@voyant-travel/commerce 0.2.2 → 0.3.0

package/dist/checkout/acceptance-signature.d.ts

@@ -0,0 +1,4 @@
+import type { EventBus } from "@voyant-travel/core";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+export declare function persistAcceptanceSignature(db: PostgresJsDatabase, contractId: string, eventBus?: EventBus): Promise<void>;
+//# sourceMappingURL=acceptance-signature.d.ts.map

package/dist/checkout/acceptance-signature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acceptance-signature.d.ts","sourceRoot":"","sources":["../../src/checkout/acceptance-signature.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAEnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAoCjE,wBAAsB,0BAA0B,CAC9C,EAAE,EAAE,kBAAkB,EACtB,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,QAAQ,GAClB,OAAO,CAAC,IAAI,CAAC,CAoFf"}

package/dist/checkout/acceptance-signature.js

@@ -0,0 +1,95 @@
+import { bookings } from "@voyant-travel/bookings/schema";
+import { eq } from "drizzle-orm";
+const ACCEPTANCE_MARKER_PREFIX = "__contract_acceptance__:";
+function readContractAcceptance(contractMetadata, internalNotesFallback) {
+    if (contractMetadata && typeof contractMetadata === "object") {
+        const meta = contractMetadata;
+        if (meta.acceptance && typeof meta.acceptance === "object") {
+            return meta.acceptance;
+        }
+    }
+    if (!internalNotesFallback)
+        return null;
+    for (const line of internalNotesFallback.split("\n")) {
+        if (!line.startsWith(ACCEPTANCE_MARKER_PREFIX))
+            continue;
+        try {
+            return JSON.parse(line.slice(ACCEPTANCE_MARKER_PREFIX.length));
+        }
+        catch {
+            // Bad marker - try next line.
+        }
+    }
+    return null;
+}
+export async function persistAcceptanceSignature(db, contractId, eventBus) {
+    const { contractsService } = await import("@voyant-travel/legal/contracts");
+    const { contracts: contractsTable } = await import("@voyant-travel/legal/contracts");
+    const [contract] = await db
+        .select()
+        .from(contractsTable)
+        .where(eq(contractsTable.id, contractId))
+        .limit(1);
+    if (!contract?.bookingId)
+        return;
+    const [booking] = await db
+        .select()
+        .from(bookings)
+        .where(eq(bookings.id, contract.bookingId))
+        .limit(1);
+    if (!booking)
+        return;
+    const acceptance = readContractAcceptance(contract.metadata, booking.internalNotes);
+    if (!acceptance)
+        return;
+    const existing = await contractsService.listSignatures(db, contractId);
+    if (existing.length > 0)
+        return;
+    if (contract.status === "issued") {
+        const sent = await contractsService.sendContract(db, contractId, { eventBus });
+        if (sent.status !== "sent") {
+            console.warn(`[catalog-checkout] could not send contract before acceptance signature for ${contractId}: ${sent.status}`);
+            return;
+        }
+    }
+    const contactName = [booking.contactFirstName, booking.contactLastName]
+        .filter(Boolean)
+        .join(" ")
+        .trim();
+    const signerName = contactName ||
+        `Storefront customer${booking.bookingNumber ? ` (${booking.bookingNumber})` : ""}`;
+    const result = await contractsService.signContract(db, contractId, {
+        signerName,
+        signerEmail: booking.contactEmail ?? null,
+        method: "electronic",
+        ipAddress: acceptance.clientIp ? acceptance.clientIp.slice(0, 64) : null,
+        userAgent: acceptance.userAgent ? acceptance.userAgent.slice(0, 500) : null,
+        metadata: {
+            source: "storefront-checkout",
+            templateId: acceptance.templateId,
+            templateSlug: acceptance.templateSlug,
+            acceptedAt: acceptance.acceptedAt,
+            acceptedMarketing: acceptance.acceptedMarketing,
+            renderedHtmlLength: acceptance.renderedHtmlLength,
+        },
+    }, { eventBus });
+    if (result.status !== "signed") {
+        console.warn(`[catalog-checkout] could not record acceptance signature for ${contractId}: ${result.status}`);
+        return;
+    }
+    if (booking.internalNotes?.includes(ACCEPTANCE_MARKER_PREFIX)) {
+        const cleanedNotes = booking.internalNotes
+            .split("\n")
+            .filter((line) => !line.startsWith(ACCEPTANCE_MARKER_PREFIX))
+            .join("\n")
+            .replace(/\n{3,}/g, "\n\n")
+            .trim();
+        await db
+            .update(bookings)
+            .set({
+            internalNotes: cleanedNotes.length > 0 ? cleanedNotes : null,
+            updatedAt: new Date(),
+        })
+            .where(eq(bookings.id, booking.id));
+    }
+}

