@burdenoff/be-sdk 2026.516.1 → 2026.516.2

package/dist/chunk-TM5RQ6P2.js

@@ -0,0 +1,925 @@
+import { RedisStreamsConnection, isWildcard, streamKey, boundaryOf, dlqKey, registryKey, delayQueueKey, delayLockKey, dedupKey, replyKey, matchSubject } from './chunk-MVHOP4IG.js';
+import { logger } from './chunk-CBZNP6RF.js';
+import { __name } from './chunk-XE4OXN2W.js';
+import { randomUUID } from 'crypto';
+import { hostname } from 'os';
+
+// src/event-queue/implementations/redis-streams/trace-context.ts
+var otelApiPromise = null;
+async function loadOtelApi() {
+  if (otelApiPromise) return otelApiPromise;
+  otelApiPromise = (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 otelApiPromise;
+}
+__name(loadOtelApi, "loadOtelApi");
+var TRACE_KEYS = [
+  "traceparent",
+  "tracestate",
+  "baggage"
+];
+async function injectTraceFields() {
+  const api = await loadOtelApi();
+  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 loadOtelApi();
+  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 runWithConsumerSpan(subject, fields, handler) {
+  const api = await loadOtelApi();
+  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(runWithConsumerSpan, "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 runWithConsumerSpan(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/types/config.ts
+var QueueType = /* @__PURE__ */ (function(QueueType2) {
+  QueueType2["REDIS_STREAMS"] = "redis-streams";
+  QueueType2["RABBITMQ"] = "rabbitmq";
+  QueueType2["KAFKA"] = "kafka";
+  QueueType2["SQS"] = "sqs";
+  return QueueType2;
+})({});
+
+// src/event-queue/factory/EventQueueFactory.ts
+function resolveQueueType() {
+  return QueueType.REDIS_STREAMS;
+}
+__name(resolveQueueType, "resolveQueueType");
+var EventQueueFactory = class _EventQueueFactory {
+  static {
+    __name(this, "EventQueueFactory");
+  }
+  /**
+  * Create an event publisher based on configuration
+  */
+  static createPublisher(config) {
+    logger.info("[EventQueueFactory] Creating event publisher", {
+      type: config.type,
+      url: config.url
+    });
+    if (config.type === QueueType.REDIS_STREAMS) {
+      return new RedisStreamsEventPublisher(config);
+    }
+    throw new Error(`Unsupported queue type: ${config.type}. NATS was retired on 2026-05-16; use 'redis-streams'.`);
+  }
+  /**
+  * Create an event consumer based on configuration
+  */
+  static createConsumer(config) {
+    logger.info("[EventQueueFactory] Creating event consumer", {
+      type: config.type,
+      url: config.url,
+      stream: config.stream,
+      consumer: config.consumer
+    });
+    if (config.type === QueueType.REDIS_STREAMS) {
+      return new RedisStreamsEventConsumer(config);
+    }
+    throw new Error(`Unsupported queue type: ${config.type}. NATS was retired on 2026-05-16; use 'redis-streams'.`);
+  }
+  /**
+  * Create a publisher from environment variables.
+  * Reads `REDIS_URL`, `REDIS_PASSWORD`, and standard queue options.
+  */
+  static createPublisherFromEnv() {
+    return _EventQueueFactory.createPublisher({
+      type: QueueType.REDIS_STREAMS,
+      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"
+    });
+  }
+  /**
+  * Create a consumer from environment variables.
+  */
+  static createConsumerFromEnv(stream, consumer) {
+    return _EventQueueFactory.createConsumer({
+      type: QueueType.REDIS_STREAMS,
+      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
+    });
+  }
+  // ========================================================================
+  // Layer-Aware Factory Methods
+  // ========================================================================
+  /**
+  * Create a publisher for a specific layer.
+  * The layer is preserved on the publisher name; otherwise identical to
+  * `createPublisherFromEnv()`.
+  */
+  static createPublisherForLayer(_layer, serviceName) {
+    return _EventQueueFactory.createPublisher({
+      type: QueueType.REDIS_STREAMS,
+      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"
+    });
+  }
+  /**
+  * Create a consumer for a specific layer.
+  */
+  static createConsumerForLayer(_layer, serviceName, stream, consumer) {
+    return _EventQueueFactory.createConsumer({
+      type: QueueType.REDIS_STREAMS,
+      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
+    });
+  }
+};
+
+export { EventQueueFactory, QueueType, RedisStreamsEventConsumer, RedisStreamsEventPublisher, resolveQueueType };
+//# sourceMappingURL=chunk-TM5RQ6P2.js.map
+//# sourceMappingURL=chunk-TM5RQ6P2.js.map