@drawbridge/drawbridge-telemetry 0.0.2 → 0.0.3

package/README.md

@@ -21,8 +21,6 @@ Requires `@sentry/core` >= 10 as a peer dependency. Backend services satisfy thi
 
 ## Naming conventions
 
-Codified in the plan at `~/.claude/plans/yes-lets-see-it-enumerated-bumblebee.md`. Summary:
-
 - **Event names** — `<noun>.<verb>` past tense, lowercase, dot-separated. Verbs match drawbridge-api's action status vocabulary (`processing` / `succeeded` / `failed`; never `pending` / `completed`). Nouns are singular and match Mongo collection names.
 - **Tag keys** — camelCase. Canonical `traceId` everywhere; `X-Request-Id` header stays for wire compat.
 - **Event envelope** — `{ name, traceId, userId, organizationId, data: {...}, createdAt }`.
@@ -52,10 +50,10 @@ Sentry events for request     BullMQ worker
 
 For cron-style repeatable BullMQ jobs (no parent request or change event), synthesize a `__traceId` at enqueue time — pass it via `data.__traceId` to `enqueueFromWorker`.
 
-## Build
+## Build & publish
 
 ```sh
-npm run build
+npm run build    # tsup + npm publish
 ```
 
-Builds CJS + ESM bundles into `dist/` and publishes. Bump `version` in package.json before publishing.
+Bump `version` in `package.json` before publishing.

package/dist/bullmq.cjs

@@ -34,6 +34,7 @@ __export(bullmq_exports, {
   wrapWorkerHandler: () => wrapWorkerHandler
 });
 module.exports = __toCommonJS(bullmq_exports);
+var import_crypto = require("crypto");
 var Sentry2 = __toESM(require("@sentry/core"), 1);
 
 // index.js
@@ -50,9 +51,9 @@ var currentTraceId = () => {
 };
 
 // bullmq.js
