abxbus 2.4.19 → 2.4.20

package/dist/cjs/index.d.ts

@@ -8,6 +8,7 @@ export { monotonicDatetime } from './helpers.js';
 export type { EventBusMiddleware, EventBusMiddlewareCtor, EventBusMiddlewareInput } from './middlewares.js';
 export { OtelTracingMiddleware } from './middleware_otel_tracing.js';
 export type { OtelTracingMiddlewareOptions } from './middleware_otel_tracing.js';
+export type { OtelTracingSpanFactory, OtelTracingSpanFactoryInput } from './middleware_otel_tracing.js';
 export { EventHandlerTimeoutError, EventHandlerCancelledError, EventHandlerAbortedError, EventHandlerResultSchemaError, } from './event_handler.js';
 export type { EventConcurrencyMode, EventHandlerConcurrencyMode, EventHandlerCompletionMode, EventBusInterfaceForLockManager, } from './lock_manager.js';
 export type { EventClass, EventHandlerCallable as EventHandler, EventPattern, EventStatus, FindOptions, FindWindow } from './types.js';

package/dist/cjs/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/index.ts"],
-  "sourcesContent": ["export { BaseEvent, BaseEventSchema } from './base_event.js'\nexport { EventHistory } from './event_history.js'\nexport type { EventHistoryFindOptions, EventHistoryTrimOptions } from './event_history.js'\nexport { EventResult } from './event_result.js'\nexport { EventBus } from './event_bus.js'\nexport type { EventBusJSON, EventBusOptions } from './event_bus.js'\nexport { monotonicDatetime } from './helpers.js'\nexport type { EventBusMiddleware, EventBusMiddlewareCtor, EventBusMiddlewareInput } from './middlewares.js'\nexport { OtelTracingMiddleware } from './middleware_otel_tracing.js'\nexport type { OtelTracingMiddlewareOptions } from './middleware_otel_tracing.js'\nexport {\n  EventHandlerTimeoutError,\n  EventHandlerCancelledError,\n  EventHandlerAbortedError,\n  EventHandlerResultSchemaError,\n} from './event_handler.js'\nexport type {\n  EventConcurrencyMode,\n  EventHandlerConcurrencyMode,\n  EventHandlerCompletionMode,\n  EventBusInterfaceForLockManager,\n} from './lock_manager.js'\nexport type { EventClass, EventHandlerCallable as EventHandler, EventPattern, EventStatus, FindOptions, FindWindow } from './types.js'\nexport { retry, clearSemaphoreRegistry, RetryTimeoutError, SemaphoreTimeoutError } from './retry.js'\nexport type { RetryOptions } from './retry.js'\nexport {\n  HTTPEventBridge,\n  SocketEventBridge,\n  NATSEventBridge,\n  RedisEventBridge,\n  PostgresEventBridge,\n  JSONLEventBridge,\n  SQLiteEventBridge,\n} from './bridges.js'\nexport type { HTTPEventBridgeOptions } from './bridges.js'\nexport { events_suck } from './events_suck.js'\nexport type { EventsSuckClient, EventsSuckClientClass, GeneratedEvents } from './events_suck.js'\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wBAA2C;AAC3C,2BAA6B;AAE7B,0BAA4B;AAC5B,uBAAyB;AAEzB,qBAAkC;AAElC,qCAAsC;AAEtC,2BAKO;AAQP,mBAAwF;AAExF,qBAQO;AAEP,yBAA4B;",
+  "sourcesContent": ["export { BaseEvent, BaseEventSchema } from './base_event.js'\nexport { EventHistory } from './event_history.js'\nexport type { EventHistoryFindOptions, EventHistoryTrimOptions } from './event_history.js'\nexport { EventResult } from './event_result.js'\nexport { EventBus } from './event_bus.js'\nexport type { EventBusJSON, EventBusOptions } from './event_bus.js'\nexport { monotonicDatetime } from './helpers.js'\nexport type { EventBusMiddleware, EventBusMiddlewareCtor, EventBusMiddlewareInput } from './middlewares.js'\nexport { OtelTracingMiddleware } from './middleware_otel_tracing.js'\nexport type { OtelTracingMiddlewareOptions } from './middleware_otel_tracing.js'\nexport type { OtelTracingSpanFactory, OtelTracingSpanFactoryInput } from './middleware_otel_tracing.js'\nexport {\n  EventHandlerTimeoutError,\n  EventHandlerCancelledError,\n  EventHandlerAbortedError,\n  EventHandlerResultSchemaError,\n} from './event_handler.js'\nexport type {\n  EventConcurrencyMode,\n  EventHandlerConcurrencyMode,\n  EventHandlerCompletionMode,\n  EventBusInterfaceForLockManager,\n} from './lock_manager.js'\nexport type { EventClass, EventHandlerCallable as EventHandler, EventPattern, EventStatus, FindOptions, FindWindow } from './types.js'\nexport { retry, clearSemaphoreRegistry, RetryTimeoutError, SemaphoreTimeoutError } from './retry.js'\nexport type { RetryOptions } from './retry.js'\nexport {\n  HTTPEventBridge,\n  SocketEventBridge,\n  NATSEventBridge,\n  RedisEventBridge,\n  PostgresEventBridge,\n  JSONLEventBridge,\n  SQLiteEventBridge,\n} from './bridges.js'\nexport type { HTTPEventBridgeOptions } from './bridges.js'\nexport { events_suck } from './events_suck.js'\nexport type { EventsSuckClient, EventsSuckClientClass, GeneratedEvents } from './events_suck.js'\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wBAA2C;AAC3C,2BAA6B;AAE7B,0BAA4B;AAC5B,uBAAyB;AAEzB,qBAAkC;AAElC,qCAAsC;AAGtC,2BAKO;AAQP,mBAAwF;AAExF,qBAQO;AAEP,yBAA4B;",
   "names": []
 }

package/dist/cjs/middleware_otel_tracing.d.ts

@@ -1,19 +1,29 @@
-import { trace, type SpanAttributes, type Tracer } from '@opentelemetry/api';
+import { trace, type Span, type SpanAttributes, type SpanContext, type Tracer } from '@opentelemetry/api';
 import type { BaseEvent } from './base_event.js';
 import type { EventBus } from './event_bus.js';
 import type { EventResult } from './event_result.js';
 import type { EventBusMiddleware } from './middlewares.js';
 import type { EventStatus } from './types.js';
 type OpenTelemetryTraceApi = Pick<typeof trace, 'getTracer' | 'setSpan'>;
+export type OtelTracingSpanFactoryInput = {
+    name: string;
+    span_context: SpanContext;
+    parent_span_context?: SpanContext;
+    attributes: SpanAttributes;
+    start_time?: Date;
+};
+export type OtelTracingSpanFactory = (input: OtelTracingSpanFactoryInput) => Span;
 export type OtelTracingMiddlewareOptions = {
     tracer?: Tracer;
     trace_api?: OpenTelemetryTraceApi;
+    span_factory?: OtelTracingSpanFactory;
     root_span_name?: string | ((eventbus: EventBus, event: BaseEvent) => string);
     root_span_attributes?: SpanAttributes | ((eventbus: EventBus, event: BaseEvent) => SpanAttributes);
 };
 export declare class OtelTracingMiddleware implements EventBusMiddleware {
     private readonly tracer;
     private readonly trace_api;
+    private readonly span_factory?;
     private readonly root_span_name;
     private readonly root_span_attributes;
     private readonly root_spans;
@@ -32,5 +42,7 @@ export declare class OtelTracingMiddleware implements EventBusMiddleware {
     private startRootSpan;
     private completeRootSpan;
     private parentContextForEvent;
+    private completeEventSpanWithFactory;
+    private completeHandlerSpanWithFactory;
 }
 export {};

package/dist/cjs/middleware_otel_tracing.js

@@ -25,6 +25,7 @@ var import_api = require("@opentelemetry/api");
 class OtelTracingMiddleware {
   tracer;
   trace_api;
+  span_factory;
   root_span_name;
   root_span_attributes;
   root_spans = /* @__PURE__ */ new Map();
@@ -36,11 +37,15 @@ class OtelTracingMiddleware {
   constructor(options = {}) {
     this.trace_api = options.trace_api ?? import_api.trace;
     this.tracer = options.tracer ?? this.trace_api.getTracer("abxbus");
+    this.span_factory = options.span_factory;
     this.root_span_name = options.root_span_name;
     this.root_span_attributes = options.root_span_attributes;
   }
   onEventChange(eventbus, event, status) {
     if (status === "started") {
+      if (this.span_factory) {
+        return;
+      }
       this.startEventSpan(eventbus, event);
       return;
     }
@@ -50,11 +55,14 @@ class OtelTracingMiddleware {
   }
   onEventResultChange(eventbus, event, event_result, status) {
     if (status === "started") {
+      if (this.span_factory) {
+        return;
+      }
       this.startHandlerSpan(eventbus, event, event_result);
       return;
     }
     if (status === "completed") {
-      this.completeHandlerSpan(event_result);
+      this.completeHandlerSpan(eventbus, event, event_result);
     }
   }
   startEventSpan(eventbus, event) {
@@ -88,6 +96,10 @@ class OtelTracingMiddleware {
     return span;
   }
   completeEventSpan(eventbus, event) {
+    if (this.span_factory) {
+      this.completeEventSpanWithFactory(eventbus, event);
+      return;
+    }
     const span = this.event_spans.get(event.event_id) ?? this.startEventSpan(eventbus, event);
     if (event.event_errors.length > 0) {
       recordSpanError(span, event.event_errors[0]);
@@ -138,7 +150,11 @@ class OtelTracingMiddleware {
     this.handler_contexts.set(handlerSpanKey(event_result.event_id, event_result.handler_id), span_context);
     return span;
   }
-  completeHandlerSpan(event_result) {
+  completeHandlerSpan(eventbus, event, event_result) {
+    if (this.span_factory) {
+      this.completeHandlerSpanWithFactory(eventbus, event, event_result);
+      return;
+    }
     const span = this.handler_spans.get(event_result.id);
     if (!span) {
       return;
@@ -205,10 +221,167 @@ class OtelTracingMiddleware {
     }
     return event.event_parent_id ? this.event_contexts.get(event.event_parent_id) : void 0;
   }
+  completeEventSpanWithFactory(eventbus, event) {
+    const root_event = rootEventForEvent(eventbus, event);
+    const trace_id = traceIdForRootEvent(root_event.event_id);
+    const event_context = eventSpanContext(trace_id, event.event_id);
+    const start_time = dateFromIso(event.event_started_at);
+    const end_time = endTimeAfterStart(start_time, dateFromIso(event.event_completed_at));
+    if (!event.event_parent_id) {
+      const root_span = this.span_factory({
+        name: resolveRootSpanName(this.root_span_name, eventbus, event),
+        span_context: rootSpanContext(trace_id, event.event_id),
+        attributes: rootSpanAttributes(this.root_span_attributes, eventbus, event),
+        start_time
+      });
+      root_span.setStatus({ code: import_api.SpanStatusCode.OK });
+      root_span.end(end_time);
+    }
+    const span = this.span_factory({
+      name: `abxbus.event ${event.event_type}`,
+      span_context: event_context,
+      parent_span_context: parentSpanContextForEvent(event, trace_id),
+      attributes: eventSpanAttributes(eventbus, event),
+      start_time
+    });
+    if (event.event_errors.length > 0) {
+      recordSpanError(span, event.event_errors[0]);
+    } else {
+      span.setStatus({ code: import_api.SpanStatusCode.OK });
+    }
+    span.end(end_time);
+  }
+  completeHandlerSpanWithFactory(eventbus, event, event_result) {
+    const root_event = rootEventForEvent(eventbus, event);
+    const trace_id = traceIdForRootEvent(root_event.event_id);
+    const start_time = dateFromIso(event_result.started_at);
+    const span = this.span_factory({
+      name: `abxbus.handler ${event.event_type} ${event_result.handler_name}`,
+      span_context: handlerSpanContext(trace_id, event_result.event_id, event_result.handler_id),
+      parent_span_context: eventSpanContext(trace_id, event.event_id),
+      attributes: handlerSpanAttributes(eventbus, event, event_result),
+      start_time
+    });
+    if (event_result.error !== void 0) {
+      recordSpanError(span, event_result.error);
+    } else {
+      span.setStatus({ code: import_api.SpanStatusCode.OK });
+    }
+    span.end(endTimeAfterStart(start_time, dateFromIso(event_result.completed_at)));
+  }
 }
 function handlerSpanKey(event_id, handler_id) {
   return `${event_id}:${handler_id}`;
 }
+function eventSpanAttributes(eventbus, event) {
+  return compactAttributes({
+    "abxbus.bus.id": eventbus.id,
+    "abxbus.bus.name": eventbus.name,
+    "abxbus.event.id": event.event_id,
+    "abxbus.event.type": event.event_type,
+    "abxbus.event.version": event.event_version,
+    "abxbus.event.session_id": stringValue(event.session_id),
+    "abxbus.event.parent_id": event.event_parent_id,
+    "abxbus.event.emitted_by_handler_id": event.event_emitted_by_handler_id,
+    "abxbus.event.path": event.event_path.join(" "),
+    "abxbus.event.status": event.event_status,
+    "abxbus.event.result_count": event.event_results.size,
+    "abxbus.event.error_count": event.event_errors.length,
+    "abxbus.event.child_count": event.event_children.length
+  });
+}
+function handlerSpanAttributes(eventbus, event, event_result) {
+  return compactAttributes({
+    "abxbus.bus.id": eventbus.id,
+    "abxbus.bus.name": eventbus.name,
+    "abxbus.event.id": event.event_id,
+    "abxbus.event.type": event.event_type,
+    "abxbus.handler.id": event_result.handler_id,
+    "abxbus.handler.name": event_result.handler_name,
+    "abxbus.handler.file_path": event_result.handler_file_path,
+    "abxbus.handler.event_pattern": event_result.handler.event_pattern,
+    "abxbus.event_result.id": event_result.id,
+    "abxbus.event_result.status": event_result.status,
+    "abxbus.handler.child_count": event_result.event_children.length
+  });
+}
+function rootSpanAttributes(root_span_attributes, eventbus, event) {
+  const session_id = stringValue(event.session_id);
+  return compactAttributes({
+    ...resolveAttributes(root_span_attributes, eventbus, event),
+    "abxbus.trace.root": true,
+    "abxbus.bus.id": eventbus.id,
+    "abxbus.bus.name": eventbus.name,
+    "abxbus.root_event.id": event.event_id,
+    "abxbus.root_event.type": event.event_type,
+    "abxbus.root_event.session_id": session_id,
+    "abxbus.root_event.status": event.event_status,
+    "abxbus.root_event.error_count": event.event_errors.length,
+    "abxbus.root_event.child_count": event.event_children.length
+  });
+}
+function rootEventForEvent(eventbus, event) {
+  let current = event._event_original ?? event;
+  const seen = /* @__PURE__ */ new Set();
+  while (current.event_parent_id && !seen.has(current.event_id)) {
+    seen.add(current.event_id);
+    const parent = eventbus.findEventById(current.event_parent_id);
+    if (!parent) {
+      break;
+    }
+    current = parent._event_original ?? parent;
+  }
+  return current;
+}
+function parentSpanContextForEvent(event, trace_id) {
+  if (!event.event_parent_id) {
+    return rootSpanContext(trace_id, event.event_id);
+  }
+  if (event.event_emitted_by_handler_id) {
+    return handlerSpanContext(trace_id, event.event_parent_id, event.event_emitted_by_handler_id);
+  }
+  return eventSpanContext(trace_id, event.event_parent_id);
+}
+function rootSpanContext(trace_id, event_id) {
+  return {
+    traceId: trace_id,
+    spanId: deterministicSpanId(`abxbus.root:${event_id}`),
+    traceFlags: 1
+  };
+}
+function eventSpanContext(trace_id, event_id) {
+  return {
+    traceId: trace_id,
+    spanId: deterministicSpanId(`abxbus.event:${event_id}`),
+    traceFlags: 1
+  };
+}
+function handlerSpanContext(trace_id, event_id, handler_id) {
+  return {
+    traceId: trace_id,
+    spanId: deterministicSpanId(`abxbus.handler:${event_id}:${handler_id}`),
+    traceFlags: 1
+  };
+}
+function traceIdForRootEvent(event_id) {
+  return `${fnv1a64Hex(`abxbus.trace.a:${event_id}`)}${fnv1a64Hex(`abxbus.trace.b:${event_id}`)}`;
+}
+function deterministicSpanId(input) {
+  return fnv1a64Hex(input);
+}
+function fnv1a64Hex(input) {
+  let hash = 0xcbf29ce484222325n;
+  const prime = 0x100000001b3n;
+  const mask = 0xffffffffffffffffn;
+  for (let index = 0; index < input.length; index += 1) {
+    hash ^= BigInt(input.charCodeAt(index));
+    hash = hash * prime & mask;
+  }
+  if (hash === 0n) {
+    hash = 1n;
+  }
+  return hash.toString(16).padStart(16, "0");
+}
 function dateFromIso(value) {
   if (value == null) {
     return void 0;

package/dist/cjs/middleware_otel_tracing.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/middleware_otel_tracing.ts"],
-  "sourcesContent": ["import {\n  ROOT_CONTEXT,\n  SpanStatusCode,\n  trace,\n  type Context,\n  type Span,\n  type SpanAttributeValue,\n  type SpanAttributes,\n  type Tracer,\n} from '@opentelemetry/api'\n\nimport type { BaseEvent } from './base_event.js'\nimport type { EventBus } from './event_bus.js'\nimport type { EventResult } from './event_result.js'\nimport type { EventBusMiddleware } from './middlewares.js'\nimport type { EventStatus } from './types.js'\n\ntype OpenTelemetryTraceApi = Pick<typeof trace, 'getTracer' | 'setSpan'>\n\nexport type OtelTracingMiddlewareOptions = {\n  tracer?: Tracer\n  trace_api?: OpenTelemetryTraceApi\n  root_span_name?: string | ((eventbus: EventBus, event: BaseEvent) => string)\n  root_span_attributes?: SpanAttributes | ((eventbus: EventBus, event: BaseEvent) => SpanAttributes)\n}\n\nexport class OtelTracingMiddleware implements EventBusMiddleware {\n  private readonly tracer: Tracer\n  private readonly trace_api: OpenTelemetryTraceApi\n  private readonly root_span_name: OtelTracingMiddlewareOptions['root_span_name']\n  private readonly root_span_attributes: OtelTracingMiddlewareOptions['root_span_attributes']\n  private readonly root_spans = new Map<string, Span>()\n  private readonly root_contexts = new Map<string, Context>()\n  private readonly event_spans = new Map<string, Span>()\n  private readonly event_contexts = new Map<string, Context>()\n  private readonly handler_spans = new Map<string, Span>()\n  private readonly handler_contexts = new Map<string, Context>()\n\n  constructor(options: OtelTracingMiddlewareOptions = {}) {\n    this.trace_api = options.trace_api ?? trace\n    this.tracer = options.tracer ?? this.trace_api.getTracer('abxbus')\n    this.root_span_name = options.root_span_name\n    this.root_span_attributes = options.root_span_attributes\n  }\n\n  onEventChange(eventbus: EventBus, event: BaseEvent, status: EventStatus): void {\n    if (status === 'started') {\n      this.startEventSpan(eventbus, event)\n      return\n    }\n\n    if (status === 'completed') {\n      this.completeEventSpan(eventbus, event)\n    }\n  }\n\n  onEventResultChange(eventbus: EventBus, event: BaseEvent, event_result: EventResult, status: EventStatus): void {\n    if (status === 'started') {\n      this.startHandlerSpan(eventbus, event, event_result)\n      return\n    }\n\n    if (status === 'completed') {\n      this.completeHandlerSpan(event_result)\n    }\n  }\n\n  private startEventSpan(eventbus: EventBus, event: BaseEvent): Span {\n    const existing = this.event_spans.get(event.event_id)\n    if (existing) {\n      return existing\n    }\n\n    const parent_context = this.parentContextForEvent(event) ?? this.startRootSpan(eventbus, event)\n    const start_time = dateFromIso(event.event_started_at)\n    const span = this.tracer.startSpan(\n      `abxbus.event ${event.event_type}`,\n      {\n        attributes: compactAttributes({\n          'abxbus.bus.id': eventbus.id,\n          'abxbus.bus.name': eventbus.name,\n          'abxbus.event.id': event.event_id,\n          'abxbus.event.type': event.event_type,\n          'abxbus.event.version': event.event_version,\n          'abxbus.event.session_id': stringValue((event as { session_id?: unknown }).session_id),\n          'abxbus.event.parent_id': event.event_parent_id,\n          'abxbus.event.emitted_by_handler_id': event.event_emitted_by_handler_id,\n          'abxbus.event.path': event.event_path.join(' '),\n        }),\n        startTime: start_time,\n      },\n      parent_context\n    )\n    const span_context = this.trace_api.setSpan(parent_context, span)\n    this.event_spans.set(event.event_id, span)\n    this.event_contexts.set(event.event_id, span_context)\n    return span\n  }\n\n  private completeEventSpan(eventbus: EventBus, event: BaseEvent): void {\n    const span = this.event_spans.get(event.event_id) ?? this.startEventSpan(eventbus, event)\n    if (event.event_errors.length > 0) {\n      recordSpanError(span, event.event_errors[0])\n    } else {\n      span.setStatus({ code: SpanStatusCode.OK })\n    }\n    span.setAttributes(\n      compactAttributes({\n        'abxbus.event.status': event.event_status,\n        'abxbus.event.result_count': event.event_results.size,\n        'abxbus.event.error_count': event.event_errors.length,\n        'abxbus.event.child_count': event.event_children.length,\n      })\n    )\n    const start_time = dateFromIso(event.event_started_at)\n    const end_time = endTimeAfterStart(start_time, dateFromIso(event.event_completed_at))\n    span.end(end_time)\n    this.event_spans.delete(event.event_id)\n    this.event_contexts.delete(event.event_id)\n    this.completeRootSpan(event.event_id, start_time, end_time)\n  }\n\n  private startHandlerSpan(eventbus: EventBus, event: BaseEvent, event_result: EventResult): Span {\n    const existing = this.handler_spans.get(event_result.id)\n    if (existing) {\n      return existing\n    }\n\n    const parent_context =\n      this.event_contexts.get(event.event_id) ?? this.trace_api.setSpan(ROOT_CONTEXT, this.startEventSpan(eventbus, event))\n    const span = this.tracer.startSpan(\n      `abxbus.handler ${event.event_type} ${event_result.handler_name}`,\n      {\n        attributes: compactAttributes({\n          'abxbus.bus.id': eventbus.id,\n          'abxbus.bus.name': eventbus.name,\n          'abxbus.event.id': event.event_id,\n          'abxbus.event.type': event.event_type,\n          'abxbus.handler.id': event_result.handler_id,\n          'abxbus.handler.name': event_result.handler_name,\n          'abxbus.handler.file_path': event_result.handler_file_path,\n          'abxbus.handler.event_pattern': event_result.handler.event_pattern,\n          'abxbus.event_result.id': event_result.id,\n        }),\n        startTime: dateFromIso(event_result.started_at),\n      },\n      parent_context\n    )\n    const span_context = this.trace_api.setSpan(parent_context, span)\n    this.handler_spans.set(event_result.id, span)\n    this.handler_contexts.set(handlerSpanKey(event_result.event_id, event_result.handler_id), span_context)\n    return span\n  }\n\n  private completeHandlerSpan(event_result: EventResult): void {\n    const span = this.handler_spans.get(event_result.id)\n    if (!span) {\n      return\n    }\n\n    if (event_result.error !== undefined) {\n      recordSpanError(span, event_result.error)\n    } else {\n      span.setStatus({ code: SpanStatusCode.OK })\n    }\n    span.setAttributes(\n      compactAttributes({\n        'abxbus.event_result.status': event_result.status,\n        'abxbus.handler.child_count': event_result.event_children.length,\n      })\n    )\n    span.end(endTimeAfterStart(dateFromIso(event_result.started_at), dateFromIso(event_result.completed_at)))\n    this.handler_spans.delete(event_result.id)\n    this.handler_contexts.delete(handlerSpanKey(event_result.event_id, event_result.handler_id))\n  }\n\n  private startRootSpan(eventbus: EventBus, event: BaseEvent): Context {\n    const existing = this.root_contexts.get(event.event_id)\n    if (existing) {\n      return existing\n    }\n\n    const session_id = stringValue((event as { session_id?: unknown }).session_id)\n    const root_attributes = resolveAttributes(this.root_span_attributes, eventbus, event)\n    const root_span = this.tracer.startSpan(\n      resolveRootSpanName(this.root_span_name, eventbus, event),\n      {\n        attributes: compactAttributes({\n          ...root_attributes,\n          'abxbus.trace.root': true,\n          'abxbus.bus.id': eventbus.id,\n          'abxbus.bus.name': eventbus.name,\n          'abxbus.root_event.id': event.event_id,\n          'abxbus.root_event.type': event.event_type,\n          'abxbus.root_event.session_id': session_id,\n        }),\n        startTime: dateFromIso(event.event_started_at),\n      },\n      ROOT_CONTEXT\n    )\n    const root_context = this.trace_api.setSpan(ROOT_CONTEXT, root_span)\n    this.root_spans.set(event.event_id, root_span)\n    this.root_contexts.set(event.event_id, root_context)\n    return root_context\n  }\n\n  private completeRootSpan(event_id: string, start_time: Date | undefined, end_time: Date | undefined): void {\n    const root_span = this.root_spans.get(event_id)\n    if (!root_span) {\n      return\n    }\n\n    root_span.setStatus({ code: SpanStatusCode.OK })\n    root_span.end(endTimeAfterStart(start_time, end_time))\n    this.root_spans.delete(event_id)\n    this.root_contexts.delete(event_id)\n  }\n\n  private parentContextForEvent(event: BaseEvent): Context | undefined {\n    if (event.event_parent_id && event.event_emitted_by_handler_id) {\n      const handler_context = this.handler_contexts.get(handlerSpanKey(event.event_parent_id, event.event_emitted_by_handler_id))\n      if (handler_context) {\n        return handler_context\n      }\n    }\n\n    return event.event_parent_id ? this.event_contexts.get(event.event_parent_id) : undefined\n  }\n}\n\nfunction handlerSpanKey(event_id: string, handler_id: string): string {\n  return `${event_id}:${handler_id}`\n}\n\nfunction dateFromIso(value: string | null | undefined): Date | undefined {\n  if (value == null) {\n    return undefined\n  }\n  const date = new Date(value)\n  return Number.isNaN(date.getTime()) ? undefined : date\n}\n\nfunction endTimeAfterStart(start_time: Date | undefined, end_time: Date | undefined): Date | undefined {\n  if (!start_time || !end_time) {\n    return end_time\n  }\n\n  return end_time.getTime() > start_time.getTime() ? end_time : new Date(start_time.getTime() + 1)\n}\n\nfunction resolveRootSpanName(\n  root_span_name: OtelTracingMiddlewareOptions['root_span_name'],\n  eventbus: EventBus,\n  event: BaseEvent\n): string {\n  if (typeof root_span_name === 'function') {\n    return root_span_name(eventbus, event)\n  }\n  return root_span_name ?? `abxbus.trace ${eventbus.name}`\n}\n\nfunction resolveAttributes(\n  attributes: OtelTracingMiddlewareOptions['root_span_attributes'],\n  eventbus: EventBus,\n  event: BaseEvent\n): SpanAttributes {\n  return typeof attributes === 'function' ? attributes(eventbus, event) : (attributes ?? {})\n}\n\nfunction stringValue(value: unknown): string | undefined {\n  return typeof value === 'string' && value.length > 0 ? value : undefined\n}\n\nfunction compactAttributes(attributes: Record<string, SpanAttributeValue | null | undefined>): SpanAttributes {\n  const compacted: SpanAttributes = {}\n  for (const [key, value] of Object.entries(attributes)) {\n    if (value !== null && value !== undefined) {\n      compacted[key] = value\n    }\n  }\n  return compacted\n}\n\nfunction recordSpanError(span: Span, error: unknown): void {\n  if (error instanceof Error) {\n    span.recordException(error)\n    span.setStatus({ code: SpanStatusCode.ERROR, message: error.message })\n    return\n  }\n\n  const message = typeof error === 'string' ? error : 'Unknown abxbus handler error'\n  span.recordException(message)\n  span.setStatus({ code: SpanStatusCode.ERROR, message })\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {\n  ROOT_CONTEXT,\n  SpanStatusCode,\n  trace,\n  type Context,\n  type Span,\n  type SpanAttributeValue,\n  type SpanAttributes,\n  type SpanContext,\n  type Tracer,\n} from '@opentelemetry/api'\n\nimport type { BaseEvent } from './base_event.js'\nimport type { EventBus } from './event_bus.js'\nimport type { EventResult } from './event_result.js'\nimport type { EventBusMiddleware } from './middlewares.js'\nimport type { EventStatus } from './types.js'\n\ntype OpenTelemetryTraceApi = Pick<typeof trace, 'getTracer' | 'setSpan'>\n\nexport type OtelTracingSpanFactoryInput = {\n  name: string\n  span_context: SpanContext\n  parent_span_context?: SpanContext\n  attributes: SpanAttributes\n  start_time?: Date\n}\n\nexport type OtelTracingSpanFactory = (input: OtelTracingSpanFactoryInput) => Span\n\nexport type OtelTracingMiddlewareOptions = {\n  tracer?: Tracer\n  trace_api?: OpenTelemetryTraceApi\n  span_factory?: OtelTracingSpanFactory\n  root_span_name?: string | ((eventbus: EventBus, event: BaseEvent) => string)\n  root_span_attributes?: SpanAttributes | ((eventbus: EventBus, event: BaseEvent) => SpanAttributes)\n}\n\nexport class OtelTracingMiddleware implements EventBusMiddleware {\n  private readonly tracer: Tracer\n  private readonly trace_api: OpenTelemetryTraceApi\n  private readonly span_factory?: OtelTracingSpanFactory\n  private readonly root_span_name: OtelTracingMiddlewareOptions['root_span_name']\n  private readonly root_span_attributes: OtelTracingMiddlewareOptions['root_span_attributes']\n  private readonly root_spans = new Map<string, Span>()\n  private readonly root_contexts = new Map<string, Context>()\n  private readonly event_spans = new Map<string, Span>()\n  private readonly event_contexts = new Map<string, Context>()\n  private readonly handler_spans = new Map<string, Span>()\n  private readonly handler_contexts = new Map<string, Context>()\n\n  constructor(options: OtelTracingMiddlewareOptions = {}) {\n    this.trace_api = options.trace_api ?? trace\n    this.tracer = options.tracer ?? this.trace_api.getTracer('abxbus')\n    this.span_factory = options.span_factory\n    this.root_span_name = options.root_span_name\n    this.root_span_attributes = options.root_span_attributes\n  }\n\n  onEventChange(eventbus: EventBus, event: BaseEvent, status: EventStatus): void {\n    if (status === 'started') {\n      if (this.span_factory) {\n        return\n      }\n      this.startEventSpan(eventbus, event)\n      return\n    }\n\n    if (status === 'completed') {\n      this.completeEventSpan(eventbus, event)\n    }\n  }\n\n  onEventResultChange(eventbus: EventBus, event: BaseEvent, event_result: EventResult, status: EventStatus): void {\n    if (status === 'started') {\n      if (this.span_factory) {\n        return\n      }\n      this.startHandlerSpan(eventbus, event, event_result)\n      return\n    }\n\n    if (status === 'completed') {\n      this.completeHandlerSpan(eventbus, event, event_result)\n    }\n  }\n\n  private startEventSpan(eventbus: EventBus, event: BaseEvent): Span {\n    const existing = this.event_spans.get(event.event_id)\n    if (existing) {\n      return existing\n    }\n\n    const parent_context = this.parentContextForEvent(event) ?? this.startRootSpan(eventbus, event)\n    const start_time = dateFromIso(event.event_started_at)\n    const span = this.tracer.startSpan(\n      `abxbus.event ${event.event_type}`,\n      {\n        attributes: compactAttributes({\n          'abxbus.bus.id': eventbus.id,\n          'abxbus.bus.name': eventbus.name,\n          'abxbus.event.id': event.event_id,\n          'abxbus.event.type': event.event_type,\n          'abxbus.event.version': event.event_version,\n          'abxbus.event.session_id': stringValue((event as { session_id?: unknown }).session_id),\n          'abxbus.event.parent_id': event.event_parent_id,\n          'abxbus.event.emitted_by_handler_id': event.event_emitted_by_handler_id,\n          'abxbus.event.path': event.event_path.join(' '),\n        }),\n        startTime: start_time,\n      },\n      parent_context\n    )\n    const span_context = this.trace_api.setSpan(parent_context, span)\n    this.event_spans.set(event.event_id, span)\n    this.event_contexts.set(event.event_id, span_context)\n    return span\n  }\n\n  private completeEventSpan(eventbus: EventBus, event: BaseEvent): void {\n    if (this.span_factory) {\n      this.completeEventSpanWithFactory(eventbus, event)\n      return\n    }\n\n    const span = this.event_spans.get(event.event_id) ?? this.startEventSpan(eventbus, event)\n    if (event.event_errors.length > 0) {\n      recordSpanError(span, event.event_errors[0])\n    } else {\n      span.setStatus({ code: SpanStatusCode.OK })\n    }\n    span.setAttributes(\n      compactAttributes({\n        'abxbus.event.status': event.event_status,\n        'abxbus.event.result_count': event.event_results.size,\n        'abxbus.event.error_count': event.event_errors.length,\n        'abxbus.event.child_count': event.event_children.length,\n      })\n    )\n    const start_time = dateFromIso(event.event_started_at)\n    const end_time = endTimeAfterStart(start_time, dateFromIso(event.event_completed_at))\n    span.end(end_time)\n    this.event_spans.delete(event.event_id)\n    this.event_contexts.delete(event.event_id)\n    this.completeRootSpan(event.event_id, start_time, end_time)\n  }\n\n  private startHandlerSpan(eventbus: EventBus, event: BaseEvent, event_result: EventResult): Span {\n    const existing = this.handler_spans.get(event_result.id)\n    if (existing) {\n      return existing\n    }\n\n    const parent_context =\n      this.event_contexts.get(event.event_id) ?? this.trace_api.setSpan(ROOT_CONTEXT, this.startEventSpan(eventbus, event))\n    const span = this.tracer.startSpan(\n      `abxbus.handler ${event.event_type} ${event_result.handler_name}`,\n      {\n        attributes: compactAttributes({\n          'abxbus.bus.id': eventbus.id,\n          'abxbus.bus.name': eventbus.name,\n          'abxbus.event.id': event.event_id,\n          'abxbus.event.type': event.event_type,\n          'abxbus.handler.id': event_result.handler_id,\n          'abxbus.handler.name': event_result.handler_name,\n          'abxbus.handler.file_path': event_result.handler_file_path,\n          'abxbus.handler.event_pattern': event_result.handler.event_pattern,\n          'abxbus.event_result.id': event_result.id,\n        }),\n        startTime: dateFromIso(event_result.started_at),\n      },\n      parent_context\n    )\n    const span_context = this.trace_api.setSpan(parent_context, span)\n    this.handler_spans.set(event_result.id, span)\n    this.handler_contexts.set(handlerSpanKey(event_result.event_id, event_result.handler_id), span_context)\n    return span\n  }\n\n  private completeHandlerSpan(eventbus: EventBus, event: BaseEvent, event_result: EventResult): void {\n    if (this.span_factory) {\n      this.completeHandlerSpanWithFactory(eventbus, event, event_result)\n      return\n    }\n\n    const span = this.handler_spans.get(event_result.id)\n    if (!span) {\n      return\n    }\n\n    if (event_result.error !== undefined) {\n      recordSpanError(span, event_result.error)\n    } else {\n      span.setStatus({ code: SpanStatusCode.OK })\n    }\n    span.setAttributes(\n      compactAttributes({\n        'abxbus.event_result.status': event_result.status,\n        'abxbus.handler.child_count': event_result.event_children.length,\n      })\n    )\n    span.end(endTimeAfterStart(dateFromIso(event_result.started_at), dateFromIso(event_result.completed_at)))\n    this.handler_spans.delete(event_result.id)\n    this.handler_contexts.delete(handlerSpanKey(event_result.event_id, event_result.handler_id))\n  }\n\n  private startRootSpan(eventbus: EventBus, event: BaseEvent): Context {\n    const existing = this.root_contexts.get(event.event_id)\n    if (existing) {\n      return existing\n    }\n\n    const session_id = stringValue((event as { session_id?: unknown }).session_id)\n    const root_attributes = resolveAttributes(this.root_span_attributes, eventbus, event)\n    const root_span = this.tracer.startSpan(\n      resolveRootSpanName(this.root_span_name, eventbus, event),\n      {\n        attributes: compactAttributes({\n          ...root_attributes,\n          'abxbus.trace.root': true,\n          'abxbus.bus.id': eventbus.id,\n          'abxbus.bus.name': eventbus.name,\n          'abxbus.root_event.id': event.event_id,\n          'abxbus.root_event.type': event.event_type,\n          'abxbus.root_event.session_id': session_id,\n        }),\n        startTime: dateFromIso(event.event_started_at),\n      },\n      ROOT_CONTEXT\n    )\n    const root_context = this.trace_api.setSpan(ROOT_CONTEXT, root_span)\n    this.root_spans.set(event.event_id, root_span)\n    this.root_contexts.set(event.event_id, root_context)\n    return root_context\n  }\n\n  private completeRootSpan(event_id: string, start_time: Date | undefined, end_time: Date | undefined): void {\n    const root_span = this.root_spans.get(event_id)\n    if (!root_span) {\n      return\n    }\n\n    root_span.setStatus({ code: SpanStatusCode.OK })\n    root_span.end(endTimeAfterStart(start_time, end_time))\n    this.root_spans.delete(event_id)\n    this.root_contexts.delete(event_id)\n  }\n\n  private parentContextForEvent(event: BaseEvent): Context | undefined {\n    if (event.event_parent_id && event.event_emitted_by_handler_id) {\n      const handler_context = this.handler_contexts.get(handlerSpanKey(event.event_parent_id, event.event_emitted_by_handler_id))\n      if (handler_context) {\n        return handler_context\n      }\n    }\n\n    return event.event_parent_id ? this.event_contexts.get(event.event_parent_id) : undefined\n  }\n\n  private completeEventSpanWithFactory(eventbus: EventBus, event: BaseEvent): void {\n    const root_event = rootEventForEvent(eventbus, event)\n    const trace_id = traceIdForRootEvent(root_event.event_id)\n    const event_context = eventSpanContext(trace_id, event.event_id)\n    const start_time = dateFromIso(event.event_started_at)\n    const end_time = endTimeAfterStart(start_time, dateFromIso(event.event_completed_at))\n\n    if (!event.event_parent_id) {\n      const root_span = this.span_factory!({\n        name: resolveRootSpanName(this.root_span_name, eventbus, event),\n        span_context: rootSpanContext(trace_id, event.event_id),\n        attributes: rootSpanAttributes(this.root_span_attributes, eventbus, event),\n        start_time,\n      })\n      root_span.setStatus({ code: SpanStatusCode.OK })\n      root_span.end(end_time)\n    }\n\n    const span = this.span_factory!({\n      name: `abxbus.event ${event.event_type}`,\n      span_context: event_context,\n      parent_span_context: parentSpanContextForEvent(event, trace_id),\n      attributes: eventSpanAttributes(eventbus, event),\n      start_time,\n    })\n    if (event.event_errors.length > 0) {\n      recordSpanError(span, event.event_errors[0])\n    } else {\n      span.setStatus({ code: SpanStatusCode.OK })\n    }\n    span.end(end_time)\n  }\n\n  private completeHandlerSpanWithFactory(eventbus: EventBus, event: BaseEvent, event_result: EventResult): void {\n    const root_event = rootEventForEvent(eventbus, event)\n    const trace_id = traceIdForRootEvent(root_event.event_id)\n    const start_time = dateFromIso(event_result.started_at)\n    const span = this.span_factory!({\n      name: `abxbus.handler ${event.event_type} ${event_result.handler_name}`,\n      span_context: handlerSpanContext(trace_id, event_result.event_id, event_result.handler_id),\n      parent_span_context: eventSpanContext(trace_id, event.event_id),\n      attributes: handlerSpanAttributes(eventbus, event, event_result),\n      start_time,\n    })\n\n    if (event_result.error !== undefined) {\n      recordSpanError(span, event_result.error)\n    } else {\n      span.setStatus({ code: SpanStatusCode.OK })\n    }\n    span.end(endTimeAfterStart(start_time, dateFromIso(event_result.completed_at)))\n  }\n}\n\nfunction handlerSpanKey(event_id: string, handler_id: string): string {\n  return `${event_id}:${handler_id}`\n}\n\nfunction eventSpanAttributes(eventbus: EventBus, event: BaseEvent): SpanAttributes {\n  return compactAttributes({\n    'abxbus.bus.id': eventbus.id,\n    'abxbus.bus.name': eventbus.name,\n    'abxbus.event.id': event.event_id,\n    'abxbus.event.type': event.event_type,\n    'abxbus.event.version': event.event_version,\n    'abxbus.event.session_id': stringValue((event as { session_id?: unknown }).session_id),\n    'abxbus.event.parent_id': event.event_parent_id,\n    'abxbus.event.emitted_by_handler_id': event.event_emitted_by_handler_id,\n    'abxbus.event.path': event.event_path.join(' '),\n    'abxbus.event.status': event.event_status,\n    'abxbus.event.result_count': event.event_results.size,\n    'abxbus.event.error_count': event.event_errors.length,\n    'abxbus.event.child_count': event.event_children.length,\n  })\n}\n\nfunction handlerSpanAttributes(eventbus: EventBus, event: BaseEvent, event_result: EventResult): SpanAttributes {\n  return compactAttributes({\n    'abxbus.bus.id': eventbus.id,\n    'abxbus.bus.name': eventbus.name,\n    'abxbus.event.id': event.event_id,\n    'abxbus.event.type': event.event_type,\n    'abxbus.handler.id': event_result.handler_id,\n    'abxbus.handler.name': event_result.handler_name,\n    'abxbus.handler.file_path': event_result.handler_file_path,\n    'abxbus.handler.event_pattern': event_result.handler.event_pattern,\n    'abxbus.event_result.id': event_result.id,\n    'abxbus.event_result.status': event_result.status,\n    'abxbus.handler.child_count': event_result.event_children.length,\n  })\n}\n\nfunction rootSpanAttributes(\n  root_span_attributes: OtelTracingMiddlewareOptions['root_span_attributes'],\n  eventbus: EventBus,\n  event: BaseEvent\n): SpanAttributes {\n  const session_id = stringValue((event as { session_id?: unknown }).session_id)\n  return compactAttributes({\n    ...resolveAttributes(root_span_attributes, eventbus, event),\n    'abxbus.trace.root': true,\n    'abxbus.bus.id': eventbus.id,\n    'abxbus.bus.name': eventbus.name,\n    'abxbus.root_event.id': event.event_id,\n    'abxbus.root_event.type': event.event_type,\n    'abxbus.root_event.session_id': session_id,\n    'abxbus.root_event.status': event.event_status,\n    'abxbus.root_event.error_count': event.event_errors.length,\n    'abxbus.root_event.child_count': event.event_children.length,\n  })\n}\n\nfunction rootEventForEvent(eventbus: EventBus, event: BaseEvent): BaseEvent {\n  let current = event._event_original ?? event\n  const seen = new Set<string>()\n  while (current.event_parent_id && !seen.has(current.event_id)) {\n    seen.add(current.event_id)\n    const parent = eventbus.findEventById(current.event_parent_id)\n    if (!parent) {\n      break\n    }\n    current = parent._event_original ?? parent\n  }\n  return current\n}\n\nfunction parentSpanContextForEvent(event: BaseEvent, trace_id: string): SpanContext {\n  if (!event.event_parent_id) {\n    return rootSpanContext(trace_id, event.event_id)\n  }\n\n  if (event.event_emitted_by_handler_id) {\n    return handlerSpanContext(trace_id, event.event_parent_id, event.event_emitted_by_handler_id)\n  }\n\n  return eventSpanContext(trace_id, event.event_parent_id)\n}\n\nfunction rootSpanContext(trace_id: string, event_id: string): SpanContext {\n  return {\n    traceId: trace_id,\n    spanId: deterministicSpanId(`abxbus.root:${event_id}`),\n    traceFlags: 1,\n  }\n}\n\nfunction eventSpanContext(trace_id: string, event_id: string): SpanContext {\n  return {\n    traceId: trace_id,\n    spanId: deterministicSpanId(`abxbus.event:${event_id}`),\n    traceFlags: 1,\n  }\n}\n\nfunction handlerSpanContext(trace_id: string, event_id: string, handler_id: string): SpanContext {\n  return {\n    traceId: trace_id,\n    spanId: deterministicSpanId(`abxbus.handler:${event_id}:${handler_id}`),\n    traceFlags: 1,\n  }\n}\n\nfunction traceIdForRootEvent(event_id: string): string {\n  return `${fnv1a64Hex(`abxbus.trace.a:${event_id}`)}${fnv1a64Hex(`abxbus.trace.b:${event_id}`)}`\n}\n\nfunction deterministicSpanId(input: string): string {\n  return fnv1a64Hex(input)\n}\n\nfunction fnv1a64Hex(input: string): string {\n  let hash = 0xcbf29ce484222325n\n  const prime = 0x100000001b3n\n  const mask = 0xffffffffffffffffn\n  for (let index = 0; index < input.length; index += 1) {\n    hash ^= BigInt(input.charCodeAt(index))\n    hash = (hash * prime) & mask\n  }\n  if (hash === 0n) {\n    hash = 1n\n  }\n  return hash.toString(16).padStart(16, '0')\n}\n\nfunction dateFromIso(value: string | null | undefined): Date | undefined {\n  if (value == null) {\n    return undefined\n  }\n  const date = new Date(value)\n  return Number.isNaN(date.getTime()) ? undefined : date\n}\n\nfunction endTimeAfterStart(start_time: Date | undefined, end_time: Date | undefined): Date | undefined {\n  if (!start_time || !end_time) {\n    return end_time\n  }\n\n  return end_time.getTime() > start_time.getTime() ? end_time : new Date(start_time.getTime() + 1)\n}\n\nfunction resolveRootSpanName(root_span_name: OtelTracingMiddlewareOptions['root_span_name'], eventbus: EventBus, event: BaseEvent): string {\n  if (typeof root_span_name === 'function') {\n    return root_span_name(eventbus, event)\n  }\n  return root_span_name ?? `abxbus.trace ${eventbus.name}`\n}\n\nfunction resolveAttributes(\n  attributes: OtelTracingMiddlewareOptions['root_span_attributes'],\n  eventbus: EventBus,\n  event: BaseEvent\n): SpanAttributes {\n  return typeof attributes === 'function' ? attributes(eventbus, event) : (attributes ?? {})\n}\n\nfunction stringValue(value: unknown): string | undefined {\n  return typeof value === 'string' && value.length > 0 ? value : undefined\n}\n\nfunction compactAttributes(attributes: Record<string, SpanAttributeValue | null | undefined>): SpanAttributes {\n  const compacted: SpanAttributes = {}\n  for (const [key, value] of Object.entries(attributes)) {\n    if (value !== null && value !== undefined) {\n      compacted[key] = value\n    }\n  }\n  return compacted\n}\n\nfunction recordSpanError(span: Span, error: unknown): void {\n  if (error instanceof Error) {\n    span.recordException(error)\n    span.setStatus({ code: SpanStatusCode.ERROR, message: error.message })\n    return\n  }\n\n  const message = typeof error === 'string' ? error : 'Unknown abxbus handler error'\n  span.recordException(message)\n  span.setStatus({ code: SpanStatusCode.ERROR, message })\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/esm/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/index.ts"],
-  "sourcesContent": ["export { BaseEvent, BaseEventSchema } from './base_event.js'\nexport { EventHistory } from './event_history.js'\nexport type { EventHistoryFindOptions, EventHistoryTrimOptions } from './event_history.js'\nexport { EventResult } from './event_result.js'\nexport { EventBus } from './event_bus.js'\nexport type { EventBusJSON, EventBusOptions } from './event_bus.js'\nexport { monotonicDatetime } from './helpers.js'\nexport type { EventBusMiddleware, EventBusMiddlewareCtor, EventBusMiddlewareInput } from './middlewares.js'\nexport { OtelTracingMiddleware } from './middleware_otel_tracing.js'\nexport type { OtelTracingMiddlewareOptions } from './middleware_otel_tracing.js'\nexport {\n  EventHandlerTimeoutError,\n  EventHandlerCancelledError,\n  EventHandlerAbortedError,\n  EventHandlerResultSchemaError,\n} from './event_handler.js'\nexport type {\n  EventConcurrencyMode,\n  EventHandlerConcurrencyMode,\n  EventHandlerCompletionMode,\n  EventBusInterfaceForLockManager,\n} from './lock_manager.js'\nexport type { EventClass, EventHandlerCallable as EventHandler, EventPattern, EventStatus, FindOptions, FindWindow } from './types.js'\nexport { retry, clearSemaphoreRegistry, RetryTimeoutError, SemaphoreTimeoutError } from './retry.js'\nexport type { RetryOptions } from './retry.js'\nexport {\n  HTTPEventBridge,\n  SocketEventBridge,\n  NATSEventBridge,\n  RedisEventBridge,\n  PostgresEventBridge,\n  JSONLEventBridge,\n  SQLiteEventBridge,\n} from './bridges.js'\nexport type { HTTPEventBridgeOptions } from './bridges.js'\nexport { events_suck } from './events_suck.js'\nexport type { EventsSuckClient, EventsSuckClientClass, GeneratedEvents } from './events_suck.js'\n"],
-  "mappings": "AAAA,SAAS,WAAW,uBAAuB;AAC3C,SAAS,oBAAoB;AAE7B,SAAS,mBAAmB;AAC5B,SAAS,gBAAgB;AAEzB,SAAS,yBAAyB;AAElC,SAAS,6BAA6B;AAEtC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAQP,SAAS,OAAO,wBAAwB,mBAAmB,6BAA6B;AAExF;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,mBAAmB;",
+  "sourcesContent": ["export { BaseEvent, BaseEventSchema } from './base_event.js'\nexport { EventHistory } from './event_history.js'\nexport type { EventHistoryFindOptions, EventHistoryTrimOptions } from './event_history.js'\nexport { EventResult } from './event_result.js'\nexport { EventBus } from './event_bus.js'\nexport type { EventBusJSON, EventBusOptions } from './event_bus.js'\nexport { monotonicDatetime } from './helpers.js'\nexport type { EventBusMiddleware, EventBusMiddlewareCtor, EventBusMiddlewareInput } from './middlewares.js'\nexport { OtelTracingMiddleware } from './middleware_otel_tracing.js'\nexport type { OtelTracingMiddlewareOptions } from './middleware_otel_tracing.js'\nexport type { OtelTracingSpanFactory, OtelTracingSpanFactoryInput } from './middleware_otel_tracing.js'\nexport {\n  EventHandlerTimeoutError,\n  EventHandlerCancelledError,\n  EventHandlerAbortedError,\n  EventHandlerResultSchemaError,\n} from './event_handler.js'\nexport type {\n  EventConcurrencyMode,\n  EventHandlerConcurrencyMode,\n  EventHandlerCompletionMode,\n  EventBusInterfaceForLockManager,\n} from './lock_manager.js'\nexport type { EventClass, EventHandlerCallable as EventHandler, EventPattern, EventStatus, FindOptions, FindWindow } from './types.js'\nexport { retry, clearSemaphoreRegistry, RetryTimeoutError, SemaphoreTimeoutError } from './retry.js'\nexport type { RetryOptions } from './retry.js'\nexport {\n  HTTPEventBridge,\n  SocketEventBridge,\n  NATSEventBridge,\n  RedisEventBridge,\n  PostgresEventBridge,\n  JSONLEventBridge,\n  SQLiteEventBridge,\n} from './bridges.js'\nexport type { HTTPEventBridgeOptions } from './bridges.js'\nexport { events_suck } from './events_suck.js'\nexport type { EventsSuckClient, EventsSuckClientClass, GeneratedEvents } from './events_suck.js'\n"],
+  "mappings": "AAAA,SAAS,WAAW,uBAAuB;AAC3C,SAAS,oBAAoB;AAE7B,SAAS,mBAAmB;AAC5B,SAAS,gBAAgB;AAEzB,SAAS,yBAAyB;AAElC,SAAS,6BAA6B;AAGtC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAQP,SAAS,OAAO,wBAAwB,mBAAmB,6BAA6B;AAExF;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,mBAAmB;",
   "names": []
 }

package/dist/esm/middleware_otel_tracing.js

@@ -6,6 +6,7 @@ import {
 class OtelTracingMiddleware {
   tracer;
   trace_api;
+  span_factory;
   root_span_name;
   root_span_attributes;
   root_spans = /* @__PURE__ */ new Map();
@@ -17,11 +18,15 @@ class OtelTracingMiddleware {
   constructor(options = {}) {
     this.trace_api = options.trace_api ?? trace;
     this.tracer = options.tracer ?? this.trace_api.getTracer("abxbus");
+    this.span_factory = options.span_factory;
     this.root_span_name = options.root_span_name;
     this.root_span_attributes = options.root_span_attributes;
   }
   onEventChange(eventbus, event, status) {
     if (status === "started") {
+      if (this.span_factory) {
+        return;
+      }
       this.startEventSpan(eventbus, event);
       return;
     }
@@ -31,11 +36,14 @@ class OtelTracingMiddleware {
   }
   onEventResultChange(eventbus, event, event_result, status) {
     if (status === "started") {
+      if (this.span_factory) {
+        return;
+      }
       this.startHandlerSpan(eventbus, event, event_result);
       return;
     }
     if (status === "completed") {
-      this.completeHandlerSpan(event_result);
+      this.completeHandlerSpan(eventbus, event, event_result);
     }
   }
   startEventSpan(eventbus, event) {
@@ -69,6 +77,10 @@ class OtelTracingMiddleware {
     return span;
   }
   completeEventSpan(eventbus, event) {
+    if (this.span_factory) {
+      this.completeEventSpanWithFactory(eventbus, event);
+      return;
+    }
     const span = this.event_spans.get(event.event_id) ?? this.startEventSpan(eventbus, event);
     if (event.event_errors.length > 0) {
       recordSpanError(span, event.event_errors[0]);
@@ -119,7 +131,11 @@ class OtelTracingMiddleware {
     this.handler_contexts.set(handlerSpanKey(event_result.event_id, event_result.handler_id), span_context);
     return span;
   }
-  completeHandlerSpan(event_result) {
+  completeHandlerSpan(eventbus, event, event_result) {
+    if (this.span_factory) {
+      this.completeHandlerSpanWithFactory(eventbus, event, event_result);
+      return;
+    }
     const span = this.handler_spans.get(event_result.id);
     if (!span) {
       return;
@@ -186,10 +202,167 @@ class OtelTracingMiddleware {
     }
     return event.event_parent_id ? this.event_contexts.get(event.event_parent_id) : void 0;
   }
+  completeEventSpanWithFactory(eventbus, event) {
+    const root_event = rootEventForEvent(eventbus, event);
+    const trace_id = traceIdForRootEvent(root_event.event_id);
+    const event_context = eventSpanContext(trace_id, event.event_id);
+    const start_time = dateFromIso(event.event_started_at);
+    const end_time = endTimeAfterStart(start_time, dateFromIso(event.event_completed_at));
+    if (!event.event_parent_id) {
+      const root_span = this.span_factory({
+        name: resolveRootSpanName(this.root_span_name, eventbus, event),
+        span_context: rootSpanContext(trace_id, event.event_id),
+        attributes: rootSpanAttributes(this.root_span_attributes, eventbus, event),
+        start_time
+      });
+      root_span.setStatus({ code: SpanStatusCode.OK });
+      root_span.end(end_time);
+    }
+    const span = this.span_factory({
+      name: `abxbus.event ${event.event_type}`,
+      span_context: event_context,
+      parent_span_context: parentSpanContextForEvent(event, trace_id),
+      attributes: eventSpanAttributes(eventbus, event),
+      start_time
+    });
+    if (event.event_errors.length > 0) {
+      recordSpanError(span, event.event_errors[0]);
+    } else {
+      span.setStatus({ code: SpanStatusCode.OK });
+    }
+    span.end(end_time);
+  }
+  completeHandlerSpanWithFactory(eventbus, event, event_result) {
+    const root_event = rootEventForEvent(eventbus, event);
+    const trace_id = traceIdForRootEvent(root_event.event_id);
+    const start_time = dateFromIso(event_result.started_at);
+    const span = this.span_factory({
+      name: `abxbus.handler ${event.event_type} ${event_result.handler_name}`,
+      span_context: handlerSpanContext(trace_id, event_result.event_id, event_result.handler_id),
+      parent_span_context: eventSpanContext(trace_id, event.event_id),
+      attributes: handlerSpanAttributes(eventbus, event, event_result),
+      start_time
+    });
+    if (event_result.error !== void 0) {
+      recordSpanError(span, event_result.error);
+    } else {
+      span.setStatus({ code: SpanStatusCode.OK });
+    }
+    span.end(endTimeAfterStart(start_time, dateFromIso(event_result.completed_at)));
+  }
 }
 function handlerSpanKey(event_id, handler_id) {
   return `${event_id}:${handler_id}`;
 }
+function eventSpanAttributes(eventbus, event) {
+  return compactAttributes({
+    "abxbus.bus.id": eventbus.id,
+    "abxbus.bus.name": eventbus.name,
+    "abxbus.event.id": event.event_id,
+    "abxbus.event.type": event.event_type,
+    "abxbus.event.version": event.event_version,
+    "abxbus.event.session_id": stringValue(event.session_id),
+    "abxbus.event.parent_id": event.event_parent_id,
+    "abxbus.event.emitted_by_handler_id": event.event_emitted_by_handler_id,
+    "abxbus.event.path": event.event_path.join(" "),
+    "abxbus.event.status": event.event_status,
+    "abxbus.event.result_count": event.event_results.size,
+    "abxbus.event.error_count": event.event_errors.length,
+    "abxbus.event.child_count": event.event_children.length
+  });
+}
+function handlerSpanAttributes(eventbus, event, event_result) {
+  return compactAttributes({
+    "abxbus.bus.id": eventbus.id,
+    "abxbus.bus.name": eventbus.name,
+    "abxbus.event.id": event.event_id,
+    "abxbus.event.type": event.event_type,
+    "abxbus.handler.id": event_result.handler_id,
+    "abxbus.handler.name": event_result.handler_name,
+    "abxbus.handler.file_path": event_result.handler_file_path,
+    "abxbus.handler.event_pattern": event_result.handler.event_pattern,
+    "abxbus.event_result.id": event_result.id,
+    "abxbus.event_result.status": event_result.status,
+    "abxbus.handler.child_count": event_result.event_children.length
+  });
+}
+function rootSpanAttributes(root_span_attributes, eventbus, event) {
+  const session_id = stringValue(event.session_id);
+  return compactAttributes({
+    ...resolveAttributes(root_span_attributes, eventbus, event),
+    "abxbus.trace.root": true,
+    "abxbus.bus.id": eventbus.id,
+    "abxbus.bus.name": eventbus.name,
+    "abxbus.root_event.id": event.event_id,
+    "abxbus.root_event.type": event.event_type,
+    "abxbus.root_event.session_id": session_id,
+    "abxbus.root_event.status": event.event_status,
+    "abxbus.root_event.error_count": event.event_errors.length,
+    "abxbus.root_event.child_count": event.event_children.length
+  });
+}
+function rootEventForEvent(eventbus, event) {
+  let current = event._event_original ?? event;
+  const seen = /* @__PURE__ */ new Set();
+  while (current.event_parent_id && !seen.has(current.event_id)) {
+    seen.add(current.event_id);
+    const parent = eventbus.findEventById(current.event_parent_id);
+    if (!parent) {
+      break;
+    }
+    current = parent._event_original ?? parent;
+  }
+  return current;
+}
+function parentSpanContextForEvent(event, trace_id) {
+  if (!event.event_parent_id) {
+    return rootSpanContext(trace_id, event.event_id);
+  }
+  if (event.event_emitted_by_handler_id) {
+    return handlerSpanContext(trace_id, event.event_parent_id, event.event_emitted_by_handler_id);
+  }
+  return eventSpanContext(trace_id, event.event_parent_id);
+}
+function rootSpanContext(trace_id, event_id) {
+  return {
+    traceId: trace_id,
+    spanId: deterministicSpanId(`abxbus.root:${event_id}`),
+    traceFlags: 1
+  };
+}
+function eventSpanContext(trace_id, event_id) {
+  return {
+    traceId: trace_id,
+    spanId: deterministicSpanId(`abxbus.event:${event_id}`),
+    traceFlags: 1
+  };
+}
+function handlerSpanContext(trace_id, event_id, handler_id) {
+  return {
+    traceId: trace_id,
+    spanId: deterministicSpanId(`abxbus.handler:${event_id}:${handler_id}`),
+    traceFlags: 1
+  };
+}
+function traceIdForRootEvent(event_id) {
+  return `${fnv1a64Hex(`abxbus.trace.a:${event_id}`)}${fnv1a64Hex(`abxbus.trace.b:${event_id}`)}`;
+}
+function deterministicSpanId(input) {
+  return fnv1a64Hex(input);
+}
+function fnv1a64Hex(input) {
+  let hash = 0xcbf29ce484222325n;
+  const prime = 0x100000001b3n;
+  const mask = 0xffffffffffffffffn;
+  for (let index = 0; index < input.length; index += 1) {
+    hash ^= BigInt(input.charCodeAt(index));
+    hash = hash * prime & mask;
+  }
+  if (hash === 0n) {
+    hash = 1n;
+  }
+  return hash.toString(16).padStart(16, "0");
+}
 function dateFromIso(value) {
   if (value == null) {
     return void 0;

package/dist/esm/middleware_otel_tracing.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/middleware_otel_tracing.ts"],
-  "sourcesContent": ["import {\n  ROOT_CONTEXT,\n  SpanStatusCode,\n  trace,\n  type Context,\n  type Span,\n  type SpanAttributeValue,\n  type SpanAttributes,\n  type Tracer,\n} from '@opentelemetry/api'\n\nimport type { BaseEvent } from './base_event.js'\nimport type { EventBus } from './event_bus.js'\nimport type { EventResult } from './event_result.js'\nimport type { EventBusMiddleware } from './middlewares.js'\nimport type { EventStatus } from './types.js'\n\ntype OpenTelemetryTraceApi = Pick<typeof trace, 'getTracer' | 'setSpan'>\n\nexport type OtelTracingMiddlewareOptions = {\n  tracer?: Tracer\n  trace_api?: OpenTelemetryTraceApi\n  root_span_name?: string | ((eventbus: EventBus, event: BaseEvent) => string)\n  root_span_attributes?: SpanAttributes | ((eventbus: EventBus, event: BaseEvent) => SpanAttributes)\n}\n\nexport class OtelTracingMiddleware implements EventBusMiddleware {\n  private readonly tracer: Tracer\n  private readonly trace_api: OpenTelemetryTraceApi\n  private readonly root_span_name: OtelTracingMiddlewareOptions['root_span_name']\n  private readonly root_span_attributes: OtelTracingMiddlewareOptions['root_span_attributes']\n  private readonly root_spans = new Map<string, Span>()\n  private readonly root_contexts = new Map<string, Context>()\n  private readonly event_spans = new Map<string, Span>()\n  private readonly event_contexts = new Map<string, Context>()\n  private readonly handler_spans = new Map<string, Span>()\n  private readonly handler_contexts = new Map<string, Context>()\n\n  constructor(options: OtelTracingMiddlewareOptions = {}) {\n    this.trace_api = options.trace_api ?? trace\n    this.tracer = options.tracer ?? this.trace_api.getTracer('abxbus')\n    this.root_span_name = options.root_span_name\n    this.root_span_attributes = options.root_span_attributes\n  }\n\n  onEventChange(eventbus: EventBus, event: BaseEvent, status: EventStatus): void {\n    if (status === 'started') {\n      this.startEventSpan(eventbus, event)\n      return\n    }\n\n    if (status === 'completed') {\n      this.completeEventSpan(eventbus, event)\n    }\n  }\n\n  onEventResultChange(eventbus: EventBus, event: BaseEvent, event_result: EventResult, status: EventStatus): void {\n    if (status === 'started') {\n      this.startHandlerSpan(eventbus, event, event_result)\n      return\n    }\n\n    if (status === 'completed') {\n      this.completeHandlerSpan(event_result)\n    }\n  }\n\n  private startEventSpan(eventbus: EventBus, event: BaseEvent): Span {\n    const existing = this.event_spans.get(event.event_id)\n    if (existing) {\n      return existing\n    }\n\n    const parent_context = this.parentContextForEvent(event) ?? this.startRootSpan(eventbus, event)\n    const start_time = dateFromIso(event.event_started_at)\n    const span = this.tracer.startSpan(\n      `abxbus.event ${event.event_type}`,\n      {\n        attributes: compactAttributes({\n          'abxbus.bus.id': eventbus.id,\n          'abxbus.bus.name': eventbus.name,\n          'abxbus.event.id': event.event_id,\n          'abxbus.event.type': event.event_type,\n          'abxbus.event.version': event.event_version,\n          'abxbus.event.session_id': stringValue((event as { session_id?: unknown }).session_id),\n          'abxbus.event.parent_id': event.event_parent_id,\n          'abxbus.event.emitted_by_handler_id': event.event_emitted_by_handler_id,\n          'abxbus.event.path': event.event_path.join(' '),\n        }),\n        startTime: start_time,\n      },\n      parent_context\n    )\n    const span_context = this.trace_api.setSpan(parent_context, span)\n    this.event_spans.set(event.event_id, span)\n    this.event_contexts.set(event.event_id, span_context)\n    return span\n  }\n\n  private completeEventSpan(eventbus: EventBus, event: BaseEvent): void {\n    const span = this.event_spans.get(event.event_id) ?? this.startEventSpan(eventbus, event)\n    if (event.event_errors.length > 0) {\n      recordSpanError(span, event.event_errors[0])\n    } else {\n      span.setStatus({ code: SpanStatusCode.OK })\n    }\n    span.setAttributes(\n      compactAttributes({\n        'abxbus.event.status': event.event_status,\n        'abxbus.event.result_count': event.event_results.size,\n        'abxbus.event.error_count': event.event_errors.length,\n        'abxbus.event.child_count': event.event_children.length,\n      })\n    )\n    const start_time = dateFromIso(event.event_started_at)\n    const end_time = endTimeAfterStart(start_time, dateFromIso(event.event_completed_at))\n    span.end(end_time)\n    this.event_spans.delete(event.event_id)\n    this.event_contexts.delete(event.event_id)\n    this.completeRootSpan(event.event_id, start_time, end_time)\n  }\n\n  private startHandlerSpan(eventbus: EventBus, event: BaseEvent, event_result: EventResult): Span {\n    const existing = this.handler_spans.get(event_result.id)\n    if (existing) {\n      return existing\n    }\n\n    const parent_context =\n      this.event_contexts.get(event.event_id) ?? this.trace_api.setSpan(ROOT_CONTEXT, this.startEventSpan(eventbus, event))\n    const span = this.tracer.startSpan(\n      `abxbus.handler ${event.event_type} ${event_result.handler_name}`,\n      {\n        attributes: compactAttributes({\n          'abxbus.bus.id': eventbus.id,\n          'abxbus.bus.name': eventbus.name,\n          'abxbus.event.id': event.event_id,\n          'abxbus.event.type': event.event_type,\n          'abxbus.handler.id': event_result.handler_id,\n          'abxbus.handler.name': event_result.handler_name,\n          'abxbus.handler.file_path': event_result.handler_file_path,\n          'abxbus.handler.event_pattern': event_result.handler.event_pattern,\n          'abxbus.event_result.id': event_result.id,\n        }),\n        startTime: dateFromIso(event_result.started_at),\n      },\n      parent_context\n    )\n    const span_context = this.trace_api.setSpan(parent_context, span)\n    this.handler_spans.set(event_result.id, span)\n    this.handler_contexts.set(handlerSpanKey(event_result.event_id, event_result.handler_id), span_context)\n    return span\n  }\n\n  private completeHandlerSpan(event_result: EventResult): void {\n    const span = this.handler_spans.get(event_result.id)\n    if (!span) {\n      return\n    }\n\n    if (event_result.error !== undefined) {\n      recordSpanError(span, event_result.error)\n    } else {\n      span.setStatus({ code: SpanStatusCode.OK })\n    }\n    span.setAttributes(\n      compactAttributes({\n        'abxbus.event_result.status': event_result.status,\n        'abxbus.handler.child_count': event_result.event_children.length,\n      })\n    )\n    span.end(endTimeAfterStart(dateFromIso(event_result.started_at), dateFromIso(event_result.completed_at)))\n    this.handler_spans.delete(event_result.id)\n    this.handler_contexts.delete(handlerSpanKey(event_result.event_id, event_result.handler_id))\n  }\n\n  private startRootSpan(eventbus: EventBus, event: BaseEvent): Context {\n    const existing = this.root_contexts.get(event.event_id)\n    if (existing) {\n      return existing\n    }\n\n    const session_id = stringValue((event as { session_id?: unknown }).session_id)\n    const root_attributes = resolveAttributes(this.root_span_attributes, eventbus, event)\n    const root_span = this.tracer.startSpan(\n      resolveRootSpanName(this.root_span_name, eventbus, event),\n      {\n        attributes: compactAttributes({\n          ...root_attributes,\n          'abxbus.trace.root': true,\n          'abxbus.bus.id': eventbus.id,\n          'abxbus.bus.name': eventbus.name,\n          'abxbus.root_event.id': event.event_id,\n          'abxbus.root_event.type': event.event_type,\n          'abxbus.root_event.session_id': session_id,\n        }),\n        startTime: dateFromIso(event.event_started_at),\n      },\n      ROOT_CONTEXT\n    )\n    const root_context = this.trace_api.setSpan(ROOT_CONTEXT, root_span)\n    this.root_spans.set(event.event_id, root_span)\n    this.root_contexts.set(event.event_id, root_context)\n    return root_context\n  }\n\n  private completeRootSpan(event_id: string, start_time: Date | undefined, end_time: Date | undefined): void {\n    const root_span = this.root_spans.get(event_id)\n    if (!root_span) {\n      return\n    }\n\n    root_span.setStatus({ code: SpanStatusCode.OK })\n    root_span.end(endTimeAfterStart(start_time, end_time))\n    this.root_spans.delete(event_id)\n    this.root_contexts.delete(event_id)\n  }\n\n  private parentContextForEvent(event: BaseEvent): Context | undefined {\n    if (event.event_parent_id && event.event_emitted_by_handler_id) {\n      const handler_context = this.handler_contexts.get(handlerSpanKey(event.event_parent_id, event.event_emitted_by_handler_id))\n      if (handler_context) {\n        return handler_context\n      }\n    }\n\n    return event.event_parent_id ? this.event_contexts.get(event.event_parent_id) : undefined\n  }\n}\n\nfunction handlerSpanKey(event_id: string, handler_id: string): string {\n  return `${event_id}:${handler_id}`\n}\n\nfunction dateFromIso(value: string | null | undefined): Date | undefined {\n  if (value == null) {\n    return undefined\n  }\n  const date = new Date(value)\n  return Number.isNaN(date.getTime()) ? undefined : date\n}\n\nfunction endTimeAfterStart(start_time: Date | undefined, end_time: Date | undefined): Date | undefined {\n  if (!start_time || !end_time) {\n    return end_time\n  }\n\n  return end_time.getTime() > start_time.getTime() ? end_time : new Date(start_time.getTime() + 1)\n}\n\nfunction resolveRootSpanName(\n  root_span_name: OtelTracingMiddlewareOptions['root_span_name'],\n  eventbus: EventBus,\n  event: BaseEvent\n): string {\n  if (typeof root_span_name === 'function') {\n    return root_span_name(eventbus, event)\n  }\n  return root_span_name ?? `abxbus.trace ${eventbus.name}`\n}\n\nfunction resolveAttributes(\n  attributes: OtelTracingMiddlewareOptions['root_span_attributes'],\n  eventbus: EventBus,\n  event: BaseEvent\n): SpanAttributes {\n  return typeof attributes === 'function' ? attributes(eventbus, event) : (attributes ?? {})\n}\n\nfunction stringValue(value: unknown): string | undefined {\n  return typeof value === 'string' && value.length > 0 ? value : undefined\n}\n\nfunction compactAttributes(attributes: Record<string, SpanAttributeValue | null | undefined>): SpanAttributes {\n  const compacted: SpanAttributes = {}\n  for (const [key, value] of Object.entries(attributes)) {\n    if (value !== null && value !== undefined) {\n      compacted[key] = value\n    }\n  }\n  return compacted\n}\n\nfunction recordSpanError(span: Span, error: unknown): void {\n  if (error instanceof Error) {\n    span.recordException(error)\n    span.setStatus({ code: SpanStatusCode.ERROR, message: error.message })\n    return\n  }\n\n  const message = typeof error === 'string' ? error : 'Unknown abxbus handler error'\n  span.recordException(message)\n  span.setStatus({ code: SpanStatusCode.ERROR, message })\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {\n  ROOT_CONTEXT,\n  SpanStatusCode,\n  trace,\n  type Context,\n  type Span,\n  type SpanAttributeValue,\n  type SpanAttributes,\n  type SpanContext,\n  type Tracer,\n} from '@opentelemetry/api'\n\nimport type { BaseEvent } from './base_event.js'\nimport type { EventBus } from './event_bus.js'\nimport type { EventResult } from './event_result.js'\nimport type { EventBusMiddleware } from './middlewares.js'\nimport type { EventStatus } from './types.js'\n\ntype OpenTelemetryTraceApi = Pick<typeof trace, 'getTracer' | 'setSpan'>\n\nexport type OtelTracingSpanFactoryInput = {\n  name: string\n  span_context: SpanContext\n  parent_span_context?: SpanContext\n  attributes: SpanAttributes\n  start_time?: Date\n}\n\nexport type OtelTracingSpanFactory = (input: OtelTracingSpanFactoryInput) => Span\n\nexport type OtelTracingMiddlewareOptions = {\n  tracer?: Tracer\n  trace_api?: OpenTelemetryTraceApi\n  span_factory?: OtelTracingSpanFactory\n  root_span_name?: string | ((eventbus: EventBus, event: BaseEvent) => string)\n  root_span_attributes?: SpanAttributes | ((eventbus: EventBus, event: BaseEvent) => SpanAttributes)\n}\n\nexport class OtelTracingMiddleware implements EventBusMiddleware {\n  private readonly tracer: Tracer\n  private readonly trace_api: OpenTelemetryTraceApi\n  private readonly span_factory?: OtelTracingSpanFactory\n  private readonly root_span_name: OtelTracingMiddlewareOptions['root_span_name']\n  private readonly root_span_attributes: OtelTracingMiddlewareOptions['root_span_attributes']\n  private readonly root_spans = new Map<string, Span>()\n  private readonly root_contexts = new Map<string, Context>()\n  private readonly event_spans = new Map<string, Span>()\n  private readonly event_contexts = new Map<string, Context>()\n  private readonly handler_spans = new Map<string, Span>()\n  private readonly handler_contexts = new Map<string, Context>()\n\n  constructor(options: OtelTracingMiddlewareOptions = {}) {\n    this.trace_api = options.trace_api ?? trace\n    this.tracer = options.tracer ?? this.trace_api.getTracer('abxbus')\n    this.span_factory = options.span_factory\n    this.root_span_name = options.root_span_name\n    this.root_span_attributes = options.root_span_attributes\n  }\n\n  onEventChange(eventbus: EventBus, event: BaseEvent, status: EventStatus): void {\n    if (status === 'started') {\n      if (this.span_factory) {\n        return\n      }\n      this.startEventSpan(eventbus, event)\n      return\n    }\n\n    if (status === 'completed') {\n      this.completeEventSpan(eventbus, event)\n    }\n  }\n\n  onEventResultChange(eventbus: EventBus, event: BaseEvent, event_result: EventResult, status: EventStatus): void {\n    if (status === 'started') {\n      if (this.span_factory) {\n        return\n      }\n      this.startHandlerSpan(eventbus, event, event_result)\n      return\n    }\n\n    if (status === 'completed') {\n      this.completeHandlerSpan(eventbus, event, event_result)\n    }\n  }\n\n  private startEventSpan(eventbus: EventBus, event: BaseEvent): Span {\n    const existing = this.event_spans.get(event.event_id)\n    if (existing) {\n      return existing\n    }\n\n    const parent_context = this.parentContextForEvent(event) ?? this.startRootSpan(eventbus, event)\n    const start_time = dateFromIso(event.event_started_at)\n    const span = this.tracer.startSpan(\n      `abxbus.event ${event.event_type}`,\n      {\n        attributes: compactAttributes({\n          'abxbus.bus.id': eventbus.id,\n          'abxbus.bus.name': eventbus.name,\n          'abxbus.event.id': event.event_id,\n          'abxbus.event.type': event.event_type,\n          'abxbus.event.version': event.event_version,\n          'abxbus.event.session_id': stringValue((event as { session_id?: unknown }).session_id),\n          'abxbus.event.parent_id': event.event_parent_id,\n          'abxbus.event.emitted_by_handler_id': event.event_emitted_by_handler_id,\n          'abxbus.event.path': event.event_path.join(' '),\n        }),\n        startTime: start_time,\n      },\n      parent_context\n    )\n    const span_context = this.trace_api.setSpan(parent_context, span)\n    this.event_spans.set(event.event_id, span)\n    this.event_contexts.set(event.event_id, span_context)\n    return span\n  }\n\n  private completeEventSpan(eventbus: EventBus, event: BaseEvent): void {\n    if (this.span_factory) {\n      this.completeEventSpanWithFactory(eventbus, event)\n      return\n    }\n\n    const span = this.event_spans.get(event.event_id) ?? this.startEventSpan(eventbus, event)\n    if (event.event_errors.length > 0) {\n      recordSpanError(span, event.event_errors[0])\n    } else {\n      span.setStatus({ code: SpanStatusCode.OK })\n    }\n    span.setAttributes(\n      compactAttributes({\n        'abxbus.event.status': event.event_status,\n        'abxbus.event.result_count': event.event_results.size,\n        'abxbus.event.error_count': event.event_errors.length,\n        'abxbus.event.child_count': event.event_children.length,\n      })\n    )\n    const start_time = dateFromIso(event.event_started_at)\n    const end_time = endTimeAfterStart(start_time, dateFromIso(event.event_completed_at))\n    span.end(end_time)\n    this.event_spans.delete(event.event_id)\n    this.event_contexts.delete(event.event_id)\n    this.completeRootSpan(event.event_id, start_time, end_time)\n  }\n\n  private startHandlerSpan(eventbus: EventBus, event: BaseEvent, event_result: EventResult): Span {\n    const existing = this.handler_spans.get(event_result.id)\n    if (existing) {\n      return existing\n    }\n\n    const parent_context =\n      this.event_contexts.get(event.event_id) ?? this.trace_api.setSpan(ROOT_CONTEXT, this.startEventSpan(eventbus, event))\n    const span = this.tracer.startSpan(\n      `abxbus.handler ${event.event_type} ${event_result.handler_name}`,\n      {\n        attributes: compactAttributes({\n          'abxbus.bus.id': eventbus.id,\n          'abxbus.bus.name': eventbus.name,\n          'abxbus.event.id': event.event_id,\n          'abxbus.event.type': event.event_type,\n          'abxbus.handler.id': event_result.handler_id,\n          'abxbus.handler.name': event_result.handler_name,\n          'abxbus.handler.file_path': event_result.handler_file_path,\n          'abxbus.handler.event_pattern': event_result.handler.event_pattern,\n          'abxbus.event_result.id': event_result.id,\n        }),\n        startTime: dateFromIso(event_result.started_at),\n      },\n      parent_context\n    )\n    const span_context = this.trace_api.setSpan(parent_context, span)\n    this.handler_spans.set(event_result.id, span)\n    this.handler_contexts.set(handlerSpanKey(event_result.event_id, event_result.handler_id), span_context)\n    return span\n  }\n\n  private completeHandlerSpan(eventbus: EventBus, event: BaseEvent, event_result: EventResult): void {\n    if (this.span_factory) {\n      this.completeHandlerSpanWithFactory(eventbus, event, event_result)\n      return\n    }\n\n    const span = this.handler_spans.get(event_result.id)\n    if (!span) {\n      return\n    }\n\n    if (event_result.error !== undefined) {\n      recordSpanError(span, event_result.error)\n    } else {\n      span.setStatus({ code: SpanStatusCode.OK })\n    }\n    span.setAttributes(\n      compactAttributes({\n        'abxbus.event_result.status': event_result.status,\n        'abxbus.handler.child_count': event_result.event_children.length,\n      })\n    )\n    span.end(endTimeAfterStart(dateFromIso(event_result.started_at), dateFromIso(event_result.completed_at)))\n    this.handler_spans.delete(event_result.id)\n    this.handler_contexts.delete(handlerSpanKey(event_result.event_id, event_result.handler_id))\n  }\n\n  private startRootSpan(eventbus: EventBus, event: BaseEvent): Context {\n    const existing = this.root_contexts.get(event.event_id)\n    if (existing) {\n      return existing\n    }\n\n    const session_id = stringValue((event as { session_id?: unknown }).session_id)\n    const root_attributes = resolveAttributes(this.root_span_attributes, eventbus, event)\n    const root_span = this.tracer.startSpan(\n      resolveRootSpanName(this.root_span_name, eventbus, event),\n      {\n        attributes: compactAttributes({\n          ...root_attributes,\n          'abxbus.trace.root': true,\n          'abxbus.bus.id': eventbus.id,\n          'abxbus.bus.name': eventbus.name,\n          'abxbus.root_event.id': event.event_id,\n          'abxbus.root_event.type': event.event_type,\n          'abxbus.root_event.session_id': session_id,\n        }),\n        startTime: dateFromIso(event.event_started_at),\n      },\n      ROOT_CONTEXT\n    )\n    const root_context = this.trace_api.setSpan(ROOT_CONTEXT, root_span)\n    this.root_spans.set(event.event_id, root_span)\n    this.root_contexts.set(event.event_id, root_context)\n    return root_context\n  }\n\n  private completeRootSpan(event_id: string, start_time: Date | undefined, end_time: Date | undefined): void {\n    const root_span = this.root_spans.get(event_id)\n    if (!root_span) {\n      return\n    }\n\n    root_span.setStatus({ code: SpanStatusCode.OK })\n    root_span.end(endTimeAfterStart(start_time, end_time))\n    this.root_spans.delete(event_id)\n    this.root_contexts.delete(event_id)\n  }\n\n  private parentContextForEvent(event: BaseEvent): Context | undefined {\n    if (event.event_parent_id && event.event_emitted_by_handler_id) {\n      const handler_context = this.handler_contexts.get(handlerSpanKey(event.event_parent_id, event.event_emitted_by_handler_id))\n      if (handler_context) {\n        return handler_context\n      }\n    }\n\n    return event.event_parent_id ? this.event_contexts.get(event.event_parent_id) : undefined\n  }\n\n  private completeEventSpanWithFactory(eventbus: EventBus, event: BaseEvent): void {\n    const root_event = rootEventForEvent(eventbus, event)\n    const trace_id = traceIdForRootEvent(root_event.event_id)\n    const event_context = eventSpanContext(trace_id, event.event_id)\n    const start_time = dateFromIso(event.event_started_at)\n    const end_time = endTimeAfterStart(start_time, dateFromIso(event.event_completed_at))\n\n    if (!event.event_parent_id) {\n      const root_span = this.span_factory!({\n        name: resolveRootSpanName(this.root_span_name, eventbus, event),\n        span_context: rootSpanContext(trace_id, event.event_id),\n        attributes: rootSpanAttributes(this.root_span_attributes, eventbus, event),\n        start_time,\n      })\n      root_span.setStatus({ code: SpanStatusCode.OK })\n      root_span.end(end_time)\n    }\n\n    const span = this.span_factory!({\n      name: `abxbus.event ${event.event_type}`,\n      span_context: event_context,\n      parent_span_context: parentSpanContextForEvent(event, trace_id),\n      attributes: eventSpanAttributes(eventbus, event),\n      start_time,\n    })\n    if (event.event_errors.length > 0) {\n      recordSpanError(span, event.event_errors[0])\n    } else {\n      span.setStatus({ code: SpanStatusCode.OK })\n    }\n    span.end(end_time)\n  }\n\n  private completeHandlerSpanWithFactory(eventbus: EventBus, event: BaseEvent, event_result: EventResult): void {\n    const root_event = rootEventForEvent(eventbus, event)\n    const trace_id = traceIdForRootEvent(root_event.event_id)\n    const start_time = dateFromIso(event_result.started_at)\n    const span = this.span_factory!({\n      name: `abxbus.handler ${event.event_type} ${event_result.handler_name}`,\n      span_context: handlerSpanContext(trace_id, event_result.event_id, event_result.handler_id),\n      parent_span_context: eventSpanContext(trace_id, event.event_id),\n      attributes: handlerSpanAttributes(eventbus, event, event_result),\n      start_time,\n    })\n\n    if (event_result.error !== undefined) {\n      recordSpanError(span, event_result.error)\n    } else {\n      span.setStatus({ code: SpanStatusCode.OK })\n    }\n    span.end(endTimeAfterStart(start_time, dateFromIso(event_result.completed_at)))\n  }\n}\n\nfunction handlerSpanKey(event_id: string, handler_id: string): string {\n  return `${event_id}:${handler_id}`\n}\n\nfunction eventSpanAttributes(eventbus: EventBus, event: BaseEvent): SpanAttributes {\n  return compactAttributes({\n    'abxbus.bus.id': eventbus.id,\n    'abxbus.bus.name': eventbus.name,\n    'abxbus.event.id': event.event_id,\n    'abxbus.event.type': event.event_type,\n    'abxbus.event.version': event.event_version,\n    'abxbus.event.session_id': stringValue((event as { session_id?: unknown }).session_id),\n    'abxbus.event.parent_id': event.event_parent_id,\n    'abxbus.event.emitted_by_handler_id': event.event_emitted_by_handler_id,\n    'abxbus.event.path': event.event_path.join(' '),\n    'abxbus.event.status': event.event_status,\n    'abxbus.event.result_count': event.event_results.size,\n    'abxbus.event.error_count': event.event_errors.length,\n    'abxbus.event.child_count': event.event_children.length,\n  })\n}\n\nfunction handlerSpanAttributes(eventbus: EventBus, event: BaseEvent, event_result: EventResult): SpanAttributes {\n  return compactAttributes({\n    'abxbus.bus.id': eventbus.id,\n    'abxbus.bus.name': eventbus.name,\n    'abxbus.event.id': event.event_id,\n    'abxbus.event.type': event.event_type,\n    'abxbus.handler.id': event_result.handler_id,\n    'abxbus.handler.name': event_result.handler_name,\n    'abxbus.handler.file_path': event_result.handler_file_path,\n    'abxbus.handler.event_pattern': event_result.handler.event_pattern,\n    'abxbus.event_result.id': event_result.id,\n    'abxbus.event_result.status': event_result.status,\n    'abxbus.handler.child_count': event_result.event_children.length,\n  })\n}\n\nfunction rootSpanAttributes(\n  root_span_attributes: OtelTracingMiddlewareOptions['root_span_attributes'],\n  eventbus: EventBus,\n  event: BaseEvent\n): SpanAttributes {\n  const session_id = stringValue((event as { session_id?: unknown }).session_id)\n  return compactAttributes({\n    ...resolveAttributes(root_span_attributes, eventbus, event),\n    'abxbus.trace.root': true,\n    'abxbus.bus.id': eventbus.id,\n    'abxbus.bus.name': eventbus.name,\n    'abxbus.root_event.id': event.event_id,\n    'abxbus.root_event.type': event.event_type,\n    'abxbus.root_event.session_id': session_id,\n    'abxbus.root_event.status': event.event_status,\n    'abxbus.root_event.error_count': event.event_errors.length,\n    'abxbus.root_event.child_count': event.event_children.length,\n  })\n}\n\nfunction rootEventForEvent(eventbus: EventBus, event: BaseEvent): BaseEvent {\n  let current = event._event_original ?? event\n  const seen = new Set<string>()\n  while (current.event_parent_id && !seen.has(current.event_id)) {\n    seen.add(current.event_id)\n    const parent = eventbus.findEventById(current.event_parent_id)\n    if (!parent) {\n      break\n    }\n    current = parent._event_original ?? parent\n  }\n  return current\n}\n\nfunction parentSpanContextForEvent(event: BaseEvent, trace_id: string): SpanContext {\n  if (!event.event_parent_id) {\n    return rootSpanContext(trace_id, event.event_id)\n  }\n\n  if (event.event_emitted_by_handler_id) {\n    return handlerSpanContext(trace_id, event.event_parent_id, event.event_emitted_by_handler_id)\n  }\n\n  return eventSpanContext(trace_id, event.event_parent_id)\n}\n\nfunction rootSpanContext(trace_id: string, event_id: string): SpanContext {\n  return {\n    traceId: trace_id,\n    spanId: deterministicSpanId(`abxbus.root:${event_id}`),\n    traceFlags: 1,\n  }\n}\n\nfunction eventSpanContext(trace_id: string, event_id: string): SpanContext {\n  return {\n    traceId: trace_id,\n    spanId: deterministicSpanId(`abxbus.event:${event_id}`),\n    traceFlags: 1,\n  }\n}\n\nfunction handlerSpanContext(trace_id: string, event_id: string, handler_id: string): SpanContext {\n  return {\n    traceId: trace_id,\n    spanId: deterministicSpanId(`abxbus.handler:${event_id}:${handler_id}`),\n    traceFlags: 1,\n  }\n}\n\nfunction traceIdForRootEvent(event_id: string): string {\n  return `${fnv1a64Hex(`abxbus.trace.a:${event_id}`)}${fnv1a64Hex(`abxbus.trace.b:${event_id}`)}`\n}\n\nfunction deterministicSpanId(input: string): string {\n  return fnv1a64Hex(input)\n}\n\nfunction fnv1a64Hex(input: string): string {\n  let hash = 0xcbf29ce484222325n\n  const prime = 0x100000001b3n\n  const mask = 0xffffffffffffffffn\n  for (let index = 0; index < input.length; index += 1) {\n    hash ^= BigInt(input.charCodeAt(index))\n    hash = (hash * prime) & mask\n  }\n  if (hash === 0n) {\n    hash = 1n\n  }\n  return hash.toString(16).padStart(16, '0')\n}\n\nfunction dateFromIso(value: string | null | undefined): Date | undefined {\n  if (value == null) {\n    return undefined\n  }\n  const date = new Date(value)\n  return Number.isNaN(date.getTime()) ? undefined : date\n}\n\nfunction endTimeAfterStart(start_time: Date | undefined, end_time: Date | undefined): Date | undefined {\n  if (!start_time || !end_time) {\n    return end_time\n  }\n\n  return end_time.getTime() > start_time.getTime() ? end_time : new Date(start_time.getTime() + 1)\n}\n\nfunction resolveRootSpanName(root_span_name: OtelTracingMiddlewareOptions['root_span_name'], eventbus: EventBus, event: BaseEvent): string {\n  if (typeof root_span_name === 'function') {\n    return root_span_name(eventbus, event)\n  }\n  return root_span_name ?? `abxbus.trace ${eventbus.name}`\n}\n\nfunction resolveAttributes(\n  attributes: OtelTracingMiddlewareOptions['root_span_attributes'],\n  eventbus: EventBus,\n  event: BaseEvent\n): SpanAttributes {\n  return typeof attributes === 'function' ? attributes(eventbus, event) : (attributes ?? {})\n}\n\nfunction stringValue(value: unknown): string | undefined {\n  return typeof value === 'string' && value.length > 0 ? value : undefined\n}\n\nfunction compactAttributes(attributes: Record<string, SpanAttributeValue | null | undefined>): SpanAttributes {\n  const compacted: SpanAttributes = {}\n  for (const [key, value] of Object.entries(attributes)) {\n    if (value !== null && value !== undefined) {\n      compacted[key] = value\n    }\n  }\n  return compacted\n}\n\nfunction recordSpanError(span: Span, error: unknown): void {\n  if (error instanceof Error) {\n    span.recordException(error)\n    span.setStatus({ code: SpanStatusCode.ERROR, message: error.message })\n    return\n  }\n\n  const message = typeof error === 'string' ? error : 'Unknown abxbus handler error'\n  span.recordException(message)\n  span.setStatus({ code: SpanStatusCode.ERROR, message })\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/types/index.d.ts

@@ -8,6 +8,7 @@ export { monotonicDatetime } from './helpers.js';
 export type { EventBusMiddleware, EventBusMiddlewareCtor, EventBusMiddlewareInput } from './middlewares.js';
 export { OtelTracingMiddleware } from './middleware_otel_tracing.js';
 export type { OtelTracingMiddlewareOptions } from './middleware_otel_tracing.js';
+export type { OtelTracingSpanFactory, OtelTracingSpanFactoryInput } from './middleware_otel_tracing.js';
 export { EventHandlerTimeoutError, EventHandlerCancelledError, EventHandlerAbortedError, EventHandlerResultSchemaError, } from './event_handler.js';
 export type { EventConcurrencyMode, EventHandlerConcurrencyMode, EventHandlerCompletionMode, EventBusInterfaceForLockManager, } from './lock_manager.js';
 export type { EventClass, EventHandlerCallable as EventHandler, EventPattern, EventStatus, FindOptions, FindWindow } from './types.js';

package/dist/types/middleware_otel_tracing.d.ts

@@ -1,19 +1,29 @@
-import { trace, type SpanAttributes, type Tracer } from '@opentelemetry/api';
+import { trace, type Span, type SpanAttributes, type SpanContext, type Tracer } from '@opentelemetry/api';
 import type { BaseEvent } from './base_event.js';
 import type { EventBus } from './event_bus.js';
 import type { EventResult } from './event_result.js';
 import type { EventBusMiddleware } from './middlewares.js';
 import type { EventStatus } from './types.js';
 type OpenTelemetryTraceApi = Pick<typeof trace, 'getTracer' | 'setSpan'>;
+export type OtelTracingSpanFactoryInput = {
+    name: string;
+    span_context: SpanContext;
+    parent_span_context?: SpanContext;
+    attributes: SpanAttributes;
+    start_time?: Date;
+};
+export type OtelTracingSpanFactory = (input: OtelTracingSpanFactoryInput) => Span;
 export type OtelTracingMiddlewareOptions = {
     tracer?: Tracer;
     trace_api?: OpenTelemetryTraceApi;
+    span_factory?: OtelTracingSpanFactory;
     root_span_name?: string | ((eventbus: EventBus, event: BaseEvent) => string);
     root_span_attributes?: SpanAttributes | ((eventbus: EventBus, event: BaseEvent) => SpanAttributes);
 };
 export declare class OtelTracingMiddleware implements EventBusMiddleware {
     private readonly tracer;
     private readonly trace_api;
+    private readonly span_factory?;
     private readonly root_span_name;
     private readonly root_span_attributes;
     private readonly root_spans;
@@ -32,5 +42,7 @@ export declare class OtelTracingMiddleware implements EventBusMiddleware {
     private startRootSpan;
     private completeRootSpan;
     private parentContextForEvent;
+    private completeEventSpanWithFactory;
+    private completeHandlerSpanWithFactory;
 }
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "abxbus",
-  "version": "2.4.19",
+  "version": "2.4.20",
   "description": "Event bus library for browsers and ESM Node.js",
   "type": "module",
   "sideEffects": false,

package/src/index.ts

@@ -8,6 +8,7 @@ export { monotonicDatetime } from './helpers.js'
 export type { EventBusMiddleware, EventBusMiddlewareCtor, EventBusMiddlewareInput } from './middlewares.js'
 export { OtelTracingMiddleware } from './middleware_otel_tracing.js'
 export type { OtelTracingMiddlewareOptions } from './middleware_otel_tracing.js'
+export type { OtelTracingSpanFactory, OtelTracingSpanFactoryInput } from './middleware_otel_tracing.js'
 export {
   EventHandlerTimeoutError,
   EventHandlerCancelledError,

package/src/middleware_otel_tracing.ts

@@ -6,6 +6,7 @@ import {
   type Span,
   type SpanAttributeValue,
   type SpanAttributes,
+  type SpanContext,
   type Tracer,
 } from '@opentelemetry/api'
 
@@ -17,9 +18,20 @@ import type { EventStatus } from './types.js'
 
 type OpenTelemetryTraceApi = Pick<typeof trace, 'getTracer' | 'setSpan'>
 
+export type OtelTracingSpanFactoryInput = {
+  name: string
+  span_context: SpanContext
+  parent_span_context?: SpanContext
+  attributes: SpanAttributes
+  start_time?: Date
+}
+
+export type OtelTracingSpanFactory = (input: OtelTracingSpanFactoryInput) => Span
+
 export type OtelTracingMiddlewareOptions = {
   tracer?: Tracer
   trace_api?: OpenTelemetryTraceApi
+  span_factory?: OtelTracingSpanFactory
   root_span_name?: string | ((eventbus: EventBus, event: BaseEvent) => string)
   root_span_attributes?: SpanAttributes | ((eventbus: EventBus, event: BaseEvent) => SpanAttributes)
 }
@@ -27,6 +39,7 @@ export type OtelTracingMiddlewareOptions = {
 export class OtelTracingMiddleware implements EventBusMiddleware {
   private readonly tracer: Tracer
   private readonly trace_api: OpenTelemetryTraceApi
+  private readonly span_factory?: OtelTracingSpanFactory
   private readonly root_span_name: OtelTracingMiddlewareOptions['root_span_name']
   private readonly root_span_attributes: OtelTracingMiddlewareOptions['root_span_attributes']
   private readonly root_spans = new Map<string, Span>()
@@ -39,12 +52,16 @@ export class OtelTracingMiddleware implements EventBusMiddleware {
   constructor(options: OtelTracingMiddlewareOptions = {}) {
     this.trace_api = options.trace_api ?? trace
     this.tracer = options.tracer ?? this.trace_api.getTracer('abxbus')
+    this.span_factory = options.span_factory
     this.root_span_name = options.root_span_name
     this.root_span_attributes = options.root_span_attributes
   }
 
   onEventChange(eventbus: EventBus, event: BaseEvent, status: EventStatus): void {
     if (status === 'started') {
+      if (this.span_factory) {
+        return
+      }
       this.startEventSpan(eventbus, event)
       return
     }
@@ -56,12 +73,15 @@ export class OtelTracingMiddleware implements EventBusMiddleware {
 
   onEventResultChange(eventbus: EventBus, event: BaseEvent, event_result: EventResult, status: EventStatus): void {
     if (status === 'started') {
+      if (this.span_factory) {
+        return
+      }
       this.startHandlerSpan(eventbus, event, event_result)
       return
     }
 
     if (status === 'completed') {
-      this.completeHandlerSpan(event_result)
+      this.completeHandlerSpan(eventbus, event, event_result)
     }
   }
 
@@ -98,6 +118,11 @@ export class OtelTracingMiddleware implements EventBusMiddleware {
   }
 
   private completeEventSpan(eventbus: EventBus, event: BaseEvent): void {
+    if (this.span_factory) {
+      this.completeEventSpanWithFactory(eventbus, event)
+      return
+    }
+
     const span = this.event_spans.get(event.event_id) ?? this.startEventSpan(eventbus, event)
     if (event.event_errors.length > 0) {
       recordSpanError(span, event.event_errors[0])
@@ -152,7 +177,12 @@ export class OtelTracingMiddleware implements EventBusMiddleware {
     return span
   }
 
-  private completeHandlerSpan(event_result: EventResult): void {
+  private completeHandlerSpan(eventbus: EventBus, event: BaseEvent, event_result: EventResult): void {
+    if (this.span_factory) {
+      this.completeHandlerSpanWithFactory(eventbus, event, event_result)
+      return
+    }
+
     const span = this.handler_spans.get(event_result.id)
     if (!span) {
       return
@@ -226,12 +256,191 @@ export class OtelTracingMiddleware implements EventBusMiddleware {
 
     return event.event_parent_id ? this.event_contexts.get(event.event_parent_id) : undefined
   }
+
+  private completeEventSpanWithFactory(eventbus: EventBus, event: BaseEvent): void {
+    const root_event = rootEventForEvent(eventbus, event)
+    const trace_id = traceIdForRootEvent(root_event.event_id)
+    const event_context = eventSpanContext(trace_id, event.event_id)
+    const start_time = dateFromIso(event.event_started_at)
+    const end_time = endTimeAfterStart(start_time, dateFromIso(event.event_completed_at))
+
+    if (!event.event_parent_id) {
+      const root_span = this.span_factory!({
+        name: resolveRootSpanName(this.root_span_name, eventbus, event),
+        span_context: rootSpanContext(trace_id, event.event_id),
+        attributes: rootSpanAttributes(this.root_span_attributes, eventbus, event),
+        start_time,
+      })
+      root_span.setStatus({ code: SpanStatusCode.OK })
+      root_span.end(end_time)
+    }
+
+    const span = this.span_factory!({
+      name: `abxbus.event ${event.event_type}`,
+      span_context: event_context,
+      parent_span_context: parentSpanContextForEvent(event, trace_id),
+      attributes: eventSpanAttributes(eventbus, event),
+      start_time,
+    })
+    if (event.event_errors.length > 0) {
+      recordSpanError(span, event.event_errors[0])
+    } else {
+      span.setStatus({ code: SpanStatusCode.OK })
+    }
+    span.end(end_time)
+  }
+
+  private completeHandlerSpanWithFactory(eventbus: EventBus, event: BaseEvent, event_result: EventResult): void {
+    const root_event = rootEventForEvent(eventbus, event)
+    const trace_id = traceIdForRootEvent(root_event.event_id)
+    const start_time = dateFromIso(event_result.started_at)
+    const span = this.span_factory!({
+      name: `abxbus.handler ${event.event_type} ${event_result.handler_name}`,
+      span_context: handlerSpanContext(trace_id, event_result.event_id, event_result.handler_id),
+      parent_span_context: eventSpanContext(trace_id, event.event_id),
+      attributes: handlerSpanAttributes(eventbus, event, event_result),
+      start_time,
+    })
+
+    if (event_result.error !== undefined) {
+      recordSpanError(span, event_result.error)
+    } else {
+      span.setStatus({ code: SpanStatusCode.OK })
+    }
+    span.end(endTimeAfterStart(start_time, dateFromIso(event_result.completed_at)))
+  }
 }
 
 function handlerSpanKey(event_id: string, handler_id: string): string {
   return `${event_id}:${handler_id}`
 }
 
+function eventSpanAttributes(eventbus: EventBus, event: BaseEvent): SpanAttributes {
+  return compactAttributes({
+    'abxbus.bus.id': eventbus.id,
+    'abxbus.bus.name': eventbus.name,
+    'abxbus.event.id': event.event_id,
+    'abxbus.event.type': event.event_type,
+    'abxbus.event.version': event.event_version,
+    'abxbus.event.session_id': stringValue((event as { session_id?: unknown }).session_id),
+    'abxbus.event.parent_id': event.event_parent_id,
+    'abxbus.event.emitted_by_handler_id': event.event_emitted_by_handler_id,
+    'abxbus.event.path': event.event_path.join(' '),
+    'abxbus.event.status': event.event_status,
+    'abxbus.event.result_count': event.event_results.size,
+    'abxbus.event.error_count': event.event_errors.length,
+    'abxbus.event.child_count': event.event_children.length,
+  })
+}
+
+function handlerSpanAttributes(eventbus: EventBus, event: BaseEvent, event_result: EventResult): SpanAttributes {
+  return compactAttributes({
+    'abxbus.bus.id': eventbus.id,
+    'abxbus.bus.name': eventbus.name,
+    'abxbus.event.id': event.event_id,
+    'abxbus.event.type': event.event_type,
+    'abxbus.handler.id': event_result.handler_id,
+    'abxbus.handler.name': event_result.handler_name,
+    'abxbus.handler.file_path': event_result.handler_file_path,
+    'abxbus.handler.event_pattern': event_result.handler.event_pattern,
+    'abxbus.event_result.id': event_result.id,
+    'abxbus.event_result.status': event_result.status,
+    'abxbus.handler.child_count': event_result.event_children.length,
+  })
+}
+
+function rootSpanAttributes(
+  root_span_attributes: OtelTracingMiddlewareOptions['root_span_attributes'],
+  eventbus: EventBus,
+  event: BaseEvent
+): SpanAttributes {
+  const session_id = stringValue((event as { session_id?: unknown }).session_id)
+  return compactAttributes({
+    ...resolveAttributes(root_span_attributes, eventbus, event),
+    'abxbus.trace.root': true,
+    'abxbus.bus.id': eventbus.id,
+    'abxbus.bus.name': eventbus.name,
+    'abxbus.root_event.id': event.event_id,
+    'abxbus.root_event.type': event.event_type,
+    'abxbus.root_event.session_id': session_id,
+    'abxbus.root_event.status': event.event_status,
+    'abxbus.root_event.error_count': event.event_errors.length,
+    'abxbus.root_event.child_count': event.event_children.length,
+  })
+}
+
+function rootEventForEvent(eventbus: EventBus, event: BaseEvent): BaseEvent {
+  let current = event._event_original ?? event
+  const seen = new Set<string>()
+  while (current.event_parent_id && !seen.has(current.event_id)) {
+    seen.add(current.event_id)
+    const parent = eventbus.findEventById(current.event_parent_id)
+    if (!parent) {
+      break
+    }
+    current = parent._event_original ?? parent
+  }
+  return current
+}
+
+function parentSpanContextForEvent(event: BaseEvent, trace_id: string): SpanContext {
+  if (!event.event_parent_id) {
+    return rootSpanContext(trace_id, event.event_id)
+  }
+
+  if (event.event_emitted_by_handler_id) {
+    return handlerSpanContext(trace_id, event.event_parent_id, event.event_emitted_by_handler_id)
+  }
+
+  return eventSpanContext(trace_id, event.event_parent_id)
+}
+
+function rootSpanContext(trace_id: string, event_id: string): SpanContext {
+  return {
+    traceId: trace_id,
+    spanId: deterministicSpanId(`abxbus.root:${event_id}`),
+    traceFlags: 1,
+  }
+}
+
+function eventSpanContext(trace_id: string, event_id: string): SpanContext {
+  return {
+    traceId: trace_id,
+    spanId: deterministicSpanId(`abxbus.event:${event_id}`),
+    traceFlags: 1,
+  }
+}
+
+function handlerSpanContext(trace_id: string, event_id: string, handler_id: string): SpanContext {
+  return {
+    traceId: trace_id,
+    spanId: deterministicSpanId(`abxbus.handler:${event_id}:${handler_id}`),
+    traceFlags: 1,
+  }
+}
+
+function traceIdForRootEvent(event_id: string): string {
+  return `${fnv1a64Hex(`abxbus.trace.a:${event_id}`)}${fnv1a64Hex(`abxbus.trace.b:${event_id}`)}`
+}
+
+function deterministicSpanId(input: string): string {
+  return fnv1a64Hex(input)
+}
+
+function fnv1a64Hex(input: string): string {
+  let hash = 0xcbf29ce484222325n
+  const prime = 0x100000001b3n
+  const mask = 0xffffffffffffffffn
+  for (let index = 0; index < input.length; index += 1) {
+    hash ^= BigInt(input.charCodeAt(index))
+    hash = (hash * prime) & mask
+  }
+  if (hash === 0n) {
+    hash = 1n
+  }
+  return hash.toString(16).padStart(16, '0')
+}
+
 function dateFromIso(value: string | null | undefined): Date | undefined {
   if (value == null) {
     return undefined