@adonis-agora/telescope 0.6.0 → 0.7.0

package/dist/src/entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/entry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,SAAS;IACpB,wEAAwE;;IAExE,0DAA0D;;;;;;;;;;IAW1D,kEAAkE;;IAElE;;;;OAIG;;IAEH;;;;;OAKG;;IAEH;;;;;OAKG;;CAEK,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAE1E;;;;GAIG;AACH,QAAA,MAAM,aAAa,yDAA0D,CAAC;AAC9E,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AAED;;;;GAIG;AACH,MAAM,WAAW,KAAK,CAAC,QAAQ,GAAG,OAAO;IACvC,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iCAAiC;IACjC,OAAO,EAAE,QAAQ,CAAC;IAClB,iFAAiF;IACjF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oCAAoC;IACpC,MAAM,EAAE,WAAW,CAAC;IACpB,qEAAqE;IACrE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,mCAAmC;IACnC,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAAC,QAAQ,GAAG,OAAO;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,QAAQ,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB"}
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/entry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,SAAS;IACpB,wEAAwE;;IAExE,0DAA0D;;;;;;;;;;IAW1D,kEAAkE;;IAElE;;;;OAIG;;IAEH;;;;;OAKG;;IAEH;;;;;OAKG;;IAEH;;;;;;OAMG;;CAEK,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAE1E;;;;GAIG;AACH,QAAA,MAAM,aAAa,yDAA0D,CAAC;AAC9E,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AAED;;;;GAIG;AACH,MAAM,WAAW,KAAK,CAAC,QAAQ,GAAG,OAAO;IACvC,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iCAAiC;IACjC,OAAO,EAAE,QAAQ,CAAC;IAClB,iFAAiF;IACjF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oCAAoC;IACpC,MAAM,EAAE,WAAW,CAAC;IACpB,qEAAqE;IACrE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,mCAAmC;IACnC,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAAC,QAAQ,GAAG,OAAO;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,QAAQ,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB"}

package/dist/src/entry.js