-var wrapWorkerHandler = (handler) => async (jobData, job) => {
+var wrapWorkerHandler = (handler) => async (job) => {
   var _a;
-  const traceId = (_a = job == null ? void 0 : job.data) == null ? void 0 : _a.__traceId;
+  const traceId = ((_a = job == null ? void 0 : job.data) == null ? void 0 : _a.__traceId) || (0, import_crypto.randomUUID)();
   return withTraceScope(traceId, (scope) => {
     if (job == null ? void 0 : job.queueName) {
       scope.setTag("queue", job.queueName);
@@ -62,7 +63,7 @@ var wrapWorkerHandler = (handler) => async (jobData, job) => {
       scope.setTag("jobName", job.name);
     }
     ;
-    return handler(jobData, job);
+    return handler(job);
   });
 };
 var enqueueFromWorker = async (queue, name, data, options = {}) => {

package/dist/bullmq.d.cts

@@ -1,19 +1,22 @@
+import { randomUUID } from 'crypto';
 import { currentTraceId, withTraceScope } from './index.cjs';
 import '@sentry/core';
 
 // Wrap a BullMQ worker handler so it runs inside a Sentry scope tagged
-// with the job's traceId, queue name, and job name. The wrapped handler
-// keeps the same `( jobData, job )` signature the existing queue-factory
-// uses, so worker code itself doesn't change.
+// with the job's traceId, queue name, and job name. Matches BullMQ's
+// native single-arg `( job )` callback shape — pass it directly to
+// `new Worker( name, wrapWorkerHandler( handler ), ... )`.
 //
-// The traceId originates from one of two places:
+// The traceId originates from one of three places:
 //   - HTTP request: the API's req.id is forwarded as job.data.__traceId
 //   - Change stream: the Mongo resume token (_id._data) is forwarded
-// Either way, the wrapper just reads job.data.__traceId.
+//   - Synthesized: any job arriving with no __traceId gets a fresh UUID,
+//     so cron / repeatable jobs (no parent context) still produce
+//     correlated downstream events.
 
-const wrapWorkerHandler = ( handler ) => async ( jobData, job ) => {
+const wrapWorkerHandler = ( handler ) => async ( job ) => {
 
-	const traceId = job?.data?.__traceId;
+	const traceId = job?.data?.__traceId || randomUUID();
 
 	return withTraceScope( traceId, ( scope ) => {
 
@@ -27,7 +30,7 @@ const wrapWorkerHandler = ( handler ) => async ( jobData, job ) => {
 			scope.setTag( 'jobName', job.name );
 
 		}
-		return handler( jobData, job );
+		return handler( job );
 
 	} );
 

package/dist/bullmq.d.ts

@@ -1,19 +1,22 @@
+import { randomUUID } from 'crypto';
 import { currentTraceId, withTraceScope } from './index.js';
 import '@sentry/core';
 
 // Wrap a BullMQ worker handler so it runs inside a Sentry scope tagged
-// with the job's traceId, queue name, and job name. The wrapped handler
-// keeps the same `( jobData, job )` signature the existing queue-factory
-// uses, so worker code itself doesn't change.
+// with the job's traceId, queue name, and job name. Matches BullMQ's
+// native single-arg `( job )` callback shape — pass it directly to
+// `new Worker( name, wrapWorkerHandler( handler ), ... )`.
 //
-// The traceId originates from one of two places:
+// The traceId originates from one of three places:
 //   - HTTP request: the API's req.id is forwarded as job.data.__traceId
 //   - Change stream: the Mongo resume token (_id._data) is forwarded
-// Either way, the wrapper just reads job.data.__traceId.
+//   - Synthesized: any job arriving with no __traceId gets a fresh UUID,
+//     so cron / repeatable jobs (no parent context) still produce
+//     correlated downstream events.
 
-const wrapWorkerHandler = ( handler ) => async ( jobData, job ) => {
+const wrapWorkerHandler = ( handler ) => async ( job ) => {
 
-	const traceId = job?.data?.__traceId;
+	const traceId = job?.data?.__traceId || randomUUID();
 
 	return withTraceScope( traceId, ( scope ) => {
 
@@ -27,7 +30,7 @@ const wrapWorkerHandler = ( handler ) => async ( jobData, job ) => {
 			scope.setTag( 'jobName', job.name );
 
 		}
-		return handler( jobData, job );
+		return handler( job );
 
 	} );
 

package/dist/bullmq.js

@@ -4,10 +4,11 @@ import {
 } from "./chunk-SRV5HFQT.js";
 
 // bullmq.js
+import { randomUUID } from "crypto";
 import * as Sentry from "@sentry/core";
-var wrapWorkerHandler = (handler) => async (jobData, job) => {
+var wrapWorkerHandler = (handler) => async (job) => {
   var _a;
-  const traceId = (_a = job == null ? void 0 : job.data) == null ? void 0 : _a.__traceId;
+  const traceId = ((_a = job == null ? void 0 : job.data) == null ? void 0 : _a.__traceId) || randomUUID();
   return withTraceScope(traceId, (scope) => {
     if (job == null ? void 0 : job.queueName) {
       scope.setTag("queue", job.queueName);
@@ -17,7 +18,7 @@ var wrapWorkerHandler = (handler) => async (jobData, job) => {
       scope.setTag("jobName", job.name);
     }
     ;
-    return handler(jobData, job);
+    return handler(job);
   });
 };
 var enqueueFromWorker = async (queue, name, data, options = {}) => {

package/package.json

@@ -1,9 +1,5 @@
 {
   "type": "module",
-  "dependencies": {
-    "tsup": "8.5.1",
-    "typescript": "5.9.3"
-  },
   "peerDependencies": {
     "@sentry/core": ">=10"
   },
@@ -13,7 +9,9 @@
     }
   },
   "devDependencies": {
-    "@sentry/core": "10.27.0"
+    "@sentry/core": "10.27.0",
+    "tsup": "8.5.1",
+    "typescript": "5.9.3"
   },
   "exports": {
     ".": {
@@ -52,5 +50,5 @@
     "build": "tsup && npm publish"
   },
   "types": "dist/index.d.ts",
-  "version": "0.0.2"
+  "version": "0.0.3"
 }