@rimori/playwright-testing 0.2.3 → 0.2.4-next.0

package/dist/core/MessageChannelSimulator.d.ts

@@ -1,79 +1,10 @@
 import type { Page } from '@playwright/test';
-type Language = {
-    code: string;
-    name: string;
-    native: string;
-    capitalized: string;
-    uppercase: string;
-};
-type StudyBuddy = {
-    id: string;
-    name: string;
-    description: string;
-    avatarUrl: string;
-    voiceId: string;
-    aiPersonality: string;
-};
-export type UserInfo = {
-    mother_tongue: Language;
-    target_language: Language;
-    skill_level_reading: string;
-    skill_level_writing: string;
-    skill_level_grammar: string;
-    skill_level_speaking: string;
-    skill_level_listening: string;
-    skill_level_understanding: string;
-    goal_longterm: string;
-    goal_weekly: string;
-    study_buddy: StudyBuddy;
-    story_genre: string;
-    study_duration: number;
-    motivation_type: string;
-    onboarding_completed: boolean;
-    context_menu_on_select: boolean;
-    user_name?: string;
-    target_country: string;
-    target_city?: string;
-};
-type RimoriGuild = {
-    id: string;
-    longTermGoalOverride: string;
-    allowUserPluginSettings: boolean;
-};
-type PluginInfo = {
-    id: string;
-    title: string;
-    description: string;
-    logo: string;
-    url: string;
-};
-type RimoriInfo = {
-    url: string;
-    key: string;
-    backendUrl: string;
-    token: string;
-    expiration: Date;
-    tablePrefix: string;
-    pluginId: string;
-    guild: RimoriGuild;
-    installedPlugins: PluginInfo[];
-    profile: UserInfo;
-    mainPanelPlugin?: PluginInfo;
-    sidePanelPlugin?: PluginInfo;
-};
-type EventBusMessage = {
-    timestamp: string;
-    sender: string;
-    topic: string;
-    data: unknown;
-    debug: boolean;
-    eventId?: number;
-};
+import { UserInfo, RimoriInfo, EventBusMessage, EventPayload } from '@rimori/client';
 type MessageChannelSimulatorArgs = {
     page: Page;
     pluginId: string;
+    rimoriInfo: RimoriInfo;
     queryParams?: Record<string, string>;
-    rimoriInfo?: RimoriInfo;
 };
 type EventListener = (event: EventBusMessage) => void | Promise<void>;
 type AutoResponder = (event: EventBusMessage) => unknown | Promise<unknown>;
