hyperframes 0.6.48 → 0.6.50

package/dist/cli.js

@@ -54,7 +54,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.6.48" : "0.0.0-dev";
+    VERSION = true ? "0.6.50" : "0.0.0-dev";
   }
 });
 
@@ -11820,6 +11820,23 @@ function trackInitTemplate(templateId, props) {
 function trackBrowserInstall() {
   trackEvent("browser_install", {});
 }
+function trackCliError(props) {
+  trackEvent("cli_error", {
+    error_name: props.error_name,
+    error_message: props.error_message.slice(0, 1e3),
+    stack_trace: props.stack_trace?.slice(0, 2e3),
+    command: props.command,
+    kind: props.kind
+  });
+}
+function trackCommandResult(props) {
+  trackEvent("cli_command_result", {
+    command: props.command,
+    success: props.success,
+    exit_code: props.exitCode,
+    duration_ms: props.durationMs
+  });
+}
 var init_events = __esm({
   "src/telemetry/events.ts"() {
     "use strict";
@@ -26579,6 +26596,12 @@ function patchElementInHtml(source, target, operations) {
   }
   return wrappedFragment ? document2.body.innerHTML || "" : document2.toString();
 }
+function probeElementInSource(source, target) {
+  if (!target.id && !target.selector) return false;
+  const { document: document2 } = parseSourceDocument(source);
+  const el = findTargetElement(document2, target);
+  return el != null && isHTMLElement(el);
+}
 var ALLOWED_HTML_ATTRS, DANGEROUS_URI_SCHEMES, DANGEROUS_DATA_URI, URI_ATTRS;
 var init_sourceMutation = __esm({
   "../core/src/studio-api/helpers/sourceMutation.ts"() {
@@ -26670,13 +26693,13 @@ import {
   readdirSync as readdirSync4
 } from "fs";
 import { resolve as resolve9, dirname as dirname6, join as join13 } from "path";
-async function resolveProjectFile(c3, adapter2, opts) {
+async function resolveProjectPath(c3, adapter2, pathPrefix, opts) {
   const id = c3.req.param("id");
   const project = await adapter2.resolveProject(id);
   if (!project) {
     return { error: c3.json({ error: "not found" }, 404) };
   }
-  const filePath = decodeURIComponent(c3.req.path.replace(`/projects/${project.id}/files/`, ""));
+  const filePath = decodeURIComponent(c3.req.path.replace(pathPrefix(project.id), ""));
   if (filePath.includes("\0")) {
     return { error: c3.json({ error: "forbidden" }, 403) };
   }
@@ -26689,6 +26712,26 @@ async function resolveProjectFile(c3, adapter2, opts) {
   }
   return { project, filePath, absPath };
 }
+function resolveProjectFile(c3, adapter2, opts) {
+  return resolveProjectPath(c3, adapter2, (id) => `/projects/${id}/files/`, opts);
+}
+function resolveFileMutationContext(c3, adapter2, operation) {
+  return resolveProjectPath(c3, adapter2, (id) => `/projects/${id}/file-mutations/${operation}/`);
+}
+function writeIfChanged(c3, absPath, original, next) {
+  if (next === original) {
+    return c3.json({ ok: true, changed: false, content: original });
+  }
+  writeFileSync8(absPath, next, "utf-8");
+  return c3.json({ ok: true, changed: true, content: next });
+}
+async function parseMutationBody(c3) {
+  const body = await c3.req.json().catch(() => null);
+  if (!body?.target) {
+    return { error: c3.json({ error: "target required" }, 400) };
+  }
+  return { target: body.target, body };
+}
 function ensureDir(filePath) {
   const dir = dirname6(filePath);
   if (!existsSync11(dir)) mkdirSync6(dir, { recursive: true });
@@ -26781,64 +26824,55 @@ function registerFileRoutes(api, adapter2) {
     return c3.json({ ok: true });
   });
   api.post("/projects/:id/file-mutations/remove-element/*", async (c3) => {
-    const id = c3.req.param("id");
-    const project = await adapter2.resolveProject(id);
-    if (!project) return c3.json({ error: "not found" }, 404);
-    const filePath = decodeURIComponent(
-      c3.req.path.replace(`/projects/${project.id}/file-mutations/remove-element/`, "")
-    );
-    if (filePath.includes("\0")) {
-      return c3.json({ error: "forbidden" }, 403);
-    }
-    const absPath = resolve9(project.dir, filePath);
-    if (!isSafePath(project.dir, absPath)) {
-      return c3.json({ error: "forbidden" }, 403);
-    }
-    if (!existsSync11(absPath)) {
+    const ctx = await resolveFileMutationContext(c3, adapter2, "remove-element");
+    if ("error" in ctx) return ctx.error;
+    if (!existsSync11(ctx.absPath)) {
       return c3.json({ error: "not found" }, 404);
     }
-    const body = await c3.req.json().catch(() => null);
-    if (!body?.target) {
-      return c3.json({ error: "target required" }, 400);
-    }
-    const originalContent = readFileSync12(absPath, "utf-8");
-    const patchedContent = removeElementFromHtml2(originalContent, body.target);
-    if (patchedContent === originalContent) {
-      return c3.json({ ok: true, changed: false, content: originalContent });
-    }
-    writeFileSync8(absPath, patchedContent, "utf-8");
-    return c3.json({ ok: true, changed: true, content: patchedContent });
+    const parsed = await parseMutationBody(c3);
+    if ("error" in parsed) return parsed.error;
+    const originalContent = readFileSync12(ctx.absPath, "utf-8");
+    return writeIfChanged(
+      c3,
+      ctx.absPath,
+      originalContent,
+      removeElementFromHtml2(originalContent, parsed.target)
+    );
   });
   api.post("/projects/:id/file-mutations/patch-element/*", async (c3) => {
-    const id = c3.req.param("id");
-    const project = await adapter2.resolveProject(id);
-    if (!project) return c3.json({ error: "not found" }, 404);
-    const filePath = decodeURIComponent(
-      c3.req.path.replace(`/projects/${project.id}/file-mutations/patch-element/`, "")
-    );
-    if (filePath.includes("\0")) {
-      return c3.json({ error: "forbidden" }, 403);
-    }
-    const absPath = resolve9(project.dir, filePath);
-    if (!isSafePath(project.dir, absPath)) {
-      return c3.json({ error: "forbidden" }, 403);
-    }
-    const body = await c3.req.json().catch(() => null);
-    if (!body?.target || !Array.isArray(body.operations) || body.operations.length === 0) {
+    const ctx = await resolveFileMutationContext(c3, adapter2, "patch-element");
+    if ("error" in ctx) return ctx.error;
+    const parsed = await parseMutationBody(c3);
+    if ("error" in parsed) return parsed.error;
+    if (!Array.isArray(parsed.body.operations) || parsed.body.operations.length === 0) {
       return c3.json({ error: "target and operations required" }, 400);
     }
     let originalContent;
     try {
-      originalContent = readFileSync12(absPath, "utf-8");
+      originalContent = readFileSync12(ctx.absPath, "utf-8");
     } catch {
       return c3.json({ error: "not found" }, 404);
     }
-    const patchedContent = patchElementInHtml(originalContent, body.target, body.operations);
-    if (patchedContent === originalContent) {
-      return c3.json({ ok: true, changed: false, content: originalContent });
+    return writeIfChanged(
+      c3,
+      ctx.absPath,
+      originalContent,
+      patchElementInHtml(originalContent, parsed.target, parsed.body.operations)
+    );
+  });
+  api.post("/projects/:id/file-mutations/probe-element/*", async (c3) => {
+    const ctx = await resolveFileMutationContext(c3, adapter2, "probe-element");
+    if ("error" in ctx) return ctx.error;
+    const parsed = await parseMutationBody(c3);
+    if ("error" in parsed) return parsed.error;
+    let content;
+    try {
+      content = readFileSync12(ctx.absPath, "utf-8");
+    } catch {
+      return c3.json({ exists: false });
     }
-    writeFileSync8(absPath, patchedContent, "utf-8");
-    return c3.json({ ok: true, changed: true, content: patchedContent });
+    const exists = probeElementInSource(content, parsed.target);
+    return c3.json({ exists });
   });
   api.patch("/projects/:id/files/*", async (c3) => {
     const res = await resolveProjectFile(c3, adapter2, { mustExist: true });
@@ -30086,7 +30120,11 @@ async function pageScreenshotCapture(page, options) {
     format: isPng ? "png" : "jpeg",
     quality: isPng ? void 0 : options.quality ?? 80,
     fromSurface: true,
-    captureBeyondViewport: false,
+    // The explicit clip rect constrains output to exact composition
+    // dimensions. The viewport-boundary pre-clip from captureBeyondViewport:
+    // false is redundant, and Chrome's compositor rounds it inward under
+    // multi-tab load — clipping the bottom/right edge of tall viewports.
+    captureBeyondViewport: true,
     optimizeForSpeed: !isPng,
     clip
   });
@@ -30101,7 +30139,8 @@ async function captureScreenshotWithAlpha(page, width, height) {
     const result = await client.send("Page.captureScreenshot", {
       format: "png",
       fromSurface: true,
-      captureBeyondViewport: false,
+      captureBeyondViewport: true,
+      // see pageScreenshotCapture for rationale
       optimizeForSpeed: false,
       // `true` uses a zero-alpha-aware fast path that crushes real alpha values — observed empirically, CDP docs don't spell it out
       clip: { x: 0, y: 0, width, height, scale: 1 }
@@ -30130,7 +30169,8 @@ async function captureAlphaPng(page, width, height) {
   const result = await client.send("Page.captureScreenshot", {
     format: "png",
     fromSurface: true,
-    captureBeyondViewport: false,
+    captureBeyondViewport: true,
+    // see pageScreenshotCapture for rationale
     optimizeForSpeed: false,
     // must be false to preserve alpha
     clip: { x: 0, y: 0, width, height, scale: 1 }
@@ -99558,7 +99598,9 @@ __export(telemetry_exports2, {
   shouldTrack: () => shouldTrack,
   showTelemetryNotice: () => showTelemetryNotice,
   trackBrowserInstall: () => trackBrowserInstall,
+  trackCliError: () => trackCliError,
   trackCommand: () => trackCommand,
+  trackCommandResult: () => trackCommandResult,
   trackEvent: () => trackEvent,
   trackInitTemplate: () => trackInitTemplate,
   trackRenderComplete: () => trackRenderComplete,
@@ -100097,11 +100139,15 @@ var command = cliCommandArg && cliCommandArg in subCommands ? cliCommandArg : "u
 var hasJsonFlag = process.argv.includes("--json");
 var _flush;
 var _flushSync;
+var _trackCliError;
+var _trackCommandResult;
 var _printUpdateNotice;
 if (!isHelp && command !== "telemetry" && command !== "unknown") {
   Promise.resolve().then(() => (init_telemetry2(), telemetry_exports2)).then((mod) => {
     _flush = mod.flush;
     _flushSync = mod.flushSync;
+    _trackCliError = mod.trackCliError;
+    _trackCommandResult = mod.trackCommandResult;
     mod.showTelemetryNotice();
     mod.trackCommand(command);
     if (mod.shouldTrack()) mod.incrementCommandCount();
@@ -100119,13 +100165,44 @@ if (!isHelp && !hasJsonFlag && command !== "upgrade") {
     }
   });
 }
+var commandStart = Date.now();
+var commandFailed = false;
 process.on("beforeExit", () => {
   _flush?.().catch(() => {
   });
   if (!hasJsonFlag) _printUpdateNotice?.();
 });
-process.on("exit", () => {
+process.on("exit", (code) => {
+  _trackCommandResult?.({
+    command,
+    success: code === 0 && !commandFailed,
+    exitCode: code,
+    durationMs: Date.now() - commandStart
+  });
+  _flushSync?.();
+});
+process.on("uncaughtException", (error) => {
+  commandFailed = true;
+  _trackCliError?.({
+    error_name: error.name,
+    error_message: error.message,
+    stack_trace: error.stack,
+    command,
+    kind: "uncaught_exception"
+  });
   _flushSync?.();
+  process.exit(1);
+});
+process.on("unhandledRejection", (reason) => {
+  commandFailed = true;
+  const error = reason instanceof Error ? reason : new Error(String(reason));
+  _trackCliError?.({
+    error_name: error.name,
+    error_message: error.message,
+    stack_trace: error.stack,
+    command,
+    kind: "unhandled_rejection"
+  });
 });
 async function showUsage3(cmd, parent) {
   const { showUsage: impl } = await Promise.resolve().then(() => (init_help(), help_exports));