gptrans 1.1.2 → 1.1.6

package/README.md

@@ -20,6 +20,15 @@ Whether you're building a multilingual website, a mobile app, or a localization
 npm install gptrans
 ```
 
+### 🌐 Environment Setup
+
+GPTrans uses dotenv for environment configuration. Create a `.env` file in your project root and add your API keys:
+
+```env
+OPENAI_API_KEY=your_openai_api_key
+ANTHROPIC_API_KEY=your_anthropic_api_key
+```
+
 ## 🚀 Quick Start
 
 Here's a simple example to get you started:
@@ -28,8 +37,8 @@ Here's a simple example to get you started:
 import GPTrans from 'gptrans';
 
 const gptrans = new GPTrans({
-  target: 'es-AR',
   from: 'en-US',
+  target: 'es-AR',
   model: 'claude-3-5-sonnet-20241022'
 });
 
@@ -52,13 +61,13 @@ console.log(gptrans.t('Card'));
 
 ## ⚙️ Configuration Options
 
-When creating a new instance of Gptrans, you can customize:
+When creating a new instance of GPTrans, you can customize:
 
 | Option | Description | Default |
 |--------|-------------|---------|
-| `target` | Target language locale | `'en-US'` |
-| `from` | Source language locale | `'es-AR'` |
-| `model` | Translation model key | - |
+| `from` | Source language locale | `es-AR` |
+| `target` | Target language locale | `en-US` |
+| `model` | Translation model key | `claude-3-7-sonnet` |
 | `batchThreshold` | Maximum number of characters to accumulate before triggering batch processing | `1000` |
 | `debounceTimeout` | Time in milliseconds to wait before processing translations | `500` |
 
@@ -82,25 +91,16 @@ When creating a new instance of Gptrans, you can customize:
 }
 ```
 
-## 🌐 Environment Setup
-
-Gptrans uses dotenv for environment configuration. Create a `.env` file in your project root and add your API keys:
-
-```env
-OPENAI_API_KEY=your_openai_api_key
-ANTHROPIC_API_KEY=your_anthropic_api_key
-```
-
-## 🎉 Why Choose Gptrans?
+## 🎉 Why Choose GPTrans?
 
-Gptrans stands out by combining advanced AI capabilities with efficient batching and caching. This means:
+GPTrans stands out by combining advanced AI capabilities with efficient batching and caching. This means:
 
 - **Speed:** Reduced API calls and instant retrieval of cached translations
 - **Quality:** Leverage state-of-the-art models for precise and context-aware translations
 - **Flexibility:** Tailor the tool to your specific localization needs with minimal effort
 - **Zero Maintenance:** Set it up once and forget about it - automatic updates and self-healing capabilities keep everything running smoothly
 
-If you're looking to streamline your translation workflow and bring your applications to a global audience effortlessly, Gptrans is the perfect choice!
+If you're looking to streamline your translation workflow and bring your applications to a global audience effortlessly, GPTrans is the perfect choice!
 
 ## Contributing
 

package/db/gptrans_ar.json

@@ -0,0 +1,9 @@
+{
+    "topup_uzdh5y": "شحن",
+    "transf_176pc1a": "تحويل",
+    "deposi_wg2ec5": "إيداع",
+    "balanc_1rv8if7": "رصيد",
+    "transa_1wtqm5d": "معاملة",
+    "accoun_x1y0v8": "حساب",
+    "card_yis1ox": "بطاقة"
+}

package/demo/case_2.js

@@ -0,0 +1,19 @@
+import GPTrans from '../index.js';
+
+try {
+    const gptrans = new GPTrans({
+        target: 'ar',
+        model: 'claude-3-7-sonnet-20250219',
+    });
+
+    console.log(gptrans.t('Top-up'));
+    console.log(gptrans.t('Transfer'));
+    console.log(gptrans.t('Deposit'));
+    console.log(gptrans.t('Balance'));
+    console.log(gptrans.t('Transaction'));
+    console.log(gptrans.t('Account'));
+    console.log(gptrans.t('Card'));    
+} catch (e) {
+    console.error(e);
+}
+

