@voyant-travel/cruises 0.118.2

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

@@ -0,0 +1,90 @@
+/**
+ * Cruise cabin/deck projection extension.
+ *
+ * Joins a cruise's default ship to cabin categories, specific cabins, and
+ * decks, then denormalizes machine-filterable cabin/deck facets onto the
+ * cruise search document.
+ */
+import { asc, eq } from "drizzle-orm";
+import { cruiseCabinCategories, cruiseCabins, cruiseDecks } from "./schema-cabins.js";
+import { cruises } from "./schema-core.js";
+export function projectCruiseCabinFacetRows(rows) {
+    const cabinCategoryIds = [];
+    const cabinCategoryCodes = [];
+    const cabinGradeCodes = [];
+    const cabinRoomTypes = [];
+    const cabinFeatureCodes = [];
+    const cabinBedConfigurations = [];
+    const cabinAccessibilityFeatures = [];
+    const cabinViewTypes = [];
+    const deckIds = [];
+    const deckNames = [];
+    const deckLevels = [];
+    for (const row of rows) {
+        pushUnique(cabinCategoryIds, row.cabinCategoryId);
+        pushUnique(cabinCategoryCodes, row.cabinCategoryCode);
+        pushUnique(cabinRoomTypes, row.roomType);
+        for (const code of row.featureCodes ?? [])
+            pushUnique(cabinFeatureCodes, code);
+        for (const bed of row.bedConfigurations ?? [])
+            pushUnique(cabinBedConfigurations, bed);
+        for (const feature of row.accessibilityFeatures ?? []) {
+            pushUnique(cabinAccessibilityFeatures, feature);
+        }
+        if (row.viewType)
+            pushUnique(cabinViewTypes, row.viewType);
+        for (const grade of row.gradeCodes ?? [])
+            pushUnique(cabinGradeCodes, grade);
+        if (row.deckId)
+            pushUnique(deckIds, row.deckId);
+        if (row.deckName)
+            pushUnique(deckNames, row.deckName);
+        if (row.deckLevel !== null)
+            pushUnique(deckLevels, row.deckLevel);
+    }
+    return new Map([
+        ["cabinCategoryIds[]", cabinCategoryIds],
+        ["cabinCategoryCodes[]", cabinCategoryCodes],
+        ["cabinGradeCodes[]", cabinGradeCodes],
+        ["cabinRoomTypes[]", cabinRoomTypes],
+        ["cabinFeatureCodes[]", cabinFeatureCodes],
+        ["cabinBedConfigurations[]", cabinBedConfigurations],
+        ["cabinAccessibilityFeatures[]", cabinAccessibilityFeatures],
+        ["cabinViewTypes[]", cabinViewTypes],
+        ["deckIds[]", deckIds],
+        ["deckNames[]", deckNames],
+        ["deckLevels[]", deckLevels],
+    ]);
+}
+export function createCruiseCabinFacetProjectionExtension() {
+    return {
+        name: "cruises:cabin-facets",
+        async project(db, cruiseId, _slice) {
+            const rows = await db
+                .select({
+                cabinCategoryId: cruiseCabinCategories.id,
+                cabinCategoryCode: cruiseCabinCategories.code,
+                roomType: cruiseCabinCategories.roomType,
+                featureCodes: cruiseCabinCategories.featureCodes,
+                bedConfigurations: cruiseCabinCategories.bedConfigurations,
+                accessibilityFeatures: cruiseCabinCategories.accessibilityFeatures,
+                viewType: cruiseCabinCategories.viewType,
+                gradeCodes: cruiseCabinCategories.gradeCodes,
+                deckId: cruiseDecks.id,
+                deckName: cruiseDecks.name,
+                deckLevel: cruiseDecks.level,
+            })
+                .from(cruises)
+                .innerJoin(cruiseCabinCategories, eq(cruiseCabinCategories.shipId, cruises.defaultShipId))
+                .leftJoin(cruiseCabins, eq(cruiseCabins.categoryId, cruiseCabinCategories.id))
+                .leftJoin(cruiseDecks, eq(cruiseCabins.deckId, cruiseDecks.id))
+                .where(eq(cruises.id, cruiseId))
+                .orderBy(asc(cruiseCabinCategories.code), asc(cruiseDecks.level), asc(cruiseDecks.name));
+            return projectCruiseCabinFacetRows(rows);
+        },
+    };
+}
+function pushUnique(values, value) {
+    if (!values.includes(value))
+        values.push(value);
+}

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

