@origintrail-official/dkg-node-ui 0.0.1-dev.1773506972.23bf9c0

package/dist/operation-tracker.js

@@ -0,0 +1,195 @@
+/**
+ * Records the lifecycle of node operations (publish, query, sync, etc.)
+ * in the dashboard SQLite database. If no DB is configured (e.g. in tests),
+ * all methods are no-ops.
+ */
+export class OperationTracker {
+    db;
+    starts = new Map();
+    phaseStarts = new Map();
+    constructor(db) {
+        this.db = db;
+    }
+    start(ctx, meta) {
+        if (!this.db)
+            return;
+        const now = Date.now();
+        this.starts.set(ctx.operationId, now);
+        try {
+            this.db.insertOperation({
+                operation_id: ctx.operationId,
+                operation_name: ctx.operationName,
+                started_at: now,
+                peer_id: meta?.peerId,
+                paranet_id: meta?.paranetId,
+                details: meta?.details ? JSON.stringify(meta.details) : null,
+            });
+        }
+        catch {
+            // Must never break the node
+        }
+    }
+    complete(ctx, meta) {
+        if (!this.db)
+            return;
+        const startedAt = this.starts.get(ctx.operationId);
+        this.starts.delete(ctx.operationId);
+        try {
+            this.db.completeOperation({
+                operation_id: ctx.operationId,
+                duration_ms: startedAt ? Date.now() - startedAt : 0,
+                triple_count: meta?.tripleCount,
+                details: meta?.details ? JSON.stringify(meta.details) : null,
+            });
+        }
+        catch {
+            // Must never break the node
+        }
+    }
+    fail(ctx, err) {
+        if (!this.db)
+            return;
+        const now = Date.now();
+        const startedAt = this.starts.get(ctx.operationId);
+        this.starts.delete(ctx.operationId);
+        const message = err instanceof Error ? err.message : String(err);
+        try {
+            const prefix = ctx.operationId + ':';
+            const activeKeys = [...this.phaseStarts.keys()].filter(k => k.startsWith(prefix));
+            for (const key of activeKeys) {
+                const phase = key.slice(prefix.length);
+                const phaseStartedAt = this.phaseStarts.get(key);
+                this.phaseStarts.delete(key);
+                this.db.failPhase({
+                    operation_id: ctx.operationId,
+                    phase,
+                    duration_ms: phaseStartedAt ? now - phaseStartedAt : 0,
+                    error_message: message,
+                });
+            }
+            this.db.failOperation({
+                operation_id: ctx.operationId,
+                duration_ms: startedAt ? now - startedAt : 0,
+                error_message: message,
+            });
+        }
+        catch {
+            // Must never break the node
+        }
+    }
+    startPhase(ctx, phase) {
+        if (!this.db)
+            return;
+        const now = Date.now();
+        const key = `${ctx.operationId}:${phase}`;
+        this.phaseStarts.set(key, now);
+        try {
+            this.db.insertPhase({
+                operation_id: ctx.operationId,
+                phase,
+                started_at: now,
+            });
+        }
+        catch {
+            // Must never break the node
+        }
+    }
+    completePhase(ctx, phase) {
+        if (!this.db)
+            return;
+        const key = `${ctx.operationId}:${phase}`;
+        const startedAt = this.phaseStarts.get(key);
+        this.phaseStarts.delete(key);
+        try {
+            this.db.completePhase({
+                operation_id: ctx.operationId,
+                phase,
+                duration_ms: startedAt ? Date.now() - startedAt : 0,
+            });
+        }
+        catch {
+            // Must never break the node
+        }
+    }
+    setCost(ctx, cost) {
+        if (!this.db)
+            return;
+        try {
+            const gasPriceGwei = cost.gasPrice != null
+                ? Number(cost.gasPrice) / 1e9
+                : null;
+            const gasCostEth = cost.gasCost != null
+                ? Number(cost.gasCost) / 1e18
+                : null;
+            const tracCost = cost.tracCost != null
+                ? Number(cost.tracCost) / 1e18
+                : null;
+            this.db.setOperationCost({
+                operation_id: ctx.operationId,
+                gas_used: cost.gasUsed != null ? Number(cost.gasUsed) : null,
+                gas_price_gwei: gasPriceGwei,
+                gas_cost_eth: gasCostEth,
+                trac_cost: tracCost,
+            });
+        }
+        catch {
+            // Must never break the node
+        }
+    }
+    setTxHash(ctx, txHash, chainId) {
+        if (!this.db || !txHash)
+            return;
+        try {
+            this.db.setOperationCost({
+                operation_id: ctx.operationId,
+                tx_hash: txHash,
+                chain_id: chainId ?? null,
+            });
+        }
+        catch {
+            // Must never break the node
+        }
+    }
+    /**
+     * Execute `fn` as a tracked phase — no timing gaps, no forgotten end calls.
+     * On success completes the phase; on error fails the phase and re-throws.
+     */
+    async trackPhase(ctx, phase, fn) {
+        this.startPhase(ctx, phase);
+        try {
+            const result = await fn();
+            this.completePhase(ctx, phase);
+            return result;
+        }
+        catch (err) {
+            if (this.db) {
+                const key = `${ctx.operationId}:${phase}`;
+                const startedAt = this.phaseStarts.get(key);
+                this.phaseStarts.delete(key);
+                try {
+                    this.db.failPhase({
+                        operation_id: ctx.operationId,
+                        phase,
+                        duration_ms: startedAt ? Date.now() - startedAt : 0,
+                        error_message: err instanceof Error ? err.message : String(err),
+                    });
+                }
+                catch { /* never crash */ }
+            }
+            throw err;
+        }
+    }
+    /**
+     * Create an onPhase callback wired to this tracker instance.
+     * Pass this to DKGAgent/Publisher methods that accept `onPhase`.
+     */
+    phaseCallback(ctx) {
+        return (phase, status) => {
+            if (status === 'start')
+                this.startPhase(ctx, phase);
+            else
+                this.completePhase(ctx, phase);
+        };
+    }
+}
+//# sourceMappingURL=operation-tracker.js.map

