@volter/editor-sdk 0.5.58 → 0.5.60

package/package.json

@@ -2,7 +2,7 @@
   "name": "@volter/editor-sdk",
   "author": "Volter AI, Inc.",
   "license": "Apache-2.0",
-  "version": "0.5.58",
+  "version": "0.5.60",
   "publishConfig": {
     "access": "public"
   },
@@ -70,7 +70,7 @@
     "typescript": "^5.6.0",
     "undici": "^7.28.0",
     "zod": "^4.3.6",
-    "@volter/editor-project": "0.5.58",
+    "@volter/editor-project": "0.5.60",
     "@types/node": "^22.0.0"
   },
   "peerDependencies": {

package/src/client.ts

@@ -471,6 +471,11 @@ export class EditorClient {
     await this.command({ type: 'play' });
   }
 
+  /** Refuse shutdown if a document cannot be saved. Does not stop the server. */
+  async prepareClose(): Promise<void> {
+    await this.command({ type: 'session-prepare-close' });
+  }
+
   /** Stops play, and finalizes this run's recording before the surface it was
    *  photographing is torn down. The capture is absent when nothing recorded. */
   async stop(): Promise<{ recording?: GameplayRecordingCapture }> {

package/src/host.ts

@@ -563,6 +563,9 @@ export interface EditorHostSession {
    * A lane that owns a worker, a socket or a device ends it here.
    */
   onEnded(fn: () => void): () => void;
+  /** Save before an explicit session close, while HTTP and the relay are live.
+   * Rejection cancels close; onEnded remains forced resource teardown. */
+  onBeforeClose(fn: () => Promise<void>): () => void;
   /**
    * PUBLISH (or retract, with null) THIS LANE'S OUT-OF-PROCESS WORKER METER, so
    * the tab census carries it out on the heartbeat — the one channel that still

package/src/session/command-table.ts

@@ -114,6 +114,7 @@ const alwaysRefresh = (timeoutMs = DEFAULT_RELAY_COMMAND_TIMEOUT_MS): RelayComma
  * Rows without an explicit budget take {@link DEFAULT_RELAY_COMMAND_TIMEOUT_MS}.
  */
 export const RELAY_COMMANDS = {
+  'session-prepare-close': noDerivedRefresh(120_000),
   // ---- Selection and framing ---------------------------------------------
   select: noDerivedRefresh(30_000),
   'select-multiple': noDerivedRefresh(),