@babelqueue/bullmq 1.0.1 → 1.1.0

package/README.md

@@ -48,6 +48,24 @@ unmapped URN throws unless you pass `onUnknownUrn`.
 > services. For raw cross-language queues, other SDKs read/write plain broker
 > queues directly.
 
+## OpenTelemetry tracing (ADR-0028)
+
+Cross-hop **span** linkage rides on the out-of-band `HeaderCarrier` from
+[`@babelqueue/core@^1.4.0`](https://www.npmjs.com/package/@babelqueue/core). Pass the carrier produced by
+`@babelqueue/core/otel`'s `publish` to this adapter's `publish({ headers })`; it is carried on
+BullMQ's native `telemetry.metadata` job-options slot (so the envelope — `job.data` — is never touched). On consume, the `processor` surfaces a delivered job's headers to the handler's third argument (and `headersOf(job)` reads them back),
+so the core's `otel` `wrapHandler` starts the consumer span as a true **child** of the producer span.
+
+```ts
+import { trace } from "@opentelemetry/api";
+import { publish as tracedPublish } from "@babelqueue/core/otel";
+import type { HeaderCarrier } from "@babelqueue/core";
+
+const headers: HeaderCarrier = {};
+await tracedPublish(trace.getTracer("orders"), urn, data,
+  () => adapterPublish(urn, data, { headers }), { headers });
+```
+
 ## License
 
 [MIT](../../LICENSE) © Muhammet Şafak · [babelqueue.com](https://babelqueue.com)

package/dist/index.cjs

@@ -20,19 +20,60 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  decodeMetadata: () => decodeMetadata,
+  encodeMetadata: () => encodeMetadata,
+  headersOf: () => headersOf,
   processor: () => processor,
   publish: () => publish
 });
 module.exports = __toCommonJS(index_exports);
 var import_core = require("@babelqueue/core");
+
+// src/headers.ts
+function sanitizeHeaders(headers) {
+  const out = {};
+  if (!headers) return out;
+  for (const key of Object.keys(headers)) {
+    const value = headers[key];
+    if (key === "" || value == null || value === "") continue;
+    out[key] = value;
+  }
+  return out;
+}
+function encodeMetadata(headers) {
+  const clean = sanitizeHeaders(headers);
+  return Object.keys(clean).length === 0 ? void 0 : JSON.stringify(clean);
+}
+function decodeMetadata(metadata) {
+  if (!metadata) return {};
+  try {
+    const parsed = JSON.parse(metadata);
+    if (parsed == null || typeof parsed !== "object" || Array.isArray(parsed)) return {};
+    return sanitizeHeaders(parsed);
+  } catch {
+    return {};
+  }
+}
+
+// src/index.ts
+function headersOf(job) {
+  return decodeMetadata(job.opts?.telemetry?.metadata);
+}
 async function publish(queue, urn, data, options = {}) {
   const envelope = import_core.EnvelopeCodec.make(urn, data, {
     queue: queue.name,
     traceId: options.traceId
   });
-  await queue.add(urn, envelope, options.jobsOptions);
+  await queue.add(urn, envelope, withHeaders(options.jobsOptions, options.headers));
   return envelope.meta.id;
 }
