@cosmicdrift/kumiko-testing 0.355.0 → 0.357.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-testing",
-  "version": "0.355.0",
+  "version": "0.357.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,9 +79,9 @@
     "kumiko-testing": "./bin/kumiko-testing.ts"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-bundled-features": "0.355.0",
-    "@cosmicdrift/kumiko-dev-server": "0.355.0",
-    "@cosmicdrift/kumiko-framework": "0.355.0",
+    "@cosmicdrift/kumiko-bundled-features": "0.357.0",
+    "@cosmicdrift/kumiko-dev-server": "0.357.0",
+    "@cosmicdrift/kumiko-framework": "0.357.0",
     "zod": "^4.4.3"
   },
   "peerDependencies": {

package/src/changes.json

@@ -1,4 +1,10 @@
 [
+  {
+    "version": "0.357.0",
+    "type": "improvement",
+    "title": "defineAppE2eConfig accepts permissions, launchOptions, a custom server command and Bun preloads",
+    "detail": "Apps that need browser permissions (camera, microphone), Chromium launch flags such as fake media devices, or a preloaded module for the e2e server no longer have to hand-roll their Playwright config. permissions and launchOptions land in the shared use block. preload (one path or a list) is prefixed to serverEntry as bun run --preload flags; serverCommand replaces the whole server start command and cannot be combined with serverEntry or preload."
+  },
   {
     "version": "0.354.0",
     "type": "improvement",

package/src/e2e/define-app-e2e-config.ts

@@ -7,6 +7,7 @@ import { isRealProviderRun } from "@cosmicdrift/kumiko-framework/testing/real-pr
 import {
   defineConfig,
   devices,
+  type LaunchOptions,
   type PlaywrightTestConfig,
   type PlaywrightTestOptions,
   type PlaywrightWorkerOptions,
@@ -83,15 +84,47 @@ export type E2eProject = Omit<Project, (typeof TEMPLATE_OWNED_PROJECT_KEYS)[numb
   readonly use?: Omit<ProjectUse, (typeof TEMPLATE_OWNED_USE_KEYS)[number]>;
 };
 
+type ServerStart =
+  | {
+      readonly serverEntry?: string;
+      readonly preload?: string | readonly string[];
+      readonly serverCommand?: never;
+    }
+  | {
+      readonly serverCommand: string;
+      readonly serverEntry?: never;
+      readonly preload?: never;
+    };
+
 export type AppE2eConfigInput = {
   readonly port: number;
   readonly env?: Readonly<Record<string, string>>;
   readonly locale?: string;
   readonly projects?: readonly E2eProject[];
-  readonly serverEntry?: string;
   readonly testDir?: string;
   readonly testMatch?: string | RegExp | readonly (string | RegExp)[];
-};
+  readonly permissions?: readonly string[];
+  readonly launchOptions?: LaunchOptions;
+} & ServerStart;
+
+function serverStartCommand(input: {
+  readonly serverCommand?: string;
+  readonly serverEntry?: string;
+  readonly preload?: string | readonly string[];
+}): string {
+  const { serverCommand, serverEntry = "e2e/server.ts", preload } = input;
+  if (serverCommand !== undefined) {
+    if (input.serverEntry !== undefined || preload !== undefined) {
+      throw new Error(
+        "defineAppE2eConfig: serverCommand replaces serverEntry and preload; set only one",
+      );
+    }
+    return serverCommand;
+  }
+  const preloads = preload === undefined ? [] : typeof preload === "string" ? [preload] : preload;
+  const preloadFlags = preloads.map((path) => `--preload ${path} `).join("");
+  return `bun run ${preloadFlags}${serverEntry}`;
+}
 
 function mutableTestMatch(
   match: NonNullable<AppE2eConfigInput["testMatch"]>,
@@ -154,10 +187,12 @@ export function defineAppE2eConfig(input: AppE2eConfigInput): PlaywrightTestConf
     env = {},
     locale = "en",
     projects = [],
-    serverEntry = "e2e/server.ts",
     testDir = "./e2e",
     testMatch,
+    permissions,
+    launchOptions,
   } = input;
+  const serverCommand = serverStartCommand(input);
   assertNoReservedEnv(env);
   for (const project of projects) assertTemplateOwnedKeysUnset(project);
   // A dedicated screenshots config (testDir: "./e2e/screenshots") has its
@@ -190,6 +225,8 @@ export function defineAppE2eConfig(input: AppE2eConfigInput): PlaywrightTestConf
       screenshot: "only-on-failure",
       actionTimeout: E2E_TIMEOUT_MS.action,
       navigationTimeout: E2E_TIMEOUT_MS.navigation,
+      ...(permissions !== undefined && { permissions: [...permissions] }),
+      ...(launchOptions !== undefined && { launchOptions }),
     },
     projects: [
       {
@@ -203,7 +240,7 @@ export function defineAppE2eConfig(input: AppE2eConfigInput): PlaywrightTestConf
       ...projects,
     ],
     webServer: {
-      command: `bun run ${serverEntry}`,
+      command: serverCommand,
       url: baseURL,
       env: {
         ...infraEnvDefaults(),