@voyant-travel/finance 0.119.5

package/dist/checkout-routes.d.ts.map

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

package/dist/checkout-routes.js

@@ -0,0 +1,116 @@
+import { requireCheckoutCapability, requireGuestBookingAccess, } from "@voyant-travel/bookings/checkout-capability";
+import { idempotencyKey, parseJsonBody, parseOptionalJsonBody, parseQuery, UnauthorizedApiError, } from "@voyant-travel/hono";
+import { Hono } from "hono";
+import { bootstrapCheckoutCollection, initiateCheckoutCollection, previewCheckoutCollection, } from "./checkout-service.js";
+import { bootstrapCheckoutCollectionSchema, checkoutReminderRunListQuerySchema, initiateCheckoutCollectionSchema, previewCheckoutCollectionSchema, } from "./checkout-validation.js";
+export const CHECKOUT_ROUTE_RUNTIME_CONTAINER_KEY = "providers.finance.checkout.runtime";
+function runtimeEnv(c) {
+    return c.env;
+}
+function collectionCapability(action) {
+    return async (c, next) => {
+        const bookingId = c.req.param("bookingId");
+        try {
+            await requireCheckoutCapability(c, bookingId, action, runtimeEnv(c));
+        }
+        catch (error) {
+            if (!(error instanceof UnauthorizedApiError)) {
+                throw error;
+            }
+            await requireGuestBookingAccess(c, bookingId, action, runtimeEnv(c));
+        }
+        await next();
+    };
+}
+function attachCollectionRoutes(app, options) {
+    // Pin the middleware to this module's Env so Hono doesn't intersect the
+    // middleware's default VoyantBindings into the handlers' `c.env` type.
+    const collectionIdempotency = () => idempotencyKey();
+    function getRuntime(bindings, resolveFromContainer) {
+        return (resolveFromContainer?.(CHECKOUT_ROUTE_RUNTIME_CONTAINER_KEY) ??
+            buildCheckoutRouteRuntime(bindings, options));
+    }
+    return (app
+        // Mostly a read, but `ensureDefaultPaymentPlan` can materialize a
+        // default payment plan — so it gets the same opt-in idempotency as
+        // the other collection mutations.
+        .post("/bookings/:bookingId/collection-plan", collectionIdempotency(), async (c) => {
+        try {
+            const plan = await previewCheckoutCollection(c.get("db"), c.req.param("bookingId"), await parseOptionalJsonBody(c, previewCheckoutCollectionSchema), options.policy);
+            if (!plan) {
+                return c.json({ error: "Booking not found" }, 404);
+            }
+            return c.json({ data: plan });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Failed to preview checkout collection";
+            return c.json({ error: message }, 400);
+        }
+    })
+        .post("/bookings/:bookingId/initiate-collection", collectionIdempotency(), async (c) => {
+        try {
+            const runtime = getRuntime(c.env, (key) => c.var.container?.resolve(key));
+            const result = await initiateCheckoutCollection(c.get("db"), c.req.param("bookingId"), await parseJsonBody(c, initiateCheckoutCollectionSchema), options.policy, runtime);
+            if (!result) {
+                return c.json({ error: "Booking not found" }, 404);
+            }
+            return c.json({ data: result }, 201);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Failed to initiate checkout collection";
+            if (message.includes("Booking not found")) {
+                return c.json({ error: message }, 404);
+            }
+            return c.json({ error: message }, 409);
+        }
+    })
+        .post("/collections/bootstrap", collectionIdempotency(), async (c) => {
+        try {
+            const runtime = getRuntime(c.env, (key) => c.var.container?.resolve(key));
+            const result = await bootstrapCheckoutCollection(c.get("db"), await parseJsonBody(c, bootstrapCheckoutCollectionSchema), options.policy, runtime);
+            if (!result) {
+                return c.json({ error: "Booking session not found" }, 404);
+            }
+            return c.json({ data: result }, 201);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Failed to bootstrap checkout collection";
+            if (message.includes("Booking not found")) {
+                return c.json({ error: message }, 404);
+            }
+            return c.json({ error: message }, 409);
+        }
+    }));
+}
+export function createCheckoutRoutes(options = {}) {
+    const app = new Hono();
+    app.use("/bookings/:bookingId/collection-plan", collectionCapability("payment:read"));
+    app.use("/bookings/:bookingId/initiate-collection", collectionCapability("payment:start"));
+    return attachCollectionRoutes(app, options);
+}
+export function createCheckoutAdminRoutes(options = {}) {
+    const app = new Hono().get("/bookings/:bookingId/reminder-runs", async (c) => {
+        const query = parseQuery(c, checkoutReminderRunListQuerySchema);
+        const runtime = c.var.container?.resolve(CHECKOUT_ROUTE_RUNTIME_CONTAINER_KEY) ??
+            buildCheckoutRouteRuntime(c.env, options);
+        if (!runtime.listBookingReminderRuns) {
+            return c.json({ data: [], total: 0, limit: query.limit, offset: query.offset });
+        }
+        return c.json(await runtime.listBookingReminderRuns(c.get("db"), c.req.param("bookingId"), query));
+    });
+    return attachCollectionRoutes(app, options);
+}
+export function buildCheckoutRouteRuntime(bindings, options = {}) {
+    return {
+        bindings,
+        notificationDispatcher: options.resolveNotificationDispatcher?.(bindings) ?? options.notificationDispatcher ?? null,
+        paymentStarters: options.resolvePaymentStarters?.(bindings) ?? options.paymentStarters ?? {},
+        bankTransferDetails: options.resolveBankTransferDetails?.(bindings) ?? options.bankTransferDetails ?? null,
+        publicCheckoutBaseUrl: options.resolvePublicCheckoutBaseUrl?.(bindings) ?? options.publicCheckoutBaseUrl ?? null,
+        listBookingReminderRuns: options.listBookingReminderRuns,
+    };
+}
+export const createFinanceCheckoutRoutes = createCheckoutRoutes;
+export const createFinanceCheckoutAdminRoutes = createCheckoutAdminRoutes;
+export const buildFinanceCheckoutRouteRuntime = buildCheckoutRouteRuntime;
+export const FINANCE_CHECKOUT_ROUTE_RUNTIME_CONTAINER_KEY = CHECKOUT_ROUTE_RUNTIME_CONTAINER_KEY;

