@voyant-travel/commerce 0.2.3 → 0.3.0

package/dist/checkout/materialization-tax.js

@@ -0,0 +1,113 @@
+import { bookingItemTaxLines, computeBookingItemTaxLine, resolveBookingSellTaxRate, } from "@voyant-travel/finance";
+import { eq } from "drizzle-orm";
+import { inferSnapshotTaxFacts } from "./materialization-support.js";
+export async function rebuildBookingItemTaxLines(db, bookingId, options) {
+    const { bookingItems: bookingItemsTable, bookings: bookingsTable } = await import("@voyant-travel/bookings/schema");
+    const { bookingCatalogSnapshotTable } = await import("@voyant-travel/catalog");
+    const [booking] = await db
+        .select()
+        .from(bookingsTable)
+        .where(eq(bookingsTable.id, bookingId))
+        .limit(1);
+    if (!booking)
+        return { rebuilt: 0, itemsWithoutSnapshot: 0 };
+    const items = await db
+        .select()
+        .from(bookingItemsTable)
+        .where(eq(bookingItemsTable.bookingId, bookingId));
+    let rebuilt = 0;
+    let itemsWithoutSnapshot = 0;
+    for (const item of items) {
+        const snapshot = await loadSnapshotForItem(db, bookingCatalogSnapshotTable, item);
+        if (!snapshot) {
+            itemsWithoutSnapshot += 1;
+            continue;
+        }
+        await db.delete(bookingItemTaxLines).where(eq(bookingItemTaxLines.bookingItemId, item.id));
+        await materializeBookingItemTaxLine(db, booking, item.id, item.totalSellAmountCents ?? 0, snapshot, options);
+        rebuilt += 1;
+    }
+    return { rebuilt, itemsWithoutSnapshot };
+}
+async function loadSnapshotForItem(db, snapshotTable, item) {
+    const snapshotId = item.sourceSnapshotId;
+    if (!snapshotId) {
+        // Item wasn't materialized from a catalog snapshot; fall back to the
+        // booking-level snapshot if there is exactly one for this booking.
+        const rows = await db
+            .select()
+            .from(snapshotTable)
+            .where(eq(snapshotTable.booking_id, item.bookingId))
+            .limit(2);
+        return rows.length === 1 && rows[0] ? toMaterializationSnapshot(rows[0]) : null;
+    }
+    const [row] = await db
+        .select()
+        .from(snapshotTable)
+        .where(eq(snapshotTable.id, snapshotId))
+        .limit(1);
+    return row ? toMaterializationSnapshot(row) : null;
+}
+function toMaterializationSnapshot(row) {
+    return {
+        id: row.id,
+        entity_module: row.entity_module,
+        entity_id: row.entity_id,
+        source_kind: row.source_kind,
+        source_provider: row.source_provider,
+        source_ref: row.source_ref,
+        frozen_payload: row.frozen_payload,
+        pricing_base_amount: row.pricing_base_amount != null ? String(row.pricing_base_amount) : null,
+        pricing_taxes: row.pricing_taxes != null ? String(row.pricing_taxes) : null,
+        pricing_fees: row.pricing_fees != null ? String(row.pricing_fees) : null,
+        pricing_surcharges: row.pricing_surcharges != null ? String(row.pricing_surcharges) : null,
+        pricing_currency: row.pricing_currency,
+    };
+}
+export async function materializeBookingItemTaxLine(db, booking, bookingItemId, amountCents, snapshot, options) {
+    const currency = booking.sellCurrency ?? snapshot.pricing_currency ?? "EUR";
+    const taxRate = await resolveBookingSellTaxRate(db, {
+        productId: snapshot.entity_module === "products" ? snapshot.entity_id : null,
+        facts: inferSnapshotTaxFacts(snapshot),
+    }, {
+        resolveBookingTaxSettings: options.resolveBookingTaxSettings,
+    });
+    const policyLine = computeBookingItemTaxLine(taxRate, amountCents, currency);
+    // Fall back to the snapshot's `pricing_taxes` when the operator has no
+    // tax policy configured. Without this the booking page (which reads the
+    // snapshot directly) shows tax but the invoice (which reads
+    // `booking_item_tax_lines`) shows zero — operators see a mismatch.
+    // The booking total already includes this tax (sellAmountCents = base +
+    // taxes + fees + surcharges), so the row is `includedInPrice: true`.
+    const fallbackLine = policyLine ? null : buildSnapshotFallbackTaxLine(snapshot, currency);
+    const taxLine = policyLine ?? fallbackLine;
+    if (!taxLine)
+        return;
+    await db
+        .insert(bookingItemTaxLines)
+        .values({
+        bookingItemId,
+        ...taxLine,
+    })
+        .onConflictDoNothing();
+}
+function buildSnapshotFallbackTaxLine(snapshot, currency) {
+    if (!snapshot.pricing_taxes)
+        return null;
+    const taxAmount = Number.parseFloat(snapshot.pricing_taxes);
+    if (!Number.isFinite(taxAmount) || taxAmount <= 0)
+        return null;
+    const taxCents = Math.round(taxAmount);
+    if (taxCents <= 0)
+        return null;
+    return {
+        code: "snapshot/tax",
+        name: "Tax",
+        scope: "included",
+        currency,
+        amountCents: taxCents,
+        rateBasisPoints: null,
+        includedInPrice: true,
+        sortOrder: 0,
+    };
+}

