@btravstack/observability 0.13.0 → 0.15.0

package/README.md

@@ -33,7 +33,7 @@ class OrderRepository extends Port("OrderRepository")<{
 > **strict** `Logger` port — no `any`, no printf, no mutable context, no static
 > instance — a default implementation that stamps every line with the ambient
 > unit's trace id, a dependency-free JSON sink, pino behind a subpath, and the
-> kernel's nine lifecycle events as log lines in the same stream.
+> kernel's ten lifecycle events as log lines in the same stream.
 
 📖 **[Documentation](https://btravstack.github.io/btravstack/reference/observability)** ·
 [How-to](https://btravstack.github.io/btravstack/how-to/log-and-correlate) ·

package/dist/index.cjs

@@ -222,6 +222,13 @@ const kernelEvents = (logger) => (event) => {
 				abandoned: event.report.abandoned
 			});
 			return;
+		case "stoppedWaiting":
+			logger.warn("the kernel stopped waiting for a phase with no deadline of its own", {
+				event: event.type,
+				phase: event.phase,
+				...event.afterMs === void 0 ? {} : { afterMs: event.afterMs }
+			});
+			return;
 		default: logger.info(event.type, { event: event.type });
 	}
 };

package/dist/index.d.cts

@@ -13,7 +13,7 @@ import { Module } from "@btravstack/di";
  * `Config.string`, so it inherits the semantics every other variable has: an
  * unset variable takes the default, a set-but-blank one is an error.
  */
