@voyant-travel/inventory 0.1.0

package/dist/extras/schema.js

@@ -0,0 +1,87 @@
+import { typeId, typeIdRef } from "@voyant-travel/db/lib/typeid-column";
+import { relations } from "drizzle-orm";
+import { boolean, index, integer, jsonb, pgEnum, pgTable, text, timestamp, uniqueIndex, } from "drizzle-orm/pg-core";
+export const extraSelectionTypeEnum = pgEnum("extra_selection_type", [
+    "optional",
+    "required",
+    "default_selected",
+    "unavailable",
+]);
+export const extraPricingModeEnum = pgEnum("extra_pricing_mode", [
+    "included",
+    "per_person",
+    "per_booking",
+    "quantity_based",
+    "on_request",
+    "free",
+]);
+export const extraCollectionModeEnum = pgEnum("extra_collection_mode", [
+    "booking_total",
+    "cash_on_trip",
+    "external",
+    "included",
+    "none",
+]);
+export const productExtras = pgTable("product_extras", {
+    id: typeId("product_extras"),
+    productId: text("product_id").notNull(),
+    supplierId: text("supplier_id"),
+    code: text("code"),
+    name: text("name").notNull(),
+    description: text("description"),
+    selectionType: extraSelectionTypeEnum("selection_type").notNull().default("optional"),
+    pricingMode: extraPricingModeEnum("pricing_mode").notNull().default("per_booking"),
+    pricedPerPerson: boolean("priced_per_person").notNull().default(false),
+    collectionMode: extraCollectionModeEnum("collection_mode").notNull().default("booking_total"),
+    showOnSlotManifest: boolean("show_on_slot_manifest").notNull().default(true),
+    minQuantity: integer("min_quantity"),
+    maxQuantity: integer("max_quantity"),
+    defaultQuantity: integer("default_quantity"),
+    active: boolean("active").notNull().default(true),
+    sortOrder: integer("sort_order").notNull().default(0),
+    metadata: jsonb("metadata").$type(),
+    createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+    updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow(),
+}, (table) => [
+    index("idx_product_extras_sort_name").on(table.sortOrder, table.name),
+    index("idx_product_extras_product_sort_name").on(table.productId, table.sortOrder, table.name),
+    index("idx_product_extras_supplier_sort_name").on(table.supplierId, table.sortOrder, table.name),
+    index("idx_product_extras_active_sort_name").on(table.active, table.sortOrder, table.name),
+    uniqueIndex("uidx_product_extras_product_code").on(table.productId, table.code),
+]);
+export const optionExtraConfigs = pgTable("option_extra_configs", {
+    id: typeId("option_extra_configs"),
+    optionId: text("option_id").notNull(),
+    productExtraId: typeIdRef("product_extra_id")
+        .notNull()
+        .references(() => productExtras.id, { onDelete: "cascade" }),
+    selectionType: extraSelectionTypeEnum("selection_type"),
+    pricingMode: extraPricingModeEnum("pricing_mode"),
+    pricedPerPerson: boolean("priced_per_person"),
+    minQuantity: integer("min_quantity"),
+    maxQuantity: integer("max_quantity"),
+    defaultQuantity: integer("default_quantity"),
+    isDefault: boolean("is_default").notNull().default(false),
+    active: boolean("active").notNull().default(true),
+    sortOrder: integer("sort_order").notNull().default(0),
+    notes: text("notes"),
+    metadata: jsonb("metadata").$type(),
+    createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+    updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow(),
+}, (table) => [
+    index("idx_option_extra_configs_sort_default").on(table.sortOrder, table.isDefault),
+    index("idx_option_extra_configs_option_sort_default").on(table.optionId, table.sortOrder, table.isDefault),
+    index("idx_option_extra_configs_extra_sort_default").on(table.productExtraId, table.sortOrder, table.isDefault),
+    index("idx_option_extra_configs_active_sort_default").on(table.active, table.sortOrder, table.isDefault),
+    uniqueIndex("uidx_option_extra_configs_option_extra").on(table.optionId, table.productExtraId),
+]);
+export const productExtrasRelations = relations(productExtras, ({ many }) => ({
+    optionConfigs: many(optionExtraConfigs),
+}));
+export const optionExtraConfigsRelations = relations(optionExtraConfigs, ({ one }) => ({
+    productExtra: one(productExtras, {
+        fields: [optionExtraConfigs.productExtraId],
+        references: [productExtras.id],
+    }),
+}));
+export { EXTRAS_CONTENT_MARKET_ANY, extrasSourcedContentTable, } from "./schema-sourced-content.js";

