@kiwa-test/nextjs 1.0.1 → 1.0.5

package/dist/index.cjs

@@ -20,8 +20,19 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // 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,
+  PARALLEL_INTERCEPTION_SYMBOL: () => PARALLEL_INTERCEPTION_SYMBOL,
   REDIRECT_SYMBOL: () => REDIRECT_SYMBOL,
-  invokeServerAction: () => invokeServerAction
+  RSC_REDIRECT_SYMBOL: () => RSC_REDIRECT_SYMBOL,
+  findAll: () => findAll,
+  invokeMiddleware: () => invokeMiddleware,
+  invokeParallelRoutes: () => invokeParallelRoutes,
+  invokeServerAction: () => invokeServerAction,
+  middlewareActions: () => middlewareActions,
+  renderServerComponent: () => renderServerComponent,
+  textContent: () => textContent
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -72,9 +83,216 @@ async function invokeServerAction(opts) {
   }
   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 };
+}
+
+// src/invoke-parallel-routes.ts
+var PARALLEL_INTERCEPTION_SYMBOL = /* @__PURE__ */ Symbol.for("kiwa.next.parallel.interception");
+async function renderSlot(input) {
+  let tree = null;
+  let usedDefault = false;
+  let error;
+  const interception = input.intercepting ? {
+    [PARALLEL_INTERCEPTION_SYMBOL]: true,
+    slot: input.slot,
+    variant: input.intercepting.variant,
+    url: input.intercepting.url,
+    distance: input.intercepting.distance ?? "sibling"
+  } : null;
+  const useDefault = input.component === null || interception?.variant === "default";
+  try {
+    if (useDefault) {
+      if (typeof input.defaultFallback !== "function") {
+        throw new Error(`slot ${input.slot}: no default.tsx fallback supplied`);
+      }
+      tree = await input.defaultFallback();
+      usedDefault = true;
+    } else if (input.component !== null) {
+      tree = await input.component(input.props ?? {});
+    }
+  } catch (caught) {
+    error = caught;
+  }
+  return { slot: input.slot, tree, usedDefault, interception, error };
+}
+async function invokeParallelRoutes(opts) {
+  let childrenTree = null;
+  let childrenError;
+  let layoutError;
+  try {
+    childrenTree = await opts.children(opts.childrenProps ?? {});
+  } catch (caught) {
+    childrenError = caught;
+  }
+  const slotResults = await Promise.all(opts.slots.map((input) => renderSlot(input)));
+  const slotMap = {};
+  for (const result of slotResults) {
+    slotMap[result.slot] = result.tree;
+  }
+  let tree = null;
+  try {
+    const props = {
+      ...opts.layoutProps ?? {},
+      children: childrenTree,
+      slots: slotMap
+    };
+    tree = await opts.layout(props);
+  } catch (caught) {
+    layoutError = caught;
+  }
+  return { tree, slotResults, childrenError, layoutError };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  FORBIDDEN_SYMBOL,
+  MIDDLEWARE_ACTION_SYMBOL,
+  NOT_FOUND_SYMBOL,
+  PARALLEL_INTERCEPTION_SYMBOL,
   REDIRECT_SYMBOL,
-  invokeServerAction
+  RSC_REDIRECT_SYMBOL,
+  findAll,
+  invokeMiddleware,
+  invokeParallelRoutes,
+  invokeServerAction,
+  middlewareActions,
+  renderServerComponent,
+  textContent
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +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":[]}
+{"version":3,"sources":["../src/index.ts","../src/invoke-server-action.ts","../src/invoke-middleware.ts","../src/render-server-component.ts","../src/invoke-parallel-routes.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\nexport {\n  invokeParallelRoutes,\n  PARALLEL_INTERCEPTION_SYMBOL,\n  type InvokeParallelRoutesOptions,\n  type InvokeParallelRoutesResult,\n  type ParallelLayoutFunction,\n  type ParallelLayoutChildren,\n  type SlotComponent,\n  type SlotInput,\n  type SlotRenderResult,\n  type DefaultFallbackComponent,\n  type InterceptionMatch,\n} from './invoke-parallel-routes.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","// Next.js App Router Parallel Routes test helper for kiwa (Issue #523).\n//\n// Parallel Routes let an App Router layout render multiple async components in\n// named slots: `layout({ children, @modal, @sidebar })`. Each slot may also\n// provide a `default.tsx` fallback when no matching segment is present, and\n// the URL pattern `(.)`/`(..)`/`(...)` enables Intercepting Routes that swap\n// the slot rendering based on soft-vs-hard navigation.\n//\n// kiwa renders the layout in isolation with synthetic slot trees. The helper\n// awaits all slot promises in parallel (mirroring the React parallel-render\n// semantics), supplies optional Intercepting-Route resolution, and captures\n// errors per slot so a single failing slot does not collapse the whole tree.\n//\n// Out of scope on purpose:\n//   - real flight payload / React renderer (use `renderServerComponent` for\n//     leaf-level RSC introspection)\n//   - matcher / `loading.tsx` / `error.tsx` evaluation\n//   - client component boundary (`'use client'`)\n\nexport const PARALLEL_INTERCEPTION_SYMBOL = Symbol.for('kiwa.next.parallel.interception');\n\nexport interface InterceptionMatch<TSlot extends string> {\n  readonly [PARALLEL_INTERCEPTION_SYMBOL]: true;\n  readonly slot: TSlot;\n  readonly variant: 'intercepted' | 'default';\n  readonly url: string;\n  readonly distance: 'sibling' | 'parent' | 'root';\n}\n\nexport type SlotComponent<TProps = Record<string, unknown>, TNode = unknown> = (\n  props: TProps,\n) => Promise<TNode> | TNode;\n\nexport type DefaultFallbackComponent<TNode = unknown> = () => Promise<TNode> | TNode;\n\nexport interface ParallelLayoutChildren<TSlots extends string, TNode = unknown> {\n  readonly children: TNode;\n  readonly slots: Readonly<Record<TSlots, TNode>>;\n}\n\nexport type ParallelLayoutFunction<TSlots extends string, TLayoutProps, TNode = unknown> = (\n  props: TLayoutProps & ParallelLayoutChildren<TSlots, TNode>,\n) => Promise<TNode> | TNode;\n\nexport interface SlotInput<TSlots extends string, TNode = unknown> {\n  readonly slot: TSlots;\n  readonly component: SlotComponent<Record<string, unknown>, TNode> | null;\n  readonly props?: Record<string, unknown>;\n  readonly defaultFallback?: DefaultFallbackComponent<TNode>;\n  readonly intercepting?: {\n    readonly variant: 'intercepted' | 'default';\n    readonly url: string;\n    readonly distance?: 'sibling' | 'parent' | 'root';\n  };\n}\n\nexport interface InvokeParallelRoutesOptions<TSlots extends string, TLayoutProps, TNode = unknown> {\n  readonly layout: ParallelLayoutFunction<TSlots, TLayoutProps, TNode>;\n  readonly children: SlotComponent<Record<string, unknown>, TNode>;\n  readonly childrenProps?: Record<string, unknown>;\n  readonly slots: ReadonlyArray<SlotInput<TSlots, TNode>>;\n  readonly layoutProps?: TLayoutProps;\n}\n\nexport interface SlotRenderResult<TSlots extends string, TNode = unknown> {\n  readonly slot: TSlots;\n  readonly tree: TNode | null;\n  readonly usedDefault: boolean;\n  readonly interception: InterceptionMatch<TSlots> | null;\n  readonly error: unknown;\n}\n\nexport interface InvokeParallelRoutesResult<TSlots extends string, TNode = unknown> {\n  readonly tree: TNode | null;\n  readonly slotResults: ReadonlyArray<SlotRenderResult<TSlots, TNode>>;\n  readonly childrenError: unknown;\n  readonly layoutError: unknown;\n}\n\nasync function renderSlot<TSlots extends string, TNode>(\n  input: SlotInput<TSlots, TNode>,\n): Promise<SlotRenderResult<TSlots, TNode>> {\n  let tree: TNode | null = null;\n  let usedDefault = false;\n  let error: unknown;\n  const interception: InterceptionMatch<TSlots> | null = input.intercepting\n    ? {\n        [PARALLEL_INTERCEPTION_SYMBOL]: true,\n        slot: input.slot,\n        variant: input.intercepting.variant,\n        url: input.intercepting.url,\n        distance: input.intercepting.distance ?? 'sibling',\n      }\n    : null;\n  const useDefault =\n    input.component === null ||\n    interception?.variant === 'default';\n  try {\n    if (useDefault) {\n      if (typeof input.defaultFallback !== 'function') {\n        throw new Error(`slot ${input.slot}: no default.tsx fallback supplied`);\n      }\n      tree = await input.defaultFallback();\n      usedDefault = true;\n    } else if (input.component !== null) {\n      tree = await input.component(input.props ?? {});\n    }\n  } catch (caught) {\n    error = caught;\n  }\n  return { slot: input.slot, tree, usedDefault, interception, error };\n}\n\n/**\n * Invoke an App Router parallel-routes layout in isolation. All slot\n * components are rendered in parallel (Promise.all) so a slow slot cannot\n * block fast siblings; per-slot errors are captured into `slotResults`\n * without aborting the layout render.\n */\nexport async function invokeParallelRoutes<\n  TSlots extends string,\n  TLayoutProps = Record<string, unknown>,\n  TNode = unknown,\n>(\n  opts: InvokeParallelRoutesOptions<TSlots, TLayoutProps, TNode>,\n): Promise<InvokeParallelRoutesResult<TSlots, TNode>> {\n  let childrenTree: TNode | null = null;\n  let childrenError: unknown;\n  let layoutError: unknown;\n  try {\n    childrenTree = await opts.children(opts.childrenProps ?? {});\n  } catch (caught) {\n    childrenError = caught;\n  }\n  const slotResults = await Promise.all(opts.slots.map((input) => renderSlot(input)));\n  const slotMap: Record<string, TNode | null> = {};\n  for (const result of slotResults) {\n    slotMap[result.slot] = result.tree;\n  }\n  let tree: TNode | null = null;\n  try {\n    const props = {\n      ...((opts.layoutProps ?? {}) as TLayoutProps),\n      children: childrenTree as TNode,\n      slots: slotMap as Readonly<Record<TSlots, TNode>>,\n    } as TLayoutProps & ParallelLayoutChildren<TSlots, TNode>;\n    tree = await opts.layout(props);\n  } catch (caught) {\n    layoutError = caught;\n  }\n  return { tree, slotResults, childrenError, layoutError };\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -51,4 +51,178 @@ interface ServerActionResult<TResult> {
  */
 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 };
+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>;
+
+declare const PARALLEL_INTERCEPTION_SYMBOL: unique symbol;
+interface InterceptionMatch<TSlot extends string> {
+    readonly [PARALLEL_INTERCEPTION_SYMBOL]: true;
+    readonly slot: TSlot;
+    readonly variant: 'intercepted' | 'default';
+    readonly url: string;
+    readonly distance: 'sibling' | 'parent' | 'root';
+}
+type SlotComponent<TProps = Record<string, unknown>, TNode = unknown> = (props: TProps) => Promise<TNode> | TNode;
+type DefaultFallbackComponent<TNode = unknown> = () => Promise<TNode> | TNode;
+interface ParallelLayoutChildren<TSlots extends string, TNode = unknown> {
+    readonly children: TNode;
+    readonly slots: Readonly<Record<TSlots, TNode>>;
+}
+type ParallelLayoutFunction<TSlots extends string, TLayoutProps, TNode = unknown> = (props: TLayoutProps & ParallelLayoutChildren<TSlots, TNode>) => Promise<TNode> | TNode;
+interface SlotInput<TSlots extends string, TNode = unknown> {
+    readonly slot: TSlots;
+    readonly component: SlotComponent<Record<string, unknown>, TNode> | null;
+    readonly props?: Record<string, unknown>;
+    readonly defaultFallback?: DefaultFallbackComponent<TNode>;
+    readonly intercepting?: {
+        readonly variant: 'intercepted' | 'default';
+        readonly url: string;
+        readonly distance?: 'sibling' | 'parent' | 'root';
+    };
+}
+interface InvokeParallelRoutesOptions<TSlots extends string, TLayoutProps, TNode = unknown> {
+    readonly layout: ParallelLayoutFunction<TSlots, TLayoutProps, TNode>;
+    readonly children: SlotComponent<Record<string, unknown>, TNode>;
+    readonly childrenProps?: Record<string, unknown>;
+    readonly slots: ReadonlyArray<SlotInput<TSlots, TNode>>;
+    readonly layoutProps?: TLayoutProps;
+}
+interface SlotRenderResult<TSlots extends string, TNode = unknown> {
+    readonly slot: TSlots;
+    readonly tree: TNode | null;
+    readonly usedDefault: boolean;
+    readonly interception: InterceptionMatch<TSlots> | null;
+    readonly error: unknown;
+}
+interface InvokeParallelRoutesResult<TSlots extends string, TNode = unknown> {
+    readonly tree: TNode | null;
+    readonly slotResults: ReadonlyArray<SlotRenderResult<TSlots, TNode>>;
+    readonly childrenError: unknown;
+    readonly layoutError: unknown;
+}
+/**
+ * Invoke an App Router parallel-routes layout in isolation. All slot
+ * components are rendered in parallel (Promise.all) so a slow slot cannot
+ * block fast siblings; per-slot errors are captured into `slotResults`
+ * without aborting the layout render.
+ */
+declare function invokeParallelRoutes<TSlots extends string, TLayoutProps = Record<string, unknown>, TNode = unknown>(opts: InvokeParallelRoutesOptions<TSlots, TLayoutProps, TNode>): Promise<InvokeParallelRoutesResult<TSlots, TNode>>;
+
+export { type CookieJar, type DefaultFallbackComponent, FORBIDDEN_SYMBOL, type ForbiddenSignal, type InterceptionMatch, type InvokeMiddlewareOptions, type InvokeMiddlewareResult, type InvokeParallelRoutesOptions, type InvokeParallelRoutesResult, MIDDLEWARE_ACTION_SYMBOL, type MiddlewareAction, type MiddlewareActionKind, type MiddlewareEnv, type MiddlewareFunction, type MiddlewareRequest, NOT_FOUND_SYMBOL, type NotFoundSignal, PARALLEL_INTERCEPTION_SYMBOL, type ParallelLayoutChildren, type ParallelLayoutFunction, 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, type SlotComponent, type SlotInput, type SlotRenderResult, findAll, invokeMiddleware, invokeParallelRoutes, invokeServerAction, middlewareActions, renderServerComponent, textContent };

package/dist/index.d.ts

@@ -51,4 +51,178 @@ interface ServerActionResult<TResult> {
  */
 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 };
+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>;
+
+declare const PARALLEL_INTERCEPTION_SYMBOL: unique symbol;
+interface InterceptionMatch<TSlot extends string> {
+    readonly [PARALLEL_INTERCEPTION_SYMBOL]: true;
+    readonly slot: TSlot;
+    readonly variant: 'intercepted' | 'default';
+    readonly url: string;
+    readonly distance: 'sibling' | 'parent' | 'root';
+}
+type SlotComponent<TProps = Record<string, unknown>, TNode = unknown> = (props: TProps) => Promise<TNode> | TNode;
+type DefaultFallbackComponent<TNode = unknown> = () => Promise<TNode> | TNode;
+interface ParallelLayoutChildren<TSlots extends string, TNode = unknown> {
+    readonly children: TNode;
+    readonly slots: Readonly<Record<TSlots, TNode>>;
+}
+type ParallelLayoutFunction<TSlots extends string, TLayoutProps, TNode = unknown> = (props: TLayoutProps & ParallelLayoutChildren<TSlots, TNode>) => Promise<TNode> | TNode;
+interface SlotInput<TSlots extends string, TNode = unknown> {
+    readonly slot: TSlots;
+    readonly component: SlotComponent<Record<string, unknown>, TNode> | null;
+    readonly props?: Record<string, unknown>;
+    readonly defaultFallback?: DefaultFallbackComponent<TNode>;
+    readonly intercepting?: {
+        readonly variant: 'intercepted' | 'default';
+        readonly url: string;
+        readonly distance?: 'sibling' | 'parent' | 'root';
+    };
+}
+interface InvokeParallelRoutesOptions<TSlots extends string, TLayoutProps, TNode = unknown> {
+    readonly layout: ParallelLayoutFunction<TSlots, TLayoutProps, TNode>;
+    readonly children: SlotComponent<Record<string, unknown>, TNode>;
+    readonly childrenProps?: Record<string, unknown>;
+    readonly slots: ReadonlyArray<SlotInput<TSlots, TNode>>;
+    readonly layoutProps?: TLayoutProps;
+}
+interface SlotRenderResult<TSlots extends string, TNode = unknown> {
+    readonly slot: TSlots;
+    readonly tree: TNode | null;
+    readonly usedDefault: boolean;
+    readonly interception: InterceptionMatch<TSlots> | null;
+    readonly error: unknown;
+}
+interface InvokeParallelRoutesResult<TSlots extends string, TNode = unknown> {
+    readonly tree: TNode | null;
+    readonly slotResults: ReadonlyArray<SlotRenderResult<TSlots, TNode>>;
+    readonly childrenError: unknown;
+    readonly layoutError: unknown;
+}
+/**
+ * Invoke an App Router parallel-routes layout in isolation. All slot
+ * components are rendered in parallel (Promise.all) so a slow slot cannot
+ * block fast siblings; per-slot errors are captured into `slotResults`
+ * without aborting the layout render.
+ */
+declare function invokeParallelRoutes<TSlots extends string, TLayoutProps = Record<string, unknown>, TNode = unknown>(opts: InvokeParallelRoutesOptions<TSlots, TLayoutProps, TNode>): Promise<InvokeParallelRoutesResult<TSlots, TNode>>;
+
+export { type CookieJar, type DefaultFallbackComponent, FORBIDDEN_SYMBOL, type ForbiddenSignal, type InterceptionMatch, type InvokeMiddlewareOptions, type InvokeMiddlewareResult, type InvokeParallelRoutesOptions, type InvokeParallelRoutesResult, MIDDLEWARE_ACTION_SYMBOL, type MiddlewareAction, type MiddlewareActionKind, type MiddlewareEnv, type MiddlewareFunction, type MiddlewareRequest, NOT_FOUND_SYMBOL, type NotFoundSignal, PARALLEL_INTERCEPTION_SYMBOL, type ParallelLayoutChildren, type ParallelLayoutFunction, 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, type SlotComponent, type SlotInput, type SlotRenderResult, findAll, invokeMiddleware, invokeParallelRoutes, invokeServerAction, middlewareActions, renderServerComponent, textContent };

package/dist/index.js

@@ -45,8 +45,215 @@ async function invokeServerAction(opts) {
   }
   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 };
+}
+
+// src/invoke-parallel-routes.ts
+var PARALLEL_INTERCEPTION_SYMBOL = /* @__PURE__ */ Symbol.for("kiwa.next.parallel.interception");
+async function renderSlot(input) {
+  let tree = null;
+  let usedDefault = false;
+  let error;
+  const interception = input.intercepting ? {
+    [PARALLEL_INTERCEPTION_SYMBOL]: true,
+    slot: input.slot,
+    variant: input.intercepting.variant,
+    url: input.intercepting.url,
+    distance: input.intercepting.distance ?? "sibling"
+  } : null;
+  const useDefault = input.component === null || interception?.variant === "default";
+  try {
+    if (useDefault) {
+      if (typeof input.defaultFallback !== "function") {
+        throw new Error(`slot ${input.slot}: no default.tsx fallback supplied`);
+      }
+      tree = await input.defaultFallback();
+      usedDefault = true;
+    } else if (input.component !== null) {
+      tree = await input.component(input.props ?? {});
+    }
+  } catch (caught) {
+    error = caught;
+  }
+  return { slot: input.slot, tree, usedDefault, interception, error };
+}
+async function invokeParallelRoutes(opts) {
+  let childrenTree = null;
+  let childrenError;
+  let layoutError;
+  try {
+    childrenTree = await opts.children(opts.childrenProps ?? {});
+  } catch (caught) {
+    childrenError = caught;
+  }
+  const slotResults = await Promise.all(opts.slots.map((input) => renderSlot(input)));
+  const slotMap = {};
+  for (const result of slotResults) {
+    slotMap[result.slot] = result.tree;
+  }
+  let tree = null;
+  try {
+    const props = {
+      ...opts.layoutProps ?? {},
+      children: childrenTree,
+      slots: slotMap
+    };
+    tree = await opts.layout(props);
+  } catch (caught) {
+    layoutError = caught;
+  }
+  return { tree, slotResults, childrenError, layoutError };
+}
 export {
+  FORBIDDEN_SYMBOL,
+  MIDDLEWARE_ACTION_SYMBOL,
+  NOT_FOUND_SYMBOL,
+  PARALLEL_INTERCEPTION_SYMBOL,
   REDIRECT_SYMBOL,
-  invokeServerAction
+  RSC_REDIRECT_SYMBOL,
+  findAll,
+  invokeMiddleware,
+  invokeParallelRoutes,
+  invokeServerAction,
+  middlewareActions,
+  renderServerComponent,
+  textContent
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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":[]}
+{"version":3,"sources":["../src/invoke-server-action.ts","../src/invoke-middleware.ts","../src/render-server-component.ts","../src/invoke-parallel-routes.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","// Next.js App Router Parallel Routes test helper for kiwa (Issue #523).\n//\n// Parallel Routes let an App Router layout render multiple async components in\n// named slots: `layout({ children, @modal, @sidebar })`. Each slot may also\n// provide a `default.tsx` fallback when no matching segment is present, and\n// the URL pattern `(.)`/`(..)`/`(...)` enables Intercepting Routes that swap\n// the slot rendering based on soft-vs-hard navigation.\n//\n// kiwa renders the layout in isolation with synthetic slot trees. The helper\n// awaits all slot promises in parallel (mirroring the React parallel-render\n// semantics), supplies optional Intercepting-Route resolution, and captures\n// errors per slot so a single failing slot does not collapse the whole tree.\n//\n// Out of scope on purpose:\n//   - real flight payload / React renderer (use `renderServerComponent` for\n//     leaf-level RSC introspection)\n//   - matcher / `loading.tsx` / `error.tsx` evaluation\n//   - client component boundary (`'use client'`)\n\nexport const PARALLEL_INTERCEPTION_SYMBOL = Symbol.for('kiwa.next.parallel.interception');\n\nexport interface InterceptionMatch<TSlot extends string> {\n  readonly [PARALLEL_INTERCEPTION_SYMBOL]: true;\n  readonly slot: TSlot;\n  readonly variant: 'intercepted' | 'default';\n  readonly url: string;\n  readonly distance: 'sibling' | 'parent' | 'root';\n}\n\nexport type SlotComponent<TProps = Record<string, unknown>, TNode = unknown> = (\n  props: TProps,\n) => Promise<TNode> | TNode;\n\nexport type DefaultFallbackComponent<TNode = unknown> = () => Promise<TNode> | TNode;\n\nexport interface ParallelLayoutChildren<TSlots extends string, TNode = unknown> {\n  readonly children: TNode;\n  readonly slots: Readonly<Record<TSlots, TNode>>;\n}\n\nexport type ParallelLayoutFunction<TSlots extends string, TLayoutProps, TNode = unknown> = (\n  props: TLayoutProps & ParallelLayoutChildren<TSlots, TNode>,\n) => Promise<TNode> | TNode;\n\nexport interface SlotInput<TSlots extends string, TNode = unknown> {\n  readonly slot: TSlots;\n  readonly component: SlotComponent<Record<string, unknown>, TNode> | null;\n  readonly props?: Record<string, unknown>;\n  readonly defaultFallback?: DefaultFallbackComponent<TNode>;\n  readonly intercepting?: {\n    readonly variant: 'intercepted' | 'default';\n    readonly url: string;\n    readonly distance?: 'sibling' | 'parent' | 'root';\n  };\n}\n\nexport interface InvokeParallelRoutesOptions<TSlots extends string, TLayoutProps, TNode = unknown> {\n  readonly layout: ParallelLayoutFunction<TSlots, TLayoutProps, TNode>;\n  readonly children: SlotComponent<Record<string, unknown>, TNode>;\n  readonly childrenProps?: Record<string, unknown>;\n  readonly slots: ReadonlyArray<SlotInput<TSlots, TNode>>;\n  readonly layoutProps?: TLayoutProps;\n}\n\nexport interface SlotRenderResult<TSlots extends string, TNode = unknown> {\n  readonly slot: TSlots;\n  readonly tree: TNode | null;\n  readonly usedDefault: boolean;\n  readonly interception: InterceptionMatch<TSlots> | null;\n  readonly error: unknown;\n}\n\nexport interface InvokeParallelRoutesResult<TSlots extends string, TNode = unknown> {\n  readonly tree: TNode | null;\n  readonly slotResults: ReadonlyArray<SlotRenderResult<TSlots, TNode>>;\n  readonly childrenError: unknown;\n  readonly layoutError: unknown;\n}\n\nasync function renderSlot<TSlots extends string, TNode>(\n  input: SlotInput<TSlots, TNode>,\n): Promise<SlotRenderResult<TSlots, TNode>> {\n  let tree: TNode | null = null;\n  let usedDefault = false;\n  let error: unknown;\n  const interception: InterceptionMatch<TSlots> | null = input.intercepting\n    ? {\n        [PARALLEL_INTERCEPTION_SYMBOL]: true,\n        slot: input.slot,\n        variant: input.intercepting.variant,\n        url: input.intercepting.url,\n        distance: input.intercepting.distance ?? 'sibling',\n      }\n    : null;\n  const useDefault =\n    input.component === null ||\n    interception?.variant === 'default';\n  try {\n    if (useDefault) {\n      if (typeof input.defaultFallback !== 'function') {\n        throw new Error(`slot ${input.slot}: no default.tsx fallback supplied`);\n      }\n      tree = await input.defaultFallback();\n      usedDefault = true;\n    } else if (input.component !== null) {\n      tree = await input.component(input.props ?? {});\n    }\n  } catch (caught) {\n    error = caught;\n  }\n  return { slot: input.slot, tree, usedDefault, interception, error };\n}\n\n/**\n * Invoke an App Router parallel-routes layout in isolation. All slot\n * components are rendered in parallel (Promise.all) so a slow slot cannot\n * block fast siblings; per-slot errors are captured into `slotResults`\n * without aborting the layout render.\n */\nexport async function invokeParallelRoutes<\n  TSlots extends string,\n  TLayoutProps = Record<string, unknown>,\n  TNode = unknown,\n>(\n  opts: InvokeParallelRoutesOptions<TSlots, TLayoutProps, TNode>,\n): Promise<InvokeParallelRoutesResult<TSlots, TNode>> {\n  let childrenTree: TNode | null = null;\n  let childrenError: unknown;\n  let layoutError: unknown;\n  try {\n    childrenTree = await opts.children(opts.childrenProps ?? {});\n  } catch (caught) {\n    childrenError = caught;\n  }\n  const slotResults = await Promise.all(opts.slots.map((input) => renderSlot(input)));\n  const slotMap: Record<string, TNode | null> = {};\n  for (const result of slotResults) {\n    slotMap[result.slot] = result.tree;\n  }\n  let tree: TNode | null = null;\n  try {\n    const props = {\n      ...((opts.layoutProps ?? {}) as TLayoutProps),\n      children: childrenTree as TNode,\n      slots: slotMap as Readonly<Record<TSlots, TNode>>,\n    } as TLayoutProps & ParallelLayoutChildren<TSlots, TNode>;\n    tree = await opts.layout(props);\n  } catch (caught) {\n    layoutError = caught;\n  }\n  return { tree, slotResults, childrenError, layoutError };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "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",
+  "version": "1.0.5",
+  "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"
   ],
@@ -50,7 +52,7 @@
   ],
   "publishConfig": {
     "access": "public",
-    "provenance": true
+    "provenance": false
   },
   "engines": {
     "node": ">=20"
@@ -73,7 +75,7 @@
   "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: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.exclude='.vitest-dist/tests/**' --coverage.exclude='.vitest-dist/src/index.js'",
     "test:mutation": "stryker run",
     "typecheck": "tsc --noEmit"
   }