@@ -41,6 +41,14 @@ export const EntryType = {
      * tags, so it composes with dedup, prune, sampling, and the dashboard.
      */
     ClientException: 'client_exception',
+    /**
+     * An aggregated V8 CPU profile (flamegraph tree + precomputed hot frames)
+     * captured via `node:inspector`'s `Profiler.start`/`Profiler.stop`, recorded
+     * by the OPTIONAL `cpu_profiling` feature (`@adonis-agora/telescope/cpu_profiling`).
+     * Distinct from {@link EntryType.Profile} (user-instrumented timing spans) —
+     * this is a real V8 sampling-profiler capture.
+     */
+    CpuProfile: 'cpu_profile',
 };
 /**
  * Where a batch of entries originated. An entry recorded inside an HTTP request

package/dist/src/entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../src/entry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,wEAAwE;IACxE,OAAO,EAAE,SAAS;IAClB,0DAA0D;IAC1D,UAAU,EAAE,YAAY;IACxB,8DAA8D;IAC9D,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,KAAK;IACV,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,KAAK;IACV,kEAAkE;IAClE,UAAU,EAAE,aAAa;IACzB;;;;OAIG;IACH,OAAO,EAAE,SAAS;IAClB;;;;;OAKG;IACH,aAAa,EAAE,gBAAgB;IAC/B;;;;;OAKG;IACH,eAAe,EAAE,kBAAkB;CAC3B,CAAC;AAIX;;;;GAIG;AACH,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,CAAU,CAAC;AAG9E,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,aAAmC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC3F,CAAC"}
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../src/entry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,wEAAwE;IACxE,OAAO,EAAE,SAAS;IAClB,0DAA0D;IAC1D,UAAU,EAAE,YAAY;IACxB,8DAA8D;IAC9D,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,KAAK;IACV,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,KAAK;IACV,kEAAkE;IAClE,UAAU,EAAE,aAAa;IACzB;;;;OAIG;IACH,OAAO,EAAE,SAAS;IAClB;;;;;OAKG;IACH,aAAa,EAAE,gBAAgB;IAC/B;;;;;OAKG;IACH,eAAe,EAAE,kBAAkB;IACnC;;;;;;OAMG;IACH,UAAU,EAAE,aAAa;CACjB,CAAC;AAIX;;;;GAIG;AACH,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,CAAU,CAAC;AAG9E,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,aAAmC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC3F,CAAC"}

package/dist/src/index.d.ts

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export declare const VERSION = "0.6.0";
+export declare const VERSION = "0.7.0";
 export { EntryType, isBatchOrigin } from './entry.js';
 export type { BatchOrigin, BuiltinEntryType, Entry, RecordInput } from './entry.js';
 export type { EntryQuery, TelescopeStore } from './store.js';

package/dist/src/index.js

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export const VERSION = '0.6.0';
+export const VERSION = '0.7.0';
 // — entry model —
 export { EntryType, isBatchOrigin } from './entry.js';
 export { InMemoryTelescopeStore } from './stores/memory.js';

package/dist/src/mcp/index.d.ts

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export declare const VERSION = "0.6.0";
+export declare const VERSION = "0.7.0";
 export { defineConfig, resolveConfig, MCP_TOOL_NAMES } from './define_config.js';
 export type { McpToolName, ResolvedTelescopeMcpConfig, TelescopeMcpConfig, } from './define_config.js';
 export { MCP_INTERNAL_ERROR, MCP_METHOD_NOT_FOUND, MCP_TOOLS, MCP_UNAUTHORIZED, TelescopeMcpServer, } from './server.js';

package/dist/src/mcp/index.js

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export const VERSION = '0.6.0';
+export const VERSION = '0.7.0';
 // — config —
 export { defineConfig, resolveConfig, MCP_TOOL_NAMES } from './define_config.js';
 // — server (plain, testable JSON-RPC surface) —

package/dist/src/profiling/aggregate-profile.d.ts

@@ -0,0 +1,21 @@
+import type { FlameNode, HotFrame, V8CpuProfile } from './types.js';
+interface Aggregated {
+    tree: FlameNode;
+    durationMs: number;
+    sampleCount: number;
+    hot: HotFrame[];
+}
+/**
+ * Aggregates a raw V8 CPU profile into a flamegraph frame tree with self/total
+ * time in milliseconds. Pure and deterministic — no inspector dependency, so it
+ * is trivially unit-testable and runs OUTSIDE any hot path (only when a capture
+ * actually completes).
+ *
+ * Method: each sample's `timeDelta` (microseconds) is charged to the SELF time
+ * of the node it landed on. Total time is then the sum of a node's self time and
+ * its descendants', computed by a single post-order walk. The flame tree mirrors
+ * V8's `children` call-graph so callers nest exactly as they did at runtime.
+ */
+export declare function aggregateCpuProfile(profile: V8CpuProfile): Aggregated;
+export {};
+//# sourceMappingURL=aggregate-profile.d.ts.map

package/dist/src/profiling/aggregate-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate-profile.d.ts","sourceRoot":"","sources":["../../../src/profiling/aggregate-profile.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAiB,MAAM,YAAY,CAAC;AAQnF,UAAU,UAAU;IAClB,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,QAAQ,EAAE,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,UAAU,CA2FrE"}

package/dist/src/profiling/aggregate-profile.js

