@kiwa-test/nextjs 1.0.3 → 1.1.0

package/README.md

@@ -65,11 +65,63 @@ The returned `ServerActionResult` exposes `result` (the resolved value), `error`
 
 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.
 
+## RSC streaming + Suspense boundary (v1.1+, Issue #558)
+
+`setupNextRscEnv` extends the RSC seam to streaming chunks and Suspense boundary transitions — the cases `renderServerComponent` (leaf-level + signal capture) does not model.
+
+```ts
+import { describe, expect, it } from 'vitest';
+import { setupNextRscEnv } from '@kiwa-test/nextjs';
+
+async function* streamItems() {
+  yield { type: 'div', key: null, props: { children: 'partial: 1 item' } };
+  yield { type: 'div', key: null, props: { children: 'partial: 2 items' } };
+  yield { type: 'ul', key: null, props: { children: ['a', 'b', 'c'] } };
+}
+
+const fallback = { type: 'div', key: null, props: { children: 'loading…' } };
+
+describe('streamItems', () => {
+  it('captures fallback then resolved subtree in order', async () => {
+    const env = await setupNextRscEnv({
+      dataSource: streamItems(),
+      suspenseFallback: fallback,
+      streamingTimeout: 1000,
+    });
+    expect(env.fallback).toBe(fallback);
+    expect(env.chunks).toHaveLength(4); // fallback + 3 yields
+    expect(env.chunks[0]).toBe(fallback);
+    expect(env.resolved).not.toBeNull();
+    expect(env.errorBoundary).toBeNull();
+    expect(env.timedOut).toBe(false);
+  });
+
+  it('routes a thrown chunk into errorBoundary', async () => {
+    async function* broken() {
+      yield fallback;
+      throw new Error('stream broken');
+    }
+    const env = await setupNextRscEnv({ dataSource: broken() });
+    expect(env.errorBoundary).not.toBeNull();
+    expect((env.errorBoundary?.error as Error).message).toBe('stream broken');
+    expect(env.resolved).toBeNull();
+  });
+});
+```
+
+| `env` field | Type | Meaning |
+|---|---|---|
+| `chunks` | `RscNode[]` | All chunks in arrival order. `chunks[0]` is the Suspense fallback when one is provided. |
+| `fallback` | `RscNode \| null` | The fallback markup the helper captured before streaming started. |
+| `resolved` | `RscNode \| null` | The last chunk yielded by the source — what a real page settles on. `null` when the source threw or only the fallback was emitted. |
+| `errorBoundary` | `RscErrorBoundarySignal \| null` | Set when component / stream throws or `injectError` is provided. Mirrors what `error.tsx` would see. |
+| `timedOut` | `boolean` | `true` when `streamingTimeout` elapsed before the source completed. |
+
 ## 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
+- **Real React `renderToReadableStream` rendering / flight payload byte format** — leaf-level coverage lives in `renderServerComponent`, full wire protocol stays out of scope.
+- **Multiple concurrent Suspense boundaries interleaving** — one boundary per `setupNextRscEnv` call.
+- **End-to-end browser flow after the action** — use `/kiwa-e2e` or `/kiwa-play` instead.
 
 ## License
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kiwa-test/nextjs",
-  "version": "1.0.3",
-  "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",
+  "version": "1.1.0",
+  "description": "Next.js App Router test adapter for kiwa (Server Actions / RSC / middleware / Parallel Routes + Intercepting Routes) — invoke Server Actions with FormData / headers / cookies, render parallel-route layouts with named slots + intercepting URL matchers, and assert redirect / revalidate behavior",
   "license": "MIT",
   "author": {
     "name": "cardene",
@@ -16,6 +16,8 @@
     "rsc",
     "react-server-components",
     "middleware",
+    "parallel-routes",
+    "intercepting-routes",
     "testing",
     "vitest"
   ],
@@ -55,8 +57,15 @@
   "engines": {
     "node": ">=20"
   },