package/dist/checkout/materialization-tax.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=materialization-tax.test.d.ts.map

package/dist/checkout/materialization-tax.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialization-tax.test.d.ts","sourceRoot":"","sources":["../../src/checkout/materialization-tax.test.ts"],"names":[],"mappings":""}

package/dist/checkout/materialization-tax.test.js

@@ -0,0 +1,69 @@
+import { describe, expect, it, vi } from "vitest";
+import { materializeBookingItemTaxLine } from "./materialization-tax.js";
+vi.mock("@voyant-travel/finance", async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        // Force "no tax policy" so the snapshot-fallback path is exercised.
+        resolveBookingSellTaxRate: vi.fn().mockResolvedValue(null),
+        computeBookingItemTaxLine: vi.fn().mockReturnValue(null),
+    };
+});
+function snapshot(overrides = {}) {
+    return {
+        id: "snap_1",
+        entity_module: "products",
+        entity_id: "prod_1",
+        source_kind: "demo",
+        source_provider: null,
+        source_ref: null,
+        frozen_payload: null,
+        pricing_base_amount: null,
+        pricing_taxes: null,
+        pricing_fees: null,
+        pricing_surcharges: null,
+        pricing_currency: "EUR",
+        ...overrides,
+    };
+}
+const booking = { sellCurrency: "EUR" };
+describe("materializeBookingItemTaxLine", () => {
+    it("writes a snapshot-fallback tax line when no policy line resolves", async () => {
+        const inserted = [];
+        const db = {
+            insert: () => ({
+                values: (v) => ({
+                    onConflictDoNothing: async () => {
+                        inserted.push(v);
+                    },
+                }),
+            }),
+        };
+        await materializeBookingItemTaxLine(db, booking, "item_1", 11900, snapshot({ pricing_taxes: "1900" }), {
+            resolveBookingTaxSettings: vi.fn(),
+        });
+        expect(inserted).toHaveLength(1);
+        expect(inserted[0]).toMatchObject({
+            bookingItemId: "item_1",
+            code: "snapshot/tax",
+            amountCents: 1900,
+            includedInPrice: true,
+        });
+    });
+    it("writes nothing when there is no policy line and no snapshot tax", async () => {
+        const inserted = [];
+        const db = {
+            insert: () => ({
+                values: (v) => ({
+                    onConflictDoNothing: async () => {
+                        inserted.push(v);
+                    },
+                }),
+            }),
+        };
+        await materializeBookingItemTaxLine(db, booking, "item_1", 10000, snapshot(), {
+            resolveBookingTaxSettings: vi.fn(),
+        });
+        expect(inserted).toHaveLength(0);
+    });
+});

package/dist/checkout/materialization.d.ts

