browser-debugger-cli 0.0.1-alpha.0 → 0.1.0-alpha.1

package/dist/utils/url/safeParseUrl.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Safe URL parsing utilities with automatic protocol detection.
+ *
+ * Provides centralized URL parsing that gracefully handles:
+ * - Missing protocols (adds http://)
+ * - Malformed URLs (returns null)
+ * - Localhost and bare hostnames
+ *
+ * WHY: Eliminates duplicated try/catch blocks across 4+ files
+ * (filters.ts, url.ts, collectors, connection layer).
+ */
+/**
+ * Safely parse a URL string with automatic protocol detection.
+ *
+ * Attempts to parse the URL in two passes:
+ * 1. As-is (supports full URLs with protocols)
+ * 2. With 'http://' prefix (supports localhost:3000, example.com, etc.)
+ *
+ * @param input - URL string to parse (may lack protocol)
+ * @returns Parsed URL object, or null if parsing fails both attempts
+ *
+ * @example
+ * ```typescript
+ * safeParseUrl('https://example.com')       // → URL { ... }
+ * safeParseUrl('localhost:3000')            // → URL { protocol: 'http:', ... }
+ * safeParseUrl('example.com/path')          // → URL { protocol: 'http:', ... }
+ * safeParseUrl('not a url')                 // → null
+ * safeParseUrl('file:///path/to/file.html') // → URL { protocol: 'file:', ... }
+ * ```
+ */
+export declare function safeParseUrl(input: string): URL | null;
+/**
+ * Extract hostname from a URL string safely.
+ *
+ * @param input - URL string to extract hostname from
+ * @returns Hostname (e.g., 'example.com'), or original input if parsing fails
+ *
+ * @example
+ * ```typescript
+ * extractHostname('https://example.com/path') // → 'example.com'
+ * extractHostname('localhost:3000')           // → 'localhost'
+ * extractHostname('invalid')                  // → 'invalid'
+ * ```
+ */
+export declare function extractHostname(input: string): string;
+/**
+ * Extract hostname with pathname from a URL string safely.
+ *
+ * Useful for pattern matching that needs both hostname and path segments.
+ *
+ * @param input - URL string to extract hostname+pathname from
+ * @returns Hostname with pathname (e.g., 'example.com/api/users'), or original input if parsing fails
+ *
+ * @example
+ * ```typescript
+ * extractHostnameWithPath('https://api.example.com/v1/users?id=123')
+ *   // → 'api.example.com/v1/users'
+ * extractHostnameWithPath('localhost:3000/dashboard')
+ *   // → 'localhost/dashboard'
+ * ```
+ */
+export declare function extractHostnameWithPath(input: string): string;
+//# sourceMappingURL=safeParseUrl.d.ts.map

package/dist/utils/url/safeParseUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeParseUrl.d.ts","sourceRoot":"","sources":["../../../src/utils/url/safeParseUrl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAatD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG7D"}

package/dist/utils/url/safeParseUrl.js

@@ -0,0 +1,84 @@
+/**
+ * Safe URL parsing utilities with automatic protocol detection.
+ *
+ * Provides centralized URL parsing that gracefully handles:
+ * - Missing protocols (adds http://)
+ * - Malformed URLs (returns null)
+ * - Localhost and bare hostnames
+ *
+ * WHY: Eliminates duplicated try/catch blocks across 4+ files
+ * (filters.ts, url.ts, collectors, connection layer).
+ */
+/**
+ * Safely parse a URL string with automatic protocol detection.
+ *
+ * Attempts to parse the URL in two passes:
+ * 1. As-is (supports full URLs with protocols)
+ * 2. With 'http://' prefix (supports localhost:3000, example.com, etc.)
+ *
+ * @param input - URL string to parse (may lack protocol)
+ * @returns Parsed URL object, or null if parsing fails both attempts
+ *
+ * @example
+ * ```typescript
+ * safeParseUrl('https://example.com')       // → URL { ... }
+ * safeParseUrl('localhost:3000')            // → URL { protocol: 'http:', ... }
+ * safeParseUrl('example.com/path')          // → URL { protocol: 'http:', ... }
+ * safeParseUrl('not a url')                 // → null
+ * safeParseUrl('file:///path/to/file.html') // → URL { protocol: 'file:', ... }
+ * ```
+ */
+export function safeParseUrl(input) {
+    // First attempt: parse as-is (handles full URLs with protocols)
+    try {
+        return new URL(input);
+    }
+    catch {
+        // Second attempt: add http:// prefix for protocol-less URLs
+        try {
+            return new URL(`http://${input}`);
+        }
+        catch {
+            // Both attempts failed - invalid URL
+            return null;
+        }
+    }
+}
+/**
+ * Extract hostname from a URL string safely.
+ *
+ * @param input - URL string to extract hostname from
+ * @returns Hostname (e.g., 'example.com'), or original input if parsing fails
+ *
+ * @example
+ * ```typescript
+ * extractHostname('https://example.com/path') // → 'example.com'
+ * extractHostname('localhost:3000')           // → 'localhost'
+ * extractHostname('invalid')                  // → 'invalid'
+ * ```
+ */
+export function extractHostname(input) {
+    const parsed = safeParseUrl(input);
+    return parsed?.hostname ?? input;
+}
+/**
+ * Extract hostname with pathname from a URL string safely.
+ *
+ * Useful for pattern matching that needs both hostname and path segments.
+ *
+ * @param input - URL string to extract hostname+pathname from
+ * @returns Hostname with pathname (e.g., 'example.com/api/users'), or original input if parsing fails
+ *
+ * @example
+ * ```typescript
+ * extractHostnameWithPath('https://api.example.com/v1/users?id=123')
+ *   // → 'api.example.com/v1/users'
+ * extractHostnameWithPath('localhost:3000/dashboard')
+ *   // → 'localhost/dashboard'
+ * ```
+ */
+export function extractHostnameWithPath(input) {
+    const parsed = safeParseUrl(input);
+    return parsed ? parsed.hostname + parsed.pathname : input;
+}
+//# sourceMappingURL=safeParseUrl.js.map

package/dist/utils/url/safeParseUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeParseUrl.js","sourceRoot":"","sources":["../../../src/utils/url/safeParseUrl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,gEAAgE;IAChE,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,4DAA4D;QAC5D,IAAI,CAAC;YACH,OAAO,IAAI,GAAG,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,MAAM,EAAE,QAAQ,IAAI,KAAK,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;AAC5D,CAAC"}

package/dist/utils/url.d.ts

@@ -1,6 +1,68 @@
 /**
- * Normalize a URL by adding http:// protocol if missing
+ * Normalize a URL by adding http:// protocol if missing.
+ *
  * Supports: localhost:3000, example.com, http://localhost, file:// URLs
+ * Preserves special browser protocols: about:, chrome:, data:, javascript:, blob:
+ *
+ * @param url - URL string to normalize
+ * @returns Normalized URL with protocol
+ *
+ * @example
+ * ```typescript
+ * normalizeUrl('localhost:3000')      // → 'http://localhost:3000'
+ * normalizeUrl('https://example.com') // → 'https://example.com'
+ * normalizeUrl('example.com/path')    // → 'http://example.com/path'
+ * normalizeUrl('about:blank')         // → 'about:blank' (unchanged)
+ * normalizeUrl('chrome://settings')   // → 'chrome://settings' (unchanged)
+ * ```
  */
 export declare function normalizeUrl(url: string): string;
+/**
+ * Truncate a URL for compact display.
+ *
+ * Removes www. prefix, shortens long paths with ellipsis, and truncates to maxLength.
+ *
+ * @param url - URL string to truncate
+ * @param maxLength - Maximum length of output (default: 60)
+ * @returns Truncated URL for display
+ *
+ * @example
+ * ```typescript
+ * truncateUrl('https://i.clarity.ms/collect')
+ *   // → 'clarity.ms/collect'
+ * truncateUrl('https://aswpapius.com/api/web-channels/47d7def8-d602-49ec-bfdb-c959b1346774')
+ *   // → 'aswpapius.com/.../47d7def8'
+ * ```
+ */
+export declare function truncateUrl(url: string, maxLength?: number): string;
+/**
+ * Truncate console message text (especially stack traces)
+ * @param text - The console message text
+ * @param maxLines - Maximum number of lines to show (default: 3)
+ */
+export declare function truncateText(text: string, maxLines?: number): string;
+/**
+ * Validate that a URL is valid and usable for Chrome navigation.
+ *
+ * WHY: Provides clear error messages before attempting to launch Chrome.
+ *
+ * @param url - URL string to validate
+ * @returns Object with valid flag and error message if invalid
+ *
+ * @example
+ * ```typescript
+ * const result = validateUrl('not-a-url');
+ * if (!result.valid) {
+ *   console.error(result.error);
+ *   // → "Invalid URL format: 'not-a-url'"
+ *   console.error(result.suggestion);
+ *   // → "URLs must include a valid protocol (http:// or https://)"
+ * }
+ * ```
+ */
+export declare function validateUrl(url: string): {
+    valid: boolean;
+    error?: string;
+    suggestion?: string;
+};
 //# sourceMappingURL=url.d.ts.map

package/dist/utils/url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKhD"}
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAgBhD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,GAAE,MAAW,GAAG,MAAM,CAuCvE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAWvE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CA4CA"}

package/dist/utils/url.js

@@ -1,11 +1,161 @@
+import { safeParseUrl } from './url/safeParseUrl.js';
 /**
- * Normalize a URL by adding http:// protocol if missing
+ * Normalize a URL by adding http:// protocol if missing.
+ *
  * Supports: localhost:3000, example.com, http://localhost, file:// URLs
+ * Preserves special browser protocols: about:, chrome:, data:, javascript:, blob:
+ *
+ * @param url - URL string to normalize
+ * @returns Normalized URL with protocol
+ *
+ * @example
+ * ```typescript
+ * normalizeUrl('localhost:3000')      // → 'http://localhost:3000'
+ * normalizeUrl('https://example.com') // → 'https://example.com'
+ * normalizeUrl('example.com/path')    // → 'http://example.com/path'
+ * normalizeUrl('about:blank')         // → 'about:blank' (unchanged)
+ * normalizeUrl('chrome://settings')   // → 'chrome://settings' (unchanged)
+ * ```
  */
 export function normalizeUrl(url) {
-    if (url.startsWith('http://') || url.startsWith('https://') || url.startsWith('file://')) {
+    // Check for protocols that should not be modified
+    if (url.startsWith('http://') ||
+        url.startsWith('https://') ||
+        url.startsWith('file://') ||
+        url.startsWith('about:') ||
+        url.startsWith('chrome:') ||
+        url.startsWith('data:') ||
+        url.startsWith('javascript:') ||
+        url.startsWith('vbscript:') ||
+        url.startsWith('blob:')) {
         return url;
     }
     return `http://${url}`;
 }
+/**
+ * Truncate a URL for compact display.
+ *
+ * Removes www. prefix, shortens long paths with ellipsis, and truncates to maxLength.
+ *
+ * @param url - URL string to truncate
+ * @param maxLength - Maximum length of output (default: 60)
+ * @returns Truncated URL for display
+ *
+ * @example
+ * ```typescript
+ * truncateUrl('https://i.clarity.ms/collect')
+ *   // → 'clarity.ms/collect'
+ * truncateUrl('https://aswpapius.com/api/web-channels/47d7def8-d602-49ec-bfdb-c959b1346774')
+ *   // → 'aswpapius.com/.../47d7def8'
+ * ```
+ */
+export function truncateUrl(url, maxLength = 60) {
+    const parsed = safeParseUrl(url);
+    if (!parsed) {
+        // Fallback: simple string truncation if URL parsing fails
+        return url.length > maxLength ? url.substring(0, maxLength - 3) + '...' : url;
+    }
+    // Remove www. prefix
+    const domain = parsed.hostname.replace(/^www\./, '');
+    // Get path without leading slash
+    const path = parsed.pathname.substring(1);
+    // Start with domain + path
+    let result = domain + (path ? `/${path}` : '');
+    // If still too long, truncate the path
+    if (result.length > maxLength) {
+        const pathParts = path.split('/');
+        if (pathParts.length > 2) {
+            // Show first part, ellipsis, and last part
+            const first = pathParts[0];
+            const last = pathParts[pathParts.length - 1];
+            if (first && last) {
+                result = `${domain}/${first}/.../${last}`;
+                // If still too long, truncate the last part
+                if (result.length > maxLength) {
+                    const truncatedLast = last.substring(0, 8);
+                    result = `${domain}/${first}/.../${truncatedLast}`;
+                }
+            }
+        }
+        else {
+            // Simple truncation
+            result = result.substring(0, maxLength - 3) + '...';
+        }
+    }
+    return result;
+}
+/**
+ * Truncate console message text (especially stack traces)
+ * @param text - The console message text
+ * @param maxLines - Maximum number of lines to show (default: 3)
+ */
+export function truncateText(text, maxLines = 3) {
+    const lines = text.split('\n');
+    if (lines.length <= maxLines) {
+        return text;
+    }
+    const truncated = lines.slice(0, maxLines).join('\n');
+    const hiddenCount = lines.length - maxLines;
+    return `${truncated}\n  ... (${hiddenCount} more lines)`;
+}
+/**
+ * Validate that a URL is valid and usable for Chrome navigation.
+ *
+ * WHY: Provides clear error messages before attempting to launch Chrome.
+ *
+ * @param url - URL string to validate
+ * @returns Object with valid flag and error message if invalid
+ *
+ * @example
+ * ```typescript
+ * const result = validateUrl('not-a-url');
+ * if (!result.valid) {
+ *   console.error(result.error);
+ *   // → "Invalid URL format: 'not-a-url'"
+ *   console.error(result.suggestion);
+ *   // → "URLs must include a valid protocol (http:// or https://)"
+ * }
+ * ```
+ */
+export function validateUrl(url) {
+    // Empty URL
+    if (!url || url.trim().length === 0) {
+        return {
+            valid: false,
+            error: 'URL cannot be empty',
+            suggestion: 'Provide a valid URL, e.g.: http://localhost:3000',
+        };
+    }
+    // Normalize first (adds http:// if missing)
+    const normalized = normalizeUrl(url);
+    // Try to parse as URL
+    try {
+        const parsed = new URL(normalized);
+        // Check for valid protocol
+        const validProtocols = ['http:', 'https:', 'file:', 'about:', 'chrome:', 'data:'];
+        if (!validProtocols.includes(parsed.protocol)) {
+            return {
+                valid: false,
+                error: `Invalid protocol: '${parsed.protocol}'`,
+                suggestion: 'URLs must use http://, https://, or other valid protocols',
+            };
+        }
+        // Check for valid hostname (for http/https)
+        if ((parsed.protocol === 'http:' || parsed.protocol === 'https:') && !parsed.hostname) {
+            return {
+                valid: false,
+                error: `Invalid URL format: '${url}' (missing hostname)`,
+                suggestion: 'URLs must include a valid hostname, e.g.: http://example.com',
+            };
+        }
+        return { valid: true };
+    }
+    catch {
+        return {
+            valid: false,
+            error: `Invalid URL format: '${url}'`,
+            suggestion: 'URLs must include a valid protocol (http:// or https://)',
+        };
+    }
+}
 //# sourceMappingURL=url.js.map

package/dist/utils/url.js.map

@@ -1 +1 @@
-{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACzF,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,UAAU,GAAG,EAAE,CAAC;AACzB,CAAC"}
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"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"}

package/dist/utils/validation.d.ts

@@ -1,4 +1,4 @@
-import { CollectorType } from '../types.js';
+import type { CollectorType } from '../types.js';
 /**
  * Validate that a collector type is valid
  * @throws Error if collector type is invalid

package/dist/utils/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5C;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,IAAI,aAAa,CAMjF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,EAAE,CAIxF"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7C;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,IAAI,aAAa,CAMjF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,EAAE,CAIxF"}

package/dist/utils/version.d.ts

@@ -0,0 +1,3 @@
+export declare function getVersion(): string;
+export declare const VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/utils/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAUA,wBAAgB,UAAU,IAAI,MAAM,CAiBnC;AAED,eAAO,MAAM,OAAO,EAAE,MAAqB,CAAC"}

package/dist/utils/version.js

@@ -0,0 +1,27 @@
+import { readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+/**
+ * Get the package version.
+ * Reads package.json once and caches the result.
+ */
+let cachedVersion = '';
+export function getVersion() {
+    if (cachedVersion) {
+        return cachedVersion;
+    }
+    try {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = dirname(__filename);
+        const pkgPath = join(__dirname, '../../package.json');
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+        cachedVersion = pkg.version ?? '0.0.0';
+    }
+    catch {
+        // Fallback if package.json cannot be read
+        cachedVersion = '0.0.0';
+    }
+    return cachedVersion;
+}
+export const VERSION = getVersion();
+//# sourceMappingURL=version.js.map

package/dist/utils/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC;;;GAGG;AACH,IAAI,aAAa,GAAW,EAAE,CAAC;AAE/B,MAAM,UAAU,UAAU;IACxB,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAyB,CAAC;QAC/E,aAAa,GAAG,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;QAC1C,aAAa,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAW,UAAU,EAAE,CAAC"}

package/package.json

@@ -1,16 +1,36 @@
 {
   "name": "browser-debugger-cli",
-  "version": "0.0.1-alpha.0",
+  "version": "0.1.0-alpha.1",
   "description": "Browser telemetry via Chrome DevTools Protocol",
   "type": "module",
   "bin": {
     "bdg": "dist/index.js"
   },
   "scripts": {
-    "build": "tsc",
-    "dev": "tsc && node dist/index.js",
-    "watch": "tsc --watch",
-    "prepublishOnly": "npm run build"
+    "build": "tsc && tsc-alias",
+    "postbuild": "node -e \"require('fs').chmodSync('dist/index.js', 0o755)\"",
+    "dev": "tsc && tsc-alias && node dist/index.js",
+    "watch": "concurrently \"npm:watch:tsc\" \"npm:watch:alias\"",
+    "watch:tsc": "tsc --watch",
+    "watch:alias": "tsc-alias --watch",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"*.{js,json}\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"*.{js,json}\"",
+    "knip": "knip",
+    "knip:production": "knip --production",
+    "clean": "rm -rf dist",
+    "rebuild": "npm run clean && npm run build",
+    "lint:imports": "echo '✓ Import paths checked by main lint'",
+    "validate:module-type": "node -e \"const pkg = require('./package.json'); if (pkg.type !== 'module') { console.error('Package must have type: module'); process.exit(1); } else { console.log('✅ Package type is module'); }\"",
+    "validate:ts-version": "node -e \"const ts = require('typescript'); const v = ts.version.split('.'); if (parseInt(v[0]) < 5 || (parseInt(v[0]) === 5 && parseInt(v[1]) < 6)) { console.error('Requires TypeScript 5.6+, found:', ts.version); process.exit(1); } else { console.log('✅ TypeScript version:', ts.version); }\"",
+    "check": "npm run format:check && npm run type-check && npm run lint",
+    "check:enhanced": "npm run format:check && npm run type-check && npm run lint && npm run validate:module-type && npm run validate:ts-version",
+    "test": "tsx --test src/**/__tests__/*.test.ts src/**/__tests__/*.contract.test.ts src/__tests__/integration/*.test.ts",
+    "test:watch": "tsx --test --watch src/**/__tests__/*.test.ts src/**/__tests__/*.contract.test.ts src/__tests__/integration/*.test.ts",
+    "prepublishOnly": "npm run build",
+    "prepare": "husky"
   },
   "keywords": [
     "cdp",
@@ -23,16 +43,34 @@
   "license": "MIT",
   "dependencies": {
     "chrome-launcher": "^1.2.1",
-    "commander": "^12.1.0",
+    "commander": "^14.0.2",
     "ws": "^8.18.0"
   },
   "devDependencies": {
-    "@types/node": "^20.0.0",
+    "@eslint/js": "^9.39.0",
+    "@types/node": "^22.19.0",
     "@types/ws": "^8.5.10",
+    "@typescript-eslint/eslint-plugin": "^8.46.2",
+    "@typescript-eslint/parser": "^8.46.2",
+    "concurrently": "^9.2.1",
+    "eslint": "^9.39.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-no-relative-import-paths": "^1.6.1",
+    "eslint-plugin-tsdoc": "^0.4.0",
+    "eslint-plugin-unused-imports": "^4.3.0",
+    "globals": "^16.5.0",
+    "husky": "^9.1.7",
+    "knip": "^5.67.1",
+    "lint-staged": "^16.2.6",
+    "prettier": "^3.6.2",
+    "tsc-alias": "^1.8.9",
+    "tsx": "^4.19.0",
     "typescript": "^5.6.0"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "author": {
     "name": "Kumak",
@@ -40,7 +78,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/szymdzum/browser-debugger-cli.git"
+    "url": "git+https://github.com/szymdzum/browser-debugger-cli.git"
   },
   "homepage": "https://github.com/szymdzum/browser-debugger-cli#readme",
   "bugs": {
@@ -52,5 +90,14 @@
   "files": [
     "dist",
     "README.md"
-  ]
+  ],
+  "lint-staged": {
+    "src/**/*.ts": [
+      "prettier --write",
+      "eslint --fix"
+    ],
+    "*.{js,json}": [
+      "prettier --write"
+    ]
+  }
 }

package/dist/utils/pageLoad.d.ts

@@ -1,21 +0,0 @@
-import { CDPConnection } from '../connection/cdp.js';
-export interface PageLoadOptions {
-    /**
-     * Maximum time to wait for page load (ms)
-     * @default 30000
-     */
-    timeout?: number;
-    /**
-     * Time to wait with no network activity before considering page idle (ms)
-     * @default 2000
-     */
-    networkIdleTime?: number;
-}
-/**
- * Waits for the page to fully load including:
- * - DOM content loaded
- * - Load event fired
- * - Network idle (no new requests for specified time)
- */
-export declare function waitForPageLoad(cdp: CDPConnection, options?: PageLoadOptions): Promise<void>;
-//# sourceMappingURL=pageLoad.d.ts.map

package/dist/utils/pageLoad.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pageLoad.d.ts","sourceRoot":"","sources":["../../src/utils/pageLoad.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,aAAa,EAClB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CA0Ff"}