@kronos-ts/opentelemetry 0.3.0 → 0.4.0

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { createOpenTelemetrySpanFactory, type OpenTelemetrySpanFactoryOptions, } from "./opentelemetry-span-factory.js";
-export { openTelemetry } from "./opentelemetry.js";
+export { openTelemetry, openTelemetryMetrics } from "./opentelemetry.js";
+export { createOpenTelemetryMetricsRecorder, type OpenTelemetryMetricsRecorderOptions, } from "./opentelemetry-metrics-recorder.js";
 export { createOpenTelemetryDeadLetterListener } from "./opentelemetry-dead-letter-listener.js";
 export { createTracingCommandBus } from "@kronos-ts/messaging";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,KAAK,+BAA+B,GACrC,MAAM,iCAAiC,CAAA;AAExC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAA;AAG/F,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,KAAK,+BAA+B,GACrC,MAAM,iCAAiC,CAAA;AAExC,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAExE,OAAO,EACL,kCAAkC,EAClC,KAAK,mCAAmC,GACzC,MAAM,qCAAqC,CAAA;AAE5C,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAA;AAG/F,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export { createOpenTelemetrySpanFactory, } from "./opentelemetry-span-factory.js";
-export { openTelemetry } from "./opentelemetry.js";
+export { openTelemetry, openTelemetryMetrics } from "./opentelemetry.js";
+export { createOpenTelemetryMetricsRecorder, } from "./opentelemetry-metrics-recorder.js";
 export { createOpenTelemetryDeadLetterListener } from "./opentelemetry-dead-letter-listener.js";
 // Re-export tracing command bus for convenience
 export { createTracingCommandBus } from "@kronos-ts/messaging";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,GAE/B,MAAM,iCAAiC,CAAA;AAExC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAA;AAE/F,gDAAgD;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,GAE/B,MAAM,iCAAiC,CAAA;AAExC,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAExE,OAAO,EACL,kCAAkC,GAEnC,MAAM,qCAAqC,CAAA;AAE5C,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAA;AAE/F,gDAAgD;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/opentelemetry-metrics-recorder.d.ts

@@ -0,0 +1,17 @@
+import { type Meter } from "@opentelemetry/api";
+import type { MetricsRecorder } from "@kronos-ts/messaging";
+export interface OpenTelemetryMetricsRecorderOptions {
+    /** Meter to create instruments from. Defaults to `metrics.getMeter("kronos-framework")`. */
+    meter?: Meter;
+}
+/**
+ * MetricsRecorder implementation backed by the OpenTelemetry Metrics API.
+ *
+ * Instruments are created lazily on the configured Meter; the OTel SDK
+ * deduplicates instruments by name, so repeated `counter`/`histogram` calls for
+ * the same name write to the same series. As with the span factory, you need an
+ * OpenTelemetry MeterProvider configured (e.g. via the OTel SDK or java agent)
+ * for measurements to be exported — otherwise this is effectively a no-op.
+ */
+export declare function createOpenTelemetryMetricsRecorder(options?: OpenTelemetryMetricsRecorderOptions): MetricsRecorder;
+//# sourceMappingURL=opentelemetry-metrics-recorder.d.ts.map

package/dist/opentelemetry-metrics-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opentelemetry-metrics-recorder.d.ts","sourceRoot":"","sources":["../src/opentelemetry-metrics-recorder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,KAAK,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EACV,eAAe,EAIhB,MAAM,sBAAsB,CAAA;AAE7B,MAAM,WAAW,mCAAmC;IAClD,4FAA4F;IAC5F,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED;;;;;;;;GAQG;AACH,wBAAgB,kCAAkC,CAChD,OAAO,GAAE,mCAAwC,GAChD,eAAe,CA2BjB"}

package/dist/opentelemetry-metrics-recorder.js

