mikrojs 0.0.0 → 0.0.7

package/dist/cli/lib/simPid.js

@@ -0,0 +1,112 @@
+/**
+ * Pid file management for the simulator.
+ *
+ * One sim process at a time per project. Long-lived commands (`mikro sim dev`,
+ * `mikro sim repl`) claim the pid file and kill any predecessor. Short-lived
+ * commands (`mikro sim deploy`, `mikro sim test`, etc.) check the pid file
+ * and refuse to run if a sim is already alive — they would race on sim-fs
+ * writes or yank files out from under the running process.
+ */
+import { existsSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
+import * as pathlib from 'node:path';
+const PID_FILE = 'sim.pid';
+function pidPath(mikroDir) {
+    return pathlib.join(mikroDir, PID_FILE);
+}
+export function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        if (err.code === 'EPERM')
+            return true;
+        return false;
+    }
+}
+export function readPid(mikroDir) {
+    const file = pidPath(mikroDir);
+    if (!existsSync(file))
+        return null;
+    try {
+        const raw = readFileSync(file, 'utf-8').trim();
+        const pid = parseInt(raw, 10);
+        if (!Number.isFinite(pid) || pid <= 0)
+            return null;
+        if (!isAlive(pid)) {
+            try {
+                unlinkSync(file);
+            }
+            catch { }
+            return null;
+        }
+        return pid;
+    }
+    catch {
+        return null;
+    }
+}
+export function clearPid(mikroDir) {
+    const file = pidPath(mikroDir);
+    try {
+        unlinkSync(file);
+    }
+    catch { }
+}
+export class SimAlreadyRunningError extends Error {
+    pid;
+    constructor(pid) {
+        super(`a sim is already running (pid ${pid}). Stop it with Ctrl-C in that terminal, then try again.`);
+        this.name = 'SimAlreadyRunningError';
+        this.pid = pid;
+    }
+}
+/**
+ * Refuse to proceed if a sim is already running. Used by short-lived commands
+ * (deploy, test, env, profile, clean, reset).
+ */
+export function checkPid(mikroDir) {
+    const pid = readPid(mikroDir);
+    if (pid !== null)
+        throw new SimAlreadyRunningError(pid);
+}
+/**
+ * Claim the pid file for this process. If a predecessor is alive, kill it
+ * first (SIGTERM, then SIGKILL after a short grace period). Registers exit
+ * cleanup to remove the file on normal termination.
+ *
+ * Used by long-lived commands (dev, repl).
+ */
+export async function claimPid(mikroDir) {
+    const file = pidPath(mikroDir);
+    const existing = readPid(mikroDir);
+    if (existing !== null) {
+        try {
+            process.kill(existing, 'SIGTERM');
+        }
+        catch { }
+        const deadline = Date.now() + 2000;
+        while (Date.now() < deadline && isAlive(existing)) {
+            await new Promise((r) => setTimeout(r, 50));
+        }
+        if (isAlive(existing)) {
+            try {
+                process.kill(existing, 'SIGKILL');
+            }
+            catch { }
+            await new Promise((r) => setTimeout(r, 50));
+        }
+    }
+    writeFileSync(file, String(process.pid));
+    const cleanup = () => clearPid(mikroDir);
+    process.once('exit', cleanup);
+    process.once('SIGINT', () => {
+        cleanup();
+        process.exit(130);
+    });
+    process.once('SIGTERM', () => {
+        cleanup();
+        process.exit(143);
+    });
+}
+//# sourceMappingURL=simPid.js.map

package/dist/cli/lib/simPid.js.map

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

package/dist/cli/lib/simTransport.d.ts

@@ -0,0 +1,17 @@
+/**
+ * IPC transport for the simulator subprocess.
+ *
+ * Spawns simProcess.js as a child process and wraps its stdin/stdout
+ * as a Transport, identical to createSerialTransport but over stdio pipes.
+ */
+import type { Transport } from './transport.js';
+export interface SimTransportOptions {
+    fsRoot: string;
+    memLimit?: number;
+    fsLimit?: number;
+    fsReadMax?: number;
+    /** Path to project directory for sim/ stubs */
+    simDir?: string;
+}
+export declare function createSimTransport(options: SimTransportOptions): Transport;
+//# sourceMappingURL=simTransport.d.ts.map