package/dist/extras/service-catalog-plane.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Catalog-plane integration for the extras service.
+ *
+ * Extras are a **partial-adoption vertical** per architecture §3.3.1: they
+ * participate in provenance + booking snapshot + catalog event taxonomy,
+ * but skip the search index and overlay store. The service-plane integration
+ * here reflects that — `getResolvedExtraById` returns a resolved view but
+ * the resolver always sees an empty overlay set (extras have no overlay
+ * rows; the catalog-policy file declares no merchandisable fields).
+ *
+ * The value of running through the catalog-plane resolver anyway is
+ * uniformity: extras' projection and visibility filtering use the same
+ * machinery as every other vertical, and snapshot capture at booking commit
+ * (the most important participation surface for extras) reuses
+ * `productExtraRowToProjection` to build the frozen payload.
+ *
+ * See `docs/architecture/catalog-architecture.md` §9.1 + §3.3.1.
+ */
+import { type CaptureSnapshotInput, type DocumentBuilder, type DocumentEmitter, type IndexerDocument, type IndexerSlice, type PricingBasis, type Provenance, type ResolvedView, type ResolverScope } from "@voyant-travel/catalog";
+import type { AnyDrizzleDb } from "@voyant-travel/db";
+import { productExtras } from "./schema.js";
+/**
+ * Maps a product-extra row to a field-keyed projection. Extras almost
+ * always inherit their provenance from the parent product they attach to;
+ * the caller passes the parent's source kind / ref through, defaulting to
+ * `owned` for operator-defined extras.
+ */
+export declare function productExtraRowToProjection(row: typeof productExtras.$inferSelect, context: {
+    sellerOperatorId: string;
+    sourceKind?: string;
+    sourceRef?: string;
+}): ReadonlyMap<string, unknown>;
+export declare function productExtraProvenance(_row: typeof productExtras.$inferSelect, context: {
+    sellerOperatorId: string;
+    sourceKind?: string;
+    sourceRef?: string;
+}): Provenance;
+export interface ProductExtraCatalogContext {
+    sellerOperatorId: string;
+    scope: ResolverScope;
+    sourceKind?: string;
+    sourceRef?: string;
+}
+/**
+ * Catalog-aware extra fetch. The catalog-policy declares no merchandisable
+ * fields for extras (per §3.3.1 partial adoption), so the resolver acts as
+ * a pure visibility filter rather than an overlay-merge engine. Useful
+ * primarily for snapshot capture at booking time.
+ */
+export declare function getResolvedExtraById(db: AnyDrizzleDb, id: string, context: ProductExtraCatalogContext): Promise<ResolvedView | null>;
+export declare function listResolvedExtras(db: AnyDrizzleDb, rows: ReadonlyArray<typeof productExtras.$inferSelect>, context: ProductExtraCatalogContext): Promise<ResolvedView[]>;
+/**
+ * Build a `CaptureSnapshotInput` for a product extra. Extras participate
+ * in the snapshot graph (per §3.3.1 partial adoption) so refunds can know
+ * exactly what add-on the customer purchased and what selectionType /
+ * pricingMode applied at booking time.
+ */
+export declare function buildExtraSnapshotInput(db: AnyDrizzleDb, extraId: string, context: ProductExtraCatalogContext & {
+    pricingBasis?: PricingBasis;
+}): Promise<Omit<CaptureSnapshotInput, "bookingId"> | null>;
+/**
+ * Note: per architecture §3.3.1, extras are a partial-adoption vertical.
+ * Most fields remain snapshot-oriented, but deployments may opt extras into
+ * the index for ops-side keyword search and thumbnail rendering.
+ */
+export declare function createExtraDocumentEmitter(context: {
+    sellerOperatorId: string;
+    sourceKind?: string;
+    sourceRef?: string;
+}): DocumentEmitter<typeof productExtras.$inferSelect>;
+export declare function createExtraDocumentBuilder(db: AnyDrizzleDb, context: {
+    sellerOperatorId: string;
+    sourceKind?: string;
+    sourceRef?: string;
+}): DocumentBuilder;
+export type { CaptureSnapshotInput, DocumentBuilder, DocumentEmitter, IndexerDocument, IndexerSlice, PricingBasis, Provenance, ResolvedView, ResolverScope, };
+//# sourceMappingURL=service-catalog-plane.d.ts.map

