superdoc 2.16.1-next.3 → 2.16.1-next.4

package/dist/collaboration-upgrade-engine.cjs

@@ -19,7 +19,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = (0, _superdoc_docx_engine_collaboration_upgrade_engine.getCollaborationUpgradeEngineInfo)();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.16.1-next.3",
+	superdocVersion: "2.16.1-next.4",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/collaboration-upgrade-engine.es.js

@@ -18,7 +18,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = getCollaborationUpgradeEngineInfo$1();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.16.1-next.3",
+	superdocVersion: "2.16.1-next.4",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/superdoc/src/core/collaboration/resolve-v2-collaboration-target.d.ts

@@ -20,7 +20,7 @@ export type SupportedV2ProviderFamily = 'y-websocket' | 'hocuspocus' | 'livebloc
  * collaboration room. These strings are part of the diagnostic contract and are
  * safe to assert against in tests; they never carry caller-provided values.
  */
-export type V2CollaborationUnsupportedReason = 'missing-target' | 'invalid-document-id' | 'invalid-server-url' | 'invalid-room-mode' | 'invalid-auth-endpoint' | 'invalid-adapter-id' | 'invalid-provider-options' | 'missing-auth' | 'mixed-auth' | 'unsupported-document-type' | 'unsupported-multi-document' | 'unsupported-legacy-provider' | 'unsupported-provider-family';
+export type V2CollaborationUnsupportedReason = 'missing-target' | 'invalid-document-id' | 'invalid-server-url' | 'invalid-room-mode' | 'invalid-auth-endpoint' | 'invalid-adapter-id' | 'invalid-provider-options' | 'invalid-sync-timeout' | 'missing-auth' | 'mixed-auth' | 'unsupported-document-type' | 'unsupported-multi-document' | 'unsupported-legacy-provider' | 'unsupported-provider-family';
 /**
  * Normalized, supported v2 collaboration room target.
  *
@@ -47,6 +47,8 @@ export interface NormalizedV2CollaborationTarget {
     adapterId?: string;
     /** Structured-clone-safe options interpreted by the registered adapter. */
     providerOptions?: unknown;
+    /** Maximum initial synchronization wait in milliseconds. */
+    syncTimeoutMs?: number;
     /** Explicit room operation; join is the default at the untrusted input boundary. */
     roomMode: 'join' | 'create';
 }

package/dist/superdoc/src/core/types/index.d.ts

@@ -644,6 +644,8 @@ export interface V2YWebsocketCollaborationConfig {
      * an auth token). Values are strings.
      */
     params?: Record<string, string> | null;
+    /** Maximum initial synchronization wait in milliseconds. Defaults to 30,000. */
+    syncTimeoutMs?: number;
     /** Explicit room operation. Defaults to `'join'`; `'create'` never joins an existing room. */
     roomMode?: 'join' | 'create';
 }
@@ -660,6 +662,8 @@ export interface V2HocuspocusCollaborationConfig {
     params?: Record<string, string> | null;
     /** Static auth token or resolver invoked for every Hocuspocus connection. */
     token?: string | (() => string | Promise<string>);
+    /** Maximum initial synchronization wait in milliseconds. Defaults to 30,000. */
+    syncTimeoutMs?: number;
     /** Explicit room operation. Defaults to `'join'`; `'create'` never joins an existing room. */
     roomMode?: 'join' | 'create';
 }
@@ -683,6 +687,8 @@ export interface V2LiveblocksCollaborationConfig {
      * page; non-browser SDK/CLI callers must use an absolute HTTP(S) URL.
      */
     authEndpoint?: string;
+    /** Maximum initial synchronization wait in milliseconds. Defaults to 30,000. */
+    syncTimeoutMs?: number;
     /** Explicit room operation. Defaults to `'join'`; `'create'` never joins an existing room. */
     roomMode?: 'join' | 'create';
 }
@@ -697,6 +703,8 @@ export interface V2ProviderExtensionCollaborationConfig {
     providerOptions?: unknown;
     /** Optional host-owned credential resolver available to the adapter. */
     token?: string | (() => string | Promise<string>);
+    /** Maximum initial synchronization wait in milliseconds. Defaults to 30,000. */
+    syncTimeoutMs?: number;
     /** Explicit room operation. Defaults to `'join'`; `'create'` never joins an existing room. */
     roomMode?: 'join' | 'create';
 }

package/dist/superdoc.cjs

@@ -316,7 +316,7 @@ var shuffleArray = (array) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.16.1-next.3";
+		return "2.16.1-next.4";
 	} catch {
 		return "unknown";
 	}
