@voyantjs/notifications 0.2.0 → 0.3.1

package/dist/index.d.ts

@@ -1,11 +1,13 @@
 import type { HonoModule } from "@voyantjs/hono/module";
 import { createNotificationsRoutes } from "./routes.js";
 export type { DefaultNotificationProviderOptions } from "./provider-resolution.js";
-export { createDefaultNotificationProviders, createResendProviderFromEnv, } from "./provider-resolution.js";
+export { createDefaultNotificationProviders, createResendProviderFromEnv, createTwilioProviderFromEnv, } from "./provider-resolution.js";
 export type { LocalProviderOptions } from "./providers/local.js";
 export { createLocalProvider } from "./providers/local.js";
 export type { ResendFetch, ResendProviderOptions, ResendRenderedEmail, } from "./providers/resend.js";
 export { createResendProvider } from "./providers/resend.js";
+export type { TwilioFetch, TwilioProviderOptions, TwilioRenderedSms } from "./providers/twilio.js";
+export { createTwilioProvider } from "./providers/twilio.js";
 export { createNotificationsRoutes } from "./routes.js";
 export type { NewNotificationDelivery, NewNotificationReminderRule, NewNotificationReminderRun, NewNotificationTemplate, NotificationDelivery, NotificationReminderRule, NotificationReminderRun, NotificationsHonoModule, NotificationTemplate, } from "./schema.js";
 export { notificationChannelEnum, notificationDeliveries, notificationDeliveryStatusEnum, notificationReminderRules, notificationReminderRunStatusEnum, notificationReminderRuns, notificationReminderStatusEnum, notificationReminderTargetTypeEnum, notificationsModule, notificationTargetTypeEnum, notificationTemplateStatusEnum, notificationTemplates, } from "./schema.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAEvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AAGvD,YAAY,EAAE,kCAAkC,EAAE,MAAM,0BAA0B,CAAA;AAClF,OAAO,EACL,kCAAkC,EAClC,2BAA2B,GAC5B,MAAM,0BAA0B,CAAA;AACjC,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,YAAY,EACV,WAAW,EACX,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AACvD,YAAY,EACV,uBAAuB,EACvB,2BAA2B,EAC3B,0BAA0B,EAC1B,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,8BAA8B,EAC9B,yBAAyB,EACzB,iCAAiC,EACjC,wBAAwB,EACxB,8BAA8B,EAC9B,kCAAkC,EAClC,mBAAmB,EACnB,0BAA0B,EAC1B,8BAA8B,EAC9B,qBAAqB,GACtB,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AACvD,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAA;AAC/D,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,oCAAoC,EACpC,gCAAgC,EAChC,yBAAyB,EACzB,mCAAmC,EACnC,gCAAgC,EAChC,uCAAuC,EACvC,sCAAsC,EACtC,mCAAmC,EACnC,gCAAgC,EAChC,oCAAoC,EACpC,4BAA4B,EAC5B,mCAAmC,EACnC,gCAAgC,EAChC,qBAAqB,EACrB,6BAA6B,EAC7B,sBAAsB,EACtB,oCAAoC,EACpC,oCAAoC,EACpC,gCAAgC,GACjC,MAAM,iBAAiB,CAAA;AAExB,wBAAgB,6BAA6B,CAC3C,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC,CAAC,GACxD,UAAU,CAKZ"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAEvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AAGvD,YAAY,EAAE,kCAAkC,EAAE,MAAM,0BAA0B,CAAA;AAClF,OAAO,EACL,kCAAkC,EAClC,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,0BAA0B,CAAA;AACjC,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,YAAY,EACV,WAAW,EACX,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAC5D,YAAY,EAAE,WAAW,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAClG,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AACvD,YAAY,EACV,uBAAuB,EACvB,2BAA2B,EAC3B,0BAA0B,EAC1B,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,8BAA8B,EAC9B,yBAAyB,EACzB,iCAAiC,EACjC,wBAAwB,EACxB,8BAA8B,EAC9B,kCAAkC,EAClC,mBAAmB,EACnB,0BAA0B,EAC1B,8BAA8B,EAC9B,qBAAqB,GACtB,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AACvD,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAA;AAC/D,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,oCAAoC,EACpC,gCAAgC,EAChC,yBAAyB,EACzB,mCAAmC,EACnC,gCAAgC,EAChC,uCAAuC,EACvC,sCAAsC,EACtC,mCAAmC,EACnC,gCAAgC,EAChC,oCAAoC,EACpC,4BAA4B,EAC5B,mCAAmC,EACnC,gCAAgC,EAChC,qBAAqB,EACrB,6BAA6B,EAC7B,sBAAsB,EACtB,oCAAoC,EACpC,oCAAoC,EACpC,gCAAgC,GACjC,MAAM,iBAAiB,CAAA;AAExB,wBAAgB,6BAA6B,CAC3C,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC,CAAC,GACxD,UAAU,CAKZ"}

