superdoc 2.13.0-next.2 → 2.13.0-next.3

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.13.0-next.2";
+		return "2.13.0-next.3";
 	} catch {
 		return "unknown";
 	}
@@ -20579,7 +20579,7 @@ function resolveWebsocketFamily(family, candidate) {
 		message: `SuperDoc v2 collaboration requires a valid ws:// or wss:// URL for the "${family}" provider (received: ${redactCollaborationUrl(rawUrl)}).`
 	};
 	const params = normalizeParams(candidate.params);
-	const token = family === "hocuspocus" ? normalizeNonEmptyString(candidate.token) : null;
+	const token = family === "hocuspocus" && typeof candidate.token === "function" ? candidate.token : family === "hocuspocus" ? normalizeNonEmptyString(candidate.token) : null;
 	const roomMode = normalizeRoomMode(candidate.roomMode);
 	if (!roomMode) return invalidRoomMode();
 	return {
@@ -20594,6 +20594,43 @@ function resolveWebsocketFamily(family, candidate) {
 		}
 	};
 }
+function resolveProviderExtension(candidate) {
+	const adapterId = normalizeNonEmptyString(candidate.adapterId);
+	if (!adapterId) return {
+		ok: false,
+		reason: "invalid-adapter-id",
+		message: "SuperDoc v2 provider extensions require a non-empty v2Collaboration.adapterId."
+	};
+	const documentId = normalizeNonEmptyString(candidate.documentId);
+	if (!documentId) return {
+		ok: false,
+		reason: "invalid-document-id",
+		message: "SuperDoc v2 provider extensions require a non-empty v2Collaboration.documentId."
+	};
+	const roomMode = normalizeRoomMode(candidate.roomMode);
+	if (!roomMode) return invalidRoomMode();
+	if (Object.prototype.hasOwnProperty.call(candidate, "providerOptions")) try {
+		structuredClone(candidate.providerOptions);
+	} catch {
+		return {
+			ok: false,
+			reason: "invalid-provider-options",
+			message: "SuperDoc v2 provider extension options must be structured-clone-safe."
+		};
+	}
+	const token = typeof candidate.token === "function" ? candidate.token : normalizeNonEmptyString(candidate.token);
+	return {
+		ok: true,
+		target: {
+			providerFamily: "extension",
+			adapterId,
+			documentId,
+			roomMode,
+			...Object.prototype.hasOwnProperty.call(candidate, "providerOptions") ? { providerOptions: candidate.providerOptions } : {},
+			...token ? { token } : {}
+		}
+	};
+}
 /** Resolve the Liveblocks family (exactly one of publicApiKey / authEndpoint). */
 function resolveLiveblocksFamily(candidate, authEndpointBaseUrl) {
 	const documentId = normalizeNonEmptyString(candidate.documentId ?? candidate.roomId);
@@ -20690,10 +20727,11 @@ function resolveV2CollaborationTarget(input) {
 	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);
 	return {
 		ok: false,
 		reason: "unsupported-provider-family",
-		message: `SuperDoc v2 collaboration does not support the "${providerType}" provider family. Supported families are y-websocket, hocuspocus, and liveblocks.`
+		message: `SuperDoc v2 collaboration does not support the "${providerType}" provider family. Supported families are y-websocket, hocuspocus, liveblocks, and extension.`
 	};
 }
 //#endregion
@@ -21888,6 +21926,10 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 		const clearV2RuntimeRegistration = (documentId) => {
 			clearV2CommandShortcutBinding(documentId);
 			clearV2SessionShortcutBinding(documentId);
+			const document = getDocument(documentId);
+			const provider = document?.provider ?? null;
+			if (provider && proxy.$superdoc.provider === provider) proxy.$superdoc.provider = void 0;
+			if (document && provider?.sendStateless) document.provider = null;
 			const entry = v2Runtimes.get(documentId);
 			if (!entry) return;
 			proxy.$superdoc.unregisterEditorRuntime(entry.runtimeId);
@@ -22076,7 +22118,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 			clearV2EditorFailure(payload.documentId ?? null);
 			clearV2AuthorRequired(payload.documentId ?? null);
 			clearV2EditRejected(payload.documentId ?? null);
-			const { host, mount, documentId, capabilities, editCommands, bindEditShortcuts, bindSessionShortcuts, commentsAdapter, trackedChangesAdapter, contextMenu, documentApi, documentMutationReadiness, documentApiUnavailableReason, pageMetrics, pageLayout, pageFurniture, presence, lock, fonts, replaceFile, upgradeToCollaboration, documentOpenToken } = payload;
+			const { host, mount, documentId, capabilities, editCommands, bindEditShortcuts, bindSessionShortcuts, commentsAdapter, trackedChangesAdapter, contextMenu, documentApi, documentMutationReadiness, documentApiUnavailableReason, pageMetrics, pageLayout, pageFurniture, presence, lock, collaborationProvider, fonts, replaceFile, upgradeToCollaboration, documentOpenToken } = payload;
 			documentOpenTelemetry?.trackDocumentOpen(documentOpenToken ?? null, documentId ?? null);
 			const saveV2Bytes = async (saveOptions = {}) => {
 				if (!host || typeof host.save !== "function") throw new Error("v2-editor: save unavailable");
@@ -22351,6 +22393,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 				pageFurniture: pageFurniture ?? null,
 				presence: presence ?? null,
 				lock: lock ?? null,
+				provider: collaborationProvider ?? null,
 				reviewWindow: {
 					getDiagnostics: () => v2ReviewWindowController.getDiagnostics(),
 					getSnapshot: () => v2ReviewWindowController.getSnapshot?.() ?? null,
@@ -22385,6 +22428,11 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 				proxy.$superdoc.setActiveEditor(facade);
 				syncV2EditRejectedActiveDocument();
 			}
+			if (collaborationProvider) {
+				const provider = (0, vue.markRaw)(collaborationProvider);
+				proxy.$superdoc.provider = provider;
+				if (doc) doc.provider = provider;
+			}
 			proxy.$superdoc.broadcastEditorCreate(facade);
 			installV2CommandShortcutBinding({
 				documentId,
@@ -24160,7 +24208,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 			], 38);
 		};
 	}
