browser-debugger-cli 0.1.0 → 0.2.0

package/dist/session/process.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/session/process.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CASnD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,OAAmB,GAAG,IAAI,CAmCvF"}
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/session/process.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CASnD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,OAAmB,GAAG,IAAI,CAmCvF"}

package/dist/session/process.js

@@ -4,6 +4,7 @@
  * WHY: Centralized cross-platform process operations for session management.
  */
 import { spawnSync } from 'child_process';
+import { taskkillStderr, taskkillFailedError } from '../ui/messages/internal.js';
 /**
  * Check if a process with the given PID is alive.
  *
@@ -70,13 +71,13 @@ export function killChromeProcess(pid, signal = 'SIGTERM') {
         // - 0: Success
         // - 128: Process not found
         // - 1: Access denied or other error
-        if (result.status !== 0) {
+        if (result.status !== 0 && result.status !== null) {
             const errorMsg = (result.stderr ?? result.stdout).trim() || 'Unknown error';
-            throw new Error(`taskkill failed (exit code ${result.status}): ${errorMsg}`);
+            throw new Error(taskkillFailedError(result.status, errorMsg));
         }
         // Log stderr for debugging (taskkill sometimes writes to stderr even on success)
         if (result.stderr?.trim()) {
-            console.error(`taskkill stderr: ${result.stderr.trim()}`);
+            console.error(taskkillStderr(result.stderr.trim()));
         }
     }
     else {

package/dist/session/process.js.map

@@ -1 +1 @@
-{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/session/process.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC;QACH,8EAA8E;QAC9E,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,SAAyB,SAAS;IAC/E,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;IAE/C,IAAI,SAAS,EAAE,CAAC;QACd,6CAA6C;QAC7C,0CAA0C;QAC1C,MAAM,MAAM,GAAG,SAAS,CAAC,iBAAiB,GAAG,QAAQ,EAAE;YACrD,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;QAEH,mDAAmD;QACnD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,MAAM,CAAC,KAAK,CAAC;QACrB,CAAC;QAED,2DAA2D;QAC3D,qBAAqB;QACrB,eAAe;QACf,2BAA2B;QAC3B,oCAAoC;QACpC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,IAAI,eAAe,CAAC;YAC5E,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,CAAC,MAAM,MAAM,QAAQ,EAAE,CAAC,CAAC;QAC/E,CAAC;QAED,iFAAiF;QACjF,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;YAC1B,OAAO,CAAC,KAAK,CAAC,oBAAoB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;SAAM,CAAC;QACN,gDAAgD;QAChD,4CAA4C;QAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC"}
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/session/process.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC;QACH,8EAA8E;QAC9E,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,SAAyB,SAAS;IAC/E,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;IAE/C,IAAI,SAAS,EAAE,CAAC;QACd,6CAA6C;QAC7C,0CAA0C;QAC1C,MAAM,MAAM,GAAG,SAAS,CAAC,iBAAiB,GAAG,QAAQ,EAAE;YACrD,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;QAEH,mDAAmD;QACnD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,MAAM,CAAC,KAAK,CAAC;QACrB,CAAC;QAED,2DAA2D;QAC3D,qBAAqB;QACrB,eAAe;QACf,2BAA2B;QAC3B,oCAAoC;QACpC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAClD,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,IAAI,eAAe,CAAC;YAC5E,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;QAChE,CAAC;QAED,iFAAiF;QACjF,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;YAC1B,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;SAAM,CAAC;QACN,gDAAgD;QAChD,4CAA4C;QAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC"}

package/dist/session/queryCache.d.ts

@@ -0,0 +1,36 @@
+/**
+ * DOM query cache structure
+ * Stores results from last DOM query for index-based lookups
+ */
+export interface DomQueryCache {
+    selector: string;
+    timestamp: string;
+    sessionId?: string;
+    nodes: Array<{
+        index: number;
+        nodeId: number;
+        tag?: string;
+        classes?: string[];
+        preview?: string;
+    }>;
+}
+/**
+ * Write DOM query results to cache
+ *
+ * @param cache - DOM query cache data to write
+ */
+export declare function writeQueryCache(cache: DomQueryCache): void;
+/**
+ * Read DOM query cache
+ *
+ * @returns DOM query cache or null if not available/expired
+ */
+export declare function readQueryCache(): DomQueryCache | null;
+/**
+ * Get nodeId from cache by index
+ *
+ * @param index - Index from query results (1-based)
+ * @returns nodeId if found, null otherwise
+ */
+export declare function getNodeIdByIndex(index: number): number | null;
+//# sourceMappingURL=queryCache.d.ts.map