package/dist/operation-tracker.js.map

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

package/dist/structured-logger.d.ts

@@ -0,0 +1,16 @@
+import { Logger, type OperationContext } from '@origintrail-official/dkg-core';
+import type { DashboardDB } from './db.js';
+/**
+ * Drop-in replacement for Logger that also writes structured log
+ * entries to the dashboard SQLite database. Existing stdout/stderr
+ * output is preserved — the DB write is a side-effect.
+ */
+export declare class StructuredLogger extends Logger {
+    private readonly db;
+    constructor(moduleName: string, db: DashboardDB);
+    info(ctx: OperationContext, message: string): void;
+    warn(ctx: OperationContext, message: string): void;
+    error(ctx: OperationContext, message: string): void;
+    private persist;
+}
+//# sourceMappingURL=structured-logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"structured-logger.d.ts","sourceRoot":"","sources":["../src/structured-logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,MAAM;IAGxC,OAAO,CAAC,QAAQ,CAAC,EAAE;gBADnB,UAAU,EAAE,MAAM,EACD,EAAE,EAAE,WAAW;IAKzB,IAAI,CAAC,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAKlD,IAAI,CAAC,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAKlD,KAAK,CAAC,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAK5D,OAAO,CAAC,OAAO;CAchB"}

package/dist/structured-logger.js

@@ -0,0 +1,41 @@
+import { Logger } from '@origintrail-official/dkg-core';
+/**
+ * Drop-in replacement for Logger that also writes structured log
+ * entries to the dashboard SQLite database. Existing stdout/stderr
+ * output is preserved — the DB write is a side-effect.
+ */
+export class StructuredLogger extends Logger {
+    db;
+    constructor(moduleName, db) {
+        super(moduleName);
+        this.db = db;
+    }
+    info(ctx, message) {
+        super.info(ctx, message);
+        this.persist('info', ctx, message);
+    }
+    warn(ctx, message) {
+        super.warn(ctx, message);
+        this.persist('warn', ctx, message);
+    }
+    error(ctx, message) {
+        super.error(ctx, message);
+        this.persist('error', ctx, message);
+    }
+    persist(level, ctx, message) {
+        try {
+            this.db.insertLog({
+                ts: Date.now(),
+                level,
+                operation_name: ctx.operationName,
+                operation_id: ctx.operationId,
+                module: this.moduleName ?? 'unknown',
+                message,
+            });
+        }
+        catch {
+            // DB write failures must never break the node
+        }
+    }
+}
+//# sourceMappingURL=structured-logger.js.map

