@somewhere-tech/cli 0.11.0 → 0.12.1

package/dist/lib/build-errors.js

@@ -0,0 +1,147 @@
+/**
+ * Rendering for the worker's structured BUILD_ERROR payload (tsk_de47d1d7).
+ *
+ * The /deploy and /deploy/patch routes answer compile failures with
+ *   { error: 'BUILD_ERROR', message, data: { file, line, column, error,
+ *     frame, errors: [...], build_log }, hint? }
+ *
+ * The CLI has the source files on disk, so the code frame is rebuilt locally
+ * (wider context + caret) instead of trusting the server's copy — and falls
+ * back to data.frame / the raw message when the local file doesn't match.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { isAbsolute, join } from 'node:path';
+import { CliApiError } from './client.js';
+import { bold, dim, error, info, red, teal, warn } from './output.js';
+/** Pull file:line:col diagnostics out of esbuild-style bundle_error text. */
+export function parseBundleErrorText(text) {
+    const out = [];
+    const re = /([^\s:]+(?:\/[^\s:]+)*):(\d+):(\d+): ERROR: ([^\n]+)/g;
+    let m;
+    while ((m = re.exec(text)) !== null) {
+        out.push({ file: m[1], line: Number(m[2]), column: Number(m[3]) + 1, message: m[4].trim() });
+    }
+    return out;
+}
+const FRAME_CONTEXT = 2;
+/** Build a code frame (line ±2, caret under the column) from local source. */
+export function localCodeFrame(source, line, column) {
+    const lines = source.split('\n');
+    if (line < 1 || line > lines.length)
+        return '';
+    const start = Math.max(1, line - FRAME_CONTEXT);
+    const end = Math.min(lines.length, line + FRAME_CONTEXT);
+    const width = String(end).length;
+    const out = [];
+    for (let n = start; n <= end; n++) {
+        const marker = n === line ? red('>') : ' ';
+        const num = String(n).padStart(width);
+        out.push(`${marker} ${dim(`${num} |`)} ${lines[n - 1]}`);
+        if (n === line && column !== undefined && column >= 1) {
+            out.push(`  ${dim(`${' '.repeat(width)} |`)} ${' '.repeat(column - 1)}${red('^')}`);
+        }
+    }
+    return out.join('\n');
+}
+function frameFor(detail, baseDir, serverFrame) {
+    if (detail.file && detail.line !== undefined) {
+        const abs = isAbsolute(detail.file) ? detail.file : join(baseDir, detail.file);
+        if (existsSync(abs)) {
+            try {
+                const frame = localCodeFrame(readFileSync(abs, 'utf-8'), detail.line, detail.column);
+                if (frame)
+                    return frame;
+            }
+            catch {
+                // unreadable — fall through to the server's frame
+            }
+        }
+    }
+    return serverFrame ?? '';
+}
+function location(detail) {
+    if (!detail.file)
+        return detail.message ?? 'unknown error';
+    const pos = detail.line !== undefined
+        ? `:${detail.line}${detail.column !== undefined ? `:${detail.column}` : ''}`
+        : '';
+    return `${detail.file}${pos}${detail.message ? ` — ${detail.message}` : ''}`;
+}
+/** True when the error carries a structured build payload this module renders:
+ *  BUILD_ERROR's data.{file,line,errors}, or any error (DEPLOY_BLANK_PAGE)
+ *  whose data.bundle_error names the compile failure. */
+export function isBuildError(err) {
+    if (!(err instanceof CliApiError) || !err.data || typeof err.data !== 'object')
+        return false;
+    if (err.code === 'BUILD_ERROR')
+        return true;
+    return typeof err.data.bundle_error === 'string';
+}
+/**
+ * Print a structured build failure: file:line heading, local code frame,
+ * remaining errors, missing assets, hint. Returns true if it rendered
+ * (caller falls back to generic output otherwise).
+ */
+export function renderBuildError(err, baseDir) {
+    const data = (err.data ?? {});
+    let details = Array.isArray(data.errors) && data.errors.length > 0
+        ? data.errors
+        : data.file !== undefined || data.error !== undefined
+            ? [{ file: data.file, line: data.line, column: data.column, message: data.error }]
+            : [];
+    if (details.length === 0 && typeof data.bundle_error === 'string') {
+        details = parseBundleErrorText(data.bundle_error);
+    }
+    if (details.length === 0 && !data.missing_assets?.length)
+        return false;
+    const first = details[0];
+    if (first) {
+        error(`${bold('Build failed')} — ${teal(location(first))}`);
+        const frame = frameFor(first, baseDir, data.frame);
+        if (frame) {
+            console.log('');
+            console.log(frame);
+            console.log('');
+        }
+    }
+    for (const extra of details.slice(1, 6)) {
+        error(location(extra));
+        const frame = frameFor(extra, baseDir);
+        if (frame) {
+            console.log('');
+            console.log(frame);
+            console.log('');
+        }
+    }
+    if (details.length > 6) {
+        info(dim(`…and ${details.length - 6} more build error(s)`));
+    }
+    if (data.missing_assets?.length) {
+        warn(`Missing assets referenced by the build: ${data.missing_assets.slice(0, 10).join(', ')}${data.missing_assets.length > 10 ? ', …' : ''}`);
+    }
+    if (err.hint)
+        info(dim(err.hint));
+    if (err.code === 'BUILD_ERROR') {
+        info(dim(`Nothing from this deploy is live. Fix the error and redeploy. [BUILD_ERROR, HTTP ${err.statusCode}]`));
+    }
+    else {
+        // Non-BUILD_ERROR codes (DEPLOY_BLANK_PAGE) carry context the frame
+        // doesn't repeat — rollback state, false-alarm guidance. Keep it.
+        info(dim(`${err.message} [${err.code}, HTTP ${err.statusCode}]`));
+    }
+    return true;
+}
+/** Yellow single-line summary for watch-mode (somewhere dev) reuse. */
+export function buildErrorSummary(err) {
+    const data = (err.data ?? {});
+    let first = Array.isArray(data.errors) && data.errors.length > 0
+        ? data.errors[0]
+        : data.file !== undefined || data.error !== undefined
+            ? { file: data.file, line: data.line, column: data.column, message: data.error }
+            : undefined;
+    if (!first && typeof data.bundle_error === 'string') {
+        first = parseBundleErrorText(data.bundle_error)[0];
+    }
+    return first ? location(first) : err.message;
+}
+//# sourceMappingURL=build-errors.js.map

