sbuilder-mcp 0.64.0 → 0.66.0

package/CHANGELOG.md

@@ -6,6 +6,51 @@ 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.66.0] - 2026-09-25
+
+### Added
+- `sb_add` can now create a satellite on its host — such as the `cart-count` badge on a cart icon — instead of refusing it as a non-container, and `sb_remove` removes one and clears the host's reference to it; the `cartCount` readiness remedy now names `sb_add`.
+- `sb_store` action `cart` now seeds the site's cart drawer in the site's own language, read from `settings.locale`, instead of always seeding English, falling back to English when no per-locale seed exists.
+- `sb_store` action `chrome` now builds a real site menu and wires the header to it — a hover/dropdown desktop menu hidden on mobile, a hamburger drawer holding its own vertical menu on mobile, an account icon to `/account`, and a cart icon carrying `open_cart` badged by `cart-count` — replacing the row of buttons `sb_review` itself flagged as `handbuilt_menu`; it also creates the site's cart drawer when the header's cart icon would otherwise open nothing.
+- `sb_review` warns once per site (`site_language`) when the page's copy doesn't match the site's `settings.locale`, and `sb_theme` gains a `locale` argument to set it.
+- `sb_publish` lists other pages with unpublished drafts as `unpublished_drafts`, and `publish_drafts: true` publishes them in the same call.
+- A page save now sends the draft's revision as `baseRev` and yields — re-pulling and rebasing — when the platform reports the draft moved underneath it (`source_stale`) or broadcasts a newer revision; it names the live peer on a save (`X-WB-Live-Peer`) only once every patch in that save is confirmed acknowledged by the room, so an editor tab with unsaved edits can adopt the save instead of quietly losing it later.
+
+### Changed
+- A page-document write that bypasses `sb_set` — a raw `sb_api_call` PUT, `sb_page_repair`, a version or history restore, or a `sb_store` flow — now reaches a live editor watching that page as ops and marks this session's own copy stale, instead of one side silently overwriting the other.
+- The generated catalog was regenerated against the platform: 120 elements and per-locale cart drawer seeds.
+
+### Fixed
+- Closed several races in the save-and-rebase path that could lose an edit under concurrent access: a 409 rebase no longer republishes ops already sent to the room, a finishing save no longer clears another in-flight save's slot, a peer's edit landing mid-save is no longer discarded by that save, a source frame arriving during a re-read is judged against the revision it actually reports, and an editor's own change is no longer mistaken for this session's unsaved edit.
+- Rejoining a live room no longer vouches for ops the previous room never acknowledged, and the auth/session frame is never reported as a snapshot provider (`noSnapshot`), closing two ways a stale save could be replayed under a peer's name.
+- `sb_theme`'s locale write no longer partially applies: it validates the language tag and reads settings before the theme PUT, tries the full settings body with every credential before falling back to a locale-only body, and writes the locale only after the theme save and every other check succeed.
+- `sb_store` action `chrome` no longer overwrites a merchant's fully-linked menu when a transient lookup failure makes it look unresolved, and now fills a reused placeholder menu (four `type:none` rows) in with real links instead of leaving it empty; its dry run now summarizes the cart drawer it would create instead of embedding the full seed document.
+- A product card's image now shows as one square thumbnail instead of a strip of three empty ones, and a category tile now binds `category.image` instead of the product-image binding it inherited from the generic media pattern.
+- `sb_review`'s `categoryScope` gap now fires only when the open page is the shared category template with every product repeater pinned to a named collection, not on every site with more than one category.
+- `sb_review`'s `order_goes_nowhere` gap now judges only the checkout form, no longer flagging every login, register, forgot-password, and reset-password page because the cart drawer composed onto them also holds a cart total.
+- A nested satellite given as part of a node spec is now seeded and attached correctly instead of being born bare or refused as a child of a non-container.
+- Every page `sb_page_create` and `sb_store` create now mints fresh node ids instead of shipping the codegen placeholder ids verbatim, so two pages of the same type no longer share ids.
+- `sb_page_state` now reports `canvas.minted_root` when a page's root node isn't called `ROOT`, warning that an older editor may paint it blank and autosave over it.
+- The page a `sb_store` action `form` flow creates now wears the site's global header and footer, matching pages created by `sb_page_create`.
+
+## [0.65.0] - 2026-09-25
+
+### Added
+- `sb_page_create` now infers the page's type from its name (about, contact, policy, faq) when no `type` argument is passed, and opens it with that purpose's own layout.
+- `sb_page_repair` is a new tool that renames a page's root node to `ROOT` on one page, or every page on a site, when an older seed minted a different id (`sppro_1`, `rt_<hex>`); it defaults `dry_run` to true and lists the pages it would touch before writing anything.
+- `sb_page_open` now reports `minted_root` when the opened page's root node is not called `ROOT`, warning that an editor built before web_builder `7322af49a` renders such a page as a blank white canvas and may autosave an empty document over it.
+- `sb_store` action `form` now creates a login, register, or contact page as its own purpose type (`login`, `register`, `contact`) instead of a generic `page`, matching the platform's own routed page types.
+
+### Changed
+- Every page document this server writes — `sb_page_create`'s seed, `sb_store`'s checkout and app-scaffold creates, and any raw `sb_api_call` carrying a page document — now leaves the process rooted at `ROOT`, healed in transport regardless of which tool produced it.
+- A session whose save is rejected because the page changed underneath it now re-pulls the fresh document and reapplies the pending patches once automatically, instead of always requiring the caller to re-read and redo the edit; it still fails loudly when the other side touched one of the same nodes or local edits were unsaved.
+- `sb_page_list`'s `page_types_note` now explains that about, contact, policy, faq, login, and register name a content page's purpose with its own type and icon, and that `sb_page_create` picks that type from the name automatically.
+- The generated catalog was regenerated against the platform: 119 elements and 568 operations, including 18 page types and coverage for `FormKnobs`, `TextFieldKnobs`, and `SearchPanelKnobs` field-skin keys.
+- `sb_import_site`'s page-token reader now reads only the page's own bands when picking up heading, text, and button styles, skipping a composed global header or footer so an inserted band no longer inherits a dark header's white-on-dark styling.
+
+### Fixed
+- A newly added `countdown` element is now flagged as inert on add, since it seeds with no end time and paints four boxes counting down to nothing until `specials.endsAt` or `specials.sourceCode` is set.
+
 ## [0.64.0] - 2026-09-24
 
 ### Added