package/dist/checkout-service-plan.d.ts

@@ -0,0 +1,137 @@
+import type { bookingItems, bookings, bookingTravelers } from "@voyant-travel/bookings";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import type { BootstrapCheckoutCollectionInput, CheckoutBankTransferInstructionsRecord, CheckoutInvoiceNotificationInput, CheckoutPaymentSessionNotificationInput, CheckoutProviderStartInput, InitiateCheckoutCollectionInput } from "./checkout-validation.js";
+import type { bookingPaymentSchedules, invoices, PaymentSession } from "./schema.js";
+export interface CheckoutPolicyOptions {
+    defaultCardCollectionTarget?: "schedule" | "invoice";
+    defaultReminderCardCollectionTarget?: "schedule" | "invoice";
+    defaultBankTransferDocumentType?: "proforma" | "invoice";
+    defaultPaymentPlan?: {
+        depositMode: "none" | "percentage" | "fixed_amount";
+        depositValue: number;
+        balanceDueDaysBeforeStart: number;
+        clearExistingPending: boolean;
+        createGuarantee: boolean;
+        guaranteeType: "deposit" | "credit_card" | "preauth" | "card_on_file" | "bank_transfer" | "voucher" | "agency_letter";
+        notes?: string | null;
+    };
+}
+export type LoadedBookingContext = {
+    booking: typeof bookings.$inferSelect;
+    items: Array<typeof bookingItems.$inferSelect>;
+    participants: Array<typeof bookingTravelers.$inferSelect>;
+    schedules: Array<typeof bookingPaymentSchedules.$inferSelect>;
+    outstandingInvoices: Array<typeof invoices.$inferSelect>;
+};
+export interface CheckoutCollectionPlan {
+    bookingId: string;
+    method: "card" | "bank_transfer";
+    stage: "initial" | "reminder" | "manual";
+    paymentSessionTarget: "schedule" | "invoice" | null;
+    documentType: "proforma" | "invoice" | null;
+    willCreateDefaultPaymentPlan: boolean;
+    selectedSchedule: typeof bookingPaymentSchedules.$inferSelect | null;
+    selectedInvoice: typeof invoices.$inferSelect | null;
+    amountCents: number;
+    currency: string;
+    recommendedAction: "create_bank_transfer_document" | "create_payment_session" | "create_invoice_then_payment_session" | "none";
+}
+export interface CheckoutBankTransferDetails {
+    provider?: string | null;
+    beneficiary: string;
+    iban: string;
+    bankName?: string | null;
+    /**
+     * Deploy-wide instructions appended to every bank-transfer block (e.g.
+     * "Please reference your invoice number in the wire memo"). Per-call
+     * notes from `initiateCheckoutCollection({ notes })` take precedence -
+     * use this slot for boilerplate, not booking-specific content.
+     */
+    notes?: string | null;
+}
+export interface CheckoutProviderStartResult {
+    provider: string;
+    paymentSessionId: string;
+    redirectUrl: string | null;
+    externalReference: string | null;
+    providerSessionId: string | null;
+    providerPaymentId: string | null;
+    response: Record<string, unknown> | null;
+}
+export interface CheckoutPaymentStarterContext {
+    db: PostgresJsDatabase;
+    bookingId: string;
+    plan: CheckoutCollectionPlan;
+    invoice: typeof invoices.$inferSelect | null;
+    paymentSession: PaymentSession;
+    input: InitiateCheckoutCollectionInput;
+    startProvider: CheckoutProviderStartInput;
+    bindings: Record<string, unknown>;
+}
+export type CheckoutPaymentStarter = (context: CheckoutPaymentStarterContext) => Promise<CheckoutProviderStartResult>;
+export interface CheckoutNotificationDelivery {
+    id: string;
+    templateSlug: string | null;
+    channel: "email" | "sms";
+    provider: string;
+    status: "pending" | "sent" | "failed" | "cancelled";
+    toAddress: string;
+    subject: string | null;
+    sentAt: string | null;
+    failedAt: string | null;
+    errorMessage: string | null;
+}
+export interface CheckoutNotificationDispatcher {
+    sendInvoiceNotification?: (db: PostgresJsDatabase, invoiceId: string, input: CheckoutInvoiceNotificationInput) => Promise<CheckoutNotificationDelivery | null>;
+    sendPaymentSessionNotification?: (db: PostgresJsDatabase, paymentSessionId: string, input: CheckoutPaymentSessionNotificationInput) => Promise<CheckoutNotificationDelivery | null>;
+}
+export interface InitiatedCheckoutCollection {
+    plan: CheckoutCollectionPlan;
+    invoice: typeof invoices.$inferSelect | null;
+    paymentSession: PaymentSession | null;
+    invoiceNotification: CheckoutNotificationDelivery | null;
+    paymentSessionNotification: CheckoutNotificationDelivery | null;
+    bankTransferInstructions: CheckoutBankTransferInstructionsRecord | null;
+    providerStart: CheckoutProviderStartResult | null;
+}
+export interface BootstrappedCheckoutCollection extends InitiatedCheckoutCollection {
+    bookingId: string;
+    sessionId: string;
+    sourceType: "booking" | "session";
+    intent: "deposit" | "balance" | "custom";
+}
+export interface CheckoutRuntimeOptions {
+    bindings?: Record<string, unknown>;
+    bankTransferDetails?: CheckoutBankTransferDetails | null;
+    notificationDispatcher?: CheckoutNotificationDispatcher | null;
+    paymentStarters?: Record<string, CheckoutPaymentStarter>;
+    publicCheckoutBaseUrl?: string | null;
+}
+export declare const OUTSTANDING_SCHEDULE_STATUSES: Array<(typeof bookingPaymentSchedules.$inferSelect)["status"]>;
+export declare const OUTSTANDING_INVOICE_STATUSES: Array<(typeof invoices.$inferSelect)["status"]>;
+export declare function defaultPaymentPlan(options: CheckoutPolicyOptions): {
+    readonly depositMode: "none" | "percentage" | "fixed_amount";
+    readonly depositValue: number;
+    readonly balanceDueDaysBeforeStart: number;
+    readonly clearExistingPending: boolean;
+    readonly createGuarantee: boolean;
+    readonly guaranteeType: "bank_transfer" | "deposit" | "credit_card" | "preauth" | "card_on_file" | "voucher" | "agency_letter";
+    readonly notes: string | null;
+};
+export declare function resolvePaymentSessionTarget(method: "card" | "bank_transfer", stage: "initial" | "reminder" | "manual", override: "schedule" | "invoice" | undefined, options: CheckoutPolicyOptions): "invoice" | "schedule";
+export declare function resolveDocumentType(method: "card" | "bank_transfer", target: "schedule" | "invoice" | null, options: CheckoutPolicyOptions): "invoice" | "proforma" | null;
+export declare function fallbackInvoiceNumber(bookingNumber: string, documentType: "proforma" | "invoice", amountCents: number): string;
+export declare function lineDescription(booking: typeof bookings.$inferSelect, schedule: typeof bookingPaymentSchedules.$inferSelect | null, stage: "initial" | "reminder" | "manual"): string;
+export declare function normalizeExactAmountCents(amountCents: number | undefined): number | null;
+export declare function resolveCheckoutIntent(input: Pick<BootstrapCheckoutCollectionInput, "intent" | "stage" | "amountCents"> | Pick<InitiateCheckoutCollectionInput, "stage" | "amountCents">): "custom" | "deposit" | "balance";
+export declare function resolveCheckoutSubject(input: BootstrapCheckoutCollectionInput): {
+    bookingId: string;
+    sessionId: string;
+    sourceType: "booking";
+} | {
+    bookingId: string;
+    sessionId: string;
+    sourceType: "session";
+};
+export declare function buildBankTransferInstructions(invoice: typeof invoices.$inferSelect, details: CheckoutBankTransferDetails | null | undefined, callNotes?: string | null): CheckoutBankTransferInstructionsRecord | null;
+//# sourceMappingURL=checkout-service-plan.d.ts.map

