@kiwa-test/edge 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cardene777
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,134 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createKvNamespace: () => createKvNamespace,
+  invokeEdgeHandler: () => invokeEdgeHandler
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/invoke-edge-handler.ts
+function buildRequest(opts) {
+  const headers = new Headers();
+  for (const [name, value] of Object.entries(opts.headers ?? {})) {
+    headers.set(name, value);
+  }
+  let body = null;
+  if (typeof opts.formData !== "undefined") {
+    const fd = new FormData();
+    for (const [name, value] of Object.entries(opts.formData)) {
+      fd.set(name, value);
+    }
+    body = fd;
+  } else if (typeof opts.jsonBody !== "undefined") {
+    body = JSON.stringify(opts.jsonBody);
+    if (!headers.has("content-type")) headers.set("content-type", "application/json");
+  }
+  const method = opts.method ?? (body === null ? "GET" : "POST");
+  return new Request(opts.url, body === null ? { method, headers } : { method, headers, body });
+}
+function createCtx() {
+  const waitedPromises = [];
+  const ctx = {
+    waitedPromises,
+    passThroughCalled: false,
+    waitUntil(promise) {
+      waitedPromises.push(promise);
+    },
+    passThroughOnException() {
+      ctx.passThroughCalled = true;
+    }
+  };
+  return ctx;
+}
+async function invokeEdgeHandler(opts) {
+  const reqOpts = {
+    url: opts.url,
+    ...typeof opts.method !== "undefined" ? { method: opts.method } : {},
+    ...typeof opts.headers !== "undefined" ? { headers: opts.headers } : {},
+    ...typeof opts.formData !== "undefined" ? { formData: opts.formData } : {},
+    ...typeof opts.jsonBody !== "undefined" ? { jsonBody: opts.jsonBody } : {}
+  };
+  const request = buildRequest(reqOpts);
+  const ctx = createCtx();
+  let response;
+  let redirect = null;
+  let error;
+  try {
+    response = await opts.handler(request, opts.env, ctx);
+    if (response.status >= 300 && response.status < 400) {
+      redirect = {
+        url: response.headers.get("location") ?? "",
+        status: response.status
+      };
+    }
+  } catch (caught) {
+    response = new Response(null, { status: 500 });
+    error = caught;
+  }
+  return { response, redirect, ctx, error };
+}
+
+// src/kv-mock.ts
+function createKvNamespace(initial = {}) {
+  const store = /* @__PURE__ */ new Map();
+  for (const [key, value] of Object.entries(initial)) {
+    store.set(key, { value });
+  }
+  async function getImpl(key, type) {
+    const entry = store.get(key);
+    if (typeof entry === "undefined") return null;
+    if (type === "json") return JSON.parse(entry.value);
+    if (type === "arrayBuffer") {
+      const enc = new TextEncoder().encode(entry.value);
+      return enc.buffer.slice(enc.byteOffset, enc.byteOffset + enc.byteLength);
+    }
+    return entry.value;
+  }
+  const get = getImpl;
+  return {
+    get,
+    async put(key, value, options) {
+      const metadata = options?.metadata;
+      store.set(key, typeof metadata === "undefined" ? { value } : { value, metadata });
+    },
+    async delete(key) {
+      store.delete(key);
+    },
+    async list(options) {
+      const prefix = options?.prefix ?? "";
+      const limit = options?.limit ?? 1e3;
+      const keys = [];
+      for (const [name, entry] of store.entries()) {
+        if (!name.startsWith(prefix)) continue;
+        if (keys.length >= limit) break;
+        keys.push(typeof entry.metadata === "undefined" ? { name } : { name, metadata: entry.metadata });
+      }
+      return { keys, list_complete: true };
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createKvNamespace,
+  invokeEdgeHandler
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/invoke-edge-handler.ts","../src/kv-mock.ts"],"sourcesContent":["export {\n  invokeEdgeHandler,\n  type EdgeFetchHandler,\n  type EdgeEnvBindings,\n  type InvokeEdgeHandlerOptions,\n  type InvokeEdgeHandlerResult,\n  type SimulatedExecutionContext,\n} from './invoke-edge-handler.js';\n\nexport {\n  createKvNamespace,\n  type KVNamespace,\n  type KVNamespacePutOptions,\n  type KVNamespaceListOptions,\n  type KVNamespaceListResult,\n  type KVMockEntry,\n} from './kv-mock.js';\n","// Edge runtime fetch handler test helper for kiwa (Issue #522).\n//\n// Cloudflare Workers / Vercel Edge / generic ESM-style handlers expose a\n// `fetch(request, env, ctx)` entry point. kiwa provides a simulated env\n// (binding bag: KV namespaces, R2 buckets, D1 databases, vars) + an\n// ExecutionContext stub that captures `waitUntil` / `passThroughOnException`\n// calls so tests can assert on background promises without real Workers\n// scheduler.\n\nimport type { KVNamespace } from './kv-mock.js';\n\nexport interface SimulatedExecutionContext {\n  waitUntil(promise: Promise<unknown>): void;\n  passThroughOnException(): void;\n  readonly waitedPromises: Promise<unknown>[];\n  passThroughCalled: boolean;\n}\n\nexport interface EdgeEnvBindings {\n  readonly [bindingName: string]: KVNamespace | Record<string, unknown> | string | undefined;\n}\n\nexport type EdgeFetchHandler<TEnv extends EdgeEnvBindings = EdgeEnvBindings> = (\n  request: Request,\n  env: TEnv,\n  ctx: SimulatedExecutionContext,\n) => Promise<Response> | Response;\n\nexport interface InvokeEdgeHandlerOptions<TEnv extends EdgeEnvBindings = EdgeEnvBindings> {\n  readonly handler: EdgeFetchHandler<TEnv>;\n  readonly url: string;\n  readonly method?: string;\n  readonly headers?: Record<string, string>;\n  readonly formData?: Record<string, string>;\n  readonly jsonBody?: unknown;\n  readonly env: TEnv;\n}\n\nexport interface InvokeEdgeHandlerResult {\n  readonly response: Response;\n  readonly redirect: { url: string; status: number } | null;\n  readonly ctx: SimulatedExecutionContext;\n  readonly error: unknown;\n}\n\nfunction buildRequest(opts: {\n  readonly url: string;\n  readonly method?: string;\n  readonly headers?: Record<string, string>;\n  readonly formData?: Record<string, string>;\n  readonly jsonBody?: unknown;\n}): Request {\n  const headers = new Headers();\n  for (const [name, value] of Object.entries(opts.headers ?? {})) {\n    headers.set(name, value);\n  }\n  let body: BodyInit | null = null;\n  if (typeof opts.formData !== 'undefined') {\n    const fd = new FormData();\n    for (const [name, value] of Object.entries(opts.formData)) {\n      fd.set(name, value);\n    }\n    body = fd;\n  } else if (typeof opts.jsonBody !== 'undefined') {\n    body = JSON.stringify(opts.jsonBody);\n    if (!headers.has('content-type')) headers.set('content-type', 'application/json');\n  }\n  const method = opts.method ?? (body === null ? 'GET' : 'POST');\n  return new Request(opts.url, body === null ? { method, headers } : { method, headers, body });\n}\n\nfunction createCtx(): SimulatedExecutionContext {\n  const waitedPromises: Promise<unknown>[] = [];\n  const ctx: SimulatedExecutionContext = {\n    waitedPromises,\n    passThroughCalled: false,\n    waitUntil(promise) {\n      waitedPromises.push(promise);\n    },\n    passThroughOnException() {\n      ctx.passThroughCalled = true;\n    },\n  };\n  return ctx;\n}\n\n/**\n * Invoke an edge runtime fetch handler in isolation and capture the returned\n * Response + ExecutionContext side effects. The caller supplies `env` so KV /\n * R2 / vars stay explicit in each test (no global state).\n */\nexport async function invokeEdgeHandler<TEnv extends EdgeEnvBindings = EdgeEnvBindings>(\n  opts: InvokeEdgeHandlerOptions<TEnv>,\n): Promise<InvokeEdgeHandlerResult> {\n  const reqOpts: {\n    readonly url: string;\n    readonly method?: string;\n    readonly headers?: Record<string, string>;\n    readonly formData?: Record<string, string>;\n    readonly jsonBody?: unknown;\n  } = {\n    url: opts.url,\n    ...(typeof opts.method !== 'undefined' ? { method: opts.method } : {}),\n    ...(typeof opts.headers !== 'undefined' ? { headers: opts.headers } : {}),\n    ...(typeof opts.formData !== 'undefined' ? { formData: opts.formData } : {}),\n    ...(typeof opts.jsonBody !== 'undefined' ? { jsonBody: opts.jsonBody } : {}),\n  };\n  const request = buildRequest(reqOpts);\n  const ctx = createCtx();\n  let response: Response;\n  let redirect: { url: string; status: number } | null = null;\n  let error: unknown;\n  try {\n    response = await opts.handler(request, opts.env, ctx);\n    if (response.status >= 300 && response.status < 400) {\n      redirect = {\n        url: response.headers.get('location') ?? '',\n        status: response.status,\n      };\n    }\n  } catch (caught) {\n    response = new Response(null, { status: 500 });\n    error = caught;\n  }\n  return { response, redirect, ctx, error };\n}\n","// Minimal Cloudflare KV namespace mock for kiwa edge tests.\n//\n// Implements the subset that production Workers code touches in practice:\n//   - `get(key)` / `get(key, { type: 'json' | 'text' | 'arrayBuffer' })`\n//   - `put(key, value, options?)` (TTL captured but ignored)\n//   - `delete(key)`\n//   - `list({ prefix?, limit? })` (no cursor pagination)\n//\n// Real Workers KV is eventually consistent and has a 1KB/key/24h propagation;\n// kiwa's mock is strongly consistent because tests need determinism.\n\nexport interface KVNamespacePutOptions {\n  readonly expirationTtl?: number;\n  readonly metadata?: Record<string, unknown>;\n}\n\nexport interface KVNamespaceListOptions {\n  readonly prefix?: string;\n  readonly limit?: number;\n}\n\nexport interface KVNamespaceListResult {\n  readonly keys: ReadonlyArray<{ readonly name: string; readonly metadata?: Record<string, unknown> }>;\n  readonly list_complete: true;\n}\n\nexport interface KVNamespace {\n  get(key: string): Promise<string | null>;\n  get(key: string, type: 'text'): Promise<string | null>;\n  get<T>(key: string, type: 'json'): Promise<T | null>;\n  get(key: string, type: 'arrayBuffer'): Promise<ArrayBuffer | null>;\n  put(key: string, value: string, options?: KVNamespacePutOptions): Promise<void>;\n  delete(key: string): Promise<void>;\n  list(options?: KVNamespaceListOptions): Promise<KVNamespaceListResult>;\n}\n\nexport interface KVMockEntry {\n  readonly value: string;\n  readonly metadata?: Record<string, unknown>;\n}\n\nexport function createKvNamespace(initial: Record<string, string> = {}): KVNamespace {\n  const store = new Map<string, KVMockEntry>();\n  for (const [key, value] of Object.entries(initial)) {\n    store.set(key, { value });\n  }\n  async function getImpl(key: string, type?: 'text' | 'json' | 'arrayBuffer'): Promise<unknown> {\n    const entry = store.get(key);\n    if (typeof entry === 'undefined') return null;\n    if (type === 'json') return JSON.parse(entry.value) as unknown;\n    if (type === 'arrayBuffer') {\n      const enc = new TextEncoder().encode(entry.value);\n      return enc.buffer.slice(enc.byteOffset, enc.byteOffset + enc.byteLength) as ArrayBuffer;\n    }\n    return entry.value;\n  }\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const get = getImpl as any;\n  return {\n    get,\n    async put(key: string, value: string, options?: KVNamespacePutOptions): Promise<void> {\n      const metadata = options?.metadata;\n      store.set(key, typeof metadata === 'undefined' ? { value } : { value, metadata });\n    },\n    async delete(key: string): Promise<void> {\n      store.delete(key);\n    },\n    async list(options?: KVNamespaceListOptions): Promise<KVNamespaceListResult> {\n      const prefix = options?.prefix ?? '';\n      const limit = options?.limit ?? 1000;\n      const keys: Array<{ name: string; metadata?: Record<string, unknown> }> = [];\n      for (const [name, entry] of store.entries()) {\n        if (!name.startsWith(prefix)) continue;\n        if (keys.length >= limit) break;\n        keys.push(typeof entry.metadata === 'undefined' ? { name } : { name, metadata: entry.metadata });\n      }\n      return { keys, list_complete: true };\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,66 @@
+interface KVNamespacePutOptions {
+    readonly expirationTtl?: number;
+    readonly metadata?: Record<string, unknown>;
+}
+interface KVNamespaceListOptions {
+    readonly prefix?: string;
+    readonly limit?: number;
+}
+interface KVNamespaceListResult {
+    readonly keys: ReadonlyArray<{
+        readonly name: string;
+        readonly metadata?: Record<string, unknown>;
+    }>;
+    readonly list_complete: true;
+}
+interface KVNamespace {
+    get(key: string): Promise<string | null>;
+    get(key: string, type: 'text'): Promise<string | null>;
+    get<T>(key: string, type: 'json'): Promise<T | null>;
+    get(key: string, type: 'arrayBuffer'): Promise<ArrayBuffer | null>;
+    put(key: string, value: string, options?: KVNamespacePutOptions): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(options?: KVNamespaceListOptions): Promise<KVNamespaceListResult>;
+}
+interface KVMockEntry {
+    readonly value: string;
+    readonly metadata?: Record<string, unknown>;
+}
+declare function createKvNamespace(initial?: Record<string, string>): KVNamespace;
+
+interface SimulatedExecutionContext {
+    waitUntil(promise: Promise<unknown>): void;
+    passThroughOnException(): void;
+    readonly waitedPromises: Promise<unknown>[];
+    passThroughCalled: boolean;
+}
+interface EdgeEnvBindings {
+    readonly [bindingName: string]: KVNamespace | Record<string, unknown> | string | undefined;
+}
+type EdgeFetchHandler<TEnv extends EdgeEnvBindings = EdgeEnvBindings> = (request: Request, env: TEnv, ctx: SimulatedExecutionContext) => Promise<Response> | Response;
+interface InvokeEdgeHandlerOptions<TEnv extends EdgeEnvBindings = EdgeEnvBindings> {
+    readonly handler: EdgeFetchHandler<TEnv>;
+    readonly url: string;
+    readonly method?: string;
+    readonly headers?: Record<string, string>;
+    readonly formData?: Record<string, string>;
+    readonly jsonBody?: unknown;
+    readonly env: TEnv;
+}
+interface InvokeEdgeHandlerResult {
+    readonly response: Response;
+    readonly redirect: {
+        url: string;
+        status: number;
+    } | null;
+    readonly ctx: SimulatedExecutionContext;
+    readonly error: unknown;
+}
+/**
+ * Invoke an edge runtime fetch handler in isolation and capture the returned
+ * Response + ExecutionContext side effects. The caller supplies `env` so KV /
+ * R2 / vars stay explicit in each test (no global state).
+ */
+declare function invokeEdgeHandler<TEnv extends EdgeEnvBindings = EdgeEnvBindings>(opts: InvokeEdgeHandlerOptions<TEnv>): Promise<InvokeEdgeHandlerResult>;
+
+export { type EdgeEnvBindings, type EdgeFetchHandler, type InvokeEdgeHandlerOptions, type InvokeEdgeHandlerResult, type KVMockEntry, type KVNamespace, type KVNamespaceListOptions, type KVNamespaceListResult, type KVNamespacePutOptions, type SimulatedExecutionContext, createKvNamespace, invokeEdgeHandler };

package/dist/index.d.ts

@@ -0,0 +1,66 @@
+interface KVNamespacePutOptions {
+    readonly expirationTtl?: number;
+    readonly metadata?: Record<string, unknown>;
+}
+interface KVNamespaceListOptions {
+    readonly prefix?: string;
+    readonly limit?: number;
+}
+interface KVNamespaceListResult {
+    readonly keys: ReadonlyArray<{
+        readonly name: string;
+        readonly metadata?: Record<string, unknown>;
+    }>;
+    readonly list_complete: true;
+}
+interface KVNamespace {
+    get(key: string): Promise<string | null>;
+    get(key: string, type: 'text'): Promise<string | null>;
+    get<T>(key: string, type: 'json'): Promise<T | null>;
+    get(key: string, type: 'arrayBuffer'): Promise<ArrayBuffer | null>;
+    put(key: string, value: string, options?: KVNamespacePutOptions): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(options?: KVNamespaceListOptions): Promise<KVNamespaceListResult>;
+}
+interface KVMockEntry {
+    readonly value: string;
+    readonly metadata?: Record<string, unknown>;
+}
+declare function createKvNamespace(initial?: Record<string, string>): KVNamespace;
+
+interface SimulatedExecutionContext {
+    waitUntil(promise: Promise<unknown>): void;
+    passThroughOnException(): void;
+    readonly waitedPromises: Promise<unknown>[];
+    passThroughCalled: boolean;
+}
+interface EdgeEnvBindings {
+    readonly [bindingName: string]: KVNamespace | Record<string, unknown> | string | undefined;
+}
+type EdgeFetchHandler<TEnv extends EdgeEnvBindings = EdgeEnvBindings> = (request: Request, env: TEnv, ctx: SimulatedExecutionContext) => Promise<Response> | Response;
+interface InvokeEdgeHandlerOptions<TEnv extends EdgeEnvBindings = EdgeEnvBindings> {
+    readonly handler: EdgeFetchHandler<TEnv>;
+    readonly url: string;
+    readonly method?: string;
+    readonly headers?: Record<string, string>;
+    readonly formData?: Record<string, string>;
+    readonly jsonBody?: unknown;
+    readonly env: TEnv;
+}
+interface InvokeEdgeHandlerResult {
+    readonly response: Response;
+    readonly redirect: {
+        url: string;
+        status: number;
+    } | null;
+    readonly ctx: SimulatedExecutionContext;
+    readonly error: unknown;
+}
+/**
+ * Invoke an edge runtime fetch handler in isolation and capture the returned
+ * Response + ExecutionContext side effects. The caller supplies `env` so KV /
+ * R2 / vars stay explicit in each test (no global state).
+ */
+declare function invokeEdgeHandler<TEnv extends EdgeEnvBindings = EdgeEnvBindings>(opts: InvokeEdgeHandlerOptions<TEnv>): Promise<InvokeEdgeHandlerResult>;
+
+export { type EdgeEnvBindings, type EdgeFetchHandler, type InvokeEdgeHandlerOptions, type InvokeEdgeHandlerResult, type KVMockEntry, type KVNamespace, type KVNamespaceListOptions, type KVNamespaceListResult, type KVNamespacePutOptions, type SimulatedExecutionContext, createKvNamespace, invokeEdgeHandler };

package/dist/index.js

@@ -0,0 +1,106 @@
+// src/invoke-edge-handler.ts
+function buildRequest(opts) {
+  const headers = new Headers();
+  for (const [name, value] of Object.entries(opts.headers ?? {})) {
+    headers.set(name, value);
+  }
+  let body = null;
+  if (typeof opts.formData !== "undefined") {
+    const fd = new FormData();
+    for (const [name, value] of Object.entries(opts.formData)) {
+      fd.set(name, value);
+    }
+    body = fd;
+  } else if (typeof opts.jsonBody !== "undefined") {
+    body = JSON.stringify(opts.jsonBody);
+    if (!headers.has("content-type")) headers.set("content-type", "application/json");
+  }
+  const method = opts.method ?? (body === null ? "GET" : "POST");
+  return new Request(opts.url, body === null ? { method, headers } : { method, headers, body });
+}
+function createCtx() {
+  const waitedPromises = [];
+  const ctx = {
+    waitedPromises,
+    passThroughCalled: false,
+    waitUntil(promise) {
+      waitedPromises.push(promise);
+    },
+    passThroughOnException() {
+      ctx.passThroughCalled = true;
+    }
+  };
+  return ctx;
+}
+async function invokeEdgeHandler(opts) {
+  const reqOpts = {
+    url: opts.url,
+    ...typeof opts.method !== "undefined" ? { method: opts.method } : {},
+    ...typeof opts.headers !== "undefined" ? { headers: opts.headers } : {},
+    ...typeof opts.formData !== "undefined" ? { formData: opts.formData } : {},
+    ...typeof opts.jsonBody !== "undefined" ? { jsonBody: opts.jsonBody } : {}
+  };
+  const request = buildRequest(reqOpts);
+  const ctx = createCtx();
+  let response;
+  let redirect = null;
+  let error;
+  try {
+    response = await opts.handler(request, opts.env, ctx);
+    if (response.status >= 300 && response.status < 400) {
+      redirect = {
+        url: response.headers.get("location") ?? "",
+        status: response.status
+      };
+    }
+  } catch (caught) {
+    response = new Response(null, { status: 500 });
+    error = caught;
+  }
+  return { response, redirect, ctx, error };
+}
+
+// src/kv-mock.ts
+function createKvNamespace(initial = {}) {
+  const store = /* @__PURE__ */ new Map();
+  for (const [key, value] of Object.entries(initial)) {
+    store.set(key, { value });
+  }
+  async function getImpl(key, type) {
+    const entry = store.get(key);
+    if (typeof entry === "undefined") return null;
+    if (type === "json") return JSON.parse(entry.value);
+    if (type === "arrayBuffer") {
+      const enc = new TextEncoder().encode(entry.value);
+      return enc.buffer.slice(enc.byteOffset, enc.byteOffset + enc.byteLength);
+    }
+    return entry.value;
+  }
+  const get = getImpl;
+  return {
+    get,
+    async put(key, value, options) {
+      const metadata = options?.metadata;
+      store.set(key, typeof metadata === "undefined" ? { value } : { value, metadata });
+    },
+    async delete(key) {
+      store.delete(key);
+    },
+    async list(options) {
+      const prefix = options?.prefix ?? "";
+      const limit = options?.limit ?? 1e3;
+      const keys = [];
+      for (const [name, entry] of store.entries()) {
+        if (!name.startsWith(prefix)) continue;
+        if (keys.length >= limit) break;
+        keys.push(typeof entry.metadata === "undefined" ? { name } : { name, metadata: entry.metadata });
+      }
+      return { keys, list_complete: true };
+    }
+  };
+}
+export {
+  createKvNamespace,
+  invokeEdgeHandler
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/invoke-edge-handler.ts","../src/kv-mock.ts"],"sourcesContent":["// Edge runtime fetch handler test helper for kiwa (Issue #522).\n//\n// Cloudflare Workers / Vercel Edge / generic ESM-style handlers expose a\n// `fetch(request, env, ctx)` entry point. kiwa provides a simulated env\n// (binding bag: KV namespaces, R2 buckets, D1 databases, vars) + an\n// ExecutionContext stub that captures `waitUntil` / `passThroughOnException`\n// calls so tests can assert on background promises without real Workers\n// scheduler.\n\nimport type { KVNamespace } from './kv-mock.js';\n\nexport interface SimulatedExecutionContext {\n  waitUntil(promise: Promise<unknown>): void;\n  passThroughOnException(): void;\n  readonly waitedPromises: Promise<unknown>[];\n  passThroughCalled: boolean;\n}\n\nexport interface EdgeEnvBindings {\n  readonly [bindingName: string]: KVNamespace | Record<string, unknown> | string | undefined;\n}\n\nexport type EdgeFetchHandler<TEnv extends EdgeEnvBindings = EdgeEnvBindings> = (\n  request: Request,\n  env: TEnv,\n  ctx: SimulatedExecutionContext,\n) => Promise<Response> | Response;\n\nexport interface InvokeEdgeHandlerOptions<TEnv extends EdgeEnvBindings = EdgeEnvBindings> {\n  readonly handler: EdgeFetchHandler<TEnv>;\n  readonly url: string;\n  readonly method?: string;\n  readonly headers?: Record<string, string>;\n  readonly formData?: Record<string, string>;\n  readonly jsonBody?: unknown;\n  readonly env: TEnv;\n}\n\nexport interface InvokeEdgeHandlerResult {\n  readonly response: Response;\n  readonly redirect: { url: string; status: number } | null;\n  readonly ctx: SimulatedExecutionContext;\n  readonly error: unknown;\n}\n\nfunction buildRequest(opts: {\n  readonly url: string;\n  readonly method?: string;\n  readonly headers?: Record<string, string>;\n  readonly formData?: Record<string, string>;\n  readonly jsonBody?: unknown;\n}): Request {\n  const headers = new Headers();\n  for (const [name, value] of Object.entries(opts.headers ?? {})) {\n    headers.set(name, value);\n  }\n  let body: BodyInit | null = null;\n  if (typeof opts.formData !== 'undefined') {\n    const fd = new FormData();\n    for (const [name, value] of Object.entries(opts.formData)) {\n      fd.set(name, value);\n    }\n    body = fd;\n  } else if (typeof opts.jsonBody !== 'undefined') {\n    body = JSON.stringify(opts.jsonBody);\n    if (!headers.has('content-type')) headers.set('content-type', 'application/json');\n  }\n  const method = opts.method ?? (body === null ? 'GET' : 'POST');\n  return new Request(opts.url, body === null ? { method, headers } : { method, headers, body });\n}\n\nfunction createCtx(): SimulatedExecutionContext {\n  const waitedPromises: Promise<unknown>[] = [];\n  const ctx: SimulatedExecutionContext = {\n    waitedPromises,\n    passThroughCalled: false,\n    waitUntil(promise) {\n      waitedPromises.push(promise);\n    },\n    passThroughOnException() {\n      ctx.passThroughCalled = true;\n    },\n  };\n  return ctx;\n}\n\n/**\n * Invoke an edge runtime fetch handler in isolation and capture the returned\n * Response + ExecutionContext side effects. The caller supplies `env` so KV /\n * R2 / vars stay explicit in each test (no global state).\n */\nexport async function invokeEdgeHandler<TEnv extends EdgeEnvBindings = EdgeEnvBindings>(\n  opts: InvokeEdgeHandlerOptions<TEnv>,\n): Promise<InvokeEdgeHandlerResult> {\n  const reqOpts: {\n    readonly url: string;\n    readonly method?: string;\n    readonly headers?: Record<string, string>;\n    readonly formData?: Record<string, string>;\n    readonly jsonBody?: unknown;\n  } = {\n    url: opts.url,\n    ...(typeof opts.method !== 'undefined' ? { method: opts.method } : {}),\n    ...(typeof opts.headers !== 'undefined' ? { headers: opts.headers } : {}),\n    ...(typeof opts.formData !== 'undefined' ? { formData: opts.formData } : {}),\n    ...(typeof opts.jsonBody !== 'undefined' ? { jsonBody: opts.jsonBody } : {}),\n  };\n  const request = buildRequest(reqOpts);\n  const ctx = createCtx();\n  let response: Response;\n  let redirect: { url: string; status: number } | null = null;\n  let error: unknown;\n  try {\n    response = await opts.handler(request, opts.env, ctx);\n    if (response.status >= 300 && response.status < 400) {\n      redirect = {\n        url: response.headers.get('location') ?? '',\n        status: response.status,\n      };\n    }\n  } catch (caught) {\n    response = new Response(null, { status: 500 });\n    error = caught;\n  }\n  return { response, redirect, ctx, error };\n}\n","// Minimal Cloudflare KV namespace mock for kiwa edge tests.\n//\n// Implements the subset that production Workers code touches in practice:\n//   - `get(key)` / `get(key, { type: 'json' | 'text' | 'arrayBuffer' })`\n//   - `put(key, value, options?)` (TTL captured but ignored)\n//   - `delete(key)`\n//   - `list({ prefix?, limit? })` (no cursor pagination)\n//\n// Real Workers KV is eventually consistent and has a 1KB/key/24h propagation;\n// kiwa's mock is strongly consistent because tests need determinism.\n\nexport interface KVNamespacePutOptions {\n  readonly expirationTtl?: number;\n  readonly metadata?: Record<string, unknown>;\n}\n\nexport interface KVNamespaceListOptions {\n  readonly prefix?: string;\n  readonly limit?: number;\n}\n\nexport interface KVNamespaceListResult {\n  readonly keys: ReadonlyArray<{ readonly name: string; readonly metadata?: Record<string, unknown> }>;\n  readonly list_complete: true;\n}\n\nexport interface KVNamespace {\n  get(key: string): Promise<string | null>;\n  get(key: string, type: 'text'): Promise<string | null>;\n  get<T>(key: string, type: 'json'): Promise<T | null>;\n  get(key: string, type: 'arrayBuffer'): Promise<ArrayBuffer | null>;\n  put(key: string, value: string, options?: KVNamespacePutOptions): Promise<void>;\n  delete(key: string): Promise<void>;\n  list(options?: KVNamespaceListOptions): Promise<KVNamespaceListResult>;\n}\n\nexport interface KVMockEntry {\n  readonly value: string;\n  readonly metadata?: Record<string, unknown>;\n}\n\nexport function createKvNamespace(initial: Record<string, string> = {}): KVNamespace {\n  const store = new Map<string, KVMockEntry>();\n  for (const [key, value] of Object.entries(initial)) {\n    store.set(key, { value });\n  }\n  async function getImpl(key: string, type?: 'text' | 'json' | 'arrayBuffer'): Promise<unknown> {\n    const entry = store.get(key);\n    if (typeof entry === 'undefined') return null;\n    if (type === 'json') return JSON.parse(entry.value) as unknown;\n    if (type === 'arrayBuffer') {\n      const enc = new TextEncoder().encode(entry.value);\n      return enc.buffer.slice(enc.byteOffset, enc.byteOffset + enc.byteLength) as ArrayBuffer;\n    }\n    return entry.value;\n  }\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const get = getImpl as any;\n  return {\n    get,\n    async put(key: string, value: string, options?: KVNamespacePutOptions): Promise<void> {\n      const metadata = options?.metadata;\n      store.set(key, typeof metadata === 'undefined' ? { value } : { value, metadata });\n    },\n    async delete(key: string): Promise<void> {\n      store.delete(key);\n    },\n    async list(options?: KVNamespaceListOptions): Promise<KVNamespaceListResult> {\n      const prefix = options?.prefix ?? '';\n      const limit = options?.limit ?? 1000;\n      const keys: Array<{ name: string; metadata?: Record<string, unknown> }> = [];\n      for (const [name, entry] of store.entries()) {\n        if (!name.startsWith(prefix)) continue;\n        if (keys.length >= limit) break;\n        keys.push(typeof entry.metadata === 'undefined' ? { name } : { name, metadata: entry.metadata });\n      }\n      return { keys, list_complete: true };\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@kiwa-test/edge",
+  "version": "1.0.1",
+  "description": "Edge runtime fetch handler test adapter for kiwa — invoke Cloudflare Workers / Vercel Edge / generic edge handlers with simulated env (KV / R2 / D1 / DurableObject minimal mocks) + ExecutionContext (waitUntil / passThroughOnException) without a running Miniflare or workerd (part of the kiwa test framework family)",
+  "license": "MIT",
+  "author": {
+    "name": "cardene",
+    "url": "https://github.com/cardene777"
+  },
+  "keywords": [
+    "kiwa",
+    "edge",
+    "cloudflare-workers",
+    "vercel-edge",
+    "miniflare",
+    "kv",
+    "r2",
+    "d1",
+    "testing",
+    "vitest"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cardene777/kiwa.git",
+    "directory": "packages/edge"
+  },
+  "homepage": "https://github.com/cardene777/kiwa#readme",
+  "bugs": {
+    "url": "https://github.com/cardene777/kiwa/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@kiwa-test/core": "1.0.1"
+  },
+  "peerDependencies": {
+    "vitest": "^2"
+  },
+  "devDependencies": {
+    "@stryker-mutator/core": "^8.7.1",
+    "@stryker-mutator/vitest-runner": "^8.7.1",
+    "@types/node": "^22.10.0",
+    "@vitest/coverage-v8": "^2.1.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "node -e \"require('node:fs').rmSync('.vitest-dist',{recursive:true,force:true})\" && tsc -p tsconfig.vitest.json && vitest run .vitest-dist/tests --environment node",
+    "test:cov": "node -e \"require('node:fs').rmSync('.vitest-dist',{recursive:true,force:true})\" && tsc -p tsconfig.vitest.json && vitest run .vitest-dist/tests --environment node --coverage --coverage.provider=v8 --coverage.reporter=json --coverage.reporter=json-summary --coverage.reporter=text --coverage.reportsDirectory=coverage --coverage.include='.vitest-dist/src/invoke-edge-handler.js' --coverage.include='.vitest-dist/src/kv-mock.js' --coverage.exclude='.vitest-dist/tests/**' --coverage.exclude='.vitest-dist/src/index.js'",
+    "test:mutation": "stryker run",
+    "typecheck": "tsc --noEmit"
+  }
+}