can1357
4bf9a92b28
- Added Bun preload that records inclusive per-module windows and resolved static import edges via plugin hooks. - Shared events through a dependency-free buffer so the preload and logger avoid importing each other. - Rendered module spans as a body/TLA-ranked dependency tree, separating graph wait from top-level work. - Back-folded captured load phase into the root window to shrink the opaque pre-instrumentation figure.
48 lines
1.6 KiB
TypeScript
48 lines
1.6 KiB
TypeScript
/**
|
|
* Shared contract between the {@link module-timer} preload and {@link logger}'s
|
|
* timing tree. Kept in its own dependency-free module so the preload can import
|
|
* it without pulling in winston (via logger) and the logger can drain the buffer
|
|
* without importing the Bun-plugin preload.
|
|
*/
|
|
|
|
export interface ModuleLoadEvent {
|
|
/** Absolute or Bun-resolved module path. */
|
|
path: string;
|
|
/** `performance.now()` timestamp captured at Bun `onLoad` entry. */
|
|
start: number;
|
|
/** Inclusive module window: `onLoad` entry → appended final marker. */
|
|
durationMs: number;
|
|
/** Own top-level body / TLA time: prepended body marker → appended final marker. */
|
|
bodyMs?: number;
|
|
/** Resolved static children imported by this module. */
|
|
imports: string[];
|
|
}
|
|
|
|
/**
|
|
* Registry-global key under which the preload accumulates module-load events.
|
|
* `Symbol.for` so both modules resolve the same symbol independently.
|
|
*/
|
|
const KEY: symbol = Symbol.for("omp.moduleLoadBuffer");
|
|
|
|
type Store = Record<symbol, ModuleLoadEvent[] | undefined>;
|
|
|
|
/** The append-only buffer the preload pushes into (created on first access). */
|
|
export function moduleLoadBuffer(): ModuleLoadEvent[] {
|
|
const store = globalThis as unknown as Store;
|
|
let buffer = store[KEY];
|
|
if (!buffer) {
|
|
buffer = [];
|
|
store[KEY] = buffer;
|
|
}
|
|
return buffer;
|
|
}
|
|
|
|
/** Drain and return all buffered events, leaving the buffer empty. */
|
|
export function drainModuleLoadEvents(): ModuleLoadEvent[] {
|
|
const store = globalThis as unknown as Store;
|
|
const buffer = store[KEY];
|
|
if (!buffer || buffer.length === 0) return [];
|
|
store[KEY] = [];
|
|
return buffer;
|
|
}
|