@voyantjs/storefront-sdk 0.34.0 → 0.37.0

package/README.md

@@ -29,5 +29,29 @@ const session = await voyant.booking.createSession({
 const state = voyant.booking.deriveState(session)
 ```
 
+For custom booking engines, prefer the `bookingEngine` facade. It keeps the
+route-shaped public booking and checkout calls behind flow-oriented methods and
+returns a canonical engine snapshot alongside session reads and mutations.
+
+```ts
+const booking = await voyant.bookingEngine.reserve({
+  sellCurrency: "EUR",
+  items: [
+    {
+      title: "Danube tour",
+      availabilitySlotId: "slot_123",
+      quantity: 2,
+      totalSellAmountCents: 24000,
+    },
+  ],
+})
+
+if (voyant.bookingEngine.canRunAction(booking.engine.state, "start_payment")) {
+  await voyant.bookingEngine.startPayment(booking.session.sessionId, {
+    method: "card",
+  })
+}
+```
+
 React consumers should layer React Query hooks on top of this package rather
 than reimplementing request paths directly.

package/dist/booking-engine.d.ts

@@ -0,0 +1,420 @@
+import type { StorefrontRequestOptions, VoyantStorefrontClientOptions } from "./client.js";
+import { type BookingEngineSnapshot } from "./engine-state.js";
+import { repricePublicBookingSession } from "./operations.js";
+import type { BootstrapCheckoutCollectionInput, InitiateCheckoutCollectionInput, PreviewCheckoutCollectionInput, PublicBookingOverviewLookupQuery, PublicBookingSessionMutationInput, PublicBookingSessionRecord, PublicBookingSessionRepriceInput, PublicCreateBookingSessionInput, PublicUpdateBookingSessionInput, PublicUpsertBookingSessionStateInput } from "./schemas.js";
+type ResolvedClientOptions = Required<Pick<VoyantStorefrontClientOptions, "baseUrl" | "fetcher">> & Pick<VoyantStorefrontClientOptions, "headers">;
+export interface BookingEngineSessionSnapshot {
+    session: PublicBookingSessionRecord;
+    engine: BookingEngineSnapshot;
+}
+export interface BookingEngineRepriceResult {
+    pricing: Awaited<ReturnType<typeof repricePublicBookingSession>>["pricing"];
+    session: BookingEngineSessionSnapshot | null;
+}
+export type BookingEngineTravelerUpdateInput = Pick<PublicUpdateBookingSessionInput, "travelers" | "removedTravelerIds" | "pax">;
+export declare function createBookingEngineSessionSnapshot(session: PublicBookingSessionRecord): BookingEngineSessionSnapshot;
+export declare function reserveBookingEngineSession(client: ResolvedClientOptions, input: PublicCreateBookingSessionInput, options?: StorefrontRequestOptions): Promise<BookingEngineSessionSnapshot>;
+export declare function getBookingEngineSessionSnapshot(client: ResolvedClientOptions, sessionId: string): Promise<BookingEngineSessionSnapshot>;
+export declare function updateBookingEngineSession(client: ResolvedClientOptions, sessionId: string, input: PublicUpdateBookingSessionInput, options?: StorefrontRequestOptions): Promise<BookingEngineSessionSnapshot>;
+export declare function updateBookingEngineTravelers(client: ResolvedClientOptions, sessionId: string, input: BookingEngineTravelerUpdateInput, options?: StorefrontRequestOptions): Promise<BookingEngineSessionSnapshot>;
+export declare function getBookingEngineProgress(client: ResolvedClientOptions, sessionId: string): Promise<{
+    sessionId: string;
+    stateKey: "wizard";
+    currentStep: string | null;
+    completedSteps: string[];
+    payload: Record<string, unknown>;
+    version: number;
+    createdAt: string;
+    updatedAt: string;
+}>;
+export declare function updateBookingEngineProgress(client: ResolvedClientOptions, sessionId: string, input: PublicUpsertBookingSessionStateInput, options?: StorefrontRequestOptions): Promise<{
+    sessionId: string;
+    stateKey: "wizard";
+    currentStep: string | null;
+    completedSteps: string[];
+    payload: Record<string, unknown>;
+    version: number;
+    createdAt: string;
+    updatedAt: string;
+}>;
+export declare function repriceBookingEngineSession(client: ResolvedClientOptions, sessionId: string, input: PublicBookingSessionRepriceInput, options?: StorefrontRequestOptions): Promise<BookingEngineRepriceResult>;
+export declare function confirmBookingEngineSession(client: ResolvedClientOptions, sessionId: string, input?: PublicBookingSessionMutationInput, options?: StorefrontRequestOptions): Promise<BookingEngineSessionSnapshot>;
+export declare function expireBookingEngineSession(client: ResolvedClientOptions, sessionId: string, input?: PublicBookingSessionMutationInput, options?: StorefrontRequestOptions): Promise<BookingEngineSessionSnapshot>;
+export declare function getBookingEngineOverview(client: ResolvedClientOptions, query: PublicBookingOverviewLookupQuery): Promise<{
+    bookingId: string;
+    bookingNumber: string;
+    status: "draft" | "on_hold" | "awaiting_payment" | "confirmed" | "in_progress" | "completed" | "expired" | "cancelled";
+    sellCurrency: string;
+    sellAmountCents: number | null;
+    startDate: string | null;
+    endDate: string | null;
+    pax: number | null;
+    confirmedAt: string | null;
+    cancelledAt: string | null;
+    completedAt: string | null;
+    travelers: {
+        id: string;
+        participantType: "traveler" | "occupant" | "other";
+        firstName: string;
+        lastName: string;
+        isPrimary: boolean;
+    }[];
+    items: {
+        id: string;
+        title: string;
+        description: string | null;
+        itemType: "other" | "unit" | "extra" | "service" | "fee" | "tax" | "discount" | "adjustment" | "accommodation" | "transport";
+        status: "draft" | "on_hold" | "confirmed" | "expired" | "cancelled" | "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: "traveler" | "occupant" | "other" | "beneficiary";
+            isPrimary: boolean;
+        }[];
+    }[];
+    documents: {
+        id: string;
+        travelerId: string | null;
+        type: "other" | "visa" | "insurance" | "health" | "passport_copy";
+        fileName: string;
+        fileUrl: string;
+    }[];
+    fulfillments: {
+        id: string;
+        bookingItemId: string | null;
+        travelerId: string | null;
+        fulfillmentType: "other" | "voucher" | "ticket" | "pdf" | "qr_code" | "barcode" | "mobile";
+        deliveryChannel: "other" | "download" | "email" | "api" | "wallet";
+        status: "pending" | "issued" | "reissued" | "revoked" | "failed";
+        artifactUrl: string | null;
+    }[];
+}>;
+export declare function previewBookingEnginePayment(client: ResolvedClientOptions, bookingId: string, input: PreviewCheckoutCollectionInput, options?: StorefrontRequestOptions): Promise<{
+    bookingId: string;
+    method: "bank_transfer" | "card";
+    stage: "manual" | "initial" | "reminder";
+    paymentSessionTarget: "schedule" | "invoice" | null;
+    documentType: "invoice" | "proforma" | null;
+    willCreateDefaultPaymentPlan: boolean;
+    selectedSchedule: {
+        id: string;
+        bookingId: string;
+        bookingItemId: string | null;
+        scheduleType: string;
+        status: string;
+        dueDate: string;
+        currency: string;
+        amountCents: number;
+        notes: string | null;
+    } | null;
+    selectedInvoice: {
+        id: string;
+        invoiceNumber: string;
+        invoiceType: string;
+        bookingId: string;
+        personId: string | null;
+        organizationId: string | null;
+        status: string;
+        currency: string;
+        totalCents: number;
+        paidCents: number;
+        balanceDueCents: number;
+        issueDate: string;
+        dueDate: string;
+        notes: string | null;
+        createdAt: string;
+        updatedAt: string;
+    } | null;
+    amountCents: number;
+    currency: string;
+    recommendedAction: "none" | "create_bank_transfer_document" | "create_payment_session" | "create_invoice_then_payment_session";
+}>;
+export declare function startBookingEnginePayment(client: ResolvedClientOptions, bookingId: string, input: InitiateCheckoutCollectionInput, options?: StorefrontRequestOptions): Promise<{
+    plan: {
+        bookingId: string;
+        method: "bank_transfer" | "card";
+        stage: "manual" | "initial" | "reminder";
+        paymentSessionTarget: "schedule" | "invoice" | null;
+        documentType: "invoice" | "proforma" | null;
+        willCreateDefaultPaymentPlan: boolean;
+        selectedSchedule: {
+            id: string;
+            bookingId: string;
+            bookingItemId: string | null;
+            scheduleType: string;
+            status: string;
+            dueDate: string;
+            currency: string;
+            amountCents: number;
+            notes: string | null;
+        } | null;
+        selectedInvoice: {
+            id: string;
+            invoiceNumber: string;
+            invoiceType: string;
+            bookingId: string;
+            personId: string | null;
+            organizationId: string | null;
+            status: string;
+            currency: string;
+            totalCents: number;
+            paidCents: number;
+            balanceDueCents: number;
+            issueDate: string;
+            dueDate: string;
+            notes: string | null;
+            createdAt: string;
+            updatedAt: string;
+        } | null;
+        amountCents: number;
+        currency: string;
+        recommendedAction: "none" | "create_bank_transfer_document" | "create_payment_session" | "create_invoice_then_payment_session";
+    };
+    invoice: {
+        id: string;
+        invoiceNumber: string;
+        invoiceType: string;
+        bookingId: string;
+        personId: string | null;
+        organizationId: string | null;
+        status: string;
+        currency: string;
+        totalCents: number;
+        paidCents: number;
+        balanceDueCents: number;
+        issueDate: string;
+        dueDate: string;
+        notes: string | null;
+        createdAt: string;
+        updatedAt: string;
+    } | null;
+    paymentSession: {
+        id: string;
+        targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
+        targetId: string | null;
+        bookingId: string | null;
+        invoiceId: string | null;
+        bookingPaymentScheduleId: string | null;
+        bookingGuaranteeId: string | null;
+        status: "expired" | "cancelled" | "pending" | "failed" | "paid" | "requires_redirect" | "processing" | "authorized";
+        provider: string | null;
+        providerSessionId: string | null;
+        providerPaymentId: string | null;
+        externalReference: string | null;
+        clientReference: string | null;
+        currency: string;
+        amountCents: number;
+        paymentMethod: "other" | "voucher" | "wallet" | "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "direct_bill" | null;
+        payerEmail: string | null;
+        payerName: string | null;
+        redirectUrl: string | null;
+        returnUrl: string | null;
+        cancelUrl: string | null;
+        expiresAt: string | null;
+        completedAt: string | null;
+        failureCode: string | null;
+        failureMessage: string | null;
+        notes: string | null;
+    } | null;
+    invoiceNotification: {
+        id: string;
+        templateSlug: string | null;
+        channel: "email" | "sms";
+        provider: string;
+        status: "cancelled" | "pending" | "failed" | "sent";
+        toAddress: string;
+        subject: string | null;
+        sentAt: string | null;
+        failedAt: string | null;
+        errorMessage: string | null;
+    } | null;
+    paymentSessionNotification: {
+        id: string;
+        templateSlug: string | null;
+        channel: "email" | "sms";
+        provider: string;
+        status: "cancelled" | "pending" | "failed" | "sent";
+        toAddress: string;
+        subject: string | null;
+        sentAt: string | null;
+        failedAt: string | null;
+        errorMessage: string | null;
+    } | null;
+    bankTransferInstructions: {
+        provider: string | null;
+        invoiceId: string;
+        invoiceNumber: string;
+        documentType: "invoice" | "proforma";
+        amountCents: number;
+        currency: string;
+        dueDate: string | null;
+        beneficiary: string;
+        iban: string;
+        bankName: string | null;
+        notes: string | null;
+    } | null;
+    providerStart: {
+        provider: string;
+        paymentSessionId: string;
+        redirectUrl: string | null;
+        externalReference: string | null;
+        providerSessionId: string | null;
+        providerPaymentId: string | null;
+        response: Record<string, unknown> | null;
+    } | null;
+}>;
+export declare function bootstrapBookingEnginePayment(client: ResolvedClientOptions, input: BootstrapCheckoutCollectionInput, options?: StorefrontRequestOptions): Promise<{
+    plan: {
+        bookingId: string;
+        method: "bank_transfer" | "card";
+        stage: "manual" | "initial" | "reminder";
+        paymentSessionTarget: "schedule" | "invoice" | null;
+        documentType: "invoice" | "proforma" | null;
+        willCreateDefaultPaymentPlan: boolean;
+        selectedSchedule: {
+            id: string;
+            bookingId: string;
+            bookingItemId: string | null;
+            scheduleType: string;
+            status: string;
+            dueDate: string;
+            currency: string;
+            amountCents: number;
+            notes: string | null;
+        } | null;
+        selectedInvoice: {
+            id: string;
+            invoiceNumber: string;
+            invoiceType: string;
+            bookingId: string;
+            personId: string | null;
+            organizationId: string | null;
+            status: string;
+            currency: string;
+            totalCents: number;
+            paidCents: number;
+            balanceDueCents: number;
+            issueDate: string;
+            dueDate: string;
+            notes: string | null;
+            createdAt: string;
+            updatedAt: string;
+        } | null;
+        amountCents: number;
+        currency: string;
+        recommendedAction: "none" | "create_bank_transfer_document" | "create_payment_session" | "create_invoice_then_payment_session";
+    };
+    invoice: {
+        id: string;
+        invoiceNumber: string;
+        invoiceType: string;
+        bookingId: string;
+        personId: string | null;
+        organizationId: string | null;
+        status: string;
+        currency: string;
+        totalCents: number;
+        paidCents: number;
+        balanceDueCents: number;
+        issueDate: string;
+        dueDate: string;
+        notes: string | null;
+        createdAt: string;
+        updatedAt: string;
+    } | null;
+    paymentSession: {
+        id: string;
+        targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
+        targetId: string | null;
+        bookingId: string | null;
+        invoiceId: string | null;
+        bookingPaymentScheduleId: string | null;
+        bookingGuaranteeId: string | null;
+        status: "expired" | "cancelled" | "pending" | "failed" | "paid" | "requires_redirect" | "processing" | "authorized";
+        provider: string | null;
+        providerSessionId: string | null;
+        providerPaymentId: string | null;
+        externalReference: string | null;
+        clientReference: string | null;
+        currency: string;
+        amountCents: number;
+        paymentMethod: "other" | "voucher" | "wallet" | "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "direct_bill" | null;
+        payerEmail: string | null;
+        payerName: string | null;
+        redirectUrl: string | null;
+        returnUrl: string | null;
+        cancelUrl: string | null;
+        expiresAt: string | null;
+        completedAt: string | null;
+        failureCode: string | null;
+        failureMessage: string | null;
+        notes: string | null;
+    } | null;
+    invoiceNotification: {
+        id: string;
+        templateSlug: string | null;
+        channel: "email" | "sms";
+        provider: string;
+        status: "cancelled" | "pending" | "failed" | "sent";
+        toAddress: string;
+        subject: string | null;
+        sentAt: string | null;
+        failedAt: string | null;
+        errorMessage: string | null;
+    } | null;
+    paymentSessionNotification: {
+        id: string;
+        templateSlug: string | null;
+        channel: "email" | "sms";
+        provider: string;
+        status: "cancelled" | "pending" | "failed" | "sent";
+        toAddress: string;
+        subject: string | null;
+        sentAt: string | null;
+        failedAt: string | null;
+        errorMessage: string | null;
+    } | null;
+    bankTransferInstructions: {
+        provider: string | null;
+        invoiceId: string;
+        invoiceNumber: string;
+        documentType: "invoice" | "proforma";
+        amountCents: number;
+        currency: string;
+        dueDate: string | null;
+        beneficiary: string;
+        iban: string;
+        bankName: string | null;
+        notes: string | null;
+    } | null;
+    providerStart: {
+        provider: string;
+        paymentSessionId: string;
+        redirectUrl: string | null;
+        externalReference: string | null;
+        providerSessionId: string | null;
+        providerPaymentId: string | null;
+        response: Record<string, unknown> | null;
+    } | null;
+    bookingId: string;
+    sessionId: string;
+    sourceType: "session" | "booking";
+    intent: "custom" | "deposit" | "balance";
+}>;
+export {};
+//# sourceMappingURL=booking-engine.d.ts.map

package/dist/booking-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"booking-engine.d.ts","sourceRoot":"","sources":["../src/booking-engine.ts"],"names":[],"mappings":"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"}

package/dist/booking-engine.js

@@ -0,0 +1,56 @@
+import { createBookingEngineSnapshot } from "./engine-state.js";
+import { bootstrapCheckoutCollection, confirmPublicBookingSession, createPublicBookingSession, expirePublicBookingSession, getPublicBookingOverview, getPublicBookingSession, getPublicBookingSessionState, initiateCheckoutCollection, previewCheckoutCollection, repricePublicBookingSession, updatePublicBookingSession, updatePublicBookingSessionState, } from "./operations.js";
+export function createBookingEngineSessionSnapshot(session) {
+    return {
+        session,
+        engine: createBookingEngineSnapshot(session),
+    };
+}
+export async function reserveBookingEngineSession(client, input, options) {
+    const session = await createPublicBookingSession(client, input, options);
+    return createBookingEngineSessionSnapshot(session);
+}
+export async function getBookingEngineSessionSnapshot(client, sessionId) {
+    const session = await getPublicBookingSession(client, sessionId);
+    return createBookingEngineSessionSnapshot(session);
+}
+export async function updateBookingEngineSession(client, sessionId, input, options) {
+    const session = await updatePublicBookingSession(client, sessionId, input, options);
+    return createBookingEngineSessionSnapshot(session);
+}
+export function updateBookingEngineTravelers(client, sessionId, input, options) {
+    return updateBookingEngineSession(client, sessionId, input, options);
+}
+export function getBookingEngineProgress(client, sessionId) {
+    return getPublicBookingSessionState(client, sessionId);
+}
+export function updateBookingEngineProgress(client, sessionId, input, options) {
+    return updatePublicBookingSessionState(client, sessionId, input, options);
+}
+export async function repriceBookingEngineSession(client, sessionId, input, options) {
+    const result = await repricePublicBookingSession(client, sessionId, input, options);
+    return {
+        pricing: result.pricing,
+        session: result.session ? createBookingEngineSessionSnapshot(result.session) : null,
+    };
+}
+export async function confirmBookingEngineSession(client, sessionId, input = {}, options) {
+    const session = await confirmPublicBookingSession(client, sessionId, input, options);
+    return createBookingEngineSessionSnapshot(session);
+}
+export async function expireBookingEngineSession(client, sessionId, input = {}, options) {
+    const session = await expirePublicBookingSession(client, sessionId, input, options);
+    return createBookingEngineSessionSnapshot(session);
+}
+export function getBookingEngineOverview(client, query) {
+    return getPublicBookingOverview(client, query);
+}
+export function previewBookingEnginePayment(client, bookingId, input, options) {
+    return previewCheckoutCollection(client, bookingId, input, options);
+}
+export function startBookingEnginePayment(client, bookingId, input, options) {
+    return initiateCheckoutCollection(client, bookingId, input, options);
+}
+export function bootstrapBookingEnginePayment(client, input, options) {
+    return bootstrapCheckoutCollection(client, input, options);
+}

package/dist/client.d.ts

@@ -1,10 +1,12 @@
 import type { z } from "zod";
+import { type StorefrontApiErrorEnvelope } from "./errors.js";
 export type VoyantStorefrontFetcher = (url: string, init?: RequestInit) => Promise<Response>;
 export declare const defaultStorefrontFetcher: VoyantStorefrontFetcher;
 export declare class VoyantStorefrontApiError extends Error {
     readonly status: number;
     readonly body: unknown;
-    constructor(message: string, status: number, body: unknown);
+    readonly normalizedError: StorefrontApiErrorEnvelope | null;
+    constructor(message: string, status: number, body: unknown, normalizedError?: StorefrontApiErrorEnvelope | null);
 }
 export interface VoyantStorefrontClientOptions {
     baseUrl: string;

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B,MAAM,MAAM,uBAAuB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAE5F,eAAO,MAAM,wBAAwB,EAAE,uBACU,CAAA;AAEjD,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;gBAEV,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;CAM3D;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,uBAAuB,CAAA;IACjC,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,MAAM,yBAAyB,GACjC,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;AAEpC,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAwB9E;AAED,wBAAsB,6BAA6B,CAAC,IAAI,EACtD,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EACvB,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,6BAA6B,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC,GAC3E,IAAI,CAAC,6BAA6B,EAAE,SAAS,CAAC,EAChD,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,WAAW,GAAG,SAAS,CAU1F"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B,OAAO,EAAmC,KAAK,0BAA0B,EAAE,MAAM,aAAa,CAAA;AAE9F,MAAM,MAAM,uBAAuB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAE5F,eAAO,MAAM,wBAAwB,EAAE,uBACU,CAAA;AAEjD,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,eAAe,EAAE,0BAA0B,GAAG,IAAI,CAAA;gBAGzD,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,eAAe,GAAE,0BAA0B,GAAG,IAA4C;CAQ7F;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,uBAAuB,CAAA;IACjC,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,MAAM,yBAAyB,GACjC,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;AAEpC,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAwB9E;AAED,wBAAsB,6BAA6B,CAAC,IAAI,EACtD,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EACvB,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,6BAA6B,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC,GAC3E,IAAI,CAAC,6BAA6B,EAAE,SAAS,CAAC,EAChD,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,WAAW,GAAG,SAAS,CAU1F"}

package/dist/client.js

@@ -1,12 +1,15 @@
+import { parseStorefrontApiErrorEnvelope } from "./errors.js";
 export const defaultStorefrontFetcher = (url, init) => fetch(url, { credentials: "include", ...init });
 export class VoyantStorefrontApiError extends Error {
     status;
     body;
-    constructor(message, status, body) {
+    normalizedError;
+    constructor(message, status, body, normalizedError = parseStorefrontApiErrorEnvelope(body)) {
         super(message);
         this.name = "VoyantStorefrontApiError";
         this.status = status;
         this.body = body;
+        this.normalizedError = normalizedError;
     }
 }
 export function withStorefrontQueryParams(path, query) {
@@ -64,6 +67,9 @@ export function requestHeaders(options) {
     return headers;
 }
 function extractErrorMessage(status, statusText, body) {
+    const normalizedError = parseStorefrontApiErrorEnvelope(body);
+    if (normalizedError)
+        return normalizedError.message;
     if (typeof body === "object" && body !== null && "error" in body) {
         const err = body.error;
         if (typeof err === "string")

package/dist/errors.d.ts

@@ -0,0 +1,41 @@
+import { z } from "zod";
+export declare const bookingEngineErrorCodes: readonly ["contract_template_missing", "reservation_expired", "departure_unavailable", "invalid_traveler_payload", "payment_provider_unavailable", "payment_url_missing", "payment_webhook_pending", "checkout_finalization_failed"];
+export type BookingEngineErrorCode = (typeof bookingEngineErrorCodes)[number];
+export declare const bookingEngineNextActions: readonly ["configure_contract_template", "restart_reservation", "choose_another_departure", "correct_traveler_payload", "choose_another_payment_method", "retry_payment_start", "poll_payment_status", "contact_operator"];
+export type BookingEngineNextAction = (typeof bookingEngineNextActions)[number];
+export declare const storefrontApiErrorEnvelopeSchema: z.ZodObject<{
+    code: z.ZodOptional<z.ZodString>;
+    message: z.ZodString;
+    recoverable: z.ZodOptional<z.ZodBoolean>;
+    nextAction: z.ZodOptional<z.ZodString>;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const bookingEngineErrorEnvelopeSchema: z.ZodObject<{
+    message: z.ZodString;
+    recoverable: z.ZodOptional<z.ZodBoolean>;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    code: z.ZodEnum<{
+        contract_template_missing: "contract_template_missing";
+        reservation_expired: "reservation_expired";
+        departure_unavailable: "departure_unavailable";
+        invalid_traveler_payload: "invalid_traveler_payload";
+        payment_provider_unavailable: "payment_provider_unavailable";
+        payment_url_missing: "payment_url_missing";
+        payment_webhook_pending: "payment_webhook_pending";
+        checkout_finalization_failed: "checkout_finalization_failed";
+    }>;
+    nextAction: z.ZodOptional<z.ZodEnum<{
+        configure_contract_template: "configure_contract_template";
+        restart_reservation: "restart_reservation";
+        choose_another_departure: "choose_another_departure";
+        correct_traveler_payload: "correct_traveler_payload";
+        choose_another_payment_method: "choose_another_payment_method";
+        retry_payment_start: "retry_payment_start";
+        poll_payment_status: "poll_payment_status";
+        contact_operator: "contact_operator";
+    }>>;
+}, z.core.$strip>;
+export type StorefrontApiErrorEnvelope = z.infer<typeof storefrontApiErrorEnvelopeSchema>;
+export type BookingEngineErrorEnvelope = z.infer<typeof bookingEngineErrorEnvelopeSchema>;
+export declare function parseStorefrontApiErrorEnvelope(body: unknown): StorefrontApiErrorEnvelope | null;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,uBAAuB,sOAS1B,CAAA;AAEV,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE7E,eAAO,MAAM,wBAAwB,4NAS3B,CAAA;AAEV,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/E,eAAO,MAAM,gCAAgC;;;;;;iBAM3C,CAAA;AAEF,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;iBAG3C,CAAA;AAEF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAA;AACzF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAA;AAEzF,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,OAAO,GAAG,0BAA0B,GAAG,IAAI,CAqBhG"}

package/dist/errors.js

@@ -0,0 +1,50 @@
+import { z } from "zod";
+export const bookingEngineErrorCodes = [
+    "contract_template_missing",
+    "reservation_expired",
+    "departure_unavailable",
+    "invalid_traveler_payload",
+    "payment_provider_unavailable",
+    "payment_url_missing",
+    "payment_webhook_pending",
+    "checkout_finalization_failed",
+];
+export const bookingEngineNextActions = [
+    "configure_contract_template",
+    "restart_reservation",
+    "choose_another_departure",
+    "correct_traveler_payload",
+    "choose_another_payment_method",
+    "retry_payment_start",
+    "poll_payment_status",
+    "contact_operator",
+];
+export const storefrontApiErrorEnvelopeSchema = z.object({
+    code: z.string().optional(),
+    message: z.string(),
+    recoverable: z.boolean().optional(),
+    nextAction: z.string().optional(),
+    details: z.record(z.string(), z.unknown()).optional(),
+});
+export const bookingEngineErrorEnvelopeSchema = storefrontApiErrorEnvelopeSchema.extend({
+    code: z.enum(bookingEngineErrorCodes),
+    nextAction: z.enum(bookingEngineNextActions).optional(),
+});
+export function parseStorefrontApiErrorEnvelope(body) {
+    const direct = storefrontApiErrorEnvelopeSchema.safeParse(body);
+    if (direct.success) {
+        return direct.data;
+    }
+    if (typeof body !== "object" || body === null || !("error" in body)) {
+        return null;
+    }
+    const error = body.error;
+    if (typeof error === "string") {
+        const code = typeof body.code === "string"
+            ? body.code
+            : undefined;
+        return { code, message: error };
+    }
+    const nested = storefrontApiErrorEnvelopeSchema.safeParse(error);
+    return nested.success ? nested.data : null;
+}

package/dist/index.d.ts

@@ -1,10 +1,13 @@
+import { bootstrapBookingEnginePayment, confirmBookingEngineSession, expireBookingEngineSession, getBookingEngineOverview, previewBookingEnginePayment, repriceBookingEngineSession, reserveBookingEngineSession, startBookingEnginePayment, updateBookingEngineProgress, updateBookingEngineSession, updateBookingEngineTravelers } from "./booking-engine.js";
 import { type VoyantStorefrontClientOptions } from "./client.js";
 import { canRunBookingEngineAction, createBookingEngineSnapshot, deriveBookingEngineState } from "./engine-state.js";
 import { bootstrapCheckoutCollection, confirmPublicBookingSession, createPublicBookingSession, expirePublicBookingSession, getPublicBookingOverview, getStorefrontOfferBySlug, getStorefrontProductAvailability, initiateCheckoutCollection, listStorefrontProductDepartures, listStorefrontProductExtensions, listStorefrontProductOffers, previewCheckoutCollection, previewStorefrontDeparturePrice, repricePublicBookingSession, updatePublicBookingSession, updatePublicBookingSessionState } from "./operations.js";
+export * from "./booking-engine.js";
 export type { StorefrontQueryParamValue, StorefrontRequestOptions, VoyantStorefrontClientOptions, VoyantStorefrontFetcher, } from "./client.js";
 export { defaultStorefrontFetcher, storefrontFetchWithValidation, VoyantStorefrontApiError, withStorefrontQueryParams, } from "./client.js";
 export type { BookingEngineAction, BookingEngineSnapshot, BookingEngineState, } from "./engine-state.js";
 export { bookingEngineActions, bookingEngineStates, canRunBookingEngineAction, createBookingEngineSnapshot, deriveBookingEngineState, getAllowedBookingEngineActions, } from "./engine-state.js";
+export * from "./errors.js";
 export * from "./operations.js";
 export * from "./schemas.js";
 export declare function createVoyantStorefrontClient(options: VoyantStorefrontClientOptions): {
@@ -28,7 +31,7 @@ export declare function createVoyantStorefrontClient(options: VoyantStorefrontCl
                     fields: {
                         key: string;
                         label: string;
-                        type: "email" | "date" | "text" | "select" | "country" | "tel" | "textarea" | "checkbox";
+                        type: "date" | "email" | "text" | "select" | "country" | "tel" | "textarea" | "checkbox";
                         required: boolean;
                         placeholder: string | null;
                         description: string | null;
@@ -43,7 +46,7 @@ export declare function createVoyantStorefrontClient(options: VoyantStorefrontCl
                     fields: {
                         key: string;
                         label: string;
-                        type: "email" | "date" | "text" | "select" | "country" | "tel" | "textarea" | "checkbox";
+                        type: "date" | "email" | "text" | "select" | "country" | "tel" | "textarea" | "checkbox";
                         required: boolean;
                         placeholder: string | null;
                         description: string | null;
@@ -991,6 +994,414 @@ export declare function createVoyantStorefrontClient(options: VoyantStorefrontCl
         createSnapshot: typeof createBookingEngineSnapshot;
         canRunAction: typeof canRunBookingEngineAction;
     };
+    bookingEngine: {
+        reserve: (input: Parameters<typeof reserveBookingEngineSession>[1], requestOptions?: Parameters<typeof reserveBookingEngineSession>[2]) => Promise<import("./booking-engine.js").BookingEngineSessionSnapshot>;
+        getSnapshot: (sessionId: string) => Promise<import("./booking-engine.js").BookingEngineSessionSnapshot>;
+        updateSession: (sessionId: string, input: Parameters<typeof updateBookingEngineSession>[2], requestOptions?: Parameters<typeof updateBookingEngineSession>[3]) => Promise<import("./booking-engine.js").BookingEngineSessionSnapshot>;
+        updateTravelers: (sessionId: string, input: Parameters<typeof updateBookingEngineTravelers>[2], requestOptions?: Parameters<typeof updateBookingEngineTravelers>[3]) => Promise<import("./booking-engine.js").BookingEngineSessionSnapshot>;
+        getProgress: (sessionId: string) => Promise<{
+            sessionId: string;
+            stateKey: "wizard";
+            currentStep: string | null;
+            completedSteps: string[];
+            payload: Record<string, unknown>;
+            version: number;
+            createdAt: string;
+            updatedAt: string;
+        }>;
+        updateProgress: (sessionId: string, input: Parameters<typeof updateBookingEngineProgress>[2], requestOptions?: Parameters<typeof updateBookingEngineProgress>[3]) => Promise<{
+            sessionId: string;
+            stateKey: "wizard";
+            currentStep: string | null;
+            completedSteps: string[];
+            payload: Record<string, unknown>;
+            version: number;
+            createdAt: string;
+            updatedAt: string;
+        }>;
+        reprice: (sessionId: string, input: Parameters<typeof repriceBookingEngineSession>[2], requestOptions?: Parameters<typeof repriceBookingEngineSession>[3]) => Promise<import("./booking-engine.js").BookingEngineRepriceResult>;
+        confirm: (sessionId: string, input?: Parameters<typeof confirmBookingEngineSession>[2], requestOptions?: Parameters<typeof confirmBookingEngineSession>[3]) => Promise<import("./booking-engine.js").BookingEngineSessionSnapshot>;
+        expire: (sessionId: string, input?: Parameters<typeof expireBookingEngineSession>[2], requestOptions?: Parameters<typeof expireBookingEngineSession>[3]) => Promise<import("./booking-engine.js").BookingEngineSessionSnapshot>;
+        getOverview: (query: Parameters<typeof getBookingEngineOverview>[1]) => Promise<{
+            bookingId: string;
+            bookingNumber: string;
+            status: "draft" | "on_hold" | "awaiting_payment" | "confirmed" | "in_progress" | "completed" | "expired" | "cancelled";
+            sellCurrency: string;
+            sellAmountCents: number | null;
+            startDate: string | null;
+            endDate: string | null;
+            pax: number | null;
+            confirmedAt: string | null;
+            cancelledAt: string | null;
+            completedAt: string | null;
+            travelers: {
+                id: string;
+                participantType: "traveler" | "occupant" | "other";
+                firstName: string;
+                lastName: string;
+                isPrimary: boolean;
+            }[];
+            items: {
+                id: string;
+                title: string;
+                description: string | null;
+                itemType: "other" | "unit" | "extra" | "service" | "fee" | "tax" | "discount" | "adjustment" | "accommodation" | "transport";
+                status: "draft" | "on_hold" | "confirmed" | "expired" | "cancelled" | "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: "traveler" | "occupant" | "other" | "beneficiary";
+                    isPrimary: boolean;
+                }[];
+            }[];
+            documents: {
+                id: string;
+                travelerId: string | null;
+                type: "other" | "visa" | "insurance" | "health" | "passport_copy";
+                fileName: string;
+                fileUrl: string;
+            }[];
+            fulfillments: {
+                id: string;
+                bookingItemId: string | null;
+                travelerId: string | null;
+                fulfillmentType: "other" | "voucher" | "ticket" | "pdf" | "qr_code" | "barcode" | "mobile";
+                deliveryChannel: "other" | "download" | "email" | "api" | "wallet";
+                status: "pending" | "issued" | "reissued" | "revoked" | "failed";
+                artifactUrl: string | null;
+            }[];
+        }>;
+        previewPayment: (bookingId: string, input: Parameters<typeof previewBookingEnginePayment>[2], requestOptions?: Parameters<typeof previewBookingEnginePayment>[3]) => Promise<{
+            bookingId: string;
+            method: "bank_transfer" | "card";
+            stage: "manual" | "initial" | "reminder";
+            paymentSessionTarget: "schedule" | "invoice" | null;
+            documentType: "invoice" | "proforma" | null;
+            willCreateDefaultPaymentPlan: boolean;
+            selectedSchedule: {
+                id: string;
+                bookingId: string;
+                bookingItemId: string | null;
+                scheduleType: string;
+                status: string;
+                dueDate: string;
+                currency: string;
+                amountCents: number;
+                notes: string | null;
+            } | null;
+            selectedInvoice: {
+                id: string;
+                invoiceNumber: string;
+                invoiceType: string;
+                bookingId: string;
+                personId: string | null;
+                organizationId: string | null;
+                status: string;
+                currency: string;
+                totalCents: number;
+                paidCents: number;
+                balanceDueCents: number;
+                issueDate: string;
+                dueDate: string;
+                notes: string | null;
+                createdAt: string;
+                updatedAt: string;
+            } | null;
+            amountCents: number;
+            currency: string;
+            recommendedAction: "none" | "create_bank_transfer_document" | "create_payment_session" | "create_invoice_then_payment_session";
+        }>;
+        startPayment: (bookingId: string, input: Parameters<typeof startBookingEnginePayment>[2], requestOptions?: Parameters<typeof startBookingEnginePayment>[3]) => Promise<{
+            plan: {
+                bookingId: string;
+                method: "bank_transfer" | "card";
+                stage: "manual" | "initial" | "reminder";
+                paymentSessionTarget: "schedule" | "invoice" | null;
+                documentType: "invoice" | "proforma" | null;
+                willCreateDefaultPaymentPlan: boolean;
+                selectedSchedule: {
+                    id: string;
+                    bookingId: string;
+                    bookingItemId: string | null;
+                    scheduleType: string;
+                    status: string;
+                    dueDate: string;
+                    currency: string;
+                    amountCents: number;
+                    notes: string | null;
+                } | null;
+                selectedInvoice: {
+                    id: string;
+                    invoiceNumber: string;
+                    invoiceType: string;
+                    bookingId: string;
+                    personId: string | null;
+                    organizationId: string | null;
+                    status: string;
+                    currency: string;
+                    totalCents: number;
+                    paidCents: number;
+                    balanceDueCents: number;
+                    issueDate: string;
+                    dueDate: string;
+                    notes: string | null;
+                    createdAt: string;
+                    updatedAt: string;
+                } | null;
+                amountCents: number;
+                currency: string;
+                recommendedAction: "none" | "create_bank_transfer_document" | "create_payment_session" | "create_invoice_then_payment_session";
+            };
+            invoice: {
+                id: string;
+                invoiceNumber: string;
+                invoiceType: string;
+                bookingId: string;
+                personId: string | null;
+                organizationId: string | null;
+                status: string;
+                currency: string;
+                totalCents: number;
+                paidCents: number;
+                balanceDueCents: number;
+                issueDate: string;
+                dueDate: string;
+                notes: string | null;
+                createdAt: string;
+                updatedAt: string;
+            } | null;
+            paymentSession: {
+                id: string;
+                targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
+                targetId: string | null;
+                bookingId: string | null;
+                invoiceId: string | null;
+                bookingPaymentScheduleId: string | null;
+                bookingGuaranteeId: string | null;
+                status: "expired" | "cancelled" | "pending" | "failed" | "paid" | "requires_redirect" | "processing" | "authorized";
+                provider: string | null;
+                providerSessionId: string | null;
+                providerPaymentId: string | null;
+                externalReference: string | null;
+                clientReference: string | null;
+                currency: string;
+                amountCents: number;
+                paymentMethod: "other" | "voucher" | "wallet" | "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "direct_bill" | null;
+                payerEmail: string | null;
+                payerName: string | null;
+                redirectUrl: string | null;
+                returnUrl: string | null;
+                cancelUrl: string | null;
+                expiresAt: string | null;
+                completedAt: string | null;
+                failureCode: string | null;
+                failureMessage: string | null;
+                notes: string | null;
+            } | null;
+            invoiceNotification: {
+                id: string;
+                templateSlug: string | null;
+                channel: "email" | "sms";
+                provider: string;
+                status: "cancelled" | "pending" | "failed" | "sent";
+                toAddress: string;
+                subject: string | null;
+                sentAt: string | null;
+                failedAt: string | null;
+                errorMessage: string | null;
+            } | null;
+            paymentSessionNotification: {
+                id: string;
+                templateSlug: string | null;
+                channel: "email" | "sms";
+                provider: string;
+                status: "cancelled" | "pending" | "failed" | "sent";
+                toAddress: string;
+                subject: string | null;
+                sentAt: string | null;
+                failedAt: string | null;
+                errorMessage: string | null;
+            } | null;
+            bankTransferInstructions: {
+                provider: string | null;
+                invoiceId: string;
+                invoiceNumber: string;
+                documentType: "invoice" | "proforma";
+                amountCents: number;
+                currency: string;
+                dueDate: string | null;
+                beneficiary: string;
+                iban: string;
+                bankName: string | null;
+                notes: string | null;
+            } | null;
+            providerStart: {
+                provider: string;
+                paymentSessionId: string;
+                redirectUrl: string | null;
+                externalReference: string | null;
+                providerSessionId: string | null;
+                providerPaymentId: string | null;
+                response: Record<string, unknown> | null;
+            } | null;
+        }>;
+        bootstrapPayment: (input: Parameters<typeof bootstrapBookingEnginePayment>[1], requestOptions?: Parameters<typeof bootstrapBookingEnginePayment>[2]) => Promise<{
+            plan: {
+                bookingId: string;
+                method: "bank_transfer" | "card";
+                stage: "manual" | "initial" | "reminder";
+                paymentSessionTarget: "schedule" | "invoice" | null;
+                documentType: "invoice" | "proforma" | null;
+                willCreateDefaultPaymentPlan: boolean;
+                selectedSchedule: {
+                    id: string;
+                    bookingId: string;
+                    bookingItemId: string | null;
+                    scheduleType: string;
+                    status: string;
+                    dueDate: string;
+                    currency: string;
+                    amountCents: number;
+                    notes: string | null;
+                } | null;
+                selectedInvoice: {
+                    id: string;
+                    invoiceNumber: string;
+                    invoiceType: string;
+                    bookingId: string;
+                    personId: string | null;
+                    organizationId: string | null;
+                    status: string;
+                    currency: string;
+                    totalCents: number;
+                    paidCents: number;
+                    balanceDueCents: number;
+                    issueDate: string;
+                    dueDate: string;
+                    notes: string | null;
+                    createdAt: string;
+                    updatedAt: string;
+                } | null;
+                amountCents: number;
+                currency: string;
+                recommendedAction: "none" | "create_bank_transfer_document" | "create_payment_session" | "create_invoice_then_payment_session";
+            };
+            invoice: {
+                id: string;
+                invoiceNumber: string;
+                invoiceType: string;
+                bookingId: string;
+                personId: string | null;
+                organizationId: string | null;
+                status: string;
+                currency: string;
+                totalCents: number;
+                paidCents: number;
+                balanceDueCents: number;
+                issueDate: string;
+                dueDate: string;
+                notes: string | null;
+                createdAt: string;
+                updatedAt: string;
+            } | null;
+            paymentSession: {
+                id: string;
+                targetType: "other" | "booking" | "order" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "flight_order";
+                targetId: string | null;
+                bookingId: string | null;
+                invoiceId: string | null;
+                bookingPaymentScheduleId: string | null;
+                bookingGuaranteeId: string | null;
+                status: "expired" | "cancelled" | "pending" | "failed" | "paid" | "requires_redirect" | "processing" | "authorized";
+                provider: string | null;
+                providerSessionId: string | null;
+                providerPaymentId: string | null;
+                externalReference: string | null;
+                clientReference: string | null;
+                currency: string;
+                amountCents: number;
+                paymentMethod: "other" | "voucher" | "wallet" | "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "direct_bill" | null;
+                payerEmail: string | null;
+                payerName: string | null;
+                redirectUrl: string | null;
+                returnUrl: string | null;
+                cancelUrl: string | null;
+                expiresAt: string | null;
+                completedAt: string | null;
+                failureCode: string | null;
+                failureMessage: string | null;
+                notes: string | null;
+            } | null;
+            invoiceNotification: {
+                id: string;
+                templateSlug: string | null;
+                channel: "email" | "sms";
+                provider: string;
+                status: "cancelled" | "pending" | "failed" | "sent";
+                toAddress: string;
+                subject: string | null;
+                sentAt: string | null;
+                failedAt: string | null;
+                errorMessage: string | null;
+            } | null;
+            paymentSessionNotification: {
+                id: string;
+                templateSlug: string | null;
+                channel: "email" | "sms";
+                provider: string;
+                status: "cancelled" | "pending" | "failed" | "sent";
+                toAddress: string;
+                subject: string | null;
+                sentAt: string | null;
+                failedAt: string | null;
+                errorMessage: string | null;
+            } | null;
+            bankTransferInstructions: {
+                provider: string | null;
+                invoiceId: string;
+                invoiceNumber: string;
+                documentType: "invoice" | "proforma";
+                amountCents: number;
+                currency: string;
+                dueDate: string | null;
+                beneficiary: string;
+                iban: string;
+                bankName: string | null;
+                notes: string | null;
+            } | null;
+            providerStart: {
+                provider: string;
+                paymentSessionId: string;
+                redirectUrl: string | null;
+                externalReference: string | null;
+                providerSessionId: string | null;
+                providerPaymentId: string | null;
+                response: Record<string, unknown> | null;
+            } | null;
+            bookingId: string;
+            sessionId: string;
+            sourceType: "session" | "booking";
+            intent: "custom" | "deposit" | "balance";
+        }>;
+        deriveState: typeof deriveBookingEngineState;
+        createSnapshot: typeof createBookingEngineSnapshot;
+        canRunAction: typeof canRunBookingEngineAction;
+    };
     checkout: {
         previewCollection: (bookingId: string, input: Parameters<typeof previewCheckoutCollection>[2], requestOptions?: Parameters<typeof previewCheckoutCollection>[3]) => Promise<{
             bookingId: string;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,8 +1,11 @@
+import { bootstrapBookingEnginePayment, confirmBookingEngineSession, expireBookingEngineSession, getBookingEngineOverview, getBookingEngineProgress, getBookingEngineSessionSnapshot, previewBookingEnginePayment, repriceBookingEngineSession, reserveBookingEngineSession, startBookingEnginePayment, updateBookingEngineProgress, updateBookingEngineSession, updateBookingEngineTravelers, } from "./booking-engine.js";
 import { defaultStorefrontFetcher } from "./client.js";
 import { canRunBookingEngineAction, createBookingEngineSnapshot, deriveBookingEngineState, } from "./engine-state.js";
 import { bootstrapCheckoutCollection, confirmPublicBookingSession, createPublicBookingSession, expirePublicBookingSession, getPublicBookingOverview, getPublicBookingSession, getPublicBookingSessionState, getStorefrontDeparture, getStorefrontDepartureItinerary, getStorefrontOfferBySlug, getStorefrontProductAvailability, getStorefrontSettings, initiateCheckoutCollection, listStorefrontProductDepartures, listStorefrontProductExtensions, listStorefrontProductOffers, previewCheckoutCollection, previewStorefrontDeparturePrice, repricePublicBookingSession, updatePublicBookingSession, updatePublicBookingSessionState, } from "./operations.js";
+export * from "./booking-engine.js";
 export { defaultStorefrontFetcher, storefrontFetchWithValidation, VoyantStorefrontApiError, withStorefrontQueryParams, } from "./client.js";
 export { bookingEngineActions, bookingEngineStates, canRunBookingEngineAction, createBookingEngineSnapshot, deriveBookingEngineState, getAllowedBookingEngineActions, } from "./engine-state.js";
+export * from "./errors.js";
 export * from "./operations.js";
 export * from "./schemas.js";
 export function createVoyantStorefrontClient(options) {
@@ -37,6 +40,24 @@ export function createVoyantStorefrontClient(options) {
             createSnapshot: createBookingEngineSnapshot,
             canRunAction: canRunBookingEngineAction,
         },
+        bookingEngine: {
+            reserve: (input, requestOptions) => reserveBookingEngineSession(client, input, requestOptions),
+            getSnapshot: (sessionId) => getBookingEngineSessionSnapshot(client, sessionId),
+            updateSession: (sessionId, input, requestOptions) => updateBookingEngineSession(client, sessionId, input, requestOptions),
+            updateTravelers: (sessionId, input, requestOptions) => updateBookingEngineTravelers(client, sessionId, input, requestOptions),
+            getProgress: (sessionId) => getBookingEngineProgress(client, sessionId),
+            updateProgress: (sessionId, input, requestOptions) => updateBookingEngineProgress(client, sessionId, input, requestOptions),
+            reprice: (sessionId, input, requestOptions) => repriceBookingEngineSession(client, sessionId, input, requestOptions),
+            confirm: (sessionId, input, requestOptions) => confirmBookingEngineSession(client, sessionId, input, requestOptions),
+            expire: (sessionId, input, requestOptions) => expireBookingEngineSession(client, sessionId, input, requestOptions),
+            getOverview: (query) => getBookingEngineOverview(client, query),
+            previewPayment: (bookingId, input, requestOptions) => previewBookingEnginePayment(client, bookingId, input, requestOptions),
+            startPayment: (bookingId, input, requestOptions) => startBookingEnginePayment(client, bookingId, input, requestOptions),
+            bootstrapPayment: (input, requestOptions) => bootstrapBookingEnginePayment(client, input, requestOptions),
+            deriveState: deriveBookingEngineState,
+            createSnapshot: createBookingEngineSnapshot,
+            canRunAction: canRunBookingEngineAction,
+        },
         checkout: {
             previewCollection: (bookingId, input, requestOptions) => previewCheckoutCollection(client, bookingId, input, requestOptions),
             initiateCollection: (bookingId, input, requestOptions) => initiateCheckoutCollection(client, bookingId, input, requestOptions),

package/dist/operations.d.ts

@@ -20,7 +20,7 @@ export declare function getStorefrontSettings(client: ResolvedClientOptions): Pr
             fields: {
                 key: string;
                 label: string;
-                type: "email" | "date" | "text" | "select" | "country" | "tel" | "textarea" | "checkbox";
+                type: "date" | "email" | "text" | "select" | "country" | "tel" | "textarea" | "checkbox";
                 required: boolean;
                 placeholder: string | null;
                 description: string | null;
@@ -35,7 +35,7 @@ export declare function getStorefrontSettings(client: ResolvedClientOptions): Pr
             fields: {
                 key: string;
                 label: string;
-                type: "email" | "date" | "text" | "select" | "country" | "tel" | "textarea" | "checkbox";
+                type: "date" | "email" | "text" | "select" | "country" | "tel" | "textarea" | "checkbox";
                 required: boolean;
                 placeholder: string | null;
                 description: string | null;

package/dist/schemas.d.ts

@@ -30,8 +30,8 @@ export declare const storefrontSettingsResponseSchema: z.ZodObject<{
                     key: z.ZodString;
                     label: z.ZodString;
                     type: z.ZodEnum<{
-                        email: "email";
                         date: "date";
+                        email: "email";
                         text: "text";
                         select: "select";
                         country: "country";
@@ -54,8 +54,8 @@ export declare const storefrontSettingsResponseSchema: z.ZodObject<{
                     key: z.ZodString;
                     label: z.ZodString;
                     type: z.ZodEnum<{
-                        email: "email";
                         date: "date";
+                        email: "email";
                         text: "text";
                         select: "select";
                         country: "country";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/storefront-sdk",
-  "version": "0.34.0",
+  "version": "0.37.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -15,6 +15,11 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./booking-engine": {
+      "types": "./dist/booking-engine.d.ts",
+      "import": "./dist/booking-engine.js",
+      "default": "./dist/booking-engine.js"
+    },
     "./client": {
       "types": "./dist/client.d.ts",
       "import": "./dist/client.js",
@@ -25,6 +30,11 @@
       "import": "./dist/engine-state.js",
       "default": "./dist/engine-state.js"
     },
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "import": "./dist/errors.js",
+      "default": "./dist/errors.js"
+    },
     "./operations": {
       "types": "./dist/operations.d.ts",
       "import": "./dist/operations.js",
@@ -38,17 +48,17 @@
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@voyantjs/bookings": "0.34.0",
-    "@voyantjs/checkout": "0.34.0",
-    "@voyantjs/storefront": "0.34.0"
+    "@voyantjs/bookings": "0.37.0",
+    "@voyantjs/checkout": "0.37.0",
+    "@voyantjs/storefront": "0.37.0"
   },
   "devDependencies": {
     "typescript": "^6.0.2",
     "vitest": "^4.1.2",
     "zod": "^4.3.6",
-    "@voyantjs/bookings": "0.34.0",
-    "@voyantjs/checkout": "0.34.0",
-    "@voyantjs/storefront": "0.34.0",
+    "@voyantjs/bookings": "0.37.0",
+    "@voyantjs/checkout": "0.37.0",
+    "@voyantjs/storefront": "0.37.0",
     "@voyantjs/voyant-typescript-config": "0.1.0"
   },
   "files": [