package/dist/cli/lib/simTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simTransport.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/simTransport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,gBAAgB,CAAA;AAE7C,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,CA8E1E"}

package/dist/cli/lib/simTransport.js

@@ -0,0 +1,80 @@
+/**
+ * IPC transport for the simulator subprocess.
+ *
+ * Spawns simProcess.js as a child process and wraps its stdin/stdout
+ * as a Transport, identical to createSerialTransport but over stdio pipes.
+ */
+import { spawn } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { Observable } from 'rxjs';
+export function createSimTransport(options) {
+    const entryPath = fileURLToPath(new URL('../../simulator/simProcess.js', import.meta.url));
+    const args = ['--fs-root', options.fsRoot];
+    if (options.memLimit)
+        args.push('--mem-limit', String(options.memLimit));
+    if (options.fsLimit)
+        args.push('--fs-limit', String(options.fsLimit));
+    if (options.fsReadMax)
+        args.push('--fs-read-max', String(options.fsReadMax));
+    if (options.simDir)
+        args.push('--sim-dir', options.simDir);
+    // Inherit stderr so fatal errors and warnings from simProcess surface in the
+    // user's terminal. Previously this was 'ignore', which meant a crashing
+    // subprocess would manifest only as a cryptic EPIPE on the parent when the
+    // next TLV frame was written. simProcess only writes to stderr on real
+    // problems, so inheriting it doesn't pollute normal runs.
+    const child = spawn(process.execPath, [entryPath, ...args], {
+        stdio: ['pipe', 'pipe', 'inherit'],
+    });
+    // Track child exit so we can synthesize a clear error for writes that
+    // race with a dead subprocess (otherwise EPIPE becomes an unhandled 'error'
+    // event and crashes the parent).
+    let exitInfo = null;
+    child.on('exit', (code, signal) => {
+        exitInfo = { code, signal };
+    });
+    // Install an error listener on stdin so EPIPE from writes doesn't crash the
+    // parent. We surface it via the data observable instead.
+    child.stdin?.on('error', () => {
+        /* swallowed here; write() below re-reports as a transport error */
+    });
+    const data = new Observable((subscriber) => {
+        const onData = (chunk) => subscriber.next(new Uint8Array(chunk));
+        const onEnd = () => subscriber.complete();
+        const onError = (err) => subscriber.error(err);
+        const onExit = () => {
+            if (exitInfo && exitInfo.code !== 0) {
+                subscriber.error(new Error(`simProcess exited unexpectedly (code=${exitInfo.code} signal=${exitInfo.signal ?? 'none'})`));
+            }
+            else {
+                subscriber.complete();
+            }
+        };
+        child.stdout.on('data', onData);
+        child.stdout.on('end', onEnd);
+        child.stdout.on('error', onError);
+        child.on('exit', onExit);
+        return () => {
+            child.stdout.off('data', onData);
+            child.stdout.off('end', onEnd);
+            child.stdout.off('error', onError);
+            child.off('exit', onExit);
+        };
+    });
+    return {
+        write(chunk) {
+            if (exitInfo !== null) {
+                return Promise.reject(new Error(`cannot write to simProcess: subprocess has exited (code=${exitInfo.code} signal=${exitInfo.signal ?? 'none'})`));
+            }
+            return new Promise((resolve, reject) => {
+                child.stdin.write(Buffer.from(chunk), (err) => (err ? reject(err) : resolve()));
+            });
+        },
+        data,
+        close() {
+            child.stdin.end();
+            child.kill();
+        },
+    };
+}
+//# sourceMappingURL=simTransport.js.map

package/dist/cli/lib/simTransport.js.map

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

package/dist/cli/lib/testRunner.d.ts

