@voyant-travel/inventory 0.1.0

package/dist/content-shape.d.ts

@@ -0,0 +1,15 @@
+import { type ContentOverlay, type MergeOverlaysOptions } from "@voyant-travel/catalog";
+import { type ProductContent } from "@voyant-travel/products-contracts/content-shape";
+export { BOARD_BASIS_FROM_SHORT_CODE, BOARD_BASIS_SHORT_CODES, BOARD_BASIS_VALUES, type BoardBasis, type BoardBasisShortCode, boardBasisSchema, PRODUCTS_CONTENT_SCHEMA_VERSION, type ProductContent, type ProductDay, type ProductDeparture, type ProductMediaItem, type ProductOption, type ProductPolicy, type ProductSummary, productContentSchema, productDaySchema, productDepartureSchema, productMediaItemSchema, productOptionSchema, productOptionUnitSchema, productPolicySchema, productSummarySchema, validateProductContent, } from "@voyant-travel/products-contracts/content-shape";
+/**
+ * Apply a list of editorial overlays to a product content payload via
+ * RFC 6901 JSON pointers. Validates the merged result against the
+ * vertical's Zod schema; overlays that produce an invalid payload are
+ * rolled back and reported via `onOverlayError`.
+ *
+ * Per sourced-content §3.5.4, this is the "content-shape-aware merger"
+ * — the catalog plane stays neutral about the content shape; the
+ * vertical plugs in its validator here.
+ */
+export declare function mergeOverlaysIntoProductContent(payload: ProductContent, overlays: ReadonlyArray<ContentOverlay>, options?: Pick<MergeOverlaysOptions, "onOverlayError">): ProductContent;
+//# sourceMappingURL=content-shape.d.ts.map

package/dist/content-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-shape.d.ts","sourceRoot":"","sources":["../src/content-shape.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EAE1B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,KAAK,cAAc,EAGpB,MAAM,iDAAiD,CAAA;AAExD,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,gBAAgB,EAChB,+BAA+B,EAC/B,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,iDAAiD,CAAA;AAExD;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,aAAa,CAAC,cAAc,CAAC,EACvC,OAAO,GAAE,IAAI,CAAC,oBAAoB,EAAE,gBAAgB,CAAM,GACzD,cAAc,CAchB"}

package/dist/content-shape.js

@@ -0,0 +1,28 @@
+import { mergeOverlaysIntoContent, } from "@voyant-travel/catalog";
+import { productContentSchema, validateProductContent, } from "@voyant-travel/products-contracts/content-shape";
+export { BOARD_BASIS_FROM_SHORT_CODE, BOARD_BASIS_SHORT_CODES, BOARD_BASIS_VALUES, boardBasisSchema, PRODUCTS_CONTENT_SCHEMA_VERSION, productContentSchema, productDaySchema, productDepartureSchema, productMediaItemSchema, productOptionSchema, productOptionUnitSchema, productPolicySchema, productSummarySchema, validateProductContent, } from "@voyant-travel/products-contracts/content-shape";
+/**
+ * Apply a list of editorial overlays to a product content payload via
+ * RFC 6901 JSON pointers. Validates the merged result against the
+ * vertical's Zod schema; overlays that produce an invalid payload are
+ * rolled back and reported via `onOverlayError`.
+ *
+ * Per sourced-content §3.5.4, this is the "content-shape-aware merger"
+ * — the catalog plane stays neutral about the content shape; the
+ * vertical plugs in its validator here.
+ */
+export function mergeOverlaysIntoProductContent(payload, overlays, options = {}) {
+    const merged = mergeOverlaysIntoContent(payload, overlays, {
+        validate(p) {
+            const result = validateProductContent(p);
+            if (result.valid) {
+                return { valid: true };
+            }
+            return { valid: false, reason: result.reason };
+        },
+        onOverlayError: options.onOverlayError,
+    });
+    // The validator gates merges, so a successful merge always parses —
+    // re-parse here to satisfy the return type without an unsafe cast.
+    return productContentSchema.parse(merged);
+}

