@voyantjs/storefront 0.47.0 → 0.50.0

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

@@ -1 +1 @@
-{"version":3,"file":"routes-public.d.ts","sourceRoot":"","sources":["../src/routes-public.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,cAAc,CAAA;AAYrB,KAAK,GAAG,GAAG;IACT,SAAS,EAAE;QACT,EAAE,EAAE,OAAO,CAAA;KACZ,CAAA;CACF,CAAA;AAED,wBAAgB,4BAA4B,CAAC,OAAO,CAAC,EAAE,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAyI9E;AAED,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAA"}
+{"version":3,"file":"routes-public.d.ts","sourceRoot":"","sources":["../src/routes-public.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAA;AAIvB,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,cAAc,CAAA;AAiBrB,KAAK,GAAG,GAAG;IACT,QAAQ,EAAE,cAAc,CAAA;IACxB,SAAS,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,GAAG,eAAe,CAAA;CACpB,CAAA;AA+CD,wBAAgB,4BAA4B,CAAC,OAAO,CAAC,EAAE,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAuP9E;AAED,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAA"}

package/dist/routes-public.js

@@ -1,20 +1,90 @@
-import { parseJsonBody, parseQuery } from "@voyantjs/hono";
+import { checkoutCapabilityActions, checkoutCapabilityCookie, issueCheckoutCapability, } from "@voyantjs/bookings/checkout-capability";
+import { idempotencyKey, parseJsonBody, parseQuery, } from "@voyantjs/hono";
 import { Hono } from "hono";
 import { createStorefrontService, } from "./service.js";
-import { storefrontDepartureListQuerySchema, storefrontDeparturePricePreviewInputSchema, storefrontOfferApplyInputSchema, storefrontOfferRedeemInputSchema, storefrontProductAvailabilitySummaryQuerySchema, storefrontProductExtensionsQuerySchema, storefrontPromotionalOfferListQuerySchema, } from "./validation.js";
+import { storefrontBookingSessionBootstrapInputSchema, storefrontDepartureListQuerySchema, storefrontDeparturePricePreviewInputSchema, storefrontLeadIntakeInputSchema, storefrontNewsletterSubscribeInputSchema, storefrontOfferApplyInputSchema, storefrontOfferRedeemInputSchema, storefrontProductAvailabilitySummaryQuerySchema, storefrontProductExtensionsQuerySchema, storefrontPromotionalOfferListQuerySchema, } from "./validation.js";
 import { storefrontTransportEligibilityInputSchema } from "./validation-transport-eligibility.js";
+function getRuntimeEnv(c) {
+    const processEnv = globalThis.process?.env ?? {};
+    return {
+        ...processEnv,
+        ...(c.env ?? {}),
+    };
+}
+function sessionConflictError(status) {
+    switch (status) {
+        case "insufficient_capacity":
+            return "Insufficient slot capacity";
+        case "slot_unavailable":
+            return "Availability slot is not bookable";
+        case "pricing_unavailable":
+            return "Pricing is not available for the selected booking session items";
+        case "stale_quote":
+            return "Booking session quote is stale";
+        case "invalid_slot":
+            return "Booking session slot does not match the requested departure";
+        default:
+            return "Unable to bootstrap booking session";
+    }
+}
+function attachCheckoutCapability(session, issued) {
+    return {
+        ...session,
+        checkoutCapability: {
+            token: issued.token,
+            expiresAt: issued.expiresAt.toISOString(),
+            actions: [...checkoutCapabilityActions],
+        },
+    };
+}
 export function createStorefrontPublicRoutes(options) {
     const storefrontService = createStorefrontService(options);
     function getRequestContext(c) {
         return {
             db: c.get("db"),
+            eventBus: c.get("eventBus"),
             env: c.env,
             context: c,
         };
     }
+    async function runIntakeGuard(input) {
+        const decision = await storefrontService.checkIntakeGuard(input);
+        if (!decision || decision.allowed)
+            return null;
+        return {
+            status: decision.status ?? 403,
+            error: decision.error ?? "Storefront intake rejected",
+        };
+    }
     return new Hono()
         .get("/settings", async (c) => {
         return c.json({ data: await storefrontService.resolveSettings(getRequestContext(c)) });
+    })
+        .post("/leads", async (c) => {
+        const context = getRequestContext(c);
+        const body = await parseJsonBody(c, storefrontLeadIntakeInputSchema);
+        const rejected = await runIntakeGuard({ kind: "lead", body, context });
+        if (rejected)
+            return c.json({ error: rejected.error }, rejected.status);
+        return c.json({
+            data: await storefrontService.createLead({
+                body,
+                context,
+            }),
+        }, 201);
+    })
+        .post("/newsletter/subscribe", async (c) => {
+        const context = getRequestContext(c);
+        const body = await parseJsonBody(c, storefrontNewsletterSubscribeInputSchema);
+        const rejected = await runIntakeGuard({ kind: "newsletter", body, context });
+        if (rejected)
+            return c.json({ error: rejected.error }, rejected.status);
+        return c.json({
+            data: await storefrontService.subscribeNewsletter({
+                body,
+                context,
+            }),
+        }, 202);
     })
         .get("/departures/:departureId", async (c) => {
         const departure = await storefrontService.getDeparture(c.get("db"), c.req.param("departureId"));
@@ -26,10 +96,41 @@ export function createStorefrontPublicRoutes(options) {
         return c.json(await storefrontService.listProductDepartures(c.get("db"), c.req.param("productId"), await parseQuery(c, storefrontDepartureListQuerySchema)));
     })
         .post("/departures/:departureId/price", async (c) => {
-        const preview = await storefrontService.previewDeparturePrice(c.get("db"), c.req.param("departureId"), await parseJsonBody(c, storefrontDeparturePricePreviewInputSchema));
+        const preview = await storefrontService.previewDeparturePrice(c.get("db"), c.req.param("departureId"), await parseJsonBody(c, storefrontDeparturePricePreviewInputSchema), getRequestContext(c));
         return preview
             ? c.json({ data: preview })
             : c.json({ error: "Storefront departure not found" }, 404);
+    })
+        .post("/bookings/sessions/bootstrap", idempotencyKey({ scope: "POST /v1/public/bookings/sessions/bootstrap" }), async (c) => {
+        const result = await storefrontService.bootstrapBookingSession(getRequestContext(c), await parseJsonBody(c, storefrontBookingSessionBootstrapInputSchema), c.get("userId"));
+        if (result.status === "departure_not_found") {
+            return c.json({ error: "Storefront departure not found" }, 404);
+        }
+        if (result.status === "slot_not_found") {
+            return c.json({ error: "Availability slot not found" }, 404);
+        }
+        if (result.status !== "ok") {
+            return c.json({
+                error: sessionConflictError(result.status),
+                ...(result.status === "stale_quote" && "repricing" in result
+                    ? { data: { repricing: result.repricing } }
+                    : {}),
+            }, result.status === "invalid_slot" ? 400 : 409);
+        }
+        if (!("bootstrap" in result)) {
+            return c.json({ error: "Unable to bootstrap booking session" }, 409);
+        }
+        const { bootstrap } = result;
+        const capability = await issueCheckoutCapability(bootstrap.session.sessionId, getRuntimeEnv(c));
+        c.header("Set-Cookie", checkoutCapabilityCookie(capability.token, capability.expiresAt), {
+            append: true,
+        });
+        return c.json({
+            data: {
+                ...bootstrap,
+                session: attachCheckoutCapability(bootstrap.session, capability),
+            },
+        }, 201);
     })
         .post("/departures/:departureId/eligibility", async (c) => {
         return c.json({

package/dist/service-booking-session-bootstrap.d.ts

@@ -0,0 +1,227 @@
+import { type PaymentPolicy } from "@voyantjs/finance";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import type { StorefrontBookingSessionBootstrapInput } from "./validation.js";
+export interface StorefrontBootstrapRequestContext {
+    db: PostgresJsDatabase;
+    env?: unknown;
+    context?: unknown;
+}
+export interface StorefrontBookingSessionBootstrapOptions {
+    paymentPolicy?: PaymentPolicy;
+    resolvePaymentPolicy?: (input: StorefrontBookingSessionBootstrapInput & StorefrontBootstrapRequestContext) => Promise<PaymentPolicy | null | undefined> | PaymentPolicy | null | undefined;
+    today?: Date;
+}
+export declare function bootstrapStorefrontBookingSession(context: StorefrontBootstrapRequestContext, input: StorefrontBookingSessionBootstrapInput, options: StorefrontBookingSessionBootstrapOptions | undefined, userId?: string): Promise<{
+    status: Exclude<string, "ok">;
+} | {
+    status: "stale_quote";
+    repricing: {
+        originalQuote: {
+            currencyCode: string;
+            totalSellAmountCents: number;
+            quotedAt?: string | null | undefined;
+            expiresAt?: string | null | undefined;
+        };
+        current: {
+            sessionId: string;
+            catalogId: string | null;
+            currencyCode: string;
+            totalSellAmountCents: number;
+            items: {
+                inputIndex: number;
+                itemId: string;
+                title: string;
+                productId: string | null;
+                optionId: string | null;
+                optionUnitId: string | null;
+                optionUnitName: string | null;
+                optionUnitType: string | null;
+                pricingCategoryId: string | null;
+                quantity: number;
+                pricingMode: string;
+                unitSellAmountCents: number | null;
+                totalSellAmountCents: number | null;
+                warnings: string[];
+            }[];
+            warnings: never[];
+            appliedToSession: boolean;
+        };
+        deltaAmountCents: number;
+        staleQuote: boolean;
+    };
+    bootstrap?: undefined;
+} | {
+    status: "ok";
+    bootstrap: {
+        session: {
+            sessionId: string;
+            bookingNumber: string;
+            status: "completed" | "cancelled" | "draft" | "on_hold" | "awaiting_payment" | "confirmed" | "in_progress" | "expired";
+            externalBookingRef: string | null;
+            communicationLanguage: string | null;
+            sellCurrency: string;
+            sellAmountCents: number | null;
+            startDate: string | null;
+            endDate: string | null;
+            pax: number | null;
+            holdExpiresAt: string | null;
+            confirmedAt: string | null;
+            expiredAt: string | null;
+            cancelledAt: string | null;
+            completedAt: string | null;
+            travelers: {
+                id: string;
+                participantType: "other" | "traveler" | "occupant";
+                travelerCategory: "child" | "other" | "adult" | "infant" | "senior" | null;
+                firstName: string;
+                lastName: string;
+                email: string | null;
+                phone: string | null;
+                preferredLanguage: string | null;
+                specialRequests: string | null;
+                isPrimary: boolean;
+                notes: string | null;
+            }[];
+            items: {
+                id: string;
+                title: string;
+                description: string | null;
+                itemType: "service" | "other" | "unit" | "extra" | "fee" | "tax" | "discount" | "adjustment" | "accommodation" | "transport";
+                status: "cancelled" | "draft" | "on_hold" | "confirmed" | "expired" | "fulfilled";
+                serviceDate: string | null;
+                startsAt: string | null;
+                endsAt: string | null;
+                quantity: number;
+                sellCurrency: string;
+                unitSellAmountCents: number | null;
+                totalSellAmountCents: number | null;
+                costCurrency: string | null;
+                unitCostAmountCents: number | null;
+                totalCostAmountCents: number | null;
+                notes: string | null;
+                productId: string | null;
+                optionId: string | null;
+                optionUnitId: string | null;
+                pricingCategoryId: string | null;
+                travelerLinks: {
+                    id: string;
+                    travelerId: string;
+                    role: string;
+                    isPrimary: boolean;
+                }[];
+            }[];
+            allocations: {
+                id: string;
+                bookingItemId: string;
+                productId: string | null;
+                optionId: string | null;
+                optionUnitId: string | null;
+                pricingCategoryId: string | null;
+                availabilitySlotId: string | null;
+                quantity: number;
+                allocationType: "resource" | "pickup" | "unit";
+                status: "cancelled" | "confirmed" | "expired" | "fulfilled" | "held" | "released";
+                holdExpiresAt: string | null;
+                confirmedAt: string | null;
+                releasedAt: string | null;
+            }[];
+            checklist: {
+                hasTravelers: boolean;
+                hasPrimaryTraveler: boolean;
+                hasItems: boolean;
+                hasAllocations: boolean;
+                readyForConfirmation: boolean;
+            };
+            state: {
+                sessionId: string;
+                stateKey: "wizard";
+                currentStep: string | null;
+                completedSteps: string[];
+                payload: Record<string, unknown>;
+                version: number;
+                createdAt: string;
+                updatedAt: string;
+            } | null;
+        };
+        paymentPlan: {
+            source: "storefront_default";
+            depositKind: import("@voyantjs/finance").DepositKind;
+            depositPercent: number | null;
+            depositAmountCents: number | null;
+            requiresFullPayment: boolean;
+        };
+        paymentSchedule: {
+            id: string;
+            scheduleType: "other" | "deposit" | "installment" | "balance" | "hold";
+            status: "pending" | "cancelled" | "expired" | "paid" | "due" | "waived";
+            dueDate: string;
+            currency: string;
+            amountCents: number;
+            notes: string | null;
+        }[];
+        repricing: {
+            originalQuote: {
+                currencyCode: string;
+                totalSellAmountCents: number;
+                quotedAt?: string | null | undefined;
+                expiresAt?: string | null | undefined;
+            };
+            current: {
+                sessionId: string;
+                items: {
+                    itemId: string;
+                    title: string;
+                    productId: string | null;
+                    optionId: string | null;
+                    optionUnitId: string | null;
+                    optionUnitName: string | null;
+                    optionUnitType: string | null;
+                    pricingCategoryId: string | null;
+                    quantity: number;
+                    pricingMode: string;
+                    unitSellAmountCents: number | null;
+                    totalSellAmountCents: number | null;
+                    warnings: string[];
+                }[];
+                catalogId: string | null;
+                currencyCode: string;
+                totalSellAmountCents: number;
+                warnings: never[];
+                appliedToSession: boolean;
+            };
+            deltaAmountCents: number;
+            staleQuote: boolean;
+        };
+        availability: {
+            departureId: string;
+            slotId: string;
+            productId: string;
+            optionId: string | null;
+            dateLocal: string;
+            startsAt: string | null;
+            endsAt: string | null;
+            timezone: string;
+            status: "cancelled" | "open" | "closed" | "sold_out";
+            capacity: number | null;
+            remaining: number | null;
+        };
+        allocation: {
+            id: string;
+            bookingItemId: string;
+            productId: string | null;
+            optionId: string | null;
+            optionUnitId: string | null;
+            pricingCategoryId: string | null;
+            availabilitySlotId: string | null;
+            quantity: number;
+            allocationType: "resource" | "pickup" | "unit";
+            status: "cancelled" | "confirmed" | "expired" | "fulfilled" | "held" | "released";
+            holdExpiresAt: string | null;
+            confirmedAt: string | null;
+            releasedAt: string | null;
+        }[];
+        currency: string;
+    };
+    repricing?: undefined;
+}>;
+//# sourceMappingURL=service-booking-session-bootstrap.d.ts.map

package/dist/service-booking-session-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-booking-session-bootstrap.d.ts","sourceRoot":"","sources":["../src/service-booking-session-bootstrap.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,OAAO,KAAK,EAAE,sCAAsC,EAAE,MAAM,iBAAiB,CAAA;AAE7E,MAAM,WAAW,iCAAiC;IAChD,EAAE,EAAE,kBAAkB,CAAA;IACtB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,wCAAwC;IACvD,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,oBAAoB,CAAC,EAAE,CACrB,KAAK,EAAE,sCAAsC,GAAG,iCAAiC,KAC9E,OAAO,CAAC,aAAa,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,aAAa,GAAG,IAAI,GAAG,SAAS,CAAA;IACjF,KAAK,CAAC,EAAE,IAAI,CAAA;CACb;AA0PD,wBAAsB,iCAAiC,CACrD,OAAO,EAAE,iCAAiC,EAC1C,KAAK,EAAE,sCAAsC,EAC7C,OAAO,EAAE,wCAAwC,GAAG,SAAS,EAC7D,MAAM,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;4BA/JD,MAAM;wBACV,MAAM;uBACP,MAAM;2BACF,MAAM,GAAG,IAAI;0BACd,MAAM,GAAG,IAAI;8BACT,MAAM,GAAG,IAAI;gCACX,MAAM,GAAG,IAAI;gCACb,MAAM,GAAG,IAAI;mCACV,MAAM,GAAG,IAAI;0BACtB,MAAM;6BACH,MAAM;qCACE,MAAM,GAAG,IAAI;sCACZ,MAAM,GAAG,IAAI;0BACzB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAXX,MAAM;+BACF,MAAM,GAAG,IAAI;8BACd,MAAM,GAAG,IAAI;kCACT,MAAM,GAAG,IAAI;oCACX,MAAM,GAAG,IAAI;oCACb,MAAM,GAAG,IAAI;uCACV,MAAM,GAAG,IAAI;8BACtB,MAAM;iCACH,MAAM;yCACE,MAAM,GAAG,IAAI;0CACZ,MAAM,GAAG,IAAI;8BACzB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuTrB"}

package/dist/service-booking-session-bootstrap.js

@@ -0,0 +1,297 @@
+import { availabilitySlots } from "@voyantjs/availability/schema";
+import { publicBookingsService, resolveSessionPricingSnapshot } from "@voyantjs/bookings";
+import { computePaymentSchedule, financeService, noDepositPolicy, } from "@voyantjs/finance";
+import { eq } from "drizzle-orm";
+function normalizeDate(value) {
+    if (!value) {
+        return null;
+    }
+    return value instanceof Date ? value.toISOString().slice(0, 10) : value;
+}
+function normalizeDateTime(value) {
+    if (!value) {
+        return null;
+    }
+    return value instanceof Date ? value.toISOString() : value;
+}
+function isExpired(value, now) {
+    if (!value) {
+        return false;
+    }
+    const expiresAt = new Date(value);
+    return Number.isNaN(expiresAt.getTime()) || expiresAt.getTime() <= now.getTime();
+}
+function resolveTierAmount(tiers, quantity, fallbackAmount) {
+    const tier = tiers.find((candidate) => quantity >= candidate.minQuantity &&
+        (candidate.maxQuantity === null || quantity <= candidate.maxQuantity));
+    return tier?.sellAmountCents ?? fallbackAmount;
+}
+function computeLineTotal(pricingMode, unitSellAmountCents, quantity, fallbackAmount) {
+    switch (pricingMode) {
+        case "free":
+        case "included":
+            return 0;
+        case "on_request":
+            return null;
+        case "per_unit":
+        case "per_person":
+            return unitSellAmountCents === null ? null : unitSellAmountCents * quantity;
+        default:
+            return unitSellAmountCents ?? fallbackAmount;
+    }
+}
+function serializePaymentPlan(policy, requiresFullPayment) {
+    return {
+        source: "storefront_default",
+        depositKind: policy.deposit.kind,
+        depositPercent: policy.deposit.kind === "percent" ? (policy.deposit.percent ?? 0) : null,
+        depositAmountCents: policy.deposit.kind === "fixed_cents" ? (policy.deposit.amountCents ?? 0) : null,
+        requiresFullPayment,
+    };
+}
+async function resolveAvailabilitySlot(db, slotId) {
+    const [slot] = await db
+        .select()
+        .from(availabilitySlots)
+        .where(eq(availabilitySlots.id, slotId))
+        .limit(1);
+    return slot ?? null;
+}
+async function previewBootstrapPricing(db, input, slot) {
+    const pricedItems = [];
+    let resolvedCatalogId = input.catalogId ?? null;
+    let resolvedCurrency = input.session.sellCurrency;
+    for (const [index, item] of input.session.items.entries()) {
+        const productId = item.productId ?? slot.productId;
+        const optionId = item.optionId ?? slot.optionId ?? undefined;
+        if (!productId) {
+            return { status: "pricing_unavailable" };
+        }
+        const snapshot = await resolveSessionPricingSnapshot(db, productId, {
+            catalogId: input.catalogId,
+            optionId,
+        });
+        if (!snapshot) {
+            return { status: "pricing_unavailable" };
+        }
+        resolvedCatalogId = snapshot.catalog.id;
+        resolvedCurrency = snapshot.catalog.currencyCode ?? input.session.sellCurrency;
+        const option = snapshot.options.find((candidate) => candidate.id === optionId) ?? snapshot.options[0] ?? null;
+        if (!option) {
+            return { status: "pricing_unavailable" };
+        }
+        const rule = snapshot.rules.find((candidate) => candidate.optionId === option.id && candidate.isDefault) ??
+            snapshot.rules.find((candidate) => candidate.optionId === option.id) ??
+            null;
+        if (!rule) {
+            return { status: "pricing_unavailable" };
+        }
+        const selectedUnitId = item.optionUnitId ?? null;
+        const pricingCategoryId = item.pricingCategoryId ?? null;
+        const ruleUnitPrices = snapshot.unitPrices.filter((candidate) => candidate.optionPriceRuleId === rule.id);
+        const unitPriceCandidates = ruleUnitPrices.filter((candidate) => {
+            if (selectedUnitId && candidate.unitId !== selectedUnitId) {
+                return false;
+            }
+            if (pricingCategoryId && candidate.pricingCategoryId !== pricingCategoryId) {
+                return false;
+            }
+            if (candidate.minQuantity !== null && item.quantity < candidate.minQuantity) {
+                return false;
+            }
+            if (candidate.maxQuantity !== null && item.quantity > candidate.maxQuantity) {
+                return false;
+            }
+            return true;
+        });
+        const fallbackUnitPrice = !pricingCategoryId && !selectedUnitId
+            ? (ruleUnitPrices.find((candidate) => candidate.pricingCategoryId === null &&
+                (candidate.minQuantity === null || item.quantity >= candidate.minQuantity) &&
+                (candidate.maxQuantity === null || item.quantity <= candidate.maxQuantity)) ?? null)
+            : null;
+        const unitPrice = unitPriceCandidates[0] ?? fallbackUnitPrice;
+        if ((selectedUnitId || ruleUnitPrices.length > 0) &&
+            !unitPrice &&
+            rule.pricingMode !== "per_booking") {
+            return { status: "pricing_unavailable" };
+        }
+        const unitSellAmountCents = unitPrice
+            ? resolveTierAmount(unitPrice.tiers, item.quantity, unitPrice.sellAmountCents)
+            : rule.baseSellAmountCents;
+        const pricingMode = unitPrice?.pricingMode ?? rule.pricingMode;
+        const totalSellAmountCents = computeLineTotal(pricingMode, unitSellAmountCents, item.quantity, rule.baseSellAmountCents);
+        if (totalSellAmountCents === null) {
+            return { status: "pricing_unavailable" };
+        }
+        pricedItems.push({
+            inputIndex: index,
+            itemId: `input:${index}`,
+            title: item.title,
+            productId,
+            optionId: option.id,
+            optionUnitId: selectedUnitId,
+            optionUnitName: unitPrice?.unitName ?? null,
+            optionUnitType: unitPrice?.unitType ?? null,
+            pricingCategoryId,
+            quantity: item.quantity,
+            pricingMode,
+            unitSellAmountCents,
+            totalSellAmountCents,
+            warnings: [],
+        });
+    }
+    return {
+        status: "ok",
+        pricing: {
+            sessionId: "pending",
+            catalogId: resolvedCatalogId,
+            currencyCode: resolvedCurrency,
+            totalSellAmountCents: pricedItems.reduce((total, item) => total + (item.totalSellAmountCents ?? 0), 0),
+            items: pricedItems,
+            warnings: [],
+            appliedToSession: true,
+        },
+    };
+}
+async function resolveBootstrapPaymentPolicy(input, context, options) {
+    return ((await options?.resolvePaymentPolicy?.({
+        ...input,
+        ...context,
+    })) ??
+        options?.paymentPolicy ??
+        noDepositPolicy);
+}
+export async function bootstrapStorefrontBookingSession(context, input, options, userId) {
+    const now = options?.today ?? new Date();
+    if (isExpired(input.quote.expiresAt, now)) {
+        return { status: "stale_quote" };
+    }
+    const [departure, slot] = await Promise.all([
+        resolveAvailabilitySlot(context.db, input.departureId),
+        resolveAvailabilitySlot(context.db, input.slotId),
+    ]);
+    if (!departure) {
+        return { status: "departure_not_found" };
+    }
+    if (!slot) {
+        return { status: "slot_not_found" };
+    }
+    if (departure.id !== slot.id) {
+        return { status: "invalid_slot" };
+    }
+    const mismatchedItem = input.session.items.find((item) => item.availabilitySlotId !== input.slotId ||
+        (item.productId !== undefined &&
+            item.productId !== null &&
+            item.productId !== slot.productId) ||
+        (slot.optionId !== null &&
+            item.optionId !== undefined &&
+            item.optionId !== null &&
+            item.optionId !== slot.optionId));
+    if (mismatchedItem) {
+        return { status: "invalid_slot" };
+    }
+    const preview = await previewBootstrapPricing(context.db, input, {
+        productId: slot.productId,
+        optionId: slot.optionId ?? null,
+    });
+    if (preview.status !== "ok") {
+        return preview;
+    }
+    if (preview.pricing.currencyCode !== input.quote.currencyCode ||
+        preview.pricing.totalSellAmountCents !== input.quote.totalSellAmountCents) {
+        return {
+            status: "stale_quote",
+            repricing: {
+                originalQuote: input.quote,
+                current: preview.pricing,
+                deltaAmountCents: preview.pricing.totalSellAmountCents - input.quote.totalSellAmountCents,
+                staleQuote: true,
+            },
+        };
+    }
+    const createResult = await publicBookingsService.createSession(context.db, {
+        ...input.session,
+        sellCurrency: preview.pricing.currencyCode,
+        sellAmountCents: preview.pricing.totalSellAmountCents,
+        items: input.session.items.map((item, index) => {
+            const pricedItem = preview.pricing.items[index];
+            return {
+                ...item,
+                sellCurrency: preview.pricing.currencyCode,
+                productId: pricedItem?.productId ?? item.productId,
+                optionId: pricedItem?.optionId ?? item.optionId,
+                optionUnitId: pricedItem?.optionUnitId ?? item.optionUnitId,
+                pricingCategoryId: pricedItem?.pricingCategoryId ?? item.pricingCategoryId,
+                unitSellAmountCents: pricedItem?.unitSellAmountCents ?? item.unitSellAmountCents,
+                totalSellAmountCents: pricedItem?.totalSellAmountCents ?? item.totalSellAmountCents,
+            };
+        }),
+    }, userId);
+    if (createResult.status !== "ok") {
+        return createResult;
+    }
+    if (!("session" in createResult)) {
+        return { status: "not_found" };
+    }
+    const createdSession = createResult.session;
+    const policy = await resolveBootstrapPaymentPolicy(input, context, options);
+    const computedSchedule = computePaymentSchedule({
+        totalCents: createdSession.sellAmountCents ?? preview.pricing.totalSellAmountCents,
+        currency: createdSession.sellCurrency,
+        departureDate: slot.dateLocal ?? normalizeDate(slot.startsAt),
+        today: now,
+    }, policy);
+    const persistedSchedule = (await financeService.applyComputedPaymentSchedule(context.db, createdSession.sessionId, computedSchedule)) ?? [];
+    const [slotAfter] = await context.db
+        .select()
+        .from(availabilitySlots)
+        .where(eq(availabilitySlots.id, input.slotId))
+        .limit(1);
+    const availability = slotAfter ?? slot;
+    const currentItems = preview.pricing.items.map(({ inputIndex: _inputIndex, ...item }, index) => ({
+        ...item,
+        itemId: createdSession.items[index]?.id ?? item.itemId,
+    }));
+    const current = {
+        ...preview.pricing,
+        sessionId: createdSession.sessionId,
+        items: currentItems,
+    };
+    return {
+        status: "ok",
+        bootstrap: {
+            session: createdSession,
+            paymentPlan: serializePaymentPlan(policy, computedSchedule.length === 1 && computedSchedule[0]?.scheduleType === "full"),
+            paymentSchedule: persistedSchedule.map((schedule) => ({
+                id: schedule.id,
+                scheduleType: schedule.scheduleType,
+                status: schedule.status,
+                dueDate: normalizeDate(schedule.dueDate),
+                currency: schedule.currency,
+                amountCents: schedule.amountCents,
+                notes: schedule.notes ?? null,
+            })),
+            repricing: {
+                originalQuote: input.quote,
+                current,
+                deltaAmountCents: 0,
+                staleQuote: false,
+            },
+            availability: {
+                departureId: input.departureId,
+                slotId: input.slotId,
+                productId: availability.productId,
+                optionId: availability.optionId ?? null,
+                dateLocal: availability.dateLocal ?? null,
+                startsAt: normalizeDateTime(availability.startsAt),
+                endsAt: normalizeDateTime(availability.endsAt),
+                timezone: availability.timezone,
+                status: availability.status,
+                capacity: availability.initialPax ?? null,
+                remaining: availability.unlimited ? null : (availability.remainingPax ?? null),
+            },
+            allocation: createdSession.allocations,
+            currency: createdSession.sellCurrency,
+        },
+    };
+}