@zintrust/core 0.1.42 → 0.1.43

package/packages/workers/src/telemetry/api/TelemetryMonitoringService.js

@@ -0,0 +1,140 @@
+import { Logger, NodeSingletons } from '../../../../../src/index.js';
+const createFallbackEmitter = () => {
+    const listeners = new Map();
+    return {
+        on(event, listener) {
+            const set = listeners.get(event) ?? new Set();
+            set.add(listener);
+            listeners.set(event, set);
+        },
+        off(event, listener) {
+            const set = listeners.get(event);
+            if (!set)
+                return;
+            set.delete(listener);
+            if (set.size === 0)
+                listeners.delete(event);
+        },
+        emit(event, payload) {
+            const set = listeners.get(event);
+            if (!set)
+                return false;
+            for (const listener of set)
+                listener(payload);
+            return true;
+        },
+    };
+};
+// Internal state for singleton service
+const EventEmitterCtor = NodeSingletons?.EventEmitter;
+const emitter = typeof EventEmitterCtor === 'function' ? new EventEmitterCtor() : createFallbackEmitter();
+emitter.setMaxListeners?.(Infinity);
+let interval = null;
+let subscribers = 0;
+let currentSettings = null;
+let currentBuildSnapshot = null;
+const broadcastTelemetrySnapshot = async () => {
+    try {
+        if (subscribers <= 0 || !currentBuildSnapshot || !currentSettings)
+            return;
+        const snapshot = await currentBuildSnapshot();
+        const payload = {
+            type: 'snapshot',
+            ts: new Date().toISOString(),
+            ...snapshot,
+        };
+        emitter.emit('snapshot', payload);
+    }
+    catch (err) {
+        Logger.error('TelemetryMonitoringService.broadcastSnapshot failed', err);
+        emitter.emit('error', err);
+    }
+};
+const startPolling = () => {
+    if (interval || !currentSettings)
+        return;
+    Logger.debug('Starting TelemetryMonitoringService polling');
+    // Initial fetch
+    void broadcastTelemetrySnapshot();
+    interval = setInterval(() => {
+        void broadcastTelemetrySnapshot();
+    }, currentSettings.refreshIntervalMs);
+};
+const stopPolling = () => {
+    if (interval) {
+        Logger.debug('Stopping TelemetryMonitoringService polling');
+        clearInterval(interval);
+        interval = null;
+    }
+};
+export const TelemetryMonitoringService = Object.freeze({
+    subscribe(callback) {
+        emitter.on('snapshot', callback);
+        subscribers++;
+        if (subscribers === 1) {
+            startPolling();
+        }
+    },
+    unsubscribe(callback) {
+        emitter.off('snapshot', callback);
+        subscribers--;
+        if (subscribers <= 0) {
+            stopPolling();
+            currentSettings = null;
+            currentBuildSnapshot = null;
+        }
+    },
+    startMonitoring(settings, buildSnapshot) {
+        if (subscribers === 0) {
+            currentSettings = settings;
+            currentBuildSnapshot = buildSnapshot;
+        }
+    },
+    stopMonitoring() {
+        if (subscribers <= 0) {
+            stopPolling();
+            currentSettings = null;
+            currentBuildSnapshot = null;
+        }
+    },
+});
+export const teleStream = async (res, settings, buildSnapshot) => {
+    const raw = res.getRaw();
+    raw.writeHead(200, {
+        'Content-Type': 'text/event-stream',
+        'Cache-Control': 'no-cache, no-transform',
+        Connection: 'keep-alive',
+        'X-Accel-Buffering': 'no',
+    });
+    let closed = false;
+    const send = async (payload) => {
+        try {
+            raw.write(`data: ${JSON.stringify(payload)}\n\n`);
+        }
+        catch (err) {
+            Logger.error('Telemetry SSE send failed', err);
+        }
+    };
+    // Send hello immediately
+    await send({ type: 'hello', ts: new Date().toISOString() });
+    // Start monitoring with the singleton service
+    TelemetryMonitoringService.startMonitoring(settings, buildSnapshot);
+    // Subscribe to telemetry snapshots
+    const onSnapshot = (data) => {
+        if (!closed) {
+            void send(data);
+        }
+    };
+    TelemetryMonitoringService.subscribe(onSnapshot);
+    // Heartbeat to keep connection alive
+    const hb = setInterval(() => {
+        if (!closed)
+            raw.write(': ping\n\n');
+    }, 15000);
+    raw.on('close', () => {
+        closed = true;
+        clearInterval(hb);
+        TelemetryMonitoringService.unsubscribe(onSnapshot);
+        TelemetryMonitoringService.stopMonitoring();
+    });
+};

