@voyant-travel/catalog 0.117.2

package/dist/booking-engine/errors.js

@@ -0,0 +1,113 @@
+/**
+ * Stable error codes returned from the booking engine.
+ *
+ * Mirrors the catalog plane's `CAPABILITY_NOT_SUPPORTED` convention:
+ * codes are stable strings, callers branch on them, and each carries a
+ * dedicated `Error` subclass for stack-trace clarity.
+ */
+/** No SourceAdapter was registered for the row's `source.kind`. */
+export const NO_ADAPTER_REGISTERED = "NO_ADAPTER_REGISTERED";
+/**
+ * No OwnedBookingHandler was registered for the row's `entity_module`.
+ * Sibling to `NO_ADAPTER_REGISTERED` — sourced rows dispatch through
+ * adapters keyed by connection, owned rows dispatch through handlers
+ * keyed by entity module. Per booking-journey-architecture §6.
+ */
+export const NO_HANDLER_REGISTERED = "NO_HANDLER_REGISTERED";
+/** The supplied `quoteId` is unknown or already consumed. */
+export const QUOTE_NOT_FOUND = "QUOTE_NOT_FOUND";
+/** The quote's `expires_at` has passed; caller must re-quote. */
+export const QUOTE_EXPIRED = "QUOTE_EXPIRED";
+/** The quote's entity_module/entity_id doesn't match the book request. */
+export const QUOTE_MISMATCH = "QUOTE_MISMATCH";
+/** The adapter returned `failed` for the requested entity. */
+export const RESERVE_FAILED = "RESERVE_FAILED";
+/** No snapshot row exists for the given (booking_id, entity_*). */
+export const ORDER_NOT_FOUND = "ORDER_NOT_FOUND";
+/** The order has already been cancelled. */
+export const ORDER_ALREADY_CANCELLED = "ORDER_ALREADY_CANCELLED";
+/**
+ * Snapshot content capture failed: neither a fresh adapter fetch nor a
+ * cache fallback produced a content payload. Per sourced-content §5.1,
+ * we deliberately fail the commit rather than snapshot from the
+ * indexed projection — refunds and audit need real "what was sold"
+ * content, not a stub.
+ */
+export const SNAPSHOT_CONTENT_UNAVAILABLE = "SNAPSHOT_CONTENT_UNAVAILABLE";
+export class BookingEngineError extends Error {
+    code;
+    context;
+    constructor(code, message, context) {
+        super(message);
+        this.code = code;
+        this.context = context;
+        this.name = "BookingEngineError";
+    }
+}
+export class NoAdapterRegisteredError extends BookingEngineError {
+    /**
+     * Thrown when the registry has no adapter for the given identifier.
+     * The identifier is a connection id when dispatched per-connection
+     * (channel push, sourced bookings with a known connection) or a source
+     * kind when the caller has no connection id (legacy dispatch).
+     */
+    constructor(identifier) {
+        super(NO_ADAPTER_REGISTERED, `no SourceAdapter registered for "${identifier}"`, {
+            identifier,
+        });
+        this.name = "NoAdapterRegisteredError";
+    }
+}
+export class NoOwnedHandlerRegisteredError extends BookingEngineError {
+    /** Thrown when the owned-handler registry has no entry for the
+     *  given `entity_module`. */
+    constructor(entityModule) {
+        super(NO_HANDLER_REGISTERED, `no OwnedBookingHandler registered for "${entityModule}"`, {
+            entityModule,
+        });
+        this.name = "NoOwnedHandlerRegisteredError";
+    }
+}
+export class QuoteExpiredError extends BookingEngineError {
+    constructor(quoteId, expiredAt) {
+        super(QUOTE_EXPIRED, `quote ${quoteId} expired at ${expiredAt.toISOString()}`, {
+            quoteId,
+            expiredAt: expiredAt.toISOString(),
+        });
+        this.name = "QuoteExpiredError";
+    }
+}
+export class QuoteMismatchError extends BookingEngineError {
+    constructor(quoteId, expected, actual) {
+        super(QUOTE_MISMATCH, `quote ${quoteId} is for ${expected.entityModule}:${expected.entityId} but book request is for ${actual.entityModule}:${actual.entityId}`, { quoteId, expected, actual });
+        this.name = "QuoteMismatchError";
+    }
+}
+export class ReserveFailedError extends BookingEngineError {
+    upstreamPayload;
+    sourceKind;
+    entityId;
+    constructor(upstreamPayload, sourceKind, entityId) {
+        super(RESERVE_FAILED, `adapter "${sourceKind}" returned failed status for ${entityId}`, {
+            sourceKind,
+            entityId,
+            upstreamPayload,
+        });
+        this.upstreamPayload = upstreamPayload;
+        this.sourceKind = sourceKind;
+        this.entityId = entityId;
+        this.name = "ReserveFailedError";
+    }
+}
+export class SnapshotContentUnavailableError extends BookingEngineError {
+    entityModule;
+    entityId;
+    fallbackReason;
+    constructor(entityModule, entityId, fallbackReason) {
+        super(SNAPSHOT_CONTENT_UNAVAILABLE, `cannot capture snapshot content for ${entityModule}:${entityId} — adapter fetch failed and no cache row available (reason: ${fallbackReason})`, { entityModule, entityId, fallbackReason });
+        this.entityModule = entityModule;
+        this.entityId = entityId;
+        this.fallbackReason = fallbackReason;
+        this.name = "SnapshotContentUnavailableError";
+    }
+}

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