@@ -0,0 +1,124 @@
+/** How many hottest-by-self frames to precompute for the dashboard. */
+const HOT_FRAME_LIMIT = 12;
+/** The synthetic root name V8 uses; we keep/normalize to it. */
+const ROOT_NAME = '(root)';
+/**
+ * Aggregates a raw V8 CPU profile into a flamegraph frame tree with self/total
+ * time in milliseconds. Pure and deterministic — no inspector dependency, so it
+ * is trivially unit-testable and runs OUTSIDE any hot path (only when a capture
+ * actually completes).
+ *
+ * Method: each sample's `timeDelta` (microseconds) is charged to the SELF time
+ * of the node it landed on. Total time is then the sum of a node's self time and
+ * its descendants', computed by a single post-order walk. The flame tree mirrors
+ * V8's `children` call-graph so callers nest exactly as they did at runtime.
+ */
+export function aggregateCpuProfile(profile) {
+    const byId = new Map();
+    for (const node of profile.nodes)
+        byId.set(node.id, node);
+    // 1. Charge each sample's time delta to its node's self time (microseconds).
+    const selfMicros = new Map();
+    const selfSamples = new Map();
+    const samples = profile.samples ?? [];
+    const deltas = profile.timeDeltas ?? [];
+    let totalMicros = 0;
+    for (let i = 0; i < samples.length; i++) {
+        const id = samples[i];
+        if (id === undefined)
+            continue;
+        // V8 emits one delta per sample (the time elapsed before that sample). Fall
+        // back to 0 if the arrays are mismatched rather than guessing.
+        const delta = deltas[i] ?? 0;
+        totalMicros += delta;
+        selfMicros.set(id, (selfMicros.get(id) ?? 0) + delta);
+        selfSamples.set(id, (selfSamples.get(id) ?? 0) + 1);
+    }
+    // 2. Find (or synthesize) the root. V8 puts the (root) node first; tolerate
+    // its absence by stitching all top-level nodes under a synthetic root.
+    const rootNode = profile.nodes.find((n) => n.callFrame.functionName === ROOT_NAME);
+    const build = (node) => {
+        const childIds = node.children ?? [];
+        const children = [];
+        for (const childId of childIds) {
+            const child = byId.get(childId);
+            if (child)
+                children.push(build(child));
+        }
+        const self = (selfMicros.get(node.id) ?? 0) / 1000;
+        const selfCount = selfSamples.get(node.id) ?? 0;
+        const childTotal = children.reduce((sum, c) => sum + c.totalMs, 0);
+        const childSamples = children.reduce((sum, c) => sum + c.totalSamples, 0);
+        return {
+            name: normalizeName(node.callFrame.functionName),
+            file: frameFile(node),
+            selfMs: self,
+            totalMs: self + childTotal,
+            totalSamples: selfCount + childSamples,
+            children,
+        };
+    };
+    let tree;
+    if (rootNode) {
+        tree = build(rootNode);
+    }
+    else {
+        // No explicit root: every node referenced as a child belongs to a parent;
+        // top-level nodes are those never referenced. Stitch them under a synthetic root.
+        const referenced = new Set();
+        for (const node of profile.nodes) {
+            for (const childId of node.children ?? [])
+                referenced.add(childId);
+        }
+        const tops = profile.nodes.filter((n) => !referenced.has(n.id)).map(build);
+        const childTotal = tops.reduce((sum, c) => sum + c.totalMs, 0);
+        tree = {
+            name: ROOT_NAME,
+            file: '',
+            selfMs: 0,
+            totalMs: childTotal,
+            totalSamples: tops.reduce((sum, c) => sum + c.totalSamples, 0),
+            children: tops,
+        };
+    }
+    // 3. Hot frames by self time (flatten, sort desc, take N).
+    const totalMs = totalMicros / 1000;
+    const flat = [];
+    const visit = (node) => {
+        if (node.selfMs > 0) {
+            flat.push({
+                name: node.name,
+                file: node.file,
+                selfMs: node.selfMs,
+                selfPct: totalMs > 0 ? (node.selfMs / totalMs) * 100 : 0,
+            });
+        }
+        for (const child of node.children)
+            visit(child);
+    };
+    visit(tree);
+    flat.sort((a, b) => b.selfMs - a.selfMs);
+    return {
+        tree,
+        durationMs: durationFor(profile, totalMicros),
+        sampleCount: samples.length,
+        hot: flat.slice(0, HOT_FRAME_LIMIT),
+    };
+}
+/** Prefer the summed sample deltas; fall back to start/end when samples absent. */
+function durationFor(profile, totalMicros) {
+    if (totalMicros > 0)
+        return totalMicros / 1000;
+    const wall = profile.endTime - profile.startTime;
+    return wall > 0 ? wall / 1000 : 0;
+}
+function normalizeName(name) {
+    return name === '' ? '(anonymous)' : name;
+}
+function frameFile(node) {
+    const { url, lineNumber } = node.callFrame;
+    if (url === '')
+        return '';
+    return lineNumber >= 0 ? `${url}:${lineNumber + 1}` : url;
+}
+//# sourceMappingURL=aggregate-profile.js.map

