@electron-stagewright/plugin-budget 0.0.0-stage → 0.2.0

package/dist/run.js

@@ -0,0 +1,257 @@
+/**
+ * The run document: raw measurements of one build, and the flat summary `check` and `compare` read.
+ *
+ * @module
+ */
+import { readFile } from 'node:fs/promises';
+import { z } from 'zod';
+import { MEMORY_METRICS, PHASES, PROCESS_TYPES } from './budget.js';
+export const RUN_FORMAT = 'electron-stagewright-budget-run';
+export const RUN_SCHEMA_VERSION = 1;
+const stallSchema = z.object({
+    windowMs: z.number(),
+    blockedMs: z.number(),
+    blockedPercent: z.number(),
+    maxStallMs: z.number(),
+    stallsOver50Ms: z.number(),
+    stallsOver100Ms: z.number(),
+});
+const latencySchema = z.object({
+    count: z.number(),
+    p50: z.number(),
+    p95: z.number(),
+    p99: z.number(),
+    max: z.number(),
+});
+const processSchema = z.object({
+    pid: z.number(),
+    type: z.enum(PROCESS_TYPES),
+    name: z.string().optional(),
+    // In the run's `metric`; absent when the OS reader could not see this pid.
+    mb: z.number().optional(),
+    workingSetMb: z.number(),
+});
+const memorySchema = z.object({
+    metric: z.enum(MEMORY_METRICS),
+    processes: z.array(processSchema),
+});
+const measurementSchema = z.object({
+    startup: z.object({ firstWindowMs: z.number() }).optional(),
+    memory: memorySchema.optional(),
+    // The sample with the most memory outside the GPU during the window, when it was sampled.
+    memoryPeak: memorySchema.optional(),
+    mainThread: stallSchema.optional(),
+    ipc: latencySchema.optional(),
+    // Why a requested metric is missing, keyed by `startup` / `memory` / `mainThread` / `ipc`.
+    unavailable: z.record(z.string(), z.string()).optional(),
+});
+const bundleEntrySchema = z.object({
+    id: z.string(),
+    path: z.string(),
+    gzip: z.boolean(),
+    files: z.number(),
+    bytes: z.number(),
+    unavailable: z.string().optional(),
+});
+export const runSchema = z.object({
+    format: z.literal(RUN_FORMAT),
+    schema_version: z.literal(RUN_SCHEMA_VERSION),
+    created_at: z.string(),
+    platform: z.string(),
+    arch: z.string(),
+    electron_version: z.string().optional(),
+    label: z.string().optional(),
+    rounds: z.array(z.object({ round: z.number(), phase: z.enum(PHASES), measurement: measurementSchema })),
+    bundle: z.object({ entries: z.array(bundleEntrySchema) }).optional(),
+});
+/** A run file that is missing or is not a run document. */
+export class RunFileError extends Error {
+    runPath;
+    constructor(message, runPath) {
+        super(message);
+        this.runPath = runPath;
+        this.name = 'RunFileError';
+    }
+}
+export async function loadRun(runPath) {
+    let raw;
+    try {
+        raw = JSON.parse(await readFile(runPath, 'utf8'));
+    }
+    catch (error) {
+        throw new RunFileError(`Cannot read run file ${runPath}: ${error instanceof Error ? error.message : String(error)}`, runPath);
+    }
+    const parsed = runSchema.safeParse(raw);
+    if (!parsed.success) {
+        const issues = parsed.error.issues
+            .map((issue) => `${issue.path.join('.') || '(root)'}: ${issue.message}`)
+            .join('; ');
+        throw new RunFileError(`${runPath} is not a ${RUN_FORMAT} document: ${issues}`, runPath);
+    }
+    return parsed.data;
+}
+export function createRun(fields) {
+    return {
+        format: RUN_FORMAT,
+        schema_version: RUN_SCHEMA_VERSION,
+        created_at: (fields.now ?? new Date()).toISOString(),
+        platform: process.platform,
+        arch: process.arch,
+        ...(fields.electronVersion === undefined ? {} : { electron_version: fields.electronVersion }),
+        ...(fields.label === undefined ? {} : { label: fields.label }),
+        rounds: fields.rounds,
+        ...(fields.bundle === undefined ? {} : { bundle: fields.bundle }),
+    };
+}
+/**
+ * One run from several, rounds numbered in order, so a check takes the median across all of them.
+ * Every run must come from the same platform; the first Electron version, label and bundle win.
+ */
+export function mergeRuns(runs) {
+    const [first] = runs;
+    if (first === undefined)
+        throw new Error('mergeRuns needs at least one run');
+    const other = runs.find((run) => run.platform !== first.platform || run.arch !== first.arch);
+    if (other !== undefined) {
+        throw new Error(`cannot merge runs from ${first.platform}-${first.arch} and ${other.platform}-${other.arch}`);
+    }
+    let round = 0;
+    const electronVersion = runs.find((run) => run.electron_version !== undefined)?.electron_version;
+    const label = runs.find((run) => run.label !== undefined)?.label;
+    const bundle = runs.find((run) => run.bundle !== undefined)?.bundle;
+    return {
+        format: RUN_FORMAT,
+        schema_version: RUN_SCHEMA_VERSION,
+        created_at: first.created_at,
+        platform: first.platform,
+        arch: first.arch,
+        ...(electronVersion === undefined ? {} : { electron_version: electronVersion }),
+        ...(label === undefined ? {} : { label }),
+        // Each run numbers its rounds from 1; a run's cold and warm launch share a round.
+        rounds: runs.flatMap((run) => {
+            const offset = round;
+            const numbers = run.rounds.map((entry) => entry.round);
+            round += numbers.length === 0 ? 0 : Math.max(...numbers);
+            return run.rounds.map((entry) => ({ ...entry, round: entry.round + offset }));
+        }),
+        ...(bundle === undefined ? {} : { bundle }),
+    };
+}
+const round1 = (value) => Math.round(value * 10) / 10;
+export function median(values) {
+    const sorted = [...values].sort((a, b) => a - b);
+    const middle = Math.floor(sorted.length / 2);
+    const upper = sorted[middle] ?? 0;
+    return sorted.length % 2 === 1 ? upper : ((sorted[middle - 1] ?? upper) + upper) / 2;
+}
+/** Nearest-rank percentiles; an empty set reports zeros with `count: 0`. */
+export function summarizeLatencies(samples) {
+    const sorted = samples.filter(Number.isFinite).sort((a, b) => a - b);
+    const at = (percentile) => round1(sorted[Math.min(sorted.length - 1, Math.ceil((percentile / 100) * sorted.length) - 1)] ?? 0);
+    return { count: sorted.length, p50: at(50), p95: at(95), p99: at(99), max: at(100) };
+}
+/**
+ * Megabytes per process type for one memory sample, in the sample's metric. A type with a pid the
+ * OS reader could not see is left out rather than undercounted.
+ */
+export function memoryByType(memory) {
+    const totals = {};
+    const partial = new Set();
+    for (const entry of memory.processes) {
+        const mb = memory.metric === 'workingSet' ? entry.workingSetMb : entry.mb;
+        if (mb === undefined)
+            partial.add(entry.type);
+        else
+            totals[entry.type] = (totals[entry.type] ?? 0) + mb;
+    }
+    for (const type of partial)
+        delete totals[type];
+    return totals;
+}
+/** Sum of every type the sample holds, or undefined when one of them is unmeasured or none exist. */
+export function memoryTotal(memory, skipGpu) {
+    const types = new Set(memory.processes.map((entry) => entry.type));
+    if (skipGpu)
+        types.delete('gpu');
+    if (types.size === 0)
+        return undefined;
+    const totals = memoryByType(memory);
+    let sum = 0;
+    for (const type of types) {
+        const mb = totals[type];
+        if (mb === undefined)
+            return undefined;
+        sum += mb;
+    }
+    return sum;
+}
+function pushMemory(prefix, memories, push) {
+    // Rounds whose OS reader failed fall back to another metric; the majority one is summarised.
+    const counts = new Map();
+    for (const memory of memories)
+        counts.set(memory.metric, (counts.get(memory.metric) ?? 0) + 1);
+    let primary;
+    for (const { metric } of memories) {
+        if (primary === undefined || (counts.get(metric) ?? 0) > (counts.get(primary) ?? 0)) {
+            primary = metric;
+        }
+    }
+    // Working set is always recorded, so a budget may name it on any platform.
+    for (const metric of new Set([primary, 'workingSet'])) {
+        if (metric === undefined)
+            continue;
+        const sameMetric = memories
+            .filter((memory) => memory.metric === primary)
+            .map((memory) => ({ ...memory, metric }));
+        const byType = sameMetric.map(memoryByType);
+        for (const type of PROCESS_TYPES) {
+            push(`${prefix}.${type}`, 'MB', byType.map((totals) => totals[type]), metric);
+        }
+        push(`${prefix}.totalWithoutGpu`, 'MB', sameMetric.map((memory) => memoryTotal(memory, true)), metric);
+        push(`${prefix}.total`, 'MB', sameMetric.map((memory) => memoryTotal(memory, false)), metric);
+    }
+}
+/** Flatten a run into comparable rows (`memory.main`, `ipc.p99Ms`, `bundle.<id>`, ...). */
+export function summarizeRun(run) {
+    const rows = [];
+    for (const phase of PHASES) {
+        const measurements = run.rounds.filter((r) => r.phase === phase).map((r) => r.measurement);
+        const push = (id, unit, values, metric) => {
+            const present = values.filter((value) => value !== undefined);
+            if (present.length === 0)
+                return;
+            const exact = median(present);
+            rows.push({
+                id,
+                phase,
+                value: round1(exact),
+                exact,
+                unit,
+                ...(metric === undefined ? {} : { metric }),
+                samples: present.length,
+            });
+        };
+        push('startup.firstWindowMs', 'ms', measurements.map((m) => m.startup?.firstWindowMs));
+        pushMemory('memory', measurements.flatMap((m) => (m.memory === undefined ? [] : [m.memory])), push);
+        pushMemory('memoryPeak', measurements.flatMap((m) => (m.memoryPeak === undefined ? [] : [m.memoryPeak])), push);
+        push('mainThread.blockedPercent', '%', measurements.map((m) => m.mainThread?.blockedPercent));
+        push('mainThread.maxStallMs', 'ms', measurements.map((m) => m.mainThread?.maxStallMs));
+        const ipc = measurements.flatMap((m) => (m.ipc !== undefined && m.ipc.count > 0 ? [m.ipc] : []));
+        push('ipc.p95Ms', 'ms', ipc.map((latency) => latency.p95));
+        push('ipc.p99Ms', 'ms', ipc.map((latency) => latency.p99));
+    }
+    for (const entry of run.bundle?.entries ?? []) {
+        if (entry.unavailable !== undefined)
+            continue;
+        rows.push({
+            id: `bundle.${entry.id}`,
+            value: round1(entry.bytes / 1024),
+            exact: entry.bytes / 1024,
+            unit: 'KB',
+            ...(entry.gzip ? { metric: 'gzip' } : {}),
+            samples: 1,
+        });
+    }
+    return rows;
+}
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Measure one live app session through the transport's `evaluate` seam.
+ *
+ * @module
+ */
+import { type HostStartTimeReader, type OsMemoryReader } from './memory.js';
+import { type Measurement, type MemoryMeasurement } from './run.js';
+/** The slice of a transport session the budget needs. */
+export interface EvaluatingSession {
+    evaluate<T = unknown>(target: 'main' | 'renderer', body: string, arg?: unknown): Promise<T>;
+}
+export interface IpcProbe {
+    readonly probe: string;
+    readonly intervalMs?: number;
+}
+export declare const MAIN_EVAL_OFF = "main eval is off; start the server with --allow-eval=main (or bare --allow-eval)";
+export declare const RENDERER_EVAL_OFF = "renderer eval is off; start the server with bare --allow-eval to measure it";
+/**
+ * Open a measurement window: arm the main-thread sampler and, when a probe is given and renderer
+ * eval is allowed, the IPC probe loop. Returns why the IPC probe did not start, if it did not.
+ */
+export declare function startWindow(session: EvaluatingSession, options: {
+    readonly ipc?: IpcProbe;
+    readonly allowRenderer: boolean;
+    /** Why the renderer is off, when it is not the eval grant. */
+    readonly rendererOff?: string;
+    /** Set when main eval is unavailable: only the IPC probe starts. */
+    readonly mainUnavailable?: string;
+}): Promise<{
+    ipc: boolean;
+    ipcUnavailable?: string;
+}>;
+export interface MeasureOptions {
+    readonly allowRenderer: boolean;
+    readonly rendererOff?: string;
+    /** Set when {@link startWindow} already opened a window; otherwise one is run for `windowMs`. */
+    readonly open?: {
+        readonly ipc: boolean;
+        readonly ipcUnavailable?: string;
+    };
+    readonly windowMs: number;
+    readonly ipc?: IpcProbe;
+    readonly sleep?: (ms: number) => Promise<void>;
+    readonly memoryReader?: OsMemoryReader;
+    readonly hostStartTime?: HostStartTimeReader;
+    /** The renderer grant alone; defaults to `allowRenderer`. */
+    readonly allowStartup?: boolean;
+    /**
+     * Why main eval is unavailable (a build with the EnableNodeCliInspectArguments fuse off). Memory
+     * then comes from `memoryProbe` through the renderer; blocking and startup are unmeasured.
+     */
+    readonly mainUnavailable?: string;
+    readonly memoryProbe?: string;
+}
+/** How a sampler reads memory: from main, or through the app's renderer memory probe. */
+export interface MemorySource {
+    readonly mainUnavailable?: string;
+    readonly memoryProbe?: string;
+    readonly allowRenderer: boolean;
+    readonly memoryReader?: OsMemoryReader;
+}
+/**
+ * One memory sample of the app, for a sampler that runs during the window. Only used on an app
+ * this host launched, so the pid-namespace check of {@link measureSession} is skipped.
+ */
+export declare function sampleMemory(session: EvaluatingSession, source: MemorySource): Promise<MemoryMeasurement | undefined>;
+/**
+ * Whether `a` is a heavier sample than `b`. A sample with every process in its own metric beats
+ * one that fell back to working set, which counts in a different unit.
+ */
+export declare function heavierMemory(a: MemoryMeasurement, b: MemoryMeasurement): boolean;
+export interface SessionMeasurement {
+    readonly measurement: Measurement;
+    readonly electronVersion?: string;
+    readonly platform: string;
+}
+/** Close the window (running one first when none is open) and sample memory and startup. */
+export declare function measureSession(session: EvaluatingSession, options: MeasureOptions): Promise<SessionMeasurement>;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

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

