@voyantjs/notifications 0.47.0 → 0.50.0

package/README.md

@@ -104,6 +104,57 @@ should override that behavior with `documentAttachmentResolver` or
 or `createNotificationsHonoModule()`, so attachment URLs are resolved at send
 time from the current storage/runtime context.
 
+## Booking Document Bundle Lifecycle
+
+`createNotificationsHonoModule()` can subscribe to booking confirmation and
+fully-paid lifecycle signals through `documentBundleLifecycle`. The hook
+resolves the booking, primary customer/recipient, travelers, booking items, and
+existing legal/finance document bundle before invoking the configured policy.
+
+```ts
+const notificationsModule = createNotificationsHonoModule({
+  resolveDb: (bindings) => getDbFromEnv(bindings),
+  resolveProviders,
+  documentBundleLifecycle: {
+    enabled: true,
+    confirmation: {
+      notification: { templateSlug: "booking-confirmation" },
+    },
+    fullyPaid: {
+      documentTypes: ["contract", "invoice"],
+      notification: { templateSlug: "booking-paid-in-full" },
+    },
+    ensureLegalDocuments: async (context) => {
+      await generateContractForBooking(context.booking.id)
+    },
+    ensureFinanceDocuments: async (context, request) => {
+      await generateInvoiceDocuments(context.booking.id, request.documentTypes)
+    },
+    notificationPolicy: async (context, result) => ({
+      templateSlug:
+        context.trigger === "booking.fully-paid"
+          ? "booking-paid-in-full"
+          : "booking-confirmation",
+      documentTypes: result.documents.map((document) => document.documentType),
+    }),
+  },
+})
+```
+
+The default policy is idempotent by document type: confirmation asks for
+`contract` + `proforma`, and fully-paid asks for `contract` + `invoice`. If a
+contract was already generated at confirmation, the fully-paid hook records it
+as existing and only calls the configured finance generator for the missing
+invoice. Generator exceptions are returned as failed lifecycle results and the
+module subscriber logs booking id plus status only; it does not log document
+contents, attachment bodies, or customer data.
+
+Host apps can replace the entire policy with `policy`, or keep the default
+composition and override only `notificationPolicy`. Product brochures remain an
+extension point via `resolveBrochureDocuments`, so apps that install
+`@voyantjs/products` can add current brochure artifacts without making
+notifications depend on products at runtime.
+
 ## Exports
 
 | Entry | Description |

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import type { AnyDrizzleDb } from "@voyantjs/db";
 import type { HonoModule } from "@voyantjs/hono/module";
 import { type NotificationsRoutesOptions } from "./routes.js";
+import { type BookingDocumentBundleLifecycleOptions } from "./service-booking-document-lifecycle.js";
 export { notificationLiquidEngine, renderLiquidTemplate, } from "./liquid.js";
 export type { LocalProviderOptions } from "./providers/local.js";
 export { createLocalProvider } from "./providers/local.js";
