@xbrowser/cli 1.3.0 → 1.4.0

package/dist/index.js

@@ -49,11 +49,11 @@ import {
   extractAndSave,
   extractRecording,
   printExtractSummary
-} from "./chunk-L53IDAWK.js";
+} from "./chunk-MJFYLKGL.js";
 import {
   filterRecording,
   parseExcludeTypes
-} from "./chunk-AT4PHAJY.js";
+} from "./chunk-GJAV3QGG.js";
 import {
   SessionRecorder
 } from "./chunk-ACFE6PKF.js";
@@ -81,8 +81,8 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-6V57JME6.js";
-import "./chunk-QFROODUU.js";
+} from "./chunk-UZQYMXR5.js";
+import "./chunk-N4PIGZDG.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   errMsg
@@ -114,7 +114,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,
@@ -300,7 +300,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();
@@ -392,13 +392,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 } : {} });
   }
@@ -713,6 +719,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",
@@ -1254,7 +1276,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",
@@ -1267,7 +1289,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()
@@ -1289,17 +1313,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(),
@@ -1945,7 +1970,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";
@@ -2461,7 +2486,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);
     }
@@ -3525,7 +3550,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);
@@ -3690,7 +3715,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 = [];
@@ -4347,7 +4372,7 @@ function parseMarkdownResults(rawText) {
 
 // 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();
@@ -5303,7 +5328,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) {
@@ -5472,7 +5497,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(),
@@ -5499,7 +5524,7 @@ var tabCommand = registerCommand({
       case "switch":
         return handleSwitch(p, pages, ctx);
       default:
-        return fail5(`Unknown subcommand: ${p.subcommand}`);
+        return fail6(`Unknown subcommand: ${p.subcommand}`);
     }
   }
 });
@@ -5556,11 +5581,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;
@@ -5583,10 +5608,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(() => {
@@ -5832,7 +5857,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",
@@ -5873,7 +5898,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);
@@ -5885,15 +5910,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") {
@@ -7317,7 +7342,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 [];
@@ -7353,7 +7378,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-JP2LFPR2.js");
+    const { findTargetPage } = await import("./browser-WMQRPYXX.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.`);
@@ -7557,7 +7582,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
       duration,
       timestamp: start
     });
-    return { ...fail7(errorMessage), duration };
+    return { ...fail8(errorMessage), duration };
   } finally {
   }
 }
@@ -7598,7 +7623,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") {
@@ -7617,7 +7642,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") {
@@ -7749,7 +7774,7 @@ async function executeChain(input, options) {
             results.push({
               command: `${cmdName} ${subCommand}`,
               raw: cmdStr,
-              ...fail7(errorMessage),
+              ...fail8(errorMessage),
               duration: duration2
             });
             if (type === "and") {
@@ -7821,7 +7846,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/context.ts
@@ -10313,6 +10338,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 };
@@ -11135,6 +11171,7 @@ async function handleConvert(args, _mode) {
   const { generateJSScript: generateJSScript2, generatePythonScript: generatePythonScript2, generateBashScript: generateBashScript2 } = await import("./convert-R3XXYKC6.js");
   const content = fs6.readFileSync(filePath, "utf-8");
   const recording = yaml3.parse(content);
+  if (recording.actions && !recording.events) recording.events = recording.actions;
   const ext = path5.extname(outputPath).toLowerCase();
   let script;
   if (ext === ".py") {
@@ -11146,7 +11183,7 @@ async function handleConvert(args, _mode) {
   }
   fs6.writeFileSync(outputPath, script);
   fs6.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}`);
@@ -11157,7 +11194,7 @@ async function handleExtract(args, _mode) {
     console.error("Usage: xbrowser extract <recording.yaml>");
     process.exit(1);
   }
-  const { extractAndSave: extractAndSave2, printExtractSummary: printExtractSummary2 } = await import("./extract-2ZFW2MX7.js");
+  const { extractAndSave: extractAndSave2, printExtractSummary: printExtractSummary2 } = await import("./extract-RM62AJXW.js");
   const { summary, outputPath } = extractAndSave2(filePath);
   printExtractSummary2(summary);
   console.log(`
@@ -11170,7 +11207,7 @@ async function handleFilter(args, _mode, options) {
     console.error("Usage: xbrowser filter <input.yaml> <output.yaml> [--exclude type1,type2]");
     process.exit(1);
   }
-  const { filterRecording: filterRecording2, parseExcludeTypes: parseExcludeTypes2 } = await import("./filter-3JQWBM5F.js");
+  const { filterRecording: filterRecording2, parseExcludeTypes: parseExcludeTypes2 } = await import("./filter-K6FGRJQU.js");
   const excludeArgs = args.slice(2).concat(
     Object.entries(options || {}).flatMap(
       ([k, v]) => k.startsWith("exclude") ? [`--${k}${typeof v === "string" ? "=" + v : ""}`] : []
@@ -12625,7 +12662,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 });
@@ -12888,6 +12925,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}`);
@@ -12897,6 +12941,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;
           }
@@ -16076,7 +16123,7 @@ var DataCollector = class {
     return results;
   }
   async createBrowserContext() {
-    const { launch } = await import("./cdp-driver-S5STYUZZ.js");
+    const { launch } = await import("./cdp-driver-72HOBP4C.js");
     const { browser } = await launch({
       headless: true,
       args: ["--no-sandbox", "--disable-setuid-sandbox"]

package/dist/{session-replayer-IXLSCF5U.js → session-replayer-JIVFXVUL.js}

@@ -31,7 +31,7 @@ var SessionReplayer = class {
     if (this.opts.page) {
       this.page = this.opts.page;
     } else if (this.opts.cdpUrl) {
-      const { launch } = await import("./cdp-driver-S5STYUZZ.js");
+      const { launch } = await import("./cdp-driver-72HOBP4C.js");
       const { browser } = await launch({ cdpEndpoint: this.opts.cdpUrl });
       let contexts = browser.contexts();
       for (let i = 0; i < 10 && contexts.length === 0; i++) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xbrowser/cli",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Browser automation CLI for web scraping, headless browsing, SEO analysis, and AI agent workflows. A command-line alternative to Playwright, Puppeteer, and Selenium.",
   "type": "module",
   "bin": {
@@ -84,7 +84,7 @@
     "prepare": "husky"
   },
   "dependencies": {
-    "@dyyz1993/xcli-core": "^0.15.0",
+    "@dyyz1993/xcli-core": "^0.16.0",
     "@types/react-syntax-highlighter": "^15.5.13",
     "@types/turndown": "^5.0.6",
     "cheerio": "^1.2.0",