dpp-domain 0.20.0

//! Shared fixture builders for this crate's own unit tests.
//!
//! Every one of `Passport`/`BatteryData`/`TextileData` has 20+ fields, and
//! before this module each test file hand-rolled its own full struct literal
//! — a new field silently doesn't get set at whichever call sites nobody
//! remembered to update. Build fixtures via struct-update syntax instead:
//! `Passport { product_name: "X".into(), ..sample_passport() }`.

use chrono::Utc;

use crate::identifier::Gtin;
use crate::passport::{ManufacturerInfo, Passport, PassportId};
use crate::product_group::{BatteryChemistry, BatteryData, BatteryType, ProductGroup, TextileData};
use crate::status::PassportStatus;

/// A minimal, valid `Passport` with no product group data.
pub(crate) fn sample_passport() -> Passport {
    let now = Utc::now();
    Passport {
        id: PassportId::new(),
        batch_id: None,
        serial_number: None,
        product_name: "Test Product".into(),
        product_group: ProductGroup::Textile,
        applicable_instruments: vec![crate::instrument::InstrumentRef::from_catalog("espr")],
        granularity: Some(crate::catalog::Granularity::Item),
        manufacturer: ManufacturerInfo {
            name: "Test Manufacturer".into(),
            address: "Berlin, DE".into(),
            country: None,
            did_web_url: None,
            registered_trade_name: None,
            electronic_address: None,
        },
        materials: vec![],
        co2e_per_unit: None,
        repairability_score: None,
        compliance_result: None,
        lint_result: None,
        product_group_data: None,
        status: PassportStatus::Draft,
        qr_code_url: None,
        jws_signature: None,
        public_jws_signature: None,
        disclosure_signatures: Default::default(),
        created_at: now,
        updated_at: now,
        published_at: None,
        placed_on_market_date: None,
        schema_version: "1.0.0".into(),
        retention_locked: false,
        version: 1,
        supersedes_id: None,
        derived_from: Vec::new(),
        component_refs: Vec::new(),
        life_status: None,
        retention_until: None,
        product_id: None,
        commodity_code: None,
        operator_identifier: None,
        responsible_operator: None,
        facility: None,
        seal: None,
    }
}

/// A minimal, valid `BatteryData` (LFP chemistry, a real check-digit-valid GTIN).
pub(crate) fn sample_battery_data() -> BatteryData {
    BatteryData {
        // 09506000134352 — verified valid GTIN-14, used throughout the test suite.
        gtin: Gtin::parse("09506000134352").expect("valid GTIN literal"),
        battery_chemistry: BatteryChemistry::Lfp,
        nominal_voltage_v: 3.2,
        nominal_capacity_ah: 100.0,
        expected_lifetime_cycles: Some(3000),
        co2e_per_unit_kg: 85.4,
        recycled_content_cobalt_pct: None,
        recycled_content_lithium_pct: None,
        recycled_content_nickel_pct: None,
        state_of_health_pct: None,
        state_of_health: None,
        expected_lifetime: None,
        hazardous_substances: None,
        usable_extinguishing_agent: None,
        renewable_content_pct: None,
        minimal_voltage_v: None,
        maximum_voltage_v: None,
        voltage_temperature_range: None,
        original_power_capability_w: None,
        power_limit_min_w: None,
        power_limit_max_w: None,
        power_temperature_range: None,
        expected_lifetime_reference_test: None,
        capacity_threshold_for_exhaustion_pct: None,
        not_in_use_temperature_range: None,
        not_in_use_temperature_reference_test: None,
        commercial_warranty_period_months: None,
        cycle_life_test_c_rate: None,
        marking_information: None,
        hazard_symbol: None,
        eu_declaration_of_conformity: None,
        waste_battery_information: None,
        component_part_numbers: None,
        spare_parts_contacts: None,
        safety_measures: None,
        test_report_results: None,
        dynamic_performance: None,
        battery_status: None,
        usage_history: None,
        recycled_content_reporting_year: None,
        rated_capacity_kwh: None,
        carbon_footprint_class: None,
        carbon_footprint_class_ruleset_id: None,
        carbon_footprint_class_ruleset_version: None,
        due_diligence_url: None,
        cathode_material: None,
        anode_material: None,
        electrolyte_material: None,
        critical_raw_materials: None,
        disassembly_instructions_url: None,
        soh_methodology: None,
        operating_temp_min_c: None,
        operating_temp_max_c: None,
        rated_energy_wh: None,
        recycled_content_lead_pct: None,
        battery_weight_kg: None,
        battery_type: BatteryType::Portable,
        initial_round_trip_efficiency_pct: None,
        round_trip_efficiency_at_half_cycle_life_pct: None,
        round_trip_efficiency_pct: None,
        internal_resistance_mohm: None,
        internal_cell_resistance_mohm: None,
        internal_pack_resistance_mohm: None,
        placed_on_market_date: None,
        manufacturing_date: None,
        manufacturing_place: None,
        battery_model_id: None,
        battery_passport_number: None,
    }
}