@@ -14,6 +15,8 @@ export type { NewNotificationDelivery, NewNotificationReminderRule, NewNotificat
 export { notificationChannelEnum, notificationDeliveries, notificationDeliveryStatusEnum, notificationReminderRules, notificationReminderRunStatusEnum, notificationReminderRuns, notificationReminderStatusEnum, notificationReminderTargetTypeEnum, notificationsModule, notificationTargetTypeEnum, notificationTemplateStatusEnum, notificationTemplates, } from "./schema.js";
 export type { NotificationService } from "./service.js";
 export { createDefaultBookingDocumentAttachment, createNotificationService, NotificationError, notificationsService, previewNotificationTemplate, renderNotificationTemplate, } from "./service.js";
+export type { BookingDocumentBundleLifecycleContext, BookingDocumentBundleLifecycleDocumentType, BookingDocumentBundleLifecycleEnsureDocuments, BookingDocumentBundleLifecycleEvent, BookingDocumentBundleLifecycleOptions, BookingDocumentBundleLifecyclePolicy, BookingDocumentBundleLifecyclePolicyResult, BookingDocumentBundleLifecycleResolveBrochures, BookingDocumentBundleLifecycleResult, BookingDocumentBundleLifecycleStageOptions, BookingDocumentBundleLifecycleStep, BookingDocumentBundleLifecycleTrigger, BookingDocumentBundleNotificationPolicy, BookingFullyPaidEvent, } from "./service-booking-document-lifecycle.js";
+export { BOOKING_FULLY_PAID_EVENT, bookingDocumentBundleLifecycleService, createDefaultBookingDocumentBundlePolicy, resolveBookingDocumentBundleLifecycleContext, } from "./service-booking-document-lifecycle.js";
 export type { BookingDocumentAttachmentResolver, BookingDocumentsSentEvent, SendBookingDocumentsRuntimeOptions, } from "./service-booking-documents.js";
 export { bookingDocumentNotificationsService } from "./service-booking-documents.js";
 export { bookingIsPaidInFullForNotification, dispatchReminderEventRules, } from "./service-reminders.js";
@@ -46,6 +49,13 @@ export interface CreateNotificationsHonoModuleOptions extends NotificationsRoute
      */
     resolveDb?: (bindings: Record<string, unknown>) => AnyDrizzleDb;
     autoConfirmAndDispatch?: NotificationsAutoConfirmAndDispatchOptions;
+    /**
+     * First-class booking lifecycle hook for composing customer document
+     * bundles after confirmation and fully-paid transitions. Host apps can
+     * plug legal/finance/brochure generators and override notification policy
+     * without replacing the upstream event wiring.
+     */
+    documentBundleLifecycle?: BookingDocumentBundleLifecycleOptions;
 }
 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":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAGvD,OAAO,EAIL,KAAK,0BAA0B,EAChC,MAAM,aAAa,CAAA;AASpB,OAAO,EACL,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,YAAY,EACV,+BAA+B,EAC/B,wBAAwB,GACzB,MAAM,mCAAmC,CAAA;AAC1C,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAA;AAClF,YAAY,EACV,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,iCAAiC,CAAA;AACxC,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAA;AAC9E,YAAY,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AACxF,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,yCAAyC,GAC1C,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,uBAAuB,EACvB,2BAA2B,EAC3B,0BAA0B,EAC1B,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,8BAA8B,EAC9B,yBAAyB,EACzB,iCAAiC,EACjC,wBAAwB,EACxB,8BAA8B,EAC9B,kCAAkC,EAClC,mBAAmB,EACnB,0BAA0B,EAC1B,8BAA8B,EAC9B,qBAAqB,GACtB,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AACvD,OAAO,EACL,sCAAsC,EACtC,yBAAyB,EACzB,iBAAiB,EACjB,oBAAoB,EACpB,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,cAAc,CAAA;AACrB,YAAY,EACV,iCAAiC,EACjC,yBAAyB,EACzB,kCAAkC,GACnC,MAAM,gCAAgC,CAAA;AACvC,OAAO,EAAE,mCAAmC,EAAE,MAAM,gCAAgC,CAAA;AACpF,OAAO,EACL,kCAAkC,EAClC,0BAA0B,GAC3B,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,8BAA8B,EAC9B,mBAAmB,GACpB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,EAAE,iCAAiC,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAA;AAClG,YAAY,EACV,yBAAyB,EACzB,oCAAoC,EACpC,sCAAsC,EACtC,gCAAgC,GACjC,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,0BAA0B,EAC1B,mCAAmC,GACpC,MAAM,yBAAyB,CAAA;AAChC,YAAY,EACV,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,+BAA+B,EAC/B,2BAA2B,EAC3B,oCAAoC,EACpC,yCAAyC,EACzC,4CAA4C,EAC5C,gCAAgC,EAChC,4BAA4B,EAC5B,yBAAyB,EACzB,mCAAmC,EACnC,gCAAgC,EAChC,gCAAgC,EAChC,8BAA8B,EAC9B,uCAAuC,EACvC,4CAA4C,EAC5C,kCAAkC,EAClC,sCAAsC,EACtC,yCAAyC,EACzC,mCAAmC,EACnC,wCAAwC,EACxC,mCAAmC,EACnC,qCAAqC,EACrC,8CAA8C,EAC9C,0CAA0C,EAC1C,gCAAgC,EAChC,oCAAoC,EACpC,oCAAoC,EACpC,4BAA4B,EAC5B,mCAAmC,EACnC,gCAAgC,EAChC,uCAAuC,EACvC,iCAAiC,EACjC,2BAA2B,EAC3B,+BAA+B,EAC/B,qBAAqB,EACrB,4CAA4C,EAC5C,sCAAsC,EACtC,6BAA6B,EAC7B,sBAAsB,EACtB,oCAAoC,EACpC,oCAAoC,EACpC,yCAAyC,EACzC,4CAA4C,EAC5C,gCAAgC,EAChC,gCAAgC,GACjC,MAAM,iBAAiB,CAAA;AAExB;;;GAGG;AACH,MAAM,WAAW,0CAA0C;IACzD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,uEAAuE;IACvE,aAAa,CAAC,EAAE,KAAK,CAAC,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC,CAAA;CAC3D;AAED,MAAM,WAAW,oCAAqC,SAAQ,0BAA0B;IACtF;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,YAAY,CAAA;IAC/D,sBAAsB,CAAC,EAAE,0CAA0C,CAAA;CACpE;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,CAAC,EAAE,oCAAoC,GAC7C,UAAU,CAkNZ"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAGvD,OAAO,EAIL,KAAK,0BAA0B,EAChC,MAAM,aAAa,CAAA;AAGpB,OAAO,EAEL,KAAK,qCAAqC,EAI3C,MAAM,yCAAyC,CAAA;AAOhD,OAAO,EACL,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,YAAY,EACV,+BAA+B,EAC/B,wBAAwB,GACzB,MAAM,mCAAmC,CAAA;AAC1C,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAA;AAClF,YAAY,EACV,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,iCAAiC,CAAA;AACxC,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAA;AAC9E,YAAY,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AACxF,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,yCAAyC,GAC1C,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,uBAAuB,EACvB,2BAA2B,EAC3B,0BAA0B,EAC1B,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,8BAA8B,EAC9B,yBAAyB,EACzB,iCAAiC,EACjC,wBAAwB,EACxB,8BAA8B,EAC9B,kCAAkC,EAClC,mBAAmB,EACnB,0BAA0B,EAC1B,8BAA8B,EAC9B,qBAAqB,GACtB,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AACvD,OAAO,EACL,sCAAsC,EACtC,yBAAyB,EACzB,iBAAiB,EACjB,oBAAoB,EACpB,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,cAAc,CAAA;AACrB,YAAY,EACV,qCAAqC,EACrC,0CAA0C,EAC1C,6CAA6C,EAC7C,mCAAmC,EACnC,qCAAqC,EACrC,oCAAoC,EACpC,0CAA0C,EAC1C,8CAA8C,EAC9C,oCAAoC,EACpC,0CAA0C,EAC1C,kCAAkC,EAClC,qCAAqC,EACrC,uCAAuC,EACvC,qBAAqB,GACtB,MAAM,yCAAyC,CAAA;AAChD,OAAO,EACL,wBAAwB,EACxB,qCAAqC,EACrC,wCAAwC,EACxC,4CAA4C,GAC7C,MAAM,yCAAyC,CAAA;AAChD,YAAY,EACV,iCAAiC,EACjC,yBAAyB,EACzB,kCAAkC,GACnC,MAAM,gCAAgC,CAAA;AACvC,OAAO,EAAE,mCAAmC,EAAE,MAAM,gCAAgC,CAAA;AACpF,OAAO,EACL,kCAAkC,EAClC,0BAA0B,GAC3B,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,8BAA8B,EAC9B,mBAAmB,GACpB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,EAAE,iCAAiC,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAA;AAClG,YAAY,EACV,yBAAyB,EACzB,oCAAoC,EACpC,sCAAsC,EACtC,gCAAgC,GACjC,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,0BAA0B,EAC1B,mCAAmC,GACpC,MAAM,yBAAyB,CAAA;AAChC,YAAY,EACV,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,+BAA+B,EAC/B,2BAA2B,EAC3B,oCAAoC,EACpC,yCAAyC,EACzC,4CAA4C,EAC5C,gCAAgC,EAChC,4BAA4B,EAC5B,yBAAyB,EACzB,mCAAmC,EACnC,gCAAgC,EAChC,gCAAgC,EAChC,8BAA8B,EAC9B,uCAAuC,EACvC,4CAA4C,EAC5C,kCAAkC,EAClC,sCAAsC,EACtC,yCAAyC,EACzC,mCAAmC,EACnC,wCAAwC,EACxC,mCAAmC,EACnC,qCAAqC,EACrC,8CAA8C,EAC9C,0CAA0C,EAC1C,gCAAgC,EAChC,oCAAoC,EACpC,oCAAoC,EACpC,4BAA4B,EAC5B,mCAAmC,EACnC,gCAAgC,EAChC,uCAAuC,EACvC,iCAAiC,EACjC,2BAA2B,EAC3B,+BAA+B,EAC/B,qBAAqB,EACrB,4CAA4C,EAC5C,sCAAsC,EACtC,6BAA6B,EAC7B,sBAAsB,EACtB,oCAAoC,EACpC,oCAAoC,EACpC,yCAAyC,EACzC,4CAA4C,EAC5C,gCAAgC,EAChC,gCAAgC,GACjC,MAAM,iBAAiB,CAAA;AAExB;;;GAGG;AACH,MAAM,WAAW,0CAA0C;IACzD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,uEAAuE;IACvE,aAAa,CAAC,EAAE,KAAK,CAAC,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC,CAAA;CAC3D;AAED,MAAM,WAAW,oCAAqC,SAAQ,0BAA0B;IACtF;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,YAAY,CAAA;IAC/D,sBAAsB,CAAC,EAAE,0CAA0C,CAAA;IACnE;;;;;OAKG;IACH,uBAAuB,CAAC,EAAE,qCAAqC,CAAA;CAChE;AAWD,wBAAgB,6BAA6B,CAC3C,OAAO,CAAC,EAAE,oCAAoC,GAC7C,UAAU,CA4SZ"}

