browser-debugger-cli 0.5.1 → 0.6.1

package/dist/commands/dom/reactEventHelpers.d.ts

@@ -0,0 +1,80 @@
+/**
+ * React-compatible event handling for form interactions.
+ *
+ * React uses synthetic events and doesn't detect direct DOM manipulation.
+ * This module provides JavaScript snippets that can be injected via Runtime.evaluate
+ * to properly trigger React's event system.
+ */
+/**
+ * JavaScript function to fill an input element in a React-compatible way.
+ *
+ * This approach:
+ * 1. Uses native property setters to bypass React's value tracking
+ * 2. Dispatches input/change events that React listens for
+ * 3. Properly handles focus/blur for form validation
+ *
+ * @remarks
+ * Works with React, Vue, Angular, and vanilla JS applications.
+ */
+export declare const REACT_FILL_SCRIPT = "\n(function(selector, value, options) {\n  const el = document.querySelector(selector);\n  \n  if (!el) {\n    return { \n      success: false, \n      error: 'Element not found',\n      selector: selector\n    };\n  }\n  \n  // Check if element is fillable\n  const tagName = el.tagName.toLowerCase();\n  const inputType = el.type?.toLowerCase();\n  \n  const isFillable = (\n    tagName === 'input' || \n    tagName === 'textarea' || \n    tagName === 'select' ||\n    el.isContentEditable\n  );\n  \n  if (!isFillable) {\n    return {\n      success: false,\n      error: 'Element is not fillable',\n      elementType: tagName,\n      suggestion: 'Only input, textarea, select, and contenteditable elements can be filled'\n    };\n  }\n  \n  // Focus element first\n  el.focus();\n  \n  // Handle different input types\n  if (tagName === 'select') {\n    // For select elements\n    el.value = value;\n    el.dispatchEvent(new Event('change', { bubbles: true }));\n  } else if (inputType === 'checkbox' || inputType === 'radio') {\n    // For checkbox/radio, value should be \"true\" or \"false\"\n    const shouldCheck = value === 'true' || value === true;\n    el.checked = shouldCheck;\n    el.dispatchEvent(new Event('change', { bubbles: true }));\n  } else if (inputType === 'file') {\n    return {\n      success: false,\n      error: 'File inputs require CDP DOM.setFileInputFiles method',\n      suggestion: 'Use: bdg cdp DOM.setFileInputFiles --params {\\\"files\\\":[\\\"path\\\"]}'\n    };\n  } else if (el.isContentEditable) {\n    // For contenteditable elements\n    el.textContent = value;\n    el.dispatchEvent(new Event('input', { bubbles: true }));\n  } else {\n    // For text inputs, use native setter (React compatibility)\n    const nativeInputValueSetter = Object.getOwnPropertyDescriptor(\n      window.HTMLInputElement.prototype,\n      'value'\n    )?.set;\n    \n    const nativeTextAreaValueSetter = Object.getOwnPropertyDescriptor(\n      window.HTMLTextAreaElement.prototype,\n      'value'\n    )?.set;\n    \n    const setter = tagName === 'textarea' \n      ? nativeTextAreaValueSetter \n      : nativeInputValueSetter;\n    \n    if (setter) {\n      setter.call(el, value);\n    } else {\n      el.value = value;\n    }\n    \n    // Dispatch events that React/Vue/Angular listen for\n    el.dispatchEvent(new Event('input', { bubbles: true }));\n    el.dispatchEvent(new Event('change', { bubbles: true }));\n  }\n  \n  // Blur if requested (triggers validation in many forms)\n  if (options.blur !== false) {\n    el.blur();\n    // Dispatch focusout event for React/framework validation handlers\n    el.dispatchEvent(new FocusEvent('focusout', { bubbles: true }));\n  }\n  \n  return {\n    success: true,\n    selector: selector,\n    value: el.value || el.textContent,\n    elementType: tagName,\n    inputType: inputType || null,\n    checked: el.checked || undefined\n  };\n})\n";
+/**
+ * JavaScript function to click an element.
+ *
+ * @remarks
+ * Simple click implementation that works with buttons, links, and custom components.
+ * When selector matches multiple elements, prioritizes visible ones.
+ */
+export declare const CLICK_ELEMENT_SCRIPT = "\n(function(selector) {\n  let el = document.querySelector(selector);\n  \n  // If not found, return error\n  if (!el) {\n    return {\n      success: false,\n      error: 'Element not found',\n      selector: selector\n    };\n  }\n  \n  // Check if there are multiple matches and pick the visible one\n  const allMatches = document.querySelectorAll(selector);\n  if (allMatches.length > 1) {\n    // Find first visible element using bounding rect and computed styles\n    for (const candidate of allMatches) {\n      const style = window.getComputedStyle(candidate);\n      const rect = candidate.getBoundingClientRect();\n      \n      // Check if element is actually visible:\n      // - Must have dimensions (non-zero width/height)\n      // - Must not be display:none or visibility:hidden\n      // - Opacity check (but allow semi-transparent elements)\n      // - offsetParent check (but position:fixed elements have null offsetParent, so also check position)\n      const hasSize = rect.width > 0 && rect.height > 0;\n      const isDisplayed = style.display !== 'none' && style.visibility !== 'hidden';\n      const isOpaque = parseFloat(style.opacity) > 0;\n      const isPositioned = candidate.offsetParent !== null || style.position === 'fixed';\n      \n      // Don't filter out elements without text - icon buttons, inputs, etc. are valid\n      const isVisible = hasSize && isDisplayed && isOpaque && isPositioned;\n      \n      if (isVisible) {\n        el = candidate;\n        break;\n      }\n    }\n  }\n  \n  // Check if element is clickable (has click handler or is a button/link)\n  const tagName = el.tagName.toLowerCase();\n  const isClickable = (\n    tagName === 'button' ||\n    tagName === 'a' ||\n    tagName === 'input' ||\n    el.onclick !== null ||\n    el.getAttribute('role') === 'button' ||\n    window.getComputedStyle(el).cursor === 'pointer'\n  );\n  \n  if (!isClickable) {\n    console.warn('Warning: Element may not be clickable:', el);\n  }\n  \n  // Scroll element into view first\n  el.scrollIntoView({ behavior: 'auto', block: 'center' });\n  \n  // Click the element\n  el.click();\n  \n  return {\n    success: true,\n    selector: selector,\n    elementType: tagName,\n    clickable: isClickable\n  };\n})\n";
+/**
+ * JavaScript function to get multiple elements by selector.
+ *
+ * @remarks
+ * Used when --index is specified to select from multiple matches.
+ */
+export declare const GET_ELEMENT_BY_INDEX_SCRIPT = "\n(function(selector, index) {\n  const elements = document.querySelectorAll(selector);\n  \n  if (elements.length === 0) {\n    return {\n      success: false,\n      error: 'No elements found',\n      selector: selector,\n      matchCount: 0\n    };\n  }\n  \n  if (index < 1 || index > elements.length) {\n    return {\n      success: false,\n      error: 'Index out of range',\n      selector: selector,\n      matchCount: elements.length,\n      requestedIndex: index,\n      suggestion: `Use --index between 1 and ${elements.length}`\n    };\n  }\n  \n  // Return element info (we'll use this to build a more specific selector)\n  const el = elements[index - 1]; // Convert to 0-based\n  \n  // Build a truly unique selector by constructing a scoped DOM path\n  function buildUniquePath(element: Element): string {\n    // If element has an ID, that's unique enough\n    if (element.id) {\n      return `#${CSS.escape(element.id)}`;\n    }\n    \n    // Build path from root using nth-of-type for each ancestor\n    const path: string[] = [];\n    let current: Element | null = element;\n    \n    while (current && current !== document.documentElement) {\n      let selector = current.tagName.toLowerCase();\n      \n      // Use nth-of-type to ensure uniqueness within parent\n      if (current.parentElement) {\n        const siblings = Array.from(current.parentElement.children);\n        const sameTagSiblings = siblings.filter(\n          (sibling) => sibling.tagName === current!.tagName\n        );\n        \n        if (sameTagSiblings.length > 1) {\n          const index = sameTagSiblings.indexOf(current) + 1;\n          selector += `:nth-of-type(${index})`;\n        }\n      }\n      \n      path.unshift(selector);\n      current = current.parentElement;\n    }\n    \n    // Prefix with html to anchor to document root\n    return 'html > ' + path.join(' > ');\n  }\n  \n  const uniqueSelector = buildUniquePath(el);\n  \n  return {\n    success: true,\n    selector: selector,\n    matchCount: elements.length,\n    selectedIndex: index,\n    uniqueSelector: uniqueSelector\n  };\n})\n";
+/**
+ * Options for filling an element.
+ */
+export interface FillOptions {
+    /** Whether to blur the element after filling (default: true) */
+    blur?: boolean;
+    /** Index to use if selector matches multiple elements (1-based) */
+    index?: number;
+}
+/**
+ * Result of filling an element.
+ */
+export interface FillResult {
+    success: boolean;
+    error?: string;
+    selector?: string;
+    value?: string;
+    elementType?: string;
+    inputType?: string | null;
+    checked?: boolean;
+    suggestion?: string;
+}
+/**
+ * Result of clicking an element.
+ */
+export interface ClickResult {
+    success: boolean;
+    error?: string;
+    selector?: string;
+    elementType?: string;
+    clickable?: boolean;
+}
+/**
+ * Result of getting element by index.
+ */
+export interface ElementByIndexResult {
+    success: boolean;
+    error?: string;
+    selector?: string;
+    matchCount?: number;
+    selectedIndex?: number;
+    requestedIndex?: number;
+    uniqueSelector?: string;
+    suggestion?: string;
+}
+//# sourceMappingURL=reactEventHelpers.d.ts.map

