next-leak 0.1.0 → 0.1.2

package/dist/cli.js

@@ -9,9 +9,9 @@ import {
   killActiveChildren,
   parseCliArgs,
   runMeasurement
-} from "./chunk-UZTZWHKH.js";
-import "./chunk-K5PZFVJH.js";
-import "./chunk-OSZ6ND6E.js";
+} from "./chunk-WHC6S57X.js";
+import "./chunk-2BQZCZ4Z.js";
+import "./chunk-PF7KYD5N.js";
 
 // src/cli.ts
 import { spawn } from "child_process";
@@ -36,45 +36,55 @@ function reexecWithHeadroom() {
     process.exit(code ?? (signal === "SIGINT" ? 130 : 1));
   });
 }
-async function main() {
-  const parsed = parseCliArgs(process.argv.slice(2));
+function installInterruptHandlers() {
+  const aborter = new AbortController();
+  let interrupts = 0;
+  for (const signalName of ["SIGINT", "SIGTERM"]) {
+    process.on(signalName, () => {
+      interrupts += 1;
+      if (interrupts > 1) {
+        process.exit(130);
+      }
+      console.error("\n\xB7 interrupted \u2014 stopping the measured process and writing a partial run.json");
+      aborter.abort();
+      killActiveChildren();
+    });
+  }
+  return aborter;
+}
+function handleNonRunCommand(parsed) {
   if (parsed.kind === "version") {
     console.log(version);
-    return;
+    return true;
   }
   if (parsed.kind === "help") {
     console.log(helpText(version));
     process.exitCode = process.argv.length > 2 ? 0 : 1;
-    return;
+    return true;
   }
   if (parsed.kind === "error") {
     console.error(`error: ${parsed.message}`);
     process.exitCode = 1;
-    return;
+    return true;
   }
   const guardFailure = checkRuntime();
   if (guardFailure !== null) {
     console.error(`error: ${guardFailure}`);
     process.exitCode = 1;
+    return true;
+  }
+  return false;
+}
+async function main() {
+  const parsed = parseCliArgs(process.argv.slice(2));
+  if (handleNonRunCommand(parsed) || parsed.kind !== "run") {
     return;
   }
   if (!hasHeapHeadroom()) {
     reexecWithHeadroom();
     return;
   }
-  const aborter = new AbortController();
-  let interrupts = 0;
-  for (const signalName of ["SIGINT", "SIGTERM"]) {
-    process.on(signalName, () => {
-      interrupts += 1;
-      if (interrupts > 1) {
-        process.exit(130);
-      }
-      console.error("\n\xB7 interrupted \u2014 stopping the measured process and writing a partial run.json");
-      aborter.abort();
-      killActiveChildren();
-    });
-  }
+  const aborter = installInterruptHandlers();
   const { options } = parsed;
   const quickPreset = options.quick ? { loadRequests: 2e3, cycles: 4, idleMs: 8e3 } : {};
   const report = await runMeasurement({
@@ -96,11 +106,13 @@ async function main() {
     process.exitCode = 130;
   }
 }
-main().catch((cause) => {
+try {
+  await main();
+} catch (cause) {
   if (cause instanceof TargetError || cause instanceof RouteConfigError) {
     console.error(`error: ${cause.message}`);
   } else {
     console.error(cause);
   }
   process.exitCode = 1;
-});
+}

package/dist/control-client.d.ts

@@ -1,7 +1,4 @@
 import type { HeapSample } from "./control-server.js";
-export declare class ControlError extends Error {
-    constructor(message: string);
-}
 /** Forces GC in the measured process and returns a settled memory sample. */
 export declare function requestGc(port: number): Promise<HeapSample>;
 /** Forces GC, writes a named heap snapshot, and returns its path and sample. */

package/dist/control-server.d.ts

@@ -12,7 +12,6 @@ export type HeapSample = {
     external: number;
     arrayBuffers: number;
 };
-export declare function sampleMemory(gcExposed: boolean): HeapSample;
 export type ControlServerOptions = {
     /** Directory where heap snapshots are written. */
     snapshotDir: string;

package/dist/{html-report-3JIRVRBF.js → html-report-I4PNSLKY.js}

@@ -1,9 +1,9 @@
 import { createRequire as __nextLeakCreateRequire } from 'node:module';import { fileURLToPath as __nextLeakFileURLToPath } from 'node:url';import { dirname as __nextLeakDirname } from 'node:path';const require = __nextLeakCreateRequire(import.meta.url);const __filename = __nextLeakFileURLToPath(import.meta.url);const __dirname = __nextLeakDirname(__filename);
 import {
   renderHtmlReport
-} from "./chunk-4BMPC45G.js";
-import "./chunk-K5PZFVJH.js";
-import "./chunk-OSZ6ND6E.js";
+} from "./chunk-C3KH5Z2W.js";
+import "./chunk-2BQZCZ4Z.js";
+import "./chunk-PF7KYD5N.js";
 export {
   renderHtmlReport
 };

package/dist/index.d.ts

@@ -26,7 +26,7 @@ export { captureEnvironment } from "./environment.js";
 export type { MeasurementEnvironment } from "./environment.js";
 export { renderHtmlReport } from "./html-report.js";
 export { renderIssueMarkdown } from "./issue-report.js";
-export type { MeasuredRoute } from "./issue-report.js";
+export type { MeasuredRoute } from "./runner.js";
 export { routeSlug } from "./runner.js";
 export type { RunParameters } from "./runner.js";
 export { loadRouteConfig, resolveRoutePath, RouteConfigError, ROUTE_CONFIG_FILE } from "./route-config.js";

package/dist/index.js

@@ -40,15 +40,15 @@ import {
   sourceIndexAt,
   summarizeBaseline,
   validateTarget
-} from "./chunk-UZTZWHKH.js";
+} from "./chunk-WHC6S57X.js";
 import {
   renderHtmlReport
-} from "./chunk-4BMPC45G.js";
-import "./chunk-K5PZFVJH.js";
+} from "./chunk-C3KH5Z2W.js";
+import "./chunk-2BQZCZ4Z.js";
 import {
   renderIssueMarkdown
-} from "./chunk-5K4WEMIS.js";
-import "./chunk-OSZ6ND6E.js";
+} from "./chunk-5ZYZW2BL.js";
+import "./chunk-PF7KYD5N.js";
 export {
   LaunchError,
   LoadError,

package/dist/{issue-report-AB62FRNM.js → issue-report-VQEUXP2E.js}

@@ -1,8 +1,8 @@
 import { createRequire as __nextLeakCreateRequire } from 'node:module';import { fileURLToPath as __nextLeakFileURLToPath } from 'node:url';import { dirname as __nextLeakDirname } from 'node:path';const require = __nextLeakCreateRequire(import.meta.url);const __filename = __nextLeakFileURLToPath(import.meta.url);const __dirname = __nextLeakDirname(__filename);
 import {
   renderIssueMarkdown
-} from "./chunk-5K4WEMIS.js";
-import "./chunk-OSZ6ND6E.js";
+} from "./chunk-5ZYZW2BL.js";
+import "./chunk-PF7KYD5N.js";
 export {
   renderIssueMarkdown
 };

