@flaks/onerecord 0.4.0 → 0.6.0

package/CHANGELOG.md

@@ -4,6 +4,104 @@ 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
+work both inside the Flaks sphere and with standards-only peers.
+
+### Added
+
+- Strict Zod wire schemas for ServerInformation, ChangeRequest,
+  SubscriptionRequest, AccessDelegationRequest, Notification, and their
+  embedded API objects.
+- `assertEndorsedServerInformation`, which rejects peers that do not advertise
+  JSON-LD, API 2.2.0, the non-versioned cargo ontology IRI, and its separately
+  versioned 3.2.0 IRI.
+- `OneRecordPeerProfileSchema` for transporting standards endpoint and OIDC
+  discovery metadata through Flaks Connect without coupling the ONE Record
+  protocol to Connect.
+- The `@flaks/onerecord/api` export and equivalent root exports.
+- A shared implementation profile in `docs/ONE_RECORD_2_2_PROFILE.md`.
+
+### Changed
+
+- `__VERSION__` now reports `0.5.0`.
+- API-layer schemas accept compact `api:`/`cargo:` references as well as
+  absolute IRIs, matching the JSON-LD examples in the endorsed standard.
+
+### Compatibility
+
+- Existing cargo-model codecs and application-layer types are unchanged.
+- No network publication is performed by this repository change. Consumers
+  must move to 0.5.0 only after the package release gate is completed.
+
 ## [0.4.0] - 2026-05-19
 
 ULD composition classes: the `:UnitComposition` / `:Composing` /

package/MIGRATING.md

@@ -2,6 +2,114 @@
 
 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,
+separate API wire boundary:
+
+```ts
+import {
+  OneRecordServerInformationSchema,
+  OneRecordPeerProfileSchema,
+  assertEndorsedServerInformation,
+} from '@flaks/onerecord/api'
+```
+
+Use these schemas at HTTP and Flaks Connect boundaries. Do not substitute the
+older cargo-model `ServerInformationSchema` for API 2.2.0 wire validation; it
+is retained for compatibility with existing application-layer mappings.
+
+The peer profile contains discovery metadata, not credentials. A Connect
+credential bundle may carry this profile, but each application must still
+authenticate, authorize, and communicate using standard ONE Record endpoints
+when the peer is not part of the Flaks sphere.
+
 ## Migrating from v0.3.x to v0.4.0
 
 **No action required.** v0.4.0 is purely additive: it introduces the ULD

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/api/index.d.ts