package/dist/index.js

@@ -1,8 +1,9 @@
 import { createNotificationsRoutes } from "./routes.js";
 import { notificationsModule } from "./schema.js";
-export { createDefaultNotificationProviders, createResendProviderFromEnv, } from "./provider-resolution.js";
+export { createDefaultNotificationProviders, createResendProviderFromEnv, createTwilioProviderFromEnv, } from "./provider-resolution.js";
 export { createLocalProvider } from "./providers/local.js";
 export { createResendProvider } from "./providers/resend.js";
+export { createTwilioProvider } from "./providers/twilio.js";
 export { createNotificationsRoutes } from "./routes.js";
 export { notificationChannelEnum, notificationDeliveries, notificationDeliveryStatusEnum, notificationReminderRules, notificationReminderRunStatusEnum, notificationReminderRuns, notificationReminderStatusEnum, notificationReminderTargetTypeEnum, notificationsModule, notificationTargetTypeEnum, notificationTemplateStatusEnum, notificationTemplates, } from "./schema.js";
 export { createNotificationService, NotificationError, notificationsService, renderNotificationTemplate, } from "./service.js";

package/dist/provider-resolution.d.ts

@@ -2,13 +2,18 @@ import type { NotificationProvider } from "./types.js";
 type NotificationProviderEnv = {
     RESEND_API_KEY?: unknown;
     EMAIL_FROM?: unknown;
+    TWILIO_ACCOUNT_SID?: unknown;
+    TWILIO_AUTH_TOKEN?: unknown;
+    TWILIO_SMS_FROM?: unknown;
 };
 export interface DefaultNotificationProviderOptions {
     includeLocal?: boolean;
     emailProvider?: "resend" | null;
+    smsProvider?: "twilio" | null;
     customProviders?: ReadonlyArray<NotificationProvider>;
 }
 export declare function createResendProviderFromEnv(env: NotificationProviderEnv): NotificationProvider | null;
+export declare function createTwilioProviderFromEnv(env: NotificationProviderEnv): NotificationProvider | null;
 export declare function createDefaultNotificationProviders(env: NotificationProviderEnv, options?: DefaultNotificationProviderOptions): NotificationProvider[];
 export {};
 //# sourceMappingURL=provider-resolution.d.ts.map

