@xbrowser/cli 0.15.0 → 0.15.1

package/dist/cli.js

@@ -10618,6 +10618,22 @@ var HTTPServer = class {
 };
 
 // src/router.ts
+var KNOWN_GLOBAL_OPTIONS = /* @__PURE__ */ new Set([
+  "json",
+  "yaml",
+  "session",
+  "cdp",
+  "cdp-endpoint",
+  "version",
+  "v",
+  "help",
+  "h",
+  "target",
+  "port",
+  "token",
+  "timeout",
+  "headless"
+]);
 function showCommandHelp(siteName, cmd, siteConfig, mode) {
   const c = cmd;
   if (mode === "json") {
@@ -10766,6 +10782,23 @@ async function routeCommand(argv, stdinCommands) {
   }
   const parsed = parseArgs(argv);
   const { positional, options } = parsed;
+  const command = positional[0];
+  const cmdArgs = positional.slice(1);
+  const isPluginCommand = command ? !allBuiltins.find((b) => b.name === command) && !getCommand(command) && command !== "help" : false;
+  if (!isPluginCommand && command) {
+    const unknownOptions = Object.keys(options).filter((k) => !KNOWN_GLOBAL_OPTIONS.has(k));
+    if (unknownOptions.length > 0) {
+      const unknown = unknownOptions.map((k) => `--${k}`).join(", ");
+      outputError(
+        `Unknown option: ${unknown}
+Did you mean to use a global flag? Global flags must come BEFORE the command:
+  \u2717  xbrowser goto <url> --cdp-endpoint <endpoint>  (treated as unknown)
+  \u2713  xbrowser --cdp <endpoint> goto <url>           (correct)
+Run "xbrowser --help" to see available global options.`
+      );
+      return;
+    }
+  }
   const mode = options.json ? "json" : options.yaml ? "yaml" : "text";
   const sessionName = options.session || process.env.XBROWSER_SESSION || "default";
   const cdpEndpoint = options.cdp;
@@ -10777,8 +10810,6 @@ async function routeCommand(argv, stdinCommands) {
     showMainHelp();
     return;
   }
-  const command = positional[0];
-  const cmdArgs = positional.slice(1);
   if ((options.help || options.h) && positional.length > 0) {
     const loader = await getPluginLoader();
     const internalLoader = loader.getCore().loader;
@@ -10993,6 +11024,26 @@ Run "xbrowser ${command} --help" to see available commands.`
           const subCmdIdx = pluginNameIdx >= 0 ? argv.indexOf(subCommand, pluginNameIdx + 1) : -1;
           const rawPluginArgs = subCmdIdx >= 0 ? argv.slice(subCmdIdx + 1) : [];
           const params = parsePluginParams(rawPluginArgs, cmdEntry.parameters);
+          if (cmdEntry.parameters) {
+            const schemaAny = cmdEntry.parameters;
+            const def = schemaAny._def;
+            const shapeOrFn = def?.shape ?? schemaAny.shape;
+            const shapeObj = typeof shapeOrFn === "function" ? shapeOrFn() : shapeOrFn;
+            if (shapeObj && typeof shapeObj === "object") {
+              const knownKeys = new Set(Object.keys(shapeObj));
+              knownKeys.add("_target");
+              for (const gk of KNOWN_GLOBAL_OPTIONS) knownKeys.add(gk.replace(/-([a-z])/g, (_, c) => c.toUpperCase()));
+              const unknownKeys = Object.keys(params).filter((k) => !knownKeys.has(k));
+              if (unknownKeys.length > 0) {
+                const unknown = unknownKeys.map((k) => `--${k.replace(/([A-Z])/g, "-$1").toLowerCase()}`).join(", ");
+                outputError(
+                  `Unknown parameter: ${unknown}
+Run "xbrowser ${command} ${subCommand} --help" to see available parameters.`
+                );
+                return;
+              }
+            }
+          }
           if (options.target && !params._target) {
             params._target = options.target;
           }

package/dist/index.js

@@ -10932,6 +10932,22 @@ var HTTPServer = class {
 };
 
 // src/router.ts
+var KNOWN_GLOBAL_OPTIONS = /* @__PURE__ */ new Set([
+  "json",
+  "yaml",
+  "session",
+  "cdp",
+  "cdp-endpoint",
+  "version",
+  "v",
+  "help",
+  "h",
+  "target",
+  "port",
+  "token",
+  "timeout",
+  "headless"
+]);
 function showCommandHelp(siteName, cmd, siteConfig, mode) {
   const c = cmd;
   if (mode === "json") {
@@ -11080,6 +11096,23 @@ async function routeCommand(argv, stdinCommands) {
   }
   const parsed = parseArgs(argv);
   const { positional, options } = parsed;
+  const command = positional[0];
+  const cmdArgs = positional.slice(1);
+  const isPluginCommand = command ? !allBuiltins.find((b) => b.name === command) && !getCommand(command) && command !== "help" : false;
+  if (!isPluginCommand && command) {
+    const unknownOptions = Object.keys(options).filter((k) => !KNOWN_GLOBAL_OPTIONS.has(k));
+    if (unknownOptions.length > 0) {
+      const unknown = unknownOptions.map((k) => `--${k}`).join(", ");
+      outputError(
+        `Unknown option: ${unknown}
+Did you mean to use a global flag? Global flags must come BEFORE the command:
+  \u2717  xbrowser goto <url> --cdp-endpoint <endpoint>  (treated as unknown)
+  \u2713  xbrowser --cdp <endpoint> goto <url>           (correct)
+Run "xbrowser --help" to see available global options.`
+      );
+      return;
+    }
+  }
   const mode = options.json ? "json" : options.yaml ? "yaml" : "text";
   const sessionName = options.session || process.env.XBROWSER_SESSION || "default";
   const cdpEndpoint = options.cdp;
@@ -11091,8 +11124,6 @@ async function routeCommand(argv, stdinCommands) {
     showMainHelp();
     return;
   }
-  const command = positional[0];
-  const cmdArgs = positional.slice(1);
   if ((options.help || options.h) && positional.length > 0) {
     const loader = await getPluginLoader();
     const internalLoader = loader.getCore().loader;
@@ -11307,6 +11338,26 @@ Run "xbrowser ${command} --help" to see available commands.`
           const subCmdIdx = pluginNameIdx >= 0 ? argv.indexOf(subCommand, pluginNameIdx + 1) : -1;
           const rawPluginArgs = subCmdIdx >= 0 ? argv.slice(subCmdIdx + 1) : [];
           const params = parsePluginParams(rawPluginArgs, cmdEntry.parameters);
+          if (cmdEntry.parameters) {
+            const schemaAny = cmdEntry.parameters;
+            const def = schemaAny._def;
+            const shapeOrFn = def?.shape ?? schemaAny.shape;
+            const shapeObj = typeof shapeOrFn === "function" ? shapeOrFn() : shapeOrFn;
+            if (shapeObj && typeof shapeObj === "object") {
+              const knownKeys = new Set(Object.keys(shapeObj));
+              knownKeys.add("_target");
+              for (const gk of KNOWN_GLOBAL_OPTIONS) knownKeys.add(gk.replace(/-([a-z])/g, (_, c) => c.toUpperCase()));
+              const unknownKeys = Object.keys(params).filter((k) => !knownKeys.has(k));
+              if (unknownKeys.length > 0) {
+                const unknown = unknownKeys.map((k) => `--${k.replace(/([A-Z])/g, "-$1").toLowerCase()}`).join(", ");
+                outputError(
+                  `Unknown parameter: ${unknown}
+Run "xbrowser ${command} ${subCommand} --help" to see available parameters.`
+                );
+                return;
+              }
+            }
+          }
           if (options.target && !params._target) {
             params._target = options.target;
           }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xbrowser/cli",
-  "version": "0.15.0",
+  "version": "0.15.1",
   "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": {