@spree/docs 0.1.149 → 0.1.151

package/dist/api-reference/store.yaml

@@ -87,16 +87,16 @@ paths:
           content:
             application/json:
               example:
-                token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjRjN2VkNTM1LTFkMjAtNDQyZS05NWUwLTJkZDdjZDA0NmVjNSIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzg2MDAyNzgzfQ.O5_jPB0rDvMkk20QUn8rnNULTA7OAfIeJqE9f7O2fxE
-                refresh_token: 7tSX6C2f9EEhZPLmGYxBf6d8
+                token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjFmNDgxZjc4LTVkMDAtNDc5Yy05ZTAwLWMwMjMxOTUxNDE4NSIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzg2MTM5MzY5fQ.jKLlQNyWPaA2UgqZj6li3jjM8nRVnrnWNh__KE-9fk4
+                refresh_token: qjAnvpPQjuz7UrwsxJYNGewB
                 user:
                   id: cust_UkLWZg9DAJ
                   email: test@example.com
-                  first_name: Bruce
-                  last_name: Waters
+                  first_name: Tanesha
+                  last_name: Shields
                   phone:
                   accepts_email_marketing: false
-                  full_name: Bruce Waters
+                  full_name: Tanesha Shields
                   available_store_credit_total: '0'
                   display_available_store_credit_total: "$0.00"
                   addresses: []
@@ -194,16 +194,16 @@ paths:
           content:
             application/json:
               example:
-                token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjI2MzhlOGNkLTI0MzMtNGRmMS04YWQ2LTYwZjM3NTE1YjU4MSIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzg2MDAyNzgzfQ.9ytKHVG2ef_TDxL_-BjDlerI2jxMEkhg2QBcosWM1t4
-                refresh_token: v3ThBkwXcfXLostRSTk21mc2
+                token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjQxZTk0YjJlLTFjMjAtNDg2My1hYzhiLTlmYTFkZGVkYTJkYyIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzg2MTM5MzY5fQ.Pq5lymxSNudXHZJfj7XX8vhaHhUEwe1n2qNENJS7lMM
+                refresh_token: AtCKZc6PqsRqykRq7DWkJ3Lg
                 user:
                   id: cust_UkLWZg9DAJ
                   email: test@example.com
-                  first_name: Margie
-                  last_name: Schmidt
+                  first_name: Kirk
+                  last_name: Beer
                   phone:
                   accepts_email_marketing: false
-                  full_name: Margie Schmidt
+                  full_name: Kirk Beer
                   available_store_credit_total: '0'
                   display_available_store_credit_total: "$0.00"
                   addresses: []
@@ -393,16 +393,16 @@ paths:
           content:
             application/json:
               example:
-                token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6ImNiYjFjYjMyLTU1NmEtNDViMC05Y2I3LTNjNzMwYmQzYTE4ZiIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzg2MDAyNzg2fQ.6iCKOqevqdXLuqaW9dtjcmX1IVkX9MYcKKjNlWamAR0
-                refresh_token: z8mdjRLpth3e87ghDD3ViW4o
+                token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6ImZiZDU5MDJkLTYxZDktNDVmYi1iZjJkLWVmOWVkZTM0YzQzMyIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzg2MTM5MzcyfQ.hOpEfn34eDzhNsE1tVV6LHYtugyzkf6AVR_3dSvT2RM
+                refresh_token: EUv7LL2a8fwFjeA8nzTw56oL
                 user:
                   id: cust_UkLWZg9DAJ
                   email: customer@example.com
-                  first_name: Kimbery
-                  last_name: Larkin
+                  first_name: Edwardo
+                  last_name: Hermann
                   phone:
                   accepts_email_marketing: false
-                  full_name: Kimbery Larkin
+                  full_name: Edwardo Hermann
                   available_store_credit_total: '0'
                   display_available_store_credit_total: "$0.00"
                   addresses: []
@@ -879,8 +879,8 @@ paths:
               example:
                 data:
                 - id: prod_UkLWZg9DAJ
-                  name: Product 1297032
-                  slug: product-1297032
+                  name: Product 1291343
+                  slug: product-1291343
                   meta_title:
                   meta_description:
                   meta_keywords:
@@ -892,29 +892,20 @@ paths:
                   in_stock: false
                   backorderable: true
                   available: true
-                  description: Corporis fugit culpa ad magni sit doloremque pariatur.
-                    Natus earum deleniti distinctio quaerat voluptatum eaque. Culpa
-                    inventore tempora voluptatem id enim reprehenderit. Amet veniam
-                    magnam temporibus harum. Aperiam minima magnam beatae ad. Ab praesentium
-                    nostrum accusantium magni nihil quod quo. Rerum aperiam quidem
-                    mollitia incidunt autem temporibus. Eaque iure eligendi laudantium
-                    tempore iusto nemo. Officiis ut tempore dolor architecto fugiat
-                    ullam. Corporis architecto eum molestiae provident recusandae
-                    modi. Dolore neque id deserunt ut similique officiis. Nostrum
-                    fugiat ut veniam perferendis ullam laborum. Repellendus adipisci
-                    similique fugiat ut doloribus cum. Nihil ipsum nulla necessitatibus
-                    voluptatum expedita debitis at. Pariatur adipisci itaque hic autem
-                    soluta quo debitis. Cupiditate provident deserunt sequi perferendis
-                    laboriosam maiores officiis placeat. Impedit atque magnam similique
-                    minus necessitatibus harum consectetur. Soluta asperiores nisi
-                    temporibus natus ratione repellat. Asperiores provident laborum
-                    est voluptates.
+                  description: Nisi minima quis deleniti quam blanditiis possimus.
+                    At nihil quis deleniti ratione illum molestiae. Repudiandae quibusdam
+                    reprehenderit magnam odit. Praesentium commodi unde incidunt porro.
+                    Cupiditate nam sit architecto error natus. Ex enim tempore quibusdam
+                    praesentium adipisci est recusandae. Inventore excepturi eveniet
+                    assumenda aliquid. Reiciendis quos ipsam nesciunt quas eaque accusantium.
+                    Optio recusandae porro saepe id repellat dicta officiis. Quam
+                    qui ex sit rerum quasi placeat vitae veritatis. Blanditiis ratione
+                    excepturi recusandae culpa eum consectetur impedit. Magni odit
+                    nobis cum ipsum cumque voluptates.
                   description_html: |-
