@babelqueue/azure-service-bus 1.0.0

package/README.md

@@ -0,0 +1,71 @@
+# @babelqueue/azure-service-bus
+
+Azure Service Bus adapter for [BabelQueue](https://babelqueue.com) — a canonical-envelope
+**publisher** and a URN-routed **consumer** over `@azure/service-bus`, on
+`@babelqueue/core`. Implements
+[§4 of the broker-bindings contract](https://babelqueue.com/docs/spec/1.x/broker-bindings#azure-service-bus),
+so an ASB-based Node service speaks the same wire contract as the .NET, Java, Python and Go
+SDKs.
+
+## Install
+
+```bash
+npm i @babelqueue/azure-service-bus @azure/service-bus
+```
+
+`@azure/service-bus` is an optional peer — **you provide the sender/receiver** (a
+`ServiceBusSender` / `ServiceBusReceiver` satisfies the adapter structurally).
+
+## Use
+
+```ts
+import { ServiceBusClient } from "@azure/service-bus";
+import { AsbPublisher, AsbConsumer } from "@babelqueue/azure-service-bus";
+
+const client = new ServiceBusClient(connectionString); // or (namespace, credential)
+
+// produce
+const id = await new AsbPublisher(client.createSender("orders"))
+  .publish("urn:babel:orders:created", { order_id: 1042 });
+
+// consume (PeekLock)
+const consumer = new AsbConsumer(
+  client.createReceiver("orders"),
+  {
+    "urn:babel:orders:created": async (env, message) => {
+      console.log(env.data.order_id, env.trace_id, env.attempts);
+    },
+  },
+  { onError: (err) => console.error(err) },
+);
+await consumer.run();
+```
+
+Delayed delivery: `publish(urn, data, { delayMs: 300000 })` → native
+`scheduledEnqueueTimeUtc`.
+
+## Contract mapping (§4)
+
+| Envelope | Azure Service Bus |
+| :--- | :--- |
+| body | `body` (byte-identical across SDKs) |
+| `job` (URN) | `subject` |
+| `trace_id` | `correlationId` |
+| `meta.id` | `messageId` |
+| `meta.schema_version` | `applicationProperties["bq-schema-version"]` |
+| `meta.lang` | `applicationProperties["bq-source-lang"]` |
+| `meta.created_at` | `applicationProperties["bq-created-at"]` (ms) |
+| `attempts` | `deliveryCount − 1` (broker-authoritative) |
+| reserve / ack / retry | PeekLock → `completeMessage` / `abandonMessage` |
+
+A throwing handler `abandonMessage`s, so the broker redelivers and increments
+`deliveryCount` (at-least-once). The poll loop never stops on a bad message — observe via
+`onError` / `onUnknownUrn`. The envelope is unchanged (`schema_version` stays `1`); Azure
+Service Bus is purely additive.
+
+The sender/receiver are injected, so the unit tests use fakes — no Azure, no broker. Dual
+ESM + CJS.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,146 @@
+"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, {
+  AsbConsumer: () => AsbConsumer,
+  AsbPublisher: () => AsbPublisher,
+  toServiceBusMessage: () => toServiceBusMessage
+});
+module.exports = __toCommonJS(index_exports);
+var import_core = require("@babelqueue/core");
+function toServiceBusMessage(envelope) {
+  const applicationProperties = {};
+  if (envelope.meta.schema_version != null) {
+    applicationProperties["bq-schema-version"] = envelope.meta.schema_version;
+  }
+  if (envelope.meta.lang) applicationProperties["bq-source-lang"] = envelope.meta.lang;
+  if (envelope.meta.created_at != null) {
+    applicationProperties["bq-created-at"] = envelope.meta.created_at;
+  }
+  const message = {
+    body: import_core.EnvelopeCodec.encode(envelope),
+    contentType: "application/json"
+  };
+  if (envelope.job) message.subject = envelope.job;
+  if (envelope.trace_id) message.correlationId = envelope.trace_id;
+  if (envelope.meta.id) message.messageId = envelope.meta.id;
+  if (Object.keys(applicationProperties).length > 0) {
+    message.applicationProperties = applicationProperties;
+  }
+  return message;
+}
+var AsbPublisher = class {
+  constructor(sender) {
+    this.sender = sender;
+  }
+  sender;
+  /**
+   * Build the canonical envelope for `(urn, data)`, send it with the native projection,
+   * and return the message id (`meta.id`). A positive `delayMs` schedules native delayed
+   * delivery.
+   */
+  async publish(urn, data, options = {}) {
+    const envelope = import_core.EnvelopeCodec.make(urn, data, {
+      queue: this.sender.entityPath,
+      traceId: options.traceId
+    });
+    const message = toServiceBusMessage(envelope);
+    if (options.delayMs != null && options.delayMs > 0) {
+      message.applicationProperties = { ...message.applicationProperties, "bq-delay": options.delayMs };
+      await this.sender.scheduleMessages(message, new Date(Date.now() + options.delayMs));
+    } else {
+      await this.sender.sendMessages(message);
+    }
+    return envelope.meta.id;
+  }
+};
+var AsbConsumer = class {
+  constructor(receiver, handlers, options = {}) {
+    this.receiver = receiver;
+    this.handlers = handlers;
+    this.options = options;
+  }
+  receiver;
+  handlers;
+  options;
+  /** Receive one batch, route each message, settle each. Returns the batch size. */
+  async poll() {
+    const messages = await this.receiver.receiveMessages(
+      this.options.maxMessages ?? 10,
+      this.options.maxWaitTimeInMs != null ? { maxWaitTimeInMs: this.options.maxWaitTimeInMs } : void 0
+    );
+    for (const message of messages) {
+      await this.handle(message);
+    }
+    return messages.length;
+  }
+  /** Poll until `signal` aborts. */
+  async run(signal) {
+    while (signal?.aborted !== true) {
+      await this.poll();
+    }
+  }
+  async handle(message) {
+    const raw = typeof message.body === "string" ? message.body : String(message.body ?? "");
+    const envelope = import_core.EnvelopeCodec.decode(raw);
+    const deliveryCount = typeof message.deliveryCount === "number" ? message.deliveryCount : 0;
+    const native = deliveryCount - 1;
+    const current = typeof envelope.attempts === "number" ? envelope.attempts : 0;
+    if (native > current) {
+      envelope.attempts = native;
+    }
+    if (!import_core.EnvelopeCodec.accepts(envelope)) {
+      this.options.onError?.(
+        new import_core.BabelQueueError("Rejected a non-conformant BabelQueue envelope from Azure Service Bus."),
+        envelope,
+        message
+      );
+      await this.receiver.abandonMessage(message);
+      return;
+    }
+    const urn = import_core.EnvelopeCodec.urn(envelope);
+    const handler = this.handlers[urn];
+    if (!handler) {
+      if (this.options.onUnknownUrn) {
+        await this.options.onUnknownUrn(envelope, message);
+        await this.receiver.completeMessage(message);
+      } else {
+        this.options.onError?.(new import_core.UnknownUrnError(urn), envelope, message);
+        await this.receiver.abandonMessage(message);
+      }
+      return;
+    }
+    try {
+      await handler(envelope, message);
+      await this.receiver.completeMessage(message);
+    } catch (error) {
+      this.options.onError?.(error, envelope, message);
+      await this.receiver.abandonMessage(message);
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AsbConsumer,
+  AsbPublisher,
+  toServiceBusMessage
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Azure Service Bus adapter for BabelQueue.\n *\n * A canonical-envelope **publisher** and a URN-routed **consumer** over Azure Service\n * Bus, so an ASB-based Node service speaks the same contract (envelope shape, URN\n * identity, trace propagation) as the .NET, Java, Python and Go SDKs.\n *\n *     import { ServiceBusClient } from \"@azure/service-bus\";\n *     import { AsbPublisher, AsbConsumer } from \"@babelqueue/azure-service-bus\";\n *\n *     const client = new ServiceBusClient(connectionString);\n *     await new AsbPublisher(client.createSender(\"orders\"))\n *       .publish(\"urn:babel:orders:created\", { order_id: 1042 });\n *\n *     const consumer = new AsbConsumer(client.createReceiver(\"orders\"), {\n *       \"urn:babel:orders:created\": async (env) => { ... },\n *     });\n *     await consumer.run();\n *\n * This implements §4 of the broker-bindings contract: the canonical envelope is the\n * message body, projected onto native Service Bus fields (`subject` = URN,\n * `correlationId` = trace_id, `messageId` = meta.id, plus the `bq-` application\n * properties). The envelope is unchanged (`schema_version` stays 1); ASB is purely\n * additive. Retry is broker-native — a failed handler `abandon`s the message, so it is\n * redelivered and `deliveryCount` is incremented; the authoritative attempt count is the\n * native `deliveryCount`, surfaced to handlers as `attempts = deliveryCount − 1`.\n */\n\nimport { BabelQueueError, EnvelopeCodec, UnknownUrnError } from \"@babelqueue/core\";\nimport type { Envelope, IncomingEnvelope } from \"@babelqueue/core\";\n\n// --- Minimal Service Bus shapes (a structural subset of @azure/service-bus) -----\n\n/** A message to send (structural subset of @azure/service-bus `ServiceBusMessage`). */\nexport interface AsbMessage {\n  body: unknown;\n  subject?: string;\n  correlationId?: string;\n  messageId?: string;\n  contentType?: string;\n  applicationProperties?: { [key: string]: number | boolean | string | Date | null };\n  scheduledEnqueueTimeUtc?: Date;\n}\n\n/** A received message (structural subset of @azure/service-bus `ServiceBusReceivedMessage`). */\nexport interface AsbReceivedMessage {\n  body: unknown;\n  subject?: string;\n  correlationId?: string;\n  messageId?: string;\n  deliveryCount?: number;\n  applicationProperties?: { [key: string]: unknown };\n}\n\n/**\n * The subset of the Service Bus sender this adapter calls. A `ServiceBusSender` from\n * `@azure/service-bus` satisfies it structurally; a fake satisfies it in tests.\n */\nexport interface AsbSender {\n  entityPath: string;\n  sendMessages(message: AsbMessage): Promise<void>;\n  scheduleMessages(message: AsbMessage, scheduledEnqueueTimeUtc: Date): Promise<bigint[]>;\n}\n\n/**\n * The subset of the Service Bus receiver this adapter calls. A `ServiceBusReceiver`\n * from `@azure/service-bus` satisfies it structurally; a fake satisfies it in tests.\n */\nexport interface AsbReceiver {\n  receiveMessages(maxMessageCount: number, options?: { maxWaitTimeInMs?: number }): Promise<AsbReceivedMessage[]>;\n  completeMessage(message: AsbReceivedMessage): Promise<void>;\n  abandonMessage(message: AsbReceivedMessage): Promise<void>;\n}\n\n// --- Native projection (contract §4.2–§4.3) ------------------------------------\n\n/**\n * Project the envelope's contract fields onto a native Service Bus message — `subject`\n * = URN, `correlationId` = trace_id, `messageId` = meta.id, plus the `bq-` application\n * properties. The body stays authoritative.\n */\nexport function toServiceBusMessage(envelope: Envelope): AsbMessage {\n  const applicationProperties: { [key: string]: number | boolean | string } = {};\n  if (envelope.meta.schema_version != null) {\n    applicationProperties[\"bq-schema-version\"] = envelope.meta.schema_version;\n  }\n  if (envelope.meta.lang) applicationProperties[\"bq-source-lang\"] = envelope.meta.lang;\n  if (envelope.meta.created_at != null) {\n    applicationProperties[\"bq-created-at\"] = envelope.meta.created_at;\n  }\n\n  const message: AsbMessage = {\n    body: EnvelopeCodec.encode(envelope),\n    contentType: \"application/json\",\n  };\n  if (envelope.job) message.subject = envelope.job;\n  if (envelope.trace_id) message.correlationId = envelope.trace_id;\n  if (envelope.meta.id) message.messageId = envelope.meta.id;\n  if (Object.keys(applicationProperties).length > 0) {\n    message.applicationProperties = applicationProperties;\n  }\n  return message;\n}\n\n// --- Publisher -----------------------------------------------------------------\n\n/** Options for {@link AsbPublisher.publish}. */\nexport interface PublishOptions {\n  /** Reuse an existing trace id (trace continuation). */\n  traceId?: string;\n  /** Schedule native delayed delivery this many milliseconds from now (`scheduledEnqueueTimeUtc`). */\n  delayMs?: number;\n}\n\n/** Sends canonical-envelope messages to one Service Bus entity with the §4 native projection. */\nexport class AsbPublisher {\n  constructor(private readonly sender: AsbSender) {}\n\n  /**\n   * Build the canonical envelope for `(urn, data)`, send it with the native projection,\n   * and return the message id (`meta.id`). A positive `delayMs` schedules native delayed\n   * delivery.\n   */\n  async publish(\n    urn: string,\n    data: Record<string, unknown>,\n    options: PublishOptions = {},\n  ): Promise<string> {\n    const envelope = EnvelopeCodec.make(urn, data, {\n      queue: this.sender.entityPath,\n      traceId: options.traceId,\n    });\n    const message = toServiceBusMessage(envelope);\n\n    if (options.delayMs != null && options.delayMs > 0) {\n      message.applicationProperties = { ...message.applicationProperties, \"bq-delay\": options.delayMs };\n      await this.sender.scheduleMessages(message, new Date(Date.now() + options.delayMs));\n    } else {\n      await this.sender.sendMessages(message);\n    }\n    return envelope.meta.id;\n  }\n}\n\n// --- Consumer ------------------------------------------------------------------\n\n/** A URN handler. Receives the validated envelope and the raw Service Bus message. */\nexport type BabelHandler = (envelope: Envelope, message: AsbReceivedMessage) => unknown | Promise<unknown>;\n\n/** A map of URN → handler. */\nexport type BabelHandlers = Record<string, BabelHandler>;\n\n/** Options for {@link AsbConsumer}. */\nexport interface AsbConsumerOptions {\n  /** Called instead of erroring when a message's URN has no handler (then the message is completed). */\n  onUnknownUrn?: (envelope: IncomingEnvelope, message: AsbReceivedMessage) => unknown | Promise<unknown>;\n  /** Called for a non-conformant envelope, an unmapped URN (no `onUnknownUrn`), or a throwing handler. The loop never stops. */\n  onError?: (error: unknown, envelope: IncomingEnvelope, message: AsbReceivedMessage) => void;\n  /** Max messages per receive (default 10). */\n  maxMessages?: number;\n  /** Max time to wait for a batch, in ms. */\n  maxWaitTimeInMs?: number;\n}\n\n/**\n * Receives from a Service Bus entity (PeekLock), decodes + validates each message, routes\n * it to the handler for its URN, and completes it on success. A throwing handler abandons\n * the message — the broker redelivers it and increments `deliveryCount` (at-least-once);\n * `attempts` is reconciled to `deliveryCount − 1` for the handler.\n */\nexport class AsbConsumer {\n  constructor(\n    private readonly receiver: AsbReceiver,\n    private readonly handlers: BabelHandlers,\n    private readonly options: AsbConsumerOptions = {},\n  ) {}\n\n  /** Receive one batch, route each message, settle each. Returns the batch size. */\n  async poll(): Promise<number> {\n    const messages = await this.receiver.receiveMessages(\n      this.options.maxMessages ?? 10,\n      this.options.maxWaitTimeInMs != null ? { maxWaitTimeInMs: this.options.maxWaitTimeInMs } : undefined,\n    );\n    for (const message of messages) {\n      await this.handle(message);\n    }\n    return messages.length;\n  }\n\n  /** Poll until `signal` aborts. */\n  async run(signal?: AbortSignal): Promise<void> {\n    while (signal?.aborted !== true) {\n      await this.poll();\n    }\n  }\n\n  private async handle(message: AsbReceivedMessage): Promise<void> {\n    const raw = typeof message.body === \"string\" ? message.body : String(message.body ?? \"\");\n    const envelope = EnvelopeCodec.decode(raw);\n\n    // attempts = max(current, deliveryCount − 1): deliveryCount (1-based) is the native\n    // redelivery floor; the max never lowers a higher body count republished from another SDK.\n    const deliveryCount = typeof message.deliveryCount === \"number\" ? message.deliveryCount : 0;\n    const native = deliveryCount - 1;\n    const current = typeof envelope.attempts === \"number\" ? envelope.attempts : 0;\n    if (native > current) {\n      envelope.attempts = native;\n    }\n\n    if (!EnvelopeCodec.accepts(envelope)) {\n      this.options.onError?.(\n        new BabelQueueError(\"Rejected a non-conformant BabelQueue envelope from Azure Service Bus.\"),\n        envelope,\n        message,\n      );\n      await this.receiver.abandonMessage(message);\n      return;\n    }\n\n    const urn = EnvelopeCodec.urn(envelope);\n    const handler = this.handlers[urn];\n    if (!handler) {\n      if (this.options.onUnknownUrn) {\n        await this.options.onUnknownUrn(envelope, message);\n        await this.receiver.completeMessage(message);\n      } else {\n        this.options.onError?.(new UnknownUrnError(urn), envelope, message);\n        await this.receiver.abandonMessage(message);\n      }\n      return;\n    }\n\n    try {\n      await handler(envelope, message);\n      await this.receiver.completeMessage(message);\n    } catch (error) {\n      // Abandon releases the lock — the broker redelivers and increments deliveryCount.\n      this.options.onError?.(error, envelope, message);\n      await this.receiver.abandonMessage(message);\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,131 @@
+import { Envelope, IncomingEnvelope } from '@babelqueue/core';
+
+/**
+ * Azure Service Bus adapter for BabelQueue.
+ *
+ * A canonical-envelope **publisher** and a URN-routed **consumer** over Azure Service
+ * Bus, so an ASB-based Node service speaks the same contract (envelope shape, URN
+ * identity, trace propagation) as the .NET, Java, Python and Go SDKs.
+ *
+ *     import { ServiceBusClient } from "@azure/service-bus";
+ *     import { AsbPublisher, AsbConsumer } from "@babelqueue/azure-service-bus";
+ *
+ *     const client = new ServiceBusClient(connectionString);
+ *     await new AsbPublisher(client.createSender("orders"))
+ *       .publish("urn:babel:orders:created", { order_id: 1042 });
+ *
+ *     const consumer = new AsbConsumer(client.createReceiver("orders"), {
+ *       "urn:babel:orders:created": async (env) => { ... },
+ *     });
+ *     await consumer.run();
+ *
+ * This implements §4 of the broker-bindings contract: the canonical envelope is the
+ * message body, projected onto native Service Bus fields (`subject` = URN,
+ * `correlationId` = trace_id, `messageId` = meta.id, plus the `bq-` application
+ * properties). The envelope is unchanged (`schema_version` stays 1); ASB is purely
+ * additive. Retry is broker-native — a failed handler `abandon`s the message, so it is
+ * redelivered and `deliveryCount` is incremented; the authoritative attempt count is the
+ * native `deliveryCount`, surfaced to handlers as `attempts = deliveryCount − 1`.
+ */
+
+/** A message to send (structural subset of @azure/service-bus `ServiceBusMessage`). */
+interface AsbMessage {
+    body: unknown;
+    subject?: string;
+    correlationId?: string;
+    messageId?: string;
+    contentType?: string;
+    applicationProperties?: {
+        [key: string]: number | boolean | string | Date | null;
+    };
+    scheduledEnqueueTimeUtc?: Date;
+}
+/** A received message (structural subset of @azure/service-bus `ServiceBusReceivedMessage`). */
+interface AsbReceivedMessage {
+    body: unknown;
+    subject?: string;
+    correlationId?: string;
+    messageId?: string;
+    deliveryCount?: number;
+    applicationProperties?: {
+        [key: string]: unknown;
+    };
+}
+/**
+ * The subset of the Service Bus sender this adapter calls. A `ServiceBusSender` from
+ * `@azure/service-bus` satisfies it structurally; a fake satisfies it in tests.
+ */
+interface AsbSender {
+    entityPath: string;
+    sendMessages(message: AsbMessage): Promise<void>;
+    scheduleMessages(message: AsbMessage, scheduledEnqueueTimeUtc: Date): Promise<bigint[]>;
+}
+/**
+ * The subset of the Service Bus receiver this adapter calls. A `ServiceBusReceiver`
+ * from `@azure/service-bus` satisfies it structurally; a fake satisfies it in tests.
+ */
+interface AsbReceiver {
+    receiveMessages(maxMessageCount: number, options?: {
+        maxWaitTimeInMs?: number;
+    }): Promise<AsbReceivedMessage[]>;
+    completeMessage(message: AsbReceivedMessage): Promise<void>;
+    abandonMessage(message: AsbReceivedMessage): Promise<void>;
+}
+/**
+ * Project the envelope's contract fields onto a native Service Bus message — `subject`
+ * = URN, `correlationId` = trace_id, `messageId` = meta.id, plus the `bq-` application
+ * properties. The body stays authoritative.
+ */
+declare function toServiceBusMessage(envelope: Envelope): AsbMessage;
+/** Options for {@link AsbPublisher.publish}. */
+interface PublishOptions {
+    /** Reuse an existing trace id (trace continuation). */
+    traceId?: string;
+    /** Schedule native delayed delivery this many milliseconds from now (`scheduledEnqueueTimeUtc`). */
+    delayMs?: number;
+}
+/** Sends canonical-envelope messages to one Service Bus entity with the §4 native projection. */
+declare class AsbPublisher {
+    private readonly sender;
+    constructor(sender: AsbSender);
+    /**
+     * Build the canonical envelope for `(urn, data)`, send it with the native projection,
+     * and return the message id (`meta.id`). A positive `delayMs` schedules native delayed
+     * delivery.
+     */
+    publish(urn: string, data: Record<string, unknown>, options?: PublishOptions): Promise<string>;
+}
+/** A URN handler. Receives the validated envelope and the raw Service Bus message. */
+type BabelHandler = (envelope: Envelope, message: AsbReceivedMessage) => unknown | Promise<unknown>;
+/** A map of URN → handler. */
+type BabelHandlers = Record<string, BabelHandler>;
+/** Options for {@link AsbConsumer}. */
+interface AsbConsumerOptions {
+    /** Called instead of erroring when a message's URN has no handler (then the message is completed). */
+    onUnknownUrn?: (envelope: IncomingEnvelope, message: AsbReceivedMessage) => unknown | Promise<unknown>;
+    /** Called for a non-conformant envelope, an unmapped URN (no `onUnknownUrn`), or a throwing handler. The loop never stops. */
+    onError?: (error: unknown, envelope: IncomingEnvelope, message: AsbReceivedMessage) => void;
+    /** Max messages per receive (default 10). */
+    maxMessages?: number;
+    /** Max time to wait for a batch, in ms. */
+    maxWaitTimeInMs?: number;
+}
+/**
+ * Receives from a Service Bus entity (PeekLock), decodes + validates each message, routes
+ * it to the handler for its URN, and completes it on success. A throwing handler abandons
+ * the message — the broker redelivers it and increments `deliveryCount` (at-least-once);
+ * `attempts` is reconciled to `deliveryCount − 1` for the handler.
+ */
+declare class AsbConsumer {
+    private readonly receiver;
+    private readonly handlers;
+    private readonly options;
+    constructor(receiver: AsbReceiver, handlers: BabelHandlers, options?: AsbConsumerOptions);
+    /** Receive one batch, route each message, settle each. Returns the batch size. */
+    poll(): Promise<number>;
+    /** Poll until `signal` aborts. */
+    run(signal?: AbortSignal): Promise<void>;
+    private handle;
+}
+
+export { AsbConsumer, type AsbConsumerOptions, type AsbMessage, AsbPublisher, type AsbReceivedMessage, type AsbReceiver, type AsbSender, type BabelHandler, type BabelHandlers, type PublishOptions, toServiceBusMessage };

package/dist/index.d.ts

@@ -0,0 +1,131 @@
+import { Envelope, IncomingEnvelope } from '@babelqueue/core';
+
+/**
+ * Azure Service Bus adapter for BabelQueue.
+ *
+ * A canonical-envelope **publisher** and a URN-routed **consumer** over Azure Service
+ * Bus, so an ASB-based Node service speaks the same contract (envelope shape, URN
+ * identity, trace propagation) as the .NET, Java, Python and Go SDKs.
+ *
+ *     import { ServiceBusClient } from "@azure/service-bus";
+ *     import { AsbPublisher, AsbConsumer } from "@babelqueue/azure-service-bus";
+ *
+ *     const client = new ServiceBusClient(connectionString);
+ *     await new AsbPublisher(client.createSender("orders"))
+ *       .publish("urn:babel:orders:created", { order_id: 1042 });
+ *
+ *     const consumer = new AsbConsumer(client.createReceiver("orders"), {
+ *       "urn:babel:orders:created": async (env) => { ... },
+ *     });
+ *     await consumer.run();
+ *
+ * This implements §4 of the broker-bindings contract: the canonical envelope is the
+ * message body, projected onto native Service Bus fields (`subject` = URN,
+ * `correlationId` = trace_id, `messageId` = meta.id, plus the `bq-` application
+ * properties). The envelope is unchanged (`schema_version` stays 1); ASB is purely
+ * additive. Retry is broker-native — a failed handler `abandon`s the message, so it is
+ * redelivered and `deliveryCount` is incremented; the authoritative attempt count is the
+ * native `deliveryCount`, surfaced to handlers as `attempts = deliveryCount − 1`.
+ */
+
+/** A message to send (structural subset of @azure/service-bus `ServiceBusMessage`). */
+interface AsbMessage {
+    body: unknown;
+    subject?: string;
+    correlationId?: string;
+    messageId?: string;
+    contentType?: string;
+    applicationProperties?: {
+        [key: string]: number | boolean | string | Date | null;
+    };
+    scheduledEnqueueTimeUtc?: Date;
+}
+/** A received message (structural subset of @azure/service-bus `ServiceBusReceivedMessage`). */
+interface AsbReceivedMessage {
+    body: unknown;
+    subject?: string;
+    correlationId?: string;
+    messageId?: string;
+    deliveryCount?: number;
+    applicationProperties?: {
+        [key: string]: unknown;
+    };
+}
+/**
+ * The subset of the Service Bus sender this adapter calls. A `ServiceBusSender` from
+ * `@azure/service-bus` satisfies it structurally; a fake satisfies it in tests.
+ */
+interface AsbSender {
+    entityPath: string;
+    sendMessages(message: AsbMessage): Promise<void>;
+    scheduleMessages(message: AsbMessage, scheduledEnqueueTimeUtc: Date): Promise<bigint[]>;
+}
+/**
+ * The subset of the Service Bus receiver this adapter calls. A `ServiceBusReceiver`
+ * from `@azure/service-bus` satisfies it structurally; a fake satisfies it in tests.
+ */
+interface AsbReceiver {
+    receiveMessages(maxMessageCount: number, options?: {
+        maxWaitTimeInMs?: number;
+    }): Promise<AsbReceivedMessage[]>;
+    completeMessage(message: AsbReceivedMessage): Promise<void>;
+    abandonMessage(message: AsbReceivedMessage): Promise<void>;
+}
+/**
+ * Project the envelope's contract fields onto a native Service Bus message — `subject`
+ * = URN, `correlationId` = trace_id, `messageId` = meta.id, plus the `bq-` application
+ * properties. The body stays authoritative.
+ */
+declare function toServiceBusMessage(envelope: Envelope): AsbMessage;
+/** Options for {@link AsbPublisher.publish}. */
+interface PublishOptions {
+    /** Reuse an existing trace id (trace continuation). */
+    traceId?: string;
+    /** Schedule native delayed delivery this many milliseconds from now (`scheduledEnqueueTimeUtc`). */
+    delayMs?: number;
+}
+/** Sends canonical-envelope messages to one Service Bus entity with the §4 native projection. */
+declare class AsbPublisher {
+    private readonly sender;
+    constructor(sender: AsbSender);
+    /**
+     * Build the canonical envelope for `(urn, data)`, send it with the native projection,
+     * and return the message id (`meta.id`). A positive `delayMs` schedules native delayed
+     * delivery.
+     */
+    publish(urn: string, data: Record<string, unknown>, options?: PublishOptions): Promise<string>;
+}
+/** A URN handler. Receives the validated envelope and the raw Service Bus message. */
+type BabelHandler = (envelope: Envelope, message: AsbReceivedMessage) => unknown | Promise<unknown>;
+/** A map of URN → handler. */
+type BabelHandlers = Record<string, BabelHandler>;
+/** Options for {@link AsbConsumer}. */
+interface AsbConsumerOptions {
+    /** Called instead of erroring when a message's URN has no handler (then the message is completed). */
+    onUnknownUrn?: (envelope: IncomingEnvelope, message: AsbReceivedMessage) => unknown | Promise<unknown>;
+    /** Called for a non-conformant envelope, an unmapped URN (no `onUnknownUrn`), or a throwing handler. The loop never stops. */
+    onError?: (error: unknown, envelope: IncomingEnvelope, message: AsbReceivedMessage) => void;
+    /** Max messages per receive (default 10). */
+    maxMessages?: number;
+    /** Max time to wait for a batch, in ms. */
+    maxWaitTimeInMs?: number;
+}
+/**
+ * Receives from a Service Bus entity (PeekLock), decodes + validates each message, routes
+ * it to the handler for its URN, and completes it on success. A throwing handler abandons
+ * the message — the broker redelivers it and increments `deliveryCount` (at-least-once);
+ * `attempts` is reconciled to `deliveryCount − 1` for the handler.
+ */
+declare class AsbConsumer {
+    private readonly receiver;
+    private readonly handlers;
+    private readonly options;
+    constructor(receiver: AsbReceiver, handlers: BabelHandlers, options?: AsbConsumerOptions);
+    /** Receive one batch, route each message, settle each. Returns the batch size. */
+    poll(): Promise<number>;
+    /** Poll until `signal` aborts. */
+    run(signal?: AbortSignal): Promise<void>;
+    private handle;
+}
+
+export { AsbConsumer, type AsbConsumerOptions, type AsbMessage, AsbPublisher, type AsbReceivedMessage, type AsbReceiver, type AsbSender, type BabelHandler, type BabelHandlers, type PublishOptions, toServiceBusMessage };

package/dist/index.js

@@ -0,0 +1,119 @@
+// src/index.ts
+import { BabelQueueError, EnvelopeCodec, UnknownUrnError } from "@babelqueue/core";
+function toServiceBusMessage(envelope) {
+  const applicationProperties = {};
+  if (envelope.meta.schema_version != null) {
+    applicationProperties["bq-schema-version"] = envelope.meta.schema_version;
+  }
+  if (envelope.meta.lang) applicationProperties["bq-source-lang"] = envelope.meta.lang;
+  if (envelope.meta.created_at != null) {
+    applicationProperties["bq-created-at"] = envelope.meta.created_at;
+  }
+  const message = {
+    body: EnvelopeCodec.encode(envelope),
+    contentType: "application/json"
+  };
+  if (envelope.job) message.subject = envelope.job;
+  if (envelope.trace_id) message.correlationId = envelope.trace_id;
+  if (envelope.meta.id) message.messageId = envelope.meta.id;
+  if (Object.keys(applicationProperties).length > 0) {
+    message.applicationProperties = applicationProperties;
+  }
+  return message;
+}
+var AsbPublisher = class {
+  constructor(sender) {
+    this.sender = sender;
+  }
+  sender;
+  /**
+   * Build the canonical envelope for `(urn, data)`, send it with the native projection,
+   * and return the message id (`meta.id`). A positive `delayMs` schedules native delayed
+   * delivery.
+   */
+  async publish(urn, data, options = {}) {
+    const envelope = EnvelopeCodec.make(urn, data, {
+      queue: this.sender.entityPath,
+      traceId: options.traceId
+    });
+    const message = toServiceBusMessage(envelope);
+    if (options.delayMs != null && options.delayMs > 0) {
+      message.applicationProperties = { ...message.applicationProperties, "bq-delay": options.delayMs };
+      await this.sender.scheduleMessages(message, new Date(Date.now() + options.delayMs));
+    } else {
+      await this.sender.sendMessages(message);
+    }
+    return envelope.meta.id;
+  }
+};
+var AsbConsumer = class {
+  constructor(receiver, handlers, options = {}) {
+    this.receiver = receiver;
+    this.handlers = handlers;
+    this.options = options;
+  }
+  receiver;
+  handlers;
+  options;
+  /** Receive one batch, route each message, settle each. Returns the batch size. */
+  async poll() {
+    const messages = await this.receiver.receiveMessages(
+      this.options.maxMessages ?? 10,
+      this.options.maxWaitTimeInMs != null ? { maxWaitTimeInMs: this.options.maxWaitTimeInMs } : void 0
+    );
+    for (const message of messages) {
+      await this.handle(message);
+    }
+    return messages.length;
+  }
+  /** Poll until `signal` aborts. */
+  async run(signal) {
+    while (signal?.aborted !== true) {
+      await this.poll();
+    }
+  }
+  async handle(message) {
+    const raw = typeof message.body === "string" ? message.body : String(message.body ?? "");
+    const envelope = EnvelopeCodec.decode(raw);
+    const deliveryCount = typeof message.deliveryCount === "number" ? message.deliveryCount : 0;
+    const native = deliveryCount - 1;
+    const current = typeof envelope.attempts === "number" ? envelope.attempts : 0;
+    if (native > current) {
+      envelope.attempts = native;
+    }
+    if (!EnvelopeCodec.accepts(envelope)) {
+      this.options.onError?.(
+        new BabelQueueError("Rejected a non-conformant BabelQueue envelope from Azure Service Bus."),
+        envelope,
+        message
+      );
+      await this.receiver.abandonMessage(message);
+      return;
+    }
+    const urn = EnvelopeCodec.urn(envelope);
+    const handler = this.handlers[urn];
+    if (!handler) {
+      if (this.options.onUnknownUrn) {
+        await this.options.onUnknownUrn(envelope, message);
+        await this.receiver.completeMessage(message);
+      } else {
+        this.options.onError?.(new UnknownUrnError(urn), envelope, message);
+        await this.receiver.abandonMessage(message);
+      }
+      return;
+    }
+    try {
+      await handler(envelope, message);
+      await this.receiver.completeMessage(message);
+    } catch (error) {
+      this.options.onError?.(error, envelope, message);
+      await this.receiver.abandonMessage(message);
+    }
+  }
+};
+export {
+  AsbConsumer,
+  AsbPublisher,
+  toServiceBusMessage
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Azure Service Bus adapter for BabelQueue.\n *\n * A canonical-envelope **publisher** and a URN-routed **consumer** over Azure Service\n * Bus, so an ASB-based Node service speaks the same contract (envelope shape, URN\n * identity, trace propagation) as the .NET, Java, Python and Go SDKs.\n *\n *     import { ServiceBusClient } from \"@azure/service-bus\";\n *     import { AsbPublisher, AsbConsumer } from \"@babelqueue/azure-service-bus\";\n *\n *     const client = new ServiceBusClient(connectionString);\n *     await new AsbPublisher(client.createSender(\"orders\"))\n *       .publish(\"urn:babel:orders:created\", { order_id: 1042 });\n *\n *     const consumer = new AsbConsumer(client.createReceiver(\"orders\"), {\n *       \"urn:babel:orders:created\": async (env) => { ... },\n *     });\n *     await consumer.run();\n *\n * This implements §4 of the broker-bindings contract: the canonical envelope is the\n * message body, projected onto native Service Bus fields (`subject` = URN,\n * `correlationId` = trace_id, `messageId` = meta.id, plus the `bq-` application\n * properties). The envelope is unchanged (`schema_version` stays 1); ASB is purely\n * additive. Retry is broker-native — a failed handler `abandon`s the message, so it is\n * redelivered and `deliveryCount` is incremented; the authoritative attempt count is the\n * native `deliveryCount`, surfaced to handlers as `attempts = deliveryCount − 1`.\n */\n\nimport { BabelQueueError, EnvelopeCodec, UnknownUrnError } from \"@babelqueue/core\";\nimport type { Envelope, IncomingEnvelope } from \"@babelqueue/core\";\n\n// --- Minimal Service Bus shapes (a structural subset of @azure/service-bus) -----\n\n/** A message to send (structural subset of @azure/service-bus `ServiceBusMessage`). */\nexport interface AsbMessage {\n  body: unknown;\n  subject?: string;\n  correlationId?: string;\n  messageId?: string;\n  contentType?: string;\n  applicationProperties?: { [key: string]: number | boolean | string | Date | null };\n  scheduledEnqueueTimeUtc?: Date;\n}\n\n/** A received message (structural subset of @azure/service-bus `ServiceBusReceivedMessage`). */\nexport interface AsbReceivedMessage {\n  body: unknown;\n  subject?: string;\n  correlationId?: string;\n  messageId?: string;\n  deliveryCount?: number;\n  applicationProperties?: { [key: string]: unknown };\n}\n\n/**\n * The subset of the Service Bus sender this adapter calls. A `ServiceBusSender` from\n * `@azure/service-bus` satisfies it structurally; a fake satisfies it in tests.\n */\nexport interface AsbSender {\n  entityPath: string;\n  sendMessages(message: AsbMessage): Promise<void>;\n  scheduleMessages(message: AsbMessage, scheduledEnqueueTimeUtc: Date): Promise<bigint[]>;\n}\n\n/**\n * The subset of the Service Bus receiver this adapter calls. A `ServiceBusReceiver`\n * from `@azure/service-bus` satisfies it structurally; a fake satisfies it in tests.\n */\nexport interface AsbReceiver {\n  receiveMessages(maxMessageCount: number, options?: { maxWaitTimeInMs?: number }): Promise<AsbReceivedMessage[]>;\n  completeMessage(message: AsbReceivedMessage): Promise<void>;\n  abandonMessage(message: AsbReceivedMessage): Promise<void>;\n}\n\n// --- Native projection (contract §4.2–§4.3) ------------------------------------\n\n/**\n * Project the envelope's contract fields onto a native Service Bus message — `subject`\n * = URN, `correlationId` = trace_id, `messageId` = meta.id, plus the `bq-` application\n * properties. The body stays authoritative.\n */\nexport function toServiceBusMessage(envelope: Envelope): AsbMessage {\n  const applicationProperties: { [key: string]: number | boolean | string } = {};\n  if (envelope.meta.schema_version != null) {\n    applicationProperties[\"bq-schema-version\"] = envelope.meta.schema_version;\n  }\n  if (envelope.meta.lang) applicationProperties[\"bq-source-lang\"] = envelope.meta.lang;\n  if (envelope.meta.created_at != null) {\n    applicationProperties[\"bq-created-at\"] = envelope.meta.created_at;\n  }\n\n  const message: AsbMessage = {\n    body: EnvelopeCodec.encode(envelope),\n    contentType: \"application/json\",\n  };\n  if (envelope.job) message.subject = envelope.job;\n  if (envelope.trace_id) message.correlationId = envelope.trace_id;\n  if (envelope.meta.id) message.messageId = envelope.meta.id;\n  if (Object.keys(applicationProperties).length > 0) {\n    message.applicationProperties = applicationProperties;\n  }\n  return message;\n}\n\n// --- Publisher -----------------------------------------------------------------\n\n/** Options for {@link AsbPublisher.publish}. */\nexport interface PublishOptions {\n  /** Reuse an existing trace id (trace continuation). */\n  traceId?: string;\n  /** Schedule native delayed delivery this many milliseconds from now (`scheduledEnqueueTimeUtc`). */\n  delayMs?: number;\n}\n\n/** Sends canonical-envelope messages to one Service Bus entity with the §4 native projection. */\nexport class AsbPublisher {\n  constructor(private readonly sender: AsbSender) {}\n\n  /**\n   * Build the canonical envelope for `(urn, data)`, send it with the native projection,\n   * and return the message id (`meta.id`). A positive `delayMs` schedules native delayed\n   * delivery.\n   */\n  async publish(\n    urn: string,\n    data: Record<string, unknown>,\n    options: PublishOptions = {},\n  ): Promise<string> {\n    const envelope = EnvelopeCodec.make(urn, data, {\n      queue: this.sender.entityPath,\n      traceId: options.traceId,\n    });\n    const message = toServiceBusMessage(envelope);\n\n    if (options.delayMs != null && options.delayMs > 0) {\n      message.applicationProperties = { ...message.applicationProperties, \"bq-delay\": options.delayMs };\n      await this.sender.scheduleMessages(message, new Date(Date.now() + options.delayMs));\n    } else {\n      await this.sender.sendMessages(message);\n    }\n    return envelope.meta.id;\n  }\n}\n\n// --- Consumer ------------------------------------------------------------------\n\n/** A URN handler. Receives the validated envelope and the raw Service Bus message. */\nexport type BabelHandler = (envelope: Envelope, message: AsbReceivedMessage) => unknown | Promise<unknown>;\n\n/** A map of URN → handler. */\nexport type BabelHandlers = Record<string, BabelHandler>;\n\n/** Options for {@link AsbConsumer}. */\nexport interface AsbConsumerOptions {\n  /** Called instead of erroring when a message's URN has no handler (then the message is completed). */\n  onUnknownUrn?: (envelope: IncomingEnvelope, message: AsbReceivedMessage) => unknown | Promise<unknown>;\n  /** Called for a non-conformant envelope, an unmapped URN (no `onUnknownUrn`), or a throwing handler. The loop never stops. */\n  onError?: (error: unknown, envelope: IncomingEnvelope, message: AsbReceivedMessage) => void;\n  /** Max messages per receive (default 10). */\n  maxMessages?: number;\n  /** Max time to wait for a batch, in ms. */\n  maxWaitTimeInMs?: number;\n}\n\n/**\n * Receives from a Service Bus entity (PeekLock), decodes + validates each message, routes\n * it to the handler for its URN, and completes it on success. A throwing handler abandons\n * the message — the broker redelivers it and increments `deliveryCount` (at-least-once);\n * `attempts` is reconciled to `deliveryCount − 1` for the handler.\n */\nexport class AsbConsumer {\n  constructor(\n    private readonly receiver: AsbReceiver,\n    private readonly handlers: BabelHandlers,\n    private readonly options: AsbConsumerOptions = {},\n  ) {}\n\n  /** Receive one batch, route each message, settle each. Returns the batch size. */\n  async poll(): Promise<number> {\n    const messages = await this.receiver.receiveMessages(\n      this.options.maxMessages ?? 10,\n      this.options.maxWaitTimeInMs != null ? { maxWaitTimeInMs: this.options.maxWaitTimeInMs } : undefined,\n    );\n    for (const message of messages) {\n      await this.handle(message);\n    }\n    return messages.length;\n  }\n\n  /** Poll until `signal` aborts. */\n  async run(signal?: AbortSignal): Promise<void> {\n    while (signal?.aborted !== true) {\n      await this.poll();\n    }\n  }\n\n  private async handle(message: AsbReceivedMessage): Promise<void> {\n    const raw = typeof message.body === \"string\" ? message.body : String(message.body ?? \"\");\n    const envelope = EnvelopeCodec.decode(raw);\n\n    // attempts = max(current, deliveryCount − 1): deliveryCount (1-based) is the native\n    // redelivery floor; the max never lowers a higher body count republished from another SDK.\n    const deliveryCount = typeof message.deliveryCount === \"number\" ? message.deliveryCount : 0;\n    const native = deliveryCount - 1;\n    const current = typeof envelope.attempts === \"number\" ? envelope.attempts : 0;\n    if (native > current) {\n      envelope.attempts = native;\n    }\n\n    if (!EnvelopeCodec.accepts(envelope)) {\n      this.options.onError?.(\n        new BabelQueueError(\"Rejected a non-conformant BabelQueue envelope from Azure Service Bus.\"),\n        envelope,\n        message,\n      );\n      await this.receiver.abandonMessage(message);\n      return;\n    }\n\n    const urn = EnvelopeCodec.urn(envelope);\n    const handler = this.handlers[urn];\n    if (!handler) {\n      if (this.options.onUnknownUrn) {\n        await this.options.onUnknownUrn(envelope, message);\n        await this.receiver.completeMessage(message);\n      } else {\n        this.options.onError?.(new UnknownUrnError(urn), envelope, message);\n        await this.receiver.abandonMessage(message);\n      }\n      return;\n    }\n\n    try {\n      await handler(envelope, message);\n      await this.receiver.completeMessage(message);\n    } catch (error) {\n      // Abandon releases the lock — the broker redelivers and increments deliveryCount.\n      this.options.onError?.(error, envelope, message);\n      await this.receiver.abandonMessage(message);\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@babelqueue/azure-service-bus",
+  "version": "1.0.0",
+  "description": "Azure Service Bus adapter for BabelQueue — canonical-envelope publisher and a URN-routed consumer.",
+  "keywords": ["babelqueue", "azure", "servicebus", "asb", "queue", "polyglot", "messaging"],
+  "homepage": "https://babelqueue.com",
+  "bugs": {
+    "url": "https://github.com/BabelQueue/babelqueue-node-adapters/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BabelQueue/babelqueue-node-adapters.git",
+    "directory": "packages/azure-service-bus"
+  },
+  "license": "MIT",
+  "author": "Muhammet Şafak <info@muhammetsafak.com.tr>",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist"],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "node --import tsx --test test/*.test.ts"
+  },
+  "dependencies": {
+    "@babelqueue/core": "^1.0.0"
+  },
+  "peerDependencies": {
+    "@azure/service-bus": "^7.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@azure/service-bus": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}