@burdenoff/be-sdk 2026.513.5 → 2026.513.6

package/dist/{chunk-KSO6QQVD.js → chunk-EMSON3UD.js}

@@ -1,9 +1,11 @@
-import { QueueType } from './chunk-VOFKF27Q.js';
-import { NatsConnectionManager } from './chunk-COSUYUCB.js';
+import { QueueType } from './chunk-UVYDP6P6.js';
+import { NatsConnectionManager, RedisStreamsConnection } from './chunk-QKJR4L7B.js';
 import { DEFAULT_LAYER_RESOURCES } from './chunk-NGMEI42S.js';
 import { logger } from './chunk-CBZNP6RF.js';
 import { __name } from './chunk-XE4OXN2W.js';
 import { RetentionPolicy, StorageType, AckPolicy, DeliverPolicy, headers } from 'nats';
+import { randomUUID } from 'crypto';
+import { hostname } from 'os';
 
 // src/event-queue/implementations/nats/trace-context.ts
 var otelApiPromise = null;
@@ -13,7 +15,7 @@ async function loadOtelApi() {
   }
   otelApiPromise = (async () => {
     try {
-      const mod = await import('./esm-K6H7EIWK.js');
+      const mod = await import('./esm-M2M7HGV4.js');
       return mod;
     } catch {
       logger.debug("[trace-context] @opentelemetry/api not available; NATS traces disabled");
@@ -921,7 +923,891 @@ var NatsEventPublisher = class {
   }
 };
 
+// src/event-queue/implementations/redis-streams/keyspace.ts
+var DEFAULT_PREFIX = "boff:events";
+var REGISTRY_PREFIX = "boff:registry:subjects";
+var DELAYQ_PREFIX = "boff:delayq";
+var DELAYQ_LOCK_PREFIX = "boff:lock:delayq";
+var DLQ_PREFIX = "boff:dlq";
+var DEDUP_PREFIX = "boff:dedup";
+var REPLY_PREFIX = "boff:replies";
+function subjectToKey(subject) {
+  return subject.replace(/\./g, ":");
+}
+__name(subjectToKey, "subjectToKey");
+function streamKey(subject, opts = {}) {
+  const prefix = opts.prefix ?? DEFAULT_PREFIX;
+  return `${prefix}:${subjectToKey(subject)}`;
+}
+__name(streamKey, "streamKey");
+function registryKey(boundary) {
+  return `${REGISTRY_PREFIX}:${boundary}`;
+}
+__name(registryKey, "registryKey");
+function boundaryOf(subject) {
+  const first = subject.split(".")[0];
+  return first ?? subject;
+}
+__name(boundaryOf, "boundaryOf");
+function delayQueueKey(stream) {
+  return `${DELAYQ_PREFIX}:${stream}`;
+}
+__name(delayQueueKey, "delayQueueKey");
+function delayLockKey(stream) {
+  return `${DELAYQ_LOCK_PREFIX}:${stream}`;
+}
+__name(delayLockKey, "delayLockKey");
+function dlqKey(stream) {
+  return `${DLQ_PREFIX}:${stream}`;
+}
+__name(dlqKey, "dlqKey");
+function dedupKey(stream, msgId) {
+  return `${DEDUP_PREFIX}:${stream}:${msgId}`;
+}
+__name(dedupKey, "dedupKey");
+function replyKey(correlationId) {
+  return `${REPLY_PREFIX}:${correlationId}`;
+}
+__name(replyKey, "replyKey");
+function matchSubject(pattern, subject) {
+  if (pattern === subject) return true;
+  const pParts = pattern.split(".");
+  const sParts = subject.split(".");
+  const last = pParts[pParts.length - 1];
+  if (last === ">") {
+    if (sParts.length < pParts.length) return false;
+    for (let i = 0; i < pParts.length - 1; i++) {
+      if (pParts[i] !== sParts[i]) return false;
+    }
+    return true;
+  }
+  if (pParts.length !== sParts.length) return false;
+  for (let i = 0; i < pParts.length; i++) {
+    if (pParts[i] !== "*" && pParts[i] !== sParts[i]) return false;
+  }
+  return true;
+}
+__name(matchSubject, "matchSubject");
+function isWildcard(pattern) {
+  return pattern.includes("*") || pattern.includes(">");
+}
+__name(isWildcard, "isWildcard");
+
+// src/event-queue/implementations/redis-streams/trace-context.ts
+var otelApiPromise2 = null;
+async function loadOtelApi2() {
+  if (otelApiPromise2) return otelApiPromise2;
+  otelApiPromise2 = (async () => {
+    try {
+      const mod = await import('./esm-M2M7HGV4.js');
+      return mod;
+    } catch {
+      logger.debug("[redis-streams/trace-context] @opentelemetry/api not available; tracing disabled");
+      return null;
+    }
+  })();
+  return otelApiPromise2;
+}
+__name(loadOtelApi2, "loadOtelApi");
+var TRACE_KEYS = [
+  "traceparent",
+  "tracestate",
+  "baggage"
+];
+async function injectTraceFields() {
+  const api = await loadOtelApi2();
+  if (!api) return {};
+  const carrier = {};
+  try {
+    api.propagation.inject(api.context.active(), carrier, {
+      set(c, k, v) {
+        c[k] = v;
+      }
+    });
+  } catch (err) {
+    logger.debug("[redis-streams/trace-context] inject failed", {
+      error: err instanceof Error ? err.message : String(err)
+    });
+  }
+  return carrier;
+}
+__name(injectTraceFields, "injectTraceFields");
+async function extractTraceContext(fields) {
+  const api = await loadOtelApi2();
+  if (!api) return void 0;
+  const carrier = {};
+  for (const key of TRACE_KEYS) {
+    const value = fields[key];
+    if (value) carrier[key] = value;
+  }
+  try {
+    return api.propagation.extract(api.context.active(), carrier, {
+      get(c, k) {
+        return c[k];
+      },
+      keys(c) {
+        return Object.keys(c);
+      }
+    });
+  } catch {
+    return void 0;
+  }
+}
+__name(extractTraceContext, "extractTraceContext");
+async function runWithConsumerSpan2(subject, fields, handler) {
+  const api = await loadOtelApi2();
+  if (!api) return handler();
+  try {
+    const parentCtx = await extractTraceContext(fields);
+    const tracer = api.trace.getTracer("@burdenoff/be-sdk/redis-streams");
+    return await new Promise((resolve, reject) => {
+      tracer.startActiveSpan(`redis-streams.consume ${subject}`, {
+        kind: 5,
+        attributes: {
+          "messaging.system": "redis",
+          "messaging.destination.name": subject
+        }
+      }, parentCtx, async (span) => {
+        try {
+          const result = await handler();
+          span.setStatus({
+            code: 1
+          });
+          span.end();
+          resolve(result);
+        } catch (err) {
+          span.recordException(err);
+          span.setStatus({
+            code: 2,
+            message: err instanceof Error ? err.message : String(err)
+          });
+          span.end();
+          reject(err);
+        }
+      });
+    });
+  } catch {
+    return handler();
+  }
+}
+__name(runWithConsumerSpan2, "runWithConsumerSpan");
+
+// src/event-queue/implementations/redis-streams/RedisStreamsEventConsumer.ts
+var DEFAULT_BLOCK_MS = 5e3;
+var DEFAULT_BATCH = 10;
+var REGISTRY_REFRESH_MS = 1e4;
+var DEFAULT_ACK_WAIT_MS = 3e4;
+var DEFAULT_MAX_DELIVER = 3;
+var SWEEP_INTERVAL_MS = 15e3;
+var DELAYQ_INTERVAL_MS = 1e3;
+var RedisStreamsSubscription = class RedisStreamsSubscription2 {
+  static {
+    __name(this, "RedisStreamsSubscription");
+  }
+  subject;
+  unsubscribeFn;
+  id = randomUUID();
+  active = true;
+  receivedCount = 0;
+  processedCount = 0;
+  failedCount = 0;
+  lastActivity = (/* @__PURE__ */ new Date()).toISOString();
+  constructor(subject, unsubscribeFn) {
+    this.subject = subject;
+    this.unsubscribeFn = unsubscribeFn;
+  }
+  async unsubscribe() {
+    if (!this.active) return;
+    this.active = false;
+    await this.unsubscribeFn();
+  }
+  isActive() {
+    return this.active;
+  }
+  getStats() {
+    return {
+      messagesReceived: this.receivedCount,
+      messagesProcessed: this.processedCount,
+      messagesFailed: this.failedCount,
+      lastActivity: this.lastActivity
+    };
+  }
+  recordReceived() {
+    this.receivedCount++;
+    this.lastActivity = (/* @__PURE__ */ new Date()).toISOString();
+  }
+  recordProcessed() {
+    this.processedCount++;
+    this.lastActivity = (/* @__PURE__ */ new Date()).toISOString();
+  }
+  recordFailed() {
+    this.failedCount++;
+    this.lastActivity = (/* @__PURE__ */ new Date()).toISOString();
+  }
+};
+var RedisStreamsEventConsumer = class {
+  static {
+    __name(this, "RedisStreamsEventConsumer");
+  }
+  connection;
+  subscriptions = [];
+  subscriptionLoops = /* @__PURE__ */ new Set();
+  keyPrefix;
+  consumerName;
+  group;
+  maxDeliver;
+  ackWaitMs;
+  maxConcurrent;
+  consumedCount = 0;
+  failedCount = 0;
+  lastActivity = null;
+  stopped = false;
+  sweepTimer = null;
+  delayqTimer = null;
+  knownStreams = /* @__PURE__ */ new Map();
+  constructor(config) {
+    this.connection = new RedisStreamsConnection({
+      type: "redis-streams",
+      url: config.url ?? process.env["REDIS_URL"] ?? "redis://localhost:6379",
+      user: config.user,
+      password: config.password,
+      name: config.name,
+      connectionTimeout: config.connectionTimeout
+    });
+    this.keyPrefix = config.keyPrefix ?? process.env["REDIS_STREAMS_KEY_PREFIX"] ?? "boff:events";
+    this.group = config.consumer || config.name || "default-consumer";
+    this.consumerName = `${this.group}:${hostname()}:${process.pid}`;
+    this.maxDeliver = config.maxDeliver ?? DEFAULT_MAX_DELIVER;
+    this.ackWaitMs = config.ackWait ? Math.max(1e3, Math.round(config.ackWait / 1e6)) : DEFAULT_ACK_WAIT_MS;
+    this.maxConcurrent = config.maxConcurrent ?? 5;
+  }
+  async connect() {
+    await this.connection.connect();
+    if (!this.sweepTimer) {
+      const t = setInterval(() => {
+        void this.sweepPending().catch((err) => {
+          logger.debug("[RedisStreamsEventConsumer] sweep error", {
+            error: err instanceof Error ? err.message : String(err)
+          });
+        });
+      }, SWEEP_INTERVAL_MS);
+      t.unref?.();
+      this.sweepTimer = t;
+    }
+    if (!this.delayqTimer) {
+      const t = setInterval(() => {
+        void this.drainDelayQueues().catch(() => void 0);
+      }, DELAYQ_INTERVAL_MS);
+      t.unref?.();
+      this.delayqTimer = t;
+    }
+  }
+  async disconnect() {
+    this.stopped = true;
+    if (this.sweepTimer) clearInterval(this.sweepTimer);
+    if (this.delayqTimer) clearInterval(this.delayqTimer);
+    await this.unsubscribeAll();
+    await this.connection.disconnect();
+  }
+  isConnected() {
+    return this.connection.isConnected();
+  }
+  async healthCheck() {
+    try {
+      const t0 = Date.now();
+      const pong = await this.connection.ping();
+      return {
+        status: pong === "PONG" ? "healthy" : "degraded",
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        connected: this.isConnected(),
+        latencyMs: Date.now() - t0,
+        details: {
+          type: "redis-streams",
+          subscriptions: this.subscriptions.length
+        }
+      };
+    } catch (err) {
+      return {
+        status: "unhealthy",
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        connected: false,
+        details: {
+          type: "redis-streams"
+        },
+        error: err instanceof Error ? err.message : String(err)
+      };
+    }
+  }
+  async getStatistics() {
+    return Promise.resolve({
+      messagesConsumed: this.consumedCount,
+      messagesFailed: this.failedCount,
+      messagesPublished: 0,
+      activeConsumers: this.subscriptions.length,
+      lastActivity: this.lastActivity?.toISOString() ?? null,
+      details: {
+        type: "redis-streams",
+        group: this.group
+      }
+    });
+  }
+  async ensureStream(_config) {
+    return Promise.resolve();
+  }
+  async ensureConsumer(_config) {
+    return Promise.resolve();
+  }
+  async subscribe(opts) {
+    await this.connect();
+    const sub = new RedisStreamsSubscription(opts.subject, async () => {
+      this.subscriptions = this.subscriptions.filter((s) => s !== sub);
+    });
+    this.subscriptions.push(sub);
+    const startId = this.resolveStartId(opts.options?.deliverPolicy);
+    const wildcard = isWildcard(opts.subject);
+    const handlerFn = opts.handler;
+    if (!wildcard) {
+      const stream = streamKey(opts.subject, {
+        prefix: this.keyPrefix
+      });
+      await this.ensureGroup(stream, startId);
+      this.knownStreams.set(stream, opts.subject);
+      this.spawnLoop(sub, stream, opts.subject, handlerFn);
+    } else {
+      const boundary = boundaryOf(opts.subject);
+      const refresh = /* @__PURE__ */ __name(async () => {
+        const client = this.connection.getClient();
+        const subjects = await client.smembers(registryKey(boundary));
+        for (const s of subjects) {
+          if (!matchSubject(opts.subject, s)) continue;
+          const stream = streamKey(s, {
+            prefix: this.keyPrefix
+          });
+          if (this.knownStreams.has(stream)) continue;
+          await this.ensureGroup(stream, startId);
+          this.knownStreams.set(stream, s);
+          this.spawnLoop(sub, stream, s, handlerFn);
+        }
+      }, "refresh");
+      await refresh();
+      const t = setInterval(() => {
+        if (this.stopped || !sub.isActive()) {
+          clearInterval(t);
+          return;
+        }
+        void refresh().catch(() => void 0);
+      }, REGISTRY_REFRESH_MS);
+      t.unref?.();
+    }
+    return sub;
+  }
+  async subscribeMultiple(subjects, handler, options) {
+    const out = [];
+    for (const subject of subjects) {
+      out.push(await this.subscribe({
+        subject,
+        handler,
+        options
+      }));
+    }
+    return out;
+  }
+  async pull(opts) {
+    await this.connect();
+    const stream = streamKey(opts.subject, {
+      prefix: this.keyPrefix
+    });
+    await this.ensureGroup(stream, "$");
+    const client = this.connection.getClient();
+    const raw = await client.xreadgroup("GROUP", this.group, this.consumerName, "COUNT", opts.batch ?? DEFAULT_BATCH, "BLOCK", opts.timeout ?? DEFAULT_BLOCK_MS, "STREAMS", stream, ">");
+    if (!raw) return [];
+    const out = [];
+    for (const [streamName, entries] of raw) {
+      for (const [id, rawFields] of entries) {
+        const parsed = this.parseEntry(streamName, id, rawFields);
+        out.push(this.toAcknowledgeable(streamName, id, parsed));
+      }
+    }
+    return out;
+  }
+  async unsubscribeAll() {
+    for (const sub of [
+      ...this.subscriptions
+    ]) {
+      await sub.unsubscribe();
+    }
+    this.subscriptions = [];
+    this.subscriptionLoops.clear();
+  }
+  getSubscriptions() {
+    return [
+      ...this.subscriptions
+    ];
+  }
+  async processDLQ(handler) {
+    await this.connect();
+    const client = this.connection.getClient();
+    const dlqGroup = `${this.group}-dlq`;
+    for (const [stream] of this.knownStreams) {
+      const dlq = dlqKey(stream);
+      try {
+        await client.xgroup("CREATE", dlq, dlqGroup, "0", "MKSTREAM");
+      } catch {
+      }
+      const res = await client.xreadgroup("GROUP", dlqGroup, this.consumerName, "COUNT", 50, "BLOCK", 100, "STREAMS", dlq, ">");
+      if (!res) continue;
+      for (const [, entries] of res) {
+        for (const [id, rawFields] of entries) {
+          const parsed = this.parseEntry(dlq, id, rawFields);
+          const evt = this.toAcknowledgeable(dlq, id, parsed, dlqGroup);
+          try {
+            await handler(evt);
+          } catch (err) {
+            logger.error("[RedisStreamsEventConsumer] DLQ handler error", {
+              error: err instanceof Error ? err.message : String(err)
+            });
+          }
+        }
+      }
+    }
+  }
+  async listSubjects(_stream) {
+    await this.connect();
+    const client = this.connection.getClient();
+    const seen = /* @__PURE__ */ new Set();
+    for (const subject of this.knownStreams.values()) {
+      const members = await client.smembers(registryKey(boundaryOf(subject)));
+      for (const m of members) seen.add(m);
+    }
+    return [
+      ...seen
+    ];
+  }
+  // ---- internals ----
+  resolveStartId(policy) {
+    switch (policy) {
+      case "all":
+        return "0";
+      case "new":
+        return "$";
+      case "last":
+        return "$";
+      default:
+        return "$";
+    }
+  }
+  async ensureGroup(stream, startId) {
+    const client = this.connection.getClient();
+    try {
+      await client.xgroup("CREATE", stream, this.group, startId, "MKSTREAM");
+      logger.debug("[RedisStreamsEventConsumer] group created", {
+        stream,
+        group: this.group,
+        startId
+      });
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      if (!msg.includes("BUSYGROUP")) {
+        throw err;
+      }
+    }
+  }
+  spawnLoop(sub, stream, subject, handler) {
+    const loop = /* @__PURE__ */ __name(async () => {
+      const client = await this.connection.makeBlockingClient();
+      try {
+        while (!this.stopped && sub.isActive()) {
+          let raw = null;
+          try {
+            raw = await client.xreadgroup("GROUP", this.group, this.consumerName, "COUNT", this.maxConcurrent, "BLOCK", DEFAULT_BLOCK_MS, "STREAMS", stream, ">");
+          } catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (msg.includes("NOGROUP")) {
+              await this.ensureGroup(stream, "$");
+              continue;
+            }
+            logger.warn("[RedisStreamsEventConsumer] read error", {
+              stream,
+              error: msg
+            });
+            await new Promise((res) => setTimeout(res, 1e3));
+            continue;
+          }
+          if (!raw) continue;
+          for (const [, entries] of raw) {
+            for (const [id, rawFields] of entries) {
+              sub.recordReceived();
+              this.consumedCount++;
+              this.lastActivity = /* @__PURE__ */ new Date();
+              const parsed = this.parseEntry(stream, id, rawFields);
+              const evt = this.toAcknowledgeable(stream, id, parsed);
+              try {
+                await runWithConsumerSpan2(subject, parsed.fields, () => handler(evt));
+                sub.recordProcessed();
+              } catch (err) {
+                sub.recordFailed();
+                this.failedCount++;
+                logger.error("[RedisStreamsEventConsumer] handler error", {
+                  subject,
+                  id,
+                  error: err instanceof Error ? err.message : String(err)
+                });
+                try {
+                  await evt.nak();
+                } catch {
+                }
+              }
+            }
+          }
+        }
+      } finally {
+        try {
+          client.disconnect();
+        } catch {
+        }
+      }
+    }, "loop");
+    void loop().catch((err) => {
+      logger.error("[RedisStreamsEventConsumer] loop crashed", {
+        stream,
+        error: err instanceof Error ? err.message : String(err)
+      });
+    });
+  }
+  parseEntry(stream, id, rawFields) {
+    const fields = {};
+    for (let i = 0; i + 1 < rawFields.length; i += 2) {
+      const key = rawFields[i];
+      const val = rawFields[i + 1];
+      if (key === void 0 || val === void 0) continue;
+      fields[key] = val;
+    }
+    let data;
+    try {
+      data = JSON.parse(fields["payload"] ?? "null");
+    } catch {
+      data = fields["payload"];
+    }
+    let metadata;
+    try {
+      metadata = JSON.parse(fields["metadata"] ?? "{}");
+    } catch {
+      metadata = {
+        correlationId: fields["correlation-id"] ?? ""
+      };
+    }
+    if (!metadata.correlationId) metadata.correlationId = fields["correlation-id"] ?? "";
+    return {
+      id,
+      stream,
+      subject: fields["subject"] ?? "",
+      data,
+      metadata,
+      timestamp: fields["timestamp"] ?? (/* @__PURE__ */ new Date()).toISOString(),
+      fields,
+      deliveryCount: 1
+    };
+  }
+  toAcknowledgeable(stream, id, parsed, group = this.group) {
+    const connection = this.connection;
+    let acked = false;
+    return {
+      id,
+      subject: parsed.subject,
+      data: parsed.data,
+      metadata: parsed.metadata,
+      timestamp: parsed.timestamp,
+      async ack() {
+        if (acked) return;
+        acked = true;
+        const client = connection.getClient();
+        await client.xack(stream, group, id);
+        await client.xdel(stream, id).catch(() => void 0);
+      },
+      async nak(delay = 0) {
+        if (acked) return;
+        acked = true;
+        const client = connection.getClient();
+        if (delay > 0) {
+          const score = Date.now() + delay;
+          const payload = JSON.stringify(parsed.fields);
+          await client.zadd(delayQueueKey(stream), score, `${id}|${payload}`);
+          await client.xack(stream, group, id);
+          await client.xdel(stream, id).catch(() => void 0);
+        }
+      },
+      async term() {
+        if (acked) return;
+        acked = true;
+        const client = connection.getClient();
+        const dlq = dlqKey(stream);
+        const flat = [];
+        for (const [k, v] of Object.entries(parsed.fields)) flat.push(k, v);
+        await client.xadd(dlq, "MAXLEN", "~", 1e4, "*", ...flat);
+        await client.xack(stream, group, id);
+        await client.xdel(stream, id).catch(() => void 0);
+      },
+      isRedelivered() {
+        return parsed.deliveryCount > 1;
+      },
+      getDeliveryAttempt() {
+        return parsed.deliveryCount;
+      }
+    };
+  }
+  async sweepPending() {
+    if (this.stopped || this.knownStreams.size === 0) return;
+    const client = this.connection.getClient();
+    for (const [stream] of this.knownStreams) {
+      try {
+        const claimed = await client.xautoclaim(stream, this.group, this.consumerName, this.ackWaitMs, "0", "COUNT", 50);
+        if (!claimed) continue;
+        const entries = claimed[1] ?? [];
+        for (const [id, rawFields] of entries) {
+          const pending = await client.xpending(stream, this.group, "IDLE", 0, "-", "+", 1, this.consumerName);
+          const deliveryCount = Array.isArray(pending) && pending[0] ? pending[0][3] : 1;
+          if (deliveryCount > this.maxDeliver) {
+            const flat = [];
+            for (let i = 0; i + 1 < rawFields.length; i += 2) {
+              flat.push(rawFields[i], rawFields[i + 1]);
+            }
+            flat.push("dlq-reason", "max-deliver-exceeded");
+            flat.push("dlq-deliveries", String(deliveryCount));
+            await client.xadd(dlqKey(stream), "MAXLEN", "~", 1e4, "*", ...flat);
+            await client.xack(stream, this.group, id);
+            await client.xdel(stream, id).catch(() => void 0);
+            logger.warn("[RedisStreamsEventConsumer] message moved to DLQ", {
+              stream,
+              id,
+              deliveryCount
+            });
+          }
+        }
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes("NOGROUP")) continue;
+        logger.debug("[RedisStreamsEventConsumer] sweep iteration error", {
+          stream,
+          error: msg
+        });
+      }
+    }
+  }
+  async drainDelayQueues() {
+    if (this.stopped || this.knownStreams.size === 0) return;
+    const client = this.connection.getClient();
+    for (const [stream] of this.knownStreams) {
+      const lockKey = delayLockKey(stream);
+      const got = await client.set(lockKey, this.consumerName, "NX", "EX", 30).catch(() => null);
+      if (got !== "OK") continue;
+      try {
+        const due = await client.zrangebyscore(delayQueueKey(stream), 0, Date.now(), "LIMIT", 0, 50);
+        for (const member of due) {
+          const split = member.indexOf("|");
+          if (split < 0) continue;
+          const payload = member.slice(split + 1);
+          let fields = {};
+          try {
+            fields = JSON.parse(payload);
+          } catch {
+            continue;
+          }
+          const flat = [];
+          for (const [k, v] of Object.entries(fields)) flat.push(k, v);
+          await client.xadd(stream, "MAXLEN", "~", 1e5, "*", ...flat);
+          await client.zrem(delayQueueKey(stream), member);
+        }
+      } finally {
+        await client.del(lockKey).catch(() => void 0);
+      }
+    }
+  }
+};
+var RedisStreamsEventPublisher = class {
+  static {
+    __name(this, "RedisStreamsEventPublisher");
+  }
+  config;
+  connection;
+  publishCount = 0;
+  lastPublishTime = null;
+  maxLen;
+  dedupTtl;
+  keyPrefix;
+  constructor(config) {
+    this.config = config;
+    this.connection = new RedisStreamsConnection(config);
+    this.maxLen = config.maxLen ?? parseInt(process.env["REDIS_STREAMS_MAXLEN"] ?? "100000", 10);
+    this.dedupTtl = config.dedupTtlSeconds ?? parseInt(process.env["REDIS_STREAMS_DEDUP_TTL"] ?? "120", 10);
+    this.keyPrefix = config.keyPrefix ?? process.env["REDIS_STREAMS_KEY_PREFIX"] ?? "boff:events";
+  }
+  async connect() {
+    await this.connection.connect();
+  }
+  async disconnect() {
+    await this.connection.disconnect();
+  }
+  isConnected() {
+    return this.connection.isConnected();
+  }
+  async healthCheck() {
+    try {
+      const t0 = Date.now();
+      const pong = await this.connection.ping();
+      return {
+        status: pong === "PONG" ? "healthy" : "degraded",
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        connected: this.isConnected(),
+        latencyMs: Date.now() - t0,
+        details: {
+          type: "redis-streams",
+          url: this.config.url
+        }
+      };
+    } catch (err) {
+      return {
+        status: "unhealthy",
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        connected: false,
+        details: {
+          type: "redis-streams"
+        },
+        error: err instanceof Error ? err.message : String(err)
+      };
+    }
+  }
+  async getStatistics() {
+    return {
+      messagesPublished: this.publishCount,
+      messagesConsumed: 0,
+      messagesFailed: 0,
+      activePublishers: 1,
+      activeConsumers: 0,
+      lastActivity: this.lastPublishTime?.toISOString() ?? null,
+      details: {
+        type: "redis-streams"
+      }
+    };
+  }
+  async ensureStream(_config) {
+    return Promise.resolve();
+  }
+  async publish(options) {
+    return this.publishInternal(options);
+  }
+  async publishInternal(opts) {
+    await this.connect();
+    const client = this.connection.getClient();
+    const stream = streamKey(opts.subject, {
+      prefix: this.keyPrefix
+    });
+    const msgId = opts.options?.messageId ?? randomUUID();
+    const correlationId = opts.metadata?.correlationId ?? randomUUID();
+    const enableDedup = this.config.enableDeduplication === true || opts.options?.messageId !== void 0;
+    if (enableDedup) {
+      const ok = await client.set(dedupKey(stream, msgId), "1", "NX", "EX", this.dedupTtl);
+      if (ok !== "OK") {
+        logger.debug("[RedisStreamsEventPublisher] dedup hit; skipping publish", {
+          subject: opts.subject,
+          msgId
+        });
+        return msgId;
+      }
+    }
+    const trace = await injectTraceFields();
+    const fields = {
+      "msg-id": msgId,
+      subject: opts.subject,
+      "correlation-id": correlationId,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      priority: opts.options?.priority ?? this.config.defaultPriority ?? "normal",
+      source: opts.metadata?.source ?? this.config.name ?? "unknown",
+      payload: JSON.stringify(opts.data ?? null),
+      metadata: JSON.stringify(opts.metadata ?? {}),
+      ...trace
+    };
+    if (opts.metadata?.userId) fields["user-id"] = String(opts.metadata.userId);
+    if (opts.metadata?.workspaceId) fields["workspace-id"] = String(opts.metadata.workspaceId);
+    if (opts.metadata?.tenantId) fields["tenant-id"] = String(opts.metadata.tenantId);
+    const flat = [];
+    for (const [k, v] of Object.entries(fields)) {
+      flat.push(k, v);
+    }
+    const id = await client.xadd(stream, "MAXLEN", "~", this.maxLen, "*", ...flat);
+    void client.sadd(registryKey(boundaryOf(opts.subject)), opts.subject).catch(() => void 0);
+    this.publishCount++;
+    this.lastPublishTime = /* @__PURE__ */ new Date();
+    logger.debug("[RedisStreamsEventPublisher] published", {
+      subject: opts.subject,
+      stream,
+      id
+    });
+    return id;
+  }
+  async publishBatch(events) {
+    const out = [];
+    for (const e of events) {
+      out.push(await this.publishInternal(e));
+    }
+    return out;
+  }
+  /**
+  * Emulated request/response: writer XADDs onto its own subject, then
+  * blocks on a one-shot reply stream keyed by correlationId.
+  */
+  async publishWithAck(opts) {
+    await this.connect();
+    const client = this.connection.getClient();
+    const correlationId = opts.metadata?.correlationId ?? randomUUID();
+    const reply = replyKey(correlationId);
+    await this.publishInternal({
+      subject: opts.subject,
+      data: opts.data,
+      metadata: {
+        ...opts.metadata,
+        correlationId,
+        replyTo: reply
+      }
+    });
+    const timeoutMs = opts.timeout ?? 5e3;
+    const t0 = Date.now();
+    while (Date.now() - t0 < timeoutMs) {
+      const entries = await client.xrange(reply, "-", "+");
+      if (Array.isArray(entries) && entries.length > 0) {
+        const last = entries[entries.length - 1];
+        if (!last) break;
+        const rawFields = last[1];
+        const payloadIdx = rawFields.indexOf("payload");
+        const payload = payloadIdx >= 0 ? rawFields[payloadIdx + 1] : "{}";
+        await client.del(reply);
+        return JSON.parse(payload ?? "{}");
+      }
+      await new Promise((res) => setTimeout(res, 50));
+    }
+    await client.del(reply).catch(() => void 0);
+    throw new Error(`[RedisStreamsEventPublisher] publishWithAck timed out for subject=${opts.subject}`);
+  }
+  /** Internal helper used by the consumer's reply path. */
+  async sendReply(correlationId, data) {
+    await this.connect();
+    const client = this.connection.getClient();
+    const key = replyKey(correlationId);
+    await client.xadd(key, "*", "payload", JSON.stringify(data ?? null));
+    await client.expire(key, 60);
+  }
+};
+
 // src/event-queue/factory/EventQueueFactory.ts
