@btravstack/observability 0.11.0 → 0.13.0

package/README.md

@@ -154,8 +154,10 @@ import { UnitSpanModule, otel } from "@btravstack/observability/otel";
 // Configuration is the OTEL_* environment conventions, read by the SDK itself.
 const AppImports = [observability(), otel()];
 
-// A span per kernel unit, correlated with the same ids the logger stamps:
-// runMain(App, { unit: UnitSpanModule })
+// A span per unit, correlated with the same ids the logger stamps — bound on
+// the starter's own `unit` option and forked by the runtime around each
+// request, delivery or activity attempt, e.g.
+// http({ unit: { anonymous: UnitSpanModule } })
 ```
 
 Inbound W3C `traceparent` feeds the unit's trace id in `@btravstack/http-server` and

package/dist/otel.cjs

@@ -112,9 +112,9 @@ const otel = (options) => (0, _btravstack_di.Module)("Otel")({
 /** The span a unit rides, ended when the unit's fork closes. */
 var UnitSpan = class extends (0, _btravstack_di.Port)("UnitSpan") {};
 /**
-* A span per kernel unit, as a `StartOptions.unit` module: the kernel forks it
-* per unit and tears it down inside the unit's ambient record, so the span opens
-* when the unit does and `onStop` ends it on every path out.
+* 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
+* and `onStop` ends it on every path out.
 *
 * The correlation is the ambient record's own, carried as attributes so a span
 * joins the same query the logger's lines answer. The remote PARENT is
@@ -122,7 +122,8 @@ var UnitSpan = class extends (0, _btravstack_di.Port)("UnitSpan") {};
 * id alone, so this correlates by attribute rather than pretending to a W3C
 * parent-child edge it cannot prove.
 *
-* Compose it as `start`'s `unit`; the root must export `Tracer`.
+* Bind it as a starter's `unit` module — `unit: { anonymous: UnitSpanModule }`,
+* `unit: { message: … }`, `unit: { activity: … }`; the root must export `Tracer`.
 */
 const UnitSpanModule = (0, _btravstack_di.Module)("UnitSpan")({
 	needs: [_btravstack_core.Tracer],

package/dist/otel.d.cts

@@ -34,9 +34,9 @@ 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> {}
 /**
- * A span per kernel unit, as a `StartOptions.unit` module: the kernel forks it
- * per unit and tears it down inside the unit's ambient record, so the span opens
- * when the unit does and `onStop` ends it on every path out.
+ * 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
+ * and `onStop` ends it on every path out.
  *
  * The correlation is the ambient record's own, carried as attributes so a span
  * joins the same query the logger's lines answer. The remote PARENT is
@@ -44,7 +44,8 @@ declare class UnitSpan extends UnitSpan_base<Span> {}
  * id alone, so this correlates by attribute rather than pretending to a W3C
  * parent-child edge it cannot prove.
  *
- * Compose it as `start`'s `unit`; the root must export `Tracer`.
+ * 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

package/dist/otel.d.mts

@@ -34,9 +34,9 @@ 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> {}
 /**
- * A span per kernel unit, as a `StartOptions.unit` module: the kernel forks it
- * per unit and tears it down inside the unit's ambient record, so the span opens
- * when the unit does and `onStop` ends it on every path out.
+ * 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
+ * and `onStop` ends it on every path out.
  *
  * The correlation is the ambient record's own, carried as attributes so a span
  * joins the same query the logger's lines answer. The remote PARENT is
@@ -44,7 +44,8 @@ declare class UnitSpan extends UnitSpan_base<Span> {}
  * id alone, so this correlates by attribute rather than pretending to a W3C
  * parent-child edge it cannot prove.
  *
- * Compose it as `start`'s `unit`; the root must export `Tracer`.
+ * 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

package/dist/otel.mjs

@@ -111,9 +111,9 @@ const otel = (options) => Module("Otel")({
 /** The span a unit rides, ended when the unit's fork closes. */
 var UnitSpan = class extends Port("UnitSpan") {};
 /**
-* A span per kernel unit, as a `StartOptions.unit` module: the kernel forks it
-* per unit and tears it down inside the unit's ambient record, so the span opens
-* when the unit does and `onStop` ends it on every path out.
+* 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
+* and `onStop` ends it on every path out.
 *
 * The correlation is the ambient record's own, carried as attributes so a span
 * joins the same query the logger's lines answer. The remote PARENT is
@@ -121,7 +121,8 @@ var UnitSpan = class extends Port("UnitSpan") {};
 * id alone, so this correlates by attribute rather than pretending to a W3C
 * parent-child edge it cannot prove.
 *
-* Compose it as `start`'s `unit`; the root must export `Tracer`.
+* Bind it as a starter's `unit` module — `unit: { anonymous: UnitSpanModule }`,
+* `unit: { message: … }`, `unit: { activity: … }`; the root must export `Tracer`.
 */
 const UnitSpanModule = Module("UnitSpan")({
 	needs: [Tracer],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btravstack/observability",
-  "version": "0.11.0",
+  "version": "0.13.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,7 +65,7 @@
     "./package.json": "./package.json"
   },
   "devDependencies": {
-    "@btravstack/tsconfig": "0.2.0",
+    "@btravstack/tsconfig": "0.4.0",
     "@opentelemetry/api": "1.9.1",
     "@opentelemetry/sdk-node": "0.221.0",
     "@opentelemetry/sdk-trace": "2.10.0",
@@ -77,19 +77,19 @@
     "typescript": "7.0.2",
     "unthrown": "5.7.0",
     "vitest": "4.1.11",
-    "@btravstack/config": "0.11.0",
-    "@btravstack/core": "0.11.0",
-    "@btravstack/di": "0.11.0",
-    "@btravstack/testing": "0.11.0"
+    "@btravstack/config": "0.13.0",
+    "@btravstack/core": "0.13.0",
+    "@btravstack/di": "0.13.0",
+    "@btravstack/testing": "0.13.0"
   },
   "peerDependencies": {
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/sdk-node": "^0.221.0",
     "pino": "^10",
     "unthrown": "^5.0.0",
-    "@btravstack/config": "^0.11.0",
-    "@btravstack/core": "^0.11.0",
-    "@btravstack/di": "^0.11.0"
+    "@btravstack/config": "^0.13.0",
+    "@btravstack/core": "^0.13.0",
+    "@btravstack/di": "^0.13.0"
   },
   "peerDependenciesMeta": {
     "@opentelemetry/api": {