package/dist/checkout-service-plan.d.ts.map

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

package/dist/checkout-service-plan.js

@@ -0,0 +1,119 @@
+export const OUTSTANDING_SCHEDULE_STATUSES = ["pending", "due"];
+export const OUTSTANDING_INVOICE_STATUSES = [
+    "draft",
+    "issued",
+    "partially_paid",
+    "overdue",
+];
+export function defaultPaymentPlan(options) {
+    return {
+        depositMode: options.defaultPaymentPlan?.depositMode ?? "percentage",
+        depositValue: options.defaultPaymentPlan?.depositValue ?? 30,
+        balanceDueDaysBeforeStart: options.defaultPaymentPlan?.balanceDueDaysBeforeStart ?? 30,
+        clearExistingPending: options.defaultPaymentPlan?.clearExistingPending ?? true,
+        createGuarantee: options.defaultPaymentPlan?.createGuarantee ?? false,
+        guaranteeType: options.defaultPaymentPlan?.guaranteeType ?? "deposit",
+        notes: options.defaultPaymentPlan?.notes ?? null,
+    };
+}
+export function resolvePaymentSessionTarget(method, stage, override, options) {
+    if (method === "bank_transfer")
+        return "invoice";
+    if (override)
+        return override;
+    if (stage === "reminder")
+        return options.defaultReminderCardCollectionTarget ?? "schedule";
+    return options.defaultCardCollectionTarget ?? "schedule";
+}
+export function resolveDocumentType(method, target, options) {
+    if (method === "bank_transfer") {
+        return options.defaultBankTransferDocumentType ?? "proforma";
+    }
+    if (target === "invoice") {
+        return "invoice";
+    }
+    return null;
+}
+export function fallbackInvoiceNumber(bookingNumber, documentType, amountCents) {
+    const stamp = Date.now().toString(36).toUpperCase();
+    const suffix = documentType === "proforma" ? "PF" : "INV";
+    return `${bookingNumber}-${suffix}-${amountCents}-${stamp}`;
+}
+export function lineDescription(booking, schedule, stage) {
+    if (!schedule) {
+        return `Booking ${booking.bookingNumber}`;
+    }
+    const kind = schedule.scheduleType === "deposit" ? "deposit" : schedule.scheduleType;
+    if (stage === "reminder") {
+        return `Booking ${booking.bookingNumber} ${kind} reminder`;
+    }
+    return `Booking ${booking.bookingNumber} ${kind}`;
+}
+export function normalizeExactAmountCents(amountCents) {
+    return typeof amountCents === "number" && Number.isFinite(amountCents) && amountCents > 0
+        ? Math.round(amountCents)
+        : null;
+}
+export function resolveCheckoutIntent(input) {
+    if ("intent" in input && input.intent) {
+        return input.intent;
+    }
+    if (typeof input.amountCents === "number" &&
+        Number.isFinite(input.amountCents) &&
+        input.amountCents > 0) {
+        return "custom";
+    }
+    if (input.stage === "initial") {
+        return "deposit";
+    }
+    if (input.stage === "reminder") {
+        return "balance";
+    }
+    return "custom";
+}
+export function resolveCheckoutSubject(input) {
+    if (input.bookingId && input.sessionId && input.bookingId !== input.sessionId) {
+        throw new Error("bookingId and sessionId must refer to the same booking session");
+    }
+    if (input.bookingId) {
+        return {
+            bookingId: input.bookingId,
+            sessionId: input.sessionId ?? input.bookingId,
+            sourceType: "booking",
+        };
+    }
+    if (input.sessionId) {
+        return {
+            bookingId: input.sessionId,
+            sessionId: input.sessionId,
+            sourceType: "session",
+        };
+    }
+    throw new Error("Provide a bookingId or sessionId");
+}
+function toInvoiceDueDateTime(value) {
+    return value ? `${value}T00:00:00.000Z` : null;
+}
+export function buildBankTransferInstructions(invoice, details, callNotes) {
+    if (!details) {
+        return null;
+    }
+    return {
+        provider: details.provider ?? null,
+        invoiceId: invoice.id,
+        invoiceNumber: invoice.invoiceNumber,
+        documentType: invoice.invoiceType === "proforma" ? "proforma" : "invoice",
+        amountCents: invoice.balanceDueCents,
+        // Currency always tracks the invoice - the deploy-wide bank-transfer
+        // block can't predict what the customer is buying. EUR booking +
+        // RON-default env would have shown the wrong currency to the customer.
+        currency: invoice.currency,
+        dueDate: toInvoiceDueDateTime(invoice.dueDate),
+        beneficiary: details.beneficiary,
+        iban: details.iban,
+        bankName: details.bankName ?? null,
+        // Per-call notes win over deploy-wide boilerplate - the caller knows
+        // booking context (invoice number, due date, etc.) the env can't.
+        notes: callNotes ?? details.notes ?? null,
+    };
+}