@@ -0,0 +1,36 @@
+/**
+ * `@voyant-travel/catalog/booking-engine` — cross-vertical booking lifecycle
+ * on top of the Phase 1 `SourceAdapter` contract.
+ *
+ * See `docs/architecture/catalog-booking-engine.md` for the full design.
+ *
+ * Lifecycle:
+ *   1. `quoteEntity` → write to `catalog_quotes`, return short-lived quote.
+ *   2. `bookEntity`  → call `adapter.reserve`, write `booking_catalog_snapshot`.
+ *   3. `cancelEntity` → call `adapter.cancel`, snapshot stays for audit.
+ *
+ * Reads:
+ *   - `listOrders` / `getOrderById` — surface snapshot rows cross-vertically.
+ *
+ * Adapters:
+ *   - Templates wire a `SourceAdapterRegistry` at process start. The
+ *     engine consults it on every dispatch.
+ */
+export { type BookEntityDeps, type BookEntityRequest, type BookEntityResult, type BookingPaymentIntent, bookEntity, } from "./book.js";
+export { type CancelEntityDeps, type CancelEntityRequest, type CancelEntityResult, cancelEntity, } from "./cancel.js";
+export { type CheckoutFinalizeDeps, type CheckoutFinalizeInput, type CheckoutFinalizeStepRecorder, checkoutFinalizeWorkflow, runCheckoutFinalize, } from "./checkout-finalize.js";
+export { accommodationSubStepV1, addonGroupV1, addonOfferV1, type BookingDraftShapeV1, type BookingDraftV1, type BookRequestV1, type BookResponseV1, bookingDraftShapeV1, bookingDraftV1, bookingFieldRequirementV1, bookRequestV1, bookResponseV1, cabinCategoryOptionV1, cabinNumberOptionV1, configureSubStepV1, ENGINE_CONTRACT_V1, type EngineContractVersion, extensionOptionV1, type HoldExtendRequestV1, type HoldReleaseRequestV1, holdExtendRequestV1, holdReleaseRequestV1, type PaxBandCode, type PaxBandSpecV1, type PricingBreakdownV1, paxBandCodeSchema, paxBandSpecV1, pricingBreakdownV1, pricingLineV1, pricingTaxV1, type QuoteRequestV1, type QuoteResponseV1, quoteRequestV1, quoteResponseV1, quoteScopeV1, roomOptionV1, type TravelerEntryV1, travelerEntryV1, travelerFieldRequirementV1, } from "./contracts.js";
+export { type AccommodationSubStep, type AddonGroup, type AddonOffer, type BookingDraftShape, type BookingFieldRequirement, type CabinCategoryOption, type CabinNumberOption, type ConfigureSubStep, DEFAULT_PAX_BANDS, DEFAULT_PAX_TOTAL, defaultBookingFields, defaultDraftShapeFlags, defaultTravelerFields, type ExtensionOption, type PaxBandDependency, type PaxBandSpec, type ProductVariantOption, type ProductVariantUnitOption, paxBandsAllowedTotalFrom, type RatePlanOption, type RoomOption, type TravelerFieldRequirement, } from "./draft-shape.js";
+export { bookingDraftsTable, type InsertBookingDraft, type SelectBookingDraft, } from "./drafts-schema.js";
+export { createBookingDraft, DEFAULT_DRAFT_TTL_MS, deleteBookingDraft, findExpiredDrafts, getBookingDraft, markDraftConsumed, type UpdateDraftPatch, type UpsertDraftInput, updateBookingDraft, } from "./drafts-service.js";
+export { BookingEngineError, type BookingEngineErrorCode, NO_ADAPTER_REGISTERED, NO_HANDLER_REGISTERED, NoAdapterRegisteredError, NoOwnedHandlerRegisteredError, ORDER_ALREADY_CANCELLED, ORDER_NOT_FOUND, QUOTE_EXPIRED, QUOTE_MISMATCH, QUOTE_NOT_FOUND, QuoteExpiredError, QuoteMismatchError, RESERVE_FAILED, ReserveFailedError, SNAPSHOT_CONTENT_UNAVAILABLE, SnapshotContentUnavailableError, } from "./errors.js";
+export { getOrderById, type ListOrdersQuery, type ListOrdersResult, listOrders, } from "./orders.js";
+export { type CommitOwnedRequest, type CommitOwnedResult, type ComputeQuoteRequest, type ComputeQuoteResult, createOwnedBookingHandlerRegistry, type HoldRequest, type HoldResult, OWNED_SOURCE_KIND, type OwnedBookingHandler, type OwnedBookingHandlerRegistry, type OwnedHandlerContext, type OwnedQuoteScope, } from "./owned-handler.js";
+export type { AppliedOffer, CodeStatus, PromotionEvaluationInput, PromotionEvaluationOutput, } from "./promotions-contract.js";
+export { DEFAULT_QUOTE_TTL_MS, type QuoteContentEnricher, type QuoteContentEnrichmentInput, type QuoteEntityDeps, type QuoteEntityRequest, type QuoteEntityResult, type QuoteScope, quoteEntity, } from "./quote.js";
+export { createSourceAdapterRegistry, type SourceAdapterRegistry, } from "./registry.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 "./routes.js";
+export { catalogQuotesTable, type InsertCatalogQuote, type SelectCatalogQuote, } from "./schema.js";
+export { type ContentSnapshotAdapter, composeSnapshotContentCapturer, type SnapshotContentCapture, type SnapshotContentCaptureInput, type SnapshotContentCapturer, } from "./snapshot-content.js";
+export { type SyncAdapterSummary, type SyncProgressEvent, type SyncSourcesOptions, type SyncSourcesSummary, syncSources, } from "./sync.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/booking-engine/index.js