/// A minimal, valid `TextileData` with an empty fibre composition — tests
/// exercising fibre-sum rules override `fibre_composition` explicitly.
pub(crate) fn sample_textile_data() -> TextileData {
    TextileData {
        gtin: Gtin::parse("09506000134352").expect("valid GTIN literal"),
        fibre_composition: vec![],
        country_of_origin: "PT".into(),
        care_instructions: "Machine wash 30°C".into(),
        chemical_compliance_standard: "OEKO-TEX Standard 100".into(),
        recycled_content_pct: None,
        carbon_footprint_kg_co2e: None,
        water_use_litres: None,
        microplastic_shedding_mg_per_wash: None,
        repair_score: None,
        durability_score: None,
        expected_wash_cycles: None,
        country_of_raw_material_origin: None,
        svhc_substances: None,
        allergens: None,
        substances_of_concern: None,
        recyclability_class: None,
        end_of_life_instructions: None,
        reuse_condition: None,
        prior_use_cycles: None,
        disassembly_instructions: None,
        spare_parts_available: None,
        product_weight_grams: None,
        repair_history_url: None,
        repair_count: None,
        pef_score: None,
    }
}

/// A `Passport` with **every** optional field populated, so serialising it
/// yields every key the type is capable of emitting.
///
/// `sample_passport` is minimal on purpose, and most fields here are
/// `skip_serializing_if` — a minimal instance simply omits them, so a test
/// asserting something about the wire shape would silently be asserting it
/// about a subset. Anything reasoning over `Passport`'s JSON keys must build
/// from this.
pub(crate) fn fully_populated_passport() -> Passport {
    use crate::compliance::ComplianceResult;
    use crate::identifier::CommodityCode;
    use crate::lint::LintResult;
    use crate::passport::{
        ComponentRef, DerivationRef, FacilitySnapshot, LifeStatus, PassportRef, Quantity,
        SecondLifeOperation,
    };
    use crate::product_group::{CarbonFootprint, RepairabilityScore};
    use crate::seal::{SealConformanceLevel, SealFormat, SealedEnvelope};

    let now = Utc::now();
    let reference = PassportRef {
        uri: "https://id.example/dpp/1".to_owned(),
        public_jws_hash: "0".repeat(64),
    };

    let mut passport = sample_passport();
    passport.batch_id = Some("LOT-2026-001".to_owned());
    passport.co2e_per_unit = Some(CarbonFootprint::from_kg(45.2));
    passport.repairability_score = Some(RepairabilityScore::from_scalar(7.5));
    passport.compliance_result = Some(ComplianceResult::default());
    passport.lint_result = Some(LintResult {
        pack_version: "1.0.0".to_owned(),
        findings: Vec::new(),
        assessed_at: now,
    });
    passport.qr_code_url = Some("https://id.example/01/09506000134352/21/A".to_owned());
    passport.jws_signature = Some("eyJ..a".to_owned());
    passport.public_jws_signature = Some("eyJ..b".to_owned());
    passport
        .disclosure_signatures
        .insert("public+restricted".to_owned(), "eyJ..c".to_owned());
    passport.published_at = Some(now);
    passport.placed_on_market_date = Some(now.date_naive());
    passport.supersedes_id = Some(PassportId::new());
    // All three are `skip_serializing_if`, so leaving any of them `None` would
    // stop the passport emitting that key at all — and anything reasoning over
    // this instance's JSON would then pass while never having seen the field.
    passport.serial_number = Some("SN-2026-00042".to_owned());
    passport.manufacturer.registered_trade_name = Some("GreenCell".to_owned());
    passport.manufacturer.electronic_address = Some("contact@greencell.example".to_owned());
    passport.derived_from = vec![DerivationRef {
        reference: reference.clone(),
        operation: SecondLifeOperation::Repurposing,
    }];
    passport.component_refs = vec![ComponentRef {
        reference,
        quantity: Some(Quantity {
            value: 2.0,
            unit: None,
        }),
        role: Some("cell".to_owned()),
    }];
    // Agrees with the `Repurposing` edge above on purpose: the consistency rule
    // in `dpp-rules` reports a status its derivation edges do not support, and a
    // fixture that tripped its own rule would be a poor example of a passport.
    passport.life_status = Some(LifeStatus::Repurposed);
    passport.retention_until = Some(now);
    passport.product_id = Some(uuid::Uuid::nil());
    passport.commodity_code = Some(CommodityCode::parse("85076000").expect("valid CN-8"));
    passport.operator_identifier = Some("DE123456789".to_owned());
    passport.responsible_operator = Some(crate::operator::ResponsibleOperatorSnapshot {
        operator: crate::operator::ResponsibleOperator {
            did: "did:web:acme.example.com".to_owned(),
            name: "Acme GmbH".to_owned(),
            role: crate::operator::OperatorRole::AuthorisedRepresentative,
            eu_operator_id: Some("DE123456789".to_owned()),
            eu_operator_id_scheme: Some("vat".to_owned()),
            country: "DE".to_owned(),
            registered_trade_name: Some("Acme".to_owned()),
            postal_address: Some("Alexanderplatz 1, 10178 Berlin".to_owned()),
            electronic_address: Some("compliance@acme.example.com".to_owned()),
        },
        basis: crate::operator::ResponsibilityBasis::MarketSurveillanceArt4,
    });
    passport.facility = Some(FacilitySnapshot {
        scheme: "gln".to_owned(),
        value: "4012345000009".to_owned(),
        name: "Werk Nord".to_owned(),
        country: "DE".to_owned(),
        address: Some("Werkstrasse 4, 21079 Hamburg, DE".to_owned()),
    });
    passport.seal = Some(SealedEnvelope {
        format: SealFormat::Cades,
        seal_value: "MIIB".to_owned(),
        signing_cert_ref: Some("urn:cert:1".to_owned()),
        conformance_level: Some(SealConformanceLevel::BaselineLt),
        sealed_at: now,
        placeholder: false,
    });
    passport
}