-declare const logLevel: (options?: {
+export declare const logLevel: (options?: {
   readonly default?: Level;
 }) => ConfigField<Level>;
 /** What `observability()` binds from the environment. */
@@ -32,7 +32,7 @@ type LoggerSettings = {
  * The unit's ids are spread at the top level rather than nested under `unit`,
  * because `traceId` is the field an operator searches.
  */
-declare const jsonSink: (stream?: {
+export declare const jsonSink: (stream?: {
   readonly write: (chunk: string) => unknown;
 }) => Sink;
 //#endregion
@@ -43,7 +43,7 @@ declare const LoggerConfig_base: import("@btravstack/di").PortClass<"LoggerConfi
  * filters at. A port of its own, like a starter's `HttpConfig`, so anything
  * that wants to know reads it rather than re-deriving it.
  */
-declare class LoggerConfig extends LoggerConfig_base<LoggerSettings> {}
+export declare class LoggerConfig extends LoggerConfig_base<LoggerSettings> {}
 type ObservabilityOptions = {
   /**
    * Where lines go. Default: one JSON object per line on `stdout`. The
@@ -63,7 +63,7 @@ type ObservabilityOptions = {
  * `currentUnit()` per call — so a request's lines are attributable with no
  * argument threaded through the call stack.
  */
-declare const observability: (options?: ObservabilityOptions) => Module<Logger | LoggerConfig | Observers, ConfigInvalid, Env>;
+export declare const observability: (options?: ObservabilityOptions) => Module<Logger | LoggerConfig | Observers, ConfigInvalid, Env>;
 /**
  * The kernel's nine lifecycle events, as log lines on `logger` — the adapter
  * between `StartOptions.onEvent` and an application's own stream.
@@ -76,6 +76,6 @@ declare const observability: (options?: ObservabilityOptions) => Module<Logger |
  * The logger is a PARAMETER, not resolved: `building` is emitted while the graph
  * is still being built, so the sink cannot come from the context it watches.
  */
-declare const kernelEvents: (logger: LoggerService) => EventSink;
+export declare const kernelEvents: (logger: LoggerService) => EventSink;
 //#endregion
-export { type Line, LoggerConfig, type LoggerSettings, type ObservabilityOptions, type Sink, createLogger, jsonSink, kernelEvents, logLevel, observability };
+export { type Line, type LoggerSettings, type ObservabilityOptions, type Sink, createLogger };

package/dist/index.d.mts

@@ -13,7 +13,7 @@ import { Module } from "@btravstack/di";
  * `Config.string`, so it inherits the semantics every other variable has: an
  * unset variable takes the default, a set-but-blank one is an error.
  */
-declare const logLevel: (options?: {
+export declare const logLevel: (options?: {
   readonly default?: Level;
 }) => ConfigField<Level>;
 /** What `observability()` binds from the environment. */
@@ -32,7 +32,7 @@ type LoggerSettings = {
  * The unit's ids are spread at the top level rather than nested under `unit`,
  * because `traceId` is the field an operator searches.
  */
-declare const jsonSink: (stream?: {
+export declare const jsonSink: (stream?: {
   readonly write: (chunk: string) => unknown;
 }) => Sink;
 //#endregion
@@ -43,7 +43,7 @@ declare const LoggerConfig_base: import("@btravstack/di").PortClass<"LoggerConfi
  * filters at. A port of its own, like a starter's `HttpConfig`, so anything
  * that wants to know reads it rather than re-deriving it.
  */
-declare class LoggerConfig extends LoggerConfig_base<LoggerSettings> {}
+export declare class LoggerConfig extends LoggerConfig_base<LoggerSettings> {}
 type ObservabilityOptions = {
   /**
    * Where lines go. Default: one JSON object per line on `stdout`. The
@@ -63,7 +63,7 @@ type ObservabilityOptions = {
  * `currentUnit()` per call — so a request's lines are attributable with no
  * argument threaded through the call stack.
  */
-declare const observability: (options?: ObservabilityOptions) => Module<Logger | LoggerConfig | Observers, ConfigInvalid, Env>;
+export declare const observability: (options?: ObservabilityOptions) => Module<Logger | LoggerConfig | Observers, ConfigInvalid, Env>;
 /**
  * The kernel's nine lifecycle events, as log lines on `logger` — the adapter
  * between `StartOptions.onEvent` and an application's own stream.
@@ -76,6 +76,6 @@ declare const observability: (options?: ObservabilityOptions) => Module<Logger |
  * The logger is a PARAMETER, not resolved: `building` is emitted while the graph
  * is still being built, so the sink cannot come from the context it watches.
  */
-declare const kernelEvents: (logger: LoggerService) => EventSink;
+export declare const kernelEvents: (logger: LoggerService) => EventSink;
 //#endregion
-export { type Line, LoggerConfig, type LoggerSettings, type ObservabilityOptions, type Sink, createLogger, jsonSink, kernelEvents, logLevel, observability };
+export { type Line, type LoggerSettings, type ObservabilityOptions, type Sink, createLogger };

package/dist/index.mjs

@@ -221,6 +221,13 @@ const kernelEvents = (logger) => (event) => {
 				abandoned: event.report.abandoned
 			});
 			return;
+		case "stoppedWaiting":
+			logger.warn("the kernel stopped waiting for a phase with no deadline of its own", {
+				event: event.type,
+				phase: event.phase,
+				...event.afterMs === void 0 ? {} : { afterMs: event.afterMs }
+			});
+			return;
 		default: logger.info(event.type, { event: event.type });
 	}
 };

package/dist/otel.cjs

@@ -93,10 +93,7 @@ const otel = (options) => (0, _btravstack_di.Module)("Otel")({
 		}),
 		(0, _btravstack_di.Provider)(_btravstack_core.Tracer)({
 			inject: { sdk: OtelSdk },
-			sync: () => {
-				const tracer = _opentelemetry_api.trace.getTracer("@btravstack/observability");
-				return { startSpan: (name) => tracer.startSpan(name) };
-			}
+			sync: () => _opentelemetry_api.trace.getTracer("@btravstack/observability")
 		}),
 		(0, _btravstack_di.Provider)(_btravstack_core.Meter)({
 			inject: { sdk: OtelSdk },

package/dist/otel.d.cts

@@ -29,10 +29,10 @@ import { NodeSDKConfiguration } from "@opentelemetry/sdk-node";
  * plan time and in `Needs`. Guice's `newSetBinder` declares the empty set for
  * the same reason.
  */
-declare const otel: (options?: Partial<NodeSDKConfiguration>) => Module<Tracer | Meter | Observers, never, Scope>;
+export declare const otel: (options?: Partial<NodeSDKConfiguration>) => Module<Tracer | Meter | Observers, never, Scope>;
 declare const UnitSpan_base: import("@btravstack/di").PortClass<"UnitSpan">;
 /** The span a unit rides, ended when the unit's fork closes. */
-declare class UnitSpan extends UnitSpan_base<Span> {}
+export declare class UnitSpan extends UnitSpan_base<Span> {}
 /**
  * A span per unit, as a module a starter's own `unit` option binds: the runtime
  * forks it around every unit it opens, so the span opens when the fork is built
@@ -47,6 +47,5 @@ declare class UnitSpan extends UnitSpan_base<Span> {}
  * Bind it as a starter's `unit` module — `unit: { anonymous: UnitSpanModule }`,
  * `unit: { message: … }`, `unit: { activity: … }`; the root must export `Tracer`.
  */
-declare const UnitSpanModule: Module<UnitSpan, never, Scope | Tracer>;
-//#endregion
-export { UnitSpan, UnitSpanModule, otel };
+export declare const UnitSpanModule: Module<UnitSpan, never, Scope | Tracer>;
+//#endregion

package/dist/otel.d.mts

@@ -29,10 +29,10 @@ import { NodeSDKConfiguration } from "@opentelemetry/sdk-node";
  * plan time and in `Needs`. Guice's `newSetBinder` declares the empty set for
  * the same reason.
  */
-declare const otel: (options?: Partial<NodeSDKConfiguration>) => Module<Tracer | Meter | Observers, never, Scope>;
+export declare const otel: (options?: Partial<NodeSDKConfiguration>) => Module<Tracer | Meter | Observers, never, Scope>;
 declare const UnitSpan_base: import("@btravstack/di").PortClass<"UnitSpan">;
 /** The span a unit rides, ended when the unit's fork closes. */
-declare class UnitSpan extends UnitSpan_base<Span> {}
+export declare class UnitSpan extends UnitSpan_base<Span> {}
 /**
  * A span per unit, as a module a starter's own `unit` option binds: the runtime
  * forks it around every unit it opens, so the span opens when the fork is built
@@ -47,6 +47,5 @@ declare class UnitSpan extends UnitSpan_base<Span> {}
  * Bind it as a starter's `unit` module — `unit: { anonymous: UnitSpanModule }`,
  * `unit: { message: … }`, `unit: { activity: … }`; the root must export `Tracer`.
  */
-declare const UnitSpanModule: Module<UnitSpan, never, Scope | Tracer>;
-//#endregion
-export { UnitSpan, UnitSpanModule, otel };
+export declare const UnitSpanModule: Module<UnitSpan, never, Scope | Tracer>;
+//#endregion

package/dist/otel.mjs

@@ -92,10 +92,7 @@ const otel = (options) => Module("Otel")({
 		}),
 		Provider(Tracer)({
 			inject: { sdk: OtelSdk },
-			sync: () => {
-				const tracer = trace.getTracer("@btravstack/observability");
-				return { startSpan: (name) => tracer.startSpan(name) };
-			}
+			sync: () => trace.getTracer("@btravstack/observability")
 		}),
 		Provider(Meter)({
 			inject: { sdk: OtelSdk },

package/dist/pino.d.cts

@@ -22,6 +22,5 @@ import { Logger } from "pino";
  * validated at startup. `fatal` and `trace` map to pino's own; the ambient
  * unit's ids ride as fields, not as a message prefix, so they stay indexable.
  */
-declare const pinoSink: (logger: Logger) => Sink;
-//#endregion
-export { pinoSink };
+export declare const pinoSink: (logger: Logger) => Sink;
+//#endregion

package/dist/pino.d.mts

@@ -22,6 +22,5 @@ import { Logger } from "pino";
  * validated at startup. `fatal` and `trace` map to pino's own; the ambient
  * unit's ids ride as fields, not as a message prefix, so they stay indexable.
  */
-declare const pinoSink: (logger: Logger) => Sink;
-//#endregion
-export { pinoSink };
+export declare const pinoSink: (logger: Logger) => Sink;
+//#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btravstack/observability",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "Observability for @btravstack/core: a strict Logger port correlated with the kernel's units, a dependency-free JSON sink, and the lifecycle events as log lines",
   "keywords": [
     "dependency-injection",
@@ -65,31 +65,31 @@
     "./package.json": "./package.json"
   },
   "devDependencies": {
+    "@btravstack/config": "0.15.0",
+    "@btravstack/core": "0.15.0",
+    "@btravstack/di": "0.15.0",
+    "@btravstack/testing": "0.15.0",
     "@btravstack/tsconfig": "0.4.0",
     "@opentelemetry/api": "1.9.1",
-    "@opentelemetry/sdk-node": "0.221.0",
-    "@opentelemetry/sdk-trace": "2.10.0",
-    "@types/node": "26.4.0",
-    "@unthrown/vitest": "5.7.0",
+    "@opentelemetry/sdk-node": "0.222.0",
+    "@opentelemetry/sdk-trace": "2.11.0",
+    "@types/node": "26.4.1",
+    "@unthrown/vitest": "5.8.0",
     "@vitest/coverage-v8": "4.1.11",
     "pino": "10.3.1",
-    "tsdown": "0.22.14",
+    "tsdown": "0.23.0",
     "typescript": "7.0.2",
-    "unthrown": "5.7.0",
-    "vitest": "4.1.11",
-    "@btravstack/config": "0.13.0",
-    "@btravstack/core": "0.13.0",
-    "@btravstack/di": "0.13.0",
-    "@btravstack/testing": "0.13.0"
+    "unthrown": "5.8.0",
+    "vitest": "4.1.11"
   },
   "peerDependencies": {
+    "@btravstack/config": "^0.15.0",
+    "@btravstack/core": "^0.15.0",
+    "@btravstack/di": "^0.15.0",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/sdk-node": "^0.221.0",
     "pino": "^10",
-    "unthrown": "^5.0.0",
-    "@btravstack/config": "^0.13.0",
-    "@btravstack/core": "^0.13.0",
-    "@btravstack/di": "^0.13.0"
+    "unthrown": "^5.0.0"
   },
   "peerDependenciesMeta": {
     "@opentelemetry/api": {
@@ -107,7 +107,7 @@
   },
   "scripts": {
     "build": "tsdown src/index.ts src/pino.ts src/otel.ts --format cjs,esm --dts --clean",
-    "dev": "tsdown src/index.ts src/pino.ts --format cjs,esm --dts --watch",
+    "dev": "tsdown src/index.ts src/pino.ts src/otel.ts --format cjs,esm --dts --watch",
     "test": "vitest run --coverage",
     "typecheck": "tsc --noEmit"
   }