@templatical/core 0.35.0 → 0.37.0

package/dist/cloud/index.js

@@ -108,14 +108,14 @@ var AuthManager = class AuthManager {
 			const response = await fetch(this.url, fetchOptions);
 			if (!response.ok) throw new SdkError(`Token refresh failed: ${response.status}`, response.status);
 			const data = await response.json();
-			if (!data.token || !data.expires_at || !data.project_id || !data.tenant) throw new Error("Invalid token response: missing token, expires_at, project_id, or tenant");
+			if (!data.token || !data.expiresAt || !data.projectId || !data.tenant) throw new Error("Invalid token response: missing token, expiresAt, projectId, or tenant");
 			this.accessToken = data.token;
-			this.expiresAt = /* @__PURE__ */ new Date(data.expires_at * 1e3);
-			this._projectId = data.project_id;
+			this.expiresAt = /* @__PURE__ */ new Date(data.expiresAt * 1e3);
+			this._projectId = data.projectId;
 			this._tenantSlug = data.tenant;
-			if (data.test_email?.allowed_emails && data.test_email?.signature) this._testEmailConfig = {
-				allowedEmails: data.test_email.allowed_emails,
-				signature: data.test_email.signature
+			if (data.testEmail?.allowedEmails && data.testEmail?.signature) this._testEmailConfig = {
+				allowedEmails: data.testEmail.allowedEmails,
+				signature: data.testEmail.signature
 			};
 			else this._testEmailConfig = null;
 			if (data.user?.id && data.user?.name && data.user?.signature) this._userConfig = {
@@ -440,12 +440,184 @@ var ApiClient = class {
 	}
 };
 //#endregion
+//#region src/cloud/media-api.ts
+/**
+* Cloud's HTTP client for media. Auth and project/tenant scoping come from
+* {@link AuthManager}. The BYO contract lives on
+* `createCloudMediaProvider`, which maps this client's rows.
+*/
+var MediaApiClient = class {
+	authManager;
+	constructor(authManager) {
+		this.authManager = authManager;
+	}
+	get projectId() {
+		return this.authManager.projectId;
+	}
+	get tenantSlug() {
+		return this.authManager.tenantSlug;
+	}
+	get baseParams() {
+		return {
+			project: this.projectId,
+			tenant: this.tenantSlug
+		};
+	}
+	async request(path, options = {}) {
+		const response = await this.authManager.authenticatedFetch(path, {
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				Accept: "application/json",
+				...options.headers
+			}
+		});
+		if (!response.ok) {
+			const error = await response.json().catch(() => ({ message: `HTTP error ${response.status}` }));
+			throw new Error(error.message, { cause: error });
+		}
+		if (response.status === 204) return;
+		return (await response.json()).data;
+	}
+	async browseMedia(params) {
+		const query = new URLSearchParams();
+		if (params.folderId) query.set("folderId", params.folderId);
+		if (params.search) query.set("search", params.search);
+		if (params.category) query.set("category", params.category);
+		if (params.sort) query.set("sort", params.sort);
+		if (params.cursor) query.set("cursor", params.cursor);
+		const queryString = query.toString();
+		const url = `${buildUrl(API_ROUTES["media.browse"], this.baseParams)}${queryString ? `?${queryString}` : ""}`;
+		const response = await this.authManager.authenticatedFetch(url, { headers: { Accept: "application/json" } });
+		if (!response.ok) {
+			const error = await response.json().catch(() => ({ message: `HTTP error ${response.status}` }));
+			throw new Error(error.message, { cause: error });
+		}
+		return response.json();
+	}
+	async uploadMedia(file, folderId) {
+		const formData = new FormData();
+		formData.append("file", file);
+		if (folderId) formData.append("folderId", folderId);
+		const url = buildUrl(API_ROUTES["media.upload"], this.baseParams);
+		const response = await this.authManager.authenticatedFetch(url, {
+			method: "POST",
+			headers: { Accept: "application/json" },
+			body: formData
+		});
+		if (!response.ok) {
+			const error = await response.json().catch(() => ({ message: `HTTP error ${response.status}` }));
+			throw new Error(error.message, { cause: error });
+		}
+		return (await response.json()).data;
+	}
+	async updateMedia(mediaId, filename, alt) {
+		const body = {};
+		if (filename !== void 0) body.filename = filename;
+		if (alt !== void 0) body.alt = alt;
+		return this.request(buildUrl(API_ROUTES["media.update"], {
+			...this.baseParams,
+			media: mediaId
+		}), {
+			method: "PUT",
+			body: JSON.stringify(body)
+		});
+	}
+	async deleteMedia(ids) {
+		return this.request(buildUrl(API_ROUTES["media.delete"], this.baseParams), {
+			method: "POST",
+			body: JSON.stringify({ ids })
+		});
+	}
+	async moveMedia(ids, folderId) {
+		return this.request(buildUrl(API_ROUTES["media.move"], this.baseParams), {
+			method: "POST",
+			body: JSON.stringify({
+				ids,
+				folderId
+			})
+		});
+	}
+	async getMediaFolders() {
+		return this.request(buildUrl(API_ROUTES["folders.index"], this.baseParams));
+	}
+	async createMediaFolder(name, parentId) {
+		return this.request(buildUrl(API_ROUTES["folders.store"], this.baseParams), {
+			method: "POST",
+			body: JSON.stringify({
+				name,
+				parentId: parentId ?? null
+			})
+		});
+	}
+	async renameMediaFolder(folderId, name) {
+		return this.request(buildUrl(API_ROUTES["folders.update"], {
+			...this.baseParams,
+			mediaFolder: folderId
+		}), {
+			method: "PUT",
+			body: JSON.stringify({ name })
+		});
+	}
+	async deleteMediaFolder(folderId) {
+		return this.request(buildUrl(API_ROUTES["folders.destroy"], {
+			...this.baseParams,
+			mediaFolder: folderId
+		}), { method: "DELETE" });
+	}
+	async checkMediaUsage(ids) {
+		const response = await this.authManager.authenticatedFetch(buildUrl(API_ROUTES["media.checkUsage"], this.baseParams), {
+			method: "POST",
+			headers: {
+				"Content-Type": "application/json",
+				Accept: "application/json"
+			},
+			body: JSON.stringify({ ids })
+		});
+		if (!response.ok) {
+			const error = await response.json().catch(() => ({ message: `HTTP error ${response.status}` }));
+			throw new Error(error.message, { cause: error });
+		}
+		return response.json();
+	}
+	async getFrequentlyUsed() {
+		return this.request(buildUrl(API_ROUTES["media.frequentlyUsed"], this.baseParams));
+	}
+	async importFromUrl(url, folderId) {
+		return this.request(buildUrl(API_ROUTES["media.importFromUrl"], this.baseParams), {
+			method: "POST",
+			body: JSON.stringify({
+				url,
+				folderId: folderId ?? null
+			})
+		});
+	}
+	async replaceMedia(mediaId, file) {
+		const formData = new FormData();
+		formData.append("file", file);
+		const url = buildUrl(API_ROUTES["media.replace"], {
+			...this.baseParams,
+			media: mediaId
+		});
+		const response = await this.authManager.authenticatedFetch(url, {
+			method: "POST",
+			headers: { Accept: "application/json" },
+			body: formData
+		});
+		if (!response.ok) {
+			const error = await response.json().catch(() => ({ message: `HTTP error ${response.status}` }));
+			throw new Error(error.message, { cause: error });
+		}
+		return (await response.json()).data;
+	}
+};
+//#endregion
 //#region src/cloud/websocket-client.ts
 function resolveWebSocketConfig(serverConfig) {
 	return {
 		host: serverConfig.host,
 		port: serverConfig.port,
-		appKey: serverConfig.app_key
+		appKey: serverConfig.appKey
 	};
 }
 var WebSocketClient = class {
@@ -487,9 +659,9 @@ var WebSocketClient = class {
 					Accept: "application/json"
 				},
 				params: {
-					user_id: this.authManager.userConfig?.id ?? "",
-					user_name: this.authManager.userConfig?.name ?? "",
-					user_signature: this.authManager.userConfig?.signature ?? ""
+					userId: this.authManager.userConfig?.id ?? "",
+					userName: this.authManager.userConfig?.name ?? "",
+					userSignature: this.authManager.userConfig?.signature ?? ""
 				}
 			}
 		});
