@nixxie-cms/notifications 1.0.1

package/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2026 Nixxie International DMCC
+Portions Copyright (c) 2023 Thinkmill Labs Pty Ltd and contributors
+(this software is derived from the KeystoneJS project, https://keystonejs.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,34 @@
+# @nixxie-cms/notifications
+
+Multi-channel notifications for Nixxie CMS: Slack, Discord, SMS (Twilio), generic webhooks and your
+own custom channels. No SDK dependencies — everything goes over `fetch`.
+
+```ts
+import { config } from '@nixxie-cms/core'
+import { createNotifications } from '@nixxie-cms/notifications'
+
+export default config({
+  notifications: createNotifications({
+    channels: {
+      slack: { type: 'slack', webhookUrl: process.env.SLACK_WEBHOOK! },
+      ops: { type: 'sms', accountSid: '...', authToken: '...', from: '+1555...' },
+    },
+    default: 'slack',
+  }),
+})
+```
+
+Available everywhere as `context.services.notifications`:
+
+```ts
+await context.services.notifications.send({
+  channel: 'slack',
+  title: 'New signup',
+  body: `${user.email} just registered`,
+})
+
+// SMS needs a `to`:
+await context.services.notifications.send({ channel: 'ops', to: '+1555...', body: 'Deploy done' })
+```
+
+Add a `{ type: 'custom', send }` channel to deliver anywhere else (push, email queue, etc.).

package/dist/declarations/src/channels.d.ts

@@ -0,0 +1,7 @@
+import type { NixxieNotification } from '@nixxie-cms/core';
+import type { ChannelConfig } from "./types.js";
+/** Deliver a notification on a single configured channel. Returns the provider message id. */
+export declare function deliver(channel: ChannelConfig, notification: NixxieNotification): Promise<{
+    id?: string;
+}>;
+//# sourceMappingURL=channels.d.ts.map

package/dist/declarations/src/channels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.ts","sourceRoot":"../../../src","sources":["channels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAe;AAE5C,8FAA8F;AAC9F,wBAAsB,OAAO,CAC3B,OAAO,EAAE,aAAa,EACtB,YAAY,EAAE,kBAAkB,GAC/B,OAAO,CAAC;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiB1B"}

package/dist/declarations/src/index.d.ts

@@ -0,0 +1,14 @@
+import type { NixxieNotification, NixxieNotificationResult, NixxieNotificationsService } from '@nixxie-cms/core';
+import type { NotificationsConfig } from "./types.js";
+export declare class NotificationsService implements NixxieNotificationsService {
+    private config;
+    constructor(config: NotificationsConfig);
+    channels(): string[];
+    private targetChannels;
+    send(notification: NixxieNotification): Promise<NixxieNotificationResult[]>;
+}
+export declare function createNotifications(config: NotificationsConfig): NotificationsService;
+export { deliver } from "./channels.js";
+export type { NotificationsConfig, ChannelConfig, SlackChannelConfig, DiscordChannelConfig, WebhookChannelConfig, SmsChannelConfig, CustomChannelConfig, } from "./types.js";
+export type { NixxieNotification, NixxieNotificationResult, NixxieNotificationsService, } from '@nixxie-cms/core';
+//# sourceMappingURL=index.d.ts.map

package/dist/declarations/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"../../../src","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,wBAAwB,EACxB,0BAA0B,EAC3B,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAe;AAElD,qBAAa,oBAAqB,YAAW,0BAA0B;IACrE,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,EAAE,mBAAmB;IAIvC,QAAQ,IAAI,MAAM,EAAE;IAIpB,OAAO,CAAC,cAAc;IAKhB,IAAI,CAAC,YAAY,EAAE,kBAAkB,GAAG,OAAO,CAAC,wBAAwB,EAAE,CAAC;CAelF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,oBAAoB,CAErF;AAED,OAAO,EAAE,OAAO,EAAE,sBAAkB;AACpC,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,GACpB,mBAAe;AAChB,YAAY,EACV,kBAAkB,EAClB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAA"}

