@voyantjs/checkout 0.3.1 → 0.4.0

package/README.md

@@ -8,8 +8,14 @@ This package sits above `@voyantjs/finance` and `@voyantjs/notifications`. It do
 
 - previews a booking collection plan
 - creates bank-transfer collection documents (`proforma` by default)
+- supports exact-amount collection overrides by falling back to invoice-backed
+  collection when the requested amount does not match an existing schedule
 - creates card collection `payment_sessions`
 - supports schedule-backed or invoice-backed card collection
+- can start the provider flow in the same checkout request when a payment
+  starter is configured
+- can return customer-safe bank-transfer instructions when a bank-transfer
+  resolver is configured
 - optionally sends invoice or payment-session notifications
 
 ## Routes
@@ -21,6 +27,10 @@ This package sits above `@voyantjs/finance` and `@voyantjs/notifications`. It do
 ## Notes
 
 - payment-provider plugins like Netopia remain optional
+- provider startup is injected through `paymentStarters` or
+  `resolvePaymentStarters`
+- bank-transfer instructions are injected through `bankTransferDetails` or
+  `resolveBankTransferDetails`
 - email-provider choice remains app-owned
 - projects can override the default collection policy when mounting checkout
 - `createCheckoutHonoModule()` now mounts checkout through Voyant's module

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { checkoutModule, createCheckoutAdminRoutes, createCheckoutHonoModule, createCheckoutRoutes, } from "./routes.js";
-export type { CheckoutCollectionPlan, CheckoutPolicyOptions, CheckoutReminderRunList, CheckoutReminderRunSummary, InitiatedCheckoutCollection, } from "./service.js";
+export type { CheckoutBankTransferDetails, CheckoutCollectionPlan, CheckoutPaymentStarter, CheckoutPolicyOptions, CheckoutProviderStartResult, CheckoutReminderRunList, CheckoutReminderRunSummary, CheckoutRuntimeOptions, InitiatedCheckoutCollection, } from "./service.js";
 export { initiateCheckoutCollection, listBookingReminderRuns, previewCheckoutCollection, resolvePaymentSessionTarget, } from "./service.js";
-export type { CheckoutCollectionPlanRecord, CheckoutReminderRunListQuery, CheckoutReminderRunRecord, InitiateCheckoutCollectionInput, InitiatedCheckoutCollectionRecord, PreviewCheckoutCollectionInput, } from "./validation.js";
-export { checkoutCollectionInvoiceSchema, checkoutCollectionMethodSchema, checkoutCollectionPlanSchema, checkoutCollectionScheduleSchema, checkoutCollectionStageSchema, checkoutInvoiceDocumentTypeSchema, checkoutNotificationDeliverySchema, checkoutPaymentSessionTargetSchema, checkoutReminderRunListQuerySchema, checkoutReminderRunListResponseSchema, checkoutReminderRunSchema, initiateCheckoutCollectionSchema, initiatedCheckoutCollectionSchema, previewCheckoutCollectionSchema, } from "./validation.js";
+export type { CheckoutBankTransferInstructionsRecord, CheckoutCollectionPlanRecord, CheckoutProviderStartInput, CheckoutProviderStartResultRecord, CheckoutReminderRunListQuery, CheckoutReminderRunRecord, InitiateCheckoutCollectionInput, InitiatedCheckoutCollectionRecord, PreviewCheckoutCollectionInput, } from "./validation.js";
+export { checkoutBankTransferInstructionsSchema, checkoutCollectionInvoiceSchema, checkoutCollectionMethodSchema, checkoutCollectionPlanSchema, checkoutCollectionScheduleSchema, checkoutCollectionStageSchema, checkoutInvoiceDocumentTypeSchema, checkoutNotificationDeliverySchema, checkoutPaymentSessionTargetSchema, checkoutProviderStartInputSchema, checkoutProviderStartResultSchema, checkoutReminderRunListQuerySchema, checkoutReminderRunListResponseSchema, checkoutReminderRunSchema, initiateCheckoutCollectionSchema, initiatedCheckoutCollectionSchema, previewCheckoutCollectionSchema, } from "./validation.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":"AAAA,OAAO,EACL,cAAc,EACd,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,cAAc,CAAA;AACrB,YAAY,EACV,4BAA4B,EAC5B,4BAA4B,EAC5B,yBAAyB,EACzB,+BAA+B,EAC/B,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,+BAA+B,EAC/B,8BAA8B,EAC9B,4BAA4B,EAC5B,gCAAgC,EAChC,6BAA6B,EAC7B,iCAAiC,EACjC,kCAAkC,EAClC,kCAAkC,EAClC,kCAAkC,EAClC,qCAAqC,EACrC,yBAAyB,EACzB,gCAAgC,EAChC,iCAAiC,EACjC,+BAA+B,GAChC,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,2BAA2B,EAC3B,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,2BAA2B,EAC3B,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,cAAc,CAAA;AACrB,YAAY,EACV,sCAAsC,EACtC,4BAA4B,EAC5B,0BAA0B,EAC1B,iCAAiC,EACjC,4BAA4B,EAC5B,yBAAyB,EACzB,+BAA+B,EAC/B,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,sCAAsC,EACtC,+BAA+B,EAC/B,8BAA8B,EAC9B,4BAA4B,EAC5B,gCAAgC,EAChC,6BAA6B,EAC7B,iCAAiC,EACjC,kCAAkC,EAClC,kCAAkC,EAClC,gCAAgC,EAChC,iCAAiC,EACjC,kCAAkC,EAClC,qCAAqC,EACrC,yBAAyB,EACzB,gCAAgC,EAChC,iCAAiC,EACjC,+BAA+B,GAChC,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -1,3 +1,3 @@
 export { checkoutModule, createCheckoutAdminRoutes, createCheckoutHonoModule, createCheckoutRoutes, } from "./routes.js";
 export { initiateCheckoutCollection, listBookingReminderRuns, previewCheckoutCollection, resolvePaymentSessionTarget, } from "./service.js";