package/CHANGELOG.vi.md

@@ -6,6 +6,51 @@ 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.66.0] - 2026-09-25
+
+### Added
+- `sb_add` giờ có thể tạo một satellite trên host của nó — ví dụ badge `cart-count` trên icon giỏ hàng — thay vì từ chối vì host không phải container, và `sb_remove` xoá satellite đó và dọn tham chiếu trên host; remedy `cartCount` của readiness giờ chỉ đích danh `sb_add`.
+- Action `cart` của `sb_store` giờ gieo cart drawer của site bằng đúng ngôn ngữ của site, đọc từ `settings.locale`, thay vì luôn gieo bằng tiếng Anh, và rơi về tiếng Anh khi không có seed theo locale.
+- Action `chrome` của `sb_store` giờ tạo một site menu thật và nối header vào đó — menu desktop kiểu hover/dropdown ẩn trên mobile, một hamburger drawer chứa menu dọc riêng trên mobile, icon tài khoản trỏ tới `/account`, và icon giỏ hàng mang `open_cart` kèm badge `cart-count` — thay cho hàng nút bấm mà chính `sb_review` từng gắn cờ `handbuilt_menu`; nó cũng tạo cart drawer cho site khi icon giỏ hàng trên header sẽ mở ra không gì cả.
+- `sb_review` cảnh báo một lần cho mỗi site (`site_language`) khi nội dung trang không khớp `settings.locale` của site, và `sb_theme` có thêm tham số `locale` để đặt nó.
+- `sb_publish` liệt kê các trang khác đang có draft chưa publish dưới `unpublished_drafts`, và `publish_drafts: true` sẽ publish luôn các trang đó trong cùng lệnh gọi.
+- Một lần lưu trang giờ gửi revision của draft dưới dạng `baseRev` và nhường bước — đọc lại và rebase — khi nền tảng báo draft đã thay đổi bên dưới nó (`source_stale`) hoặc phát ra một revision mới hơn; nó chỉ đích danh live peer khi lưu (`X-WB-Live-Peer`) khi mọi patch trong lần lưu đó đã được phòng xác nhận, để một tab editor còn thay đổi chưa lưu có thể nhận lấy lần lưu này thay vì âm thầm mất nó sau đó.
+
+### Changed
+- Một lần ghi tài liệu trang không đi qua `sb_set` — một PUT thô qua `sb_api_call`, `sb_page_repair`, khôi phục version hoặc history, hay một flow của `sb_store` — giờ đến được với editor đang xem trang đó dưới dạng ops và đánh dấu bản sao của session này là cũ, thay vì bên này âm thầm ghi đè bên kia.
+- Catalog được sinh ra đã được làm mới dựa trên nền tảng: 120 element và cart drawer seed theo từng locale.
+
+### Fixed
+- Đã đóng một số race trong luồng lưu-và-rebase có thể làm mất một thay đổi khi truy cập đồng thời: một rebase sau lỗi 409 không còn gửi lại các ops đã gửi lên phòng, một lần lưu vừa hoàn tất không còn xoá slot in-flight của một lần lưu khác, một chỉnh sửa của peer đến giữa lúc đang lưu không còn bị lần lưu đó xoá mất, một source frame đến trong lúc đang đọc lại được xét đúng theo revision mà nó thực sự báo, và thay đổi của chính editor không còn bị nhầm là thay đổi cục bộ chưa lưu của session này.
+- Rejoin vào một phòng live không còn vouch cho các ops mà phòng cũ chưa từng ack, và frame auth/session không bao giờ bị báo là nơi cung cấp snapshot (`noSnapshot`), đóng lại hai cách một lần lưu cũ có thể bị phát lại dưới tên một peer.
+- Lần ghi locale của `sb_theme` không còn áp dụng nửa chừng: nó kiểm tra language tag và đọc settings trước khi PUT theme, thử toàn bộ settings body với từng credential trước khi rơi về body chỉ có locale, và chỉ ghi locale sau khi lần lưu theme và mọi kiểm tra khác thành công.
+- Action `chrome` của `sb_store` không còn ghi đè menu đã liên kết đầy đủ của merchant khi một lỗi lookup tạm thời khiến nó trông như chưa được liên kết, và giờ điền các liên kết thật vào một menu placeholder được dùng lại (bốn dòng `type:none`) thay vì để trống; dry run của nó giờ tóm tắt cart drawer sẽ tạo thay vì nhúng nguyên tài liệu seed.
+- Ảnh trên thẻ sản phẩm giờ hiển thị một thumbnail vuông duy nhất thay vì một dải ba ảnh trống, và ô category giờ bind `category.image` thay vì binding ảnh sản phẩm mà nó thừa hưởng từ pattern media chung.
+- Gap `categoryScope` của `sb_review` giờ chỉ nổ ra khi trang đang mở là category template dùng chung với mọi product repeater được ghim vào một collection có tên, không còn nổ ra trên mọi site có hơn một category.
+- Gap `order_goes_nowhere` của `sb_review` giờ chỉ xét form checkout, không còn gắn cờ mọi trang login, register, quên mật khẩu và đặt lại mật khẩu chỉ vì cart drawer được compose lên các trang đó cũng có cart total.
+- Một satellite lồng bên trong một node spec giờ được seed và gắn đúng cách thay vì sinh ra trống trơn hoặc bị từ chối vì host không phải container.
+- Mỗi lần tạo trang qua `sb_page_create` và `sb_store` giờ sinh id node mới thay vì dùng nguyên id placeholder từ codegen, nên hai trang cùng loại không còn trùng id.
+- `sb_page_state` giờ báo `canvas.minted_root` khi node root của một trang không mang tên `ROOT`, cảnh báo rằng một editor cũ hơn có thể vẽ trang đó trắng trơn và autosave đè lên nó.
+- Trang mà flow `form` của `sb_store` tạo ra giờ mang header và footer chung của site, khớp với các trang do `sb_page_create` tạo.
+
+## [0.65.0] - 2026-09-25
+
+### Added
+- `sb_page_create` giờ tự suy ra type của trang từ tên (about, contact, policy, faq) khi không truyền tham số `type`, và mở trang đó với layout đúng với mục đích của nó.
+- `sb_page_repair` là một tool mới, đổi tên node root của trang thành `ROOT` trên một trang, hoặc trên mọi trang của một site, khi một seed cũ hơn đã sinh ra một id khác (`sppro_1`, `rt_<hex>`); tool mặc định `dry_run` là true và liệt kê các trang sẽ bị ảnh hưởng trước khi ghi bất cứ thứ gì.
+- `sb_page_open` giờ báo cáo `minted_root` khi node root của trang đang mở không mang tên `ROOT`, cảnh báo rằng một editor được build trước web_builder `7322af49a` sẽ render trang đó thành một canvas trắng và có thể autosave một tài liệu rỗng đè lên nó.
+- Action `form` của `sb_store` giờ tạo trang login, register, hoặc contact đúng theo type mục đích của nó (`login`, `register`, `contact`) thay vì một `page` chung chung, khớp với các page type đã được nền tảng định tuyến sẵn.
+
+### Changed
+- Mọi tài liệu trang mà server này ghi ra — seed của `sb_page_create`, các lệnh tạo checkout và app-scaffold của `sb_store`, và bất kỳ `sb_api_call` thô nào mang theo tài liệu trang — giờ đều rời khỏi tiến trình với root là `ROOT`, được chữa ở tầng transport bất kể tool nào tạo ra nó.
+- Một session mà lệnh lưu bị từ chối vì trang đã thay đổi bên dưới nó giờ sẽ tự động đọc lại tài liệu mới nhất và áp lại các patch đang chờ một lần, thay vì luôn bắt caller phải đọc lại và làm lại thay đổi; session vẫn báo lỗi rõ ràng khi bên kia đã sửa đúng những node này hoặc khi còn thay đổi cục bộ chưa lưu.
+- `page_types_note` của `sb_page_list` giờ giải thích rằng about, contact, policy, faq, login và register đặt tên cho mục đích của một trang nội dung với type và icon riêng của nó, và `sb_page_create` tự chọn type đó từ tên trang.
+- Catalog được sinh ra đã được làm mới dựa trên nền tảng: 119 element và 568 operation, bao gồm 18 page type và độ phủ cho các key field-skin `FormKnobs`, `TextFieldKnobs`, và `SearchPanelKnobs`.
+- Bộ đọc token trang của `sb_import_site` giờ chỉ đọc các band thuộc về chính trang khi lấy style heading, text và button, bỏ qua một header hoặc footer dùng chung đã compose, để một band mới chèn vào không còn bị kế thừa kiểu chữ trắng-trên-nền-tối của header.
+
+### Fixed
+- Một element `countdown` mới được thêm giờ được đánh dấu là inert khi thêm, vì nó được gieo sẵn không có thời gian kết thúc và vẽ ra bốn ô đếm ngược về không cho đến khi `specials.endsAt` hoặc `specials.sourceCode` được thiết lập.
+
 ## [0.64.0] - 2026-09-24
 
 ### Added

