dpp-domain 0.21.0

EU Digital Product Passport domain types, port traits, and per-field disclosure policy
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

//! `PluginHost` port — delegates compliance computation to loaded Wasm product group plugins.

use crate::compliance::{ComplianceError, ComplianceResult};
use crate::product_group::ProductGroupData;

/// Port trait for the Wasm plugin host.
///
/// Implementors load product group-specific Wasm plugins and delegate compliance
/// computation to them. Tests can wire a stub that returns fixed results.
/// The passthrough registry is used when no plugin is loaded for a product group.
///
/// Dispatch is by **catalog key**, not by the `ProductGroup` enum. Plugin manifests
/// are string-keyed and the catalog is the source of product group identity; taking
/// the enum here meant a plugin could only ever be loaded for a product group this
/// build already had a variant for, which is the opposite of what a plugin
/// host is for. Use [`ProductGroup::catalog_key`](crate::product_group::ProductGroup::catalog_key)
/// at the call site.
pub trait PluginHost: Send + Sync {
    /// Returns true if a Wasm plugin is currently loaded for `product_group_key`.
    fn has_plugin(&self, product_group_key: &str) -> bool;

    /// Invoke the loaded plugin for `product_group_key` with the given `data`.
    ///
    /// Returns `ComplianceErrorKind::UnknownProductGroup` if no plugin is loaded.
    fn compute(
        &self,
        product_group_key: &str,
        data: &ProductGroupData,
    ) -> Result<ComplianceResult, ComplianceError>;
}