-                    Corporis fugit culpa ad magni sit doloremque pariatur. Natus earum deleniti distinctio quaerat voluptatum eaque. Culpa inventore tempora voluptatem id enim reprehenderit.
-                    Amet veniam magnam temporibus harum. Aperiam minima magnam beatae ad. Ab praesentium nostrum accusantium magni nihil quod quo. Rerum aperiam quidem mollitia incidunt autem temporibus. Eaque iure eligendi laudantium tempore iusto nemo.
-                    Officiis ut tempore dolor architecto fugiat ullam. Corporis architecto eum molestiae provident recusandae modi. Dolore neque id deserunt ut similique officiis. Nostrum fugiat ut veniam perferendis ullam laborum.
-                    Repellendus adipisci similique fugiat ut doloribus cum. Nihil ipsum nulla necessitatibus voluptatum expedita debitis at. Pariatur adipisci itaque hic autem soluta quo debitis. Cupiditate provident deserunt sequi perferendis laboriosam maiores officiis placeat.
-                    Impedit atque magnam similique minus necessitatibus harum consectetur. Soluta asperiores nisi temporibus natus ratione repellat. Asperiores provident laborum est voluptates.
+                    Nisi minima quis deleniti quam blanditiis possimus. At nihil quis deleniti ratione illum molestiae. Repudiandae quibusdam reprehenderit magnam odit.
+                    Praesentium commodi unde incidunt porro. Cupiditate nam sit architecto error natus. Ex enim tempore quibusdam praesentium adipisci est recusandae. Inventore excepturi eveniet assumenda aliquid. Reiciendis quos ipsam nesciunt quas eaque accusantium.
+                    Optio recusandae porro saepe id repellat dicta officiis. Quam qui ex sit rerum quasi placeat vitae veritatis. Blanditiis ratione excepturi recusandae culpa eum consectetur impedit. Magni odit nobis cum ipsum cumque voluptates.
                   default_variant_id: variant_UkLWZg9DAJ
                   thumbnail_url:
                   tags: []
@@ -1069,8 +1060,8 @@ paths:
               example:
                 data:
                 - id: prod_UkLWZg9DAJ
-                  name: Product 1717074
-                  slug: product-1717074
+                  name: Product 1717378
+                  slug: product-1717378
                   meta_title:
                   meta_description:
                   meta_keywords:
@@ -1099,8 +1090,8 @@ paths:
                     price_list_id:
                   original_price:
                 - id: prod_gbHJdmfrXB
-                  name: Product 1726982
-                  slug: product-1726982
+                  name: Product 1723546
+                  slug: product-1723546
                   meta_title:
                   meta_description:
                   meta_keywords:
@@ -1112,27 +1103,31 @@ paths:
                   in_stock: false
                   backorderable: true
                   available: true
-                  description: Nihil possimus consequuntur illum adipisci. Corrupti
-                    ea earum sunt repellendus magnam soluta assumenda. Numquam consequuntur
-                    tenetur veritatis sequi optio ad. Repellendus tempore officiis
-                    perferendis hic voluptatum illo odit. Non blanditiis perspiciatis
-                    aliquam dicta ut perferendis debitis. Explicabo quibusdam neque
-                    sit ipsam officia. Praesentium maiores perspiciatis corporis autem
-                    soluta incidunt placeat. Ea repellendus ad deserunt ullam inventore
-                    repudiandae aliquid natus. Optio voluptatum aliquid officia debitis
-                    enim. Nulla provident eius magni quasi iste odit culpa. Animi
-                    consequatur quae laboriosam nihil nisi molestiae. Ipsam explicabo
-                    ipsum deserunt sunt. Dolorum voluptatum non qui magnam. Quasi
-                    culpa vero praesentium cupiditate illum omnis. Doloribus iure
-                    ipsum aspernatur harum non. Adipisci esse eaque dolores natus
-                    veritatis consequuntur delectus quas. Quam doloremque architecto
-                    blanditiis accusantium magni. Perspiciatis quod rem dignissimos
-                    veritatis. Adipisci provident veniam incidunt perferendis.
+                  description: Iure velit nisi consequatur inventore vel esse commodi.
+                    Aut cupiditate maxime debitis nesciunt. Ipsa ipsam nihil asperiores
+                    repellat voluptatibus. Voluptas eos fuga iste accusantium fugit
+                    dolore. Facilis nobis saepe sunt sed recusandae et rerum. Quidem
+                    sint perferendis nemo dolorum magni aut similique. Consequatur
+                    praesentium est cum recusandae quibusdam quod ea. Dolore quaerat
+                    vero saepe placeat nobis assumenda totam neque. Aperiam sequi
+                    saepe maxime ea blanditiis quas. Numquam autem neque fugiat libero
+                    dolore. Cum soluta mollitia quam possimus. Quae a aliquid excepturi
+                    accusantium maiores. Distinctio at dolores voluptates iste consequuntur
+                    molestiae fugit aliquid. Quisquam autem officiis possimus provident.
+                    Ab consequuntur magnam et placeat ducimus dolor aut. Nemo modi
+                    quidem incidunt accusamus aut exercitationem. At deleniti doloremque
+                    tempora sunt culpa qui nesciunt. Unde culpa dolorem ducimus autem
+                    quaerat id. Aliquid cupiditate vero doloribus at quidem quisquam.
+                    Corporis optio iste nesciunt qui velit nemo corrupti. Dolores
+                    maiores voluptatem rem nemo ullam esse. Beatae minus in libero
+                    doloribus quasi quia provident nisi. Nesciunt corrupti voluptatem
+                    commodi aliquam amet id.
                   description_html: |-
