@elench/testkit 0.1.146 → 0.1.147

package/README.md

@@ -203,6 +203,10 @@ export default defineConfig({
 });
 ```
 
+Managed UI suites should import Playwright APIs from `@elench/testkit/ui`.
+Testkit runs those suites with its own Playwright runtime so product-local
+Playwright installs cannot split the test registry.
+
 For scripts and app-runtime code, `@elench/testkit/env` provides shared helpers
 for managed runtime detection, dotenv loading, and local-database safety:
 
@@ -563,12 +567,17 @@ export default defineConfig({
 
 const suite = defineHttpSuite({ profile: "defaultAuth" }, ({ actor, actors, req }) => {
   req.get("/api/auth/session");
+  req("GET", "/api/auth/session");
   actor?.req.get("/api/auth/session");
   req.as("outsider").get("/api/auth/session");
   actors.get("reviewer").rawReq.get("/api/auth/session");
 });
 ```
 
+Generated `auth.fixture(...)` identities are isolated per managed Testkit file run,
+so parallel suites do not reuse the same login credentials unless an actor explicitly
+sets `email`.
+
 DAL suites:
 
 ```ts
@@ -596,6 +605,9 @@ const suite = defineDalSuite({ fixtures }, ({ db, fixtureScope, fixtures }) => {
 export default suite;
 ```
 
+DAL files for the same service database are serialized by default to avoid
+exhausting Postgres connection limits during highly parallel runs.
+
 `defineDalFixtures(...)` is the package-owned DAL seeding model. It gives every
 suite a deterministic `fixtureScope` with:
 

package/lib/config-api/auth-fixtures.mjs

