@feathers-baas/plugin-notifications 0.2.0 → 0.3.0

package/dist/index.js

@@ -33,10 +33,12 @@ var DriverRegistry = class {
 
 // src/queue/producer.ts
 import { Queue } from "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 Queue(NOTIFICATION_QUEUE_NAME, {
     connection: redis,
+    prefix: NOTIFICATION_QUEUE_PREFIX,
     defaultJobOptions: {
       attempts: 5,
       backoff: {
@@ -63,14 +65,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",
@@ -79,15 +106,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",
@@ -96,10 +123,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": {
@@ -134,7 +161,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",
@@ -153,7 +180,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;
@@ -170,7 +197,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;
@@ -198,6 +225,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
@@ -335,14 +364,17 @@ export {
   BrevoDriver,
   DriverRegistry,
   NOTIFICATION_QUEUE_NAME,
+  NOTIFICATION_QUEUE_PREFIX,
   ResendDriver,
   SMTPDriver,
   SendGridDriver,
+  buildAuthNotification,
   createBullMQNotifier,
   createDirectNotifier,
   createNotificationQueue,
   createNotificationWorker,
   index_default as default,
-  enqueueNotification
+  enqueueNotification,
+  formatDuration
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.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":"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","names":["ejs","ejsRender","ejs","ejsRender","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":["ejs","ejsRender","ejs","ejsRender","ejs","ejsRender"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feathers-baas/plugin-notifications",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Notifications plugin for feathers-baas — BullMQ-backed email drivers (SMTP, Resend, SendGrid, Brevo)",
   "keywords": [
     "feathers",

package/src/index.ts

@@ -16,11 +16,22 @@ const plugin: FeathersBaasPlugin = {
 export default plugin
 
 export { DriverRegistry } from './registry.js'
-export { createBullMQNotifier, createDirectNotifier } from './notifier.js'
-export type { NotifierFn, BullMQNotifierOptions, DirectNotifierOptions } from './notifier.js'
+export { createBullMQNotifier, createDirectNotifier, buildAuthNotification, formatDuration } from './notifier.js'
+export type {
+  NotifierFn,
+  BullMQNotifierOptions,
+  DirectNotifierOptions,
+  AuthNotificationOptions,
+  AuthNotificationBuilder,
+} from './notifier.js'
 
 // Queue
-export { createNotificationQueue, enqueueNotification, NOTIFICATION_QUEUE_NAME } from './queue/producer.js'
+export {
+  createNotificationQueue,
+  enqueueNotification,
+  NOTIFICATION_QUEUE_NAME,
+  NOTIFICATION_QUEUE_PREFIX,
+} from './queue/producer.js'
 export { createNotificationWorker } from './queue/worker.js'
 export type { WorkerOptions } from './queue/worker.js'
 

package/src/notifier.ts

@@ -18,15 +18,73 @@ const AUTH_MANAGEMENT_EVENT_MAP: Record<string, AuthNotificationEvent> = {
   identityChange: 'auth.identity-change',
 }
 
+/** Defaults match feathers-authentication-management's own `delay` / `resetDelay`. */
+const DEFAULT_VERIFY_DELAY_MS = 1000 * 60 * 60 * 24 * 5
+const DEFAULT_RESET_DELAY_MS = 1000 * 60 * 60 * 2
+
+export interface AuthNotificationOptions {
+  /**
+   * 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
+}
+
+export type AuthNotificationBuilder = (
+  type: AuthNotificationEvent,
+  user: Record<string, unknown>,
+  opts: AuthNotificationOptions,
+) => Notification | null
+
+/** Human-readable duration for email copy, e.g. 432000000 → "5 days". */
+export function formatDuration(ms: number): string {
+  const units: [string, number][] = [
+    ['day', 86_400_000],
+    ['hour', 3_600_000],
+    ['minute', 60_000],
+  ]
+  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 / 60_000))
+  return `${minutes} minute${minutes === 1 ? '' : 's'}`
+}
+
+function buildLink(appUrl: string, path: string, token: string | undefined): string {
+  const base = appUrl.replace(/\/+$/, '')
+  const route = path.startsWith('/') ? path : `/${path}`
+  return `${base}${route}?token=${encodeURIComponent(token ?? '')}`
+}
+
 /**
- * Build a default Notification payload for each auth event type.
+ * 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.
  */
-function buildAuthNotification(
+export function buildAuthNotification(
   type: AuthNotificationEvent,
   user: Record<string, unknown>,
-  appUrl: string,
+  opts: AuthNotificationOptions,
 ): Notification | null {
+  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'] as string
   if (!email) return null
 
@@ -34,7 +92,7 @@ function buildAuthNotification(
     case 'auth.verify-signup':
     case 'auth.resend-verify-signup': {
       const token = user['verifyToken'] as string | undefined
-      const verifyUrl = `${appUrl}/verify?token=${token ?? ''}`
+      const verifyUrl = buildLink(appUrl, paths.verify ?? '/verify', token)
       return {
         to: email,
         channel: 'email',
@@ -43,16 +101,16 @@ function buildAuthNotification(
           <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'] as string | undefined
-      const resetUrl = `${appUrl}/reset-password?token=${token ?? ''}`
+      const resetUrl = buildLink(appUrl, paths.resetPassword ?? '/reset-password', token)
       return {
         to: email,
         channel: 'email',
@@ -61,10 +119,10 @@ function buildAuthNotification(
           <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 },
       }
     }
 
@@ -103,7 +161,7 @@ function buildAuthNotification(
 
     case 'auth.verify-signup-set-password': {
       const token = user['verifyToken'] as string | undefined
-      const verifyUrl = `${appUrl}/verify-set-password?token=${token ?? ''}`
+      const verifyUrl = buildLink(appUrl, paths.verifySetPassword ?? '/verify-set-password', token)
       return {
         to: email,
         channel: 'email',
@@ -125,16 +183,16 @@ export type NotifierFn = (
   notifierOptions: Record<string, unknown>,
 ) => Promise<void>
 
-export interface BullMQNotifierOptions {
-  /** BullMQ Queue instance — from createNotificationQueue(). */
-  queue: Queue<NotificationJob>
+interface NotifierBaseOptions extends AuthNotificationOptions {
   /** Driver registry — used to determine which drivers handle each event. */
   registry: DriverRegistry
-  /**
-   * Public base URL of the app, e.g. https://api.example.com
-   * Used to construct verification / reset URLs in email templates.
-   */
-  appUrl: string
+  /** Replace the default email composition. Wrap `buildAuthNotification` to tweak it. */
+  buildNotification?: AuthNotificationBuilder
+}
+
+export interface BullMQNotifierOptions extends NotifierBaseOptions {
+  /** BullMQ Queue instance — from createNotificationQueue(). */
+  queue: Queue<NotificationJob>
 }
 
 /**
@@ -151,12 +209,7 @@ export interface BullMQNotifierOptions {
  * app.set('notifier', createBullMQNotifier({ queue, registry, appUrl }))
  * ```
  */
-export interface DirectNotifierOptions {
-  /** Driver registry — used to determine which drivers handle each event. */
-  registry: DriverRegistry
-  /** Public base URL of the app. */
-  appUrl: string
-}
+export type DirectNotifierOptions = NotifierBaseOptions
 
 /**
  * Create a notifier that sends notifications directly via the driver (no queue).
@@ -168,7 +221,7 @@ export function createDirectNotifier(opts: DirectNotifierOptions): NotifierFn {
     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)
@@ -189,7 +242,7 @@ export function createBullMQNotifier(opts: BullMQNotifierOptions): NotifierFn {
     const eventKey = AUTH_MANAGEMENT_EVENT_MAP[type]
     if (!eventKey) return // Unknown event type — no-op
 
-    const notification = buildAuthNotification(eventKey, user, opts.appUrl)
+    const notification = (opts.buildNotification ?? buildAuthNotification)(eventKey, user, opts)
     if (!notification) return // Missing required user fields — no-op
 
     const driverNames = opts.registry.getDriversForEvent(eventKey)

package/src/queue/producer.ts

@@ -3,7 +3,9 @@ import { Queue } from 'bullmq'
 import type { Redis } from 'ioredis'
 import type { NotificationJob } from '../types.js'
 
-export const NOTIFICATION_QUEUE_NAME = 'feathers-baas:notifications'
+// BullMQ rejects ':' in queue names — namespace with its `prefix` option instead.
+export const NOTIFICATION_QUEUE_NAME = 'feathers-baas-notifications'
+export const NOTIFICATION_QUEUE_PREFIX = 'feathers-baas'
 
 /**
  * Create a BullMQ Queue instance for notification jobs.
@@ -18,6 +20,7 @@ export const NOTIFICATION_QUEUE_NAME = 'feathers-baas:notifications'
 export function createNotificationQueue(redis: Redis): Queue<NotificationJob> {
   return new Queue<NotificationJob>(NOTIFICATION_QUEUE_NAME, {
     connection: redis,
+    prefix: NOTIFICATION_QUEUE_PREFIX,
     defaultJobOptions: {
       attempts: 5,
       backoff: {

package/src/queue/worker.ts

@@ -3,7 +3,7 @@ import { Worker } from 'bullmq'
 import type { Redis } from 'ioredis'
 import type { DriverRegistry } from '../registry.js'
 import type { NotificationJob } from '../types.js'
-import { NOTIFICATION_QUEUE_NAME } from './producer.js'
+import { NOTIFICATION_QUEUE_NAME, NOTIFICATION_QUEUE_PREFIX } from './producer.js'
 
 export interface WorkerOptions {
   /** BullMQ concurrency — number of jobs processed in parallel. */
@@ -49,6 +49,8 @@ export function createNotificationWorker(
     },
     {
       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,

package/test/notifier.test.ts

@@ -0,0 +1,75 @@
+import { describe, it, expect, vi } from 'vitest'
+import { buildAuthNotification, createDirectNotifier, formatDuration } from '../src/notifier.js'
+import { DriverRegistry } from '../src/registry.js'
+import type { Notification, NotifierDriver } from '../src/types.js'
+
+const user = { email: 'alice@example.com', verifyToken: 'v/tok', resetToken: 'r-tok' }
+
+describe('formatDuration', () => {
+  it('formats whole units', () => {
+    expect(formatDuration(1000 * 60 * 60 * 24 * 5)).toBe('5 days')
+    expect(formatDuration(1000 * 60 * 60 * 2)).toBe('2 hours')
+    expect(formatDuration(1000 * 60 * 60)).toBe('1 hour')
+    expect(formatDuration(1000 * 60 * 90)).toBe('90 minutes')
+  })
+})
+
+describe('buildAuthNotification', () => {
+  it('uses the default paths and auth-management default lifetimes', () => {
+    const verify = buildAuthNotification('auth.resend-verify-signup', user, { appUrl: 'https://app.example.com/' })
+    expect(verify?.data?.['verifyUrl']).toBe('https://app.example.com/verify?token=v%2Ftok')
+    expect(verify?.data?.['expiresIn']).toBe('5 days')
+
+    const reset = buildAuthNotification('auth.send-reset-pwd', user, { appUrl: 'https://app.example.com' })
+    expect(reset?.data?.['resetUrl']).toBe('https://app.example.com/reset-password?token=r-tok')
+    expect(reset?.data?.['expiresIn']).toBe('2 hours')
+  })
+
+  it('honours custom paths and delays', () => {
+    const opts = {
+      appUrl: 'https://app.example.com',
+      paths: { verify: '/auth/confirm', resetPassword: 'auth/reset' },
+      verifyDelay: 1000 * 60 * 60 * 24,
+      resetDelay: 1000 * 60 * 30,
+    }
+    const verify = buildAuthNotification('auth.verify-signup', user, opts)
+    expect(verify?.data?.['verifyUrl']).toBe('https://app.example.com/auth/confirm?token=v%2Ftok')
+    expect(verify?.data?.['expiresIn']).toBe('1 day')
+
+    const reset = buildAuthNotification('auth.send-reset-pwd', user, opts)
+    expect(reset?.data?.['resetUrl']).toBe('https://app.example.com/auth/reset?token=r-tok')
+    expect(reset?.data?.['expiresIn']).toBe('30 minutes')
+  })
+})
+
+describe('createDirectNotifier', () => {
+  function setup() {
+    const send = vi.fn<(n: Notification) => Promise<void>>().mockResolvedValue(undefined)
+    const driver: NotifierDriver = { name: 'fake', send }
+    const registry = new DriverRegistry()
+    registry.registerDriver(driver)
+    registry.mapEvent('auth.resend-verify-signup', 'fake')
+    return { registry, send }
+  }
+
+  it('passes path options through to the email', async () => {
+    const { registry, send } = setup()
+    const notify = createDirectNotifier({ registry, appUrl: 'https://app.example.com', paths: { verify: '/confirm' } })
+    await notify('resendVerifySignup', user, {})
+    expect(send.mock.calls[0]![0].data?.['verifyUrl']).toBe('https://app.example.com/confirm?token=v%2Ftok')
+  })
+
+  it('lets apps override composition with buildNotification', async () => {
+    const { registry, send } = setup()
+    const notify = createDirectNotifier({
+      registry,
+      appUrl: 'https://app.example.com',
+      buildNotification: (type, u, opts) => {
+        const base = buildAuthNotification(type, u, opts)
+        return base && { ...base, subject: 'Custom subject' }
+      },
+    })
+    await notify('resendVerifySignup', user, {})
+    expect(send.mock.calls[0]![0].subject).toBe('Custom subject')
+  })
+})

package/test/queue-name.test.ts

@@ -0,0 +1,19 @@
+// Startup smoke test against the real bullmq — it rejects ':' in queue names at construction time.
+import { describe, it, expect } from 'vitest'
+import { Queue } from 'bullmq'
+import { NOTIFICATION_QUEUE_NAME, NOTIFICATION_QUEUE_PREFIX } from '../src/queue/producer.js'
+
+describe('notification queue name', () => {
+  it('is accepted by the bullmq Queue constructor', () => {
+    let queue: Queue | undefined
+    expect(() => {
+      // Port 0 + lazyConnect: never actually reaches for Redis
+      queue = new Queue(NOTIFICATION_QUEUE_NAME, {
+        prefix: NOTIFICATION_QUEUE_PREFIX,
+        connection: { host: '127.0.0.1', port: 0, lazyConnect: true, enableOfflineQueue: false },
+      })
+    }).not.toThrow()
+    queue?.on('error', () => {})
+    expect(queue?.name).toBe(NOTIFICATION_QUEUE_NAME)
+  })
+})