package/dist/checkout/finalize.d.ts

@@ -0,0 +1,42 @@
+import { type CheckoutFinalizeInput } from "@voyant-travel/catalog/booking-engine";
+import type { EventBus } from "@voyant-travel/core";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+/**
+ * Optional callback that generates (or fetches existing) the contract PDF for
+ * a booking. Wired by the deployment and forwarded into the explicit
+ * `generate_contract_pdf` workflow step. The deployment supplies its
+ * platform bindings (`env`) when constructing it, so this package-level type
+ * only carries the booking-scoped inputs the step needs.
+ */
+export type CatalogCheckoutContractPdfGenerator = (input: {
+    db: PostgresJsDatabase;
+    eventBus: EventBus;
+    bookingId: string;
+}) => Promise<{
+    contractId: string;
+    attachmentId: string;
+} | null>;
+export interface DispatchCheckoutFinalizeParams {
+    db: PostgresJsDatabase;
+    eventBus: EventBus;
+    input: CheckoutFinalizeInput;
+    trigger: string;
+    correlationId: string | null;
+    tags: ReadonlyArray<string>;
+    parentRunId?: string | null;
+    triggeredByUserId?: string | null;
+    resumeFromStep?: string;
+    seedResults?: Record<string, unknown>;
+    generateContractPdf?: CatalogCheckoutContractPdfGenerator;
+}
+/**
+ * Run the checkout-finalize workflow for a booking: record a workflow run,
+ * build the finalize deps (confirm booking, issue invoice, link payments,
+ * generate contract PDF), execute `runCheckoutFinalize`, and mark the run
+ * complete/failed. The deployment owns the db + event bus + (optional)
+ * contract-pdf generator; this is the reusable saga driver.
+ */
+export declare function dispatchCheckoutFinalize(params: DispatchCheckoutFinalizeParams): Promise<{
+    runId: string;
+}>;
+//# sourceMappingURL=finalize.d.ts.map

package/dist/checkout/finalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalize.d.ts","sourceRoot":"","sources":["../../src/checkout/finalize.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,qBAAqB,EAE3B,MAAM,uCAAuC,CAAA;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAInD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE;;;;;;GAMG;AACH,MAAM,MAAM,mCAAmC,GAAG,CAAC,KAAK,EAAE;IACxD,EAAE,EAAE,kBAAkB,CAAA;IACtB,QAAQ,EAAE,QAAQ,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB,KAAK,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAAA;AAuKlE,MAAM,WAAW,8BAA8B;IAC7C,EAAE,EAAE,kBAAkB,CAAA;IACtB,QAAQ,EAAE,QAAQ,CAAA;IAClB,KAAK,EAAE,qBAAqB,CAAA;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,mBAAmB,CAAC,EAAE,mCAAmC,CAAA;CAC1D;AAMD;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,8BAA8B,GACrC,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAgE5B"}

package/dist/checkout/finalize.js

