@volontariapp/database 3.5.0 → 3.6.0-snap-d038e0e

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 3.6.0
+
+### Minor Changes
+
+- Capture the active OpenTelemetry context into `traceparent` when an outbox row is created (`EventQueueEntity.createEvent`, `JobsOutboxEntity.createJob`), and carry it in Redis Stream fields / event JSON and in the BullMQ job envelope. Adds `captureTraceparent`, `normalizeTraceparent` and `EventQueueEntity.createFollowUp`, which copies `traceId`, `traceparent` and `correlationId` from the consumed event. `traceparent` is optional on `JobEnvelope` but required on `RedisEventMessage` and `RedisEventStreamFields` (empty string when there is no trace context): code that builds these types must now provide it. Messages already in a stream may lack it at runtime. Without an active span the field stays empty.
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @volontariapp/messaging@2.25.0
+
 ## 3.5.0
 
 ### Minor Changes

package/dist/outbox/entities/event-queue.entity.d.ts

@@ -2,6 +2,7 @@ import type { EventPayload } from '../types/payload.registry.js';
 import { OutboxEntity } from './outbox.entity.js';
 import type { EventType } from '../types/event.type.js';
 import type { Streams } from '@volontariapp/shared';
+import type { EventTraceContext } from '../interfaces/outbox.interfaces.js';
 export declare class EventQueueEntity<K extends EventType = EventType, P = EventPayload<K>> extends OutboxEntity<K> {
     version: number;
     correlationId: string;
@@ -16,9 +17,17 @@ export declare class EventQueueEntity<K extends EventType = EventType, P = Event
         emitter: string;
         emitterId: string;
         traceId?: string;
+        traceparent?: string;
         correlationId?: string;
         payload: EventPayload<K>;
         targetServices: Streams[];
     }): EventQueueEntity<K>;
+    static createFollowUp<K extends EventType = EventType>(source: EventTraceContext, props: {
+        type: K;
+        emitter: string;
+        emitterId: string;
+        payload: EventPayload<K>;
+        targetServices: Streams[];
+    }): EventQueueEntity<K>;
 }
 //# sourceMappingURL=event-queue.entity.d.ts.map