package/dist/commands/dom/reactEventHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactEventHelpers.d.ts","sourceRoot":"","sources":["../../../src/commands/dom/reactEventHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,i3FAkG7B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,stEAqEhC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,kkEAwEvC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gEAAgE;IAChE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/commands/dom/reactEventHelpers.js

@@ -0,0 +1,274 @@
+/**
+ * React-compatible event handling for form interactions.
+ *
+ * React uses synthetic events and doesn't detect direct DOM manipulation.
+ * This module provides JavaScript snippets that can be injected via Runtime.evaluate
+ * to properly trigger React's event system.
+ */
+/**
+ * JavaScript function to fill an input element in a React-compatible way.
+ *
+ * This approach:
+ * 1. Uses native property setters to bypass React's value tracking
+ * 2. Dispatches input/change events that React listens for
+ * 3. Properly handles focus/blur for form validation
+ *
+ * @remarks
+ * Works with React, Vue, Angular, and vanilla JS applications.
+ */
+export const REACT_FILL_SCRIPT = `
+(function(selector, value, options) {
+  const el = document.querySelector(selector);
+  
+  if (!el) {
+    return { 
+      success: false, 
+      error: 'Element not found',
+      selector: selector
+    };
+  }
+  
+  // Check if element is fillable
+  const tagName = el.tagName.toLowerCase();
+  const inputType = el.type?.toLowerCase();
+  
+  const isFillable = (
+    tagName === 'input' || 
+    tagName === 'textarea' || 
+    tagName === 'select' ||
+    el.isContentEditable
+  );
+  
+  if (!isFillable) {
+    return {
+      success: false,
+      error: 'Element is not fillable',
+      elementType: tagName,
+      suggestion: 'Only input, textarea, select, and contenteditable elements can be filled'
+    };
+  }
+  
+  // Focus element first
+  el.focus();
+  
+  // Handle different input types
+  if (tagName === 'select') {
+    // For select elements
+    el.value = value;
+    el.dispatchEvent(new Event('change', { bubbles: true }));
+  } else if (inputType === 'checkbox' || inputType === 'radio') {
+    // For checkbox/radio, value should be "true" or "false"
+    const shouldCheck = value === 'true' || value === true;
+    el.checked = shouldCheck;
+    el.dispatchEvent(new Event('change', { bubbles: true }));
+  } else if (inputType === 'file') {
+    return {
+      success: false,
+      error: 'File inputs require CDP DOM.setFileInputFiles method',
+      suggestion: 'Use: bdg cdp DOM.setFileInputFiles --params {\\"files\\":[\\"path\\"]}'
+    };
+  } else if (el.isContentEditable) {
+    // For contenteditable elements
+    el.textContent = value;
+    el.dispatchEvent(new Event('input', { bubbles: true }));
+  } else {
+    // For text inputs, use native setter (React compatibility)
+    const nativeInputValueSetter = Object.getOwnPropertyDescriptor(
+      window.HTMLInputElement.prototype,
+      'value'
+    )?.set;
+    
+    const nativeTextAreaValueSetter = Object.getOwnPropertyDescriptor(
+      window.HTMLTextAreaElement.prototype,
+      'value'
+    )?.set;
+    
+    const setter = tagName === 'textarea' 
+      ? nativeTextAreaValueSetter 
+      : nativeInputValueSetter;
+    
+    if (setter) {
+      setter.call(el, value);
+    } else {
+      el.value = value;
+    }
+    
+    // Dispatch events that React/Vue/Angular listen for
+    el.dispatchEvent(new Event('input', { bubbles: true }));
+    el.dispatchEvent(new Event('change', { bubbles: true }));
+  }
+  
+  // Blur if requested (triggers validation in many forms)
+  if (options.blur !== false) {
+    el.blur();
+    // Dispatch focusout event for React/framework validation handlers
+    el.dispatchEvent(new FocusEvent('focusout', { bubbles: true }));
+  }
+  
+  return {
+    success: true,
+    selector: selector,
+    value: el.value || el.textContent,
+    elementType: tagName,
+    inputType: inputType || null,
+    checked: el.checked || undefined
+  };
+})
+`;
+/**
+ * JavaScript function to click an element.
+ *
+ * @remarks
+ * Simple click implementation that works with buttons, links, and custom components.
+ * When selector matches multiple elements, prioritizes visible ones.
+ */
+export const CLICK_ELEMENT_SCRIPT = `
+(function(selector) {
+  let el = document.querySelector(selector);
+  
+  // If not found, return error
+  if (!el) {
+    return {
+      success: false,
+      error: 'Element not found',
+      selector: selector
+    };
+  }
+  
+  // Check if there are multiple matches and pick the visible one
+  const allMatches = document.querySelectorAll(selector);
+  if (allMatches.length > 1) {
+    // Find first visible element using bounding rect and computed styles
+    for (const candidate of allMatches) {
+      const style = window.getComputedStyle(candidate);
+      const rect = candidate.getBoundingClientRect();
+      
+      // Check if element is actually visible:
+      // - Must have dimensions (non-zero width/height)
+      // - Must not be display:none or visibility:hidden
+      // - Opacity check (but allow semi-transparent elements)
+      // - offsetParent check (but position:fixed elements have null offsetParent, so also check position)
+      const hasSize = rect.width > 0 && rect.height > 0;
+      const isDisplayed = style.display !== 'none' && style.visibility !== 'hidden';
+      const isOpaque = parseFloat(style.opacity) > 0;
+      const isPositioned = candidate.offsetParent !== null || style.position === 'fixed';
+      
+      // Don't filter out elements without text - icon buttons, inputs, etc. are valid
+      const isVisible = hasSize && isDisplayed && isOpaque && isPositioned;
+      
+      if (isVisible) {
+        el = candidate;
+        break;
+      }
+    }
+  }
+  
+  // Check if element is clickable (has click handler or is a button/link)
+  const tagName = el.tagName.toLowerCase();
+  const isClickable = (
+    tagName === 'button' ||
+    tagName === 'a' ||
+    tagName === 'input' ||
+    el.onclick !== null ||
+    el.getAttribute('role') === 'button' ||
+    window.getComputedStyle(el).cursor === 'pointer'
+  );
+  
+  if (!isClickable) {
+    console.warn('Warning: Element may not be clickable:', el);
+  }
+  
+  // Scroll element into view first
+  el.scrollIntoView({ behavior: 'auto', block: 'center' });
+  
+  // Click the element
+  el.click();
+  
+  return {
+    success: true,
+    selector: selector,
+    elementType: tagName,
+    clickable: isClickable
+  };
+})
+`;
+/**
+ * JavaScript function to get multiple elements by selector.
+ *
+ * @remarks
+ * Used when --index is specified to select from multiple matches.
+ */
+export const GET_ELEMENT_BY_INDEX_SCRIPT = `
+(function(selector, index) {
+  const elements = document.querySelectorAll(selector);
+  
+  if (elements.length === 0) {
+    return {
+      success: false,
+      error: 'No elements found',
+      selector: selector,
+      matchCount: 0
+    };
+  }
+  
+  if (index < 1 || index > elements.length) {
+    return {
+      success: false,
+      error: 'Index out of range',
+      selector: selector,
+      matchCount: elements.length,
+      requestedIndex: index,
+      suggestion: \`Use --index between 1 and \${elements.length}\`
+    };
+  }
+  
+  // Return element info (we'll use this to build a more specific selector)
+  const el = elements[index - 1]; // Convert to 0-based
+  
+  // Build a truly unique selector by constructing a scoped DOM path
+  function buildUniquePath(element: Element): string {
+    // If element has an ID, that's unique enough
+    if (element.id) {
+      return \`#\${CSS.escape(element.id)}\`;
+    }
+    
+    // Build path from root using nth-of-type for each ancestor
+    const path: string[] = [];
+    let current: Element | null = element;
+    
+    while (current && current !== document.documentElement) {
+      let selector = current.tagName.toLowerCase();
+      
+      // Use nth-of-type to ensure uniqueness within parent
+      if (current.parentElement) {
+        const siblings = Array.from(current.parentElement.children);
+        const sameTagSiblings = siblings.filter(
+          (sibling) => sibling.tagName === current!.tagName
+        );
+        
+        if (sameTagSiblings.length > 1) {
+          const index = sameTagSiblings.indexOf(current) + 1;
+          selector += \`:nth-of-type(\${index})\`;
+        }
+      }
+      
+      path.unshift(selector);
+      current = current.parentElement;
+    }
+    
+    // Prefix with html to anchor to document root
+    return 'html > ' + path.join(' > ');
+  }
+  
+  const uniqueSelector = buildUniquePath(el);
+  
+  return {
+    success: true,
+    selector: selector,
+    matchCount: elements.length,
+    selectedIndex: index,
+    uniqueSelector: uniqueSelector
+  };
+})
+`;
+//# sourceMappingURL=reactEventHelpers.js.map

