@voyantjs/notifications 0.3.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/package.json

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