@@ -0,0 +1,208 @@
+// agent-quality: file-size exception -- owner: commerce; the checkout-finalize
+// step wiring (confirm booking, issue invoice, link payments, contract PDF) is
+// one cohesive workflow definition; splitting it would scatter a single saga.
+import { bookingsService } from "@voyant-travel/bookings";
+import { bookingActivityLog, bookings } from "@voyant-travel/bookings/schema";
+import { runCheckoutFinalize, } from "@voyant-travel/catalog/booking-engine";
+import { issueInvoiceFromBooking } from "@voyant-travel/finance";
+import { beginWorkflowRun } from "@voyant-travel/workflow-runs";
+import { and, eq, isNull } from "drizzle-orm";
+function buildCheckoutFinalizeDeps(db, eventBus, recorder, generateContractPdf) {
+    return {
+        db,
+        eventBus,
+        recorder: {
+            startStep: (name) => {
+                void recorder.startStep(name);
+            },
+            completeStep: (name, output) => {
+                void recorder.completeStep(name, output ?? null);
+            },
+            failStep: (name, error) => {
+                void recorder.failStep(name, error);
+            },
+        },
+        confirmBooking: async (bookingId) => {
+            const result = await bookingsService.confirmBooking(db, bookingId, {}, undefined, {
+                eventBus,
+            });
+            if (result.status === "ok")
+                return;
+            if (result.status === "hold_expired") {
+                const recovered = await bookingsService.recoverExpiredPaidBooking(db, bookingId, { note: "Recovered after late payment completion" }, undefined, { eventBus });
+                if (recovered.status === "ok")
+                    return;
+                throw new Error(`checkout-finalize: late payment recovery failed (${recovered.status})`);
+            }
+            throw new Error(`checkout-finalize: booking confirmation failed (${result.status})`);
+        },
+        issueInvoice: async ({ bookingId, convertedFromInvoiceId }) => {
+            const [booking] = await db.select().from(bookings).where(eq(bookings.id, bookingId)).limit(1);
+            if (!booking)
+                return null;
+            const { bookingItems } = await import("@voyant-travel/bookings/schema");
+            const items = await db
+                .select()
+                .from(bookingItems)
+                .where(eq(bookingItems.bookingId, bookingId));
+            const today = new Date().toISOString().slice(0, 10);
+            const dueDate = new Date(Date.now() + 14 * 24 * 60 * 60 * 1000).toISOString().slice(0, 10);
+            const invoice = await issueInvoiceFromBooking(db, {
+                bookingId,
+                issueDate: today,
+                dueDate,
+                invoiceType: "invoice",
+                notes: convertedFromInvoiceId
+                    ? `Converted from proforma ${convertedFromInvoiceId}`
+                    : null,
+            }, {
+                booking: {
+                    id: booking.id,
+                    bookingNumber: booking.bookingNumber,
+                    personId: booking.personId,
+                    organizationId: booking.organizationId,
+                    sellCurrency: booking.sellCurrency,
+                    baseCurrency: booking.baseCurrency,
+                    fxRateSetId: null,
+                    sellAmountCents: booking.sellAmountCents,
+                    baseSellAmountCents: booking.baseSellAmountCents,
+                },
+                items: items.map((item) => ({
+                    id: item.id,
+                    title: item.title,
+                    quantity: item.quantity,
+                    unitSellAmountCents: item.unitSellAmountCents,
+                    totalSellAmountCents: item.totalSellAmountCents,
+                })),
+            }, { eventBus });
+            if (invoice && convertedFromInvoiceId) {
+                const { invoices } = await import("@voyant-travel/finance");
+                await db.update(invoices).set({ convertedFromInvoiceId }).where(eq(invoices.id, invoice.id));
+            }
+            return invoice ? { invoiceId: invoice.id } : null;
+        },
+        findProformaForBooking: async (bookingId) => {
+            const { invoices } = await import("@voyant-travel/finance");
+            const [proforma] = await db
+                .select({ id: invoices.id })
+                .from(invoices)
+                .where(eq(invoices.bookingId, bookingId))
+                .limit(1);
+            return proforma ? { invoiceId: proforma.id } : null;
+        },
+        generateContractPdf: generateContractPdf
+            ? async ({ bookingId }) => generateContractPdf({ db, eventBus, bookingId })
+            : undefined,
+        linkPaymentToInvoice: async ({ bookingId, invoiceId, paymentSessionId }) => {
+            const { paymentSessions } = await import("@voyant-travel/finance/schema");
+            const { financeService } = await import("@voyant-travel/finance");
+            const paidSessions = await db
+                .select()
+                .from(paymentSessions)
+                .where(and(eq(paymentSessions.bookingId, bookingId), eq(paymentSessions.status, "paid"), isNull(paymentSessions.invoiceId)));
+            let firstPaymentId = null;
+            let sessionsLinked = 0;
+            for (const session of paidSessions) {
+                await db
+                    .update(paymentSessions)
+                    .set({ invoiceId, updatedAt: new Date() })
+                    .where(eq(paymentSessions.id, session.id));
+                const payment = await financeService.createPayment(db, invoiceId, {
+                    amountCents: session.amountCents,
+                    currency: session.currency,
+                    paymentMethod: session.paymentMethod ?? "credit_card",
+                    paymentInstrumentId: session.paymentInstrumentId ?? null,
+                    paymentAuthorizationId: session.paymentAuthorizationId ?? null,
+                    paymentCaptureId: session.paymentCaptureId ?? null,
+                    status: "completed",
+                    referenceNumber: session.providerPaymentId ??
+                        session.externalReference ??
+                        session.providerSessionId ??
+                        session.id,
+                    paymentDate: (session.completedAt ?? new Date()).toISOString().slice(0, 10),
+                    notes: `Checkout-finalize linkage from session ${session.id}` +
+                        (paymentSessionId && session.id !== paymentSessionId
+                            ? ` (workflow input session: ${paymentSessionId})`
+                            : ""),
+                });
+                if (payment?.id) {
+                    await db
+                        .update(paymentSessions)
+                        .set({ paymentId: payment.id, updatedAt: new Date() })
+                        .where(eq(paymentSessions.id, session.id));
+                    if (!firstPaymentId)
+                        firstPaymentId = payment.id;
+                }
+                sessionsLinked++;
+            }
+            return { paymentId: firstPaymentId, sessionsLinked };
+        },
+    };
+}
+function checkoutFinalizeInputRecord(input) {
+    return { ...input };
+}
+/**
+ * Run the checkout-finalize workflow for a booking: record a workflow run,
+ * build the finalize deps (confirm booking, issue invoice, link payments,
+ * generate contract PDF), execute `runCheckoutFinalize`, and mark the run
+ * complete/failed. The deployment owns the db + event bus + (optional)
+ * contract-pdf generator; this is the reusable saga driver.
+ */
+export async function dispatchCheckoutFinalize(params) {
+    const recorder = await beginWorkflowRun(params.db, {
+        workflowName: "checkout-finalize",
+        trigger: params.trigger,
+        correlationId: params.correlationId ?? null,
+        tags: [...params.tags],
+        input: checkoutFinalizeInputRecord(params.input),
+        parentRunId: params.parentRunId ?? null,
+        triggeredByUserId: params.triggeredByUserId ?? null,
+        resumeFromStep: params.resumeFromStep ?? null,
+    });
+    if (params.parentRunId) {
+        try {
+            const action = params.resumeFromStep ? "resumed" : "rerun";
+            const description = params.resumeFromStep
+                ? `Workflow checkout-finalize ${action} from step "${params.resumeFromStep}"`
+                : `Workflow checkout-finalize ${action}`;
+            await params.db.insert(bookingActivityLog).values({
+                bookingId: params.input.bookingId,
+                actorId: params.triggeredByUserId ?? null,
+                activityType: "system_action",
+                description,
+                metadata: {
+                    kind: "workflow_rerun",
+                    workflowName: "checkout-finalize",
+                    parentRunId: params.parentRunId,
+                    newRunId: recorder.runId,
+                    resumeFromStep: params.resumeFromStep ?? null,
+                },
+            });
+        }
+        catch (err) {
+            console.warn("[catalog-checkout] failed to write rerun activity log", err);
+        }
+    }
+    if (params.resumeFromStep && params.seedResults) {
+        for (const [stepName, output] of Object.entries(params.seedResults)) {
+            if (stepName === "__deps")
+                continue;
+            await recorder.recordSkippedStep(stepName, output && typeof output === "object" ? output : null);
+        }
+    }
+    const deps = buildCheckoutFinalizeDeps(params.db, params.eventBus, recorder, params.generateContractPdf);
+    try {
+        await runCheckoutFinalize(params.input, deps, {
+            skipUntil: params.resumeFromStep,
+            seedResults: params.seedResults,
+        });
+        await recorder.complete();
+        return { runId: recorder.runId };
+    }
+    catch (err) {
+        console.error("[catalog-checkout] checkout-finalize workflow failed", err);
+        await recorder.fail(err);
+        throw err;
+    }
+}

