locai 2.5.1 → 2.6.0

package/README.md

@@ -59,6 +59,7 @@ Contributing to Locai? Learn how to build, test, and run the project locally.
 - **Framework Agnostic**: Works with Next.js, Flutter, Django, and more.
 - **Context Aware**: Knows the difference between "Home" (House) and "Home" (Page).
 - **Cost Efficient**: Smart caching and incremental updates save ~90% of AI costs.
+- **Flexible Structure**: Supports both flat (`en.json`) and nested (`en/translation.json`) directory structures automatically.
 - **Developer Friendly**: TypeScript config, type safety, and great error messages.
 
 ## 🤝 Community & Contributing

package/dist/providers/anthropic.js

@@ -20,7 +20,7 @@ class AnthropicProvider extends BaseProvider {
                 "x-api-key": this.getApiKey(),
                 "anthropic-version": "2023-06-01",
             },
-            timeout: 30000,
+            timeout: config.timeoutMs || 60000,
             maxRedirects: 0,
             validateStatus: (status) => status < 500,
         });

package/dist/providers/dashscope.js

@@ -20,7 +20,7 @@ class DashScopeProvider extends BaseProvider {
                 ...this.commonHeaders,
                 Authorization: `Bearer ${this.getApiKey()}`,
             },
-            timeout: 30000,
+            timeout: config.timeoutMs || 60000,
             maxRedirects: 0,
             validateStatus: (status) => status < 500,
         });
@@ -31,7 +31,7 @@ class DashScopeProvider extends BaseProvider {
                 ...this.commonHeaders,
                 Authorization: `Bearer ${this.getApiKey()}`,
             },
-            timeout: 30000,
+            timeout: config.timeoutMs || 60000,
             maxRedirects: 0,
             validateStatus: (status) => status < 500,
         });

package/dist/providers/deepseek.js

@@ -19,7 +19,7 @@ class DeepSeekProvider extends BaseProvider {
                 ...this.commonHeaders,
                 Authorization: `Bearer ${this.getApiKey()}`,
             },
-            timeout: 45000,
+            timeout: config.timeoutMs || 60000,
             maxRedirects: 0,
             validateStatus: (status) => status < 500,
         });

package/dist/providers/gemini.js

@@ -18,7 +18,7 @@ class GeminiProvider extends BaseProvider {
             headers: {
                 ...this.commonHeaders,
             },
-            timeout: 30000,
+            timeout: config.timeoutMs || 60000,
             maxRedirects: 0,
             validateStatus: (status) => status < 500,
         });

package/dist/providers/openai.js

@@ -19,7 +19,7 @@ class OpenAIProvider extends BaseProvider {
                 ...this.commonHeaders,
                 Authorization: `Bearer ${this.getApiKey()}`,
             },
-            timeout: 30000,
+            timeout: config.timeoutMs || 60000,
             maxRedirects: 0,
             validateStatus: (status) => status < 500,
         });

package/dist/providers/xai.js

@@ -19,7 +19,7 @@ class XAIProvider extends BaseProvider {
                 ...this.commonHeaders,
                 Authorization: `Bearer ${this.getApiKey()}`,
             },
-            timeout: 30000,
+            timeout: config.timeoutMs || 60000,
             maxRedirects: 0,
             validateStatus: (status) => status < 500,
         });

package/dist/services/language-processor.js

