@boringnode/queue 0.5.0 → 0.5.1

package/build/src/otel.js

@@ -0,0 +1,242 @@
+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
+    );
+    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    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":"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","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-DImdhRFO.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-DImdhRFO.js';

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

@@ -0,0 +1,34 @@
+import { J as JobData, b as AcquiredJob } from '../../job-DImdhRFO.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.1",
   "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": {
@@ -101,6 +120,10 @@
       "release": true,
       "releaseName": "v${version}",
       "web": true
+    },
+    "npm": {
+      "publish": true,
+      "skipChecks": true
     }
   },
   "packageManager": "yarn@4.12.0",