@@ -525,25 +697,25 @@ var WebSocketClient = class {
 function handleOperation(editor, payload) {
 	const { operation, data } = payload;
 	switch (operation) {
-		case "add_block":
-			editor.addBlock(data.block, data.section_id, data.column_index, data.index);
+		case "addBlock":
+			editor.addBlock(data.block, data.sectionId, data.columnIndex, data.index);
 			break;
-		case "update_block":
-			editor.updateBlock(data.block_id, data.updates);
+		case "updateBlock":
+			editor.updateBlock(data.blockId, data.updates);
 			break;
-		case "delete_block":
-			editor.removeBlock(data.block_id);
+		case "deleteBlock":
+			editor.removeBlock(data.blockId);
 			break;
-		case "move_block":
-			editor.moveBlock(data.block_id, data.index, data.section_id, data.column_index);
+		case "moveBlock":
+			editor.moveBlock(data.blockId, data.index, data.sectionId, data.columnIndex);
 			break;
-		case "update_settings":
+		case "updateSettings":
 			editor.updateSettings(data.updates);
 			break;
-		case "set_content":
+		case "setContent":
 			editor.setContent(data.content);
 			break;
-		case "update_block_style": editor.updateBlock(data.block_id, { styles: data.styles });
+		case "updateBlockStyle": editor.updateBlock(data.blockId, { styles: data.styles });
 	}
 }
 //#endregion
@@ -595,12 +767,12 @@ function useAiChat(options) {
 			});
 			if (!response.ok) return;
 			const data = await response.json();
