@voyantjs/checkout 0.3.0 → 0.4.0

package/README.md

@@ -8,17 +8,30 @@ 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
 
 - `POST /v1/checkout/bookings/:bookingId/collection-plan`
 - `POST /v1/checkout/bookings/:bookingId/initiate-collection`
+- `GET /v1/admin/checkout/bookings/:bookingId/reminder-runs`
 
 ## 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 the routes
+- projects can override the default collection policy when mounting checkout
+- `createCheckoutHonoModule()` now mounts checkout through Voyant's module
+  system while preserving the legacy `/v1/checkout/*` public path

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export { createCheckoutRoutes } from "./routes.js";
-export type { CheckoutCollectionPlan, CheckoutPolicyOptions, InitiatedCheckoutCollection, } from "./service.js";
-export { initiateCheckoutCollection, previewCheckoutCollection, resolvePaymentSessionTarget, } from "./service.js";
-export type { InitiateCheckoutCollectionInput, PreviewCheckoutCollectionInput, } from "./validation.js";
-export { checkoutCollectionMethodSchema, checkoutCollectionStageSchema, checkoutInvoiceDocumentTypeSchema, checkoutPaymentSessionTargetSchema, initiateCheckoutCollectionSchema, previewCheckoutCollectionSchema, } from "./validation.js";
+export { checkoutModule, createCheckoutAdminRoutes, createCheckoutHonoModule, createCheckoutRoutes, } from "./routes.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 { 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,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,cAAc,CAAA;AACrB,YAAY,EACV,+BAA+B,EAC/B,8BAA8B,GAC/B,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,8BAA8B,EAC9B,6BAA6B,EAC7B,iCAAiC,EACjC,kCAAkC,EAClC,gCAAgC,EAChC,+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 { createCheckoutRoutes } from "./routes.js";
-export { initiateCheckoutCollection, previewCheckoutCollection, resolvePaymentSessionTarget, } from "./service.js";
-export { checkoutCollectionMethodSchema, checkoutCollectionStageSchema, checkoutInvoiceDocumentTypeSchema, checkoutPaymentSessionTargetSchema, initiateCheckoutCollectionSchema, previewCheckoutCollectionSchema, } from "./validation.js";
+export { checkoutModule, createCheckoutAdminRoutes, createCheckoutHonoModule, createCheckoutRoutes, } from "./routes.js";
+export { initiateCheckoutCollection, listBookingReminderRuns, previewCheckoutCollection, resolvePaymentSessionTarget, } from "./service.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

@@ -1,6 +1,8 @@
+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: {
@@ -12,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: {
@@ -280,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;
@@ -313,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;
                 };
             };
@@ -351,5 +381,46 @@ export declare function createCheckoutRoutes(options?: {
         };
     };
 }, "/", "/v1/checkout/bookings/:bookingId/initiate-collection">;
