@boringnode/queue 0.5.0 → 0.5.2

package/build/src/drivers/sync_adapter.js

@@ -1,13 +1,17 @@
 import {
   JobExecutionRuntime
-} from "../../chunk-WOUYSNK2.js";
+} from "../../chunk-KI47AJ6U.js";
 import {
   Locator,
   QueueManager
-} from "../../chunk-OVYXMSSU.js";
+} from "../../chunk-VRXHCWNK.js";
+import {
+  executeChannel
+} from "../../chunk-WVLSICD4.js";
 import {
   DEFAULT_PRIORITY
-} from "../../chunk-ZZFSQY36.js";
+} from "../../chunk-QEFYHCL7.js";
+import "../../chunk-PZ5AY32C.js";
 
 // src/drivers/sync_adapter.ts
 import { setTimeout as sleep } from "timers/promises";
@@ -113,33 +117,49 @@ var SyncAdapter = class {
       defaultTimeout: configResolver.getWorkerTimeout()
     });
     const jobFactory = QueueManager.getJobFactory();
+    const executionWrapper = QueueManager.getExecutionWrapper();
     let attempts = jobData.attempts;
     while (true) {
+      const now = Date.now();
+      const acquiredJob = { ...jobData, attempts, acquiredAt: now };
       const context = {
         jobId: jobData.id,
         name: jobData.name,
         attempt: attempts + 1,
         queue,
         priority: jobData.priority ?? DEFAULT_PRIORITY,
-        acquiredAt: /* @__PURE__ */ new Date(),
+        acquiredAt: new Date(now),
         stalledCount: jobData.stalledCount ?? 0
       };
       const jobInstance = jobFactory ? await jobFactory(JobClass) : new JobClass();
-      try {
-        await runtime.execute(jobInstance, jobData.payload, context);
-        return;
-      } catch (error) {
-        const outcome = runtime.resolveFailure(error, attempts);
-        if (outcome.type === "failed") {
-          await jobInstance.failed?.(outcome.hookError);
-          return;
-        }
-        attempts++;
-        if (outcome.type === "retry" && outcome.retryAt) {
-          const delay = outcome.retryAt.getTime() - Date.now();
-          if (delay > 0) {
-            await sleep(delay);
+      const startTime = performance.now();
+      const executeMessage = { job: acquiredJob, queue };
+      const run = () => {
+        return executeChannel.tracePromise(async () => {
+          try {
+            await runtime.execute(jobInstance, jobData.payload, context);
+            executeMessage.status = "completed";
+          } catch (error) {
+            const outcome = runtime.resolveFailure(error, attempts);
+            executeMessage.error = error;
+            if (outcome.type === "failed") {
+              executeMessage.status = "failed";
+              await jobInstance.failed?.(outcome.hookError);
+            } else if (outcome.type === "retry") {
+              executeMessage.status = "retrying";
+              executeMessage.nextRetryAt = outcome.retryAt;
+            }
           }
+          executeMessage.duration = Number((performance.now() - startTime).toFixed(2));
+        }, executeMessage);
+      };
+      await executionWrapper(run, acquiredJob, queue);
+      if (executeMessage.status !== "retrying") return;
+      attempts++;
+      if (executeMessage.nextRetryAt) {
+        const delay = executeMessage.nextRetryAt.getTime() - Date.now();
+        if (delay > 0) {
+          await sleep(delay);
         }
       }
     }

package/build/src/drivers/sync_adapter.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/drivers/sync_adapter.ts"],"sourcesContent":["import { setTimeout as sleep } from 'node:timers/promises'\nimport { Locator } from '../locator.js'\nimport { QueueManager } from '../queue_manager.js'\nimport { JobExecutionRuntime } from '../job_runtime.js'\nimport type { Adapter, AcquiredJob } from '../contracts/adapter.js'\nimport type {\n  JobContext,\n  JobData,\n  JobRetention,\n  ScheduleConfig,\n  ScheduleData,\n  ScheduleListOptions,\n} from '../types/main.js'\nimport { DEFAULT_PRIORITY } from '../constants.js'\n\n/**\n * Create a sync adapter factory.\n */\nexport function sync() {\n  return () => new SyncAdapter()\n}\n\n/**\n * Sync adapter executes jobs immediately when pushed.\n * Pop/complete/fail/retry are not supported as jobs are executed synchronously.\n */\nexport class SyncAdapter implements Adapter {\n  setWorkerId(_workerId: string): void {}\n\n  push(jobData: JobData): Promise<void> {\n    return this.pushOn('default', jobData)\n  }\n\n  pushOn(queue: string, jobData: JobData): Promise<void> {\n    return this.#execute(jobData, queue)\n  }\n\n  pushLater(jobData: JobData, delay: number): Promise<void> {\n    return this.pushLaterOn('default', jobData, delay)\n  }\n\n  pushLaterOn(queue: string, jobData: JobData, delay: number): Promise<void> {\n    setTimeout(() => {\n      void this.#execute(jobData, queue).catch((error) => {\n        QueueManager.getLogger().error(\n          { err: error, jobId: jobData.id, jobName: jobData.name, queue },\n          'Failed to execute delayed sync job'\n        )\n      })\n    }, delay)\n\n    return Promise.resolve()\n  }\n\n  pushMany(jobs: JobData[]): Promise<void> {\n    return this.pushManyOn('default', jobs)\n  }\n\n  async pushManyOn(queue: string, jobs: JobData[]): Promise<void> {\n    for (const job of jobs) {\n      await this.pushOn(queue, job)\n    }\n  }\n\n  size(): Promise<number> {\n    return this.sizeOf('default')\n  }\n\n  sizeOf(_queue: string): Promise<number> {\n    return Promise.resolve(0)\n  }\n\n  pop(): Promise<AcquiredJob | null> {\n    return this.popFrom('default')\n  }\n\n  popFrom(_queue: string): Promise<AcquiredJob | null> {\n    throw new Error('SyncAdapter does not support pop - jobs are executed immediately on push')\n  }\n\n  completeJob(_jobId: string, _queue: string, _removeOnComplete?: JobRetention): Promise<void> {\n    return Promise.resolve()\n  }\n\n  failJob(\n    _jobId: string,\n    _queue: string,\n    _error?: Error,\n    _removeOnFail?: JobRetention\n  ): Promise<void> {\n    return Promise.resolve()\n  }\n\n  retryJob(_jobId: string, _queue: string, _retryAt?: Date): Promise<void> {\n    return Promise.resolve()\n  }\n\n  recoverStalledJobs(\n    _queue: string,\n    _stalledThreshold: number,\n    _maxStalledCount: number\n  ): Promise<number> {\n    // SyncAdapter has no stalled jobs - jobs are executed immediately\n    return Promise.resolve(0)\n  }\n\n  getJob(_jobId: string, _queue: string): Promise<null> {\n    return Promise.resolve(null)\n  }\n\n  destroy(): Promise<void> {\n    return Promise.resolve()\n  }\n\n  upsertSchedule(_config: ScheduleConfig): Promise<string> {\n    // No-op: schedules don't make sense for sync adapter\n    // Return a fake ID so code doesn't break in dev\n    return Promise.resolve(`sync-schedule-${Date.now()}`)\n  }\n\n  /**\n   * @deprecated Use `upsertSchedule` instead.\n   */\n  createSchedule(config: ScheduleConfig): Promise<string> {\n    return this.upsertSchedule(config)\n  }\n\n  getSchedule(_id: string): Promise<ScheduleData | null> {\n    return Promise.resolve(null)\n  }\n\n  listSchedules(_options?: ScheduleListOptions): Promise<ScheduleData[]> {\n    return Promise.resolve([])\n  }\n\n  updateSchedule(\n    _id: string,\n    _updates: Partial<Pick<ScheduleData, 'status' | 'nextRunAt' | 'lastRunAt' | 'runCount'>>\n  ): Promise<void> {\n    return Promise.resolve()\n  }\n\n  deleteSchedule(_id: string): Promise<void> {\n    return Promise.resolve()\n  }\n\n  claimDueSchedule(): Promise<ScheduleData | null> {\n    // SyncAdapter doesn't support scheduling\n    return Promise.resolve(null)\n  }\n\n  async #execute(jobData: JobData, queue: string = 'default'): Promise<void> {\n    const JobClass = Locator.get(jobData.name)\n\n    if (!JobClass) {\n      throw new Error(`Job class ${jobData.name} not found.`)\n    }\n\n    const options = JobClass.options || {}\n    const configResolver = QueueManager.getConfigResolver()\n    const runtime = JobExecutionRuntime.from({\n      jobName: jobData.name,\n      options,\n      retryConfig: configResolver.resolveRetryConfig(queue, options),\n      defaultTimeout: configResolver.getWorkerTimeout(),\n    })\n    const jobFactory = QueueManager.getJobFactory()\n    let attempts = jobData.attempts\n\n    while (true) {\n      const context: JobContext = {\n        jobId: jobData.id,\n        name: jobData.name,\n        attempt: attempts + 1,\n        queue,\n        priority: jobData.priority ?? DEFAULT_PRIORITY,\n        acquiredAt: new Date(),\n        stalledCount: jobData.stalledCount ?? 0,\n      }\n\n      const jobInstance = jobFactory ? await jobFactory(JobClass) : new JobClass()\n\n      try {\n        await runtime.execute(jobInstance, jobData.payload, context)\n        return\n      } catch (error) {\n        const outcome = runtime.resolveFailure(error as Error, attempts)\n\n        if (outcome.type === 'failed') {\n          await jobInstance.failed?.(outcome.hookError)\n          return\n        }\n\n        attempts++\n\n        if (outcome.type === 'retry' && outcome.retryAt) {\n          const delay = outcome.retryAt.getTime() - Date.now()\n\n          if (delay > 0) {\n            await sleep(delay)\n          }\n        }\n      }\n    }\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/drivers/sync_adapter.ts"],"sourcesContent":["import { setTimeout as sleep } from 'node:timers/promises'\nimport { Locator } from '../locator.js'\nimport { QueueManager } from '../queue_manager.js'\nimport { JobExecutionRuntime } from '../job_runtime.js'\nimport { executeChannel } from '../tracing_channels.js'\nimport type { Adapter, AcquiredJob } from '../contracts/adapter.js'\nimport type {\n  JobContext,\n  JobData,\n  JobRetention,\n  ScheduleConfig,\n  ScheduleData,\n  ScheduleListOptions,\n} from '../types/main.js'\nimport type { JobExecuteMessage } from '../types/tracing_channels.js'\nimport { DEFAULT_PRIORITY } from '../constants.js'\n\n/**\n * Create a sync adapter factory.\n */\nexport function sync() {\n  return () => new SyncAdapter()\n}\n\n/**\n * Sync adapter executes jobs immediately when pushed.\n * Pop/complete/fail/retry are not supported as jobs are executed synchronously.\n */\nexport class SyncAdapter implements Adapter {\n  setWorkerId(_workerId: string): void {}\n\n  push(jobData: JobData): Promise<void> {\n    return this.pushOn('default', jobData)\n  }\n\n  pushOn(queue: string, jobData: JobData): Promise<void> {\n    return this.#execute(jobData, queue)\n  }\n\n  pushLater(jobData: JobData, delay: number): Promise<void> {\n    return this.pushLaterOn('default', jobData, delay)\n  }\n\n  pushLaterOn(queue: string, jobData: JobData, delay: number): Promise<void> {\n    setTimeout(() => {\n      void this.#execute(jobData, queue).catch((error) => {\n        QueueManager.getLogger().error(\n          { err: error, jobId: jobData.id, jobName: jobData.name, queue },\n          'Failed to execute delayed sync job'\n        )\n      })\n    }, delay)\n\n    return Promise.resolve()\n  }\n\n  pushMany(jobs: JobData[]): Promise<void> {\n    return this.pushManyOn('default', jobs)\n  }\n\n  async pushManyOn(queue: string, jobs: JobData[]): Promise<void> {\n    for (const job of jobs) {\n      await this.pushOn(queue, job)\n    }\n  }\n\n  size(): Promise<number> {\n    return this.sizeOf('default')\n  }\n\n  sizeOf(_queue: string): Promise<number> {\n    return Promise.resolve(0)\n  }\n\n  pop(): Promise<AcquiredJob | null> {\n    return this.popFrom('default')\n  }\n\n  popFrom(_queue: string): Promise<AcquiredJob | null> {\n    throw new Error('SyncAdapter does not support pop - jobs are executed immediately on push')\n  }\n\n  completeJob(_jobId: string, _queue: string, _removeOnComplete?: JobRetention): Promise<void> {\n    return Promise.resolve()\n  }\n\n  failJob(\n    _jobId: string,\n    _queue: string,\n    _error?: Error,\n    _removeOnFail?: JobRetention\n  ): Promise<void> {\n    return Promise.resolve()\n  }\n\n  retryJob(_jobId: string, _queue: string, _retryAt?: Date): Promise<void> {\n    return Promise.resolve()\n  }\n\n  recoverStalledJobs(\n    _queue: string,\n    _stalledThreshold: number,\n    _maxStalledCount: number\n  ): Promise<number> {\n    // SyncAdapter has no stalled jobs - jobs are executed immediately\n    return Promise.resolve(0)\n  }\n\n  getJob(_jobId: string, _queue: string): Promise<null> {\n    return Promise.resolve(null)\n  }\n\n  destroy(): Promise<void> {\n    return Promise.resolve()\n  }\n\n  upsertSchedule(_config: ScheduleConfig): Promise<string> {\n    // No-op: schedules don't make sense for sync adapter\n    // Return a fake ID so code doesn't break in dev\n    return Promise.resolve(`sync-schedule-${Date.now()}`)\n  }\n\n  /**\n   * @deprecated Use `upsertSchedule` instead.\n   */\n  createSchedule(config: ScheduleConfig): Promise<string> {\n    return this.upsertSchedule(config)\n  }\n\n  getSchedule(_id: string): Promise<ScheduleData | null> {\n    return Promise.resolve(null)\n  }\n\n  listSchedules(_options?: ScheduleListOptions): Promise<ScheduleData[]> {\n    return Promise.resolve([])\n  }\n\n  updateSchedule(\n    _id: string,\n    _updates: Partial<Pick<ScheduleData, 'status' | 'nextRunAt' | 'lastRunAt' | 'runCount'>>\n  ): Promise<void> {\n    return Promise.resolve()\n  }\n\n  deleteSchedule(_id: string): Promise<void> {\n    return Promise.resolve()\n  }\n\n  claimDueSchedule(): Promise<ScheduleData | null> {\n    // SyncAdapter doesn't support scheduling\n    return Promise.resolve(null)\n  }\n\n  async #execute(jobData: JobData, queue: string = 'default'): Promise<void> {\n    const JobClass = Locator.get(jobData.name)\n\n    if (!JobClass) {\n      throw new Error(`Job class ${jobData.name} not found.`)\n    }\n\n    const options = JobClass.options || {}\n    const configResolver = QueueManager.getConfigResolver()\n    const runtime = JobExecutionRuntime.from({\n      jobName: jobData.name,\n      options,\n      retryConfig: configResolver.resolveRetryConfig(queue, options),\n      defaultTimeout: configResolver.getWorkerTimeout(),\n    })\n    const jobFactory = QueueManager.getJobFactory()\n    const executionWrapper = QueueManager.getExecutionWrapper()\n    let attempts = jobData.attempts\n\n    while (true) {\n      const now = Date.now()\n      const acquiredJob: AcquiredJob = { ...jobData, attempts, acquiredAt: now }\n\n      const context: JobContext = {\n        jobId: jobData.id,\n        name: jobData.name,\n        attempt: attempts + 1,\n        queue,\n        priority: jobData.priority ?? DEFAULT_PRIORITY,\n        acquiredAt: new Date(now),\n        stalledCount: jobData.stalledCount ?? 0,\n      }\n\n      const jobInstance = jobFactory ? await jobFactory(JobClass) : new JobClass()\n\n      const startTime = performance.now()\n      const executeMessage: JobExecuteMessage = { job: acquiredJob, queue }\n\n      const run = () => {\n        return executeChannel.tracePromise(async () => {\n          try {\n            await runtime.execute(jobInstance, jobData.payload, context)\n            executeMessage.status = 'completed'\n          } catch (error) {\n            const outcome = runtime.resolveFailure(error as Error, attempts)\n            executeMessage.error = error as Error\n\n            if (outcome.type === 'failed') {\n              executeMessage.status = 'failed'\n              await jobInstance.failed?.(outcome.hookError)\n            } else if (outcome.type === 'retry') {\n              executeMessage.status = 'retrying'\n              executeMessage.nextRetryAt = outcome.retryAt\n            }\n          }\n\n          executeMessage.duration = Number((performance.now() - startTime).toFixed(2))\n        }, executeMessage)\n      }\n\n      await executionWrapper(run, acquiredJob, queue)\n\n      if (executeMessage.status !== 'retrying') return\n\n      attempts++\n\n      if (executeMessage.nextRetryAt) {\n        const delay = executeMessage.nextRetryAt.getTime() - Date.now()\n        if (delay > 0) {\n          await sleep(delay)\n        }\n      }\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/build/src/otel.d.ts

@@ -0,0 +1,63 @@
+import '../job-Z5fBSzRX.js';
+import { JobDispatchMessage, JobExecuteMessage } from './types/tracing_channels.js';
+import { Span } from '@opentelemetry/api';
+import { TracingChannelSubscribers } from 'node:diagnostics_channel';
+import { InstrumentationConfig, InstrumentationBase } from '@opentelemetry/instrumentation';
+
+interface QueueInstrumentationConfig extends InstrumentationConfig {
+    /**
+     * How execution spans relate to the dispatch span.
+     *
+     * - `'link'` (default): Independent trace, linked to dispatch span
+     * - `'parent'`: Child of the dispatch span (same trace)
+     */
+    executionSpanLinkMode?: 'link' | 'parent';
+    /**
+     * The messaging system identifier.
+     *
+     * @default 'boringqueue'
+     */
+    messagingSystem?: string;
+}
+/**
+ * OpenTelemetry instrumentation for @boringnode/queue.
+ *
+ * Creates PRODUCER spans for job dispatch and CONSUMER spans for
+ * job execution, following OTel messaging semantic conventions.
+ *
+ * Uses `diagnostics_channel` for span lifecycle management and
+ * patches `QueueManager.init()` to inject wrappers automatically.
+ */
+declare class QueueInstrumentation extends InstrumentationBase<QueueInstrumentationConfig> {
+    #private;
+    protected subscribed: boolean;
+    protected executeSpans: Map<string, Span>;
+    protected dispatchSpans: WeakMap<JobDispatchMessage, Span>;
+    protected executeHandlers?: TracingChannelSubscribers<JobExecuteMessage>;
+    protected dispatchHandlers?: TracingChannelSubscribers<JobDispatchMessage>;
+    constructor(config?: QueueInstrumentationConfig);
+    /**
+     * Required by InstrumentationBase. Returns undefined since we use
+     * diagnostics_channel instead of module patching.
+     */
+    protected init(): undefined;
+    /**
+     * Subscribes to diagnostics_channels for span lifecycle.
+     */
+    enable(): void;
+    /**
+     * Unsubscribes from diagnostics_channels and restores patched methods.
+     */
+    disable(): void;
+    /**
+     * Patches `QueueManager.init()` to auto-inject OTel wrappers
+     * and subscribes to diagnostics_channels.
+     */
+    manuallyRegister(queueModule: {
+        QueueManager: {
+            init: (...args: any[]) => any;
+        };
+    }): void;
+}
+
+export { QueueInstrumentation, type QueueInstrumentationConfig };

package/build/src/otel.js

@@ -0,0 +1,245 @@
+import {
+  dispatchChannel,
+  executeChannel
+} from "../chunk-WVLSICD4.js";
+import "../chunk-PZ5AY32C.js";
+
+// src/otel.ts
+import {
+  context,
+  propagation,
+  trace,
+  SpanKind,
+  SpanStatusCode,
+  ROOT_CONTEXT
+} from "@opentelemetry/api";
+import { suppressTracing } from "@opentelemetry/core";
+import { InstrumentationBase } from "@opentelemetry/instrumentation";
+var QueueInstrumentation = class extends InstrumentationBase {
+  subscribed = false;
+  executeSpans = /* @__PURE__ */ new Map();
+  dispatchSpans = /* @__PURE__ */ new WeakMap();
+  executeHandlers;
+  dispatchHandlers;
+  #originalInit;
+  #patchedManager;
+  constructor(config = {}) {
+    super("@boringnode/queue", "0.1.0", config);
+  }
+  get #messagingSystem() {
+    return this.getConfig().messagingSystem ?? "boringqueue";
+  }
+  get #executionSpanLinkMode() {
+    return this.getConfig().executionSpanLinkMode ?? "link";
+  }
+  /**
+   * Required by InstrumentationBase. Returns undefined since we use
+   * diagnostics_channel instead of module patching.
+   */
+  init() {
+    return void 0;
+  }
+  /**
+   * Subscribes to diagnostics_channels for span lifecycle.
+   */
+  enable() {
+    super.enable();
+    if (this.subscribed !== void 0) this.#subscribe();
+  }
+  /**
+   * Unsubscribes from diagnostics_channels and restores patched methods.
+   */
+  disable() {
+    if (this.subscribed !== void 0) {
+      this.#unsubscribe();
+      this.#unpatchInit();
+    }
+    super.disable();
+  }
+  /**
+   * Patches `QueueManager.init()` to auto-inject OTel wrappers
+   * and subscribes to diagnostics_channels.
+   */
+  manuallyRegister(queueModule) {
+    this.#patchInit(queueModule.QueueManager);
+    this.#subscribe();
+  }
+  #patchInit(manager) {
+    if (this.#originalInit) return;
+    this.#patchedManager = manager;
+    this.#originalInit = manager.init.bind(manager);
+    const instrumentation = this;
+    manager.init = async (config) => {
+      return this.#originalInit({
+        ...config,
+        internalOperationWrapper: (fn) => {
+          return context.with(suppressTracing(context.active()), fn);
+        },
+        executionWrapper: (fn, job, queue) => {
+          return instrumentation.#wrapExecution(fn, job, queue);
+        }
+      });
+    };
+  }
+  #unpatchInit() {
+    if (!this.#originalInit || !this.#patchedManager) return;
+    this.#patchedManager.init = this.#originalInit;
+    this.#originalInit = void 0;
+    this.#patchedManager = void 0;
+  }
+  #subscribe() {
+    if (this.subscribed) return;
+    if (!this.isEnabled()) return;
+    this.subscribed = true;
+    this.executeHandlers = {
+      start: () => {
+      },
+      end: () => {
+      },
+      asyncStart: () => {
+      },
+      asyncEnd: (msg) => this.#handleExecuteAsyncEnd(msg),
+      error: () => {
+      }
+    };
+    this.dispatchHandlers = {
+      start: (msg) => this.#handleDispatchStart(msg),
+      end: () => {
+      },
+      asyncStart: () => {
+      },
+      asyncEnd: (msg) => this.#handleDispatchAsyncEnd(msg),
+      error: () => {
+      }
+    };
+    executeChannel.subscribe(this.executeHandlers);
+    dispatchChannel.subscribe(this.dispatchHandlers);
+  }
+  #unsubscribe() {
+    if (!this.subscribed) return;
+    if (this.executeHandlers) executeChannel.unsubscribe(this.executeHandlers);
+    if (this.dispatchHandlers) dispatchChannel.unsubscribe(this.dispatchHandlers);
+    this.subscribed = false;
+    this.executeHandlers = void 0;
+    this.dispatchHandlers = void 0;
+    this.executeSpans.clear();
+    this.dispatchSpans = /* @__PURE__ */ new WeakMap();
+  }
+  /**
+   * Called on dispatchChannel `start` — injects trace context into jobData
+   * and creates/enriches a PRODUCER span.
+   */
+  #handleDispatchStart(message) {
+    const attributes = this.#buildDispatchAttributes(message);
+    const span = this.tracer.startSpan(`publish ${message.queue}`, {
+      kind: SpanKind.PRODUCER,
+      attributes
+    });
+    const dispatchContext = trace.setSpan(context.active(), span);
+    for (const job of message.jobs) {
+      if (!job.traceContext) job.traceContext = {};
+      propagation.inject(dispatchContext, job.traceContext);
+    }
+    this.dispatchSpans.set(message, span);
+  }
+  #handleDispatchAsyncEnd(message) {
+    const span = this.dispatchSpans.get(message);
+    if (!span) return;
+    if (message.error) {
+      span.recordException(message.error);
+      span.setStatus({ code: SpanStatusCode.ERROR, message: message.error.message });
+    }
+    span.end();
+    this.dispatchSpans.delete(message);
+  }
+  /**
+   * Called by `executionWrapper` config — creates CONSUMER span and wraps
+   * execution in OTel context for proper child span parenting.
+   */
+  #wrapExecution(fn, job, queue) {
+    const extractedContext = this.#extractParentContext(job.traceContext);
+    const parentSpanContext = trace.getSpanContext(extractedContext);
+    let baseContext;
+    let links;
+    if (this.#executionSpanLinkMode === "parent" && parentSpanContext) {
+      baseContext = extractedContext;
+      links = [];
+    } else {
+      links = parentSpanContext ? [{ context: parentSpanContext }] : [];
+      baseContext = ROOT_CONTEXT;
+    }
+    const span = this.tracer.startSpan(
+      `process ${queue}`,
+      {
+        kind: SpanKind.CONSUMER,
+        attributes: this.#buildExecuteAttributes(job, queue),
+        links
+      },
+      baseContext
+    );
+    if (job.createdAt) {
+      span.setAttribute("messaging.job.queue_time_ms", Date.now() - job.createdAt);
+    }
+    this.executeSpans.set(job.id, span);
+    const executionContext = trace.setSpan(baseContext, span);
+    return context.with(executionContext, fn);
+  }
+  #handleExecuteAsyncEnd(message) {
+    const span = this.executeSpans.get(message.job.id);
+    if (!span) return;
+    if (message.status) span.setAttribute("messaging.job.status", message.status);
+    if (message.error) span.recordException(message.error);
+    if (message.status === "retrying" && message.nextRetryAt) {
+      span.addEvent("messaging.retry", {
+        "messaging.message.retry.count": message.job.attempts + 1,
+        "messaging.job.retry_at": message.nextRetryAt.toISOString()
+      });
+    }
+    if (message.status === "failed") {
+      span.setStatus({ code: SpanStatusCode.ERROR, message: message.error?.message });
+    } else {
+      span.setStatus({ code: SpanStatusCode.OK });
+    }
+    span.end();
+    this.executeSpans.delete(message.job.id);
+  }
+  #extractParentContext(traceContext) {
+    if (!traceContext || Object.keys(traceContext).length === 0) return ROOT_CONTEXT;
+    return propagation.extract(ROOT_CONTEXT, traceContext);
+  }
+  #buildDispatchAttributes(message) {
+    const firstJob = message.jobs[0];
+    const attributes = {
+      "messaging.system": this.#messagingSystem,
+      "messaging.operation.name": "publish",
+      "messaging.operation.type": "send",
+      "messaging.destination.name": message.queue,
+      "messaging.job.name": firstJob.name
+    };
+    if (message.jobs.length === 1) attributes["messaging.message.id"] = firstJob.id;
+    if (message.jobs.length > 1) attributes["messaging.batch.message_count"] = message.jobs.length;
+    if (firstJob.groupId) attributes["messaging.job.group_id"] = firstJob.groupId;
+    if (firstJob.priority !== void 0) attributes["messaging.job.priority"] = firstJob.priority;
+    if (message.delay !== void 0) attributes["messaging.job.delay_ms"] = message.delay;
+    return attributes;
+  }
+  #buildExecuteAttributes(job, queue) {
+    const attributes = {
+      "entry_point.type": "job",
+      "messaging.system": this.#messagingSystem,
+      "messaging.operation.name": "process",
+      "messaging.operation.type": "process",
+      "messaging.destination.name": queue,
+      "messaging.message.id": job.id,
+      "messaging.message.retry.count": job.attempts,
+      "messaging.job.name": job.name
+    };
+    if (job.groupId) attributes["messaging.job.group_id"] = job.groupId;
+    if (job.priority !== void 0) attributes["messaging.job.priority"] = job.priority;
+    return attributes;
+  }
+};
+export {
+  QueueInstrumentation
+};
+//# sourceMappingURL=otel.js.map

