@mengine/medeo-client 2.0.1-alpha.1 → 2.0.1-alpha.3

package/README.md

@@ -41,3 +41,9 @@ The session assembles SemanticEditor with MirrorVideoDocumentAdapter directly. D
 Undo/redo append ordinary synchronized updates and retain audit metadata (`Undo`/`Redo`, actor, and `payload.source` identifying an original local change). Existing revision bindings remain immutable. Redo reuses already materialized assets without repeating generation, billing, or attachment requests. Network failures do not automatically reverse history.
 
 Loro history uses new writes: undo on a shared LWW field restores its value before the local edit, potentially overwriting a later remote write to the same field; redo restores the value visible before undo. Unrelated remote fields remain intact. Undoing a local insertion removes the object and makes dependent remote edits invisible until redo restores the object. Caption creation includes its style container, even when empty, so a later style edit only changes fields and undo preserves another peer's independently edited fields. Initial document seeding preserves supplied styles and creates empty maps for captions without styles. No write-time repair or migration of older CRDT documents is provided.
+
+## Large-update resynchronization
+
+`MengineDocSession` handles SSE `event: resync` by scheduling the existing version-vector sync on the current connection. The event carries no Loro bytes and does not create an edit or undo step. A hint arriving while an HTTP sync is in flight schedules another diff so changes newer than that response are still fetched. Low-level users of `readMengineEventStream` can handle the same hint with `onResync`; `MedeoHttpDocStorage` exposes `subscribeResync`.
+
+Deploy this client before enabling server-side resync notifications. Older clients ignore the event. Large HTTP pushes remain valid: the server chooses inline update or resync notification after persistence, rather than requiring client-side fragmentation. Base64 encoding uses `Uint8Array.toBase64()` where available, with a chunked fallback preserving the same padded wire representation.

package/dist/{document-CmjJwOba.js → document-B_JQwrC5.js}