+export declare function createCheckoutAdminRoutes(): import("hono/hono-base").HonoBase<Env, {
+    "/bookings/:bookingId/reminder-runs": {
+        $get: {
+            input: {
+                param: {
+                    bookingId: string;
+                };
+            };
+            output: {
+                data: {
+                    id: string;
+                    reminderRuleId: string;
+                    reminderRuleSlug: string | null;
+                    reminderRuleName: string | null;
+                    targetType: "booking_payment_schedule" | "invoice";
+                    targetId: string;
+                    bookingId: string | null;
+                    paymentSessionId: string | null;
+                    notificationDeliveryId: string | null;
+                    status: "processing" | "sent" | "skipped" | "failed";
+                    deliveryStatus: "pending" | "sent" | "failed" | "cancelled" | null;
+                    channel: "email" | "sms" | null;
+                    provider: string | null;
+                    recipient: string | null;
+                    scheduledFor: string;
+                    processedAt: string;
+                    errorMessage: string | null;
+                    relativeDaysFromDueDate: number | null;
+                    createdAt: string;
+                }[];
+                total: number;
+                limit: number;
+                offset: number;
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+}, "/", "/bookings/:bookingId/reminder-runs">;
+export declare const checkoutModule: Module;
+export declare function createCheckoutHonoModule(options?: Parameters<typeof createCheckoutRoutes>[0]): HonoModule;
 export {};
 //# sourceMappingURL=routes.d.ts.map

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,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAEnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAGjE,OAAO,EACL,KAAK,qBAAqB,EAG3B,MAAM,cAAc,CAAA;AAGrB,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"}
+{"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

@@ -1,7 +1,7 @@
 import { createNotificationService } from "@voyantjs/notifications";
 import { Hono } from "hono";
-import { initiateCheckoutCollection, previewCheckoutCollection, } from "./service.js";
-import { initiateCheckoutCollectionSchema, previewCheckoutCollectionSchema } from "./validation.js";
+import { initiateCheckoutCollection, listBookingReminderRuns, previewCheckoutCollection, } from "./service.js";
+import { checkoutReminderRunListQuerySchema, initiateCheckoutCollectionSchema, previewCheckoutCollectionSchema, } from "./validation.js";
 export function createCheckoutRoutes(options = {}) {
     return new Hono()
         .post("/v1/checkout/bookings/:bookingId/collection-plan", async (c) => {
@@ -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);
             }
@@ -35,3 +39,19 @@ export function createCheckoutRoutes(options = {}) {
         }
     });
 }
+export function createCheckoutAdminRoutes() {
+    return new Hono().get("/bookings/:bookingId/reminder-runs", async (c) => {
+        const query = checkoutReminderRunListQuerySchema.parse(Object.fromEntries(new URL(c.req.url).searchParams));
+        return c.json(await listBookingReminderRuns(c.get("db"), c.req.param("bookingId"), query));
+    });
+}
+export const checkoutModule = {
+    name: "checkout",
+};
+export function createCheckoutHonoModule(options) {
+    return {
+        module: checkoutModule,
+        routes: createCheckoutRoutes(options),
+        adminRoutes: createCheckoutAdminRoutes(),
+    };
+}

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 { 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,14 +29,77 @@ 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" | "invoice";
+    targetId: string;
+    bookingId: string | null;
+    paymentSessionId: string | null;
+    notificationDeliveryId: string | null;
+    status: "processing" | "sent" | "skipped" | "failed";
+    deliveryStatus: "pending" | "sent" | "failed" | "cancelled" | null;
+    channel: "email" | "sms" | null;
+    provider: string | null;
+    recipient: string | null;
+    scheduledFor: string;
+    processedAt: string;
+    errorMessage: string | null;
+    relativeDaysFromDueDate: number | null;
+    createdAt: string;
+}
+export interface CheckoutReminderRunList {
+    data: CheckoutReminderRunSummary[];
+    total: number;
+    limit: number;
+    offset: number;
 }
 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":"AACA,OAAO,EACL,uBAAuB,EAIvB,QAAQ,EACR,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAGxF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,OAAO,KAAK,EACV,+BAA+B,EAC/B,8BAA8B,EAC/B,MAAM,iBAAiB,CAAA;AAExB,MAAM,WAAW,qBAAqB;IACpC,2BAA2B,CAAC,EAAE,UAAU,GAAG,SAAS,CAAA;IACpD,mCAAmC,CAAC,EAAE,UAAU,GAAG,SAAS,CAAA;IAC5D,+BAA+B,CAAC,EAAE,UAAU,GAAG,SAAS,CAAA;IACxD,kBAAkB,CAAC,EAAE;QACnB,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,cAAc,CAAA;QACnD,YAAY,EAAE,MAAM,CAAA;QACpB,yBAAyB,EAAE,MAAM,CAAA;QACjC,oBAAoB,EAAE,OAAO,CAAA;QAC7B,eAAe,EAAE,OAAO,CAAA;QACxB,aAAa,EACT,SAAS,GACT,aAAa,GACb,SAAS,GACT,cAAc,GACd,eAAe,GACf,SAAS,GACT,eAAe,CAAA;QACnB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KACtB,CAAA;CACF;AAUD,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,GAAG,eAAe,CAAA;IAChC,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAA;IACxC,oBAAoB,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI,CAAA;IACnD,YAAY,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI,CAAA;IAC3C,4BAA4B,EAAE,OAAO,CAAA;IACrC,gBAAgB,EAAE,OAAO,uBAAuB,CAAC,YAAY,GAAG,IAAI,CAAA;IACpE,eAAe,EAAE,OAAO,QAAQ,CAAC,YAAY,GAAG,IAAI,CAAA;IACpD,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,iBAAiB,EACb,+BAA+B,GAC/B,wBAAwB,GACxB,qCAAqC,GACrC,MAAM,CAAA;CACX;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,sBAAsB,CAAA;IAC5B,OAAO,EAAE,OAAO,QAAQ,CAAC,YAAY,GAAG,IAAI,CAAA;IAC5C,cAAc,EAAE,cAAc,GAAG,IAAI,CAAA;IACrC,mBAAmB,EAAE,oBAAoB,GAAG,IAAI,CAAA;IAChD,0BAA0B,EAAE,oBAAoB,GAAG,IAAI,CAAA;CACxD;AAwBD,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,GAAG,eAAe,EAChC,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,EACxC,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,EAC5C,OAAO,EAAE,qBAAqB,0BAM/B;AAwJD,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,CAyDxC;AAkED,wBAAsB,0BAA0B,CAC9C,EAAE,EAAE,kBAAkB,EACtB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,+BAA+B,EACtC,OAAO,GAAE,qBAA0B,EACnC,UAAU,CAAC,EAAE,mBAAmB,GAC/B,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC,CAiG7C"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"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"}

package/dist/service.js

@@ -1,7 +1,7 @@
 import { bookingItems, bookingParticipants, bookings } from "@voyantjs/bookings";
 import { bookingPaymentSchedules, financeService, invoiceLineItems, invoiceNumberSeries, invoices, } from "@voyantjs/finance";
-import { notificationsService } from "@voyantjs/notifications";
-import { and, asc, desc, eq, gt, inArray } from "drizzle-orm";
+import { notificationDeliveries, notificationReminderRules, notificationReminderRuns, notificationsService, } from "@voyantjs/notifications";
+import { and, asc, desc, eq, gt, inArray, sql } from "drizzle-orm";
 const OUTSTANDING_SCHEDULE_STATUSES = ["pending", "due"];
 const OUTSTANDING_INVOICE_STATUSES = [
     "draft",
@@ -9,6 +9,9 @@ const OUTSTANDING_INVOICE_STATUSES = [
     "partially_paid",
     "overdue",
 ];
+function normalizeRequiredDateTime(value) {
+    return value instanceof Date ? value.toISOString() : value;
+}
 function defaultPaymentPlan(options) {
     return {
         depositMode: options.defaultPaymentPlan?.depositMode ?? "percentage",
@@ -53,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)
@@ -130,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 ??
@@ -220,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;
@@ -234,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);
         }
@@ -273,11 +323,105 @@ 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) {
+    const where = and(eq(notificationReminderRuns.bookingId, bookingId), ...(query.status ? [eq(notificationReminderRuns.status, query.status)] : []));
+    const [rows, countResult] = await Promise.all([
+        db
+            .select({
+            id: notificationReminderRuns.id,
+            reminderRuleId: notificationReminderRuns.reminderRuleId,
+            targetType: notificationReminderRuns.targetType,
+            targetId: notificationReminderRuns.targetId,
+            bookingId: notificationReminderRuns.bookingId,
+            paymentSessionId: notificationReminderRuns.paymentSessionId,
+            notificationDeliveryId: notificationReminderRuns.notificationDeliveryId,
+            status: notificationReminderRuns.status,
+            recipient: notificationReminderRuns.recipient,
+            scheduledFor: notificationReminderRuns.scheduledFor,
+            processedAt: notificationReminderRuns.processedAt,
+            errorMessage: notificationReminderRuns.errorMessage,
+            createdAt: notificationReminderRuns.createdAt,
+            reminderRuleSlug: notificationReminderRules.slug,
+            reminderRuleName: notificationReminderRules.name,
+            relativeDaysFromDueDate: notificationReminderRules.relativeDaysFromDueDate,
+            channel: notificationReminderRules.channel,
+            ruleProvider: notificationReminderRules.provider,
+            deliveryStatus: notificationDeliveries.status,
+            deliveryProvider: notificationDeliveries.provider,
+        })
+            .from(notificationReminderRuns)
+            .leftJoin(notificationReminderRules, eq(notificationReminderRules.id, notificationReminderRuns.reminderRuleId))
+            .leftJoin(notificationDeliveries, eq(notificationDeliveries.id, notificationReminderRuns.notificationDeliveryId))
+            .where(where)
+            .orderBy(desc(notificationReminderRuns.createdAt))
+            .limit(query.limit)
+            .offset(query.offset),
+        db.select({ count: sql `count(*)::int` }).from(notificationReminderRuns).where(where),
+    ]);
+    return {
+        data: rows.map((row) => ({
+            id: row.id,
+            reminderRuleId: row.reminderRuleId,
+            reminderRuleSlug: row.reminderRuleSlug ?? null,
+            reminderRuleName: row.reminderRuleName ?? null,
+            targetType: row.targetType,
+            targetId: row.targetId,
+            bookingId: row.bookingId ?? null,
+            paymentSessionId: row.paymentSessionId ?? null,
+            notificationDeliveryId: row.notificationDeliveryId ?? null,
+            status: row.status,
+            deliveryStatus: row.deliveryStatus ?? null,
+            channel: row.channel ?? null,
+            provider: row.deliveryProvider ?? row.ruleProvider ?? null,
+            recipient: row.recipient ?? null,
+            scheduledFor: normalizeRequiredDateTime(row.scheduledFor),
+            processedAt: normalizeRequiredDateTime(row.processedAt),
+            errorMessage: row.errorMessage ?? null,
+            relativeDaysFromDueDate: row.relativeDaysFromDueDate ?? null,
+            createdAt: normalizeRequiredDateTime(row.createdAt),
+        })),
+        total: countResult[0]?.count ?? 0,
+        limit: query.limit,
+        offset: query.offset,
     };
 }

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,12 +199,451 @@ 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<{
+    id: z.ZodString;
+    bookingId: z.ZodString;
+    bookingItemId: z.ZodNullable<z.ZodString>;
+    scheduleType: z.ZodString;
+    status: z.ZodString;
+    dueDate: z.ZodString;
+    currency: z.ZodString;
+    amountCents: z.ZodNumber;
+    notes: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const checkoutCollectionInvoiceSchema: z.ZodObject<{
+    id: z.ZodString;
+    invoiceNumber: z.ZodString;
+    invoiceType: z.ZodString;
+    bookingId: z.ZodString;
+    personId: z.ZodNullable<z.ZodString>;
+    organizationId: z.ZodNullable<z.ZodString>;
+    status: z.ZodString;
+    currency: z.ZodString;
+    totalCents: z.ZodNumber;
+    paidCents: z.ZodNumber;
+    balanceDueCents: z.ZodNumber;
+    issueDate: z.ZodString;
+    dueDate: z.ZodString;
+    notes: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const checkoutNotificationDeliverySchema: z.ZodObject<{
+    id: z.ZodString;
+    templateSlug: z.ZodNullable<z.ZodString>;
+    channel: z.ZodEnum<{
+        email: "email";
+        sms: "sms";
+    }>;
+    provider: z.ZodString;
+    status: z.ZodEnum<{
+        cancelled: "cancelled";
+        pending: "pending";
+        failed: "failed";
+        sent: "sent";
+    }>;
+    toAddress: z.ZodString;
+    subject: z.ZodNullable<z.ZodString>;
+    sentAt: z.ZodNullable<z.ZodString>;
+    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<{
+        bank_transfer: "bank_transfer";
+        card: "card";
+    }>;
+    stage: z.ZodEnum<{
+        manual: "manual";
+        initial: "initial";
+        reminder: "reminder";
+    }>;
+    paymentSessionTarget: z.ZodNullable<z.ZodEnum<{
+        invoice: "invoice";
+        schedule: "schedule";
+    }>>;
+    documentType: z.ZodNullable<z.ZodEnum<{
+        invoice: "invoice";
+        proforma: "proforma";
+    }>>;
+    willCreateDefaultPaymentPlan: z.ZodBoolean;
+    selectedSchedule: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        bookingId: z.ZodString;
+        bookingItemId: z.ZodNullable<z.ZodString>;
+        scheduleType: z.ZodString;
+        status: z.ZodString;
+        dueDate: z.ZodString;
+        currency: z.ZodString;
+        amountCents: z.ZodNumber;
+        notes: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    selectedInvoice: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        invoiceNumber: z.ZodString;
+        invoiceType: z.ZodString;
+        bookingId: z.ZodString;
+        personId: z.ZodNullable<z.ZodString>;
+        organizationId: z.ZodNullable<z.ZodString>;
+        status: z.ZodString;
+        currency: z.ZodString;
+        totalCents: z.ZodNumber;
+        paidCents: z.ZodNumber;
+        balanceDueCents: z.ZodNumber;
+        issueDate: z.ZodString;
+        dueDate: z.ZodString;
+        notes: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>;
+    amountCents: z.ZodNumber;
+    currency: z.ZodString;
+    recommendedAction: z.ZodEnum<{
+        none: "none";
+        create_bank_transfer_document: "create_bank_transfer_document";
+        create_payment_session: "create_payment_session";
+        create_invoice_then_payment_session: "create_invoice_then_payment_session";
+    }>;
+}, z.core.$strip>;
+export declare const initiatedCheckoutCollectionSchema: z.ZodObject<{
+    plan: z.ZodObject<{
+        bookingId: z.ZodString;
+        method: z.ZodEnum<{
+            bank_transfer: "bank_transfer";
+            card: "card";
+        }>;
+        stage: z.ZodEnum<{
+            manual: "manual";
+            initial: "initial";
+            reminder: "reminder";
+        }>;
+        paymentSessionTarget: z.ZodNullable<z.ZodEnum<{
+            invoice: "invoice";
+            schedule: "schedule";
+        }>>;
+        documentType: z.ZodNullable<z.ZodEnum<{
+            invoice: "invoice";
+            proforma: "proforma";
+        }>>;
+        willCreateDefaultPaymentPlan: z.ZodBoolean;
+        selectedSchedule: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            bookingId: z.ZodString;
+            bookingItemId: z.ZodNullable<z.ZodString>;
+            scheduleType: z.ZodString;
+            status: z.ZodString;
+            dueDate: z.ZodString;
+            currency: z.ZodString;
+            amountCents: z.ZodNumber;
+            notes: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        selectedInvoice: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            invoiceNumber: z.ZodString;
+            invoiceType: z.ZodString;
+            bookingId: z.ZodString;
+            personId: z.ZodNullable<z.ZodString>;
+            organizationId: z.ZodNullable<z.ZodString>;
+            status: z.ZodString;
+            currency: z.ZodString;
+            totalCents: z.ZodNumber;
+            paidCents: z.ZodNumber;
+            balanceDueCents: z.ZodNumber;
+            issueDate: z.ZodString;
+            dueDate: z.ZodString;
+            notes: z.ZodNullable<z.ZodString>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+        }, z.core.$strip>>;
+        amountCents: z.ZodNumber;
+        currency: z.ZodString;
+        recommendedAction: z.ZodEnum<{
+            none: "none";
+            create_bank_transfer_document: "create_bank_transfer_document";
+            create_payment_session: "create_payment_session";
+            create_invoice_then_payment_session: "create_invoice_then_payment_session";
+        }>;
+    }, z.core.$strip>;
+    invoice: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        invoiceNumber: z.ZodString;
+        invoiceType: z.ZodString;
+        bookingId: z.ZodString;
+        personId: z.ZodNullable<z.ZodString>;
+        organizationId: z.ZodNullable<z.ZodString>;
+        status: z.ZodString;
+        currency: z.ZodString;
+        totalCents: z.ZodNumber;
+        paidCents: z.ZodNumber;
+        balanceDueCents: z.ZodNumber;
+        issueDate: z.ZodString;
+        dueDate: z.ZodString;
+        notes: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>;
+    paymentSession: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        targetType: z.ZodEnum<{
+            other: "other";
+            booking: "booking";
+            order: "order";
+            invoice: "invoice";
+            booking_payment_schedule: "booking_payment_schedule";
+            booking_guarantee: "booking_guarantee";
+        }>;
+        targetId: z.ZodNullable<z.ZodString>;
+        bookingId: z.ZodNullable<z.ZodString>;
+        invoiceId: z.ZodNullable<z.ZodString>;
+        bookingPaymentScheduleId: z.ZodNullable<z.ZodString>;
+        bookingGuaranteeId: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<{
+            expired: "expired";
+            cancelled: "cancelled";
+            pending: "pending";
+            failed: "failed";
+            paid: "paid";
+            requires_redirect: "requires_redirect";
+            processing: "processing";
+            authorized: "authorized";
+        }>;
+        provider: z.ZodNullable<z.ZodString>;
+        providerSessionId: z.ZodNullable<z.ZodString>;
+        providerPaymentId: z.ZodNullable<z.ZodString>;
+        externalReference: z.ZodNullable<z.ZodString>;
+        clientReference: z.ZodNullable<z.ZodString>;
+        currency: z.ZodString;
+        amountCents: z.ZodNumber;
+        paymentMethod: z.ZodNullable<z.ZodEnum<{
+            other: "other";
+            voucher: "voucher";
+            wallet: "wallet";
+            bank_transfer: "bank_transfer";
+            credit_card: "credit_card";
+            debit_card: "debit_card";
+            cash: "cash";
+            cheque: "cheque";
+            direct_bill: "direct_bill";
+        }>>;
+        payerEmail: z.ZodNullable<z.ZodString>;
+        payerName: z.ZodNullable<z.ZodString>;
+        redirectUrl: z.ZodNullable<z.ZodString>;
+        returnUrl: z.ZodNullable<z.ZodString>;
+        cancelUrl: z.ZodNullable<z.ZodString>;
+        expiresAt: z.ZodNullable<z.ZodString>;
+        completedAt: z.ZodNullable<z.ZodString>;
+        failureCode: z.ZodNullable<z.ZodString>;
+        failureMessage: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    invoiceNotification: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        templateSlug: z.ZodNullable<z.ZodString>;
+        channel: z.ZodEnum<{
+            email: "email";
+            sms: "sms";
+        }>;
+        provider: z.ZodString;
+        status: z.ZodEnum<{
+            cancelled: "cancelled";
+            pending: "pending";
+            failed: "failed";
+            sent: "sent";
+        }>;
+        toAddress: z.ZodString;
+        subject: z.ZodNullable<z.ZodString>;
+        sentAt: z.ZodNullable<z.ZodString>;
+        failedAt: z.ZodNullable<z.ZodString>;
+        errorMessage: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    paymentSessionNotification: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        templateSlug: z.ZodNullable<z.ZodString>;
+        channel: z.ZodEnum<{
+            email: "email";
+            sms: "sms";
+        }>;
+        provider: z.ZodString;
+        status: z.ZodEnum<{
+            cancelled: "cancelled";
+            pending: "pending";
+            failed: "failed";
+            sent: "sent";
+        }>;
+        toAddress: z.ZodString;
+        subject: z.ZodNullable<z.ZodString>;
+        sentAt: z.ZodNullable<z.ZodString>;
+        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>>;
+    offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        failed: "failed";
+        sent: "sent";
+        processing: "processing";
+        skipped: "skipped";
+    }>>;
+}, z.core.$strip>;
+export declare const checkoutReminderRunSchema: z.ZodObject<{
+    id: z.ZodString;
+    reminderRuleId: z.ZodString;
+    reminderRuleSlug: z.ZodNullable<z.ZodString>;
+    reminderRuleName: z.ZodNullable<z.ZodString>;
+    targetType: z.ZodEnum<{
+        invoice: "invoice";
+        booking_payment_schedule: "booking_payment_schedule";
+    }>;
+    targetId: z.ZodString;
+    bookingId: z.ZodNullable<z.ZodString>;
+    paymentSessionId: z.ZodNullable<z.ZodString>;
+    notificationDeliveryId: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+        failed: "failed";
+        sent: "sent";
+        processing: "processing";
+        skipped: "skipped";
+    }>;
+    deliveryStatus: z.ZodNullable<z.ZodEnum<{
+        cancelled: "cancelled";
+        pending: "pending";
+        failed: "failed";
+        sent: "sent";
+    }>>;
+    channel: z.ZodNullable<z.ZodEnum<{
+        email: "email";
+        sms: "sms";
+    }>>;
+    provider: z.ZodNullable<z.ZodString>;
+    recipient: z.ZodNullable<z.ZodString>;
+    scheduledFor: z.ZodString;
+    processedAt: z.ZodString;
+    errorMessage: z.ZodNullable<z.ZodString>;
+    relativeDaysFromDueDate: z.ZodNullable<z.ZodNumber>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export declare const checkoutReminderRunListResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        reminderRuleId: z.ZodString;
+        reminderRuleSlug: z.ZodNullable<z.ZodString>;
+        reminderRuleName: z.ZodNullable<z.ZodString>;
+        targetType: z.ZodEnum<{
+            invoice: "invoice";
+            booking_payment_schedule: "booking_payment_schedule";
+        }>;
+        targetId: z.ZodString;
+        bookingId: z.ZodNullable<z.ZodString>;
+        paymentSessionId: z.ZodNullable<z.ZodString>;
+        notificationDeliveryId: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<{
+            failed: "failed";
+            sent: "sent";
+            processing: "processing";
+            skipped: "skipped";
+        }>;
+        deliveryStatus: z.ZodNullable<z.ZodEnum<{
+            cancelled: "cancelled";
+            pending: "pending";
+            failed: "failed";
+            sent: "sent";
+        }>>;
+        channel: z.ZodNullable<z.ZodEnum<{
+            email: "email";
+            sms: "sms";
+        }>>;
+        provider: z.ZodNullable<z.ZodString>;
+        recipient: z.ZodNullable<z.ZodString>;
+        scheduledFor: z.ZodString;
+        processedAt: z.ZodString;
+        errorMessage: z.ZodNullable<z.ZodString>;
+        relativeDaysFromDueDate: z.ZodNullable<z.ZodNumber>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+    limit: z.ZodNumber;
+    offset: z.ZodNumber;
+}, z.core.$strip>;
 export type PreviewCheckoutCollectionInput = z.infer<typeof previewCheckoutCollectionSchema>;
 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":"AASA,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;AAIhF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQ1C,CAAA;AAEF,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAO3C,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"}
