@wizeworks/lens-node 0.0.0-stage → 0.3.0-alpha.2

package/dist/metrics/otel.js

@@ -0,0 +1,62 @@
+import { toAttributeValue } from "@wizeworks/lens-core";
+import { metricsOf } from "../adapters/registry.js";
+import { exponentialToExplicit } from "./exponential.js";
+// sdk-metrics enums: DataPointType and AggregationTemporality.
+const HISTOGRAM = 0;
+const EXPONENTIAL = 1;
+const SUM = 3;
+const DELTA = 0;
+const toMs = (t) => (t ? t[0] * 1000 + t[1] / 1e6 : undefined);
+function attributesOf(raw) {
+    const out = {};
+    for (const [k, v] of Object.entries(raw ?? {}))
+        out[k] = toAttributeValue(v);
+    return out;
+}
+function histogramOf(type, v) {
+    const explicit = type === EXPONENTIAL ? exponentialToExplicit(v) : { bounds: [...(v.buckets?.boundaries ?? [])], counts: [...(v.buckets?.counts ?? [])] };
+    return { count: Number(v.count ?? 0), sum: Number(v.sum ?? 0), min: v.min ?? null, max: v.max ?? null, ...explicit };
+}
+function pointOf(m, d) {
+    const type = m.dataPointType ?? 2;
+    const histogram = type === HISTOGRAM || type === EXPONENTIAL;
+    const timeMs = toMs(d.endTime);
+    if (timeMs === undefined || (!histogram && typeof d.value !== "number"))
+        return null;
+    const p = { name: m.descriptor?.name ?? "", kind: histogram ? "histogram" : type === SUM ? "sum" : "gauge", unit: m.descriptor?.unit ?? "", service: "", attributes: attributesOf(d.attributes), timeMs };
+    if (m.descriptor?.description)
+        p.description = m.descriptor.description;
+    if (p.kind === "sum")
+        p.monotonic = !!m.isMonotonic;
+    if (p.kind !== "gauge")
+        p.temporality = m.aggregationTemporality === DELTA ? "delta" : "cumulative";
+    const startMs = toMs(d.startTime);
+    if (startMs !== undefined)
+        p.startMs = startMs;
+    if (histogram)
+        p.histogram = histogramOf(type, d.value);
+    else
+        p.value = d.value;
+    return p.name ? p : null;
+}
+/** OpenTelemetry SDK metrics as WizeLens points. */
+export function pointsFromSdk(rm) {
+    return (rm.scopeMetrics ?? []).flatMap((sm) => (sm.metrics ?? []).flatMap((m) => (m.dataPoints ?? []).flatMap((d) => pointOf(m, d) ?? [])));
+}
+/** An OpenTelemetry exporter for app metrics: `new PeriodicExportingMetricReader({ exporter: wizelensMetricExporter(wizelens) })`. */
+export function wizelensMetricExporter(wizelens) {
+    return {
+        export(metrics, resultCallback) {
+            try {
+                metricsOf(wizelens)?.add(pointsFromSdk(metrics));
+                resultCallback({ code: 0 });
+            }
+            catch (err) {
+                resultCallback({ code: 1, error: err instanceof Error ? err : new Error(String(err)) });
+            }
+        },
+        forceFlush: async () => { },
+        shutdown: async () => { },
+    };
+}
+//# sourceMappingURL=otel.js.map

package/dist/metrics/otel.js.map

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

package/dist/metrics/runtime.d.ts