@@ -0,0 +1,34 @@
+/**
+ * `@voyant-travel/catalog/booking-engine` — cross-vertical booking lifecycle
+ * on top of the Phase 1 `SourceAdapter` contract.
+ *
+ * See `docs/architecture/catalog-booking-engine.md` for the full design.
+ *
+ * Lifecycle:
+ *   1. `quoteEntity` → write to `catalog_quotes`, return short-lived quote.
+ *   2. `bookEntity`  → call `adapter.reserve`, write `booking_catalog_snapshot`.
+ *   3. `cancelEntity` → call `adapter.cancel`, snapshot stays for audit.
+ *
+ * Reads:
+ *   - `listOrders` / `getOrderById` — surface snapshot rows cross-vertically.
+ *
+ * Adapters:
+ *   - Templates wire a `SourceAdapterRegistry` at process start. The
+ *     engine consults it on every dispatch.
+ */
+export { bookEntity, } from "./book.js";
+export { cancelEntity, } from "./cancel.js";
+export { checkoutFinalizeWorkflow, runCheckoutFinalize, } from "./checkout-finalize.js";
+export { accommodationSubStepV1, addonGroupV1, addonOfferV1, bookingDraftShapeV1, bookingDraftV1, bookingFieldRequirementV1, bookRequestV1, bookResponseV1, cabinCategoryOptionV1, cabinNumberOptionV1, configureSubStepV1, ENGINE_CONTRACT_V1, extensionOptionV1, holdExtendRequestV1, holdReleaseRequestV1, paxBandCodeSchema, paxBandSpecV1, pricingBreakdownV1, pricingLineV1, pricingTaxV1, quoteRequestV1, quoteResponseV1, quoteScopeV1, roomOptionV1, travelerEntryV1, travelerFieldRequirementV1, } from "./contracts.js";
+export { DEFAULT_PAX_BANDS, DEFAULT_PAX_TOTAL, defaultBookingFields, defaultDraftShapeFlags, defaultTravelerFields, paxBandsAllowedTotalFrom, } from "./draft-shape.js";
+export { bookingDraftsTable, } from "./drafts-schema.js";
+export { createBookingDraft, DEFAULT_DRAFT_TTL_MS, deleteBookingDraft, findExpiredDrafts, getBookingDraft, markDraftConsumed, updateBookingDraft, } from "./drafts-service.js";
+export { BookingEngineError, NO_ADAPTER_REGISTERED, NO_HANDLER_REGISTERED, NoAdapterRegisteredError, NoOwnedHandlerRegisteredError, ORDER_ALREADY_CANCELLED, ORDER_NOT_FOUND, QUOTE_EXPIRED, QUOTE_MISMATCH, QUOTE_NOT_FOUND, QuoteExpiredError, QuoteMismatchError, RESERVE_FAILED, ReserveFailedError, SNAPSHOT_CONTENT_UNAVAILABLE, SnapshotContentUnavailableError, } from "./errors.js";
+export { getOrderById, listOrders, } from "./orders.js";
+export { createOwnedBookingHandlerRegistry, OWNED_SOURCE_KIND, } from "./owned-handler.js";
+export { DEFAULT_QUOTE_TTL_MS, quoteEntity, } from "./quote.js";
+export { createSourceAdapterRegistry, } from "./registry.js";
+export { createCatalogBookingHonoModule, createCatalogBookingRoutes, } from "./routes.js";
+export { catalogQuotesTable, } from "./schema.js";
+export { composeSnapshotContentCapturer, } from "./snapshot-content.js";
+export { syncSources, } from "./sync.js";

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

