browser-debugger-cli 0.0.1-alpha.0

package/dist/utils/session.d.ts

@@ -0,0 +1,104 @@
+import { BdgOutput } from '../types.js';
+/**
+ * Get the session directory path (~/.bdg)
+ */
+export declare function getSessionDir(): string;
+/**
+ * Ensure the session directory exists
+ */
+export declare function ensureSessionDir(): void;
+/**
+ * Get the path to the PID file
+ */
+export declare function getPidFilePath(): string;
+/**
+ * Get the path to the output JSON file
+ */
+export declare function getOutputFilePath(): string;
+/**
+ * Get the path to the session lock file
+ */
+export declare function getLockFilePath(): string;
+/**
+ * Get the path to the session metadata file
+ */
+export declare function getMetadataFilePath(): string;
+/**
+ * Session metadata stored alongside PID
+ */
+export interface SessionMetadata {
+    bdgPid: number;
+    chromePid?: number;
+    startTime: number;
+    port: number;
+    targetId?: string;
+    webSocketDebuggerUrl?: string;
+}
+/**
+ * Write the current process PID to the session file atomically
+ *
+ * @param pid - Process ID to write
+ */
+export declare function writePid(pid: number): void;
+/**
+ * Read the PID from the session file
+ *
+ * @returns The PID if file exists and is valid, null otherwise
+ */
+export declare function readPid(): number | null;
+/**
+ * Check if a process with the given PID is alive
+ *
+ * @param pid - Process ID to check
+ * @returns True if process is running, false otherwise
+ */
+export declare function isProcessAlive(pid: number): boolean;
+/**
+ * Remove the PID file
+ */
+export declare function cleanupPidFile(): void;
+/**
+ * Write session output to the JSON file
+ *
+ * @param output - The BdgOutput data to write
+ */
+export declare function writeSessionOutput(output: BdgOutput): void;
+/**
+ * Read session output from the JSON file
+ *
+ * @returns The BdgOutput data if file exists and is valid, null otherwise
+ */
+export declare function readSessionOutput(): BdgOutput | null;
+/**
+ * Acquire session lock atomically.
+ *
+ * Uses exclusive file creation (wx flag) to ensure only one session can run.
+ *
+ * @returns True if lock was acquired, false if another session is running
+ */
+export declare function acquireSessionLock(): boolean;
+/**
+ * Release session lock.
+ *
+ * Removes the lock file to allow other sessions to start.
+ */
+export declare function releaseSessionLock(): void;
+/**
+ * Write session metadata.
+ *
+ * @param metadata - Session metadata to write
+ */
+export declare function writeSessionMetadata(metadata: SessionMetadata): void;
+/**
+ * Read session metadata.
+ *
+ * @returns Session metadata if file exists and is valid, null otherwise
+ */
+export declare function readSessionMetadata(): SessionMetadata | null;
+/**
+ * Cleanup all session files.
+ *
+ * Removes PID, lock, metadata, and output files.
+ */
+export declare function cleanupSession(): void;
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/utils/session.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAKvC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAQ1C;AAED;;;;GAIG;AACH,wBAAgB,OAAO,IAAI,MAAM,GAAG,IAAI,CAmBvC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CASnD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAUrC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAI1D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,SAAS,GAAG,IAAI,CAapD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAmC5C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAUzC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAIpE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,eAAe,GAAG,IAAI,CAa5D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAYrC"}

package/dist/utils/session.js

