superdoc 2.16.1-next.3 → 2.16.1-next.5

package/dist/document-api/src/contract/types.d.ts

@@ -1,6 +1,6 @@
 import { OperationId } from './operation-definitions.js';
 import { CommandStaticMetadata } from './metadata-types.js';
-export { OPERATION_IDEMPOTENCY_VALUES, type OperationIdempotency, PRE_APPLY_THROW_CODES, type PreApplyThrowCode, type CommandThrowPolicy, type CommandStaticMetadata, } from './metadata-types.js';
+export { OPERATION_IDEMPOTENCY_VALUES, type OperationIdempotency, OPERATION_TRACKED_SUPPORT_VALUES, type OperationTrackedSupport, PRE_APPLY_THROW_CODES, type PreApplyThrowCode, type CommandThrowPolicy, type CommandStaticMetadata, } from './metadata-types.js';
 export { type OperationId, OPERATION_IDS, SINGLETON_OPERATION_IDS, NAMESPACED_OPERATION_IDS, } from './operation-definitions.js';
 export declare const CONTRACT_VERSION = "0.1.0";
 export declare const JSON_SCHEMA_DIALECT = "https://json-schema.org/draft/2020-12/schema";

package/dist/document-api/src/index.d.ts

@@ -32,7 +32,7 @@ import { TableLocator, TableMutationResult, TablesConvertFromTextInput, TablesMo
 import { TrackChangesAdapter, TrackChangesApi } from './track-changes/track-changes.js';
 import { MutationOptions, RichContentMutationOptions, WriteAdapter } from './write/write.js';
 import { SelectionMutationAdapter } from './selection-mutation.js';
-import { CapabilitiesAdapter, DocumentApiCapabilities } from './capabilities/capabilities.js';
+import { CapabilitiesAdapter, DocumentApiCapabilities, OperationCapabilityResolveInput, OperationCapabilityResolveResult } from './capabilities/capabilities.js';
 import { SDHtmlMarkdownSupportCheckInput, SDHtmlMarkdownSupportCheckResult } from './capabilities/html-markdown-support.js';
 import { OperationId } from './contract/types.js';
 import { DynamicInvokeRequest, InvokeRequest, InvokeResult } from './contract/operation-registry.js';
@@ -242,6 +242,7 @@ export interface CapabilitiesApi {
     (): DocumentApiCapabilities;
     get(): DocumentApiCapabilities;
     check(input: SDHtmlMarkdownSupportCheckInput): Promise<SDHtmlMarkdownSupportCheckResult>;
+    resolve(input: OperationCapabilityResolveInput): OperationCapabilityResolveResult;
 }
 export interface QueryApi {
     /** Accepts canonical nested input or a selector shorthand normalized to `{ select: ... }` internally. */
@@ -267,7 +268,7 @@ export interface MutationsAdapter {
 /**
  * The Document API interface for querying and inspecting document nodes.
  */
-export interface DocumentApi {
+export interface DocumentApiSurface {
     /**
      * Read the full document as an SDDocument structure.
      * @param input - Get input with optional read options.
@@ -511,6 +512,9 @@ export interface DocumentApi {
      * Callable directly (`capabilities()`) or via `.get()`.
      */
     capabilities: CapabilitiesApi;
+}
+/** Complete Document API surface, including typed dynamic invocation. */
+export interface DocumentApi extends DocumentApiSurface {
     /**
      * Dynamically dispatch any operation by its operation ID.
      *

package/dist/document-api/src/invoke/invoke.d.ts

@@ -1,5 +1,5 @@
-import { OperationId } from '../contract/types.js';
 import { OperationRegistry } from '../contract/operation-registry.js';
+import { OperationId } from '../contract/types.js';
 import { DocumentApi } from '../index.js';
 type DispatchOutput<K extends OperationId> = K extends 'mutations.preview' | 'mutations.apply' ? Promise<OperationRegistry[K]['output']> : K extends 'plan.execute' ? OperationRegistry[K]['output'] | Promise<OperationRegistry[K]['output']> : OperationRegistry[K]['output'];
 type TypedDispatchHandler<K extends OperationId> = OperationRegistry[K]['options'] extends never ? (input: OperationRegistry[K]['input']) => DispatchOutput<K> : (input: OperationRegistry[K]['input'], options?: OperationRegistry[K]['options']) => DispatchOutput<K>;
@@ -7,12 +7,8 @@ export type TypedDispatchTable = {
     [K in OperationId]: TypedDispatchHandler<K>;
 };
 /**
- * Builds a dispatch table that maps every OperationId to the corresponding
- * direct method call on the given DocumentApi instance.
- *
- * Each entry delegates to the direct method: no parallel execution path.
- * The return type is {@link TypedDispatchTable}, which validates at compile
- * time that each handler conforms to the {@link OperationRegistry} contract.
+ * Builds the generic invoke dispatch from the same operation definitions that
+ * publish operation IDs and direct API member paths.
  */
 export declare function buildDispatchTable(api: DocumentApi): TypedDispatchTable;
 export {};

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/src/public/ui/types.d.ts

@@ -30,7 +30,7 @@ import { BuiltInCommandId } from './commands.js';
  * (`scripts/ensure-types.cjs` `rewriteDocApiPaths`), so no bare private
  * specifier leaks into the emitted `.d.ts`.
  */
-export type { Receipt, SelectionInfo, SelectionTarget, SelectionPoint, TextTarget, TextAddress, ScrollIntoViewInput, ScrollIntoViewOutput, DocumentApi, EntityAddress, CommentsListQuery as DocumentApiCommentsListQuery, CommentsListResult, TrackChangesListResult, ContentControlsListResult, ContentControlInfo, RichContentInsertInput, SDHtmlMarkdownSupportCheckResult, PictureWatermarkInput, TextWatermark, WatermarkInfo, WatermarkTarget, } from '../../../../document-api/src/index.js';
+export type { Receipt, SelectionInfo, SelectionTarget, SelectionPoint, TextTarget, TextAddress, ScrollIntoViewInput, ScrollIntoViewOutput, DocumentApi, EntityAddress, CommentsListQuery as DocumentApiCommentsListQuery, CommentsListResult, TrackChangesListResult, ContentControlsListResult, ContentControlInfo, RichContentInsertInput, OperationCapabilityResolveResult, SDHtmlMarkdownSupportCheckResult, PictureWatermarkInput, TextWatermark, WatermarkInfo, WatermarkTarget, } from '../../../../document-api/src/index.js';
 export type { StyleCatalogView, StyleCatalogItemType, StyleCatalogFilterType, StyleProvenance, StyleCatalogItemVisibility, StyleCatalogItemUsage, StyleCatalogItemPreview, StyleCatalogItem, StyleCatalogDefaults, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult, } from '../../../../document-api/src/index.js';
 export type { ListPresetId } from '../../../../document-api/src/index.js';
 export type { BrowserDocumentApi, PartialBrowserDocumentApi } from '../browser-document-api.js';

package/dist/superdoc/src/public/ui.d.cts

@@ -40,6 +40,7 @@ import type { FontsHandle as __Cjs_FontsHandle } from './ui.js' with { "resoluti
 import type { FontSizeOption as __Cjs_FontSizeOption } from './ui.js' with { "resolution-mode": "import" };
 import type { FontsSlice as __Cjs_FontsSlice } from './ui.js' with { "resolution-mode": "import" };
 import type { MetadataHandle as __Cjs_MetadataHandle } from './ui.js' with { "resolution-mode": "import" };
+import type { OperationCapabilityResolveResult as __Cjs_OperationCapabilityResolveResult } from './ui.js' with { "resolution-mode": "import" };
 import type { PartialBrowserDocumentApi as __Cjs_PartialBrowserDocumentApi } from './ui.js' with { "resolution-mode": "import" };
 import type { PictureWatermarkInput as __Cjs_PictureWatermarkInput } from './ui.js' with { "resolution-mode": "import" };
 import type { Receipt as __Cjs_Receipt } from './ui.js' with { "resolution-mode": "import" };
@@ -154,6 +155,7 @@ export type { __Cjs_FontsHandle as FontsHandle };
 export type { __Cjs_FontSizeOption as FontSizeOption };
 export type { __Cjs_FontsSlice as FontsSlice };
 export type { __Cjs_MetadataHandle as MetadataHandle };
+export type { __Cjs_OperationCapabilityResolveResult as OperationCapabilityResolveResult };
 export type { __Cjs_PartialBrowserDocumentApi as PartialBrowserDocumentApi };
 export type { __Cjs_PictureWatermarkInput as PictureWatermarkInput };
 export type { __Cjs_Receipt as Receipt };

package/dist/superdoc/src/public/ui.d.ts

@@ -26,4 +26,4 @@
 export { createSuperDocUI } from './ui/create-super-doc-ui.js';
 export { shallowEqual } from './ui/equality.js';
 export { BUILT_IN_COMMAND_IDS } from './ui/commands.js';
-export type { EqualityFn, SelectorFn, Subscribable, SuperDocUI, BorrowedSuperDocUI, SuperDocUIOptions, SuperDocUIState, SuperDocUIScope, SuperDocLike, SuperDocEditorLike, CommandHandle, CommandState, CommandExecutionResult, WorkflowReceipt, WorkflowActionResult, WorkflowScrollResult, SelectionRestoreResult, SuperDocUIReason, CommandId, CommandsHandle, ContextMenuItem, ContextMenuHandle, SearchController, SearchHandle, SearchQueryOptions, CustomCommandContext, CustomCommandHandle, CustomCommandHandleState, CustomCommandRegistration, CustomCommandRegistrationResult, MetadataHandle, SelectionHandle, ToolbarHandle, BuiltInCommandId, ToolbarCommandId, CommentsHandle, TrackChangesHandle, ContentControlsHandle, ContentControlFocusResult, ContentControlHighlightResult, FontsHandle, ZoomHandle, DocumentHandle, DocumentReplacementResult, ViewportHandle, StylesHandle, ActiveParagraphStyle, SliceStatus, SelectionSlice, SelectionCapture, CommentAnchorCapture, ToolbarSnapshotSlice, CommentsSlice, TrackChangesSlice, ContentControlsSlice, FontsSlice, ZoomSlice, DocumentSlice, StylesSlice, SearchSnapshot, SearchSlice, StyleCatalogView, StyleCatalogItemType, StyleCatalogFilterType, StyleProvenance, StyleCatalogItemVisibility, StyleCatalogItemUsage, StyleCatalogItemPreview, StyleCatalogItem, StyleCatalogDefaults, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult, CommentInfo, CommentsListQuery, TrackChangeInfo, TrackChangePointHit, TrackChangesItem, FontFamilyOption, FontSizeOption, CommentAddress, TrackedChangeAddress, ContentControlViewportAddress, ViewportEntityAddress, ViewportEntityHit, ViewportContext, ViewportRect, ViewportGetRectInput, ViewportRectResult, BrowserDocumentApi, PartialBrowserDocumentApi, DocumentApi, Receipt, SelectionInfo, SelectionTarget, SelectionPoint, TextTarget, TextAddress, ScrollIntoViewInput, ScrollIntoViewOutput, EntityAddress, CommentsListResult, TrackChangesListResult, ContentControlsListResult, ContentControlInfo, RichContentInsertInput, SDHtmlMarkdownSupportCheckResult, PictureWatermarkInput, TextWatermark, WatermarkInfo, WatermarkTarget, } from './ui/types.js';
+export type { EqualityFn, SelectorFn, Subscribable, SuperDocUI, BorrowedSuperDocUI, SuperDocUIOptions, SuperDocUIState, SuperDocUIScope, SuperDocLike, SuperDocEditorLike, CommandHandle, CommandState, CommandExecutionResult, WorkflowReceipt, WorkflowActionResult, WorkflowScrollResult, SelectionRestoreResult, SuperDocUIReason, CommandId, CommandsHandle, ContextMenuItem, ContextMenuHandle, SearchController, SearchHandle, SearchQueryOptions, CustomCommandContext, CustomCommandHandle, CustomCommandHandleState, CustomCommandRegistration, CustomCommandRegistrationResult, MetadataHandle, SelectionHandle, ToolbarHandle, BuiltInCommandId, ToolbarCommandId, CommentsHandle, TrackChangesHandle, ContentControlsHandle, ContentControlFocusResult, ContentControlHighlightResult, FontsHandle, ZoomHandle, DocumentHandle, DocumentReplacementResult, ViewportHandle, StylesHandle, ActiveParagraphStyle, SliceStatus, SelectionSlice, SelectionCapture, CommentAnchorCapture, ToolbarSnapshotSlice, CommentsSlice, TrackChangesSlice, ContentControlsSlice, FontsSlice, ZoomSlice, DocumentSlice, StylesSlice, SearchSnapshot, SearchSlice, StyleCatalogView, StyleCatalogItemType, StyleCatalogFilterType, StyleProvenance, StyleCatalogItemVisibility, StyleCatalogItemUsage, StyleCatalogItemPreview, StyleCatalogItem, StyleCatalogDefaults, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult, CommentInfo, CommentsListQuery, TrackChangeInfo, TrackChangePointHit, TrackChangesItem, FontFamilyOption, FontSizeOption, CommentAddress, TrackedChangeAddress, ContentControlViewportAddress, ViewportEntityAddress, ViewportEntityHit, ViewportContext, ViewportRect, ViewportGetRectInput, ViewportRectResult, BrowserDocumentApi, PartialBrowserDocumentApi, DocumentApi, Receipt, SelectionInfo, SelectionTarget, SelectionPoint, TextTarget, TextAddress, ScrollIntoViewInput, ScrollIntoViewOutput, EntityAddress, CommentsListResult, TrackChangesListResult, ContentControlsListResult, ContentControlInfo, RichContentInsertInput, OperationCapabilityResolveResult, SDHtmlMarkdownSupportCheckResult, PictureWatermarkInput, TextWatermark, WatermarkInfo, WatermarkTarget, } from './ui/types.js';

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.5";
 	} 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.5";
 		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.5";
 	} 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.5";
 		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 } : {}
 		};