@mengine/medeo-client 1.2.1-alpha.1 → 1.2.1-alpha.11

package/dist/{document-Dcu87api.js → document-C0o_cjAH.js}

@@ -87,8 +87,7 @@ function jsonTransform() {
 const trackItem = schema.LoroMap({
 	part_id: schema.String(),
 	time_position: schema.String().transform(jsonTransform()),
-	fallback_abs_ms: schema.Number({ required: false }),
-	duration_override_ms: schema.Number({ required: false })
+	fallback_abs_ms: schema.Number({ required: false })
 });
 const track = schema.LoroMap({
 	id: schema.String(),
@@ -774,8 +773,7 @@ const trackItemTimePositionSchema = z.discriminatedUnion("mode", [
 const trackItemSchema = z.object({
 	part_id: z.string(),
 	time_position: trackItemTimePositionSchema,
-	fallback_abs_ms: finiteNumber.optional(),
-	duration_override_ms: z.number().finite().positive().optional()
+	fallback_abs_ms: finiteNumber.optional()
 }).passthrough();
 const trackSchema = z.object({
 	id: z.string().optional(),
@@ -1328,7 +1326,7 @@ function fromVideoDocument(document) {
 		above_main_tracks: aboveTracks.map((t) => draftTrack(t, view.absByPartId)),
 		below_main_tracks: belowTracks.map((t) => draftTrack(t, view.absByPartId)),
 		part_aggregations: view.aggregations,
-		part_library: toReadViewPartLibrary(view.partLibrary, view.durationMs, view.derivedFillerPartIds, captionDurationOverrides(document)),
+		part_library: toReadViewPartLibrary(view.partLibrary, view.durationMs, view.derivedFillerPartIds),
 		version: document.meta.version
 	};
 }
@@ -1349,7 +1347,7 @@ function fromVideoDocument(document) {
 * and they are not part of the document (see `fromVideoDocument`). An empty clip a
 * writer placed deliberately is NOT in that set and is projected normally.
 */
-function toReadViewPartLibrary(partLibrary, durationMs, derivedFillerPartIds, captionDurationByPartId) {
+function toReadViewPartLibrary(partLibrary, durationMs, derivedFillerPartIds) {
 	const out = {};
 	for (const [partId, part] of Object.entries(partLibrary)) {
 		if (derivedFillerPartIds.has(partId)) continue;
@@ -1369,7 +1367,7 @@ function toReadViewPartLibrary(partLibrary, durationMs, derivedFillerPartIds, ca
 			const caption = clone(part.caption);
 			out[partId] = { caption: {
 				...caption,
-				duration_ms: captionDurationByPartId.get(partId) ?? caption.initial_duration_ms
+				duration_ms: caption.initial_duration_ms
 			} };
 		} else if (part.bgm != null) out[partId] = { bgm: {
 			...clone(part.bgm),
@@ -1378,14 +1376,6 @@ function toReadViewPartLibrary(partLibrary, durationMs, derivedFillerPartIds, ca
 	}
 	return out;
 }
-function captionDurationOverrides(document) {
-	const result = /* @__PURE__ */ new Map();
-	for (const track of document.tracks ?? []) {
-		if (track.parts_kind !== "caption") continue;
-		for (const item of track.items ?? []) if (item.duration_override_ms != null) result.set(item.part_id, item.duration_override_ms);
-	}
-	return result;
-}
 /** Deep-clone a part payload, dropping the derived read-view `duration_ms`. */
 function omitDurationMs(part) {
 	const { duration_ms: _drop, ...rest } = clone(part);
@@ -1548,7 +1538,6 @@ function rowToTrack(row) {
 				time_position: item.time_position
 			};
 			if (item.fallback_abs_ms != null) result.fallback_abs_ms = item.fallback_abs_ms;
-			if (item.duration_override_ms != null) result.duration_override_ms = item.duration_override_ms;
 			return result;
 		})
 	};
@@ -1657,8 +1646,7 @@ function toTrackRow(track) {
 		items: (track.items ?? []).map((item) => ({
 			part_id: item.part_id,
 			time_position: item.time_position,
-			fallback_abs_ms: item.fallback_abs_ms,
-			duration_override_ms: item.duration_override_ms
+			fallback_abs_ms: item.fallback_abs_ms
 		}))
 	};
 }

package/dist/{index-CZlTzzrm.d.ts → index-DWVYLTjv.d.ts}

@@ -545,8 +545,6 @@ interface TrackItem {
   part_id: string;
   time_position: TrackItemTimePosition;
   fallback_abs_ms?: number | undefined;
-  /** Presentation window for this placement; currently used by caption resize. */
-  duration_override_ms?: number | undefined;
 }
 interface Track {
   id: string | undefined;
@@ -1322,14 +1320,6 @@ declare const replaceVideoClipSequenceInputSchema: z.ZodObject<{
 }, z.core.$strip>;
 type ReplaceVideoClipSequenceInput = z.infer<typeof replaceVideoClipSequenceInputSchema>;
 //#endregion
-//#region src/editor/schemas/resize-caption.d.ts
-/** Resize one caption placement without changing its cue/source duration. */
-declare const resizeCaptionInputSchema: z.ZodObject<{
-  caption_id: z.ZodString;
-  duration_ms: z.ZodNumber;
-}, z.core.$strip>;
-type ResizeCaptionInput = z.infer<typeof resizeCaptionInputSchema>;
-//#endregion
 //#region src/editor/schemas/set-bgm.d.ts
 /**
  * Set the document BGM. The media's stable result (storage key) arrives
@@ -1548,7 +1538,7 @@ type SpeechAsset = z.infer<typeof speechAssetSchema>;
 type CaptionAsset = z.infer<typeof captionAssetSchema>;
 type SpeechAssets = z.infer<typeof speechAssetsSchema>;
 declare namespace index_d_exports {
-  export { AddSpeechesInput, AddVideoClipsInput, AdjustBgmVolumeInput, AdjustSpeechVolumeInput, AdjustVideoClipDurationInput, AdjustVideoClipVolumeInput, AnchoredDeletePolicy, AnchoredReplacePolicy, CaptionAsset, ChangeSpeechScriptInput, ChangeSpeechVoiceInput, DeleteBgmInput, DeleteSpeechesInput, DeleteVideoClipsInput, MoveAnchor, MoveSpeechesInput, MoveVideoClipsByAnchorInput, MoveVideoClipsInput, MovedClipAnchoredPolicy, ReplaceVideoClipContentInput, ReplaceVideoClipSequenceInput, ResizeCaptionInput, SetBgmInput, SetCaptionStyleInput, SetCaptionVisibilityInput, SetVideoClipSpeedShiftInput, SpeechAsset, SpeechAssets, addSpeechesInputSchema, addVideoClipsInputSchema, adjustBgmVolumeInputSchema, adjustSpeechVolumeInputSchema, adjustVideoClipDurationInputSchema, adjustVideoClipVolumeInputSchema, anchoredDeletePolicySchema, anchoredReplacePolicySchema, changeSpeechScriptInputSchema, changeSpeechVoiceInputSchema, clipIdSchema, clipIdsSchema, deleteBgmInputSchema, deleteSpeechesInputSchema, deleteVideoClipsInputSchema, mediaIdSchema, moveAnchorSchema, moveSpeechesInputSchema, moveVideoClipsByAnchorInputSchema, moveVideoClipsInputSchema, movedClipAnchoredPolicySchema, positiveMsSchema, replaceVideoClipContentInputSchema, replaceVideoClipSequenceInputSchema, resizeCaptionInputSchema, setBgmInputSchema, setCaptionStyleInputSchema, setCaptionVisibilityInputSchema, setVideoClipSpeedShiftInputSchema, speechAssetsSchema, speechIdSchema, speechIdsSchema, speedShiftSchema, timelineMsSchema, voiceSchema, volumeSchema };
+  export { AddSpeechesInput, AddVideoClipsInput, AdjustBgmVolumeInput, AdjustSpeechVolumeInput, AdjustVideoClipDurationInput, AdjustVideoClipVolumeInput, AnchoredDeletePolicy, AnchoredReplacePolicy, CaptionAsset, ChangeSpeechScriptInput, ChangeSpeechVoiceInput, DeleteBgmInput, DeleteSpeechesInput, DeleteVideoClipsInput, MoveAnchor, MoveSpeechesInput, MoveVideoClipsByAnchorInput, MoveVideoClipsInput, MovedClipAnchoredPolicy, ReplaceVideoClipContentInput, ReplaceVideoClipSequenceInput, SetBgmInput, SetCaptionStyleInput, SetCaptionVisibilityInput, SetVideoClipSpeedShiftInput, SpeechAsset, SpeechAssets, addSpeechesInputSchema, addVideoClipsInputSchema, adjustBgmVolumeInputSchema, adjustSpeechVolumeInputSchema, adjustVideoClipDurationInputSchema, adjustVideoClipVolumeInputSchema, anchoredDeletePolicySchema, anchoredReplacePolicySchema, changeSpeechScriptInputSchema, changeSpeechVoiceInputSchema, clipIdSchema, clipIdsSchema, deleteBgmInputSchema, deleteSpeechesInputSchema, deleteVideoClipsInputSchema, mediaIdSchema, moveAnchorSchema, moveSpeechesInputSchema, moveVideoClipsByAnchorInputSchema, moveVideoClipsInputSchema, movedClipAnchoredPolicySchema, positiveMsSchema, replaceVideoClipContentInputSchema, replaceVideoClipSequenceInputSchema, setBgmInputSchema, setCaptionStyleInputSchema, setCaptionVisibilityInputSchema, setVideoClipSpeedShiftInputSchema, speechAssetsSchema, speechIdSchema, speechIdsSchema, speedShiftSchema, timelineMsSchema, voiceSchema, volumeSchema };
 }
 //#endregion
 //#region src/editor/schema-validator.d.ts
@@ -1600,7 +1590,6 @@ declare class SchemaValidator {
   validateSetBgm(input: SetBgmInput, _doc: SnapshotReadable): void;
   validateDeleteBgm(input: DeleteBgmInput, _doc: SnapshotReadable): void;
   validateSetCaptionVisibility(input: SetCaptionVisibilityInput, _doc: SnapshotReadable): void;
-  validateResizeCaption(input: ResizeCaptionInput, doc: SnapshotReadable): void;
   validateSetCaptionStyle(input: SetCaptionStyleInput, _doc: SnapshotReadable): void;
   private parse;
   private mainTrackIds;
@@ -1649,7 +1638,7 @@ declare class SchemaValidator {
  * side-effect payload contract in
  * `docs/projects/medeo-integration/results/phase-4-side-effect-payload-contract.md`.
  */
-type ImplementedSemanticOpKind = 'MoveVideoClips' | 'MoveVideoClipsByAnchor' | 'DeleteVideoClips' | 'AddVideoClips' | 'AdjustVideoClipVolume' | 'SetVideoClipSpeedShift' | 'ReplaceVideoClipContent' | 'ReplaceVideoClipSequence' | 'AdjustVideoClipDuration' | 'AddSpeeches' | 'DeleteSpeeches' | 'MoveSpeeches' | 'ChangeSpeechScript' | 'ChangeSpeechVoice' | 'AdjustSpeechVolume' | 'ResizeCaption' | 'SetCaptionVisibility' | 'SetCaptionStyle' | 'SetBgm' | 'DeleteBgm' | 'AdjustBgmVolume';
+type ImplementedSemanticOpKind = 'MoveVideoClips' | 'MoveVideoClipsByAnchor' | 'DeleteVideoClips' | 'AddVideoClips' | 'AdjustVideoClipVolume' | 'SetVideoClipSpeedShift' | 'ReplaceVideoClipContent' | 'ReplaceVideoClipSequence' | 'AdjustVideoClipDuration' | 'AddSpeeches' | 'DeleteSpeeches' | 'MoveSpeeches' | 'ChangeSpeechScript' | 'ChangeSpeechVoice' | 'AdjustSpeechVolume' | 'SetCaptionVisibility' | 'SetCaptionStyle' | 'SetBgm' | 'DeleteBgm' | 'AdjustBgmVolume';
 /**
  * Operations on the roadmap but NOT yet implemented by `SemanticEditor`. Empty:
  * Phase 4 covers every op with a real entry point. Kept as a named type so the
@@ -1711,7 +1700,7 @@ interface CommitOptions {
   /** Author of this op; omitted for writes with no acting user (bootstrap, repair). */
   actor?: OpActor;
 }
-type SemanticOpInput = MoveVideoClipsInput | MoveVideoClipsByAnchorInput | DeleteVideoClipsInput | AddVideoClipsInput | AdjustVideoClipVolumeInput | AdjustSpeechVolumeInput | AdjustBgmVolumeInput | SetVideoClipSpeedShiftInput | ReplaceVideoClipContentInput | ReplaceVideoClipSequenceInput | AdjustVideoClipDurationInput | AddSpeechesInput | DeleteSpeechesInput | MoveSpeechesInput | ResizeCaptionInput | SetCaptionVisibilityInput | SetCaptionStyleInput | SetBgmInput | DeleteBgmInput;
+type SemanticOpInput = MoveVideoClipsInput | MoveVideoClipsByAnchorInput | DeleteVideoClipsInput | AddVideoClipsInput | AdjustVideoClipVolumeInput | AdjustSpeechVolumeInput | AdjustBgmVolumeInput | SetVideoClipSpeedShiftInput | ReplaceVideoClipContentInput | ReplaceVideoClipSequenceInput | AdjustVideoClipDurationInput | AddSpeechesInput | DeleteSpeechesInput | MoveSpeechesInput | SetCaptionVisibilityInput | SetCaptionStyleInput | SetBgmInput | DeleteBgmInput;
 type SemanticOpName = ImplementedSemanticOpKind;
 /** Audit metadata committed alongside an op's writes. */
 interface TransactAudit {
@@ -1857,8 +1846,6 @@ declare class SemanticEditor {
   deleteBgm(input: DeleteBgmInput, options?: CommitOptions): Promise<void>;
   /** Toggle caption visibility (caption track `is_hidden`). */
   setCaptionVisibility(input: SetCaptionVisibilityInput, options?: CommitOptions): Promise<void>;
-  /** Resize the caption placement window; cue/source duration stays immutable. */
-  resizeCaption(input: ResizeCaptionInput, options?: CommitOptions): Promise<void>;
   /**
    * Set the document-wide caption style. GLOBAL (no `caption_id`): the patch is
    * merged onto EVERY caption part's `style`, mirroring the FE, which applies a
@@ -2043,7 +2030,6 @@ declare const videoDocumentSchema: z.ZodObject<{
         offsetMs: z.ZodNumber;
       }, z.core.$loose>], "mode">;
       fallback_abs_ms: z.ZodOptional<z.ZodNumber>;
-      duration_override_ms: z.ZodOptional<z.ZodNumber>;
     }, z.core.$loose>>>;
   }, z.core.$loose>>>;
   part_library: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { $ as VideoDocumentSchemaVersion, A as assertValidVideoDocument, B as BgmPart, C as index_d_exports, D as VideoDocumentMirrorSchema, E as VideoDocumentDraft, F as SpeechHostMap, G as SpeechPart, H as DEFAULT_UNIT_TIME_MS, I as buildSpeechHostMap, J as TrackItem, K as Timeline, L as derivePositionFromAbs, M as InitialDocumentFacts, N as buildInitialVideoDocument, O as videoDocumentMirrorSchema, P as DerivedItemPosition, Q as VideoDocument, R as fromVideoDocument, S as ValidationError, T as TrackItemDraft, U as PartKind, V as CaptionPart, W as PartUnion, X as VIDEO_DOCUMENT_SCHEMA_VERSION, Y as TrackItemTimePosition, Z as VideoClipPart, _ as PlannedSemanticOpKind, a as MirrorVideoDocumentOptions, at as CaptionPart$1, b as SchemaValidator, c as CommitOptions, ct as SpeedShift, d as SemanticEditor, dt as TrackItem$1, et as VideoDocumentValidationIssue, f as SemanticOpInput, g as ImplementedSemanticOpKind, h as IMPLEMENTED_SEMANTIC_OP_KINDS, i as MirrorVideoDocumentAdapter, it as Attachment, j as validateVideoDocument, k as VideoDocumentValidationError, l as OpActor, lt as Timeline$1, m as TransactAudit, n as videoDocumentSchema, nt as VideoDraft, o as createMirrorVideoDocument, ot as CaptionStyle, p as SemanticOpName, q as Track, r as readVideoDocumentFromDraft, rt as VideoDraftPartUnion, s as createMirrorVideoDocumentAdapter, st as PartAggregation, t as partUnionSchema, tt as VideoDocumentValidationIssueCode, u as SemanticDocumentAdapter, ut as Track$1, v as SemanticOpKind, w as TrackDraft, x as SnapshotReadable, y as isImplementedSemanticOpKind, z as toVideoDocument } from "./index-CZlTzzrm.js";
+import { $ as VideoDocumentSchemaVersion, A as assertValidVideoDocument, B as BgmPart, C as index_d_exports, D as VideoDocumentMirrorSchema, E as VideoDocumentDraft, F as SpeechHostMap, G as SpeechPart, H as DEFAULT_UNIT_TIME_MS, I as buildSpeechHostMap, J as TrackItem, K as Timeline, L as derivePositionFromAbs, M as InitialDocumentFacts, N as buildInitialVideoDocument, O as videoDocumentMirrorSchema, P as DerivedItemPosition, Q as VideoDocument, R as fromVideoDocument, S as ValidationError, T as TrackItemDraft, U as PartKind, V as CaptionPart, W as PartUnion, X as VIDEO_DOCUMENT_SCHEMA_VERSION, Y as TrackItemTimePosition, Z as VideoClipPart, _ as PlannedSemanticOpKind, a as MirrorVideoDocumentOptions, at as CaptionPart$1, b as SchemaValidator, c as CommitOptions, ct as SpeedShift, d as SemanticEditor, dt as TrackItem$1, et as VideoDocumentValidationIssue, f as SemanticOpInput, g as ImplementedSemanticOpKind, h as IMPLEMENTED_SEMANTIC_OP_KINDS, i as MirrorVideoDocumentAdapter, it as Attachment, j as validateVideoDocument, k as VideoDocumentValidationError, l as OpActor, lt as Timeline$1, m as TransactAudit, n as videoDocumentSchema, nt as VideoDraft, o as createMirrorVideoDocument, ot as CaptionStyle, p as SemanticOpName, q as Track, r as readVideoDocumentFromDraft, rt as VideoDraftPartUnion, s as createMirrorVideoDocumentAdapter, st as PartAggregation, t as partUnionSchema, tt as VideoDocumentValidationIssueCode, u as SemanticDocumentAdapter, ut as Track$1, v as SemanticOpKind, w as TrackDraft, x as SnapshotReadable, y as isImplementedSemanticOpKind, z as toVideoDocument } from "./index-DWVYLTjv.js";
 import { PeerID } from "loro-crdt";
 import { DocState } from "@mengine/sync";
 import { BaseDocStorage, Connection, DocDiff, DocPushReceipt, DocSnapshotRecord, DocStorage, DocStorageOptions, DocUpdate, DocUpdateRecord } from "@mengine/storage";
@@ -296,7 +296,9 @@ type PushResultKind = 'ack' | 'duplicate' | 'rejected' | 'failed' | 'nothing_to_
  */
 interface PushResult {
   kind: PushResultKind;
-  /** Server-allocated sequence number; only present for `ack`. */
+  /** Server document sequence observed after a successful `ack` or `duplicate`. */
+  mengineUpdateSeq?: number | undefined;
+  /** @deprecated Ack-only sequence retained until consumers adopt `mengineUpdateSeq`. */
   updateSeq?: number | undefined;
   /** Whether the server held ops the local document lacked. See above. */
   collaborated: boolean;
@@ -575,6 +577,9 @@ declare class MedeoHttpDocStorage implements DocStorage {
    * tool-level ack wait) subscribe here.
    */
   subscribePushOutcome(callback: (outcome: PushOutcome) => void): () => void;
+  /** Authoritative HTTP reads and accepted pushes, never inferred from SSE bytes. */
+  subscribeServerVersion(callback: (version: Uint8Array) => void): () => void;
+  private reportServerVersion;
   deleteDoc(_docId: string): Promise<void>;
   subscribeDocUpdate(callback: (update: DocUpdate, origin: unknown) => void): () => void;
   private assertDocId;
@@ -623,6 +628,14 @@ 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. */
+  readonly confirmation: 'unknown' | 'pending' | 'confirmed';
+  /** Transport/activity phase. Idle does not imply confirmation; failure details
+   * remain available through push outcomes and confirmation wait errors. */
+  readonly phase: 'connecting' | 'idle' | 'syncing' | 'offline' | 'failed';
+}
 interface MengineDocSessionOptions {
   docId: string;
   client: MengineHttpClient;
@@ -668,8 +681,14 @@ declare class MengineDocSession {
   private adapterValue;
   private editorValue;
   private started;
+  private destroyed;
+  private lifetime;
+  private hasConnected;
+  private initialVersionValue;
+  private localVersionValue;
+  private pushErrorValue;
   /**
-   * Latest server oplog version seen on a push outcome. Lets `waitForServerAck`
+   * Latest server oplog version seen on an authoritative HTTP response. Lets `waitForServerAck`
    * return without waiting when the server is already known to cover the local
    * doc (e.g. nothing was edited since the last confirmed push).
    */
@@ -684,14 +703,14 @@ declare class MengineDocSession {
    */
   subscribePushOutcome(callback: (outcome: PushOutcome) => void): () => void;
   /**
-   * Resolve once the server has durably accepted the local document state as of
+   * Resolve once the server has durably accepted the local commits as of
    * *now* — the capability an Agent tool needs to answer "did my edit land?"
    * before reporting success.
    *
    * Call it right after the editor ops whose durability matters. It snapshots the
-   * local doc's current version and resolves on the first push outcome whose
-   * `serverVV` covers that version, i.e. the server log is at least as advanced as
-   * the local doc was when this was called.
+   * latest local commit's version (or the loaded baseline before any edit) and
+   * resolves when an authoritative server version covers it. Remote-only
+   * imports do not extend this target, matching the displayed confirmation state.
    *
    * Version coverage, not byte identity, is the acceptance test — for two reasons:
    * the ops may reach the server inside a merged blob rather than as the exact
@@ -723,6 +742,11 @@ declare class MengineDocSession {
    * surfaces through `subscribe`.
    */
   start(): Promise<VideoDocument>;
+  getSyncState(): MengineDocSyncState;
+  private confirmationTarget;
+  /** Immediately supplies current state; unsubscribe when the host changes docs. */
+  subscribeSyncState(cb: (state: MengineDocSyncState) => void): () => void;
+  private emitSyncState;
   subscribe(cb: (event: MengineDocSessionUpdateEvent) => void): () => void;
   onStateChange(cb: (state: DocState) => void): () => void;
   getState(): DocState;
@@ -1064,4 +1088,4 @@ declare function hostForAbsMs(ranges: MainClipRange[], absMs: number): MainClipR
  */
 declare function relativePositionForAbs(ranges: MainClipRange[], absMs: number): TrackItemTimePosition;
 //#endregion
-export { type Aggregation, type Attachment, type BgmPart, type CaptionPart, type CaptionStyle, type CommitOptions, DEFAULT_UNIT_TIME_MS, type DerivedItemPosition, type DocStorageLike, type DocVersionMark, IMPLEMENTED_SEMANTIC_OP_KINDS, type ImplementedSemanticOpKind, type InitialDocumentFacts, LANE_KINDS_IN_STACK_ORDER, type LaneKind, type MainClipRange, type MakeEmptyPart, ManualSyncDoc, type ManualSyncDocOptions, MedeoHttpDocStorage, type MedeoHttpDocStorageOptions, MemoryDocStorage, MengineAckFailedError, type MengineAuditEntry, type MengineAuditResponse, MengineDocSession, type MengineDocSessionOptions, type MengineDocSessionUpdateEvent, type MengineDocumentVersion, type MengineEventStreamOptions, MengineHttpClient, type MengineHttpClientOptions, MengineHttpRequestError, MenginePushRejectedError, type MenginePushResponse, type MenginePushUpdateResponse, type MengineRejectedResponse, type MengineSnapshotResponse, type MengineSseUpdateEvent, type MengineSyncResponse, type MengineUpdateMeta, MirrorVideoDocumentAdapter, type MirrorVideoDocumentOptions, type OpActor, type PartAggregation, type PartKind, type PartUnion, type PlannedSemanticOpKind, type PullFailureReason, type PullResult, type PushOutcome, type PushOutcomeKind, type PushResult, type PushResultKind, SchemaValidator, type SemanticDocumentAdapter, SemanticEditor, type SemanticOpInput, type SemanticOpKind, type SemanticOpName, type SnapshotReadable, type SolvedVideoDocument, type SpeechHostMap, type SpeechPart, type SpeedShift, TIMELINE_SKELETON_DURATION_MS, type Timeline, type TimelineDoc, type TimelineItem, type Track, type TrackDraft, type TrackItem, type TrackItemDraft, type TrackItemTimePosition, type TransactAudit, VIDEO_DOCUMENT_SCHEMA_VERSION, ValidationError, type VideoClipPart, type VideoDocument, type VideoDocumentDraft, type VideoDocumentMirrorSchema, type VideoDocumentSchemaVersion, VideoDocumentValidationError, type VideoDocumentValidationIssue, type VideoDocumentValidationIssueCode, type VideoDraft, type CaptionPart$1 as VideoDraftCaptionPart, type VideoDraftPartUnion, type Timeline$1 as VideoDraftTimeline, type Track$1 as VideoDraftTrack, type TrackItem$1 as VideoDraftTrackItem, type WaitForServerAckOptions, arrangeMainTrackSeamlessly, assertValidVideoDocument, base64ToBytes, buildInitialVideoDocument, buildSpeechHostMap, bytesToBase64, cascadeAfterVideoClipChanges, createMirrorVideoDocument, createMirrorVideoDocumentAdapter, decodeDocVersionMark, derivePositionFromAbs, encodeDocVersionMark, ensureLaneTrack, fillMainTrackTimeGaps, findLaneTrack, fromVideoDocument, generatePartId, getAt, hostForAbsMs, isEmptyVideoClip, isImplementedSemanticOpKind, isMap, laneTrackId, mainTrackRanges, partDurationMs, partUnionSchema, readMainTrackItems, readMengineEventStream, readPart, readPartDurationMs, readVideoDocumentFromDraft, reassignSpeechesToVideoClipsByTime, recalculateTimelineDuration, relativePositionForAbs, resolveAllSpeechOverlaps, resolveSpeechOverlapByShiftingVideos, safeDurationMs, index_d_exports as schemas, snapshotToPlain, solveVideoDocument, syncAggregatedClipsTimePosition, toVideoDocument, validateVideoDocument, videoDocumentMirrorSchema, videoDocumentSchema };
+export { type Aggregation, type Attachment, type BgmPart, type CaptionPart, type CaptionStyle, type CommitOptions, DEFAULT_UNIT_TIME_MS, type DerivedItemPosition, type DocStorageLike, type DocVersionMark, IMPLEMENTED_SEMANTIC_OP_KINDS, type ImplementedSemanticOpKind, type InitialDocumentFacts, LANE_KINDS_IN_STACK_ORDER, type LaneKind, type MainClipRange, type MakeEmptyPart, ManualSyncDoc, type ManualSyncDocOptions, MedeoHttpDocStorage, type MedeoHttpDocStorageOptions, MemoryDocStorage, MengineAckFailedError, type MengineAuditEntry, type MengineAuditResponse, MengineDocSession, type MengineDocSessionOptions, type MengineDocSessionUpdateEvent, type MengineDocSyncState, type MengineDocumentVersion, type MengineEventStreamOptions, MengineHttpClient, type MengineHttpClientOptions, MengineHttpRequestError, MenginePushRejectedError, type MenginePushResponse, type MenginePushUpdateResponse, type MengineRejectedResponse, type MengineSnapshotResponse, type MengineSseUpdateEvent, type MengineSyncResponse, type MengineUpdateMeta, MirrorVideoDocumentAdapter, type MirrorVideoDocumentOptions, type OpActor, type PartAggregation, type PartKind, type PartUnion, type PlannedSemanticOpKind, type PullFailureReason, type PullResult, type PushOutcome, type PushOutcomeKind, type PushResult, type PushResultKind, SchemaValidator, type SemanticDocumentAdapter, SemanticEditor, type SemanticOpInput, type SemanticOpKind, type SemanticOpName, type SnapshotReadable, type SolvedVideoDocument, type SpeechHostMap, type SpeechPart, type SpeedShift, TIMELINE_SKELETON_DURATION_MS, type Timeline, type TimelineDoc, type TimelineItem, type Track, type TrackDraft, type TrackItem, type TrackItemDraft, type TrackItemTimePosition, type TransactAudit, VIDEO_DOCUMENT_SCHEMA_VERSION, ValidationError, type VideoClipPart, type VideoDocument, type VideoDocumentDraft, type VideoDocumentMirrorSchema, type VideoDocumentSchemaVersion, VideoDocumentValidationError, type VideoDocumentValidationIssue, type VideoDocumentValidationIssueCode, type VideoDraft, type CaptionPart$1 as VideoDraftCaptionPart, type VideoDraftPartUnion, type Timeline$1 as VideoDraftTimeline, type Track$1 as VideoDraftTrack, type TrackItem$1 as VideoDraftTrackItem, type WaitForServerAckOptions, arrangeMainTrackSeamlessly, assertValidVideoDocument, base64ToBytes, buildInitialVideoDocument, buildSpeechHostMap, bytesToBase64, cascadeAfterVideoClipChanges, createMirrorVideoDocument, createMirrorVideoDocumentAdapter, decodeDocVersionMark, derivePositionFromAbs, encodeDocVersionMark, ensureLaneTrack, fillMainTrackTimeGaps, findLaneTrack, fromVideoDocument, generatePartId, getAt, hostForAbsMs, isEmptyVideoClip, isImplementedSemanticOpKind, isMap, laneTrackId, mainTrackRanges, partDurationMs, partUnionSchema, readMainTrackItems, readMengineEventStream, readPart, readPartDurationMs, readVideoDocumentFromDraft, reassignSpeechesToVideoClipsByTime, recalculateTimelineDuration, relativePositionForAbs, resolveAllSpeechOverlaps, resolveSpeechOverlapByShiftingVideos, safeDurationMs, index_d_exports as schemas, snapshotToPlain, solveVideoDocument, syncAggregatedClipsTimePosition, toVideoDocument, validateVideoDocument, videoDocumentMirrorSchema, videoDocumentSchema };

package/dist/index.js

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./chunk-D7D4PA-g.js";
-import { A as partDurationMs, C as reassignSpeechesToVideoClipsByTime, D as syncAggregatedClipsTimePosition, E as resolveSpeechOverlapByShiftingVideos, F as partUnionToDraft, I as recordEntries, L as videoDocumentMirrorSchema, M as DEFAULT_UNIT_TIME_MS, N as VIDEO_DOCUMENT_SCHEMA_VERSION, O as TIMELINE_SKELETON_DURATION_MS, P as effectiveVideoClipDurationMs, R as base64ToBytes, S as fillMainTrackTimeGaps, T as resolveAllSpeechOverlaps, _ as findLaneTrack, a as buildInitialVideoDocument, b as cascadeAfterVideoClipChanges, c as fromVideoDocument, d as assertValidVideoDocument, f as validateVideoDocument, g as ensureLaneTrack, h as LANE_KINDS_IN_STACK_ORDER, i as readVideoDocumentFromDraft, j as safeDurationMs, k as isEmptyVideoClip, l as toVideoDocument, m as videoDocumentSchema, n as createMirrorVideoDocument, o as buildSpeechHostMap, p as partUnionSchema, r as createMirrorVideoDocumentAdapter, s as derivePositionFromAbs, t as MirrorVideoDocumentAdapter, u as VideoDocumentValidationError, v as laneTrackId, w as recalculateTimelineDuration, x as arrangeMainTrackSeamlessly, y as solveVideoDocument, z as bytesToBase64 } from "./document-Dcu87api.js";
+import { A as partDurationMs, C as reassignSpeechesToVideoClipsByTime, D as syncAggregatedClipsTimePosition, E as resolveSpeechOverlapByShiftingVideos, F as partUnionToDraft, I as recordEntries, L as videoDocumentMirrorSchema, M as DEFAULT_UNIT_TIME_MS, N as VIDEO_DOCUMENT_SCHEMA_VERSION, O as TIMELINE_SKELETON_DURATION_MS, P as effectiveVideoClipDurationMs, R as base64ToBytes, S as fillMainTrackTimeGaps, T as resolveAllSpeechOverlaps, _ as findLaneTrack, a as buildInitialVideoDocument, b as cascadeAfterVideoClipChanges, c as fromVideoDocument, d as assertValidVideoDocument, f as validateVideoDocument, g as ensureLaneTrack, h as LANE_KINDS_IN_STACK_ORDER, i as readVideoDocumentFromDraft, j as safeDurationMs, k as isEmptyVideoClip, l as toVideoDocument, m as videoDocumentSchema, n as createMirrorVideoDocument, o as buildSpeechHostMap, p as partUnionSchema, r as createMirrorVideoDocumentAdapter, s as derivePositionFromAbs, t as MirrorVideoDocumentAdapter, u as VideoDocumentValidationError, v as laneTrackId, w as recalculateTimelineDuration, x as arrangeMainTrackSeamlessly, y as solveVideoDocument, z as bytesToBase64 } from "./document-C0o_cjAH.js";
 import { z } from "zod";
 import { LoroDoc, VersionVector } from "loro-crdt";
 import { ClientServerSynchronizer, DocManager } from "@mengine/sync";
@@ -670,13 +670,6 @@ const replaceVideoClipSequenceInputSchema = z.object({
 	}
 });
 //#endregion
-//#region src/editor/schemas/resize-caption.ts
-/** Resize one caption placement without changing its cue/source duration. */
-const resizeCaptionInputSchema = z.object({
-	caption_id: z.string().min(1),
-	duration_ms: z.number().finite().positive()
-});
-//#endregion
 //#region src/editor/schemas/set-bgm.ts
 /**
 * Set the document BGM. The media's stable result (storage key) arrives
@@ -772,7 +765,6 @@ var schemas_exports = /* @__PURE__ */ __exportAll({
 	positiveMsSchema: () => positiveMsSchema,
 	replaceVideoClipContentInputSchema: () => replaceVideoClipContentInputSchema,
 	replaceVideoClipSequenceInputSchema: () => replaceVideoClipSequenceInputSchema,
-	resizeCaptionInputSchema: () => resizeCaptionInputSchema,
 	setBgmInputSchema: () => setBgmInputSchema,
 	setCaptionStyleInputSchema: () => setCaptionStyleInputSchema,
 	setCaptionVisibilityInputSchema: () => setCaptionVisibilityInputSchema,
@@ -1023,18 +1015,6 @@ var SchemaValidator = class {
 	validateSetCaptionVisibility(input, _doc) {
 		this.parse(setCaptionVisibilityInputSchema, input, "set_caption_visibility_invalid_input");
 	}
-	validateResizeCaption(input, doc) {
-		const parsed = this.parse(resizeCaptionInputSchema, input, "resize_caption_invalid_input");
-		const snapshot = doc.snapshot();
-		this.assertPartKind(snapshot, parsed.caption_id, "caption", "resize_caption");
-		if (snapshot.tracks?.find((track) => track.parts_kind === "caption")?.items?.find((row) => row.part_id === parsed.caption_id) == null) throw new ValidationError("resize_caption_placement_not_found", `caption_id "${parsed.caption_id}" is not placed on the caption track`, { caption_id: parsed.caption_id });
-		const cueDuration = snapshot.part_library?.[parsed.caption_id]?.caption?.initial_duration_ms ?? 0;
-		if (parsed.duration_ms < cueDuration) throw new ValidationError("resize_caption_below_cue", `duration_ms ${parsed.duration_ms} is shorter than cue duration ${cueDuration}`, {
-			caption_id: parsed.caption_id,
-			duration_ms: parsed.duration_ms,
-			cue_duration_ms: cueDuration
-		});
-	}
 	validateSetCaptionStyle(input, _doc) {
 		this.parse(setCaptionStyleInputSchema, input, "set_caption_style_invalid_input");
 	}
@@ -1240,8 +1220,7 @@ var SemanticEditor = class {
 				track.items.splice(at, 0, {
 					part_id: partId,
 					time_position: { mode: "sequential" },
-					fallback_abs_ms: void 0,
-					duration_override_ms: void 0
+					fallback_abs_ms: void 0
 				});
 				at += 1;
 			}
@@ -1288,8 +1267,7 @@ var SemanticEditor = class {
 				newItems.push({
 					part_id: partId,
 					time_position: { mode: "sequential" },
-					fallback_abs_ms: void 0,
-					duration_override_ms: void 0
+					fallback_abs_ms: void 0
 				});
 				newClipIds.push(partId);
 			}
@@ -1502,8 +1480,7 @@ var SemanticEditor = class {
 					mode: "absolute",
 					offsetMs: 0
 				},
-				fallback_abs_ms: void 0,
-				duration_override_ms: void 0
+				fallback_abs_ms: void 0
 			}];
 		}, audit("SetBgm", input, options));
 	}
@@ -1526,15 +1503,6 @@ var SemanticEditor = class {
 			track.is_hidden = input.is_hidden;
 		}, audit("SetCaptionVisibility", input, options));
 	}
-	/** Resize the caption placement window; cue/source duration stays immutable. */
-	async resizeCaption(input, options) {
-		this.validator.validateResizeCaption(input, this.doc);
-		this.doc.transact((draft) => {
-			const item = findLaneTrack(draft, "caption")?.items?.find((row) => row.part_id === input.caption_id);
-			if (item == null) return;
-			item.duration_override_ms = input.duration_ms;
-		}, audit("ResizeCaption", input, options));
-	}
 	/**
 	* Set the document-wide caption style. GLOBAL (no `caption_id`): the patch is
 	* merged onto EVERY caption part's `style`, mirroring the FE, which applies a
@@ -1781,8 +1749,7 @@ function placeRelative(items, partId, anchorPartId, offsetMs, fallbackAbsMs) {
 	items.push({
 		part_id: partId,
 		time_position: timePosition,
-		fallback_abs_ms: fallbackAbsMs,
-		duration_override_ms: void 0
+		fallback_abs_ms: fallbackAbsMs
 	});
 }
 /**
@@ -1926,7 +1893,6 @@ const IMPLEMENTED_SEMANTIC_OP_KINDS = [
 	"ChangeSpeechScript",
 	"ChangeSpeechVoice",
 	"AdjustSpeechVolume",
-	"ResizeCaption",
 	"SetCaptionVisibility",
 	"SetCaptionStyle",
 	"SetBgm",
@@ -2194,6 +2160,7 @@ var ManualSyncDoc = class ManualSyncDoc {
 			if (serverVV != null) this.watermark = serverVV;
 			return {
 				kind: response.kind,
+				mengineUpdateSeq: response.version?.update_seq ?? response.update_seq ?? void 0,
 				updateSeq: response.update_seq ?? void 0,
 				collaborated: serverVV != null && !covers(localVersion, serverVV)
 			};
@@ -2312,6 +2279,7 @@ var SseConnection = class {
 						for (const update of event.updates) this.onUpdate(update);
 					}
 				});
+				if (!signal.aborted) this.setStatus("connecting", /* @__PURE__ */ new Error("SSE stream closed"));
 			} catch (error) {
 				if (signal.aborted) break;
 				this.setStatus("connecting", error instanceof Error ? error : new Error(String(error)));
@@ -2364,6 +2332,7 @@ var MedeoHttpDocStorage = class {
 	async getDoc(docId) {
 		this.assertDocId(docId);
 		const snapshot = await this.client.fetchSnapshot();
+		this.reportServerVersion(snapshot.version?.server_vv);
 		const now = /* @__PURE__ */ new Date();
 		return {
 			docId,
@@ -2375,6 +2344,7 @@ var MedeoHttpDocStorage = class {
 	async getDocDiff(docId, knownVersion) {
 		this.assertDocId(docId);
 		const response = await this.client.sync(knownVersion);
+		this.reportServerVersion(response.server_vv);
 		return {
 			docId,
 			missing: base64ToBytes(response.update),
@@ -2405,7 +2375,7 @@ var MedeoHttpDocStorage = class {
 		if (update.data.byteLength === 0) return {};
 		try {
 			const response = await this.client.pushUpdate(update.data);
-			const serverVV = decodeServerVV(response.version?.server_vv);
+			const serverVV = this.reportServerVersion(response.version?.server_vv);
 			this.events.emit("pushOutcome", {
 				kind: response.kind,
 				updateSeq: response.update_seq ?? void 0,
@@ -2433,6 +2403,15 @@ var MedeoHttpDocStorage = class {
 	subscribePushOutcome(callback) {
 		return this.events.on("pushOutcome", callback);
 	}
+	/** Authoritative HTTP reads and accepted pushes, never inferred from SSE bytes. */
+	subscribeServerVersion(callback) {
+		return this.events.on("serverVersion", callback);
+	}
+	reportServerVersion(encoded) {
+		const version = decodeServerVV(encoded);
+		if (version != null) this.events.emit("serverVersion", version);
+		return version;
+	}
 	async deleteDoc(_docId) {
 		throw new Error("MedeoHttpDocStorage does not support deleteDoc");
 	}
@@ -2614,8 +2593,14 @@ var MengineDocSession = class {
 	adapterValue = null;
 	editorValue = null;
 	started = false;
+	destroyed = false;
+	lifetime = null;
+	hasConnected = false;
+	initialVersionValue = null;
+	localVersionValue = null;
+	pushErrorValue = null;
 	/**
-	* Latest server oplog version seen on a push outcome. Lets `waitForServerAck`
+	* Latest server oplog version seen on an authoritative HTTP response. Lets `waitForServerAck`
 	* return without waiting when the server is already known to cover the local
 	* doc (e.g. nothing was edited since the last confirmed push).
 	*/
@@ -2643,14 +2628,14 @@ var MengineDocSession = class {
 		return this.server.subscribePushOutcome(callback);
 	}
 	/**
-	* Resolve once the server has durably accepted the local document state as of
+	* Resolve once the server has durably accepted the local commits as of
 	* *now* — the capability an Agent tool needs to answer "did my edit land?"
 	* before reporting success.
 	*
 	* Call it right after the editor ops whose durability matters. It snapshots the
-	* local doc's current version and resolves on the first push outcome whose
-	* `serverVV` covers that version, i.e. the server log is at least as advanced as
-	* the local doc was when this was called.
+	* latest local commit's version (or the loaded baseline before any edit) and
+	* resolves when an authoritative server version covers it. Remote-only
+	* imports do not extend this target, matching the displayed confirmation state.
 	*
 	* Version coverage, not byte identity, is the acceptance test — for two reasons:
 	* the ops may reach the server inside a merged blob rather than as the exact
@@ -2665,31 +2650,39 @@ var MengineDocSession = class {
 	* @throws {MengineAckFailedError} on timeout, rejection, or transport failure.
 	*/
 	async waitForServerAck(options = {}) {
-		if (this.adapterValue == null) throw new Error("mengine doc session is not started");
+		if (this.adapterValue == null || this.lifetime == null) throw new Error("mengine doc session is not started");
 		const timeoutMs = options.timeoutMs ?? 15e3;
-		const target = this.manager.connectDoc(this.docId).version();
+		const target = this.confirmationTarget() ?? this.manager.connectDoc(this.docId).version();
+		const signal = this.lifetime.signal;
 		if (this.serverVVValue != null && serverCovers(this.serverVVValue, target)) return;
 		await new Promise((resolve, reject) => {
-			let off = () => {};
+			const cleanup = [];
 			let done = false;
 			const settle = (error) => {
 				if (done) return;
 				done = true;
 				clearTimeout(timer);
-				off();
+				cleanup.forEach((off) => off());
 				if (error == null) resolve();
 				else reject(error);
 			};
 			const timer = setTimeout(() => {
 				settle(new MengineAckFailedError("timeout", void 0, void 0, `mengine did not acknowledge the update within ${timeoutMs}ms`));
 			}, timeoutMs);
-			off = this.server.subscribePushOutcome((outcome) => {
+			const onAbort = () => settle(new MengineAckFailedError("failed", void 0, void 0, "mengine doc session destroyed"));
+			signal.addEventListener("abort", onAbort, { once: true });
+			cleanup.push(() => signal.removeEventListener("abort", onAbort));
+			cleanup.push(this.events.on("syncState", () => {
+				if (this.serverVVValue != null && serverCovers(this.serverVVValue, target)) settle(void 0);
+			}));
+			cleanup.push(this.server.subscribePushOutcome((outcome) => {
 				if (outcome.kind === "rejected" || outcome.kind === "failed") {
 					settle(new MengineAckFailedError(outcome.kind, outcome.code, outcome.error, outcome.error?.message ?? `mengine push ${outcome.kind}`));
 					return;
 				}
-				if (outcome.serverVV != null && serverCovers(outcome.serverVV, target)) settle(void 0);
-			});
+			}));
+			if (signal.aborted) onAbort();
+			else this.synchronizer.requestSync(this.docId);
 		});
 	}
 	/**
@@ -2715,8 +2708,23 @@ var MengineDocSession = class {
 	* surfaces through `subscribe`.
 	*/
 	async start() {
+		if (this.destroyed) throw new Error("mengine doc session destroyed");
 		if (this.started) return this.snapshot();
 		this.started = true;
+		this.lifetime = new AbortController();
+		this.disposables.add(this.server.subscribeServerVersion((version) => {
+			this.serverVVValue = version;
+			if (this.getSyncState().confirmation === "confirmed") this.pushErrorValue = null;
+			this.emitSyncState();
+		}));
+		this.disposables.add(this.server.subscribePushOutcome((outcome) => {
+			this.pushErrorValue = outcome.kind === "failed" || outcome.kind === "rejected" ? outcome.error ?? /* @__PURE__ */ new Error(`mengine push ${outcome.kind}`) : null;
+			this.emitSyncState();
+		}));
+		this.disposables.add(this.server.connection.onStatusChanged((status) => {
+			if (status === "connected") this.hasConnected = true;
+			this.emitSyncState();
+		}));
 		this.local.connection.connect();
 		this.server.connection.connect();
 		this.disposables.add(() => this.local.connection.disconnect());
@@ -2732,19 +2740,46 @@ var MengineDocSession = class {
 		this.disposables.add(() => this.manager.disconnectDoc(this.docId));
 		const unsubscribe = doc.subscribe((event) => {
 			if (this.adapterValue == null) return;
+			if (this.initialVersionValue == null && this.hasContent()) this.initialVersionValue = doc.version();
+			if (event.by === "local") this.localVersionValue = doc.version();
+			this.emitSyncState();
 			this.events.emit("update", {
 				source: event.by === "local" ? "local" : "remote",
 				snapshot: this.adapterValue.snapshot()
 			});
 		});
 		this.disposables.add(unsubscribe);
-		this.disposables.add(this.manager.onDocStateChange(this.docId, (state) => this.events.emit("state", state)));
-		this.disposables.add(this.server.subscribePushOutcome((outcome) => {
-			if (outcome.serverVV != null) this.serverVVValue = outcome.serverVV;
+		this.disposables.add(this.manager.onDocStateChange(this.docId, (state) => {
+			this.events.emit("state", state);
+			this.emitSyncState();
 		}));
 		await this.waitForContent();
+		this.initialVersionValue ??= doc.version();
+		this.emitSyncState();
 		return this.snapshot();
 	}
+	getSyncState() {
+		const state = this.getState();
+		const target = this.confirmationTarget();
+		const confirmation = this.serverVVValue == null || target == null ? this.localVersionValue == null ? "unknown" : "pending" : serverCovers(this.serverVVValue, target) ? "confirmed" : "pending";
+		const connection = !this.started ? "disconnected" : this.server.connection.status === "connected" ? "connected" : this.hasConnected || this.server.connection.error != null ? "disconnected" : "connecting";
+		return {
+			confirmation,
+			phase: connection === "disconnected" ? "offline" : this.pushErrorValue != null || state.error != null ? "failed" : connection === "connecting" ? "connecting" : state.syncing ? "syncing" : "idle"
+		};
+	}
+	confirmationTarget() {
+		return this.localVersionValue ?? this.initialVersionValue;
+	}
+	/** Immediately supplies current state; unsubscribe when the host changes docs. */
+	subscribeSyncState(cb) {
+		const off = this.events.on("syncState", cb);
+		cb(this.getSyncState());
+		return off;
+	}
+	emitSyncState() {
+		this.events.emit("syncState", this.getSyncState());
+	}
 	subscribe(cb) {
 		return this.events.on("update", cb);
 	}
@@ -2755,7 +2790,12 @@ var MengineDocSession = class {
 		return this.manager.getDocState(this.docId);
 	}
 	destroy() {
+		if (this.destroyed) return;
+		this.destroyed = true;
+		this.started = false;
+		this.lifetime?.abort();
 		this.disposables.dispose();
+		this.emitSyncState();
 		this.events.clearAll();
 		this.adapterValue = null;
 		this.editorValue = null;
@@ -2772,13 +2812,21 @@ var MengineDocSession = class {
 	*/
 	async waitForContent() {
 		if (this.hasContent()) return;
-		await new Promise((resolve) => {
+		const signal = this.lifetime.signal;
+		await new Promise((resolve, reject) => {
+			const onAbort = () => {
+				off();
+				reject(/* @__PURE__ */ new Error("mengine doc session destroyed"));
+			};
 			const off = this.events.on("update", () => {
 				if (this.hasContent()) {
 					off();
+					signal.removeEventListener("abort", onAbort);
 					resolve();
 				}
 			});
+			signal.addEventListener("abort", onAbort, { once: true });
+			if (signal.aborted) onAbort();
 		});
 	}
 	hasContent() {

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-import { i as MirrorVideoDocumentAdapter, nt as VideoDraft } from "./index-CZlTzzrm.js";
+import { i as MirrorVideoDocumentAdapter, nt as VideoDraft } from "./index-DWVYLTjv.js";
 
 //#region src/testing/in-memory-mengine-server.d.ts
 /**

package/dist/testing.js

@@ -1,4 +1,4 @@
-import { N as VIDEO_DOCUMENT_SCHEMA_VERSION, R as base64ToBytes, r as createMirrorVideoDocumentAdapter, z as bytesToBase64 } from "./document-Dcu87api.js";
+import { N as VIDEO_DOCUMENT_SCHEMA_VERSION, R as base64ToBytes, r as createMirrorVideoDocumentAdapter, z as bytesToBase64 } from "./document-C0o_cjAH.js";
 import { t as classifyUpdate } from "./loro-relay-doc-ssdYpuef.js";
 import { LoroDoc, VersionVector, encodeFrontiers } from "loro-crdt";
 //#region src/testing/in-memory-mengine-server.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mengine/medeo-client",
-  "version": "1.2.1-alpha.1",
+  "version": "1.2.1-alpha.11",
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
@@ -25,9 +25,9 @@
   "dependencies": {
     "loro-mirror": "^2.2.0",
     "zod": "^4.4.3",
-    "@mengine/storage": "1.2.1-alpha.1",
-    "@mengine/sync": "1.2.1-alpha.1",
-    "@mengine/utils": "1.2.1-alpha.1"
+    "@mengine/sync": "1.2.1-alpha.11",
+    "@mengine/storage": "1.2.1-alpha.11",
+    "@mengine/utils": "1.2.1-alpha.11"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",