browser-extension-manager 1.3.21 → 1.3.23

package/CLAUDE.md

@@ -1,12 +1,12 @@
-# Browser Extension Manager (BEM)
+# Browser Extension Manager (BXM)
 
 ## Identity
 
-Browser Extension Manager (BEM) is a comprehensive framework for building modern browser extensions. It provides a template-based development system with built-in build tools, component architecture, theming support, and best practices for creating cross-browser extensions.
+Browser Extension Manager (BXM) is a comprehensive framework for building modern browser extensions. It provides a template-based development system with built-in build tools, component architecture, theming support, and best practices for creating cross-browser extensions.
 
 ## Quick Start
 
-### For Consuming Projects (Extensions Built Using BEM)
+### For Consuming Projects (Extensions Built Using BXM)
 1. Run `npx bxm setup` to initialize the project
 2. Run `npm start` to start development
 3. Load `packaged/raw/` directory in browser as unpacked extension
@@ -14,7 +14,7 @@ Browser Extension Manager (BEM) is a comprehensive framework for building modern
 
 ### For Framework Development (This Repository)
 1. Run `npm start` to watch and compile framework changes
-2. Test changes in a consuming project by linking: `npm link` (in BEM) then `npm link browser-extension-manager` (in consuming project)
+2. Test changes in a consuming project by linking: `npm link` (in BXM) then `npm link browser-extension-manager` (in consuming project)
 3. Changes in `src/` compile to `dist/` automatically
 
 ## Architecture Overview
@@ -131,7 +131,7 @@ browser-extension-manager/
 
 ## Consuming Project Structure
 
-When users create a project using BEM, they get this structure:
+When users create a project using BXM, they get this structure:
 
 ```
 my-extension/
@@ -149,7 +149,7 @@ my-extension/
 │   ├── _locales/                            # i18n translations
 │   └── manifest.json                        # Extension manifest
 ├── config/
-│   └── config.json                          # BEM configuration
+│   └── config.json                          # BXM configuration
 ├── hooks/
 │   ├── build:pre.js                         # Pre-build hook
 │   └── build:post.js                        # Post-build hook
@@ -354,7 +354,7 @@ Provides cross-context auth synchronization and reusable auth UI event handlers.
 
 ### Cross-Context Auth Architecture
 
-**Background.js is the source of truth** for authentication. Browser extensions have multiple isolated JavaScript contexts (background, popup, options, pages, sidepanel) - each runs its own Firebase instance. BEM syncs them via messaging (no storage).
+**Background.js is the source of truth** for authentication. Browser extensions have multiple isolated JavaScript contexts (background, popup, options, pages, sidepanel) - each runs its own Firebase instance. BXM syncs them via messaging (no storage).
 
 **Sign-in Flow:**
 ```
@@ -395,7 +395,7 @@ User clicks .auth-signout-btn
 
 2. **Firebase in service workers**: Static ES6 imports are required. Dynamic `import()` fails with webpack chunking in service workers.
 
-3. **Config path**: `authDomain` is at `config.firebase.app.config.authDomain` (loaded via BEM_BUILD_JSON).
+3. **Config path**: `authDomain` is at `config.firebase.app.config.authDomain` (loaded via BXM_BUILD_JSON).
 
 4. **Required permission**: `tabs` permission needed for `tabs.onUpdated` listener.
 
