@cosmicdrift/kumiko-testing 0.365.0 → 0.366.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-testing",
-  "version": "0.365.0",
+  "version": "0.366.0",
   "description": "Test template for Kumiko apps: per-flow seedTenant, app test stack, canonical test preloads, bunfig generator and integration runner.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -79,10 +79,10 @@
     "kumiko-testing": "./bin/kumiko-testing.ts"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-bundled-features": "0.365.0",
-    "@cosmicdrift/kumiko-dev-server": "0.365.0",
-    "@cosmicdrift/kumiko-framework": "0.365.0",
-    "@cosmicdrift/kumiko-types": "0.365.0",
+    "@cosmicdrift/kumiko-bundled-features": "0.366.0",
+    "@cosmicdrift/kumiko-dev-server": "0.366.0",
+    "@cosmicdrift/kumiko-framework": "0.366.0",
+    "@cosmicdrift/kumiko-types": "0.366.0",
     "zod": "^4.4.3"
   },
   "peerDependencies": {

package/src/e2e/boundary-guard.ts

@@ -0,0 +1,38 @@
+import {
+  ERROR_BOUNDARY_LOG_MARKER,
+  ROOT_ERROR_FALLBACK_TEST_ID,
+  SCREEN_ERROR_FALLBACK_TEST_ID,
+} from "@cosmicdrift/kumiko-types/error-boundary";
+import { test as base, expect } from "@playwright/test";
+
+// An error boundary keeps the page alive, which also hides the failure from `pageerror`.
+// Every spec using `test` from this package fails when a boundary caught something.
+export const boundaryGuardedTest = base.extend<{
+  failOnErrorBoundary: undefined;
+  expectErrorBoundary: boolean;
+}>({
+  expectErrorBoundary: [false, { option: true }],
+  failOnErrorBoundary: [
+    async ({ page, expectErrorBoundary }, use) => {
+      const boundaryLogs: string[] = [];
+      page.on("console", (msg) => {
+        if (msg.type() === "error" && msg.text().includes(ERROR_BOUNDARY_LOG_MARKER)) {
+          boundaryLogs.push(msg.text());
+        }
+      });
+      await use(undefined);
+      // skip: the spec provokes a boundary on purpose and asserts the fallback itself
+      if (expectErrorBoundary) return;
+      const visibleFallbacks = await page
+        .locator(
+          `[data-testid="${SCREEN_ERROR_FALLBACK_TEST_ID}"], [data-testid="${ROOT_ERROR_FALLBACK_TEST_ID}"]`,
+        )
+        .count();
+      expect(
+        { boundaryLogs, visibleFallbacks },
+        "an error boundary caught a render/effect error",
+      ).toEqual({ boundaryLogs: [], visibleFallbacks: 0 });
+    },
+    { auto: true },
+  ],
+});

package/src/e2e/index.ts

@@ -21,6 +21,7 @@ export {
   syntheticClientIpFor,
   totpCode,
 } from "./auth-kit";
+export { boundaryGuardedTest } from "./boundary-guard";
 export {
   CSRF_COOKIE_NAME,
   CSRF_HEADER_NAME,

package/src/e2e/seeded-tenant-fixture.ts

@@ -1,14 +1,13 @@
 import { ROLES } from "@cosmicdrift/kumiko-framework/auth";
-import {
-  type APIRequestContext,
-  type BrowserContext,
-  test as base,
-  type Page,
-  type Request as PlaywrightRequest,
-  type PlaywrightTestArgs,
-  type PlaywrightTestOptions,
-  type PlaywrightWorkerArgs,
-  type TestInfo,
+import type {
+  APIRequestContext,
+  BrowserContext,
+  Page,
+  Request as PlaywrightRequest,
+  PlaywrightTestArgs,
+  PlaywrightTestOptions,
+  PlaywrightWorkerArgs,
+  TestInfo,
 } from "@playwright/test";
 import type * as z from "zod";
 import {
@@ -29,6 +28,7 @@ import {
   loginViaApi,
   syntheticClientIpFor,
 } from "./auth-kit";
+import { boundaryGuardedTest as base } from "./boundary-guard";
 import { SEED_ROUTES, SEED_TOKEN_ENV } from "./constants";
 import { seedRouteHeaders } from "./mail-capture";
 import {