package/dist/extras/service-catalog-plane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-catalog-plane.d.ts","sourceRoot":"","sources":["../../src/extras/service-catalog-plane.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAGL,KAAK,oBAAoB,EAEzB,KAAK,eAAe,EACpB,KAAK,eAAe,EAEpB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,aAAa,EAEnB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAIrD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAW3C;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,OAAO,aAAa,CAAC,YAAY,EACtC,OAAO,EAAE;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7E,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAgC9B;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,aAAa,CAAC,YAAY,EACvC,OAAO,EAAE;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7E,UAAU,CAMZ;AAED,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,EAAE,MAAM,CAAA;IACxB,KAAK,EAAE,aAAa,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,YAAY,EAChB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAW9B;AAED,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,YAAY,EAChB,IAAI,EAAE,aAAa,CAAC,OAAO,aAAa,CAAC,YAAY,CAAC,EACtD,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,YAAY,EAAE,CAAC,CAazB;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,YAAY,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,0BAA0B,GAAG;IAAE,YAAY,CAAC,EAAE,YAAY,CAAA;CAAE,GACpE,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC,CAUzD;AAMD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,gBAAgB,EAAE,MAAM,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,eAAe,CAAC,OAAO,aAAa,CAAC,YAAY,CAAC,CAarD;AAED,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,YAAY,EAChB,OAAO,EAAE;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7E,eAAe,CAuBjB;AA0ED,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,aAAa,GACd,CAAA"}

package/dist/extras/service-catalog-plane.js