/// A minimal, well-formed unsold-goods disclosure.
///
/// One line, a treatment split totalling 100, and a CN heading outside Annex II
/// so the depth lint stays quiet — tests that want a finding should reach in and
/// break one thing rather than build a whole second fixture.
pub(crate) fn sample_unsold_goods_report()
-> crate::product_group::data::unsold_goods::UnsoldGoodsReport {
    use crate::product_group::data::unsold_goods::*;
    use chrono::NaiveDate;

    UnsoldGoodsReport {
        entity: DisclosingEntity {
            name: "Example Retail Group SA".to_owned(),
            identifier: LegalEntityIdentifier::Euid {
                value: "LUB123456789".to_owned(),
            },
            scope: DisclosureScope::Standalone,
        },
        financial_year: FinancialYear {
            start: NaiveDate::from_ymd_opt(2027, 1, 1).expect("valid date"),
            end: NaiveDate::from_ymd_opt(2027, 12, 31).expect("valid date"),
        },
        lines: vec![DiscardedProductLine {
            cn_categories: vec![CnCategory::parse("6203").expect("valid CN heading")],
            description: "Men's suits, ensembles, jackets and trousers".to_owned(),
            units_discarded: DiscardedQuantity::measured(1_200),
            weight_kg: DiscardedQuantity::estimated(430),
            packaging_included: false,
            reason: DiscardReason::DamagedOrContaminated,
            reason_detail: None,
            treatment: WasteTreatmentSplit {
                preparing_for_reuse_pct: 20,
                recycling_pct: 50,
                other_recovery_pct: 20,
                disposal_pct: 5,
                unknown_pct: 5,
            },
        }],
        measures_taken: "Introduced pre-season demand forecasting across all lines.".to_owned(),
        measures_planned: "Extending the donation offer window to twelve weeks.".to_owned(),
    }
}