sbuilder-mcp 0.67.0 → 0.68.0

package/CHANGELOG.md

@@ -6,6 +6,13 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.68.0] - 2026-09-25
+
+### Changed
+- The generated catalog was regenerated against the platform: two new dataset elements, `flash-sale-price` (a product price that swaps to the sale price while a flash sale covers the product) and `flash-sale-progress` (a stock/urgency bar for a running flash sale), and the `countdown` element gains a `sourceFlashSale` option that counts down to the flash sale running right now instead of a typed end time.
+- The catalog now carries 6 new flash-sale operations (list active flash sales, and list/create/get/update/delete a site's flash sales), discoverable through `sb_api_find` and callable through `sb_api_call`.
+- Card and chip defaults across the catalog — account, voucher, countdown, tab, accordion, variant, and filter elements — now read the theme's `var(--wb-sc-*)` tokens instead of a hardcoded color, so a dark-themed site no longer shows dark text pinned to a light background on these elements.
+
 ## [0.67.0] - 2026-09-25
 
 ### Added

package/CHANGELOG.vi.md

@@ -6,6 +6,13 @@ Mọi thay đổi đáng chú ý của dự án được ghi lại trong file n
 Định dạng dựa trên [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 và dự án tuân theo [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.68.0] - 2026-09-25
+
+### Changed
+- Catalog được sinh ra đã được làm mới dựa trên nền tảng: thêm hai element dataset mới, `flash-sale-price` (giá sản phẩm tự chuyển sang giá sale khi sản phẩm nằm trong một flash sale) và `flash-sale-progress` (thanh thể hiện tình trạng bán/cháy hàng của một flash sale đang chạy), và element `countdown` có thêm tùy chọn `sourceFlashSale` để đếm ngược theo flash sale đang chạy thay vì phải nhập sẵn thời điểm kết thúc.
+- Catalog giờ mang thêm 6 operation flash-sale mới (liệt kê flash sale đang chạy, và liệt kê/tạo/lấy/cập nhật/xóa flash sale của site), có thể tìm thấy qua `sb_api_find` và gọi qua `sb_api_call`.
+- Giá trị mặc định của thẻ và chip trên khắp catalog — element tài khoản, voucher, countdown, tab, accordion, biến thể và bộ lọc — giờ đọc theo token `var(--wb-sc-*)` của theme thay vì màu cố định, nên một site theme tối không còn hiện chữ tối đè lên nền sáng cố định ở những element này.
+
 ## [0.67.0] - 2026-09-25
 
 ### Added

package/README.md

@@ -114,8 +114,8 @@ in this client: one would put the very key the platform exists to hold back into
 | `sb_store` | Run a store flow that must happen in a fixed order — `checkout` (the four writes that make a working one), `form` (any of the platform's 17 templates with its own field document), `chrome` (one shared header or footer on a real site menu — desktop menu, mobile drawer, cart and account icons), `menu` (a menu node bound to the site's menu, its links resolved), `overlay_attach` (a pop-up or quick view on the open page), `cart` (the site's cart drawer, when it has none; `relocalize` puts an existing one in the site's language) and `app` (a built-in app plus the pages it needs), `global_attach` / `global_detach` (put an EXISTING shared section on the open page, or take it off) |
 | `sb_undo` | Put back what a PUT replaced. The SECOND answer for a page, not the only one: the platform has versions, history and restore (`sb_api_find` "page versions"), which outlive this process — reach for those first and use this for every other shaped PUT |
 
-Twenty-eight tools, **568 API operations** (195 of the 253 writes carrying a body shape read
-off the handler), 120 elements, 79 binding sources. `sb_api_find`
+Twenty-eight tools, **574 API operations** (197 of the 255 writes carrying a body shape read
+off the handler), 122 elements, 79 binding sources. `sb_api_find`
 is an index rather than a tool per endpoint, so the tool list stays short while everything
 the platform can do stays reachable — and operations added to the platform arrive with the
 next `npm run codegen`.

package/README.vi.md

@@ -111,8 +111,8 @@ nhét ngược lại vào mọi bản cài.
 | `sb_store` | Chạy một luồng cửa hàng bắt buộc đúng thứ tự — `checkout` (bốn lệnh ghi tạo nên trang thanh toán), `form` (một trong 17 template của nền tảng kèm field document của nó), `chrome` (một header hoặc footer dùng chung trên menu thật của site — menu desktop, drawer mobile, icon giỏ hàng và tài khoản), `menu` (một node menu bind vào menu của site, link đã phân giải), `overlay_attach` (một pop-up hay quick view trên trang đang mở), `cart` (ngăn giỏ hàng của site, khi chưa có; `relocalize` đưa ngăn giỏ đã có về ngôn ngữ của site), `app` (một app dựng sẵn kèm những trang nó cần), và `global_attach` / `global_detach` (đặt một section dùng chung ĐÃ CÓ lên trang đang mở, hoặc gỡ ra) |
 | `sb_undo` | Trả lại thứ mà một lệnh PUT đã ghi đè. Với TRANG thì đây là đường về thứ hai chứ không phải duy nhất: nền tảng có version, history và restore (`sb_api_find` "page versions"), và chúng sống lâu hơn tiến trình này — hãy dùng chúng trước, còn tool này cho mọi PUT có hình dạng khác |
 
-Hai mươi tám tool, **568 operation API** (195 trong 253 lệnh ghi có hình dạng body đọc thẳng
-từ handler), 120 element, 79 nguồn binding. `sb_api_find` là
+Hai mươi tám tool, **574 operation API** (197 trong 255 lệnh ghi có hình dạng body đọc thẳng
+từ handler), 122 element, 79 nguồn binding. `sb_api_find` là
 một chỉ mục chứ không phải mỗi endpoint một tool, nên danh sách tool vẫn ngắn trong khi mọi
 thứ nền tảng làm được vẫn với tới — và operation mới thêm bên nền tảng sẽ tự có sau lần
 `npm run codegen` kế tiếp.

package/dist/catalog/api.generated.js

@@ -1,7 +1,7 @@
 export const SWAGGER_SOURCE = {
-    "operations": 568,
-    "definitions": 108,
-    "bodyCarrying": 214,
+    "operations": 574,
+    "definitions": 110,
+    "bodyCarrying": 219,
     "bodyUndescribed": 92,
     "generatedFrom": "server/docs/swagger.json"
 };
@@ -978,6 +978,19 @@ export const API_OPERATIONS = [
         "bodyRef": null,
         "credential": "siteScoped"
     },
+    {
+        "id": "get:/_wb/flashsales/active",
+        "method": "GET",
+        "path": "/_wb/flashsales/active",
+        "tags": [
+            "storeflashsales"
+        ],
+        "summary": "List the site's running flash-sale campaigns and items",
+        "params": [],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
     {
         "id": "get:/_wb/forms/{formId}/slots",
         "method": "GET",
@@ -8021,6 +8034,167 @@ export const API_OPERATIONS = [
         "bodyRef": null,
         "credential": "siteScoped"
     },
+    {
+        "id": "get:/api/sites/{siteId}/flash-sales",
+        "method": "GET",
+        "path": "/api/sites/{siteId}/flash-sales",
+        "tags": [
+            "flashsales"
+        ],
+        "summary": "List or create flash sales",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "flashSale",
+                "in": "body",
+                "required": false,
+                "type": "object",
+                "description": "Flash sale to create (POST only)"
+            }
+        ],
+        "bodyDescribed": true,
+        "bodyRef": "github_com_webbuilder_server_internal_flashsales.FlashSale",
+        "credential": "siteScoped"
+    },
+    {
+        "id": "post:/api/sites/{siteId}/flash-sales",
+        "method": "POST",
+        "path": "/api/sites/{siteId}/flash-sales",
+        "tags": [
+            "flashsales"
+        ],
+        "summary": "List or create flash sales",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "flashSale",
+                "in": "body",
+                "required": false,
+                "type": "object",
+                "description": "Flash sale to create (POST only)"
+            }
+        ],
+        "bodyDescribed": true,
+        "bodyRef": "github_com_webbuilder_server_internal_flashsales.FlashSale",
+        "credential": "siteScoped"
+    },
+    {
+        "id": "get:/api/sites/{siteId}/flash-sales/{id}",
+        "method": "GET",
+        "path": "/api/sites/{siteId}/flash-sales/{id}",
+        "tags": [
+            "flashsales"
+        ],
+        "summary": "Get, update or delete a flash sale",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Flash sale ID"
+            },
+            {
+                "name": "flashSale",
+                "in": "body",
+                "required": false,
+                "type": "object",
+                "description": "Updated flash sale (PUT only)"
+            }
+        ],
+        "bodyDescribed": true,
+        "bodyRef": "github_com_webbuilder_server_internal_flashsales.FlashSale",
+        "credential": "siteScoped"
+    },
+    {
+        "id": "put:/api/sites/{siteId}/flash-sales/{id}",
+        "method": "PUT",
+        "path": "/api/sites/{siteId}/flash-sales/{id}",
+        "tags": [
+            "flashsales"
+        ],
+        "summary": "Get, update or delete a flash sale",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Flash sale ID"
+            },
+            {
+                "name": "flashSale",
+                "in": "body",
+                "required": false,
+                "type": "object",
+                "description": "Updated flash sale (PUT only)"
+            }
+        ],
+        "bodyDescribed": true,
+        "bodyRef": "github_com_webbuilder_server_internal_flashsales.FlashSale",
+        "credential": "siteScoped"
+    },
+    {
+        "id": "delete:/api/sites/{siteId}/flash-sales/{id}",
+        "method": "DELETE",
+        "path": "/api/sites/{siteId}/flash-sales/{id}",
+        "tags": [
+            "flashsales"
+        ],
+        "summary": "Get, update or delete a flash sale",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Flash sale ID"
+            },
+            {
+                "name": "flashSale",
+                "in": "body",
+                "required": false,
+                "type": "object",
+                "description": "Updated flash sale (PUT only)"
+            }
+        ],
+        "bodyDescribed": true,
+        "bodyRef": "github_com_webbuilder_server_internal_flashsales.FlashSale",
+        "credential": "siteScoped"
+    },
     {
         "id": "get:/api/sites/{siteId}/fonts",
         "method": "GET",
@@ -17574,6 +17748,73 @@ export const API_DEFINITIONS = {
             }
         }
     },
