@xbrowser/cli 1.3.0 → 1.4.0

package/dist/cli.js

@@ -25,7 +25,7 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-MNFOCOL6.js";
+} from "./chunk-TLOHV3FP.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   forwardCommandLog,
@@ -187,7 +187,7 @@ var version = pkg.version;
 // src/executor.ts
 import {
   ok as ok25,
-  fail as fail7,
+  fail as fail8,
   isCommandResult,
   CompositeStorage as CompositeStorage2,
   TipCollector as TipCollector2,
@@ -263,7 +263,7 @@ function createStubContext(pluginName) {
 
 // src/commands/navigation.ts
 import { z } from "zod";
-import { ok } from "@dyyz1993/xcli-core";
+import { ok, fail } from "@dyyz1993/xcli-core";
 
 // src/commands/command-registry.ts
 var registry = /* @__PURE__ */ new Map();
@@ -352,13 +352,19 @@ var gotoCommand = registerCommand({
       if (/^[\w-]+(\.[\w-]+)+/.test(url) || url.startsWith("localhost")) {
         url = "https://" + url;
       } else {
-        throw new Error(`Invalid URL: "${url}". Expected http(s)://, file://, about:, data:, or a domain name.`);
+        return fail(`Invalid URL: "${url}". Expected http(s)://, file://, about:, data:, or a domain name.`);
       }
     }
-    const response = await ctx.page.goto(url, {
-      waitUntil: p.waitUntil || "domcontentloaded",
-      ...p.timeout ? { timeout: p.timeout } : {}
-    });
+    let response;
+    try {
+      response = await ctx.page.goto(url, {
+        waitUntil: p.waitUntil || "domcontentloaded",
+        ...p.timeout ? { timeout: p.timeout } : {}
+      });
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return fail(`Navigation failed: ${msg}`);
+    }
     const ssr = await detectSsr(ctx.page);
     return ok({ url, status: response?.status(), ...ssr ? { ssr } : {} });
   }
@@ -673,6 +679,22 @@ var checkCommand = registerCommand({
     return ok2({ selector: p.selector });
   }
 });
+var uncheckCommand = registerCommand({
+  name: "uncheck",
+  description: "Uncheck checkbox or radio",
+  scope: "element",
+  selectorParams: ["selector"],
+  parameters: z2.object({
+    selector: z2.string()
+  }),
+  result: z2.object({
+    selector: z2.string()
+  }),
+  handler: async (p, ctx) => {
+    await ctx.page.uncheck(p.selector, { timeout: 1e4 });
+    return ok2({ selector: p.selector });
+  }
+});
 var hoverCommand = registerCommand({
   name: "hover",
   description: "Hover over element",
@@ -1214,7 +1236,7 @@ var setViewportCommand = registerCommand({
 
 // src/commands/frame.ts
 import { z as z12 } from "zod";
-import { ok as ok12, fail } from "@dyyz1993/xcli-core";
+import { ok as ok12, fail as fail2 } from "@dyyz1993/xcli-core";
 var framesCommand = registerCommand({
   name: "frames",
   description: "List all frames in the current page",
@@ -1227,7 +1249,9 @@ var framesCommand = registerCommand({
     }))
   }),
   handler: async (_p, ctx) => {
-    const frameList = ctx.page.frames().map((frame, index) => ({
+    const discover = ctx.page.discoverFrames;
+    const rawFrames = discover ? await discover.call(ctx.page) : ctx.page.frames();
+    const frameList = rawFrames.map((frame, index) => ({
       index,
       name: frame.name(),
       url: frame.url()
@@ -1249,17 +1273,18 @@ var frameCommand = registerCommand({
     error: z12.string().optional()
   }),
   handler: async (p, ctx) => {
-    const allFrames = ctx.page.frames();
+    const discover = ctx.page.discoverFrames;
+    const rawFrames = discover ? await discover.call(ctx.page) : ctx.page.frames();
     let targetFrame;
     if (p.index !== void 0) {
-      targetFrame = allFrames[p.index];
+      targetFrame = rawFrames[p.index];
     } else if (p.name !== void 0) {
-      targetFrame = allFrames.find((f) => f.name() === p.name);
+      targetFrame = rawFrames.find((f) => f.name() === p.name);
     } else {
-      return fail("Must provide index or name");
+      return fail2("Must provide index or name");
     }
     if (!targetFrame) {
-      return fail("Frame not found");
+      return fail2("Frame not found");
     }
     return ok12({
       name: targetFrame.name(),
@@ -1905,7 +1930,7 @@ var actionsCommand = registerCommand({
 
 // src/commands/scrape.ts
 import { z as z15 } from "zod";
-import { ok as ok15, fail as fail2 } from "@dyyz1993/xcli-core";
+import { ok as ok15, fail as fail3 } from "@dyyz1993/xcli-core";
 
 // src/lib/html-to-markdown.ts
 import * as cheerio from "cheerio";
@@ -2421,7 +2446,7 @@ var scrapeCommand = registerCommand({
           }
         }
       }
-      return fail2(`Scrape failed after ${maxAttempts} attempt(s): ${lastError?.message ?? "unknown error"}`);
+      return fail3(`Scrape failed after ${maxAttempts} attempt(s): ${lastError?.message ?? "unknown error"}`);
     } finally {
       await closeEphemeralContext(context);
     }
@@ -3485,7 +3510,7 @@ ${errors.map((e) => `  - ${e.engine}: ${e.error}`).join("\n")}`
 
 // src/commands/network.ts
 import { z as z19 } from "zod";
-import { ok as ok19, fail as fail3 } from "@dyyz1993/xcli-core";
+import { ok as ok19, fail as fail4 } from "@dyyz1993/xcli-core";
 function extractPath2(url) {
   try {
     const u = new URL(url);
@@ -3650,7 +3675,7 @@ var networkCommand = registerCommand({
     };
     if (p.listen) {
       const page2 = ctx.page;
-      if (!page2) return fail3("No active page. Use --cdp to connect first.");
+      if (!page2) return fail4("No active page. Use --cdp to connect first.");
       const captures = [];
       const consoleMessages = [];
       const wsCaptures = [];
@@ -4030,7 +4055,7 @@ var ENGINE_KEY_ENUM = z20.enum(ALL_ENGINE_KEYS);
 
 // src/commands/snapshot.ts
 import { z as z21 } from "zod";
-import { ok as ok20, fail as fail4, normalizeTips as normalizeTips3 } from "@dyyz1993/xcli-core";
+import { ok as ok20, fail as fail5, normalizeTips as normalizeTips3 } from "@dyyz1993/xcli-core";
 
 // src/runtime/ref-store.ts
 var sessions = /* @__PURE__ */ new Map();
@@ -4986,7 +5011,7 @@ var snapshotCommand = registerCommand({
       persistSemantics(url, aria);
       return ok20({ url, title, aria, text, dom }, normalizeTips3(tips));
     }
-    return fail4(`Unknown snapshot type: ${p.type}`);
+    return fail5(`Unknown snapshot type: ${p.type}`);
   }
 });
 function persistSemantics(url, aria) {
@@ -5155,7 +5180,7 @@ var waitForCommand = registerCommand({
 
 // src/commands/tab.ts
 import { z as z23 } from "zod";
-import { ok as ok22, fail as fail5 } from "@dyyz1993/xcli-core";
+import { ok as ok22, fail as fail6 } from "@dyyz1993/xcli-core";
 var TabParams = z23.object({
   subcommand: z23.enum(["list", "new", "close", "switch"]),
   url: z23.string().optional(),
@@ -5182,7 +5207,7 @@ var tabCommand = registerCommand({
       case "switch":
         return handleSwitch(p, pages, ctx);
       default:
-        return fail5(`Unknown subcommand: ${p.subcommand}`);
+        return fail6(`Unknown subcommand: ${p.subcommand}`);
     }
   }
 });
@@ -5239,11 +5264,11 @@ async function handleNew(p, _pages, ctx) {
 }
 async function handleClose(p, pages, ctx) {
   if (pages.length <= 1) {
-    return fail5("Cannot close the last remaining tab");
+    return fail6("Cannot close the last remaining tab");
   }
   const closeIndex = p.index ?? pages.indexOf(ctx.page);
   if (closeIndex < 0 || closeIndex >= pages.length) {
-    return fail5(`Invalid tab index: ${closeIndex}. Valid range: 0-${pages.length - 1}`);
+    return fail6(`Invalid tab index: ${closeIndex}. Valid range: 0-${pages.length - 1}`);
   }
   const pageToClose = pages[closeIndex];
   const isActivePage = pageToClose === ctx.page;
@@ -5266,10 +5291,10 @@ async function handleClose(p, pages, ctx) {
 }
 async function handleSwitch(p, pages, ctx) {
   if (p.index === void 0) {
-    return fail5("Parameter --index is required for switch subcommand");
+    return fail6("Parameter --index is required for switch subcommand");
   }
   if (p.index < 0 || p.index >= pages.length) {
-    return fail5(`Invalid tab index: ${p.index}. Valid range: 0-${pages.length - 1}`);
+    return fail6(`Invalid tab index: ${p.index}. Valid range: 0-${pages.length - 1}`);
   }
   const targetPage = pages[p.index];
   await targetPage.bringToFront().catch(() => {
@@ -5515,7 +5540,7 @@ registerCommandDefinition("addinitscript", ["script"]);
 
 // src/commands/find.ts
 import { z as z25 } from "zod";
-import { ok as ok24, fail as fail6, normalizeTips as normalizeTips5 } from "@dyyz1993/xcli-core";
+import { ok as ok24, fail as fail7, normalizeTips as normalizeTips5 } from "@dyyz1993/xcli-core";
 var actionSchema2 = z25.enum(["click", "fill", "type", "select", "hover", "check"]);
 var findCommand = registerCommand({
   name: "find",
@@ -5556,7 +5581,7 @@ var findCommand = registerCommand({
     });
     const count = await locator.count();
     if (count === 0) {
-      return fail6(`No element found with ${p.strategy}="${p.value}"`);
+      return fail7(`No element found with ${p.strategy}="${p.value}"`);
     }
     const tips = [];
     const target = selectTarget(locator, p.strategy);
@@ -5568,15 +5593,15 @@ var findCommand = registerCommand({
       await target.click({ timeout: p.timeout, force: true });
       return okWithTips({ matched: count, selector, action: "click" }, tips);
     } else if (actionName === "fill") {
-      if (actionValue === void 0) return fail6("find fill requires a value");
+      if (actionValue === void 0) return fail7("find fill requires a value");
       await target.fill(actionValue, { timeout: p.timeout, force: true });
       return okWithTips({ matched: count, selector, action: `fill("${actionValue}")` }, tips);
     } else if (actionName === "type") {
-      if (actionValue === void 0) return fail6("find type requires a value");
+      if (actionValue === void 0) return fail7("find type requires a value");
       await target.type(actionValue, { delay: 10, timeout: p.timeout });
       return okWithTips({ matched: count, selector, action: `type("${actionValue}")` }, tips);
     } else if (actionName === "select") {
-      if (actionValue === void 0) return fail6("find select requires a value");
+      if (actionValue === void 0) return fail7("find select requires a value");
       await target.selectOption(actionValue);
       return okWithTips({ matched: count, selector, action: `select("${actionValue}")` }, tips);
     } else if (actionName === "hover") {
@@ -7000,7 +7025,7 @@ async function guardCheck(commandName) {
   }
 }
 function errorResult(message) {
-  return { ...fail7(message), duration: 0 };
+  return { ...fail8(message), duration: 0 };
 }
 function tipsToMessages(tips) {
   if (!tips || tips.length === 0) return [];
@@ -7033,7 +7058,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-PZX7PO23.js");
+    const { findTargetPage } = await import("./browser-VKZVOOVV.js");
     targetPageOverride = await findTargetPage(extraOpts.cdpEndpoint, _target);
     if (!targetPageOverride) {
       return errorResult(`Target "${_target}" not found. Use 'xbrowser targets --cdp ${extraOpts.cdpEndpoint}' to list available pages.`);
@@ -7237,7 +7262,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
       duration,
       timestamp: start
     });
-    return { ...fail7(errorMessage), duration };
+    return { ...fail8(errorMessage), duration };
   } finally {
   }
 }
@@ -7278,7 +7303,7 @@ async function executeChain(input, options) {
             results.push({
               command: cmdName,
               raw: cmdStr,
-              ...fail7(`Plugin "${cmdName}" requires a sub-command`),
+              ...fail8(`Plugin "${cmdName}" requires a sub-command`),
               duration: 0
             });
             if (type === "and") {
@@ -7297,7 +7322,7 @@ async function executeChain(input, options) {
             results.push({
               command: cmdName,
               raw: cmdStr,
-              ...fail7(`Unknown command "${subCommand}" for plugin "${cmdName}"`),
+              ...fail8(`Unknown command "${subCommand}" for plugin "${cmdName}"`),
               duration: 0
             });
             if (type === "and") {
@@ -7429,7 +7454,7 @@ async function executeChain(input, options) {
             results.push({
               command: `${cmdName} ${subCommand}`,
               raw: cmdStr,
-              ...fail7(errorMessage),
+              ...fail8(errorMessage),
               duration: duration2
             });
             if (type === "and") {
@@ -7501,7 +7526,7 @@ async function executeChain(input, options) {
   }
 }
 function isChainInput(input) {
-  return /\s&&\s|\s;\s|\s,\s|\s\+\s|\s->\s/.test(input);
+  return /\s&&\s|\|\|\s|\s;\s|\s,\s|\s\+\s|\s->\s/.test(input);
 }
 
 // src/session/session-client.ts
@@ -9973,6 +9998,17 @@ async function handleBrowserCommand(command, args, options, sessionName, mode, c
         };
         break;
       }
+      case "tab": {
+        const tabSub = args[0];
+        const validSubs = ["list", "new", "close", "switch"];
+        cmdName = "tab";
+        params = {
+          subcommand: validSubs.includes(tabSub) ? tabSub : options.subcommand,
+          url: args[1] || options.url,
+          index: options.index ? Number(options.index) : void 0
+        };
+        break;
+      }
       default:
         cmdName = command;
         params = { ...options };
@@ -10795,6 +10831,7 @@ async function handleConvert(args, _mode) {
   const { generateJSScript, generatePythonScript, generateBashScript } = await import("./convert-LB3GJTLR.js");
   const content = fs3.readFileSync(filePath, "utf-8");
   const recording = yaml.parse(content);
+  if (recording.actions && !recording.events) recording.events = recording.actions;
   const ext = path3.extname(outputPath).toLowerCase();
   let script;
   if (ext === ".py") {
@@ -10806,7 +10843,7 @@ async function handleConvert(args, _mode) {
   }
   fs3.writeFileSync(outputPath, script);
   fs3.chmodSync(outputPath, 493);
-  const eventCount = (recording.events || []).length;
+  const eventCount = (recording.events || recording.actions || []).length;
   console.log(`Converted ${filePath} -> ${outputPath}`);
   console.log(`  Events: ${eventCount}, Start URL: ${recording.startUrl}`);
   console.log(`  Run: ${ext === ".py" ? "python" : ext === ".sh" ? "./" : "node"} ${outputPath}`);
@@ -10817,7 +10854,7 @@ async function handleExtract(args, _mode) {
     console.error("Usage: xbrowser extract <recording.yaml>");
     process.exit(1);
   }
-  const { extractAndSave, printExtractSummary } = await import("./extract-BSYBM4MR.js");
+  const { extractAndSave, printExtractSummary } = await import("./extract-O46CC533.js");
   const { summary, outputPath } = extractAndSave(filePath);
   printExtractSummary(summary);
   console.log(`
@@ -10830,7 +10867,7 @@ async function handleFilter(args, _mode, options) {
     console.error("Usage: xbrowser filter <input.yaml> <output.yaml> [--exclude type1,type2]");
     process.exit(1);
   }
-  const { filterRecording, parseExcludeTypes } = await import("./filter-EDTFGLS5.js");
+  const { filterRecording, parseExcludeTypes } = await import("./filter-TAAYMSYI.js");
   const excludeArgs = args.slice(2).concat(
     Object.entries(options || {}).flatMap(
       ([k, v]) => k.startsWith("exclude") ? [`--${k}${typeof v === "string" ? "=" + v : ""}`] : []
@@ -12285,7 +12322,7 @@ function extractCdpFromArgv(argv) {
   return process.env.XBROWSER_CDP;
 }
 async function handleStdinMode(stdinCommands, argv) {
-  const chain = stdinCommands.join(" && ");
+  const chain = stdinCommands.join(" ; ");
   const cdpEndpoint = argv ? extractCdpFromArgv(argv) : void 0;
   const sessionName = argv ? extractSessionNameFromArgv(argv) : "default";
   const chainResult = await executeChain(chain, { fileMode: true, cdpEndpoint, sessionName });
@@ -12548,6 +12585,13 @@ async function routeCommand(argvIn, stdinCommands) {
             for (const step of chainResult.steps) {
               if (step.success) {
                 console.log(`[OK] ${step.raw}`);
+                if (step.data && typeof step.data === "object") {
+                  const d = step.data;
+                  for (const [k, v] of Object.entries(d)) {
+                    if (k !== "ok" && k !== "success")
+                      console.log(`     ${k}: ${typeof v === "string" ? v : JSON.stringify(v)}`);
+                  }
+                }
                 if (step.tips?.length) {
                   for (const tip of step.tips) {
                     console.log(`  \u{1F4A1} ${tip}`);
@@ -12557,6 +12601,9 @@ async function routeCommand(argvIn, stdinCommands) {
                 console.error(`[FAIL] ${step.raw}: ${step.message}`);
               }
             }
+            if (chainResult.stoppedReason) {
+              console.error(`Stopped: ${chainResult.stoppedReason}`);
+            }
             if (!chainResult.success) throw new Error("Command failed");
             return;
           }
@@ -12949,7 +12996,7 @@ async function main() {
     const command = process.argv[2];
     const isLongRunning = command === "preview" || command === "serve";
     if (!isLongRunning) {
-      const { ensureProcessCanExit } = await import("./browser-PZX7PO23.js");
+      const { ensureProcessCanExit } = await import("./browser-VKZVOOVV.js");
       await ensureProcessCanExit().catch(() => {
       });
       process.exit(exitCode);