@@ -0,0 +1,41 @@
+/**
+ * Read-side of the booking engine — `getOrder` / `listOrders`.
+ *
+ * The engine does not introduce a new "orders" table; `bookings` is
+ * already the parent and `booking_catalog_snapshot` is the per-line
+ * record. These helpers expose the cross-vertical view by selecting
+ * snapshot rows directly.
+ *
+ * Bookings-module joins (status, customer, payment) are layered on at
+ * the route level — these helpers stay scoped to what the catalog plane
+ * itself owns.
+ */
+import type { AnyDrizzleDb } from "@voyant-travel/db";
+import { type SelectBookingCatalogSnapshot } from "../snapshot/schema.js";
+export interface ListOrdersQuery {
+    /** Restrict to a specific booking. */
+    bookingId?: string;
+    /** Restrict to a specific catalog vertical (`"products"`, `"accommodations"`, etc.). */
+    entityModule?: string;
+    /** Restrict to one or more source kinds — e.g. `["demo"]`. */
+    sourceKinds?: ReadonlyArray<string>;
+    /** Pagination — capped at 100 by callers. */
+    limit?: number;
+    offset?: number;
+}
+export interface ListOrdersResult {
+    rows: ReadonlyArray<SelectBookingCatalogSnapshot>;
+    /**
+     * `null` when the caller didn't request a count; populated when the
+     * query is bounded enough that an EXACT count is cheap (currently when
+     * `bookingId` is provided).
+     */
+    total?: number;
+}
+export declare function listOrders(db: AnyDrizzleDb, query?: ListOrdersQuery): Promise<ListOrdersResult>;
+/**
+ * Fetch one snapshot row by its id. Used by the operator starter's
+ * `GET /v1/admin/catalog/orders/:id` route. Returns `null` when absent.
+ */
+export declare function getOrderById(db: AnyDrizzleDb, snapshotId: string): Promise<SelectBookingCatalogSnapshot | null>;
+//# sourceMappingURL=orders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orders.d.ts","sourceRoot":"","sources":["../../src/booking-engine/orders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGrD,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,uBAAuB,CAAA;AAE9B,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wFAAwF;IACxF,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACnC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,aAAa,CAAC,4BAA4B,CAAC,CAAA;IACjD;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,wBAAsB,UAAU,CAC9B,EAAE,EAAE,YAAY,EAChB,KAAK,GAAE,eAAoB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CAyB3B;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,YAAY,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAO9C"}

