@voyant-travel/finance 0.120.2 → 0.122.0

package/dist/card-payment.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Provider-agnostic card-payment seam.
+ *
+ * Finance defines the neutral contract a deployment's chosen card processor
+ * implements; checkout surfaces (flights, trips checkout, payment links,
+ * catalog) route card payments through a single `CardPaymentStarter` rather
+ * than importing any specific provider. The Netopia (or Stripe/Adyen/…)
+ * implementation lives in the provider's own package — finance never names a
+ * processor.
+ *
+ * Returning `null` from a starter means "this processor isn't configured" so
+ * callers fall back gracefully (bank-transfer paths still work).
+ */
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import type { Context } from "hono";
+/**
+ * Billing details a card processor needs to start a hosted payment.
+ *
+ * Field names are kept structurally compatible with a provider's own billing
+ * shape (e.g. Netopia's `NetopiaBillingAddress`) so callers' existing billing
+ * objects satisfy this without reshaping. `country` accepts a numeric code or
+ * ISO string depending on the processor.
+ */
+export interface CardPaymentBilling {
+    email: string;
+    phone?: string;
+    firstName: string;
+    lastName?: string;
+    city?: string;
+    country?: number | string;
+    state?: string;
+    postalCode?: string;
+    details?: string;
+}
+/** Arguments a caller maps from its checkout surface to start a card payment. */
+export interface CardPaymentStartArgs {
+    db: PostgresJsDatabase;
+    sessionId: string;
+    billing: CardPaymentBilling;
+    description?: string;
+    returnUrl?: string;
+}
+/** Result of a card-payment start: the hosted-payment URL to redirect to. */
+export interface CardPaymentStartResult {
+    redirectUrl: string | null;
+}
+/**
+ * The neutral card-payment starter contract. A deployment selects exactly one
+ * implementation (its chosen processor) and every checkout surface routes
+ * through it.
+ *
+ * `c` carries the request env + container so a processor can resolve its own
+ * request-scoped runtime. Returning `null` means "this processor isn't
+ * configured" — callers fall back (bank transfer still works).
+ */
+export type CardPaymentStarter = (c: Context, args: CardPaymentStartArgs) => Promise<CardPaymentStartResult | null>;
+//# sourceMappingURL=card-payment.d.ts.map

package/dist/card-payment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-payment.d.ts","sourceRoot":"","sources":["../src/card-payment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,iFAAiF;AACjF,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,kBAAkB,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,kBAAkB,CAAA;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,6EAA6E;AAC7E,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,CAAC,EAAE,OAAO,EACV,IAAI,EAAE,oBAAoB,KACvB,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAA"}

package/dist/card-payment.js

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -31,10 +31,14 @@ export interface FinanceHonoModuleOptions extends FinanceRuntimeOptions, PublicF
 export declare function createFinanceHonoModule(options?: FinanceHonoModuleOptions): HonoModule;
 export declare const financeHonoModule: HonoModule;
 export { type BookingTaxRouteOptions, type BookingTaxSettings, computeBookingItemTaxLine, createBookingTaxHonoExtension, createBookingTaxRoutes, loadProductTaxFacts, matchesTaxPolicyCondition, mountBookingTaxRoutes, type ProductTaxFacts, type ResolveBookingSellTaxRateOptions, type ResolveBookingTaxSettings, type ResolvedBookingSellTaxRate, resolveBookingSellTaxRate, type TaxPolicyCondition, type UpdateBookingTaxSettings, } from "./booking-tax.js";
+export type { CardPaymentBilling, CardPaymentStartArgs, CardPaymentStarter, CardPaymentStartResult, } from "./card-payment.js";
 export { type DocumentDownloadEnvelope, type DocumentDownloadResolution, type DocumentDownloadResolver, resolveStoredDocumentDownload, type StoredDocumentReference, } from "./document-download.js";
 export { createInvoiceFxHonoExtension, createInvoiceFxRoutes, createVoyantDataFxExchangeRateResolver, type InvoiceExchangeRateResolution, type InvoiceFxContext, type InvoiceFxOptions, type InvoiceFxRouteOptions, type InvoiceFxSettings, mountInvoiceFxRoutes, type ResolvedInvoiceFxSettings, type ResolveInvoiceExchangeRate, type ResolveInvoiceExchangeRateInput, type ResolveInvoiceFxSettings, resolveInvoiceFxContext, resolveInvoiceFxSettingsOrDefault, type UpdateInvoiceFxSettings, type VoyantDataFxResolverOptions, } from "./invoice-fx.js";
+export { type CreateOrderPaymentSessionsOptions, createOrderPaymentSessions, type EnsureOrderSessionParams, type OrderPaymentSessionSummary, type OrderPaymentSessions, type OrderPaymentSessionTargetType, type StartOrderPaymentProvider, } from "./order-payment-sessions.js";
 export type { ComputedScheduleEntry, ComputeScheduleInput, DepositKind, DepositRule, PaymentPolicy, PaymentPolicyCascadeLayers, PaymentPolicySource, PaymentScheduleEntryType, ResolvedPaymentPolicy, } from "./payment-policy.js";
 export { computePaymentSchedule, isPaymentPolicyEmpty, noDepositPolicy, policyShouldRequireFullPayment, resolveEffectivePaymentPolicy, } from "./payment-policy.js";
+export { createPaymentPolicyCascade, type PaymentPolicyCascade, type PaymentPolicyCascadeOptions, type PaymentPolicyCascadeReaders, readPolicySourceFromInternalNotes, stampPolicySourceOnBooking, } from "./payment-policy-cascade.js";
+export { type BookingScheduleRoutesOptions, createBookingScheduleAdminRoutes, createPaymentPolicyPublicRoutes, generatePaymentScheduleForBooking, type PaymentPolicyEntityContext, } from "./payment-schedule/routes.js";
 export { buildFinanceRouteRuntime, FINANCE_ROUTE_RUNTIME_CONTAINER_KEY, type FinanceRouteRuntime, type FinanceRuntimeOptions, } from "./route-runtime.js";
 export { bookingsCreateExtension } from "./routes-booking-create.js";
 export { createFinanceAdminDocumentRoutes, type FinanceDocumentRouteOptions, type InvoiceDocumentGenerator, } from "./routes-documents.js";

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

@@ -88,7 +88,10 @@ export const financeHonoModule = createFinanceHonoModule();
 export { computeBookingItemTaxLine, createBookingTaxHonoExtension, createBookingTaxRoutes, loadProductTaxFacts, matchesTaxPolicyCondition, mountBookingTaxRoutes, resolveBookingSellTaxRate, } from "./booking-tax.js";
 export { resolveStoredDocumentDownload, } from "./document-download.js";
 export { createInvoiceFxHonoExtension, createInvoiceFxRoutes, createVoyantDataFxExchangeRateResolver, mountInvoiceFxRoutes, resolveInvoiceFxContext, resolveInvoiceFxSettingsOrDefault, } from "./invoice-fx.js";
