browser-debugger-cli 0.3.0 → 0.5.1

package/dist/cli/handlers/ChromeBootstrap.js

@@ -0,0 +1,50 @@
+import { launchChrome } from '../../connection/launcher.js';
+/**
+ * Handles Chrome browser launch and connection
+ */
+export class ChromeBootstrap {
+    /**
+     * Launch Chrome if not already running, or connect to existing instance.
+     *
+     * Delegates to chrome-launcher which handles:
+     * - Port availability checking
+     * - Strict mode enforcement (via portStrictMode option)
+     * - Chrome readiness polling
+     * - Reusing existing Chrome instances when port is occupied
+     *
+     * @param port - Chrome debugging port
+     * @param targetUrl - Initial URL to navigate to
+     * @param launchOptions - Chrome launcher options (userDataDir, logLevel, etc.)
+     * @returns LaunchedChrome instance if Chrome was launched, null if already running
+     * @throws Error if chrome-launcher fails to launch or connect
+     */
+    static async launch(port, targetUrl, launchOptions) {
+        // Attempt launch - chrome-launcher handles everything:
+        // - Port availability checking
+        // - Launching new Chrome or reusing existing instance
+        // - Strict mode enforcement (throws if portStrictMode=true and can't connect)
+        // - Chrome readiness polling with retries
+        // Default to headless in CI environments (no display available)
+        // User can override via launchOptions.headless if needed
+        const isCI = process.env['CI'] === 'true' || process.env['CI'] === '1';
+        const headless = launchOptions?.headless ?? (isCI ? true : false);
+        const chrome = await launchChrome({
+            port,
+            headless,
+            url: targetUrl,
+            ...launchOptions,
+        });
+        // chrome-launcher returns a valid LaunchedChrome when successful
+        // PID will be 0 or undefined if reusing an existing Chrome instance
+        const isNewLaunch = chrome.pid && chrome.pid > 0;
+        if (isNewLaunch) {
+            console.error(`Chrome launched (PID: ${chrome.pid})`);
+            return chrome; // Return handle so we can kill it on cleanup
+        }
+        else {
+            console.error(`Chrome already running on port ${port}`);
+            return null; // Don't return handle - we don't own this Chrome instance
+        }
+    }
+}
+//# sourceMappingURL=ChromeBootstrap.js.map

package/dist/cli/handlers/ChromeBootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChromeBootstrap.js","sourceRoot":"","sources":["../../../src/cli/handlers/ChromeBootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAsB,MAAM,0BAA0B,CAAC;AAG5E;;GAEG;AACH,MAAM,OAAO,eAAe;IAC1B;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,IAAY,EACZ,SAAiB,EACjB,aAAsC;QAEtC,uDAAuD;QACvD,+BAA+B;QAC/B,sDAAsD;QACtD,8EAA8E;QAC9E,0CAA0C;QAE1C,gEAAgE;QAChE,yDAAyD;QACzD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC;QACvE,MAAM,QAAQ,GAAG,aAAa,EAAE,QAAQ,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAElE,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;YAChC,IAAI;YACJ,QAAQ;YACR,GAAG,EAAE,SAAS;YACd,GAAG,aAAa;SACjB,CAAC,CAAC;QAEH,iEAAiE;QACjE,oEAAoE;QACpE,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;QACjD,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,yBAAyB,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;YACtD,OAAO,MAAM,CAAC,CAAC,6CAA6C;QAC9D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,kCAAkC,IAAI,EAAE,CAAC,CAAC;YACxD,OAAO,IAAI,CAAC,CAAC,0DAA0D;QACzE,CAAC;IACH,CAAC;CACF"}

package/dist/cli/handlers/OutputBuilder.d.ts

@@ -1,4 +1,4 @@
-import type { BdgOutput, CDPTarget, NetworkRequest, ConsoleMessage, DOMData, CollectorType } from '../../types';
+import type { BdgOutput, CDPTarget, NetworkRequest, ConsoleMessage, DOMData, CollectorType } from '../../types.js';
 /**
  * Output mode determines what data is included and how partial flag is set
  */
