@elench/testkit 0.1.65 → 0.1.66

package/node_modules/typescript/package.json

@@ -0,0 +1,120 @@
+{
+    "name": "typescript",
+    "author": "Microsoft Corp.",
+    "homepage": "https://www.typescriptlang.org/",
+    "version": "5.9.3",
+    "license": "Apache-2.0",
+    "description": "TypeScript is a language for application scale JavaScript development",
+    "keywords": [
+        "TypeScript",
+        "Microsoft",
+        "compiler",
+        "language",
+        "javascript"
+    ],
+    "bugs": {
+        "url": "https://github.com/microsoft/TypeScript/issues"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/microsoft/TypeScript.git"
+    },
+    "main": "./lib/typescript.js",
+    "typings": "./lib/typescript.d.ts",
+    "bin": {
+        "tsc": "./bin/tsc",
+        "tsserver": "./bin/tsserver"
+    },
+    "engines": {
+        "node": ">=14.17"
+    },
+    "files": [
+        "bin",
+        "lib",
+        "!lib/enu",
+        "LICENSE.txt",
+        "README.md",
+        "SECURITY.md",
+        "ThirdPartyNoticeText.txt",
+        "!**/.gitattributes"
+    ],
+    "devDependencies": {
+        "@dprint/formatter": "^0.4.1",
+        "@dprint/typescript": "0.93.4",
+        "@esfx/canceltoken": "^1.0.0",
+        "@eslint/js": "^9.20.0",
+        "@octokit/rest": "^21.1.1",
+        "@types/chai": "^4.3.20",
+        "@types/diff": "^7.0.1",
+        "@types/minimist": "^1.2.5",
+        "@types/mocha": "^10.0.10",
+        "@types/ms": "^0.7.34",
+        "@types/node": "latest",
+        "@types/source-map-support": "^0.5.10",
+        "@types/which": "^3.0.4",
+        "@typescript-eslint/rule-tester": "^8.24.1",
+        "@typescript-eslint/type-utils": "^8.24.1",
+        "@typescript-eslint/utils": "^8.24.1",
+        "azure-devops-node-api": "^14.1.0",
+        "c8": "^10.1.3",
+        "chai": "^4.5.0",
+        "chokidar": "^4.0.3",
+        "diff": "^7.0.0",
+        "dprint": "^0.49.0",
+        "esbuild": "^0.25.0",
+        "eslint": "^9.20.1",
+        "eslint-formatter-autolinkable-stylish": "^1.4.0",
+        "eslint-plugin-regexp": "^2.7.0",
+        "fast-xml-parser": "^4.5.2",
+        "glob": "^10.4.5",
+        "globals": "^15.15.0",
+        "hereby": "^1.10.0",
+        "jsonc-parser": "^3.3.1",
+        "knip": "^5.44.4",
+        "minimist": "^1.2.8",
+        "mocha": "^10.8.2",
+        "mocha-fivemat-progress-reporter": "^0.1.0",
+        "monocart-coverage-reports": "^2.12.1",
+        "ms": "^2.1.3",
+        "picocolors": "^1.1.1",
+        "playwright": "^1.50.1",
+        "source-map-support": "^0.5.21",
+        "tslib": "^2.8.1",
+        "typescript": "^5.7.3",
+        "typescript-eslint": "^8.24.1",
+        "which": "^3.0.1"
+    },
+    "overrides": {
+        "typescript@*": "$typescript"
+    },
+    "scripts": {
+        "test": "hereby runtests-parallel --light=false",
+        "test:eslint-rules": "hereby run-eslint-rules-tests",
+        "build": "npm run build:compiler && npm run build:tests",
+        "build:compiler": "hereby local",
+        "build:tests": "hereby tests",
+        "build:tests:notypecheck": "hereby tests --no-typecheck",
+        "clean": "hereby clean",
+        "gulp": "hereby",
+        "lint": "hereby lint",
+        "knip": "hereby knip",
+        "format": "dprint fmt",
+        "setup-hooks": "node scripts/link-hooks.mjs"
+    },
+    "browser": {
+        "fs": false,
+        "os": false,
+        "path": false,
+        "crypto": false,
+        "buffer": false,
+        "source-map-support": false,
+        "inspector": false,
+        "perf_hooks": false
+    },
+    "packageManager": "npm@8.19.4",
+    "volta": {
+        "node": "20.1.0",
+        "npm": "8.19.4"
+    },
+    "gitHead": "c63de15a992d37f0d6cec03ac7631872838602cb"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/testkit",
-  "version": "0.1.65",
+  "version": "0.1.66",
   "description": "CLI for discovering and running local HTTP, DAL, and Playwright test suites",
   "type": "module",
   "workspaces": [
@@ -40,10 +40,12 @@
     "topicSeparator": " "
   },
   "scripts": {
-    "test": "vitest run",
-    "test:unit": "vitest run lib packages",
-    "test:integration": "vitest run test/integration",
-    "test:system": "vitest run test/system --passWithNoTests"
+    "build:packages": "npm --workspace packages/testkit-protocol run build && npm --workspace packages/ts-analysis run build && npm --workspace packages/next-analysis run build && npm --workspace packages/testkit-bridge run build",
+    "typecheck:packages": "npm --workspace packages/testkit-protocol run typecheck && npm --workspace packages/ts-analysis run typecheck && npm --workspace packages/next-analysis run typecheck && npm --workspace packages/testkit-bridge run typecheck && npm --workspace packages/testkit-extension run compile",
+    "test": "npm run build:packages && vitest run",
+    "test:unit": "npm run build:packages && vitest run lib packages",
+    "test:integration": "npm run build:packages && vitest run test/integration",
+    "test:system": "npm run build:packages && vitest run test/system --passWithNoTests"
   },
   "files": [
     "bin/",
@@ -57,14 +59,15 @@
     "@elench/testkit-protocol"
   ],
   "devDependencies": {
+    "@types/node": "^24.9.1",
     "@playwright/test": "^1.52.0",
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@elench/next-analysis": "0.1.65",
-    "@elench/ts-analysis": "0.1.65",
-    "@elench/testkit-bridge": "0.1.65",
-    "@elench/testkit-protocol": "0.1.65",
+    "@elench/next-analysis": "0.1.66",
+    "@elench/ts-analysis": "0.1.66",
+    "@elench/testkit-bridge": "0.1.66",
+    "@elench/testkit-protocol": "0.1.66",
     "@babel/code-frame": "^7.29.0",
     "@oclif/core": "^4.10.6",
     "esbuild": "^0.25.11",

package/lib/coverage/fs-walk.mjs

@@ -1,64 +0,0 @@
-import fs from "fs";
-import path from "path";
-import {
-  normalizeDiscoveryPath,
-  shouldExcludeDiscoveryPath,
-} from "../discovery/path-policy.mjs";
-import { normalizePath } from "./shared.mjs";
-import { resolveImportToSourceFile as resolveImportToSourceFileFromTsAnalysis } from "@elench/ts-analysis";
-
-export function findNextAppRoot(serviceRoot) {
-  const candidates = [path.join(serviceRoot, "app"), path.join(serviceRoot, "src", "app")];
-  return candidates.find((candidate) => fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) || null;
-}
-
-export function resolveServiceRoot(productDir, config) {
-  const cwd = config?.local?.cwd || ".";
-  return path.resolve(productDir, cwd);
-}
-
-export function walkFiles(rootDir, options = {}) {
-  if (!fs.existsSync(rootDir)) return [];
-  const baseDir = options.baseDir || rootDir;
-  const exclude = options.exclude || [];
-  const results = [];
-  const queue = [rootDir];
-  while (queue.length > 0) {
-    const current = queue.pop();
-    for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
-      if (entry.isSymbolicLink()) continue;
-      const absolutePath = path.join(current, entry.name);
-      if (entry.isDirectory()) {
-        const relativeDirPath = normalizeDiscoveryPath(path.relative(baseDir, absolutePath));
-        if (shouldExcludeDiscoveryPath(relativeDirPath, exclude)) continue;
-        queue.push(absolutePath);
-        continue;
-      }
-      if (entry.isFile()) {
-        results.push(absolutePath);
-      }
-    }
-  }
-  return results.sort((left, right) => left.localeCompare(right));
-}
-
-export function resolveImportToSourceFile(serviceRoot, fromFilePath, specifier) {
-  return resolveImportToSourceFileFromTsAnalysis(serviceRoot, fromFilePath, specifier);
-}
-
-export function resolveSourceCandidate(basePath) {
-  const direct = [basePath, `${basePath}.ts`, `${basePath}.tsx`, `${basePath}.js`, `${basePath}.mjs`];
-  for (const candidate of direct) {
-    if (fs.existsSync(candidate) && fs.statSync(candidate).isFile()) return candidate;
-  }
-  const indexed = [
-    path.join(basePath, "index.ts"),
-    path.join(basePath, "index.tsx"),
-    path.join(basePath, "index.js"),
-    path.join(basePath, "index.mjs"),
-  ];
-  for (const candidate of indexed) {
-    if (fs.existsSync(candidate) && fs.statSync(candidate).isFile()) return candidate;
-  }
-  return null;
-}

package/node_modules/@elench/next-analysis/src/api-routes.mjs

@@ -1,81 +0,0 @@
-import fs from "fs";
-import path from "path";
-import { extractBackendRefs } from "./backend-links.mjs";
-import { routeFromApiFile } from "./routes.mjs";
-import { HTTP_METHODS, isRouteHandlerFile, normalizePath, toApiRequestPath } from "./shared.mjs";
-import { parseModule } from "./swc.mjs";
-
-export function discoverApiRoutes({ rootDir, appRoot }) {
-  const apiRoot = path.join(appRoot, "api");
-  if (!fs.existsSync(apiRoot)) return [];
-  const routeFiles = walkFiles(apiRoot).filter(isRouteHandlerFile);
-  const entries = [];
-
-  for (const absolutePath of routeFiles) {
-    const filePath = normalizePath(path.relative(rootDir, absolutePath));
-    const route = routeFromApiFile(appRoot, absolutePath);
-    const requestPath = toApiRequestPath(route);
-    const content = fs.readFileSync(absolutePath, "utf8");
-    const ast = parseModule(content, filePath);
-    const backendRefs = extractBackendRefs({
-      ast,
-      rootDir,
-      filePath,
-      readSourceFile: (targetPath) => fs.existsSync(targetPath) ? fs.readFileSync(targetPath, "utf8") : null,
-    });
-    const exportedMethods = extractExportedMethods(ast);
-
-    for (const method of exportedMethods) {
-      entries.push({
-        id: `api:${method}:${requestPath}`,
-        kind: "api_route",
-        route,
-        requestPath,
-        method,
-        filePath,
-        backendRefs,
-      });
-    }
-  }
-
-  return entries.sort((left, right) => {
-    return left.requestPath.localeCompare(right.requestPath) || left.method.localeCompare(right.method);
-  });
-}
-
-function extractExportedMethods(ast) {
-  const methods = [];
-  for (const statement of ast.body || []) {
-    if (statement.type !== "ExportDeclaration") continue;
-    const declaration = statement.declaration;
-    if (declaration?.type === "FunctionDeclaration" && declaration.identifier) {
-      const name = declaration.identifier.value.toUpperCase();
-      if (HTTP_METHODS.includes(name)) methods.push(name);
-    } else if (declaration?.type === "VariableDeclaration") {
-      for (const declarator of declaration.declarations || []) {
-        if (declarator.id?.type !== "Identifier") continue;
-        const name = declarator.id.value.toUpperCase();
-        if (HTTP_METHODS.includes(name)) methods.push(name);
-      }
-    }
-  }
-  return [...new Set(methods)];
-}
-
-function walkFiles(rootDir) {
-  const results = [];
-  const queue = [rootDir];
-  while (queue.length > 0) {
-    const current = queue.pop();
-    for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
-      if (entry.isSymbolicLink()) continue;
-      const absolutePath = path.join(current, entry.name);
-      if (entry.isDirectory()) {
-        queue.push(absolutePath);
-      } else if (entry.isFile()) {
-        results.push(absolutePath);
-      }
-    }
-  }
-  return results.sort((left, right) => left.localeCompare(right));
-}