+export { createOrderPaymentSessions, } from "./order-payment-sessions.js";
 export { computePaymentSchedule, isPaymentPolicyEmpty, noDepositPolicy, policyShouldRequireFullPayment, resolveEffectivePaymentPolicy, } from "./payment-policy.js";
+export { createPaymentPolicyCascade, readPolicySourceFromInternalNotes, stampPolicySourceOnBooking, } from "./payment-policy-cascade.js";
+export { createBookingScheduleAdminRoutes, createPaymentPolicyPublicRoutes, generatePaymentScheduleForBooking, } from "./payment-schedule/routes.js";
 export { buildFinanceRouteRuntime, FINANCE_ROUTE_RUNTIME_CONTAINER_KEY, } from "./route-runtime.js";
 export { bookingsCreateExtension } from "./routes-booking-create.js";
 export { createFinanceAdminDocumentRoutes, } from "./routes-documents.js";

package/dist/order-payment-sessions.d.ts

@@ -0,0 +1,69 @@
+import type { CreatePaymentSessionInput, PostgresJsDatabase } from "./service-shared.js";
+/** Target types finance recognises for external order payment sessions. */
+export type OrderPaymentSessionTargetType = CreatePaymentSessionInput["targetType"];
+/** A resolved payment session for an external order. */
+export interface OrderPaymentSessionSummary {
+    sessionId: string;
+    status: string;
+}
+/** Parameters the caller maps from its domain object to create/find a session. */
+export interface EnsureOrderSessionParams {
+    /** The external order id (becomes `payment_sessions.target_id`). */
+    targetId: string;
+    /** ISO 4217 currency code. */
+    currency: string;
+    /** Amount in minor units (cents). A non-positive amount short-circuits. */
+    amountCents: number;
+    /** Payer email for the session, when known. */
+    payerEmail?: string | null;
+    /** Payer display name for the session, when known. */
+    payerName?: string | null;
+    /** Human summary surfaced as `payment_sessions.notes`. */
+    notes?: string | null;
+}
+/**
+ * Best-effort provider start hook. Called after a session is created so the
+ * provider can populate `redirectUrl`. Failures are swallowed (logged) — the
+ * session still exists for non-card payment paths.
+ */
+export type StartOrderPaymentProvider = (db: PostgresJsDatabase, sessionId: string) => Promise<void>;
+export interface OrderPaymentSessions {
+    /**
+     * Ensure (idempotently) a payment session exists for an external order.
+     *
+     * Precedence: the most recent non-terminal session (a live link) wins; else a
+     * paid/authorized session from history; else create a fresh `pending` session
+     * via `financeService.createPaymentSession` and optionally start the provider.
+     * Returns `null` when the amount is non-positive.
+     */
+    ensureSession(db: PostgresJsDatabase, params: EnsureOrderSessionParams, startProvider?: StartOrderPaymentProvider): Promise<OrderPaymentSessionSummary | null>;
+    /**
+     * Bulk-resolve the most relevant session per order id (no N+1). Two passes:
+     * first the most recent non-terminal session per order, then fall back to the
+     * latest (terminal) session for status.
+     */
+    fetchSessions(db: PostgresJsDatabase, targetIds: string[]): Promise<Map<string, OrderPaymentSessionSummary>>;
+}
+export interface CreateOrderPaymentSessionsOptions {
+    /** The `payment_sessions.target_type` this instance scopes all reads/writes to. */
+    targetType: OrderPaymentSessionTargetType;
+    /**
+     * Provider to stamp on newly-created sessions. Defaults to `null` (no provider)
+     * so the session stays provider-agnostic — the injected `startProvider` claims
+     * it when it runs (e.g. Netopia sets `provider: "netopia"` on start). Set this
+     * only when the deployment wants the provider recorded up front. Never hard-code
+     * a provider here: that would mislabel Stripe/Adyen/bank-transfer deployments.
+     */
+    provider?: string | null;
+    /**
+     * Payment method to stamp on newly-created sessions. Defaults to `null` (unset)
+     * until a payment path is chosen.
+     */
+    paymentMethod?: CreatePaymentSessionInput["paymentMethod"] | null;
+}
+/**
+ * Build an {@link OrderPaymentSessions} bound to a single `targetType`
+ * (e.g. `"flight_order"`). All queries are scoped to that target type.
+ */
+export declare function createOrderPaymentSessions(options: CreateOrderPaymentSessionsOptions): OrderPaymentSessions;
+//# sourceMappingURL=order-payment-sessions.d.ts.map

package/dist/order-payment-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-payment-sessions.d.ts","sourceRoot":"","sources":["../src/order-payment-sessions.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAExF,2EAA2E;AAC3E,MAAM,MAAM,6BAA6B,GAAG,yBAAyB,CAAC,YAAY,CAAC,CAAA;AAEnF,wDAAwD;AACxD,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,kFAAkF;AAClF,MAAM,WAAW,wBAAwB;IACvC,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAA;IAChB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,EAAE,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAOpG,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,aAAa,CACX,EAAE,EAAE,kBAAkB,EACtB,MAAM,EAAE,wBAAwB,EAChC,aAAa,CAAC,EAAE,yBAAyB,GACxC,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAAA;IAC7C;;;;OAIG;IACH,aAAa,CACX,EAAE,EAAE,kBAAkB,EACtB,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC,CAAA;CACpD;AAED,MAAM,WAAW,iCAAiC;IAChD,mFAAmF;IACnF,UAAU,EAAE,6BAA6B,CAAA;IACzC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB;;;OAGG;IACH,aAAa,CAAC,EAAE,yBAAyB,CAAC,eAAe,CAAC,GAAG,IAAI,CAAA;CAClE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,iCAAiC,GACzC,oBAAoB,CAuFtB"}

package/dist/order-payment-sessions.js