@@ -0,0 +1,219 @@
+/**
+ * Catalog-plane integration for the extras service.
+ *
+ * Extras are a **partial-adoption vertical** per architecture §3.3.1: they
+ * participate in provenance + booking snapshot + catalog event taxonomy,
+ * but skip the search index and overlay store. The service-plane integration
+ * here reflects that — `getResolvedExtraById` returns a resolved view but
+ * the resolver always sees an empty overlay set (extras have no overlay
+ * rows; the catalog-policy file declares no merchandisable fields).
+ *
+ * The value of running through the catalog-plane resolver anyway is
+ * uniformity: extras' projection and visibility filtering use the same
+ * machinery as every other vertical, and snapshot capture at booking commit
+ * (the most important participation surface for extras) reuses
+ * `productExtraRowToProjection` to build the frozen payload.
+ *
+ * See `docs/architecture/catalog-architecture.md` §9.1 + §3.3.1.
+ */
+import { buildIndexerDocument, buildSnapshotInputFromView, createFieldPolicyRegistry, resolveEntityView, } from "@voyant-travel/catalog";
+import { and, eq } from "drizzle-orm";
+import { extrasCatalogPolicy } from "./catalog-policy.js";
+import { productExtras } from "./schema.js";
+import { EXTRAS_CONTENT_MARKET_ANY, extrasSourcedContentTable } from "./schema-sourced-content.js";
+let _registry;
+function getExtrasRegistry() {
+    if (!_registry) {
+        _registry = createFieldPolicyRegistry(extrasCatalogPolicy);
+    }
+    return _registry;
+}
+/**
+ * Maps a product-extra row to a field-keyed projection. Extras almost
+ * always inherit their provenance from the parent product they attach to;
+ * the caller passes the parent's source kind / ref through, defaulting to
+ * `owned` for operator-defined extras.
+ */
+export function productExtraRowToProjection(row, context) {
+    return new Map([
+        // Provenance
+        ["source.kind", context.sourceKind ?? "owned"],
+        ["source.ref", context.sourceRef],
+        ["seller.operator_id", context.sellerOperatorId],
+        // Identity + cross-module reference
+        ["id", row.id],
+        ["code", row.code],
+        ["productId", row.productId],
+        ["supplierId", row.supplierId],
+        ["createdAt", row.createdAt],
+        ["updatedAt", row.updatedAt],
+        // Snapshot-relevant managed fields
+        ["name", row.name],
+        ["description", row.description],
+        ["thumbnailUrl", pickThumbnailUrl(row.metadata)],
+        // Selection / pricing structure
+        ["selectionType", row.selectionType],
+        ["pricingMode", row.pricingMode],
+        ["pricedPerPerson", row.pricedPerPerson],
+        ["collectionMode", row.collectionMode],
+        ["showOnSlotManifest", row.showOnSlotManifest],
+        ["minQuantity", row.minQuantity],
+        ["maxQuantity", row.maxQuantity],
+        ["defaultQuantity", row.defaultQuantity],
+        ["active", row.active],
+        ["sortOrder", row.sortOrder],
+    ]);
+}
+export function productExtraProvenance(_row, context) {
+    return {
+        source_kind: context.sourceKind ?? "owned",
+        source_freshness: context.sourceKind && context.sourceKind !== "owned" ? "sync" : "static",
+        source_ref: context.sourceRef,
+    };
+}
+/**
+ * Catalog-aware extra fetch. The catalog-policy declares no merchandisable
+ * fields for extras (per §3.3.1 partial adoption), so the resolver acts as
+ * a pure visibility filter rather than an overlay-merge engine. Useful
+ * primarily for snapshot capture at booking time.
+ */
+export async function getResolvedExtraById(db, id, context) {
+    const rows = await db.select().from(productExtras).where(eq(productExtras.id, id)).limit(1);
+    const row = rows[0];
+    if (!row)
+        return null;
+    const projection = productExtraRowToProjection(row, {
+        sellerOperatorId: context.sellerOperatorId,
+        sourceKind: context.sourceKind,
+        sourceRef: context.sourceRef,
+    });
+    return resolveEntityView(db, getExtrasRegistry(), "extras", id, projection, context.scope);
+}
+export async function listResolvedExtras(db, rows, context) {
+    const registry = getExtrasRegistry();
+    const views = [];
+    for (const row of rows) {
+        const projection = productExtraRowToProjection(row, {
+            sellerOperatorId: context.sellerOperatorId,
+            sourceKind: context.sourceKind,
+            sourceRef: context.sourceRef,
+        });
+        const view = await resolveEntityView(db, registry, "extras", row.id, projection, context.scope);
+        views.push(view);
+    }
+    return views;
+}
+/**
+ * Build a `CaptureSnapshotInput` for a product extra. Extras participate
+ * in the snapshot graph (per §3.3.1 partial adoption) so refunds can know
+ * exactly what add-on the customer purchased and what selectionType /
+ * pricingMode applied at booking time.
+ */
+export async function buildExtraSnapshotInput(db, extraId, context) {
+    const view = await getResolvedExtraById(db, extraId, context);
+    if (!view)
+        return null;
+    return buildSnapshotInputFromView(view, {
+        entityModule: "extras",
+        entityId: extraId,
+        sourceKind: context.sourceKind ?? "owned",
+        sourceRef: context.sourceRef,
+        pricingBasis: context.pricingBasis,
+    });
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Indexer document emission
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Note: per architecture §3.3.1, extras are a partial-adoption vertical.
+ * Most fields remain snapshot-oriented, but deployments may opt extras into
+ * the index for ops-side keyword search and thumbnail rendering.
+ */
+export function createExtraDocumentEmitter(context) {
+    const registry = getExtrasRegistry();
+    return {
+        vertical: "extras",
+        emit(source, slice) {
+            const projection = productExtraRowToProjection(source, {
+                sellerOperatorId: context.sellerOperatorId,
+                sourceKind: context.sourceKind,
+                sourceRef: context.sourceRef,
+            });
+            return buildIndexerDocument(registry, projection, slice, source.id);
+        },
+    };
+}
+export function createExtraDocumentBuilder(db, context) {
+    const registry = getExtrasRegistry();
+    return async (entityId, slice) => {
+        const rows = await db
+            .select()
+            .from(productExtras)
+            .where(eq(productExtras.id, entityId))
+            .limit(1);
+        const row = rows[0];
+        if (!row)
+            return null;
+        const projection = new Map(productExtraRowToProjection(row, {
+            sellerOperatorId: context.sellerOperatorId,
+            sourceKind: context.sourceKind,
+            sourceRef: context.sourceRef,
+        }));
+        const sourcedThumbnailUrl = await fetchSourcedContentThumbnailUrl(db, entityId, slice);
+        if (sourcedThumbnailUrl) {
+            projection.set("thumbnailUrl", sourcedThumbnailUrl);
+        }
+        return buildIndexerDocument(registry, projection, slice, entityId);
+    };
+}
+async function fetchSourcedContentThumbnailUrl(db, entityId, slice) {
+    const rows = await db
+        .select({
+        market: extrasSourcedContentTable.market,
+        payload: extrasSourcedContentTable.payload,
+    })
+        .from(extrasSourcedContentTable)
+        .where(and(eq(extrasSourcedContentTable.entity_id, entityId), eq(extrasSourcedContentTable.locale, slice.locale)));
+    const row = rows.find((candidate) => candidate.market === slice.market) ??
+        rows.find((candidate) => candidate.market === EXTRAS_CONTENT_MARKET_ANY) ??
+        rows[0];
+    return pickThumbnailUrl(row?.payload);
+}
+function pickThumbnailUrl(value) {
+    const record = asRecord(value);
+    if (!record)
+        return null;
+    return (firstString(record.thumbnailUrl, record.heroImageUrl, record.hero_image_url, record.imageUrl, record.image_url) ??
+        firstMediaUrl(record.media) ??
+        firstStringFromArray(record.images) ??
+        firstStringFromArray(record.galleryUrls));
+}
+function firstMediaUrl(value) {
+    if (!Array.isArray(value))
+        return null;
+    for (const item of value) {
+        const media = asRecord(item);
+        if (!media)
+            continue;
+        const type = typeof media.type === "string" ? media.type : null;
+        if (type && type !== "image")
+            continue;
+        const url = firstString(media.url, media.src);
+        if (url)
+            return url;
+    }
+    return null;
+}
+function firstStringFromArray(value) {
+    if (!Array.isArray(value))
+        return null;
+    return value.find((item) => typeof item === "string" && item.length > 0) ?? null;
+}
+function firstString(...values) {
+    return (values.find((value) => typeof value === "string" && value.length > 0) ?? null);
+}
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}