@@ -81,13 +12,10 @@ export declare class MessageChannelSimulator {
     private readonly page;
     private readonly pluginId;
     private readonly queryParams;
-    private readonly baseUserInfo;
-    private readonly providedInfo?;
+    private readonly rimoriInfo;
     private readonly listeners;
     private readonly autoResponders;
     private readonly pendingOutbound;
-    private currentUserInfo;
-    private currentRimoriInfo;
     private isReady;
     private instanceId;
     /**
@@ -107,7 +35,7 @@ export declare class MessageChannelSimulator {
     /**
      * Sends an event into the plugin as though the Rimori parent emitted it.
      */
-    emit(topic: string, data: unknown, sender?: string): Promise<void>;
+    emit(topic: string, data: EventPayload, sender?: string): Promise<void>;
     /**
      * Registers a handler for events emitted from the plugin.
      */
@@ -123,20 +51,17 @@ export declare class MessageChannelSimulator {
      */
     respondOnce(topic: string, responder: AutoResponder | unknown): () => void;
     /**
-     * Overrides the default profile returned by the auto responders.
+     * Overrides the user info.
      */
-    setUserInfo(overrides: Partial<UserInfo>): void;
-    getRimoriInfo(): RimoriInfo | null;
+    setUserInfo(userInfo: UserInfo): void;
+    getRimoriInfo(): RimoriInfo;
     private setupMessageChannel;
     private sendToPlugin;
     private flushPending;
     private handlePortMessage;
     private dispatchEvent;
     private maybeRespond;
-    private buildRimoriInfo;
-    private serializeRimoriInfo;
     private cloneUserInfo;
-    private mergeUserInfo;
     private registerAutoResponders;
     private cloneRimoriInfo;
 }

package/dist/core/MessageChannelSimulator.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MessageChannelSimulator = void 0;
 const node_crypto_1 = require("node:crypto");
-const default_user_info_1 = require("../fixtures/default-user-info");
 class MessageChannelSimulator {
     /**
      * Creates a simulator that mimics the Rimori host for plugin tests.
@@ -15,22 +14,19 @@ class MessageChannelSimulator {
         this.listeners = new Map();
         this.autoResponders = new Map();
         this.pendingOutbound = [];
-        this.currentRimoriInfo = null;
         this.isReady = false;
         this.instanceId = (0, node_crypto_1.randomUUID)();
         this.page = page;
         this.pluginId = pluginId;
         this.queryParams = queryParams ?? {};
-        this.baseUserInfo = this.cloneUserInfo(default_user_info_1.DEFAULT_USER_INFO);
-        this.currentUserInfo = this.cloneUserInfo(default_user_info_1.DEFAULT_USER_INFO);
-        this.providedInfo = rimoriInfo ? this.cloneRimoriInfo(rimoriInfo) : undefined;
+        this.rimoriInfo = this.cloneRimoriInfo(rimoriInfo);
         this.registerAutoResponders();
     }
     get defaultUserInfo() {
-        return this.cloneUserInfo(this.baseUserInfo);
+        return this.cloneUserInfo(this.rimoriInfo.profile);
     }
     get userInfo() {
-        return this.cloneUserInfo(this.currentUserInfo);
+        return this.cloneUserInfo(this.rimoriInfo.profile);
     }
     /**
      * Injects the handshake shims so the plugin talks to this simulator.
@@ -112,6 +108,7 @@ class MessageChannelSimulator {
         const message = {
             event: {
                 timestamp: new Date().toISOString(),
+                eventId: Math.floor(Math.random() * 1000000),
                 sender,
                 topic,
                 data,
@@ -176,25 +173,19 @@ class MessageChannelSimulator {
         };
     }
     /**
-     * Overrides the default profile returned by the auto responders.
+     * Overrides the user info.
      */
-    setUserInfo(overrides) {
-        this.currentUserInfo = this.mergeUserInfo(this.currentUserInfo, overrides);
-        if (this.currentRimoriInfo) {
-            this.currentRimoriInfo.profile = this.cloneUserInfo(this.currentUserInfo);
-        }
+    setUserInfo(userInfo) {
+        this.rimoriInfo.profile = userInfo;
     }
     getRimoriInfo() {
-        return this.currentRimoriInfo ? this.cloneRimoriInfo(this.currentRimoriInfo) : null;
+        return this.cloneRimoriInfo(this.rimoriInfo);
     }
     async setupMessageChannel() {
         if (this.isReady) {
             return;
         }
-        const rimoriInfo = this.buildRimoriInfo();
-        this.currentRimoriInfo = rimoriInfo;
-        const serialized = this.serializeRimoriInfo(rimoriInfo);
-        await this.page.evaluate(({ pluginId, queryParams, instanceId, rimoriInfo: info, }) => {
+        await this.page.evaluate(({ pluginId, queryParams, instanceId, rimoriInfo, }) => {
             const channel = new MessageChannel();
             channel.port1.onmessage = (event) => {
                 // @ts-expect-error binding injected via exposeBinding
@@ -209,10 +200,7 @@ class MessageChannelSimulator {
                     pluginId,
                     instanceId,
                     queryParams,
-                    rimoriInfo: {
-                        ...info,
-                        expiration: new Date(info.expiration),
-                    },
+                    rimoriInfo,
                 },
                 ports: [channel.port2],
             });
@@ -221,7 +209,7 @@ class MessageChannelSimulator {
             pluginId: this.pluginId,
             queryParams: this.queryParams,
             instanceId: this.instanceId,
-            rimoriInfo: serialized,
+            rimoriInfo: this.rimoriInfo,
         });
         this.isReady = true;
         await this.flushPending();
@@ -248,21 +236,38 @@ class MessageChannelSimulator {
             return;
         }
         if ('event' in payload && payload.event) {
-            console.log('[MessageChannelSimulator] handlePortMessage - received event:', payload.event.topic, 'from:', payload.event.sender);
+            // console.log(
+            //   '[MessageChannelSimulator] handlePortMessage - received event:',
+            //   payload.event.topic,
+            //   'from:',
+            //   payload.event.sender,
+            // );
             await this.dispatchEvent(payload.event);
             await this.maybeRespond(payload.event);
             return;
         }
     }
     async dispatchEvent(event) {
-        console.log('[MessageChannelSimulator] dispatchEvent - topic:', event.topic, 'sender:', event.sender, 'listeners:', this.listeners.has(event.topic) ? this.listeners.get(event.topic)?.size : 0);
+        // console.log(
+        //   '[MessageChannelSimulator] dispatchEvent - topic:',
+        //   event.topic,
+        //   'sender:',
+        //   event.sender,
+        //   'listeners:',
+        //   this.listeners.has(event.topic) ? this.listeners.get(event.topic)?.size : 0,
+        // );
         const handlers = this.listeners.get(event.topic);
         if (!handlers?.size) {
-            console.log('[MessageChannelSimulator] No handlers found for topic:', event.topic);
-            console.log('[MessageChannelSimulator] Available topics:', Array.from(this.listeners.keys()));
+            // Don't log an error if this is a request/response event with an auto-responder
+            // (auto-responders handle request/response patterns, not listeners)
+            const hasAutoResponder = event.eventId && this.autoResponders.has(event.topic);
+            if (!hasAutoResponder) {
+                console.log('[MessageChannelSimulator] No handlers found for topic:', event.topic);
+                console.log('[MessageChannelSimulator] Available topics:', Array.from(this.listeners.keys()));
+            }
             return;
         }
-        console.log('[MessageChannelSimulator] Calling', handlers.size, 'handler(s) for topic:', event.topic);
+        // console.log('[MessageChannelSimulator] Calling', handlers.size, 'handler(s) for topic:', event.topic);
         for (const handler of handlers) {
             await handler(event);
         }
@@ -285,90 +290,16 @@ class MessageChannelSimulator {
             },
         });
     }
-    buildRimoriInfo() {
-        if (this.providedInfo) {
-            const clone = this.cloneRimoriInfo(this.providedInfo);
-            clone.profile = this.cloneUserInfo(this.currentUserInfo);
-            clone.pluginId = this.pluginId;
-            clone.tablePrefix = clone.tablePrefix || `${this.pluginId}_`;
-            return clone;
-        }
-        return {
-            url: 'http://localhost:3500',
-            key: 'rimori-sdk-key',
-            backendUrl: 'http://localhost:3501',
-            token: 'rimori-token',
-            expiration: new Date(Date.now() + 60 * 60 * 1000),
-            tablePrefix: `${this.pluginId}_`,
-            pluginId: this.pluginId,
-            guild: {
-                id: 'guild-test',
-                longTermGoalOverride: '',
-                allowUserPluginSettings: true,
-            },
-            installedPlugins: [
-                {
-                    id: this.pluginId,
-                    title: 'Test Plugin',
-                    description: 'Playwright testing plugin',
-                    logo: '',
-                    url: 'https://plugins.rimori.localhost',
-                },
-            ],
-            profile: this.cloneUserInfo(this.currentUserInfo),
-        };
-    }
-    serializeRimoriInfo(info) {
-        return {
-            ...info,
-            expiration: info.expiration.toISOString(),
-        };
-    }
     cloneUserInfo(input) {
         return JSON.parse(JSON.stringify(input));
     }
-    mergeUserInfo(current, overrides) {
-        const clone = this.cloneUserInfo(current);
-        if (overrides.mother_tongue) {
-            clone.mother_tongue = {
-                ...clone.mother_tongue,
-                ...overrides.mother_tongue,
-            };
-        }
-        if (overrides.target_language) {
-            clone.target_language = {
-                ...clone.target_language,
-                ...overrides.target_language,
-            };
-        }
-        if (overrides.study_buddy) {
-            clone.study_buddy = {
-                ...clone.study_buddy,
-                ...overrides.study_buddy,
-            };
-        }
-        const { mother_tongue, target_language, study_buddy, ...rest } = overrides;
-        for (const [key, value] of Object.entries(rest)) {
-            if (value === undefined) {
-                continue;
-            }
-            clone[key] = value;
-        }
-        return clone;
-    }
     registerAutoResponders() {
-        this.autoResponders.set('global.supabase.requestAccess', () => this.buildRimoriInfo());
-        this.autoResponders.set('global.profile.requestUserInfo', () => this.cloneUserInfo(this.currentUserInfo));
-        this.autoResponders.set('global.profile.getUserInfo', () => this.cloneUserInfo(this.currentUserInfo));
+        this.autoResponders.set('global.supabase.requestAccess', () => this.cloneRimoriInfo(this.rimoriInfo));
+        this.autoResponders.set('global.profile.requestUserInfo', () => this.cloneUserInfo(this.rimoriInfo.profile));
+        this.autoResponders.set('global.profile.getUserInfo', () => this.cloneUserInfo(this.rimoriInfo.profile));
     }
     cloneRimoriInfo(info) {
-        return {
-            ...info,
-            expiration: new Date(info.expiration),
-            guild: { ...info.guild },
-            installedPlugins: info.installedPlugins.map((plugin) => ({ ...plugin })),
-            profile: this.cloneUserInfo(info.profile),
-        };
+        return JSON.parse(JSON.stringify(info));
     }
 }
 exports.MessageChannelSimulator = MessageChannelSimulator;

package/dist/core/RimoriTestEnvironment.d.ts

@@ -1,9 +1,13 @@
 import { Page, Request } from '@playwright/test';
 import { UserInfo } from '@rimori/client/dist/controller/SettingsController';
 import { MainPanelAction, Plugin } from '@rimori/client/dist/fromRimori/PluginTypes';
+import { PluginSettings } from './SettingsStateManager';
+import { EventPayload } from '@rimori/client/dist/fromRimori/EventBus';
 interface RimoriTestEnvironmentOptions {
     page: Page;
     pluginId: string;
+    pluginUrl: string;
+    settings?: PluginSettings;
     queryParams?: Record<string, string>;
     userInfo?: Record<string, unknown>;
     installedPlugins?: Plugin[];
@@ -40,9 +44,21 @@ export declare class RimoriTestEnvironment {
     private backendRoutes;
     private supabaseRoutes;
     private messageChannelSimulator;
+    private settingsManager;
     constructor(options: RimoriTestEnvironmentOptions);
     private interceptRoutes;
     setup(): Promise<void>;
+    private getRimoriInfo;
+    /**
+     * Sets up the plugin_settings routes to use the SettingsStateManager.
+     * GET returns current state, PATCH updates state, POST creates/updates state.
+     */
+    private setupSettingsRoutes;
+    /**
+     * Sets up default handlers for shared_content and shared_content_completed routes.
+     * These provide sensible defaults so tests don't need to mock every shared content call.
+     */
+    private setupSharedContentRoutes;
     /**
      * Formats text as SSE (Server-Sent Events) response.
      * Since Playwright's route.fulfill() requires complete body, we format as SSE without delays.
@@ -78,30 +94,31 @@ export declare class RimoriTestEnvironment {
     private addBackendRoute;
     readonly plugin: {
         /**
-         * Mocks PATCH request for updating plugin_settings.
-         * @param response - The response for PATCH. Defaults to empty array (no rows updated).
-         *                   Should return array with updated row(s) like [{ id: '...' }] if update succeeds.
+         * Manually set the settings state (useful for test setup).
+         * This directly modifies the internal settings state.
+         * @param settings - The settings to set, or null to clear settings
+         */
+        setSettings: (settings: PluginSettings | null) => void;
+        /**
+         * Get the current settings state (useful for assertions).
+         * @returns The current settings or null if no settings exist
+         */
+        getSettings: () => PluginSettings | null;
+        /**
+         * Override the GET handler for plugin_settings (rarely needed).
+         * By default, GET returns the current state from SettingsStateManager.
          */
-        mockSetSettings: (response?: unknown, options?: MockOptions) => void;
+        mockGetSettings: (settingsRow: PluginSettings | null, options?: MockOptions) => void;
         /**
-         * Mocks GET request for fetching plugin_settings.
-         * @param settingsRow - The full row object from plugin_settings table, or null if not found.
-         *                      Should include: { id, plugin_id, guild_id, settings, is_guild_setting, user_id }.
-         *                      If null, simulates no settings exist (triggers INSERT flow).
+         * Override the PATCH handler for plugin_settings (rarely needed).
+         * By default, PATCH updates the state in SettingsStateManager.
          */
-        mockGetSettings: (settingsRow: {
-            id?: string;
-            plugin_id?: string;
-            guild_id?: string;
-            settings?: Record<string, unknown>;
-            is_guild_setting?: boolean;
-            user_id?: string | null;
-        } | null, options?: MockOptions) => void;
+        mockSetSettings: (response: unknown, options?: MockOptions) => void;
         /**
-         * Mocks POST request for inserting plugin_settings.
-         * @param response - The response for POST. Defaults to success response with inserted row.
+         * Override the POST handler for plugin_settings (rarely needed).
+         * By default, POST inserts/updates the state in SettingsStateManager.
          */
-        mockInsertSettings: (response?: unknown, options?: MockOptions) => void;
+        mockInsertSettings: (response: unknown, options?: MockOptions) => void;
         mockGetUserInfo: (userInfo: Partial<UserInfo>, options?: MockOptions) => void;
         mockGetPluginInfo: (pluginInfo: Plugin, options?: MockOptions) => void;
     };
@@ -131,7 +148,7 @@ export declare class RimoriTestEnvironment {
          * `worker/listeners/decks.ts` or `worker/listeners/flascards.ts` – those run in a
          * separate process. This helper is intended for UI‑side events only.
          */
-        mockEmit: (topic: string, data: unknown, sender?: string) => Promise<void>;
+        mockEmit: (topic: string, data: EventPayload, sender?: string) => Promise<void>;
         /**
          * Registers a one-time auto-responder for request/response style events.
          *
@@ -272,14 +289,43 @@ export declare class RimoriTestEnvironment {
     };
     readonly community: {
         sharedContent: {
-            mockGet: () => void;
-            mockGetList: () => void;
-            mockGetNew: () => void;
-            mockCreate: () => void;
-            mockUpdate: () => void;
-            mockComplete: () => void;
-            mockUpdateState: () => void;
-            mockRemove: () => void;
+            /**
+             * Mock the shared_content GET endpoint for fetching a single item.
+             * Used by SharedContentController.getSharedContent()
+             */
+            mockGet: (value: unknown, options?: MockOptions) => void;
+            /**
+             * Mock the shared_content GET endpoint for fetching multiple items.
+             * Used by SharedContentController.getSharedContentList() and getCompletedTopics()
+             */
+            mockGetList: (value: unknown[], options?: MockOptions) => void;
+            /**
+             * Mock the shared_content POST endpoint for creating new content.
+             * Used by SharedContentController.createSharedContent() after AI generation.
+             * Note: getNewSharedContent() first calls ai.getObject() (mock via env.ai.mockGetObject),
+             * then calls createSharedContent() which hits this endpoint.
+             */
+            mockCreate: (value: unknown, options?: MockOptions) => void;
+            /**
+             * Mock the shared_content PATCH endpoint for updating content.
+             * Used by SharedContentController.updateSharedContent() and removeSharedContent() (soft delete)
+             */
+            mockUpdate: (value: unknown, options?: MockOptions) => void;
+            /**
+             * Mock the shared_content_completed POST endpoint (upsert).
+             * Used by SharedContentController.completeSharedContent() and updateSharedContentState()
+             */
+            mockComplete: (value?: unknown, options?: MockOptions) => void;
+            /**
+             * Mock the shared_content_completed POST endpoint for state updates.
+             * Alias for mockComplete since both use upsert via POST.
+             */
+            mockUpdateState: (value?: unknown, options?: MockOptions) => void;
+            /**
+             * Mock removing shared content (soft delete via PATCH).
+             * Alias for mockUpdate since removeSharedContent uses PATCH to set deleted_at.
+             */
+            mockRemove: (value: unknown, options?: MockOptions) => void;
         };
     };
     readonly exercise: {

package/dist/core/RimoriTestEnvironment.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.RimoriTestEnvironment = void 0;
 const default_user_info_1 = require("../fixtures/default-user-info");
 const MessageChannelSimulator_1 = require("./MessageChannelSimulator");
+const SettingsStateManager_1 = require("./SettingsStateManager");
 class RimoriTestEnvironment {
     constructor(options) {
         this.backendRoutes = {};
@@ -10,57 +11,45 @@ class RimoriTestEnvironment {
         this.messageChannelSimulator = null;
         this.plugin = {
             /**
-             * Mocks PATCH request for updating plugin_settings.
-             * @param response - The response for PATCH. Defaults to empty array (no rows updated).
-             *                   Should return array with updated row(s) like [{ id: '...' }] if update succeeds.
+             * Manually set the settings state (useful for test setup).
+             * This directly modifies the internal settings state.
+             * @param settings - The settings to set, or null to clear settings
              */
-            mockSetSettings: (response, options) => {
-                console.log('Mocking set settings for mockSetSettings', response, options);
-                console.warn('mockSetSettings is not tested');
-                // PATCH request returns array of updated rows
-                // Empty array means no rows matched (will trigger INSERT)
-                // Array with items means update succeeded
-                const defaultResponse = response ?? [];
-                this.addSupabaseRoute('plugin_settings', defaultResponse, { ...options, method: 'PATCH' });
+            setSettings: (settings) => {
+                this.settingsManager.setSettings(settings);
+            },
+            /**
+             * Get the current settings state (useful for assertions).
+             * @returns The current settings or null if no settings exist
+             */
+            getSettings: () => {
+                return this.settingsManager.getSettings();
             },
             /**
-             * Mocks GET request for fetching plugin_settings.
-             * @param settingsRow - The full row object from plugin_settings table, or null if not found.
-             *                      Should include: { id, plugin_id, guild_id, settings, is_guild_setting, user_id }.
-             *                      If null, simulates no settings exist (triggers INSERT flow).
+             * Override the GET handler for plugin_settings (rarely needed).
+             * By default, GET returns the current state from SettingsStateManager.
              */
             mockGetSettings: (settingsRow, options) => {
-                console.log('Mocking get settings for mockGetSettings', settingsRow, options);
-                console.warn('mockGetSettings is not tested');
-                // GET request returns the full row or null (from maybeSingle())
-                // null means no settings exist, which triggers setSettings() -> INSERT
-                this.addSupabaseRoute('plugin_settings', settingsRow, options);
+                this.addSupabaseRoute('plugin_settings', settingsRow, { ...options, method: 'GET' });
             },
             /**
-             * Mocks POST request for inserting plugin_settings.
-             * @param response - The response for POST. Defaults to success response with inserted row.
+             * Override the PATCH handler for plugin_settings (rarely needed).
+             * By default, PATCH updates the state in SettingsStateManager.
+             */
+            mockSetSettings: (response, options) => {
+                this.addSupabaseRoute('plugin_settings', response, { ...options, method: 'PATCH' });
+            },
+            /**
+             * Override the POST handler for plugin_settings (rarely needed).
+             * By default, POST inserts/updates the state in SettingsStateManager.
              */
             mockInsertSettings: (response, options) => {
-                console.log('Mocking insert settings for mockInsertSettings', response, options);
-                console.warn('mockInsertSettings is not tested');
-                // TODO this function should not exist and possibly be combined with the mockSetSettings function
-                // POST request returns the inserted row or success response
-                // Default to an object representing successful insert
-                const defaultResponse = response ?? {
-                    id: 'mock-settings-id',
-                    plugin_id: this.pluginId,
-                    guild_id: this.rimoriInfo.guild.id,
-                };
-                this.addSupabaseRoute('plugin_settings', defaultResponse, { ...options, method: 'POST' });
+                this.addSupabaseRoute('plugin_settings', response, { ...options, method: 'POST' });
             },
             mockGetUserInfo: (userInfo, options) => {
-                console.log('Mocking get user info for mockGetUserInfo', userInfo, options);
-                console.warn('mockGetUserInfo is not tested');
                 this.addSupabaseRoute('/user-info', { ...this.rimoriInfo.profile, ...userInfo }, { ...options, delay: 0 });
             },
             mockGetPluginInfo: (pluginInfo, options) => {
-                console.log('Mocking get plugin info for mockGetPluginInfo', pluginInfo, options);
-                console.warn('mockGetPluginInfo is not tested');
                 this.addSupabaseRoute('/plugin-info', pluginInfo, options);
             },
         };
@@ -81,7 +70,7 @@ class RimoriTestEnvironment {
              * @param options - Mock options including HTTP method (defaults to 'GET' if not specified)
              */
             mockFrom: (tableName, value, options) => {
-                console.log('Mocking db.from for table:', tableName, 'method:', options?.method ?? 'GET', value, options);
+                // console.log('Mocking db.from for table:', tableName, 'method:', options?.method ?? 'GET', value, options);
                 const fullTableName = `${this.pluginId}_${tableName}`;
                 this.addSupabaseRoute(fullTableName, value, options);
             },
@@ -222,21 +211,15 @@ class RimoriTestEnvironment {
              * @param options - Optional mock options.
              */
             mockGetSteamedText: (text, options) => {
-                console.log('Mocking get steamed text for mockGetSteamedText', text, options);
                 this.addBackendRoute('/ai/llm', text, { ...options, isStreaming: true });
             },
             mockGetVoice: (values, options) => {
-                console.log('Mocking get voice for mockGetVoice', values, options);
-                console.warn('mockGetVoice is not tested');
                 this.addBackendRoute('/voice/tts', values, options);
             },
             mockGetTextFromVoice: (text, options) => {
-                console.log('Mocking get text from voice for mockGetTextFromVoice', text, options);
-                console.warn('mockGetTextFromVoice is not tested');
                 this.addBackendRoute('/voice/stt', text, options);
             },
             mockGetObject: (value, options) => {
-                console.log('Mocking get object for mockGetObject', value, options);
                 this.addBackendRoute('/ai/llm-object', value, { ...options, method: 'POST' });
             },
         };
@@ -364,14 +347,57 @@ class RimoriTestEnvironment {
         };
         this.community = {
             sharedContent: {
-                mockGet: () => { },
-                mockGetList: () => { },
-                mockGetNew: () => { },
-                mockCreate: () => { },
-                mockUpdate: () => { },
-                mockComplete: () => { },
-                mockUpdateState: () => { },
-                mockRemove: () => { },
+                /**
+                 * Mock the shared_content GET endpoint for fetching a single item.
+                 * Used by SharedContentController.getSharedContent()
+                 */
+                mockGet: (value, options) => {
+                    this.addSupabaseRoute('shared_content', value, { ...options, method: 'GET' });
+                },
+                /**
+                 * Mock the shared_content GET endpoint for fetching multiple items.
+                 * Used by SharedContentController.getSharedContentList() and getCompletedTopics()
+                 */
+                mockGetList: (value, options) => {
+                    this.addSupabaseRoute('shared_content', value, { ...options, method: 'GET' });
+                },
+                /**
+                 * Mock the shared_content POST endpoint for creating new content.
+                 * Used by SharedContentController.createSharedContent() after AI generation.
+                 * Note: getNewSharedContent() first calls ai.getObject() (mock via env.ai.mockGetObject),
+                 * then calls createSharedContent() which hits this endpoint.
+                 */
+                mockCreate: (value, options) => {
+                    this.addSupabaseRoute('shared_content', value, { ...options, method: 'POST' });
+                },
+                /**
+                 * Mock the shared_content PATCH endpoint for updating content.
+                 * Used by SharedContentController.updateSharedContent() and removeSharedContent() (soft delete)
+                 */
+                mockUpdate: (value, options) => {
+                    this.addSupabaseRoute('shared_content', value, { ...options, method: 'PATCH' });
+                },
+                /**
+                 * Mock the shared_content_completed POST endpoint (upsert).
+                 * Used by SharedContentController.completeSharedContent() and updateSharedContentState()
+                 */
+                mockComplete: (value = {}, options) => {
+                    this.addSupabaseRoute('shared_content_completed', value, { ...options, method: 'POST' });
+                },
+                /**
+                 * Mock the shared_content_completed POST endpoint for state updates.
+                 * Alias for mockComplete since both use upsert via POST.
+                 */
+                mockUpdateState: (value = {}, options) => {
+                    this.addSupabaseRoute('shared_content_completed', value, { ...options, method: 'POST' });
+                },
+                /**
+                 * Mock removing shared content (soft delete via PATCH).
+                 * Alias for mockUpdate since removeSharedContent uses PATCH to set deleted_at.
+                 */
+                mockRemove: (value, options) => {
+                    this.addSupabaseRoute('shared_content', value, { ...options, method: 'PATCH' });
+                },
             },
         };
         this.exercise = {
@@ -384,8 +410,86 @@ class RimoriTestEnvironment {
         };
         this.page = options.page;
         this.pluginId = options.pluginId;
-        // TODO move to a function
-        this.rimoriInfo = {
+        this.rimoriInfo = this.getRimoriInfo(options);
+        // Initialize settings state manager
+        this.settingsManager = new SettingsStateManager_1.SettingsStateManager(options.settings || null, options.pluginId, this.rimoriInfo.guild.id);
+        this.interceptRoutes(options.pluginUrl);
+    }
+    interceptRoutes(pluginUrl) {
+        // Intercept all /locales requests and fetch from the dev server
+        this.page.route(`${pluginUrl}/locales/**`, async (route) => {
+            const request = route.request();
+            const url = new URL(request.url());
+            const devServerUrl = `http://${url.host}/locales/en.json`;
+            // console.log('Fetching locales from: ' + devServerUrl);
+            // throw new Error('Test: ' + devServerUrl);
+            try {
+                // Fetch from the dev server
+                const response = await fetch(devServerUrl);
+                const body = await response.text();
+                await route.fulfill({
+                    status: response.status,
+                    headers: { 'Content-Type': 'application/json' },
+                    body,
+                });
+            }
+            catch (error) {
+                console.error(`Error fetching translation from ${devServerUrl}:`, error);
+                await route.fulfill({
+                    status: 500,
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ error: 'Failed to load translations' }),
+                });
+            }
+        });
+        this.page.route(`${this.rimoriInfo.backendUrl}/**`, (route) => this.handleRoute(route, this.backendRoutes));
+        this.page.route(`${this.rimoriInfo.url}/**`, (route) => this.handleRoute(route, this.supabaseRoutes));
+    }
+    async setup() {
+        // console.log('Setting up RimoriTestEnvironment');
+        this.page.on('console', (msg) => {
+            const logLevel = msg.type();
+            const logMessage = msg.text();
+            if (logLevel === 'debug')
+                return;
+            if (logMessage.includes('Download the React DevTools'))
+                return;
+            if (logMessage.includes('languageChanged en'))
+                return;
+            if (logMessage.includes('i18next: initialized {debug: true'))
+                return;
+            console.log(`[browser:${logLevel}]`, logMessage);
+        });
+        // Set up default handlers for plugin_settings routes using SettingsStateManager
+        this.setupSettingsRoutes();
+        // Set up default handlers for shared_content routes
+        this.setupSharedContentRoutes();
+        // Initialize MessageChannelSimulator to simulate parent-iframe communication
+        // This makes the plugin think it's running in an iframe (not standalone mode)
+        // Convert RimoriInfo from CommunicationHandler format to MessageChannelSimulator format
+        this.messageChannelSimulator = new MessageChannelSimulator_1.MessageChannelSimulator({
+            page: this.page,
+            pluginId: this.pluginId,
+            queryParams: {},
+            rimoriInfo: this.rimoriInfo,
+        });
+        // Initialize the simulator - this injects the necessary shims
+        // to intercept window.parent.postMessage calls and set up MessageChannel communication
+        await this.messageChannelSimulator.initialize();
+        // Set up a no-op handler for pl454583483.session.triggerUrlChange
+        // This prevents errors if the plugin emits this event
+        this.messageChannelSimulator.on(`${this.pluginId}.session.triggerUrlChange`, () => {
+            // No-op handler - does nothing
+        });
+        this.messageChannelSimulator.on('global.accomplishment.triggerMicro', () => {
+            // No-op handler - does nothing
+        });
+        this.messageChannelSimulator.on('global.accomplishment.triggerMacro', () => {
+            // No-op handler - does nothing
+        });
+    }
+    getRimoriInfo(options) {
+        return {
             key: 'rimori-testing-key',
             token: 'rimori-testing-token',
             url: 'http://localhost:3500',
@@ -416,80 +520,99 @@ class RimoriTestEnvironment {
             profile: default_user_info_1.DEFAULT_USER_INFO,
             mainPanelPlugin: undefined,
             sidePanelPlugin: undefined,
+            interfaceLanguage: default_user_info_1.DEFAULT_USER_INFO.mother_tongue.code, // Set interface language from user's mother tongue
         };
-        this.interceptRoutes();
     }
-    interceptRoutes() {
-        this.page.route(`${this.rimoriInfo.backendUrl}/**`, (route) => this.handleRoute(route, this.backendRoutes));
-        this.page.route(`${this.rimoriInfo.url}/**`, (route) => this.handleRoute(route, this.supabaseRoutes));
-    }
-    async setup() {
-        console.log('Setting up RimoriTestEnvironment');
-        this.page.on('console', (msg) => {
-            console.log(`[browser:${msg.type()}]`, msg.text());
+    /**
+     * Sets up the plugin_settings routes to use the SettingsStateManager.
+     * GET returns current state, PATCH updates state, POST creates/updates state.
+     */
+    setupSettingsRoutes() {
+        // GET: Return current settings state
+        this.addSupabaseRoute('plugin_settings', () => this.settingsManager.getSettings(), {
+            method: 'GET',
         });
-        // Add default handlers for common routes that plugins typically access
-        // These can be overridden by explicit mock calls
-        if (!this.supabaseRoutes[this.createRouteKey('GET', `${this.rimoriInfo.url}/rest/v1/plugin_settings`)]) {
-            // Default: no settings exist (null) - triggers INSERT flow
-            // Can be overridden with mockGetSettings() to return existing settings
-            this.plugin.mockGetSettings(null);
-        }
-        if (!this.supabaseRoutes[this.createRouteKey('PATCH', `${this.rimoriInfo.url}/rest/v1/plugin_settings`)]) {
-            // Default PATCH handler for plugin_settings - returns empty array (no rows updated)
-            // This triggers INSERT (POST) flow
-            // Can be overridden with mockSetSettings() to simulate successful update
-            this.plugin.mockSetSettings([]);
-        }
-        if (!this.supabaseRoutes[this.createRouteKey('POST', `${this.rimoriInfo.url}/rest/v1/plugin_settings`)]) {
-            // Default POST handler for plugin_settings - simulates successful insert
-            // Can be overridden with mockInsertSettings() to customize response
-            this.plugin.mockInsertSettings();
-        }
-        // Initialize MessageChannelSimulator to simulate parent-iframe communication
-        // This makes the plugin think it's running in an iframe (not standalone mode)
-        // Convert RimoriInfo from CommunicationHandler format to MessageChannelSimulator format
-        this.messageChannelSimulator = new MessageChannelSimulator_1.MessageChannelSimulator({
-            page: this.page,
-            pluginId: this.pluginId,
-            queryParams: {},
-            rimoriInfo: {
-                ...this.rimoriInfo,
-                guild: {
-                    id: this.rimoriInfo.guild.id,
-                    longTermGoalOverride: 'longTermGoalOverride' in this.rimoriInfo.guild ? this.rimoriInfo.guild.longTermGoalOverride : '',
-                    allowUserPluginSettings: this.rimoriInfo.guild.allowUserPluginSettings,
-                },
-                installedPlugins: this.rimoriInfo.installedPlugins.map((p) => ({
-                    id: p.id,
-                    title: p.info?.title || '',
-                    description: p.info?.description || '',
-                    logo: p.info?.logo || '',
-                    url: p.pages?.external_hosted_url || '',
-                })),
-                mainPanelPlugin: this.rimoriInfo.mainPanelPlugin
-                    ? {
-                        id: this.rimoriInfo.mainPanelPlugin.id,
-                        title: this.rimoriInfo.mainPanelPlugin.info?.title || '',
-                        description: this.rimoriInfo.mainPanelPlugin.info?.description || '',
-                        logo: this.rimoriInfo.mainPanelPlugin.info?.logo || '',
-                        url: this.rimoriInfo.mainPanelPlugin.pages?.external_hosted_url || '',
-                    }
-                    : undefined,
-                sidePanelPlugin: this.rimoriInfo.sidePanelPlugin
-                    ? {
-                        id: this.rimoriInfo.sidePanelPlugin.id,
-                        title: this.rimoriInfo.sidePanelPlugin.info?.title || '',
-                        description: this.rimoriInfo.sidePanelPlugin.info?.description || '',
-                        logo: this.rimoriInfo.sidePanelPlugin.info?.logo || '',
-                        url: this.rimoriInfo.sidePanelPlugin.pages?.external_hosted_url || '',
-                    }
-                    : undefined,
-            },
+        // PATCH: Update settings based on request body
+        this.addSupabaseRoute('plugin_settings', async (request) => {
+            try {
+                const postData = request.postData();
+                if (postData) {
+                    const updates = JSON.parse(postData);
+                    return this.settingsManager.updateSettings(updates);
+                }
+                // If no body, return empty array (no update)
+                return this.settingsManager.updateSettings({});
+            }
+            catch {
+                // If parsing fails, return empty array
+                return this.settingsManager.updateSettings({});
+            }
+        }, {
+            method: 'PATCH',
+        });
+        // POST: Insert/update settings based on request body
+        this.addSupabaseRoute('plugin_settings', async (request) => {
+            try {
+                const postData = request.postData();
+                if (postData) {
+                    const newSettings = JSON.parse(postData);
+                    return this.settingsManager.insertSettings(newSettings);
+                }
+                // If no body, insert with defaults
+                return this.settingsManager.insertSettings({});
+            }
+            catch {
+                // If parsing fails, insert with defaults
+                return this.settingsManager.insertSettings({});
+            }
+        }, {
+            method: 'POST',
         });
-        // Initialize the simulator - this injects the necessary shims
-        // to intercept window.parent.postMessage calls and set up MessageChannel communication
-        await this.messageChannelSimulator.initialize();
+    }
+    /**
+     * Sets up default handlers for shared_content and shared_content_completed routes.
+     * These provide sensible defaults so tests don't need to mock every shared content call.
+     */
+    setupSharedContentRoutes() {
+        // GET: Return empty array for getCompletedTopics and getSharedContentList
+        this.addSupabaseRoute('shared_content', [], { method: 'GET' });
+        // POST: Return created content with generated ID for createSharedContent
+        this.addSupabaseRoute('shared_content', async (request) => {
+            try {
+                const postData = request.postData();
+                if (postData) {
+                    const content = JSON.parse(postData);
+                    // Return the content with a generated ID
+                    return [
+                        {
+                            id: `shared-content-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`,
+                            ...content,
+                            created_at: new Date().toISOString(),
+                        },
+                    ];
+                }
+                return [];
+            }
+            catch {
+                return [];
+            }
+        }, { method: 'POST' });
+        // PATCH: Return updated content for updateSharedContent and removeSharedContent
+        this.addSupabaseRoute('shared_content', async (request) => {
+            try {
+                const postData = request.postData();
+                if (postData) {
+                    const updates = JSON.parse(postData);
+                    return [{ id: 'updated-content', ...updates }];
+                }
+                return [];
+            }
+            catch {
+                return [];
+            }
+        }, { method: 'PATCH' });
+        // POST: Handle shared_content_completed upserts
+        this.addSupabaseRoute('shared_content_completed', {}, { method: 'POST' });
     }
     /**
      * Formats text as SSE (Server-Sent Events) response.
@@ -548,10 +671,11 @@ class RimoriTestEnvironment {
         const requestUrl = request.url();
         const method = request.method().toUpperCase();
         const routeKey = this.createRouteKey(method, requestUrl);
-        console.log('Handling route', routeKey);
+        // console.log('Handling route', routeKey);
         const mocks = routes[routeKey];
         if (!mocks || mocks.length === 0) {
             console.error('No route handler found for route', routeKey);
+            throw new Error('No route handler found for route: ' + routeKey);
             route.abort('not_found');
             return;
         }
@@ -591,10 +715,15 @@ class RimoriTestEnvironment {
         if (options?.error) {
             return await route.abort(options.error);
         }
+        // Handle function-based mocks (for stateful responses like settings)
+        let responseValue = matchingMock.value;
+        if (typeof matchingMock.value === 'function') {
+            responseValue = await matchingMock.value(request);
+        }
         // Handle streaming responses (for mockGetSteamedText)
         // Since Playwright requires complete body, we format as SSE without delays
-        if (matchingMock.isStreaming && typeof matchingMock.value === 'string') {
-            const body = this.formatAsSSE(matchingMock.value);
+        if (matchingMock.isStreaming && typeof responseValue === 'string') {
+            const body = this.formatAsSSE(responseValue);
             return await route.fulfill({
                 status: 200,
                 headers: { 'Content-Type': 'text/event-stream' },
@@ -602,7 +731,7 @@ class RimoriTestEnvironment {
             });
         }
         // Regular JSON response
-        const responseBody = JSON.stringify(matchingMock.value);
+        const responseBody = JSON.stringify(responseValue);
         route.fulfill({
             status: 200,
             body: responseBody,
@@ -618,6 +747,7 @@ class RimoriTestEnvironment {
         const method = options?.method ?? 'GET';
         const fullPath = `${this.rimoriInfo.url}/rest/v1/${path}`;
         const routeKey = this.createRouteKey(method, fullPath);
+        // console.log('Registering supabase route:', routeKey);
         if (!this.supabaseRoutes[routeKey]) {
             this.supabaseRoutes[routeKey] = [];
         }
@@ -635,7 +765,6 @@ class RimoriTestEnvironment {
      * @param isStreaming - Optional flag to mark this as a streaming response.
      */
     addBackendRoute(path, values, options) {
-        console.warn('addBackendRoute is not tested');
         const method = options?.method ?? 'POST';
         const fullPath = `${this.rimoriInfo.backendUrl}${path.startsWith('/') ? path : '/' + path}`;
         const routeKey = this.createRouteKey(method, fullPath);
@@ -653,4 +782,3 @@ class RimoriTestEnvironment {
 }
 exports.RimoriTestEnvironment = RimoriTestEnvironment;
 // Todo: How to test if the event was received by the parent?
-// TODO: The matcher option of RimoriTestEnvironment v1 might be useful to use

package/dist/core/SettingsStateManager.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Manages plugin settings state for test environment.
+ * Provides a single source of truth for settings that can be modified by mocked API calls.
+ */
+export interface PluginSettings {
+    id?: string;
+    plugin_id?: string;
+    guild_id?: string;
+    settings?: Record<string, unknown>;
+    is_guild_setting?: boolean;
+    user_id?: string | null;
+}
+export declare class SettingsStateManager {
+    private settings;
+    constructor(initialSettings: PluginSettings | null, pluginId: string, guildId: string);
+    /**
+     * Get current settings state (for GET requests)
+     * Returns null if no settings exist, otherwise returns the full settings object
+     */
+    getSettings(): PluginSettings | null;
+    /**
+     * Update settings (for PATCH requests)
+     * @param updates - Partial settings to update
+     * @returns Array with updated row if settings exist, empty array if no settings exist
+     */
+    updateSettings(updates: Partial<PluginSettings>): PluginSettings[];
+    /**
+     * Insert new settings (for POST requests)
+     * @param newSettings - Settings to insert
+     * @returns The inserted settings object
+     */
+    insertSettings(newSettings: Partial<PluginSettings>): PluginSettings;
+    /**
+     * Manually set settings (useful for test setup)
+     */
+    setSettings(settings: PluginSettings | null): void;
+    /**
+     * Check if settings exist
+     */
+    hasSettings(): boolean;
+}

package/dist/core/SettingsStateManager.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Manages plugin settings state for test environment.
+ * Provides a single source of truth for settings that can be modified by mocked API calls.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SettingsStateManager = void 0;
+class SettingsStateManager {
+    constructor(initialSettings, pluginId, guildId) {
+        this.settings = {
+            id: initialSettings?.id ?? 'settings-id',
+            plugin_id: initialSettings?.plugin_id ?? pluginId,
+            guild_id: initialSettings?.guild_id ?? guildId,
+            settings: initialSettings?.settings ?? {},
+            is_guild_setting: initialSettings?.is_guild_setting ?? false,
+            user_id: initialSettings?.user_id ?? null,
+        };
+    }
+    /**
+     * Get current settings state (for GET requests)
+     * Returns null if no settings exist, otherwise returns the full settings object
+     */
+    getSettings() {
+        return this.settings;
+    }
+    /**
+     * Update settings (for PATCH requests)
+     * @param updates - Partial settings to update
+     * @returns Array with updated row if settings exist, empty array if no settings exist
+     */
+    updateSettings(updates) {
+        if (this.settings === null) {
+            // No settings exist - PATCH returns empty array (triggers INSERT flow)
+            return [];
+        }
+        // Update existing settings
+        this.settings = {
+            ...this.settings,
+            ...updates,
+            // Ensure these fields are preserved
+            id: this.settings.id,
+            plugin_id: this.settings.plugin_id,
+            guild_id: this.settings.guild_id,
+        };
+        // PATCH returns array with updated row
+        return [this.settings];
+    }
+    /**
+     * Insert new settings (for POST requests)
+     * @param newSettings - Settings to insert
+     * @returns The inserted settings object
+     */
+    insertSettings(newSettings) {
+        // Update existing settings with new values
+        this.settings = {
+            ...this.settings,
+            ...newSettings,
+        };
+        return this.settings;
+    }
+    /**
+     * Manually set settings (useful for test setup)
+     */
+    setSettings(settings) {
+        this.settings = settings;
+    }
+    /**
+     * Check if settings exist
+     */
+    hasSettings() {
+        return this.settings !== null;
+    }
+}
+exports.SettingsStateManager = SettingsStateManager;

package/dist/fixtures/default-user-info.js

@@ -40,4 +40,5 @@ exports.DEFAULT_USER_INFO = {
     user_name: 'Test User',
     target_country: 'SE',
     target_city: 'Stockholm',
+    user_role: 'user',
 };

package/dist/test/translator.test.js

@@ -7,7 +7,7 @@ const pluginUrl = 'http://localhost:3009';
 test_1.test.describe('Translator Plugin', () => {
     let env;
     test_1.test.beforeEach(async ({ page }) => {
-        env = new RimoriTestEnvironment_1.RimoriTestEnvironment({ page, pluginId });
+        env = new RimoriTestEnvironment_1.RimoriTestEnvironment({ page, pluginId, pluginUrl });
         env.ai.mockGetObject({
             gramatically_corrected_input_text: 'tree',
             detected_language: 'English',

package/package.json

@@ -1,13 +1,18 @@
 {
   "name": "@rimori/playwright-testing",
-  "version": "0.2.3",
+  "version": "0.2.4-next.0",
   "description": "Playwright testing utilities for Rimori plugins and workers",
   "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rimori-org/playwright-testing.git"
+  },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "source": "src/index.ts",
   "scripts": {
     "build": "tsc -p tsconfig.json",
+    "dev": "tsc -w --preserveWatchOutput -p tsconfig.json",
     "clean": "rimraf dist",
     "lint": "eslint \"src/**/*.{ts,tsx}\"",
     "test": "playwright test",
@@ -17,13 +22,12 @@
     "test:headed:debug": "playwright test --headed --debug"
   },
   "peerDependencies": {
-    "@playwright/test": "^1.40.0"
-  },
-  "dependencies": {
-    "@rimori/client": "^2.1.7"
+    "@playwright/test": "^1.40.0",
+    "@rimori/client": "^2.2.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.40.0",
+    "@rimori/client": "^2.2.0",
     "@types/node": "^20.12.7",
     "rimraf": "^5.0.7",
     "typescript": "^5.7.2"