package/dist/draft-shape.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Project a `ProductContent` payload into a `BookingDraftShape` so
+ * the journey wizard can render the correct sub-steps for a sourced
+ * product.
+ *
+ * Tour-style products typically need:
+ *   - Configure: occupancy band selection (adult / child / infant)
+ *     and optionally a date / departure picker if `days[]` carries
+ *     scheduled departures.
+ *   - Travelers: per-pax fields (first / last / email; passport when
+ *     the supplier requires it — surfaced via overlay when known).
+ *   - Product options: the product's own `options[]` projected as a
+ *     configure sub-step, setting `draft.configure.variantId`.
+ *
+ * No accommodation sub-step today (multi-day tours w/ rooms route
+ * through accommodations, not products). Pricing flows through
+ * liveResolve at quote time, not the descriptor.
+ *
+ * See `docs/architecture/booking-journey-architecture.md` §3 + §F.
+ */
+import { type BookingDraftShape, type PaxBandSpec } from "@voyant-travel/catalog/booking-engine";
+import type { ProductContent } from "./content-shape.js";
+export interface BuildProductDraftShapeOptions {
+    /** Locale — used for option-label fallback. Defaults to `"en-GB"`. */
+    locale?: string;
+    /**
+     * Override the default pax bands. Use when the supplier mandates
+     * specific age cutoffs (rare for tour products; common for cruises
+     * and family-oriented packages).
+     */
+    paxBands?: ReadonlyArray<PaxBandSpec>;
+    /**
+     * Override the maximum total pax. Defaults to `paxBands` sum.
+     * Useful when supplier capacity is < combined band max (e.g. a
+     * 6-pax max party on a private tour).
+     */
+    paxBandsAllowedTotal?: {
+        min: number;
+        max: number;
+    };
+}
+export declare function buildProductDraftShape(content: ProductContent, options?: BuildProductDraftShapeOptions): BookingDraftShape;
+//# sourceMappingURL=draft-shape.d.ts.map

package/dist/draft-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-shape.d.ts","sourceRoot":"","sources":["../src/draft-shape.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACL,KAAK,iBAAiB,EAKtB,KAAK,WAAW,EAEjB,MAAM,uCAAuC,CAAA;AAE9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAExD,MAAM,WAAW,6BAA6B;IAC5C,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAA;IACrC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CACpD;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,6BAAkC,GAC1C,iBAAiB,CA4BnB"}

package/dist/draft-shape.js

@@ -0,0 +1,48 @@
+/**
+ * Project a `ProductContent` payload into a `BookingDraftShape` so
+ * the journey wizard can render the correct sub-steps for a sourced
+ * product.
+ *
+ * Tour-style products typically need:
+ *   - Configure: occupancy band selection (adult / child / infant)
+ *     and optionally a date / departure picker if `days[]` carries
+ *     scheduled departures.
+ *   - Travelers: per-pax fields (first / last / email; passport when
+ *     the supplier requires it — surfaced via overlay when known).
+ *   - Product options: the product's own `options[]` projected as a
+ *     configure sub-step, setting `draft.configure.variantId`.
+ *
+ * No accommodation sub-step today (multi-day tours w/ rooms route
+ * through accommodations, not products). Pricing flows through
+ * liveResolve at quote time, not the descriptor.
+ *
+ * See `docs/architecture/booking-journey-architecture.md` §3 + §F.
+ */
+import { DEFAULT_PAX_BANDS, defaultBookingFields, defaultDraftShapeFlags, defaultTravelerFields, paxBandsAllowedTotalFrom, } from "@voyant-travel/catalog/booking-engine";
+export function buildProductDraftShape(content, options = {}) {
+    const paxBands = options.paxBands ?? DEFAULT_PAX_BANDS;
+    const total = options.paxBandsAllowedTotal ?? paxBandsAllowedTotalFrom(paxBands);
+    const productOptions = content.options.map((opt) => ({
+        id: opt.id,
+        name: opt.name,
+        description: opt.description ?? null,
+    }));
+    return {
+        ...defaultDraftShapeFlags(),
+        paxBands,
+        paxBandsAllowedTotal: total,
+        travelerFields: defaultTravelerFields(),
+        bookingFields: defaultBookingFields(),
+        paymentIntents: ["hold", "card"],
+        configureSubSteps: [
+            ...(productOptions.length > 0
+                ? [{ kind: "product-option", options: productOptions }]
+                : []),
+            // Owned products are scheduled — the operator picks a real departure.
+            // The journey renders an injected slot picker for this kind, falling
+            // back to a free date when the product has no scheduled departures.
+            { kind: "departure", required: true },
+            { kind: "occupancy", bands: paxBands },
+        ],
+    };
+}