+function withHeaders(jobsOptions, headers) {
+  const metadata = encodeMetadata(headers);
+  if (metadata === void 0) return jobsOptions;
+  const telemetry = jobsOptions?.telemetry;
+  if (telemetry?.metadata != null) return jobsOptions;
+  return { ...jobsOptions, telemetry: { ...telemetry, metadata } };
+}
 function processor(handlers, options = {}) {
   return async (job) => {
     const envelope = job.data;
@@ -49,11 +90,14 @@ function processor(handlers, options = {}) {
       }
       throw new import_core.UnknownUrnError(urn);
     }
-    return handler(envelope, job);
+    return handler(envelope, job, headersOf(job));
   };
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  decodeMetadata,
+  encodeMetadata,
+  headersOf,
   processor,
   publish
 });

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * BullMQ adapter for BabelQueue.\n *\n * It makes your BullMQ jobs carry the canonical BabelQueue envelope and routes\n * them by URN, so a BullMQ-based Node service speaks the same contract (envelope\n * shape, URN identity, trace propagation) as the PHP/Laravel, Python, Go, Java and\n * .NET SDKs.\n *\n *     import { Queue, Worker } from \"bullmq\";\n *     import { publish, processor } from \"@babelqueue/bullmq\";\n *\n *     const queue = new Queue(\"orders\", { connection });\n *     await publish(queue, \"urn:babel:orders:created\", { order_id: 1042 });\n *\n *     new Worker(\"orders\", processor({\n *       \"urn:babel:orders:created\": async (env) => { ... },\n *     }), { connection });\n */\n\nimport {\n  BabelQueueError,\n  EnvelopeCodec,\n  UnknownUrnError,\n  type Envelope,\n  type IncomingEnvelope,\n} from \"@babelqueue/core\";\nimport type { Job, JobsOptions, Queue } from \"bullmq\";\n\n/** A URN handler. Receives the validated envelope and the raw BullMQ job. */\nexport type BabelHandler = (envelope: Envelope, job: Job) => unknown | Promise<unknown>;\n\n/** A map of URN → handler. */\nexport type BabelHandlers = Record<string, BabelHandler>;\n\n/** Options for {@link publish}. */\nexport interface PublishOptions {\n  /** Reuse an existing trace id (trace continuation). */\n  traceId?: string;\n  /** BullMQ job options (delay, attempts, backoff, …). */\n  jobsOptions?: JobsOptions;\n}\n\n/**\n * Build the canonical envelope for `(urn, data)` and add it as a BullMQ job (the\n * job name is the URN, the job data is the envelope). Returns the message id\n * (`meta.id`).\n */\nexport async function publish(\n  queue: Queue,\n  urn: string,\n  data: Record<string, unknown>,\n  options: PublishOptions = {},\n): Promise<string> {\n  const envelope = EnvelopeCodec.make(urn, data, {\n    queue: queue.name,\n    traceId: options.traceId,\n  });\n  await queue.add(urn, envelope, options.jobsOptions);\n  return envelope.meta.id;\n}\n\n/** Options for {@link processor}. */\nexport interface ProcessorOptions {\n  /** Called instead of throwing when a job's URN has no handler. */\n  onUnknownUrn?: (envelope: IncomingEnvelope, job: Job) => unknown | Promise<unknown>;\n}\n\n/**\n * Build a BullMQ processor that decodes each job's envelope, validates it, and\n * routes it to the handler registered for its URN. A non-conformant envelope\n * throws (so BullMQ retries / fails the job per its options); an unmapped URN\n * throws unless `onUnknownUrn` is given.\n *\n *     new Worker(\"orders\", processor(handlers), { connection });\n */\nexport function processor(\n  handlers: BabelHandlers,\n  options: ProcessorOptions = {},\n): (job: Job) => Promise<unknown> {\n  return async (job: Job): Promise<unknown> => {\n    const envelope = job.data as IncomingEnvelope;\n\n    if (!EnvelopeCodec.accepts(envelope)) {\n      throw new BabelQueueError(\n        `Rejected a non-conformant BabelQueue envelope on job ${job.id ?? \"?\"}.`,\n      );\n    }\n\n    const urn = EnvelopeCodec.urn(envelope);\n    const handler = handlers[urn];\n    if (!handler) {\n      if (options.onUnknownUrn) {\n        return options.onUnknownUrn(envelope, job);\n      }\n      throw new UnknownUrnError(urn);\n    }\n\n    return handler(envelope, job);\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAmBA,kBAMO;AAsBP,eAAsB,QACpB,OACA,KACA,MACA,UAA0B,CAAC,GACV;AACjB,QAAM,WAAW,0BAAc,KAAK,KAAK,MAAM;AAAA,IAC7C,OAAO,MAAM;AAAA,IACb,SAAS,QAAQ;AAAA,EACnB,CAAC;AACD,QAAM,MAAM,IAAI,KAAK,UAAU,QAAQ,WAAW;AAClD,SAAO,SAAS,KAAK;AACvB;AAgBO,SAAS,UACd,UACA,UAA4B,CAAC,GACG;AAChC,SAAO,OAAO,QAA+B;AAC3C,UAAM,WAAW,IAAI;AAErB,QAAI,CAAC,0BAAc,QAAQ,QAAQ,GAAG;AACpC,YAAM,IAAI;AAAA,QACR,wDAAwD,IAAI,MAAM,GAAG;AAAA,MACvE;AAAA,IACF;AAEA,UAAM,MAAM,0BAAc,IAAI,QAAQ;AACtC,UAAM,UAAU,SAAS,GAAG;AAC5B,QAAI,CAAC,SAAS;AACZ,UAAI,QAAQ,cAAc;AACxB,eAAO,QAAQ,aAAa,UAAU,GAAG;AAAA,MAC3C;AACA,YAAM,IAAI,4BAAgB,GAAG;AAAA,IAC/B;AAEA,WAAO,QAAQ,UAAU,GAAG;AAAA,EAC9B;AACF;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/headers.ts"],"sourcesContent":["/**\n * BullMQ adapter for BabelQueue.\n *\n * It makes your BullMQ jobs carry the canonical BabelQueue envelope and routes\n * them by URN, so a BullMQ-based Node service speaks the same contract (envelope\n * shape, URN identity, trace propagation) as the PHP/Laravel, Python, Go, Java and\n * .NET SDKs.\n *\n *     import { Queue, Worker } from \"bullmq\";\n *     import { publish, processor } from \"@babelqueue/bullmq\";\n *\n *     const queue = new Queue(\"orders\", { connection });\n *     await publish(queue, \"urn:babel:orders:created\", { order_id: 1042 });\n *\n *     new Worker(\"orders\", processor({\n *       \"urn:babel:orders:created\": async (env) => { ... },\n *     }), { connection });\n */\n\nimport {\n  BabelQueueError,\n  EnvelopeCodec,\n  UnknownUrnError,\n  type Envelope,\n  type HeaderCarrier,\n  type IncomingEnvelope,\n} from \"@babelqueue/core\";\nimport type { Job, JobsOptions, Queue } from \"bullmq\";\n\nimport { decodeMetadata, encodeMetadata } from \"./headers.js\";\n\nexport { decodeMetadata, encodeMetadata } from \"./headers.js\";\n\n/**\n * The out-of-band {@link HeaderCarrier} carried by a job, read from BullMQ's native\n * `telemetry.metadata` slot (`job.opts.telemetry.metadata`). Empty for a job published without\n * headers. Pass it to `@babelqueue/core/otel`'s `wrapHandler` to link the consumer span as a child\n * of the producer span (ADR-0028).\n */\nexport function headersOf(job: Job): HeaderCarrier {\n  return decodeMetadata(job.opts?.telemetry?.metadata);\n}\n\n/**\n * A URN handler. Receives the validated envelope, the raw BullMQ job, and the out-of-band\n * {@link HeaderCarrier} carried in the job's `telemetry.metadata` (empty when there are none).\n */\nexport type BabelHandler = (envelope: Envelope, job: Job, headers: HeaderCarrier) => unknown | Promise<unknown>;\n\n/** A map of URN → handler. */\nexport type BabelHandlers = Record<string, BabelHandler>;\n\n/** Options for {@link publish}. */\nexport interface PublishOptions {\n  /** Reuse an existing trace id (trace continuation). */\n  traceId?: string;\n  /** BullMQ job options (delay, attempts, backoff, …). */\n  jobsOptions?: JobsOptions;\n  /**\n   * Out-of-band transport headers carried in BullMQ's native `telemetry.metadata` slot (ADR-0028) —\n   * e.g. a W3C `traceparent` written by `@babelqueue/core/otel`'s `publish`. The canonical envelope\n   * (`job.data`) stays byte-identical (GR-1); an empty/omitted carrier leaves the job options\n   * unchanged. An explicit `jobsOptions.telemetry.metadata` wins (it is not clobbered).\n   */\n  headers?: HeaderCarrier;\n}\n\n/**\n * Build the canonical envelope for `(urn, data)` and add it as a BullMQ job (the\n * job name is the URN, the job data is the envelope). Returns the message id\n * (`meta.id`).\n *\n * When `options.headers` carries any out-of-band header (e.g. a `traceparent`) it is serialized\n * into the job's `telemetry.metadata` so a consumer can read it back via {@link headersOf} — the\n * envelope itself is never touched.\n */\nexport async function publish(\n  queue: Queue,\n  urn: string,\n  data: Record<string, unknown>,\n  options: PublishOptions = {},\n): Promise<string> {\n  const envelope = EnvelopeCodec.make(urn, data, {\n    queue: queue.name,\n    traceId: options.traceId,\n  });\n  await queue.add(urn, envelope, withHeaders(options.jobsOptions, options.headers));\n  return envelope.meta.id;\n}\n\n/**\n * Merge an out-of-band header carrier into a job's `telemetry.metadata` without clobbering an\n * explicit one the caller already set. Returns the original options unchanged when there is nothing\n * to carry, so a header-less publish stays byte-identical.\n */\nfunction withHeaders(jobsOptions: JobsOptions | undefined, headers: HeaderCarrier | undefined): JobsOptions | undefined {\n  const metadata = encodeMetadata(headers);\n  if (metadata === undefined) return jobsOptions;\n  const telemetry = jobsOptions?.telemetry;\n  if (telemetry?.metadata != null) return jobsOptions; // an explicit metadata wins (merge-not-clobber)\n  return { ...jobsOptions, telemetry: { ...telemetry, metadata } };\n}\n\n/** Options for {@link processor}. */\nexport interface ProcessorOptions {\n  /** Called instead of throwing when a job's URN has no handler. */\n  onUnknownUrn?: (envelope: IncomingEnvelope, job: Job) => unknown | Promise<unknown>;\n}\n\n/**\n * Build a BullMQ processor that decodes each job's envelope, validates it, and\n * routes it to the handler registered for its URN. A non-conformant envelope\n * throws (so BullMQ retries / fails the job per its options); an unmapped URN\n * throws unless `onUnknownUrn` is given.\n *\n *     new Worker(\"orders\", processor(handlers), { connection });\n */\nexport function processor(\n  handlers: BabelHandlers,\n  options: ProcessorOptions = {},\n): (job: Job) => Promise<unknown> {\n  return async (job: Job): Promise<unknown> => {\n    const envelope = job.data as IncomingEnvelope;\n\n    if (!EnvelopeCodec.accepts(envelope)) {\n      throw new BabelQueueError(\n        `Rejected a non-conformant BabelQueue envelope on job ${job.id ?? \"?\"}.`,\n      );\n    }\n\n    const urn = EnvelopeCodec.urn(envelope);\n    const handler = handlers[urn];\n    if (!handler) {\n      if (options.onUnknownUrn) {\n        return options.onUnknownUrn(envelope, job);\n      }\n      throw new UnknownUrnError(urn);\n    }\n\n    return handler(envelope, job, headersOf(job));\n  };\n}\n","/**\n * Pure, dependency-free helpers for the out-of-band transport-header seam (ADR-0028) — the Node\n * adapter mirror of Go's `sanitizeHeaders` and PHP's `Support\\Headers`. They carry an injected\n * {@link HeaderCarrier} (e.g. a W3C `traceparent`) beside the frozen envelope (GR-1), never inside it.\n *\n * BullMQ has no AMQP-style header table; its native context-propagation slot is\n * `JobsOptions.telemetry.metadata` (a string, stored compactly as `tm` in Redis), so the carrier is\n * serialized to JSON there — leaving `job.data` (the canonical envelope) byte-identical.\n */\n\nimport type { HeaderCarrier } from \"@babelqueue/core\";\n\n/**\n * Copy `headers`, dropping blank keys and blank values. Returns an empty object when nothing\n * survives. A nullish input yields an empty object.\n */\nexport function sanitizeHeaders(headers: HeaderCarrier | null | undefined): HeaderCarrier {\n  const out: HeaderCarrier = {};\n  if (!headers) return out;\n  for (const key of Object.keys(headers)) {\n    const value = headers[key];\n    if (key === \"\" || value == null || value === \"\") continue;\n    out[key] = value;\n  }\n  return out;\n}\n\n/**\n * Serialize a header carrier for BullMQ's `telemetry.metadata` slot, or `undefined` when there is\n * nothing to carry (so a header-less publish leaves `telemetry` unset and the job byte-identical).\n */\nexport function encodeMetadata(headers: HeaderCarrier | null | undefined): string | undefined {\n  const clean = sanitizeHeaders(headers);\n  return Object.keys(clean).length === 0 ? undefined : JSON.stringify(clean);\n}\n\n/**\n * Read a header carrier back from a BullMQ `telemetry.metadata` string. Returns an empty object for\n * a missing or unparseable value, so a job produced without headers (or by a non-babelqueue\n * producer) consumes with no headers and no error.\n */\nexport function decodeMetadata(metadata: string | undefined | null): HeaderCarrier {\n  if (!metadata) return {};\n  try {\n    const parsed = JSON.parse(metadata) as unknown;\n    if (parsed == null || typeof parsed !== \"object\" || Array.isArray(parsed)) return {};\n    return sanitizeHeaders(parsed as HeaderCarrier);\n  } catch {\n    return {};\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAmBA,kBAOO;;;ACVA,SAAS,gBAAgB,SAA0D;AACxF,QAAM,MAAqB,CAAC;AAC5B,MAAI,CAAC,QAAS,QAAO;AACrB,aAAW,OAAO,OAAO,KAAK,OAAO,GAAG;AACtC,UAAM,QAAQ,QAAQ,GAAG;AACzB,QAAI,QAAQ,MAAM,SAAS,QAAQ,UAAU,GAAI;AACjD,QAAI,GAAG,IAAI;AAAA,EACb;AACA,SAAO;AACT;AAMO,SAAS,eAAe,SAA+D;AAC5F,QAAM,QAAQ,gBAAgB,OAAO;AACrC,SAAO,OAAO,KAAK,KAAK,EAAE,WAAW,IAAI,SAAY,KAAK,UAAU,KAAK;AAC3E;AAOO,SAAS,eAAe,UAAoD;AACjF,MAAI,CAAC,SAAU,QAAO,CAAC;AACvB,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,QAAQ;AAClC,QAAI,UAAU,QAAQ,OAAO,WAAW,YAAY,MAAM,QAAQ,MAAM,EAAG,QAAO,CAAC;AACnF,WAAO,gBAAgB,MAAuB;AAAA,EAChD,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;;;ADXO,SAAS,UAAU,KAAyB;AACjD,SAAO,eAAe,IAAI,MAAM,WAAW,QAAQ;AACrD;AAmCA,eAAsB,QACpB,OACA,KACA,MACA,UAA0B,CAAC,GACV;AACjB,QAAM,WAAW,0BAAc,KAAK,KAAK,MAAM;AAAA,IAC7C,OAAO,MAAM;AAAA,IACb,SAAS,QAAQ;AAAA,EACnB,CAAC;AACD,QAAM,MAAM,IAAI,KAAK,UAAU,YAAY,QAAQ,aAAa,QAAQ,OAAO,CAAC;AAChF,SAAO,SAAS,KAAK;AACvB;AAOA,SAAS,YAAY,aAAsC,SAA6D;AACtH,QAAM,WAAW,eAAe,OAAO;AACvC,MAAI,aAAa,OAAW,QAAO;AACnC,QAAM,YAAY,aAAa;AAC/B,MAAI,WAAW,YAAY,KAAM,QAAO;AACxC,SAAO,EAAE,GAAG,aAAa,WAAW,EAAE,GAAG,WAAW,SAAS,EAAE;AACjE;AAgBO,SAAS,UACd,UACA,UAA4B,CAAC,GACG;AAChC,SAAO,OAAO,QAA+B;AAC3C,UAAM,WAAW,IAAI;AAErB,QAAI,CAAC,0BAAc,QAAQ,QAAQ,GAAG;AACpC,YAAM,IAAI;AAAA,QACR,wDAAwD,IAAI,MAAM,GAAG;AAAA,MACvE;AAAA,IACF;AAEA,UAAM,MAAM,0BAAc,IAAI,QAAQ;AACtC,UAAM,UAAU,SAAS,GAAG;AAC5B,QAAI,CAAC,SAAS;AACZ,UAAI,QAAQ,cAAc;AACxB,eAAO,QAAQ,aAAa,UAAU,GAAG;AAAA,MAC3C;AACA,YAAM,IAAI,4BAAgB,GAAG;AAAA,IAC/B;AAEA,WAAO,QAAQ,UAAU,KAAK,UAAU,GAAG,CAAC;AAAA,EAC9C;AACF;","names":[]}