-export { checkoutCollectionInvoiceSchema, checkoutCollectionMethodSchema, checkoutCollectionPlanSchema, checkoutCollectionScheduleSchema, checkoutCollectionStageSchema, checkoutInvoiceDocumentTypeSchema, checkoutNotificationDeliverySchema, checkoutPaymentSessionTargetSchema, checkoutReminderRunListQuerySchema, checkoutReminderRunListResponseSchema, checkoutReminderRunSchema, initiateCheckoutCollectionSchema, initiatedCheckoutCollectionSchema, previewCheckoutCollectionSchema, } from "./validation.js";
+export { checkoutBankTransferInstructionsSchema, checkoutCollectionInvoiceSchema, checkoutCollectionMethodSchema, checkoutCollectionPlanSchema, checkoutCollectionScheduleSchema, checkoutCollectionStageSchema, checkoutInvoiceDocumentTypeSchema, checkoutNotificationDeliverySchema, checkoutPaymentSessionTargetSchema, checkoutProviderStartInputSchema, checkoutProviderStartResultSchema, checkoutReminderRunListQuerySchema, checkoutReminderRunListResponseSchema, checkoutReminderRunSchema, initiateCheckoutCollectionSchema, initiatedCheckoutCollectionSchema, previewCheckoutCollectionSchema, } from "./validation.js";

package/dist/routes.d.ts

@@ -2,7 +2,7 @@ import type { Module } from "@voyantjs/core";
 import type { HonoModule } from "@voyantjs/hono/module";
 import type { NotificationProvider } from "@voyantjs/notifications";
 import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