package/dist/issue-report.d.ts

@@ -1,7 +1,4 @@
-import type { RouteReport, RunReport } from "./runner.js";
-export type MeasuredRoute = Extract<RouteReport, {
-    status: "measured";
-}>;
+import type { MeasuredRoute, RunReport } from "./runner.js";
 /**
  * Issue draft in the Next.js bug-template section order. The attribution
  * gates the preamble: app/dependency-owned leaks warn against filing

package/dist/module-registry.d.ts

@@ -1,19 +1,5 @@
-import { type LineMapping } from "./vlq.js";
 /** Bundler module id → source path (e.g. `[project]/src/app/leaky/page.tsx`). */
 export type ModuleRegistry = ReadonlyMap<number, string>;
-export type NormalizedSourceMap = {
-    sources: string[];
-    lines: LineMapping[];
-};
-/** Accepts flat or sectioned sourcemaps; null when it is neither. */
-export declare function normalizeSourceMap(raw: unknown): NormalizedSourceMap | null;
-/**
- * Extracts `[id, factory, ...]` pairs from a Turbopack CJS chunk by walking
- * the sourcemap instead of lexing JavaScript: each factory is a contiguous
- * region mapped to one source, so a change of source index marks a factory
- * boundary, and the module id is the last integer literal in the unmapped
- * gap right before it. Non-Turbopack chunks contribute nothing.
- */
 export declare function extractChunkModules(code: string, rawMap: unknown): Map<number, string>;
 /**
  * Builds the module registry by scanning every server chunk that has an

package/dist/route-config.d.ts

@@ -4,7 +4,7 @@ import { z } from "zod";
  * route params. `params` applies globally; `routes` overrides per route
  * template (keys as discovered, e.g. `/[lang]/candidate/[candidateId]`).
  */