-                    Nihil possimus consequuntur illum adipisci. Corrupti ea earum sunt repellendus magnam soluta assumenda. Numquam consequuntur tenetur veritatis sequi optio ad. Repellendus tempore officiis perferendis hic voluptatum illo odit. Non blanditiis perspiciatis aliquam dicta ut perferendis debitis.
-                    Explicabo quibusdam neque sit ipsam officia. Praesentium maiores perspiciatis corporis autem soluta incidunt placeat. Ea repellendus ad deserunt ullam inventore repudiandae aliquid natus. Optio voluptatum aliquid officia debitis enim.
-                    Nulla provident eius magni quasi iste odit culpa. Animi consequatur quae laboriosam nihil nisi molestiae. Ipsam explicabo ipsum deserunt sunt. Dolorum voluptatum non qui magnam. Quasi culpa vero praesentium cupiditate illum omnis.
-                    Doloribus iure ipsum aspernatur harum non. Adipisci esse eaque dolores natus veritatis consequuntur delectus quas. Quam doloremque architecto blanditiis accusantium magni. Perspiciatis quod rem dignissimos veritatis. Adipisci provident veniam incidunt perferendis.
+                    Iure velit nisi consequatur inventore vel esse commodi. Aut cupiditate maxime debitis nesciunt. Ipsa ipsam nihil asperiores repellat voluptatibus. Voluptas eos fuga iste accusantium fugit dolore. Facilis nobis saepe sunt sed recusandae et rerum.
+                    Quidem sint perferendis nemo dolorum magni aut similique. Consequatur praesentium est cum recusandae quibusdam quod ea. Dolore quaerat vero saepe placeat nobis assumenda totam neque. Aperiam sequi saepe maxime ea blanditiis quas. Numquam autem neque fugiat libero dolore.
+                    Cum soluta mollitia quam possimus. Quae a aliquid excepturi accusantium maiores. Distinctio at dolores voluptates iste consequuntur molestiae fugit aliquid. Quisquam autem officiis possimus provident.
+                    Ab consequuntur magnam et placeat ducimus dolor aut. Nemo modi quidem incidunt accusamus aut exercitationem. At deleniti doloremque tempora sunt culpa qui nesciunt. Unde culpa dolorem ducimus autem quaerat id.
+                    Aliquid cupiditate vero doloribus at quidem quisquam. Corporis optio iste nesciunt qui velit nemo corrupti. Dolores maiores voluptatem rem nemo ullam esse. Beatae minus in libero doloribus quasi quia provident nisi. Nesciunt corrupti voluptatem commodi aliquam amet id.
                   default_variant_id: variant_EfhxLZ9ck8
                   thumbnail_url:
                   tags: []
@@ -1234,8 +1229,8 @@ paths:
             application/json:
               example:
                 id: prod_UkLWZg9DAJ
-                name: Product 1999987
-                slug: product-1999987
+                name: Product 1996315
+                slug: product-1996315
                 meta_title:
                 meta_description:
                 meta_keywords:
@@ -1269,7 +1264,7 @@ paths:
                   amount_in_cents: 999
                   currency: USD
                   display_amount: "$9.99"
-                  recorded_at: '2026-07-22T06:53:12Z'
+                  recorded_at: '2026-07-23T20:49:39Z'
               schema:
                 "$ref": "#/components/schemas/Product"
         '404':
@@ -1519,7 +1514,7 @@ paths:
                   channel_id: ch_UkLWZg9DAJ
                   preferred_stock_location_id:
                   number: cart_gbHJdmfrXB
-                  token: vY7vPHCKPmddDqkMsueQnDnS
+                  token: ZGwRfzzwTM1QZDmG1fCs2aJ5
                   email:
                   customer_note:
                   currency: USD
@@ -1578,8 +1573,8 @@ paths:
                     preorder_ships_at:
                     quantity: 1
                     currency: USD
-                    name: Product 1048664
-                    slug: product-1048664
+                    name: Product 1048908
+                    slug: product-1048908
                     options_text: ''
                     price: '10.0'
                     display_price: "$10.00"
@@ -1624,7 +1619,7 @@ paths:
                   channel_id: ch_UkLWZg9DAJ
                   preferred_stock_location_id:
                   number: cart_UkLWZg9DAJ
-                  token: YF5RiUAJDyB6sPeyFmpfjj9Q
+                  token: rDJKdfw23YF2LXwEZjM8f7wJ
                   email:
                   customer_note:
                   currency: USD
@@ -1683,8 +1678,8 @@ paths:
                     preorder_ships_at:
                     quantity: 1
                     currency: USD
-                    name: Product 1039063
-                    slug: product-1039063
+                    name: Product 1034202
+                    slug: product-1034202
                     options_text: ''
                     price: '10.0'
                     display_price: "$10.00"
@@ -1802,7 +1797,7 @@ paths:
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
                 number: cart_UkLWZg9DAJ
-                token: BjNncg9bJwpfz9BsWKE51dNs
+                token: JTsY1USfmyF6pnH4EdMwN7DC
                 email:
                 customer_note:
                 currency: USD
@@ -1967,7 +1962,7 @@ paths:
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
                 number: cart_UkLWZg9DAJ
-                token: gH9hRoksSuMR9qrLxeV5LipU
+                token: JJytHbVGaseU1BVd1DEAKpFz
                 email:
                 customer_note:
                 currency: USD
@@ -1975,7 +1970,7 @@ paths:
                 total_quantity: 0
                 warnings:
                 - code: line_item_removed
-                  message: Product 1085606 was removed because it was sold out
+                  message: Product 1086790 was removed because it was sold out
                   line_item_id: li_UkLWZg9DAJ
                   variant_id: variant_UkLWZg9DAJ
                 coupon_code:
@@ -2117,7 +2112,7 @@ paths:
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
                 number: cart_UkLWZg9DAJ
-                token: BNTmJyhhfHdQxYBBJkTiX6u9
+                token: ssiwdnYqtCKnFAHqAX7ZoeSU
                 email:
                 customer_note: Leave at door
                 currency: USD
@@ -2172,8 +2167,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 1093203
-                  slug: product-1093203
+                  name: Product 1095813
+                  slug: product-1095813
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -2392,8 +2387,8 @@ paths:
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
                 number: cart_UkLWZg9DAJ
-                token: Z3jeSEhH4y5aXSvbwYHzVANy
-                email: drucilla@metz.ca
+                token: 5vrdx2ikeKAv3d7fJfhwbjat
+                email: calandra.rutherford@rutherfordwest.biz
                 customer_note:
                 currency: USD
                 locale: en
@@ -2444,8 +2439,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 1119378
-                  slug: product-1119378
+                  name: Product 1115530
+                  slug: product-1115530
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -2599,8 +2594,8 @@ paths:
                 market_id: mkt_UkLWZg9DAJ
                 cart_id: cart_UkLWZg9DAJ
                 channel_id: ch_UkLWZg9DAJ
-                number: R771964763
-                email: kimbery.dickinson@williamson.us
+                number: R690497072
+                email: demetrius@bogisich.us
                 customer_note:
                 currency: USD
                 locale: en
@@ -2608,7 +2603,7 @@ paths:
                 coupon_code:
                 fulfillment_status: backorder
                 payment_status: paid
