@mengine/medeo-client 2.1.1-dsl.1 → 2.1.1-dsl.2

package/README.md

@@ -23,6 +23,20 @@ session.destroy();
 
 For explicit synchronization, use `ManualSyncDoc.open({client, peerId})`, then `pull()`, `editor`, `push()` and `dispose()`. Both lifecycles use the same binary snapshot/update and version-coverage contracts. Neither silently upgrades old documents or overwrites an incompatible cache.
 
+## Local persistence
+
+Browser hosts can inject `IndexedDBDocStorage` through `localStorage`. An optional `initialSnapshot` merges a freshly fetched server snapshot into that storage before DocManager loads it; it never replaces locally saved, unconfirmed edits. The host can require a successful online fetch before constructing the session.
+
+`getLocalSaveState()` / `subscribeLocalSaveState()` report `{ status: 'saving' | 'saved' | 'failed', error }` for this session's local commits. This is separate from `getSyncState()` and server confirmation. The storage adapter determines durability: IndexedDB resolves only after its transaction commits; MemoryDocStorage remains in memory. Failed saves retain their causal order and retry without blocking other documents.
+
+`waitForLocalSave({ timeoutMs? })` waits until the local save queue drains, including in-flight writes and edits made while waiting (default deadline: 15 seconds). Continuous editing may keep it pending. Timing out only stops the wait; persistence continues. This does not wait for server acknowledgement.
+
+For normal teardown, use `await session.close()`. It immediately rejects new edits and stops synchronization, then keeps local persistence alive until pending commits are saved before releasing connections. Storage failures remain retryable while closing. `destroy()` is immediate cancellation for exceptional teardown, including failed startup; it can discard unpersisted in-memory work. Neither API can guarantee a save after the browser process is forcibly terminated. Only completed local saves survive reopening.
+
+Edits received from another local-storage peer also remain unconfirmed until covered by an authoritative server version. Receiving a cross-tab notification is not a server acknowledgement.
+
+Reopening uses the stored Loro history and the server's version vector to derive missing updates, without replaying semantic operations or their external side effects. Undo history remains limited to the current session.
+
 ## Editing and conversion
 
 - Track: create, reorder, hide and delete.

package/dist/{index-B7fC7q7P.d.ts → index-D-3rdfUP.d.ts}

@@ -1,6 +1,6 @@
 import { M as DslDiagnostic, o as VideoDraftContent, p as CommitOptions } from "./video-draft-types-c_shaRyq.js";
 import { LoroDoc, PeerID, VersionVector } from "loro-crdt";
-import { DocState } from "@mengine/sync";
+import { DocState, LocalSaveState } from "@mengine/sync";
 import { BaseDocStorage, Connection, DocDiff, DocPushReceipt, DocSnapshotRecord, DocStorage, DocStorageOptions, DocUpdate, DocUpdateRecord } from "@mengine/storage";
 
 //#region src/client/base64.d.ts
@@ -532,13 +532,18 @@ declare class MengineAckFailedError extends Error {
   readonly cause: Error | undefined;
   constructor(reason: 'timeout' | 'rejected' | 'failed', code: string | undefined, cause: Error | undefined, message: string);
 }
