@kodycodes/cli 1.23.1 → 1.23.2

package/README.md

@@ -240,6 +240,32 @@ kody execute --local --invoke kody:@scope/pkg/export --params '{}'
 kody search --target mock local
 ```
 
+### What `kody dev` does while it runs
+
+- **Rebuilds never drop requests.** A save starts a new workerd, and the proxy
+  switches to it only once it is listening. The old one finishes its in-flight
+  requests and then stops. Requests that arrive mid-rebuild wait for it, so you
+  never get a `503` or the previous bundle after a save.
+- **Watching survives editors and scripts.** chokidar watches the package
+  (skipping `node_modules`, dotfiles, and `*.map`). A 1s stat poll over the
+  files in the current bundle graph backs it up, so replaced files (`sed -i`,
+  `cp`, atomic saves) are always picked up.
+- **Build errors** print `file:line:col: message` with a code frame. Until the
+  next good build, every request gets a `500` error page with the same text
+  (HTML for browsers, plain text otherwise, header `x-kody-dev-error: build`).
+  The last good build does not keep answering `200`.
+- **Runtime errors**: an uncaught throw from the fetch handler returns a
+  dev-only `500` page with the stack mapped back to your `.ts` sources
+  (`x-kody-dev-error: runtime`). Runtime wrapper and native frames are
+  dropped. The terminal prints the same stack.
+- **Logs**: app `console.*` output streams to the terminal tagged with the
+  request, e.g. `[GET /scores #12] saved 3 rows`. `warn` and `error` go to
+  stderr.
+- **Cleanup**: Ctrl-C, `SIGTERM`, and `SIGHUP` stop workerd and remove the
+  `kody-dev-*` temp dir. If the CLI is killed outright, a small reaper process
+  does the same. Each start also sweeps dirs and orphaned workerd processes
+  left behind by dead CLI runs, including older CLI versions.
+
 ## Local execute
 
 `kody execute --local` runs the same execute module (default export called

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

@@ -0,0 +1,25 @@
+/**
+ * `kody dev` bundles of `kody.app.entry`: same esbuild options as one-shot
+ * local bundles, plus an in-memory source map (for mapping workerd stacks back
+ * to `.ts`) and the list of input files (for the watcher's stat poll).
+ */
+import * as esbuild from 'esbuild';
+export type DevBundle = {
+    code: string;
+    /** Source map JSON with sources relative to the package root. */
+    sourceMap: string | null;
+    /** Absolute paths of every non-node_modules input in the graph. */
+    inputs: Array<string>;
+};
+export type DevBundler = {
+    build: () => Promise<DevBundle>;
+    dispose: () => Promise<void>;
+};
+export declare function createDevBundler(input: {
+    entryPath: string;
+    root: string;
+}): DevBundler;
+export declare function readBundle(result: esbuild.BuildResult<{
+    metafile: true;
+    write: false;
+}>, workingDir: string, entryPath: string): DevBundle;

package/dist/dev/dev-bundler.js

@@ -0,0 +1,51 @@
+/**
+ * `kody dev` bundles of `kody.app.entry`: same esbuild options as one-shot
+ * local bundles, plus an in-memory source map (for mapping workerd stacks back
+ * to `.ts`) and the list of input files (for the watcher's stat poll).
+ */
+import * as esbuild from 'esbuild';
+import { join, resolve } from 'node:path';
+import { BundleError, createBundleError, localBundleOptions } from '../local-bundle.js';
+export function createDevBundler(input) {
+    const entry = resolve(input.entryPath);
+    const base = localBundleOptions(entry);
+    const options = {
+        ...base,
+        sourcemap: 'external',
+        sourcesContent: false,
+        metafile: true,
+        // Never written (write: false); only anchors source map paths at the root.
+        outfile: join(input.root, '__kody_dev_bundle.js'),
+    };
+    const paths = { workingDir: base.absWorkingDir, displayRoot: input.root };
+    return {
+        build: async () => {
+            let result;
+            try {
+                result = await esbuild.build(options);
+            }
+            catch (error) {
+                throw createBundleError(input.entryPath, error, paths);
+            }
+            return readBundle(result, base.absWorkingDir, input.entryPath);
+        },
+        dispose: async () => { },
+    };
+}
+export function readBundle(result, workingDir, entryPath) {
+    const outputs = result.outputFiles ?? [];
+    const js = outputs.find((file) => file.path.endsWith('.js'));
+    const map = outputs.find((file) => file.path.endsWith('.js.map'));
+    if (!js) {
+        throw new BundleError(`Could not bundle ${entryPath}: esbuild produced no output.`, []);
+    }
+    const inputs = Object.keys(result.metafile?.inputs ?? {})
+        .filter((path) => !path.includes('node_modules') && !path.includes(':'))
+        .map((path) => resolve(workingDir, path));
+    return {
+        code: js.text.replace(/\n\/\/# sourceMappingURL=\S+\s*$/, '\n'),
+        sourceMap: map?.text ?? null,
+        inputs,
+    };
+}
+//# sourceMappingURL=dev-bundler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dev-bundler.js","sourceRoot":"","sources":["../../src/dev/dev-bundler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAA;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAevF,MAAM,UAAU,gBAAgB,CAAC,KAA0C;IAC1E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IACtC,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAA;IACtC,MAAM,OAAO,GAAG;QACf,GAAG,IAAI;QACP,SAAS,EAAE,UAAU;QACrB,cAAc,EAAE,KAAK;QACrB,QAAQ,EAAE,IAAI;QACd,2EAA2E;QAC3E,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,sBAAsB,CAAC;KAClB,CAAA;IAChC,MAAM,KAAK,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,CAAA;IAEzE,OAAO;QACN,KAAK,EAAE,KAAK,IAAI,EAAE;YACjB,IAAI,MAA2C,CAAA;YAC/C,IAAI,CAAC;gBACJ,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YACtC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,iBAAiB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;YACvD,CAAC;YACD,OAAO,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,CAAA;QAC/D,CAAC;QACD,OAAO,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;KACvB,CAAA;AACF,CAAC;AAED,MAAM,UAAU,UAAU,CACzB,MAA6D,EAC7D,UAAkB,EAClB,SAAiB;IAEjB,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAA;IACxC,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;IAC5D,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAA;IACjE,IAAI,CAAC,EAAE,EAAE,CAAC;QACT,MAAM,IAAI,WAAW,CAAC,oBAAoB,SAAS,+BAA+B,EAAE,EAAE,CAAC,CAAA;IACxF,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,CAAC;SACvD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;SACvE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAA;IAC1C,OAAO;QACN,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,kCAAkC,EAAE,IAAI,CAAC;QAC/D,SAAS,EAAE,GAAG,EAAE,IAAI,IAAI,IAAI;QAC5B,MAAM;KACN,CAAA;AACF,CAAC"}

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

@@ -0,0 +1,50 @@
+/**
+ * Events a running `kody dev` server reports: rebuilds, build and runtime
+ * errors, and app logs. Humans get {@link formatDevEvent}; agents get the
+ * same objects as NDJSON.
+ */
+import { type BundleDiagnostic } from '../local-bundle.js';
+export type DevRequestTag = {
+    id: string;
+    method: string;
+    path: string;
+};
+export type DevLogLevel = 'log' | 'info' | 'warn' | 'error' | 'debug';
+export type DevEvent = {
+    type: 'rebuild_start';
+    files: Array<string>;
+} | {
+    type: 'rebuild_ok';
+    ms: number;
+    buildId: number;
+    restarted: boolean;
+} | {
+    type: 'build_error';
+    ms: number;
+    message: string;
+    file: string | null;
+    line: number | null;
+    col: number | null;
+    diagnostics: Array<BundleDiagnostic>;
+} | {
+    type: 'runtime_error';
+    message: string;
+    stack: string;
+    request: DevRequestTag | null;
+} | {
+    type: 'log';
+    source: 'app' | 'workerd';
+    level: DevLogLevel;
+    message: string;
+    request: DevRequestTag | null;
+};
+/** Parse one workerd stdout line; plain lines become untagged `log` events. */
+export declare function parseWorkerdStdoutLine(line: string): Extract<DevEvent, {
+    type: 'log';
+}>;
+export declare function formatRequestTag(request: DevRequestTag | null): string;
+/** One human-readable block for terminals. */
+export declare function formatDevEvent(event: DevEvent): {
+    stream: 'stdout' | 'stderr';
+    text: string;
+};

package/dist/dev/dev-events.js

@@ -0,0 +1,81 @@
+/**
+ * Events a running `kody dev` server reports: rebuilds, build and runtime
+ * errors, and app logs. Humans get {@link formatDevEvent}; agents get the
+ * same objects as NDJSON.
+ */
+import { formatBundleDiagnostic } from '../local-bundle.js';
+import { appLogMarker } from './dev-protocol.js';
+const logLevels = new Set(['log', 'info', 'warn', 'error', 'debug']);
+/** Parse one workerd stdout line; plain lines become untagged `log` events. */
+export function parseWorkerdStdoutLine(line) {
+    if (line.startsWith(appLogMarker)) {
+        try {
+            const parsed = JSON.parse(line.slice(appLogMarker.length));
+            const level = typeof parsed.level === 'string' && logLevels.has(parsed.level)
+                ? parsed.level
+                : 'log';
+            return {
+                type: 'log',
+                source: 'app',
+                level,
+                message: typeof parsed.message === 'string' ? parsed.message : String(parsed.message),
+                request: readRequestTag(parsed.request),
+            };
+        }
+        catch { }
+    }
+    return { type: 'log', source: 'app', level: 'log', message: line, request: null };
+}
+function readRequestTag(value) {
+    if (!value || typeof value !== 'object')
+        return null;
+    const record = value;
+    if (typeof record.id !== 'string')
+        return null;
+    return {
+        id: record.id,
+        method: typeof record.method === 'string' ? record.method : 'GET',
+        path: typeof record.path === 'string' ? record.path : '/',
+    };
+}
+export function formatRequestTag(request) {
+    return request ? `[${request.method} ${request.path} #${request.id}]` : '[app]';
+}
+/** One human-readable block for terminals. */
+export function formatDevEvent(event) {
+    switch (event.type) {
+        case 'rebuild_start':
+            return {
+                stream: 'stderr',
+                text: event.files.length > 0 ? `Rebuilding (${event.files.join(', ')})…` : 'Building…',
+            };
+        case 'rebuild_ok':
+            return {
+                stream: 'stderr',
+                text: event.restarted
+                    ? `Ready in ${event.ms}ms (build ${event.buildId})`
+                    : `No bundle changes (${event.ms}ms)`,
+            };
+        case 'build_error':
+            return {
+                stream: 'stderr',
+                text: `Build failed${event.diagnostics.length > 0 ? `:\n${event.diagnostics.map(formatBundleDiagnostic).join('\n')}` : `: ${event.message}`}\nThe last good build is paused until this is fixed; requests get the error page.`,
+            };
+        case 'runtime_error':
+            return {
+                stream: 'stderr',
+                text: `${formatRequestTag(event.request)} Uncaught ${event.stack || event.message}`,
+            };
+        case 'log': {
+            const tag = event.source === 'workerd' ? '[workerd]' : formatRequestTag(event.request);
+            const level = event.level === 'log' || event.level === 'info' ? '' : `${event.level}: `;
+            const stream = event.level === 'error' || event.level === 'warn' ? 'stderr' : 'stdout';
+            return { stream, text: `${tag} ${level}${event.message}` };
+        }
+        default: {
+            const exhaustive = event;
+            throw new Error(`Unhandled dev event: ${JSON.stringify(exhaustive)}`);
+        }
+    }
+}
+//# sourceMappingURL=dev-events.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * Wire constants shared by the `kody dev` proxy (Node) and the dev entry that
+ * runs inside workerd.
+ */
+/**
+ * Prefix the dev entry puts on every captured `console.*` line it writes to
+ * workerd stdout. Control characters keep it from colliding with app output.
+ */
+export declare const appLogMarker = "\u001Fkody-dev-log\u001F";
+/** Proxy → workerd: short request id used to tag logs and errors. */
+export declare const devRequestIdHeader = "x-kody-dev-request";
+/** workerd → proxy: the response carries a serialized uncaught handler error. */
+export declare const devErrorHeader = "x-kody-dev-error";

package/dist/dev/dev-protocol.js

@@ -0,0 +1,14 @@
+/**
+ * Wire constants shared by the `kody dev` proxy (Node) and the dev entry that
+ * runs inside workerd.
+ */
+/**
+ * Prefix the dev entry puts on every captured `console.*` line it writes to
+ * workerd stdout. Control characters keep it from colliding with app output.
+ */
+export const appLogMarker = '\u001fkody-dev-log\u001f';
+/** Proxy → workerd: short request id used to tag logs and errors. */
+export const devRequestIdHeader = 'x-kody-dev-request';
+/** workerd → proxy: the response carries a serialized uncaught handler error. */
+export const devErrorHeader = 'x-kody-dev-error';
+//# sourceMappingURL=dev-protocol.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dev-protocol.js","sourceRoot":"","sources":["../../src/dev/dev-protocol.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,0BAA0B,CAAA;AAEtD,qEAAqE;AACrE,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,CAAA;AAEtD,iFAAiF;AACjF,MAAM,CAAC,MAAM,cAAc,GAAG,kBAAkB,CAAA"}

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 {};