package/dist/checkout/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Catalog-checkout business-logic cluster, owned by `@voyant-travel/commerce`.
+ *
+ * The reusable orchestration (snapshot→booking materialization, tax-line
+ * derivation, acceptance signature promotion, checkout-start service, the
+ * checkout-finalize saga driver, and the public checkout route) lives here.
+ * Deployment-specific dependencies are injected via the options interfaces in
+ * `./options.js`:
+ *   - `resolveBookingTaxSettings` — operator tax-mode/profile reads.
+ *   - `getOwnedProductName` — owned product title (injected to avoid a cycle
+ *     through `@voyant-travel/inventory`, which depends on commerce).
+ *   - `resolveBankTransferInstructions` — operator profile / payment rows.
+ *
+ * The deployment keeps the thin HonoBundle wiring (workflow runner registry +
+ * event-bus subscribers) and calls `dispatchCheckoutFinalize` /
+ * `persistAcceptanceSignature` from there.
+ */
+export { persistAcceptanceSignature } from "./acceptance-signature.js";
+export { type CatalogCheckoutContractPdfGenerator, type DispatchCheckoutFinalizeParams, dispatchCheckoutFinalize, } from "./finalize.js";
+export { type DraftPayload, type MaterializationSnapshot, materializeBookingFromSnapshot, rebuildBookingItemTaxLines, } from "./materialization.js";
+export { extractBookingDates, extractItemDates, extractItemDescription, inferSnapshotTaxFacts, materializeBookingAllocations, materializeTravelerTravelDetails, resolveLineItemTitle, resolveSupplierFromSnapshot, resolveUpstreamCostCents, travelerBandToCategory, } from "./materialization-support.js";
+export { materializeBookingItemTaxLine } from "./materialization-tax.js";
+export type { CheckoutBankTransferInstructions, CheckoutModuleOptions, CheckoutStartOptions, } from "./options.js";
+export { createCatalogCheckoutRoutes } from "./routes.js";
+export { type CatalogCheckoutStartContext, CatalogCheckoutStartError, type CatalogCheckoutStartResult, type CheckoutStartInput, type CheckoutStartRequestMeta, checkoutStartSchema, startCatalogCheckout, } from "./start-service.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/checkout/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/checkout/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AACtE,OAAO,EACL,KAAK,mCAAmC,EACxC,KAAK,8BAA8B,EACnC,wBAAwB,GACzB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC5B,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,6BAA6B,EAC7B,gCAAgC,EAChC,oBAAoB,EACpB,2BAA2B,EAC3B,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAA;AACxE,YAAY,EACV,gCAAgC,EAChC,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAA;AACzD,OAAO,EACL,KAAK,2BAA2B,EAChC,yBAAyB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,oBAAoB,CAAA"}

