browser-extension-manager 1.3.28 → 1.3.30

package/dist/commands/clean.js

@@ -3,12 +3,13 @@ const Manager = new (require('../build.js'));
 const logger = Manager.logger('clean');
 const { execSync } = require('child_process');
 const jetpack = require('fs-jetpack');
+const path = require('path');
 
 // Load package
 const package = Manager.getPackage('main');
 const project = Manager.getPackage('project');
 
-// Const dirs
+// Dirs to clean
 const dirs = [
   '.temp',
   'dist',
@@ -16,11 +17,29 @@ const dirs = [
   // 'src/assets/themes',
 ]
 
+// Dirs to preserve inside cleaned dirs
+const preserve = [
+  'packaged/translations',
+]
+
 module.exports = async function (options) {
   // Log
   logger.log(`Cleaning up .temp, dist, and packaged directories...`);
 
   try {
+    // Back up preserved dirs
+    const backups = {};
+    for (const dir of preserve) {
+      if (!jetpack.exists(dir)) {
+        continue;
+      }
+
+      const backupPath = path.join('.temp', '_preserve', dir);
+      jetpack.dir(path.dirname(backupPath));
+      jetpack.move(dir, backupPath, { overwrite: true });
+      backups[dir] = backupPath;
+    }
+
     // Loop through dirs
     dirs.forEach((dir) => {
       // Remove (use rm -rf on Unix for speed, fallback to jetpack on Windows)
@@ -33,6 +52,16 @@ module.exports = async function (options) {
       // Create empty dir
       jetpack.dir(dir);
     });
+
+    // Restore preserved dirs
+    for (const [dir, backupPath] of Object.entries(backups)) {
+      jetpack.dir(path.dirname(dir));
+      jetpack.move(backupPath, dir, { overwrite: true });
+      logger.log(`Preserved: ${dir}`);
+    }
+
+    // Clean up temp preserve dir
+    jetpack.remove(path.join('.temp', '_preserve'));
   } catch (e) {
     logger.error(`Error clearing directories: ${e}`);
   }

package/dist/defaults/config/description.md

@@ -0,0 +1,46 @@
+🚀 Enhance Your Browsing Experience Instantly
+🧠 Smart Features That Work in the Background
+⚡ One-Click Setup — No Configuration Needed
+🎯 Customizable Settings — Your Browser, Your Rules
+💡 Lightweight, Fast, Zero Bloat
+
+{{ brand.name }} is your all-in-one browser companion that makes the web work better for you. No more frustrating browsing experiences. No more wasting time on repetitive tasks. No more settling for a browser that doesn't do enough.
+If you want a smarter, faster, and more enjoyable browsing experience — {{ brand.name }} was made for you.
+
+🔍 How it works
+{{ brand.name }} runs quietly in the background, enhancing your browsing experience automatically.
+
+🧠 Smart Detection: Knows when to activate and when to stay out of the way
+🔧 Powerful Tools: Access everything you need from a simple popup
+⚙️ Customizable: Tailor the extension to fit your browsing habits
+🌐 Works Everywhere: Compatible with all your favorite websites
+
+Click the icon, adjust your settings, and browse better. Everything else just works.
+No complicated setup. No learning curve. Just a better browsing experience, instantly.
+
+✨ Why {{ brand.name }} is a game changer
+
+Save time: Automate repetitive tasks and get more done with less effort.
+Stay in control: Customize every aspect of the extension to match your preferences.
+Browse smarter: Intelligent features that adapt to how you use the web.
+Clean and fast: Minimal footprint — no slowdowns, no clutter, no unnecessary bloat.
+Private and secure: No cloud accounts required. No tracking. Everything runs locally and respects your privacy.
+
+🧠 The {{ brand.name }} Difference
+Most people either:
+
+Settle for a bare-bones browser with no enhancements
+Install a dozen separate extensions that slow everything down
+
+{{ brand.name }} gives you a better option: one powerful extension that does it all — cleanly, efficiently, and without getting in your way.
+Think of it as a supercharger for your browser ⚡
+Whether you're working, researching, shopping, or just casually browsing — {{ brand.name }} makes every session better.
+
+🔥 Install {{ brand.name }} now and upgrade the way you browse.
+Stop settling for a basic browser. Start browsing smarter.
+
+💸 Bonus:
+While you're browsing, the extension also finds and applies shopping deals from top partners like Amazon, Capital One, and NordVPN. Get discounts and bonuses without lifting a finger. When you buy through links on our extension, we may earn an affiliate commission.
+
+🔐 Your privacy is respected — we do not sell or misuse your data. By using our extension, you agree to our terms of service and privacy policy.
+When you buy through links on our extension, we may earn an affiliate commission.

package/dist/gulp/tasks/defaults.js

@@ -66,11 +66,17 @@ const FILE_MAP = {
     mergeLines: true,
   },
 
-  // Config file with smart merging
+  // Config files
   'config/browser-extension-manager.json': {
     overwrite: true,
     merge: true,
   },
+  'config/messages.json': {
+    overwrite: false,
+  },
+  'config/description.md': {
+    overwrite: false,
+  },
 
   // Files to run templating on
   '.nvmrc': {

package/dist/gulp/tasks/translate.js

@@ -1,153 +1,188 @@
 // Libraries
 const Manager = new (require('../../build.js'));
 const logger = Manager.logger('translate');
+const { query } = require('@anthropic-ai/claude-agent-sdk');
 const { series } = require('gulp');
 const jetpack = require('fs-jetpack');
 const path = require('path');
-const { execute } = require('node-powertools');
+const crypto = require('crypto');
 const JSON5 = require('json5');
 
 // Locale config (shared with audit.js)
 const { limits: LOCALE_LIMITS, languages: LANGUAGES } = require('../config/locales.js');
 
 // Paths
+const configMessagesPath = path.join(process.cwd(), 'config', 'messages.json');
+const configDescriptionPath = path.join(process.cwd(), 'config', 'description.md');
 const localesDir = path.join(process.cwd(), 'src', '_locales');
 const enMessagesPath = path.join(localesDir, 'en', 'messages.json');
+const translationsDir = path.join(process.cwd(), 'packaged', 'translations');
+const descriptionDir = path.join(translationsDir, 'description');
+const cacheDir = path.join(process.cwd(), '.cache');
+const cachePath = path.join(cacheDir, 'translate.json');
+
+// Helper: Compute hash of a string
+function hash(content) {
+  return crypto.createHash('md5').update(content).digest('hex');
+}
+
+// Helper: Read cache
+function readCache() {
+  if (!jetpack.exists(cachePath)) {
+    return {};
+  }
 
-// Check if Claude CLI is installed
-async function isClaudeInstalled() {
   try {
-    await execute('which claude');
-    return true;
+    return JSON.parse(jetpack.read(cachePath));
   } catch (e) {
-    return false;
+    return {};
   }
 }
 
-// Main translate task
-async function translate(complete) {
-  // Only run in build mode
-  if (!Manager.isBuildMode()) {
-    logger.log('Skipping translation (not in build mode)');
-    return complete();
-  }
+// Helper: Write cache
+function writeCache(cache) {
+  jetpack.dir(cacheDir);
+  jetpack.write(cachePath, JSON.stringify(cache, null, 2));
+}
 
-  // Check if Claude CLI is installed
-  if (!await isClaudeInstalled()) {
-    logger.log('Skipping translation (Claude CLI not installed)');
-    return complete();
-  }
+// Helper: Check if source has changed since last translation
+function hasSourceChanged(cacheKey, content) {
+  const cache = readCache();
+  const currentHash = hash(content);
 
-  // Log
-  logger.log('Starting translation...');
+  return cache[cacheKey] !== currentHash;
+}
 
-  // Check if English messages exist
-  if (!jetpack.exists(enMessagesPath)) {
-    logger.warn(`English messages not found at ${enMessagesPath}`);
-    return complete();
+// Helper: Update cache hash for a source
+function updateCacheHash(cacheKey, content) {
+  const cache = readCache();
+
+  cache[cacheKey] = hash(content);
+
+  writeCache(cache);
+}
+
+// Helper: Read and parse config/messages.json
+function readConfigMessages() {
+  if (!jetpack.exists(configMessagesPath)) {
+    return null;
   }
 
-  // Read English messages
-  let enMessages;
   try {
-    enMessages = JSON5.parse(jetpack.read(enMessagesPath));
+    return JSON5.parse(jetpack.read(configMessagesPath));
   } catch (e) {
-    logger.error(`Failed to parse English messages: ${e.message}`);
-    return complete();
+    logger.error(`Failed to parse config/messages.json: ${e.message}`);
+    return null;
   }
+}
 
-  // Get English keys
-  const enKeys = Object.keys(enMessages);
-  logger.log(`Found ${enKeys.length} keys in English messages`);
-
-  // Check which languages need translation
-  const languagesToTranslate = [];
-
-  for (const lang of Object.keys(LANGUAGES)) {
-    const langDir = path.join(localesDir, lang);
-    const langMessagesPath = path.join(langDir, 'messages.json');
-
-    // Check if translation exists
-    const exists = jetpack.exists(langMessagesPath);
-
-    if (!exists) {
-      languagesToTranslate.push({ lang, missingKeys: enKeys, existingMessages: {} });
-      continue;
-    }
-
-    // Check for missing keys
-    try {
-      const existingMessages = JSON5.parse(jetpack.read(langMessagesPath));
-      const missingKeys = enKeys.filter(key => !existingMessages[key]);
-
-      if (missingKeys.length > 0) {
-        logger.log(`[${lang}] Found ${missingKeys.length} missing keys`);
-        languagesToTranslate.push({ lang, missingKeys, existingMessages });
-      } else {
-        logger.log(`[${lang}] Up to date, skipping`);
+// Helper: Call Claude Agent SDK with a prompt and parse JSON from the response
+async function callClaude(prompt) {
+  let result = '';
+
+  for await (const message of query({
+    prompt,
+    options: {
+      model: 'claude-sonnet-4-5-20250929',
+      maxTurns: 1,
+      allowedTools: [],
+      thinking: { type: 'disabled' },
+    },
+  })) {
+    // Collect assistant text
+    if (message.type === 'assistant' && message.message?.content) {
+      for (const block of message.message.content) {
+        if (block.type === 'text') {
+          result += block.text;
+        }
       }
-    } catch (e) {
-      logger.warn(`[${lang}] Failed to parse existing messages, will retranslate: ${e.message}`);
-      languagesToTranslate.push({ lang, missingKeys: enKeys, existingMessages: {} });
     }
   }
 
-  // Skip if nothing to translate
-  if (languagesToTranslate.length === 0) {
-    logger.log('All translations up to date');
-    return complete();
+  logger.log(`Claude responded (${result.length} chars)`);
+
+  // Parse JSON from response
+  const jsonMatch = result.match(/\{[\s\S]*\}/);
+  if (!jsonMatch) {
+    throw new Error('No JSON found in Claude response');
   }
 
-  logger.log(`Translating ${languagesToTranslate.length} languages in one call...`);
+  return JSON.parse(jsonMatch[0]);
+}
 
-  // Translate all languages at once
-  try {
-    const translations = await translateAllWithClaude(enMessages, languagesToTranslate);
+// Helper: Split an object into chunks of a given size
+function chunkObject(obj, size) {
+  const entries = Object.entries(obj);
+  const chunks = [];
 
-    // Write each translation
-    for (const { lang, existingMessages } of languagesToTranslate) {
-      const langDir = path.join(localesDir, lang);
-      const langMessagesPath = path.join(langDir, 'messages.json');
+  for (let i = 0; i < entries.length; i += size) {
+    chunks.push(Object.fromEntries(entries.slice(i, i + size)));
+  }
 
-      if (translations[lang]) {
-        // Merge with existing messages
-        const finalMessages = { ...existingMessages, ...translations[lang] };
+  return chunks;
+}
 
-        // Ensure directory exists
-        jetpack.dir(langDir);
+// Copy config files to src/ locations
+// Always runs (dev + build) so distribute task has the latest files
+async function copyConfigFiles(complete) {
+  // Copy config/messages.json → src/_locales/en/messages.json
+  const enMessages = readConfigMessages();
+  if (enMessages) {
+    jetpack.dir(path.join(localesDir, 'en'));
+    jetpack.write(enMessagesPath, JSON.stringify(enMessages, null, 2));
+    logger.log('Copied config/messages.json → src/_locales/en/messages.json');
+  } else {
+    logger.warn('config/messages.json not found or invalid, skipping');
+  }
 
-        // Write translated messages
-        jetpack.write(langMessagesPath, JSON.stringify(finalMessages, null, 2));
+  // Complete
+  return complete();
+}
 
-        logger.log(`[${lang}] Translation saved`);
-      } else {
-        logger.warn(`[${lang}] No translation returned`);
-      }
-    }
-  } catch (e) {
-    logger.error(`Translation failed: ${e.message}`);
+// Translate messages.json into all configured languages
+// Only runs in build mode
+async function translateMessages(complete) {
+  // Only run in build mode
+  if (!Manager.isBuildMode()) {
+    logger.log('Skipping messages translation (not in build mode)');
+    return complete();
   }
 
   // Log
-  logger.log('Translation finished!');
+  logger.log('Starting messages translation...');
 
-  // Complete
-  return complete();
-}
+  // Read config/messages.json
+  const enMessages = readConfigMessages();
+  if (!enMessages) {
+    logger.warn('config/messages.json not found or invalid, skipping');
+    return complete();
+  }
+
+  // Check if source has changed
+  const sourceContent = jetpack.read(configMessagesPath);
+  if (!hasSourceChanged('messages', sourceContent)) {
+    logger.log('config/messages.json unchanged since last translation, skipping');
+    return complete();
+  }
+
+  // Get English keys
+  const enKeys = Object.keys(enMessages);
+  logger.log(`Found ${enKeys.length} keys in config/messages.json`);
 
-// Translate all languages using a single Claude CLI call
-async function translateAllWithClaude(enMessages, languagesToTranslate) {
-  // Build language info for prompt
-  const languageList = languagesToTranslate.map(({ lang }) =>
-    `- "${lang}": ${LANGUAGES[lang]}`
-  ).join('\n');
+  // Build language list
+  const languageList = Object.entries(LANGUAGES)
+    .map(([code, name]) => `- "${code}": ${name}`)
+    .join('\n');
 
   // Build character limits info
   const limitsInfo = Object.entries(LOCALE_LIMITS)
     .map(([field, limit]) => `- ${field}: max ${limit} characters`)
     .join('\n');
 
-  const prompt = `Translate the following Chrome extension messages.json content from English to multiple languages.
+  logger.log(`Translating messages into ${Object.keys(LANGUAGES).length} languages...`);
+
+  try {
+    const translations = await callClaude(`Translate the following Chrome extension messages.json content from English to multiple languages.
 
 TARGET LANGUAGES:
 ${languageList}
@@ -174,48 +209,135 @@ OUTPUT FORMAT:
   ...
 }
 
-Output the translated JSON:`;
+Output the translated JSON:`);
+
+    // Write each translation
+    for (const lang of Object.keys(LANGUAGES)) {
+      if (!translations[lang]) {
+        logger.warn(`[${lang}] No translation returned`);
+        continue;
+      }
+
+      const langDir = path.join(localesDir, lang);
+      const langMessagesPath = path.join(langDir, 'messages.json');
+
+      jetpack.dir(langDir);
+      jetpack.write(langMessagesPath, JSON.stringify(translations[lang], null, 2));
+      logger.log(`[${lang}] Messages translation saved`);
+    }
+
+    // Update cache
+    updateCacheHash('messages', sourceContent);
+  } catch (e) {
+    logger.error(`Messages translation failed: ${e.message}`);
+  }
+
+  // Log
+  logger.log('Messages translation finished!');
+
+  // Complete
+  return complete();
+}
+
+// Translate description.md into all configured languages
+// Only runs in build mode
+async function translateDescription(complete) {
+  // Only run in build mode
+  if (!Manager.isBuildMode()) {
+    logger.log('Skipping description translation (not in build mode)');
+    return complete();
+  }
+
+  // Log
+  logger.log('Starting description translation...');
+
+  // Check if English description exists
+  if (!jetpack.exists(configDescriptionPath)) {
+    logger.log('config/description.md not found, skipping');
+    return complete();
+  }
+
+  // Read English description
+  const enDescription = jetpack.read(configDescriptionPath);
+  if (!enDescription || !enDescription.trim()) {
+    logger.warn('config/description.md is empty, skipping');
+    return complete();
+  }
 
-  // Write prompt to temp file to avoid shell escaping issues
-  const tempDir = path.join(process.cwd(), '.temp');
-  const tempFile = path.join(tempDir, 'translate-all.txt');
+  // Check if source has changed
+  if (!hasSourceChanged('description', enDescription)) {
+    logger.log('config/description.md unchanged since last translation, skipping');
+    return complete();
+  }
+
+  logger.log(`Found config/description.md (${enDescription.length} chars)`);
+
+  // Batch languages into chunks to avoid output size limits
+  const BATCH_SIZE = 4;
+  const batches = chunkObject(LANGUAGES, BATCH_SIZE);
+
+  logger.log(`Translating description into ${Object.keys(LANGUAGES).length} languages (${batches.length} batches of ${BATCH_SIZE})...`);
+
+  // Ensure description directory exists
+  jetpack.dir(descriptionDir);
 
   try {
-    // Ensure temp dir exists and write prompt
-    jetpack.dir(tempDir);
-    jetpack.write(tempFile, prompt);
+    for (let i = 0; i < batches.length; i++) {
+      const batch = batches[i];
+      const languageList = Object.entries(batch)
+        .map(([code, name]) => `- "${code}": ${name}`)
+        .join('\n');
 
-    // Build command - pipe from file
-    const command = `cat "${tempFile}" | claude -p -`;
+      logger.log(`Batch ${i + 1}/${batches.length}: translating ${Object.keys(batch).join(', ')}...`);
 
-    // Log start
-    logger.log('Calling Claude CLI...');
+      const translations = await callClaude(`Translate the following Chrome extension store description from English to multiple languages.
 
-    // Run Claude CLI
-    const result = await execute(command);
+TARGET LANGUAGES:
+${languageList}
 
-    // Log response received
-    logger.log(`Claude CLI responded (${result.length} chars)`);
+IMPORTANT RULES:
+1. Translate ALL text content including emoji labels and descriptions
+2. Keep all emojis exactly as they are
+3. Preserve the markdown formatting (headers, bold, bullet points, etc.)
+4. Keep brand names, product names, and company names in English (e.g., Amazon, Capital One, NordVPN)
+5. Maintain the same tone — enthusiastic, conversational, and persuasive
+6. Return ONLY valid JSON, no markdown code fences, no explanation
+7. Return a JSON object where each key is the language code and the value is the full translated description as a string
 
-    // Clean up temp file
-    jetpack.remove(tempFile);
+INPUT (English):
+${enDescription}
 
-    // Parse result - extract JSON from response
-    const jsonMatch = result.match(/\{[\s\S]*\}/);
-    if (!jsonMatch) {
-      throw new Error('No JSON found in Claude response');
-    }
+OUTPUT FORMAT:
+{
+${Object.keys(batch).map((code) => `  "${code}": "full translated description here..."`).join(',\n')}
+}
+
+Output the translated JSON:`);
+
+      // Write each translation in this batch
+      for (const lang of Object.keys(batch)) {
+        if (!translations[lang]) {
+          logger.warn(`[${lang}] No description translation returned`);
+          continue;
+        }
 
-    // Log success
-    logger.log('Parsed JSON successfully');
+        jetpack.write(path.join(descriptionDir, `${lang}.md`), translations[lang]);
+        logger.log(`[${lang}] Description translation saved`);
+      }
+    }
 
-    return JSON.parse(jsonMatch[0]);
+    // Update cache
+    updateCacheHash('description', enDescription);
   } catch (e) {
-    // Clean up temp file on error
-    jetpack.remove(tempFile);
-    throw new Error(`Claude CLI failed: ${e.message}`);
+    logger.error(`Description translation failed: ${e.message}`);
   }
+
+  // Log
+  logger.log('Description translation finished!');
+
+  // Complete
+  return complete();
 }
 
 // Export task
-module.exports = series(translate);
+module.exports = series(copyConfigFiles, translateMessages, translateDescription);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browser-extension-manager",
-  "version": "1.3.28",
+  "version": "1.3.30",
   "description": "Browser Extension Manager dependency manager",
   "main": "dist/index.js",
   "exports": {
@@ -66,14 +66,15 @@
   },
   "homepage": "https://template.itwcreativeworks.com",
   "dependencies": {
-    "@babel/core": "^7.28.6",
-    "@babel/preset-env": "^7.28.6",
+    "@anthropic-ai/claude-agent-sdk": "^0.2.20",
+    "@babel/core": "^7.29.0",
+    "@babel/preset-env": "^7.29.0",
     "@popperjs/core": "^2.11.8",
     "babel-loader": "^10.0.0",
     "chalk": "^5.6.2",
-    "dotenv": "^17.2.3",
+    "dotenv": "^17.2.4",
     "fs-jetpack": "^5.1.0",
-    "glob": "^13.0.0",
+    "glob": "^13.0.1",
     "gulp-clean-css": "^4.3.0",
     "gulp-filter": "^9.0.1",
     "gulp-rename": "^2.1.0",
@@ -82,13 +83,13 @@
     "itwcw-package-analytics": "^1.0.8",
     "json5": "^2.2.3",
     "lodash": "^4.17.23",
-    "minimatch": "^10.1.1",
+    "minimatch": "^10.1.2",
     "node-powertools": "^2.3.2",
     "npm-api": "^1.0.1",
     "sass": "^1.97.3",
     "through2": "^4.0.2",
     "web-manager": "^4.1.6",
-    "webpack": "^5.104.1",
+    "webpack": "^5.105.0",
     "wonderful-fetch": "^1.3.4",
     "wonderful-version": "^1.3.2",
     "ws": "^8.19.0",