mikrojs 0.0.0 → 0.0.8

package/dist/cli/lib/testRunner.js

@@ -0,0 +1,469 @@
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { glob } from 'node:fs/promises';
+import * as pathlib from 'node:path';
+import { catchError, firstValueFrom, last, lastValueFrom, of, scan, takeWhile, tap, timeout, } from 'rxjs';
+import { buildTests } from './build.js';
+import { collectFiles } from './deploy.js';
+import { readBaseline, writeBaseline } from './heapBaseline.js';
+/**
+ * Resolve the deploy root directory for a test run.
+ *
+ * Firmware and sim deploy-done atomically promote only `<staging>/app/` to the
+ * live app dir; anything outside that subtree is dropped. So the build output
+ * must live under an `app/` root that matches the user's project convention.
+ *
+ * We derive this from the package.json "main" field (e.g. `./app/main.ts` →
+ * `app`). Fall back to `app` if main is missing, matching the convention used
+ * by every example in this repo.
+ */
+function resolveAppRoot(cwd) {
+    const pkgPath = pathlib.join(cwd, 'package.json');
+    if (existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+            if (typeof pkg.main === 'string') {
+                const rel = pathlib.relative(cwd, pathlib.resolve(cwd, pkg.main));
+                const dir = pathlib.dirname(rel);
+                if (dir && dir !== '.')
+                    return dir;
+            }
+        }
+        catch {
+            // Fall through to default
+        }
+    }
+    return 'app';
+}
+/**
+ * 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 async function discoverTestFiles(cwd, patterns = []) {
+    const effective = patterns.length === 0 ? ['**/*.test.ts'] : patterns;
+    const results = new Set();
+    for (const pattern of effective) {
+        const abs = pathlib.resolve(cwd, pattern);
+        if (existsSync(abs) && statSync(abs).isFile()) {
+            results.add(abs);
+            continue;
+        }
+        let matched = 0;
+        for await (const m of glob(pattern, { cwd, exclude: ['node_modules/**', 'build/**'] })) {
+            results.add(pathlib.resolve(cwd, m));
+            matched++;
+        }
+        if (matched === 0) {
+            throw new Error(`No test files matched: ${pattern}`);
+        }
+    }
+    return Array.from(results).sort();
+}
+/**
+ * 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 async function runTestManifest(session, testFiles, options, cb = {}) {
+    const cwd = process.cwd();
+    const rootDir = resolveAppRoot(cwd);
+    const relPaths = testFiles.map((f) => pathlib.relative(cwd, f));
+    cb.log?.('Building test manifest...');
+    await lastValueFrom(buildTests(relPaths, options.buildDir, {
+        minify: options.minify,
+        bytecode: options.bytecode,
+        minifier: options.minifier,
+        minifyLevel: options.minifyLevel,
+        rootDir,
+    }), { defaultValue: undefined });
+    const files = await collectFiles(options.buildDir);
+    cb.log?.(`Deploying ${files.length} file(s)`);
+    // Incremental deploy: the device-side supervisor only executes paths
+    // listed in package.json's `tests` array, so stale files from a prior
+    // run are benign (they just sit in flash). Letting the checksum-based
+    // KEEP path run makes re-running `mikro test` after a one-file edit
+    // upload only the changed file instead of the whole manifest.
+    await lastValueFrom(session
+        .deploy({
+        files,
+        envVars: [{ key: 'MIKRO_ENV', value: options.mikroEnv, secret: false }, ...options.envVars],
+        restart: true,
+        // Each test run needs a fresh runtime so the supervisor re-evaluates
+        // the manifest. Without this, a re-run with unchanged files + env
+        // short-circuits to abort+no-restart and the device stays in whatever
+        // state the previous run left it in.
+        alwaysRestart: true,
+    })
+        .pipe(tap((event) => cb.onDeployEvent?.(event))));
+    // Resolve chip before streaming so heap-baseline bookkeeping can run
+    // synchronously inside onFileDone — otherwise the per-file render happens
+    // before heapBaselineAction is set and the user sees no feedback.
+    // ready$ is shareReplay(1) and session.deploy() awaits ready, so this is
+    // cached and resolves immediately.
+    const ready = await firstValueFrom(session.ready$);
+    const chip = ready.chip ?? 'unknown';
+    const wrappedCb = {
+        ...cb,
+        onFileDone: (result, index, total) => {
+            applyHeapBaseline(result, chip, options.updateHeapBaselines ?? false);
+            cb.onFileDone?.(result, index, total);
+        },
+    };
+    cb.log?.('Waiting for test results...');
+    return await collectManifestEvents(session, testFiles, options.timeout, wrappedCb);
+}
+/**
+ * Mutates `result` with chip + heap-baseline bookkeeping fields and writes
+ * the baseline file when appropriate. Must run before the user-visible
+ * render of a TestFileResult so messages like "heap-baseline exceeded" can
+ * appear alongside the file's pass/fail summary.
+ */
+function applyHeapBaseline(result, chip, update) {
+    result.chip = chip;
+    if (typeof result.heapDelta !== 'number')
+        return;
+    const stored = readBaseline(result.file, chip);
+    if (update) {
+        writeBaseline(result.file, chip, result.heapDelta);
+        result.heapBaselineAction = stored === undefined ? 'created' : 'updated';
+        result.heapBaselineStored = result.heapDelta;
+        return;
+    }
+    if (stored === undefined) {
+        writeBaseline(result.file, chip, result.heapDelta);
+        result.heapBaselineAction = 'created';
+        result.heapBaselineStored = result.heapDelta;
+        return;
+    }
+    result.heapBaselineStored = stored;
+    if (result.heapDelta > stored) {
+        result.heapBaselineAction = 'exceeded';
+        return;
+    }
+    // Nudge to tighten the snapshot when actual is well below stored, so
+    // optimizations get locked in rather than leaving slack that masks a
+    // future regression. Margin: max(512B, 25% of stored).
+    const margin = Math.max(512, Math.floor(stored * 0.25));
+    result.heapBaselineAction = result.heapDelta < stored - margin ? 'stale' : 'ok';
+}
+function emptyResult(file) {
+    return {
+        file,
+        passed: 0,
+        failed: 0,
+        skipped: 0,
+        todo: 0,
+        duration: 0,
+        events: [],
+    };
+}
+/**
+ * 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 async function collectManifestEvents(session, testFiles, timeoutMs, cb) {
+    const debug = process.env.MIKRO_DEBUG_EVENTS === '1';
+    /**
+     * Match the firmware supervisor's announcement:
+     *   `[supervisor] running N/M: /app/test/foo.test.js`
+     * We read the path as the authoritative file identity. MSG_READY frames
+     * can arrive any time the CLI sends CMD_HELLO, so they're not reliable
+     * boot signals; the supervisor announce is. */
+    const SUPERVISOR_ANNOUNCE_RE = /^\[supervisor\] running \d+\/\d+: (.+?\.(?:js|bjs))$/;
+    /** Match a device path like `/app/test/foo.test.js` back to its testFiles
+     * index. The device path has a `<rootDir>/` prefix that the CLI's absolute
+     * testFiles don't share, so we match by longest-path-suffix first, then
+     * fall back to a basename match ONLY if it's unambiguous — two test files
+     * sharing a basename must not silently collapse to one index. */
+    function matchDevicePathToIndex(devicePath) {
+        // Strip one leading path component (the rootDir) from the device path,
+        // so `/app/test/foo.test.js` → `test/foo.test.js`.
+        const deviceTail = devicePath.replace(/^\/[^/]+\//, '');
+        for (let i = 0; i < testFiles.length; i++) {
+            const cliPath = testFiles[i].replace(/\.ts$/, '.js');
+            if (devicePath.endsWith(cliPath) || cliPath.endsWith(deviceTail))
+                return i;
+        }
+        // Basename-only fallback — only if exactly one testFile matches, so we
+        // never mis-attribute events between e.g. unit/foo.test.ts and
+        // integration/foo.test.ts.
+        const deviceBase = devicePath.split('/').pop();
+        let basenameMatch = -1;
+        for (let i = 0; i < testFiles.length; i++) {
+            const cliBase = testFiles[i].replace(/\.ts$/, '.js').split('/').pop();
+            if (cliBase === deviceBase) {
+                if (basenameMatch >= 0)
+                    return -1;
+                basenameMatch = i;
+            }
+        }
+        return basenameMatch;
+    }
+    const initialState = {
+        index: 0,
+        seenAnyTestForIndex: false,
+        results: testFiles.map(emptyResult),
+        done: false,
+        doneReason: null,
+        /* No initial onFileStart here — we let the firmware supervisor's
+         * `[supervisor] running N/M: /app/path` announcement drive it. This
+         * keeps a single side-effect path and makes announcements the single
+         * source of truth for file identity, which matters when the device
+         * crash-reboots and re-runs files out of ordinal sequence. */
+        emits: [],
+    };
+    // Sentinel event injected by the timeout operator so the reducer can
+    // close out the current index with a timeout error using the same code
+    // path as other terminal transitions.
+    const TIMEOUT_EVENT = { type: '__timeout' };
+    function reduce(prev, event) {
+        if (prev.done)
+            return { ...prev, emits: [] };
+        const currentFile = testFiles[prev.index];
+        if (!currentFile)
+            return { ...prev, done: true, doneReason: 'manifest_done', emits: [] };
+        if (event.type === '__timeout') {
+            const results = prev.results.slice();
+            if (prev.index < testFiles.length && !results[prev.index]?.error) {
+                results[prev.index] = {
+                    ...results[prev.index],
+                    error: `Timeout after ${timeoutMs}ms`,
+                };
+            }
+            return { ...prev, results, done: true, doneReason: 'timeout', emits: [] };
+        }
+        switch (event.type) {
+            case 'ready':
+                /* Ignore ready events outright. They can arrive whenever the CLI
+                 * sends CMD_HELLO (e.g. during awaitReady$ inside a deploy), so
+                 * they're not reliable boot signals. Real crash detection comes
+                 * from seeing an earlier supervisor-announce path than the current
+                 * index (see below). */
+                return { ...prev, emits: [] };
+            case 'manifest_done':
+                return { ...prev, done: true, doneReason: 'manifest_done', emits: [] };
+            case 'disconnect':
+                return { ...prev, done: true, doneReason: 'disconnect', emits: [] };
+            case 'debug': {
+                /* Supervisor announcements are the authoritative signal for which
+                 * file the device is about to evaluate. Use them to sync the
+                 * CLI's index to whatever the device is actually running — this
+                 * handles out-of-order execution, skipped files, and (critically)
+                 * crash-reboot loops where the device restarts mid-manifest and
+                 * re-runs files from 1. */
+                const match = SUPERVISOR_ANNOUNCE_RE.exec(event.text);
+                if (match) {
+                    const devicePath = match[1];
+                    const targetIndex = matchDevicePathToIndex(devicePath);
+                    if (targetIndex >= 0) {
+                        if (targetIndex < prev.index && prev.seenAnyTestForIndex) {
+                            /* Device jumped back — it crashed and restarted. Bail with
+                             * what we have; the partial results of the current file are
+                             * meaningless now, and re-running earlier files would
+                             * overwrite already-closed results. */
+                            const results = prev.results.slice();
+                            if (!results[prev.index]?.error) {
+                                results[prev.index] = {
+                                    ...results[prev.index],
+                                    error: 'Device restarted unexpectedly during test run',
+                                };
+                            }
+                            return {
+                                ...prev,
+                                results,
+                                done: true,
+                                doneReason: 'crash',
+                                emits: [{ kind: 'log', level: 'error', text: event.text, file: currentFile }],
+                            };
+                        }
+                        if (targetIndex !== prev.index) {
+                            /* Forward jump: the supervisor skipped over some files (or
+                             * we missed their e:6 events). Start the new file. */
+                            return {
+                                ...prev,
+                                index: targetIndex,
+                                seenAnyTestForIndex: false,
+                                emits: [
+                                    {
+                                        kind: 'log',
+                                        level: 'debug',
+                                        text: event.text,
+                                        file: testFiles[targetIndex],
+                                    },
+                                    { kind: 'file_start', file: testFiles[targetIndex], index: targetIndex },
+                                ],
+                            };
+                        }
+                        /* Same index. If we haven't seen any test events for it yet,
+                         * this is the expected "announce for the file e:6 just advanced
+                         * us to" — fire onFileStart now. Otherwise a re-announce (e.g.
+                         * device re-running the same file for some reason) is just a
+                         * log line. */
+                        if (!prev.seenAnyTestForIndex) {
+                            return {
+                                ...prev,
+                                emits: [
+                                    { kind: 'log', level: 'debug', text: event.text, file: currentFile },
+                                    { kind: 'file_start', file: currentFile, index: prev.index },
+                                ],
+                            };
+                        }
+                    }
+                }
+                return {
+                    ...prev,
+                    emits: [{ kind: 'log', level: 'debug', text: event.text, file: currentFile }],
+                };
+            }
+            case 'log':
+            case 'warn':
+            case 'error':
+            case 'info':
+                return {
+                    ...prev,
+                    emits: [{ kind: 'log', level: event.type, text: event.text, file: currentFile }],
+                };
+            case 'raw':
+                /* Raw bytes are non-TLV output from the device (boot banner, panic
+                 * traces). They aren't attributable to a specific test file, so the
+                 * test command's top-level session.messages$ subscription forwards
+                 * them directly. Silently pass through here. */
+                return { ...prev, emits: [] };
+            case 'eval_error': {
+                const results = prev.results.slice();
+                results[prev.index] = {
+                    ...results[prev.index],
+                    error: `Fatal error: ${event.text}`,
+                };
+                return {
+                    ...prev,
+                    results,
+                    emits: [{ kind: 'log', level: 'error', text: event.text, file: currentFile }],
+                };
+            }
+            case 'test':
+                return reduceTestEvent(prev, event, currentFile);
+            default:
+                return { ...prev, emits: [] };
+        }
+    }
+    function reduceTestEvent(prev, event, currentFile) {
+        const d = event.data;
+        const e = d.e;
+        const results = prev.results.slice();
+        const result = {
+            ...results[prev.index],
+            events: [...results[prev.index].events, event],
+        };
+        if (e === 2)
+            result.passed++;
+        else if (e === 3)
+            result.failed++;
+        else if (e === 4)
+            result.skipped++;
+        else if (e === 9)
+            result.todo++;
+        const emits = [{ kind: 'event', event, file: currentFile }];
+        if (e === 6) {
+            result.passed = d.p ?? result.passed;
+            result.failed = d.f ?? result.failed;
+            result.skipped = d.k ?? result.skipped;
+            result.todo = d.o ?? result.todo;
+            result.duration = d.d ?? 0;
+            if (typeof d.hb === 'number' && typeof d.ha === 'number') {
+                result.heapDelta = d.ha - d.hb;
+            }
+            if (typeof d.tb === 'number' && typeof d.ta === 'number') {
+                result.timerDelta = d.ta - d.tb;
+            }
+            if (typeof d.pb === 'number' && typeof d.pa === 'number') {
+                result.pendingDelta = d.pa - d.pb;
+            }
+            emits.push({ kind: 'file_done', result, index: prev.index, file: currentFile });
+            const nextIndex = prev.index + 1;
+            results[prev.index] = result;
+            if (nextIndex < testFiles.length) {
+                /* Don't preemptively fire onFileStart here — the next supervisor
+                 * announcement will drive that. If the device crashes and
+                 * restarts, the expected "next" file is wrong anyway. */
+                return { ...prev, results, index: nextIndex, seenAnyTestForIndex: false, emits };
+            }
+            // Ran out of declared files — natural end of manifest.
+            return {
+                ...prev,
+                results,
+                index: nextIndex,
+                seenAnyTestForIndex: false,
+                done: true,
+                doneReason: 'manifest_done',
+                emits,
+            };
+        }
+        results[prev.index] = result;
+        return { ...prev, results, seenAnyTestForIndex: true, emits };
+    }
+    function applyEmits(state) {
+        for (const e of state.emits) {
+            if (e.kind === 'file_start')
+                cb.onFileStart?.(e.file, e.index, testFiles.length);
+            else if (e.kind === 'file_done')
+                cb.onFileDone?.(e.result, e.index, testFiles.length);
+            else if (e.kind === 'event')
+                cb.onEvent?.(e.event, e.file);
+            else if (e.kind === 'log')
+                cb.onLog?.(e.level, e.text, e.file);
+        }
+    }
+    const final = await lastValueFrom(session.messages$.pipe(
+    // Raw-event diagnostic: logs every event before any filtering, so
+    // we can tell whether session.messages$ is emitting at all or the
+    // issue is further up the pipeline. No-op unless MIKRO_DEBUG_EVENTS=1.
+    tap((event) => {
+        if (debug) {
+            // eslint-disable-next-line no-console
+            console.error(`[raw-ev] ${event.type}`);
+        }
+    }), 
+    // Per-emission timeout: if no event arrives for `timeoutMs`, inject
+    // a synthetic timeout event so the reducer can close out the current
+    // index with a real error message. Good-enough proxy for per-file:
+    // test.ts emits heap events around each test, so an actively-running
+    // file keeps ticking this timer; a hung/crashed device stops
+    // emitting and trips it.
+    timeout({ each: timeoutMs, with: () => of(TIMEOUT_EVENT) }), scan(reduce, initialState), tap((state) => {
+        if (debug) {
+            // eslint-disable-next-line no-console
+            console.error(`[dbg] idx=${state.index} done=${state.done}${state.doneReason ? `(${state.doneReason})` : ''} emits=${state.emits.length}`);
+        }
+        applyEmits(state);
+    }), takeWhile((state) => !state.done, true), last(), catchError((err) => {
+        // Any unexpected stream error ends the run with a diagnostic on
+        // file 0 rather than a silent reject.
+        const results = testFiles.map(emptyResult);
+        results[0].error = `Unexpected stream error: ${String(err)}`;
+        return of({
+            index: 0,
+            seenAnyTestForIndex: false,
+            results,
+            done: true,
+            doneReason: null,
+            emits: [],
+        });
+    })));
+    return final.results;
+}
+//# sourceMappingURL=testRunner.js.map

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

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

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