@@ -0,0 +1,103 @@
+/**
+ * Generic order payment-session orchestration.
+ *
+ * Finance owns the `payment_sessions` table, so the "ensure a live session for
+ * an external order, else reuse paid history, else create one and best-effort
+ * start the provider" pattern lives here — generic over `targetType` rather than
+ * baked into any one caller (flights, etc.). The caller maps its domain object
+ * to the small `EnsureOrderSessionParams` shape and supplies an optional
+ * provider-start callback.
+ *
+ * This module imports NO upstream module (flights/bookings/etc.) — it only
+ * touches finance's own schema + service. Callers depend on finance; finance
+ * never depends on them.
+ */
+import { and, desc, eq, inArray } from "drizzle-orm";
+import { paymentSessions } from "./schema.js";
+import { financeService } from "./service.js";
+/** Statuses that are terminal/dead for "is there a live session?" purposes. */
+const TERMINAL_STATUSES = ["failed", "expired", "cancelled"];
+/** Statuses worth surfacing from history even when no live session exists. */
+const SETTLED_STATUSES = ["paid", "authorized"];
+/**
+ * Build an {@link OrderPaymentSessions} bound to a single `targetType`
+ * (e.g. `"flight_order"`). All queries are scoped to that target type.
+ */
+export function createOrderPaymentSessions(options) {
+    const { targetType, provider = null, paymentMethod = null } = options;
+    return {
+        async ensureSession(db, params, startProvider) {
+            // Prefer the most recent non-terminal session for this order so the UI
+            // surfaces a live link; fall back to paid/authorized history.
+            const existing = await db
+                .select()
+                .from(paymentSessions)
+                .where(and(eq(paymentSessions.targetId, params.targetId), eq(paymentSessions.targetType, targetType)))
+                .orderBy(desc(paymentSessions.createdAt));
+            const live = existing.find((row) => !TERMINAL_STATUSES.includes(row.status));
+            if (live)
+                return { sessionId: live.id, status: live.status };
+            const latest = existing[0];
+            if (latest && SETTLED_STATUSES.includes(latest.status)) {
+                return { sessionId: latest.id, status: latest.status };
+            }
+            if (params.amountCents <= 0)
+                return null;
+            const session = await financeService.createPaymentSession(db, {
+                targetType,
+                targetId: params.targetId,
+                currency: params.currency,
+                amountCents: params.amountCents,
+                status: "pending",
+                provider,
+                paymentMethod,
+                payerEmail: params.payerEmail ?? null,
+                payerName: params.payerName ?? null,
+                notes: params.notes ?? null,
+            });
+            if (!session)
+                return null;
+            // Start the provider so `redirectUrl` is populated for the landing page's
+            // card tab. Best-effort — other payment paths still work if it fails.
+            if (startProvider) {
+                try {
+                    await startProvider(db, session.id);
+                }
+                catch (err) {
+                    console.warn("[finance] order payment provider start failed:", err);
+                }
+            }
+            return { sessionId: session.id, status: session.status };
+        },
+        async fetchSessions(db, targetIds) {
+            const result = new Map();
+            if (targetIds.length === 0)
+                return result;
+            const rows = await db
+                .select({
+                id: paymentSessions.id,
+                targetId: paymentSessions.targetId,
+                status: paymentSessions.status,
+                createdAt: paymentSessions.createdAt,
+            })
+                .from(paymentSessions)
+                .where(and(eq(paymentSessions.targetType, targetType), inArray(paymentSessions.targetId, targetIds)))
+                .orderBy(desc(paymentSessions.createdAt));
+            // First pass — most recent non-terminal session per order.
+            for (const row of rows) {
+                if (!row.targetId || result.has(row.targetId))
+                    continue;
+                if (!TERMINAL_STATUSES.includes(row.status)) {
+                    result.set(row.targetId, { sessionId: row.id, status: row.status });
+                }
+            }
+            // Second pass — fall back to the latest (terminal) session for status.
+            for (const row of rows) {
+                if (!row.targetId || result.has(row.targetId))
+                    continue;
+                result.set(row.targetId, { sessionId: row.id, status: row.status });
+            }
+            return result;
+        },
+    };
+}