-                completed_at: '2026-08-06T06:53:04.144Z'
+                completed_at: '2026-08-07T20:49:30.670Z'
                 item_total: '10.0'
                 display_item_total: "$10.00"
                 adjustment_total: '0.0'
@@ -2640,8 +2635,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 1141752
-                  slug: product-1141752
+                  name: Product 1144047
+                  slug: product-1144047
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -2666,7 +2661,7 @@ paths:
                   digital_links: []
                 fulfillments:
                 - id: ful_gbHJdmfrXB
-                  number: F77291293587
+                  number: F39480379632
                   tracking:
                   tracking_url:
                   pickup_point_data:
@@ -2700,7 +2695,7 @@ paths:
                   stock_location:
                     id: sloc_UkLWZg9DAJ
                     state_abbr: NY
-                    name: Armanda Senger
+                    name: Trinidad Weissnat
                     address1: 1600 Pennsylvania Ave NW
                     city: Washington
                     zipcode: '20500'
@@ -2732,8 +2727,8 @@ paths:
                 payments:
                 - id: py_UkLWZg9DAJ
                   payment_method_id: pm_UkLWZg9DAJ
-                  response_code: BGS-fc8fac9944b9
-                  number: PAWX9EMK
+                  response_code: BGS-ea4603e066c1
+                  number: PUOJEYV0
                   amount: '20.0'
                   display_amount: "$20.00"
                   status: completed
@@ -2889,7 +2884,7 @@ paths:
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
                 number: cart_UkLWZg9DAJ
-                token: ky57Uzbs9RduSQJfDrmYsd9y
+                token: FQDbauG8aEgScLYUcXpMkPpM
                 email:
                 customer_note:
                 currency: USD
@@ -2947,8 +2942,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 1402745
-                  slug: product-1402745
+                  name: Product 1405795
+                  slug: product-1405795
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -3077,7 +3072,7 @@ paths:
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
                 number: cart_UkLWZg9DAJ
-                token: ZH3qUqoa5mFPx8KVGwZtu3Cn
+                token: tAv724h9v1PwxK1V9ieHCqMH
                 email:
                 customer_note:
                 currency: USD
@@ -3132,8 +3127,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 142939
-                  slug: product-142939
+                  name: Product 1426794
+                  slug: product-1426794
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -3251,8 +3246,8 @@ paths:
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
                 number: cart_UkLWZg9DAJ
-                token: uVu1rkCULSJyvZHCG3zPsnT5
-                email: chelsey@bernier.biz
+                token: tfZdN3Upa8rmmMr4rUQ5SBSC
+                email: jacqulyn@grimes.biz
                 customer_note:
                 currency: USD
                 locale: en
@@ -3300,8 +3295,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 1449771
-                  slug: product-1449771
+                  name: Product 1446727
+                  slug: product-1446727
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -3326,7 +3321,7 @@ paths:
                   digital_links: []
                 fulfillments:
                 - id: ful_UkLWZg9DAJ
-                  number: F29595870834
+                  number: F54133936901
                   tracking:
                   tracking_url:
                   pickup_point_data:
@@ -3360,7 +3355,7 @@ paths:
                   stock_location:
                     id: sloc_UkLWZg9DAJ
                     state_abbr: NY
-                    name: Catherin Herman
+                    name: Oren Carroll
                     address1: 1600 Pennsylvania Ave NW
                     city: Washington
                     zipcode: '20500'
@@ -3515,7 +3510,7 @@ paths:
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
                 number: cart_UkLWZg9DAJ
-                token: V68JRRRdxiK4hs2SBoFsKkbv
+                token: TMvtwbyRwVToyVreqaaQV8Zt
                 email:
                 customer_note:
                 currency: USD
@@ -3566,8 +3561,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 1463654
-                  slug: product-1463654
+                  name: Product 1469145
+                  slug: product-1469145
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -3594,8 +3589,8 @@ paths:
                 payments:
                 - id: py_UkLWZg9DAJ
                   payment_method_id: pm_UkLWZg9DAJ
-                  response_code: 1-SC-20260806065308243546
-                  number: PDA34NFS
+                  response_code: 1-SC-20260807204934590829
+                  number: P9BMZ97Y
                   amount: '10.0'
                   display_amount: "$10.00"
                   status: checkout
@@ -3751,7 +3746,7 @@ paths:
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
                 number: cart_UkLWZg9DAJ
-                token: FcUFveqkBY96UnuYEoFmXeWt
+                token: MXpyX5n3idPNTt2vofWnZdyE
                 email:
                 customer_note:
                 currency: USD
@@ -3806,8 +3801,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 1507634
-                  slug: product-1507634
+                  name: Product 1505234
+                  slug: product-1505234
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -3834,8 +3829,8 @@ paths:
                 payments:
                 - id: py_UkLWZg9DAJ
                   payment_method_id: pm_UkLWZg9DAJ
-                  response_code: 1-SC-20260806065308550221
-                  number: P5O2YNFO
+                  response_code: 1-SC-20260807204934865762
+                  number: PIED5HX1
                   amount: '10.0'
                   display_amount: "$10.00"
                   status: invalid
@@ -3942,7 +3937,7 @@ paths:
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
                 number: cart_UkLWZg9DAJ
-                token: 21dV9iF7HCyJ9TZc27BRs9sJ
+                token: jvadFhxXvhEg16NhkUmoibCq
                 email:
                 customer_note:
                 currency: USD
@@ -3950,10 +3945,10 @@ paths:
                 total_quantity: 2
                 warnings:
                 - code: delivery_unavailable
-                  message: Product 1535829 cannot be delivered to the selected address
+                  message: Product 1533090 cannot be delivered to the selected address
                   line_item_id: li_UkLWZg9DAJ
                 - code: delivery_unavailable
-                  message: Product 1544634 cannot be delivered to the selected address
+                  message: Product 1545235 cannot be delivered to the selected address
                   line_item_id: li_gbHJdmfrXB
                 coupon_code:
                 item_total: '29.99'
@@ -4003,8 +3998,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 1535829
-                  slug: product-1535829
+                  name: Product 1533090
+                  slug: product-1533090
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -4033,8 +4028,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 1544634
-                  slug: product-1544634
+                  name: Product 1545235
+                  slug: product-1545235
                   options_text: ''
                   price: '19.99'
                   display_price: "$19.99"
@@ -4172,7 +4167,7 @@ paths:
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
                 number: cart_UkLWZg9DAJ
-                token: wWk1EgsJzsbmN3K9grajefro
+                token: uUckmDmEqhr6E3DnFTEvFzzy
                 email:
                 customer_note:
                 currency: USD