package/dist/checkout-service.d.ts

@@ -0,0 +1,9 @@
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import { type BootstrappedCheckoutCollection, type CheckoutCollectionPlan, type CheckoutPolicyOptions, type CheckoutRuntimeOptions, type InitiatedCheckoutCollection } from "./checkout-service-plan.js";
+import type { BootstrapCheckoutCollectionInput, InitiateCheckoutCollectionInput, PreviewCheckoutCollectionInput } from "./checkout-validation.js";
+export { type BootstrappedCheckoutCollection, type CheckoutBankTransferDetails, type CheckoutCollectionPlan, type CheckoutNotificationDelivery, type CheckoutNotificationDispatcher, type CheckoutPaymentStarter, type CheckoutPaymentStarterContext, type CheckoutPolicyOptions, type CheckoutProviderStartResult, type CheckoutRuntimeOptions, type InitiatedCheckoutCollection, resolvePaymentSessionTarget, } from "./checkout-service-plan.js";
+export type { BootstrapCheckoutCollectionInput, BootstrappedCheckoutCollectionRecord, CheckoutCollectionPlanRecord, InitiateCheckoutCollectionInput, InitiatedCheckoutCollectionRecord, PreviewCheckoutCollectionInput, } from "./checkout-validation.js";
+export declare function previewCheckoutCollection(db: PostgresJsDatabase, bookingId: string, input: PreviewCheckoutCollectionInput, options?: CheckoutPolicyOptions): Promise<CheckoutCollectionPlan | null>;
+export declare function initiateCheckoutCollection(db: PostgresJsDatabase, bookingId: string, input: InitiateCheckoutCollectionInput, options?: CheckoutPolicyOptions, runtime?: CheckoutRuntimeOptions): Promise<InitiatedCheckoutCollection | null>;
+export declare function bootstrapCheckoutCollection(db: PostgresJsDatabase, input: BootstrapCheckoutCollectionInput, options?: CheckoutPolicyOptions, runtime?: CheckoutRuntimeOptions): Promise<BootstrappedCheckoutCollection | null>;
+//# sourceMappingURL=checkout-service.d.ts.map