+{"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,16 +1,25 @@
-import { applyDefaultBookingPaymentPlanSchema, createPaymentSessionFromInvoiceSchema, createPaymentSessionFromScheduleSchema, } from "@voyantjs/finance";
-import { sendInvoiceNotificationSchema, sendPaymentSessionNotificationSchema, } from "@voyantjs/notifications";
+import { applyDefaultBookingPaymentPlanSchema, createPaymentSessionFromInvoiceSchema, createPaymentSessionFromScheduleSchema, publicPaymentSessionSchema, } from "@voyantjs/finance";
+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),
+    offset: z.coerce.number().int().min(0).default(0),
+});
 export const previewCheckoutCollectionSchema = z.object({
     method: checkoutCollectionMethodSchema,
     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(),
@@ -21,5 +30,126 @@ export const initiateCheckoutCollectionSchema = previewCheckoutCollectionSchema.
         .optional(),
     paymentSessionNotification: sendPaymentSessionNotificationSchema.optional(),
     invoiceNotification: sendInvoiceNotificationSchema.optional(),
+    startProvider: checkoutProviderStartInputSchema.optional(),
     notes: z.string().optional().nullable(),
 });
+export const checkoutCollectionScheduleSchema = z.object({
+    id: z.string(),
+    bookingId: z.string(),
+    bookingItemId: z.string().nullable(),
+    scheduleType: z.string(),
+    status: z.string(),
+    dueDate: z.string(),
+    currency: z.string(),
+    amountCents: z.number().int(),
+    notes: z.string().nullable(),
+});
+export const checkoutCollectionInvoiceSchema = z.object({
+    id: z.string(),
+    invoiceNumber: z.string(),
+    invoiceType: z.string(),
+    bookingId: z.string(),
+    personId: z.string().nullable(),
+    organizationId: z.string().nullable(),
+    status: z.string(),
+    currency: z.string(),
+    totalCents: z.number().int(),
+    paidCents: z.number().int(),
+    balanceDueCents: z.number().int(),
+    issueDate: z.string(),
+    dueDate: z.string(),
+    notes: z.string().nullable(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+});
+export const checkoutNotificationDeliverySchema = z.object({
+    id: z.string(),
+    templateSlug: z.string().nullable(),
+    channel: notificationChannelSchema,
+    provider: z.string(),
+    status: notificationDeliveryStatusSchema,
+    toAddress: z.string(),
+    subject: z.string().nullable(),
+    sentAt: z.string().nullable(),
+    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,
+    stage: checkoutCollectionStageSchema,
+    paymentSessionTarget: checkoutPaymentSessionTargetSchema.nullable(),
+    documentType: checkoutInvoiceDocumentTypeSchema.nullable(),
+    willCreateDefaultPaymentPlan: z.boolean(),
+    selectedSchedule: checkoutCollectionScheduleSchema.nullable(),
+    selectedInvoice: checkoutCollectionInvoiceSchema.nullable(),
+    amountCents: z.number().int(),
+    currency: z.string(),
+    recommendedAction: z.enum([
+        "create_bank_transfer_document",
+        "create_payment_session",
+        "create_invoice_then_payment_session",
+        "none",
+    ]),
+});
+export const initiatedCheckoutCollectionSchema = z.object({
+    plan: checkoutCollectionPlanSchema,
+    invoice: checkoutCollectionInvoiceSchema.nullable(),
+    paymentSession: publicPaymentSessionSchema.nullable(),
+    invoiceNotification: checkoutNotificationDeliverySchema.nullable(),
+    paymentSessionNotification: checkoutNotificationDeliverySchema.nullable(),
+    bankTransferInstructions: checkoutBankTransferInstructionsSchema.nullable(),
+    providerStart: checkoutProviderStartResultSchema.nullable(),
+});
+export const checkoutReminderRunListQuerySchema = paginationSchema.extend({
+    status: notificationReminderRunStatusSchema.optional(),
+});
+export const checkoutReminderRunSchema = z.object({
+    id: z.string(),
+    reminderRuleId: z.string(),
+    reminderRuleSlug: z.string().nullable(),
+    reminderRuleName: z.string().nullable(),
+    targetType: notificationReminderTargetTypeSchema,
+    targetId: z.string(),
+    bookingId: z.string().nullable(),
+    paymentSessionId: z.string().nullable(),
+    notificationDeliveryId: z.string().nullable(),
+    status: notificationReminderRunStatusSchema,
+    deliveryStatus: notificationDeliveryStatusSchema.nullable(),
+    channel: notificationChannelSchema.nullable(),
+    provider: z.string().nullable(),
+    recipient: z.string().nullable(),
+    scheduledFor: z.string(),
+    processedAt: z.string(),
+    errorMessage: z.string().nullable(),
+    relativeDaysFromDueDate: z.number().int().nullable(),
+    createdAt: z.string(),
+});
+export const checkoutReminderRunListResponseSchema = z.object({
+    data: z.array(checkoutReminderRunSchema),
+    total: z.number().int(),
+    limit: z.number().int(),
+    offset: z.number().int(),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/checkout",
-  "version": "0.3.0",
+  "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.0",
-    "@voyantjs/core": "0.3.0",
-    "@voyantjs/finance": "0.3.0",
-    "@voyantjs/hono": "0.3.0",
-    "@voyantjs/notifications": "0.3.0"
+    "@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",