@voyant-travel/cruises 0.118.2

package/dist/routes-booking-payloads.js

@@ -0,0 +1,142 @@
+import { z } from "zod";
+import { encodeSourceRef } from "./lib/key.js";
+export const createBookingPayloadSchema = z.object({
+    sailingId: z.string(),
+    cabinCategoryId: z.string(),
+    cabinCategoryRef: z.record(z.string(), z.unknown()).optional().nullable(),
+    cabinId: z.string().optional().nullable(),
+    occupancy: z.number().int().min(1).max(8),
+    passengerComposition: passengerCompositionSchema().optional().nullable(),
+    fareCode: z.string().optional().nullable(),
+    fareVariant: z.enum(["cruise_only", "air_inclusive"]).optional().nullable(),
+    mode: z.enum(["inquiry", "reserve"]).optional(),
+    personId: z.string().optional().nullable(),
+    organizationId: z.string().optional().nullable(),
+    contact: z.object({
+        firstName: z.string().min(1),
+        lastName: z.string().min(1),
+        email: z.string().email().optional().nullable(),
+        phone: z.string().optional().nullable(),
+        language: z.string().optional().nullable(),
+        country: z.string().optional().nullable(),
+        region: z.string().optional().nullable(),
+        city: z.string().optional().nullable(),
+        address: z.string().optional().nullable(),
+        postalCode: z.string().optional().nullable(),
+    }),
+    passengers: z
+        .array(z.object({
+        firstName: z.string().min(1),
+        lastName: z.string().min(1),
+        email: z.string().email().optional().nullable(),
+        phone: z.string().optional().nullable(),
+        travelerCategory: z
+            .enum(["adult", "child", "infant", "senior", "other"])
+            .optional()
+            .nullable(),
+        preferredLanguage: z.string().optional().nullable(),
+        specialRequests: z.string().optional().nullable(),
+        personId: z.string().optional().nullable(),
+        isPrimary: z.boolean().optional(),
+        notes: z.string().optional().nullable(),
+    }))
+        .min(1),
+    notes: z.string().optional().nullable(),
+});
+export const createPartyBookingPayloadSchema = z.object({
+    sailingId: z.string(),
+    cabins: z
+        .array(z.object({
+        cabinCategoryId: z.string(),
+        cabinId: z.string().optional().nullable(),
+        occupancy: z.number().int().min(1).max(8),
+        fareCode: z.string().optional().nullable(),
+        fareVariant: z.enum(["cruise_only", "air_inclusive"]).optional().nullable(),
+        passengers: z
+            .array(z.object({
+            firstName: z.string().min(1),
+            lastName: z.string().min(1),
+            email: z.string().email().optional().nullable(),
+            phone: z.string().optional().nullable(),
+            travelerCategory: z
+                .enum(["adult", "child", "infant", "senior", "other"])
+                .optional()
+                .nullable(),
+            preferredLanguage: z.string().optional().nullable(),
+            specialRequests: z.string().optional().nullable(),
+            personId: z.string().optional().nullable(),
+            isPrimary: z.boolean().optional(),
+            notes: z.string().optional().nullable(),
+        }))
+            .min(1),
+        notes: z.string().optional().nullable(),
+    }))
+        .min(2)
+        .max(20),
+    leadPersonId: z.string().optional().nullable(),
+    organizationId: z.string().optional().nullable(),
+    contact: z.object({
+        firstName: z.string().min(1),
+        lastName: z.string().min(1),
+        email: z.string().email().optional().nullable(),
+        phone: z.string().optional().nullable(),
+        language: z.string().optional().nullable(),
+        country: z.string().optional().nullable(),
+        region: z.string().optional().nullable(),
+        city: z.string().optional().nullable(),
+        address: z.string().optional().nullable(),
+        postalCode: z.string().optional().nullable(),
+    }),
+    mode: z.enum(["inquiry", "reserve"]).optional(),
+    label: z.string().optional(),
+    notes: z.string().optional().nullable(),
+});
+export const quotePayloadSchema = z.object({
+    cabinCategoryId: z.string(),
+    cabinCategoryRef: z.record(z.string(), z.unknown()).optional().nullable(),
+    occupancy: z.number().int().min(1).max(8),
+    guestCount: z.number().int().min(1).max(8).optional(),
+    passengerComposition: passengerCompositionSchema().optional().nullable(),
+    fareCode: z.string().optional().nullable(),
+    fareVariant: z.enum(["cruise_only", "air_inclusive"]).optional().nullable(),
+});
+function passengerCompositionSchema() {
+    return z
+        .object({
+        adults: z.number().int().min(0),
+        children: z.number().int().min(0).optional(),
+        childAges: z.array(z.number().int().min(0).max(17)).optional(),
+        infants: z.number().int().min(0).optional(),
+        seniors: z.number().int().min(0).optional(),
+    })
+        .catchall(z.unknown())
+        .refine((value) => value.adults + (value.children ?? 0) + (value.infants ?? 0) + (value.seniors ?? 0) > 0, "passengerComposition must include at least one passenger");
+}
+export function passengerCountFromComposition(composition) {
+    if (!composition)
+        return null;
+    return (composition.adults +
+        (composition.children ?? 0) +
+        (composition.infants ?? 0) +
+        (composition.seniors ?? 0));
+}
+export function sourceRefFromPayload(maybeRef, externalId) {
+    if (maybeRef && typeof maybeRef.externalId === "string")
+        return maybeRef;
+    return { externalId };
+}
+export function sourceRefMatches(candidate, requested) {
+    if (encodeSourceRef(candidate) === encodeSourceRef(requested))
+        return true;
+    const candidateIsLegacy = Object.keys(candidate).length === 1;
+    const requestedIsLegacy = Object.keys(requested).length === 1;
+    return (candidateIsLegacy || requestedIsLegacy) && candidate.externalId === requested.externalId;
+}
+export function passengerCompositionMatches(candidate, requested) {
+    if (!requested || !candidate)
+        return true;
+    return (encodeSourceRef({
+        externalId: "composition",
+        ...candidate,
+    }) === encodeSourceRef({ externalId: "composition", ...requested }));
+}

