@elench/testkit 0.1.117 → 0.1.119

package/lib/ui/sandbox.mjs

@@ -0,0 +1,115 @@
+import { expect, request, test as base } from "@playwright/test";
+
+export function createUiSandbox(options = {}) {
+  const sandboxId = createSandboxId(options);
+  return {
+    expect,
+    test: base.extend({
+      testkitSandbox: async ({ page }, use) => {
+        await use({
+          id: sandboxId,
+          backendBaseUrl: resolveBackendBaseUrl(options),
+          frontendBaseUrl: resolveFrontendBaseUrl(options),
+          page,
+        });
+      },
+    }),
+  };
+}
+
+export function createSandboxId(options = {}) {
+  const prefix =
+    String(options.prefix || "ui").replace(/[^A-Za-z0-9_-]+/g, "-").replace(/^-+|-+$/g, "") || "ui";
+  const worker = process.env.TEST_WORKER_INDEX || process.env.TESTKIT_WORKER_INDEX || "0";
+  const run = process.env.TESTKIT_LEASE_ID || process.env.TESTKIT_RUNTIME_ID || process.pid;
+  return `${prefix}-${run}-${worker}`;
+}
+
+export function resolveFrontendBaseUrl(options = {}) {
+  return resolveBaseUrl(
+    options.frontendBaseUrl ||
+      options.baseUrl ||
+      process.env.TESTKIT_FRONTEND_BASE_URL ||
+      process.env.BASE_URL
+  );
+}
+
+export function resolveBackendBaseUrl(options = {}) {
+  return resolveBaseUrl(options.backendBaseUrl || process.env.TESTKIT_BACKEND_BASE_URL || process.env.API_BASE_URL);
+}
+
+export function assertSafeUiTarget(url, options = {}) {
+  const parsed = parseUrl(url);
+  if (!parsed) {
+    throw new Error(`Invalid UI target URL: ${url}`);
+  }
+  if (options.allowRemote === true) return parsed.toString().replace(/\/$/, "");
+  if (!isLocalHost(parsed.hostname)) {
+    throw new Error(`UI target must be local unless allowRemote is true: ${url}`);
+  }
+  return parsed.toString().replace(/\/$/, "");
+}
+
+export function assertSafeUiTargets(urls = [], options = {}) {
+  return urls.map((url) => assertSafeUiTarget(url, options));
+}
+
+export async function createAuthedApiClient(playwrightRequest = request, options = {}) {
+  const baseURL = assertSafeUiTarget(resolveBackendBaseUrl(options), options);
+  return playwrightRequest.newContext({
+    baseURL,
+    extraHTTPHeaders: options.headers || {},
+  });
+}
+
+export async function waitForUiSettled(page, options = {}) {
+  const timeout = options.timeout ?? 5_000;
+  await page.waitForLoadState("domcontentloaded", { timeout });
+  await waitForAnimationFrames(page, options.frames ?? 2);
+  await page.waitForLoadState("networkidle", { timeout }).catch(() => {});
+}
+
+export async function waitForAnimationFrames(page, frames = 2) {
+  const count = Math.max(1, Number(frames) || 1);
+  await page.evaluate(
+    (frameCount) =>
+      new Promise((resolve) => {
+        let remaining = frameCount;
+        const tick = () => {
+          remaining -= 1;
+          if (remaining <= 0) {
+            resolve();
+            return;
+          }
+          requestAnimationFrame(tick);
+        };
+        requestAnimationFrame(tick);
+      }),
+    count
+  );
+}
+
+function resolveBaseUrl(value) {
+  const normalized = String(value || "").trim();
+  if (!normalized) {
+    throw new Error("A UI base URL is required");
+  }
+  return assertSafeUiTarget(normalized);
+}
+
+function parseUrl(value) {
+  try {
+    return new URL(value);
+  } catch {
+    return null;
+  }
+}
+
+function isLocalHost(hostname) {
+  return (
+    hostname === "localhost" ||
+    hostname === "127.0.0.1" ||
+    hostname === "::1" ||
+    hostname.endsWith(".localhost")
+  );
+}

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

@@ -1,6 +1,6 @@
 {
   "name": "@elench/next-analysis",
-  "version": "0.1.117",
+  "version": "0.1.119",
   "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.117",
+  "version": "0.1.119",
   "description": "Browser bridge helpers for testkit",
   "type": "module",
   "main": "./dist/index.js",
@@ -22,7 +22,7 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@elench/testkit-protocol": "0.1.117"
+    "@elench/testkit-protocol": "0.1.119"
   },
   "private": false
 }

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

@@ -1,6 +1,6 @@
 {
   "name": "@elench/testkit-protocol",
-  "version": "0.1.117",
+  "version": "0.1.119",
   "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.117",
+  "version": "0.1.119",
   "description": "TypeScript compiler-backed source analysis primitives for Erench tools",
   "type": "module",
   "exports": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/testkit",
-  "version": "0.1.117",
+  "version": "0.1.119",
   "description": "Assistant-first CLI for running, inspecting, and debugging local testkit suites",
   "type": "module",
   "workspaces": [
@@ -65,6 +65,7 @@
     "test:database-version:compat": "node scripts/test-database-version-compat.mjs",
     "test:engine-version:compat": "node scripts/test-engine-version-compat.mjs",
     "test:live": "node scripts/live-sandbox/harness.mjs",
+    "test:live:github": "node scripts/test-live-github-fixture.mjs",
     "test:live:neon": "node scripts/test-database-version-compat.mjs --neon-only",
     "test:unit": "npm run build:assistant && npm run build:packages && npm run test:audit && vitest run --config vitest.unit.config.mjs",
     "test:integration": "npm run build:assistant && npm run build:packages && vitest run test/integration",
@@ -94,10 +95,10 @@
   },
   "dependencies": {
     "@babel/code-frame": "^7.29.0",
-    "@elench/next-analysis": "0.1.117",
-    "@elench/testkit-bridge": "0.1.117",
-    "@elench/testkit-protocol": "0.1.117",
-    "@elench/ts-analysis": "0.1.117",
+    "@elench/next-analysis": "0.1.119",
+    "@elench/testkit-bridge": "0.1.119",
+    "@elench/testkit-protocol": "0.1.119",
+    "@elench/ts-analysis": "0.1.119",
     "@oclif/core": "^4.10.6",
     "@playwright/test": "^1.52.0",
     "esbuild": "^0.25.11",

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

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