@@ -243,8 +243,9 @@ function buildSessionBundle({ actorNames, contract, env, primaryActor, topology
 }
 
 function resolveActorSession({ actorDefinition, actorIndex, contract, env }) {
+  const resolvedActorDefinition = materializeActorDefinition(actorDefinition, env);
   const context = {
-    actor: actorDefinition.actorName,
+    actor: resolvedActorDefinition.actorName,
     actorIndex,
     env,
   };
@@ -253,13 +254,13 @@ function resolveActorSession({ actorDefinition, actorIndex, contract, env }) {
     try {
       runProfileRequest({
         requestConfig: {
-          body: () => buildSignupBody(actorDefinition),
+          body: () => buildSignupBody(resolvedActorDefinition),
           expect: contract.signup.expect,
           method: "POST",
           path: contract.signup.path,
         },
         context: { ...context, phase: "signup" },
-        label: `auth.fixture signup for actor "${actorDefinition.actorName}"`,
+        label: `auth.fixture signup for actor "${resolvedActorDefinition.actorName}"`,
       });
     } catch {
       // Provisioning is best-effort. Some apps report duplicate-account races as 500s
@@ -269,28 +270,57 @@ function resolveActorSession({ actorDefinition, actorIndex, contract, env }) {
 
   const response = runProfileRequest({
     requestConfig: {
-      body: () => buildLoginBody(actorDefinition),
+      body: () => buildLoginBody(resolvedActorDefinition),
       expect: contract.login.expect,
       method: "POST",
       path: contract.login.path,
     },
     context: { ...context, phase: "login" },
-    label: `auth.fixture login for actor "${actorDefinition.actorName}"`,
+    label: `auth.fixture login for actor "${resolvedActorDefinition.actorName}"`,
   });
   const session = extractSessionData(response, contract.session);
 
   return {
     actorIndex,
-    actorName: actorDefinition.actorName,
-    email: actorDefinition.email,
-    name: actorDefinition.name,
-    organizationKey: actorDefinition.organizationKey,
-    organizationName: actorDefinition.organizationName,
+    actorName: resolvedActorDefinition.actorName,
+    email: resolvedActorDefinition.email,
+    name: resolvedActorDefinition.name,
+    organizationKey: resolvedActorDefinition.organizationKey,
+    organizationName: resolvedActorDefinition.organizationName,
     session,
     ...session,
   };
 }
 
+function materializeActorDefinition(actorDefinition, env = {}) {
+  if (!actorDefinition.emailGenerated) return actorDefinition;
+  const suffix = buildRuntimeEmailSuffix(env.rawEnv || {});
+  if (!suffix) return actorDefinition;
+
+  return {
+    ...actorDefinition,
+    email: appendEmailSuffix(actorDefinition.email, suffix),
+  };
+}
+
+function buildRuntimeEmailSuffix(rawEnv = {}) {
+  if (rawEnv.TESTKIT_ACTIVE !== "1") return "";
+  return [
+    rawEnv.TESTKIT_LEASE_ID,
+    rawEnv.TESTKIT_TEST_FILE,
+    rawEnv.TESTKIT_SCENARIO_SEED,
+  ]
+    .map(slugifyToken)
+    .filter(Boolean)
+    .join(".");
+}
+
+function appendEmailSuffix(email, suffix) {
+  const [local, domain] = String(email).split("@");
+  if (!local || !domain || !suffix) return email;
+  return `${local}.${suffix}@${domain}`;
+}
+
 function buildSignupBody(actorDefinition) {
   return {
     email: actorDefinition.email,
@@ -421,6 +451,7 @@ function finalizeActorEntries({ namespace, actorEntries, orgs, defaultOrgKey, de
       email:
         normalizeOptionalString(config.email) ||
         buildGeneratedEmail(namespace, actorName),
+      emailGenerated: !normalizeOptionalString(config.email),
       loginBody: normalizePlainObject(config.loginBody, `${label} actor "${actorName}" loginBody`),
       name:
         normalizeOptionalString(config.name) ||

package/lib/runner/default-runtime-runner.mjs

@@ -97,6 +97,8 @@ export async function runDefaultRuntimeTask(
         lease,
         {
           ...buildFileTimeoutEnv(fileTimeoutSeconds, startedAt),
+          TESTKIT_TEST_FILE: task.file,
+          TESTKIT_TEST_ID: String(task.id),
           ...(task.scenarioSeed ? { TESTKIT_SCENARIO_SEED: task.scenarioSeed } : {}),
         },
         process.env

package/lib/runner/playwright-runner.mjs

@@ -1,5 +1,6 @@
 import path from "path";
 import fs from "fs";
+import { createRequire } from "module";
 import { parsePlaywrightJsonResults } from "../reporters/playwright.mjs";
 import { resolveServiceCwd } from "../config/paths.mjs";
 import { buildFileTimeoutEnv, formatFileTimeoutBudgetError } from "../shared/file-timeout.mjs";
@@ -10,6 +11,8 @@ import { normalizePathSeparators } from "./state.mjs";
 import { buildPlaywrightEnv } from "./template.mjs";
 import { settleManagedSubprocess, startManagedSubprocess } from "./subprocess.mjs";
 
+const require = createRequire(import.meta.url);
+
 export async function runPlaywrightTask(targetConfig, task, lifecycle, lease, reporter = null) {
   const local = targetConfig.testkit.local;
   if (!local?.baseUrl) {
@@ -33,9 +36,10 @@ export async function runPlaywrightTask(targetConfig, task, lifecycle, lease, re
     { globalTimeoutMs: fileTimeoutSeconds * 1000 }
   );
   const jsonReportPath = buildPlaywrightJsonReportPath(lease, task);
+  const playwrightCliPath = resolvePlaywrightCliPath();
   const subprocess = startManagedSubprocess(
-    "npx",
-    ["playwright", "test", "--config", playwrightConfigPath, "--reporter=json"],
+    process.execPath,
+    [playwrightCliPath, "test", "--config", playwrightConfigPath, "--reporter=json"],
     {
       cwd,
       env: {
@@ -113,6 +117,10 @@ export async function runPlaywrightTask(targetConfig, task, lifecycle, lease, re
   };
 }
 
+export function resolvePlaywrightCliPath() {
+  return require.resolve("@playwright/test/cli");
+}
+
 export function buildPlaywrightJsonReportPath(lease, task) {
   if (!lease?.leaseDir) {
     throw new Error(`Playwright task ${task?.file || ""} requires a lease-scoped directory`);

package/lib/runner/scheduler/index.mjs

@@ -105,6 +105,9 @@ export function compareScheduledTasks(a, b) {
 
 function resolveTaskLocks(config, suite, file) {
   const locks = new Set();
+  if (suite.type === "dal") {
+    locks.add(`database:${config.name}`);
+  }
   const matchedSuiteRules = config.testkit.requirements?.suites || [];
   for (const rule of matchedSuiteRules) {
     if (matchesSuiteSelectors(suite.displayType, suite.name, [rule.selector])) {

package/lib/runtime/index.d.ts

@@ -61,6 +61,7 @@ export interface WaitForOptions {
 export interface RuntimeEnv {
   BASE: string;
   MACHINE_ID?: string;
+  rawEnv?: Record<string, string | undefined>;
   routeParams: RuntimeHeaders;
 }
 
@@ -290,6 +291,13 @@ export interface ActorRequestClient {
 }
 
 export interface HttpClient<TSetup = unknown> {
+  (
+    method: RuntimeMethod,
+    path: string,
+    setupData?: TSetup | null,
+    body?: unknown,
+    extraHeaders?: RuntimeHeaders
+  ): RuntimeResponse;
   as(actorName: string): ActorRequestClient;
   headers(extraHeaders?: RuntimeHeaders): RuntimeHeaders;
   multipart: MultipartRequestClient;

package/lib/runtime-src/k6/http.js

@@ -233,7 +233,12 @@ export function createHttpClient(config) {
   const defaultClient = createActorClient(defaultActor);
   const rawClient = createRawInvoker(null);
 
-  return {
+  function client(method, path, setupDataOrBody = null, body, extraHeaders = {}) {
+    const requestBody = arguments.length >= 4 ? body : setupDataOrBody;
+    return defaultClient.request(method, path, requestBody, extraHeaders);
+  }
+
+  Object.assign(client, {
     rawHttp: http,
     headers(extraHeaders = {}) {
       return resolvedHeadersFor(defaultActor, extraHeaders);
@@ -299,7 +304,9 @@ export function createHttpClient(config) {
         return rawClient.multipart.patch(path, payload, extraHeaders);
       },
     },
-  };
+  });
+
+  return client;
 }
 
 export function makeReq(baseUrl, sessionBundle = null, routeHeaders = {}, getHeaders = null, defaultActor = null) {

package/node_modules/@elench/next-analysis/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/next-analysis",
-  "version": "0.1.146",
+  "version": "0.1.147",
   "description": "SWC-backed Next.js source analysis primitives for Erench tools",
   "type": "module",
   "exports": {

package/node_modules/@elench/testkit-bridge/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/testkit-bridge",
-  "version": "0.1.146",
+  "version": "0.1.147",
   "description": "Browser bridge helpers for testkit",
   "type": "module",
   "main": "./dist/index.js",

package/node_modules/@elench/testkit-protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/testkit-protocol",
-  "version": "0.1.146",
+  "version": "0.1.147",
   "description": "Shared browser protocol for testkit bridge and extension consumers",
   "type": "module",
   "main": "./dist/index.js",

package/node_modules/@elench/ts-analysis/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/ts-analysis",
-  "version": "0.1.146",
+  "version": "0.1.147",
   "description": "TypeScript compiler-backed source analysis primitives for Erench tools",
   "type": "module",
   "exports": {