@burdenoff/be-sdk 2026.510.79

package/dist/chunk-3O2RQOPV.js

@@ -0,0 +1,1068 @@
+import { QueueType } from './chunk-L7ZMN2FJ.js';
+import { NatsConnectionManager } from './chunk-OVSYMNCI.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';
+
+// src/event-queue/implementations/nats/trace-context.ts
+var otelApiPromise = null;
+async function loadOtelApi() {
+  if (otelApiPromise) {
+    return otelApiPromise;
+  }
+  otelApiPromise = (async () => {
+    try {
+      const mod = await import('./esm-K6H7EIWK.js');
+      return mod;
+    } catch {
+      logger.debug("[trace-context] @opentelemetry/api not available; NATS traces disabled");
+      return null;
+    }
+  })();
+  return otelApiPromise;
+}
+__name(loadOtelApi, "loadOtelApi");
+var setter = {
+  set(carrier, key, value) {
+    carrier[key] = value;
+  }
+};
+var getter = {
+  get(carrier, key) {
+    return carrier[key];
+  },
+  keys(carrier) {
+    return Object.keys(carrier);
+  }
+};
+async function injectW3CTraceContext(hdrs) {
+  const api = await loadOtelApi();
+  if (!api) return;
+  try {
+    const carrier = {};
+    api.propagation.inject(api.context.active(), carrier, setter);
+    for (const [key, value] of Object.entries(carrier)) {
+      if (value) hdrs.set(key, value);
+    }
+  } catch (err) {
+    logger.debug("[trace-context] injection failed", {
+      error: err instanceof Error ? err.message : String(err)
+    });
+  }
+}
+__name(injectW3CTraceContext, "injectW3CTraceContext");
+async function extractW3CTraceContext(hdrs) {
+  const api = await loadOtelApi();
+  if (!api || !hdrs) return void 0;
+  try {
+    const carrier = {};
+    for (const key of [
+      "traceparent",
+      "tracestate",
+      "baggage"
+    ]) {
+      const value = hdrs.get(key);
+      if (value) carrier[key] = value;
+    }
+    return api.propagation.extract(api.context.active(), carrier, getter);
+  } catch (err) {
+    logger.debug("[trace-context] extraction failed", {
+      error: err instanceof Error ? err.message : String(err)
+    });
+    return void 0;
+  }
+}
+__name(extractW3CTraceContext, "extractW3CTraceContext");
+async function runWithConsumerSpan(subject, hdrs, handler) {
+  const api = await loadOtelApi();
+  if (!api) return handler();
+  try {
+    const parentCtx = await extractW3CTraceContext(hdrs);
+    const tracer = api.trace.getTracer("@burdenoff/be-sdk/nats");
+    return await new Promise((resolve, reject) => {
+      tracer.startActiveSpan(`nats.consume ${subject}`, {
+        kind: 5,
+        attributes: {
+          "messaging.system": "nats",
+          "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 (err) {
+    logger.debug("[trace-context] consumer span failed to start; running without span", {
+      error: err instanceof Error ? err.message : String(err)
+    });
+    return handler();
+  }
+}
+__name(runWithConsumerSpan, "runWithConsumerSpan");
+var NatsSubscription = class NatsSubscription2 {
+  static {
+    __name(this, "NatsSubscription");
+  }
+  id;
+  subject;
+  stopFn;
+  active = true;
+  stats = {
+    messagesReceived: 0,
+    messagesProcessed: 0,
+    messagesFailed: 0,
+    lastActivity: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  constructor(id, subject, stopFn) {
+    this.id = id;
+    this.subject = subject;
+    this.stopFn = stopFn;
+  }
+  async unsubscribe() {
+    if (!this.active) {
+      return Promise.resolve();
+    }
+    this.active = false;
+    this.stopFn();
+    return Promise.resolve();
+  }
+  isActive() {
+    return this.active;
+  }
+  getStats() {
+    return {
+      messagesReceived: this.stats.messagesReceived,
+      messagesProcessed: this.stats.messagesProcessed,
+      messagesFailed: this.stats.messagesFailed,
+      lastActivity: this.stats.lastActivity
+    };
+  }
+  incrementReceived() {
+    this.stats.messagesReceived++;
+    this.stats.lastActivity = (/* @__PURE__ */ new Date()).toISOString();
+  }
+  incrementProcessed() {
+    this.stats.messagesProcessed++;
+    this.stats.lastActivity = (/* @__PURE__ */ new Date()).toISOString();
+  }
+  incrementFailed() {
+    this.stats.messagesFailed++;
+    this.stats.lastActivity = (/* @__PURE__ */ new Date()).toISOString();
+  }
+};
+var NatsEventConsumer = class {
+  static {
+    __name(this, "NatsEventConsumer");
+  }
+  config;
+  connectionManager;
+  subscriptions = /* @__PURE__ */ new Map();
+  constructor(config) {
+    this.config = config;
+    const baseConfig = {
+      type: config.type || "nats",
+      url: config.url || "nats://localhost:4222",
+      user: config.user,
+      password: config.password,
+      token: config.token,
+      maxReconnectAttempts: config.maxReconnectAttempts,
+      reconnectTimeWait: config.reconnectTimeWait,
+      connectionTimeout: config.connectionTimeout,
+      name: config.name
+    };
+    this.connectionManager = new NatsConnectionManager(baseConfig);
+  }
+  /**
+  * Connect to NATS server
+  */
+  async connect() {
+    await this.connectionManager.connect();
+  }
+  /**
+  * Disconnect from NATS server
+  */
+  async disconnect() {
+    await this.unsubscribeAll();
+    await this.connectionManager.disconnect();
+  }
+  /**
+  * Check if connected
+  */
+  isConnected() {
+    return this.connectionManager.isConnected();
+  }
+  /**
+  * Health check
+  */
+  async healthCheck() {
+    await Promise.resolve();
+    const isConnected = this.isConnected();
+    return {
+      status: isConnected ? "healthy" : "unhealthy",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      connected: isConnected,
+      details: {
+        type: "nats",
+        url: this.config.url,
+        activeSubscriptions: this.subscriptions.size
+      }
+    };
+  }
+  /**
+  * Get queue statistics
+  */
+  async getStatistics() {
+    await Promise.resolve();
+    let totalReceived = 0;
+    let totalProcessed = 0;
+    let totalFailed = 0;
+    let lastActivity = null;
+    for (const subscription of this.subscriptions.values()) {
+      const stats = subscription.getStats();
+      totalReceived += stats.messagesReceived;
+      totalProcessed += stats.messagesProcessed;
+      totalFailed += stats.messagesFailed;
+      if (stats.lastActivity && (!lastActivity || stats.lastActivity > lastActivity)) {
+        lastActivity = stats.lastActivity;
+      }
+    }
+    return {
+      messagesPublished: 0,
+      messagesConsumed: totalProcessed,
+      messagesFailed: totalFailed,
+      activeConsumers: this.subscriptions.size,
+      activePublishers: 0,
+      queueSize: 0,
+      lastActivity,
+      details: {
+        totalReceived,
+        type: "nats"
+      }
+    };
+  }
+  /**
+  * Ensure a stream exists
+  */
+  async ensureStream(config) {
+    const jsm = this.connectionManager.getJetStreamManager();
+    try {
+      try {
+        await jsm.streams.info(config.name);
+        logger.debug("[NatsEventConsumer] Stream already exists", {
+          stream: config.name
+        });
+        return;
+      } catch {
+      }
+      const streamConfig = {
+        name: config.name,
+        subjects: config.subjects,
+        retention: this.mapRetentionPolicy(config.retention),
+        storage: this.mapStorageType(config.storage),
+        max_consumers: config.maxConsumers,
+        max_msgs: config.maxMsgs,
+        max_bytes: config.maxBytes,
+        max_age: config.maxAge,
+        duplicate_window: config.duplicateWindow
+      };
+      await jsm.streams.add(streamConfig);
+      logger.info("[NatsEventConsumer] Stream created successfully", {
+        stream: config.name,
+        subjects: config.subjects
+      });
+    } catch (error) {
+      logger.error("[NatsEventConsumer] Failed to ensure stream", {
+        stream: config.name,
+        error: error instanceof Error ? error.message : "Unknown error"
+      });
+      throw error;
+    }
+  }
+  /**
+  * Ensure a consumer exists
+  */
+  async ensureConsumer(config) {
+    const jsm = this.connectionManager.getJetStreamManager();
+    try {
+      await jsm.consumers.add(config.stream, {
+        name: config.consumer,
+        durable_name: config.consumer,
+        filter_subject: config.filterSubject,
+        ack_policy: this.mapAckPolicy(config.ackPolicy),
+        deliver_policy: this.mapDeliverPolicy(config.deliverPolicy),
+        max_deliver: config.maxDeliver || 3,
+        ack_wait: config.ackWait || 3e10,
+        max_ack_pending: config.maxAckPending || 100
+      });
+      logger.info("[NatsEventConsumer] Consumer created successfully", {
+        stream: config.stream,
+        consumer: config.consumer
+      });
+    } catch (error) {
+      if (error instanceof Error && error.message?.includes("already exists")) {
+        logger.debug("[NatsEventConsumer] Consumer already exists", {
+          stream: config.stream,
+          consumer: config.consumer
+        });
+      } else {
+        logger.error("[NatsEventConsumer] Failed to ensure consumer", {
+          stream: config.stream,
+          consumer: config.consumer,
+          error: error instanceof Error ? error.message : "Unknown error"
+        });
+        throw error;
+      }
+    }
+  }
+  /**
+  * Derive stream subject pattern from subscription subject
+  * Examples:
+  *   - "channel.conversation.message" → ["channel.>"]
+  *   - "wspace.tags.created" → ["wspace.>"]
+  *   - "global.auth.login" → ["global.>"]
+  */
+  deriveStreamSubjects(subject) {
+    const firstSegment = subject.split(".")[0];
+    if (firstSegment) {
+      return [
+        `${firstSegment}.>`
+      ];
+    }
+    return [
+      `${subject.replace(/\.[^.]+$/, ".>")}`
+    ];
+  }
+  /**
+  * Subscribe to a subject
+  */
+  async subscribe(options) {
+    const js = this.connectionManager.getJetStream();
+    try {
+      const streamName = options.options?.stream || this.config.stream;
+      const consumerName = options.options?.consumer || `${this.config.consumer}-${options.subject.replace(/\./g, "-")}`;
+      const streamSubjects = options.options?.streamSubjects || this.deriveStreamSubjects(options.subject);
+      await this.ensureStream({
+        name: streamName,
+        subjects: streamSubjects,
+        retention: options.options?.retention || "limits",
+        storage: options.options?.storage || "file"
+      });
+      await this.ensureConsumer({
+        type: this.config.type,
+        url: this.config.url,
+        consumer: consumerName,
+        stream: streamName,
+        filterSubject: options.subject,
+        ackPolicy: options.options?.ackPolicy,
+        deliverPolicy: options.options?.deliverPolicy,
+        maxDeliver: options.options?.maxDeliver || this.config.maxDeliver,
+        ackWait: options.options?.ackWait || this.config.ackWait,
+        maxAckPending: options.options?.maxAckPending
+      });
+      const consumer = await js.consumers.get(streamName, consumerName);
+      const subscriptionId = `sub_${Date.now()}_${crypto.randomUUID().substring(0, 7)}`;
+      let stopRequested = false;
+      const stopFn = /* @__PURE__ */ __name(() => {
+        stopRequested = true;
+      }, "stopFn");
+      const subscription = new NatsSubscription(subscriptionId, options.subject, stopFn);
+      this.subscriptions.set(subscriptionId, subscription);
+      this.consumeMessages(consumer, subscription, options.handler, options.options?.maxConcurrent || this.config.maxConcurrent || 1, () => stopRequested).catch((error) => {
+        logger.error("[NatsEventConsumer] Error in message consumption loop", {
+          subject: options.subject,
+          error: error instanceof Error ? error.message : "Unknown error"
+        });
+      });
+      logger.info("[NatsEventConsumer] Subscription created", {
+        subscriptionId,
+        subject: options.subject
+      });
+      return subscription;
+    } catch (error) {
+      logger.error("[NatsEventConsumer] Failed to subscribe", {
+        subject: options.subject,
+        error: error instanceof Error ? error.message : "Unknown error"
+      });
+      throw error;
+    }
+  }
+  /**
+  * Subscribe to multiple subjects
+  */
+  async subscribeMultiple(subjects, handler, options) {
+    const subscriptions = [];
+    for (const subject of subjects) {
+      const subscription = await this.subscribe({
+        subject,
+        handler,
+        options
+      });
+      subscriptions.push(subscription);
+    }
+    return subscriptions;
+  }
+  /**
+  * Pull messages manually
+  */
+  async pull(options) {
+    const js = this.connectionManager.getJetStream();
+    try {
+      const consumer = await js.consumers.get(this.config.stream, this.config.consumer);
+      const messages = await consumer.fetch({
+        max_messages: options.batch || 10,
+        expires: options.timeout || 3e4
+      });
+      const events = [];
+      for await (const msg of messages) {
+        const event = this.wrapMessage(msg);
+        events.push(event);
+      }
+      return events;
+    } catch (error) {
+      logger.error("[NatsEventConsumer] Failed to pull messages", {
+        subject: options.subject,
+        error: error instanceof Error ? error.message : "Unknown error"
+      });
+      throw error;
+    }
+  }
+  /**
+  * Unsubscribe from all active subscriptions
+  */
+  async unsubscribeAll() {
+    const unsubscribePromises = Array.from(this.subscriptions.values()).map(async (subscription) => subscription.unsubscribe());
+    await Promise.all(unsubscribePromises);
+    this.subscriptions.clear();
+    logger.info("[NatsEventConsumer] All subscriptions unsubscribed");
+  }
+  /**
+  * Get all active subscriptions
+  */
+  getSubscriptions() {
+    return Array.from(this.subscriptions.values());
+  }
+  /**
+  * Process pending messages in dead letter queue
+  */
+  async processDLQ(_handler) {
+    await Promise.resolve();
+    logger.warn("[NatsEventConsumer] DLQ processing not yet implemented");
+  }
+  /**
+  * List subjects for the configured stream
+  */
+  async listSubjects(streamName) {
+    const jsm = this.connectionManager.getJetStreamManager();
+    const info = await jsm.streams.info(streamName || this.config.stream);
+    return info.config.subjects || [];
+  }
+  /**
+  * Consume messages from consumer
+  */
+  async consumeMessages(consumer, subscription, handler, maxConcurrent, stopRequested) {
+    try {
+      const messages = await consumer.consume({
+        max_messages: maxConcurrent,
+        expires: 3e4
+      });
+      for await (const msg of messages) {
+        if (stopRequested()) {
+          break;
+        }
+        subscription.incrementReceived();
+        try {
+          const event = this.wrapMessage(msg);
+          await runWithConsumerSpan(msg.subject, msg.headers, async () => handler(event));
+          subscription.incrementProcessed();
+        } catch (error) {
+          subscription.incrementFailed();
+          logger.error("[NatsEventConsumer] Error processing message", {
+            subject: msg.subject,
+            error: error instanceof Error ? error.message : "Unknown error"
+          });
+          msg.nak();
+        }
+      }
+    } catch (error) {
+      logger.error("[NatsEventConsumer] Error consuming messages", {
+        error: error instanceof Error ? error.message : "Unknown error"
+      });
+    }
+  }
+  /**
+  * Wrap NATS message in AcknowledgeableEvent
+  */
+  wrapMessage(msg) {
+    const eventMessage = JSON.parse(msg.data.toString());
+    return {
+      ...eventMessage,
+      sequence: msg.seq,
+      ack: /* @__PURE__ */ __name(async () => {
+        await Promise.resolve();
+        msg.ack();
+      }, "ack"),
+      nak: /* @__PURE__ */ __name(async (delay) => {
+        await Promise.resolve();
+        if (delay) {
+          msg.nak(delay);
+        } else {
+          msg.nak();
+        }
+      }, "nak"),
+      term: /* @__PURE__ */ __name(async () => {
+        await Promise.resolve();
+        msg.term();
+      }, "term"),
+      isRedelivered: /* @__PURE__ */ __name(() => {
+        return msg.redelivered;
+      }, "isRedelivered"),
+      getDeliveryAttempt: /* @__PURE__ */ __name(() => {
+        return msg.info.deliveryCount;
+      }, "getDeliveryAttempt")
+    };
+  }
+  /**
+  * Map retention policy string to NATS enum
+  */
+  mapRetentionPolicy(policy) {
+    switch (policy?.toLowerCase()) {
+      case "limits":
+        return RetentionPolicy.Limits;
+      case "interest":
+        return RetentionPolicy.Interest;
+      case "workqueue":
+      default:
+        return RetentionPolicy.Workqueue;
+    }
+  }
+  /**
+  * Map storage type string to NATS enum
+  */
+  mapStorageType(storage) {
+    switch (storage?.toLowerCase()) {
+      case "memory":
+        return StorageType.Memory;
+      case "file":
+      default:
+        return StorageType.File;
+    }
+  }
+  /**
+  * Map ack policy string to NATS enum
+  */
+  mapAckPolicy(policy) {
+    switch (policy?.toLowerCase()) {
+      case "none":
+        return AckPolicy.None;
+      case "all":
+        return AckPolicy.All;
+      case "explicit":
+      default:
+        return AckPolicy.Explicit;
+    }
+  }
+  /**
+  * Map deliver policy string to NATS enum
+  */
+  mapDeliverPolicy(policy) {
+    switch (policy?.toLowerCase()) {
+      case "new":
+        return DeliverPolicy.New;
+      case "last":
+        return DeliverPolicy.Last;
+      case "lastpersubject":
+        return DeliverPolicy.LastPerSubject;
+      case "all":
+      default:
+        return DeliverPolicy.All;
+    }
+  }
+};
+var NatsEventPublisher = class {
+  static {
+    __name(this, "NatsEventPublisher");
+  }
+  config;
+  connectionManager;
+  publishCount = 0;
+  lastPublishTime = null;
+  constructor(config) {
+    this.config = config;
+    this.connectionManager = new NatsConnectionManager(config);
+  }
+  /**
+  * Connect to NATS server
+  */
+  async connect() {
+    await this.connectionManager.connect();
+  }
+  /**
+  * Disconnect from NATS server
+  */
+  async disconnect() {
+    await this.connectionManager.disconnect();
+  }
+  /**
+  * Check if connected
+  */
+  isConnected() {
+    return this.connectionManager.isConnected();
+  }
+  /**
+  * Health check
+  */
+  async healthCheck() {
+    await Promise.resolve();
+    const isConnected = this.isConnected();
+    return {
+      status: isConnected ? "healthy" : "unhealthy",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      details: {
+        connected: isConnected,
+        type: "nats",
+        url: this.config.url
+      }
+    };
+  }
+  /**
+  * Get queue statistics
+  */
+  async getStatistics() {
+    const jsm = this.connectionManager.getJetStreamManager();
+    try {
+      const streams = await jsm.streams.list().next();
+      const streamCount = streams.length;
+      return {
+        messagesPublished: this.publishCount,
+        messagesConsumed: 0,
+        messagesFailed: 0,
+        activeConsumers: 0,
+        activePublishers: 1,
+        queueSize: 0,
+        lastActivity: this.lastPublishTime?.toISOString() || null,
+        details: {
+          streamCount,
+          type: "nats"
+        }
+      };
+    } catch (error) {
+      logger.error("[NatsEventPublisher] Failed to get statistics", {
+        error: error instanceof Error ? error.message : "Unknown error"
+      });
+      throw error;
+    }
+  }
+  /**
+  * Ensure a stream exists
+  */
+  async ensureStream(config) {
+    const jsm = this.connectionManager.getJetStreamManager();
+    try {
+      try {
+        await jsm.streams.info(config.name);
+        logger.debug("[NatsEventPublisher] Stream already exists", {
+          stream: config.name
+        });
+        return;
+      } catch {
+      }
+      const streamConfig = {
+        name: config.name,
+        subjects: config.subjects,
+        retention: this.mapRetentionPolicy(config.retention),
+        storage: this.mapStorageType(config.storage),
+        max_consumers: config.maxConsumers,
+        max_msgs: config.maxMsgs,
+        max_bytes: config.maxBytes,
+        max_age: config.maxAge,
+        duplicate_window: config.duplicateWindow
+      };
+      await jsm.streams.add(streamConfig);
+      logger.info("[NatsEventPublisher] Stream created successfully", {
+        stream: config.name,
+        subjects: config.subjects
+      });
+    } catch (error) {
+      logger.error("[NatsEventPublisher] Failed to ensure stream", {
+        stream: config.name,
+        error: error instanceof Error ? error.message : "Unknown error"
+      });
+      throw error;
+    }
+  }
+  /**
+  * Derive stream subject pattern from subscription subject
+  * Examples:
+  *   - "channel.conversation.message" → ["channel.>"]
+  *   - "wspace.tags.created" → ["wspace.>"]
+  *   - "global.auth.login" → ["global.>"]
+  */
+  deriveStreamSubjects(subject) {
+    const firstSegment = subject.split(".")[0];
+    if (firstSegment) {
+      return [
+        `${firstSegment}.>`
+      ];
+    }
+    return [
+      `${subject.replace(/\.[^.]+$/, ".>")}`
+    ];
+  }
+  /**
+  * Derive stream name from subject
+  * Examples:
+  *   - "channel.conversation.message" → "CHANNEL_EVENTS"
+  *   - "wspace.tags.created" → "WSPACE_EVENTS"
+  *   - "global.auth.login" → "GLOBAL_EVENTS"
+  */
+  deriveStreamName(subject) {
+    const firstSegment = subject.split(".")[0];
+    if (firstSegment) {
+      return `${firstSegment.toUpperCase()}_EVENTS`;
+    }
+    return "EVENTS";
+  }
+  /**
+  * Publish an event to a subject
+  */
+  async publish(options) {
+    const js = this.connectionManager.getJetStream();
+    try {
+      const streamName = options.options?.stream || this.deriveStreamName(options.subject);
+      const streamSubjects = options.options?.streamSubjects || this.deriveStreamSubjects(options.subject);
+      await this.ensureStream({
+        name: streamName,
+        subjects: streamSubjects,
+        retention: options.options?.retention || "limits",
+        storage: options.options?.storage || "file"
+      });
+      const message = {
+        id: options.options?.messageId || this.generateMessageId(),
+        subject: options.subject,
+        data: options.data,
+        metadata: {
+          source: options.metadata?.source || "workspaces-backend",
+          correlationId: options.metadata?.correlationId || this.generateCorrelationId(),
+          userId: options.metadata?.userId,
+          workspaceId: options.metadata?.workspaceId,
+          priority: options.options?.priority || this.config.defaultPriority || "normal",
+          ...options.metadata
+        },
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      const hdrs = headers();
+      hdrs.set("message-id", message.id);
+      hdrs.set("correlation-id", message.metadata.correlationId);
+      if (message.metadata.source) {
+        hdrs.set("source", message.metadata.source);
+      }
+      if (message.metadata["priority"] && typeof message.metadata["priority"] === "string") {
+        hdrs.set("priority", message.metadata["priority"]);
+      }
+      if (message.metadata.userId) {
+        hdrs.set("user-id", message.metadata.userId);
+      }
+      if (message.metadata.workspaceId) {
+        hdrs.set("workspace-id", message.metadata.workspaceId);
+      }
+      await injectW3CTraceContext(hdrs);
+      const publishOpts = {
+        msgID: this.config.enableDeduplication ? message.id : void 0,
+        headers: hdrs
+      };
+      if (options.options?.ttl) {
+        logger.warn("[NatsEventPublisher] Per-message TTL not supported in NATS", {
+          subject: options.subject,
+          ttl: options.options.ttl
+        });
+      }
+      if (options.options?.delay) {
+        logger.warn("[NatsEventPublisher] Message delay not supported in NATS", {
+          subject: options.subject,
+          delay: options.options.delay
+        });
+      }
+      const ack = await js.publish(options.subject, JSON.stringify(message), publishOpts);
+      this.publishCount++;
+      this.lastPublishTime = /* @__PURE__ */ new Date();
+      logger.debug("[NatsEventPublisher] Event published", {
+        subject: options.subject,
+        messageId: message.id,
+        sequence: ack.seq
+      });
+      return ack.seq;
+    } catch (error) {
+      logger.error("[NatsEventPublisher] Failed to publish event", {
+        subject: options.subject,
+        error: error instanceof Error ? error.message : "Unknown error"
+      });
+      throw error;
+    }
+  }
+  /**
+  * Publish multiple events in a batch
+  */
+  async publishBatch(events) {
+    const results = [];
+    for (const event of events) {
+      const seq = await this.publish(event);
+      results.push(seq);
+    }
+    return results;
+  }
+  /**
+  * Publish an event and wait for acknowledgment
+  * Note: This is not natively supported by NATS JetStream
+  * Would require implementing request-reply pattern
+  */
+  async publishWithAck(options) {
+    const nc = this.connectionManager.getNatsConnection();
+    try {
+      const message = {
+        id: this.generateMessageId(),
+        subject: options.subject,
+        data: options.data,
+        metadata: {
+          source: options.metadata?.source || "workspaces-backend",
+          correlationId: options.metadata?.correlationId || this.generateCorrelationId(),
+          userId: options.metadata?.userId,
+          workspaceId: options.metadata?.workspaceId,
+          ...options.metadata
+        },
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      const response = await nc.request(options.subject, JSON.stringify(message), {
+        timeout: options.timeout || 3e4
+      });
+      const result = JSON.parse(response.data.toString());
+      logger.debug("[NatsEventPublisher] Event published with ack", {
+        subject: options.subject,
+        messageId: message.id
+      });
+      return result;
+    } catch (error) {
+      logger.error("[NatsEventPublisher] Failed to publish event with ack", {
+        subject: options.subject,
+        error: error instanceof Error ? error.message : "Unknown error"
+      });
+      throw error;
+    }
+  }
+  /**
+  * Map retention policy string to NATS enum
+  */
+  mapRetentionPolicy(policy) {
+    switch (policy?.toLowerCase()) {
+      case "limits":
+        return RetentionPolicy.Limits;
+      case "interest":
+        return RetentionPolicy.Interest;
+      case "workqueue":
+      default:
+        return RetentionPolicy.Workqueue;
+    }
+  }
+  /**
+  * Map storage type string to NATS enum
+  */
+  mapStorageType(storage) {
+    switch (storage?.toLowerCase()) {
+      case "memory":
+        return StorageType.Memory;
+      case "file":
+      default:
+        return StorageType.File;
+    }
+  }
+  /**
+  * Generate unique message ID
+  */
+  generateMessageId() {
+    return `msg_${Date.now()}_${crypto.randomUUID().substring(0, 13)}`;
+  }
+  /**
+  * Generate correlation ID
+  */
+  generateCorrelationId() {
+    return `corr_${Date.now()}_${crypto.randomUUID().substring(0, 13)}`;
+  }
+};
+
+// src/event-queue/factory/EventQueueFactory.ts
+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.NATS) {
+      return new NatsEventPublisher(config);
+    }
+    throw new Error(`Unsupported queue type: ${config.type}`);
+  }
+  /**
+  * 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.NATS) {
+      return new NatsEventConsumer(config);
+    }
+    throw new Error(`Unsupported queue type: ${config.type}`);
+  }
+  /**
+  * Create a publisher from environment variables
+  */
+  static createPublisherFromEnv() {
+    const config = {
+      type: process.env["QUEUE_TYPE"] || QueueType.NATS,
+      url: process.env["NATS_URL"] || "nats://localhost:4222",
+      user: process.env["NATS_USER"],
+      password: process.env["NATS_PASSWORD"],
+      token: process.env["NATS_TOKEN"],
+      name: process.env["QUEUE_CLIENT_NAME"] || "workspaces-backend-publisher",
+      maxReconnectAttempts: process.env["NATS_MAX_RECONNECT_ATTEMPTS"] ? parseInt(process.env["NATS_MAX_RECONNECT_ATTEMPTS"], 10) : -1,
+      reconnectTimeWait: process.env["NATS_RECONNECT_TIME_WAIT"] ? parseInt(process.env["NATS_RECONNECT_TIME_WAIT"], 10) : 2e3,
+      enableDeduplication: process.env["QUEUE_ENABLE_DEDUPLICATION"] === "true",
+      defaultPriority: process.env["QUEUE_DEFAULT_PRIORITY"] || "normal",
+      defaultTTL: process.env["QUEUE_DEFAULT_TTL"] ? parseInt(process.env["QUEUE_DEFAULT_TTL"], 10) : void 0
+    };
+    return _EventQueueFactory.createPublisher(config);
+  }
+  /**
+  * Create a consumer from environment variables
+  */
+  static createConsumerFromEnv(stream, consumer) {
+    const config = {
+      type: process.env["QUEUE_TYPE"] || QueueType.NATS,
+      url: process.env["NATS_URL"] || "nats://localhost:4222",
+      user: process.env["NATS_USER"],
+      password: process.env["NATS_PASSWORD"],
+      token: process.env["NATS_TOKEN"],
+      name: process.env["QUEUE_CLIENT_NAME"] || "workspaces-workers-consumer",
+      maxReconnectAttempts: process.env["NATS_MAX_RECONNECT_ATTEMPTS"] ? parseInt(process.env["NATS_MAX_RECONNECT_ATTEMPTS"], 10) : -1,
+      reconnectTimeWait: process.env["NATS_RECONNECT_TIME_WAIT"] ? parseInt(process.env["NATS_RECONNECT_TIME_WAIT"], 10) : 2e3,
+      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
+    };
+    return _EventQueueFactory.createConsumer(config);
+  }
+  // ========================================================================
+  // Layer-Aware Factory Methods
+  // ========================================================================
+  /**
+  * Create a publisher for a specific layer
+  *
+  * @param layer - Service layer ('wspace' or 'global')
+  * @param serviceName - Service name for identification
+  * @returns Publisher configured for the layer
+  *
+  * @example
+  * ```typescript
+  * const publisher = EventQueueFactory.createPublisherForLayer('wspace', 'wspace-tags-svc');
+  * await publisher.connect();
+  * await publisher.publish({ subject: 'wspace.tags.created', data: { id: '123' } });
+  * ```
+  */
+  static createPublisherForLayer(layer, serviceName) {
+    const envPrefix = layer.toUpperCase();
+    const defaults = DEFAULT_LAYER_RESOURCES[layer];
+    const config = {
+      type: QueueType.NATS,
+      url: process.env[`${envPrefix}_NATS_URL`] || process.env["NATS_URL"] || defaults.natsUrl,
+      user: process.env["NATS_USER"],
+      password: process.env["NATS_PASSWORD"],
+      token: process.env["NATS_TOKEN"],
+      name: serviceName,
+      maxReconnectAttempts: process.env["NATS_MAX_RECONNECT_ATTEMPTS"] ? parseInt(process.env["NATS_MAX_RECONNECT_ATTEMPTS"], 10) : -1,
+      reconnectTimeWait: process.env["NATS_RECONNECT_TIME_WAIT"] ? parseInt(process.env["NATS_RECONNECT_TIME_WAIT"], 10) : 2e3,
+      enableDeduplication: process.env["QUEUE_ENABLE_DEDUPLICATION"] === "true",
+      defaultPriority: process.env["QUEUE_DEFAULT_PRIORITY"] || "normal",
+      defaultTTL: process.env["QUEUE_DEFAULT_TTL"] ? parseInt(process.env["QUEUE_DEFAULT_TTL"], 10) : void 0
+    };
+    logger.info("[EventQueueFactory] Creating layer publisher", {
+      layer,
+      serviceName,
+      url: config.url
+    });
+    return _EventQueueFactory.createPublisher(config);
+  }
+  /**
+  * Create a consumer for a specific layer
+  *
+  * @param layer - Service layer ('wspace' or 'global')
+  * @param serviceName - Service name for identification
+  * @param stream - NATS stream name
+  * @param consumer - Consumer name
+  * @returns Consumer configured for the layer
+  *
+  * @example
+  * ```typescript
+  * const consumer = EventQueueFactory.createConsumerForLayer(
+  *   'wspace', 'wspace-tags-svc', 'WSPACE_EVENTS', 'tags-consumer'
+  * );
+  * await consumer.connect();
+  * await consumer.consume(async (msg) => { console.log(msg); });
+  * ```
+  */
+  static createConsumerForLayer(layer, serviceName, stream, consumer) {
+    const envPrefix = layer.toUpperCase();
+    const defaults = DEFAULT_LAYER_RESOURCES[layer];
+    const config = {
+      type: QueueType.NATS,
+      url: process.env[`${envPrefix}_NATS_URL`] || process.env["NATS_URL"] || defaults.natsUrl,
+      user: process.env["NATS_USER"],
+      password: process.env["NATS_PASSWORD"],
+      token: process.env["NATS_TOKEN"],
+      name: serviceName,
+      maxReconnectAttempts: process.env["NATS_MAX_RECONNECT_ATTEMPTS"] ? parseInt(process.env["NATS_MAX_RECONNECT_ATTEMPTS"], 10) : -1,
+      reconnectTimeWait: process.env["NATS_RECONNECT_TIME_WAIT"] ? parseInt(process.env["NATS_RECONNECT_TIME_WAIT"], 10) : 2e3,
+      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
+    };
+    logger.info("[EventQueueFactory] Creating layer consumer", {
+      layer,
+      serviceName,
+      stream,
+      consumer,
+      url: config.url
+    });
+    return _EventQueueFactory.createConsumer(config);
+  }
+};
+
+export { EventQueueFactory, NatsEventConsumer, NatsEventPublisher };
+//# sourceMappingURL=chunk-3O2RQOPV.js.map
+//# sourceMappingURL=chunk-3O2RQOPV.js.map