package/dist/src/profiling/aggregate-profile.js.map

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

package/dist/src/profiling/cpu-profiler.d.ts

@@ -0,0 +1,59 @@
+import type { FlameNode, HotFrame } from './types.js';
+/**
+ * The slice of `inspector.Session` we depend on. Declared structurally so the
+ * profiler can be unit-tested with a fake and — crucially — so the real
+ * `node:inspector` module is NEVER imported at module load. It is required
+ * lazily by {@link defaultSessionFactory} ONLY when a capture actually starts.
+ */
+export interface InspectorSessionLike {
+    connect(): void;
+    disconnect(): void;
+    post(method: string, paramsOrCallback?: unknown | ((err: Error | null, result?: unknown) => void), callback?: (err: Error | null, result?: unknown) => void): void;
+}
+export type SessionFactory = () => InspectorSessionLike;
+export interface CpuProfilerOptions {
+    /**
+     * V8 sampling interval in microseconds. Lower = finer-grained but more
+     * overhead. V8's default is 1000µs (1ms); we keep that default.
+     */
+    samplingIntervalMicros?: number;
+}
+export interface CpuProfilerResult {
+    tree: FlameNode;
+    durationMs: number;
+    sampleCount: number;
+    hot: HotFrame[];
+}
+/**
+ * Wraps a V8 CPU profiling session over the inspector protocol. A single
+ * profiler instance captures ONE profile at a time (`start` then `stop`).
+ *
+ * OVERHEAD GUARANTEE: constructing a profiler does no work and creates no
+ * session. The inspector session is created (and `node:inspector` is required)
+ * only inside `start()`. When profiling is disabled the controller never
+ * constructs one, so there is provably zero inspector activity.
+ */
+export declare class CpuProfiler {
+    private readonly sessionFactory;
+    private session;
+    private running;
+    private readonly intervalMicros;
+    constructor(sessionFactory?: SessionFactory, options?: CpuProfilerOptions);
+    get isRunning(): boolean;
+    /** Begin a CPU profile. No-op if one is already running. */
+    start(): Promise<void>;
+    /**
+     * Stop the profile and aggregate it into a flame tree. Returns `null` when no
+     * profile is running. Always disconnects the session, even on error.
+     */
+    stop(): Promise<CpuProfilerResult | null>;
+    private postAsync;
+}
+/**
+ * Lazily require `node:inspector` and return a fresh Session. Kept out of the
+ * module's import graph so that importing this file (or the whole package) does
+ * NOT load the inspector binding — that only happens the first time a capture
+ * starts, i.e. only when profiling is enabled AND a request is sampled.
+ */
+export declare function defaultSessionFactory(): InspectorSessionLike;
+//# sourceMappingURL=cpu-profiler.d.ts.map

package/dist/src/profiling/cpu-profiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cpu-profiler.d.ts","sourceRoot":"","sources":["../../../src/profiling/cpu-profiler.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAgB,MAAM,YAAY,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,IAAI,IAAI,CAAC;IAChB,UAAU,IAAI,IAAI,CAAC;IACnB,IAAI,CACF,MAAM,EAAE,MAAM,EACd,gBAAgB,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC,EAC5E,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,GACvD,IAAI,CAAC;CACT;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,QAAQ,EAAE,CAAC;CACjB;AAID;;;;;;;;GAQG;AACH,qBAAa,WAAW;IAMpB,OAAO,CAAC,QAAQ,CAAC,cAAc;IALjC,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAGrB,cAAc,GAAE,cAAsC,EACvE,OAAO,GAAE,kBAAuB;IAKlC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,4DAA4D;IACtD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAmB/C,OAAO,CAAC,SAAS;CAclB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,oBAAoB,CAS5D"}

