@saga-bus/transport-nats 0.1.2

package/README.md

@@ -0,0 +1,258 @@
+# @saga-bus/transport-nats
+
+NATS JetStream transport for saga-bus.
+
+## Installation
+
+```bash
+npm install @saga-bus/transport-nats nats
+# or
+pnpm add @saga-bus/transport-nats nats
+```
+
+## Features
+
+- **JetStream**: Persistent message storage with replay capability
+- **Durable Consumers**: Reliable delivery with acknowledgment tracking
+- **Work Queues**: Competing consumer pattern for load distribution
+- **Low Latency**: High-performance messaging
+- **Horizontal Scaling**: Native clustering support
+
+## Quick Start
+
+```typescript
+import { createBus } from "@saga-bus/core";
+import { NatsTransport } from "@saga-bus/transport-nats";
+
+const transport = new NatsTransport({
+  connectionOptions: { servers: "localhost:4222" },
+  streamName: "SAGA_EVENTS",
+});
+
+const bus = createBus({
+  transport,
+  // ... other config
+});
+
+await bus.start();
+```
+
+## Configuration
+
+```typescript
+interface NatsTransportOptions {
+  /** Existing NATS connection */
+  connection?: NatsConnection;
+
+  /** Connection options for creating new connection */
+  connectionOptions?: ConnectionOptions;
+
+  /** JetStream options */
+  jetStreamOptions?: JetStreamOptions;
+
+  /** Subject prefix for all messages (default: "saga-bus") */
+  subjectPrefix?: string;
+
+  /** Stream name for JetStream (default: "SAGA_BUS") */
+  streamName?: string;
+
+  /** Consumer name prefix (default: "saga-bus-consumer") */
+  consumerPrefix?: string;
+
+  /** Whether to auto-create streams (default: true) */
+  autoCreateStream?: boolean;
+
+  /** Stream retention policy (default: "workqueue") */
+  retentionPolicy?: "limits" | "interest" | "workqueue";
+
+  /** Max messages in stream (-1 for unlimited) */
+  maxMessages?: number;
+
+  /** Max bytes in stream (-1 for unlimited) */
+  maxBytes?: number;
+
+  /** Max age of messages in nanoseconds */
+  maxAge?: number;
+
+  /** Number of replicas (default: 1) */
+  replicas?: number;
+
+  /** Ack wait timeout in nanoseconds (default: 30s) */
+  ackWait?: number;
+
+  /** Max redelivery attempts (default: 5) */
+  maxDeliver?: number;
+}
+```
+
+## Examples
+
+### Basic Usage
+
+```typescript
+import { NatsTransport } from "@saga-bus/transport-nats";
+
+const transport = new NatsTransport({
+  connectionOptions: { servers: "localhost:4222" },
+});
+
+await transport.start();
+
+// Publish a message
+await transport.publish(
+  { type: "OrderCreated", orderId: "123" },
+  { endpoint: "orders" }
+);
+
+// Subscribe to messages
+await transport.subscribe(
+  { endpoint: "orders", group: "order-processor" },
+  async (envelope) => {
+    console.log("Received:", envelope.payload);
+  }
+);
+```
+
+### With Existing Connection
+
+```typescript
+import { connect } from "nats";
+
+const nc = await connect({
+  servers: ["nats://server1:4222", "nats://server2:4222"],
+  token: "my-secret-token",
+});
+
+const transport = new NatsTransport({
+  connection: nc,
+  streamName: "MY_STREAM",
+});
+```
+
+### Custom Stream Configuration
+
+```typescript
+const transport = new NatsTransport({
+  connectionOptions: { servers: "localhost:4222" },
+  streamName: "ORDERS_STREAM",
+  retentionPolicy: "limits",
+  maxMessages: 100000,
+  maxBytes: 100 * 1024 * 1024, // 100MB
+  maxAge: 24 * 60 * 60 * 1000000000, // 24 hours in nanoseconds
+  replicas: 3,
+});
+```
+
+### Multiple Consumer Groups
+
+```typescript
+// Worker pool 1
+await transport.subscribe(
+  { endpoint: "orders", group: "order-validators" },
+  async (envelope) => {
+    await validateOrder(envelope.payload);
+  }
+);
+
+// Worker pool 2
+await transport.subscribe(
+  { endpoint: "orders", group: "order-emailers" },
+  async (envelope) => {
+    await sendOrderEmail(envelope.payload);
+  }
+);
+```
+
+## Subject Hierarchy
+
+Messages are published to subjects following this pattern:
+
+```
+{subjectPrefix}.{endpoint}.{messageType}
+```
+
+Examples:
+- `saga-bus.orders.OrderCreated`
+- `saga-bus.payments.PaymentReceived`
+- `myapp.inventory.StockUpdated`
+
+Consumers subscribe to patterns using `>` wildcard:
+- `saga-bus.orders.>` - All order messages
+- `saga-bus.>` - All messages
+
+## Retention Policies
+
+| Policy | Description | Use Case |
+|--------|-------------|----------|
+| `limits` | Messages kept until limits reached | Event sourcing, audit logs |
+| `interest` | Messages kept while consumers interested | Standard pub/sub |
+| `workqueue` | Messages removed after acknowledgment | Task queues, job processing |
+
+## Message Format
+
+Messages are published as JSON:
+
+```json
+{
+  "id": "msg-uuid",
+  "type": "OrderCreated",
+  "payload": { "type": "OrderCreated", "orderId": "123" },
+  "headers": {},
+  "timestamp": "2024-01-01T00:00:00.000Z",
+  "partitionKey": "order-123"
+}
+```
+
+With NATS headers:
+- `Nats-Msg-Id`: Unique message ID
+- `X-Message-Type`: Message type
+- `X-Correlation-Id`: Correlation/partition key
+
+## Limitations
+
+### No Delayed Messages
+
+NATS JetStream does not support native delayed message delivery. Attempting to publish with `delayMs` will throw an error:
+
+```typescript
+// This will throw an error
+await transport.publish(message, { delayMs: 5000 });
+// Error: NATS JetStream does not support delayed messages.
+//        Use an external scheduler for delayed delivery.
+```
+
+**Alternatives:**
+- Use Redis sorted sets for scheduling
+- Implement delay in application logic
+- Use a separate scheduler service
+
+## Error Handling
+
+Messages that fail processing are automatically retried up to `maxDeliver` times:
+
+```typescript
+const transport = new NatsTransport({
+  connectionOptions: { servers: "localhost:4222" },
+  maxDeliver: 10, // Retry up to 10 times
+  ackWait: 60_000_000_000, // 60 second ack timeout
+});
+```
+
+## Testing
+
+For testing, you can run NATS locally:
+
+```bash
+# Run NATS with JetStream enabled
+docker run -p 4222:4222 nats:latest -js
+```
+
+Or use the NATS CLI:
+
+```bash
+nats-server -js
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,189 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  NatsTransport: () => NatsTransport
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/NatsTransport.ts
+var import_nats = require("nats");
+var import_crypto = require("crypto");
+var sc = (0, import_nats.StringCodec)();
+var NatsTransport = class {
+  nc = null;
+  jsm = null;
+  js = null;
+  options;
+  consumers = [];
+  started = false;
+  constructor(options) {
+    if (!options.connection && !options.connectionOptions) {
+      throw new Error(
+        "Either connection or connectionOptions must be provided"
+      );
+    }
+    this.options = {
+      subjectPrefix: "saga-bus",
+      streamName: "SAGA_BUS",
+      consumerPrefix: "saga-bus-consumer",
+      autoCreateStream: true,
+      retentionPolicy: "workqueue",
+      maxMessages: -1,
+      maxBytes: -1,
+      replicas: 1,
+      ackWait: 3e10,
+      // 30 seconds in nanoseconds
+      maxDeliver: 5,
+      ...options
+    };
+  }
+  async start() {
+    if (this.started) return;
+    if (this.options.connection) {
+      this.nc = this.options.connection;
+    } else {
+      this.nc = await (0, import_nats.connect)(this.options.connectionOptions);
+    }
+    this.jsm = await this.nc.jetstreamManager(this.options.jetStreamOptions);
+    this.js = this.nc.jetstream(this.options.jetStreamOptions);
+    if (this.options.autoCreateStream) {
+      await this.ensureStream();
+    }
+    this.started = true;
+  }
+  async stop() {
+    if (!this.started) return;
+    for (const consumer of this.consumers) {
+      consumer.stop();
+    }
+    this.consumers.length = 0;
+    if (!this.options.connection && this.nc) {
+      await this.nc.drain();
+    }
+    this.nc = null;
+    this.jsm = null;
+    this.js = null;
+    this.started = false;
+  }
+  async subscribe(options, handler) {
+    if (!this.js || !this.jsm) throw new Error("Transport not started");
+    const { endpoint, group } = options;
+    const subject = `${this.options.subjectPrefix}.${endpoint}.>`;
+    const consumerName = group ?? `${this.options.consumerPrefix}-${endpoint}`;
+    const consumerConfig = {
+      durable_name: consumerName,
+      filter_subject: subject,
+      ack_policy: import_nats.AckPolicy.Explicit,
+      deliver_policy: import_nats.DeliverPolicy.All,
+      ack_wait: this.options.ackWait,
+      max_deliver: this.options.maxDeliver
+    };
+    await this.jsm.consumers.add(this.options.streamName, consumerConfig);
+    const consumer = await this.js.consumers.get(
+      this.options.streamName,
+      consumerName
+    );
+    const messages = await consumer.consume();
+    (async () => {
+      for await (const msg of messages) {
+        try {
+          const rawEnvelope = JSON.parse(sc.decode(msg.data));
+          const envelope = {
+            id: rawEnvelope.id,
+            type: rawEnvelope.type,
+            payload: rawEnvelope.payload,
+            headers: rawEnvelope.headers,
+            timestamp: new Date(rawEnvelope.timestamp),
+            partitionKey: rawEnvelope.partitionKey
+          };
+          await handler(envelope);
+          msg.ack();
+        } catch (error) {
+          console.error("[NatsTransport] Message handler error:", error);
+          msg.nak();
+        }
+      }
+    })();
+    this.consumers.push({ stop: () => messages.stop() });
+  }
+  async publish(message, options) {
+    if (!this.js) throw new Error("Transport not started");
+    const { endpoint, key, headers: customHeaders = {}, delayMs } = options;
+    if (delayMs && delayMs > 0) {
+      throw new Error(
+        "NATS JetStream does not support delayed messages. Use an external scheduler for delayed delivery."
+      );
+    }
+    const subject = `${this.options.subjectPrefix}.${endpoint}.${message.type}`;
+    const envelope = {
+      id: (0, import_crypto.randomUUID)(),
+      type: message.type,
+      payload: message,
+      headers: customHeaders,
+      timestamp: /* @__PURE__ */ new Date(),
+      partitionKey: key
+    };
+    const h = (0, import_nats.headers)();
+    h.set("Nats-Msg-Id", envelope.id);
+    h.set("X-Message-Type", message.type);
+    if (key) h.set("X-Correlation-Id", key);
+    for (const [k, v] of Object.entries(customHeaders)) {
+      if (typeof v === "string") {
+        h.set(k, v);
+      }
+    }
+    const publishOptions = {
+      msgID: envelope.id,
+      headers: h
+    };
+    await this.js.publish(
+      subject,
+      sc.encode(JSON.stringify(envelope)),
+      publishOptions
+    );
+  }
+  async ensureStream() {
+    if (!this.jsm) return;
+    try {
+      await this.jsm.streams.info(this.options.streamName);
+    } catch {
+      const retentionMap = {
+        limits: import_nats.RetentionPolicy.Limits,
+        interest: import_nats.RetentionPolicy.Interest,
+        workqueue: import_nats.RetentionPolicy.Workqueue
+      };
+      await this.jsm.streams.add({
+        name: this.options.streamName,
+        subjects: [`${this.options.subjectPrefix}.>`],
+        retention: retentionMap[this.options.retentionPolicy],
+        max_msgs: this.options.maxMessages,
+        max_bytes: this.options.maxBytes,
+        num_replicas: this.options.replicas
+      });
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  NatsTransport
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/NatsTransport.ts"],"sourcesContent":["export { NatsTransport } from \"./NatsTransport.js\";\nexport type { NatsTransportOptions } from \"./types.js\";\n","import {\n  connect,\n  NatsConnection,\n  JetStreamManager,\n  JetStreamClient,\n  JetStreamPublishOptions,\n  ConsumerConfig,\n  AckPolicy,\n  DeliverPolicy,\n  StringCodec,\n  headers,\n  RetentionPolicy,\n} from \"nats\";\nimport type {\n  Transport,\n  TransportSubscribeOptions,\n  TransportPublishOptions,\n  MessageEnvelope,\n  BaseMessage,\n} from \"@saga-bus/core\";\nimport type { NatsTransportOptions } from \"./types.js\";\nimport { randomUUID } from \"crypto\";\n\nconst sc = StringCodec();\n\n/**\n * NATS JetStream transport for saga-bus.\n *\n * @example\n * ```typescript\n * import { NatsTransport } from \"@saga-bus/transport-nats\";\n *\n * const transport = new NatsTransport({\n *   connectionOptions: { servers: \"localhost:4222\" },\n *   streamName: \"SAGA_EVENTS\",\n * });\n *\n * await transport.start();\n * ```\n */\nexport class NatsTransport implements Transport {\n  private nc: NatsConnection | null = null;\n  private jsm: JetStreamManager | null = null;\n  private js: JetStreamClient | null = null;\n  private readonly options: Required<\n    Pick<\n      NatsTransportOptions,\n      | \"subjectPrefix\"\n      | \"streamName\"\n      | \"consumerPrefix\"\n      | \"autoCreateStream\"\n      | \"retentionPolicy\"\n      | \"maxMessages\"\n      | \"maxBytes\"\n      | \"replicas\"\n      | \"ackWait\"\n      | \"maxDeliver\"\n    >\n  > &\n    NatsTransportOptions;\n\n  private readonly consumers: Array<{ stop: () => void }> = [];\n  private started = false;\n\n  constructor(options: NatsTransportOptions) {\n    if (!options.connection && !options.connectionOptions) {\n      throw new Error(\n        \"Either connection or connectionOptions must be provided\"\n      );\n    }\n\n    this.options = {\n      subjectPrefix: \"saga-bus\",\n      streamName: \"SAGA_BUS\",\n      consumerPrefix: \"saga-bus-consumer\",\n      autoCreateStream: true,\n      retentionPolicy: \"workqueue\",\n      maxMessages: -1,\n      maxBytes: -1,\n      replicas: 1,\n      ackWait: 30_000_000_000, // 30 seconds in nanoseconds\n      maxDeliver: 5,\n      ...options,\n    };\n  }\n\n  async start(): Promise<void> {\n    if (this.started) return;\n\n    // Connect\n    if (this.options.connection) {\n      this.nc = this.options.connection;\n    } else {\n      this.nc = await connect(this.options.connectionOptions);\n    }\n\n    // Get JetStream manager and client\n    this.jsm = await this.nc.jetstreamManager(this.options.jetStreamOptions);\n    this.js = this.nc.jetstream(this.options.jetStreamOptions);\n\n    // Create stream if needed\n    if (this.options.autoCreateStream) {\n      await this.ensureStream();\n    }\n\n    this.started = true;\n  }\n\n  async stop(): Promise<void> {\n    if (!this.started) return;\n\n    // Stop all consumers\n    for (const consumer of this.consumers) {\n      consumer.stop();\n    }\n    this.consumers.length = 0;\n\n    // Close connection if we created it\n    if (!this.options.connection && this.nc) {\n      await this.nc.drain();\n    }\n\n    this.nc = null;\n    this.jsm = null;\n    this.js = null;\n    this.started = false;\n  }\n\n  async subscribe<TMessage extends BaseMessage>(\n    options: TransportSubscribeOptions,\n    handler: (envelope: MessageEnvelope<TMessage>) => Promise<void>\n  ): Promise<void> {\n    if (!this.js || !this.jsm) throw new Error(\"Transport not started\");\n\n    const { endpoint, group } = options;\n    const subject = `${this.options.subjectPrefix}.${endpoint}.>`;\n    const consumerName = group ?? `${this.options.consumerPrefix}-${endpoint}`;\n\n    // Create durable consumer\n    const consumerConfig: Partial<ConsumerConfig> = {\n      durable_name: consumerName,\n      filter_subject: subject,\n      ack_policy: AckPolicy.Explicit,\n      deliver_policy: DeliverPolicy.All,\n      ack_wait: this.options.ackWait,\n      max_deliver: this.options.maxDeliver,\n    };\n\n    await this.jsm.consumers.add(this.options.streamName, consumerConfig);\n\n    // Subscribe\n    const consumer = await this.js.consumers.get(\n      this.options.streamName,\n      consumerName\n    );\n    const messages = await consumer.consume();\n\n    // Process messages asynchronously\n    (async () => {\n      for await (const msg of messages) {\n        try {\n          const rawEnvelope = JSON.parse(sc.decode(msg.data));\n          const envelope: MessageEnvelope<TMessage> = {\n            id: rawEnvelope.id,\n            type: rawEnvelope.type,\n            payload: rawEnvelope.payload as TMessage,\n            headers: rawEnvelope.headers,\n            timestamp: new Date(rawEnvelope.timestamp),\n            partitionKey: rawEnvelope.partitionKey,\n          };\n          await handler(envelope);\n          msg.ack();\n        } catch (error) {\n          console.error(\"[NatsTransport] Message handler error:\", error);\n          msg.nak();\n        }\n      }\n    })();\n\n    this.consumers.push({ stop: () => messages.stop() });\n  }\n\n  async publish<TMessage extends BaseMessage>(\n    message: TMessage,\n    options: TransportPublishOptions\n  ): Promise<void> {\n    if (!this.js) throw new Error(\"Transport not started\");\n\n    const { endpoint, key, headers: customHeaders = {}, delayMs } = options;\n\n    // NATS JetStream doesn't support delayed messages natively\n    if (delayMs && delayMs > 0) {\n      throw new Error(\n        \"NATS JetStream does not support delayed messages. \" +\n          \"Use an external scheduler for delayed delivery.\"\n      );\n    }\n\n    const subject = `${this.options.subjectPrefix}.${endpoint}.${message.type}`;\n\n    // Create envelope\n    const envelope: MessageEnvelope<TMessage> = {\n      id: randomUUID(),\n      type: message.type,\n      payload: message,\n      headers: customHeaders as Record<string, string>,\n      timestamp: new Date(),\n      partitionKey: key,\n    };\n\n    // Build headers\n    const h = headers();\n    h.set(\"Nats-Msg-Id\", envelope.id);\n    h.set(\"X-Message-Type\", message.type);\n    if (key) h.set(\"X-Correlation-Id\", key);\n    for (const [k, v] of Object.entries(customHeaders)) {\n      if (typeof v === \"string\") {\n        h.set(k, v);\n      }\n    }\n\n    // Publish\n    const publishOptions: Partial<JetStreamPublishOptions> = {\n      msgID: envelope.id,\n      headers: h,\n    };\n\n    await this.js.publish(\n      subject,\n      sc.encode(JSON.stringify(envelope)),\n      publishOptions\n    );\n  }\n\n  private async ensureStream(): Promise<void> {\n    if (!this.jsm) return;\n\n    try {\n      await this.jsm.streams.info(this.options.streamName);\n    } catch {\n      // Stream doesn't exist, create it\n      const retentionMap: Record<string, RetentionPolicy> = {\n        limits: RetentionPolicy.Limits,\n        interest: RetentionPolicy.Interest,\n        workqueue: RetentionPolicy.Workqueue,\n      };\n\n      await this.jsm.streams.add({\n        name: this.options.streamName,\n        subjects: [`${this.options.subjectPrefix}.>`],\n        retention: retentionMap[this.options.retentionPolicy],\n        max_msgs: this.options.maxMessages,\n        max_bytes: this.options.maxBytes,\n        num_replicas: this.options.replicas,\n      });\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,68 @@
+import { Transport, BaseMessage, TransportSubscribeOptions, MessageEnvelope, TransportPublishOptions } from '@saga-bus/core';
+import { NatsConnection, ConnectionOptions, JetStreamOptions } from 'nats';
+
+/**
+ * Configuration options for the NATS JetStream transport.
+ */
+interface NatsTransportOptions {
+    /** Existing NATS connection */
+    connection?: NatsConnection;
+    /** Connection options for creating new connection */
+    connectionOptions?: ConnectionOptions;
+    /** JetStream options */
+    jetStreamOptions?: JetStreamOptions;
+    /** Subject prefix for all messages (default: "saga-bus") */
+    subjectPrefix?: string;
+    /** Stream name for JetStream (default: "SAGA_BUS") */
+    streamName?: string;
+    /** Consumer name prefix (default: "saga-bus-consumer") */
+    consumerPrefix?: string;
+    /** Whether to auto-create streams (default: true) */
+    autoCreateStream?: boolean;
+    /** Stream retention policy (default: "workqueue") */
+    retentionPolicy?: "limits" | "interest" | "workqueue";
+    /** Max messages in stream (-1 for unlimited, default: -1) */
+    maxMessages?: number;
+    /** Max bytes in stream (-1 for unlimited, default: -1) */
+    maxBytes?: number;
+    /** Max age of messages in nanoseconds */
+    maxAge?: number;
+    /** Number of replicas (default: 1) */
+    replicas?: number;
+    /** Ack wait timeout in nanoseconds (default: 30_000_000_000 = 30s) */
+    ackWait?: number;
+    /** Max redelivery attempts (default: 5) */
+    maxDeliver?: number;
+}
+
+/**
+ * NATS JetStream transport for saga-bus.
+ *
+ * @example
+ * ```typescript
+ * import { NatsTransport } from "@saga-bus/transport-nats";
+ *
+ * const transport = new NatsTransport({
+ *   connectionOptions: { servers: "localhost:4222" },
+ *   streamName: "SAGA_EVENTS",
+ * });
+ *
+ * await transport.start();
+ * ```
+ */
+declare class NatsTransport implements Transport {
+    private nc;
+    private jsm;
+    private js;
+    private readonly options;
+    private readonly consumers;
+    private started;
+    constructor(options: NatsTransportOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    subscribe<TMessage extends BaseMessage>(options: TransportSubscribeOptions, handler: (envelope: MessageEnvelope<TMessage>) => Promise<void>): Promise<void>;
+    publish<TMessage extends BaseMessage>(message: TMessage, options: TransportPublishOptions): Promise<void>;
+    private ensureStream;
+}
+
+export { NatsTransport, type NatsTransportOptions };

package/dist/index.d.ts

@@ -0,0 +1,68 @@
+import { Transport, BaseMessage, TransportSubscribeOptions, MessageEnvelope, TransportPublishOptions } from '@saga-bus/core';
+import { NatsConnection, ConnectionOptions, JetStreamOptions } from 'nats';
+
+/**
+ * Configuration options for the NATS JetStream transport.
+ */
+interface NatsTransportOptions {
+    /** Existing NATS connection */
+    connection?: NatsConnection;
+    /** Connection options for creating new connection */
+    connectionOptions?: ConnectionOptions;
+    /** JetStream options */
+    jetStreamOptions?: JetStreamOptions;
+    /** Subject prefix for all messages (default: "saga-bus") */
+    subjectPrefix?: string;
+    /** Stream name for JetStream (default: "SAGA_BUS") */
+    streamName?: string;
+    /** Consumer name prefix (default: "saga-bus-consumer") */
+    consumerPrefix?: string;
+    /** Whether to auto-create streams (default: true) */
+    autoCreateStream?: boolean;
+    /** Stream retention policy (default: "workqueue") */
+    retentionPolicy?: "limits" | "interest" | "workqueue";
+    /** Max messages in stream (-1 for unlimited, default: -1) */
+    maxMessages?: number;
+    /** Max bytes in stream (-1 for unlimited, default: -1) */
+    maxBytes?: number;
+    /** Max age of messages in nanoseconds */
+    maxAge?: number;
+    /** Number of replicas (default: 1) */
+    replicas?: number;
+    /** Ack wait timeout in nanoseconds (default: 30_000_000_000 = 30s) */
+    ackWait?: number;
+    /** Max redelivery attempts (default: 5) */
+    maxDeliver?: number;
+}
+
+/**
+ * NATS JetStream transport for saga-bus.
+ *
+ * @example
+ * ```typescript
+ * import { NatsTransport } from "@saga-bus/transport-nats";
+ *
+ * const transport = new NatsTransport({
+ *   connectionOptions: { servers: "localhost:4222" },
+ *   streamName: "SAGA_EVENTS",
+ * });
+ *
+ * await transport.start();
+ * ```
+ */
+declare class NatsTransport implements Transport {
+    private nc;
+    private jsm;
+    private js;
+    private readonly options;
+    private readonly consumers;
+    private started;
+    constructor(options: NatsTransportOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    subscribe<TMessage extends BaseMessage>(options: TransportSubscribeOptions, handler: (envelope: MessageEnvelope<TMessage>) => Promise<void>): Promise<void>;
+    publish<TMessage extends BaseMessage>(message: TMessage, options: TransportPublishOptions): Promise<void>;
+    private ensureStream;
+}
+
+export { NatsTransport, type NatsTransportOptions };

package/dist/index.js

@@ -0,0 +1,169 @@
+// src/NatsTransport.ts
+import {
+  connect,
+  AckPolicy,
+  DeliverPolicy,
+  StringCodec,
+  headers,
+  RetentionPolicy
+} from "nats";
+import { randomUUID } from "crypto";
+var sc = StringCodec();
+var NatsTransport = class {
+  nc = null;
+  jsm = null;
+  js = null;
+  options;
+  consumers = [];
+  started = false;
+  constructor(options) {
+    if (!options.connection && !options.connectionOptions) {
+      throw new Error(
+        "Either connection or connectionOptions must be provided"
+      );
+    }
+    this.options = {
+      subjectPrefix: "saga-bus",
+      streamName: "SAGA_BUS",
+      consumerPrefix: "saga-bus-consumer",
+      autoCreateStream: true,
+      retentionPolicy: "workqueue",
+      maxMessages: -1,
+      maxBytes: -1,
+      replicas: 1,
+      ackWait: 3e10,
+      // 30 seconds in nanoseconds
+      maxDeliver: 5,
+      ...options
+    };
+  }
+  async start() {
+    if (this.started) return;
+    if (this.options.connection) {
+      this.nc = this.options.connection;
+    } else {
+      this.nc = await connect(this.options.connectionOptions);
+    }
+    this.jsm = await this.nc.jetstreamManager(this.options.jetStreamOptions);
+    this.js = this.nc.jetstream(this.options.jetStreamOptions);
+    if (this.options.autoCreateStream) {
+      await this.ensureStream();
+    }
+    this.started = true;
+  }
+  async stop() {
+    if (!this.started) return;
+    for (const consumer of this.consumers) {
+      consumer.stop();
+    }
+    this.consumers.length = 0;
+    if (!this.options.connection && this.nc) {
+      await this.nc.drain();
+    }
+    this.nc = null;
+    this.jsm = null;
+    this.js = null;
+    this.started = false;
+  }
+  async subscribe(options, handler) {
+    if (!this.js || !this.jsm) throw new Error("Transport not started");
+    const { endpoint, group } = options;
+    const subject = `${this.options.subjectPrefix}.${endpoint}.>`;
+    const consumerName = group ?? `${this.options.consumerPrefix}-${endpoint}`;
+    const consumerConfig = {
+      durable_name: consumerName,
+      filter_subject: subject,
+      ack_policy: AckPolicy.Explicit,
+      deliver_policy: DeliverPolicy.All,
+      ack_wait: this.options.ackWait,
+      max_deliver: this.options.maxDeliver
+    };
+    await this.jsm.consumers.add(this.options.streamName, consumerConfig);
+    const consumer = await this.js.consumers.get(
+      this.options.streamName,
+      consumerName
+    );
+    const messages = await consumer.consume();
+    (async () => {
+      for await (const msg of messages) {
+        try {
+          const rawEnvelope = JSON.parse(sc.decode(msg.data));
+          const envelope = {
+            id: rawEnvelope.id,
+            type: rawEnvelope.type,
+            payload: rawEnvelope.payload,
+            headers: rawEnvelope.headers,
+            timestamp: new Date(rawEnvelope.timestamp),
+            partitionKey: rawEnvelope.partitionKey
+          };
+          await handler(envelope);
+          msg.ack();
+        } catch (error) {
+          console.error("[NatsTransport] Message handler error:", error);
+          msg.nak();
+        }
+      }
+    })();
+    this.consumers.push({ stop: () => messages.stop() });
+  }
+  async publish(message, options) {
+    if (!this.js) throw new Error("Transport not started");
+    const { endpoint, key, headers: customHeaders = {}, delayMs } = options;
+    if (delayMs && delayMs > 0) {
+      throw new Error(
+        "NATS JetStream does not support delayed messages. Use an external scheduler for delayed delivery."
+      );
+    }
+    const subject = `${this.options.subjectPrefix}.${endpoint}.${message.type}`;
+    const envelope = {
+      id: randomUUID(),
+      type: message.type,
+      payload: message,
+      headers: customHeaders,
+      timestamp: /* @__PURE__ */ new Date(),
+      partitionKey: key
+    };
+    const h = headers();
+    h.set("Nats-Msg-Id", envelope.id);
+    h.set("X-Message-Type", message.type);
+    if (key) h.set("X-Correlation-Id", key);
+    for (const [k, v] of Object.entries(customHeaders)) {
+      if (typeof v === "string") {
+        h.set(k, v);
+      }
+    }
+    const publishOptions = {
+      msgID: envelope.id,
+      headers: h
+    };
+    await this.js.publish(
+      subject,
+      sc.encode(JSON.stringify(envelope)),
+      publishOptions
+    );
+  }
+  async ensureStream() {
+    if (!this.jsm) return;
+    try {
+      await this.jsm.streams.info(this.options.streamName);
+    } catch {
+      const retentionMap = {
+        limits: RetentionPolicy.Limits,
+        interest: RetentionPolicy.Interest,
+        workqueue: RetentionPolicy.Workqueue
+      };
+      await this.jsm.streams.add({
+        name: this.options.streamName,
+        subjects: [`${this.options.subjectPrefix}.>`],
+        retention: retentionMap[this.options.retentionPolicy],
+        max_msgs: this.options.maxMessages,
+        max_bytes: this.options.maxBytes,
+        num_replicas: this.options.replicas
+      });
+    }
+  }
+};
+export {
+  NatsTransport
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/NatsTransport.ts"],"sourcesContent":["import {\n  connect,\n  NatsConnection,\n  JetStreamManager,\n  JetStreamClient,\n  JetStreamPublishOptions,\n  ConsumerConfig,\n  AckPolicy,\n  DeliverPolicy,\n  StringCodec,\n  headers,\n  RetentionPolicy,\n} from \"nats\";\nimport type {\n  Transport,\n  TransportSubscribeOptions,\n  TransportPublishOptions,\n  MessageEnvelope,\n  BaseMessage,\n} from \"@saga-bus/core\";\nimport type { NatsTransportOptions } from \"./types.js\";\nimport { randomUUID } from \"crypto\";\n\nconst sc = StringCodec();\n\n/**\n * NATS JetStream transport for saga-bus.\n *\n * @example\n * ```typescript\n * import { NatsTransport } from \"@saga-bus/transport-nats\";\n *\n * const transport = new NatsTransport({\n *   connectionOptions: { servers: \"localhost:4222\" },\n *   streamName: \"SAGA_EVENTS\",\n * });\n *\n * await transport.start();\n * ```\n */\nexport class NatsTransport implements Transport {\n  private nc: NatsConnection | null = null;\n  private jsm: JetStreamManager | null = null;\n  private js: JetStreamClient | null = null;\n  private readonly options: Required<\n    Pick<\n      NatsTransportOptions,\n      | \"subjectPrefix\"\n      | \"streamName\"\n      | \"consumerPrefix\"\n      | \"autoCreateStream\"\n      | \"retentionPolicy\"\n      | \"maxMessages\"\n      | \"maxBytes\"\n      | \"replicas\"\n      | \"ackWait\"\n      | \"maxDeliver\"\n    >\n  > &\n    NatsTransportOptions;\n\n  private readonly consumers: Array<{ stop: () => void }> = [];\n  private started = false;\n\n  constructor(options: NatsTransportOptions) {\n    if (!options.connection && !options.connectionOptions) {\n      throw new Error(\n        \"Either connection or connectionOptions must be provided\"\n      );\n    }\n\n    this.options = {\n      subjectPrefix: \"saga-bus\",\n      streamName: \"SAGA_BUS\",\n      consumerPrefix: \"saga-bus-consumer\",\n      autoCreateStream: true,\n      retentionPolicy: \"workqueue\",\n      maxMessages: -1,\n      maxBytes: -1,\n      replicas: 1,\n      ackWait: 30_000_000_000, // 30 seconds in nanoseconds\n      maxDeliver: 5,\n      ...options,\n    };\n  }\n\n  async start(): Promise<void> {\n    if (this.started) return;\n\n    // Connect\n    if (this.options.connection) {\n      this.nc = this.options.connection;\n    } else {\n      this.nc = await connect(this.options.connectionOptions);\n    }\n\n    // Get JetStream manager and client\n    this.jsm = await this.nc.jetstreamManager(this.options.jetStreamOptions);\n    this.js = this.nc.jetstream(this.options.jetStreamOptions);\n\n    // Create stream if needed\n    if (this.options.autoCreateStream) {\n      await this.ensureStream();\n    }\n\n    this.started = true;\n  }\n\n  async stop(): Promise<void> {\n    if (!this.started) return;\n\n    // Stop all consumers\n    for (const consumer of this.consumers) {\n      consumer.stop();\n    }\n    this.consumers.length = 0;\n\n    // Close connection if we created it\n    if (!this.options.connection && this.nc) {\n      await this.nc.drain();\n    }\n\n    this.nc = null;\n    this.jsm = null;\n    this.js = null;\n    this.started = false;\n  }\n\n  async subscribe<TMessage extends BaseMessage>(\n    options: TransportSubscribeOptions,\n    handler: (envelope: MessageEnvelope<TMessage>) => Promise<void>\n  ): Promise<void> {\n    if (!this.js || !this.jsm) throw new Error(\"Transport not started\");\n\n    const { endpoint, group } = options;\n    const subject = `${this.options.subjectPrefix}.${endpoint}.>`;\n    const consumerName = group ?? `${this.options.consumerPrefix}-${endpoint}`;\n\n    // Create durable consumer\n    const consumerConfig: Partial<ConsumerConfig> = {\n      durable_name: consumerName,\n      filter_subject: subject,\n      ack_policy: AckPolicy.Explicit,\n      deliver_policy: DeliverPolicy.All,\n      ack_wait: this.options.ackWait,\n      max_deliver: this.options.maxDeliver,\n    };\n\n    await this.jsm.consumers.add(this.options.streamName, consumerConfig);\n\n    // Subscribe\n    const consumer = await this.js.consumers.get(\n      this.options.streamName,\n      consumerName\n    );\n    const messages = await consumer.consume();\n\n    // Process messages asynchronously\n    (async () => {\n      for await (const msg of messages) {\n        try {\n          const rawEnvelope = JSON.parse(sc.decode(msg.data));\n          const envelope: MessageEnvelope<TMessage> = {\n            id: rawEnvelope.id,\n            type: rawEnvelope.type,\n            payload: rawEnvelope.payload as TMessage,\n            headers: rawEnvelope.headers,\n            timestamp: new Date(rawEnvelope.timestamp),\n            partitionKey: rawEnvelope.partitionKey,\n          };\n          await handler(envelope);\n          msg.ack();\n        } catch (error) {\n          console.error(\"[NatsTransport] Message handler error:\", error);\n          msg.nak();\n        }\n      }\n    })();\n\n    this.consumers.push({ stop: () => messages.stop() });\n  }\n\n  async publish<TMessage extends BaseMessage>(\n    message: TMessage,\n    options: TransportPublishOptions\n  ): Promise<void> {\n    if (!this.js) throw new Error(\"Transport not started\");\n\n    const { endpoint, key, headers: customHeaders = {}, delayMs } = options;\n\n    // NATS JetStream doesn't support delayed messages natively\n    if (delayMs && delayMs > 0) {\n      throw new Error(\n        \"NATS JetStream does not support delayed messages. \" +\n          \"Use an external scheduler for delayed delivery.\"\n      );\n    }\n\n    const subject = `${this.options.subjectPrefix}.${endpoint}.${message.type}`;\n\n    // Create envelope\n    const envelope: MessageEnvelope<TMessage> = {\n      id: randomUUID(),\n      type: message.type,\n      payload: message,\n      headers: customHeaders as Record<string, string>,\n      timestamp: new Date(),\n      partitionKey: key,\n    };\n\n    // Build headers\n    const h = headers();\n    h.set(\"Nats-Msg-Id\", envelope.id);\n    h.set(\"X-Message-Type\", message.type);\n    if (key) h.set(\"X-Correlation-Id\", key);\n    for (const [k, v] of Object.entries(customHeaders)) {\n      if (typeof v === \"string\") {\n        h.set(k, v);\n      }\n    }\n\n    // Publish\n    const publishOptions: Partial<JetStreamPublishOptions> = {\n      msgID: envelope.id,\n      headers: h,\n    };\n\n    await this.js.publish(\n      subject,\n      sc.encode(JSON.stringify(envelope)),\n      publishOptions\n    );\n  }\n\n  private async ensureStream(): Promise<void> {\n    if (!this.jsm) return;\n\n    try {\n      await this.jsm.streams.info(this.options.streamName);\n    } catch {\n      // Stream doesn't exist, create it\n      const retentionMap: Record<string, RetentionPolicy> = {\n        limits: RetentionPolicy.Limits,\n        interest: RetentionPolicy.Interest,\n        workqueue: RetentionPolicy.Workqueue,\n      };\n\n      await this.jsm.streams.add({\n        name: this.options.streamName,\n        subjects: [`${this.options.subjectPrefix}.>`],\n        retention: retentionMap[this.options.retentionPolicy],\n        max_msgs: this.options.maxMessages,\n        max_bytes: this.options.maxBytes,\n        num_replicas: this.options.replicas,\n      });\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@saga-bus/transport-nats",
+  "version": "0.1.2",
+  "description": "NATS JetStream transport for saga-bus",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@saga-bus/core": "workspace:*"
+  },
+  "peerDependencies": {
+    "nats": ">=2.0.0"
+  },
+  "devDependencies": {
+    "@repo/eslint-config": "workspace:*",
+    "@repo/typescript-config": "workspace:*",
+    "@types/node": "^22.10.1",
+    "eslint": "^9.16.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/d-e-a-n-f/saga-bus.git",
+    "directory": "packages/transport-nats"
+  },
+  "bugs": {
+    "url": "https://github.com/d-e-a-n-f/saga-bus/issues"
+  },
+  "homepage": "https://github.com/d-e-a-n-f/saga-bus#readme"
+}