i18ntk 2.0.4 → 2.2.0

package/README.md

@@ -1,74 +1,64 @@
-# 🚀 i18ntk - The Ultra-Fast, Zero-Dependency i18n Translation Toolkit
+# i18ntk v2.2.0
 
-<div align="center">
+Zero-dependency i18n toolkit for initialization, scanning, analysis, validation, usage tracking, and translation completion.
 
 ![i18ntk Logo](docs/screenshots/i18ntk-logo-public.PNG)
 
-**The fastest and most comprehensive i18n toolkit ever built.**
-
 [![npm version](https://img.shields.io/npm/v/i18ntk.svg?color=brightgreen)](https://www.npmjs.com/package/i18ntk)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Performance](https://img.shields.io/badge/Performance-97%25%20Faster-blue.svg)](https://github.com/vladnoskv/i18ntk#performance)
-[![Zero Dependencies](https://img.shields.io/badge/Dependencies-ZERO-red.svg)](https://github.com/vladnoskv/i18ntk#features)
 [![npm downloads](https://img.shields.io/npm/dt/i18ntk.svg)](https://www.npmjs.com/package/i18ntk)
-[![GitHub stars](https://img.shields.io/github/stars/vladnoskv/i18ntk?style=social)](https://github.com/vladnoskv/i18ntk)
-[![Socket Badge](https://socket.dev/api/badge/npm/package/i18ntk/2.0.4)](https://socket.dev/npm/package/i18ntk/overview/2.0.4)
-
-[📦 Install Now](#-installation) • [⚡ Quick Start](#-quick-start) • [📚 Documentation](#-documentation) • [🎯 Features](#-why-choose-i18ntk)
-
----
+[![node](https://img.shields.io/badge/node-%3E%3D16-339933)](https://nodejs.org)
+[![dependencies](https://img.shields.io/badge/dependencies-0-success)](https://www.npmjs.com/package/i18ntk)
+[![license](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)
+[![socket](https://socket.dev/api/badge/npm/package/i18ntk/2.2.0)](https://socket.dev/npm/package/i18ntk/overview/2.2.0)
 
-## ⚡ Lightning Fast Performance
+## Upgrade Notice
 
-**15.38ms** for 200k translation keys • **<2MB** memory usage • **97% faster** than traditional tools
+Versions earlier than `2.2.0` may contain known stability and security issues.
+They are considered unsupported for production use. Upgrade to `2.2.0` or newer.
 
-**v2.0.4**
+## Why i18ntk
 
-</div>
+- Zero runtime dependencies
+- Works across JS/TS, React, Vue, Angular, and generic projects
+- Supports non-interactive CI runs (`--no-prompt`)
+- Includes usage/coverage validation and missing-key completion
+- Ships with runtime translation helpers via `i18ntk/runtime`
 
-## 📦 Installation
+## Install
 
 ```bash
-# Install globally (recommended)
+# global (recommended for CLI use)
 npm install -g i18ntk
 
-# Or use with npx (no installation required)
-npx i18ntk
+# local
+npm install --save-dev i18ntk
 
-# Or install locally in your project
-npm install i18ntk --save-dev
+# one-off
+npx i18ntk --help
 ```
 
-## ⚡ Quick Start
-
-Get your i18n project up and running in **60 seconds**:
+## Quick Start
 
 ```bash
-# 1. Install i18ntk
-npm install -g i18ntk
-
-# 2. Initialize your project
-i18ntk init
-
-# 3. Analyze your translations
-i18ntk analyze
+# initialize locales/project settings
+i18ntk --command=init
 
-# 4. Fix any issues
-i18ntk fixer --interactive
+# analyze translation completeness
+i18ntk --command=analyze
 
-# 5. Validate everything
-i18ntk validate
+# validate translation structure/content
+i18ntk --command=validate
 
-# 6. Mangage Mre
+# complete missing keys
+i18ntk --command=complete
 ```
 
-That's it! Your i18n infrastructure is ready. 🎉
+## Command Model (v2)
 
-## v2 Command Model
-
-Primary CLI commands:
+Primary CLI:
 
 ```bash
+i18ntk
 i18ntk --command=init
 i18ntk --command=analyze
 i18ntk --command=validate
@@ -80,7 +70,7 @@ i18ntk --command=summary
 i18ntk --command=debug
 ```
 
-Standalone binaries:
+Standalone executables:
 
 ```bash
 i18ntk-init
@@ -96,19 +86,8 @@ i18ntk-fixer
 i18ntk-backup
 ```
 
-Backup helper:
-
-```bash
-i18ntk-backup --help
-i18ntk-backup create ./locales
-i18ntk-backup list
-i18ntk-backup restore <backup-file>
-```
-
 ## Common Flags
 
-Most commands support:
-
 - `--source-dir <path>`
 - `--i18n-dir <path>`
 - `--output-dir <path>`
@@ -120,13 +99,13 @@ Most commands support:
 
 ## Configuration
 
-i18ntk reads project settings from `.i18ntk-config` in the project root.
+i18ntk reads project settings from `.i18ntk-config` in your project root.
 
 Example:
 
 ```json
 {
-  "version": "2.0.0",
+  "version": "2.2.0",
   "sourceDir": "./locales",
   "i18nDir": "./locales",
   "outputDir": "./i18ntk-reports",
@@ -155,7 +134,7 @@ setLanguage('fr');
 console.log(getLanguage());
 ```
 
-## Docs
+## Documentation
 
 - [Documentation Index](docs/README.md)
 - [API Reference](docs/api/API_REFERENCE.md)
@@ -163,8 +142,7 @@ console.log(getLanguage());
 - [Runtime API Guide](docs/runtime.md)
 - [Scanner Guide](docs/scanner-guide.md)
 - [Environment Variables](docs/environment-variables.md)
-- [Migration Guide v2.0.0](docs/migration-guide-v2.0.0.md)
-- [Release Runbook](DEVUPDATE.md)
+- [Migration Guide v2.2.0](docs/migration-guide-v2.2.0.md)
 
 ## License
 

package/main/i18ntk-analyze.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 /**
  * I18NTK TRANSLATION ANALYSIS SCRIPT
  * 
@@ -27,7 +27,7 @@ const SetupEnforcer = require('../utils/setup-enforcer');
   }
 })();
 
-loadTranslations( 'en', path.resolve(__dirname, '..', 'resources', 'i18n', 'ui-locales'));
+loadTranslations('en', path.resolve(__dirname, '..', 'ui-locales'));
 
 const PROJECT_ROOT = process.cwd();
 
@@ -67,7 +67,7 @@ class I18nAnalyzer {
       this.config = { ...baseConfig, ...(this.config || {}) };
       
       const uiLanguage = (this.config && this.config.uiLanguage) || 'en';
-      loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'resources', 'i18n', 'ui-locales'));
+      loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'ui-locales'));
       
       this.sourceDir = this.config.sourceDir;
       this.sourceLanguageDir = path.join(this.sourceDir, this.config.sourceLanguage);
@@ -143,6 +143,17 @@ class I18nAnalyzer {
   }
 
   // Get all available languages
+  isValidLanguageCode(code) {
+    if (!code || typeof code !== 'string') return false;
+    return /^[a-z]{2}(?:-[A-Za-z0-9]{2,8})*$/i.test(code.trim());
+  }
+
+  isExcludedLanguageDirectory(name) {
+    if (!name || typeof name !== 'string') return true;
+    const lowered = name.toLowerCase();
+    return lowered.startsWith('backup-') || lowered === 'backup' || lowered === 'reports' || lowered === 'i18ntk-reports';
+  }
+
   getAvailableLanguages() {
     try {
       const items = SecurityUtils.safeReaddirSync(this.sourceDir, process.cwd(), { withFileTypes: true });
@@ -157,7 +168,18 @@ class I18nAnalyzer {
       const directories = items
         .filter(item => item.isDirectory())
         .map(item => item.name)
-        .filter(name => name !== 'node_modules' && !name.startsWith('.') && name !== this.config.sourceLanguage);
+        .filter(name =>
+          name !== 'node_modules' &&
+          !name.startsWith('.') &&
+          name !== this.config.sourceLanguage &&
+          !this.isExcludedLanguageDirectory(name) &&
+          this.isValidLanguageCode(name)
+        )
+        .filter(name => {
+          const dirPath = path.join(this.sourceDir, name);
+          const dirItems = SecurityUtils.safeReaddirSync(dirPath, process.cwd(), { withFileTypes: true }) || [];
+          return dirItems.some(item => item.isFile() && item.name.endsWith('.json'));
+        });
       
       // Check for monolith files (language.json files)
       const files = items
@@ -170,31 +192,14 @@ class I18nAnalyzer {
       // Add monolith files as languages (without .json extension)
       const monolithLanguages = files
         .map(file => file.replace('.json', ''))
-        .filter(lang => !languages.includes(lang) && lang !== this.config.sourceLanguage);
+        .filter(lang =>
+          !languages.includes(lang) &&
+          lang !== this.config.sourceLanguage &&
+          !this.isExcludedLanguageDirectory(lang) &&
+          this.isValidLanguageCode(lang)
+        );
       languages.push(...monolithLanguages);
-      
-      // Check for nested structures
-      for (const dir of directories) {
-        const dirPath = path.join(this.sourceDir, dir);
-        try {
-          const dirItems = SecurityUtils.safeReaddirSync(dirPath, process.cwd(), { withFileTypes: true });
-          if (dirItems) {
-            const jsonFiles = dirItems
-              .filter(item => item.isFile() && item.name.endsWith('.json'))
-              .map(item => item.name.replace('.json', ''));
-            
-            // If directory contains JSON files, it's likely a language directory
-            if (jsonFiles.length > 0) {
-              if (!languages.includes(dir)) {
-                languages.push(dir);
-              }
-            }
-          }
-        } catch (error) {
-          // Skip directories we can't read
-        }
-      }
-      
+
       return [...new Set(languages)].sort();
     } catch (error) {
       console.error('Error reading source directory:', error.message);
@@ -707,7 +712,6 @@ try {
         throw new Error(t('analyze.failedToWriteReportFile') || 'Failed to write report file securely');
       }
       
-      console.log(`Report saved to: ${reportPath}`);
       return reportPath;
       
     } catch (error) {
@@ -775,20 +779,21 @@ try {
           console.log(t('analyze.analyzing', { language }) || `\n🔄 Analyzing ${language}...`);
         }
         
-        const analysis = this.analyzeLanguage(language);
-        const report = this.generateLanguageReport(analysis);
-        
-        // Save report
-        const reportPath = await this.saveReport(language, report);
-        
-        if (!args.json) {
-          console.log(t('analyze.completed', { language }) || `✅ Analysis completed for ${language}`);
-          console.log(t('analyze.progress', { 
-            translated: results.length, 
-            total: languages.length 
-          }) || `   Progress: ${results.length}/${languages.length} languages processed`);
-          console.log(t('analyze.reportSaved', { reportPath }) || `   Report saved: ${reportPath}`);
-        }
+          const analysis = this.analyzeLanguage(language);
+          const report = this.generateLanguageReport(analysis);
+
+          // Save report
+          const reportPath = await this.saveReport(language, report);
+          const processedCount = results.length + 1;
+
+          if (!args.json) {
+            console.log(t('analyze.completed', { language }) || `✅ Analysis completed for ${language}`);
+            console.log(t('analyze.progress', {
+              translated: processedCount,
+              total: languages.length
+            }) || `   Progress: ${processedCount}/${languages.length} languages processed`);
+            console.log(t('analyze.reportSaved', { reportPath }) || `   Report saved: ${reportPath}`);
+          }
         
         results.push({
           language,
@@ -884,7 +889,7 @@ try {
         this.config = { ...baseConfig, ...this.config };
         
         const uiLanguage = this.config.uiLanguage || 'en';
-        loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'resources', 'i18n', 'ui-locales'));
+        loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'ui-locales'));
         
         this.sourceDir = this.config.sourceDir;
         this.sourceLanguageDir = path.join(this.sourceDir, this.config.sourceLanguage);

package/main/i18ntk-complete.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 /**
  * I18NTK TRANSLATION COMPLETION SCRIPT
  * 
@@ -19,15 +19,15 @@ const { loadTranslations, t } = require('../utils/i18n-helper');
 const { getGlobalReadline, closeGlobalReadline } = require('../utils/cli');
 const SetupEnforcer = require('../utils/setup-enforcer');
 
-// Ensure setup is complete before running, except for help output.
-(async () => {
-  const isHelpRequest = process.argv.slice(2).some(arg => arg === '--help' || arg === '-h');
-  if (isHelpRequest) {
-    return;
-  }
-  try {
-    await SetupEnforcer.checkSetupCompleteAsync();
-  } catch (error) {
+// Ensure setup is complete before running, except for help output.
+(async () => {
+  const isHelpRequest = process.argv.slice(2).some(arg => arg === '--help' || arg === '-h');
+  if (isHelpRequest) {
+    return;
+  }
+  try {
+    await SetupEnforcer.checkSetupCompleteAsync();
+  } catch (error) {
     console.error('Setup check failed:', error.message);
     process.exit(1);
   }
@@ -37,7 +37,7 @@ loadTranslations();
 
 
 
-class I18nCompletionTool {
+class I18nCompletionTool {
   constructor(config = {}) {
     this.config = config;
     this.sourceDir = null;
@@ -109,57 +109,57 @@ class I18nCompletionTool {
           parsed.autoTranslate = true;
         } else if (key === 'dry-run') {
           parsed.dryRun = true;
-        } else if (key === 'no-prompt') {
-          parsed.noPrompt = true;
-        } else if (key === 'help' || key === 'h') {
-          parsed.help = true;
-        }
-      }
-    });
+        } else if (key === 'no-prompt') {
+          parsed.noPrompt = true;
+        } else if (key === 'help' || key === 'h') {
+          parsed.help = true;
+        }
+      }
+    });
     
     return parsed;
   }
 
-  // Get all available languages
-  getAvailableLanguages() {
+  // Get all available languages
+  getAvailableLanguages() {
     if (!SecurityUtils.safeExistsSync(this.sourceDir, this.config.projectRoot)) {
       throw new Error(`Source directory not found: ${this.sourceDir}`);
     }
     
     // Check for monolith JSON files (en.json, es.json, etc.)
-    const files = SecurityUtils.safeReaddirSync(this.sourceDir, this.config.projectRoot);
-    const languagesFromFiles = files
-      .filter(file => file.endsWith('.json'))
-      .map(file => path.basename(file, '.json'))
-      .filter(code => this.isValidLanguageCode(code));
-    
-    // Also check for directory-based structure for backward compatibility
-    const directories = SecurityUtils.safeReaddirSync(this.sourceDir, this.config.projectRoot)
-      .filter(item => {
-        if (this.isExcludedLanguageDirectory(item)) return false;
-        if (!this.isValidLanguageCode(item)) return false;
-        const itemPath = path.join(this.sourceDir, item);
-        const stat = SecurityUtils.safeStatSync(itemPath, this.config.projectRoot);
-        if (!stat || !stat.isDirectory()) return false;
-
-        const localeFiles = SecurityUtils.safeReaddirSync(itemPath, this.config.projectRoot)
-          .filter(name => name.endsWith('.json'));
-        return localeFiles.length > 0;
-      });
-    
-    return [...new Set([...languagesFromFiles, ...directories])];
-  }
-
-  isValidLanguageCode(code) {
-    if (!code || typeof code !== 'string') return false;
-    return /^[a-z]{2}(?:-[A-Za-z0-9]{2,8})*$/i.test(code.trim());
-  }
-
-  isExcludedLanguageDirectory(name) {
-    if (!name || typeof name !== 'string') return true;
-    const lowered = name.toLowerCase();
-    return lowered.startsWith('backup-') || lowered === 'backup' || lowered === 'reports' || lowered === 'i18ntk-reports';
-  }
+    const files = SecurityUtils.safeReaddirSync(this.sourceDir, this.config.projectRoot);
+    const languagesFromFiles = files
+      .filter(file => file.endsWith('.json'))
+      .map(file => path.basename(file, '.json'))
+      .filter(code => this.isValidLanguageCode(code));
+    
+    // Also check for directory-based structure for backward compatibility
+    const directories = SecurityUtils.safeReaddirSync(this.sourceDir, this.config.projectRoot)
+      .filter(item => {
+        if (this.isExcludedLanguageDirectory(item)) return false;
+        if (!this.isValidLanguageCode(item)) return false;
+        const itemPath = path.join(this.sourceDir, item);
+        const stat = SecurityUtils.safeStatSync(itemPath, this.config.projectRoot);
+        if (!stat || !stat.isDirectory()) return false;
+
+        const localeFiles = SecurityUtils.safeReaddirSync(itemPath, this.config.projectRoot)
+          .filter(name => name.endsWith('.json'));
+        return localeFiles.length > 0;
+      });
+    
+    return [...new Set([...languagesFromFiles, ...directories])];
+  }
+
+  isValidLanguageCode(code) {
+    if (!code || typeof code !== 'string') return false;
+    return /^[a-z]{2}(?:-[A-Za-z0-9]{2,8})*$/i.test(code.trim());
+  }
+
+  isExcludedLanguageDirectory(name) {
+    if (!name || typeof name !== 'string') return true;
+    const lowered = name.toLowerCase();
+    return lowered.startsWith('backup-') || lowered === 'backup' || lowered === 'reports' || lowered === 'i18ntk-reports';
+  }
 
   // Get all JSON files from a language directory
   getLanguageFiles(language) {
@@ -481,7 +481,8 @@ class I18nCompletionTool {
       this.config = { ...baseConfig, ...(this.config || {}) };
       
       const uiLanguage = (this.config && this.config.uiLanguage) || 'en';
-      loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'resources', 'i18n', 'ui-locales'));this.sourceDir = this.config.sourceDir;
+      loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'ui-locales'));
+      this.sourceDir = this.config.sourceDir;
       this.sourceLanguageDir = path.join(this.sourceDir, this.config.sourceLanguage);
     } else {
       await this.initialize();
@@ -552,28 +553,28 @@ class I18nCompletionTool {
       console.log(t("complete.languagesProcessed", { languagesProcessed: languages.length }));
       console.log(t("complete.missingKeysAdded", { missingKeysAdded: missingKeys.length }));
       
-      if (!args.dryRun && allChanges.length > 0 && !args.noPrompt) {
-        const rl = this.rl || this.initReadline();
-        const answer = await this.prompt('\n' + t('complete.generateReportPrompt') + ' (Y/N): ');
-        
-        if (answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes') {
-          await this.generateReport(allChanges, languages);
+      if (!args.dryRun && allChanges.length > 0 && !args.noPrompt) {
+        const rl = this.rl || this.initReadline();
+        const answer = await this.prompt('\n' + t('complete.generateReportPrompt') + ' (Y/N): ');
+        
+        if (answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes') {
+          await this.generateReport(allChanges, languages);
         }
       }
       
-      if (!args.dryRun) {
-        console.log('\n' + t("complete.nextStepsTitle"));
-        console.log(t("complete.separator"));
-        console.log('1. Run usage analysis:');
-        console.log('   i18ntk --command=usage');
-        console.log('2. Validate translations:');
-        console.log('   i18ntk --command=validate');
-        console.log('3. Analyze translation status:');
-        console.log('   i18ntk --command=analyze');
-        console.log('\n' + t("complete.allKeysAvailable"));
-      } else {
-        console.log('\n' + t("complete.runWithoutDryRun"));
-      }
+      if (!args.dryRun) {
+        console.log('\n' + t("complete.nextStepsTitle"));
+        console.log(t("complete.separator"));
+        console.log('1. Run usage analysis:');
+        console.log('   i18ntk --command=usage');
+        console.log('2. Validate translations:');
+        console.log('   i18ntk --command=validate');
+        console.log('3. Analyze translation status:');
+        console.log('   i18ntk --command=analyze');
+        console.log('\n' + t("complete.allKeysAvailable"));
+      } else {
+        console.log('\n' + t("complete.runWithoutDryRun"));
+      }
       
       // Only prompt when run from the menu (i.e., when a callback or menu context is present)
       if (typeof this.prompt === "function" && args.fromMenu) {
@@ -605,4 +606,4 @@ if (require.main === module) {
   });
 }
 
-module.exports = I18nCompletionTool;
+module.exports = I18nCompletionTool;

package/main/i18ntk-fixer.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * I18NTK TRANSLATION FIXER SCRIPT
@@ -27,7 +27,7 @@ const SetupEnforcer = require('../utils/setup-enforcer');
   }
 })();
 
-loadTranslations('en', path.resolve(__dirname, '..', 'resources', 'i18n', 'ui-locales'));
+loadTranslations('en', path.resolve(__dirname, '..', 'ui-locales'));
 
 class I18nFixer {
   constructor(config = {}) {
@@ -51,7 +51,7 @@ class I18nFixer {
       this.config = { ...baseConfig, ...(this.config || {}) };
 
       const uiLanguage = (this.config && this.config.uiLanguage) || 'en';
-      loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'resources', 'i18n', 'ui-locales'));
+      loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'ui-locales'));
 
       this.sourceDir = this.config.sourceDir;
       this.outputDir = this.config.outputDir;

package/main/i18ntk-init.js

@@ -1122,7 +1122,7 @@ class I18nInitializer {
       
       try {
         // Import locale optimizer directly
-        const LocaleOptimizer = require('../scripts/locale-optimizer');
+        const LocaleOptimizer = require('../utils/locale-optimizer');
         
         // First run dry run to show current state
         console.log('\n🔍 Running locale optimization preview...');
@@ -1139,12 +1139,12 @@ class I18nInitializer {
           console.log('\n✅ Package optimization completed!');
         } else {
           console.log('\n💡 You can run locale optimization later with:');
-          console.log('   node scripts/locale-optimizer.js --interactive');
+          console.log('   node utils/locale-optimizer.js --interactive');
         }
       } catch (error) {
         console.log('\n⚠️ Could not offer locale optimization:', error.message);
         console.log('\n💡 You can run locale optimization later with:');
-        console.log('   node scripts/locale-optimizer.js --interactive');
+        console.log('   node utils/locale-optimizer.js --interactive');
       }
     } catch (error) {
       console.log('\n⚠️ Could not offer locale optimization:', error.message);
@@ -1178,7 +1178,7 @@ class I18nInitializer {
         // Load translations for UI messages
       const uiLanguage = this.config.uiLanguage || 'en';
       const { loadTranslations } = require('../utils/i18n-helper');
-      loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'resources', 'i18n', 'ui-locales'));
+      loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'ui-locales'));
       }
       
       // Setup is now handled centrally by config manager
@@ -1261,7 +1261,7 @@ class I18nInitializer {
       // Load translations for UI messages
       const uiLanguage = this.config.uiLanguage || 'en';
       const { loadTranslations } = require('../utils/i18n-helper');
-      loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'resources', 'i18n', 'ui-locales'));
+      loadTranslations(uiLanguage, path.resolve(__dirname, '..', 'ui-locales'));
       
       // Skip i18n framework check in non-interactive mode
       console.log('Running initialization in non-interactive mode...');

package/main/i18ntk-scanner.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * I18NTK TEXT SCANNER
@@ -47,7 +47,7 @@ class I18nTextScanner {
   }
 
   loadLocale() {
-    const uiLocalesDir = path.join(__dirname, '..', 'resources', 'i18n', 'ui-locales');
+    const uiLocalesDir = path.join(__dirname, '..', 'ui-locales');
     const localeFile = path.join(uiLocalesDir, 'en.json');
 
     try {