package/dist/declarations/src/types.d.ts

@@ -0,0 +1,43 @@
+import type { NixxieNotification, NixxieNotificationResult, NixxieNotificationsService } from '@nixxie-cms/core';
+export type { NixxieNotification, NixxieNotificationResult, NixxieNotificationsService };
+export type SlackChannelConfig = {
+    type: 'slack';
+    /** Slack Incoming Webhook URL. */
+    webhookUrl: string;
+};
+export type DiscordChannelConfig = {
+    type: 'discord';
+    /** Discord webhook URL. */
+    webhookUrl: string;
+};
+export type WebhookChannelConfig = {
+    type: 'webhook';
+    /** Endpoint to POST the notification JSON to. */
+    url: string;
+    /** Extra headers (e.g. an auth token). */
+    headers?: Record<string, string>;
+};
+export type SmsChannelConfig = {
+    type: 'sms';
+    /** Twilio Account SID. */
+    accountSid: string;
+    /** Twilio Auth Token. */
+    authToken: string;
+    /** Sending phone number in E.164 format. */
+    from: string;
+};
+export type CustomChannelConfig = {
+    type: 'custom';
+    /** Implement delivery yourself. Return the provider message id on success. */
+    send: (notification: NixxieNotification) => Promise<{
+        id?: string;
+    } | void>;
+};
+export type ChannelConfig = SlackChannelConfig | DiscordChannelConfig | WebhookChannelConfig | SmsChannelConfig | CustomChannelConfig;
+export type NotificationsConfig = {
+    /** Named channels. Reference them by key via `notification.channel`. */
+    channels: Record<string, ChannelConfig>;
+    /** Channel(s) used when a notification doesn't specify one. Default: every configured channel. */
+    default?: string | string[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/declarations/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"../../../src","sources":["types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,wBAAwB,EACxB,0BAA0B,EAC3B,MAAM,kBAAkB,CAAA;AAEzB,YAAY,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,CAAA;AAExF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,OAAO,CAAA;IACb,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,SAAS,CAAA;IACf,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,SAAS,CAAA;IACf,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAA;IACX,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,KAAK,CAAA;IACX,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,QAAQ,CAAA;IACd,8EAA8E;IAC9E,IAAI,EAAE,CAAC,YAAY,EAAE,kBAAkB,KAAK,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;CAC5E,CAAA;AAED,MAAM,MAAM,aAAa,GACrB,kBAAkB,GAClB,oBAAoB,GACpB,oBAAoB,GACpB,gBAAgB,GAChB,mBAAmB,CAAA;AAEvB,MAAM,MAAM,mBAAmB,GAAG;IAChC,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACvC,kGAAkG;IAClG,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAC5B,CAAA"}

package/dist/nixxie-cms-notifications.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./declarations/src/index.js";
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibml4eGllLWNtcy1ub3RpZmljYXRpb25zLmNqcy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi9kZWNsYXJhdGlvbnMvc3JjL2luZGV4LmQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEifQ==

package/dist/nixxie-cms-notifications.cjs.js

@@ -0,0 +1,146 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/** Deliver a notification on a single configured channel. Returns the provider message id. */
+async function deliver(channel, notification) {
+  var _await$channel$send;
+  switch (channel.type) {
+    case 'slack':
+      return deliverSlack(channel.webhookUrl, notification);
+    case 'discord':
+      return deliverDiscord(channel.webhookUrl, notification);
+    case 'webhook':
+      return deliverWebhook(channel.url, channel.headers, notification);
+    case 'sms':
+      return deliverSms(channel, notification);
+    case 'custom':
+      return (_await$channel$send = await channel.send(notification)) !== null && _await$channel$send !== void 0 ? _await$channel$send : {};
+    default:
+      {
+        const exhaustive = channel;
+        throw new Error(`Unknown channel type: ${exhaustive.type}`);
+      }
+  }
+}
+function text(n) {
+  return n.title ? `*${n.title}*\n${n.body}` : n.body;
+}
+async function deliverSlack(url, n) {
+  var _n$data;
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json'
+    },
+    // Spread custom data first so it can add Slack fields (blocks, attachments, …) without
+    // clobbering the composed message text.
+    body: JSON.stringify({
+      ...((_n$data = n.data) !== null && _n$data !== void 0 ? _n$data : {}),
+      text: text(n)
+    })
+  });
+  if (!res.ok) throw new Error(`Slack delivery failed (${res.status}): ${await res.text()}`);
+  return {};
+}
+async function deliverDiscord(url, n) {
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json'
+    },
+    body: JSON.stringify({
+      content: text(n)
+    })
+  });
+  if (!res.ok) throw new Error(`Discord delivery failed (${res.status}): ${await res.text()}`);
+  return {};
+}
+async function deliverWebhook(url, headers, n) {
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      ...headers
+    },
+    body: JSON.stringify({
+      title: n.title,
+      body: n.body,
+      to: n.to,
+      data: n.data
+    })
+  });
+  if (!res.ok) throw new Error(`Webhook delivery failed (${res.status}): ${await res.text()}`);
+  return {};
+}
+async function deliverSms(channel, n) {
+  if (!n.to) throw new Error('SMS notifications require `to` (a destination phone number)');
+  const auth = Buffer.from(`${channel.accountSid}:${channel.authToken}`).toString('base64');
+  const body = new URLSearchParams({
+    To: n.to,
+    From: channel.from,
+    Body: n.title ? `${n.title}: ${n.body}` : n.body
+  });
+  const res = await fetch(`https://api.twilio.com/2010-04-01/Accounts/${channel.accountSid}/Messages.json`, {
+    method: 'POST',
+    headers: {
+      Authorization: `Basic ${auth}`,
+      'Content-Type': 'application/x-www-form-urlencoded'
+    },
+    body
+  });
+  if (!res.ok) throw new Error(`SMS delivery failed (${res.status}): ${await res.text()}`);
+  const data = await res.json();
+  return {
+    id: data.sid
+  };
+}
+
+class NotificationsService {
+  constructor(config) {
+    this.config = config;
+  }
+  channels() {
+    return Object.keys(this.config.channels);
+  }
+  targetChannels(notification) {
+    var _ref, _notification$channel;
+    const requested = (_ref = (_notification$channel = notification.channel) !== null && _notification$channel !== void 0 ? _notification$channel : this.config.default) !== null && _ref !== void 0 ? _ref : this.channels();
+    return Array.isArray(requested) ? requested : [requested];
+  }
+  async send(notification) {
+    const targets = this.targetChannels(notification);
+    return Promise.all(targets.map(async name => {
+      const channel = this.config.channels[name];
+      if (!channel) return {
+        channel: name,
+        ok: false,
+        error: `Unknown channel: ${name}`
+      };
+      try {
+        const {
+          id
+        } = await deliver(channel, notification);
+        return {
+          channel: name,
+          ok: true,
+          id
+        };
+      } catch (err) {
+        var _err$message;
+        return {
+          channel: name,
+          ok: false,
+          error: (_err$message = err === null || err === void 0 ? void 0 : err.message) !== null && _err$message !== void 0 ? _err$message : String(err)
+        };
+      }
+    }));
+  }
+}
+function createNotifications(config) {
+  return new NotificationsService(config);
+}
+
+exports.NotificationsService = NotificationsService;
+exports.createNotifications = createNotifications;
+exports.deliver = deliver;

