abxbus 2.4.15 → 2.4.16

package/dist/cjs/index.d.ts

@@ -6,6 +6,8 @@ export { EventBus } from './event_bus.js';
 export type { EventBusJSON, EventBusOptions } from './event_bus.js';
 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 { 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

@@ -30,6 +30,7 @@ __export(index_exports, {
   HTTPEventBridge: () => import_bridges.HTTPEventBridge,
   JSONLEventBridge: () => import_bridges.JSONLEventBridge,
   NATSEventBridge: () => import_bridges.NATSEventBridge,
+  OtelTracingMiddleware: () => import_middleware_otel_tracing.OtelTracingMiddleware,
   PostgresEventBridge: () => import_bridges.PostgresEventBridge,
   RedisEventBridge: () => import_bridges.RedisEventBridge,
   RetryTimeoutError: () => import_retry.RetryTimeoutError,
@@ -47,6 +48,7 @@ var import_event_history = require("./event_history.js");
 var import_event_result = require("./event_result.js");
 var import_event_bus = require("./event_bus.js");
 var import_helpers = require("./helpers.js");
+var import_middleware_otel_tracing = require("./middleware_otel_tracing.js");
 var import_event_handler = require("./event_handler.js");
 var import_retry = require("./retry.js");
 var import_bridges = require("./bridges.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 {\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,wBAA2C;AAC3C,2BAA6B;AAE7B,0BAA4B;AAC5B,uBAAyB;AAEzB,qBAAkC;AAElC,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 {\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;",
   "names": []
 }

package/dist/cjs/middleware_otel_tracing.d.ts

@@ -0,0 +1,28 @@
+import { trace, 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 OtelTracingMiddlewareOptions = {
+    tracer?: Tracer;
+    trace_api?: OpenTelemetryTraceApi;
+};
+export declare class OtelTracingMiddleware implements EventBusMiddleware {
+    private readonly tracer;
+    private readonly trace_api;
+    private readonly event_spans;
+    private readonly event_contexts;
+    private readonly handler_spans;
+    private readonly handler_contexts;
+    constructor(options?: OtelTracingMiddlewareOptions);
+    onEventChange(eventbus: EventBus, event: BaseEvent, status: EventStatus): void;
+    onEventResultChange(eventbus: EventBus, event: BaseEvent, event_result: EventResult, status: EventStatus): void;
+    private startEventSpan;
+    private completeEventSpan;
+    private startHandlerSpan;
+    private completeHandlerSpan;
+    private parentContextForEvent;
+}
+export {};

package/dist/cjs/middleware_otel_tracing.js

@@ -0,0 +1,189 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var middleware_otel_tracing_exports = {};
+__export(middleware_otel_tracing_exports, {
+  OtelTracingMiddleware: () => OtelTracingMiddleware
+});
+module.exports = __toCommonJS(middleware_otel_tracing_exports);
+var import_api = require("@opentelemetry/api");
+class OtelTracingMiddleware {
+  tracer;
+  trace_api;
+  event_spans = /* @__PURE__ */ new Map();
+  event_contexts = /* @__PURE__ */ new Map();
+  handler_spans = /* @__PURE__ */ new Map();
+  handler_contexts = /* @__PURE__ */ new Map();
+  constructor(options = {}) {
+    this.trace_api = options.trace_api ?? import_api.trace;
+    this.tracer = options.tracer ?? this.trace_api.getTracer("abxbus");
+  }
+  onEventChange(eventbus, event, status) {
+    if (status === "started") {
+      this.startEventSpan(eventbus, event);
+      return;
+    }
+    if (status === "completed") {
+      this.completeEventSpan(eventbus, event);
+    }
+  }
+  onEventResultChange(eventbus, event, event_result, status) {
+    if (status === "started") {
+      this.startHandlerSpan(eventbus, event, event_result);
+      return;
+    }
+    if (status === "completed") {
+      this.completeHandlerSpan(event_result);
+    }
+  }
+  startEventSpan(eventbus, event) {
+    const existing = this.event_spans.get(event.event_id);
+    if (existing) {
+      return existing;
+    }
+    const parent_context = this.parentContextForEvent(event);
+    const span = this.tracer.startSpan(
+      `abxbus.event ${event.event_type}`,
+      {
+        attributes: 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.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(" ")
+        }),
+        startTime: dateFromIso(event.event_started_at)
+      },
+      parent_context
+    );
+    const span_context = this.trace_api.setSpan(parent_context ?? import_api.context.active(), span);
+    this.event_spans.set(event.event_id, span);
+    this.event_contexts.set(event.event_id, span_context);
+    return span;
+  }
+  completeEventSpan(eventbus, event) {
+    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]);
+    } else {
+      span.setStatus({ code: import_api.SpanStatusCode.OK });
+    }
+    span.setAttributes(
+      compactAttributes({
+        "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
+      })
+    );
+    span.end(dateFromIso(event.event_completed_at));
+    this.event_spans.delete(event.event_id);
+    this.event_contexts.delete(event.event_id);
+  }
+  startHandlerSpan(eventbus, event, event_result) {
+    const existing = this.handler_spans.get(event_result.id);
+    if (existing) {
+      return existing;
+    }
+    const parent_context = this.event_contexts.get(event.event_id) ?? this.trace_api.setSpan(import_api.context.active(), this.startEventSpan(eventbus, event));
+    const span = this.tracer.startSpan(
+      `abxbus.handler ${event.event_type} ${event_result.handler_name}`,
+      {
+        attributes: 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
+        }),
+        startTime: dateFromIso(event_result.started_at)
+      },
+      parent_context
+    );
+    const span_context = this.trace_api.setSpan(parent_context, span);
+    this.handler_spans.set(event_result.id, span);
+    this.handler_contexts.set(handlerSpanKey(event_result.event_id, event_result.handler_id), span_context);
+    return span;
+  }
+  completeHandlerSpan(event_result) {
+    const span = this.handler_spans.get(event_result.id);
+    if (!span) {
+      return;
+    }
+    if (event_result.error !== void 0) {
+      recordSpanError(span, event_result.error);
+    } else {
+      span.setStatus({ code: import_api.SpanStatusCode.OK });
+    }
+    span.setAttributes(
+      compactAttributes({
+        "abxbus.event_result.status": event_result.status,
+        "abxbus.handler.child_count": event_result.event_children.length
+      })
+    );
+    span.end(dateFromIso(event_result.completed_at));
+    this.handler_spans.delete(event_result.id);
+    this.handler_contexts.delete(handlerSpanKey(event_result.event_id, event_result.handler_id));
+  }
+  parentContextForEvent(event) {
+    if (event.event_parent_id && event.event_emitted_by_handler_id) {
+      const handler_context = this.handler_contexts.get(handlerSpanKey(event.event_parent_id, event.event_emitted_by_handler_id));
+      if (handler_context) {
+        return handler_context;
+      }
+    }
+    return event.event_parent_id ? this.event_contexts.get(event.event_parent_id) : void 0;
+  }
+}
+function handlerSpanKey(event_id, handler_id) {
+  return `${event_id}:${handler_id}`;
+}
+function dateFromIso(value) {
+  if (value == null) {
+    return void 0;
+  }
+  const date = new Date(value);
+  return Number.isNaN(date.getTime()) ? void 0 : date;
+}
+function compactAttributes(attributes) {
+  const compacted = {};
+  for (const [key, value] of Object.entries(attributes)) {
+    if (value !== null && value !== void 0) {
+      compacted[key] = value;
+    }
+  }
+  return compacted;
+}
+function recordSpanError(span, error) {
+  if (error instanceof Error) {
+    span.recordException(error);
+    span.setStatus({ code: import_api.SpanStatusCode.ERROR, message: error.message });
+    return;
+  }
+  const message = typeof error === "string" ? error : "Unknown abxbus handler error";
+  span.recordException(message);
+  span.setStatus({ code: import_api.SpanStatusCode.ERROR, message });
+}
+//# sourceMappingURL=middleware_otel_tracing.js.map

