@rimori/client 2.5.8-next.2 → 2.5.8-next.3

package/README.md

@@ -119,7 +119,7 @@ Access metadata and settings through `client.plugin`:
 - `plugin.getSettings(defaults)` / `plugin.setSettings(settings)` – persist configuration.
 - `plugin.getPluginInfo()` – read active/installed plugin information.
 - `plugin.getUserInfo()` – obtain user profile details (language, name, guild, etc.).
-- `plugin.getTranslator()` – lazily initialize the translator for manual i18n.
+- `plugin.getTranslator()` – lazily initialize the translator for manual i18n. Translation keys must follow the dot notation (`section.subsection.key`); non-key strings are translated via AI and cached.
 
 ### Database Access
 
@@ -183,7 +183,7 @@ The controller handles topic generation, metadata, and completion tracking autom
 Import additional helpers as needed:
 
 - `AudioController` – high-level audio playback/recording utilities for non-React environments.
-- `Translator` – encapsulated i18next integration for manual translation flows.
+- `Translator` – encapsulated i18next integration for manual translation flows, with AI fallback for non-key strings.
 - `difficultyConverter` – convert between textual and numeric difficulty levels.
 - Type definitions for AI messages, shared content, triggers, accomplishments, and more.
 

package/dist/controller/TranslationController.d.ts

@@ -1,4 +1,7 @@
 import { ThirdPartyModule, TOptions } from 'i18next';
+import { ObjectRequest } from './ObjectController';
+import { AIModule } from '../plugin/module/AIModule';
+export type AIObjectGenerator = <T>(request: ObjectRequest) => Promise<T>;
 /**
  * Translator class for handling internationalization
  */
@@ -8,7 +11,10 @@ export declare class Translator {
     private initializationPromise;
     private i18n;
     private translationUrl;
-    constructor(initialLanguage: string, translationUrl: string);
+    private ai;
+    private aiTranslationCache;
+    private aiTranslationInFlight;
+    constructor(initialLanguage: string, translationUrl: string, ai: AIModule);
     /**
      * Initialize translator with user's language
      * @param userLanguage - Language code from user info
@@ -23,8 +29,8 @@ export declare class Translator {
      */
     private fetchTranslations;
     /**
-     * Get translation for a key
-     * @param key - Translation key
+     * Get translation for a key or freeform text. If the key is not a valid translation key, the freeform text is translated using AI and cached.
+     * @param key - Translation key or freeform text
      * @param options - Translation options
      * @returns Translated string
      */
@@ -37,4 +43,7 @@ export declare class Translator {
      * Check if translator is initialized
      */
     isReady(): boolean;
+    private isTranslationKey;
+    private translateFreeformText;
+    private fetchAiTranslation;
 }

package/dist/controller/TranslationController.js

@@ -12,11 +12,14 @@ import { createInstance } from 'i18next';
  * Translator class for handling internationalization
  */
 export class Translator {
-    constructor(initialLanguage, translationUrl) {
+    constructor(initialLanguage, translationUrl, ai) {
+        this.aiTranslationCache = new Map();
+        this.aiTranslationInFlight = new Set();
         this.currentLanguage = initialLanguage;
         this.initializationState = 'not-inited';
         this.initializationPromise = null;
         this.translationUrl = translationUrl;
+        this.ai = ai;
     }
     /**
      * Initialize translator with user's language
@@ -102,12 +105,15 @@ export class Translator {
         });
     }
     /**
-     * Get translation for a key
-     * @param key - Translation key
+     * Get translation for a key or freeform text. If the key is not a valid translation key, the freeform text is translated using AI and cached.
+     * @param key - Translation key or freeform text
      * @param options - Translation options
      * @returns Translated string
      */
     t(key, options) {
+        if (!this.isTranslationKey(key)) {
+            return this.translateFreeformText(key);
+        }
         if (!this.i18n) {
             throw new Error('Translator is not initialized');
         }
@@ -125,4 +131,45 @@ export class Translator {
     isReady() {
         return this.initializationState === 'finished';
     }
+    isTranslationKey(key) {
+        return /^[^\s.]+(\.[^\s.]+)+$/.test(key);
+    }
+    translateFreeformText(text) {
+        const cached = this.aiTranslationCache.get(text);
+        if (cached)
+            return cached;
+        if (!this.ai || this.aiTranslationInFlight.has(text)) {
+            return text;
+        }
+        this.aiTranslationInFlight.add(text);
+        void this.fetchAiTranslation(text).finally(() => {
+            this.aiTranslationInFlight.delete(text);
+        });
+        return text;
+    }
+    fetchAiTranslation(text) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                if (!this.ai)
+                    return;
+                const response = yield this.ai.getObject({
+                    behaviour: 'You are a translation engine. Return only the translated text.',
+                    instructions: `Translate the following text into ${this.currentLanguage}: ${text}`,
+                    tool: {
+                        translation: {
+                            type: 'string',
+                            description: `The translation of the input text into ${this.currentLanguage}.`,
+                        },
+                    },
+                });
+                const translation = response === null || response === void 0 ? void 0 : response.translation;
+                if (translation) {
+                    this.aiTranslationCache.set(text, translation);
+                }
+            }
+            catch (error) {
+                console.warn('Failed to translate freeform text:', { text, error });
+            }
+        });
+    }
 }