@@ -4223,8 +4218,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 157938
-                  slug: product-157938
+                  name: Product 157324
+                  slug: product-157324
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -4342,7 +4337,7 @@ paths:
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
                 number: cart_UkLWZg9DAJ
-                token: yQ9xoEFyHZ2Pxr6ZLBa9Q8Jq
+                token: Q8cbePWDHEjRhPzo6S4byoyR
                 email:
                 customer_note:
                 currency: USD
@@ -4482,9 +4477,9 @@ paths:
                 id: ps_gbHJdmfrXB
                 status: pending
                 currency: USD
-                external_id: bogus_9a7451b93a3688b86e94e0c0
+                external_id: bogus_da5aecdce2f1f7c90d576255
                 external_data:
-                  client_secret: bogus_secret_c6a19ce2f31f91fc
+                  client_secret: bogus_secret_806b4e9099a5c035
                 customer_external_id:
                 expires_at:
                 amount: '10.0'
@@ -4583,7 +4578,7 @@ paths:
                 id: ps_UkLWZg9DAJ
                 status: pending
                 currency: USD
-                external_id: bogus_d8d0ce9db3686d9ed687a59e
+                external_id: bogus_77cff91ae222d5fad98b608d
                 external_data:
                   client_secret: secret_123
                 customer_external_id:
@@ -4646,7 +4641,7 @@ paths:
                 id: ps_UkLWZg9DAJ
                 status: pending
                 currency: USD
-                external_id: bogus_048aa8b3eef1d42ca5646333
+                external_id: bogus_191a50d17dc7ebcc9bb4fd1a
                 external_data:
                   client_secret: secret_123
                 customer_external_id:
@@ -4749,7 +4744,7 @@ paths:
                 id: ps_UkLWZg9DAJ
                 status: completed
                 currency: USD
-                external_id: bogus_eb6a543a69de2d6c8f5e2d2d
+                external_id: bogus_25cb72f4dc3b5f94c8a8e7a8
                 external_data:
                   client_secret: secret_123
                 customer_external_id:
@@ -4848,7 +4843,7 @@ paths:
                 id: py_UkLWZg9DAJ
                 payment_method_id: pm_UkLWZg9DAJ
                 response_code:
-                number: PENIW5RF
+                number: PGHI0N2F
                 amount: '10.0'
                 display_amount: "$10.00"
                 status: checkout
@@ -4957,7 +4952,7 @@ paths:
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
                 number: cart_UkLWZg9DAJ
-                token: 4sMuM9pXGSrH8LTxJVvaqpg2
+                token: MGL861esQxkfKMERy5R6Hu9o
                 email:
                 customer_note:
                 currency: USD
@@ -5008,8 +5003,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 2199064
-                  slug: product-2199064
+                  name: Product 2199602
+                  slug: product-2199602
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -5036,8 +5031,8 @@ paths:
                 payments:
                 - id: py_UkLWZg9DAJ
                   payment_method_id: pm_UkLWZg9DAJ
-                  response_code: 1-SC-20260806065314214085
-                  number: PC4HV7M9
+                  response_code: 1-SC-20260807204940420175
+                  number: PTUTDCC0
                   amount: '10.0'
                   display_amount: "$10.00"
                   status: checkout
@@ -5157,7 +5152,7 @@ paths:
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
                 number: cart_UkLWZg9DAJ
-                token: eXmqiv8HzsoRXHhJCyHxwPEg
+                token: DKVofW1AeXvnPu4zmnbpPBYj
                 email:
                 customer_note:
                 currency: USD
@@ -5212,8 +5207,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 2211750
-                  slug: product-2211750
+                  name: Product 2217255
+                  slug: product-2217255
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -5328,7 +5323,7 @@ paths:
                 market_id: mkt_UkLWZg9DAJ
                 cart_id:
                 channel_id: ch_UkLWZg9DAJ
-                number: R553866761
+                number: R998302679
                 email: guest@example.com
                 customer_note:
                 currency: USD
@@ -5337,7 +5332,7 @@ paths:
                 coupon_code:
                 fulfillment_status:
                 payment_status:
-                completed_at: '2026-08-06T06:53:10.319Z'
+                completed_at: '2026-08-07T20:49:36.532Z'
                 item_total: '10.0'
                 display_item_total: "$10.00"
                 adjustment_total: '0.0'
@@ -5369,8 +5364,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 1618277
-                  slug: product-1618277
+                  name: Product 1619033
+                  slug: product-1619033
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -5395,7 +5390,7 @@ paths:
                   digital_links: []
                 fulfillments:
                 - id: ful_UkLWZg9DAJ
-                  number: F33598649535
+                  number: F63949833773
                   tracking: U10000
                   tracking_url:
                   pickup_point_data:
@@ -5429,7 +5424,7 @@ paths:
                   stock_location:
                     id: sloc_UkLWZg9DAJ
                     state_abbr: NY
-                    name: Ulrike Dach
+                    name: Melodi Franecki
                     address1: 1600 Pennsylvania Ave NW
                     city: Washington
                     zipcode: '20500'
@@ -6381,8 +6376,8 @@ paths:
                   market_id: mkt_UkLWZg9DAJ
                   cart_id:
                   channel_id: ch_UkLWZg9DAJ
-                  number: R849832793
-                  email: sadie.kuvalis@willmshammes.us
+                  number: R074347320
+                  email: migdalia_stoltenberg@caspercarroll.name
                   customer_note:
                   currency: USD
                   locale: en
@@ -6390,7 +6385,7 @@ paths:
                   coupon_code:
                   fulfillment_status:
                   payment_status:
-                  completed_at: '2026-08-06T06:53:06.652Z'
+                  completed_at: '2026-08-07T20:49:33.026Z'
                   item_total: '10.0'
                   display_item_total: "$10.00"
                   adjustment_total: '0.0'
@@ -6422,8 +6417,8 @@ paths:
                     preorder_ships_at:
                     quantity: 1
                     currency: USD
-                    name: Product 1309181
-                    slug: product-1309181
+                    name: Product 1308646
+                    slug: product-1308646
                     options_text: ''
                     price: '10.0'
                     display_price: "$10.00"
@@ -6448,7 +6443,7 @@ paths:
                     digital_links: []
                   fulfillments:
                   - id: ful_UkLWZg9DAJ
-                    number: F89983461451
+                    number: F19402681403
                     tracking: U10000
                     tracking_url:
                     pickup_point_data:
