@kodycodes/cli 1.23.0 → 1.23.2

package/dist/dev/dev-watcher.d.ts

@@ -0,0 +1,20 @@
+/**
+ * File watching for `kody dev`. chokidar watches the package tree (it re-arms
+ * per-directory watchers when editors or `sed -i` / `cp` replace a file with a
+ * new inode). A low-frequency stat poll over the files in the current bundle
+ * graph backs it up, so a missed event can never leave a stale bundle serving.
+ */
+export type DevWatcher = {
+    ready: Promise<void>;
+    /** Replace the set of absolute paths the stat poll keeps an eye on. */
+    track: (paths: ReadonlyArray<string>) => void;
+    close: () => Promise<void>;
+};
+export declare function createDevWatcher(input: {
+    root: string;
+    onChange: (path: string) => void;
+    /** Extra root-relative path prefixes to ignore. */
+    ignore?: ReadonlyArray<string>;
+    pollIntervalMs?: number;
+}): DevWatcher;
+export declare function shouldIgnoreWatchPath(relativePath: string, ignorePrefixes?: ReadonlyArray<string>): boolean;

package/dist/dev/dev-watcher.js

@@ -0,0 +1,108 @@
+/**
+ * File watching for `kody dev`. chokidar watches the package tree (it re-arms
+ * per-directory watchers when editors or `sed -i` / `cp` replace a file with a
+ * new inode). A low-frequency stat poll over the files in the current bundle
+ * graph backs it up, so a missed event can never leave a stale bundle serving.
+ */
+import { watch } from 'chokidar';
+import { stat } from 'node:fs/promises';
+import { relative, sep } from 'node:path';
+const defaultPollIntervalMs = 1000;
+export function createDevWatcher(input) {
+    const ignorePrefixes = (input.ignore ?? []).map(normalizePrefix).filter(Boolean);
+    const ignored = (path) => shouldIgnoreWatchPath(relative(input.root, path), ignorePrefixes);
+    const watcher = watch(input.root, {
+        ignoreInitial: true,
+        ignored,
+        atomic: true,
+    });
+    watcher.on('all', (_event, path) => {
+        if (!ignored(path))
+            input.onChange(path);
+    });
+    // Init errors reject `ready` (awaited by start). Later errors are swallowed
+    // so a transient watch glitch cannot crash the process.
+    let readySettled = false;
+    const ready = new Promise((resolve, reject) => {
+        watcher.once('ready', () => {
+            readySettled = true;
+            resolve();
+        });
+        watcher.on('error', (error) => {
+            if (readySettled)
+                return;
+            readySettled = true;
+            reject(error instanceof Error ? error : new Error(String(error)));
+        });
+    });
+    let tracked = new Map();
+    let polling = false;
+    const poll = async () => {
+        if (polling)
+            return;
+        polling = true;
+        try {
+            for (const [path, previous] of tracked) {
+                const next = await fingerprint(path);
+                if (!tracked.has(path))
+                    continue;
+                if (previous !== null && next !== previous) {
+                    tracked.set(path, next);
+                    input.onChange(path);
+                }
+                else if (previous === null) {
+                    tracked.set(path, next);
+                }
+            }
+        }
+        finally {
+            polling = false;
+        }
+    };
+    const timer = setInterval(() => void poll(), input.pollIntervalMs ?? defaultPollIntervalMs);
+    timer.unref();
+    return {
+        ready,
+        track: (paths) => {
+            const next = new Map();
+            for (const path of paths) {
+                if (ignored(path))
+                    continue;
+                next.set(path, tracked.get(path) ?? null);
+            }
+            tracked = next;
+            void poll();
+        },
+        close: async () => {
+            clearInterval(timer);
+            tracked = new Map();
+            await watcher.close();
+        },
+    };
+}
+async function fingerprint(path) {
+    try {
+        const info = await stat(path);
+        return `${info.ino}:${info.size}:${info.mtimeMs}`;
+    }
+    catch {
+        return 'missing';
+    }
+}
+function normalizePrefix(prefix) {
+    return prefix.replace(/^\.\//, '').replace(/\/+$/, '').split('/').join(sep);
+}
+export function shouldIgnoreWatchPath(relativePath, ignorePrefixes = []) {
+    if (!relativePath || relativePath === '.')
+        return false;
+    if (relativePath.startsWith('..'))
+        return true;
+    const segments = relativePath.split(sep);
+    if (segments.some((segment) => segment === 'node_modules' || segment.startsWith('.'))) {
+        return true;
+    }
+    if (relativePath.endsWith('.map'))
+        return true;
+    return ignorePrefixes.some((prefix) => relativePath === prefix || relativePath.startsWith(`${prefix}${sep}`));
+}
+//# sourceMappingURL=dev-watcher.js.map

package/dist/dev/dev-watcher.js.map

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

package/dist/dev/error-page.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Dev-only error responses served by the `kody dev` proxy for build failures
+ * and uncaught handler errors. HTML for browsers, plain text for everyone else
+ * (curl, agents, `kody dev fetch`).
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+export type DevErrorKind = 'build' | 'runtime';
+export type DevErrorView = {
+    kind: DevErrorKind;
+    title: string;
+    /** Preformatted body: diagnostics with code frames, or a mapped stack. */
+    detail: string;
+    /** `METHOD /path` for runtime errors. */
+    request?: string;
+};
+export declare function wantsHtml(req: IncomingMessage): boolean;
+export declare function sendDevError(req: IncomingMessage, res: ServerResponse, status: number, view: DevErrorView, options?: {
+    htmlTail?: string;
+}): void;
+export declare function renderDevErrorPage(view: DevErrorView): string;
+export declare function escapeHtml(value: string): string;

package/dist/dev/error-page.js

@@ -0,0 +1,64 @@
+/**
+ * Dev-only error responses served by the `kody dev` proxy for build failures
+ * and uncaught handler errors. HTML for browsers, plain text for everyone else
+ * (curl, agents, `kody dev fetch`).
+ */
+export function wantsHtml(req) {
+    const accept = req.headers.accept ?? '';
+    return /\btext\/html\b/.test(accept);
+}
+export function sendDevError(req, res, status, view, options = {}) {
+    if (res.headersSent) {
+        res.end();
+        return;
+    }
+    const headers = {
+        'cache-control': 'no-store',
+        'x-kody-dev-error': view.kind,
+    };
+    if (wantsHtml(req)) {
+        res.writeHead(status, { ...headers, 'content-type': 'text/html; charset=utf-8' });
+        res.end(renderDevErrorPage(view) + (options.htmlTail ?? ''));
+        return;
+    }
+    res.writeHead(status, { ...headers, 'content-type': 'text/plain; charset=utf-8' });
+    res.end(`kody dev ${view.kind} error${view.request ? ` (${view.request})` : ''}\n\n${view.detail}\n`);
+}
+export function renderDevErrorPage(view) {
+    const label = view.kind === 'build' ? 'Build error' : 'Runtime error';
+    return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>${escapeHtml(label)} · kody dev</title>
+<style>
+	:root { color-scheme: dark; }
+	body { margin: 0; font: 14px/1.5 ui-sans-serif, system-ui, sans-serif; background: #1a1015; color: #f5e9ee; }
+	main { max-width: 960px; margin: 0 auto; padding: 32px 24px; }
+	.label { display: inline-block; font-size: 12px; font-weight: 600; letter-spacing: .04em; text-transform: uppercase; color: #ff8fab; }
+	h1 { font-size: 20px; margin: 8px 0 20px; word-break: break-word; }
+	pre { margin: 0; padding: 16px; overflow: auto; background: #0e080b; border: 1px solid #3a2530; border-radius: 8px; font: 13px/1.55 ui-monospace, SFMono-Regular, Menlo, monospace; white-space: pre; }
+	p { color: #bfa9b3; font-size: 13px; }
+</style>
+</head>
+<body>
+<main>
+<span class="label">${escapeHtml(label)}</span>
+<h1>${escapeHtml(view.title)}</h1>${view.request ? `\n<p>${escapeHtml(view.request)}</p>` : ''}
+<pre>${escapeHtml(view.detail)}</pre>
+<p>Served by <code>kody dev</code> only; published apps never see this page.</p>
+</main>
+</body>
+</html>
+`;
+}
+export function escapeHtml(value) {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+//# sourceMappingURL=error-page.js.map

package/dist/dev/error-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-page.js","sourceRoot":"","sources":["../../src/dev/error-page.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH,MAAM,UAAU,SAAS,CAAC,GAAoB;IAC7C,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAA;IACvC,OAAO,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;AACrC,CAAC;AAED,MAAM,UAAU,YAAY,CAC3B,GAAoB,EACpB,GAAmB,EACnB,MAAc,EACd,IAAkB,EAClB,UAAiC,EAAE;IAEnC,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;QACrB,GAAG,CAAC,GAAG,EAAE,CAAA;QACT,OAAM;IACP,CAAC;IACD,MAAM,OAAO,GAAG;QACf,eAAe,EAAE,UAAU;QAC3B,kBAAkB,EAAE,IAAI,CAAC,IAAI;KAC7B,CAAA;IACD,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,CAAC,CAAA;QACjF,GAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAA;QAC5D,OAAM;IACP,CAAC;IACD,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,2BAA2B,EAAE,CAAC,CAAA;IAClF,GAAG,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,CAAA;AACtG,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAkB;IACpD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,eAAe,CAAA;IACrE,OAAO;;;;;SAKC,UAAU,CAAC,KAAK,CAAC;;;;;;;;;;;;;sBAaJ,UAAU,CAAC,KAAK,CAAC;MACjC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;OACvF,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;;;;;CAK7B,CAAA;AACD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACvC,OAAO,KAAK;SACV,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;AACzB,CAAC"}

package/dist/dev/process-reaper.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Keeps `kody dev` from leaking workerd processes and `/tmp/kody-dev-*` dirs.
+ *
+ * - A tiny detached `sh` reaper holds a pipe from this process. It learns
+ *   workerd pids over that pipe and, when the pipe closes for any reason
+ *   (including SIGKILL of the CLI), kills those pids and removes the work dir.
+ * - On startup, {@link sweepStaleDevDirs} removes dirs and workerd processes
+ *   left behind by dead CLI processes (including CLIs that predate the reaper).
+ */
+export declare const devWorkDirPrefix = "kody-dev-";
+export type ProcessReaper = {
+    track: (pid: number) => void;
+    untrack: (pid: number) => void;
+    close: () => void;
+};
+export declare function startProcessReaper(input: {
+    workDir: string;
+}): Promise<ProcessReaper>;
+type ListedProcess = {
+    pid: number;
+    ppid?: number;
+    name: string;
+    cmd?: string;
+};
+/**
+ * Remove `kody-dev-*` work dirs whose owner is gone and kill workerd processes
+ * still serving from them. Best effort; never throws.
+ */
+export declare function sweepStaleDevDirs(input?: {
+    tmp?: string;
+    now?: number;
+    listProcesses?: () => Promise<Array<ListedProcess>>;
+    isAlive?: (pid: number) => boolean;
+    kill?: (pid: number) => void;
+}): Promise<{
+    removed: Array<string>;
+    killed: Array<number>;
+}>;
+export declare function isProcessAlive(pid: number): boolean;
+export {};

package/dist/dev/process-reaper.js

@@ -0,0 +1,144 @@
+/**
+ * Keeps `kody dev` from leaking workerd processes and `/tmp/kody-dev-*` dirs.
+ *
+ * - A tiny detached `sh` reaper holds a pipe from this process. It learns
+ *   workerd pids over that pipe and, when the pipe closes for any reason
+ *   (including SIGKILL of the CLI), kills those pids and removes the work dir.
+ * - On startup, {@link sweepStaleDevDirs} removes dirs and workerd processes
+ *   left behind by dead CLI processes (including CLIs that predate the reaper).
+ */
+import { spawn } from 'node:child_process';
+import { readdir, readFile, rm, stat, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import psList from 'ps-list';
+export const devWorkDirPrefix = 'kody-dev-';
+const ownerFileName = 'owner.json';
+/** Legacy dirs without an owner file are only removed once this old. */
+const legacyDirMinAgeMs = 10 * 60_000;
+const reaperScript = `
+pids=" "
+while IFS= read -r line; do
+  case "$line" in
+    +*) pids="$pids\${line#+} " ;;
+    -*) pids="$(printf '%s' "$pids" | sed "s/ \${line#-} / /g")" ;;
+  esac
+done
+for pid in $pids; do kill -9 "$pid" 2>/dev/null; done
+rm -rf "$1"
+`;
+export async function startProcessReaper(input) {
+    await writeFile(join(input.workDir, ownerFileName), JSON.stringify({ pid: process.pid, startedAt: new Date().toISOString() }));
+    let reaper;
+    try {
+        reaper = spawn('/bin/sh', ['-c', reaperScript, 'kody-dev-reaper', input.workDir], {
+            stdio: ['pipe', 'ignore', 'ignore'],
+            detached: true,
+        });
+        reaper.on('error', () => {
+            reaper = undefined;
+        });
+        reaper.stdin?.on('error', () => { });
+        reaper.unref();
+        reaper.stdin?.unref?.();
+    }
+    catch {
+        reaper = undefined;
+    }
+    const send = (line) => {
+        if (reaper?.stdin?.writable)
+            reaper.stdin.write(`${line}\n`);
+    };
+    return {
+        track: (pid) => send(`+${pid}`),
+        untrack: (pid) => send(`-${pid}`),
+        close: () => {
+            reaper?.stdin?.end();
+            reaper = undefined;
+        },
+    };
+}
+/**
+ * Remove `kody-dev-*` work dirs whose owner is gone and kill workerd processes
+ * still serving from them. Best effort; never throws.
+ */
+export async function sweepStaleDevDirs(input = {}) {
+    const tmp = input.tmp ?? tmpdir();
+    const now = input.now ?? Date.now();
+    const isAlive = input.isAlive ?? isProcessAlive;
+    const kill = input.kill ?? ((pid) => process.kill(pid, 'SIGKILL'));
+    const removed = [];
+    const killed = [];
+    let entries;
+    try {
+        entries = (await readdir(tmp)).filter((name) => name.startsWith(devWorkDirPrefix));
+    }
+    catch {
+        return { removed, killed };
+    }
+    if (entries.length === 0)
+        return { removed, killed };
+    let processes = [];
+    try {
+        processes = await (input.listProcesses ?? psList)();
+    }
+    catch {
+        processes = [];
+    }
+    const byPid = new Map(processes.map((item) => [item.pid, item]));
+    for (const name of entries) {
+        const dir = join(tmp, name);
+        try {
+            const owner = await readOwnerPid(dir);
+            if (owner !== null && isAlive(owner))
+                continue;
+            const workerds = processes.filter((item) => /workerd/.test(item.name) && (item.cmd ?? '').includes(`${dir}/`));
+            if (owner === null) {
+                const info = await stat(dir);
+                if (now - info.mtimeMs < legacyDirMinAgeMs)
+                    continue;
+                // Legacy CLI without an owner file: only reap workerds whose parent died.
+                if (workerds.some((item) => !isOrphaned(item, byPid, isAlive)))
+                    continue;
+            }
+            for (const item of workerds) {
+                try {
+                    kill(item.pid);
+                    killed.push(item.pid);
+                }
+                catch { }
+            }
+            await rm(dir, { recursive: true, force: true });
+            removed.push(dir);
+        }
+        catch { }
+    }
+    return { removed, killed };
+}
+function isOrphaned(item, byPid, isAlive) {
+    if (item.ppid === undefined)
+        return false;
+    if (item.ppid <= 1 || !isAlive(item.ppid))
+        return true;
+    const parent = byPid.get(item.ppid);
+    return parent !== undefined && !/node|kody/i.test(`${parent.name} ${parent.cmd ?? ''}`);
+}
+async function readOwnerPid(dir) {
+    try {
+        const parsed = JSON.parse(await readFile(join(dir, ownerFileName), 'utf8'));
+        return typeof parsed.pid === 'number' ? parsed.pid : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === 'EPERM';
+    }
+}
+//# sourceMappingURL=process-reaper.js.map

package/dist/dev/process-reaper.js.map

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

package/dist/dev/stack-trace.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Turn a workerd V8 stack (frames point into the bundled `main.js`) into one
+ * that points at the author's `.ts` sources, without runtime wrapper frames.
+ */
+export type StackMapper = (stack: string) => string;
+export declare function createStackMapper(input: {
+    /** esbuild source map JSON for the user module, sources relative to the package root. */
+    sourceMap: string | null;
+    /** Module name of the bundled user code inside workerd. */
+    userModule: string;
+}): StackMapper;

package/dist/dev/stack-trace.js

@@ -0,0 +1,56 @@
+/**
+ * Turn a workerd V8 stack (frames point into the bundled `main.js`) into one
+ * that points at the author's `.ts` sources, without runtime wrapper frames.
+ */
+import { originalPositionFor, TraceMap } from '@jridgewell/trace-mapping';
+const internalModules = new Set([
+    '__kody_local_entry.js',
+    'kody:runtime',
+    '.__kody_runtime__.js',
+    'runtime.js',
+    'entry.js',
+]);
+const framePattern = /^(\s*at\s+)(?:(.*?)\s+\()?([^()\s]+?):(\d+):(\d+)\)?\s*$/;
+export function createStackMapper(input) {
+    let map = null;
+    if (input.sourceMap) {
+        try {
+            map = new TraceMap(input.sourceMap);
+        }
+        catch {
+            map = null;
+        }
+    }
+    return (stack) => {
+        const out = [];
+        for (const line of stack.split('\n')) {
+            if (!/^\s*at\s/.test(line)) {
+                out.push(line);
+                continue;
+            }
+            const match = framePattern.exec(line);
+            if (!match)
+                continue;
+            const [, lead, fn, file, lineText, colText] = match;
+            const module = file.replace(/^file:\/\/\//, '').replace(/^\//, '');
+            if (internalModules.has(module))
+                continue;
+            const fnPart = fn ? `${fn} (` : '';
+            const close = fn ? ')' : '';
+            if (map && module === input.userModule) {
+                const original = originalPositionFor(map, {
+                    line: Number(lineText),
+                    column: Number(colText) - 1,
+                });
+                if (original.source && original.line !== null) {
+                    const name = fn ?? original.name;
+                    out.push(`${lead}${name ? `${name} (` : ''}${original.source}:${original.line}:${(original.column ?? 0) + 1}${name ? ')' : ''}`);
+                    continue;
+                }
+            }
+            out.push(`${lead}${fnPart}${file}:${lineText}:${colText}${close}`);
+        }
+        return out.join('\n');
+    };
+}
+//# sourceMappingURL=stack-trace.js.map

package/dist/dev/stack-trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-trace.js","sourceRoot":"","sources":["../../src/dev/stack-trace.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AAEzE,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC/B,uBAAuB;IACvB,cAAc;IACd,sBAAsB;IACtB,YAAY;IACZ,UAAU;CACV,CAAC,CAAA;AAEF,MAAM,YAAY,GAAG,0DAA0D,CAAA;AAI/E,MAAM,UAAU,iBAAiB,CAAC,KAKjC;IACA,IAAI,GAAG,GAAoB,IAAI,CAAA;IAC/B,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACrB,IAAI,CAAC;YACJ,GAAG,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QACpC,CAAC;QAAC,MAAM,CAAC;YACR,GAAG,GAAG,IAAI,CAAA;QACX,CAAC;IACF,CAAC;IACD,OAAO,CAAC,KAAK,EAAE,EAAE;QAChB,MAAM,GAAG,GAAkB,EAAE,CAAA;QAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACd,SAAQ;YACT,CAAC;YACD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACrC,IAAI,CAAC,KAAK;gBAAE,SAAQ;YACpB,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,KAAK,CAAA;YACnD,MAAM,MAAM,GAAG,IAAK,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;YACnE,IAAI,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,SAAQ;YACzC,MAAM,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAA;YAClC,MAAM,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;YAC3B,IAAI,GAAG,IAAI,MAAM,KAAK,KAAK,CAAC,UAAU,EAAE,CAAC;gBACxC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,GAAG,EAAE;oBACzC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC;oBACtB,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;iBAC3B,CAAC,CAAA;gBACF,IAAI,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;oBAC/C,MAAM,IAAI,GAAG,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAA;oBAChC,GAAG,CAAC,IAAI,CACP,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACtH,CAAA;oBACD,SAAQ;gBACT,CAAC;YACF,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,IAAI,QAAQ,IAAI,OAAO,GAAG,KAAK,EAAE,CAAC,CAAA;QACnE,CAAC;QACD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACtB,CAAC,CAAA;AACF,CAAC"}

package/dist/dev/workerd-process.d.ts

@@ -0,0 +1,28 @@
+/**
+ * One workerd `serve` process for `kody dev`: spawn, wait for the control-fd
+ * `listen` event, stream stdout/stderr line by line, and stop it.
+ */
+export type WorkerdHandle = {
+    pid: number;
+    port: number;
+    /** Resolves with a short exit description once the process is gone. */
+    exited: Promise<string>;
+    kill: () => Promise<void>;
+};
+export declare function startWorkerd(input: {
+    workerdPath: string;
+    configPath: string;
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    /** Called synchronously after spawn so callers can track the pid before listen. */
+    onSpawn?: (pid: number) => void;
+    onStdoutLine: (line: string) => void;
+    onStderrLine: (line: string) => void;
+}): Promise<WorkerdHandle>;
+export declare function parseListenPort(line: string): number | null;
+/**
+ * Make workerd stderr readable: drop native `stack: …workerd@0x…` address
+ * lines and the C++ source prefix on uncaught-exception lines. Returns null
+ * for lines that carry nothing for a JS developer.
+ */
+export declare function cleanWorkerdStderrLine(line: string): string | null;

package/dist/dev/workerd-process.js

@@ -0,0 +1,118 @@
+/**
+ * One workerd `serve` process for `kody dev`: spawn, wait for the control-fd
+ * `listen` event, stream stdout/stderr line by line, and stop it.
+ */
+import { spawn } from 'node:child_process';
+import { createInterface } from 'node:readline';
+import { redact } from '../redact.js';
+const workerdStartTimeoutMs = 30_000;
+export async function startWorkerd(input) {
+    const child = spawn(input.workerdPath, ['serve', input.configPath, '--control-fd=3'], {
+        cwd: input.cwd,
+        env: input.env,
+        stdio: ['ignore', 'pipe', 'pipe', 'pipe'],
+    });
+    if (child.pid !== undefined)
+        input.onSpawn?.(child.pid);
+    let startupStderr = '';
+    let listening = false;
+    forEachLine(child.stdout, input.onStdoutLine);
+    forEachLine(child.stderr, (line) => {
+        if (!listening)
+            startupStderr += `${line}\n`;
+        input.onStderrLine(line);
+    });
+    const exited = new Promise((resolve) => {
+        child.once('exit', (code, signal) => resolve(`workerd exit ${signal ?? code}`));
+        child.once('error', (error) => resolve(`workerd error: ${error.message}`));
+    });
+    const port = await waitForListen(child, exited, () => {
+        const trimmed = redact(startupStderr.trim());
+        return trimmed ? `\n${trimmed}` : '';
+    });
+    listening = true;
+    return {
+        pid: child.pid ?? -1,
+        port,
+        exited,
+        kill: async () => {
+            if (child.exitCode !== null || child.signalCode !== null)
+                return;
+            child.kill('SIGKILL');
+            await Promise.race([exited, new Promise((resolve) => setTimeout(resolve, 1000))]);
+        },
+    };
+}
+function forEachLine(stream, onLine) {
+    if (!stream)
+        return;
+    const lines = createInterface({ input: stream, crlfDelay: Infinity });
+    lines.on('line', (line) => {
+        if (line.length > 0)
+            onLine(line);
+    });
+}
+function waitForListen(child, exited, stderr) {
+    return new Promise((resolve, reject) => {
+        const control = child.stdio[3];
+        let buffered = '';
+        let settled = false;
+        const settle = (fn) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            fn();
+        };
+        const timer = setTimeout(() => {
+            settle(() => {
+                child.kill('SIGKILL');
+                reject(new Error(`workerd did not start within ${workerdStartTimeoutMs / 1000}s.${stderr()}`));
+            });
+        }, workerdStartTimeoutMs);
+        control?.on('data', (chunk) => {
+            buffered += chunk.toString('utf8');
+            const lines = buffered.split('\n');
+            buffered = lines.pop() ?? '';
+            for (const line of lines) {
+                const port = parseListenPort(line);
+                if (port !== null)
+                    settle(() => resolve(port));
+            }
+        });
+        void exited.then((detail) => {
+            settle(() => reject(new Error(`workerd failed to start (${detail})${stderr()}`)));
+        });
+    });
+}
+export function parseListenPort(line) {
+    if (!line.trim())
+        return null;
+    try {
+        const event = JSON.parse(line);
+        return event.event === 'listen' && event.socket === 'http' && typeof event.port === 'number'
+            ? event.port
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Make workerd stderr readable: drop native `stack: …workerd@0x…` address
+ * lines and the C++ source prefix on uncaught-exception lines. Returns null
+ * for lines that carry nothing for a JS developer.
+ */
+export function cleanWorkerdStderrLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return null;
+    if (/^stack:(\s+\S+@[0-9a-fx]+)+\s*$/i.test(trimmed))
+        return null;
+    const prefixed = /^workerd\/\S+:\d+: (?:error|warning|info|debug): (.*)$/.exec(trimmed);
+    const body = prefixed ? prefixed[1] : trimmed;
+    return body
+        .replace(/\S+\.(?:c\+\+|h):\d+: failed: /g, '')
+        .replace(/(?:remote\.)?jsg\.(\w*Error)(?=:)/g, '$1');
+}
+//# sourceMappingURL=workerd-process.js.map

package/dist/dev/workerd-process.js.map

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