package/packages/workers/src/telemetry/components/AlertPanel.d.ts

@@ -0,0 +1,2 @@
+export declare const renderAlertPanel: () => string;
+//# sourceMappingURL=AlertPanel.d.ts.map

package/packages/workers/src/telemetry/components/AlertPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AlertPanel.d.ts","sourceRoot":"","sources":["../../../../../../packages/workers/src/telemetry/components/AlertPanel.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,QAAO,MAYnC,CAAC"}

package/packages/workers/src/telemetry/components/AlertPanel.js

@@ -0,0 +1,13 @@
+export const renderAlertPanel = () => {
+    return `
+    <div class="zt-card">
+      <div class="zt-card-header">
+        <h3 class="zt-card-title">Alert History</h3>
+        <span class="zt-card-meta">Latest events</span>
+      </div>
+      <ul id="alertList" class="zt-alert-list">
+        <li class="zt-alert-item">No alerts yet.</li>
+      </ul>
+    </div>
+  `;
+};

package/packages/workers/src/telemetry/components/CostTracking.d.ts

@@ -0,0 +1,2 @@
+export declare const renderCostTracking: () => string;
+//# sourceMappingURL=CostTracking.d.ts.map

package/packages/workers/src/telemetry/components/CostTracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CostTracking.d.ts","sourceRoot":"","sources":["../../../../../../packages/workers/src/telemetry/components/CostTracking.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,QAAO,MAarC,CAAC"}

package/packages/workers/src/telemetry/components/CostTracking.js

@@ -0,0 +1,14 @@
+export const renderCostTracking = () => {
+    return `
+    <div class="zt-card">
+      <div class="zt-card-header">
+        <h3 class="zt-card-title">Cost Tracking</h3>
+        <span class="zt-card-meta">Daily estimate</span>
+      </div>
+      <div class="zt-card-body">
+        <p class="zt-cost-value" id="costTotal">$0.00</p>
+        <p class="zt-card-meta">Auto-updated from resource metrics</p>
+      </div>
+    </div>
+  `;
+};

package/packages/workers/src/telemetry/components/ResourceUsageChart.d.ts

@@ -0,0 +1,2 @@
+export declare const renderResourceUsageChart: () => string;
+//# sourceMappingURL=ResourceUsageChart.d.ts.map

package/packages/workers/src/telemetry/components/ResourceUsageChart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceUsageChart.d.ts","sourceRoot":"","sources":["../../../../../../packages/workers/src/telemetry/components/ResourceUsageChart.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,QAAO,MAU3C,CAAC"}

package/packages/workers/src/telemetry/components/ResourceUsageChart.js

@@ -0,0 +1,11 @@
+export const renderResourceUsageChart = () => {
+    return `
+    <div class="zt-card">
+      <div class="zt-card-header">
+        <h3 class="zt-card-title">Resource Usage</h3>
+        <span class="zt-card-meta">Current snapshot</span>
+      </div>
+      <canvas id="resourceUsageChart" class="zt-chart"></canvas>
+    </div>
+  `;
+};

package/packages/workers/src/telemetry/components/WorkerHealthChart.d.ts

@@ -0,0 +1,2 @@
+export declare const renderWorkerHealthChart: () => string;
+//# sourceMappingURL=WorkerHealthChart.d.ts.map

package/packages/workers/src/telemetry/components/WorkerHealthChart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerHealthChart.d.ts","sourceRoot":"","sources":["../../../../../../packages/workers/src/telemetry/components/WorkerHealthChart.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,QAAO,MAU1C,CAAC"}

package/packages/workers/src/telemetry/components/WorkerHealthChart.js

@@ -0,0 +1,11 @@
+export const renderWorkerHealthChart = () => {
+    return `
+    <div class="zt-card">
+      <div class="zt-card-header">
+        <h3 class="zt-card-title">Worker Health</h3>
+        <span class="zt-card-meta">Last 24h</span>
+      </div>
+      <canvas id="workerHealthChart" class="zt-chart"></canvas>
+    </div>
+  `;
+};

package/packages/workers/src/telemetry/index.d.ts