package/dist/checkout/index.js

@@ -0,0 +1,24 @@
+/**
+ * Catalog-checkout business-logic cluster, owned by `@voyant-travel/commerce`.
+ *
+ * The reusable orchestration (snapshot→booking materialization, tax-line
+ * derivation, acceptance signature promotion, checkout-start service, the
+ * checkout-finalize saga driver, and the public checkout route) lives here.
+ * Deployment-specific dependencies are injected via the options interfaces in
+ * `./options.js`:
+ *   - `resolveBookingTaxSettings` — operator tax-mode/profile reads.
+ *   - `getOwnedProductName` — owned product title (injected to avoid a cycle
+ *     through `@voyant-travel/inventory`, which depends on commerce).
+ *   - `resolveBankTransferInstructions` — operator profile / payment rows.
+ *
+ * The deployment keeps the thin HonoBundle wiring (workflow runner registry +
+ * event-bus subscribers) and calls `dispatchCheckoutFinalize` /
+ * `persistAcceptanceSignature` from there.
+ */
+export { persistAcceptanceSignature } from "./acceptance-signature.js";
+export { dispatchCheckoutFinalize, } from "./finalize.js";
+export { materializeBookingFromSnapshot, rebuildBookingItemTaxLines, } from "./materialization.js";
+export { extractBookingDates, extractItemDates, extractItemDescription, inferSnapshotTaxFacts, materializeBookingAllocations, materializeTravelerTravelDetails, resolveLineItemTitle, resolveSupplierFromSnapshot, resolveUpstreamCostCents, travelerBandToCategory, } from "./materialization-support.js";
+export { materializeBookingItemTaxLine } from "./materialization-tax.js";
+export { createCatalogCheckoutRoutes } from "./routes.js";
+export { CatalogCheckoutStartError, checkoutStartSchema, startCatalogCheckout, } from "./start-service.js";

