lumiverse-spindle-types 0.4.33 → 0.4.35

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lumiverse-spindle-types",
-  "version": "0.4.33",
+  "version": "0.4.35",
   "types": "./src/index.ts",
   "keywords": [
     "lumiverse",

package/src/api.ts

@@ -1280,10 +1280,20 @@ export type WorkerToHost =
   | { type: "frontend_message"; payload: unknown; userId?: string }
   | { type: "user_storage_read"; requestId: string; path: string; userId?: string }
   | { type: "user_storage_write"; requestId: string; path: string; data: string; userId?: string }
+  | { type: "user_storage_read_binary"; requestId: string; path: string; userId?: string }
+  | {
+      type: "user_storage_write_binary";
+      requestId: string;
+      path: string;
+      data: Uint8Array;
+      userId?: string;
+    }
   | { type: "user_storage_delete"; requestId: string; path: string; userId?: string }
   | { type: "user_storage_list"; requestId: string; prefix?: string; userId?: string }
   | { type: "user_storage_exists"; requestId: string; path: string; userId?: string }
   | { type: "user_storage_mkdir"; requestId: string; path: string; userId?: string }
+  | { type: "user_storage_move"; requestId: string; from: string; to: string; userId?: string }
+  | { type: "user_storage_stat"; requestId: string; path: string; userId?: string }
   | { type: "enclave_put"; requestId: string; key: string; value: string; userId?: string }
   | { type: "enclave_get"; requestId: string; key: string; userId?: string }
   | { type: "enclave_delete"; requestId: string; key: string; userId?: string }
@@ -1356,7 +1366,7 @@ export type WorkerToHost =
   // ─── Chat Memories (gated: "chats") ───────────────────────────────
   | { type: "chats_get_memories"; requestId: string; chatId: string; topK?: number; userId?: string }
   // ─── Toast (free tier) ───────────────────────────────────────────────
-  | { type: "toast_show"; toastType: "success" | "warning" | "error" | "info"; message: string; title?: string; duration?: number }
+  | { type: "toast_show"; toastType: "success" | "warning" | "error" | "info"; message: string; title?: string; duration?: number; userId?: string }
   // ─── Push Notifications (gated: "push_notification") ────────────────
   | { type: "push_send"; requestId: string; title: string; body: string; tag?: string; url?: string; userId?: string; icon?: string; rawTitle?: boolean; image?: string }
   | { type: "push_get_status"; requestId: string; userId?: string }

package/src/spindle-api.ts

@@ -57,13 +57,13 @@ import type {
 
 /** The global `spindle` object available in backend extension workers */
 export interface SpindleAPI {
-  /** Subscribe to generation-started events (requires `generation` permission). */
+  /** Subscribe to generation-started events (requires `generation` permission). The optional `userId` identifies which user triggered the event. */
   on(event: "GENERATION_STARTED", handler: (payload: GenerationStartedPayloadDTO, userId?: string) => void): () => void;
-  /** Subscribe to streamed token events (requires `generation` permission). */
+  /** Subscribe to streamed token events (requires `generation` permission). The optional `userId` identifies which user triggered the event. */
   on(event: "STREAM_TOKEN_RECEIVED", handler: (payload: StreamTokenPayloadDTO, userId?: string) => void): () => void;
-  /** Subscribe to generation-ended events (requires `generation` permission). */
+  /** Subscribe to generation-ended events (requires `generation` permission). The optional `userId` identifies which user triggered the event. */
   on(event: "GENERATION_ENDED", handler: (payload: GenerationEndedPayloadDTO, userId?: string) => void): () => void;
-  /** Subscribe to generation-stopped events (requires `generation` permission). */
+  /** Subscribe to generation-stopped events (requires `generation` permission). The optional `userId` identifies which user triggered the event. */
   on(event: "GENERATION_STOPPED", handler: (payload: GenerationStoppedPayloadDTO, userId?: string) => void): () => void;
   /**
    * Subscribe to swipe lifecycle events. The payload's `action` discriminator
@@ -95,7 +95,7 @@ export interface SpindleAPI {
     event: "TOOL_INVOCATION",
     handler: (payload: ToolInvocationPayloadDTO) => string | Promise<string> | void | Promise<void>
   ): () => void;
-  /** Subscribe to a Lumiverse event. */
+  /** Subscribe to a Lumiverse event. Multi-user extensions should use the optional `userId` to keep per-user state and notifications isolated. */
   on(event: string, handler: (payload: unknown, userId?: string) => void): () => void;
 
   /** Register a macro. Handler contexts expose `commit === false` during dry resolves. */
@@ -255,10 +255,20 @@ export interface SpindleAPI {
   userStorage: {
     read(path: string, userId?: string): Promise<string>;
     write(path: string, data: string, userId?: string): Promise<void>;
+    readBinary(path: string, userId?: string): Promise<Uint8Array>;
+    writeBinary(path: string, data: Uint8Array, userId?: string): Promise<void>;
     delete(path: string, userId?: string): Promise<void>;
     list(prefix?: string, userId?: string): Promise<string[]>;
     exists(path: string, userId?: string): Promise<boolean>;
     mkdir(path: string, userId?: string): Promise<void>;
+    move(from: string, to: string, userId?: string): Promise<void>;
+    stat(path: string, userId?: string): Promise<{
+      exists: boolean;
+      isFile: boolean;
+      isDirectory: boolean;
+      sizeBytes: number;
+      modifiedAt: string;
+    }>;
     getJson<T>(path: string, options?: { fallback?: T; userId?: string }): Promise<T>;
     setJson(path: string, value: unknown, options?: { indent?: number; userId?: string }): Promise<void>;
   };
@@ -698,6 +708,8 @@ export interface SpindleAPI {
     /**
      * Send a push notification to a user's registered devices.
      * Only delivered when the app is not focused (avoids double-notification).
+     * Operator-scoped extensions should pass the `userId` from the triggering
+     * frontend message or event handler to avoid cross-user delivery.
      */
     send(input: {
       title: string;
@@ -800,10 +812,10 @@ export interface SpindleAPI {
 
   /** Show toast notifications in the frontend UI (free tier — no permission needed) */
   toast: {
-    success(message: string, options?: { title?: string; duration?: number }): void;
-    warning(message: string, options?: { title?: string; duration?: number }): void;
-    error(message: string, options?: { title?: string; duration?: number }): void;
-    info(message: string, options?: { title?: string; duration?: number }): void;
+    success(message: string, options?: { title?: string; duration?: number; /** For operator-scoped extensions only. */ userId?: string }): void;
+    warning(message: string, options?: { title?: string; duration?: number; /** For operator-scoped extensions only. */ userId?: string }): void;
+    error(message: string, options?: { title?: string; duration?: number; /** For operator-scoped extensions only. */ userId?: string }): void;
+    info(message: string, options?: { title?: string; duration?: number; /** For operator-scoped extensions only. */ userId?: string }): void;
   };
 
   /** OAuth callback handling (permission: "oauth") */