-}, [["__scopeId", "data-v-0d27f262"]]);
+}, [["__scopeId", "data-v-f0b56abb"]]);
 //#endregion
 //#region src/core/create-app.js
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
@@ -45356,7 +45404,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.13.0-next.2";
+		this.version = "2.13.0-next.3";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];
@@ -46010,6 +46058,14 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		storeDoc.v2Collaboration = value;
 	}
 	#toV2CollaborationConfig(target) {
+		if (target.providerFamily === "extension") return {
+			providerType: "extension",
+			adapterId: target.adapterId,
+			documentId: target.documentId,
+			roomMode: target.roomMode,
+			...target.providerOptions !== void 0 ? { providerOptions: target.providerOptions } : {},
+			...target.token ? { token: target.token } : {}
+		};
 		if (target.providerFamily === "liveblocks") return {
 			providerType: "liveblocks",
 			documentId: target.documentId,

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.13.0-next.2";
+		return "2.13.0-next.3";
 	} catch {
 		return "unknown";
 	}
@@ -20547,7 +20547,7 @@ function resolveWebsocketFamily(family, candidate) {
 		message: `SuperDoc v2 collaboration requires a valid ws:// or wss:// URL for the "${family}" provider (received: ${redactCollaborationUrl(rawUrl)}).`
 	};
 	const params = normalizeParams(candidate.params);
-	const token = family === "hocuspocus" ? normalizeNonEmptyString(candidate.token) : null;
+	const token = family === "hocuspocus" && typeof candidate.token === "function" ? candidate.token : family === "hocuspocus" ? normalizeNonEmptyString(candidate.token) : null;
 	const roomMode = normalizeRoomMode(candidate.roomMode);
 	if (!roomMode) return invalidRoomMode();
 	return {
@@ -20562,6 +20562,43 @@ function resolveWebsocketFamily(family, candidate) {
 		}
 	};
 }
+function resolveProviderExtension(candidate) {
+	const adapterId = normalizeNonEmptyString(candidate.adapterId);
+	if (!adapterId) return {
+		ok: false,
+		reason: "invalid-adapter-id",
+		message: "SuperDoc v2 provider extensions require a non-empty v2Collaboration.adapterId."
+	};
+	const documentId = normalizeNonEmptyString(candidate.documentId);
+	if (!documentId) return {
+		ok: false,
+		reason: "invalid-document-id",
+		message: "SuperDoc v2 provider extensions require a non-empty v2Collaboration.documentId."
+	};
+	const roomMode = normalizeRoomMode(candidate.roomMode);
+	if (!roomMode) return invalidRoomMode();
+	if (Object.prototype.hasOwnProperty.call(candidate, "providerOptions")) try {
+		structuredClone(candidate.providerOptions);
+	} catch {
+		return {
+			ok: false,
+			reason: "invalid-provider-options",
+			message: "SuperDoc v2 provider extension options must be structured-clone-safe."
+		};
+	}
+	const token = typeof candidate.token === "function" ? candidate.token : normalizeNonEmptyString(candidate.token);
+	return {
+		ok: true,
+		target: {
+			providerFamily: "extension",
+			adapterId,
+			documentId,
+			roomMode,
+			...Object.prototype.hasOwnProperty.call(candidate, "providerOptions") ? { providerOptions: candidate.providerOptions } : {},
+			...token ? { token } : {}
+		}
+	};
+}
 /** Resolve the Liveblocks family (exactly one of publicApiKey / authEndpoint). */
 function resolveLiveblocksFamily(candidate, authEndpointBaseUrl) {
 	const documentId = normalizeNonEmptyString(candidate.documentId ?? candidate.roomId);
@@ -20658,10 +20695,11 @@ function resolveV2CollaborationTarget(input) {
 	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);
 	return {
 		ok: false,
 		reason: "unsupported-provider-family",
-		message: `SuperDoc v2 collaboration does not support the "${providerType}" provider family. Supported families are y-websocket, hocuspocus, and liveblocks.`
+		message: `SuperDoc v2 collaboration does not support the "${providerType}" provider family. Supported families are y-websocket, hocuspocus, liveblocks, and extension.`
 	};
 }
 //#endregion
