i18ntk 2.1.0 → 2.3.0

package/main/manage/services/AuthenticationService.js

@@ -4,7 +4,8 @@
  * @module services/AuthenticationService
  */
 
-const AdminAuth = require('../../../utils/admin-auth');
+const AdminAuth = require('../../../utils/admin-auth');
+const cliHelper = require('../../../utils/cli-helper');
 
 module.exports = class AuthenticationService {
   constructor(config = {}) {
@@ -74,8 +75,7 @@ module.exports = class AuthenticationService {
     }
 
     console.log(ui ? ui.t('adminCli.authRequired') : 'Admin authentication required');
-    const cliHelper = require('../../../utils/cli-helper');
-    const pin = await cliHelper.promptPin(ui ? ui.t('adminCli.enterPin') : 'Enter PIN: ');
+    const pin = await cliHelper.promptPin(ui ? ui.t('adminCli.enterPin') : 'Enter PIN: ');
     const isValid = await this.verifyPin(pin);
 
     if (!isValid) {
@@ -131,8 +131,7 @@ module.exports = class AuthenticationService {
    * @returns {Promise<string>} User input or empty string
    */
   async prompt(question) {
-    const cliHelper = require('../../../utils/cli-helper');
-    // If interactive not available, return empty string to avoid hangs
+    // If interactive not available, return empty string to avoid hangs
     if (!process.stdin.isTTY || process.stdin.destroyed) {
       console.log('\n⚠️ Interactive input not available, using default response.');
       return Promise.resolve('');
@@ -260,4 +259,4 @@ module.exports = class AuthenticationService {
       process.exit(1);
     }
   }
-};
+};

package/main/manage/services/ConfigurationService.js

@@ -8,12 +8,14 @@ const path = require('path');
 const configManager = require('../../../settings/settings-manager');
 const { loadTranslations, t, refreshLanguageFromSettings } = require('../../../utils/i18n-helper');
 
-const { createPrompt, isInteractive } = require('../../../utils/prompt-helper');
-const { loadConfig, saveConfig, ensureConfigDefaults } = require('../../../utils/config');
-const { getUnifiedConfig, ensureInitialized, validateSourceDir } = require('../../../utils/config-helper');
-const cliHelper = require('../../../utils/cli-helper');
-const pkg = require('../../../package.json');
-const SetupEnforcer = require('../../../utils/setup-enforcer');
+const { createPrompt, isInteractive } = require('../../../utils/prompt-helper');
+const { loadConfig, saveConfig, ensureConfigDefaults } = require('../../../utils/config');
+const { getUnifiedConfig, ensureInitialized, validateSourceDir } = require('../../../utils/config-helper');
+const { checkInitialized } = require('../../../utils/init-helper');
+const cliHelper = require('../../../utils/cli-helper');
+const pkg = require('../../../package.json');
+const SetupEnforcer = require('../../../utils/setup-enforcer');
+const FrameworkDetectionService = require('./FrameworkDetectionService');
 
 module.exports = class ConfigurationService {
   constructor(config = {}) {
@@ -54,9 +56,8 @@ module.exports = class ConfigurationService {
       loadTranslations(uiLanguage);
 
       // Validate source directory exists
-      const { validateSourceDir, displayPaths } = require('../../../utils/config-helper');
-      try {
-        validateSourceDir(this.config.sourceDir, 'i18ntk-manage');
+      try {
+        validateSourceDir(this.config.sourceDir, 'i18ntk-manage');
       } catch (err) {
         console.log(t('init.requiredTitle'));
         console.log(t('init.requiredBody'));
@@ -102,23 +103,18 @@ module.exports = class ConfigurationService {
       // Ensure setup is complete before running any operations
       await SetupEnforcer.checkSetupCompleteAsync();
 
-      prompt = createPrompt({ noPrompt: args.noPrompt || Boolean(args.adminPin) });
-      const interactive = isInteractive({ noPrompt: args.noPrompt || Boolean(args.adminPin) });
+      prompt = createPrompt({ noPrompt: args.noPrompt });
+      const interactive = isInteractive({ noPrompt: args.noPrompt });
 
       // Load settings and UI language
       const settings = this.settings || (this.configManager.loadSettings ? this.configManager.loadSettings() : (this.configManager.getConfig ? this.configManager.getConfig() : {}));
       const uiLanguage = args.uiLanguage || settings.uiLanguage || settings.language || this.config.uiLanguage || 'en';
       loadTranslations(uiLanguage);
 
-      if (args.adminPin) {
-        // Handle admin PIN mode
-        this.prompt = async () => '';
-      }
-
-      if (args.help) {
-        this.showHelp();
-        return;
-      }
+      if (args.help) {
+        this.showHelp();
+        return;
+      }
 
       let cfgAfterInitCheck = {};
       if (interactive) {
@@ -155,11 +151,7 @@ module.exports = class ConfigurationService {
    * @returns {Promise<Object>} Configuration object if initialized
    */
   async ensureInitializedOrExit(prompt) {
-    const { checkInitialized } = require('../../../utils/init-helper');
-    const cliHelper = require('../../../utils/cli-helper');
-    const pkg = require('../../../package.json');
-
-    const { initialized, config } = await checkInitialized();
+    const { initialized, config } = await checkInitialized();
 
     if (!initialized) {
       console.log('\nThis project is not yet initialized with i18ntk.');
@@ -224,8 +216,7 @@ module.exports = class ConfigurationService {
         console.log('Framework detection prompt will be suppressed for this version.');
       } else if (action === 'detect') {
         // Run framework detection
-        const FrameworkDetectionService = require('./FrameworkDetectionService');
-        const frameworkService = new FrameworkDetectionService();
+        const frameworkService = new FrameworkDetectionService();
         frameworkService.initialize(this.configManager);
 
         const { detectedLanguage, detectedFramework } = await frameworkService.detectEnvironmentAndFramework();
@@ -260,8 +251,7 @@ module.exports = class ConfigurationService {
    * @returns {Promise<boolean>} True if frameworks detected, false otherwise
    */
   async checkI18nDependencies() {
-    const FrameworkDetectionService = require('./FrameworkDetectionService');
-    const frameworkService = new FrameworkDetectionService();
+    const frameworkService = new FrameworkDetectionService();
     frameworkService.initialize(this.configManager);
     return await frameworkService.checkI18nDependencies(null);
   }
@@ -274,8 +264,7 @@ module.exports = class ConfigurationService {
    * @returns {Promise<Object>} Updated configuration
    */
   async maybePromptFramework(prompt, cfg, currentVersion) {
-    const FrameworkDetectionService = require('./FrameworkDetectionService');
-    const frameworkService = new FrameworkDetectionService();
+    const frameworkService = new FrameworkDetectionService();
     frameworkService.initialize(this.configManager);
     return await frameworkService.maybePromptFramework(prompt, cfg, currentVersion);
   }
@@ -392,8 +381,7 @@ module.exports = class ConfigurationService {
    * @returns {Promise<string>} User input or empty string
    */
   prompt(question) {
-    const cliHelper = require('../../../utils/cli-helper');
-    // If interactive not available, return empty string to avoid hangs
+    // If interactive not available, return empty string to avoid hangs
     if (!process.stdin.isTTY || process.stdin.destroyed) {
       console.log('\n⚠️ Interactive input not available, using default response.');
       return Promise.resolve('');
@@ -446,4 +434,4 @@ module.exports = class ConfigurationService {
   getUI() {
     return this.ui;
   }
-};
+};

package/main/manage/services/FileManagementService.js

@@ -4,9 +4,10 @@
  * @module services/FileManagementService
  */
 
-const path = require('path');
-const fs = require('fs');
-const SecurityUtils = require('../../../utils/security');
+const path = require('path');
+const fs = require('fs');
+const SecurityUtils = require('../../../utils/security');
+const cliHelper = require('../../../utils/cli-helper');
 
 module.exports = class FileManagementService {
   constructor(config = {}) {
@@ -108,8 +109,7 @@ module.exports = class FileManagementService {
     const authRequired = await this.isAuthRequiredForScript('deleteReports');
     if (authRequired) {
       console.log(`\n${ui ? ui.t('adminPin.protectedAccess') : 'Protected Access'}`);
-      const cliHelper = require('../../../utils/cli-helper');
-      const pin = await cliHelper.promptPin((ui ? ui.t('adminPin.enterPin') : 'Enter PIN: ') + ': ');
+      const pin = await cliHelper.promptPin((ui ? ui.t('adminPin.enterPin') : 'Enter PIN: ') + ': ');
       const isValid = await this.verifyPin(pin);
       if (!isValid) {
         console.log(ui ? ui.t('adminPin.invalidPin') : 'Invalid PIN');
@@ -365,4 +365,4 @@ module.exports = class FileManagementService {
     // For now, return true as a placeholder
     return true;
   }
-};
+};

package/main/manage/services/InitService.js

@@ -681,7 +681,7 @@ class InitService {
   }
 
   // Interactive admin PIN setup
-  async promptAdminPinSetup() {
+  async promptAdminPinSetup() {
     const { ask, askHidden, flushStdout } = require('../../../utils/cli');
 
     console.log('\n' + t('init.adminPinSetupOptional'));
@@ -733,8 +733,31 @@ class InitService {
       }
     } else {
       console.log(t('init.skippingAdminPinSetup'));
-    }
-  }
+    }
+  }
+
+  async promptBackupConfiguration(skipPrompt = false) {
+    const defaultBackupConfig = { enabled: false, maxBackups: 1, location: './i18ntk-backups' };
+    if (skipPrompt || !process.stdin.isTTY) {
+      return null;
+    }
+
+    const { ask } = require('../../../utils/cli');
+    console.log('\nBackup Settings');
+    console.log('Backups are disabled by default to avoid backup recursion and repo pollution.');
+    const enableAnswer = await ask('Enable automatic backups? (y/N): ');
+    const enabled = ['y', 'yes'].includes(String(enableAnswer || '').trim().toLowerCase());
+
+    if (!enabled) {
+      return defaultBackupConfig;
+    }
+
+    const keepAnswer = await ask('How many backups should be kept automatically (1-3, default 1): ');
+    const parsedKeep = parseInt(String(keepAnswer || '').trim(), 10);
+    const maxBackups = Number.isInteger(parsedKeep) ? Math.min(Math.max(parsedKeep, 1), 3) : 1;
+
+    return { enabled: true, maxBackups, location: './i18ntk-backups' };
+  }
 
   // Interactive language selection
   async selectLanguages(skipPrompt = false) {
@@ -845,11 +868,24 @@ class InitService {
     // Prompt for admin PIN setup if not already configured
     const securitySettings = configManager.getConfig().security || {};
 
-    if (!securitySettings.adminPinEnabled && securitySettings.adminPinPromptOnInit !== false && !args.noPrompt) {
-      const { flushStdout } = require('../../../utils/cli');
-      await flushStdout();
-      await this.promptAdminPinSetup();
-    }
+    if (!securitySettings.adminPinEnabled && securitySettings.adminPinPromptOnInit !== false && !args.noPrompt) {
+      const { flushStdout } = require('../../../utils/cli');
+      await flushStdout();
+      await this.promptAdminPinSetup();
+    }
+
+    const backupSettings = await this.promptBackupConfiguration(args.noPrompt);
+    if (backupSettings) {
+      await configManager.updateConfig({
+        backup: {
+          ...(this.config.backup || {}),
+          ...backupSettings
+        }
+      });
+      this.config.backup = { ...(this.config.backup || {}), ...backupSettings };
+    } else if (!this.config.backup) {
+      this.config.backup = { enabled: false, maxBackups: 1, location: './i18ntk-backups' };
+    }
 
     // Get target languages - use args.languages if provided
     let targetLanguages = args.languages || await this.selectLanguages(args.noPrompt);

package/main/manage/services/UsageService.js

@@ -130,9 +130,9 @@ class UsageService {
         this.config.includeExtensions = ['.js', '.jsx', '.ts', '.tsx', '.py', '.pyx', '.pyi'];
       }
 
-      await SecurityUtils.logSecurityEvent(t('usage.analyzerInitialized'), { component: 'i18ntk-usage' });
+      await SecurityUtils.logSecurityEvent(t('usage.analyzerInitialized'), 'info', { component: 'i18ntk-usage' });
     } catch (error) {
-      await SecurityUtils.logSecurityEvent(t('usage.analyzerInitFailed'), { component: 'i18ntk-usage', error: error.message });
+      await SecurityUtils.logSecurityEvent(t('usage.analyzerInitFailed'), 'error', { component: 'i18ntk-usage', error: error.message });
       throw error;
     }
   }
@@ -237,7 +237,7 @@ class UsageService {
           }
         }
       } catch (error) {
-        await SecurityUtils.logSecurityEvent(t('usage.translationDiscoveryError'), {
+        await SecurityUtils.logSecurityEvent(t('usage.translationDiscoveryError'), 'error', {
           component: 'i18ntk-usage',
           directory: currentDir,
           error: error.message
@@ -311,7 +311,7 @@ class UsageService {
           }
         }
       } catch (error) {
-        await SecurityUtils.logSecurityEvent(t('usage.fileTraversalError'), {
+        await SecurityUtils.logSecurityEvent(t('usage.fileTraversalError'), 'error', {
           component: 'i18ntk-usage',
           directory: currentDir,
           error: error.message
@@ -466,7 +466,7 @@ class UsageService {
           if (isDebug) {
             console.error(error.stack);
           }
-          await SecurityUtils.logSecurityEvent(t('usage.translationFileParseError'), {
+          await SecurityUtils.logSecurityEvent(t('usage.translationFileParseError'), 'error', {
             component: 'i18ntk-usage',
             file: fileInfo.filePath,
             error: error.message
@@ -474,7 +474,7 @@ class UsageService {
         }
       }
     } catch (error) {
-      await SecurityUtils.logSecurityEvent(t('usage.translationKeysLoadError'), {
+      await SecurityUtils.logSecurityEvent(t('usage.translationKeysLoadError'), 'error', {
         component: 'i18ntk-usage',
         error: error.message
       });
@@ -512,10 +512,22 @@ class UsageService {
     return keys;
   }
 
-  collectPlaceholderKeys(obj, prefix = '', language) {
-    const patterns = this.placeholderStyles[language] || [];
-    const regexes = patterns.map(p => new RegExp(p));
-    if (typeof obj !== 'object' || obj === null) return;
+  collectPlaceholderKeys(obj, prefix = '', language) {
+    const patterns = this.placeholderStyles[language] || [];
+    const regexes = patterns.reduce((compiled, pattern) => {
+      try {
+        compiled.push(new RegExp(pattern));
+      } catch (error) {
+        SecurityUtils.logSecurityEvent('Invalid placeholder regex pattern skipped', 'warn', {
+          component: 'i18ntk-usage',
+          language,
+          pattern,
+          error: error.message
+        });
+      }
+      return compiled;
+    }, []);
+    if (typeof obj !== 'object' || obj === null) return;
 
     for (const [key, value] of Object.entries(obj)) {
       const fullKey = prefix ? `${prefix}.${key}` : key;
@@ -1447,7 +1459,7 @@ class UsageService {
     } catch (error) {
       console.error(t('usage.analysisFailedError'), error.message);
       this.closeReadline();
-      SecurityUtils.logSecurityEvent(t('usage.usageAnalysisFailed'), {
+      SecurityUtils.logSecurityEvent(t('usage.usageAnalysisFailed'), 'error', {
         component: 'i18ntk-usage',
         error: error.message
       });
@@ -1499,4 +1511,4 @@ Analysis Features (v1.8.3):
   }
 }
 
-module.exports = UsageService;
+module.exports = UsageService;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "i18ntk",
-  "version": "2.1.0",
-  "description": "🚀 The fastest i18n toolkit with 97% performance boost! Zero-dependency, enterprise-grade internationalization for React, Vue, Angular, Python, Java, PHP & more. Features PIN protection, auto framework detection, 7+ UI languages, and comprehensive translation management. Perfect for startups to enterprises.",
+  "version": "2.3.0",
+  "description": "🚀 The fastest internationalization toolkit with 97% performance boost! Zero-dependency, enterprise-grade internationalization for React, Vue, Angular, Python, Java, PHP & more. Features PIN protection, auto framework detection, 7+ UI languages, and comprehensive translation management. Perfect for startups to enterprises.",
   "keywords": [
     "i18n",
     "internationalization",
@@ -134,7 +134,6 @@
     "./main/*": "./main/*",
     "./utils/*": "./utils/*",
     "./settings/*": "./settings/*",
-    "./scripts/*": "./scripts/*",
     "./ui-locales/*": "./ui-locales/*",
     "./package.json": "./package.json"
   },
@@ -162,9 +161,17 @@
     "main/",
     "runtime/",
     "utils/",
-    "scripts/",
     "settings/",
     "ui-locales/",
+    "!main/manage/index-fixed.js",
+    "!main/i18ntk-manage.js",
+    "!main/i18ntk-py.js",
+    "!main/i18ntk-js.js",
+    "!main/i18ntk-java.js",
+    "!main/i18ntk-php.js",
+    "!main/i18ntk-go.js",
+    "!main/i18ntk-settings.js",
+    "!utils/security-fixed.js",
     "LICENSE",
     "package.json",
     "README.md"
@@ -220,50 +227,21 @@
   },
   "preferGlobal": true,
   "versionInfo": {
-    "version": "2.1.0",
-    "releaseDate": "11/04/2026",
-    "lastUpdated": "11/04/2026",
+    "version": "2.3.0",
+    "releaseDate": "12/04/2026",
+    "lastUpdated": "12/04/2026",
     "maintainer": "Vladimir Noskov",
     "changelog": "./CHANGELOG.md",
     "documentation": "./README.md",
     "apiReference": "./docs/api/API_REFERENCE.md",
     "majorChanges": [
-      "UX: Interactive menu command flow now returns reliably to Main Menu after command completion",
-      "I18N: UI locale keysets synchronized and normalized across resources/ui-locales and ui-locales",
-      "ANALYZE: Fixed progress counter and removed duplicate report-save output lines",
-      "RELIABILITY: Backup/report directories are excluded from language discovery in analyze/complete flows",
-      "FRAMEWORK: Setup-complete projects are recognized as internal i18ntk framework to avoid repeated detection prompts",
-      "SECURITY: Reduced false-positive config sanitization warnings for valid date/time report settings"
+      "CRITICAL FIX: Resolved sizing and usage-analysis regressions in v2 command flow.",
+      "PACKAGING: Reduced publish footprint by removing internal development scripts and legacy fixed-file artifacts.",
+      "SECURITY: Hardened release checks and added explicit support guidance to update from pre-2.3.0 versions.",
+      "I18N: Completed internal UI locale parity and actionable untranslated-key cleanup across supported languages."
     ],
     "breakingChanges": [],
-    "deprecations": [
-      "1.0.x",
-      "1.1.x",
-      "1.2.x",
-      "1.3.x",
-      "1.4.x",
-      "1.5.x",
-      "1.6.0",
-      "1.6.1",
-      "1.6.2",
-      "1.6.3",
-      "1.7.0",
-      "1.7.1",
-      "1.7.2",
-      "1.7.3",
-      "1.7.4",
-      "1.7.5",
-      "1.7.6",
-      "1.8.0",
-      "1.8.1",
-      "1.8.2",
-      "1.8.3",
-      "1.9.0",
-      "1.10.1",
-      "1.10.2",
-      "1.10.3"
-    ],
-    "nextVersion": "2.2.0",
+    "nextVersion": "2.4.0",
     "supportedNodeVersions": ">=16.0.0",
     "supportedFrameworks": {
       "react-i18next": ">=11.0.0",
@@ -284,7 +262,8 @@
       "fastapi": ">=0.70.0",
       "spring-boot": ">=2.5.0",
       "laravel": ">=8.0.0"
-    }
+    },
+    "supportPolicy": "Versions earlier than 2.3.0 may be unstable or insecure. Upgrade to 2.3.0 or newer."
   },
   "_comment": "This package is zero-dependency and uses only native Node.js modules"
 }

package/settings/settings-cli.js

@@ -12,7 +12,7 @@ const settingsManager = new SettingsManager();
 const UIi18n = require('../main/i18ntk-ui');
 const configManager = require('../utils/config-manager');
 const { loadTranslations, t } = require('../utils/i18n-helper');
-loadTranslations(null, path.resolve(__dirname, '..', 'resources', 'i18n', 'ui-locales'));
+loadTranslations(null, path.resolve(__dirname, '..', 'ui-locales'));
 
 const AdminAuth = require('../utils/admin-auth');
 const uiI18n = new UIi18n();
@@ -567,8 +567,8 @@ class SettingsCLI {
             'backupRetention': { min: 1, max: 30, type: 'int', unit: 'days' },
             'logRetention': { min: 1, max: 90, type: 'int', unit: 'days' },
             'retentionDays': { min: 1, max: 365, type: 'int', unit: 'days' },
-            'maxBackups': { min: 1, max: 1000, type: 'int' }
-        };
+            'maxBackups': { min: 1, max: 3, type: 'int' }
+        };
         
         for (const [field, rules] of Object.entries(validations)) {
             if (key.includes(field)) {
@@ -610,7 +610,7 @@ class SettingsCLI {
         }
                if (key === 'removeUiLanguages') {
             if (this.rl && this.rl.pause) this.rl.pause();
-            const LocaleOptimizer = require('../scripts/locale-optimizer.js');
+            const LocaleOptimizer = require('../utils/locale-optimizer.js');
             const optimizer = new LocaleOptimizer();
             await optimizer.interactiveSelect();
             // Re-initialize readline if it was closed by locale optimizer
@@ -2135,4 +2135,4 @@ Note: Use arrow keys and Enter to navigate the interactive menu.
         console.error('Stack trace:', error.stack);
         process.exit(1);
     });
-}
+}