@@ -0,0 +1,99 @@
+import { bookings } from "@voyant-travel/bookings/schema";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import type { CheckoutModuleOptions } from "./options.js";
+export { rebuildBookingItemTaxLines } from "./materialization-tax.js";
+/**
+ * Look up the catalog snapshot for a `bookingId` (the catalog plane
+ * always writes one) and materialize a real bookings row plus the
+ * traveler / item children. Used when /book went through the sourced
+ * arm — sourced adapters don't write to the bookings table directly,
+ * so the checkout flow has to bridge the snapshot into normal
+ * booking shape before it can place payment sessions, transition
+ * status, etc.
+ *
+ * The booking_drafts table carries the customer-entered detail
+ * (passengers, billing contact, configure pax / dates) — we look
+ * up the draft via `consumed_booking_id` and pull contact + traveler
+ * rows out of it. Snapshot supplies pricing + entity refs.
+ */
+export declare function materializeBookingFromSnapshot(db: PostgresJsDatabase, bookingId: string, env: Record<string, unknown>, options: CheckoutModuleOptions): Promise<typeof bookings.$inferSelect | null>;
+export interface DraftPayload {
+    billing?: {
+        contact?: {
+            firstName?: string;
+            lastName?: string;
+            email?: string;
+            phone?: string;
+        };
+        address?: {
+            country?: string;
+            city?: string;
+            line1?: string;
+            line2?: string;
+            postal?: string;
+        };
+    };
+    configure?: {
+        pax?: {
+            adult?: number;
+            child?: number;
+            infant?: number;
+        };
+        departureSlotId?: string;
+        departureDate?: string;
+        dateRange?: {
+            checkIn?: string;
+            checkOut?: string;
+        };
+    };
+    travelers?: Array<{
+        rowId?: string;
+        firstName?: string;
+        lastName?: string;
+        email?: string;
+        phone?: string;
+        band?: string;
+        dateOfBirth?: string;
+        nationality?: string;
+        documentType?: "passport" | "id_card" | "driver_license" | "visa" | "other";
+        documentNumber?: string;
+        documentExpiry?: string;
+        passportNumber?: string;
+        passportExpiry?: string;
+        passportExpiresAt?: string;
+        dietaryRequirements?: string;
+        accessibilityNeeds?: string;
+        preferredLanguage?: string;
+        specialRequests?: string;
+        isPrimary?: boolean;
+        isLeadTraveler?: boolean;
+        documents?: Record<string, unknown>;
+    }>;
+    entity?: {
+        module?: string;
+        id?: string;
+    };
+    internalNotes?: string;
+}
+/**
+ * Snapshot subset `materializeChildren` reads from. The catalog table
+ * has more columns (idempotency_key, captured_at, etc.), but children
+ * materialization only needs the parts that drive line items + supplier
+ * statuses.
+ */
+export type MaterializationSnapshot = {
+    /** Snapshot id — stamped on each `booking_items.source_snapshot_id`. */
+    id?: string;
+    entity_module: string;
+    entity_id: string;
+    source_kind: string;
+    source_provider: string | null;
+    source_ref: string | null;
+    frozen_payload: Record<string, unknown> | null;
+    pricing_base_amount: string | null;
+    pricing_taxes: string | null;
+    pricing_fees: string | null;
+    pricing_surcharges: string | null;
+    pricing_currency: string | null;
+};
+//# sourceMappingURL=materialization.d.ts.map

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

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

package/dist/checkout/materialization.js

