benchforge 0.1.11 → 0.2.4

package/dist/{HeapSampler-B8dtKHn1.mjs → HeapSampler-Dq-hpXem.mjs}

@@ -1,6 +1,5 @@
 import { Session } from "node:inspector/promises";
-
-//#region src/heap-sample/HeapSampler.ts
+//#region src/profiling/node/HeapSampler.ts
 const defaultOptions = {
 	samplingInterval: 32768,
 	stackDepth: 64,
@@ -44,11 +43,12 @@ async function startSampling(session, opts) {
 		await session.post("HeapProfiler.startSampling", base);
 	}
 }
+/** Stop heap sampling and return the profile, casting past incomplete @types/node typings */
 async function stopSampling(session) {
 	const { profile } = await session.post("HeapProfiler.stopSampling");
 	return profile;
 }
-
 //#endregion
 export { withHeapSampling };
-//# sourceMappingURL=HeapSampler-B8dtKHn1.mjs.map
+
+//# sourceMappingURL=HeapSampler-Dq-hpXem.mjs.map

package/dist/HeapSampler-Dq-hpXem.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeapSampler-Dq-hpXem.mjs","names":[],"sources":["../src/profiling/node/HeapSampler.ts"],"sourcesContent":["import { Session } from \"node:inspector/promises\";\n\nexport interface HeapSampleOptions {\n  /** Bytes between samples (default 32768) */\n  samplingInterval?: number;\n\n  /** Max stack frames (default 64) */\n  stackDepth?: number;\n\n  /** Keep objects collected by minor GC (default true) */\n  includeMinorGC?: boolean;\n\n  /** Keep objects collected by major GC (default true) */\n  includeMajorGC?: boolean;\n}\n\n/** V8 call frame location within a profiled script */\nexport interface CallFrame {\n  /** Function name (empty string for anonymous) */\n  functionName: string;\n\n  /** Script URL or file path */\n  url: string;\n\n  /** Zero-based line number */\n  lineNumber: number;\n\n  /** Zero-based column number */\n  columnNumber?: number;\n}\n\n/** Node in the V8 sampling heap profile tree */\nexport interface ProfileNode {\n  /** Call site for this allocation node */\n  callFrame: CallFrame;\n\n  /** Bytes allocated directly at this node (not children) */\n  selfSize: number;\n\n  /** Unique node ID, links to {@link HeapSample.nodeId} */\n  id: number;\n\n  /** Child nodes in the call tree */\n  children?: ProfileNode[];\n}\n\n/** Individual heap allocation sample from V8's SamplingHeapProfiler */\nexport interface HeapSample {\n  /** Links to {@link ProfileNode.id} for stack lookup */\n  nodeId: number;\n\n  /** Allocation size in bytes */\n  size: number;\n\n  /** Monotonically increasing, gives temporal ordering */\n  ordinal: number;\n}\n\n/** V8 sampling heap profile tree with optional per-allocation samples */\nexport interface HeapProfile {\n  /** Root of the profile call tree */\n  head: ProfileNode;\n\n  /** Per-allocation samples, if collected */\n  samples?: HeapSample[];\n}\n\nconst defaultOptions: Required<HeapSampleOptions> = {\n  samplingInterval: 32768,\n  stackDepth: 64,\n  includeMinorGC: true,\n  includeMajorGC: true,\n};\n\n/** Run a function while sampling heap allocations, return profile */\nexport async function withHeapSampling<T>(\n  options: HeapSampleOptions,\n  fn: () => Promise<T> | T,\n): Promise<{ result: T; profile: HeapProfile }> {\n  const opts = { ...defaultOptions, ...options };\n  const session = new Session();\n  session.connect();\n\n  try {\n    await startSampling(session, opts);\n    const result = await fn();\n    const profile = await stopSampling(session);\n    return { result, profile };\n  } finally {\n    session.disconnect();\n  }\n}\n\n/** Start heap sampling, falling back if include-collected params aren't supported */\nasync function startSampling(\n  session: Session,\n  opts: Required<HeapSampleOptions>,\n): Promise<void> {\n  const { samplingInterval, stackDepth } = opts;\n  const base = { samplingInterval, stackDepth };\n  const params = {\n    ...base,\n    includeObjectsCollectedByMinorGC: opts.includeMinorGC,\n    includeObjectsCollectedByMajorGC: opts.includeMajorGC,\n  };\n  try {\n    await session.post(\"HeapProfiler.startSampling\", params);\n  } catch {\n    console.warn(\n      \"HeapProfiler: include-collected params not supported, falling back\",\n    );\n    await session.post(\"HeapProfiler.startSampling\", base);\n  }\n}\n\n/** Stop heap sampling and return the profile, casting past incomplete @types/node typings */\nasync function stopSampling(session: Session): Promise<HeapProfile> {\n  const { profile } = await session.post(\"HeapProfiler.stopSampling\");\n  return profile as unknown as HeapProfile;\n}\n"],"mappings":";;AAmEA,MAAM,iBAA8C;CAClD,kBAAkB;CAClB,YAAY;CACZ,gBAAgB;CAChB,gBAAgB;CACjB;;AAGD,eAAsB,iBACpB,SACA,IAC8C;CAC9C,MAAM,OAAO;EAAE,GAAG;EAAgB,GAAG;EAAS;CAC9C,MAAM,UAAU,IAAI,SAAS;AAC7B,SAAQ,SAAS;AAEjB,KAAI;AACF,QAAM,cAAc,SAAS,KAAK;AAGlC,SAAO;GAAE,QAFM,MAAM,IAAI;GAER,SADD,MAAM,aAAa,QAAQ;GACjB;WAClB;AACR,UAAQ,YAAY;;;;AAKxB,eAAe,cACb,SACA,MACe;CACf,MAAM,EAAE,kBAAkB,eAAe;CACzC,MAAM,OAAO;EAAE;EAAkB;EAAY;CAC7C,MAAM,SAAS;EACb,GAAG;EACH,kCAAkC,KAAK;EACvC,kCAAkC,KAAK;EACxC;AACD,KAAI;AACF,QAAM,QAAQ,KAAK,8BAA8B,OAAO;SAClD;AACN,UAAQ,KACN,qEACD;AACD,QAAM,QAAQ,KAAK,8BAA8B,KAAK;;;;AAK1D,eAAe,aAAa,SAAwC;CAClE,MAAM,EAAE,YAAY,MAAM,QAAQ,KAAK,4BAA4B;AACnE,QAAO"}