@voyantjs/notifications 0.3.0 → 0.4.0

package/dist/service-reminders.js

@@ -1,8 +1,8 @@
 import { bookingParticipants, bookings } from "@voyantjs/bookings/schema";
-import { bookingPaymentSchedules } from "@voyantjs/finance";
-import { and, desc, eq, or } from "drizzle-orm";
+import { bookingPaymentSchedules, invoices } from "@voyantjs/finance";
+import { and, desc, eq, gt, or } from "drizzle-orm";
 import { notificationReminderRules, notificationReminderRuns } from "./schema.js";
-import { sendNotification } from "./service-deliveries.js";
+import { sendInvoiceNotification, sendNotification } from "./service-deliveries.js";
 import { addUtcDays, buildReminderDedupeKey, resolveReminderRecipient, startOfUtcDay, toDateString, toTimestamp, } from "./service-shared.js";
 async function sendBookingPaymentScheduleReminder(db, dispatcher, rule, schedule, now) {
     const runDate = toDateString(startOfUtcDay(now));
@@ -176,6 +176,151 @@ async function sendBookingPaymentScheduleReminder(db, dispatcher, rule, schedule
         return run ?? null;
     }
 }
+async function sendInvoiceReminder(db, dispatcher, rule, invoice, now) {
+    const runDate = toDateString(startOfUtcDay(now));
+    const dedupeKey = buildReminderDedupeKey(rule.id, invoice.id, runDate);
+    const [existingRun] = await db
+        .select({ id: notificationReminderRuns.id })
+        .from(notificationReminderRuns)
+        .where(eq(notificationReminderRuns.dedupeKey, dedupeKey))
+        .limit(1);
+    if (existingRun) {
+        return null;
+    }
+    const [booking] = await db
+        .select()
+        .from(bookings)
+        .where(eq(bookings.id, invoice.bookingId))
+        .limit(1);
+    if (!booking) {
+        const [run] = await db
+            .insert(notificationReminderRuns)
+            .values({
+            reminderRuleId: rule.id,
+            targetType: "invoice",
+            targetId: invoice.id,
+            dedupeKey,
+            bookingId: invoice.bookingId,
+            personId: invoice.personId ?? null,
+            organizationId: invoice.organizationId ?? null,
+            paymentSessionId: null,
+            notificationDeliveryId: null,
+            status: "skipped",
+            recipient: null,
+            scheduledFor: now,
+            processedAt: now,
+            errorMessage: "Booking not found for invoice reminder",
+            metadata: {
+                dueDate: invoice.dueDate,
+                relativeDaysFromDueDate: rule.relativeDaysFromDueDate,
+                invoiceNumber: invoice.invoiceNumber,
+                invoiceType: invoice.invoiceType,
+            },
+        })
+            .returning();
+        return run ?? null;
+    }
+    const participants = await db
+        .select({
+        id: bookingParticipants.id,
+        firstName: bookingParticipants.firstName,
+        lastName: bookingParticipants.lastName,
+        email: bookingParticipants.email,
+        participantType: bookingParticipants.participantType,
+        isPrimary: bookingParticipants.isPrimary,
+    })
+        .from(bookingParticipants)
+        .where(eq(bookingParticipants.bookingId, booking.id))
+        .orderBy(desc(bookingParticipants.isPrimary), bookingParticipants.createdAt);
+    const recipient = resolveReminderRecipient(participants);
+    const [processingRun] = await db
+        .insert(notificationReminderRuns)
+        .values({
+        reminderRuleId: rule.id,
+        targetType: "invoice",
+        targetId: invoice.id,
+        dedupeKey,
+        bookingId: booking.id,
+        personId: invoice.personId ?? booking.personId ?? null,
+        organizationId: invoice.organizationId ?? booking.organizationId ?? null,
+        paymentSessionId: null,
+        notificationDeliveryId: null,
+        status: "processing",
+        recipient: recipient?.email ?? null,
+        scheduledFor: now,
+        processedAt: now,
+        errorMessage: null,
+        metadata: {
+            dueDate: invoice.dueDate,
+            relativeDaysFromDueDate: rule.relativeDaysFromDueDate,
+            bookingNumber: booking.bookingNumber,
+            invoiceNumber: invoice.invoiceNumber,
+            invoiceType: invoice.invoiceType,
+        },
+    })
+        .onConflictDoNothing({ target: notificationReminderRuns.dedupeKey })
+        .returning();
+    if (!processingRun) {
+        return null;
+    }
+    if (!recipient?.email) {
+        const [run] = await db
+            .update(notificationReminderRuns)
+            .set({
+            status: "skipped",
+            errorMessage: "No participant email available for invoice reminder",
+            processedAt: now,
+            updatedAt: now,
+        })
+            .where(eq(notificationReminderRuns.id, processingRun.id))
+            .returning();
+        return run ?? null;
+    }
+    try {
+        const delivery = await sendInvoiceNotification(db, dispatcher, invoice.id, {
+            templateId: rule.templateId ?? null,
+            templateSlug: rule.templateSlug ?? null,
+            channel: rule.channel,
+            provider: rule.provider ?? null,
+            to: recipient.email,
+            data: {
+                reminderOffsetDays: rule.relativeDaysFromDueDate,
+                reminderRunId: processingRun.id,
+            },
+            metadata: {
+                reminderRuleId: rule.id,
+                reminderRunId: processingRun.id,
+            },
+            scheduledFor: now.toISOString(),
+        });
+        const [run] = await db
+            .update(notificationReminderRuns)
+            .set({
+            notificationDeliveryId: delivery?.id ?? null,
+            status: "sent",
+            processedAt: new Date(),
+            updatedAt: new Date(),
+            errorMessage: null,
+        })
+            .where(eq(notificationReminderRuns.id, processingRun.id))
+            .returning();
+        return run ?? null;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Invoice reminder failed";
+        const [run] = await db
+            .update(notificationReminderRuns)
+            .set({
+            status: "failed",
+            errorMessage: message,
+            processedAt: new Date(),
+            updatedAt: new Date(),
+        })
+            .where(eq(notificationReminderRuns.id, processingRun.id))
+            .returning();
+        return run ?? null;
+    }
+}
 export async function runDueReminders(db, dispatcher, input = {}) {
     const now = toTimestamp(input.now) ?? new Date();
     const today = startOfUtcDay(now);
@@ -192,23 +337,46 @@ export async function runDueReminders(db, dispatcher, input = {}) {
     };
     for (const rule of activeRules) {
         const matchingDueDate = toDateString(addUtcDays(today, -rule.relativeDaysFromDueDate));
-        const schedules = await db
-            .select()
-            .from(bookingPaymentSchedules)
-            .where(and(eq(bookingPaymentSchedules.dueDate, matchingDueDate), or(eq(bookingPaymentSchedules.status, "pending"), eq(bookingPaymentSchedules.status, "due"))))
-            .orderBy(bookingPaymentSchedules.createdAt);
-        for (const schedule of schedules) {
-            const run = await sendBookingPaymentScheduleReminder(db, dispatcher, rule, schedule, now);
-            if (!run) {
-                continue;
+        if (rule.targetType === "booking_payment_schedule") {
+            const schedules = await db
+                .select()
+                .from(bookingPaymentSchedules)
+                .where(and(eq(bookingPaymentSchedules.dueDate, matchingDueDate), or(eq(bookingPaymentSchedules.status, "pending"), eq(bookingPaymentSchedules.status, "due"))))
+                .orderBy(bookingPaymentSchedules.createdAt);
+            for (const schedule of schedules) {
+                const run = await sendBookingPaymentScheduleReminder(db, dispatcher, rule, schedule, now);
+                if (!run) {
+                    continue;
+                }
+                summary.processed += 1;
+                if (run.status === "sent")
+                    summary.sent += 1;
+                if (run.status === "skipped")
+                    summary.skipped += 1;
+                if (run.status === "failed")
+                    summary.failed += 1;
+            }
+            continue;
+        }
+        if (rule.targetType === "invoice") {
+            const dueInvoices = await db
+                .select()
+                .from(invoices)
+                .where(and(eq(invoices.dueDate, matchingDueDate), gt(invoices.balanceDueCents, 0), or(eq(invoices.invoiceType, "invoice"), eq(invoices.invoiceType, "proforma")), or(eq(invoices.status, "sent"), eq(invoices.status, "partially_paid"), eq(invoices.status, "overdue"))))
+                .orderBy(invoices.createdAt);
+            for (const invoice of dueInvoices) {
+                const run = await sendInvoiceReminder(db, dispatcher, rule, invoice, now);
+                if (!run) {
+                    continue;
+                }
+                summary.processed += 1;
+                if (run.status === "sent")
+                    summary.sent += 1;
+                if (run.status === "skipped")
+                    summary.skipped += 1;
+                if (run.status === "failed")
+                    summary.failed += 1;
             }
-            summary.processed += 1;
-            if (run.status === "sent")
-                summary.sent += 1;
-            if (run.status === "skipped")
-                summary.skipped += 1;
-            if (run.status === "failed")
-                summary.failed += 1;
         }
     }
     return summary;

package/dist/service-shared.d.ts

@@ -3,8 +3,8 @@ import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
 import type { SQLWrapper } from "drizzle-orm/sql";
 import type { z } from "zod";
 import type { notificationReminderRules } from "./schema.js";
-import type { NotificationChannel, NotificationPayload, NotificationProvider, NotificationResult } from "./types.js";
-import type { insertNotificationReminderRuleSchema, insertNotificationTemplateSchema, notificationDeliveryListQuerySchema, notificationReminderRuleListQuerySchema, notificationReminderRunListQuerySchema, notificationTemplateListQuerySchema, runDueRemindersSchema, sendInvoiceNotificationSchema, sendNotificationSchema, sendPaymentSessionNotificationSchema, updateNotificationReminderRuleSchema, updateNotificationTemplateSchema } from "./validation.js";
+import type { NotificationAttachment, NotificationChannel, NotificationPayload, NotificationProvider, NotificationResult } from "./types.js";
+import type { bookingDocumentBundleItemSchema, insertNotificationReminderRuleSchema, insertNotificationTemplateSchema, notificationDeliveryListQuerySchema, notificationReminderRuleListQuerySchema, notificationReminderRunListQuerySchema, notificationTemplateListQuerySchema, runDueRemindersSchema, sendBookingDocumentsNotificationSchema, sendInvoiceNotificationSchema, sendNotificationSchema, sendPaymentSessionNotificationSchema, updateNotificationReminderRuleSchema, updateNotificationTemplateSchema } from "./validation.js";
 export type NotificationTemplateListQuery = z.infer<typeof notificationTemplateListQuerySchema>;
 export type NotificationDeliveryListQuery = z.infer<typeof notificationDeliveryListQuerySchema>;
 export type CreateNotificationTemplateInput = z.infer<typeof insertNotificationTemplateSchema>;
@@ -17,6 +17,8 @@ export type UpdateNotificationReminderRuleInput = z.infer<typeof updateNotificat
 export type RunDueRemindersInput = z.infer<typeof runDueRemindersSchema>;
 export type SendPaymentSessionNotificationInput = z.infer<typeof sendPaymentSessionNotificationSchema>;
 export type SendInvoiceNotificationInput = z.infer<typeof sendInvoiceNotificationSchema>;
+export type SendBookingDocumentsNotificationInput = z.infer<typeof sendBookingDocumentsNotificationSchema>;
+export type BookingDocumentBundleItem = z.infer<typeof bookingDocumentBundleItemSchema>;
 export type ReminderSweepResult = {
     processed: number;
     sent: number;
@@ -34,6 +36,13 @@ export interface NotificationService {
     getProvider(channel: NotificationChannel): NotificationProvider | undefined;
 }
 export declare function createNotificationService(providers: ReadonlyArray<NotificationProvider>): NotificationService;
+export declare function summarizeNotificationAttachments(attachments: ReadonlyArray<NotificationAttachment> | null | undefined): {
+    filename: string;
+    path: string | null;
+    contentType: string | null;
+    disposition: "attachment" | "inline" | null;
+    contentId: string | null;
+}[];
 export declare function renderNotificationTemplate(template: string | null | undefined, data: Record<string, unknown>): string | null;
 export declare function toTimestamp(value?: string | null): Date | null;
 export declare function startOfUtcDay(value: Date): Date;

package/dist/service-shared.d.ts.map

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

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"}