sbuilder-mcp 0.67.0 → 0.69.0

package/CHANGELOG.md

@@ -6,6 +6,26 @@ 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.69.0] - 2026-09-26
+
+### Added
+- `sb_store` gains action `checkout_sync`, which re-reads a store's current payment gateways and shipping methods into every existing order form (keeping each method's own label) and republishes the checkout pages, for when a gateway or shipping method is added after the checkout was built and the form's select is left pointing at stale options.
+
+### Changed
+- The generated catalog was regenerated against the platform (`web_builder` `a3a735283`): a cart-line's image now catalogs as a single thumbnail instead of a bottom strip, and a category's derived `slug` is now catalogued.
+
+### Fixed
+- The catalog generator was dropping every Go field that carried a trailing line comment, silently hiding `slug`, `parentId`, and `position` on categories and `description`, `images`, `attributes`, and `variants[].priceCents` on products from the catalog; `sb_api_find` also now reports a described body for `POST /api/sites` instead of `undescribed`.
+- `sb_media_upload` and the store's own upload path now read the uploaded file's URL from the response's top-level `url` when the asset entry itself carries none, instead of reporting every successful upload as having no URL.
+- `sb_store` action `chrome` now builds a footer whenever its columns carry two or more links in total, instead of skipping it whenever every individual column holds fewer than two — a footer with two columns of one link each was rendered empty.
+
+## [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,26 @@ 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.69.0] - 2026-09-26
+
+### Added
+- `sb_store` có thêm action `checkout_sync`, đọc lại các cổng thanh toán và phương thức giao hàng hiện tại của store rồi ghi vào mọi order form đang có (giữ nguyên label riêng của từng phương thức) và republish lại các trang checkout, dùng cho trường hợp một gateway hay phương thức giao hàng được thêm sau khi checkout đã được dựng, khiến select trong form vẫn trỏ vào các tùy chọn cũ.
+
+### Changed
+- Catalog được sinh ra đã được làm mới dựa trên nền tảng (`web_builder` `a3a735283`): ảnh của cart line giờ được catalog là một thumbnail duy nhất thay vì một dải ảnh phía dưới, và `slug` suy ra của category giờ cũng được catalog.
+
+### Fixed
+- Bộ sinh catalog trước đây bỏ rơi mọi field Go có comment cuối dòng, âm thầm làm mất `slug`, `parentId`, `position` của category và `description`, `images`, `attributes`, `variants[].priceCents` của product khỏi catalog; `sb_api_find` giờ cũng báo body của `POST /api/sites` là "described" thay vì "undescribed".
+- `sb_media_upload` và đường upload riêng của store giờ đọc URL của file đã tải lên từ trường `url` ở cấp cao nhất của response khi bản thân asset không mang URL, thay vì báo mọi lần upload thành công là không có URL.
+- Action `chrome` của `sb_store` giờ dựng footer bất cứ khi nào tổng số link trên các cột đạt từ hai trở lên, thay vì bỏ qua khi mỗi cột riêng lẻ có ít hơn hai link — một footer có hai cột mỗi cột một link trước đây bị dựng trống.
+
+## [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

@@ -111,11 +111,11 @@ in this client: one would put the very key the platform exists to hold back into
 | `sb_import` | Read a page from any public URL and add its structure and content to the open page as real elements, styled with THIS page's own tokens — a translation, not a clone |
 | `sb_import_site` | Read a WHOLE site from one URL — its sitemap, or the links on that page — and give each page found its own draft page here, built from this site's tokens; the entry page's own colours and type scale also patch into this SITE'S theme, so it stops being purely a read |
 | `sb_theme` | Read or patch the site's palette and type scale — the layer every style preset resolves from, so one token repaints every page; `locale` sets the site's language |
-| `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_store` | Run a store flow that must happen in a fixed order — `checkout` (the four writes that make a working one), `checkout_sync` (the store's current payment and delivery methods into every existing order form, checkout page republished), `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

@@ -108,11 +108,11 @@ nhét ngược lại vào mọi bản cài.
 | `sb_import` | Đọc một trang từ URL công khai bất kỳ và thêm cấu trúc + nội dung của nó vào trang đang mở dưới dạng element thật, mang token của CHÍNH trang này — là dịch lại, không phải sao chép |
 | `sb_import_site` | Đọc CẢ website từ một URL — sitemap của nó, hoặc các link trên trang đó — và tạo cho mỗi trang tìm được một trang nháp riêng ở đây, dựng bằng token của site này; màu và thang chữ của trang gốc cũng được vá vào THEME của site này, nên đây không còn thuần là đọc |
 | `sb_theme` | Đọc hoặc vá bảng màu và thang chữ của site — tầng mà mọi style preset phân giải từ đó, nên một token thay áo cho mọi trang; `locale` đặt ngôn ngữ của site |
-| `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_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), `checkout_sync` (đưa phương thức thanh toán và giao hàng hiện tại vào mọi form đặt hàng đã có, publish lại 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": {
@@ -18704,7 +18953,7 @@ export const API_DEFINITIONS = {
                 "type": "string"
             },
             "slug": {
-                "description": "unique per (siteId, slug) within its own type",
+                "description": "unique per (siteId, slug) within its own type; derived from Name when empty on create",
                 "type": "string"
             },
             "updatedAt": {

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": 84432,
+    "seededKeys": 442,
     "dead": 0
 };
 /**