package/README.md

@@ -98,8 +98,9 @@ in this client: one would put the very key the platform exists to hold back into
 | `sb_template_use` | Instantiate a template into a page |
 | `sb_page_list` | Every page on the site |
 | `sb_page_create` | Create a page — a store type arrives with the editor's own starting document; `type` is the route for checkout, product, category, post, course |
-| `sb_publish` | Compile the draft into the live page (cascades to shared globals), report which revision went live, and with `verify` check the origin is serving it |
+| `sb_publish` | Compile the draft into the live page (cascades to shared globals), report which revision went live, and with `verify` check the origin is serving it; lists other pages with unpublished drafts (`publish_drafts` publishes them too) |
 | `sb_page_state` | Which of a page's three copies is which — the DRAFT the editor canvas shows, the PUBLISHED row the storefront serves, and this session's — plus whether the editor will render the canvas BLANK, and where the recovery points are |
+| `sb_page_repair` | Rename a page root that is not `ROOT` (left by older seeds) so every editor build draws it — one page or the whole site |
 | `sb_review` | Every defect a visitor would see, each with its fix, plus the five gaps between this store and a paid order |
 | `sb_media_list` | The site's media library |
 | `sb_media_upload` | Add an image and get its URL — a local path, a URL the platform fetches, or a SEARCH for real photographs you read and pick from, one or several at a time |
