ai-l10n-sdk 1.4.1 → 1.5.0

package/CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to the SDK package will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.5.0] - 2026-04-16
+
+### Changed
+- Updated to use `ai-l10n-core@1.5.0` — all API methods now return `ApiResponse<T>` and never throw
+- `TranslationOutput.remainingBalance` is now sourced from `TranslationResponse.currentBalance` (unchanged behavior for consumers)
+- Error results from `translate()` (previously thrown or null-returned) are now uniformly surfaced as failed `TranslationOutput` entries with the error `message` from `TranslationResponse`
+
 ## [1.4.0] - 2026-04-02
 
 ### Added

package/dist/apiKeyManager.js

@@ -41,7 +41,7 @@ const ai_l10n_core_1 = require("ai-l10n-core");
 class ApiKeyManager {
     constructor(logger = new ai_l10n_core_1.ConsoleLogger()) {
         this.logger = logger;
-        this.noApiKeyMessage = "ℹ️ API Key not found. Please provide it via:\n" +
+        this.noApiKeyMessage = "ℹ️  API Key not found. Please provide it via:\n" +
             "1. Configuration option (apiKey)\n" +
             "2. Environment variable (L10N_API_KEY)\n" +
             "3. Run 'ai-l10n config --api-key YOUR_KEY' to save it\n" +

package/dist/index.js

@@ -69,7 +69,7 @@ class AiTranslator {
             const fileExtension = path.extname(sourceFilePath);
             const format = fileExtension.slice(1);
             if (verbose) {
-                console.log(`📂 Source file: ${sourceFilePath}`);
+                this.logger.logInfo(`📂 Source file: ${sourceFilePath}`);
             }
             // Ensure API key is available
             const apiKey = await this.apiKeyManager.ensureApiKey(config.apiKey);
@@ -82,7 +82,7 @@ class AiTranslator {
                 if (targetLanguages.length === 0) {
                     throw new Error("No target languages found. Please specify targetLanguages in config or ensure your project has the proper structure (e.g., folders named with language codes or files named with language codes).");
                 }
-                console.log(`✨ Auto-detected target languages from project structure: ${targetLanguages.join(", ")}`);
+                this.logger.logInfo(`✨ Auto-detected target languages from project structure: ${targetLanguages.join(", ")}`);
             }
             // Validate language codes
             for (const lang of targetLanguages) {
@@ -91,7 +91,7 @@ class AiTranslator {
                 }
             }
             if (verbose) {
-                console.log(`🎯 Target languages: ${targetLanguages.join(", ")}`);
+                this.logger.logInfo(`🎯 Target languages: ${targetLanguages.join(", ")}`);
             }
             // Prepare configuration
             const useContractions = config.useContractions ?? true;
@@ -101,7 +101,7 @@ class AiTranslator {
             const saveFilteredStrings = config.saveFilteredStrings ?? true;
             const translateOnlyNewStrings = config.translateOnlyNewStrings ?? false;
             if (verbose) {
-                console.log(`Configuration:
+                this.logger.logInfo(`Configuration:
   - Use contractions: ${useContractions}
   - Use shortening: ${useShortening}
   - Generate plural forms: ${generatePluralForms}
@@ -114,17 +114,16 @@ class AiTranslator {
             const translationPromises = targetLanguages.map(async (targetLanguage, i) => {
                 const targetFilePath = this.i18nProjectManager.generateTargetFilePath(sourceFilePath, targetLanguage);
                 try {
-                    console.log(`\n🌐 Translating (${i + 1}/${totalLanguages}) to ${targetLanguage}...`);
+                    this.logger.logInfo(`\n🌐 Translating (${i + 1}/${totalLanguages}) to ${targetLanguage}...`);
                     const result = await this.performTranslation(apiKey, sourceFilePath, targetLanguage, targetFilePath, translateOnlyNewStrings, useContractions, useShortening, generatePluralForms, translateMetadata, saveFilteredStrings, format, verbose);
                     return result;
                 }
                 catch (error) {
-                    const errorMessage = error instanceof Error ? error.message : "Unknown error";
-                    console.error(`❌ Translation to ${targetLanguage} failed: ${errorMessage}`);
+                    this.logger.showAndLogError(`Translation to ${targetLanguage} failed`, error);
                     return {
                         success: false,
                         language: targetLanguage,
-                        error: errorMessage,
+                        error: error instanceof Error ? error.message : "Unknown error",
                     };
                 }
             });
@@ -143,19 +142,19 @@ class AiTranslator {
             }
             // Summary
             const successCount = results.filter((r) => r.success).length;
-            console.log(`\n${"=".repeat(50)}`);
-            console.log(`📊 Translation Summary`);
-            console.log(`${"=".repeat(50)}`);
-            console.log(`✅ Successful: ${successCount}/${targetLanguages.length}`);
-            console.log(`📝 Total characters used: ${totalCharsUsed.toLocaleString()}`);
+            this.logger.logInfo(`\n${"=".repeat(50)}`);
+            this.logger.logInfo(`📊 Translation Summary`);
+            this.logger.logInfo(`${"=".repeat(50)}`);
+            this.logger.logInfo(`✅ Successful: ${successCount}/${targetLanguages.length}`);
+            this.logger.logInfo(`📝 Total characters used: ${totalCharsUsed.toLocaleString()}`);
             if (remainingBalance !== undefined && remainingBalance !== null) {
-                console.log(`💰 Remaining balance: ${remainingBalance.toLocaleString()} characters`);
+                this.logger.logInfo(`💰 Remaining balance: ${remainingBalance.toLocaleString()} characters`);
             }
             if (successCount < targetLanguages.length) {
                 const failedLanguages = results
                     .filter((r) => !r.success)
                     .map((r) => r.language);
-                console.log(`❌ Failed: ${failedLanguages.join(", ")}`);
+                this.logger.logWarning(`Failed: ${failedLanguages.join(", ")}`);
             }
             return {
                 success: successCount > 0,
@@ -165,8 +164,7 @@ class AiTranslator {
             };
         }
         catch (error) {
-            const errorMessage = error instanceof Error ? error.message : "Unknown error";
-            console.error(`❌ Translation failed: ${errorMessage}`);
+            this.logger.showAndLogError("Translation failed", error);
             return {
                 success: false,
                 results: [],
@@ -182,7 +180,7 @@ class AiTranslator {
         if (translateOnlyNewStrings && fs.existsSync(targetFilePath)) {
             targetStrings = fs.readFileSync(targetFilePath, "utf8");
             if (verbose) {
-                console.log(`  📄 Updating existing file: ${targetFilePath}`);
+                this.logger.logInfo(`  📄 Updating existing file: ${targetFilePath}`);
             }
         }
         // Normalize language code for API
@@ -196,21 +194,21 @@ class AiTranslator {
             generatePluralForms,
             translateMetadata,
             client: ai_l10n_core_1.CONFIG.CLIENT,
-            returnTranslationsAsString: true,
             translateOnlyNewStrings,
             targetStrings,
             schema: format === "arb" ? ai_l10n_core_1.FileSchema.ARBFlutter : null,
             format,
         };
         // Call translation service
-        const result = await this.translationService.translate(request, apiKey);
-        if (!result) {
+        const response = await this.translationService.translate(request, apiKey);
+        if (!response.success) {
             return {
                 success: false,
                 language: targetLanguage,
-                error: "Translation service returned no result",
+                error: response.message ?? "Translation service returned no result",
             };
         }
+        const result = response.data;
         if (!result.translations) {
             return {
                 success: false,
@@ -230,14 +228,14 @@ class AiTranslator {
             this.handleFilteredStrings(result, outputPath, saveFilteredStrings);
         }
         const charsUsed = result.usage.charsUsed || 0;
-        console.log(`  ✅ Saved to: ${outputPath}`);
-        console.log(`  📊 Characters used: ${charsUsed.toLocaleString()}`);
+        this.logger.logInfo(`  ✅ Saved to: ${outputPath}`);
+        this.logger.logInfo(`  📊 Characters used: ${charsUsed.toLocaleString()}`);
         return {
             success: true,
             language: targetLanguage,
             outputPath,
             charsUsed,
-            remainingBalance: result.remainingBalance,
+            remainingBalance: response.currentBalance,
         };
     }
     handleFilteredStrings(result, targetFilePath, saveFilteredStrings) {
@@ -252,9 +250,9 @@ class AiTranslator {
             return;
         }
         const filteredStringsContent = result.filteredStrings ?? "";
-        console.warn(`  ⚠️  Some string(s) were excluded due to ${reasonMessage}`);
+        this.logger.logWarning(`Some strings were excluded due to ${reasonMessage}`);
         if (result.finishReason === ai_l10n_core_1.FinishReason.contentFilter) {
-            console.warn(`  ℹ️ View content policy at: ${ai_l10n_core_1.URLS.CONTENT_POLICY}`);
+            this.logger.logInfo(`  ℹ️ View content policy at: ${ai_l10n_core_1.URLS.CONTENT_POLICY}`);
         }
         if (saveFilteredStrings) {
             const ext = path.extname(targetFilePath);
@@ -262,10 +260,10 @@ class AiTranslator {
             const dir = path.dirname(targetFilePath);
             const filteredPath = path.join(dir, `${base}.filtered${ext}`);
             fs.writeFileSync(filteredPath, filteredStringsContent, "utf8");
-            console.log(`  📝 Filtered strings saved to: ${filteredPath}`);
+            this.logger.logInfo(`  📝 Filtered strings saved to: ${filteredPath}`);
         }
         else {
-            console.log(`  📝 Filtered strings:\n${filteredStringsContent}`);
+            this.logger.logInfo(`  📝 Filtered strings:\n${filteredStringsContent}`);
         }
     }
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-l10n-sdk",
-  "version": "1.4.1",
+  "version": "1.5.0",
   "description": "Lightweight SDK for AI-powered localization automation - programmatic API (no CLI)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -46,7 +46,7 @@
     "node": ">=14.0.0"
   },
   "dependencies": {
-    "ai-l10n-core": "^1.4.1"
+    "ai-l10n-core": "^1.5.0"
   },
   "devDependencies": {
     "@types/mocha": "^10.0.10",