package/dist/booking-engine/orders.js

@@ -0,0 +1,49 @@
+/**
+ * Read-side of the booking engine — `getOrder` / `listOrders`.
+ *
+ * The engine does not introduce a new "orders" table; `bookings` is
+ * already the parent and `booking_catalog_snapshot` is the per-line
+ * record. These helpers expose the cross-vertical view by selecting
+ * snapshot rows directly.
+ *
+ * Bookings-module joins (status, customer, payment) are layered on at
+ * the route level — these helpers stay scoped to what the catalog plane
+ * itself owns.
+ */
+import { and, desc, eq, inArray } from "drizzle-orm";
+import { bookingCatalogSnapshotTable, } from "../snapshot/schema.js";
+export async function listOrders(db, query = {}) {
+    const conditions = [];
+    if (query.bookingId) {
+        conditions.push(eq(bookingCatalogSnapshotTable.booking_id, query.bookingId));
+    }
+    if (query.entityModule) {
+        conditions.push(eq(bookingCatalogSnapshotTable.entity_module, query.entityModule));
+    }
+    if (query.sourceKinds?.length) {
+        conditions.push(inArray(bookingCatalogSnapshotTable.source_kind, [...query.sourceKinds]));
+    }
+    const where = conditions.length ? and(...conditions) : undefined;
+    const limit = Math.min(Math.max(query.limit ?? 50, 1), 100);
+    const offset = Math.max(query.offset ?? 0, 0);
+    const rows = (await db
+        .select()
+        .from(bookingCatalogSnapshotTable)
+        .where(where)
+        .orderBy(desc(bookingCatalogSnapshotTable.captured_at))
+        .limit(limit)
+        .offset(offset));
+    return { rows };
+}
+/**
+ * Fetch one snapshot row by its id. Used by the operator starter's
+ * `GET /v1/admin/catalog/orders/:id` route. Returns `null` when absent.
+ */
+export async function getOrderById(db, snapshotId) {
+    const rows = (await db
+        .select()
+        .from(bookingCatalogSnapshotTable)
+        .where(eq(bookingCatalogSnapshotTable.id, snapshotId))
+        .limit(1));
+    return rows[0] ?? null;
+}

package/dist/booking-engine/owned-handler.d.ts