package/node_modules/@elench/next-analysis/src/api-routes.test.mjs

@@ -1,22 +0,0 @@
-import path from "path";
-import { describe, expect, it } from "vitest";
-import { createNextAnalysisProject } from "./index.mjs";
-
-const fixtureRoot = path.resolve(
-  "/home/georgedlr/workspace/elench/testkit/test/fixtures/integration/next-dynamic-routes-product"
-);
-
-describe("@elench/next-analysis api routes", () => {
-  it("discovers dynamic API routes with normalized request paths", () => {
-    const project = createNextAnalysisProject({ rootDir: fixtureRoot });
-    expect(project.discoverApiRoutes()).toEqual(
-      expect.arrayContaining([
-        expect.objectContaining({
-          method: "GET",
-          route: "/projects/[projectId]",
-          requestPath: "/api/projects/[projectId]",
-        }),
-      ])
-    );
-  });
-});

package/node_modules/@elench/next-analysis/src/app-root.mjs

@@ -1,7 +0,0 @@
-import path from "path";
-import { directoryExists } from "./shared.mjs";
-
-export function findNextAppRoot(rootDir) {
-  const candidates = [path.join(rootDir, "app"), path.join(rootDir, "src", "app")];
-  return candidates.find((candidate) => directoryExists(candidate)) || null;
-}

