@babelqueue/artemis 1.0.0

package/README.md

@@ -0,0 +1,105 @@
+# @babelqueue/artemis
+
+Apache ActiveMQ Artemis adapter for [BabelQueue](https://babelqueue.com) — a canonical-envelope
+**publisher** and a URN-routed **AMQP 1.0** consumer over [rhea](https://github.com/amqp/rhea),
+so an Artemis-based Node service speaks the same wire contract (envelope shape, URN identity,
+trace propagation) as the Java, .NET, Python and Go SDKs. Implements
+[§7 of the broker-bindings contract](https://babelqueue.com/docs/spec/1.x/broker-bindings#apache-activemq-artemis).
+
+Artemis speaks AMQP 1.0 (not RabbitMQ's 0-9-1) and gives the binding native primitives —
+per-message settlement, scheduled delivery, a delivery counter and a dead-letter address — so
+this adapter maps onto them (the envelope stays `schema_version: 1`):
+
+- the envelope JSON is the message **body**; the contract fields are mirrored onto the AMQP a JMS
+  peer reads — `correlation-id` = `trace_id`, `creation-time` = `meta.created_at`, the
+  `x-opt-jms-type` annotation = URN (so a Java/JMS or AMQP consumer routes without decoding the
+  body) — plus the `bq-` application properties;
+- consume settles per message: **`accept` after success**; a throwing handler **`release`s** the
+  message so the broker redelivers it (incrementing the AMQP `delivery-count`);
+- **`attempts = max(body, delivery-count)`** — the AMQP delivery-count is 0-based (0 on first
+  delivery), so it maps directly with no −1 (the Java JMS binding reads the 1-based
+  `JMSXDeliveryCount` and subtracts 1, arriving at the same 0-based `attempts`);
+- delay uses Artemis's **native** AMQP scheduled delivery (`x-opt-delivery-time`); terminal
+  failures go to an opt-in `<queue>.dlq` with a `dead_letter` block.
+
+## Install
+
+```bash
+npm install @babelqueue/artemis rhea
+```
+
+`rhea` is an optional peer — you provide the sender/receiver; a rhea sender/receiver satisfies
+the adapter structurally.
+
+## Produce
+
+```ts
+import { Container } from "rhea";
+import { ArtemisPublisher } from "@babelqueue/artemis";
+
+const container = new Container();
+const connection = container.connect({ host: "localhost", port: 5672 });
+const sender = connection.open_sender("orders");
+
+const publisher = ArtemisPublisher.create(sender, "orders");
+const id = await publisher.publish("urn:babel:orders:created", { order_id: 1042 });
+```
+
+`publish(urn, data, options?)` returns the message `meta.id`; `options` adds a `traceId` and a
+`delayMs` (native scheduled delivery).
+
+## Consume
+
+```ts
+import { Container } from "rhea";
+import { ArtemisConsumer, type BabelHandlers } from "@babelqueue/artemis";
+
+const receiver = connection.open_receiver({ source: "orders", autoaccept: false, credit_window: 10 });
+const dlqSender = connection.open_sender("orders.dlq");
+
+const handlers: BabelHandlers = {
+  "urn:babel:orders:created": (envelope, message) => {
+    // envelope.data, envelope.trace_id, envelope.attempts ...
+  },
+};
+
+const consumer = new ArtemisConsumer(handlers, {
+  deadLetterSender: dlqSender, // enables the cross-language <queue>.dlq
+  maxTries: 3,
+  onError: (err, envelope, context) => console.error(err),
+});
+
+consumer.listen(receiver); // wires receiver.on("message") → accept / release / dead-letter
+```
+
+A successful handler `accept`s the message. A throwing handler `release`s it (the broker
+redelivers and bumps `delivery-count`); once `maxTries` is reached the envelope goes to
+`<queue>.dlq` with a `dead_letter` block. The consumer routes on the `x-opt-jms-type` annotation
+(falling back to the body URN), so it never decodes a message it cannot handle. Unknown-URN
+strategy is one of `fail` / `delete` / `release` / `dead_letter`.
+
+> `autoaccept: false` is required — the consumer owns the disposition. `handle(context)` is also
+> exposed directly for testing or a custom event wiring.
+
+## Contract mapping (§7)
+
+| Envelope | Apache ActiveMQ Artemis (AMQP 1.0) |
+| :--- | :--- |
+| body | message body (byte-identical across SDKs) |
+| `job` (URN) | `x-opt-jms-type` annotation → JMSType (consumer routes on this) |
+| `trace_id` | `correlation-id` → JMSCorrelationID |
+| `meta.created_at` | `creation-time` → JMSTimestamp (Unix ms) |
+| `meta.schema_version` | application property `bq-schema-version` (`"1"`) |
+| `meta.lang` | application property `bq-source-lang` |
+| `attempts` | `max(body, delivery-count)` (AMQP counter is 0-based) |
+| reserve / ack | message event → process → **`accept`** |
+| retry / delay | `release` redelivery · native `x-opt-delivery-time` |
+| dead-letter | `<queue>.dlq` + `dead_letter` block (alongside the native DLA) |
+
+The `bq-` application-property values are strings (integers as decimal, e.g. `"1"`); `bq-app-id`
+is `"babelqueue"`. The envelope is unchanged (`schema_version` stays `1`); Artemis is purely
+additive.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,202 @@
+"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, {
+  ArtemisConsumer: () => ArtemisConsumer,
+  ArtemisPublisher: () => ArtemisPublisher,
+  JMS_TYPE_KEY: () => JMS_TYPE_KEY,
+  SCHEDULED_DELIVERY_KEY: () => SCHEDULED_DELIVERY_KEY,
+  artemisMessage: () => artemisMessage,
+  messageBody: () => messageBody
+});
+module.exports = __toCommonJS(index_exports);
+var import_core = require("@babelqueue/core");
+var JMS_TYPE_KEY = "x-opt-jms-type";
+var SCHEDULED_DELIVERY_KEY = "x-opt-delivery-time";
+function artemisMessage(envelope, delayMs) {
+  const annotations = {};
+  if (envelope.job) annotations[JMS_TYPE_KEY] = envelope.job;
+  const applicationProperties = {
+    "bq_schema_version": String(envelope.meta.schema_version),
+    "bq_attempts": String(envelope.attempts ?? 0),
+    "bq_app_id": "babelqueue"
+  };
+  if (envelope.meta.lang) applicationProperties["bq_source_lang"] = envelope.meta.lang;
+  const message = {
+    body: import_core.EnvelopeCodec.encode(envelope),
+    content_type: "application/json",
+    application_properties: applicationProperties,
+    message_annotations: annotations
+  };
+  if (envelope.trace_id) message.correlation_id = envelope.trace_id;
+  if (envelope.meta.created_at != null) message.creation_time = envelope.meta.created_at;
+  if (delayMs != null && delayMs > 0) {
+    applicationProperties["bq_delay"] = String(delayMs);
+    annotations[SCHEDULED_DELIVERY_KEY] = Date.now() + delayMs;
+  }
+  return message;
+}
+function messageBody(message) {
+  const body = message.body;
+  if (body == null) return "";
+  if (typeof body === "string") return body;
+  if (Buffer.isBuffer(body)) return body.toString("utf8");
+  if (typeof body === "object" && "content" in body) {
+    const content = body.content;
+    if (Buffer.isBuffer(content)) return content.toString("utf8");
+    if (typeof content === "string") return content;
+  }
+  return String(body);
+}
+function jmsType(message) {
+  const value = message.message_annotations?.[JMS_TYPE_KEY];
+  return value == null ? void 0 : String(value);
+}
+function deliveryCount(message) {
+  const value = message.delivery_count;
+  return typeof value === "number" && value > 0 ? value : 0;
+}
+var ArtemisPublisher = class _ArtemisPublisher {
+  constructor(sender, queue) {
+    this.sender = sender;
+    this.queue = queue;
+  }
+  sender;
+  queue;
+  /** A publisher over a sender bound to `queue` (the address is stamped onto `meta.queue`). */
+  static create(sender, queue) {
+    return new _ArtemisPublisher(sender, queue);
+  }
+  /** Build + send the canonical envelope; returns the message id (`meta.id`). */
+  async publish(urn, data, options = {}) {
+    const envelope = import_core.EnvelopeCodec.make(urn, data, { queue: this.queue, traceId: options.traceId });
+    await this.sender.send(artemisMessage(envelope, options.delayMs));
+    return envelope.meta.id;
+  }
+};
+var ArtemisConsumer = class {
+  constructor(handlers, options = {}) {
+    this.handlers = handlers;
+    this.options = options;
+    this.maxTries = options.maxTries ?? 3;
+    this.unknownUrn = options.unknownUrn ?? import_core.UnknownUrnStrategy.FAIL;
+  }
+  handlers;
+  options;
+  maxTries;
+  unknownUrn;
+  /** Wire this consumer to a rhea receiver's `message` event (auto-accept must be off). */
+  listen(receiver) {
+    receiver.on("message", (context) => this.handle(context));
+  }
+  /** Route + settle one delivery. Exposed for testing. */
+  async handle(context) {
+    const message = context.message ?? {};
+    const delivery = context.delivery;
+    const decoded = import_core.EnvelopeCodec.decode(messageBody(message));
+    if (!import_core.EnvelopeCodec.accepts(decoded)) {
+      this.report(new import_core.BabelQueueError("Rejected a non-conformant BabelQueue envelope from Artemis."), decoded, context);
+      await this.deadLetterRaw(messageBody(message));
+      delivery?.accept();
+      return;
+    }
+    const envelope = this.reconcile(decoded, message);
+    const urn = jmsType(message) ?? import_core.EnvelopeCodec.urn(envelope);
+    const handler = this.handlers[urn];
+    if (!handler) {
+      await this.onUnknownUrn(context, envelope, urn);
+      return;
+    }
+    try {
+      await handler(envelope, message);
+      delivery?.accept();
+    } catch (error) {
+      this.report(error, envelope, context);
+      await this.retryOrDeadLetter(context, envelope, error);
+    }
+  }
+  /** `attempts = max(body, delivery-count)`: the AMQP counter is 0-based, so no −1. */
+  reconcile(envelope, message) {
+    const body = typeof envelope.attempts === "number" ? envelope.attempts : 0;
+    const count = deliveryCount(message);
+    return { ...envelope, attempts: Math.max(body, count) };
+  }
+  async onUnknownUrn(context, envelope, urn) {
+    const delivery = context.delivery;
+    switch (this.unknownUrn) {
+      case import_core.UnknownUrnStrategy.DELETE:
+        delivery?.accept();
+        return;
+      case import_core.UnknownUrnStrategy.DEAD_LETTER:
+        await this.deadLetter(envelope, "unknown_urn");
+        delivery?.accept();
+        return;
+      case import_core.UnknownUrnStrategy.RELEASE:
+        delivery?.release({ delivery_failed: true });
+        return;
+      default: {
+        const error = new import_core.UnknownUrnError(urn);
+        this.report(error, envelope, context);
+        throw error;
+      }
+    }
+  }
+  async retryOrDeadLetter(context, envelope, error) {
+    const delivery = context.delivery;
+    if ((envelope.attempts ?? 0) + 1 < this.maxTries) {
+      delivery?.release({ delivery_failed: true });
+    } else if (this.options.deadLetterSender) {
+      await this.deadLetter(envelope, "failed", error);
+      delivery?.accept();
+    } else {
+      delivery?.accept();
+    }
+  }
+  async deadLetter(envelope, reason, error) {
+    const sender = this.options.deadLetterSender;
+    if (!sender) return;
+    const original = envelope.meta?.queue ?? "";
+    const annotated = (0, import_core.annotate)(envelope, reason, original, {
+      attempts: envelope.attempts ?? 0,
+      error: error instanceof Error ? error.message : null,
+      exception: error instanceof Error ? error.name : null
+    });
+    await sender.send(artemisMessage(annotated));
+  }
+  async deadLetterRaw(raw) {
+    const sender = this.options.deadLetterSender;
+    if (!sender) return;
+    await sender.send({ body: raw });
+  }
+  report(error, envelope, context) {
+    this.options.onError?.(error, envelope, context);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ArtemisConsumer,
+  ArtemisPublisher,
+  JMS_TYPE_KEY,
+  SCHEDULED_DELIVERY_KEY,
+  artemisMessage,
+  messageBody
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Apache ActiveMQ Artemis adapter for BabelQueue.\n *\n * A canonical-envelope **publisher** and a URN-routed **AMQP 1.0** consumer over Artemis (rhea),\n * so an Artemis-based Node service speaks the same contract (envelope shape, URN identity, trace\n * propagation) as the Java, .NET, Python and Go SDKs.\n *\n * Artemis speaks AMQP 1.0 (not RabbitMQ's 0-9-1) and gives the binding native primitives —\n * per-message settlement, scheduled delivery, a delivery counter and a dead-letter address — so\n * this adapter maps onto them (the envelope stays `schema_version: 1`): the envelope JSON is the\n * message **body**; the contract fields are mirrored onto the AMQP a JMS peer reads\n * (`correlation-id` = `trace_id`, `creation-time` = `meta.created_at`, the `x-opt-jms-type`\n * annotation = URN) plus the `bq_` application properties; consume settles per message\n * (`accept` after success, `release` for redelivery); **`attempts = max(body, delivery-count)`**\n * (the AMQP counter is 0-based — no −1); terminal failures go to an opt-in `<queue>.dlq` with a\n * `dead_letter` block.\n *\n * This implements §7 of the broker-bindings contract. `rhea` is an optional peer — you provide\n * the sender/receiver (a rhea sender/receiver satisfies the adapter structurally).\n */\n\nimport { annotate, BabelQueueError, EnvelopeCodec, UnknownUrnError, UnknownUrnStrategy } from \"@babelqueue/core\";\nimport type { Envelope, IncomingEnvelope } from \"@babelqueue/core\";\n\n// --- Minimal AMQP 1.0 shapes (a structural subset of rhea) ---------------------\n\n/** An AMQP message (structural subset of a rhea message). */\nexport interface AmqpMessage {\n  body?: unknown;\n  correlation_id?: unknown;\n  creation_time?: number | Date;\n  content_type?: string;\n  application_properties?: Record<string, unknown>;\n  message_annotations?: Record<string, unknown>;\n  /** The AMQP header delivery-count (0-based: 0 on first delivery). */\n  delivery_count?: number;\n}\n\n/** The disposition handle rhea passes alongside a received message. */\nexport interface AmqpDelivery {\n  /** Settle (acknowledge) the message — it is removed from the queue. */\n  accept(): void;\n  /** Return the message for redelivery — the broker increments `delivery-count`. */\n  release(params?: { delivery_failed?: boolean; undeliverable_here?: boolean }): void;\n}\n\n/** The event context rhea emits on a `message` event. */\nexport interface AmqpEventContext {\n  message?: AmqpMessage;\n  delivery?: AmqpDelivery;\n}\n\n/** The subset of a rhea sender this adapter calls. */\nexport interface AmqpSender {\n  send(message: AmqpMessage): unknown;\n}\n\n/** The subset of a rhea receiver this adapter wires to (its `message` event). */\nexport interface AmqpReceiver {\n  on(event: \"message\", handler: (context: AmqpEventContext) => void): unknown;\n}\n\n// --- Projection (contract §7.2) ------------------------------------------------\n\n/** The message annotation carrying the URN (the AMQP-JMS mapping of `JMSType`). */\nexport const JMS_TYPE_KEY = \"x-opt-jms-type\";\n/** The message annotation Artemis honours for AMQP scheduled delivery (absolute Unix ms). */\nexport const SCHEDULED_DELIVERY_KEY = \"x-opt-delivery-time\";\n\n/**\n * Project the envelope onto the AMQP 1.0 message a JMS peer reads: body = envelope JSON,\n * `correlation-id` = `trace_id`, `creation-time` = `meta.created_at`, the `x-opt-jms-type`\n * annotation = URN, plus the string-valued `bq_` application properties. A positive `delayMs`\n * sets the `x-opt-delivery-time` annotation for native scheduled delivery.\n */\nexport function artemisMessage(envelope: Envelope, delayMs?: number): AmqpMessage {\n  const annotations: Record<string, unknown> = {};\n  if (envelope.job) annotations[JMS_TYPE_KEY] = envelope.job;\n\n  // The bq_ property names use underscores, not hyphens: a JMS property name must be a valid\n  // Java identifier, and every Artemis SDK uses the same JMS-legal form for cross-protocol parity.\n  const applicationProperties: Record<string, unknown> = {\n    \"bq_schema_version\": String(envelope.meta.schema_version),\n    \"bq_attempts\": String(envelope.attempts ?? 0),\n    \"bq_app_id\": \"babelqueue\",\n  };\n  if (envelope.meta.lang) applicationProperties[\"bq_source_lang\"] = envelope.meta.lang;\n\n  const message: AmqpMessage = {\n    body: EnvelopeCodec.encode(envelope),\n    content_type: \"application/json\",\n    application_properties: applicationProperties,\n    message_annotations: annotations,\n  };\n  if (envelope.trace_id) message.correlation_id = envelope.trace_id;\n  if (envelope.meta.created_at != null) message.creation_time = envelope.meta.created_at;\n\n  if (delayMs != null && delayMs > 0) {\n    applicationProperties[\"bq_delay\"] = String(delayMs);\n    annotations[SCHEDULED_DELIVERY_KEY] = Date.now() + delayMs;\n  }\n  return message;\n}\n\n/** The message body as text (AMQP value string, or UTF-8-decoded binary / rhea Data section). */\nexport function messageBody(message: AmqpMessage): string {\n  const body = message.body;\n  if (body == null) return \"\";\n  if (typeof body === \"string\") return body;\n  if (Buffer.isBuffer(body)) return body.toString(\"utf8\");\n  if (typeof body === \"object\" && \"content\" in body) {\n    const content = (body as { content: unknown }).content;\n    if (Buffer.isBuffer(content)) return content.toString(\"utf8\");\n    if (typeof content === \"string\") return content;\n  }\n  return String(body);\n}\n\nfunction jmsType(message: AmqpMessage): string | undefined {\n  const value = message.message_annotations?.[JMS_TYPE_KEY];\n  return value == null ? undefined : String(value);\n}\n\nfunction deliveryCount(message: AmqpMessage): number {\n  const value = message.delivery_count;\n  return typeof value === \"number\" && value > 0 ? value : 0;\n}\n\n// --- Publisher -----------------------------------------------------------------\n\n/** Options for {@link ArtemisPublisher.publish}. */\nexport interface PublishOptions {\n  traceId?: string;\n  /** Schedule via Artemis's native AMQP scheduled delivery (`x-opt-delivery-time`). */\n  delayMs?: number;\n}\n\n/** Sends canonical-envelope messages to one Artemis address with the §7 projection. */\nexport class ArtemisPublisher {\n  private constructor(\n    private readonly sender: AmqpSender,\n    private readonly queue: string,\n  ) {}\n\n  /** A publisher over a sender bound to `queue` (the address is stamped onto `meta.queue`). */\n  static create(sender: AmqpSender, queue: string): ArtemisPublisher {\n    return new ArtemisPublisher(sender, queue);\n  }\n\n  /** Build + send the canonical envelope; returns the message id (`meta.id`). */\n  async publish(urn: string, data: Record<string, unknown>, options: PublishOptions = {}): Promise<string> {\n    const envelope = EnvelopeCodec.make(urn, data, { queue: this.queue, traceId: options.traceId });\n    await this.sender.send(artemisMessage(envelope, options.delayMs));\n    return envelope.meta.id;\n  }\n}\n\n// --- Consumer ------------------------------------------------------------------\n\n/** A URN handler. Receives the validated envelope and the raw AMQP message. */\nexport type BabelHandler = (envelope: Envelope, message: AmqpMessage) => unknown | Promise<unknown>;\n\n/** A map of URN → handler. */\nexport type BabelHandlers = Record<string, BabelHandler>;\n\n/** Options for {@link ArtemisConsumer}. */\nexport interface ArtemisConsumerOptions {\n  /** A sender to `<queue>.dlq`; enables cross-language dead-lettering. Without it a terminal failure drops. */\n  deadLetterSender?: AmqpSender;\n  /** Attempts before terminal dead-lettering (default 3). */\n  maxTries?: number;\n  /** Strategy for a URN with no handler (default `fail`). */\n  unknownUrn?: string;\n  /** Called for a non-conformant message, an unmapped URN, or a throwing handler. */\n  onError?: (error: unknown, envelope: IncomingEnvelope | null, context: AmqpEventContext) => void;\n}\n\n/**\n * Consumes an Artemis address over AMQP 1.0: each message is decoded, validated, routed to the\n * handler for its URN (read from the `x-opt-jms-type` annotation), and `accept`ed on success. A\n * throwing handler `release`s the message so the broker redelivers it (incrementing the AMQP\n * `delivery-count`); once max-tries is reached the envelope goes to `<queue>.dlq` with a\n * `dead_letter` block. `attempts` is reconciled to `max(body, delivery-count)` — the AMQP\n * counter is 0-based, so no −1.\n */\nexport class ArtemisConsumer {\n  private readonly maxTries: number;\n  private readonly unknownUrn: string;\n\n  constructor(\n    private readonly handlers: BabelHandlers,\n    private readonly options: ArtemisConsumerOptions = {},\n  ) {\n    this.maxTries = options.maxTries ?? 3;\n    this.unknownUrn = options.unknownUrn ?? UnknownUrnStrategy.FAIL;\n  }\n\n  /** Wire this consumer to a rhea receiver's `message` event (auto-accept must be off). */\n  listen(receiver: AmqpReceiver): void {\n    receiver.on(\"message\", (context) => this.handle(context));\n  }\n\n  /** Route + settle one delivery. Exposed for testing. */\n  async handle(context: AmqpEventContext): Promise<void> {\n    const message = context.message ?? {};\n    const delivery = context.delivery;\n    const decoded = EnvelopeCodec.decode(messageBody(message));\n\n    if (!EnvelopeCodec.accepts(decoded)) {\n      // A non-conformant / poison message may lack the fields to annotate; forward it raw.\n      this.report(new BabelQueueError(\"Rejected a non-conformant BabelQueue envelope from Artemis.\"), decoded, context);\n      await this.deadLetterRaw(messageBody(message));\n      delivery?.accept();\n      return;\n    }\n\n    const envelope = this.reconcile(decoded, message);\n    const urn = jmsType(message) ?? EnvelopeCodec.urn(envelope);\n    const handler = this.handlers[urn];\n    if (!handler) {\n      await this.onUnknownUrn(context, envelope, urn);\n      return;\n    }\n\n    try {\n      await handler(envelope, message);\n      delivery?.accept();\n    } catch (error) {\n      this.report(error, envelope, context);\n      await this.retryOrDeadLetter(context, envelope, error);\n    }\n  }\n\n  /** `attempts = max(body, delivery-count)`: the AMQP counter is 0-based, so no −1. */\n  private reconcile(envelope: IncomingEnvelope, message: AmqpMessage): Envelope {\n    const body = typeof envelope.attempts === \"number\" ? envelope.attempts : 0;\n    const count = deliveryCount(message);\n    return { ...envelope, attempts: Math.max(body, count) } as Envelope;\n  }\n\n  private async onUnknownUrn(context: AmqpEventContext, envelope: Envelope, urn: string): Promise<void> {\n    const delivery = context.delivery;\n    switch (this.unknownUrn) {\n      case UnknownUrnStrategy.DELETE:\n        delivery?.accept();\n        return;\n      case UnknownUrnStrategy.DEAD_LETTER:\n        await this.deadLetter(envelope, \"unknown_urn\");\n        delivery?.accept();\n        return;\n      case UnknownUrnStrategy.RELEASE:\n        delivery?.release({ delivery_failed: true });\n        return;\n      default: {\n        // FAIL: surface and do NOT settle — the broker redelivers, then dead-letters.\n        const error = new UnknownUrnError(urn);\n        this.report(error, envelope, context);\n        throw error;\n      }\n    }\n  }\n\n  private async retryOrDeadLetter(context: AmqpEventContext, envelope: Envelope, error: unknown): Promise<void> {\n    const delivery = context.delivery;\n    if ((envelope.attempts ?? 0) + 1 < this.maxTries) {\n      // Release with delivery-failed leaves it for redelivery — the broker bumps delivery-count.\n      delivery?.release({ delivery_failed: true });\n    } else if (this.options.deadLetterSender) {\n      await this.deadLetter(envelope, \"failed\", error);\n      delivery?.accept();\n    } else {\n      delivery?.accept(); // terminal, no DLQ → drop\n    }\n  }\n\n  private async deadLetter(envelope: Envelope, reason: string, error?: unknown): Promise<void> {\n    const sender = this.options.deadLetterSender;\n    if (!sender) return;\n    const original = envelope.meta?.queue ?? \"\";\n    const annotated = annotate(envelope, reason, original, {\n      attempts: envelope.attempts ?? 0,\n      error: error instanceof Error ? error.message : null,\n      exception: error instanceof Error ? error.name : null,\n    });\n    await sender.send(artemisMessage(annotated));\n  }\n\n  private async deadLetterRaw(raw: string): Promise<void> {\n    const sender = this.options.deadLetterSender;\n    if (!sender) return;\n    await sender.send({ body: raw });\n  }\n\n  private report(error: unknown, envelope: IncomingEnvelope | null, context: AmqpEventContext): void {\n    this.options.onError?.(error, envelope, context);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,129 @@
+import { Envelope, IncomingEnvelope } from '@babelqueue/core';
+
+/**
+ * Apache ActiveMQ Artemis adapter for BabelQueue.
+ *
+ * A canonical-envelope **publisher** and a URN-routed **AMQP 1.0** consumer over Artemis (rhea),
+ * so an Artemis-based Node service speaks the same contract (envelope shape, URN identity, trace
+ * propagation) as the Java, .NET, Python and Go SDKs.
+ *
+ * Artemis speaks AMQP 1.0 (not RabbitMQ's 0-9-1) and gives the binding native primitives —
+ * per-message settlement, scheduled delivery, a delivery counter and a dead-letter address — so
+ * this adapter maps onto them (the envelope stays `schema_version: 1`): the envelope JSON is the
+ * message **body**; the contract fields are mirrored onto the AMQP a JMS peer reads
+ * (`correlation-id` = `trace_id`, `creation-time` = `meta.created_at`, the `x-opt-jms-type`
+ * annotation = URN) plus the `bq_` application properties; consume settles per message
+ * (`accept` after success, `release` for redelivery); **`attempts = max(body, delivery-count)`**
+ * (the AMQP counter is 0-based — no −1); terminal failures go to an opt-in `<queue>.dlq` with a
+ * `dead_letter` block.
+ *
+ * This implements §7 of the broker-bindings contract. `rhea` is an optional peer — you provide
+ * the sender/receiver (a rhea sender/receiver satisfies the adapter structurally).
+ */
+
+/** An AMQP message (structural subset of a rhea message). */
+interface AmqpMessage {
+    body?: unknown;
+    correlation_id?: unknown;
+    creation_time?: number | Date;
+    content_type?: string;
+    application_properties?: Record<string, unknown>;
+    message_annotations?: Record<string, unknown>;
+    /** The AMQP header delivery-count (0-based: 0 on first delivery). */
+    delivery_count?: number;
+}
+/** The disposition handle rhea passes alongside a received message. */
+interface AmqpDelivery {
+    /** Settle (acknowledge) the message — it is removed from the queue. */
+    accept(): void;
+    /** Return the message for redelivery — the broker increments `delivery-count`. */
+    release(params?: {
+        delivery_failed?: boolean;
+        undeliverable_here?: boolean;
+    }): void;
+}
+/** The event context rhea emits on a `message` event. */
+interface AmqpEventContext {
+    message?: AmqpMessage;
+    delivery?: AmqpDelivery;
+}
+/** The subset of a rhea sender this adapter calls. */
+interface AmqpSender {
+    send(message: AmqpMessage): unknown;
+}
+/** The subset of a rhea receiver this adapter wires to (its `message` event). */
+interface AmqpReceiver {
+    on(event: "message", handler: (context: AmqpEventContext) => void): unknown;
+}
+/** The message annotation carrying the URN (the AMQP-JMS mapping of `JMSType`). */
+declare const JMS_TYPE_KEY = "x-opt-jms-type";
+/** The message annotation Artemis honours for AMQP scheduled delivery (absolute Unix ms). */
+declare const SCHEDULED_DELIVERY_KEY = "x-opt-delivery-time";
+/**
+ * Project the envelope onto the AMQP 1.0 message a JMS peer reads: body = envelope JSON,
+ * `correlation-id` = `trace_id`, `creation-time` = `meta.created_at`, the `x-opt-jms-type`
+ * annotation = URN, plus the string-valued `bq_` application properties. A positive `delayMs`
+ * sets the `x-opt-delivery-time` annotation for native scheduled delivery.
+ */
+declare function artemisMessage(envelope: Envelope, delayMs?: number): AmqpMessage;
+/** The message body as text (AMQP value string, or UTF-8-decoded binary / rhea Data section). */
+declare function messageBody(message: AmqpMessage): string;
+/** Options for {@link ArtemisPublisher.publish}. */
+interface PublishOptions {
+    traceId?: string;
+    /** Schedule via Artemis's native AMQP scheduled delivery (`x-opt-delivery-time`). */
+    delayMs?: number;
+}
+/** Sends canonical-envelope messages to one Artemis address with the §7 projection. */
+declare class ArtemisPublisher {
+    private readonly sender;
+    private readonly queue;
+    private constructor();
+    /** A publisher over a sender bound to `queue` (the address is stamped onto `meta.queue`). */
+    static create(sender: AmqpSender, queue: string): ArtemisPublisher;
+    /** Build + send the canonical envelope; returns the message id (`meta.id`). */
+    publish(urn: string, data: Record<string, unknown>, options?: PublishOptions): Promise<string>;
+}
+/** A URN handler. Receives the validated envelope and the raw AMQP message. */
+type BabelHandler = (envelope: Envelope, message: AmqpMessage) => unknown | Promise<unknown>;
+/** A map of URN → handler. */
+type BabelHandlers = Record<string, BabelHandler>;
+/** Options for {@link ArtemisConsumer}. */
+interface ArtemisConsumerOptions {
+    /** A sender to `<queue>.dlq`; enables cross-language dead-lettering. Without it a terminal failure drops. */
+    deadLetterSender?: AmqpSender;
+    /** Attempts before terminal dead-lettering (default 3). */
+    maxTries?: number;
+    /** Strategy for a URN with no handler (default `fail`). */
+    unknownUrn?: string;
+    /** Called for a non-conformant message, an unmapped URN, or a throwing handler. */
+    onError?: (error: unknown, envelope: IncomingEnvelope | null, context: AmqpEventContext) => void;
+}
+/**
+ * Consumes an Artemis address over AMQP 1.0: each message is decoded, validated, routed to the
+ * handler for its URN (read from the `x-opt-jms-type` annotation), and `accept`ed on success. A
+ * throwing handler `release`s the message so the broker redelivers it (incrementing the AMQP
+ * `delivery-count`); once max-tries is reached the envelope goes to `<queue>.dlq` with a
+ * `dead_letter` block. `attempts` is reconciled to `max(body, delivery-count)` — the AMQP
+ * counter is 0-based, so no −1.
+ */
+declare class ArtemisConsumer {
+    private readonly handlers;
+    private readonly options;
+    private readonly maxTries;
+    private readonly unknownUrn;
+    constructor(handlers: BabelHandlers, options?: ArtemisConsumerOptions);
+    /** Wire this consumer to a rhea receiver's `message` event (auto-accept must be off). */
+    listen(receiver: AmqpReceiver): void;
+    /** Route + settle one delivery. Exposed for testing. */
+    handle(context: AmqpEventContext): Promise<void>;
+    /** `attempts = max(body, delivery-count)`: the AMQP counter is 0-based, so no −1. */
+    private reconcile;
+    private onUnknownUrn;
+    private retryOrDeadLetter;
+    private deadLetter;
+    private deadLetterRaw;
+    private report;
+}
+
+export { type AmqpDelivery, type AmqpEventContext, type AmqpMessage, type AmqpReceiver, type AmqpSender, ArtemisConsumer, type ArtemisConsumerOptions, ArtemisPublisher, type BabelHandler, type BabelHandlers, JMS_TYPE_KEY, type PublishOptions, SCHEDULED_DELIVERY_KEY, artemisMessage, messageBody };

package/dist/index.d.ts

@@ -0,0 +1,129 @@
+import { Envelope, IncomingEnvelope } from '@babelqueue/core';
+
+/**
+ * Apache ActiveMQ Artemis adapter for BabelQueue.
+ *
+ * A canonical-envelope **publisher** and a URN-routed **AMQP 1.0** consumer over Artemis (rhea),
+ * so an Artemis-based Node service speaks the same contract (envelope shape, URN identity, trace
+ * propagation) as the Java, .NET, Python and Go SDKs.
+ *
+ * Artemis speaks AMQP 1.0 (not RabbitMQ's 0-9-1) and gives the binding native primitives —
+ * per-message settlement, scheduled delivery, a delivery counter and a dead-letter address — so
+ * this adapter maps onto them (the envelope stays `schema_version: 1`): the envelope JSON is the
+ * message **body**; the contract fields are mirrored onto the AMQP a JMS peer reads
+ * (`correlation-id` = `trace_id`, `creation-time` = `meta.created_at`, the `x-opt-jms-type`
+ * annotation = URN) plus the `bq_` application properties; consume settles per message
+ * (`accept` after success, `release` for redelivery); **`attempts = max(body, delivery-count)`**
+ * (the AMQP counter is 0-based — no −1); terminal failures go to an opt-in `<queue>.dlq` with a
+ * `dead_letter` block.
+ *
+ * This implements §7 of the broker-bindings contract. `rhea` is an optional peer — you provide
+ * the sender/receiver (a rhea sender/receiver satisfies the adapter structurally).
+ */
+
+/** An AMQP message (structural subset of a rhea message). */
+interface AmqpMessage {
+    body?: unknown;
+    correlation_id?: unknown;
+    creation_time?: number | Date;
+    content_type?: string;
+    application_properties?: Record<string, unknown>;
+    message_annotations?: Record<string, unknown>;
+    /** The AMQP header delivery-count (0-based: 0 on first delivery). */
+    delivery_count?: number;
+}
+/** The disposition handle rhea passes alongside a received message. */
+interface AmqpDelivery {
+    /** Settle (acknowledge) the message — it is removed from the queue. */
+    accept(): void;
+    /** Return the message for redelivery — the broker increments `delivery-count`. */
+    release(params?: {
+        delivery_failed?: boolean;
+        undeliverable_here?: boolean;
+    }): void;
+}
+/** The event context rhea emits on a `message` event. */
+interface AmqpEventContext {
+    message?: AmqpMessage;
+    delivery?: AmqpDelivery;
+}
+/** The subset of a rhea sender this adapter calls. */
+interface AmqpSender {
+    send(message: AmqpMessage): unknown;
+}
+/** The subset of a rhea receiver this adapter wires to (its `message` event). */
+interface AmqpReceiver {
+    on(event: "message", handler: (context: AmqpEventContext) => void): unknown;
+}
+/** The message annotation carrying the URN (the AMQP-JMS mapping of `JMSType`). */
+declare const JMS_TYPE_KEY = "x-opt-jms-type";
+/** The message annotation Artemis honours for AMQP scheduled delivery (absolute Unix ms). */
+declare const SCHEDULED_DELIVERY_KEY = "x-opt-delivery-time";
+/**
+ * Project the envelope onto the AMQP 1.0 message a JMS peer reads: body = envelope JSON,
+ * `correlation-id` = `trace_id`, `creation-time` = `meta.created_at`, the `x-opt-jms-type`
+ * annotation = URN, plus the string-valued `bq_` application properties. A positive `delayMs`
+ * sets the `x-opt-delivery-time` annotation for native scheduled delivery.
+ */
+declare function artemisMessage(envelope: Envelope, delayMs?: number): AmqpMessage;
+/** The message body as text (AMQP value string, or UTF-8-decoded binary / rhea Data section). */
+declare function messageBody(message: AmqpMessage): string;
+/** Options for {@link ArtemisPublisher.publish}. */
+interface PublishOptions {
+    traceId?: string;
+    /** Schedule via Artemis's native AMQP scheduled delivery (`x-opt-delivery-time`). */
+    delayMs?: number;
+}
+/** Sends canonical-envelope messages to one Artemis address with the §7 projection. */
+declare class ArtemisPublisher {
+    private readonly sender;
+    private readonly queue;
+    private constructor();
+    /** A publisher over a sender bound to `queue` (the address is stamped onto `meta.queue`). */
+    static create(sender: AmqpSender, queue: string): ArtemisPublisher;
+    /** Build + send the canonical envelope; returns the message id (`meta.id`). */
+    publish(urn: string, data: Record<string, unknown>, options?: PublishOptions): Promise<string>;
+}
+/** A URN handler. Receives the validated envelope and the raw AMQP message. */
+type BabelHandler = (envelope: Envelope, message: AmqpMessage) => unknown | Promise<unknown>;
+/** A map of URN → handler. */
+type BabelHandlers = Record<string, BabelHandler>;
+/** Options for {@link ArtemisConsumer}. */
+interface ArtemisConsumerOptions {
+    /** A sender to `<queue>.dlq`; enables cross-language dead-lettering. Without it a terminal failure drops. */
+    deadLetterSender?: AmqpSender;
+    /** Attempts before terminal dead-lettering (default 3). */
+    maxTries?: number;
+    /** Strategy for a URN with no handler (default `fail`). */
+    unknownUrn?: string;
+    /** Called for a non-conformant message, an unmapped URN, or a throwing handler. */
+    onError?: (error: unknown, envelope: IncomingEnvelope | null, context: AmqpEventContext) => void;
+}
+/**
+ * Consumes an Artemis address over AMQP 1.0: each message is decoded, validated, routed to the
+ * handler for its URN (read from the `x-opt-jms-type` annotation), and `accept`ed on success. A
+ * throwing handler `release`s the message so the broker redelivers it (incrementing the AMQP
+ * `delivery-count`); once max-tries is reached the envelope goes to `<queue>.dlq` with a
+ * `dead_letter` block. `attempts` is reconciled to `max(body, delivery-count)` — the AMQP
+ * counter is 0-based, so no −1.
+ */
+declare class ArtemisConsumer {
+    private readonly handlers;
+    private readonly options;
+    private readonly maxTries;
+    private readonly unknownUrn;
+    constructor(handlers: BabelHandlers, options?: ArtemisConsumerOptions);
+    /** Wire this consumer to a rhea receiver's `message` event (auto-accept must be off). */
+    listen(receiver: AmqpReceiver): void;
+    /** Route + settle one delivery. Exposed for testing. */
+    handle(context: AmqpEventContext): Promise<void>;
+    /** `attempts = max(body, delivery-count)`: the AMQP counter is 0-based, so no −1. */
+    private reconcile;
+    private onUnknownUrn;
+    private retryOrDeadLetter;
+    private deadLetter;
+    private deadLetterRaw;
+    private report;
+}
+
+export { type AmqpDelivery, type AmqpEventContext, type AmqpMessage, type AmqpReceiver, type AmqpSender, ArtemisConsumer, type ArtemisConsumerOptions, ArtemisPublisher, type BabelHandler, type BabelHandlers, JMS_TYPE_KEY, type PublishOptions, SCHEDULED_DELIVERY_KEY, artemisMessage, messageBody };

package/dist/index.js

@@ -0,0 +1,172 @@
+// src/index.ts
+import { annotate, BabelQueueError, EnvelopeCodec, UnknownUrnError, UnknownUrnStrategy } from "@babelqueue/core";
+var JMS_TYPE_KEY = "x-opt-jms-type";
+var SCHEDULED_DELIVERY_KEY = "x-opt-delivery-time";
+function artemisMessage(envelope, delayMs) {
+  const annotations = {};
+  if (envelope.job) annotations[JMS_TYPE_KEY] = envelope.job;
+  const applicationProperties = {
+    "bq_schema_version": String(envelope.meta.schema_version),
+    "bq_attempts": String(envelope.attempts ?? 0),
+    "bq_app_id": "babelqueue"
+  };
+  if (envelope.meta.lang) applicationProperties["bq_source_lang"] = envelope.meta.lang;
+  const message = {
+    body: EnvelopeCodec.encode(envelope),
+    content_type: "application/json",
+    application_properties: applicationProperties,
+    message_annotations: annotations
+  };
+  if (envelope.trace_id) message.correlation_id = envelope.trace_id;
+  if (envelope.meta.created_at != null) message.creation_time = envelope.meta.created_at;
+  if (delayMs != null && delayMs > 0) {
+    applicationProperties["bq_delay"] = String(delayMs);
+    annotations[SCHEDULED_DELIVERY_KEY] = Date.now() + delayMs;
+  }
+  return message;
+}
+function messageBody(message) {
+  const body = message.body;
+  if (body == null) return "";
+  if (typeof body === "string") return body;
+  if (Buffer.isBuffer(body)) return body.toString("utf8");
+  if (typeof body === "object" && "content" in body) {
+    const content = body.content;
+    if (Buffer.isBuffer(content)) return content.toString("utf8");
+    if (typeof content === "string") return content;
+  }
+  return String(body);
+}
+function jmsType(message) {
+  const value = message.message_annotations?.[JMS_TYPE_KEY];
+  return value == null ? void 0 : String(value);
+}
+function deliveryCount(message) {
+  const value = message.delivery_count;
+  return typeof value === "number" && value > 0 ? value : 0;
+}
+var ArtemisPublisher = class _ArtemisPublisher {
+  constructor(sender, queue) {
+    this.sender = sender;
+    this.queue = queue;
+  }
+  sender;
+  queue;
+  /** A publisher over a sender bound to `queue` (the address is stamped onto `meta.queue`). */
+  static create(sender, queue) {
+    return new _ArtemisPublisher(sender, queue);
+  }
+  /** Build + send the canonical envelope; returns the message id (`meta.id`). */
+  async publish(urn, data, options = {}) {
+    const envelope = EnvelopeCodec.make(urn, data, { queue: this.queue, traceId: options.traceId });
+    await this.sender.send(artemisMessage(envelope, options.delayMs));
+    return envelope.meta.id;
+  }
+};
+var ArtemisConsumer = class {
+  constructor(handlers, options = {}) {
+    this.handlers = handlers;
+    this.options = options;
+    this.maxTries = options.maxTries ?? 3;
+    this.unknownUrn = options.unknownUrn ?? UnknownUrnStrategy.FAIL;
+  }
+  handlers;
+  options;
+  maxTries;
+  unknownUrn;
+  /** Wire this consumer to a rhea receiver's `message` event (auto-accept must be off). */
+  listen(receiver) {
+    receiver.on("message", (context) => this.handle(context));
+  }
+  /** Route + settle one delivery. Exposed for testing. */
+  async handle(context) {
+    const message = context.message ?? {};
+    const delivery = context.delivery;
+    const decoded = EnvelopeCodec.decode(messageBody(message));
+    if (!EnvelopeCodec.accepts(decoded)) {
+      this.report(new BabelQueueError("Rejected a non-conformant BabelQueue envelope from Artemis."), decoded, context);
+      await this.deadLetterRaw(messageBody(message));
+      delivery?.accept();
+      return;
+    }
+    const envelope = this.reconcile(decoded, message);
+    const urn = jmsType(message) ?? EnvelopeCodec.urn(envelope);
+    const handler = this.handlers[urn];
+    if (!handler) {
+      await this.onUnknownUrn(context, envelope, urn);
+      return;
+    }
+    try {
+      await handler(envelope, message);
+      delivery?.accept();
+    } catch (error) {
+      this.report(error, envelope, context);
+      await this.retryOrDeadLetter(context, envelope, error);
+    }
+  }
+  /** `attempts = max(body, delivery-count)`: the AMQP counter is 0-based, so no −1. */
+  reconcile(envelope, message) {
+    const body = typeof envelope.attempts === "number" ? envelope.attempts : 0;
+    const count = deliveryCount(message);
+    return { ...envelope, attempts: Math.max(body, count) };
+  }
+  async onUnknownUrn(context, envelope, urn) {
+    const delivery = context.delivery;
+    switch (this.unknownUrn) {
+      case UnknownUrnStrategy.DELETE:
+        delivery?.accept();
+        return;
+      case UnknownUrnStrategy.DEAD_LETTER:
+        await this.deadLetter(envelope, "unknown_urn");
+        delivery?.accept();
+        return;
+      case UnknownUrnStrategy.RELEASE:
+        delivery?.release({ delivery_failed: true });
+        return;
+      default: {
+        const error = new UnknownUrnError(urn);
+        this.report(error, envelope, context);
+        throw error;
+      }
+    }
+  }
+  async retryOrDeadLetter(context, envelope, error) {
+    const delivery = context.delivery;
+    if ((envelope.attempts ?? 0) + 1 < this.maxTries) {
+      delivery?.release({ delivery_failed: true });
+    } else if (this.options.deadLetterSender) {
+      await this.deadLetter(envelope, "failed", error);
+      delivery?.accept();
+    } else {
+      delivery?.accept();
+    }
+  }
+  async deadLetter(envelope, reason, error) {
+    const sender = this.options.deadLetterSender;
+    if (!sender) return;
+    const original = envelope.meta?.queue ?? "";
+    const annotated = annotate(envelope, reason, original, {
+      attempts: envelope.attempts ?? 0,
+      error: error instanceof Error ? error.message : null,
+      exception: error instanceof Error ? error.name : null
+    });
+    await sender.send(artemisMessage(annotated));
+  }
+  async deadLetterRaw(raw) {
+    const sender = this.options.deadLetterSender;
+    if (!sender) return;
+    await sender.send({ body: raw });
+  }
+  report(error, envelope, context) {
+    this.options.onError?.(error, envelope, context);
+  }
+};
+export {
+  ArtemisConsumer,
+  ArtemisPublisher,
+  JMS_TYPE_KEY,
+  SCHEDULED_DELIVERY_KEY,
+  artemisMessage,
+  messageBody
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Apache ActiveMQ Artemis adapter for BabelQueue.\n *\n * A canonical-envelope **publisher** and a URN-routed **AMQP 1.0** consumer over Artemis (rhea),\n * so an Artemis-based Node service speaks the same contract (envelope shape, URN identity, trace\n * propagation) as the Java, .NET, Python and Go SDKs.\n *\n * Artemis speaks AMQP 1.0 (not RabbitMQ's 0-9-1) and gives the binding native primitives —\n * per-message settlement, scheduled delivery, a delivery counter and a dead-letter address — so\n * this adapter maps onto them (the envelope stays `schema_version: 1`): the envelope JSON is the\n * message **body**; the contract fields are mirrored onto the AMQP a JMS peer reads\n * (`correlation-id` = `trace_id`, `creation-time` = `meta.created_at`, the `x-opt-jms-type`\n * annotation = URN) plus the `bq_` application properties; consume settles per message\n * (`accept` after success, `release` for redelivery); **`attempts = max(body, delivery-count)`**\n * (the AMQP counter is 0-based — no −1); terminal failures go to an opt-in `<queue>.dlq` with a\n * `dead_letter` block.\n *\n * This implements §7 of the broker-bindings contract. `rhea` is an optional peer — you provide\n * the sender/receiver (a rhea sender/receiver satisfies the adapter structurally).\n */\n\nimport { annotate, BabelQueueError, EnvelopeCodec, UnknownUrnError, UnknownUrnStrategy } from \"@babelqueue/core\";\nimport type { Envelope, IncomingEnvelope } from \"@babelqueue/core\";\n\n// --- Minimal AMQP 1.0 shapes (a structural subset of rhea) ---------------------\n\n/** An AMQP message (structural subset of a rhea message). */\nexport interface AmqpMessage {\n  body?: unknown;\n  correlation_id?: unknown;\n  creation_time?: number | Date;\n  content_type?: string;\n  application_properties?: Record<string, unknown>;\n  message_annotations?: Record<string, unknown>;\n  /** The AMQP header delivery-count (0-based: 0 on first delivery). */\n  delivery_count?: number;\n}\n\n/** The disposition handle rhea passes alongside a received message. */\nexport interface AmqpDelivery {\n  /** Settle (acknowledge) the message — it is removed from the queue. */\n  accept(): void;\n  /** Return the message for redelivery — the broker increments `delivery-count`. */\n  release(params?: { delivery_failed?: boolean; undeliverable_here?: boolean }): void;\n}\n\n/** The event context rhea emits on a `message` event. */\nexport interface AmqpEventContext {\n  message?: AmqpMessage;\n  delivery?: AmqpDelivery;\n}\n\n/** The subset of a rhea sender this adapter calls. */\nexport interface AmqpSender {\n  send(message: AmqpMessage): unknown;\n}\n\n/** The subset of a rhea receiver this adapter wires to (its `message` event). */\nexport interface AmqpReceiver {\n  on(event: \"message\", handler: (context: AmqpEventContext) => void): unknown;\n}\n\n// --- Projection (contract §7.2) ------------------------------------------------\n\n/** The message annotation carrying the URN (the AMQP-JMS mapping of `JMSType`). */\nexport const JMS_TYPE_KEY = \"x-opt-jms-type\";\n/** The message annotation Artemis honours for AMQP scheduled delivery (absolute Unix ms). */\nexport const SCHEDULED_DELIVERY_KEY = \"x-opt-delivery-time\";\n\n/**\n * Project the envelope onto the AMQP 1.0 message a JMS peer reads: body = envelope JSON,\n * `correlation-id` = `trace_id`, `creation-time` = `meta.created_at`, the `x-opt-jms-type`\n * annotation = URN, plus the string-valued `bq_` application properties. A positive `delayMs`\n * sets the `x-opt-delivery-time` annotation for native scheduled delivery.\n */\nexport function artemisMessage(envelope: Envelope, delayMs?: number): AmqpMessage {\n  const annotations: Record<string, unknown> = {};\n  if (envelope.job) annotations[JMS_TYPE_KEY] = envelope.job;\n\n  // The bq_ property names use underscores, not hyphens: a JMS property name must be a valid\n  // Java identifier, and every Artemis SDK uses the same JMS-legal form for cross-protocol parity.\n  const applicationProperties: Record<string, unknown> = {\n    \"bq_schema_version\": String(envelope.meta.schema_version),\n    \"bq_attempts\": String(envelope.attempts ?? 0),\n    \"bq_app_id\": \"babelqueue\",\n  };\n  if (envelope.meta.lang) applicationProperties[\"bq_source_lang\"] = envelope.meta.lang;\n\n  const message: AmqpMessage = {\n    body: EnvelopeCodec.encode(envelope),\n    content_type: \"application/json\",\n    application_properties: applicationProperties,\n    message_annotations: annotations,\n  };\n  if (envelope.trace_id) message.correlation_id = envelope.trace_id;\n  if (envelope.meta.created_at != null) message.creation_time = envelope.meta.created_at;\n\n  if (delayMs != null && delayMs > 0) {\n    applicationProperties[\"bq_delay\"] = String(delayMs);\n    annotations[SCHEDULED_DELIVERY_KEY] = Date.now() + delayMs;\n  }\n  return message;\n}\n\n/** The message body as text (AMQP value string, or UTF-8-decoded binary / rhea Data section). */\nexport function messageBody(message: AmqpMessage): string {\n  const body = message.body;\n  if (body == null) return \"\";\n  if (typeof body === \"string\") return body;\n  if (Buffer.isBuffer(body)) return body.toString(\"utf8\");\n  if (typeof body === \"object\" && \"content\" in body) {\n    const content = (body as { content: unknown }).content;\n    if (Buffer.isBuffer(content)) return content.toString(\"utf8\");\n    if (typeof content === \"string\") return content;\n  }\n  return String(body);\n}\n\nfunction jmsType(message: AmqpMessage): string | undefined {\n  const value = message.message_annotations?.[JMS_TYPE_KEY];\n  return value == null ? undefined : String(value);\n}\n\nfunction deliveryCount(message: AmqpMessage): number {\n  const value = message.delivery_count;\n  return typeof value === \"number\" && value > 0 ? value : 0;\n}\n\n// --- Publisher -----------------------------------------------------------------\n\n/** Options for {@link ArtemisPublisher.publish}. */\nexport interface PublishOptions {\n  traceId?: string;\n  /** Schedule via Artemis's native AMQP scheduled delivery (`x-opt-delivery-time`). */\n  delayMs?: number;\n}\n\n/** Sends canonical-envelope messages to one Artemis address with the §7 projection. */\nexport class ArtemisPublisher {\n  private constructor(\n    private readonly sender: AmqpSender,\n    private readonly queue: string,\n  ) {}\n\n  /** A publisher over a sender bound to `queue` (the address is stamped onto `meta.queue`). */\n  static create(sender: AmqpSender, queue: string): ArtemisPublisher {\n    return new ArtemisPublisher(sender, queue);\n  }\n\n  /** Build + send the canonical envelope; returns the message id (`meta.id`). */\n  async publish(urn: string, data: Record<string, unknown>, options: PublishOptions = {}): Promise<string> {\n    const envelope = EnvelopeCodec.make(urn, data, { queue: this.queue, traceId: options.traceId });\n    await this.sender.send(artemisMessage(envelope, options.delayMs));\n    return envelope.meta.id;\n  }\n}\n\n// --- Consumer ------------------------------------------------------------------\n\n/** A URN handler. Receives the validated envelope and the raw AMQP message. */\nexport type BabelHandler = (envelope: Envelope, message: AmqpMessage) => unknown | Promise<unknown>;\n\n/** A map of URN → handler. */\nexport type BabelHandlers = Record<string, BabelHandler>;\n\n/** Options for {@link ArtemisConsumer}. */\nexport interface ArtemisConsumerOptions {\n  /** A sender to `<queue>.dlq`; enables cross-language dead-lettering. Without it a terminal failure drops. */\n  deadLetterSender?: AmqpSender;\n  /** Attempts before terminal dead-lettering (default 3). */\n  maxTries?: number;\n  /** Strategy for a URN with no handler (default `fail`). */\n  unknownUrn?: string;\n  /** Called for a non-conformant message, an unmapped URN, or a throwing handler. */\n  onError?: (error: unknown, envelope: IncomingEnvelope | null, context: AmqpEventContext) => void;\n}\n\n/**\n * Consumes an Artemis address over AMQP 1.0: each message is decoded, validated, routed to the\n * handler for its URN (read from the `x-opt-jms-type` annotation), and `accept`ed on success. A\n * throwing handler `release`s the message so the broker redelivers it (incrementing the AMQP\n * `delivery-count`); once max-tries is reached the envelope goes to `<queue>.dlq` with a\n * `dead_letter` block. `attempts` is reconciled to `max(body, delivery-count)` — the AMQP\n * counter is 0-based, so no −1.\n */\nexport class ArtemisConsumer {\n  private readonly maxTries: number;\n  private readonly unknownUrn: string;\n\n  constructor(\n    private readonly handlers: BabelHandlers,\n    private readonly options: ArtemisConsumerOptions = {},\n  ) {\n    this.maxTries = options.maxTries ?? 3;\n    this.unknownUrn = options.unknownUrn ?? UnknownUrnStrategy.FAIL;\n  }\n\n  /** Wire this consumer to a rhea receiver's `message` event (auto-accept must be off). */\n  listen(receiver: AmqpReceiver): void {\n    receiver.on(\"message\", (context) => this.handle(context));\n  }\n\n  /** Route + settle one delivery. Exposed for testing. */\n  async handle(context: AmqpEventContext): Promise<void> {\n    const message = context.message ?? {};\n    const delivery = context.delivery;\n    const decoded = EnvelopeCodec.decode(messageBody(message));\n\n    if (!EnvelopeCodec.accepts(decoded)) {\n      // A non-conformant / poison message may lack the fields to annotate; forward it raw.\n      this.report(new BabelQueueError(\"Rejected a non-conformant BabelQueue envelope from Artemis.\"), decoded, context);\n      await this.deadLetterRaw(messageBody(message));\n      delivery?.accept();\n      return;\n    }\n\n    const envelope = this.reconcile(decoded, message);\n    const urn = jmsType(message) ?? EnvelopeCodec.urn(envelope);\n    const handler = this.handlers[urn];\n    if (!handler) {\n      await this.onUnknownUrn(context, envelope, urn);\n      return;\n    }\n\n    try {\n      await handler(envelope, message);\n      delivery?.accept();\n    } catch (error) {\n      this.report(error, envelope, context);\n      await this.retryOrDeadLetter(context, envelope, error);\n    }\n  }\n\n  /** `attempts = max(body, delivery-count)`: the AMQP counter is 0-based, so no −1. */\n  private reconcile(envelope: IncomingEnvelope, message: AmqpMessage): Envelope {\n    const body = typeof envelope.attempts === \"number\" ? envelope.attempts : 0;\n    const count = deliveryCount(message);\n    return { ...envelope, attempts: Math.max(body, count) } as Envelope;\n  }\n\n  private async onUnknownUrn(context: AmqpEventContext, envelope: Envelope, urn: string): Promise<void> {\n    const delivery = context.delivery;\n    switch (this.unknownUrn) {\n      case UnknownUrnStrategy.DELETE:\n        delivery?.accept();\n        return;\n      case UnknownUrnStrategy.DEAD_LETTER:\n        await this.deadLetter(envelope, \"unknown_urn\");\n        delivery?.accept();\n        return;\n      case UnknownUrnStrategy.RELEASE:\n        delivery?.release({ delivery_failed: true });\n        return;\n      default: {\n        // FAIL: surface and do NOT settle — the broker redelivers, then dead-letters.\n        const error = new UnknownUrnError(urn);\n        this.report(error, envelope, context);\n        throw error;\n      }\n    }\n  }\n\n  private async retryOrDeadLetter(context: AmqpEventContext, envelope: Envelope, error: unknown): Promise<void> {\n    const delivery = context.delivery;\n    if ((envelope.attempts ?? 0) + 1 < this.maxTries) {\n      // Release with delivery-failed leaves it for redelivery — the broker bumps delivery-count.\n      delivery?.release({ delivery_failed: true });\n    } else if (this.options.deadLetterSender) {\n      await this.deadLetter(envelope, \"failed\", error);\n      delivery?.accept();\n    } else {\n      delivery?.accept(); // terminal, no DLQ → drop\n    }\n  }\n\n  private async deadLetter(envelope: Envelope, reason: string, error?: unknown): Promise<void> {\n    const sender = this.options.deadLetterSender;\n    if (!sender) return;\n    const original = envelope.meta?.queue ?? \"\";\n    const annotated = annotate(envelope, reason, original, {\n      attempts: envelope.attempts ?? 0,\n      error: error instanceof Error ? error.message : null,\n      exception: error instanceof Error ? error.name : null,\n    });\n    await sender.send(artemisMessage(annotated));\n  }\n\n  private async deadLetterRaw(raw: string): Promise<void> {\n    const sender = this.options.deadLetterSender;\n    if (!sender) return;\n    await sender.send({ body: raw });\n  }\n\n  private report(error: unknown, envelope: IncomingEnvelope | null, context: AmqpEventContext): void {\n    this.options.onError?.(error, envelope, context);\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@babelqueue/artemis",
+  "version": "1.0.0",
+  "description": "Apache ActiveMQ Artemis adapter for BabelQueue — canonical-envelope publisher and a URN-routed AMQP 1.0 consumer (accept/release settlement, native scheduled delivery, cross-language DLQ) over rhea.",
+  "keywords": ["babelqueue", "artemis", "activemq", "amqp", "rhea", "jms", "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/artemis"
+  },
+  "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": {
+    "rhea": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "rhea": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}