package/dist/index.js

@@ -1,6 +1,7 @@
 import { buildNotificationsRouteRuntime, createNotificationsRoutes, NOTIFICATIONS_ROUTE_RUNTIME_CONTAINER_KEY, } from "./routes.js";
 import { notificationsModule } from "./schema.js";
 import { createNotificationService } from "./service.js";
+import { BOOKING_FULLY_PAID_EVENT, bookingDocumentBundleLifecycleService, } from "./service-booking-document-lifecycle.js";
 import { bookingDocumentNotificationsService } from "./service-booking-documents.js";
 import { bookingIsPaidInFullForNotification, dispatchReminderEventRules, } from "./service-reminders.js";
 export { notificationLiquidEngine, renderLiquidTemplate, } from "./liquid.js";
@@ -10,12 +11,16 @@ export { createVoyantCloudSmsProvider } from "./providers/voyant-cloud-sms.js";
 export { buildNotificationsRouteRuntime, createNotificationsRoutes, NOTIFICATIONS_ROUTE_RUNTIME_CONTAINER_KEY, } from "./routes.js";
 export { notificationChannelEnum, notificationDeliveries, notificationDeliveryStatusEnum, notificationReminderRules, notificationReminderRunStatusEnum, notificationReminderRuns, notificationReminderStatusEnum, notificationReminderTargetTypeEnum, notificationsModule, notificationTargetTypeEnum, notificationTemplateStatusEnum, notificationTemplates, } from "./schema.js";
 export { createDefaultBookingDocumentAttachment, createNotificationService, NotificationError, notificationsService, previewNotificationTemplate, renderNotificationTemplate, } from "./service.js";
+export { BOOKING_FULLY_PAID_EVENT, bookingDocumentBundleLifecycleService, createDefaultBookingDocumentBundlePolicy, resolveBookingDocumentBundleLifecycleContext, } from "./service-booking-document-lifecycle.js";
 export { bookingDocumentNotificationsService } from "./service-booking-documents.js";
 export { bookingIsPaidInFullForNotification, dispatchReminderEventRules, } from "./service-reminders.js";
 export { buildNotificationTaskRuntime } from "./task-runtime.js";
 export { deliverQueuedNotificationReminder, sendDueNotificationReminders } from "./tasks/index.js";
 export { notificationLiquidSnippets, notificationTemplateVariableCatalog, } from "./template-authoring.js";
 export { bookingDocumentBundleItemSchema, bookingDocumentBundleSchema, insertNotificationReminderRuleSchema, insertNotificationReminderRuleStageSchema, insertNotificationReminderStageChannelSchema, insertNotificationTemplateSchema, notificationAttachmentSchema, notificationChannelSchema, notificationDeliveryListQuerySchema, notificationDeliveryStatusSchema, notificationDocumentSourceSchema, notificationDocumentTypeSchema, notificationReminderRuleListQuerySchema, notificationReminderRunDeliverySummarySchema, notificationReminderRunLinksSchema, notificationReminderRunListQuerySchema, notificationReminderRunListResponseSchema, notificationReminderRunRecordSchema, notificationReminderRunRuleSummarySchema, notificationReminderRunStatusSchema, notificationReminderStageAnchorSchema, notificationReminderStageCadenceIntervalSchema, notificationReminderStageCadenceKindSchema, notificationReminderStatusSchema, notificationReminderTargetTypeSchema, notificationStageRecipientKindSchema, notificationTargetTypeSchema, notificationTemplateListQuerySchema, notificationTemplateStatusSchema, previewNotificationTemplateResultSchema, previewNotificationTemplateSchema, previewRemindersQuerySchema, reorderReminderRuleStagesSchema, runDueRemindersSchema, sendBookingDocumentsNotificationResultSchema, sendBookingDocumentsNotificationSchema, sendInvoiceNotificationSchema, sendNotificationSchema, sendPaymentSessionNotificationSchema, updateNotificationReminderRuleSchema, updateNotificationReminderRuleStageSchema, updateNotificationReminderStageChannelSchema, updateNotificationSettingsSchema, updateNotificationTemplateSchema, } from "./validation.js";
