lumiverse-spindle-types 0.4.51 → 0.4.53

package/package.json

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

package/src/api.ts

@@ -278,6 +278,9 @@ export interface RequestInitDTO {
   method?: string;
   headers?: Record<string, string>;
   body?: string;
+  /** When `"arraybuffer"`, the response body is returned as a base64-encoded string
+   *  with `encoding: "base64"`. Used by the sandboxed-widget transparent proxy. */
+  responseType?: "text" | "arraybuffer";
 }
 
 /**

package/src/dom.ts

@@ -1,3 +1,5 @@
+import type { RequestInitDTO } from "./api";
+
 /** DOM helper API provided to frontend extension modules. */
 export interface SpindleDOMHelper {
   /** Inject sanitized HTML into the host document at the given target. */
@@ -188,6 +190,15 @@ export interface SpindleSandboxFrameHandle {
   destroy(): void;
 }
 
+/** API exposed inside the sandboxed iframe as `window.spindleSandbox`. */
+export interface SpindleSandboxAPI {
+  postMessage(payload: unknown): void;
+  onMessage(handler: (payload: unknown) => void): () => void;
+  requestResize(height?: number): void;
+  /** Fetch a URL through the extension's CORS proxy. Requires the `cors_proxy` permission. */
+  corsProxy(url: string, options?: RequestInitDTO): Promise<unknown>;
+}
+
 export interface SpindleUploadFile {
   name: string;
   mimeType: string;

package/src/index.ts

@@ -142,6 +142,7 @@ export type {
    SpindleInputBarActionHandle,
    SpindleSandboxFrameOptions,
    SpindleSandboxFrameHandle,
+   SpindleSandboxAPI,
    SpindleContextMenuOptions,
    SpindleContextMenuItemDef,
    SpindleContextMenuResult,

package/src/spindle-api.ts

@@ -921,6 +921,8 @@ export interface SpindleAPI {
     list(filter?: FrontendProcessListOptionsDTO): Promise<FrontendProcessInfoDTO[]>;
     /** Get a single tracked process by ID. Returns `null` if it no longer exists. */
     get(processId: string): Promise<FrontendProcessInfoDTO | null>;
+    /** Send a message to a specific frontend process */
+    send(processId: string, payload: unknown, userId?: string): void;
     /** Request graceful termination of a tracked process. */
     stop(processId: string, options?: FrontendProcessStopOptionsDTO): Promise<void>;
     /** Subscribe to lifecycle transitions (`starting`, `running`, `timed_out`, etc.). */
@@ -951,6 +953,8 @@ export interface SpindleAPI {
     list(filter?: BackendProcessListOptionsDTO): Promise<BackendProcessInfoDTO[]>;
     /** Get a single tracked subprocess by ID. Returns `null` if it no longer exists. */
     get(processId: string): Promise<BackendProcessInfoDTO | null>;
+    /** Send a message to a specific backend process */
+    send(processId: string, payload: unknown, userId?: string): void;
     /** Request graceful termination of a tracked subprocess. */
     stop(processId: string, options?: BackendProcessStopOptionsDTO): Promise<void>;
     /** Subscribe to lifecycle transitions (`starting`, `running`, `timed_out`, etc.). */