@rimori/client 2.5.48 → 2.5.49

package/dist/cli/scripts/release/release-config-upload.d.ts

@@ -0,0 +1,9 @@
+import { Config } from './release';
+/**
+ * Read `rimori/rimori.config.ts` and store it on the plugin's `plugin` row, so the backend has
+ * a live source of truth for the plugin's pages and actions (see planning/plugin-config-in-db.md).
+ *
+ * Unlike db.config.ts / prompts.config.ts (both optional and skipped when absent),
+ * rimori.config.ts is mandatory — a plugin without one cannot be released.
+ */
+export default function configUpload(config: Config): Promise<void>;

package/dist/cli/scripts/release/release-config-upload.js

@@ -0,0 +1,63 @@
+import fs from 'fs';
+import path from 'path';
+import ts from 'typescript';
+/**
+ * Read `rimori/rimori.config.ts` and store it on the plugin's `plugin` row, so the backend has
+ * a live source of truth for the plugin's pages and actions (see planning/plugin-config-in-db.md).
+ *
+ * Unlike db.config.ts / prompts.config.ts (both optional and skipped when absent),
+ * rimori.config.ts is mandatory — a plugin without one cannot be released.
+ */
+export default async function configUpload(config) {
+    const configPath = path.resolve('./rimori/rimori.config.ts');
+    try {
+        await fs.promises.access(configPath);
+    }
+    catch {
+        throw new Error('Could not find rimori.config.ts in ./rimori/ directory');
+    }
+    const configContent = await fs.promises.readFile(configPath, 'utf8');
+    // The `import type { RimoriPluginConfig } from '@rimori/client'` at the top of every plugin
+    // config is elided by ts.transpile (type-only), which is why importing the transpiled file
+    // works without resolving @rimori/client from the plugin's directory.
+    const transpiled = ts.transpile(configContent, {
+        target: ts.ScriptTarget.ES2020,
+        module: ts.ModuleKind.ES2020,
+    });
+    const tempFile = path.join(process.cwd(), 'temp_rimori_config.js');
+    await fs.promises.writeFile(tempFile, transpiled);
+    let configObject;
+    try {
+        const imported = await import(`file://${tempFile}`);
+        configObject = imported.default;
+    }
+    finally {
+        await fs.promises.unlink(tempFile).catch(() => { });
+    }
+    if (!configObject) {
+        throw new Error('rimori.config.ts has no default export');
+    }
+    console.log('⚙️ Sending plugin configuration...');
+    const response = await fetch(`${config.domain}/release/config`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${config.token}`,
+        },
+        body: JSON.stringify({
+            plugin_id: config.plugin_id,
+            config: configObject,
+            version: config.version,
+        }),
+    }).catch((e) => {
+        console.log('error', e);
+        throw new Error('Error sending plugin configuration');
+    });
+    const responseText = await response.text();
+    if (!response.ok) {
+        // The release-time validation lives in syncConfig() and its message names the offending
+        // page/action, so surface it verbatim rather than a generic failure.
+        throw new Error(`Plugin configuration rejected (${response.status}): ${responseText}`);
+    }
+    console.log('✅ Plugin configuration deployed successfully!');
+}

package/dist/cli/scripts/release/release.js

@@ -13,6 +13,7 @@
 import 'dotenv/config';
 import fs from 'fs';
 import path from 'path';
+import configUpload from './release-config-upload.js';
 import dbUpdate from './release-db-update.js';
 import promptsUpload from './release-prompts-upload.js';
 // Read version from package.json
@@ -59,6 +60,9 @@ async function releaseProcess() {
             console.log(`🚀 Releasing ${config.plugin_id} to ${config.release_channel}...`);
         }
         console.log(`📡 Deploying to: ${config.domain}`);
+        // Upload rimori.config.ts first: it upserts the `plugin` row, so the db sync below is
+        // guaranteed to find a row to write `db_schema` onto. Mandatory — hard-fails if missing.
+        await configUpload(config);
         // Upload prompts (if prompts.config.ts exists)
         await promptsUpload(config);
         // Migrate tables (if db.config.ts exists)

package/dist/cli/types/PromptTypes.d.ts

@@ -1,3 +1,4 @@
+import { SubscriptionTier } from '../../plugin/module/PluginModule';
 /**
  * Formatting options for string array variables when rendered into prompts.
  */
@@ -75,4 +76,6 @@ export interface PromptDefinition {
     schema?: Record<string, any>;
     tools?: any[];
     model?: string;
+    /** Minimum subscription tier allowed to invoke this prompt. Defaults to 'free' when unset. */
+    minTier?: SubscriptionTier;
 }

package/dist/cli/types/PromptTypes.js

@@ -1,3 +1 @@
-// Prompt configuration type definitions
-// Used by plugins in their rimori/prompts.config.ts files
 export {};

package/dist/fromRimori/PluginTypes.d.ts

@@ -27,6 +27,22 @@ export interface PluginPage {
     action?: {
         key: string;
         parameters: ObjectTool;
+        /**
+         * Minimum subscription tier a user must hold to run this exercise. Defaults to 'free'.
+         *
+         * UI / pre-flight only — the enforcement boundary is the server-side `minTier` on the
+         * prompts this action invokes (checked in the backend's ai.controller). Keep the two
+         * consistent: this must never be *above* the prompts' minTier, or the UI would block an
+         * exercise the backend would happily run.
+         *
+         * Drives two things in rimori-main: the "account required" badge in the create-exercise
+         * picker, and whether the public (anonymous) share toggle is offered — anonymous visitors
+         * are granted 'free', so only 'free' actions can be shared publicly.
+         *
+         * Union is inlined rather than importing SubscriptionTier from plugin/module/PluginModule,
+         * which imports this file (circular).
+         */
+        min_tier?: 'anonymous' | 'free' | 'standard' | 'premium' | 'early_access';
         supportive_tools?: {
             key: string;
             event: string;

package/dist/plugin/CommunicationHandler.d.ts

@@ -38,8 +38,10 @@ export interface RimoriInfo {
      * Determined by rimori-main based on release channel:
      * - 'plugins_alpha' for alpha release channel
      * - 'plugins' for stable release channel
+     * - 'public' for rimori-main's own natively-absorbed features (e.g. studyplan), which own
+     *   plain `public` tables namespaced by `tablePrefix` instead of a plugin-scoped schema.
      */
-    dbSchema: 'plugins' | 'plugins_alpha';
+    dbSchema: 'plugins' | 'plugins_alpha' | 'public';
     /**
      * Whether text-to-speech is enabled globally (set in rimori-main navbar).
      */

package/dist/plugin/RimoriClient.js

@@ -31,8 +31,10 @@ export class RimoriClient {
         this.eventBus = eventBus ?? EventBus;
         this.sharedContent = new SharedContentController(supabase, this);
         this.ai = new AIModule(controller);
-        this.ai.setOnRateLimited((exercisesRemaining) => {
-            this.eventBus.emit(info.pluginId, 'global.quota.triggerExceeded', { exercises_remaining: exercisesRemaining });
+        // Fallback for gated prompts even when a plugin's own useTierGate check is missed or
+        // bypassed — mirrors PluginModule.requestUpgrade so both paths open the same modal.
+        this.ai.setOnTierGateBlocked((requiredTier) => {
+            this.eventBus.emit(info.pluginId, 'global.subscription.triggerUpgrade', { requiredTier });
         });
         this.event = new EventModule(info.pluginId, this.ai, this.eventBus);
         this.db = new DbModule(supabase, controller, info);

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

@@ -50,7 +50,7 @@ export type OnLLMResponse = (id: string, response: string, finished: boolean, to
 export declare class AIModule {
     private controller;
     private sessionTokenId;
-    private onRateLimitedCb?;
+    private onTierGateBlockedCb?;
     constructor(controller: RimoriCommunicationHandler);
     /**
      * Resolves a prompt name following the event naming convention:
@@ -67,8 +67,12 @@ export declare class AIModule {
         /** Clears the stored session token. */
         clear: () => void;
     };
-    /** Registers a callback invoked whenever a 429 rate-limit response is received. */
-    setOnRateLimited(cb: (exercisesRemaining: number) => void): void;
+    /**
+     * Registers a callback invoked whenever the backend refuses a prompt call with 403 because
+     * the caller's subscription tier is below the prompt's `minTier`. This is the fallback path
+     * for gated prompts even when a plugin's own UI gate (useTierGate) was missed or bypassed.
+     */
+    setOnTierGateBlocked(cb: (requiredTier: string) => void): void;
     /**
      * Generate text from messages using AI.
      * @param params.messages The messages to generate text from.
@@ -109,7 +113,9 @@ export declare class AIModule {
      * @param speed The speed of the voice (default: 1).
      * @param language Optional language for the voice.
      * @param cache Whether to cache the result (default: false).
-     * @returns The generated audio as a Blob.
+     * @returns The generated audio as a Blob. Free/anonymous tier gets voice silently truncated
+     *   to a few words server-side (see voice.service.ts truncateForFreeTier) — the response shape
+     *   here stays byte-identical for every tier, no flag or signal is exposed to the frontend.
      *
      * **Empty input:** If `text` is empty or whitespace-only, no network request is
      * made and an empty `Blob` is returned immediately. This prevents a 400 error
@@ -137,7 +143,9 @@ export declare class AIModule {
      * Convert voice audio to text using AI.
      * @param file The audio file to convert.
      * @param language Optional language for the voice.
-     * @returns The transcribed text.
+     * @returns The transcribed text. Free/anonymous tier gets the transcript silently truncated
+     *   to a few words server-side (see voice.service.ts truncateForFreeTier) — no flag or signal
+     *   is exposed to the frontend.
      */
     getTextFromVoice(file: Blob, language?: Language): Promise<string>;
     /**

package/dist/plugin/module/AIModule.js

@@ -5,7 +5,7 @@
 export class AIModule {
     controller;
     sessionTokenId = null;
-    onRateLimitedCb;
+    onTierGateBlockedCb;
     constructor(controller) {
         this.controller = controller;
     }
@@ -36,9 +36,13 @@ export class AIModule {
             this.sessionTokenId = null;
         },
     };
-    /** Registers a callback invoked whenever a 429 rate-limit response is received. */
-    setOnRateLimited(cb) {
-        this.onRateLimitedCb = cb;
+    /**
+     * Registers a callback invoked whenever the backend refuses a prompt call with 403 because
+     * the caller's subscription tier is below the prompt's `minTier`. This is the fallback path
+     * for gated prompts even when a plugin's own UI gate (useTierGate) was missed or bypassed.
+     */
+    setOnTierGateBlocked(cb) {
+        this.onTierGateBlockedCb = cb;
     }
     /**
      * Generate text from messages using AI.
@@ -90,7 +94,9 @@ export class AIModule {
      * @param speed The speed of the voice (default: 1).
      * @param language Optional language for the voice.
      * @param cache Whether to cache the result (default: false).
-     * @returns The generated audio as a Blob.
+     * @returns The generated audio as a Blob. Free/anonymous tier gets voice silently truncated
+     *   to a few words server-side (see voice.service.ts truncateForFreeTier) — the response shape
+     *   here stays byte-identical for every tier, no flag or signal is exposed to the frontend.
      *
      * **Empty input:** If `text` is empty or whitespace-only, no network request is
      * made and an empty `Blob` is returned immediately. This prevents a 400 error
@@ -143,7 +149,9 @@ export class AIModule {
      * Convert voice audio to text using AI.
      * @param file The audio file to convert.
      * @param language Optional language for the voice.
-     * @returns The transcribed text.
+     * @returns The transcribed text. Free/anonymous tier gets the transcript silently truncated
+     *   to a few words server-side (see voice.service.ts truncateForFreeTier) — no flag or signal
+     *   is exposed to the frontend.
      */
     async getTextFromVoice(file, language) {
         const formData = new FormData();
@@ -159,10 +167,7 @@ export class AIModule {
             body: formData,
         })
             .then((r) => r.json())
-            .then((r) => {
-            // console.log("STT response: ", r);
-            return r.text;
-        });
+            .then((r) => r.text);
     }
     /**
      * Generate a structured object from a request using AI.
@@ -227,11 +232,11 @@ export class AIModule {
             body: JSON.stringify(payload),
         });
         if (!response.ok) {
-            if (response.status === 429) {
+            if (response.status === 403) {
                 const body = await response.json().catch(() => ({}));
-                const remaining = body.exercises_remaining ?? 0;
-                this.onRateLimitedCb?.(remaining);
-                throw new Error(`Rate limit exceeded: ${body.error ?? 'Daily exercise limit reached'}. exercises_remaining: ${remaining}`);
+                const requiredTier = body.required_tier ?? 'standard';
+                this.onTierGateBlockedCb?.(requiredTier);
+                throw new Error(`Upgrade required: ${body.error ?? 'Upgrade required for this feature'}. required_tier: ${requiredTier}`);
             }
             throw new Error(`Failed to stream object: ${response.status} ${response.statusText}`);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rimori/client",
-  "version": "2.5.48",
+  "version": "2.5.49",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "repository": {