@@ -5380,6 +5380,20 @@ function normalizeRoomMode(value) {
 	if (value === void 0) return "join";
 	return value === "join" || value === "create" ? value : null;
 }
+function normalizeSyncTimeoutMs(value) {
+	if (value === void 0) return void 0;
+	return typeof value === "number" && Number.isFinite(value) && value > 0 && value <= 2147483647 ? value : null;
+}
+function withSyncTimeout(resolution, syncTimeoutMs) {
+	if (!resolution.ok || syncTimeoutMs === void 0) return resolution;
+	return {
+		ok: true,
+		target: {
+			...resolution.target,
+			syncTimeoutMs
+		}
+	};
+}
 function invalidRoomMode() {
 	return {
 		ok: false,
@@ -5567,11 +5581,17 @@ function resolveV2CollaborationTarget(input) {
 		reason: "unsupported-legacy-provider",
 		message: "SuperDoc v2 collaboration cannot use an external { ydoc, provider } pair. v2 owns its provider; pass a collaboration target ({ providerType, documentId, serverUrl | publicApiKey | authEndpoint }) instead."
 	};
+	const syncTimeoutMs = normalizeSyncTimeoutMs(candidate.syncTimeoutMs);
+	if (syncTimeoutMs === null) return {
+		ok: false,
+		reason: "invalid-sync-timeout",
+		message: "SuperDoc v2 collaboration syncTimeoutMs must be a finite positive number within the JavaScript timer range."
+	};
 	const providerType = readProviderType(candidate);
-	if (providerType === null || providerType === "y-websocket") return resolveWebsocketFamily("y-websocket", candidate);
-	if (providerType === "hocuspocus") return resolveWebsocketFamily("hocuspocus", candidate);
-	if (providerType === "liveblocks") return resolveLiveblocksFamily(candidate, authEndpointBaseUrl);
-	if (providerType === "extension") return resolveProviderExtension(candidate);
+	if (providerType === null || providerType === "y-websocket") return withSyncTimeout(resolveWebsocketFamily("y-websocket", candidate), syncTimeoutMs);
+	if (providerType === "hocuspocus") return withSyncTimeout(resolveWebsocketFamily("hocuspocus", candidate), syncTimeoutMs);
+	if (providerType === "liveblocks") return withSyncTimeout(resolveLiveblocksFamily(candidate, authEndpointBaseUrl), syncTimeoutMs);
+	if (providerType === "extension") return withSyncTimeout(resolveProviderExtension(candidate), syncTimeoutMs);
 	return {
 		ok: false,
 		reason: "unsupported-provider-family",
@@ -45690,7 +45710,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.16.1-next.3";
+		this.version = "2.16.1-next.4";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];
@@ -46351,11 +46371,13 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		storeDoc.v2Collaboration = value;
 	}
 	#toV2CollaborationConfig(target) {
+		const syncTimeoutOption = target.syncTimeoutMs === void 0 ? {} : { syncTimeoutMs: target.syncTimeoutMs };
 		if (target.providerFamily === "extension") return {
 			providerType: "extension",
 			adapterId: target.adapterId,
 			documentId: target.documentId,
 			roomMode: target.roomMode,
+			...syncTimeoutOption,
 			...target.providerOptions !== void 0 ? { providerOptions: target.providerOptions } : {},
 			...target.token ? { token: target.token } : {}
 		};
@@ -46363,6 +46385,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 			providerType: "liveblocks",
 			documentId: target.documentId,
 			roomMode: target.roomMode,
+			...syncTimeoutOption,
 			...target.publicApiKey ? { publicApiKey: target.publicApiKey } : {},
 			...target.authEndpoint ? { authEndpoint: target.authEndpoint } : {}
 		};
@@ -46370,6 +46393,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 			providerType: "hocuspocus",
 			documentId: target.documentId,
 			roomMode: target.roomMode,
+			...syncTimeoutOption,
 			...target.serverUrl ? { serverUrl: target.serverUrl } : {},
 			...target.params ? { params: target.params } : {},
 			...target.token ? { token: target.token } : {}
@@ -46378,6 +46402,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 			providerType: "y-websocket",
 			documentId: target.documentId,
 			roomMode: target.roomMode,
+			...syncTimeoutOption,
 			...target.serverUrl ? { serverUrl: target.serverUrl } : {},
 			...target.params ? { params: target.params } : {}
 		};

package/dist/superdoc.es.js

