@rimori/client 2.5.17 → 2.5.18-next.1

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

@@ -1,7 +1,14 @@
 /**
  * Supported database column data types for table schema definitions.
  */
-type DbColumnType = 'decimal' | 'integer' | 'text' | 'boolean' | 'json' | 'timestamp' | 'uuid';
+/**
+ * 'markdown' is stored as `text` in the database.
+ * Marking a column as 'markdown' causes the migration system to:
+ *  1. Add an `updated_at` timestamp + trigger to the table.
+ *  2. Add an `updated_at` trigger so the image-sync cron can detect recently
+ *     modified entries. The cron derives which columns to scan from release.db_schema.
+ */
+type DbColumnType = 'decimal' | 'integer' | 'text' | 'boolean' | 'json' | 'timestamp' | 'uuid' | 'markdown';
 /**
  * Foreign key relationship configuration with cascade delete support.
  * Defines a relationship where the source record is deleted when the destination record is deleted.

package/dist/index.d.ts

@@ -18,3 +18,4 @@ export type { Theme, ApplicationMode } from './plugin/module/PluginModule';
 export type { UserInfo, Language, UserRole, ExplicitUndefined } 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,3 +10,4 @@ export * from './plugin/CommunicationHandler';
 export { setupWorker } from './worker/WorkerSetup';
 export { AudioController } from './controller/AudioController';
 export { Translator } from './controller/TranslationController';
+export { StorageModule } from './plugin/module/StorageModule';

package/dist/plugin/RimoriClient.d.ts

@@ -4,6 +4,7 @@ import { DbModule } from './module/DbModule';
 import { EventModule } from './module/EventModule';
 import { AIModule } from './module/AIModule';
 import { ExerciseModule } from './module/ExerciseModule';
+import { StorageModule } from './module/StorageModule';
 export declare class RimoriClient {
     private static instance;
     sharedContent: SharedContentController;
@@ -12,6 +13,8 @@ export declare class RimoriClient {
     plugin: PluginModule;
     ai: AIModule;
     exercise: ExerciseModule;
+    /** Upload and manage images stored in Supabase via the backend. */
+    storage: StorageModule;
     private rimoriInfo;
     private constructor();
     static getInstance(pluginId?: string): Promise<RimoriClient>;

package/dist/plugin/RimoriClient.js

@@ -15,6 +15,7 @@ import { DbModule } from './module/DbModule';
 import { EventModule } from './module/EventModule';
 import { AIModule } from './module/AIModule';
 import { ExerciseModule } from './module/ExerciseModule';