package/build/src/otel.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/otel.ts"],"sourcesContent":["import {\n  context,\n  propagation,\n  trace,\n  SpanKind,\n  SpanStatusCode,\n  ROOT_CONTEXT,\n  type Span,\n  type Link,\n} from '@opentelemetry/api'\nimport type { TracingChannelSubscribers } from 'node:diagnostics_channel'\nimport { suppressTracing } from '@opentelemetry/core'\nimport { InstrumentationBase } from '@opentelemetry/instrumentation'\nimport type { InstrumentationConfig } from '@opentelemetry/instrumentation'\nimport { dispatchChannel, executeChannel } from './tracing_channels.js'\nimport type { AcquiredJob } from './contracts/adapter.js'\nimport type { JobDispatchMessage, JobExecuteMessage } from './types/tracing_channels.js'\n\nexport interface QueueInstrumentationConfig extends InstrumentationConfig {\n  /**\n   * How execution spans relate to the dispatch span.\n   *\n   * - `'link'` (default): Independent trace, linked to dispatch span\n   * - `'parent'`: Child of the dispatch span (same trace)\n   */\n  executionSpanLinkMode?: 'link' | 'parent'\n\n  /**\n   * The messaging system identifier.\n   *\n   * @default 'boringqueue'\n   */\n  messagingSystem?: string\n}\n\n/**\n * OpenTelemetry instrumentation for @boringnode/queue.\n *\n * Creates PRODUCER spans for job dispatch and CONSUMER spans for\n * job execution, following OTel messaging semantic conventions.\n *\n * Uses `diagnostics_channel` for span lifecycle management and\n * patches `QueueManager.init()` to inject wrappers automatically.\n */\nexport class QueueInstrumentation extends InstrumentationBase<QueueInstrumentationConfig> {\n  protected subscribed = false\n  protected executeSpans = new Map<string, Span>()\n  protected dispatchSpans = new WeakMap<JobDispatchMessage, Span>()\n  protected executeHandlers?: TracingChannelSubscribers<JobExecuteMessage>\n  protected dispatchHandlers?: TracingChannelSubscribers<JobDispatchMessage>\n\n  #originalInit?: (...args: any[]) => any\n  #patchedManager?: { init: (...args: any[]) => any }\n\n  constructor(config: QueueInstrumentationConfig = {}) {\n    super('@boringnode/queue', '0.1.0', config)\n  }\n\n  get #messagingSystem(): string {\n    return this.getConfig().messagingSystem ?? 'boringqueue'\n  }\n\n  get #executionSpanLinkMode(): 'link' | 'parent' {\n    return this.getConfig().executionSpanLinkMode ?? 'link'\n  }\n\n  /**\n   * Required by InstrumentationBase. Returns undefined since we use\n   * diagnostics_channel instead of module patching.\n   */\n  protected init() {\n    return undefined\n  }\n\n  /**\n   * Subscribes to diagnostics_channels for span lifecycle.\n   */\n  enable() {\n    super.enable()\n    if (this.subscribed !== undefined) this.#subscribe()\n  }\n\n  /**\n   * Unsubscribes from diagnostics_channels and restores patched methods.\n   */\n  disable() {\n    if (this.subscribed !== undefined) {\n      this.#unsubscribe()\n      this.#unpatchInit()\n    }\n\n    super.disable()\n  }\n\n  /**\n   * Patches `QueueManager.init()` to auto-inject OTel wrappers\n   * and subscribes to diagnostics_channels.\n   */\n  manuallyRegister(queueModule: { QueueManager: { init: (...args: any[]) => any } }) {\n    this.#patchInit(queueModule.QueueManager)\n    this.#subscribe()\n  }\n\n  #patchInit(manager: { init: (...args: any[]) => any }) {\n    if (this.#originalInit) return\n\n    this.#patchedManager = manager\n    this.#originalInit = manager.init.bind(manager)\n    const instrumentation = this\n\n    manager.init = async (config: any) => {\n      return this.#originalInit!({\n        ...config,\n        internalOperationWrapper: <T>(fn: () => Promise<T>) => {\n          return context.with(suppressTracing(context.active()), fn)\n        },\n        executionWrapper: <T>(fn: () => Promise<T>, job: AcquiredJob, queue: string) => {\n          return instrumentation.#wrapExecution(fn, job, queue)\n        },\n      })\n    }\n  }\n\n  #unpatchInit() {\n    if (!this.#originalInit || !this.#patchedManager) return\n\n    this.#patchedManager.init = this.#originalInit\n    this.#originalInit = undefined\n    this.#patchedManager = undefined\n  }\n\n  #subscribe() {\n    if (this.subscribed) return\n    if (!this.isEnabled()) return\n\n    this.subscribed = true\n\n    this.executeHandlers = {\n      start: () => {},\n      end: () => {},\n      asyncStart: () => {},\n      asyncEnd: (msg) => this.#handleExecuteAsyncEnd(msg as unknown as JobExecuteMessage),\n      error: () => {},\n    }\n\n    this.dispatchHandlers = {\n      start: (msg) => this.#handleDispatchStart(msg as unknown as JobDispatchMessage),\n      end: () => {},\n      asyncStart: () => {},\n      asyncEnd: (msg) => this.#handleDispatchAsyncEnd(msg as unknown as JobDispatchMessage),\n      error: () => {},\n    }\n\n    executeChannel.subscribe(this.executeHandlers as any)\n    dispatchChannel.subscribe(this.dispatchHandlers as any)\n  }\n\n  #unsubscribe() {\n    if (!this.subscribed) return\n\n    if (this.executeHandlers) executeChannel.unsubscribe(this.executeHandlers as any)\n    if (this.dispatchHandlers) dispatchChannel.unsubscribe(this.dispatchHandlers as any)\n\n    this.subscribed = false\n    this.executeHandlers = undefined\n    this.dispatchHandlers = undefined\n    this.executeSpans.clear()\n    this.dispatchSpans = new WeakMap()\n  }\n\n  /**\n   * Called on dispatchChannel `start` — injects trace context into jobData\n   * and creates/enriches a PRODUCER span.\n   */\n  #handleDispatchStart(message: JobDispatchMessage) {\n    const attributes = this.#buildDispatchAttributes(message)\n    const span = this.tracer.startSpan(`publish ${message.queue}`, {\n      kind: SpanKind.PRODUCER,\n      attributes,\n    })\n\n    const dispatchContext = trace.setSpan(context.active(), span)\n    for (const job of message.jobs) {\n      if (!job.traceContext) job.traceContext = {}\n      propagation.inject(dispatchContext, job.traceContext)\n    }\n\n    this.dispatchSpans.set(message, span)\n  }\n\n  #handleDispatchAsyncEnd(message: JobDispatchMessage) {\n    const span = this.dispatchSpans.get(message)\n    if (!span) return\n\n    if (message.error) {\n      span.recordException(message.error)\n      span.setStatus({ code: SpanStatusCode.ERROR, message: message.error.message })\n    }\n\n    span.end()\n    this.dispatchSpans.delete(message)\n  }\n\n  /**\n   * Called by `executionWrapper` config — creates CONSUMER span and wraps\n   * execution in OTel context for proper child span parenting.\n   */\n  #wrapExecution<T>(fn: () => Promise<T>, job: AcquiredJob, queue: string): Promise<T> {\n    const extractedContext = this.#extractParentContext(job.traceContext)\n    const parentSpanContext = trace.getSpanContext(extractedContext)\n\n    let baseContext: typeof extractedContext\n    let links: Link[]\n\n    if (this.#executionSpanLinkMode === 'parent' && parentSpanContext) {\n      baseContext = extractedContext\n      links = []\n    } else {\n      links = parentSpanContext ? [{ context: parentSpanContext }] : []\n      baseContext = ROOT_CONTEXT\n    }\n\n    const span = this.tracer.startSpan(\n      `process ${queue}`,\n      {\n        kind: SpanKind.CONSUMER,\n        attributes: this.#buildExecuteAttributes(job, queue),\n        links,\n      },\n      baseContext\n    )\n\n    if (job.createdAt) {\n      span.setAttribute('messaging.job.queue_time_ms', Date.now() - job.createdAt)\n    }\n\n    this.executeSpans.set(job.id, span)\n    const executionContext = trace.setSpan(baseContext, span)\n\n    return context.with(executionContext, fn)\n  }\n\n  #handleExecuteAsyncEnd(message: JobExecuteMessage) {\n    const span = this.executeSpans.get(message.job.id)\n    if (!span) return\n\n    if (message.status) span.setAttribute('messaging.job.status', message.status)\n    if (message.error) span.recordException(message.error)\n\n    if (message.status === 'retrying' && message.nextRetryAt) {\n      span.addEvent('messaging.retry', {\n        'messaging.message.retry.count': message.job.attempts + 1,\n        'messaging.job.retry_at': message.nextRetryAt.toISOString(),\n      })\n    }\n\n    if (message.status === 'failed') {\n      span.setStatus({ code: SpanStatusCode.ERROR, message: message.error?.message })\n    } else {\n      span.setStatus({ code: SpanStatusCode.OK })\n    }\n\n    span.end()\n    this.executeSpans.delete(message.job.id)\n  }\n\n  #extractParentContext(traceContext?: Record<string, string>) {\n    if (!traceContext || Object.keys(traceContext).length === 0) return ROOT_CONTEXT\n    return propagation.extract(ROOT_CONTEXT, traceContext)\n  }\n\n  #buildDispatchAttributes(message: JobDispatchMessage) {\n    const firstJob = message.jobs[0]\n    const attributes: Record<string, string | number | boolean> = {\n      'messaging.system': this.#messagingSystem,\n      'messaging.operation.name': 'publish',\n      'messaging.operation.type': 'send',\n      'messaging.destination.name': message.queue,\n      'messaging.job.name': firstJob.name,\n    }\n\n    if (message.jobs.length === 1) attributes['messaging.message.id'] = firstJob.id\n    if (message.jobs.length > 1) attributes['messaging.batch.message_count'] = message.jobs.length\n    if (firstJob.groupId) attributes['messaging.job.group_id'] = firstJob.groupId\n    if (firstJob.priority !== undefined) attributes['messaging.job.priority'] = firstJob.priority\n    if (message.delay !== undefined) attributes['messaging.job.delay_ms'] = message.delay\n\n    return attributes\n  }\n\n  #buildExecuteAttributes(job: AcquiredJob, queue: string) {\n    const attributes: Record<string, string | number | boolean> = {\n      'entry_point.type': 'job',\n      'messaging.system': this.#messagingSystem,\n      'messaging.operation.name': 'process',\n      'messaging.operation.type': 'process',\n      'messaging.destination.name': queue,\n      'messaging.message.id': job.id,\n      'messaging.message.retry.count': job.attempts,\n      'messaging.job.name': job.name,\n    }\n\n    if (job.groupId) attributes['messaging.job.group_id'] = job.groupId\n    if (job.priority !== undefined) attributes['messaging.job.priority'] = job.priority\n\n    return attributes\n  }\n}\n"],"mappings":";;;;;;;AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAEP,SAAS,uBAAuB;AAChC,SAAS,2BAA2B;AAgC7B,IAAM,uBAAN,cAAmC,oBAAgD;AAAA,EAC9E,aAAa;AAAA,EACb,eAAe,oBAAI,IAAkB;AAAA,EACrC,gBAAgB,oBAAI,QAAkC;AAAA,EACtD;AAAA,EACA;AAAA,EAEV;AAAA,EACA;AAAA,EAEA,YAAY,SAAqC,CAAC,GAAG;AACnD,UAAM,qBAAqB,SAAS,MAAM;AAAA,EAC5C;AAAA,EAEA,IAAI,mBAA2B;AAC7B,WAAO,KAAK,UAAU,EAAE,mBAAmB;AAAA,EAC7C;AAAA,EAEA,IAAI,yBAA4C;AAC9C,WAAO,KAAK,UAAU,EAAE,yBAAyB;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMU,OAAO;AACf,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,SAAS;AACP,UAAM,OAAO;AACb,QAAI,KAAK,eAAe,OAAW,MAAK,WAAW;AAAA,EACrD;AAAA;AAAA;AAAA;AAAA,EAKA,UAAU;AACR,QAAI,KAAK,eAAe,QAAW;AACjC,WAAK,aAAa;AAClB,WAAK,aAAa;AAAA,IACpB;AAEA,UAAM,QAAQ;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,iBAAiB,aAAkE;AACjF,SAAK,WAAW,YAAY,YAAY;AACxC,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,WAAW,SAA4C;AACrD,QAAI,KAAK,cAAe;AAExB,SAAK,kBAAkB;AACvB,SAAK,gBAAgB,QAAQ,KAAK,KAAK,OAAO;AAC9C,UAAM,kBAAkB;AAExB,YAAQ,OAAO,OAAO,WAAgB;AACpC,aAAO,KAAK,cAAe;AAAA,QACzB,GAAG;AAAA,QACH,0BAA0B,CAAI,OAAyB;AACrD,iBAAO,QAAQ,KAAK,gBAAgB,QAAQ,OAAO,CAAC,GAAG,EAAE;AAAA,QAC3D;AAAA,QACA,kBAAkB,CAAI,IAAsB,KAAkB,UAAkB;AAC9E,iBAAO,gBAAgB,eAAe,IAAI,KAAK,KAAK;AAAA,QACtD;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAAA,EAEA,eAAe;AACb,QAAI,CAAC,KAAK,iBAAiB,CAAC,KAAK,gBAAiB;AAElD,SAAK,gBAAgB,OAAO,KAAK;AACjC,SAAK,gBAAgB;AACrB,SAAK,kBAAkB;AAAA,EACzB;AAAA,EAEA,aAAa;AACX,QAAI,KAAK,WAAY;AACrB,QAAI,CAAC,KAAK,UAAU,EAAG;AAEvB,SAAK,aAAa;AAElB,SAAK,kBAAkB;AAAA,MACrB,OAAO,MAAM;AAAA,MAAC;AAAA,MACd,KAAK,MAAM;AAAA,MAAC;AAAA,MACZ,YAAY,MAAM;AAAA,MAAC;AAAA,MACnB,UAAU,CAAC,QAAQ,KAAK,uBAAuB,GAAmC;AAAA,MAClF,OAAO,MAAM;AAAA,MAAC;AAAA,IAChB;AAEA,SAAK,mBAAmB;AAAA,MACtB,OAAO,CAAC,QAAQ,KAAK,qBAAqB,GAAoC;AAAA,MAC9E,KAAK,MAAM;AAAA,MAAC;AAAA,MACZ,YAAY,MAAM;AAAA,MAAC;AAAA,MACnB,UAAU,CAAC,QAAQ,KAAK,wBAAwB,GAAoC;AAAA,MACpF,OAAO,MAAM;AAAA,MAAC;AAAA,IAChB;AAEA,mBAAe,UAAU,KAAK,eAAsB;AACpD,oBAAgB,UAAU,KAAK,gBAAuB;AAAA,EACxD;AAAA,EAEA,eAAe;AACb,QAAI,CAAC,KAAK,WAAY;AAEtB,QAAI,KAAK,gBAAiB,gBAAe,YAAY,KAAK,eAAsB;AAChF,QAAI,KAAK,iBAAkB,iBAAgB,YAAY,KAAK,gBAAuB;AAEnF,SAAK,aAAa;AAClB,SAAK,kBAAkB;AACvB,SAAK,mBAAmB;AACxB,SAAK,aAAa,MAAM;AACxB,SAAK,gBAAgB,oBAAI,QAAQ;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,qBAAqB,SAA6B;AAChD,UAAM,aAAa,KAAK,yBAAyB,OAAO;AACxD,UAAM,OAAO,KAAK,OAAO,UAAU,WAAW,QAAQ,KAAK,IAAI;AAAA,MAC7D,MAAM,SAAS;AAAA,MACf;AAAA,IACF,CAAC;AAED,UAAM,kBAAkB,MAAM,QAAQ,QAAQ,OAAO,GAAG,IAAI;AAC5D,eAAW,OAAO,QAAQ,MAAM;AAC9B,UAAI,CAAC,IAAI,aAAc,KAAI,eAAe,CAAC;AAC3C,kBAAY,OAAO,iBAAiB,IAAI,YAAY;AAAA,IACtD;AAEA,SAAK,cAAc,IAAI,SAAS,IAAI;AAAA,EACtC;AAAA,EAEA,wBAAwB,SAA6B;AACnD,UAAM,OAAO,KAAK,cAAc,IAAI,OAAO;AAC3C,QAAI,CAAC,KAAM;AAEX,QAAI,QAAQ,OAAO;AACjB,WAAK,gBAAgB,QAAQ,KAAK;AAClC,WAAK,UAAU,EAAE,MAAM,eAAe,OAAO,SAAS,QAAQ,MAAM,QAAQ,CAAC;AAAA,IAC/E;AAEA,SAAK,IAAI;AACT,SAAK,cAAc,OAAO,OAAO;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,eAAkB,IAAsB,KAAkB,OAA2B;AACnF,UAAM,mBAAmB,KAAK,sBAAsB,IAAI,YAAY;AACpE,UAAM,oBAAoB,MAAM,eAAe,gBAAgB;AAE/D,QAAI;AACJ,QAAI;AAEJ,QAAI,KAAK,2BAA2B,YAAY,mBAAmB;AACjE,oBAAc;AACd,cAAQ,CAAC;AAAA,IACX,OAAO;AACL,cAAQ,oBAAoB,CAAC,EAAE,SAAS,kBAAkB,CAAC,IAAI,CAAC;AAChE,oBAAc;AAAA,IAChB;AAEA,UAAM,OAAO,KAAK,OAAO;AAAA,MACvB,WAAW,KAAK;AAAA,MAChB;AAAA,QACE,MAAM,SAAS;AAAA,QACf,YAAY,KAAK,wBAAwB,KAAK,KAAK;AAAA,QACnD;AAAA,MACF;AAAA,MACA;AAAA,IACF;AAEA,QAAI,IAAI,WAAW;AACjB,WAAK,aAAa,+BAA+B,KAAK,IAAI,IAAI,IAAI,SAAS;AAAA,IAC7E;AAEA,SAAK,aAAa,IAAI,IAAI,IAAI,IAAI;AAClC,UAAM,mBAAmB,MAAM,QAAQ,aAAa,IAAI;AAExD,WAAO,QAAQ,KAAK,kBAAkB,EAAE;AAAA,EAC1C;AAAA,EAEA,uBAAuB,SAA4B;AACjD,UAAM,OAAO,KAAK,aAAa,IAAI,QAAQ,IAAI,EAAE;AACjD,QAAI,CAAC,KAAM;AAEX,QAAI,QAAQ,OAAQ,MAAK,aAAa,wBAAwB,QAAQ,MAAM;AAC5E,QAAI,QAAQ,MAAO,MAAK,gBAAgB,QAAQ,KAAK;AAErD,QAAI,QAAQ,WAAW,cAAc,QAAQ,aAAa;AACxD,WAAK,SAAS,mBAAmB;AAAA,QAC/B,iCAAiC,QAAQ,IAAI,WAAW;AAAA,QACxD,0BAA0B,QAAQ,YAAY,YAAY;AAAA,MAC5D,CAAC;AAAA,IACH;AAEA,QAAI,QAAQ,WAAW,UAAU;AAC/B,WAAK,UAAU,EAAE,MAAM,eAAe,OAAO,SAAS,QAAQ,OAAO,QAAQ,CAAC;AAAA,IAChF,OAAO;AACL,WAAK,UAAU,EAAE,MAAM,eAAe,GAAG,CAAC;AAAA,IAC5C;AAEA,SAAK,IAAI;AACT,SAAK,aAAa,OAAO,QAAQ,IAAI,EAAE;AAAA,EACzC;AAAA,EAEA,sBAAsB,cAAuC;AAC3D,QAAI,CAAC,gBAAgB,OAAO,KAAK,YAAY,EAAE,WAAW,EAAG,QAAO;AACpE,WAAO,YAAY,QAAQ,cAAc,YAAY;AAAA,EACvD;AAAA,EAEA,yBAAyB,SAA6B;AACpD,UAAM,WAAW,QAAQ,KAAK,CAAC;AAC/B,UAAM,aAAwD;AAAA,MAC5D,oBAAoB,KAAK;AAAA,MACzB,4BAA4B;AAAA,MAC5B,4BAA4B;AAAA,MAC5B,8BAA8B,QAAQ;AAAA,MACtC,sBAAsB,SAAS;AAAA,IACjC;AAEA,QAAI,QAAQ,KAAK,WAAW,EAAG,YAAW,sBAAsB,IAAI,SAAS;AAC7E,QAAI,QAAQ,KAAK,SAAS,EAAG,YAAW,+BAA+B,IAAI,QAAQ,KAAK;AACxF,QAAI,SAAS,QAAS,YAAW,wBAAwB,IAAI,SAAS;AACtE,QAAI,SAAS,aAAa,OAAW,YAAW,wBAAwB,IAAI,SAAS;AACrF,QAAI,QAAQ,UAAU,OAAW,YAAW,wBAAwB,IAAI,QAAQ;AAEhF,WAAO;AAAA,EACT;AAAA,EAEA,wBAAwB,KAAkB,OAAe;AACvD,UAAM,aAAwD;AAAA,MAC5D,oBAAoB;AAAA,MACpB,oBAAoB,KAAK;AAAA,MACzB,4BAA4B;AAAA,MAC5B,4BAA4B;AAAA,MAC5B,8BAA8B;AAAA,MAC9B,wBAAwB,IAAI;AAAA,MAC5B,iCAAiC,IAAI;AAAA,MACrC,sBAAsB,IAAI;AAAA,IAC5B;AAEA,QAAI,IAAI,QAAS,YAAW,wBAAwB,IAAI,IAAI;AAC5D,QAAI,IAAI,aAAa,OAAW,YAAW,wBAAwB,IAAI,IAAI;AAE3E,WAAO;AAAA,EACT;AACF;","names":[]}

package/build/src/types/index.d.ts

@@ -1 +1,6 @@
-export { b as AcquiredJob, A as Adapter, x as AdapterFactory, v as BackoffConfig, B as BackoffStrategy, t as DispatchManyResult, s as DispatchResult, D as Duration, a as JobClass, u as JobContext, J as JobData, i as JobFactory, g as JobOptions, d as JobRecord, c as JobRetention, r as JobStatus, L as Logger, h as QueueConfig, Q as QueueManagerConfig, R as RetryConfig, S as ScheduleConfig, e as ScheduleData, f as ScheduleListOptions, y as ScheduleResult, k as ScheduleStatus, w as WorkerConfig, W as WorkerCycle } from '../../index-B1XdqWpN.js';
+export { b as AcquiredJob, A as Adapter, r as AdapterFactory, B as BackoffConfig, s as BackoffStrategy, t as DispatchManyResult, u as DispatchResult, D as Duration, a as JobClass, v as JobContext, J as JobData, i as JobFactory, g as JobOptions, d as JobRecord, c as JobRetention, w as JobStatus, L as Logger, h as QueueConfig, Q as QueueManagerConfig, R as RetryConfig, S as ScheduleConfig, e as ScheduleData, f as ScheduleListOptions, x as ScheduleResult, k as ScheduleStatus, y as WorkerConfig, W as WorkerCycle } from '../../job-Z5fBSzRX.js';
+export { JobDispatchMessage, JobExecuteMessage } from './tracing_channels.js';
+export { QueueInstrumentationConfig } from '../otel.js';
+import '@opentelemetry/api';
+import 'node:diagnostics_channel';
+import '@opentelemetry/instrumentation';

package/build/src/types/main.d.ts

@@ -1 +1 @@
-export { x as AdapterFactory, v as BackoffConfig, B as BackoffStrategy, t as DispatchManyResult, s as DispatchResult, D as Duration, a as JobClass, u as JobContext, J as JobData, i as JobFactory, g as JobOptions, d as JobRecord, c as JobRetention, r as JobStatus, L as Logger, h as QueueConfig, Q as QueueManagerConfig, R as RetryConfig, S as ScheduleConfig, e as ScheduleData, f as ScheduleListOptions, y as ScheduleResult, k as ScheduleStatus, w as WorkerConfig, W as WorkerCycle } from '../../index-B1XdqWpN.js';
+export { r as AdapterFactory, B as BackoffConfig, s as BackoffStrategy, t as DispatchManyResult, u as DispatchResult, D as Duration, a as JobClass, v as JobContext, J as JobData, i as JobFactory, g as JobOptions, d as JobRecord, c as JobRetention, w as JobStatus, L as Logger, h as QueueConfig, Q as QueueManagerConfig, R as RetryConfig, S as ScheduleConfig, e as ScheduleData, f as ScheduleListOptions, x as ScheduleResult, k as ScheduleStatus, y as WorkerConfig, W as WorkerCycle } from '../../job-Z5fBSzRX.js';

package/build/src/types/tracing_channels.d.ts

@@ -0,0 +1,34 @@
+import { J as JobData, b as AcquiredJob } from '../../job-Z5fBSzRX.js';
+
+/**
+ * Tracing data structure for job dispatch events.
+ */
+type JobDispatchMessage = {
+    /** The jobs being dispatched (single dispatch = array of one) */
+    jobs: JobData[];
+    /** Target queue name */
+    queue: string;
+    /** Delay in milliseconds before the job becomes available */
+    delay?: number;
+    /** Error that caused the dispatch to fail */
+    error?: Error;
+};
+/**
+ * Tracing data structure for job execution events.
+ */
+type JobExecuteMessage = {
+    /** The acquired job being executed */
+    job: AcquiredJob;
+    /** Queue the job was acquired from */
+    queue: string;
+    /** Execution outcome (set in asyncEnd) */
+    status?: 'completed' | 'failed' | 'retrying';
+    /** Execution duration in milliseconds (set in asyncEnd) */
+    duration?: number;
+    /** Error that caused the failure (set in asyncEnd) */
+    error?: Error;
+    /** When the next retry is scheduled (set in asyncEnd for retrying jobs) */
+    nextRetryAt?: Date;
+};
+
+export type { JobDispatchMessage, JobExecuteMessage };

package/build/src/types/tracing_channels.js

@@ -0,0 +1 @@
+//# sourceMappingURL=tracing_channels.js.map

package/build/src/types/tracing_channels.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@boringnode/queue",
   "description": "A simple and efficient queue system for Node.js applications",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "main": "build/index.js",
   "type": "module",
   "files": [
@@ -9,6 +9,7 @@
   ],
   "exports": {
     ".": "./build/index.js",
+    "./otel": "./build/src/otel.js",
     "./drivers/*": "./build/src/drivers/*.js",
     "./contracts/*": "./build/src/contracts/*.js",
     "./types": "./build/src/types/index.js"
@@ -40,29 +41,46 @@
     "@japa/expect-type": "^2.0.4",
     "@japa/file-system": "^3.0.0",
     "@japa/runner": "^5.3.0",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/context-async-hooks": "^2.6.0",
+    "@opentelemetry/core": "^2.6.0",
+    "@opentelemetry/instrumentation": "^0.213.0",
+    "@opentelemetry/sdk-trace-base": "^2.6.0",
     "@poppinss/ts-exec": "^1.4.4",
     "@types/better-sqlite3": "^7.6.13",
-    "@types/node": "^24.11.0",
-    "@types/pg": "^8.18.0",
-    "better-sqlite3": "^12.6.2",
-    "bullmq": "^5.70.1",
+    "@types/node": "^25.5.0",
+    "@types/pg": "^8.20.0",
+    "better-sqlite3": "^12.8.0",
+    "bullmq": "^5.71.0",
     "c8": "^11.0.0",
     "del-cli": "^7.0.0",
-    "ioredis": "^5.10.0",
-    "knex": "^3.1.0",
-    "oxfmt": "^0.36.0",
-    "oxlint": "^1.51.0",
-    "oxlint-tsgolint": "^0.15.0",
-    "pg": "^8.19.0",
+    "ioredis": "^5.10.1",
+    "knex": "3.1.0",
+    "oxfmt": "^0.41.0",
+    "oxlint": "^1.56.0",
+    "oxlint-tsgolint": "^0.17.1",
+    "pg": "^8.20.0",
     "release-it": "^19.2.4",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/core": "^1.30.0 || ^2.0.0",
+    "@opentelemetry/instrumentation": "^0.200.0",
     "ioredis": "^5.0.0",
     "knex": "^3.0.0"
   },
   "peerDependenciesMeta": {
+    "@opentelemetry/api": {
+      "optional": true
+    },
+    "@opentelemetry/core": {
+      "optional": true
+    },
+    "@opentelemetry/instrumentation": {
+      "optional": true
+    },
     "ioredis": {
       "optional": true
     },
@@ -89,7 +107,8 @@
   ],
   "publishConfig": {
     "access": "public",
-    "tag": "latest"
+    "tag": "latest",
+    "provenance": true
   },
   "release-it": {
     "git": {
@@ -99,8 +118,11 @@
     },
     "github": {
       "release": true,
-      "releaseName": "v${version}",
-      "web": true
+      "releaseName": "v${version}"
+    },
+    "npm": {
+      "publish": true,
+      "skipChecks": true
     }
   },
   "packageManager": "yarn@4.12.0",