package/dist/nixxie-cms-notifications.esm.js

@@ -0,0 +1,140 @@
+/** Deliver a notification on a single configured channel. Returns the provider message id. */
+async function deliver(channel, notification) {
+  var _await$channel$send;
+  switch (channel.type) {
+    case 'slack':
+      return deliverSlack(channel.webhookUrl, notification);
+    case 'discord':
+      return deliverDiscord(channel.webhookUrl, notification);
+    case 'webhook':
+      return deliverWebhook(channel.url, channel.headers, notification);
+    case 'sms':
+      return deliverSms(channel, notification);
+    case 'custom':
+      return (_await$channel$send = await channel.send(notification)) !== null && _await$channel$send !== void 0 ? _await$channel$send : {};
+    default:
+      {
+        const exhaustive = channel;
+        throw new Error(`Unknown channel type: ${exhaustive.type}`);
+      }
+  }
+}
+function text(n) {
+  return n.title ? `*${n.title}*\n${n.body}` : n.body;
+}
+async function deliverSlack(url, n) {
+  var _n$data;
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json'
+    },
+    // Spread custom data first so it can add Slack fields (blocks, attachments, …) without
+    // clobbering the composed message text.
+    body: JSON.stringify({
+      ...((_n$data = n.data) !== null && _n$data !== void 0 ? _n$data : {}),
+      text: text(n)
+    })
+  });
+  if (!res.ok) throw new Error(`Slack delivery failed (${res.status}): ${await res.text()}`);
+  return {};
+}
+async function deliverDiscord(url, n) {
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json'
+    },
+    body: JSON.stringify({
+      content: text(n)
+    })
+  });
+  if (!res.ok) throw new Error(`Discord delivery failed (${res.status}): ${await res.text()}`);
+  return {};
+}
+async function deliverWebhook(url, headers, n) {
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      ...headers
+    },
+    body: JSON.stringify({
+      title: n.title,
+      body: n.body,
+      to: n.to,
+      data: n.data
+    })
+  });
+  if (!res.ok) throw new Error(`Webhook delivery failed (${res.status}): ${await res.text()}`);
+  return {};
+}
+async function deliverSms(channel, n) {
+  if (!n.to) throw new Error('SMS notifications require `to` (a destination phone number)');
+  const auth = Buffer.from(`${channel.accountSid}:${channel.authToken}`).toString('base64');
+  const body = new URLSearchParams({
+    To: n.to,
+    From: channel.from,
+    Body: n.title ? `${n.title}: ${n.body}` : n.body
+  });
+  const res = await fetch(`https://api.twilio.com/2010-04-01/Accounts/${channel.accountSid}/Messages.json`, {
+    method: 'POST',
+    headers: {
+      Authorization: `Basic ${auth}`,
+      'Content-Type': 'application/x-www-form-urlencoded'
+    },
+    body
+  });
+  if (!res.ok) throw new Error(`SMS delivery failed (${res.status}): ${await res.text()}`);
+  const data = await res.json();
+  return {
+    id: data.sid
+  };
+}
+
+class NotificationsService {
+  constructor(config) {
+    this.config = config;
+  }
+  channels() {
+    return Object.keys(this.config.channels);
+  }
+  targetChannels(notification) {
+    var _ref, _notification$channel;
+    const requested = (_ref = (_notification$channel = notification.channel) !== null && _notification$channel !== void 0 ? _notification$channel : this.config.default) !== null && _ref !== void 0 ? _ref : this.channels();
+    return Array.isArray(requested) ? requested : [requested];
+  }
+  async send(notification) {
+    const targets = this.targetChannels(notification);
+    return Promise.all(targets.map(async name => {
+      const channel = this.config.channels[name];
+      if (!channel) return {
+        channel: name,
+        ok: false,
+        error: `Unknown channel: ${name}`
+      };
+      try {
+        const {
+          id
+        } = await deliver(channel, notification);
+        return {
+          channel: name,
+          ok: true,
+          id
+        };
+      } catch (err) {
+        var _err$message;
+        return {
+          channel: name,
+          ok: false,
+          error: (_err$message = err === null || err === void 0 ? void 0 : err.message) !== null && _err$message !== void 0 ? _err$message : String(err)
+        };
+      }
+    }));
+  }
+}
+function createNotifications(config) {
+  return new NotificationsService(config);
+}
+
+export { NotificationsService, createNotifications, deliver };

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@nixxie-cms/notifications",
+  "version": "1.0.1",
+  "license": "MIT",
+  "main": "dist/nixxie-cms-notifications.cjs.js",
+  "module": "dist/nixxie-cms-notifications.esm.js",
+  "exports": {
+    ".": {
+      "types": "./dist/nixxie-cms-notifications.cjs.js",
+      "module": "./dist/nixxie-cms-notifications.esm.js",
+      "default": "./dist/nixxie-cms-notifications.cjs.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@babel/runtime": "^7.24.7"
+  },
+  "devDependencies": {
+    "@nixxie-cms/core": "^1.0.1"
+  },
+  "peerDependencies": {
+    "@nixxie-cms/core": "^1.0.1"
+  },
+  "preconstruct": {
+    "entrypoints": [
+      "index.ts"
+    ]
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nixxiecms/nixxie/tree/main/packages/notifications"
+  }
+}

