lumiverse-spindle-types 0.4.41 → 0.4.43

package/package.json

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

package/src/api.ts

@@ -579,6 +579,71 @@ export interface WorldBookEntryCreateDTO {
 
 export type WorldBookEntryUpdateDTO = WorldBookEntryCreateDTO;
 
+// ─── Databank DTOs ───────────────────────────────────────────────────────
+
+export type DatabankScopeDTO = "global" | "character" | "chat";
+export type DatabankDocumentStatusDTO = "pending" | "processing" | "ready" | "error";
+
+/** Safe representation of a databank exposed to extensions. */
+export interface DatabankDTO {
+  id: string;
+  name: string;
+  description: string;
+  scope: DatabankScopeDTO;
+  scope_id: string | null;
+  enabled: boolean;
+  metadata: Record<string, unknown>;
+  document_count?: number;
+  created_at: number;
+  updated_at: number;
+}
+
+export interface DatabankCreateDTO {
+  name: string;
+  description?: string;
+  scope: DatabankScopeDTO;
+  scope_id?: string | null;
+}
+
+export interface DatabankUpdateDTO {
+  name?: string;
+  description?: string;
+  enabled?: boolean;
+}
+
+/** Safe representation of a databank document exposed to extensions. */
+export interface DatabankDocumentDTO {
+  id: string;
+  databank_id: string;
+  name: string;
+  slug: string;
+  mime_type: string;
+  file_size: number;
+  content_hash: string;
+  total_chunks: number;
+  status: DatabankDocumentStatusDTO;
+  error_message: string | null;
+  metadata: Record<string, unknown>;
+  created_at: number;
+  updated_at: number;
+}
+
+export interface DatabankDocumentCreateDTO {
+  /** Raw file bytes. */
+  data: Uint8Array;
+  /** Original filename including extension. */
+  filename: string;
+  /** Optional MIME type recorded on the document. */
+  mime_type?: string;
+  /** Optional display name override. Defaults to the filename without extension. */
+  name?: string;
+}
+
+export interface DatabankDocumentUpdateDTO {
+  /** Renames the document display name (and derived slug). */
+  name: string;
+}
+
 // ─── Persona DTOs ──────────────────────────────────────────────────────
 
 /**
@@ -1528,6 +1593,20 @@ export type WorkerToHost =
   | { type: "world_book_entries_create"; requestId: string; worldBookId: string; input: WorldBookEntryCreateDTO; userId?: string }
   | { type: "world_book_entries_update"; requestId: string; entryId: string; input: WorldBookEntryUpdateDTO; userId?: string }
   | { type: "world_book_entries_delete"; requestId: string; entryId: string; userId?: string }
+  // ─── Databanks (gated: "databanks") ───────────────────────────────────
+  | { type: "databanks_list"; requestId: string; limit?: number; offset?: number; scope?: DatabankScopeDTO; scopeId?: string | null; userId?: string }
+  | { type: "databanks_get"; requestId: string; databankId: string; userId?: string }
+  | { type: "databanks_create"; requestId: string; input: DatabankCreateDTO; userId?: string }
+  | { type: "databanks_update"; requestId: string; databankId: string; input: DatabankUpdateDTO; userId?: string }
+  | { type: "databanks_delete"; requestId: string; databankId: string; userId?: string }
+  // ─── Databank Documents (gated: "databanks") ─────────────────────────
+  | { type: "databank_documents_list"; requestId: string; databankId: string; limit?: number; offset?: number; userId?: string }
+  | { type: "databank_documents_get"; requestId: string; documentId: string; userId?: string }
+  | { type: "databank_documents_create"; requestId: string; databankId: string; input: DatabankDocumentCreateDTO; userId?: string }
+  | { type: "databank_documents_update"; requestId: string; documentId: string; input: DatabankDocumentUpdateDTO; userId?: string }
+  | { type: "databank_documents_delete"; requestId: string; documentId: string; userId?: string }
+  | { type: "databank_documents_get_content"; requestId: string; documentId: string; userId?: string }
+  | { type: "databank_documents_reprocess"; requestId: string; documentId: string; userId?: string }
   // ─── Personas (gated: "personas") ────────────────────────────────────
   | { type: "personas_list"; requestId: string; limit?: number; offset?: number; userId?: string }
   | { type: "personas_get"; requestId: string; personaId: string; userId?: string }

package/src/dom.ts

@@ -87,6 +87,8 @@ export interface SpindleFloatWidgetHandle {
   widgetId: string;
   moveTo(x: number, y: number): void;
   getPosition(): { x: number; y: number };
+  /** Update the widget's rendered width/height in the host container. */
+  setSize(width: number, height: number): void;
   setVisible(visible: boolean): void;
   isVisible(): boolean;
   /** Toggle fullscreen mode. When enabled the host resizes the widget to

package/src/index.ts

@@ -41,6 +41,14 @@ export type {
   WorldBookEntryDTO,
   WorldBookEntryCreateDTO,
   WorldBookEntryUpdateDTO,
+  DatabankScopeDTO,
+  DatabankDocumentStatusDTO,
+  DatabankDTO,
+  DatabankCreateDTO,
+  DatabankUpdateDTO,
+  DatabankDocumentDTO,
+  DatabankDocumentCreateDTO,
+  DatabankDocumentUpdateDTO,
   PersonaDTO,
   LumiaItemDTO,
   PersonaCreateDTO,

package/src/permissions.ts

@@ -13,6 +13,7 @@
  * - "characters"           — CRUD on character cards
  * - "chats"                — CRUD on chat sessions
  * - "personas"             — CRUD on personas
+ * - "databanks"            — CRUD on databanks and their documents
  * - "macro_interceptor"    — transform raw templates before macro parsing/dispatch
  */
 export type SpindlePermission =
@@ -30,6 +31,7 @@ export type SpindlePermission =
   | "characters"
   | "chats"
   | "world_books"
+  | "databanks"
   | "personas"
   | "push_notification"
   | "image_gen"
@@ -51,6 +53,7 @@ export const ALL_PERMISSIONS: readonly SpindlePermission[] = [
   "characters",
   "chats",
   "world_books",
+  "databanks",
   "personas",
   "push_notification",
   "image_gen",

package/src/spindle-api.ts

@@ -27,6 +27,12 @@ import type {
   WorldBookEntryDTO,
   WorldBookEntryCreateDTO,
   WorldBookEntryUpdateDTO,
+  DatabankDTO,
+  DatabankCreateDTO,
+  DatabankUpdateDTO,
+  DatabankDocumentDTO,
+  DatabankDocumentCreateDTO,
+  DatabankDocumentUpdateDTO,
   PersonaDTO,
   LumiaItemDTO,
   PersonaCreateDTO,
@@ -630,6 +636,27 @@ export interface SpindleAPI {
     getActivated(chatId: string, userId?: string): Promise<ActivatedWorldInfoEntryDTO[]>;
   };
 
+  /**
+   * Databank CRUD (permission: "databanks").
+   * Manage databanks plus the documents they contain.
+   */
+  databanks: {
+    list(options?: { limit?: number; offset?: number; scope?: "global" | "character" | "chat"; scopeId?: string | null; userId?: string }): Promise<{ data: DatabankDTO[]; total: number }>;
+    get(databankId: string, userId?: string): Promise<DatabankDTO | null>;
+    create(input: DatabankCreateDTO, userId?: string): Promise<DatabankDTO>;
+    update(databankId: string, input: DatabankUpdateDTO, userId?: string): Promise<DatabankDTO>;
+    delete(databankId: string, userId?: string): Promise<boolean>;
+    documents: {
+      list(databankId: string, options?: { limit?: number; offset?: number; userId?: string }): Promise<{ data: DatabankDocumentDTO[]; total: number }>;
+      get(documentId: string, userId?: string): Promise<DatabankDocumentDTO | null>;
+      create(databankId: string, input: DatabankDocumentCreateDTO, userId?: string): Promise<DatabankDocumentDTO>;
+      update(documentId: string, input: DatabankDocumentUpdateDTO, userId?: string): Promise<DatabankDocumentDTO>;
+      delete(documentId: string, userId?: string): Promise<boolean>;
+      getContent(documentId: string, userId?: string): Promise<{ content: string } | null>;
+      reprocess(documentId: string, userId?: string): Promise<{ success: true; status: "processing" }>;
+    };
+  };
+
   /**
    * Personas CRUD (permission: "personas").
    * Manage user personas (identity profiles).