package/dist/lib/build-errors.js.map

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

package/dist/lib/client.js

@@ -1,10 +1,17 @@
+import { Agent } from 'undici';
 const BASE_URL = 'https://api.somewhere.tech/v1';
+/** Default request timeout. Long-running calls (deploy compiles, pulls)
+ *  pass an explicit budget via opts.timeoutMs instead. */
+const DEFAULT_TIMEOUT_MS = 60_000;
+/** Budget for calls that run a real build server-side (npm install alone
+ *  can take minutes): /deploy, /deploy/patch, pull/export. */
+export const LONG_CALL_TIMEOUT_MS = 10 * 60_000;
 export class ApiClient {
     token;
     constructor(token) {
         this.token = token;
     }
-    async call(method, path, body, query) {
+    async call(method, path, body, query, opts) {
         let url = `${BASE_URL}${path}`;
         if (query) {
             const params = new URLSearchParams();
@@ -25,7 +32,57 @@ export class ApiClient {
             headers['Content-Type'] = 'application/json';
             reqBody = JSON.stringify(body);
         }
-        const res = await fetch(url, { method, headers, body: reqBody });
+        const timeoutMs = opts?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        let res;
+        try {
+            res = await fetch(url, {
+                method,
+                headers,
+                body: reqBody,
+                signal: AbortSignal.timeout(timeoutMs),
+                // Match undici's internal header/body timeouts to OUR budget. Node's
+                // global fetch defaults headersTimeout to ~300s — SHORTER than a long
+                // deploy's 10-min budget — so a cold first deploy (while the project is
+                // provisioned) tripped UND_ERR_HEADERS_TIMEOUT before our AbortSignal
+                // fired, and the failure got mislabeled as the user's network
+                // (tsk_896f9c7b). Now our AbortSignal is the only real deadline.
+                dispatcher: new Agent({ headersTimeout: timeoutMs, bodyTimeout: timeoutMs }),
+            });
+        }
+        catch (err) {
+            // AbortSignal.timeout fired — no bytes back within the budget. Name it
+            // so the user can tell a hang from a rejection (review F8/Q5: a bare
+            // fetch hung `somewhere deploy` forever on network silence).
+            if (err instanceof Error && (err.name === 'TimeoutError' || err.name === 'AbortError')) {
+                throw new CliApiError('TIMEOUT', `No response from ${method} ${url.split('?')[0]} after ${Math.round(timeoutMs / 1000)}s. ` +
+                    'The request may still be processing server-side — check `somewhere status` before retrying a deploy.', 0);
+            }
+            // Node's fetch rejects network-level failures with a bare
+            // "fetch failed" and buries the real reason (ENOTFOUND,
+            // ECONNRESET, UND_ERR_*) in err.cause. Surfacing only the bare
+            // message cost a customer an hour of guessing whether it was
+            // auth, payload, or network (pfb_70e9d140c5a0) — name the
+            // endpoint and the underlying cause.
+            const cause = err.cause;
+            const code = cause?.code;
+            // undici's own header/body timeout means the CONNECTION established but the
+            // server was slow to respond — NOT the user's network. Common on a first
+            // deploy while the project is provisioned (tsk_896f9c7b). With the matching
+            // dispatcher above this should rarely fire now, but if it does, say what's
+            // actually happening instead of blaming the network.
+            if (code === 'UND_ERR_HEADERS_TIMEOUT' || code === 'UND_ERR_BODY_TIMEOUT') {
+                throw new CliApiError('SERVER_SLOW', `${method} ${url.split('?')[0]} connected, but the server didn't finish responding in time. ` +
+                    'This is usually a first deploy while your project is being provisioned — the request may ' +
+                    'still be completing server-side. Check `somewhere status` before retrying ' +
+                    '(retrying a first deploy is safe — it just creates a new version).', 0);
+            }
+            const detail = code ??
+                cause?.message ??
+                (err instanceof Error ? err.message : String(err));
+            throw new CliApiError('NETWORK_ERROR', `Could not reach ${method} ${url.split('?')[0]} — ${detail}. ` +
+                'No HTTP response was received (this is a connection problem, not a server rejection). ' +
+                'Check your network and retry; for large deploys a flaky connection can drop the upload mid-request.', 0);
+        }
         const text = await res.text();
         let parsed;
         try {
@@ -36,16 +93,23 @@ export class ApiClient {
         }
         if (parsed.ok === true)
             return parsed.data;
-        throw new CliApiError(parsed.error ?? 'UNKNOWN', parsed.message ?? 'Unknown error', res.status);
+        const errBody = parsed;
+        throw new CliApiError(errBody.error ?? 'UNKNOWN', errBody.message ?? 'Unknown error', res.status, errBody.data, errBody.hint);
     }
 }
 export class CliApiError extends Error {
     code;
     statusCode;
-    constructor(code, message, statusCode) {
+    data;
+    hint;
+    constructor(code, message, statusCode, 
+    /** Structured payload some errors carry (e.g. BUILD_ERROR file/line/frame). */
+    data, hint) {
         super(message);
         this.code = code;
         this.statusCode = statusCode;
+        this.data = data;
+        this.hint = hint;
         this.name = 'CliApiError';
     }
 }

package/dist/lib/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AAEA,MAAM,QAAQ,GAAG,+BAA+B,CAAC;AAEjD,MAAM,OAAO,SAAS;IACS;IAA7B,YAA6B,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAE9C,KAAK,CAAC,IAAI,CACR,MAAc,EACd,IAAY,EACZ,IAAc,EACd,KAAmD;QAEnD,IAAI,GAAG,GAAG,GAAG,QAAQ,GAAG,IAAI,EAAE,CAAC;QAC/B,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YACrC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3C,IAAI,CAAC,KAAK,SAAS;oBAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACnD,CAAC;YACD,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC7B,IAAI,EAAE;gBAAE,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC;QAC1B,CAAC;QAED,MAAM,OAAO,GAA2B;YACtC,aAAa,EAAE,UAAU,IAAI,CAAC,KAAK,EAAE;YACrC,MAAM,EAAE,kBAAkB;SAC3B,CAAC;QAEF,IAAI,OAA2B,CAAC;QAChC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;YAC7C,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACjE,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,MAAsB,CAAC;QAE3B,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,WAAW,CACnB,kBAAkB,EAClB,sBAAsB,GAAG,CAAC,MAAM,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAC1D,GAAG,CAAC,MAAM,CACX,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,EAAE,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC;QAE3C,MAAM,IAAI,WAAW,CAClB,MAA6B,CAAC,KAAK,IAAI,SAAS,EAChD,MAA+B,CAAC,OAAO,IAAI,eAAe,EAC3D,GAAG,CAAC,MAAM,CACX,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,KAAK;IAElB;IAEA;IAHlB,YACkB,IAAY,EAC5B,OAAe,EACC,UAAkB;QAElC,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAQ;QAEZ,eAAU,GAAV,UAAU,CAAQ;QAGlC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"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"}

package/dist/local/envfile.js

@@ -0,0 +1,40 @@
+/**
+ * Minimal .env parser for local dev. Values from .env / .env.local in the
+ * project root feed sw.env when running functions locally — these files are
+ * in the deploy IGNORE list, so nothing here ever leaves the machine.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+export function parseEnvFile(content) {
+    const out = {};
+    for (const rawLine of content.split('\n')) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith('#'))
+            continue;
+        const eq = line.indexOf('=');
+        if (eq <= 0)
+            continue;
+        const key = line.slice(0, eq).trim().replace(/^export\s+/, '');
+        if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key))
+            continue;
+        let value = line.slice(eq + 1).trim();
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        out[key] = value;
+    }
+    return out;
+}
+/** Load .env then .env.local (local wins), from the project directory. */
+export function loadLocalEnv(dir) {
+    const merged = {};
+    for (const name of ['.env', '.env.local']) {
+        const path = join(dir, name);
+        if (!existsSync(path))
+            continue;
+        Object.assign(merged, parseEnvFile(readFileSync(path, 'utf-8')));
+    }
+    return merged;
+}
+//# sourceMappingURL=envfile.js.map

package/dist/local/envfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envfile.js","sourceRoot":"","sources":["../../src/local/envfile.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5C,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,EAAE,IAAI,CAAC;YAAE,SAAS;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QAC/D,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,SAAS;QACpD,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACtC,IACE,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC9C,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAC9C,CAAC;YACD,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QAChC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/local/loader.js

@@ -0,0 +1,103 @@
+/**
+ * Module loading for the local function runtime.
+ *
+ * Two jobs the deployed runtime gets for free from the platform compiler:
+ *
+ * 1. Extensionless cross-file imports — `import { db } from '../_lib/db'`
+ *    works deployed; Node ESM requires extensions. A resolve hook tries the
+ *    same candidates the platform accepts (.ts/.tsx/.mts/.js/.mjs/.jsx and
+ *    directory index files) for relative imports originating inside the
+ *    project.
+ *
+ * 2. Hot reload — ESM has no cache invalidation, so every project-local file
+ *    URL carries a ?gen=N query. Bumping the generation makes the next
+ *    import() re-evaluate the whole project module graph; the hook propagates
+ *    the parent's generation to children so nothing stale survives a save.
+ *
+ * TypeScript runs through Node's native type stripping (>= 22.18 / 23.6).
+ */
+import { registerHooks } from 'node:module';
+import { existsSync, statSync } from 'node:fs';
+import { dirname, resolve as resolvePath } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+const EXT_CANDIDATES = ['.ts', '.tsx', '.mts', '.js', '.mjs', '.jsx'];
+let generation = 1;
+let installedRoot = null;
+export function bumpGeneration() {
+    return ++generation;
+}
+/** file:// URL for a project entry file, stamped with the current generation. */
+export function entryUrl(absPath) {
+    return `${pathToFileURL(absPath).href}?gen=${generation}`;
+}
+/**
+ * Verify the running Node supports what the local runtime needs:
+ * module.registerHooks + unflagged TypeScript type stripping.
+ */
+export function assertNodeSupport() {
+    const [major, minor] = process.versions.node.split('.').map(Number);
+    const ok = major >= 24 || (major === 23 && minor >= 6) || (major === 22 && minor >= 18);
+    if (!ok) {
+        throw new Error(`somewhere dev --local needs Node >= 22.18 (or >= 23.6) for TypeScript support and module hooks — you're on ${process.versions.node}. Upgrade Node and retry.`);
+    }
+}
+function isFile(p) {
+    try {
+        return existsSync(p) && statSync(p).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function resolveWithExtensions(base) {
+    if (isFile(base))
+        return base;
+    for (const ext of EXT_CANDIDATES) {
+        if (isFile(base + ext))
+            return base + ext;
+    }
+    for (const ext of EXT_CANDIDATES) {
+        const idx = resolvePath(base, 'index' + ext);
+        if (isFile(idx))
+            return idx;
+    }
+    return null;
+}
+/**
+ * Install the resolve hook for project files under `projectRoot`.
+ * Safe to call once per process; subsequent calls just update the root.
+ */
+export function installLoader(projectRoot) {
+    const root = resolvePath(projectRoot);
+    if (installedRoot !== null) {
+        installedRoot = root;
+        return;
+    }
+    installedRoot = root;
+    registerHooks({
+        resolve(specifier, context, nextResolve) {
+            const parent = context.parentURL;
+            if (!installedRoot ||
+                !parent ||
+                !parent.startsWith('file://') ||
+                (!specifier.startsWith('./') && !specifier.startsWith('../'))) {
+                return nextResolve(specifier, context);
+            }
+            const parentUrl = new URL(parent);
+            const parentPath = fileURLToPath(`file://${parentUrl.pathname}`);
+            if (!parentPath.startsWith(installedRoot)) {
+                return nextResolve(specifier, context);
+            }
+            const target = resolvePath(dirname(parentPath), specifier);
+            const found = resolveWithExtensions(target);
+            if (!found) {
+                // Let Node produce its standard (clear) ERR_MODULE_NOT_FOUND.
+                return nextResolve(specifier, context);
+            }
+            const gen = parentUrl.searchParams.get('gen');
+            const url = pathToFileURL(found).href + (gen ? `?gen=${gen}` : '');
+            return { url, shortCircuit: true };
+        },
+    });
+}
+//# sourceMappingURL=loader.js.map

package/dist/local/loader.js.map

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

package/dist/local/router.js

@@ -0,0 +1,114 @@
+/**
+ * File-based routing for the local function runtime — a faithful port of the
+ * deploy pipeline's route compiler + matcher (worker/src/utils/function-bundle.ts:
+ * compileRoutePattern / routeSpecificityKey / matchRoute), so a URL resolves to
+ * the same function locally as it does deployed.
+ *
+ *   api/hello.ts           → /api/hello              (static)
+ *   api/sites/[id].ts      → /api/sites/:id          (param)
+ *   api/files/[...path].ts → /api/files/*path        (catch-all)
+ *   [...path].ts (root)    → /*path                  (root catch-all)
+ *
+ * Static beats param beats rest. `_lib/` and plain root files are bundled for
+ * imports but never routed.
+ */
+export function compileRoutePattern(file) {
+    const noExt = file.replace(/\.(ts|tsx|mts|js|mjs|jsx)$/, '');
+    const parts = noExt.split('/');
+    const pattern = [];
+    const display = [];
+    parts.forEach((seg, i) => {
+        const rest = seg.match(/^\[\.\.\.([a-zA-Z_][a-zA-Z0-9_]*)\]$/);
+        if (rest) {
+            if (i !== parts.length - 1) {
+                throw new Error(`catch-all [...${rest[1]}] must be the last path segment: ${file}`);
+            }
+            pattern.push({ type: 'rest', value: rest[1] });
+            display.push(`*${rest[1]}`);
+            return;
+        }
+        const param = seg.match(/^\[([a-zA-Z_][a-zA-Z0-9_]*)\]$/);
+        if (param) {
+            pattern.push({ type: 'param', value: param[1] });
+            display.push(`:${param[1]}`);
+            return;
+        }
+        if (/[\[\]]/.test(seg)) {
+            throw new Error(`malformed parametric segment "${seg}" in ${file}. Use [name] or [...name].`);
+        }
+        pattern.push({ type: 'static', value: seg });
+        display.push(seg);
+    });
+    return { pattern, displayPath: '/' + display.join('/') };
+}
+function routeSpecificityKey(pattern) {
+    return pattern.map((s) => (s.type === 'static' ? '2' : s.type === 'param' ? '1' : '0')).join('');
+}
+function hasRestSegment(pattern) {
+    return pattern.some((s) => s.type === 'rest');
+}
+export function isRoutable(file) {
+    const isRootParametric = !file.includes('/') && /\[/.test(file);
+    return file.startsWith('api/') || isRootParametric;
+}
+/**
+ * Compile + sort routes most-specific first, mirroring buildFunctionBundle:
+ * non-rest beats rest; within a group, segment-wise static > param wins.
+ * Throws on two files compiling to the same route (same deploy-time error).
+ */
+export function compileRoutes(files) {
+    const routes = [];
+    for (const { file, absPath } of files) {
+        if (!isRoutable(file))
+            continue;
+        const { pattern, displayPath } = compileRoutePattern(file);
+        routes.push({ file, absPath, pattern, displayPath });
+    }
+    const seen = new Map();
+    for (const r of routes) {
+        const prior = seen.get(r.displayPath);
+        if (prior) {
+            throw new Error(`Two functions compile to the same route "${r.displayPath}": ${prior} and ${r.file}`);
+        }
+        seen.set(r.displayPath, r.file);
+    }
+    routes.sort((a, b) => {
+        const aRest = hasRestSegment(a.pattern);
+        const bRest = hasRestSegment(b.pattern);
+        if (aRest !== bRest)
+            return aRest ? 1 : -1;
+        const ka = routeSpecificityKey(a.pattern);
+        const kb = routeSpecificityKey(b.pattern);
+        return kb.localeCompare(ka);
+    });
+    return routes;
+}
+/** Walk routes in order and return the first match — port of the shim's matchRoute. */
+export function matchRoute(routes, pathname) {
+    const urlSegs = pathname.split('/').filter(Boolean);
+    outer: for (const route of routes) {
+        const params = {};
+        const pat = route.pattern;
+        for (let i = 0; i < pat.length; i++) {
+            const p = pat[i];
+            if (p.type === 'rest') {
+                params[p.value] = urlSegs.slice(i).map(decodeURIComponent).join('/');
+                return { route, params };
+            }
+            if (i >= urlSegs.length)
+                continue outer;
+            if (p.type === 'static') {
+                if (urlSegs[i] !== p.value)
+                    continue outer;
+            }
+            else {
+                params[p.value] = decodeURIComponent(urlSegs[i]);
+            }
+        }
+        if (pat.length === urlSegs.length) {
+            return { route, params };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=router.js.map

package/dist/local/router.js.map

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