@@ -0,0 +1,17 @@
+import type { MetricPoint } from "@wizeworks/lens-core";
+export interface RuntimeCollectorOptions {
+    /** How often to sample. Default 10000 ms. */
+    intervalMs?: number;
+    add: (points: MetricPoint[]) => void;
+    now?: () => number;
+}
+/** Samples CPU, memory, heap, event loop, and GC every interval. Never traced, never keeps the process alive. */
+export declare class RuntimeCollector {
+    #private;
+    constructor(options: RuntimeCollectorOptions);
+    start(): void;
+    /** One round of runtime points. Rates cover the time since the last round. */
+    sample(): MetricPoint[];
+    stop(): void;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/metrics/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/metrics/runtime.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGpE,MAAM,WAAW,uBAAuB;IACtC,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IACrC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AA6BD,iHAAiH;AACjH,qBAAa,gBAAgB;;IAU3B,YAAY,OAAO,EAAE,uBAAuB,EAK3C;IAED,KAAK,IAAI,IAAI,CAUZ;IAED,8EAA8E;IAC9E,MAAM,IAAI,WAAW,EAAE,CAqBtB;IAcD,IAAI,IAAI,IAAI,CAKX;CACF"}

package/dist/metrics/runtime.js

@@ -0,0 +1,100 @@
+import { availableParallelism } from "node:os";
+import { monitorEventLoopDelay, PerformanceObserver, performance } from "node:perf_hooks";
+import { getHeapStatistics } from "node:v8";
+import { context, ROOT_CONTEXT } from "@opentelemetry/api";
+import { GcHistogram } from "./gc.js";
+const gauge = (name, unit, value, timeMs, description, attributes = {}) => ({
+    name,
+    kind: "gauge",
+    unit,
+    description,
+    service: "",
+    attributes,
+    timeMs,
+    value,
+});
+const cpuTime = (mode, seconds, timeMs, startMs) => ({
+    name: "process.cpu.time",
+    kind: "sum",
+    unit: "s",
+    description: "Total CPU seconds by mode.",
+    service: "",
+    monotonic: true,
+    temporality: "cumulative",
+    attributes: { "cpu.mode": mode },
+    timeMs,
+    startMs,
+    value: seconds,
+});
+/** Samples CPU, memory, heap, event loop, and GC every interval. Never traced, never keeps the process alive. */
+export class RuntimeCollector {
+    #o;
+    #now;
+    #gc = new GcHistogram();
+    #startMs;
+    #loop;
+    #observer;
+    #timer;
+    #last;
+    constructor(options) {
+        this.#o = options;
+        this.#now = options.now ?? Date.now;
+        this.#startMs = this.#now() - process.uptime() * 1000;
+        this.#last = { cpu: process.cpuUsage(), atMs: this.#now(), elu: performance.eventLoopUtilization() };
+    }
+    start() {
+        if (this.#timer)
+            return;
+        context.with(ROOT_CONTEXT, () => {
+            this.#loop = monitorEventLoopDelay({ resolution: 20 });
+            this.#loop.enable();
+            this.#observer = new PerformanceObserver((list) => list.getEntries().forEach((e) => this.#gc.record(e)));
+            this.#observer.observe({ entryTypes: ["gc"] });
+            this.#timer = setInterval(() => context.with(ROOT_CONTEXT, () => this.#o.add(this.sample())), this.#o.intervalMs ?? 10_000);
+            this.#timer.unref?.();
+        });
+    }
+    /** One round of runtime points. Rates cover the time since the last round. */
+    sample() {
+        const now = this.#now();
+        const cpu = process.cpuUsage();
+        const elu = performance.eventLoopUtilization();
+        const last = this.#last;
+        const wallS = Math.max(0.001, (now - last.atMs) / 1000);
+        const cpuS = (cpu.user - last.cpu.user + cpu.system - last.cpu.system) / 1e6;
+        const heap = getHeapStatistics();
+        const points = [
+            gauge("process.cpu.utilization", "1", cpuS / wallS / availableParallelism(), now, "CPU used by the process, as a share of all CPUs."),
+            cpuTime("user", cpu.user / 1e6, now, this.#startMs),
+            cpuTime("system", cpu.system / 1e6, now, this.#startMs),
+            gauge("process.memory.usage", "By", process.memoryUsage.rss(), now, "Resident memory of the process."),
+            gauge("v8js.memory.heap.used", "By", heap.used_heap_size, now, "V8 heap in use."),
+            gauge("v8js.memory.heap.limit", "By", heap.heap_size_limit, now, "V8 heap size limit."),
+            gauge("nodejs.eventloop.utilization", "1", performance.eventLoopUtilization(elu, last.elu).utilization, now, "Share of time the event loop was busy."),
+            ...this.#loopPoints(now),
+            ...this.#gc.drain(last.atMs, now),
+        ];
+        this.#last = { cpu, atMs: now, elu };
+        return points;
+    }
+    #loopPoints(now) {
+        const h = this.#loop;
+        if (!h || h.count === 0)
+            return [];
+        const points = [
+            gauge("nodejs.eventloop.delay.p50", "s", h.percentile(50) / 1e9, now, "Event loop delay, median."),
+            gauge("nodejs.eventloop.delay.p99", "s", h.percentile(99) / 1e9, now, "Event loop delay, 99th percentile."),
+            gauge("nodejs.eventloop.delay.max", "s", h.max / 1e9, now, "Event loop delay, longest."),
+        ];
+        h.reset();
+        return points;
+    }
+    stop() {
+        if (this.#timer)
+            clearInterval(this.#timer);
+        this.#timer = undefined;
+        this.#loop?.disable();
+        this.#observer?.disconnect();
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/metrics/runtime.js.map

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

package/dist/metrics/setup.d.ts

@@ -0,0 +1,13 @@
+import type { McpDataSource } from "../mcp-shared.js";
+import type { WizeLensOptions } from "../types.js";
+import { RuntimeCollector } from "./runtime.js";
+import { MetricStore } from "./store.js";
+export interface MetricParts {
+    store: MetricStore;
+    collector: RuntimeCollector;
+}
+/** The metric store and runtime collector, or null when `captureMetrics` is false. Call `start` on the collector. */
+export declare function createMetricParts(o: WizeLensOptions, redactKeys: readonly string[]): MetricParts | null;
+/** The MCP metric tools' view of the store. */
+export declare function mcpMetrics(store: MetricStore | null): Pick<McpDataSource, "metrics" | "metricRanges">;
+//# sourceMappingURL=setup.d.ts.map

package/dist/metrics/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/metrics/setup.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AAED,qHAAqH;AACrH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,GAAG,IAAI,CAKvG;AAKD,+CAA+C;AAC/C,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,cAAc,CAAC,CAGrG"}

package/dist/metrics/setup.js

@@ -0,0 +1,20 @@
+import { metricsModel } from "@wizeworks/lens-core";
+import { RuntimeCollector } from "./runtime.js";
+import { MetricStore } from "./store.js";
+/** The metric store and runtime collector, or null when `captureMetrics` is false. Call `start` on the collector. */
+export function createMetricParts(o, redactKeys) {
+    if (o.captureMetrics === false)
+        return null;
+    const store = new MetricStore({ service: o.serviceName, redactKeys, maxAgeMs: o.metricsMaxAgeMs });
+    const collector = new RuntimeCollector({ intervalMs: o.metricsIntervalMs, add: (points) => void store.add(points) });
+    return { store, collector };
+}
+/** In-app ranges: the add-on keeps an hour by default. */
+const IN_APP_RANGES = ["15m", "1h"];
+/** The MCP metric tools' view of the store. */
+export function mcpMetrics(store) {
+    if (!store)
+        return {};
+    return { metrics: (range, params) => metricsModel({ points: store.all(), range, now: Date.now(), params }), metricRanges: IN_APP_RANGES };
+}
+//# sourceMappingURL=setup.js.map

package/dist/metrics/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/metrics/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAkB,MAAM,sBAAsB,CAAC;AAGpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAOzC,qHAAqH;AACrH,MAAM,UAAU,iBAAiB,CAAC,CAAkB,EAAE,UAA6B;IACjF,IAAI,CAAC,CAAC,cAAc,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAC5C,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;IACnG,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,iBAAiB,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACrH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC9B,CAAC;AAED,0DAA0D;AAC1D,MAAM,aAAa,GAAyB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAE1D,+CAA+C;AAC/C,MAAM,UAAU,UAAU,CAAC,KAAyB;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC;AAC5I,CAAC"}

package/dist/metrics/store.d.ts

@@ -0,0 +1,34 @@
+import { type MetricPoint } from "@wizeworks/lens-core";
+export interface MetricStoreOptions {
+    service: string;
+    redactKeys: readonly string[];
+    /** Oldest point kept, in ms. Default 1 h. */
+    maxAgeMs?: number;
+    /** Most points kept. The oldest are dropped first. Default 50000. */
+    maxPoints?: number;
+    /** Most series kept. Points of new series past it are dropped. Default 1000. */
+    maxSeries?: number;
+    now?: () => number;
+}
+export type MetricListener = (points: readonly MetricPoint[]) => void;
+export declare const MAX_METRIC_POINTS = 50000;
+/** The add-on's metrics: a time-ordered window of points, in memory only. */
+export declare class MetricStore {
+    #private;
+    readonly maxAgeMs: number;
+    readonly maxPoints: number;
+    readonly maxSeries: number;
+    dropped: number;
+    constructor(options: MetricStoreOptions);
+    get size(): number;
+    get seriesCount(): number;
+    subscribe(listener: MetricListener): () => void;
+    /** Check, redact, and keep points. Returns the ones kept. */
+    add(raw: readonly unknown[]): MetricPoint[];
+    /** Drop points past the age or count limit. */
+    prune(): void;
+    /** Points at or after `sinceMs`, oldest first, at most `limit` (the newest are kept). */
+    since(sinceMs?: number, limit?: number): MetricPoint[];
+    all(): readonly MetricPoint[];
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/metrics/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/metrics/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAoC,MAAM,sBAAsB,CAAC;AAE1F,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,KAAK,IAAI,CAAC;AAEtE,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAExC,6EAA6E;AAC7E,qBAAa,WAAW;;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAM3B,OAAO,SAAK;IAEZ,YAAY,OAAO,EAAE,kBAAkB,EAMtC;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,SAAS,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI,CAG9C;IAED,6DAA6D;IAC7D,GAAG,CAAC,GAAG,EAAE,SAAS,OAAO,EAAE,GAAG,WAAW,EAAE,CAY1C;IAsBD,+CAA+C;IAC/C,KAAK,IAAI,IAAI,CAMZ;IAED,yFAAyF;IACzF,KAAK,CAAC,OAAO,SAAI,EAAE,KAAK,SAAoB,GAAG,WAAW,EAAE,CAM3D;IAED,GAAG,IAAI,SAAS,WAAW,EAAE,CAG5B;CACF"}

package/dist/metrics/store.js

@@ -0,0 +1,94 @@
+import { sanitizeMetricPoint, seriesKeyOf } from "@wizeworks/lens-core";
+export const MAX_METRIC_POINTS = 50_000;
+/** The add-on's metrics: a time-ordered window of points, in memory only. */
+export class MetricStore {
+    maxAgeMs;
+    maxPoints;
+    maxSeries;
+    #o;
+    #now;
+    #listeners = new Set();
+    #series = new Map();
+    #points = [];
+    dropped = 0;
+    constructor(options) {
+        this.#o = options;
+        this.maxAgeMs = Math.max(60_000, options.maxAgeMs ?? 60 * 60_000);
+        this.maxPoints = Math.max(100, options.maxPoints ?? MAX_METRIC_POINTS);
+        this.maxSeries = Math.max(1, options.maxSeries ?? 1000);
+        this.#now = options.now ?? Date.now;
+    }
+    get size() {
+        return this.#points.length;
+    }
+    get seriesCount() {
+        return this.#series.size;
+    }
+    subscribe(listener) {
+        this.#listeners.add(listener);
+        return () => void this.#listeners.delete(listener);
+    }
+    /** Check, redact, and keep points. Returns the ones kept. */
+    add(raw) {
+        const kept = [];
+        for (const r of raw) {
+            const p = sanitizeMetricPoint(r, this.#o.redactKeys, this.#o.service);
+            if (p && this.#track(p))
+                kept.push(p);
+        }
+        if (kept.length === 0)
+            return kept;
+        this.#points.push(...kept);
+        if (kept.some((p, i) => i > 0 && p.timeMs < kept[i - 1].timeMs) || this.#outOfOrder(kept))
+            this.#points.sort((a, b) => a.timeMs - b.timeMs);
+        this.prune();
+        for (const l of this.#listeners)
+            l(kept);
+        return kept;
+    }
+    #outOfOrder(kept) {
+        const before = this.#points[this.#points.length - kept.length - 1];
+        return !!before && before.timeMs > kept[0].timeMs;
+    }
+    #track(p) {
+        const key = seriesKeyOf(p);
+        const count = this.#series.get(key);
+        if (count === undefined && this.#series.size >= this.maxSeries)
+            return void this.dropped++, false;
+        this.#series.set(key, (count ?? 0) + 1);
+        return true;
+    }
+    #forget(p) {
+        const key = seriesKeyOf(p);
+        const count = (this.#series.get(key) ?? 1) - 1;
+        if (count <= 0)
+            this.#series.delete(key);
+        else
+            this.#series.set(key, count);
+    }
+    /** Drop points past the age or count limit. */
+    prune() {
+        const cutoff = this.#now() - this.maxAgeMs;
+        let drop = 0;
+        while (drop < this.#points.length && (this.#points[drop].timeMs < cutoff || this.#points.length - drop > this.maxPoints))
+            drop++;
+        if (drop === 0)
+            return;
+        for (const p of this.#points.splice(0, drop))
+            this.#forget(p);
+    }
+    /** Points at or after `sinceMs`, oldest first, at most `limit` (the newest are kept). */
+    since(sinceMs = 0, limit = MAX_METRIC_POINTS) {
+        this.prune();
+        const from = this.#points.findIndex((p) => p.timeMs >= sinceMs);
+        if (from < 0)
+            return [];
+        const list = this.#points.slice(from);
+        return list.length > limit ? list.slice(list.length - limit) : list;
+    }
+    all() {
+        this.prune();
+        return this.#points;
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/metrics/store.js.map

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

package/dist/mode.d.ts

@@ -0,0 +1,6 @@
+import type { WizeLensOptions } from "./types.js";
+/** On or off: the option, then WIZELENS_ENABLED, then on outside production. */
+export declare const isEnabled: (o: WizeLensOptions) => boolean;
+/** Serve reads (dashboard, API, MCP): the option, then WIZELENS_DASHBOARD, then on outside production. */
+export declare const servesDashboard: (o: WizeLensOptions) => boolean;
+//# sourceMappingURL=mode.d.ts.map

package/dist/mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.d.ts","sourceRoot":"","sources":["../src/mode.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD,gFAAgF;AAChF,eAAO,MAAM,SAAS,MAAO,eAAe,KAAG,OAA0E,CAAC;AAE1H,0GAA0G;AAC1G,eAAO,MAAM,eAAe,MAAO,eAAe,KAAG,OAA8E,CAAC"}

package/dist/mode.js

@@ -0,0 +1,7 @@
+import { DASHBOARD_ENV, ENABLED_ENV, envFlag } from "@wizeworks/lens-core";
+const production = () => process.env.NODE_ENV === "production";
+/** On or off: the option, then WIZELENS_ENABLED, then on outside production. */
+export const isEnabled = (o) => o.enabled ?? envFlag(process.env[ENABLED_ENV]) ?? !production();
+/** Serve reads (dashboard, API, MCP): the option, then WIZELENS_DASHBOARD, then on outside production. */
+export const servesDashboard = (o) => o.dashboard ?? envFlag(process.env[DASHBOARD_ENV]) ?? !production();
+//# sourceMappingURL=mode.js.map

package/dist/mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.js","sourceRoot":"","sources":["../src/mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAG3E,MAAM,UAAU,GAAG,GAAY,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC;AAExE,gFAAgF;AAChF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAkB,EAAW,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;AAE1H,0GAA0G;AAC1G,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAkB,EAAW,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC"}

package/dist/next.d.ts

@@ -0,0 +1,5 @@
+export { nextIgnore, nextWizeLens, onRequestError, registerWizeLens } from "./frameworks/next.js";
+export type { NextErrorContext, NextRequestInfo, WizeLensNextOptions } from "./frameworks/next.js";
+export type { IgnorePath } from "./frameworks/node-server.js";
+export type { WizeLens, WizeLensOptions } from "./types.js";
+//# sourceMappingURL=next.d.ts.map

package/dist/next.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../src/next.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAClG,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACnG,YAAY,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/next.js

@@ -0,0 +1,2 @@
+export { nextIgnore, nextWizeLens, onRequestError, registerWizeLens } from "./frameworks/next.js";
+//# sourceMappingURL=next.js.map

package/dist/next.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.js","sourceRoot":"","sources":["../src/next.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/persist-schema.d.ts

@@ -0,0 +1,14 @@
+import type { DatabaseSync, StatementSync } from "node:sqlite";
+export declare const SCHEMA_VERSION = "1";
+export declare const SCHEMA = "\nCREATE TABLE IF NOT EXISTS meta   (key TEXT PRIMARY KEY, value TEXT NOT NULL);\nCREATE TABLE IF NOT EXISTS traces (\n  trace_id TEXT PRIMARY KEY, start_ms REAL NOT NULL, updated_ms REAL NOT NULL,\n  remotes TEXT NOT NULL DEFAULT '[]'\n);\nCREATE TABLE IF NOT EXISTS spans  (\n  trace_id TEXT NOT NULL, span_id TEXT NOT NULL, parent_span_id TEXT,\n  name TEXT NOT NULL, kind TEXT NOT NULL, category TEXT NOT NULL, service TEXT NOT NULL,\n  start_ms REAL NOT NULL, duration_ms REAL NOT NULL, status TEXT NOT NULL,\n  session TEXT,\n  json TEXT NOT NULL,\n  PRIMARY KEY (trace_id, span_id)\n);\nCREATE TABLE IF NOT EXISTS logs   (\n  trace_id TEXT NOT NULL, seq INTEGER NOT NULL, time_ms REAL NOT NULL, level TEXT NOT NULL,\n  json TEXT NOT NULL,\n  PRIMARY KEY (trace_id, seq)\n);\nCREATE INDEX IF NOT EXISTS ix_traces_start  ON traces(start_ms);\nCREATE INDEX IF NOT EXISTS ix_spans_session ON spans(session) WHERE session IS NOT NULL;\nCREATE INDEX IF NOT EXISTS ix_spans_cat_dur ON spans(category, duration_ms);\n";
+export interface Statements {
+    upsertTrace: StatementSync;
+    upsertSpan: StatementSync;
+    insertLog: StatementSync;
+    pruneAge: StatementSync;
+    pruneCount: StatementSync;
+    pruneSpans: StatementSync;
+    pruneLogs: StatementSync;
+}
+export declare function prepareStatements(db: DatabaseSync): Statements;
+//# sourceMappingURL=persist-schema.d.ts.map

package/dist/persist-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist-schema.d.ts","sourceRoot":"","sources":["../src/persist-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG/D,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,MAAM,6/BAsBlB,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,aAAa,CAAC;IAC3B,UAAU,EAAE,aAAa,CAAC;IAC1B,SAAS,EAAE,aAAa,CAAC;IACzB,QAAQ,EAAE,aAAa,CAAC;IACxB,UAAU,EAAE,aAAa,CAAC;IAC1B,UAAU,EAAE,aAAa,CAAC;IAC1B,SAAS,EAAE,aAAa,CAAC;CAC1B;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,YAAY,GAAG,UAAU,CAgB9D"}

package/dist/persist-schema.js

@@ -0,0 +1,41 @@
+// Shared schema (docs/CONTRACT.md, "Storage"). The phase 2 hub reads these files too.
+export const SCHEMA_VERSION = "1";
+export const SCHEMA = `
+CREATE TABLE IF NOT EXISTS meta   (key TEXT PRIMARY KEY, value TEXT NOT NULL);
+CREATE TABLE IF NOT EXISTS traces (
+  trace_id TEXT PRIMARY KEY, start_ms REAL NOT NULL, updated_ms REAL NOT NULL,
+  remotes TEXT NOT NULL DEFAULT '[]'
+);
+CREATE TABLE IF NOT EXISTS spans  (
+  trace_id TEXT NOT NULL, span_id TEXT NOT NULL, parent_span_id TEXT,
+  name TEXT NOT NULL, kind TEXT NOT NULL, category TEXT NOT NULL, service TEXT NOT NULL,
+  start_ms REAL NOT NULL, duration_ms REAL NOT NULL, status TEXT NOT NULL,
+  session TEXT,
+  json TEXT NOT NULL,
+  PRIMARY KEY (trace_id, span_id)
+);
+CREATE TABLE IF NOT EXISTS logs   (
+  trace_id TEXT NOT NULL, seq INTEGER NOT NULL, time_ms REAL NOT NULL, level TEXT NOT NULL,
+  json TEXT NOT NULL,
+  PRIMARY KEY (trace_id, seq)
+);
+CREATE INDEX IF NOT EXISTS ix_traces_start  ON traces(start_ms);
+CREATE INDEX IF NOT EXISTS ix_spans_session ON spans(session) WHERE session IS NOT NULL;
+CREATE INDEX IF NOT EXISTS ix_spans_cat_dur ON spans(category, duration_ms);
+`;
+export function prepareStatements(db) {
+    return {
+        upsertTrace: db.prepare(`INSERT INTO traces (trace_id, start_ms, updated_ms, remotes) VALUES (?, ?, ?, ?)
+      ON CONFLICT(trace_id) DO UPDATE SET start_ms = min(start_ms, excluded.start_ms),
+        updated_ms = excluded.updated_ms, remotes = excluded.remotes`),
+        upsertSpan: db.prepare(`INSERT OR REPLACE INTO spans
+      (trace_id, span_id, parent_span_id, name, kind, category, service, start_ms, duration_ms, status, session, json)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`),
+        insertLog: db.prepare("INSERT OR IGNORE INTO logs (trace_id, seq, time_ms, level, json) VALUES (?, ?, ?, ?, ?)"),
+        pruneAge: db.prepare("DELETE FROM traces WHERE start_ms < ?"),
+        pruneCount: db.prepare("DELETE FROM traces WHERE trace_id NOT IN (SELECT trace_id FROM traces ORDER BY start_ms DESC LIMIT ?)"),
+        pruneSpans: db.prepare("DELETE FROM spans WHERE trace_id NOT IN (SELECT trace_id FROM traces)"),
+        pruneLogs: db.prepare("DELETE FROM logs WHERE trace_id NOT IN (SELECT trace_id FROM traces)"),
+    };
+}
+//# sourceMappingURL=persist-schema.js.map

package/dist/persist-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist-schema.js","sourceRoot":"","sources":["../src/persist-schema.ts"],"names":[],"mappings":"AAEA,sFAAsF;AACtF,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAClC,MAAM,CAAC,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;CAsBrB,CAAC;AAYF,MAAM,UAAU,iBAAiB,CAAC,EAAgB;IAChD,OAAO;QACL,WAAW,EAAE,EAAE,CAAC,OAAO,CAAC;;qEAEyC,CAAC;QAClE,UAAU,EAAE,EAAE,CAAC,OAAO,CAAC;;kDAEuB,CAAC;QAC/C,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,yFAAyF,CAAC;QAChH,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,uCAAuC,CAAC;QAC7D,UAAU,EAAE,EAAE,CAAC,OAAO,CACpB,uGAAuG,CACxG;QACD,UAAU,EAAE,EAAE,CAAC,OAAO,CAAC,uEAAuE,CAAC;QAC/F,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,sEAAsE,CAAC;KAC9F,CAAC;AACJ,CAAC"}

package/dist/persist-util.d.ts

@@ -0,0 +1,4 @@
+export declare function parseArray<T>(json: string): T[];
+/** Run `flush` on exit and on SIGINT/SIGTERM; re-raise the signal when no one else listens. */
+export declare function hookProcessExit(flush: () => void): () => void;
+//# sourceMappingURL=persist-util.d.ts.map

package/dist/persist-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist-util.d.ts","sourceRoot":"","sources":["../src/persist-util.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,CAO/C;AAED,+FAA+F;AAC/F,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAgB7D"}

package/dist/persist-util.js

@@ -0,0 +1,30 @@
+export function parseArray(json) {
+    try {
+        const v = JSON.parse(json);
+        return Array.isArray(v) ? v : [];
+    }
+    catch {
+        return [];
+    }
+}
+/** Run `flush` on exit and on SIGINT/SIGTERM; re-raise the signal when no one else listens. */
+export function hookProcessExit(flush) {
+    const onExit = () => flush();
+    const signals = ["SIGINT", "SIGTERM"];
+    const onSignal = (signal) => {
+        flush();
+        if (process.listenerCount(signal) === 1) {
+            process.removeListener(signal, onSignal);
+            process.kill(process.pid, signal);
+        }
+    };
+    process.on("exit", onExit);
+    for (const s of signals)
+        process.on(s, onSignal);
+    return () => {
+        process.removeListener("exit", onExit);
+        for (const s of signals)
+            process.removeListener(s, onSignal);
+    };
+}
+//# sourceMappingURL=persist-util.js.map

package/dist/persist-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist-util.js","sourceRoot":"","sources":["../src/persist-util.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAI,IAAY;IACxC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;QACtC,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,eAAe,CAAC,KAAiB;IAC/C,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAqB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,CAAC,MAAsB,EAAE,EAAE;QAC1C,KAAK,EAAE,CAAC;QACR,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACxC,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,OAAO;QAAE,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACjD,OAAO,GAAG,EAAE;QACV,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,KAAK,MAAM,CAAC,IAAI,OAAO;YAAE,OAAO,CAAC,cAAc,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC/D,CAAC,CAAC;AACJ,CAAC"}

package/dist/persist.d.ts

@@ -0,0 +1,27 @@
+import type { TraceStore } from "./store.js";
+export interface PersisterOptions {
+    path: string;
+    serviceName: string;
+    /** Flush interval in ms. Default 500. */
+    intervalMs?: number;
+    /** Called once when the file cannot be used. WizeLens then keeps working in memory. */
+    warn?: (message: string) => void;
+    /** Clock, for tests. */
+    now?: () => number;
+}
+/** Writes the store to a SQLite file and loads it back on startup; any error turns it off with one warning. */
+export declare class SqlitePersister {
+    #private;
+    readonly path: string;
+    constructor(store: TraceStore, options: PersisterOptions);
+    get active(): boolean;
+    /** Open the file, prune it, and load recent traces into the store. Returns false on failure. */
+    open(): boolean;
+    /** Flush every `intervalMs`, and once more when the process exits. */
+    start(): void;
+    /** Write all changed traces in one transaction, then prune. Synchronous on purpose (safe in `exit`). */
+    flush(): void;
+    /** Final flush, then close the file. */
+    close(): void;
+}
+//# sourceMappingURL=persist.d.ts.map

package/dist/persist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../src/persist.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,YAAY,CAAC;AAI1D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uFAAuF;IACvF,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,+GAA+G;AAC/G,qBAAa,eAAe;;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAUtB,YAAY,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,EAKvD;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,gGAAgG;IAChG,IAAI,IAAI,OAAO,CAEd;IAwBD,sEAAsE;IACtE,KAAK,IAAI,IAAI,CAKZ;IAED,wGAAwG;IACxG,KAAK,IAAI,IAAI,CAEZ;IA4CD,wCAAwC;IACxC,KAAK,IAAI,IAAI,CAYZ;CA6CF"}