package/node_modules/@elench/next-analysis/src/backend-links.mjs

@@ -1,31 +0,0 @@
-import { isBackendSpecifier, modulePathKey, normalizePath } from "./shared.mjs";
-import { collectImports } from "./swc.mjs";
-
-export function extractBackendRefs({ ast, rootDir, filePath, readSourceFile }) {
-  const imports = collectImports(ast, { rootDir, filePath, readSourceFile });
-  const refs = [];
-
-  for (const [localName, imported] of imports.entries()) {
-    if (!isBackendSpecifier(imported.specifier)) continue;
-    refs.push({
-      id: `server_ref:${modulePathKey(imported.resolvedFilePath || filePath)}#${imported.importedName}`,
-      kind: "server_capability",
-      importName: localName,
-      exportName: imported.importedName,
-      modulePath: normalizePath(imported.resolvedFilePath || filePath),
-      specifier: imported.specifier,
-    });
-  }
-
-  return dedupeBackendRefs(refs);
-}
-
-function dedupeBackendRefs(entries) {
-  const seen = new Set();
-  return entries.filter((entry) => {
-    const key = `${entry.modulePath}#${entry.exportName}`;
-    if (seen.has(key)) return false;
-    seen.add(key);
-    return true;
-  });
-}

package/node_modules/@elench/next-analysis/src/index.mjs