package/dist/payment-policy-cascade.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Multi-vertical payment-policy cascade — owned by `@voyant-travel/finance`.
+ *
+ * Finance owns the `PaymentPolicy` primitive and the most-specific-wins cascade
+ * (`resolveEffectivePaymentPolicy`: booking → listing → category → supplier →
+ * operator default). This module packages the *cascade orchestration* + the
+ * policy-source bookkeeping so no deployment recreates it: the supplier /
+ * category / listing layers, the per-entity storefront-preview variant, and the
+ * `__payment_policy_source__:` marker protocol stamped onto a booking's
+ * `internalNotes`.
+ *
+ * WHY THE VERTICAL READERS ARE INJECTED (not imported):
+ *
+ * The actual schema walks the cascade performs — supplier policy off the
+ * booking's supplier link, category policy off `product_categories`, and the
+ * per-listing policy off accommodation rate plans / cruise cabin→sailing→cruise
+ * layers / product rows — read tables in `@voyant-travel/inventory`,
+ * `@voyant-travel/accommodations`, `@voyant-travel/cruises`, and
+ * `@voyant-travel/distribution`. Finance is a retail-spine root and the spine
+ * closure gate HARD-FORBIDS finance from depending on `@voyant-travel/inventory`
+ * / `@voyant-travel/products` (and `@voyant-travel/accommodations` transitively
+ * reaches the forbidden `@voyant-travel/operations`). So those reads MUST stay
+ * in the deployment and are injected here as `options.readers` rather than
+ * imported. The cascade *order*, the per-entity fan-out, and the source-marker
+ * protocol are vertical-agnostic framework logic and live here.
+ *
+ * The `bookings` schema reads (stamp/read the source marker) ARE imported
+ * directly: finance already depends on `@voyant-travel/bookings` acyclically
+ * (bookings never depends back on finance).
+ */
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import type { PaymentPolicy, PaymentPolicySource } from "./payment-policy.js";
+/**
+ * Storefront-preview entity context passed to the per-entity cascade readers.
+ * Mirrors the journey-level selections a customer makes before a booking row
+ * exists — the readers walk these to find the listing / category / supplier
+ * policy.
+ */
+export interface PaymentPolicyEntityContext {
+    entityModule: string;
+    entityId: string;
+    /** Cruise journey selection — resolves cabin → sailing → cruise. */
+    sailingId?: string;
+    cabinCategoryId?: string;
+    /** Accommodation journey selection — resolves the rate plan's policy. */
+    ratePlanId?: string;
+}
+/**
+ * Deployment-supplied vertical readers for the cascade. Each returns the raw
+ * per-layer policy override (or `null` to inherit from the next-broader layer).
+ *
+ * These are INJECTED because they read across vertical modules (inventory /
+ * accommodations / cruises / distribution) that finance must not statically
+ * import. The cascade ordering that composes them is framework logic and stays
+ * in finance.
+ */
+export interface PaymentPolicyCascadeReaders {
+    /** Supplier-layer override keyed off the booking's supplier link. */
+    resolveSupplierPolicy(db: PostgresJsDatabase, bookingId: string): Promise<PaymentPolicy | null>;
+    /** Product-category override (first category by sortOrder) for the booking. */
+    resolveCategoryPolicy(db: PostgresJsDatabase, bookingId: string): Promise<PaymentPolicy | null>;
+    /** Per-listing override (cruise / accommodation / product) for the booking. */
+    resolveListingPolicy(db: PostgresJsDatabase, bookingId: string): Promise<PaymentPolicy | null>;
+    /** Per-entity (storefront preview) supplier-layer reader. */
+    resolveSupplierPolicyForEntity(db: PostgresJsDatabase, ctx: PaymentPolicyEntityContext): Promise<PaymentPolicy | null>;
+    /** Per-entity (storefront preview) category-layer reader. */
+    resolveCategoryPolicyForEntity(db: PostgresJsDatabase, ctx: PaymentPolicyEntityContext): Promise<PaymentPolicy | null>;
+    /** Per-entity (storefront preview) listing-layer reader. */
+    resolveListingPolicyForEntity(db: PostgresJsDatabase, ctx: PaymentPolicyEntityContext): Promise<PaymentPolicy | null>;
+}
+/** Options for {@link createPaymentPolicyCascade}. */
+export interface PaymentPolicyCascadeOptions {
+    /** The deployment-supplied vertical readers (see above). */
+    readers: PaymentPolicyCascadeReaders;
+}
+/**
+ * The resolver surface produced by {@link createPaymentPolicyCascade}. Mirrors
+ * the function names deployments wire into the booking-schedule route module so
+ * a deployment can pass `cascade` fields straight into
+ * `BookingScheduleRoutesOptions`.
+ */
+export interface PaymentPolicyCascade {
+    resolveSupplierPolicy(db: PostgresJsDatabase, bookingId: string): Promise<PaymentPolicy | null>;
+    resolveCategoryPolicy(db: PostgresJsDatabase, bookingId: string): Promise<PaymentPolicy | null>;
+    resolveListingPolicy(db: PostgresJsDatabase, bookingId: string): Promise<PaymentPolicy | null>;
+    resolveSupplierPolicyForEntity(db: PostgresJsDatabase, ctx: PaymentPolicyEntityContext): Promise<PaymentPolicy | null>;
+    resolveCategoryPolicyForEntity(db: PostgresJsDatabase, ctx: PaymentPolicyEntityContext): Promise<PaymentPolicy | null>;
+    resolveListingPolicyForEntity(db: PostgresJsDatabase, ctx: PaymentPolicyEntityContext): Promise<PaymentPolicy | null>;
+    stampPolicySourceOnBooking(db: PostgresJsDatabase, bookingId: string, source: PaymentPolicySource): Promise<void>;
+    readPolicySourceFromInternalNotes(internalNotes: string | null | undefined): PaymentPolicySource | null;
+}
+/**
+ * Build the payment-policy cascade. Composes the deployment-supplied vertical
+ * readers into the cascade's per-layer resolvers (booking-level + per-entity
+ * preview) and owns the source-marker protocol on the booking row.
+ *
+ * Behaviour is byte-for-byte equivalent to the operator's previous
+ * `booking-payment-policy-runtime.ts`: same cascade order, same fallbacks, same
+ * `PaymentPolicy` shape, same `source` values.
+ */
+export declare function createPaymentPolicyCascade(options: PaymentPolicyCascadeOptions): PaymentPolicyCascade;
+/**
+ * Persist the winning cascade source onto a booking's `internalNotes`.
+ *
+ * Replaces any existing `__payment_policy_source__:` marker line so the stamp
+ * is idempotent across re-confirmations. The source enum is small
+ * (booking | listing | category | supplier | operator_default) so a single
+ * marker line is enough.
+ *
+ * Touches only the `bookings` schema, which finance already depends on
+ * acyclically — no vertical import, so this lives in finance.
+ */
+export declare function stampPolicySourceOnBooking(db: PostgresJsDatabase, bookingId: string, source: PaymentPolicySource): Promise<void>;
+/**
+ * Read the policy-source marker stamped onto a booking by the schedule
+ * subscriber. Used by the contract resolver so `booking.paymentPolicy.source`
+ * reflects the actual cascade layer (`supplier`, `operator_default`, etc.)
+ * rather than always echoing `"operator_default"`.
+ *
+ * Returns `null` when no marker is present or the stamped value isn't a known
+ * `PaymentPolicySource`.
+ */
+export declare function readPolicySourceFromInternalNotes(internalNotes: string | null | undefined): PaymentPolicySource | null;
+//# sourceMappingURL=payment-policy-cascade.d.ts.map

package/dist/payment-policy-cascade.d.ts.map

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

package/dist/payment-policy-cascade.js