+import { StorageModule } from './module/StorageModule';
 import { EventBus } from '../fromRimori/EventBus';
 export class RimoriClient {
     constructor(controller, supabase, info) {
@@ -38,6 +39,7 @@ export class RimoriClient {
         this.db = new DbModule(supabase, controller, info);
         this.plugin = new PluginModule(supabase, controller, info, this.ai);
         this.exercise = new ExerciseModule(supabase, controller, info, this.event);
+        this.storage = new StorageModule(info.backendUrl, () => this.rimoriInfo.token);
         controller.onUpdate((updatedInfo) => {
             this.rimoriInfo = updatedInfo;
         });

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

@@ -67,6 +67,11 @@ export declare class AIModule {
     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;
     /** Registers a callback invoked whenever a 429 rate-limit response is received. */
     setOnRateLimited(cb: (exercisesRemaining: number) => void): void;
     /**
@@ -86,7 +91,7 @@ export declare class AIModule {
      * @param cache Whether to cache the result (default: false).
      * @param model The model to use for generation.
      */
-    getSteamedText(messages: Message[], onMessage: OnLLMResponse, tools?: Tool[], cache?: boolean, model?: string, knowledgeId?: string): Promise<void>;
+    getSteamedText(messages: Message[], onMessage: OnLLMResponse, tools?: Tool[], cache?: boolean, model?: string, knowledgeId?: string): Promise<string>;
     /**
      * Generate voice audio from text using AI.
      * @param text The text to convert to voice.
@@ -146,7 +151,7 @@ export declare class AIModule {
         tools?: Tool[];
         model?: string;
         knowledgeId?: string;
-    }): Promise<void>;
+    }): Promise<T>;
     private streamObject;
     private sendToolResult;
 }

package/dist/plugin/module/AIModule.js

@@ -29,6 +29,32 @@ export class AIModule {
     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;
@@ -82,6 +108,7 @@ export class AIModule {
                 onResult: ({ result }) => onMessage(messageId, result, false),
             });
             onMessage(messageId, result, true);
+            return result;
         });
     }
     /**
@@ -96,6 +123,7 @@ export class AIModule {
     getVoice(text_1) {
         return __awaiter(this, arguments, void 0, function* (text, voice = 'alloy', speed = 1, language, cache = false) {
             var _a;
+            yield this.ensureSessionToken();
             return yield fetch(`${this.backendUrl}/voice/tts`, {
                 method: 'POST',
                 headers: {
@@ -114,6 +142,7 @@ export class AIModule {
      */
     getTextFromVoice(file, language) {
         return __awaiter(this, void 0, void 0, function* () {
+            yield this.ensureSessionToken();
             const formData = new FormData();
             formData.append('file', file);
             if (language) {
@@ -180,7 +209,7 @@ export class AIModule {
     getStreamedObject(params) {
         return __awaiter(this, void 0, void 0, function* () {
             const { systemPrompt, responseSchema, userPrompt, onResult, cache = false, tools = [], model = undefined, knowledgeId, } = params;
-            yield this.streamObject({
+            return yield this.streamObject({
                 responseSchema,
                 messages: this.getChatMessage(systemPrompt, userPrompt),
                 onResult,

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

@@ -45,8 +45,9 @@ export declare class ExerciseModule {
      */
     view(): Promise<Exercise[]>;
     /**
-     * Creates a new exercise or multiple exercises via the backend API.
-     * When creating multiple exercises, all requests are made in parallel but only one event is emitted.
+     * Creates one or more exercises via the backend API.
+     * Multiple exercises are sent in a single bulk request to ensure atomicity —
+     * either all succeed or none are inserted.
      * @param params Exercise creation parameters (single or array).
      * @returns Created exercise objects.
      */

package/dist/plugin/module/ExerciseModule.js

@@ -37,31 +37,30 @@ export class ExerciseModule {
         });
     }
     /**
-     * Creates a new exercise or multiple exercises via the backend API.
-     * When creating multiple exercises, all requests are made in parallel but only one event is emitted.
+     * Creates one or more exercises via the backend API.
+     * Multiple exercises are sent in a single bulk request to ensure atomicity —
+     * either all succeed or none are inserted.
      * @param params Exercise creation parameters (single or array).
      * @returns Created exercise objects.
      */
     add(params) {
         return __awaiter(this, void 0, void 0, function* () {
             const exercises = Array.isArray(params) ? params : [params];
-            const responses = yield Promise.all(exercises.map((exercise) => __awaiter(this, void 0, void 0, function* () {
-                const response = yield fetch(`${this.backendUrl}/exercises`, {
-                    method: 'POST',
-                    headers: {
-                        'Content-Type': 'application/json',
-                        Authorization: `Bearer ${this.token}`,
-                    },
-                    body: JSON.stringify(exercise),
-                });
-                if (!response.ok) {
-                    const errorText = yield response.text();
-                    throw new Error(`Failed to create exercise: ${errorText}`);
-                }
-                return yield response.json();
-            })));
+            const response = yield fetch(`${this.backendUrl}/exercises`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${this.token}`,
+                },
+                body: JSON.stringify({ exercises }),
+            });
+            if (!response.ok) {
+                const errorText = yield response.text();
+                throw new Error(`Failed to create exercises: ${errorText}`);
+            }
+            const data = yield response.json();
             this.eventModule.emit('global.exercises.triggerChange');
-            return responses;
+            return data;
         });
     }
     /**

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

@@ -0,0 +1,34 @@
+/**
+ * Storage module for plugin image operations.
+ *
+ * Handles uploading images to Supabase storage via the backend.
+ *
+ * Images are tracked automatically: the backend cron scans markdown columns
+ * (declared via `type: 'markdown'` in db.config.ts) every 30 minutes,
+ * confirms images found in content, and deletes orphaned ones. No plugin-side
+ * confirm or delete calls are needed.
+ */
+export declare class StorageModule {
+    private readonly backendUrl;
+    private readonly getToken;
+    constructor(backendUrl: string, getToken: () => string);
+    /**
+     * Upload a PNG image blob to Supabase storage via the backend.
+     *
+     * The image is initially "unconfirmed". The background cron will link it to
+     * the entry automatically when it scans the markdown column after the entry
+     * is saved (within ~30 minutes).
+     *
+     * @returns `{ data: { url, path } }` on success, `{ error }` on failure.
+     */
+    uploadImage(pngBlob: Blob): Promise<{
+        data: {
+            url: string;
+            path: string;
+        };
+        error?: undefined;
+    } | {
+        data?: undefined;
+        error: Error;
+    }>;
+}

package/dist/plugin/module/StorageModule.js

@@ -0,0 +1,57 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+/**
+ * Storage module for plugin image operations.
+ *
+ * Handles uploading images to Supabase storage via the backend.
+ *
+ * Images are tracked automatically: the backend cron scans markdown columns
+ * (declared via `type: 'markdown'` in db.config.ts) every 30 minutes,
+ * confirms images found in content, and deletes orphaned ones. No plugin-side
+ * confirm or delete calls are needed.
+ */
+export class StorageModule {
+    constructor(backendUrl, getToken) {
+        this.backendUrl = backendUrl;
+        this.getToken = getToken;
+    }
+    /**
+     * Upload a PNG image blob to Supabase storage via the backend.
+     *
+     * The image is initially "unconfirmed". The background cron will link it to
+     * the entry automatically when it scans the markdown column after the entry
+     * is saved (within ~30 minutes).
+     *
+     * @returns `{ data: { url, path } }` on success, `{ error }` on failure.
+     */
+    uploadImage(pngBlob) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const formData = new FormData();
+            formData.append('file', pngBlob, 'image.png');
+            try {
+                const response = yield fetch(`${this.backendUrl}/plugin-images/upload`, {
+                    method: 'POST',
+                    headers: { Authorization: `Bearer ${this.getToken()}` },
+                    body: formData,
+                });
+                if (!response.ok) {
+                    const body = (yield response.json().catch(() => ({})));
+                    return { error: new Error((_a = body.message) !== null && _a !== void 0 ? _a : `Upload failed (${response.status})`) };
+                }
+                const result = (yield response.json());
+                return { data: result };
+            }
+            catch (err) {
+                return { error: err instanceof Error ? err : new Error(String(err)) };
+            }
+        });
+    }
+}

package/package.json

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