@@ -3,9 +3,11 @@ import { z } from "zod";
 import { LoroDoc } from "loro-crdt";
 //#region src/client/base64.ts
 function bytesToBase64(bytes) {
-	let binary = "";
-	for (const byte of bytes) binary += String.fromCharCode(byte);
-	return btoa(binary);
+	const native = bytes.toBase64;
+	if (typeof native === "function") return native.call(bytes);
+	const chunks = [];
+	for (let offset = 0; offset < bytes.length; offset += 8192) chunks.push(String.fromCharCode(...bytes.subarray(offset, offset + 8192)));
+	return btoa(chunks.join(""));
 }
 function base64ToBytes(base64) {
 	const binary = atob(base64);

package/dist/index.d.ts

@@ -173,6 +173,8 @@ interface MengineEventStreamOptions {
   /** Fired once the stream response is established (HTTP ok, body readable). */
   onOpen?(): void;
   onUpdate(event: MengineSseUpdateEvent): void;
+  /** A committed update omitted from live transport; fetch the missing operations by VV. */
+  onResync?(): void;
 }
 declare function readMengineEventStream(options: MengineEventStreamOptions): Promise<void>;
 //#endregion
@@ -574,6 +576,8 @@ declare class MedeoHttpDocStorage implements DocStorage {
    * tool-level ack wait) subscribe here.
    */
   subscribePushOutcome(callback: (outcome: PushOutcome) => void): () => void;
+  /** Observe live hints that require VV catch-up without replacing the SSE connection. */
+  subscribeResync(callback: () => void): () => void;
   /** Authoritative HTTP reads and accepted pushes, never inferred from SSE bytes. */
   subscribeServerVersion(callback: (version: Uint8Array) => void): () => void;
   private reportServerVersion;

package/dist/index.js

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./chunk-D7D4PA-g.js";
-import { A as isEmptyVideoClip, C as fillMainTrackTimeGaps, D as resolveSpeechOverlapByShiftingVideos, E as resolveAllSpeechOverlaps, F as partUnionToDraft, I as recordEntries, L as videoDocumentMirrorSchema, M as safeDurationMs, N as DEFAULT_UNIT_TIME_MS, O as syncAggregatedClipsTimePosition, P as effectiveVideoClipDurationMs, R as base64ToBytes, S as arrangeMainTrackSeamlessly, T as recalculateTimelineDuration, _ as ensureLaneTrack, a as DocumentMutationGuard, b as solveVideoDocument, c as derivePositionFromAbs, d as VideoDocumentValidationError, f as assertValidVideoDocument, g as LANE_KINDS_IN_STACK_ORDER, h as videoDocumentSchema, i as readVideoDocumentFromDraft, j as partDurationMs, k as TIMELINE_SKELETON_DURATION_MS, l as fromVideoDocument, m as partUnionSchema, n as createMirrorVideoDocument, o as buildInitialVideoDocument, p as validateVideoDocument, r as createMirrorVideoDocumentAdapter, s as buildSpeechHostMap, t as MirrorVideoDocumentAdapter, u as toVideoDocument, v as findLaneTrack, w as reassignSpeechesToVideoClipsByTime, x as cascadeAfterVideoClipChanges, y as laneTrackId, z as bytesToBase64 } from "./document-CmjJwOba.js";
+import { A as isEmptyVideoClip, C as fillMainTrackTimeGaps, D as resolveSpeechOverlapByShiftingVideos, E as resolveAllSpeechOverlaps, F as partUnionToDraft, I as recordEntries, L as videoDocumentMirrorSchema, M as safeDurationMs, N as DEFAULT_UNIT_TIME_MS, O as syncAggregatedClipsTimePosition, P as effectiveVideoClipDurationMs, R as base64ToBytes, S as arrangeMainTrackSeamlessly, T as recalculateTimelineDuration, _ as ensureLaneTrack, a as DocumentMutationGuard, b as solveVideoDocument, c as derivePositionFromAbs, d as VideoDocumentValidationError, f as assertValidVideoDocument, g as LANE_KINDS_IN_STACK_ORDER, h as videoDocumentSchema, i as readVideoDocumentFromDraft, j as partDurationMs, k as TIMELINE_SKELETON_DURATION_MS, l as fromVideoDocument, m as partUnionSchema, n as createMirrorVideoDocument, o as buildInitialVideoDocument, p as validateVideoDocument, r as createMirrorVideoDocumentAdapter, s as buildSpeechHostMap, t as MirrorVideoDocumentAdapter, u as toVideoDocument, v as findLaneTrack, w as reassignSpeechesToVideoClipsByTime, x as cascadeAfterVideoClipChanges, y as laneTrackId, z as bytesToBase64 } from "./document-B_JQwrC5.js";
 import { z } from "zod";
 import { LoroDoc, UndoManager, VersionVector, decodeImportBlobMeta } from "loro-crdt";
 import { ClientServerSynchronizer, DocManager } from "@mengine/sync";
@@ -163,9 +163,6 @@ async function safeReadJson(response) {
 //#endregion
 //#region src/client/sse.ts
 async function readMengineEventStream(options) {
-	const onUpdate = (event) => {
-		options.onUpdate(event);
-	};
 	const response = await options.client.fetch(options.client.eventsUrl(), {
 		headers: options.client.headers(),
 		signal: options.signal
@@ -184,15 +181,19 @@ async function readMengineEventStream(options) {
 		while (splitAt >= 0) {
 			const frame = buffer.slice(0, splitAt);
 			buffer = buffer.slice(buffer[splitAt] === "\r" ? splitAt + 4 : splitAt + 2);
-			handleSseFrame(frame, onUpdate);
+			handleSseFrame(frame, options);
 			splitAt = findSseFrameBoundary(buffer);
 		}
 	}
 }
-function handleSseFrame(frame, onUpdate) {
+function handleSseFrame(frame, options) {
 	const event = parseSseFrame(frame);
+	if (event.event === "resync") {
+		options.onResync?.();
+		return;
+	}
 	if (event.event !== "update" || event.data.length === 0) return;
-	onUpdate(JSON.parse(event.data.join("\n")));
+	options.onUpdate(JSON.parse(event.data.join("\n")));
 }
 function parseSseFrame(frame) {
 	let event = null;
@@ -2199,22 +2200,24 @@ var ManualSyncDoc = class ManualSyncDoc {
 * recovers whatever the stream missed while it was down. Recovery therefore
 * lives in the synchronizer (keyed on the real doc version), not here.
 *
-* Each SSE frame's updates are forwarded verbatim via `onUpdate`; this
+* Update frames are forwarded via `onUpdate`, resync hints via `onResync`; this
 * connection keeps no version cursor and does no catch-up of its own. Dedup is
 * unnecessary because `LoroDoc.import` is idempotent by OpId/VV.
 */
 var SseConnection = class {
 	client;
 	onUpdate;
+	onResync;
 	reconnectDelayMs;
 	inner = void 0;
 	event = new EventBus();
 	streamTask = null;
 	_status = "idle";
 	_error;
-	constructor(client, onUpdate, reconnectDelayMs) {
+	constructor(client, onUpdate, onResync, reconnectDelayMs) {
 		this.client = client;
 		this.onUpdate = onUpdate;
+		this.onResync = onResync;
 		this.reconnectDelayMs = reconnectDelayMs;
 	}
 	get status() {
@@ -2275,6 +2278,7 @@ var SseConnection = class {
 					client: this.client,
 					signal,
 					onOpen: () => this.setStatus("connected"),
+					onResync: this.onResync,
 					onUpdate: (event) => {
 						for (const update of event.updates) this.onUpdate(update);
 					}
@@ -2324,7 +2328,7 @@ var MedeoHttpDocStorage = class {
 		this.options = options;
 		this.client = options.client;
 		this.docId = options.docId;
-		this.connection = new SseConnection(this.client, (update) => this.emitUpdate(update), options.sseReconnectDelayMs ?? 500);
+		this.connection = new SseConnection(this.client, (update) => this.emitUpdate(update), () => this.events.emit("resync"), options.sseReconnectDelayMs ?? 500);
 	}
 	get isReadonly() {
 		return this.options.readonlyMode ?? false;
@@ -2403,6 +2407,10 @@ var MedeoHttpDocStorage = class {
 	subscribePushOutcome(callback) {
 		return this.events.on("pushOutcome", callback);
 	}
+	/** Observe live hints that require VV catch-up without replacing the SSE connection. */
+	subscribeResync(callback) {
+		return this.events.on("resync", callback);
+	}
 	/** Authoritative HTTP reads and accepted pushes, never inferred from SSE bytes. */
 	subscribeServerVersion(callback) {
 		return this.events.on("serverVersion", callback);
@@ -2887,6 +2895,7 @@ var MengineDocSession = class {
 		return this.startTask;
 	}
 	async open() {
+		this.disposables.add(this.server.subscribeResync(() => this.synchronizer.requestSync(this.docId)));
 		this.disposables.add(this.server.subscribeServerVersion((version) => {
 			this.serverVVValue = version;
 			if (this.getSyncState().confirmation === "confirmed") this.pushErrorValue = null;

package/dist/testing.js

@@ -1,4 +1,4 @@
-import { R as base64ToBytes, r as createMirrorVideoDocumentAdapter, z as bytesToBase64 } from "./document-CmjJwOba.js";
+import { R as base64ToBytes, r as createMirrorVideoDocumentAdapter, z as bytesToBase64 } from "./document-B_JQwrC5.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": "2.0.1-alpha.1",
+  "version": "2.0.1-alpha.3",
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
@@ -25,9 +25,9 @@
   "dependencies": {
     "loro-mirror": "^2.3.3",
     "zod": "^4.4.3",
-    "@mengine/storage": "2.0.1-alpha.1",
-    "@mengine/sync": "2.0.1-alpha.1",
-    "@mengine/utils": "2.0.1-alpha.1"
+    "@mengine/storage": "2.0.1-alpha.3",
+    "@mengine/sync": "2.0.1-alpha.3",
+    "@mengine/utils": "2.0.1-alpha.3"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",