webcake-storefront-mcp 1.12.0 → 1.13.0

package/dist/changelog.json

@@ -1,4 +1,18 @@
 [
+  {
+    "v": "1.13.0",
+    "d": "24/06/2026",
+    "type": "Added",
+    "en": "New restore_file_version tool rolls a CMS file back to a saved version in one step: it reads the chosen version's content (via get_file_versions)…",
+    "vi": "Tool mới restore_file_version khôi phục CMS file về một phiên bản đã lưu chỉ trong một bước: đọc nội dung phiên bản được chọn (qua…"
+  },
+  {
+    "v": "1.12.1",
+    "d": "24/06/2026",
+    "type": "Fixed",
+    "en": "save_file_version and get_file_versions both sent the parameter as cms_file_id, but the backend reads file_id; versions were saved unlinked to any…",
+    "vi": "save_file_version và get_file_versions đều gửi tham số dưới key cms_file_id, trong khi backend đọc file_id; các phiên bản được lưu mà không liên kết…"
+  },
   {
     "v": "1.12.0",
     "d": "24/06/2026",
@@ -26,19 +40,5 @@
     "type": "Added",
     "en": "New scaffold_store_pages tool creates the standard storefront pages (Category, Product, Cart, Checkout, Thank-you) so navigation links resolve…",
     "vi": "Tool mới scaffold_store_pages tạo các trang storefront tiêu chuẩn (Category, Product, Cart, Checkout, Thank-you) để các liên kết điều hướng không bị…"
-  },
-  {
-    "v": "1.9.0",
-    "d": "24/06/2026",
-    "type": "Added",
-    "en": "search_images now accepts an upload parameter (default true) that re-hosts each Pexels result on the WebCake CDN and adds a cdn_url field to every…",
-    "vi": "search_images nay nhận thêm tham số upload (mặc định true) để tự động tải từng kết quả Pexels lên WebCake CDN và bổ sung trường cdn_url vào mỗi ảnh,…"
-  },
-  {
-    "v": "1.8.0",
-    "d": "23/06/2026",
-    "type": "Added",
-    "en": "New list_automations tool returns each automation's id, name, status, and trigger info so agents can find the automation_id required by send_mail or…",
-    "vi": "Tool mới list_automations trả về id, name, status và thông tin trigger của từng automation, giúp agent tìm được automation_id cần truyền vào…"
   }
 ]

package/dist/tools/cms-files.js

@@ -249,7 +249,34 @@ Example: "get_Products" → function_name="Products", method="GET"`, {
         cms_file_id: z.string().describe("CMS file ID"),
         content: z.string().describe("Content to save"),
         is_public: z.boolean().default(false).describe("Mark as public version"),
-    }, ({ cms_file_id, content, is_public }) => handle(() => api.saveFileVersion({ cms_file_id, content, is_public })));
-    server.tool("get_file_versions", "View version history of a CMS file", { cms_file_id: z.string().describe("CMS file ID") }, ({ cms_file_id }) => handle(() => api.getFileVersions({ cms_file_id })));
+    }, ({ cms_file_id, content, is_public }) => 
+    // Backend reads `file_id` (it stores it as cms_file_id); a `cms_file_id` key alone is ignored.
+    handle(() => api.saveFileVersion({ file_id: cms_file_id, content, is_public })));
+    server.tool("get_file_versions", "View version history of a CMS file. Each version includes its saved content — to restore, pass that content back to update_http_function (the http_function file) or update_cms_file, or use restore_file_version.", { cms_file_id: z.string().describe("CMS file ID") }, ({ cms_file_id }) => handle(() => api.getFileVersions({ file_id: cms_file_id })));
+    server.tool("restore_file_version", "Roll a CMS file back to a saved version in one step: reads the version's content and writes it back to the file. Omit version_id to restore the most recent snapshot. Tip: save_file_version on the current content first if you want an undo point.", {
+        cms_file_id: z.string().describe("CMS file ID to restore"),
+        version_id: z.string().optional().describe("Which version to restore (from get_file_versions). Omit = latest snapshot."),
+    }, ({ cms_file_id, version_id }) => handle(async () => {
+        const res = await api.getFileVersions({ file_id: cms_file_id });
+        const body = res?.data ?? res;
+        const list = Array.isArray(body) ? body : body?.data || [];
+        if (!list.length)
+            throw new Error("No saved versions for this file — nothing to restore.");
+        const version = version_id ? list.find((v) => v.id === version_id) : list[0];
+        if (!version)
+            throw new Error(`Version "${version_id}" not found. Use get_file_versions to list available versions.`);
+        const content = version.content;
+        if (content == null)
+            throw new Error("That version has no stored content; cannot restore.");
+        await api.updateCmsFile(cms_file_id, { content });
+        return {
+            success: true,
+            cms_file_id,
+            restored_version_id: version.id,
+            restored_at: version.inserted_at || version.created_at || undefined,
+            content_length: String(content).length,
+            note: "File reverted. Run/debug it to confirm, then publish if needed.",
+        };
+    }));
     server.tool("toggle_debug_render", "Toggle debug render mode for a CMS file", { cms_file_id: z.string().describe("CMS file ID") }, ({ cms_file_id }) => handle(() => api.toggleDebugRender({ cms_file_id })));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webcake-storefront-mcp",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "MCP server for the WebCake/StoreCake storefront builder — page CRUD, page authoring, products, orders, and more",
   "mcpName": "io.github.vuluu2k/webcake-storefront-mcp",
   "license": "MIT",