@@ -16,8 +16,7 @@ export interface OutputBuilderOptions {
     activeCollectors: CollectorType[];
 }
 /**
- * Helper: build output payloads for different modes with consistent metadata.
- * Modes: preview (metadata only), full (with bodies), final (complete with DOM).
+ * Helper: build output payloads for preview/full/final modes with consistent metadata.
  */
 export declare class OutputBuilder {
     /**

package/dist/cli/handlers/OutputBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OutputBuilder.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/OutputBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,cAAc,EACd,cAAc,EACd,OAAO,EACP,aAAa,EACd,MAAM,SAAS,CAAC;AAIjB;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,aAAa,EAAE,CAAC;CACnC;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS;IA4FtD;;;;;;;OAOG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS;IAYnF;;;;;;;OAOG;IACH,MAAM,CAAC,cAAc,CACnB,KAAK,EAAE,MAAM,GAAG,KAAK,EACrB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GACtD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAS1B;;;;;;OAMG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOhF"}
+{"version":3,"file":"OutputBuilder.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/OutputBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,cAAc,EACd,cAAc,EACd,OAAO,EACP,aAAa,EACd,MAAM,SAAS,CAAC;AAGjB;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,aAAa,EAAE,CAAC;CACnC;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS;IA4FtD;;;;;;;OAOG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS;IAYnF;;;;;;;OAOG;IACH,MAAM,CAAC,cAAc,CACnB,KAAK,EAAE,MAAM,GAAG,KAAK,EACrB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GACtD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAS1B;;;;;;OAMG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOhF"}

package/dist/cli/handlers/OutputBuilder.js

@@ -1,8 +1,6 @@
-import { getErrorMessage } from '../../utils/errors.js';
 import { VERSION } from '../../utils/version.js';
 /**
- * Helper: build output payloads for different modes with consistent metadata.
- * Modes: preview (metadata only), full (with bodies), final (complete with DOM).
+ * Helper: build output payloads for preview/full/final modes with consistent metadata.
  */
 export class OutputBuilder {
     /**
@@ -101,7 +99,7 @@ export class OutputBuilder {
             duration: Date.now() - startTime,
             target: target ? { url: target.url, title: target.title } : { url: '', title: '' },
             data: {},
-            error: getErrorMessage(error),
+            error: error instanceof Error ? error.message : String(error),
         };
     }
     /**

package/dist/cli/handlers/OutputBuilder.js.map

@@ -1 +1 @@
-{"version":3,"file":"OutputBuilder.js","sourceRoot":"","sources":["../../../src/cli/handlers/OutputBuilder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"OutputBuilder.js","sourceRoot":"","sources":["../../../src/cli/handlers/OutputBuilder.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAoB7C;;GAEG;AACH,MAAM,OAAO,aAAa;IACxB;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,OAA6B;QACxC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,EAAE,GACxF,OAAO,CAAC;QAEV,MAAM,UAAU,GAAG;YACjB,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAChC,MAAM,EAAE;gBACN,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB;YACD,kDAAkD;YAClD,OAAO,EAAE,IAAI,KAAK,OAAO;SAC1B,CAAC;QAEF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,sDAAsD;YACtD,MAAM,WAAW,GAA4B,EAAE,CAAC;YAEhD,IAAI,gBAAgB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACzC,WAAW,CAAC,SAAS,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;oBAClE,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,GAAG,EAAE,GAAG,CAAC,GAAG;oBACZ,MAAM,EAAE,GAAG,CAAC,MAAM;oBAClB,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,MAAM,EAAE,GAAG,CAAC,MAAM;oBAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ;oBACtB,qEAAqE;iBACtE,CAAC,CAAC,CAAC;YACN,CAAC;YAED,IAAI,gBAAgB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACzC,WAAW,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;oBAC9D,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,uCAAuC;iBACxC,CAAC,CAAC,CAAC;YACN,CAAC;YAED,iDAAiD;YAEjD,OAAO;gBACL,GAAG,UAAU;gBACb,IAAI,EAAE,WAAW;aAClB,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,uCAAuC;YACvC,MAAM,QAAQ,GAA4B,EAAE,CAAC;YAE7C,IAAI,gBAAgB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACzC,QAAQ,CAAC,SAAS,CAAC,GAAG,eAAe,CAAC,CAAC,uBAAuB;YAChE,CAAC;YAED,IAAI,gBAAgB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACzC,QAAQ,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC,CAAC,qBAAqB;YAC1D,CAAC;YAED,sCAAsC;YAEtC,OAAO;gBACL,GAAG,UAAU;gBACb,IAAI,EAAE,QAAQ;aACf,CAAC;QACJ,CAAC;QAED,2CAA2C;QAC3C,MAAM,SAAS,GAA4B,EAAE,CAAC;QAE9C,IAAI,gBAAgB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,SAAS,CAAC,SAAS,CAAC,GAAG,eAAe,CAAC;QACzC,CAAC;QAED,IAAI,gBAAgB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,SAAS,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC;QACrC,CAAC;QAED,IAAI,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;YAChD,SAAS,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC;QAC7B,CAAC;QAED,OAAO;YACL,GAAG,UAAU;YACb,OAAO,EAAE,KAAK;YACd,IAAI,EAAE,SAAS;SAChB,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,UAAU,CAAC,KAAc,EAAE,SAAiB,EAAE,MAAkB;QACrE,OAAO;YACL,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAChC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;YAClF,IAAI,EAAE,EAAE;YACR,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,cAAc,CACnB,KAAqB,EACrB,OAAuD;QAEvD,OAAO;YACL,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;YACrD,GAAG,OAAO;SACX,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAA6B;QACnD,OAAO;YACL,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,IAAI;YACb,GAAG,IAAI;SACR,CAAC;IACJ,CAAC;CACF"}

package/dist/cli/handlers/OutputWriter.d.ts

@@ -0,0 +1,15 @@
+import type { BdgOutput } from '../../types.js';
+/**
+ * Handles writing session output to files and console
+ */
+export declare class OutputWriter {
+    /**
+     * Write session output to file and stdout.
+     *
+     * @param output - The output payload to write
+     * @param exitCode - 0 for success, 1 for error
+     * @param compact - If true, use compact JSON format (no indentation)
+     */
+    writeSessionOutput(output: BdgOutput, exitCode: 0 | 1, compact?: boolean): void;
+}
+//# sourceMappingURL=OutputWriter.d.ts.map

package/dist/cli/handlers/OutputWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OutputWriter.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/OutputWriter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGzC;;GAEG;AACH,qBAAa,YAAY;IACvB;;;;;;OAMG;IACH,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,GAAE,OAAe,GAAG,IAAI;CAsBvF"}

package/dist/cli/handlers/OutputWriter.js

@@ -0,0 +1,34 @@
+import { writeSessionOutput } from '../../utils/session.js';
+/**
+ * Handles writing session output to files and console
+ */
+export class OutputWriter {
+    /**
+     * Write session output to file and stdout.
+     *
+     * @param output - The output payload to write
+     * @param exitCode - 0 for success, 1 for error
+     * @param compact - If true, use compact JSON format (no indentation)
+     */
+    writeSessionOutput(output, exitCode, compact = false) {
+        // Write output to file for 'bdg stop' to read
+        try {
+            const message = exitCode === 0 ? 'Writing session output...' : 'Writing error output...';
+            console.error(message);
+            writeSessionOutput(output, compact);
+            const successMessage = exitCode === 0
+                ? 'Session output written successfully'
+                : 'Error output written successfully';
+            console.error(successMessage);
+        }
+        catch (writeError) {
+            const errorMessage = exitCode === 0 ? 'Failed to write session output:' : 'Failed to write error output:';
+            console.error(errorMessage, writeError);
+            console.error('Write error details:', writeError);
+        }
+        // Output to stdout (for foreground use)
+        const jsonString = compact ? JSON.stringify(output) : JSON.stringify(output, null, 2);
+        console.log(jsonString);
+    }
+}
+//# sourceMappingURL=OutputWriter.js.map

package/dist/cli/handlers/OutputWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OutputWriter.js","sourceRoot":"","sources":["../../../src/cli/handlers/OutputWriter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD;;GAEG;AACH,MAAM,OAAO,YAAY;IACvB;;;;;;OAMG;IACH,kBAAkB,CAAC,MAAiB,EAAE,QAAe,EAAE,UAAmB,KAAK;QAC7E,8CAA8C;QAC9C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,yBAAyB,CAAC;YACzF,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACvB,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACpC,MAAM,cAAc,GAClB,QAAQ,KAAK,CAAC;gBACZ,CAAC,CAAC,qCAAqC;gBACvC,CAAC,CAAC,mCAAmC,CAAC;YAC1C,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,UAAU,EAAE,CAAC;YACpB,MAAM,YAAY,GAChB,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,+BAA+B,CAAC;YACvF,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;YACxC,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,UAAU,CAAC,CAAC;QACpD,CAAC;QAED,wCAAwC;QACxC,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACtF,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/cli/handlers/PreviewWriter.d.ts

@@ -0,0 +1,52 @@
+import type { CDPTarget, NetworkRequest, ConsoleMessage, CollectorType } from '../../types.js';
+/**
+ * Interface for accessing session data without direct coupling
+ */
+export interface PreviewDataSource {
+    getTarget: () => CDPTarget;
+    getNetworkRequests: () => NetworkRequest[];
+    getConsoleLogs: () => ConsoleMessage[];
+    getActiveCollectors: () => CollectorType[];
+    isConnected: () => boolean;
+}
+/**
+ * Manages two-tier preview system with async I/O and mutex
+ *
+ * Periodically writes both lightweight preview and full data files
+ * to enable efficient monitoring without stopping collection.
+ */
+export declare class PreviewWriter {
+    private dataSource;
+    private startTime;
+    private intervalMs;
+    private compact;
+    private interval;
+    private pendingWrite;
+    private isWriting;
+    constructor(dataSource: PreviewDataSource, startTime: number, intervalMs?: number, compact?: boolean);
+    /**
+     * Start periodic preview writes.
+     */
+    start(): void;
+    /**
+     * Stop preview writes and clear interval.
+     */
+    stop(): void;
+    /**
+     * Wait for any in-flight write to complete.
+     * Called during shutdown to prevent race conditions.
+     */
+    waitForPendingWrite(): Promise<void>;
+    /**
+     * Execute a single preview write cycle (internal)
+     */
+    private writePreview;
+    /**
+     * Perform the actual write operation (internal)
+     *
+     * Passes original arrays for active collectors, empty arrays for inactive ones.
+     * No cloning needed - OutputBuilder serializes immediately, avoiding unnecessary copies.
+     */
+    private doWrite;
+}
+//# sourceMappingURL=PreviewWriter.d.ts.map

package/dist/cli/handlers/PreviewWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreviewWriter.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/PreviewWriter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAKxF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,SAAS,CAAC;IAC3B,kBAAkB,EAAE,MAAM,cAAc,EAAE,CAAC;IAC3C,cAAc,EAAE,MAAM,cAAc,EAAE,CAAC;IACvC,mBAAmB,EAAE,MAAM,aAAa,EAAE,CAAC;IAC3C,WAAW,EAAE,MAAM,OAAO,CAAC;CAC5B;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IAMtB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,OAAO;IARjB,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,SAAS,CAAS;gBAGhB,UAAU,EAAE,iBAAiB,EAC7B,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,MAAa,EACzB,OAAO,GAAE,OAAe;IAGlC;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAY1C;;OAEG;IACH,OAAO,CAAC,YAAY;IAyBpB;;;;;OAKG;YACW,OAAO;CAqCtB"}

package/dist/cli/handlers/PreviewWriter.js

@@ -0,0 +1,118 @@
+import { writePartialOutputAsync, writeFullOutputAsync } from '../../utils/session.js';
+import { OutputBuilder } from './OutputBuilder.js';
+/**
+ * Manages two-tier preview system with async I/O and mutex
+ *
+ * Periodically writes both lightweight preview and full data files
+ * to enable efficient monitoring without stopping collection.
+ */
+export class PreviewWriter {
+    dataSource;
+    startTime;
+    intervalMs;
+    compact;
+    interval = null;
+    pendingWrite = null;
+    isWriting = false;
+    constructor(dataSource, startTime, intervalMs = 5000, compact = false) {
+        this.dataSource = dataSource;
+        this.startTime = startTime;
+        this.intervalMs = intervalMs;
+        this.compact = compact;
+    }
+    /**
+     * Start periodic preview writes.
+     */
+    start() {
+        this.interval = setInterval(() => {
+            this.writePreview();
+        }, this.intervalMs);
+    }
+    /**
+     * Stop preview writes and clear interval.
+     */
+    stop() {
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = null;
+        }
+    }
+    /**
+     * Wait for any in-flight write to complete.
+     * Called during shutdown to prevent race conditions.
+     */
+    async waitForPendingWrite() {
+        if (this.pendingWrite) {
+            console.error('Waiting for in-flight write to complete...');
+            try {
+                await this.pendingWrite;
+                console.error('In-flight write completed');
+            }
+            catch (error) {
+                console.error('Error in pending write (ignoring):', error);
+            }
+        }
+    }
+    /**
+     * Execute a single preview write cycle (internal)
+     */
+    writePreview() {
+        // Skip if previous write in progress or disconnected
+        if (this.isWriting || !this.dataSource.isConnected()) {
+            if (this.isWriting) {
+                console.error('[PERF] Skipping preview write (previous write still in progress)');
+            }
+            return;
+        }
+        this.isWriting = true;
+        // Create and track the write promise so shutdown can await it
+        this.pendingWrite = this.doWrite()
+            .catch((error) => {
+            console.error('Warning: Failed to write preview data:', error instanceof Error ? error.message : String(error));
+        })
+            .finally(() => {
+            this.isWriting = false;
+            this.pendingWrite = null;
+        });
+    }
+    /**
+     * Perform the actual write operation (internal)
+     *
+     * Passes original arrays for active collectors, empty arrays for inactive ones.
+     * No cloning needed - OutputBuilder serializes immediately, avoiding unnecessary copies.
+     */
+    async doWrite() {
+        const target = this.dataSource.getTarget();
+        const activeCollectors = this.dataSource.getActiveCollectors();
+        // Pass original arrays when active, empty arrays when inactive (no cloning needed)
+        const networkRequests = activeCollectors.includes('network')
+            ? this.dataSource.getNetworkRequests()
+            : [];
+        const consoleLogs = activeCollectors.includes('console')
+            ? this.dataSource.getConsoleLogs()
+            : [];
+        // Build both preview and full outputs
+        const previewOutput = OutputBuilder.build({
+            mode: 'preview',
+            target,
+            startTime: this.startTime,
+            networkRequests,
+            consoleLogs,
+            activeCollectors,
+        });
+        const fullOutput = OutputBuilder.build({
+            mode: 'full',
+            target,
+            startTime: this.startTime,
+            networkRequests,
+            consoleLogs,
+            activeCollectors,
+        });
+        // Write both files in parallel (async, non-blocking)
+        await Promise.all([
+            writePartialOutputAsync(previewOutput, this.compact), // ~500KB - for 'bdg peek'
+            writeFullOutputAsync(fullOutput, this.compact), // ~87MB - for 'bdg details'
+        ]);
+    }
+}
+//# sourceMappingURL=PreviewWriter.js.map

package/dist/cli/handlers/PreviewWriter.js.map

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

package/dist/cli/handlers/SessionLock.d.ts

@@ -0,0 +1,16 @@
+import type { CollectorType } from '../../types.js';
+/**
+ * Handles session lock acquisition and validation
+ */
+export declare class SessionLock {
+    /**
+     * Acquire session lock and validate inputs
+     *
+     * @param url - Target URL to monitor
+     * @param collectors - Collector types to enable
+     * @returns Normalized URL
+     * @throws Error if session already running or validation fails
+     */
+    static acquire(url: string, collectors: CollectorType[]): string;
+}
+//# sourceMappingURL=SessionLock.d.ts.map

package/dist/cli/handlers/SessionLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionLock.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/SessionLock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAK7C;;GAEG;AACH,qBAAa,WAAW;IACtB;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,MAAM;CAsBjE"}

package/dist/cli/handlers/SessionLock.js

@@ -0,0 +1,35 @@
+import { readPid, isProcessAlive, cleanupSession, acquireSessionLock } from '../../utils/session.js';
+import { normalizeUrl } from '../../utils/url.js';
+import { validateCollectorTypes } from '../../utils/validation.js';
+/**
+ * Handles session lock acquisition and validation
+ */
+export class SessionLock {
+    /**
+     * Acquire session lock and validate inputs
+     *
+     * @param url - Target URL to monitor
+     * @param collectors - Collector types to enable
+     * @returns Normalized URL
+     * @throws Error if session already running or validation fails
+     */
+    static acquire(url, collectors) {
+        const existingPid = readPid();
+        // Check for stale session before trying to acquire lock
+        if (existingPid && !isProcessAlive(existingPid)) {
+            console.error(`Found stale session (PID ${existingPid} not running)`);
+            console.error('Cleaning up stale session files...');
+            cleanupSession();
+            console.error('Stale session cleaned up');
+        }
+        if (!acquireSessionLock()) {
+            const currentPid = readPid();
+            throw new Error(`Session already running (PID ${currentPid}). Stop it with: bdg stop`);
+        }
+        // Validate collector types
+        validateCollectorTypes(collectors);
+        // Normalize URL - add http:// if no protocol specified
+        return normalizeUrl(url);
+    }
+}
+//# sourceMappingURL=SessionLock.js.map

package/dist/cli/handlers/SessionLock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionLock.js","sourceRoot":"","sources":["../../../src/cli/handlers/SessionLock.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACjG,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D;;GAEG;AACH,MAAM,OAAO,WAAW;IACtB;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,CAAC,GAAW,EAAE,UAA2B;QACrD,MAAM,WAAW,GAAG,OAAO,EAAE,CAAC;QAE9B,wDAAwD;QACxD,IAAI,WAAW,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC;YAChD,OAAO,CAAC,KAAK,CAAC,4BAA4B,WAAW,eAAe,CAAC,CAAC;YACtE,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;YACpD,cAAc,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC;YAC1B,MAAM,UAAU,GAAG,OAAO,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,gCAAgC,UAAU,2BAA2B,CAAC,CAAC;QACzF,CAAC;QAED,2BAA2B;QAC3B,sBAAsB,CAAC,UAAU,CAAC,CAAC;QAEnC,uDAAuD;QACvD,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;CACF"}

package/dist/cli/handlers/SessionLoop.d.ts

@@ -0,0 +1,19 @@
+import type { BdgSession } from '../../session/BdgSession.js';
+import type { CDPTarget } from '../../types.js';
+/**
+ * Manages the session monitoring loop
+ */
+export declare class SessionLoop {
+    /**
+     * Run session loop until stopped or error
+     *
+     * Monitors WebSocket connection and target lifecycle.
+     * Throws error if connection lost or tab closed.
+     *
+     * @param session - Active BDG session instance
+     * @param target - CDP target being monitored
+     * @throws Error if WebSocket connection lost or browser tab closed
+     */
+    static run(session: BdgSession, target: CDPTarget): Promise<void>;
+}
+//# sourceMappingURL=SessionLoop.d.ts.map

package/dist/cli/handlers/SessionLoop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionLoop.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/SessionLoop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAA4B,MAAM,SAAS,CAAC;AAEnE;;GAEG;AACH,qBAAa,WAAW;IACtB;;;;;;;;;OASG;WACU,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CA2CxE"}

package/dist/cli/handlers/SessionLoop.js

@@ -0,0 +1,47 @@
+/**
+ * Manages the session monitoring loop
+ */
+export class SessionLoop {
+    /**
+     * Run session loop until stopped or error
+     *
+     * Monitors WebSocket connection and target lifecycle.
+     * Throws error if connection lost or tab closed.
+     *
+     * @param session - Active BDG session instance
+     * @param target - CDP target being monitored
+     * @throws Error if WebSocket connection lost or browser tab closed
+     */
+    static async run(session, target) {
+        if (!session) {
+            throw new Error('Session not initialized');
+        }
+        const cdp = session.getCDP();
+        const waitForNextCheck = () => new Promise((resolve) => {
+            let timer;
+            let handlerId;
+            const handleTargetDestroyed = (params) => {
+                if (params.targetId === target.id) {
+                    clearTimeout(timer);
+                    cdp.off('Target.targetDestroyed', handlerId);
+                    resolve('destroyed');
+                }
+            };
+            handlerId = cdp.on('Target.targetDestroyed', handleTargetDestroyed);
+            timer = setTimeout(() => {
+                cdp.off('Target.targetDestroyed', handlerId);
+                resolve('continue');
+            }, 2000);
+        });
+        for (;;) {
+            const result = await waitForNextCheck();
+            if (!session.isConnected()) {
+                throw new Error('WebSocket connection lost');
+            }
+            if (result === 'destroyed') {
+                throw new Error('Browser tab was closed');
+            }
+        }
+    }
+}
+//# sourceMappingURL=SessionLoop.js.map

package/dist/cli/handlers/SessionLoop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionLoop.js","sourceRoot":"","sources":["../../../src/cli/handlers/SessionLoop.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,OAAO,WAAW;IACtB;;;;;;;;;OASG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAmB,EAAE,MAAiB;QACrD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAE7B,MAAM,gBAAgB,GAAG,GAAsC,EAAE,CAC/D,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YACtB,IAAI,KAAoC,CAAC;YACzC,IAAI,SAAiB,CAAC;YAEtB,MAAM,qBAAqB,GAAG,CAAC,MAAgC,EAAQ,EAAE;gBACvE,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC;oBAClC,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,GAAG,CAAC,GAAG,CAAC,wBAAwB,EAAE,SAAS,CAAC,CAAC;oBAC7C,OAAO,CAAC,WAAW,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC,CAAC;YAEF,SAAS,GAAG,GAAG,CAAC,EAAE,CAChB,wBAAwB,EACxB,qBAAqB,CACtB,CAAC;YAEF,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACtB,GAAG,CAAC,GAAG,CAAC,wBAAwB,EAAE,SAAS,CAAC,CAAC;gBAC7C,OAAO,CAAC,UAAU,CAAC,CAAC;YACtB,CAAC,EAAE,IAAI,CAAC,CAAC;QACX,CAAC,CAAC,CAAC;QAEL,SAAS,CAAC;YACR,MAAM,MAAM,GAAG,MAAM,gBAAgB,EAAE,CAAC;YAExC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;YAC/C,CAAC;YAED,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/cli/handlers/ShutdownController.d.ts

@@ -0,0 +1,41 @@
+import type { PreviewWriter } from './PreviewWriter.js';
+import type { BdgSession } from '../../session/BdgSession.js';
+import type { CDPTarget, LaunchedChrome } from '../../types.js';
+import { OutputWriter } from './OutputWriter.js';
+/**
+ * Minimal session state interface
+ */
+export interface SessionState {
+    session: BdgSession | null;
+    launchedChrome: LaunchedChrome | null;
+    isShuttingDown: boolean;
+    previewWriter: PreviewWriter | null;
+    startTime: number;
+    target: CDPTarget | null;
+    compact: boolean;
+}
+/**
+ * Orchestrates shutdown sequence and cleanup operations
+ */
+export declare class ShutdownController {
+    private state;
+    private shutdownKeepalive;
+    private outputWriter;
+    constructor(state: SessionState, outputWriter?: OutputWriter);
+    /**
+     * Execute graceful shutdown sequence.
+     * Stops session, writes output, and exits process.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Cleanup without stopping session (error path).
+     * Clears timers, tears down Chrome if launched, and removes session files.
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Finalize shutdown: write output, cleanup, and exit
+     * @private
+     */
+    private finalize;
+}
+//# sourceMappingURL=ShutdownController.d.ts.map

package/dist/cli/handlers/ShutdownController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShutdownController.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/ShutdownController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAa,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAIpE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAK3B,OAAO,CAAC,KAAK;IAJf,OAAO,CAAC,iBAAiB,CAA+B;IACxD,OAAO,CAAC,YAAY,CAAe;gBAGzB,KAAK,EAAE,YAAY,EAC3B,YAAY,CAAC,EAAE,YAAY;IAK7B;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B/B;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB9B;;;OAGG;IACH,OAAO,CAAC,QAAQ;CA8BjB"}

package/dist/cli/handlers/ShutdownController.js

@@ -0,0 +1,94 @@
+import { cleanupSession } from '../../utils/session.js';
+import { OutputBuilder } from './OutputBuilder.js';
+import { OutputWriter } from './OutputWriter.js';
+/**
+ * Orchestrates shutdown sequence and cleanup operations
+ */
+export class ShutdownController {
+    state;
+    shutdownKeepalive = null;
+    outputWriter;
+    constructor(state, outputWriter) {
+        this.state = state;
+        this.outputWriter = outputWriter ?? new OutputWriter();
+    }
+    /**
+     * Execute graceful shutdown sequence.
+     * Stops session, writes output, and exits process.
+     */
+    async shutdown() {
+        if (this.state.isShuttingDown || !this.state.session) {
+            return;
+        }
+        this.state.isShuttingDown = true;
+        // Keep event loop alive IMMEDIATELY to prevent premature exit during async operations
+        // This must be set before any await points
+        this.shutdownKeepalive = setInterval(() => { }, 1000);
+        // Stop preview writer and wait for pending writes
+        if (this.state.previewWriter) {
+            this.state.previewWriter.stop();
+            await this.state.previewWriter.waitForPendingWrite();
+        }
+        try {
+            console.error('Stopping session...');
+            const output = await this.state.session.stop();
+            this.finalize(output, 0);
+        }
+        catch (error) {
+            console.error('Error during shutdown:', error);
+            const errorOutput = OutputBuilder.buildError(error, this.state.startTime);
+            this.finalize(errorOutput, 1);
+        }
+    }
+    /**
+     * Cleanup without stopping session (error path).
+     * Clears timers, tears down Chrome if launched, and removes session files.
+     */
+    async cleanup() {
+        // Stop preview writer and wait for pending writes
+        if (this.state.previewWriter) {
+            this.state.previewWriter.stop();
+            await this.state.previewWriter.waitForPendingWrite();
+        }
+        // Kill Chrome if we launched it
+        if (this.state.launchedChrome) {
+            try {
+                await this.state.launchedChrome.kill();
+            }
+            catch {
+                // Ignore errors during cleanup
+            }
+        }
+        // Cleanup session files
+        cleanupSession();
+    }
+    /**
+     * Finalize shutdown: write output, cleanup, and exit
+     * @private
+     */
+    finalize(output, exitCode) {
+        // Write output
+        this.outputWriter.writeSessionOutput(output, exitCode, this.state.compact);
+        // Leave Chrome running for future sessions
+        if (this.state.launchedChrome) {
+            const chromeMessage = exitCode === 0
+                ? 'Leaving Chrome running for future sessions (use persistent profile)'
+                : 'Leaving Chrome running (use persistent profile)';
+            console.error(chromeMessage);
+            console.error(`Chrome PID: ${this.state.launchedChrome.pid}, port: ${this.state.launchedChrome.port}`);
+        }
+        // Cleanup session files
+        try {
+            cleanupSession();
+        }
+        catch (cleanupError) {
+            console.error('Error cleaning up session:', cleanupError);
+        }
+        // Clear keepalive and exit
+        if (this.shutdownKeepalive) {
+            clearInterval(this.shutdownKeepalive);
+        }
+        process.exit(exitCode);
+    }
+}
+//# sourceMappingURL=ShutdownController.js.map

package/dist/cli/handlers/ShutdownController.js.map

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