@voyantjs/finance 0.20.0 → 0.21.1

package/dist/index.d.ts

@@ -19,13 +19,15 @@ export interface FinanceHonoModuleOptions extends FinanceRuntimeOptions, PublicF
 }
 export declare function createFinanceHonoModule(options?: FinanceHonoModuleOptions): HonoModule;
 export declare const financeHonoModule: HonoModule;
+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 { buildFinanceRouteRuntime, FINANCE_ROUTE_RUNTIME_CONTAINER_KEY, type FinanceRouteRuntime, type FinanceRuntimeOptions, } from "./route-runtime.js";
 export { bookingsQuickCreateExtension } from "./routes-bookings-quick-create.js";
 export { createFinanceAdminDocumentRoutes, type FinanceDocumentRouteOptions, type InvoiceDocumentGenerator, } from "./routes-documents.js";
 export { createFinanceAdminSettlementRoutes, type FinanceSettlementRouteOptions, type InvoiceSettlementPoller, } from "./routes-settlement.js";
-export type { BookingGuarantee, BookingItemCommission, BookingItemTaxLine, BookingPaymentSchedule, CreditNote, CreditNoteLineItem, FinanceNote, Invoice, InvoiceExternalRef, InvoiceLineItem, InvoiceNumberSeries, InvoiceRendition, InvoiceTemplate, NewBookingGuarantee, NewBookingItemCommission, NewBookingItemTaxLine, NewBookingPaymentSchedule, NewCreditNote, NewCreditNoteLineItem, NewFinanceNote, NewInvoice, NewInvoiceExternalRef, NewInvoiceLineItem, NewInvoiceNumberSeries, NewInvoiceRendition, NewInvoiceTemplate, NewPayment, NewPaymentAuthorization, NewPaymentCapture, NewPaymentInstrument, NewPaymentSession, NewSupplierPayment, NewTaxRegime, NewVoucher, NewVoucherRedemption, Payment, PaymentAuthorization, PaymentCapture, PaymentInstrument, PaymentSession, SupplierPayment, TaxRegime, Voucher, VoucherRedemption, } from "./schema.js";
-export { bookingGuarantees, bookingItemCommissions, bookingItemTaxLines, bookingPaymentSchedules, creditNoteLineItems, creditNotes, financeNotes, invoiceExternalRefs, invoiceLineItems, invoiceNumberSeries, invoiceRenditions, invoices, invoiceTemplates, paymentAuthorizations, paymentCaptures, paymentInstruments, paymentSessions, payments, supplierPayments, taxRegimes, voucherRedemptions, voucherSourceTypeEnum, voucherStatusEnum, vouchers, } from "./schema.js";
-export type { InvoiceFromBookingData } from "./service.js";
+export type { BookingGuarantee, BookingItemCommission, BookingItemTaxLine, BookingPaymentSchedule, CreditNote, CreditNoteLineItem, FinanceNote, Invoice, InvoiceExternalRef, InvoiceLineItem, InvoiceNumberSeries, InvoiceRendition, InvoiceTemplate, NewBookingGuarantee, NewBookingItemCommission, NewBookingItemTaxLine, NewBookingPaymentSchedule, NewCreditNote, NewCreditNoteLineItem, NewFinanceNote, NewInvoice, NewInvoiceExternalRef, NewInvoiceLineItem, NewInvoiceNumberSeries, NewInvoiceRendition, NewInvoiceTemplate, NewPayment, NewPaymentAuthorization, NewPaymentCapture, NewPaymentInstrument, NewPaymentSession, NewSupplierPayment, NewTaxClass, NewTaxRegime, NewVoucher, NewVoucherRedemption, Payment, PaymentAuthorization, PaymentCapture, PaymentInstrument, PaymentSession, SupplierPayment, TaxClass, TaxRegime, Voucher, VoucherRedemption, } from "./schema.js";
+export { bookingGuarantees, bookingItemCommissions, bookingItemTaxLines, bookingPaymentSchedules, creditNoteLineItems, creditNotes, financeNotes, invoiceExternalRefs, invoiceLineItems, invoiceNumberSeries, invoiceRenditions, invoices, invoiceTemplates, paymentAuthorizations, paymentCaptures, paymentInstruments, paymentSessions, payments, supplierPayments, taxClasses, taxPolicyProfiles, taxPolicyRules, taxRegimes, voucherRedemptions, voucherSourceTypeEnum, voucherStatusEnum, vouchers, } from "./schema.js";
+export type { CreateInvoiceFromBookingInput, InvoiceFromBookingData } from "./service.js";
 export { financeService, renderInvoiceBody } from "./service.js";
 export type { BookingDualCreatedEvent, DualCreateBookingInput, DualCreateBookingOutcome, DualCreateBookingResult, DualCreateBookingRuntime, } from "./service-bookings-dual-create.js";
 export { dualCreateBooking, dualCreateBookingSchema, } from "./service-bookings-dual-create.js";
