gptrans 1.5.8 → 1.6.2

package/README.md

@@ -67,7 +67,7 @@ When creating a new instance of GPTrans, you can customize:
 |--------|-------------|---------|
 | `from` | Source language locale (BCP 47) | `en-US` |
 | `target` | Target language locale (BCP 47) | `es` |
-| `model` | Translation model key | `claude-3-7-sonnet` |
+| `model` | Translation model key or array of models for fallback | `claude-3-7-sonnet` |
 | `batchThreshold` | Maximum number of characters to accumulate before triggering batch processing | `1500` |
 | `debounceTimeout` | Time in milliseconds to wait before processing translations | `500` |
 | `freeze` | Freeze mode to prevent translations from being queued | `false` |
@@ -119,9 +119,25 @@ If you're looking to streamline your translation workflow and bring your applica
 You can preload translations for specific languages using the `preload` method. This is particularly useful when you want to initialize translations based on dynamically generated keys:
 
 ```javascript
-await gptrans.preload({target:'ar'});
+await gptrans.preload({ target:'ar' });
 ```
 
+### Model Fallback System
+
+GPTrans supports a fallback mechanism for translation models. Instead of providing a single model, you can pass an array of models:
+
+```javascript
+const translator = new GPTrans({
+  model: ['claude-3-7-sonnet-20250219', 'o3-mini-2025-01-31'],
+  // ... other options
+});
+```
+
+When using multiple models:
+- The first model in the array is used as the primary translation service
+- If the primary model fails (due to API errors, rate limits, etc.), GPTrans automatically falls back to the next model
+- This ensures higher availability and resilience of your translation service
+
 ## Contributing
 
 Contributions are welcome! Please open an issue or submit a pull request on GitHub to contribute improvements or fixes.

package/db/gptrans_en.json

@@ -1,9 +1,10 @@
 {
     "45h": {
-        "eres_muy_bueno_26czme": "You're very good",
+        "eres_muy_bueno\n_lo_eres_1lkenvc": "You're very good\n---\nYou truly are",
         "tienes_fuego_1i2o3ok": "Do you have a light?"
     },
     "1sfvxng": {
-        "eres_muy_bueno_26czme": "You are very good"
+        "eres_muy_bueno_26czme": "You are very good",
+        "_memora_intern_p18x__vrlf96": "| **INTERNAL MEMORANDUM P-18-X**  |                       |\n| ------------------------------- | --------------------- |\n| **From:**                       | Zentara Group         |\n| **Date:**                       | February 15, 2018     |\n| **Time:**                       | 06:00 AM GMT          |\n| **Confidentiality Level:**      | ALPHA-8               |\n\n\n## Incident in South Georgia\n### Advanced MPD Propulsion ZNC-S20 Vessel\n\nAt 03:45 AM GMT on February 15, 2018, an **Advanced MPD Propulsion ZNC-S20 Vessel** experienced a loss of control due to causes still unknown. The vessel performed an emergency landing at coordinates **54°39'44.62\" S 36°11'42.47\" W** in South Georgia, leaving a furrow approximately 1 km long across the snow and surrounding mountains.\n\n![full](/ODF.ZNG/georgia_incident/aereal_view.jpg)\n*Aerial view of the impact.*\n\n### **Immediate Actions:**\n\n1. **Containment Team Deployment:**\n   - Send specialized units to the impact site to secure the area and recover the vessel.\n   - Establish a 15 km security perimeter and restrict access to all unauthorized personnel.\n\n2. **Information Control:**\n   - Apply confidentiality procedures for all personnel involved.\n   - Implement disinformation protocols for any eyewitnesses.\n\n3. **Satellite Image Manipulation:**\n   - Coordinate with the Satellite Observation Department to, in the short term, **replace images simulating a glacier collapse**.\n   - In the long term, **remove high-quality satellite images of the area**.\n\n4. **Communication with Local Population:**\n   - Inform residents that security operations are being conducted due to geological risks.\n   - Restrict access to nearby areas.\n\n5. **Media Management:**\n   - Issue an official statement reporting an avalanche in the area caused by a glacier collapse.\n   - Facilitate interviews with experts such as Dr. Richard Waller to support the official version.\n\n6. **Social Media Monitoring and Control:**\n   - Monitor digital platforms to identify and neutralize any information leaks.\n   - Disseminate content that reinforces the official narrative.\n\n### **Official Scientific Narrative:**\n\nDr. Richard Waller, geologist from Keele University, will indicate that the observed phenomenon was a consequence of a glacier collapse, which has left visible debris in the snow. He will also suggest that the trail in the snow is related to a recent avalanche in the area.\n\n![full](/ODF.ZNG/georgia_incident/maps_view.jpg)\n*Proposal to replace satellite images of the area.*\n\n---\n\n### **Conclusions and Next Steps:**\n\nThe situation must be handled with the highest level of discretion. All departments must work in coordination to ensure that the incident remains confidential. The described actions are expected to be implemented immediately and effectively.\n\n\n![width=200](/ODF.ZNG/sign.png)\n**Michael Camelbot**\n\nZentara Group\n\n---\n\n**This document is confidential and intended only for authorized Zentara Group personnel. Any unauthorized disclosure is strictly prohibited and will be sanctioned according to internal security protocols.**"
     }
 }