@@ -0,0 +1,38 @@
+import { metrics } from "@opentelemetry/api";
+/**
+ * MetricsRecorder implementation backed by the OpenTelemetry Metrics API.
+ *
+ * Instruments are created lazily on the configured Meter; the OTel SDK
+ * deduplicates instruments by name, so repeated `counter`/`histogram` calls for
+ * the same name write to the same series. As with the span factory, you need an
+ * OpenTelemetry MeterProvider configured (e.g. via the OTel SDK or java agent)
+ * for measurements to be exported — otherwise this is effectively a no-op.
+ */
+export function createOpenTelemetryMetricsRecorder(options = {}) {
+    const meter = options.meter ?? metrics.getMeter("kronos-framework");
+    return {
+        counter(name, opts) {
+            const instrument = meter.createCounter(name, {
+                description: opts?.description,
+                unit: opts?.unit,
+            });
+            return {
+                add(value, attributes) {
+                    instrument.add(value, attributes);
+                },
+            };
+        },
+        histogram(name, opts) {
+            const instrument = meter.createHistogram(name, {
+                description: opts?.description,
+                unit: opts?.unit,
+            });
+            return {
+                record(value, attributes) {
+                    instrument.record(value, attributes);
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=opentelemetry-metrics-recorder.js.map

package/dist/opentelemetry-metrics-recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opentelemetry-metrics-recorder.js","sourceRoot":"","sources":["../src/opentelemetry-metrics-recorder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAc,MAAM,oBAAoB,CAAA;AAaxD;;;;;;;;GAQG;AACH,MAAM,UAAU,kCAAkC,CAChD,UAA+C,EAAE;IAEjD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAA;IAEnE,OAAO;QACL,OAAO,CAAC,IAAY,EAAE,IAAwB;YAC5C,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE;gBAC3C,WAAW,EAAE,IAAI,EAAE,WAAW;gBAC9B,IAAI,EAAE,IAAI,EAAE,IAAI;aACjB,CAAC,CAAA;YACF,OAAO;gBACL,GAAG,CAAC,KAAK,EAAE,UAAU;oBACnB,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;gBACnC,CAAC;aACF,CAAA;QACH,CAAC;QACD,SAAS,CAAC,IAAY,EAAE,IAAwB;YAC9C,MAAM,UAAU,GAAG,KAAK,CAAC,eAAe,CAAC,IAAI,EAAE;gBAC7C,WAAW,EAAE,IAAI,EAAE,WAAW;gBAC9B,IAAI,EAAE,IAAI,EAAE,IAAI;aACjB,CAAC,CAAA;YACF,OAAO;gBACL,MAAM,CAAC,KAAK,EAAE,UAAU;oBACtB,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;gBACtC,CAAC;aACF,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/opentelemetry.d.ts

@@ -1,5 +1,7 @@
 import type { App } from "@kronos-ts/app";
+import { type MeteringOptions } from "@kronos-ts/messaging";
 import { type OpenTelemetrySpanFactoryOptions } from "./opentelemetry-span-factory.js";
+import { type OpenTelemetryMetricsRecorderOptions } from "./opentelemetry-metrics-recorder.js";
 /**
  * OpenTelemetry tracing extension for Kronos.
  *
@@ -33,4 +35,25 @@ import { type OpenTelemetrySpanFactoryOptions } from "./opentelemetry-span-facto
  * ```
  */
 export declare function openTelemetry(options?: OpenTelemetrySpanFactoryOptions): (app: App) => void;
+/**
+ * OpenTelemetry metrics extension for Kronos.
+ *
+ * Wires a metering handler enhancer (via `app.handlerEnhancer(...)`) that
+ * records throughput, latency, error rate, and event-processing lag for every
+ * command/query/event handler invocation, using the OpenTelemetry Metrics API.
+ *
+ * Compose independently of (and alongside) {@link openTelemetry}:
+ *
+ * @example
+ * ```typescript
+ * await kronos()
+ *   .use(openTelemetry())        // tracing
+ *   .use(openTelemetryMetrics()) // metrics
+ *   .start()
+ * ```
+ *
+ * Requires an OpenTelemetry MeterProvider to be configured for measurements to
+ * be exported; without one this is effectively a no-op.
+ */
+export declare function openTelemetryMetrics(options?: OpenTelemetryMetricsRecorderOptions & MeteringOptions): (app: App) => void;
 //# sourceMappingURL=opentelemetry.d.ts.map

package/dist/opentelemetry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"opentelemetry.d.ts","sourceRoot":"","sources":["../src/opentelemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AAKzC,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,iCAAiC,CAAA;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,aAAa,CAC3B,OAAO,GAAE,+BAAoC,GAC5C,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAQpB"}
+{"version":3,"file":"opentelemetry.d.ts","sourceRoot":"","sources":["../src/opentelemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,iCAAiC,CAAA;AACxC,OAAO,EAEL,KAAK,mCAAmC,EACzC,MAAM,qCAAqC,CAAA;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,aAAa,CAC3B,OAAO,GAAE,+BAAoC,GAC5C,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAQpB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,mCAAmC,GAAG,eAAoB,GAClE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAKpB"}

package/dist/opentelemetry.js

@@ -1,5 +1,6 @@
-import { createTracingCommandBus, tracingHandlerEnhancerDefinition, } from "@kronos-ts/messaging";
+import { createTracingCommandBus, tracingHandlerEnhancerDefinition, meteringHandlerEnhancerDefinition, } from "@kronos-ts/messaging";
 import { createOpenTelemetrySpanFactory, } from "./opentelemetry-span-factory.js";
+import { createOpenTelemetryMetricsRecorder, } from "./opentelemetry-metrics-recorder.js";
 /**
  * OpenTelemetry tracing extension for Kronos.
  *
@@ -39,4 +40,30 @@ export function openTelemetry(options = {}) {
         app.handlerEnhancer(tracingHandlerEnhancerDefinition(spanFactory));
     };
 }
+/**
+ * OpenTelemetry metrics extension for Kronos.
+ *
+ * Wires a metering handler enhancer (via `app.handlerEnhancer(...)`) that
+ * records throughput, latency, error rate, and event-processing lag for every
+ * command/query/event handler invocation, using the OpenTelemetry Metrics API.
+ *
+ * Compose independently of (and alongside) {@link openTelemetry}:
+ *
+ * @example
+ * ```typescript
+ * await kronos()
+ *   .use(openTelemetry())        // tracing
+ *   .use(openTelemetryMetrics()) // metrics
+ *   .start()
+ * ```
+ *
+ * Requires an OpenTelemetry MeterProvider to be configured for measurements to
+ * be exported; without one this is effectively a no-op.
+ */
+export function openTelemetryMetrics(options = {}) {
+    return (app) => {
+        const recorder = createOpenTelemetryMetricsRecorder(options);
+        app.handlerEnhancer(meteringHandlerEnhancerDefinition(recorder, options));
+    };
+}
 //# sourceMappingURL=opentelemetry.js.map

package/dist/opentelemetry.js.map

@@ -1 +1 @@
-{"version":3,"file":"opentelemetry.js","sourceRoot":"","sources":["../src/opentelemetry.ts"],"names":[],"mappings":"AACA,OAAO,EACL,uBAAuB,EACvB,gCAAgC,GACjC,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,8BAA8B,GAE/B,MAAM,iCAAiC,CAAA;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,aAAa,CAC3B,UAA2C,EAAE;IAE7C,OAAO,CAAC,GAAG,EAAE,EAAE;QACb,MAAM,WAAW,GAAG,8BAA8B,CAAC,OAAO,CAAC,CAAA;QAC3D,GAAG,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC,QAAQ,EAAE,EAAE,CACtC,uBAAuB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAC/C,CAAA;QACD,GAAG,CAAC,eAAe,CAAC,gCAAgC,CAAC,WAAW,CAAC,CAAC,CAAA;IACpE,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"opentelemetry.js","sourceRoot":"","sources":["../src/opentelemetry.ts"],"names":[],"mappings":"AACA,OAAO,EACL,uBAAuB,EACvB,gCAAgC,EAChC,iCAAiC,GAElC,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,8BAA8B,GAE/B,MAAM,iCAAiC,CAAA;AACxC,OAAO,EACL,kCAAkC,GAEnC,MAAM,qCAAqC,CAAA;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,aAAa,CAC3B,UAA2C,EAAE;IAE7C,OAAO,CAAC,GAAG,EAAE,EAAE;QACb,MAAM,WAAW,GAAG,8BAA8B,CAAC,OAAO,CAAC,CAAA;QAC3D,GAAG,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC,QAAQ,EAAE,EAAE,CACtC,uBAAuB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAC/C,CAAA;QACD,GAAG,CAAC,eAAe,CAAC,gCAAgC,CAAC,WAAW,CAAC,CAAC,CAAA;IACpE,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAiE,EAAE;IAEnE,OAAO,CAAC,GAAG,EAAE,EAAE;QACb,MAAM,QAAQ,GAAG,kCAAkC,CAAC,OAAO,CAAC,CAAA;QAC5D,GAAG,CAAC,eAAe,CAAC,iCAAiC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAA;IAC3E,CAAC,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kronos-ts/opentelemetry",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "OpenTelemetry extension for Kronos — tracing for commands and events.",
   "license": "Apache-2.0",
   "type": "module",
@@ -50,13 +50,13 @@
   },
   "dependencies": {
     "@kronos-ts/common": "0.1.1",
-    "@kronos-ts/app": "0.4.0",
-    "@kronos-ts/messaging": "0.6.0",
+    "@kronos-ts/app": "0.4.1",
+    "@kronos-ts/messaging": "0.7.0",
     "@opentelemetry/api": "^1.9"
   },
   "devDependencies": {
-    "@kronos-ts/eventsourcing": "0.2.2",
-    "@kronos-ts/modelling": "0.2.5",
+    "@kronos-ts/eventsourcing": "0.2.3",
+    "@kronos-ts/modelling": "0.2.6",
     "@opentelemetry/sdk-trace-base": "^1.30.0",
     "@opentelemetry/sdk-trace-node": "^1.30.0",
     "zod": "^4.3.6"

package/src/index.ts

@@ -3,7 +3,12 @@ export {
   type OpenTelemetrySpanFactoryOptions,
 } from "./opentelemetry-span-factory.js"
 
-export { openTelemetry } from "./opentelemetry.js"
+export { openTelemetry, openTelemetryMetrics } from "./opentelemetry.js"
+
+export {
+  createOpenTelemetryMetricsRecorder,
+  type OpenTelemetryMetricsRecorderOptions,
+} from "./opentelemetry-metrics-recorder.js"
 
 export { createOpenTelemetryDeadLetterListener } from "./opentelemetry-dead-letter-listener.js"
 

package/src/opentelemetry-metrics-recorder.ts

@@ -0,0 +1,52 @@
+import { metrics, type Meter } from "@opentelemetry/api"
+import type {
+  MetricsRecorder,
+  Counter,
+  Histogram,
+  InstrumentOptions,
+} from "@kronos-ts/messaging"
+
+export interface OpenTelemetryMetricsRecorderOptions {
+  /** Meter to create instruments from. Defaults to `metrics.getMeter("kronos-framework")`. */
+  meter?: Meter
+}
+
+/**
+ * MetricsRecorder implementation backed by the OpenTelemetry Metrics API.
+ *
+ * Instruments are created lazily on the configured Meter; the OTel SDK
+ * deduplicates instruments by name, so repeated `counter`/`histogram` calls for
+ * the same name write to the same series. As with the span factory, you need an
+ * OpenTelemetry MeterProvider configured (e.g. via the OTel SDK or java agent)
+ * for measurements to be exported — otherwise this is effectively a no-op.
+ */
+export function createOpenTelemetryMetricsRecorder(
+  options: OpenTelemetryMetricsRecorderOptions = {},
+): MetricsRecorder {
+  const meter = options.meter ?? metrics.getMeter("kronos-framework")
+
+  return {
+    counter(name: string, opts?: InstrumentOptions): Counter {
+      const instrument = meter.createCounter(name, {
+        description: opts?.description,
+        unit: opts?.unit,
+      })
+      return {
+        add(value, attributes) {
+          instrument.add(value, attributes)
+        },
+      }
+    },
+    histogram(name: string, opts?: InstrumentOptions): Histogram {
+      const instrument = meter.createHistogram(name, {
+        description: opts?.description,
+        unit: opts?.unit,
+      })
+      return {
+        record(value, attributes) {
+          instrument.record(value, attributes)
+        },
+      }
+    },
+  }
+}

package/src/opentelemetry.ts

@@ -2,11 +2,17 @@ import type { App } from "@kronos-ts/app"
 import {
   createTracingCommandBus,
   tracingHandlerEnhancerDefinition,
+  meteringHandlerEnhancerDefinition,
+  type MeteringOptions,
 } from "@kronos-ts/messaging"
 import {
   createOpenTelemetrySpanFactory,
   type OpenTelemetrySpanFactoryOptions,
 } from "./opentelemetry-span-factory.js"
+import {
+  createOpenTelemetryMetricsRecorder,
+  type OpenTelemetryMetricsRecorderOptions,
+} from "./opentelemetry-metrics-recorder.js"
 
 /**
  * OpenTelemetry tracing extension for Kronos.
@@ -51,3 +57,32 @@ export function openTelemetry(
     app.handlerEnhancer(tracingHandlerEnhancerDefinition(spanFactory))
   }
 }
+
+/**
+ * OpenTelemetry metrics extension for Kronos.
+ *
+ * Wires a metering handler enhancer (via `app.handlerEnhancer(...)`) that
+ * records throughput, latency, error rate, and event-processing lag for every
+ * command/query/event handler invocation, using the OpenTelemetry Metrics API.
+ *
+ * Compose independently of (and alongside) {@link openTelemetry}:
+ *
+ * @example
+ * ```typescript
+ * await kronos()
+ *   .use(openTelemetry())        // tracing
+ *   .use(openTelemetryMetrics()) // metrics
+ *   .start()
+ * ```
+ *
+ * Requires an OpenTelemetry MeterProvider to be configured for measurements to
+ * be exported; without one this is effectively a no-op.
+ */
+export function openTelemetryMetrics(
+  options: OpenTelemetryMetricsRecorderOptions & MeteringOptions = {},
+): (app: App) => void {
+  return (app) => {
+    const recorder = createOpenTelemetryMetricsRecorder(options)
+    app.handlerEnhancer(meteringHandlerEnhancerDefinition(recorder, options))
+  }
+}