package/dist/events.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Product domain events.
+ *
+ * Emitted by the products module on lifecycle and content changes.
+ * `product.content.changed` is the load-bearing channel-push signal —
+ * fired when ANY content axis (description, itinerary, media, options,
+ * days) changes.
+ *
+ * Per docs/architecture/channel-push-architecture.md §6.
+ */
+import type { EventBus } from "@voyant-travel/core";
+/** Stable event identifier. */
+export declare const PRODUCT_CONTENT_CHANGED_EVENT: "product.content.changed";
+export interface ProductContentChangedEvent {
+    /** Product id whose content changed. */
+    id: string;
+    /**
+     * The content axis that changed, when known. Diagnostic only — channel
+     * push hashes the full current content at push time so this field is
+     * not load-bearing for correctness.
+     */
+    axis?: "product" | "itinerary" | "option" | "day" | "media" | "feature" | "faq" | "location" | "destination" | "category" | "tag" | "translation";
+}
+/**
+ * Helper for route handlers / services to fire `product.content.changed`
+ * with a stable shape. Fire-and-forget per the EventBus contract; the
+ * caller does not await this if it's already on a hot path.
+ *
+ * v1 wiring: every product service/route mutation that touches a
+ * content-affecting field should call this helper. The top-level PATCH
+ * route already calls it (alongside the legacy `product.updated`); child
+ * routes can be wired incrementally. Until full coverage exists, the
+ * channel-push reconciler (§13) catches missed events by hashing
+ * current content per (product, channel).
+ */
+export declare function emitProductContentChanged(eventBus: EventBus | undefined, payload: ProductContentChangedEvent): Promise<void>;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAEnD,+BAA+B;AAC/B,eAAO,MAAM,6BAA6B,EAAG,yBAAkC,CAAA;AAE/E,MAAM,WAAW,0BAA0B;IACzC,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAA;IACV;;;;OAIG;IACH,IAAI,CAAC,EACD,SAAS,GACT,WAAW,GACX,QAAQ,GACR,KAAK,GACL,OAAO,GACP,SAAS,GACT,KAAK,GACL,UAAU,GACV,aAAa,GACb,UAAU,GACV,KAAK,GACL,aAAa,CAAA;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAC9B,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/events.js

@@ -0,0 +1,32 @@
+/**
+ * Product domain events.
+ *
+ * Emitted by the products module on lifecycle and content changes.
+ * `product.content.changed` is the load-bearing channel-push signal —
+ * fired when ANY content axis (description, itinerary, media, options,
+ * days) changes.
+ *
+ * Per docs/architecture/channel-push-architecture.md §6.
+ */
+/** Stable event identifier. */
+export const PRODUCT_CONTENT_CHANGED_EVENT = "product.content.changed";
+/**
+ * Helper for route handlers / services to fire `product.content.changed`
+ * with a stable shape. Fire-and-forget per the EventBus contract; the
+ * caller does not await this if it's already on a hot path.
+ *
+ * v1 wiring: every product service/route mutation that touches a
+ * content-affecting field should call this helper. The top-level PATCH
+ * route already calls it (alongside the legacy `product.updated`); child
+ * routes can be wired incrementally. Until full coverage exists, the
+ * channel-push reconciler (§13) catches missed events by hashing
+ * current content per (product, channel).
+ */
+export async function emitProductContentChanged(eventBus, payload) {
+    if (!eventBus)
+        return;
+    await eventBus.emit(PRODUCT_CONTENT_CHANGED_EVENT, payload, {
+        category: "domain",
+        source: "service",
+    });
+}

