webcake-storefront-mcp 1.5.0 → 1.5.1

package/dist/api.js

@@ -139,8 +139,16 @@ export class WebcakeCmsApi {
     listPages() {
         return this.request("GET", `/api/v1/site/${this.siteId}/pages`);
     }
+    /** Create a page. The backend creates the page AND its source in one call, so `source`
+     *  is REQUIRED and must be a JSON string (stringified here if an object is passed).
+     *  `slug`/`is_homepage` are NOT applied at create — set them afterwards via updatePage. */
     createPage(params) {
-        return this.request("POST", `/api/v1/site/${this.siteId}/page`, { body: params });
+        const body = { ...params };
+        if (body.source != null && typeof body.source !== "string")
+            body.source = JSON.stringify(body.source);
+        if (body.source == null)
+            body.source = JSON.stringify({ sections: [] });
+        return this.request("POST", `/api/v1/site/${this.siteId}/page`, { body });
     }
     updatePage(pageId, params) {
         return this.request("POST", `/api/v1/site/${this.siteId}/${pageId}/update_page`, { body: params });
@@ -169,8 +177,21 @@ export class WebcakeCmsApi {
     saveSite(params = {}) {
         return this.request("POST", `/api/v1/site/${this.siteId}/save`, { body: params, timeout: 60000 });
     }
-    publishSite(params = {}) {
-        return this.request("POST", `/api/v1/site/${this.siteId}/publish`, { body: params, timeout: 60000 });
+    /** Publish the site live. /publish runs the full "save" pipeline, which OVERWRITES
+     *  site.settings with the body's `settings` — so we send the CURRENT settings (else
+     *  they'd be nulled, disabling use_store/use_blog/etc.). Other collections default to []. */
+    async publishSite(params = {}) {
+        let settings = params.settings;
+        if (settings === undefined) {
+            settings = await this.getSiteSettings().catch(() => ({}));
+        }
+        // The save pipeline stores site.settings as a JSON STRING — an object body is
+        // rejected (422). Stringify unless the caller already passed a string.
+        const settingsStr = typeof settings === "string" ? settings : JSON.stringify(settings || {});
+        return this.request("POST", `/api/v1/site/${this.siteId}/publish`, {
+            body: { global_sources: [], global_sections: [], page_contents: [], ...params, settings: settingsStr },
+            timeout: 60000,
+        });
     }
     uploadImageBase64({ base64, content_type } = {}) {
         return this.request("POST", `/api/v1/site/${this.siteId}/media/content/b64`, {

package/dist/changelog.json

@@ -1,4 +1,11 @@
 [
+  {
+    "v": "1.5.1",
+    "d": "23/06/2026",
+    "type": "Fixed",
+    "en": "build_page now passes the finalized page source to create_page in the initial create call (required by the backend), then sets slug and is_homepage…",
+    "vi": "build_page nay truyền source trang đã hoàn thiện vào lời gọi create_page ban đầu (bắt buộc bởi backend), sau đó đặt slug và is_homepage qua một lời…"
+  },
   {
     "v": "1.5.0",
     "d": "23/06/2026",
@@ -33,12 +40,5 @@
     "type": "Added",
     "en": "The remote landing page served by the serve command now includes a \"What's new\" section that renders a version timeline loaded from a build-time…",
     "vi": "Trang landing của lệnh serve nay có thêm mục \"Có gì mới\" hiển thị timeline lịch sử phiên bản được tải từ file changelog.json sinh ra lúc build (từ…"
-  },
-  {
-    "v": "1.1.3",
-    "d": "23/06/2026",
-    "type": "Changed",
-    "en": "The install command's interactive wizard now runs a three-step flow: environment selection (prod / staging / local), authentication, then IDE…",
-    "vi": "Trình hướng dẫn tương tác của lệnh install nay chạy theo 3 bước: chọn môi trường (prod / staging / local), xác thực, rồi cấu hình IDE."
   }
 ]

package/dist/tools/builder.js

@@ -96,14 +96,20 @@ The source must be { sections: [...] } — build sections with new_section. Vali
                 return { error: `Could not enable site.settings.${requiredFlag} (needed for a '${kind}' page). ${e?.message ?? e}` };
             }
         }
-        const created = await api.createPage({ name, slug, ...(typeNum != null ? { type: typeNum } : {}), is_homepage });
+        // Expand runtime -> bp1..bp4 so the saved source actually renders on the storefront.
+        finalizeForRender(parsed);
+        // createPage saves the page AND its source in one call (source is required there).
+        const created = await api.createPage({ name, source: parsed, ...(typeNum != null ? { type: typeNum } : {}) });
         const pageId = newPageId(created);
         if (!pageId) {
-            return { error: "Page created but no id was returned; cannot save source.", created };
+            return { error: "Page created but no id was returned.", created };
+        }
+        // slug / homepage are not applied at create — set them via update_page.
+        if (slug || is_homepage) {
+            await api
+                .updatePage(pageId, { ...(slug ? { slug } : {}), ...(is_homepage ? { is_homepage: true } : {}) })
+                .catch(() => { });
         }
-        // Expand runtime -> bp1..bp4 so the saved source actually renders on the storefront.
-        finalizeForRender(parsed);
-        const saved = await api.updatePageSource(pageId, { source: parsed });
         return {
             success: true,
             page_id: pageId,
@@ -111,7 +117,6 @@ The source must be { sections: [...] } — build sections with new_section. Vali
             slug,
             page_type: kind ?? null,
             ...(feature ? { data_source: { flag: feature.flag, newly_enabled: feature.changed } } : {}),
-            page_source_id: saved && saved.data && saved.data.id,
             stats: validation.stats,
         };
     }));

package/dist/tools/catalog-write.js

@@ -69,19 +69,22 @@ Images must be HOSTED URLs — get them from search_images or upload_images firs
         const productParams = {
             name,
             variations: vars,
+            // These MUST be arrays — the backend does Enum.reduce over them and 500s on nil.
+            categories: category_ids || [],
+            ribbons: [],
             ...(description ? { description } : {}),
             ...(attributes ? { product_attributes: attributes } : {}),
-            ...(category_ids ? { categories: category_ids } : {}),
             ...(images && images.length ? { image: images[0] } : {}),
         };
         const res = await api.createProduct(productParams);
-        const data = res?.data;
-        const productId = data?.attributes?.id || data?.id || data?.product?.id || null;
+        // Success response is { product: {...} } at the top level (not under data).
+        const prod = res?.product || res?.data?.product || res?.data?.attributes || res?.data || {};
+        const productId = prod?.id || null;
         return {
             success: true,
             product_id: productId,
             name,
-            slug: data?.attributes?.slug || data?.slug || null,
+            slug: prod?.slug || null,
             variations: vars.length,
             categories: category_ids || [],
             raw: productId ? undefined : res, // surface raw response only if we couldn't find the id

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webcake-storefront-mcp",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "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",