@@ -33,12 +35,14 @@ export type { BookingQuickCreatedEvent, BookingQuickCreateRuntime, QuickCreateBo
 export { quickCreateBooking, quickCreateBookingSchema, } from "./service-bookings-quick-create.js";
 export type { GeneratedInvoiceDocumentRecord, GeneratedInvoiceRenditionArtifact, InvoiceDocumentGeneratedEvent, InvoiceDocumentGeneratorContext, InvoiceDocumentRuntimeOptions, StorageBackedInvoiceDocumentGeneratorOptions, StorageBackedInvoiceDocumentSerializer, StorageBackedInvoiceDocumentUpload, } from "./service-documents.js";
 export { createPdfInvoiceDocumentGenerator, createStorageBackedInvoiceDocumentGenerator, defaultPdfInvoiceDocumentSerializer, defaultStorageBackedInvoiceDocumentSerializer, financeDocumentsService, } from "./service-documents.js";
+export type { InvoiceIssuedEvent, InvoiceIssueRuntime } from "./service-issue.js";
+export { issueInvoiceFromBooking, issueProformaFromBooking } from "./service-issue.js";
 export type { FinanceSettlementRuntimeOptions, InvoiceSettledEvent, InvoiceSettlementPollerContext, InvoiceSettlementPollerResult, } from "./service-settlement.js";
 export { financeSettlementService } from "./service-settlement.js";
 export { VoucherServiceError, vouchersService } from "./service-vouchers.js";
 export { migrateVouchersFromPaymentInstruments, type VoucherMigrationOptions, type VoucherMigrationResult, type VoucherMigrationSkip, } from "./service-vouchers-migration.js";
 export type { GeneratedInvoiceDocumentResult, GenerateInvoiceDocumentInput, PolledInvoiceSettlementResult, PollInvoiceSettlementInput, } from "./validation.js";
-export { agingReportQuerySchema, allocateInvoiceNumberInputSchema, applyDefaultBookingPaymentPlanSchema, cancelPaymentSessionSchema, completePaymentSessionSchema, createPaymentSessionFromGuaranteeSchema, createPaymentSessionFromInvoiceSchema, createPaymentSessionFromScheduleSchema, expirePaymentSessionSchema, failPaymentSessionSchema, generatedInvoiceDocumentResultSchema, generateInvoiceDocumentInputSchema, insertBookingGuaranteeSchema, insertBookingItemCommissionSchema, insertBookingItemTaxLineSchema, insertBookingPaymentScheduleSchema, insertCreditNoteLineItemSchema, insertCreditNoteSchema, insertFinanceNoteSchema, insertInvoiceExternalRefSchema, insertInvoiceLineItemSchema, insertInvoiceNumberSeriesSchema, insertInvoiceRenditionSchema, insertInvoiceSchema, insertInvoiceTemplateSchema, insertPaymentAuthorizationSchema, insertPaymentCaptureSchema, insertPaymentInstrumentSchema, insertPaymentSchema, insertPaymentSessionSchema, insertSupplierPaymentSchema, insertTaxRegimeSchema, invoiceFromBookingSchema, invoiceListQuerySchema, invoiceNumberSeriesListQuerySchema, invoiceTemplateListQuerySchema, markPaymentSessionRequiresRedirectSchema, paymentAuthorizationListQuerySchema, paymentCaptureListQuerySchema, paymentInstrumentListQuerySchema, paymentSessionListQuerySchema, polledInvoiceSettlementProviderResultSchema, polledInvoiceSettlementResultSchema, pollInvoiceSettlementInputSchema, profitabilityQuerySchema, renderInvoiceInputSchema, revenueReportQuerySchema, supplierPaymentListQuerySchema, taxRegimeListQuerySchema, updateBookingGuaranteeSchema, updateBookingItemCommissionSchema, updateBookingItemTaxLineSchema, updateBookingPaymentScheduleSchema, updateCreditNoteLineItemSchema, updateCreditNoteSchema, updateInvoiceExternalRefSchema, updateInvoiceLineItemSchema, updateInvoiceNumberSeriesSchema, updateInvoiceRenditionSchema, updateInvoiceSchema, updateInvoiceTemplateSchema, updatePaymentAuthorizationSchema, updatePaymentCaptureSchema, updatePaymentInstrumentSchema, updatePaymentSchema, updatePaymentSessionSchema, updateSupplierPaymentSchema, updateTaxRegimeSchema, } from "./validation.js";
+export { agingReportQuerySchema, allocateInvoiceNumberInputSchema, applyDefaultBookingPaymentPlanSchema, cancelPaymentSessionSchema, completePaymentSessionSchema, createPaymentSessionFromGuaranteeSchema, createPaymentSessionFromInvoiceSchema, createPaymentSessionFromScheduleSchema, expirePaymentSessionSchema, failPaymentSessionSchema, generatedInvoiceDocumentResultSchema, generateInvoiceDocumentInputSchema, insertBookingGuaranteeSchema, insertBookingItemCommissionSchema, insertBookingItemTaxLineSchema, insertBookingPaymentScheduleSchema, insertCreditNoteLineItemSchema, insertCreditNoteSchema, insertFinanceNoteSchema, insertInvoiceExternalRefSchema, insertInvoiceLineItemSchema, insertInvoiceNumberSeriesSchema, insertInvoiceRenditionSchema, insertInvoiceSchema, insertInvoiceTemplateSchema, insertPaymentAuthorizationSchema, insertPaymentCaptureSchema, insertPaymentInstrumentSchema, insertPaymentSchema, insertPaymentSessionSchema, insertSupplierPaymentSchema, insertTaxClassSchema, insertTaxPolicyProfileSchema, insertTaxPolicyRuleSchema, insertTaxRegimeSchema, invoiceFromBookingSchema, invoiceListQuerySchema, invoiceNumberSeriesListQuerySchema, invoiceTemplateListQuerySchema, markPaymentSessionRequiresRedirectSchema, paymentAuthorizationListQuerySchema, paymentCaptureListQuerySchema, paymentInstrumentListQuerySchema, paymentSessionListQuerySchema, polledInvoiceSettlementProviderResultSchema, polledInvoiceSettlementResultSchema, pollInvoiceSettlementInputSchema, profitabilityQuerySchema, renderInvoiceInputSchema, revenueReportQuerySchema, supplierPaymentListQuerySchema, taxClassListQuerySchema, taxPolicyProfileListQuerySchema, taxPolicyRuleListQuerySchema, taxRegimeListQuerySchema, updateBookingGuaranteeSchema, updateBookingItemCommissionSchema, updateBookingItemTaxLineSchema, updateBookingPaymentScheduleSchema, updateCreditNoteLineItemSchema, updateCreditNoteSchema, updateInvoiceExternalRefSchema, updateInvoiceLineItemSchema, updateInvoiceNumberSeriesSchema, updateInvoiceRenditionSchema, updateInvoiceSchema, updateInvoiceTemplateSchema, updatePaymentAuthorizationSchema, updatePaymentCaptureSchema, updatePaymentInstrumentSchema, updatePaymentSchema, updatePaymentSessionSchema, updateSupplierPaymentSchema, updateTaxClassSchema, updateTaxPolicyProfileSchema, updateTaxPolicyRuleSchema, updateTaxRegimeSchema, } from "./validation.js";
 export type { PublicBookingFinanceDocuments, PublicBookingFinancePayments, PublicBookingPaymentOptions, PublicFinanceBookingDocument, PublicFinanceBookingPayment, PublicFinanceDocumentLookup, PublicFinanceDocumentLookupQuery, PublicPaymentOptionsQuery, PublicPaymentSession, PublicStartPaymentSessionInput, PublicValidateVoucherInput, PublicVoucherValidationResult, } from "./validation-public.js";
 export { publicBookingFinanceDocumentsSchema, publicBookingFinancePaymentsSchema, publicBookingPaymentOptionsSchema, publicFinanceBookingDocumentSchema, publicFinanceBookingPaymentSchema, publicFinanceDocumentAvailabilitySchema, publicFinanceDocumentFormatSchema, publicFinanceDocumentLookupQuerySchema, publicFinanceDocumentLookupSchema, publicFinanceInvoiceTypeSchema, publicPaymentOptionsQuerySchema, publicPaymentSessionSchema, publicStartPaymentSessionSchema, publicValidateVoucherSchema, publicVoucherValidationSchema, } from "./validation-public.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -40,8 +40,16 @@ export function createFinanceHonoModule(options = {}) {
         .route("/", createFinanceAdminSettlementRoutes(options));
     const module = {
         ...financeModule,
-        bootstrap: ({ bindings, container }) => {
-            container.register(FINANCE_ROUTE_RUNTIME_CONTAINER_KEY, buildFinanceRouteRuntime(bindings, options));
+        bootstrap: ({ bindings, container, eventBus }) => {
+            const runtime = buildFinanceRouteRuntime(bindings, options);
+            // Wire the framework's eventBus into the route runtime so subscribers
+            // (notably the storefront's checkout-finalize workflow on
+            // `payment.completed`) actually receive emissions from
+            // `financeService.completePaymentSession`. Without this, the Netopia
+            // webhook silently no-ops because the runtime has no bus attached.
+            if (!runtime.eventBus && eventBus)
+                runtime.eventBus = eventBus;
+            container.register(FINANCE_ROUTE_RUNTIME_CONTAINER_KEY, runtime);
         },
     };
     return {
@@ -52,17 +60,19 @@ export function createFinanceHonoModule(options = {}) {
     };
 }
 export const financeHonoModule = createFinanceHonoModule();
+export { computePaymentSchedule, isPaymentPolicyEmpty, noDepositPolicy, policyShouldRequireFullPayment, resolveEffectivePaymentPolicy, } from "./payment-policy.js";
 export { buildFinanceRouteRuntime, FINANCE_ROUTE_RUNTIME_CONTAINER_KEY, } from "./route-runtime.js";
 export { bookingsQuickCreateExtension } from "./routes-bookings-quick-create.js";
 export { createFinanceAdminDocumentRoutes, } from "./routes-documents.js";
 export { createFinanceAdminSettlementRoutes, } from "./routes-settlement.js";
-export { bookingGuarantees, bookingItemCommissions, bookingItemTaxLines, bookingPaymentSchedules, creditNoteLineItems, creditNotes, financeNotes, invoiceExternalRefs, invoiceLineItems, invoiceNumberSeries, invoiceRenditions, invoices, invoiceTemplates, paymentAuthorizations, paymentCaptures, paymentInstruments, paymentSessions, payments, supplierPayments, taxRegimes, voucherRedemptions, voucherSourceTypeEnum, voucherStatusEnum, vouchers, } from "./schema.js";
+export { bookingGuarantees, bookingItemCommissions, bookingItemTaxLines, bookingPaymentSchedules, creditNoteLineItems, creditNotes, financeNotes, invoiceExternalRefs, invoiceLineItems, invoiceNumberSeries, invoiceRenditions, invoices, invoiceTemplates, paymentAuthorizations, paymentCaptures, paymentInstruments, paymentSessions, payments, supplierPayments, taxClasses, taxPolicyProfiles, taxPolicyRules, taxRegimes, voucherRedemptions, voucherSourceTypeEnum, voucherStatusEnum, vouchers, } from "./schema.js";
 export { financeService, renderInvoiceBody } from "./service.js";
 export { dualCreateBooking, dualCreateBookingSchema, } from "./service-bookings-dual-create.js";
 export { quickCreateBooking, quickCreateBookingSchema, } from "./service-bookings-quick-create.js";
 export { createPdfInvoiceDocumentGenerator, createStorageBackedInvoiceDocumentGenerator, defaultPdfInvoiceDocumentSerializer, defaultStorageBackedInvoiceDocumentSerializer, financeDocumentsService, } from "./service-documents.js";
+export { issueInvoiceFromBooking, issueProformaFromBooking } from "./service-issue.js";
 export { financeSettlementService } from "./service-settlement.js";
 export { VoucherServiceError, vouchersService } from "./service-vouchers.js";
 export { migrateVouchersFromPaymentInstruments, } from "./service-vouchers-migration.js";
-export { agingReportQuerySchema, allocateInvoiceNumberInputSchema, applyDefaultBookingPaymentPlanSchema, cancelPaymentSessionSchema, completePaymentSessionSchema, createPaymentSessionFromGuaranteeSchema, createPaymentSessionFromInvoiceSchema, createPaymentSessionFromScheduleSchema, expirePaymentSessionSchema, failPaymentSessionSchema, generatedInvoiceDocumentResultSchema, generateInvoiceDocumentInputSchema, insertBookingGuaranteeSchema, insertBookingItemCommissionSchema, insertBookingItemTaxLineSchema, insertBookingPaymentScheduleSchema, insertCreditNoteLineItemSchema, insertCreditNoteSchema, insertFinanceNoteSchema, insertInvoiceExternalRefSchema, insertInvoiceLineItemSchema, insertInvoiceNumberSeriesSchema, insertInvoiceRenditionSchema, insertInvoiceSchema, insertInvoiceTemplateSchema, insertPaymentAuthorizationSchema, insertPaymentCaptureSchema, insertPaymentInstrumentSchema, insertPaymentSchema, insertPaymentSessionSchema, insertSupplierPaymentSchema, insertTaxRegimeSchema, invoiceFromBookingSchema, invoiceListQuerySchema, invoiceNumberSeriesListQuerySchema, invoiceTemplateListQuerySchema, markPaymentSessionRequiresRedirectSchema, paymentAuthorizationListQuerySchema, paymentCaptureListQuerySchema, paymentInstrumentListQuerySchema, paymentSessionListQuerySchema, polledInvoiceSettlementProviderResultSchema, polledInvoiceSettlementResultSchema, pollInvoiceSettlementInputSchema, profitabilityQuerySchema, renderInvoiceInputSchema, revenueReportQuerySchema, supplierPaymentListQuerySchema, taxRegimeListQuerySchema, updateBookingGuaranteeSchema, updateBookingItemCommissionSchema, updateBookingItemTaxLineSchema, updateBookingPaymentScheduleSchema, updateCreditNoteLineItemSchema, updateCreditNoteSchema, updateInvoiceExternalRefSchema, updateInvoiceLineItemSchema, updateInvoiceNumberSeriesSchema, updateInvoiceRenditionSchema, updateInvoiceSchema, updateInvoiceTemplateSchema, updatePaymentAuthorizationSchema, updatePaymentCaptureSchema, updatePaymentInstrumentSchema, updatePaymentSchema, updatePaymentSessionSchema, updateSupplierPaymentSchema, updateTaxRegimeSchema, } from "./validation.js";
+export { agingReportQuerySchema, allocateInvoiceNumberInputSchema, applyDefaultBookingPaymentPlanSchema, cancelPaymentSessionSchema, completePaymentSessionSchema, createPaymentSessionFromGuaranteeSchema, createPaymentSessionFromInvoiceSchema, createPaymentSessionFromScheduleSchema, expirePaymentSessionSchema, failPaymentSessionSchema, generatedInvoiceDocumentResultSchema, generateInvoiceDocumentInputSchema, insertBookingGuaranteeSchema, insertBookingItemCommissionSchema, insertBookingItemTaxLineSchema, insertBookingPaymentScheduleSchema, insertCreditNoteLineItemSchema, insertCreditNoteSchema, insertFinanceNoteSchema, insertInvoiceExternalRefSchema, insertInvoiceLineItemSchema, insertInvoiceNumberSeriesSchema, insertInvoiceRenditionSchema, insertInvoiceSchema, insertInvoiceTemplateSchema, insertPaymentAuthorizationSchema, insertPaymentCaptureSchema, insertPaymentInstrumentSchema, insertPaymentSchema, insertPaymentSessionSchema, insertSupplierPaymentSchema, insertTaxClassSchema, insertTaxPolicyProfileSchema, insertTaxPolicyRuleSchema, insertTaxRegimeSchema, invoiceFromBookingSchema, invoiceListQuerySchema, invoiceNumberSeriesListQuerySchema, invoiceTemplateListQuerySchema, markPaymentSessionRequiresRedirectSchema, paymentAuthorizationListQuerySchema, paymentCaptureListQuerySchema, paymentInstrumentListQuerySchema, paymentSessionListQuerySchema, polledInvoiceSettlementProviderResultSchema, polledInvoiceSettlementResultSchema, pollInvoiceSettlementInputSchema, profitabilityQuerySchema, renderInvoiceInputSchema, revenueReportQuerySchema, supplierPaymentListQuerySchema, taxClassListQuerySchema, taxPolicyProfileListQuerySchema, taxPolicyRuleListQuerySchema, taxRegimeListQuerySchema, updateBookingGuaranteeSchema, updateBookingItemCommissionSchema, updateBookingItemTaxLineSchema, updateBookingPaymentScheduleSchema, updateCreditNoteLineItemSchema, updateCreditNoteSchema, updateInvoiceExternalRefSchema, updateInvoiceLineItemSchema, updateInvoiceNumberSeriesSchema, updateInvoiceRenditionSchema, updateInvoiceSchema, updateInvoiceTemplateSchema, updatePaymentAuthorizationSchema, updatePaymentCaptureSchema, updatePaymentInstrumentSchema, updatePaymentSchema, updatePaymentSessionSchema, updateSupplierPaymentSchema, updateTaxClassSchema, updateTaxPolicyProfileSchema, updateTaxPolicyRuleSchema, updateTaxRegimeSchema, } from "./validation.js";
 export { publicBookingFinanceDocumentsSchema, publicBookingFinancePaymentsSchema, publicBookingPaymentOptionsSchema, publicFinanceBookingDocumentSchema, publicFinanceBookingPaymentSchema, publicFinanceDocumentAvailabilitySchema, publicFinanceDocumentFormatSchema, publicFinanceDocumentLookupQuerySchema, publicFinanceDocumentLookupSchema, publicFinanceInvoiceTypeSchema, publicPaymentOptionsQuerySchema, publicPaymentSessionSchema, publicStartPaymentSessionSchema, publicValidateVoucherSchema, publicVoucherValidationSchema, } from "./validation-public.js";

package/dist/payment-policy.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Customer-facing payment policy primitive.
+ *
+ * Decides how to split a booking total into a payment schedule: full
+ * payment up-front, or a deposit now + balance due before departure.
+ * Pure function — no DB, no IO. Two policies in (the operator default
+ * + any per-supplier / per-category / per-listing override) plus the
+ * booking total + departure date, schedule rows out.
+ *
+ * Behaviour:
+ *
+ *   1. If `policy.deposit.kind === "none"` → one row, full total, due
+ *      immediately. Skips the rest of the rules.
+ *   2. If departure is too close (`< minDaysBeforeDepartureForDeposit`
+ *      from today) → also full payment now. The agency doesn't have
+ *      time to chase a balance.
+ *   3. Otherwise → two rows:
+ *        - deposit row, due today, amount = percent × total OR fixed
+ *          cents (capped at total).
+ *        - balance row, amount = total − deposit, due
+ *          `balanceDueDaysBeforeDeparture` before departure, but never
+ *          sooner than `balanceDueMinDaysFromNow` days from now.
+ *
+ * Cascade resolution lives in {@link resolveEffectivePaymentPolicy}:
+ * the most-specific layer that defines a policy wins (booking >
+ * listing > category > supplier > operator default), no field-level
+ * merging — so the audit trail is "this whole policy applied".
+ */
+export type DepositKind = "none" | "percent" | "fixed_cents";
+export interface DepositRule {
+    kind: DepositKind;
+    /** Required when `kind === "percent"`. 0–100 inclusive. */
+    percent?: number;
+    /** Required when `kind === "fixed_cents"`. Capped at total. */
+    amountCents?: number;
+}
+export interface PaymentPolicy {
+    deposit: DepositRule;
+    /** Below this many days before departure, deposits are rejected and
+     *  the booking is invoiced for the full amount up-front. */
+    minDaysBeforeDepartureForDeposit: number;
+    /** When the balance is due (days BEFORE departure). */
+    balanceDueDaysBeforeDeparture: number;
+    /** Floor on the balance due date so it's never sooner than this
+     *  many days from "now". Protects the customer from a tight squeeze
+     *  when departure is barely outside the deposit window. */
+    balanceDueMinDaysFromNow: number;
+}
+/** Default policy: 100% up-front, no deposit. Safe fallback for
+ *  agencies that haven't configured anything yet. */
+export declare const noDepositPolicy: PaymentPolicy;
+export type PaymentScheduleEntryType = "deposit" | "balance" | "full";
+export interface ComputedScheduleEntry {
+    scheduleType: PaymentScheduleEntryType;
+    amountCents: number;
+    currency: string;
+    /** ISO `YYYY-MM-DD`. */
+    dueDate: string;
+}
+export interface ComputeScheduleInput {
+    totalCents: number;
+    currency: string;
+    /** ISO `YYYY-MM-DD` (or full ISO string — we only look at the date). */
+    departureDate: string | null | undefined;
+    /** Defaults to `new Date()`. Injectable for deterministic tests. */
+    today?: Date;
+}
+/**
+ * Compute the customer-facing payment schedule for a booking.
+ *
+ * Always returns at least one row. When the policy resolves to no
+ * deposit (or the gate denies one), the single row is a `full`
+ * scheduled for today.
+ */
+export declare function computePaymentSchedule(input: ComputeScheduleInput, policy: PaymentPolicy): ComputedScheduleEntry[];
+/** True when this policy is empty / "inherit from parent". */
+export declare function isPaymentPolicyEmpty(policy: PaymentPolicy | null | undefined): boolean;
+export type PaymentPolicySource = "booking" | "listing" | "category" | "supplier" | "operator_default";
+export interface PaymentPolicyCascadeLayers {
+    bookingPolicy?: PaymentPolicy | null;
+    listingPolicy?: PaymentPolicy | null;
+    categoryPolicy?: PaymentPolicy | null;
+    supplierPolicy?: PaymentPolicy | null;
+    operatorDefault: PaymentPolicy;
+}
+export interface ResolvedPaymentPolicy {
+    policy: PaymentPolicy;
+    source: PaymentPolicySource;
+}
+/**
+ * Most-specific-wins cascade. Returns both the policy and which
+ * layer it came from so contracts and ops UIs can show the trace.
+ *
+ * A layer is "set" when it's not null/undefined AND not effectively
+ * empty (deposit kind === "none" with no other meaningful fields).
+ * That way operators who declare an explicit "no deposit" policy on
+ * a supplier override their parent's "50% deposit" — they pass an
+ * explicit `deposit: { kind: "none" }` AND set non-zero day fields
+ * to mark the layer as intentional.
+ *
+ * For v1 we rely on null/undefined to mean "inherit". The settings
+ * API stores `null` for "use parent". An explicit "none" policy
+ * needs to be modeled with a different deposit kind later if it
+ * proves useful.
+ */
+export declare function resolveEffectivePaymentPolicy(layers: PaymentPolicyCascadeLayers): ResolvedPaymentPolicy;
+/**
+ * Predicate the storefront UI uses to decide whether to surface the
+ * "deposit + balance" copy or just "pay full now". Returns true when
+ * the policy + departure date resolve to a single full-payment row.
+ */
+export declare function policyShouldRequireFullPayment(policy: PaymentPolicy, departureDate: string | null | undefined, today?: Date): boolean;
+//# sourceMappingURL=payment-policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payment-policy.d.ts","sourceRoot":"","sources":["../src/payment-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,CAAA;AAE5D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAA;IACjB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,WAAW,CAAA;IACpB;gEAC4D;IAC5D,gCAAgC,EAAE,MAAM,CAAA;IACxC,uDAAuD;IACvD,6BAA6B,EAAE,MAAM,CAAA;IACrC;;+DAE2D;IAC3D,wBAAwB,EAAE,MAAM,CAAA;CACjC;AAED;qDACqD;AACrD,eAAO,MAAM,eAAe,EAAE,aAK7B,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAA;AAErE,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,wBAAwB,CAAA;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,wEAAwE;IACxE,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IACxC,oEAAoE;IACpE,KAAK,CAAC,EAAE,IAAI,CAAA;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,oBAAoB,EAC3B,MAAM,EAAE,aAAa,GACpB,qBAAqB,EAAE,CA8DzB;AAaD,8DAA8D;AAC9D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAgBtF;AAED,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT,SAAS,GACT,UAAU,GACV,UAAU,GACV,kBAAkB,CAAA;AAEtB,MAAM,WAAW,0BAA0B;IACzC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IACpC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IACpC,cAAc,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IACrC,cAAc,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IACrC,eAAe,EAAE,aAAa,CAAA;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,aAAa,CAAA;IACrB,MAAM,EAAE,mBAAmB,CAAA;CAC5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,0BAA0B,GACjC,qBAAqB,CAMvB;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,aAAa,EACrB,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACxC,KAAK,GAAE,IAAiB,GACvB,OAAO,CAKT"}

package/dist/payment-policy.js

@@ -0,0 +1,193 @@
+/**
+ * Customer-facing payment policy primitive.
+ *
+ * Decides how to split a booking total into a payment schedule: full
+ * payment up-front, or a deposit now + balance due before departure.
+ * Pure function — no DB, no IO. Two policies in (the operator default
+ * + any per-supplier / per-category / per-listing override) plus the
+ * booking total + departure date, schedule rows out.
+ *
+ * Behaviour:
+ *
+ *   1. If `policy.deposit.kind === "none"` → one row, full total, due
+ *      immediately. Skips the rest of the rules.
+ *   2. If departure is too close (`< minDaysBeforeDepartureForDeposit`
+ *      from today) → also full payment now. The agency doesn't have
+ *      time to chase a balance.
+ *   3. Otherwise → two rows:
+ *        - deposit row, due today, amount = percent × total OR fixed
+ *          cents (capped at total).
+ *        - balance row, amount = total − deposit, due
+ *          `balanceDueDaysBeforeDeparture` before departure, but never
+ *          sooner than `balanceDueMinDaysFromNow` days from now.
+ *
+ * Cascade resolution lives in {@link resolveEffectivePaymentPolicy}:
+ * the most-specific layer that defines a policy wins (booking >
+ * listing > category > supplier > operator default), no field-level
+ * merging — so the audit trail is "this whole policy applied".
+ */
+/** Default policy: 100% up-front, no deposit. Safe fallback for
+ *  agencies that haven't configured anything yet. */
+export const noDepositPolicy = {
+    deposit: { kind: "none" },
+    minDaysBeforeDepartureForDeposit: 0,
+    balanceDueDaysBeforeDeparture: 0,
+    balanceDueMinDaysFromNow: 0,
+};
+/**
+ * Compute the customer-facing payment schedule for a booking.
+ *
+ * Always returns at least one row. When the policy resolves to no
+ * deposit (or the gate denies one), the single row is a `full`
+ * scheduled for today.
+ */
+export function computePaymentSchedule(input, policy) {
+    const total = Math.max(0, Math.round(input.totalCents));
+    const today = input.today ?? new Date();
+    const todayIso = isoDate(today);
+    if (total === 0) {
+        return [{ scheduleType: "full", amountCents: 0, currency: input.currency, dueDate: todayIso }];
+    }
+    if (policy.deposit.kind === "none") {
+        return [
+            { scheduleType: "full", amountCents: total, currency: input.currency, dueDate: todayIso },
+        ];
+    }
+    const departure = parseIsoDate(input.departureDate);
+    if (!departure) {
+        // Without a departure date we can't anchor the balance, so fall
+        // back to full upfront — the operator can still split manually
+        // via a booking-level override later.
+        return [
+            { scheduleType: "full", amountCents: total, currency: input.currency, dueDate: todayIso },
+        ];
+    }
+    const daysUntilDeparture = wholeDaysBetween(today, departure);
+    if (daysUntilDeparture < policy.minDaysBeforeDepartureForDeposit) {
+        return [
+            { scheduleType: "full", amountCents: total, currency: input.currency, dueDate: todayIso },
+        ];
+    }
+    const depositCents = clampCents(computeDepositCents(total, policy.deposit), 0, total);
+    const balanceCents = total - depositCents;
+    if (depositCents <= 0 || balanceCents <= 0) {
+        // Edge: a policy that resolves to 0% deposit or 100% deposit
+        // collapses to a single row rather than emitting a zero-cent
+        // partner.
+        return [
+            { scheduleType: "full", amountCents: total, currency: input.currency, dueDate: todayIso },
+        ];
+    }
+    const rawBalanceDue = addDays(departure, -policy.balanceDueDaysBeforeDeparture);
+    const earliestBalanceDue = addDays(today, policy.balanceDueMinDaysFromNow);
+    const balanceDue = rawBalanceDue.getTime() > earliestBalanceDue.getTime() ? rawBalanceDue : earliestBalanceDue;
+    return [
+        {
+            scheduleType: "deposit",
+            amountCents: depositCents,
+            currency: input.currency,
+            dueDate: todayIso,
+        },
+        {
+            scheduleType: "balance",
+            amountCents: balanceCents,
+            currency: input.currency,
+            dueDate: isoDate(balanceDue),
+        },
+    ];
+}
+function computeDepositCents(total, rule) {
+    if (rule.kind === "percent") {
+        const pct = clampNumber(rule.percent ?? 0, 0, 100);
+        return Math.round((total * pct) / 100);
+    }
+    if (rule.kind === "fixed_cents") {
+        return Math.max(0, Math.round(rule.amountCents ?? 0));
+    }
+    return 0;
+}
+/** True when this policy is empty / "inherit from parent". */
+export function isPaymentPolicyEmpty(policy) {
+    if (!policy)
+        return true;
+    if (policy.deposit.kind === "none")
+        return true;
+    if (policy.deposit.kind === "percent" &&
+        (policy.deposit.percent === undefined || policy.deposit.percent === 0)) {
+        return true;
+    }
+    if (policy.deposit.kind === "fixed_cents" &&
+        (policy.deposit.amountCents === undefined || policy.deposit.amountCents === 0)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Most-specific-wins cascade. Returns both the policy and which
+ * layer it came from so contracts and ops UIs can show the trace.
+ *
+ * A layer is "set" when it's not null/undefined AND not effectively
+ * empty (deposit kind === "none" with no other meaningful fields).
+ * That way operators who declare an explicit "no deposit" policy on
+ * a supplier override their parent's "50% deposit" — they pass an
+ * explicit `deposit: { kind: "none" }` AND set non-zero day fields
+ * to mark the layer as intentional.
+ *
+ * For v1 we rely on null/undefined to mean "inherit". The settings
+ * API stores `null` for "use parent". An explicit "none" policy
+ * needs to be modeled with a different deposit kind later if it
+ * proves useful.
+ */
+export function resolveEffectivePaymentPolicy(layers) {
+    if (layers.bookingPolicy)
+        return { policy: layers.bookingPolicy, source: "booking" };
+    if (layers.listingPolicy)
+        return { policy: layers.listingPolicy, source: "listing" };
+    if (layers.categoryPolicy)
+        return { policy: layers.categoryPolicy, source: "category" };
+    if (layers.supplierPolicy)
+        return { policy: layers.supplierPolicy, source: "supplier" };
+    return { policy: layers.operatorDefault, source: "operator_default" };
+}
+/**
+ * Predicate the storefront UI uses to decide whether to surface the
+ * "deposit + balance" copy or just "pay full now". Returns true when
+ * the policy + departure date resolve to a single full-payment row.
+ */
+export function policyShouldRequireFullPayment(policy, departureDate, today = new Date()) {
+    if (policy.deposit.kind === "none")
+        return true;
+    const departure = parseIsoDate(departureDate);
+    if (!departure)
+        return true;
+    return wholeDaysBetween(today, departure) < policy.minDaysBeforeDepartureForDeposit;
+}
+// ─────────────────────────────────────────────────────────────────
+// Helpers
+// ─────────────────────────────────────────────────────────────────
+function parseIsoDate(value) {
+    if (!value)
+        return null;
+    const trimmed = value.length >= 10 ? value.slice(0, 10) : value;
+    const parsed = new Date(`${trimmed}T00:00:00Z`);
+    return Number.isNaN(parsed.getTime()) ? null : parsed;
+}
+function isoDate(d) {
+    return d.toISOString().slice(0, 10);
+}
+function wholeDaysBetween(from, to) {
+    const fromMs = Date.UTC(from.getUTCFullYear(), from.getUTCMonth(), from.getUTCDate());
+    const toMs = Date.UTC(to.getUTCFullYear(), to.getUTCMonth(), to.getUTCDate());
+    return Math.floor((toMs - fromMs) / (24 * 60 * 60 * 1000));
+}
+function addDays(d, days) {
+    const next = new Date(d.getTime());
+    next.setUTCDate(next.getUTCDate() + days);
+    return next;
+}
+function clampCents(value, min, max) {
+    return Math.max(min, Math.min(max, Math.round(value)));
+}
+function clampNumber(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}

package/dist/routes-documents.d.ts

@@ -73,13 +73,13 @@ export declare function createFinanceAdminDocumentRoutes(options?: FinanceDocume
                         updatedAt: string;
                         status: "pending" | "failed" | "ready" | "stale";
                         format: "json" | "pdf" | "html" | "xml";
+                        errorMessage: string | null;
                         templateId: string | null;
                         language: string | null;
                         invoiceId: string;
                         storageKey: string | null;
                         fileSize: number | null;
                         checksum: string | null;
-                        errorMessage: string | null;
                         generatedAt: string | null;
                     };
                 };
@@ -144,13 +144,13 @@ export declare function createFinanceAdminDocumentRoutes(options?: FinanceDocume
                         updatedAt: string;
                         status: "pending" | "failed" | "ready" | "stale";
                         format: "json" | "pdf" | "html" | "xml";
+                        errorMessage: string | null;
                         templateId: string | null;
                         language: string | null;
                         invoiceId: string;
                         storageKey: string | null;
                         fileSize: number | null;
                         checksum: string | null;
-                        errorMessage: string | null;
                         generatedAt: string | null;
                     };
                 };

package/dist/routes-public.d.ts

@@ -221,7 +221,7 @@ export declare function createPublicFinanceRoutes(options?: PublicFinanceRouteOp
                         invoiceId: string;
                         invoiceNumber: string;
                         invoiceType: "invoice" | "proforma" | "credit_note";
-                        status: "pending" | "completed" | "failed" | "refunded";
+                        status: "pending" | "failed" | "completed" | "refunded";
                         paymentMethod: "other" | "voucher" | "wallet" | "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "direct_bill";
                         amountCents: number;
                         currency: string;
@@ -282,7 +282,7 @@ export declare function createPublicFinanceRoutes(options?: PublicFinanceRouteOp
                         id: string;
                         bookingPaymentScheduleId: string | null;
                         guaranteeType: "other" | "voucher" | "bank_transfer" | "credit_card" | "deposit" | "preauth" | "card_on_file" | "agency_letter";
-                        status: "pending" | "active" | "expired" | "cancelled" | "released" | "failed";
+                        status: "pending" | "active" | "failed" | "expired" | "cancelled" | "released";
                         currency: string | null;
                         amountCents: number | null;
                         provider: string | null;
@@ -328,7 +328,7 @@ export declare function createPublicFinanceRoutes(options?: PublicFinanceRouteOp
                     invoiceId: string | null;
                     bookingPaymentScheduleId: string | null;
                     bookingGuaranteeId: string | null;
-                    status: "pending" | "expired" | "cancelled" | "failed" | "paid" | "requires_redirect" | "processing" | "authorized";
+                    status: "pending" | "failed" | "expired" | "cancelled" | "paid" | "requires_redirect" | "processing" | "authorized";
                     provider: string | null;
                     providerSessionId: string | null;
                     providerPaymentId: string | null;
@@ -385,7 +385,7 @@ export declare function createPublicFinanceRoutes(options?: PublicFinanceRouteOp
                     invoiceId: string | null;
                     bookingPaymentScheduleId: string | null;
                     bookingGuaranteeId: string | null;
-                    status: "pending" | "expired" | "cancelled" | "failed" | "paid" | "requires_redirect" | "processing" | "authorized";
+                    status: "pending" | "failed" | "expired" | "cancelled" | "paid" | "requires_redirect" | "processing" | "authorized";
                     provider: string | null;
                     providerSessionId: string | null;
                     providerPaymentId: string | null;
@@ -455,7 +455,7 @@ export declare function createPublicFinanceRoutes(options?: PublicFinanceRouteOp
                     invoiceId: string | null;
                     bookingPaymentScheduleId: string | null;
                     bookingGuaranteeId: string | null;
-                    status: "pending" | "expired" | "cancelled" | "failed" | "paid" | "requires_redirect" | "processing" | "authorized";
+                    status: "pending" | "failed" | "expired" | "cancelled" | "paid" | "requires_redirect" | "processing" | "authorized";
                     provider: string | null;
                     providerSessionId: string | null;
                     providerPaymentId: string | null;
@@ -521,7 +521,7 @@ export declare function createPublicFinanceRoutes(options?: PublicFinanceRouteOp
                     invoiceId: string | null;
                     bookingPaymentScheduleId: string | null;
                     bookingGuaranteeId: string | null;
-                    status: "pending" | "expired" | "cancelled" | "failed" | "paid" | "requires_redirect" | "processing" | "authorized";
+                    status: "pending" | "failed" | "expired" | "cancelled" | "paid" | "requires_redirect" | "processing" | "authorized";
                     provider: string | null;
                     providerSessionId: string | null;
                     providerPaymentId: string | null;
@@ -777,7 +777,7 @@ export declare const publicFinanceRoutes: import("hono/hono-base").HonoBase<Env,
                         invoiceId: string;
                         invoiceNumber: string;
                         invoiceType: "invoice" | "proforma" | "credit_note";
-                        status: "pending" | "completed" | "failed" | "refunded";
+                        status: "pending" | "failed" | "completed" | "refunded";
                         paymentMethod: "other" | "voucher" | "wallet" | "bank_transfer" | "credit_card" | "debit_card" | "cash" | "cheque" | "direct_bill";
                         amountCents: number;
                         currency: string;
@@ -838,7 +838,7 @@ export declare const publicFinanceRoutes: import("hono/hono-base").HonoBase<Env,
                         id: string;
                         bookingPaymentScheduleId: string | null;
                         guaranteeType: "other" | "voucher" | "bank_transfer" | "credit_card" | "deposit" | "preauth" | "card_on_file" | "agency_letter";
-                        status: "pending" | "active" | "expired" | "cancelled" | "released" | "failed";
+                        status: "pending" | "active" | "failed" | "expired" | "cancelled" | "released";
                         currency: string | null;
                         amountCents: number | null;
                         provider: string | null;
@@ -884,7 +884,7 @@ export declare const publicFinanceRoutes: import("hono/hono-base").HonoBase<Env,
                     invoiceId: string | null;
                     bookingPaymentScheduleId: string | null;
                     bookingGuaranteeId: string | null;
-                    status: "pending" | "expired" | "cancelled" | "failed" | "paid" | "requires_redirect" | "processing" | "authorized";
+                    status: "pending" | "failed" | "expired" | "cancelled" | "paid" | "requires_redirect" | "processing" | "authorized";
                     provider: string | null;
                     providerSessionId: string | null;
                     providerPaymentId: string | null;
@@ -941,7 +941,7 @@ export declare const publicFinanceRoutes: import("hono/hono-base").HonoBase<Env,
                     invoiceId: string | null;
                     bookingPaymentScheduleId: string | null;
                     bookingGuaranteeId: string | null;
-                    status: "pending" | "expired" | "cancelled" | "failed" | "paid" | "requires_redirect" | "processing" | "authorized";
+                    status: "pending" | "failed" | "expired" | "cancelled" | "paid" | "requires_redirect" | "processing" | "authorized";
                     provider: string | null;
                     providerSessionId: string | null;
                     providerPaymentId: string | null;
@@ -1011,7 +1011,7 @@ export declare const publicFinanceRoutes: import("hono/hono-base").HonoBase<Env,
                     invoiceId: string | null;
                     bookingPaymentScheduleId: string | null;
                     bookingGuaranteeId: string | null;
-                    status: "pending" | "expired" | "cancelled" | "failed" | "paid" | "requires_redirect" | "processing" | "authorized";
+                    status: "pending" | "failed" | "expired" | "cancelled" | "paid" | "requires_redirect" | "processing" | "authorized";
                     provider: string | null;
                     providerSessionId: string | null;
                     providerPaymentId: string | null;
@@ -1077,7 +1077,7 @@ export declare const publicFinanceRoutes: import("hono/hono-base").HonoBase<Env,
                     invoiceId: string | null;
                     bookingPaymentScheduleId: string | null;
                     bookingGuaranteeId: string | null;
-                    status: "pending" | "expired" | "cancelled" | "failed" | "paid" | "requires_redirect" | "processing" | "authorized";
+                    status: "pending" | "failed" | "expired" | "cancelled" | "paid" | "requires_redirect" | "processing" | "authorized";
                     provider: string | null;
                     providerSessionId: string | null;
                     providerPaymentId: string | null;