package/dist/session/queryCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryCache.d.ts","sourceRoot":"","sources":["../../src/session/queryCache.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAOD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAQ1D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,aAAa,GAAG,IAAI,CA0BrD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ7D"}

package/dist/session/queryCache.js

@@ -0,0 +1,66 @@
+import fs from 'fs';
+import { getDomQueryCachePath } from '../session/paths.js';
+import { domCacheWriteWarning } from '../ui/messages/internal.js';
+import { getErrorMessage } from '../utils/errors.js';
+/**
+ * Cache expiration time (5 minutes)
+ */
+const CACHE_EXPIRY_MS = 5 * 60 * 1000;
+/**
+ * Write DOM query results to cache
+ *
+ * @param cache - DOM query cache data to write
+ */
+export function writeQueryCache(cache) {
+    try {
+        const cachePath = getDomQueryCachePath();
+        fs.writeFileSync(cachePath, JSON.stringify(cache, null, 2), 'utf8');
+    }
+    catch (error) {
+        // Silently fail - cache is optional and non-critical for CLI operation
+        console.error(domCacheWriteWarning(getErrorMessage(error)));
+    }
+}
+/**
+ * Read DOM query cache
+ *
+ * @returns DOM query cache or null if not available/expired
+ */
+export function readQueryCache() {
+    try {
+        const cachePath = getDomQueryCachePath();
+        if (!fs.existsSync(cachePath)) {
+            return null;
+        }
+        const data = fs.readFileSync(cachePath, 'utf8');
+        const cache = JSON.parse(data);
+        // Check if cache is expired
+        const cacheTime = new Date(cache.timestamp).getTime();
+        const now = Date.now();
+        if (now - cacheTime > CACHE_EXPIRY_MS) {
+            // Cache expired - delete it
+            fs.unlinkSync(cachePath);
+            return null;
+        }
+        return cache;
+    }
+    catch {
+        // Silently fail - cache is optional, missing/corrupt cache doesn't affect core functionality
+        return null;
+    }
+}
+/**
+ * Get nodeId from cache by index
+ *
+ * @param index - Index from query results (1-based)
+ * @returns nodeId if found, null otherwise
+ */
+export function getNodeIdByIndex(index) {
+    const cache = readQueryCache();
+    if (!cache) {
+        return null;
+    }
+    const node = cache.nodes.find((n) => n.index === index);
+    return node?.nodeId ?? null;
+}
+//# sourceMappingURL=queryCache.js.map

package/dist/session/queryCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryCache.js","sourceRoot":"","sources":["../../src/session/queryCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAmBpD;;GAEG;AACH,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAEtC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAoB;IAClD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;QACzC,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,uEAAuE;QACvE,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;QAEzC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAkB,CAAC;QAEhD,4BAA4B;QAC5B,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,IAAI,GAAG,GAAG,SAAS,GAAG,eAAe,EAAE,CAAC;YACtC,4BAA4B;YAC5B,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,6FAA6F;QAC7F,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;IAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IACxD,OAAO,IAAI,EAAE,MAAM,IAAI,IAAI,CAAC;AAC9B,CAAC"}

package/dist/telemetry/__tests__/network.contract.test.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Network telemetry contract tests
+ *
+ * Tests the public API behavior of startNetworkCollection WITHOUT testing implementation details.
+ * Follows the testing philosophy: "Test the contract, not the implementation"
+ *
+ * Coverage:
+ * 1. Request/response pairing - Normal flow with matching IDs
+ * 2. Out-of-order events - Response arrives before request
+ * 3. Stale requests - Incomplete requests after timeout
+ * 4. Failed requests - Network.loadingFailed events
+ * 5. Request limits - MAX_NETWORK_REQUESTS enforcement
+ * 6. Cleanup - Handler removal and state cleanup
+ * 7. Domain filtering - Tracking/analytics exclusion
+ * 8. Body fetching - Size limits and MIME type handling
+ *
+ * What we test:
+ * ✅ Behavior: Given CDP events → expect NetworkRequest array contents
+ * ✅ Invariants: "Requests are paired with responses", "Cleanup removes all handlers"
+ * ✅ Edge cases: Out-of-order, stale, limits, failures
+ *
+ * What we DON'T test:
+ * ❌ Internal requestMap structure
+ * ❌ Internal function calls (tryExactMatch, normalizeUrl, etc.)
+ * ❌ Implementation details (Map vs Set, event handler IDs)
+ */
+export {};
+//# sourceMappingURL=network.contract.test.d.ts.map

package/dist/telemetry/__tests__/network.contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.contract.test.d.ts","sourceRoot":"","sources":["../../../src/telemetry/__tests__/network.contract.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG"}