@@ -6482,7 +6477,7 @@ paths:
                     stock_location:
                       id: sloc_UkLWZg9DAJ
                       state_abbr: NY
-                      name: Jolanda Moen
+                      name: Sharen Becker
                       address1: 1600 Pennsylvania Ave NW
                       city: Washington
                       zipcode: '20500'
@@ -6659,8 +6654,8 @@ paths:
                 market_id: mkt_UkLWZg9DAJ
                 cart_id:
                 channel_id: ch_UkLWZg9DAJ
-                number: R289935921
-                email: kayleen@nolan.co.uk
+                number: R660891710
+                email: benita_sawayn@boscoschmidt.co.uk
                 customer_note:
                 currency: USD
                 locale: en
@@ -6668,7 +6663,7 @@ paths:
                 coupon_code:
                 fulfillment_status:
                 payment_status:
-                completed_at: '2026-08-06T06:53:06.819Z'
+                completed_at: '2026-08-07T20:49:33.255Z'
                 item_total: '10.0'
                 display_item_total: "$10.00"
                 adjustment_total: '0.0'
@@ -6700,8 +6695,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 132878
-                  slug: product-132878
+                  name: Product 1325941
+                  slug: product-1325941
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -6726,7 +6721,7 @@ paths:
                   digital_links: []
                 fulfillments:
                 - id: ful_UkLWZg9DAJ
-                  number: F69709338407
+                  number: F42518993200
                   tracking: U10000
                   tracking_url:
                   pickup_point_data:
@@ -6760,7 +6755,7 @@ paths:
                   stock_location:
                     id: sloc_UkLWZg9DAJ
                     state_abbr: NY
-                    name: Enriqueta Ziemann
+                    name: Larraine Hahn
                     address1: 1600 Pennsylvania Ave NW
                     city: Washington
                     zipcode: '20500'
@@ -6893,8 +6888,8 @@ paths:
           content:
             application/json:
               example:
-                token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6ImNhMjJmOGIwLTQ1ZGMtNGIyOS1hMGFiLWEzZTY4YWJhZjUxYSIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzg2MDAyNzg2fQ.h2PO2I5UVwVUO7z-M4F4IKFSvSnRgsbG76DGrJceurM
-                refresh_token: yQ4wuoebHJSWeuNwPiZGeHVh
+                token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjAwOWJjZjAzLTAyNzAtNDA1NS05OTYzLTdlNDYzZTJkMzg0ZSIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzg2MTM5MzczfQ.YWm3T24sBmwnQpIgElqnyc2iBeU6W5ny4xHUuXEF5wY
+                refresh_token: caQWisav2V1qfuqpfvn3qPyh
                 user:
                   id: cust_UkLWZg9DAJ
                   email: newuser@example.com
@@ -6911,10 +6906,10 @@ paths:
                   newsletter_subscriber:
                     id: sub_UkLWZg9DAJ
                     email: newuser@example.com
-                    created_at: '2026-08-06T06:53:06.975Z'
-                    updated_at: '2026-08-06T06:53:06.976Z'
+                    created_at: '2026-08-07T20:49:33.404Z'
+                    updated_at: '2026-08-07T20:49:33.406Z'
                     verified: true
-                    verified_at: '2026-08-06T06:53:06Z'
+                    verified_at: '2026-08-07T20:49:33Z'
                     customer_id: cust_UkLWZg9DAJ
                   customer_groups: []
               schema:
@@ -7017,12 +7012,12 @@ paths:
             application/json:
               example:
                 id: cust_UkLWZg9DAJ
-                email: candis_schumm@beatty.us
-                first_name: Alonzo
-                last_name: Volkman
+                email: lauren_bergstrom@walshschimmel.name
+                first_name: Rochelle
+                last_name: Champlin
                 phone: 555-555-0199
                 accepts_email_marketing: false
-                full_name: Alonzo Volkman
+                full_name: Rochelle Champlin
                 available_store_credit_total: '0'
                 display_available_store_credit_total: "$0.00"
                 addresses:
@@ -7158,7 +7153,7 @@ paths:
             application/json:
               example:
                 id: cust_UkLWZg9DAJ
-                email: marta@hane.name
+                email: sidney.feest@dietrichhoppe.biz
                 first_name: Updated
                 last_name: Name
                 phone: 555-555-0199
@@ -7349,7 +7344,7 @@ paths:
               example:
                 data:
                 - id: gc_UkLWZg9DAJ
-                  code: 9D3B1152FA1EBBC7
+                  code: AF6F27B34CA326B8
                   status: active
                   currency: USD
                   amount: '10.0'
@@ -7445,7 +7440,7 @@ paths:
             application/json:
               example:
                 id: gc_UkLWZg9DAJ
-                code: 056F7633DFC7D0A2
+                code: 0006045EDC4130B7
                 status: active
                 currency: USD
                 amount: '10.0'
@@ -7517,8 +7512,8 @@ paths:
               example:
                 id: pss_gbHJdmfrXB
                 status: pending
-                external_id: bogus_seti_1fe26750bf32c78ae9c78fdf
-                external_client_secret: bogus_seti_secret_8fbfc2b8555025bd
+                external_id: bogus_seti_06e37be8d870c452be8085da
+                external_client_secret: bogus_seti_secret_b234c3ea512af9cc
                 external_data: {}
                 payment_method_id: pm_UkLWZg9DAJ
                 payment_source_id:
@@ -7617,8 +7612,8 @@ paths:
               example:
                 id: pss_UkLWZg9DAJ
                 status: pending
-                external_id: seti_test_841b582d4f46c6e668f0a19e
-                external_client_secret: seti_secret_2b80ae9839b0e71a6c5b4e22
+                external_id: seti_test_42391fd9fa4a73438ae05dea
+                external_client_secret: seti_secret_0bea7b367249088c1152c923
                 external_data:
                   client_secret: secret_123
                 payment_method_id: pm_UkLWZg9DAJ
@@ -7694,8 +7689,8 @@ paths:
               example:
                 id: pss_UkLWZg9DAJ
                 status: completed
-                external_id: seti_test_c9eebd4de27894b5e817de7c
-                external_client_secret: seti_secret_33ca80adc19901ba5b13b015
+                external_id: seti_test_e8ee2d846b185a5d8e969db6
+                external_client_secret: seti_secret_fb416451aae79dd1d04b6558
                 external_data:
                   client_secret: secret_123
                 payment_method_id: pm_UkLWZg9DAJ