-export declare const routeConfigSchema: z.ZodObject<{
+declare const routeConfigSchema: z.ZodObject<{
     params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     routes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>>;
     headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -34,3 +34,4 @@ export declare const UNIQUE_MARKER = "{n}";
  * requests that never completed — both verified against a real server.
  */
 export declare function resolveRoutePath(routeTemplate: string, config: RouteConfig): string | null;
+export {};

package/dist/run-report.fixture.d.ts

@@ -1,3 +1,2 @@
 import type { RunReport } from "./runner.js";
-/** Canonical report fixture shared by report/html/issue renderer tests. */
 export declare function makeRunReport(): RunReport;

package/dist/runner.d.ts

@@ -106,18 +106,6 @@ export type RunnerDeps = {
     nextVersion: typeof readNextVersion;
 };
 export declare function freePort(): Promise<number>;
-/**
- * Filesystem-safe label for a route. Distinct routes MUST get distinct slugs:
- * `/a/b` and `/a_b` used to collapse onto the same `ISSUE-a_b.md`, and any
- * all-non-ASCII path (`/ñ`) became "root", colliding with `/`. A short digest
- * disambiguates whenever the sanitized form loses information.
- */
-/**
- * Mean RSS growth per cycle, excluding the warm-up cycle exactly like the
- * heap verdict does. Reported alongside the heap so a flat heap with growing
- * RSS is visible instead of invisible.
- */
-export declare function rssTrend(memorySamples: readonly HeapSample[]): number;
 export declare function routeSlug(route: string): string;
 /**
  * Full measurement run: validate the target, discover routes, run the ritual

package/dist/vlq.d.ts

@@ -1,4 +1,3 @@
-/** Decodes one line of base64-VLQ segments from a sourcemap `mappings` string. */
 export declare function decodeVlqLine(line: string): number[][];
 export type LineMapping = {
     /** Generated column → source index, sorted by column. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-leak",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Find out whether your Next.js app actually leaks memory — how much, on which route, and whose fault it is.",
   "keywords": [
     "nextjs",
@@ -33,8 +33,7 @@
     "prepublishOnly": "npm run typecheck && npm run test && npm run build",
     "pack:smoke": "node scripts/pack-smoke.mjs",
     "test:mutation": "stryker run",
-    "prepare": "husky >/dev/null 2>&1 || true",
-    "release": "release-it"
+    "prepare": "husky >/dev/null 2>&1 || true"
   },
   "pnpm": {
     "overrides": {
@@ -46,21 +45,19 @@
     "@commitlint/config-conventional": "^21.2.0",
     "@memlab/core": "^2.0.4",
     "@memlab/heap-analysis": "^2.0.4",
-    "@release-it/conventional-changelog": "^11.0.1",
     "@stryker-mutator/core": "^9.6.1",
     "@stryker-mutator/vitest-runner": "^9.6.1",
     "@types/autocannon": "^7.12.7",
     "@types/node": "^26.1.1",
     "@types/semver": "^7.7.1",
     "@vitest/coverage-v8": "^4.1.10",
+    "autocannon": "^8.0.0",
     "husky": "^9.1.7",
-    "release-it": "^20.2.1",
     "tsup": "^8.5.1",
     "typescript": "^7.0.2",
     "vitest": "^4.1.10"
   },
   "dependencies": {
-    "autocannon": "^8.0.0",
     "semver": "^7.8.5",
     "zod": "^4.4.3"
   },

package/dist/chunk-K5PZFVJH.js

@@ -1,103 +0,0 @@
-import { createRequire as __nextLeakCreateRequire } from 'node:module';import { fileURLToPath as __nextLeakFileURLToPath } from 'node:url';import { dirname as __nextLeakDirname } from 'node:path';const require = __nextLeakCreateRequire(import.meta.url);const __filename = __nextLeakFileURLToPath(import.meta.url);const __dirname = __nextLeakDirname(__filename);
-
-// src/confidence.ts
-function effectiveVerdict(report) {
-  return report.confidence.supersededVerdict ?? report.trend.verdict;
-}
-var VERDICT_WEAKENING = /* @__PURE__ */ new Set([
-  "near-threshold",
-  "spiky-growth"
-]);
-function warrantsIssueDraft(report) {
-  return effectiveVerdict(report) === "leak" && !report.confidence.warnings.some((warning) => VERDICT_WEAKENING.has(warning.code));
-}
-var DEFAULT_MIN_GROWTH = 256 * 1024;
-var LOAD_COMPLETION_FLOOR = 0.99;
-var ABANDON_EFFECTIVE_FLOOR = 0.9;
-var MID_STREAM_FLOOR = 0.1;
-var SPIKE_RATIO = 4;
-var NOISE_FLOOR_MULTIPLE = 2;
-var mb = (bytes) => `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
-var pct = (part, whole) => `${(part / whole * 100).toFixed(1)}%`;
-function assessConfidence(input) {
-  const warnings = [];
-  const minGrowth = input.minGrowthPerCycle ?? DEFAULT_MIN_GROWTH;
-  const isLeak = input.trend.verdict === "leak";
-  const moving = input.settleOutcomes.filter((outcome) => outcome.status === "moving");
-  if (moving.length > 0) {
-    const phases = moving.map((outcome) => outcome.phase).join(", ");
-    warnings.push({
-      code: "unsettled",
-      detail: `the heap never held steady before sampling on ${phases} \u2014 raise --idle-ms so post-load transients finish draining`
-    });
-  }
-  const unverified = input.settleOutcomes.filter((outcome) => outcome.status === "unknown");
-  if (unverified.length > 0) {
-    const phases = unverified.map((outcome) => outcome.phase).join(", ");
-    warnings.push({
-      code: "settle-unverified",
-      detail: `the idle budget was too short to check whether the heap had settled on ${phases} \u2014 the samples may include post-load transients`
-    });
-  }
-  for (const outcome of input.loadOutcomes) {
-    if (input.abandonAfterMs !== void 0) {
-      const abandoned = outcome.abandoned ?? 0;
-      if (outcome.sent > 0 && abandoned < outcome.sent * ABANDON_EFFECTIVE_FLOOR) {
-        warnings.push({
-          code: "abandon-ineffective",
-          detail: `${outcome.phase} disconnected early on only ${abandoned} of ${outcome.sent} requests (${pct(abandoned, outcome.sent)}) \u2014 the early-disconnect path was largely not exercised`
-        });
-        continue;
-      }
-      const midStream = outcome.abandonedMidStream ?? 0;
-      if (abandoned > 0 && midStream < abandoned * MID_STREAM_FLOOR) {
-        warnings.push({
-          code: "abandon-before-response",
-          detail: `${outcome.phase} cut ${abandoned} requests before the server sent anything (${midStream} mid-stream) \u2014 this tested pre-response disconnects, not mid-stream teardown; raise abandonAfterMs above the route's time-to-first-byte`
-        });
-      }
-      continue;
-    }
-    const landed = outcome.ok2xx ?? 0;
-    if (outcome.sent > 0 && landed < outcome.sent * LOAD_COMPLETION_FLOOR) {
-      warnings.push({
-        code: "load-incomplete",
-        detail: `${outcome.phase} landed ${landed} of ${outcome.sent} requests (${pct(landed, outcome.sent)}) \u2014 the route saw less traffic than reported`
-      });
-    }
-  }
-  const deltas = input.trend.deltas;
-  if ((isLeak || input.trend.verdict === "inconclusive") && deltas.length >= 2) {
-    const positive = deltas.filter((delta) => delta > 0);
-    if (positive.length === deltas.length) {
-      const smallest = Math.min(...positive);
-      const largest = Math.max(...positive);
-      if (largest > smallest * SPIKE_RATIO) {
-        warnings.push({
-          code: "spiky-growth",
-          detail: `one cycle grew ${mb(largest)} and another ${mb(smallest)} \u2014 the mean of ${mb(input.trend.growthPerCycle)}/cycle summarizes an uneven series; measure more cycles before quoting it`
-        });
-      }
-    }
-  }
-  if (isLeak && input.trend.growthPerCycle < minGrowth * NOISE_FLOOR_MULTIPLE) {
-    warnings.push({
-      code: "near-threshold",
-      detail: `growth of ${mb(input.trend.growthPerCycle)}/cycle barely clears the ${mb(minGrowth)} threshold \u2014 raise --load-requests so the signal outgrows the noise`
-    });
-  }
-  const neverSettled = input.settleOutcomes.length > 0 && moving.length === input.settleOutcomes.length;
-  const abandonedNothing = input.abandonAfterMs !== void 0 && input.loadOutcomes.length > 0 && input.loadOutcomes.every((outcome) => (outcome.abandoned ?? 0) === 0);
-  const invalid = isLeak && (neverSettled || abandonedNothing);
-  return {
-    level: warnings.length === 0 ? "high" : "low",
-    warnings,
-    ...invalid && { supersededVerdict: "inconclusive" }
-  };
-}
-
-export {
-  effectiveVerdict,
-  warrantsIssueDraft,
-  assessConfidence
-};