extension 4.1.15 → 4.1.16

package/dist/cli.cjs

@@ -6642,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);
         }
@@ -6846,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;
@@ -6862,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: {
@@ -6873,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;
@@ -6977,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',
@@ -7342,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,
@@ -7351,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,
@@ -7414,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(),
@@ -9473,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 {
@@ -9696,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) {
@@ -9817,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;
@@ -10361,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) {
@@ -10402,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){
@@ -10415,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'),
@@ -10626,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) {
@@ -10694,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;
@@ -10733,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,
@@ -10819,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);

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

@@ -15,10 +15,13 @@ 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 interface CommandFailureDetails {
     code?: unknown;

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.15",
+  "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.15",
-    "extension-develop": "4.1.15",
-    "extension-install": "4.1.15",
+    "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",