package/dist/src/profiling/cpu-profiler.js

@@ -0,0 +1,94 @@
+// Ported near-verbatim (only the import path changed) from `nestjs-telescope`'s
+// `packages/core/src/profiling/cpu-profiler.ts`. `node:inspector`'s Session API is a Node.js
+// built-in, identical under NestJS or AdonisJS — this file has NO framework glue at all.
+import { createRequire } from 'node:module';
+import { aggregateCpuProfile } from './aggregate-profile.js';
+const DEFAULT_SAMPLING_INTERVAL_MICROS = 1000;
+/**
+ * Wraps a V8 CPU profiling session over the inspector protocol. A single
+ * profiler instance captures ONE profile at a time (`start` then `stop`).
+ *
+ * OVERHEAD GUARANTEE: constructing a profiler does no work and creates no
+ * session. The inspector session is created (and `node:inspector` is required)
+ * only inside `start()`. When profiling is disabled the controller never
+ * constructs one, so there is provably zero inspector activity.
+ */
+export class CpuProfiler {
+    sessionFactory;
+    session = null;
+    running = false;
+    intervalMicros;
+    constructor(sessionFactory = defaultSessionFactory, options = {}) {
+        this.sessionFactory = sessionFactory;
+        this.intervalMicros = options.samplingIntervalMicros ?? DEFAULT_SAMPLING_INTERVAL_MICROS;
+    }
+    get isRunning() {
+        return this.running;
+    }
+    /** Begin a CPU profile. No-op if one is already running. */
+    async start() {
+        if (this.running)
+            return;
+        const session = this.sessionFactory();
+        session.connect();
+        this.session = session;
+        await this.postAsync(session, 'Profiler.enable');
+        await this.postAsync(session, 'Profiler.setSamplingInterval', {
+            interval: this.intervalMicros,
+        });
+        await this.postAsync(session, 'Profiler.start');
+        this.running = true;
+    }
+    /**
+     * Stop the profile and aggregate it into a flame tree. Returns `null` when no
+     * profile is running. Always disconnects the session, even on error.
+     */
+    async stop() {
+        const session = this.session;
+        if (!this.running || session === null)
+            return null;
+        try {
+            const result = (await this.postAsync(session, 'Profiler.stop'));
+            return aggregateCpuProfile(result.profile);
+        }
+        finally {
+            this.running = false;
+            this.session = null;
+            try {
+                session.disconnect();
+            }
+            catch {
+                // A disconnect failure must never mask the captured profile or throw.
+            }
+        }
+    }
+    postAsync(session, method, params) {
+        return new Promise((resolve, reject) => {
+            const cb = (err, result) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve(result);
+            };
+            if (params === undefined)
+                session.post(method, cb);
+            else
+                session.post(method, params, cb);
+        });
+    }
+}
+/**
+ * Lazily require `node:inspector` and return a fresh Session. Kept out of the
+ * module's import graph so that importing this file (or the whole package) does
+ * NOT load the inspector binding — that only happens the first time a capture
+ * starts, i.e. only when profiling is enabled AND a request is sampled.
+ */
+export function defaultSessionFactory() {
+    // `createRequire` performs a SYNCHRONOUS require of the built-in without it
+    // appearing in this module's static import graph, so loading the package never
+    // pulls in the inspector binding. Built only on first capture.
+    const requireFn = createRequire(import.meta.url);
+    const inspector = requireFn('node:inspector');
+    return new inspector.Session();
+}
+//# sourceMappingURL=cpu-profiler.js.map

package/dist/src/profiling/cpu-profiler.js.map

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