@@ -0,0 +1,120 @@
+/**
+ * Multi-vertical payment-policy cascade — owned by `@voyant-travel/finance`.
+ *
+ * Finance owns the `PaymentPolicy` primitive and the most-specific-wins cascade
+ * (`resolveEffectivePaymentPolicy`: booking → listing → category → supplier →
+ * operator default). This module packages the *cascade orchestration* + the
+ * policy-source bookkeeping so no deployment recreates it: the supplier /
+ * category / listing layers, the per-entity storefront-preview variant, and the
+ * `__payment_policy_source__:` marker protocol stamped onto a booking's
+ * `internalNotes`.
+ *
+ * WHY THE VERTICAL READERS ARE INJECTED (not imported):
+ *
+ * The actual schema walks the cascade performs — supplier policy off the
+ * booking's supplier link, category policy off `product_categories`, and the
+ * per-listing policy off accommodation rate plans / cruise cabin→sailing→cruise
+ * layers / product rows — read tables in `@voyant-travel/inventory`,
+ * `@voyant-travel/accommodations`, `@voyant-travel/cruises`, and
+ * `@voyant-travel/distribution`. Finance is a retail-spine root and the spine
+ * closure gate HARD-FORBIDS finance from depending on `@voyant-travel/inventory`
+ * / `@voyant-travel/products` (and `@voyant-travel/accommodations` transitively
+ * reaches the forbidden `@voyant-travel/operations`). So those reads MUST stay
+ * in the deployment and are injected here as `options.readers` rather than
+ * imported. The cascade *order*, the per-entity fan-out, and the source-marker
+ * protocol are vertical-agnostic framework logic and live here.
+ *
+ * The `bookings` schema reads (stamp/read the source marker) ARE imported
+ * directly: finance already depends on `@voyant-travel/bookings` acyclically
+ * (bookings never depends back on finance).
+ */
+import { bookings } from "@voyant-travel/bookings/schema";
+import { eq } from "drizzle-orm";
+/**
+ * The marker line stamped onto a booking's `internalNotes` recording which
+ * cascade layer produced the effective policy. Framework-owned protocol so the
+ * contract resolver can echo the real source rather than always "operator_default".
+ */
+const POLICY_SOURCE_MARKER_PREFIX = "__payment_policy_source__:";
+/**
+ * Build the payment-policy cascade. Composes the deployment-supplied vertical
+ * readers into the cascade's per-layer resolvers (booking-level + per-entity
+ * preview) and owns the source-marker protocol on the booking row.
+ *
+ * Behaviour is byte-for-byte equivalent to the operator's previous
+ * `booking-payment-policy-runtime.ts`: same cascade order, same fallbacks, same
+ * `PaymentPolicy` shape, same `source` values.
+ */
+export function createPaymentPolicyCascade(options) {
+    const { readers } = options;
+    return {
+        resolveSupplierPolicy: (db, bookingId) => readers.resolveSupplierPolicy(db, bookingId),
+        resolveCategoryPolicy: (db, bookingId) => readers.resolveCategoryPolicy(db, bookingId),
+        resolveListingPolicy: (db, bookingId) => readers.resolveListingPolicy(db, bookingId),
+        resolveSupplierPolicyForEntity: (db, ctx) => readers.resolveSupplierPolicyForEntity(db, ctx),
+        resolveCategoryPolicyForEntity: (db, ctx) => readers.resolveCategoryPolicyForEntity(db, ctx),
+        resolveListingPolicyForEntity: (db, ctx) => readers.resolveListingPolicyForEntity(db, ctx),
+        stampPolicySourceOnBooking: (db, bookingId, source) => stampPolicySourceOnBooking(db, bookingId, source),
+        readPolicySourceFromInternalNotes,
+    };
+}
+/**
+ * Persist the winning cascade source onto a booking's `internalNotes`.
+ *
+ * Replaces any existing `__payment_policy_source__:` marker line so the stamp
+ * is idempotent across re-confirmations. The source enum is small
+ * (booking | listing | category | supplier | operator_default) so a single
+ * marker line is enough.
+ *
+ * Touches only the `bookings` schema, which finance already depends on
+ * acyclically — no vertical import, so this lives in finance.
+ */
+export async function stampPolicySourceOnBooking(db, bookingId, source) {
+    const [row] = await db
+        .select({ internalNotes: bookings.internalNotes })
+        .from(bookings)
+        .where(eq(bookings.id, bookingId))
+        .limit(1);
+    if (!row)
+        return;
+    const filtered = (row.internalNotes ?? "")
+        .split(/\r?\n/)
+        .filter((line) => !line.trim().startsWith(POLICY_SOURCE_MARKER_PREFIX))
+        .join("\n");
+    const marker = `${POLICY_SOURCE_MARKER_PREFIX}${source}`;
+    const next = filtered.length > 0 ? `${filtered}\n${marker}` : marker;
+    await db
+        .update(bookings)
+        .set({ internalNotes: next, updatedAt: new Date() })
+        .where(eq(bookings.id, bookingId));
+}
+/**
+ * Read the policy-source marker stamped onto a booking by the schedule
+ * subscriber. Used by the contract resolver so `booking.paymentPolicy.source`
+ * reflects the actual cascade layer (`supplier`, `operator_default`, etc.)
+ * rather than always echoing `"operator_default"`.
+ *
+ * Returns `null` when no marker is present or the stamped value isn't a known
+ * `PaymentPolicySource`.
+ */
+export function readPolicySourceFromInternalNotes(internalNotes) {
+    if (!internalNotes)
+        return null;
+    for (const line of internalNotes.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith(POLICY_SOURCE_MARKER_PREFIX)) {
+            const value = trimmed.slice(POLICY_SOURCE_MARKER_PREFIX.length).trim();
+            switch (value) {
+                case "booking":
+                case "listing":
+                case "category":
+                case "supplier":
+                case "operator_default":
+                    return value;
+                default:
+                    return null;
+            }
+        }
+    }
+    return null;
+}

package/dist/payment-schedule/routes.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Booking payment-schedule route module — owned by `@voyant-travel/finance`.
+ *
+ * Hosts the admin + public payment-policy surface plus the schedule-generation
+ * orchestration that backs the `booking.confirmed` subscriber:
+ *
+ *   POST /v1/admin/bookings/:bookingId/payment-schedule/regenerate
+ *   POST /v1/public/payment-policy/resolve
+ *
+ * The policy cascade (booking → listing → category → supplier → operator
+ * default) is deployment-specific — the resolvers read across vertical modules
+ * (cruises / accommodations / products / suppliers / categories) that the
+ * finance package must not statically import. They are therefore INJECTED via
+ * {@link BookingScheduleRoutesOptions}, alongside the operator-default resolver.
+ *
+ * The bookings schema (`bookings`, `bookingActivityLog`) and the action-ledger
+ * appender are imported directly: `@voyant-travel/finance` already depends on
+ * both `@voyant-travel/bookings` and `@voyant-travel/action-ledger` acyclically
+ * (neither depends back on finance), so no injection is needed there.
+ *
+ * All handler behavior, cascade precedence, idempotency, and the activity-log
+ * entry are preserved byte-for-byte from the operator's previous
+ * `booking-schedule.ts`.
+ */
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import { type Context, Hono } from "hono";
+import { type PaymentPolicy, type PaymentPolicySource } from "../payment-policy.js";
+import type { PaymentPolicyEntityContext } from "../payment-policy-cascade.js";
+export type { PaymentPolicyEntityContext };
+/**
+ * Deployment-supplied options for the booking payment-schedule route module.
+ *
+ * The cascade resolvers + operator default are INJECTED because they read
+ * across vertical modules (cruises / accommodations / products / suppliers /
+ * product categories) that finance must not statically import. The bookings
+ * schema and action-ledger appender are NOT injected — finance already depends
+ * on both acyclically and imports them directly.
+ */
+export interface BookingScheduleRoutesOptions {
+    /** Resolve the per-request drizzle db from the Hono context (`c.get("db")`). */
+    resolveDb(c: Context): PostgresJsDatabase;
+    /** Operator-default payment policy (the cascade's last-resort layer). */
+    resolveOperatorDefaultPaymentPolicy(db: PostgresJsDatabase): Promise<PaymentPolicy | null>;
+    /** Phase 2: supplier-layer override keyed off the booking's supplier link. */
+    resolveSupplierPolicy(db: PostgresJsDatabase, bookingId: string): Promise<PaymentPolicy | null>;
+    /** Phase 3: product-category override (first category by sortOrder). */
+    resolveCategoryPolicy(db: PostgresJsDatabase, bookingId: string): Promise<PaymentPolicy | null>;
+    /** Phase 4: per-listing override (first booking-item product policy). */
+    resolveListingPolicy(db: PostgresJsDatabase, bookingId: string): Promise<PaymentPolicy | null>;
+    resolveListingPolicyForEntity(db: PostgresJsDatabase, ctx: PaymentPolicyEntityContext): Promise<PaymentPolicy | null>;
+    resolveCategoryPolicyForEntity(db: PostgresJsDatabase, ctx: PaymentPolicyEntityContext): Promise<PaymentPolicy | null>;
+    resolveSupplierPolicyForEntity(db: PostgresJsDatabase, ctx: PaymentPolicyEntityContext): Promise<PaymentPolicy | null>;
+    /** Persist the winning cascade source onto the booking's internalNotes. */
+    stampPolicySourceOnBooking(db: PostgresJsDatabase, bookingId: string, source: PaymentPolicySource): Promise<void>;
+    /** Read the stamped cascade source back off internalNotes (regenerate response). */
+    readPolicySourceFromInternalNotes(internalNotes: string): PaymentPolicySource | null;
+}
+/**
+ * Generate (or regenerate) the payment schedule for a booking.
+ *
+ * Resolves the effective customer payment policy (cascade: booking → listing →
+ * category → supplier → operator default), runs {@link computePaymentSchedule},
+ * persists the rows via `financeService.applyComputedPaymentSchedule`, stamps
+ * the cascade source on the booking, and writes a `system_action` activity-log
+ * entry.
+ *
+ * Idempotent: when any schedule row already exists for the booking (in any
+ * status) it returns early so a re-fired `booking.confirmed` event doesn't wipe
+ * outstanding rows and double-bill the customer on paper.
+ */
+export declare function generatePaymentScheduleForBooking(db: PostgresJsDatabase, bookingId: string, options: BookingScheduleRoutesOptions): Promise<void>;
+/**
+ * Admin payment-schedule routes (relative paths; mount at `/v1/admin/bookings`).
+ *
+ *   POST /:bookingId/payment-schedule/regenerate
+ */
+export declare function createBookingScheduleAdminRoutes(options: BookingScheduleRoutesOptions): Hono;
+/**
+ * Public payment-policy routes (relative paths; mount at
+ * `/v1/public/payment-policy`).
+ *
+ *   POST /resolve  — anonymous storefront preview of the effective policy.
+ */
+export declare function createPaymentPolicyPublicRoutes(options: BookingScheduleRoutesOptions): Hono;
+//# sourceMappingURL=routes.d.ts.map

