@voyantjs/notifications 0.6.9 → 0.8.0

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import type { HonoModule } from "@voyantjs/hono/module";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
 import { type NotificationsRoutesOptions } from "./routes.js";
 export { notificationLiquidEngine, renderLiquidTemplate, } from "./liquid.js";
 export type { DefaultNotificationProviderOptions } from "./provider-resolution.js";
@@ -24,5 +25,25 @@ export type { NotificationLiquidSnippet, NotificationTemplateVariableCategory, N
 export { notificationLiquidSnippets, notificationTemplateVariableCatalog, } from "./template-authoring.js";
 export type { NotificationAttachment, NotificationChannel, NotificationPayload, NotificationProvider, NotificationResult, } from "./types.js";
 export { bookingDocumentBundleItemSchema, bookingDocumentBundleSchema, insertNotificationReminderRuleSchema, insertNotificationTemplateSchema, notificationAttachmentSchema, notificationChannelSchema, notificationDeliveryListQuerySchema, notificationDeliveryStatusSchema, notificationDocumentSourceSchema, notificationDocumentTypeSchema, notificationReminderRuleListQuerySchema, notificationReminderRunDeliverySummarySchema, notificationReminderRunLinksSchema, notificationReminderRunListQuerySchema, notificationReminderRunListResponseSchema, notificationReminderRunRecordSchema, notificationReminderRunRuleSummarySchema, notificationReminderRunStatusSchema, notificationReminderStatusSchema, notificationReminderTargetTypeSchema, notificationTargetTypeSchema, notificationTemplateListQuerySchema, notificationTemplateStatusSchema, previewNotificationTemplateResultSchema, previewNotificationTemplateSchema, runDueRemindersSchema, sendBookingDocumentsNotificationResultSchema, sendBookingDocumentsNotificationSchema, sendInvoiceNotificationSchema, sendNotificationSchema, sendPaymentSessionNotificationSchema, updateNotificationReminderRuleSchema, updateNotificationTemplateSchema, } from "./validation.js";
-export declare function createNotificationsHonoModule(options?: NotificationsRoutesOptions): HonoModule;
+/**
+ * Auto-dispatch policy for the `booking.confirmed` subscriber. Set `enabled:
+ * false` (or leave the option off entirely) to opt out.
+ */
+export interface NotificationsAutoConfirmAndDispatchOptions {
+    enabled?: boolean;
+    /** Notification template slug used when the handler fires. */
+    templateSlug?: string;
+    /** Optional allowlist of document types to attach; defaults to all. */
+    documentTypes?: Array<"contract" | "invoice" | "proforma">;
+}
+export interface CreateNotificationsHonoModuleOptions extends NotificationsRoutesOptions {
+    /**
+     * Resolves a database from runtime bindings. Required for
+     * `autoConfirmAndDispatch` — the `booking.confirmed` subscriber fires
+     * outside a request scope and needs its own db handle.
+     */
+    resolveDb?: (bindings: Record<string, unknown>) => PostgresJsDatabase;
+    autoConfirmAndDispatch?: NotificationsAutoConfirmAndDispatchOptions;
+}
+export declare function createNotificationsHonoModule(options?: CreateNotificationsHonoModuleOptions): HonoModule;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,5 +1,7 @@
 import { buildNotificationsRouteRuntime, createNotificationsRoutes, NOTIFICATIONS_ROUTE_RUNTIME_CONTAINER_KEY, } from "./routes.js";
 import { notificationsModule } from "./schema.js";
+import { createNotificationService } from "./service.js";
+import { bookingDocumentNotificationsService } from "./service-booking-documents.js";
 export { notificationLiquidEngine, renderLiquidTemplate, } from "./liquid.js";
 export { createDefaultNotificationProviders, createResendProviderFromEnv, createTwilioProviderFromEnv, } from "./provider-resolution.js";
 export { createLocalProvider } from "./providers/local.js";
@@ -17,8 +19,38 @@ export function createNotificationsHonoModule(options) {
     const routes = createNotificationsRoutes(options);
     const module = {
         ...notificationsModule,
-        bootstrap: ({ bindings, container }) => {
+        bootstrap: ({ bindings, container, eventBus }) => {
             container.register(NOTIFICATIONS_ROUTE_RUNTIME_CONTAINER_KEY, buildNotificationsRouteRuntime(bindings, options));
+            // Auto-dispatch wiring — opt-in. When enabled, every `booking.confirmed`
+            // event triggers a `confirmAndDispatchBooking` call so the operator
+            // doesn't have to click a second button. The handler runs in the same
+            // process as the emitter (the in-process event bus) but outside the
+            // request scope, so we resolve our own db handle from bindings.
+            if (options?.autoConfirmAndDispatch?.enabled && options.resolveDb) {
+                const resolveDb = options.resolveDb;
+                const autoOptions = options.autoConfirmAndDispatch;
+                const runtime = buildNotificationsRouteRuntime(bindings, options);
+                const dispatcher = createNotificationService(runtime.providers);
+                eventBus.subscribe("booking.confirmed", async (event) => {
+                    try {
+                        const db = resolveDb(bindings);
+                        await bookingDocumentNotificationsService.confirmAndDispatchBooking(db, dispatcher, event.data.bookingId, {
+                            templateSlug: autoOptions.templateSlug ?? null,
+                            documentTypes: autoOptions.documentTypes ?? null,
+                        }, {
+                            attachmentResolver: runtime.documentAttachmentResolver,
+                            eventBus,
+                        });
+                    }
+                    catch (error) {
+                        // Per the EventBus contract, handler failures are logged, not
+                        // rethrown. We surface the context so ops can diagnose without
+                        // digging through stack traces.
+                        const message = error instanceof Error ? error.message : String(error);
+                        console.error(`[notifications] auto-dispatch failed for booking ${event.data.bookingId}: ${message}`);
+                    }
+                });
+            }
         },
     };
     return {

package/dist/routes.d.ts

@@ -448,7 +448,7 @@ export declare function createNotificationsRoutes(options?: NotificationsRoutesO
                     targetType: "invoice" | "booking_payment_schedule";
                     targetId: string;
                     dedupeKey: string;
-                    status: "failed" | "sent" | "processing" | "queued" | "skipped";
+                    status: "failed" | "sent" | "processing" | "skipped" | "queued";
                     recipient: string | null;
                     scheduledFor: string;
                     processedAt: string;
@@ -525,7 +525,7 @@ export declare function createNotificationsRoutes(options?: NotificationsRoutesO
                     targetType: "invoice" | "booking_payment_schedule";
                     targetId: string;
                     dedupeKey: string;
-                    status: "failed" | "sent" | "processing" | "queued" | "skipped";
+                    status: "failed" | "sent" | "processing" | "skipped" | "queued";
                     recipient: string | null;
                     scheduledFor: string;
                     processedAt: string;
@@ -784,6 +784,74 @@ export declare function createNotificationsRoutes(options?: NotificationsRoutesO
             status: import("hono/utils/http-status").ContentfulStatusCode;
         };
     };
+} & {
+    "/bookings/:id/confirm-and-dispatch": {
+        $post: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                data: {
+                    bookingId: string;
+                    documents: {
+                        key: string;
+                        source: "finance" | "legal";
+                        documentType: "invoice" | "proforma" | "contract";
+                        bookingId: string;
+                        name: string;
+                        createdAt: string;
+                        contractId?: string | null | undefined;
+                        invoiceId?: string | null | undefined;
+                        attachmentId?: string | null | undefined;
+                        renditionId?: string | null | undefined;
+                        contractStatus?: string | null | undefined;
+                        invoiceStatus?: string | null | undefined;
+                        format?: string | null | undefined;
+                        mimeType?: string | null | undefined;
+                        storageKey?: string | null | undefined;
+                        downloadUrl?: string | null | undefined;
+                        language?: string | null | undefined;
+                        metadata?: {
+                            [x: string]: import("hono/utils/types").JSONValue;
+                        } | null | undefined;
+                    }[];
+                    notification: {
+                        recipient: string;
+                        deliveryId: string;
+                        status: "pending" | "cancelled" | "failed" | "sent";
+                        provider?: string | null | undefined;
+                    } | null;
+                    skipReason: "preview_only" | "no_documents" | "no_recipient" | "no_attachments" | "send_failed" | null;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 400;
+        };
+    };
 } & {
     "/bookings/:id/send-documents": {
         $post: {

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,QAAQ,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAE/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAIjE,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAA;AACvF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAqBtD,KAAK,GAAG,GAAG;IACT,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,SAAS,EAAE;QACT,SAAS,EAAE,eAAe,CAAA;QAC1B,EAAE,EAAE,kBAAkB,CAAA;QACtB,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;CACF,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,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,0BAA0B,CAAC,EAAE,iCAAiC,CAAA;IAC9D,iCAAiC,CAAC,EAAE,CAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,iCAAiC,GAAG,SAAS,CAAA;IAClD,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,QAAQ,GAAG,SAAS,CAAA;CAC9E,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAA;IAC9C,0BAA0B,CAAC,EAAE,iCAAiC,CAAA;IAC9D,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB,CAAA;AAED,eAAO,MAAM,yCAAyC,oCAAoC,CAAA;AAE1F,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,CAAC,EAAE,0BAA0B,GACnC,yBAAyB,CAO3B;AAcD,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgM7E"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAE/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAIjE,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAA;AACvF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAuBtD,KAAK,GAAG,GAAG;IACT,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,SAAS,EAAE;QACT,SAAS,EAAE,eAAe,CAAA;QAC1B,EAAE,EAAE,kBAAkB,CAAA;QACtB,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;CACF,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,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,0BAA0B,CAAC,EAAE,iCAAiC,CAAA;IAC9D,iCAAiC,CAAC,EAAE,CAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,iCAAiC,GAAG,SAAS,CAAA;IAClD,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,QAAQ,GAAG,SAAS,CAAA;CAC9E,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAA;IAC9C,0BAA0B,CAAC,EAAE,iCAAiC,CAAA;IAC9D,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB,CAAA;AAED,eAAO,MAAM,yCAAyC,oCAAoC,CAAA;AAE1F,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,CAAC,EAAE,0BAA0B,GACnC,yBAAyB,CAO3B;AAcD,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwP7E"}

package/dist/routes.js

@@ -1,7 +1,7 @@
 import { parseJsonBody, parseOptionalJsonBody, parseQuery } from "@voyantjs/hono";
 import { Hono } from "hono";
 import { createNotificationService, notificationsService } from "./service.js";
-import { bookingDocumentBundleSchema, insertNotificationReminderRuleSchema, insertNotificationTemplateSchema, notificationDeliveryListQuerySchema, notificationReminderRuleListQuerySchema, notificationReminderRunListQuerySchema, notificationTemplateListQuerySchema, previewNotificationTemplateResultSchema, previewNotificationTemplateSchema, runDueRemindersSchema, sendBookingDocumentsNotificationResultSchema, sendBookingDocumentsNotificationSchema, sendInvoiceNotificationSchema, sendNotificationSchema, sendPaymentSessionNotificationSchema, updateNotificationReminderRuleSchema, updateNotificationTemplateSchema, } from "./validation.js";
+import { bookingDocumentBundleSchema, confirmAndDispatchBookingResultSchema, confirmAndDispatchBookingSchema, insertNotificationReminderRuleSchema, insertNotificationTemplateSchema, notificationDeliveryListQuerySchema, notificationReminderRuleListQuerySchema, notificationReminderRunListQuerySchema, notificationTemplateListQuerySchema, previewNotificationTemplateResultSchema, previewNotificationTemplateSchema, runDueRemindersSchema, sendBookingDocumentsNotificationResultSchema, sendBookingDocumentsNotificationSchema, sendInvoiceNotificationSchema, sendNotificationSchema, sendPaymentSessionNotificationSchema, updateNotificationReminderRuleSchema, updateNotificationTemplateSchema, } from "./validation.js";
 export const NOTIFICATIONS_ROUTE_RUNTIME_CONTAINER_KEY = "providers.notifications.runtime";
 export function buildNotificationsRouteRuntime(bindings, options) {
     return {
@@ -129,6 +129,55 @@ export function createNotificationsRoutes(options) {
         if (!bundle)
             return c.json({ error: "Booking not found" }, 404);
         return c.json({ data: bookingDocumentBundleSchema.parse(bundle) });
+    })
+        .post("/bookings/:id/confirm-and-dispatch", async (c) => {
+        try {
+            const runtime = getRuntime(c.env, options, (key) => c.var.container.resolve(key));
+            const dispatcher = createNotificationService(runtime.providers);
+            const result = await notificationsService.confirmAndDispatchBooking(c.get("db"), dispatcher, c.req.param("id"), await parseOptionalJsonBody(c, confirmAndDispatchBookingSchema), {
+                attachmentResolver: runtime.documentAttachmentResolver,
+                eventBus: runtime.eventBus,
+            });
+            if (result.status === "not_found")
+                return c.json({ error: "Booking not found" }, 404);
+            if (result.status === "preview") {
+                return c.json({
+                    data: confirmAndDispatchBookingResultSchema.parse({
+                        bookingId: result.bookingId,
+                        documents: result.documents,
+                        notification: null,
+                        skipReason: "preview_only",
+                    }),
+                });
+            }
+            if (result.status === "skipped") {
+                return c.json({
+                    data: confirmAndDispatchBookingResultSchema.parse({
+                        bookingId: result.bookingId,
+                        documents: result.documents,
+                        notification: null,
+                        skipReason: result.skipReason,
+                    }),
+                });
+            }
+            return c.json({
+                data: confirmAndDispatchBookingResultSchema.parse({
+                    bookingId: result.bookingId,
+                    documents: result.documents,
+                    notification: {
+                        recipient: result.recipient,
+                        deliveryId: result.delivery.id,
+                        provider: result.delivery.provider,
+                        status: result.delivery.status,
+                    },
+                    skipReason: null,
+                }),
+            }, 201);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Confirm-and-dispatch failed";
+            return c.json({ error: message }, 400);
+        }
     })
         .post("/bookings/:id/send-documents", async (c) => {
         try {

package/dist/schema.d.ts

@@ -1156,7 +1156,7 @@ export declare const notificationReminderRuns: import("drizzle-orm/pg-core").PgT
             tableName: "notification_reminder_runs";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "failed" | "sent" | "processing" | "queued" | "skipped";
+            data: "failed" | "sent" | "processing" | "skipped" | "queued";
             driverParam: string;
             notNull: true;
             hasDefault: false;

package/dist/service-booking-documents.d.ts

@@ -123,6 +123,134 @@ export declare const bookingDocumentNotificationsService: {
             updatedAt: Date;
         };
     }>;
+    /**
+     * Confirm-and-dispatch — single orchestrated call for the operator flow
+     * that wants "list the booking's documents, then send them to the client"
+     * to be one action instead of two round-trips.
+     *
+     * With `sendNotification: false`, the caller gets the bundle back without
+     * attempting a send — useful for rendering a preview/checkbox list before
+     * the operator confirms. With `sendNotification: true`, the same send
+     * guards as `sendBookingDocumentsNotification` apply (no_documents,
+     * no_recipient, no_attachments, send_failed); the result keeps the bundle
+     * regardless so the UI always has something to show.
+     */
+    confirmAndDispatchBooking(db: PostgresJsDatabase, dispatcher: NotificationService, bookingId: string, input: {
+        sendNotification?: boolean;
+    } & SendBookingDocumentsNotificationInput, runtime?: SendBookingDocumentsRuntimeOptions): Promise<{
+        status: "not_found";
+        bookingId?: undefined;
+        documents?: undefined;
+        skipReason?: undefined;
+        recipient?: undefined;
+        delivery?: undefined;
+    } | {
+        status: "preview";
+        bookingId: string;
+        documents: {
+            key: string;
+            source: "finance" | "legal";
+            documentType: "invoice" | "proforma" | "contract";
+            bookingId: string;
+            name: string;
+            createdAt: string;
+            contractId?: string | null | undefined;
+            invoiceId?: string | null | undefined;
+            attachmentId?: string | null | undefined;
+            renditionId?: string | null | undefined;
+            contractStatus?: string | null | undefined;
+            invoiceStatus?: string | null | undefined;
+            format?: string | null | undefined;
+            mimeType?: string | null | undefined;
+            storageKey?: string | null | undefined;
+            downloadUrl?: string | null | undefined;
+            language?: string | null | undefined;
+            metadata?: Record<string, unknown> | null | undefined;
+        }[];
+        skipReason?: undefined;
+        recipient?: undefined;
+        delivery?: undefined;
+    } | {
+        status: "skipped";
+        bookingId: string;
+        documents: {
+            key: string;
+            source: "finance" | "legal";
+            documentType: "invoice" | "proforma" | "contract";
+            bookingId: string;
+            name: string;
+            createdAt: string;
+            contractId?: string | null | undefined;
+            invoiceId?: string | null | undefined;
+            attachmentId?: string | null | undefined;
+            renditionId?: string | null | undefined;
+            contractStatus?: string | null | undefined;
+            invoiceStatus?: string | null | undefined;
+            format?: string | null | undefined;
+            mimeType?: string | null | undefined;
+            storageKey?: string | null | undefined;
+            downloadUrl?: string | null | undefined;
+            language?: string | null | undefined;
+            metadata?: Record<string, unknown> | null | undefined;
+        }[];
+        skipReason: "no_documents" | "no_recipient" | "no_attachments" | "send_failed";
+        recipient?: undefined;
+        delivery?: undefined;
+    } | {
+        status: "dispatched";
+        bookingId: string;
+        documents: {
+            key: string;
+            source: "finance" | "legal";
+            documentType: "invoice" | "proforma" | "contract";
+            bookingId: string;
+            name: string;
+            createdAt: string;
+            contractId?: string | null | undefined;
+            invoiceId?: string | null | undefined;
+            attachmentId?: string | null | undefined;
+            renditionId?: string | null | undefined;
+            contractStatus?: string | null | undefined;
+            invoiceStatus?: string | null | undefined;
+            format?: string | null | undefined;
+            mimeType?: string | null | undefined;
+            storageKey?: string | null | undefined;
+            downloadUrl?: string | null | undefined;
+            language?: string | null | undefined;
+            metadata?: Record<string, unknown> | null | undefined;
+        }[];
+        recipient: string;
+        delivery: {
+            id: string;
+            templateId: string | null;
+            templateSlug: string | null;
+            targetType: "organization" | "other" | "booking" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "person" | "payment_session";
+            targetId: string | null;
+            personId: string | null;
+            organizationId: string | null;
+            bookingId: string | null;
+            invoiceId: string | null;
+            paymentSessionId: string | null;
+            channel: "email" | "sms";
+            provider: string;
+            providerMessageId: string | null;
+            status: "pending" | "cancelled" | "failed" | "sent";
+            toAddress: string;
+            fromAddress: string | null;
+            subject: string | null;
+            htmlBody: string | null;
+            textBody: string | null;
+            payloadData: Record<string, unknown> | null;
+            metadata: Record<string, unknown> | null;
+            errorMessage: string | null;
+            scheduledFor: Date | null;
+            sentAt: Date | null;
+            failedAt: Date | null;
+            createdAt: Date;
+            updatedAt: Date;
+        };
+        skipReason?: undefined;
+    }>;
 };
 export { createDefaultAttachmentFromDocument as createDefaultBookingDocumentAttachment };
 //# sourceMappingURL=service-booking-documents.d.ts.map

package/dist/service-booking-documents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-booking-documents.d.ts","sourceRoot":"","sources":["../src/service-booking-documents.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAI9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAGjE,OAAO,KAAK,EACV,yBAAyB,EACzB,mBAAmB,EACnB,qCAAqC,EACtC,MAAM,qBAAqB,CAAA;AAM5B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAExD,MAAM,MAAM,iCAAiC,GAAG,CAC9C,QAAQ,EAAE,yBAAyB,KAChC,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAA;AAE3C,MAAM,WAAW,kCAAkC;IACjD,kBAAkB,CAAC,EAAE,iCAAiC,CAAA;IACtD,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AA2BD,iBAAS,mCAAmC,CAC1C,QAAQ,EAAE,yBAAyB,GAClC,sBAAsB,GAAG,IAAI,CAU/B;AAwLD,eAAO,MAAM,mCAAmC;kCACV,kBAAkB,aAAa,MAAM;;;;;;;;;;;;;;;;;;;;;;;yCAkBnE,kBAAkB,cACV,mBAAmB,aACpB,MAAM,SACV,qCAAqC,YACnC,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmH9C,CAAA;AAED,OAAO,EAAE,mCAAmC,IAAI,sCAAsC,EAAE,CAAA"}
+{"version":3,"file":"service-booking-documents.d.ts","sourceRoot":"","sources":["../src/service-booking-documents.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAI9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAGjE,OAAO,KAAK,EACV,yBAAyB,EACzB,mBAAmB,EACnB,qCAAqC,EACtC,MAAM,qBAAqB,CAAA;AAM5B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAExD,MAAM,MAAM,iCAAiC,GAAG,CAC9C,QAAQ,EAAE,yBAAyB,KAChC,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAA;AAE3C,MAAM,WAAW,kCAAkC;IACjD,kBAAkB,CAAC,EAAE,iCAAiC,CAAA;IACtD,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AA2BD,iBAAS,mCAAmC,CAC1C,QAAQ,EAAE,yBAAyB,GAClC,sBAAsB,GAAG,IAAI,CAU/B;AAwLD,eAAO,MAAM,mCAAmC;kCACV,kBAAkB,aAAa,MAAM;;;;;;;;;;;;;;;;;;;;;;;yCAkBnE,kBAAkB,cACV,mBAAmB,aACpB,MAAM,SACV,qCAAqC,YACnC,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAoH7C;;;;;;;;;;;OAWG;kCAEG,kBAAkB,cACV,mBAAmB,aACpB,MAAM,SACV;QAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,qCAAqC,YACpE,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4C9C,CAAA;AAED,OAAO,EAAE,mCAAmC,IAAI,sCAAsC,EAAE,CAAA"}

package/dist/service-booking-documents.js

@@ -274,5 +274,50 @@ export const bookingDocumentNotificationsService = {
             delivery,
         };
     },
+    /**
+     * Confirm-and-dispatch — single orchestrated call for the operator flow
+     * that wants "list the booking's documents, then send them to the client"
+     * to be one action instead of two round-trips.
+     *
+     * With `sendNotification: false`, the caller gets the bundle back without
+     * attempting a send — useful for rendering a preview/checkbox list before
+     * the operator confirms. With `sendNotification: true`, the same send
+     * guards as `sendBookingDocumentsNotification` apply (no_documents,
+     * no_recipient, no_attachments, send_failed); the result keeps the bundle
+     * regardless so the UI always has something to show.
+     */
+    async confirmAndDispatchBooking(db, dispatcher, bookingId, input, runtime = {}) {
+        const bundle = await this.listBookingDocumentBundle(db, bookingId);
+        if (!bundle)
+            return { status: "not_found" };
+        const documents = bundle.documents;
+        const sendNotification = input.sendNotification ?? true;
+        if (!sendNotification) {
+            return {
+                status: "preview",
+                bookingId,
+                documents,
+            };
+        }
+        const result = await this.sendBookingDocumentsNotification(db, dispatcher, bookingId, input, runtime);
+        if (result.status === "not_found") {
+            return { status: "not_found" };
+        }
+        if (result.status !== "sent") {
+            return {
+                status: "skipped",
+                bookingId,
+                documents,
+                skipReason: result.status,
+            };
+        }
+        return {
+            status: "dispatched",
+            bookingId: result.bookingId,
+            documents: result.documents,
+            recipient: result.recipient,
+            delivery: result.delivery,
+        };
+    },
 };
 export { createDefaultAttachmentFromDocument as createDefaultBookingDocumentAttachment };

package/dist/service-reminders.d.ts

@@ -17,7 +17,7 @@ export declare function deliverReminderRun(db: PostgresJsDatabase, dispatcher: N
     organizationId: string | null;
     paymentSessionId: string | null;
     notificationDeliveryId: string | null;
-    status: "failed" | "sent" | "processing" | "queued" | "skipped";
+    status: "failed" | "sent" | "processing" | "skipped" | "queued";
     recipient: string | null;
     scheduledFor: Date;
     processedAt: Date;

package/dist/service-templates.d.ts

@@ -161,7 +161,7 @@ export declare function listReminderRuns(db: PostgresJsDatabase, query: Notifica
         targetType: "invoice" | "booking_payment_schedule";
         targetId: string;
         dedupeKey: string;
-        status: "failed" | "sent" | "processing" | "queued" | "skipped";
+        status: "failed" | "sent" | "processing" | "skipped" | "queued";
         recipient: string | null;
         scheduledFor: string;
         processedAt: string;
@@ -212,7 +212,7 @@ export declare function getReminderRunById(db: PostgresJsDatabase, id: string):
     targetType: "invoice" | "booking_payment_schedule";
     targetId: string;
     dedupeKey: string;
-    status: "failed" | "sent" | "processing" | "queued" | "skipped";
+    status: "failed" | "sent" | "processing" | "skipped" | "queued";
     recipient: string | null;
     scheduledFor: string;
     processedAt: string;

package/dist/service.d.ts

@@ -132,6 +132,122 @@ export declare const notificationsService: {
             updatedAt: Date;
         };
     }>;
+    confirmAndDispatchBooking: (db: import("drizzle-orm/postgres-js").PostgresJsDatabase, dispatcher: import("./service-shared.js").NotificationService, bookingId: string, input: {
+        sendNotification?: boolean;
+    } & import("./service-shared.js").SendBookingDocumentsNotificationInput, runtime?: import("./service-booking-documents.js").SendBookingDocumentsRuntimeOptions) => Promise<{
+        status: "not_found";
+        bookingId?: undefined;
+        documents?: undefined;
+        skipReason?: undefined;
+        recipient?: undefined;
+        delivery?: undefined;
+    } | {
+        status: "preview";
+        bookingId: string;
+        documents: {
+            key: string;
+            source: "finance" | "legal";
+            documentType: "invoice" | "proforma" | "contract";
+            bookingId: string;
+            name: string;
+            createdAt: string;
+            contractId?: string | null | undefined;
+            invoiceId?: string | null | undefined;
+            attachmentId?: string | null | undefined;
+            renditionId?: string | null | undefined;
+            contractStatus?: string | null | undefined;
+            invoiceStatus?: string | null | undefined;
+            format?: string | null | undefined;
+            mimeType?: string | null | undefined;
+            storageKey?: string | null | undefined;
+            downloadUrl?: string | null | undefined;
+            language?: string | null | undefined;
+            metadata?: Record<string, unknown> | null | undefined;
+        }[];
+        skipReason?: undefined;
+        recipient?: undefined;
+        delivery?: undefined;
+    } | {
+        status: "skipped";
+        bookingId: string;
+        documents: {
+            key: string;
+            source: "finance" | "legal";
+            documentType: "invoice" | "proforma" | "contract";
+            bookingId: string;
+            name: string;
+            createdAt: string;
+            contractId?: string | null | undefined;
+            invoiceId?: string | null | undefined;
+            attachmentId?: string | null | undefined;
+            renditionId?: string | null | undefined;
+            contractStatus?: string | null | undefined;
+            invoiceStatus?: string | null | undefined;
+            format?: string | null | undefined;
+            mimeType?: string | null | undefined;
+            storageKey?: string | null | undefined;
+            downloadUrl?: string | null | undefined;
+            language?: string | null | undefined;
+            metadata?: Record<string, unknown> | null | undefined;
+        }[];
+        skipReason: "no_documents" | "no_recipient" | "no_attachments" | "send_failed";
+        recipient?: undefined;
+        delivery?: undefined;
+    } | {
+        status: "dispatched";
+        bookingId: string;
+        documents: {
+            key: string;
+            source: "finance" | "legal";
+            documentType: "invoice" | "proforma" | "contract";
+            bookingId: string;
+            name: string;
+            createdAt: string;
+            contractId?: string | null | undefined;
+            invoiceId?: string | null | undefined;
+            attachmentId?: string | null | undefined;
+            renditionId?: string | null | undefined;
+            contractStatus?: string | null | undefined;
+            invoiceStatus?: string | null | undefined;
+            format?: string | null | undefined;
+            mimeType?: string | null | undefined;
+            storageKey?: string | null | undefined;
+            downloadUrl?: string | null | undefined;
+            language?: string | null | undefined;
+            metadata?: Record<string, unknown> | null | undefined;
+        }[];
+        recipient: string;
+        delivery: {
+            id: string;
+            templateId: string | null;
+            templateSlug: string | null;
+            targetType: "organization" | "other" | "booking" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "person" | "payment_session";
+            targetId: string | null;
+            personId: string | null;
+            organizationId: string | null;
+            bookingId: string | null;
+            invoiceId: string | null;
+            paymentSessionId: string | null;
+            channel: "email" | "sms";
+            provider: string;
+            providerMessageId: string | null;
+            status: "pending" | "cancelled" | "failed" | "sent";
+            toAddress: string;
+            fromAddress: string | null;
+            subject: string | null;
+            htmlBody: string | null;
+            textBody: string | null;
+            payloadData: Record<string, unknown> | null;
+            metadata: Record<string, unknown> | null;
+            errorMessage: string | null;
+            scheduledFor: Date | null;
+            sentAt: Date | null;
+            failedAt: Date | null;
+            createdAt: Date;
+            updatedAt: Date;
+        };
+        skipReason?: undefined;
+    }>;
     createDefaultBookingDocumentAttachment: typeof createDefaultBookingDocumentAttachment;
 };
 //# 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":"AAAA,OAAO,EAAE,sCAAsC,EAAE,MAAM,gCAAgC,CAAA;AACvF,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,2BAA2B,EAC3B,0BAA0B,EAC1B,gCAAgC,GACjC,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAEL,sCAAsC,EACvC,MAAM,gCAAgC,CAAA;AACvC,OAAO,EACL,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,gBAAgB,EAChB,8BAA8B,EAC/B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AACjE,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACf,MAAM,wBAAwB,CAAA;AAE/B,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuBhC,CAAA"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sCAAsC,EAAE,MAAM,gCAAgC,CAAA;AACvF,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,2BAA2B,EAC3B,0BAA0B,EAC1B,gCAAgC,GACjC,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAEL,sCAAsC,EACvC,MAAM,gCAAgC,CAAA;AACvC,OAAO,EACL,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,gBAAgB,EAChB,8BAA8B,EAC/B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AACjE,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACf,MAAM,wBAAwB,CAAA;AAE/B,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAyBumV,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CADxoV,CAAA"}

package/dist/service.js

@@ -26,5 +26,6 @@ export const notificationsService = {
     sendInvoiceNotification,
     listBookingDocumentBundle: bookingDocumentNotificationsService.listBookingDocumentBundle,
     sendBookingDocumentsNotification: bookingDocumentNotificationsService.sendBookingDocumentsNotification,
+    confirmAndDispatchBooking: bookingDocumentNotificationsService.confirmAndDispatchBooking,
     createDefaultBookingDocumentAttachment,
 };

package/dist/tasks/deliver-reminder.d.ts

@@ -4,6 +4,6 @@ export declare function deliverQueuedNotificationReminder(db: PostgresJsDatabase
     reminderRunId: string;
 }, options?: NotificationTaskRuntimeOptions): Promise<{
     reminderRunId: string;
-    status: "failed" | "sent" | "processing" | "queued" | "skipped" | null;
+    status: "failed" | "sent" | "processing" | "skipped" | "queued" | null;
 }>;
 //# sourceMappingURL=deliver-reminder.d.ts.map

package/dist/validation.d.ts

@@ -37,8 +37,8 @@ export declare const notificationReminderRunStatusSchema: z.ZodEnum<{
     failed: "failed";
     sent: "sent";
     processing: "processing";
-    queued: "queued";
     skipped: "skipped";
+    queued: "queued";
 }>;
 export declare const notificationDocumentTypeSchema: z.ZodEnum<{
     invoice: "invoice";
@@ -232,8 +232,8 @@ export declare const notificationReminderRunListQuerySchema: z.ZodObject<{
         failed: "failed";
         sent: "sent";
         processing: "processing";
-        queued: "queued";
         skipped: "skipped";
+        queued: "queued";
     }>>;
 }, z.core.$strip>;
 export declare const notificationReminderRunRuleSummarySchema: z.ZodObject<{
@@ -299,8 +299,8 @@ export declare const notificationReminderRunRecordSchema: z.ZodObject<{
         failed: "failed";
         sent: "sent";
         processing: "processing";
-        queued: "queued";
         skipped: "skipped";
+        queued: "queued";
     }>;
     recipient: z.ZodNullable<z.ZodString>;
     scheduledFor: z.ZodString;
@@ -374,8 +374,8 @@ export declare const notificationReminderRunListResponseSchema: z.ZodObject<{
             failed: "failed";
             sent: "sent";
             processing: "processing";
-            queued: "queued";
             skipped: "skipped";
+            queued: "queued";
         }>;
         recipient: z.ZodNullable<z.ZodString>;
         scheduledFor: z.ZodString;
@@ -679,4 +679,79 @@ export declare const sendBookingDocumentsNotificationResultSchema: z.ZodObject<{
         sent: "sent";
     }>;
 }, z.core.$strip>;
+/**
+ * Confirm-and-dispatch — single orchestrated request that lists the booking's
+ * document bundle and (optionally) sends it to the client in one round-trip.
+ *
+ * `sendNotification: false` turns the call into a preview: the bundle comes
+ * back but no delivery is attempted. Templates use the preview to render the
+ * "here's what's ready" checkbox list before the operator confirms.
+ */
+export declare const confirmAndDispatchBookingSchema: z.ZodObject<{
+    templateId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    templateSlug: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    provider: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    to: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    from: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    subject: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    html: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    text: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    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>>;
+    documentTypes: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        invoice: "invoice";
+        proforma: "proforma";
+        contract: "contract";
+    }>>>>;
+    sendNotification: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const confirmAndDispatchBookingResultSchema: z.ZodObject<{
+    bookingId: z.ZodString;
+    documents: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        source: z.ZodEnum<{
+            finance: "finance";
+            legal: "legal";
+        }>;
+        documentType: z.ZodEnum<{
+            invoice: "invoice";
+            proforma: "proforma";
+            contract: "contract";
+        }>;
+        bookingId: z.ZodString;
+        contractId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        invoiceId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        attachmentId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        renditionId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contractStatus: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        invoiceStatus: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        name: z.ZodString;
+        format: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        mimeType: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        storageKey: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        downloadUrl: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        language: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        metadata: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+    notification: z.ZodNullable<z.ZodObject<{
+        recipient: z.ZodString;
+        deliveryId: z.ZodString;
+        provider: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        status: z.ZodEnum<{
+            pending: "pending";
+            cancelled: "cancelled";
+            failed: "failed";
+            sent: "sent";
+        }>;
+    }, z.core.$strip>>;
+    skipReason: z.ZodNullable<z.ZodEnum<{
+        preview_only: "preview_only";
+        no_documents: "no_documents";
+        no_recipient: "no_recipient";
+        no_attachments: "no_attachments";
+        send_failed: "send_failed";
+    }>>;
+}, z.core.$strip>;
 //# 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,yBAAyB;;;EAA2B,CAAA;AACjE,eAAO,MAAM,gCAAgC;;;;EAA0C,CAAA;AACvF,eAAO,MAAM,gCAAgC;;;;;EAAqD,CAAA;AAClG,eAAO,MAAM,4BAA4B;;;;;;;;;EASvC,CAAA;AACF,eAAO,MAAM,gCAAgC;;;;EAA0C,CAAA;AACvF,eAAO,MAAM,oCAAoC;;;EAAkD,CAAA;AACnG,eAAO,MAAM,mCAAmC;;;;;;EAM9C,CAAA;AACF,eAAO,MAAM,8BAA8B;;;;EAA8C,CAAA;AACzF,eAAO,MAAM,gCAAgC;;;EAA+B,CAAA;AAC5E,eAAO,MAAM,4BAA4B;;;;;;;;;;iBAYrC,CAAA;AAqBJ,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;iBAAiC,CAAA;AAC9E,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;iBAA2C,CAAA;AAExF,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;iBAK9C,CAAA;AAEF,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAY9C,CAAA;AAgBF,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;iBAMhD,CAAA;AAED,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;iBAI7C,CAAA;AAEJ,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;iBAKlD,CAAA;AAEF,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;iBAajD,CAAA;AAEF,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;;;;;;iBAWnD,CAAA;AAEF,eAAO,MAAM,4CAA4C;;;;;;;;;;;;;;;;;;iBAUvD,CAAA;AAEF,eAAO,MAAM,kCAAkC;;;;;;;;iBAQ7C,CAAA;AAEF,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiB9C,CAAA;AAEF,eAAO,MAAM,yCAAyC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKpD,CAAA;AAEF,eAAO,MAAM,qBAAqB;;iBAEhC,CAAA;AAkBF,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMhD,CAAA;AAED,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMzC,CAAA;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6BhC,CAAA;AAEH,eAAO,MAAM,iCAAiC;;;;;;;;;;;iBAY1C,CAAA;AAEJ,eAAO,MAAM,uCAAuC;;;;;;;;;;iBAOlD,CAAA;AAEF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmB1C,CAAA;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGtC,CAAA;AAEF,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;iBAajD,CAAA;AAEF,eAAO,MAAM,4CAA4C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOvD,CAAA"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,yBAAyB;;;EAA2B,CAAA;AACjE,eAAO,MAAM,gCAAgC;;;;EAA0C,CAAA;AACvF,eAAO,MAAM,gCAAgC;;;;;EAAqD,CAAA;AAClG,eAAO,MAAM,4BAA4B;;;;;;;;;EASvC,CAAA;AACF,eAAO,MAAM,gCAAgC;;;;EAA0C,CAAA;AACvF,eAAO,MAAM,oCAAoC;;;EAAkD,CAAA;AACnG,eAAO,MAAM,mCAAmC;;;;;;EAM9C,CAAA;AACF,eAAO,MAAM,8BAA8B;;;;EAA8C,CAAA;AACzF,eAAO,MAAM,gCAAgC;;;EAA+B,CAAA;AAC5E,eAAO,MAAM,4BAA4B;;;;;;;;;;iBAYrC,CAAA;AAqBJ,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;iBAAiC,CAAA;AAC9E,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;iBAA2C,CAAA;AAExF,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;iBAK9C,CAAA;AAEF,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAY9C,CAAA;AAgBF,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;iBAMhD,CAAA;AAED,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;iBAI7C,CAAA;AAEJ,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;iBAKlD,CAAA;AAEF,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;iBAajD,CAAA;AAEF,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;;;;;;iBAWnD,CAAA;AAEF,eAAO,MAAM,4CAA4C;;;;;;;;;;;;;;;;;;iBAUvD,CAAA;AAEF,eAAO,MAAM,kCAAkC;;;;;;;;iBAQ7C,CAAA;AAEF,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiB9C,CAAA;AAEF,eAAO,MAAM,yCAAyC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKpD,CAAA;AAEF,eAAO,MAAM,qBAAqB;;iBAEhC,CAAA;AAkBF,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMhD,CAAA;AAED,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMzC,CAAA;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6BhC,CAAA;AAEH,eAAO,MAAM,iCAAiC;;;;;;;;;;;iBAY1C,CAAA;AAEJ,eAAO,MAAM,uCAAuC;;;;;;;;;;iBAOlD,CAAA;AAEF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmB1C,CAAA;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGtC,CAAA;AAEF,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;iBAajD,CAAA;AAEF,eAAO,MAAM,4CAA4C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOvD,CAAA;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;iBAE1C,CAAA;AAEF,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwBhD,CAAA"}

package/dist/validation.js

@@ -289,3 +289,39 @@ export const sendBookingDocumentsNotificationResultSchema = z.object({
     provider: z.string().optional().nullable(),
     status: notificationDeliveryStatusSchema,
 });
+/**
+ * Confirm-and-dispatch — single orchestrated request that lists the booking's
+ * document bundle and (optionally) sends it to the client in one round-trip.
+ *
+ * `sendNotification: false` turns the call into a preview: the bundle comes
+ * back but no delivery is attempted. Templates use the preview to render the
+ * "here's what's ready" checkbox list before the operator confirms.
+ */
+export const confirmAndDispatchBookingSchema = sendBookingDocumentsNotificationSchema.extend({
+    sendNotification: z.boolean().default(true),
+});
+export const confirmAndDispatchBookingResultSchema = z.object({
+    bookingId: z.string().min(1),
+    documents: z.array(bookingDocumentBundleItemSchema),
+    /**
+     * Non-null when `sendNotification` was true and a delivery actually went
+     * out. Null when either the operator asked for a preview only, or the send
+     * couldn't proceed (no recipient / no attachments / no matching documents).
+     */
+    notification: z
+        .object({
+        recipient: z.string().min(1),
+        deliveryId: z.string().min(1),
+        provider: z.string().optional().nullable(),
+        status: notificationDeliveryStatusSchema,
+    })
+        .nullable(),
+    /**
+     * When `sendNotification` was true but the dispatcher declined to send,
+     * this captures which guard tripped so the UI can explain it — e.g.
+     * "No recipient on file, add an email to the lead traveler and retry".
+     */
+    skipReason: z
+        .enum(["preview_only", "no_documents", "no_recipient", "no_attachments", "send_failed"])
+        .nullable(),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/notifications",
-  "version": "0.6.9",
+  "version": "0.8.0",
   "license": "FSL-1.1-Apache-2.0",
   "type": "module",
   "exports": {
@@ -50,12 +50,12 @@
     "hono": "^4.12.10",
     "liquidjs": "^10.24.0",
     "zod": "^4.3.6",
-    "@voyantjs/bookings": "0.6.9",
-    "@voyantjs/core": "0.6.9",
-    "@voyantjs/db": "0.6.9",
-    "@voyantjs/finance": "0.6.9",
-    "@voyantjs/hono": "0.6.9",
-    "@voyantjs/legal": "0.6.9"
+    "@voyantjs/bookings": "0.8.0",
+    "@voyantjs/core": "0.8.0",
+    "@voyantjs/db": "0.8.0",
+    "@voyantjs/finance": "0.8.0",
+    "@voyantjs/hono": "0.8.0",
+    "@voyantjs/legal": "0.8.0"
   },
   "devDependencies": {
     "typescript": "^6.0.2",