@@ -1,21 +0,0 @@
-export { createNextAnalysisProject } from "./project.mjs";
-export { findNextAppRoot } from "./app-root.mjs";
-export { discoverPages } from "./pages.mjs";
-export { discoverApiRoutes } from "./api-routes.mjs";
-export { discoverServerActions } from "./server-actions.mjs";
-export { analyzeRouteTree } from "./route-tree.mjs";
-export {
-  normalizePath,
-  normalizeRoute,
-  normalizeRouteSegments,
-  pageLabelFromRoute,
-  toApiRequestPath,
-  HTTP_METHODS,
-} from "./shared.mjs";
-export {
-  routeFromAppFile,
-  routeFromApiFile,
-  routePatternMatches,
-  requestPathPatternFromLiteral,
-} from "./routes.mjs";
-export { parseModule, extractHttpRequests, extractPlaywrightVisitedRoutes } from "./swc.mjs";

package/node_modules/@elench/next-analysis/src/pages.mjs

@@ -1,68 +0,0 @@
-import fs from "fs";
-import path from "path";
-import { routeFromAppFile } from "./routes.mjs";
-import { compareByRoute, isPageFile, normalizePath, pageLabelFromRoute } from "./shared.mjs";
-
-export function discoverPages({ rootDir, appRoot }) {
-  const pageFiles = walkFiles(appRoot).filter(isPageFile);
-  return pageFiles
-    .map((absolutePath) => {
-      const filePath = normalizePath(path.relative(rootDir, absolutePath));
-      const route = routeFromAppFile(appRoot, absolutePath);
-      const layoutFiles = collectLayoutFiles(rootDir, appRoot, absolutePath);
-      const rootFiles = [...layoutFiles, filePath];
-      return {
-        id: `page:${route}`,
-        kind: "page",
-        route,
-        label: pageLabelFromRoute(route),
-        filePath,
-        layoutFiles,
-        rootFiles,
-      };
-    })
-    .sort(compareByRoute);
-}
-
-function collectLayoutFiles(rootDir, appRoot, pageAbsolutePath) {
-  const rootFiles = [];
-  let currentDir = path.dirname(pageAbsolutePath);
-  const absoluteAppRoot = path.resolve(appRoot);
-
-  while (currentDir.startsWith(absoluteAppRoot)) {
-    const layoutFile = resolveRouteCompanion(currentDir, "layout");
-    if (layoutFile) rootFiles.push(normalizePath(path.relative(rootDir, layoutFile)));
-    if (currentDir === absoluteAppRoot) break;
-    currentDir = path.dirname(currentDir);
-  }
-
-  return [...new Set(rootFiles.reverse())];
-}
-
-function resolveRouteCompanion(directoryPath, baseName) {
-  const candidates = [
-    path.join(directoryPath, `${baseName}.tsx`),
-    path.join(directoryPath, `${baseName}.ts`),
-    path.join(directoryPath, `${baseName}.jsx`),
-    path.join(directoryPath, `${baseName}.js`),
-  ];
-  return candidates.find((candidate) => fs.existsSync(candidate)) || null;
-}
-
-function walkFiles(rootDir) {
-  const results = [];
-  const queue = [rootDir];
-  while (queue.length > 0) {
-    const current = queue.pop();
-    for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
-      if (entry.isSymbolicLink()) continue;
-      const absolutePath = path.join(current, entry.name);
-      if (entry.isDirectory()) {
-        queue.push(absolutePath);
-      } else if (entry.isFile()) {
-        results.push(absolutePath);
-      }
-    }
-  }
-  return results.sort((left, right) => left.localeCompare(right));
-}