package/dist/payment-schedule/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/payment-schedule/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAOH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAEzC,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EAEzB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAA;AAI9E,YAAY,EAAE,0BAA0B,EAAE,CAAA;AAE1C;;;;;;;;GAQG;AACH,MAAM,WAAW,4BAA4B;IAC3C,gFAAgF;IAChF,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAAA;IACzC,yEAAyE;IACzE,mCAAmC,CAAC,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;IAG1F,8EAA8E;IAC9E,qBAAqB,CAAC,EAAE,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;IAC/F,wEAAwE;IACxE,qBAAqB,CAAC,EAAE,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;IAC/F,yEAAyE;IACzE,oBAAoB,CAAC,EAAE,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;IAG9F,6BAA6B,CAC3B,EAAE,EAAE,kBAAkB,EACtB,GAAG,EAAE,0BAA0B,GAC9B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;IAChC,8BAA8B,CAC5B,EAAE,EAAE,kBAAkB,EACtB,GAAG,EAAE,0BAA0B,GAC9B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;IAChC,8BAA8B,CAC5B,EAAE,EAAE,kBAAkB,EACtB,GAAG,EAAE,0BAA0B,GAC9B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;IAGhC,2EAA2E;IAC3E,0BAA0B,CACxB,EAAE,EAAE,kBAAkB,EACtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAAA;IAChB,oFAAoF;IACpF,iCAAiC,CAAC,aAAa,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAAA;CACrF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,iCAAiC,CACrD,EAAE,EAAE,kBAAkB,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,IAAI,CAAC,CAuFf;AA6LD;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,4BAA4B,GAAG,IAAI,CAI5F;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,4BAA4B,GAAG,IAAI,CAI3F"}

package/dist/payment-schedule/routes.js

