@feathers-baas/plugin-notifications 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @feathers-baas/plugin-notifications
 
+## 0.3.0
+
+### Minor Changes
+
+- 4d99238: Fix BullMQ startup crash and make auth email links configurable (#6, #7).
+  - The queue is now named `feathers-baas-notifications` with BullMQ `prefix: 'feathers-baas'` (exported as `NOTIFICATION_QUEUE_PREFIX`). bullmq ≥ 5 rejects `:` in queue names, so the old name crashed the app at startup whenever `REDIS_URL` and an email driver were both set. Queue and worker use the same name and prefix.
+  - Notifier options accept `paths` (`verify`, `resetPassword`, `verifySetPassword`), `verifyDelay` / `resetDelay`, and a `buildNotification` override. `buildAuthNotification` and `formatDuration` are exported so apps can wrap the default emails.
+  - The "link expires in…" copy is derived from the configured token lifetimes (the verification email used to say 24 hours while tokens lived 5 days).
+
+## 0.2.1
+
+### Patch Changes
+
+- Add README for each package, update AGENTS.md template, fix MongoDB auth entityId, and add timestamp hooks for consistent createdAt/updatedAt across all databases
+
 ## 0.2.0
 
 ### Minor Changes

package/README.md

@@ -0,0 +1,99 @@
+# @feathers-baas/plugin-notifications
+
+Notification plugin for [feathers-baas](https://github.com/anthropics/feathers-baas) — BullMQ-backed email delivery with SMTP, Resend, SendGrid, and Brevo drivers.
+
+## Installation
+
+```bash
+pnpm add @feathers-baas/plugin-notifications
+```
+
+## How it works
+
+Auth events (verify email, reset password, etc.) are routed through the notification system. Two delivery modes:
+
+- **Direct mode** (no Redis) — drivers called synchronously in the request path. Suitable for development and API-based drivers.
+- **Queue mode** (with Redis) — jobs enqueued in BullMQ with automatic retries and exponential backoff. Best for production.
+
+If no driver env vars are configured, auth events are logged to console.
+
+## Setup
+
+Add driver env vars to `.env`:
+
+```env
+# Pick one (or more):
+
+# SMTP
+SMTP_URL=smtp://user:pass@localhost:1025
+SMTP_FROM_NAME=My App
+SMTP_FROM_ADDRESS=no-reply@example.com
+
+# Resend
+RESEND_API_KEY=re_xxxxxxxxxxxx
+RESEND_FROM_NAME=My App
+RESEND_FROM_ADDRESS=no-reply@yourdomain.com
+
+# SendGrid
+SENDGRID_API_KEY=SG.xxxxxxxxxxxx
+SENDGRID_FROM_NAME=My App
+SENDGRID_FROM_ADDRESS=no-reply@yourdomain.com
+
+# Brevo
+BREVO_API_KEY=xkeysib-xxxxxxxxxxxx
+BREVO_FROM_NAME=My App
+BREVO_FROM_ADDRESS=no-reply@yourdomain.com
+```
+
+For queue mode, add Redis:
+
+```env
+REDIS_URL=redis://localhost:6379
+```
+
+No code changes needed — `@feathers-baas/core` auto-configures drivers from env vars.
+
+## Email drivers
+
+| Driver   | Class           | Env var            | Use case                          |
+|----------|-----------------|--------------------|-----------------------------------|
+| SMTP     | `SMTPDriver`    | `SMTP_URL`         | Self-hosted SMTP, Mailtrap        |
+| Resend   | `ResendDriver`  | `RESEND_API_KEY`   | Managed transactional email       |
+| SendGrid | `SendGridDriver`| `SENDGRID_API_KEY` | Twilio SendGrid                   |
+| Brevo    | `BrevoDriver`   | `BREVO_API_KEY`    | Brevo (formerly Sendinblue)       |
+
+All configured drivers are active simultaneously.
+
+## Auth events handled automatically
+
+| Event              | Trigger                    |
+|--------------------|----------------------------|
+| Verify email       | User registers             |
+| Resend verification| User requests re-send      |
+| Reset password     | User requests reset        |
+| Password changed   | After successful reset     |
+| Email change       | Identity change request    |
+
+## Exports
+
+```ts
+// Drivers
+import { SMTPDriver, ResendDriver, SendGridDriver, BrevoDriver } from '@feathers-baas/plugin-notifications'
+
+// Driver registry
+import { DriverRegistry } from '@feathers-baas/plugin-notifications'
+
+// Notifier factories
+import { createBullMQNotifier, createDirectNotifier } from '@feathers-baas/plugin-notifications'
+
+// Queue utilities
+import { createNotificationQueue, createNotificationWorker } from '@feathers-baas/plugin-notifications'
+```
+
+## Plugin interface
+
+This package exports a `FeathersBaasPlugin` default export and is auto-discovered by `@feathers-baas/core` when listed as a dependency. Drivers are configured automatically from env vars by core's `configureNotifications()`.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -33,15 +33,18 @@ __export(index_exports, {
   BrevoDriver: () => BrevoDriver,
   DriverRegistry: () => DriverRegistry,
   NOTIFICATION_QUEUE_NAME: () => NOTIFICATION_QUEUE_NAME,
+  NOTIFICATION_QUEUE_PREFIX: () => NOTIFICATION_QUEUE_PREFIX,
   ResendDriver: () => ResendDriver,
   SMTPDriver: () => SMTPDriver,
   SendGridDriver: () => SendGridDriver,
+  buildAuthNotification: () => buildAuthNotification,
   createBullMQNotifier: () => createBullMQNotifier,
   createDirectNotifier: () => createDirectNotifier,
   createNotificationQueue: () => createNotificationQueue,
   createNotificationWorker: () => createNotificationWorker,
   default: () => index_default,
-  enqueueNotification: () => enqueueNotification
+  enqueueNotification: () => enqueueNotification,
+  formatDuration: () => formatDuration
 });
 module.exports = __toCommonJS(index_exports);
 var import_node_module = require("module");