@@ -0,0 +1,34 @@
+/**
+ * Transport abstraction for the MIK protocol.
+ *
+ * A transport is a bidirectional byte pipe. The protocol layer (session.ts)
+ * builds on top of it. `createSerialTransport` wraps a `serialport` SerialPort
+ * instance; other implementations (loopback, WebSocket) can be added for
+ * testing or alternative connectivity.
+ */
+import { Observable } from 'rxjs';
+import { SerialPort } from 'serialport';
+export interface Transport {
+    /** Push data to the device. Returns a promise that resolves once the
+     *  bytes have been flushed to the OS — important for tiny writes
+     *  (e.g. 5-byte command frames) on macOS, where node-serialport's
+     *  internal queue can otherwise hold them indefinitely behind a
+     *  USB-CDC packet boundary. */
+    write(data: Uint8Array): Promise<void>;
+    /** Observable stream of incoming bytes from the device */
+    data: Observable<Uint8Array>;
+    /** Tear down the transport */
+    close(): void;
+}
+/**
+ * Open a serial port as an Observable. Emits the open port, then completes.
+ * Closing the port on unsubscribe ensures cleanup if the subscriber cancels.
+ */
+export declare function openSerial(path: string, baudRate: number): Observable<SerialPort>;
+/**
+ * Create a transport backed by a SerialPort instance.
+ * The caller owns the SerialPort lifecycle; `close()` removes listeners
+ * but does NOT close the port (the caller may reuse it).
+ */
+export declare function createSerialTransport(serialPort: SerialPort): Transport;
+//# sourceMappingURL=transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAC,UAAU,EAAC,MAAM,MAAM,CAAA;AAC/B,OAAO,EAAC,UAAU,EAAC,MAAM,YAAY,CAAA;AAErC,MAAM,WAAW,SAAS;IACxB;;;;mCAI+B;IAC/B,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtC,0DAA0D;IAC1D,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC,CAAA;IAC5B,8BAA8B;IAC9B,KAAK,IAAI,IAAI,CAAA;CACd;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAmBjF;AAKD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,CAgFvE"}