-import { type CheckoutPolicyOptions } from "./service.js";
+import { type CheckoutBankTransferDetails, type CheckoutPaymentStarter, type CheckoutPolicyOptions } from "./service.js";
 type Env = {
     Bindings: Record<string, unknown>;
     Variables: {
@@ -14,6 +14,10 @@ export declare function createCheckoutRoutes(options?: {
     policy?: CheckoutPolicyOptions;
     providers?: ReadonlyArray<NotificationProvider>;
     resolveProviders?: (bindings: Record<string, unknown>) => ReadonlyArray<NotificationProvider>;
+    paymentStarters?: Record<string, CheckoutPaymentStarter>;
+    resolvePaymentStarters?: (bindings: Record<string, unknown>) => Record<string, CheckoutPaymentStarter>;
+    bankTransferDetails?: CheckoutBankTransferDetails | null;
+    resolveBankTransferDetails?: (bindings: Record<string, unknown>) => CheckoutBankTransferDetails | null;
 }): import("hono/hono-base").HonoBase<Env, {
     "/v1/checkout/bookings/:bookingId/collection-plan": {
         $post: {
@@ -282,25 +286,25 @@ export declare function createCheckoutRoutes(options?: {
                         } | null;
                         channel: "email" | "sms";
                         provider: string;
-                        targetType: "other" | "booking" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "payment_session" | "person" | "organization";
+                        targetType: "other" | "booking" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "organization" | "person" | "payment_session";
                         targetId: string | null;
                         templateId: string | null;
                         invoiceId: string | null;
                         failedAt: string | null;
                         errorMessage: string | null;
+                        subject: string | null;
+                        sentAt: string | null;
                         fromAddress: string | null;
                         templateSlug: string | null;
                         paymentSessionId: string | null;
                         providerMessageId: string | null;
                         toAddress: string;
-                        subject: string | null;
                         htmlBody: string | null;
                         textBody: string | null;
                         payloadData: {
                             [x: string]: import("hono/utils/types").JSONValue;
                         } | null;
                         scheduledFor: string | null;
-                        sentAt: string | null;
                     } | null;
                     paymentSessionNotification: {
                         id: string;
@@ -315,25 +319,49 @@ export declare function createCheckoutRoutes(options?: {
                         } | null;
                         channel: "email" | "sms";
                         provider: string;
-                        targetType: "other" | "booking" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "payment_session" | "person" | "organization";
+                        targetType: "other" | "booking" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "organization" | "person" | "payment_session";
                         targetId: string | null;
                         templateId: string | null;
                         invoiceId: string | null;
                         failedAt: string | null;
                         errorMessage: string | null;
+                        subject: string | null;
+                        sentAt: string | null;
                         fromAddress: string | null;
                         templateSlug: string | null;
                         paymentSessionId: string | null;
                         providerMessageId: string | null;
                         toAddress: string;
-                        subject: string | null;
                         htmlBody: string | null;
                         textBody: string | null;
                         payloadData: {
                             [x: string]: import("hono/utils/types").JSONValue;
                         } | null;
                         scheduledFor: string | null;
-                        sentAt: string | null;
+                    } | null;
+                    bankTransferInstructions: {
+                        provider: string | null;
+                        invoiceId: string;
+                        invoiceNumber: string;
+                        documentType: "invoice" | "proforma";
+                        amountCents: number;
+                        currency: string;
+                        dueDate: string | null;
+                        beneficiary: string;
+                        iban: string;
+                        bankName: string | null;
+                        notes: string | null;
+                    } | null;
+                    providerStart: {
+                        provider: string;
+                        paymentSessionId: string;
+                        redirectUrl: string | null;
+                        externalReference: string | null;
+                        providerSessionId: string | null;
+                        providerPaymentId: string | null;
+                        response: {
+                            [x: string]: import("hono/utils/types").JSONValue;
+                        } | null;
                     } | null;
                 };
             };
@@ -367,7 +395,7 @@ export declare function createCheckoutAdminRoutes(): import("hono/hono-base").Ho
                     reminderRuleId: string;
                     reminderRuleSlug: string | null;
                     reminderRuleName: string | null;
-                    targetType: "booking_payment_schedule";
+                    targetType: "booking_payment_schedule" | "invoice";
                     targetId: string;
                     bookingId: string | null;
                     paymentSessionId: string | null;

package/dist/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAEnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAGjE,OAAO,EACL,KAAK,qBAAqB,EAI3B,MAAM,cAAc,CAAA;AAOrB,KAAK,GAAG,GAAG;IACT,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,SAAS,EAAE;QACT,EAAE,EAAE,kBAAkB,CAAA;QACtB,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;CACF,CAAA;AAED,wBAAgB,oBAAoB,CAClC,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,qBAAqB,CAAA;IAC9B,SAAS,CAAC,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAA;IAC/C,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,aAAa,CAAC,oBAAoB,CAAC,CAAA;CACzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gEAkDP;AAED,wBAAgB,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8CAQxC;AAED,eAAO,MAAM,cAAc,EAAE,MAE5B,CAAA;AAED,wBAAgB,wBAAwB,CACtC,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC,GACnD,UAAU,CAMZ"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAEnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAGjE,OAAO,EACL,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAI3B,MAAM,cAAc,CAAA;AAOrB,KAAK,GAAG,GAAG;IACT,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,SAAS,EAAE;QACT,EAAE,EAAE,kBAAkB,CAAA;QACtB,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;CACF,CAAA;AAED,wBAAgB,oBAAoB,CAClC,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,qBAAqB,CAAA;IAC9B,SAAS,CAAC,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAA;IAC/C,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,aAAa,CAAC,oBAAoB,CAAC,CAAA;IAC7F,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAA;IACxD,sBAAsB,CAAC,EAAE,CACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAA;IAC3C,mBAAmB,CAAC,EAAE,2BAA2B,GAAG,IAAI,CAAA;IACxD,0BAA0B,CAAC,EAAE,CAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,2BAA2B,GAAG,IAAI,CAAA;CACnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gEAyDP;AAED,wBAAgB,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8CAQxC;AAED,eAAO,MAAM,cAAc,EAAE,MAE5B,CAAA;AAED,wBAAgB,wBAAwB,CACtC,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC,GACnD,UAAU,CAMZ"}

package/dist/routes.js

@@ -20,7 +20,11 @@ export function createCheckoutRoutes(options = {}) {
         .post("/v1/checkout/bookings/:bookingId/initiate-collection", async (c) => {
         try {
             const dispatcher = createNotificationService(options.resolveProviders?.(c.env) ?? options.providers ?? []);
-            const result = await initiateCheckoutCollection(c.get("db"), c.req.param("bookingId"), initiateCheckoutCollectionSchema.parse(await c.req.json()), options.policy, dispatcher);
+            const result = await initiateCheckoutCollection(c.get("db"), c.req.param("bookingId"), initiateCheckoutCollectionSchema.parse(await c.req.json()), options.policy, dispatcher, {
+                bindings: c.env,
+                paymentStarters: options.resolvePaymentStarters?.(c.env) ?? options.paymentStarters ?? {},
+                bankTransferDetails: options.resolveBankTransferDetails?.(c.env) ?? options.bankTransferDetails ?? null,
+            });
             if (!result) {
                 return c.json({ error: "Booking not found" }, 404);
             }

package/dist/service.d.ts

@@ -1,7 +1,7 @@
 import { bookingPaymentSchedules, invoices, type PaymentSession } from "@voyantjs/finance";
 import type { NotificationDelivery, NotificationService } from "@voyantjs/notifications";
 import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
-import type { CheckoutReminderRunListQuery, InitiateCheckoutCollectionInput, PreviewCheckoutCollectionInput } from "./validation.js";
+import type { CheckoutBankTransferInstructionsRecord, CheckoutProviderStartInput, CheckoutReminderRunListQuery, InitiateCheckoutCollectionInput, PreviewCheckoutCollectionInput } from "./validation.js";
 export interface CheckoutPolicyOptions {
     defaultCardCollectionTarget?: "schedule" | "invoice";
     defaultReminderCardCollectionTarget?: "schedule" | "invoice";
@@ -29,19 +29,54 @@ export interface CheckoutCollectionPlan {
     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;
+    currency?: string | null;
+    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 InitiatedCheckoutCollection {
     plan: CheckoutCollectionPlan;
     invoice: typeof invoices.$inferSelect | null;
     paymentSession: PaymentSession | null;
     invoiceNotification: NotificationDelivery | null;
     paymentSessionNotification: NotificationDelivery | null;
+    bankTransferInstructions: CheckoutBankTransferInstructionsRecord | null;
+    providerStart: CheckoutProviderStartResult | null;
+}
+export interface CheckoutRuntimeOptions {
+    bindings?: Record<string, unknown>;
+    bankTransferDetails?: CheckoutBankTransferDetails | null;
+    paymentStarters?: Record<string, CheckoutPaymentStarter>;
 }
 export interface CheckoutReminderRunSummary {
     id: string;
     reminderRuleId: string;
     reminderRuleSlug: string | null;
     reminderRuleName: string | null;
-    targetType: "booking_payment_schedule";
+    targetType: "booking_payment_schedule" | "invoice";
     targetId: string;
     bookingId: string | null;
     paymentSessionId: string | null;
@@ -65,6 +100,6 @@ export interface CheckoutReminderRunList {
 }
 export declare function resolvePaymentSessionTarget(method: "card" | "bank_transfer", stage: "initial" | "reminder" | "manual", override: "schedule" | "invoice" | undefined, options: CheckoutPolicyOptions): "invoice" | "schedule";
 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, dispatcher?: NotificationService): Promise<InitiatedCheckoutCollection | null>;
+export declare function initiateCheckoutCollection(db: PostgresJsDatabase, bookingId: string, input: InitiateCheckoutCollectionInput, options?: CheckoutPolicyOptions, dispatcher?: NotificationService, runtime?: CheckoutRuntimeOptions): Promise<InitiatedCheckoutCollection | null>;
 export declare function listBookingReminderRuns(db: PostgresJsDatabase, bookingId: string, query: CheckoutReminderRunListQuery): Promise<CheckoutReminderRunList>;
 //# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

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

package/dist/service.js

@@ -56,6 +56,32 @@ function lineDescription(booking, schedule, stage) {
     }
     return `Booking ${booking.bookingNumber} ${kind}`;
 }
+function normalizeExactAmountCents(amountCents) {
+    return typeof amountCents === "number" && Number.isFinite(amountCents) && amountCents > 0
+        ? Math.round(amountCents)
+        : null;
+}
+function toInvoiceDueDateTime(value) {
+    return value ? `${value}T00:00:00.000Z` : null;
+}
+function buildBankTransferInstructions(invoice, details) {
+    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: details.currency ?? invoice.currency,
+        dueDate: toInvoiceDueDateTime(invoice.dueDate),
+        beneficiary: details.beneficiary,
+        iban: details.iban,
+        bankName: details.bankName ?? null,
+        notes: details.notes ?? null,
+    };
+}
 async function loadBookingContext(db, bookingId) {
     const [booking] = await db.select().from(bookings).where(eq(bookings.id, bookingId)).limit(1);
     if (!booking)
@@ -133,12 +159,30 @@ export async function previewCheckoutCollection(db, bookingId, input, options =
     if (!context)
         return null;
     const schedules = await ensurePaymentPlanIfNeeded(db, bookingId, context.schedules, input, options);
-    const paymentSessionTarget = resolvePaymentSessionTarget(input.method, input.stage, input.paymentSessionTarget, options);
-    const documentType = resolveDocumentType(input.method, paymentSessionTarget, options);
-    const selectedSchedule = pickSchedule(schedules, input.scheduleId);
-    const selectedInvoice = pickInvoice(context.outstandingInvoices, input.invoiceId);
+    let paymentSessionTarget = resolvePaymentSessionTarget(input.method, input.stage, input.paymentSessionTarget, options);
+    let documentType = resolveDocumentType(input.method, paymentSessionTarget, options);
+    let selectedSchedule = pickSchedule(schedules, input.scheduleId);
+    let selectedInvoice = pickInvoice(context.outstandingInvoices, input.invoiceId);
+    const requestedAmountCents = normalizeExactAmountCents(input.amountCents);
     let amountCents = 0;
-    if (paymentSessionTarget === "invoice") {
+    if (requestedAmountCents !== null) {
+        amountCents = requestedAmountCents;
+        if (paymentSessionTarget === "schedule" &&
+            selectedSchedule &&
+            selectedSchedule.amountCents === requestedAmountCents) {
+            selectedInvoice = null;
+        }
+        else {
+            paymentSessionTarget = "invoice";
+            documentType = resolveDocumentType(input.method, paymentSessionTarget, options);
+            selectedInvoice =
+                selectedInvoice && selectedInvoice.balanceDueCents === requestedAmountCents
+                    ? selectedInvoice
+                    : null;
+            selectedSchedule = null;
+        }
+    }
+    else if (paymentSessionTarget === "invoice") {
         amountCents =
             selectedInvoice?.balanceDueCents ??
                 selectedSchedule?.amountCents ??
@@ -223,7 +267,7 @@ async function createCollectionInvoice(db, context, plan, notes) {
     });
     return invoice;
 }
-export async function initiateCheckoutCollection(db, bookingId, input, options = {}, dispatcher) {
+export async function initiateCheckoutCollection(db, bookingId, input, options = {}, dispatcher, runtime = {}) {
     const context = await loadBookingContext(db, bookingId);
     if (!context)
         return null;
@@ -237,8 +281,11 @@ export async function initiateCheckoutCollection(db, bookingId, input, options =
     let paymentSession = null;
     let invoiceNotification = null;
     let paymentSessionNotification = null;
+    let bankTransferInstructions = null;
+    let providerStart = null;
     if (input.method === "bank_transfer") {
         invoice = await createCollectionInvoice(db, context, plan, input.notes ?? null);
+        bankTransferInstructions = buildBankTransferInstructions(invoice, runtime.bankTransferDetails ?? null);
         if (dispatcher && input.invoiceNotification) {
             invoiceNotification = await notificationsService.sendInvoiceNotification(db, dispatcher, invoice.id, input.invoiceNotification);
         }
@@ -276,12 +323,44 @@ export async function initiateCheckoutCollection(db, bookingId, input, options =
             paymentSessionNotification = await notificationsService.sendPaymentSessionNotification(db, dispatcher, paymentSession.id, input.paymentSessionNotification);
         }
     }
+    if (input.startProvider) {
+        if (input.method !== "card") {
+            throw new Error("Provider start is only available for card collections");
+        }
+        if (!paymentSession) {
+            throw new Error("No payment session available for provider start");
+        }
+        const starter = runtime.paymentStarters?.[input.startProvider.provider];
+        if (!starter) {
+            throw new Error(`Payment provider "${input.startProvider.provider}" is not configured`);
+        }
+        providerStart = await starter({
+            db,
+            bookingId,
+            plan,
+            invoice: invoice ?? null,
+            paymentSession,
+            input,
+            startProvider: input.startProvider,
+            bindings: runtime.bindings ?? {},
+        });
+        if (providerStart.paymentSessionId !== paymentSession.id) {
+            const updatedSession = await financeService.getPaymentSessionById(db, providerStart.paymentSessionId);
+            paymentSession = updatedSession ?? paymentSession;
+        }
+        else {
+            const updatedSession = await financeService.getPaymentSessionById(db, paymentSession.id);
+            paymentSession = updatedSession ?? paymentSession;
+        }
+    }
     return {
         plan,
         invoice: invoice ?? null,
         paymentSession,
         invoiceNotification,
         paymentSessionNotification,
+        bankTransferInstructions,
+        providerStart,
     };
 }
 export async function listBookingReminderRuns(db, bookingId, query) {

package/dist/validation.d.ts

@@ -16,6 +16,10 @@ export declare const checkoutInvoiceDocumentTypeSchema: z.ZodEnum<{
     invoice: "invoice";
     proforma: "proforma";
 }>;
+export declare const checkoutProviderStartInputSchema: z.ZodObject<{
+    provider: z.ZodString;
+    payload: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strip>;
 export declare const previewCheckoutCollectionSchema: z.ZodObject<{
     method: z.ZodEnum<{
         bank_transfer: "bank_transfer";
@@ -28,6 +32,7 @@ export declare const previewCheckoutCollectionSchema: z.ZodObject<{
     }>>;
     scheduleId: z.ZodOptional<z.ZodString>;
     invoiceId: z.ZodOptional<z.ZodString>;
+    amountCents: z.ZodOptional<z.ZodNumber>;
     ensureDefaultPaymentPlan: z.ZodDefault<z.ZodBoolean>;
     paymentSessionTarget: z.ZodOptional<z.ZodEnum<{
         invoice: "invoice";
@@ -69,6 +74,7 @@ export declare const initiateCheckoutCollectionSchema: z.ZodObject<{
     }>>;
     scheduleId: z.ZodOptional<z.ZodString>;
     invoiceId: z.ZodOptional<z.ZodString>;
+    amountCents: z.ZodOptional<z.ZodNumber>;
     ensureDefaultPaymentPlan: z.ZodDefault<z.ZodBoolean>;
     paymentSessionTarget: z.ZodOptional<z.ZodEnum<{
         invoice: "invoice";
@@ -165,6 +171,17 @@ export declare const initiateCheckoutCollectionSchema: z.ZodObject<{
         subject: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         html: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         text: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        attachments: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            filename: z.ZodString;
+            contentBase64: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            path: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            contentType: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            disposition: z.ZodNullable<z.ZodOptional<z.ZodEnum<{
+                attachment: "attachment";
+                inline: "inline";
+            }>>>;
+            contentId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        }, z.core.$strip>>>>;
         data: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         metadata: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         scheduledFor: z.ZodNullable<z.ZodOptional<z.ZodString>>;
@@ -182,10 +199,25 @@ export declare const initiateCheckoutCollectionSchema: z.ZodObject<{
         subject: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         html: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         text: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        attachments: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            filename: z.ZodString;
+            contentBase64: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            path: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            contentType: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            disposition: z.ZodNullable<z.ZodOptional<z.ZodEnum<{
+                attachment: "attachment";
+                inline: "inline";
+            }>>>;
+            contentId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        }, z.core.$strip>>>>;
         data: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         metadata: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         scheduledFor: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     }, z.core.$strip>>;
+    startProvider: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodString;
+        payload: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$strip>>;
     notes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>;
 export declare const checkoutCollectionScheduleSchema: z.ZodObject<{
@@ -237,6 +269,31 @@ export declare const checkoutNotificationDeliverySchema: z.ZodObject<{
     failedAt: z.ZodNullable<z.ZodString>;
     errorMessage: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
+export declare const checkoutBankTransferInstructionsSchema: z.ZodObject<{
+    provider: z.ZodNullable<z.ZodString>;
+    invoiceId: z.ZodString;
+    invoiceNumber: z.ZodString;
+    documentType: z.ZodEnum<{
+        invoice: "invoice";
+        proforma: "proforma";
+    }>;
+    amountCents: z.ZodNumber;
+    currency: z.ZodString;
+    dueDate: z.ZodNullable<z.ZodString>;
+    beneficiary: z.ZodString;
+    iban: z.ZodString;
+    bankName: z.ZodNullable<z.ZodString>;
+    notes: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const checkoutProviderStartResultSchema: z.ZodObject<{
+    provider: z.ZodString;
+    paymentSessionId: z.ZodString;
+    redirectUrl: z.ZodNullable<z.ZodString>;
+    externalReference: z.ZodNullable<z.ZodString>;
+    providerSessionId: z.ZodNullable<z.ZodString>;
+    providerPaymentId: z.ZodNullable<z.ZodString>;
+    response: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
 export declare const checkoutCollectionPlanSchema: z.ZodObject<{
     bookingId: z.ZodString;
     method: z.ZodEnum<{
@@ -465,6 +522,31 @@ export declare const initiatedCheckoutCollectionSchema: z.ZodObject<{
         failedAt: z.ZodNullable<z.ZodString>;
         errorMessage: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>>;
+    bankTransferInstructions: z.ZodNullable<z.ZodObject<{
+        provider: z.ZodNullable<z.ZodString>;
+        invoiceId: z.ZodString;
+        invoiceNumber: z.ZodString;
+        documentType: z.ZodEnum<{
+            invoice: "invoice";
+            proforma: "proforma";
+        }>;
+        amountCents: z.ZodNumber;
+        currency: z.ZodString;
+        dueDate: z.ZodNullable<z.ZodString>;
+        beneficiary: z.ZodString;
+        iban: z.ZodString;
+        bankName: z.ZodNullable<z.ZodString>;
+        notes: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    providerStart: z.ZodNullable<z.ZodObject<{
+        provider: z.ZodString;
+        paymentSessionId: z.ZodString;
+        redirectUrl: z.ZodNullable<z.ZodString>;
+        externalReference: z.ZodNullable<z.ZodString>;
+        providerSessionId: z.ZodNullable<z.ZodString>;
+        providerPaymentId: z.ZodNullable<z.ZodString>;
+        response: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const checkoutReminderRunListQuerySchema: z.ZodObject<{
     limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
@@ -481,7 +563,10 @@ export declare const checkoutReminderRunSchema: z.ZodObject<{
     reminderRuleId: z.ZodString;
     reminderRuleSlug: z.ZodNullable<z.ZodString>;
     reminderRuleName: z.ZodNullable<z.ZodString>;
-    targetType: z.ZodLiteral<"booking_payment_schedule">;
+    targetType: z.ZodEnum<{
+        invoice: "invoice";
+        booking_payment_schedule: "booking_payment_schedule";
+    }>;
     targetId: z.ZodString;
     bookingId: z.ZodNullable<z.ZodString>;
     paymentSessionId: z.ZodNullable<z.ZodString>;
@@ -516,7 +601,10 @@ export declare const checkoutReminderRunListResponseSchema: z.ZodObject<{
         reminderRuleId: z.ZodString;
         reminderRuleSlug: z.ZodNullable<z.ZodString>;
         reminderRuleName: z.ZodNullable<z.ZodString>;
-        targetType: z.ZodLiteral<"booking_payment_schedule">;
+        targetType: z.ZodEnum<{
+            invoice: "invoice";
+            booking_payment_schedule: "booking_payment_schedule";
+        }>;
         targetId: z.ZodString;
         bookingId: z.ZodNullable<z.ZodString>;
         paymentSessionId: z.ZodNullable<z.ZodString>;
@@ -553,6 +641,9 @@ export type PreviewCheckoutCollectionInput = z.infer<typeof previewCheckoutColle
 export type InitiateCheckoutCollectionInput = z.infer<typeof initiateCheckoutCollectionSchema>;
 export type CheckoutCollectionPlanRecord = z.infer<typeof checkoutCollectionPlanSchema>;
 export type InitiatedCheckoutCollectionRecord = z.infer<typeof initiatedCheckoutCollectionSchema>;
+export type CheckoutProviderStartInput = z.infer<typeof checkoutProviderStartInputSchema>;
+export type CheckoutBankTransferInstructionsRecord = z.infer<typeof checkoutBankTransferInstructionsSchema>;
+export type CheckoutProviderStartResultRecord = z.infer<typeof checkoutProviderStartResultSchema>;
 export type CheckoutReminderRunListQuery = z.infer<typeof checkoutReminderRunListQuerySchema>;
 export type CheckoutReminderRunRecord = z.infer<typeof checkoutReminderRunSchema>;
 //# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,8BAA8B;;;EAAoC,CAAA;AAC/E,eAAO,MAAM,6BAA6B;;;;EAA4C,CAAA;AACtF,eAAO,MAAM,kCAAkC;;;EAAkC,CAAA;AACjF,eAAO,MAAM,iCAAiC;;;EAAkC,CAAA;AAQhF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQ1C,CAAA;AAEF,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAO3C,CAAA;AAEF,eAAO,MAAM,gCAAgC;;;;;;;;;;iBAU3C,CAAA;AAEF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;iBAiB1C,CAAA;AAEF,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;iBAW7C,CAAA;AAEF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiBvC,CAAA;AAEF,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAM5C,CAAA;AAEF,eAAO,MAAM,kCAAkC;;;;;;;;;iBAE7C,CAAA;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoBpC,CAAA;AAEF,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKhD,CAAA;AAEF,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AAC5F,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAA;AAC9F,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AACvF,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAA;AACjG,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAC7F,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,8BAA8B;;;EAAoC,CAAA;AAC/E,eAAO,MAAM,6BAA6B;;;;EAA4C,CAAA;AACtF,eAAO,MAAM,kCAAkC;;;EAAkC,CAAA;AACjF,eAAO,MAAM,iCAAiC;;;EAAkC,CAAA;AAChF,eAAO,MAAM,gCAAgC;;;iBAG3C,CAAA;AAQF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAS1C,CAAA;AAEF,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQ3C,CAAA;AAEF,eAAO,MAAM,gCAAgC;;;;;;;;;;iBAU3C,CAAA;AAEF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;iBAiB1C,CAAA;AAEF,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;iBAW7C,CAAA;AAEF,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;iBAYjD,CAAA;AAEF,eAAO,MAAM,iCAAiC;;;;;;;;iBAQ5C,CAAA;AAEF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiBvC,CAAA;AAEF,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQ5C,CAAA;AAEF,eAAO,MAAM,kCAAkC;;;;;;;;;iBAE7C,CAAA;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoBpC,CAAA;AAEF,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKhD,CAAA;AAEF,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AAC5F,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAA;AAC9F,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AACvF,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAA;AACjG,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAA;AACzF,MAAM,MAAM,sCAAsC,GAAG,CAAC,CAAC,KAAK,CAC1D,OAAO,sCAAsC,CAC9C,CAAA;AACD,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAA;AACjG,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAC7F,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA"}

package/dist/validation.js

@@ -1,10 +1,14 @@
 import { applyDefaultBookingPaymentPlanSchema, createPaymentSessionFromInvoiceSchema, createPaymentSessionFromScheduleSchema, publicPaymentSessionSchema, } from "@voyantjs/finance";
-import { notificationChannelSchema, notificationDeliveryStatusSchema, notificationReminderRunStatusSchema, sendInvoiceNotificationSchema, sendPaymentSessionNotificationSchema, } from "@voyantjs/notifications";
+import { notificationChannelSchema, notificationDeliveryStatusSchema, notificationReminderRunStatusSchema, notificationReminderTargetTypeSchema, sendInvoiceNotificationSchema, sendPaymentSessionNotificationSchema, } from "@voyantjs/notifications";
 import { z } from "zod";
 export const checkoutCollectionMethodSchema = z.enum(["card", "bank_transfer"]);
 export const checkoutCollectionStageSchema = z.enum(["initial", "reminder", "manual"]);
 export const checkoutPaymentSessionTargetSchema = z.enum(["schedule", "invoice"]);
 export const checkoutInvoiceDocumentTypeSchema = z.enum(["proforma", "invoice"]);
+export const checkoutProviderStartInputSchema = z.object({
+    provider: z.string().min(1).max(255),
+    payload: z.record(z.string(), z.unknown()).optional().nullable(),
+});
 const planOverrideSchema = applyDefaultBookingPaymentPlanSchema.partial();
 const paginationSchema = z.object({
     limit: z.coerce.number().int().min(1).max(100).default(20),
@@ -15,6 +19,7 @@ export const previewCheckoutCollectionSchema = z.object({
     stage: checkoutCollectionStageSchema.default("initial"),
     scheduleId: z.string().optional(),
     invoiceId: z.string().optional(),
+    amountCents: z.number().int().min(1).optional(),
     ensureDefaultPaymentPlan: z.boolean().default(true),
     paymentSessionTarget: checkoutPaymentSessionTargetSchema.optional(),
     paymentPlan: planOverrideSchema.optional(),
@@ -25,6 +30,7 @@ export const initiateCheckoutCollectionSchema = previewCheckoutCollectionSchema.
         .optional(),
     paymentSessionNotification: sendPaymentSessionNotificationSchema.optional(),
     invoiceNotification: sendInvoiceNotificationSchema.optional(),
+    startProvider: checkoutProviderStartInputSchema.optional(),
     notes: z.string().optional().nullable(),
 });
 export const checkoutCollectionScheduleSchema = z.object({
@@ -68,6 +74,28 @@ export const checkoutNotificationDeliverySchema = z.object({
     failedAt: z.string().nullable(),
     errorMessage: z.string().nullable(),
 });
+export const checkoutBankTransferInstructionsSchema = z.object({
+    provider: z.string().nullable(),
+    invoiceId: z.string(),
+    invoiceNumber: z.string(),
+    documentType: checkoutInvoiceDocumentTypeSchema,
+    amountCents: z.number().int(),
+    currency: z.string(),
+    dueDate: z.string().nullable(),
+    beneficiary: z.string(),
+    iban: z.string(),
+    bankName: z.string().nullable(),
+    notes: z.string().nullable(),
+});
+export const checkoutProviderStartResultSchema = z.object({
+    provider: z.string(),
+    paymentSessionId: z.string(),
+    redirectUrl: z.string().nullable(),
+    externalReference: z.string().nullable(),
+    providerSessionId: z.string().nullable(),
+    providerPaymentId: z.string().nullable(),
+    response: z.record(z.string(), z.unknown()).nullable(),
+});
 export const checkoutCollectionPlanSchema = z.object({
     bookingId: z.string(),
     method: checkoutCollectionMethodSchema,
@@ -92,6 +120,8 @@ export const initiatedCheckoutCollectionSchema = z.object({
     paymentSession: publicPaymentSessionSchema.nullable(),
     invoiceNotification: checkoutNotificationDeliverySchema.nullable(),
     paymentSessionNotification: checkoutNotificationDeliverySchema.nullable(),
+    bankTransferInstructions: checkoutBankTransferInstructionsSchema.nullable(),
+    providerStart: checkoutProviderStartResultSchema.nullable(),
 });
 export const checkoutReminderRunListQuerySchema = paginationSchema.extend({
     status: notificationReminderRunStatusSchema.optional(),
@@ -101,7 +131,7 @@ export const checkoutReminderRunSchema = z.object({
     reminderRuleId: z.string(),
     reminderRuleSlug: z.string().nullable(),
     reminderRuleName: z.string().nullable(),
-    targetType: z.literal("booking_payment_schedule"),
+    targetType: notificationReminderTargetTypeSchema,
     targetId: z.string(),
     bookingId: z.string().nullable(),
     paymentSessionId: z.string().nullable(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/checkout",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "license": "FSL-1.1-Apache-2.0",
   "type": "module",
   "exports": {
@@ -25,11 +25,11 @@
     "drizzle-orm": "^0.45.2",
     "hono": "^4.12.10",
     "zod": "^4.3.6",
-    "@voyantjs/bookings": "0.3.1",
-    "@voyantjs/core": "0.3.1",
-    "@voyantjs/finance": "0.3.1",
-    "@voyantjs/hono": "0.3.1",
-    "@voyantjs/notifications": "0.3.1"
+    "@voyantjs/bookings": "0.4.0",
+    "@voyantjs/core": "0.4.0",
+    "@voyantjs/finance": "0.4.0",
+    "@voyantjs/hono": "0.4.0",
+    "@voyantjs/notifications": "0.4.0"
   },
   "devDependencies": {
     "typescript": "^6.0.2",