@voyantjs/catalog 0.57.0 → 0.59.0

package/README.md

@@ -25,6 +25,7 @@ pnpm add @voyantjs/catalog
 - **`./drift/events`** — drift event types for upstream change detection.
 - **`./events/taxonomy`** — catalog event names + visibility-filtered payload builders, emitted via `@voyantjs/core/events` and consumed by the existing webhook pipeline.
 - **`./adapter/contract`** — public source-adapter contract. Voyant Connect, third-party providers, operator-built adapters all implement this.
+- **`./adapter/schemas`** — zod schemas for source-adapter runtime payloads. Use these at HTTP, queue, RPC, and adapter boundaries instead of re-declaring validators.
 - **`./booking-engine`** — quote/book services plus the Hono route module that backs `@voyantjs/catalog-react/booking-engine` and `@voyantjs/bookings-ui/journey`.
 
 ## Architectural rules
@@ -64,6 +65,19 @@ export const productCatalogPolicy = defineFieldPolicy([
 
 See `docs/architecture/catalog-architecture.md` for the full contract and worked examples.
 
+## Source-adapter runtime validation
+
+```typescript
+import { reserveRequestSchema } from "@voyantjs/catalog/adapter/schemas"
+import type { ReserveRequest } from "@voyantjs/catalog/adapter/contract"
+
+const request: ReserveRequest = reserveRequestSchema.parse(await req.json())
+```
+
+Reserve and cancel requests may include a `scope` matching live resolution plus
+an `idempotency_key`; cancel results may return `status: "pending"` with
+`pending_channel` for async upstream workflows.
+
 ## BookingJourney HTTP routes
 
 `@voyantjs/catalog` exports `createCatalogBookingHonoModule(...)` and

package/dist/adapter/booking-forwarding.d.ts

@@ -0,0 +1,46 @@
+export interface SourceAdapterRequestScope {
+    locale: string;
+    audience: string;
+    market: string;
+    currency?: string;
+}
+export interface ReserveRequest {
+    entity_module: string;
+    entity_id: string;
+    parameters: Record<string, unknown>;
+    /** Customer / passenger identity, vertical-shaped. */
+    party?: Record<string, unknown>;
+    /** Payment intent for verticals that distinguish hold vs ticket. */
+    payment_intent?: Record<string, unknown>;
+    /** Per-request scope. Mirrors `LiveResolveRequest.scope`. */
+    scope?: SourceAdapterRequestScope;
+    /** Replay-safe write key. Same key on retries means same upstream effect. */
+    idempotency_key?: string;
+}
+export interface ReserveResult {
+    /** Upstream order / booking identifier — used as `source_ref` in snapshots. */
+    upstream_ref: string;
+    /** Status returned by the upstream system. */
+    status: "held" | "confirmed" | "ticketed" | "failed";
+    /** Opaque per-vertical payload echoed back to the snapshot graph. */
+    upstream_payload?: Record<string, unknown>;
+}
+export interface CancelRequest {
+    upstream_ref: string;
+    reason?: string;
+    /** Per-request scope. Mirrors `LiveResolveRequest.scope`. */
+    scope?: SourceAdapterRequestScope;
+    /** Replay-safe write key. Same key on retries means same upstream effect. */
+    idempotency_key?: string;
+}
+export interface CancelResult {
+    status: "cancelled" | "pending" | "refused" | "failed";
+    refund_amount?: number;
+    refund_currency?: string;
+    /**
+     * Free-text channel through which an async cancellation was submitted
+     * when `status` is "pending" (email, partner portal, batch, etc.).
+     */
+    pending_channel?: string;
+}
+//# sourceMappingURL=booking-forwarding.d.ts.map

package/dist/adapter/booking-forwarding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"booking-forwarding.d.ts","sourceRoot":"","sources":["../../src/adapter/booking-forwarding.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,6DAA6D;IAC7D,KAAK,CAAC,EAAE,yBAAyB,CAAA;IACjC,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,+EAA+E;IAC/E,YAAY,EAAE,MAAM,CAAA;IACpB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAA;IACpD,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC3C;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6DAA6D;IAC7D,KAAK,CAAC,EAAE,yBAAyB,CAAA;IACjC,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAA;IACtD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB"}

package/dist/adapter/booking-forwarding.js

@@ -0,0 +1 @@
+export {};

package/dist/adapter/contract.d.ts

@@ -16,6 +16,8 @@
  */
 import type { CatalogDriftEvent } from "../drift/events.js";
 import type { Provenance } from "../provenance.js";
+import type { CancelRequest, CancelResult, ReserveRequest, ReserveResult, SourceAdapterRequestScope } from "./booking-forwarding.js";
+export type { CancelRequest, CancelResult, ReserveRequest, ReserveResult, SourceAdapterRequestScope, } from "./booking-forwarding.js";
 /**
  * Capability declaration. Adapters return their capabilities at registration
  * so the catalog plane can route operations correctly and fail fast on
@@ -38,6 +40,13 @@ export interface AdapterCapabilities {
     supportsDriftDetection: boolean;
     /** Whether the adapter forwards bookings to the upstream source. */
     supportsBookingForwarding: boolean;
+    /**
+     * Whether `cancel` returns a terminal upstream status synchronously.
+     * When false, the adapter may return `status: "pending"` and drive the
+     * final transition later through drift, polling, or connector-specific
+     * reconciliation.
+     */
+    supportsSyncCancellation?: boolean;
     /** Post-book operations the adapter supports (modify, cancel, status, refund). */
     postBookOperations: ReadonlyArray<"modify" | "cancel" | "status" | "refund" | "exchange" | "void">;
     /**
@@ -131,12 +140,7 @@ export interface DiscoveryPage {
 export interface LiveResolveRequest {
     ids: string[];
     /** Variant scope for the request (mirrors the resolver's scope). */
-    scope: {
-        locale: string;
-        audience: string;
-        market: string;
-        currency?: string;
-    };
+    scope: SourceAdapterRequestScope;
     /** Date range or other vertical-specific parameters. */
     parameters?: Record<string, unknown>;
 }
@@ -222,32 +226,6 @@ export interface GetContentResult {
     /** ETag-style marker for HTTP-cache revalidation on the next pull. */
     etag?: string;
 }
-export interface ReserveRequest {
-    entity_module: string;
-    entity_id: string;
-    parameters: Record<string, unknown>;
-    /** Customer / passenger identity, vertical-shaped. */
-    party?: Record<string, unknown>;
-    /** Payment intent for verticals that distinguish hold vs ticket. */
-    payment_intent?: Record<string, unknown>;
-}
-export interface ReserveResult {
-    /** Upstream order / booking identifier — used as `source_ref` in snapshots. */
-    upstream_ref: string;
-    /** Status returned by the upstream system. */
-    status: "held" | "confirmed" | "ticketed" | "failed";
-    /** Opaque per-vertical payload echoed back to the snapshot graph. */
-    upstream_payload?: Record<string, unknown>;
-}
-export interface CancelRequest {
-    upstream_ref: string;
-    reason?: string;
-}
-export interface CancelResult {
-    status: "cancelled" | "refused" | "failed";
-    refund_amount?: number;
-    refund_currency?: string;
-}
 /**
  * Push-booking request — when a booking commits locally on a syndicated
  * owned product, the channel push pipeline calls `pushBooking` for each

package/dist/adapter/contract.d.ts.map

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

package/dist/adapter/contract.test.js

@@ -1,4 +1,5 @@
 import { describe, expect, it } from "vitest";
+import { cancelRequestSchema, reserveRequestSchema } from "./schemas.js";
 describe("AdapterCapabilities — content fetch declaration", () => {
     it("accepts adapters that omit supportsContentFetch (backward compatible)", () => {
         const cap = {
@@ -136,3 +137,78 @@ describe("SourceAdapter — getContent capability gating", () => {
         expect(result.content_schema_version).toBe("products/v1");
     });
 });
+describe("ReserveRequest / CancelRequest scoped write shape", () => {
+    it("round-trips reserve requests with request scope and idempotency key", () => {
+        const request = {
+            entity_module: "products",
+            entity_id: "prod_abc",
+            parameters: { departureId: "dep_1" },
+            party: { travelers: 2 },
+            scope: {
+                locale: "en-GB",
+                audience: "customer",
+                market: "GB",
+                currency: "GBP",
+            },
+            idempotency_key: "reserve_abc",
+        };
+        expect(reserveRequestSchema.parse(request)).toEqual(request);
+    });
+    it("round-trips cancel requests with request scope and idempotency key", () => {
+        const request = {
+            upstream_ref: "booking_abc",
+            reason: "customer_request",
+            scope: {
+                locale: "en-GB",
+                audience: "customer",
+                market: "GB",
+                currency: "GBP",
+            },
+            idempotency_key: "cancel_abc",
+        };
+        expect(cancelRequestSchema.parse(request)).toEqual(request);
+    });
+});
+describe("SourceAdapter — cancellation capability declaration", () => {
+    it("typechecks sync cancellation adapters that return terminal statuses", async () => {
+        const adapter = {
+            kind: "sync-cancel",
+            capabilities: {
+                verticals: ["products"],
+                supportsLiveResolution: false,
+                supportsDriftDetection: false,
+                supportsBookingForwarding: true,
+                supportsSyncCancellation: true,
+                postBookOperations: ["cancel"],
+            },
+            async cancel() {
+                return { status: "cancelled", refund_amount: 100, refund_currency: "GBP" };
+            },
+        };
+        await expect(adapter.cancel({ connection_id: "conn_1" }, { upstream_ref: "up_1" })).resolves.toEqual({
+            status: "cancelled",
+            refund_amount: 100,
+            refund_currency: "GBP",
+        });
+    });
+    it("typechecks async cancellation adapters that return pending", async () => {
+        const adapter = {
+            kind: "async-cancel",
+            capabilities: {
+                verticals: ["products"],
+                supportsLiveResolution: false,
+                supportsDriftDetection: true,
+                supportsBookingForwarding: true,
+                supportsSyncCancellation: false,
+                postBookOperations: ["cancel"],
+            },
+            async cancel() {
+                return { status: "pending", pending_channel: "partner portal" };
+            },
+        };
+        await expect(adapter.cancel({ connection_id: "conn_1" }, { upstream_ref: "up_1" })).resolves.toEqual({
+            status: "pending",
+            pending_channel: "partner portal",
+        });
+    });
+});

package/dist/adapter/schemas.d.ts

@@ -0,0 +1,272 @@
+import { z } from "zod";
+import type { SourceAdapter } from "./contract.js";
+export declare const postBookOperationSchema: z.ZodEnum<{
+    modify: "modify";
+    cancel: "cancel";
+    status: "status";
+    refund: "refund";
+    exchange: "exchange";
+    void: "void";
+}>;
+export declare const adapterCapabilitiesSchema: z.ZodObject<{
+    verticals: z.ZodArray<z.ZodString>;
+    supportsLiveResolution: z.ZodBoolean;
+    supportsDriftDetection: z.ZodBoolean;
+    supportsBookingForwarding: z.ZodBoolean;
+    supportsSyncCancellation: z.ZodOptional<z.ZodBoolean>;
+    postBookOperations: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+        modify: "modify";
+        cancel: "cancel";
+        status: "status";
+        refund: "refund";
+        exchange: "exchange";
+        void: "void";
+    }>>>;
+    cacheTtlSeconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    supportsContentFetch: z.ZodOptional<z.ZodBoolean>;
+    supportedContentLocales: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+    holdReleaseGraceMs: z.ZodOptional<z.ZodNumber>;
+    supportsBookingPush: z.ZodOptional<z.ZodBoolean>;
+    supportsAvailabilityPush: z.ZodOptional<z.ZodBoolean>;
+    supportsContentPush: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const connectionStateSchema: z.ZodEnum<{
+    active: "active";
+    paused: "paused";
+    disconnected: "disconnected";
+    error: "error";
+}>;
+export declare const sourceAdapterContextSchema: z.ZodObject<{
+    connection_id: z.ZodString;
+    credentials: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    tenant_id: z.ZodOptional<z.ZodString>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const sourceFreshnessSchema: z.ZodNullable<z.ZodEnum<{
+    sync: "sync";
+    event: "event";
+    request: "request";
+    static: "static";
+}>>;
+export declare const provenanceSchema: z.ZodObject<{
+    source_kind: z.ZodString;
+    source_provider: z.ZodOptional<z.ZodString>;
+    source_connection_id: z.ZodOptional<z.ZodString>;
+    source_ref: z.ZodOptional<z.ZodString>;
+    source_freshness: z.ZodNullable<z.ZodEnum<{
+        sync: "sync";
+        event: "event";
+        request: "request";
+        static: "static";
+    }>>;
+    last_sourced_at: z.ZodOptional<z.ZodDate>;
+}, z.core.$strip>;
+export declare const catalogProjectionSchema: z.ZodObject<{
+    entity_module: z.ZodString;
+    entity_id: z.ZodString;
+    provenance: z.ZodObject<{
+        source_kind: z.ZodString;
+        source_provider: z.ZodOptional<z.ZodString>;
+        source_connection_id: z.ZodOptional<z.ZodString>;
+        source_ref: z.ZodOptional<z.ZodString>;
+        source_freshness: z.ZodNullable<z.ZodEnum<{
+            sync: "sync";
+            event: "event";
+            request: "request";
+            static: "static";
+        }>>;
+        last_sourced_at: z.ZodOptional<z.ZodDate>;
+    }, z.core.$strip>;
+    fields: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const discoveryCursorSchema: z.ZodCustom<string | undefined, string | undefined>;
+export declare const discoveryPageSchema: z.ZodObject<{
+    projections: z.ZodArray<z.ZodObject<{
+        entity_module: z.ZodString;
+        entity_id: z.ZodString;
+        provenance: z.ZodObject<{
+            source_kind: z.ZodString;
+            source_provider: z.ZodOptional<z.ZodString>;
+            source_connection_id: z.ZodOptional<z.ZodString>;
+            source_ref: z.ZodOptional<z.ZodString>;
+            source_freshness: z.ZodNullable<z.ZodEnum<{
+                sync: "sync";
+                event: "event";
+                request: "request";
+                static: "static";
+            }>>;
+            last_sourced_at: z.ZodOptional<z.ZodDate>;
+        }, z.core.$strip>;
+        fields: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>>;
+    next_cursor: z.ZodCustom<string | undefined, string | undefined>;
+}, z.core.$strip>;
+export declare const liveResolveScopeSchema: z.ZodObject<{
+    locale: z.ZodString;
+    audience: z.ZodString;
+    market: z.ZodString;
+    currency: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const sourceAdapterRequestScopeSchema: z.ZodObject<{
+    locale: z.ZodString;
+    audience: z.ZodString;
+    market: z.ZodString;
+    currency: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const liveResolveRequestSchema: z.ZodObject<{
+    ids: z.ZodArray<z.ZodString>;
+    scope: z.ZodObject<{
+        locale: z.ZodString;
+        audience: z.ZodString;
+        market: z.ZodString;
+        currency: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const liveResolveFailedReasonSchema: z.ZodEnum<{
+    timeout: "timeout";
+    error: "error";
+    not_found: "not_found";
+    unavailable: "unavailable";
+    departure_not_found: "departure_not_found";
+    departure_unavailable: "departure_unavailable";
+    unsupported: "unsupported";
+}>;
+export declare const liveResolveResultSchema: z.ZodObject<{
+    values: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    failed: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+        timeout: "timeout";
+        error: "error";
+        not_found: "not_found";
+        unavailable: "unavailable";
+        departure_not_found: "departure_not_found";
+        departure_unavailable: "departure_unavailable";
+        unsupported: "unsupported";
+    }>>>;
+}, z.core.$strip>;
+export declare const getContentRequestSchema: z.ZodObject<{
+    entity_module: z.ZodString;
+    entity_id: z.ZodString;
+    locale: z.ZodString;
+    market: z.ZodOptional<z.ZodString>;
+    currency: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const getContentResultSchema: z.ZodObject<{
+    entity_module: z.ZodString;
+    entity_id: z.ZodString;
+    source_ref: z.ZodString;
+    returned_locale: z.ZodString;
+    machine_translated: z.ZodOptional<z.ZodBoolean>;
+    content: z.ZodUnknown;
+    content_schema_version: z.ZodString;
+    source_updated_at: z.ZodOptional<z.ZodDate>;
+    fresh_until: z.ZodOptional<z.ZodDate>;
+    etag: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const reserveRequestSchema: z.ZodObject<{
+    entity_module: z.ZodString;
+    entity_id: z.ZodString;
+    parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    party: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    payment_intent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    scope: z.ZodOptional<z.ZodObject<{
+        locale: z.ZodString;
+        audience: z.ZodString;
+        market: z.ZodString;
+        currency: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    idempotency_key: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const reserveStatusSchema: z.ZodEnum<{
+    held: "held";
+    confirmed: "confirmed";
+    ticketed: "ticketed";
+    failed: "failed";
+}>;
+export declare const reserveResultSchema: z.ZodObject<{
+    upstream_ref: z.ZodString;
+    status: z.ZodEnum<{
+        held: "held";
+        confirmed: "confirmed";
+        ticketed: "ticketed";
+        failed: "failed";
+    }>;
+    upstream_payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const cancelRequestSchema: z.ZodObject<{
+    upstream_ref: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodObject<{
+        locale: z.ZodString;
+        audience: z.ZodString;
+        market: z.ZodString;
+        currency: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    idempotency_key: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const cancelStatusSchema: z.ZodEnum<{
+    failed: "failed";
+    cancelled: "cancelled";
+    pending: "pending";
+    refused: "refused";
+}>;
+export declare const cancelResultSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        failed: "failed";
+        cancelled: "cancelled";
+        pending: "pending";
+        refused: "refused";
+    }>;
+    refund_amount: z.ZodOptional<z.ZodNumber>;
+    refund_currency: z.ZodOptional<z.ZodString>;
+    pending_channel: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const pushBookingRequestSchema: z.ZodObject<{
+    idempotencyKey: z.ZodString;
+    bookingId: z.ZodString;
+    bookingItemId: z.ZodOptional<z.ZodString>;
+    externalProductId: z.ZodString;
+    externalRateId: z.ZodOptional<z.ZodString>;
+    externalCategoryId: z.ZodOptional<z.ZodString>;
+    channelId: z.ZodString;
+    contractPolicy: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const pushBookingResultSchema: z.ZodObject<{
+    upstreamRef: z.ZodString;
+    externalReference: z.ZodOptional<z.ZodString>;
+    externalStatus: z.ZodOptional<z.ZodString>;
+    upstreamPayload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const pushAvailabilityRequestSchema: z.ZodObject<{
+    channelId: z.ZodString;
+    externalProductId: z.ZodString;
+    externalRateId: z.ZodOptional<z.ZodString>;
+    externalCategoryId: z.ZodOptional<z.ZodString>;
+    slotId: z.ZodString;
+    productId: z.ZodString;
+    optionId: z.ZodOptional<z.ZodString>;
+    startsAt: z.ZodUnion<readonly [z.ZodDate, z.ZodString]>;
+    remainingPax: z.ZodNumber;
+    source: z.ZodString;
+}, z.core.$strip>;
+export declare const pushAvailabilityResultSchema: z.ZodObject<{
+    externalStatus: z.ZodOptional<z.ZodString>;
+    upstreamPayload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const pushContentRequestSchema: z.ZodObject<{
+    channelId: z.ZodString;
+    externalProductId: z.ZodString;
+    productId: z.ZodString;
+    contentHash: z.ZodString;
+    content: z.ZodUnknown;
+    contentSchemaVersion: z.ZodOptional<z.ZodString>;
+    locale: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const pushContentResultSchema: z.ZodObject<{
+    externalStatus: z.ZodOptional<z.ZodString>;
+    upstreamPayload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    acknowledgedHash: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const sourceAdapterSchema: z.ZodCustom<SourceAdapter, SourceAdapter>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/adapter/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/adapter/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAalD,eAAO,MAAM,uBAAuB;;;;;;;EAOlC,CAAA;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;iBAcpC,CAAA;AAEF,eAAO,MAAM,qBAAqB;;;;;EAAwD,CAAA;AAE1F,eAAO,MAAM,0BAA0B;;;;;iBAKrC,CAAA;AAEF,eAAO,MAAM,qBAAqB;;;;;GAA4D,CAAA;AAE9F,eAAO,MAAM,gBAAgB;;;;;;;;;;;;iBAO3B,CAAA;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;iBAKlC,CAAA;AAEF,eAAO,MAAM,qBAAqB,qDAEjC,CAAA;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;iBAG9B,CAAA;AAEF,eAAO,MAAM,sBAAsB;;;;;iBAKjC,CAAA;AAEF,eAAO,MAAM,+BAA+B;;;;;iBAAyB,CAAA;AAErE,eAAO,MAAM,wBAAwB;;;;;;;;;iBAInC,CAAA;AAEF,eAAO,MAAM,6BAA6B;;;;;;;;EAQxC,CAAA;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;iBAGlC,CAAA;AAEF,eAAO,MAAM,uBAAuB;;;;;;iBAMlC,CAAA;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;iBAWjC,CAAA;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;iBAQ/B,CAAA;AAEF,eAAO,MAAM,mBAAmB;;;;;EAAsD,CAAA;AAEtF,eAAO,MAAM,mBAAmB;;;;;;;;;iBAI9B,CAAA;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;;iBAK9B,CAAA;AAEF,eAAO,MAAM,kBAAkB;;;;;EAAwD,CAAA;AAEvF,eAAO,MAAM,kBAAkB;;;;;;;;;;iBAK7B,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;iBAUnC,CAAA;AAEF,eAAO,MAAM,uBAAuB;;;;;iBAKlC,CAAA;AAEF,eAAO,MAAM,6BAA6B;;;;;;;;;;;iBAWxC,CAAA;AAEF,eAAO,MAAM,4BAA4B;;;iBAGvC,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;iBAQnC,CAAA;AAEF,eAAO,MAAM,uBAAuB;;;;iBAIlC,CAAA;AAEF,eAAO,MAAM,mBAAmB,2CAsB/B,CAAA"}

package/dist/adapter/schemas.js

@@ -0,0 +1,199 @@
+import { z } from "zod";
+const recordSchema = z.record(z.string(), z.unknown());
+const localeSchema = z.string().regex(/^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$/);
+const currencySchema = z.string().length(3);
+const dateOrStringSchema = z.union([z.date(), z.string()]);
+const catalogVerticalSchema = z.string();
+const isRecord = (value) => typeof value === "object" && value !== null;
+const optionalFunction = (value) => value === undefined || typeof value === "function";
+export const postBookOperationSchema = z.enum([
+    "modify",
+    "cancel",
+    "status",
+    "refund",
+    "exchange",
+    "void",
+]);
+export const adapterCapabilitiesSchema = z.object({
+    verticals: z.array(catalogVerticalSchema),
+    supportsLiveResolution: z.boolean(),
+    supportsDriftDetection: z.boolean(),
+    supportsBookingForwarding: z.boolean(),
+    supportsSyncCancellation: z.boolean().optional(),
+    postBookOperations: z.array(postBookOperationSchema).readonly(),
+    cacheTtlSeconds: z.number().int().min(0).nullable().optional(),
+    supportsContentFetch: z.boolean().optional(),
+    supportedContentLocales: z.array(localeSchema).readonly().optional(),
+    holdReleaseGraceMs: z.number().int().min(0).optional(),
+    supportsBookingPush: z.boolean().optional(),
+    supportsAvailabilityPush: z.boolean().optional(),
+    supportsContentPush: z.boolean().optional(),
+});
+export const connectionStateSchema = z.enum(["active", "paused", "disconnected", "error"]);
+export const sourceAdapterContextSchema = z.object({
+    connection_id: z.string(),
+    credentials: z.record(z.string(), z.string()).optional(),
+    tenant_id: z.string().optional(),
+    correlation_id: z.string().optional(),
+});
+export const sourceFreshnessSchema = z.enum(["sync", "event", "request", "static"]).nullable();
+export const provenanceSchema = z.object({
+    source_kind: z.string(),
+    source_provider: z.string().optional(),
+    source_connection_id: z.string().optional(),
+    source_ref: z.string().optional(),
+    source_freshness: sourceFreshnessSchema,
+    last_sourced_at: z.date().optional(),
+});
+export const catalogProjectionSchema = z.object({
+    entity_module: catalogVerticalSchema,
+    entity_id: z.string(),
+    provenance: provenanceSchema,
+    fields: recordSchema,
+});
+export const discoveryCursorSchema = z.custom((value) => value === undefined || typeof value === "string");
+export const discoveryPageSchema = z.object({
+    projections: z.array(catalogProjectionSchema),
+    next_cursor: discoveryCursorSchema,
+});
+export const liveResolveScopeSchema = z.object({
+    locale: localeSchema,
+    audience: z.string(),
+    market: z.string(),
+    currency: currencySchema.optional(),
+});
+export const sourceAdapterRequestScopeSchema = liveResolveScopeSchema;
+export const liveResolveRequestSchema = z.object({
+    ids: z.array(z.string()),
+    scope: liveResolveScopeSchema,
+    parameters: recordSchema.optional(),
+});
+export const liveResolveFailedReasonSchema = z.enum([
+    "timeout",
+    "not_found",
+    "unavailable",
+    "departure_not_found",
+    "departure_unavailable",
+    "unsupported",
+    "error",
+]);
+export const liveResolveResultSchema = z.object({
+    values: z.record(z.string(), recordSchema),
+    failed: z.record(z.string(), liveResolveFailedReasonSchema).optional(),
+});
+export const getContentRequestSchema = z.object({
+    entity_module: catalogVerticalSchema,
+    entity_id: z.string(),
+    locale: localeSchema,
+    market: z.string().optional(),
+    currency: currencySchema.optional(),
+});
+export const getContentResultSchema = z.object({
+    entity_module: catalogVerticalSchema,
+    entity_id: z.string(),
+    source_ref: z.string(),
+    returned_locale: localeSchema,
+    machine_translated: z.boolean().optional(),
+    content: z.unknown(),
+    content_schema_version: z.string(),
+    source_updated_at: z.date().optional(),
+    fresh_until: z.date().optional(),
+    etag: z.string().optional(),
+});
+export const reserveRequestSchema = z.object({
+    entity_module: catalogVerticalSchema,
+    entity_id: z.string(),
+    parameters: recordSchema,
+    party: recordSchema.optional(),
+    payment_intent: recordSchema.optional(),
+    scope: sourceAdapterRequestScopeSchema.optional(),
+    idempotency_key: z.string().optional(),
+});
+export const reserveStatusSchema = z.enum(["held", "confirmed", "ticketed", "failed"]);
+export const reserveResultSchema = z.object({
+    upstream_ref: z.string(),
+    status: reserveStatusSchema,
+    upstream_payload: recordSchema.optional(),
+});
+export const cancelRequestSchema = z.object({
+    upstream_ref: z.string(),
+    reason: z.string().optional(),
+    scope: sourceAdapterRequestScopeSchema.optional(),
+    idempotency_key: z.string().optional(),
+});
+export const cancelStatusSchema = z.enum(["cancelled", "pending", "refused", "failed"]);
+export const cancelResultSchema = z.object({
+    status: cancelStatusSchema,
+    refund_amount: z.number().optional(),
+    refund_currency: currencySchema.optional(),
+    pending_channel: z.string().optional(),
+});
+export const pushBookingRequestSchema = z.object({
+    idempotencyKey: z.string(),
+    bookingId: z.string(),
+    bookingItemId: z.string().optional(),
+    externalProductId: z.string(),
+    externalRateId: z.string().optional(),
+    externalCategoryId: z.string().optional(),
+    channelId: z.string(),
+    contractPolicy: recordSchema.optional(),
+    payload: recordSchema,
+});
+export const pushBookingResultSchema = z.object({
+    upstreamRef: z.string(),
+    externalReference: z.string().optional(),
+    externalStatus: z.string().optional(),
+    upstreamPayload: recordSchema.optional(),
+});
+export const pushAvailabilityRequestSchema = z.object({
+    channelId: z.string(),
+    externalProductId: z.string(),
+    externalRateId: z.string().optional(),
+    externalCategoryId: z.string().optional(),
+    slotId: z.string(),
+    productId: z.string(),
+    optionId: z.string().optional(),
+    startsAt: dateOrStringSchema,
+    remainingPax: z.number().int().min(0),
+    source: z.string(),
+});
+export const pushAvailabilityResultSchema = z.object({
+    externalStatus: z.string().optional(),
+    upstreamPayload: recordSchema.optional(),
+});
+export const pushContentRequestSchema = z.object({
+    channelId: z.string(),
+    externalProductId: z.string(),
+    productId: z.string(),
+    contentHash: z.string(),
+    content: z.unknown(),
+    contentSchemaVersion: z.string().optional(),
+    locale: localeSchema.optional(),
+});
+export const pushContentResultSchema = z.object({
+    externalStatus: z.string().optional(),
+    upstreamPayload: recordSchema.optional(),
+    acknowledgedHash: z.string().optional(),
+});
+export const sourceAdapterSchema = z.custom((value) => {
+    if (!isRecord(value) || typeof value.kind !== "string")
+        return false;
+    if (!adapterCapabilitiesSchema.safeParse(value.capabilities).success)
+        return false;
+    return [
+        "connect",
+        "pause",
+        "disconnect",
+        "getState",
+        "discover",
+        "freshnessCheck",
+        "liveResolve",
+        "getContent",
+        "reserve",
+        "cancel",
+        "pushBooking",
+        "pushAvailability",
+        "pushContent",
+        "onDrift",
+    ].every((key) => optionalFunction(value[key]));
+}, { message: "Invalid source adapter" });

package/dist/adapter/schemas.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schemas.test.d.ts.map

package/dist/adapter/schemas.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.test.d.ts","sourceRoot":"","sources":["../../src/adapter/schemas.test.ts"],"names":[],"mappings":""}

package/dist/adapter/schemas.test.js

@@ -0,0 +1,273 @@
+import { describe, expect, it } from "vitest";
+import { adapterCapabilitiesSchema, cancelRequestSchema, cancelResultSchema, catalogProjectionSchema, connectionStateSchema, discoveryCursorSchema, discoveryPageSchema, getContentRequestSchema, getContentResultSchema, liveResolveRequestSchema, liveResolveResultSchema, provenanceSchema, pushAvailabilityRequestSchema, pushAvailabilityResultSchema, pushBookingRequestSchema, pushBookingResultSchema, pushContentRequestSchema, pushContentResultSchema, reserveRequestSchema, reserveResultSchema, sourceAdapterContextSchema, sourceAdapterRequestScopeSchema, sourceAdapterSchema, } from "./schemas.js";
+const typeChecks = [
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+];
+void typeChecks;
+const capabilities = {
+    verticals: ["products"],
+    supportsLiveResolution: true,
+    supportsDriftDetection: true,
+    supportsBookingForwarding: true,
+    supportsSyncCancellation: false,
+    postBookOperations: ["cancel", "status"],
+    cacheTtlSeconds: 300,
+    supportsContentFetch: true,
+    supportedContentLocales: ["en-GB", "ro-RO"],
+    holdReleaseGraceMs: 1000,
+    supportsBookingPush: true,
+    supportsAvailabilityPush: true,
+    supportsContentPush: true,
+};
+const context = {
+    connection_id: "conn_123",
+    credentials: { apiKey: "secret" },
+    tenant_id: "tenant_1",
+    correlation_id: "corr_1",
+};
+const provenance = {
+    source_kind: "direct:tui",
+    source_provider: "tui",
+    source_connection_id: "conn_123",
+    source_ref: "TUI-123",
+    source_freshness: "sync",
+    last_sourced_at: new Date("2026-01-01T00:00:00Z"),
+};
+const projection = {
+    entity_module: "products",
+    entity_id: "prod_123",
+    provenance,
+    fields: { title: "Sample tour", country: "RO" },
+};
+const discoveryPage = {
+    projections: [projection],
+    next_cursor: "cursor_2",
+};
+const liveResolveRequest = {
+    ids: ["prod_123"],
+    scope: {
+        locale: "en-GB",
+        audience: "customer",
+        market: "GB",
+        currency: "GBP",
+    },
+    parameters: { departureId: "dep_1" },
+};
+const sourceAdapterRequestScope = liveResolveRequest.scope;
+const liveResolveResult = {
+    values: {
+        prod_123: {
+            price: { amount: "100.00", currency: "GBP" },
+            remainingPax: 4,
+        },
+    },
+    failed: { prod_missing: "not_found" },
+};
+const getContentRequest = {
+    entity_module: "products",
+    entity_id: "prod_123",
+    locale: "ro-RO",
+    market: "RO",
+    currency: "RON",
+};
+const getContentResult = {
+    entity_module: "products",
+    entity_id: "prod_123",
+    source_ref: "TUI-123",
+    returned_locale: "en-GB",
+    machine_translated: false,
+    content: { product: { title: "Sample tour" } },
+    content_schema_version: "products/v1",
+    source_updated_at: new Date("2026-01-02T00:00:00Z"),
+    fresh_until: new Date("2026-01-03T00:00:00Z"),
+    etag: "etag-1",
+};
+const reserveRequest = {
+    entity_module: "products",
+    entity_id: "prod_123",
+    parameters: { departureId: "dep_1" },
+    party: { travelers: 2 },
+    payment_intent: { type: "hold" },
+    scope: sourceAdapterRequestScope,
+    idempotency_key: "reserve_123",
+};
+const reserveResult = {
+    upstream_ref: "booking_123",
+    status: "held",
+    upstream_payload: { holdToken: "hold_1" },
+};
+const cancelRequest = {
+    upstream_ref: "booking_123",
+    reason: "customer_request",
+    scope: sourceAdapterRequestScope,
+    idempotency_key: "cancel_123",
+};
+const cancelResult = {
+    status: "pending",
+    pending_channel: "partner portal",
+};
+const pushBookingRequest = {
+    idempotencyKey: "idem_1",
+    bookingId: "book_1",
+    bookingItemId: "item_1",
+    externalProductId: "EXT-1",
+    externalRateId: "RATE-1",
+    externalCategoryId: "CAT-1",
+    channelId: "channel_1",
+    contractPolicy: { commission: 0.1 },
+    payload: { travelers: 2 },
+};
+const pushBookingResult = {
+    upstreamRef: "upstream_1",
+    externalReference: "CONF-1",
+    externalStatus: "confirmed",
+    upstreamPayload: { ok: true },
+};
+const pushAvailabilityRequest = {
+    channelId: "channel_1",
+    externalProductId: "EXT-1",
+    externalRateId: "RATE-1",
+    externalCategoryId: "CAT-1",
+    slotId: "slot_1",
+    productId: "prod_123",
+    optionId: "opt_1",
+    startsAt: new Date("2026-02-01T10:00:00Z"),
+    remainingPax: 8,
+    source: "booking",
+};
+const pushAvailabilityResult = {
+    externalStatus: "updated",
+    upstreamPayload: { ok: true },
+};
+const pushContentRequest = {
+    channelId: "channel_1",
+    externalProductId: "EXT-1",
+    productId: "prod_123",
+    contentHash: "hash_123",
+    content: { product: { title: "Sample tour" } },
+    contentSchemaVersion: "products/v1",
+    locale: "en-GB",
+};
+const pushContentResult = {
+    externalStatus: "updated",
+    upstreamPayload: { ok: true },
+    acknowledgedHash: "hash_123",
+};
+const sourceAdapter = {
+    kind: "direct:tui",
+    capabilities,
+    async connect() { },
+    async getState() {
+        return "active";
+    },
+    async discover() {
+        return discoveryPage;
+    },
+    async getContent(_ctx, request) {
+        return { ...getContentResult, entity_id: request.entity_id };
+    },
+};
+const roundTripCases = [
+    ["adapterCapabilitiesSchema", adapterCapabilitiesSchema, capabilities],
+    ["connectionStateSchema", connectionStateSchema, "active"],
+    ["sourceAdapterContextSchema", sourceAdapterContextSchema, context],
+    ["provenanceSchema", provenanceSchema, provenance],
+    ["catalogProjectionSchema", catalogProjectionSchema, projection],
+    ["discoveryCursorSchema", discoveryCursorSchema, "cursor_2"],
+    ["discoveryPageSchema", discoveryPageSchema, discoveryPage],
+    ["sourceAdapterRequestScopeSchema", sourceAdapterRequestScopeSchema, sourceAdapterRequestScope],
+    ["liveResolveRequestSchema", liveResolveRequestSchema, liveResolveRequest],
+    ["liveResolveResultSchema", liveResolveResultSchema, liveResolveResult],
+    ["getContentRequestSchema", getContentRequestSchema, getContentRequest],
+    ["getContentResultSchema", getContentResultSchema, getContentResult],
+    ["reserveRequestSchema", reserveRequestSchema, reserveRequest],
+    ["reserveResultSchema", reserveResultSchema, reserveResult],
+    ["cancelRequestSchema", cancelRequestSchema, cancelRequest],
+    ["cancelResultSchema", cancelResultSchema, cancelResult],
+    ["pushBookingRequestSchema", pushBookingRequestSchema, pushBookingRequest],
+    ["pushBookingResultSchema", pushBookingResultSchema, pushBookingResult],
+    ["pushAvailabilityRequestSchema", pushAvailabilityRequestSchema, pushAvailabilityRequest],
+    ["pushAvailabilityResultSchema", pushAvailabilityResultSchema, pushAvailabilityResult],
+    ["pushContentRequestSchema", pushContentRequestSchema, pushContentRequest],
+    ["pushContentResultSchema", pushContentResultSchema, pushContentResult],
+    ["sourceAdapterSchema", sourceAdapterSchema, sourceAdapter],
+];
+const invalidCases = [
+    ["adapterCapabilitiesSchema", adapterCapabilitiesSchema, { ...capabilities, verticals: [123] }],
+    ["connectionStateSchema", connectionStateSchema, "reconnecting"],
+    ["sourceAdapterContextSchema", sourceAdapterContextSchema, { credentials: { apiKey: "secret" } }],
+    ["provenanceSchema", provenanceSchema, { ...provenance, source_freshness: "live" }],
+    ["catalogProjectionSchema", catalogProjectionSchema, { ...projection, entity_module: 123 }],
+    ["discoveryCursorSchema", discoveryCursorSchema, 123],
+    ["discoveryPageSchema", discoveryPageSchema, { projections: [{ fields: {} }] }],
+    [
+        "sourceAdapterRequestScopeSchema",
+        sourceAdapterRequestScopeSchema,
+        { ...sourceAdapterRequestScope, currency: "GB" },
+    ],
+    [
+        "liveResolveRequestSchema",
+        liveResolveRequestSchema,
+        { ...liveResolveRequest, scope: { ...liveResolveRequest.scope, locale: "not_locale" } },
+    ],
+    ["liveResolveResultSchema", liveResolveResultSchema, { values: {}, failed: { prod_1: "gone" } }],
+    ["getContentRequestSchema", getContentRequestSchema, { ...getContentRequest, currency: "EU" }],
+    [
+        "getContentResultSchema",
+        getContentResultSchema,
+        { ...getContentResult, content_schema_version: undefined },
+    ],
+    ["reserveRequestSchema", reserveRequestSchema, { ...reserveRequest, parameters: undefined }],
+    ["reserveResultSchema", reserveResultSchema, { ...reserveResult, status: "pending" }],
+    ["cancelRequestSchema", cancelRequestSchema, { reason: "customer_request" }],
+    ["cancelResultSchema", cancelResultSchema, { ...cancelResult, refund_currency: "GB" }],
+    [
+        "pushBookingRequestSchema",
+        pushBookingRequestSchema,
+        { ...pushBookingRequest, payload: undefined },
+    ],
+    ["pushBookingResultSchema", pushBookingResultSchema, { externalStatus: "confirmed" }],
+    [
+        "pushAvailabilityRequestSchema",
+        pushAvailabilityRequestSchema,
+        { ...pushAvailabilityRequest, remainingPax: -1 },
+    ],
+    ["pushAvailabilityResultSchema", pushAvailabilityResultSchema, { upstreamPayload: "ok" }],
+    [
+        "pushContentRequestSchema",
+        pushContentRequestSchema,
+        { ...pushContentRequest, locale: "not_locale" },
+    ],
+    ["pushContentResultSchema", pushContentResultSchema, { acknowledgedHash: 123 }],
+    ["sourceAdapterSchema", sourceAdapterSchema, { ...sourceAdapter, discover: "yes" }],
+];
+describe("catalog source-adapter schemas", () => {
+    it.each(roundTripCases)("parses %s fixtures without changing shape", (_name, schema, value) => {
+        expect(schema.parse(value)).toEqual(value);
+    });
+    it.each(invalidCases)("rejects invalid %s fixtures", (_name, schema, value) => {
+        expect(schema.safeParse(value).success).toBe(false);
+    });
+});

package/dist/booking-engine/book.d.ts

@@ -14,7 +14,7 @@
  * joined at read time via the shared `booking_id` text column.
  */
 import type { AnyDrizzleDb } from "@voyantjs/db";
-import type { SourceAdapterContext } from "../adapter/contract.js";
+import type { SourceAdapterContext, SourceAdapterRequestScope } from "../adapter/contract.js";
 import { type PricingBasis, type SelectBookingCatalogSnapshot } from "../snapshot/schema.js";
 import type { OwnedBookingHandlerRegistry } from "./owned-handler.js";
 import type { SourceAdapterRegistry } from "./registry.js";
@@ -69,6 +69,12 @@ export interface BookEntityRequest {
         market?: string;
         currency?: string;
     };
+    /**
+     * Per-request supplier scope forwarded to `SourceAdapter.reserve`.
+     * Kept separate from `contentScope`: this controls upstream write
+     * semantics, while `contentScope` controls snapshot-content capture.
+     */
+    adapterScope?: SourceAdapterRequestScope;
 }
 export interface BookEntityResult {
     bookingId: string;

package/dist/booking-engine/book.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"book.d.ts","sourceRoot":"","sources":["../../src/booking-engine/book.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAIhD,OAAO,KAAK,EAAkB,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAElF,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,4BAA4B,EAClC,MAAM,uBAAuB,CAAA;AAS9B,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAA;AAErE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAE1D,OAAO,KAAK,EAA0B,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAE5F;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvD,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAA;IAEf;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAE/B,mEAAmE;IACnE,aAAa,CAAC,EAAE,oBAAoB,CAAA;IAEpC,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAEpC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,cAAc,EAAE,oBAAoB,CAAA;IAEpC;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE;QACb,MAAM,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAA;CACF;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAA;IACpD,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC1C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,qBAAqB,CAAA;IAC/B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,2BAA2B,CAAA;IAC3C;;;;;;;;;;;;;;;OAeG;IACH,sBAAsB,CAAC,EAAE,uBAAuB,CAAA;CACjD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,UAAU,CAC9B,EAAE,EAAE,YAAY,EAChB,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CA+K3B;AAoID,YAAY,EAAE,4BAA4B,EAAE,CAAA"}
+{"version":3,"file":"book.d.ts","sourceRoot":"","sources":["../../src/booking-engine/book.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAIhD,OAAO,KAAK,EAEV,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,4BAA4B,EAClC,MAAM,uBAAuB,CAAA;AAS9B,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAA;AAErE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAE1D,OAAO,KAAK,EAA0B,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAE5F;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAA;AAMvD,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAA;IAEf;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAE/B,mEAAmE;IACnE,aAAa,CAAC,EAAE,oBAAoB,CAAA;IAEpC,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAEpC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,cAAc,EAAE,oBAAoB,CAAA;IAEpC;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE;QACb,MAAM,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAA;IAED;;;;OAIG;IACH,YAAY,CAAC,EAAE,yBAAyB,CAAA;CACzC;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAA;IACpD,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC1C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,qBAAqB,CAAA;IAC/B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,2BAA2B,CAAA;IAC3C;;;;;;;;;;;;;;;OAeG;IACH,sBAAsB,CAAC,EAAE,uBAAuB,CAAA;CACjD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,UAAU,CAC9B,EAAE,EAAE,YAAY,EAChB,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAiL3B;AAoID,YAAY,EAAE,4BAA4B,EAAE,CAAA"}

package/dist/booking-engine/book.js

@@ -20,6 +20,9 @@ import { bookingCatalogSnapshotTable, } from "../snapshot/schema.js";
 import { BookingEngineError, QUOTE_NOT_FOUND, QuoteExpiredError, QuoteMismatchError, ReserveFailedError, } from "./errors.js";
 import { OWNED_SOURCE_KIND } from "./owned-handler.js";
 import { catalogQuotesTable } from "./schema.js";
+function paymentIntentToAdapterRecord(intent) {
+    return { ...intent };
+}
 /**
  * Book the row referenced by `quoteId`. End-to-end: validate quote,
  * dispatch `adapter.reserve`, capture snapshot, mark quote consumed.
@@ -122,7 +125,9 @@ export async function bookEntity(db, deps, request) {
         entity_id: quote.entity_id,
         parameters: request.parameters ?? {},
         party: request.party,
-        payment_intent: paymentIntent,
+        payment_intent: paymentIntentToAdapterRecord(paymentIntent),
+        scope: request.adapterScope,
+        idempotency_key: request.idempotencyKey,
     };
     const reserveResult = await adapter.reserve(request.adapterContext, reserveRequest);
     if (reserveResult.status === "failed") {

package/dist/booking-engine/cancel.d.ts

@@ -8,19 +8,22 @@
  * decoupling from `packages/bookings`.
  */
 import type { AnyDrizzleDb } from "@voyantjs/db";
-import type { CancelResult, SourceAdapterContext } from "../adapter/contract.js";
+import type { CancelResult, SourceAdapterContext, SourceAdapterRequestScope } from "../adapter/contract.js";
 import type { SourceAdapterRegistry } from "./registry.js";
 export interface CancelEntityRequest {
     bookingId: string;
     entityModule: string;
     entityId: string;
     reason?: string;
+    scope?: SourceAdapterRequestScope;
+    idempotencyKey?: string;
     adapterContext: SourceAdapterContext;
 }
 export interface CancelEntityResult {
     status: CancelResult["status"];
     refundAmount?: number;
     refundCurrency?: string;
+    pendingChannel?: string;
     /** The snapshot row's id — exposed for callers that want to log the cancel against it. */
     snapshotId: string;
 }

package/dist/booking-engine/cancel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cancel.d.ts","sourceRoot":"","sources":["../../src/booking-engine/cancel.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAGhD,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAOhF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAE1D,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,oBAAoB,CAAA;CACrC;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAA;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,0FAA0F;IAC1F,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,qBAAqB,CAAA;CAChC;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,YAAY,EAChB,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAwB7B"}
+{"version":3,"file":"cancel.d.ts","sourceRoot":"","sources":["../../src/booking-engine/cancel.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAGhD,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,wBAAwB,CAAA;AAO/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAE1D,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,yBAAyB,CAAA;IACjC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,cAAc,EAAE,oBAAoB,CAAA;CACrC;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAA;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,0FAA0F;IAC1F,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,qBAAqB,CAAA;CAChC;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,YAAY,EAChB,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CA2B7B"}

package/dist/booking-engine/cancel.js

@@ -31,11 +31,14 @@ export async function cancelEntity(db, deps, request) {
     const result = await adapter.cancel(request.adapterContext, {
         upstream_ref: snapshot.source_ref ?? snapshot.id,
         reason: request.reason,
+        scope: request.scope,
+        idempotency_key: request.idempotencyKey,
     });
     return {
         status: result.status,
         refundAmount: result.refund_amount,
         refundCurrency: result.refund_currency,
+        pendingChannel: result.pending_channel,
         snapshotId: snapshot.id,
     };
 }

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-export { ADAPTER_RATE_LIMITED, type AdapterCapabilities, AdapterRateLimitedError, CAPABILITY_NOT_SUPPORTED, type CancelRequest, type CancelResult, CapabilityNotSupportedError, type CatalogProjection, type ConnectionState, type DiscoveryCursor, type DiscoveryPage, type GetContentRequest, type GetContentResult, type LiveResolveRequest, type LiveResolveResult, type PushAvailabilityRequest, type PushAvailabilityResult, type PushBookingRequest, type PushBookingResult, type PushContentRequest, type PushContentResult, type ReserveRequest, type ReserveResult, type SourceAdapter, type SourceAdapterContext, } from "./adapter/contract.js";
+export { ADAPTER_RATE_LIMITED, type AdapterCapabilities, AdapterRateLimitedError, CAPABILITY_NOT_SUPPORTED, type CancelRequest, type CancelResult, CapabilityNotSupportedError, type CatalogProjection, type ConnectionState, type DiscoveryCursor, type DiscoveryPage, type GetContentRequest, type GetContentResult, type LiveResolveRequest, type LiveResolveResult, type PushAvailabilityRequest, type PushAvailabilityResult, type PushBookingRequest, type PushBookingResult, type PushContentRequest, type PushContentResult, type ReserveRequest, type ReserveResult, type SourceAdapter, type SourceAdapterContext, type SourceAdapterRequestScope, } from "./adapter/contract.js";
+export * from "./adapter/schemas.js";
 export { type CatalogBookingAdapterContextInput, type CatalogBookingBookBody, type CatalogBookingBookTransformInput, type CatalogBookingCommittedEvent, type CatalogBookingContentScopeInput, type CatalogBookingDraftBody, type CatalogBookingDraftConsumedError, type CatalogBookingHoldPlaceBody, type CatalogBookingHoldReleaseBody, type CatalogBookingHoldTtlInput, type CatalogBookingProvenance, type CatalogBookingProvenanceInput, type CatalogBookingQuoteBody, type CatalogBookingQuoteTransformInput, type CatalogBookingRoutesOptions, createCatalogBookingHonoModule, createCatalogBookingRoutes, } from "./booking-engine/routes.js";
 export * from "./contract.js";
 export { blocksBookings, type CatalogDriftEvent, type ContentDriftEvent, type ContentDriftKind, type FieldDrift, maxDriftSeverity, } from "./drift/events.js";

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,6 +1,7 @@
 // Field-policy contract — the load-bearing schema decision.
 // Public source-adapter contract.
 export { ADAPTER_RATE_LIMITED, AdapterRateLimitedError, CAPABILITY_NOT_SUPPORTED, CapabilityNotSupportedError, } from "./adapter/contract.js";
+export * from "./adapter/schemas.js";
 // BookingJourney HTTP contract — root export matches the Hono module pattern
 // used by the vertical packages while keeping the ./booking-engine subpath.
 export { createCatalogBookingHonoModule, createCatalogBookingRoutes, } from "./booking-engine/routes.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/catalog",
-  "version": "0.57.0",
+  "version": "0.59.0",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -79,6 +79,11 @@
       "import": "./dist/adapter/contract.js",
       "default": "./dist/adapter/contract.js"
     },
+    "./adapter/schemas": {
+      "types": "./dist/adapter/schemas.d.ts",
+      "import": "./dist/adapter/schemas.js",
+      "default": "./dist/adapter/schemas.js"
+    },
     "./services/overlay": {
       "types": "./dist/services/overlay-service.d.ts",
       "import": "./dist/services/overlay-service.js",
@@ -140,9 +145,9 @@
     "drizzle-orm": "^0.45.2",
     "hono": "^4.12.10",
     "zod": "^4.1.4",
-    "@voyantjs/core": "0.57.0",
-    "@voyantjs/db": "0.57.0",
-    "@voyantjs/hono": "0.57.0"
+    "@voyantjs/core": "0.59.0",
+    "@voyantjs/db": "0.59.0",
+    "@voyantjs/hono": "0.59.0"
   },
   "devDependencies": {
     "drizzle-kit": "^0.31.10",