+  "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.include='.vitest-dist/src/invoke-middleware.js' --coverage.include='.vitest-dist/src/render-server-component.js' --coverage.include='.vitest-dist/src/invoke-parallel-routes.js' --coverage.include='.vitest-dist/src/setup-next-rsc-env.js' --coverage.exclude='.vitest-dist/tests/**' --coverage.exclude='.vitest-dist/src/index.js'",
+    "test:mutation": "stryker run",
+    "typecheck": "tsc --noEmit"
+  },
   "dependencies": {
-    "@kiwa-test/core": "1.0.1"
+    "@kiwa-test/core": "workspace:*"
   },
   "peerDependencies": {
     "vitest": "^2"
@@ -69,12 +78,5 @@
     "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.include='.vitest-dist/src/invoke-middleware.js' --coverage.include='.vitest-dist/src/render-server-component.js' --coverage.exclude='.vitest-dist/tests/**' --coverage.exclude='.vitest-dist/src/index.js'",
-    "test:mutation": "stryker run",
-    "typecheck": "tsc --noEmit"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-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

@@ -1,237 +0,0 @@
-"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, {
-  FORBIDDEN_SYMBOL: () => FORBIDDEN_SYMBOL,
-  MIDDLEWARE_ACTION_SYMBOL: () => MIDDLEWARE_ACTION_SYMBOL,
-  NOT_FOUND_SYMBOL: () => NOT_FOUND_SYMBOL,
-  REDIRECT_SYMBOL: () => REDIRECT_SYMBOL,
-  RSC_REDIRECT_SYMBOL: () => RSC_REDIRECT_SYMBOL,
-  findAll: () => findAll,
-  invokeMiddleware: () => invokeMiddleware,
-  invokeServerAction: () => invokeServerAction,
-  middlewareActions: () => middlewareActions,
-  renderServerComponent: () => renderServerComponent,
-  textContent: () => textContent
-});
-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 };
-}
-
-// src/invoke-middleware.ts
-var MIDDLEWARE_ACTION_SYMBOL = /* @__PURE__ */ Symbol.for("kiwa.next.middleware.action");
-function buildRequest(opts) {
-  const url = new URL(opts.url);
-  const headers = /* @__PURE__ */ new Map();
-  for (const [name, value] of Object.entries(opts.headers ?? {})) {
-    headers.set(name.toLowerCase(), value);
-  }
-  const cookies = new Map(Object.entries(opts.cookies ?? {}));
-  return {
-    url: opts.url,
-    method: opts.method ?? "GET",
-    headers,
-    cookies,
-    nextUrl: {
-      pathname: url.pathname,
-      search: url.search,
-      searchParams: url.searchParams
-    },
-    geo: opts.geo ?? {}
-  };
-}
-var middlewareActions = {
-  next() {
-    return { [MIDDLEWARE_ACTION_SYMBOL]: true, kind: "next" };
-  },
-  redirect(url, status = 307) {
-    return { [MIDDLEWARE_ACTION_SYMBOL]: true, kind: "redirect", url, status };
-  },
-  rewrite(url) {
-    return { [MIDDLEWARE_ACTION_SYMBOL]: true, kind: "rewrite", url };
-  },
-  json(body, status = 200) {
-    return { [MIDDLEWARE_ACTION_SYMBOL]: true, kind: "json", body, status };
-  }
-};
-async function invokeMiddleware(opts) {
-  const req = buildRequest(opts);
-  const responseHeaders = /* @__PURE__ */ new Map();
-  const responseCookies = /* @__PURE__ */ new Map();
-  const seam = {
-    setHeader(name, value) {
-      responseHeaders.set(name.toLowerCase(), value);
-    },
-    setCookie(name, value) {
-      responseCookies.set(name, value);
-    }
-  };
-  let action = middlewareActions.next();
-  let error;
-  try {
-    const result = await opts.middleware(req, seam);
-    action = result;
-  } catch (caught) {
-    error = caught;
-    action = { [MIDDLEWARE_ACTION_SYMBOL]: true, kind: "noop" };
-  }
-  return {
-    env: {
-      responseHeaders,
-      responseCookies,
-      action
-    },
-    error
-  };
-}
-
-// src/render-server-component.ts
-var NOT_FOUND_SYMBOL = /* @__PURE__ */ Symbol.for("kiwa.next.rsc.notFound");
-var FORBIDDEN_SYMBOL = /* @__PURE__ */ Symbol.for("kiwa.next.rsc.forbidden");
-var RSC_REDIRECT_SYMBOL = /* @__PURE__ */ Symbol.for("kiwa.next.rsc.redirect");
-function isRscElement(node) {
-  if (typeof node !== "object" || node === null) return false;
-  const candidate = node;
-  return typeof candidate.type !== "undefined" && typeof candidate.props === "object" && candidate.props !== null;
-}
-function isNotFound(value) {
-  return typeof value === "object" && value !== null && value[NOT_FOUND_SYMBOL] === true;
-}
-function isForbidden(value) {
-  return typeof value === "object" && value !== null && value[FORBIDDEN_SYMBOL] === true;
-}
-function isRscRedirect(value) {
-  return typeof value === "object" && value !== null && value[RSC_REDIRECT_SYMBOL] === true;
-}
-function findAll(tree, predicate) {
-  const out = [];
-  function visit(node) {
-    if (Array.isArray(node)) {
-      node.forEach(visit);
-      return;
-    }
-    if (!isRscElement(node)) return;
-    if (predicate(node)) out.push(node);
-    const children = node.props.children;
-    if (typeof children !== "undefined") {
-      visit(children);
-    }
-  }
-  visit(tree);
-  return out;
-}
-function textContent(tree) {
-  const parts = [];
-  function visit(node) {
-    if (Array.isArray(node)) {
-      node.forEach(visit);
-      return;
-    }
-    if (typeof node === "string" || typeof node === "number") {
-      parts.push(String(node));
-      return;
-    }
-    if (isRscElement(node)) {
-      const children = node.props.children;
-      if (typeof children !== "undefined") visit(children);
-    }
-  }
-  visit(tree);
-  return parts.filter((p) => p.length > 0).join(" ");
-}
-async function renderServerComponent(opts) {
-  let tree = null;
-  let signal = null;
-  let error;
-  const props = opts.props ?? {};
-  try {
-    const result = await opts.component(props);
-    tree = result;
-  } catch (caught) {
-    if (isNotFound(caught) || isForbidden(caught) || isRscRedirect(caught)) {
-      signal = caught;
-    } else {
-      error = caught;
-    }
-  }
-  return { tree, signal, error };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  FORBIDDEN_SYMBOL,
-  MIDDLEWARE_ACTION_SYMBOL,
-  NOT_FOUND_SYMBOL,
-  REDIRECT_SYMBOL,
-  RSC_REDIRECT_SYMBOL,
-  findAll,
-  invokeMiddleware,
-  invokeServerAction,
-  middlewareActions,
-  renderServerComponent,
-  textContent
-});
-//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts","../src/invoke-server-action.ts","../src/invoke-middleware.ts","../src/render-server-component.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\nexport {\n  invokeMiddleware,\n  middlewareActions,\n  MIDDLEWARE_ACTION_SYMBOL,\n  type InvokeMiddlewareOptions,\n  type InvokeMiddlewareResult,\n  type MiddlewareFunction,\n  type MiddlewareRequest,\n  type MiddlewareEnv,\n  type MiddlewareAction,\n  type MiddlewareActionKind,\n} from './invoke-middleware.js';\n\nexport {\n  renderServerComponent,\n  findAll,\n  textContent,\n  NOT_FOUND_SYMBOL,\n  FORBIDDEN_SYMBOL,\n  RSC_REDIRECT_SYMBOL,\n  type RenderServerComponentOptions,\n  type RenderServerComponentResult,\n  type RscElement,\n  type RscNode,\n  type RscSignal,\n  type NotFoundSignal,\n  type ForbiddenSignal,\n  type RscRedirectSignal,\n} from './render-server-component.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","// Next.js middleware.ts invocation helper for kiwa tests (Issue #495).\n//\n// Middleware in App Router is `(req: NextRequest) => NextResponse | Response | void`.\n// It can set response headers / cookies, throw redirect via NextResponse.redirect(),\n// rewrite via NextResponse.rewrite(), short-circuit with NextResponse.json(), or\n// pass through with NextResponse.next(). kiwa wraps the call so unit tests can\n// assert on the captured action + outgoing headers/cookies without a running\n// Next.js server.\n//\n// Out of scope on purpose:\n//   - matcher config evaluation (the test already knows which middleware to call)\n//   - revalidate / cache header semantics\n//   - Edge runtime polyfill (use Node test environment + the helper's simulated request)\n\nexport const MIDDLEWARE_ACTION_SYMBOL = Symbol.for('kiwa.next.middleware.action');\n\nexport type MiddlewareActionKind = 'next' | 'redirect' | 'rewrite' | 'json' | 'noop';\n\nexport interface MiddlewareAction {\n  readonly [MIDDLEWARE_ACTION_SYMBOL]: true;\n  readonly kind: MiddlewareActionKind;\n  readonly url?: string;\n  readonly body?: unknown;\n  readonly status?: number;\n}\n\nexport interface MiddlewareRequest {\n  readonly url: string;\n  readonly method: string;\n  readonly headers: ReadonlyMap<string, string>;\n  readonly cookies: ReadonlyMap<string, string>;\n  readonly nextUrl: {\n    readonly pathname: string;\n    readonly search: string;\n    readonly searchParams: URLSearchParams;\n  };\n  readonly geo: {\n    readonly country?: string;\n    readonly region?: string;\n    readonly city?: string;\n  };\n}\n\nexport interface MiddlewareEnv {\n  readonly responseHeaders: Map<string, string>;\n  readonly responseCookies: Map<string, string>;\n  readonly action: MiddlewareAction;\n}\n\nexport type MiddlewareFunction = (\n  req: MiddlewareRequest,\n  env: { setHeader: (name: string, value: string) => void; setCookie: (name: string, value: string) => void },\n) => MiddlewareAction | Promise<MiddlewareAction>;\n\nexport interface InvokeMiddlewareOptions {\n  readonly middleware: MiddlewareFunction;\n  readonly url: string;\n  readonly method?: string;\n  readonly headers?: Record<string, string>;\n  readonly cookies?: Record<string, string>;\n  readonly geo?: {\n    readonly country?: string;\n    readonly region?: string;\n    readonly city?: string;\n  };\n}\n\nexport interface InvokeMiddlewareResult {\n  readonly env: MiddlewareEnv;\n  readonly error: unknown;\n}\n\nfunction buildRequest(opts: InvokeMiddlewareOptions): MiddlewareRequest {\n  const url = new URL(opts.url);\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 cookies = new Map<string, string>(Object.entries(opts.cookies ?? {}));\n  return {\n    url: opts.url,\n    method: opts.method ?? 'GET',\n    headers,\n    cookies,\n    nextUrl: {\n      pathname: url.pathname,\n      search: url.search,\n      searchParams: url.searchParams,\n    },\n    geo: opts.geo ?? {},\n  };\n}\n\n/**\n * Helpers your `middleware.ts` returns instead of constructing NextResponse\n * directly. Keep the production code shape close by re-exporting these from\n * a shared module; the helper expects the returned value to be a\n * MiddlewareAction shaped object.\n */\nexport const middlewareActions = {\n  next(): MiddlewareAction {\n    return { [MIDDLEWARE_ACTION_SYMBOL]: true, kind: 'next' };\n  },\n  redirect(url: string, status = 307): MiddlewareAction {\n    return { [MIDDLEWARE_ACTION_SYMBOL]: true, kind: 'redirect', url, status };\n  },\n  rewrite(url: string): MiddlewareAction {\n    return { [MIDDLEWARE_ACTION_SYMBOL]: true, kind: 'rewrite', url };\n  },\n  json(body: unknown, status = 200): MiddlewareAction {\n    return { [MIDDLEWARE_ACTION_SYMBOL]: true, kind: 'json', body, status };\n  },\n};\n\n/**\n * Invoke a middleware function in isolation and capture its outgoing\n * response shape + headers + cookies. Mirrors the kiwa style of\n * invokeServerAction: no globals, no real Next.js runtime.\n */\nexport async function invokeMiddleware(opts: InvokeMiddlewareOptions): Promise<InvokeMiddlewareResult> {\n  const req = buildRequest(opts);\n  const responseHeaders = new Map<string, string>();\n  const responseCookies = new Map<string, string>();\n  const seam = {\n    setHeader(name: string, value: string) {\n      responseHeaders.set(name.toLowerCase(), value);\n    },\n    setCookie(name: string, value: string) {\n      responseCookies.set(name, value);\n    },\n  };\n  let action: MiddlewareAction = middlewareActions.next();\n  let error: unknown;\n  try {\n    const result = await opts.middleware(req, seam);\n    action = result;\n  } catch (caught) {\n    error = caught;\n    action = { [MIDDLEWARE_ACTION_SYMBOL]: true, kind: 'noop' };\n  }\n  return {\n    env: {\n      responseHeaders,\n      responseCookies,\n      action,\n    },\n    error,\n  };\n}\n","// Next.js async React Server Component (RSC) test helper for kiwa (Issue #494).\n//\n// Real RSC rendering involves a streaming runtime + a flight payload format\n// that requires `vitest-environment-rsc` or a Next.js dev server. kiwa takes\n// a lighter approach: treat the async server component as `async (props) =>\n// JSX.Element` and await it directly. The returned React element tree is\n// inspected with a small finder API instead of a full DOM.\n//\n// Out of scope:\n//   - flight payload serialization\n//   - client component boundary (`'use client'`)\n//   - suspense streaming (synchronous resolution only)\n//   - dangerous HTML rendering — tests assert on element shape, not strings\n\nexport const NOT_FOUND_SYMBOL = Symbol.for('kiwa.next.rsc.notFound');\nexport const FORBIDDEN_SYMBOL = Symbol.for('kiwa.next.rsc.forbidden');\nexport const RSC_REDIRECT_SYMBOL = Symbol.for('kiwa.next.rsc.redirect');\n\nexport interface NotFoundSignal {\n  readonly [NOT_FOUND_SYMBOL]: true;\n}\nexport interface ForbiddenSignal {\n  readonly [FORBIDDEN_SYMBOL]: true;\n}\nexport interface RscRedirectSignal {\n  readonly [RSC_REDIRECT_SYMBOL]: true;\n  readonly url: string;\n  readonly type: 'replace' | 'push';\n}\n\nexport type RscSignal = NotFoundSignal | ForbiddenSignal | RscRedirectSignal;\n\nexport interface RscElement {\n  readonly type: string | symbol | ((props: Record<string, unknown>) => unknown);\n  readonly props: Record<string, unknown>;\n  readonly key: string | null;\n}\n\nexport type RscNode = RscElement | string | number | boolean | null | undefined | RscNode[];\n\nexport interface RenderServerComponentOptions<TProps> {\n  readonly component: (props: TProps) => Promise<RscNode> | RscNode;\n  readonly props?: TProps;\n}\n\nexport interface RenderServerComponentResult {\n  readonly tree: RscNode;\n  readonly signal: RscSignal | null;\n  readonly error: unknown;\n}\n\nfunction isRscElement(node: unknown): node is RscElement {\n  if (typeof node !== 'object' || node === null) return false;\n  const candidate = node as { type?: unknown; props?: unknown };\n  return (\n    typeof candidate.type !== 'undefined' &&\n    typeof candidate.props === 'object' &&\n    candidate.props !== null\n  );\n}\n\nfunction isNotFound(value: unknown): value is NotFoundSignal {\n  return typeof value === 'object' && value !== null && (value as { [NOT_FOUND_SYMBOL]?: true })[NOT_FOUND_SYMBOL] === true;\n}\nfunction isForbidden(value: unknown): value is ForbiddenSignal {\n  return typeof value === 'object' && value !== null && (value as { [FORBIDDEN_SYMBOL]?: true })[FORBIDDEN_SYMBOL] === true;\n}\nfunction isRscRedirect(value: unknown): value is RscRedirectSignal {\n  return typeof value === 'object' && value !== null && (value as { [RSC_REDIRECT_SYMBOL]?: true })[RSC_REDIRECT_SYMBOL] === true;\n}\n\n/**\n * Recursively walk an RSC tree and collect every node that satisfies the\n * predicate. Children are read from `props.children` and are normalized to a\n * flat array regardless of how the component spelled them.\n */\nexport function findAll(tree: RscNode, predicate: (node: RscElement) => boolean): RscElement[] {\n  const out: RscElement[] = [];\n  function visit(node: RscNode): void {\n    if (Array.isArray(node)) {\n      node.forEach(visit);\n      return;\n    }\n    if (!isRscElement(node)) return;\n    if (predicate(node)) out.push(node);\n    const children = node.props.children;\n    if (typeof children !== 'undefined') {\n      visit(children as RscNode);\n    }\n  }\n  visit(tree);\n  return out;\n}\n\n/**\n * Concatenate every string/number leaf of an RSC tree, joined by a single\n * space. Useful for `expect(textContent(tree)).toContain('hello')` style\n * assertions where the exact element structure does not matter.\n */\nexport function textContent(tree: RscNode): string {\n  const parts: string[] = [];\n  function visit(node: RscNode): void {\n    if (Array.isArray(node)) {\n      node.forEach(visit);\n      return;\n    }\n    if (typeof node === 'string' || typeof node === 'number') {\n      parts.push(String(node));\n      return;\n    }\n    if (isRscElement(node)) {\n      const children = node.props.children;\n      if (typeof children !== 'undefined') visit(children as RscNode);\n    }\n  }\n  visit(tree);\n  return parts.filter((p) => p.length > 0).join(' ');\n}\n\n/**\n * Invoke an async server component in isolation and capture its return tree.\n * Throws of `notFound() / forbidden() / redirect()` from `next/navigation`\n * should be replaced with the kiwa signals below (Pattern A from the\n * server-action seam doc); the helper normalizes them into `result.signal`\n * instead of leaving them as `result.error`.\n */\nexport async function renderServerComponent<TProps = Record<string, unknown>>(\n  opts: RenderServerComponentOptions<TProps>,\n): Promise<RenderServerComponentResult> {\n  let tree: RscNode = null;\n  let signal: RscSignal | null = null;\n  let error: unknown;\n  const props = (opts.props ?? ({} as TProps)) as TProps;\n  try {\n    const result = await opts.component(props);\n    tree = result;\n  } catch (caught) {\n    if (isNotFound(caught) || isForbidden(caught) || isRscRedirect(caught)) {\n      signal = caught;\n    } else {\n      error = caught;\n    }\n  }\n  return { tree, signal, error };\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -1,174 +0,0 @@
-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>>;
-
-declare const MIDDLEWARE_ACTION_SYMBOL: unique symbol;
-type MiddlewareActionKind = 'next' | 'redirect' | 'rewrite' | 'json' | 'noop';
-interface MiddlewareAction {
-    readonly [MIDDLEWARE_ACTION_SYMBOL]: true;
-    readonly kind: MiddlewareActionKind;
-    readonly url?: string;
-    readonly body?: unknown;
-    readonly status?: number;
-}
-interface MiddlewareRequest {
-    readonly url: string;
-    readonly method: string;
-    readonly headers: ReadonlyMap<string, string>;
-    readonly cookies: ReadonlyMap<string, string>;
-    readonly nextUrl: {
-        readonly pathname: string;
-        readonly search: string;
-        readonly searchParams: URLSearchParams;
-    };
-    readonly geo: {
-        readonly country?: string;
-        readonly region?: string;
-        readonly city?: string;
-    };
-}
-interface MiddlewareEnv {
-    readonly responseHeaders: Map<string, string>;
-    readonly responseCookies: Map<string, string>;
-    readonly action: MiddlewareAction;
-}
-type MiddlewareFunction = (req: MiddlewareRequest, env: {
-    setHeader: (name: string, value: string) => void;
-    setCookie: (name: string, value: string) => void;
-}) => MiddlewareAction | Promise<MiddlewareAction>;
-interface InvokeMiddlewareOptions {
-    readonly middleware: MiddlewareFunction;
-    readonly url: string;
-    readonly method?: string;
-    readonly headers?: Record<string, string>;
-    readonly cookies?: Record<string, string>;
-    readonly geo?: {
-        readonly country?: string;
-        readonly region?: string;
-        readonly city?: string;
-    };
-}
-interface InvokeMiddlewareResult {
-    readonly env: MiddlewareEnv;
-    readonly error: unknown;
-}
-/**
- * Helpers your `middleware.ts` returns instead of constructing NextResponse
- * directly. Keep the production code shape close by re-exporting these from
- * a shared module; the helper expects the returned value to be a
- * MiddlewareAction shaped object.
- */
-declare const middlewareActions: {
-    next(): MiddlewareAction;
-    redirect(url: string, status?: number): MiddlewareAction;
-    rewrite(url: string): MiddlewareAction;
-    json(body: unknown, status?: number): MiddlewareAction;
-};
-/**
- * Invoke a middleware function in isolation and capture its outgoing
- * response shape + headers + cookies. Mirrors the kiwa style of
- * invokeServerAction: no globals, no real Next.js runtime.
- */
-declare function invokeMiddleware(opts: InvokeMiddlewareOptions): Promise<InvokeMiddlewareResult>;
-
-declare const NOT_FOUND_SYMBOL: unique symbol;
-declare const FORBIDDEN_SYMBOL: unique symbol;
-declare const RSC_REDIRECT_SYMBOL: unique symbol;
-interface NotFoundSignal {
-    readonly [NOT_FOUND_SYMBOL]: true;
-}
-interface ForbiddenSignal {
-    readonly [FORBIDDEN_SYMBOL]: true;
-}
-interface RscRedirectSignal {
-    readonly [RSC_REDIRECT_SYMBOL]: true;
-    readonly url: string;
-    readonly type: 'replace' | 'push';
-}
-type RscSignal = NotFoundSignal | ForbiddenSignal | RscRedirectSignal;
-interface RscElement {
-    readonly type: string | symbol | ((props: Record<string, unknown>) => unknown);
-    readonly props: Record<string, unknown>;
-    readonly key: string | null;
-}
-type RscNode = RscElement | string | number | boolean | null | undefined | RscNode[];
-interface RenderServerComponentOptions<TProps> {
-    readonly component: (props: TProps) => Promise<RscNode> | RscNode;
-    readonly props?: TProps;
-}
-interface RenderServerComponentResult {
-    readonly tree: RscNode;
-    readonly signal: RscSignal | null;
-    readonly error: unknown;
-}
-/**
- * Recursively walk an RSC tree and collect every node that satisfies the
- * predicate. Children are read from `props.children` and are normalized to a
- * flat array regardless of how the component spelled them.
- */
-declare function findAll(tree: RscNode, predicate: (node: RscElement) => boolean): RscElement[];
-/**
- * Concatenate every string/number leaf of an RSC tree, joined by a single
- * space. Useful for `expect(textContent(tree)).toContain('hello')` style
- * assertions where the exact element structure does not matter.
- */
-declare function textContent(tree: RscNode): string;
-/**
- * Invoke an async server component in isolation and capture its return tree.
- * Throws of `notFound() / forbidden() / redirect()` from `next/navigation`
- * should be replaced with the kiwa signals below (Pattern A from the
- * server-action seam doc); the helper normalizes them into `result.signal`
- * instead of leaving them as `result.error`.
- */
-declare function renderServerComponent<TProps = Record<string, unknown>>(opts: RenderServerComponentOptions<TProps>): Promise<RenderServerComponentResult>;
-
-export { type CookieJar, FORBIDDEN_SYMBOL, type ForbiddenSignal, type InvokeMiddlewareOptions, type InvokeMiddlewareResult, MIDDLEWARE_ACTION_SYMBOL, type MiddlewareAction, type MiddlewareActionKind, type MiddlewareEnv, type MiddlewareFunction, type MiddlewareRequest, NOT_FOUND_SYMBOL, type NotFoundSignal, REDIRECT_SYMBOL, RSC_REDIRECT_SYMBOL, type RedirectSignal, type RenderServerComponentOptions, type RenderServerComponentResult, type RscElement, type RscNode, type RscRedirectSignal, type RscSignal, type ServerActionEnv, type ServerActionFunction, type ServerActionInvocation, type ServerActionResult, findAll, invokeMiddleware, invokeServerAction, middlewareActions, renderServerComponent, textContent };