+function resolveQueueType() {
+  const raw = (process.env["EVENT_QUEUE_TYPE"] ?? process.env["QUEUE_TYPE"] ?? "").toLowerCase();
+  if (raw === "redis-streams" || raw === "redis" || raw === "streams") return QueueType.REDIS_STREAMS;
+  if (raw === "nats") return QueueType.NATS;
+  if (!process.env["NATS_URL"] && !process.env["NATS_SERVERS"] && process.env["REDIS_URL"]) {
+    return QueueType.REDIS_STREAMS;
+  }
+  return QueueType.NATS;
+}
+__name(resolveQueueType, "resolveQueueType");
 var EventQueueFactory = class _EventQueueFactory {
   static {
     __name(this, "EventQueueFactory");
@@ -937,6 +1823,9 @@ var EventQueueFactory = class _EventQueueFactory {
     if (config.type === QueueType.NATS) {
       return new NatsEventPublisher(config);
     }
+    if (config.type === QueueType.REDIS_STREAMS) {
+      return new RedisStreamsEventPublisher(config);
+    }
     throw new Error(`Unsupported queue type: ${config.type}`);
   }
   /**
@@ -952,14 +1841,28 @@ var EventQueueFactory = class _EventQueueFactory {
     if (config.type === QueueType.NATS) {
       return new NatsEventConsumer(config);
     }
+    if (config.type === QueueType.REDIS_STREAMS) {
+      return new RedisStreamsEventConsumer(config);
+    }
     throw new Error(`Unsupported queue type: ${config.type}`);
   }
   /**
   * Create a publisher from environment variables
   */
   static createPublisherFromEnv() {
+    const type = resolveQueueType();
+    if (type === QueueType.REDIS_STREAMS) {
+      return _EventQueueFactory.createPublisher({
+        type,
+        url: process.env["REDIS_URL"] ?? "redis://localhost:6379",
+        password: process.env["REDIS_PASSWORD"],
+        name: process.env["QUEUE_CLIENT_NAME"] ?? process.env["SERVICE_NAME"] ?? "be-sdk-publisher",
+        enableDeduplication: process.env["QUEUE_ENABLE_DEDUPLICATION"] === "true",
+        defaultPriority: process.env["QUEUE_DEFAULT_PRIORITY"] ?? "normal"
+      });
+    }
     const config = {
-      type: process.env["QUEUE_TYPE"] || QueueType.NATS,
+      type,
       url: process.env["NATS_URL"] || "nats://localhost:4222",
       user: process.env["NATS_USER"],
       password: process.env["NATS_PASSWORD"],
@@ -979,8 +1882,22 @@ var EventQueueFactory = class _EventQueueFactory {
   * Create a consumer from environment variables
   */
   static createConsumerFromEnv(stream, consumer) {
+    const type = resolveQueueType();
+    if (type === QueueType.REDIS_STREAMS) {
+      return _EventQueueFactory.createConsumer({
+        type,
+        url: process.env["REDIS_URL"] ?? "redis://localhost:6379",
+        password: process.env["REDIS_PASSWORD"],
+        name: process.env["QUEUE_CLIENT_NAME"] ?? process.env["SERVICE_NAME"] ?? consumer,
+        stream,
+        consumer,
+        maxConcurrent: process.env["QUEUE_MAX_CONCURRENT"] ? parseInt(process.env["QUEUE_MAX_CONCURRENT"], 10) : 5,
+        maxDeliver: process.env["QUEUE_MAX_DELIVER"] ? parseInt(process.env["QUEUE_MAX_DELIVER"], 10) : 3,
+        ackWait: process.env["QUEUE_ACK_WAIT"] ? parseInt(process.env["QUEUE_ACK_WAIT"], 10) * 1e9 : 3e10
+      });
+    }
     const config = {
-      type: process.env["QUEUE_TYPE"] || QueueType.NATS,
+      type,
       url: process.env["NATS_URL"] || "nats://localhost:4222",
       user: process.env["NATS_USER"],
       password: process.env["NATS_PASSWORD"],
@@ -1018,8 +1935,19 @@ var EventQueueFactory = class _EventQueueFactory {
   static createPublisherForLayer(layer, serviceName) {
     const envPrefix = layer.toUpperCase();
     const defaults = DEFAULT_LAYER_RESOURCES[layer];
+    const type = resolveQueueType();
+    if (type === QueueType.REDIS_STREAMS) {
+      return _EventQueueFactory.createPublisher({
+        type,
+        url: process.env["REDIS_URL"] ?? "redis://localhost:6379",
+        password: process.env["REDIS_PASSWORD"],
+        name: serviceName,
+        enableDeduplication: process.env["QUEUE_ENABLE_DEDUPLICATION"] === "true",
+        defaultPriority: process.env["QUEUE_DEFAULT_PRIORITY"] || "normal"
+      });
+    }
     const config = {
-      type: QueueType.NATS,
+      type,
       url: process.env[`${envPrefix}_NATS_URL`] || process.env["NATS_URL"] || defaults.natsUrl,
       user: process.env["NATS_USER"],
       password: process.env["NATS_PASSWORD"],
@@ -1061,8 +1989,22 @@ var EventQueueFactory = class _EventQueueFactory {
   static createConsumerForLayer(layer, serviceName, stream, consumer) {
     const envPrefix = layer.toUpperCase();
     const defaults = DEFAULT_LAYER_RESOURCES[layer];
+    const type = resolveQueueType();
+    if (type === QueueType.REDIS_STREAMS) {
+      return _EventQueueFactory.createConsumer({
+        type,
+        url: process.env["REDIS_URL"] ?? "redis://localhost:6379",
+        password: process.env["REDIS_PASSWORD"],
+        name: serviceName,
+        stream,
+        consumer,
+        maxConcurrent: process.env["QUEUE_MAX_CONCURRENT"] ? parseInt(process.env["QUEUE_MAX_CONCURRENT"], 10) : 5,
+        maxDeliver: process.env["QUEUE_MAX_DELIVER"] ? parseInt(process.env["QUEUE_MAX_DELIVER"], 10) : 3,
+        ackWait: process.env["QUEUE_ACK_WAIT"] ? parseInt(process.env["QUEUE_ACK_WAIT"], 10) * 1e9 : 3e10
+      });
+    }
     const config = {
-      type: QueueType.NATS,
+      type,
       url: process.env[`${envPrefix}_NATS_URL`] || process.env["NATS_URL"] || defaults.natsUrl,
       user: process.env["NATS_USER"],
       password: process.env["NATS_PASSWORD"],
@@ -1089,6 +2031,6 @@ var EventQueueFactory = class _EventQueueFactory {
   }
 };
 
-export { EventQueueFactory, NatsEventConsumer, NatsEventPublisher };
-//# sourceMappingURL=chunk-KSO6QQVD.js.map
-//# sourceMappingURL=chunk-KSO6QQVD.js.map
+export { EventQueueFactory, NatsEventConsumer, NatsEventPublisher, RedisStreamsEventConsumer, RedisStreamsEventPublisher, dlqKey, streamKey };
+//# sourceMappingURL=chunk-EMSON3UD.js.map
+//# sourceMappingURL=chunk-EMSON3UD.js.map