package/dist/src/profiling/define_config.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The shape of `config/telescope_cpu_profiling.ts`. Mirrors `nestjs-telescope`'s
+ * `profiling-config.ts` (`ResolvedProfilingConfig`) — the knobs are framework-agnostic (they gate a
+ * `node:inspector` capture, not anything NestJS/AdonisJS-specific).
+ */
+export interface TelescopeCpuProfilingConfig {
+    /**
+     * Master switch. CPU profiling carries real overhead (a running V8 sampling
+     * profiler slows the process it profiles), so it is OFF by default — opt in
+     * explicitly. When `false` the middleware hook is a single boolean check and
+     * `node:inspector` is never required. Default `false`.
+     */
+    enabled?: boolean;
+    /**
+     * Fraction (0–1) of requests to automatically capture. `0` (the default) means
+     * captures only happen when armed via `POST <path>/api/profiles/arm`.
+     */
+    sampleRate?: number;
+    /** Maximum concurrent captures. Keeps overhead bounded under load. Default 2. */
+    maxConcurrent?: number;
+    /** Captures shorter than this are discarded (not worth an entry). Default 5. */
+    minDurationMs?: number;
+    /** V8 sampling interval in microseconds (lower = finer-grained, more overhead). Default 1000. */
+    samplingIntervalMicros?: number;
+}
+/** The fully-resolved config the provider + `ProfilerService` act on (no optionals). */
+export interface ResolvedTelescopeCpuProfilingConfig {
+    enabled: boolean;
+    sampleRate: number;
+    maxConcurrent: number;
+    minDurationMs: number;
+    samplingIntervalMicros: number;
+}
+/** Identity helper giving `config/telescope_cpu_profiling.ts` full type-checking. */
+export declare function defineConfig(config: TelescopeCpuProfilingConfig): TelescopeCpuProfilingConfig;
+/** Apply defaults to a (possibly partial) config. */
+export declare function resolveConfig(config?: TelescopeCpuProfilingConfig): ResolvedTelescopeCpuProfilingConfig;
+//# sourceMappingURL=define_config.d.ts.map

package/dist/src/profiling/define_config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define_config.d.ts","sourceRoot":"","sources":["../../../src/profiling/define_config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iGAAiG;IACjG,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,wFAAwF;AACxF,MAAM,WAAW,mCAAmC;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAMD,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,MAAM,EAAE,2BAA2B,GAAG,2BAA2B,CAE7F;AAED,qDAAqD;AACrD,wBAAgB,aAAa,CAC3B,MAAM,GAAE,2BAAgC,GACvC,mCAAmC,CAWrC"}

package/dist/src/profiling/define_config.js

@@ -0,0 +1,23 @@
+const DEFAULT_MAX_CONCURRENT = 2;
+const DEFAULT_MIN_DURATION_MS = 5;
+const DEFAULT_SAMPLING_INTERVAL_MICROS = 1000;
+/** Identity helper giving `config/telescope_cpu_profiling.ts` full type-checking. */
+export function defineConfig(config) {
+    return config;
+}
+/** Apply defaults to a (possibly partial) config. */
+export function resolveConfig(config = {}) {
+    return {
+        enabled: config.enabled ?? false,
+        sampleRate: clamp01(config.sampleRate ?? 0),
+        maxConcurrent: Math.max(1, Math.floor(config.maxConcurrent ?? DEFAULT_MAX_CONCURRENT)),
+        minDurationMs: Math.max(0, config.minDurationMs ?? DEFAULT_MIN_DURATION_MS),
+        samplingIntervalMicros: Math.max(100, Math.floor(config.samplingIntervalMicros ?? DEFAULT_SAMPLING_INTERVAL_MICROS)),
+    };
+}
+function clamp01(value) {
+    if (!Number.isFinite(value))
+        return 0;
+    return Math.min(1, Math.max(0, value));
+}
+//# sourceMappingURL=define_config.js.map