package/dist/cli/lib/transport.js

@@ -0,0 +1,117 @@
+/**
+ * Transport abstraction for the MIK protocol.
+ *
+ * A transport is a bidirectional byte pipe. The protocol layer (session.ts)
+ * builds on top of it. `createSerialTransport` wraps a `serialport` SerialPort
+ * instance; other implementations (loopback, WebSocket) can be added for
+ * testing or alternative connectivity.
+ */
+import { Observable } from 'rxjs';
+import { SerialPort } from 'serialport';
+/**
+ * Open a serial port as an Observable. Emits the open port, then completes.
+ * Closing the port on unsubscribe ensures cleanup if the subscriber cancels.
+ */
+export function openSerial(path, baudRate) {
+    return new Observable((observer) => {
+        let opened = false;
+        const serial = new SerialPort({ path, baudRate, autoOpen: false });
+        serial.open((err) => {
+            if (err) {
+                observer.error(err);
+            }
+            else {
+                opened = true;
+                observer.next(serial);
+                observer.complete();
+            }
+        });
+        return () => {
+            // Only close if the open was cancelled before completing.
+            // Once emitted, the consumer owns the serial port lifecycle.
+            if (!opened && serial.isOpen)
+                serial.close();
+        };
+    });
+}
+/** Chunk size for serial writes (avoids overflowing device UART FIFO) */
+const WRITE_CHUNK_SIZE = 64;
+/**
+ * Create a transport backed by a SerialPort instance.
+ * The caller owns the SerialPort lifecycle; `close()` removes listeners
+ * but does NOT close the port (the caller may reuse it).
+ */
+export function createSerialTransport(serialPort) {
+    const debugBytes = process.env.MIKRO_DEBUG_SERIAL === '1';
+    const data = new Observable((observer) => {
+        const onData = (chunk) => {
+            if (debugBytes) {
+                // eslint-disable-next-line no-console
+                console.error(`[serial rx ${chunk.length}B] ${chunk.subarray(0, Math.min(chunk.length, 64)).toString('hex')}${chunk.length > 64 ? '...' : ''}`);
+            }
+            observer.next(new Uint8Array(chunk));
+        };
+        const onError = (err) => {
+            if (debugBytes) {
+                // eslint-disable-next-line no-console
+                console.error(`[serial error] ${String(err)}`);
+            }
+            observer.error(err);
+        };
+        const onClose = () => {
+            if (debugBytes) {
+                // eslint-disable-next-line no-console
+                console.error('[serial close]');
+            }
+            observer.complete();
+        };
+        serialPort.on('data', onData);
+        serialPort.on('error', onError);
+        serialPort.on('close', onClose);
+        return () => {
+            serialPort.off('data', onData);
+            serialPort.off('error', onError);
+            serialPort.off('close', onClose);
+        };
+    });
+    return {
+        write(chunk) {
+            if (debugBytes) {
+                // eslint-disable-next-line no-console
+                console.error(`[serial tx ${chunk.length}B] ${Buffer.from(chunk.subarray(0, Math.min(chunk.length, 64))).toString('hex')}${chunk.length > 64 ? '...' : ''}`);
+            }
+            // Write in small chunks with drain to avoid overflowing the device FIFO.
+            // serialport's write() queues internally, so sequential calls are safe.
+            for (let offset = 0; offset < chunk.length; offset += WRITE_CHUNK_SIZE) {
+                const slice = chunk.subarray(offset, offset + WRITE_CHUNK_SIZE);
+                serialPort.write(Buffer.from(slice));
+            }
+            return new Promise((resolve, reject) => {
+                serialPort.drain((err) => {
+                    if (err) {
+                        if (debugBytes) {
+                            // eslint-disable-next-line no-console
+                            console.error(`[serial tx drain error] ${String(err)}`);
+                        }
+                        reject(err);
+                    }
+                    else {
+                        if (debugBytes) {
+                            // eslint-disable-next-line no-console
+                            console.error(`[serial tx drained ${chunk.length}B]`);
+                        }
+                        resolve();
+                    }
+                });
+            });
+        },
+        data,
+        close() {
+            // Remove all our listeners but don't close the port
+            serialPort.removeAllListeners('data');
+            serialPort.removeAllListeners('error');
+            serialPort.removeAllListeners('close');
+        },
+    };
+}
+//# sourceMappingURL=transport.js.map

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

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