@kiwa-test/nextjs 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/README.md

@@ -0,0 +1,76 @@
+# @kiwa-test/nextjs
+
+Next.js App Router test adapter for [kiwa](https://github.com/cardene777/kiwa) — invoke Server Actions in isolation and capture redirect / cookie / header side-effects without a running Next.js server.
+
+```bash
+pnpm add -D @kiwa-test/nextjs
+```
+
+## Why
+
+Next.js Server Actions (`'use server'`) are async functions that can throw `redirect()`, mutate cookies, and call `revalidatePath()` — none of which return values. Integration-level testing through Playwright works but is slow and flaky. `@kiwa-test/nextjs` lets you call the action **directly in Vitest** and assert on the captured side-effects.
+
+## Quick start
+
+```ts
+import { describe, expect, it } from 'vitest';
+import { invokeServerAction, REDIRECT_SYMBOL } from '@kiwa-test/nextjs';
+
+// app/actions.ts — your Server Action
+async function login(formData: FormData) {
+  const email = formData.get('email') as string;
+  if (!email) throw new Error('email required');
+  // In production: redirect('/dashboard') from 'next/navigation'.
+  // In tests: throw a kiwa redirect signal so the helper can capture it.
+  throw {
+    [REDIRECT_SYMBOL]: true,
+    url: '/dashboard',
+    type: 'replace',
+  };
+}
+
+describe('login', () => {
+  it('redirects to /dashboard on success', async () => {
+    const fd = new FormData();
+    fd.set('email', 'user@example.com');
+    const { env, error } = await invokeServerAction({ action: login, formData: fd });
+    expect(error).toBeUndefined();
+    expect(env.redirect?.url).toBe('/dashboard');
+  });
+
+  it('returns validation error when email is missing', async () => {
+    const { error } = await invokeServerAction({ action: login, formData: new FormData() });
+    expect((error as Error).message).toBe('email required');
+  });
+});
+```
+
+## API
+
+### `invokeServerAction<TResult>(opts): Promise<ServerActionResult<TResult>>`
+
+Invokes a `'use server'` action and captures side-effects.
+
+| `opts` field | Type | Default | Meaning |
+|---|---|---|---|
+| `action` | `(...args) => Promise<T> \| T` | required | The Server Action under test |
+| `formData` | `FormData` | empty | First positional argument |
+| `args` | `unknown[]` | `[]` | Extra args appended after `formData` (useful for `useFormState` `(prevState, formData)` shape) |
+| `cookies` | `Record<string, string>` | `{}` | Initial cookie jar entries |
+| `headers` | `Record<string, string>` | `{}` | Initial request headers (case-insensitive) |
+
+The returned `ServerActionResult` exposes `result` (the resolved value), `error` (any non-redirect throw), and `env` (captured cookies / headers / redirect / revalidate signals).
+
+### `REDIRECT_SYMBOL`
+
+Throw a `{ [REDIRECT_SYMBOL]: true, url, type }` from your action to signal a redirect. The helper normalizes it into `env.redirect` instead of leaking it as an error. Production code keeps using `redirect()` from `next/navigation` — only the test seam differs.
+
+## Out of scope (tracked separately)
+
+- **React Server Components (RSC) render assertions** — [#494](https://github.com/cardene777/kiwa/issues/494)
+- **`middleware.ts` invocation** — [#495](https://github.com/cardene777/kiwa/issues/495)
+- **End-to-end browser flow after the action** — use `/kiwa-e2e` or `/kiwa-play` instead
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,80 @@
+"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, {
+  REDIRECT_SYMBOL: () => REDIRECT_SYMBOL,
+  invokeServerAction: () => invokeServerAction
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/invoke-server-action.ts
+var REDIRECT_SYMBOL = /* @__PURE__ */ Symbol.for("kiwa.next.redirect");
+function createCookieJar(initial) {
+  const store = new Map(Object.entries(initial));
+  return {
+    get(name) {
+      return store.get(name);
+    },
+    set(name, value) {
+      store.set(name, value);
+    },
+    delete(name) {
+      store.delete(name);
+    },
+    entries() {
+      return Array.from(store.entries());
+    }
+  };
+}
+function isRedirectSignal(value) {
+  return typeof value === "object" && value !== null && value[REDIRECT_SYMBOL] === true;
+}
+async function invokeServerAction(opts) {
+  const headers = /* @__PURE__ */ new Map();
+  for (const [name, value] of Object.entries(opts.headers ?? {})) {
+    headers.set(name.toLowerCase(), value);
+  }
+  const env = {
+    cookies: createCookieJar(opts.cookies ?? {}),
+    headers,
+    revalidated: { paths: [], tags: [] },
+    redirect: null
+  };
+  const callArgs = [opts.formData ?? new FormData(), ...opts.args ?? []];
+  let result;
+  let error;
+  try {
+    result = await opts.action(...callArgs);
+  } catch (caught) {
+    if (isRedirectSignal(caught)) {
+      env.redirect = caught;
+    } else {
+      error = caught;
+    }
+  }
+  return { result, error, env };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  REDIRECT_SYMBOL,
+  invokeServerAction
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/invoke-server-action.ts"],"sourcesContent":["export {\n  invokeServerAction,\n  type ServerActionFunction,\n  type ServerActionResult,\n  type ServerActionInvocation,\n  type ServerActionEnv,\n  type CookieJar,\n  REDIRECT_SYMBOL,\n  type RedirectSignal,\n} from './invoke-server-action.js';\n","// Next.js Server Action invocation helper for kiwa tests.\n//\n// Wraps an `'use server'` async function and captures Next.js side-effects\n// (redirect / revalidatePath / cookies set) without requiring a real Next.js\n// runtime. The test calls `invokeServerAction({ action, formData, ... })`\n// and asserts on the returned `ServerActionResult` instead of relying on\n// integration-level behavior.\n//\n// Out of scope on purpose:\n//   - real `next/server` middleware semantics (use #495 helper instead)\n//   - RSC payload format (use #494 helper instead)\n//   - rendering a page after the action (use Playwright + `/kiwa-e2e` for that)\n\nexport const REDIRECT_SYMBOL = Symbol.for('kiwa.next.redirect');\n\nexport interface RedirectSignal {\n  readonly [REDIRECT_SYMBOL]: true;\n  readonly url: string;\n  readonly type: 'replace' | 'push';\n}\n\nexport interface CookieJar {\n  get(name: string): string | undefined;\n  set(name: string, value: string, options?: Record<string, unknown>): void;\n  delete(name: string): void;\n  entries(): Array<[string, string]>;\n}\n\nexport interface ServerActionEnv {\n  readonly cookies: CookieJar;\n  readonly headers: Map<string, string>;\n  readonly revalidated: { paths: string[]; tags: string[] };\n  readonly redirect: RedirectSignal | null;\n}\n\n// We deliberately accept `any[]` here so callers can pass typed actions like\n// `(fd: FormData) => Promise<T>` or `(prev: State, fd: FormData) => Promise<T>`\n// without contortions. The runtime always invokes `action(formData, ...args)`.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type ServerActionFunction<TResult> = (...args: any[]) => Promise<TResult> | TResult;\n\nexport interface ServerActionInvocation<TResult> {\n  /** The `'use server'` async function under test. */\n  readonly action: ServerActionFunction<TResult>;\n  /** Optional FormData first argument (default empty). */\n  readonly formData?: FormData;\n  /** Extra positional args appended after FormData (e.g. previous state for useFormState). */\n  readonly args?: unknown[];\n  /** Initial cookie jar entries (name → value). */\n  readonly cookies?: Record<string, string>;\n  /** Initial request headers (case-insensitive). */\n  readonly headers?: Record<string, string>;\n}\n\nexport interface ServerActionResult<TResult> {\n  /** Resolved return value (or `undefined` if the action threw a redirect signal). */\n  readonly result: TResult | undefined;\n  /** Error thrown by the action (excluding redirect signals which are normalized). */\n  readonly error: unknown;\n  /** Side-effects captured during the invocation. */\n  readonly env: ServerActionEnv;\n}\n\nfunction createCookieJar(initial: Record<string, string>): CookieJar {\n  const store = new Map<string, string>(Object.entries(initial));\n  return {\n    get(name) {\n      return store.get(name);\n    },\n    set(name, value) {\n      store.set(name, value);\n    },\n    delete(name) {\n      store.delete(name);\n    },\n    entries() {\n      return Array.from(store.entries());\n    },\n  };\n}\n\nfunction isRedirectSignal(value: unknown): value is RedirectSignal {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    (value as { [REDIRECT_SYMBOL]?: true })[REDIRECT_SYMBOL] === true\n  );\n}\n\n/**\n * Invoke a Next.js Server Action in isolation and capture its side-effects.\n *\n * The action is called as `await action(formData, ...args)`. The kiwa helper\n * does NOT monkey-patch global `next/navigation` / `next/headers` / `next/cache`\n * imports. Instead the action under test should accept its dependencies via\n * an injectable seam (a parameter or a module-level setter) so tests stay\n * deterministic. See `examples/nextjs-server-actions-poc/` for the pattern.\n */\nexport async function invokeServerAction<TResult>(\n  opts: ServerActionInvocation<TResult>,\n): Promise<ServerActionResult<TResult>> {\n  const headers = new Map<string, string>();\n  for (const [name, value] of Object.entries(opts.headers ?? {})) {\n    headers.set(name.toLowerCase(), value);\n  }\n  const env: ServerActionEnv = {\n    cookies: createCookieJar(opts.cookies ?? {}),\n    headers,\n    revalidated: { paths: [], tags: [] },\n    redirect: null,\n  };\n  const callArgs: unknown[] = [opts.formData ?? new FormData(), ...(opts.args ?? [])];\n  let result: TResult | undefined;\n  let error: unknown;\n  try {\n    result = await opts.action(...callArgs);\n  } catch (caught) {\n    if (isRedirectSignal(caught)) {\n      (env as { redirect: RedirectSignal | null }).redirect = caught;\n    } else {\n      error = caught;\n    }\n  }\n  return { result, error, env };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACaO,IAAM,kBAAkB,uBAAO,IAAI,oBAAoB;AAkD9D,SAAS,gBAAgB,SAA4C;AACnE,QAAM,QAAQ,IAAI,IAAoB,OAAO,QAAQ,OAAO,CAAC;AAC7D,SAAO;AAAA,IACL,IAAI,MAAM;AACR,aAAO,MAAM,IAAI,IAAI;AAAA,IACvB;AAAA,IACA,IAAI,MAAM,OAAO;AACf,YAAM,IAAI,MAAM,KAAK;AAAA,IACvB;AAAA,IACA,OAAO,MAAM;AACX,YAAM,OAAO,IAAI;AAAA,IACnB;AAAA,IACA,UAAU;AACR,aAAO,MAAM,KAAK,MAAM,QAAQ,CAAC;AAAA,IACnC;AAAA,EACF;AACF;AAEA,SAAS,iBAAiB,OAAyC;AACjE,SACE,OAAO,UAAU,YACjB,UAAU,QACT,MAAuC,eAAe,MAAM;AAEjE;AAWA,eAAsB,mBACpB,MACsC;AACtC,QAAM,UAAU,oBAAI,IAAoB;AACxC,aAAW,CAAC,MAAM,KAAK,KAAK,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,GAAG;AAC9D,YAAQ,IAAI,KAAK,YAAY,GAAG,KAAK;AAAA,EACvC;AACA,QAAM,MAAuB;AAAA,IAC3B,SAAS,gBAAgB,KAAK,WAAW,CAAC,CAAC;AAAA,IAC3C;AAAA,IACA,aAAa,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,EAAE;AAAA,IACnC,UAAU;AAAA,EACZ;AACA,QAAM,WAAsB,CAAC,KAAK,YAAY,IAAI,SAAS,GAAG,GAAI,KAAK,QAAQ,CAAC,CAAE;AAClF,MAAI;AACJ,MAAI;AACJ,MAAI;AACF,aAAS,MAAM,KAAK,OAAO,GAAG,QAAQ;AAAA,EACxC,SAAS,QAAQ;AACf,QAAI,iBAAiB,MAAM,GAAG;AAC5B,MAAC,IAA4C,WAAW;AAAA,IAC1D,OAAO;AACL,cAAQ;AAAA,IACV;AAAA,EACF;AACA,SAAO,EAAE,QAAQ,OAAO,IAAI;AAC9B;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,54 @@
+declare const REDIRECT_SYMBOL: unique symbol;
+interface RedirectSignal {
+    readonly [REDIRECT_SYMBOL]: true;
+    readonly url: string;
+    readonly type: 'replace' | 'push';
+}
+interface CookieJar {
+    get(name: string): string | undefined;
+    set(name: string, value: string, options?: Record<string, unknown>): void;
+    delete(name: string): void;
+    entries(): Array<[string, string]>;
+}
+interface ServerActionEnv {
+    readonly cookies: CookieJar;
+    readonly headers: Map<string, string>;
+    readonly revalidated: {
+        paths: string[];
+        tags: string[];
+    };
+    readonly redirect: RedirectSignal | null;
+}
+type ServerActionFunction<TResult> = (...args: any[]) => Promise<TResult> | TResult;
+interface ServerActionInvocation<TResult> {
+    /** The `'use server'` async function under test. */
+    readonly action: ServerActionFunction<TResult>;
+    /** Optional FormData first argument (default empty). */
+    readonly formData?: FormData;
+    /** Extra positional args appended after FormData (e.g. previous state for useFormState). */
+    readonly args?: unknown[];
+    /** Initial cookie jar entries (name → value). */
+    readonly cookies?: Record<string, string>;
+    /** Initial request headers (case-insensitive). */
+    readonly headers?: Record<string, string>;
+}
+interface ServerActionResult<TResult> {
+    /** Resolved return value (or `undefined` if the action threw a redirect signal). */
+    readonly result: TResult | undefined;
+    /** Error thrown by the action (excluding redirect signals which are normalized). */
+    readonly error: unknown;
+    /** Side-effects captured during the invocation. */
+    readonly env: ServerActionEnv;
+}
+/**
+ * Invoke a Next.js Server Action in isolation and capture its side-effects.
+ *
+ * The action is called as `await action(formData, ...args)`. The kiwa helper
+ * does NOT monkey-patch global `next/navigation` / `next/headers` / `next/cache`
+ * imports. Instead the action under test should accept its dependencies via
+ * an injectable seam (a parameter or a module-level setter) so tests stay
+ * deterministic. See `examples/nextjs-server-actions-poc/` for the pattern.
+ */
+declare function invokeServerAction<TResult>(opts: ServerActionInvocation<TResult>): Promise<ServerActionResult<TResult>>;
+
+export { type CookieJar, REDIRECT_SYMBOL, type RedirectSignal, type ServerActionEnv, type ServerActionFunction, type ServerActionInvocation, type ServerActionResult, invokeServerAction };

package/dist/index.d.ts

@@ -0,0 +1,54 @@
+declare const REDIRECT_SYMBOL: unique symbol;
+interface RedirectSignal {
+    readonly [REDIRECT_SYMBOL]: true;
+    readonly url: string;
+    readonly type: 'replace' | 'push';
+}
+interface CookieJar {
+    get(name: string): string | undefined;
+    set(name: string, value: string, options?: Record<string, unknown>): void;
+    delete(name: string): void;
+    entries(): Array<[string, string]>;
+}
+interface ServerActionEnv {
+    readonly cookies: CookieJar;
+    readonly headers: Map<string, string>;
+    readonly revalidated: {
+        paths: string[];
+        tags: string[];
+    };
+    readonly redirect: RedirectSignal | null;
+}
+type ServerActionFunction<TResult> = (...args: any[]) => Promise<TResult> | TResult;
+interface ServerActionInvocation<TResult> {
+    /** The `'use server'` async function under test. */
+    readonly action: ServerActionFunction<TResult>;
+    /** Optional FormData first argument (default empty). */
+    readonly formData?: FormData;
+    /** Extra positional args appended after FormData (e.g. previous state for useFormState). */
+    readonly args?: unknown[];
+    /** Initial cookie jar entries (name → value). */
+    readonly cookies?: Record<string, string>;
+    /** Initial request headers (case-insensitive). */
+    readonly headers?: Record<string, string>;
+}
+interface ServerActionResult<TResult> {
+    /** Resolved return value (or `undefined` if the action threw a redirect signal). */
+    readonly result: TResult | undefined;
+    /** Error thrown by the action (excluding redirect signals which are normalized). */
+    readonly error: unknown;
+    /** Side-effects captured during the invocation. */
+    readonly env: ServerActionEnv;
+}
+/**
+ * Invoke a Next.js Server Action in isolation and capture its side-effects.
+ *
+ * The action is called as `await action(formData, ...args)`. The kiwa helper
+ * does NOT monkey-patch global `next/navigation` / `next/headers` / `next/cache`
+ * imports. Instead the action under test should accept its dependencies via
+ * an injectable seam (a parameter or a module-level setter) so tests stay
+ * deterministic. See `examples/nextjs-server-actions-poc/` for the pattern.
+ */
+declare function invokeServerAction<TResult>(opts: ServerActionInvocation<TResult>): Promise<ServerActionResult<TResult>>;
+
+export { type CookieJar, REDIRECT_SYMBOL, type RedirectSignal, type ServerActionEnv, type ServerActionFunction, type ServerActionInvocation, type ServerActionResult, invokeServerAction };

package/dist/index.js

@@ -0,0 +1,52 @@
+// src/invoke-server-action.ts
+var REDIRECT_SYMBOL = /* @__PURE__ */ Symbol.for("kiwa.next.redirect");
+function createCookieJar(initial) {
+  const store = new Map(Object.entries(initial));
+  return {
+    get(name) {
+      return store.get(name);
+    },
+    set(name, value) {
+      store.set(name, value);
+    },
+    delete(name) {
+      store.delete(name);
+    },
+    entries() {
+      return Array.from(store.entries());
+    }
+  };
+}
+function isRedirectSignal(value) {
+  return typeof value === "object" && value !== null && value[REDIRECT_SYMBOL] === true;
+}
+async function invokeServerAction(opts) {
+  const headers = /* @__PURE__ */ new Map();
+  for (const [name, value] of Object.entries(opts.headers ?? {})) {
+    headers.set(name.toLowerCase(), value);
+  }
+  const env = {
+    cookies: createCookieJar(opts.cookies ?? {}),
+    headers,
+    revalidated: { paths: [], tags: [] },
+    redirect: null
+  };
+  const callArgs = [opts.formData ?? new FormData(), ...opts.args ?? []];
+  let result;
+  let error;
+  try {
+    result = await opts.action(...callArgs);
+  } catch (caught) {
+    if (isRedirectSignal(caught)) {
+      env.redirect = caught;
+    } else {
+      error = caught;
+    }
+  }
+  return { result, error, env };
+}
+export {
+  REDIRECT_SYMBOL,
+  invokeServerAction
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/invoke-server-action.ts"],"sourcesContent":["// Next.js Server Action invocation helper for kiwa tests.\n//\n// Wraps an `'use server'` async function and captures Next.js side-effects\n// (redirect / revalidatePath / cookies set) without requiring a real Next.js\n// runtime. The test calls `invokeServerAction({ action, formData, ... })`\n// and asserts on the returned `ServerActionResult` instead of relying on\n// integration-level behavior.\n//\n// Out of scope on purpose:\n//   - real `next/server` middleware semantics (use #495 helper instead)\n//   - RSC payload format (use #494 helper instead)\n//   - rendering a page after the action (use Playwright + `/kiwa-e2e` for that)\n\nexport const REDIRECT_SYMBOL = Symbol.for('kiwa.next.redirect');\n\nexport interface RedirectSignal {\n  readonly [REDIRECT_SYMBOL]: true;\n  readonly url: string;\n  readonly type: 'replace' | 'push';\n}\n\nexport interface CookieJar {\n  get(name: string): string | undefined;\n  set(name: string, value: string, options?: Record<string, unknown>): void;\n  delete(name: string): void;\n  entries(): Array<[string, string]>;\n}\n\nexport interface ServerActionEnv {\n  readonly cookies: CookieJar;\n  readonly headers: Map<string, string>;\n  readonly revalidated: { paths: string[]; tags: string[] };\n  readonly redirect: RedirectSignal | null;\n}\n\n// We deliberately accept `any[]` here so callers can pass typed actions like\n// `(fd: FormData) => Promise<T>` or `(prev: State, fd: FormData) => Promise<T>`\n// without contortions. The runtime always invokes `action(formData, ...args)`.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type ServerActionFunction<TResult> = (...args: any[]) => Promise<TResult> | TResult;\n\nexport interface ServerActionInvocation<TResult> {\n  /** The `'use server'` async function under test. */\n  readonly action: ServerActionFunction<TResult>;\n  /** Optional FormData first argument (default empty). */\n  readonly formData?: FormData;\n  /** Extra positional args appended after FormData (e.g. previous state for useFormState). */\n  readonly args?: unknown[];\n  /** Initial cookie jar entries (name → value). */\n  readonly cookies?: Record<string, string>;\n  /** Initial request headers (case-insensitive). */\n  readonly headers?: Record<string, string>;\n}\n\nexport interface ServerActionResult<TResult> {\n  /** Resolved return value (or `undefined` if the action threw a redirect signal). */\n  readonly result: TResult | undefined;\n  /** Error thrown by the action (excluding redirect signals which are normalized). */\n  readonly error: unknown;\n  /** Side-effects captured during the invocation. */\n  readonly env: ServerActionEnv;\n}\n\nfunction createCookieJar(initial: Record<string, string>): CookieJar {\n  const store = new Map<string, string>(Object.entries(initial));\n  return {\n    get(name) {\n      return store.get(name);\n    },\n    set(name, value) {\n      store.set(name, value);\n    },\n    delete(name) {\n      store.delete(name);\n    },\n    entries() {\n      return Array.from(store.entries());\n    },\n  };\n}\n\nfunction isRedirectSignal(value: unknown): value is RedirectSignal {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    (value as { [REDIRECT_SYMBOL]?: true })[REDIRECT_SYMBOL] === true\n  );\n}\n\n/**\n * Invoke a Next.js Server Action in isolation and capture its side-effects.\n *\n * The action is called as `await action(formData, ...args)`. The kiwa helper\n * does NOT monkey-patch global `next/navigation` / `next/headers` / `next/cache`\n * imports. Instead the action under test should accept its dependencies via\n * an injectable seam (a parameter or a module-level setter) so tests stay\n * deterministic. See `examples/nextjs-server-actions-poc/` for the pattern.\n */\nexport async function invokeServerAction<TResult>(\n  opts: ServerActionInvocation<TResult>,\n): Promise<ServerActionResult<TResult>> {\n  const headers = new Map<string, string>();\n  for (const [name, value] of Object.entries(opts.headers ?? {})) {\n    headers.set(name.toLowerCase(), value);\n  }\n  const env: ServerActionEnv = {\n    cookies: createCookieJar(opts.cookies ?? {}),\n    headers,\n    revalidated: { paths: [], tags: [] },\n    redirect: null,\n  };\n  const callArgs: unknown[] = [opts.formData ?? new FormData(), ...(opts.args ?? [])];\n  let result: TResult | undefined;\n  let error: unknown;\n  try {\n    result = await opts.action(...callArgs);\n  } catch (caught) {\n    if (isRedirectSignal(caught)) {\n      (env as { redirect: RedirectSignal | null }).redirect = caught;\n    } else {\n      error = caught;\n    }\n  }\n  return { result, error, env };\n}\n"],"mappings":";AAaO,IAAM,kBAAkB,uBAAO,IAAI,oBAAoB;AAkD9D,SAAS,gBAAgB,SAA4C;AACnE,QAAM,QAAQ,IAAI,IAAoB,OAAO,QAAQ,OAAO,CAAC;AAC7D,SAAO;AAAA,IACL,IAAI,MAAM;AACR,aAAO,MAAM,IAAI,IAAI;AAAA,IACvB;AAAA,IACA,IAAI,MAAM,OAAO;AACf,YAAM,IAAI,MAAM,KAAK;AAAA,IACvB;AAAA,IACA,OAAO,MAAM;AACX,YAAM,OAAO,IAAI;AAAA,IACnB;AAAA,IACA,UAAU;AACR,aAAO,MAAM,KAAK,MAAM,QAAQ,CAAC;AAAA,IACnC;AAAA,EACF;AACF;AAEA,SAAS,iBAAiB,OAAyC;AACjE,SACE,OAAO,UAAU,YACjB,UAAU,QACT,MAAuC,eAAe,MAAM;AAEjE;AAWA,eAAsB,mBACpB,MACsC;AACtC,QAAM,UAAU,oBAAI,IAAoB;AACxC,aAAW,CAAC,MAAM,KAAK,KAAK,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,GAAG;AAC9D,YAAQ,IAAI,KAAK,YAAY,GAAG,KAAK;AAAA,EACvC;AACA,QAAM,MAAuB;AAAA,IAC3B,SAAS,gBAAgB,KAAK,WAAW,CAAC,CAAC;AAAA,IAC3C;AAAA,IACA,aAAa,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,EAAE;AAAA,IACnC,UAAU;AAAA,EACZ;AACA,QAAM,WAAsB,CAAC,KAAK,YAAY,IAAI,SAAS,GAAG,GAAI,KAAK,QAAQ,CAAC,CAAE;AAClF,MAAI;AACJ,MAAI;AACJ,MAAI;AACF,aAAS,MAAM,KAAK,OAAO,GAAG,QAAQ;AAAA,EACxC,SAAS,QAAQ;AACf,QAAI,iBAAiB,MAAM,GAAG;AAC5B,MAAC,IAA4C,WAAW;AAAA,IAC1D,OAAO;AACL,cAAQ;AAAA,IACV;AAAA,EACF;AACA,SAAO,EAAE,QAAQ,OAAO,IAAI;AAC9B;","names":[]}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@kiwa-test/nextjs",
+  "version": "1.0.1",
+  "description": "Next.js App Router test adapter for kiwa (Server Actions / RSC / middleware) — invoke Server Actions with FormData / headers / cookies and assert redirect / revalidate behavior",
+  "license": "MIT",
+  "author": {
+    "name": "cardene",
+    "url": "https://github.com/cardene777"
+  },
+  "keywords": [
+    "kiwa",
+    "nextjs",
+    "next.js",
+    "app-router",
+    "server-actions",
+    "rsc",
+    "react-server-components",
+    "middleware",
+    "testing",
+    "vitest"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cardene777/kiwa.git",
+    "directory": "packages/nextjs"
+  },
+  "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": true
+  },
+  "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-server-action.js' --coverage.exclude='.vitest-dist/tests/**' --coverage.exclude='.vitest-dist/src/index.js'",
+    "test:mutation": "stryker run",
+    "typecheck": "tsc --noEmit"
+  }
+}