webcake-storefront-mcp 1.31.3 → 1.31.4

package/dist/changelog.json

@@ -1,4 +1,11 @@
 [
+  {
+    "v": "1.31.4",
+    "d": "26/06/2026",
+    "type": "Added",
+    "en": "The guide returned by get_http_function and get_site_custom_code now includes a verified end-to-end \"Custom data TABLES (collections)\" section…",
+    "vi": "Hướng dẫn trả về bởi get_http_function và get_site_custom_code nay bổ sung phần \"Custom data TABLES (collections)\" đã được xác minh thực tế, ghi lại…"
+  },
   {
     "v": "1.31.3",
     "d": "26/06/2026",
@@ -33,12 +40,5 @@
     "type": "Added",
     "en": "New list_customers tool browses or searches the site's customer list; accepts page, limit, and term (name/phone/email keyword) and returns a compact…",
     "vi": "Tool mới list_customers duyệt hoặc tìm kiếm danh sách khách hàng của site; nhận các tham số page, limit và term (từ khóa tên/điện thoại/email) và…"
-  },
-  {
-    "v": "1.29.0",
-    "d": "26/06/2026",
-    "type": "Added",
-    "en": "scaffold_global_sections now accepts a logo parameter (hosted image URL) that renders an image element in the header instead of the brand-name text…",
-    "vi": "scaffold_global_sections nay nhận thêm tham số logo (URL hình ảnh được host) để hiển thị phần tử image trong header thay vì node text tên thương hiệu."
   }
 ]

package/dist/guides.js

@@ -101,6 +101,21 @@ await Members.updateOne({ id: created.id }, { tien_con_lai: 100000 });
     const userId = request.customer?.id ?? ""; if (!userId) return { mess: "NO_ACCOUNT_CALL" };
     try { /* … */ return { mess: "OK", ...data }; } catch (err) { console.error(err?.message || err); return { mess: "SYSTEM_ERROR" }; }
 
+## Custom data TABLES (collections) — end-to-end (VERIFIED flow)
+A "collection" is a custom DB table. To stand one up and use it from a function:
+1. Create the table + columns with the MCP tools: create_collection({ name, columns:[{name,type},…] })
+   then update_collection_columns to change them. (Types: string|text|integer|float|boolean|
+   naive_datetime|binary_id|map|array.) The table always has id/inserted_at/updated_at/creator_id.
+2. READ rows directly with the MCP tool query_collection_records({ table_name, where, order_by }).
+3. WRITE rows from an HTTP function via webcake-data — db.model(table) gives full CRUD on it:
+   const T = db.model("my_table");
+   const row = await T.create({ email: "a@b.com" });          // insert
+   await T.updateOne({ id: row.id }, { email: "c@d.com" });    // update
+   await T.deleteMany({ email: "a@b.com" });                   // delete
+   const rows = await T.find({ … }).select([…]).limit(50);     // query
+   (There is NO direct dashboard record-INSERT API — record writes MUST go through a function.
+    Deploy the function with the update_http_function MCP tool, then call it with run_function.)
+
 ## Built-in @webcake/* modules (first arg is always request; they auth via global.token — these run
 ## INSIDE the function sandbox, so they reach the /cms_function endpoints the dashboard JWT can't)
 Thin wrappers over the backend's /cms_function/{site_id}/... endpoints. Pass request so

package/package.json

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