@origintrail-official/dkg-node-ui 10.0.1 → 10.0.3

package/dist/otlp-log-worker.d.ts

@@ -0,0 +1,127 @@
+/**
+ * OTLP/HTTP log exporter — ships structured log records to an OpenTelemetry
+ * collector (or any OTLP/HTTP logs endpoint) as a second, opt-in sink
+ * alongside the always-on local SQLite store.
+ *
+ * Why hand-rolled rather than @opentelemetry/sdk-logs: as of 2026 the OTel JS
+ * Logs SDK is still "Development" (Traces/Metrics are Stable). We emit the
+ * stable OTLP/HTTP JSON wire format (ExportLogsServiceRequest) directly and
+ * reuse the buffer/flush/backoff shape proven by the syslog LogPushWorker.
+ *
+ * Reliability contract (this must NEVER slow down or crash the node):
+ *  - push() only appends to a bounded in-memory buffer (drop-oldest on
+ *    overflow) and returns immediately; it never awaits the network.
+ *  - flush() runs on a timer, is guarded against overlap, and swallows every
+ *    error. On a retryable failure the batch is requeued and an exponential
+ *    backoff (with jitter, honoring Retry-After) is applied. On a
+ *    non-retryable failure the batch is dropped (logged once).
+ *  - The flush timer is unref'd so it never keeps the process alive.
+ *  - Transport is outbound HTTPS push only — no inbound scrape endpoint.
+ */
+import type { LogRecord } from '@origintrail-official/dkg-core';
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface OtlpLogWorkerOptions {
+    /** Full OTLP/HTTP logs URL, e.g. http://localhost:4318/v1/logs */
+    endpoint: string;
+    /** Bearer credential for the collector (sent as Authorization: Bearer …). */
+    token?: string;
+    /** Extra static headers to attach to every request. */
+    headers?: Record<string, string>;
+    /** Network identifier: 'testnet' | 'mainnet' | 'devnet'. */
+    network: string;
+    /** Node's libp2p peer ID. */
+    peerId: string;
+    nodeName?: string;
+    version?: string;
+    commit?: string;
+    /** 'core' | 'edge' */
+    role?: string;
+    /** Chain id string, e.g. 'base:8453' → resource attr dkg.chain (matches traces/metrics). */
+    chainId?: string;
+    /** OTel resource service.name. Default 'dkg-node'. */
+    serviceName?: string;
+    /**
+     * Per-node identifier. Becomes the OTel `service.instance.id`, which Loki
+     * promotes to the index label `service_instance_id` — this is what a Grafana
+     * "pick a node" dashboard variable selects on. Defaults to nodeName, then
+     * peerId. Hosted nodes should set a unique `name` in config.
+     */
+    serviceInstanceId?: string;
+    /**
+     * Deployment environment (e.g. 'testnet' | 'mainnet'). Becomes the OTel
+     * `deployment.environment`, which Loki promotes to the label
+     * `deployment_environment`. Defaults to `network`.
+     */
+    deploymentEnvironment?: string;
+    /** Minimum level forwarded remotely. Default 'info' (debug stays local). */
+    minLevel?: LogLevel;
+    /** Bounded in-memory buffer; drop-oldest on overflow. Default 500. */
+    bufferMaxEntries?: number;
+    flushIntervalMs?: number;
+    requestTimeoutMs?: number;
+    /** Initial retry backoff in ms (doubles up to maxBackoffMs). Default 1000. */
+    baseBackoffMs?: number;
+    /** Ceiling for retry backoff in ms. Default 60000. */
+    maxBackoffMs?: number;
+    /** Optional diagnostic sink (e.g. the daemon log). Never throws. */
+    onError?: (message: string) => void;
+}
+interface OtlpAttribute {
+    key: string;
+    value: {
+        stringValue: string;
+    };
+}
+export declare class OtlpLogWorker {
+    private buffer;
+    private timer;
+    private stopped;
+    private flushing;
+    private nextAttemptAt;
+    private backoffMs;
+    private droppedNonRetryable;
+    private loggedNonRetryable;
+    private readonly endpoint;
+    private readonly minRank;
+    private readonly maxBuffer;
+    private readonly flushIntervalMs;
+    private readonly requestTimeoutMs;
+    private readonly baseBackoffMs;
+    private readonly maxBackoffMs;
+    private readonly authHeaders;
+    private readonly resourceAttrs;
+    private readonly scopeVersion;
+    private readonly onError;
+    constructor(opts: OtlpLogWorkerOptions);
+    /** Append a record. Filters below minLevel; never awaits the network. */
+    push(record: LogRecord): void;
+    start(): void;
+    stop(): void;
+    /**
+     * Async teardown for the daemon shutdown / telemetry-disable path: stop the
+     * timer and AWAIT a final flush, so the caller can guarantee no batch is still
+     * being sent (or stranded in the buffer) once this resolves. stop() is the
+     * fire-and-forget variant for callers that can't await.
+     */
+    shutdown(): Promise<void>;
+    /** Test/diagnostic hook. */
+    pending(): number;
+    private flush;
+    private requeue;
+    private scheduleBackoff;
+    private post;
+    private buildPayload;
+}
+/**
+ * PURE OTLP/HTTP logs wire-format encoder (ExportLogsServiceRequest JSON).
+ * Extracted from `OtlpLogWorker` so the protocol/payload shape is independent
+ * from the worker's scheduling + retry/backoff mechanics (review: "OtlpLogWorker
+ * mixes too many concerns") — change the wire shape here without touching the
+ * buffer/timer logic, and vice-versa. No side effects, no `this`.
+ */
+export declare function encodeOtlpLogPayload(batch: ReadonlyArray<{
+    r: LogRecord;
+    tsMs: number;
+}>, resourceAttrs: ReadonlyArray<OtlpAttribute>, scopeVersion?: string): string;
+export {};
+//# sourceMappingURL=otlp-log-worker.d.ts.map