package/dist/outbox/entities/event-queue.entity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-queue.entity.d.ts","sourceRoot":"","sources":["../../../src/outbox/entities/event-queue.entity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAIpD,qBAAa,gBAAgB,CAC3B,CAAC,SAAS,SAAS,GAAG,SAAS,EAC/B,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CACnB,SAAQ,YAAY,CAAC,CAAC,CAAC;IACvB,OAAO,EAAG,MAAM,CAAC;IAEjB,aAAa,EAAG,MAAM,CAAC;IAEvB,cAAc,EAAE,OAAO,EAAE,CAAM;IAE/B,OAAO,EAAG;QACR,MAAM,CAAC,EAAE,CAAC,CAAC;QACX,KAAK,EAAE,CAAC,CAAC;KACV,CAAC;IAEF,WAAW,CAAC,EAAE,IAAI,CAAC;IAEnB,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,KAAK,EAAE;QACzD,IAAI,EAAE,CAAC,CAAC;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;QACzB,cAAc,EAAE,OAAO,EAAE,CAAC;KAC3B,GAAG,gBAAgB,CAAC,CAAC,CAAC;CAiBxB"}
+{"version":3,"file":"event-queue.entity.d.ts","sourceRoot":"","sources":["../../../src/outbox/entities/event-queue.entity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAIpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAE5E,qBAAa,gBAAgB,CAC3B,CAAC,SAAS,SAAS,GAAG,SAAS,EAC/B,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CACnB,SAAQ,YAAY,CAAC,CAAC,CAAC;IACvB,OAAO,EAAG,MAAM,CAAC;IAEjB,aAAa,EAAG,MAAM,CAAC;IAEvB,cAAc,EAAE,OAAO,EAAE,CAAM;IAE/B,OAAO,EAAG;QACR,MAAM,CAAC,EAAE,CAAC,CAAC;QACX,KAAK,EAAE,CAAC,CAAC;KACV,CAAC;IAEF,WAAW,CAAC,EAAE,IAAI,CAAC;IAEnB,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,KAAK,EAAE;QACzD,IAAI,EAAE,CAAC,CAAC;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;QACzB,cAAc,EAAE,OAAO,EAAE,CAAC;KAC3B,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAyBvB,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EACnD,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE;QACL,IAAI,EAAE,CAAC,CAAC;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;QACzB,cAAc,EAAE,OAAO,EAAE,CAAC;KAC3B,GACA,gBAAgB,CAAC,CAAC,CAAC;CAQvB"}

package/dist/outbox/entities/event-queue.entity.js

@@ -1,6 +1,7 @@
 import { OutboxEntity } from './outbox.entity.js';
 import { randomUUID } from 'crypto';
 import { OutboxStatus } from '../types/outbox.status.js';
+import { captureTraceparent, normalizeTraceparent } from '../utils/capture-traceparent.js';
 export class EventQueueEntity extends OutboxEntity {
     version;
     correlationId;
@@ -14,6 +15,7 @@ export class EventQueueEntity extends OutboxEntity {
         entity.emitter = props.emitter;
         entity.emitterId = props.emitterId;
         entity.traceId = props.traceId;
+        entity.traceparent = normalizeTraceparent(props.traceparent) ?? captureTraceparent();
         entity.correlationId = props.correlationId ?? randomUUID();
         entity.payload = { after: props.payload };
         entity.targetServices = props.targetServices;
@@ -24,5 +26,13 @@ export class EventQueueEntity extends OutboxEntity {
         entity.updatedAt = new Date();
         return entity;
     }
+    static createFollowUp(source, props) {
+        return EventQueueEntity.createEvent({
+            ...props,
+            traceId: source.traceId,
+            traceparent: source.traceparent,
+            correlationId: source.correlationId,
+        });
+    }
 }
 //# sourceMappingURL=event-queue.entity.js.map

package/dist/outbox/entities/event-queue.entity.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-queue.entity.js","sourceRoot":"","sources":["../../../src/outbox/entities/event-queue.entity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,MAAM,OAAO,gBAGX,SAAQ,YAAe;IACvB,OAAO,CAAU;IAEjB,aAAa,CAAU;IAEvB,cAAc,GAAc,EAAE,CAAC;IAE/B,OAAO,CAGL;IAEF,WAAW,CAAQ;IAEnB,MAAM,CAAC,WAAW,CAAkC,KAQnD;QACC,MAAM,MAAM,GAAG,IAAI,gBAAgB,EAAK,CAAC;QACzC,MAAM,CAAC,EAAE,GAAG,UAAU,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACzB,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC/B,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACnC,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC/B,MAAM,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,IAAI,UAAU,EAAE,CAAC;QAC3D,MAAM,CAAC,OAAO,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAC1C,MAAM,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC;QAC7C,MAAM,CAAC,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC;QACrC,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;QACpB,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;QACnB,MAAM,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC9B,MAAM,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}
+{"version":3,"file":"event-queue.entity.js","sourceRoot":"","sources":["../../../src/outbox/entities/event-queue.entity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAG3F,MAAM,OAAO,gBAGX,SAAQ,YAAe;IACvB,OAAO,CAAU;IAEjB,aAAa,CAAU;IAEvB,cAAc,GAAc,EAAE,CAAC;IAE/B,OAAO,CAGL;IAEF,WAAW,CAAQ;IAEnB,MAAM,CAAC,WAAW,CAAkC,KASnD;QACC,MAAM,MAAM,GAAG,IAAI,gBAAgB,EAAK,CAAC;QACzC,MAAM,CAAC,EAAE,GAAG,UAAU,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACzB,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC/B,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACnC,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC/B,MAAM,CAAC,WAAW,GAAG,oBAAoB,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,kBAAkB,EAAE,CAAC;QACrF,MAAM,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,IAAI,UAAU,EAAE,CAAC;QAC3D,MAAM,CAAC,OAAO,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAC1C,MAAM,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC;QAC7C,MAAM,CAAC,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC;QACrC,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;QACpB,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;QACnB,MAAM,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC9B,MAAM,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC;IAChB,CAAC;IAQD,MAAM,CAAC,cAAc,CACnB,MAAyB,EACzB,KAMC;QAED,OAAO,gBAAgB,CAAC,WAAW,CAAI;YACrC,GAAG,KAAK;YACR,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,aAAa,EAAE,MAAM,CAAC,aAAa;SACpC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/outbox/entities/jobs-outbox.entity.d.ts

@@ -10,6 +10,7 @@ export declare class JobsOutboxEntity<K extends JobType = JobType, P = JobPayloa
         emitter: string;
         emitterId: string;
         traceId?: string;
+        traceparent?: string;
         target: string;
         payload: JobPayload<K>;
         scheduledAt?: Date;

package/dist/outbox/entities/jobs-outbox.entity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jobs-outbox.entity.d.ts","sourceRoot":"","sources":["../../../src/outbox/entities/jobs-outbox.entity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGpD,qBAAa,gBAAgB,CAC3B,CAAC,SAAS,OAAO,GAAG,OAAO,EAC3B,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CACjB,SAAQ,YAAY,CAAC,CAAC,CAAC;IACvB,MAAM,EAAG,MAAM,CAAC;IAEhB,OAAO,EAAG,CAAC,CAAC;IAEZ,WAAW,CAAC,EAAE,IAAI,CAAC;IAEnB,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,KAAK,EAAE;QACnD,IAAI,EAAE,CAAC,CAAC;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;QACvB,WAAW,CAAC,EAAE,IAAI,CAAC;KACpB,GAAG,gBAAgB,CAAC,CAAC,CAAC;CAgBxB"}
+{"version":3,"file":"jobs-outbox.entity.d.ts","sourceRoot":"","sources":["../../../src/outbox/entities/jobs-outbox.entity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAIpD,qBAAa,gBAAgB,CAC3B,CAAC,SAAS,OAAO,GAAG,OAAO,EAC3B,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CACjB,SAAQ,YAAY,CAAC,CAAC,CAAC;IACvB,MAAM,EAAG,MAAM,CAAC;IAEhB,OAAO,EAAG,CAAC,CAAC;IAEZ,WAAW,CAAC,EAAE,IAAI,CAAC;IAEnB,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,KAAK,EAAE;QACnD,IAAI,EAAE,CAAC,CAAC;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;QACvB,WAAW,CAAC,EAAE,IAAI,CAAC;KACpB,GAAG,gBAAgB,CAAC,CAAC,CAAC;CAiBxB"}

package/dist/outbox/entities/jobs-outbox.entity.js

@@ -1,6 +1,7 @@
 import { OutboxEntity } from './outbox.entity.js';
 import { randomUUID } from 'crypto';
 import { OutboxStatus } from '../index.js';
+import { captureTraceparent } from '../utils/capture-traceparent.js';
 export class JobsOutboxEntity extends OutboxEntity {
     target;
     payload;
@@ -12,6 +13,7 @@ export class JobsOutboxEntity extends OutboxEntity {
         entity.emitter = props.emitter;
         entity.emitterId = props.emitterId;
         entity.traceId = props.traceId;
+        entity.traceparent = props.traceparent ?? captureTraceparent();
         entity.target = props.target;
         entity.payload = props.payload;
         entity.scheduledAt = props.scheduledAt;

package/dist/outbox/entities/jobs-outbox.entity.js.map

@@ -1 +1 @@
-{"version":3,"file":"jobs-outbox.entity.js","sourceRoot":"","sources":["../../../src/outbox/entities/jobs-outbox.entity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,OAAO,gBAGX,SAAQ,YAAe;IACvB,MAAM,CAAU;IAEhB,OAAO,CAAK;IAEZ,WAAW,CAAQ;IAEnB,MAAM,CAAC,SAAS,CAA8B,KAQ7C;QACC,MAAM,MAAM,GAAG,IAAI,gBAAgB,EAAK,CAAC;QACzC,MAAM,CAAC,EAAE,GAAG,UAAU,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACzB,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC/B,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACnC,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC/B,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC7B,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC/B,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QACvC,MAAM,CAAC,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC;QACrC,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;QACpB,MAAM,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC9B,MAAM,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}
+{"version":3,"file":"jobs-outbox.entity.js","sourceRoot":"","sources":["../../../src/outbox/entities/jobs-outbox.entity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErE,MAAM,OAAO,gBAGX,SAAQ,YAAe;IACvB,MAAM,CAAU;IAEhB,OAAO,CAAK;IAEZ,WAAW,CAAQ;IAEnB,MAAM,CAAC,SAAS,CAA8B,KAS7C;QACC,MAAM,MAAM,GAAG,IAAI,gBAAgB,EAAK,CAAC;QACzC,MAAM,CAAC,EAAE,GAAG,UAAU,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACzB,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC/B,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACnC,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC/B,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,kBAAkB,EAAE,CAAC;QAC/D,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC7B,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC/B,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QACvC,MAAM,CAAC,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC;QACrC,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;QACpB,MAAM,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC9B,MAAM,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/outbox/entities/outbox.entity.d.ts

@@ -9,6 +9,7 @@ export declare class OutboxEntity<T extends OutboxType = OutboxType> extends Bas
     type: T;
     emitter: string;
     traceId?: string;
+    traceparent?: string;
     emitterId: string;
 }
 //# sourceMappingURL=outbox.entity.d.ts.map

package/dist/outbox/entities/outbox.entity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"outbox.entity.d.ts","sourceRoot":"","sources":["../../../src/outbox/entities/outbox.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,qBAAa,YAAY,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,CACzD,SAAQ,UACR,YAAW,aAAa,CAAC,CAAC,CAAC;IAE3B,MAAM,EAAG,YAAY,CAAC;IAEtB,QAAQ,EAAG,MAAM,CAAC;IAElB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,IAAI,EAAG,CAAC,CAAC;IAET,OAAO,EAAG,MAAM,CAAC;IAEjB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,SAAS,EAAG,MAAM,CAAC;CACpB"}
+{"version":3,"file":"outbox.entity.d.ts","sourceRoot":"","sources":["../../../src/outbox/entities/outbox.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,qBAAa,YAAY,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,CACzD,SAAQ,UACR,YAAW,aAAa,CAAC,CAAC,CAAC;IAE3B,MAAM,EAAG,YAAY,CAAC;IAEtB,QAAQ,EAAG,MAAM,CAAC;IAElB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,IAAI,EAAG,CAAC,CAAC;IAET,OAAO,EAAG,MAAM,CAAC;IAEjB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,SAAS,EAAG,MAAM,CAAC;CACpB"}

package/dist/outbox/entities/outbox.entity.js

@@ -6,6 +6,7 @@ export class OutboxEntity extends BaseEntity {
     type;
     emitter;
     traceId;
+    traceparent;
     emitterId;
 }
 //# sourceMappingURL=outbox.entity.js.map

package/dist/outbox/entities/outbox.entity.js.map

@@ -1 +1 @@
-{"version":3,"file":"outbox.entity.js","sourceRoot":"","sources":["../../../src/outbox/entities/outbox.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAKvD,MAAM,OAAO,YACX,SAAQ,UAAU;IAGlB,MAAM,CAAgB;IAEtB,QAAQ,CAAU;IAElB,SAAS,CAAU;IAEnB,IAAI,CAAK;IAET,OAAO,CAAU;IAEjB,OAAO,CAAU;IAEjB,SAAS,CAAU;CACpB"}
+{"version":3,"file":"outbox.entity.js","sourceRoot":"","sources":["../../../src/outbox/entities/outbox.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAKvD,MAAM,OAAO,YACX,SAAQ,UAAU;IAGlB,MAAM,CAAgB;IAEtB,QAAQ,CAAU;IAElB,SAAS,CAAU;IAEnB,IAAI,CAAK;IAET,OAAO,CAAU;IAEjB,OAAO,CAAU;IAEjB,WAAW,CAAU;IAErB,SAAS,CAAU;CACpB"}

package/dist/outbox/index.d.ts

@@ -6,6 +6,7 @@ export * from './entities/index.js';
 export * from './interfaces/index.js';
 export * from './models/index.js';
 export * from './types/index.js';
+export * from './utils/index.js';
 export * from './writers/index.js';
 export * from './dispatchers/index.js';
 export * from './pushers/index.js';

package/dist/outbox/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/outbox/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,cAAc,4BAA4B,CAAC;AAE3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/outbox/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,cAAc,4BAA4B,CAAC;AAE3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC"}

package/dist/outbox/index.js

@@ -6,6 +6,7 @@ export * from './entities/index.js';
 export * from './interfaces/index.js';
 export * from './models/index.js';
 export * from './types/index.js';
+export * from './utils/index.js';
 export * from './writers/index.js';
 export * from './dispatchers/index.js';
 export * from './pushers/index.js';

package/dist/outbox/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/outbox/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,cAAc,4BAA4B,CAAC;AAE3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/outbox/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,cAAc,4BAA4B,CAAC;AAE3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC"}

package/dist/outbox/interfaces/outbox.interfaces.d.ts

@@ -1,5 +1,10 @@
 import type { OutboxStatus } from '../types/outbox.status.js';
 import type { OutboxType } from '../types/outbox.type.js';
+export interface EventTraceContext {
+    correlationId: string;
+    traceId?: string;
+    traceparent: string;
+}
 export interface IOutboxEntity<T extends OutboxType> {
     id: string;
     status: OutboxStatus;

package/dist/outbox/interfaces/outbox.interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"outbox.interfaces.d.ts","sourceRoot":"","sources":["../../../src/outbox/interfaces/outbox.interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,UAAU;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AACD,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,UAAU;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}
+{"version":3,"file":"outbox.interfaces.d.ts","sourceRoot":"","sources":["../../../src/outbox/interfaces/outbox.interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAO1D,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,UAAU;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AACD,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,UAAU;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/outbox/utils/capture-traceparent.d.ts

@@ -0,0 +1,3 @@
+export declare function captureTraceparent(): string | undefined;
+export declare function normalizeTraceparent(value: string | null | undefined): string | undefined;
+//# sourceMappingURL=capture-traceparent.d.ts.map

package/dist/outbox/utils/capture-traceparent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-traceparent.d.ts","sourceRoot":"","sources":["../../../src/outbox/utils/capture-traceparent.ts"],"names":[],"mappings":"AASA,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAIvD;AAQD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAEzF"}

package/dist/outbox/utils/capture-traceparent.js

@@ -0,0 +1,10 @@
+import { context, propagation } from '@opentelemetry/api';
+export function captureTraceparent() {
+    const carrier = {};
+    propagation.inject(context.active(), carrier);
+    return carrier.traceparent;
+}
+export function normalizeTraceparent(value) {
+    return value === null || value === undefined || value === '' ? undefined : value;
+}
+//# sourceMappingURL=capture-traceparent.js.map

package/dist/outbox/utils/capture-traceparent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-traceparent.js","sourceRoot":"","sources":["../../../src/outbox/utils/capture-traceparent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAS1D,MAAM,UAAU,kBAAkB;IAChC,MAAM,OAAO,GAA6B,EAAE,CAAC;IAC7C,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9C,OAAO,OAAO,CAAC,WAAW,CAAC;AAC7B,CAAC;AAQD,MAAM,UAAU,oBAAoB,CAAC,KAAgC;IACnE,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;AACnF,CAAC"}

package/dist/outbox/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './capture-traceparent.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/outbox/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/outbox/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC"}

package/dist/outbox/utils/index.js

@@ -0,0 +1,2 @@
+export * from './capture-traceparent.js';
+//# sourceMappingURL=index.js.map

package/dist/outbox/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/outbox/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC"}

package/dist/test/outbox/entities/span-context.factory.d.ts

@@ -0,0 +1,7 @@
+import type { Context, SpanContext } from '@opentelemetry/api';
+export declare const TRACE_ID_HEX = "0af7651916cd43dd8448eb211c80319c";
+export declare const SPAN_ID_HEX = "b7ad6b7169203331";
+export declare const SAMPLED_TRACEPARENT = "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01";
+export declare const createSpanContext: (overrides?: Partial<SpanContext>) => SpanContext;
+export declare const createActiveContext: (spanContext?: SpanContext) => Context;
+//# sourceMappingURL=span-context.factory.d.ts.map

package/dist/test/outbox/entities/span-context.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-context.factory.d.ts","sourceRoot":"","sources":["../../../../src/test/outbox/entities/span-context.factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE/D,eAAO,MAAM,YAAY,qCAAqC,CAAC;AAC/D,eAAO,MAAM,WAAW,qBAAqB,CAAC;AAC9C,eAAO,MAAM,mBAAmB,4DAAyC,CAAC;AAE1E,eAAO,MAAM,iBAAiB,eAAe,OAAO,CAAC,WAAW,CAAC,KAAQ,WAKvE,CAAC;AAEH,eAAO,MAAM,mBAAmB,iBAAiB,WAAW,KAAyB,OACpC,CAAC"}

package/dist/test/outbox/entities/span-context.factory.js

@@ -0,0 +1,12 @@
+import { ROOT_CONTEXT, TraceFlags, trace } from '@opentelemetry/api';
+export const TRACE_ID_HEX = '0af7651916cd43dd8448eb211c80319c';
+export const SPAN_ID_HEX = 'b7ad6b7169203331';
+export const SAMPLED_TRACEPARENT = `00-${TRACE_ID_HEX}-${SPAN_ID_HEX}-01`;
+export const createSpanContext = (overrides = {}) => ({
+    traceId: TRACE_ID_HEX,
+    spanId: SPAN_ID_HEX,
+    traceFlags: TraceFlags.SAMPLED,
+    ...overrides,
+});
+export const createActiveContext = (spanContext = createSpanContext()) => trace.setSpanContext(ROOT_CONTEXT, spanContext);
+//# sourceMappingURL=span-context.factory.js.map

package/dist/test/outbox/entities/span-context.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-context.factory.js","sourceRoot":"","sources":["../../../../src/test/outbox/entities/span-context.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAGrE,MAAM,CAAC,MAAM,YAAY,GAAG,kCAAkC,CAAC;AAC/D,MAAM,CAAC,MAAM,WAAW,GAAG,kBAAkB,CAAC;AAC9C,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,YAAY,IAAI,WAAW,KAAK,CAAC;AAE1E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,YAAkC,EAAE,EAAe,EAAE,CAAC,CAAC;IACvF,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,UAAU,EAAE,UAAU,CAAC,OAAO;IAC9B,GAAG,SAAS;CACb,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,cAA2B,iBAAiB,EAAE,EAAW,EAAE,CAC7F,KAAK,CAAC,cAAc,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC"}

package/dist/test/outbox/entities/traceparent-capture.unit.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=traceparent-capture.unit.spec.d.ts.map

package/dist/test/outbox/entities/traceparent-capture.unit.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceparent-capture.unit.spec.d.ts","sourceRoot":"","sources":["../../../../src/test/outbox/entities/traceparent-capture.unit.spec.ts"],"names":[],"mappings":""}

package/dist/test/outbox/entities/traceparent-capture.unit.spec.js

@@ -0,0 +1,142 @@
+import { afterAll, afterEach, beforeAll, describe, expect, it, jest } from '@jest/globals';
+import { ROOT_CONTEXT, context, propagation } from '@opentelemetry/api';
+import { W3CTraceContextPropagator } from '@opentelemetry/core';
+import { captureTraceparent, normalizeTraceparent, } from '../../../outbox/utils/capture-traceparent.js';
+import { EventQueueEntity } from '../../../outbox/entities/event-queue.entity.js';
+import { JobsOutboxEntity } from '../../../outbox/entities/jobs-outbox.entity.js';
+import { SAMPLED_TRACEPARENT, createActiveContext, createSpanContext, } from './span-context.factory.js';
+const EMITTER_ID = '00000000-0000-0000-0000-000000000000';
+const EXPLICIT_TRACEPARENT = '00-11111111111111111111111111111111-2222222222222222-00';
+describe('traceparent capture (Unit)', () => {
+    beforeAll(() => {
+        propagation.setGlobalPropagator(new W3CTraceContextPropagator());
+    });
+    afterAll(() => {
+        propagation.disable();
+    });
+    afterEach(() => {
+        jest.restoreAllMocks();
+    });
+    const withActiveSpan = (spanContext = createSpanContext()) => {
+        jest.spyOn(context, 'active').mockReturnValue(createActiveContext(spanContext));
+    };
+    const withoutActiveSpan = () => {
+        jest.spyOn(context, 'active').mockReturnValue(ROOT_CONTEXT);
+    };
+    describe('captureTraceparent', () => {
+        it('should serialise the active span as a 55 character W3C traceparent', () => {
+            withActiveSpan();
+            const traceparent = captureTraceparent();
+            expect(traceparent).toBe(SAMPLED_TRACEPARENT);
+            expect(traceparent).toHaveLength(55);
+        });
+        it('should keep the sampled flag of the active span', () => {
+            withActiveSpan(createSpanContext({ traceFlags: 0 }));
+            const traceparent = captureTraceparent();
+            expect(traceparent?.endsWith('-00')).toBe(true);
+        });
+        it('should return undefined without an active span', () => {
+            withoutActiveSpan();
+            expect(captureTraceparent()).toBeUndefined();
+        });
+        it('should return undefined when the active span context is invalid', () => {
+            withActiveSpan(createSpanContext({ traceId: '0'.repeat(32), spanId: '0'.repeat(16) }));
+            expect(captureTraceparent()).toBeUndefined();
+        });
+    });
+    describe('normalizeTraceparent', () => {
+        it('should turn the null read from a nullable column into undefined', () => {
+            expect(normalizeTraceparent(null)).toBeUndefined();
+        });
+        it('should turn the empty string of the stream wire format into undefined', () => {
+            expect(normalizeTraceparent('')).toBeUndefined();
+        });
+        it('should keep undefined and string values unchanged', () => {
+            expect(normalizeTraceparent(undefined)).toBeUndefined();
+            expect(normalizeTraceparent(SAMPLED_TRACEPARENT)).toBe(SAMPLED_TRACEPARENT);
+        });
+    });
+    describe('EventQueueEntity.createFollowUp', () => {
+        const makeProps = () => ({
+            type: 'user.badge_awarded',
+            emitter: 'post-processor-user',
+            emitterId: EMITTER_ID,
+            payload: { id: 'user-1' },
+            targetServices: [],
+        });
+        const CORRELATION_ID = '9f8c1a52-3d2e-4b8a-9c11-0d6a7e5b4c33';
+        it('should copy traceId, traceparent and correlationId from the source event', () => {
+            withoutActiveSpan();
+            const source = {
+                correlationId: CORRELATION_ID,
+                traceId: '0b1c2d3e-4f50-4162-8374-95a6b7c8d9e0',
+                traceparent: EXPLICIT_TRACEPARENT,
+            };
+            const entity = EventQueueEntity.createFollowUp(source, makeProps());
+            expect(entity.correlationId).toBe(CORRELATION_ID);
+            expect(entity.traceId).toBe(source.traceId);
+            expect(entity.traceparent).toBe(EXPLICIT_TRACEPARENT);
+        });
+        it('should not replace the source traceparent with the active span of the consumer', () => {
+            withActiveSpan();
+            const entity = EventQueueEntity.createFollowUp({ correlationId: CORRELATION_ID, traceparent: EXPLICIT_TRACEPARENT }, makeProps());
+            expect(entity.traceparent).toBe(EXPLICIT_TRACEPARENT);
+        });
+        it('should store no traceparent when the source message had none', () => {
+            withoutActiveSpan();
+            const entity = EventQueueEntity.createFollowUp({ correlationId: CORRELATION_ID, traceparent: '' }, makeProps());
+            expect(entity.traceparent).toBeUndefined();
+        });
+    });
+    describe('EventQueueEntity.createEvent', () => {
+        const makeProps = (traceparent) => ({
+            type: 'user.created',
+            emitter: 'ms-user',
+            emitterId: EMITTER_ID,
+            payload: { id: 'user-1' },
+            targetServices: [],
+            traceparent,
+        });
+        it('should store the active trace context in traceparent', () => {
+            withActiveSpan();
+            const entity = EventQueueEntity.createEvent(makeProps());
+            expect(entity.traceparent).toBe(SAMPLED_TRACEPARENT);
+        });
+        it('should leave traceparent undefined without an active span', () => {
+            withoutActiveSpan();
+            const entity = EventQueueEntity.createEvent(makeProps());
+            expect(entity.traceparent).toBeUndefined();
+        });
+        it('should prefer an explicit traceparent over the active span', () => {
+            withActiveSpan();
+            const entity = EventQueueEntity.createEvent(makeProps(EXPLICIT_TRACEPARENT));
+            expect(entity.traceparent).toBe(EXPLICIT_TRACEPARENT);
+        });
+    });
+    describe('JobsOutboxEntity.createJob', () => {
+        const makeProps = (traceparent) => ({
+            type: 'user.cleanup',
+            emitter: 'ms-user',
+            emitterId: EMITTER_ID,
+            target: 'worker-user',
+            payload: { id: 'user-1' },
+            traceparent,
+        });
+        it('should store the active trace context in traceparent', () => {
+            withActiveSpan();
+            const entity = JobsOutboxEntity.createJob(makeProps());
+            expect(entity.traceparent).toBe(SAMPLED_TRACEPARENT);
+        });
+        it('should leave traceparent undefined without an active span', () => {
+            withoutActiveSpan();
+            const entity = JobsOutboxEntity.createJob(makeProps());
+            expect(entity.traceparent).toBeUndefined();
+        });
+        it('should prefer an explicit traceparent over the active span', () => {
+            withActiveSpan();
+            const entity = JobsOutboxEntity.createJob(makeProps(EXPLICIT_TRACEPARENT));
+            expect(entity.traceparent).toBe(EXPLICIT_TRACEPARENT);
+        });
+    });
+});
+//# sourceMappingURL=traceparent-capture.unit.spec.js.map

package/dist/test/outbox/entities/traceparent-capture.unit.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceparent-capture.unit.spec.js","sourceRoot":"","sources":["../../../../src/test/outbox/entities/traceparent-capture.unit.spec.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volontariapp/database",
-  "version": "3.5.0",
+  "version": "3.6.0-snap-d038e0e",
   "publishConfig": {
     "access": "public",
     "provenance": true
@@ -40,11 +40,12 @@
     "db:down": "docker-compose -f ../../docker-compose.test.yml down"
   },
   "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
     "@volontariapp/bridge": "1.0.7",
     "@volontariapp/config": "3.2.3",
     "@volontariapp/errors": "0.6.3",
     "@volontariapp/logger": "0.3.0",
-    "@volontariapp/messaging": "2.24.0",
+    "@volontariapp/messaging": "2.25.0-snap-d038e0e",
     "@volontariapp/shared": "0.14.0",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.1",
@@ -53,6 +54,7 @@
   },
   "devDependencies": {
     "@jest/globals": "^30.3.0",
+    "@opentelemetry/core": "^2.6.1",
     "@types/jest": "^30.0.0",
     "@types/node": "^22.10.7",
     "@types/pg": "^8",