@voyantjs/accommodations 0.55.0

package/dist/content-shape.js

@@ -0,0 +1,122 @@
+/**
+ * Accommodation content shape — the rich detail-page content shape
+ * returned by `getContent` for sourced room types (bedbanks like
+ * Hotelbeds / Expedia, direct-property feeds, hotel groups via Voyant
+ * Connect).
+ *
+ * Per sourced-content §3.6, the accommodation content aggregate is
+ * `{ hotel, room_types[], rate_plans[], meal_plans[], amenities[],
+ * policies[] }` — one payload returned by a single `getContent`.
+ * Pricing stays out (volatile-live, flows through `liveResolve`).
+ *
+ * The aggregate is **per property** — one row per property × locale ×
+ * market — even though the sellable catalog entry is a room type.
+ * That's because bedbanks return whole-property payloads and splitting
+ * by room type would multiply cache writes and refresh work without
+ * benefit. The vertical's read service projects the cached property
+ * payload to the requested room-type detail page.
+ *
+ * See `docs/architecture/catalog-sourced-content.md` §3.2, §3.5.4, §3.6.
+ */
+import { mergeOverlaysIntoContent, } from "@voyantjs/catalog";
+import { z } from "zod";
+export const ACCOMMODATION_CONTENT_SCHEMA_VERSION = "accommodations/v1";
+export const hotelSummarySchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    description: z.string().nullable().optional(),
+    star_rating: z.number().min(0).max(5).nullable().optional(),
+    hero_image_url: z.string().nullable().optional(),
+    highlights: z.array(z.string()).optional(),
+    brand: z.string().nullable().optional(),
+    // Geo / location
+    country: z.string().nullable().optional(),
+    city: z.string().nullable().optional(),
+    address: z.string().nullable().optional(),
+    postal_code: z.string().nullable().optional(),
+    latitude: z.number().nullable().optional(),
+    longitude: z.number().nullable().optional(),
+    // Operational
+    check_in_time: z.string().nullable().optional(),
+    check_out_time: z.string().nullable().optional(),
+});
+export const accommodationRoomTypeSchema = z.object({
+    id: z.string(),
+    code: z.string().nullable().optional(),
+    name: z.string(),
+    description: z.string().nullable().optional(),
+    room_class: z.string().nullable().optional(), // e.g. "deluxe", "suite"
+    /** Inside / outside / balcony / suite — bedbank conventions vary. */
+    view: z.string().nullable().optional(),
+    bedrooms: z.number().int().nonnegative().nullable().optional(),
+    beds: z.array(z.string()).optional().default([]),
+    size_sqm: z.number().int().nonnegative().nullable().optional(),
+    max_adults: z.number().int().nonnegative().nullable().optional(),
+    max_children: z.number().int().nonnegative().nullable().optional(),
+    max_occupancy: z.number().int().nonnegative().nullable().optional(),
+    amenities: z.array(z.string()).optional().default([]),
+    images: z.array(z.string()).optional().default([]),
+});
+export const accommodationRatePlanSchema = z.object({
+    id: z.string(),
+    code: z.string().nullable().optional(),
+    name: z.string(),
+    description: z.string().nullable().optional(),
+    /** "per_night" | "per_stay" — the plan's charge frequency. */
+    charge_frequency: z.enum(["per_night", "per_stay"]).optional().default("per_night"),
+    /** Room types this plan is bookable on; empty = all. */
+    applies_to_room_type_ids: z.array(z.string()).optional().default([]),
+    cancellation_policy: z.string().nullable().optional(),
+    inclusions: z.array(z.string()).optional().default([]),
+});
+export const accommodationMealPlanSchema = z.object({
+    id: z.string(),
+    code: z.string().nullable().optional(),
+    name: z.string(),
+    description: z.string().nullable().optional(),
+    /** "room_only" | "bed_breakfast" | "half_board" | "full_board" | "all_inclusive". */
+    basis: z.string(),
+    inclusions: z.array(z.string()).optional().default([]),
+});
+export const accommodationAmenitySchema = z.object({
+    id: z.string(),
+    /** "pool" | "spa" | "wifi" | … */
+    category: z.string().nullable().optional(),
+    name: z.string(),
+    description: z.string().nullable().optional(),
+    is_free: z.boolean().optional(),
+});
+export const accommodationPolicySchema = z.object({
+    kind: z.enum(["cancellation", "payment", "supplier_notes", "requirements", "check_in"]),
+    body: z.string(),
+    rules: z.unknown().optional(),
+});
+export const accommodationContentSchema = z.object({
+    hotel: hotelSummarySchema,
+    room_types: z.array(accommodationRoomTypeSchema).default([]),
+    rate_plans: z.array(accommodationRatePlanSchema).default([]),
+    meal_plans: z.array(accommodationMealPlanSchema).default([]),
+    amenities: z.array(accommodationAmenitySchema).default([]),
+    policies: z.array(accommodationPolicySchema).default([]),
+});
+export function validateAccommodationContent(payload) {
+    const result = accommodationContentSchema.safeParse(payload);
+    if (result.success) {
+        return { valid: true, content: result.data };
+    }
+    const issue = result.error.issues[0];
+    return {
+        valid: false,
+        reason: issue ? `${issue.path.join(".")}: ${issue.message}` : "validation failed",
+    };
+}
+export function mergeOverlaysIntoAccommodationContent(payload, overlays, options = {}) {
+    const merged = mergeOverlaysIntoContent(payload, overlays, {
+        validate(p) {
+            const r = validateAccommodationContent(p);
+            return r.valid ? { valid: true } : { valid: false, reason: r.reason };
+        },
+        onOverlayError: options.onOverlayError,
+    });
+    return accommodationContentSchema.parse(merged);
+}