@@ -0,0 +1,166 @@
+/**
+ * `OwnedBookingHandler` + `OwnedBookingHandlerRegistry` — the
+ * dispatch seam for owned-arm bookings.
+ *
+ * Per `docs/architecture/booking-journey-architecture.md` §6, the
+ * catalog booking engine has two dispatch axes:
+ *
+ *   - Sourced rows go through `SourceAdapterRegistry` keyed by
+ *     `connection_id` (one adapter per upstream connection).
+ *   - Owned rows go through `OwnedBookingHandlerRegistry` keyed by
+ *     `entity_module` (one handler per vertical — products,
+ *     accommodations, cruises, etc.).
+ *
+ * The two registries live side-by-side, never wrap each other. The
+ * dispatch direction inverts: instead of `@voyant-travel/catalog`
+ * importing every vertical, each vertical imports this interface
+ * and provides an implementation. Catalog stays a contract package;
+ * verticals stay self-contained.
+ *
+ * Phase A (per doc §10) ships the registry + interface + the first
+ * vertical handler (products). Subsequent phases land accommodations,
+ * cruises, etc. against the same interface without re-architecting
+ * the dispatch.
+ */
+import type { AnyDrizzleDb } from "@voyant-travel/db";
+import type { SourceAdapterContext } from "../adapter/contract.js";
+import type { PricingBasis } from "../snapshot/schema.js";
+import type { BookingDraftShape } from "./draft-shape.js";
+export interface OwnedHandlerContext {
+    db: AnyDrizzleDb;
+    /** Echoed through from the engine — handlers may use it for audit. */
+    adapterContext: SourceAdapterContext;
+}
+export interface OwnedQuoteScope {
+    locale: string;
+    audience: string;
+    market: string;
+    currency?: string;
+}
+export interface ComputeQuoteRequest {
+    entityModule: string;
+    entityId: string;
+    scope: OwnedQuoteScope;
+    /**
+     * Vertical-specific parameters echoed by callers. Free-form today;
+     * Phase B adds a typed `BookingDraft` payload that supersedes this.
+     */
+    parameters?: Record<string, unknown>;
+    /**
+     * Optional partial draft state — used when the wizard re-quotes
+     * mid-journey. Owned handlers read pax counts, addons, accommodation
+     * picks, billing country off this to compute the correct price.
+     *
+     * Typed as `unknown` here so Phase A doesn't pin the schema in the
+     * catalog package; Phase B replaces with a Zod-validated
+     * `BookingDraftV1` (see §8.5 of the doc).
+     */
+    draft?: unknown;
+}
+export interface ComputeQuoteResult {
+    available: boolean;
+    invalidReason?: string;
+    pricing?: PricingBasis;
+    /**
+     * Per-quote journey descriptor. Owned handlers return this when
+     * they have enough context (always, for products in Phase A; the
+     * journey falls back to defaults when omitted).
+     */
+    shape?: BookingDraftShape;
+    /** Echoed back into `catalog_quotes.upstream_payload` for audit. */
+    upstreamPayload?: Record<string, unknown>;
+}
+export interface CommitOwnedRequest {
+    entityModule: string;
+    entityId: string;
+    /** Booking shell id — generated by the engine when the caller
+     *  doesn't pass one. Always defined here. */
+    bookingId: string;
+    /**
+     * Free-form party / passenger payload echoed from the caller. Phase
+     * B supersedes with a typed draft.
+     */
+    party?: Record<string, unknown>;
+    parameters?: Record<string, unknown>;
+    /** Pre-validated quote pricing — handlers MAY trust this for cost
+     *  basis or recompute on their own (some verticals re-price at
+     *  commit). */
+    pricing?: PricingBasis;
+    /** Optional draft payload — Phase B routes the full draft here. */
+    draft?: unknown;
+}
+export interface CommitOwnedResult {
+    status: "held" | "confirmed" | "ticketed" | "failed";
+    orderRef: string;
+    /**
+     * The id of the booking row the handler actually created. The engine adopts
+     * this as the canonical booking id (the handler mints its own rather than use
+     * the provided `request.bookingId`), so the response + snapshot + quote-
+     * consumed marker all point at the real row.
+     */
+    bookingId?: string;
+    /** Re-priced or echoed pricing — written into the snapshot. */
+    pricing?: PricingBasis;
+    /** Free-form payload preserved in the snapshot's frozen_payload. */
+    upstreamPayload?: Record<string, unknown>;
+}
+export interface HoldRequest {
+    entityModule: string;
+    entityId: string;
+    /** Caller-supplied draft id; handlers tie holds to the draft so
+     *  abandonment is observable. */
+    draftId?: string;
+    ttlMs: number;
+    parameters?: Record<string, unknown>;
+}
+export interface HoldResult {
+    holdToken: string;
+    expiresAt: Date;
+}
+export interface OwnedBookingHandler {
+    /** Vertical this handler claims. One handler per `entity_module`. */
+    readonly entityModule: string;
+    /**
+     * Per-vertical hold-release grace period in milliseconds. The
+     * reaper defers calling `releaseHold` for `grace` past a draft's
+     * expiry. Default `0` (immediate release).
+     *
+     * Mirrors `AdapterCapabilities.holdReleaseGraceMs` for sourced
+     * holds. Per booking-journey-architecture §12.9.
+     */
+    readonly holdReleaseGraceMs?: number;
+    /**
+     * Live-quote an owned row for a draft. The engine calls this on
+     * every meaningful input change. Returns shape + pricing +
+     * availability.
+     *
+     * Implementations should be idempotent — the same input must
+     * produce the same output (modulo time-sensitive fields like
+     * promo windows, which are explicitly OK to vary).
+     */
+    computeQuote(ctx: OwnedHandlerContext, request: ComputeQuoteRequest): Promise<ComputeQuoteResult>;
+    /**
+     * Commit the draft to a booking row. Phase A handlers map the
+     * draft into `bookingsCreate`'s input shape; later phases
+     * extend this to model extras, accommodation stays, encrypted
+     * travel details, tax lines, snapshot graphs.
+     */
+    commit(ctx: OwnedHandlerContext, request: CommitOwnedRequest): Promise<CommitOwnedResult>;
+    /** Optional: place / extend / release a soft hold on the row. */
+    placeHold?(ctx: OwnedHandlerContext, request: HoldRequest): Promise<HoldResult>;
+    extendHold?(ctx: OwnedHandlerContext, holdToken: string, request?: Pick<HoldRequest, "ttlMs" | "parameters">): Promise<HoldResult>;
+    releaseHold?(ctx: OwnedHandlerContext, holdToken: string): Promise<void>;
+}
+export interface OwnedBookingHandlerRegistry {
+    /** Register a handler. Re-registering the same `entityModule`
+     *  replaces the previous handler. */
+    register(handler: OwnedBookingHandler): void;
+    resolve(entityModule: string): OwnedBookingHandler | undefined;
+    resolveOrThrow(entityModule: string): OwnedBookingHandler;
+    has(entityModule: string): boolean;
+    modules(): ReadonlyArray<string>;
+}
+export declare function createOwnedBookingHandlerRegistry(): OwnedBookingHandlerRegistry;
+/** Stable string the engine inspects when deciding which arm to use. */
+export declare const OWNED_SOURCE_KIND: "owned";
+//# sourceMappingURL=owned-handler.d.ts.map

