extension 4.1.20 → 4.1.22

package/README.md

@@ -6,10 +6,10 @@
 [action-url]: https://github.com/extension-js/extension.js/actions
 [discord-image]: https://img.shields.io/discord/1253608412890271755?label=Discord&logo=discord&style=flat&color=0971fe
 [discord-url]: https://discord.gg/v9h2RgeTSN
-[bestpractices-image]: https://img.shields.io/cii/level/14662?label=OpenSSF%20Best%20Practices&style=flat&color=0971fe
+[bestpractices-image]: https://img.shields.io/cii/level/14662?label=Best%20Practices&style=flat&color=0971fe
 [bestpractices-url]: https://www.bestpractices.dev/projects/14662
 
-# Extension.js [![Version][npm-version-image]][npm-version-url] [![Stars][stars-image]][stars-url] [![CI][action-image]][action-url] [![Discord][discord-image]][discord-url] [![OpenSSF Best Practices][bestpractices-image]][bestpractices-url]
+# Extension.js [![Version][npm-version-image]][npm-version-url] [![Stars][stars-image]][stars-url] [![CI][action-image]][action-url] [![Discord][discord-image]][discord-url] [![Best Practices][bestpractices-image]][bestpractices-url]
 
 > The cross-browser extension framework. Build for Chrome, Edge, Firefox, and Safari with no build config required.
 
@@ -23,9 +23,9 @@ npm run dev
 
 Works with `npm`, `pnpm`, `yarn`, `bun`, and `deno`.
 
-The CLI itself runs on Node.js 22.12+ and Deno 2.5+. Bun installs and launches it, and it runs on Node.js from there.
+The CLI itself runs on Node.js 22.12+, Deno 2.5+, and Bun 1.2+.
 