@@ -0,0 +1,16 @@
+import type { IRouter } from '../../../../src/index.js';
+export type TelemetryDashboardConfig = {
+    enabled?: boolean;
+    basePath?: string;
+    middleware?: ReadonlyArray<string>;
+    autoRefresh?: boolean;
+    refreshIntervalMs?: number;
+};
+export type TelemetryDashboardApi = {
+    registerRoutes: (router: IRouter) => void;
+};
+export declare const TelemetryDashboard: Readonly<{
+    create(config: TelemetryDashboardConfig): TelemetryDashboardApi;
+}>;
+export default TelemetryDashboard;
+//# sourceMappingURL=index.d.ts.map

package/packages/workers/src/telemetry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/workers/src/telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAuB,OAAO,EAAgB,MAAM,gBAAgB,CAAC;AAOjF,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AASF,MAAM,MAAM,qBAAqB,GAAG;IAClC,cAAc,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CAC3C,CAAC;AAEF,eAAO,MAAM,kBAAkB;mBACd,wBAAwB,GAAG,qBAAqB;EAO/D,CAAC;AAsFH,eAAe,kBAAkB,CAAC"}

package/packages/workers/src/telemetry/index.js

@@ -0,0 +1,60 @@
+import { Router } from '../../../../src/index.js';
+import { createSnapshotBuilder } from './api/TelemetryAPI.js';
+import { teleStream } from './api/TelemetryMonitoringService.js';
+import { getDashboardHtml } from './routes/dashboard.js';
+const DEFAULTS = {
+    enabled: true,
+    basePath: '/telemetry',
+    autoRefresh: true,
+    refreshIntervalMs: 10000,
+};
+export const TelemetryDashboard = Object.freeze({
+    create(config) {
+        const settings = buildSettings(config);
+        const buildSnapshot = createSnapshotBuilder();
+        const registerRoutes = createRouteRegistrar(settings, buildSnapshot);
+        return Object.freeze({ registerRoutes });
+    },
+});
+function buildSettings(config) {
+    return {
+        enabled: config.enabled ?? DEFAULTS.enabled,
+        basePath: config.basePath ?? DEFAULTS.basePath,
+        middleware: config.middleware ?? [],
+        autoRefresh: config.autoRefresh ?? DEFAULTS.autoRefresh,
+        refreshIntervalMs: typeof config.refreshIntervalMs === 'number' && Number.isFinite(config.refreshIntervalMs)
+            ? Math.max(1000, Math.floor(config.refreshIntervalMs))
+            : DEFAULTS.refreshIntervalMs,
+    };
+}
+function createRouteRegistrar(settings, buildSnapshot) {
+    return (router) => {
+        if (!settings.enabled)
+            return;
+        const routeOptions = (settings.middleware.length > 0 ? { middleware: settings.middleware } : undefined);
+        registerDashboardRoute(router, settings, routeOptions);
+        registerSummaryApi(router, settings, routeOptions, buildSnapshot);
+        registerEventsApi(router, settings, routeOptions, buildSnapshot);
+    };
+}
+function registerDashboardRoute(router, settings, routeOptions) {
+    Router.get(router, settings.basePath, (_req, res) => {
+        res.html(getDashboardHtml({
+            basePath: settings.basePath,
+            autoRefresh: settings.autoRefresh,
+            refreshIntervalMs: settings.refreshIntervalMs,
+        }));
+    }, routeOptions);
+}
+function registerSummaryApi(router, settings, routeOptions, buildSnapshot) {
+    Router.get(router, `${settings.basePath}/api/summary`, async (_req, res) => {
+        const snapshot = await buildSnapshot();
+        res.json(snapshot);
+    }, routeOptions);
+}
+function registerEventsApi(router, settings, routeOptions, buildSnapshot) {
+    Router.get(router, `${settings.basePath}/api/events`, async (_req, res) => {
+        teleStream(res, settings, buildSnapshot);
+    }, routeOptions);
+}
+export default TelemetryDashboard;

package/packages/workers/src/telemetry/routes/dashboard.d.ts

@@ -0,0 +1,7 @@
+export type DashboardUiOptions = {
+    basePath: string;
+    autoRefresh: boolean;
+    refreshIntervalMs: number;
+};
+export declare const getDashboardHtml: (options: DashboardUiOptions) => string;
+//# sourceMappingURL=dashboard.d.ts.map

package/packages/workers/src/telemetry/routes/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../../../../../packages/workers/src/telemetry/routes/dashboard.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AA6mBF,eAAO,MAAM,gBAAgB,GAAI,SAAS,kBAAkB,KAAG,MAOvD,CAAC"}