lumiverse-spindle-types 0.5.26 → 0.5.28

package/package.json

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

package/src/api.ts

@@ -1353,6 +1353,23 @@ export interface PersonaUpdateDTO {
   metadata?: Record<string, unknown>;
 }
 
+export interface GlobalAddonDTO {
+  id: string;
+  label: string;
+  content: string;
+  sort_order: number;
+  metadata: Record<string, unknown>;
+  created_at: number;
+  updated_at: number;
+}
+
+export interface GlobalAddonUpdateDTO {
+  label?: string;
+  content?: string;
+  sort_order?: number;
+  metadata?: Record<string, unknown>;
+}
+
 // ─── Activated World Info DTOs ─────────────────────────────────────────
 
 /**
@@ -2683,6 +2700,10 @@ export type WorkerToHost =
   | { type: "personas_delete"; requestId: string; personaId: string; userId?: string }
   | { type: "personas_switch"; requestId: string; personaId: string | null; userId?: string }
   | { type: "personas_get_world_book"; requestId: string; personaId: string; userId?: string }
+  // ─── Global Add-ons (gated: "personas") ──────────────────────────
+  | { type: "global_addons_list"; requestId: string; limit?: number; offset?: number; userId?: string }
+  | { type: "global_addons_get"; requestId: string; addonId: string; userId?: string }
+  | { type: "global_addons_update"; requestId: string; addonId: string; input: GlobalAddonUpdateDTO; userId?: string }
   // ─── Council (free tier, read-only) ──────────────────────────────
   | { type: "council_get_settings"; requestId: string; userId?: string }
   | { type: "council_get_members"; requestId: string; userId?: string }

package/src/dom.ts

@@ -151,6 +151,57 @@ export interface SpindleDrawerTabHandle {
   onActivate(handler: () => void): () => void;
 }
 
+// ── Character Editor Tab ──
+
+export interface SpindleCharacterEditorTabOptions {
+  /** Unique tab identifier within the current extension. */
+  id: string;
+  /** Label shown in the character editor tab bar. */
+  title: string;
+}
+
+export interface SpindleCharacterEditorTabHandle {
+  root: HTMLElement;
+  tabId: string;
+  setTitle(title: string): void;
+  activate(): void;
+  destroy(): void;
+  /** Register a callback fired when the active character-editor tab switches to this tab. */
+  onActivate(handler: () => void): () => void;
+}
+
+export interface SpindleCharacterEditorState {
+  /** Whether the character editor modal is currently open. */
+  open: boolean;
+  /** Character currently being edited, or `null` when the modal is closed. */
+  characterId: string | null;
+  /** Active built-in or extension tab id inside the editor modal. */
+  activeTabId: string | null;
+  /** Current draft extensions blob visible to the editor. */
+  extensions: Record<string, any>;
+}
+
+export interface SpindleCharacterEditorSaveOptions {
+  /** Persist immediately instead of using the host's debounced save path. */
+  immediate?: boolean;
+}
+
+export interface SpindleCharacterEditorHelper {
+  /** Read the current editor snapshot. */
+  getState(): SpindleCharacterEditorState;
+  /** Subscribe to editor open/close, tab, character, and extensions changes. */
+  onChange(handler: (state: SpindleCharacterEditorState) => void): () => void;
+  /** Replace the draft extensions object shown in the editor. */
+  setExtensions(extensions: Record<string, any>, options?: SpindleCharacterEditorSaveOptions): void;
+  /** Atomically derive the next draft extensions object from the current one. */
+  updateExtensions(
+    mutator: (extensions: Record<string, any>) => Record<string, any>,
+    options?: SpindleCharacterEditorSaveOptions,
+  ): void;
+  /** Immediately persist any pending draft extension changes. */
+  flush(): Promise<void>;
+}
+
 // ── Float Widget ──
 
 export interface SpindleFloatWidgetOptions {
@@ -711,6 +762,8 @@ export interface SpindleFrontendContext {
     events: SpindleUIEventsHelper;
     mount(point: SpindleMountPoint): Element;
     registerDrawerTab(options: SpindleDrawerTabOptions): SpindleDrawerTabHandle;
+    registerCharacterEditorTab(options: SpindleCharacterEditorTabOptions): SpindleCharacterEditorTabHandle;
+    characterEditor: SpindleCharacterEditorHelper;
     createFloatWidget(options?: SpindleFloatWidgetOptions): SpindleFloatWidgetHandle;
     requestDockPanel(options: SpindleDockPanelOptions): SpindleDockPanelHandle;
     mountApp(options?: SpindleAppMountOptions): SpindleAppMountHandle;

package/src/index.ts

@@ -94,6 +94,8 @@ export type {
   DatabankDocumentCreateDTO,
   DatabankDocumentUpdateDTO,
   PersonaDTO,
+  GlobalAddonDTO,
+  GlobalAddonUpdateDTO,
   LumiaItemDTO,
   PersonaCreateDTO,
   PersonaUpdateDTO,
@@ -193,6 +195,11 @@ export type {
   SpindleFrontendModule,
   SpindleDrawerTabOptions,
   SpindleDrawerTabHandle,
+  SpindleCharacterEditorTabOptions,
+  SpindleCharacterEditorTabHandle,
+  SpindleCharacterEditorState,
+  SpindleCharacterEditorSaveOptions,
+  SpindleCharacterEditorHelper,
   SpindleFloatWidgetOptions,
   SpindleFloatWidgetHandle,
   SpindleDockEdge,

package/src/spindle-api.ts

@@ -47,6 +47,8 @@ import type {
   DatabankDocumentCreateDTO,
   DatabankDocumentUpdateDTO,
   PersonaDTO,
+  GlobalAddonDTO,
+  GlobalAddonUpdateDTO,
   LumiaItemDTO,
   PersonaCreateDTO,
   PersonaUpdateDTO,
@@ -1163,6 +1165,12 @@ export interface SpindleAPI {
     getWorldBook(personaId: string, userId?: string): Promise<WorldBookDTO | null>;
   };
 
+  global_addons: {
+    list(options?: { limit?: number; offset?: number; userId?: string }): Promise<{ data: GlobalAddonDTO[]; total: number }>;
+    get(addonId: string, userId?: string): Promise<GlobalAddonDTO | null>;
+    update(addonId: string, input: GlobalAddonUpdateDTO, userId?: string): Promise<GlobalAddonDTO>;
+  };
+
   permissions: {
     getGranted(): Promise<string[]>;
     /**