package/node_modules/@elench/next-analysis/src/project.mjs

@@ -1,94 +0,0 @@
-import fs from "fs";
-import path from "path";
-import nextRouting from "@next/routing";
-import { findNextAppRoot } from "./app-root.mjs";
-import { discoverApiRoutes } from "./api-routes.mjs";
-import { discoverPages } from "./pages.mjs";
-import { analyzeRouteTree } from "./route-tree.mjs";
-import { discoverServerActions } from "./server-actions.mjs";
-import { compareByPath, compareByRoute, createDiagnostic, normalizePath, readFileIfExists } from "./shared.mjs";
-
-export function createNextAnalysisProject({ rootDir, buildDir = null, nextConfigPath = null } = {}) {
-  const { resolveRoutes } = nextRouting;
-  const absoluteRoot = path.resolve(rootDir || process.cwd());
-  const diagnostics = [];
-  const moduleCache = new Map();
-  const routeTreeCache = new Map();
-  const appRoot = findNextAppRoot(absoluteRoot);
-
-  const project = {
-    rootDir: absoluteRoot,
-    buildDir: buildDir ? path.resolve(absoluteRoot, buildDir) : null,
-    nextConfigPath: nextConfigPath ? path.resolve(absoluteRoot, nextConfigPath) : null,
-    findAppRoot() {
-      return appRoot;
-    },
-    readSourceFile(relativeFilePath) {
-      const absolutePath = path.join(absoluteRoot, relativeFilePath);
-      return readFileIfExists(absolutePath);
-    },
-    getDiagnostics() {
-      return [...diagnostics];
-    },
-    loadModule(relativeFilePath) {
-      return moduleCache.get(relativeFilePath) || null;
-    },
-    setModule(relativeFilePath, moduleInfo) {
-      moduleCache.set(relativeFilePath, moduleInfo);
-    },
-    discoverPages() {
-      if (!appRoot) {
-        diagnostics.push(createDiagnostic({
-          level: "warn",
-          code: "missing-app-root",
-          message: `No Next app root found under "${absoluteRoot}".`,
-        }));
-        return [];
-      }
-      return discoverPages({ rootDir: absoluteRoot, appRoot }).sort(compareByRoute);
-    },
-    discoverApiRoutes() {
-      if (!appRoot) return [];
-      return discoverApiRoutes({ rootDir: absoluteRoot, appRoot }).sort((left, right) => {
-        return left.requestPath.localeCompare(right.requestPath) || left.method.localeCompare(right.method);
-      });
-    },
-    discoverServerActions() {
-      if (!appRoot) return [];
-      return discoverServerActions({ rootDir: absoluteRoot, appRoot }).sort(compareByPath);
-    },
-    analyzeRouteTree(routeOrPageFile) {
-      if (!appRoot) return null;
-      const key = normalizePath(routeOrPageFile);
-      if (routeTreeCache.has(key)) return routeTreeCache.get(key);
-      const result = analyzeRouteTree({ project, routeOrPageFile, diagnostics });
-      routeTreeCache.set(key, result);
-      return result;
-    },
-    async loadBuildRouting() {
-      if (!project.buildDir || !fs.existsSync(project.buildDir)) return null;
-      return {
-        async resolve(url, pathnames = []) {
-          return resolveRoutes({
-            url: new URL(url),
-            basePath: "",
-            requestBody: null,
-            headers: new Headers(),
-            pathnames,
-            routes: {
-              beforeMiddleware: [],
-              beforeFiles: [],
-              afterFiles: [],
-              dynamicRoutes: [],
-              onMatch: [],
-              fallback: [],
-            },
-            invokeMiddleware: async () => ({}),
-          });
-        },
-      };
-    },
-  };
-
-  return project;
-}