package/src/channels.ts

@@ -0,0 +1,92 @@
+import type { NixxieNotification } from '@nixxie-cms/core'
+import type { ChannelConfig } from './types'
+
+/** Deliver a notification on a single configured channel. Returns the provider message id. */
+export async function deliver(
+  channel: ChannelConfig,
+  notification: NixxieNotification
+): Promise<{ id?: string }> {
+  switch (channel.type) {
+    case 'slack':
+      return deliverSlack(channel.webhookUrl, notification)
+    case 'discord':
+      return deliverDiscord(channel.webhookUrl, notification)
+    case 'webhook':
+      return deliverWebhook(channel.url, channel.headers, notification)
+    case 'sms':
+      return deliverSms(channel, notification)
+    case 'custom':
+      return (await channel.send(notification)) ?? {}
+    default: {
+      const exhaustive: never = channel
+      throw new Error(`Unknown channel type: ${(exhaustive as any).type}`)
+    }
+  }
+}
+
+function text(n: NixxieNotification): string {
+  return n.title ? `*${n.title}*\n${n.body}` : n.body
+}
+
+async function deliverSlack(url: string, n: NixxieNotification): Promise<{ id?: string }> {
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    // Spread custom data first so it can add Slack fields (blocks, attachments, …) without
+    // clobbering the composed message text.
+    body: JSON.stringify({ ...(n.data ?? {}), text: text(n) }),
+  })
+  if (!res.ok) throw new Error(`Slack delivery failed (${res.status}): ${await res.text()}`)
+  return {}
+}
+
+async function deliverDiscord(url: string, n: NixxieNotification): Promise<{ id?: string }> {
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ content: text(n) }),
+  })
+  if (!res.ok) throw new Error(`Discord delivery failed (${res.status}): ${await res.text()}`)
+  return {}
+}
+
+async function deliverWebhook(
+  url: string,
+  headers: Record<string, string> | undefined,
+  n: NixxieNotification
+): Promise<{ id?: string }> {
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json', ...headers },
+    body: JSON.stringify({ title: n.title, body: n.body, to: n.to, data: n.data }),
+  })
+  if (!res.ok) throw new Error(`Webhook delivery failed (${res.status}): ${await res.text()}`)
+  return {}
+}
+
+async function deliverSms(
+  channel: { accountSid: string; authToken: string; from: string },
+  n: NixxieNotification
+): Promise<{ id?: string }> {
+  if (!n.to) throw new Error('SMS notifications require `to` (a destination phone number)')
+  const auth = Buffer.from(`${channel.accountSid}:${channel.authToken}`).toString('base64')
+  const body = new URLSearchParams({
+    To: n.to,
+    From: channel.from,
+    Body: n.title ? `${n.title}: ${n.body}` : n.body,
+  })
+  const res = await fetch(
+    `https://api.twilio.com/2010-04-01/Accounts/${channel.accountSid}/Messages.json`,
+    {
+      method: 'POST',
+      headers: {
+        Authorization: `Basic ${auth}`,
+        'Content-Type': 'application/x-www-form-urlencoded',
+      },
+      body,
+    }
+  )
+  if (!res.ok) throw new Error(`SMS delivery failed (${res.status}): ${await res.text()}`)
+  const data: any = await res.json()
+  return { id: data.sid }
+}

