@rimori/client 2.5.19 → 2.5.20-next.1

package/dist/controller/TranslationController.js

@@ -49,6 +49,8 @@ export class Translator {
                         },
                         debug: false,
                         parseMissingKeyHandler: (key, defaultValue) => {
+                            if (!key.trim())
+                                return '';
                             if (this.isTranslationKey(key)) {
                                 console.warn(`Translation key not found: ${key}`);
                                 return defaultValue !== null && defaultValue !== void 0 ? defaultValue : '';

package/dist/fromRimori/EventBus.d.ts

@@ -13,6 +13,8 @@ export interface EventBusMessage<T = EventPayload> {
     topic: string;
     data: T;
     debug: boolean;
+    /** Session token inherited from the calling plugin, used to attribute AI calls to the originating exercise session. */
+    ai_session_token?: string;
 }
 export type EventHandler<T = EventPayload> = (event: EventBusMessage<T>) => void | Promise<void>;
 export interface EventListener {
@@ -56,7 +58,7 @@ export declare class EventBusHandler {
      * - pl1234.card.delete
      * - pl1234.card.triggerBackup
      */
-    emit<T = EventPayload>(sender: string, topic: string, data?: T, eventId?: number): void;
+    emit<T = EventPayload>(sender: string, topic: string, data?: T, eventId?: number, aiSessionToken?: string): void;
     private emitInternal;
     /**
      * Subscribes to an event on the event bus.
@@ -93,7 +95,7 @@ export declare class EventBusHandler {
      * @param data - The data of the event.
      * @returns A promise that resolves to the event.
      */
-    request<T = EventPayload>(sender: string, topic: string, data?: EventPayload): Promise<EventBusMessage<T>>;
+    request<T = EventPayload>(sender: string, topic: string, data?: EventPayload, aiSessionToken?: string): Promise<EventBusMessage<T>>;
     /**
      * Gets the matching handlers for an event.
      * @param topic - The topic of the event.

package/dist/fromRimori/EventBus.js

@@ -63,7 +63,7 @@ export class EventBusHandler {
         this.generatedIds.set(id, now);
         return id;
     }
-    createEvent(sender, topic, data, eventId) {
+    createEvent(sender, topic, data, eventId, aiSessionToken) {
         const generatedEventId = eventId || this.generateUniqueId();
         return {
             eventId: generatedEventId,
@@ -72,6 +72,7 @@ export class EventBusHandler {
             topic,
             data,
             debug: this.debugEnabled,
+            ai_session_token: aiSessionToken,
         };
     }
     /**
@@ -92,15 +93,15 @@ export class EventBusHandler {
      * - pl1234.card.delete
      * - pl1234.card.triggerBackup
      */
-    emit(sender, topic, data, eventId) {
-        this.emitInternal(sender, topic, data || {}, eventId);
+    emit(sender, topic, data, eventId, aiSessionToken) {
+        this.emitInternal(sender, topic, data || {}, eventId, false, aiSessionToken);
     }
-    emitInternal(sender, topic, data, eventId, skipResponseTrigger = false) {
+    emitInternal(sender, topic, data, eventId, skipResponseTrigger = false, aiSessionToken) {
         if (!this.validateTopic(topic)) {
             this.logAndThrowError(false, `Invalid topic: ` + topic);
             return;
         }
-        const event = this.createEvent(sender, topic, data, eventId);
+        const event = this.createEvent(sender, topic, data, eventId, aiSessionToken);
         const handlers = this.getMatchingHandlers(event.topic);
         handlers.forEach((handler) => {
             if (handler.ignoreSender && handler.ignoreSender.includes(sender)) {
@@ -245,16 +246,16 @@ export class EventBusHandler {
      * @param data - The data of the event.
      * @returns A promise that resolves to the event.
      */
-    request(sender, topic, data) {
+    request(sender, topic, data, aiSessionToken) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!this.validateTopic(topic)) {
                 this.logAndThrowError(true, `Invalid topic: ` + topic);
             }
-            const event = this.createEvent(sender, topic, data || {});
+            const event = this.createEvent(sender, topic, data || {}, undefined, aiSessionToken);
             this.logIfDebug(`Requesting data from ` + topic, { event });
             return new Promise((resolve) => {
                 this.responseResolvers.set(event.eventId, (value) => resolve(value));
-                this.emitInternal(sender, topic, data || {}, event.eventId, true);
+                this.emitInternal(sender, topic, data || {}, event.eventId, true, aiSessionToken);
             });
         });
     }

package/dist/index.d.ts

@@ -15,7 +15,8 @@ export { Translator } from './controller/TranslationController';
 export type { TriggerAction } from './plugin/module/ExerciseModule';
 export type { Message, ToolInvocation } from './plugin/module/AIModule';
 export type { Theme, ApplicationMode } from './plugin/module/PluginModule';
-export type { UserInfo, Language, UserRole, ExplicitUndefined, BasePluginSettings } from './plugin/module/PluginModule';
+export type { UserInfo, Language, UserRole, SubscriptionTier, ExplicitUndefined, BasePluginSettings } from './plugin/module/PluginModule';
+export { TIER_ORDER, ROLE_ORDER } from './plugin/module/PluginModule';
 export type { SharedContent, BasicSharedContent, ContentStatus } from './plugin/module/SharedContentController';
 export type { MacroAccomplishmentPayload, MicroAccomplishmentPayload } from './controller/AccomplishmentController';
 export { StorageModule } from './plugin/module/StorageModule';

package/dist/index.js

@@ -10,4 +10,5 @@ export * from './plugin/CommunicationHandler';
 export { setupWorker } from './worker/WorkerSetup';
 export { AudioController } from './controller/AudioController';
 export { Translator } from './controller/TranslationController';
+export { TIER_ORDER, ROLE_ORDER } from './plugin/module/PluginModule';
 export { StorageModule } from './plugin/module/StorageModule';

package/dist/plugin/CommunicationHandler.js

@@ -58,9 +58,9 @@ export class RimoriCommunicationHandler {
                     EventBus.emit(this.pluginId, 'error', { error }, eventId);
                 }
                 else if (event) {
-                    const { topic, sender, data: eventData, eventId } = event;
+                    const { topic, sender, data: eventData, eventId, ai_session_token } = event;
                     if (sender !== this.pluginId) {
-                        EventBus.emit(sender, topic, eventData, eventId);
+                        EventBus.emit(sender, topic, eventData, eventId, ai_session_token);
                     }
                     else {
                         console.log('[PluginController] event from self', event);

package/dist/plugin/TTS/MessageSender.d.ts

@@ -1,4 +1,4 @@
-type VoiceBackend = (text: string, voice?: string, speed?: number, language?: string, cache?: boolean) => Promise<Blob>;
+type VoiceBackend = (text: string, voice?: string, speed?: number, language?: string, cache?: boolean, instructions?: string) => Promise<Blob>;
 export declare class MessageSender {
     private player;
     private fetchedSentences;
@@ -6,9 +6,12 @@ export declare class MessageSender {
     private voice;
     private voiceBackend;
     private cache;
+    private voiceSpeed;
+    private instructions;
     constructor(voiceBackend: VoiceBackend, voice: string, cache?: boolean);
     private getCompletedSentences;
     handleNewText(currentText: string | undefined, isLoading: boolean): Promise<void>;
+    setInstructions(instructions: string | undefined): void;
     private generateSpeech;
     play(): void;
     stop(): void;
@@ -17,5 +20,6 @@ export declare class MessageSender {
     setVolume(volume: number): void;
     setOnLoudnessChange(callback: (value: number) => void): void;
     setOnEndOfSpeech(callback: () => void): void;
+    setVoiceSpeed(speed: number): void;
 }
 export {};

package/dist/plugin/TTS/MessageSender.js

@@ -13,6 +13,7 @@ export class MessageSender {
         this.player = new ChunkedAudioPlayer();
         this.fetchedSentences = new Set();
         this.lastLoading = false;
+        this.voiceSpeed = 1;
         if ((voice === null || voice === void 0 ? void 0 : voice.split('_').length) !== 2) {
             throw new Error("Invalid voice id format '" + voice + "'. Voice id needs to look like <provider>_<voice_id>");
         }
@@ -61,9 +62,12 @@ export class MessageSender {
             }
         });
     }
+    setInstructions(instructions) {
+        this.instructions = instructions;
+    }
     generateSpeech(sentence) {
         return __awaiter(this, void 0, void 0, function* () {
-            const blob = yield this.voiceBackend(sentence, this.voice, 1.0, undefined, this.cache);
+            const blob = yield this.voiceBackend(sentence, this.voice, this.voiceSpeed, undefined, this.cache, this.instructions);
             return yield blob.arrayBuffer();
         });
     }
@@ -92,4 +96,7 @@ export class MessageSender {
     setOnEndOfSpeech(callback) {
         this.player.setOnEndOfSpeech(callback);
     }
+    setVoiceSpeed(speed) {
+        this.voiceSpeed = speed;
+    }
 }

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

@@ -61,17 +61,20 @@ export declare class AIModule {
     private sessionTokenId;
     private onRateLimitedCb?;
     constructor(backendUrl: string, getToken: () => string);
-    /** Returns the current exercise session token ID (null if no active session). */
-    getSessionTokenId(): string | null;
-    /** Sets the session token ID (used by workers inheriting a session from the plugin). */
-    setSessionToken(id: string): void;
-    /** Clears the stored session token (called after macro accomplishment). */
-    clearSessionToken(): void;
-    /**
-     * Ensures a session token exists, requesting one from the backend if needed.
-     * Mirrors the lazy-issuance pattern used by the AI/LLM endpoint.
-     */
-    private ensureSessionToken;
+    /** Exercise session management. */
+    readonly session: {
+        /** Returns the current exercise session token ID (null if no active session). */
+        get: () => string | null;
+        /** Sets the session token ID. */
+        set: (id: string) => void;
+        /** Clears the stored session token. */
+        clear: () => void;
+        /**
+         * Ensures a session token exists, creating one from the backend if needed.
+         * Mirrors the lazy-issuance pattern used by the AI/LLM endpoint.
+         */
+        ensure: () => Promise<void>;
+    };
     /** Registers a callback invoked whenever a 429 rate-limit response is received. */
     setOnRateLimited(cb: (exercisesRemaining: number) => void): void;
     /**
@@ -101,7 +104,7 @@ export declare class AIModule {
      * @param cache Whether to cache the result (default: false).
      * @returns The generated audio as a Blob.
      */
-    getVoice(text: string, voice?: string, speed?: number, language?: string, cache?: boolean): Promise<Blob>;
+    getVoice(text: string, voice?: string, speed?: number, language?: string, cache?: boolean, instructions?: string): Promise<Blob>;
     /**
      * Convert voice audio to text using AI.
      * @param file The audio file to convert.

package/dist/plugin/module/AIModule.js

@@ -14,47 +14,46 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 export class AIModule {
     constructor(backendUrl, getToken) {
         this.sessionTokenId = null;
+        /** Exercise session management. */
+        this.session = {
+            /** Returns the current exercise session token ID (null if no active session). */
+            get: () => this.sessionTokenId,
+            /** Sets the session token ID. */
+            set: (id) => {
+                this.sessionTokenId = id;
+            },
+            /** Clears the stored session token. */
+            clear: () => {
+                this.sessionTokenId = null;
+            },
+            /**
+             * Ensures a session token exists, creating one from the backend if needed.
+             * Mirrors the lazy-issuance pattern used by the AI/LLM endpoint.
+             */
+            ensure: () => __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                if (this.sessionTokenId)
+                    return;
+                const response = yield fetch(`${this.backendUrl}/ai/session`, {
+                    method: 'POST',
+                    headers: { Authorization: `Bearer ${this.getToken()}` },
+                });
+                if (!response.ok) {
+                    if (response.status === 429) {
+                        const body = yield response.json().catch(() => ({}));
+                        const remaining = (_a = body.exercises_remaining) !== null && _a !== void 0 ? _a : 0;
+                        (_b = this.onRateLimitedCb) === null || _b === void 0 ? void 0 : _b.call(this, remaining);
+                        throw new Error(`Rate limit exceeded: ${(_c = body.error) !== null && _c !== void 0 ? _c : 'Daily exercise limit reached'}. exercises_remaining: ${remaining}`);
+                    }
+                    throw new Error(`Failed to create session: ${response.status} ${response.statusText}`);
+                }
+                const { session_token_id } = yield response.json();
+                this.sessionTokenId = session_token_id;
+            }),
+        };
         this.backendUrl = backendUrl;
         this.getToken = getToken;
     }
-    /** Returns the current exercise session token ID (null if no active session). */
-    getSessionTokenId() {
-        return this.sessionTokenId;
-    }
-    /** Sets the session token ID (used by workers inheriting a session from the plugin). */
-    setSessionToken(id) {
-        this.sessionTokenId = id;
-    }
-    /** Clears the stored session token (called after macro accomplishment). */
-    clearSessionToken() {
-        this.sessionTokenId = null;
-    }
-    /**
-     * Ensures a session token exists, requesting one from the backend if needed.
-     * Mirrors the lazy-issuance pattern used by the AI/LLM endpoint.
-     */
-    ensureSessionToken() {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c;
-            if (this.sessionTokenId)
-                return;
-            const response = yield fetch(`${this.backendUrl}/ai/session`, {
-                method: 'POST',
-                headers: { Authorization: `Bearer ${this.getToken()}` },
-            });
-            if (!response.ok) {
-                if (response.status === 429) {
-                    const body = yield response.json().catch(() => ({}));
-                    const remaining = (_a = body.exercises_remaining) !== null && _a !== void 0 ? _a : 0;
-                    (_b = this.onRateLimitedCb) === null || _b === void 0 ? void 0 : _b.call(this, remaining);
-                    throw new Error(`Rate limit exceeded: ${(_c = body.error) !== null && _c !== void 0 ? _c : 'Daily exercise limit reached'}. exercises_remaining: ${remaining}`);
-                }
-                throw new Error(`Failed to create session: ${response.status} ${response.statusText}`);
-            }
-            const { session_token_id } = yield response.json();
-            this.sessionTokenId = session_token_id;
-        });
-    }
     /** Registers a callback invoked whenever a 429 rate-limit response is received. */
     setOnRateLimited(cb) {
         this.onRateLimitedCb = cb;
@@ -121,16 +120,16 @@ export class AIModule {
      * @returns The generated audio as a Blob.
      */
     getVoice(text_1) {
-        return __awaiter(this, arguments, void 0, function* (text, voice = 'alloy', speed = 1, language, cache = false) {
+        return __awaiter(this, arguments, void 0, function* (text, voice = 'alloy', speed = 1, language, cache = false, instructions) {
             var _a;
-            yield this.ensureSessionToken();
+            yield this.session.ensure();
             return yield fetch(`${this.backendUrl}/voice/tts`, {
                 method: 'POST',
                 headers: {
                     'Content-Type': 'application/json',
                     Authorization: `Bearer ${this.getToken()}`,
                 },
-                body: JSON.stringify({ input: text, voice, speed, language, cache, session_token_id: (_a = this.sessionTokenId) !== null && _a !== void 0 ? _a : undefined }),
+                body: JSON.stringify({ input: text, voice, speed, language, cache, instructions, session_token_id: (_a = this.sessionTokenId) !== null && _a !== void 0 ? _a : undefined }),
             }).then((r) => r.blob());
         });
     }
@@ -142,7 +141,7 @@ export class AIModule {
      */
     getTextFromVoice(file, language) {
         return __awaiter(this, void 0, void 0, function* () {
-            yield this.ensureSessionToken();
+            yield this.session.ensure();
             const formData = new FormData();
             formData.append('file', file);
             if (language) {
@@ -222,7 +221,7 @@ export class AIModule {
     }
     streamObject(params) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d;
+            var _a, _b, _c, _d, _e;
             const { messages, responseSchema, onResult = () => null, cache = false, tools = [], model = undefined, knowledgeId, } = params;
             const chatMessages = messages.map((message, index) => (Object.assign(Object.assign({}, message), { id: `${index + 1}` })));
             const response = yield fetch(`${this.backendUrl}/ai/llm`, {
@@ -254,6 +253,18 @@ export class AIModule {
             const reader = response.body.getReader();
             const decoder = new TextDecoder('utf-8');
             let currentObject = {};
+            // Buffer for SSE lines that are split across network chunks.
+            // TCP/IP does not guarantee that each `read()` call delivers a complete
+            // logical line. For example, the `token:` line carrying the session token
+            // may arrive as two separate chunks:
+            //   chunk 1 → `token: {"token_id":`
+            //   chunk 2 → `"abc123"}\n`
+            // Without buffering, `JSON.parse` would throw on the partial line and the
+            // session token would be silently discarded, causing the next LLM call to
+            // start without a session (triggering an unnecessary extra round-trip via
+            // `session.ensure()`). By keeping the incomplete tail in `lineBuffer` and
+            // prepending it to the next chunk we always process whole lines.
+            let lineBuffer = '';
             let isLoading = true;
             while (isLoading) {
                 //wait 50ms to not overload the CPU
@@ -268,7 +279,13 @@ export class AIModule {
                 if (!value)
                     continue;
                 const chunk = decoder.decode(value, { stream: true });
-                const lines = chunk.split('\n').filter((line) => line.trim());
+                // Prepend any incomplete line left over from the previous chunk, then
+                // split on newlines. `parts.pop()` removes (and saves) the last element
+                // which may be an incomplete line if the chunk did not end with '\n'.
+                const combined = lineBuffer + chunk;
+                const parts = combined.split('\n');
+                lineBuffer = (_e = parts.pop()) !== null && _e !== void 0 ? _e : '';
+                const lines = parts.filter((line) => line.trim());
                 for (const line of lines) {
                     // Handle token: line (session token issued by backend on first AI call)
                     if (line.startsWith('token:')) {
@@ -278,7 +295,7 @@ export class AIModule {
                                 this.sessionTokenId = tokenData.token_id;
                             }
                         }
-                        catch (_e) {
+                        catch (_f) {
                             console.error('Failed to parse token: line', line);
                         }
                         continue;

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

@@ -1,7 +1,25 @@
-import { PostgrestClientOptions, PostgrestQueryBuilder } from '@supabase/postgrest-js';
+import { PostgrestFilterBuilder, PostgrestQueryBuilder } from '@supabase/postgrest-js';
 import { SupabaseClient } from '../CommunicationHandler';
 import { RimoriCommunicationHandler, RimoriInfo } from '../CommunicationHandler';
-import { GenericSchema, GenericTable } from '@supabase/postgrest-js/dist/cjs/types/common/common';
+/**
+ * Wraps PostgrestQueryBuilder and overrides select() to always return Row[].
+ *
+ * postgrest-js's GetResult type can only infer row types from string literals.
+ * Dynamic select strings (e.g. `'col:' + getTableName('other') + '(id)'`) produce
+ * GenericStringError. This wrapper forces select() to return Row[] regardless of
+ * the query string, so callers using from<Row>() always get typed results.
+ */
+type DbQueryBuilder<Row extends Record<string, unknown>> = Omit<PostgrestQueryBuilder<any, any, {
+    Row: Row;
+    Insert: Partial<Row>;
+    Update: Partial<Row>;
+    Relationships: [];
+}, string>, 'select'> & {
+    select(columns?: string, options?: {
+        head?: boolean;
+        count?: 'exact' | 'planned' | 'estimated';
+    }): PostgrestFilterBuilder<any, any, Row, Row[], string, any, 'GET'>;
+};
 /**
  * Database module for plugin database operations.
  * Provides access to plugin tables with automatic prefixing and schema management.
@@ -16,10 +34,16 @@ export declare class DbModule {
      * Query a database table.
      * Global tables (starting with 'global_') remain in public schema.
      * Plugin tables use the schema provided by rimori-main (plugins or plugins_alpha).
+     *
+     * The generic parameter `Row` lets callers opt-in to typed row access:
+     *   client.db.from<{ id: string; name: string }>('decks')
+     * When omitted, row fields are inferred from the select() string (each field typed as `any`).
+     * Works with both literal and dynamic select strings.
+     *
      * @param relation The table name (without prefix for plugin tables, with 'global_' for global tables).
      * @returns A Postgrest query builder for the table.
      */
-    from<ViewName extends string & keyof GenericSchema['Views'], View extends GenericSchema['Views'][ViewName]>(relation: string): PostgrestQueryBuilder<PostgrestClientOptions, GenericSchema, GenericTable, ViewName, View>;
+    from<Row extends Record<string, unknown> = any>(relation: string): DbQueryBuilder<Row>;
     /**
      * Get the table name for a given plugin table.
      * Internally all tables are prefixed with the plugin id. This function is used to get the correct table name for a given public table.
@@ -28,3 +52,4 @@ export declare class DbModule {
      */
     getTableName(table: string): string;
 }
+export {};

package/dist/plugin/module/DbModule.js

@@ -18,19 +18,20 @@ export class DbModule {
      * Query a database table.
      * Global tables (starting with 'global_') remain in public schema.
      * Plugin tables use the schema provided by rimori-main (plugins or plugins_alpha).
+     *
+     * The generic parameter `Row` lets callers opt-in to typed row access:
+     *   client.db.from<{ id: string; name: string }>('decks')
+     * When omitted, row fields are inferred from the select() string (each field typed as `any`).
+     * Works with both literal and dynamic select strings.
+     *
      * @param relation The table name (without prefix for plugin tables, with 'global_' for global tables).
      * @returns A Postgrest query builder for the table.
      */
     from(relation) {
         const tableName = this.getTableName(relation);
-        // Use the schema determined by rimori-main based on release channel
-        // Global tables (starting with 'global_') remain in public schema
-        // Plugin tables use the schema provided by rimori-main (plugins or plugins_alpha)
         if (relation.startsWith('global_')) {
-            // Global tables stay in public schema
             return this.supabase.schema('public').from(tableName);
         }
-        // Plugin tables go to the schema provided by rimori-main
         return this.supabase.schema(this.rimoriInfo.dbSchema).from(tableName);
     }
     /**

package/dist/plugin/module/EventModule.js

@@ -63,8 +63,13 @@ export class EventModule {
      * @returns The response from the event.
      */
     request(topic, data) {
-        const globalTopic = this.getGlobalEventTopic(topic);
-        return EventBus.request(this.pluginId, globalTopic, data);
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const globalTopic = this.getGlobalEventTopic(topic);
+            yield this.aiModule.session.ensure();
+            const sessionToken = (_a = this.aiModule.session.get()) !== null && _a !== void 0 ? _a : undefined;
+            return EventBus.request(this.pluginId, globalTopic, data, sessionToken);
+        });
     }
     /**
      * Subscribe to an event.
@@ -74,7 +79,12 @@ export class EventModule {
      */
     on(topic, callback) {
         const topics = Array.isArray(topic) ? topic : [topic];
-        return EventBus.on(topics.map((t) => this.getGlobalEventTopic(t)), callback);
+        return EventBus.on(topics.map((t) => this.getGlobalEventTopic(t)), (event) => {
+            if (event.ai_session_token && !this.aiModule.session.get()) {
+                this.aiModule.session.set(event.ai_session_token);
+            }
+            callback(event);
+        });
     }
     /**
      * Subscribe to an event once.
@@ -91,7 +101,30 @@ export class EventModule {
      */
     respond(topic, data) {
         const topics = Array.isArray(topic) ? topic : [topic];
-        EventBus.respond(this.pluginId, topics.map((t) => this.getGlobalEventTopic(t)), data);
+        let wrappedData = data;
+        if (typeof data === 'function') {
+            wrappedData = (event) => __awaiter(this, void 0, void 0, function* () {
+                const previousToken = this.aiModule.session.get();
+                if (event.ai_session_token) {
+                    this.aiModule.session.set(event.ai_session_token);
+                }
+                try {
+                    console.log('responding to event', event);
+                    return yield data(event);
+                }
+                finally {
+                    if (event.ai_session_token) {
+                        if (previousToken) {
+                            this.aiModule.session.set(previousToken);
+                        }
+                        else {
+                            this.aiModule.session.clear();
+                        }
+                    }
+                }
+            });
+        }
+        EventBus.respond(this.pluginId, topics.map((t) => this.getGlobalEventTopic(t)), wrappedData);
     }
     /**
      * Emit an accomplishment.
@@ -100,7 +133,7 @@ export class EventModule {
     emitAccomplishment(payload) {
         return __awaiter(this, void 0, void 0, function* () {
             if (payload.type === 'macro') {
-                const sessionId = this.aiModule.getSessionTokenId();
+                const sessionId = this.aiModule.session.get();
                 if (sessionId) {
                     try {
                         yield fetch(`${this.backendUrl}/ai/session/${sessionId}/complete`, {
@@ -111,7 +144,7 @@ export class EventModule {
                     catch (_a) {
                         // non-fatal — session will expire naturally
                     }
-                    this.aiModule.clearSessionToken();
+                    this.aiModule.session.clear();
                 }
             }
             this.accomplishmentController.emitAccomplishment(payload);

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

@@ -105,6 +105,11 @@ export interface Language {
     uppercase: string;
 }
 export type UserRole = 'user' | 'plugin_moderator' | 'lang_moderator' | 'admin';
+export type SubscriptionTier = 'anonymous' | 'free' | 'standard' | 'premium' | 'early_access';
+/** Ordered tiers from lowest to highest access level */
+export declare const TIER_ORDER: SubscriptionTier[];
+/** Ordered roles from lowest to highest access level */
+export declare const ROLE_ORDER: UserRole[];
 export declare const LEARNING_REASONS: readonly ["work", "partner", "friends", "study", "living", "culture", "growth", "citizenship", "other"];
 export type LearningReason = (typeof LEARNING_REASONS)[number];
 export type ExplicitUndefined<T> = {
@@ -161,4 +166,16 @@ export interface UserInfo {
      * The user's role: 'user', 'plugin_moderator', 'lang_moderator', or 'admin'
      */
     user_role: UserRole;
+    /**
+     * The user's subscription tier. Higher tiers include all privileges of lower tiers.
+     * Order (ascending): anonymous < free < standard < premium < early_access
+     */
+    subscription_tier: SubscriptionTier;
+    /**
+     * Regional dialect name for the user's target city (e.g. "Skånska", "Göteborgska").
+     * Only set when: subscription_tier >= premium AND skill_level_listening >= B1
+     *                AND dialect_enabled = true AND city has a dialect in DB.
+     * Undefined otherwise. Plugins decide how to use this on a per-feature basis.
+     */
+    dialect?: string;
 }

package/dist/plugin/module/PluginModule.js

@@ -178,6 +178,10 @@ export class PluginModule {
         });
     }
 }
+/** Ordered tiers from lowest to highest access level */
+export const TIER_ORDER = ['anonymous', 'free', 'standard', 'premium', 'early_access'];
+/** Ordered roles from lowest to highest access level */
+export const ROLE_ORDER = ['user', 'plugin_moderator', 'lang_moderator', 'admin'];
 export const LEARNING_REASONS = [
     'work',
     'partner',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rimori/client",
-  "version": "2.5.19",
+  "version": "2.5.20-next.1",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "repository": {
@@ -36,9 +36,9 @@
     "format": "prettier --write ."
   },
   "dependencies": {
-    "@supabase/postgrest-js": "^2.87.1",
-    "dotenv": "16.5.0",
-    "i18next": "^25.6.0"
+    "@supabase/postgrest-js": "^2.98.0",
+    "dotenv": "^16.5.0",
+    "i18next": "^25.8.14"
   },
   "devDependencies": {
     "@eslint/js": "^9.37.0",