mailery 0.8.1 → 0.9.0

package/dist/{null-CwXmiVLe.d.cts → null-BRSHAxvg.d.cts}

@@ -378,6 +378,13 @@ interface Queues {
 type QueueDriverConfig = {
     driver: 'bull';
     redis: RedisOptions | IORedis;
+    /**
+     * Redis key prefix for all queue keys (BullMQ default: 'bull').
+     * Namespaces multiple mailery instances on one Redis cluster — e.g.
+     * 'mailery-dev' / 'mailery-prod' to isolate environments. Must not
+     * contain ':' (BullMQ uses it as the key separator).
+     */
+    prefix?: string;
 } | {
     driver: 'agenda';
     db?: Db;
@@ -1382,6 +1389,7 @@ declare class Mailer {
      *   MAILER_MONGODB_URI                — Mongo connection string (required)
      *   MAILER_MONGODB_DB                 — database name (optional; defaults to the URI default)
      *   MAILER_REDIS_URL                  — Redis connection URL (required)
+     *   MAILER_QUEUE_PREFIX               — Redis key prefix to namespace this instance (optional)
      *   MAILER_PUBLIC_URL                 — base for tracking/unsub URLs (required)
      *   MAILER_UNSUBSCRIBE_SECRET         — HMAC key (required)
      *   MAILER_SENDER_ADDRESS             — postal address for CAN-SPAM (optional)

package/dist/{null-CwXmiVLe.d.ts → null-BRSHAxvg.d.ts}

@@ -378,6 +378,13 @@ interface Queues {
 type QueueDriverConfig = {
     driver: 'bull';
     redis: RedisOptions | IORedis;
+    /**
+     * Redis key prefix for all queue keys (BullMQ default: 'bull').
+     * Namespaces multiple mailery instances on one Redis cluster — e.g.
+     * 'mailery-dev' / 'mailery-prod' to isolate environments. Must not
+     * contain ':' (BullMQ uses it as the key separator).
+     */
+    prefix?: string;
 } | {
     driver: 'agenda';
     db?: Db;
@@ -1382,6 +1389,7 @@ declare class Mailer {
      *   MAILER_MONGODB_URI                — Mongo connection string (required)
      *   MAILER_MONGODB_DB                 — database name (optional; defaults to the URI default)
      *   MAILER_REDIS_URL                  — Redis connection URL (required)
+     *   MAILER_QUEUE_PREFIX               — Redis key prefix to namespace this instance (optional)
      *   MAILER_PUBLIC_URL                 — base for tracking/unsub URLs (required)
      *   MAILER_UNSUBSCRIBE_SECRET         — HMAC key (required)
      *   MAILER_SENDER_ADDRESS             — postal address for CAN-SPAM (optional)

package/dist/testing.cjs

@@ -14636,7 +14636,7 @@ var BullDriver = class _BullDriver {
   bullQueues;
   workers = null;
   bull;
-  static async create(redisConfig) {
+  static async create(redisConfig, prefix) {
     let bull;
     try {
       bull = await import('bullmq');
@@ -14645,14 +14645,22 @@ var BullDriver = class _BullDriver {
         "mailery: queue driver 'bull' requires the 'bullmq' peer dependency. Run `npm install bullmq ioredis`."
       );
     }
+    if (prefix?.includes(":")) {
+      throw new Error(
+        `mailery: queue prefix "${prefix}" must not contain ':' \u2014 BullMQ uses it as the Redis key separator.`
+      );
+    }
     const redis = isRedisLike(redisConfig) ? redisConfig : connect(redisConfig);
-    return new _BullDriver(bull, redis);
+    return new _BullDriver(bull, redis, prefix);
   }
-  constructor(bull, redis) {
+  prefix;
+  constructor(bull, redis, prefix) {
     this.bull = bull;
     this.redis = redis;
+    this.prefix = prefix;
     const opts = {
       connection: redis,
+      prefix,
       defaultJobOptions: {
         removeOnComplete: { age: 24 * 3600, count: 1e3 },
         removeOnFail: { age: 7 * 24 * 3600 }
@@ -14684,7 +14692,7 @@ var BullDriver = class _BullDriver {
   }
   async startWorkers(opts) {
     if (this.workers) return;
-    const base = { connection: this.redis };
+    const base = { connection: this.redis, prefix: this.prefix };
     const { Worker } = this.bull;
     const tick = new Worker(
       QUEUE_NAMES.tick,
@@ -14936,7 +14944,7 @@ var NoopDriver = class {
 async function createQueueDriver(config, fallbackDb) {
   switch (config.driver) {
     case "bull":
-      return BullDriver.create(config.redis);
+      return BullDriver.create(config.redis, config.prefix);
     case "agenda":
       return AgendaDriver.create({
         db: config.db ?? fallbackDb,
@@ -17364,6 +17372,7 @@ var Mailer = class _Mailer {
    *   MAILER_MONGODB_URI                — Mongo connection string (required)
    *   MAILER_MONGODB_DB                 — database name (optional; defaults to the URI default)
    *   MAILER_REDIS_URL                  — Redis connection URL (required)
+   *   MAILER_QUEUE_PREFIX               — Redis key prefix to namespace this instance (optional)
    *   MAILER_PUBLIC_URL                 — base for tracking/unsub URLs (required)
    *   MAILER_UNSUBSCRIBE_SECRET         — HMAC key (required)
    *   MAILER_SENDER_ADDRESS             — postal address for CAN-SPAM (optional)
@@ -17412,7 +17421,11 @@ var Mailer = class _Mailer {
     }
     const defaultProvider = env.MAILER_DEFAULT_PROVIDER ?? Object.keys(providers)[0];
     const driverEnv = env.MAILER_QUEUE_DRIVER ?? "bull";
-    const queue = driverEnv === "agenda" ? { driver: "agenda" } : driverEnv === "noop" ? { driver: "noop" } : { driver: "bull", redis: { url: required("MAILER_REDIS_URL") } };
+    const queue = driverEnv === "agenda" ? { driver: "agenda" } : driverEnv === "noop" ? { driver: "noop" } : {
+      driver: "bull",
+      redis: { url: required("MAILER_REDIS_URL") },
+      prefix: env.MAILER_QUEUE_PREFIX
+    };
     return _Mailer.init({
       db,
       adapter,