package/dist/extras/service-content-synthesizer.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Extras content synthesizer — fallback for thin adapters that declare
+ * `supportsContentFetch: false`.
+ *
+ * Produces the most complete `ExtraContent` blob we can legitimately
+ * synthesize from the durable sourced-entry projection + locale-aware
+ * overlays + plane-level provenance. Sub-options render as a typed
+ * empty state unless the projection genuinely carries them.
+ *
+ * Per §3.6: never invents plausible-but-unverified fields, never
+ * machine-translates, never mines snapshots, never caches its own
+ * output.
+ */
+import { type ProvenanceReadResult } from "@voyant-travel/catalog";
+import type { AnyDrizzleDb } from "@voyant-travel/db";
+import { type ExtraContent } from "./content-shape.js";
+export interface SynthesizeExtraContentOptions {
+    provenance: Extract<ProvenanceReadResult, {
+        kind: "sourced";
+    }>;
+    overlays?: ReadonlyArray<{
+        field_path: string;
+        value: unknown;
+    }>;
+}
+export interface SynthesizedExtraContent {
+    content: ExtraContent;
+    content_schema_version: string;
+    served_locale: string;
+    source_kind: string;
+    source_provider?: string;
+}
+export declare function synthesizeExtraContent(scope: {
+    locale: string;
+}, options: SynthesizeExtraContentOptions): SynthesizedExtraContent;
+export declare function synthesizeExtraContentFromDb(db: AnyDrizzleDb, scope: {
+    locale: string;
+}, provenance: Extract<ProvenanceReadResult, {
+    kind: "sourced";
+}>): Promise<SynthesizedExtraContent>;
+//# sourceMappingURL=service-content-synthesizer.d.ts.map