package/dist/extras/catalog-policy.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Catalog plane field policy for `packages/extras`.
+ *
+ * Extras are booking add-ons (optional line items layered on a booked
+ * parent product) — **not independently sellable inventory**. Per
+ * architecture §3.3.1, extras are a partial-adoption vertical:
+ *
+ *   - **Adopt:** provenance shape (§5.1), booking snapshot graph (§5.3),
+ *     catalog event taxonomy for the cancellation/fulfillment lifecycle.
+ *   - **Skip:** search index projection (§5.4), editorial overlay store
+ *     (§5.2), embeddings / RAG (Phase 2). Extras are discovered through
+ *     the parent's surface, not via standalone catalog browse.
+ *
+ * Most fields below have `reindex: "none"` because extras are primarily
+ * discovered through their parent product. The `thumbnailUrl` card-image
+ * projection is indexed for operator catalog search surfaces that opt
+ * extras into the shared catalog index.
+ *
+ * Scope of this file:
+ *   - The `product_extras` table (extra catalog definitions).
+ *
+ * Out of scope:
+ *   - `option_extra_configs` — option-level overrides; promoted child.
+ *   - `booking_extras` — runtime line items on a booking; not catalog data.
+ */
+import { type FieldPolicyInput } from "@voyant-travel/catalog/contract";
+declare const EXTRAS_FIELD_POLICY: FieldPolicyInput[];
+export declare const extrasCatalogPolicy: import("@voyant-travel/catalog").FieldPolicy[];
+export { EXTRAS_FIELD_POLICY };
+//# sourceMappingURL=catalog-policy.d.ts.map

package/dist/extras/catalog-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-policy.d.ts","sourceRoot":"","sources":["../../src/extras/catalog-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAE1F,QAAA,MAAM,mBAAmB,EAAE,gBAAgB,EAsS1C,CAAA;AAED,eAAO,MAAM,mBAAmB,gDAAyC,CAAA;AAEzE,OAAO,EAAE,mBAAmB,EAAE,CAAA"}

package/dist/extras/catalog-policy.js