package/dist/index.d.ts

@@ -1,174 +0,0 @@
-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>>;
-
-declare const MIDDLEWARE_ACTION_SYMBOL: unique symbol;
-type MiddlewareActionKind = 'next' | 'redirect' | 'rewrite' | 'json' | 'noop';
-interface MiddlewareAction {
-    readonly [MIDDLEWARE_ACTION_SYMBOL]: true;
-    readonly kind: MiddlewareActionKind;
-    readonly url?: string;
-    readonly body?: unknown;
-    readonly status?: number;
-}
-interface MiddlewareRequest {
-    readonly url: string;
-    readonly method: string;
-    readonly headers: ReadonlyMap<string, string>;
-    readonly cookies: ReadonlyMap<string, string>;
-    readonly nextUrl: {
-        readonly pathname: string;
-        readonly search: string;
-        readonly searchParams: URLSearchParams;
-    };
-    readonly geo: {
-        readonly country?: string;
-        readonly region?: string;
-        readonly city?: string;
-    };
-}
-interface MiddlewareEnv {
-    readonly responseHeaders: Map<string, string>;
-    readonly responseCookies: Map<string, string>;
-    readonly action: MiddlewareAction;
-}
-type MiddlewareFunction = (req: MiddlewareRequest, env: {
-    setHeader: (name: string, value: string) => void;
-    setCookie: (name: string, value: string) => void;
-}) => MiddlewareAction | Promise<MiddlewareAction>;
-interface InvokeMiddlewareOptions {
-    readonly middleware: MiddlewareFunction;
-    readonly url: string;
-    readonly method?: string;
-    readonly headers?: Record<string, string>;
-    readonly cookies?: Record<string, string>;
-    readonly geo?: {
-        readonly country?: string;
-        readonly region?: string;
-        readonly city?: string;
-    };
-}
-interface InvokeMiddlewareResult {
-    readonly env: MiddlewareEnv;
-    readonly error: unknown;
-}
-/**
- * Helpers your `middleware.ts` returns instead of constructing NextResponse
- * directly. Keep the production code shape close by re-exporting these from
- * a shared module; the helper expects the returned value to be a
- * MiddlewareAction shaped object.
- */
-declare const middlewareActions: {
-    next(): MiddlewareAction;
-    redirect(url: string, status?: number): MiddlewareAction;
-    rewrite(url: string): MiddlewareAction;
-    json(body: unknown, status?: number): MiddlewareAction;
-};
-/**
- * Invoke a middleware function in isolation and capture its outgoing
- * response shape + headers + cookies. Mirrors the kiwa style of
- * invokeServerAction: no globals, no real Next.js runtime.
- */
-declare function invokeMiddleware(opts: InvokeMiddlewareOptions): Promise<InvokeMiddlewareResult>;
-
-declare const NOT_FOUND_SYMBOL: unique symbol;
-declare const FORBIDDEN_SYMBOL: unique symbol;
-declare const RSC_REDIRECT_SYMBOL: unique symbol;
-interface NotFoundSignal {
-    readonly [NOT_FOUND_SYMBOL]: true;
-}
-interface ForbiddenSignal {
-    readonly [FORBIDDEN_SYMBOL]: true;
-}
-interface RscRedirectSignal {
-    readonly [RSC_REDIRECT_SYMBOL]: true;
-    readonly url: string;
-    readonly type: 'replace' | 'push';
-}
-type RscSignal = NotFoundSignal | ForbiddenSignal | RscRedirectSignal;
-interface RscElement {
-    readonly type: string | symbol | ((props: Record<string, unknown>) => unknown);
-    readonly props: Record<string, unknown>;
-    readonly key: string | null;
-}
-type RscNode = RscElement | string | number | boolean | null | undefined | RscNode[];
-interface RenderServerComponentOptions<TProps> {
-    readonly component: (props: TProps) => Promise<RscNode> | RscNode;
-    readonly props?: TProps;
-}
-interface RenderServerComponentResult {
-    readonly tree: RscNode;
-    readonly signal: RscSignal | null;
-    readonly error: unknown;
-}
-/**
- * Recursively walk an RSC tree and collect every node that satisfies the
- * predicate. Children are read from `props.children` and are normalized to a
- * flat array regardless of how the component spelled them.
- */
-declare function findAll(tree: RscNode, predicate: (node: RscElement) => boolean): RscElement[];
-/**
- * Concatenate every string/number leaf of an RSC tree, joined by a single
- * space. Useful for `expect(textContent(tree)).toContain('hello')` style
- * assertions where the exact element structure does not matter.
- */
-declare function textContent(tree: RscNode): string;
-/**
- * Invoke an async server component in isolation and capture its return tree.
- * Throws of `notFound() / forbidden() / redirect()` from `next/navigation`
- * should be replaced with the kiwa signals below (Pattern A from the
- * server-action seam doc); the helper normalizes them into `result.signal`
- * instead of leaving them as `result.error`.
- */
-declare function renderServerComponent<TProps = Record<string, unknown>>(opts: RenderServerComponentOptions<TProps>): Promise<RenderServerComponentResult>;
-
-export { type CookieJar, FORBIDDEN_SYMBOL, type ForbiddenSignal, type InvokeMiddlewareOptions, type InvokeMiddlewareResult, MIDDLEWARE_ACTION_SYMBOL, type MiddlewareAction, type MiddlewareActionKind, type MiddlewareEnv, type MiddlewareFunction, type MiddlewareRequest, NOT_FOUND_SYMBOL, type NotFoundSignal, REDIRECT_SYMBOL, RSC_REDIRECT_SYMBOL, type RedirectSignal, type RenderServerComponentOptions, type RenderServerComponentResult, type RscElement, type RscNode, type RscRedirectSignal, type RscSignal, type ServerActionEnv, type ServerActionFunction, type ServerActionInvocation, type ServerActionResult, findAll, invokeMiddleware, invokeServerAction, middlewareActions, renderServerComponent, textContent };

