extension 4.1.13 → 4.1.15

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");
@@ -7147,14 +7262,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 +7311,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'
@@ -7232,12 +7365,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)
             });
         }
@@ -7403,7 +7553,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 +9257,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),
@@ -10775,13 +10927,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/telemetry-cli.d.ts

@@ -1,10 +1,14 @@
 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(): {
@@ -16,5 +20,11 @@ export declare function setTelemetryConsent(value: 'enabled' | 'disabled'): {
     path: string | null;
 };
 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/package.json

@@ -38,7 +38,7 @@
     "extension": "./bin/extension.cjs"
   },
   "name": "extension",
-  "version": "4.1.13",
+  "version": "4.1.15",
   "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.13",
-    "extension-develop": "4.1.13",
-    "extension-install": "4.1.13",
+    "extension-create": "4.1.15",
+    "extension-develop": "4.1.15",
+    "extension-install": "4.1.15",
     "commander": "^15.0.0",
     "pintor": "0.3.0",
     "semver": "^7.7.3",