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

package/README.md

@@ -3,6 +3,7 @@
 The `@rimori/client` package is the framework-agnostic runtime and CLI that powers Rimori plugins. Use it inside plugin iframes, workers, and build scripts to access Rimori platform features such as database access, AI, shared content, and the event bus. All React-specific helpers and UI components are now published separately in `@rimori/react-client`.
 
 ## Table of Contents
+
 - [Overview](#overview)
 - [Installation](#installation)
 - [Relationship to @rimori/react-client](#relationship-to-rimori-react-client)
@@ -24,6 +25,7 @@ The `@rimori/client` package is the framework-agnostic runtime and CLI that powe
 ## Overview
 
 `@rimori/client` gives you direct, typed access to the Rimori platform:
+
 - Bootstrap authenticated plugin sessions and fetch Rimori context.
 - Run Supabase queries against your plugin's dedicated schema.
 - Call AI services for text, structured data, or voice.
@@ -54,18 +56,15 @@ npm install @rimori/react-client
 Instantiate the client once in your application entry point and reuse it everywhere:
 
 ```ts
-import { RimoriClient } from "@rimori/client";
+import { RimoriClient } from '@rimori/client';
 
 async function bootstrap() {
-  const client = await RimoriClient.getInstance("your-plugin-id");
+  const client = await RimoriClient.getInstance('your-plugin-id');
 
   const user = client.plugin.getUserInfo();
-  const { data } = await client.db
-    .from("notes")
-    .select("*")
-    .eq("user_id", user.profile_id);
+  const { data } = await client.db.from('notes').select('*').eq('user_id', user.profile_id);
 
-  console.log("Loaded notes", data);
+  console.log('Loaded notes', data);
 }
 
 bootstrap().catch(console.error);
@@ -127,10 +126,7 @@ Access metadata and settings through `client.plugin`:
 `client.db` wraps the Supabase client that is scoped to your plugin tables:
 
 ```ts
-const { data, error } = await client.db
-  .from("study_sessions")
-  .select("*")
-  .order("completed_at", { ascending: false });
+const { data, error } = await client.db.from('study_sessions').select('*').order('completed_at', { ascending: false });
 ```
 
 Helpers:
@@ -196,7 +192,7 @@ Import additional helpers as needed:
 All exports are fully typed. You can import the type definitions directly:
 
 ```ts
-import type { Message, Tool, SharedContent, MacroAccomplishmentPayload } from "@rimori/client";
+import type { Message, Tool, SharedContent, MacroAccomplishmentPayload } from '@rimori/client';
 ```
 
 The generated declaration files cover every controller and helper to keep plugins strictly typed.
@@ -206,7 +202,7 @@ The generated declaration files cover every controller and helper to keep plugin
 React users should install `@rimori/react-client` and wrap their app:
 
 ```tsx
-import { PluginProvider, useRimori, useChat } from "@rimori/react-client";
+import { PluginProvider, useRimori, useChat } from '@rimori/react-client';
 
 function Dashboard() {
   const client = useRimori();

package/dist/plugin/CommunicationHandler.d.ts

@@ -27,6 +27,17 @@ export interface RimoriInfo {
     mainPanelPlugin?: ActivePlugin;
     sidePanelPlugin?: ActivePlugin;
     interfaceLanguage: string;
+    /**
+     * The release channel of the plugin installation.
+     */
+    releaseChannel: 'alpha' | 'beta' | 'stable';
+    /**
+     * The database schema to use for plugin tables.
+     * Determined by rimori-main based on release channel:
+     * - 'plugins_alpha' for alpha release channel
+     * - 'plugins' for beta and stable release channels
+     */
+    dbSchema: 'plugins' | 'plugins_alpha';
 }
 export declare class RimoriCommunicationHandler {
     private port;

package/dist/plugin/RimoriClient.d.ts

@@ -22,6 +22,11 @@ export declare class RimoriClient {
     private constructor();
     get plugin(): {
         pluginId: string;
+        /**
+         * The release channel of this plugin installation.
+         * Determines which database schema is used for plugin tables.
+         */
+        releaseChannel: "alpha" | "beta" | "stable";
         /**
          * Set the settings for the plugin.
          * @param settings The settings to set.
@@ -67,6 +72,13 @@ export declare class RimoriClient {
          * The table prefix for of database tables of the plugin.
          */
         tablePrefix: string;
+        /**
+         * The database schema used for plugin tables.
+         * Determined by rimori-main based on release channel:
+         * - 'plugins_alpha' for alpha release channel
+         * - 'plugins' for beta and stable release channels
+         */
+        schema: "plugins" | "plugins_alpha";
         /**
          * 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.

package/dist/plugin/RimoriClient.js

@@ -287,6 +287,11 @@ export class RimoriClient {
     get plugin() {
         return {
             pluginId: this.rimoriInfo.pluginId,
+            /**
+             * The release channel of this plugin installation.
+             * Determines which database schema is used for plugin tables.
+             */
+            releaseChannel: this.rimoriInfo.releaseChannel,
             /**
              * Set the settings for the plugin.
              * @param settings The settings to set.
@@ -340,15 +345,15 @@ export class RimoriClient {
             // ): PostgrestQueryBuilder<GenericSchema, View, ViewName>;
             from: (relation) => {
                 const tableName = this.db.getTableName(relation);
-                // Use plugins schema for plugin-specific tables (those with plugin prefix pattern pl[0-9]+_*)
+                // Use the schema determined by rimori-main based on release channel
                 // Global tables (starting with 'global_') remain in public schema
-                // Plugin tables always have the prefix, so use plugins schema for all prefixed tables
+                // 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.superbase.from(tableName);
                 }
-                // All plugin tables go to plugins schema
-                return this.superbase.schema('plugins').from(tableName);
+                // Plugin tables go to the schema provided by rimori-main
+                return this.superbase.schema(this.rimoriInfo.dbSchema).from(tableName);
             },
             // storage: this.superbase.storage,
             // functions: this.superbase.functions,
@@ -356,6 +361,13 @@ export class RimoriClient {
              * The table prefix for of database tables of the plugin.
              */
             tablePrefix: this.rimoriInfo.tablePrefix,
+            /**
+             * The database schema used for plugin tables.
+             * Determined by rimori-main based on release channel:
+             * - 'plugins_alpha' for alpha release channel
+             * - 'plugins' for beta and stable release channels
+             */
+            schema: this.rimoriInfo.dbSchema,
             /**
              * 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.

package/package.json

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

package/src/plugin/CommunicationHandler.ts

@@ -33,6 +33,17 @@ export interface RimoriInfo {
   mainPanelPlugin?: ActivePlugin;
   sidePanelPlugin?: ActivePlugin;
   interfaceLanguage: string;
+  /**
+   * The release channel of the plugin installation.
+   */
+  releaseChannel: 'alpha' | 'beta' | 'stable';
+  /**
+   * The database schema to use for plugin tables.
+   * Determined by rimori-main based on release channel:
+   * - 'plugins_alpha' for alpha release channel
+   * - 'plugins' for beta and stable release channels
+   */
+  dbSchema: 'plugins' | 'plugins_alpha';
 }
 
 export class RimoriCommunicationHandler {

package/src/plugin/RimoriClient.ts

@@ -55,6 +55,11 @@ export class RimoriClient {
   public get plugin() {
     return {
       pluginId: this.rimoriInfo.pluginId,
+      /**
+       * The release channel of this plugin installation.
+       * Determines which database schema is used for plugin tables.
+       */
+      releaseChannel: this.rimoriInfo.releaseChannel,
       /**
        * Set the settings for the plugin.
        * @param settings The settings to set.
@@ -124,15 +129,15 @@ export class RimoriClient {
         relation: string,
       ): PostgrestQueryBuilder<GenericSchema, View, ViewName> => {
         const tableName = this.db.getTableName(relation);
-        // Use plugins schema for plugin-specific tables (those with plugin prefix pattern pl[0-9]+_*)
+        // Use the schema determined by rimori-main based on release channel
         // Global tables (starting with 'global_') remain in public schema
-        // Plugin tables always have the prefix, so use plugins schema for all prefixed tables
+        // 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.superbase.from(tableName);
         }
-        // All plugin tables go to plugins schema
-        return this.superbase.schema('plugins').from(tableName);
+        // Plugin tables go to the schema provided by rimori-main
+        return this.superbase.schema(this.rimoriInfo.dbSchema).from(tableName);
       },
       // storage: this.superbase.storage,
       // functions: this.superbase.functions,
@@ -140,6 +145,13 @@ export class RimoriClient {
        * The table prefix for of database tables of the plugin.
        */
       tablePrefix: this.rimoriInfo.tablePrefix,
+      /**
+       * The database schema used for plugin tables.
+       * Determined by rimori-main based on release channel:
+       * - 'plugins_alpha' for alpha release channel
+       * - 'plugins' for beta and stable release channels
+       */
+      schema: this.rimoriInfo.dbSchema,
       /**
        * 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.