@@ -109,12 +110,12 @@ in this client: one would put the very key the platform exists to hold back into
 | `sb_bind` | Bind a node's content to real store data, or make a button add to the cart |
 | `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 |
-| `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), `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) 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_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) 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, **560 API operations** (193 of the 251 writes carrying a body shape read
-off the handler), 113 elements, 79 binding sources. `sb_api_find`
+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`
 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

@@ -95,8 +95,9 @@ nhét ngược lại vào mọi bản cài.
 | `sb_template_use` | Thả một template vào trang |
 | `sb_page_list` | Mọi trang của site |
 | `sb_page_create` | Tạo một trang — trang cửa hàng sinh ra đã có sẵn tài liệu như trong editor; `type` là đường đi cho checkout, product, category, post, course |
-| `sb_publish` | Biên dịch bản nháp thành trang live (lan sang global dùng chung), báo bản nào đã lên live, và với `verify` kiểm origin đã phục vụ đúng bản đó chưa |
+| `sb_publish` | Biên dịch bản nháp thành trang live (lan sang global dùng chung), báo bản nào đã lên live, và với `verify` kiểm origin đã phục vụ đúng bản đó chưa; liệt kê các trang khác còn nháp chưa publish (`publish_drafts` publish luôn) |
 | `sb_page_state` | Ba bản sao của một trang, bản nào là bản nào — bản NHÁP canvas editor hiển thị, dòng PUBLISHED storefront phục vụ, và bản phiên này giữ — kèm dự báo editor có render canvas TRẮNG không, và các điểm phục hồi nằm ở đâu |