+function logDocumentBundleLifecycleFailure(input, message) {
+    console.error(`[notifications] document-bundle lifecycle failed for ${input.trigger} booking ${input.event.bookingId}: ${message}`);
+}
 export function createNotificationsHonoModule(options) {
     const routes = createNotificationsRoutes(options);
     const module = {
@@ -55,6 +60,55 @@ export function createNotificationsHonoModule(options) {
                     }
                 });
             }
+            if (options?.documentBundleLifecycle?.enabled && options.resolveDb) {
+                const resolveDb = options.resolveDb;
+                const lifecycleOptions = options.documentBundleLifecycle;
+                const runtime = buildNotificationsRouteRuntime(bindings, options);
+                const dispatcher = createNotificationService(runtime.providers);
+                const runLifecycle = async (input) => {
+                    try {
+                        const db = resolveDb(bindings);
+                        const result = await bookingDocumentBundleLifecycleService.run(db, dispatcher, input, lifecycleOptions, { attachmentResolver: runtime.documentAttachmentResolver, eventBus });
+                        if (result.status === "failed") {
+                            logDocumentBundleLifecycleFailure(input, result.error);
+                        }
+                    }
+                    catch (error) {
+                        const message = error instanceof Error ? error.message : String(error);
+                        logDocumentBundleLifecycleFailure(input, message);
+                    }
+                };
+                eventBus.subscribe("booking.confirmed", async (event) => {
+                    await runLifecycle({ trigger: "booking.confirmed", event: event.data });
+                });
+                eventBus.subscribe(BOOKING_FULLY_PAID_EVENT, async (event) => {
+                    await runLifecycle({ trigger: BOOKING_FULLY_PAID_EVENT, event: event.data });
+                });
+                eventBus.subscribe("payment.completed", async (event) => {
+                    if (!event.data.bookingId) {
+                        return;
+                    }
+                    try {
+                        const db = resolveDb(bindings);
+                        const isPaidInFull = await bookingIsPaidInFullForNotification(db, event.data.bookingId);
+                        if (!isPaidInFull) {
+                            return;
+                        }
+                        await eventBus.emit(BOOKING_FULLY_PAID_EVENT, {
+                            bookingId: event.data.bookingId,
+                            paymentSessionId: event.data.paymentSessionId,
+                            invoiceId: event.data.invoiceId ?? null,
+                            amountCents: event.data.amountCents,
+                            currency: event.data.currency,
+                            provider: event.data.provider,
+                        }, { category: "domain", source: "subscriber" });
+                    }
+                    catch (error) {
+                        const message = error instanceof Error ? error.message : String(error);
+                        console.error(`[notifications] booking.fully-paid dispatch failed for booking ${event.data.bookingId}: ${message}`);
+                    }
+                });
+            }
             if (options?.resolveDb) {
                 const resolveDb = options.resolveDb;
                 const runtime = buildNotificationsRouteRuntime(bindings, options);

package/dist/routes.d.ts

@@ -1247,8 +1247,8 @@ export declare function createNotificationsRoutes(options?: NotificationsRoutesO
                     bookingId: string;
                     documents: {
                         key: string;
-                        source: "finance" | "legal";
-                        documentType: "invoice" | "proforma" | "contract";
+                        source: "products" | "finance" | "legal";
+                        documentType: "invoice" | "proforma" | "contract" | "brochure";
                         bookingId: string;
                         name: string;
                         createdAt: string;
@@ -1297,8 +1297,8 @@ export declare function createNotificationsRoutes(options?: NotificationsRoutesO
                     bookingId: string;
                     documents: {
                         key: string;
-                        source: "finance" | "legal";
-                        documentType: "invoice" | "proforma" | "contract";
+                        source: "products" | "finance" | "legal";
+                        documentType: "invoice" | "proforma" | "contract" | "brochure";
                         bookingId: string;
                         name: string;
                         createdAt: string;
@@ -1377,8 +1377,8 @@ export declare function createNotificationsRoutes(options?: NotificationsRoutesO
                     recipient: string;
                     documents: {
                         key: string;
-                        source: "finance" | "legal";
-                        documentType: "invoice" | "proforma" | "contract";
+                        source: "products" | "finance" | "legal";
+                        documentType: "invoice" | "proforma" | "contract" | "brochure";
                         bookingId: string;
                         name: string;
                         createdAt: string;

package/dist/service-booking-document-lifecycle.d.ts

@@ -0,0 +1,99 @@
+import { bookings } from "@voyantjs/bookings/schema";
+import type { EventBus } from "@voyantjs/core";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import { type BookingDocumentAttachmentResolver } from "./service-booking-documents.js";
+import type { BookingDocumentBundleItem, NotificationService, SendBookingDocumentsNotificationInput } from "./service-shared.js";
+import { listBookingNotificationItems, listBookingNotificationParticipants, resolveReminderRecipient } from "./service-shared.js";
+export declare const BOOKING_FULLY_PAID_EVENT: "booking.fully-paid";
+export type BookingDocumentBundleLifecycleTrigger = "booking.confirmed" | typeof BOOKING_FULLY_PAID_EVENT;
+export type BookingDocumentBundleLifecycleDocumentType = BookingDocumentBundleItem["documentType"];
+export interface BookingDocumentBundleLifecycleEvent {
+    bookingId: string;
+    bookingNumber?: string | null;
+    actorId?: string | null;
+    [key: string]: unknown;
+}
+export interface BookingFullyPaidEvent extends BookingDocumentBundleLifecycleEvent {
+    paymentSessionId?: string | null;
+    invoiceId?: string | null;
+    amountCents?: number | null;
+    currency?: string | null;
+    provider?: string | null;
+}
+type BookingNotificationParticipant = Awaited<ReturnType<typeof listBookingNotificationParticipants>>[number];
+type BookingNotificationItem = Awaited<ReturnType<typeof listBookingNotificationItems>>[number];
+export interface BookingDocumentBundleLifecycleContext {
+    trigger: BookingDocumentBundleLifecycleTrigger;
+    event: BookingDocumentBundleLifecycleEvent;
+    booking: typeof bookings.$inferSelect;
+    customer: ReturnType<typeof resolveReminderRecipient>;
+    travelers: BookingNotificationParticipant[];
+    items: BookingNotificationItem[];
+    existingDocuments: BookingDocumentBundleItem[];
+}
+export interface BookingDocumentBundleLifecycleStep {
+    source: "legal" | "finance" | "products" | "notification" | "policy";
+    documentType?: BookingDocumentBundleLifecycleDocumentType;
+    status: "existing" | "created" | "skipped" | "sent" | "failed";
+    reason?: string;
+}
+export type BookingDocumentBundleLifecyclePolicyResult = {
+    status: "ok";
+    bookingId: string;
+    documents: BookingDocumentBundleItem[];
+    steps: BookingDocumentBundleLifecycleStep[];
+} | {
+    status: "failed";
+    bookingId: string;
+    steps: BookingDocumentBundleLifecycleStep[];
+    error: string;
+};
+export type BookingDocumentBundleLifecycleResult = BookingDocumentBundleLifecyclePolicyResult | {
+    status: "not_found";
+    bookingId: string;
+};
+export interface BookingDocumentBundleLifecyclePolicyHelpers {
+    refreshDocuments(): Promise<BookingDocumentBundleItem[]>;
+    ensureLegalDocuments?: BookingDocumentBundleLifecycleEnsureDocuments;
+    ensureFinanceDocuments?: BookingDocumentBundleLifecycleEnsureDocuments;
+    resolveBrochureDocuments?: BookingDocumentBundleLifecycleResolveBrochures;
+}
+export type BookingDocumentBundleLifecyclePolicy = (context: BookingDocumentBundleLifecycleContext, helpers: BookingDocumentBundleLifecyclePolicyHelpers) => Promise<BookingDocumentBundleLifecyclePolicyResult> | BookingDocumentBundleLifecyclePolicyResult;
+export type BookingDocumentBundleLifecycleEnsureDocuments = (context: BookingDocumentBundleLifecycleContext, request: {
+    trigger: BookingDocumentBundleLifecycleTrigger;
+    documentTypes: BookingDocumentBundleLifecycleDocumentType[];
+}) => Promise<undefined | BookingDocumentBundleLifecycleStep[]> | undefined | BookingDocumentBundleLifecycleStep[];
+export type BookingDocumentBundleLifecycleResolveBrochures = (context: BookingDocumentBundleLifecycleContext) => Promise<BookingDocumentBundleItem[]> | BookingDocumentBundleItem[];
+export type BookingDocumentBundleNotificationPolicy = (context: BookingDocumentBundleLifecycleContext, result: Extract<BookingDocumentBundleLifecyclePolicyResult, {
+    status: "ok";
+}>) => Promise<SendBookingDocumentsNotificationInput | false | null | undefined> | SendBookingDocumentsNotificationInput | false | null | undefined;
+export interface BookingDocumentBundleLifecycleStageOptions {
+    documentTypes?: BookingDocumentBundleLifecycleDocumentType[];
+    notification?: SendBookingDocumentsNotificationInput | false;
+}
+export interface BookingDocumentBundleLifecycleOptions {
+    enabled?: boolean;
+    confirmation?: BookingDocumentBundleLifecycleStageOptions;
+    fullyPaid?: BookingDocumentBundleLifecycleStageOptions;
+    policy?: BookingDocumentBundleLifecyclePolicy;
+    notificationPolicy?: BookingDocumentBundleNotificationPolicy;
+    ensureLegalDocuments?: BookingDocumentBundleLifecycleEnsureDocuments;
+    ensureFinanceDocuments?: BookingDocumentBundleLifecycleEnsureDocuments;
+    resolveBrochureDocuments?: BookingDocumentBundleLifecycleResolveBrochures;
+}
+export interface RunBookingDocumentBundleLifecycleInput {
+    trigger: BookingDocumentBundleLifecycleTrigger;
+    event: BookingDocumentBundleLifecycleEvent;
+}
+export interface BookingDocumentBundleLifecycleRuntime {
+    eventBus?: EventBus;
+    attachmentResolver?: BookingDocumentAttachmentResolver;
+    resolveContext?: (db: PostgresJsDatabase, input: RunBookingDocumentBundleLifecycleInput) => Promise<BookingDocumentBundleLifecycleContext | null>;
+}
+export declare function resolveBookingDocumentBundleLifecycleContext(db: PostgresJsDatabase, input: RunBookingDocumentBundleLifecycleInput): Promise<BookingDocumentBundleLifecycleContext | null>;
+export declare function createDefaultBookingDocumentBundlePolicy(options: BookingDocumentBundleLifecycleOptions): BookingDocumentBundleLifecyclePolicy;
+export declare const bookingDocumentBundleLifecycleService: {
+    run(db: PostgresJsDatabase, dispatcher: NotificationService, input: RunBookingDocumentBundleLifecycleInput, options?: BookingDocumentBundleLifecycleOptions, runtime?: BookingDocumentBundleLifecycleRuntime): Promise<BookingDocumentBundleLifecycleResult>;
+};
+export {};
+//# sourceMappingURL=service-booking-document-lifecycle.d.ts.map

package/dist/service-booking-document-lifecycle.d.ts.map

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

package/dist/service-booking-document-lifecycle.js

@@ -0,0 +1,259 @@
+import { bookings } from "@voyantjs/bookings/schema";
+import { eq } from "drizzle-orm";
+import { bookingDocumentNotificationsService, } from "./service-booking-documents.js";
+import { listBookingNotificationItems, listBookingNotificationParticipants, resolveReminderRecipient, } from "./service-shared.js";
+export const BOOKING_FULLY_PAID_EVENT = "booking.fully-paid";
+function stageOptionsForTrigger(options, trigger) {
+    return trigger === BOOKING_FULLY_PAID_EVENT ? options.fullyPaid : options.confirmation;
+}
+function defaultDocumentTypesForTrigger(trigger) {
+    return trigger === BOOKING_FULLY_PAID_EVENT ? ["contract", "invoice"] : ["contract", "proforma"];
+}
+function getRequestedDocumentTypes(options, trigger) {
+    return (stageOptionsForTrigger(options, trigger)?.documentTypes ??
+        defaultDocumentTypesForTrigger(trigger));
+}
+function hasDocument(documents, documentType) {
+    return documents.some((document) => document.documentType === documentType);
+}
+function isFinanceDocumentType(documentType) {
+    return documentType === "invoice" || documentType === "proforma";
+}
+function messageFromError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function generatorStep(source, documentType, status, reason) {
+    return {
+        source,
+        documentType,
+        status,
+        ...(reason ? { reason } : {}),
+    };
+}
+export async function resolveBookingDocumentBundleLifecycleContext(db, input) {
+    const [booking] = await db
+        .select()
+        .from(bookings)
+        .where(eq(bookings.id, input.event.bookingId))
+        .limit(1);
+    if (!booking) {
+        return null;
+    }
+    const [bundle, travelers, items] = await Promise.all([
+        bookingDocumentNotificationsService.listBookingDocumentBundle(db, booking.id),
+        listBookingNotificationParticipants(db, booking.id),
+        listBookingNotificationItems(db, booking.id),
+    ]);
+    return {
+        trigger: input.trigger,
+        event: input.event,
+        booking,
+        customer: resolveReminderRecipient(booking, travelers),
+        travelers,
+        items,
+        existingDocuments: bundle?.documents ?? [],
+    };
+}
+export function createDefaultBookingDocumentBundlePolicy(options) {
+    return async (context, helpers) => {
+        const requestedTypes = getRequestedDocumentTypes(options, context.trigger);
+        const steps = [];
+        let documents = context.existingDocuments;
+        const missingTypes = requestedTypes.filter((documentType) => !hasDocument(documents, documentType));
+        const needsContract = missingTypes.includes("contract");
+        const financeTypes = missingTypes.filter(isFinanceDocumentType);
+        if (needsContract) {
+            if (helpers.ensureLegalDocuments) {
+                try {
+                    steps.push(...((await helpers.ensureLegalDocuments(context, {
+                        trigger: context.trigger,
+                        documentTypes: ["contract"],
+                    })) ?? [generatorStep("legal", "contract", "created")]));
+                    documents = await helpers.refreshDocuments();
+                }
+                catch (error) {
+                    return {
+                        status: "failed",
+                        bookingId: context.booking.id,
+                        steps: [
+                            ...steps,
+                            generatorStep("legal", "contract", "failed", messageFromError(error)),
+                        ],
+                        error: messageFromError(error),
+                    };
+                }
+            }
+            else {
+                steps.push(generatorStep("legal", "contract", "skipped", "no_generator"));
+            }
+        }
+        else if (requestedTypes.includes("contract")) {
+            steps.push(generatorStep("legal", "contract", "existing"));
+        }
+        for (const documentType of financeTypes) {
+            if (!helpers.ensureFinanceDocuments) {
+                steps.push(generatorStep("finance", documentType, "skipped", "no_generator"));
+                continue;
+            }
+            try {
+                steps.push(...((await helpers.ensureFinanceDocuments(context, {
+                    trigger: context.trigger,
+                    documentTypes: [documentType],
+                })) ?? [generatorStep("finance", documentType, "created")]));
+                documents = await helpers.refreshDocuments();
+            }
+            catch (error) {
+                return {
+                    status: "failed",
+                    bookingId: context.booking.id,
+                    steps: [
+                        ...steps,
+                        generatorStep("finance", documentType, "failed", messageFromError(error)),
+                    ],
+                    error: messageFromError(error),
+                };
+            }
+        }
+        for (const documentType of requestedTypes) {
+            if (isFinanceDocumentType(documentType) && !financeTypes.includes(documentType)) {
+                steps.push(generatorStep("finance", documentType, "existing"));
+            }
+        }
+        if (requestedTypes.includes("brochure")) {
+            if (helpers.resolveBrochureDocuments) {
+                try {
+                    const brochures = await helpers.resolveBrochureDocuments(context);
+                    documents = [...documents, ...brochures];
+                    steps.push({
+                        source: "products",
+                        documentType: "brochure",
+                        status: brochures.length > 0 ? "existing" : "skipped",
+                        ...(brochures.length === 0 ? { reason: "not_available" } : {}),
+                    });
+                }
+                catch (error) {
+                    return {
+                        status: "failed",
+                        bookingId: context.booking.id,
+                        steps: [
+                            ...steps,
+                            {
+                                source: "products",
+                                documentType: "brochure",
+                                status: "failed",
+                                reason: messageFromError(error),
+                            },
+                        ],
+                        error: messageFromError(error),
+                    };
+                }
+            }
+            else {
+                steps.push({
+                    source: "products",
+                    documentType: "brochure",
+                    status: "skipped",
+                    reason: "no_resolver",
+                });
+            }
+        }
+        return {
+            status: "ok",
+            bookingId: context.booking.id,
+            documents,
+            steps,
+        };
+    };
+}
+function defaultNotificationInput(options, context) {
+    const stage = stageOptionsForTrigger(options, context.trigger);
+    if (stage?.notification === false)
+        return false;
+    return {
+        ...(stage?.notification ?? {}),
+        documentTypes: stage?.notification && "documentTypes" in stage.notification
+            ? stage.notification.documentTypes
+            : getRequestedDocumentTypes(options, context.trigger),
+    };
+}
+export const bookingDocumentBundleLifecycleService = {
+    async run(db, dispatcher, input, options = {}, runtime = {}) {
+        const resolveContext = runtime.resolveContext ?? resolveBookingDocumentBundleLifecycleContext;
+        const context = await resolveContext(db, input);
+        if (!context) {
+            return { status: "not_found", bookingId: input.event.bookingId };
+        }
+        const helpers = {
+            refreshDocuments: async () => {
+                const bundle = await bookingDocumentNotificationsService.listBookingDocumentBundle(db, context.booking.id);
+                return bundle?.documents ?? [];
+            },
+            ensureLegalDocuments: options.ensureLegalDocuments,
+            ensureFinanceDocuments: options.ensureFinanceDocuments,
+            resolveBrochureDocuments: options.resolveBrochureDocuments,
+        };
+        let policyResult;
+        try {
+            const policy = options.policy ?? createDefaultBookingDocumentBundlePolicy(options);
+            policyResult = await policy(context, helpers);
+        }
+        catch (error) {
+            policyResult = {
+                status: "failed",
+                bookingId: context.booking.id,
+                steps: [{ source: "policy", status: "failed", reason: messageFromError(error) }],
+                error: messageFromError(error),
+            };
+        }
+        if (policyResult.status !== "ok") {
+            return policyResult;
+        }
+        let notificationInput;
+        try {
+            notificationInput =
+                options.notificationPolicy !== undefined
+                    ? await options.notificationPolicy(context, policyResult)
+                    : defaultNotificationInput(options, context);
+        }
+        catch (error) {
+            return {
+                status: "failed",
+                bookingId: context.booking.id,
+                steps: [
+                    ...policyResult.steps,
+                    { source: "notification", status: "failed", reason: messageFromError(error) },
+                ],
+                error: messageFromError(error),
+            };
+        }
+        if (notificationInput === false || notificationInput == null) {
+            return policyResult;
+        }
+        let notification;
+        try {
+            notification = await bookingDocumentNotificationsService.sendBookingDocumentsNotification(db, dispatcher, context.booking.id, notificationInput, { attachmentResolver: runtime.attachmentResolver, eventBus: runtime.eventBus });
+        }
+        catch (error) {
+            return {
+                status: "failed",
+                bookingId: context.booking.id,
+                steps: [
+                    ...policyResult.steps,
+                    { source: "notification", status: "failed", reason: messageFromError(error) },
+                ],
+                error: messageFromError(error),
+            };
+        }
+        return {
+            ...policyResult,
+            steps: [
+                ...policyResult.steps,
+                {
+                    source: "notification",
+                    status: notification.status === "sent" ? "sent" : "skipped",
+                    reason: notification.status === "sent" ? undefined : notification.status,
+                },
+            ],
+        };
+    },
+};

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

@@ -20,8 +20,8 @@ export declare const bookingDocumentNotificationsService: {
         bookingId: string;
         documents: {
             key: string;
-            source: "finance" | "legal";
-            documentType: "invoice" | "proforma" | "contract";
+            source: "products" | "finance" | "legal";
+            documentType: "invoice" | "proforma" | "contract" | "brochure";
             bookingId: string;
             name: string;
             createdAt: string;
@@ -75,8 +75,8 @@ export declare const bookingDocumentNotificationsService: {
         recipient: string;
         documents: {
             key: string;
-            source: "finance" | "legal";
-            documentType: "invoice" | "proforma" | "contract";
+            source: "products" | "finance" | "legal";
+            documentType: "invoice" | "proforma" | "contract" | "brochure";
             bookingId: string;
             name: string;
             createdAt: string;
@@ -149,8 +149,8 @@ export declare const bookingDocumentNotificationsService: {
         bookingId: string;
         documents: {
             key: string;
-            source: "finance" | "legal";
-            documentType: "invoice" | "proforma" | "contract";
+            source: "products" | "finance" | "legal";
+            documentType: "invoice" | "proforma" | "contract" | "brochure";
             bookingId: string;
             name: string;
             createdAt: string;
@@ -175,8 +175,8 @@ export declare const bookingDocumentNotificationsService: {
         bookingId: string;
         documents: {
             key: string;
-            source: "finance" | "legal";
-            documentType: "invoice" | "proforma" | "contract";
+            source: "products" | "finance" | "legal";
+            documentType: "invoice" | "proforma" | "contract" | "brochure";
             bookingId: string;
             name: string;
             createdAt: string;
@@ -201,8 +201,8 @@ export declare const bookingDocumentNotificationsService: {
         bookingId: string;
         documents: {
             key: string;
-            source: "finance" | "legal";
-            documentType: "invoice" | "proforma" | "contract";
+            source: "products" | "finance" | "legal";
+            documentType: "invoice" | "proforma" | "contract" | "brochure";
             bookingId: string;
             name: string;
             createdAt: string;

package/dist/service.d.ts

@@ -45,8 +45,8 @@ export declare const notificationsService: {
         bookingId: string;
         documents: {
             key: string;
-            source: "finance" | "legal";
-            documentType: "invoice" | "proforma" | "contract";
+            source: "products" | "finance" | "legal";
+            documentType: "invoice" | "proforma" | "contract" | "brochure";
             bookingId: string;
             name: string;
             createdAt: string;
@@ -100,8 +100,8 @@ export declare const notificationsService: {
         recipient: string;
         documents: {
             key: string;
-            source: "finance" | "legal";
-            documentType: "invoice" | "proforma" | "contract";
+            source: "products" | "finance" | "legal";
+            documentType: "invoice" | "proforma" | "contract" | "brochure";
             bookingId: string;
             name: string;
             createdAt: string;
@@ -162,8 +162,8 @@ export declare const notificationsService: {
         bookingId: string;
         documents: {
             key: string;
-            source: "finance" | "legal";
-            documentType: "invoice" | "proforma" | "contract";
+            source: "products" | "finance" | "legal";
+            documentType: "invoice" | "proforma" | "contract" | "brochure";
             bookingId: string;
             name: string;
             createdAt: string;
@@ -188,8 +188,8 @@ export declare const notificationsService: {
         bookingId: string;
         documents: {
             key: string;
-            source: "finance" | "legal";
-            documentType: "invoice" | "proforma" | "contract";
+            source: "products" | "finance" | "legal";
+            documentType: "invoice" | "proforma" | "contract" | "brochure";
             bookingId: string;
             name: string;
             createdAt: string;
@@ -214,8 +214,8 @@ export declare const notificationsService: {
         bookingId: string;
         documents: {
             key: string;
-            source: "finance" | "legal";
-            documentType: "invoice" | "proforma" | "contract";
+            source: "products" | "finance" | "legal";
+            documentType: "invoice" | "proforma" | "contract" | "brochure";
             bookingId: string;
             name: string;
             createdAt: string;

package/dist/validation.d.ts

@@ -69,8 +69,10 @@ export declare const notificationDocumentTypeSchema: z.ZodEnum<{
     invoice: "invoice";
     proforma: "proforma";
     contract: "contract";
+    brochure: "brochure";
 }>;
 export declare const notificationDocumentSourceSchema: z.ZodEnum<{
+    products: "products";
     finance: "finance";
     legal: "legal";
 }>;
@@ -728,6 +730,7 @@ export declare const previewNotificationTemplateResultSchema: z.ZodObject<{
 export declare const bookingDocumentBundleItemSchema: z.ZodObject<{
     key: z.ZodString;
     source: z.ZodEnum<{
+        products: "products";
         finance: "finance";
         legal: "legal";
     }>;
@@ -735,6 +738,7 @@ export declare const bookingDocumentBundleItemSchema: z.ZodObject<{
         invoice: "invoice";
         proforma: "proforma";
         contract: "contract";
+        brochure: "brochure";
     }>;
     bookingId: z.ZodString;
     contractId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
@@ -757,6 +761,7 @@ export declare const bookingDocumentBundleSchema: z.ZodObject<{
     documents: z.ZodArray<z.ZodObject<{
         key: z.ZodString;
         source: z.ZodEnum<{
+            products: "products";
             finance: "finance";
             legal: "legal";
         }>;
@@ -764,6 +769,7 @@ export declare const bookingDocumentBundleSchema: z.ZodObject<{
             invoice: "invoice";
             proforma: "proforma";
             contract: "contract";
+            brochure: "brochure";
         }>;
         bookingId: z.ZodString;
         contractId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
@@ -798,6 +804,7 @@ export declare const sendBookingDocumentsNotificationSchema: z.ZodObject<{
         invoice: "invoice";
         proforma: "proforma";
         contract: "contract";
+        brochure: "brochure";
     }>>>>;
 }, z.core.$strip>;
 export declare const sendBookingDocumentsNotificationResultSchema: z.ZodObject<{
@@ -806,6 +813,7 @@ export declare const sendBookingDocumentsNotificationResultSchema: z.ZodObject<{
     documents: z.ZodArray<z.ZodObject<{
         key: z.ZodString;
         source: z.ZodEnum<{
+            products: "products";
             finance: "finance";
             legal: "legal";
         }>;
@@ -813,6 +821,7 @@ export declare const sendBookingDocumentsNotificationResultSchema: z.ZodObject<{
             invoice: "invoice";
             proforma: "proforma";
             contract: "contract";
+            brochure: "brochure";
         }>;
         bookingId: z.ZodString;
         contractId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
@@ -863,6 +872,7 @@ export declare const confirmAndDispatchBookingSchema: z.ZodObject<{
         invoice: "invoice";
         proforma: "proforma";
         contract: "contract";
+        brochure: "brochure";
     }>>>>;
     sendNotification: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
@@ -871,6 +881,7 @@ export declare const confirmAndDispatchBookingResultSchema: z.ZodObject<{
     documents: z.ZodArray<z.ZodObject<{
         key: z.ZodString;
         source: z.ZodEnum<{
+            products: "products";
             finance: "finance";
             legal: "legal";
         }>;
@@ -878,6 +889,7 @@ export declare const confirmAndDispatchBookingResultSchema: z.ZodObject<{
             invoice: "invoice";
             proforma: "proforma";
             contract: "contract";
+            brochure: "brochure";
         }>;
         bookingId: z.ZodString;
         contractId: z.ZodNullable<z.ZodOptional<z.ZodString>>;

package/dist/validation.d.ts.map

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

package/dist/validation.js

@@ -45,8 +45,13 @@ export const notificationReminderStageCadenceIntervalSchema = z.object({
     whenDaysUntilDueLT: z.coerce.number().int().optional().nullable(),
     repeatEveryDays: z.coerce.number().int().min(1).max(365),
 });
-export const notificationDocumentTypeSchema = z.enum(["contract", "invoice", "proforma"]);
-export const notificationDocumentSourceSchema = z.enum(["legal", "finance"]);
+export const notificationDocumentTypeSchema = z.enum([
+    "contract",
+    "invoice",
+    "proforma",
+    "brochure",
+]);
+export const notificationDocumentSourceSchema = z.enum(["legal", "finance", "products"]);
 export const notificationAttachmentSchema = z
     .object({
     filename: z.string().min(1).max(500),

package/package.json

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