+    "github_com_webbuilder_server_internal_flashsales.FlashSale": {
+        "type": "object",
+        "properties": {
+            "active": {
+                "type": "boolean"
+            },
+            "allowDiscountCodes": {
+                "type": "boolean"
+            },
+            "createdAt": {
+                "type": "string"
+            },
+            "endsAt": {
+                "type": "string"
+            },
+            "id": {
+                "type": "string"
+            },
+            "items": {
+                "type": "array",
+                "items": {
+                    "$ref": "#/definitions/github_com_webbuilder_server_internal_flashsales.Item"
+                }
+            },
+            "name": {
+                "type": "string"
+            },
+            "siteId": {
+                "type": "string"
+            },
+            "startsAt": {
+                "type": "string"
+            },
+            "updatedAt": {
+                "type": "string"
+            }
+        }
+    },
+    "github_com_webbuilder_server_internal_flashsales.Item": {
+        "type": "object",
+        "properties": {
+            "flashSaleId": {
+                "type": "string"
+            },
+            "id": {
+                "type": "string"
+            },
+            "perOrderLimit": {
+                "type": "integer"
+            },
+            "productId": {
+                "type": "string"
+            },
+            "quota": {
+                "type": "integer"
+            },
+            "salePriceCents": {
+                "type": "integer"
+            },
+            "sold": {
+                "type": "integer"
+            },
+            "variantId": {
+                "type": "string"
+            }
+        }
+    },
     "github_com_webbuilder_server_internal_fonts.FontFile": {
         "type": "object",
         "properties": {
@@ -18254,12 +18495,20 @@ export const API_DEFINITIONS = {
     "github_com_webbuilder_server_internal_orders.OrderItem": {
         "type": "object",
         "properties": {
+            "flashItemId": {
+                "description": "FlashItemID names the flash-sale item this line was priced by (\"\" = the\ncatalogue price). Set only by LineResolver.Items; the quota claim and its\nrelease key on it. See orders/flash.go.",
+                "type": "string"
+            },
             "image": {
                 "type": "string"
             },
             "name": {
                 "type": "string"
             },
+            "noDiscount": {
+                "description": "NoDiscount keeps this line out of every discount base — a flash-sale line\nwhose campaign does not stack with codes. See Checkout.orderContext.",
+                "type": "boolean"
+            },
             "options": {
                 "type": "object",
                 "additionalProperties": {

package/dist/catalog/checkout.generated.js

@@ -627,7 +627,7 @@ export const CHECKOUT_PAGE_DOCUMENT = {
                 "gap": "12px",
                 "fontSize": "16px",
                 "fontWeight": "400",
-                "color": "#171717"
+                "color": "var(--wb-sc-heading, #171717)"
             },
             "config": {},
             "specials": {
@@ -658,7 +658,7 @@ export const CHECKOUT_PAGE_DOCUMENT = {
                 "gap": "12px",
                 "fontSize": "16px",
                 "fontWeight": "400",
-                "color": "#171717"
+                "color": "var(--wb-sc-heading, #171717)"
             },
             "config": {},
             "specials": {
@@ -689,7 +689,7 @@ export const CHECKOUT_PAGE_DOCUMENT = {
                 "gap": "12px",
                 "fontSize": "16px",
                 "fontWeight": "400",
-                "color": "#171717"
+                "color": "var(--wb-sc-heading, #171717)"
             },
             "config": {},
             "specials": {
@@ -720,7 +720,7 @@ export const CHECKOUT_PAGE_DOCUMENT = {
                 "gap": "12px",
                 "fontSize": "16px",
                 "fontWeight": "600",
-                "color": "#171717"
+                "color": "var(--wb-sc-heading, #171717)"
             },
             "config": {},
             "specials": {
@@ -751,7 +751,7 @@ export const CHECKOUT_PAGE_DOCUMENT = {
                 "gap": "12px",
                 "fontSize": "16px",
                 "fontWeight": "600",
-                "color": "#171717"
+                "color": "var(--wb-sc-heading, #171717)"
             },
             "config": {},
             "specials": {

package/dist/catalog/deadkeys.generated.js

@@ -1,7 +1,7 @@
 export const DEAD_KEY_SOURCE = {
-    "files": 4426,
-    "identifiers": 83752,
-    "seededKeys": 436,
+    "files": 4486,
+    "identifiers": 84430,
+    "seededKeys": 442,
     "dead": 0
 };
 /**