@@ -315,7 +315,7 @@ var shuffleArray = (array) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.16.1-next.3";
+		return "2.16.1-next.4";
 	} catch {
 		return "unknown";
 	}
@@ -5379,6 +5379,20 @@ function normalizeRoomMode(value) {
 	if (value === void 0) return "join";
 	return value === "join" || value === "create" ? value : null;
 }
+function normalizeSyncTimeoutMs(value) {
+	if (value === void 0) return void 0;
+	return typeof value === "number" && Number.isFinite(value) && value > 0 && value <= 2147483647 ? value : null;
+}
+function withSyncTimeout(resolution, syncTimeoutMs) {
+	if (!resolution.ok || syncTimeoutMs === void 0) return resolution;
+	return {
+		ok: true,
+		target: {
+			...resolution.target,
+			syncTimeoutMs
+		}
+	};
+}
 function invalidRoomMode() {
 	return {
 		ok: false,
@@ -5566,11 +5580,17 @@ function resolveV2CollaborationTarget(input) {
 		reason: "unsupported-legacy-provider",
 		message: "SuperDoc v2 collaboration cannot use an external { ydoc, provider } pair. v2 owns its provider; pass a collaboration target ({ providerType, documentId, serverUrl | publicApiKey | authEndpoint }) instead."
 	};
+	const syncTimeoutMs = normalizeSyncTimeoutMs(candidate.syncTimeoutMs);
+	if (syncTimeoutMs === null) return {
+		ok: false,
+		reason: "invalid-sync-timeout",
+		message: "SuperDoc v2 collaboration syncTimeoutMs must be a finite positive number within the JavaScript timer range."
+	};
 	const providerType = readProviderType(candidate);
-	if (providerType === null || providerType === "y-websocket") return resolveWebsocketFamily("y-websocket", candidate);
-	if (providerType === "hocuspocus") return resolveWebsocketFamily("hocuspocus", candidate);
-	if (providerType === "liveblocks") return resolveLiveblocksFamily(candidate, authEndpointBaseUrl);
-	if (providerType === "extension") return resolveProviderExtension(candidate);
+	if (providerType === null || providerType === "y-websocket") return withSyncTimeout(resolveWebsocketFamily("y-websocket", candidate), syncTimeoutMs);
+	if (providerType === "hocuspocus") return withSyncTimeout(resolveWebsocketFamily("hocuspocus", candidate), syncTimeoutMs);
+	if (providerType === "liveblocks") return withSyncTimeout(resolveLiveblocksFamily(candidate, authEndpointBaseUrl), syncTimeoutMs);
+	if (providerType === "extension") return withSyncTimeout(resolveProviderExtension(candidate), syncTimeoutMs);
 	return {
 		ok: false,
 		reason: "unsupported-provider-family",
@@ -45621,7 +45641,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.16.1-next.3";
+		this.version = "2.16.1-next.4";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];
@@ -46282,11 +46302,13 @@ var SuperDoc = class extends import_eventemitter3.default {
 		storeDoc.v2Collaboration = value;
 	}
 	#toV2CollaborationConfig(target) {
+		const syncTimeoutOption = target.syncTimeoutMs === void 0 ? {} : { syncTimeoutMs: target.syncTimeoutMs };
 		if (target.providerFamily === "extension") return {
 			providerType: "extension",
 			adapterId: target.adapterId,
 			documentId: target.documentId,
 			roomMode: target.roomMode,
+			...syncTimeoutOption,
 			...target.providerOptions !== void 0 ? { providerOptions: target.providerOptions } : {},
 			...target.token ? { token: target.token } : {}
 		};
@@ -46294,6 +46316,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 			providerType: "liveblocks",
 			documentId: target.documentId,
 			roomMode: target.roomMode,
+			...syncTimeoutOption,
 			...target.publicApiKey ? { publicApiKey: target.publicApiKey } : {},
 			...target.authEndpoint ? { authEndpoint: target.authEndpoint } : {}
 		};
@@ -46301,6 +46324,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 			providerType: "hocuspocus",
 			documentId: target.documentId,
 			roomMode: target.roomMode,
+			...syncTimeoutOption,
 			...target.serverUrl ? { serverUrl: target.serverUrl } : {},
 			...target.params ? { params: target.params } : {},
 			...target.token ? { token: target.token } : {}
@@ -46309,6 +46333,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 			providerType: "y-websocket",
 			documentId: target.documentId,
 			roomMode: target.roomMode,
+			...syncTimeoutOption,
 			...target.serverUrl ? { serverUrl: target.serverUrl } : {},
 			...target.params ? { params: target.params } : {}
 		};