package/dist/booking-engine/owned-handler.d.ts.map

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

package/dist/booking-engine/owned-handler.js

@@ -0,0 +1,50 @@
+/**
+ * `OwnedBookingHandler` + `OwnedBookingHandlerRegistry` — the
+ * dispatch seam for owned-arm bookings.
+ *
+ * Per `docs/architecture/booking-journey-architecture.md` §6, the
+ * catalog booking engine has two dispatch axes:
+ *
+ *   - Sourced rows go through `SourceAdapterRegistry` keyed by
+ *     `connection_id` (one adapter per upstream connection).
+ *   - Owned rows go through `OwnedBookingHandlerRegistry` keyed by
+ *     `entity_module` (one handler per vertical — products,
+ *     accommodations, cruises, etc.).
+ *
+ * The two registries live side-by-side, never wrap each other. The
+ * dispatch direction inverts: instead of `@voyant-travel/catalog`
+ * importing every vertical, each vertical imports this interface
+ * and provides an implementation. Catalog stays a contract package;
+ * verticals stay self-contained.
+ *
+ * Phase A (per doc §10) ships the registry + interface + the first
+ * vertical handler (products). Subsequent phases land accommodations,
+ * cruises, etc. against the same interface without re-architecting
+ * the dispatch.
+ */
+import { NoOwnedHandlerRegisteredError } from "./errors.js";
+export function createOwnedBookingHandlerRegistry() {
+    const byModule = new Map();
+    return {
+        register(handler) {
+            byModule.set(handler.entityModule, handler);
+        },
+        resolve(entityModule) {
+            return byModule.get(entityModule);
+        },
+        resolveOrThrow(entityModule) {
+            const handler = byModule.get(entityModule);
+            if (!handler)
+                throw new NoOwnedHandlerRegisteredError(entityModule);
+            return handler;
+        },
+        has(entityModule) {
+            return byModule.has(entityModule);
+        },
+        modules() {
+            return [...byModule.keys()];
+        },
+    };
+}
+/** Stable string the engine inspects when deciding which arm to use. */
+export const OWNED_SOURCE_KIND = "owned";

package/dist/booking-engine/owned-handler.test.d.ts

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

package/dist/booking-engine/owned-handler.test.d.ts.map

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

package/dist/booking-engine/owned-handler.test.js