-[Documentation](https://extension.js.org/docs) · [Templates](https://templates.extension.dev/?utm_source=readme&utm_campaign=nav-templates) · [Showcase](https://extension.js.org/showcase) · [Blog](https://extension.js.org/blog)
+[Documentation](https://extension.js.org/docs) · [Templates](https://templates.extension.dev/?utm_source=readme&utm_campaign=nav-templates) · [YouTube](https://www.youtube.com/@BrowserExtension) · [Showcase](https://extension.js.org/showcase) · [Blog](https://extension.js.org/blog)
 
 ## Why Extension.js
 
@@ -173,23 +173,25 @@ npx extension@latest dev https://github.com/GoogleChrome/chrome-extensions-sampl
 
 ## Package managers
 
-<div align="center">
-
-| <img alt="npm" src="https://media.extension.land/logos/package-managers/npm.svg" width="70"> | <img alt="pnpm" src="https://media.extension.land/logos/package-managers/pnpm.svg" width="70"> | <img alt="Yarn" src="https://media.extension.land/logos/package-managers/yarn.svg" width="70"> | <img alt="Bun" src="https://media.extension.land/logos/package-managers/bun.svg" width="70"> | <picture><source media="(prefers-color-scheme: dark)" srcset="https://media.extension.land/logos/package-managers/deno-dark.svg"><img alt="Deno" src="https://media.extension.land/logos/package-managers/deno.svg" width="70"></picture> |
-| :-: | :-: | :-: | :-: | :-: |
-| npm<br>✅ Supported | pnpm<br>✅ Supported | Yarn<br>✅ Supported | Bun<br>✅ Supported | Deno<br>✅ Supported |
+Add Extension.js to a project, or run it once without installing, with the package manager you already use.
 
-</div>
+| Package manager | Add to a project | Run without installing |
+| :-- | :-- | :-- |
+| npm | `npm install extension@latest --save-dev` | `npx extension@latest create my-extension` |
+| pnpm | `pnpm add extension@latest --save-dev` | `pnpm dlx extension@latest create my-extension` |
+| Yarn | `yarn add extension@latest --dev` | `yarn dlx extension@latest create my-extension` |
+| Bun | `bun add --dev extension@latest` | `bunx extension@latest create my-extension` |
+| Deno | `deno add npm:extension@latest` | `deno run -A npm:extension@latest create my-extension` |
 
-Each of these installs Extension.js, launches it, and runs its scripts. Which runtime the CLI then executes on is a separate question.
+Which runtime the CLI then executes on is a separate question, answered below.
 
 ## Runtimes
 
-| Runtime | Status | Notes |
-| :-- | :-- | :-- |
-| Node.js | ✅ 22.12 and newer | The default. `npx`, `pnpm dlx`, `yarn dlx` and `bunx` all land here through the published bin |
-| Deno | ✅ 2.5 and newer | `deno run -A npm:extension@latest`. Deno 2.8.0 is refused because it cannot load `node:querystring`, fixed in 2.8.1 |
-| Bun | ❌ Not a runtime for the CLI | Bun installs and launches Extension.js, which then runs on Node.js. `bunx --bun` and `bun run --bun` are refused |
+| | Runtime | Status | Notes |
+| :-: | :-- | :-- | :-- |
+| <img alt="Node.js" src="https://media.extension.land/logos/package-managers/node.svg" width="28"> | Node.js | ✅ 22.12 and newer | The default. `npx`, `pnpm dlx`, `yarn dlx` and `bunx` all land here through the published bin |
+| <picture><source media="(prefers-color-scheme: dark)" srcset="https://media.extension.land/logos/package-managers/deno-dark.svg"><img alt="Deno" src="https://media.extension.land/logos/package-managers/deno.svg" width="28"></picture> | Deno | ✅ 2.5 and newer | `deno run -A npm:extension@latest`. Deno 2.8.0 is refused because it cannot load `node:querystring`, fixed in 2.8.1 |
+| <img alt="Bun" src="https://media.extension.land/logos/package-managers/bun.svg" width="28"> | Bun | ✅ 1.2 and newer | `bunx --bun extension` and `bun run --bun`. Plain `bunx` runs the CLI on Node.js instead, through the published bin |
 
 ## Community
 

package/dist/{84.cjs → 597.cjs}

@@ -1,6 +1,6 @@
 "use strict";
 exports.ids = [
-    84
+    597
 ];
 exports.modules = {
     "./browsers/run-chromium/cdp/cdp-extension-controller/ensure.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
@@ -197,6 +197,7 @@ exports.modules = {
         var newtab_override = __webpack_require__("./browsers/browsers-lib/newtab-override.ts");
         var ready_stamp = __webpack_require__("./browsers/browsers-lib/ready-stamp.ts");
         var shared_utils = __webpack_require__("./browsers/browsers-lib/shared-utils.ts");
+        var write_json_atomic = __webpack_require__("./browsers/browsers-lib/write-json-atomic.ts");
         var external_ws_ = __webpack_require__("ws");
         var external_ws_default = /*#__PURE__*/ __webpack_require__.n(external_ws_);
         var constants = __webpack_require__("./browsers/browsers-lib/constants.ts");
@@ -482,6 +483,73 @@ exports.modules = {
                 this.host = host;
             }
         }
+        const EXTENSIONS_PAGE = 'chrome://extensions';
+        const READ_DEVELOPER_MODE = "new Promise((resolve) => chrome.developerPrivate.getProfileConfiguration((config) => resolve(!!config.inDeveloperMode)))";
+        const ENABLE_DEVELOPER_MODE = "new Promise((resolve) => chrome.developerPrivate.updateProfileConfiguration({inDeveloperMode: true}, () => resolve(!chrome.runtime.lastError)))";
+        function developerModeFromProfile(profilePath) {
+            try {
+                const securePath = external_node_path_.join(profilePath, 'Default', 'Secure Preferences');
+                const parsed = JSON.parse(external_node_fs_.readFileSync(securePath, 'utf-8'));
+                return parsed?.extensions?.ui?.developer_mode === true;
+            } catch  {
+                return false;
+            }
+        }
+        function developerModeFlipIsSafe(browserArgs) {
+            return !browserArgs.some((arg)=>arg.startsWith('--no-startup-window'));
+        }
+        async function evaluateBoolean(transport, sessionId, expression) {
+            try {
+                const response = await transport.sendCommand('Runtime.evaluate', {
+                    expression,
+                    awaitPromise: true,
+                    returnByValue: true
+                }, sessionId);
+                const value = response?.result?.value;
+                return 'boolean' == typeof value ? value : void 0;
+            } catch  {
+                return;
+            }
+        }
+        async function ensureDeveloperMode(options) {
+            const { transport } = options;
+            const attempts = options.attempts ?? 10;
+            const delayMs = options.delayMs ?? 200;
+            const sleep = options.sleep ?? ((ms)=>new Promise((r)=>setTimeout(r, ms)));
+            let targetId = '';
+            try {
+                const created = await transport.sendCommand('Target.createTarget', {
+                    url: EXTENSIONS_PAGE,
+                    background: true
+                });
+                targetId = created?.targetId ?? '';
+                if (!targetId) return 'unavailable';
+                const attached = await transport.sendCommand('Target.attachToTarget', {
+                    targetId,
+                    flatten: true
+                });
+                const sessionId = attached?.sessionId ?? '';
+                if (!sessionId) return 'unavailable';
+                for(let attempt = 0; attempt < attempts; attempt++){
+                    const current = await evaluateBoolean(transport, sessionId, READ_DEVELOPER_MODE);
+                    if (true === current) return 'already-on';
+                    if (false === current) {
+                        const enabled = await evaluateBoolean(transport, sessionId, ENABLE_DEVELOPER_MODE);
+                        return true === enabled ? 'enabled' : 'unavailable';
+                    }
+                    await sleep(delayMs);
+                }
+                return 'unavailable';
+            } catch  {
+                return 'unavailable';
+            } finally{
+                if (targetId) try {
+                    await transport.sendCommand('Target.closeTarget', {
+                        targetId
+                    });
+                } catch  {}
+            }
+        }
         function isRecoverableBootstrapError(error) {
             const msg = String(error?.message || error || '').toLowerCase();
             return msg.includes('econnreset') || msg.includes('websocket is not open') || msg.includes('cdp transport is not open') || msg.includes('cdp connection closed') || msg.includes('cdp pipe closed') || msg.includes('socket hang up') || msg.includes('timed out') || msg.includes('no cdp websocket url');
@@ -783,6 +851,12 @@ exports.modules = {
                 if (this.cdp) return;
                 await this.connectFreshClient();
             }
+            async ensureDeveloperMode() {
+                if (!this.cdp) return 'unavailable';
+                return ensureDeveloperMode({
+                    transport: this.cdp
+                });
+            }
             async openTab(url) {
                 if (!this.cdp) return;
                 await this.cdp.sendCommand('Target.createTarget', {
@@ -1109,6 +1183,10 @@ exports.modules = {
             });
             await cdpExtensionController.connect();
             if ((0, messaging._o)()) (0, messaging._w)(messages.M3('127.0.0.1', chromeRemoteDebugPort));
+            if (userDataDir && developerModeFlipIsSafe(chromiumArgs) && !developerModeFromProfile(userDataDir)) {
+                const developerMode = await cdpExtensionController.ensureDeveloperMode();
+                if ((0, messaging._o)()) (0, messaging._w)(`[CDP] developer mode: ${developerMode}`);
+            }
             try {
                 if (extensionOutputPath && Number.isFinite(chromeRemoteDebugPort)) {
                     const readyPath = external_node_path_.join(external_node_path_.dirname(extensionOutputPath), 'extension-js', external_node_path_.basename(extensionOutputPath), 'ready.json');
@@ -1116,7 +1194,7 @@ exports.modules = {
                         const ready = JSON.parse(external_node_fs_.readFileSync(readyPath, 'utf-8'));
                         if (ready.cdpPort !== chromeRemoteDebugPort) {
                             ready.cdpPort = chromeRemoteDebugPort;
-                            external_node_fs_.writeFileSync(readyPath, JSON.stringify(ready, null, 2));
+                            (0, write_json_atomic.Z)(readyPath, ready);
                         }
                     }
                 }