package/dist/cjs/middleware_otel_tracing.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/middleware_otel_tracing.ts"],
+  "sourcesContent": ["import { context, SpanStatusCode, trace, type Context, type Span, type Tracer } 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}\n\nexport class OtelTracingMiddleware implements EventBusMiddleware {\n  private readonly tracer: Tracer\n  private readonly trace_api: OpenTelemetryTraceApi\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  }\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)\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.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: dateFromIso(event.event_started_at),\n      },\n      parent_context\n    )\n    const span_context = this.trace_api.setSpan(parent_context ?? context.active(), 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    span.end(dateFromIso(event.event_completed_at))\n    this.event_spans.delete(event.event_id)\n    this.event_contexts.delete(event.event_id)\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(context.active(), 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(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 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 compactAttributes(\n  attributes: Record<string, string | number | boolean | null | undefined>\n): Record<string, string | number | boolean> {\n  const compacted: Record<string, string | number | boolean> = {}\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

@@ -3,6 +3,7 @@ import { EventHistory } from "./event_history.js";
 import { EventResult } from "./event_result.js";
 import { EventBus } from "./event_bus.js";
 import { monotonicDatetime } from "./helpers.js";
+import { OtelTracingMiddleware } from "./middleware_otel_tracing.js";
 import {
   EventHandlerTimeoutError,
   EventHandlerCancelledError,
@@ -33,6 +34,7 @@ export {
   HTTPEventBridge,
   JSONLEventBridge,
   NATSEventBridge,
+  OtelTracingMiddleware,
   PostgresEventBridge,
   RedisEventBridge,
   RetryTimeoutError,

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 {\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;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 {\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;",
   "names": []
 }

package/dist/esm/middleware_otel_tracing.js

@@ -0,0 +1,169 @@
+import { context, SpanStatusCode, trace } from "@opentelemetry/api";
+class OtelTracingMiddleware {
+  tracer;
+  trace_api;
+  event_spans = /* @__PURE__ */ new Map();
+  event_contexts = /* @__PURE__ */ new Map();
+  handler_spans = /* @__PURE__ */ new Map();
+  handler_contexts = /* @__PURE__ */ new Map();
+  constructor(options = {}) {
+    this.trace_api = options.trace_api ?? trace;
+    this.tracer = options.tracer ?? this.trace_api.getTracer("abxbus");
+  }
+  onEventChange(eventbus, event, status) {
+    if (status === "started") {
+      this.startEventSpan(eventbus, event);
+      return;
+    }
+    if (status === "completed") {
+      this.completeEventSpan(eventbus, event);
+    }
+  }
+  onEventResultChange(eventbus, event, event_result, status) {
+    if (status === "started") {
+      this.startHandlerSpan(eventbus, event, event_result);
+      return;
+    }
+    if (status === "completed") {
+      this.completeHandlerSpan(event_result);
+    }
+  }
+  startEventSpan(eventbus, event) {
+    const existing = this.event_spans.get(event.event_id);
+    if (existing) {
+      return existing;
+    }
+    const parent_context = this.parentContextForEvent(event);
+    const span = this.tracer.startSpan(
+      `abxbus.event ${event.event_type}`,
+      {
+        attributes: 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.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(" ")
+        }),
+        startTime: dateFromIso(event.event_started_at)
+      },
+      parent_context
+    );
+    const span_context = this.trace_api.setSpan(parent_context ?? context.active(), span);
+    this.event_spans.set(event.event_id, span);
+    this.event_contexts.set(event.event_id, span_context);
+    return span;
+  }
+  completeEventSpan(eventbus, event) {
+    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]);
+    } else {
+      span.setStatus({ code: SpanStatusCode.OK });
+    }
+    span.setAttributes(
+      compactAttributes({
+        "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
+      })
+    );
+    span.end(dateFromIso(event.event_completed_at));
+    this.event_spans.delete(event.event_id);
+    this.event_contexts.delete(event.event_id);
+  }
+  startHandlerSpan(eventbus, event, event_result) {
+    const existing = this.handler_spans.get(event_result.id);
+    if (existing) {
+      return existing;
+    }
+    const parent_context = this.event_contexts.get(event.event_id) ?? this.trace_api.setSpan(context.active(), this.startEventSpan(eventbus, event));
+    const span = this.tracer.startSpan(
+      `abxbus.handler ${event.event_type} ${event_result.handler_name}`,
+      {
+        attributes: 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
+        }),
+        startTime: dateFromIso(event_result.started_at)
+      },
+      parent_context
+    );
+    const span_context = this.trace_api.setSpan(parent_context, span);
+    this.handler_spans.set(event_result.id, span);
+    this.handler_contexts.set(handlerSpanKey(event_result.event_id, event_result.handler_id), span_context);
+    return span;
+  }
+  completeHandlerSpan(event_result) {
+    const span = this.handler_spans.get(event_result.id);
+    if (!span) {
+      return;
+    }
+    if (event_result.error !== void 0) {
+      recordSpanError(span, event_result.error);
+    } else {
+      span.setStatus({ code: SpanStatusCode.OK });
+    }
+    span.setAttributes(
+      compactAttributes({
+        "abxbus.event_result.status": event_result.status,
+        "abxbus.handler.child_count": event_result.event_children.length
+      })
+    );
+    span.end(dateFromIso(event_result.completed_at));
+    this.handler_spans.delete(event_result.id);
+    this.handler_contexts.delete(handlerSpanKey(event_result.event_id, event_result.handler_id));
+  }
+  parentContextForEvent(event) {
+    if (event.event_parent_id && event.event_emitted_by_handler_id) {
+      const handler_context = this.handler_contexts.get(handlerSpanKey(event.event_parent_id, event.event_emitted_by_handler_id));
+      if (handler_context) {
+        return handler_context;
+      }
+    }
+    return event.event_parent_id ? this.event_contexts.get(event.event_parent_id) : void 0;
+  }
+}
+function handlerSpanKey(event_id, handler_id) {
+  return `${event_id}:${handler_id}`;
+}
+function dateFromIso(value) {
+  if (value == null) {
+    return void 0;
+  }
+  const date = new Date(value);
+  return Number.isNaN(date.getTime()) ? void 0 : date;
+}
+function compactAttributes(attributes) {
+  const compacted = {};
+  for (const [key, value] of Object.entries(attributes)) {
+    if (value !== null && value !== void 0) {
+      compacted[key] = value;
+    }
+  }
+  return compacted;
+}
+function recordSpanError(span, error) {
+  if (error instanceof Error) {
+    span.recordException(error);
+    span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });
+    return;
+  }
+  const message = typeof error === "string" ? error : "Unknown abxbus handler error";
+  span.recordException(message);
+  span.setStatus({ code: SpanStatusCode.ERROR, message });
+}
+export {
+  OtelTracingMiddleware
+};
+//# sourceMappingURL=middleware_otel_tracing.js.map

