@saga-bus/transport-azure-servicebus 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Dean Foran
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,102 @@
+# @saga-bus/transport-azure-servicebus
+
+Azure Service Bus transport for saga-bus. Provides integration with Azure Service Bus topics and subscriptions with support for sessions, scheduled messages, and dead-letter queues.
+
+## Installation
+
+```bash
+pnpm add @saga-bus/transport-azure-servicebus @azure/service-bus
+```
+
+## Usage
+
+### Basic Setup
+
+```typescript
+import { AzureServiceBusTransport } from "@saga-bus/transport-azure-servicebus";
+import { createBus } from "@saga-bus/core";
+
+const transport = new AzureServiceBusTransport({
+  connectionString: process.env.AZURE_SERVICE_BUS_CONNECTION_STRING,
+  subscriptionName: "my-worker",
+});
+
+const bus = createBus({
+  transport,
+  store,
+  sagas: [OrderSaga],
+});
+
+await bus.start();
+```
+
+### Azure AD Authentication
+
+```typescript
+import { DefaultAzureCredential } from "@azure/identity";
+
+const transport = new AzureServiceBusTransport({
+  fullyQualifiedNamespace: "mybus.servicebus.windows.net",
+  credential: new DefaultAzureCredential(),
+  subscriptionName: "my-worker",
+});
+```
+
+### Session-Based Ordering
+
+Enable sessions for guaranteed message ordering per correlation ID:
+
+```typescript
+const transport = new AzureServiceBusTransport({
+  connectionString: process.env.AZURE_SERVICE_BUS_CONNECTION_STRING,
+  subscriptionName: "my-worker",
+  sessionEnabled: true, // Uses correlation ID as session ID
+});
+```
+
+## Features
+
+- **Topic/Subscription Model** - Publish to topics, subscribe via subscriptions
+- **Session Support** - Ordered message processing using sessions
+- **Scheduled Messages** - Native delayed delivery via `scheduledEnqueueTimeUtc`
+- **Dead-Letter Queue** - Automatic DLQ for invalid messages
+- **Auto-Lock Renewal** - Prevents message loss during long processing
+- **Azure AD Authentication** - Support for managed identities
+
+## Configuration
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `connectionString` | `string` | - | Connection string for Service Bus |
+| `fullyQualifiedNamespace` | `string` | - | Namespace for Azure AD auth |
+| `credential` | `TokenCredential` | - | Azure AD credential |
+| `subscriptionName` | `string` | - | Subscription name for receiving |
+| `defaultTopic` | `string` | message type | Default topic for publishing |
+| `sessionEnabled` | `boolean` | `false` | Enable session-based ordering |
+| `maxConcurrentCalls` | `number` | `1` | Concurrent message handlers |
+| `maxAutoLockRenewalDurationInMs` | `number` | `300000` | Lock renewal duration |
+| `autoCompleteMessages` | `boolean` | `false` | Auto-complete on success |
+| `receiveMode` | `"peekLock" \| "receiveAndDelete"` | `"peekLock"` | Message receive mode |
+| `entityPrefix` | `string` | `""` | Prefix for topic/queue names |
+
+## Delayed Messages
+
+The transport uses Azure Service Bus native scheduled messages:
+
+```typescript
+// In a saga handler
+await ctx.schedule(
+  { type: "PaymentTimeout", orderId },
+  60000 // 1 minute delay
+);
+```
+
+## Error Handling
+
+- **Invalid messages** are sent to the dead-letter queue
+- **Handler errors** cause message abandonment for retry
+- **Connection errors** are logged and the receiver continues
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,219 @@
+"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, {
+  AzureServiceBusTransport: () => AzureServiceBusTransport
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/AzureServiceBusTransport.ts
+var import_service_bus = require("@azure/service-bus");
+var import_crypto = require("crypto");
+var AzureServiceBusTransport = class {
+  client = null;
+  options;
+  senders = /* @__PURE__ */ new Map();
+  receivers = [];
+  subscriptions = [];
+  started = false;
+  stopping = false;
+  constructor(options) {
+    if (!options.connectionString && !options.fullyQualifiedNamespace) {
+      throw new Error(
+        "Either connectionString or fullyQualifiedNamespace must be provided"
+      );
+    }
+    if (options.fullyQualifiedNamespace && !options.credential) {
+      throw new Error(
+        "credential is required when using fullyQualifiedNamespace"
+      );
+    }
+    this.options = {
+      maxConcurrentCalls: 1,
+      maxAutoLockRenewalDurationInMs: 3e5,
+      autoCompleteMessages: false,
+      receiveMode: "peekLock",
+      entityPrefix: "",
+      sessionEnabled: false,
+      ...options
+    };
+  }
+  async start() {
+    if (this.started) return;
+    if (this.options.connectionString) {
+      this.client = new import_service_bus.ServiceBusClient(this.options.connectionString);
+    } else if (this.options.fullyQualifiedNamespace && this.options.credential) {
+      this.client = new import_service_bus.ServiceBusClient(
+        this.options.fullyQualifiedNamespace,
+        this.options.credential
+      );
+    } else {
+      throw new Error("Invalid configuration");
+    }
+    for (const sub of this.subscriptions) {
+      await this.startReceiver(sub);
+    }
+    this.started = true;
+  }
+  async stop() {
+    if (!this.started || this.stopping) return;
+    this.stopping = true;
+    for (const receiver of this.receivers) {
+      try {
+        await receiver.close();
+      } catch (error) {
+        console.error("[AzureServiceBus] Error closing receiver:", error);
+      }
+    }
+    this.receivers.length = 0;
+    for (const sender of this.senders.values()) {
+      try {
+        await sender.close();
+      } catch (error) {
+        console.error("[AzureServiceBus] Error closing sender:", error);
+      }
+    }
+    this.senders.clear();
+    if (this.client) {
+      await this.client.close();
+      this.client = null;
+    }
+    this.started = false;
+    this.stopping = false;
+  }
+  async subscribe(options, handler) {
+    const { endpoint, concurrency = 1, group } = options;
+    const topicName = `${this.options.entityPrefix}${endpoint}`;
+    const subscriptionName = group ?? this.options.subscriptionName ?? "default";
+    const registration = {
+      endpoint,
+      topicName,
+      subscriptionName,
+      handler,
+      concurrency
+    };
+    this.subscriptions.push(registration);
+    if (this.started && this.client) {
+      await this.startReceiver(registration);
+    }
+  }
+  async publish(message, options) {
+    if (!this.client) {
+      throw new Error("Transport not started");
+    }
+    const { endpoint, key, headers = {}, delayMs } = options;
+    const topicName = `${this.options.entityPrefix}${endpoint ?? this.options.defaultTopic ?? message.type}`;
+    let sender = this.senders.get(topicName);
+    if (!sender) {
+      sender = this.client.createSender(topicName);
+      this.senders.set(topicName, sender);
+    }
+    const envelope = {
+      id: (0, import_crypto.randomUUID)(),
+      type: message.type,
+      payload: message,
+      headers,
+      timestamp: /* @__PURE__ */ new Date(),
+      partitionKey: key
+    };
+    const sbMessage = {
+      body: envelope,
+      messageId: envelope.id,
+      contentType: "application/json",
+      applicationProperties: {
+        messageType: message.type,
+        ...headers
+      }
+    };
+    if (this.options.sessionEnabled && key) {
+      sbMessage.sessionId = key;
+    } else if (key) {
+      sbMessage.partitionKey = key;
+    }
+    if (delayMs && delayMs > 0) {
+      sbMessage.scheduledEnqueueTimeUtc = new Date(Date.now() + delayMs);
+    }
+    await sender.sendMessages(sbMessage);
+  }
+  async startReceiver(registration) {
+    if (!this.client) return;
+    const { topicName, subscriptionName, handler, concurrency } = registration;
+    let receiver;
+    if (this.options.sessionEnabled) {
+      receiver = await this.client.acceptNextSession(topicName, subscriptionName, {
+        maxAutoLockRenewalDurationInMs: this.options.maxAutoLockRenewalDurationInMs,
+        receiveMode: this.options.receiveMode
+      });
+    } else {
+      receiver = this.client.createReceiver(topicName, subscriptionName, {
+        maxAutoLockRenewalDurationInMs: this.options.maxAutoLockRenewalDurationInMs,
+        receiveMode: this.options.receiveMode
+      });
+    }
+    this.receivers.push(receiver);
+    receiver.subscribe(
+      {
+        processMessage: async (message) => {
+          try {
+            const envelope = message.body;
+            if (!envelope || !envelope.type || !envelope.payload) {
+              console.error("[AzureServiceBus] Invalid message format:", message);
+              if (this.options.receiveMode === "peekLock") {
+                await receiver.deadLetterMessage(message, {
+                  deadLetterReason: "InvalidMessageFormat",
+                  deadLetterErrorDescription: "Message body is not a valid envelope"
+                });
+              }
+              return;
+            }
+            await handler(envelope);
+            if (this.options.receiveMode === "peekLock" && !this.options.autoCompleteMessages) {
+              await receiver.completeMessage(message);
+            }
+          } catch (error) {
+            console.error("[AzureServiceBus] Message handler error:", error);
+            if (this.options.receiveMode === "peekLock") {
+              await receiver.abandonMessage(message);
+            }
+            throw error;
+          }
+        },
+        processError: async (args) => {
+          console.error(
+            "[AzureServiceBus] Error from receiver:",
+            args.error,
+            "Source:",
+            args.errorSource
+          );
+        }
+      },
+      {
+        maxConcurrentCalls: concurrency,
+        autoCompleteMessages: this.options.autoCompleteMessages
+      }
+    );
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AzureServiceBusTransport
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/AzureServiceBusTransport.ts"],"sourcesContent":["export { AzureServiceBusTransport } from \"./AzureServiceBusTransport.js\";\nexport type { AzureServiceBusTransportOptions } from \"./types.js\";\n","import {\n  ServiceBusClient,\n  ServiceBusSender,\n  ServiceBusReceiver,\n  ServiceBusReceivedMessage,\n  ServiceBusSessionReceiver,\n} from \"@azure/service-bus\";\nimport type {\n  Transport,\n  TransportSubscribeOptions,\n  TransportPublishOptions,\n  MessageEnvelope,\n  BaseMessage,\n} from \"@saga-bus/core\";\nimport type { AzureServiceBusTransportOptions, SubscriptionRegistration } from \"./types.js\";\nimport { randomUUID } from \"crypto\";\n\n/**\n * Azure Service Bus transport implementation for saga-bus.\n *\n * Supports both queue and topic/subscription patterns with optional\n * session-based message ordering.\n */\nexport class AzureServiceBusTransport implements Transport {\n  private client: ServiceBusClient | null = null;\n  private readonly options: AzureServiceBusTransportOptions;\n  private readonly senders = new Map<string, ServiceBusSender>();\n  private readonly receivers: Array<ServiceBusReceiver | ServiceBusSessionReceiver> = [];\n  private readonly subscriptions: SubscriptionRegistration[] = [];\n  private started = false;\n  private stopping = false;\n\n  constructor(options: AzureServiceBusTransportOptions) {\n    if (!options.connectionString && !options.fullyQualifiedNamespace) {\n      throw new Error(\n        \"Either connectionString or fullyQualifiedNamespace must be provided\"\n      );\n    }\n\n    if (options.fullyQualifiedNamespace && !options.credential) {\n      throw new Error(\n        \"credential is required when using fullyQualifiedNamespace\"\n      );\n    }\n\n    this.options = {\n      maxConcurrentCalls: 1,\n      maxAutoLockRenewalDurationInMs: 300000,\n      autoCompleteMessages: false,\n      receiveMode: \"peekLock\",\n      entityPrefix: \"\",\n      sessionEnabled: false,\n      ...options,\n    };\n  }\n\n  async start(): Promise<void> {\n    if (this.started) return;\n\n    // Create the ServiceBusClient\n    if (this.options.connectionString) {\n      this.client = new ServiceBusClient(this.options.connectionString);\n    } else if (this.options.fullyQualifiedNamespace && this.options.credential) {\n      this.client = new ServiceBusClient(\n        this.options.fullyQualifiedNamespace,\n        this.options.credential\n      );\n    } else {\n      throw new Error(\"Invalid configuration\");\n    }\n\n    // Start all registered subscriptions\n    for (const sub of this.subscriptions) {\n      await this.startReceiver(sub);\n    }\n\n    this.started = true;\n  }\n\n  async stop(): Promise<void> {\n    if (!this.started || this.stopping) return;\n    this.stopping = true;\n\n    // Close all receivers\n    for (const receiver of this.receivers) {\n      try {\n        await receiver.close();\n      } catch (error) {\n        console.error(\"[AzureServiceBus] Error closing receiver:\", error);\n      }\n    }\n    this.receivers.length = 0;\n\n    // Close all senders\n    for (const sender of this.senders.values()) {\n      try {\n        await sender.close();\n      } catch (error) {\n        console.error(\"[AzureServiceBus] Error closing sender:\", error);\n      }\n    }\n    this.senders.clear();\n\n    // Close the client\n    if (this.client) {\n      await this.client.close();\n      this.client = null;\n    }\n\n    this.started = false;\n    this.stopping = false;\n  }\n\n  async subscribe<TMessage extends BaseMessage>(\n    options: TransportSubscribeOptions,\n    handler: (envelope: MessageEnvelope<TMessage>) => Promise<void>\n  ): Promise<void> {\n    const { endpoint, concurrency = 1, group } = options;\n\n    // Build topic and subscription names\n    const topicName = `${this.options.entityPrefix}${endpoint}`;\n    const subscriptionName =\n      group ?? this.options.subscriptionName ?? \"default\";\n\n    const registration: SubscriptionRegistration = {\n      endpoint,\n      topicName,\n      subscriptionName,\n      handler: handler as (envelope: unknown) => Promise<void>,\n      concurrency,\n    };\n\n    this.subscriptions.push(registration);\n\n    // If already started, immediately start the receiver\n    if (this.started && this.client) {\n      await this.startReceiver(registration);\n    }\n  }\n\n  async publish<TMessage extends BaseMessage>(\n    message: TMessage,\n    options: TransportPublishOptions\n  ): Promise<void> {\n    if (!this.client) {\n      throw new Error(\"Transport not started\");\n    }\n\n    const { endpoint, key, headers = {}, delayMs } = options;\n    const topicName = `${this.options.entityPrefix}${\n      endpoint ?? this.options.defaultTopic ?? message.type\n    }`;\n\n    // Get or create sender\n    let sender = this.senders.get(topicName);\n    if (!sender) {\n      sender = this.client.createSender(topicName);\n      this.senders.set(topicName, sender);\n    }\n\n    // Create message envelope\n    const envelope: MessageEnvelope<TMessage> = {\n      id: randomUUID(),\n      type: message.type,\n      payload: message,\n      headers: headers as Record<string, string>,\n      timestamp: new Date(),\n      partitionKey: key,\n    };\n\n    // Build Service Bus message\n    const sbMessage: {\n      body: MessageEnvelope<TMessage>;\n      messageId: string;\n      contentType: string;\n      sessionId?: string;\n      partitionKey?: string;\n      applicationProperties: Record<string, string>;\n      scheduledEnqueueTimeUtc?: Date;\n    } = {\n      body: envelope,\n      messageId: envelope.id,\n      contentType: \"application/json\",\n      applicationProperties: {\n        messageType: message.type,\n        ...headers,\n      },\n    };\n\n    // Set session ID for ordered delivery if enabled\n    if (this.options.sessionEnabled && key) {\n      sbMessage.sessionId = key;\n    } else if (key) {\n      sbMessage.partitionKey = key;\n    }\n\n    // Handle delayed delivery using native scheduled messages\n    if (delayMs && delayMs > 0) {\n      sbMessage.scheduledEnqueueTimeUtc = new Date(Date.now() + delayMs);\n    }\n\n    await sender.sendMessages(sbMessage);\n  }\n\n  private async startReceiver(registration: SubscriptionRegistration): Promise<void> {\n    if (!this.client) return;\n\n    const { topicName, subscriptionName, handler, concurrency } = registration;\n\n    let receiver: ServiceBusReceiver | ServiceBusSessionReceiver;\n\n    if (this.options.sessionEnabled) {\n      // Session-enabled receiver for ordered processing\n      receiver = await this.client.acceptNextSession(topicName, subscriptionName, {\n        maxAutoLockRenewalDurationInMs: this.options.maxAutoLockRenewalDurationInMs,\n        receiveMode: this.options.receiveMode,\n      });\n    } else {\n      // Regular subscription receiver\n      receiver = this.client.createReceiver(topicName, subscriptionName, {\n        maxAutoLockRenewalDurationInMs: this.options.maxAutoLockRenewalDurationInMs,\n        receiveMode: this.options.receiveMode,\n      });\n    }\n\n    this.receivers.push(receiver);\n\n    // Start message processing\n    receiver.subscribe(\n      {\n        processMessage: async (message: ServiceBusReceivedMessage) => {\n          try {\n            const envelope = message.body as MessageEnvelope;\n\n            // Ensure envelope has required fields\n            if (!envelope || !envelope.type || !envelope.payload) {\n              console.error(\"[AzureServiceBus] Invalid message format:\", message);\n              if (this.options.receiveMode === \"peekLock\") {\n                await receiver.deadLetterMessage(message, {\n                  deadLetterReason: \"InvalidMessageFormat\",\n                  deadLetterErrorDescription: \"Message body is not a valid envelope\",\n                });\n              }\n              return;\n            }\n\n            await handler(envelope);\n\n            // Complete message if not auto-completed\n            if (\n              this.options.receiveMode === \"peekLock\" &&\n              !this.options.autoCompleteMessages\n            ) {\n              await receiver.completeMessage(message);\n            }\n          } catch (error) {\n            console.error(\"[AzureServiceBus] Message handler error:\", error);\n\n            if (this.options.receiveMode === \"peekLock\") {\n              // Abandon for retry\n              await receiver.abandonMessage(message);\n            }\n\n            throw error;\n          }\n        },\n        processError: async (args) => {\n          console.error(\n            \"[AzureServiceBus] Error from receiver:\",\n            args.error,\n            \"Source:\",\n            args.errorSource\n          );\n        },\n      },\n      {\n        maxConcurrentCalls: concurrency,\n        autoCompleteMessages: this.options.autoCompleteMessages,\n      }\n    );\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,88 @@
+import { Transport, BaseMessage, TransportSubscribeOptions, MessageEnvelope, TransportPublishOptions } from '@saga-bus/core';
+import { TokenCredential } from '@azure/service-bus';
+
+/**
+ * Configuration options for Azure Service Bus transport.
+ */
+interface AzureServiceBusTransportOptions {
+    /**
+     * Connection string for Azure Service Bus.
+     * Either connectionString OR (fullyQualifiedNamespace + credential) must be provided.
+     */
+    connectionString?: string;
+    /**
+     * Fully qualified namespace (e.g., "mybus.servicebus.windows.net").
+     * Use with credential for Azure AD authentication.
+     */
+    fullyQualifiedNamespace?: string;
+    /**
+     * Token credential for Azure AD authentication.
+     * Use with fullyQualifiedNamespace.
+     */
+    credential?: TokenCredential;
+    /**
+     * Default topic for publishing messages.
+     * If not provided, message type is used as topic name.
+     */
+    defaultTopic?: string;
+    /**
+     * Subscription name for receiving messages.
+     * Required for subscribing to topics.
+     */
+    subscriptionName?: string;
+    /**
+     * Whether to use sessions for ordered message processing.
+     * When enabled, correlation ID is used as session ID.
+     * @default false
+     */
+    sessionEnabled?: boolean;
+    /**
+     * Maximum number of concurrent message handlers.
+     * @default 1
+     */
+    maxConcurrentCalls?: number;
+    /**
+     * Maximum duration for auto-lock renewal in milliseconds.
+     * @default 300000 (5 minutes)
+     */
+    maxAutoLockRenewalDurationInMs?: number;
+    /**
+     * Whether to auto-complete messages after successful processing.
+     * @default false (manual acknowledgment)
+     */
+    autoCompleteMessages?: boolean;
+    /**
+     * Receive mode: "peekLock" or "receiveAndDelete".
+     * @default "peekLock"
+     */
+    receiveMode?: "peekLock" | "receiveAndDelete";
+    /**
+     * Prefix for queue/topic names.
+     * @default ""
+     */
+    entityPrefix?: string;
+}
+
+/**
+ * Azure Service Bus transport implementation for saga-bus.
+ *
+ * Supports both queue and topic/subscription patterns with optional
+ * session-based message ordering.
+ */
+declare class AzureServiceBusTransport implements Transport {
+    private client;
+    private readonly options;
+    private readonly senders;
+    private readonly receivers;
+    private readonly subscriptions;
+    private started;
+    private stopping;
+    constructor(options: AzureServiceBusTransportOptions);
+    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 startReceiver;
+}
+
+export { AzureServiceBusTransport, type AzureServiceBusTransportOptions };

package/dist/index.d.ts

@@ -0,0 +1,88 @@
+import { Transport, BaseMessage, TransportSubscribeOptions, MessageEnvelope, TransportPublishOptions } from '@saga-bus/core';
+import { TokenCredential } from '@azure/service-bus';
+
+/**
+ * Configuration options for Azure Service Bus transport.
+ */
+interface AzureServiceBusTransportOptions {
+    /**
+     * Connection string for Azure Service Bus.
+     * Either connectionString OR (fullyQualifiedNamespace + credential) must be provided.
+     */
+    connectionString?: string;
+    /**
+     * Fully qualified namespace (e.g., "mybus.servicebus.windows.net").
+     * Use with credential for Azure AD authentication.
+     */
+    fullyQualifiedNamespace?: string;
+    /**
+     * Token credential for Azure AD authentication.
+     * Use with fullyQualifiedNamespace.
+     */
+    credential?: TokenCredential;
+    /**
+     * Default topic for publishing messages.
+     * If not provided, message type is used as topic name.
+     */
+    defaultTopic?: string;
+    /**
+     * Subscription name for receiving messages.
+     * Required for subscribing to topics.
+     */
+    subscriptionName?: string;
+    /**
+     * Whether to use sessions for ordered message processing.
+     * When enabled, correlation ID is used as session ID.
+     * @default false
+     */
+    sessionEnabled?: boolean;
+    /**
+     * Maximum number of concurrent message handlers.
+     * @default 1
+     */
+    maxConcurrentCalls?: number;
+    /**
+     * Maximum duration for auto-lock renewal in milliseconds.
+     * @default 300000 (5 minutes)
+     */
+    maxAutoLockRenewalDurationInMs?: number;
+    /**
+     * Whether to auto-complete messages after successful processing.
+     * @default false (manual acknowledgment)
+     */
+    autoCompleteMessages?: boolean;
+    /**
+     * Receive mode: "peekLock" or "receiveAndDelete".
+     * @default "peekLock"
+     */
+    receiveMode?: "peekLock" | "receiveAndDelete";
+    /**
+     * Prefix for queue/topic names.
+     * @default ""
+     */
+    entityPrefix?: string;
+}
+
+/**
+ * Azure Service Bus transport implementation for saga-bus.
+ *
+ * Supports both queue and topic/subscription patterns with optional
+ * session-based message ordering.
+ */
+declare class AzureServiceBusTransport implements Transport {
+    private client;
+    private readonly options;
+    private readonly senders;
+    private readonly receivers;
+    private readonly subscriptions;
+    private started;
+    private stopping;
+    constructor(options: AzureServiceBusTransportOptions);
+    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 startReceiver;
+}
+
+export { AzureServiceBusTransport, type AzureServiceBusTransportOptions };

package/dist/index.js

@@ -0,0 +1,194 @@
+// src/AzureServiceBusTransport.ts
+import {
+  ServiceBusClient
+} from "@azure/service-bus";
+import { randomUUID } from "crypto";
+var AzureServiceBusTransport = class {
+  client = null;
+  options;
+  senders = /* @__PURE__ */ new Map();
+  receivers = [];
+  subscriptions = [];
+  started = false;
+  stopping = false;
+  constructor(options) {
+    if (!options.connectionString && !options.fullyQualifiedNamespace) {
+      throw new Error(
+        "Either connectionString or fullyQualifiedNamespace must be provided"
+      );
+    }
+    if (options.fullyQualifiedNamespace && !options.credential) {
+      throw new Error(
+        "credential is required when using fullyQualifiedNamespace"
+      );
+    }
+    this.options = {
+      maxConcurrentCalls: 1,
+      maxAutoLockRenewalDurationInMs: 3e5,
+      autoCompleteMessages: false,
+      receiveMode: "peekLock",
+      entityPrefix: "",
+      sessionEnabled: false,
+      ...options
+    };
+  }
+  async start() {
+    if (this.started) return;
+    if (this.options.connectionString) {
+      this.client = new ServiceBusClient(this.options.connectionString);
+    } else if (this.options.fullyQualifiedNamespace && this.options.credential) {
+      this.client = new ServiceBusClient(
+        this.options.fullyQualifiedNamespace,
+        this.options.credential
+      );
+    } else {
+      throw new Error("Invalid configuration");
+    }
+    for (const sub of this.subscriptions) {
+      await this.startReceiver(sub);
+    }
+    this.started = true;
+  }
+  async stop() {
+    if (!this.started || this.stopping) return;
+    this.stopping = true;
+    for (const receiver of this.receivers) {
+      try {
+        await receiver.close();
+      } catch (error) {
+        console.error("[AzureServiceBus] Error closing receiver:", error);
+      }
+    }
+    this.receivers.length = 0;
+    for (const sender of this.senders.values()) {
+      try {
+        await sender.close();
+      } catch (error) {
+        console.error("[AzureServiceBus] Error closing sender:", error);
+      }
+    }
+    this.senders.clear();
+    if (this.client) {
+      await this.client.close();
+      this.client = null;
+    }
+    this.started = false;
+    this.stopping = false;
+  }
+  async subscribe(options, handler) {
+    const { endpoint, concurrency = 1, group } = options;
+    const topicName = `${this.options.entityPrefix}${endpoint}`;
+    const subscriptionName = group ?? this.options.subscriptionName ?? "default";
+    const registration = {
+      endpoint,
+      topicName,
+      subscriptionName,
+      handler,
+      concurrency
+    };
+    this.subscriptions.push(registration);
+    if (this.started && this.client) {
+      await this.startReceiver(registration);
+    }
+  }
+  async publish(message, options) {
+    if (!this.client) {
+      throw new Error("Transport not started");
+    }
+    const { endpoint, key, headers = {}, delayMs } = options;
+    const topicName = `${this.options.entityPrefix}${endpoint ?? this.options.defaultTopic ?? message.type}`;
+    let sender = this.senders.get(topicName);
+    if (!sender) {
+      sender = this.client.createSender(topicName);
+      this.senders.set(topicName, sender);
+    }
+    const envelope = {
+      id: randomUUID(),
+      type: message.type,
+      payload: message,
+      headers,
+      timestamp: /* @__PURE__ */ new Date(),
+      partitionKey: key
+    };
+    const sbMessage = {
+      body: envelope,
+      messageId: envelope.id,
+      contentType: "application/json",
+      applicationProperties: {
+        messageType: message.type,
+        ...headers
+      }
+    };
+    if (this.options.sessionEnabled && key) {
+      sbMessage.sessionId = key;
+    } else if (key) {
+      sbMessage.partitionKey = key;
+    }
+    if (delayMs && delayMs > 0) {
+      sbMessage.scheduledEnqueueTimeUtc = new Date(Date.now() + delayMs);
+    }
+    await sender.sendMessages(sbMessage);
+  }
+  async startReceiver(registration) {
+    if (!this.client) return;
+    const { topicName, subscriptionName, handler, concurrency } = registration;
+    let receiver;
+    if (this.options.sessionEnabled) {
+      receiver = await this.client.acceptNextSession(topicName, subscriptionName, {
+        maxAutoLockRenewalDurationInMs: this.options.maxAutoLockRenewalDurationInMs,
+        receiveMode: this.options.receiveMode
+      });
+    } else {
+      receiver = this.client.createReceiver(topicName, subscriptionName, {
+        maxAutoLockRenewalDurationInMs: this.options.maxAutoLockRenewalDurationInMs,
+        receiveMode: this.options.receiveMode
+      });
+    }
+    this.receivers.push(receiver);
+    receiver.subscribe(
+      {
+        processMessage: async (message) => {
+          try {
+            const envelope = message.body;
+            if (!envelope || !envelope.type || !envelope.payload) {
+              console.error("[AzureServiceBus] Invalid message format:", message);
+              if (this.options.receiveMode === "peekLock") {
+                await receiver.deadLetterMessage(message, {
+                  deadLetterReason: "InvalidMessageFormat",
+                  deadLetterErrorDescription: "Message body is not a valid envelope"
+                });
+              }
+              return;
+            }
+            await handler(envelope);
+            if (this.options.receiveMode === "peekLock" && !this.options.autoCompleteMessages) {
+              await receiver.completeMessage(message);
+            }
+          } catch (error) {
+            console.error("[AzureServiceBus] Message handler error:", error);
+            if (this.options.receiveMode === "peekLock") {
+              await receiver.abandonMessage(message);
+            }
+            throw error;
+          }
+        },
+        processError: async (args) => {
+          console.error(
+            "[AzureServiceBus] Error from receiver:",
+            args.error,
+            "Source:",
+            args.errorSource
+          );
+        }
+      },
+      {
+        maxConcurrentCalls: concurrency,
+        autoCompleteMessages: this.options.autoCompleteMessages
+      }
+    );
+  }
+};
+export {
+  AzureServiceBusTransport
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/AzureServiceBusTransport.ts"],"sourcesContent":["import {\n  ServiceBusClient,\n  ServiceBusSender,\n  ServiceBusReceiver,\n  ServiceBusReceivedMessage,\n  ServiceBusSessionReceiver,\n} from \"@azure/service-bus\";\nimport type {\n  Transport,\n  TransportSubscribeOptions,\n  TransportPublishOptions,\n  MessageEnvelope,\n  BaseMessage,\n} from \"@saga-bus/core\";\nimport type { AzureServiceBusTransportOptions, SubscriptionRegistration } from \"./types.js\";\nimport { randomUUID } from \"crypto\";\n\n/**\n * Azure Service Bus transport implementation for saga-bus.\n *\n * Supports both queue and topic/subscription patterns with optional\n * session-based message ordering.\n */\nexport class AzureServiceBusTransport implements Transport {\n  private client: ServiceBusClient | null = null;\n  private readonly options: AzureServiceBusTransportOptions;\n  private readonly senders = new Map<string, ServiceBusSender>();\n  private readonly receivers: Array<ServiceBusReceiver | ServiceBusSessionReceiver> = [];\n  private readonly subscriptions: SubscriptionRegistration[] = [];\n  private started = false;\n  private stopping = false;\n\n  constructor(options: AzureServiceBusTransportOptions) {\n    if (!options.connectionString && !options.fullyQualifiedNamespace) {\n      throw new Error(\n        \"Either connectionString or fullyQualifiedNamespace must be provided\"\n      );\n    }\n\n    if (options.fullyQualifiedNamespace && !options.credential) {\n      throw new Error(\n        \"credential is required when using fullyQualifiedNamespace\"\n      );\n    }\n\n    this.options = {\n      maxConcurrentCalls: 1,\n      maxAutoLockRenewalDurationInMs: 300000,\n      autoCompleteMessages: false,\n      receiveMode: \"peekLock\",\n      entityPrefix: \"\",\n      sessionEnabled: false,\n      ...options,\n    };\n  }\n\n  async start(): Promise<void> {\n    if (this.started) return;\n\n    // Create the ServiceBusClient\n    if (this.options.connectionString) {\n      this.client = new ServiceBusClient(this.options.connectionString);\n    } else if (this.options.fullyQualifiedNamespace && this.options.credential) {\n      this.client = new ServiceBusClient(\n        this.options.fullyQualifiedNamespace,\n        this.options.credential\n      );\n    } else {\n      throw new Error(\"Invalid configuration\");\n    }\n\n    // Start all registered subscriptions\n    for (const sub of this.subscriptions) {\n      await this.startReceiver(sub);\n    }\n\n    this.started = true;\n  }\n\n  async stop(): Promise<void> {\n    if (!this.started || this.stopping) return;\n    this.stopping = true;\n\n    // Close all receivers\n    for (const receiver of this.receivers) {\n      try {\n        await receiver.close();\n      } catch (error) {\n        console.error(\"[AzureServiceBus] Error closing receiver:\", error);\n      }\n    }\n    this.receivers.length = 0;\n\n    // Close all senders\n    for (const sender of this.senders.values()) {\n      try {\n        await sender.close();\n      } catch (error) {\n        console.error(\"[AzureServiceBus] Error closing sender:\", error);\n      }\n    }\n    this.senders.clear();\n\n    // Close the client\n    if (this.client) {\n      await this.client.close();\n      this.client = null;\n    }\n\n    this.started = false;\n    this.stopping = false;\n  }\n\n  async subscribe<TMessage extends BaseMessage>(\n    options: TransportSubscribeOptions,\n    handler: (envelope: MessageEnvelope<TMessage>) => Promise<void>\n  ): Promise<void> {\n    const { endpoint, concurrency = 1, group } = options;\n\n    // Build topic and subscription names\n    const topicName = `${this.options.entityPrefix}${endpoint}`;\n    const subscriptionName =\n      group ?? this.options.subscriptionName ?? \"default\";\n\n    const registration: SubscriptionRegistration = {\n      endpoint,\n      topicName,\n      subscriptionName,\n      handler: handler as (envelope: unknown) => Promise<void>,\n      concurrency,\n    };\n\n    this.subscriptions.push(registration);\n\n    // If already started, immediately start the receiver\n    if (this.started && this.client) {\n      await this.startReceiver(registration);\n    }\n  }\n\n  async publish<TMessage extends BaseMessage>(\n    message: TMessage,\n    options: TransportPublishOptions\n  ): Promise<void> {\n    if (!this.client) {\n      throw new Error(\"Transport not started\");\n    }\n\n    const { endpoint, key, headers = {}, delayMs } = options;\n    const topicName = `${this.options.entityPrefix}${\n      endpoint ?? this.options.defaultTopic ?? message.type\n    }`;\n\n    // Get or create sender\n    let sender = this.senders.get(topicName);\n    if (!sender) {\n      sender = this.client.createSender(topicName);\n      this.senders.set(topicName, sender);\n    }\n\n    // Create message envelope\n    const envelope: MessageEnvelope<TMessage> = {\n      id: randomUUID(),\n      type: message.type,\n      payload: message,\n      headers: headers as Record<string, string>,\n      timestamp: new Date(),\n      partitionKey: key,\n    };\n\n    // Build Service Bus message\n    const sbMessage: {\n      body: MessageEnvelope<TMessage>;\n      messageId: string;\n      contentType: string;\n      sessionId?: string;\n      partitionKey?: string;\n      applicationProperties: Record<string, string>;\n      scheduledEnqueueTimeUtc?: Date;\n    } = {\n      body: envelope,\n      messageId: envelope.id,\n      contentType: \"application/json\",\n      applicationProperties: {\n        messageType: message.type,\n        ...headers,\n      },\n    };\n\n    // Set session ID for ordered delivery if enabled\n    if (this.options.sessionEnabled && key) {\n      sbMessage.sessionId = key;\n    } else if (key) {\n      sbMessage.partitionKey = key;\n    }\n\n    // Handle delayed delivery using native scheduled messages\n    if (delayMs && delayMs > 0) {\n      sbMessage.scheduledEnqueueTimeUtc = new Date(Date.now() + delayMs);\n    }\n\n    await sender.sendMessages(sbMessage);\n  }\n\n  private async startReceiver(registration: SubscriptionRegistration): Promise<void> {\n    if (!this.client) return;\n\n    const { topicName, subscriptionName, handler, concurrency } = registration;\n\n    let receiver: ServiceBusReceiver | ServiceBusSessionReceiver;\n\n    if (this.options.sessionEnabled) {\n      // Session-enabled receiver for ordered processing\n      receiver = await this.client.acceptNextSession(topicName, subscriptionName, {\n        maxAutoLockRenewalDurationInMs: this.options.maxAutoLockRenewalDurationInMs,\n        receiveMode: this.options.receiveMode,\n      });\n    } else {\n      // Regular subscription receiver\n      receiver = this.client.createReceiver(topicName, subscriptionName, {\n        maxAutoLockRenewalDurationInMs: this.options.maxAutoLockRenewalDurationInMs,\n        receiveMode: this.options.receiveMode,\n      });\n    }\n\n    this.receivers.push(receiver);\n\n    // Start message processing\n    receiver.subscribe(\n      {\n        processMessage: async (message: ServiceBusReceivedMessage) => {\n          try {\n            const envelope = message.body as MessageEnvelope;\n\n            // Ensure envelope has required fields\n            if (!envelope || !envelope.type || !envelope.payload) {\n              console.error(\"[AzureServiceBus] Invalid message format:\", message);\n              if (this.options.receiveMode === \"peekLock\") {\n                await receiver.deadLetterMessage(message, {\n                  deadLetterReason: \"InvalidMessageFormat\",\n                  deadLetterErrorDescription: \"Message body is not a valid envelope\",\n                });\n              }\n              return;\n            }\n\n            await handler(envelope);\n\n            // Complete message if not auto-completed\n            if (\n              this.options.receiveMode === \"peekLock\" &&\n              !this.options.autoCompleteMessages\n            ) {\n              await receiver.completeMessage(message);\n            }\n          } catch (error) {\n            console.error(\"[AzureServiceBus] Message handler error:\", error);\n\n            if (this.options.receiveMode === \"peekLock\") {\n              // Abandon for retry\n              await receiver.abandonMessage(message);\n            }\n\n            throw error;\n          }\n        },\n        processError: async (args) => {\n          console.error(\n            \"[AzureServiceBus] Error from receiver:\",\n            args.error,\n            \"Source:\",\n            args.errorSource\n          );\n        },\n      },\n      {\n        maxConcurrentCalls: concurrency,\n        autoCompleteMessages: this.options.autoCompleteMessages,\n      }\n    );\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@saga-bus/transport-azure-servicebus",
+  "version": "0.1.0",
+  "description": "Azure Service Bus 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"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/deanforan/saga-bus.git",
+    "directory": "packages/transport-azure-servicebus"
+  },
+  "dependencies": {
+    "@saga-bus/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@azure/service-bus": "^7.9.5",
+    "@types/node": "^20.0.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4",
+    "@repo/eslint-config": "0.0.0",
+    "@repo/typescript-config": "0.0.0"
+  },
+  "peerDependencies": {
+    "@azure/service-bus": ">=7.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}