@@ -0,0 +1,298 @@
+/**
+ * Booking payment-schedule route module — owned by `@voyant-travel/finance`.
+ *
+ * Hosts the admin + public payment-policy surface plus the schedule-generation
+ * orchestration that backs the `booking.confirmed` subscriber:
+ *
+ *   POST /v1/admin/bookings/:bookingId/payment-schedule/regenerate
+ *   POST /v1/public/payment-policy/resolve
+ *
+ * The policy cascade (booking → listing → category → supplier → operator
+ * default) is deployment-specific — the resolvers read across vertical modules
+ * (cruises / accommodations / products / suppliers / categories) that the
+ * finance package must not statically import. They are therefore INJECTED via
+ * {@link BookingScheduleRoutesOptions}, alongside the operator-default resolver.
+ *
+ * The bookings schema (`bookings`, `bookingActivityLog`) and the action-ledger
+ * appender are imported directly: `@voyant-travel/finance` already depends on
+ * both `@voyant-travel/bookings` and `@voyant-travel/action-ledger` acyclically
+ * (neither depends back on finance), so no injection is needed there.
+ *
+ * All handler behavior, cascade precedence, idempotency, and the activity-log
+ * entry are preserved byte-for-byte from the operator's previous
+ * `booking-schedule.ts`.
+ */
+import { appendActionLedgerMutation } from "@voyant-travel/action-ledger";
+import { bookingActivityLog, bookings } from "@voyant-travel/bookings/schema";
+import { parseJsonBody } from "@voyant-travel/hono";
+import { asc, eq } from "drizzle-orm";
+import { Hono } from "hono";
+import { z } from "zod";
+import { computePaymentSchedule, noDepositPolicy, resolveEffectivePaymentPolicy, } from "../payment-policy.js";
+import { bookingPaymentSchedules } from "../schema/booking-billing.js";
+import { financeService } from "../service.js";
+/**
+ * Generate (or regenerate) the payment schedule for a booking.
+ *
+ * Resolves the effective customer payment policy (cascade: booking → listing →
+ * category → supplier → operator default), runs {@link computePaymentSchedule},
+ * persists the rows via `financeService.applyComputedPaymentSchedule`, stamps
+ * the cascade source on the booking, and writes a `system_action` activity-log
+ * entry.
+ *
+ * Idempotent: when any schedule row already exists for the booking (in any
+ * status) it returns early so a re-fired `booking.confirmed` event doesn't wipe
+ * outstanding rows and double-bill the customer on paper.
+ */
+export async function generatePaymentScheduleForBooking(db, bookingId, options) {
+    const [booking] = await db.select().from(bookings).where(eq(bookings.id, bookingId)).limit(1);
+    if (!booking)
+        return;
+    if (!booking.sellAmountCents || booking.sellAmountCents <= 0)
+        return;
+    // Idempotency: this subscriber fires on every `booking.confirmed`
+    // emission, which includes re-confirmations during the
+    // checkout-finalize workflow when an existing booking transitions
+    // to confirmed after a late payment. If a schedule already exists
+    // (in any status — pending/due/paid/etc.), regenerating would wipe
+    // the outstanding rows and insert a fresh full-amount plan as if
+    // the booking had never been touched, double-billing the customer
+    // on paper.
+    const [existingSchedule] = await db
+        .select({ id: bookingPaymentSchedules.id })
+        .from(bookingPaymentSchedules)
+        .where(eq(bookingPaymentSchedules.bookingId, bookingId))
+        .limit(1);
+    if (existingSchedule)
+        return;
+    const operatorDefault = (await options.resolveOperatorDefaultPaymentPolicy(db)) ?? noDepositPolicy;
+    // Phase 2: supplier-layer override. Falls back to operator
+    // default when the booking has no supplier link or the supplier
+    // hasn't configured a custom policy.
+    const supplierPolicy = await options.resolveSupplierPolicy(db, bookingId);
+    // Phase 3: product-category override. Walks the booking's
+    // products → categories and picks the first category (by
+    // productCategoryProducts.sortOrder ascending) that defines a
+    // policy. Wins over supplier per the cascade order.
+    const categoryPolicy = await options.resolveCategoryPolicy(db, bookingId);
+    // Phase 4: per-listing override. The first booking-item's product
+    // with a non-null customerPaymentPolicy wins. Most specific catalog
+    // layer — beats category, supplier, and operator default.
+    const listingPolicy = await options.resolveListingPolicy(db, bookingId);
+    // Phase 5: booking-level override. The booking's own
+    // customerPaymentPolicy column wins over every catalog layer.
+    // Reserved for ops adjustments — most bookings leave this null.
+    const bookingPolicy = booking.customerPaymentPolicy ?? null;
+    const { policy, source } = resolveEffectivePaymentPolicy({
+        bookingPolicy,
+        listingPolicy,
+        categoryPolicy,
+        supplierPolicy,
+        operatorDefault,
+    });
+    const entries = computePaymentSchedule({
+        totalCents: booking.sellAmountCents,
+        currency: booking.sellCurrency,
+        departureDate: booking.startDate,
+    }, policy);
+    await financeService.applyComputedPaymentSchedule(db, bookingId, entries, { replace: true });
+    // Stash the source on the booking's internalNotes so the contract
+    // resolver can echo it via `booking.paymentPolicy.source`. The
+    // source enum is small (booking | listing | category | supplier |
+    // operator_default) so a single marker line is enough.
+    await options.stampPolicySourceOnBooking(db, bookingId, source);
+    // Audit trail — record what cascade layer applied, which policy
+    // was used, and the resulting schedule snapshot. Lets ops trace
+    // why a particular schedule was generated. The structured metadata
+    // (`kind: payment_schedule_regenerated`) distinguishes this row
+    // from other system-issued activity entries.
+    await db.insert(bookingActivityLog).values({
+        bookingId,
+        actorId: "system",
+        activityType: "system_action",
+        description: `Payment schedule regenerated from ${source} policy (${entries.length} row${entries.length === 1 ? "" : "s"})`,
+        metadata: {
+            kind: "payment_schedule_regenerated",
+            policySource: source,
+            policy,
+            entries,
+        },
+    });
+}
+// ─────────────────────────────────────────────────────────────────
+// Admin route: update booking-level policy + regenerate schedule
+// ─────────────────────────────────────────────────────────────────
+const depositRuleApiSchema = z.object({
+    kind: z.enum(["none", "percent", "fixed_cents"]),
+    percent: z.number().min(0).max(100).optional(),
+    amountCents: z.number().int().min(0).optional(),
+});
+const policyApiSchema = z.object({
+    deposit: depositRuleApiSchema,
+    minDaysBeforeDepartureForDeposit: z.number().int().min(0),
+    balanceDueDaysBeforeDeparture: z.number().int().min(0),
+    balanceDueMinDaysFromNow: z.number().int().min(0),
+});
+const regenerateScheduleBodySchema = z.object({
+    /**
+     * Optional booking-level override. When provided, persists onto
+     * `bookings.customerPaymentPolicy` before running the resolver.
+     * Pass `null` to clear an existing override (cascade falls back
+     * to listing/category/supplier/operator default).
+     */
+    customerPaymentPolicy: policyApiSchema.nullable().optional(),
+});
+async function handleRegenerateSchedule(c, options) {
+    const db = options.resolveDb(c);
+    const bookingId = c.req.param("bookingId");
+    if (!bookingId) {
+        return c.json({ error: "missing_booking_id" }, 400);
+    }
+    let body;
+    try {
+        body = await parseJsonBody(c, regenerateScheduleBodySchema);
+    }
+    catch (err) {
+        return c.json({ error: err instanceof Error ? err.message : "invalid_body" }, 400);
+    }
+    // Persist the override (or clear it) before running the resolver.
+    if (Object.hasOwn(body, "customerPaymentPolicy")) {
+        const [before] = await db
+            .select({ customerPaymentPolicy: bookings.customerPaymentPolicy })
+            .from(bookings)
+            .where(eq(bookings.id, bookingId))
+            .limit(1);
+        await db
+            .update(bookings)
+            .set({
+            customerPaymentPolicy: (body.customerPaymentPolicy ?? null),
+            updatedAt: new Date(),
+        })
+            .where(eq(bookings.id, bookingId));
+        const overrideChanged = JSON.stringify(before?.customerPaymentPolicy ?? null) !==
+            JSON.stringify(body.customerPaymentPolicy ?? null);
+        if (overrideChanged) {
+            await appendActionLedgerMutation(db, {
+                context: getPaymentScheduleActionLedgerRequestContext(c),
+                actionName: "booking.payment_policy.override",
+                actionVersion: "v1",
+                actionKind: "update",
+                evaluatedRisk: "high",
+                targetType: "booking",
+                targetId: bookingId,
+                routeOrToolName: "bookings.payment-schedule.regenerate",
+                authorizationSource: "operator.booking-schedule.route",
+                mutationDetail: {
+                    summary: body.customerPaymentPolicy === null
+                        ? "Cleared booking payment policy override"
+                        : "Updated booking payment policy override",
+                    reversalKind: "none",
+                },
+            });
+        }
+    }
+    await generatePaymentScheduleForBooking(db, bookingId, options);
+    const rows = await db
+        .select()
+        .from(bookingPaymentSchedules)
+        .where(eq(bookingPaymentSchedules.bookingId, bookingId))
+        .orderBy(asc(bookingPaymentSchedules.dueDate), asc(bookingPaymentSchedules.createdAt));
+    const [updatedBooking] = await db
+        .select({
+        customerPaymentPolicy: bookings.customerPaymentPolicy,
+        internalNotes: bookings.internalNotes,
+    })
+        .from(bookings)
+        .where(eq(bookings.id, bookingId))
+        .limit(1);
+    return c.json({
+        data: {
+            schedule: rows,
+            bookingPolicy: updatedBooking?.customerPaymentPolicy ?? null,
+            cascadeSource: options.readPolicySourceFromInternalNotes(updatedBooking?.internalNotes ?? "") ??
+                "operator_default",
+        },
+    });
+}
+function getPaymentScheduleActionLedgerRequestContext(c) {
+    return {
+        userId: c.get("userId") ?? null,
+        agentId: c.get("agentId") ?? null,
+        workflowPrincipalId: c.get("workflowPrincipalId") ?? null,
+        principalSubtype: c.get("principalSubtype") ?? null,
+        sessionId: c.get("sessionId") ?? null,
+        apiTokenId: c.get("apiTokenId") ?? c.get("apiKeyId") ?? null,
+        callerType: c.get("callerType") ?? null,
+        actor: c.get("actor") ?? null,
+        isInternalRequest: c.get("isInternalRequest") ?? false,
+        organizationId: c.get("organizationId") ?? null,
+        workflowRunId: c.get("workflowRunId") ?? null,
+        workflowStepId: c.get("workflowStepId") ?? null,
+        correlationId: c.req.header("x-correlation-id") ?? c.req.header("x-request-id") ?? null,
+    };
+}
+// ─────────────────────────────────────────────────────────────────
+// Public route: resolve policy for an entity (storefront preview)
+// ─────────────────────────────────────────────────────────────────
+const resolvePolicyBodySchema = z.object({
+    entityModule: z.string(),
+    entityId: z.string(),
+    /** Cruise journey selections — resolver walks cabin → sailing →
+     *  cruise once these are picked. Optional because the customer
+     *  may not have selected a cabin yet. */
+    sailingId: z.string().optional(),
+    cabinCategoryId: z.string().optional(),
+    /** Accommodation journey selection — resolver picks the rate plan's
+     *  policy when present. */
+    ratePlanId: z.string().optional(),
+});
+async function handleResolvePolicy(c, options) {
+    const db = options.resolveDb(c);
+    let body;
+    try {
+        body = await parseJsonBody(c, resolvePolicyBodySchema);
+    }
+    catch (err) {
+        return c.json({ error: err instanceof Error ? err.message : "invalid_body" }, 400);
+    }
+    const operatorDefault = (await options.resolveOperatorDefaultPaymentPolicy(db)) ?? noDepositPolicy;
+    // Vertical-specific listing lookups — same source-of-truth queries
+    // as the booking-confirmed path, just keyed off the journey
+    // selections instead of a persisted booking_items row.
+    const listingPolicy = await options.resolveListingPolicyForEntity(db, body);
+    const categoryPolicy = await options.resolveCategoryPolicyForEntity(db, body);
+    const supplierPolicy = await options.resolveSupplierPolicyForEntity(db, body);
+    const { policy, source } = resolveEffectivePaymentPolicy({
+        listingPolicy,
+        categoryPolicy,
+        supplierPolicy,
+        operatorDefault,
+    });
+    return c.json({
+        data: {
+            policy,
+            source,
+        },
+    });
+}
+/**
+ * Admin payment-schedule routes (relative paths; mount at `/v1/admin/bookings`).
+ *
+ *   POST /:bookingId/payment-schedule/regenerate
+ */
+export function createBookingScheduleAdminRoutes(options) {
+    const hono = new Hono();
+    hono.post("/:bookingId/payment-schedule/regenerate", (c) => handleRegenerateSchedule(c, options));
+    return hono;
+}
+/**
+ * Public payment-policy routes (relative paths; mount at
+ * `/v1/public/payment-policy`).
+ *
+ *   POST /resolve  — anonymous storefront preview of the effective policy.
+ */
+export function createPaymentPolicyPublicRoutes(options) {
+    const hono = new Hono();
+    hono.post("/resolve", (c) => handleResolvePolicy(c, options));
+    return hono;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyant-travel/finance",
-  "version": "0.120.2",
+  "version": "0.122.0",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -14,6 +14,11 @@
       "import": "./dist/action-ledger-drift.js",
       "default": "./dist/action-ledger-drift.js"
     },