@@ -0,0 +1,244 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+/**
+ * Get the session directory path (~/.bdg)
+ */
+export function getSessionDir() {
+    return path.join(os.homedir(), '.bdg');
+}
+/**
+ * Ensure the session directory exists
+ */
+export function ensureSessionDir() {
+    const dir = getSessionDir();
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+/**
+ * Get the path to the PID file
+ */
+export function getPidFilePath() {
+    return path.join(getSessionDir(), 'session.pid');
+}
+/**
+ * Get the path to the output JSON file
+ */
+export function getOutputFilePath() {
+    return path.join(getSessionDir(), 'session.json');
+}
+/**
+ * Get the path to the session lock file
+ */
+export function getLockFilePath() {
+    return path.join(getSessionDir(), 'session.lock');
+}
+/**
+ * Get the path to the session metadata file
+ */
+export function getMetadataFilePath() {
+    return path.join(getSessionDir(), 'session.meta.json');
+}
+/**
+ * Write the current process PID to the session file atomically
+ *
+ * @param pid - Process ID to write
+ */
+export function writePid(pid) {
+    ensureSessionDir();
+    const pidPath = getPidFilePath();
+    const tmpPath = pidPath + '.tmp';
+    // Write to temp file first, then rename for atomicity
+    fs.writeFileSync(tmpPath, pid.toString(), 'utf-8');
+    fs.renameSync(tmpPath, pidPath);
+}
+/**
+ * Read the PID from the session file
+ *
+ * @returns The PID if file exists and is valid, null otherwise
+ */
+export function readPid() {
+    const pidPath = getPidFilePath();
+    if (!fs.existsSync(pidPath)) {
+        return null;
+    }
+    try {
+        const pidStr = fs.readFileSync(pidPath, 'utf-8').trim();
+        const pid = parseInt(pidStr, 10);
+        if (isNaN(pid)) {
+            return null;
+        }
+        return pid;
+    }
+    catch (error) {
+        return null;
+    }
+}
+/**
+ * Check if a process with the given PID is alive
+ *
+ * @param pid - Process ID to check
+ * @returns True if process is running, false otherwise
+ */
+export function isProcessAlive(pid) {
+    try {
+        // Sending signal 0 checks if process exists without actually sending a signal
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        // ESRCH error means process doesn't exist
+        return false;
+    }
+}
+/**
+ * Remove the PID file
+ */
+export function cleanupPidFile() {
+    const pidPath = getPidFilePath();
+    if (fs.existsSync(pidPath)) {
+        try {
+            fs.unlinkSync(pidPath);
+        }
+        catch (error) {
+            // Ignore errors during cleanup
+        }
+    }
+}
+/**
+ * Write session output to the JSON file
+ *
+ * @param output - The BdgOutput data to write
+ */
+export function writeSessionOutput(output) {
+    ensureSessionDir();
+    const outputPath = getOutputFilePath();
+    fs.writeFileSync(outputPath, JSON.stringify(output, null, 2), 'utf-8');
+}
+/**
+ * Read session output from the JSON file
+ *
+ * @returns The BdgOutput data if file exists and is valid, null otherwise
+ */
+export function readSessionOutput() {
+    const outputPath = getOutputFilePath();
+    if (!fs.existsSync(outputPath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(outputPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        return null;
+    }
+}
+/**
+ * Acquire session lock atomically.
+ *
+ * Uses exclusive file creation (wx flag) to ensure only one session can run.
+ *
+ * @returns True if lock was acquired, false if another session is running
+ */
+export function acquireSessionLock() {
+    ensureSessionDir();
+    const lockPath = getLockFilePath();
+    try {
+        // 'wx' flag creates file exclusively - fails if exists
+        fs.writeFileSync(lockPath, process.pid.toString(), { flag: 'wx' });
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'EEXIST') {
+            // Lock file exists - check if process is still alive
+            try {
+                const lockPidStr = fs.readFileSync(lockPath, 'utf-8').trim();
+                const lockPid = parseInt(lockPidStr, 10);
+                if (!isNaN(lockPid) && isProcessAlive(lockPid)) {
+                    // Lock is held by active process
+                    return false;
+                }
+                else {
+                    // Stale lock file - remove it and try again
+                    fs.unlinkSync(lockPath);
+                    return acquireSessionLock();
+                }
+            }
+            catch {
+                // Can't read lock file - assume it's stale
+                try {
+                    fs.unlinkSync(lockPath);
+                    return acquireSessionLock();
+                }
+                catch {
+                    return false;
+                }
+            }
+        }
+        return false;
+    }
+}
+/**
+ * Release session lock.
+ *
+ * Removes the lock file to allow other sessions to start.
+ */
+export function releaseSessionLock() {
+    const lockPath = getLockFilePath();
+    try {
+        if (fs.existsSync(lockPath)) {
+            fs.unlinkSync(lockPath);
+        }
+    }
+    catch (error) {
+        // Ignore errors during cleanup
+    }
+}
+/**
+ * Write session metadata.
+ *
+ * @param metadata - Session metadata to write
+ */
+export function writeSessionMetadata(metadata) {
+    ensureSessionDir();
+    const metaPath = getMetadataFilePath();
+    fs.writeFileSync(metaPath, JSON.stringify(metadata, null, 2), 'utf-8');
+}
+/**
+ * Read session metadata.
+ *
+ * @returns Session metadata if file exists and is valid, null otherwise
+ */
+export function readSessionMetadata() {
+    const metaPath = getMetadataFilePath();
+    if (!fs.existsSync(metaPath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(metaPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        return null;
+    }
+}
+/**
+ * Cleanup all session files.
+ *
+ * Removes PID, lock, metadata, and output files.
+ */
+export function cleanupSession() {
+    cleanupPidFile();
+    releaseSessionLock();
+    const metaPath = getMetadataFilePath();
+    if (fs.existsSync(metaPath)) {
+        try {
+            fs.unlinkSync(metaPath);
+        }
+        catch (error) {
+            // Ignore errors
+        }
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/utils/session.js.map

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

package/dist/utils/url.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Normalize a URL by adding http:// protocol if missing
+ * Supports: localhost:3000, example.com, http://localhost, file:// URLs
+ */
+export declare function normalizeUrl(url: string): string;
+//# sourceMappingURL=url.d.ts.map

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

@@ -0,0 +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"}

package/dist/utils/url.js

@@ -0,0 +1,11 @@
+/**
+ * Normalize a URL by adding http:// protocol if missing
+ * Supports: localhost:3000, example.com, http://localhost, file:// URLs
+ */
+export function normalizeUrl(url) {
+    if (url.startsWith('http://') || url.startsWith('https://') || url.startsWith('file://')) {
+        return url;
+    }
+    return `http://${url}`;
+}
+//# sourceMappingURL=url.js.map

package/dist/utils/url.js.map

@@ -0,0 +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"}

package/dist/utils/validation.d.ts

@@ -0,0 +1,12 @@
+import { CollectorType } from '../types.js';
+/**
+ * Validate that a collector type is valid
+ * @throws Error if collector type is invalid
+ */
+export declare function validateCollectorType(type: string): asserts type is CollectorType;
+/**
+ * Validate an array of collector types
+ * @throws Error if any collector type is invalid
+ */
+export declare function validateCollectorTypes(types: string[]): asserts types is CollectorType[];
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +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"}

package/dist/utils/validation.js

@@ -0,0 +1,20 @@
+const VALID_COLLECTORS = ['dom', 'network', 'console'];
+/**
+ * Validate that a collector type is valid
+ * @throws Error if collector type is invalid
+ */
+export function validateCollectorType(type) {
+    if (!VALID_COLLECTORS.includes(type)) {
+        throw new Error(`Invalid collector type: "${type}". Valid types are: ${VALID_COLLECTORS.join(', ')}`);
+    }
+}
+/**
+ * Validate an array of collector types
+ * @throws Error if any collector type is invalid
+ */
+export function validateCollectorTypes(types) {
+    for (const type of types) {
+        validateCollectorType(type);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAEA,MAAM,gBAAgB,GAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAExE;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAqB,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CACb,4BAA4B,IAAI,uBAAuB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAe;IACpD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "browser-debugger-cli",
+  "version": "0.0.1-alpha.0",
+  "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"
+  },
+  "keywords": [
+    "cdp",
+    "chrome-devtools-protocol",
+    "browser",
+    "telemetry",
+    "cli",
+    "devtools"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "chrome-launcher": "^1.2.1",
+    "commander": "^12.1.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/ws": "^8.5.10",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "author": {
+    "name": "Kumak",
+    "email": "szymon@kumak.dev"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/szymdzum/browser-debugger-cli.git"
+  },
+  "homepage": "https://github.com/szymdzum/browser-debugger-cli#readme",
+  "bugs": {
+    "url": "https://github.com/szymdzum/browser-debugger-cli/issues"
+  },
+  "publishConfig": {
+    "tag": "alpha"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}