package/dist/index.d.cts

@@ -1,6 +1,28 @@
-import { Envelope, IncomingEnvelope } from '@babelqueue/core';
+import { HeaderCarrier, Envelope, IncomingEnvelope } from '@babelqueue/core';
 import { Job, JobsOptions, Queue } from 'bullmq';
 
+/**
+ * Pure, dependency-free helpers for the out-of-band transport-header seam (ADR-0028) — the Node
+ * adapter mirror of Go's `sanitizeHeaders` and PHP's `Support\Headers`. They carry an injected
+ * {@link HeaderCarrier} (e.g. a W3C `traceparent`) beside the frozen envelope (GR-1), never inside it.
+ *
+ * BullMQ has no AMQP-style header table; its native context-propagation slot is
+ * `JobsOptions.telemetry.metadata` (a string, stored compactly as `tm` in Redis), so the carrier is
+ * serialized to JSON there — leaving `job.data` (the canonical envelope) byte-identical.
+ */
+
+/**
+ * Serialize a header carrier for BullMQ's `telemetry.metadata` slot, or `undefined` when there is
+ * nothing to carry (so a header-less publish leaves `telemetry` unset and the job byte-identical).
+ */
+declare function encodeMetadata(headers: HeaderCarrier | null | undefined): string | undefined;
+/**
+ * Read a header carrier back from a BullMQ `telemetry.metadata` string. Returns an empty object for
+ * a missing or unparseable value, so a job produced without headers (or by a non-babelqueue
+ * producer) consumes with no headers and no error.
+ */
+declare function decodeMetadata(metadata: string | undefined | null): HeaderCarrier;
+
 /**
  * BullMQ adapter for BabelQueue.
  *
@@ -20,8 +42,18 @@ import { Job, JobsOptions, Queue } from 'bullmq';
  *     }), { connection });
  */
 
