@voyantjs/notifications 0.1.1 → 0.3.0

package/dist/providers/local.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/providers/local.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EAErB,MAAM,aAAa,CAAA;AAEpB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yEAAyE;IACzE,QAAQ,CAAC,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAA;IAC7C;;;OAGG;IACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAA;IAC7C,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG,oBAAoB,CAoB5F"}
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/providers/local.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EAErB,MAAM,aAAa,CAAA;AAEpB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yEAAyE;IACzE,QAAQ,CAAC,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAA;IAC7C;;;OAGG;IACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAA;IAC7C,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG,oBAAoB,CAmB5F"}

package/dist/providers/local.js

@@ -8,7 +8,6 @@ export function createLocalProvider(options = {}) {
     const channels = options.channels ?? ["email", "sms"];
     const sink = options.sink ??
         ((payload) => {
-            // biome-ignore lint/suspicious/noConsole: local provider is console-based by design
             console.log(`[notifications:${name}]`, payload);
         });
     let counter = 0;

package/dist/service-deliveries.d.ts

@@ -0,0 +1,153 @@
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import type { NotificationDeliveryListQuery, NotificationService, SendInvoiceNotificationInput, SendNotificationInput, SendPaymentSessionNotificationInput } from "./service-shared.js";
+export declare function listDeliveries(db: PostgresJsDatabase, query: NotificationDeliveryListQuery): Promise<{
+    data: {
+        id: string;
+        templateId: string | null;
+        templateSlug: string | null;
+        targetType: "other" | "booking" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "payment_session" | "person" | "organization";
+        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;
+    }[];
+    total: number;
+    limit: number;
+    offset: number;
+}>;
+export declare function getDeliveryById(db: PostgresJsDatabase, id: string): Promise<{
+    id: string;
+    templateId: string | null;
+    templateSlug: string | null;
+    targetType: "other" | "booking" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "payment_session" | "person" | "organization";
+    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;
+} | null>;
+export declare function sendNotification(db: PostgresJsDatabase, dispatcher: NotificationService, input: SendNotificationInput): Promise<{
+    id: string;
+    templateId: string | null;
+    templateSlug: string | null;
+    targetType: "other" | "booking" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "payment_session" | "person" | "organization";
+    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;
+} | null>;
+export declare function sendPaymentSessionNotification(db: PostgresJsDatabase, dispatcher: NotificationService, sessionId: string, input: SendPaymentSessionNotificationInput): Promise<{
+    id: string;
+    templateId: string | null;
+    templateSlug: string | null;
+    targetType: "other" | "booking" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "payment_session" | "person" | "organization";
+    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;
+} | null>;
+export declare function sendInvoiceNotification(db: PostgresJsDatabase, dispatcher: NotificationService, invoiceId: string, input: SendInvoiceNotificationInput): Promise<{
+    id: string;
+    templateId: string | null;
+    templateSlug: string | null;
+    targetType: "other" | "booking" | "invoice" | "booking_payment_schedule" | "booking_guarantee" | "payment_session" | "person" | "organization";
+    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;
+} | null>;
+//# sourceMappingURL=service-deliveries.d.ts.map

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

@@ -0,0 +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"}

package/dist/service-deliveries.js

@@ -0,0 +1,334 @@
+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 { getTemplateById, getTemplateBySlug } from "./service-templates.js";
+export async function listDeliveries(db, query) {
+    const conditions = [];
+    if (query.channel)
+        conditions.push(eq(notificationDeliveries.channel, query.channel));
+    if (query.provider)
+        conditions.push(eq(notificationDeliveries.provider, query.provider));
+    if (query.status)
+        conditions.push(eq(notificationDeliveries.status, query.status));
+    if (query.templateSlug)
+        conditions.push(eq(notificationDeliveries.templateSlug, query.templateSlug));
+    if (query.targetType)
+        conditions.push(eq(notificationDeliveries.targetType, query.targetType));
+    if (query.targetId)
+        conditions.push(eq(notificationDeliveries.targetId, query.targetId));
+    if (query.bookingId)
+        conditions.push(eq(notificationDeliveries.bookingId, query.bookingId));
+    if (query.invoiceId)
+        conditions.push(eq(notificationDeliveries.invoiceId, query.invoiceId));
+    if (query.paymentSessionId) {
+        conditions.push(eq(notificationDeliveries.paymentSessionId, query.paymentSessionId));
+    }
+    if (query.personId)
+        conditions.push(eq(notificationDeliveries.personId, query.personId));
+    if (query.organizationId) {
+        conditions.push(eq(notificationDeliveries.organizationId, query.organizationId));
+    }
+    const where = buildWhereClause(conditions);
+    return paginate(db
+        .select()
+        .from(notificationDeliveries)
+        .where(where)
+        .limit(query.limit)
+        .offset(query.offset)
+        .orderBy(desc(notificationDeliveries.createdAt)), db.select({ total: sql `count(*)::int` }).from(notificationDeliveries).where(where), query.limit, query.offset);
+}
+export async function getDeliveryById(db, id) {
+    const [row] = await db
+        .select()
+        .from(notificationDeliveries)
+        .where(eq(notificationDeliveries.id, id))
+        .limit(1);
+    return row ?? null;
+}
+export async function sendNotification(db, dispatcher, input) {
+    let template = null;
+    if (input.templateId) {
+        template = await getTemplateById(db, input.templateId);
+    }
+    else if (input.templateSlug) {
+        template = await getTemplateBySlug(db, input.templateSlug);
+    }
+    if ((input.templateId || input.templateSlug) && !template) {
+        throw new NotificationError("Notification template not found");
+    }
+    const data = input.data ?? {};
+    const channel = input.channel ?? template?.channel;
+    if (!channel) {
+        throw new NotificationError("Notification channel is required");
+    }
+    const provider = input.provider ?? template?.provider ?? dispatcher.getProvider(channel)?.name;
+    if (!provider) {
+        throw new NotificationError(`No notification provider available for channel "${channel}"`);
+    }
+    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 [pending] = await db
+        .insert(notificationDeliveries)
+        .values({
+        templateId: template?.id ?? null,
+        templateSlug: template?.slug ?? input.templateSlug ?? null,
+        targetType: input.targetType,
+        targetId: input.targetId ?? null,
+        personId: input.personId ?? null,
+        organizationId: input.organizationId ?? null,
+        bookingId: input.bookingId ?? null,
+        invoiceId: input.invoiceId ?? null,
+        paymentSessionId: input.paymentSessionId ?? null,
+        channel,
+        provider,
+        providerMessageId: null,
+        status: "pending",
+        toAddress: input.to,
+        fromAddress: input.from ?? template?.fromAddress ?? null,
+        subject: subject ?? null,
+        htmlBody: html ?? null,
+        textBody: text ?? null,
+        payloadData: data,
+        metadata: input.metadata ?? null,
+        errorMessage: null,
+        scheduledFor: toTimestamp(input.scheduledFor),
+        sentAt: null,
+        failedAt: null,
+    })
+        .returning();
+    if (!pending) {
+        throw new NotificationError("Failed to create notification delivery");
+    }
+    try {
+        const result = provider === dispatcher.getProvider(channel)?.name
+            ? await dispatcher.send({
+                to: input.to,
+                channel,
+                provider,
+                template: template?.slug ?? input.templateSlug ?? "direct",
+                data,
+                from: input.from ?? template?.fromAddress ?? undefined,
+                subject: subject ?? undefined,
+                html: html ?? undefined,
+                text: text ?? undefined,
+            })
+            : await dispatcher.sendWith(provider, {
+                to: input.to,
+                channel,
+                provider,
+                template: template?.slug ?? input.templateSlug ?? "direct",
+                data,
+                from: input.from ?? template?.fromAddress ?? undefined,
+                subject: subject ?? undefined,
+                html: html ?? undefined,
+                text: text ?? undefined,
+            });
+        const [sent] = await db
+            .update(notificationDeliveries)
+            .set({
+            status: "sent",
+            providerMessageId: result.id ?? null,
+            sentAt: new Date(),
+            errorMessage: null,
+            updatedAt: new Date(),
+        })
+            .where(eq(notificationDeliveries.id, pending.id))
+            .returning();
+        return sent ?? null;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Notification send failed";
+        const [failed] = await db
+            .update(notificationDeliveries)
+            .set({
+            status: "failed",
+            failedAt: new Date(),
+            errorMessage: message,
+            updatedAt: new Date(),
+        })
+            .where(eq(notificationDeliveries.id, pending.id))
+            .returning();
+        throw new NotificationError(failed?.errorMessage ?? message);
+    }
+}
+export async function sendPaymentSessionNotification(db, dispatcher, sessionId, input) {
+    const [session] = await db
+        .select()
+        .from(paymentSessions)
+        .where(eq(paymentSessions.id, sessionId))
+        .limit(1);
+    if (!session) {
+        return null;
+    }
+    const booking = session.bookingId
+        ? ((await db.select().from(bookings).where(eq(bookings.id, session.bookingId)).limit(1))[0] ??
+            null)
+        : null;
+    const invoice = session.invoiceId
+        ? ((await db.select().from(invoices).where(eq(invoices.id, session.invoiceId)).limit(1))[0] ??
+            null)
+        : null;
+    const participants = booking ? await listBookingNotificationParticipants(db, booking.id) : [];
+    const recipient = resolveReminderRecipient(participants);
+    const to = input.to ?? session.payerEmail ?? recipient?.email ?? null;
+    if (!to) {
+        throw new NotificationError("No recipient available for payment session notification");
+    }
+    return sendNotification(db, dispatcher, {
+        templateId: input.templateId ?? null,
+        templateSlug: input.templateSlug ?? null,
+        channel: input.channel,
+        provider: input.provider ?? null,
+        to,
+        from: input.from ?? null,
+        subject: input.subject ?? null,
+        html: input.html ?? null,
+        text: input.text ?? null,
+        data: {
+            paymentSession: {
+                id: session.id,
+                status: session.status,
+                provider: session.provider,
+                currency: session.currency,
+                amountCents: session.amountCents,
+                redirectUrl: session.redirectUrl,
+                returnUrl: session.returnUrl,
+                cancelUrl: session.cancelUrl,
+                expiresAt: session.expiresAt,
+                paymentMethod: session.paymentMethod,
+                externalReference: session.externalReference,
+            },
+            booking: booking
+                ? {
+                    id: booking.id,
+                    bookingNumber: booking.bookingNumber,
+                    startDate: booking.startDate,
+                    endDate: booking.endDate,
+                    sellCurrency: booking.sellCurrency,
+                    sellAmountCents: booking.sellAmountCents,
+                }
+                : null,
+            invoice: invoice
+                ? {
+                    id: invoice.id,
+                    invoiceNumber: invoice.invoiceNumber,
+                    invoiceType: invoice.invoiceType,
+                    status: invoice.status,
+                    currency: invoice.currency,
+                    totalCents: invoice.totalCents,
+                    balanceDueCents: invoice.balanceDueCents,
+                    issueDate: invoice.issueDate,
+                    dueDate: invoice.dueDate,
+                }
+                : null,
+            participant: recipient
+                ? {
+                    firstName: recipient.firstName,
+                    lastName: recipient.lastName,
+                    email: recipient.email,
+                }
+                : null,
+            ...(input.data ?? {}),
+        },
+        targetType: "payment_session",
+        targetId: session.id,
+        bookingId: session.bookingId ?? null,
+        invoiceId: session.invoiceId ?? null,
+        paymentSessionId: session.id,
+        personId: session.payerPersonId ?? booking?.personId ?? null,
+        organizationId: session.payerOrganizationId ?? booking?.organizationId ?? null,
+        metadata: input.metadata ?? null,
+        scheduledFor: input.scheduledFor ?? null,
+    });
+}
+export async function sendInvoiceNotification(db, dispatcher, invoiceId, input) {
+    const [invoice] = await db.select().from(invoices).where(eq(invoices.id, invoiceId)).limit(1);
+    if (!invoice) {
+        return null;
+    }
+    const [booking] = await db
+        .select()
+        .from(bookings)
+        .where(eq(bookings.id, invoice.bookingId))
+        .limit(1);
+    const participants = booking ? await listBookingNotificationParticipants(db, booking.id) : [];
+    const recipient = resolveReminderRecipient(participants);
+    const [latestSession] = await db
+        .select()
+        .from(paymentSessions)
+        .where(eq(paymentSessions.invoiceId, invoice.id))
+        .orderBy(desc(paymentSessions.createdAt))
+        .limit(1);
+    const to = input.to ?? latestSession?.payerEmail ?? recipient?.email ?? null;
+    if (!to) {
+        throw new NotificationError("No recipient available for invoice notification");
+    }
+    return sendNotification(db, dispatcher, {
+        templateId: input.templateId ?? null,
+        templateSlug: input.templateSlug ?? null,
+        channel: input.channel,
+        provider: input.provider ?? null,
+        to,
+        from: input.from ?? null,
+        subject: input.subject ?? null,
+        html: input.html ?? null,
+        text: input.text ?? null,
+        data: {
+            invoice: {
+                id: invoice.id,
+                invoiceNumber: invoice.invoiceNumber,
+                invoiceType: invoice.invoiceType,
+                status: invoice.status,
+                currency: invoice.currency,
+                subtotalCents: invoice.subtotalCents,
+                taxCents: invoice.taxCents,
+                totalCents: invoice.totalCents,
+                paidCents: invoice.paidCents,
+                balanceDueCents: invoice.balanceDueCents,
+                issueDate: invoice.issueDate,
+                dueDate: invoice.dueDate,
+            },
+            booking: booking
+                ? {
+                    id: booking.id,
+                    bookingNumber: booking.bookingNumber,
+                    startDate: booking.startDate,
+                    endDate: booking.endDate,
+                    sellCurrency: booking.sellCurrency,
+                    sellAmountCents: booking.sellAmountCents,
+                }
+                : null,
+            paymentSession: latestSession
+                ? {
+                    id: latestSession.id,
+                    status: latestSession.status,
+                    provider: latestSession.provider,
+                    redirectUrl: latestSession.redirectUrl,
+                    expiresAt: latestSession.expiresAt,
+                    amountCents: latestSession.amountCents,
+                    currency: latestSession.currency,
+                }
+                : null,
+            participant: recipient
+                ? {
+                    firstName: recipient.firstName,
+                    lastName: recipient.lastName,
+                    email: recipient.email,
+                }
+                : null,
+            ...(input.data ?? {}),
+        },
+        targetType: "invoice",
+        targetId: invoice.id,
+        bookingId: invoice.bookingId,
+        invoiceId: invoice.id,
+        paymentSessionId: latestSession?.id ?? null,
+        personId: invoice.personId ?? booking?.personId ?? null,
+        organizationId: invoice.organizationId ?? booking?.organizationId ?? null,
+        metadata: input.metadata ?? null,
+        scheduledFor: input.scheduledFor ?? null,
+    });
+}

package/dist/service-reminders.d.ts

@@ -0,0 +1,4 @@
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import type { NotificationService, ReminderSweepResult, RunDueRemindersInput } from "./service-shared.js";
+export declare function runDueReminders(db: PostgresJsDatabase, dispatcher: NotificationService, input?: RunDueRemindersInput): Promise<ReminderSweepResult>;
+//# sourceMappingURL=service-reminders.d.ts.map

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

@@ -0,0 +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"}