@@ -711,7 +711,7 @@ new ReplacePlugin({
 
 1. **Rebuild framework:** `npm run prepare`
 2. **Reinstall in consuming project:** `npm install browser-extension-manager@latest`
-3. **Or use local link:** `npm link` (in BEM) then `npm link browser-extension-manager` (in project)
+3. **Or use local link:** `npm link` (in BXM) then `npm link browser-extension-manager` (in project)
 
 ### Gulp task errors
 
@@ -736,7 +736,7 @@ new ReplacePlugin({
 ## Notable Dependencies
 
 ### Web Manager
-BEM integrates **Web Manager** for Firebase, analytics, and web services functionality. Each component manager initializes Web Manager automatically with configuration from `config/config.json`.
+BXM integrates **Web Manager** for Firebase, analytics, and web services functionality. Each component manager initializes Web Manager automatically with configuration from `config/config.json`.
 
 **Web Manager API:**
 - Study the Web Manager API and documentation in the sibling repository
@@ -744,7 +744,7 @@ BEM integrates **Web Manager** for Firebase, analytics, and web services functio
 - GitHub: https://github.com/itw-creative-works/web-manager
 - npm: https://www.npmjs.com/package/web-manager
 
-**Usage in BEM:**
+**Usage in BXM:**
 ```javascript
 const Manager = new (require('browser-extension-manager/popup'));
 

package/README.md

@@ -46,7 +46,7 @@ npm start
 1. Simply run `npx bxm setup` in Terminal to get all the latest updates from the **Ultimate Browser Extension template**.
 
 ## 🌐 Automatic Translation
-When you run `npm run build`, BEM automatically translates your `src/_locales/en/messages.json` to 16 languages using Claude CLI:
+When you run `npm run build`, BXM automatically translates your `src/_locales/en/messages.json` to 16 languages using Claude CLI:
 `zh`, `es`, `hi`, `ar`, `pt`, `ru`, `ja`, `de`, `fr`, `ko`, `ur`, `id`, `bn`, `tl`, `vi`, `it`
 
 Only missing translations are generated - existing translations are preserved.
@@ -58,7 +58,7 @@ Only missing translations are generated - existing translations are preserved.
 2. Upload the `.zip` file to the browser's extension store.
 
 ### Automatic Publishing
-BEM can automatically publish to Chrome, Firefox, and Edge stores when `BXM_IS_PUBLISH=true`:
+BXM can automatically publish to Chrome, Firefox, and Edge stores when `BXM_IS_PUBLISH=true`:
 
 ```bash
 BXM_IS_PUBLISH=true npm run build
@@ -88,7 +88,7 @@ Only stores with configured credentials will be published to.
 
 ## 🔐 Authentication
 
-BEM provides built-in authentication that syncs across all extension contexts (popup, options, pages, sidepanel, background).
+BXM provides built-in authentication that syncs across all extension contexts (popup, options, pages, sidepanel, background).
 
 ### How It Works
 

package/bin/browser-extension-manager

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const argv = require('yargs').argv;
+const argv = require('yargs')(process.argv.slice(2)).parseSync();
 const cli = new (require('../dist/cli.js'))(argv);
 (async function() {
   'use strict';

package/dist/background.js

@@ -27,13 +27,13 @@ class Manager {
     this.serviceWorker = null;
 
     // Load config from build.js
-    this.config = serviceWorker.BEM_BUILD_JSON?.config || {};
+    this.config = serviceWorker.BXM_BUILD_JSON?.config || {};
 
     // Defaults
     this.version = this.config?.version || 'unknown';
     this.brand = this.config?.brand || { name: 'unknown' };
     this.app = this.config?.app?.id || 'extension';
-    this.environment = this.config?.bem?.environment || 'production';
+    this.environment = this.config?.bxm?.environment || 'production';
     this.libraries = {
       firebase: null,
       firebaseAuth: null,
@@ -41,7 +41,7 @@ class Manager {
       promoServer: false,
     };
     this.cache = {
-      breaker: this.config?.bem?.cache_breaker || new Date().getTime(),
+      breaker: this.config?.bxm?.cache_breaker || new Date().getTime(),
       name: ''
     };
   }
@@ -73,7 +73,7 @@ class Manager {
 
     // Log
     this.logger.log('Initialized!', this.version, this.cache.name, this);
-    this.logger.log('Config loaded from BEM_BUILD_JSON:', this.config);
+    this.logger.log('Config loaded from BXM_BUILD_JSON:', this.config);
 
     // Return manager instance
     return this;
@@ -318,7 +318,7 @@ class Manager {
     // DEBUG: Log the full config to see what we have
     console.log('[AUTH] setupAuthTokenListener called');
     console.log('[AUTH] this.config:', this.config);
-    console.log('[AUTH] BEM_BUILD_JSON:', serviceWorker.BEM_BUILD_JSON);
+    console.log('[AUTH] BXM_BUILD_JSON:', serviceWorker.BXM_BUILD_JSON);
 
     // Get auth domain from config
     // Structure is: this.config.firebase.app.config.authDomain
@@ -516,7 +516,7 @@ class Manager {
     if (this.environment !== 'development') return;
 
     // Get port from config or use default
-    const port = this.config?.bem?.liveReloadPort || 35729;
+    const port = this.config?.bxm?.liveReloadPort || 35729;
 
     // Setup livereload
     const address = `ws://localhost:${port}/livereload`;
@@ -613,7 +613,7 @@ function setupGlobalHandlers() {
     }
 
     // Get website URL from config
-    const config = serviceWorker.BEM_BUILD_JSON?.config || {};
+    const config = serviceWorker.BXM_BUILD_JSON?.config || {};
     const website = config?.brand?.url;
 
     // Skip if no website configured

package/dist/build.js

@@ -3,7 +3,7 @@ const path = require('path');
 const jetpack = require('fs-jetpack');
 const fs = require('fs');
 const JSON5 = require('json5');
-const argv = require('yargs').argv;
+const argv = require('yargs')(process.argv.slice(2)).parseSync();
 const { force, execute } = require('node-powertools');
 
 // Class

package/dist/defaults/CLAUDE.md

@@ -1,7 +1,7 @@
 # Identity
-This is a browser extension that is "consuming" a browser extension template project called Browser Extension Manager (BEM)--a collection of components that can be used to build a browser extension quickly and efficiently.
+This is a browser extension that is "consuming" a browser extension template project called Browser Extension Manager (BXM)--a collection of components that can be used to build a browser extension quickly and efficiently.
 
-## BEM Documentation
+## BXM Documentation
 You should have a full understanding of Browser Extension Manager before editing this project, which can be found at: node_modules/browser-extension-manager/CLAUDE.md
 
 ## Project-specific Notes

package/dist/gulp/loaders/webpack/strip-dev-blocks-loader.js

@@ -13,7 +13,7 @@ function escapeRegex(str) {
 
 module.exports = function stripDevBlocksLoader(source) {
   // Only strip in build mode
-  if (process.env.BEM_BUILD_MODE !== 'true') {
+  if (process.env.BXM_BUILD_MODE !== 'true') {
     return source;
   }
 

package/dist/gulp/tasks/defaults.js

@@ -8,7 +8,7 @@ const path = require('path');
 const { minimatch } = require('minimatch');
 const { template } = require('node-powertools');
 const createTemplateTransform = require('./utils/template-transform');
-const argv = require('yargs').argv;
+const argv = require('yargs')(process.argv.slice(2)).parseSync();
 const JSON5 = require('json5');
 
 // Load package

package/dist/gulp/tasks/package.js

@@ -35,9 +35,9 @@ const JSONP_TEMPLATE = `
   const config = { config };
 
   // Assign to various global scopes for compatibility
-  if (typeof self !== 'undefined') self.BEM_BUILD_JSON = config;
-  if (typeof window !== 'undefined') window.BEM_BUILD_JSON = config;
-  if (typeof globalThis !== 'undefined') globalThis.BEM_BUILD_JSON = config;
+  if (typeof self !== 'undefined') self.BXM_BUILD_JSON = config;
+  if (typeof window !== 'undefined') window.BXM_BUILD_JSON = config;
+  if (typeof globalThis !== 'undefined') globalThis.BXM_BUILD_JSON = config;
 })();
 `.trim();
 
@@ -66,8 +66,8 @@ async function generateBuildJs(outputDir) {
         // Brand configuration (from browser-extension-manager.json or manifest)
         brand: config.brand || {},
 
-        // BEM-specific config
-        bem: {
+        // BXM-specific config
+        bxm: {
           environment: Manager.getEnvironment(),
           cache_breaker: Math.round(new Date().getTime() / 1000),
           liveReloadPort: config.liveReloadPort || 35729,

package/dist/gulp/tasks/webpack.js

@@ -52,7 +52,7 @@ const watchInput = [
   // All project assets js - watch for changes but don't compile as entry points
   'src/assets/js/**/*.js',
 
-  // All BEM package src files - watch for changes (includes background.js, popup.js, etc.)
+  // All BXM package src files - watch for changes (includes background.js, popup.js, etc.)
   `${rootPathPackage}/src/**/*.js`,
 
   // So we can watch for changes while we're developing web-manager
@@ -177,23 +177,27 @@ function getSettings() {
         {
           test: /\.js$/,
           exclude: /node_modules/,
-          use: {
-            loader: 'babel-loader',
-            options: {
-              sourceMaps: !Manager.actLikeProduction(),
-              presets: [
-                [require.resolve('@babel/preset-env', {
-                  paths: [path.resolve(process.cwd(), 'node_modules', package.name, 'node_modules')]
-                }), {
-                  exclude: [
-                    // Prevent lighthouse error in 2025 about Legacy JavaScript
-                    // 'es.array.from',
-                  ]
-                }]
-              ],
-              compact: Manager.isBuildMode(),
-            }
-          }
+          use: [
+            {
+              loader: 'babel-loader',
+              options: {
+                sourceMaps: !Manager.actLikeProduction(),
+                presets: [
+                  [require.resolve('@babel/preset-env', {
+                    paths: [path.resolve(process.cwd(), 'node_modules', package.name, 'node_modules')]
+                  }), {
+                    exclude: [
+                      // Prevent lighthouse error in 2025 about Legacy JavaScript
+                      // 'es.array.from',
+                    ]
+                  }]
+                ],
+                compact: Manager.isBuildMode(),
+              }
+            },
+            // Strip dev-only blocks before babel processes the file
+            stripDevBlocksLoader,
+          ]
         }
       ]
     },

package/dist/index.js

@@ -19,7 +19,7 @@
 //   const self = this;
 
 //   // Configuration
-//   const configuration = window.BEM_BUILD_JSON?.config;
+//   const configuration = window.BXM_BUILD_JSON?.config;
 
 //   // Initiate the web manager
 //   self.extension = require('./lib/extension');

package/dist/lib/auth-helpers.js

@@ -5,7 +5,7 @@
 // - Background.js is the SOURCE OF TRUTH for authentication
 // - On context load, contexts wait for WM auth to settle, then ask background if in sync
 // - If out of sync, background provides a fresh custom token (fetched from server)
-// - No BEM-specific storage - Web Manager handles auth state internally
+// - No BXM-specific storage - Web Manager handles auth state internally
 
 /**
  * Sync auth state with background.js on context load

package/dist/options.js

@@ -19,7 +19,7 @@ class Manager {
 
   async initialize() {
     // Configuration
-    const configuration = window.BEM_BUILD_JSON?.config;
+    const configuration = window.BXM_BUILD_JSON?.config;
 
     // Set properties
     this.extension = extension;

package/dist/page.js

@@ -19,7 +19,7 @@ class Manager {
 
   async initialize() {
     // Configuration
-    const configuration = window.BEM_BUILD_JSON?.config;
+    const configuration = window.BXM_BUILD_JSON?.config;
 
     // Set properties
     this.extension = extension;

package/dist/popup.js

@@ -19,7 +19,7 @@ class Manager {
 
   async initialize() {
     // Configuration
-    const configuration = window.BEM_BUILD_JSON?.config;
+    const configuration = window.BXM_BUILD_JSON?.config;
 
     // Set properties
     this.extension = extension;

package/dist/sidepanel.js

@@ -19,7 +19,7 @@ class Manager {
 
   async initialize() {
     // Configuration
-    const configuration = window.BEM_BUILD_JSON?.config;
+    const configuration = window.BXM_BUILD_JSON?.config;
 
     // Set properties
     this.extension = extension;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browser-extension-manager",
-  "version": "1.3.21",
+  "version": "1.3.23",
   "description": "Browser Extension Manager dependency manager",
   "main": "dist/index.js",
   "exports": {
@@ -66,8 +66,8 @@
   },
   "homepage": "https://template.itwcreativeworks.com",
   "dependencies": {
-    "@babel/core": "^7.28.5",
-    "@babel/preset-env": "^7.28.5",
+    "@babel/core": "^7.28.6",
+    "@babel/preset-env": "^7.28.6",
     "@popperjs/core": "^2.11.8",
     "babel-loader": "^10.0.0",
     "chalk": "^5.6.2",
@@ -81,18 +81,18 @@
     "gulp-sass": "^6.0.1",
     "itwcw-package-analytics": "^1.0.6",
     "json5": "^2.2.3",
-    "lodash": "^4.17.21",
+    "lodash": "^4.17.23",
     "minimatch": "^10.1.1",
     "node-powertools": "^2.3.2",
     "npm-api": "^1.0.1",
-    "sass": "^1.97.1",
+    "sass": "^1.97.3",
     "through2": "^4.0.2",
-    "web-manager": "^4.1.3",
+    "web-manager": "^4.1.6",
     "webpack": "^5.104.1",
     "wonderful-fetch": "^1.3.4",
     "wonderful-version": "^1.3.2",
-    "ws": "^8.18.3",
-    "yargs": "^17.7.2"
+    "ws": "^8.19.0",
+    "yargs": "^18.0.0"
   },
   "peerDependencies": {
     "gulp": "^5.0.1"

package/dist/gulp/plugins/webpack/strip-dev-blocks.js

@@ -1,53 +0,0 @@
-// Plugin: StripDevBlocksPlugin
-class StripDevBlocksPlugin {
-  constructor(options = {}) {
-    this.options = Object.assign(
-      {
-        fileTest: /\.js$/,
-        startMarker: '/* @dev-only:start */',
-        endMarker: '/* @dev-only:end */',
-      },
-      options
-    )
-    this.enabled = process.env.BEM_BUILD_MODE === 'true'
-  }
-
-  apply(compiler) {
-    if (!this.enabled) return
-
-    compiler.hooks.compilation.tap('StripDevBlocksPlugin', (compilation) => {
-      compilation.hooks.processAssets.tap(
-        {
-          name: 'StripDevBlocksPlugin',
-          stage: compilation.PROCESS_ASSETS_STAGE_OPTIMIZE,
-        },
-        (assets) => {
-          for (const filename in assets) {
-            if (!this.options.fileTest.test(filename)) continue
-
-            let source = assets[filename].source()
-
-            // Strip everything between start and end marker
-            const pattern = new RegExp(
-              `${this.escape(this.options.startMarker)}[\\s\\S]*?${this.escape(this.options.endMarker)}`,
-              'g'
-            )
-            source = source.replace(pattern, '')
-
-            compilation.updateAsset(
-              filename,
-              new compiler.webpack.sources.RawSource(source)
-            )
-          }
-        }
-      )
-    })
-  }
-
-  escape(str) {
-    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
-  }
-}
-
-// Export
-module.exports = StripDevBlocksPlugin