sbuilder-mcp 0.91.0 → 0.93.0

package/CHANGELOG.md

@@ -6,6 +6,31 @@ 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.93.0] - 2026-10-26
+
+### Added
+- `sb_bind` accepts `record.agg.<key>` and `record.money.agg.<key>`, and a text-dataset tile with `recordField: "agg.<key>"` derives its binding the way the platform does.
+- `sb_review` reports `record_aggregate_invalid` for `recordAggregates` that are malformed, which would publish an empty list, or that use `whenNone: "hide"` without an empty state.
+- `sb_review` reports `estimate_invalid` for a form-estimate that does not have exactly one record term, or whose term or rule points at a node of the wrong type.
+- The element catalog gains `form-estimate` and the base-only `recordAggregates` key.
+
+### Changed
+- `sb_review` accepts `agg.<key>` and `param.<name>` axes in `record_filter_invalid` when the target list defines them, rejects a param with more than one value, and accepts sort values of `agg.<key>_asc|desc`.
+- `sb_review` reports `record_field_unset` for a tile bound to `agg.<key>` that its list does not define.
+- The API catalog is synced with web_builder v1.0.173 and now covers 124 elements and 95 binding sources.
+
+## [0.92.0] - 2026-10-26
+
+### Added
+- `sb_bind` accepts `record.url` and, on a page of type `record`, reads the collection linked through page-links so `record.*` bindings work outside any list, refusing `record.url` while the collection has no detail page.
+- `sb_review` reports `record_option_invalid` for form-select, radio and checkbox controls with `optionSource: "record"` that lack a collection, use a label that is not an ID field, or have a parent that is not a record-sourced form-select.
+- Form controls accept `optionSource: "record"` to take their options from a collection, and form-select supports `specials.urlParam` prefill such as `?hotel=rec_…&room=rec_…`.
+
+### Changed
+- `sb_review` no longer reports `no_data_context` or `record_relation_orphan` for nodes outside a list on a record page.
+- `sb_set` no longer writes `optionSource`, `recordLabelField`, `recordParentField` or `recordParentNode` per breakpoint, because they are now base-only config keys.
+- The API catalog is synced with web_builder v1.0.172 and gains the `record` page type, served at `/records/<id>`.
+
 ## [0.91.0] - 2026-10-23
 
 ### Added

package/CHANGELOG.vi.md

@@ -6,6 +6,31 @@ 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.93.0] - 2026-10-26
+
+### Added
+- `sb_bind` nhận `record.agg.<key>` và `record.money.agg.<key>`, và tile text-dataset có `recordField: "agg.<key>"` suy ra binding giống nền tảng.
+- `sb_review` báo `record_aggregate_invalid` cho `recordAggregates` sai định dạng (làm danh sách publish rỗng) hoặc dùng `whenNone: "hide"` mà thiếu trạng thái rỗng.
+- `sb_review` báo `estimate_invalid` khi form-estimate không có đúng một term record, hoặc term/rule trỏ vào node sai loại.
+- Catalog element thêm `form-estimate` và khoá base-only `recordAggregates`.
+
+### Changed
+- `sb_review` chấp nhận axis `agg.<key>` và `param.<name>` trong `record_filter_invalid` khi danh sách đích có định nghĩa, từ chối param có nhiều hơn một giá trị, và chấp nhận giá trị sort `agg.<key>_asc|desc`.
+- `sb_review` báo `record_field_unset` cho tile bind `agg.<key>` mà danh sách của nó không định nghĩa.
+- Catalog API được đồng bộ với web_builder v1.0.173 và nay gồm 124 element và 95 nguồn binding.
+
+## [0.92.0] - 2026-10-26
+
+### Added
+- `sb_bind` nhận `record.url` và, trên trang loại `record`, đọc collection gắn qua page-links để bind `record.*` ngoài mọi danh sách, đồng thời từ chối `record.url` khi collection chưa có trang chi tiết.
+- `sb_review` báo `record_option_invalid` cho control form-select, radio và checkbox có `optionSource: "record"` thiếu collection, dùng nhãn không phải ID field, hoặc có cha không phải form-select lấy từ record.
+- Các control form nhận `optionSource: "record"` để lấy option từ collection, và form-select hỗ trợ điền sẵn qua `specials.urlParam` như `?hotel=rec_…&room=rec_…`.
+
+### Changed
+- `sb_review` không còn báo `no_data_context` hay `record_relation_orphan` cho node nằm ngoài danh sách trên trang record.
+- `sb_set` không còn ghi `optionSource`, `recordLabelField`, `recordParentField` hay `recordParentNode` theo breakpoint, vì chúng nay là khoá config base-only.
+- Catalog API được đồng bộ với web_builder v1.0.172 và thêm loại trang `record`, phục vụ tại `/records/<id>`.
+
 ## [0.91.0] - 2026-10-23
 
 ### Added

package/README.md

@@ -119,7 +119,7 @@ in this client: one would put the very key the platform exists to hold back into
 | `sb_undo` | Undo / redo this session's writes — page and form edits and `sb_api_call` PUTs; a page is refused if someone else saved it since. The platform's versions and history (`sb_page_version`) outlive this process |
 
 Twenty-eight tools, **919 API operations** (344 of the 429 writes carrying a body shape read
-off the handler), 123 elements, 94 binding sources. `sb_api_find`
+off the handler), 124 elements, 95 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

@@ -116,7 +116,7 @@ nhét ngược lại vào mọi bản cài.
 | `sb_undo` | Hoàn tác / làm lại các thao tác ghi trong phiên — chỉnh sửa trang, form và PUT qua `sb_api_call`; trang bị từ chối nếu người khác đã lưu sau đó. Version và history của nền tảng (`sb_page_version`) sống lâu hơn process này |
 
 Hai mươi tám tool, **919 operation API** (344 trong 429 lệnh ghi có hình dạng body đọc thẳng
-từ handler), 123 element, 94 nguồn binding. `sb_api_find` là
+từ handler), 124 element, 95 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/appscaffolds.generated.js