package/db/gptrans_from_es.json

@@ -1,9 +1,10 @@
 {
     "": {
-        "eres_muy_bueno_26czme": "Eres muy bueno",
+        "eres_muy_bueno\n_lo_eres_1lkenvc": "Eres muy bueno\n---\nVerdaderamente lo eres",
         "tienes_fuego_1i2o3ok": "Tienes fuego?"
     },
     "El mensaje es para una mujer": {
-        "eres_muy_bueno_26czme": "Eres muy bueno"
+        "eres_muy_bueno_26czme": "Eres muy bueno",
+        "_memora_intern_p18x__vrlf96": "| **MEMORANDO INTERNO P-18-X**   |                       |\n| ------------------------------ | --------------------- |\n| **Emisor:**                    | Zentara Group         |\n| **Fecha:**                     | 15 de febrero de 2018 |\n| **Hora:**                      | 06:00 AM GMT          |\n| **Nivel de Confidencialidad:** | ALPHA-8               |\n\n\n## Incidente en South Georgia\n### Nave ZNC-S20 de Propulsión MPD Avanzada\n\nA las 03:45 AM GMT del 15 de febrero de 2018, una **Nave ZNC-S20 de Propulsión MPD Avanzada** sufrió una pérdida de control por causas aún desconocidas. La nave realizó un aterrizaje de emergencia en las coordenadas **54°39'44.62\" S 36°11'42.47\" W** en South Georgia, dejando una surco de aproximadamente 1 km a través de la nieve y las montañas circundantes.\n\n![full](/ODF.ZNG/georgia_incident/aereal_view.jpg)\n*Vista aérea del impacto.*\n\n### **Acciones Inmediatas:**\n\n1. **Despliegue de Equipo de Contención:**\n   - Enviar unidades especializadas al sitio del impacto para asegurar el área y recuperar la nave.\n   - Establecer un perímetro de seguridad de 15 km y restringir el acceso a todo personal no autorizado.\n\n2. **Control de Información:**\n   - Aplicar procedimientos de confidencialidad para todo el personal involucrado.\n   - Implementar protocolos de desinformación para cualquier testigo presencial.\n\n3. **Manipulación de Imágenes Satelitales:**\n   - Coordinar con el Departamento de Observación Satelital para, a corto plazo, **sustituir imágenes simulando un desprendimiento glaciar**.\n   - A largo plazo, **eliminar las imágenes satelitales de alta calidad en la zona**.\n\n4. **Comunicación con la Población Local:**\n   - Informar a los residentes que se están llevando a cabo operaciones de seguridad por riesgos geológicos.\n   - Restringir el acceso a áreas próximas.\n\n5. **Gestión de Medios de Comunicación:**\n   - Emitir un comunicado oficial informando sobre una avalancha en la zona ocasionada por el colapso de un glaciar.\n   - Facilitar entrevistas con expertos como el Dr. Richard Waller para respaldar la versión oficial.\n\n6. **Monitoreo y Control de Redes Sociales:**\n   - Supervisar plataformas digitales para identificar y neutralizar cualquier filtración de información.\n   - Difundir contenido que refuerce la narrativa oficial.\n\n### **Narrativa Científica Oficial:**\n\nEl Dr. Richard Waller, geólogo de la Universidad Keele, indicará que el fenómeno observado fue consecuencia del colapso de un glaciar, lo que ha dejado escombros visibles en la nieve. También sugerirá que el rastro en la nieve está relacionado con una avalancha reciente en la zona.\n\n![full](/ODF.ZNG/georgia_incident/maps_view.jpg)\n*Propuesta para reemplazar las imagenes satelitales de la zona.*\n\n---\n\n### **Conclusiones y Pasos a Seguir:**\n\nLa situación debe ser manejada con el máximo nivel de discreción. Todos los departamentos deben trabajar en coordinación para asegurar que el incidente permanezca confidencial. Se espera que las acciones descritas sean implementadas de forma inmediata y efectiva.\n\n\n![width=200](/ODF.ZNG/sign.png)\n**Michael Camelbot**\n\nZentara Group\n\n---\n\n**Este documento es confidencial y está destinado únicamente al personal autorizado de Zentara Group. Cualquier divulgación no autorizada está estrictamente prohibida y será sancionada conforme a protocolos internos de seguridad.**"
     }
 }

