@voyantjs/notifications 0.3.1 → 0.4.1

package/dist/service-booking-documents.js

@@ -0,0 +1,261 @@
+import { bookings } from "@voyantjs/bookings/schema";
+import { invoiceRenditions, invoices } from "@voyantjs/finance/schema";
+import { contractAttachments, contracts } from "@voyantjs/legal/contracts";
+import { and, desc, eq, ne, or } from "drizzle-orm";
+import { sendNotification } from "./service-deliveries.js";
+import { listBookingNotificationParticipants, resolveReminderRecipient } from "./service-shared.js";
+function getMetadataRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return null;
+    }
+    return value;
+}
+function getMetadataString(metadata, keys) {
+    if (!metadata) {
+        return null;
+    }
+    for (const key of keys) {
+        const value = metadata[key];
+        if (typeof value === "string" && value.length > 0) {
+            return value;
+        }
+    }
+    return null;
+}
+function createDefaultAttachmentFromDocument(document) {
+    if (!document.downloadUrl) {
+        return null;
+    }
+    return {
+        filename: document.name,
+        path: document.downloadUrl,
+        contentType: document.mimeType ?? undefined,
+    };
+}
+function buildDefaultDocumentMessage(booking, documents) {
+    const label = booking.bookingNumber || booking.id;
+    const listText = documents.map((document) => `- ${document.name}`).join("\n");
+    const listHtml = documents.map((document) => `<li>${document.name}</li>`).join("");
+    return {
+        subject: `Booking ${label} documents`,
+        text: `Your booking documents are attached.\n\nBooking: ${label}\n\n${listText}`,
+        html: `<p>Your booking documents are attached.</p><p><strong>Booking:</strong> ${label}</p><ul>${listHtml}</ul>`,
+    };
+}
+async function listLegalBookingDocuments(db, bookingId) {
+    const contractRows = await db
+        .select()
+        .from(contracts)
+        .where(and(eq(contracts.bookingId, bookingId), eq(contracts.scope, "customer"), ne(contracts.status, "void")))
+        .orderBy(desc(contracts.createdAt));
+    if (contractRows.length === 0) {
+        return [];
+    }
+    const attachmentRows = await db
+        .select()
+        .from(contractAttachments)
+        .where(and(eq(contractAttachments.kind, "document"), or(...contractRows.map((contract) => eq(contractAttachments.contractId, contract.id)))))
+        .orderBy(desc(contractAttachments.createdAt));
+    const bestAttachmentByContractId = new Map();
+    for (const attachment of attachmentRows) {
+        if (!bestAttachmentByContractId.has(attachment.contractId)) {
+            bestAttachmentByContractId.set(attachment.contractId, attachment);
+        }
+    }
+    return contractRows.flatMap((contract) => {
+        const attachment = bestAttachmentByContractId.get(contract.id);
+        if (!attachment) {
+            return [];
+        }
+        const metadata = getMetadataRecord(attachment.metadata);
+        return [
+            {
+                key: `legal:${attachment.id}`,
+                source: "legal",
+                documentType: "contract",
+                bookingId,
+                contractId: contract.id,
+                invoiceId: null,
+                attachmentId: attachment.id,
+                renditionId: null,
+                contractStatus: contract.status,
+                invoiceStatus: null,
+                name: attachment.name,
+                format: attachment.mimeType === "application/pdf" ? "pdf" : null,
+                mimeType: attachment.mimeType ?? null,
+                storageKey: attachment.storageKey ?? null,
+                downloadUrl: getMetadataString(metadata, ["url", "downloadUrl"]),
+                language: contract.language ?? null,
+                metadata,
+                createdAt: attachment.createdAt.toISOString(),
+            },
+        ];
+    });
+}
+function compareInvoiceRenditions(left, right) {
+    const formatRank = new Map([
+        ["pdf", 0],
+        ["html", 1],
+        ["json", 2],
+        ["xml", 3],
+    ]);
+    const leftRank = formatRank.get(left.format) ?? Number.MAX_SAFE_INTEGER;
+    const rightRank = formatRank.get(right.format) ?? Number.MAX_SAFE_INTEGER;
+    if (leftRank !== rightRank) {
+        return leftRank - rightRank;
+    }
+    return right.createdAt.getTime() - left.createdAt.getTime();
+}
+async function listFinanceBookingDocuments(db, bookingId) {
+    const invoiceRows = await db
+        .select()
+        .from(invoices)
+        .where(and(eq(invoices.bookingId, bookingId), ne(invoices.status, "void")))
+        .orderBy(desc(invoices.createdAt));
+    if (invoiceRows.length === 0) {
+        return [];
+    }
+    const renditionRows = await db
+        .select()
+        .from(invoiceRenditions)
+        .where(and(eq(invoiceRenditions.status, "ready"), or(...invoiceRows.map((invoice) => eq(invoiceRenditions.invoiceId, invoice.id)))))
+        .orderBy(desc(invoiceRenditions.createdAt));
+    const bestRenditionByInvoiceId = new Map();
+    for (const rendition of renditionRows) {
+        const existing = bestRenditionByInvoiceId.get(rendition.invoiceId);
+        if (!existing || compareInvoiceRenditions(rendition, existing) < 0) {
+            bestRenditionByInvoiceId.set(rendition.invoiceId, rendition);
+        }
+    }
+    return invoiceRows.flatMap((invoice) => {
+        const rendition = bestRenditionByInvoiceId.get(invoice.id);
+        if (!rendition) {
+            return [];
+        }
+        const metadata = getMetadataRecord(rendition.metadata);
+        const format = rendition.format;
+        const extension = format === "pdf" ? "pdf" : format;
+        return [
+            {
+                key: `finance:${rendition.id}`,
+                source: "finance",
+                documentType: invoice.invoiceType === "proforma" ? "proforma" : "invoice",
+                bookingId,
+                contractId: null,
+                invoiceId: invoice.id,
+                attachmentId: null,
+                renditionId: rendition.id,
+                contractStatus: null,
+                invoiceStatus: invoice.status,
+                name: `${invoice.invoiceNumber}.${extension}`,
+                format,
+                mimeType: format === "pdf"
+                    ? "application/pdf"
+                    : format === "html"
+                        ? "text/html"
+                        : format === "json"
+                            ? "application/json"
+                            : "application/xml",
+                storageKey: rendition.storageKey ?? null,
+                downloadUrl: getMetadataString(metadata, ["url", "downloadUrl"]),
+                language: rendition.language ?? invoice.language ?? null,
+                metadata,
+                createdAt: rendition.createdAt.toISOString(),
+            },
+        ];
+    });
+}
+export const bookingDocumentNotificationsService = {
+    async listBookingDocumentBundle(db, bookingId) {
+        const [booking] = await db.select().from(bookings).where(eq(bookings.id, bookingId)).limit(1);
+        if (!booking) {
+            return null;
+        }
+        const [legalDocuments, financeDocuments] = await Promise.all([
+            listLegalBookingDocuments(db, bookingId),
+            listFinanceBookingDocuments(db, bookingId),
+        ]);
+        return {
+            bookingId,
+            documents: [...legalDocuments, ...financeDocuments],
+        };
+    },
+    async sendBookingDocumentsNotification(db, dispatcher, bookingId, input, runtime = {}) {
+        const [booking] = await db.select().from(bookings).where(eq(bookings.id, bookingId)).limit(1);
+        if (!booking) {
+            return { status: "not_found" };
+        }
+        const bundle = await this.listBookingDocumentBundle(db, bookingId);
+        const requestedTypes = new Set(input.documentTypes ?? ["contract", "invoice", "proforma"]);
+        const documents = (bundle?.documents ?? []).filter((document) => requestedTypes.has(document.documentType));
+        if (documents.length === 0) {
+            return { status: "no_documents" };
+        }
+        const participants = await listBookingNotificationParticipants(db, bookingId);
+        const recipient = resolveReminderRecipient(participants);
+        const to = input.to ?? recipient?.email ?? null;
+        if (!to) {
+            return { status: "no_recipient" };
+        }
+        const attachmentResolver = runtime.attachmentResolver ??
+            (async (document) => createDefaultAttachmentFromDocument(document));
+        const attachments = (await Promise.all(documents.map((document) => attachmentResolver(document)))).filter((attachment) => Boolean(attachment));
+        if (attachments.length === 0) {
+            return { status: "no_attachments" };
+        }
+        const defaults = buildDefaultDocumentMessage(booking, documents);
+        const delivery = await sendNotification(db, dispatcher, {
+            templateId: input.templateId ?? null,
+            templateSlug: input.templateSlug ?? null,
+            channel: "email",
+            provider: input.provider ?? null,
+            to,
+            from: input.from ?? null,
+            subject: input.subject ?? defaults.subject,
+            html: input.html ?? defaults.html,
+            text: input.text ?? defaults.text,
+            attachments,
+            data: {
+                booking: {
+                    id: booking.id,
+                    bookingNumber: booking.bookingNumber,
+                    status: booking.status,
+                    sellCurrency: booking.sellCurrency,
+                    sellAmountCents: booking.sellAmountCents,
+                    startDate: booking.startDate,
+                    endDate: booking.endDate,
+                },
+                participant: recipient
+                    ? {
+                        firstName: recipient.firstName,
+                        lastName: recipient.lastName,
+                        email: recipient.email,
+                    }
+                    : null,
+                documents,
+                ...(input.data ?? {}),
+            },
+            targetType: "booking",
+            targetId: booking.id,
+            bookingId: booking.id,
+            personId: booking.personId ?? null,
+            organizationId: booking.organizationId ?? null,
+            metadata: {
+                bookingDocumentKeys: documents.map((document) => document.key),
+                ...(input.metadata ?? {}),
+            },
+            scheduledFor: input.scheduledFor ?? null,
+        });
+        if (!delivery) {
+            return { status: "send_failed" };
+        }
+        return {
+            status: "sent",
+            bookingId: booking.id,
+            recipient: to,
+            documents,
+            delivery,
+        };
+    },
+};
+export { createDefaultAttachmentFromDocument as createDefaultBookingDocumentAttachment };