package/node_modules/@elench/next-analysis/src/project.test.mjs

@@ -1,35 +0,0 @@
-import path from "path";
-import { describe, expect, it } from "vitest";
-import { createNextAnalysisProject } from "./index.mjs";
-
-const fixtureRoot = path.resolve(
-  "/home/georgedlr/workspace/elench/testkit/test/fixtures/integration/next-route-tree-product"
-);
-
-describe("@elench/next-analysis project", () => {
-  it("discovers pages, api routes, and route trees from a Next fixture", () => {
-    const project = createNextAnalysisProject({ rootDir: fixtureRoot });
-
-    expect(project.findAppRoot()).toMatch(/src\/app$/u);
-    expect(project.discoverPages().map((page) => page.route)).toEqual(["/events", "/projects"]);
-    expect(project.discoverApiRoutes().map((route) => `${route.method} ${route.requestPath}`)).toEqual([
-      "GET /api/projects",
-      "POST /api/projects",
-      "GET /api/projects/[projectId]/events",
-    ]);
-
-    const routeTree = project.analyzeRouteTree("/projects");
-    expect(routeTree.reachableModules).toEqual(
-      expect.arrayContaining([
-        "src/app/(dashboard)/projects/page.tsx",
-        "src/components/project-context.tsx",
-      ])
-    );
-    expect(routeTree.requests).toEqual(
-      expect.arrayContaining([
-        expect.objectContaining({ ownerKind: "page", method: "GET", path: "/api/projects" }),
-        expect.objectContaining({ ownerKind: "action", method: "POST", path: "/api/projects" }),
-      ])
-    );
-  });
-});