package/dist/routes-content.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Cruise content routes — sourced-aware detail endpoint.
+ *
+ *   GET /:key/content
+ *
+ * Returns the full `CruiseContent` payload for a sourced cruise:
+ * cache hit → cached row + overlay merge; cache miss with rich adapter
+ * → adapter fetch + write-through; cache miss with thin adapter →
+ * synthesizer fallback (sourced-content §3.3, §3.4, §3.6).
+ *
+ * The cruise vertical's unified key parser (`<provider>:<ref>` for
+ * external, plain TypeID for owned) is reused; this route accepts
+ * either form. Owned cruises return 404 — they have no sourced-entry
+ * row. Owned-cruise detail uses the existing `/:key` route.
+ *
+ * The catalog SourceAdapterRegistry is starter-owned and resolved via
+ * the `resolveRegistry` callback. For cruise adapters wrapped via
+ * `cruiseAdapterToSourceAdapter`, registry registration alongside the
+ * cruise vertical's per-vertical registry enables both detail surfaces
+ * (`/:key` for ad-hoc fetchCruise + `/:key/content` for cached
+ * CruiseContent) without code duplication.
+ *
+ * See `docs/architecture/catalog-sourced-content.md` §3.3.
+ */
+import type { SourceAdapterRegistry } from "@voyant-travel/catalog/booking-engine";
+import type { AnyDrizzleDb } from "@voyant-travel/db";
+import type { Context } from "hono";
+import { Hono } from "hono";
+export interface CruiseContentRoutesEnv {
+    Variables: {
+        db: AnyDrizzleDb;
+    };
+}
+export interface CreateCruiseContentRoutesOptions {
+    resolveRegistry: (c: Context) => SourceAdapterRegistry;
+    onOverlayError?: (event: {
+        field_path: string;
+        reason: string;
+    }) => void;
+    defaultAcceptMachineTranslated?: boolean;
+    /**
+     * When the unified key resolves to a cruise typeid (`crus_*` —
+     * owned cruise), the route returns 404 by default. Set this to
+     * `true` to also dispatch through `getCruiseContent` for owned ids
+     * (useful when an owned cruise also has a sourced-entry row, e.g.
+     * after a detach + re-import workflow).
+     */
+    allowOwnedKeys?: boolean;
+}
+export declare function createCruiseContentRoutes(options: CreateCruiseContentRoutesOptions): Hono<CruiseContentRoutesEnv>;
+export declare function parseAcceptLanguage(header: string): string[];
+export type CruiseContentRoutes = ReturnType<typeof createCruiseContentRoutes>;
+//# sourceMappingURL=routes-content.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes-content.d.ts","sourceRoot":"","sources":["../src/routes-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAA;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAc3B,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE;QACT,EAAE,EAAE,YAAY,CAAA;KACjB,CAAA;CACF;AAED,MAAM,WAAW,gCAAgC;IAC/C,eAAe,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,qBAAqB,CAAA;IACtD,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IACxE,8BAA8B,CAAC,EAAE,OAAO,CAAA;IACxC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gCAAgC,GACxC,IAAI,CAAC,sBAAsB,CAAC,CA4H9B;AAaD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAqB5D;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAA"}