@@ -43,8 +43,24 @@ export class LanguageProcessor {
             let savedMessage = undefined;
             statisticsManager.initLanguageStats(safeTargetLang);
             const sourceDir = path.dirname(sourceFile);
-            const safeTargetFilename = `${safeTargetLang}.json`;
-            const targetPath = InputValidator.createSafeFilePath(sourceDir, safeTargetFilename);
+            // Detect structure based on source file name
+            const isNestedStructure = path.basename(sourceFile) === "translation.json";
+            let targetPath;
+            if (isNestedStructure) {
+                // Nested: locales/tr/translation.json
+                // We assume sourceDir ends with the language code (e.g. .../en)
+                // So we need to go up one level and then into target lang
+                const localesRoot = path.dirname(sourceDir);
+                const targetDir = path.join(localesRoot, safeTargetLang);
+                // Ensure target directory exists for nested structure
+                await FileManager.ensureDir(targetDir);
+                targetPath = path.join(targetDir, "translation.json");
+            }
+            else {
+                // Flat: locales/tr.json
+                const safeTargetFilename = `${safeTargetLang}.json`;
+                targetPath = InputValidator.createSafeFilePath(sourceDir, safeTargetFilename);
+            }
             let targetContent = {};
             try {
                 targetContent = await FileManager.readJSON(targetPath);

package/dist/services/translation-service.js

@@ -248,16 +248,28 @@ class TranslationService {
      */
     async removeDeletedKeysFromTargets(sourceFile, deletedKeys, options) {
         const sourceDir = path.dirname(sourceFile);
+        // Detect structure based on source file name
+        const isNestedStructure = path.basename(sourceFile) === "translation.json";
         let totalRemoved = 0;
         let filesProcessed = 0;
         for (const targetLang of options.targets || []) {
             try {
-                const safeTargetFilename = `${targetLang}.json`;
-                const targetPath = InputValidator.createSafeFilePath(sourceDir, safeTargetFilename);
+                let targetPath;
+                if (isNestedStructure) {
+                    // Nested: locales/tr/translation.json
+                    const localesRoot = path.dirname(sourceDir);
+                    const targetDir = path.join(localesRoot, targetLang);
+                    targetPath = path.join(targetDir, "translation.json");
+                }
+                else {
+                    // Flat: locales/tr.json
+                    const safeTargetFilename = `${targetLang}.json`;
+                    targetPath = InputValidator.createSafeFilePath(sourceDir, safeTargetFilename);
+                }
                 // Check if target file exists
                 const fileExists = await FileManager.exists(targetPath);
                 if (!fileExists) {
-                    await uiManager.log(`   Skipping ${targetLang}.json (file doesn't exist)`);
+                    await uiManager.log(`   Skipping ${targetLang} (file doesn't exist)`);
                     continue;
                 }
                 // Read target file
@@ -279,12 +291,12 @@ class TranslationService {
                     await uiManager.log(`   ${targetLang}.json: Removed ${removedFromThisFile} keys`);
                 }
                 else {
-                    await uiManager.log(`   No keys to remove from ${targetLang}.json`);
+                    await uiManager.log(`   No keys to remove from ${targetLang}`);
                 }
                 filesProcessed++;
             }
             catch (error) {
-                await uiManager.log(`   \u274c Error processing ${targetLang}.json: ${error.message}`);
+                await uiManager.log(`   \u274c Error processing ${targetLang}: ${error.message}`);
             }
         }
         await uiManager.log(`Cleanup Summary: Removed ${totalRemoved} keys from ${filesProcessed} files\n`);
@@ -300,14 +312,23 @@ class TranslationService {
         const sourceContent = await FileManager.readJSON(file);
         const flattenedSource = ObjectTransformer.flatten(sourceContent);
         const orchestrator = new Orchestrator(options);
+        const sourceDir = path.dirname(file);
+        const isNestedStructure = path.basename(file) === "translation.json";
         const languageResults = await Promise.all((options.targets || []).map(async (targetLang) => {
             try {
-                const targetPath = path.join(path.dirname(file), `${targetLang}.json`);
+                let targetPath;
+                if (isNestedStructure) {
+                    const localesRoot = path.dirname(sourceDir);
+                    targetPath = path.join(localesRoot, targetLang, "translation.json");
+                }
+                else {
+                    targetPath = path.join(sourceDir, `${targetLang}.json`);
+                }
                 const targetContent = await FileManager.readJSON(targetPath);
                 return { targetLang, targetPath, content: targetContent, success: true };
             }
             catch (err) {
-                await uiManager.log(`Could not read ${targetLang}.json: ${err.message}`);
+                await uiManager.log(`Could not read ${targetLang}: ${err.message}`);
                 return {
                     targetLang,
                     targetPath: "",

package/dist/utils/file-manager.d.ts

@@ -40,6 +40,12 @@ declare class FileManager {
      * @returns Current configuration
      */
     static getConfig(): FileOptions;
+    /**
+     * Find locale files in the specified directory
+     * @param localesDir - Directory containing locale files
+     * @param sourceLang - Source language code
+     * @returns Array of file paths
+     */
     /**
      * Find locale files in the specified directory
      * @param localesDir - Directory containing locale files

package/dist/utils/file-manager.js

@@ -37,6 +37,12 @@ class FileManager {
     static getConfig() {
         return this.options || this.defaultOptions;
     }
+    /**
+     * Find locale files in the specified directory
+     * @param localesDir - Directory containing locale files
+     * @param sourceLang - Source language code
+     * @returns Array of file paths
+     */
     /**
      * Find locale files in the specified directory
      * @param localesDir - Directory containing locale files
@@ -45,17 +51,45 @@ class FileManager {
      */
     static async findLocaleFiles(localesDir, sourceLang) {
         try {
-            // Find any file with the source language name (ignoring extension)
+            // Priority 1: Check for nested structure: localesDir/sourceLang/translation.json
+            // This is the standard i18next-fs-backend pattern
+            const nestedPath = path.join(localesDir, sourceLang, "translation.json");
+            if (await this.exists(nestedPath)) {
+                return [nestedPath];
+            }
+            // Priority 2: Check for flat structure: localesDir/sourceLang.json
+            const flatPath = path.join(localesDir, `${sourceLang}.json`);
+            if (await this.exists(flatPath)) {
+                return [flatPath];
+            }
+            // Priority 3: Scan directory for any file starting with sourceLang
+            // This matches "en-US.json" or "en_GB.json" if sourceLang is "en"
             const files = await fs.readdir(localesDir);
             const sourceFiles = files
-                .filter((file) => file.startsWith(`${sourceLang}.`))
+                .filter((file) => file.startsWith(`${sourceLang}.`) || file === sourceLang)
                 .map((file) => path.join(localesDir, file));
             if (sourceFiles.length === 0) {
                 throw new Error(`Source language file not found for '${sourceLang}' in ${localesDir}`);
             }
-            // Return the first match, or maybe prioritize JSON?
-            // For now, return all matches, but usually there's only one.
-            return sourceFiles;
+            // Filter specifically for files or directories that look like the locale
+            const validFiles = [];
+            for (const file of sourceFiles) {
+                const stats = await fs.stat(file);
+                if (stats.isDirectory()) {
+                    // If it's a directory, check for translation.json inside
+                    const nestedTrial = path.join(file, "translation.json");
+                    if (await this.exists(nestedTrial)) {
+                        validFiles.push(nestedTrial);
+                    }
+                }
+                else {
+                    validFiles.push(file);
+                }
+            }
+            if (validFiles.length > 0) {
+                return validFiles;
+            }
+            throw new Error(`Source language file not found for '${sourceLang}' in ${localesDir}`);
         }
         catch (err) {
             if (err.code === "ENOENT") {

package/dist/utils/rate-limiter.js

@@ -398,7 +398,7 @@ class RateLimiter {
 }
 const config = {
     queueStrategy: process.env.QUEUE_STRATEGY || "priority",
-    queueTimeout: parseInt(process.env.QUEUE_TIMEOUT || "30000"),
+    queueTimeout: parseInt(process.env.QUEUE_TIMEOUT || "60000"),
     adaptiveThrottling: process.env.ADAPTIVE_THROTTLING !== "false",
 };
 export default new RateLimiter(config);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "locai",
-	"version": "2.5.1",
+	"version": "2.6.0",
 	"type": "module",
 	"main": "dist/core/orchestrator.js",
 	"types": "dist/core/orchestrator.d.ts",
@@ -75,32 +75,32 @@
 		"axios": "1.13.2",
 		"c12": "^3.3.3",
 		"commander": "^14.0.2",
-		"dot-properties": "^1.1.0",
+		"dot-properties": "^1.1.1",
 		"dotenv": "^17.2.3",
 		"fast-xml-parser": "^5.3.3",
-		"gettext-parser": "^8.0.0",
+		"gettext-parser": "^9.0.0",
 		"jiti": "^2.6.1",
 		"js-yaml": "^4.1.1",
 		"lru-cache": "^11.2.4",
 		"p-limit": "^7.2.0",
 		"prompts": "^2.4.2",
 		"ts-morph": "^27.0.2",
-		"vectra": "^0.11.1"
+		"vectra": "^0.12.3"
 	},
 	"devDependencies": {
 		"@eslint/js": "^9.39.2",
 		"@types/js-yaml": "^4.0.9",
-		"@types/node": "^25.0.3",
+		"@types/node": "^25.0.7",
 		"@types/prompts": "^2.4.9",
-		"@vitest/coverage-v8": "^4.0.16",
+		"@vitest/coverage-v8": "^4.0.17",
 		"eslint": "^9.39.2",
 		"eslint-config-prettier": "^10.1.8",
-		"globals": "^16.5.0",
+		"globals": "^17.0.0",
 		"prettier": "^3.7.4",
 		"std-mocks": "^2.0.0",
 		"tsx": "^4.21.0",
 		"typescript": "^5.9.3",
-		"vitest": "^4.0.16"
+		"vitest": "^4.0.17"
 	},
 	"files": [
 		"dist/"