package/dist/src/profiling/define_config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define_config.js","sourceRoot":"","sources":["../../../src/profiling/define_config.ts"],"names":[],"mappings":"AAmCA,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACjC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAClC,MAAM,gCAAgC,GAAG,IAAI,CAAC;AAE9C,qFAAqF;AACrF,MAAM,UAAU,YAAY,CAAC,MAAmC;IAC9D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,aAAa,CAC3B,SAAsC,EAAE;IAExC,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,KAAK;QAChC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC;QAC3C,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,IAAI,sBAAsB,CAAC,CAAC;QACtF,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,aAAa,IAAI,uBAAuB,CAAC;QAC3E,sBAAsB,EAAE,IAAI,CAAC,GAAG,CAC9B,GAAG,EACH,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,sBAAsB,IAAI,gCAAgC,CAAC,CAC9E;KACF,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,KAAa;IAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/src/profiling/index.d.ts

@@ -0,0 +1,11 @@
+/** Keep in sync with this package's `version` in package.json. */
+export declare const VERSION = "0.7.0";
+export { defineConfig, resolveConfig } from './define_config.js';
+export type { ResolvedTelescopeCpuProfilingConfig, TelescopeCpuProfilingConfig, } from './define_config.js';
+export { CPU_PROFILE_ENTRY_TYPE, ProfilerService, } from './profiler_service.js';
+export type { ProfileHandle, ProfilerLike, ProfilerServiceDeps, ProfilerStatus, } from './profiler_service.js';
+export { CpuProfiler, defaultSessionFactory } from './cpu-profiler.js';
+export type { CpuProfilerOptions, CpuProfilerResult, InspectorSessionLike, SessionFactory, } from './cpu-profiler.js';
+export { aggregateCpuProfile } from './aggregate-profile.js';
+export type { CpuProfileContent, FlameNode, HotFrame, V8CpuProfile, V8ProfileNode, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/profiling/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/profiling/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACjE,YAAY,EACV,mCAAmC,EACnC,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,sBAAsB,EACtB,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACvE,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,YAAY,EACV,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/src/profiling/index.js

@@ -0,0 +1,7 @@
+/** Keep in sync with this package's `version` in package.json. */
+export const VERSION = '0.7.0';
+export { defineConfig, resolveConfig } from './define_config.js';
+export { CPU_PROFILE_ENTRY_TYPE, ProfilerService, } from './profiler_service.js';
+export { CpuProfiler, defaultSessionFactory } from './cpu-profiler.js';
+export { aggregateCpuProfile } from './aggregate-profile.js';
+//# sourceMappingURL=index.js.map

package/dist/src/profiling/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/profiling/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMjE,OAAO,EACL,sBAAsB,EACtB,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAQ/B,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAQvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/src/profiling/profiler_service.d.ts

@@ -0,0 +1,100 @@
+import { type RecordInput } from '../entry.js';
+import { type CpuProfilerResult } from './cpu-profiler.js';
+import type { ResolvedTelescopeCpuProfilingConfig } from './define_config.js';
+import type { CpuProfileContent } from './types.js';
+/** The `type` of the entries this service records. */
+export declare const CPU_PROFILE_ENTRY_TYPE: "cpu_profile";
+/** Opaque handle for an in-flight capture, returned by {@link ProfilerService.begin}. */
+export interface ProfileHandle {
+    readonly profiler: ProfilerLike;
+    readonly startedAt: number;
+    readonly reason: 'manual' | 'sampled';
+    /**
+     * The (fire-and-forget) start promise. {@link ProfilerService.end} awaits it
+     * before calling `stop()` so a capture that ends before `start()` settled (a
+     * very fast request, or a synchronous test) is still stopped correctly rather
+     * than seeing `isRunning === false` and silently dropping the profile.
+     */
+    readonly started: Promise<void>;
+}
+/** Minimal profiler contract so the service can be tested with a fake. */
+export interface ProfilerLike {
+    readonly isRunning: boolean;
+    start(): Promise<void>;
+    stop(): Promise<CpuProfilerResult | null>;
+}
+export interface ProfilerServiceDeps {
+    /** RNG for sampling — injectable for deterministic tests. */
+    random?: () => number;
+    /** Builds a profiler; injectable so tests avoid the real inspector. */
+    profilerFactory?: () => ProfilerLike;
+    /** Records the finished profile; injectable for tests. Defaults to `safeRecord`
+     *  through the runtime store slot (mirrors every other watcher). */
+    record?: (input: RecordInput<CpuProfileContent>) => void;
+}
+export interface ProfilerStatus {
+    enabled: boolean;
+    sampleRate: number;
+    /** Currently in-flight captures. */
+    active: number;
+    maxConcurrent: number;
+    /** Remaining manual budget across all arms. */
+    pendingManual: number;
+}
+/**
+ * Decides whether to profile a request and drives the capture lifecycle around
+ * it. {@link TelescopeMiddleware} calls {@link shouldProfile} (cheap gate), then
+ * {@link begin}/{@link end} around the request body — ported near-verbatim from
+ * `nestjs-telescope`'s `ProfilerService`; only the recording seam changed (fire-and-forget
+ * `safeRecord` through the runtime store slot, matching every other Adonis watcher, instead of a
+ * NestJS-injected recorder).
+ *
+ * OVERHEAD: while disabled, {@link shouldProfile} returns false and {@link begin}
+ * returns null after a single boolean check — no profiler is ever constructed
+ * and `node:inspector` is never required. While enabled but a request isn't
+ * selected, the only added cost is the gate and (if sampling) one RNG call.
+ */
+export declare class ProfilerService {
+    private readonly config;
+    private active;
+    private readonly manual;
+    private readonly random;
+    private readonly profilerFactory;
+    private readonly recordFn;
+    constructor(config: ResolvedTelescopeCpuProfilingConfig, deps?: ProfilerServiceDeps);
+    /**
+     * Arm a manual capture for the next `count` requests (optionally only those
+     * matching `label`). Returns the pending budget. No-op when disabled.
+     */
+    arm(arm: {
+        count: number;
+        label?: string;
+    }): {
+        pendingManual: number;
+    };
+    /**
+     * Whether this request should be profiled. Consults the manual arm budget
+     * first (targeted captures win), then sampling. Cheap and side-effect-free
+     * EXCEPT it does not yet consume the manual budget — that happens in
+     * {@link begin} so a request rejected by the concurrency cap doesn't waste it.
+     */
+    shouldProfile(label: string | null): boolean;
+    /**
+     * Begin a capture for a request that {@link shouldProfile} accepted. Returns a
+     * handle to pass to {@link end}, or `null` if the request should not be
+     * profiled (disabled, concurrency cap reached, or not selected). The caller
+     * MUST treat a null handle as "no profiling" and proceed untouched.
+     */
+    begin(label: string | null): ProfileHandle | null;
+    /**
+     * Stop a capture and record it as a `cpu_profile` entry. Safe to call with a
+     * null handle (no-op). Never throws into the host request path. Captures below
+     * the `minDurationMs` floor are discarded.
+     */
+    end(handle: ProfileHandle | null, label: string | null): Promise<void>;
+    status(): ProfilerStatus;
+    private pendingManual;
+    /** First arm matching this label (labelled arms require an exact match). */
+    private matchingArm;
+}
+//# sourceMappingURL=profiler_service.d.ts.map

package/dist/src/profiling/profiler_service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiler_service.d.ts","sourceRoot":"","sources":["../../../src/profiling/profiler_service.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EAAe,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,sDAAsD;AACtD,eAAO,MAAM,sBAAsB,eAAuB,CAAC;AAE3D,yFAAyF;AACzF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;CAC3C;AASD,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;IACtB,uEAAuE;IACvE,eAAe,CAAC,EAAE,MAAM,YAAY,CAAC;IACrC;wEACoE;IACpE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;CAC1D;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAe;IAQxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPzB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkD;gBAGxD,MAAM,EAAE,mCAAmC,EAC5D,IAAI,GAAE,mBAAwB;IAShC;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE;IAOtE;;;;;OAKG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;IAO5C;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,aAAa,GAAG,IAAI;IAuBjD;;;;OAIG;IACG,GAAG,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC5E,MAAM,IAAI,cAAc;IAUxB,OAAO,CAAC,aAAa;IAIrB,4EAA4E;IAC5E,OAAO,CAAC,WAAW;CAQpB"}