@@ -8639,7 +8634,7 @@ paths:
                 data:
                 - id: wl_UkLWZg9DAJ
                   name: My Wishlist
-                  token: ZKig6aVWNDEc98vpNp9ovq37
+                  token: cCfcGuXqgQmyvAthWzsaQb8R
                   is_default: false
                   is_private: true
                 meta:
@@ -8715,7 +8710,7 @@ paths:
               example:
                 id: wl_gbHJdmfrXB
                 name: Birthday Ideas
-                token: kiA4acRfkf4qvsWzCmLDFAkf
+                token: LFUSYaoFAnedbWDoC28moiU3
                 is_default: false
                 is_private: true
               schema:
@@ -8816,7 +8811,7 @@ paths:
               example:
                 id: wl_UkLWZg9DAJ
                 name: My Wishlist
-                token: jDyQvCE5UJ9Vr4jf94BeRthm
+                token: K8VuQB6TFgLUiV5MYMmTZfVK
                 is_default: false
                 is_private: true
               schema:
@@ -8878,7 +8873,7 @@ paths:
               example:
                 id: wl_UkLWZg9DAJ
                 name: Updated Name
-                token: wRHy3dCZJ23whZsVZVdU6XG9
+                token: 5EDZVQqMcUZ5mdbtxJAm4qYV
                 is_default: false
                 is_private: true
               schema:
@@ -9160,11 +9155,11 @@ paths:
             application/json:
               example:
                 id: sub_UkLWZg9DAJ
-                email: hal@wolf.ca
-                created_at: '2026-08-06T06:53:09.759Z'
-                updated_at: '2026-08-06T06:53:09.760Z'
+                email: ellena.hauck@jacobi.co.uk
+                created_at: '2026-08-07T20:49:35.983Z'
+                updated_at: '2026-08-07T20:49:35.984Z'
                 verified: true
-                verified_at: '2026-08-06T06:53:09Z'
+                verified_at: '2026-08-07T20:49:35Z'
                 customer_id: cust_UkLWZg9DAJ
               schema:
                 "$ref": "#/components/schemas/NewsletterSubscriber"
@@ -9243,10 +9238,10 @@ paths:
               example:
                 id: sub_UkLWZg9DAJ
                 email: pending@example.com
-                created_at: '2026-08-06T06:53:09.780Z'
-                updated_at: '2026-08-06T06:53:09.785Z'
+                created_at: '2026-08-07T20:49:36.006Z'
+                updated_at: '2026-08-07T20:49:36.011Z'
                 verified: true
-                verified_at: '2026-08-06T06:53:09Z'
+                verified_at: '2026-08-07T20:49:36Z'
                 customer_id:
               schema:
                 "$ref": "#/components/schemas/NewsletterSubscriber"
@@ -9416,7 +9411,7 @@ paths:
                   body_html: ''
                 - id: pol_OIJLhNcSbf
                   name: Privacy Policy
-                  slug: privacy-policy-7bb47d79-033e-4437-b9ab-5bb1f3c9be58
+                  slug: privacy-policy-e6543f47-bbab-41e2-a91c-cf4d4e4ba168
                   body: We respect your privacy.
                   body_html: |
                     <div class="trix-content">
@@ -9806,20 +9801,6 @@ components:
       bearerFormat: JWT
       description: JWT token for authenticated customers
   schemas:
-    ClaimReason:
-      type: object
-      properties:
-        id:
-          type: string
-        name:
-          type: string
-        active:
-          type: boolean
-      required:
-      - id
-      - name
-      - active
-      x-typelizer: true
     PaginationMeta:
       type: object
       properties:
@@ -10592,6 +10573,20 @@ components:
       - replacement_variant_id
       - line_item_id
       x-typelizer: true
+    ClaimReason:
+      type: object
+      properties:
+        id:
+          type: string
+        name:
+          type: string
+        active:
+          type: boolean
+      required:
+      - id
+      - name
+      - active
+      x-typelizer: true
     Claim:
       type: object
       properties:
@@ -12560,6 +12555,20 @@ components:
       - line_item_id
       - fulfillment_item_id
       x-typelizer: true
+    ReturnReason:
+      type: object
+      properties:
+        id:
+          type: string
+        name:
+          type: string
+        active:
+          type: boolean
+      required:
+      - id
+      - name
+      - active
+      x-typelizer: true
     Return:
       type: object
       properties:
@@ -12610,20 +12619,6 @@ components:
       - refunded_at
       - canceled_at
       x-typelizer: true
-    ReturnReason:
-      type: object
-      properties:
-        id:
-          type: string
-        name:
-          type: string
-        active:
-          type: boolean
-      required:
-      - id
-      - name
-      - active
-      x-typelizer: true
     State:
       type: object
       properties:

package/dist/developer/dashboard/customization/permissions.md