@@ -0,0 +1,319 @@
+/**
+ * Catalog plane field policy for `packages/extras`.
+ *
+ * Extras are booking add-ons (optional line items layered on a booked
+ * parent product) — **not independently sellable inventory**. Per
+ * architecture §3.3.1, extras are a partial-adoption vertical:
+ *
+ *   - **Adopt:** provenance shape (§5.1), booking snapshot graph (§5.3),
+ *     catalog event taxonomy for the cancellation/fulfillment lifecycle.
+ *   - **Skip:** search index projection (§5.4), editorial overlay store
+ *     (§5.2), embeddings / RAG (Phase 2). Extras are discovered through
+ *     the parent's surface, not via standalone catalog browse.
+ *
+ * Most fields below have `reindex: "none"` because extras are primarily
+ * discovered through their parent product. The `thumbnailUrl` card-image
+ * projection is indexed for operator catalog search surfaces that opt
+ * extras into the shared catalog index.
+ *
+ * Scope of this file:
+ *   - The `product_extras` table (extra catalog definitions).
+ *
+ * Out of scope:
+ *   - `option_extra_configs` — option-level overrides; promoted child.
+ *   - `booking_extras` — runtime line items on a booking; not catalog data.
+ */
+import { defineFieldPolicy } from "@voyant-travel/catalog/contract";
+const EXTRAS_FIELD_POLICY = [
+    // ── Source pointer / provenance ─────────────────────────────────────────
+    {
+        path: "source.kind",
+        class: "managed",
+        merge: "source-only",
+        drift: "critical",
+        reindex: "facet-affecting",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "source.ref",
+        class: "managed",
+        merge: "source-only",
+        drift: "critical",
+        reindex: "none",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "seller.operator_id",
+        class: "managed",
+        merge: "source-only",
+        drift: "critical",
+        reindex: "none",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "static",
+    },
+    // ── Identity / lifecycle ────────────────────────────────────────────────
+    {
+        path: "id",
+        class: "managed",
+        merge: "source-only",
+        drift: "critical",
+        reindex: "none",
+        snapshot: "on-book",
+        query: "first-class-table",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "static",
+    },
+    {
+        path: "code",
+        class: "managed",
+        merge: "source-only",
+        drift: "high",
+        reindex: "none",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "createdAt",
+        class: "managed",
+        merge: "source-only",
+        drift: "none",
+        reindex: "none",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "static",
+    },
+    {
+        path: "updatedAt",
+        class: "managed",
+        merge: "source-only",
+        drift: "none",
+        reindex: "none",
+        snapshot: "never",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    // ── Cross-module reference (the parent product the extra attaches to) ──
+    {
+        path: "productId",
+        class: "managed",
+        merge: "source-only",
+        drift: "critical",
+        reindex: "none",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "supplierId",
+        class: "structural",
+        merge: "source-only",
+        drift: "high",
+        reindex: "none",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    // ── Snapshot-relevant managed fields ────────────────────────────────────
+    // Extras' name/description aren't merchandised standalone — they're
+    // shown inside the parent product's add-on UI. Marked as managed for
+    // simplicity; if a future case requires marketing overrides on extras'
+    // names, this can be promoted to merchandisable.
+    {
+        path: "name",
+        class: "managed",
+        merge: "source-only",
+        drift: "medium",
+        reindex: "none",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "description",
+        class: "managed",
+        merge: "source-only",
+        drift: "low",
+        reindex: "none",
+        snapshot: "on-book",
+        query: "blob-only",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "thumbnailUrl",
+        class: "merchandisable",
+        merge: "source-only",
+        drift: "low",
+        reindex: "entry",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    // ── Selection / pricing structure (snapshotted at book time) ───────────
+    {
+        path: "selectionType",
+        class: "structural",
+        merge: "source-only",
+        drift: "high",
+        reindex: "none",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "pricingMode",
+        class: "structural",
+        merge: "source-only",
+        drift: "high",
+        reindex: "none",
+        snapshot: "on-quote-and-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "pricedPerPerson",
+        class: "structural",
+        merge: "source-only",
+        drift: "high",
+        reindex: "none",
+        snapshot: "on-quote-and-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "minQuantity",
+        class: "structural",
+        merge: "source-only",
+        drift: "medium",
+        reindex: "none",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "maxQuantity",
+        class: "structural",
+        merge: "source-only",
+        drift: "medium",
+        reindex: "none",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "defaultQuantity",
+        class: "structural",
+        merge: "source-only",
+        drift: "low",
+        reindex: "none",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "active",
+        class: "structural",
+        merge: "source-only",
+        drift: "high",
+        reindex: "none",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "sortOrder",
+        class: "structural",
+        merge: "source-only",
+        drift: "none",
+        reindex: "none",
+        snapshot: "never",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff"],
+        editRole: "ops",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+];
+export const extrasCatalogPolicy = defineFieldPolicy(EXTRAS_FIELD_POLICY);
+export { EXTRAS_FIELD_POLICY };

package/dist/extras/content-shape.d.ts

@@ -0,0 +1,5 @@
+import { type ContentOverlay, type MergeOverlaysOptions } from "@voyant-travel/catalog";
+import { type ExtraContent } from "@voyant-travel/extras-contracts/content-shape";
+export { EXTRAS_CONTENT_SCHEMA_VERSION, type ExtraContent, type ExtraMediaItem, type ExtraOption, type ExtraPolicy, type ExtraSummary, extraContentSchema, extraMediaItemSchema, extraOptionSchema, extraPolicySchema, extraSummarySchema, validateExtraContent, } from "@voyant-travel/extras-contracts/content-shape";
+export declare function mergeOverlaysIntoExtraContent(payload: ExtraContent, overlays: ReadonlyArray<ContentOverlay>, options?: Pick<MergeOverlaysOptions, "onOverlayError">): ExtraContent;
+//# sourceMappingURL=content-shape.d.ts.map

package/dist/extras/content-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-shape.d.ts","sourceRoot":"","sources":["../../src/extras/content-shape.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EAE1B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,KAAK,YAAY,EAGlB,MAAM,+CAA+C,CAAA;AAEtD,OAAO,EACL,6BAA6B,EAC7B,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,+CAA+C,CAAA;AAEtD,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,aAAa,CAAC,cAAc,CAAC,EACvC,OAAO,GAAE,IAAI,CAAC,oBAAoB,EAAE,gBAAgB,CAAM,GACzD,YAAY,CASd"}

package/dist/extras/content-shape.js

@@ -0,0 +1,13 @@
+import { mergeOverlaysIntoContent, } from "@voyant-travel/catalog";
+import { extraContentSchema, validateExtraContent, } from "@voyant-travel/extras-contracts/content-shape";
+export { EXTRAS_CONTENT_SCHEMA_VERSION, extraContentSchema, extraMediaItemSchema, extraOptionSchema, extraPolicySchema, extraSummarySchema, validateExtraContent, } from "@voyant-travel/extras-contracts/content-shape";
+export function mergeOverlaysIntoExtraContent(payload, overlays, options = {}) {
+    const merged = mergeOverlaysIntoContent(payload, overlays, {
+        validate(p) {
+            const r = validateExtraContent(p);
+            return r.valid ? { valid: true } : { valid: false, reason: r.reason };
+        },
+        onOverlayError: options.onOverlayError,
+    });
+    return extraContentSchema.parse(merged);
+}

package/dist/extras/draft-shape.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Project an `ExtraContent` payload into a `BookingDraftShape`.
+ *
+ * Extras are booking add-ons (excursions, transfers, insurance) —
+ * they're never standalone bookable on their own; they always layer
+ * onto a parent product. So the descriptor here is **degenerate**:
+ *
+ *   - `showsConfigure: false` (no configure step — extras are picked
+ *     during the parent product's add-on step).
+ *   - `showsTravelers: false` (extras don't have their own pax flow).
+ *   - `showsPayment: false` (extras roll up into the parent's pricing).
+ *   - `addons.catalog`: the extra itself + its sub-options projected
+ *     as a small catalog. Useful for journey contexts that want to
+ *     render an add-on detail view (e.g. ops admin reviewing a
+ *     supplier's extras).
+ *
+ * In practice templates rarely call this directly — the parent
+ * product's `BookingDraftShape` aggregates extras via the journey's
+ * cross-product composer. This function is the building block.
+ */
+import { type BookingDraftShape } from "@voyant-travel/catalog/booking-engine";
+import type { ExtraContent } from "./content-shape.js";
+export interface BuildExtraDraftShapeOptions {
+    locale?: string;
+    /**
+     * When true, returns the full descriptor surface (configure +
+     * travelers + payment all visible). Useful for tests or admin
+     * surfaces that render extras standalone. Defaults to false (the
+     * normal "extras-as-addon" mode).
+     */
+    standalone?: boolean;
+}
+export declare function buildExtraDraftShape(content: ExtraContent, options?: BuildExtraDraftShapeOptions): BookingDraftShape;
+//# sourceMappingURL=draft-shape.d.ts.map

package/dist/extras/draft-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-shape.d.ts","sourceRoot":"","sources":["../../src/extras/draft-shape.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAEL,KAAK,iBAAiB,EAMvB,MAAM,uCAAuC,CAAA;AAE9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAMtD,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,2BAAgC,GACxC,iBAAiB,CAsCnB"}