-			if (data.conversation_id) conversationId.value = data.conversation_id;
+			if (data.conversationId) conversationId.value = data.conversationId;
 			if (Array.isArray(data.data) && data.data.length > 0) messages.value = data.data.map((msg) => ({
 				id: msg.id,
 				role: msg.role,
 				content: msg.content,
-				timestamp: new Date(msg.created_at).getTime()
+				timestamp: new Date(msg.createdAt).getTime()
 			}));
 		} catch {} finally {
 			isLoadingHistory.value = false;
@@ -623,8 +795,8 @@ function useAiChat(options) {
 					Accept: "text/event-stream"
 				},
 				body: JSON.stringify({
-					current_content: currentContent,
-					merge_tags: mergeTags.map((p) => ({
+					currentContent,
+					mergeTags: mergeTags.map((p) => ({
 						label: p.label,
 						value: p.value
 					}))
@@ -691,17 +863,17 @@ function useAiChat(options) {
 				},
 				body: JSON.stringify({
 					prompt,
-					current_content: currentContent,
-					merge_tags: mergeTags.map((p) => ({
+					currentContent,
+					mergeTags: mergeTags.map((p) => ({
 						label: p.label,
 						value: p.value
 					})),
-					conversation_id: conversationId.value
+					conversationId: conversationId.value
 				})
 			});
 			if (!response.ok) {
 				const errorData = await response.json().catch(() => null);
-				if (response.status === 403) throw new Error("ai_generation_not_available");
+				if (response.status === 403) throw new Error("aiGenerationNotAvailable");
 				throw new Error(errorData?.message || "Failed to generate template");
 			}
 			const reader = response.body?.getReader();
@@ -728,7 +900,7 @@ function useAiChat(options) {
 						if (event.type === "text") updateMessage(assistantMsgId, { content: (messages.value.find((m) => m.id === assistantMsgId)?.content ?? "") + event.text });
 						else if (event.type === "error") throw new Error(event.message || "Failed to generate template");
 						else if (event.type === "done") {
-							if (event.conversation_id) conversationId.value = event.conversation_id;
+							if (event.conversationId) conversationId.value = event.conversationId;
 							updateMessage(assistantMsgId, { content: event.text });
 							result = event.content ?? null;
 							if (result) {
@@ -822,14 +994,14 @@ function useAiRewrite(options) {
 				body: JSON.stringify({
 					content,
 					instruction,
-					merge_tags: mergeTags.map((p) => ({
+					mergeTags: mergeTags.map((p) => ({
 						label: p.label,
 						value: p.value
 					}))
 				})
 			});
 			if (!response.ok) {
-				if (response.status === 403) throw new Error("ai_generation_not_available");
+				if (response.status === 403) throw new Error("aiGenerationNotAvailable");
 				const errorData = await response.json().catch(() => null);
 				throw new Error(errorData?.message || "Failed to rewrite text");
 			}
@@ -944,15 +1116,15 @@ function useTemplateScoring(options) {
 					Accept: "text/event-stream"
 				},
 				body: JSON.stringify({
-					current_content: content,
-					merge_tags: mergeTags.map((p) => ({
+					currentContent: content,
+					mergeTags: mergeTags.map((p) => ({
 						label: p.label,
 						value: p.value
 					}))
 				})
 			});
 			if (!response.ok) {
-				if (response.status === 403) throw new Error("ai_generation_not_available");
+				if (response.status === 403) throw new Error("aiGenerationNotAvailable");
 				const errorData = await response.json().catch(() => null);
 				throw new Error(errorData?.message || "Failed to score template");
 			}
@@ -1015,14 +1187,14 @@ function useTemplateScoring(options) {
 						suggestion: finding.suggestion,
 						category: finding.category
 					},
-					merge_tags: mergeTags.map((p) => ({
+					mergeTags: mergeTags.map((p) => ({
 						label: p.label,
 						value: p.value
 					}))
 				})
 			});
 			if (!response.ok) {
-				if (response.status === 403) throw new Error("ai_generation_not_available");
+				if (response.status === 403) throw new Error("aiGenerationNotAvailable");
 				const errorData = await response.json().catch(() => null);
 				throw new Error(errorData?.message || "Failed to fix finding");
 			}
@@ -1113,7 +1285,7 @@ function useDesignReference(options) {
 			});
 			if (!response.ok) {
 				const errorData = await response.json().catch(() => null);
-				if (response.status === 403) throw new Error("ai_generation_not_available");
+				if (response.status === 403) throw new Error("aiGenerationNotAvailable");
 				throw new Error(errorData?.message || "Failed to generate template from design");
 			}
 			const reader = response.body?.getReader();
@@ -1169,28 +1341,23 @@ function useDesignReference(options) {
 /** The Pusher event Cloud's backend fans comment writes out on. */
 const BROADCAST_EVENT = "comment-broadcast";
 /**
-* Cloud's wire shape → the contract shape. The whole job of this adapter, plus
-* auth: snake_case to camelCase, and the two flat `author_*` / `resolved_by_*`
-* pairs into {@link CommentAuthor} objects.
+* Cloud's HTTP row → {@link Comment}. Omits `updatedAt` when it equals
+* `createdAt` (Cloud stamps both on insert) so the panel does not mark
+* every comment "(edited)", and omits `resolvedBy` / empty `replies`
+* when they are absent.
 */
 function toComment(record) {
 	const comment = {
 		id: record.id,
 		body: record.body,
-		author: {
-			id: record.author_identifier,
-			name: record.author_name
-		},
-		createdAt: record.created_at,
-		blockId: record.block_id,
-		parentId: record.parent_id,
-		resolvedAt: record.resolved_at
-	};
-	if (record.updated_at !== record.created_at) comment.updatedAt = record.updated_at;
-	if (record.resolved_by_identifier) comment.resolvedBy = {
-		id: record.resolved_by_identifier,
-		name: record.resolved_by_name ?? ""
+		author: record.author,
+		createdAt: record.createdAt,
+		blockId: record.blockId,
+		parentId: record.parentId,
+		resolvedAt: record.resolvedAt
 	};
+	if (record.updatedAt !== record.createdAt) comment.updatedAt = record.updatedAt;
+	if (record.resolvedBy) comment.resolvedBy = record.resolvedBy;
 	if (record.replies?.length) comment.replies = record.replies.map(toComment);
 	return comment;
 }
@@ -1206,7 +1373,7 @@ function toComment(record) {
 * Two things about the write payloads are Cloud's alone and stay on this side of
 * the seam:
 *
-* - **The author is signed.** `user_id` / `user_name` / `user_signature` come from
+* - **The author is signed.** `userId` / `userName` / `userSignature` come from
 *   the JWT, not from the editor's `user` config, so a browser cannot attribute a
 *   comment to someone else. The editor's `user` key still gates the feature and
 *   drives "you wrote this" in the UI; the two agree because `initCloud()` fills
@@ -1223,9 +1390,9 @@ function createCloudCommentsProvider(options) {
 		const user = authManager.userConfig;
 		if (!user) throw new Error("[Templatical] Cloud comments need a signed user in the auth token. The project's token endpoint must include a `user` claim.");
 		return {
-			user_id: user.id,
-			user_name: user.name,
-			user_signature: user.signature
+			userId: user.id,
+			userName: user.name,
+			userSignature: user.signature
 		};
 	}
 	function socketHeaders() {
@@ -1239,8 +1406,8 @@ function createCloudCommentsProvider(options) {
 		async create(templateId, input) {
 			return toComment(await api.createComment(templateId, {
 				body: input.body,
-				block_id: input.blockId,
-				parent_id: input.parentId,
+				blockId: input.blockId,
+				parentId: input.parentId,
 				...userPayload()
 			}, socketHeaders()));
 		},
@@ -1261,22 +1428,22 @@ function createCloudCommentsProvider(options) {
 			function handle(payload) {
 				const comment = toComment(payload.comment);
 				switch (payload.action) {
-					case "comment_created":
+					case "commentCreated":
 						onChange({
 							type: "created",
 							comment
 						});
 						break;
-					case "comment_deleted":
+					case "commentDeleted":
 						onChange({
 							type: "deleted",
 							commentId: comment.id,
 							parentId: comment.parentId
 						});
 						break;
-					case "comment_updated":
-					case "comment_resolved":
-					case "comment_unresolved": onChange({
+					case "commentUpdated":
+					case "commentResolved":
+					case "commentUnresolved": onChange({
 						type: "updated",
 						comment
 					});
@@ -1298,8 +1465,8 @@ function createCloudCommentsProvider(options) {
 const COLLAB_EVENTS = [
 	"pusher:member_added",
 	"pusher:member_removed",
-	"client-block_locked",
-	"client-block_unlocked",
+	"client-blockLocked",
+	"client-blockUnlocked",
 	"client-operation",
 	"mcp-operation"
 ];
@@ -1388,14 +1555,14 @@ function useCollaboration(options) {
 	}
 	function broadcastBlockLocked(blockId) {
 		if (!channel.value) return;
-		channel.value.trigger("client-block_locked", {
+		channel.value.trigger("client-blockLocked", {
 			blockId,
 			userId: myUserId.value
 		});
 	}
 	function broadcastBlockUnlocked(blockId) {
 		if (!channel.value) return;
-		channel.value.trigger("client-block_unlocked", { blockId });
+		channel.value.trigger("client-blockUnlocked", { blockId });
 	}
 	watch(() => editor.state.selectedBlockId, (newBlockId, oldBlockId) => {
 		if (isProcessingRemoteOperation) return;
@@ -1423,7 +1590,7 @@ function useCollaboration(options) {
 			removeCollaborator(member.id);
 			if (collaborator) options.onCollaboratorLeft?.(collaborator);
 		});
-		newChannel.bind("client-block_locked", (data) => {
+		newChannel.bind("client-blockLocked", (data) => {
 			handleBlockLocked(data);
 			const collaborator = collaborators.value.find((c) => c.id === data.userId);
 			if (collaborator) options.onBlockLocked?.({
@@ -1431,7 +1598,7 @@ function useCollaboration(options) {
 				collaborator
 			});
 		});
-		newChannel.bind("client-block_unlocked", (data) => {
+		newChannel.bind("client-blockUnlocked", (data) => {
 			const holder = lockedBlocks.value.get(data.blockId);
 			handleBlockUnlocked(data);
 			if (holder) options.onBlockUnlocked?.({
@@ -1475,11 +1642,11 @@ function useCollaborationBroadcast(editor, collaboration) {
 	editor.addBlock = (block, targetSectionId, columnIndex, index) => {
 		originalAddBlock(block, targetSectionId, columnIndex, index);
 		collaboration._broadcastOperation({
-			operation: "add_block",
+			operation: "addBlock",
 			data: {
 				block,
-				section_id: targetSectionId,
-				column_index: columnIndex,
+				sectionId: targetSectionId,
+				columnIndex,
 				index
 			},
 			timestamp: Date.now()
@@ -1488,9 +1655,9 @@ function useCollaborationBroadcast(editor, collaboration) {
 	editor.updateBlock = (blockId, updates) => {
 		originalUpdateBlock(blockId, updates);
 		collaboration._broadcastOperation({
-			operation: "update_block",
+			operation: "updateBlock",
 			data: {
-				block_id: blockId,
+				blockId,
 				updates
 			},
 			timestamp: Date.now()
@@ -1499,20 +1666,20 @@ function useCollaborationBroadcast(editor, collaboration) {
 	editor.removeBlock = (blockId) => {
 		originalRemoveBlock(blockId);
 		collaboration._broadcastOperation({
-			operation: "delete_block",
-			data: { block_id: blockId },
+			operation: "deleteBlock",
+			data: { blockId },
 			timestamp: Date.now()
 		});
 	};
 	editor.moveBlock = (blockId, newIndex, targetSectionId, columnIndex) => {
 		originalMoveBlock(blockId, newIndex, targetSectionId, columnIndex);
 		collaboration._broadcastOperation({
-			operation: "move_block",
+			operation: "moveBlock",
 			data: {
-				block_id: blockId,
+				blockId,
 				index: newIndex,
-				section_id: targetSectionId,
-				column_index: columnIndex
+				sectionId: targetSectionId,
+				columnIndex
 			},
 			timestamp: Date.now()
 		});
@@ -1520,7 +1687,7 @@ function useCollaborationBroadcast(editor, collaboration) {
 	editor.updateSettings = (updates) => {
 		originalUpdateSettings(updates);
 		collaboration._broadcastOperation({
-			operation: "update_settings",
+			operation: "updateSettings",
 			data: { updates },
 			timestamp: Date.now()
 		});
@@ -1528,7 +1695,7 @@ function useCollaborationBroadcast(editor, collaboration) {
 	editor.setContent = (content, markDirty) => {
 		originalSetContent(content, markDirty);
 		collaboration._broadcastOperation({
-			operation: "set_content",
+			operation: "setContent",
 			data: { content },
 			timestamp: Date.now()
 		});
@@ -1621,6 +1788,152 @@ function createCloudSavedBlocksProvider(authManager) {
 	};
 }
 //#endregion
+//#region src/cloud/media-provider.ts
+/**
+* Cloud's HTTP row → {@link MediaAsset}. Omits null optionals so
+* `thumbnailUrl` / `width` / `height` are absent rather than `null` —
+* the grid falls back to `url` when there is no thumbnail. Confirm
+* always inserts `url`.
+*/
+function toAsset(item) {
+	const asset = {
+		id: item.id,
+		url: item.url,
+		filename: item.filename,
+		alt: item.alt,
+		mimeType: item.mimeType,
+		folderId: item.folderId,
+		createdAt: item.createdAt,
+		updatedAt: item.updatedAt,
+		size: item.size
+	};
+	if (item.width != null) asset.width = item.width;
+	if (item.height != null) asset.height = item.height;
+	if (item.thumbnailUrl != null) asset.thumbnailUrl = item.thumbnailUrl;
+	return asset;
+}
+function toFolder(folder, inheritedParentId = null) {
+	return {
+		id: folder.id,
+		name: folder.name,
+		parentId: folder.parentId !== void 0 ? folder.parentId : inheritedParentId
+	};
+}
+/**
+* Flatten a Cloud folder payload into the contract's flat list.
+*
+* The index endpoint may return a tree (`children`) or already-flat
+* `parentId` rows. Depth-first so a parent is always listed before its
+* descendants. Already-flat rows just copy `parentId`.
+*/
+function flattenFolders(nodes, inheritedParentId = null) {
+	const out = [];
+	for (const node of nodes) {
+		out.push(toFolder(node, inheritedParentId));
+		if (node.children?.length) out.push(...flattenFolders(node.children, node.id));
+	}
+	return out;
+}
+function mimeTypesFromPlan(plan) {
+	const categories = plan?.media?.categories;
+	if (!categories) return;
+	const mapped = {};
+	for (const [key, value] of Object.entries(categories)) mapped[key] = value.mimeTypes;
+	return mapped;
+}
+/**
+* Cloud-backed {@link MediaProvider} — the Templatical Cloud adapter for the
+* same DAM contract consumers implement themselves.
+*
+* Every method is a function: Cloud's media storage is what the plan pays
+* for, so there is no Cloud tier that can list but not upload. A consumer
+* who wants a read-only gallery supplies their own provider with the
+* mutations set to `false`.
+*
+* **Ignores `templateId`.** Cloud's library is project-scoped; a CMS that
+* scopes a gallery per template reads that param in its own `list`.
+*
+* **`storage` / `maxFileSize` / `mimeTypes` are live.** They read
+* `getPlanConfig()` at call time, because plan config arrives after
+* construction. Snapshotting at setup would pin `storage()` to `null` and
+* hide the quota ring for the whole session. A spread of this object
+* freezes the getters — `initCloud()` must `Object.assign`, never spread.
+*/
+function createCloudMediaProvider(authManager, getPlanConfig) {
+	const api = new MediaApiClient(authManager);
+	return {
+		async list(params) {
+			const response = await api.browseMedia({
+				search: params?.search,
+				cursor: params?.cursor,
+				folderId: params?.folderId,
+				category: params?.category
+			});
+			const page = { items: response.data.map(toAsset) };
+			if (response.meta.nextCursor) page.nextCursor = response.meta.nextCursor;
+			return page;
+		},
+		async create(input) {
+			return toAsset(await api.uploadMedia(input.file, input.folderId));
+		},
+		async update(id, patch) {
+			return toAsset(await api.updateMedia(id, patch.filename, patch.alt));
+		},
+		delete(ids) {
+			return api.deleteMedia(ids);
+		},
+		folders: {
+			async list() {
+				return flattenFolders(await api.getMediaFolders());
+			},
+			async create(input) {
+				return toFolder(await api.createMediaFolder(input.name, input.parentId));
+			},
+			async update(id, patch) {
+				return toFolder(await api.renameMediaFolder(id, patch.name));
+			},
+			delete(id) {
+				return api.deleteMediaFolder(id);
+			},
+			async move(ids, folderId) {
+				return (await api.moveMedia(ids, folderId)).map(toAsset);
+			}
+		},
+		async replace(id, file) {
+			return toAsset(await api.replaceMedia(id, file));
+		},
+		async importFromUrl(url, folderId) {
+			return toAsset(await api.importFromUrl(url, folderId));
+		},
+		async checkUsage(ids) {
+			const response = await api.checkMediaUsage(ids);
+			const mapped = {};
+			for (const [id, info] of Object.entries(response.data)) mapped[id] = {
+				templateCount: info.templateCount,
+				templateNames: info.templateNames
+			};
+			return mapped;
+		},
+		async frequentlyUsed() {
+			return (await api.getFrequentlyUsed()).map(toAsset);
+		},
+		async storage() {
+			return getPlanConfig?.()?.storage ?? null;
+		},
+		/**
+		* A getter, not a snapshot: plan config arrives after construction.
+		* The editor reads this inside a computed; capturing it at setup
+		* would pin the client pre-check to `undefined`.
+		*/
+		get maxFileSize() {
+			return getPlanConfig?.()?.media?.maxFileSize;
+		},
+		get mimeTypes() {
+			return mimeTypesFromPlan(getPlanConfig?.() ?? null);
+		}
+	};
+}
+//#endregion
 //#region src/cloud/templates-provider.ts
 /**
 * How often a save may also record an automatic version. Cloud's storage, Cloud's
@@ -1786,8 +2099,8 @@ function createCloudRenderProvider(options) {
 //#endregion
 //#region src/cloud/version-history-provider.ts
 /**
-* Cloud's wire shape → the contract shape. The only real work this adapter does:
-* snake_case to camelCase, and `is_autosave` to `isAutomatic`.
+* Cloud's HTTP row → {@link TemplateVersion}. Copies the contract fields
+* and drops `templateId`.
 *
 * `content` is carried through deliberately — Cloud's index endpoint already
 * returns it, so every listed version arrives hydrated and the editor never
@@ -1799,8 +2112,8 @@ function createCloudRenderProvider(options) {
 function toVersion(record) {
 	return {
 		id: record.id,
-		createdAt: record.created_at,
-		isAutomatic: record.is_autosave,
+		createdAt: record.createdAt,
+		isAutomatic: record.isAutomatic,
 		content: record.content
 	};
 }
@@ -1894,7 +2207,7 @@ function createCloudTestEmailProvider(options) {
 			await api.sendTestEmail(templateId, {
 				recipient,
 				html,
-				allowed_emails: options.allowedEmails.value,
+				allowedEmails: options.allowedEmails.value,
 				signature
 			});
 		}
@@ -1991,7 +2304,7 @@ async function checkApiAndAuth(url, authManager) {
 	}
 }
 async function checkWebSocket(wsConfig) {
-	if (!wsConfig?.host || !wsConfig?.app_key) return {
+	if (!wsConfig?.host || !wsConfig?.appKey) return {
 		ok: false,
 		error: "WebSocket configuration not available"
 	};
@@ -1999,7 +2312,7 @@ async function checkWebSocket(wsConfig) {
 		ok: false,
 		error: "WebSocket not supported in this environment"
 	};
-	const url = `${wsConfig.port === 443 ? "wss" : "ws"}://${wsConfig.host}:${wsConfig.port}/app/${wsConfig.app_key}?protocol=7&client=js&version=8.4.0-rc2&flash=false`;
+	const url = `${wsConfig.port === 443 ? "wss" : "ws"}://${wsConfig.host}:${wsConfig.port}/app/${wsConfig.appKey}?protocol=7&client=js&version=8.4.0-rc2&flash=false`;
 	return new Promise((resolve) => {
 		let ws = null;
 		const timeout = setTimeout(() => {
@@ -2056,6 +2369,6 @@ function useMcpListener(options) {
 	});
 }
 //#endregion
-export { API_ROUTES, ApiClient, AuthManager, WebSocketClient, buildUrl, createCloudCommentsProvider, createCloudRenderProvider, createCloudSavedBlocksProvider, createCloudTemplatesProvider, createCloudTestEmailProvider, createCloudVersionHistoryProvider, createSdkAuthManager, handleOperation, isFatalAuthError, performHealthCheck, resolveExportFonts, resolveWebSocketConfig, useAiChat, useAiConfig, useAiRewrite, useCollaboration, useCollaborationBroadcast, useDesignReference, useExport, useMcpListener, usePlanConfig, useTemplateScoring, useTestEmail, useWebSocket };
+export { API_ROUTES, ApiClient, AuthManager, MediaApiClient, WebSocketClient, buildUrl, createCloudCommentsProvider, createCloudMediaProvider, createCloudRenderProvider, createCloudSavedBlocksProvider, createCloudTemplatesProvider, createCloudTestEmailProvider, createCloudVersionHistoryProvider, createSdkAuthManager, handleOperation, isFatalAuthError, performHealthCheck, resolveExportFonts, resolveWebSocketConfig, useAiChat, useAiConfig, useAiRewrite, useCollaboration, useCollaborationBroadcast, useDesignReference, useExport, useMcpListener, usePlanConfig, useTemplateScoring, useTestEmail, useWebSocket };
 
 //# sourceMappingURL=index.js.map