@semiont/observability 0.5.2 → 0.5.4

package/dist/index.d.ts

@@ -1,6 +1,3 @@
-import { Span, Attributes, SpanKind } from '@opentelemetry/api';
-export { Attributes, Span, SpanKind, SpanStatusCode } from '@opentelemetry/api';
-
 /**
  * @semiont/observability — public API.
  *
@@ -24,13 +21,13 @@ export { Attributes, Span, SpanKind, SpanStatusCode } from '@opentelemetry/api';
  * 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.
  */
-declare function withSpan<T>(name: string, fn: (span: Span) => Promise<T> | T, options?: {
+export declare function withSpan<T>(name: string, fn: (span: Span) => Promise<T> | T, options?: {
     kind?: SpanKind;
     attrs?: Attributes;
 }): Promise<T>;
@@ -40,7 +37,7 @@ declare function withSpan<T>(name: string, fn: (span: Span) => Promise<T> | T, o
  * the payload to subscribers. Additive — payloads without `_trace` parse
  * unchanged.
  */
-interface TraceCarrier {
+export interface TraceCarrier {
     /** W3C `traceparent` header value (`00-<traceId>-<spanId>-<flags>`). */
     traceparent: string;
     /** W3C `tracestate` header value (vendor-specific extensions). */
@@ -50,24 +47,24 @@ interface TraceCarrier {
  * Read the active span's W3C traceparent (and tracestate). Returns
  * `undefined` if no span is active.
  */
-declare function getActiveTraceparent(): TraceCarrier | undefined;
+export 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.
  */
-declare function injectTraceparent<T extends Record<string, unknown>>(payload: T): T;
+export 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.
  */
-declare function extractTraceparent<T extends Record<string, unknown>>(payload: T): TraceCarrier | undefined;
+export 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.
  */
-declare function withTraceparent<T>(carrier: TraceCarrier | undefined, fn: () => T): T;
+export 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
@@ -80,7 +77,7 @@ 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.
  */
-declare function withActorSpan<T>(actor: string, channel: string, fn: (span: Span) => Promise<T> | T, extraAttrs?: Attributes): Promise<T>;
+export 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
@@ -90,12 +87,12 @@ declare function withActorSpan<T>(actor: string, channel: string, fn: (span: Spa
  * Returns `undefined` if no span is active, or if the active span's
  * context is invalid (uninitialized SDK, no-op tracer).
  */
-declare function getLogTraceContext(): {
+export declare function getLogTraceContext(): {
     trace_id: string;
     span_id: string;
 } | undefined;
 /** Snapshot of job-queue contents by status. Match `JobQueue.getStats()`. */
-interface JobQueueSnapshot {
+export interface JobQueueSnapshot {
     pending: number;
     running: number;
     complete: number;
@@ -103,15 +100,15 @@ interface JobQueueSnapshot {
     cancelled: number;
 }
 /** Increment the bus-emit counter. Called at every transport `emit` site. */
-declare function recordBusEmit(channel: string, scope?: string): void;
+export declare function recordBusEmit(channel: string, scope?: string): void;
 /** Record an in-process actor handler's duration. */
-declare function recordHandlerDuration(actor: string, channel: string, durationMs: number): void;
+export declare function recordHandlerDuration(actor: string, channel: string, durationMs: number): void;
 /** Record a worker job's outcome and duration. */
-declare function recordJobOutcome(jobType: string, outcome: 'completed' | 'failed', durationMs: number): void;
+export declare function recordJobOutcome(jobType: string, outcome: 'completed' | 'failed', durationMs: number): void;
 /** Increment the SSE subscriber gauge — call on `/bus/subscribe` open. */
-declare function recordSubscriberConnect(): void;
+export declare function recordSubscriberConnect(): void;
 /** Decrement on disconnect. Pair with `recordSubscriberConnect`. */
-declare function recordSubscriberDisconnect(): void;
+export 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
@@ -119,19 +116,19 @@ declare function recordSubscriberDisconnect(): void;
  * with the `job.status` attribute. Idempotent — last registered
  * provider wins.
  */
-declare function registerJobQueueProvider(provider: () => Promise<JobQueueSnapshot> | JobQueueSnapshot): void;
+export 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.
  */
-declare function registerVectorIndexSizeProvider(provider: () => Promise<number> | number): void;
+export 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.
  */
-declare function recordInferenceUsage(opts: {
+export declare function recordInferenceUsage(opts: {
     provider: string;
     model: string;
     durationMs: number;
@@ -139,5 +136,5 @@ declare function recordInferenceUsage(opts: {
     inputTokens?: number;
     outputTokens?: number;
 }): void;
-
-export { type JobQueueSnapshot, type TraceCarrier, extractTraceparent, getActiveTraceparent, getLogTraceContext, injectTraceparent, recordBusEmit, recordHandlerDuration, recordInferenceUsage, recordJobOutcome, recordSubscriberConnect, recordSubscriberDisconnect, registerJobQueueProvider, registerVectorIndexSizeProvider, withActorSpan, withSpan, withTraceparent };
+export { SpanKind, SpanStatusCode, type Attributes, type Span } from '@opentelemetry/api';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

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.
  */
-interface NodeObservabilityConfig {
+export 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,8 +39,7 @@ interface NodeObservabilityConfig {
  * Metrics export at `OTEL_METRIC_EXPORT_INTERVAL` ms (default 30s) to
  * the same `OTEL_EXPORTER_OTLP_ENDPOINT` as traces.
  */
-declare function initObservabilityNode(config: NodeObservabilityConfig): boolean;
+export declare function initObservabilityNode(config: NodeObservabilityConfig): boolean;
 /** Force-flush + shutdown both SDKs. Test cleanup, not production. */
-declare function shutdownObservabilityNode(): Promise<void>;
-
-export { type NodeObservabilityConfig, initObservabilityNode, shutdownObservabilityNode };
+export declare function shutdownObservabilityNode(): Promise<void>;
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"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

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

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

@@ -0,0 +1 @@
+{"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

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

package/dist/web.d.ts.map

@@ -0,0 +1 @@
+{"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@semiont/observability",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "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",
@@ -46,7 +46,7 @@
   "scripts": {
     "pretypecheck": "npm run build --workspace=@semiont/core --if-present",
     "typecheck": "tsc --noEmit",
-    "build": "npm run typecheck && tsup",
+    "build": "npm run typecheck && tsup && tsc -p tsconfig.build.json",
     "watch": "tsup --watch",
     "clean": "rm -rf dist *.tsbuildinfo",
     "test": "vitest run",
@@ -56,7 +56,7 @@
   "license": "Apache-2.0",
   "devDependencies": {
     "tsup": "^8.5.1",
-    "typescript": "^5.6.3",
+    "typescript": "^6.0.2",
     "vitest": "^4.1.0"
   },
   "dependencies": {