@orqenix/mesh-observability 0.6.0-phase-6

package/LICENSE

@@ -0,0 +1,19 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+Copyright 2026 Milo Nguyen and Orqenix contributors
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+[Full Apache 2.0 text: include verbatim from https://www.apache.org/licenses/LICENSE-2.0.txt]

package/dist/adapters.d.ts

@@ -0,0 +1,44 @@
+import { MeshLogger } from './logger.js';
+import { MeshMetrics } from './metrics.js';
+import type { MeshRequest, MeshResponse, ScopeId } from '@orqenix/mesh-transport-core';
+export interface ObservabilityHooks {
+    logger: MeshLogger;
+    metrics: MeshMetrics;
+}
+export interface CommonCtx {
+    scopeId: ScopeId;
+    transport: string;
+    peerId?: string;
+}
+export declare function onTransportStart(h: ObservabilityHooks, ctx: CommonCtx): void;
+export declare function onTransportStop(h: ObservabilityHooks, ctx: CommonCtx): void;
+export declare function onPeerConnect(h: ObservabilityHooks, ctx: CommonCtx & {
+    peerCount: number;
+}): void;
+export declare function onPeerDisconnect(h: ObservabilityHooks, ctx: CommonCtx & {
+    peerCount: number;
+}): void;
+export declare function onRpcIn(h: ObservabilityHooks, ctx: CommonCtx, req: MeshRequest): void;
+export declare function onRpcOut(h: ObservabilityHooks, ctx: CommonCtx, req: MeshRequest, resp: MeshResponse, durationMs: number): void;
+export declare function onRpcDenied(h: ObservabilityHooks, ctx: CommonCtx, req: Pick<MeshRequest, 'id' | 'method'>, errorCode: string): void;
+export declare function onDiscoveryFound(h: ObservabilityHooks, ctx: CommonCtx): void;
+export declare function onDiscoveryLost(h: ObservabilityHooks, ctx: CommonCtx): void;
+export declare function onFailover(h: ObservabilityHooks, ctx: {
+    scopeId: ScopeId;
+    from: string;
+    to: string;
+}): void;
+export declare function onCircuitOpen(h: ObservabilityHooks, ctx: {
+    scopeId: ScopeId;
+    transport: string;
+}): void;
+export declare function onCircuitHalfOpen(h: ObservabilityHooks, ctx: {
+    scopeId: ScopeId;
+    transport: string;
+}): void;
+export declare function onCircuitClose(h: ObservabilityHooks, ctx: {
+    scopeId: ScopeId;
+    transport: string;
+}): void;
+export declare function rpcTraceId(req: MeshRequest): string | undefined;
+//# sourceMappingURL=adapters.d.ts.map

package/dist/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAgB,WAAW,EAAE,MAAM,cAAc,CAAC;AAGzD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAEvF,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,kBAAkB,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAE5E;AACD,wBAAgB,eAAe,CAAC,CAAC,EAAE,kBAAkB,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAE3E;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,kBAAkB,EAAE,GAAG,EAAE,SAAS,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAGjG;AACD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,kBAAkB,EAAE,GAAG,EAAE,SAAS,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAGpG;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,kBAAkB,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAUrF;AAED,wBAAgB,QAAQ,CACtB,CAAC,EAAE,kBAAkB,EACrB,GAAG,EAAE,SAAS,EACd,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,YAAY,EAClB,UAAU,EAAE,MAAM,GACjB,IAAI,CAgBN;AAED,wBAAgB,WAAW,CACzB,CAAC,EAAE,kBAAkB,EACrB,GAAG,EAAE,SAAS,EACd,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,QAAQ,CAAC,EACvC,SAAS,EAAE,MAAM,GAChB,IAAI,CAaN;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,kBAAkB,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAE5E;AACD,wBAAgB,eAAe,CAAC,CAAC,EAAE,kBAAkB,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAE3E;AAED,wBAAgB,UAAU,CACxB,CAAC,EAAE,kBAAkB,EACrB,GAAG,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAClD,IAAI,CAGN;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,kBAAkB,EAAE,GAAG,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAGvG;AACD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,kBAAkB,EAAE,GAAG,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAG3G;AACD,wBAAgB,cAAc,CAAC,CAAC,EAAE,kBAAkB,EAAE,GAAG,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAGxG;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAE/D"}

package/dist/adapters.js

@@ -0,0 +1,85 @@
+import { METRIC_NAMES } from './metrics.js';
+import { summarizePayload } from './redaction.js';
+import { traceIdOf } from './trace.js';
+export function onTransportStart(h, ctx) {
+    h.logger.emit({ level: 'info', event: 'transport.start', ...ctx });
+}
+export function onTransportStop(h, ctx) {
+    h.logger.emit({ level: 'info', event: 'transport.stop', ...ctx });
+}
+export function onPeerConnect(h, ctx) {
+    h.logger.emit({ level: 'info', event: 'peer.connect', scopeId: ctx.scopeId, transport: ctx.transport, peerId: ctx.peerId });
+    h.metrics.setGauge(METRIC_NAMES.PEERS, ctx.peerCount, { transport: ctx.transport });
+}
+export function onPeerDisconnect(h, ctx) {
+    h.logger.emit({ level: 'info', event: 'peer.disconnect', scopeId: ctx.scopeId, transport: ctx.transport, peerId: ctx.peerId });
+    h.metrics.setGauge(METRIC_NAMES.PEERS, ctx.peerCount, { transport: ctx.transport });
+}
+export function onRpcIn(h, ctx, req) {
+    h.logger.emit({
+        level: 'info',
+        event: 'rpc.in',
+        scopeId: ctx.scopeId,
+        transport: ctx.transport,
+        peerId: ctx.peerId,
+        requestId: req.id,
+        method: req.method,
+    });
+}
+export function onRpcOut(h, ctx, req, resp, durationMs) {
+    h.logger.emit({
+        level: 'info',
+        event: 'rpc.out',
+        scopeId: ctx.scopeId,
+        transport: ctx.transport,
+        peerId: ctx.peerId,
+        requestId: req.id,
+        method: req.method,
+        durationMs,
+        status: resp.status,
+        errorCode: resp.error?.code,
+    });
+    h.metrics.incCounter(METRIC_NAMES.RPC_TOTAL, 1, { transport: ctx.transport, status: resp.status });
+    h.metrics.observeHistogram(METRIC_NAMES.RPC_DURATION_MS, durationMs, { transport: ctx.transport });
+    void summarizePayload(resp.payload);
+}
+export function onRpcDenied(h, ctx, req, errorCode) {
+    h.logger.emit({
+        level: 'warn',
+        event: 'rpc.denied',
+        scopeId: ctx.scopeId,
+        transport: ctx.transport,
+        peerId: ctx.peerId,
+        requestId: req.id,
+        method: req.method,
+        status: 'denied',
+        errorCode,
+    });
+    h.metrics.incCounter(METRIC_NAMES.RPC_TOTAL, 1, { transport: ctx.transport, status: 'denied' });
+}
+export function onDiscoveryFound(h, ctx) {
+    h.logger.emit({ level: 'info', event: 'discovery.found', scopeId: ctx.scopeId, transport: ctx.transport, peerId: ctx.peerId });
+}
+export function onDiscoveryLost(h, ctx) {
+    h.logger.emit({ level: 'info', event: 'discovery.lost', scopeId: ctx.scopeId, transport: ctx.transport, peerId: ctx.peerId });
+}
+export function onFailover(h, ctx) {
+    h.logger.emit({ level: 'warn', event: 'failover', scopeId: ctx.scopeId, transport: ctx.from });
+    h.metrics.incCounter(METRIC_NAMES.FAILOVER_TOTAL, 1, { from: ctx.from, to: ctx.to });
+}
+export function onCircuitOpen(h, ctx) {
+    h.logger.emit({ level: 'warn', event: 'circuit.open', scopeId: ctx.scopeId, transport: ctx.transport });
+    h.metrics.setGauge(METRIC_NAMES.CIRCUIT_STATE, 2, { transport: ctx.transport });
+}
+export function onCircuitHalfOpen(h, ctx) {
+    h.logger.emit({ level: 'info', event: 'circuit.halfopen', scopeId: ctx.scopeId, transport: ctx.transport });
+    h.metrics.setGauge(METRIC_NAMES.CIRCUIT_STATE, 1, { transport: ctx.transport });
+}
+export function onCircuitClose(h, ctx) {
+    h.logger.emit({ level: 'info', event: 'circuit.close', scopeId: ctx.scopeId, transport: ctx.transport });
+    h.metrics.setGauge(METRIC_NAMES.CIRCUIT_STATE, 0, { transport: ctx.transport });
+}
+export function rpcTraceId(req) {
+    return traceIdOf(req.trace.traceparent);
+}
+//# sourceMappingURL=adapters.js.map

package/dist/adapters.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './schema.js';
+export * from './redaction.js';
+export * from './logger.js';
+export * from './metrics.js';
+export * from './trace.js';
+export * from './adapters.js';
+//# 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":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from './schema.js';
+export * from './redaction.js';
+export * from './logger.js';
+export * from './metrics.js';
+export * from './trace.js';
+export * from './adapters.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,46 @@
+import { type MeshLogEvent, type MeshLogLevel, type MeshStatus } from './schema.js';
+import type { ScopeId } from '@orqenix/mesh-transport-core';
+export type LogSink = (event: MeshLogEvent, serialized: string) => void;
+export interface MeshLoggerOptions {
+    sink?: LogSink;
+    level?: MeshLogLevel;
+    now?: () => Date;
+    strict?: boolean;
+}
+export declare class MeshLogger {
+    private readonly sink;
+    private readonly level;
+    private readonly now;
+    private readonly strict;
+    constructor(opts?: MeshLoggerOptions);
+    emit(partial: Omit<MeshLogEvent, 'ts'> & {
+        ts?: string;
+    }): void;
+    rpcIn(args: {
+        scopeId: ScopeId;
+        transport: string;
+        requestId: string;
+        method: string;
+    }): void;
+    rpcOut(args: {
+        scopeId: ScopeId;
+        transport: string;
+        requestId: string;
+        method: string;
+        durationMs: number;
+        status: MeshStatus;
+    }): void;
+    rpcDenied(args: {
+        scopeId: ScopeId;
+        transport: string;
+        requestId: string;
+        method?: string;
+        errorCode: string;
+    }): void;
+}
+export declare function bufferSink(): {
+    events: MeshLogEvent[];
+    lines: string[];
+    sink: LogSink;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0D,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAE5I,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAE5D,MAAM,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;AAExE,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAID,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;gBAErB,IAAI,GAAE,iBAAsB;IAOxC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAwC/D,KAAK,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAG7F,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,UAAU,CAAA;KAAE,GAAG,IAAI;IAGtI,SAAS,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAGtH;AAMD,wBAAgB,UAAU,IAAI;IAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAOvF"}

package/dist/logger.js

@@ -0,0 +1,75 @@
+import { validateLogEvent } from './schema.js';
+import { containsLeak } from './redaction.js';
+const LEVEL_RANK = { debug: 0, info: 1, warn: 2, error: 3 };
+export class MeshLogger {
+    sink;
+    level;
+    now;
+    strict;
+    constructor(opts = {}) {
+        this.sink = opts.sink ?? defaultSink;
+        this.level = opts.level ?? 'info';
+        this.now = opts.now ?? (() => new Date());
+        this.strict = opts.strict ?? false;
+    }
+    emit(partial) {
+        if (LEVEL_RANK[partial.level] < LEVEL_RANK[this.level])
+            return;
+        const event = {
+            ...partial,
+            ts: partial.ts ?? this.now().toISOString(),
+        };
+        const errs = validateLogEvent(event);
+        if (errs) {
+            if (this.strict)
+                throw new Error(`MeshLogger schema violation: ${errs.join('; ')}`);
+            return;
+        }
+        let serialized;
+        try {
+            serialized = JSON.stringify(event);
+        }
+        catch {
+            return;
+        }
+        if (containsLeak(serialized)) {
+            try {
+                this.sink({
+                    ts: this.now().toISOString(),
+                    level: 'warn',
+                    event: 'rpc.denied',
+                    scopeId: event.scopeId,
+                    transport: event.transport,
+                    errorCode: 'E_LOG_REDACTION',
+                }, '{"event":"rpc.denied","errorCode":"E_LOG_REDACTION"}');
+            }
+            catch { /* ignore */ }
+            return;
+        }
+        try {
+            this.sink(event, serialized);
+        }
+        catch { /* ignore */ }
+    }
+    rpcIn(args) {
+        this.emit({ level: 'info', event: 'rpc.in', ...args });
+    }
+    rpcOut(args) {
+        this.emit({ level: 'info', event: 'rpc.out', ...args });
+    }
+    rpcDenied(args) {
+        this.emit({ level: 'warn', event: 'rpc.denied', status: 'denied', ...args });
+    }
+}
+function defaultSink(_evt, serialized) {
+    console.log(serialized);
+}
+export function bufferSink() {
+    const events = [];
+    const lines = [];
+    return {
+        events, lines,
+        sink: (e, s) => { events.push(e); lines.push(s); },
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/metrics.d.ts

@@ -0,0 +1,50 @@
+export type MetricKind = 'counter' | 'gauge' | 'histogram';
+export declare const METRIC_NAMES: {
+    readonly RPC_TOTAL: "orqenix_mesh_rpc_total";
+    readonly RPC_DURATION_MS: "orqenix_mesh_rpc_duration_ms";
+    readonly PEERS: "orqenix_mesh_peers";
+    readonly CAPABILITY_VERIFY_MS: "orqenix_mesh_capability_verify_ms";
+    readonly FAILOVER_TOTAL: "orqenix_mesh_failover_total";
+    readonly CIRCUIT_STATE: "orqenix_mesh_circuit_state";
+};
+export interface HistogramSummary {
+    count: number;
+    p50: number;
+    p95: number;
+    p99: number;
+    max: number;
+}
+export interface MetricSnapshot {
+    counters: Array<{
+        name: string;
+        labels: string;
+        value: number;
+    }>;
+    gauges: Array<{
+        name: string;
+        labels: string;
+        value: number;
+    }>;
+    histograms: Array<{
+        name: string;
+        labels: string;
+        summary: HistogramSummary;
+    }>;
+}
+export interface MeshMetricsOptions {
+    histogramCapacity?: number;
+}
+export declare class MeshMetrics {
+    private readonly metrics;
+    private readonly histogramCapacity;
+    constructor(opts?: MeshMetricsOptions);
+    incCounter(name: string, by: number, labels?: Record<string, string>): void;
+    setGauge(name: string, value: number, labels?: Record<string, string>): void;
+    observeHistogram(name: string, sample: number, labels?: Record<string, string>): void;
+    snapshot(): MetricSnapshot;
+    registeredNames(): string[];
+    private ensureCounter;
+    private ensureGauge;
+    private ensureHistogram;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;AA2B3D,eAAO,MAAM,YAAY;;;;;;;CAOf,CAAC;AAEX,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,gBAAgB,CAAA;KAAE,CAAC,CAAC;CAChF;AAED,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;gBAE/B,IAAI,GAAE,kBAAuB;IAUzC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAM3E,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAK5E,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAYrF,QAAQ,IAAI,cAAc;IAiB1B,eAAe,IAAI,MAAM,EAAE;IAI3B,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,eAAe;CASxB"}

package/dist/metrics.js

@@ -0,0 +1,109 @@
+function labelKey(labels) {
+    if (!labels)
+        return '';
+    const keys = Object.keys(labels).sort();
+    return keys.map((k) => `${k}=${labels[k]}`).join(',');
+}
+export const METRIC_NAMES = {
+    RPC_TOTAL: 'orqenix_mesh_rpc_total',
+    RPC_DURATION_MS: 'orqenix_mesh_rpc_duration_ms',
+    PEERS: 'orqenix_mesh_peers',
+    CAPABILITY_VERIFY_MS: 'orqenix_mesh_capability_verify_ms',
+    FAILOVER_TOTAL: 'orqenix_mesh_failover_total',
+    CIRCUIT_STATE: 'orqenix_mesh_circuit_state',
+};
+export class MeshMetrics {
+    metrics = new Map();
+    histogramCapacity;
+    constructor(opts = {}) {
+        this.histogramCapacity = opts.histogramCapacity ?? 1024;
+        this.ensureCounter(METRIC_NAMES.RPC_TOTAL);
+        this.ensureHistogram(METRIC_NAMES.RPC_DURATION_MS);
+        this.ensureGauge(METRIC_NAMES.PEERS);
+        this.ensureHistogram(METRIC_NAMES.CAPABILITY_VERIFY_MS);
+        this.ensureCounter(METRIC_NAMES.FAILOVER_TOTAL);
+        this.ensureGauge(METRIC_NAMES.CIRCUIT_STATE);
+    }
+    incCounter(name, by, labels) {
+        const m = this.ensureCounter(name);
+        const k = labelKey(labels);
+        m.values.set(k, (m.values.get(k) ?? 0) + by);
+    }
+    setGauge(name, value, labels) {
+        const m = this.ensureGauge(name);
+        m.values.set(labelKey(labels), value);
+    }
+    observeHistogram(name, sample, labels) {
+        const m = this.ensureHistogram(name);
+        const k = labelKey(labels);
+        let buf = m.ring.get(k);
+        if (!buf) {
+            buf = [];
+            m.ring.set(k, buf);
+        }
+        buf.push(sample);
+        if (buf.length > m.capacity)
+            buf.shift();
+    }
+    snapshot() {
+        const counters = [];
+        const gauges = [];
+        const histograms = [];
+        for (const m of this.metrics.values()) {
+            if (m.kind === 'counter') {
+                for (const [labels, value] of m.values)
+                    counters.push({ name: m.name, labels, value });
+            }
+            else if (m.kind === 'gauge') {
+                for (const [labels, value] of m.values)
+                    gauges.push({ name: m.name, labels, value });
+            }
+            else {
+                for (const [labels, buf] of m.ring)
+                    histograms.push({ name: m.name, labels, summary: summarize(buf) });
+            }
+        }
+        return { counters, gauges, histograms };
+    }
+    registeredNames() {
+        return [...this.metrics.keys()].sort();
+    }
+    ensureCounter(name) {
+        let m = this.metrics.get(name);
+        if (!m) {
+            m = { kind: 'counter', name, values: new Map() };
+            this.metrics.set(name, m);
+        }
+        if (m.kind !== 'counter')
+            throw new Error(`metric ${name} already registered with kind ${m.kind}`);
+        return m;
+    }
+    ensureGauge(name) {
+        let m = this.metrics.get(name);
+        if (!m) {
+            m = { kind: 'gauge', name, values: new Map() };
+            this.metrics.set(name, m);
+        }
+        if (m.kind !== 'gauge')
+            throw new Error(`metric ${name} already registered with kind ${m.kind}`);
+        return m;
+    }
+    ensureHistogram(name) {
+        let m = this.metrics.get(name);
+        if (!m) {
+            m = { kind: 'histogram', name, ring: new Map(), capacity: this.histogramCapacity };
+            this.metrics.set(name, m);
+        }
+        if (m.kind !== 'histogram')
+            throw new Error(`metric ${name} already registered with kind ${m.kind}`);
+        return m;
+    }
+}
+function summarize(samples) {
+    if (samples.length === 0)
+        return { count: 0, p50: 0, p95: 0, p99: 0, max: 0 };
+    const sorted = samples.slice().sort((a, b) => a - b);
+    const at = (q) => sorted[Math.min(sorted.length - 1, Math.floor(sorted.length * q))];
+    return { count: sorted.length, p50: at(0.5), p95: at(0.95), p99: at(0.99), max: sorted[sorted.length - 1] };
+}
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

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

package/dist/redaction.d.ts

@@ -0,0 +1,18 @@
+import type { MeshRequest } from '@orqenix/mesh-transport-core';
+export interface PayloadSummary {
+    payloadSize: number;
+    payloadHash: string;
+}
+export interface CapabilitySummary {
+    jti?: string;
+}
+export declare function summarizePayload(bytes: Uint8Array | undefined): PayloadSummary | undefined;
+export declare function summarizeCapability(_token: unknown): CapabilitySummary | undefined;
+export declare function summarizeRequest(req: Pick<MeshRequest, 'id' | 'method' | 'payload'>): {
+    requestId: string;
+    method: string;
+    payload?: PayloadSummary;
+};
+export declare function redact(input: unknown, depth?: number): unknown;
+export declare function containsLeak(serialized: string): boolean;
+//# sourceMappingURL=redaction.d.ts.map

package/dist/redaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.d.ts","sourceRoot":"","sources":["../src/redaction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAQD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAO1F;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAElF;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,QAAQ,GAAG,SAAS,CAAC,GAAG;IACrF,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B,CAMA;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,OAAO,CAiBzD;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAQxD"}

package/dist/redaction.js

@@ -0,0 +1,57 @@
+import { hash as blake3Hash } from 'blake3-wasm';
+const FORBIDDEN_FIELD_NAMES = new Set([
+    'capability', 'cap', 'token', 'signature', 'sig', 'secret',
+    'privateKey', 'private_key', 'seed', 'scopeSeed',
+    'payload', 'payloadBytes',
+]);
+export function summarizePayload(bytes) {
+    if (!bytes)
+        return undefined;
+    const digest = blake3Hash(bytes);
+    return {
+        payloadSize: bytes.length,
+        payloadHash: Buffer.from(digest).toString('hex'),
+    };
+}
+export function summarizeCapability(_token) {
+    return { jti: undefined };
+}
+export function summarizeRequest(req) {
+    return {
+        requestId: req.id,
+        method: req.method,
+        payload: summarizePayload(req.payload),
+    };
+}
+export function redact(input, depth = 0) {
+    if (depth > 4)
+        return '[depth-limited]';
+    if (input == null)
+        return input;
+    if (input instanceof Uint8Array)
+        return summarizePayload(input);
+    if (Array.isArray(input))
+        return input.map((v) => redact(v, depth + 1));
+    if (typeof input === 'object') {
+        const out = {};
+        for (const [k, v] of Object.entries(input)) {
+            if (FORBIDDEN_FIELD_NAMES.has(k)) {
+                out[k] = '[redacted]';
+                continue;
+            }
+            out[k] = redact(v, depth + 1);
+        }
+        return out;
+    }
+    return input;
+}
+export function containsLeak(serialized) {
+    if (/"(capability|token|sig|signature|secret|privateKey|seed)"\s*:\s*"(?!\[redacted\])/.test(serialized)) {
+        return true;
+    }
+    if (/"[A-Za-z0-9_-]{120,}"/.test(serialized)) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=redaction.js.map

package/dist/redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../src/redaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AAYjD,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ;IAC1D,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW;IAChD,SAAS,EAAE,cAAc;CAC1B,CAAC,CAAC;AAEH,MAAM,UAAU,gBAAgB,CAAC,KAA6B;IAC5D,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,MAAM;QACzB,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;KACjD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAe;IACjD,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAmD;IAKlF,OAAO;QACL,SAAS,EAAE,GAAG,CAAC,EAAE;QACjB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,OAAO,EAAE,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC;KACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAc,EAAE,KAAK,GAAG,CAAC;IAC9C,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,iBAAiB,CAAC;IACxC,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IAChC,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAChE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IACxE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;YACtE,IAAI,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjC,GAAG,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC;gBACtB,SAAS;YACX,CAAC;YACD,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,UAAkB;IAC7C,IAAI,mFAAmF,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACzG,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,uBAAuB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,20 @@
+import type { ScopeId } from '@orqenix/mesh-transport-core';
+export type MeshLogLevel = 'debug' | 'info' | 'warn' | 'error';
+export type MeshEventName = 'transport.start' | 'transport.stop' | 'peer.connect' | 'peer.disconnect' | 'rpc.in' | 'rpc.out' | 'rpc.denied' | 'discovery.found' | 'discovery.lost' | 'failover' | 'circuit.open' | 'circuit.halfopen' | 'circuit.close';
+export type MeshStatus = 'ok' | 'denied' | 'error' | 'timeout';
+export declare const CANONICAL_EVENTS: ReadonlySet<MeshEventName>;
+export interface MeshLogEvent {
+    ts: string;
+    level: MeshLogLevel;
+    event: MeshEventName;
+    scopeId: ScopeId;
+    peerId?: string;
+    requestId?: string;
+    transport: 'http' | 'libp2p' | 'loopback' | string;
+    method?: string;
+    durationMs?: number;
+    status?: MeshStatus;
+    errorCode?: string;
+}
+export declare function validateLogEvent(value: unknown): string[] | null;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAE5D,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE/D,MAAM,MAAM,aAAa,GACrB,iBAAiB,GACjB,gBAAgB,GAChB,cAAc,GACd,iBAAiB,GACjB,QAAQ,GACR,SAAS,GACT,YAAY,GACZ,iBAAiB,GACjB,gBAAgB,GAChB,UAAU,GACV,cAAc,GACd,kBAAkB,GAClB,eAAe,CAAC;AAEpB,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAE/D,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,aAAa,CActD,CAAC;AAEH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,IAAI,CA0ChE"}

package/dist/schema.js

@@ -0,0 +1,62 @@
+export const CANONICAL_EVENTS = new Set([
+    'transport.start',
+    'transport.stop',
+    'peer.connect',
+    'peer.disconnect',
+    'rpc.in',
+    'rpc.out',
+    'rpc.denied',
+    'discovery.found',
+    'discovery.lost',
+    'failover',
+    'circuit.open',
+    'circuit.halfopen',
+    'circuit.close',
+]);
+export function validateLogEvent(value) {
+    const errs = [];
+    if (!value || typeof value !== 'object') {
+        return ['event is not an object'];
+    }
+    const v = value;
+    const allowed = new Set([
+        'ts', 'level', 'event', 'scopeId', 'peerId', 'requestId',
+        'transport', 'method', 'durationMs', 'status', 'errorCode',
+    ]);
+    for (const k of Object.keys(v)) {
+        if (!allowed.has(k))
+            errs.push(`unknown field: ${k}`);
+    }
+    if (typeof v.ts !== 'string' || !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/.test(v.ts)) {
+        errs.push('ts must be ISO-8601 with ms precision and Z suffix');
+    }
+    if (!['debug', 'info', 'warn', 'error'].includes(v.level)) {
+        errs.push('level must be one of debug|info|warn|error');
+    }
+    if (typeof v.event !== 'string' || !CANONICAL_EVENTS.has(v.event)) {
+        errs.push('event must be one of the canonical event names');
+    }
+    if (typeof v.scopeId !== 'string' || v.scopeId.length === 0) {
+        errs.push('scopeId required');
+    }
+    if (typeof v.transport !== 'string' || v.transport.length === 0) {
+        errs.push('transport required');
+    }
+    if (v.peerId !== undefined && typeof v.peerId !== 'string')
+        errs.push('peerId must be string when present');
+    if (v.requestId !== undefined && typeof v.requestId !== 'string')
+        errs.push('requestId must be string when present');
+    if (v.method !== undefined && typeof v.method !== 'string')
+        errs.push('method must be string when present');
+    if (v.durationMs !== undefined && (typeof v.durationMs !== 'number' || v.durationMs < 0)) {
+        errs.push('durationMs must be a non-negative number when present');
+    }
+    if (v.status !== undefined && !['ok', 'denied', 'error', 'timeout'].includes(v.status)) {
+        errs.push('status must be one of ok|denied|error|timeout when present');
+    }
+    if (v.errorCode !== undefined && typeof v.errorCode !== 'string') {
+        errs.push('errorCode must be string when present');
+    }
+    return errs.length === 0 ? null : errs;
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/dist/trace.d.ts

@@ -0,0 +1,15 @@
+import type { TraceContext } from '@orqenix/mesh-transport-core';
+export interface ParsedTraceparent {
+    version: '00';
+    traceId: string;
+    spanId: string;
+    flags: string;
+}
+export declare function parseTraceparent(tp: string): ParsedTraceparent | null;
+export declare function validateTraceparent(tp: string): boolean;
+export declare function formatTraceparent(p: ParsedTraceparent): string;
+export declare function newTraceparent(): string;
+export declare function deriveChildSpan(parent: string): string;
+export declare function buildOutgoingTraceContext(parent?: string): TraceContext;
+export declare function traceIdOf(traceparent: string): string | undefined;
+//# sourceMappingURL=trace.d.ts.map

package/dist/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAIjE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,IAAI,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAIrE;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAE9D;AAQD,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAItD;AAED,wBAAgB,yBAAyB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,CAGvE;AAED,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEjE"}

package/dist/trace.js

@@ -0,0 +1,36 @@
+import { webcrypto } from 'node:crypto';
+const TRACEPARENT_RE = /^00-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/;
+export function parseTraceparent(tp) {
+    const m = TRACEPARENT_RE.exec(tp);
+    if (!m)
+        return null;
+    return { version: '00', traceId: m[1], spanId: m[2], flags: m[3] };
+}
+export function validateTraceparent(tp) {
+    return parseTraceparent(tp) !== null;
+}
+export function formatTraceparent(p) {
+    return `00-${p.traceId}-${p.spanId}-${p.flags}`;
+}
+function randHex(bytes) {
+    const buf = new Uint8Array(bytes);
+    webcrypto.getRandomValues(buf);
+    return Buffer.from(buf).toString('hex');
+}
+export function newTraceparent() {
+    return formatTraceparent({ version: '00', traceId: randHex(16), spanId: randHex(8), flags: '01' });
+}
+export function deriveChildSpan(parent) {
+    const p = parseTraceparent(parent);
+    if (!p)
+        return newTraceparent();
+    return formatTraceparent({ ...p, spanId: randHex(8) });
+}
+export function buildOutgoingTraceContext(parent) {
+    const traceparent = parent ? deriveChildSpan(parent) : newTraceparent();
+    return { traceparent };
+}
+export function traceIdOf(traceparent) {
+    return parseTraceparent(traceparent)?.traceId;
+}
+//# sourceMappingURL=trace.js.map

package/dist/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,MAAM,cAAc,GAAG,kDAAkD,CAAC;AAS1E,MAAM,UAAU,gBAAgB,CAAC,EAAU;IACzC,MAAM,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,EAAU;IAC5C,OAAO,gBAAgB,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,CAAoB;IACpD,OAAO,MAAM,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;AAClD,CAAC;AAED,SAAS,OAAO,CAAC,KAAa;IAC5B,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAClC,SAAS,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,iBAAiB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACrG,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,CAAC,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,CAAC,CAAC;QAAE,OAAO,cAAc,EAAE,CAAC;IAChC,OAAO,iBAAiB,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAe;IACvD,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC;IACxE,OAAO,EAAE,WAAW,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,WAAmB;IAC3C,OAAO,gBAAgB,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;AAChD,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@orqenix/mesh-observability",
+  "version": "0.6.0-phase-6",
+  "description": "Structured logs, OpenTelemetry-compatible metrics, W3C traceparent propagation, and strict redaction for the Orqenix mesh.",
+  "type": "module",
+  "license": "Apache-2.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "dependencies": {
+    "blake3-wasm": "^2.0.0",
+    "@orqenix/mesh-transport-core": "0.6.0-phase-6"
+  },
+  "devDependencies": {
+    "@types/node": "^22.7.0",
+    "@vitest/coverage-v8": "^2.1.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run --coverage",
+    "gate:G42": "vitest run test/G42-gate-wrapper.test.ts --reporter verbose"
+  }
+}