@@ -101,21 +101,9 @@ function ReportsPage() {
 
 The same `permissions` object backs the nav registry's `if` predicate, so you can move logic between the two without changing behaviour. For declarative gating, `<Can I="update" a="Spree::Order">…</Can>` (also from `@spree/dashboard-core`) renders children only when the check passes.
 
-## Custom abilities
-
-If your customization introduces a new model on the backend, extend the CanCanCan ability there (typically a decorator on `Spree::PermissionSets::DefaultCustomer` or `Spree::PermissionSets::DashboardManagement`):
-
-```ruby
-# config/initializers/spree.rb (host app)
-Spree::PermissionSets::DashboardManagement.class_eval do
-  def activate!
-    super
-    can :manage, MyApp::Report
-  end
-end
-```
+## Custom permissions
 
-After that, `permissions.can('read', 'MyApp::Report')` resolves in the dashboard exactly like a first-party check — the abilities ship to the dashboard with the current-user response (`GET /api/v3/admin/me`) at sign-in.
+If your customization introduces a new model on the backend, register it as a permission catalog resource there (`Spree.permissions.register_resource` in your engine's initializer). Its keys then appear in the role editor and the API-key scope picker, and any role granted them makes `permissions.can('read', 'MyApp::Report')` resolve in the dashboard exactly like a first-party check — the abilities ship with the current-user response (`GET /api/v3/admin/me`) at sign-in, alongside `permission_keys`, the flat key list the role editor grants from.
 
 ## Reference
 

package/dist/developer/upgrades/5.6-to-6.0.md

@@ -300,6 +300,21 @@ These were deprecated in 5.x and are **gone now** — there is no bridge, so cal
 | `Product.add_search_scope` | plain `scope :name, -> { ... }` |
 | `Spree::Image::Configuration::ActiveStorage` | deleted — an empty no-op module; all logic lives in `Spree::Asset` |
 | `Spree::OrderRouting::Strategy::Legacy` | `Spree::OrderRouting::Strategy::Rules` (see below) |
+| `private_metafields` association | read `custom_fields` and filter, or query `Spree::CustomField.admin_only` |
+
+### Custom fields replace metafields
+
+The metafields system is now custom fields: `Spree::CustomField` and `Spree::CustomFieldDefinition`, stored in `spree_custom_fields` and `spree_custom_field_definitions`. The legacy class names, the concern, and the reader methods all keep working for one release with a deprecation warning (see the table further down), so most applications need no code change to upgrade.
+
+Two things do change under you, both handled by `db:migrate`:
+
+- **Visibility is a boolean.** The tri-state `display_on` column collapses into `storefront_visible`. Definitions that were `back_end` become `storefront_visible: false`; everything else becomes `true`. The `front_end`-only value never meant hidden-from-staff and folds into `true`.
+- **Two columns are renamed.** `name` becomes `label`, and `metafield_type` becomes `field_type`. Reading `field_type` returns the API token (`short_text`) rather than the Ruby class name; use `field_type_class_name` when you need the class.
+- **Rich-text values leave Action Text.** `Spree::CustomFields::RichText` stores sanitized HTML in the same `value` column as every other type, so reading `value` returns a String rather than an `ActionText::RichText`. Existing bodies are copied across by the migration; the Action Text rows stay behind as a rollback path until 6.1. Code calling `custom_field.value.body` should read `value` directly.
+
+Two behavior notes for extension authors: `Spree::Metadata` no longer includes the custom-fields concern (metadata is the private, schemaless system — include `Spree::HasCustomFields` explicitly if a model needs both), and rich-text values are now sanitized on save, so markup outside the allowlist is stripped rather than stored.
+
+**BREAKING — product CSV.** Custom-field columns are now prefixed `custom_field.` instead of `metafield.` (for example `custom_field.custom.material`). Exports emit the new prefix and imports only recognise the new prefix, so update any saved import templates and any integration that reads the export. A file still using the old prefix imports without its custom-field values rather than failing.
 
 ### The Legacy order-routing strategy is gone
 
@@ -377,6 +392,43 @@ Every rename keeps the legacy name working for one release with a deprecation wa
 | `order.completed` event | `order.placed` |
 | Calling cart services with `order:` kwargs | `cart:` kwargs |
 | `OrderWalkthrough` (testing support) | factories: `:cart_ready_for_delivery`, `:cart_ready_to_complete`, `:completed_order_with_totals` |
+| `Spree::Metafield`, `Spree::MetafieldDefinition`, `Spree::Metafields::*` | `Spree::CustomField`, `Spree::CustomFieldDefinition`, `Spree::CustomFields::*` |
+| `include Spree::Metafields` | `include Spree::HasCustomFields` |
+| `#set_metafield`, `#get_metafield`, `#has_metafield?` | `#set_custom_field`, `#get_custom_field`, `#has_custom_field?` |
+| `metafields` / `public_metafields` associations | `custom_fields` / `storefront_custom_fields` |
+| `.with_metafield_key`, `.with_metafield_key_value` | `.with_custom_field_key`, `.with_custom_field_key_value` |
+| `Spree.metafields` | `Spree.custom_fields` |
+| `CustomFieldDefinition#name`, `#metafield_type`, `#display_on` | `#label`, `#field_type`, `#storefront_visible` (columns renamed) |
+
+## Staff permissions: roles are data
+
+Permission sets are **removed with no bridge**. Staff roles now hold flat permission keys from one catalog — the same `read_<resource>` / `write_<resource>` vocabulary secret API keys use — and are managed as data: in the dashboard (Settings → Roles), through the Admin API (`/api/v3/admin/roles`), or in seeds. Code no longer defines what a role can do.
+
+| Removed | Use instead |
+|---|---|
+| `Spree::PermissionSets::*` (all classes) | catalog keys on the role row: `Spree::Role#permissions` |
+| `Spree.permissions.assign(:role, [sets])` | the role editor, `POST /api/v3/admin/roles`, or plain ActiveRecord in seeds |
+| Custom permission sets with record-level rules | Replace the ability class: `Spree::Dependencies.ability_class = 'MyApp::Ability'` |
+| `Spree::ApiKey::SCOPES` | `Spree::ApiKey.known_scopes` (derived from the catalog) |
+
+Old initializers fail loudly at boot: the set constants raise `NameError`, and `Spree.permissions.assign` raises with directions. **Recreate your custom roles before deploying** — a pre-existing role row comes up with no permissions, so staff holding it are locked out (fail closed) until its permissions are filled in:
+
+```ruby
+# db/seeds.rb — "roles as code" is plain ActiveRecord now
+Spree::Role.find_or_create_by!(name: 'support')
+  .update!(permissions: %w[read_orders read_customers])
+```
+
+Storefront customers are not part of this system: the old `:default` role and `DefaultCustomer` set are gone, customers never resolve roles, and the Store API no longer consults CanCanCan at all — customer authorization is ownership-scoped queries plus `Spree::Storefront::AccessPolicy` (swappable via `Spree::Dependencies.storefront_access_policy_class`). If an extension added storefront `can` rules, move them into an access-policy subclass or a checkout workflow `validate` hook. Extensions register their resources into the catalog once, which makes them grantable to roles **and** mintable as API-key scopes:
+
+```ruby
+Spree.permissions.register_resource(:reviews, group: :catalog, subjects: -> { [SpreeReviews::Review] })
+```
+
+Two enforcement changes on the Admin API:
+
+- **JWT staff pass the same per-controller key gate as secret keys.** A request whose principal lacks `<read|write>_<resource>` gets a 403 with `details.required_permission` naming the missing key.
+- **Staff endpoints moved out of the `settings` scope.** `/admin_users`, `/invitations`, and `/roles` now require the new `read_staff` / `write_staff` scopes; secret keys minted with `settings` before 6.0 lose those endpoints. `/countries` and `/locales` became scope-exempt reference data.
 
 ## For extension authors
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spree/docs",
-  "version": "0.1.149",
+  "version": "0.1.151",
   "description": "Spree Commerce developer documentation for AI agents and local reference",
   "type": "module",
   "license": "CC-BY-4.0",