@@ -0,0 +1,296 @@
+import { z } from 'zod';
+/**
+ * Endorsed ONE Record production baseline (28 July 2025).
+ *
+ * The development specification is deliberately not used as the default wire
+ * contract. Development versions can be advertised in addition to this
+ * baseline once a product implements them completely.
+ */
+export declare const ONE_RECORD_API_VERSION: "2.2.0";
+export declare const ONE_RECORD_CARGO_ONTOLOGY_VERSION: "3.2.0";
+export declare const ONE_RECORD_ORCHESTRATION_VERSION: "1.1.0";
+export declare const ONE_RECORD_API_ONTOLOGY: "https://onerecord.iata.org/ns/api";
+export declare const ONE_RECORD_CARGO_ONTOLOGY: "https://onerecord.iata.org/ns/cargo";
+export declare const ONE_RECORD_API_ONTOLOGY_VERSION: "https://onerecord.iata.org/ns/api/2.2.0";
+export declare const ONE_RECORD_CARGO_ONTOLOGY_VERSION_IRI: "https://onerecord.iata.org/ns/cargo/3.2.0";
+export declare const JsonLdContextSchema: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>;
+export declare const OneRecordReferenceSchema: z.ZodObject<{
+    '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+    '@type': z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export declare const OneRecordTypedValueSchema: z.ZodObject<{
+    '@value': z.ZodString;
+    '@type': z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const OneRecordRequestStatusSchema: z.ZodEnum<{
+    "api:REQUEST_PENDING": "api:REQUEST_PENDING";
+    "api:REQUEST_ACCEPTED": "api:REQUEST_ACCEPTED";
+    "api:REQUEST_REJECTED": "api:REQUEST_REJECTED";
+    "api:REQUEST_FAILED": "api:REQUEST_FAILED";
+    "api:REQUEST_REVOKED": "api:REQUEST_REVOKED";
+    "api:REQUEST_ACKNOWLEDGED": "api:REQUEST_ACKNOWLEDGED";
+}>;
+export declare const OneRecordServerInformationSchema: z.ZodObject<{
+    '@context': z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>;
+    '@id': z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>;
+    '@type': z.ZodUnion<readonly [z.ZodLiteral<"api:ServerInformation">, z.ZodLiteral<"https://onerecord.iata.org/ns/api#ServerInformation">]>;
+    'api:hasDataHolder': z.ZodObject<{
+        '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    'api:hasServerEndpoint': z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>;
+    'api:hasSupportedApiVersion': z.ZodArray<z.ZodString>;
+    'api:hasSupportedContentType': z.ZodArray<z.ZodString>;
+    'api:hasSupportedLanguage': z.ZodArray<z.ZodString>;
+    'api:hasSupportedOntology': z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>>;
+    'api:hasSupportedOntologyVersion': z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>>;
+    'api:hasSupportedEncoding': z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export declare const OneRecordChangeRequestSchema: z.ZodObject<{
+    '@type': z.ZodLiteral<"api:ChangeRequest">;
+    'api:hasChange': z.ZodUnion<readonly [z.ZodObject<{
+        '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>;
+    '@context': z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>;
+    '@id': z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>;
+    'api:hasRequestStatus': z.ZodObject<{
+        '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    'api:isRequestedBy': z.ZodObject<{
+        '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    'api:isRequestedAt': z.ZodObject<{
+        '@value': z.ZodString;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    'api:hasRequestStatusSince': z.ZodOptional<z.ZodObject<{
+        '@value': z.ZodString;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    'api:isRevokedBy': z.ZodOptional<z.ZodObject<{
+        '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    'api:isRevokedAt': z.ZodOptional<z.ZodObject<{
+        '@value': z.ZodString;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    'api:hasError': z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strict>;
+export declare const OneRecordSubscriptionSchema: z.ZodObject<{
+    '@id': z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>>;
+    '@type': z.ZodLiteral<"api:Subscription">;
+    'api:hasContentType': z.ZodOptional<z.ZodString>;
+    'api:hasSubscriber': z.ZodObject<{
+        '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    'api:hasTopicType': z.ZodObject<{
+        '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    'api:includeSubscriptionEventType': z.ZodArray<z.ZodObject<{
+        '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    'api:hasTopic': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodObject<{
+        '@value': z.ZodString;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>;
+    'api:expiresAt': z.ZodOptional<z.ZodObject<{
+        '@value': z.ZodString;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    'api:hasDescription': z.ZodOptional<z.ZodString>;
+    'api:notifyRequestStatusChange': z.ZodOptional<z.ZodBoolean>;
+    'api:sendLogisticsObjectBody': z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const OneRecordSubscriptionRequestSchema: z.ZodObject<{
+    '@type': z.ZodLiteral<"api:SubscriptionRequest">;
+    'api:hasSubscription': z.ZodObject<{
+        '@id': z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>>;
+        '@type': z.ZodLiteral<"api:Subscription">;
+        'api:hasContentType': z.ZodOptional<z.ZodString>;
+        'api:hasSubscriber': z.ZodObject<{
+            '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+            '@type': z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+        'api:hasTopicType': z.ZodObject<{
+            '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+            '@type': z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+        'api:includeSubscriptionEventType': z.ZodArray<z.ZodObject<{
+            '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+            '@type': z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        'api:hasTopic': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodObject<{
+            '@value': z.ZodString;
+            '@type': z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>;
+        'api:expiresAt': z.ZodOptional<z.ZodObject<{
+            '@value': z.ZodString;
+            '@type': z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        'api:hasDescription': z.ZodOptional<z.ZodString>;
+        'api:notifyRequestStatusChange': z.ZodOptional<z.ZodBoolean>;
+        'api:sendLogisticsObjectBody': z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>;
+    '@context': z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>;
+    '@id': z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>;
+    'api:hasRequestStatus': z.ZodObject<{
+        '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    'api:isRequestedBy': z.ZodObject<{
+        '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    'api:isRequestedAt': z.ZodObject<{
+        '@value': z.ZodString;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    'api:hasRequestStatusSince': z.ZodOptional<z.ZodObject<{
+        '@value': z.ZodString;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    'api:isRevokedBy': z.ZodOptional<z.ZodObject<{
+        '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    'api:isRevokedAt': z.ZodOptional<z.ZodObject<{
+        '@value': z.ZodString;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    'api:hasError': z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strict>;
+export declare const OneRecordAccessDelegationSchema: z.ZodObject<{
+    '@id': z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>>;
+    '@type': z.ZodLiteral<"api:AccessDelegation">;
+    'api:hasDescription': z.ZodOptional<z.ZodString>;
+    'api:hasPermission': z.ZodArray<z.ZodObject<{
+        '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    'api:isRequestedFor': z.ZodArray<z.ZodObject<{
+        '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    'api:hasLogisticsObject': z.ZodArray<z.ZodObject<{
+        '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    'api:notifyRequestStatusChange': z.ZodBoolean;
+}, z.core.$strict>;
+export declare const OneRecordAccessDelegationRequestSchema: z.ZodObject<{
+    '@type': z.ZodLiteral<"api:AccessDelegationRequest">;
+    'api:hasAccessDelegation': z.ZodObject<{
+        '@id': z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>>;
+        '@type': z.ZodLiteral<"api:AccessDelegation">;
+        'api:hasDescription': z.ZodOptional<z.ZodString>;
+        'api:hasPermission': z.ZodArray<z.ZodObject<{
+            '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+            '@type': z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        'api:isRequestedFor': z.ZodArray<z.ZodObject<{
+            '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+            '@type': z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        'api:hasLogisticsObject': z.ZodArray<z.ZodObject<{
+            '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+            '@type': z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        'api:notifyRequestStatusChange': z.ZodBoolean;
+    }, z.core.$strict>;
+    '@context': z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>;
+    '@id': z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>;
+    'api:hasRequestStatus': z.ZodObject<{
+        '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    'api:isRequestedBy': z.ZodObject<{
+        '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    'api:isRequestedAt': z.ZodObject<{
+        '@value': z.ZodString;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    'api:hasRequestStatusSince': z.ZodOptional<z.ZodObject<{
+        '@value': z.ZodString;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    'api:isRevokedBy': z.ZodOptional<z.ZodObject<{
+        '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    'api:isRevokedAt': z.ZodOptional<z.ZodObject<{
+        '@value': z.ZodString;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    'api:hasError': z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strict>;
+export declare const OneRecordNotificationSchema: z.ZodObject<{
+    '@context': z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>;
+    '@id': z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>>;
+    '@type': z.ZodLiteral<"api:Notification">;
+    'api:hasEventType': z.ZodObject<{
+        '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    'api:hasLogisticsObject': z.ZodOptional<z.ZodObject<{
+        '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    'api:hasLogisticsEvent': z.ZodOptional<z.ZodObject<{
+        '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    'api:hasLogisticsObjectType': z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodObject<{
+        '@value': z.ZodString;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>>;
+    'api:hasChangedProperty': z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodObject<{
+        '@value': z.ZodString;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>>>;
+    'api:hasTopic': z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodObject<{
+        '@value': z.ZodString;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>>;
+    'api:isTriggeredBy': z.ZodOptional<z.ZodObject<{
+        '@id': z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>, z.ZodString]>;
+        '@type': z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+}, z.core.$strict>;
+export declare const OneRecordOidcProfileSchema: z.ZodObject<{
+    issuer: z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>;
+    token_endpoint: z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>;
+    jwks_uri: z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>;
+    grant_types_supported: z.ZodArray<z.ZodLiteral<"client_credentials">>;
+}, z.core.$strict>;
+/**
+ * Flaks Connect carries this standards-only peer metadata alongside its
+ * optimized application-specific channels. It contains no plaintext secret.
+ */
+export declare const OneRecordPeerProfileSchema: z.ZodObject<{
+    server_endpoint: z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>;
+    server_information: z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>;
+    oidc_discovery: z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>;
+    jwks_uri: z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>;
+    data_holder: z.ZodPipe<z.ZodString, z.ZodTransform<import("../index.js").SafeIri, string>>;
+    api_version: z.ZodLiteral<"2.2.0">;
+    cargo_ontology_version: z.ZodLiteral<"3.2.0">;
+}, z.core.$strict>;
+export type OneRecordServerInformation = z.infer<typeof OneRecordServerInformationSchema>;
+export type OneRecordChangeRequest = z.infer<typeof OneRecordChangeRequestSchema>;
+export type OneRecordSubscription = z.infer<typeof OneRecordSubscriptionSchema>;
+export type OneRecordSubscriptionRequest = z.infer<typeof OneRecordSubscriptionRequestSchema>;
+export type OneRecordAccessDelegation = z.infer<typeof OneRecordAccessDelegationSchema>;
+export type OneRecordAccessDelegationRequest = z.infer<typeof OneRecordAccessDelegationRequestSchema>;
+export type OneRecordNotification = z.infer<typeof OneRecordNotificationSchema>;
+export type OneRecordPeerProfile = z.infer<typeof OneRecordPeerProfileSchema>;
+export declare function assertEndorsedServerInformation(value: unknown): OneRecordServerInformation;
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAG,OAAgB,CAAA;AACtD,eAAO,MAAM,iCAAiC,EAAG,OAAgB,CAAA;AACjE,eAAO,MAAM,gCAAgC,EAAG,OAAgB,CAAA;AAChE,eAAO,MAAM,uBAAuB,EAAG,mCAA4C,CAAA;AACnF,eAAO,MAAM,yBAAyB,EAAG,qCAA8C,CAAA;AACvF,eAAO,MAAM,+BAA+B,2CACqB,CAAA;AACjE,eAAO,MAAM,qCAAqC,6CAC4B,CAAA;AAQ9E,eAAO,MAAM,mBAAmB,oKAI9B,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;iBAKrB,CAAA;AAEhB,eAAO,MAAM,yBAAyB;;;kBAK3B,CAAA;AAEX,eAAO,MAAM,4BAA4B;;;;;;;EAOvC,CAAA;AAEF,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;kBA4CzC,CAAA;AAcJ,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAM9B,CAAA;AAEX,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAc7B,CAAA;AAEX,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAMpC,CAAA;AAEX,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;kBAUjC,CAAA;AAEX,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAMxC,CAAA;AAEX,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAa7B,CAAA;AAEX,eAAO,MAAM,0BAA0B;;;;;kBAO5B,CAAA;AAEX;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;kBAU5B,CAAA;AAEX,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAA;AACzF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AACjF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAC/E,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAC7F,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AACvF,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CACpD,OAAO,sCAAsC,CAC9C,CAAA;AACD,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAC/E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAE7E,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,0BAA0B,CAa1F"}