@superblocksteam/sdk 2.0.130-next.2 → 2.0.130-next.4

package/dist/telemetry/memory-metrics.js

@@ -1,54 +1,231 @@
-import { PerformanceObserver, } from "node:perf_hooks";
+import { readFileSync } from "node:fs";
+import { constants, monitorEventLoopDelay, performance, PerformanceObserver, } from "node:perf_hooks";
+import { getHeapStatistics } from "node:v8";
 import { getMeter } from "./index.js";
 let cleanupFn;
+const NS_PER_MS = 1_000_000;
+const US_PER_SECOND = 1_000_000;
+function finiteNonNegative(value) {
+    return Number.isFinite(value) && value > 0 ? value : 0;
+}
+function nsToMs(value) {
+    return finiteNonNegative(value) / NS_PER_MS;
+}
+function ratio(numerator, denominator) {
+    if (!Number.isFinite(numerator) || !Number.isFinite(denominator)) {
+        return 0;
+    }
+    if (denominator <= 0) {
+        return 0;
+    }
+    return Math.max(0, numerator / denominator);
+}
+function readCgroupNumber(filePath) {
+    try {
+        const value = readFileSync(filePath, "utf-8").trim();
+        if (!value || value === "max") {
+            return { exists: true };
+        }
+        const parsed = Number(value);
+        if (Number.isFinite(parsed) &&
+            parsed >= 0 &&
+            parsed < Number.MAX_SAFE_INTEGER) {
+            return { exists: true, value: parsed };
+        }
+        return { exists: true };
+    }
+    catch {
+        return { exists: false };
+    }
+}
+export function readCgroupMemory(root = "/sys/fs/cgroup") {
+    const v2Current = readCgroupNumber(`${root}/memory.current`);
+    const v2Limit = readCgroupNumber(`${root}/memory.max`);
+    const usesCgroupV2 = v2Current.exists || v2Limit.exists;
+    const currentBytes = usesCgroupV2
+        ? v2Current.value
+        : readCgroupNumber(`${root}/memory/memory.usage_in_bytes`).value;
+    const limitBytes = usesCgroupV2
+        ? v2Limit.value
+        : readCgroupNumber(`${root}/memory/memory.limit_in_bytes`).value;
+    if (currentBytes === undefined ||
+        limitBytes === undefined ||
+        limitBytes <= 0) {
+        return undefined;
+    }
+    return {
+        currentBytes,
+        limitBytes,
+        usageRatio: ratio(currentBytes, limitBytes),
+    };
+}
+function gcKind(kind) {
+    switch (kind) {
+        case constants.NODE_PERFORMANCE_GC_MINOR:
+            return "minor";
+        case constants.NODE_PERFORMANCE_GC_MAJOR:
+            return "major";
+        case constants.NODE_PERFORMANCE_GC_INCREMENTAL:
+            return "incremental";
+        case constants.NODE_PERFORMANCE_GC_WEAKCB:
+            return "weakcb";
+        default:
+            return "unknown";
+    }
+}
 export function startMemoryMetrics() {
     if (cleanupFn) {
         return;
     }
     const meter = getMeter();
-    const heapUsedGauge = meter.createObservableGauge("nodejs.memory.heap_used_bytes", { description: "V8 heap memory used (bytes)", unit: "By" });
-    const heapTotalGauge = meter.createObservableGauge("nodejs.memory.heap_total_bytes", { description: "V8 heap memory allocated (bytes)", unit: "By" });
-    const rssGauge = meter.createObservableGauge("nodejs.memory.rss_bytes", {
-        description: "Resident Set Size - total memory allocated for the process",
-        unit: "By",
-    });
-    const externalGauge = meter.createObservableGauge("nodejs.memory.external_bytes", {
-        description: "Memory used by C++ objects bound to JavaScript objects",
-        unit: "By",
-    });
-    const arrayBuffersGauge = meter.createObservableGauge("nodejs.memory.array_buffers_bytes", {
-        description: "Memory allocated for ArrayBuffers and SharedArrayBuffers (also included in external)",
-        unit: "By",
-    });
-    const gcCountCounter = meter.createCounter("nodejs.gc.count", {
-        description: "Number of garbage collection events",
-        unit: "{event}",
-    });
-    const gauges = [
-        heapUsedGauge,
-        heapTotalGauge,
-        rssGauge,
-        externalGauge,
-        arrayBuffersGauge,
-    ];
-    // Single memoryUsage() call per export interval for all 5 gauges (idiomatic OTEL batch pattern).
-    const batchCb = (result) => {
-        const mem = process.memoryUsage();
-        result.observe(heapUsedGauge, mem.heapUsed);
-        result.observe(heapTotalGauge, mem.heapTotal);
-        result.observe(rssGauge, mem.rss);
-        result.observe(externalGauge, mem.external);
-        result.observe(arrayBuffersGauge, mem.arrayBuffers);
-    };
-    meter.addBatchObservableCallback(batchCb, gauges);
-    const gcObserver = new PerformanceObserver((list) => {
-        gcCountCounter.add(list.getEntries().length);
-    });
-    gcObserver.observe({ entryTypes: ["gc"], buffered: false });
-    cleanupFn = () => {
-        gcObserver.disconnect();
-        meter.removeBatchObservableCallback(batchCb, gauges);
-    };
+    const eventLoopDelay = monitorEventLoopDelay({ resolution: 20 });
+    let previousEventLoopUtilization = performance.eventLoopUtilization();
+    let removeBatchCallback;
+    let disconnectGcObserver;
+    try {
+        const heapUsedGauge = meter.createObservableGauge("nodejs.memory.heap_used_bytes", { description: "V8 heap memory used (bytes)", unit: "By" });
+        const heapTotalGauge = meter.createObservableGauge("nodejs.memory.heap_total_bytes", { description: "V8 heap memory allocated (bytes)", unit: "By" });
+        const rssGauge = meter.createObservableGauge("nodejs.memory.rss_bytes", {
+            description: "Resident Set Size - total memory allocated for the process",
+            unit: "By",
+        });
+        const externalGauge = meter.createObservableGauge("nodejs.memory.external_bytes", {
+            description: "Memory used by C++ objects bound to JavaScript objects",
+            unit: "By",
+        });
+        const arrayBuffersGauge = meter.createObservableGauge("nodejs.memory.array_buffers_bytes", {
+            description: "Memory allocated for ArrayBuffers and SharedArrayBuffers (also included in external)",
+            unit: "By",
+        });
+        const heapLimitGauge = meter.createObservableGauge("nodejs.memory.heap_limit_bytes", { description: "Configured V8 heap size limit (bytes)", unit: "By" });
+        const heapUsedRatioGauge = meter.createObservableGauge("nodejs.memory.heap_used_ratio", { description: "V8 heap used divided by V8 heap size limit", unit: "1" });
+        const cgroupCurrentGauge = meter.createObservableGauge("nodejs.memory.cgroup_current_bytes", { description: "Current cgroup memory usage when available", unit: "By" });
+        const cgroupLimitGauge = meter.createObservableGauge("nodejs.memory.cgroup_limit_bytes", { description: "Cgroup memory limit when available", unit: "By" });
+        const cgroupUsageRatioGauge = meter.createObservableGauge("nodejs.memory.cgroup_usage_ratio", {
+            description: "Cgroup memory usage divided by cgroup memory limit",
+            unit: "1",
+        });
+        const eventLoopDelayMeanGauge = meter.createObservableGauge("nodejs.event_loop.delay.mean_ms", {
+            description: "Mean event-loop delay for the last collection window",
+            unit: "ms",
+        });
+        const eventLoopDelayMaxGauge = meter.createObservableGauge("nodejs.event_loop.delay.max_ms", {
+            description: "Max event-loop delay for the last collection window",
+            unit: "ms",
+        });
+        const eventLoopDelayP50Gauge = meter.createObservableGauge("nodejs.event_loop.delay.p50_ms", {
+            description: "p50 event-loop delay for the last collection window",
+            unit: "ms",
+        });
+        const eventLoopDelayP90Gauge = meter.createObservableGauge("nodejs.event_loop.delay.p90_ms", {
+            description: "p90 event-loop delay for the last collection window",
+            unit: "ms",
+        });
+        const eventLoopDelayP99Gauge = meter.createObservableGauge("nodejs.event_loop.delay.p99_ms", {
+            description: "p99 event-loop delay for the last collection window",
+            unit: "ms",
+        });
+        const eventLoopUtilizationGauge = meter.createObservableGauge("nodejs.event_loop.utilization", {
+            description: "Event-loop utilization delta for the last collection window",
+            unit: "1",
+        });
+        const processCpuUserCounter = meter.createObservableCounter("nodejs.process.cpu.user_seconds", { description: "Process user CPU time since start", unit: "s" });
+        const processCpuSystemCounter = meter.createObservableCounter("nodejs.process.cpu.system_seconds", { description: "Process system CPU time since start", unit: "s" });
+        const gcCountCounter = meter.createCounter("nodejs.gc.count", {
+            description: "Number of garbage collection events",
+            unit: "{event}",
+        });
+        const gcDurationHistogram = meter.createHistogram("nodejs.gc.duration_ms", {
+            description: "Garbage collection duration by collection kind",
+            unit: "ms",
+            advice: {
+                explicitBucketBoundaries: [0.5, 1, 2, 5, 10, 25, 50, 100, 250, 500],
+            },
+        });
+        const observableInstruments = [
+            heapUsedGauge,
+            heapTotalGauge,
+            rssGauge,
+            externalGauge,
+            arrayBuffersGauge,
+            heapLimitGauge,
+            heapUsedRatioGauge,
+            cgroupCurrentGauge,
+            cgroupLimitGauge,
+            cgroupUsageRatioGauge,
+            eventLoopDelayMeanGauge,
+            eventLoopDelayMaxGauge,
+            eventLoopDelayP50Gauge,
+            eventLoopDelayP90Gauge,
+            eventLoopDelayP99Gauge,
+            eventLoopUtilizationGauge,
+            processCpuUserCounter,
+            processCpuSystemCounter,
+        ];
+        // Single callback per export interval keeps runtime stats temporally aligned.
+        const batchCb = (result) => {
+            try {
+                const mem = process.memoryUsage();
+                const heap = getHeapStatistics();
+                const cgroup = readCgroupMemory();
+                const elu = performance.eventLoopUtilization(previousEventLoopUtilization);
+                previousEventLoopUtilization = performance.eventLoopUtilization();
+                const cpu = process.cpuUsage();
+                result.observe(heapUsedGauge, mem.heapUsed);
+                result.observe(heapTotalGauge, mem.heapTotal);
+                result.observe(rssGauge, mem.rss);
+                result.observe(externalGauge, mem.external);
+                result.observe(arrayBuffersGauge, mem.arrayBuffers);
+                result.observe(heapLimitGauge, heap.heap_size_limit);
+                result.observe(heapUsedRatioGauge, ratio(mem.heapUsed, heap.heap_size_limit));
+                // Omit cgroup gauges when no finite cgroup limit is available; absence means host/unlimited memory, not telemetry setup failure.
+                if (cgroup) {
+                    result.observe(cgroupCurrentGauge, cgroup.currentBytes);
+                    result.observe(cgroupLimitGauge, cgroup.limitBytes);
+                    result.observe(cgroupUsageRatioGauge, cgroup.usageRatio);
+                }
+                result.observe(eventLoopDelayMeanGauge, nsToMs(eventLoopDelay.mean));
+                result.observe(eventLoopDelayMaxGauge, nsToMs(eventLoopDelay.max));
+                result.observe(eventLoopDelayP50Gauge, nsToMs(eventLoopDelay.percentile(50)));
+                result.observe(eventLoopDelayP90Gauge, nsToMs(eventLoopDelay.percentile(90)));
+                result.observe(eventLoopDelayP99Gauge, nsToMs(eventLoopDelay.percentile(99)));
+                result.observe(eventLoopUtilizationGauge, finiteNonNegative(elu.utilization));
+                result.observe(processCpuUserCounter, cpu.user / US_PER_SECOND);
+                result.observe(processCpuSystemCounter, cpu.system / US_PER_SECOND);
+            }
+            finally {
+                eventLoopDelay.reset();
+            }
+        };
+        meter.addBatchObservableCallback(batchCb, observableInstruments);
+        removeBatchCallback = () => {
+            meter.removeBatchObservableCallback(batchCb, observableInstruments);
+        };
+        const gcObserver = new PerformanceObserver((list) => {
+            for (const entry of list.getEntries()) {
+                const kind = gcKind(entry.detail?.kind ?? entry.kind);
+                const attrs = { kind };
+                gcCountCounter.add(1, attrs);
+                gcDurationHistogram.record(finiteNonNegative(entry.duration), attrs);
+            }
+        });
+        disconnectGcObserver = () => {
+            gcObserver.disconnect();
+        };
+        gcObserver.observe({ entryTypes: ["gc"], buffered: false });
+        eventLoopDelay.enable();
+        cleanupFn = () => {
+            eventLoopDelay.disable();
+            disconnectGcObserver?.();
+            removeBatchCallback?.();
+        };
+    }
+    catch (error) {
+        eventLoopDelay.disable();
+        disconnectGcObserver?.();
+        removeBatchCallback?.();
+        throw error;
+    }
 }
 export function stopMemoryMetrics() {
     if (cleanupFn) {

package/dist/telemetry/memory-metrics.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-metrics.js","sourceRoot":"","sources":["../../src/telemetry/memory-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,GAEpB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,IAAI,SAAmC,CAAC;AAExC,MAAM,UAAU,kBAAkB;IAChC,IAAI,SAAS,EAAE,CAAC;QACd,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IAEzB,MAAM,aAAa,GAAG,KAAK,CAAC,qBAAqB,CAC/C,+BAA+B,EAC/B,EAAE,WAAW,EAAE,6BAA6B,EAAE,IAAI,EAAE,IAAI,EAAE,CAC3D,CAAC;IACF,MAAM,cAAc,GAAG,KAAK,CAAC,qBAAqB,CAChD,gCAAgC,EAChC,EAAE,WAAW,EAAE,kCAAkC,EAAE,IAAI,EAAE,IAAI,EAAE,CAChE,CAAC;IACF,MAAM,QAAQ,GAAG,KAAK,CAAC,qBAAqB,CAAC,yBAAyB,EAAE;QACtE,WAAW,EAAE,4DAA4D;QACzE,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;IACH,MAAM,aAAa,GAAG,KAAK,CAAC,qBAAqB,CAC/C,8BAA8B,EAC9B;QACE,WAAW,EAAE,wDAAwD;QACrE,IAAI,EAAE,IAAI;KACX,CACF,CAAC;IACF,MAAM,iBAAiB,GAAG,KAAK,CAAC,qBAAqB,CACnD,mCAAmC,EACnC;QACE,WAAW,EACT,sFAAsF;QACxF,IAAI,EAAE,IAAI;KACX,CACF,CAAC;IAEF,MAAM,cAAc,GAAG,KAAK,CAAC,aAAa,CAAC,iBAAiB,EAAE;QAC5D,WAAW,EAAE,qCAAqC;QAClD,IAAI,EAAE,SAAS;KAChB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG;QACb,aAAa;QACb,cAAc;QACd,QAAQ;QACR,aAAa;QACb,iBAAiB;KAClB,CAAC;IAEF,iGAAiG;IACjG,MAAM,OAAO,GAAG,CAAC,MAA6B,EAAE,EAAE;QAChD,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;QAC9C,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;IACtD,CAAC,CAAC;IAEF,KAAK,CAAC,0BAA0B,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAElD,MAAM,UAAU,GAAG,IAAI,mBAAmB,CACxC,CAAC,IAAkC,EAAE,EAAE;QACrC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC,CACF,CAAC;IACF,UAAU,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAE5D,SAAS,GAAG,GAAG,EAAE;QACf,UAAU,CAAC,UAAU,EAAE,CAAC;QACxB,KAAK,CAAC,6BAA6B,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,IAAI,SAAS,EAAE,CAAC;QACd,SAAS,EAAE,CAAC;QACZ,SAAS,GAAG,SAAS,CAAC;IACxB,CAAC;AACH,CAAC"}
+{"version":3,"file":"memory-metrics.js","sourceRoot":"","sources":["../../src/telemetry/memory-metrics.ts"],"names":[],"mappings":"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"}

package/dist/telemetry/memory-metrics.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memory-metrics.test.d.ts.map

package/dist/telemetry/memory-metrics.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-metrics.test.d.ts","sourceRoot":"","sources":["../../src/telemetry/memory-metrics.test.ts"],"names":[],"mappings":""}

package/dist/telemetry/memory-metrics.test.js

@@ -0,0 +1,256 @@
+import { mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { beforeEach, describe, expect, it, vi } from "vitest";
+const h = vi.hoisted(() => {
+    const gauges = [];
+    const observableCounters = [];
+    const counters = [];
+    const histograms = [];
+    return {
+        gauges,
+        observableCounters,
+        counters,
+        histograms,
+        throwOnGaugeName: undefined,
+        delayMonitor: {
+            enable: vi.fn(),
+            disable: vi.fn(),
+            reset: vi.fn(),
+            mean: 2_000_000,
+            max: 80_000_000,
+            percentile: vi.fn((p) => p * 1_000_000),
+        },
+        gcCallback: undefined,
+        elu: vi.fn(),
+        addBatchObservableCallback: vi.fn((callback, callbackInstruments) => {
+            for (const instrument of callbackInstruments) {
+                const captured = [...gauges, ...observableCounters].find((g) => g.name === instrument.name);
+                if (captured)
+                    captured.callback = callback;
+            }
+        }),
+        removeBatchObservableCallback: vi.fn(),
+    };
+});
+vi.mock("node:perf_hooks", async () => {
+    const actual = await vi.importActual("node:perf_hooks");
+    return {
+        ...actual,
+        PerformanceObserver: class {
+            constructor(callback) {
+                h.gcCallback = callback;
+            }
+            observe = vi.fn();
+            disconnect = vi.fn();
+        },
+        monitorEventLoopDelay: vi.fn(() => h.delayMonitor),
+        performance: {
+            ...actual.performance,
+            eventLoopUtilization: h.elu,
+        },
+    };
+});
+vi.mock("./index.js", () => ({
+    getMeter: () => ({
+        createObservableGauge: (name) => {
+            if (h.throwOnGaugeName === name) {
+                throw new Error(`createObservableGauge failed for ${name}`);
+            }
+            const gauge = { name };
+            h.gauges.push(gauge);
+            return gauge;
+        },
+        createObservableCounter: (name) => {
+            const counter = { name };
+            h.observableCounters.push(counter);
+            return counter;
+        },
+        createCounter: (name) => {
+            const counter = { name, adds: [] };
+            h.counters.push(counter);
+            return {
+                add: (value, attrs) => counter.adds.push({ value, attrs }),
+            };
+        },
+        createHistogram: (name, options) => {
+            const histogram = { name, options, records: [] };
+            h.histograms.push(histogram);
+            return {
+                record: (value, attrs) => histogram.records.push({ value, attrs }),
+            };
+        },
+        addBatchObservableCallback: h.addBatchObservableCallback,
+        removeBatchObservableCallback: h.removeBatchObservableCallback,
+    }),
+}));
+function observeAll() {
+    const observations = [];
+    const callback = h.gauges.find((g) => g.callback)?.callback;
+    if (!callback)
+        throw new Error("missing observable callback");
+    callback({
+        observe: (gauge, value, attrs) => observations.push({ name: gauge.name, value, attrs }),
+    });
+    return observations;
+}
+describe("memory metrics", () => {
+    beforeEach(async () => {
+        vi.resetModules();
+        h.gauges.length = 0;
+        h.observableCounters.length = 0;
+        h.counters.length = 0;
+        h.histograms.length = 0;
+        h.throwOnGaugeName = undefined;
+        h.delayMonitor.enable.mockClear();
+        h.delayMonitor.disable.mockClear();
+        h.delayMonitor.reset.mockClear();
+        h.delayMonitor.percentile.mockClear();
+        h.gcCallback = undefined;
+        h.elu.mockReset();
+        h.elu
+            .mockReturnValueOnce({ idle: 0, active: 0, utilization: 0 })
+            .mockReturnValueOnce({ idle: 25, active: 75, utilization: 0.75 })
+            .mockReturnValue({ idle: 100, active: 200, utilization: 0.67 });
+        h.addBatchObservableCallback.mockClear();
+        h.removeBatchObservableCallback.mockClear();
+    });
+    it("observes event-loop, V8 heap, and memory-pressure gauges", async () => {
+        const { startMemoryMetrics, stopMemoryMetrics } = await import("./memory-metrics.js");
+        startMemoryMetrics();
+        const observations = observeAll();
+        stopMemoryMetrics();
+        expect(h.delayMonitor.enable).toHaveBeenCalledOnce();
+        expect(observations.map((o) => o.name)).toEqual(expect.arrayContaining([
+            "nodejs.event_loop.delay.max_ms",
+            "nodejs.event_loop.delay.p99_ms",
+            "nodejs.event_loop.utilization",
+            "nodejs.memory.heap_limit_bytes",
+            "nodejs.memory.heap_used_ratio",
+        ]));
+        expect(h.observableCounters.map((counter) => counter.name)).toEqual([
+            "nodejs.process.cpu.user_seconds",
+            "nodejs.process.cpu.system_seconds",
+        ]);
+        expect(observations.find((o) => o.name === "nodejs.event_loop.delay.max_ms")
+            ?.value).toBe(80);
+        expect(observations.find((o) => o.name === "nodejs.event_loop.utilization")
+            ?.value).toBe(0.75);
+        expect(h.delayMonitor.reset).toHaveBeenCalledOnce();
+        expect(h.delayMonitor.disable).toHaveBeenCalledOnce();
+    });
+    it("cleans up the event-loop delay monitor when setup fails", async () => {
+        const { startMemoryMetrics, stopMemoryMetrics } = await import("./memory-metrics.js");
+        h.throwOnGaugeName = "nodejs.memory.rss_bytes";
+        expect(() => startMemoryMetrics()).toThrow("createObservableGauge failed for nodejs.memory.rss_bytes");
+        expect(h.delayMonitor.disable).toHaveBeenCalledOnce();
+        h.throwOnGaugeName = undefined;
+        startMemoryMetrics();
+        stopMemoryMetrics();
+        expect(h.delayMonitor.enable).toHaveBeenCalledOnce();
+        expect(h.delayMonitor.disable).toHaveBeenCalledTimes(2);
+    });
+    it("resets event-loop delay even when observation fails", async () => {
+        const { startMemoryMetrics, stopMemoryMetrics } = await import("./memory-metrics.js");
+        startMemoryMetrics();
+        const callback = h.gauges.find((g) => g.callback)?.callback;
+        if (!callback)
+            throw new Error("missing observable callback");
+        expect(() => callback({
+            observe: (instrument) => {
+                if (instrument.name === "nodejs.memory.rss_bytes") {
+                    throw new Error("observe failed");
+                }
+            },
+        })).toThrow("observe failed");
+        stopMemoryMetrics();
+        expect(h.delayMonitor.reset).toHaveBeenCalledOnce();
+    });
+    it("does not register metrics twice until stopped", async () => {
+        const { startMemoryMetrics, stopMemoryMetrics } = await import("./memory-metrics.js");
+        startMemoryMetrics();
+        startMemoryMetrics();
+        stopMemoryMetrics();
+        startMemoryMetrics();
+        stopMemoryMetrics();
+        expect(h.delayMonitor.enable).toHaveBeenCalledTimes(2);
+        expect(h.addBatchObservableCallback).toHaveBeenCalledTimes(2);
+        expect(h.removeBatchObservableCallback).toHaveBeenCalledTimes(2);
+    });
+    it("records GC count and duration with bounded kind labels", async () => {
+        const { startMemoryMetrics, stopMemoryMetrics } = await import("./memory-metrics.js");
+        startMemoryMetrics();
+        h.gcCallback?.({
+            getEntries: () => [
+                { detail: { kind: 1 }, duration: 12 },
+                { detail: { kind: 4 }, duration: 34 },
+                { kind: 999, duration: 56 },
+            ],
+        });
+        stopMemoryMetrics();
+        const gcCounter = h.counters.find((c) => c.name === "nodejs.gc.count");
+        const gcDuration = h.histograms.find((histogram) => histogram.name === "nodejs.gc.duration_ms");
+        expect(gcCounter?.adds.map((a) => a.attrs)).toEqual([
+            { kind: "minor" },
+            { kind: "major" },
+            { kind: "unknown" },
+        ]);
+        expect(gcDuration?.records).toEqual([
+            { value: 12, attrs: { kind: "minor" } },
+            { value: 34, attrs: { kind: "major" } },
+            { value: 56, attrs: { kind: "unknown" } },
+        ]);
+        expect(gcDuration?.options).toEqual({
+            description: "Garbage collection duration by collection kind",
+            unit: "ms",
+            advice: {
+                explicitBucketBoundaries: [0.5, 1, 2, 5, 10, 25, 50, 100, 250, 500],
+            },
+        });
+    });
+});
+describe("readCgroupMemory", () => {
+    beforeEach(() => {
+        vi.resetModules();
+    });
+    it("reads cgroup v2 memory usage and ratio", async () => {
+        const root = mkdtempSync(path.join(tmpdir(), "sb-cgroup-"));
+        writeFileSync(path.join(root, "memory.current"), "50\n");
+        writeFileSync(path.join(root, "memory.max"), "200\n");
+        const { readCgroupMemory } = await import("./memory-metrics.js");
+        expect(readCgroupMemory(root)).toEqual({
+            currentBytes: 50,
+            limitBytes: 200,
+            usageRatio: 0.25,
+        });
+    });
+    it("returns undefined when cgroup files are absent or unlimited", async () => {
+        const root = mkdtempSync(path.join(tmpdir(), "sb-cgroup-"));
+        const { readCgroupMemory } = await import("./memory-metrics.js");
+        expect(readCgroupMemory(root)).toBeUndefined();
+        writeFileSync(path.join(root, "memory.current"), "50\n");
+        writeFileSync(path.join(root, "memory.max"), "max\n");
+        expect(readCgroupMemory(root)).toBeUndefined();
+    });
+    it("does not combine v2 usage with v1 limits", async () => {
+        const root = mkdtempSync(path.join(tmpdir(), "sb-cgroup-"));
+        const memoryRoot = path.join(root, "memory");
+        mkdirSync(memoryRoot);
+        writeFileSync(path.join(root, "memory.current"), "50\n");
+        writeFileSync(path.join(root, "memory.max"), "max\n");
+        writeFileSync(path.join(memoryRoot, "memory.usage_in_bytes"), "60\n");
+        writeFileSync(path.join(memoryRoot, "memory.limit_in_bytes"), "200\n");
+        const { readCgroupMemory } = await import("./memory-metrics.js");
+        expect(readCgroupMemory(root)).toBeUndefined();
+    });
+    it("treats cgroup v1 sentinel limits as unlimited", async () => {
+        const root = mkdtempSync(path.join(tmpdir(), "sb-cgroup-"));
+        const memoryRoot = path.join(root, "memory");
+        mkdirSync(memoryRoot);
+        writeFileSync(path.join(memoryRoot, "memory.usage_in_bytes"), "50\n");
+        writeFileSync(path.join(memoryRoot, "memory.limit_in_bytes"), "9223372036854771712\n");
+        const { readCgroupMemory } = await import("./memory-metrics.js");
+        expect(readCgroupMemory(root)).toBeUndefined();
+    });
+});
+//# sourceMappingURL=memory-metrics.test.js.map

package/dist/telemetry/memory-metrics.test.js.map

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

package/dist/vite-plugin-sdk-api-entry-point.d.mts

@@ -1,10 +1,23 @@
 import type { Plugin } from "vite";
+/**
+ * Resolve the app-root-relative entry point path for a Vite module id.
+ *
+ * Fullstack apps keep `server/apis/` at the app root while `vite.config.ts`
+ * often sets `root: "./client"`. Dev server and build already pass the true
+ * app root into the plugin; failures are intermittent and depend on how Vite
+ * resolves module ids for files outside the client subtree (for example
+ * `../server/apis/...` relatives or `/@fs/...` absolute ids). Plain absolute
+ * paths under `<appRoot>/server/apis/` already matched before this helper.
+ */
+export declare function resolveSdkApiEntryPointRelativePath(appRootDir: string, moduleId: string): string | null;
 /**
  * Vite plugin that prepends `__setEntryPoint(relativePath)` to SDK API files
  * so that `api()` can stamp the authoritative source file
  * path onto the compiled API object.
  *
+ * @param appRootDir - App root (parent of `client/` and `server/`).
+ *
  * Runs in both dev and build. The user's source code is never modified on disk.
  */
-export declare function sdkApiEntryPointPlugin(root: string): Plugin;
+export declare function sdkApiEntryPointPlugin(appRootDir: string): Plugin;
 //# sourceMappingURL=vite-plugin-sdk-api-entry-point.d.mts.map

package/dist/vite-plugin-sdk-api-entry-point.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"vite-plugin-sdk-api-entry-point.d.mts","sourceRoot":"","sources":["../src/vite-plugin-sdk-api-entry-point.mts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAwBnC;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA2C3D"}
+{"version":3,"file":"vite-plugin-sdk-api-entry-point.d.mts","sourceRoot":"","sources":["../src/vite-plugin-sdk-api-entry-point.mts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAuDnC;;;;;;;;;GASG;AACH,wBAAgB,mCAAmC,CACjD,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CA4Bf;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAqCjE"}