lumiverse-spindle-types 0.4.53 → 0.4.54

package/package.json

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

package/src/api.ts

@@ -374,6 +374,29 @@ export interface ImageGenResultDTO {
   imageUrl?: string;
 }
 
+// ─── Image DTOs ─────────────────────────────────────────────────────────
+
+/** Safe representation of an image exposed to extensions. */
+export interface ImageDTO {
+  id: string;
+  original_filename: string;
+  mime_type: string;
+  width: number | null;
+  height: number | null;
+  has_thumbnail: boolean;
+  created_at: number;
+}
+
+/** Upload payload for `spindle.images.upload()` */
+export interface ImageUploadDTO {
+  /** Raw image bytes. */
+  data: Uint8Array;
+  /** Optional filename used to preserve the extension/MIME when storing the image. */
+  filename?: string;
+  /** Optional content type. Defaults to image/png when not inferable. */
+  mime_type?: string;
+}
+
 // ─── Character DTOs ─────────────────────────────────────────────────────
 
 /**
@@ -1854,6 +1877,12 @@ export type WorkerToHost =
   | { type: "image_gen_connections_list"; requestId: string; userId?: string }
   | { type: "image_gen_connections_get"; requestId: string; connectionId: string; userId?: string }
   | { type: "image_gen_models"; requestId: string; connectionId: string; userId?: string }
+  // ─── Images (gated: "images") ────────────────────────────────────────
+  | { type: "images_list"; requestId: string; limit?: number; offset?: number; userId?: string }
+  | { type: "images_get"; requestId: string; imageId: string; userId?: string }
+  | { type: "images_upload"; requestId: string; input: ImageUploadDTO; userId?: string }
+  | { type: "images_upload_from_data_url"; requestId: string; dataUrl: string; originalFilename?: string; userId?: string }
+  | { type: "images_delete"; requestId: string; imageId: string; userId?: string }
   // ─── Theme (gated: "app_manipulation") ──────────────────────────────────
   | { type: "theme_apply"; requestId: string; overrides: ThemeOverrideDTO; userId?: string }
   | { type: "theme_apply_palette"; requestId: string; palette: ThemePaletteConfigDTO | null; userId?: string }

package/src/index.ts

@@ -63,12 +63,14 @@ export type {
   DryRunTokenCountDTO,
   ChatMemoryChunkDTO,
   ChatMemoryResultDTO,
-  ImageGenConnectionDTO,
-  ImageGenParameterSchemaDTO,
-  ImageGenProviderDTO,
-  ImageGenRequestDTO,
-  ImageGenResultDTO,
-  ThemeOverrideDTO,
+   ImageGenConnectionDTO,
+   ImageGenParameterSchemaDTO,
+   ImageGenProviderDTO,
+   ImageGenRequestDTO,
+   ImageGenResultDTO,
+   ImageDTO,
+   ImageUploadDTO,
+   ThemeOverrideDTO,
   ThemeInfoDTO,
   ThemePaletteConfigDTO,
   ThemeVariablesConfigDTO,

package/src/permissions.ts

@@ -35,6 +35,7 @@ export type SpindlePermission =
   | "personas"
   | "push_notification"
   | "image_gen"
+  | "images"
   | "generation_parameters"
   | "macro_interceptor";
 
@@ -57,6 +58,7 @@ export const ALL_PERMISSIONS: readonly SpindlePermission[] = [
   "personas",
   "push_notification",
   "image_gen",
+  "images",
   "generation_parameters",
   "macro_interceptor",
 ] as const;

package/src/spindle-api.ts

@@ -45,6 +45,8 @@ import type {
   ImageGenResultDTO,
   ImageGenConnectionDTO,
   ImageGenProviderDTO,
+  ImageDTO,
+  ImageUploadDTO,
   ThemeOverrideDTO,
   ThemeInfoDTO,
   ThemePaletteConfigDTO,
@@ -633,6 +635,20 @@ export interface SpindleAPI {
     getModels(connectionId: string, userId?: string): Promise<Array<{ id: string; label: string }>>;
   };
 
+  /**
+   * Image CRUD (permission: "images").
+   * Manage images stored in Lumiverse's image system on behalf of the user.
+   * For user-scoped extensions, userId is inferred from the extension owner.
+   * For operator-scoped extensions, pass userId to scope to a specific user.
+   */
+  images: {
+    list(options?: { limit?: number; offset?: number; userId?: string }): Promise<{ data: ImageDTO[]; total: number }>;
+    get(imageId: string, userId?: string): Promise<ImageDTO | null>;
+    upload(input: ImageUploadDTO, userId?: string): Promise<ImageDTO>;
+    uploadFromDataUrl(dataUrl: string, originalFilename?: string, userId?: string): Promise<ImageDTO>;
+    delete(imageId: string, userId?: string): Promise<boolean>;
+  };
+
   /**
    * Local (transient), global (user-scoped), and chat (persisted) variable access
    * (free tier — no permission needed).