package/dist/commands/dom/reactEventHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactEventHelpers.js","sourceRoot":"","sources":["../../../src/commands/dom/reactEventHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkGhC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqEnC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwE1C,CAAC"}

package/dist/commands/network.js

@@ -1,7 +1,7 @@
 import { runCommand } from '../commands/shared/CommandRunner.js';
 import { jsonOption } from '../commands/shared/commonOptions.js';
 import { callCDP } from '../ipc/client.js';
-import { validateIPCResponse } from '../ipc/responseValidator.js';
+import { validateIPCResponse } from '../ipc/index.js';
 import { formatCookies } from '../ui/formatters/index.js';
 /**
  * Register network commands.

package/dist/commands/network.js.map

@@ -1 +1 @@
-{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/commands/network.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAUzD;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,qCAAqC,CAAC,CAAC;IAEjG,yBAAyB;IACzB,UAAU;SACP,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,oCAAoC,CAAC;SACjD,MAAM,CAAC,aAAa,EAAE,uBAAuB,CAAC;SAC9C,SAAS,CAAC,UAAU,CAAC;SACrB,MAAM,CAAC,KAAK,EAAE,OAA0B,EAAE,EAAE;QAC3C,MAAM,UAAU,CACd,KAAK,EAAE,IAAI,EAAE,EAAE;YACb,8BAA8B;YAC9B,MAAM,MAAM,GAA4B,EAAE,CAAC;YAC3C,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC9B,CAAC;YAED,8BAA8B;YAC9B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;YAE7D,0CAA0C;YAC1C,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAE9B,oCAAoC;YACpC,MAAM,OAAO,GAAI,QAAQ,CAAC,IAAI,EAAE,MAAiC,EAAE,OAAO,IAAI,EAAE,CAAC;YAEjF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,OAAO;aACd,CAAC;QACJ,CAAC,EACD,OAAO;QACP,2BAA2B;QAC3B,aAAa,CACd,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/commands/network.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAUzD;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,qCAAqC,CAAC,CAAC;IAEjG,yBAAyB;IACzB,UAAU;SACP,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,oCAAoC,CAAC;SACjD,MAAM,CAAC,aAAa,EAAE,uBAAuB,CAAC;SAC9C,SAAS,CAAC,UAAU,CAAC;SACrB,MAAM,CAAC,KAAK,EAAE,OAA0B,EAAE,EAAE;QAC3C,MAAM,UAAU,CACd,KAAK,EAAE,IAAI,EAAE,EAAE;YACb,8BAA8B;YAC9B,MAAM,MAAM,GAA4B,EAAE,CAAC;YAC3C,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC9B,CAAC;YAED,8BAA8B;YAC9B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;YAE7D,0CAA0C;YAC1C,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAE9B,oCAAoC;YACpC,MAAM,OAAO,GAAI,QAAQ,CAAC,IAAI,EAAE,MAAiC,EAAE,OAAO,IAAI,EAAE,CAAC;YAEjF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,OAAO;aACd,CAAC;QACJ,CAAC,EACD,OAAO;QACP,2BAA2B;QAC3B,aAAa,CACd,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/peek.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"peek.d.ts","sourceRoot":"","sources":["../../src/commands/peek.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgCzC;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoG1D"}
+{"version":3,"file":"peek.d.ts","sourceRoot":"","sources":["../../src/commands/peek.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsBzC;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2G1D"}

package/dist/commands/peek.js

@@ -1,30 +1,11 @@
-import { OutputBuilder } from '../commands/shared/OutputBuilder.js';
 import { jsonOption } from '../commands/shared/commonOptions.js';
+import { handleDaemonConnectionError } from '../commands/shared/daemonErrorHandler.js';
+import { positiveIntRule } from '../commands/shared/validation.js';
 import { getPeek } from '../ipc/client.js';
-import { validateIPCResponse } from '../ipc/responseValidator.js';
+import { validateIPCResponse } from '../ipc/index.js';
 import { formatPreview } from '../ui/formatters/preview.js';
-import { invalidLastArgumentError } from '../ui/messages/commands.js';
-import { daemonNotRunningError, noPreviewDataError } from '../ui/messages/errors.js';
 import { followingPreviewMessage, stoppedFollowingPreviewMessage } from '../ui/messages/preview.js';
 import { EXIT_CODES } from '../utils/exitCodes.js';
-/**
- * Handle errors in a consistent way for both follow and one-time modes.
- *
- * @param error - Error message
- * @param options - Preview options
- * @param exitCode - Exit code to use if not in follow mode
- */
-function handlePreviewError(error, options, exitCode) {
-    if (options.json) {
-        console.log(JSON.stringify(OutputBuilder.buildJsonError(error), null, 2));
-    }
-    else {
-        console.error(noPreviewDataError());
-    }
-    if (!options.follow) {
-        process.exit(exitCode);
-    }
-}
 /**
  * Register peek command.
  *
@@ -35,19 +16,23 @@ export function registerPeekCommand(program) {
         .command('peek')
         .description('Preview collected data without stopping the session')
         .addOption(jsonOption)
-        .option('-v, --verbose', 'Use verbose output with full URLs and formatting')
-        .option('-n, --network', 'Show only network requests')
-        .option('-c, --console', 'Show only console messages')
-        .option('-f, --follow', 'Watch for updates (like tail -f)')
-        .option('--last <count>', 'Show last N items', '10')
+        .option('-v, --verbose', 'Use verbose output with full URLs and formatting', false)
+        .option('-n, --network', 'Show only network requests', false)
+        .option('-c, --console', 'Show only console messages', false)
+        .option('-f, --follow', 'Watch for updates (like tail -f)', false)
+        .option('--last <count>', 'Show last N items (network requests + console messages)', '10')
         .action(async (options) => {
-        // Validate --last parameter
-        const lastN = parseInt(options.last ?? '10', 10);
-        if (isNaN(lastN) || lastN < 1 || lastN > 1000) {
-            console.error(invalidLastArgumentError(options.last));
-            process.exit(EXIT_CODES.INVALID_ARGUMENTS);
-        }
-        options.last = lastN.toString();
+        // Validate --last option using validation layer
+        const lastRule = positiveIntRule({ min: 1, max: 1000, default: 10 });
+        const lastN = lastRule.validate(options.last);
+        const previewBase = {
+            json: options.json,
+            network: options.network,
+            console: options.console,
+            last: lastN,
+            verbose: options.verbose,
+            follow: options.follow,
+        };
         const showPreview = async () => {
             try {
                 // Fetch preview data via IPC from daemon
@@ -57,13 +42,34 @@ export function registerPeekCommand(program) {
                     validateIPCResponse(response);
                 }
                 catch {
-                    handlePreviewError(response.error ?? 'Unknown error', options, EXIT_CODES.RESOURCE_NOT_FOUND);
+                    const errorMsg = response.error ?? 'Unknown error';
+                    // No active session - use RESOURCE_NOT_FOUND
+                    const exitCode = errorMsg.includes('No active session')
+                        ? EXIT_CODES.RESOURCE_NOT_FOUND
+                        : EXIT_CODES.SESSION_FILE_ERROR;
+                    const result = handleDaemonConnectionError(errorMsg, {
+                        json: options.json,
+                        follow: options.follow,
+                        retryIntervalMs: 1000,
+                        exitCode,
+                    });
+                    if (result.shouldExit) {
+                        process.exit(result.exitCode);
+                    }
                     return;
                 }
                 // Extract preview data from response
                 const output = response.data?.preview;
                 if (!output) {
-                    handlePreviewError('No preview data in response', options, EXIT_CODES.RESOURCE_NOT_FOUND);
+                    const result = handleDaemonConnectionError('No preview data in response', {
+                        json: options.json,
+                        follow: options.follow,
+                        retryIntervalMs: 1000,
+                        exitCode: EXIT_CODES.SESSION_FILE_ERROR,
+                    });
+                    if (result.shouldExit) {
+                        process.exit(result.exitCode);
+                    }
                     return;
                 }
                 // Clear screen before rendering to prevent stacked outputs in follow mode
@@ -71,24 +77,19 @@ export function registerPeekCommand(program) {
                     console.clear();
                 }
                 // Add current view timestamp for follow mode to show refresh time
-                const previewOptions = options.follow
-                    ? { ...options, viewedAt: new Date() }
-                    : options;
+                const previewOptions = previewBase.follow
+                    ? { ...previewBase, viewedAt: new Date() }
+                    : previewBase;
                 console.log(formatPreview(output, previewOptions));
             }
             catch {
-                // Handle IPC connection errors (daemon not running, etc.)
-                // Note: validateIPCResponse errors are caught above
-                if (options.json) {
-                    console.log(JSON.stringify(OutputBuilder.buildJsonError('Daemon not running', {
-                        suggestion: 'Start it with: bdg <url>',
-                    }), null, 2));
-                }
-                else {
-                    console.error(daemonNotRunningError());
-                }
-                if (!options.follow) {
-                    process.exit(EXIT_CODES.RESOURCE_NOT_FOUND);
+                const result = handleDaemonConnectionError('Daemon not running', {
+                    json: options.json,
+                    follow: options.follow,
+                    retryIntervalMs: 1000,
+                });
+                if (result.shouldExit) {
+                    process.exit(result.exitCode);
                 }
             }
         };

package/dist/commands/peek.js.map

@@ -1 +1 @@
-{"version":3,"file":"peek.js","sourceRoot":"","sources":["../../src/commands/peek.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"peek.js","sourceRoot":"","sources":["../../src/commands/peek.ts"],"names":[],"mappings":"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"}

package/dist/commands/shared/CommandRunner.d.ts

@@ -19,6 +19,8 @@ export interface CommandResult<T = unknown> {
     error?: string;
     /** Optional exit code override (defaults: SUCCESS=0, error codes from EXIT_CODES) */
     exitCode?: number;
