@voyantjs/extras 0.19.0 → 0.21.0

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

@@ -0,0 +1,79 @@
+/**
+ * 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 "@voyantjs/catalog";
+import type { AnyDrizzleDb } from "@voyantjs/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 opt out of search-index
+ * participation — the catalog-policy declares every field with
+ * `reindex: "none"`. The emitter is provided for completeness (a deployment
+ * may opt extras into the index for ops-side keyword search) but production
+ * deployments should not register an extras emitter with the IndexerService.
+ */
+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/service-catalog-plane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-catalog-plane.d.ts","sourceRoot":"","sources":["../src/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,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAIhD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAU3C;;;;;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,CA6B9B;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;;;;;;GAMG;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,CAYjB;AAED,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,aAAa,GACd,CAAA"}

package/dist/service-catalog-plane.js

@@ -0,0 +1,157 @@
+/**
+ * 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 "@voyantjs/catalog";
+import { eq } from "drizzle-orm";
+import { extrasCatalogPolicy } from "./catalog-policy.js";
+import { productExtras } from "./schema.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],
+        // Selection / pricing structure
+        ["selectionType", row.selectionType],
+        ["pricingMode", row.pricingMode],
+        ["pricedPerPerson", row.pricedPerPerson],
+        ["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 opt out of search-index
+ * participation — the catalog-policy declares every field with
+ * `reindex: "none"`. The emitter is provided for completeness (a deployment
+ * may opt extras into the index for ops-side keyword search) but production
+ * deployments should not register an extras emitter with the IndexerService.
+ */
+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 emitter = createExtraDocumentEmitter(context);
+    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;
+        return emitter.emit(row, slice);
+    };
+}

package/dist/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 "@voyantjs/catalog";
+import type { AnyDrizzleDb } from "@voyantjs/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/service-content-synthesizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-content-synthesizer.d.ts","sourceRoot":"","sources":["../src/service-content-synthesizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAEhD,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/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 "@voyantjs/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/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 / hospitality
+ * / 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 "@voyantjs/catalog";
+import type { SourceAdapterRegistry } from "@voyantjs/catalog/booking-engine";
+import type { AnyDrizzleDb } from "@voyantjs/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/service-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-content.d.ts","sourceRoot":"","sources":["../src/service-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,KAAK,uBAAuB,EAK5B,KAAK,iBAAiB,EAKtB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EAE1B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAA;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAGhD,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"}