@@ -376,6 +376,7 @@ export const APP_SCAFFOLDS = {
                             "recordFilterField": "",
                             "recordFilterValue": "",
                             "recordRelationField": "",
+                            "recordAggregates": [],
                             "itemsPerRow": 4,
                             "collectionType": "all_products",
                             "collectionId": "all_products",

package/dist/catalog/checkout.generated.js

@@ -361,7 +361,11 @@ export const CHECKOUT_FORM_DOCUMENT = {
                 "width": "100%"
             },
             "config": {
-                "optionSource": "manual"
+                "optionSource": "manual",
+                "recordCollectionId": "",
+                "recordLabelField": "",
+                "recordParentField": "",
+                "recordParentNode": ""
             },
             "specials": {
                 "name": "shipping_method",
@@ -372,7 +376,8 @@ export const CHECKOUT_FORM_DOCUMENT = {
                 "mapTo": "order.shippingMethod",
                 "options": [],
                 "defaultValue": "",
-                "placeholder": "Chọn phương thức vận chuyển"
+                "placeholder": "Chọn phương thức vận chuyển",
+                "urlParam": ""
             },
             "responsive": {},
             "events": [],
@@ -466,7 +471,9 @@ export const CHECKOUT_FORM_DOCUMENT = {
             },
             "config": {
                 "columns": 1,
-                "optionSource": "manual"
+                "optionSource": "manual",
+                "recordCollectionId": "",
+                "recordLabelField": ""
             },
             "specials": {
                 "name": "xuat_hoa_don_vat",
@@ -2271,7 +2278,11 @@ export const FORM_TEMPLATES = {
                         "width": "100%"
                     },
                     "config": {
-                        "optionSource": "manual"
+                        "optionSource": "manual",
+                        "recordCollectionId": "",
+                        "recordLabelField": "",
+                        "recordParentField": "",
+                        "recordParentNode": ""
                     },
                     "specials": {
                         "name": "shipping_method",
@@ -2282,7 +2293,8 @@ export const FORM_TEMPLATES = {
                         "mapTo": "order.shippingMethod",
                         "options": [],
                         "defaultValue": "",
-                        "placeholder": "Chọn phương thức vận chuyển"
+                        "placeholder": "Chọn phương thức vận chuyển",
+                        "urlParam": ""
                     },
                     "responsive": {},
                     "events": [],
@@ -2376,7 +2388,9 @@ export const FORM_TEMPLATES = {
                     },
                     "config": {
                         "columns": 1,
-                        "optionSource": "manual"
+                        "optionSource": "manual",
+                        "recordCollectionId": "",
+                        "recordLabelField": ""
                     },
                     "specials": {
                         "name": "xuat_hoa_don_vat",
@@ -4199,7 +4213,11 @@ export const FORM_TEMPLATES = {
                         "width": "100%"
                     },
                     "config": {
-                        "optionSource": "manual"
+                        "optionSource": "manual",
+                        "recordCollectionId": "",
+                        "recordLabelField": "",
+                        "recordParentField": "",
+                        "recordParentNode": ""
                     },
                     "specials": {
                         "name": "loai_phong",
@@ -4214,7 +4232,8 @@ export const FORM_TEMPLATES = {
                             "Phòng gia đình"
                         ],
                         "defaultValue": "",
-                        "placeholder": "Chọn loại phòng"
+                        "placeholder": "Chọn loại phòng",
+                        "urlParam": ""
                     },
                     "responsive": {},
                     "events": [],
@@ -4422,7 +4441,9 @@ export const FORM_TEMPLATES = {
                     },
                     "config": {
                         "columns": 1,
-                        "optionSource": "manual"
+                        "optionSource": "manual",
+                        "recordCollectionId": "",
+                        "recordLabelField": ""
                     },
                     "specials": {
                         "name": "muc_do_hai_long",

package/dist/catalog/deadkeys.generated.js

@@ -1,7 +1,7 @@
 export const DEAD_KEY_SOURCE = {
-    "files": 5944,
-    "identifiers": 109564,
-    "seededKeys": 454,
+    "files": 5992,
+    "identifiers": 110190,
+    "seededKeys": 460,
     "dead": 0
 };
 /**

package/dist/catalog/elements.generated.js

@@ -1,5 +1,5 @@
 export const ELEMENT_SOURCE = {
-    "count": 123,
+    "count": 124,
     "docSchemaVersion": 2
 };
 export const ELEMENTS = {
@@ -8304,13 +8304,18 @@ export const ELEMENTS = {
                     "Tùy chọn 3"
                 ],
                 "defaultValue": "",
-                "placeholder": "Chọn một mục"
+                "placeholder": "Chọn một mục",
+                "urlParam": ""
             },
             "style": {
                 "width": "100%"
             },
             "config": {
-                "optionSource": "manual"
+                "optionSource": "manual",
+                "recordCollectionId": "",
+                "recordLabelField": "",
+                "recordParentField": "",
+                "recordParentNode": ""
             }
         },
         "inspector": [
@@ -8476,7 +8481,9 @@ export const ELEMENTS = {
             },
             "config": {
                 "columns": 1,
-                "optionSource": "manual"
+                "optionSource": "manual",
+                "recordCollectionId": "",
+                "recordLabelField": ""
             },
             "style": {
                 "width": "100%"
@@ -8967,7 +8974,9 @@ export const ELEMENTS = {
             },
             "config": {
                 "columns": 1,
-                "optionSource": "manual"
+                "optionSource": "manual",
+                "recordCollectionId": "",
+                "recordLabelField": ""
             },
             "style": {
                 "width": "100%"
@@ -9837,6 +9846,154 @@ export const ELEMENTS = {
             "account"
         ]
     },
+    "form-estimate": {
+        "type": "form-estimate",
+        "label": "Estimate",
+        "category": "form",
+        "isContainer": false,
+        "isRootOnly": false,
+        "locked": false,
+        "hideInLayer": false,
+        "childAllows": [],
+        "defaults": {
+            "specials": {
+                "name": "",
+                "label": "Tạm tính",
+                "placeholder": "Chọn phòng và ngày để xem giá dự kiến.",
+                "description": "Giá dự kiến, chưa phải giá giữ chỗ.",
+                "estimateTerms": [],
+                "estimateRules": []
+            },
+            "style": {
+                "width": "100%",
+                "height": "fit-content",
+                "fontSize": "14px",
+                "lineHeight": "150%",
+                "color": "#171717"
+            }
+        },
+        "inspector": [
+            {
+                "tab": "general",
+                "groups": [
+                    {
+                        "key": "content",
+                        "label": "Content",
+                        "controls": [
+                            "form_estimate_content"
+                        ]
+                    },
+                    {
+                        "key": "estimate",
+                        "label": "Estimate",
+                        "controls": [
+                            "form_estimate_terms"
+                        ]
+                    },
+                    {
+                        "key": "estimate_rules",
+                        "label": "Stay rules",
+                        "controls": [
+                            "form_estimate_rules"
+                        ]
+                    },
+                    {
+                        "key": "typography",
+                        "label": "Typography",
+                        "controls": [
+                            "text_color",
+                            "font_family",
+                            "font_size",
+                            "text_align",
+                            "line_height"
+                        ]
+                    },
+                    {
+                        "key": "size",
+                        "label": "Size",
+                        "controls": [
+                            "width_select",
+                            "height_select",
+                            "size_bounds"
+                        ]
+                    },
+                    {
+                        "key": "id_field",
+                        "label": "ID field",
+                        "controls": [
+                            "field_name"
+                        ]
+                    }
+                ]
+            },
+            {
+                "tab": "advanced",
+                "groups": [
+                    {
+                        "key": "spacing",
+                        "label": "Spacing",
+                        "controls": [
+                            "padding_margin"
+                        ]
+                    },
+                    {
+                        "key": "display",
+                        "label": "Display",
+                        "controls": [
+                            "display"
+                        ]
+                    },
+                    {
+                        "key": "class_css",
+                        "label": "Class",
+                        "controls": [
+                            "class_css"
+                        ]
+                    }
+                ]
+            }
+        ],
+        "controls": [
+            "form_estimate_content",
+            "form_estimate_terms",
+            "form_estimate_rules",
+            "text_color",
+            "font_family",
+            "font_size",
+            "text_align",
+            "line_height",
+            "width_select",
+            "height_select",
+            "size_bounds",
+            "field_name",
+            "padding_margin",
+            "display",
+            "class_css"
+        ],
+        "description": "A live booking summary inside a form: the price of the record chosen in a data-record select, multiplied by the nights between two date fields and by a number field (\"3.330.000 ₫ × 2 đêm × 2 phòng = 13.320.000 ₫\"), plus the stay rules that go with it — check-in not in the past, check-out after check-in, a maximum number of nights, and guests within the chosen room's capacity. The server recomputes the total from the published record on submit and stores it as an estimate.",
+        "useWhen": [
+            "A booking or quote request whose price is a record (a room type, a tour, a rental) times nights and/or a quantity.",
+            "The visitor should see what their choice costs before sending, and the stay dates need checking."
+        ],
+        "avoidWhen": [
+            "The form sells cart products — the order form and its bill already price those.",
+            "The price is not stored on a data record; there is nothing authoritative for the server to recompute from."
+        ],
+        "contentTips": [
+            "Point the price at a number column holding WHOLE currency units (1850000, not cents).",
+            "Set the guests and rooms fields to whole numbers with a range, and add a capacity rule so 3 guests cannot book 1 room for 2.",
+            "Keep the note: an estimate is not a held price."
+        ],
+        "semantics": [
+            "form",
+            "booking",
+            "estimate",
+            "total",
+            "price",
+            "summary",
+            "nights"
+        ]
+    },
     "form-segment": {
         "type": "form-segment",
         "label": "Segment",
@@ -42909,6 +43066,7 @@ export const ELEMENTS = {
                 "recordFilterField": "",
                 "recordFilterValue": "",
                 "recordRelationField": "",
+                "recordAggregates": [],
                 "itemsPerRow": 4,
                 "collectionType": "all_products",
                 "collectionId": "all_products",
@@ -44016,6 +44174,7 @@ export const ELEMENTS = {
                             "recordFilterField",
                             "recordFilterValue",
                             "recordRelationField",
+                            "recordAggregates",
                             "itemsPerRow",
                             "listNavIcon",
                             "listNavPosition",
@@ -44058,6 +44217,7 @@ export const ELEMENTS = {
                             "recordFilterField",
                             "recordFilterValue",
                             "recordRelationField",
+                            "recordAggregates",
                             "itemsPerRow",
                             "listNavIcon",
                             "listNavPosition",
@@ -44108,6 +44268,7 @@ export const ELEMENTS = {
                             "recordFilterField",
                             "recordFilterValue",
                             "recordRelationField",
+                            "recordAggregates",
                             "itemsPerRow",
                             "listNavIcon",
                             "listNavPosition",
@@ -44160,6 +44321,7 @@ export const ELEMENTS = {
                             "recordFilterField",
                             "recordFilterValue",
                             "recordRelationField",
+                            "recordAggregates",
                             "itemsPerRow",
                             "listNavIcon",
                             "listNavPosition",
@@ -44202,6 +44364,7 @@ export const ELEMENTS = {
                             "recordFilterField",
                             "recordFilterValue",
                             "recordRelationField",
+                            "recordAggregates",
                             "itemsPerRow",
                             "listNavIcon",
                             "listNavPosition",
@@ -44390,6 +44553,7 @@ export const ELEMENTS = {
             "recordFilterField",
             "recordFilterValue",
             "recordRelationField",
+            "recordAggregates",
             "itemsPerRow",
             "listNavIcon",
             "listNavPosition",
@@ -44502,6 +44666,7 @@ export const ELEMENTS = {
             "Collection lists: config.collectionListType \"page_collections\" renders THE SUB-COLLECTIONS OF THE COLLECTION THE PAGE IS (the one /collections/{slug} named), so a single collection template draws every collection's browse grid — off a collection template it shows every collection instead; \"all_collections\" renders every collection; \"custom_collections\" renders specials.collectionIds, in that order",
             "config.quantity caps how many records render and, under a loadingMode, is the PAGE SIZE; it is BASE-only — one value for every breakpoint, never per-breakpoint. A Data list (datasetSource \"record\") pages at most 50 records per page. config.itemsPerRow is the row size (grid columns / slide page size) and style.gap is the space between cards — both are per-breakpoint",
             "A Data list (datasetSource \"record\") nested inside another Data list's row can show ONLY the child records pointing at that row: set config.recordRelationField to the field id (fld_<16hex>) of a \"reference\" field in the nested list's own collection (e.g. RoomType.hotel inside a Hotels list). BASE-only. Such a list is never paged (loadingMode is ignored), its card may also bind the enclosing row's fields, and outside a record-list row it shows its empty state, never all records",
+            "A Data list can carry config.recordAggregates (BASE-only, ≤4): [{key, recordCollectionId (child collection), recordRelationField (child reference field → this collection), op \"min\"|\"max\"|\"count\", recordField (child number/integer field, \"\" for count), where: [{recordField, op:\"gte\", param, per?}], whenNone \"hide\"|\"show\"}]. Each row then binds record.agg.<key> / record.money.agg.<key> (e.g. a hotel's cheapest room that fits: min nightly price where capacity × rooms ≥ guests). Visitors send params as f.record.param.<name>=<int>, filter as f.record.agg.<key>=..3000000, sort as s.<node>=agg.<key>_asc. Not availability",
             "config.layout \"grid\" for a multi-row grid, \"slide\" for row-by-row carousel behaviour",
             "Navigation and pagination only matter when layout is \"slide\". The arrows exist while config.listNavIcon names an icon (clearing it turns them off); the dots exist while paginationItemWidth and paginationItemHeight are both above 0",
             "config.loadingMode is how a GRID list offers the REST of its feed once config.quantity rows are on screen: \"none\" (the default — those rows and nothing more), \"pagination\" (a numbered pager, each page its own URL), \"load_more\" (a button that appends the next page in place) or \"scroll_more\" (the same append, triggered by reaching the end). Set it whenever the listing is a real catalogue rather than a fixed shelf of featured rows",
@@ -45571,6 +45736,7 @@ export const BINDING_SOURCES = [
     "site.supportEmail",
     "site.supportPhone",
     "site.tiktok",
+    "site.timezone",
     "site.youtube"
 ];
 export const BOUND_SPECIALS = {
@@ -45762,6 +45928,67 @@ export const RECORD_BINDING_PROBES = [
             }
         ]
     },
+    {
+        "type": "text-dataset",
+        "config": {
+            "datasetSource": "record",
+            "recordField": "agg.startPrice",
+            "recordFieldType": "number"
+        },
+        "bindings": [
+            {
+                "id": "bind-text",
+                "source": "record.agg.startPrice",
+                "field": "specials.boundText",
+                "target": {
+                    "type": "record",
+                    "id": "",
+                    "kind": "title"
+                }
+            }
+        ]
+    },
+    {
+        "type": "text-dataset",
+        "config": {
+            "datasetSource": "record",
+            "recordField": "agg.startPrice",
+            "recordFieldType": "number",
+            "recordFormat": "money"
+        },
+        "bindings": [
+            {
+                "id": "bind-text",
+                "source": "record.money.agg.startPrice",
+                "field": "specials.boundText",
+                "target": {
+                    "type": "record",
+                    "id": "",
+                    "kind": "title"
+                }
+            }
+        ]
+    },
+    {
+        "type": "text-dataset",
+        "config": {
+            "datasetSource": "record",
+            "recordField": "agg.startPrice",
+            "recordFieldType": "richtext"
+        },
+        "bindings": [
+            {
+                "id": "bind-text",
+                "source": "",
+                "field": "specials.boundHtml",
+                "target": {
+                    "type": "record",
+                    "id": "",
+                    "kind": "title"
+                }
+            }
+        ]
+    },
     {
         "type": "text-dataset",
         "config": {
@@ -49348,6 +49575,7 @@ export const ELEMENT_VALUES = {
                 "category",
                 "manual",
                 "product",
+                "record",
                 "tag"
             ],
             "readBy": "OPTION_SOURCES (schema/src/elements/formOptionSource.ts)"
@@ -49363,6 +49591,7 @@ export const ELEMENT_VALUES = {
                 "category",
                 "manual",
                 "product",
+                "record",
                 "tag"
             ],
             "readBy": "OPTION_SOURCES (schema/src/elements/formOptionSource.ts)"
@@ -49389,6 +49618,7 @@ export const ELEMENT_VALUES = {
                 "category",
                 "manual",
                 "product",
+                "record",
                 "tag"
             ],
             "readBy": "OPTION_SOURCES (schema/src/elements/formOptionSource.ts)"
@@ -50186,11 +50416,16 @@ export const BASE_ONLY_CONFIG = [
     "backgroundSceneUrl",
     "backgroundSceneModelUrl",
     "rowLimit",
+    "optionSource",
+    "recordAggregates",
     "recordCollectionId",
     "recordField",
     "recordFieldType",
     "recordFilterField",
     "recordFilterValue",
+    "recordLabelField",
+    "recordParentField",
+    "recordParentNode",
     "recordRelationField",
     "recordSortDesc",
     "recordSortField"

package/dist/catalog/shapes.generated.js

@@ -4,7 +4,7 @@ export const SHAPE_SOURCE = {
     "fromHandlers": 334,
     "fromSwaggerOnly": 10,
     "withReadOnly": 29,
-    "structsRead": 3457
+    "structsRead": 3467
 };
 export const REQUEST_SHAPES = {
     "post:/api/sites/{id}/ai-credits/purchase": {

package/dist/catalog/source.generated.js

@@ -1,7 +1,7 @@
 // GENERATED by scripts/gen-catalog.ts — do not edit by hand.
 // The platform commit every other generated file here describes.
 export const PLATFORM_SOURCE = {
-    "commit": "4a6a6b151a18713d4f6c3235f063b870d314a968",
-    "committedAt": "2026-10-23T14:44:15+07:00",
+    "commit": "e909f77a5b8c33c635657cc906e45b99f6d253d8",
+    "committedAt": "2026-10-26T17:18:35+07:00",
     "dirty": false
 };

package/dist/catalog/storepages.generated.js

@@ -678,6 +678,7 @@ export const PAGE_LAYOUT_SEEDS = {
                     "recordFilterField": "",
                     "recordFilterValue": "",
                     "recordRelationField": "",
+                    "recordAggregates": [],
                     "itemsPerRow": 4,
                     "collectionType": "all_products",
                     "collectionId": "all_products",
@@ -1624,6 +1625,11 @@ export const PAGE_TYPES = [
         "ownSlug": false,
         "routePattern": "/brands/{slug}"
     },
+    {
+        "type": "record",
+        "group": "store",
+        "ownSlug": false
+    },
     {
         "type": "search",
         "group": "main",
@@ -2962,6 +2968,7 @@ export const STORE_PAGE_SEEDS = {
                     "recordFilterField": "",
                     "recordFilterValue": "",
                     "recordRelationField": "",
+                    "recordAggregates": [],
                     "itemsPerRow": 4,
                     "collectionType": "all_products",
                     "collectionId": "all_products",
@@ -3683,6 +3690,7 @@ export const STORE_PAGE_SEEDS = {
                     "recordFilterField": "",
                     "recordFilterValue": "",
                     "recordRelationField": "",
+                    "recordAggregates": [],
                     "itemsPerRow": 4,
                     "collectionType": "all_products",
                     "collectionId": "all_products",
@@ -4413,6 +4421,7 @@ export const STORE_PAGE_SEEDS = {
                     "recordFilterField": "",
                     "recordFilterValue": "",
                     "recordRelationField": "",
+                    "recordAggregates": [],
                     "itemsPerRow": 4,
                     "collectionType": "all_products",
                     "collectionId": "all_products",

package/dist/catalog/translations.generated.js

@@ -1,9 +1,9 @@
 // GENERATED by scripts/gen-catalog.ts — do not edit by hand.
 // Source: <WB_REPO>/schema/src/elements/translatableFields.ts
 export const TRANSLATION_SOURCE = {
-    "elements": 67,
-    "pairs": 187,
-    "neverKeys": 180,
+    "elements": 68,
+    "pairs": 190,
+    "neverKeys": 182,
     "entityTypes": 12
 };
 /** Every entity type a translation record can name, including "node". */
@@ -274,6 +274,11 @@ export const TRANSLATABLE_SPECIALS = {
         "text",
         "linkText"
     ],
+    "form-estimate": [
+        "label",
+        "placeholder",
+        "description"
+    ],
     "form-step-button": [
         "text"
     ],
@@ -407,6 +412,7 @@ export const NEVER_TRANSLATED = [
     "displayType",
     "end",
     "endsAt",
+    "estimateRules",
     "field",
     "fileFormat",
     "fileLimit",
@@ -522,6 +528,7 @@ export const NEVER_TRANSLATED = [
     "showPercent",
     "showPhone",
     "showPlaceholder",
+    "siteTimezone",
     "source",
     "sourceCode",
     "sourceFlashSale",
@@ -1129,6 +1136,17 @@ export const TRANSLATABLE_FIELDS = {
             "key": "linkText"
         }
     ],
+    "form-estimate": [
+        {
+            "key": "label"
+        },
+        {
+            "key": "placeholder"
+        },
+        {
+            "key": "description"
+        }
+    ],
     "form-step-button": [
         {
             "key": "text"

package/dist/domains/site/findings.js

@@ -120,6 +120,17 @@ export const FIX = {
         'datasetSource is "record" — one card template, rows edited as data. Logic the platform has ' +
         'no native control for yet (visitor filters, computed totals) may stay in code, reading ' +
         'GET /_wb/collections/{slug}/records instead of its own copy.',
+    record_option_invalid: 'Point it at a collection and its label column: sb_set id "<id>", namespace config, keys ' +
+        '{ "optionSource": "record", "recordCollectionId": "col_…", "recordLabelField": "fld_…" } (base). A dependent ' +
+        'select adds "recordParentNode": "<parent form-select id>" and "recordParentField": "<reference fld_… of this ' +
+        'collection pointing at the parent\'s>". Values are record ids; prefill with specials.urlParam.',
+    record_aggregate_invalid: 'Fix config.recordAggregates on "<id>" (base): each { key, recordCollectionId (child), recordRelationField ' +
+        '(its reference to this list\'s collection), op min|max|count, recordField (child number/integer; "" for count), ' +
+        'where: [{ recordField, op: "gte", param, per? }], whenNone hide|show } — and keep the list\'s list-empty.',
+    estimate_invalid: 'Point its operands at THIS form\'s nodes: sb_set id "<id>", namespace specials, base, keys { "estimateTerms": ' +
+        '[{kind:"record", node:<record form-select>, field:<fld_ price>}, {kind:"nights", start:<date>, end:<date>, unit:"đêm"}, ' +
+        '{kind:"number", node:<form-number>, unit:"phòng"}], "estimateRules": [{kind:"dateRange", start, end, notPast:true}, ' +
+        '{kind:"maxNights", start, end, max:30}, {kind:"capacity", node, field:<fld_ capacity>, per:<rooms>, count:<guests>}] }.',
     record_filter_invalid: 'Aim it at ONE collection\'s record list(s) and a field: sb_set id "<id>", namespace specials, keys ' +
         '{ "filterSource": "record", "filterAxis": "fld_…", "filterTargets": ["<list id>"], "filterBehavior": "filter" } — ' +
         'axis types text/select/reference/url/date/boolean/integer/number. A sort select takes filterValues ' +

package/dist/domains/site/record.js

@@ -12,9 +12,64 @@ export const RECORD_FIELD_ID = /^fld_[0-9a-f]{16}$/;
 /**
  * A `record.*` source a context can supply: `record.<fid>`, `record.html.<fid>`,
  * `record.money.<fid>` (a number/integer field formatted in the site's currency),
- * or `record.id` — the row's own record id (recordContext.ts).
+ * `record.id` — the row's own record id — or `record.url` — `/records/<id>`, emitted
+ * only when the row's collection has a published record detail page (recordContext.ts).
  */
-export const RECORD_SOURCE = /^record\.(?:id|(?:html\.|money\.)?fld_[0-9a-f]{16})$/;
+export const RECORD_SOURCE = /^record\.(?:id|url|(?:html\.|money\.)?fld_[0-9a-f]{16}|(?:money\.)?agg\.[a-z][a-zA-Z0-9_]{0,31})$/;
+/** An aggregate key — recordAggregates.ts RECORD_AGG_KEY. A tile names it as `agg.<key>`. */
+export const RECORD_AGG_KEY = /^[a-z][a-zA-Z0-9_]{0,31}$/;
+const RECORD_PARAM_NAME = /^[a-z][a-z0-9_]{0,23}$/;
+const COLLECTION_ID = /^col_[0-9a-f]{16}$/;
+export const recordAggKeyOf = (axis) => {
+    const key = axis.startsWith('agg.') ? axis.slice(4) : '';
+    return RECORD_AGG_KEY.test(key) ? key : '';
+};
+/**
+ * `config.recordAggregates` read the way the platform does
+ * (recordAggregates.ts readRecordAggregates): [] for none, null when MALFORMED —
+ * the server then refuses the list and it publishes EMPTY.
+ */
+export function readRecordAggregates(raw) {
+    if (raw === undefined || raw === null)
+        return [];
+    if (!Array.isArray(raw) || raw.length > 4)
+        return null;
+    const s = (v) => (typeof v === 'string' ? v : '');
+    const seen = new Set();
+    const out = [];
+    for (const a of raw) {
+        if (!a || typeof a !== 'object')
+            return null;
+        const op = s(a.op);
+        const field = s(a.recordField);
+        const whenNone = a.whenNone == null || a.whenNone === '' ? 'hide' : s(a.whenNone);
+        if (!RECORD_AGG_KEY.test(s(a.key)) ||
+            seen.has(s(a.key)) ||
+            !['min', 'max', 'count'].includes(op) ||
+            !COLLECTION_ID.test(s(a.recordCollectionId)) ||
+            !RECORD_FIELD_ID.test(s(a.recordRelationField)) ||
+            (op === 'count' ? field !== '' : !RECORD_FIELD_ID.test(field)) ||
+            !['hide', 'show'].includes(whenNone)) {
+            return null;
+        }
+        const where = a.where ?? [];
+        if (!Array.isArray(where) || where.length > 4)
+            return null;
+        const conds = [];
+        for (const c of where) {
+            const per = s(c?.per);
+            if (!c || !RECORD_FIELD_ID.test(s(c.recordField)) || c.op !== 'gte' || !RECORD_PARAM_NAME.test(s(c.param)) || (per !== '' && !RECORD_PARAM_NAME.test(per))) {
+                return null;
+            }
+            conds.push({ param: s(c.param), ...(per ? { per } : {}) });
+        }
+        seen.add(s(a.key));
+        out.push({ key: s(a.key), op, where: conds, whenNone });
+    }
+    return out;
+}
+/** The visitor params a list's aggregates read (`param.<name>` axes it accepts). */
+export const recordAggregateParams = (aggs) => new Set(aggs.flatMap((a) => a.where.flatMap((c) => (c.per ? [c.param, c.per] : [c.param]))));
 /** The field types `record.money.<fid>` formats — recordContext.ts RECORD_MONEY_FIELD_TYPES. */
 export const RECORD_MONEY_TYPES = new Set(['number', 'integer']);
 /** The only record source `specials.boundHtml` admits — schema/src/rawSinkBindings.ts:102. */
@@ -34,8 +89,9 @@ export function recordTileBindings(type, config, rows) {
     if (!RECORD_TILES.has(type))
         return rows;
     const fid = config.recordField;
-    const ok = typeof fid === 'string' && RECORD_FIELD_ID.test(fid);
     const html = type === 'text-dataset' && config.recordFieldType === 'richtext';
+    // An aggregate (`agg.<key>`) is a number on the row — datasetBindings.ts recordSource.
+    const ok = typeof fid === 'string' && (RECORD_FIELD_ID.test(fid) || (!html && recordAggKeyOf(fid) !== ''));
     // datasetBindings.ts isRecordMoney: a stale recordFormat on any other type is ignored.
     const money = type === 'text-dataset' && config.recordFormat === 'money' && RECORD_MONEY_TYPES.has(String(config.recordFieldType));
     return rows.map((row) => {
@@ -85,9 +141,12 @@ export function recordScope(nodeAt, id) {
  */
 export function recordFieldProblem(source, scope) {
     if (!scope.length) {
-        return `"${source}" sits in no record-list row — only a list-dataset with datasetSource "record" (or a relation list inside one) supplies a record, so it would render its placeholder.`;
+        return `"${source}" sits in no record-list row and this is no record detail page — only a list-dataset with datasetSource "record" (or a relation list inside one), or a page of type "record" attached to a collection, supplies a record, so it would render its placeholder.`;
     }
-    if (source === 'record.id')
+    if (source === 'record.id' || source === 'record.url')
+        return undefined;
+    // An aggregate is checked against the list's recordAggregates (sb_review), not a field.
+    if (/^record\.(?:money\.)?agg\./.test(source))
         return undefined;
     const html = source.startsWith('record.html.');
     const money = source.startsWith('record.money.');

package/dist/domains/site/review.js

@@ -7,7 +7,7 @@ import { SEED_COPY_VI, langOf } from './seedcopy.js';
 import { HOVER_STATE, hoverHome } from './hover.js';
 import { ELEMENTS, BINDING_SOURCES, BOUND_SPECIALS, FIRST_CHILD_ONLY, SATELLITE_RULES, ELEMENT_SEEDS } from '../../catalog/elements.generated.js';
 import { fill } from './findings.js';
-import { isRecordSource, RECORD_FIELD_ID, RECORD_HTML_SOURCE, RECORD_SOURCE, RECORD_TILES } from './record.js';
+import { isRecordSource, readRecordAggregates, recordAggKeyOf, recordAggregateParams, RECORD_FIELD_ID, RECORD_HTML_SOURCE, RECORD_SOURCE, RECORD_TILES, } from './record.js';
 import { formFieldFindings } from './formdoc.js';
 import { deadNavigation, liveEventTable, PAYLOAD_NEEDS } from './navhref.js';
 import { unknownValueNote, unknownWriteNote, vocabularyFor, vocabularyForWrite } from './vocabulary.js';
@@ -636,6 +636,9 @@ opts = {}) {
                 const parentCfg = up && d.nodes[up] ? d.nodes[up].config : undefined;
                 const nested = parentCfg?.datasetSource === 'record';
                 const rel = String(cfg.recordRelationField ?? '');
+                // A record detail page (web_builder #160) is the parent of a relation list
+                // placed on it outside any list.
+                const pageParent = opts.pageType === 'record' && !up;
                 if (nested && !rel) {
                     out.push({
                         code: 'record_relation_unset',
@@ -647,7 +650,7 @@ opts = {}) {
                         fix: fill('record_relation_unset', { id }),
                     });
                 }
-                else if (rel && (!nested || !RECORD_FIELD_ID.test(rel))) {
+                else if (rel && ((!nested && !pageParent) || !RECORD_FIELD_ID.test(rel))) {
                     out.push({
                         code: 'record_relation_orphan',
                         nodeId: id,
@@ -670,6 +673,94 @@ opts = {}) {
                     });
                 }
             }
+            // FORM OPTIONS FROM A COLLECTION (web_builder #159, contract §7.2). Every miss renders
+            // a choice field with only its placeholder (no authored fallback), or a room list that
+            // never narrows — and the server refuses any other answer as not_an_option.
+            if (['form-select', 'form-radio', 'form-checkbox'].includes(type) && String(cfg.optionSource ?? '').trim() === 'record') {
+                const why = [];
+                if (!String(cfg.recordCollectionId ?? '').trim())
+                    why.push('config.recordCollectionId names no collection');
+                if (!RECORD_FIELD_ID.test(String(cfg.recordLabelField ?? '')))
+                    why.push('config.recordLabelField is not a field ID');
+                const pNode = String(cfg.recordParentNode ?? '');
+                const pField = String(cfg.recordParentField ?? '');
+                if (pNode || pField) {
+                    const pc = d.nodes[pNode]?.config;
+                    if (type !== 'form-select')
+                        why.push('only a form-select narrows by a parent field');
+                    else if (!pNode || !pField)
+                        why.push('recordParentNode and recordParentField go together');
+                    else if (d.nodes[pNode]?.data.type !== 'form-select' || String(pc?.optionSource ?? '').trim() !== 'record')
+                        why.push(`recordParentNode "${pNode}" is not a record-sourced form-select`);
+                    else if (!RECORD_FIELD_ID.test(pField))
+                        why.push(`recordParentField "${pField}" is not a field ID`);
+                }
+                if (why.length) {
+                    out.push({
+                        code: 'record_option_invalid',
+                        nodeId: id,
+                        type,
+                        problem: `A choice field listing records that shows no options or never narrows: ${why.join('; ')}.`,
+                        fix: fill('record_option_invalid', { id }),
+                    });
+                }
+            }
+            // AGGREGATES OVER A RELATION (web_builder #162, contract §7.5). A malformed
+            // definition makes the server refuse the WHOLE list — it publishes empty; a
+            // "hide" aggregate drops every row nothing fits, so the list needs its empty state.
+            if (type === 'list-dataset' && cfg.datasetSource === 'record' && cfg.recordAggregates !== undefined) {
+                const aggs = readRecordAggregates(cfg.recordAggregates);
+                const empty = d.nodes[String(cfg.emptyStateId ?? '')]?.data.type === 'list-empty';
+                if (aggs === null || (aggs.some((a) => a.whenNone === 'hide') && !empty)) {
+                    out.push({
+                        code: 'record_aggregate_invalid',
+                        nodeId: id,
+                        type,
+                        problem: aggs === null
+                            ? 'config.recordAggregates is malformed (a bad key, op, id, condition or more than 4) — the server refuses the list and it publishes EMPTY.'
+                            : 'An aggregate with whenNone "hide" drops every row nothing fits, and this list has no empty state — a visitor whose search fits nothing sees a blank band.',
+                        fix: fill('record_aggregate_invalid', { id }),
+                    });
+                }
+            }
+            // BOOKING ESTIMATE (web_builder #161, contract §7.4): its operands are NODE IDS of
+            // this form document. A wrong one leaves the line on its placeholder and the
+            // server stores no total — or skips a stay rule — with no error anywhere.
+            if (type === 'form-estimate') {
+                const sp = (n.specials ?? {});
+                const terms = Array.isArray(sp.estimateTerms) ? sp.estimateTerms : [];
+                const rules = Array.isArray(sp.estimateRules) ? sp.estimateRules : [];
+                const why = [];
+                const t = (x) => d.nodes[String(x ?? '')]?.data.type;
+                const cfgSrc = (x) => String((d.nodes[String(x ?? '')]?.config?.optionSource ?? '')).trim();
+                const isRecordSelect = (x) => t(x) === 'form-select' && cfgSrc(x) === 'record';
+                const isDate = (x) => t(x) === 'form-date' || t(x) === 'form-calendar';
+                if (terms.filter((x) => x.kind === 'record').length !== 1)
+                    why.push('it needs exactly ONE "record" term (the chosen room\'s price)');
+                for (const x of terms) {
+                    if (x.kind === 'record' && (!isRecordSelect(x.node) || !RECORD_FIELD_ID.test(String(x.field ?? ''))))
+                        why.push(`record term: node "${String(x.node ?? '')}" must be a record-sourced form-select and field a fld_ id`);
+                    if (x.kind === 'nights' && (!isDate(x.start) || !isDate(x.end)))
+                        why.push('nights term: start and end must be date fields of this form');
+                    if (x.kind === 'number' && t(x.node) !== 'form-number')
+                        why.push(`number term: "${String(x.node ?? '')}" is not a form-number`);
+                }
+                for (const r of rules) {
+                    if ((r.kind === 'dateRange' || r.kind === 'maxNights') && (!isDate(r.start) || !isDate(r.end)))
+                        why.push(`${String(r.kind)} rule: start and end must be date fields of this form`);
+                    if (r.kind === 'capacity' && (!isRecordSelect(r.node) || !RECORD_FIELD_ID.test(String(r.field ?? '')) || t(r.count) !== 'form-number' || (r.per && t(r.per) !== 'form-number')))
+                        why.push('capacity rule: node must be a record select, field a fld_ id, count (and per) form-number fields');
+                }
+                if (why.length) {
+                    out.push({
+                        code: 'estimate_invalid',
+                        nodeId: id,
+                        type,
+                        problem: `A booking estimate that shows no total or skips a stay rule: ${[...new Set(why)].join('; ')}.`,
+                        fix: fill('estimate_invalid', { id }),
+                    });
+                }
+            }
             // RECORD FILTERS (web_builder PR #157, contract §7.1): a filter/sort control aimed at a
             // record list. Every miss below renders a control that empties the list or narrows nothing.
             {
@@ -681,11 +772,23 @@ opts = {}) {
                 });
                 const why = [];
                 if (sp.filterSource === 'record') {
-                    if (!RECORD_FIELD_ID.test(String(sp.filterAxis ?? '')))
-                        why.push(`filterAxis "${String(sp.filterAxis ?? '')}" is not a field ID`);
+                    const cfgOf = (t) => d.nodes[t].config ?? {};
+                    // web_builder #162: an axis may also be an aggregate (`agg.<key>`, a budget) or a
+                    // visitor param (`param.<name>`) — both must exist on EVERY targeted list.
+                    const axis = String(sp.filterAxis ?? '');
+                    const aggsOf = (t) => readRecordAggregates(cfgOf(t).recordAggregates) ?? [];
+                    if (axis.startsWith('agg.') || axis.startsWith('param.')) {
+                        const key = axis.startsWith('agg.') ? recordAggKeyOf(axis) : axis.slice(6);
+                        const has = (t) => axis.startsWith('agg.') ? aggsOf(t).some((a) => a.key === key) : recordAggregateParams(aggsOf(t)).has(key);
+                        if (!key || !recordTargets.length || !recordTargets.every(has))
+                            why.push(`filterAxis "${axis}" names no aggregate or param of its target list's config.recordAggregates`);
+                        if (axis.startsWith('param.') && sp.filterArity !== undefined && sp.filterArity !== 'single')
+                            why.push(`a param axis holds ONE value — filterArity "${String(sp.filterArity)}" lets a visitor tick two and empties the list`);
+                    }
+                    else if (!RECORD_FIELD_ID.test(axis))
+                        why.push(`filterAxis "${axis}" is not a field ID`);
                     if (targets.length && recordTargets.length !== targets.length)
                         why.push('a filterTargets entry is not a record list');
-                    const cfgOf = (t) => d.nodes[t].config ?? {};
                     if (recordTargets.some((t) => String(cfgOf(t).recordRelationField ?? '')))
                         why.push('it targets a relation list');
                     if (new Set(recordTargets.map((t) => String(cfgOf(t).recordCollectionId ?? ''))).size > 1)
@@ -696,9 +799,9 @@ opts = {}) {
                 if (sp.filterSource === 'sort' && recordTargets.length) {
                     const bad = (Array.isArray(sp.filterValues) ? sp.filterValues : [])
                         .map((v) => String(v?.value ?? ''))
-                        .filter((v) => !/^fld_[0-9a-f]{16}_(?:asc|desc)$/.test(v));
+                        .filter((v) => !/^(?:fld_[0-9a-f]{16}|agg\.[a-z][a-zA-Z0-9_]{0,31})_(?:asc|desc)$/.test(v));
                     if (bad.length)
-                        why.push(`sort values ${bad.slice(0, 3).map((v) => `"${v}"`).join(', ')} are not "<fieldId>_asc|desc" — a record list ignores product sort keys`);
+                        why.push(`sort values ${bad.slice(0, 3).map((v) => `"${v}"`).join(', ')} are not "<fieldId>_asc|desc" or "agg.<key>_asc|desc" — a record list ignores product sort keys`);
                 }
                 if (why.length) {
                     out.push({
@@ -712,7 +815,25 @@ opts = {}) {
             }
             if (RECORD_TILES.has(type) && cfg.datasetSource === 'record') {
                 const fid = cfg.recordField;
-                if (typeof fid !== 'string' || !RECORD_FIELD_ID.test(fid)) {
+                const aggKey = typeof fid === 'string' ? recordAggKeyOf(fid) : '';
+                let aggOk = false;
+                if (aggKey) {
+                    let up = n.data.parent;
+                    while (up && d.nodes[up] && d.nodes[up].data.type !== 'list-dataset')
+                        up = d.nodes[up].data.parent;
+                    const lc = up ? d.nodes[up].config : undefined;
+                    aggOk = (readRecordAggregates(lc?.recordAggregates) ?? []).some((a) => a.key === aggKey);
+                }
+                if (aggKey && !aggOk) {
+                    out.push({
+                        code: 'record_field_unset',
+                        nodeId: id,
+                        type,
+                        problem: `config.recordField "${String(fid)}" names an aggregate its record list does not define in config.recordAggregates — it renders its placeholder on every row.`,
+                        fix: fill('record_field_unset', { id }),
+                    });
+                }
+                else if (!aggKey && (typeof fid !== 'string' || !RECORD_FIELD_ID.test(fid))) {
                     out.push({
                         code: 'record_field_unset',
                         nodeId: id,
@@ -730,7 +851,8 @@ opts = {}) {
                 while (list && d.nodes[list] && d.nodes[list].data.type !== 'list-dataset')
                     list = d.nodes[list].data.parent;
                 const lcfg = list && d.nodes[list] ? d.nodes[list].config : undefined;
-                if (lcfg?.datasetSource !== 'record') {
+                // On a record detail page the PAGE supplies the record outside any list.
+                if (lcfg?.datasetSource !== 'record' && !(opts.pageType === 'record' && !list)) {
                     out.push({
                         code: 'no_data_context',
                         nodeId: id,

package/dist/tools/live.js

@@ -745,21 +745,23 @@ export function registerLiveTools(server, ctx, session) {
         // `force` gets past it, recorded under `forced`.
         if (RECORD_SOURCE.test(source)) {
             const scope = recordScope((x) => (d.has(x) ? d.node(x) : undefined), id);
-            // Resolved only when there is something to read: an empty scope is refused below
-            // without a fetch, and must not fail on a missing SB_SITE first.
-            const site = scope.length ? siteFor(ctx, session.page()?.siteId) : '';
+            const open = session.page();
+            const site = siteFor(ctx, open?.siteId);
+            const get = async (path) => request({ base: ctx.base, method: 'GET', path: `/api/sites/${encodeURIComponent(site)}${path}`, token: siteToken(ctx), fetchImpl: ctx.fetchImpl });
             let withFields;
             try {
+                // A RECORD DETAIL PAGE (web_builder #160) supplies its record outside any list:
+                // the collections attached to it are the scope.
+                if (!scope.length && open) {
+                    const links = (await get(`/page-links?pageId=${encodeURIComponent(open.pageId)}&linkType=recordCollection`));
+                    for (const l of links.links ?? [])
+                        if (l.linkId)
+                            scope.push(l.linkId);
+                }
                 withFields = await Promise.all(scope.map(async (cid) => {
                     if (!cid)
                         return { collectionId: '(none set)', fields: [] };
-                    const got = (await request({
-                        base: ctx.base,
-                        method: 'GET',
-                        path: `/api/sites/${encodeURIComponent(site)}/collections/${encodeURIComponent(cid)}/fields`,
-                        token: siteToken(ctx),
-                        fetchImpl: ctx.fetchImpl,
-                    }));
+                    const got = (await get(`/collections/${encodeURIComponent(cid)}/fields`));
                     return { collectionId: cid, fields: got.fields ?? [] };
                 }));
             }
@@ -776,6 +778,26 @@ export function registerLiveTools(server, ctx, session) {
                     if (why)
                         throw new Error(`sbuilder: ${why}`);
                 });
+                // record.url resolves only for a collection with an attached record page.
+                const cid = scope[0];
+                if (source === 'record.url' && cid) {
+                    let attached = true;
+                    try {
+                        await get(`/page-links/recordCollection/${encodeURIComponent(cid)}`);
+                    }
+                    catch (e) {
+                        if (e.status !== 404)
+                            throw e;
+                        attached = false;
+                    }
+                    soft(guard, () => {
+                        if (!attached) {
+                            throw new Error(`sbuilder: collection ${cid} has no record detail page, so record.url is never emitted and the link ` +
+                                'stays a plain button. Create a page of type "record", attach it with PUT ' +
+                                `/api/sites/{siteId}/page-links/recordCollection/${cid} {pageId}, and publish it.`);
+                        }
+                    });
+                }
             }
         }
         const forced = guard.forced.length ? { forced: guard.forced } : {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sbuilder-mcp",
-  "version": "0.91.0",
+  "version": "0.93.0",
   "description": "MCP server that designs and operates a Store Builder site — pages, data, theme and publish — through the platform's own API and live-edit protocol.",
   "mcpName": "io.github.vuluu2k/sbuilder-mcp",
   "type": "module",