package/dist/service-deliveries.d.ts

@@ -5,7 +5,7 @@ export declare function listDeliveries(db: PostgresJsDatabase, query: Notificati
         id: string;
         templateId: string | null;
         templateSlug: string | null;
-        targetType: "other" | "booking" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "payment_session" | "person" | "organization";
+        targetType: "other" | "booking" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "organization" | "person" | "payment_session";
         targetId: string | null;
         personId: string | null;
         organizationId: string | null;
@@ -38,7 +38,7 @@ export declare function getDeliveryById(db: PostgresJsDatabase, id: string): Pro
     id: string;
     templateId: string | null;
     templateSlug: string | null;
-    targetType: "other" | "booking" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "payment_session" | "person" | "organization";
+    targetType: "other" | "booking" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "organization" | "person" | "payment_session";
     targetId: string | null;
     personId: string | null;
     organizationId: string | null;
@@ -67,7 +67,7 @@ export declare function sendNotification(db: PostgresJsDatabase, dispatcher: Not
     id: string;
     templateId: string | null;
     templateSlug: string | null;
-    targetType: "other" | "booking" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "payment_session" | "person" | "organization";
+    targetType: "other" | "booking" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "organization" | "person" | "payment_session";
     targetId: string | null;
     personId: string | null;
     organizationId: string | null;
@@ -96,7 +96,7 @@ export declare function sendPaymentSessionNotification(db: PostgresJsDatabase, d
     id: string;
     templateId: string | null;
     templateSlug: string | null;
-    targetType: "other" | "booking" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "payment_session" | "person" | "organization";
+    targetType: "other" | "booking" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "organization" | "person" | "payment_session";
     targetId: string | null;
     personId: string | null;
     organizationId: string | null;
@@ -125,7 +125,7 @@ export declare function sendInvoiceNotification(db: PostgresJsDatabase, dispatch
     id: string;
     templateId: string | null;
     templateSlug: string | null;
-    targetType: "other" | "booking" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "payment_session" | "person" | "organization";
+    targetType: "other" | "booking" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "organization" | "person" | "payment_session";
     targetId: string | null;
     personId: string | null;
     organizationId: string | null;

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

@@ -1 +1 @@
-{"version":3,"file":"service-deliveries.d.ts","sourceRoot":"","sources":["../src/service-deliveries.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAGjE,OAAO,KAAK,EACV,6BAA6B,EAC7B,mBAAmB,EACnB,4BAA4B,EAC5B,qBAAqB,EACrB,mCAAmC,EACpC,MAAM,qBAAqB,CAAA;AAY5B,wBAAsB,cAAc,CAAC,EAAE,EAAE,kBAAkB,EAAE,KAAK,EAAE,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgChG;AAED,wBAAsB,eAAe,CAAC,EAAE,EAAE,kBAAkB,EAAE,EAAE,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAOvE;AAED,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,kBAAkB,EACtB,UAAU,EAAE,mBAAmB,EAC/B,KAAK,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAmH7B;AAED,wBAAsB,8BAA8B,CAClD,EAAE,EAAE,kBAAkB,EACtB,UAAU,EAAE,mBAAmB,EAC/B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA8F3C;AAED,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,kBAAkB,EACtB,UAAU,EAAE,mBAAmB,EAC/B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA4FpC"}
+{"version":3,"file":"service-deliveries.d.ts","sourceRoot":"","sources":["../src/service-deliveries.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAGjE,OAAO,KAAK,EACV,6BAA6B,EAC7B,mBAAmB,EACnB,4BAA4B,EAC5B,qBAAqB,EACrB,mCAAmC,EACpC,MAAM,qBAAqB,CAAA;AAyC5B,wBAAsB,cAAc,CAAC,EAAE,EAAE,kBAAkB,EAAE,KAAK,EAAE,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgChG;AAED,wBAAsB,eAAe,CAAC,EAAE,EAAE,kBAAkB,EAAE,EAAE,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAOvE;AAED,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,kBAAkB,EACtB,UAAU,EAAE,mBAAmB,EAC/B,KAAK,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA8H7B;AAED,wBAAsB,8BAA8B,CAClD,EAAE,EAAE,kBAAkB,EACtB,UAAU,EAAE,mBAAmB,EAC/B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA8F3C;AAED,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,kBAAkB,EACtB,UAAU,EAAE,mBAAmB,EAC/B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA4FpC"}

package/dist/service-deliveries.js

@@ -2,8 +2,21 @@ import { bookings } from "@voyantjs/bookings/schema";
 import { invoices, paymentSessions } from "@voyantjs/finance";
 import { desc, eq, sql } from "drizzle-orm";
 import { notificationDeliveries } from "./schema.js";
-import { buildWhereClause, listBookingNotificationParticipants, NotificationError, paginate, renderNotificationTemplate, resolveReminderRecipient, toTimestamp, } from "./service-shared.js";
+import { buildWhereClause, listBookingNotificationParticipants, NotificationError, paginate, renderNotificationTemplate, resolveReminderRecipient, summarizeNotificationAttachments, toTimestamp, } from "./service-shared.js";
 import { getTemplateById, getTemplateBySlug } from "./service-templates.js";
+function normalizeAttachments(attachments) {
+    if (!attachments || attachments.length === 0) {
+        return undefined;
+    }
+    return attachments.map((attachment) => ({
+        filename: attachment.filename,
+        ...(attachment.contentBase64 ? { contentBase64: attachment.contentBase64 } : {}),
+        ...(attachment.path ? { path: attachment.path } : {}),
+        ...(attachment.contentType ? { contentType: attachment.contentType } : {}),
+        ...(attachment.disposition ? { disposition: attachment.disposition } : {}),
+        ...(attachment.contentId ? { contentId: attachment.contentId } : {}),
+    }));
+}
 export async function listDeliveries(db, query) {
     const conditions = [];
     if (query.channel)
@@ -70,6 +83,8 @@ export async function sendNotification(db, dispatcher, input) {
     const subject = input.subject ?? renderNotificationTemplate(template?.subjectTemplate, data);
     const html = input.html ?? renderNotificationTemplate(template?.htmlTemplate, data);
     const text = input.text ?? renderNotificationTemplate(template?.textTemplate, data);
+    const attachments = normalizeAttachments(input.attachments);
+    const attachmentSummary = summarizeNotificationAttachments(attachments);
     const [pending] = await db
         .insert(notificationDeliveries)
         .values({
@@ -92,7 +107,13 @@ export async function sendNotification(db, dispatcher, input) {
         htmlBody: html ?? null,
         textBody: text ?? null,
         payloadData: data,
-        metadata: input.metadata ?? null,
+        metadata: (input.metadata ?? null) || attachmentSummary.length > 0
+            ? {
+                ...(input.metadata ?? {}),
+                attachmentCount: attachmentSummary.length,
+                attachments: attachmentSummary,
+            }
+            : null,
         errorMessage: null,
         scheduledFor: toTimestamp(input.scheduledFor),
         sentAt: null,
@@ -114,6 +135,7 @@ export async function sendNotification(db, dispatcher, input) {
                 subject: subject ?? undefined,
                 html: html ?? undefined,
                 text: text ?? undefined,
+                attachments,
             })
             : await dispatcher.sendWith(provider, {
                 to: input.to,
@@ -125,6 +147,7 @@ export async function sendNotification(db, dispatcher, input) {
                 subject: subject ?? undefined,
                 html: html ?? undefined,
                 text: text ?? undefined,
+                attachments,
             });
         const [sent] = await db
             .update(notificationDeliveries)

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

@@ -1 +1 @@
-{"version":3,"file":"service-reminders.d.ts","sourceRoot":"","sources":["../src/service-reminders.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAIjE,OAAO,KAAK,EAGV,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,qBAAqB,CAAA;AAoM5B,wBAAsB,eAAe,CACnC,EAAE,EAAE,kBAAkB,EACtB,UAAU,EAAE,mBAAmB,EAC/B,KAAK,GAAE,oBAAyB,gCA+CjC"}
+{"version":3,"file":"service-reminders.d.ts","sourceRoot":"","sources":["../src/service-reminders.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAIjE,OAAO,KAAK,EAGV,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,qBAAqB,CAAA;AAoW5B,wBAAsB,eAAe,CACnC,EAAE,EAAE,kBAAkB,EACtB,UAAU,EAAE,mBAAmB,EAC/B,KAAK,GAAE,oBAAyB,gCAiFjC"}

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":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAEhE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EACV,oCAAoC,EACpC,gCAAgC,EAChC,mCAAmC,EACnC,uCAAuC,EACvC,sCAAsC,EACtC,mCAAmC,EACnC,qBAAqB,EACrB,6BAA6B,EAC7B,sBAAsB,EACtB,oCAAoC,EACpC,oCAAoC,EACpC,gCAAgC,EACjC,MAAM,iBAAiB,CAAA;AAExB,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAA;AAC/F,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAA;AAC/F,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAA;AAC9F,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAA;AAC9F,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAC1E,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,uCAAuC,CAC/C,CAAA;AACD,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CACpD,OAAO,sCAAsC,CAC9C,CAAA;AACD,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CACvD,OAAO,oCAAoC,CAC5C,CAAA;AACD,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CACvD,OAAO,oCAAoC,CAC5C,CAAA;AACD,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AACxE,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CACvD,OAAO,oCAAoC,CAC5C,CAAA;AACD,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAExF,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,2BAA2B,GAAG,OAAO,yBAAyB,CAAC,YAAY,CAAA;AACvF,MAAM,MAAM,yBAAyB,GAAG,OAAO,uBAAuB,CAAC,YAAY,CAAA;AAEnF,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAC/D,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACzF,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,oBAAoB,GAAG,SAAS,CAAA;CAC5E;AAED,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,aAAa,CAAC,oBAAoB,CAAC,GAC7C,mBAAmB,CAkCrB;AAmBD,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,iBAM9B;AAED,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,eAEhD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,QAExC;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,QAEnD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,UAEvC;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,UAEvF;AAED,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,KAAK,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,SAAS,EAAE,OAAO,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAC;WALO,MAAM,GAAG,IAAI;eACT,OAAO;qBACD,MAAM;eACZ,MAAM;cACP,MAAM;SAsBnB;AAED,wBAAsB,mCAAmC,CACvD,EAAE,EAAE,kBAAkB,EACtB,SAAS,EAAE,MAAM;;;;;;;KAclB;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,WAAW,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,EACzB,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,EAC/C,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM;;;;;GASf;AAED,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,UAAU,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,GAAG,SAAS,CAAC,kDAGtF"}
+{"version":3,"file":"service-shared.d.ts","sourceRoot":"","sources":["../src/service-shared.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAEhE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EACV,+BAA+B,EAC/B,oCAAoC,EACpC,gCAAgC,EAChC,mCAAmC,EACnC,uCAAuC,EACvC,sCAAsC,EACtC,mCAAmC,EACnC,qBAAqB,EACrB,sCAAsC,EACtC,6BAA6B,EAC7B,sBAAsB,EACtB,oCAAoC,EACpC,oCAAoC,EACpC,gCAAgC,EACjC,MAAM,iBAAiB,CAAA;AAExB,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAA;AAC/F,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAA;AAC/F,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAA;AAC9F,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAA;AAC9F,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAC1E,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,uCAAuC,CAC/C,CAAA;AACD,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CACpD,OAAO,sCAAsC,CAC9C,CAAA;AACD,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CACvD,OAAO,oCAAoC,CAC5C,CAAA;AACD,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CACvD,OAAO,oCAAoC,CAC5C,CAAA;AACD,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AACxE,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CACvD,OAAO,oCAAoC,CAC5C,CAAA;AACD,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAA;AACxF,MAAM,MAAM,qCAAqC,GAAG,CAAC,CAAC,KAAK,CACzD,OAAO,sCAAsC,CAC9C,CAAA;AACD,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AAEvF,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,2BAA2B,GAAG,OAAO,yBAAyB,CAAC,YAAY,CAAA;AACvF,MAAM,MAAM,yBAAyB,GAAG,OAAO,uBAAuB,CAAC,YAAY,CAAA;AAEnF,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAC/D,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACzF,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,oBAAoB,GAAG,SAAS,CAAA;CAC5E;AAED,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,aAAa,CAAC,oBAAoB,CAAC,GAC7C,mBAAmB,CAkCrB;AAED,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,aAAa,CAAC,sBAAsB,CAAC,GAAG,IAAI,GAAG,SAAS;;;;;;IAatE;AAmBD,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,iBAM9B;AAED,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,eAEhD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,QAExC;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,QAEnD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,UAEvC;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,UAEvF;AAED,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,KAAK,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,SAAS,EAAE,OAAO,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAC;WALO,MAAM,GAAG,IAAI;eACT,OAAO;qBACD,MAAM;eACZ,MAAM;cACP,MAAM;SAsBnB;AAED,wBAAsB,mCAAmC,CACvD,EAAE,EAAE,kBAAkB,EACtB,SAAS,EAAE,MAAM;;;;;;;KAclB;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,WAAW,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,EACzB,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,EAC/C,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM;;;;;GASf;AAED,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,UAAU,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,GAAG,SAAS,CAAC,kDAGtF"}