@mengine/medeo-client 1.3.1-alpha.3 → 1.3.1-alpha.5

package/dist/{document-ChxLYTqs.js → document-CkFhI8ir.js}

@@ -1102,13 +1102,13 @@ function zodPath(path) {
 //#endregion
 //#region src/document/projection.ts
 /**
-* Projection between the authoritative `VideoDocument` and the legacy
-* `VideoDraft` read-view (RFC 02 §5/§7). Both directions live here:
+* Projection between authoritative `VideoDocument` and compatible content
+* layouts (RFC 02 §5/§7). Both directions live here:
 *
 * - `toVideoDocument` ingests a `VideoDraft`, deriving each item's `position`
 *   from the legacy absolute layout + aggregations; derived values (abs time,
 *   `part_aggregations`, total duration) are dropped.
-* - `fromVideoDocument` solves a `VideoDocument` back into a `VideoDraft` via the
+* - `fromVideoDocument` solves a `VideoDocument` into `VideoDraftContent` via the
 *   timeline-core cascade, re-deriving exactly those values.
 *
 * Business validation lives in `validation.ts`; `fromVideoDocument` asserts a
@@ -1248,8 +1248,8 @@ function deriveItem(item, isMain, speechHost, partLibrary) {
 	};
 }
 /**
-* Project the authoritative `VideoDocument` back into the legacy `VideoDraft`
-* read-view, solving each item's absolute position, the `part_aggregations`, and
+* Project `VideoDocument` into `VideoDraftContent`, solving each item's
+* absolute position, the `part_aggregations`, and
 * the total duration via the timeline-core cascade.
 *
 * The read-view is a compatibility contract, and the IDL declares

package/dist/{index-DORI7qkw.d.ts → index-DdnuQf17.d.ts}

@@ -615,12 +615,9 @@ type VideoDraftPartUnion = {
   };
 };
 /**
- * Derived `VideoDraft` read-view. The shape follows the IDL verbatim except for
- * `part_library`: the IDL types its parts with the generated namespace
- * `PartUnion`, but the engine's projection emits `VideoDraftPartUnion` — the
- * authoritative parts with the derived `duration_ms` re-injected (reference/17 §7)
- * plus the engine extensions (`media_duration_ms`, the looser `SpeedShift`). This
- * is the intentional superset over the IDL `VideoDraft` (see the extensions note).
+ * Legacy Draft import shape. It allows omitted durations and engine extensions
+ * so existing fixtures and migrations can state only the facts they have.
+ * Projection returns the narrower `VideoDraftContent` contract instead.
  */
 type VideoDraft = Omit<VideoDraft$1, 'part_library' | 'video_creation_settings'> & {
   part_library: Record<string, VideoDraftPartUnion> | undefined;
@@ -631,7 +628,39 @@ type VideoDraft = Omit<VideoDraft$1, 'part_library' | 'video_creation_settings'>
  * identity, settings, thumbnail and revision counters are assembled by Director;
  * keeping an explicit field list prevents new business DTO fields entering here.
  */
-type VideoDraftContent = Pick<VideoDraft, 'timeline' | 'main_track' | 'above_main_tracks' | 'below_main_tracks' | 'part_aggregations' | 'part_library'>;
+type VideoDraftContent = Pick<VideoDraft, 'timeline' | 'main_track' | 'above_main_tracks' | 'below_main_tracks' | 'part_aggregations'> & {
+  part_library: Record<string, VideoDraftContentPartUnion> | undefined;
+};
+/** Projection always states the duration field; legacy imports may omit it. */
+type VideoDraftContentPartUnion = {
+  video_clip: VideoClipPart & {
+    duration_ms: number | undefined;
+  };
+  speech?: never;
+  caption?: never;
+  bgm?: never;
+} | {
+  video_clip?: never;
+  speech: SpeechPart & {
+    duration_ms: number | undefined;
+  };
+  caption?: never;
+  bgm?: never;
+} | {
+  video_clip?: never;
+  speech?: never;
+  caption: CaptionPart & {
+    duration_ms: number | undefined;
+  };
+  bgm?: never;
+} | {
+  video_clip?: never;
+  speech?: never;
+  caption?: never;
+  bgm: BgmPart & {
+    duration_ms: number | undefined;
+  };
+};
 /** Authoritative timeline: `duration_ms` is derived (= longest track), not stored. */
 interface Timeline {
   unit_time_ms: number | undefined;
@@ -682,13 +711,13 @@ interface VideoDocumentValidationIssue {
 //#endregion
 //#region src/document/projection.d.ts
 /**
- * Projection between the authoritative `VideoDocument` and the legacy
- * `VideoDraft` read-view (RFC 02 §5/§7). Both directions live here:
+ * Projection between authoritative `VideoDocument` and compatible content
+ * layouts (RFC 02 §5/§7). Both directions live here:
  *
  * - `toVideoDocument` ingests a `VideoDraft`, deriving each item's `position`
  *   from the legacy absolute layout + aggregations; derived values (abs time,
  *   `part_aggregations`, total duration) are dropped.
- * - `fromVideoDocument` solves a `VideoDocument` back into a `VideoDraft` via the
+ * - `fromVideoDocument` solves a `VideoDocument` into `VideoDraftContent` via the
  *   timeline-core cascade, re-deriving exactly those values.
  *
  * Business validation lives in `validation.ts`; `fromVideoDocument` asserts a
@@ -700,7 +729,7 @@ interface VideoDocumentValidationIssue {
  * aggregations (RFC 02 §4/§5). Absolute time, `part_aggregations`, and total
  * duration are dropped — they are re-derived by the projection.
  */
-declare function toVideoDocument(draft: VideoDraftContent): VideoDocument;
+declare function toVideoDocument(draft: Pick<VideoDraft, keyof VideoDraftContent>): VideoDocument;
 /** speech/attachment part_id → its host video part_id + relative offset. */
 type SpeechHostMap = Map<string, {
   hostPartId: string;
@@ -740,8 +769,8 @@ interface DerivedItemPosition {
  */
 declare function derivePositionFromAbs(partId: string, abs: number, isMain: boolean, speechHost: SpeechHostMap, partLibrary: Record<string, PartUnion | string | undefined>): DerivedItemPosition;
 /**
- * Project the authoritative `VideoDocument` back into the legacy `VideoDraft`
- * read-view, solving each item's absolute position, the `part_aggregations`, and
+ * Project `VideoDocument` into `VideoDraftContent`, solving each item's
+ * absolute position, the `part_aggregations`, and
  * the total duration via the timeline-core cascade.
  *
  * The read-view is a compatibility contract, and the IDL declares

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { $ as VideoDraft, A as assertValidVideoDocument, B as CaptionPart, C as index_d_exports, D as VideoDocumentMirrorSchema, E as VideoDocumentDraft, F as buildSpeechHostMap, G as Timeline, H as PartKind, I as derivePositionFromAbs, J as TrackItemTimePosition, K as Track, L as fromVideoDocument, M as buildInitialVideoDocument, N as DerivedItemPosition, O as videoDocumentMirrorSchema, P as SpeechHostMap, Q as VideoDocumentValidationIssueCode, R as toVideoDocument, S as ValidationError, T as TrackItemDraft, U as PartUnion, V as DEFAULT_UNIT_TIME_MS, W as SpeechPart, X as VideoDocument, Y as VideoClipPart, Z as VideoDocumentValidationIssue, _ as PlannedSemanticOpKind, a as MirrorVideoDocumentOptions, at as PartAggregation, b as SchemaValidator, c as CommitOptions, ct as Track$1, d as SemanticEditor, et as VideoDraftContent, f as SemanticOpInput, g as ImplementedSemanticOpKind, h as IMPLEMENTED_SEMANTIC_OP_KINDS, i as MirrorVideoDocumentAdapter, it as CaptionStyle, j as validateVideoDocument, k as VideoDocumentValidationError, l as OpActor, lt as TrackItem$1, m as TransactAudit, n as videoDocumentSchema, nt as Attachment, o as createMirrorVideoDocument, ot as SpeedShift, p as SemanticOpName, q as TrackItem, r as readVideoDocumentFromDraft, rt as CaptionPart$1, s as createMirrorVideoDocumentAdapter, st as Timeline$1, t as partUnionSchema, tt as VideoDraftPartUnion, u as SemanticDocumentAdapter, v as SemanticOpKind, w as TrackDraft, x as SnapshotReadable, y as isImplementedSemanticOpKind, z as BgmPart } from "./index-DORI7qkw.js";
+import { $ as VideoDraft, A as assertValidVideoDocument, B as CaptionPart, C as index_d_exports, D as VideoDocumentMirrorSchema, E as VideoDocumentDraft, F as buildSpeechHostMap, G as Timeline, H as PartKind, I as derivePositionFromAbs, J as TrackItemTimePosition, K as Track, L as fromVideoDocument, M as buildInitialVideoDocument, N as DerivedItemPosition, O as videoDocumentMirrorSchema, P as SpeechHostMap, Q as VideoDocumentValidationIssueCode, R as toVideoDocument, S as ValidationError, T as TrackItemDraft, U as PartUnion, V as DEFAULT_UNIT_TIME_MS, W as SpeechPart, X as VideoDocument, Y as VideoClipPart, Z as VideoDocumentValidationIssue, _ as PlannedSemanticOpKind, a as MirrorVideoDocumentOptions, at as PartAggregation, b as SchemaValidator, c as CommitOptions, ct as Track$1, d as SemanticEditor, et as VideoDraftContent, f as SemanticOpInput, g as ImplementedSemanticOpKind, h as IMPLEMENTED_SEMANTIC_OP_KINDS, i as MirrorVideoDocumentAdapter, it as CaptionStyle, j as validateVideoDocument, k as VideoDocumentValidationError, l as OpActor, lt as TrackItem$1, m as TransactAudit, n as videoDocumentSchema, nt as Attachment, o as createMirrorVideoDocument, ot as SpeedShift, p as SemanticOpName, q as TrackItem, r as readVideoDocumentFromDraft, rt as CaptionPart$1, s as createMirrorVideoDocumentAdapter, st as Timeline$1, t as partUnionSchema, tt as VideoDraftPartUnion, u as SemanticDocumentAdapter, v as SemanticOpKind, w as TrackDraft, x as SnapshotReadable, y as isImplementedSemanticOpKind, z as BgmPart } from "./index-DdnuQf17.js";
 import { PeerID } from "loro-crdt";
 import { DocState } from "@mengine/sync";
 import { BaseDocStorage, Connection, DocDiff, DocPushReceipt, DocSnapshotRecord, DocStorage, DocStorageOptions, DocUpdate, DocUpdateRecord } from "@mengine/storage";
@@ -405,8 +405,7 @@ declare class ManualSyncDoc {
    * Fetches the snapshot up front rather than starting empty and converging: the
    * agent's first act is to read the document, so there is no useful state before
    * the snapshot lands. This also fails fast and loudly on a document that does
-   * not exist, instead of `MengineDocSession.waitForContent()`'s behavior of
-   * waiting forever for content that will never arrive.
+   * not exist or whose first snapshot is incomplete or invalid.
    */
   static open(options: ManualSyncDocOptions): Promise<ManualSyncDoc>;
   /** Current document read model (authoritative shape). */

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 recordEntries, I as videoDocumentMirrorSchema, L as base64ToBytes, M as DEFAULT_UNIT_TIME_MS, N as effectiveVideoClipDurationMs, O as TIMELINE_SKELETON_DURATION_MS, P as partUnionToDraft, R as bytesToBase64, 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 } from "./document-ChxLYTqs.js";
+import { A as partDurationMs, C as reassignSpeechesToVideoClipsByTime, D as syncAggregatedClipsTimePosition, E as resolveSpeechOverlapByShiftingVideos, F as recordEntries, I as videoDocumentMirrorSchema, L as base64ToBytes, M as DEFAULT_UNIT_TIME_MS, N as effectiveVideoClipDurationMs, O as TIMELINE_SKELETON_DURATION_MS, P as partUnionToDraft, R as bytesToBase64, 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 } from "./document-CkFhI8ir.js";
 import { z } from "zod";
 import { LoroDoc, VersionVector } from "loro-crdt";
 import { ClientServerSynchronizer, DocManager } from "@mengine/sync";
@@ -2035,17 +2035,24 @@ var ManualSyncDoc = class ManualSyncDoc {
 	* Fetches the snapshot up front rather than starting empty and converging: the
 	* agent's first act is to read the document, so there is no useful state before
 	* the snapshot lands. This also fails fast and loudly on a document that does
-	* not exist, instead of `MengineDocSession.waitForContent()`'s behavior of
-	* waiting forever for content that will never arrive.
+	* not exist or whose first snapshot is incomplete or invalid.
 	*/
 	static async open(options) {
-		const doc = new LoroDoc();
-		if (options.peerId != null) doc.setPeerId(options.peerId);
 		const response = await options.client.fetchSnapshot();
-		doc.import(base64ToBytes(response.snapshot));
-		const manualSyncDoc = new ManualSyncDoc(options.client, doc);
-		manualSyncDoc.watermark = manualSyncDoc.serverVVFrom(response.version.server_vv) ?? doc.oplogVersion();
-		return manualSyncDoc;
+		const doc = new LoroDoc();
+		let manualSyncDoc;
+		try {
+			if (options.peerId != null) doc.setPeerId(options.peerId);
+			if (doc.import(base64ToBytes(response.snapshot)).pending != null) throw new Error("Initial mengine snapshot has missing dependencies");
+			manualSyncDoc = new ManualSyncDoc(options.client, doc);
+			assertValidVideoDocument(manualSyncDoc.snapshot());
+			manualSyncDoc.watermark = manualSyncDoc.serverVVFrom(response.version.server_vv) ?? doc.oplogVersion();
+			return manualSyncDoc;
+		} catch (error) {
+			manualSyncDoc?.adapter.dispose();
+			doc.free();
+			throw error;
+		}
 	}
 	/** Current document read model (authoritative shape). */
 	snapshot() {

package/dist/testing.d.ts

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

package/dist/testing.js

@@ -1,4 +1,4 @@
-import { L as base64ToBytes, R as bytesToBase64, r as createMirrorVideoDocumentAdapter } from "./document-ChxLYTqs.js";
+import { L as base64ToBytes, R as bytesToBase64, r as createMirrorVideoDocumentAdapter } from "./document-CkFhI8ir.js";
 import { t as classifyUpdate } from "./loro-relay-doc-cJSY-uau.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.3.1-alpha.3",
+  "version": "1.3.1-alpha.5",
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
@@ -25,9 +25,9 @@
   "dependencies": {
     "loro-mirror": "^2.2.0",
     "zod": "^4.4.3",
-    "@mengine/sync": "1.3.1-alpha.3",
-    "@mengine/utils": "1.3.1-alpha.3",
-    "@mengine/storage": "1.3.1-alpha.3"
+    "@mengine/storage": "1.3.1-alpha.5",
+    "@mengine/sync": "1.3.1-alpha.5",
+    "@mengine/utils": "1.3.1-alpha.5"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",