extension 4.1.14 → 4.1.16

package/dist/browsers.cjs

@@ -891,6 +891,20 @@ var __webpack_modules__ = {
         function rdpInvalidRequestPayload() {
             return `${getLoggingPrefix('error')} Received an unreadable Firefox remote debugging message.\nThe debugging connection is out of sync with the browser, usually after a crash or an abrupt reload.\nRestart the dev session.\nIf it repeats, report it with your Firefox version.`;
         }
+        function firstRunInstallOffer(browser) {
+            const name = managedBrowserDisplayName(browser);
+            return `${getLoggingPrefix('info')} ${name} is not installed yet.\nExtension.js runs your extension in a version-pinned browser with an isolated profile, so it never touches the browser you use every day.\n${pintor__rspack_import_8_default().gray('NO DOWNLOAD')} ${pintor__rspack_import_8_default().blue('--browser=edge')} or ${pintor__rspack_import_8_default().blue('--browser=brave')} use a browser already on this machine, and ${pintor__rspack_import_8_default().blue('--chromium-binary')} ${pintor__rspack_import_8_default().gray('<abs-path>')} pins any binary, including your own Chrome.`;
+        }
+        function firstRunInstallQuestion(browser) {
+            const name = managedBrowserDisplayName(browser);
+            return `${getLoggingPrefix('info')} Download ${name} now? ${pintor__rspack_import_8_default().gray('[Y/n]')} `;
+        }
+        function firstRunInstallDeclined(browser) {
+            return `${getLoggingPrefix('info')} Skipped the download.\nRun ${pintor__rspack_import_8_default().blue(`npx extension install ${browser}`)} when you want it, or pass one of the no-download options above.`;
+        }
+        function firstRunInstallFailed(browser, reason) {
+            return `${getLoggingPrefix('warn')} The download did not finish.\n${pintor__rspack_import_8_default().gray('REASON')} ${reason}\nRun ${pintor__rspack_import_8_default().blue(`npx extension install ${browser}`)} to see the full output.`;
+        }
         __webpack_require__.d(__webpack_exports__, {
             $q: ()=>safariDefaultBundleIdNote,
             $w: ()=>bestEffortBannerPrintFailed,
@@ -909,6 +923,7 @@ var __webpack_modules__ = {
             F1: ()=>cdpClientBrowserConnectionEstablished,
             F4: ()=>enhancedProcessManagementUncaughtException,
             FF: ()=>cdpClientFoundTargets,
+            FW: ()=>firstRunInstallQuestion,
             Fm: ()=>connectionClosedError,
             G3: ()=>safariRequiresMacOS,
             GB: ()=>waitingForBrowserDebugger,
@@ -928,6 +943,7 @@ var __webpack_modules__ = {
             MS: ()=>errorConnectingToBrowser,
             N4: ()=>enhancedProcessManagementUnhandledRejection,
             NO: ()=>mv3BackgroundScriptsNotSupportedByChromium,
+            NT: ()=>firstRunInstallDeclined,
             Nk: ()=>chromiumDryRunNotLaunching,
             Q0: ()=>chromiumDryRunBinary,
             Rl: ()=>safariBuilt,
@@ -959,6 +975,7 @@ var __webpack_modules__ = {
             fR: ()=>cdpClientConnectionError,
             fd: ()=>safariRegistered,
             fw: ()=>safariOpening,
+            gX: ()=>firstRunInstallFailed,
             hE: ()=>cdpClientConnectionClosed,
             io: ()=>emptyLine,
             jP: ()=>rdpInvalidRequestPayload,
@@ -969,6 +986,7 @@ var __webpack_modules__ = {
             l9: ()=>parsingPacketError,
             lO: ()=>firefoxDryRunArgs,
             l_: ()=>safariConverted,
+            lk: ()=>firstRunInstallOffer,
             ne: ()=>requireChromiumBinaryForChromiumBased,
             nn: ()=>chromeProcessExited,
             oB: ()=>safariSettingsPreserved,
@@ -2196,6 +2214,63 @@ var __webpack_modules__ = {
         var external_yandex_location_default = /*#__PURE__*/ __webpack_require__.n(external_yandex_location_namespaceObject);
         var messaging = __webpack_require__("./helpers/messaging.ts");
         var banner = __webpack_require__("./browsers/browsers-lib/banner.ts");
+        const external_node_readline_namespaceObject = require("node:readline");
+        var external_node_readline_default = /*#__PURE__*/ __webpack_require__.n(external_node_readline_namespaceObject);
+        var browser_install_outcome = __webpack_require__("./helpers/browser-install-outcome.ts");
+        var messages = __webpack_require__("./browsers/browsers-lib/messages.ts");
+        function isCI() {
+            const v = process.env;
+            return Boolean(v.CI || v.GITHUB_ACTIONS || v.GITLAB_CI || v.BUILDKITE || v.CIRCLECI || v.TRAVIS);
+        }
+        function canPromptForInstall() {
+            if (process.env.VITEST || process.env.VITEST_WORKER_ID) return false;
+            if (process.env.EXTENSION_NO_INSTALL_PROMPT) return false;
+            if (isCI()) return false;
+            return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+        }
+        function askToInstall(question) {
+            return new Promise((resolve)=>{
+                const rl = external_node_readline_default().createInterface({
+                    input: process.stdin,
+                    output: process.stdout
+                });
+                const finish = (answer)=>{
+                    try {
+                        rl.close();
+                    } catch  {}
+                    resolve(answer);
+                };
+                rl.question(question, (answer)=>{
+                    const normalized = String(answer || '').trim().toLowerCase();
+                    finish('n' !== normalized && 'no' !== normalized);
+                });
+                rl.on('SIGINT', ()=>finish(false));
+            });
+        }
+        async function offerManagedInstall(target) {
+            if (!canPromptForInstall()) return false;
+            (0, messaging._w)(messages.lk(target));
+            (0, browser_install_outcome.rQ)('offered', target);
+            const accepted = await askToInstall(messages.FW(target));
+            if (!accepted) {
+                (0, browser_install_outcome.rQ)('declined', target);
+                (0, messaging._w)(messages.NT(target));
+                return false;
+            }
+            const startedAt = Date.now();
+            try {
+                const { extensionInstall } = await import("extension-install");
+                await extensionInstall({
+                    browser: target
+                });
+                (0, browser_install_outcome.rQ)('accepted', target, (Date.now() - startedAt) / 1000);
+                return true;
+            } catch (error) {
+                (0, browser_install_outcome.rQ)('failed', target, (Date.now() - startedAt) / 1000);
+                (0, messaging._w)(messages.gX(target, error instanceof Error ? error.message : String(error)));
+                return false;
+            }
+        }
         var instance_registry = __webpack_require__("./browsers/browsers-lib/instance-registry.ts");
         const MSG_REFERENCE = /__MSG_([A-Za-z0-9_@]+?)__/g;
         function collectMsgReferences(value) {
@@ -2416,7 +2491,6 @@ var __webpack_modules__ = {
                 return false;
             }
         }
-        var messages = __webpack_require__("./browsers/browsers-lib/messages.ts");
         var output_binaries_resolver = __webpack_require__("./browsers/browsers-lib/output-binaries-resolver.ts");
         var process_teardown = __webpack_require__("./browsers/browsers-lib/process-teardown.ts");
         var ready_message = __webpack_require__("./browsers/browsers-lib/ready-message.ts");
@@ -3208,6 +3282,26 @@ var __webpack_modules__ = {
                             browserBinaryLocation = normalized;
                         }
                     }
+                    if (!browserBinaryLocation || !external_node_fs_.existsSync(browserBinaryLocation)) {
+                        const offerTarget = 'chromium' === browser ? 'chrome' : 'chrome' === browser || 'edge' === browser ? browser : null;
+                        if (offerTarget && await offerManagedInstall(offerTarget)) {
+                            const justInstalled = ()=>{
+                                try {
+                                    const env = managedEnvFor(offerTarget);
+                                    const located = 'edge' === offerTarget ? external_edge_location_default()({
+                                        env
+                                    }) : external_chrome_location2_default()(true, {
+                                        env
+                                    });
+                                    return normalizePath(located || null);
+                                } catch  {
+                                    return null;
+                                }
+                            };
+                            const resolved = resolveManagedBinary() || justInstalled();
+                            if (isUsableBinary(resolved)) browserBinaryLocation = resolved;
+                        }
+                    }
                     if (!browserBinaryLocation || !external_node_fs_.existsSync(browserBinaryLocation)) {
                         if ('chromium' === browser || 'chromium-based' === browser) printInstallGuidance(getInstallGuidanceText('chromium'), 'chromium');
                         if (!printedGuidance && 'chromium' !== browser && 'chromium-based' !== browser) this.logger.error(messages.Ih(browser, browserBinaryLocation || ''));
@@ -6186,6 +6280,18 @@ var __webpack_modules__ = {
             P: ()=>createSafariPackager
         });
     },
+    "./helpers/browser-install-outcome.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        function recordBrowserInstall(outcome, browser, seconds) {
+            ({
+                ...'number' == typeof seconds && Number.isFinite(seconds) && seconds >= 0 ? {
+                    seconds: Math.round(seconds)
+                } : {}
+            });
+        }
+        __webpack_require__.d(__webpack_exports__, {
+            rQ: ()=>recordBrowserInstall
+        });
+    },
     "./helpers/messaging.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         var pintor__rspack_import_0 = __webpack_require__("pintor");
         var pintor__rspack_import_0_default = /*#__PURE__*/ __webpack_require__.n(pintor__rspack_import_0);

package/dist/cli.cjs

@@ -892,6 +892,20 @@ var __webpack_modules__ = {
         function rdpInvalidRequestPayload() {
             return `${getLoggingPrefix('error')} Received an unreadable Firefox remote debugging message.\nThe debugging connection is out of sync with the browser, usually after a crash or an abrupt reload.\nRestart the dev session.\nIf it repeats, report it with your Firefox version.`;
         }
+        function firstRunInstallOffer(browser) {
+            const name = managedBrowserDisplayName(browser);
+            return `${getLoggingPrefix('info')} ${name} is not installed yet.\nExtension.js runs your extension in a version-pinned browser with an isolated profile, so it never touches the browser you use every day.\n${pintor__rspack_import_8_default().gray('NO DOWNLOAD')} ${pintor__rspack_import_8_default().blue('--browser=edge')} or ${pintor__rspack_import_8_default().blue('--browser=brave')} use a browser already on this machine, and ${pintor__rspack_import_8_default().blue('--chromium-binary')} ${pintor__rspack_import_8_default().gray('<abs-path>')} pins any binary, including your own Chrome.`;
+        }
+        function firstRunInstallQuestion(browser) {
+            const name = managedBrowserDisplayName(browser);
+            return `${getLoggingPrefix('info')} Download ${name} now? ${pintor__rspack_import_8_default().gray('[Y/n]')} `;
+        }
+        function firstRunInstallDeclined(browser) {
+            return `${getLoggingPrefix('info')} Skipped the download.\nRun ${pintor__rspack_import_8_default().blue(`npx extension install ${browser}`)} when you want it, or pass one of the no-download options above.`;
+        }
+        function firstRunInstallFailed(browser, reason) {
+            return `${getLoggingPrefix('warn')} The download did not finish.\n${pintor__rspack_import_8_default().gray('REASON')} ${reason}\nRun ${pintor__rspack_import_8_default().blue(`npx extension install ${browser}`)} to see the full output.`;
+        }
         __webpack_require__.d(__webpack_exports__, {
             $q: ()=>safariDefaultBundleIdNote,
             $w: ()=>bestEffortBannerPrintFailed,
@@ -910,6 +924,7 @@ var __webpack_modules__ = {
             F1: ()=>cdpClientBrowserConnectionEstablished,
             F4: ()=>enhancedProcessManagementUncaughtException,
             FF: ()=>cdpClientFoundTargets,
+            FW: ()=>firstRunInstallQuestion,
             Fm: ()=>connectionClosedError,
             G3: ()=>safariRequiresMacOS,
             GB: ()=>waitingForBrowserDebugger,
@@ -929,6 +944,7 @@ var __webpack_modules__ = {
             MS: ()=>errorConnectingToBrowser,
             N4: ()=>enhancedProcessManagementUnhandledRejection,
             NO: ()=>mv3BackgroundScriptsNotSupportedByChromium,
+            NT: ()=>firstRunInstallDeclined,
             Nk: ()=>chromiumDryRunNotLaunching,
             Q0: ()=>chromiumDryRunBinary,
             Rl: ()=>safariBuilt,
@@ -960,6 +976,7 @@ var __webpack_modules__ = {
             fR: ()=>cdpClientConnectionError,
             fd: ()=>safariRegistered,
             fw: ()=>safariOpening,
+            gX: ()=>firstRunInstallFailed,
             hE: ()=>cdpClientConnectionClosed,
             io: ()=>emptyLine,
             jP: ()=>rdpInvalidRequestPayload,
@@ -970,6 +987,7 @@ var __webpack_modules__ = {
             l9: ()=>parsingPacketError,
             lO: ()=>firefoxDryRunArgs,
             l_: ()=>safariConverted,
+            lk: ()=>firstRunInstallOffer,
             ne: ()=>requireChromiumBinaryForChromiumBased,
             nn: ()=>chromeProcessExited,
             oB: ()=>safariSettingsPreserved,
@@ -2187,6 +2205,63 @@ var __webpack_modules__ = {
         var external_yandex_location_default = /*#__PURE__*/ __webpack_require__.n(external_yandex_location_namespaceObject);
         var messaging = __webpack_require__("./helpers/messaging.ts");
         var banner = __webpack_require__("./browsers/browsers-lib/banner.ts");
+        const external_node_readline_namespaceObject = require("node:readline");
+        var external_node_readline_default = /*#__PURE__*/ __webpack_require__.n(external_node_readline_namespaceObject);
+        var browser_install_outcome = __webpack_require__("./helpers/browser-install-outcome.ts");
+        var messages = __webpack_require__("./browsers/browsers-lib/messages.ts");
+        function isCI() {
+            const v = process.env;
+            return Boolean(v.CI || v.GITHUB_ACTIONS || v.GITLAB_CI || v.BUILDKITE || v.CIRCLECI || v.TRAVIS);
+        }
+        function canPromptForInstall() {
+            if (process.env.VITEST || process.env.VITEST_WORKER_ID) return false;
+            if (process.env.EXTENSION_NO_INSTALL_PROMPT) return false;
+            if (isCI()) return false;
+            return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+        }
+        function askToInstall(question) {
+            return new Promise((resolve)=>{
+                const rl = external_node_readline_default().createInterface({
+                    input: process.stdin,
+                    output: process.stdout
+                });
+                const finish = (answer)=>{
+                    try {
+                        rl.close();
+                    } catch  {}
+                    resolve(answer);
+                };
+                rl.question(question, (answer)=>{
+                    const normalized = String(answer || '').trim().toLowerCase();
+                    finish('n' !== normalized && 'no' !== normalized);
+                });
+                rl.on('SIGINT', ()=>finish(false));
+            });
+        }
+        async function offerManagedInstall(target) {
+            if (!canPromptForInstall()) return false;
+            (0, messaging._w)(messages.lk(target));
+            (0, browser_install_outcome.rQ)('offered', target);
+            const accepted = await askToInstall(messages.FW(target));
+            if (!accepted) {
+                (0, browser_install_outcome.rQ)('declined', target);
+                (0, messaging._w)(messages.NT(target));
+                return false;
+            }
+            const startedAt = Date.now();
+            try {
+                const { extensionInstall } = await import("extension-install");
+                await extensionInstall({
+                    browser: target
+                });
+                (0, browser_install_outcome.rQ)('accepted', target, (Date.now() - startedAt) / 1000);
+                return true;
+            } catch (error) {
+                (0, browser_install_outcome.rQ)('failed', target, (Date.now() - startedAt) / 1000);
+                (0, messaging._w)(messages.gX(target, error instanceof Error ? error.message : String(error)));
+                return false;
+            }
+        }
         var instance_registry = __webpack_require__("./browsers/browsers-lib/instance-registry.ts");
         const MSG_REFERENCE = /__MSG_([A-Za-z0-9_@]+?)__/g;
         function collectMsgReferences(value) {
@@ -2407,7 +2482,6 @@ var __webpack_modules__ = {
                 return false;
             }
         }
-        var messages = __webpack_require__("./browsers/browsers-lib/messages.ts");
         var output_binaries_resolver = __webpack_require__("./browsers/browsers-lib/output-binaries-resolver.ts");
         var process_teardown = __webpack_require__("./browsers/browsers-lib/process-teardown.ts");
         var ready_message = __webpack_require__("./browsers/browsers-lib/ready-message.ts");
@@ -3199,6 +3273,26 @@ var __webpack_modules__ = {
                             browserBinaryLocation = normalized;
                         }
                     }
+                    if (!browserBinaryLocation || !external_node_fs_.existsSync(browserBinaryLocation)) {
+                        const offerTarget = 'chromium' === browser ? 'chrome' : 'chrome' === browser || 'edge' === browser ? browser : null;
+                        if (offerTarget && await offerManagedInstall(offerTarget)) {
+                            const justInstalled = ()=>{
+                                try {
+                                    const env = managedEnvFor(offerTarget);
+                                    const located = 'edge' === offerTarget ? external_edge_location_default()({
+                                        env
+                                    }) : external_chrome_location2_default()(true, {
+                                        env
+                                    });
+                                    return normalizePath(located || null);
+                                } catch  {
+                                    return null;
+                                }
+                            };
+                            const resolved = resolveManagedBinary() || justInstalled();
+                            if (isUsableBinary(resolved)) browserBinaryLocation = resolved;
+                        }
+                    }
                     if (!browserBinaryLocation || !external_node_fs_.existsSync(browserBinaryLocation)) {
                         if ('chromium' === browser || 'chromium-based' === browser) printInstallGuidance(getInstallGuidanceText('chromium'), 'chromium');
                         if (!printedGuidance && 'chromium' !== browser && 'chromium-based' !== browser) this.logger.error(messages.Ih(browser, browserBinaryLocation || ''));
@@ -6177,6 +6271,25 @@ var __webpack_modules__ = {
             P: ()=>createSafariPackager
         });
     },
+    "./helpers/browser-install-outcome.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        let record = null;
+        function recordBrowserInstall(outcome, browser, seconds) {
+            record = {
+                outcome,
+                browser,
+                ...'number' == typeof seconds && Number.isFinite(seconds) && seconds >= 0 ? {
+                    seconds: Math.round(seconds)
+                } : {}
+            };
+        }
+        function readBrowserInstall() {
+            return record;
+        }
+        __webpack_require__.d(__webpack_exports__, {
+            rQ: ()=>recordBrowserInstall,
+            w6: ()=>readBrowserInstall
+        });
+    },
     "./helpers/messaging.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         var pintor__rspack_import_0 = __webpack_require__("pintor");
         var pintor__rspack_import_0_default = /*#__PURE__*/ __webpack_require__.n(pintor__rspack_import_0);
@@ -6497,6 +6610,7 @@ var __webpack_modules__ = {
         var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_);
         var external_pintor_ = __webpack_require__("pintor");
         var external_pintor_default = /*#__PURE__*/ __webpack_require__.n(external_pintor_);
+        var browser_install_outcome = __webpack_require__("./helpers/browser-install-outcome.ts");
         let cachedPackageJson = null;
         function getCliPackageJson() {
             if (cachedPackageJson) return cachedPackageJson;
@@ -6512,6 +6626,7 @@ var __webpack_modules__ = {
             }
             throw new Error('Extension.js CLI package.json not found.');
         }
+        var messaging = __webpack_require__("./helpers/messaging.ts");
         var external_node_crypto_ = __webpack_require__("node:crypto");
         var external_node_crypto_default = /*#__PURE__*/ __webpack_require__.n(external_node_crypto_);
         var external_node_os_ = __webpack_require__("node:os");
@@ -6527,6 +6642,15 @@ var __webpack_modules__ = {
             return obj;
         }
         const VERSION_MAX_LENGTH = 64;
+        const CATALOG_CODE = /^E_[A-Z0-9_]{1,48}$/;
+        function catalogCode(value) {
+            if ('string' != typeof value) return;
+            return CATALOG_CODE.test(value) ? value : void 0;
+        }
+        function smallExitCode(value) {
+            if ('number' != typeof value || !Number.isInteger(value)) return;
+            return value >= 0 && value <= 255 ? value : void 0;
+        }
         function sanitizeTag(value) {
             return String(value).trim().replace(/[^a-zA-Z0-9._-]/g, '').slice(0, 64);
         }
@@ -6731,6 +6855,10 @@ var __webpack_modules__ = {
             get isEnabled() {
                 return !this.disabled;
             }
+            disable() {
+                this.disabled = true;
+                this.buffer.length = 0;
+            }
             track(event, props) {
                 try {
                     if (this.disabled) return;
@@ -6747,6 +6875,11 @@ var __webpack_modules__ = {
                     };
                     if (props.template) enforcedProps.template = sanitizeTag(props.template);
                     if (props.source) enforcedProps.source = sanitizeTag(props.source);
+                    if ('started' === props.session) enforcedProps.session = 'started';
+                    const code = catalogCode(props.code);
+                    if (code) enforcedProps.code = code;
+                    const exitCode = smallExitCode(props.exit_code);
+                    if (void 0 !== exitCode) enforcedProps.exit_code = exitCode;
                     const payload = {
                         event,
                         properties: {
@@ -6758,7 +6891,7 @@ var __webpack_modules__ = {
                         distinct_id: this.anonId
                     };
                     this.writeAudit(payload);
-                    if ('command_executed' === event && 'create' !== props.command && Math.random() > this.sampleRate) return;
+                    if ('command_executed' === event && 'create' !== props.command && 'started' !== props.session && Math.random() > this.sampleRate) return;
                     if (!this.apiKey || !this.host) return;
                     this.buffer.push(payload);
                     this.sent += 1;
@@ -6862,7 +6995,7 @@ var __webpack_modules__ = {
             return Math.min(Math.max(n, min), max);
         }
         const TEMPLATE_CORPUS_REPO = 'extension-js/examples';
-        const TEMPLATE_CORPUS_REF = 'cb6a25377bd9516a1e55447a2010537019851ab2';
+        const TEMPLATE_CORPUS_REF = 'd951b735ee5fbe904bba0c47d688527300d10e32';
         const TEMPLATE_CORPUS_SLUGS = [
             'action',
             'action-locales',
@@ -7147,14 +7280,23 @@ var __webpack_modules__ = {
             ].join('\n');
         }
         const KNOWN_COMMANDS = new Set([
+            'build',
+            'capabilities',
             'create',
             'dev',
-            'start',
-            'preview',
-            'build',
+            'doctor',
+            'eval',
+            'inspect',
             'install',
-            'uninstall',
+            'logs',
+            'open',
+            'preview',
+            'publish',
+            'reload',
+            'start',
+            'storage',
             'telemetry',
+            'uninstall',
             'unknown'
         ]);
         function detectInvokedCommand(argv) {
@@ -7187,8 +7329,17 @@ var __webpack_modules__ = {
             if (templateAliasFor(name)) return name;
         }
         function telemetryCommandContext(command, argv = process.argv) {
-            if ('create' !== command) return {};
+            const install = (0, browser_install_outcome.w6)();
+            const installContext = install ? {
+                browser_install: install.outcome,
+                browser_install_browser: install.browser,
+                ...void 0 === install.seconds ? {} : {
+                    browser_install_seconds: install.seconds
+                }
+            } : {};
+            if ('create' !== command) return installContext;
             return {
+                ...installContext,
                 template: advertisedTemplateName(readArgValue(argv, [
                     '--template',
                     '-t'
@@ -7209,8 +7360,12 @@ var __webpack_modules__ = {
         function getTelemetryConsent() {
             return consent;
         }
+        function invokedCommand() {
+            return invoked;
+        }
         function setTelemetryConsent(value) {
             const ok = writeConsent(value);
+            if ('disabled' === value) telemetry.disable();
             const storage = resolveTelemetryStorage();
             return {
                 ok,
@@ -7218,12 +7373,29 @@ var __webpack_modules__ = {
             };
         }
         let tracked = false;
+        let sessionStarted = false;
         function markTracked() {
             if (tracked) return false;
             tracked = true;
             return true;
         }
+        function markCommandSessionStart(command = invoked) {
+            if (tracked || sessionStarted) return;
+            sessionStarted = true;
+            telemetry.track('command_executed', {
+                command,
+                success: true,
+                version: telemetry_cli_version,
+                session: 'started',
+                ...telemetryCommandContext(command)
+            });
+            telemetry.flush();
+        }
+        function hasTrackedSessionStart() {
+            return sessionStarted;
+        }
         function markCommandSuccess(command = invoked) {
+            if (sessionStarted) return;
             if (!markTracked()) return;
             telemetry.track('command_executed', {
                 command,
@@ -7232,12 +7404,29 @@ var __webpack_modules__ = {
                 ...telemetryCommandContext(command)
             });
         }
-        function markCommandFailure(command = invoked) {
+        function telemetryFailureCode(code) {
+            if ('string' != typeof code) return;
+            return Object.prototype.hasOwnProperty.call(messaging.Lp, code) ? code : void 0;
+        }
+        function telemetryExitCode(exitCode) {
+            if ('number' != typeof exitCode) return;
+            if (!Number.isInteger(exitCode) || exitCode < 0 || exitCode > 255) return;
+            return exitCode;
+        }
+        function markCommandFailure(command = invoked, details = {}) {
             if (!markTracked()) return;
+            const code = telemetryFailureCode(details.code);
+            const exitCode = telemetryExitCode(details.exitCode);
             telemetry.track('command_failed', {
                 command,
                 success: false,
                 version: telemetry_cli_version,
+                ...code ? {
+                    code
+                } : {},
+                ...void 0 === exitCode ? {} : {
+                    exit_code: exitCode
+                },
                 ...telemetryCommandContext(command)
             });
         }
@@ -7264,7 +7453,17 @@ var __webpack_modules__ = {
             });
         }
         const TELEMETRY_FLUSH_TIMEOUT_MS = 500;
+        function markOutcomeForExit(code) {
+            try {
+                if ('unknown' === invokedCommand()) return;
+                if (0 === code) return void markCommandSuccess();
+                markCommandFailure(void 0, {
+                    exitCode: code
+                });
+            } catch  {}
+        }
         async function exitAfterDrain(code) {
+            markOutcomeForExit(code);
             try {
                 await Promise.race([
                     telemetry.flush(),
@@ -7403,7 +7602,6 @@ var __webpack_modules__ = {
             const bridgeSpecifier = 'extension-develop/bridge';
             return await import(bridgeSpecifier);
         }
-        var messaging = __webpack_require__("./helpers/messaging.ts");
         function getLoggingPrefix(type) {
             return (0, messaging.Pl)(type);
         }
@@ -9108,7 +9306,10 @@ Cross-browser compatibility
                         cliVersion: getCliPackageJson().version
                     });
                 } catch (error) {
-                    markCommandFailure();
+                    markCommandFailure(void 0, {
+                        code: createErrorCode(error),
+                        exitCode: 1
+                    });
                     if (!asJson) throw error;
                     console.log(JSON.stringify(messaging.Pr.fail('create', 'failed', {
                         code: createErrorCode(error),
@@ -9321,6 +9522,8 @@ Cross-browser compatibility
         function cliGeckoBinary(opts) {
             return opts.geckoBinary ?? opts.firefoxBinary;
         }
+        const BROWSER_LAUNCH_HELP_FOOTER = "\nTo stop the browser launch, use --no-browser.\nTo launch the browser without opening a tab for your extension, use --no-open.\n";
+        const NO_OPEN_FLAG_DESCRIPTION = 'launch the browser but do not open a tab for your extension. To stop the browser launch itself, use --no-browser';
         async function resolveNoBrowser(projectPath, command) {
             if ('1' === process.env.EXTENSION_CLI_NO_BROWSER) return true;
             try {
@@ -9544,7 +9747,7 @@ Cross-browser compatibility
             return Number.isFinite(parsed) && parsed >= 0 ? Math.floor(parsed) : 8080;
         }
         function registerDevCommand(program) {
-            program.command('dev').arguments('[project-path|remote-url]').usage('[project-path|remote-url] [options]').description(commandDescriptions.dev).addHelpText('after', "\nAdditional options:\n  --no-browser    do not launch the browser (dev server still starts)\n  --no-reload     emit a dev-mode dist without the content-script reload runtime; tabs need manual reload to see changes\n  --wait          wait for ready contract and exit; pair with --output json for machine output\n").option('--profile <path-to-file | boolean>', 'what path to use for the browser profile. A boolean value of false sets the profile to the default user profile. Defaults to a fresh profile').option(`-b, --browser <${BROWSER_TARGETS_HELP}>`, 'specify a browser/engine to run. Defaults to `chromium`. `safari` builds and opens a Safari app via Xcode (macOS only; no live reload)').option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').addOption(geckoBinaryOption()).addOption(firefoxBinaryAliasOption()).option('--safari-binary <path-to-binary>', 'specify the Safari binary to open after packaging (safari targets only)').option('--app-name <name>', 'override the Safari app name (safari targets only). Defaults to the manifest `name`').option('--bundle-id <reverse.dns>', 'set a user-owned Safari bundle identifier (safari targets only). Defaults to a generated dev.extensionjs.* id').option('--development-team <id>', 'sign the Safari app with an Apple Developer team id (safari targets only). Without it the build is ad-hoc signed, which Safari treats as unsigned: the extension then needs Develop \u25b8 Allow Unsigned Extensions re-ticked on every launch. A signed build is listed and stays enabled across restarts').option('--macos-only [boolean]', 'generate a macOS-only Safari Xcode project (safari targets only). Pass `false` for a universal macOS + iOS project. Defaults to `true`', parseOptionalBoolean).option('--force-regenerate', 'regenerate the Safari Xcode project even when up to date (safari targets only)').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `true`', parseOptionalBoolean).option('--no-polyfill', 'disable the cross-browser polyfill').option('--no-open', 'do not open the browser automatically (default: open)').option('--starting-url <url>', 'specify the starting URL for the browser. Defaults to `undefined`').option('--port <port>', 'specify the port to use for the development server. Defaults to `8080`').option('--host <host>', 'specify the host to bind the dev server to. Use 0.0.0.0 for Docker/devcontainers. Defaults to `127.0.0.1`').option('--public-host <host>', 'connectable host the browser (HMR + reload bridge) dials when it differs from the bind host (e.g. a remote/devcontainer). Defaults to the bind host, or 127.0.0.1 when bound to 0.0.0.0').option('--log-context <list>', '[experimental] comma-separated contexts to include (background,content,page,sidebar,popup,options,devtools). Use `all` to include all contexts (default)').option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--install [boolean]', '[internal] install project dependencies when missing', parseOptionalBoolean).option('--wait [boolean]', 'wait for dist/extension-js/<browser>/ready.json and exit', parseOptionalBoolean).option('--wait-timeout <ms>', 'timeout in milliseconds when using --wait (default: 60000)').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addOption(new external_commander_namespaceObject.Option('--wait-format <pretty|json>').hideHelp()).addOption(new external_commander_namespaceObject.Option('--debug', 'print maintainer diagnostics alongside normal output')).addOption(new external_commander_namespaceObject.Option('--author, --author-mode', 'deprecated alias for --debug').hideHelp()).option('--allow-control', 'enable the agent-bridge control channel for bounded act (storage/reload/open): see `extension reload|storage|open`').option('--allow-eval', 'additionally enable `extension eval` (implies --allow-control, runs arbitrary code in a context, writes a 0600 session token)').option('--parent-pid <pid>', 'exit when the given process dies. For wrappers that spawn `extension dev`, so a leaked dev server can never outlive its owner').action(async (pathOrRemoteUrl, options, command)=>{
+            program.command('dev').arguments('[project-path|remote-url]').usage('[project-path|remote-url] [options]').description(commandDescriptions.dev).addHelpText('after', "\nAdditional options:\n  --no-browser    stop the browser launch, the dev server still starts\n  --no-reload     emit a dev-mode dist without the content-script reload runtime, tabs need a manual reload to see changes\n  --wait          wait for ready contract and exit, pair with --output json for machine output\n" + BROWSER_LAUNCH_HELP_FOOTER).option('--profile <path-to-file | boolean>', 'what path to use for the browser profile. A boolean value of false sets the profile to the default user profile. Defaults to a fresh profile').option(`-b, --browser <${BROWSER_TARGETS_HELP}>`, 'specify a browser/engine to run. Defaults to `chromium`. `safari` builds and opens a Safari app via Xcode (macOS only; no live reload)').option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').addOption(geckoBinaryOption()).addOption(firefoxBinaryAliasOption()).option('--safari-binary <path-to-binary>', 'specify the Safari binary to open after packaging (safari targets only)').option('--app-name <name>', 'override the Safari app name (safari targets only). Defaults to the manifest `name`').option('--bundle-id <reverse.dns>', 'set a user-owned Safari bundle identifier (safari targets only). Defaults to a generated dev.extensionjs.* id').option('--development-team <id>', 'sign the Safari app with an Apple Developer team id (safari targets only). Without it the build is ad-hoc signed, which Safari treats as unsigned: the extension then needs Develop \u25b8 Allow Unsigned Extensions re-ticked on every launch. A signed build is listed and stays enabled across restarts').option('--macos-only [boolean]', 'generate a macOS-only Safari Xcode project (safari targets only). Pass `false` for a universal macOS + iOS project. Defaults to `true`', parseOptionalBoolean).option('--force-regenerate', 'regenerate the Safari Xcode project even when up to date (safari targets only)').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `true`', parseOptionalBoolean).option('--no-polyfill', 'disable the cross-browser polyfill').option('--no-open', NO_OPEN_FLAG_DESCRIPTION).option('--starting-url <url>', 'specify the starting URL for the browser. Defaults to `undefined`').option('--port <port>', 'specify the port to use for the development server. Defaults to `8080`').option('--host <host>', 'specify the host to bind the dev server to. Use 0.0.0.0 for Docker/devcontainers. Defaults to `127.0.0.1`').option('--public-host <host>', 'connectable host the browser (HMR + reload bridge) dials when it differs from the bind host (e.g. a remote/devcontainer). Defaults to the bind host, or 127.0.0.1 when bound to 0.0.0.0').option('--log-context <list>', '[experimental] comma-separated contexts to include (background,content,page,sidebar,popup,options,devtools). Use `all` to include all contexts (default)').option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--install [boolean]', '[internal] install project dependencies when missing', parseOptionalBoolean).option('--wait [boolean]', 'wait for dist/extension-js/<browser>/ready.json and exit', parseOptionalBoolean).option('--wait-timeout <ms>', 'timeout in milliseconds when using --wait (default: 60000)').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addOption(new external_commander_namespaceObject.Option('--wait-format <pretty|json>').hideHelp()).addOption(new external_commander_namespaceObject.Option('--debug', 'print maintainer diagnostics alongside normal output')).addOption(new external_commander_namespaceObject.Option('--author, --author-mode', 'deprecated alias for --debug').hideHelp()).option('--allow-control', 'enable the agent-bridge control channel for bounded act (storage/reload/open): see `extension reload|storage|open`').option('--allow-eval', 'additionally enable `extension eval` (implies --allow-control, runs arbitrary code in a context, writes a 0600 session token)').option('--parent-pid <pid>', 'exit when the given process dies. For wrappers that spawn `extension dev`, so a leaked dev server can never outlive its owner').action(async (pathOrRemoteUrl, options, command)=>{
                 const { browser: cliBrowser, ...devOptions } = options;
                 const browser = cliBrowser ?? await resolveConfigBrowser(pathOrRemoteUrl || process.cwd(), 'dev') ?? 'chromium';
                 if (devOptions.debug || devOptions.author || devOptions.authorMode) {
@@ -9665,6 +9868,7 @@ Cross-browser compatibility
                     pid: process.pid,
                     noBrowser
                 }));
+                markCommandSessionStart('dev');
                 const { extensionDev } = await loadExtensionDevelopModule();
                 for (const vendor of list){
                     const logsOption = devOptions.logs;
@@ -10209,7 +10413,7 @@ Cross-browser compatibility
             'Manifest file not found'
         ];
         function registerPreviewCommand(program) {
-            program.command('preview').arguments('[project-name]').usage('[path-to-remote-extension] [options]').description(commandDescriptions.preview).addHelpText('after', '\nAdditional option:\n  --no-browser    do not launch the browser\n').option('--profile <path-to-file | boolean>', 'what path to use for the browser profile. A boolean value of false sets the profile to the default user profile. Defaults to a fresh profile').option(`--browser <${NO_SAFARI_BROWSER_TARGETS_HELP}>`, 'specify a browser/engine to run. Defaults to `chromium`').option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').addOption(geckoBinaryOption()).addOption(firefoxBinaryAliasOption()).option('--starting-url <url>', 'specify the starting URL for the browser. Defaults to `undefined`').option('--port <port>', 'specify the port to use for the development server. Defaults to `8080`').option('--log-context <list>', '[experimental] comma-separated contexts to include (background,content,page,sidebar,popup,options,devtools). Use `all` to include all contexts (default)').option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--output-path <dir>', 'path to an existing unpacked extension directory. Defaults to dist/<browser> when available').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addOption(new external_commander_namespaceObject.Option('--debug', 'print maintainer diagnostics alongside normal output')).addOption(new external_commander_namespaceObject.Option('--author, --author-mode', 'deprecated alias for --debug').hideHelp()).action(async (pathOrRemoteUrl, options, command)=>{
+            program.command('preview').arguments('[project-name]').usage('[path-to-remote-extension] [options]').description(commandDescriptions.preview).addHelpText('after', "\nAdditional option:\n  --no-browser    stop the browser launch\n" + BROWSER_LAUNCH_HELP_FOOTER).option('--profile <path-to-file | boolean>', 'what path to use for the browser profile. A boolean value of false sets the profile to the default user profile. Defaults to a fresh profile').option(`--browser <${NO_SAFARI_BROWSER_TARGETS_HELP}>`, 'specify a browser/engine to run. Defaults to `chromium`').option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').addOption(geckoBinaryOption()).addOption(firefoxBinaryAliasOption()).option('--no-open', NO_OPEN_FLAG_DESCRIPTION).option('--starting-url <url>', 'specify the starting URL for the browser. Defaults to `undefined`').option('--port <port>', 'specify the port to use for the development server. Defaults to `8080`').option('--log-context <list>', '[experimental] comma-separated contexts to include (background,content,page,sidebar,popup,options,devtools). Use `all` to include all contexts (default)').option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--output-path <dir>', 'path to an existing unpacked extension directory. Defaults to dist/<browser> when available').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addOption(new external_commander_namespaceObject.Option('--debug', 'print maintainer diagnostics alongside normal output')).addOption(new external_commander_namespaceObject.Option('--author, --author-mode', 'deprecated alias for --debug').hideHelp()).action(async (pathOrRemoteUrl, options, command)=>{
                 const { browser: cliBrowser, ...previewOptions } = options;
                 const browser = cliBrowser ?? await resolveConfigBrowser(pathOrRemoteUrl || process.cwd(), 'preview') ?? 'chromium';
                 if (previewOptions.debug || previewOptions.author || previewOptions.authorMode) {
@@ -10250,6 +10454,7 @@ Cross-browser compatibility
                     const isRemote = 'string' == typeof pathOrRemoteUrl && /^https?:/i.test(pathOrRemoteUrl);
                     if (isRemote) process.env.EXTJS_LIGHT = '1';
                 }
+                markCommandSessionStart('preview');
                 const { extensionPreview } = await loadExtensionDevelopPreviewModule();
                 const previewed = [];
                 for (const vendor of list){
@@ -10263,6 +10468,7 @@ Cross-browser compatibility
                             browser: vendor,
                             chromiumBinary: previewOptions.chromiumBinary,
                             geckoBinary: cliGeckoBinary(previewOptions),
+                            noOpen: explicitCliValue(command, 'open', false === previewOptions.open),
                             startingUrl: previewOptions.startingUrl,
                             port: previewOptions.port,
                             noBrowser: await resolveNoBrowser(pathOrRemoteUrl || process.cwd(), 'preview'),
@@ -10474,7 +10680,7 @@ Cross-browser compatibility
             return Number.isFinite(parsed) && parsed >= 0 ? Math.floor(parsed) : 8080;
         }
         function registerStartCommand(program) {
-            program.command('start').arguments('[project-path|remote-url]').usage('[project-path|remote-url] [options]').description(commandDescriptions.start).addHelpText('after', '\nAdditional options:\n  --no-browser    do not launch the browser (build still runs)\n  --wait          wait for ready contract and exit; pair with --output json for machine output\n').option('--profile <path-to-file | boolean>', 'what path to use for the browser profile. A boolean value of false sets the profile to the default user profile. Defaults to a fresh profile').option(`--browser <${NO_SAFARI_BROWSER_TARGETS_HELP}>`, 'specify a browser/engine to run. Defaults to `chromium`').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `true`', parseOptionalBoolean).option('--no-polyfill', 'disable the cross-browser polyfill').option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').addOption(geckoBinaryOption()).addOption(firefoxBinaryAliasOption()).option('--starting-url <url>', 'specify the starting URL for the browser. Defaults to `undefined`').option('--port <port>', 'specify the port to use for the development server. Defaults to `8080`').option('--host <host>', 'specify the host to bind the dev server to. Use 0.0.0.0 for Docker/devcontainers. Defaults to `127.0.0.1`').option('--public-host <host>', 'connectable host the browser (HMR + reload bridge) dials when it differs from the bind host (e.g. a remote/devcontainer). Defaults to the bind host, or 127.0.0.1 when bound to 0.0.0.0').option('--log-context <list>', '[experimental] comma-separated contexts to include (background,content,page,sidebar,popup,options,devtools). Use `all` to include all contexts (default)').option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--install [boolean]', '[internal] install project dependencies when missing', parseOptionalBoolean).option('--wait [boolean]', 'wait for dist/extension-js/<browser>/ready.json and exit', parseOptionalBoolean).option('--wait-timeout <ms>', 'timeout in milliseconds when using --wait (default: 60000)').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addOption(new external_commander_namespaceObject.Option('--wait-format <pretty|json>').hideHelp()).addOption(new external_commander_namespaceObject.Option('--debug', 'print maintainer diagnostics alongside normal output')).addOption(new external_commander_namespaceObject.Option('--author, --author-mode', 'deprecated alias for --debug').hideHelp()).action(async (pathOrRemoteUrl, options, command)=>{
+            program.command('start').arguments('[project-path|remote-url]').usage('[project-path|remote-url] [options]').description(commandDescriptions.start).addHelpText('after', "\nAdditional options:\n  --no-browser    stop the browser launch, the build still runs\n  --wait          wait for ready contract and exit, pair with --output json for machine output\n" + BROWSER_LAUNCH_HELP_FOOTER).option('--profile <path-to-file | boolean>', 'what path to use for the browser profile. A boolean value of false sets the profile to the default user profile. Defaults to a fresh profile').option(`--browser <${NO_SAFARI_BROWSER_TARGETS_HELP}>`, 'specify a browser/engine to run. Defaults to `chromium`').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `true`', parseOptionalBoolean).option('--no-polyfill', 'disable the cross-browser polyfill').option('--no-open', NO_OPEN_FLAG_DESCRIPTION).option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').addOption(geckoBinaryOption()).addOption(firefoxBinaryAliasOption()).option('--starting-url <url>', 'specify the starting URL for the browser. Defaults to `undefined`').option('--port <port>', 'specify the port to use for the development server. Defaults to `8080`').option('--host <host>', 'specify the host to bind the dev server to. Use 0.0.0.0 for Docker/devcontainers. Defaults to `127.0.0.1`').option('--public-host <host>', 'connectable host the browser (HMR + reload bridge) dials when it differs from the bind host (e.g. a remote/devcontainer). Defaults to the bind host, or 127.0.0.1 when bound to 0.0.0.0').option('--log-context <list>', '[experimental] comma-separated contexts to include (background,content,page,sidebar,popup,options,devtools). Use `all` to include all contexts (default)').option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--install [boolean]', '[internal] install project dependencies when missing', parseOptionalBoolean).option('--wait [boolean]', 'wait for dist/extension-js/<browser>/ready.json and exit', parseOptionalBoolean).option('--wait-timeout <ms>', 'timeout in milliseconds when using --wait (default: 60000)').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addOption(new external_commander_namespaceObject.Option('--wait-format <pretty|json>').hideHelp()).addOption(new external_commander_namespaceObject.Option('--debug', 'print maintainer diagnostics alongside normal output')).addOption(new external_commander_namespaceObject.Option('--author, --author-mode', 'deprecated alias for --debug').hideHelp()).action(async (pathOrRemoteUrl, options, command)=>{
                 const { browser: cliBrowser, ...startOptions } = options;
                 const browser = cliBrowser ?? await resolveConfigBrowser(pathOrRemoteUrl || process.cwd(), 'start') ?? 'chromium';
                 if (startOptions.debug || startOptions.author || startOptions.authorMode) {
@@ -10542,6 +10748,7 @@ Cross-browser compatibility
                     pid: process.pid,
                     noBrowser: await resolveNoBrowser(pathOrRemoteUrl || process.cwd(), 'start')
                 }));
+                markCommandSessionStart('start');
                 const { extensionBuild } = await loadExtensionDevelopModule();
                 for (const vendor of list){
                     const logsOption = startOptions.logs;
@@ -10581,6 +10788,7 @@ Cross-browser compatibility
                         port: startOptions.port,
                         host: startOptions.host,
                         noBrowser: false,
+                        noOpen: explicitCliValue(command, 'open', false === startOptions.open),
                         extensions: parseExtensionsList(startOptions.extensions),
                         metadataCommand: 'start',
                         logLevel,
@@ -10667,6 +10875,63 @@ Cross-browser compatibility
             }
             return null;
         }
+        const TERMINATION_SIGNALS = [
+            'SIGINT',
+            'SIGTERM'
+        ];
+        const FLUSH_DEADLINE_MS = 500;
+        const SIGNAL_NUMBERS = {
+            SIGINT: 2,
+            SIGTERM: 15
+        };
+        function signalExitCode(signal) {
+            return 128 + SIGNAL_NUMBERS[signal];
+        }
+        let handled = false;
+        const ownListeners = new Set();
+        let telemetry_signals_installed = false;
+        async function flushTelemetryWithin(ms) {
+            try {
+                await Promise.race([
+                    telemetry.flush(),
+                    new Promise((resolve)=>setTimeout(resolve, ms).unref?.())
+                ]);
+            } catch  {}
+        }
+        async function handleTerminationSignal(signal, deps) {
+            if (handled) return;
+            handled = true;
+            const counted = deps.sessionStarted();
+            const othersOwn = deps.othersOwnTermination();
+            if (!counted && !othersOwn) deps.markInterrupted(signalExitCode(signal));
+            await deps.flush();
+            if (!othersOwn) await deps.exit(counted ? 0 : signalExitCode(signal));
+        }
+        function defaultDeps() {
+            return {
+                sessionStarted: hasTrackedSessionStart,
+                markInterrupted: (exitCode)=>markCommandFailure(void 0, {
+                        code: messaging.Lp.E_INTERRUPTED,
+                        exitCode
+                    }),
+                flush: ()=>flushTelemetryWithin(FLUSH_DEADLINE_MS),
+                othersOwnTermination: ()=>TERMINATION_SIGNALS.some((signal)=>process.listeners(signal).some((listener)=>!ownListeners.has(listener))),
+                exit: (code)=>exitAfterDrain(code)
+            };
+        }
+        function installTelemetrySignalHandlers() {
+            if (telemetry_signals_installed) return;
+            if (!getTelemetryConsent().enabled) return;
+            telemetry_signals_installed = true;
+            for (const signal of TERMINATION_SIGNALS){
+                const listener = ()=>{
+                    handleTerminationSignal(signal, defaultDeps());
+                };
+                ownListeners.add(listener);
+                process.once(signal, listener);
+            }
+        }
+        installTelemetrySignalHandlers();
         const index_cliPackageJson = getCliPackageJson();
         function developVersion() {
             return resolveExtensionDevelopVersion(__dirname, index_cliPackageJson.version);
@@ -10775,13 +11040,19 @@ Cross-browser compatibility
                     if (isCommanderError(err)) {
                         const exitCode = commanderExitCode(err);
                         if (0 === exitCode) process.exit(0);
-                        markCommandFailure();
+                        markCommandFailure(void 0, {
+                            code: messaging.Lp.E_ARGS,
+                            exitCode
+                        });
                         console.error(commanderHumanError(err, commandName));
                         if (asJson) writeStdoutFrame(commanderErrorEnvelope(err, commandName));
                         await exitAfterDrain(exitCode);
                         return;
                     }
-                    markCommandFailure();
+                    markCommandFailure(void 0, {
+                        code: telemetryFailureCode(err?.code) || messaging.Lp.E_INTERNAL,
+                        exitCode: 1
+                    });
                     console.error(unhandledError(err));
                     if (asJson && !isErrorFramed(err)) writeStdoutFrame(internalErrorEnvelope(err, commandName));
                     await exitAfterDrain(1);

package/dist/extension/browsers/browsers-lib/first-run-install.d.ts

@@ -0,0 +1,4 @@
+export type InstallableTarget = 'chrome' | 'chromium' | 'edge' | 'firefox';
+export declare function canPromptForInstall(): boolean;
+export declare function askToInstall(question: string): Promise<boolean>;
+export declare function offerManagedInstall(target: InstallableTarget): Promise<boolean>;

package/dist/extension/browsers/browsers-lib/messages.d.ts

@@ -140,4 +140,8 @@ export declare function requireGeckoBinaryForGeckoBased(): string;
 export declare function invalidChromiumBinaryPath(p: string): string;
 export declare function invalidGeckoBinaryPath(p: string): string;
 export declare function rdpInvalidRequestPayload(): string;
+export declare function firstRunInstallOffer(browser: string): string;
+export declare function firstRunInstallQuestion(browser: string): string;
+export declare function firstRunInstallDeclined(browser: string): string;
+export declare function firstRunInstallFailed(browser: string, reason: string): string;
 export {};

package/dist/extension/helpers/browser-install-outcome.d.ts

@@ -0,0 +1,10 @@
+export type BrowserInstallOutcome = 'offered' | 'accepted' | 'declined' | 'failed';
+interface BrowserInstallRecord {
+    outcome: BrowserInstallOutcome;
+    browser: string;
+    seconds?: number;
+}
+export declare function recordBrowserInstall(outcome: BrowserInstallOutcome, browser: string, seconds?: number): void;
+export declare function readBrowserInstall(): BrowserInstallRecord | null;
+export declare function resetBrowserInstall(): void;
+export {};

package/dist/extension/helpers/no-browser.d.ts

@@ -1 +1,3 @@
+export declare const BROWSER_LAUNCH_HELP_FOOTER: string;
+export declare const NO_OPEN_FLAG_DESCRIPTION = "launch the browser but do not open a tab for your extension. To stop the browser launch itself, use --no-browser";
 export declare function resolveNoBrowser(projectPath: string, command: 'dev' | 'start' | 'preview'): Promise<boolean>;

package/dist/extension/helpers/telemetry-cli.d.ts

@@ -1,20 +1,33 @@
 import { Telemetry, type TelemetrySource } from './telemetry';
-type KnownCommand = 'create' | 'dev' | 'start' | 'preview' | 'build' | 'install' | 'uninstall' | 'telemetry' | 'unknown';
+type KnownCommand = 'build' | 'capabilities' | 'create' | 'dev' | 'doctor' | 'eval' | 'inspect' | 'install' | 'logs' | 'open' | 'preview' | 'publish' | 'reload' | 'start' | 'storage' | 'telemetry' | 'uninstall' | 'unknown';
+export declare const KNOWN_COMMANDS: ReadonlySet<KnownCommand>;
 export declare function detectInvokedCommand(argv: string[]): KnownCommand;
 export declare function advertisedTemplateName(value: string | undefined): string | undefined;
 export declare function telemetryCommandContext(command: string, argv?: string[]): {
     template?: string;
     source?: string;
+    browser_install?: string;
+    browser_install_browser?: string;
+    browser_install_seconds?: number;
 };
 export declare const telemetry: Telemetry;
 export declare function getTelemetryConsent(): {
     enabled: boolean;
     source: TelemetrySource;
 };
+export declare function invokedCommand(): string;
 export declare function setTelemetryConsent(value: 'enabled' | 'disabled'): {
     ok: boolean;
     path: string | null;
 };
+export declare function markCommandSessionStart(command?: KnownCommand): void;
+export declare function hasTrackedSessionStart(): boolean;
 export declare function markCommandSuccess(command?: KnownCommand): void;
-export declare function markCommandFailure(command?: KnownCommand): void;
+export interface CommandFailureDetails {
+    code?: unknown;
+    exitCode?: unknown;
+}
+export declare function telemetryFailureCode(code: unknown): string | undefined;
+export declare function telemetryExitCode(exitCode: unknown): number | undefined;
+export declare function markCommandFailure(command?: KnownCommand, details?: CommandFailureDetails): void;
 export {};

package/dist/extension/helpers/telemetry-signals.d.ts

@@ -0,0 +1,14 @@
+export type TerminationSignal = 'SIGINT' | 'SIGTERM';
+export declare const TERMINATION_SIGNALS: readonly TerminationSignal[];
+export declare function signalExitCode(signal: TerminationSignal): number;
+export interface TerminationSignalDeps {
+    sessionStarted: () => boolean;
+    markInterrupted: (exitCode: number) => void;
+    flush: () => Promise<void>;
+    othersOwnTermination: () => boolean;
+    exit: (code: number) => void | Promise<void>;
+}
+export declare function __resetTelemetrySignalsForTest(): void;
+export declare function flushTelemetryWithin(ms: number): Promise<void>;
+export declare function handleTerminationSignal(signal: TerminationSignal, deps: TerminationSignalDeps): Promise<void>;
+export declare function installTelemetrySignalHandlers(): void;

package/dist/extension/helpers/telemetry.d.ts

@@ -5,6 +5,9 @@ export type TelemetryProps = {
     version: string;
     template?: string;
     source?: string;
+    session?: 'started';
+    code?: string;
+    exit_code?: number;
 };
 export type TelemetrySource = 'env' | 'flag' | 'config' | 'ci' | 'default';
 type TelemetryInit = {
@@ -53,6 +56,7 @@ export declare class Telemetry {
     private buffer;
     constructor(init: TelemetryInit);
     get isEnabled(): boolean;
+    disable(): void;
     track(event: TelemetryEvent, props: TelemetryProps): void;
     flush(): Promise<void>;
     shutdown(): void;

package/dist/extension/helpers/template-catalog.d.ts

@@ -1,6 +1,6 @@
 export declare const DEFAULT_TEMPLATE = "typescript";
 export declare const BUNDLED_TEMPLATES: readonly string[];
-export declare const TEMPLATE_CATALOG_URL = "https://github.com/extension-js/examples/tree/cb6a25377bd9516a1e55447a2010537019851ab2/examples";
+export declare const TEMPLATE_CATALOG_URL = "https://github.com/extension-js/examples/tree/d951b735ee5fbe904bba0c47d688527300d10e32/examples";
 export interface TemplateGroup {
     title: string;
     summary: string;

package/dist/extension/helpers/template-corpus.generated.d.ts

@@ -1,3 +1,3 @@
 export declare const TEMPLATE_CORPUS_REPO = "extension-js/examples";
-export declare const TEMPLATE_CORPUS_REF = "cb6a25377bd9516a1e55447a2010537019851ab2";
+export declare const TEMPLATE_CORPUS_REF = "d951b735ee5fbe904bba0c47d688527300d10e32";
 export declare const TEMPLATE_CORPUS_SLUGS: readonly string[];

package/package.json

@@ -38,7 +38,7 @@
     "extension": "./bin/extension.cjs"
   },
   "name": "extension",
-  "version": "4.1.14",
+  "version": "4.1.16",
   "description": "The cross-browser extension framework. Build Chrome, Edge, Firefox, and Safari extensions with no build configuration.",
   "homepage": "https://extension.js.org/",
   "bugs": {
@@ -106,9 +106,9 @@
     "vivaldi-location2": "2.1.1",
     "waterfox-location": "2.1.1",
     "yandex-location": "2.1.1",
-    "extension-create": "4.1.14",
-    "extension-develop": "4.1.14",
-    "extension-install": "4.1.14",
+    "extension-create": "4.1.16",
+    "extension-develop": "4.1.16",
+    "extension-install": "4.1.16",
     "commander": "^15.0.0",
     "pintor": "0.3.0",
     "semver": "^7.7.3",