package/dist/extras/service-content-synthesizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-content-synthesizer.d.ts","sourceRoot":"","sources":["../../src/extras/service-content-synthesizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,OAAO,EAEL,KAAK,YAAY,EAElB,MAAM,oBAAoB,CAAA;AAE3B,MAAM,WAAW,6BAA6B;IAC5C,UAAU,EAAE,OAAO,CAAC,oBAAoB,EAAE;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE,CAAC,CAAA;IAC9D,QAAQ,CAAC,EAAE,aAAa,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CACjE;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,YAAY,CAAA;IACrB,sBAAsB,EAAE,MAAM,CAAA;IAC9B,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EACzB,OAAO,EAAE,6BAA6B,GACrC,uBAAuB,CAiCzB;AAED,wBAAsB,4BAA4B,CAChD,EAAE,EAAE,YAAY,EAChB,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EACzB,UAAU,EAAE,OAAO,CAAC,oBAAoB,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,GAC7D,OAAO,CAAC,uBAAuB,CAAC,CAOlC"}

package/dist/extras/service-content-synthesizer.js

@@ -0,0 +1,138 @@
+/**
+ * Extras content synthesizer — fallback for thin adapters that declare
+ * `supportsContentFetch: false`.
+ *
+ * Produces the most complete `ExtraContent` blob we can legitimately
+ * synthesize from the durable sourced-entry projection + locale-aware
+ * overlays + plane-level provenance. Sub-options render as a typed
+ * empty state unless the projection genuinely carries them.
+ *
+ * Per §3.6: never invents plausible-but-unverified fields, never
+ * machine-translates, never mines snapshots, never caches its own
+ * output.
+ */
+import { fetchOverlaysForEntity, mergeOverlaysIntoContent, } from "@voyant-travel/catalog";
+import { EXTRAS_CONTENT_SCHEMA_VERSION, extraContentSchema, } from "./content-shape.js";
+export function synthesizeExtraContent(scope, options) {
+    const projection = options.provenance.projection;
+    const extra = pickExtraSummary(projection, options.provenance);
+    const media = pickMedia(projection);
+    const policies = pickPolicies(projection);
+    const baseContent = {
+        extra,
+        options: [],
+        media,
+        policies,
+    };
+    let merged = baseContent;
+    if (options.overlays && options.overlays.length > 0) {
+        const result = mergeOverlaysIntoContent(baseContent, options.overlays, {
+            validate(p) {
+                const r = extraContentSchema.safeParse(p);
+                return r.success
+                    ? { valid: true }
+                    : { valid: false, reason: r.error.issues[0]?.message ?? "invalid" };
+            },
+        });
+        merged = extraContentSchema.parse(result);
+    }
+    return {
+        content: merged,
+        content_schema_version: EXTRAS_CONTENT_SCHEMA_VERSION,
+        served_locale: scope.locale,
+        source_kind: options.provenance.provenance.source_kind,
+        source_provider: options.provenance.provenance.source_provider,
+    };
+}
+export async function synthesizeExtraContentFromDb(db, scope, provenance) {
+    const entityId = entityIdFromProvenance(provenance);
+    const overlays = await fetchOverlaysForEntity(db, "extras", entityId);
+    return synthesizeExtraContent(scope, {
+        provenance,
+        overlays: overlays.map((o) => ({ field_path: o.field_path, value: o.value })),
+    });
+}
+function entityIdFromProvenance(provenance) {
+    const fromProjection = provenance.projection.id;
+    if (typeof fromProjection === "string" && fromProjection.length > 0) {
+        return fromProjection;
+    }
+    return provenance.entry_id;
+}
+function pickExtraSummary(projection, provenance) {
+    return {
+        id: stringOr(projection.id, "") || provenance.entry_id,
+        name: stringOr(projection.name, "") || stringOr(projection.title, "") || "Unnamed extra",
+        status: stringOr(projection.status, undefined),
+        description: stringOr(projection.description, null),
+        selection_type: stringOr(projection.selection_type, "optional"),
+        pricing_mode: stringOr(projection.pricing_mode, "per_booking"),
+        priced_per_person: typeof projection.priced_per_person === "boolean" ? projection.priced_per_person : undefined,
+        category: stringOr(projection.category, null),
+        hero_image_url: stringOr(projection.hero_image_url, null),
+        highlights: stringArrayOr(projection.highlights, []),
+        supplier: stringOr(projection.supplier, null) ??
+            stringOr(projection.supplier_name, null) ??
+            provenance.provenance.source_provider ??
+            null,
+        duration_minutes: numberOr(projection.duration_minutes, null),
+        requirements_summary: stringOr(projection.requirements_summary, null),
+    };
+}
+function pickMedia(projection) {
+    const heroUrl = stringOr(projection.hero_image_url, null);
+    const out = [];
+    if (heroUrl) {
+        out.push({ url: heroUrl, type: "image", caption: null, alt: null });
+    }
+    const additional = projection.media;
+    if (Array.isArray(additional)) {
+        for (const item of additional) {
+            if (item && typeof item === "object") {
+                const obj = item;
+                const url = stringOr(obj.url, null);
+                if (!url)
+                    continue;
+                out.push({
+                    url,
+                    type: pickMediaType(obj.type),
+                    caption: stringOr(obj.caption, null),
+                    alt: stringOr(obj.alt, null),
+                });
+            }
+        }
+    }
+    return out;
+}
+function pickMediaType(value) {
+    if (value === "video")
+        return "video";
+    if (value === "document")
+        return "document";
+    return "image";
+}
+function pickPolicies(projection) {
+    const out = [];
+    const cancel = stringOr(projection.cancellation_policy, null);
+    if (cancel)
+        out.push({ kind: "cancellation", body: cancel });
+    const payment = stringOr(projection.payment_terms, null);
+    if (payment)
+        out.push({ kind: "payment", body: payment });
+    const requirements = stringOr(projection.requirements, null);
+    if (requirements)
+        out.push({ kind: "requirements", body: requirements });
+    return out;
+}
+function stringOr(value, fallback) {
+    return typeof value === "string" && value.length > 0 ? value : fallback;
+}
+function numberOr(value, fallback) {
+    return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+function stringArrayOr(value, fallback) {
+    if (!Array.isArray(value))
+        return fallback;
+    const out = value.filter((v) => typeof v === "string");
+    return out.length > 0 ? out : fallback;
+}

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

@@ -0,0 +1,48 @@
+/**
+ * Extras content service — `getExtraContent` with locale-resolved
+ * cache reads, SWR refresh, and synthesizer fallback.
+ *
+ * Mirrors `service-content.ts` in the products / cruises / accommodations
+ * / charters packages but extras-shaped. The extras content aggregate
+ * (§3.2 / §3.6) is `{ extra, options[], media[], policies[] }` — one
+ * payload returned by a single getContent. Pricing stays out (volatile-
+ * live, flows through `liveResolve`).
+ *
+ * Extras don't appear in the search index (per the vertical's catalog-
+ * policy.ts), but sourced extras still need rich content for the
+ * booking-flow's add-on selection UI. The cache layer covers exactly
+ * that surface.
+ */
+import { type ContentLocaleResolution, type InvalidateOnDrift, type SourceAdapter, type SourceAdapterContext } from "@voyant-travel/catalog";
+import type { SourceAdapterRegistry } from "@voyant-travel/catalog/booking-engine";
+import type { AnyDrizzleDb } from "@voyant-travel/db";
+import { type ExtraContent } from "./content-shape.js";
+export interface ExtraContentScope {
+    preferredLocales: ReadonlyArray<string>;
+    market?: string;
+    currency?: string;
+    acceptMachineTranslated?: boolean;
+}
+export interface GetExtraContentOptions {
+    registry: SourceAdapterRegistry;
+    buildAdapterContext?: (adapter: SourceAdapter) => SourceAdapterContext;
+    onOverlayError?: (event: {
+        field_path: string;
+        reason: string;
+    }) => void;
+}
+export interface ResolvedExtraContent {
+    content: ExtraContent;
+    resolution: ContentLocaleResolution<{
+        locale: string;
+        payload: ExtraContent;
+    }>;
+    source: "sourced-cache" | "sourced-fresh" | "synthesized";
+    served_stale: boolean;
+    synthesized: boolean;
+    machine_translated: boolean;
+}
+export declare function getExtraContent(db: AnyDrizzleDb, entityId: string, scope: ExtraContentScope, options: GetExtraContentOptions): Promise<ResolvedExtraContent | null>;
+/** Drift event consumer for the extras content cache. Per §3.4.1. */
+export declare const invalidateExtraContentOnDrift: InvalidateOnDrift;
+//# sourceMappingURL=service-content.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service-content.d.ts","sourceRoot":"","sources":["../../src/extras/service-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,KAAK,uBAAuB,EAK5B,KAAK,iBAAiB,EAKtB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EAE1B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAA;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGrD,OAAO,EAEL,KAAK,YAAY,EAIlB,MAAM,oBAAoB,CAAA;AAc3B,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACvC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uBAAuB,CAAC,EAAE,OAAO,CAAA;CAClC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,qBAAqB,CAAA;IAC/B,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,oBAAoB,CAAA;IACtE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;CACzE;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,YAAY,CAAA;IACrB,UAAU,EAAE,uBAAuB,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,YAAY,CAAA;KAAE,CAAC,CAAA;IAC9E,MAAM,EAAE,eAAe,GAAG,eAAe,GAAG,aAAa,CAAA;IACzD,YAAY,EAAE,OAAO,CAAA;IACrB,WAAW,EAAE,OAAO,CAAA;IACpB,kBAAkB,EAAE,OAAO,CAAA;CAC5B;AAED,wBAAsB,eAAe,CACnC,EAAE,EAAE,YAAY,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CA0FtC;AA2ND,qEAAqE;AACrE,eAAO,MAAM,6BAA6B,EAAE,iBAG3C,CAAA"}