package/dist/otlp-log-worker.d.ts.map

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

package/dist/otlp-log-worker.js

@@ -0,0 +1,268 @@
+/**
+ * OTLP/HTTP log exporter — ships structured log records to an OpenTelemetry
+ * collector (or any OTLP/HTTP logs endpoint) as a second, opt-in sink
+ * alongside the always-on local SQLite store.
+ *
+ * Why hand-rolled rather than @opentelemetry/sdk-logs: as of 2026 the OTel JS
+ * Logs SDK is still "Development" (Traces/Metrics are Stable). We emit the
+ * stable OTLP/HTTP JSON wire format (ExportLogsServiceRequest) directly and
+ * reuse the buffer/flush/backoff shape proven by the syslog LogPushWorker.
+ *
+ * Reliability contract (this must NEVER slow down or crash the node):
+ *  - push() only appends to a bounded in-memory buffer (drop-oldest on
+ *    overflow) and returns immediately; it never awaits the network.
+ *  - flush() runs on a timer, is guarded against overlap, and swallows every
+ *    error. On a retryable failure the batch is requeued and an exponential
+ *    backoff (with jitter, honoring Retry-After) is applied. On a
+ *    non-retryable failure the batch is dropped (logged once).
+ *  - The flush timer is unref'd so it never keeps the process alive.
+ *  - Transport is outbound HTTPS push only — no inbound scrape endpoint.
+ */
+import { buildTelemetryResourceAttrs } from './telemetry-resource.js';
+// OpenTelemetry severity numbers (logs data model).
+const OTEL_SEVERITY = {
+    debug: { num: 5, text: 'DEBUG' },
+    info: { num: 9, text: 'INFO' },
+    warn: { num: 13, text: 'WARN' },
+    error: { num: 17, text: 'ERROR' },
+};
+const LEVEL_RANK = { debug: 0, info: 1, warn: 2, error: 3 };
+const RETRYABLE_STATUS = new Set([408, 429, 500, 502, 503, 504]);
+const DEFAULTS = {
+    flushIntervalMs: 2_000,
+    maxBuffer: 500,
+    maxBatch: 256,
+    requestTimeoutMs: 10_000,
+    baseBackoffMs: 1_000,
+    maxBackoffMs: 60_000,
+    serviceName: 'dkg-node',
+    minLevel: 'info',
+};
+function attr(key, value) {
+    if (value == null || value === '')
+        return null;
+    return { key, value: { stringValue: String(value) } };
+}
+export class OtlpLogWorker {
+    buffer = [];
+    timer = null;
+    stopped = false;
+    flushing = false;
+    nextAttemptAt = 0;
+    backoffMs = 0;
+    droppedNonRetryable = 0;
+    loggedNonRetryable = false;
+    endpoint;
+    minRank;
+    maxBuffer;
+    flushIntervalMs;
+    requestTimeoutMs;
+    baseBackoffMs;
+    maxBackoffMs;
+    authHeaders;
+    resourceAttrs;
+    scopeVersion;
+    onError;
+    constructor(opts) {
+        this.endpoint = opts.endpoint;
+        this.minRank = LEVEL_RANK[opts.minLevel ?? DEFAULTS.minLevel] ?? LEVEL_RANK.info;
+        this.maxBuffer = Math.max(1, opts.bufferMaxEntries ?? DEFAULTS.maxBuffer);
+        this.flushIntervalMs = opts.flushIntervalMs ?? DEFAULTS.flushIntervalMs;
+        this.requestTimeoutMs = opts.requestTimeoutMs ?? DEFAULTS.requestTimeoutMs;
+        this.baseBackoffMs = opts.baseBackoffMs ?? DEFAULTS.baseBackoffMs;
+        this.maxBackoffMs = opts.maxBackoffMs ?? DEFAULTS.maxBackoffMs;
+        this.scopeVersion = opts.version || undefined;
+        this.onError = opts.onError ?? (() => { });
+        this.authHeaders = { 'content-type': 'application/json', ...(opts.headers ?? {}) };
+        if (opts.token)
+            this.authHeaders['authorization'] = `Bearer ${opts.token}`;
+        // Built from the SHARED resource model so the log resource (and the Loki
+        // labels promoted from service.name / service.instance.id /
+        // deployment.environment / dkg.node.role) can never drift from the
+        // traces/metrics resource. See ./telemetry-resource.
+        this.resourceAttrs = Object.entries(buildTelemetryResourceAttrs({
+            serviceName: opts.serviceName ?? DEFAULTS.serviceName,
+            serviceVersion: opts.version,
+            serviceInstanceId: opts.serviceInstanceId,
+            deploymentEnvironment: opts.deploymentEnvironment,
+            network: opts.network,
+            peerId: opts.peerId,
+            nodeName: opts.nodeName,
+            nodeRole: opts.role,
+            commit: opts.commit,
+            chainId: opts.chainId,
+        })).map(([key, value]) => ({ key, value: { stringValue: value } }));
+    }
+    /** Append a record. Filters below minLevel; never awaits the network. */
+    push(record) {
+        if ((LEVEL_RANK[record.level] ?? LEVEL_RANK.info) < this.minRank)
+            return;
+        if (this.buffer.length >= this.maxBuffer)
+            this.buffer.shift();
+        this.buffer.push({ r: record, tsMs: Date.now() });
+    }
+    start() {
+        if (this.timer)
+            return;
+        this.stopped = false;
+        this.timer = setInterval(() => {
+            void this.flush();
+        }, this.flushIntervalMs);
+        this.timer.unref();
+    }
+    stop() {
+        this.stopped = true;
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        // Best-effort final flush; failures are swallowed. Fire-and-forget — use
+        // shutdown() when you need to AWAIT the final flush (orderly teardown).
+        void this.flush(true);
+    }
+    /**
+     * Async teardown for the daemon shutdown / telemetry-disable path: stop the
+     * timer and AWAIT a final flush, so the caller can guarantee no batch is still
+     * being sent (or stranded in the buffer) once this resolves. stop() is the
+     * fire-and-forget variant for callers that can't await.
+     */
+    async shutdown() {
+        this.stopped = true;
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        await this.flush(true).catch(() => { });
+    }
+    /** Test/diagnostic hook. */
+    pending() {
+        return this.buffer.length;
+    }
+    async flush(force = false) {
+        if (this.flushing)
+            return;
+        if (this.stopped && !force)
+            return;
+        if (this.buffer.length === 0)
+            return;
+        if (!force && Date.now() < this.nextAttemptAt)
+            return;
+        this.flushing = true;
+        const batch = this.buffer.splice(0, DEFAULTS.maxBatch);
+        try {
+            const body = this.buildPayload(batch);
+            const res = await this.post(body);
+            if (res.ok) {
+                this.backoffMs = 0;
+                this.nextAttemptAt = 0;
+            }
+            else if (RETRYABLE_STATUS.has(res.status)) {
+                this.requeue(batch);
+                this.scheduleBackoff(res.retryAfterMs);
+            }
+            else {
+                // Non-retryable (e.g. 400/401/403): dropping is correct — retrying
+                // a malformed/unauthorized request forever would just grow the buffer.
+                this.droppedNonRetryable += batch.length;
+                if (!this.loggedNonRetryable) {
+                    this.loggedNonRetryable = true;
+                    this.onError(`dropping logs — collector returned ${res.status} (non-retryable); check endpoint/token. ` +
+                        `${this.droppedNonRetryable} record(s) dropped so far.`);
+                }
+            }
+        }
+        catch (err) {
+            // Network/timeout error → treat as retryable.
+            this.requeue(batch);
+            this.scheduleBackoff();
+            void err;
+        }
+        finally {
+            this.flushing = false;
+        }
+    }
+    requeue(batch) {
+        this.buffer.unshift(...batch);
+        while (this.buffer.length > this.maxBuffer)
+            this.buffer.shift();
+    }
+    scheduleBackoff(retryAfterMs) {
+        const next = this.backoffMs === 0 ? this.baseBackoffMs : Math.min(this.backoffMs * 2, this.maxBackoffMs);
+        this.backoffMs = next;
+        const jitter = next * 0.2 * Math.random();
+        const delay = retryAfterMs != null ? Math.max(retryAfterMs, next) : next + jitter;
+        this.nextAttemptAt = Date.now() + delay;
+    }
+    async post(body) {
+        const ac = new AbortController();
+        const timer = setTimeout(() => ac.abort(), this.requestTimeoutMs);
+        try {
+            const res = await fetch(this.endpoint, {
+                method: 'POST',
+                headers: this.authHeaders,
+                body,
+                signal: ac.signal,
+            });
+            // Drain the body so the socket can be reused / freed.
+            await res.arrayBuffer().catch(() => { });
+            let retryAfterMs;
+            const ra = res.headers.get('retry-after');
+            if (ra) {
+                const secs = Number(ra);
+                if (!Number.isNaN(secs))
+                    retryAfterMs = secs * 1000;
+            }
+            return { ok: res.ok, status: res.status, retryAfterMs };
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    buildPayload(batch) {
+        return encodeOtlpLogPayload(batch, this.resourceAttrs, this.scopeVersion);
+    }
+}
+/**
+ * PURE OTLP/HTTP logs wire-format encoder (ExportLogsServiceRequest JSON).
+ * Extracted from `OtlpLogWorker` so the protocol/payload shape is independent
+ * from the worker's scheduling + retry/backoff mechanics (review: "OtlpLogWorker
+ * mixes too many concerns") — change the wire shape here without touching the
+ * buffer/timer logic, and vice-versa. No side effects, no `this`.
+ */
+export function encodeOtlpLogPayload(batch, resourceAttrs, scopeVersion) {
+    const logRecords = batch.map(({ r, tsMs }) => {
+        const sev = OTEL_SEVERITY[r.level] ?? OTEL_SEVERITY.info;
+        const nano = String(tsMs * 1_000_000);
+        return {
+            timeUnixNano: nano,
+            observedTimeUnixNano: nano,
+            severityNumber: sev.num,
+            severityText: sev.text,
+            body: { stringValue: r.message },
+            // W3C trace correlation — OTLP top-level fields (hex), not attributes.
+            // Present only when the log was emitted inside a recording span.
+            ...(r.traceId ? { traceId: r.traceId } : {}),
+            ...(r.spanId ? { spanId: r.spanId } : {}),
+            attributes: [
+                attr('dkg.operation_id', r.operationId),
+                attr('dkg.operation_name', r.operationName),
+                attr('dkg.source_operation_id', r.sourceOperationId),
+                attr('dkg.module', r.module),
+            ].filter((a) => a !== null),
+        };
+    });
+    return JSON.stringify({
+        resourceLogs: [
+            {
+                resource: { attributes: resourceAttrs },
+                scopeLogs: [
+                    {
+                        scope: { name: 'dkg-node', version: scopeVersion },
+                        logRecords,
+                    },
+                ],
+            },
+        ],
+    });
+}
+//# sourceMappingURL=otlp-log-worker.js.map

package/dist/otlp-log-worker.js.map

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

package/dist/telemetry-resource.d.ts

@@ -0,0 +1,41 @@
+/**
+ * THE one canonical node-identity → OTel resource-attribute mapping, shared by
+ * BOTH the hand-rolled log exporter (`OtlpLogWorker`) and the OTel SDK bootstrap
+ * (`telemetry.ts`). Keeping a single builder is the whole point: logs, traces,
+ * and metrics describe the same node, so a key/default must change in exactly
+ * one place or Loki labels, trace resources, and metric resources silently drift
+ * apart (review: "resource identity is duplicated between logs and traces/metrics").
+ *
+ * Pure (no OTel SDK, no Node built-ins) → safe to import from anywhere.
+ */
+export interface TelemetryResourceInput {
+    /** OTel service.name. Default 'dkg-node'. */
+    serviceName?: string;
+    /** OTel service.version (node build version). */
+    serviceVersion?: string;
+    /**
+     * Per-node id → service.instance.id (the Grafana node selector / Loki
+     * `service_instance_id` label). Falls back to nodeName then peerId so logs and
+     * traces/metrics resolve the SAME instance id even if a caller omits it.
+     */
+    serviceInstanceId?: string;
+    /** Explicit deployment.environment; defaults to `network` when unset. */
+    deploymentEnvironment?: string;
+    /** testnet | mainnet | devnet → deployment.environment (default) + dkg.network. */
+    network?: string;
+    peerId?: string;
+    nodeName?: string;
+    /** 'core' | 'edge' → dkg.node.role */
+    nodeRole?: string;
+    commit?: string;
+    /** e.g. 'base:8453' → dkg.chain */
+    chainId?: string;
+}
+/**
+ * Build the resource attribute map. Standard OTel keys (service.*, deployment.*)
+ * plus the DKG identity keys (dkg.network, dkg.peer_id, dkg.node.name,
+ * dkg.node.role, dkg.chain, dkg.commit). Unset values are omitted so the
+ * resource never carries empty strings.
+ */
+export declare function buildTelemetryResourceAttrs(r?: TelemetryResourceInput): Record<string, string>;
+//# sourceMappingURL=telemetry-resource.d.ts.map

package/dist/telemetry-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-resource.d.ts","sourceRoot":"","sources":["../src/telemetry-resource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,sBAAsB;IACrC,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,GAAE,sBAA2B,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAclG"}

package/dist/telemetry-resource.js

@@ -0,0 +1,31 @@
+/**
+ * Build the resource attribute map. Standard OTel keys (service.*, deployment.*)
+ * plus the DKG identity keys (dkg.network, dkg.peer_id, dkg.node.name,
+ * dkg.node.role, dkg.chain, dkg.commit). Unset values are omitted so the
+ * resource never carries empty strings.
+ */
+export function buildTelemetryResourceAttrs(r = {}) {
+    const attrs = { 'service.name': r.serviceName || 'dkg-node' };
+    if (r.serviceVersion)
+        attrs['service.version'] = r.serviceVersion;
+    const instanceId = r.serviceInstanceId || r.nodeName || r.peerId;
+    if (instanceId)
+        attrs['service.instance.id'] = instanceId;
+    const env = r.deploymentEnvironment || r.network;
+    if (env)
+        attrs['deployment.environment'] = env;
+    if (r.network)
+        attrs['dkg.network'] = r.network;
+    if (r.peerId)
+        attrs['dkg.peer_id'] = r.peerId;
+    if (r.nodeName)
+        attrs['dkg.node.name'] = r.nodeName;
+    if (r.nodeRole)
+        attrs['dkg.node.role'] = r.nodeRole;
+    if (r.commit)
+        attrs['dkg.commit'] = r.commit;
+    if (r.chainId)
+        attrs['dkg.chain'] = r.chainId;
+    return attrs;
+}
+//# sourceMappingURL=telemetry-resource.js.map

package/dist/telemetry-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-resource.js","sourceRoot":"","sources":["../src/telemetry-resource.ts"],"names":[],"mappings":"AAkCA;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAA4B,EAAE;IACxE,MAAM,KAAK,GAA2B,EAAE,cAAc,EAAE,CAAC,CAAC,WAAW,IAAI,UAAU,EAAE,CAAC;IACtF,IAAI,CAAC,CAAC,cAAc;QAAE,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC;IAClE,MAAM,UAAU,GAAG,CAAC,CAAC,iBAAiB,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC;IACjE,IAAI,UAAU;QAAE,KAAK,CAAC,qBAAqB,CAAC,GAAG,UAAU,CAAC;IAC1D,MAAM,GAAG,GAAG,CAAC,CAAC,qBAAqB,IAAI,CAAC,CAAC,OAAO,CAAC;IACjD,IAAI,GAAG;QAAE,KAAK,CAAC,wBAAwB,CAAC,GAAG,GAAG,CAAC;IAC/C,IAAI,CAAC,CAAC,OAAO;QAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;IAChD,IAAI,CAAC,CAAC,MAAM;QAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,CAAC,CAAC,QAAQ;QAAE,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IACpD,IAAI,CAAC,CAAC,QAAQ;QAAE,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IACpD,IAAI,CAAC,CAAC,MAAM;QAAE,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,IAAI,CAAC,CAAC,OAAO;QAAE,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;IAC9C,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/telemetry.d.ts

@@ -1,12 +1,58 @@
 /**
- * Optional OpenTelemetry integration for the Node UI.
- * When enabled (via config), exports metrics and optionally traces to an OTLP endpoint.
- * operationId is set as the trace/span attribute for correlation with the dashboard.
+ * OpenTelemetry SDK bootstrap for a DKG node (boot side, daemon-only consumer).
  *
- * To enable: add @opentelemetry/api, @opentelemetry/sdk-metrics, and
- * @opentelemetry/exporter-metrics-otlp-http; then implement registerMeter() and
- * use the same metric names below. For traces, use @opentelemetry/sdk-trace-base
- * and set span attributes { 'dkg.operation_id': operationId }.
+ * Registers the global Tracer + Meter providers at daemon startup so that the
+ * call-site facade in `@origintrail-official/dkg-core` (getTracer/withSpan/
+ * getMetrics) — used across agent/publisher/chain/sync — produces real spans and
+ * metrics. When telemetry is disabled, or a signal has no endpoint, this
+ * registers NOTHING: the core facade then talks to the API's built-in no-op
+ * providers (zero cost, no outbound calls).
+ *
+ * Logs are NOT handled here — they stay on the hand-rolled `OtlpLogWorker`
+ * (bounded buffer + retry + at-source redaction); the OTel Logs SDK is still
+ * "Development". This module only wires traces + metrics, and shares ONE
+ * Resource with the log worker so all three signals describe the same node.
+ *
+ * BROWSER SAFETY: the heavy Node-only OTel SDK packages (sdk-trace-node,
+ * sdk-metrics, exporter-*-otlp-proto, resources) and `@origintrail-official/dkg-core`
+ * are loaded via DYNAMIC import inside `initTelemetry`/`shutdownTelemetry`, never
+ * statically. Only `@opentelemetry/api` (browser-safe, no Node built-ins) is a
+ * static import. That keeps this module — and the package root that re-exports
+ * it — free of server-only code in any static bundle graph: a browser bundler
+ * never pulls the Node SDK because it sits behind a runtime `import()` that the
+ * UI never triggers.
+ */
+import { type TelemetryResourceInput } from './telemetry-resource.js';
+/**
+ * Stable resource identity, shared by logs + traces + metrics. Single canonical
+ * type — re-exported alias of `TelemetryResourceInput` (the shared resource
+ * model in ./telemetry-resource) so logs and traces/metrics can't drift.
+ */
+export type TelemetryResource = TelemetryResourceInput;
+export interface OtlpSignalConfig {
+    endpoint?: string;
+    /** Bearer token → Authorization header. */
+    token?: string;
+    headers?: Record<string, string>;
+    /** Per-signal opt-out. A signal is on only when it has an endpoint AND this is not false. */
+    enabled?: boolean;
+}
+export interface TelemetryInitConfig {
+    /** Master gate. When false, nothing is registered. */
+    enabled?: boolean;
+    resource?: TelemetryResource;
+    traces?: OtlpSignalConfig & {
+        sampleRatio?: number;
+    };
+    metrics?: OtlpSignalConfig & {
+        exportIntervalMs?: number;
+    };
+}
+/**
+ * LEGACY config shape (pre-PR #1317 stub). Kept so old JS callers that pass
+ * `{ enabled, metricsEndpoint, serviceName }` keep working — `initTelemetry`
+ * normalizes it into `TelemetryInitConfig` (metricsEndpoint → metrics.endpoint).
+ * @deprecated Use `TelemetryInitConfig` (traces/metrics signal blocks).
  */
 export interface TelemetryConfig {
     enabled?: boolean;
@@ -16,20 +62,33 @@ export interface TelemetryConfig {
     serviceName?: string;
 }
 /**
- * Initialize telemetry. No-op if disabled or OTel packages not installed.
- * Call once at daemon startup.
+ * Initialize traces + metrics. No-op when disabled or when a signal has no
+ * endpoint. Safe to call once at daemon boot. Idempotent (subsequent calls are
+ * ignored once configured). Async because the Node OTel SDK is dynamically
+ * imported (see the BROWSER SAFETY note above).
  */
-export declare function initTelemetry(_config: TelemetryConfig): void;
+export declare function initTelemetry(input: TelemetryInitConfig | TelemetryConfig): Promise<void>;
+/** True once EITHER signal (traces or metrics) has registered a real provider. */
+export declare function isTelemetryConfigured(): boolean;
 /**
- * Record a gauge value for export. No-op when telemetry is disabled.
- * Metric names match dashboard: dkg.network.peers, dkg.knowledge.triples, dkg.system.cpu_percent, etc.
+ * Flush + shut down providers. Used both at daemon teardown AND when telemetry
+ * is turned off via the runtime master gate, so it must FULLY reverse
+ * `initTelemetry`: stop the exporters, then clear the OTel API globals so a
+ * later `initTelemetry` (live re-enable) can register fresh providers — without
+ * the `disable()` calls, the API keeps the first (now shut-down) provider and a
+ * re-enable would silently no-op. Safe if never initialized; idempotent.
+ */
+export declare function shutdownTelemetry(): Promise<void>;
+/**
+ * @deprecated No-op compatibility shim for the pre-PR #1317 telemetry API. Node
+ * metrics flow through the `@origintrail-official/dkg-core` facade
+ * (`getMetrics()`), not this call. Kept so old callers don't break at import.
  */
 export declare function recordGauge(_name: string, _value: number): void;
 /**
- * Start a span for an operation (for trace correlation).
- * operationId should be set as span attribute so traces match the Operations panel.
- * No-op when telemetry is disabled.
+ * @deprecated No-op compatibility shim for the pre-PR #1317 telemetry API. Spans
+ * are created via the core facade `withSpan()`/`getTracer()`. Kept so old
+ * callers don't break at import.
  */
 export declare function setOperationSpan(_operationId: string, _operationName: string): void;
-export declare function isTelemetryConfigured(): boolean;
 //# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAK5D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAG/D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CAGnF;AAED,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C"}
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAA+B,KAAK,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAKnG;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,sBAAsB,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,6FAA6F;IAC7F,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,MAAM,CAAC,EAAE,gBAAgB,GAAG;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,OAAO,CAAC,EAAE,gBAAgB,GAAG;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA+BD;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,mBAAmB,GAAG,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAwD/F;AAED,kFAAkF;AAClF,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAyBvD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CAEnF"}