@@ -0,0 +1,63 @@
+import { describe, expect, it } from "vitest";
+import { NoOwnedHandlerRegisteredError } from "./errors.js";
+import { createOwnedBookingHandlerRegistry, } from "./owned-handler.js";
+function stubHandler(entityModule) {
+    return {
+        entityModule,
+        async computeQuote(_ctx, _req) {
+            return { available: true };
+        },
+        async commit(_ctx, req) {
+            return { status: "held", orderRef: `ord-${req.bookingId}` };
+        },
+    };
+}
+const stubDb = {};
+describe("OwnedBookingHandlerRegistry", () => {
+    it("registers and resolves handlers by entity_module", () => {
+        const reg = createOwnedBookingHandlerRegistry();
+        const products = stubHandler("products");
+        reg.register(products);
+        expect(reg.has("products")).toBe(true);
+        expect(reg.has("accommodations")).toBe(false);
+        expect(reg.resolve("products")).toBe(products);
+        expect(reg.resolveOrThrow("products")).toBe(products);
+        expect(reg.modules()).toEqual(["products"]);
+    });
+    it("replaces handler when a module re-registers", () => {
+        const reg = createOwnedBookingHandlerRegistry();
+        const a = stubHandler("products");
+        const b = stubHandler("products");
+        reg.register(a);
+        reg.register(b);
+        expect(reg.resolveOrThrow("products")).toBe(b);
+        expect(reg.modules()).toHaveLength(1);
+    });
+    it("throws NoOwnedHandlerRegisteredError when missing", () => {
+        const reg = createOwnedBookingHandlerRegistry();
+        expect(() => reg.resolveOrThrow("accommodations")).toThrow(NoOwnedHandlerRegisteredError);
+        expect(reg.resolve("accommodations")).toBeUndefined();
+    });
+    it("dispatches computeQuote through resolved handler", async () => {
+        const reg = createOwnedBookingHandlerRegistry();
+        const captured = [];
+        reg.register({
+            entityModule: "products",
+            async computeQuote(_ctx, req) {
+                captured.push(req);
+                return { available: true, pricing: undefined };
+            },
+            async commit() {
+                return { status: "held", orderRef: "x" };
+            },
+        });
+        const handler = reg.resolveOrThrow("products");
+        const result = await handler.computeQuote({ db: stubDb, adapterContext: { connection_id: "test" } }, {
+            entityModule: "products",
+            entityId: "prod_1",
+            scope: { locale: "en-GB", audience: "staff", market: "default" },
+        });
+        expect(result.available).toBe(true);
+        expect(captured[0]?.entityId).toBe("prod_1");
+    });
+});

package/dist/booking-engine/promotions-contract.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Promotion-evaluation contract types now live in `@voyant-travel/catalog-contracts`
+ * so external consumers can validate promotion payloads without the catalog
+ * runtime. Re-exported here to keep existing `@voyant-travel/catalog` import paths
+ * stable. See `docs/adr/0002-contract-packages.md`.
+ */
+export * from "@voyant-travel/catalog-contracts/booking-engine/promotions-contract";
+//# sourceMappingURL=promotions-contract.d.ts.map

package/dist/booking-engine/promotions-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotions-contract.d.ts","sourceRoot":"","sources":["../../src/booking-engine/promotions-contract.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,qEAAqE,CAAA"}

package/dist/booking-engine/promotions-contract.js

@@ -0,0 +1,7 @@
+/**
+ * Promotion-evaluation contract types now live in `@voyant-travel/catalog-contracts`
+ * so external consumers can validate promotion payloads without the catalog
+ * runtime. Re-exported here to keep existing `@voyant-travel/catalog` import paths
+ * stable. See `docs/adr/0002-contract-packages.md`.
+ */
+export * from "@voyant-travel/catalog-contracts/booking-engine/promotions-contract";

package/dist/booking-engine/quote-enricher.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Focused tests for the `contentEnricher` hook on `quoteEntity`. The
+ * full quote path needs a real DB — these tests stub the drizzle
+ * insert chain just enough to verify the hook's call contract:
+ *   - Called with the right input when wired and live-resolve succeeds.
+ *   - Result attached to the quote response as `shape`.
+ *   - Errors swallowed + reported via `onEnricherError` instead of
+ *     failing the quote.
+ *   - Skipped when the entity is not available (failed live-resolve).
+ */
+export {};
+//# sourceMappingURL=quote-enricher.test.d.ts.map

package/dist/booking-engine/quote-enricher.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote-enricher.test.d.ts","sourceRoot":"","sources":["../../src/booking-engine/quote-enricher.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}