package/dist/session.js

@@ -0,0 +1,263 @@
+/**
+ * Measure one live app session through the transport's `evaluate` seam.
+ *
+ * @module
+ */
+import { validateEvalContent } from '@electron-stagewright/core';
+import { measureMemory, osMemoryReader, hostStartTimeReader, } from './memory.js';
+import { DEFAULT_IPC_INTERVAL_MS, IPC_READ_BODY, MAIN_BODY, buildIpcStartBody, buildMemoryProbeBody, } from './probe.js';
+import { memoryByType, memoryTotal, summarizeLatencies, } from './run.js';
+export const MAIN_EVAL_OFF = 'main eval is off; start the server with --allow-eval=main (or bare --allow-eval)';
+export const RENDERER_EVAL_OFF = 'renderer eval is off; start the server with bare --allow-eval to measure it';
+const message = (error) => (error instanceof Error ? error.message : String(error));
+/**
+ * Open a measurement window: arm the main-thread sampler and, when a probe is given and renderer
+ * eval is allowed, the IPC probe loop. Returns why the IPC probe did not start, if it did not.
+ */
+export async function startWindow(session, options) {
+    if (options.mainUnavailable === undefined) {
+        await session.evaluate('main', MAIN_BODY, { op: 'start' });
+    }
+    if (options.ipc === undefined)
+        return { ipc: false };
+    if (!options.allowRenderer) {
+        return { ipc: false, ipcUnavailable: options.rendererOff ?? RENDERER_EVAL_OFF };
+    }
+    try {
+        // The probe is caller-supplied JavaScript: hold it to the same blocklist as the eval tools.
+        validateEvalContent(options.ipc.probe, { target: 'renderer' });
+    }
+    catch (error) {
+        return { ipc: false, ipcUnavailable: `the IPC probe was refused: ${message(error)}` };
+    }
+    try {
+        await session.evaluate('renderer', buildIpcStartBody(options.ipc.probe), {
+            intervalMs: options.ipc.intervalMs ?? DEFAULT_IPC_INTERVAL_MS,
+        });
+        return { ipc: true };
+    }
+    catch (error) {
+        return { ipc: false, ipcUnavailable: `the IPC probe did not start: ${message(error)}` };
+    }
+}
+/** Read the renderer memory probe; throws with the reason it cannot. */
+async function probeMetrics(session, source) {
+    const reason = source.mainUnavailable ?? 'main eval is unavailable';
+    if (source.memoryProbe === undefined) {
+        throw new Error(`${reason}; name a memoryProbe in the budget to measure memory`);
+    }
+    if (!source.allowRenderer)
+        throw new Error(`${reason}, and ${RENDERER_EVAL_OFF}`);
+    try {
+        validateEvalContent(source.memoryProbe, { target: 'renderer' });
+    }
+    catch (error) {
+        throw new Error(`the memory probe was refused: ${message(error)}`);
+    }
+    try {
+        return await session.evaluate('renderer', buildMemoryProbeBody(source.memoryProbe));
+    }
+    catch (error) {
+        throw new Error(`the memory probe failed: ${message(error)}`);
+    }
+}
+/**
+ * One memory sample of the app, for a sampler that runs during the window. Only used on an app
+ * this host launched, so the pid-namespace check of {@link measureSession} is skipped.
+ */
+export async function sampleMemory(session, source) {
+    try {
+        const processes = source.mainUnavailable === undefined
+            ? (await session.evaluate('main', MAIN_BODY, { op: 'facts' })).processes
+            : (await probeMetrics(session, source)).processes;
+        const { memory } = await measureMemory(processes.filter((entry) => isPid(entry.pid)), process.platform, source.memoryReader ?? osMemoryReader(process.platform));
+        return memory;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Memory outside the GPU in the sample's metric, else in working set. */
+function memoryWeight(memory) {
+    const total = memoryTotal(memory, true);
+    if (total !== undefined)
+        return total;
+    const byType = memoryByType({ ...memory, metric: 'workingSet' });
+    return Object.entries(byType).reduce((sum, [type, mb]) => (type === 'gpu' ? sum : sum + mb), 0);
+}
+/**
+ * Whether `a` is a heavier sample than `b`. A sample with every process in its own metric beats
+ * one that fell back to working set, which counts in a different unit.
+ */
+export function heavierMemory(a, b) {
+    const aComplete = memoryTotal(a, true) !== undefined;
+    const bComplete = memoryTotal(b, true) !== undefined;
+    if (aComplete !== bComplete)
+        return aComplete;
+    return memoryWeight(a) > memoryWeight(b);
+}
+async function measureWithoutMain(session, options, open) {
+    const unavailable = {
+        mainThread: options.mainUnavailable,
+        startup: options.mainUnavailable,
+    };
+    const ipc = await readIpc(session, open, unavailable);
+    let memory;
+    let electronVersion;
+    try {
+        const metrics = await probeMetrics(session, options);
+        electronVersion = /Electron\/(\S+)/.exec(metrics.userAgent)?.[1];
+        const measured = await measureMemory(metrics.processes.filter((entry) => isPid(entry.pid)), process.platform, options.memoryReader ?? osMemoryReader(process.platform));
+        memory = measured.memory;
+        if (measured.error !== undefined)
+            unavailable['memory'] = measured.error;
+    }
+    catch (error) {
+        unavailable['memory'] = message(error);
+    }
+    return {
+        measurement: {
+            ...(memory === undefined ? {} : { memory }),
+            ...(ipc === undefined ? {} : { ipc }),
+            unavailable,
+        },
+        ...(electronVersion === undefined ? {} : { electronVersion }),
+        platform: process.platform,
+    };
+}
+async function readIpc(session, open, unavailable) {
+    if (open.ipcUnavailable !== undefined)
+        unavailable['ipc'] = open.ipcUnavailable;
+    if (!open.ipc)
+        return undefined;
+    try {
+        const read = await session.evaluate('renderer', IPC_READ_BODY, {
+            stop: true,
+        });
+        if (read === null) {
+            unavailable['ipc'] = 'the IPC probe was lost; the window navigated during the measurement';
+        }
+        else if (read.samples.length === 0) {
+            unavailable['ipc'] =
+                read.lastError === null
+                    ? 'the IPC probe completed no round trip'
+                    : `the IPC probe failed: ${read.lastError}`;
+        }
+        else {
+            return summarizeLatencies(read.samples);
+        }
+    }
+    catch (error) {
+        unavailable['ipc'] = `could not read the IPC probe: ${message(error)}`;
+    }
+    return undefined;
+}
+/** `ps` start times have whole-second resolution. */
+const START_TIME_TOLERANCE_MS = 2_000;
+/**
+ * Pids come from the app, but the OS reader runs on this host. Refuse to read them when the
+ * host's process with the main pid did not start when the app's main process did.
+ */
+async function hostMismatch(facts, reader) {
+    if (!isPid(facts.pid))
+        return 'the app reported an invalid main pid';
+    if (facts.creationTime === null || reader === undefined)
+        return undefined;
+    const started = await reader(facts.pid);
+    if (started === undefined)
+        return undefined;
+    if (started !== 'missing' && Math.abs(started - facts.creationTime) <= START_TIME_TOLERANCE_MS) {
+        return undefined;
+    }
+    return `pid ${facts.pid} on this host is not the app's main process (another pid namespace?)`;
+}
+/** App-reported pids reach host commands and /proc paths, so only plain pids pass. */
+const isPid = (value) => typeof value === 'number' && Number.isSafeInteger(value) && value > 0;
+/** Close the window (running one first when none is open) and sample memory and startup. */
+export async function measureSession(session, options) {
+    const unavailable = {};
+    const sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    let open = options.open;
+    if (open === undefined) {
+        open = await startWindow(session, {
+            allowRenderer: options.allowRenderer,
+            ...(options.rendererOff === undefined ? {} : { rendererOff: options.rendererOff }),
+            ...(options.ipc === undefined ? {} : { ipc: options.ipc }),
+            ...(options.mainUnavailable === undefined
+                ? {}
+                : { mainUnavailable: options.mainUnavailable }),
+        });
+        await sleep(options.windowMs);
+    }
+    if (options.mainUnavailable !== undefined) {
+        return measureWithoutMain(session, { ...options, mainUnavailable: options.mainUnavailable }, open);
+    }
+    const stall = await session.evaluate('main', MAIN_BODY, {
+        op: 'read',
+        stop: true,
+    });
+    // The app restarted its main process mid-window, or the window outlived MAX_WINDOW_MS.
+    if (stall === null)
+        unavailable['mainThread'] = 'the measurement window was lost or expired';
+    const ipc = await readIpc(session, open, unavailable);
+    const facts = await session.evaluate('main', MAIN_BODY, { op: 'facts' });
+    let reader = options.memoryReader ?? osMemoryReader(facts.platform);
+    const mismatch = reader === undefined
+        ? undefined
+        : await hostMismatch(facts, options.hostStartTime ?? hostStartTimeReader(facts.platform));
+    if (mismatch !== undefined) {
+        reader = () => Promise.reject(new Error(mismatch));
+    }
+    const { memory, error: memoryError } = await measureMemory(facts.processes.filter((entry) => isPid(entry.pid)), facts.platform, reader);
+    if (memoryError !== undefined)
+        unavailable['memory'] = memoryError;
+    let startup;
+    if (options.allowStartup === false) {
+        unavailable['startup'] = RENDERER_EVAL_OFF;
+    }
+    else if (options.allowStartup === undefined && !options.allowRenderer) {
+        unavailable['startup'] = options.rendererOff ?? RENDERER_EVAL_OFF;
+    }
+    else if (facts.creationTime === null) {
+        unavailable['startup'] = 'this Electron does not report the process creation time';
+    }
+    else {
+        try {
+            // Read from main so the first window counts, not whichever renderer is selected.
+            const timing = await session.evaluate('main', MAIN_BODY, {
+                op: 'startup',
+            });
+            if ('error' in timing)
+                throw new Error(timing.error);
+            const firstWindowMs = timing.timeOrigin + timing.loadEventEnd - facts.creationTime;
+            // A later document means the first one was left; pushState keeps the document.
+            const navigated = timing.firstUrl !== null ? timing.url !== timing.firstUrl : (timing.historyLength ?? 1) > 1;
+            if (timing.type !== 'navigate' || navigated) {
+                unavailable['startup'] = 'the first window was reloaded or navigated since launch';
+            }
+            else if (!(timing.loadEventEnd > 0) ||
+                !(firstWindowMs > 0) ||
+                !Number.isFinite(firstWindowMs)) {
+                unavailable['startup'] = 'the window has not finished loading';
+            }
+            else {
+                startup = { firstWindowMs: Math.round(firstWindowMs) };
+            }
+        }
+        catch (error) {
+            unavailable['startup'] = `could not read navigation timing: ${message(error)}`;
+        }
+    }
+    return {
+        measurement: {
+            ...(startup === undefined ? {} : { startup }),
+            memory,
+            ...(stall === null ? {} : { mainThread: stall }),
+            ...(ipc === undefined ? {} : { ipc }),
+            ...(Object.keys(unavailable).length === 0 ? {} : { unavailable }),
+        },
+        ...(facts.electron === null ? {} : { electronVersion: facts.electron }),
+        platform: facts.platform,
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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