package/dist/checkout/materialization-support.d.ts

@@ -0,0 +1,105 @@
+import type { bookings } from "@voyant-travel/bookings/schema";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import type { DraftPayload, MaterializationSnapshot } from "./materialization.js";
+import type { CheckoutModuleOptions } from "./options.js";
+interface InsertedBookingItem {
+    id: string;
+    quantity?: number | null;
+    optionId?: string | null;
+    optionUnitId?: string | null;
+}
+export declare function materializeBookingAllocations(db: PostgresJsDatabase, booking: typeof bookings.$inferSelect, insertedItems: ReadonlyArray<InsertedBookingItem>, draftPayload: DraftPayload, snapshot: MaterializationSnapshot): Promise<void>;
+export declare function inferSnapshotTaxFacts(snapshot: MaterializationSnapshot): {
+    hasAccommodation: boolean;
+    accommodationCountries: string[];
+};
+export declare function materializeTravelerTravelDetails(db: PostgresJsDatabase, insertedTravelers: Array<{
+    id: string;
+}>, draftTravelers: NonNullable<DraftPayload["travelers"]>, env: Record<string, unknown>): Promise<void>;
+/**
+ * Resolve supplier info for the booking from the catalog snapshot.
+ * Pulls from:
+ *   1. `catalog_sourced_entries.projection.supplierId` — supplier
+ *      name/id captured at sync time (covers Bokun, demo adapter, etc.).
+ *   2. The frozen payload's `upstream_payload.supplierId` — fallback
+ *      when the sourced-entries row is missing (legacy bookings).
+ *   3. `frozen_payload.reserve.orderId` — used as `supplierReference`
+ *      so operators can match up against the upstream provider's
+ *      booking reference.
+ *
+ * Returns null when no supplier can be resolved — the caller treats
+ * that as "skip auto-fill, leave blank for manual entry".
+ */
+export declare function resolveSupplierFromSnapshot(db: PostgresJsDatabase, snapshot: MaterializationSnapshot): Promise<{
+    serviceName: string;
+    supplierReference: string | null;
+    supplierServiceId: string | null;
+    upstreamCostCents: number | null;
+} | null>;
+/**
+ * Resolve booking-level dates from the draft and frozen source data.
+ * `start_date`/`end_date` drive the admin booking header, while item
+ * dates drive the line table. A storefront product selection usually
+ * carries only `departureSlotId`, so we resolve that id against the
+ * quote/reserve/content payload before falling back to free-form dates.
+ */
+export declare function extractBookingDates(snapshot: Pick<MaterializationSnapshot, "frozen_payload">, draftPayload: DraftPayload): {
+    startDate: string | null;
+    endDate: string | null;
+};
+/**
+ * Pull start/end dates for a booking-item from the most reliable
+ * source available. Order:
+ *   1. The selected `departureSlotId` resolved against reserve /
+ *      quote / captured content payloads.
+ *   2. `frozen_payload.quote.upstream_payload.metadata.days[]` —
+ *      Bokun-style itinerary captured at quote time, gives us per-day
+ *      dates with full timezone fidelity.
+ *   3. Draft `configure.dateRange.checkIn`/`checkOut` — what the
+ *      customer selected on the storefront before booking.
+ *   4. Draft `configure.departureDate` — single-day tour selection.
+ *   5. Booking row's own `start_date` / `end_date` columns — the
+ *      caller already populated these from the same draft when
+ *      writing the booking row, so this is a final safety net.
+ *
+ * Returns nulls when nothing resolves — the caller treats that as
+ * "no date data, leave NULL" rather than fabricating one.
+ */
+export declare function extractItemDates(snapshot: MaterializationSnapshot, draftPayload: DraftPayload, booking: typeof bookings.$inferSelect): {
+    serviceDate: string | null;
+    startsAt: Date | null;
+    endsAt: Date | null;
+};
+/**
+ * Pull a description for the booking item from the upstream payload.
+ * Sourced products typically carry rich descriptions on the upstream
+ * entry; surfacing a short snippet on the item helps operators scan
+ * a multi-item booking without clicking into each line.
+ */
+export declare function extractItemDescription(snapshot: MaterializationSnapshot): string | null;
+/**
+ * Look up the upstream cost (net rate the operator pays the supplier)
+ * for a sourced entity. Returns null when the adapter doesn't expose
+ * a net/gross split — caller falls back to sell-as-cost (zero-markup
+ * default).
+ */
+export declare function resolveUpstreamCostCents(db: PostgresJsDatabase, snapshot: MaterializationSnapshot): Promise<number | null>;
+/**
+ * Resolve a human title for the booking line item. Tries:
+ *   1. `catalog_sourced_entries.projection.name` — sourced products
+ *      (demo, Bokun, …) all carry the upstream title there.
+ *   2. The injected `getOwnedProductName` — owned products from this
+ *      deployment's products module (injected because inventory
+ *      depends on commerce; a static import would cycle).
+ *   3. A generic "$module booking" fallback.
+ *
+ * Errors fall through quietly — a title is purely cosmetic, the
+ * booking-item row should always insert successfully.
+ */
+export declare function resolveLineItemTitle(db: PostgresJsDatabase, snapshot: {
+    entity_module: string;
+    entity_id: string;
+}, options: Pick<CheckoutModuleOptions, "getOwnedProductName">): Promise<string>;
+export declare function travelerBandToCategory(band: string | undefined): "adult" | "child" | "infant" | "senior" | "other";
+export {};
+//# sourceMappingURL=materialization-support.d.ts.map