+type MengineLocalSaveState = LocalSaveState;
+interface WaitForLocalSaveOptions {
+  /** Only limits waiting, never cancels persistence. */
+  timeoutMs?: number;
+}
 interface WaitForServerAckOptions {
   /** Deadline in ms. Rejects with reason `timeout` when it elapses. */
   timeoutMs?: number;
 }
 /** Document-level confirmation is independent of local operation completion. */
 interface MengineDocSyncState {
-  /** Remote-only imports do not create a new local confirmation obligation. */
+  /** Server-originated imports do not create a new local confirmation obligation. */
   readonly confirmation: 'unknown' | 'pending' | 'confirmed';
   /** Transport/activity phase. Idle does not imply confirmation; failure details
    * remain available through push outcomes and confirmation wait errors. */
@@ -553,6 +558,9 @@ interface MengineDocSessionOptions {
    * Browsers should pass an `IndexedDBDocStorage` for refresh/cross-tab support.
    */
   localStorage?: DocStorageLike;
+  /** A freshly fetched remote snapshot to merge into storage before loading.
+   * Existing local changes are retained; the host owns any online startup gate. */
+  initialSnapshot?: Uint8Array;
   sseReconnectDelayMs?: number;
   /**
    * Keep remote synchronization read-only: pull snapshot/diffs and subscribe to
@@ -587,6 +595,7 @@ declare class DocumentSession<Snapshot, Editor, Document> {
   private started;
   private startTask;
   private destroyed;
+  private closeTask;
   private lifetime;
   private hasConnected;
   private initialVersionValue;
@@ -687,7 +696,17 @@ declare class DocumentSession<Snapshot, Editor, Document> {
    */
   start(): Promise<Snapshot>;
   private open;
+  getLocalSaveState(): MengineLocalSaveState;
+  /** Immediately reports local transaction state; independent of server confirmation. */
+  subscribeLocalSaveState(cb: (state: MengineLocalSaveState) => void): () => void;
+  /** Waits until all local saves finish, including edits made while waiting. Does not wait for the network. */
+  waitForLocalSave(options?: WaitForLocalSaveOptions): Promise<void>;
+  /** Stop accepting edits and drain local persistence before releasing resources.
+   * A failed local write keeps retrying, even after the host has unmounted.
+   * Hosts should use this for normal teardown; destroy() is immediate cancellation. */
+  close(): Promise<void>;
   getSyncState(): MengineDocSyncState;
+  private trackLocalVersion;
   private confirmationTarget;
   /** Immediately supplies current state; unsubscribe when the host changes docs. */
   subscribeSyncState(cb: (state: MengineDocSyncState) => void): () => void;
@@ -725,4 +744,4 @@ declare class MemoryDocStorage extends BaseDocStorage {
   private now;
 }
 //#endregion
-export { MengineAuditResponse as A, base64ToBytes as B, MengineEventStreamOptions as C, MengineHttpRequestError as D, MengineHttpClientOptions as E, MengineRejectedResponse as F, MengineSnapshotResponse as I, MengineSseUpdateEvent as L, MengineDraftResponse as M, MenginePushResponse as N, MenginePushRejectedError as O, MenginePushUpdateResponse as P, MengineSyncResponse as R, PushResultKind as S, MengineHttpClient as T, bytesToBase64 as V, encodeDocVersionMark as _, MengineDocSessionOptions as a, PullResult as b, DocStorageLike as c, MedeoHttpDocStorageOptions as d, PushOutcome as f, decodeDocVersionMark as g, ManualSyncTransport as h, MengineAckFailedError as i, MengineDocumentVersion as j, MengineAuditEntry as k, MengineUndoState as l, ManualSyncDocOptions as m, DocumentSession as n, MengineDocSyncState as o, PushOutcomeKind as p, DocumentSessionUpdateEvent as r, WaitForServerAckOptions as s, MemoryDocStorage as t, MedeoHttpDocStorage as u, DocVersionMark as v, readMengineEventStream as w, PushResult as x, PullFailureReason as y, MengineUpdateMeta as z };
+export { MenginePushRejectedError as A, MengineSyncResponse as B, PushResult as C, MengineHttpClient as D, readMengineEventStream as E, MenginePushResponse as F, base64ToBytes as H, MenginePushUpdateResponse as I, MengineRejectedResponse as L, MengineAuditResponse as M, MengineDocumentVersion as N, MengineHttpClientOptions as O, MengineDraftResponse as P, MengineSnapshotResponse as R, PullResult as S, MengineEventStreamOptions as T, bytesToBase64 as U, MengineUpdateMeta as V, ManualSyncTransport as _, MengineDocSessionOptions as a, DocVersionMark as b, WaitForLocalSaveOptions as c, MengineUndoState as d, MedeoHttpDocStorage as f, ManualSyncDocOptions as g, PushOutcomeKind as h, MengineAckFailedError as i, MengineAuditEntry as j, MengineHttpRequestError as k, WaitForServerAckOptions as l, PushOutcome as m, DocumentSession as n, MengineDocSyncState as o, MedeoHttpDocStorageOptions as p, DocumentSessionUpdateEvent as r, MengineLocalSaveState as s, MemoryDocStorage as t, DocStorageLike as u, decodeDocVersionMark as v, PushResultKind as w, PullFailureReason as x, encodeDocVersionMark as y, MengineSseUpdateEvent as z };

package/dist/{index-yifEtZSP.d.ts → index-D-6uebu4.d.ts}

@@ -1,6 +1,6 @@
 import { G as ResourceSystem, et as TrackRole, z as MedeoDslSnapshot } from "./video-draft-types-c_shaRyq.js";
 import { _ as MedeoDsl, f as DslEditor, i as VideoDraftProjection } from "./index-Cu7SdKN5.js";
-import { a as MengineDocSessionOptions, h as ManualSyncTransport, m as ManualSyncDocOptions, n as DocumentSession, r as DocumentSessionUpdateEvent } from "./index-B7fC7q7P.js";
+import { _ as ManualSyncTransport, a as MengineDocSessionOptions, g as ManualSyncDocOptions, n as DocumentSession, r as DocumentSessionUpdateEvent } from "./index-D-3rdfUP.js";
 
 //#region src/manual-sync/manual-sync-doc.d.ts
 /** Explicit synchronization over the same DSL/editor used by the live Session. */

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { $ as Track, A as ContainNode, B as Media, C as Caption, D as CaptionText, E as CaptionStyle, F as EntityTable, G as ResourceSystem, H as RelationTable, I as EntityTables, J as TextEdit, K as RichTextSnapshot, L as EntityValues, M as DslDiagnostic, N as DslMutation, O as Clip, P as EntityMutation, Q as TimeAnchor, R as FieldPatch, S as AudioScript, T as CaptionSelection, U as RelationTables, V as RelationMutation, W as RelationValues, X as TextMutation, Y as TextMark, Z as TextRun, _ as defaultIdFactory, a as VideoDraftCaptionStyle, b as tupleHash, c as VideoDraftInput, d as VideoDraftTrack, et as TrackRole, f as VideoDraftTrackItem, g as EntityIdKind, h as DslIdFactory, i as VideoDraft, j as DeepReadonly, k as ContainMutation, l as VideoDraftPartUnion, m as OpActor, n as DEFAULT_UNIT_TIME_MS, o as VideoDraftContent, p as CommitOptions, q as TextDelta, r as VideoCreationSettings, s as VideoDraftContentPartUnion, t as CaptionDisplayCue, tt as Voice, u as VideoDraftTimeline, v as relationId, w as CaptionContent, x as Asset, y as resourceId, z as MedeoDslSnapshot } from "./video-draft-types-c_shaRyq.js";
 import { A as AddDslClip, C as MedeoDslDraft, D as captionContentCodec, E as InvalidAtomic, F as ReplaceDslClipsInput, I as ClipPlacement, M as ClipSource, N as DslClipUpdate, O as isInvalidAtomic, P as MoveDslClipsInput, S as documentFormat, T as medeoDslLoroShape, _ as MedeoDsl, a as toVideoDraft, b as UnsupportedDocumentFormatError, c as DslLayout, d as createInitialMedeoDsl, f as DslEditor, g as CreateMedeoDslOptions, h as VoiceoverResult, i as VideoDraftProjection, j as AddDslClipsInput, k as timeAnchorCodec, l as DslProjectionError, m as VoiceoverCaptionInput, n as ImportedVideoDraft, o as resolveDslLayout, p as ApplyVoiceoverInput, r as fromVideoDraft, s as DslClipLayout, t as FromVideoDraftOptions, u as DslTrackLayout, v as DslAudit, w as MedeoDslLoroState, x as assertDslDocument, y as DslTransaction } from "./index-Cu7SdKN5.js";
-import { A as MengineAuditResponse, B as base64ToBytes, C as MengineEventStreamOptions, D as MengineHttpRequestError, E as MengineHttpClientOptions, F as MengineRejectedResponse, I as MengineSnapshotResponse, L as MengineSseUpdateEvent, M as MengineDraftResponse, N as MenginePushResponse, O as MenginePushRejectedError, P as MenginePushUpdateResponse, R as MengineSyncResponse, S as PushResultKind, T as MengineHttpClient, V as bytesToBase64, _ as encodeDocVersionMark, a as MengineDocSessionOptions, b as PullResult, c as DocStorageLike, d as MedeoHttpDocStorageOptions, f as PushOutcome, g as decodeDocVersionMark, i as MengineAckFailedError, j as MengineDocumentVersion, k as MengineAuditEntry, l as MengineUndoState, m as ManualSyncDocOptions, o as MengineDocSyncState, p as PushOutcomeKind, s as WaitForServerAckOptions, t as MemoryDocStorage, u as MedeoHttpDocStorage, v as DocVersionMark, w as readMengineEventStream, x as PushResult, y as PullFailureReason, z as MengineUpdateMeta } from "./index-B7fC7q7P.js";
-import { n as MengineDocSessionUpdateEvent, r as ManualSyncDoc, t as MengineDocSession } from "./index-yifEtZSP.js";
-export { type AddDslClip, type AddDslClipsInput, type ApplyVoiceoverInput, type Asset, type AudioScript, type Caption, type CaptionContent, type CaptionDisplayCue, type CaptionSelection, type CaptionStyle, type CaptionText, type Clip, type ClipPlacement, type ClipSource, type CommitOptions, type ContainMutation, type ContainNode, type CreateMedeoDslOptions, DEFAULT_UNIT_TIME_MS, type DeepReadonly, type DocStorageLike, type DocVersionMark, type DslAudit, type DslClipLayout, type DslClipUpdate, type DslDiagnostic, DslEditor, type DslIdFactory, type DslLayout, type DslMutation, DslProjectionError, type DslTrackLayout, type DslTransaction, type EntityIdKind, type EntityMutation, type EntityTable, type EntityTables, type EntityValues, type FieldPatch, type FromVideoDraftOptions, type ImportedVideoDraft, type InvalidAtomic, ManualSyncDoc, type ManualSyncDocOptions, MedeoDsl, type MedeoDslDraft, type MedeoDslLoroState, type MedeoDslSnapshot, MedeoHttpDocStorage, type MedeoHttpDocStorageOptions, type Media, MemoryDocStorage, MengineAckFailedError, type MengineAuditEntry, type MengineAuditResponse, MengineDocSession, type MengineDocSessionOptions, type MengineDocSessionUpdateEvent, type MengineDocSyncState, type MengineDocumentVersion, type MengineDraftResponse, type MengineEventStreamOptions, MengineHttpClient, type MengineHttpClientOptions, MengineHttpRequestError, MenginePushRejectedError, type MenginePushResponse, type MenginePushUpdateResponse, type MengineRejectedResponse, type MengineSnapshotResponse, type MengineSseUpdateEvent, type MengineSyncResponse, type MengineUndoState, type MengineUpdateMeta, type MoveDslClipsInput, type OpActor, type PullFailureReason, type PullResult, type PushOutcome, type PushOutcomeKind, type PushResult, type PushResultKind, type RelationMutation, type RelationTable, type RelationTables, type RelationValues, type ReplaceDslClipsInput, type ResourceSystem, type RichTextSnapshot, type TextDelta, type TextEdit, type TextMark, type TextMutation, type TextRun, type TimeAnchor, type Track, type TrackRole, UnsupportedDocumentFormatError, type VideoCreationSettings, type VideoDraft, type VideoDraftCaptionStyle, type VideoDraftContent, type VideoDraftContentPartUnion, type VideoDraftInput, type VideoDraftPartUnion, type VideoDraftProjection, type VideoDraftTimeline, type VideoDraftTrack, type VideoDraftTrackItem, type Voice, type VoiceoverCaptionInput, type VoiceoverResult, type WaitForServerAckOptions, assertDslDocument, base64ToBytes, bytesToBase64, captionContentCodec, createInitialMedeoDsl, decodeDocVersionMark, defaultIdFactory, documentFormat, encodeDocVersionMark, fromVideoDraft, isInvalidAtomic, medeoDslLoroShape, readMengineEventStream, relationId, resolveDslLayout, resourceId, timeAnchorCodec, toVideoDraft, tupleHash };
+import { A as MenginePushRejectedError, B as MengineSyncResponse, C as PushResult, D as MengineHttpClient, E as readMengineEventStream, F as MenginePushResponse, H as base64ToBytes, I as MenginePushUpdateResponse, L as MengineRejectedResponse, M as MengineAuditResponse, N as MengineDocumentVersion, O as MengineHttpClientOptions, P as MengineDraftResponse, R as MengineSnapshotResponse, S as PullResult, T as MengineEventStreamOptions, U as bytesToBase64, V as MengineUpdateMeta, a as MengineDocSessionOptions, b as DocVersionMark, c as WaitForLocalSaveOptions, d as MengineUndoState, f as MedeoHttpDocStorage, g as ManualSyncDocOptions, h as PushOutcomeKind, i as MengineAckFailedError, j as MengineAuditEntry, k as MengineHttpRequestError, l as WaitForServerAckOptions, m as PushOutcome, o as MengineDocSyncState, p as MedeoHttpDocStorageOptions, s as MengineLocalSaveState, t as MemoryDocStorage, u as DocStorageLike, v as decodeDocVersionMark, w as PushResultKind, x as PullFailureReason, y as encodeDocVersionMark, z as MengineSseUpdateEvent } from "./index-D-3rdfUP.js";
+import { n as MengineDocSessionUpdateEvent, r as ManualSyncDoc, t as MengineDocSession } from "./index-D-6uebu4.js";
+export { type AddDslClip, type AddDslClipsInput, type ApplyVoiceoverInput, type Asset, type AudioScript, type Caption, type CaptionContent, type CaptionDisplayCue, type CaptionSelection, type CaptionStyle, type CaptionText, type Clip, type ClipPlacement, type ClipSource, type CommitOptions, type ContainMutation, type ContainNode, type CreateMedeoDslOptions, DEFAULT_UNIT_TIME_MS, type DeepReadonly, type DocStorageLike, type DocVersionMark, type DslAudit, type DslClipLayout, type DslClipUpdate, type DslDiagnostic, DslEditor, type DslIdFactory, type DslLayout, type DslMutation, DslProjectionError, type DslTrackLayout, type DslTransaction, type EntityIdKind, type EntityMutation, type EntityTable, type EntityTables, type EntityValues, type FieldPatch, type FromVideoDraftOptions, type ImportedVideoDraft, type InvalidAtomic, ManualSyncDoc, type ManualSyncDocOptions, MedeoDsl, type MedeoDslDraft, type MedeoDslLoroState, type MedeoDslSnapshot, MedeoHttpDocStorage, type MedeoHttpDocStorageOptions, type Media, MemoryDocStorage, MengineAckFailedError, type MengineAuditEntry, type MengineAuditResponse, MengineDocSession, type MengineDocSessionOptions, type MengineDocSessionUpdateEvent, type MengineDocSyncState, type MengineDocumentVersion, type MengineDraftResponse, type MengineEventStreamOptions, MengineHttpClient, type MengineHttpClientOptions, MengineHttpRequestError, type MengineLocalSaveState, MenginePushRejectedError, type MenginePushResponse, type MenginePushUpdateResponse, type MengineRejectedResponse, type MengineSnapshotResponse, type MengineSseUpdateEvent, type MengineSyncResponse, type MengineUndoState, type MengineUpdateMeta, type MoveDslClipsInput, type OpActor, type PullFailureReason, type PullResult, type PushOutcome, type PushOutcomeKind, type PushResult, type PushResultKind, type RelationMutation, type RelationTable, type RelationTables, type RelationValues, type ReplaceDslClipsInput, type ResourceSystem, type RichTextSnapshot, type TextDelta, type TextEdit, type TextMark, type TextMutation, type TextRun, type TimeAnchor, type Track, type TrackRole, UnsupportedDocumentFormatError, type VideoCreationSettings, type VideoDraft, type VideoDraftCaptionStyle, type VideoDraftContent, type VideoDraftContentPartUnion, type VideoDraftInput, type VideoDraftPartUnion, type VideoDraftProjection, type VideoDraftTimeline, type VideoDraftTrack, type VideoDraftTrackItem, type Voice, type VoiceoverCaptionInput, type VoiceoverResult, type WaitForLocalSaveOptions, type WaitForServerAckOptions, assertDslDocument, base64ToBytes, bytesToBase64, captionContentCodec, createInitialMedeoDsl, decodeDocVersionMark, defaultIdFactory, documentFormat, encodeDocVersionMark, fromVideoDraft, isInvalidAtomic, medeoDslLoroShape, readMengineEventStream, relationId, resolveDslLayout, resourceId, timeAnchorCodec, toVideoDraft, tupleHash };

package/dist/index.js

@@ -2,7 +2,7 @@ import { n as bytesToBase64, t as base64ToBytes } from "./base64-D-jd-dr5.js";
 import { a as covers, c as readMengineEventStream, d as MenginePushRejectedError, i as openManualDocument, l as MengineHttpClient, n as MedeoHttpDocStorage, o as decodeDocVersionMark, r as ManualSyncTransport, s as encodeDocVersionMark, t as MemoryDocStorage, u as MengineHttpRequestError } from "./storage-BW3tI_ER.js";
 import { a as documentFormat, c as isInvalidAtomic, ct as relationId, i as assertDslDocument, l as timeAnchorCodec, lt as resourceId, o as medeoDslLoroShape, r as UnsupportedDocumentFormatError, s as captionContentCodec, st as defaultIdFactory, t as DEFAULT_UNIT_TIME_MS, ut as tupleHash } from "./video-draft-types-TXRv3wS6.js";
 import { a as MedeoDsl, i as DslEditor, n as toVideoDraft, o as resolveDslLayout, r as createInitialMedeoDsl, s as DslProjectionError, t as fromVideoDraft } from "./dsl-EV6kCdr6.js";
-import { UndoManager, VersionVector } from "loro-crdt";
+import { UndoManager, VersionVector, decodeImportBlobMeta } from "loro-crdt";
 import { ClientServerSynchronizer, DocManager } from "@mengine/sync";
 import { DisposableSet, EventBus } from "@mengine/utils";
 //#region src/manual-sync/manual-sync-doc.ts
@@ -222,6 +222,7 @@ var DocumentSession = class {
 	started = false;
 	startTask = null;
 	destroyed = false;
+	closeTask = null;
 	lifetime = null;
 	hasConnected = false;
 	initialVersionValue = null;
@@ -438,6 +439,13 @@ var DocumentSession = class {
 		this.local.connection.connect();
 		await this.local.connection.waitForConnected().abortOn(this.lifetime.signal);
 		if (this.destroyed) throw new Error("mengine doc session destroyed");
+		if (this.options.initialSnapshot) {
+			await this.local.pushDocUpdate({
+				docId: this.docId,
+				data: this.options.initialSnapshot
+			}, "initial-snapshot");
+			if (this.destroyed) throw new Error("mengine doc session destroyed");
+		}
 		this.server.connection.connect();
 		this.synchronizer.start();
 		this.manager.start();
@@ -446,6 +454,10 @@ var DocumentSession = class {
 		const doc = this.manager.connectDoc(this.docId);
 		this.disposables.add(() => this.manager.disconnectDoc(this.docId));
 		if (this.options.peerId != null) doc.setPeerId(this.options.peerId);
+		this.disposables.add(this.manager.onLocalUpdateReceived(this.docId, (update) => {
+			this.trackLocalVersion(decodeImportBlobMeta(update, true).partialEndVersionVector);
+			this.emitSyncState();
+		}));
 		this.disposables.add(this.manager.onDocStateChange(this.docId, (state) => {
 			this.events.emit("state", state);
 			this.emitSyncState();
@@ -455,7 +467,7 @@ var DocumentSession = class {
 		this.adapterValue = this.model(doc, this.mutationGuard);
 		this.disposables.add(this.adapterValue.subscribe((source) => {
 			if (!this.adapterValue) return;
-			if (source === "local") this.localVersionValue = doc.version();
+			if (source === "local") this.trackLocalVersion(doc.version());
 			this.emitSyncState();
 			this.events.emit("update", {
 				source,
@@ -470,9 +482,39 @@ var DocumentSession = class {
 		this.undoManagerValue = new DocumentUndoManager(doc, this.mutationGuard, () => this.events.emit("undoState"));
 		this.editorValue = this.adapterValue.editor;
 		this.initialVersionValue = doc.version();
+		if (this.localVersionValue) this.trackLocalVersion(this.initialVersionValue);
 		this.emitSyncState();
 		return this.snapshot();
 	}
+	getLocalSaveState() {
+		return this.getState().localSave;
+	}
+	/** Immediately reports local transaction state; independent of server confirmation. */
+	subscribeLocalSaveState(cb) {
+		const off = this.events.on("state", () => cb(this.getLocalSaveState()));
+		cb(this.getLocalSaveState());
+		return off;
+	}
+	/** Waits until all local saves finish, including edits made while waiting. Does not wait for the network. */
+	async waitForLocalSave(options = {}) {
+		if (!this.editorValue || this.destroyed) throw new Error("mengine doc session is not started");
+		await this.manager.waitForLocalSave(this.docId).timeout(options.timeoutMs ?? 15e3);
+	}
+	/** Stop accepting edits and drain local persistence before releasing resources.
+	* A failed local write keeps retrying, even after the host has unmounted.
+	* Hosts should use this for normal teardown; destroy() is immediate cancellation. */
+	close() {
+		if (this.closeTask) return this.closeTask;
+		if (this.destroyed || !this.editorValue) {
+			this.destroy();
+			return Promise.resolve();
+		}
+		this.mutationGuard.close();
+		this.synchronizer.stop();
+		this.server.connection.disconnect();
+		this.closeTask = this.manager.waitForLocalSave(this.docId).then(() => this.destroy());
+		return this.closeTask;
+	}
 	getSyncState() {
 		const state = this.getState();
 		const target = this.confirmationTarget();
@@ -483,6 +525,14 @@ var DocumentSession = class {
 			phase: connection === "disconnected" ? "offline" : this.pushErrorValue != null || state.error != null ? "failed" : connection === "connecting" ? "connecting" : state.syncing ? "syncing" : "idle"
 		};
 	}
+	trackLocalVersion(version) {
+		const target = VersionVector.parseJSON(this.confirmationTarget()?.toJSON() ?? /* @__PURE__ */ new Map());
+		for (const [peer, counter] of version.toJSON()) if ((target.get(peer) ?? 0) < counter) target.setEnd({
+			peer,
+			counter
+		});
+		this.localVersionValue = target;
+	}
 	confirmationTarget() {
 		return this.localVersionValue ?? this.initialVersionValue;
 	}

package/dist/legacy.d.ts

@@ -1,5 +1,5 @@
 import { i as VideoDraft, l as VideoDraftPartUnion, o as VideoDraftContent, p as CommitOptions, t as CaptionDisplayCue } from "./video-draft-types-c_shaRyq.js";
-import { A as MengineAuditResponse, B as base64ToBytes, C as MengineEventStreamOptions, D as MengineHttpRequestError, E as MengineHttpClientOptions, F as MengineRejectedResponse, I as MengineSnapshotResponse, L as MengineSseUpdateEvent, M as MengineDraftResponse, N as MenginePushResponse, O as MenginePushRejectedError, P as MenginePushUpdateResponse, R as MengineSyncResponse, S as PushResultKind, T as MengineHttpClient, V as bytesToBase64, _ as encodeDocVersionMark, a as MengineDocSessionOptions, b as PullResult, c as DocStorageLike, d as MedeoHttpDocStorageOptions, f as PushOutcome, g as decodeDocVersionMark, h as ManualSyncTransport, j as MengineDocumentVersion, k as MengineAuditEntry, l as MengineUndoState, m as ManualSyncDocOptions, o as MengineDocSyncState, p as PushOutcomeKind, s as WaitForServerAckOptions, t as MemoryDocStorage, u as MedeoHttpDocStorage, v as DocVersionMark, w as readMengineEventStream, x as PushResult, y as PullFailureReason, z as MengineUpdateMeta } from "./index-B7fC7q7P.js";
+import { A as MenginePushRejectedError, B as MengineSyncResponse, C as PushResult, D as MengineHttpClient, E as readMengineEventStream, F as MenginePushResponse, H as base64ToBytes, I as MenginePushUpdateResponse, L as MengineRejectedResponse, M as MengineAuditResponse, N as MengineDocumentVersion, O as MengineHttpClientOptions, P as MengineDraftResponse, R as MengineSnapshotResponse, S as PullResult, T as MengineEventStreamOptions, U as bytesToBase64, V as MengineUpdateMeta, _ as ManualSyncTransport, a as MengineDocSessionOptions, b as DocVersionMark, d as MengineUndoState, f as MedeoHttpDocStorage, g as ManualSyncDocOptions, h as PushOutcomeKind, j as MengineAuditEntry, k as MengineHttpRequestError, l as WaitForServerAckOptions, m as PushOutcome, o as MengineDocSyncState, p as MedeoHttpDocStorageOptions, t as MemoryDocStorage, u as DocStorageLike, v as decodeDocVersionMark, w as PushResultKind, x as PullFailureReason, y as encodeDocVersionMark, z as MengineSseUpdateEvent } from "./index-D-3rdfUP.js";
 import { LoroDoc, PeerID } from "loro-crdt";
 
 //#region ../medeo-dsl/depreacted/sandbox.d.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mengine/medeo-client",
-  "version": "2.1.1-dsl.1",
+  "version": "2.1.1-dsl.2",
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
@@ -29,9 +29,9 @@
     "@noble/hashes": "^2.4.0",
     "immer": "^10.2.0",
     "zod": "^4.4.3",
-    "@mengine/storage": "2.1.1-dsl.1",
-    "@mengine/sync": "2.1.1-dsl.1",
-    "@mengine/utils": "2.1.1-dsl.1"
+    "@mengine/storage": "2.1.1-dsl.2",
+    "@mengine/sync": "2.1.1-dsl.2",
+    "@mengine/utils": "2.1.1-dsl.2"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",