@@ -0,0 +1,86 @@
+import type { Minifier, MinifyLevel } from '../../_exports/index.js';
+import { type EnvVar } from './deploy.js';
+import type { DeployEvent, ReplSession, TestEvent } from './session.js';
+export type HeapBaselineAction = 'created' | 'ok' | 'exceeded' | 'updated' | 'stale';
+export interface TestFileResult {
+    file: string;
+    passed: number;
+    failed: number;
+    skipped: number;
+    todo: number;
+    duration: number;
+    events: TestEvent[];
+    error?: string;
+    /** heapUsed delta (bytes) between run start and end, after gc on both sides */
+    heapDelta?: number;
+    /** Net timer count change between run start and end (should be 0) */
+    timerDelta?: number;
+    /** Net in-flight HTTP request count change (should be 0). Detects fetches
+     *  that were initiated but not cancelled or awaited before teardown. */
+    pendingDelta?: number;
+    /** Chip reported by the device (e.g. "esp32c6", "host"). Used as baseline key. */
+    chip?: string;
+    /** Stored baseline value for this chip (if a baseline file existed) */
+    heapBaselineStored?: number;
+    /** What happened to the heap-baseline file this run */
+    heapBaselineAction?: HeapBaselineAction;
+}
+export interface TestRunOptions {
+    minify: boolean;
+    bytecode: boolean;
+    minifier?: Minifier;
+    minifyLevel?: MinifyLevel;
+    envVars: EnvVar[];
+    timeout: number;
+    buildDir: string;
+    /** Value of MIKRO_ENV to set during the test run (e.g. 'test', 'simulator'). */
+    mikroEnv: string;
+    /** If true, write the current heapDelta as the new baseline for the current chip. */
+    updateHeapBaselines?: boolean;
+}
+/**
+ * Resolve test files from a list of patterns. Each pattern may be:
+ *   - an explicit path to an existing file (included directly)
+ *   - a glob pattern (expanded against cwd, excluding node_modules/build)
+ *
+ * With no patterns, falls back to the default `**\/*.test.ts` glob. Patterns
+ * that match nothing throw — a typo in a path shouldn't silently run zero
+ * tests.
+ */
+export declare function discoverTestFiles(cwd: string, patterns?: readonly string[]): Promise<string[]>;
+export interface TestManifestCallbacks {
+    /** Called with the test file about to start (based on deploy manifest order). */
+    onFileStart?: (file: string, index: number, total: number) => void;
+    /** Called when a file's run_done event arrives, closing out its result. */
+    onFileDone?: (result: TestFileResult, index: number, total: number) => void;
+    /** Per-event hook (suite/test events). */
+    onEvent?: (event: TestEvent, file: string) => void;
+    /** Console output forwarding. */
+    onLog?: (level: string, text: string, file: string) => void;
+    /** Deploy-phase progress. Fired for each DeployEvent before tests start. */
+    onDeployEvent?: (event: DeployEvent) => void;
+    /** Generic progress messages. */
+    log?: (msg: string) => void;
+}
+/**
+ * Build the test manifest, deploy once, and observe the device supervisor
+ * stream as each test file runs in its own fresh runtime. Returns one
+ * TestFileResult per input, with heap-baseline bookkeeping applied.
+ */
+export declare function runTestManifest(session: ReplSession, testFiles: string[], options: TestRunOptions, cb?: TestManifestCallbacks): Promise<TestFileResult[]>;
+/**
+ * Demultiplex the device event stream per file. Each run_done (e:6) closes
+ * the current file and advances the index; manifest_done ends the run.
+ *
+ * Readiness handling: the initial deploy restarts the device once, so a
+ * single ready event is expected before test 1. Any subsequent ready event
+ * (after test 1's first event) indicates an unexpected reboot — treat as a
+ * crash and bail, returning partial results.
+ */
+/**
+ * Observe the device event stream and produce one TestFileResult per test
+ * file. Exported so the reducer's contract with the firmware supervisor
+ * can be unit-tested without going through the real build+deploy path.
+ */
+export declare function collectManifestEvents(session: ReplSession, testFiles: string[], timeoutMs: number, cb: TestManifestCallbacks): Promise<TestFileResult[]>;
+//# sourceMappingURL=testRunner.d.ts.map

package/dist/cli/lib/testRunner.d.ts.map

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