@voyant-travel/storefront 0.120.1

package/dist/service.d.ts

@@ -0,0 +1,1062 @@
+import type { EventBus } from "@voyant-travel/core";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import { type StorefrontBookingSessionBootstrapOptions } from "./service-booking-session-bootstrap.js";
+import { type StorefrontCustomerSignalCreatedEvent, type StorefrontIntakeGuard, type StorefrontIntakeOptions, type StorefrontIntakePersistence, type StorefrontIntakePersistenceResolver, type StorefrontIntakePerson, type StorefrontIntakeSignal } from "./service-intake.js";
+import { type StorefrontBookingSessionBootstrapInput, type StorefrontDepartureListQuery, type StorefrontDeparturePricePreviewInput, type StorefrontLeadIntakeInput, type StorefrontNewsletterSubscribeInput, type StorefrontOfferApplyInput, type StorefrontOfferMutationResult, type StorefrontOfferRedeemInput, type StorefrontProductAvailabilitySummaryQuery, type StorefrontPromotionalOffer, type StorefrontSettings, type StorefrontSettingsInput, type StorefrontSettingsPatchInput } from "./validation.js";
+import type { StorefrontTransportEligibilityInput, StorefrontTransportEligibilityResult, StorefrontTransportEligibilityRuleInput } from "./validation-transport-eligibility.js";
+export interface StorefrontServiceOptions {
+    /**
+     * Enables the async booking-bootstrap mode (queued write pipeline,
+     * RFC voyant#1687 §3.2). When set, `createStorefrontHonoModule`'s
+     * bootstrap registers the intent handler on the app bus AND the
+     * public bootstrap route honors `?async=1` / `Prefer: respond-async`.
+     * When omitted, async-mode requests fall back to the SYNC path — an
+     * intent with no registered handler would otherwise 202 and then
+     * stale-fail, which is strictly worse than just doing the work.
+     */
+    bookingIntents?: {
+        resolveDb: (bindings: Record<string, unknown>) => unknown;
+    };
+    settings?: StorefrontSettingsInput;
+    resolveSettings?: (context: StorefrontRequestContext) => Promise<StorefrontSettingsInput> | StorefrontSettingsInput;
+    updateSettings?: (input: StorefrontSettings, context: StorefrontRequestContext) => Promise<StorefrontSettingsInput | StorefrontSettings> | StorefrontSettingsInput | StorefrontSettings;
+    offers?: StorefrontOfferResolvers;
+    resolveOffers?: (context: StorefrontRequestContext) => Promise<StorefrontOfferResolvers | null | undefined> | StorefrontOfferResolvers | null | undefined;
+    transportEligibilityRules?: StorefrontTransportEligibilityRuleInput[];
+    resolveTransportEligibilityRules?: (input: {
+        departureId: string;
+        productId?: string | null;
+        travelStartsOn?: string | null;
+        travelEndsOn?: string | null;
+    } & StorefrontRequestContext) => Promise<StorefrontTransportEligibilityRuleInput[]> | StorefrontTransportEligibilityRuleInput[];
+    intake?: StorefrontIntakeOptions;
+    bookingSessionBootstrap?: StorefrontBookingSessionBootstrapOptions;
+}
+export interface StorefrontRequestContext {
+    db?: PostgresJsDatabase;
+    eventBus?: EventBus;
+    env?: unknown;
+    context?: unknown;
+}
+export interface StorefrontOfferResolvers {
+    listApplicableOffers?: (input: {
+        productId: string;
+        departureId?: string;
+        locale?: string;
+    } & StorefrontRequestContext) => Promise<StorefrontPromotionalOffer[]> | StorefrontPromotionalOffer[];
+    getOfferBySlug?: (input: {
+        slug: string;
+        locale?: string;
+    } & StorefrontRequestContext) => Promise<StorefrontPromotionalOffer | null> | StorefrontPromotionalOffer | null;
+    applyOffer?: (input: {
+        slug: string;
+        body: StorefrontOfferApplyInput;
+    } & StorefrontRequestContext) => Promise<StorefrontOfferMutationResult> | StorefrontOfferMutationResult;
+    redeemOffer?: (input: {
+        body: StorefrontOfferRedeemInput;
+    } & StorefrontRequestContext) => Promise<StorefrontOfferMutationResult> | StorefrontOfferMutationResult;
+}
+export declare function resolveStorefrontSettings(input?: StorefrontSettingsInput): StorefrontSettings;
+export declare function mergeStorefrontSettingsPatch(current: StorefrontSettings, patch: StorefrontSettingsPatchInput): StorefrontSettings;
+export declare function createStorefrontService(options?: StorefrontServiceOptions): {
+    getSettings(): StorefrontSettings;
+    resolveSettings: (context?: StorefrontRequestContext) => Promise<{
+        branding: {
+            logoUrl: string | null;
+            faviconUrl: string | null;
+            brandMarkUrl: string | null;
+            primaryColor: string | null;
+            accentColor: string | null;
+            supportedLanguages: string[];
+        };
+        support: {
+            email: string | null;
+            phone: string | null;
+            links: {
+                label: string;
+                url: string;
+            }[];
+        };
+        legal: {
+            termsUrl: string | null;
+            privacyUrl: string | null;
+            cancellationUrl: string | null;
+            defaultContractTemplateId: string | null;
+        };
+        localization: {
+            defaultLocale: string | null;
+            currencyDisplay: "symbol" | "name" | "code";
+        };
+        forms: {
+            billing: {
+                fields: {
+                    key: string;
+                    label: string;
+                    type: "date" | "select" | "text" | "email" | "textarea" | "country" | "tel" | "checkbox";
+                    required: boolean;
+                    placeholder: string | null;
+                    description: string | null;
+                    autocomplete: string | null;
+                    options: {
+                        value: string;
+                        label: string;
+                    }[];
+                }[];
+            };
+            travelers: {
+                fields: {
+                    key: string;
+                    label: string;
+                    type: "date" | "select" | "text" | "email" | "textarea" | "country" | "tel" | "checkbox";
+                    required: boolean;
+                    placeholder: string | null;
+                    description: string | null;
+                    autocomplete: string | null;
+                    options: {
+                        value: string;
+                        label: string;
+                    }[];
+                }[];
+            };
+        };
+        payment: {
+            defaultMethod: "voucher" | "bank_transfer" | "cash" | "invoice" | "card" | null;
+            methods: {
+                code: "voucher" | "bank_transfer" | "cash" | "invoice" | "card";
+                label: string;
+                description: string | null;
+                enabled: boolean;
+            }[];
+            structure: "split" | "full";
+            schedule: {
+                percent: number;
+                dueInDays: number;
+                dueCondition: "after_booking" | "before_departure";
+            }[];
+            defaultSchedule: {
+                depositPercent: number | null;
+                balanceDueDaysBeforeDeparture: number | null;
+            } | null;
+            bankTransfer: {
+                dueDays: number | null;
+                account: {
+                    provider: string | null;
+                    currency: string | null;
+                    iban: string;
+                    beneficiary: string;
+                    bank: string;
+                } | null;
+                accountHolder: string | null;
+                bankName: string | null;
+                iban: string | null;
+                bic: string | null;
+                paymentReference: string | null;
+                instructions: string | null;
+            } | null;
+        };
+    }>;
+    updateSettings: (patch: StorefrontSettingsPatchInput, context?: StorefrontRequestContext) => Promise<{
+        branding: {
+            logoUrl: string | null;
+            faviconUrl: string | null;
+            brandMarkUrl: string | null;
+            primaryColor: string | null;
+            accentColor: string | null;
+            supportedLanguages: string[];
+        };
+        support: {
+            email: string | null;
+            phone: string | null;
+            links: {
+                label: string;
+                url: string;
+            }[];
+        };
+        legal: {
+            termsUrl: string | null;
+            privacyUrl: string | null;
+            cancellationUrl: string | null;
+            defaultContractTemplateId: string | null;
+        };
+        localization: {
+            defaultLocale: string | null;
+            currencyDisplay: "symbol" | "name" | "code";
+        };
+        forms: {
+            billing: {
+                fields: {
+                    key: string;
+                    label: string;
+                    type: "date" | "select" | "text" | "email" | "textarea" | "country" | "tel" | "checkbox";
+                    required: boolean;
+                    placeholder: string | null;
+                    description: string | null;
+                    autocomplete: string | null;
+                    options: {
+                        value: string;
+                        label: string;
+                    }[];
+                }[];
+            };
+            travelers: {
+                fields: {
+                    key: string;
+                    label: string;
+                    type: "date" | "select" | "text" | "email" | "textarea" | "country" | "tel" | "checkbox";
+                    required: boolean;
+                    placeholder: string | null;
+                    description: string | null;
+                    autocomplete: string | null;
+                    options: {
+                        value: string;
+                        label: string;
+                    }[];
+                }[];
+            };
+        };
+        payment: {
+            defaultMethod: "voucher" | "bank_transfer" | "cash" | "invoice" | "card" | null;
+            methods: {
+                code: "voucher" | "bank_transfer" | "cash" | "invoice" | "card";
+                label: string;
+                description: string | null;
+                enabled: boolean;
+            }[];
+            structure: "split" | "full";
+            schedule: {
+                percent: number;
+                dueInDays: number;
+                dueCondition: "after_booking" | "before_departure";
+            }[];
+            defaultSchedule: {
+                depositPercent: number | null;
+                balanceDueDaysBeforeDeparture: number | null;
+            } | null;
+            bankTransfer: {
+                dueDays: number | null;
+                account: {
+                    provider: string | null;
+                    currency: string | null;
+                    iban: string;
+                    beneficiary: string;
+                    bank: string;
+                } | null;
+                accountHolder: string | null;
+                bankName: string | null;
+                iban: string | null;
+                bic: string | null;
+                paymentReference: string | null;
+                instructions: string | null;
+            } | null;
+        };
+    } | null>;
+    getDeparture(db: PostgresJsDatabase, departureId: string): Promise<{
+        id: string;
+        productId: string;
+        itineraryId: string;
+        optionId: string | null;
+        dateLocal: string | null;
+        startAt: string | null;
+        endAt: string | null;
+        timezone: string;
+        startTime: {
+            id: string;
+            label: string | null;
+            startTimeLocal: string;
+            durationMinutes: number | null;
+        } | null;
+        meetingPoint: string | null;
+        capacity: number | null;
+        remaining: number | null;
+        departureStatus: "on_request" | import("./service-boundary-sql.js").StorefrontSlotStatus;
+        nights: number | null;
+        days: number | null;
+        ratePlans: {
+            id: string;
+            active: boolean;
+            name: string;
+            pricingModel: string;
+            basePrices: {
+                amount: number;
+                currencyCode: string;
+            }[];
+            roomPrices: {
+                amount: number;
+                currencyCode: string;
+                roomType: {
+                    id: string;
+                    name: string;
+                    occupancy: {
+                        adultsMin: number;
+                        adultsMax: number;
+                        childrenMax: number;
+                    };
+                };
+            }[];
+        }[];
+        resourceManifest: {
+            kinds: {
+                capacity: number;
+                assigned: number;
+                available: number;
+                kind: string;
+            }[];
+            resources: {
+                id: string;
+                kind: string;
+                label: string | null;
+                refType: string | null;
+                refId: string | null;
+                capacity: number;
+                assigned: number;
+                available: number;
+                parentId: string | null;
+                flags: Record<string, unknown>;
+            }[];
+        } | null;
+    } | null>;
+    listProductDepartures(db: PostgresJsDatabase, productId: string, query: StorefrontDepartureListQuery): Promise<{
+        data: {
+            id: string;
+            productId: string;
+            itineraryId: string;
+            optionId: string | null;
+            dateLocal: string | null;
+            startAt: string | null;
+            endAt: string | null;
+            timezone: string;
+            startTime: {
+                id: string;
+                label: string | null;
+                startTimeLocal: string;
+                durationMinutes: number | null;
+            } | null;
+            meetingPoint: string | null;
+            capacity: number | null;
+            remaining: number | null;
+            departureStatus: "on_request" | import("./service-boundary-sql.js").StorefrontSlotStatus;
+            nights: number | null;
+            days: number | null;
+            ratePlans: {
+                id: string;
+                active: boolean;
+                name: string;
+                pricingModel: string;
+                basePrices: {
+                    amount: number;
+                    currencyCode: string;
+                }[];
+                roomPrices: {
+                    amount: number;
+                    currencyCode: string;
+                    roomType: {
+                        id: string;
+                        name: string;
+                        occupancy: {
+                            adultsMin: number;
+                            adultsMax: number;
+                            childrenMax: number;
+                        };
+                    };
+                }[];
+            }[];
+            resourceManifest: {
+                kinds: {
+                    capacity: number;
+                    assigned: number;
+                    available: number;
+                    kind: string;
+                }[];
+                resources: {
+                    id: string;
+                    kind: string;
+                    label: string | null;
+                    refType: string | null;
+                    refId: string | null;
+                    capacity: number;
+                    assigned: number;
+                    available: number;
+                    parentId: string | null;
+                    flags: Record<string, unknown>;
+                }[];
+            } | null;
+        }[];
+        total: number;
+        limit: number;
+        offset: number;
+    }>;
+    previewDeparturePrice(db: PostgresJsDatabase, departureId: string, input: StorefrontDeparturePricePreviewInput, context?: StorefrontRequestContext): Promise<{
+        departureId: string;
+        productId: string;
+        optionId: string | null;
+        currencyCode: string;
+        basePrice: number;
+        taxAmount: number;
+        total: number;
+        notes: string | null;
+        lineItems: {
+            name: string;
+            total: number;
+            quantity: number;
+            unitPrice: number;
+        }[];
+        allocation: {
+            slot: {
+                id: string;
+                productId: string;
+                optionId: string | null;
+                dateLocal: string | null;
+                startAt: string | null;
+                endAt: string | null;
+                timezone: string;
+                status: "on_request" | import("./service-boundary-sql.js").StorefrontSlotStatus;
+                availabilityState: import("./service-departures-core.js").StorefrontProductAvailabilityState;
+                capacity: number | null;
+                remaining: number | null;
+                pastCutoff: boolean;
+                tooEarly: boolean;
+                resourceManifest: {
+                    kinds: {
+                        capacity: number;
+                        assigned: number;
+                        available: number;
+                        kind: string;
+                    }[];
+                    resources: {
+                        id: string;
+                        kind: string;
+                        label: string | null;
+                        refType: string | null;
+                        refId: string | null;
+                        capacity: number;
+                        assigned: number;
+                        available: number;
+                        parentId: string | null;
+                        flags: Record<string, unknown>;
+                    }[];
+                } | null;
+            };
+            pax: {
+                adults: number;
+                children: number;
+                infants: number;
+                total: number;
+            };
+            requestedUnits: {
+                unitId: string | null;
+                requestRef: string | null;
+                name: string;
+                unitType: string | null;
+                quantity: number;
+                pricingMode: string | null;
+                unitPrice: number;
+                total: number;
+                currencyCode: string;
+                tierId: string | null;
+            }[];
+            rooms: {
+                unitId: string;
+                name: string;
+                occupancy: number;
+                quantity: number;
+                pax: number;
+                pricingMode: string | null;
+                unitPrice: number;
+                total: number;
+                currencyCode: string;
+                tierId: string | null;
+            }[];
+        };
+        units: {
+            unitId: string | null;
+            requestRef: string | null;
+            name: string;
+            unitType: string | null;
+            quantity: number;
+            pricingMode: string | null;
+            unitPrice: number;
+            total: number;
+            currencyCode: string;
+            tierId: string | null;
+        }[];
+        rooms: {
+            unitId: string;
+            name: string;
+            occupancy: number;
+            quantity: number;
+            pax: number;
+            pricingMode: string | null;
+            unitPrice: number;
+            total: number;
+            currencyCode: string;
+            tierId: string | null;
+        }[];
+        extras: {
+            extraId: string;
+            name: string;
+            required: boolean;
+            selectable: boolean;
+            selected: boolean;
+            pricingMode: string;
+            quantity: number;
+            unitPrice: number;
+            total: number;
+            currencyCode: string;
+        }[];
+        offers: {
+            available: {
+                offer: {
+                    id: string;
+                    name: string;
+                    slug: string | null;
+                    description: string | null;
+                    discountType: "percentage" | "fixed_amount";
+                    discountValue: string;
+                    currency: string | null;
+                    applicableProductIds: string[];
+                    applicableDepartureIds: string[];
+                    validFrom: string | null;
+                    validTo: string | null;
+                    minTravelers: number | null;
+                    imageMobileUrl: string | null;
+                    imageDesktopUrl: string | null;
+                    stackable: boolean;
+                    createdAt: string;
+                    updatedAt: string;
+                };
+                status: string;
+                reason: string | null;
+                selected: boolean;
+                discountAppliedCents: number;
+                discountedPriceCents: number;
+            }[];
+            requested: ({
+                kind: "slug";
+                value: string;
+                result: {
+                    status: "applied" | "not_applicable" | "invalid" | "conflict";
+                    reason: "currency" | "scope" | "booking_mismatch" | "conflict" | "offer_not_found" | "offer_expired" | "offer_not_yet_valid" | "code_not_found" | "code_required" | "code_expired" | "code_not_yet_valid" | "min_pax" | "eligibility" | "no_discount" | "session_mismatch" | null;
+                    offer: {
+                        id: string;
+                        name: string;
+                        slug: string | null;
+                        description: string | null;
+                        discountType: "percentage" | "fixed_amount";
+                        discountValue: string;
+                        currency: string | null;
+                        applicableProductIds: string[];
+                        applicableDepartureIds: string[];
+                        validFrom: string | null;
+                        validTo: string | null;
+                        minTravelers: number | null;
+                        imageMobileUrl: string | null;
+                        imageDesktopUrl: string | null;
+                        stackable: boolean;
+                        createdAt: string;
+                        updatedAt: string;
+                    } | null;
+                    target: {
+                        bookingId: string | null;
+                        sessionId: string | null;
+                        productId: string;
+                        departureId: string | null;
+                    };
+                    pricing: {
+                        basePriceCents: number;
+                        currency: string;
+                        discountAppliedCents: number;
+                        discountedPriceCents: number;
+                    };
+                    appliedOffers: {
+                        offerId: string;
+                        offerName: string;
+                        discountAppliedCents: number;
+                        discountedPriceCents: number;
+                        currency: string;
+                        discountKind: "percentage" | "fixed_amount";
+                        discountPercent: number | null;
+                        discountAmountCents: number | null;
+                        appliedCode: string | null;
+                        stackable: boolean;
+                    }[];
+                    conflict: {
+                        policy: "best_discount_wins" | "stackable_compose";
+                        autoAppliedOfferIds: string[];
+                        manualOfferId: string | null;
+                        selectedOfferIds: string[];
+                        message: string;
+                    } | null;
+                } | null;
+            } | {
+                kind: "code";
+                value: string;
+                result: {
+                    status: "applied" | "not_applicable" | "invalid" | "conflict";
+                    reason: "currency" | "scope" | "booking_mismatch" | "conflict" | "offer_not_found" | "offer_expired" | "offer_not_yet_valid" | "code_not_found" | "code_required" | "code_expired" | "code_not_yet_valid" | "min_pax" | "eligibility" | "no_discount" | "session_mismatch" | null;
+                    offer: {
+                        id: string;
+                        name: string;
+                        slug: string | null;
+                        description: string | null;
+                        discountType: "percentage" | "fixed_amount";
+                        discountValue: string;
+                        currency: string | null;
+                        applicableProductIds: string[];
+                        applicableDepartureIds: string[];
+                        validFrom: string | null;
+                        validTo: string | null;
+                        minTravelers: number | null;
+                        imageMobileUrl: string | null;
+                        imageDesktopUrl: string | null;
+                        stackable: boolean;
+                        createdAt: string;
+                        updatedAt: string;
+                    } | null;
+                    target: {
+                        bookingId: string | null;
+                        sessionId: string | null;
+                        productId: string;
+                        departureId: string | null;
+                    };
+                    pricing: {
+                        basePriceCents: number;
+                        currency: string;
+                        discountAppliedCents: number;
+                        discountedPriceCents: number;
+                    };
+                    appliedOffers: {
+                        offerId: string;
+                        offerName: string;
+                        discountAppliedCents: number;
+                        discountedPriceCents: number;
+                        currency: string;
+                        discountKind: "percentage" | "fixed_amount";
+                        discountPercent: number | null;
+                        discountAmountCents: number | null;
+                        appliedCode: string | null;
+                        stackable: boolean;
+                    }[];
+                    conflict: {
+                        policy: "best_discount_wins" | "stackable_compose";
+                        autoAppliedOfferIds: string[];
+                        manualOfferId: string | null;
+                        selectedOfferIds: string[];
+                        message: string;
+                    } | null;
+                } | null;
+            })[];
+            applied: {
+                offerId: string;
+                offerName: string;
+                discountAppliedCents: number;
+                discountedPriceCents: number;
+                currency: string;
+                discountKind: "percentage" | "fixed_amount";
+                discountPercent: number | null;
+                discountAmountCents: number | null;
+                appliedCode: string | null;
+                stackable: boolean;
+            }[];
+            conflict: {
+                policy: "best_discount_wins" | "stackable_compose";
+                autoAppliedOfferIds: string[];
+                manualOfferId: string | null;
+                selectedOfferIds: string[];
+                message: string;
+            } | {
+                policy: string;
+                autoAppliedOfferIds: string[];
+                manualOfferId: null;
+                selectedOfferIds: string[];
+                message: string;
+            } | null;
+            discountTotal: number;
+            discountTotalCents: number;
+            totalAfterDiscount: number;
+            currencyCode: string;
+        };
+        totals: {
+            currencyCode: string;
+            base: number;
+            extras: number;
+            subtotal: number;
+            discount: number;
+            tax: number;
+            total: number;
+            perPerson: number;
+            perBooking: number;
+        };
+    } | null>;
+    getProductExtensions(db: PostgresJsDatabase, productId: string, optionId?: string): Promise<{
+        extensions: {
+            id: string;
+            name: string;
+            label: string;
+            required: boolean;
+            selectable: boolean;
+            hasOptions: boolean;
+            refProductId: string | null;
+            thumb: string | null;
+            pricePerPerson: number | null;
+            currencyCode: string;
+            pricingMode: string;
+            defaultQuantity: number | null;
+            minQuantity: number | null;
+            maxQuantity: number | null;
+        }[];
+        items: {
+            id: string;
+            name: string;
+            label: string;
+            required: boolean;
+            selectable: boolean;
+            hasOptions: boolean;
+            refProductId: string | null;
+            thumb: string | null;
+            pricePerPerson: number | null;
+            currencyCode: string;
+            pricingMode: string;
+            defaultQuantity: number | null;
+            minQuantity: number | null;
+            maxQuantity: number | null;
+        }[];
+        details: {
+            [k: string]: {
+                description: string | null;
+                media: {
+                    url: string;
+                    alt: string | null;
+                }[];
+            };
+        };
+        currencyCode: string;
+    }>;
+    getProductAvailabilitySummary(db: PostgresJsDatabase, productId: string, query: StorefrontProductAvailabilitySummaryQuery): Promise<{
+        productId: string;
+        availabilityState: import("./service-departures-core.js").StorefrontProductAvailabilityState;
+        counts: {
+            total: number;
+            open: number;
+            closed: number;
+            soldOut: number;
+            cancelled: number;
+            onRequest: number;
+            pastCutoff: number;
+            tooEarly: number;
+            available: number;
+        };
+        departures: {
+            id: string;
+            productId: string;
+            optionId: string | null;
+            dateLocal: string | null;
+            startAt: string | null;
+            endAt: string | null;
+            timezone: string;
+            status: "on_request" | import("./service-boundary-sql.js").StorefrontSlotStatus;
+            availabilityState: import("./service-departures-core.js").StorefrontProductAvailabilityState;
+            capacity: number | null;
+            remaining: number | null;
+            pastCutoff: boolean;
+            tooEarly: boolean;
+        }[];
+        total: number;
+        limit: number;
+        offset: number;
+    }>;
+    getDepartureItinerary(db: PostgresJsDatabase, input: {
+        departureId: string;
+        productId: string;
+    }): Promise<{
+        id: string;
+        itineraryId: string;
+        days: {
+            id: string;
+            title: string;
+            description: string | null;
+            thumbnail: {
+                url: string;
+            } | null;
+            segments: {
+                id: string;
+                title: string;
+                description: string | null;
+            }[];
+        }[];
+    } | null>;
+    checkDepartureTransportEligibility(input: {
+        departureId: string;
+        productId?: string | null;
+        body: StorefrontTransportEligibilityInput;
+        context?: StorefrontRequestContext;
+    }): Promise<StorefrontTransportEligibilityResult>;
+    bootstrapBookingSession(context: StorefrontRequestContext & {
+        db: PostgresJsDatabase;
+    }, input: StorefrontBookingSessionBootstrapInput, 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: "draft" | "confirmed" | "cancelled" | "on_hold" | "awaiting_payment" | "in_progress" | "completed" | "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: "other" | "adult" | "child" | "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" | "unit" | "other" | "extra" | "fee" | "tax" | "discount" | "adjustment" | "accommodation" | "transport";
+                    status: "draft" | "confirmed" | "cancelled" | "fulfilled" | "on_hold" | "expired";
+                    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: "unit" | "pickup" | "resource";
+                    status: "confirmed" | "cancelled" | "fulfilled" | "expired" | "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("@voyant-travel/finance").DepositKind;
+                depositPercent: number | null;
+                depositAmountCents: number | null;
+                requiresFullPayment: boolean;
+            };
+            paymentSchedule: {
+                id: string;
+                scheduleType: "other" | "deposit" | "installment" | "balance" | "hold";
+                status: "pending" | "cancelled" | "waived" | "expired" | "paid" | "due";
+                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 | Date;
+                startsAt: string | null;
+                endsAt: string | null;
+                timezone: string;
+                status: import("./service-boundary-sql.js").StorefrontSlotStatus;
+                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: "unit" | "pickup" | "resource";
+                status: "confirmed" | "cancelled" | "fulfilled" | "expired" | "held" | "released";
+                holdExpiresAt: string | null;
+                confirmedAt: string | null;
+                releasedAt: string | null;
+            }[];
+            currency: string;
+        };
+        repricing?: undefined;
+    }>;
+    listApplicableOffers(input: {
+        productId: string;
+        departureId?: string;
+        locale?: string;
+        context?: StorefrontRequestContext;
+    }): Promise<StorefrontPromotionalOffer[]>;
+    getOfferBySlug(input: {
+        slug: string;
+        locale?: string;
+        context?: StorefrontRequestContext;
+    }): Promise<StorefrontPromotionalOffer | null>;
+    applyOffer(input: {
+        slug: string;
+        body: StorefrontOfferApplyInput;
+        context?: StorefrontRequestContext;
+    }): Promise<StorefrontOfferMutationResult | null>;
+    redeemOffer(input: {
+        body: StorefrontOfferRedeemInput;
+        context?: StorefrontRequestContext;
+    }): Promise<StorefrontOfferMutationResult | null>;
+    checkIntakeGuard: (input: {
+        kind: "lead";
+        body: StorefrontLeadIntakeInput;
+        context: StorefrontRequestContext;
+    } | {
+        kind: "newsletter";
+        body: StorefrontNewsletterSubscribeInput;
+        context: StorefrontRequestContext;
+    }) => Promise<import("./service-intake.js").StorefrontIntakeGuardDecision | undefined>;
+    createLead(input: {
+        body: StorefrontLeadIntakeInput;
+        context: StorefrontRequestContext;
+    }): Promise<{
+        id: string;
+        personId: string;
+        kind: "notify" | "wishlist" | "inquiry" | "request_offer" | "referral";
+        source: "admin" | "phone" | "booking" | "form" | "website" | "abandoned_cart";
+        status: "expired" | "lost" | "new" | "contacted" | "qualified" | "converted";
+        duplicate: boolean;
+    }>;
+    subscribeNewsletter(input: {
+        body: StorefrontNewsletterSubscribeInput;
+        context: StorefrontRequestContext;
+    }): Promise<{
+        id: string;
+        personId: string;
+        kind: "notify" | "wishlist" | "inquiry" | "request_offer" | "referral";
+        source: "admin" | "phone" | "booking" | "form" | "website" | "abandoned_cart";
+        status: "expired" | "lost" | "new" | "contacted" | "qualified" | "converted";
+        duplicate: boolean;
+        doubleOptIn: "requested" | "not_configured";
+    }>;
+};
+export type { StorefrontCustomerSignalCreatedEvent, StorefrontIntakeGuard, StorefrontIntakeOptions, StorefrontIntakePersistence, StorefrontIntakePersistenceResolver, StorefrontIntakePerson, StorefrontIntakeSignal, };
+//# sourceMappingURL=service.d.ts.map