webcake-storefront-mcp 1.28.0 → 1.30.0

package/dist/api.js

@@ -505,6 +505,11 @@ export class WebcakeCmsApi {
         return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/combo_product/items`, { query: { combo_product_id: comboProductId, ...query } });
     }
     // ── Customers ──
+    /** List/search customers. Real shape: { customers: { data:[…], total_entries } }. Accepts
+     *  page/limit and a `term` keyword (name/phone/email). Endpoint is /customer/all (singular). */
+    listCustomers(query) {
+        return this.request("GET", `/api/v1/dashboard/site/${this.siteId}/customer/all`, { query });
+    }
     findCustomerById(id) {
         return this.request("GET", `/api/v1/cms_function/${this.siteId}/customer/identity/${id}`);
     }

package/dist/builder/templates.js

@@ -311,7 +311,9 @@ export function headerSection(opts = {}) {
         { label: "Sản phẩm", navTo: "collections" },
         { label: "Giỏ hàng", navTo: "cart" },
     ];
-    const logo = { type: "text", opts: { text: opts.brand || "Shop", specials: { tag: "h2" }, style: { fontSize: "24px", fontWeight: "800", color: p.text } } };
+    const logo = opts.logo
+        ? { type: "image", opts: { config: { src: opts.logo }, style: { height: 40, width: 140 } } }
+        : { type: "text", opts: { text: opts.brand || "Shop", specials: { tag: "h2" }, style: { fontSize: "24px", fontWeight: "800", color: p.text } } };
     // Real designer templates use a `menu` of `menu-item`s, NOT text links — and a menu-item's
     // navigation lives in its SPECIALS (linkType/linkPage/pageId), not events. We build the
     // items directly (via buildElement, so buildFromSpec doesn't grid-stack the menu) and leave
@@ -327,16 +329,32 @@ export function headerSection(opts = {}) {
             children: menuItems,
         },
     };
+    // Right-hand actions: optional search / account / language, then cart + CTA — like real headers.
+    const actionChildren = [];
+    const actionWidths = [];
+    if (opts.search !== false) {
+        actionChildren.push({ type: "input-search", opts: { specials: { field_name: "search", placeholder: "Tìm kiếm sản phẩm...", showIcon: true }, config: { inputBackground: p.surfaceAlt, inputBorderColor: p.border, inputBorderRadius: "8px", iconColor: p.muted, placeholderColor: p.muted, iconAlign: "left" }, style: { height: 40 } } });
+        actionWidths.push({ unit: "px", absValue: 200 });
+    }
+    if (opts.account) {
+        actionChildren.push({ type: "member-bar", opts: { specials: { showView: "not_logged", layoutShow: "text", textLogin: "Đăng nhập", textSignup: "Đăng ký" }, config: { colorIcon: p.text }, style: { color: p.text } } });
+        actionWidths.push({ unit: "max-c" });
+    }
+    if (opts.language) {
+        actionChildren.push({ type: "language-menu", opts: { specials: { show_flag: true, type: "dropdown" }, config: { color: p.text, display: "abbreviated" } } });
+        actionWidths.push({ unit: "max-c" });
+    }
+    actionChildren.push({ type: "cart-icon", opts: { style: { width: 26, height: 26, color: p.text } } });
+    actionWidths.push({ unit: "px", absValue: 32 });
+    actionChildren.push(cta(opts.cta || "Đặt mua ngay", p, { navTo: "collections", height: 44 }));
+    actionWidths.push({ unit: "max-c" });
     const actions = {
         type: "container",
         layout: "row",
         columnGap: 16,
-        colWidths: [{ unit: "px", absValue: 32 }, { unit: "max-c" }],
-        collapse: { bp4: 2 },
-        children: [
-            { type: "cart-icon", opts: { style: { width: 26, height: 26, color: p.text } } },
-            cta(opts.cta || "Đặt mua ngay", p, { navTo: "collections", height: 44 }),
-        ],
+        colWidths: actionWidths,
+        collapse: { bp4: Math.min(2, actionChildren.length) },
+        children: actionChildren,
     };
     return buildSection([
         {

package/dist/changelog.json

@@ -1,4 +1,18 @@
 [
+  {
+    "v": "1.30.0",
+    "d": "26/06/2026",
+    "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."
+  },
   {
     "v": "1.28.0",
     "d": "26/06/2026",
@@ -26,19 +40,5 @@
     "type": "Fixed",
     "en": "create_product now accepts a short_description parameter and sends it to the backend as [{description}] — the array shape the real product schema…",
     "vi": "create_product nay nhận thêm tham số short_description và gửi lên backend dưới dạng [{description}] — đúng kiểu mảng mà schema sản phẩm thực tế yêu…"
-  },
-  {
-    "v": "1.25.0",
-    "d": "26/06/2026",
-    "type": "Changed",
-    "en": "list_elements now documents 16 previously-uncovered element types, completing curated attribute coverage across all 132 factory types: popup…",
-    "vi": "list_elements nay tài liệu hóa 16 kiểu phần tử trước đây chưa được ghi lại, hoàn thiện độ phủ thuộc tính curated cho toàn bộ 132 kiểu factory: popup…"
-  },
-  {
-    "v": "1.24.0",
-    "d": "26/06/2026",
-    "type": "Changed",
-    "en": "list_elements now documents tabIndex and text_animation_type as shared specials present on every element, covering tab-panel visibility binding and…",
-    "vi": "list_elements nay tài liệu hóa tabIndex và text_animation_type là các specials dùng chung có trên mọi phần tử, bao gồm gắn kết hiển thị/ẩn cho…"
   }
 ]

package/dist/tools/customers.js

@@ -1,5 +1,35 @@
 import { z } from "zod";
 export function registerCustomerTools(server, api, handle) {
+    server.tool("list_customers", "List/search the site's customers (browse or segment). Pass `term` to search by name/phone/email. Returns name, phone, email, order_count, purchased_amount, reward_point, tags, last_order_at. Use find_customer for an exact id/phone/email lookup.", {
+        page: z.number().optional().describe("Page number (default 1)"),
+        limit: z.number().optional().describe("Items per page (default 50)"),
+        term: z.string().optional().describe("Keyword — searches name / phone / email"),
+    }, ({ page, limit, term }) => handle(async () => {
+        const query = { page: page ?? 1, limit: limit ?? 50 };
+        if (term && term.trim())
+            query.term = term.trim();
+        const res = await api.listCustomers(query);
+        // Real shape: { customers: { data:[…], total_entries } }.
+        const box = (res && res.customers) || res || {};
+        const list = (Array.isArray(box) ? box : box.data) || [];
+        if (!Array.isArray(list))
+            return res;
+        return {
+            data: list.map((c) => ({
+                id: c.id,
+                name: c.name,
+                phone_number: c.phone_number || c.recent_phone_number || undefined,
+                email: c.email || undefined,
+                order_count: c.order_count ?? undefined,
+                succeed_order_count: c.succeed_order_count ?? undefined,
+                purchased_amount: c.purchased_amount ?? undefined,
+                reward_point: c.reward_point ?? undefined,
+                tags: c.tags && c.tags.length ? c.tags : undefined,
+                last_order_at: c.last_order_at || undefined,
+            })),
+            total: (box.total_entries ?? res.total) || list.length,
+        };
+    }));
     server.tool("find_customer", "Find a customer by ID, phone number, or email", {
         by: z.enum(["id", "phone", "email"]).describe("Search field"),
         value: z.string().describe("Search value"),

package/dist/tools/global-section-write.js

@@ -135,11 +135,15 @@ force=true. Two-step safety: dry_run=true (default) previews; dry_run=false perf
         links: z.array(z.object({ label: z.string(), navTo: z.string().optional(), url: z.string().optional() })).optional().describe("Header nav links. navTo = a page slug ('home','collections','cart') auto-wired to open_page; url = external link. Defaults to Home/Products/Cart."),
         contact: z.object({ phone: z.string().optional(), email: z.string().optional(), address: z.string().optional() }).optional().describe("Real contact info for the footer (don't invent — omit what you don't have)."),
         cta: z.string().optional().describe("Header call-to-action button label (default 'Đặt mua ngay')."),
+        logo: z.string().optional().describe("Logo image URL (hosted) — renders an image instead of the brand text."),
+        search: z.boolean().default(true).describe("Add a storefront search box to the header (most real templates have one)."),
+        account: z.boolean().default(false).describe("Add a login/account bar (member sites)."),
+        language: z.boolean().default(false).describe("Add a language switcher (multilingual sites)."),
         palette: z.record(z.any()).optional().describe("Optional colour overrides { accent, onAccent, text, muted, surface, surfaceAlt, border }."),
         include: z.enum(["both", "header", "footer"]).default("both").describe("Which chrome to generate."),
         force: z.boolean().default(false).describe("Create even if a header/footer global already exists (otherwise that slot is skipped)."),
         dry_run: z.boolean().default(true).describe("Preview (true) or perform the atomic save (false)."),
-    }, ({ brand, links, contact, cta, palette, include, force, dry_run }) => handle(async () => {
+    }, ({ brand, links, contact, cta, logo, search, account, language, palette, include, force, dry_run }) => handle(async () => {
         // Which slots already have a global section? (dedupe by type unless force)
         const existingRes = await api.listGlobalSections().catch(() => null);
         const existing = (existingRes && (existingRes.data || existingRes.global_sections || existingRes)) || [];
@@ -174,7 +178,7 @@ force=true. Two-step safety: dry_run=true (default) previews; dry_run=false perf
             if (!force && slotTaken("header"))
                 skipped.push("header");
             else
-                toCreate.push({ type: "header", name: "Header", node: buildNode("header", headerSection({ brand, links: links, cta, palette })) });
+                toCreate.push({ type: "header", name: "Header", node: buildNode("header", headerSection({ brand, links: links, cta, logo, search, account, language, palette })) });
         }
         if (wantFooter) {
             if (!force && slotTaken("footer"))

package/package.json

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