@@ -0,0 +1,74 @@
+/**
+ * Catalog-plane integration for the cruises service.
+ *
+ * Mirrors the pattern in `packages/products/src/service-catalog-plane.ts`.
+ * Adds catalog-aware methods alongside the existing service surface.
+ *
+ * See `docs/architecture/catalog-architecture.md` §9.1.
+ */
+import { type CaptureSnapshotInput, type DocumentBuilder, type DocumentEmitter, type FieldPolicy, type FieldPolicyRegistry, type IndexerDocument, type IndexerSlice, type PricingBasis, type Provenance, type ResolvedView, type ResolverScope } from "@voyant-travel/catalog";
+import type { AnyDrizzleDb } from "@voyant-travel/db";
+import { cruises } from "./schema-core.js";
+export interface CruiseProjectionExtension {
+    readonly name: string;
+    project(db: AnyDrizzleDb, cruiseId: string, slice: IndexerSlice): Promise<ReadonlyMap<string, unknown>>;
+}
+export declare function createCruisesRegistry(...extensionPolicies: ReadonlyArray<ReadonlyArray<FieldPolicy>>): FieldPolicyRegistry;
+/**
+ * Maps a cruise row to a field-keyed projection. Provenance is synthesized:
+ * cruises sourced from a line via Voyant Connect would carry their actual
+ * source connection; today's mapper assumes operator-owned cruises (Phase 1
+ * baseline). When sourced cruises land, this helper picks up the parallel
+ * provenance row.
+ */
+export declare function cruiseRowToProjection(row: typeof cruises.$inferSelect, context: {
+    sellerOperatorId: string;
+    sourceKind?: string;
+    sourceRef?: string;
+}): ReadonlyMap<string, unknown>;
+/**
+ * Returns the Provenance tuple for a cruise. Owned cruises synthesize an
+ * `owned` source; sourced cruises (e.g. via Voyant Connect from a cruise
+ * line) carry the actual connection identity from their parallel provenance
+ * row.
+ */
+export declare function cruiseProvenance(_row: typeof cruises.$inferSelect, context: {
+    sellerOperatorId: string;
+    sourceKind?: string;
+    sourceRef?: string;
+}): Provenance;
+export interface CruiseCatalogContext {
+    sellerOperatorId: string;
+    scope: ResolverScope;
+    /** When the cruise comes from an upstream source, populate these. */
+    sourceKind?: string;
+    sourceRef?: string;
+}
+export declare function getResolvedCruiseById(db: AnyDrizzleDb, id: string, context: CruiseCatalogContext): Promise<ResolvedView | null>;
+export declare function listResolvedCruises(db: AnyDrizzleDb, rows: ReadonlyArray<typeof cruises.$inferSelect>, context: CruiseCatalogContext): Promise<ResolvedView[]>;
+/**
+ * Build a `CaptureSnapshotInput` for a cruise. Fetches the cruise, resolves
+ * its view, and returns the snapshot input shape ready to pass into
+ * `captureSnapshot` or `captureSnapshotGraph`.
+ *
+ * Sourced cruises (Voyant Connect from a cruise line) carry their actual
+ * source kind / ref through the context.
+ */
+export declare function buildCruiseSnapshotInput(db: AnyDrizzleDb, cruiseId: string, context: CruiseCatalogContext & {
+    pricingBasis?: PricingBasis;
+}): Promise<Omit<CaptureSnapshotInput, "bookingId"> | null>;
+export declare function createCruiseDocumentEmitter(context: {
+    sellerOperatorId: string;
+    sourceKind?: string;
+    sourceRef?: string;
+    registry?: FieldPolicyRegistry;
+}): DocumentEmitter<typeof cruises.$inferSelect>;
+export declare function createCruiseDocumentBuilder(db: AnyDrizzleDb, context: {
+    sellerOperatorId: string;
+    sourceKind?: string;
+    sourceRef?: string;
+    extensions?: ReadonlyArray<CruiseProjectionExtension>;
+    registry?: FieldPolicyRegistry;
+}): 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":"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"}