package/dist/plugin/RimoriClient.js

@@ -32,7 +32,7 @@ export class RimoriClient {
         this.ai = new AIModule(controller, info);
         this.event = new EventModule(info.pluginId);
         this.db = new DbModule(supabase, controller, info);
-        this.plugin = new PluginModule(supabase, controller, info);
+        this.plugin = new PluginModule(supabase, controller, info, this.ai);
         this.exercise = new ExerciseModule(supabase, controller, info, this.event);
         controller.onUpdate((updatedInfo) => {
             this.rimoriInfo = updatedInfo;

package/dist/plugin/module/PluginModule.d.ts

@@ -3,6 +3,7 @@ import { RimoriCommunicationHandler, RimoriInfo } from '../CommunicationHandler'
 import { Translator } from '../../controller/TranslationController';
 import { ActivePlugin, Plugin } from '../../fromRimori/PluginTypes';
 import { SupabaseClient } from '../CommunicationHandler';
+import { AIModule } from './AIModule';
 export type Theme = 'light' | 'dark' | 'system';
 export type ApplicationMode = 'main' | 'sidebar' | 'settings';
 /**
@@ -22,7 +23,7 @@ export declare class PluginModule {
     releaseChannel: string;
     applicationMode: ApplicationMode;
     theme: Theme;
-    constructor(supabase: SupabaseClient, communicationHandler: RimoriCommunicationHandler, info: RimoriInfo);
+    constructor(supabase: SupabaseClient, communicationHandler: RimoriCommunicationHandler, info: RimoriInfo, ai: AIModule);
     /**
      * Set the settings for the plugin.
      * @param settings The settings to set.

package/dist/plugin/module/PluginModule.js

@@ -14,14 +14,14 @@ import { Translator } from '../../controller/TranslationController';
  * Provides access to plugin settings, user info, and plugin information.
  */
 export class PluginModule {
-    constructor(supabase, communicationHandler, info) {
+    constructor(supabase, communicationHandler, info, ai) {
         this.rimoriInfo = info;
         this.communicationHandler = communicationHandler;
         this.pluginId = info.pluginId;
         this.releaseChannel = info.releaseChannel;
         this.settingsController = new SettingsController(supabase, info.pluginId, info.guild);
         const currentPlugin = info.installedPlugins.find((plugin) => plugin.id === info.pluginId);
-        this.translator = new Translator(info.interfaceLanguage, (currentPlugin === null || currentPlugin === void 0 ? void 0 : currentPlugin.endpoint) || '');
+        this.translator = new Translator(info.interfaceLanguage, (currentPlugin === null || currentPlugin === void 0 ? void 0 : currentPlugin.endpoint) || '', ai);
         this.communicationHandler.onUpdate((updatedInfo) => (this.rimoriInfo = updatedInfo));
         this.applicationMode = this.communicationHandler.getQueryParam('applicationMode');
         this.theme = this.communicationHandler.getQueryParam('rm_theme') || 'light';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rimori/client",
-  "version": "2.5.8-next.2",
+  "version": "2.5.8-next.3",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "repository": {