@@ -0,0 +1,269 @@
+// agent-quality: file-size exception -- owner: commerce; the snapshot→booking
+// materialization (parent row + traveler/item/allocation/supplier children) is
+// one cohesive bridge; splitting it would scatter a single checkout step.
+import { bookings } from "@voyant-travel/bookings/schema";
+import { OWNED_SOURCE_KIND } from "@voyant-travel/catalog/booking-engine";
+import { eq } from "drizzle-orm";
+import { extractBookingDates, extractItemDates, extractItemDescription, materializeBookingAllocations, materializeTravelerTravelDetails, resolveLineItemTitle, resolveSupplierFromSnapshot, resolveUpstreamCostCents, travelerBandToCategory, } from "./materialization-support.js";
+import { materializeBookingItemTaxLine } from "./materialization-tax.js";
+export { rebuildBookingItemTaxLines } from "./materialization-tax.js";
+/**
+ * Look up the catalog snapshot for a `bookingId` (the catalog plane
+ * always writes one) and materialize a real bookings row plus the
+ * traveler / item children. Used when /book went through the sourced
+ * arm — sourced adapters don't write to the bookings table directly,
+ * so the checkout flow has to bridge the snapshot into normal
+ * booking shape before it can place payment sessions, transition
+ * status, etc.
+ *
+ * The booking_drafts table carries the customer-entered detail
+ * (passengers, billing contact, configure pax / dates) — we look
+ * up the draft via `consumed_booking_id` and pull contact + traveler
+ * rows out of it. Snapshot supplies pricing + entity refs.
+ */
+export async function materializeBookingFromSnapshot(db, bookingId, env, options) {
+    const { bookingCatalogSnapshotTable } = await import("@voyant-travel/catalog");
+    const { bookingDraftsTable } = await import("@voyant-travel/catalog/booking-engine");
+    const [snapshot] = await db
+        .select()
+        .from(bookingCatalogSnapshotTable)
+        .where(eq(bookingCatalogSnapshotTable.booking_id, bookingId))
+        .limit(1);
+    if (!snapshot)
+        return null;
+    const baseAmount = snapshot.pricing_base_amount
+        ? Number.parseFloat(String(snapshot.pricing_base_amount))
+        : 0;
+    const taxes = snapshot.pricing_taxes ? Number.parseFloat(String(snapshot.pricing_taxes)) : 0;
+    const fees = snapshot.pricing_fees ? Number.parseFloat(String(snapshot.pricing_fees)) : 0;
+    const surcharges = snapshot.pricing_surcharges
+        ? Number.parseFloat(String(snapshot.pricing_surcharges))
+        : 0;
+    const sellAmountCents = Math.round(baseAmount + taxes + fees + surcharges);
+    const sellCurrency = snapshot.pricing_currency ?? "EUR";
+    // Pull the consuming draft so we can copy the customer-entered
+    // billing contact + travelers + dates into the booking row.
+    const [draftRow] = await db
+        .select()
+        .from(bookingDraftsTable)
+        .where(eq(bookingDraftsTable.consumed_booking_id, bookingId))
+        .limit(1);
+    const draftPayload = (draftRow?.draft_payload ?? {});
+    const frozenPayload = (snapshot.frozen_payload ?? {});
+    const bookingDates = extractBookingDates({
+        frozen_payload: frozenPayload,
+    }, draftPayload);
+    const billingContact = draftPayload.billing?.contact;
+    const billingAddress = draftPayload.billing?.address;
+    const config = draftPayload.configure;
+    const pax = config?.pax;
+    const totalPax = pax ? (pax.adult ?? 0) + (pax.child ?? 0) + (pax.infant ?? 0) : null;
+    const startDate = bookingDates.startDate;
+    const endDate = bookingDates.endDate;
+    const bookingNumber = `BK-${bookingId.slice(-12).toUpperCase()}`;
+    const [row] = await db
+        .insert(bookings)
+        .values({
+        id: bookingId,
+        bookingNumber,
+        status: "on_hold",
+        sourceType: "direct",
+        sellCurrency,
+        sellAmountCents,
+        contactFirstName: billingContact?.firstName ?? null,
+        contactLastName: billingContact?.lastName ?? null,
+        contactEmail: billingContact?.email ?? null,
+        contactPhone: billingContact?.phone ?? null,
+        contactCountry: billingAddress?.country ?? null,
+        contactCity: billingAddress?.city ?? null,
+        contactAddressLine1: billingAddress?.line1 ?? null,
+        contactAddressLine2: billingAddress?.line2 ?? null,
+        contactPostalCode: billingAddress?.postal ?? null,
+        startDate,
+        endDate,
+        pax: totalPax && totalPax > 0 ? totalPax : null,
+        internalNotes: typeof draftPayload.internalNotes === "string" ? draftPayload.internalNotes : null,
+    })
+        .onConflictDoNothing({ target: bookings.id })
+        .returning();
+    const inserted = row ?? null;
+    // Materialize travelers + a single line item per booked entity so
+    // the operator detail page has something to render. No-ops on
+    // re-entry (race or retry) because we only run this when the
+    // bookings row was just inserted.
+    if (inserted) {
+        await materializeChildren(db, inserted, {
+            id: snapshot.id,
+            entity_module: snapshot.entity_module,
+            entity_id: snapshot.entity_id,
+            source_kind: snapshot.source_kind,
+            source_provider: snapshot.source_provider,
+            source_ref: snapshot.source_ref,
+            frozen_payload: (snapshot.frozen_payload ?? {}),
+            pricing_base_amount: snapshot.pricing_base_amount != null ? String(snapshot.pricing_base_amount) : null,
+            pricing_taxes: snapshot.pricing_taxes != null ? String(snapshot.pricing_taxes) : null,
+            pricing_fees: snapshot.pricing_fees != null ? String(snapshot.pricing_fees) : null,
+            pricing_surcharges: snapshot.pricing_surcharges != null ? String(snapshot.pricing_surcharges) : null,
+            pricing_currency: snapshot.pricing_currency,
+        }, draftPayload, env, options);
+    }
+    if (inserted)
+        return inserted;
+    // Race: another request already inserted; re-fetch.
+    const [existing] = await db.select().from(bookings).where(eq(bookings.id, bookingId)).limit(1);
+    return existing ?? null;
+}
+async function materializeChildren(db, booking, snapshot, draftPayload, env, options) {
+    const { bookingTravelers, bookingItems, bookingSupplierStatuses } = await import("@voyant-travel/bookings/schema");
+    const travelers = draftPayload.travelers ?? [];
+    if (travelers.length > 0) {
+        const travelerRows = travelers
+            .map((t, idx) => ({
+            draftTraveler: t,
+            row: {
+                bookingId: booking.id,
+                firstName: t.firstName ?? "Traveler",
+                lastName: t.lastName ?? `${idx + 1}`,
+                email: t.email ?? null,
+                phone: t.phone ?? null,
+                travelerCategory: travelerBandToCategory(t.band),
+                preferredLanguage: t.preferredLanguage ?? null,
+                specialRequests: t.specialRequests ?? null,
+                isPrimary: t.isPrimary ?? t.isLeadTraveler ?? idx === 0,
+            },
+        }))
+            .filter(({ draftTraveler }) => {
+            return ((draftTraveler.firstName?.length ?? 0) > 0 || (draftTraveler.lastName?.length ?? 0) > 0);
+        });
+        const rows = travelerRows.map(({ row }) => row);
+        if (rows.length > 0) {
+            const insertedTravelers = await db.insert(bookingTravelers).values(rows).returning();
+            try {
+                await materializeTravelerTravelDetails(db, insertedTravelers, travelerRows.map(({ draftTraveler }) => draftTraveler), env);
+            }
+            catch (err) {
+                console.warn("[catalog-checkout] traveler travel-details materialization failed", err);
+            }
+        }
+    }
+    // One item summarizing the booked entity, so the items tab isn't
+    // empty. Real verticals (cruises with cabin lines, accommodations with
+    // room lines) fan this out per their own conventions; this is the
+    // generic fallback so sourced products show up in the UI.
+    //
+    // Resolve a real product title rather than the dumb fallback
+    // "Tour booking". For sourced products, the projection captured
+    // by `catalog_sourced_entries` carries the upstream name; for
+    // owned products, the local `products.title` is canonical.
+    const resolvedTitle = await resolveLineItemTitle(db, snapshot, options);
+    const itemDates = extractItemDates(snapshot, draftPayload, booking);
+    const itemDescription = extractItemDescription(snapshot);
+    // Item-level cost mirrors the booking-level cost we set later: when
+    // the upstream provides a net rate (Bokun-style net/gross split),
+    // use it; otherwise fall back to sell. Owned bookings skip cost on
+    // the item — the operator IS the supplier, no "cost" makes sense.
+    const sellAmountCents = booking.sellAmountCents ?? 0;
+    const upstreamCostCents = snapshot.source_kind !== OWNED_SOURCE_KIND ? await resolveUpstreamCostCents(db, snapshot) : null;
+    const itemCostAmountCents = snapshot.source_kind !== OWNED_SOURCE_KIND ? (upstreamCostCents ?? sellAmountCents) : null;
+    const itemQuantity = booking.pax ?? 1;
+    const insertedItems = await db
+        .insert(bookingItems)
+        .values({
+        bookingId: booking.id,
+        title: resolvedTitle,
+        description: itemDescription,
+        productId: snapshot.entity_module === "products" ? snapshot.entity_id : null,
+        quantity: itemQuantity,
+        itemType: "service",
+        status: "on_hold",
+        serviceDate: itemDates.serviceDate ?? null,
+        startsAt: itemDates.startsAt ?? null,
+        endsAt: itemDates.endsAt ?? null,
+        unitSellAmountCents: booking.pax && booking.pax > 0 && booking.sellAmountCents
+            ? Math.round(booking.sellAmountCents / booking.pax)
+            : (booking.sellAmountCents ?? 0),
+        totalSellAmountCents: booking.sellAmountCents ?? 0,
+        sellCurrency: booking.sellCurrency,
+        ...(itemCostAmountCents != null
+            ? {
+                costCurrency: booking.sellCurrency,
+                unitCostAmountCents: itemQuantity > 0
+                    ? Math.round(itemCostAmountCents / itemQuantity)
+                    : itemCostAmountCents,
+                totalCostAmountCents: itemCostAmountCents,
+            }
+            : {}),
+        sourceSnapshotId: snapshot.id ?? null,
+    })
+        .onConflictDoNothing()
+        .returning();
+    for (const item of insertedItems) {
+        await materializeBookingItemTaxLine(db, booking, item.id, item.totalSellAmountCents ?? 0, snapshot, options);
+    }
+    await materializeBookingAllocations(db, booking, insertedItems, draftPayload, snapshot);
+    // Sourced bookings: auto-populate the supplier-status row + booking
+    // cost columns from the catalog snapshot. Without this the operator
+    // sees an empty "Furnizori" tab and "Cost / Marja —" on a deal
+    // we already know the supplier for. Owned bookings skip — the
+    // operator IS the supplier.
+    if (snapshot.source_kind !== OWNED_SOURCE_KIND) {
+        const supplierInfo = await resolveSupplierFromSnapshot(db, snapshot);
+        if (supplierInfo) {
+            // Cost = sell as a working assumption (zero-markup default).
+            // Operators with a configured net/gross split should override
+            // via the supplier-status edit form. We mark the row's notes so
+            // it's clear this came from auto-fill, not from a real
+            // supplier confirmation.
+            const costAmountCents = supplierInfo.upstreamCostCents ?? sellAmountCents;
+            const costCurrency = booking.sellCurrency;
+            try {
+                await db
+                    .insert(bookingSupplierStatuses)
+                    .values({
+                    bookingId: booking.id,
+                    supplierServiceId: supplierInfo.supplierServiceId ?? null,
+                    serviceName: supplierInfo.serviceName,
+                    supplierReference: supplierInfo.supplierReference ?? null,
+                    costCurrency,
+                    costAmountCents,
+                    status: "pending",
+                    notes: `Auto-populated from ${snapshot.source_kind} catalog snapshot. ` +
+                        "Verify against supplier confirmation when it lands.",
+                })
+                    .onConflictDoNothing();
+            }
+            catch (err) {
+                console.warn("[catalog-checkout] auto supplier-status insert failed", err);
+            }
+            // Stamp booking-level cost so the header's Cost/Marja card
+            // shows something meaningful. Margin computed against the
+            // current cost+sell — when sell == cost, margin is 0; that's
+            // accurate for our zero-markup default until the operator
+            // updates the cost.
+            try {
+                const margin = sellAmountCents > 0
+                    ? Math.round(((sellAmountCents - costAmountCents) / sellAmountCents) * 100)
+                    : 0;
+                const baseCurrencyMatches = booking.baseCurrency != null && booking.baseCurrency === booking.sellCurrency;
+                await db
+                    .update(bookings)
+                    .set({
+                    costAmountCents,
+                    // Only set base_cost_amount_cents when base_currency is
+                    // already set on the booking. The check constraint
+                    // `ck_bookings_base_currency_amounts` rejects setting
+                    // base_*_amount with no base_currency.
+                    baseCostAmountCents: baseCurrencyMatches
+                        ? costAmountCents
+                        : booking.baseCostAmountCents,
+                    marginPercent: margin,
+                    updatedAt: new Date(),
+                })
+                    .where(eq(bookings.id, booking.id));
+            }
+            catch (err) {
+                console.warn("[catalog-checkout] booking cost update failed", err);
+            }
+        }
+    }
+}