package/dist/provider-resolution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-resolution.d.ts","sourceRoot":"","sources":["../src/provider-resolution.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEtD,KAAK,uBAAuB,GAAG;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED,MAAM,WAAW,kCAAkC;IACjD,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,aAAa,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC/B,eAAe,CAAC,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAA;CACtD;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,uBAAuB,+BAcvE;AAED,wBAAgB,kCAAkC,CAChD,GAAG,EAAE,uBAAuB,EAC5B,OAAO,GAAE,kCAAuC,0BAoBjD"}
+{"version":3,"file":"provider-resolution.d.ts","sourceRoot":"","sources":["../src/provider-resolution.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEtD,KAAK,uBAAuB,GAAG;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED,MAAM,WAAW,kCAAkC;IACjD,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,aAAa,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC/B,WAAW,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC7B,eAAe,CAAC,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAA;CACtD;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,uBAAuB,+BAcvE;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,uBAAuB,+BAiBvE;AAED,wBAAgB,kCAAkC,CAChD,GAAG,EAAE,uBAAuB,EAC5B,OAAO,GAAE,kCAAuC,0BA2BjD"}

package/dist/provider-resolution.js

@@ -1,5 +1,6 @@
 import { createLocalProvider } from "./providers/local.js";
 import { createResendProvider } from "./providers/resend.js";
+import { createTwilioProvider } from "./providers/twilio.js";
 export function createResendProviderFromEnv(env) {
     if (typeof env.RESEND_API_KEY === "string" &&
         env.RESEND_API_KEY &&
@@ -12,6 +13,21 @@ export function createResendProviderFromEnv(env) {
     }
     return null;
 }
+export function createTwilioProviderFromEnv(env) {
+    if (typeof env.TWILIO_ACCOUNT_SID === "string" &&
+        env.TWILIO_ACCOUNT_SID &&
+        typeof env.TWILIO_AUTH_TOKEN === "string" &&
+        env.TWILIO_AUTH_TOKEN &&
+        typeof env.TWILIO_SMS_FROM === "string" &&
+        env.TWILIO_SMS_FROM) {
+        return createTwilioProvider({
+            accountSid: env.TWILIO_ACCOUNT_SID,
+            authToken: env.TWILIO_AUTH_TOKEN,
+            from: env.TWILIO_SMS_FROM,
+        });
+    }
+    return null;
+}
 export function createDefaultNotificationProviders(env, options = {}) {
     const providers = [];
     if (options.includeLocal !== false) {
@@ -23,6 +39,12 @@ export function createDefaultNotificationProviders(env, options = {}) {
             providers.push(resend);
         }
     }
+    if (options.smsProvider === "twilio") {
+        const twilio = createTwilioProviderFromEnv(env);
+        if (twilio) {
+            providers.push(twilio);
+        }
+    }
     if (options.customProviders?.length) {
         providers.push(...options.customProviders);
     }

package/dist/providers/twilio.d.ts

@@ -0,0 +1,24 @@
+import type { NotificationProvider } from "../types.js";
+export type TwilioFetch = (input: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body: string;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    json: () => Promise<unknown>;
+    text: () => Promise<string>;
+}>;
+export interface TwilioRenderedSms {
+    text: string;
+}
+export interface TwilioProviderOptions {
+    accountSid: string;
+    authToken: string;
+    from: string;
+    baseUrl?: string;
+    fetch?: TwilioFetch;
+    renderTemplate?: (template: string, data: unknown) => Promise<TwilioRenderedSms> | TwilioRenderedSms;
+}
+export declare function createTwilioProvider(options: TwilioProviderOptions): NotificationProvider;
+//# sourceMappingURL=twilio.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"twilio.d.ts","sourceRoot":"","sources":["../../src/providers/twilio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAsB,MAAM,aAAa,CAAA;AAE3E,MAAM,MAAM,WAAW,GAAG,CACxB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;IACJ,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,IAAI,EAAE,MAAM,CAAA;CACb,KACE,OAAO,CAAC;IACX,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IAC5B,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;CAC5B,CAAC,CAAA;AAEF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,cAAc,CAAC,EAAE,CACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,KACV,OAAO,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,CAAA;CACpD;AA0BD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,oBAAoB,CA4CzF"}

package/dist/providers/twilio.js

@@ -0,0 +1,48 @@
+function toBase64(value) {
+    if (typeof btoa === "function") {
+        return btoa(value);
+    }
+    const globals = globalThis;
+    if (globals.Buffer) {
+        return globals.Buffer.from(value).toString("base64");
+    }
+    throw new Error("Twilio provider requires a base64 encoder");
+}
+export function createTwilioProvider(options) {
+    const baseUrl = options.baseUrl ?? "https://api.twilio.com/2010-04-01";
+    const fetchImpl = options.fetch ?? globalThis.fetch;
+    return {
+        name: "twilio",
+        channels: ["sms"],
+        async send(payload) {
+            if (payload.channel !== "sms") {
+                throw new Error(`Twilio provider only supports the "sms" channel, got "${payload.channel}"`);
+            }
+            if (!fetchImpl) {
+                throw new Error("Twilio provider requires a fetch implementation");
+            }
+            const rendered = options.renderTemplate
+                ? await options.renderTemplate(payload.template, payload.data)
+                : { text: payload.text ?? JSON.stringify(payload.data ?? {}) };
+            const body = new URLSearchParams({
+                To: payload.to,
+                From: payload.from ?? options.from,
+                Body: payload.text ?? rendered.text,
+            });
+            const response = await fetchImpl(`${baseUrl}/Accounts/${options.accountSid}/Messages.json`, {
+                method: "POST",
+                headers: {
+                    Authorization: `Basic ${toBase64(`${options.accountSid}:${options.authToken}`)}`,
+                    "Content-Type": "application/x-www-form-urlencoded;charset=UTF-8",
+                },
+                body: body.toString(),
+            });
+            if (!response.ok) {
+                const text = await response.text().catch(() => "");
+                throw new Error(`Twilio send failed (${response.status}): ${text}`);
+            }
+            const data = (await response.json());
+            return { id: data.sid, provider: "twilio" };
+        },
+    };
+}

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,
+    });
+}