@xbrowser/cli 1.4.2 → 1.4.3

package/dist/{browser-VKZVOOVV.js → browser-B5W577GO.js}

@@ -20,7 +20,7 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-TLOHV3FP.js";
+} from "./chunk-O4HCWMU2.js";
 import "./chunk-TNEN6VQ2.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-KFQGP6VL.js";

package/dist/{browser-WMQRPYXX.js → browser-MPMDAGZY.js}

@@ -20,8 +20,8 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-UZQYMXR5.js";
-import "./chunk-N4PIGZDG.js";
+} from "./chunk-JLSKMNMN.js";
+import "./chunk-WI3XE4W3.js";
 import "./chunk-TNEN6VQ2.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-ABXMBNQ6.js";

package/dist/{browser-ALV2PLW4.js → browser-VWKGCFA5.js}

@@ -20,8 +20,8 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-7OGKQWXE.js";
-import "./chunk-N4PIGZDG.js";
+} from "./chunk-J3VNBG25.js";
+import "./chunk-WI3XE4W3.js";
 import "./chunk-TNEN6VQ2.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-KFQGP6VL.js";

package/dist/{cdp-driver-72HOBP4C.js → cdp-driver-RCRYKHVQ.js}

@@ -14,7 +14,7 @@ import {
   scrollIntoView,
   waitForActionable,
   waitForNetworkIdle
-} from "./chunk-N4PIGZDG.js";
+} from "./chunk-WI3XE4W3.js";
 import {
   connectToCDP,
   findChrome,

package/dist/{cdp-driver-JZPU5YXY.js → cdp-driver-TMMK2YYE.js}

@@ -1629,16 +1629,16 @@ Last error: ${lastError.message}` : "";
       const result = await this.conn.send("Page.getFrameTree", void 0, this.sessionId);
       const frames = [];
       const collect = (node) => {
-        frames.push({
+        const frame = {
           name: () => node.frame.name || "",
           url: () => node.frame.url,
-          // Helper for frame.ts to pick by index
-          childFrames: () => (node.childFrames || []).map((c) => ({
-            name: () => c.frame.name || "",
-            url: () => c.frame.url,
-            childFrames: () => []
-          }))
-        });
+          isDetached: () => false,
+          page: () => this,
+          evaluate: (fn, ...args) => this.evaluate(fn, ...args),
+          $: (sel) => this.$(sel),
+          $$: (sel) => this.$$(sel)
+        };
+        frames.push(frame);
         for (const child of node.childFrames || []) {
           collect({ frame: child.frame, childFrames: [] });
         }

package/dist/{chunk-7OGKQWXE.js → chunk-J3VNBG25.js}

@@ -1,6 +1,6 @@
 import {
   launch
-} from "./chunk-N4PIGZDG.js";
+} from "./chunk-WI3XE4W3.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";

package/dist/{chunk-UZQYMXR5.js → chunk-JLSKMNMN.js}

@@ -1,6 +1,6 @@
 import {
   launch
-} from "./chunk-N4PIGZDG.js";
+} from "./chunk-WI3XE4W3.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";

package/dist/{chunk-TLOHV3FP.js → chunk-O4HCWMU2.js}

@@ -1634,16 +1634,16 @@ Last error: ${lastError.message}` : "";
       const result = await this.conn.send("Page.getFrameTree", void 0, this.sessionId);
       const frames = [];
       const collect = (node) => {
-        frames.push({
+        const frame = {
           name: () => node.frame.name || "",
           url: () => node.frame.url,
-          // Helper for frame.ts to pick by index
-          childFrames: () => (node.childFrames || []).map((c) => ({
-            name: () => c.frame.name || "",
-            url: () => c.frame.url,
-            childFrames: () => []
-          }))
-        });
+          isDetached: () => false,
+          page: () => this,
+          evaluate: (fn, ...args) => this.evaluate(fn, ...args),
+          $: (sel) => this.$(sel),
+          $$: (sel) => this.$$(sel)
+        };
+        frames.push(frame);
         for (const child of node.childFrames || []) {
           collect({ frame: child.frame, childFrames: [] });
         }

package/dist/{chunk-N4PIGZDG.js → chunk-WI3XE4W3.js}

@@ -1628,16 +1628,16 @@ Last error: ${lastError.message}` : "";
       const result = await this.conn.send("Page.getFrameTree", void 0, this.sessionId);
       const frames = [];
       const collect = (node) => {
-        frames.push({
+        const frame = {
           name: () => node.frame.name || "",
           url: () => node.frame.url,
-          // Helper for frame.ts to pick by index
-          childFrames: () => (node.childFrames || []).map((c) => ({
-            name: () => c.frame.name || "",
-            url: () => c.frame.url,
-            childFrames: () => []
-          }))
-        });
+          isDetached: () => false,
+          page: () => this,
+          evaluate: (fn, ...args) => this.evaluate(fn, ...args),
+          $: (sel) => this.$(sel),
+          $$: (sel) => this.$$(sel)
+        };
+        frames.push(frame);
         for (const child of node.childFrames || []) {
           collect({ frame: child.frame, childFrames: [] });
         }

package/dist/cli.js

@@ -25,7 +25,7 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-TLOHV3FP.js";
+} from "./chunk-O4HCWMU2.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   forwardCommandLog,
@@ -2678,7 +2678,7 @@ async function discoverUrls(page, baseUrl, options) {
 `);
   const basePath = new URL(baseUrl).pathname;
   let filtered = Array.from(allUrls).filter(
-    (u) => isSameDomain(u, baseHostname, options.includeSubdomains ?? false) && isWithinPathScope(u, basePath)
+    (u) => options.allowExternalLinks || isSameDomain(u, baseHostname, options.includeSubdomains ?? false) && isWithinPathScope(u, basePath)
   );
   filtered = deduplicateUrls(filtered);
   if (options.search) {
@@ -2699,6 +2699,7 @@ var mapCommand = registerCommand({
     search: z16.string().optional(),
     sitemap: z16.enum(["include", "only"]).optional(),
     includeSubdomains: z16.boolean().optional(),
+    allowExternalLinks: z16.boolean().optional().describe("Include links to external domains"),
     limit: z16.number().optional(),
     verbose: z16.boolean().default(false).describe("Show progress feedback")
   }),
@@ -2708,6 +2709,7 @@ var mapCommand = registerCommand({
       const links = await discoverUrls(page, p.url, {
         sitemap: p.sitemap,
         includeSubdomains: p.includeSubdomains,
+        allowExternalLinks: p.allowExternalLinks,
         limit: p.limit,
         search: p.search,
         verbose: p.verbose
@@ -4892,8 +4894,23 @@ async function waitForPage(page, input) {
       return { success: true, matched: "selector", timeout, elapsed: Date.now() - startedAt };
     }
     if (input.text) {
-      await page.getByText(input.text).first().waitFor({ state: "visible", timeout });
-      return { success: true, matched: "text", timeout, elapsed: Date.now() - startedAt };
+      const textToFind = input.text;
+      const matched = await pollUntil(timeout, pollInterval, async () => {
+        return page.evaluate((text) => {
+          const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT);
+          while (walker.nextNode()) {
+            if (walker.currentNode.textContent?.includes(text)) return true;
+          }
+          return false;
+        }, textToFind);
+      });
+      return {
+        success: matched,
+        matched: "text",
+        timeout,
+        elapsed: Date.now() - startedAt,
+        ...matched ? {} : { message: `Timed out waiting for text: ${input.text}` }
+      };
     }
     if (input.url) {
       const matched = await pollUntil(timeout, pollInterval, async () => matchUrlPattern(page.url(), input.url));
@@ -7058,7 +7075,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-VKZVOOVV.js");
+    const { findTargetPage } = await import("./browser-B5W577GO.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.`);
@@ -12408,7 +12425,7 @@ async function routeCommand(argvIn, stdinCommands) {
       const possibleCmd = argv[0].substring(0, spaceIdx);
       if (/^[a-zA-Z][\w-]*$/.test(possibleCmd)) {
         const remainder = argv[0].substring(spaceIdx + 1);
-        if (remainder.startsWith("--") || remainder.includes(" --") && !remainder.match(/^\w+:\/\//)) {
+        if (remainder.includes("--")) {
           const remainderParts = remainder.split(/\s+/).filter(Boolean);
           argv = [possibleCmd, ...remainderParts, ...argv.slice(1)];
         } else {
@@ -13024,7 +13041,7 @@ async function main() {
     const command = process.argv[2];
     const isLongRunning = command === "preview" || command === "serve";
     if (!isLongRunning) {
-      const { ensureProcessCanExit } = await import("./browser-VKZVOOVV.js");
+      const { ensureProcessCanExit } = await import("./browser-B5W577GO.js");
       await ensureProcessCanExit().catch(() => {
       });
       process.exit(exitCode);

package/dist/daemon-main.js

@@ -21,8 +21,8 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-7OGKQWXE.js";
-import "./chunk-N4PIGZDG.js";
+} from "./chunk-J3VNBG25.js";
+import "./chunk-WI3XE4W3.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   getPluginLoader
@@ -2639,7 +2639,7 @@ async function discoverUrls(page, baseUrl, options) {
 `);
   const basePath = new URL(baseUrl).pathname;
   let filtered = Array.from(allUrls).filter(
-    (u) => isSameDomain(u, baseHostname, options.includeSubdomains ?? false) && isWithinPathScope(u, basePath)
+    (u) => options.allowExternalLinks || isSameDomain(u, baseHostname, options.includeSubdomains ?? false) && isWithinPathScope(u, basePath)
   );
   filtered = deduplicateUrls(filtered);
   if (options.search) {
@@ -2660,6 +2660,7 @@ var mapCommand = registerCommand({
     search: z16.string().optional(),
     sitemap: z16.enum(["include", "only"]).optional(),
     includeSubdomains: z16.boolean().optional(),
+    allowExternalLinks: z16.boolean().optional().describe("Include links to external domains"),
     limit: z16.number().optional(),
     verbose: z16.boolean().default(false).describe("Show progress feedback")
   }),
@@ -2669,6 +2670,7 @@ var mapCommand = registerCommand({
       const links = await discoverUrls(page, p.url, {
         sitemap: p.sitemap,
         includeSubdomains: p.includeSubdomains,
+        allowExternalLinks: p.allowExternalLinks,
         limit: p.limit,
         search: p.search,
         verbose: p.verbose
@@ -4853,8 +4855,23 @@ async function waitForPage(page, input) {
       return { success: true, matched: "selector", timeout, elapsed: Date.now() - startedAt };
     }
     if (input.text) {
-      await page.getByText(input.text).first().waitFor({ state: "visible", timeout });
-      return { success: true, matched: "text", timeout, elapsed: Date.now() - startedAt };
+      const textToFind = input.text;
+      const matched = await pollUntil(timeout, pollInterval, async () => {
+        return page.evaluate((text) => {
+          const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT);
+          while (walker.nextNode()) {
+            if (walker.currentNode.textContent?.includes(text)) return true;
+          }
+          return false;
+        }, textToFind);
+      });
+      return {
+        success: matched,
+        matched: "text",
+        timeout,
+        elapsed: Date.now() - startedAt,
+        ...matched ? {} : { message: `Timed out waiting for text: ${input.text}` }
+      };
     }
     if (input.url) {
       const matched = await pollUntil(timeout, pollInterval, async () => matchUrlPattern(page.url(), input.url));
@@ -6589,7 +6606,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-ALV2PLW4.js");
+    const { findTargetPage } = await import("./browser-VWKGCFA5.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.`);
@@ -8305,7 +8322,7 @@ function createRPCHandler() {
     const isNewFormat = Array.isArray(parsed.actions);
     if (isNewFormat) {
       try {
-        const { SessionReplayer } = await import("./session-replayer-JIVFXVUL.js");
+        const { SessionReplayer } = await import("./session-replayer-X3S47AA3.js");
         const replayer = new SessionReplayer({
           page: session.page,
           stepDelay: slowMo * 500,

package/dist/index.d.ts

@@ -172,6 +172,7 @@ interface XBPage {
         height: number;
     }): Promise<void>;
     addInitScript(script: string): Promise<void>;
+    discoverFrames(): Promise<XBFrame[]>;
     bringToFront(): Promise<void>;
     setExtraHTTPHeaders(headers: Record<string, string>): Promise<void>;
     setOfflineMode(offline: boolean): Promise<void>;
@@ -1606,6 +1607,10 @@ declare class RecorderController {
     private getDefaultOutputPath;
 }
 
+/**
+ * Recording-related type definitions.
+ * Extracted from session-recorder.ts to keep the main file focused on logic.
+ */
 interface ClickContextItem {
     text: string;
     tag?: string;
@@ -1650,17 +1655,13 @@ interface UserAction {
         tag: string;
         selector?: string;
         text: string;
-        /** Which strategy from generateUniqueSelector produced this selector */
         strategy?: string;
-        /** Reliability rating from generateUniqueSelector: high / medium / low */
         confidence?: 'high' | 'medium' | 'low';
-        /** Text-based fallback for low-confidence selectors (e.g. menu items) */
         textFallback?: {
             type: 'text';
             value: string;
             selector: string;
         };
-        /** Popup/menu context when element is inside a dropdown */
         popup?: {
             containerSelector: string;
             containerText: string;
@@ -1677,9 +1678,7 @@ interface UserAction {
     y?: number;
     scrollX?: number;
     scrollY?: number;
-    /** Click context: popover/dropdown/menu items captured 200ms after click */
     clickContext?: ClickContext;
-    /** File upload info (type=filechooser only) */
     files?: {
         names: string[];
         count: number;
@@ -1691,36 +1690,30 @@ interface UserAction {
             dataUrl: string | null;
         }>;
     };
-    /** Drag & drop info (type=drag only) */
     drag?: {
         fromX: number;
         fromY: number;
         toX: number;
         toY: number;
-        /** Source element description */
         source?: {
             tag: string;
             selector?: string;
             text: string;
         };
-        /** Target (drop zone) element description */
         target?: {
             tag: string;
             selector?: string;
             text: string;
         };
     };
-    /** Resize info (type=resize only) */
     resize?: {
         width: number;
         height: number;
     };
-    /** Clipboard info (type=clipboard only) */
     clipboard?: {
         operation: 'copy' | 'paste' | 'cut';
         textPreview?: string;
     };
-    /** Touch info (type=touch only) */
     touch?: {
         touchType: 'start' | 'move' | 'end';
         touches: Array<{
@@ -1728,26 +1721,19 @@ interface UserAction {
             y: number;
         }>;
     };
-    /** Focus info (type=focus only) */
     focus?: {
         focusType: 'focus' | 'blur';
     };
-    /** Visibility info (type=visibility only) */
     visibility?: {
         state: 'visible' | 'hidden';
     };
-    /** Mouse trajectory from previous action's position to this action's position.
-     *  Captured as simplified waypoints with relative timestamps for realistic replay. */
     trajectory?: {
-        /** Waypoints: [x, y, deltaMs from previous point] */
         points: Array<{
             x: number;
             y: number;
             dt: number;
         }>;
-        /** Total distance in pixels (approximate) */
         distance: number;
-        /** Total duration in ms */
         duration: number;
     };
 }
@@ -1825,13 +1811,13 @@ interface RecordingData {
     contextChanges: ContextChange[];
     checkpoints: CheckpointEntry[];
 }
-/** Written to disk so `record stop` (separate process) can signal the recorder. */
 interface RecordingControlFile {
     pid: number;
     startedAt: string;
     startUrl: string;
     sessionName: string;
 }
+
 declare class SessionRecorder {
     private context;
     private page;

package/dist/index.js

@@ -81,8 +81,8 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-UZQYMXR5.js";
-import "./chunk-N4PIGZDG.js";
+} from "./chunk-JLSKMNMN.js";
+import "./chunk-WI3XE4W3.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   errMsg
@@ -2718,7 +2718,7 @@ async function discoverUrls(page, baseUrl, options) {
 `);
   const basePath = new URL(baseUrl).pathname;
   let filtered = Array.from(allUrls).filter(
-    (u) => isSameDomain(u, baseHostname, options.includeSubdomains ?? false) && isWithinPathScope(u, basePath)
+    (u) => options.allowExternalLinks || isSameDomain(u, baseHostname, options.includeSubdomains ?? false) && isWithinPathScope(u, basePath)
   );
   filtered = deduplicateUrls(filtered);
   if (options.search) {
@@ -2739,6 +2739,7 @@ var mapCommand = registerCommand({
     search: z16.string().optional(),
     sitemap: z16.enum(["include", "only"]).optional(),
     includeSubdomains: z16.boolean().optional(),
+    allowExternalLinks: z16.boolean().optional().describe("Include links to external domains"),
     limit: z16.number().optional(),
     verbose: z16.boolean().default(false).describe("Show progress feedback")
   }),
@@ -2748,6 +2749,7 @@ var mapCommand = registerCommand({
       const links = await discoverUrls(page, p.url, {
         sitemap: p.sitemap,
         includeSubdomains: p.includeSubdomains,
+        allowExternalLinks: p.allowExternalLinks,
         limit: p.limit,
         search: p.search,
         verbose: p.verbose
@@ -5209,8 +5211,23 @@ async function waitForPage(page, input) {
       return { success: true, matched: "selector", timeout, elapsed: Date.now() - startedAt };
     }
     if (input.text) {
-      await page.getByText(input.text).first().waitFor({ state: "visible", timeout });
-      return { success: true, matched: "text", timeout, elapsed: Date.now() - startedAt };
+      const textToFind = input.text;
+      const matched = await pollUntil(timeout, pollInterval, async () => {
+        return page.evaluate((text) => {
+          const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT);
+          while (walker.nextNode()) {
+            if (walker.currentNode.textContent?.includes(text)) return true;
+          }
+          return false;
+        }, textToFind);
+      });
+      return {
+        success: matched,
+        matched: "text",
+        timeout,
+        elapsed: Date.now() - startedAt,
+        ...matched ? {} : { message: `Timed out waiting for text: ${input.text}` }
+      };
     }
     if (input.url) {
       const matched = await pollUntil(timeout, pollInterval, async () => matchUrlPattern(page.url(), input.url));
@@ -7378,7 +7395,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-WMQRPYXX.js");
+    const { findTargetPage } = await import("./browser-MPMDAGZY.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.`);
@@ -12748,7 +12765,7 @@ async function routeCommand(argvIn, stdinCommands) {
       const possibleCmd = argv[0].substring(0, spaceIdx);
       if (/^[a-zA-Z][\w-]*$/.test(possibleCmd)) {
         const remainder = argv[0].substring(spaceIdx + 1);
-        if (remainder.startsWith("--") || remainder.includes(" --") && !remainder.match(/^\w+:\/\//)) {
+        if (remainder.includes("--")) {
           const remainderParts = remainder.split(/\s+/).filter(Boolean);
           argv = [possibleCmd, ...remainderParts, ...argv.slice(1)];
         } else {
@@ -16151,7 +16168,7 @@ var DataCollector = class {
     return results;
   }
   async createBrowserContext() {
-    const { launch } = await import("./cdp-driver-72HOBP4C.js");
+    const { launch } = await import("./cdp-driver-RCRYKHVQ.js");
     const { browser } = await launch({
       headless: true,
       args: ["--no-sandbox", "--disable-setuid-sandbox"]

package/dist/{session-replayer-JIVFXVUL.js → session-replayer-X3S47AA3.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-72HOBP4C.js");
+      const { launch } = await import("./cdp-driver-RCRYKHVQ.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.4.2",
+  "version": "1.4.3",
   "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": {
@@ -122,6 +122,6 @@
     ]
   },
   "optionalDependencies": {
-    "undici": "^7.25.0"
+    "undici": "^7.28.0"
   }
 }