package/dist/draft-shape.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Project a `AccommodationContent` payload into a `BookingDraftShape`.
+ *
+ * Hotel / room-type bookings need:
+ *   - Configure: date-range (check-in → check-out) + occupancy.
+ *   - Accommodation: room selection — the journey's
+ *     `accommodation.subSteps` rooms variant, populated from
+ *     `content.room_types[]`.
+ *   - Add-ons: meal plans + amenities surfaced as upsells (when the
+ *     supplier prices them as add-ons; otherwise they're informational).
+ *
+ * Pricing flows through liveResolve at quote time per night /
+ * occupancy / rate-plan.
+ */
+import { type BookingDraftShape, type PaxBandSpec } from "@voyantjs/catalog/booking-engine";
+import type { AccommodationContent } from "./content-shape.js";
+export declare const DEFAULT_ACCOMMODATION_PAX_BANDS: ReadonlyArray<PaxBandSpec>;
+export interface BuildAccommodationDraftShapeOptions {
+    locale?: string;
+    paxBands?: ReadonlyArray<PaxBandSpec>;
+    paxBandsAllowedTotal?: {
+        min: number;
+        max: number;
+    };
+    /**
+     * Default minimum-nights window. Most bedbanks accept 1–30 nights;
+     * templates override per supplier when known.
+     */
+    minNights?: number;
+    maxNights?: number;
+    /** When true, the wizard allows multiple guests sharing one room. */
+    sharedRoomAllowed?: boolean;
+}
+export declare function buildAccommodationDraftShape(content: AccommodationContent, options?: BuildAccommodationDraftShapeOptions): BookingDraftShape;
+//# sourceMappingURL=draft-shape.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"draft-shape.d.ts","sourceRoot":"","sources":["../src/draft-shape.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,KAAK,iBAAiB,EAItB,KAAK,WAAW,EAIjB,MAAM,kCAAkC,CAAA;AAEzC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAE9D,eAAO,MAAM,+BAA+B,EAAE,aAAa,CAAC,WAAW,CAGtE,CAAA;AAED,MAAM,WAAW,mCAAmC;IAClD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAA;IACrC,oBAAoB,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IACnD;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,oBAAoB,EAC7B,OAAO,GAAE,mCAAwC,GAChD,iBAAiB,CAoEnB"}

package/dist/draft-shape.js

@@ -0,0 +1,84 @@
+/**
+ * Project a `AccommodationContent` payload into a `BookingDraftShape`.
+ *
+ * Hotel / room-type bookings need:
+ *   - Configure: date-range (check-in → check-out) + occupancy.
+ *   - Accommodation: room selection — the journey's
+ *     `accommodation.subSteps` rooms variant, populated from
+ *     `content.room_types[]`.
+ *   - Add-ons: meal plans + amenities surfaced as upsells (when the
+ *     supplier prices them as add-ons; otherwise they're informational).
+ *
+ * Pricing flows through liveResolve at quote time per night /
+ * occupancy / rate-plan.
+ */
+import { defaultBookingFields, defaultDraftShapeFlags, defaultTravelerFields, paxBandsAllowedTotalFrom, } from "@voyantjs/catalog/booking-engine";
+export const DEFAULT_ACCOMMODATION_PAX_BANDS = [
+    { code: "adult", label: "Adult", minCount: 1, maxCount: 6 },
+    { code: "child", label: "Child", minAge: 0, maxAge: 17, minCount: 0, maxCount: 4 },
+];
+export function buildAccommodationDraftShape(content, options = {}) {
+    const paxBands = options.paxBands ?? DEFAULT_ACCOMMODATION_PAX_BANDS;
+    const total = options.paxBandsAllowedTotal ?? paxBandsAllowedTotalFrom(paxBands);
+    const minNights = options.minNights ?? 1;
+    const maxNights = options.maxNights ?? 30;
+    const sharedRoomAllowed = options.sharedRoomAllowed ?? true;
+    // Project each rate plan once. The journey filters per-room based
+    // on `applies_to_room_type_ids` (empty = applies to all rooms).
+    const planByRoom = new Map();
+    for (const rt of content.room_types) {
+        planByRoom.set(rt.id, []);
+    }
+    for (const plan of content.rate_plans) {
+        const rooms = plan.applies_to_room_type_ids.length === 0
+            ? content.room_types.map((r) => r.id)
+            : plan.applies_to_room_type_ids;
+        const planOption = {
+            id: plan.id,
+            name: plan.name,
+            description: plan.description ?? null,
+            chargeFrequency: plan.charge_frequency,
+            cancellationPolicy: plan.cancellation_policy ?? null,
+            inclusions: plan.inclusions,
+        };
+        for (const roomId of rooms) {
+            const list = planByRoom.get(roomId);
+            if (list)
+                list.push(planOption);
+        }
+    }
+    const roomOptions = content.room_types.map((rt) => ({
+        id: rt.id,
+        name: rt.name,
+        description: rt.description ?? null,
+        capacity: rt.max_occupancy ?? rt.max_adults ?? null,
+        baseRateHint: null,
+        ratePlans: planByRoom.get(rt.id) ?? [],
+    }));
+    return {
+        ...defaultDraftShapeFlags(),
+        showsAccommodation: roomOptions.length > 0,
+        paxBands,
+        paxBandsAllowedTotal: total,
+        travelerFields: defaultTravelerFields(),
+        bookingFields: defaultBookingFields(),
+        configureSubSteps: [
+            { kind: "date-range", minNights, maxNights },
+            { kind: "occupancy", bands: paxBands },
+        ],
+        accommodation: roomOptions.length > 0
+            ? {
+                roomOptions,
+                sharedRoomAllowed,
+                subSteps: [
+                    {
+                        kind: "rooms",
+                        options: roomOptions,
+                        sharedRoomAllowed,
+                    },
+                ],
+            }
+            : undefined,
+        paymentIntents: ["hold", "card"],
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./booking-engine/index.js";
+export * from "./catalog-policy.js";
+export * from "./content-shape.js";
+export * from "./draft-shape.js";
+export * from "./service-catalog-plane.js";
+export * from "./service-content.js";
+export * from "./service-content-synthesizer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAA;AACzC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sBAAsB,CAAA;AACpC,cAAc,kCAAkC,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from "./booking-engine/index.js";
+export * from "./catalog-policy.js";
+export * from "./content-shape.js";
+export * from "./draft-shape.js";
+export * from "./service-catalog-plane.js";
+export * from "./service-content.js";
+export * from "./service-content-synthesizer.js";

package/dist/routes-content.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Accommodation content routes — sourced-aware detail endpoint.
+ *
+ *   GET /:id/content
+ *
+ * Returns lodging detail content for sourced accommodation inventory:
+ * cache hit -> cached row + overlay merge; cache miss with rich adapter ->
+ * adapter fetch + write-through; cache miss with thin adapter -> synthesizer
+ * fallback.
+ */
+import type { SourceAdapterRegistry } from "@voyantjs/catalog/booking-engine";
+import type { AnyDrizzleDb } from "@voyantjs/db";
+import type { Context } from "hono";
+import { Hono } from "hono";
+export interface AccommodationContentRoutesEnv {
+    Variables: {
+        db: AnyDrizzleDb;
+    };
+}
+export interface CreateAccommodationContentRoutesOptions {
+    resolveRegistry: (c: Context) => SourceAdapterRegistry;
+    onOverlayError?: (event: {
+        field_path: string;
+        reason: string;
+    }) => void;
+    defaultAcceptMachineTranslated?: boolean;
+}
+export declare function createAccommodationContentRoutes(options: CreateAccommodationContentRoutesOptions): Hono<AccommodationContentRoutesEnv>;
+export declare function parseAcceptLanguage(header: string): string[];
+export type AccommodationContentRoutes = ReturnType<typeof createAccommodationContentRoutes>;
+//# 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;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAA;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAI3B,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE;QACT,EAAE,EAAE,YAAY,CAAA;KACjB,CAAA;CACF;AAED,MAAM,WAAW,uCAAuC;IACtD,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;CACzC;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,uCAAuC,GAC/C,IAAI,CAAC,6BAA6B,CAAC,CA4DrC;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAqB5D;AAED,MAAM,MAAM,0BAA0B,GAAG,UAAU,CAAC,OAAO,gCAAgC,CAAC,CAAA"}

package/dist/routes-content.js

@@ -0,0 +1,87 @@
+/**
+ * Accommodation content routes — sourced-aware detail endpoint.
+ *
+ *   GET /:id/content
+ *
+ * Returns lodging detail content for sourced accommodation inventory:
+ * cache hit -> cached row + overlay merge; cache miss with rich adapter ->
+ * adapter fetch + write-through; cache miss with thin adapter -> synthesizer
+ * fallback.
+ */
+import { Hono } from "hono";
+import { getAccommodationContent } from "./service-content.js";
+export function createAccommodationContentRoutes(options) {
+    return new Hono().get("/:id/content", async (c) => {
+        const entityId = c.req.param("id");
+        const scope = parseScope(c);
+        const registry = options.resolveRegistry(c);
+        const result = await getAccommodationContent(c.var.db, entityId, scope, {
+            registry,
+            onOverlayError: options.onOverlayError,
+        });
+        if (!result) {
+            return c.json({
+                error: "not_found",
+                detail: `Accommodation ${entityId} has no sourced-content row.`,
+            }, 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,
+            },
+        });
+    });
+    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,
+        };
+    }
+}
+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);
+}