@flaks/onerecord 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -4,6 +4,115 @@ All notable changes are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/), versioning follows
 [SemVer](https://semver.org/) per the policy in `MIGRATING.md`.
 
+## [0.3.0] - 2026-05-17
+
+FWB-equivalence Path A: 10 new classes, schema rewrites for the core FWB
+classes, full IATA 3.2.0 conformance for the covered class set with documented
+deviations and 3.2.1-forward extensions. See `MIGRATING.md` for per-breaking-
+change migration guidance.
+
+### Added
+
+- **`Company`** class — concrete `:Organization` subtype; retires the abstract
+  `Organization` class. `Party.partyDetails` and all Organization-range fields
+  now point to `Company`.
+- **`WaybillLineItem`** class — FWB rate/charge line item.
+- **`OtherCharge`** class — FWB OCI/other-charge block.
+- **`CustomsInformation`** class — FWB customs information block.
+- **`Insurance`** class — FWB insurance details.
+- **`LineItemPackage`** class — FWB package-level line item.
+- **`ULD`** class — unit load device reference.
+- **`CO2Emissions`** class — carbon emissions per spec §D6.
+- **`RegulatedEntity`** class — security regulated entity (shipper/handler).
+- **`SecurityDeclaration`** class — security declaration per spec §8.
+- **Shared value sub-schemas**: `ValueSchema`, `CurrencyValueSchema`,
+  `DimensionsSchema` — used by all NEW value-typed properties in v0.3.0.
+- **FWB properties** on `Waybill`: `shipment`, `involvedParties`,
+  `waybillLineItems`, `otherCharges`, `carrierDeclarationPlace`,
+  `departureLocation`, `arrivalLocation`, `houseWaybills`, `masterWaybill`,
+  `billingDetails` (IRI ref only; `:BillingDetails` class not modelled — deviation #16).
+  `accountingInformation` — deprecated upstream (owl:deprecated true in
+  3.2-rc2 ~2861) — **deviation #15**.
+- **FWB properties** on `Shipment`: `pieces`, `waybill`, `involvedParties`,
+  `customsInformation`, `insurance`, `securityDeclarations` (accepted as
+  optional 3.2.1-forward extension — deviation #12).
+- **FWB properties** on `Piece`: `ofShipment`, `containedPieces`,
+  `securityDeclarations` (3.2.0-conformant via Piece restriction ~8260).
+- `CARGO_ONTOLOGY_VERSION` bumped from `'3.2'` to `'3.2.0'` (exact endorsed
+  version string). Legacy alias `'3.2'` remains accepted by
+  `assertOntologyVersion` and `checkServerInformation`.
+
+### Changed
+
+- **`Organization` class retired** — replaced by `Company`
+  (`:Company rdfs:subClassOf :Organization`; the only concrete org type shipped).
+  `Party.partyDetails` widened to accept `IRI | {@id}` (Person or Company).
+  `NI` added as accepted `Party.partyRole` value.
+- **`Waybill`**: dropped `shipmentInformation` (renamed to `shipment`);
+  dropped `totalGrossWeight` (the field already exists on `Shipment` — use that).
+- **`Shipment`**: dropped `pieceCount`, `totalVolume`, `containedPieces`
+  (renamed to `pieces`), `shipper`, `consignee` (moved to `involvedParties`).
+- **`waybillType` enum**: `DIRECT` added.
+- **`waybillPrefix`**: now accepts `[A-Z0-9]{1,3}` (editorial policy relaxation
+  — NOT a spec pattern; the ontology has only `xsd:string maxLength 3`).
+- **`waybillNumber`**: now accepts `[A-Z0-9]+` per 3.2-rc2 ontology pattern.
+- **`AccountNumber`**: `accountNumber`/`issuedBy`/`accountType` renamed to
+  `accountNumberType`/`textualValue`; `issuedBy` removed (wrong domain — belongs
+  to `:SecurityDeclaration`, not `:AccountNumber`).
+- **`CARGO_ONTOLOGY_VERSION`**: `'3.2'` → `'3.2.0'`. `assertOntologyVersion`
+  and `checkServerInformation` now use an exact-alias accepted set
+  (`'3.2'` ≡ `'3.2.0'`, `'3.2.1'` rejected — NOT prefix-tolerant).
+- **`FIELD_TYPES` map**: stale v0.2 entries removed (`Waybill.shipmentInformation`,
+  `Shipment.containedPieces`, `Shipment.consignee`, `Shipment.shipper`,
+  `Organization.address`, `Organization.contactPersons`,
+  `AccountNumber.issuedBy`); ~40 new entries added for v0.3.0 classes.
+- **Domain constraints** (`domain-constraints.ts`): stale v0.2 constraints
+  on `Waybill.shipmentInformation` and `Shipment.containedPieces` removed.
+  No spec basis post-Path-A; the corrected cross-node check
+  (Waybill↔Shipment inverse-property consistency) is deferred.
+
+### BREAKING CHANGES
+
+Consumers upgrading from v0.2.x must audit the following:
+
+1. **`Organization` class removed** — import `Company` instead. Any code
+   referencing `OrganizationSchema`, `OrganizationCodec`, `serializeOrganization`,
+   or `deserializeOrganization` will break.
+2. **`Waybill.shipmentInformation` removed** — use `Waybill.shipment`.
+3. **`Waybill.totalGrossWeight` removed** — field moved to `Shipment`.
+4. **`Shipment.pieceCount` removed** — no direct replacement (compute from `pieces.length`).
+5. **`Shipment.totalVolume` removed** — no direct replacement in v0.3.0.
+6. **`Shipment.containedPieces` removed** — use `Shipment.pieces`.
+7. **`Shipment.shipper` / `Shipment.consignee` removed** — use `Shipment.involvedParties`
+   filtered by `partyRole`.
+8. **`waybillType` enum**: `DIRECT` is now a valid value — exhaustive switches
+   must handle it.
+9. **`waybillPrefix`**: now accepts alphanumeric `[A-Z0-9]{1,3}` — do not
+   assume numeric-only downstream.
+10. **`waybillNumber`**: now accepts `[A-Z0-9]+` — do not assume numeric-only.
+11. **`AccountNumber` fields renamed**: `accountNumber` → `textualValue`,
+    `accountType` → `accountNumberType`; `issuedBy` removed.
+12. **`Party.partyDetails`** widened (additive for accept — a bare IRI still
+    validates; see MIGRATING.md for detail).
+13. **`CARGO_ONTOLOGY_VERSION`** changed from `'3.2'` to `'3.2.0'`. Any code
+    doing `=== '3.2'` on the constant will need updating.
+14. **`assertOntologyVersion('3.2.1')`** now throws (previously any mismatch
+    with `'3.2'` would throw; now the exact-alias set `{'3.2.0','3.2'}` is
+    accepted and everything else including `'3.2.1'` is rejected).
+15. **`domain_constraint_violation`** for `Waybill.shipmentInformation` /
+    `Shipment.containedPieces` no longer fires (those fields no longer exist).
+16. **`Party.partyRole`**: `'NI'` (also-notify, AWB box 7) is now an accepted
+    value — exhaustive `switch` statements over `partyRole` must handle it
+    (same migration class as `waybillType` `DIRECT`).
+
+### Spec deviations
+
+- **#12 (reworded)**: `Shipment.securityDeclarations` is a documented
+  3.2.1-forward extension — see `docs/spec-deviations.md#12`.
+- **#14 (new)**: Legacy `{unit,value}` shape on 3 pre-existing fields.
+- **#15 (new)**: `Waybill.accountingInformation` is `owl:deprecated` in 3.2-rc2.
+- **#16 (new)**: `BillingDetails` class not modelled in v0.3.0.
+
 ## [0.2.0] - 2026-04-28
 
 First publicly verifiable release. Closes 3 of 5 v0.1.x spec

package/MIGRATING.md

@@ -2,6 +2,120 @@
 
 This file documents one entry per minor release.
 
+## Migrating from v0.2.x to v0.3.0
+
+v0.3.0 is a **breaking release**. Review every item below before upgrading.
+
+### 1. `Organization` class retired → use `Company`
+
+`Organization` is removed. Import and use `Company` instead. Update all
+references to `OrganizationSchema`, `OrganizationCodec`, `serializeOrganization`,
+`deserializeOrganization`.
+
+```typescript
+// Before (v0.2.x)
+import { OrganizationCodec } from '@flaks/onerecord'
+// After (v0.3.0)
+import { CompanyCodec } from '@flaks/onerecord'
+```
+
+### 2. `Waybill.shipmentInformation` → `Waybill.shipment`
+
+```typescript
+// Before
+waybill.shipmentInformation = 'https://example/sh'
+// After
+waybill.shipment = 'https://example/sh'
+```
+
+### 3. `Shipment.containedPieces` → `Shipment.pieces`
+
+```typescript
+// Before
+shipment.containedPieces = ['https://example/p1']
+// After
+shipment.pieces = ['https://example/p1']
+```
+
+### 4. `Shipment.shipper` / `Shipment.consignee` → `Shipment.involvedParties`
+
+The `shipper` and `consignee` top-level fields on `Shipment` are removed.
+Use `Shipment.involvedParties` filtered by `partyRole`:
+
+```typescript
+const shipper = shipment.involvedParties?.find(p => p.partyRole === 'SHP')
+const consignee = shipment.involvedParties?.find(p => p.partyRole === 'CNE')
+```
+
+### 5. `Shipment.pieceCount` / `Shipment.totalVolume` removed
+
+No direct replacement in v0.3.0. Compute `pieceCount` from `pieces.length`
+if needed. `totalVolume` is deferred (no spec-correct successor in scope).
+
+### 6. `AccountNumber` field renames
+
+| v0.2.x field | v0.3.0 field | Notes |
+|---|---|---|
+| `accountNumber` | `textualValue` | String value of the account number |
+| `accountType` | `accountNumberType` | IRI ref to code value |
+| `issuedBy` | removed | Wrong domain; belongs to `:SecurityDeclaration` |
+
+### 7. `Party.partyDetails` widening — additive for accept
+
+`partyDetails` now accepts `Person | Company` (not `Person | Organization`).
+**This is additive for deserializing**: a bare IRI still validates. Code
+that checks `partyDetails['@type'] === 'Organization'` must be updated to
+`'Company'`. The new `NI` value is accepted for `partyRole`.
+
+### 8. `waybillNumber` and `waybillPrefix` regex relaxation
+
+- **`waybillNumber`**: now accepts `[A-Z0-9]+` **per the 3.2-rc2 ontology
+  pattern**. Do not assume numeric-only (`[0-9]+`) downstream.
+- **`waybillPrefix`**: now accepts up to 3 alphanumeric characters (`[A-Z0-9]{1,3}`)
+  as the library's **EDITORIAL policy** — the ontology only specifies
+  `xsd:string maxLength 3` with no character-class restriction. Do not assume
+  numeric-only downstream.
+
+### 9. `CARGO_ONTOLOGY_VERSION` constant changed
+
+The exported constant changed from `'3.2'` to `'3.2.0'`:
+
+```typescript
+// Before: CARGO_ONTOLOGY_VERSION === '3.2'
+// After:  CARGO_ONTOLOGY_VERSION === '3.2.0'
+```
+
+Any code doing `=== '3.2'` on the constant must be updated to `=== '3.2.0'`
+(or use `CARGO_ONTOLOGY_VERSION` indirectly).
+
+### 10. `assertOntologyVersion` + `checkServerInformation` — exact-alias peer-compat policy
+
+Both functions now use an **exact-alias accepted set**: `{'3.2.0', '3.2'}`.
+
+- `assertOntologyVersion('3.2.0')` — does NOT throw (canonical pin)
+- `assertOntologyVersion('3.2')` — does NOT throw (legacy alias ≡ 3.2.0)
+- `assertOntologyVersion('3.2.1')` — THROWS `incompatible_ontology_version`
+- `assertOntologyVersion('4.0')` — THROWS `incompatible_ontology_version`
+
+The accepted set is **NOT** prefix-tolerant (`'3.2.1'` is master-only and
+intentionally rejected). `checkServerInformation` follows the same rule:
+a server advertising `cargoOntologyVersion: '3.2.1'` will return
+`compatible: false`.
+
+### 11. `waybillType` enum: `DIRECT` added
+
+If your code has an exhaustive `switch` on `waybillType`, add a `'DIRECT'`
+case. TypeScript will surface this at compile time.
+
+### 12. `domain_constraint_violation` for stale fields no longer fires
+
+If your code expected `domain_constraint_violation` for a Waybill missing
+`shipmentInformation` or a Shipment missing `containedPieces`, those errors
+no longer fire — those fields don't exist in v0.3.0. Update your error
+handling to match the new field names (`shipment`, `pieces`).
+
+---
+
 ## Migrating from v0.1.x to v0.2.0
 
 v0.2.0 is **non-breaking at the call-site level** for v0.1.x consumers.

package/README.md

@@ -1,18 +1,19 @@
 # @flaks/onerecord
 
-Zero-dependency Zod-first TypeScript mapper for the IATA OneRecord cargo data model 3.2 and API spec 2.2.0.
+Zero-dependency Zod-first TypeScript mapper for the IATA OneRecord cargo data model 3.2.0 and API spec 2.2.0.
 
 ## What it is
 
 `@flaks/onerecord` provides round-trip-safe serialization and deserialization for
-32 OneRecord cargo data model classes. Each class ships with a Zod schema, an
-application-layer TypeScript type, a `JsonLd<T>` brand, `serialize` / `serializeStrict`
-/ `deserialize` functions, and a `Codec` bundle. A factory (`createMapper`) and a
-namespaced facade (`onerecord`) cover the two main consumption patterns. Safety
-primitives (depth, node, string, array, payload limits; prototype-pollution defense;
-IRI validation) run before Zod so that invalid JSON-LD graphs never reach schema
-evaluation. All 22 parse-error variants are typed as a discriminated union (`ParseError`)
-so callers handle every failure mode exhaustively.
+the OneRecord cargo data model class set (Ring 1–5, booking-flow, and FWB-equivalence
+classes added in v0.3.0). Each class ships with a Zod schema, an application-layer
+TypeScript type, a `JsonLd<T>` brand, `serialize` / `serializeStrict` / `deserialize`
+functions, and a `Codec` bundle. A factory (`createMapper`) and a namespaced facade
+(`onerecord`) cover the two main consumption patterns. Safety primitives (depth, node,
+string, array, payload limits; prototype-pollution defense; IRI validation) run before
+Zod so that invalid JSON-LD graphs never reach schema evaluation. All parse-error
+variants are typed as a discriminated union (`ParseError`) so callers handle every
+failure mode exhaustively.
 
 ## Why use this library?
 
@@ -36,14 +37,20 @@ Use this library if you're building cargo software that needs to:
   `missing_type`, all surfaced as typed `ParseError` variants. Default
   per-class deserializers stay structural-only for v0.1.x compatibility;
   graph-walk is opt-in.
-- **Type-check** every parse-failure path: `ParseError` is a 22-variant
-  discriminated union, so the compiler tells you when you've forgotten a
-  failure mode.
+- **Type-check** every parse-failure path: `ParseError` is a discriminated
+  union, so the compiler tells you when you've forgotten a failure mode.
 
 Skip it if you want a generic JSON-LD or RDF toolkit; this is purpose-built
 for the IATA cargo ontology and the ONE Record API spec 2.2.0.
 
-### Publicly verifiable
+### Conformance and verifiability
+
+This library is **3.2.0-conformant for the covered class set, with documented
+deviations and 3.2.1-forward extensions**. Specifically:
+`Shipment.securityDeclarations` is accepted as a documented 3.2.1-forward
+extension (deviation #12). Every deviation is recorded in
+[`docs/spec-deviations.md`](docs/spec-deviations.md) — read that before
+adopting if your integration must match the spec verbatim.
 
 This library publishes verifiable artifacts so consumers can audit the
 conformance claim independently:
@@ -51,12 +58,13 @@ conformance claim independently:
 - All releases are GPG-signed git tags + signed npm tarballs (per
   [`MAINTENANCE.md`](MAINTENANCE.md)).
 - Every spec deviation is documented in [`docs/spec-deviations.md`](docs/spec-deviations.md)
-  with status banners (CLOSED, PARTIAL, deferred-to-v0.3) and explicit
-  guidance on what consumers should do today.
-- Property-based round-trip tests for the eight Ring 1+2 classes
-  (Waybill, Shipment, Piece, Address, Person, Organization, Party,
-  AccountNumber) — `serialize(deserialize(x))` is field-equivalent for
-  any value an `Arbitrary` produces.
+  with status banners (CLOSED, PARTIAL, deferred) and explicit guidance
+  on what consumers should do today.
+- A [`docs/conformance-matrix.md`](docs/conformance-matrix.md) maps each
+  class and field to its binding authority in `IATA-1R-DM-Ontology.ttl`.
+- Property-based round-trip tests for the Ring 1+2 classes
+  — `serialize(deserialize(x))` is field-equivalent for any value an
+  `Arbitrary` produces.
 - Contract tests at `test/contract/` exercise the wire format
   end-to-end against the OLF-hosted reference NE:ONE Server (the IATA
   OneRecord reference implementation). See [`CONTRIBUTING.md`](CONTRIBUTING.md)
@@ -64,11 +72,11 @@ conformance claim independently:
 
 ## Status
 
-`v0.2.0` ships:
+`v0.3.0` ships:
 
-- The 32 canonical cargo data model classes (Ring 1–5 plus booking-flow)
-  with full round-trip codecs, Zod schemas, snapshot tests, and pre-Zod
-  safety primitives.
+- The canonical cargo data model class set (Ring 1–5, booking-flow, plus
+  10 new FWB-equivalence classes in v0.3.0) with full round-trip codecs,
+  Zod schemas, snapshot tests, and pre-Zod safety primitives.
 - Opt-in **graph-walk dispatcher** (`createMapper({ graphWalk: true })` or
   `onerecord.dispatch.deserialize.<Class>`) emitting all four cross-node
   integrity ParseError kinds.
@@ -87,11 +95,11 @@ conformance claim independently:
 The library is Apache-2.0 and ready for use within the v0.x stability
 policy described in [`MIGRATING.md`](MIGRATING.md).
 
-Spec compliance: cargo data model **3.2 (2025-07 endorsed standard)**, API
-spec **2.2.0**. A small number of deliberate divergences from canonical
-spec behavior are documented in
-[`docs/spec-deviations.md`](docs/spec-deviations.md); read that before
-adopting if your integration must match the spec verbatim.
+Spec compliance: cargo data model **3.2.0 (2025-07 endorsed standard, 3.2-rc2 file)**,
+API spec **2.2.0**. The library is 3.2.0-conformant for the covered class set,
+with documented deviations and 3.2.1-forward extensions. See
+[`docs/spec-deviations.md`](docs/spec-deviations.md) and
+[`docs/conformance-matrix.md`](docs/conformance-matrix.md) for the full picture.
 
 ## Install
 
@@ -163,7 +171,7 @@ const jsonLd = onerecord.serialize.Piece(piece)
 
 ### Per-class exports
 
-Each of the 32 classes exposes:
+Each registered class exposes:
 
 | Export | Description |
 |---|---|
@@ -196,9 +204,9 @@ No bound state; suitable for one-off operations and tree-shake-friendly imports.
 
 ### Errors
 
-- `ParseError` — 22-variant discriminated union (`kind` field); covers
-  `zod_validation`, `cardinality_violation`, `invalid_iri`, `depth_limit_exceeded`,
-  `prototype_pollution_attempt`, `invalid_pointer`, and 16 more
+- `ParseError` — discriminated union on `kind`; covers `zod_validation`,
+  `cardinality_violation`, `invalid_iri`, `depth_limit_exceeded`,
+  `prototype_pollution_attempt`, `invalid_pointer`, and more
 - `SerializationError` — `code: 'invalid_application_object' | 'iri_construction_failed'`
 - `formatError(e: ParseError): string` — human-readable message
 - `redactError(e: ParseError): ParseError` — strips PII from error payloads before logging
@@ -288,14 +296,14 @@ import type { Waybill, ParseError } from '@flaks/onerecord/types'
 
 | Spec | Version |
 |---|---|
-| Cargo data model | 3.2 (2025-07 endorsed standard) |
+| Cargo data model | 3.2.0 (2025-07 endorsed standard, 3.2-rc2 ontology file) |
 | API spec | 2.2.0 |
 
 ## Development
 
 ```bash
 bun install
-bun run test       # 518 passing + 10 skipped = 528 total
+bun run test       # see CI for current count
 bun run lint       # Biome
 bun run typecheck  # tsc --noEmit
 ```

package/dist/classes/account-number/schema.d.ts

@@ -4,13 +4,8 @@ export declare const AccountNumberSchema: z.ZodObject<{
     '@context': z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
     '@id': z.ZodString;
     '@type': z.ZodLiteral<"AccountNumber">;
-    accountNumber: z.ZodString;
-    issuedBy: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../index.js").SafeIri, string>>>;
-    accountType: z.ZodOptional<z.ZodEnum<{
-        IATA_CASS: "IATA_CASS";
-        INTERNAL: "INTERNAL";
-        OTHER: "OTHER";
-    }>>;
+    accountNumberType: z.ZodOptional<z.ZodString>;
+    textualValue: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type AccountNumber = z.infer<typeof AccountNumberSchema>;
 export type JsonLdAccountNumber = JsonLd<'AccountNumber'>;

package/dist/classes/account-number/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/classes/account-number/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAGvD,eAAO,MAAM,mBAAmB;;;;;;;;;;;kBAKrB,CAAA;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAC/D,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,eAAe,CAAC,CAAA"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/classes/account-number/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAGvD,eAAO,MAAM,mBAAmB;;;;;;kBASrB,CAAA;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAC/D,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,eAAe,CAAC,CAAA"}

package/dist/classes/account-number/schema.js

@@ -1,10 +1,13 @@
 import { z } from 'zod';
-import { safeIri } from '../../iri/zod-safe-iri.js';
 import { LogisticsObjectSchema } from '../shared/logistics-object.js';
 export const AccountNumberSchema = LogisticsObjectSchema.extend({
     '@type': z.literal('AccountNumber'),
-    accountNumber: z.string().max(35),
-    issuedBy: safeIri().optional(),
-    accountType: z.enum(['IATA_CASS', 'INTERNAL', 'OTHER']).optional(),
+    // :accountNumberType → :AccountType, owl:maxCardinality 1 (TTL DM 4780/4784-4785).
+    // String per open-codelist idiom — :AccountType is rdfs:subClassOf :CodeListElement,
+    // no owl:oneOf in DM or CL ontology (DM TTL 4801-4805).
+    accountNumberType: z.string().min(1).max(16).optional(),
+    // :textualValue → xsd:string, owl:maxCardinality 1 (TTL DM 4788/4791-4793). .max(35) = FWB account
+    // field width (editorial — the ontology has no length facet).
+    textualValue: z.string().min(1).max(35).optional(),
 }).strict();
 //# sourceMappingURL=schema.js.map

package/dist/classes/account-number/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/classes/account-number/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAEnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AAErE,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,MAAM,CAAC;IAC9D,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;IACnC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;IACjC,QAAQ,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE;CACnE,CAAC,CAAC,MAAM,EAAE,CAAA"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/classes/account-number/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AAErE,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,MAAM,CAAC;IAC9D,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;IACnC,mFAAmF;IACnF,qFAAqF;IACrF,wDAAwD;IACxD,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvD,mGAAmG;IACnG,8DAA8D;IAC9D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAC,MAAM,EAAE,CAAA"}

package/dist/classes/co2-emissions/codec.d.ts

@@ -0,0 +1,4 @@
+import type { Codec } from '../shared/codec.js';
+import type { CO2Emissions, JsonLdCO2Emissions } from './schema.js';
+export declare const CO2EmissionsCodec: Codec<CO2Emissions, JsonLdCO2Emissions, 'CO2Emissions'>;
+//# sourceMappingURL=codec.d.ts.map

package/dist/classes/co2-emissions/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../../../src/classes/co2-emissions/codec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE/C,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAInE,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,YAAY,EAAE,kBAAkB,EAAE,cAAc,CAOzE,CAAA"}

package/dist/classes/co2-emissions/codec.js

@@ -0,0 +1,11 @@
+import { deserializeCO2Emissions } from './deserialize.js';
+import { CO2EmissionsSchema } from './schema.js';
+import { serializeCO2Emissions, serializeCO2EmissionsStrict } from './serialize.js';
+export const CO2EmissionsCodec = Object.freeze({
+    schema: CO2EmissionsSchema,
+    serialize: serializeCO2Emissions,
+    serializeStrict: serializeCO2EmissionsStrict,
+    deserialize: deserializeCO2Emissions,
+    type: 'CO2Emissions',
+});
+//# sourceMappingURL=codec.js.map

package/dist/classes/co2-emissions/codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.js","sourceRoot":"","sources":["../../../src/classes/co2-emissions/codec.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAE1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAA;AAEnF,MAAM,CAAC,MAAM,iBAAiB,GAC5B,MAAM,CAAC,MAAM,CAAC;IACZ,MAAM,EAAE,kBAAkB;IAC1B,SAAS,EAAE,qBAAqB;IAChC,eAAe,EAAE,2BAA2B;IAC5C,WAAW,EAAE,uBAAuB;IACpC,IAAI,EAAE,cAAc;CACZ,CAAC,CAAA"}

package/dist/classes/co2-emissions/deserialize.d.ts

@@ -0,0 +1,5 @@
+import type { ParseResult } from '../../result.js';
+import type { DeserializeOpts } from '../../safety/limits.js';
+import type { CO2Emissions } from './schema.js';
+export declare function deserializeCO2Emissions(input: unknown, opts?: DeserializeOpts): ParseResult<CO2Emissions>;
+//# sourceMappingURL=deserialize.d.ts.map

package/dist/classes/co2-emissions/deserialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deserialize.d.ts","sourceRoot":"","sources":["../../../src/classes/co2-emissions/deserialize.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAG7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG/C,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,IAAI,GAAE,eAAoB,GACzB,WAAW,CAAC,YAAY,CAAC,CA2D3B"}

package/dist/classes/co2-emissions/deserialize.js

@@ -0,0 +1,64 @@
+import { assertContextAllowed } from '../../context.js';
+import { findInvalidIriInIssues } from '../../iri/zod-safe-iri.js';
+import { preValidate } from '../../safety/pre-validate.js';
+import { findFirstEmptyArray, nullProtoClone, withMeta } from '../shared/parse-utils.js';
+import { CO2EmissionsSchema } from './schema.js';
+export function deserializeCO2Emissions(input, opts = {}) {
+    // 1. Pre-Zod sanity (depth/nodes/string/array/payload/pollution/cycle)
+    const preOpts = {};
+    if (opts.limits !== undefined)
+        preOpts.limits = opts.limits;
+    if (opts.payloadByteLength !== undefined)
+        preOpts.payloadByteLength = opts.payloadByteLength;
+    if (opts.meta !== undefined)
+        preOpts.meta = opts.meta;
+    const pre = preValidate(input, preOpts);
+    if (!pre.ok)
+        return pre;
+    // 2. v2 (A3-B2, A1-M4): @context allowlist enforced before Zod
+    if (pre.value && typeof pre.value === 'object' && '@context' in pre.value) {
+        const ctxOpts = {};
+        if (opts.allowedContexts !== undefined)
+            ctxOpts.allowedContexts = opts.allowedContexts;
+        if (opts.meta !== undefined)
+            ctxOpts.meta = opts.meta;
+        const ctxR = assertContextAllowed(pre.value['@context'], ctxOpts);
+        if (!ctxR.ok)
+            return ctxR;
+    }
+    // 3. v3 plan correction: empty-array rejection BEFORE Zod
+    const empty = findFirstEmptyArray(pre.value, '$');
+    if (empty) {
+        return {
+            ok: false,
+            error: withMeta({
+                kind: 'cardinality_violation',
+                field: empty.field,
+                expected: '>=1 or omit',
+                got: 0,
+                path: empty.path,
+            }, opts.meta),
+        };
+    }
+    // 4. Zod parse — lift safeIri-tagged issues to invalid_iri
+    const r = CO2EmissionsSchema.safeParse(pre.value);
+    if (!r.success) {
+        const iriErr = findInvalidIriInIssues(r.error.issues, '$');
+        if (iriErr)
+            return { ok: false, error: withMeta(iriErr, opts.meta) };
+        return {
+            ok: false,
+            error: withMeta({
+                kind: 'zod_validation',
+                issues: r.error.issues.map((i) => ({
+                    path: i.path.length === 0 ? '$' : i.path.join('.'),
+                    message: i.message,
+                    code: i.code,
+                })),
+            }, opts.meta),
+        };
+    }
+    // 5. v2 (A1-M5, A3-M4): null-prototype clone the output graph
+    return { ok: true, value: nullProtoClone(r.data) };
+}
+//# sourceMappingURL=deserialize.js.map

package/dist/classes/co2-emissions/deserialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deserialize.js","sourceRoot":"","sources":["../../../src/classes/co2-emissions/deserialize.ts"],"names":[],"mappings":"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"}

package/dist/classes/co2-emissions/index.d.ts

@@ -0,0 +1,6 @@
+export { CO2EmissionsCodec } from './codec.js';
+export { deserializeCO2Emissions } from './deserialize.js';
+export { CO2EmissionsSchema } from './schema.js';
+export type { CO2Emissions, JsonLdCO2Emissions } from './schema.js';
+export { serializeCO2Emissions, serializeCO2EmissionsStrict } from './serialize.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/classes/co2-emissions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/classes/co2-emissions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACnE,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/classes/co2-emissions/index.js

@@ -0,0 +1,5 @@
+export { CO2EmissionsCodec } from './codec.js';
+export { deserializeCO2Emissions } from './deserialize.js';
+export { CO2EmissionsSchema } from './schema.js';
+export { serializeCO2Emissions, serializeCO2EmissionsStrict } from './serialize.js';
+//# sourceMappingURL=index.js.map

package/dist/classes/co2-emissions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/classes/co2-emissions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAEhD,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/classes/co2-emissions/schema.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import type { JsonLd } from '../shared/jsonld-brand.js';
+export declare const CO2EmissionsSchema: z.ZodObject<{
+    '@context': z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+    '@id': z.ZodString;
+    '@type': z.ZodLiteral<"CO2Emissions">;
+    calculatedEmissions: z.ZodOptional<z.ZodObject<{
+        '@type': z.ZodOptional<z.ZodLiteral<"Value">>;
+        numericalValue: z.ZodNumber;
+        unit: z.ZodString;
+    }, z.core.$strict>>;
+    calculationFor: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../index.js").SafeIri, string>>>;
+    methodName: z.ZodOptional<z.ZodString>;
+    methodVersion: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type CO2Emissions = z.infer<typeof CO2EmissionsSchema>;
+export type JsonLdCO2Emissions = JsonLd<'CO2Emissions'>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/classes/co2-emissions/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/classes/co2-emissions/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAIvD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;kBAMpB,CAAA;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAC7D,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,cAAc,CAAC,CAAA"}

package/dist/classes/co2-emissions/schema.js

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import { safeIri } from '../../iri/zod-safe-iri.js';
+import { LogisticsObjectSchema } from '../shared/logistics-object.js';
+import { ValueSchema } from '../shared/value.js';
+export const CO2EmissionsSchema = LogisticsObjectSchema.extend({
+    '@type': z.literal('CO2Emissions'),
+    calculatedEmissions: ValueSchema.optional(),
+    calculationFor: safeIri().optional(),
+    methodName: z.string().min(1).max(128).optional(),
+    methodVersion: z.string().min(1).max(64).optional(),
+}).strict();
+//# sourceMappingURL=schema.js.map

package/dist/classes/co2-emissions/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/classes/co2-emissions/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAEnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD,MAAM,CAAC,MAAM,kBAAkB,GAAG,qBAAqB,CAAC,MAAM,CAAC;IAC7D,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;IAClC,mBAAmB,EAAE,WAAW,CAAC,QAAQ,EAAE;IAC3C,cAAc,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACjD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CACpD,CAAC,CAAC,MAAM,EAAE,CAAA"}

package/dist/classes/co2-emissions/serialize.d.ts

@@ -0,0 +1,6 @@
+import type { ParseResult } from '../../result.js';
+import type { SerializeOpts } from '../../safety/limits.js';
+import type { CO2Emissions, JsonLdCO2Emissions } from './schema.js';
+export declare function serializeCO2Emissions(input: CO2Emissions, _opts?: SerializeOpts): JsonLdCO2Emissions;
+export declare function serializeCO2EmissionsStrict(input: CO2Emissions, _opts?: SerializeOpts): ParseResult<JsonLdCO2Emissions>;
+//# sourceMappingURL=serialize.d.ts.map

package/dist/classes/co2-emissions/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../../src/classes/co2-emissions/serialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAE3D,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAGnE,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EACnB,KAAK,CAAC,EAAE,aAAa,GACpB,kBAAkB,CAUpB;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,YAAY,EACnB,KAAK,CAAC,EAAE,aAAa,GACpB,WAAW,CAAC,kBAAkB,CAAC,CAgBjC"}