package/src/index.ts

@@ -0,0 +1,60 @@
+import type {
+  NixxieNotification,
+  NixxieNotificationResult,
+  NixxieNotificationsService,
+} from '@nixxie-cms/core'
+import { deliver } from './channels'
+import type { NotificationsConfig } from './types'
+
+export class NotificationsService implements NixxieNotificationsService {
+  private config: NotificationsConfig
+
+  constructor(config: NotificationsConfig) {
+    this.config = config
+  }
+
+  channels(): string[] {
+    return Object.keys(this.config.channels)
+  }
+
+  private targetChannels(notification: NixxieNotification): string[] {
+    const requested = notification.channel ?? this.config.default ?? this.channels()
+    return Array.isArray(requested) ? requested : [requested]
+  }
+
+  async send(notification: NixxieNotification): Promise<NixxieNotificationResult[]> {
+    const targets = this.targetChannels(notification)
+    return Promise.all(
+      targets.map(async (name): Promise<NixxieNotificationResult> => {
+        const channel = this.config.channels[name]
+        if (!channel) return { channel: name, ok: false, error: `Unknown channel: ${name}` }
+        try {
+          const { id } = await deliver(channel, notification)
+          return { channel: name, ok: true, id }
+        } catch (err: any) {
+          return { channel: name, ok: false, error: err?.message ?? String(err) }
+        }
+      })
+    )
+  }
+}
+
+export function createNotifications(config: NotificationsConfig): NotificationsService {
+  return new NotificationsService(config)
+}
+
+export { deliver } from './channels'
+export type {
+  NotificationsConfig,
+  ChannelConfig,
+  SlackChannelConfig,
+  DiscordChannelConfig,
+  WebhookChannelConfig,
+  SmsChannelConfig,
+  CustomChannelConfig,
+} from './types'
+export type {
+  NixxieNotification,
+  NixxieNotificationResult,
+  NixxieNotificationsService,
+} from '@nixxie-cms/core'

