@kodycodes/cli 1.19.2 → 1.20.1

package/dist/mock/install-mock-fetch-shim.js

@@ -0,0 +1,36 @@
+/**
+ * When `.kody/mocks.ts` is active under `--target mock`, embed the CLI-owned
+ * gateway-fetch shim and ensure the workerd entry side-effect imports it.
+ *
+ * Keep the origin `.__kody_virtual__/runtime.js` module (CAF / packageStorage
+ * re-exports). Register the mock wrap under a *flat* module name so bare
+ * `kody:runtime` does not path-join under `.__kody_virtual__/` (same workerd
+ * rule as kentcdodds/kody local-execute-package-graph).
+ */
+import { writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { localExecuteGatewayFetchShimModuleName } from '../local-package-graph.js';
+import { createMockGatewayFetchShimSource } from './mock-gateway-fetch-shim.js';
+const mockShimFileName = 'mock-gateway-fetch-shim.js';
+/** Flat workerd module name — must not contain `/` (path-join hazard). */
+export const mockGatewayFetchShimModuleName = '.__kody_mock_gateway_fetch__.js';
+export async function installMockFetchShimModules(input) {
+    const withoutDup = input.packageModules.filter((module) => module.name !== mockGatewayFetchShimModuleName);
+    await writeFile(join(input.workDir, mockShimFileName), createMockGatewayFetchShimSource());
+    const originShimNames = withoutDup
+        .map((module) => module.name)
+        .filter((name) => name === localExecuteGatewayFetchShimModuleName);
+    return {
+        packageModules: [
+            ...withoutDup,
+            {
+                name: mockGatewayFetchShimModuleName,
+                file: mockShimFileName,
+            },
+        ],
+        // Origin first (runtime re-exports + secret wrap), mock last so ambient
+        // fetch is fail-closed through the Node MSW gateway.
+        sideEffectModules: [...originShimNames, mockGatewayFetchShimModuleName],
+    };
+}
+//# sourceMappingURL=install-mock-fetch-shim.js.map

package/dist/mock/install-mock-fetch-shim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-mock-fetch-shim.js","sourceRoot":"","sources":["../../src/mock/install-mock-fetch-shim.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,sCAAsC,EAAE,MAAM,2BAA2B,CAAA;AAElF,OAAO,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAA;AAE/E,MAAM,gBAAgB,GAAG,4BAA4B,CAAA;AAErD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,8BAA8B,GAAG,iCAAiC,CAAA;AAE/E,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,KAGjD;IAIA,MAAM,UAAU,GAAG,KAAK,CAAC,cAAc,CAAC,MAAM,CAC7C,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,8BAA8B,CAC1D,CAAA;IACD,MAAM,SAAS,CACd,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,EACrC,gCAAgC,EAAE,CAClC,CAAA;IACD,MAAM,eAAe,GAAG,UAAU;SAChC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;SAC5B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,sCAAsC,CAAC,CAAA;IACnE,OAAO;QACN,cAAc,EAAE;YACf,GAAG,UAAU;YACb;gBACC,IAAI,EAAE,8BAA8B;gBACpC,IAAI,EAAE,gBAAgB;aACtB;SACD;QACD,wEAAwE;QACxE,qDAAqD;QACrD,iBAAiB,EAAE,CAAC,GAAG,eAAe,EAAE,8BAA8B,CAAC;KACvE,CAAA;AACF,CAAC"}

package/dist/mock/load-package-mocks.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Load optional `<packageRoot>/.kody/mocks.ts` for `--target mock` outbound
+ * fetch mocking. Missing file → no handlers (packages without mocks keep
+ * native workerd fetch). Never imported into published package bundles.
+ */
+import type { RequestHandler } from 'msw';
+export declare const packageMocksRelativePath = ".kody/mocks.ts";
+export type LoadedPackageMocks = {
+    path: string;
+    handlers: Array<RequestHandler>;
+};
+export declare function resolvePackageMocksPath(packageRoot: string): Promise<string | null>;
+/**
+ * Bundle and evaluate `.kody/mocks.ts`. Expects `export const handlers = […]`
+ * (MSW `http.*` handlers) or a default export of that array.
+ */
+export declare function loadPackageMocks(packageRoot: string): Promise<LoadedPackageMocks | null>;
+/** Write a tiny helper so tests can assert the relative path without importing fs. */
+export declare function packageMocksPathFor(packageRoot: string): string;

package/dist/mock/load-package-mocks.js

@@ -0,0 +1,115 @@
+/**
+ * Load optional `<packageRoot>/.kody/mocks.ts` for `--target mock` outbound
+ * fetch mocking. Missing file → no handlers (packages without mocks keep
+ * native workerd fetch). Never imported into published package bundles.
+ */
+import * as esbuild from 'esbuild';
+import { access, mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { StructuredCliError } from '../structured-error.js';
+const requireFromCli = createRequire(import.meta.url);
+export const packageMocksRelativePath = '.kody/mocks.ts';
+export async function resolvePackageMocksPath(packageRoot) {
+    const path = join(packageRoot, packageMocksRelativePath);
+    try {
+        await access(path);
+        return path;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Bundle and evaluate `.kody/mocks.ts`. Expects `export const handlers = […]`
+ * (MSW `http.*` handlers) or a default export of that array.
+ */
+export async function loadPackageMocks(packageRoot) {
+    const path = await resolvePackageMocksPath(packageRoot);
+    if (!path)
+        return null;
+    const workDir = await mkdtemp(join(tmpdir(), 'kody-mocks-'));
+    const outfile = join(workDir, 'mocks.mjs');
+    try {
+        const mswHref = pathToFileURL(requireFromCli.resolve('msw')).href;
+        let result;
+        try {
+            result = await esbuild.build({
+                entryPoints: [path],
+                bundle: true,
+                platform: 'node',
+                format: 'esm',
+                target: 'node22',
+                outfile,
+                write: true,
+                logLevel: 'silent',
+                // Leave MSW external; rewrite the import to the CLI-resolved absolute URL.
+                external: ['msw', 'msw/*'],
+            });
+        }
+        catch (error) {
+            const messages = error && typeof error === 'object' && 'errors' in error
+                ? error.errors.map((item) => item.text)
+                : [error instanceof Error ? error.message : String(error)];
+            throw new StructuredCliError({
+                code: 'bundle_failed',
+                message: `Could not bundle ${packageMocksRelativePath} for --target mock.`,
+                target: 'mock',
+                where: path,
+                fix: 'Fix TypeScript/syntax errors in .kody/mocks.ts and retry. Import handlers from `msw` (provided by @kodycodes/cli).',
+                details: { errors: messages },
+            });
+        }
+        if (result.errors.length > 0) {
+            throw new StructuredCliError({
+                code: 'bundle_failed',
+                message: `Could not bundle ${packageMocksRelativePath} for --target mock.`,
+                target: 'mock',
+                where: path,
+                fix: 'Fix TypeScript/syntax errors in .kody/mocks.ts and retry.',
+                details: {
+                    errors: result.errors.map((error) => error.text),
+                },
+            });
+        }
+        const bundled = await readFile(outfile, 'utf8');
+        const rewritten = bundled.replace(/(from\s*|import\s*\(|require\s*\()\s*(['"])msw\2/g, (_match, prefix, quote) => `${prefix}${quote}${mswHref}${quote}`);
+        await writeFile(outfile, rewritten);
+        const mod = (await import(pathToFileURL(outfile).href));
+        const raw = mod.handlers ?? mod.default;
+        if (!Array.isArray(raw)) {
+            throw new StructuredCliError({
+                code: 'package_manifest_invalid',
+                message: `${packageMocksRelativePath} must export \`handlers\` (or default) as an array of MSW http handlers.`,
+                target: 'mock',
+                where: path,
+                fix: `export const handlers = [http.get('https://api.example.com/…', () => HttpResponse.json({ ok: true }))]`,
+            });
+        }
+        return { path, handlers: raw };
+    }
+    catch (error) {
+        if (error instanceof StructuredCliError)
+            throw error;
+        throw new StructuredCliError({
+            code: 'bundle_failed',
+            message: `Could not load ${packageMocksRelativePath}.`,
+            target: 'mock',
+            where: path,
+            fix: 'Ensure the file exports MSW handlers and that `msw` is resolvable from the package (or rely on the CLI’s dependency).',
+            details: {
+                cause: error instanceof Error ? error.message : String(error),
+            },
+        });
+    }
+    finally {
+        await rm(workDir, { recursive: true, force: true });
+    }
+}
+/** Write a tiny helper so tests can assert the relative path without importing fs. */
+export function packageMocksPathFor(packageRoot) {
+    return join(packageRoot, packageMocksRelativePath);
+}
+//# sourceMappingURL=load-package-mocks.js.map

package/dist/mock/load-package-mocks.js.map

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

package/dist/mock/mock-fetch-gateway.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Node-side mock outbound fetch gateway: match MSW handlers from
+ * `.kody/mocks.ts`, optionally passthrough allowlisted hosts to real network,
+ * otherwise fail closed with `unmocked_request` + a paste-ready handler stub.
+ */
+import { type RequestHandler } from 'msw';
+import { StructuredCliError } from '../structured-error.js';
+import type { KodyTarget } from '../target.js';
+export type MockGatewayFetchRequest = {
+    url?: string;
+    method?: string;
+    headers?: Record<string, string>;
+    bodyBase64?: string;
+};
+export type MockGatewayFetchResult = {
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    bodyBase64: string;
+};
+export type MockFetchGateway = {
+    /** True when `.kody/mocks.ts` loaded (shim should be injected). */
+    enabled: boolean;
+    handlers: ReadonlyArray<RequestHandler>;
+    passthroughHosts: ReadonlyArray<string>;
+    allowPrivateNetwork: boolean;
+    handle: (args: unknown, signal?: AbortSignal) => Promise<MockGatewayFetchResult>;
+};
+export declare function parsePassthroughHosts(raw: string | undefined): Array<string>;
+export declare function createMockFetchGateway(input: {
+    handlers: ReadonlyArray<RequestHandler>;
+    passthroughHosts?: ReadonlyArray<string>;
+    allowPrivateNetwork?: boolean;
+    fetchFn?: typeof fetch;
+}): MockFetchGateway;
+export declare function dispatchMockGatewayFetch(input: {
+    handlers: ReadonlyArray<RequestHandler>;
+    passthroughHosts: ReadonlyArray<string>;
+    allowPrivateNetwork: boolean;
+    request: MockGatewayFetchRequest;
+    fetchFn?: typeof fetch;
+    signal?: AbortSignal;
+}): Promise<MockGatewayFetchResult>;
+export declare function hostMatchesPassthrough(hostname: string, hosts: ReadonlyArray<string>): boolean;
+export declare function unmockedRequestError(method: string, url: string): StructuredCliError;
+export declare function buildHandlerStub(method: string, url: string): string;
+/** Bridge interceptor: handle `kody.gatewayFetch` when a mock gateway is active. */
+export declare function tryHandleMockGatewayFetchCall(input: {
+    gateway: MockFetchGateway | undefined;
+    path: ReadonlyArray<string>;
+    args: ReadonlyArray<unknown>;
+    signal?: AbortSignal;
+}): Promise<MockGatewayFetchResult> | null;
+/**
+ * Load `.kody/mocks.ts` only for `--target mock` when the file exists.
+ * Packages without the file keep native workerd fetch (no shim).
+ */
+export declare function resolveMockFetchGateway(input: {
+    target: KodyTarget;
+    packageRoot?: string;
+    passthroughHosts?: ReadonlyArray<string>;
+    allowPrivateNetwork?: boolean;
+    onStatus?: (message: string) => void;
+}): Promise<MockFetchGateway | undefined>;

package/dist/mock/mock-fetch-gateway.js

@@ -0,0 +1,242 @@
+/**
+ * Node-side mock outbound fetch gateway: match MSW handlers from
+ * `.kody/mocks.ts`, optionally passthrough allowlisted hosts to real network,
+ * otherwise fail closed with `unmocked_request` + a paste-ready handler stub.
+ */
+import { getResponse, isPassthroughResponse } from 'msw';
+import { StructuredCliError } from '../structured-error.js';
+import { loadPackageMocks } from './load-package-mocks.js';
+export function parsePassthroughHosts(raw) {
+    if (!raw?.trim())
+        return [];
+    return [
+        ...new Set(raw
+            .split(',')
+            .map((part) => part.trim().toLowerCase())
+            .filter(Boolean)),
+    ];
+}
+export function createMockFetchGateway(input) {
+    const passthroughHosts = input.passthroughHosts ?? [];
+    const allowPrivateNetwork = input.allowPrivateNetwork === true;
+    const fetchFn = input.fetchFn ?? fetch;
+    return {
+        enabled: true,
+        handlers: input.handlers,
+        passthroughHosts,
+        allowPrivateNetwork,
+        handle: async (args, signal) => {
+            const request = readGatewayRequest(args);
+            return await dispatchMockGatewayFetch({
+                handlers: input.handlers,
+                passthroughHosts,
+                allowPrivateNetwork,
+                request,
+                fetchFn,
+                signal,
+            });
+        },
+    };
+}
+export async function dispatchMockGatewayFetch(input) {
+    const method = (input.request.method ?? 'GET').toUpperCase();
+    const url = String(input.request.url ?? '');
+    if (!url) {
+        throw new StructuredCliError({
+            code: 'unmocked_request',
+            message: 'Mock gatewayFetch requires request.url.',
+            target: 'mock',
+            fix: 'Pass an absolute URL from ambient fetch.',
+        });
+    }
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new StructuredCliError({
+            code: 'unmocked_request',
+            message: `Mock gatewayFetch URL is not absolute: ${JSON.stringify(url)}.`,
+            target: 'mock',
+            where: `${method} ${url}`,
+            fix: 'Use an absolute https:// URL in package code under --target mock.',
+        });
+    }
+    if (hostMatchesPassthrough(parsed.hostname, input.passthroughHosts)) {
+        assertPassthroughAllowed(parsed, input.allowPrivateNetwork);
+        return await realNetworkFetch({
+            request: input.request,
+            method,
+            url: parsed.href,
+            fetchFn: input.fetchFn ?? fetch,
+            signal: input.signal,
+        });
+    }
+    const headers = new Headers(input.request.headers ?? {});
+    const body = input.request.bodyBase64 != null && input.request.bodyBase64 !== ''
+        ? Buffer.from(input.request.bodyBase64, 'base64')
+        : undefined;
+    const requestInit = {
+        method,
+        headers,
+        ...(body !== undefined && method !== 'GET' && method !== 'HEAD'
+            ? { body }
+            : {}),
+        signal: input.signal,
+    };
+    const request = new Request(parsed.href, requestInit);
+    const response = await getResponse([...input.handlers], request);
+    if (!response || isPassthroughResponse(response)) {
+        throw unmockedRequestError(method, parsed.href);
+    }
+    return await serializeResponse(response);
+}
+function readGatewayRequest(args) {
+    const record = args && typeof args === 'object' && !Array.isArray(args)
+        ? args
+        : {};
+    const nested = record.request && typeof record.request === 'object' && !Array.isArray(record.request)
+        ? record.request
+        : record;
+    return {
+        url: typeof nested.url === 'string' ? nested.url : undefined,
+        method: typeof nested.method === 'string' ? nested.method : undefined,
+        headers: nested.headers && typeof nested.headers === 'object' && !Array.isArray(nested.headers)
+            ? nested.headers
+            : undefined,
+        bodyBase64: typeof nested.bodyBase64 === 'string' ? nested.bodyBase64 : undefined,
+    };
+}
+export function hostMatchesPassthrough(hostname, hosts) {
+    const target = hostname.toLowerCase();
+    return hosts.some((entry) => {
+        const normalized = entry.trim().toLowerCase();
+        if (!normalized)
+            return false;
+        if (normalized.startsWith('*.')) {
+            const suffix = normalized.slice(1);
+            return target.endsWith(suffix) && target.length > suffix.length;
+        }
+        return target === normalized;
+    });
+}
+function assertPassthroughAllowed(url, allowPrivateNetwork) {
+    if (allowPrivateNetwork)
+        return;
+    if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+        throw new StructuredCliError({
+            code: 'unmocked_request',
+            message: `Passthrough refused for non-http(s) URL ${url.href}.`,
+            target: 'mock',
+            where: url.href,
+        });
+    }
+    const host = url.hostname.toLowerCase();
+    const privateHost = host === 'localhost' ||
+        host === '127.0.0.1' ||
+        host === '::1' ||
+        host === '[::1]' ||
+        host.endsWith('.local') ||
+        /^10\./.test(host) ||
+        /^192\.168\./.test(host) ||
+        /^172\.(1[6-9]|2\d|3[0-1])\./.test(host);
+    if (privateHost) {
+        throw new StructuredCliError({
+            code: 'unmocked_request',
+            message: `Passthrough to private/local host ${JSON.stringify(host)} requires --allow-private-network.`,
+            target: 'mock',
+            where: url.href,
+            fix: 'Add --allow-private-network, or mock this host in .kody/mocks.ts instead of --passthrough.',
+        });
+    }
+}
+async function realNetworkFetch(input) {
+    const headers = new Headers(input.request.headers ?? {});
+    // Credentials stay fake on mock — never forward opaque credential handles
+    // or Authorization that would look like a real secret placement.
+    headers.delete('x-kody-credential-client');
+    const body = input.request.bodyBase64 != null && input.request.bodyBase64 !== ''
+        ? Buffer.from(input.request.bodyBase64, 'base64')
+        : undefined;
+    const response = await input.fetchFn(input.url, {
+        method: input.method,
+        headers,
+        ...(body !== undefined && input.method !== 'GET' && input.method !== 'HEAD'
+            ? { body }
+            : {}),
+        signal: input.signal,
+        redirect: 'manual',
+    });
+    return await serializeResponse(response);
+}
+async function serializeResponse(response) {
+    const bytes = new Uint8Array(await response.arrayBuffer());
+    return {
+        status: response.status,
+        statusText: response.statusText,
+        headers: Object.fromEntries(response.headers.entries()),
+        bodyBase64: Buffer.from(bytes).toString('base64'),
+    };
+}
+export function unmockedRequestError(method, url) {
+    const stub = buildHandlerStub(method, url);
+    return new StructuredCliError({
+        code: 'unmocked_request',
+        message: `Unmocked ${method} ${url} under --target mock.`,
+        target: 'mock',
+        where: `${method} ${url}`,
+        fix: `Add a handler in .kody/mocks.ts (or pass --passthrough ${safeHost(url)} for real network without secrets):\n\n${stub}`,
+        details: { method, url, handlerStub: stub },
+    });
+}
+export function buildHandlerStub(method, url) {
+    const verb = method.toLowerCase();
+    const httpMethod = ['get', 'post', 'put', 'patch', 'delete', 'options', 'head'].includes(verb)
+        ? verb
+        : 'all';
+    return [
+        `import { http, HttpResponse } from 'msw'`,
+        ``,
+        `export const handlers = [`,
+        `  http.${httpMethod}(${JSON.stringify(url)}, () =>`,
+        `    HttpResponse.json({ /* TODO */ }, { status: 200 }),`,
+        `  ),`,
+        `]`,
+    ].join('\n');
+}
+function safeHost(url) {
+    try {
+        return new URL(url).hostname;
+    }
+    catch {
+        return 'example.com';
+    }
+}
+/** Bridge interceptor: handle `kody.gatewayFetch` when a mock gateway is active. */
+export function tryHandleMockGatewayFetchCall(input) {
+    if (!input.gateway?.enabled)
+        return null;
+    if (input.path.join('.') !== 'kody.gatewayFetch')
+        return null;
+    return input.gateway.handle(input.args[0], input.signal);
+}
+/**
+ * Load `.kody/mocks.ts` only for `--target mock` when the file exists.
+ * Packages without the file keep native workerd fetch (no shim).
+ */
+export async function resolveMockFetchGateway(input) {
+    if (input.target !== 'mock')
+        return undefined;
+    if (!input.packageRoot)
+        return undefined;
+    const loaded = await loadPackageMocks(input.packageRoot);
+    if (!loaded)
+        return undefined;
+    input.onStatus?.(`Loaded ${loaded.handlers.length} MSW handler${loaded.handlers.length === 1 ? '' : 's'} from .kody/mocks.ts (outbound fetch fail-closed on mock).`);
+    return createMockFetchGateway({
+        handlers: loaded.handlers,
+        passthroughHosts: input.passthroughHosts,
+        allowPrivateNetwork: input.allowPrivateNetwork,
+    });
+}
+//# sourceMappingURL=mock-fetch-gateway.js.map

package/dist/mock/mock-fetch-gateway.js.map

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

package/dist/mock/mock-gateway-fetch-shim.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Mock-only workerd side-effect module (flat name
+ * `.__kody_mock_gateway_fetch__.js` — see install-mock-fetch-shim.ts).
+ * Wraps ambient `fetch` so every outbound request hops through the Node bridge
+ * as `kody.gatewayFetch` (MSW matching / passthrough / unmocked_request).
+ * Origin's `.__kody_virtual__/runtime.js` stays for CAF / packageStorage.
+ */
+/**
+ * Source for the CLI-owned mock gateway-fetch shim. Side-effect imported before
+ * user code; fetch calls happen after `__kodyInstallLocalBridge`.
+ *
+ * Registered under a flat module name so bare `"kody:runtime"` resolves to the
+ * host module (path-like names like `.__kody_virtual__/runtime.js` path-join).
+ */
+export declare function createMockGatewayFetchShimSource(): string;

package/dist/mock/mock-gateway-fetch-shim.js

@@ -0,0 +1,104 @@
+/**
+ * Mock-only workerd side-effect module (flat name
+ * `.__kody_mock_gateway_fetch__.js` — see install-mock-fetch-shim.ts).
+ * Wraps ambient `fetch` so every outbound request hops through the Node bridge
+ * as `kody.gatewayFetch` (MSW matching / passthrough / unmocked_request).
+ * Origin's `.__kody_virtual__/runtime.js` stays for CAF / packageStorage.
+ */
+import { localWorkerModuleNames } from '../local-runtime-source.js';
+/**
+ * Source for the CLI-owned mock gateway-fetch shim. Side-effect imported before
+ * user code; fetch calls happen after `__kodyInstallLocalBridge`.
+ *
+ * Registered under a flat module name so bare `"kody:runtime"` resolves to the
+ * host module (path-like names like `.__kody_virtual__/runtime.js` path-join).
+ */
+export function createMockGatewayFetchShimSource() {
+    return `
+import { kody } from ${JSON.stringify(localWorkerModuleNames.runtime)};
+
+const __kodyNativeFetch = globalThis.fetch.bind(globalThis);
+const __kodyNullBodyStatuses = new Set([101, 103, 204, 205, 304]);
+
+function __kodyBytesToBase64(bytes) {
+	let binary = '';
+	for (let i = 0; i < bytes.length; i++) binary += String.fromCharCode(bytes[i]);
+	return btoa(binary);
+}
+
+function __kodyBase64ToBytes(value) {
+	const binary = atob(String(value ?? ''));
+	const bytes = new Uint8Array(binary.length);
+	for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
+	return bytes;
+}
+
+async function __kodyBodyToBytes(body) {
+	if (body == null) return null;
+	if (typeof body === 'string') return new TextEncoder().encode(body);
+	if (body instanceof Uint8Array) return body;
+	if (body instanceof ArrayBuffer) return new Uint8Array(body);
+	if (ArrayBuffer.isView(body)) {
+		return new Uint8Array(body.buffer, body.byteOffset, body.byteLength);
+	}
+	if (typeof Blob !== 'undefined' && body instanceof Blob) {
+		return new Uint8Array(await body.arrayBuffer());
+	}
+	if (typeof URLSearchParams !== 'undefined' && body instanceof URLSearchParams) {
+		return new TextEncoder().encode(body.toString());
+	}
+	if (body && typeof body.getReader === 'function') {
+		return new Uint8Array(await new Response(body).arrayBuffer());
+	}
+	if (typeof FormData !== 'undefined' && body instanceof FormData) {
+		throw new Error(
+			'Mock fetch gateway does not support FormData bodies yet; use Uint8Array, Blob, or string.',
+		);
+	}
+	throw new Error('Mock fetch gateway could not serialize the request body.');
+}
+
+globalThis.fetch = async (input, init) => {
+	let url;
+	let method = 'GET';
+	let headers = {};
+	let bodyBytes = null;
+	if (typeof input === 'string' || input instanceof URL) {
+		url = String(input);
+		method = String(init?.method ?? 'GET');
+		headers = Object.fromEntries(new Headers(init?.headers).entries());
+		if (init?.body != null) bodyBytes = await __kodyBodyToBytes(init.body);
+	} else {
+		const merged = new Request(input, init);
+		url = merged.url;
+		method = merged.method;
+		headers = Object.fromEntries(merged.headers.entries());
+		if (method !== 'GET' && method !== 'HEAD') {
+			bodyBytes = new Uint8Array(await merged.arrayBuffer());
+		}
+	}
+	const result = await kody.gatewayFetch({
+		request: {
+			url,
+			method,
+			headers,
+			...(bodyBytes != null ? { bodyBase64: __kodyBytesToBase64(bodyBytes) } : {}),
+		},
+	});
+	const bytes = __kodyBase64ToBytes(result.bodyBase64 ?? '');
+	return new Response(
+		__kodyNullBodyStatuses.has(result.status) ? null : bytes,
+		{
+			status: result.status,
+			statusText: result.statusText ?? '',
+			headers: result.headers ?? {},
+		},
+	);
+};
+
+// Retain a reference so workerd keeps the binding available for debugging.
+void __kodyNativeFetch;
+export {};
+`.trimStart();
+}
+//# sourceMappingURL=mock-gateway-fetch-shim.js.map

package/dist/mock/mock-gateway-fetch-shim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-gateway-fetch-shim.js","sourceRoot":"","sources":["../../src/mock/mock-gateway-fetch-shim.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AAEnE;;;;;;GAMG;AACH,MAAM,UAAU,gCAAgC;IAC/C,OAAO;uBACe,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoFpE,CAAC,SAAS,EAAE,CAAA;AACb,CAAC"}