automategraph 1.5.1 → 1.5.3

package/tools/server.mjs

@@ -0,0 +1,152 @@
+/* ============================================================
+ * Static report server + auto-refresh
+ * ------------------------------------------------------------
+ * Serves the workspace so the generated report can be viewed in
+ * a browser (and in the Arena live preview). Binds 0.0.0.0 so the
+ * preview proxy can reach it. No external dependencies.
+ *
+ *   node tools/server.mjs [port]
+ *
+ * Routes
+ *   /                     -> redirect to /report/index.html
+ *   /report/index.html    -> dashboard (with injected auto-reload)
+ *   /api/version          -> JSON { version, csv } fingerprint of results
+ *   /api/report.json      -> raw machine-readable results
+ *   /run                  -> re-runs the suite (tsc + runner) and refreshes
+ * ============================================================ */
+
+import { createServer } from "node:http";
+import { readFile, stat } from "node:fs/promises";
+import { spawn } from "node:child_process";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ROOT = path.resolve(__dirname, "..");
+const PORT = Number(process.argv[2] ?? 4173);
+const HOST = "0.0.0.0";
+
+const MIME = {
+  ".html": "text/html; charset=utf-8",
+  ".json": "application/json; charset=utf-8",
+  ".js": "text/javascript; charset=utf-8",
+  ".css": "text/css; charset=utf-8",
+  ".ts": "text/plain; charset=utf-8",
+  ".map": "application/json; charset=utf-8",
+  ".svg": "image/svg+xml",
+  ".ico": "image/x-icon"
+};
+
+async function fingerprint() {
+  try {
+    const info = await stat(path.join(ROOT, "report", "report.json"));
+    const data = JSON.parse(await readFile(path.join(ROOT, "report", "report.json"), "utf8"));
+    return {
+      version: `${info.mtimeMs}-${data.totals?.passed ?? 0}-${data.totals?.failed ?? 0}`,
+      summary: {
+        total: data.totals?.total ?? 0,
+        passed: data.totals?.passed ?? 0,
+        failed: data.totals?.failed ?? 0,
+        durationMs: data.durationMs ?? 0,
+        generatedAt: data.generatedAt ?? null
+      }
+    };
+  } catch {
+    return { version: "missing", summary: null };
+  }
+}
+
+const RELOAD_SNIPPET = `
+<script>
+(function () {
+  var current = null;
+  async function poll() {
+    try {
+      var response = await fetch("/api/version", { cache: "no-store" });
+      var data = await response.json();
+      if (current === null) current = data.version;
+      else if (data.version !== current) location.reload();
+    } catch (_) { /* ignore */ }
+  }
+  setInterval(poll, 2000);
+  poll();
+})();
+</script>
+`;
+
+function rerunSuite() {
+  return new Promise(resolve => {
+    const tsc = spawn(path.join(ROOT, "node_modules", ".bin", "tsc"), ["-p", "tsconfig.json"], { cwd: ROOT });
+    tsc.on("close", () => {
+      const runner = spawn(process.execPath, [path.join(ROOT, "js", "tests", "runner.js")], { cwd: ROOT });
+      let output = "";
+      runner.stdout.on("data", chunk => { output += chunk.toString(); });
+      runner.stderr.on("data", chunk => { output += chunk.toString(); });
+      runner.on("close", code => resolve({ code, output }));
+    });
+  });
+}
+
+const server = createServer(async (request, response) => {
+  const url = new URL(request.url ?? "/", `http://${request.headers.host ?? "localhost"}`);
+  let pathname = decodeURIComponent(url.pathname);
+
+  if (pathname === "/" ) {
+    response.writeHead(302, { Location: "/report/index.html" });
+    response.end();
+    return;
+  }
+
+  if (pathname === "/api/version") {
+    const payload = await fingerprint();
+    response.writeHead(200, { "Content-Type": MIME[".json"], "Cache-Control": "no-store" });
+    response.end(JSON.stringify(payload));
+    return;
+  }
+
+  if (pathname === "/api/report.json") {
+    pathname = "/report/report.json";
+  }
+
+  if (pathname === "/run") {
+    const result = await rerunSuite();
+    response.writeHead(200, { "Content-Type": MIME[".json"], "Cache-Control": "no-store" });
+    response.end(JSON.stringify({ exitCode: result.code, tail: result.output.split("\n").slice(-14).join("\n") }));
+    return;
+  }
+
+  const filePath = path.join(ROOT, pathname);
+
+  if (!filePath.startsWith(ROOT)) {
+    response.writeHead(403);
+    response.end("forbidden");
+    return;
+  }
+
+  try {
+    let body = await readFile(filePath);
+
+    if (pathname.endsWith(".html")) {
+      const html = body.toString("utf8");
+      body = Buffer.from(html.includes("</body>")
+        ? html.replace("</body>", `${RELOAD_SNIPPET}</body>`)
+        : html + RELOAD_SNIPPET);
+    }
+
+    const extension = path.extname(filePath);
+    response.writeHead(200, {
+      "Content-Type": MIME[extension] ?? "application/octet-stream",
+      "Cache-Control": "no-store"
+    });
+    response.end(body);
+  } catch {
+    response.writeHead(404, { "Content-Type": "text/plain; charset=utf-8" });
+    response.end("404 not found");
+  }
+});
+
+server.listen(PORT, HOST, () => {
+  console.log(`AutomateGraph report server listening on http://${HOST}:${PORT}`);
+  console.log(`Dashboard: http://localhost:${PORT}/report/index.html`);
+  console.log("Re-run endpoint: POST/GET /run  (recompiles and re-executes all 120 tests)");
+});

package/tsconfig.browser.json

@@ -0,0 +1,19 @@
+{
+  /* Isomorphic proof: the engine core must compile with DOM-only libs and
+     NO Node types. If any Node-specific API sneaks in, this build fails. */
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022", "DOM"],
+    "types": [],
+    "noEmit": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  /* Everything isomorphic. src/node/** is Node-only by definition and is
+     deliberately outside this guard (the two-step script loader lives there). */
+  "include": ["src/**/*.ts"],
+  "exclude": ["src/node/**/*.ts"]
+}

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "CommonJS",
+    "moduleResolution": "node",
+    "lib": ["ES2022", "DOM"],
+    "types": ["node"],
+    "outDir": "js",
+    "rootDir": ".",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": false,
+    "sourceMap": true
+  },
+  "include": ["src/**/*.ts", "tests/**/*.ts", "examples/**/*.ts"]
+}

package/tsconfig.publish.json

@@ -0,0 +1,13 @@
+{
+  /* Publishing build: emits JavaScript + .d.ts + declaration maps for the
+     library sources only (tests, examples and tools are not shipped).
+     Consumer-facing types live next to the emitted JS in js/src/. */
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "declaration": true,
+    "declarationMap": true,
+    "rootDir": ".",
+    "outDir": "js"
+  },
+  "include": ["src/**/*.ts"]
+}