package/src/types.ts

@@ -0,0 +1,57 @@
+import type {
+  NixxieNotification,
+  NixxieNotificationResult,
+  NixxieNotificationsService,
+} from '@nixxie-cms/core'
+
+export type { NixxieNotification, NixxieNotificationResult, NixxieNotificationsService }
+
+export type SlackChannelConfig = {
+  type: 'slack'
+  /** Slack Incoming Webhook URL. */
+  webhookUrl: string
+}
+
+export type DiscordChannelConfig = {
+  type: 'discord'
+  /** Discord webhook URL. */
+  webhookUrl: string
+}
+
+export type WebhookChannelConfig = {
+  type: 'webhook'
+  /** Endpoint to POST the notification JSON to. */
+  url: string
+  /** Extra headers (e.g. an auth token). */
+  headers?: Record<string, string>
+}
+
+export type SmsChannelConfig = {
+  type: 'sms'
+  /** Twilio Account SID. */
+  accountSid: string
+  /** Twilio Auth Token. */
+  authToken: string
+  /** Sending phone number in E.164 format. */
+  from: string
+}
+
+export type CustomChannelConfig = {
+  type: 'custom'
+  /** Implement delivery yourself. Return the provider message id on success. */
+  send: (notification: NixxieNotification) => Promise<{ id?: string } | void>
+}
+
+export type ChannelConfig =
+  | SlackChannelConfig
+  | DiscordChannelConfig
+  | WebhookChannelConfig
+  | SmsChannelConfig
+  | CustomChannelConfig
+
+export type NotificationsConfig = {
+  /** Named channels. Reference them by key via `notification.channel`. */
+  channels: Record<string, ChannelConfig>
+  /** Channel(s) used when a notification doesn't specify one. Default: every configured channel. */
+  default?: string | string[]
+}