package/demo/case_4.js

@@ -1,17 +1,27 @@
 import GPTrans from '../index.js';
+import { dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { promises as fs } from 'fs';
 
+// Get current file directory
+const __dirname = dirname(fileURLToPath(import.meta.url));
 
-// Case 2: Translate from Spanish to English
+// Initialize translator
 const model = new GPTrans({
-    from: 'es',
+    model: ['claude-3-7-sonnet-20250219', 'o3-mini-2025-01-31'],
+    from: 'es',  // Assuming the source file is in Spanish
     target: 'en',
 });
 
+// Load the model
 await model.preload();
 
+// Read and translate the file
+const filePath = `${__dirname}/georgia_incident.md`;
+const content = await fs.readFile(filePath, 'utf-8');
 
-console.log(model.setContext().t('Eres muy bueno'));
-console.log(model.setContext('El mensaje es para una mujer').t('Eres muy bueno'));
+// Translate the content
+const translatedContent = model.t(content);
+console.log(translatedContent);
 
 
-console.log(model.setContext().t('Tienes fuego?'));

package/demo/georgia_incident.md

@@ -0,0 +1,64 @@
+| **MEMORANDO INTERNO P-18-X**   |                       |
+| ------------------------------ | --------------------- |
+| **Emisor:**                    | Zentara Group         |
+| **Fecha:**                     | 15 de febrero de 2018 |
+| **Hora:**                      | 06:00 AM GMT          |
+| **Nivel de Confidencialidad:** | ALPHA-8               |
+
+
+## Incidente en South Georgia
+### Nave ZNC-S20 de Propulsión MPD Avanzada
+
+A las 03:45 AM GMT del 15 de febrero de 2018, una **Nave ZNC-S20 de Propulsión MPD Avanzada** sufrió una pérdida de control por causas aún desconocidas. La nave realizó un aterrizaje de emergencia en las coordenadas **54°39'44.62" S 36°11'42.47" W** en South Georgia, dejando una surco de aproximadamente 1 km a través de la nieve y las montañas circundantes.
+
+![full](/ODF.ZNG/georgia_incident/aereal_view.jpg)
+*Vista aérea del impacto.*
+
+### **Acciones Inmediatas:**
+
+1. **Despliegue de Equipo de Contención:**
+   - Enviar unidades especializadas al sitio del impacto para asegurar el área y recuperar la nave.
+   - Establecer un perímetro de seguridad de 15 km y restringir el acceso a todo personal no autorizado.
+
+2. **Control de Información:**
+   - Aplicar procedimientos de confidencialidad para todo el personal involucrado.
+   - Implementar protocolos de desinformación para cualquier testigo presencial.
+
+3. **Manipulación de Imágenes Satelitales:**
+   - Coordinar con el Departamento de Observación Satelital para, a corto plazo, **sustituir imágenes simulando un desprendimiento glaciar**.
+   - A largo plazo, **eliminar las imágenes satelitales de alta calidad en la zona**.
+
+4. **Comunicación con la Población Local:**
+   - Informar a los residentes que se están llevando a cabo operaciones de seguridad por riesgos geológicos.
+   - Restringir el acceso a áreas próximas.
+
+5. **Gestión de Medios de Comunicación:**
+   - Emitir un comunicado oficial informando sobre una avalancha en la zona ocasionada por el colapso de un glaciar.
+   - Facilitar entrevistas con expertos como el Dr. Richard Waller para respaldar la versión oficial.
+
+6. **Monitoreo y Control de Redes Sociales:**
+   - Supervisar plataformas digitales para identificar y neutralizar cualquier filtración de información.
+   - Difundir contenido que refuerce la narrativa oficial.
+
+### **Narrativa Científica Oficial:**
+
+El Dr. Richard Waller, geólogo de la Universidad Keele, indicará que el fenómeno observado fue consecuencia del colapso de un glaciar, lo que ha dejado escombros visibles en la nieve. También sugerirá que el rastro en la nieve está relacionado con una avalancha reciente en la zona.
+
+![full](/ODF.ZNG/georgia_incident/maps_view.jpg)
+*Propuesta para reemplazar las imagenes satelitales de la zona.*
+
+---
+
+### **Conclusiones y Pasos a Seguir:**
+
+La situación debe ser manejada con el máximo nivel de discreción. Todos los departamentos deben trabajar en coordinación para asegurar que el incidente permanezca confidencial. Se espera que las acciones descritas sean implementadas de forma inmediata y efectiva.
+
+
+![width=200](/ODF.ZNG/sign.png)
+**Michael Camelbot**
+
+Zentara Group
+
+---
+
+**Este documento es confidencial y está destinado únicamente al personal autorizado de Zentara Group. Cualquier divulgación no autorizada está estrictamente prohibida y será sancionada conforme a protocolos internos de seguridad.**

package/index.js

@@ -40,8 +40,9 @@ class GPTrans {
 
         }
 
-        this.dbTarget = new DeepBase({ name: 'gptrans_' + target });
-        this.dbFrom = new DeepBase({ name: 'gptrans_from_' + from });
+        const path = new URL('../../db', import.meta.url).pathname;
+        this.dbTarget = new DeepBase({ name: 'gptrans_' + target, path });
+        this.dbFrom = new DeepBase({ name: 'gptrans_from_' + from, path });
 
         try {
             this.replaceTarget = isoAssoc(target, 'TARGET_');

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gptrans",
   "type": "module",
-  "version": "1.5.8",
+  "version": "1.6.2",
   "description": "🚆 GPTrans - The smarter AI-powered way to translate.",
   "keywords": [
     "translate",
@@ -34,7 +34,7 @@
   "dependencies": {
     "deepbase": "^1.4.8",
     "dotenv": "^16.4.7",
-    "modelmix": "^2.9.0",
+    "modelmix": "^2.9.2",
     "string-hash": "^1.1.3"
   }
 }

package/db/gptrans_es.json

@@ -1,5 +0,0 @@
-{
-    "1sfvxng": {
-        "eres_muy_bueno_26czme": "Eres muy buena"
-    }
-}