package/dist/checkout-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout-service.d.ts","sourceRoot":"","sources":["../src/checkout-service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EACL,KAAK,8BAA8B,EAEnC,KAAK,sBAAsB,EAE3B,KAAK,qBAAqB,EAE1B,KAAK,sBAAsB,EAG3B,KAAK,2BAA2B,EAUjC,MAAM,4BAA4B,CAAA;AACnC,OAAO,KAAK,EACV,gCAAgC,EAEhC,+BAA+B,EAC/B,8BAA8B,EAC/B,MAAM,0BAA0B,CAAA;AAUjC,OAAO,EACL,KAAK,8BAA8B,EACnC,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,EAC3B,KAAK,4BAA4B,EACjC,KAAK,8BAA8B,EACnC,KAAK,sBAAsB,EAC3B,KAAK,6BAA6B,EAClC,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,2BAA2B,GAC5B,MAAM,4BAA4B,CAAA;AACnC,YAAY,EACV,gCAAgC,EAChC,oCAAoC,EACpC,4BAA4B,EAC5B,+BAA+B,EAC/B,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,0BAA0B,CAAA;AAiHjC,wBAAsB,yBAAyB,CAC7C,EAAE,EAAE,kBAAkB,EACtB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,8BAA8B,EACrC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CA4ExC;AAkED,wBAAsB,0BAA0B,CAC9C,EAAE,EAAE,kBAAkB,EACtB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,+BAA+B,EACtC,OAAO,GAAE,qBAA0B,EACnC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC,CAkJ7C;AAUD,wBAAsB,2BAA2B,CAC/C,EAAE,EAAE,kBAAkB,EACtB,KAAK,EAAE,gCAAgC,EACvC,OAAO,GAAE,qBAA0B,EACnC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,8BAA8B,GAAG,IAAI,CAAC,CAmChD"}