package/dist/esm/middleware_otel_tracing.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/middleware_otel_tracing.ts"],
+  "sourcesContent": ["import { context, SpanStatusCode, trace, type Context, type Span, type Tracer } 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}\n\nexport class OtelTracingMiddleware implements EventBusMiddleware {\n  private readonly tracer: Tracer\n  private readonly trace_api: OpenTelemetryTraceApi\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  }\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)\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.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: dateFromIso(event.event_started_at),\n      },\n      parent_context\n    )\n    const span_context = this.trace_api.setSpan(parent_context ?? context.active(), 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    span.end(dateFromIso(event.event_completed_at))\n    this.event_spans.delete(event.event_id)\n    this.event_contexts.delete(event.event_id)\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(context.active(), 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(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 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 compactAttributes(\n  attributes: Record<string, string | number | boolean | null | undefined>\n): Record<string, string | number | boolean> {\n  const compacted: Record<string, string | number | boolean> = {}\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

@@ -6,6 +6,8 @@ export { EventBus } from './event_bus.js';
 export type { EventBusJSON, EventBusOptions } from './event_bus.js';
 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 { 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

@@ -0,0 +1,28 @@
+import { trace, 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 OtelTracingMiddlewareOptions = {
+    tracer?: Tracer;
+    trace_api?: OpenTelemetryTraceApi;
+};
+export declare class OtelTracingMiddleware implements EventBusMiddleware {
+    private readonly tracer;
+    private readonly trace_api;
+    private readonly event_spans;
+    private readonly event_contexts;
+    private readonly handler_spans;
+    private readonly handler_contexts;
+    constructor(options?: OtelTracingMiddlewareOptions);
+    onEventChange(eventbus: EventBus, event: BaseEvent, status: EventStatus): void;
+    onEventResultChange(eventbus: EventBus, event: BaseEvent, event_result: EventResult, status: EventStatus): void;
+    private startEventSpan;
+    private completeEventSpan;
+    private startHandlerSpan;
+    private completeHandlerSpan;
+    private parentContextForEvent;
+}
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "abxbus",
-  "version": "2.4.15",
+  "version": "2.4.16",
   "description": "Event bus library for browsers and ESM Node.js",
   "type": "module",
   "sideEffects": false,
@@ -30,6 +30,7 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
+    "@opentelemetry/api": "^1.9.1",
     "uuid": "^13.0.0",
     "zod": "^4.3.6"
   },