@@ -21848,6 +21886,10 @@ var SuperDoc_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 		const clearV2RuntimeRegistration = (documentId) => {
 			clearV2CommandShortcutBinding(documentId);
 			clearV2SessionShortcutBinding(documentId);
+			const document = getDocument(documentId);
+			const provider = document?.provider ?? null;
+			if (provider && proxy.$superdoc.provider === provider) proxy.$superdoc.provider = void 0;
+			if (document && provider?.sendStateless) document.provider = null;
 			const entry = v2Runtimes.get(documentId);
 			if (!entry) return;
 			proxy.$superdoc.unregisterEditorRuntime(entry.runtimeId);
@@ -22036,7 +22078,7 @@ var SuperDoc_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 			clearV2EditorFailure(payload.documentId ?? null);
 			clearV2AuthorRequired(payload.documentId ?? null);
 			clearV2EditRejected(payload.documentId ?? null);
-			const { host, mount, documentId, capabilities, editCommands, bindEditShortcuts, bindSessionShortcuts, commentsAdapter, trackedChangesAdapter, contextMenu, documentApi, documentMutationReadiness, documentApiUnavailableReason, pageMetrics, pageLayout, pageFurniture, presence, lock, fonts, replaceFile, upgradeToCollaboration, documentOpenToken } = payload;
+			const { host, mount, documentId, capabilities, editCommands, bindEditShortcuts, bindSessionShortcuts, commentsAdapter, trackedChangesAdapter, contextMenu, documentApi, documentMutationReadiness, documentApiUnavailableReason, pageMetrics, pageLayout, pageFurniture, presence, lock, collaborationProvider, fonts, replaceFile, upgradeToCollaboration, documentOpenToken } = payload;
 			documentOpenTelemetry?.trackDocumentOpen(documentOpenToken ?? null, documentId ?? null);
 			const saveV2Bytes = async (saveOptions = {}) => {
 				if (!host || typeof host.save !== "function") throw new Error("v2-editor: save unavailable");
@@ -22311,6 +22353,7 @@ var SuperDoc_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 				pageFurniture: pageFurniture ?? null,
 				presence: presence ?? null,
 				lock: lock ?? null,
+				provider: collaborationProvider ?? null,
 				reviewWindow: {
 					getDiagnostics: () => v2ReviewWindowController.getDiagnostics(),
 					getSnapshot: () => v2ReviewWindowController.getSnapshot?.() ?? null,
@@ -22345,6 +22388,11 @@ var SuperDoc_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 				proxy.$superdoc.setActiveEditor(facade);
 				syncV2EditRejectedActiveDocument();
 			}
+			if (collaborationProvider) {
+				const provider = markRaw(collaborationProvider);
+				proxy.$superdoc.provider = provider;
+				if (doc) doc.provider = provider;
+			}
 			proxy.$superdoc.broadcastEditorCreate(facade);
 			installV2CommandShortcutBinding({
 				documentId,
@@ -24120,7 +24168,7 @@ var SuperDoc_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 			], 38);
 		};
 	}
-}, [["__scopeId", "data-v-0d27f262"]]);
+}, [["__scopeId", "data-v-f0b56abb"]]);
 //#endregion
 //#region src/core/create-app.js
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
@@ -45287,7 +45335,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.13.0-next.2";
+		this.version = "2.13.0-next.3";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];
@@ -45941,6 +45989,14 @@ var SuperDoc = class extends import_eventemitter3.default {
 		storeDoc.v2Collaboration = value;
 	}
 	#toV2CollaborationConfig(target) {
+		if (target.providerFamily === "extension") return {
+			providerType: "extension",
+			adapterId: target.adapterId,
+			documentId: target.documentId,
+			roomMode: target.roomMode,
+			...target.providerOptions !== void 0 ? { providerOptions: target.providerOptions } : {},
+			...target.token ? { token: target.token } : {}
+		};
 		if (target.providerFamily === "liveblocks") return {
 			providerType: "liveblocks",
 			documentId: target.documentId,