@@ -78,10 +81,12 @@ var DriverRegistry = class {
 
 // src/queue/producer.ts
 var import_bullmq = require("bullmq");
-var NOTIFICATION_QUEUE_NAME = "feathers-baas:notifications";
+var NOTIFICATION_QUEUE_NAME = "feathers-baas-notifications";
+var NOTIFICATION_QUEUE_PREFIX = "feathers-baas";
 function createNotificationQueue(redis) {
   return new import_bullmq.Queue(NOTIFICATION_QUEUE_NAME, {
     connection: redis,
+    prefix: NOTIFICATION_QUEUE_PREFIX,
     defaultJobOptions: {
       attempts: 5,
       backoff: {
@@ -108,14 +113,39 @@ var AUTH_MANAGEMENT_EVENT_MAP = {
   passwordChange: "auth.password-change",
   identityChange: "auth.identity-change"
 };
-function buildAuthNotification(type, user, appUrl) {
+var DEFAULT_VERIFY_DELAY_MS = 1e3 * 60 * 60 * 24 * 5;
+var DEFAULT_RESET_DELAY_MS = 1e3 * 60 * 60 * 2;
+function formatDuration(ms) {
+  const units = [
+    ["day", 864e5],
+    ["hour", 36e5],
+    ["minute", 6e4]
+  ];
+  for (const [name, size] of units) {
+    if (ms >= size && ms % size === 0) {
+      const n = ms / size;
+      return `${n} ${name}${n === 1 ? "" : "s"}`;
+    }
+  }
+  const minutes = Math.max(1, Math.round(ms / 6e4));
+  return `${minutes} minute${minutes === 1 ? "" : "s"}`;
+}
+function buildLink(appUrl, path, token) {
+  const base = appUrl.replace(/\/+$/, "");
+  const route = path.startsWith("/") ? path : `/${path}`;
+  return `${base}${route}?token=${encodeURIComponent(token ?? "")}`;
+}
+function buildAuthNotification(type, user, opts) {
+  const { appUrl, paths = {} } = opts;
+  const verifyExpiry = formatDuration(opts.verifyDelay ?? DEFAULT_VERIFY_DELAY_MS);
+  const resetExpiry = formatDuration(opts.resetDelay ?? DEFAULT_RESET_DELAY_MS);
   const email = user["email"];
   if (!email) return null;
   switch (type) {
     case "auth.verify-signup":
     case "auth.resend-verify-signup": {
       const token = user["verifyToken"];
-      const verifyUrl = `${appUrl}/verify?token=${token ?? ""}`;
+      const verifyUrl = buildLink(appUrl, paths.verify ?? "/verify", token);
       return {
         to: email,
         channel: "email",
@@ -124,15 +154,15 @@ function buildAuthNotification(type, user, appUrl) {
           <h2>Welcome!</h2>
           <p>Click the link below to verify your email address:</p>
           <p><a href="<%= verifyUrl %>">Verify email</a></p>
-          <p>This link expires in 24 hours.</p>
+          <p>This link expires in <%= expiresIn %>.</p>
         `,
         textTemplate: `Verify your email: <%= verifyUrl %>`,
-        data: { verifyUrl, user }
+        data: { verifyUrl, expiresIn: verifyExpiry, user }
       };
     }
     case "auth.send-reset-pwd": {
       const token = user["resetToken"];
-      const resetUrl = `${appUrl}/reset-password?token=${token ?? ""}`;
+      const resetUrl = buildLink(appUrl, paths.resetPassword ?? "/reset-password", token);
       return {
         to: email,
         channel: "email",
@@ -141,10 +171,10 @@ function buildAuthNotification(type, user, appUrl) {
           <h2>Password reset requested</h2>
           <p>Click the link below to reset your password:</p>
           <p><a href="<%= resetUrl %>">Reset password</a></p>
-          <p>This link expires in 2 hours. If you did not request this, ignore this email.</p>
+          <p>This link expires in <%= expiresIn %>. If you did not request this, ignore this email.</p>
         `,
         textTemplate: `Reset your password: <%= resetUrl %>`,
-        data: { resetUrl, user }
+        data: { resetUrl, expiresIn: resetExpiry, user }
       };
     }
     case "auth.reset-pwd": {
@@ -179,7 +209,7 @@ function buildAuthNotification(type, user, appUrl) {
     }
     case "auth.verify-signup-set-password": {
       const token = user["verifyToken"];
-      const verifyUrl = `${appUrl}/verify-set-password?token=${token ?? ""}`;
+      const verifyUrl = buildLink(appUrl, paths.verifySetPassword ?? "/verify-set-password", token);
       return {
         to: email,
         channel: "email",
@@ -198,7 +228,7 @@ function createDirectNotifier(opts) {
   return async (type, user, _notifierOptions) => {
     const eventKey = AUTH_MANAGEMENT_EVENT_MAP[type];
     if (!eventKey) return;
-    const notification = buildAuthNotification(eventKey, user, opts.appUrl);
+    const notification = (opts.buildNotification ?? buildAuthNotification)(eventKey, user, opts);
     if (!notification) return;
     const driverNames = opts.registry.getDriversForEvent(eventKey);
     if (driverNames.length === 0) return;
@@ -215,7 +245,7 @@ function createBullMQNotifier(opts) {
   return async (type, user, _notifierOptions) => {
     const eventKey = AUTH_MANAGEMENT_EVENT_MAP[type];
     if (!eventKey) return;
-    const notification = buildAuthNotification(eventKey, user, opts.appUrl);
+    const notification = (opts.buildNotification ?? buildAuthNotification)(eventKey, user, opts);
     if (!notification) return;
     const driverNames = opts.registry.getDriversForEvent(eventKey);
     if (driverNames.length === 0) return;
@@ -243,6 +273,8 @@ function createNotificationWorker(registry, redis, opts = {}) {
     },
     {
       connection: redis,
+      // Must match the producer, or jobs are enqueued where the worker isn't listening
+      prefix: NOTIFICATION_QUEUE_PREFIX,
       concurrency,
       // Don't create a new redis connection per job — reuse the pool
       autorun: true
@@ -382,13 +414,16 @@ var index_default = plugin;
   BrevoDriver,
   DriverRegistry,
   NOTIFICATION_QUEUE_NAME,
+  NOTIFICATION_QUEUE_PREFIX,
   ResendDriver,
   SMTPDriver,
   SendGridDriver,
+  buildAuthNotification,
   createBullMQNotifier,
   createDirectNotifier,
   createNotificationQueue,
   createNotificationWorker,
-  enqueueNotification
+  enqueueNotification,
+  formatDuration
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/registry.ts","../src/queue/producer.ts","../src/notifier.ts","../src/queue/worker.ts","../src/drivers/smtp.driver.ts","../src/drivers/resend.driver.ts","../src/drivers/sendgrid.driver.ts","../src/drivers/brevo.driver.ts"],"sourcesContent":["// Generated by feathers-baas. Safe to edit.\nimport { createRequire } from 'node:module'\nimport type { FeathersBaasPlugin } from './plugin.js'\n\nconst pkg = createRequire(import.meta.url)('../package.json') as { version: string }\n\nconst plugin: FeathersBaasPlugin = {\n  name: '@feathers-baas/plugin-notifications',\n  version: pkg.version,\n  async install(_app, _options) {\n    // Notification drivers are configured via core's configureNotifications()\n    // based on env vars. Auto-install is a no-op; discovery confirms the plugin is present.\n  },\n}\n\nexport default plugin\n\nexport { DriverRegistry } from './registry.js'\nexport { createBullMQNotifier, createDirectNotifier } from './notifier.js'\nexport type { NotifierFn, BullMQNotifierOptions, DirectNotifierOptions } from './notifier.js'\n\n// Queue\nexport { createNotificationQueue, enqueueNotification, NOTIFICATION_QUEUE_NAME } from './queue/producer.js'\nexport { createNotificationWorker } from './queue/worker.js'\nexport type { WorkerOptions } from './queue/worker.js'\n\n// Drivers\nexport { SMTPDriver } from './drivers/smtp.driver.js'\nexport type { SMTPDriverOptions } from './drivers/smtp.driver.js'\nexport { ResendDriver } from './drivers/resend.driver.js'\nexport type { ResendDriverOptions } from './drivers/resend.driver.js'\nexport { SendGridDriver } from './drivers/sendgrid.driver.js'\nexport type { SendGridDriverOptions } from './drivers/sendgrid.driver.js'\nexport { BrevoDriver } from './drivers/brevo.driver.js'\nexport type { BrevoDriverOptions } from './drivers/brevo.driver.js'\n\n// Types\nexport type {\n  Notification,\n  NotifierDriver,\n  NotificationJob,\n  NotificationEvent,\n  AuthNotificationEvent,\n} from './types.js'\n","// Generated by feathers-baas. Safe to edit.\nimport type { NotifierDriver, NotificationEvent } from './types.js'\n\n/**\n * DriverRegistry maps event keys to the list of drivers that should handle\n * that event.\n *\n * A single driver instance can handle multiple events (e.g. the SMTP driver\n * handles all auth.* email events).\n *\n * @example\n * ```ts\n * const registry = new DriverRegistry()\n * registry.registerDriver(smtpDriver)\n * registry.mapEvent('auth.verify-signup', 'smtp')\n * registry.mapEvent('auth.send-reset-pwd', 'smtp')\n * ```\n */\nexport class DriverRegistry {\n  private readonly drivers = new Map<string, NotifierDriver>()\n  private readonly eventMap = new Map<NotificationEvent, string[]>()\n\n  /** Register a driver under its name. Overwrites any existing driver with the same name. */\n  registerDriver(driver: NotifierDriver): void {\n    this.drivers.set(driver.name, driver)\n  }\n\n  /** Map a notification event to a driver name. Multiple calls for the same event add drivers. */\n  mapEvent(event: NotificationEvent, driverName: string): void {\n    const existing = this.eventMap.get(event) ?? []\n    if (!existing.includes(driverName)) {\n      existing.push(driverName)\n    }\n    this.eventMap.set(event, existing)\n  }\n\n  /** Look up a driver by name. Returns undefined if not registered. */\n  getDriver(name: string): NotifierDriver | undefined {\n    return this.drivers.get(name)\n  }\n\n  /** Get all driver names mapped to the given event. */\n  getDriversForEvent(event: NotificationEvent): string[] {\n    return this.eventMap.get(event) ?? []\n  }\n\n  /** All registered driver names. */\n  listDriverNames(): string[] {\n    return [...this.drivers.keys()]\n  }\n}\n","// Generated by feathers-baas. Safe to edit.\nimport { Queue } from 'bullmq'\nimport type { Redis } from 'ioredis'\nimport type { NotificationJob } from '../types.js'\n\nexport const NOTIFICATION_QUEUE_NAME = 'feathers-baas:notifications'\n\n/**\n * Create a BullMQ Queue instance for notification jobs.\n *\n * @example\n * ```ts\n * const redis = new Redis(process.env.REDIS_URL)\n * const queue = createNotificationQueue(redis)\n * await enqueueNotification(queue, { driverName: 'smtp', notification: { ... } })\n * ```\n */\nexport function createNotificationQueue(redis: Redis): Queue<NotificationJob> {\n  return new Queue<NotificationJob>(NOTIFICATION_QUEUE_NAME, {\n    connection: redis,\n    defaultJobOptions: {\n      attempts: 5,\n      backoff: {\n        type: 'exponential',\n        delay: 1_000, // initial delay: 1s → 2s → 4s → 8s → 16s\n      },\n      removeOnComplete: { count: 100 },\n      removeOnFail: { count: 500 },\n    },\n  })\n}\n\n/**\n * Enqueue a notification job.\n *\n * @param queue  BullMQ Queue instance from createNotificationQueue()\n * @param job    Job payload { driverName, notification }\n */\nexport async function enqueueNotification(\n  queue: Queue<NotificationJob>,\n  job: NotificationJob,\n): Promise<void> {\n  await queue.add('send', job)\n}\n","// Generated by feathers-baas. Safe to edit.\nimport type { Queue } from 'bullmq'\nimport type { NotificationJob, Notification, AuthNotificationEvent } from './types.js'\nimport { enqueueNotification } from './queue/producer.js'\nimport type { DriverRegistry } from './registry.js'\n\n/**\n * Auth-management notification types mapped to feathers-baas event keys.\n * feathers-authentication-management passes these type strings to the notifier.\n */\nconst AUTH_MANAGEMENT_EVENT_MAP: Record<string, AuthNotificationEvent> = {\n  resendVerifySignup: 'auth.resend-verify-signup',\n  verifySignup: 'auth.verify-signup',\n  verifySignupSetPassword: 'auth.verify-signup-set-password',\n  sendResetPwd: 'auth.send-reset-pwd',\n  resetPwd: 'auth.reset-pwd',\n  passwordChange: 'auth.password-change',\n  identityChange: 'auth.identity-change',\n}\n\n/**\n * Build a default Notification payload for each auth event type.\n * Templates use EJS — `<%= variable %>` for output, `<% code %>` for logic.\n */\nfunction buildAuthNotification(\n  type: AuthNotificationEvent,\n  user: Record<string, unknown>,\n  appUrl: string,\n): Notification | null {\n  const email = user['email'] as string\n  if (!email) return null\n\n  switch (type) {\n    case 'auth.verify-signup':\n    case 'auth.resend-verify-signup': {\n      const token = user['verifyToken'] as string | undefined\n      const verifyUrl = `${appUrl}/verify?token=${token ?? ''}`\n      return {\n        to: email,\n        channel: 'email',\n        subject: 'Verify your email address',\n        bodyTemplate: `\n          <h2>Welcome!</h2>\n          <p>Click the link below to verify your email address:</p>\n          <p><a href=\"<%= verifyUrl %>\">Verify email</a></p>\n          <p>This link expires in 24 hours.</p>\n        `,\n        textTemplate: `Verify your email: <%= verifyUrl %>`,\n        data: { verifyUrl, user },\n      }\n    }\n\n    case 'auth.send-reset-pwd': {\n      const token = user['resetToken'] as string | undefined\n      const resetUrl = `${appUrl}/reset-password?token=${token ?? ''}`\n      return {\n        to: email,\n        channel: 'email',\n        subject: 'Reset your password',\n        bodyTemplate: `\n          <h2>Password reset requested</h2>\n          <p>Click the link below to reset your password:</p>\n          <p><a href=\"<%= resetUrl %>\">Reset password</a></p>\n          <p>This link expires in 2 hours. If you did not request this, ignore this email.</p>\n        `,\n        textTemplate: `Reset your password: <%= resetUrl %>`,\n        data: { resetUrl, user },\n      }\n    }\n\n    case 'auth.reset-pwd': {\n      return {\n        to: email,\n        channel: 'email',\n        subject: 'Your password has been reset',\n        bodyTemplate: `<p>Your password has been successfully reset. If you did not do this, please contact support immediately.</p>`,\n        textTemplate: `Your password has been reset. If you did not do this, please contact support.`,\n        data: { user },\n      }\n    }\n\n    case 'auth.password-change': {\n      return {\n        to: email,\n        channel: 'email',\n        subject: 'Your password has been changed',\n        bodyTemplate: `<p>Your account password was just changed. If this was not you, please contact support immediately.</p>`,\n        textTemplate: `Your password was changed. Contact support if this wasn't you.`,\n        data: { user },\n      }\n    }\n\n    case 'auth.identity-change': {\n      return {\n        to: email,\n        channel: 'email',\n        subject: 'Your email address is being changed',\n        bodyTemplate: `<p>A request was made to change your email address. Click the link to confirm.</p>`,\n        textTemplate: `Confirm your email change by clicking the link in the HTML email.`,\n        data: { user },\n      }\n    }\n\n    case 'auth.verify-signup-set-password': {\n      const token = user['verifyToken'] as string | undefined\n      const verifyUrl = `${appUrl}/verify-set-password?token=${token ?? ''}`\n      return {\n        to: email,\n        channel: 'email',\n        subject: 'Set your password',\n        bodyTemplate: `\n          <h2>Set your password</h2>\n          <p><a href=\"<%= verifyUrl %>\">Set password</a></p>\n        `,\n        textTemplate: `Set your password: <%= verifyUrl %>`,\n        data: { verifyUrl, user },\n      }\n    }\n  }\n}\n\nexport type NotifierFn = (\n  type: string,\n  user: Record<string, unknown>,\n  notifierOptions: Record<string, unknown>,\n) => Promise<void>\n\nexport interface BullMQNotifierOptions {\n  /** BullMQ Queue instance — from createNotificationQueue(). */\n  queue: Queue<NotificationJob>\n  /** Driver registry — used to determine which drivers handle each event. */\n  registry: DriverRegistry\n  /**\n   * Public base URL of the app, e.g. https://api.example.com\n   * Used to construct verification / reset URLs in email templates.\n   */\n  appUrl: string\n}\n\n/**\n * Create a notifier function compatible with feathers-authentication-management.\n *\n * When an auth event fires (verifySignup, sendResetPwd, etc.), this notifier:\n * 1. Maps the event type to a feathers-baas notification event key\n * 2. Looks up all registered drivers for that event\n * 3. Enqueues one BullMQ job per driver\n * 4. Returns immediately — delivery is asynchronous\n *\n * Wire into the app:\n * ```ts\n * app.set('notifier', createBullMQNotifier({ queue, registry, appUrl }))\n * ```\n */\nexport interface DirectNotifierOptions {\n  /** Driver registry — used to determine which drivers handle each event. */\n  registry: DriverRegistry\n  /** Public base URL of the app. */\n  appUrl: string\n}\n\n/**\n * Create a notifier that sends notifications directly via the driver (no queue).\n * Use this when Redis/BullMQ is not available — suitable for API-based drivers\n * (Brevo, Resend, SendGrid) in development or low-traffic environments.\n */\nexport function createDirectNotifier(opts: DirectNotifierOptions): NotifierFn {\n  return async (type, user, _notifierOptions) => {\n    const eventKey = AUTH_MANAGEMENT_EVENT_MAP[type]\n    if (!eventKey) return\n\n    const notification = buildAuthNotification(eventKey, user, opts.appUrl)\n    if (!notification) return\n\n    const driverNames = opts.registry.getDriversForEvent(eventKey)\n    if (driverNames.length === 0) return\n\n    await Promise.all(\n      driverNames.map(async (driverName) => {\n        const driver = opts.registry.getDriver(driverName)\n        if (!driver) return\n        await driver.send(notification)\n      }),\n    )\n  }\n}\n\nexport function createBullMQNotifier(opts: BullMQNotifierOptions): NotifierFn {\n  return async (type, user, _notifierOptions) => {\n    const eventKey = AUTH_MANAGEMENT_EVENT_MAP[type]\n    if (!eventKey) return // Unknown event type — no-op\n\n    const notification = buildAuthNotification(eventKey, user, opts.appUrl)\n    if (!notification) return // Missing required user fields — no-op\n\n    const driverNames = opts.registry.getDriversForEvent(eventKey)\n    if (driverNames.length === 0) return // No drivers configured for this event\n\n    await Promise.all(\n      driverNames.map((driverName) =>\n        enqueueNotification(opts.queue, { driverName, notification }),\n      ),\n    )\n  }\n}\n","// Generated by feathers-baas. Safe to edit.\nimport { Worker } from 'bullmq'\nimport type { Redis } from 'ioredis'\nimport type { DriverRegistry } from '../registry.js'\nimport type { NotificationJob } from '../types.js'\nimport { NOTIFICATION_QUEUE_NAME } from './producer.js'\n\nexport interface WorkerOptions {\n  /** BullMQ concurrency — number of jobs processed in parallel. */\n  concurrency?: number\n}\n\n/**\n * Create and start the BullMQ worker that processes notification jobs.\n *\n * The worker looks up the driver from the registry by name, renders the\n * EJS template, and calls driver.send(). BullMQ handles retries with\n * exponential back-off automatically.\n *\n * Call worker.close() during graceful shutdown to drain in-flight jobs.\n *\n * @example\n * ```ts\n * const worker = createNotificationWorker(registry, redis, { concurrency: 5 })\n *\n * process.on('SIGTERM', async () => {\n *   await worker.close()\n * })\n * ```\n */\nexport function createNotificationWorker(\n  registry: DriverRegistry,\n  redis: Redis,\n  opts: WorkerOptions = {},\n): Worker<NotificationJob> {\n  const concurrency = opts.concurrency ?? 5\n\n  const worker = new Worker<NotificationJob>(\n    NOTIFICATION_QUEUE_NAME,\n    async (job) => {\n      const { driverName, notification } = job.data\n\n      const driver = registry.getDriver(driverName)\n      if (!driver) {\n        throw new Error(`Notification driver \"${driverName}\" is not registered`)\n      }\n\n      await driver.send(notification)\n    },\n    {\n      connection: redis,\n      concurrency,\n      // Don't create a new redis connection per job — reuse the pool\n      autorun: true,\n    },\n  )\n\n  worker.on('failed', (job, err) => {\n    // BullMQ handles retries; this is just for observability\n    const jobId = job?.id ?? 'unknown'\n    const message = err instanceof Error ? err.message : String(err)\n    console.error(`[notifications] Job ${jobId} failed: ${message}`)\n  })\n\n  return worker\n}\n","// Generated by feathers-baas. Safe to edit.\nimport nodemailer from 'nodemailer'\nimport * as ejs from 'ejs'\nimport type { NotifierDriver, Notification } from '../types.js'\n\n// ejs is a CommonJS module — alias the render function defensively\nconst ejsRender = (ejs as unknown as { render?: typeof ejs.render }).render ?? ejs.render\n\nexport interface SMTPDriverOptions {\n  /** SMTP connection URL, e.g. smtp://user:pass@mail.example.com:587 */\n  url: string\n  /** Display name shown in the From field. */\n  fromName: string\n  /** Email address shown in the From field. */\n  fromAddress: string\n}\n\n/**\n * Email driver backed by nodemailer over SMTP.\n * Templates are rendered with EJS at send time.\n *\n * Use this driver for self-hosted SMTP servers (Postfix, Mailtrap, etc.).\n * For transactional email services, prefer ResendDriver.\n */\nexport class SMTPDriver implements NotifierDriver {\n  readonly name = 'smtp'\n\n  private readonly transporter: nodemailer.Transporter\n\n  constructor(private readonly opts: SMTPDriverOptions) {\n    this.transporter = nodemailer.createTransport(opts.url)\n  }\n\n  async send(notification: Notification): Promise<void> {\n    const html = ejsRender(notification.bodyTemplate, notification.data, { async: false })\n    const text = notification.textTemplate\n      ? ejsRender(notification.textTemplate, notification.data, { async: false })\n      : undefined\n\n    await this.transporter.sendMail({\n      from: `\"${this.opts.fromName}\" <${this.opts.fromAddress}>`,\n      to: notification.to,\n      subject: notification.subject ?? '(no subject)',\n      html,\n      text,\n    })\n  }\n\n  /** Verify SMTP connectivity. Throws if the server is unreachable. */\n  async verify(): Promise<void> {\n    await this.transporter.verify()\n  }\n\n  /** Close the underlying connection pool. */\n  close(): void {\n    this.transporter.close()\n  }\n}\n","// Generated by feathers-baas. Safe to edit.\nimport { Resend } from 'resend'\nimport * as ejs from 'ejs'\nimport type { NotifierDriver, Notification } from '../types.js'\n\nconst ejsRender = (ejs as unknown as { render?: typeof ejs.render }).render ?? ejs.render\n\nexport interface ResendDriverOptions {\n  /** Resend API key (from https://resend.com/api-keys). */\n  apiKey: string\n  /** Display name shown in the From field. */\n  fromName: string\n  /** Verified sender address. Must be a verified domain in your Resend account. */\n  fromAddress: string\n}\n\n/**\n * Email driver backed by the Resend transactional email API.\n * Templates are rendered with EJS at send time.\n *\n * Resend offers generous free tier and excellent deliverability,\n * making it the recommended choice for new projects.\n */\nexport class ResendDriver implements NotifierDriver {\n  readonly name = 'resend'\n\n  private readonly client: Resend\n\n  constructor(private readonly opts: ResendDriverOptions) {\n    this.client = new Resend(opts.apiKey)\n  }\n\n  async send(notification: Notification): Promise<void> {\n    const html = ejsRender(notification.bodyTemplate, notification.data, { async: false })\n    const text = notification.textTemplate\n      ? ejsRender(notification.textTemplate, notification.data, { async: false })\n      : undefined\n\n    const result = await this.client.emails.send({\n      from: `${this.opts.fromName} <${this.opts.fromAddress}>`,\n      to: [notification.to],\n      subject: notification.subject ?? '(no subject)',\n      html,\n      text,\n    })\n\n    if ('error' in result && result.error) {\n      throw new Error(`Resend error: ${result.error.message}`)\n    }\n  }\n}\n","// Generated by feathers-baas. Safe to edit.\nimport sgMail from '@sendgrid/mail'\nimport * as ejs from 'ejs'\nimport type { NotifierDriver, Notification } from '../types.js'\n\n// ejs is a CommonJS module — alias the render function defensively\nconst ejsRender = (ejs as unknown as { render?: typeof ejs.render }).render ?? ejs.render\n\nexport interface SendGridDriverOptions {\n  /** SendGrid API key (from https://app.sendgrid.com/settings/api_keys). */\n  apiKey: string\n  /** Display name shown in the From field. */\n  fromName: string\n  /** Verified sender address. Must be verified in your SendGrid account. */\n  fromAddress: string\n}\n\n/**\n * Email driver backed by the SendGrid API.\n * Templates are rendered with EJS at send time.\n */\nexport class SendGridDriver implements NotifierDriver {\n  readonly name = 'sendgrid'\n\n  constructor(private readonly opts: SendGridDriverOptions) {\n    sgMail.setApiKey(opts.apiKey)\n  }\n\n  async send(notification: Notification): Promise<void> {\n    const html = ejsRender(notification.bodyTemplate, notification.data, { async: false })\n    const text = notification.textTemplate\n      ? ejsRender(notification.textTemplate, notification.data, { async: false })\n      : undefined\n\n    await sgMail.send({\n      from: { name: this.opts.fromName, email: this.opts.fromAddress },\n      to: notification.to,\n      subject: notification.subject ?? '(no subject)',\n      html,\n      ...(text ? { text } : {}),\n    })\n  }\n}\n","// Generated by feathers-baas. Safe to edit.\nimport { TransactionalEmailsApi, TransactionalEmailsApiApiKeys, SendSmtpEmail } from '@getbrevo/brevo'\nimport * as ejs from 'ejs'\nimport type { NotifierDriver, Notification } from '../types.js'\n\n// ejs is a CommonJS module — alias the render function defensively\nconst ejsRender = (ejs as unknown as { render?: typeof ejs.render }).render ?? ejs.render\n\nexport interface BrevoDriverOptions {\n  /** Brevo API key (from https://app.brevo.com/settings/keys/api). */\n  apiKey: string\n  /** Display name shown in the From field. */\n  fromName: string\n  /** Verified sender address. Must be verified in your Brevo account. */\n  fromAddress: string\n}\n\n/**\n * Email driver backed by the Brevo (formerly Sendinblue) Transactional Email API.\n * Templates are rendered with EJS at send time.\n */\nexport class BrevoDriver implements NotifierDriver {\n  readonly name = 'brevo'\n\n  private readonly apiInstance: TransactionalEmailsApi\n\n  constructor(private readonly opts: BrevoDriverOptions) {\n    this.apiInstance = new TransactionalEmailsApi()\n    this.apiInstance.setApiKey(TransactionalEmailsApiApiKeys.apiKey, opts.apiKey)\n  }\n\n  async send(notification: Notification): Promise<void> {\n    const html = ejsRender(notification.bodyTemplate, notification.data, { async: false })\n    const text = notification.textTemplate\n      ? ejsRender(notification.textTemplate, notification.data, { async: false })\n      : undefined\n\n    const email = new SendSmtpEmail()\n    email.sender = { name: this.opts.fromName, email: this.opts.fromAddress }\n    email.to = [{ email: notification.to }]\n    email.subject = notification.subject ?? '(no subject)'\n    email.htmlContent = html\n    if (text) email.textContent = text\n\n    await this.apiInstance.sendTransacEmail(email)\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,yBAA8B;;;ACiBvB,IAAM,iBAAN,MAAqB;AAAA,EACT,UAAU,oBAAI,IAA4B;AAAA,EAC1C,WAAW,oBAAI,IAAiC;AAAA;AAAA,EAGjE,eAAe,QAA8B;AAC3C,SAAK,QAAQ,IAAI,OAAO,MAAM,MAAM;AAAA,EACtC;AAAA;AAAA,EAGA,SAAS,OAA0B,YAA0B;AAC3D,UAAM,WAAW,KAAK,SAAS,IAAI,KAAK,KAAK,CAAC;AAC9C,QAAI,CAAC,SAAS,SAAS,UAAU,GAAG;AAClC,eAAS,KAAK,UAAU;AAAA,IAC1B;AACA,SAAK,SAAS,IAAI,OAAO,QAAQ;AAAA,EACnC;AAAA;AAAA,EAGA,UAAU,MAA0C;AAClD,WAAO,KAAK,QAAQ,IAAI,IAAI;AAAA,EAC9B;AAAA;AAAA,EAGA,mBAAmB,OAAoC;AACrD,WAAO,KAAK,SAAS,IAAI,KAAK,KAAK,CAAC;AAAA,EACtC;AAAA;AAAA,EAGA,kBAA4B;AAC1B,WAAO,CAAC,GAAG,KAAK,QAAQ,KAAK,CAAC;AAAA,EAChC;AACF;;;ACjDA,oBAAsB;AAIf,IAAM,0BAA0B;AAYhC,SAAS,wBAAwB,OAAsC;AAC5E,SAAO,IAAI,oBAAuB,yBAAyB;AAAA,IACzD,YAAY;AAAA,IACZ,mBAAmB;AAAA,MACjB,UAAU;AAAA,MACV,SAAS;AAAA,QACP,MAAM;AAAA,QACN,OAAO;AAAA;AAAA,MACT;AAAA,MACA,kBAAkB,EAAE,OAAO,IAAI;AAAA,MAC/B,cAAc,EAAE,OAAO,IAAI;AAAA,IAC7B;AAAA,EACF,CAAC;AACH;AAQA,eAAsB,oBACpB,OACA,KACe;AACf,QAAM,MAAM,IAAI,QAAQ,GAAG;AAC7B;;;ACjCA,IAAM,4BAAmE;AAAA,EACvE,oBAAoB;AAAA,EACpB,cAAc;AAAA,EACd,yBAAyB;AAAA,EACzB,cAAc;AAAA,EACd,UAAU;AAAA,EACV,gBAAgB;AAAA,EAChB,gBAAgB;AAClB;AAMA,SAAS,sBACP,MACA,MACA,QACqB;AACrB,QAAM,QAAQ,KAAK,OAAO;AAC1B,MAAI,CAAC,MAAO,QAAO;AAEnB,UAAQ,MAAM;AAAA,IACZ,KAAK;AAAA,IACL,KAAK,6BAA6B;AAChC,YAAM,QAAQ,KAAK,aAAa;AAChC,YAAM,YAAY,GAAG,MAAM,iBAAiB,SAAS,EAAE;AACvD,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,SAAS;AAAA,QACT,SAAS;AAAA,QACT,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAMd,cAAc;AAAA,QACd,MAAM,EAAE,WAAW,KAAK;AAAA,MAC1B;AAAA,IACF;AAAA,IAEA,KAAK,uBAAuB;AAC1B,YAAM,QAAQ,KAAK,YAAY;AAC/B,YAAM,WAAW,GAAG,MAAM,yBAAyB,SAAS,EAAE;AAC9D,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,SAAS;AAAA,QACT,SAAS;AAAA,QACT,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAMd,cAAc;AAAA,QACd,MAAM,EAAE,UAAU,KAAK;AAAA,MACzB;AAAA,IACF;AAAA,IAEA,KAAK,kBAAkB;AACrB,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,SAAS;AAAA,QACT,SAAS;AAAA,QACT,cAAc;AAAA,QACd,cAAc;AAAA,QACd,MAAM,EAAE,KAAK;AAAA,MACf;AAAA,IACF;AAAA,IAEA,KAAK,wBAAwB;AAC3B,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,SAAS;AAAA,QACT,SAAS;AAAA,QACT,cAAc;AAAA,QACd,cAAc;AAAA,QACd,MAAM,EAAE,KAAK;AAAA,MACf;AAAA,IACF;AAAA,IAEA,KAAK,wBAAwB;AAC3B,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,SAAS;AAAA,QACT,SAAS;AAAA,QACT,cAAc;AAAA,QACd,cAAc;AAAA,QACd,MAAM,EAAE,KAAK;AAAA,MACf;AAAA,IACF;AAAA,IAEA,KAAK,mCAAmC;AACtC,YAAM,QAAQ,KAAK,aAAa;AAChC,YAAM,YAAY,GAAG,MAAM,8BAA8B,SAAS,EAAE;AACpE,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,SAAS;AAAA,QACT,SAAS;AAAA,QACT,cAAc;AAAA;AAAA;AAAA;AAAA,QAId,cAAc;AAAA,QACd,MAAM,EAAE,WAAW,KAAK;AAAA,MAC1B;AAAA,IACF;AAAA,EACF;AACF;AA8CO,SAAS,qBAAqB,MAAyC;AAC5E,SAAO,OAAO,MAAM,MAAM,qBAAqB;AAC7C,UAAM,WAAW,0BAA0B,IAAI;AAC/C,QAAI,CAAC,SAAU;AAEf,UAAM,eAAe,sBAAsB,UAAU,MAAM,KAAK,MAAM;AACtE,QAAI,CAAC,aAAc;AAEnB,UAAM,cAAc,KAAK,SAAS,mBAAmB,QAAQ;AAC7D,QAAI,YAAY,WAAW,EAAG;AAE9B,UAAM,QAAQ;AAAA,MACZ,YAAY,IAAI,OAAO,eAAe;AACpC,cAAM,SAAS,KAAK,SAAS,UAAU,UAAU;AACjD,YAAI,CAAC,OAAQ;AACb,cAAM,OAAO,KAAK,YAAY;AAAA,MAChC,CAAC;AAAA,IACH;AAAA,EACF;AACF;AAEO,SAAS,qBAAqB,MAAyC;AAC5E,SAAO,OAAO,MAAM,MAAM,qBAAqB;AAC7C,UAAM,WAAW,0BAA0B,IAAI;AAC/C,QAAI,CAAC,SAAU;AAEf,UAAM,eAAe,sBAAsB,UAAU,MAAM,KAAK,MAAM;AACtE,QAAI,CAAC,aAAc;AAEnB,UAAM,cAAc,KAAK,SAAS,mBAAmB,QAAQ;AAC7D,QAAI,YAAY,WAAW,EAAG;AAE9B,UAAM,QAAQ;AAAA,MACZ,YAAY;AAAA,QAAI,CAAC,eACf,oBAAoB,KAAK,OAAO,EAAE,YAAY,aAAa,CAAC;AAAA,MAC9D;AAAA,IACF;AAAA,EACF;AACF;;;AC1MA,IAAAA,iBAAuB;AA6BhB,SAAS,yBACd,UACA,OACA,OAAsB,CAAC,GACE;AACzB,QAAM,cAAc,KAAK,eAAe;AAExC,QAAM,SAAS,IAAI;AAAA,IACjB;AAAA,IACA,OAAO,QAAQ;AACb,YAAM,EAAE,YAAY,aAAa,IAAI,IAAI;AAEzC,YAAM,SAAS,SAAS,UAAU,UAAU;AAC5C,UAAI,CAAC,QAAQ;AACX,cAAM,IAAI,MAAM,wBAAwB,UAAU,qBAAqB;AAAA,MACzE;AAEA,YAAM,OAAO,KAAK,YAAY;AAAA,IAChC;AAAA,IACA;AAAA,MACE,YAAY;AAAA,MACZ;AAAA;AAAA,MAEA,SAAS;AAAA,IACX;AAAA,EACF;AAEA,SAAO,GAAG,UAAU,CAAC,KAAK,QAAQ;AAEhC,UAAM,QAAQ,KAAK,MAAM;AACzB,UAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC/D,YAAQ,MAAM,uBAAuB,KAAK,YAAY,OAAO,EAAE;AAAA,EACjE,CAAC;AAED,SAAO;AACT;;;AChEA,wBAAuB;AACvB,UAAqB;AAIrB,IAAM,YAA+D,cAAc;AAkB5E,IAAM,aAAN,MAA2C;AAAA,EAKhD,YAA6B,MAAyB;AAAzB;AAC3B,SAAK,cAAc,kBAAAC,QAAW,gBAAgB,KAAK,GAAG;AAAA,EACxD;AAAA,EAF6B;AAAA,EAJpB,OAAO;AAAA,EAEC;AAAA,EAMjB,MAAM,KAAK,cAA2C;AACpD,UAAM,OAAO,UAAU,aAAa,cAAc,aAAa,MAAM,EAAE,OAAO,MAAM,CAAC;AACrF,UAAM,OAAO,aAAa,eACtB,UAAU,aAAa,cAAc,aAAa,MAAM,EAAE,OAAO,MAAM,CAAC,IACxE;AAEJ,UAAM,KAAK,YAAY,SAAS;AAAA,MAC9B,MAAM,IAAI,KAAK,KAAK,QAAQ,MAAM,KAAK,KAAK,WAAW;AAAA,MACvD,IAAI,aAAa;AAAA,MACjB,SAAS,aAAa,WAAW;AAAA,MACjC;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,SAAwB;AAC5B,UAAM,KAAK,YAAY,OAAO;AAAA,EAChC;AAAA;AAAA,EAGA,QAAc;AACZ,SAAK,YAAY,MAAM;AAAA,EACzB;AACF;;;ACxDA,oBAAuB;AACvB,IAAAC,OAAqB;AAGrB,IAAMC,aAA+D,eAAc;AAkB5E,IAAM,eAAN,MAA6C;AAAA,EAKlD,YAA6B,MAA2B;AAA3B;AAC3B,SAAK,SAAS,IAAI,qBAAO,KAAK,MAAM;AAAA,EACtC;AAAA,EAF6B;AAAA,EAJpB,OAAO;AAAA,EAEC;AAAA,EAMjB,MAAM,KAAK,cAA2C;AACpD,UAAM,OAAOA,WAAU,aAAa,cAAc,aAAa,MAAM,EAAE,OAAO,MAAM,CAAC;AACrF,UAAM,OAAO,aAAa,eACtBA,WAAU,aAAa,cAAc,aAAa,MAAM,EAAE,OAAO,MAAM,CAAC,IACxE;AAEJ,UAAM,SAAS,MAAM,KAAK,OAAO,OAAO,KAAK;AAAA,MAC3C,MAAM,GAAG,KAAK,KAAK,QAAQ,KAAK,KAAK,KAAK,WAAW;AAAA,MACrD,IAAI,CAAC,aAAa,EAAE;AAAA,MACpB,SAAS,aAAa,WAAW;AAAA,MACjC;AAAA,MACA;AAAA,IACF,CAAC;AAED,QAAI,WAAW,UAAU,OAAO,OAAO;AACrC,YAAM,IAAI,MAAM,iBAAiB,OAAO,MAAM,OAAO,EAAE;AAAA,IACzD;AAAA,EACF;AACF;;;ACjDA,kBAAmB;AACnB,IAAAC,OAAqB;AAIrB,IAAMC,aAA+D,eAAc;AAe5E,IAAM,iBAAN,MAA+C;AAAA,EAGpD,YAA6B,MAA6B;AAA7B;AAC3B,gBAAAC,QAAO,UAAU,KAAK,MAAM;AAAA,EAC9B;AAAA,EAF6B;AAAA,EAFpB,OAAO;AAAA,EAMhB,MAAM,KAAK,cAA2C;AACpD,UAAM,OAAOD,WAAU,aAAa,cAAc,aAAa,MAAM,EAAE,OAAO,MAAM,CAAC;AACrF,UAAM,OAAO,aAAa,eACtBA,WAAU,aAAa,cAAc,aAAa,MAAM,EAAE,OAAO,MAAM,CAAC,IACxE;AAEJ,UAAM,YAAAC,QAAO,KAAK;AAAA,MAChB,MAAM,EAAE,MAAM,KAAK,KAAK,UAAU,OAAO,KAAK,KAAK,YAAY;AAAA,MAC/D,IAAI,aAAa;AAAA,MACjB,SAAS,aAAa,WAAW;AAAA,MACjC;AAAA,MACA,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC;AAAA,IACzB,CAAC;AAAA,EACH;AACF;;;ACzCA,mBAAqF;AACrF,IAAAC,OAAqB;AAIrB,IAAMC,aAA+D,eAAc;AAe5E,IAAM,cAAN,MAA4C;AAAA,EAKjD,YAA6B,MAA0B;AAA1B;AAC3B,SAAK,cAAc,IAAI,oCAAuB;AAC9C,SAAK,YAAY,UAAU,2CAA8B,QAAQ,KAAK,MAAM;AAAA,EAC9E;AAAA,EAH6B;AAAA,EAJpB,OAAO;AAAA,EAEC;AAAA,EAOjB,MAAM,KAAK,cAA2C;AACpD,UAAM,OAAOA,WAAU,aAAa,cAAc,aAAa,MAAM,EAAE,OAAO,MAAM,CAAC;AACrF,UAAM,OAAO,aAAa,eACtBA,WAAU,aAAa,cAAc,aAAa,MAAM,EAAE,OAAO,MAAM,CAAC,IACxE;AAEJ,UAAM,QAAQ,IAAI,2BAAc;AAChC,UAAM,SAAS,EAAE,MAAM,KAAK,KAAK,UAAU,OAAO,KAAK,KAAK,YAAY;AACxE,UAAM,KAAK,CAAC,EAAE,OAAO,aAAa,GAAG,CAAC;AACtC,UAAM,UAAU,aAAa,WAAW;AACxC,UAAM,cAAc;AACpB,QAAI,KAAM,OAAM,cAAc;AAE9B,UAAM,KAAK,YAAY,iBAAiB,KAAK;AAAA,EAC/C;AACF;;;AR9CA;AAIA,IAAM,UAAM,kCAAc,YAAY,GAAG,EAAE,iBAAiB;AAE5D,IAAM,SAA6B;AAAA,EACjC,MAAM;AAAA,EACN,SAAS,IAAI;AAAA,EACb,MAAM,QAAQ,MAAM,UAAU;AAAA,EAG9B;AACF;AAEA,IAAO,gBAAQ;","names":["import_bullmq","nodemailer","ejs","ejsRender","ejs","ejsRender","sgMail","ejs","ejsRender"]}
+{"version":3,"sources":["../src/index.ts","../src/registry.ts","../src/queue/producer.ts","../src/notifier.ts","../src/queue/worker.ts","../src/drivers/smtp.driver.ts","../src/drivers/resend.driver.ts","../src/drivers/sendgrid.driver.ts","../src/drivers/brevo.driver.ts"],"sourcesContent":["// Generated by feathers-baas. Safe to edit.\nimport { createRequire } from 'node:module'\nimport type { FeathersBaasPlugin } from './plugin.js'\n\nconst pkg = createRequire(import.meta.url)('../package.json') as { version: string }\n\nconst plugin: FeathersBaasPlugin = {\n  name: '@feathers-baas/plugin-notifications',\n  version: pkg.version,\n  async install(_app, _options) {\n    // Notification drivers are configured via core's configureNotifications()\n    // based on env vars. Auto-install is a no-op; discovery confirms the plugin is present.\n  },\n}\n\nexport default plugin\n\nexport { DriverRegistry } from './registry.js'\nexport { createBullMQNotifier, createDirectNotifier, buildAuthNotification, formatDuration } from './notifier.js'\nexport type {\n  NotifierFn,\n  BullMQNotifierOptions,\n  DirectNotifierOptions,\n  AuthNotificationOptions,\n  AuthNotificationBuilder,\n} from './notifier.js'\n\n// Queue\nexport {\n  createNotificationQueue,\n  enqueueNotification,\n  NOTIFICATION_QUEUE_NAME,\n  NOTIFICATION_QUEUE_PREFIX,\n} from './queue/producer.js'\nexport { createNotificationWorker } from './queue/worker.js'\nexport type { WorkerOptions } from './queue/worker.js'\n\n// Drivers\nexport { SMTPDriver } from './drivers/smtp.driver.js'\nexport type { SMTPDriverOptions } from './drivers/smtp.driver.js'\nexport { ResendDriver } from './drivers/resend.driver.js'\nexport type { ResendDriverOptions } from './drivers/resend.driver.js'\nexport { SendGridDriver } from './drivers/sendgrid.driver.js'\nexport type { SendGridDriverOptions } from './drivers/sendgrid.driver.js'\nexport { BrevoDriver } from './drivers/brevo.driver.js'\nexport type { BrevoDriverOptions } from './drivers/brevo.driver.js'\n\n// Types\nexport type {\n  Notification,\n  NotifierDriver,\n  NotificationJob,\n  NotificationEvent,\n  AuthNotificationEvent,\n} from './types.js'\n","// Generated by feathers-baas. Safe to edit.\nimport type { NotifierDriver, NotificationEvent } from './types.js'\n\n/**\n * DriverRegistry maps event keys to the list of drivers that should handle\n * that event.\n *\n * A single driver instance can handle multiple events (e.g. the SMTP driver\n * handles all auth.* email events).\n *\n * @example\n * ```ts\n * const registry = new DriverRegistry()\n * registry.registerDriver(smtpDriver)\n * registry.mapEvent('auth.verify-signup', 'smtp')\n * registry.mapEvent('auth.send-reset-pwd', 'smtp')\n * ```\n */\nexport class DriverRegistry {\n  private readonly drivers = new Map<string, NotifierDriver>()\n  private readonly eventMap = new Map<NotificationEvent, string[]>()\n\n  /** Register a driver under its name. Overwrites any existing driver with the same name. */\n  registerDriver(driver: NotifierDriver): void {\n    this.drivers.set(driver.name, driver)\n  }\n\n  /** Map a notification event to a driver name. Multiple calls for the same event add drivers. */\n  mapEvent(event: NotificationEvent, driverName: string): void {\n    const existing = this.eventMap.get(event) ?? []\n    if (!existing.includes(driverName)) {\n      existing.push(driverName)\n    }\n    this.eventMap.set(event, existing)\n  }\n\n  /** Look up a driver by name. Returns undefined if not registered. */\n  getDriver(name: string): NotifierDriver | undefined {\n    return this.drivers.get(name)\n  }\n\n  /** Get all driver names mapped to the given event. */\n  getDriversForEvent(event: NotificationEvent): string[] {\n    return this.eventMap.get(event) ?? []\n  }\n\n  /** All registered driver names. */\n  listDriverNames(): string[] {\n    return [...this.drivers.keys()]\n  }\n}\n","// Generated by feathers-baas. Safe to edit.\nimport { Queue } from 'bullmq'\nimport type { Redis } from 'ioredis'\nimport type { NotificationJob } from '../types.js'\n\n// BullMQ rejects ':' in queue names — namespace with its `prefix` option instead.\nexport const NOTIFICATION_QUEUE_NAME = 'feathers-baas-notifications'\nexport const NOTIFICATION_QUEUE_PREFIX = 'feathers-baas'\n\n/**\n * Create a BullMQ Queue instance for notification jobs.\n *\n * @example\n * ```ts\n * const redis = new Redis(process.env.REDIS_URL)\n * const queue = createNotificationQueue(redis)\n * await enqueueNotification(queue, { driverName: 'smtp', notification: { ... } })\n * ```\n */\nexport function createNotificationQueue(redis: Redis): Queue<NotificationJob> {\n  return new Queue<NotificationJob>(NOTIFICATION_QUEUE_NAME, {\n    connection: redis,\n    prefix: NOTIFICATION_QUEUE_PREFIX,\n    defaultJobOptions: {\n      attempts: 5,\n      backoff: {\n        type: 'exponential',\n        delay: 1_000, // initial delay: 1s → 2s → 4s → 8s → 16s\n      },\n      removeOnComplete: { count: 100 },\n      removeOnFail: { count: 500 },\n    },\n  })\n}\n\n/**\n * Enqueue a notification job.\n *\n * @param queue  BullMQ Queue instance from createNotificationQueue()\n * @param job    Job payload { driverName, notification }\n */\nexport async function enqueueNotification(\n  queue: Queue<NotificationJob>,\n  job: NotificationJob,\n): Promise<void> {\n  await queue.add('send', job)\n}\n","// Generated by feathers-baas. Safe to edit.\nimport type { Queue } from 'bullmq'\nimport type { NotificationJob, Notification, AuthNotificationEvent } from './types.js'\nimport { enqueueNotification } from './queue/producer.js'\nimport type { DriverRegistry } from './registry.js'\n\n/**\n * Auth-management notification types mapped to feathers-baas event keys.\n * feathers-authentication-management passes these type strings to the notifier.\n */\nconst AUTH_MANAGEMENT_EVENT_MAP: Record<string, AuthNotificationEvent> = {\n  resendVerifySignup: 'auth.resend-verify-signup',\n  verifySignup: 'auth.verify-signup',\n  verifySignupSetPassword: 'auth.verify-signup-set-password',\n  sendResetPwd: 'auth.send-reset-pwd',\n  resetPwd: 'auth.reset-pwd',\n  passwordChange: 'auth.password-change',\n  identityChange: 'auth.identity-change',\n}\n\n/** Defaults match feathers-authentication-management's own `delay` / `resetDelay`. */\nconst DEFAULT_VERIFY_DELAY_MS = 1000 * 60 * 60 * 24 * 5\nconst DEFAULT_RESET_DELAY_MS = 1000 * 60 * 60 * 2\n\nexport interface AuthNotificationOptions {\n  /**\n   * Public base URL of the **web app** that redeems the tokens (not this API),\n   * e.g. https://app.example.com\n   */\n  appUrl: string\n  /** Frontend routes the email links point to. */\n  paths?: {\n    /** Default: `/verify` */\n    verify?: string\n    /** Default: `/reset-password` */\n    resetPassword?: string\n    /** Default: `/verify-set-password` */\n    verifySetPassword?: string\n  }\n  /** Verification token lifetime in ms — must match auth-management's `delay`. Default: 5 days. */\n  verifyDelay?: number\n  /** Reset token lifetime in ms — must match auth-management's `resetDelay`. Default: 2 hours. */\n  resetDelay?: number\n}\n\nexport type AuthNotificationBuilder = (\n  type: AuthNotificationEvent,\n  user: Record<string, unknown>,\n  opts: AuthNotificationOptions,\n) => Notification | null\n\n/** Human-readable duration for email copy, e.g. 432000000 → \"5 days\". */\nexport function formatDuration(ms: number): string {\n  const units: [string, number][] = [\n    ['day', 86_400_000],\n    ['hour', 3_600_000],\n    ['minute', 60_000],\n  ]\n  for (const [name, size] of units) {\n    if (ms >= size && ms % size === 0) {\n      const n = ms / size\n      return `${n} ${name}${n === 1 ? '' : 's'}`\n    }\n  }\n  const minutes = Math.max(1, Math.round(ms / 60_000))\n  return `${minutes} minute${minutes === 1 ? '' : 's'}`\n}\n\nfunction buildLink(appUrl: string, path: string, token: string | undefined): string {\n  const base = appUrl.replace(/\\/+$/, '')\n  const route = path.startsWith('/') ? path : `/${path}`\n  return `${base}${route}?token=${encodeURIComponent(token ?? '')}`\n}\n\n/**\n * Build the default Notification payload for each auth event type.\n * Exported so apps can wrap it via the notifier's `buildNotification` option.\n * Templates use EJS — `<%= variable %>` for output, `<% code %>` for logic.\n */\nexport function buildAuthNotification(\n  type: AuthNotificationEvent,\n  user: Record<string, unknown>,\n  opts: AuthNotificationOptions,\n): Notification | null {\n  const { appUrl, paths = {} } = opts\n  const verifyExpiry = formatDuration(opts.verifyDelay ?? DEFAULT_VERIFY_DELAY_MS)\n  const resetExpiry = formatDuration(opts.resetDelay ?? DEFAULT_RESET_DELAY_MS)\n  const email = user['email'] as string\n  if (!email) return null\n\n  switch (type) {\n    case 'auth.verify-signup':\n    case 'auth.resend-verify-signup': {\n      const token = user['verifyToken'] as string | undefined\n      const verifyUrl = buildLink(appUrl, paths.verify ?? '/verify', token)\n      return {\n        to: email,\n        channel: 'email',\n        subject: 'Verify your email address',\n        bodyTemplate: `\n          <h2>Welcome!</h2>\n          <p>Click the link below to verify your email address:</p>\n          <p><a href=\"<%= verifyUrl %>\">Verify email</a></p>\n          <p>This link expires in <%= expiresIn %>.</p>\n        `,\n        textTemplate: `Verify your email: <%= verifyUrl %>`,\n        data: { verifyUrl, expiresIn: verifyExpiry, user },\n      }\n    }\n\n    case 'auth.send-reset-pwd': {\n      const token = user['resetToken'] as string | undefined\n      const resetUrl = buildLink(appUrl, paths.resetPassword ?? '/reset-password', token)\n      return {\n        to: email,\n        channel: 'email',\n        subject: 'Reset your password',\n        bodyTemplate: `\n          <h2>Password reset requested</h2>\n          <p>Click the link below to reset your password:</p>\n          <p><a href=\"<%= resetUrl %>\">Reset password</a></p>\n          <p>This link expires in <%= expiresIn %>. If you did not request this, ignore this email.</p>\n        `,\n        textTemplate: `Reset your password: <%= resetUrl %>`,\n        data: { resetUrl, expiresIn: resetExpiry, user },\n      }\n    }\n\n    case 'auth.reset-pwd': {\n      return {\n        to: email,\n        channel: 'email',\n        subject: 'Your password has been reset',\n        bodyTemplate: `<p>Your password has been successfully reset. If you did not do this, please contact support immediately.</p>`,\n        textTemplate: `Your password has been reset. If you did not do this, please contact support.`,\n        data: { user },\n      }\n    }\n\n    case 'auth.password-change': {\n      return {\n        to: email,\n        channel: 'email',\n        subject: 'Your password has been changed',\n        bodyTemplate: `<p>Your account password was just changed. If this was not you, please contact support immediately.</p>`,\n        textTemplate: `Your password was changed. Contact support if this wasn't you.`,\n        data: { user },\n      }\n    }\n\n    case 'auth.identity-change': {\n      return {\n        to: email,\n        channel: 'email',\n        subject: 'Your email address is being changed',\n        bodyTemplate: `<p>A request was made to change your email address. Click the link to confirm.</p>`,\n        textTemplate: `Confirm your email change by clicking the link in the HTML email.`,\n        data: { user },\n      }\n    }\n\n    case 'auth.verify-signup-set-password': {\n      const token = user['verifyToken'] as string | undefined\n      const verifyUrl = buildLink(appUrl, paths.verifySetPassword ?? '/verify-set-password', token)\n      return {\n        to: email,\n        channel: 'email',\n        subject: 'Set your password',\n        bodyTemplate: `\n          <h2>Set your password</h2>\n          <p><a href=\"<%= verifyUrl %>\">Set password</a></p>\n        `,\n        textTemplate: `Set your password: <%= verifyUrl %>`,\n        data: { verifyUrl, user },\n      }\n    }\n  }\n}\n\nexport type NotifierFn = (\n  type: string,\n  user: Record<string, unknown>,\n  notifierOptions: Record<string, unknown>,\n) => Promise<void>\n\ninterface NotifierBaseOptions extends AuthNotificationOptions {\n  /** Driver registry — used to determine which drivers handle each event. */\n  registry: DriverRegistry\n  /** Replace the default email composition. Wrap `buildAuthNotification` to tweak it. */\n  buildNotification?: AuthNotificationBuilder\n}\n\nexport interface BullMQNotifierOptions extends NotifierBaseOptions {\n  /** BullMQ Queue instance — from createNotificationQueue(). */\n  queue: Queue<NotificationJob>\n}\n\n/**\n * Create a notifier function compatible with feathers-authentication-management.\n *\n * When an auth event fires (verifySignup, sendResetPwd, etc.), this notifier:\n * 1. Maps the event type to a feathers-baas notification event key\n * 2. Looks up all registered drivers for that event\n * 3. Enqueues one BullMQ job per driver\n * 4. Returns immediately — delivery is asynchronous\n *\n * Wire into the app:\n * ```ts\n * app.set('notifier', createBullMQNotifier({ queue, registry, appUrl }))\n * ```\n */\nexport type DirectNotifierOptions = NotifierBaseOptions\n\n/**\n * Create a notifier that sends notifications directly via the driver (no queue).\n * Use this when Redis/BullMQ is not available — suitable for API-based drivers\n * (Brevo, Resend, SendGrid) in development or low-traffic environments.\n */\nexport function createDirectNotifier(opts: DirectNotifierOptions): NotifierFn {\n  return async (type, user, _notifierOptions) => {\n    const eventKey = AUTH_MANAGEMENT_EVENT_MAP[type]\n    if (!eventKey) return\n\n    const notification = (opts.buildNotification ?? buildAuthNotification)(eventKey, user, opts)\n    if (!notification) return\n\n    const driverNames = opts.registry.getDriversForEvent(eventKey)\n    if (driverNames.length === 0) return\n\n    await Promise.all(\n      driverNames.map(async (driverName) => {\n        const driver = opts.registry.getDriver(driverName)\n        if (!driver) return\n        await driver.send(notification)\n      }),\n    )\n  }\n}\n\nexport function createBullMQNotifier(opts: BullMQNotifierOptions): NotifierFn {\n  return async (type, user, _notifierOptions) => {\n    const eventKey = AUTH_MANAGEMENT_EVENT_MAP[type]\n    if (!eventKey) return // Unknown event type — no-op\n\n    const notification = (opts.buildNotification ?? buildAuthNotification)(eventKey, user, opts)\n    if (!notification) return // Missing required user fields — no-op\n\n    const driverNames = opts.registry.getDriversForEvent(eventKey)\n    if (driverNames.length === 0) return // No drivers configured for this event\n\n    await Promise.all(\n      driverNames.map((driverName) =>\n        enqueueNotification(opts.queue, { driverName, notification }),\n      ),\n    )\n  }\n}\n","// Generated by feathers-baas. Safe to edit.\nimport { Worker } from 'bullmq'\nimport type { Redis } from 'ioredis'\nimport type { DriverRegistry } from '../registry.js'\nimport type { NotificationJob } from '../types.js'\nimport { NOTIFICATION_QUEUE_NAME, NOTIFICATION_QUEUE_PREFIX } from './producer.js'\n\nexport interface WorkerOptions {\n  /** BullMQ concurrency — number of jobs processed in parallel. */\n  concurrency?: number\n}\n\n/**\n * Create and start the BullMQ worker that processes notification jobs.\n *\n * The worker looks up the driver from the registry by name, renders the\n * EJS template, and calls driver.send(). BullMQ handles retries with\n * exponential back-off automatically.\n *\n * Call worker.close() during graceful shutdown to drain in-flight jobs.\n *\n * @example\n * ```ts\n * const worker = createNotificationWorker(registry, redis, { concurrency: 5 })\n *\n * process.on('SIGTERM', async () => {\n *   await worker.close()\n * })\n * ```\n */\nexport function createNotificationWorker(\n  registry: DriverRegistry,\n  redis: Redis,\n  opts: WorkerOptions = {},\n): Worker<NotificationJob> {\n  const concurrency = opts.concurrency ?? 5\n\n  const worker = new Worker<NotificationJob>(\n    NOTIFICATION_QUEUE_NAME,\n    async (job) => {\n      const { driverName, notification } = job.data\n\n      const driver = registry.getDriver(driverName)\n      if (!driver) {\n        throw new Error(`Notification driver \"${driverName}\" is not registered`)\n      }\n\n      await driver.send(notification)\n    },\n    {\n      connection: redis,\n      // Must match the producer, or jobs are enqueued where the worker isn't listening\n      prefix: NOTIFICATION_QUEUE_PREFIX,\n      concurrency,\n      // Don't create a new redis connection per job — reuse the pool\n      autorun: true,\n    },\n  )\n\n  worker.on('failed', (job, err) => {\n    // BullMQ handles retries; this is just for observability\n    const jobId = job?.id ?? 'unknown'\n    const message = err instanceof Error ? err.message : String(err)\n    console.error(`[notifications] Job ${jobId} failed: ${message}`)\n  })\n\n  return worker\n}\n","// Generated by feathers-baas. Safe to edit.\nimport nodemailer from 'nodemailer'\nimport * as ejs from 'ejs'\nimport type { NotifierDriver, Notification } from '../types.js'\n\n// ejs is a CommonJS module — alias the render function defensively\nconst ejsRender = (ejs as unknown as { render?: typeof ejs.render }).render ?? ejs.render\n\nexport interface SMTPDriverOptions {\n  /** SMTP connection URL, e.g. smtp://user:pass@mail.example.com:587 */\n  url: string\n  /** Display name shown in the From field. */\n  fromName: string\n  /** Email address shown in the From field. */\n  fromAddress: string\n}\n\n/**\n * Email driver backed by nodemailer over SMTP.\n * Templates are rendered with EJS at send time.\n *\n * Use this driver for self-hosted SMTP servers (Postfix, Mailtrap, etc.).\n * For transactional email services, prefer ResendDriver.\n */\nexport class SMTPDriver implements NotifierDriver {\n  readonly name = 'smtp'\n\n  private readonly transporter: nodemailer.Transporter\n\n  constructor(private readonly opts: SMTPDriverOptions) {\n    this.transporter = nodemailer.createTransport(opts.url)\n  }\n\n  async send(notification: Notification): Promise<void> {\n    const html = ejsRender(notification.bodyTemplate, notification.data, { async: false })\n    const text = notification.textTemplate\n      ? ejsRender(notification.textTemplate, notification.data, { async: false })\n      : undefined\n\n    await this.transporter.sendMail({\n      from: `\"${this.opts.fromName}\" <${this.opts.fromAddress}>`,\n      to: notification.to,\n      subject: notification.subject ?? '(no subject)',\n      html,\n      text,\n    })\n  }\n\n  /** Verify SMTP connectivity. Throws if the server is unreachable. */\n  async verify(): Promise<void> {\n    await this.transporter.verify()\n  }\n\n  /** Close the underlying connection pool. */\n  close(): void {\n    this.transporter.close()\n  }\n}\n","// Generated by feathers-baas. Safe to edit.\nimport { Resend } from 'resend'\nimport * as ejs from 'ejs'\nimport type { NotifierDriver, Notification } from '../types.js'\n\nconst ejsRender = (ejs as unknown as { render?: typeof ejs.render }).render ?? ejs.render\n\nexport interface ResendDriverOptions {\n  /** Resend API key (from https://resend.com/api-keys). */\n  apiKey: string\n  /** Display name shown in the From field. */\n  fromName: string\n  /** Verified sender address. Must be a verified domain in your Resend account. */\n  fromAddress: string\n}\n\n/**\n * Email driver backed by the Resend transactional email API.\n * Templates are rendered with EJS at send time.\n *\n * Resend offers generous free tier and excellent deliverability,\n * making it the recommended choice for new projects.\n */\nexport class ResendDriver implements NotifierDriver {\n  readonly name = 'resend'\n\n  private readonly client: Resend\n\n  constructor(private readonly opts: ResendDriverOptions) {\n    this.client = new Resend(opts.apiKey)\n  }\n\n  async send(notification: Notification): Promise<void> {\n    const html = ejsRender(notification.bodyTemplate, notification.data, { async: false })\n    const text = notification.textTemplate\n      ? ejsRender(notification.textTemplate, notification.data, { async: false })\n      : undefined\n\n    const result = await this.client.emails.send({\n      from: `${this.opts.fromName} <${this.opts.fromAddress}>`,\n      to: [notification.to],\n      subject: notification.subject ?? '(no subject)',\n      html,\n      text,\n    })\n\n    if ('error' in result && result.error) {\n      throw new Error(`Resend error: ${result.error.message}`)\n    }\n  }\n}\n","// Generated by feathers-baas. Safe to edit.\nimport sgMail from '@sendgrid/mail'\nimport * as ejs from 'ejs'\nimport type { NotifierDriver, Notification } from '../types.js'\n\n// ejs is a CommonJS module — alias the render function defensively\nconst ejsRender = (ejs as unknown as { render?: typeof ejs.render }).render ?? ejs.render\n\nexport interface SendGridDriverOptions {\n  /** SendGrid API key (from https://app.sendgrid.com/settings/api_keys). */\n  apiKey: string\n  /** Display name shown in the From field. */\n  fromName: string\n  /** Verified sender address. Must be verified in your SendGrid account. */\n  fromAddress: string\n}\n\n/**\n * Email driver backed by the SendGrid API.\n * Templates are rendered with EJS at send time.\n */\nexport class SendGridDriver implements NotifierDriver {\n  readonly name = 'sendgrid'\n\n  constructor(private readonly opts: SendGridDriverOptions) {\n    sgMail.setApiKey(opts.apiKey)\n  }\n\n  async send(notification: Notification): Promise<void> {\n    const html = ejsRender(notification.bodyTemplate, notification.data, { async: false })\n    const text = notification.textTemplate\n      ? ejsRender(notification.textTemplate, notification.data, { async: false })\n      : undefined\n\n    await sgMail.send({\n      from: { name: this.opts.fromName, email: this.opts.fromAddress },\n      to: notification.to,\n      subject: notification.subject ?? '(no subject)',\n      html,\n      ...(text ? { text } : {}),\n    })\n  }\n}\n","// Generated by feathers-baas. Safe to edit.\nimport { TransactionalEmailsApi, TransactionalEmailsApiApiKeys, SendSmtpEmail } from '@getbrevo/brevo'\nimport * as ejs from 'ejs'\nimport type { NotifierDriver, Notification } from '../types.js'\n\n// ejs is a CommonJS module — alias the render function defensively\nconst ejsRender = (ejs as unknown as { render?: typeof ejs.render }).render ?? ejs.render\n\nexport interface BrevoDriverOptions {\n  /** Brevo API key (from https://app.brevo.com/settings/keys/api). */\n  apiKey: string\n  /** Display name shown in the From field. */\n  fromName: string\n  /** Verified sender address. Must be verified in your Brevo account. */\n  fromAddress: string\n}\n\n/**\n * Email driver backed by the Brevo (formerly Sendinblue) Transactional Email API.\n * Templates are rendered with EJS at send time.\n */\nexport class BrevoDriver implements NotifierDriver {\n  readonly name = 'brevo'\n\n  private readonly apiInstance: TransactionalEmailsApi\n\n  constructor(private readonly opts: BrevoDriverOptions) {\n    this.apiInstance = new TransactionalEmailsApi()\n    this.apiInstance.setApiKey(TransactionalEmailsApiApiKeys.apiKey, opts.apiKey)\n  }\n\n  async send(notification: Notification): Promise<void> {\n    const html = ejsRender(notification.bodyTemplate, notification.data, { async: false })\n    const text = notification.textTemplate\n      ? ejsRender(notification.textTemplate, notification.data, { async: false })\n      : undefined\n\n    const email = new SendSmtpEmail()\n    email.sender = { name: this.opts.fromName, email: this.opts.fromAddress }\n    email.to = [{ email: notification.to }]\n    email.subject = notification.subject ?? '(no subject)'\n    email.htmlContent = html\n    if (text) email.textContent = text\n\n    await this.apiInstance.sendTransacEmail(email)\n  }\n}\n"],"mappings":"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","names":["import_bullmq","nodemailer","ejs","ejsRender","ejs","ejsRender","sgMail","ejs","ejsRender"]}

package/dist/index.d.cts

@@ -82,17 +82,45 @@ declare class DriverRegistry {
     listDriverNames(): string[];
 }
 
-type NotifierFn = (type: string, user: Record<string, unknown>, notifierOptions: Record<string, unknown>) => Promise<void>;
-interface BullMQNotifierOptions {
-    /** BullMQ Queue instance — from createNotificationQueue(). */
-    queue: Queue<NotificationJob>;
-    /** Driver registry — used to determine which drivers handle each event. */
-    registry: DriverRegistry;
+interface AuthNotificationOptions {
     /**
-     * Public base URL of the app, e.g. https://api.example.com
-     * Used to construct verification / reset URLs in email templates.
+     * Public base URL of the **web app** that redeems the tokens (not this API),
+     * e.g. https://app.example.com
      */
     appUrl: string;
+    /** Frontend routes the email links point to. */
+    paths?: {
+        /** Default: `/verify` */
+        verify?: string;
+        /** Default: `/reset-password` */
+        resetPassword?: string;
+        /** Default: `/verify-set-password` */
+        verifySetPassword?: string;
+    };
+    /** Verification token lifetime in ms — must match auth-management's `delay`. Default: 5 days. */
+    verifyDelay?: number;
+    /** Reset token lifetime in ms — must match auth-management's `resetDelay`. Default: 2 hours. */
+    resetDelay?: number;
+}
+type AuthNotificationBuilder = (type: AuthNotificationEvent, user: Record<string, unknown>, opts: AuthNotificationOptions) => Notification | null;
+/** Human-readable duration for email copy, e.g. 432000000 → "5 days". */
+declare function formatDuration(ms: number): string;
+/**
+ * Build the default Notification payload for each auth event type.
+ * Exported so apps can wrap it via the notifier's `buildNotification` option.
+ * Templates use EJS — `<%= variable %>` for output, `<% code %>` for logic.
+ */
+declare function buildAuthNotification(type: AuthNotificationEvent, user: Record<string, unknown>, opts: AuthNotificationOptions): Notification | null;
+type NotifierFn = (type: string, user: Record<string, unknown>, notifierOptions: Record<string, unknown>) => Promise<void>;
+interface NotifierBaseOptions extends AuthNotificationOptions {
+    /** Driver registry — used to determine which drivers handle each event. */
+    registry: DriverRegistry;
+    /** Replace the default email composition. Wrap `buildAuthNotification` to tweak it. */
+    buildNotification?: AuthNotificationBuilder;
+}
+interface BullMQNotifierOptions extends NotifierBaseOptions {
+    /** BullMQ Queue instance — from createNotificationQueue(). */
+    queue: Queue<NotificationJob>;
 }
 /**
  * Create a notifier function compatible with feathers-authentication-management.
@@ -108,12 +136,7 @@ interface BullMQNotifierOptions {
  * app.set('notifier', createBullMQNotifier({ queue, registry, appUrl }))
  * ```
  */
-interface DirectNotifierOptions {
-    /** Driver registry — used to determine which drivers handle each event. */
-    registry: DriverRegistry;
-    /** Public base URL of the app. */
-    appUrl: string;
-}
+type DirectNotifierOptions = NotifierBaseOptions;
 /**
  * Create a notifier that sends notifications directly via the driver (no queue).
  * Use this when Redis/BullMQ is not available — suitable for API-based drivers
@@ -122,7 +145,8 @@ interface DirectNotifierOptions {
 declare function createDirectNotifier(opts: DirectNotifierOptions): NotifierFn;
 declare function createBullMQNotifier(opts: BullMQNotifierOptions): NotifierFn;
 
-declare const NOTIFICATION_QUEUE_NAME = "feathers-baas:notifications";
+declare const NOTIFICATION_QUEUE_NAME = "feathers-baas-notifications";
+declare const NOTIFICATION_QUEUE_PREFIX = "feathers-baas";
 /**
  * Create a BullMQ Queue instance for notification jobs.
  *
@@ -257,4 +281,4 @@ declare class BrevoDriver implements NotifierDriver {
 
 declare const plugin: FeathersBaasPlugin;
 
-export { type AuthNotificationEvent, BrevoDriver, type BrevoDriverOptions, type BullMQNotifierOptions, type DirectNotifierOptions, DriverRegistry, NOTIFICATION_QUEUE_NAME, type Notification, type NotificationEvent, type NotificationJob, type NotifierDriver, type NotifierFn, ResendDriver, type ResendDriverOptions, SMTPDriver, type SMTPDriverOptions, SendGridDriver, type SendGridDriverOptions, type WorkerOptions, createBullMQNotifier, createDirectNotifier, createNotificationQueue, createNotificationWorker, plugin as default, enqueueNotification };
+export { type AuthNotificationBuilder, type AuthNotificationEvent, type AuthNotificationOptions, BrevoDriver, type BrevoDriverOptions, type BullMQNotifierOptions, type DirectNotifierOptions, DriverRegistry, NOTIFICATION_QUEUE_NAME, NOTIFICATION_QUEUE_PREFIX, type Notification, type NotificationEvent, type NotificationJob, type NotifierDriver, type NotifierFn, ResendDriver, type ResendDriverOptions, SMTPDriver, type SMTPDriverOptions, SendGridDriver, type SendGridDriverOptions, type WorkerOptions, buildAuthNotification, createBullMQNotifier, createDirectNotifier, createNotificationQueue, createNotificationWorker, plugin as default, enqueueNotification, formatDuration };

package/dist/index.d.ts

@@ -82,17 +82,45 @@ declare class DriverRegistry {
     listDriverNames(): string[];
 }
 
-type NotifierFn = (type: string, user: Record<string, unknown>, notifierOptions: Record<string, unknown>) => Promise<void>;
-interface BullMQNotifierOptions {
-    /** BullMQ Queue instance — from createNotificationQueue(). */
-    queue: Queue<NotificationJob>;
-    /** Driver registry — used to determine which drivers handle each event. */
-    registry: DriverRegistry;
+interface AuthNotificationOptions {
     /**
-     * Public base URL of the app, e.g. https://api.example.com
-     * Used to construct verification / reset URLs in email templates.
+     * Public base URL of the **web app** that redeems the tokens (not this API),
+     * e.g. https://app.example.com
      */
     appUrl: string;
+    /** Frontend routes the email links point to. */
+    paths?: {
+        /** Default: `/verify` */
+        verify?: string;
+        /** Default: `/reset-password` */
+        resetPassword?: string;
+        /** Default: `/verify-set-password` */
+        verifySetPassword?: string;
+    };
+    /** Verification token lifetime in ms — must match auth-management's `delay`. Default: 5 days. */
+    verifyDelay?: number;
+    /** Reset token lifetime in ms — must match auth-management's `resetDelay`. Default: 2 hours. */
+    resetDelay?: number;
+}
+type AuthNotificationBuilder = (type: AuthNotificationEvent, user: Record<string, unknown>, opts: AuthNotificationOptions) => Notification | null;
+/** Human-readable duration for email copy, e.g. 432000000 → "5 days". */
+declare function formatDuration(ms: number): string;
+/**
+ * Build the default Notification payload for each auth event type.
+ * Exported so apps can wrap it via the notifier's `buildNotification` option.
+ * Templates use EJS — `<%= variable %>` for output, `<% code %>` for logic.
+ */
+declare function buildAuthNotification(type: AuthNotificationEvent, user: Record<string, unknown>, opts: AuthNotificationOptions): Notification | null;
+type NotifierFn = (type: string, user: Record<string, unknown>, notifierOptions: Record<string, unknown>) => Promise<void>;
+interface NotifierBaseOptions extends AuthNotificationOptions {
+    /** Driver registry — used to determine which drivers handle each event. */
+    registry: DriverRegistry;
+    /** Replace the default email composition. Wrap `buildAuthNotification` to tweak it. */
+    buildNotification?: AuthNotificationBuilder;
+}
+interface BullMQNotifierOptions extends NotifierBaseOptions {
+    /** BullMQ Queue instance — from createNotificationQueue(). */
+    queue: Queue<NotificationJob>;
 }
 /**
  * Create a notifier function compatible with feathers-authentication-management.
@@ -108,12 +136,7 @@ interface BullMQNotifierOptions {
  * app.set('notifier', createBullMQNotifier({ queue, registry, appUrl }))
  * ```
  */
-interface DirectNotifierOptions {
-    /** Driver registry — used to determine which drivers handle each event. */
-    registry: DriverRegistry;
-    /** Public base URL of the app. */
-    appUrl: string;
-}
+type DirectNotifierOptions = NotifierBaseOptions;
 /**
  * Create a notifier that sends notifications directly via the driver (no queue).
  * Use this when Redis/BullMQ is not available — suitable for API-based drivers
@@ -122,7 +145,8 @@ interface DirectNotifierOptions {
 declare function createDirectNotifier(opts: DirectNotifierOptions): NotifierFn;
 declare function createBullMQNotifier(opts: BullMQNotifierOptions): NotifierFn;
 
-declare const NOTIFICATION_QUEUE_NAME = "feathers-baas:notifications";
+declare const NOTIFICATION_QUEUE_NAME = "feathers-baas-notifications";
+declare const NOTIFICATION_QUEUE_PREFIX = "feathers-baas";
 /**
  * Create a BullMQ Queue instance for notification jobs.
  *
@@ -257,4 +281,4 @@ declare class BrevoDriver implements NotifierDriver {
 
 declare const plugin: FeathersBaasPlugin;
 
-export { type AuthNotificationEvent, BrevoDriver, type BrevoDriverOptions, type BullMQNotifierOptions, type DirectNotifierOptions, DriverRegistry, NOTIFICATION_QUEUE_NAME, type Notification, type NotificationEvent, type NotificationJob, type NotifierDriver, type NotifierFn, ResendDriver, type ResendDriverOptions, SMTPDriver, type SMTPDriverOptions, SendGridDriver, type SendGridDriverOptions, type WorkerOptions, createBullMQNotifier, createDirectNotifier, createNotificationQueue, createNotificationWorker, plugin as default, enqueueNotification };
+export { type AuthNotificationBuilder, type AuthNotificationEvent, type AuthNotificationOptions, BrevoDriver, type BrevoDriverOptions, type BullMQNotifierOptions, type DirectNotifierOptions, DriverRegistry, NOTIFICATION_QUEUE_NAME, NOTIFICATION_QUEUE_PREFIX, type Notification, type NotificationEvent, type NotificationJob, type NotifierDriver, type NotifierFn, ResendDriver, type ResendDriverOptions, SMTPDriver, type SMTPDriverOptions, SendGridDriver, type SendGridDriverOptions, type WorkerOptions, buildAuthNotification, createBullMQNotifier, createDirectNotifier, createNotificationQueue, createNotificationWorker, plugin as default, enqueueNotification, formatDuration };