package/dist/structured-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-logger.js","sourceRoot":"","sources":["../src/structured-logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAyB,MAAM,gCAAgC,CAAC;AAG/E;;;;GAIG;AACH,MAAM,OAAO,gBAAiB,SAAQ,MAAM;IAGvB;IAFnB,YACE,UAAkB,EACD,EAAe;QAEhC,KAAK,CAAC,UAAU,CAAC,CAAC;QAFD,OAAE,GAAF,EAAE,CAAa;IAGlC,CAAC;IAEQ,IAAI,CAAC,GAAqB,EAAE,OAAe;QAClD,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAEQ,IAAI,CAAC,GAAqB,EAAE,OAAe;QAClD,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAEQ,KAAK,CAAC,GAAqB,EAAE,OAAe;QACnD,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC1B,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAEO,OAAO,CAAC,KAAa,EAAE,GAAqB,EAAE,OAAe;QACnE,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC;gBAChB,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;gBACd,KAAK;gBACL,cAAc,EAAE,GAAG,CAAC,aAAa;gBACjC,YAAY,EAAE,GAAG,CAAC,WAAW;gBAC7B,MAAM,EAAG,IAAY,CAAC,UAAU,IAAI,SAAS;gBAC7C,OAAO;aACR,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,8CAA8C;QAChD,CAAC;IACH,CAAC;CACF"}

package/dist/telemetry.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 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.
+ *
+ * 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 }.
+ */
+export interface TelemetryConfig {
+    enabled?: boolean;
+    /** OTLP HTTP endpoint for metrics (e.g. http://localhost:4318/v1/metrics) */
+    metricsEndpoint?: string;
+    /** Service name for resource attributes */
+    serviceName?: string;
+}
+/**
+ * Initialize telemetry. No-op if disabled or OTel packages not installed.
+ * Call once at daemon startup.
+ */
+export declare function initTelemetry(_config: TelemetryConfig): void;
+/**
+ * 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.
+ */
+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.
+ */
+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

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

package/dist/telemetry.js

@@ -0,0 +1,45 @@
+/**
+ * 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.
+ *
+ * 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 }.
+ */
+let configured = false;
+/**
+ * Initialize telemetry. No-op if disabled or OTel packages not installed.
+ * Call once at daemon startup.
+ */
+export function initTelemetry(_config) {
+    if (!_config.enabled || !_config.metricsEndpoint)
+        return;
+    configured = true;
+    // When OTel is added: create MeterProvider, OTLP exporter, register gauges
+    // meter.createObservableGauge('dkg.network.peers', ...), etc.
+}
+/**
+ * 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.
+ */
+export function recordGauge(_name, _value) {
+    if (!configured)
+        return;
+    // When OTel is added: update the observable gauge callback or record value
+}
+/**
+ * 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.
+ */
+export function setOperationSpan(_operationId, _operationName) {
+    if (!configured)
+        return;
+    // When OTel is added: tracer.startSpan(operationName, { attributes: { 'dkg.operation_id': operationId } })
+}
+export function isTelemetryConfigured() {
+    return configured;
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAwB;IACpD,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe;QAAE,OAAO;IACzD,UAAU,GAAG,IAAI,CAAC;IAClB,2EAA2E;IAC3E,8DAA8D;AAChE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,MAAc;IACvD,IAAI,CAAC,UAAU;QAAE,OAAO;IACxB,2EAA2E;AAC7E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,YAAoB,EAAE,cAAsB;IAC3E,IAAI,CAAC,UAAU;QAAE,OAAO;IACxB,2GAA2G;AAC7G,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,UAAU,CAAC;AACpB,CAAC"}