package/dist/service-catalog-plane.js

@@ -0,0 +1,194 @@
+/**
+ * Catalog-plane integration for the cruises service.
+ *
+ * Mirrors the pattern in `packages/products/src/service-catalog-plane.ts`.
+ * Adds catalog-aware methods alongside the existing service surface.
+ *
+ * See `docs/architecture/catalog-architecture.md` §9.1.
+ */
+import { buildIndexerDocument, buildSnapshotInputFromView, createFieldPolicyRegistry, resolveEntityView, } from "@voyant-travel/catalog";
+import { eq } from "drizzle-orm";
+import { cruiseCatalogPolicy } from "./catalog-policy.js";
+import { cruises } from "./schema-core.js";
+let _registry;
+function getCruisesRegistry() {
+    if (!_registry) {
+        _registry = createFieldPolicyRegistry(cruiseCatalogPolicy);
+    }
+    return _registry;
+}
+export function createCruisesRegistry(...extensionPolicies) {
+    if (extensionPolicies.length === 0)
+        return getCruisesRegistry();
+    const composed = [...cruiseCatalogPolicy];
+    for (const policies of extensionPolicies) {
+        composed.push(...policies);
+    }
+    return createFieldPolicyRegistry(composed);
+}
+/**
+ * Maps a cruise row to a field-keyed projection. Provenance is synthesized:
+ * cruises sourced from a line via Voyant Connect would carry their actual
+ * source connection; today's mapper assumes operator-owned cruises (Phase 1
+ * baseline). When sourced cruises land, this helper picks up the parallel
+ * provenance row.
+ */
+export function cruiseRowToProjection(row, context) {
+    return new Map([
+        // Provenance
+        ["source.kind", context.sourceKind ?? "owned"],
+        ["source.ref", context.sourceRef],
+        ["seller.operator_id", context.sellerOperatorId],
+        // Identity
+        ["id", row.id],
+        ["slug", row.slug],
+        ["createdAt", row.createdAt],
+        ["updatedAt", row.updatedAt],
+        ["externalRefs", row.externalRefs],
+        // Merchandisable
+        ["name", row.name],
+        ["description", row.description],
+        ["shortDescription", row.shortDescription],
+        ["highlights", row.highlights],
+        ["inclusionsHtml", row.inclusionsHtml],
+        ["exclusionsHtml", row.exclusionsHtml],
+        ["heroImageUrl", row.heroImageUrl],
+        ["thumbnailUrl", row.heroImageUrl],
+        ["mapImageUrl", row.mapImageUrl],
+        // Structural
+        ["cruiseType", row.cruiseType],
+        ["status", row.status],
+        ["lineSupplierId", row.lineSupplierId],
+        ["defaultShipId", row.defaultShipId],
+        ["nights", row.nights],
+        ["embarkPortFacilityId", row.embarkPortFacilityId],
+        ["embarkPortCanonicalPlaceId", row.embarkPortCanonicalPlaceId],
+        ["disembarkPortFacilityId", row.disembarkPortFacilityId],
+        ["disembarkPortCanonicalPlaceId", row.disembarkPortCanonicalPlaceId],
+        ["region_ids[]", row.regionIds],
+        ["waterway_ids[]", row.waterwayIds],
+        ["port_ids[]", row.portIds],
+        ["country_iso[]", row.countryIso],
+        ["regions[]", row.regions],
+        ["waterways[]", row.waterways],
+        ["ports[]", row.ports],
+        ["countries[]", row.countries],
+        ["themes[]", row.themes],
+        // Volatile-indexed (browse-time approximations)
+        ["lowestPriceCached", moneyStringToCents(row.lowestPriceCached)],
+        ["lowestPriceCurrencyCached", row.lowestPriceCurrencyCached],
+        ["lowestPriceUnit", "minor"],
+        ["earliestDepartureCached", row.earliestDepartureCached],
+        ["latestDepartureCached", row.latestDepartureCached],
+    ]);
+}
+function moneyStringToCents(value) {
+    if (!value)
+        return null;
+    const major = Number.parseFloat(value);
+    if (!Number.isFinite(major))
+        return null;
+    return Math.round(major * 100);
+}
+/**
+ * Returns the Provenance tuple for a cruise. Owned cruises synthesize an
+ * `owned` source; sourced cruises (e.g. via Voyant Connect from a cruise
+ * line) carry the actual connection identity from their parallel provenance
+ * row.
+ */
+export function cruiseProvenance(_row, context) {
+    return {
+        source_kind: context.sourceKind ?? "owned",
+        source_freshness: context.sourceKind && context.sourceKind !== "owned" ? "sync" : "static",
+        source_ref: context.sourceRef,
+    };
+}
+export async function getResolvedCruiseById(db, id, context) {
+    const rows = await db.select().from(cruises).where(eq(cruises.id, id)).limit(1);
+    const row = rows[0];
+    if (!row)
+        return null;
+    const projection = cruiseRowToProjection(row, {
+        sellerOperatorId: context.sellerOperatorId,
+        sourceKind: context.sourceKind,
+        sourceRef: context.sourceRef,
+    });
+    return resolveEntityView(db, getCruisesRegistry(), "cruises", id, projection, context.scope);
+}
+export async function listResolvedCruises(db, rows, context) {
+    const registry = getCruisesRegistry();
+    const views = [];
+    for (const row of rows) {
+        const projection = cruiseRowToProjection(row, {
+            sellerOperatorId: context.sellerOperatorId,
+            sourceKind: context.sourceKind,
+            sourceRef: context.sourceRef,
+        });
+        const view = await resolveEntityView(db, registry, "cruises", row.id, projection, context.scope);
+        views.push(view);
+    }
+    return views;
+}
+/**
+ * Build a `CaptureSnapshotInput` for a cruise. Fetches the cruise, resolves
+ * its view, and returns the snapshot input shape ready to pass into
+ * `captureSnapshot` or `captureSnapshotGraph`.
+ *
+ * Sourced cruises (Voyant Connect from a cruise line) carry their actual
+ * source kind / ref through the context.
+ */
+export async function buildCruiseSnapshotInput(db, cruiseId, context) {
+    const view = await getResolvedCruiseById(db, cruiseId, context);
+    if (!view)
+        return null;
+    return buildSnapshotInputFromView(view, {
+        entityModule: "cruises",
+        entityId: cruiseId,
+        sourceKind: context.sourceKind ?? "owned",
+        sourceRef: context.sourceRef,
+        pricingBasis: context.pricingBasis,
+    });
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Indexer document emission
+// ─────────────────────────────────────────────────────────────────────────────
+export function createCruiseDocumentEmitter(context) {
+    const registry = context.registry ?? getCruisesRegistry();
+    return {
+        vertical: "cruises",
+        emit(source, slice) {
+            const projection = cruiseRowToProjection(source, {
+                sellerOperatorId: context.sellerOperatorId,
+                sourceKind: context.sourceKind,
+                sourceRef: context.sourceRef,
+            });
+            return buildIndexerDocument(registry, projection, slice, source.id);
+        },
+    };
+}
+export function createCruiseDocumentBuilder(db, context) {
+    const registry = context.registry ?? getCruisesRegistry();
+    const extensions = context.extensions ?? [];
+    const emitter = createCruiseDocumentEmitter({ ...context, registry });
+    return async (entityId, slice) => {
+        const rows = await db.select().from(cruises).where(eq(cruises.id, entityId)).limit(1);
+        const row = rows[0];
+        if (!row)
+            return null;
+        if (extensions.length === 0)
+            return emitter.emit(row, slice);
+        const baseProjection = cruiseRowToProjection(row, {
+            sellerOperatorId: context.sellerOperatorId,
+            sourceKind: context.sourceKind,
+            sourceRef: context.sourceRef,
+        });
+        const extensionProjections = await Promise.all(extensions.map((ext) => ext.project(db, entityId, slice)));
+        const merged = new Map(baseProjection);
+        for (const projection of extensionProjections) {
+            for (const [path, value] of projection) {
+                merged.set(path, value);
+            }
+        }
+        return buildIndexerDocument(registry, merged, slice, entityId);
+    };
+}

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

@@ -0,0 +1,42 @@
+/**
+ * Cruise content synthesizer — fallback for thin adapters that declare
+ * `supportsContentFetch: false`.
+ *
+ * Produces the most complete `CruiseContent` blob we can legitimately
+ * synthesize from the durable sourced-entry projection + locale-aware
+ * overlays + plane-level provenance. Fields the projection doesn't
+ * carry render as typed empty states (`sailings: []`,
+ * `cabin_categories: []`).
+ *
+ * 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 CruiseContent } from "./content-shape.js";
+export interface SynthesizeCruiseContentOptions {
+    provenance: Extract<ProvenanceReadResult, {
+        kind: "sourced";
+    }>;
+    overlays?: ReadonlyArray<{
+        field_path: string;
+        value: unknown;
+    }>;
+}
+export interface SynthesizedCruiseContent {
+    content: CruiseContent;
+    content_schema_version: string;
+    served_locale: string;
+    source_kind: string;
+    source_provider?: string;
+}
+export declare function synthesizeCruiseContent(scope: {
+    locale: string;
+}, options: SynthesizeCruiseContentOptions): SynthesizedCruiseContent;
+export declare function synthesizeCruiseContentFromDb(db: AnyDrizzleDb, scope: {
+    locale: string;
+}, provenance: Extract<ProvenanceReadResult, {
+    kind: "sourced";
+}>): Promise<SynthesizedCruiseContent>;
+//# 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;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,oBAAoB,CAAA;AAE3B,MAAM,WAAW,8BAA8B;IAC7C,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,wBAAwB;IACvC,OAAO,EAAE,aAAa,CAAA;IACtB,sBAAsB,EAAE,MAAM,CAAA;IAC9B,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EACzB,OAAO,EAAE,8BAA8B,GACtC,wBAAwB,CAoC1B;AAED,wBAAsB,6BAA6B,CACjD,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,wBAAwB,CAAC,CAOnC"}

package/dist/service-content-synthesizer.js

@@ -0,0 +1,144 @@
+/**
+ * Cruise content synthesizer — fallback for thin adapters that declare
+ * `supportsContentFetch: false`.
+ *
+ * Produces the most complete `CruiseContent` blob we can legitimately
+ * synthesize from the durable sourced-entry projection + locale-aware
+ * overlays + plane-level provenance. Fields the projection doesn't
+ * carry render as typed empty states (`sailings: []`,
+ * `cabin_categories: []`).
+ *
+ * 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 { CRUISES_CONTENT_SCHEMA_VERSION, cruiseContentSchema, } from "./content-shape.js";
+export function synthesizeCruiseContent(scope, options) {
+    const projection = options.provenance.projection;
+    const cruise = pickCruiseSummary(projection, options.provenance);
+    const ship = pickShip(projection);
+    const itinerary = pickItineraryStops(projection);
+    const policies = pickPolicies(projection);
+    const baseContent = {
+        cruise,
+        ship,
+        sailings: [],
+        cabin_categories: [],
+        itinerary_stops: itinerary,
+        policies,
+    };
+    let merged = baseContent;
+    if (options.overlays && options.overlays.length > 0) {
+        const result = mergeOverlaysIntoContent(baseContent, options.overlays, {
+            validate(p) {
+                const r = cruiseContentSchema.safeParse(p);
+                return r.success
+                    ? { valid: true }
+                    : { valid: false, reason: r.error.issues[0]?.message ?? "invalid" };
+            },
+        });
+        merged = cruiseContentSchema.parse(result);
+    }
+    return {
+        content: merged,
+        content_schema_version: CRUISES_CONTENT_SCHEMA_VERSION,
+        served_locale: scope.locale,
+        source_kind: options.provenance.provenance.source_kind,
+        source_provider: options.provenance.provenance.source_provider,
+    };
+}
+export async function synthesizeCruiseContentFromDb(db, scope, provenance) {
+    const entityId = entityIdFromProvenance(provenance);
+    const overlays = await fetchOverlaysForEntity(db, "cruises", entityId);
+    return synthesizeCruiseContent(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 pickCruiseSummary(projection, provenance) {
+    return {
+        id: stringOr(projection.id, "") || provenance.entry_id,
+        name: stringOr(projection.name, "") || stringOr(projection.title, "") || "Unnamed cruise",
+        status: stringOr(projection.status, undefined),
+        description: stringOr(projection.description, null),
+        cruise_type: stringOr(projection.cruise_type, null),
+        hero_image_url: stringOr(projection.hero_image_url, null),
+        highlights: stringArrayOr(projection.highlights, []),
+        cruise_line: stringOr(projection.cruise_line, null) ??
+            stringOr(projection.line_name, null) ??
+            provenance.provenance.source_provider ??
+            null,
+        duration_nights: numberOr(projection.duration_nights, null),
+        embarkation_port: stringOr(projection.embarkation_port, null),
+        disembarkation_port: stringOr(projection.disembarkation_port, null),
+    };
+}
+function pickShip(projection) {
+    const shipName = stringOr(projection.ship_name, null) ?? stringOr(projection.ship, null);
+    if (!shipName)
+        return null;
+    return {
+        name: shipName,
+        description: stringOr(projection.ship_description, null),
+        deck_plan_url: stringOr(projection.ship_deck_plan_url, null),
+        deck_plans: [],
+        capacity: numberOr(projection.ship_capacity, null),
+        decks: numberOr(projection.ship_decks, null),
+        gallery: [],
+    };
+}
+function pickItineraryStops(projection) {
+    const stops = projection.itinerary;
+    if (!Array.isArray(stops))
+        return [];
+    const result = [];
+    for (const item of stops) {
+        if (!item || typeof item !== "object")
+            continue;
+        const obj = item;
+        const portName = stringOr(obj.port_name, null) ?? stringOr(obj.port, null);
+        const dayNumber = numberOr(obj.day_number, null) ?? numberOr(obj.day, null);
+        if (!portName || dayNumber === null || dayNumber <= 0)
+            continue;
+        result.push({
+            day_number: dayNumber,
+            date: stringOr(obj.date, null),
+            port_name: portName,
+            arrival_time: stringOr(obj.arrival_time, null),
+            departure_time: stringOr(obj.departure_time, null),
+            description: stringOr(obj.description, null),
+            is_at_sea: typeof obj.is_at_sea === "boolean" ? obj.is_at_sea : false,
+        });
+    }
+    return result;
+}
+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 });
+    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,74 @@
+/**
+ * Cruise content service — `getCruiseContent` with locale-resolved
+ * cache reads, SWR refresh, and synthesizer fallback.
+ *
+ * Mirrors `service-content.ts` in the products package but cruise-
+ * shaped. The cruise content aggregate (§3.2 / §E) is `{ cruise, ship,
+ * sailings[], cabin_categories[], itinerary_stops[], policies[] }` —
+ * one payload returned by a single getContent. The cruise adapter's
+ * existing internal multi-method API
+ * (`fetchCruise/fetchSailing/fetchShip/fetchItinerary`) composes
+ * internally to produce this blob; the public catalog SourceAdapter
+ * contract gets one method, not five.
+ *
+ * See `docs/architecture/catalog-sourced-content.md` §3.3, §3.4, §3.6.
+ */
+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 CruiseContent } from "./content-shape.js";
+export interface CruiseContentScope {
+    preferredLocales: ReadonlyArray<string>;
+    market?: string;
+    currency?: string;
+    acceptMachineTranslated?: boolean;
+}
+export interface GetCruiseContentOptions {
+    registry: SourceAdapterRegistry;
+    buildAdapterContext?: (adapter: SourceAdapter) => SourceAdapterContext;
+    onOverlayError?: (event: {
+        field_path: string;
+        reason: string;
+    }) => void;
+}
+export interface ResolvedCruiseContent {
+    content: CruiseContent;
+    resolution: ContentLocaleResolution<{
+        locale: string;
+        payload: CruiseContent;
+    }>;
+    source: "sourced-cache" | "sourced-fresh" | "synthesized";
+    served_stale: boolean;
+    synthesized: boolean;
+    machine_translated: boolean;
+}
+export declare function getCruiseContent(db: AnyDrizzleDb, entityId: string, scope: CruiseContentScope, options: GetCruiseContentOptions): Promise<ResolvedCruiseContent | null>;
+export interface CruiseSailingPricingRow {
+    /** Upstream cabin-category external id (e.g. `<ship>_<grade>`). */
+    cabinExternalId: string;
+    occupancy: number;
+    fareCode: string | null;
+    fareName: string | null;
+    currency: string;
+    /** Major-unit price string as the adapter returns it (e.g. "12959.00"). */
+    pricePerPerson: string;
+    availability: string;
+}
+/**
+ * Live per-sailing cabin pricing for a sourced cruise. Pricing is volatile-live
+ * (architecture §5.4) so it is fetched fresh from the adapter per call rather
+ * than baked into the cached content — the catalog detail sheet calls this
+ * lazily when a departure row is expanded.
+ *
+ * Returns `null` when the entity has no sourced row or the registered adapter
+ * can't price sailings (e.g. a thin adapter without `fetchSailingPricing`).
+ */
+export declare function getCruiseSailingPricing(db: AnyDrizzleDb, entityId: string, sailingExternalId: string, options: {
+    registry: SourceAdapterRegistry;
+}): Promise<CruiseSailingPricingRow[] | null>;
+/**
+ * Drift event consumer for the cruises content cache. Per sourced-
+ * content §3.4.1.
+ */
+export declare const invalidateCruiseContentOnDrift: 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,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAA;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAKrD,OAAO,EAEL,KAAK,aAAa,EAInB,MAAM,oBAAoB,CAAA;AAa3B,MAAM,WAAW,kBAAkB;IACjC,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,uBAAuB;IACtC,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,qBAAqB;IACpC,OAAO,EAAE,aAAa,CAAA;IACtB,UAAU,EAAE,uBAAuB,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,aAAa,CAAA;KAAE,CAAC,CAAA;IAC/E,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,gBAAgB,CACpC,EAAE,EAAE,YAAY,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CA2GvC;AAED,MAAM,WAAW,uBAAuB;IACtC,mEAAmE;IACnE,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,2EAA2E;IAC3E,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,YAAY,EAChB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,EACzB,OAAO,EAAE;IAAE,QAAQ,EAAE,qBAAqB,CAAA;CAAE,GAC3C,OAAO,CAAC,uBAAuB,EAAE,GAAG,IAAI,CAAC,CA6B3C;AA0OD;;;GAGG;AACH,eAAO,MAAM,8BAA8B,EAAE,iBAG5C,CAAA"}