@semiont/observability 0.5.4 → 0.5.6

package/dist/index.d.ts

@@ -1,3 +1,6 @@
+import { Span, Attributes, SpanKind } from '@opentelemetry/api';
+export { Attributes, Span, SpanKind, SpanStatusCode } from '@opentelemetry/api';
+
 /**
  * @semiont/observability — public API.
  *
@@ -21,13 +24,13 @@
  * tracer is a no-op, so `withSpan` is essentially free until
  * `initObservability*()` runs.
  */
-import { SpanKind, type Attributes, type Span } from '@opentelemetry/api';
+
 /**
  * Wrap an async block in a span. The span is started before `fn` runs and
  * ended after it resolves or rejects; exceptions are recorded and the span
  * status is set to ERROR. `kind` defaults to INTERNAL.
  */
-export declare function withSpan<T>(name: string, fn: (span: Span) => Promise<T> | T, options?: {
+declare function withSpan<T>(name: string, fn: (span: Span) => Promise<T> | T, options?: {
     kind?: SpanKind;
     attrs?: Attributes;
 }): Promise<T>;
@@ -37,7 +40,7 @@ export declare function withSpan<T>(name: string, fn: (span: Span) => Promise<T>
  * the payload to subscribers. Additive — payloads without `_trace` parse
  * unchanged.
  */
-export interface TraceCarrier {
+interface TraceCarrier {
     /** W3C `traceparent` header value (`00-<traceId>-<spanId>-<flags>`). */
     traceparent: string;
     /** W3C `tracestate` header value (vendor-specific extensions). */
@@ -47,24 +50,24 @@ export interface TraceCarrier {
  * Read the active span's W3C traceparent (and tracestate). Returns
  * `undefined` if no span is active.
  */
-export declare function getActiveTraceparent(): TraceCarrier | undefined;
+declare function getActiveTraceparent(): TraceCarrier | undefined;
 /**
  * Attach the active span's trace-context to a payload object as
  * `_trace`. No-op when no span is active. Returns the same object
  * reference for chaining.
  */
-export declare function injectTraceparent<T extends Record<string, unknown>>(payload: T): T;
+declare function injectTraceparent<T extends Record<string, unknown>>(payload: T): T;
 /**
  * Strip and return the `_trace` field from a payload. Mutates `payload`.
  * The field is internal plumbing and should not be visible to subscribers.
  */
-export declare function extractTraceparent<T extends Record<string, unknown>>(payload: T): TraceCarrier | undefined;
+declare function extractTraceparent<T extends Record<string, unknown>>(payload: T): TraceCarrier | undefined;
 /**
  * Run `fn` with the given W3C traceparent set as the parent context.
  * Any spans started inside `fn` will be children of the incoming trace.
  * No-op if `carrier` is undefined.
  */
-export declare function withTraceparent<T>(carrier: TraceCarrier | undefined, fn: () => T): T;
+declare function withTraceparent<T>(carrier: TraceCarrier | undefined, fn: () => T): T;
 /**
  * Wrap a bus-event handler in an `actor.<name>:<channel>` consumer span.
  * Used at every `eventBus.get(channel).subscribe(handler)` site inside
@@ -77,7 +80,7 @@ export declare function withTraceparent<T>(carrier: TraceCarrier | undefined, fn
  * (Subject.next runs synchronously inside the dispatch span), or the
  * `bus.emit:<channel>` span when an actor emits to itself.
  */
-export declare function withActorSpan<T>(actor: string, channel: string, fn: (span: Span) => Promise<T> | T, extraAttrs?: Attributes): Promise<T>;
+declare function withActorSpan<T>(actor: string, channel: string, fn: (span: Span) => Promise<T> | T, extraAttrs?: Attributes): Promise<T>;
 /**
  * Read the active span's `trace_id` / `span_id` for log-line correlation.
  * Tier 3 of `.plans/OBSERVABILITY.md`. Each structured log line gets
@@ -87,12 +90,12 @@ export declare function withActorSpan<T>(actor: string, channel: string, fn: (sp
  * Returns `undefined` if no span is active, or if the active span's
  * context is invalid (uninitialized SDK, no-op tracer).
  */
-export declare function getLogTraceContext(): {
+declare function getLogTraceContext(): {
     trace_id: string;
     span_id: string;
 } | undefined;
 /** Snapshot of job-queue contents by status. Match `JobQueue.getStats()`. */
-export interface JobQueueSnapshot {
+interface JobQueueSnapshot {
     pending: number;
     running: number;
     complete: number;
@@ -100,15 +103,15 @@ export interface JobQueueSnapshot {
     cancelled: number;
 }
 /** Increment the bus-emit counter. Called at every transport `emit` site. */
-export declare function recordBusEmit(channel: string, scope?: string): void;
+declare function recordBusEmit(channel: string, scope?: string): void;
 /** Record an in-process actor handler's duration. */
-export declare function recordHandlerDuration(actor: string, channel: string, durationMs: number): void;
+declare function recordHandlerDuration(actor: string, channel: string, durationMs: number): void;
 /** Record a worker job's outcome and duration. */
-export declare function recordJobOutcome(jobType: string, outcome: 'completed' | 'failed', durationMs: number): void;
+declare function recordJobOutcome(jobType: string, outcome: 'completed' | 'failed', durationMs: number): void;
 /** Increment the SSE subscriber gauge — call on `/bus/subscribe` open. */
-export declare function recordSubscriberConnect(): void;
+declare function recordSubscriberConnect(): void;
 /** Decrement on disconnect. Pair with `recordSubscriberConnect`. */
-export declare function recordSubscriberDisconnect(): void;
+declare function recordSubscriberDisconnect(): void;
 /**
  * Register a callback that returns the current job-queue snapshot.
  * Polled at the SDK's metric-collection interval. The single gauge
@@ -116,19 +119,19 @@ export declare function recordSubscriberDisconnect(): void;
  * with the `job.status` attribute. Idempotent — last registered
  * provider wins.
  */
-export declare function registerJobQueueProvider(provider: () => Promise<JobQueueSnapshot> | JobQueueSnapshot): void;
+declare function registerJobQueueProvider(provider: () => Promise<JobQueueSnapshot> | JobQueueSnapshot): void;
 /**
  * Register a callback that returns the current vector-index size
  * (point count). Async to allow remote queries (Qdrant). Polled at
  * the metric-collection interval.
  */
-export declare function registerVectorIndexSizeProvider(provider: () => Promise<number> | number): void;
+declare function registerVectorIndexSizeProvider(provider: () => Promise<number> | number): void;
 /**
  * Record an inference call. Token counts are optional — providers that
  * don't expose them (or fail before generating) record only call count
  * and duration.
  */
-export declare function recordInferenceUsage(opts: {
+declare function recordInferenceUsage(opts: {
     provider: string;
     model: string;
     durationMs: number;
@@ -136,5 +139,6 @@ export declare function recordInferenceUsage(opts: {
     inputTokens?: number;
     outputTokens?: number;
 }): void;
-export { SpanKind, SpanStatusCode, type Attributes, type Span } from '@opentelemetry/api';
-//# sourceMappingURL=index.d.ts.map
+
+export { extractTraceparent, getActiveTraceparent, getLogTraceContext, injectTraceparent, recordBusEmit, recordHandlerDuration, recordInferenceUsage, recordJobOutcome, recordSubscriberConnect, recordSubscriberDisconnect, registerJobQueueProvider, registerVectorIndexSizeProvider, withActorSpan, withSpan, withTraceparent };
+export type { JobQueueSnapshot, TraceCarrier };

package/dist/node.d.ts

@@ -24,7 +24,7 @@
  * SDKs, forcing npm to nest duplicate copies of the stable packages and
  * blowing up bundles for every consumer.
  */
-export interface NodeObservabilityConfig {
+interface NodeObservabilityConfig {
     /** Service identity (e.g. `semiont-backend`). Overridden by `OTEL_SERVICE_NAME`. */
     serviceName: string;
     /** Service version. Defaults to `0.0.0` if omitted. */
@@ -39,7 +39,9 @@ export interface NodeObservabilityConfig {
  * Metrics export at `OTEL_METRIC_EXPORT_INTERVAL` ms (default 30s) to
  * the same `OTEL_EXPORTER_OTLP_ENDPOINT` as traces.
  */
-export declare function initObservabilityNode(config: NodeObservabilityConfig): boolean;
+declare function initObservabilityNode(config: NodeObservabilityConfig): boolean;
 /** Force-flush + shutdown both SDKs. Test cleanup, not production. */
-export declare function shutdownObservabilityNode(): Promise<void>;
-//# sourceMappingURL=node.d.ts.map
+declare function shutdownObservabilityNode(): Promise<void>;
+
+export { initObservabilityNode, shutdownObservabilityNode };
+export type { NodeObservabilityConfig };

package/dist/process-logger.d.ts

@@ -1,3 +1,5 @@
+import { Logger } from '@semiont/core';
+
 /**
  * Process-level structured logger for Node entry points.
  *
@@ -15,6 +17,7 @@
  * only reasonably-shaped consumer of that helper, and putting them in
  * the same package keeps the trace-id wiring in one place.
  */
-import type { Logger } from '@semiont/core';
-export declare function createProcessLogger(component: string): Logger;
-//# sourceMappingURL=process-logger.d.ts.map
+
+declare function createProcessLogger(component: string): Logger;
+
+export { createProcessLogger };

package/dist/web.d.ts

@@ -10,7 +10,7 @@
  * Without an `otlpEndpoint`, falls back to a console exporter (visible
  * in DevTools).
  */
-export interface WebObservabilityConfig {
+interface WebObservabilityConfig {
     /** Service identity (e.g. `semiont-frontend`). */
     serviceName: string;
     /** Service version. */
@@ -32,5 +32,7 @@ export interface WebObservabilityConfig {
  * Initialize OTel for the SPA. Idempotent. Returns `true` if the SDK
  * started, `false` if disabled or already initialized.
  */
-export declare function initObservabilityWeb(config: WebObservabilityConfig): boolean;
-//# sourceMappingURL=web.d.ts.map
+declare function initObservabilityWeb(config: WebObservabilityConfig): boolean;
+
+export { initObservabilityWeb };
+export type { WebObservabilityConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@semiont/observability",
-  "version": "0.5.4",
+  "version": "0.5.6",
   "description": "OpenTelemetry-based tracing for Semiont — Tier 2 of OBSERVABILITY.md. Process-init helpers (Node + Web), withSpan helper, W3C traceparent inject/extract for bus payloads. No-op when no exporter is configured.",
   "type": "module",
   "main": "dist/index.js",
@@ -28,7 +28,7 @@
     }
   },
   "engines": {
-    "node": ">=20.18.1"
+    "node": ">=24.0.0"
   },
   "files": [
     "dist",
@@ -46,7 +46,7 @@
   "scripts": {
     "pretypecheck": "npm run build --workspace=@semiont/core --if-present",
     "typecheck": "tsc --noEmit",
-    "build": "npm run typecheck && tsup && tsc -p tsconfig.build.json",
+    "build": "npm run typecheck && tsup && tsc -p tsconfig.build.json && rollup -c rollup.dts.config.mjs && rm -rf dist-types",
     "watch": "tsup --watch",
     "clean": "rm -rf dist *.tsbuildinfo",
     "test": "vitest run",
@@ -55,22 +55,24 @@
   "author": "Semiont Team",
   "license": "Apache-2.0",
   "devDependencies": {
+    "rollup": "^4.61.0",
+    "rollup-plugin-dts": "^6.4.1",
     "tsup": "^8.5.1",
     "typescript": "^6.0.2",
-    "vitest": "^4.1.0"
+    "vitest": "^4.1.8"
   },
   "dependencies": {
-    "@opentelemetry/api": "^1.9.0",
-    "@semiont/core": "*",
-    "@opentelemetry/context-async-hooks": "^2.7.0",
-    "@opentelemetry/core": "^2.7.0",
-    "@opentelemetry/exporter-metrics-otlp-http": "^0.215.0",
-    "@opentelemetry/exporter-trace-otlp-http": "^0.215.0",
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/context-async-hooks": "^2.7.1",
+    "@opentelemetry/core": "^2.7.1",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.218.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.218.0",
     "@opentelemetry/resources": "^2.7.0",
     "@opentelemetry/sdk-metrics": "^2.7.0",
     "@opentelemetry/sdk-trace-base": "^2.7.0",
-    "@opentelemetry/sdk-trace-web": "^2.7.0",
-    "@opentelemetry/semantic-conventions": "^1.40.0",
+    "@opentelemetry/sdk-trace-web": "^2.7.1",
+    "@opentelemetry/semantic-conventions": "^1.41.1",
+    "@semiont/core": "*",
     "winston": "^3.17.0"
   }
 }

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/node.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAuBH,MAAM,WAAW,uBAAuB;IACtC,oFAAoF;IACpF,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAWD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAyE9E;AAED,sEAAsE;AACtE,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,CAO/D"}

package/dist/process-logger.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"process-logger.d.ts","sourceRoot":"","sources":["../src/process-logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAY5C,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA2B7D"}

package/dist/web.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../src/web.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAID;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAwB5E"}