package/dist/routes-content.js

@@ -0,0 +1,158 @@
+/**
+ * Cruise content routes — sourced-aware detail endpoint.
+ *
+ *   GET /:key/content
+ *
+ * Returns the full `CruiseContent` payload for a sourced cruise:
+ * cache hit → cached row + overlay merge; cache miss with rich adapter
+ * → adapter fetch + write-through; cache miss with thin adapter →
+ * synthesizer fallback (sourced-content §3.3, §3.4, §3.6).
+ *
+ * The cruise vertical's unified key parser (`<provider>:<ref>` for
+ * external, plain TypeID for owned) is reused; this route accepts
+ * either form. Owned cruises return 404 — they have no sourced-entry
+ * row. Owned-cruise detail uses the existing `/:key` route.
+ *
+ * The catalog SourceAdapterRegistry is starter-owned and resolved via
+ * the `resolveRegistry` callback. For cruise adapters wrapped via
+ * `cruiseAdapterToSourceAdapter`, registry registration alongside the
+ * cruise vertical's per-vertical registry enables both detail surfaces
+ * (`/:key` for ad-hoc fetchCruise + `/:key/content` for cached
+ * CruiseContent) without code duplication.
+ *
+ * See `docs/architecture/catalog-sourced-content.md` §3.3.
+ */
+import { Hono } from "hono";
+import { encodeSourceRef, isEncodedSourceEntityId, parseUnifiedKey, sourceRefFromExternalKeyRef, } from "./lib/key.js";
+import { getCruiseContent, getCruiseSailingPricing, } from "./service-content.js";
+export function createCruiseContentRoutes(options) {
+    return new Hono()
+        .get("/:key/content", async (c) => {
+        const rawKey = c.req.param("key");
+        const parsed = parseUnifiedKey(rawKey);
+        if (parsed.kind === "invalid") {
+            return c.json({
+                error: "invalid_key",
+                detail: `Unrecognized cruise key: ${parsed.raw}`,
+            }, 400);
+        }
+        // A catalog sourced entity id (`crus_sr_<base64>`) is inherently sourced,
+        // so it dispatches regardless of `allowOwnedKeys`. Only plain owned TypeIDs
+        // (`crus_<base32>`) need the opt-in.
+        const isSourcedEntityId = parsed.kind === "local" && isEncodedSourceEntityId(parsed.id);
+        if (parsed.kind === "local" && !isSourcedEntityId && !options.allowOwnedKeys) {
+            return c.json({
+                error: "owned_not_supported",
+                detail: "GET /:key/content serves sourced cruises only. Owned cruises use GET /:key. Set allowOwnedKeys: true on the route factory to opt into owned dispatch.",
+            }, 404);
+        }
+        // For external keys we resolve through the catalog sourced-entry
+        // store via service-content. The cruise adapter must be registered
+        // against the catalog SourceAdapterRegistry (typically via
+        // cruiseAdapterToSourceAdapter) for this to find a row.
+        const entityId = parsed.kind === "local" ? parsed.id : entityIdFromExternal(parsed);
+        const scope = parseScope(c);
+        const registry = options.resolveRegistry(c);
+        const result = await getCruiseContent(c.var.db, entityId, scope, {
+            registry,
+            onOverlayError: options.onOverlayError,
+        });
+        if (!result) {
+            return c.json({
+                error: "not_found",
+                detail: `Cruise ${rawKey} (entity ${entityId}) has no sourced-content row. Either no adapter is registered for this provider, or discovery hasn't run yet.`,
+            }, 404);
+        }
+        return c.json({
+            data: {
+                content: result.content,
+                served_locale: result.resolution.served_locale,
+                match_kind: result.resolution.match_kind,
+                source: result.source,
+                served_stale: result.served_stale,
+                synthesized: result.synthesized,
+                machine_translated: result.machine_translated,
+            },
+        });
+    })
+        .get("/:key/sailings/:sailingExternalId/pricing", async (c) => {
+        // Live per-sailing cabin pricing for the detail sheet's Departures tab.
+        // Fetched fresh from the adapter (price is volatile-live), not cached.
+        const rawKey = c.req.param("key");
+        const parsed = parseUnifiedKey(rawKey);
+        if (parsed.kind === "invalid") {
+            return c.json({ error: "invalid_key", detail: `Unrecognized cruise key: ${parsed.raw}` }, 400);
+        }
+        const isSourcedEntityId = parsed.kind === "local" && isEncodedSourceEntityId(parsed.id);
+        if (parsed.kind === "local" && !isSourcedEntityId && !options.allowOwnedKeys) {
+            return c.json({ error: "owned_not_supported", detail: "Sourced cruises only." }, 404);
+        }
+        const entityId = parsed.kind === "local" ? parsed.id : entityIdFromExternal(parsed);
+        const sailingExternalId = c.req.param("sailingExternalId");
+        const pricing = await getCruiseSailingPricing(c.var.db, entityId, sailingExternalId, {
+            registry: options.resolveRegistry(c),
+        });
+        if (pricing == null) {
+            return c.json({
+                error: "not_found",
+                detail: `No pricing for sailing ${sailingExternalId} on cruise ${rawKey} (no sourced row or adapter can't price sailings).`,
+            }, 404);
+        }
+        return c.json({ data: { pricing } });
+    });
+    function parseScope(c) {
+        const localeParams = c.req.queries("locale") ?? c.req.queries("locales") ?? [];
+        const headerLocale = c.req.header("accept-language");
+        const acceptLanguageList = headerLocale ? parseAcceptLanguage(headerLocale) : [];
+        const preferredLocales = localeParams.length > 0
+            ? localeParams
+            : acceptLanguageList.length > 0
+                ? acceptLanguageList
+                : ["en-GB"];
+        const market = c.req.query("market") ?? undefined;
+        const currency = c.req.query("currency") ?? undefined;
+        const acceptMTQuery = c.req.query("accept_mt");
+        const acceptMachineTranslated = acceptMTQuery != null
+            ? acceptMTQuery !== "false" && acceptMTQuery !== "0"
+            : (options.defaultAcceptMachineTranslated ?? true);
+        return {
+            preferredLocales,
+            market,
+            currency,
+            acceptMachineTranslated,
+        };
+    }
+}
+/**
+ * Translate a parsed external key (`<provider>:<ref>`) into the catalog-side
+ * entity_id. Mirrors the default `buildEntityId` from
+ * `cruiseAdapterToSourceAdapter`: `crus_<encoded SourceRef>`.
+ */
+function entityIdFromExternal(parsed) {
+    return `crus_${encodeSourceRef(sourceRefFromExternalKeyRef(parsed.ref))}`;
+}
+export function parseAcceptLanguage(header) {
+    const parts = header.split(",");
+    const ranked = [];
+    for (let i = 0; i < parts.length; i += 1) {
+        const part = parts[i].trim();
+        if (!part)
+            continue;
+        const [tagRaw, ...params] = part.split(";");
+        const tag = tagRaw.trim();
+        if (!tag || tag === "*")
+            continue;
+        let q = 1;
+        for (const p of params) {
+            const [k, v] = p.split("=").map((s) => s.trim());
+            if (k === "q" && v) {
+                const parsed = Number.parseFloat(v);
+                if (Number.isFinite(parsed))
+                    q = parsed;
+            }
+        }
+        ranked.push({ tag, q, idx: i });
+    }
+    ranked.sort((a, b) => b.q - a.q || a.idx - b.idx);
+    return ranked.map((r) => r.tag);
+}