+    "./card-payment": {
+      "types": "./dist/card-payment.d.ts",
+      "import": "./dist/card-payment.js",
+      "default": "./dist/card-payment.js"
+    },
     "./checkout": {
       "types": "./dist/checkout-service.d.ts",
       "import": "./dist/checkout-service.js",
@@ -34,6 +39,16 @@
       "import": "./dist/invoice-fx.js",
       "default": "./dist/invoice-fx.js"
     },
+    "./order-payment-sessions": {
+      "types": "./dist/order-payment-sessions.d.ts",
+      "import": "./dist/order-payment-sessions.js",
+      "default": "./dist/order-payment-sessions.js"
+    },
+    "./payment-policy-cascade": {
+      "types": "./dist/payment-policy-cascade.d.ts",
+      "import": "./dist/payment-policy-cascade.js",
+      "default": "./dist/payment-policy-cascade.js"
+    },
     "./payment-link": {
       "types": "./dist/payment-link.d.ts",
       "import": "./dist/payment-link.js",
@@ -76,19 +91,17 @@
     "fflate": "^0.8.2",
     "hono": "^4.12.10",
     "zod": "^4.3.6",
-    "@voyant-travel/action-ledger": "^0.104.11",
-    "@voyant-travel/bookings": "^0.120.3",
+    "@voyant-travel/action-ledger": "^0.105.0",
+    "@voyant-travel/bookings": "^0.122.0",
     "@voyant-travel/core": "^0.109.0",
     "@voyant-travel/db": "^0.108.1",
     "@voyant-travel/finance-contracts": "^0.104.5",
-    "@voyant-travel/hono": "^0.110.3",
-    "@voyant-travel/storage": "^0.104.1",
+    "@voyant-travel/hono": "^0.111.0",
+    "@voyant-travel/storage": "^0.105.0",
     "@voyant-travel/utils": "^0.105.2"
   },
   "devDependencies": {
     "typescript": "^6.0.2",
-    "@voyant-travel/operations": "^0.1.0",
-    "@voyant-travel/inventory": "^0.2.0",
     "@voyant-travel/voyant-typescript-config": "^0.1.0"
   },
   "files": [