@voyantjs/notifications 0.3.1 → 0.4.1

package/dist/service-shared.js

@@ -36,6 +36,18 @@ export function createNotificationService(providers) {
         },
     };
 }
+export function summarizeNotificationAttachments(attachments) {
+    if (!attachments || attachments.length === 0) {
+        return [];
+    }
+    return attachments.map((attachment) => ({
+        filename: attachment.filename,
+        path: attachment.path ?? null,
+        contentType: attachment.contentType ?? null,
+        disposition: attachment.disposition ?? null,
+        contentId: attachment.contentId ?? null,
+    }));
+}
 function resolveMustachePath(path, scope) {
     const parts = path.match(/[^.[\]]+/g) ?? [];
     let current = scope;

package/dist/service-templates.d.ts

@@ -91,7 +91,7 @@ export declare function listReminderRules(db: PostgresJsDatabase, query: Notific
         slug: string;
         name: string;
         status: "draft" | "active" | "archived";
-        targetType: "booking_payment_schedule";
+        targetType: "invoice" | "booking_payment_schedule";
         channel: "email" | "sms";
         provider: string | null;
         templateId: string | null;
@@ -111,7 +111,7 @@ export declare function getReminderRuleById(db: PostgresJsDatabase, id: string):
     slug: string;
     name: string;
     status: "draft" | "active" | "archived";
-    targetType: "booking_payment_schedule";
+    targetType: "invoice" | "booking_payment_schedule";
     channel: "email" | "sms";
     provider: string | null;
     templateId: string | null;
@@ -131,7 +131,7 @@ export declare function createReminderRule(db: PostgresJsDatabase, data: CreateN
     metadata: Record<string, unknown> | null;
     channel: "email" | "sms";
     provider: string | null;
-    targetType: "booking_payment_schedule";
+    targetType: "invoice" | "booking_payment_schedule";
     templateId: string | null;
     slug: string;
     isSystem: boolean;
@@ -143,7 +143,7 @@ export declare function updateReminderRule(db: PostgresJsDatabase, id: string, d
     slug: string;
     name: string;
     status: "draft" | "active" | "archived";
-    targetType: "booking_payment_schedule";
+    targetType: "invoice" | "booking_payment_schedule";
     channel: "email" | "sms";
     provider: string | null;
     templateId: string | null;
@@ -158,7 +158,7 @@ export declare function listReminderRuns(db: PostgresJsDatabase, query: Notifica
     data: {
         id: string;
         reminderRuleId: string;
-        targetType: "booking_payment_schedule";
+        targetType: "invoice" | "booking_payment_schedule";
         targetId: string;
         dedupeKey: string;
         bookingId: string | null;

package/dist/service.d.ts

@@ -1,5 +1,7 @@
+export { createDefaultBookingDocumentAttachment } from "./service-booking-documents.js";
 export type { NotificationService } from "./service-shared.js";
-export { createNotificationService, NotificationError, renderNotificationTemplate, } from "./service-shared.js";
+export { createNotificationService, NotificationError, renderNotificationTemplate, summarizeNotificationAttachments, } from "./service-shared.js";
+import { createDefaultBookingDocumentAttachment } from "./service-booking-documents.js";
 import { getDeliveryById, listDeliveries, sendInvoiceNotification, sendNotification, sendPaymentSessionNotification } from "./service-deliveries.js";
 import { runDueReminders } from "./service-reminders.js";
 import { createReminderRule, createTemplate, getReminderRuleById, getTemplateById, getTemplateBySlug, listReminderRules, listReminderRuns, listTemplates, updateReminderRule, updateTemplate } from "./service-templates.js";
@@ -20,5 +22,113 @@ export declare const notificationsService: {
     runDueReminders: typeof runDueReminders;
     sendPaymentSessionNotification: typeof sendPaymentSessionNotification;
     sendInvoiceNotification: typeof sendInvoiceNotification;
+    listBookingDocumentBundle: (db: import("drizzle-orm/postgres-js").PostgresJsDatabase, bookingId: string) => Promise<{
+        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;
+        }[];
+    } | null>;
+    sendBookingDocumentsNotification: (db: import("drizzle-orm/postgres-js").PostgresJsDatabase, dispatcher: import("./service-shared.js").NotificationService, bookingId: string, input: import("./service-shared.js").SendBookingDocumentsNotificationInput, runtime?: import("./service-booking-documents.js").SendBookingDocumentsRuntimeOptions) => Promise<{
+        status: "not_found";
+        bookingId?: undefined;
+        recipient?: undefined;
+        documents?: undefined;
+        delivery?: undefined;
+    } | {
+        status: "no_documents";
+        bookingId?: undefined;
+        recipient?: undefined;
+        documents?: undefined;
+        delivery?: undefined;
+    } | {
+        status: "no_recipient";
+        bookingId?: undefined;
+        recipient?: undefined;
+        documents?: undefined;
+        delivery?: undefined;
+    } | {
+        status: "no_attachments";
+        bookingId?: undefined;
+        recipient?: undefined;
+        documents?: undefined;
+        delivery?: undefined;
+    } | {
+        status: "send_failed";
+        bookingId?: undefined;
+        recipient?: undefined;
+        documents?: undefined;
+        delivery?: undefined;
+    } | {
+        status: "sent";
+        bookingId: string;
+        recipient: 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;
+        }[];
+        delivery: {
+            id: string;
+            templateId: string | null;
+            templateSlug: string | null;
+            targetType: "other" | "booking" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "organization" | "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: "cancelled" | "pending" | "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;
+        };
+    }>;
+    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,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAA;AAE5B,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,EACL,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACf,MAAM,wBAAwB,CAAA;AAE/B,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;CAiBhC,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,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,EACL,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACf,MAAM,wBAAwB,CAAA;AAE/B,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqBhC,CAAA"}

package/dist/service.js

@@ -1,4 +1,6 @@
-export { createNotificationService, NotificationError, renderNotificationTemplate, } from "./service-shared.js";
+export { createDefaultBookingDocumentAttachment } from "./service-booking-documents.js";
+export { createNotificationService, NotificationError, renderNotificationTemplate, summarizeNotificationAttachments, } from "./service-shared.js";
+import { bookingDocumentNotificationsService, createDefaultBookingDocumentAttachment, } from "./service-booking-documents.js";
 import { getDeliveryById, listDeliveries, sendInvoiceNotification, sendNotification, sendPaymentSessionNotification, } from "./service-deliveries.js";
 import { runDueReminders } from "./service-reminders.js";
 import { createReminderRule, createTemplate, getReminderRuleById, getTemplateById, getTemplateBySlug, listReminderRules, listReminderRuns, listTemplates, updateReminderRule, updateTemplate, } from "./service-templates.js";
@@ -19,4 +21,7 @@ export const notificationsService = {
     runDueReminders,
     sendPaymentSessionNotification,
     sendInvoiceNotification,
+    listBookingDocumentBundle: bookingDocumentNotificationsService.listBookingDocumentBundle,
+    sendBookingDocumentsNotification: bookingDocumentNotificationsService.sendBookingDocumentsNotification,
+    createDefaultBookingDocumentAttachment,
 };

package/dist/types.d.ts

@@ -4,6 +4,26 @@
  * identifiers (e.g. `"slack"`, `"push"`).
  */
 export type NotificationChannel = "email" | "sms" | (string & {});
+/**
+ * Attachment payload for channels that support file delivery, such as email.
+ *
+ * Use `contentBase64` when the caller already has the rendered bytes, or `path`
+ * when the downstream provider can fetch the attachment from a URL/file path.
+ */
+export interface NotificationAttachment {
+    /** User-visible file name. */
+    filename: string;
+    /** Base64-encoded content for inline upload. */
+    contentBase64?: string;
+    /** Provider-resolvable URL or path. */
+    path?: string;
+    /** MIME type hint. */
+    contentType?: string;
+    /** Optional disposition override. */
+    disposition?: "attachment" | "inline";
+    /** Optional inline content id. */
+    contentId?: string;
+}
 /**
  * Payload describing a single notification to send. The `template` and
  * `data` fields are interpreted by the handling provider.
@@ -27,6 +47,8 @@ export interface NotificationPayload {
     html?: string;
     /** Optional pre-rendered text body. */
     text?: string;
+    /** Optional attachments for providers that support them. */
+    attachments?: ReadonlyArray<NotificationAttachment>;
 }
 /**
  * Result returned after a provider handles a send.

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,KAAK,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEjE;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAA;IACV,yCAAyC;IACzC,OAAO,EAAE,mBAAmB,CAAA;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAA;IAChB,iDAAiD;IACjD,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAA;IACrD,mDAAmD;IACnD,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;CAChE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,KAAK,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEjE;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sBAAsB;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qCAAqC;IACrC,WAAW,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAA;IACrC,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAA;IACV,yCAAyC;IACzC,OAAO,EAAE,mBAAmB,CAAA;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAA;IAChB,iDAAiD;IACjD,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,4DAA4D;IAC5D,WAAW,CAAC,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAA;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAA;IACrD,mDAAmD;IACnD,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;CAChE"}

package/dist/validation.d.ts

@@ -20,9 +20,9 @@ export declare const notificationTargetTypeSchema: z.ZodEnum<{
     invoice: "invoice";
     booking_payment_schedule: "booking_payment_schedule";
     booking_guarantee: "booking_guarantee";
-    payment_session: "payment_session";
-    person: "person";
     organization: "organization";
+    person: "person";
+    payment_session: "payment_session";
 }>;
 export declare const notificationReminderStatusSchema: z.ZodEnum<{
     draft: "draft";
@@ -30,6 +30,7 @@ export declare const notificationReminderStatusSchema: z.ZodEnum<{
     archived: "archived";
 }>;
 export declare const notificationReminderTargetTypeSchema: z.ZodEnum<{
+    invoice: "invoice";
     booking_payment_schedule: "booking_payment_schedule";
 }>;
 export declare const notificationReminderRunStatusSchema: z.ZodEnum<{
@@ -38,6 +39,26 @@ export declare const notificationReminderRunStatusSchema: z.ZodEnum<{
     processing: "processing";
     skipped: "skipped";
 }>;
+export declare const notificationDocumentTypeSchema: z.ZodEnum<{
+    invoice: "invoice";
+    proforma: "proforma";
+    contract: "contract";
+}>;
+export declare const notificationDocumentSourceSchema: z.ZodEnum<{
+    finance: "finance";
+    legal: "legal";
+}>;
+export declare const notificationAttachmentSchema: z.ZodObject<{
+    filename: z.ZodString;
+    contentBase64: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    path: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    contentType: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    disposition: z.ZodNullable<z.ZodOptional<z.ZodEnum<{
+        attachment: "attachment";
+        inline: "inline";
+    }>>>;
+    contentId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
 export declare const insertNotificationTemplateSchema: z.ZodObject<{
     slug: z.ZodString;
     name: z.ZodString;
@@ -114,9 +135,9 @@ export declare const notificationDeliveryListQuerySchema: z.ZodObject<{
         invoice: "invoice";
         booking_payment_schedule: "booking_payment_schedule";
         booking_guarantee: "booking_guarantee";
-        payment_session: "payment_session";
-        person: "person";
         organization: "organization";
+        person: "person";
+        payment_session: "payment_session";
     }>>;
     targetId: z.ZodOptional<z.ZodString>;
     bookingId: z.ZodOptional<z.ZodString>;
@@ -134,6 +155,7 @@ export declare const insertNotificationReminderRuleSchema: z.ZodObject<{
         archived: "archived";
     }>>;
     targetType: z.ZodEnum<{
+        invoice: "invoice";
         booking_payment_schedule: "booking_payment_schedule";
     }>;
     channel: z.ZodEnum<{
@@ -156,6 +178,7 @@ export declare const updateNotificationReminderRuleSchema: z.ZodObject<{
         archived: "archived";
     }>>>;
     targetType: z.ZodOptional<z.ZodEnum<{
+        invoice: "invoice";
         booking_payment_schedule: "booking_payment_schedule";
     }>>;
     channel: z.ZodOptional<z.ZodEnum<{
@@ -178,6 +201,7 @@ export declare const notificationReminderRuleListQuerySchema: z.ZodObject<{
         archived: "archived";
     }>>;
     targetType: z.ZodOptional<z.ZodEnum<{
+        invoice: "invoice";
         booking_payment_schedule: "booking_payment_schedule";
     }>>;
     channel: z.ZodOptional<z.ZodEnum<{
@@ -191,6 +215,7 @@ export declare const notificationReminderRunListQuerySchema: z.ZodObject<{
     offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     reminderRuleId: z.ZodOptional<z.ZodString>;
     targetType: z.ZodOptional<z.ZodEnum<{
+        invoice: "invoice";
         booking_payment_schedule: "booking_payment_schedule";
     }>>;
     targetId: z.ZodOptional<z.ZodString>;
@@ -218,6 +243,17 @@ export declare const sendPaymentSessionNotificationSchema: z.ZodObject<{
     subject: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     html: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     text: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    attachments: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        filename: z.ZodString;
+        contentBase64: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        path: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contentType: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        disposition: z.ZodNullable<z.ZodOptional<z.ZodEnum<{
+            attachment: "attachment";
+            inline: "inline";
+        }>>>;
+        contentId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>>>>;
     data: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     metadata: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     scheduledFor: z.ZodNullable<z.ZodOptional<z.ZodString>>;
@@ -235,6 +271,17 @@ export declare const sendInvoiceNotificationSchema: z.ZodObject<{
     subject: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     html: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     text: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    attachments: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        filename: z.ZodString;
+        contentBase64: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        path: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contentType: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        disposition: z.ZodNullable<z.ZodOptional<z.ZodEnum<{
+            attachment: "attachment";
+            inline: "inline";
+        }>>>;
+        contentId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>>>>;
     data: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     metadata: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     scheduledFor: z.ZodNullable<z.ZodOptional<z.ZodString>>;
@@ -252,6 +299,17 @@ export declare const sendNotificationSchema: z.ZodObject<{
     subject: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     html: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     text: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    attachments: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        filename: z.ZodString;
+        contentBase64: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        path: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contentType: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        disposition: z.ZodNullable<z.ZodOptional<z.ZodEnum<{
+            attachment: "attachment";
+            inline: "inline";
+        }>>>;
+        contentId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>>>>;
     data: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     targetType: z.ZodDefault<z.ZodEnum<{
         other: "other";
@@ -259,9 +317,9 @@ export declare const sendNotificationSchema: z.ZodObject<{
         invoice: "invoice";
         booking_payment_schedule: "booking_payment_schedule";
         booking_guarantee: "booking_guarantee";
-        payment_session: "payment_session";
-        person: "person";
         organization: "organization";
+        person: "person";
+        payment_session: "payment_session";
     }>>;
     targetId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     bookingId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
@@ -272,4 +330,118 @@ export declare const sendNotificationSchema: z.ZodObject<{
     metadata: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     scheduledFor: z.ZodNullable<z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>;
+export declare const bookingDocumentBundleItemSchema: 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>;
+export declare const bookingDocumentBundleSchema: 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>>;
+}, z.core.$strip>;
+export declare const sendBookingDocumentsNotificationSchema: 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";
+    }>>>>;
+}, z.core.$strip>;
+export declare const sendBookingDocumentsNotificationResultSchema: z.ZodObject<{
+    bookingId: z.ZodString;
+    recipient: 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>>;
+    deliveryId: z.ZodString;
+    provider: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    status: z.ZodEnum<{
+        cancelled: "cancelled";
+        pending: "pending";
+        failed: "failed";
+        sent: "sent";
+    }>;
+}, 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;;EAAuC,CAAA;AACxF,eAAO,MAAM,mCAAmC;;;;;EAK9C,CAAA;AAqBF,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;;;;;;;;;;;;;;;iBAMjD,CAAA;AAEF,eAAO,MAAM,qBAAqB;;iBAEhC,CAAA;AAiBF,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;iBAMhD,CAAA;AAED,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;iBAMzC,CAAA;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4BhC,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;;;;;EAK9C,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;;;;;;;;;;;;;;;;iBAMjD,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,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmB1C,CAAA;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGtC,CAAA;AAEF,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;iBAajD,CAAA;AAEF,eAAO,MAAM,4CAA4C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOvD,CAAA"}

package/dist/validation.js

@@ -13,13 +13,28 @@ export const notificationTargetTypeSchema = z.enum([
     "other",
 ]);
 export const notificationReminderStatusSchema = z.enum(["draft", "active", "archived"]);
-export const notificationReminderTargetTypeSchema = z.enum(["booking_payment_schedule"]);
+export const notificationReminderTargetTypeSchema = z.enum(["booking_payment_schedule", "invoice"]);
 export const notificationReminderRunStatusSchema = z.enum([
     "processing",
     "sent",
     "skipped",
     "failed",
 ]);
+export const notificationDocumentTypeSchema = z.enum(["contract", "invoice", "proforma"]);
+export const notificationDocumentSourceSchema = z.enum(["legal", "finance"]);
+export const notificationAttachmentSchema = z
+    .object({
+    filename: z.string().min(1).max(500),
+    contentBase64: z.string().min(1).optional().nullable(),
+    path: z.string().min(1).max(4000).optional().nullable(),
+    contentType: z.string().max(255).optional().nullable(),
+    disposition: z.enum(["attachment", "inline"]).optional().nullable(),
+    contentId: z.string().max(255).optional().nullable(),
+})
+    .refine((value) => Boolean(value.contentBase64 || value.path), {
+    message: "contentBase64 or path is required",
+    path: ["contentBase64"],
+});
 const paginationSchema = z.object({
     limit: z.coerce.number().int().min(1).max(100).default(20),
     offset: z.coerce.number().int().min(0).default(0),
@@ -106,6 +121,7 @@ const transportNotificationCoreSchema = z.object({
     subject: z.string().max(2000).optional().nullable(),
     html: z.string().optional().nullable(),
     text: z.string().optional().nullable(),
+    attachments: z.array(notificationAttachmentSchema).optional().nullable(),
     data: z.record(z.string(), z.unknown()).optional().nullable(),
     metadata: z.record(z.string(), z.unknown()).optional().nullable(),
     scheduledFor: z.string().optional().nullable(),
@@ -127,6 +143,7 @@ export const sendNotificationSchema = z
     subject: z.string().max(2000).optional().nullable(),
     html: z.string().optional().nullable(),
     text: z.string().optional().nullable(),
+    attachments: z.array(notificationAttachmentSchema).optional().nullable(),
     data: z.record(z.string(), z.unknown()).optional().nullable(),
     targetType: notificationTargetTypeSchema.default("other"),
     targetId: z.string().optional().nullable(),
@@ -141,3 +158,49 @@ export const sendNotificationSchema = z
     .refine((value) => Boolean(value.templateId || value.templateSlug || value.subject || value.html || value.text), {
     message: "templateId, templateSlug, or direct content is required",
 });
+export const bookingDocumentBundleItemSchema = z.object({
+    key: z.string().min(1),
+    source: notificationDocumentSourceSchema,
+    documentType: notificationDocumentTypeSchema,
+    bookingId: z.string().min(1),
+    contractId: z.string().optional().nullable(),
+    invoiceId: z.string().optional().nullable(),
+    attachmentId: z.string().optional().nullable(),
+    renditionId: z.string().optional().nullable(),
+    contractStatus: z.string().optional().nullable(),
+    invoiceStatus: z.string().optional().nullable(),
+    name: z.string().min(1),
+    format: z.string().optional().nullable(),
+    mimeType: z.string().optional().nullable(),
+    storageKey: z.string().optional().nullable(),
+    downloadUrl: z.string().url().optional().nullable(),
+    language: z.string().optional().nullable(),
+    metadata: z.record(z.string(), z.unknown()).optional().nullable(),
+    createdAt: z.string().datetime(),
+});
+export const bookingDocumentBundleSchema = z.object({
+    bookingId: z.string().min(1),
+    documents: z.array(bookingDocumentBundleItemSchema),
+});
+export const sendBookingDocumentsNotificationSchema = z.object({
+    templateId: z.string().optional().nullable(),
+    templateSlug: z.string().optional().nullable(),
+    provider: z.string().optional().nullable(),
+    to: z.string().min(1).optional().nullable(),
+    from: z.string().max(500).optional().nullable(),
+    subject: z.string().max(2000).optional().nullable(),
+    html: z.string().optional().nullable(),
+    text: z.string().optional().nullable(),
+    data: z.record(z.string(), z.unknown()).optional().nullable(),
+    metadata: z.record(z.string(), z.unknown()).optional().nullable(),
+    scheduledFor: z.string().optional().nullable(),
+    documentTypes: z.array(notificationDocumentTypeSchema).optional().nullable(),
+});
+export const sendBookingDocumentsNotificationResultSchema = z.object({
+    bookingId: z.string().min(1),
+    recipient: z.string().min(1),
+    documents: z.array(bookingDocumentBundleItemSchema),
+    deliveryId: z.string().min(1),
+    provider: z.string().optional().nullable(),
+    status: notificationDeliveryStatusSchema,
+});

package/package.json

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