package/dist/index.js

@@ -1,200 +0,0 @@
-// 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 };
-}
-
-// src/invoke-middleware.ts
-var MIDDLEWARE_ACTION_SYMBOL = /* @__PURE__ */ Symbol.for("kiwa.next.middleware.action");
-function buildRequest(opts) {
-  const url = new URL(opts.url);
-  const headers = /* @__PURE__ */ new Map();
-  for (const [name, value] of Object.entries(opts.headers ?? {})) {
-    headers.set(name.toLowerCase(), value);
-  }
-  const cookies = new Map(Object.entries(opts.cookies ?? {}));
-  return {
-    url: opts.url,
-    method: opts.method ?? "GET",
-    headers,
-    cookies,
-    nextUrl: {
-      pathname: url.pathname,
-      search: url.search,
-      searchParams: url.searchParams
-    },
-    geo: opts.geo ?? {}
-  };
-}
-var middlewareActions = {
-  next() {
-    return { [MIDDLEWARE_ACTION_SYMBOL]: true, kind: "next" };
-  },
-  redirect(url, status = 307) {
-    return { [MIDDLEWARE_ACTION_SYMBOL]: true, kind: "redirect", url, status };
-  },
-  rewrite(url) {
-    return { [MIDDLEWARE_ACTION_SYMBOL]: true, kind: "rewrite", url };
-  },
-  json(body, status = 200) {
-    return { [MIDDLEWARE_ACTION_SYMBOL]: true, kind: "json", body, status };
-  }
-};
-async function invokeMiddleware(opts) {
-  const req = buildRequest(opts);
-  const responseHeaders = /* @__PURE__ */ new Map();
-  const responseCookies = /* @__PURE__ */ new Map();
-  const seam = {
-    setHeader(name, value) {
-      responseHeaders.set(name.toLowerCase(), value);
-    },
-    setCookie(name, value) {
-      responseCookies.set(name, value);
-    }
-  };
-  let action = middlewareActions.next();
-  let error;
-  try {
-    const result = await opts.middleware(req, seam);
-    action = result;
-  } catch (caught) {
-    error = caught;
-    action = { [MIDDLEWARE_ACTION_SYMBOL]: true, kind: "noop" };
-  }
-  return {
-    env: {
-      responseHeaders,
-      responseCookies,
-      action
-    },
-    error
-  };
-}
-
-// src/render-server-component.ts
-var NOT_FOUND_SYMBOL = /* @__PURE__ */ Symbol.for("kiwa.next.rsc.notFound");
-var FORBIDDEN_SYMBOL = /* @__PURE__ */ Symbol.for("kiwa.next.rsc.forbidden");
-var RSC_REDIRECT_SYMBOL = /* @__PURE__ */ Symbol.for("kiwa.next.rsc.redirect");
-function isRscElement(node) {
-  if (typeof node !== "object" || node === null) return false;
-  const candidate = node;
-  return typeof candidate.type !== "undefined" && typeof candidate.props === "object" && candidate.props !== null;
-}
-function isNotFound(value) {
-  return typeof value === "object" && value !== null && value[NOT_FOUND_SYMBOL] === true;
-}
-function isForbidden(value) {
-  return typeof value === "object" && value !== null && value[FORBIDDEN_SYMBOL] === true;
-}
-function isRscRedirect(value) {
-  return typeof value === "object" && value !== null && value[RSC_REDIRECT_SYMBOL] === true;
-}
-function findAll(tree, predicate) {
-  const out = [];
-  function visit(node) {
-    if (Array.isArray(node)) {
-      node.forEach(visit);
-      return;
-    }
-    if (!isRscElement(node)) return;
-    if (predicate(node)) out.push(node);
-    const children = node.props.children;
-    if (typeof children !== "undefined") {
-      visit(children);
-    }
-  }
-  visit(tree);
-  return out;
-}
-function textContent(tree) {
-  const parts = [];
-  function visit(node) {
-    if (Array.isArray(node)) {
-      node.forEach(visit);
-      return;
-    }
-    if (typeof node === "string" || typeof node === "number") {
-      parts.push(String(node));
-      return;
-    }
-    if (isRscElement(node)) {
-      const children = node.props.children;
-      if (typeof children !== "undefined") visit(children);
-    }
-  }
-  visit(tree);
-  return parts.filter((p) => p.length > 0).join(" ");
-}
-async function renderServerComponent(opts) {
-  let tree = null;
-  let signal = null;
-  let error;
-  const props = opts.props ?? {};
-  try {
-    const result = await opts.component(props);
-    tree = result;
-  } catch (caught) {
-    if (isNotFound(caught) || isForbidden(caught) || isRscRedirect(caught)) {
-      signal = caught;
-    } else {
-      error = caught;
-    }
-  }
-  return { tree, signal, error };
-}
-export {
-  FORBIDDEN_SYMBOL,
-  MIDDLEWARE_ACTION_SYMBOL,
-  NOT_FOUND_SYMBOL,
-  REDIRECT_SYMBOL,
-  RSC_REDIRECT_SYMBOL,
-  findAll,
-  invokeMiddleware,
-  invokeServerAction,
-  middlewareActions,
-  renderServerComponent,
-  textContent
-};
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/invoke-server-action.ts","../src/invoke-middleware.ts","../src/render-server-component.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","// Next.js middleware.ts invocation helper for kiwa tests (Issue #495).\n//\n// Middleware in App Router is `(req: NextRequest) => NextResponse | Response | void`.\n// It can set response headers / cookies, throw redirect via NextResponse.redirect(),\n// rewrite via NextResponse.rewrite(), short-circuit with NextResponse.json(), or\n// pass through with NextResponse.next(). kiwa wraps the call so unit tests can\n// assert on the captured action + outgoing headers/cookies without a running\n// Next.js server.\n//\n// Out of scope on purpose:\n//   - matcher config evaluation (the test already knows which middleware to call)\n//   - revalidate / cache header semantics\n//   - Edge runtime polyfill (use Node test environment + the helper's simulated request)\n\nexport const MIDDLEWARE_ACTION_SYMBOL = Symbol.for('kiwa.next.middleware.action');\n\nexport type MiddlewareActionKind = 'next' | 'redirect' | 'rewrite' | 'json' | 'noop';\n\nexport interface MiddlewareAction {\n  readonly [MIDDLEWARE_ACTION_SYMBOL]: true;\n  readonly kind: MiddlewareActionKind;\n  readonly url?: string;\n  readonly body?: unknown;\n  readonly status?: number;\n}\n\nexport interface MiddlewareRequest {\n  readonly url: string;\n  readonly method: string;\n  readonly headers: ReadonlyMap<string, string>;\n  readonly cookies: ReadonlyMap<string, string>;\n  readonly nextUrl: {\n    readonly pathname: string;\n    readonly search: string;\n    readonly searchParams: URLSearchParams;\n  };\n  readonly geo: {\n    readonly country?: string;\n    readonly region?: string;\n    readonly city?: string;\n  };\n}\n\nexport interface MiddlewareEnv {\n  readonly responseHeaders: Map<string, string>;\n  readonly responseCookies: Map<string, string>;\n  readonly action: MiddlewareAction;\n}\n\nexport type MiddlewareFunction = (\n  req: MiddlewareRequest,\n  env: { setHeader: (name: string, value: string) => void; setCookie: (name: string, value: string) => void },\n) => MiddlewareAction | Promise<MiddlewareAction>;\n\nexport interface InvokeMiddlewareOptions {\n  readonly middleware: MiddlewareFunction;\n  readonly url: string;\n  readonly method?: string;\n  readonly headers?: Record<string, string>;\n  readonly cookies?: Record<string, string>;\n  readonly geo?: {\n    readonly country?: string;\n    readonly region?: string;\n    readonly city?: string;\n  };\n}\n\nexport interface InvokeMiddlewareResult {\n  readonly env: MiddlewareEnv;\n  readonly error: unknown;\n}\n\nfunction buildRequest(opts: InvokeMiddlewareOptions): MiddlewareRequest {\n  const url = new URL(opts.url);\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 cookies = new Map<string, string>(Object.entries(opts.cookies ?? {}));\n  return {\n    url: opts.url,\n    method: opts.method ?? 'GET',\n    headers,\n    cookies,\n    nextUrl: {\n      pathname: url.pathname,\n      search: url.search,\n      searchParams: url.searchParams,\n    },\n    geo: opts.geo ?? {},\n  };\n}\n\n/**\n * Helpers your `middleware.ts` returns instead of constructing NextResponse\n * directly. Keep the production code shape close by re-exporting these from\n * a shared module; the helper expects the returned value to be a\n * MiddlewareAction shaped object.\n */\nexport const middlewareActions = {\n  next(): MiddlewareAction {\n    return { [MIDDLEWARE_ACTION_SYMBOL]: true, kind: 'next' };\n  },\n  redirect(url: string, status = 307): MiddlewareAction {\n    return { [MIDDLEWARE_ACTION_SYMBOL]: true, kind: 'redirect', url, status };\n  },\n  rewrite(url: string): MiddlewareAction {\n    return { [MIDDLEWARE_ACTION_SYMBOL]: true, kind: 'rewrite', url };\n  },\n  json(body: unknown, status = 200): MiddlewareAction {\n    return { [MIDDLEWARE_ACTION_SYMBOL]: true, kind: 'json', body, status };\n  },\n};\n\n/**\n * Invoke a middleware function in isolation and capture its outgoing\n * response shape + headers + cookies. Mirrors the kiwa style of\n * invokeServerAction: no globals, no real Next.js runtime.\n */\nexport async function invokeMiddleware(opts: InvokeMiddlewareOptions): Promise<InvokeMiddlewareResult> {\n  const req = buildRequest(opts);\n  const responseHeaders = new Map<string, string>();\n  const responseCookies = new Map<string, string>();\n  const seam = {\n    setHeader(name: string, value: string) {\n      responseHeaders.set(name.toLowerCase(), value);\n    },\n    setCookie(name: string, value: string) {\n      responseCookies.set(name, value);\n    },\n  };\n  let action: MiddlewareAction = middlewareActions.next();\n  let error: unknown;\n  try {\n    const result = await opts.middleware(req, seam);\n    action = result;\n  } catch (caught) {\n    error = caught;\n    action = { [MIDDLEWARE_ACTION_SYMBOL]: true, kind: 'noop' };\n  }\n  return {\n    env: {\n      responseHeaders,\n      responseCookies,\n      action,\n    },\n    error,\n  };\n}\n","// Next.js async React Server Component (RSC) test helper for kiwa (Issue #494).\n//\n// Real RSC rendering involves a streaming runtime + a flight payload format\n// that requires `vitest-environment-rsc` or a Next.js dev server. kiwa takes\n// a lighter approach: treat the async server component as `async (props) =>\n// JSX.Element` and await it directly. The returned React element tree is\n// inspected with a small finder API instead of a full DOM.\n//\n// Out of scope:\n//   - flight payload serialization\n//   - client component boundary (`'use client'`)\n//   - suspense streaming (synchronous resolution only)\n//   - dangerous HTML rendering — tests assert on element shape, not strings\n\nexport const NOT_FOUND_SYMBOL = Symbol.for('kiwa.next.rsc.notFound');\nexport const FORBIDDEN_SYMBOL = Symbol.for('kiwa.next.rsc.forbidden');\nexport const RSC_REDIRECT_SYMBOL = Symbol.for('kiwa.next.rsc.redirect');\n\nexport interface NotFoundSignal {\n  readonly [NOT_FOUND_SYMBOL]: true;\n}\nexport interface ForbiddenSignal {\n  readonly [FORBIDDEN_SYMBOL]: true;\n}\nexport interface RscRedirectSignal {\n  readonly [RSC_REDIRECT_SYMBOL]: true;\n  readonly url: string;\n  readonly type: 'replace' | 'push';\n}\n\nexport type RscSignal = NotFoundSignal | ForbiddenSignal | RscRedirectSignal;\n\nexport interface RscElement {\n  readonly type: string | symbol | ((props: Record<string, unknown>) => unknown);\n  readonly props: Record<string, unknown>;\n  readonly key: string | null;\n}\n\nexport type RscNode = RscElement | string | number | boolean | null | undefined | RscNode[];\n\nexport interface RenderServerComponentOptions<TProps> {\n  readonly component: (props: TProps) => Promise<RscNode> | RscNode;\n  readonly props?: TProps;\n}\n\nexport interface RenderServerComponentResult {\n  readonly tree: RscNode;\n  readonly signal: RscSignal | null;\n  readonly error: unknown;\n}\n\nfunction isRscElement(node: unknown): node is RscElement {\n  if (typeof node !== 'object' || node === null) return false;\n  const candidate = node as { type?: unknown; props?: unknown };\n  return (\n    typeof candidate.type !== 'undefined' &&\n    typeof candidate.props === 'object' &&\n    candidate.props !== null\n  );\n}\n\nfunction isNotFound(value: unknown): value is NotFoundSignal {\n  return typeof value === 'object' && value !== null && (value as { [NOT_FOUND_SYMBOL]?: true })[NOT_FOUND_SYMBOL] === true;\n}\nfunction isForbidden(value: unknown): value is ForbiddenSignal {\n  return typeof value === 'object' && value !== null && (value as { [FORBIDDEN_SYMBOL]?: true })[FORBIDDEN_SYMBOL] === true;\n}\nfunction isRscRedirect(value: unknown): value is RscRedirectSignal {\n  return typeof value === 'object' && value !== null && (value as { [RSC_REDIRECT_SYMBOL]?: true })[RSC_REDIRECT_SYMBOL] === true;\n}\n\n/**\n * Recursively walk an RSC tree and collect every node that satisfies the\n * predicate. Children are read from `props.children` and are normalized to a\n * flat array regardless of how the component spelled them.\n */\nexport function findAll(tree: RscNode, predicate: (node: RscElement) => boolean): RscElement[] {\n  const out: RscElement[] = [];\n  function visit(node: RscNode): void {\n    if (Array.isArray(node)) {\n      node.forEach(visit);\n      return;\n    }\n    if (!isRscElement(node)) return;\n    if (predicate(node)) out.push(node);\n    const children = node.props.children;\n    if (typeof children !== 'undefined') {\n      visit(children as RscNode);\n    }\n  }\n  visit(tree);\n  return out;\n}\n\n/**\n * Concatenate every string/number leaf of an RSC tree, joined by a single\n * space. Useful for `expect(textContent(tree)).toContain('hello')` style\n * assertions where the exact element structure does not matter.\n */\nexport function textContent(tree: RscNode): string {\n  const parts: string[] = [];\n  function visit(node: RscNode): void {\n    if (Array.isArray(node)) {\n      node.forEach(visit);\n      return;\n    }\n    if (typeof node === 'string' || typeof node === 'number') {\n      parts.push(String(node));\n      return;\n    }\n    if (isRscElement(node)) {\n      const children = node.props.children;\n      if (typeof children !== 'undefined') visit(children as RscNode);\n    }\n  }\n  visit(tree);\n  return parts.filter((p) => p.length > 0).join(' ');\n}\n\n/**\n * Invoke an async server component in isolation and capture its return tree.\n * Throws of `notFound() / forbidden() / redirect()` from `next/navigation`\n * should be replaced with the kiwa signals below (Pattern A from the\n * server-action seam doc); the helper normalizes them into `result.signal`\n * instead of leaving them as `result.error`.\n */\nexport async function renderServerComponent<TProps = Record<string, unknown>>(\n  opts: RenderServerComponentOptions<TProps>,\n): Promise<RenderServerComponentResult> {\n  let tree: RscNode = null;\n  let signal: RscSignal | null = null;\n  let error: unknown;\n  const props = (opts.props ?? ({} as TProps)) as TProps;\n  try {\n    const result = await opts.component(props);\n    tree = result;\n  } catch (caught) {\n    if (isNotFound(caught) || isForbidden(caught) || isRscRedirect(caught)) {\n      signal = caught;\n    } else {\n      error = caught;\n    }\n  }\n  return { tree, signal, error };\n}\n"],"mappings":"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","names":[]}