package/dist/checkout/materialization-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialization-support.d.ts","sourceRoot":"","sources":["../../src/checkout/materialization-support.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AAE9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AACjF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAEzD,UAAU,mBAAmB;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED,wBAAsB,6BAA6B,CACjD,EAAE,EAAE,kBAAkB,EACtB,OAAO,EAAE,OAAO,QAAQ,CAAC,YAAY,EACrC,aAAa,EAAE,aAAa,CAAC,mBAAmB,CAAC,EACjD,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,uBAAuB,GAChC,OAAO,CAAC,IAAI,CAAC,CAkCf;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,uBAAuB;;;EAOtE;AAgCD,wBAAsB,gCAAgC,CACpD,EAAE,EAAE,kBAAkB,EACtB,iBAAiB,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,EACxC,cAAc,EAAE,WAAW,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC,EACtD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC,CAaf;AAmED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,2BAA2B,CAC/C,EAAE,EAAE,kBAAkB,EACtB,QAAQ,EAAE,uBAAuB,GAChC,OAAO,CAAC;IACT,WAAW,EAAE,MAAM,CAAA;IACnB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;CACjC,GAAG,IAAI,CAAC,CA4DR;AAuBD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,IAAI,CAAC,uBAAuB,EAAE,gBAAgB,CAAC,EACzD,YAAY,EAAE,YAAY,GACzB;IAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAyBtD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,uBAAuB,EACjC,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,OAAO,QAAQ,CAAC,YAAY,GACpC;IAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,IAAI,GAAG,IAAI,CAAA;CAAE,CA6E5E;AAqED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,GAAG,IAAI,CAQvF;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,EAAE,EAAE,kBAAkB,EACtB,QAAQ,EAAE,uBAAuB,GAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAsBxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,kBAAkB,EACtB,QAAQ,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EACtD,OAAO,EAAE,IAAI,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,GAC1D,OAAO,CAAC,MAAM,CAAC,CAkCjB;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAGnD"}