-/** A URN handler. Receives the validated envelope and the raw BullMQ job. */
-type BabelHandler = (envelope: Envelope, job: Job) => unknown | Promise<unknown>;
+/**
+ * The out-of-band {@link HeaderCarrier} carried by a job, read from BullMQ's native
+ * `telemetry.metadata` slot (`job.opts.telemetry.metadata`). Empty for a job published without
+ * headers. Pass it to `@babelqueue/core/otel`'s `wrapHandler` to link the consumer span as a child
+ * of the producer span (ADR-0028).
+ */
+declare function headersOf(job: Job): HeaderCarrier;
+/**
+ * A URN handler. Receives the validated envelope, the raw BullMQ job, and the out-of-band
+ * {@link HeaderCarrier} carried in the job's `telemetry.metadata` (empty when there are none).
+ */
+type BabelHandler = (envelope: Envelope, job: Job, headers: HeaderCarrier) => unknown | Promise<unknown>;
 /** A map of URN → handler. */
 type BabelHandlers = Record<string, BabelHandler>;
 /** Options for {@link publish}. */
@@ -30,11 +62,22 @@ interface PublishOptions {
     traceId?: string;
     /** BullMQ job options (delay, attempts, backoff, …). */
     jobsOptions?: JobsOptions;
+    /**
+     * Out-of-band transport headers carried in BullMQ's native `telemetry.metadata` slot (ADR-0028) —
+     * e.g. a W3C `traceparent` written by `@babelqueue/core/otel`'s `publish`. The canonical envelope
+     * (`job.data`) stays byte-identical (GR-1); an empty/omitted carrier leaves the job options
+     * unchanged. An explicit `jobsOptions.telemetry.metadata` wins (it is not clobbered).
+     */
+    headers?: HeaderCarrier;
 }
 /**
  * Build the canonical envelope for `(urn, data)` and add it as a BullMQ job (the
  * job name is the URN, the job data is the envelope). Returns the message id
  * (`meta.id`).
+ *
+ * When `options.headers` carries any out-of-band header (e.g. a `traceparent`) it is serialized
+ * into the job's `telemetry.metadata` so a consumer can read it back via {@link headersOf} — the
+ * envelope itself is never touched.
  */
 declare function publish(queue: Queue, urn: string, data: Record<string, unknown>, options?: PublishOptions): Promise<string>;
 /** Options for {@link processor}. */