package/index.js

@@ -2,8 +2,7 @@ import DeepBase from 'deepbase';
 import stringHash from 'string-hash';
 import { ModelMix, MixOpenAI, MixAnthropic } from 'modelmix';
 import dotenv from 'dotenv';
-import { fileURLToPath } from 'url';
-import { dirname, join } from 'path';
+import path from 'path';
 
 import { isoAssoc } from './isoAssoc.js';
 dotenv.config();
@@ -23,19 +22,24 @@ class Gptrans {
         return this.#mmixInstance;
     }
 
-    constructor({ from = 'en-US', target = 'es-AR', model = 'gpt-4o-mini', batchThreshold = 1000, debounceTimeout = 500, promptFile = null, context = '' }) {
-        const __dirname = dirname(fileURLToPath(import.meta.url));
-        this.target = target;
-        this.from = from;
-        this.dbTarget = new DeepBase({ name: 'gptrans_' + this.target });
-        this.dbFrom = new DeepBase({ name: 'gptrans_from_' + this.from });
+    constructor({ from = 'en-US', target = 'es-AR', model = 'claude-3-7-sonnet-20250219', batchThreshold = 1000, debounceTimeout = 500, promptFile = null, context = '' }) {
+        this.dbTarget = new DeepBase({ name: 'gptrans_' + target });
+        this.dbFrom = new DeepBase({ name: 'gptrans_from_' + from });
+        
+        try {
+            this.replace_target = isoAssoc(target, 'TARGET_');
+            this.replace_from = isoAssoc(from, 'FROM_');
+        } catch (e) {
+            throw new Error(`Invalid target: ${target}`);
+        }
+
         this.batchThreshold = batchThreshold; // Now represents character count threshold
         this.debounceTimeout = debounceTimeout;
         this.pendingTranslations = new Map(); // [key, text]
         this.pendingCharCount = 0; // Add character count tracker
         this.debounceTimer = null;
         this.modelKey = model;
-        this.promptFile ??= join(__dirname, './prompt/translate.md');  // Convert to absolute path
+        this.promptFile ??= path.resolve('./prompt/translate.md');  // Convert to absolute path
         this.context = context;
         this.modelConfig = {
             config: {
@@ -125,8 +129,8 @@ class Gptrans {
         model.addTextFromFile(this.promptFile);
 
         model.replace({ INPUT: text, CONTEXT: this.context });
-        model.replace(isoAssoc(this.target, 'TARGET_'));
-        model.replace(isoAssoc(this.from, 'FROM_'));
+        model.replace(this.replace_target);
+        model.replace(this.replace_from);
 
         const response = await model.message();
 

package/isoAssoc.js

@@ -169,10 +169,26 @@ export function isoAssoc(iso, prefix = '') {
         throw new Error(`Invalid country code: ${country}`);
     }
 
+    // Special handling for languages with variants
+    let denonym = country ? countryDenonym[country] : 'Neutral';
+    
+    // Handle Chinese without specified dialect (use "Simplified" instead of "Neutral")
+    if (lang === 'zh' && !country) {
+        denonym = 'Simplified';
+    }
+    // Handle Arabic without specified dialect (use "Standard" instead of "Neutral")
+    else if (lang === 'ar' && !country) {
+        denonym = 'Standard';
+    }
+    // Handle Portuguese without specified dialect (use "European" instead of "Neutral")
+    else if (lang === 'pt' && !country) {
+        denonym = 'European';
+    }
+
     return {
         [prefix + 'ISO']: iso,
         [prefix + 'LANG']: langName[lang],
         [prefix + 'COUNTRY']: country ? countryName[country] : langName[lang],
-        [prefix + 'DENONYM']: country ? countryDenonym[country] : 'Universal',
+        [prefix + 'DENONYM']: denonym,
     };
 } 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gptrans",
   "type": "module",
-  "version": "1.1.2",
+  "version": "1.1.6",
   "description": "🚆 GPTrans - The smarter AI-powered way to translate.",
   "keywords": [
     "translate",