@rimori/client 2.5.36 → 2.5.37-next.1

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

@@ -16,7 +16,18 @@
  *  3. The column MUST be named 'embedding' and only one per table is allowed.
  *  4. Requires `source_column` — the column whose content is embedded async on insert.
  */
-type DbColumnType = 'decimal' | 'integer' | 'text' | 'boolean' | 'json' | 'timestamp' | 'uuid' | 'markdown' | 'vector';
+/**
+ * 'image', 'audio', 'video' and 'file' are stored as `text` (URL) in the database.
+ * Marking a column with one of these types causes the migration system to:
+ *  1. Add an `updated_at` timestamp + trigger to the table.
+ *  2. Register the column for the asset-refs cron, which links rows to bucket
+ *     files (in the `plugin-assets` Supabase bucket) and deletes orphans when
+ *     the row is deleted, the column is replaced, or the value is cleared.
+ *
+ * Use these types instead of `text` for any column whose value is a URL into the
+ * `plugin-assets` bucket — that way the file is automatically cleaned up.
+ */
+type DbColumnType = 'decimal' | 'integer' | 'text' | 'boolean' | 'json' | 'timestamp' | 'uuid' | 'markdown' | 'vector' | 'image' | 'audio' | 'video' | 'file';
 /**
  * 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

@@ -21,4 +21,5 @@ export { TIER_ORDER, ROLE_ORDER } from './plugin/module/PluginModule';
 export type { SharedContent, BasicSharedContent, ContentStatus } from './plugin/module/SharedContentController';
 export type { MacroAccomplishmentPayload, MicroAccomplishmentPayload } from './controller/AccomplishmentController';
 export { StorageModule } from './plugin/module/StorageModule';
+export { AssetsModule, type AssetKind } from './plugin/module/AssetsModule';
 export type { PublicityLevel } from './plugin/module/DbModule';

package/dist/index.js

@@ -13,3 +13,4 @@ export { AudioController } from './controller/AudioController';
 export { Translator } from './controller/TranslationController';
 export { TIER_ORDER, ROLE_ORDER } from './plugin/module/PluginModule';
 export { StorageModule } from './plugin/module/StorageModule';
+export { AssetsModule } from './plugin/module/AssetsModule';

package/dist/plugin/RimoriClient.d.ts

@@ -6,6 +6,7 @@ import { EventModule } from './module/EventModule';
 import { AIModule } from './module/AIModule';
 import { ExerciseModule } from './module/ExerciseModule';
 import { StorageModule } from './module/StorageModule';
+import { AssetsModule } from './module/AssetsModule';
 import { EventBusHandler } from '../fromRimori/EventBus';
 export declare class RimoriClient {
     private static instance;
@@ -18,6 +19,8 @@ export declare class RimoriClient {
     exercise: ExerciseModule;
     /** Upload and manage images stored in Supabase via the backend. */
     storage: StorageModule;
+    /** Upload assets (image/audio/video/file) backing asset-typed db.config columns. */
+    assets: AssetsModule;
     /** The EventBus instance used by this client. In federation mode this is a per-plugin instance. */
     eventBus: EventBusHandler;
     private constructor();

package/dist/plugin/RimoriClient.js

@@ -7,6 +7,7 @@ import { EventModule } from './module/EventModule';
 import { AIModule } from './module/AIModule';
 import { ExerciseModule } from './module/ExerciseModule';
 import { StorageModule } from './module/StorageModule';
+import { AssetsModule } from './module/AssetsModule';
 import { PostgrestClient } from '@supabase/postgrest-js';
 import { EventBus, EventBusHandler } from '../fromRimori/EventBus';
 export class RimoriClient {
@@ -20,6 +21,8 @@ export class RimoriClient {
     exercise;
     /** Upload and manage images stored in Supabase via the backend. */
     storage;
+    /** Upload assets (image/audio/video/file) backing asset-typed db.config columns. */
+    assets;
     /** The EventBus instance used by this client. In federation mode this is a per-plugin instance. */
     eventBus;
     constructor(controller, supabase, info, eventBus) {
@@ -35,6 +38,7 @@ export class RimoriClient {
         this.plugin = new PluginModule(supabase, controller, info, this.ai);
         this.exercise = new ExerciseModule(supabase, controller, info, this.event);
         this.storage = new StorageModule(controller);
+        this.assets = new AssetsModule(controller);
         //only init logger in workers and on main plugin pages
         if (this.plugin.applicationMode !== 'sidebar') {
             Logger.getInstance(this);

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

@@ -0,0 +1,41 @@
+/**
+ * Assets module for the `plugin-assets` Supabase bucket.
+ *
+ * Use this to upload files (image|audio|video|file) whose URL is stored in a
+ * matching `type: 'image' | 'audio' | 'video' | 'file'` column in db.config.ts.
+ *
+ * Lifecycle is automatic: the backend asset-refs cron links the upload to the
+ * row whose column value matches the returned URL (within ~30 minutes), and
+ * deletes the file when the row is removed or the column is replaced/cleared.
+ * No plugin-side confirm or delete call is needed.
+ *
+ * For markdown editor images (embedded as `![](url)` in markdown text), use
+ * `plugin.storage.uploadImage` instead — that has a different lifecycle (regex
+ * scan over markdown bodies) and lives in the separate `plugin-images` bucket.
+ */
+import { RimoriCommunicationHandler } from '../CommunicationHandler';
+export type AssetKind = 'image' | 'audio' | 'video' | 'file';
+export declare class AssetsModule {
+    private readonly controller;
+    constructor(controller: RimoriCommunicationHandler);
+    /**
+     * Upload a blob as an asset of the given kind.
+     *
+     * @returns `{ data: { url, path } }` on success, `{ error }` on failure.
+     *   Store `url` in the matching asset-typed column on your row. The cron
+     *   will pick it up on the next tick and confirm the ref.
+     */
+    upload(blob: Blob, options: {
+        kind: AssetKind;
+        filename?: string;
+    }): Promise<{
+        data: {
+            url: string;
+            path: string;
+        };
+        error?: undefined;
+    } | {
+        data?: undefined;
+        error: Error;
+    }>;
+}

package/dist/plugin/module/AssetsModule.js

@@ -0,0 +1,34 @@
+export class AssetsModule {
+    controller;
+    constructor(controller) {
+        this.controller = controller;
+    }
+    /**
+     * Upload a blob as an asset of the given kind.
+     *
+     * @returns `{ data: { url, path } }` on success, `{ error }` on failure.
+     *   Store `url` in the matching asset-typed column on your row. The cron
+     *   will pick it up on the next tick and confirm the ref.
+     */
+    async upload(blob, options) {
+        const formData = new FormData();
+        const filename = options.filename ?? `asset.${options.kind}`;
+        formData.append('file', blob, filename);
+        formData.append('kind', options.kind);
+        try {
+            const response = await this.controller.fetchBackend('/plugin-assets/upload', {
+                method: 'POST',
+                body: formData,
+            });
+            if (!response.ok) {
+                const body = (await response.json().catch(() => ({})));
+                return { error: new Error(body.message ?? `Upload failed (${response.status})`) };
+            }
+            const result = (await 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.36",
+  "version": "2.5.37-next.1",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "repository": {