wasm-capability-contract 0.3.0

//! [`ComponentManifest`] — identity, route, limits, and declared capabilities of one component.

use serde::{Deserialize, Serialize};

use crate::{ArtifactProvenance, ResourceLimits};

/// Declares what a Wasm component is, what route it wants, what it
/// declares it needs, and where it came from.
///
/// Checked by a real `ComponentValidator` implementor before the
/// component's route is ever registered — a component whose manifest
/// fails validation must never reach the host's dispatch engine.
///
/// The one `entity` in this crate: `component_id` is a stable identity
/// that outlives changes to route, contract version, or anything else
/// here, so equality is by `component_id` alone (see [`PartialEq`] below),
/// not full structural equality the way a `vo`/`dto` compares.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ComponentManifest {
    /// Stable identifier for this component, independent of route or version.
    pub component_id: String,
    /// The route this component wants to serve (e.g. `"/echo"`).
    pub route_id: String,
    /// The byte-ABI contract version this component was compiled against.
    pub contract_version: String,
    /// Name of the component's exported handler function.
    pub handler_export: String,
    /// Resource bounds the host must enforce for this component.
    pub resource_limits: ResourceLimits,
    /// Capability names this component declares it needs (e.g.
    /// `"http-egress"`). Anything not also present in the route's granted
    /// `Vec<CapabilityGrant>` is denied — ADR-001's deny-by-default posture.
    pub capabilities: Vec<String>,
    /// Where this artifact came from and how to verify it.
    pub artifact_provenance: ArtifactProvenance,
}

/// Identity-based, not structural: two manifests with the same
/// `component_id` are the same component even if every other field
/// differs (e.g. a redeploy that changes `route_id` or bumps
/// `contract_version`) -- the entity persists across such changes.
impl PartialEq for ComponentManifest {
    fn eq(&self, other: &Self) -> bool {
        self.component_id == other.component_id
    }
}

impl Eq for ComponentManifest {}