@flaks/onerecord 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -4,6 +4,73 @@ 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.6.0] - 2026-11-13
+
+ONE Record 3.2.0 Quote & Book charge chain: `Price`, `Ratings` and
+`TransportLegs`, and a full ontology realignment of `BookingOption`,
+`BookingRequest` and `Booking`. Every payload 0.5.0 accepted still parses;
+the 0.5.0 booking keys are kept and deprecated. The ontology pin stays 3.2.0.
+Upgrade receivers first (see `MIGRATING.md`).
+
+### Added
+
+- `Price`, `Ratings` and `TransportLegs` classes with codecs, schemas and
+  `serialize*` / `serialize*Strict` / `deserialize*` helpers; registered in
+  `CLASSES`, `CODECS`, the facade and `createMapper`.
+- Code lists `ChargeIdentifier`, `PrepaidCollectIndicator`, `EntitlementCode`,
+  `SpaceAllocationCode` and `TransportMeansServiceType`.
+- Nine embedded shapes, exported as types only: `Ranges`, `UnitsPreference`,
+  `CarrierProduct`, `StationRemarks`, `EmbeddedBookingTimes`, `PieceGroup`,
+  `EmbeddedBookingSegment`, `ActivitySequence`, `ContactDetail`.
+- The complete 3.2.0 property sets on `BookingOption`, `BookingRequest` and
+  `Booking` (including the inherited `:LogisticsService` properties).
+- 21 `FIELD_TYPES` entries for the new links.
+- Vendored IATA ONE Record 3.2 / 3.3.0 ontology files (MIT), a typed
+  restriction extractor and a conformance guard that checks the chain
+  schemas against them. 3.3.0 was endorsed on 2026-07-25 and is the current
+  endorsed release; the package intentionally stays on the 3.2.0 pin, and
+  every in-scope Quote & Book class is identical in 3.3.0 (the guard proves
+  this).
+- A `./codecs` runtime-surface snapshot, superset and mixed-fleet property
+  tests against a frozen 0.5.0 oracle, and a Quote & Book chain fixture.
+- Deviations #18 to #22 in `docs/spec-deviations.md`, a Quote & Book wire
+  section in `docs/ONE_RECORD_2_2_PROFILE.md`, and conformance-matrix rows.
+
+### Changed
+
+- `codes.BookingStatus` is now `CONFIRMED | DELETED | QUEUED | REJECTED` and
+  `codes.BookingOptionStatus` is now `BOOKABLE | BOOKED | EXPIRED |
+  NONBOOKABLE | NOT_BOOKABLE | ON_REQUEST | QUEUED` (the ontology values).
+  The old `REQUEST_*` values are no longer in these enums.
+- `Booking.bookingStatus` is widened and optional: it accepts the four ontology values plus
+  `REQUEST_ACCEPTED` and `REQUEST_REVOKED` for 0.5.0 compatibility.
+- `BookingOption.optionStatus`, `BookingRequest.requestStatus` and
+  `BookingRequest.requestor` were required and are now optional;
+  `BookingOption.forBookingRequest` is no longer required.
+- `Booking.bookingStatus` and `Booking.forBookingRequest` were required in
+  0.5.0 and are now optional.
+- The booking-flow helpers refuse ontology-shaped inputs explicitly
+  (`ontology_status_present`, `legacy_status_absent`); 0.5.0-valid inputs
+  behave as before.
+- `__VERSION__` now reports `0.6.0`.
+
+### Deprecated
+
+- Legacy booking-chain keys: `BookingOption.optionStatus`, `expiresAt`,
+  `preferences`; `BookingRequest.requestStatus`, `requestor`, `preferences`;
+  `Booking.forBookingRequest`, `forBookingOption`. Removal is planned for
+  booking Path A, at the latest by 0.8.0 (deviation #18).
+- The booking-flow helpers (the transition functions), `STATE_DIAGRAM` and
+  `canTransition` (deviation #21).
+
+### Fixed
+
+- `FIELD_TYPES['Waybill.referredBookingOption']` pointed at `BookingOption`;
+  the ontology target is `Booking`.
+- `looksLikeIri` now rejects strings that contain whitespace, so free text
+  such as `"NOTE: prepaid"` no longer triggers `iri_not_canonical` under the
+  graph walk (deviation #9).
+
 ## [0.5.0] - 2026-07-26
 
 ONE Record API 2.2.0 interoperability boundary for applications that must

package/MIGRATING.md

@@ -2,6 +2,92 @@
 
 This file documents one entry per minor release.
 
+## Migrating from v0.5.x to v0.6.0
+
+0.6.0 aligns `BookingOption`, `BookingRequest` and `Booking` with the ONE
+Record 3.2.0 Quote & Book chain and adds `Price`, `Ratings` and
+`TransportLegs`. Every payload 0.5.0 accepted still parses (superset
+acceptance), so a mixed fleet keeps working, and a legacy-shaped object
+serialized by 0.6.0 is byte-identical to 0.5.0 output. **Upgrade receivers
+first**: a 0.5.0 receiver rejects the new ontology keys (every schema is
+strict), so a 0.6.0 producer must not send ontology-shaped objects to a
+0.5.0 receiver.
+
+### Breaking or behaviour-changing
+
+- **Keys made optional.** `BookingOption.forBookingRequest` remains an
+  ontology key but is no longer required. The legacy keys
+  `BookingOption.optionStatus`, `BookingRequest.requestStatus` and
+  `BookingRequest.requestor` were required and are now optional. Likewise
+  `Booking.bookingStatus` and `Booking.forBookingRequest` were required in
+  0.5.0 and are now optional. Code that reads them must handle `undefined`
+  (deviation #18).
+- **`Booking.bookingStatus` widened and optional.** It accepts the four `:BookingStatus`
+  values (`CONFIRMED`, `DELETED`, `QUEUED`, `REJECTED`) and, for 0.5.0
+  compatibility, `REQUEST_ACCEPTED` and `REQUEST_REVOKED`.
+- **`codes.BookingStatus` and `codes.BookingOptionStatus` changed values.**
+  `BookingStatus` is now `CONFIRMED | DELETED | QUEUED | REJECTED`;
+  `BookingOptionStatus` is now `BOOKABLE | BOOKED | EXPIRED | NONBOOKABLE |
+  NOT_BOOKABLE | ON_REQUEST | QUEUED`. Comparisons against the old
+  `REQUEST_*` values now fail silently at runtime, and
+  `BookingStatus.parse(booking.bookingStatus)` throws on legacy values; use
+  `RequestStatus` for the legacy values instead.
+- **`FIELD_TYPES['Waybill.referredBookingOption']`** now targets `Booking`,
+  not `BookingOption`, as the ontology defines it.
+- **Booking-flow refusals and deprecation.** The five `booking-flow` helpers,
+  `STATE_DIAGRAM` and `canTransition` are `@deprecated`. They now refuse
+  ontology-shaped inputs: `statusBookingOption` present returns
+  `reason: 'ontology_status_present'`, and an absent `optionStatus` returns
+  `reason: 'legacy_status_absent'`. `acceptBookingRequest` likewise refuses an
+  input with no `requestStatus`, returning `forbidden_state_transition` with
+  `reason: 'legacy_status_absent'` and `from: 'BookingRequest.(absent)'`. Every 0.5.0-valid input behaves as before.
+- **Role swap.** The legacy booking flow assigns the roles the other way
+  round to the ontology, and `BookingTimes`, `BookingSegment` and
+  `BookingPreferences` are LogisticsObject-shaped legacy classes where the
+  ontology has embedded classes (deviation #21). Both go to booking Path A
+  (target 0.7.0).
+- **`looksLikeIri` rejects whitespace.** Free text such as `"NOTE: prepaid"`
+  no longer triggers `iri_not_canonical` under the graph walk (deviation #9). Under the graph walk, whitespace-free strings in non-IRI fields that contain a scheme-like prefix (e.g. `URGENT:Handle`, or a website `HTTPS://Example.com/x` in `ContactDetail.textualValue`) are still checked for canonical IRI form and can yield `iri_not_canonical` (deviation #9).
+
+### Deprecations
+
+The 0.5.0 keys that are not ONE Record properties of their class are
+`@deprecated` and will be removed in booking Path A, at the latest by 0.8.0
+(deviation #18). Emit ontology keys only (`statusBookingOption`,
+`bookingRequest`, `offerValidTo`, ...). Deprecation is visible only through
+the exported `BookingOption`, `BookingRequest` and `Booking` types. It is not
+visible on values inferred from `XSchema.parse(...)`, because the
+deprecation tags live on the hand-written types.
+
+### Additions
+
+- `Price`, `Ratings` and `TransportLegs` are registered in `CLASSES`,
+  `CODECS` (and so `./codecs`), the facade and `createMapper`.
+- New code lists: `ChargeIdentifier`, `PrepaidCollectIndicator`,
+  `EntitlementCode`, `SpaceAllocationCode`, `TransportMeansServiceType`.
+- Nine embedded shapes are exported as types only (`Ranges`,
+  `UnitsPreference`, `CarrierProduct`, `StationRemarks`,
+  `EmbeddedBookingTimes`, `PieceGroup`, `EmbeddedBookingSegment`,
+  `ActivitySequence`, `ContactDetail`).
+
+### Profile rules that now matter
+
+- **Multi-valued properties need a JSON array**, even for one value:
+  `Booking.additionalInformation: "x"` is rejected, `["x"]` is accepted, and
+  `[]` is rejected as `cardinality_violation`.
+- **Reference IRIs are canonicalised, `@id` is not.** `safeIri` lowercases
+  scheme and host and adds `/` for an empty path, but a node's `@id` is kept
+  verbatim. Compare canonical forms when joining a reference to an `@id`.
+- **`xsd:dateTime` needs a timezone** (`Z` or an offset), deviation #22.
+- **Currency.** `Price.grandTotal` and `Ratings.subTotal` are plain numbers
+  (deviation #20). Set `BookingOption.unitsPreference.currency` whenever an
+  option carries a `Price`; receivers may fall back to the Waybill's
+  `CurrencyValue` units. See `docs/ONE_RECORD_2_2_PROFILE.md`.
+- **Duplicate IRIs in `Price.ratings` are accepted**; consumers must not
+  double-count.
+- `BookingShipment` is still the legacy shape; an ontology-shaped
+  BookingShipment is rejected by its codec until booking Path A.
+
 ## Migrating from v0.4.x to v0.5.0
 
 Existing cargo-model imports require no changes. v0.5.0 adds a stricter,

package/README.md

@@ -77,6 +77,9 @@ conformance claim independently:
 - 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.
+- **0.6.0 Quote & Book classes:** new `Price`, `Ratings` and `TransportLegs`,
+  and ontology-complete `BookingOption`, `BookingRequest` and `Booking`
+  (see CHANGELOG and MIGRATING).
 - Opt-in **graph-walk dispatcher** (`createMapper({ graphWalk: true })` or
   `onerecord.dispatch.deserialize.<Class>`) emitting all four cross-node
   integrity ParseError kinds.
@@ -213,6 +216,10 @@ No bound state; suitable for one-off operations and tree-shake-friendly imports.
 
 ### Booking state machine
 
+> Deprecated in 0.6.0. These helpers implement a legacy pre-ontology flow
+> whose roles are swapped versus ONE Record (deviation #21). They refuse
+> ontology-shaped inputs and will be replaced in "booking Path A".
+
 ```typescript
 import { STATE_DIAGRAM, canTransition } from '@flaks/onerecord'
 

package/dist/booking-flow/can-transition.d.ts

@@ -1,3 +1,6 @@
 import { type BookingAction, type BookingType, type Transition } from './state-diagram.js';
+/**
+ * @deprecated Legacy pre-ontology booking flow (roles swapped vs ONE Record, deviation #21). Replacement: booking Path A.
+ */
 export declare function canTransition(fromType: BookingType, fromStatus: string, action: BookingAction): Transition | null;
 //# sourceMappingURL=can-transition.d.ts.map

package/dist/booking-flow/can-transition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"can-transition.d.ts","sourceRoot":"","sources":["../../src/booking-flow/can-transition.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,WAAW,EAEhB,KAAK,UAAU,EAChB,MAAM,oBAAoB,CAAA;AAE3B,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,WAAW,EACrB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,aAAa,GACpB,UAAU,GAAG,IAAI,CAGnB"}
+{"version":3,"file":"can-transition.d.ts","sourceRoot":"","sources":["../../src/booking-flow/can-transition.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,WAAW,EAEhB,KAAK,UAAU,EAChB,MAAM,oBAAoB,CAAA;AAE3B;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,WAAW,EACrB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,aAAa,GACpB,UAAU,GAAG,IAAI,CAGnB"}

package/dist/booking-flow/can-transition.js

@@ -1,5 +1,8 @@
 // src/booking-flow/can-transition.ts
 import { STATE_DIAGRAM, } from './state-diagram.js';
+/**
+ * @deprecated Legacy pre-ontology booking flow (roles swapped vs ONE Record, deviation #21). Replacement: booking Path A.
+ */
 export function canTransition(fromType, fromStatus, action) {
     const t = STATE_DIAGRAM[fromType]?.[fromStatus]?.[action];
     return t ?? null;

package/dist/booking-flow/can-transition.js.map

@@ -1 +1 @@
-{"version":3,"file":"can-transition.js","sourceRoot":"","sources":["../../src/booking-flow/can-transition.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,OAAO,EAGL,aAAa,GAEd,MAAM,oBAAoB,CAAA;AAE3B,MAAM,UAAU,aAAa,CAC3B,QAAqB,EACrB,UAAkB,EAClB,MAAqB;IAErB,MAAM,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,CAAA;IACzD,OAAO,CAAC,IAAI,IAAI,CAAA;AAClB,CAAC"}
+{"version":3,"file":"can-transition.js","sourceRoot":"","sources":["../../src/booking-flow/can-transition.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,OAAO,EAGL,aAAa,GAEd,MAAM,oBAAoB,CAAA;AAE3B;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAqB,EACrB,UAAkB,EAClB,MAAqB;IAErB,MAAM,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,CAAA;IACzD,OAAO,CAAC,IAAI,IAAI,CAAA;AAClB,CAAC"}

package/dist/booking-flow/state-diagram.d.ts

@@ -13,7 +13,11 @@ export interface StateDiagram {
         };
     };
 }
-/** v2 (A1 risk #2): deepFreeze covers leaf Transition objects so STATE_DIAGRAM.X.Y.Z.accept.nextType = '...' fails at runtime. */
+/**
+ * @deprecated Legacy pre-ontology booking flow (roles swapped vs ONE Record, deviation #21). Replacement: booking Path A.
+ *
+ * v2 (A1 risk #2): deepFreeze covers leaf Transition objects so STATE_DIAGRAM.X.Y.Z.accept.nextType = '...' fails at runtime.
+ */
 export declare const STATE_DIAGRAM: StateDiagram;
 export {};
 //# sourceMappingURL=state-diagram.d.ts.map

package/dist/booking-flow/state-diagram.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state-diagram.d.ts","sourceRoot":"","sources":["../../src/booking-flow/state-diagram.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,eAAe,GAAG,sBAAsB,GAAG,SAAS,CAAA;AACjG,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAErE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAA;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,KAAK,IAAI,GAAG,UAAU,GAAG,SAAS,CAAA;AAElC,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG;QAC3B,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG;YAC7B,QAAQ,EAAE,MAAM,IAAI,aAAa,CAAC,CAAC,EAAE,IAAI;SAC1C,CAAA;KACF,CAAA;CACF;AAED,kIAAkI;AAClI,eAAO,MAAM,aAAa,EAAE,YA6B1B,CAAA"}
+{"version":3,"file":"state-diagram.d.ts","sourceRoot":"","sources":["../../src/booking-flow/state-diagram.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,eAAe,GAAG,sBAAsB,GAAG,SAAS,CAAA;AACjG,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAErE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAA;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,KAAK,IAAI,GAAG,UAAU,GAAG,SAAS,CAAA;AAElC,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG;QAC3B,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG;YAC7B,QAAQ,EAAE,MAAM,IAAI,aAAa,CAAC,CAAC,EAAE,IAAI;SAC1C,CAAA;KACF,CAAA;CACF;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,YA6B1B,CAAA"}

package/dist/booking-flow/state-diagram.js

@@ -1,6 +1,10 @@
 // src/booking-flow/state-diagram.ts
 import { deepFreeze } from '../util/deep-freeze.js';
-/** v2 (A1 risk #2): deepFreeze covers leaf Transition objects so STATE_DIAGRAM.X.Y.Z.accept.nextType = '...' fails at runtime. */
+/**
+ * @deprecated Legacy pre-ontology booking flow (roles swapped vs ONE Record, deviation #21). Replacement: booking Path A.
+ *
+ * v2 (A1 risk #2): deepFreeze covers leaf Transition objects so STATE_DIAGRAM.X.Y.Z.accept.nextType = '...' fails at runtime.
+ */
 export const STATE_DIAGRAM = deepFreeze({
     BookingRequest: {
         REQUEST_PENDING: {

package/dist/booking-flow/state-diagram.js.map

@@ -1 +1 @@
-{"version":3,"file":"state-diagram.js","sourceRoot":"","sources":["../../src/booking-flow/state-diagram.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAqBnD,kIAAkI;AAClI,MAAM,CAAC,MAAM,aAAa,GAAiB,UAAU,CAAC;IACpD,cAAc,EAAE;QACd,eAAe,EAAE;YACf,MAAM,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,iBAAiB,EAAE;YACpE,MAAM,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAE;YACtF,MAAM,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,iBAAiB,EAAE,QAAQ,EAAE,IAAI,EAAE;SACtF;KACF;IACD,aAAa,EAAE;QACb,eAAe,EAAE;YACf,MAAM,EAAE,EAAE,QAAQ,EAAE,sBAAsB,EAAE,UAAU,EAAE,iBAAiB,EAAE;YAC3E,MAAM,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAE;YACrF,MAAM,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,iBAAiB,EAAE,QAAQ,EAAE,IAAI,EAAE;YACpF,MAAM,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,iBAAiB,EAAE;SACrE;KACF;IACD,oBAAoB,EAAE;QACpB,eAAe,EAAE;YACf,MAAM,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,kBAAkB,EAAE;YAC/D,MAAM,EAAE,EAAE,QAAQ,EAAE,sBAAsB,EAAE,UAAU,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC5F,MAAM,EAAE,EAAE,QAAQ,EAAE,sBAAsB,EAAE,UAAU,EAAE,iBAAiB,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC3F,MAAM,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,iBAAiB,EAAE;SACrE;KACF;IACD,OAAO,EAAE;QACP,gBAAgB,EAAE;YAChB,MAAM,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,iBAAiB,EAAE,QAAQ,EAAE,IAAI,EAAE;SAC/E;KACF;CACF,CAAC,CAAA"}
+{"version":3,"file":"state-diagram.js","sourceRoot":"","sources":["../../src/booking-flow/state-diagram.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAqBnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAiB,UAAU,CAAC;IACpD,cAAc,EAAE;QACd,eAAe,EAAE;YACf,MAAM,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,iBAAiB,EAAE;YACpE,MAAM,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAE;YACtF,MAAM,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,iBAAiB,EAAE,QAAQ,EAAE,IAAI,EAAE;SACtF;KACF;IACD,aAAa,EAAE;QACb,eAAe,EAAE;YACf,MAAM,EAAE,EAAE,QAAQ,EAAE,sBAAsB,EAAE,UAAU,EAAE,iBAAiB,EAAE;YAC3E,MAAM,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAE;YACrF,MAAM,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,iBAAiB,EAAE,QAAQ,EAAE,IAAI,EAAE;YACpF,MAAM,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,iBAAiB,EAAE;SACrE;KACF;IACD,oBAAoB,EAAE;QACpB,eAAe,EAAE;YACf,MAAM,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,kBAAkB,EAAE;YAC/D,MAAM,EAAE,EAAE,QAAQ,EAAE,sBAAsB,EAAE,UAAU,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC5F,MAAM,EAAE,EAAE,QAAQ,EAAE,sBAAsB,EAAE,UAAU,EAAE,iBAAiB,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC3F,MAAM,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,iBAAiB,EAAE;SACrE;KACF;IACD,OAAO,EAAE;QACP,gBAAgB,EAAE;YAChB,MAAM,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,iBAAiB,EAAE,QAAQ,EAAE,IAAI,EAAE;SAC/E;KACF;CACF,CAAC,CAAA"}

package/dist/booking-flow/transitions.d.ts

@@ -3,9 +3,14 @@ import type { BookingOption } from '../classes/booking-option/schema.js';
 import type { BookingRequest } from '../classes/booking-request/schema.js';
 import type { Booking } from '../classes/booking/schema.js';
 import type { ParseResult } from '../result.js';
+/**
+ * @deprecated Legacy pre-ontology booking flow (roles swapped vs ONE Record, deviation #21). Replacement: booking Path A.
+ */
 export declare function acceptBookingRequest(req: BookingRequest): ParseResult<BookingOption>;
 /**
- * @deprecated v0.2 deprecation; removal in v0.3.
+ * @deprecated Legacy pre-ontology booking flow (roles swapped vs ONE Record, deviation #21). Replacement: booking Path A.
+ *
+ * (Earlier v0.2 deprecation: skips the intermediate state.)
  *
  * Skips the `BookingOptionRequest` intermediate state per spec §5.4
  * STATE_DIAGRAM. Use `acceptBookingOptionViaRequest(opt)` instead and
@@ -14,7 +19,13 @@ export declare function acceptBookingRequest(req: BookingRequest): ParseResult<B
  * shortcut, this annotation will be relaxed.
  */
 export declare function acceptBookingOption(opt: BookingOption): ParseResult<Booking>;
+/**
+ * @deprecated Legacy pre-ontology booking flow (roles swapped vs ONE Record, deviation #21). Replacement: booking Path A.
+ */
 export declare function rejectBookingOption(opt: BookingOption, _reason?: string): ParseResult<BookingOption>;
+/**
+ * @deprecated Legacy pre-ontology booking flow (roles swapped vs ONE Record, deviation #21). Replacement: booking Path A.
+ */
 export declare function revokeBookingOption(opt: BookingOption, _reason?: string): ParseResult<BookingOption>;
 /**
  * Accept a BookingOption per spec §5.4 STATE_DIAGRAM. Returns the
@@ -25,6 +36,8 @@ export declare function revokeBookingOption(opt: BookingOption, _reason?: string
  * only models the forwarder->carrier request transition.
  *
  * Source-state hardcode: see top-of-file comment + deviation #11.
+ *
+ * @deprecated Legacy pre-ontology booking flow (roles swapped vs ONE Record, deviation #21). Replacement: booking Path A.
  */
 export declare function acceptBookingOptionViaRequest(opt: BookingOption): ParseResult<BookingOptionRequest>;
 //# sourceMappingURL=transitions.d.ts.map

package/dist/booking-flow/transitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transitions.d.ts","sourceRoot":"","sources":["../../src/booking-flow/transitions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAA;AACvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAA;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAA;AAC1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AA+B/C,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,cAAc,GAAG,WAAW,CAAC,aAAa,CAAC,CAoBpF;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC,CAqB5E;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,aAAa,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,WAAW,CAAC,aAAa,CAAC,CAmB5B;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,aAAa,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,WAAW,CAAC,aAAa,CAAC,CAa5B;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,aAAa,GACjB,WAAW,CAAC,oBAAoB,CAAC,CAoBnC"}
+{"version":3,"file":"transitions.d.ts","sourceRoot":"","sources":["../../src/booking-flow/transitions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAA;AACvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAA;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAA;AAC1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAE3D,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,cAAc,CAAA;AAuD3D;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,cAAc,GAAG,WAAW,CAAC,aAAa,CAAC,CA+BpF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC,CAuB5E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,aAAa,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,WAAW,CAAC,aAAa,CAAC,CAqB5B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,aAAa,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,WAAW,CAAC,aAAa,CAAC,CAe5B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,aAAa,GACjB,WAAW,CAAC,oBAAoB,CAAC,CAsBnC"}

package/dist/booking-flow/transitions.js

@@ -3,30 +3,63 @@ import { randomUUID } from 'node:crypto';
 import { CARGO_CONTEXT_IRI } from '../version.js';
 import { canTransition } from './can-transition.js';
 /**
- * v0.2 booking-flow status:
- * - `acceptBookingOptionViaRequest` (below) returns the spec-§5.4
- *   intermediate `BookingOptionRequest` — the spec-correct path.
- * - `acceptBookingOption` (legacy, @deprecated) continues to return
- *   `Booking` directly per spec §5.2 signature; removal v0.3 unless
- *   IATA §5.4 reconciliation restores the §5.2 shortcut.
+ * Legacy pre-ontology booking flow (roles swapped vs ONE Record, deviation
+ * #21). These helpers neither read nor write ontology keys: they work only
+ * on the legacy `optionStatus` / `requestStatus` state model and refuse
+ * ontology-shaped inputs (`statusBookingOption` present, or the legacy
+ * status absent) with a `forbidden_state_transition` error carrying a
+ * `reason`. Every 0.5.0-valid input behaves exactly as before.
  *
- * Source-state hardcode: all four BookingOption transition functions
- * (acceptBookingOption, rejectBookingOption, revokeBookingOption,
- * acceptBookingOptionViaRequest) pass the constant `'REQUEST_PENDING'`
- * as the source state to `canTransition` rather than reading
- * `opt.optionStatus`. This is intentional — see deviation #11 in
- * `docs/spec-deviations.md`. The schema's optionStatus enum
- * (OPTION_PROPOSED/_ACCEPTED/_REJECTED) does not align with
- * STATE_DIAGRAM.BookingOption's source-state keys (REQUEST_PENDING).
- * Reading `opt.optionStatus` would make every transition fail.
- * Reconciliation deferred to v0.3.
+ * Source-state hardcode: the four BookingOption helpers still pass the
+ * constant `'REQUEST_PENDING'` to `canTransition` rather than mapping
+ * `opt.optionStatus` onto STATE_DIAGRAM keys (deviation #11). They only
+ * check that `optionStatus` is present.
  */
 const TENANT = 'transitions';
 const HOST = 'flaks.example';
 function makeId(type) {
     return `https://${HOST}/${TENANT}/${type.toLowerCase()}/${randomUUID()}`;
 }
+function refuseOptionInput(opt, to) {
+    if (opt.statusBookingOption !== undefined)
+        return {
+            ok: false,
+            error: {
+                kind: 'forbidden_state_transition',
+                from: `BookingOption.${opt.statusBookingOption}`,
+                to,
+                reason: 'ontology_status_present',
+                path: '$',
+            },
+        };
+    if (opt.optionStatus === undefined)
+        return {
+            ok: false,
+            error: {
+                kind: 'forbidden_state_transition',
+                from: 'BookingOption.(absent)',
+                to,
+                reason: 'legacy_status_absent',
+                path: '$',
+            },
+        };
+    return null;
+}
+/**
+ * @deprecated Legacy pre-ontology booking flow (roles swapped vs ONE Record, deviation #21). Replacement: booking Path A.
+ */
 export function acceptBookingRequest(req) {
+    if (req.requestStatus === undefined)
+        return {
+            ok: false,
+            error: {
+                kind: 'forbidden_state_transition',
+                from: 'BookingRequest.(absent)',
+                to: 'accept',
+                reason: 'legacy_status_absent',
+                path: '$',
+            },
+        };
     const t = canTransition('BookingRequest', req.requestStatus, 'accept');
     if (!t)
         return {
@@ -48,7 +81,9 @@ export function acceptBookingRequest(req) {
     return { ok: true, value: opt };
 }
 /**
- * @deprecated v0.2 deprecation; removal in v0.3.
+ * @deprecated Legacy pre-ontology booking flow (roles swapped vs ONE Record, deviation #21). Replacement: booking Path A.
+ *
+ * (Earlier v0.2 deprecation: skips the intermediate state.)
  *
  * Skips the `BookingOptionRequest` intermediate state per spec §5.4
  * STATE_DIAGRAM. Use `acceptBookingOptionViaRequest(opt)` instead and
@@ -57,6 +92,9 @@ export function acceptBookingRequest(req) {
  * shortcut, this annotation will be relaxed.
  */
 export function acceptBookingOption(opt) {
+    const refused = refuseOptionInput(opt, 'accept');
+    if (refused)
+        return refused;
     const t = canTransition('BookingOption', 'REQUEST_PENDING', 'accept');
     if (!t)
         return {
@@ -73,12 +111,18 @@ export function acceptBookingOption(opt) {
         '@type': 'Booking',
         '@id': makeId('Booking'),
         bookingStatus: 'REQUEST_ACCEPTED',
-        forBookingRequest: opt.forBookingRequest,
+        ...(opt.forBookingRequest !== undefined && { forBookingRequest: opt.forBookingRequest }),
         forBookingOption: opt['@id'],
     };
     return { ok: true, value: booking };
 }
+/**
+ * @deprecated Legacy pre-ontology booking flow (roles swapped vs ONE Record, deviation #21). Replacement: booking Path A.
+ */
 export function rejectBookingOption(opt, _reason) {
+    const refused = refuseOptionInput(opt, 'reject');
+    if (refused)
+        return refused;
     const t = canTransition('BookingOption', 'REQUEST_PENDING', 'reject');
     if (!t)
         return {
@@ -98,7 +142,13 @@ export function rejectBookingOption(opt, _reason) {
         },
     };
 }
+/**
+ * @deprecated Legacy pre-ontology booking flow (roles swapped vs ONE Record, deviation #21). Replacement: booking Path A.
+ */
 export function revokeBookingOption(opt, _reason) {
+    const refused = refuseOptionInput(opt, 'revoke');
+    if (refused)
+        return refused;
     const t = canTransition('BookingOption', 'REQUEST_PENDING', 'revoke');
     if (!t)
         return {
@@ -121,8 +171,13 @@ export function revokeBookingOption(opt, _reason) {
  * only models the forwarder->carrier request transition.
  *
  * Source-state hardcode: see top-of-file comment + deviation #11.
+ *
+ * @deprecated Legacy pre-ontology booking flow (roles swapped vs ONE Record, deviation #21). Replacement: booking Path A.
  */
 export function acceptBookingOptionViaRequest(opt) {
+    const refused = refuseOptionInput(opt, 'accept');
+    if (refused)
+        return refused;
     const t = canTransition('BookingOption', 'REQUEST_PENDING', 'accept');
     if (!t)
         return {

package/dist/booking-flow/transitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"transitions.js","sourceRoot":"","sources":["../../src/booking-flow/transitions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"transitions.js","sourceRoot":"","sources":["../../src/booking-flow/transitions.ts"],"names":[],"mappings":"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"}

package/dist/classes/booking/schema.d.ts

@@ -4,13 +4,103 @@ export declare const BookingSchema: z.ZodObject<{
     '@context': z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
     '@id': z.ZodString;
     '@type': z.ZodLiteral<"Booking">;
-    bookingStatus: z.ZodEnum<{
+    bookingStatus: z.ZodOptional<z.ZodEnum<{
         REQUEST_ACCEPTED: "REQUEST_ACCEPTED";
         REQUEST_REVOKED: "REQUEST_REVOKED";
-    }>;
-    forBookingRequest: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../index.js").SafeIri, string>>;
+        CONFIRMED: "CONFIRMED";
+        DELETED: "DELETED";
+        QUEUED: "QUEUED";
+        REJECTED: "REJECTED";
+    }>>;
+    forBookingRequest: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../index.js").SafeIri, string>>>;
     forBookingOption: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../index.js").SafeIri, string>>>;
+    additionalInformation: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    arrivalLocation: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../index.js").SafeIri, string>>>;
+    departureLocation: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../index.js").SafeIri, string>>>;
+    bookingRequest: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../index.js").SafeIri, string>>>;
+    bookingSegments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        '@type': z.ZodOptional<z.ZodLiteral<"BookingSegment">>;
+        allotmentCode: z.ZodOptional<z.ZodString>;
+        pieceGroups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            '@type': z.ZodOptional<z.ZodLiteral<"PieceGroup">>;
+            dryIceWeight: z.ZodOptional<z.ZodObject<{
+                '@type': z.ZodOptional<z.ZodLiteral<"Value">>;
+                numericalValue: z.ZodNumber;
+                unit: z.ZodString;
+            }, z.core.$strict>>;
+            pieceGroupCount: z.ZodOptional<z.ZodNumber>;
+            pieceGroupGrossWeight: z.ZodOptional<z.ZodObject<{
+                '@type': z.ZodOptional<z.ZodLiteral<"Value">>;
+                numericalValue: z.ZodNumber;
+                unit: z.ZodString;
+            }, z.core.$strict>>;
+            pieceGroupId: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>>;
+        spaceAllocationCode: z.ZodOptional<z.ZodEnum<{
+            CN: "CN";
+            CA: "CA";
+            HK: "HK";
+            HL: "HL";
+            HN: "HN";
+            KK: "KK";
+            LL: "LL";
+            NA: "NA";
+            NL: "NL";
+            NN: "NN";
+            SS: "SS";
+            UN: "UN";
+            UU: "UU";
+            XX: "XX";
+        }>>;
+        transportLegs: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../index.js").SafeIri, string>>>;
+    }, z.core.$strict>>>;
+    bookingShipmentDetails: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../index.js").SafeIri, string>>>;
+    bookingTimes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        '@type': z.ZodOptional<z.ZodLiteral<"BookingTimes">>;
+        earliestAcceptanceTime: z.ZodOptional<z.ZodString>;
+        latestAcceptanceTime: z.ZodOptional<z.ZodString>;
+        latestArrivalTime: z.ZodOptional<z.ZodString>;
+        timeOfAvailability: z.ZodOptional<z.ZodString>;
+        totalTransitTime: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    carrier: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../index.js").SafeIri, string>>>;
+    carrierProduct: z.ZodOptional<z.ZodObject<{
+        '@type': z.ZodOptional<z.ZodLiteral<"CarrierProduct">>;
+        productCode: z.ZodOptional<z.ZodString>;
+        serviceLevelCode: z.ZodOptional<z.ZodString>;
+        productDescription: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    issuedForWaybill: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../index.js").SafeIri, string>>>;
+    shippingInfo: z.ZodOptional<z.ZodString>;
+    shippingRefNo: z.ZodOptional<z.ZodString>;
+    stationRemarks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        '@type': z.ZodOptional<z.ZodLiteral<"StationRemarks">>;
+        station: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../index.js").SafeIri, string>>>;
+        remarksText: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    transportLegs: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../index.js").SafeIri, string>>>>;
+    updateBookingOptionRequests: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../index.js").SafeIri, string>>>>;
+    waybillNumber: z.ZodOptional<z.ZodString>;
+    waybillPrefix: z.ZodOptional<z.ZodString>;
+    activitySequences: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        '@type': z.ZodOptional<z.ZodLiteral<"ActivitySequence">>;
+        activity: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../index.js").SafeIri, string>>>;
+        sequenceNumber: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    contactDetails: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        '@type': z.ZodOptional<z.ZodLiteral<"ContactDetail">>;
+        contactDetailType: z.ZodOptional<z.ZodString>;
+        textualValue: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    contactPersons: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../index.js").SafeIri, string>>>>;
 }, z.core.$strict>;
-export type Booking = z.infer<typeof BookingSchema>;
+type BookingInferred = z.infer<typeof BookingSchema>;
+export type Booking = Omit<BookingInferred, 'forBookingRequest' | 'forBookingOption'> & {
+    /** @deprecated Not a ONE Record property of Booking. Use `bookingRequest`. Removal: booking Path A (deviation #18). */
+    forBookingRequest?: BookingInferred['forBookingRequest'];
+    /** @deprecated Not a ONE Record property of Booking (chain is Booking → BookingRequest → BookingOption). Removal: booking Path A (deviation #18). */
+    forBookingOption?: BookingInferred['forBookingOption'];
+};
 export type JsonLdBooking = JsonLd<'Booking'>;
+export {};
 //# sourceMappingURL=schema.d.ts.map

package/dist/classes/booking/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/classes/booking/schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAGvD,eAAO,MAAM,aAAa;;;;;;;;;;kBAKf,CAAA;AAEX,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AACnD,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,CAAA"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/classes/booking/schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAWvB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAKvD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA0Cf,CAAA;AAEX,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AACpD,MAAM,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,EAAE,mBAAmB,GAAG,kBAAkB,CAAC,GAAG;IACtF,uHAAuH;IACvH,iBAAiB,CAAC,EAAE,eAAe,CAAC,mBAAmB,CAAC,CAAA;IACxD,qJAAqJ;IACrJ,gBAAgB,CAAC,EAAE,eAAe,CAAC,kBAAkB,CAAC,CAAA;CACvD,CAAA;AACD,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,CAAA"}