+    /** Optional error context (suggestions, examples, etc.) */
+    errorContext?: Record<string, unknown>;
 }
 /**
  * Handler function type.

package/dist/commands/shared/CommandRunner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CommandRunner.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/CommandRunner.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,QAAQ,SAAS,kBAAkB,EAAE,OAAO,GAAG,OAAO,IAAI,CACnF,OAAO,EAAE,QAAQ,KACd,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAErC;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,CAAC,OAAO,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,UAAU,CAAC,QAAQ,SAAS,kBAAkB,EAAE,OAAO,GAAG,OAAO,EACrF,OAAO,EAAE,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,EAC1C,OAAO,EAAE,QAAQ,EACjB,SAAS,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC,CAyEf"}
+{"version":3,"file":"CommandRunner.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/CommandRunner.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,QAAQ,SAAS,kBAAkB,EAAE,OAAO,GAAG,OAAO,IAAI,CACnF,OAAO,EAAE,QAAQ,KACd,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAErC;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,CAAC,OAAO,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,UAAU,CAAC,QAAQ,SAAS,kBAAkB,EAAE,OAAO,GAAG,OAAO,EACrF,OAAO,EAAE,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,EAC1C,OAAO,EAAE,QAAQ,EACjB,SAAS,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC,CAyFf"}

package/dist/commands/shared/CommandRunner.js

@@ -1,5 +1,6 @@
-import { OutputBuilder } from '../../commands/shared/OutputBuilder.js';
-import { CommandError, getErrorMessage, isDaemonConnectionError } from '../../ui/errors/index.js';
+import { getErrorMessage } from '../../connection/errors.js';
+import { OutputBuilder } from '../../ui/OutputBuilder.js';
+import { CommandError, isDaemonConnectionError } from '../../ui/errors/index.js';
 import { daemonNotRunningError, unknownError, genericError } from '../../ui/messages/errors.js';
 import { EXIT_CODES } from '../../utils/exitCodes.js';
 /**
@@ -34,10 +35,22 @@ export async function runCommand(handler, options, formatter) {
         if (!result.success) {
             // Error result from handler
             if (options.json) {
-                console.log(JSON.stringify(OutputBuilder.buildJsonError(result.error ?? 'Unknown error'), null, 2));
+                const errorData = {
+                    ...(result.exitCode !== undefined && { exitCode: result.exitCode }),
+                    ...result.errorContext,
+                };
+                console.log(JSON.stringify(OutputBuilder.buildJsonError(result.error ?? 'Unknown error', errorData), null, 2));
             }
             else {
                 console.error(result.error ? genericError(result.error) : unknownError());
+                // Show errorContext suggestions in human-readable mode
+                if (result.errorContext && typeof result.errorContext === 'object') {
+                    for (const value of Object.values(result.errorContext)) {
+                        if (typeof value === 'string') {
+                            console.error(value);
+                        }
+                    }
+                }
             }
             process.exit(result.exitCode ?? EXIT_CODES.UNHANDLED_EXCEPTION);
         }

package/dist/commands/shared/CommandRunner.js.map

@@ -1 +1 @@
-{"version":3,"file":"CommandRunner.js","sourceRoot":"","sources":["../../../src/commands/shared/CommandRunner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CommandRunner.js","sourceRoot":"","sources":["../../../src/commands/shared/CommandRunner.ts"],"names":[],"mappings":"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"}

package/dist/commands/shared/commonOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commonOptions.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/commonOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAWnC;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,UAAU,QAA6C,CAAC;AAErE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,QAQnB,CAAC;AAEL;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAIzD"}
+{"version":3,"file":"commonOptions.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/commonOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAanC;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,UAAU,QAA4D,CAAC;AAEpF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,QAenB,CAAC;AAEL;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAIzD"}