package/dist/routes-core.d.ts

@@ -0,0 +1,4 @@
+import type { Hono } from "hono";
+import type { CruiseRoutesEnv as Env } from "./routes-env.js";
+export declare function registerCruiseCoreRoutes(app: Hono<Env>): void;
+//# sourceMappingURL=routes-core.d.ts.map

package/dist/routes-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes-core.d.ts","sourceRoot":"","sources":["../src/routes-core.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAIhC,OAAO,KAAK,EAAE,eAAe,IAAI,GAAG,EAAE,MAAM,iBAAiB,CAAA;AAK7D,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,QAwEtD"}

package/dist/routes-core.js

@@ -0,0 +1,68 @@
+import { parseJsonBody, parseQuery } from "@voyant-travel/hono";
+import { listCruiseAdapters } from "./adapters/registry.js";
+import { makeExternalKey } from "./routes-keying.js";
+import { cruisesService } from "./service.js";
+import { cruiseListQuerySchema, insertCruiseSchema } from "./validation-core.js";
+export function registerCruiseCoreRoutes(app) {
+    app
+        // --- list / unified detail ---
+        .get("/", async (c) => {
+        const query = parseQuery(c, cruiseListQuerySchema);
+        const local = await cruisesService.listCruises(c.get("db"), query);
+        const localItems = local.data.map((c) => ({
+            source: "local",
+            sourceProvider: null,
+            sourceRef: null,
+            key: c.id,
+            cruise: c,
+        }));
+        // Fan out to every registered adapter in parallel via Promise.allSettled —
+        // one slow or failing adapter doesn't block the rest. Each adapter's call
+        // is independent so there's no concurrency-control concern at this layer
+        // (adapters that need rate limiting handle it inside their own implementation).
+        const adapters = listCruiseAdapters();
+        const settled = await Promise.allSettled(adapters.map((adapter) => adapter
+            .listEntries({ limit: query.limit })
+            .then((result) => ({ adapter, result }))));
+        const adapterItems = [];
+        const adapterErrors = [];
+        for (let i = 0; i < settled.length; i++) {
+            const outcome = settled[i];
+            const adapter = adapters[i];
+            if (!outcome || !adapter)
+                continue;
+            if (outcome.status === "rejected") {
+                adapterErrors.push({
+                    adapter: adapter.name,
+                    error: outcome.reason instanceof Error ? outcome.reason.message : String(outcome.reason),
+                });
+                continue;
+            }
+            for (const entry of outcome.value.result.entries) {
+                adapterItems.push({
+                    source: "external",
+                    sourceProvider: adapter.name,
+                    sourceRef: entry.sourceRef,
+                    key: makeExternalKey(adapter, entry.sourceRef),
+                    cruise: entry,
+                });
+            }
+        }
+        return c.json({
+            data: [...localItems, ...adapterItems],
+            total: local.total + adapterItems.length,
+            localTotal: local.total,
+            adapterCount: adapters.length,
+            adapterErrors,
+            limit: local.limit,
+            offset: local.offset,
+        });
+    })
+        .post("/", async (c) => {
+        const data = await parseJsonBody(c, insertCruiseSchema);
+        const row = await cruisesService.createCruise(c.get("db"), data, {
+            eventBus: c.get("eventBus"),
+        });
+        return c.json({ data: row }, 201);
+    });
+}

package/dist/routes-detail.d.ts

@@ -0,0 +1,4 @@
+import type { Hono } from "hono";
+import type { CruiseRoutesEnv as Env } from "./routes-env.js";
+export declare function registerCruiseDetailRoutes(app: Hono<Env>): void;
+//# sourceMappingURL=routes-detail.d.ts.map

package/dist/routes-detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes-detail.d.ts","sourceRoot":"","sources":["../src/routes-detail.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAGhC,OAAO,KAAK,EAAE,eAAe,IAAI,GAAG,EAAE,MAAM,iBAAiB,CAAA;AAoB7D,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,QA2PxD"}