@@ -52,4 +95,4 @@ interface ProcessorOptions {
  */
 declare function processor(handlers: BabelHandlers, options?: ProcessorOptions): (job: Job) => Promise<unknown>;
 
-export { type BabelHandler, type BabelHandlers, type ProcessorOptions, type PublishOptions, processor, publish };
+export { type BabelHandler, type BabelHandlers, type ProcessorOptions, type PublishOptions, decodeMetadata, encodeMetadata, headersOf, processor, publish };

package/dist/index.d.ts

@@ -1,6 +1,28 @@
-import { Envelope, IncomingEnvelope } from '@babelqueue/core';
+import { HeaderCarrier, Envelope, IncomingEnvelope } from '@babelqueue/core';
 import { Job, JobsOptions, Queue } from 'bullmq';
 
+/**
+ * Pure, dependency-free helpers for the out-of-band transport-header seam (ADR-0028) — the Node
+ * adapter mirror of Go's `sanitizeHeaders` and PHP's `Support\Headers`. They carry an injected
+ * {@link HeaderCarrier} (e.g. a W3C `traceparent`) beside the frozen envelope (GR-1), never inside it.
+ *
+ * BullMQ has no AMQP-style header table; its native context-propagation slot is
+ * `JobsOptions.telemetry.metadata` (a string, stored compactly as `tm` in Redis), so the carrier is
+ * serialized to JSON there — leaving `job.data` (the canonical envelope) byte-identical.
+ */
+
+/**
+ * Serialize a header carrier for BullMQ's `telemetry.metadata` slot, or `undefined` when there is
+ * nothing to carry (so a header-less publish leaves `telemetry` unset and the job byte-identical).
+ */
+declare function encodeMetadata(headers: HeaderCarrier | null | undefined): string | undefined;
+/**
+ * Read a header carrier back from a BullMQ `telemetry.metadata` string. Returns an empty object for
+ * a missing or unparseable value, so a job produced without headers (or by a non-babelqueue
+ * producer) consumes with no headers and no error.
+ */
+declare function decodeMetadata(metadata: string | undefined | null): HeaderCarrier;
+
 /**
  * BullMQ adapter for BabelQueue.
  *
@@ -20,8 +42,18 @@ import { Job, JobsOptions, Queue } from 'bullmq';
  *     }), { connection });
  */
 
-/** A URN handler. Receives the validated envelope and the raw BullMQ job. */
-type BabelHandler = (envelope: Envelope, job: Job) => unknown | Promise<unknown>;
+/**
+ * The out-of-band {@link HeaderCarrier} carried by a job, read from BullMQ's native
+ * `telemetry.metadata` slot (`job.opts.telemetry.metadata`). Empty for a job published without
+ * headers. Pass it to `@babelqueue/core/otel`'s `wrapHandler` to link the consumer span as a child
+ * of the producer span (ADR-0028).
+ */
+declare function headersOf(job: Job): HeaderCarrier;
+/**
+ * A URN handler. Receives the validated envelope, the raw BullMQ job, and the out-of-band
+ * {@link HeaderCarrier} carried in the job's `telemetry.metadata` (empty when there are none).
+ */
+type BabelHandler = (envelope: Envelope, job: Job, headers: HeaderCarrier) => unknown | Promise<unknown>;
 /** A map of URN → handler. */
 type BabelHandlers = Record<string, BabelHandler>;
 /** Options for {@link publish}. */
@@ -30,11 +62,22 @@ interface PublishOptions {
     traceId?: string;
     /** BullMQ job options (delay, attempts, backoff, …). */
     jobsOptions?: JobsOptions;
+    /**
+     * Out-of-band transport headers carried in BullMQ's native `telemetry.metadata` slot (ADR-0028) —
+     * e.g. a W3C `traceparent` written by `@babelqueue/core/otel`'s `publish`. The canonical envelope
+     * (`job.data`) stays byte-identical (GR-1); an empty/omitted carrier leaves the job options
+     * unchanged. An explicit `jobsOptions.telemetry.metadata` wins (it is not clobbered).
+     */
+    headers?: HeaderCarrier;
 }
 /**
  * Build the canonical envelope for `(urn, data)` and add it as a BullMQ job (the
  * job name is the URN, the job data is the envelope). Returns the message id
  * (`meta.id`).
+ *
+ * When `options.headers` carries any out-of-band header (e.g. a `traceparent`) it is serialized
+ * into the job's `telemetry.metadata` so a consumer can read it back via {@link headersOf} — the
+ * envelope itself is never touched.
  */
 declare function publish(queue: Queue, urn: string, data: Record<string, unknown>, options?: PublishOptions): Promise<string>;
 /** Options for {@link processor}. */
@@ -52,4 +95,4 @@ interface ProcessorOptions {
  */
 declare function processor(handlers: BabelHandlers, options?: ProcessorOptions): (job: Job) => Promise<unknown>;
 
-export { type BabelHandler, type BabelHandlers, type ProcessorOptions, type PublishOptions, processor, publish };
+export { type BabelHandler, type BabelHandlers, type ProcessorOptions, type PublishOptions, decodeMetadata, encodeMetadata, headersOf, processor, publish };

package/dist/index.js

@@ -4,14 +4,52 @@ import {
   EnvelopeCodec,
   UnknownUrnError
 } from "@babelqueue/core";
+
+// src/headers.ts
+function sanitizeHeaders(headers) {
+  const out = {};
+  if (!headers) return out;
+  for (const key of Object.keys(headers)) {
+    const value = headers[key];
+    if (key === "" || value == null || value === "") continue;
+    out[key] = value;
+  }
+  return out;
+}
+function encodeMetadata(headers) {
+  const clean = sanitizeHeaders(headers);
+  return Object.keys(clean).length === 0 ? void 0 : JSON.stringify(clean);
+}
+function decodeMetadata(metadata) {
+  if (!metadata) return {};
+  try {
+    const parsed = JSON.parse(metadata);
+    if (parsed == null || typeof parsed !== "object" || Array.isArray(parsed)) return {};
+    return sanitizeHeaders(parsed);
+  } catch {
+    return {};
+  }
+}
+
+// src/index.ts
+function headersOf(job) {
+  return decodeMetadata(job.opts?.telemetry?.metadata);
+}
 async function publish(queue, urn, data, options = {}) {
   const envelope = EnvelopeCodec.make(urn, data, {
     queue: queue.name,
     traceId: options.traceId
   });
-  await queue.add(urn, envelope, options.jobsOptions);
+  await queue.add(urn, envelope, withHeaders(options.jobsOptions, options.headers));
   return envelope.meta.id;
 }
+function withHeaders(jobsOptions, headers) {
+  const metadata = encodeMetadata(headers);
+  if (metadata === void 0) return jobsOptions;
+  const telemetry = jobsOptions?.telemetry;
+  if (telemetry?.metadata != null) return jobsOptions;
+  return { ...jobsOptions, telemetry: { ...telemetry, metadata } };
+}
 function processor(handlers, options = {}) {
   return async (job) => {
     const envelope = job.data;
@@ -28,10 +66,13 @@ function processor(handlers, options = {}) {
       }
       throw new UnknownUrnError(urn);
     }
-    return handler(envelope, job);
+    return handler(envelope, job, headersOf(job));
   };
 }
 export {
+  decodeMetadata,
+  encodeMetadata,
+  headersOf,
   processor,
   publish
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * BullMQ adapter for BabelQueue.\n *\n * It makes your BullMQ jobs carry the canonical BabelQueue envelope and routes\n * them by URN, so a BullMQ-based Node service speaks the same contract (envelope\n * shape, URN identity, trace propagation) as the PHP/Laravel, Python, Go, Java and\n * .NET SDKs.\n *\n *     import { Queue, Worker } from \"bullmq\";\n *     import { publish, processor } from \"@babelqueue/bullmq\";\n *\n *     const queue = new Queue(\"orders\", { connection });\n *     await publish(queue, \"urn:babel:orders:created\", { order_id: 1042 });\n *\n *     new Worker(\"orders\", processor({\n *       \"urn:babel:orders:created\": async (env) => { ... },\n *     }), { connection });\n */\n\nimport {\n  BabelQueueError,\n  EnvelopeCodec,\n  UnknownUrnError,\n  type Envelope,\n  type IncomingEnvelope,\n} from \"@babelqueue/core\";\nimport type { Job, JobsOptions, Queue } from \"bullmq\";\n\n/** A URN handler. Receives the validated envelope and the raw BullMQ job. */\nexport type BabelHandler = (envelope: Envelope, job: Job) => unknown | Promise<unknown>;\n\n/** A map of URN → handler. */\nexport type BabelHandlers = Record<string, BabelHandler>;\n\n/** Options for {@link publish}. */\nexport interface PublishOptions {\n  /** Reuse an existing trace id (trace continuation). */\n  traceId?: string;\n  /** BullMQ job options (delay, attempts, backoff, …). */\n  jobsOptions?: JobsOptions;\n}\n\n/**\n * Build the canonical envelope for `(urn, data)` and add it as a BullMQ job (the\n * job name is the URN, the job data is the envelope). Returns the message id\n * (`meta.id`).\n */\nexport async function publish(\n  queue: Queue,\n  urn: string,\n  data: Record<string, unknown>,\n  options: PublishOptions = {},\n): Promise<string> {\n  const envelope = EnvelopeCodec.make(urn, data, {\n    queue: queue.name,\n    traceId: options.traceId,\n  });\n  await queue.add(urn, envelope, options.jobsOptions);\n  return envelope.meta.id;\n}\n\n/** Options for {@link processor}. */\nexport interface ProcessorOptions {\n  /** Called instead of throwing when a job's URN has no handler. */\n  onUnknownUrn?: (envelope: IncomingEnvelope, job: Job) => unknown | Promise<unknown>;\n}\n\n/**\n * Build a BullMQ processor that decodes each job's envelope, validates it, and\n * routes it to the handler registered for its URN. A non-conformant envelope\n * throws (so BullMQ retries / fails the job per its options); an unmapped URN\n * throws unless `onUnknownUrn` is given.\n *\n *     new Worker(\"orders\", processor(handlers), { connection });\n */\nexport function processor(\n  handlers: BabelHandlers,\n  options: ProcessorOptions = {},\n): (job: Job) => Promise<unknown> {\n  return async (job: Job): Promise<unknown> => {\n    const envelope = job.data as IncomingEnvelope;\n\n    if (!EnvelopeCodec.accepts(envelope)) {\n      throw new BabelQueueError(\n        `Rejected a non-conformant BabelQueue envelope on job ${job.id ?? \"?\"}.`,\n      );\n    }\n\n    const urn = EnvelopeCodec.urn(envelope);\n    const handler = handlers[urn];\n    if (!handler) {\n      if (options.onUnknownUrn) {\n        return options.onUnknownUrn(envelope, job);\n      }\n      throw new UnknownUrnError(urn);\n    }\n\n    return handler(envelope, job);\n  };\n}\n"],"mappings":";AAmBA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAsBP,eAAsB,QACpB,OACA,KACA,MACA,UAA0B,CAAC,GACV;AACjB,QAAM,WAAW,cAAc,KAAK,KAAK,MAAM;AAAA,IAC7C,OAAO,MAAM;AAAA,IACb,SAAS,QAAQ;AAAA,EACnB,CAAC;AACD,QAAM,MAAM,IAAI,KAAK,UAAU,QAAQ,WAAW;AAClD,SAAO,SAAS,KAAK;AACvB;AAgBO,SAAS,UACd,UACA,UAA4B,CAAC,GACG;AAChC,SAAO,OAAO,QAA+B;AAC3C,UAAM,WAAW,IAAI;AAErB,QAAI,CAAC,cAAc,QAAQ,QAAQ,GAAG;AACpC,YAAM,IAAI;AAAA,QACR,wDAAwD,IAAI,MAAM,GAAG;AAAA,MACvE;AAAA,IACF;AAEA,UAAM,MAAM,cAAc,IAAI,QAAQ;AACtC,UAAM,UAAU,SAAS,GAAG;AAC5B,QAAI,CAAC,SAAS;AACZ,UAAI,QAAQ,cAAc;AACxB,eAAO,QAAQ,aAAa,UAAU,GAAG;AAAA,MAC3C;AACA,YAAM,IAAI,gBAAgB,GAAG;AAAA,IAC/B;AAEA,WAAO,QAAQ,UAAU,GAAG;AAAA,EAC9B;AACF;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/headers.ts"],"sourcesContent":["/**\n * BullMQ adapter for BabelQueue.\n *\n * It makes your BullMQ jobs carry the canonical BabelQueue envelope and routes\n * them by URN, so a BullMQ-based Node service speaks the same contract (envelope\n * shape, URN identity, trace propagation) as the PHP/Laravel, Python, Go, Java and\n * .NET SDKs.\n *\n *     import { Queue, Worker } from \"bullmq\";\n *     import { publish, processor } from \"@babelqueue/bullmq\";\n *\n *     const queue = new Queue(\"orders\", { connection });\n *     await publish(queue, \"urn:babel:orders:created\", { order_id: 1042 });\n *\n *     new Worker(\"orders\", processor({\n *       \"urn:babel:orders:created\": async (env) => { ... },\n *     }), { connection });\n */\n\nimport {\n  BabelQueueError,\n  EnvelopeCodec,\n  UnknownUrnError,\n  type Envelope,\n  type HeaderCarrier,\n  type IncomingEnvelope,\n} from \"@babelqueue/core\";\nimport type { Job, JobsOptions, Queue } from \"bullmq\";\n\nimport { decodeMetadata, encodeMetadata } from \"./headers.js\";\n\nexport { decodeMetadata, encodeMetadata } from \"./headers.js\";\n\n/**\n * The out-of-band {@link HeaderCarrier} carried by a job, read from BullMQ's native\n * `telemetry.metadata` slot (`job.opts.telemetry.metadata`). Empty for a job published without\n * headers. Pass it to `@babelqueue/core/otel`'s `wrapHandler` to link the consumer span as a child\n * of the producer span (ADR-0028).\n */\nexport function headersOf(job: Job): HeaderCarrier {\n  return decodeMetadata(job.opts?.telemetry?.metadata);\n}\n\n/**\n * A URN handler. Receives the validated envelope, the raw BullMQ job, and the out-of-band\n * {@link HeaderCarrier} carried in the job's `telemetry.metadata` (empty when there are none).\n */\nexport type BabelHandler = (envelope: Envelope, job: Job, headers: HeaderCarrier) => unknown | Promise<unknown>;\n\n/** A map of URN → handler. */\nexport type BabelHandlers = Record<string, BabelHandler>;\n\n/** Options for {@link publish}. */\nexport interface PublishOptions {\n  /** Reuse an existing trace id (trace continuation). */\n  traceId?: string;\n  /** BullMQ job options (delay, attempts, backoff, …). */\n  jobsOptions?: JobsOptions;\n  /**\n   * Out-of-band transport headers carried in BullMQ's native `telemetry.metadata` slot (ADR-0028) —\n   * e.g. a W3C `traceparent` written by `@babelqueue/core/otel`'s `publish`. The canonical envelope\n   * (`job.data`) stays byte-identical (GR-1); an empty/omitted carrier leaves the job options\n   * unchanged. An explicit `jobsOptions.telemetry.metadata` wins (it is not clobbered).\n   */\n  headers?: HeaderCarrier;\n}\n\n/**\n * Build the canonical envelope for `(urn, data)` and add it as a BullMQ job (the\n * job name is the URN, the job data is the envelope). Returns the message id\n * (`meta.id`).\n *\n * When `options.headers` carries any out-of-band header (e.g. a `traceparent`) it is serialized\n * into the job's `telemetry.metadata` so a consumer can read it back via {@link headersOf} — the\n * envelope itself is never touched.\n */\nexport async function publish(\n  queue: Queue,\n  urn: string,\n  data: Record<string, unknown>,\n  options: PublishOptions = {},\n): Promise<string> {\n  const envelope = EnvelopeCodec.make(urn, data, {\n    queue: queue.name,\n    traceId: options.traceId,\n  });\n  await queue.add(urn, envelope, withHeaders(options.jobsOptions, options.headers));\n  return envelope.meta.id;\n}\n\n/**\n * Merge an out-of-band header carrier into a job's `telemetry.metadata` without clobbering an\n * explicit one the caller already set. Returns the original options unchanged when there is nothing\n * to carry, so a header-less publish stays byte-identical.\n */\nfunction withHeaders(jobsOptions: JobsOptions | undefined, headers: HeaderCarrier | undefined): JobsOptions | undefined {\n  const metadata = encodeMetadata(headers);\n  if (metadata === undefined) return jobsOptions;\n  const telemetry = jobsOptions?.telemetry;\n  if (telemetry?.metadata != null) return jobsOptions; // an explicit metadata wins (merge-not-clobber)\n  return { ...jobsOptions, telemetry: { ...telemetry, metadata } };\n}\n\n/** Options for {@link processor}. */\nexport interface ProcessorOptions {\n  /** Called instead of throwing when a job's URN has no handler. */\n  onUnknownUrn?: (envelope: IncomingEnvelope, job: Job) => unknown | Promise<unknown>;\n}\n\n/**\n * Build a BullMQ processor that decodes each job's envelope, validates it, and\n * routes it to the handler registered for its URN. A non-conformant envelope\n * throws (so BullMQ retries / fails the job per its options); an unmapped URN\n * throws unless `onUnknownUrn` is given.\n *\n *     new Worker(\"orders\", processor(handlers), { connection });\n */\nexport function processor(\n  handlers: BabelHandlers,\n  options: ProcessorOptions = {},\n): (job: Job) => Promise<unknown> {\n  return async (job: Job): Promise<unknown> => {\n    const envelope = job.data as IncomingEnvelope;\n\n    if (!EnvelopeCodec.accepts(envelope)) {\n      throw new BabelQueueError(\n        `Rejected a non-conformant BabelQueue envelope on job ${job.id ?? \"?\"}.`,\n      );\n    }\n\n    const urn = EnvelopeCodec.urn(envelope);\n    const handler = handlers[urn];\n    if (!handler) {\n      if (options.onUnknownUrn) {\n        return options.onUnknownUrn(envelope, job);\n      }\n      throw new UnknownUrnError(urn);\n    }\n\n    return handler(envelope, job, headersOf(job));\n  };\n}\n","/**\n * Pure, dependency-free helpers for the out-of-band transport-header seam (ADR-0028) — the Node\n * adapter mirror of Go's `sanitizeHeaders` and PHP's `Support\\Headers`. They carry an injected\n * {@link HeaderCarrier} (e.g. a W3C `traceparent`) beside the frozen envelope (GR-1), never inside it.\n *\n * BullMQ has no AMQP-style header table; its native context-propagation slot is\n * `JobsOptions.telemetry.metadata` (a string, stored compactly as `tm` in Redis), so the carrier is\n * serialized to JSON there — leaving `job.data` (the canonical envelope) byte-identical.\n */\n\nimport type { HeaderCarrier } from \"@babelqueue/core\";\n\n/**\n * Copy `headers`, dropping blank keys and blank values. Returns an empty object when nothing\n * survives. A nullish input yields an empty object.\n */\nexport function sanitizeHeaders(headers: HeaderCarrier | null | undefined): HeaderCarrier {\n  const out: HeaderCarrier = {};\n  if (!headers) return out;\n  for (const key of Object.keys(headers)) {\n    const value = headers[key];\n    if (key === \"\" || value == null || value === \"\") continue;\n    out[key] = value;\n  }\n  return out;\n}\n\n/**\n * Serialize a header carrier for BullMQ's `telemetry.metadata` slot, or `undefined` when there is\n * nothing to carry (so a header-less publish leaves `telemetry` unset and the job byte-identical).\n */\nexport function encodeMetadata(headers: HeaderCarrier | null | undefined): string | undefined {\n  const clean = sanitizeHeaders(headers);\n  return Object.keys(clean).length === 0 ? undefined : JSON.stringify(clean);\n}\n\n/**\n * Read a header carrier back from a BullMQ `telemetry.metadata` string. Returns an empty object for\n * a missing or unparseable value, so a job produced without headers (or by a non-babelqueue\n * producer) consumes with no headers and no error.\n */\nexport function decodeMetadata(metadata: string | undefined | null): HeaderCarrier {\n  if (!metadata) return {};\n  try {\n    const parsed = JSON.parse(metadata) as unknown;\n    if (parsed == null || typeof parsed !== \"object\" || Array.isArray(parsed)) return {};\n    return sanitizeHeaders(parsed as HeaderCarrier);\n  } catch {\n    return {};\n  }\n}\n"],"mappings":";AAmBA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAIK;;;ACVA,SAAS,gBAAgB,SAA0D;AACxF,QAAM,MAAqB,CAAC;AAC5B,MAAI,CAAC,QAAS,QAAO;AACrB,aAAW,OAAO,OAAO,KAAK,OAAO,GAAG;AACtC,UAAM,QAAQ,QAAQ,GAAG;AACzB,QAAI,QAAQ,MAAM,SAAS,QAAQ,UAAU,GAAI;AACjD,QAAI,GAAG,IAAI;AAAA,EACb;AACA,SAAO;AACT;AAMO,SAAS,eAAe,SAA+D;AAC5F,QAAM,QAAQ,gBAAgB,OAAO;AACrC,SAAO,OAAO,KAAK,KAAK,EAAE,WAAW,IAAI,SAAY,KAAK,UAAU,KAAK;AAC3E;AAOO,SAAS,eAAe,UAAoD;AACjF,MAAI,CAAC,SAAU,QAAO,CAAC;AACvB,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,QAAQ;AAClC,QAAI,UAAU,QAAQ,OAAO,WAAW,YAAY,MAAM,QAAQ,MAAM,EAAG,QAAO,CAAC;AACnF,WAAO,gBAAgB,MAAuB;AAAA,EAChD,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;;;ADXO,SAAS,UAAU,KAAyB;AACjD,SAAO,eAAe,IAAI,MAAM,WAAW,QAAQ;AACrD;AAmCA,eAAsB,QACpB,OACA,KACA,MACA,UAA0B,CAAC,GACV;AACjB,QAAM,WAAW,cAAc,KAAK,KAAK,MAAM;AAAA,IAC7C,OAAO,MAAM;AAAA,IACb,SAAS,QAAQ;AAAA,EACnB,CAAC;AACD,QAAM,MAAM,IAAI,KAAK,UAAU,YAAY,QAAQ,aAAa,QAAQ,OAAO,CAAC;AAChF,SAAO,SAAS,KAAK;AACvB;AAOA,SAAS,YAAY,aAAsC,SAA6D;AACtH,QAAM,WAAW,eAAe,OAAO;AACvC,MAAI,aAAa,OAAW,QAAO;AACnC,QAAM,YAAY,aAAa;AAC/B,MAAI,WAAW,YAAY,KAAM,QAAO;AACxC,SAAO,EAAE,GAAG,aAAa,WAAW,EAAE,GAAG,WAAW,SAAS,EAAE;AACjE;AAgBO,SAAS,UACd,UACA,UAA4B,CAAC,GACG;AAChC,SAAO,OAAO,QAA+B;AAC3C,UAAM,WAAW,IAAI;AAErB,QAAI,CAAC,cAAc,QAAQ,QAAQ,GAAG;AACpC,YAAM,IAAI;AAAA,QACR,wDAAwD,IAAI,MAAM,GAAG;AAAA,MACvE;AAAA,IACF;AAEA,UAAM,MAAM,cAAc,IAAI,QAAQ;AACtC,UAAM,UAAU,SAAS,GAAG;AAC5B,QAAI,CAAC,SAAS;AACZ,UAAI,QAAQ,cAAc;AACxB,eAAO,QAAQ,aAAa,UAAU,GAAG;AAAA,MAC3C;AACA,YAAM,IAAI,gBAAgB,GAAG;AAAA,IAC/B;AAEA,WAAO,QAAQ,UAAU,KAAK,UAAU,GAAG,CAAC;AAAA,EAC9C;AACF;","names":[]}

package/package.json

@@ -1,8 +1,15 @@
 {
   "name": "@babelqueue/bullmq",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "BullMQ adapter for BabelQueue — canonical-envelope jobs and a URN-routed processor.",
-  "keywords": ["babelqueue", "bullmq", "queue", "polyglot", "redis", "messaging"],
+  "keywords": [
+    "babelqueue",
+    "bullmq",
+    "queue",
+    "polyglot",
+    "redis",
+    "messaging"
+  ],
   "homepage": "https://babelqueue.com",
   "bugs": {
     "url": "https://github.com/BabelQueue/babelqueue-node-adapters/issues"
@@ -30,7 +37,9 @@
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "sideEffects": false,
   "engines": {
     "node": ">=18"
@@ -41,7 +50,7 @@
     "test": "node --import tsx --test test/*.test.ts"
   },
   "dependencies": {
-    "@babelqueue/core": "^1.0.0"
+    "@babelqueue/core": "^1.4.0"
   },
   "peerDependencies": {
     "bullmq": "^5.0.0"