+| `sb_page_repair` | Đổi gốc trang khác `ROOT` (do seed cũ để lại) về `ROOT` để mọi bản editor vẽ được — một trang hoặc cả site |
 | `sb_review` | Mọi khiếm khuyết người xem sẽ thấy, kèm lệnh sửa từng cái, và năm khoảng trống chắn giữa cửa hàng với một đơn đã thanh toán |
 | `sb_media_list` | Thư viện ảnh của site |
 | `sb_media_upload` | Thêm ảnh và lấy URL — file trên máy, một URL để nền tảng tự tải, hoặc TÌM ảnh chụp thật để đọc mô tả rồi chọn, một hoặc nhiều tấm một lượt |
@@ -106,12 +107,12 @@ nhét ngược lại vào mọi bản cài.
 | `sb_bind` | Gắn nội dung một node vào dữ liệu cửa hàng thật, hoặc biến một nút thành nút thêm vào giỏ |
 | `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 |
-| `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), `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ở) `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_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ó), `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, **560 operation API** (193 trong 251 lệnh ghi có hình dạng body đọc thẳng
-từ handler), 113 element, 79 nguồn binding. `sb_api_find` là
+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à
 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,8 +1,8 @@
 export const SWAGGER_SOURCE = {
-    "operations": 560,
-    "definitions": 107,
-    "bodyCarrying": 210,
-    "bodyUndescribed": 91,
+    "operations": 568,
+    "definitions": 108,
+    "bodyCarrying": 214,
+    "bodyUndescribed": 92,
     "generatedFrom": "server/docs/swagger.json"
 };
 export const API_OPERATIONS = [
@@ -505,6 +505,19 @@ export const API_OPERATIONS = [
         "bodyRef": null,
         "credential": "siteScoped"
     },
+    {
+        "id": "get:/_wb/account/vouchers",
+        "method": "GET",
+        "path": "/_wb/account/vouchers",
+        "tags": [
+            "storeaccount"
+        ],
+        "summary": "The signed-in shopper's voucher wallet",
+        "params": [],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
     {
         "id": "get:/_wb/account/wishlist",
         "method": "GET",
@@ -663,9 +676,16 @@ export const API_OPERATIONS = [
             {
                 "name": "courseId",
                 "in": "query",
-                "required": true,
+                "required": false,
                 "type": "string",
                 "description": "The course id"
+            },
+            {
+                "name": "slug",
+                "in": "query",
+                "required": false,
+                "type": "string",
+                "description": "The course slug, when no id is known"
             }
         ],
         "bodyDescribed": false,
@@ -1146,6 +1166,19 @@ export const API_OPERATIONS = [
         "bodyRef": null,
         "credential": "siteScoped"
     },
+    {
+        "id": "get:/_wb/vouchers/list",
+        "method": "GET",
+        "path": "/_wb/vouchers/list",
+        "tags": [
+            "storevouchers"
+        ],
+        "summary": "List the site's publicly-listed vouchers",
+        "params": [],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
     {
         "id": "get:/api/admin/accounts/{id}/ai-credits",
         "method": "GET",
@@ -1438,7 +1471,7 @@ export const API_OPERATIONS = [
                 "in": "body",
                 "required": false,
                 "type": "object",
-                "description": "{bankName,bankCode,accountNumber,accountHolder,codePrefix,webhookSecret} — PUT only"
+                "description": "{bankName,bankCode,accountNumber,accountHolder,webhookSecret} — PUT only"
             }
         ],
         "bodyDescribed": false,
@@ -1459,7 +1492,7 @@ export const API_OPERATIONS = [
                 "in": "body",
                 "required": false,
                 "type": "object",
-                "description": "{bankName,bankCode,accountNumber,accountHolder,codePrefix,webhookSecret} — PUT only"
+                "description": "{bankName,bankCode,accountNumber,accountHolder,webhookSecret} — PUT only"
             }
         ],
         "bodyDescribed": false,
@@ -2552,6 +2585,55 @@ export const API_OPERATIONS = [
         "bodyRef": null,
         "credential": "siteScoped"
     },
+    {
+        "id": "get:/api/orgs/{id}/ai-credits",
+        "method": "GET",
+        "path": "/api/orgs/{id}/ai-credits",
+        "tags": [
+            "ai"
+        ],
+        "summary": "An organisation's AI credit balance",
+        "params": [
+            {
+                "name": "id",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "org id"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
+    {
+        "id": "post:/api/orgs/{id}/ai-credits/purchase",
+        "method": "POST",
+        "path": "/api/orgs/{id}/ai-credits/purchase",
+        "tags": [
+            "ai"
+        ],
+        "summary": "Buy AI credits for an organisation",
+        "params": [
+            {
+                "name": "id",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "org id"
+            },
+            {
+                "name": "body",
+                "in": "body",
+                "required": true,
+                "type": "object",
+                "description": "{credits:N}"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
     {
         "id": "get:/api/orgs/{id}/invitations",
         "method": "GET",
@@ -7203,6 +7285,111 @@ export const API_OPERATIONS = [
         "bodyRef": "github_com_webbuilder_server_internal_discounts.Discount",
         "credential": "siteScoped"
     },
+    {
+        "id": "get:/api/sites/{siteId}/discounts/{id}/grants",
+        "method": "GET",
+        "path": "/api/sites/{siteId}/discounts/{id}/grants",
+        "tags": [
+            "discounts"
+        ],
+        "summary": "List, assign or revoke a discount's member grants",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Discount ID"
+            },
+            {
+                "name": "grant",
+                "in": "body",
+                "required": false,
+                "type": "object",
+                "description": "{customerId} (POST only)"
+            }
+        ],
+        "bodyDescribed": true,
+        "bodyRef": "internal_discounts_rest.grantRequest",
+        "credential": "siteScoped"
+    },
+    {
+        "id": "post:/api/sites/{siteId}/discounts/{id}/grants",
+        "method": "POST",
+        "path": "/api/sites/{siteId}/discounts/{id}/grants",
+        "tags": [
+            "discounts"
+        ],
+        "summary": "List, assign or revoke a discount's member grants",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Discount ID"
+            },
+            {
+                "name": "grant",
+                "in": "body",
+                "required": false,
+                "type": "object",
+                "description": "{customerId} (POST only)"
+            }
+        ],
+        "bodyDescribed": true,
+        "bodyRef": "internal_discounts_rest.grantRequest",
+        "credential": "siteScoped"
+    },
+    {
+        "id": "delete:/api/sites/{siteId}/discounts/{id}/grants/{grantId}",
+        "method": "DELETE",
+        "path": "/api/sites/{siteId}/discounts/{id}/grants/{grantId}",
+        "tags": [
+            "discounts"
+        ],
+        "summary": "List, assign or revoke a discount's member grants",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "id",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Discount ID"
+            },
+            {
+                "name": "grant",
+                "in": "body",
+                "required": false,
+                "type": "object",
+                "description": "{customerId} (POST only)"
+            }
+        ],
+        "bodyDescribed": true,
+        "bodyRef": "internal_discounts_rest.grantRequest",
+        "credential": "siteScoped"
+    },
     {
         "id": "get:/api/sites/{siteId}/domains",
         "method": "GET",
@@ -12441,6 +12628,34 @@ export const API_OPERATIONS = [
         "bodyRef": "github_com_webbuilder_server_internal_products.Product",
         "credential": "siteScoped"
     },
+    {
+        "id": "get:/api/sites/{siteId}/products/attributes",
+        "method": "GET",
+        "path": "/api/sites/{siteId}/products/attributes",
+        "tags": [
+            "products"
+        ],
+        "summary": "Attribute axes already used on this site",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "limit",
+                "in": "query",
+                "required": false,
+                "type": "integer",
+                "description": "Max axes to return (clamped to products.MaxAttributeSuggestions)"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
     {
         "id": "get:/api/sites/{siteId}/products/export",
         "method": "GET",
@@ -16281,7 +16496,7 @@ export const API_OPERATIONS = [
                 "in": "query",
                 "required": false,
                 "type": "string",
-                "description": "Filter by page type (page|product|category|blog|post|error|maintain|search|checkout|complete)"
+                "description": "Filter by page type (page|product|category|blog|post|error|maintain|search|checkout|complete|account|course|about|contact|policy|faq|login|register|forgot|reset)"
             },
             {
                 "name": "status",
@@ -16351,7 +16566,7 @@ export const API_OPERATIONS = [
                 "in": "query",
                 "required": false,
                 "type": "string",
-                "description": "Filter by page type (page|product|category|blog|post|error|maintain|search|checkout|complete)"
+                "description": "Filter by page type (page|product|category|blog|post|error|maintain|search|checkout|complete|account|course|about|contact|policy|faq|login|register|forgot|reset)"
             },
             {
                 "name": "status",
@@ -17308,6 +17523,10 @@ export const API_DEFINITIONS = {
             "id": {
                 "type": "string"
             },
+            "memberBound": {
+                "description": "MemberBound marks this discount as OWNED: it is redeemable only by a\ncustomer who holds a DiscountGrant for it (see grant.go), and the\nownership check lives in orders.Checkout.resolveDiscount — the one\nfunction both the quote and the order-create path call.\n\nOFF by construction exactly as PublicListed is: Go's zero value is\nfalse and the Postgres column defaults false, so a discount is a\nbearer code until somebody says otherwise. The opposite default would\nretroactively lock every shopper out of every code that works today.\n\nIT IS AN EXPLICIT FLAG RATHER THAN \"this discount has at least one\ngrant\", and that is the whole design (contract D3): deriving boundness\nwould mean that adding the FIRST grant to an ordinary shared code\nsilently made that code refuse for every other shopper on the site —\n\"save this one for Anna\" breaking SUMMER20 for everyone, with nothing\non screen and nothing in a log. With the flag, a grant on an UNBOUND\ncode is a bookmark that changes spendability for nobody, and a grant\non a BOUND code is an entitlement. Two facts, two words.\n\nNormalize keeps two invariants true for every write path: an automatic\ndiscount is never member-bound, and a member-bound discount is never\nPublicListed. See Normalize's clauses for why each one is there.",
+                "type": "boolean"
+            },
             "method": {
                 "description": "Method decides how the discount is applied: \"code\" (customer enters a code)\nor \"automatic\" (applied at checkout with no code). Automatic discounts may\nhave a blank Code.",
                 "type": "string"
@@ -17315,6 +17534,10 @@ export const API_DEFINITIONS = {
             "minOrderCents": {
                 "type": "integer"
             },
+            "publicListed": {
+                "description": "PublicListed is the merchant's explicit opt-in to publish this code on the\nanonymous storefront list (GET /_wb/vouchers/list, package\ninternal/discounts/public). OFF by construction, not by care: the zero\nvalue is false and the Postgres column defaults false, so a discount is\nprivate until a merchant ticks the box — never the other way round on a\nfeature that publishes a working code to anyone who opens the shop.\n\nNormalize forces this back to false whenever UsageLimit == 1: a\nsingle-use code on a public list is a race by construction (the first\nanonymous reader spends it and every later reader gets a refusal), and\nit is also the exact shape of a loyalty-minted bearer voucher\n(loyaltyminter.MintFixedCode sets UsageLimit: 1 because \"the code ...\nmust die on first use\"). See Normalize's comment for why the rule keys\non UsageLimit rather than the minted code's \"DIEM-\" prefix.",
+                "type": "boolean"
+            },
             "siteId": {
                 "type": "string"
             },
@@ -18952,6 +19175,14 @@ export const API_DEFINITIONS = {
             }
         }
     },
+    "internal_discounts_rest.grantRequest": {
+        "type": "object",
+        "properties": {
+            "customerId": {
+                "type": "string"
+            }
+        }
+    },
     "internal_giftcards_rest.adjustRequest": {
         "type": "object",
         "properties": {