package/dist/checkout/options.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Deployment-supplied options for the catalog-checkout cluster.
+ *
+ * The checkout business logic (materialization, tax, start-service,
+ * acceptance signature) lives in `@voyant-travel/commerce`. The two
+ * genuinely deployment-specific dependencies are injected here as
+ * structural functions so the package never statically imports the
+ * deployment, and — crucially — never imports `@voyant-travel/inventory`
+ * (which already depends on `@voyant-travel/commerce`; a static import
+ * would cycle).
+ *
+ *   - `resolveBookingTaxSettings` — reads the operator's tax-mode /
+ *     tax-policy-profile row. The deployment owns the settings table.
+ *   - `getOwnedProductName` — resolves an owned product's title for the
+ *     line-item fallback. The package can't import inventory's
+ *     `productsService.getProductById` without cycling, so the
+ *     deployment hands it in.
+ *   - `resolveBankTransferInstructions` — reads the operator profile +
+ *     payment-instruction rows for the bank-transfer checkout path.
+ */
+import type { BookingTaxSettings } from "@voyant-travel/finance";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+/**
+ * Bank-transfer instructions surfaced on the bank_transfer_instructions
+ * checkout result. The deployment composes these from its operator
+ * profile / payment-instruction rows + env fallbacks.
+ */
+export interface CheckoutBankTransferInstructions {
+    beneficiary: string;
+    iban: string;
+    bankName: string;
+}
+/**
+ * Options shared by the checkout materialization + start-service. All
+ * structural — no deployment imports, no platform bindings.
+ */
+export interface CheckoutModuleOptions {
+    /**
+     * Read the operator's booking tax settings (tax-price mode + policy
+     * profile). Modelled on the operator's `resolveBookingTaxSettings`;
+     * structural so commerce doesn't import the deployment settings table.
+     */
+    resolveBookingTaxSettings(db: PostgresJsDatabase): Promise<BookingTaxSettings>;
+    /**
+     * Resolve an owned product's display name for the line-item title
+     * fallback. INJECTED because `@voyant-travel/inventory` depends on
+     * `@voyant-travel/commerce` — a static import would cycle. Returns the
+     * product name, or null when not an owned product / not found.
+     */
+    getOwnedProductName(db: PostgresJsDatabase, entityModule: string, entityId: string): Promise<string | null>;
+}
+/**
+ * Options for the checkout-start service (`startCatalogCheckout`). Extends
+ * the shared module options with the bank-transfer instruction reader the
+ * bank_transfer path needs.
+ */
+export interface CheckoutStartOptions extends CheckoutModuleOptions {
+    /**
+     * Resolve the bank-transfer instructions for the bank_transfer payment
+     * intent. The deployment reads its operator profile / payment
+     * instructions and applies env fallbacks.
+     */
+    resolveBankTransferInstructions(db: PostgresJsDatabase, env: Record<string, string | undefined>): Promise<CheckoutBankTransferInstructions>;
+    /**
+     * Start the card-payment provider session for the `card` checkout intent.
+     * INJECTED so commerce never imports a specific payment provider (which
+     * would pull a provider package into the retail-spine closure). The
+     * deployment owns the provider choice (e.g. Netopia) and the
+     * provider-specific placeholder billing.
+     *
+     * Returns `{ redirectUrl }` to redirect the customer to the provider, or
+     * `null`/`undefined` when no card provider is configured — in which case
+     * the checkout falls back to the `card_pending` confirmation-page poll.
+     */
+    startCardPayment?(params: {
+        db: PostgresJsDatabase;
+        sessionId: string;
+        billing: {
+            email: string;
+            firstName: string;
+            lastName: string;
+        };
+        description: string;
+        returnUrl?: string;
+    }): Promise<{
+        redirectUrl: string | null;
+    } | null>;
+}
+//# sourceMappingURL=options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/checkout/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE;;;;GAIG;AACH,MAAM,WAAW,gCAAgC;IAC/C,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAC9E;;;;;OAKG;IACH,mBAAmB,CACjB,EAAE,EAAE,kBAAkB,EACtB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,qBAAqB;IACjE;;;;OAIG;IACH,+BAA+B,CAC7B,EAAE,EAAE,kBAAkB,EACtB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,OAAO,CAAC,gCAAgC,CAAC,CAAA;IAC5C;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,CAAC,MAAM,EAAE;QACxB,EAAE,EAAE,kBAAkB,CAAA;QACtB,SAAS,EAAE,MAAM,CAAA;QACjB,OAAO,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAA;QAC/D,WAAW,EAAE,MAAM,CAAA;QACnB,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;CACnD"}