Skip to content

armgit / spree

Public Imported from GitHub
0

Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.

Fix: Offered every dimension unit in the variant editors and shared unit and variant request types (#14936)

Damian Legawiec06fc8b065747
diff --git a/.changeset/unit-code-lists-and-variant-params.md b/.changeset/unit-code-lists-and-variant-params.md
new file mode 100644
index 0000000000..070cd3bb54
--- /dev/null
+++ b/.changeset/unit-code-lists-and-variant-params.md
@@ -0,0 +1,8 @@
+---
+"@spree/sdk": patch
+"@spree/admin-sdk": patch
+"@spree/seller-sdk": patch
+"@spree/dashboard": patch
+---
+
+Weight and dimension units are closed code lists, exported as `WeightUnit` and `DimensionUnit` (values and types) like `CountryCode` and `CurrencyCode`, and every unit field in responses and request types uses them; unit fields in requests accept `null` to fall back to the store default. The Admin and Seller SDKs publish one `VariantParams` type: `ProductVariantParams`, `VariantCreateParams` and `VariantUpdateParams` build on it. The Seller SDK's `SellerProductVariantParams` is renamed to `ProductVariantParams` (the old name stays as a deprecated alias). The variant editor and bulk variant editor now offer feet as a dimension unit.
diff --git a/.github/workflows/packages.yml b/.github/workflows/packages.yml
index ff1525c0f1..5b3b57d5c8 100644
--- a/.github/workflows/packages.yml
+++ b/.github/workflows/packages.yml
@@ -100,14 +100,14 @@ jobs:
exit 1
fi
- # The country, currency and locale lists come from the closed code
- # schemas in the Store API reference.
+ # The country, currency, locale and unit lists come from the closed code
+ # schemas in the Store and Admin API references.
- name: Check SDK code lists are up to date
run: |
- pnpm generate:iso-codes
- if [ -n "$(git status --porcelain -- packages/sdk-core/src/iso-codes.generated.ts)" ]; then
- git diff -- packages/sdk-core/src/iso-codes.generated.ts
- echo "::error::SDK code lists are out of date. Run 'pnpm generate:iso-codes' and commit the result."
+ pnpm generate:code-lists
+ if [ -n "$(git status --porcelain -- packages/sdk-core/src/code-lists.generated.ts)" ]; then
+ git diff -- packages/sdk-core/src/code-lists.generated.ts
+ echo "::error::SDK code lists are out of date. Run 'pnpm generate:code-lists' and commit the result."
exit 1
fi
diff --git a/docs/api-reference/admin.yaml b/docs/api-reference/admin.yaml
index d444626287..29b1cac790 100644
--- a/docs/api-reference/admin.yaml
+++ b/docs/api-reference/admin.yaml
@@ -7203,7 +7203,7 @@ paths:
content: |-
## Filters
- Filter with `q[<attribute>_<predicate>]=value`, for example `q[currency_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/admin-api/querying#which-filters-an-endpoint-accepts).
+ Filter with `q[<attribute>_<predicate>]=value`, for example `q[memo_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/admin-api/querying#which-filters-an-endpoint-accepts).
| Attribute | Kind | Predicates |
|---|---|---|
@@ -10202,7 +10202,7 @@ paths:
content:
application/json:
example:
- signed_id: eyJfcmFpbHMiOnsiZGF0YSI6MSwiZXhwIjoiMjAyNi0wMS0xNlQxMjowMDowMC4wMDBaIiwicHVyIjoiYmxvYl9pZCJ9fQ==--ee9db0d35f7a01f2e75cd6e66a7c5d973957a5c8
+ signed_id: eyJfcmFpbHMiOnsiZGF0YSI6MSwiZXhwIjoiMjAyNi0wMS0xNlQxMjowMDowMC4wMDBaIiwicHVyIjoiYmxvYl9pZCJ9fQ==--37ea8559a3ea6e9f4877608b795389de5d0a2325
filename: products.csv
content_type: text/csv
byte_size: 48213
@@ -10210,7 +10210,7 @@ paths:
expires_at: '2026-01-16T12:00:00.000Z'
upload:
method: PUT
- url: http://www.example.com/rails/active_storage/disk/eyJfcmFpbHMiOnsiZGF0YSI6eyJrZXkiOiJxcmZsMnNod3YwYmR4cWF3ZWFocDZvYjhlYzh5IiwiY29udGVudF90eXBlIjoidGV4dC9jc3YiLCJjb250ZW50X2xlbmd0aCI6NDgyMTMsImNoZWNrc3VtIjoiaGdKTXJSNkRFQjJYTloxelVRVVJWZz09Iiwic2VydmljZV9uYW1lIjoidGVzdCJ9LCJleHAiOiIyMDI2LTAxLTE1VDEyOjA1OjAwLjAwMFoiLCJwdXIiOiJibG9iX3Rva2VuIn19--63bab79a1a7c5e3405d2d80b82893b0b0cb3daf5
+ url: http://www.example.com/rails/active_storage/disk/eyJfcmFpbHMiOnsiZGF0YSI6eyJrZXkiOiJxcmZsMnNod3YwYmR4cWF3ZWFocDZvYjhlYzh5IiwiY29udGVudF90eXBlIjoidGV4dC9jc3YiLCJjb250ZW50X2xlbmd0aCI6NDgyMTMsImNoZWNrc3VtIjoiaGdKTXJSNkRFQjJYTloxelVRVVJWZz09Iiwic2VydmljZV9uYW1lIjoidGVzdCJ9LCJleHAiOiIyMDI2LTAxLTE1VDEyOjA1OjAwLjAwMFoiLCJwdXIiOiJibG9iX3Rva2VuIn19--900c151cd70c1eef5cc5fc5c7fd1d4922ae2063a
headers:
Content-Type: text/csv
schema:
@@ -16747,7 +16747,7 @@ paths:
content: |-
## Filters
- Filter with `q[<attribute>_<predicate>]=value`, for example `q[country_code_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/admin-api/querying#which-filters-an-endpoint-accepts).
+ Filter with `q[<attribute>_<predicate>]=value`, for example `q[provider_id_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/admin-api/querying#which-filters-an-endpoint-accepts).
| Attribute | Kind | Predicates |
|---|---|---|
@@ -22737,7 +22737,7 @@ paths:
content: |-
## Filters
- Filter with `q[<attribute>_<predicate>]=value`, for example `q[currency_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/admin-api/querying#which-filters-an-endpoint-accepts).
+ Filter with `q[<attribute>_<predicate>]=value`, for example `q[amount_eq]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/admin-api/querying#which-filters-an-endpoint-accepts).
| Attribute | Kind | Predicates |
|---|---|---|
@@ -23706,7 +23706,7 @@ paths:
updated_at: '2026-01-15T12:00:00.000Z'
provider_type:
provider_name: File
- download_url: http://www.example.com/rails/active_storage/disk/eyJfcmFpbHMiOnsiZGF0YSI6eyJrZXkiOiJ0Z252N2l0MG55YnkwbHhkczg5Y2hteTd6aXlvIiwiZGlzcG9zaXRpb24iOiJhdHRhY2htZW50OyBmaWxlbmFtZT1cInRoaW5raW5nLWNhdC5qcGdcIjsgZmlsZW5hbWUqPVVURi04Jyd0aGlua2luZy1jYXQuanBnIiwiY29udGVudF90eXBlIjoiaW1hZ2UvanBlZyIsInNlcnZpY2VfbmFtZSI6InRlc3QifSwiZXhwIjoiMjAyNi0wMS0xNVQxMjowNTowMC4wMDBaIiwicHVyIjoiYmxvYl9rZXkifX0=--3eb3abc8c585d12290abb3e0bca118393f89b258/thinking-cat.jpg
+ download_url: http://www.example.com/rails/active_storage/disk/eyJfcmFpbHMiOnsiZGF0YSI6eyJrZXkiOiJ0Z252N2l0MG55YnkwbHhkczg5Y2hteTd6aXlvIiwiZGlzcG9zaXRpb24iOiJhdHRhY2htZW50OyBmaWxlbmFtZT1cInRoaW5raW5nLWNhdC5qcGdcIjsgZmlsZW5hbWUqPVVURi04Jyd0aGlua2luZy1jYXQuanBnIiwiY29udGVudF90eXBlIjoiaW1hZ2UvanBlZyIsInNlcnZpY2VfbmFtZSI6InRlc3QifSwiZXhwIjoiMjAyNi0wMS0xNVQxMjowNTowMC4wMDBaIiwicHVyIjoiYmxvYl9rZXkifX0=--e42005e4c105e6f8094c921695292e20b969a0ad/thinking-cat.jpg
effective_authorized_clicks: 5
effective_authorized_days: 7
meta:
@@ -23797,7 +23797,7 @@ paths:
updated_at: '2026-01-15T12:00:00.000Z'
provider_type:
provider_name: File
- download_url: http://www.example.com/rails/active_storage/disk/eyJfcmFpbHMiOnsiZGF0YSI6eyJrZXkiOiJhOXR0cGNpbmxxbThvbmtlNHM1NmI2Y3gxMWVzIiwiZGlzcG9zaXRpb24iOiJhdHRhY2htZW50OyBmaWxlbmFtZT1cIm1hbnVhbC5wZGZcIjsgZmlsZW5hbWUqPVVURi04JydtYW51YWwucGRmIiwiY29udGVudF90eXBlIjoiaW1hZ2UvanBlZyIsInNlcnZpY2VfbmFtZSI6InRlc3QifSwiZXhwIjoiMjAyNi0wMS0xNVQxMjowNTowMC4wMDBaIiwicHVyIjoiYmxvYl9rZXkifX0=--46746b28f02b813c55ea370385310cb3bb8199de/manual.pdf
+ download_url: http://www.example.com/rails/active_storage/disk/eyJfcmFpbHMiOnsiZGF0YSI6eyJrZXkiOiJhOXR0cGNpbmxxbThvbmtlNHM1NmI2Y3gxMWVzIiwiZGlzcG9zaXRpb24iOiJhdHRhY2htZW50OyBmaWxlbmFtZT1cIm1hbnVhbC5wZGZcIjsgZmlsZW5hbWUqPVVURi04JydtYW51YWwucGRmIiwiY29udGVudF90eXBlIjoiaW1hZ2UvanBlZyIsInNlcnZpY2VfbmFtZSI6InRlc3QifSwiZXhwIjoiMjAyNi0wMS0xNVQxMjowNTowMC4wMDBaIiwicHVyIjoiYmxvYl9rZXkifX0=--c9c18ad2443198da01ed71a0dc9284caacae4001/manual.pdf
effective_authorized_clicks: 5
effective_authorized_days: 30
schema:
@@ -23886,7 +23886,7 @@ paths:
updated_at: '2026-01-15T12:00:00.000Z'
provider_type:
provider_name: File
- download_url: http://www.example.com/rails/active_storage/disk/eyJfcmFpbHMiOnsiZGF0YSI6eyJrZXkiOiIwZXp6d3IzMzE3ajRoem9kc3Awc2czN3EzMnhzIiwiZGlzcG9zaXRpb24iOiJhdHRhY2htZW50OyBmaWxlbmFtZT1cInRoaW5raW5nLWNhdC5qcGdcIjsgZmlsZW5hbWUqPVVURi04Jyd0aGlua2luZy1jYXQuanBnIiwiY29udGVudF90eXBlIjoiaW1hZ2UvanBlZyIsInNlcnZpY2VfbmFtZSI6InRlc3QifSwiZXhwIjoiMjAyNi0wMS0xNVQxMjowNTowMC4wMDBaIiwicHVyIjoiYmxvYl9rZXkifX0=--f2d667ba3ae460e4f69a442091349666bfdacb37/thinking-cat.jpg
+ download_url: http://www.example.com/rails/active_storage/disk/eyJfcmFpbHMiOnsiZGF0YSI6eyJrZXkiOiIwZXp6d3IzMzE3ajRoem9kc3Awc2czN3EzMnhzIiwiZGlzcG9zaXRpb24iOiJhdHRhY2htZW50OyBmaWxlbmFtZT1cInRoaW5raW5nLWNhdC5qcGdcIjsgZmlsZW5hbWUqPVVURi04Jyd0aGlua2luZy1jYXQuanBnIiwiY29udGVudF90eXBlIjoiaW1hZ2UvanBlZyIsInNlcnZpY2VfbmFtZSI6InRlc3QifSwiZXhwIjoiMjAyNi0wMS0xNVQxMjowNTowMC4wMDBaIiwicHVyIjoiYmxvYl9rZXkifX0=--460229b26eb8f170248268466ab15eea32d07043/thinking-cat.jpg
effective_authorized_clicks: 10
effective_authorized_days: 7
schema:
@@ -31019,11 +31019,10 @@ paths:
rate_percent: '19',
country_code: 'DE',
tax_category_id: 'txc_UkLWZg9DAJ',
- included_in_price: true,
})
- lang: bash
label: Spree CLI
- source: spree api post /tax_rates -d '{"name":"German VAT","rate_percent":"19","country_code":"DE","tax_category_id":"txc_UkLWZg9DAJ","included_in_price":true}'
+ source: spree api post /tax_rates -d '{"name":"German VAT","rate_percent":"19","country_code":"DE","tax_category_id":"txc_UkLWZg9DAJ"}'
parameters:
- name: x-spree-api-key
in: header
@@ -31522,7 +31521,7 @@ paths:
content:
application/json:
example:
- current_version: 6.0.0.rc3
+ current_version: 6.0.0.rc4
enabled: true
checked_at: '2026-10-03T04:00:00.000Z'
update_available: true
@@ -33641,7 +33640,7 @@ paths:
content: |-
## Filters
- Filter with `q[<attribute>_<predicate>]=value`, for example `q[currency_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/admin-api/querying#which-filters-an-endpoint-accepts).
+ Filter with `q[<attribute>_<predicate>]=value`, for example `q[memo_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/admin-api/querying#which-filters-an-endpoint-accepts).
| Attribute | Kind | Predicates |
|---|---|---|
@@ -34191,7 +34190,7 @@ paths:
content: |-
## Filters
- Filter with `q[<attribute>_<predicate>]=value`, for example `q[cost_currency_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/admin-api/querying#which-filters-an-endpoint-accepts).
+ Filter with `q[<attribute>_<predicate>]=value`, for example `q[hs_code_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/admin-api/querying#which-filters-an-endpoint-accepts).
| Attribute | Kind | Predicates |
|---|---|---|
@@ -35016,7 +35015,7 @@ paths:
content: |-
## Filters
- Filter with `q[<attribute>_<predicate>]=value`, for example `q[cost_currency_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/admin-api/querying#which-filters-an-endpoint-accepts).
+ Filter with `q[<attribute>_<predicate>]=value`, for example `q[hs_code_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/admin-api/querying#which-filters-an-endpoint-accepts).
| Attribute | Kind | Predicates |
|---|---|---|
@@ -40129,7 +40128,7 @@ paths:
content: |-
## Filters
- Filter with `q[<attribute>_<predicate>]=value`, for example `q[currency_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/admin-api/querying#which-filters-an-endpoint-accepts).
+ Filter with `q[<attribute>_<predicate>]=value`, for example `q[amount_eq]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/admin-api/querying#which-filters-an-endpoint-accepts).
| Attribute | Kind | Predicates |
|---|---|---|
@@ -45026,13 +45025,13 @@ paths:
video_embed_url:
video_url:
poster_url:
- original_url: http://localhost:3000/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/thinking-cat.jpg
- mini_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjgsMTI4XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--ca882db7ae219757a69edb16a1258ffd3425f9e8/thinking-cat.jpg
- small_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyNTYsMjU2XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--dcfbb5f9274f6fe1c9dea79e98ca851d7b66f972/thinking-cat.jpg
- medium_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls0MDAsNDAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--3eeeddc44473e17abefe3d91ceb7e1386b062651/thinking-cat.jpg
- large_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls3MjAsNzIwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--6150a09686a18d103463acd98756a4f1277d9e27/thinking-cat.jpg
- xlarge_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyMDAwLDIwMDBdLCJzYXZlciI6eyJzdHJpcCI6dHJ1ZSwicXVhbGl0eSI6NzUsImxvc3NsZXNzIjpmYWxzZSwiYWxwaGFfcSI6ODUsInJlZHVjdGlvbl9lZmZvcnQiOjYsInNtYXJ0X3N1YnNhbXBsZSI6dHJ1ZX19LCJwdXIiOiJ2YXJpYXRpb24ifX0=--918c7c1856e74f9a607b8181274909ef3b58fae5/thinking-cat.jpg
- og_image_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjAwLDYzMF0sInNhdmVyIjp7InN0cmlwIjp0cnVlLCJxdWFsaXR5Ijo3NSwibG9zc2xlc3MiOmZhbHNlLCJhbHBoYV9xIjo4NSwicmVkdWN0aW9uX2VmZm9ydCI6Niwic21hcnRfc3Vic2FtcGxlIjp0cnVlfX0sInB1ciI6InZhcmlhdGlvbiJ9fQ==--c77fcf84a0ab838daf5045f909c8a77dff682d61/thinking-cat.jpg
+ original_url: http://localhost:3000/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/thinking-cat.jpg
+ mini_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjgsMTI4XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--c7cabbf4f42ac8ba67d9a91d8296f41a60806a27/thinking-cat.jpg
+ small_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyNTYsMjU2XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--2a76f6551b45153f6e6be558bc5934f5252e5d4b/thinking-cat.jpg
+ medium_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls0MDAsNDAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--70f1b4b1d65bbac19c369f6514a14b2efae9b861/thinking-cat.jpg
+ large_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls3MjAsNzIwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--ad2e7db00f46de1be1b1d802422591dc63cda389/thinking-cat.jpg
+ xlarge_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyMDAwLDIwMDBdLCJzYXZlciI6eyJzdHJpcCI6dHJ1ZSwicXVhbGl0eSI6NzUsImxvc3NsZXNzIjpmYWxzZSwiYWxwaGFfcSI6ODUsInJlZHVjdGlvbl9lZmZvcnQiOjYsInNtYXJ0X3N1YnNhbXBsZSI6dHJ1ZX19LCJwdXIiOiJ2YXJpYXRpb24ifX0=--a86d6ae04dadfd78927fab23cc51648f9edd3775/thinking-cat.jpg
+ og_image_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjAwLDYzMF0sInNhdmVyIjp7InN0cmlwIjp0cnVlLCJxdWFsaXR5Ijo3NSwibG9zc2xlc3MiOmZhbHNlLCJhbHBoYV9xIjo4NSwicmVkdWN0aW9uX2VmZm9ydCI6Niwic21hcnRfc3Vic2FtcGxlIjp0cnVlfX0sInB1ciI6InZhcmlhdGlvbiJ9fQ==--c0f594ef4e0298070899e42d661848fbdf32192b/thinking-cat.jpg
external_references: {}
created_at: '2026-01-15T12:00:00.000Z'
updated_at: '2026-01-15T12:00:00.000Z'
@@ -45040,10 +45039,10 @@ paths:
filename: thinking-cat.jpg
content_type: image/jpeg
byte_size: 18090
- embed_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2xpbWl0IjpbMTIwMCwxMjAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--e5ec1051c1f03aa144647d80dfd66d6078e08ac3/thinking-cat.jpg
- signed_id: eyJfcmFpbHMiOnsiZGF0YSI6MSwiZXhwIjoiMjAyNi0wMS0xNlQxMjowMDowMC4wMDBaIiwicHVyIjoiYmxvYl9pZCJ9fQ==--ee9db0d35f7a01f2e75cd6e66a7c5d973957a5c8
+ embed_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2xpbWl0IjpbMTIwMCwxMjAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--28f76504c18451476e04c1b0194941f513805ebe/thinking-cat.jpg
+ signed_id: eyJfcmFpbHMiOnsiZGF0YSI6MSwiZXhwIjoiMjAyNi0wMS0xNlQxMjowMDowMC4wMDBaIiwicHVyIjoiYmxvYl9pZCJ9fQ==--37ea8559a3ea6e9f4877608b795389de5d0a2325
viewable_id: prod_UkLWZg9DAJ
- download_url: http://localhost:3000/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/thinking-cat.jpg?disposition=attachment
+ download_url: http://localhost:3000/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/thinking-cat.jpg?disposition=attachment
metadata: {}
viewable_type: product
meta:
@@ -45134,13 +45133,13 @@ paths:
video_embed_url:
video_url:
poster_url:
- original_url: http://localhost:3000/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--d982d54ec8b4cbd7964b086ecbe5b38271609a6a/library-upload.jpg
- mini_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--d982d54ec8b4cbd7964b086ecbe5b38271609a6a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjgsMTI4XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--ca882db7ae219757a69edb16a1258ffd3425f9e8/library-upload.jpg
- small_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--d982d54ec8b4cbd7964b086ecbe5b38271609a6a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyNTYsMjU2XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--dcfbb5f9274f6fe1c9dea79e98ca851d7b66f972/library-upload.jpg
- medium_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--d982d54ec8b4cbd7964b086ecbe5b38271609a6a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls0MDAsNDAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--3eeeddc44473e17abefe3d91ceb7e1386b062651/library-upload.jpg
- large_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--d982d54ec8b4cbd7964b086ecbe5b38271609a6a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls3MjAsNzIwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--6150a09686a18d103463acd98756a4f1277d9e27/library-upload.jpg
- xlarge_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--d982d54ec8b4cbd7964b086ecbe5b38271609a6a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyMDAwLDIwMDBdLCJzYXZlciI6eyJzdHJpcCI6dHJ1ZSwicXVhbGl0eSI6NzUsImxvc3NsZXNzIjpmYWxzZSwiYWxwaGFfcSI6ODUsInJlZHVjdGlvbl9lZmZvcnQiOjYsInNtYXJ0X3N1YnNhbXBsZSI6dHJ1ZX19LCJwdXIiOiJ2YXJpYXRpb24ifX0=--918c7c1856e74f9a607b8181274909ef3b58fae5/library-upload.jpg
- og_image_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--d982d54ec8b4cbd7964b086ecbe5b38271609a6a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjAwLDYzMF0sInNhdmVyIjp7InN0cmlwIjp0cnVlLCJxdWFsaXR5Ijo3NSwibG9zc2xlc3MiOmZhbHNlLCJhbHBoYV9xIjo4NSwicmVkdWN0aW9uX2VmZm9ydCI6Niwic21hcnRfc3Vic2FtcGxlIjp0cnVlfX0sInB1ciI6InZhcmlhdGlvbiJ9fQ==--c77fcf84a0ab838daf5045f909c8a77dff682d61/library-upload.jpg
+ original_url: http://localhost:3000/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--0aa96b0c1672ab4a98f8d9aee1d20d5e590a630a/library-upload.jpg
+ mini_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--0aa96b0c1672ab4a98f8d9aee1d20d5e590a630a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjgsMTI4XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--c7cabbf4f42ac8ba67d9a91d8296f41a60806a27/library-upload.jpg
+ small_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--0aa96b0c1672ab4a98f8d9aee1d20d5e590a630a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyNTYsMjU2XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--2a76f6551b45153f6e6be558bc5934f5252e5d4b/library-upload.jpg
+ medium_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--0aa96b0c1672ab4a98f8d9aee1d20d5e590a630a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls0MDAsNDAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--70f1b4b1d65bbac19c369f6514a14b2efae9b861/library-upload.jpg
+ large_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--0aa96b0c1672ab4a98f8d9aee1d20d5e590a630a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls3MjAsNzIwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--ad2e7db00f46de1be1b1d802422591dc63cda389/library-upload.jpg
+ xlarge_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--0aa96b0c1672ab4a98f8d9aee1d20d5e590a630a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyMDAwLDIwMDBdLCJzYXZlciI6eyJzdHJpcCI6dHJ1ZSwicXVhbGl0eSI6NzUsImxvc3NsZXNzIjpmYWxzZSwiYWxwaGFfcSI6ODUsInJlZHVjdGlvbl9lZmZvcnQiOjYsInNtYXJ0X3N1YnNhbXBsZSI6dHJ1ZX19LCJwdXIiOiJ2YXJpYXRpb24ifX0=--a86d6ae04dadfd78927fab23cc51648f9edd3775/library-upload.jpg
+ og_image_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--0aa96b0c1672ab4a98f8d9aee1d20d5e590a630a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjAwLDYzMF0sInNhdmVyIjp7InN0cmlwIjp0cnVlLCJxdWFsaXR5Ijo3NSwibG9zc2xlc3MiOmZhbHNlLCJhbHBoYV9xIjo4NSwicmVkdWN0aW9uX2VmZm9ydCI6Niwic21hcnRfc3Vic2FtcGxlIjp0cnVlfX0sInB1ciI6InZhcmlhdGlvbiJ9fQ==--c0f594ef4e0298070899e42d661848fbdf32192b/library-upload.jpg
external_references: {}
created_at: '2026-01-15T12:00:00.000Z'
updated_at: '2026-01-15T12:00:00.000Z'
@@ -45148,10 +45147,10 @@ paths:
filename: library-upload.jpg
content_type: image/jpeg
byte_size: 18090
- embed_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--d982d54ec8b4cbd7964b086ecbe5b38271609a6a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2xpbWl0IjpbMTIwMCwxMjAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--e5ec1051c1f03aa144647d80dfd66d6078e08ac3/library-upload.jpg
- signed_id: eyJfcmFpbHMiOnsiZGF0YSI6MiwiZXhwIjoiMjAyNi0wMS0xNlQxMjowMDowMC4wMDBaIiwicHVyIjoiYmxvYl9pZCJ9fQ==--dba783ba37ce4cc398af3113c60f58a33e32966f
+ embed_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--0aa96b0c1672ab4a98f8d9aee1d20d5e590a630a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2xpbWl0IjpbMTIwMCwxMjAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--28f76504c18451476e04c1b0194941f513805ebe/library-upload.jpg
+ signed_id: eyJfcmFpbHMiOnsiZGF0YSI6MiwiZXhwIjoiMjAyNi0wMS0xNlQxMjowMDowMC4wMDBaIiwicHVyIjoiYmxvYl9pZCJ9fQ==--f52aea954c8b0c35d86e91416f4414376ea5c1ef
viewable_id:
- download_url: http://localhost:3000/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--d982d54ec8b4cbd7964b086ecbe5b38271609a6a/library-upload.jpg?disposition=attachment
+ download_url: http://localhost:3000/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--0aa96b0c1672ab4a98f8d9aee1d20d5e590a630a/library-upload.jpg?disposition=attachment
metadata: {}
viewable_type:
schema:
@@ -45229,13 +45228,13 @@ paths:
video_embed_url:
video_url:
poster_url:
- original_url: http://localhost:3000/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/thinking-cat.jpg
- mini_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjgsMTI4XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--ca882db7ae219757a69edb16a1258ffd3425f9e8/thinking-cat.jpg
- small_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyNTYsMjU2XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--dcfbb5f9274f6fe1c9dea79e98ca851d7b66f972/thinking-cat.jpg
- medium_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls0MDAsNDAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--3eeeddc44473e17abefe3d91ceb7e1386b062651/thinking-cat.jpg
- large_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls3MjAsNzIwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--6150a09686a18d103463acd98756a4f1277d9e27/thinking-cat.jpg
- xlarge_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyMDAwLDIwMDBdLCJzYXZlciI6eyJzdHJpcCI6dHJ1ZSwicXVhbGl0eSI6NzUsImxvc3NsZXNzIjpmYWxzZSwiYWxwaGFfcSI6ODUsInJlZHVjdGlvbl9lZmZvcnQiOjYsInNtYXJ0X3N1YnNhbXBsZSI6dHJ1ZX19LCJwdXIiOiJ2YXJpYXRpb24ifX0=--918c7c1856e74f9a607b8181274909ef3b58fae5/thinking-cat.jpg
- og_image_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjAwLDYzMF0sInNhdmVyIjp7InN0cmlwIjp0cnVlLCJxdWFsaXR5Ijo3NSwibG9zc2xlc3MiOmZhbHNlLCJhbHBoYV9xIjo4NSwicmVkdWN0aW9uX2VmZm9ydCI6Niwic21hcnRfc3Vic2FtcGxlIjp0cnVlfX0sInB1ciI6InZhcmlhdGlvbiJ9fQ==--c77fcf84a0ab838daf5045f909c8a77dff682d61/thinking-cat.jpg
+ original_url: http://localhost:3000/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/thinking-cat.jpg
+ mini_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjgsMTI4XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--c7cabbf4f42ac8ba67d9a91d8296f41a60806a27/thinking-cat.jpg
+ small_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyNTYsMjU2XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--2a76f6551b45153f6e6be558bc5934f5252e5d4b/thinking-cat.jpg
+ medium_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls0MDAsNDAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--70f1b4b1d65bbac19c369f6514a14b2efae9b861/thinking-cat.jpg
+ large_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls3MjAsNzIwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--ad2e7db00f46de1be1b1d802422591dc63cda389/thinking-cat.jpg
+ xlarge_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyMDAwLDIwMDBdLCJzYXZlciI6eyJzdHJpcCI6dHJ1ZSwicXVhbGl0eSI6NzUsImxvc3NsZXNzIjpmYWxzZSwiYWxwaGFfcSI6ODUsInJlZHVjdGlvbl9lZmZvcnQiOjYsInNtYXJ0X3N1YnNhbXBsZSI6dHJ1ZX19LCJwdXIiOiJ2YXJpYXRpb24ifX0=--a86d6ae04dadfd78927fab23cc51648f9edd3775/thinking-cat.jpg
+ og_image_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjAwLDYzMF0sInNhdmVyIjp7InN0cmlwIjp0cnVlLCJxdWFsaXR5Ijo3NSwibG9zc2xlc3MiOmZhbHNlLCJhbHBoYV9xIjo4NSwicmVkdWN0aW9uX2VmZm9ydCI6Niwic21hcnRfc3Vic2FtcGxlIjp0cnVlfX0sInB1ciI6InZhcmlhdGlvbiJ9fQ==--c0f594ef4e0298070899e42d661848fbdf32192b/thinking-cat.jpg
external_references: {}
created_at: '2026-01-15T12:00:00.000Z'
updated_at: '2026-01-15T12:00:00.000Z'
@@ -45243,10 +45242,10 @@ paths:
filename: thinking-cat.jpg
content_type: image/jpeg
byte_size: 18090
- embed_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2xpbWl0IjpbMTIwMCwxMjAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--e5ec1051c1f03aa144647d80dfd66d6078e08ac3/thinking-cat.jpg
- signed_id: eyJfcmFpbHMiOnsiZGF0YSI6MSwiZXhwIjoiMjAyNi0wMS0xNlQxMjowMDowMC4wMDBaIiwicHVyIjoiYmxvYl9pZCJ9fQ==--ee9db0d35f7a01f2e75cd6e66a7c5d973957a5c8
+ embed_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2xpbWl0IjpbMTIwMCwxMjAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--28f76504c18451476e04c1b0194941f513805ebe/thinking-cat.jpg
+ signed_id: eyJfcmFpbHMiOnsiZGF0YSI6MSwiZXhwIjoiMjAyNi0wMS0xNlQxMjowMDowMC4wMDBaIiwicHVyIjoiYmxvYl9pZCJ9fQ==--37ea8559a3ea6e9f4877608b795389de5d0a2325
viewable_id: prod_UkLWZg9DAJ
- download_url: http://localhost:3000/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/thinking-cat.jpg?disposition=attachment
+ download_url: http://localhost:3000/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/thinking-cat.jpg?disposition=attachment
metadata: {}
viewable_type: product
schema:
@@ -45480,13 +45479,13 @@ paths:
video_embed_url:
video_url:
poster_url:
- original_url: http://localhost:3000/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/thinking-cat.jpg
- mini_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjgsMTI4XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--ca882db7ae219757a69edb16a1258ffd3425f9e8/thinking-cat.jpg
- small_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyNTYsMjU2XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--dcfbb5f9274f6fe1c9dea79e98ca851d7b66f972/thinking-cat.jpg
- medium_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls0MDAsNDAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--3eeeddc44473e17abefe3d91ceb7e1386b062651/thinking-cat.jpg
- large_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls3MjAsNzIwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--6150a09686a18d103463acd98756a4f1277d9e27/thinking-cat.jpg
- xlarge_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyMDAwLDIwMDBdLCJzYXZlciI6eyJzdHJpcCI6dHJ1ZSwicXVhbGl0eSI6NzUsImxvc3NsZXNzIjpmYWxzZSwiYWxwaGFfcSI6ODUsInJlZHVjdGlvbl9lZmZvcnQiOjYsInNtYXJ0X3N1YnNhbXBsZSI6dHJ1ZX19LCJwdXIiOiJ2YXJpYXRpb24ifX0=--918c7c1856e74f9a607b8181274909ef3b58fae5/thinking-cat.jpg
- og_image_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjAwLDYzMF0sInNhdmVyIjp7InN0cmlwIjp0cnVlLCJxdWFsaXR5Ijo3NSwibG9zc2xlc3MiOmZhbHNlLCJhbHBoYV9xIjo4NSwicmVkdWN0aW9uX2VmZm9ydCI6Niwic21hcnRfc3Vic2FtcGxlIjp0cnVlfX0sInB1ciI6InZhcmlhdGlvbiJ9fQ==--c77fcf84a0ab838daf5045f909c8a77dff682d61/thinking-cat.jpg
+ original_url: http://localhost:3000/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/thinking-cat.jpg
+ mini_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjgsMTI4XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--c7cabbf4f42ac8ba67d9a91d8296f41a60806a27/thinking-cat.jpg
+ small_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyNTYsMjU2XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--2a76f6551b45153f6e6be558bc5934f5252e5d4b/thinking-cat.jpg
+ medium_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls0MDAsNDAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--70f1b4b1d65bbac19c369f6514a14b2efae9b861/thinking-cat.jpg
+ large_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls3MjAsNzIwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--ad2e7db00f46de1be1b1d802422591dc63cda389/thinking-cat.jpg
+ xlarge_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyMDAwLDIwMDBdLCJzYXZlciI6eyJzdHJpcCI6dHJ1ZSwicXVhbGl0eSI6NzUsImxvc3NsZXNzIjpmYWxzZSwiYWxwaGFfcSI6ODUsInJlZHVjdGlvbl9lZmZvcnQiOjYsInNtYXJ0X3N1YnNhbXBsZSI6dHJ1ZX19LCJwdXIiOiJ2YXJpYXRpb24ifX0=--a86d6ae04dadfd78927fab23cc51648f9edd3775/thinking-cat.jpg
+ og_image_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjAwLDYzMF0sInNhdmVyIjp7InN0cmlwIjp0cnVlLCJxdWFsaXR5Ijo3NSwibG9zc2xlc3MiOmZhbHNlLCJhbHBoYV9xIjo4NSwicmVkdWN0aW9uX2VmZm9ydCI6Niwic21hcnRfc3Vic2FtcGxlIjp0cnVlfX0sInB1ciI6InZhcmlhdGlvbiJ9fQ==--c0f594ef4e0298070899e42d661848fbdf32192b/thinking-cat.jpg
external_references: {}
created_at: '2026-01-15T12:00:00.000Z'
updated_at: '2026-01-15T12:00:00.000Z'
@@ -45494,10 +45493,10 @@ paths:
filename: thinking-cat.jpg
content_type: image/jpeg
byte_size: 18090
- embed_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2xpbWl0IjpbMTIwMCwxMjAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--e5ec1051c1f03aa144647d80dfd66d6078e08ac3/thinking-cat.jpg
- signed_id: eyJfcmFpbHMiOnsiZGF0YSI6MSwiZXhwIjoiMjAyNi0wMS0xNlQxMjowMDowMC4wMDBaIiwicHVyIjoiYmxvYl9pZCJ9fQ==--ee9db0d35f7a01f2e75cd6e66a7c5d973957a5c8
+ embed_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2xpbWl0IjpbMTIwMCwxMjAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--28f76504c18451476e04c1b0194941f513805ebe/thinking-cat.jpg
+ signed_id: eyJfcmFpbHMiOnsiZGF0YSI6MSwiZXhwIjoiMjAyNi0wMS0xNlQxMjowMDowMC4wMDBaIiwicHVyIjoiYmxvYl9pZCJ9fQ==--37ea8559a3ea6e9f4877608b795389de5d0a2325
viewable_id: prod_UkLWZg9DAJ
- download_url: http://localhost:3000/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/thinking-cat.jpg?disposition=attachment
+ download_url: http://localhost:3000/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/thinking-cat.jpg?disposition=attachment
metadata: {}
viewable_type: product
meta:
@@ -45588,13 +45587,13 @@ paths:
video_embed_url:
video_url:
poster_url:
- original_url: http://localhost:3000/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/thinking-cat.jpg
- mini_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjgsMTI4XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--ca882db7ae219757a69edb16a1258ffd3425f9e8/thinking-cat.jpg
- small_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyNTYsMjU2XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--dcfbb5f9274f6fe1c9dea79e98ca851d7b66f972/thinking-cat.jpg
- medium_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls0MDAsNDAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--3eeeddc44473e17abefe3d91ceb7e1386b062651/thinking-cat.jpg
- large_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls3MjAsNzIwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--6150a09686a18d103463acd98756a4f1277d9e27/thinking-cat.jpg
- xlarge_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyMDAwLDIwMDBdLCJzYXZlciI6eyJzdHJpcCI6dHJ1ZSwicXVhbGl0eSI6NzUsImxvc3NsZXNzIjpmYWxzZSwiYWxwaGFfcSI6ODUsInJlZHVjdGlvbl9lZmZvcnQiOjYsInNtYXJ0X3N1YnNhbXBsZSI6dHJ1ZX19LCJwdXIiOiJ2YXJpYXRpb24ifX0=--918c7c1856e74f9a607b8181274909ef3b58fae5/thinking-cat.jpg
- og_image_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjAwLDYzMF0sInNhdmVyIjp7InN0cmlwIjp0cnVlLCJxdWFsaXR5Ijo3NSwibG9zc2xlc3MiOmZhbHNlLCJhbHBoYV9xIjo4NSwicmVkdWN0aW9uX2VmZm9ydCI6Niwic21hcnRfc3Vic2FtcGxlIjp0cnVlfX0sInB1ciI6InZhcmlhdGlvbiJ9fQ==--c77fcf84a0ab838daf5045f909c8a77dff682d61/thinking-cat.jpg
+ original_url: http://localhost:3000/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/thinking-cat.jpg
+ mini_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjgsMTI4XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--c7cabbf4f42ac8ba67d9a91d8296f41a60806a27/thinking-cat.jpg
+ small_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyNTYsMjU2XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--2a76f6551b45153f6e6be558bc5934f5252e5d4b/thinking-cat.jpg
+ medium_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls0MDAsNDAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--70f1b4b1d65bbac19c369f6514a14b2efae9b861/thinking-cat.jpg
+ large_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls3MjAsNzIwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--ad2e7db00f46de1be1b1d802422591dc63cda389/thinking-cat.jpg
+ xlarge_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyMDAwLDIwMDBdLCJzYXZlciI6eyJzdHJpcCI6dHJ1ZSwicXVhbGl0eSI6NzUsImxvc3NsZXNzIjpmYWxzZSwiYWxwaGFfcSI6ODUsInJlZHVjdGlvbl9lZmZvcnQiOjYsInNtYXJ0X3N1YnNhbXBsZSI6dHJ1ZX19LCJwdXIiOiJ2YXJpYXRpb24ifX0=--a86d6ae04dadfd78927fab23cc51648f9edd3775/thinking-cat.jpg
+ og_image_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjAwLDYzMF0sInNhdmVyIjp7InN0cmlwIjp0cnVlLCJxdWFsaXR5Ijo3NSwibG9zc2xlc3MiOmZhbHNlLCJhbHBoYV9xIjo4NSwicmVkdWN0aW9uX2VmZm9ydCI6Niwic21hcnRfc3Vic2FtcGxlIjp0cnVlfX0sInB1ciI6InZhcmlhdGlvbiJ9fQ==--c0f594ef4e0298070899e42d661848fbdf32192b/thinking-cat.jpg
external_references: {}
created_at: '2026-01-15T12:00:00.000Z'
updated_at: '2026-01-15T12:00:00.000Z'
@@ -45602,10 +45601,10 @@ paths:
filename: thinking-cat.jpg
content_type: image/jpeg
byte_size: 18090
- embed_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2xpbWl0IjpbMTIwMCwxMjAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--e5ec1051c1f03aa144647d80dfd66d6078e08ac3/thinking-cat.jpg
- signed_id: eyJfcmFpbHMiOnsiZGF0YSI6MSwiZXhwIjoiMjAyNi0wMS0xNlQxMjowMDowMC4wMDBaIiwicHVyIjoiYmxvYl9pZCJ9fQ==--ee9db0d35f7a01f2e75cd6e66a7c5d973957a5c8
+ embed_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2xpbWl0IjpbMTIwMCwxMjAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--28f76504c18451476e04c1b0194941f513805ebe/thinking-cat.jpg
+ signed_id: eyJfcmFpbHMiOnsiZGF0YSI6MSwiZXhwIjoiMjAyNi0wMS0xNlQxMjowMDowMC4wMDBaIiwicHVyIjoiYmxvYl9pZCJ9fQ==--37ea8559a3ea6e9f4877608b795389de5d0a2325
viewable_id: prod_gbHJdmfrXB
- download_url: http://localhost:3000/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/thinking-cat.jpg?disposition=attachment
+ download_url: http://localhost:3000/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/thinking-cat.jpg?disposition=attachment
metadata: {}
viewable_type: product
schema:
@@ -45695,13 +45694,13 @@ paths:
video_embed_url:
video_url:
poster_url:
- original_url: http://localhost:3000/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/thinking-cat.jpg
- mini_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjgsMTI4XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--ca882db7ae219757a69edb16a1258ffd3425f9e8/thinking-cat.jpg
- small_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyNTYsMjU2XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--dcfbb5f9274f6fe1c9dea79e98ca851d7b66f972/thinking-cat.jpg
- medium_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls0MDAsNDAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--3eeeddc44473e17abefe3d91ceb7e1386b062651/thinking-cat.jpg
- large_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls3MjAsNzIwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--6150a09686a18d103463acd98756a4f1277d9e27/thinking-cat.jpg
- xlarge_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyMDAwLDIwMDBdLCJzYXZlciI6eyJzdHJpcCI6dHJ1ZSwicXVhbGl0eSI6NzUsImxvc3NsZXNzIjpmYWxzZSwiYWxwaGFfcSI6ODUsInJlZHVjdGlvbl9lZmZvcnQiOjYsInNtYXJ0X3N1YnNhbXBsZSI6dHJ1ZX19LCJwdXIiOiJ2YXJpYXRpb24ifX0=--918c7c1856e74f9a607b8181274909ef3b58fae5/thinking-cat.jpg
- og_image_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjAwLDYzMF0sInNhdmVyIjp7InN0cmlwIjp0cnVlLCJxdWFsaXR5Ijo3NSwibG9zc2xlc3MiOmZhbHNlLCJhbHBoYV9xIjo4NSwicmVkdWN0aW9uX2VmZm9ydCI6Niwic21hcnRfc3Vic2FtcGxlIjp0cnVlfX0sInB1ciI6InZhcmlhdGlvbiJ9fQ==--c77fcf84a0ab838daf5045f909c8a77dff682d61/thinking-cat.jpg
+ original_url: http://localhost:3000/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/thinking-cat.jpg
+ mini_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjgsMTI4XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--c7cabbf4f42ac8ba67d9a91d8296f41a60806a27/thinking-cat.jpg
+ small_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyNTYsMjU2XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--2a76f6551b45153f6e6be558bc5934f5252e5d4b/thinking-cat.jpg
+ medium_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls0MDAsNDAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--70f1b4b1d65bbac19c369f6514a14b2efae9b861/thinking-cat.jpg
+ large_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls3MjAsNzIwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--ad2e7db00f46de1be1b1d802422591dc63cda389/thinking-cat.jpg
+ xlarge_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyMDAwLDIwMDBdLCJzYXZlciI6eyJzdHJpcCI6dHJ1ZSwicXVhbGl0eSI6NzUsImxvc3NsZXNzIjpmYWxzZSwiYWxwaGFfcSI6ODUsInJlZHVjdGlvbl9lZmZvcnQiOjYsInNtYXJ0X3N1YnNhbXBsZSI6dHJ1ZX19LCJwdXIiOiJ2YXJpYXRpb24ifX0=--a86d6ae04dadfd78927fab23cc51648f9edd3775/thinking-cat.jpg
+ og_image_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjAwLDYzMF0sInNhdmVyIjp7InN0cmlwIjp0cnVlLCJxdWFsaXR5Ijo3NSwibG9zc2xlc3MiOmZhbHNlLCJhbHBoYV9xIjo4NSwicmVkdWN0aW9uX2VmZm9ydCI6Niwic21hcnRfc3Vic2FtcGxlIjp0cnVlfX0sInB1ciI6InZhcmlhdGlvbiJ9fQ==--c0f594ef4e0298070899e42d661848fbdf32192b/thinking-cat.jpg
external_references: {}
created_at: '2026-01-15T12:00:00.000Z'
updated_at: '2026-01-15T12:00:00.000Z'
@@ -45709,10 +45708,10 @@ paths:
filename: thinking-cat.jpg
content_type: image/jpeg
byte_size: 18090
- embed_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2xpbWl0IjpbMTIwMCwxMjAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--e5ec1051c1f03aa144647d80dfd66d6078e08ac3/thinking-cat.jpg
- signed_id: eyJfcmFpbHMiOnsiZGF0YSI6MSwiZXhwIjoiMjAyNi0wMS0xNlQxMjowMDowMC4wMDBaIiwicHVyIjoiYmxvYl9pZCJ9fQ==--ee9db0d35f7a01f2e75cd6e66a7c5d973957a5c8
+ embed_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2xpbWl0IjpbMTIwMCwxMjAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--28f76504c18451476e04c1b0194941f513805ebe/thinking-cat.jpg
+ signed_id: eyJfcmFpbHMiOnsiZGF0YSI6MSwiZXhwIjoiMjAyNi0wMS0xNlQxMjowMDowMC4wMDBaIiwicHVyIjoiYmxvYl9pZCJ9fQ==--37ea8559a3ea6e9f4877608b795389de5d0a2325
viewable_id: prod_UkLWZg9DAJ
- download_url: http://localhost:3000/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--5a57de62fd3b3c9120d3f03d009f42e16c87653d/thinking-cat.jpg?disposition=attachment
+ download_url: http://localhost:3000/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--ac7861aca8bb12054d2fd9cc61d77a69b65bfbf3/thinking-cat.jpg?disposition=attachment
metadata: {}
viewable_type: product
schema:
@@ -45864,13 +45863,13 @@ paths:
video_embed_url:
video_url:
poster_url:
- original_url: http://localhost:3000/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--d982d54ec8b4cbd7964b086ecbe5b38271609a6a/thinking-cat.jpg
- mini_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--d982d54ec8b4cbd7964b086ecbe5b38271609a6a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjgsMTI4XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--ca882db7ae219757a69edb16a1258ffd3425f9e8/thinking-cat.jpg
- small_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--d982d54ec8b4cbd7964b086ecbe5b38271609a6a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyNTYsMjU2XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--dcfbb5f9274f6fe1c9dea79e98ca851d7b66f972/thinking-cat.jpg
- medium_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--d982d54ec8b4cbd7964b086ecbe5b38271609a6a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls0MDAsNDAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--3eeeddc44473e17abefe3d91ceb7e1386b062651/thinking-cat.jpg
- large_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--d982d54ec8b4cbd7964b086ecbe5b38271609a6a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls3MjAsNzIwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--6150a09686a18d103463acd98756a4f1277d9e27/thinking-cat.jpg
- xlarge_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--d982d54ec8b4cbd7964b086ecbe5b38271609a6a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyMDAwLDIwMDBdLCJzYXZlciI6eyJzdHJpcCI6dHJ1ZSwicXVhbGl0eSI6NzUsImxvc3NsZXNzIjpmYWxzZSwiYWxwaGFfcSI6ODUsInJlZHVjdGlvbl9lZmZvcnQiOjYsInNtYXJ0X3N1YnNhbXBsZSI6dHJ1ZX19LCJwdXIiOiJ2YXJpYXRpb24ifX0=--918c7c1856e74f9a607b8181274909ef3b58fae5/thinking-cat.jpg
- og_image_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--d982d54ec8b4cbd7964b086ecbe5b38271609a6a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjAwLDYzMF0sInNhdmVyIjp7InN0cmlwIjp0cnVlLCJxdWFsaXR5Ijo3NSwibG9zc2xlc3MiOmZhbHNlLCJhbHBoYV9xIjo4NSwicmVkdWN0aW9uX2VmZm9ydCI6Niwic21hcnRfc3Vic2FtcGxlIjp0cnVlfX0sInB1ciI6InZhcmlhdGlvbiJ9fQ==--c77fcf84a0ab838daf5045f909c8a77dff682d61/thinking-cat.jpg
+ original_url: http://localhost:3000/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--0aa96b0c1672ab4a98f8d9aee1d20d5e590a630a/thinking-cat.jpg
+ mini_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--0aa96b0c1672ab4a98f8d9aee1d20d5e590a630a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjgsMTI4XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--c7cabbf4f42ac8ba67d9a91d8296f41a60806a27/thinking-cat.jpg
+ small_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--0aa96b0c1672ab4a98f8d9aee1d20d5e590a630a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyNTYsMjU2XSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--2a76f6551b45153f6e6be558bc5934f5252e5d4b/thinking-cat.jpg
+ medium_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--0aa96b0c1672ab4a98f8d9aee1d20d5e590a630a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls0MDAsNDAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--70f1b4b1d65bbac19c369f6514a14b2efae9b861/thinking-cat.jpg
+ large_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--0aa96b0c1672ab4a98f8d9aee1d20d5e590a630a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOls3MjAsNzIwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--ad2e7db00f46de1be1b1d802422591dc63cda389/thinking-cat.jpg
+ xlarge_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--0aa96b0c1672ab4a98f8d9aee1d20d5e590a630a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsyMDAwLDIwMDBdLCJzYXZlciI6eyJzdHJpcCI6dHJ1ZSwicXVhbGl0eSI6NzUsImxvc3NsZXNzIjpmYWxzZSwiYWxwaGFfcSI6ODUsInJlZHVjdGlvbl9lZmZvcnQiOjYsInNtYXJ0X3N1YnNhbXBsZSI6dHJ1ZX19LCJwdXIiOiJ2YXJpYXRpb24ifX0=--a86d6ae04dadfd78927fab23cc51648f9edd3775/thinking-cat.jpg
+ og_image_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--0aa96b0c1672ab4a98f8d9aee1d20d5e590a630a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2ZpbGwiOlsxMjAwLDYzMF0sInNhdmVyIjp7InN0cmlwIjp0cnVlLCJxdWFsaXR5Ijo3NSwibG9zc2xlc3MiOmZhbHNlLCJhbHBoYV9xIjo4NSwicmVkdWN0aW9uX2VmZm9ydCI6Niwic21hcnRfc3Vic2FtcGxlIjp0cnVlfX0sInB1ciI6InZhcmlhdGlvbiJ9fQ==--c0f594ef4e0298070899e42d661848fbdf32192b/thinking-cat.jpg
external_references: {}
created_at: '2026-01-15T12:00:00.000Z'
updated_at: '2026-01-15T12:00:00.000Z'
@@ -45878,10 +45877,10 @@ paths:
filename: thinking-cat.jpg
content_type: image/jpeg
byte_size: 18090
- embed_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--d982d54ec8b4cbd7964b086ecbe5b38271609a6a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2xpbWl0IjpbMTIwMCwxMjAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--e5ec1051c1f03aa144647d80dfd66d6078e08ac3/thinking-cat.jpg
- signed_id: eyJfcmFpbHMiOnsiZGF0YSI6MiwiZXhwIjoiMjAyNi0wMS0xNlQxMjowMDowMC4wMDBaIiwicHVyIjoiYmxvYl9pZCJ9fQ==--dba783ba37ce4cc398af3113c60f58a33e32966f
+ embed_url: http://localhost:3000/rails/active_storage/representations/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--0aa96b0c1672ab4a98f8d9aee1d20d5e590a630a/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2xpbWl0IjpbMTIwMCwxMjAwXSwic2F2ZXIiOnsic3RyaXAiOnRydWUsInF1YWxpdHkiOjc1LCJsb3NzbGVzcyI6ZmFsc2UsImFscGhhX3EiOjg1LCJyZWR1Y3Rpb25fZWZmb3J0Ijo2LCJzbWFydF9zdWJzYW1wbGUiOnRydWV9fSwicHVyIjoidmFyaWF0aW9uIn19--28f76504c18451476e04c1b0194941f513805ebe/thinking-cat.jpg
+ signed_id: eyJfcmFpbHMiOnsiZGF0YSI6MiwiZXhwIjoiMjAyNi0wMS0xNlQxMjowMDowMC4wMDBaIiwicHVyIjoiYmxvYl9pZCJ9fQ==--f52aea954c8b0c35d86e91416f4414376ea5c1ef
viewable_id: variant_gbHJdmfrXB
- download_url: http://localhost:3000/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--d982d54ec8b4cbd7964b086ecbe5b38271609a6a/thinking-cat.jpg?disposition=attachment
+ download_url: http://localhost:3000/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--0aa96b0c1672ab4a98f8d9aee1d20d5e590a630a/thinking-cat.jpg?disposition=attachment
metadata: {}
viewable_type: variant
meta:
@@ -52771,7 +52770,7 @@ paths:
content: |-
## Filters
- Filter with `q[<attribute>_<predicate>]=value`, for example `q[currency_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/admin-api/querying#which-filters-an-endpoint-accepts).
+ Filter with `q[<attribute>_<predicate>]=value`, for example `q[provider_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/admin-api/querying#which-filters-an-endpoint-accepts).
| Attribute | Kind | Predicates |
|---|---|---|
@@ -52942,7 +52941,7 @@ paths:
content: |-
## Filters
- Filter with `q[<attribute>_<predicate>]=value`, for example `q[currency_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/admin-api/querying#which-filters-an-endpoint-accepts).
+ Filter with `q[<attribute>_<predicate>]=value`, for example `q[provider_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/admin-api/querying#which-filters-an-endpoint-accepts).
| Attribute | Kind | Predicates |
|---|---|---|
@@ -75512,6 +75511,20 @@ components:
- zh-HK
- zh-TW
- zu
+ DimensionUnit:
+ type: string
+ enum:
+ - mm
+ - cm
+ - in
+ - ft
+ WeightUnit:
+ type: string
+ enum:
+ - g
+ - kg
+ - lb
+ - oz
AddressInputParams:
type: object
properties:
@@ -79126,12 +79139,8 @@ components:
type: number
nullable: true
dimensions_unit:
- type: string
- enum:
- - mm
- - cm
- - in
- - ft
+ allOf:
+ - "$ref": "#/components/schemas/DimensionUnit"
description: Unit the three dimensions are in; falls back to the store's
unit system.
example: cm
@@ -79146,12 +79155,8 @@ components:
description: What the package can hold, not the same as its own weight.
nullable: true
weight_unit:
- type: string
- enum:
- - g
- - kg
- - lb
- - oz
+ allOf:
+ - "$ref": "#/components/schemas/WeightUnit"
example: kg
nullable: true
default:
@@ -79192,12 +79197,8 @@ components:
type: number
nullable: true
dimensions_unit:
- type: string
- enum:
- - mm
- - cm
- - in
- - ft
+ allOf:
+ - "$ref": "#/components/schemas/DimensionUnit"
description: Unit the three dimensions are in; falls back to the store's
unit system.
example: cm
@@ -79212,12 +79213,8 @@ components:
description: What the package can hold, not the same as its own weight.
nullable: true
weight_unit:
- type: string
- enum:
- - g
- - kg
- - lb
- - oz
+ allOf:
+ - "$ref": "#/components/schemas/WeightUnit"
example: kg
nullable: true
default:
@@ -80200,124 +80197,12 @@ components:
lives on variants. An entry without `options` upserts onto the default
variant of a simple product; pass `id` to update an existing variant.
ProductVariantParams:
- type: object
- properties:
- id:
- type: string
- sku:
- type: string
- barcode:
- type: string
- cost_price:
- type: string
- format: decimal
- pattern: "^-?\\d+(\\.\\d+)?$"
- nullable: true
- cost_currency:
- "$ref": "#/components/schemas/CurrencyCode"
- weight:
- type: number
- nullable: true
- height:
- type: number
- nullable: true
- width:
- type: number
- nullable: true
- depth:
- type: number
- nullable: true
- weight_unit:
- type: string
- enum:
- - g
- - kg
- - lb
- - oz
- dimensions_unit:
- type: string
- enum:
- - mm
- - cm
- - in
- - ft
- hs_code:
- type: string
- customs_description:
- type: string
- country_of_origin:
- "$ref": "#/components/schemas/CountryCode"
- minimum_order_quantity:
- type: integer
- nullable: true
- order_multiple:
- type: integer
- nullable: true
- purchase_unit:
- type: string
- units_per_carton:
- type: integer
- description: How many units fill one carton.
- nullable: true
- carton_package_type_id:
- type: string
- description: 'The carton this variant is packed into: a package type of
- kind `carton`. Its dimensions are shared by every product packed the same
- way, so a corrected carton size fixes all of them at once.'
- nullable: true
- carton_weight:
- type: number
- description: What one packed carton weighs, in the variant's weight unit.
- nullable: true
- cartons_per_pallet:
- type: integer
- description: How many cartons stack on one pallet.
- nullable: true
- seller_id:
- type: string
- delivery_profile_id:
- type: string
- nullable: true
- track_inventory:
- type: boolean
- preorderable:
- type: boolean
- description: Sell this variant before it's in stock. Adds the pre-order
- label and ships-by promise; the cap comes from `backorder_limit`, an incoming
- stock count, or backorder.
- preorder_ships_at:
- type: string
- format: date-time
- description: The "ships by" date shown to customers while the variant is
- a pre-order. Once it passes, the variant is no longer a pre-order. Null
- clears it.
- nullable: true
- backorder_limit:
- type: integer
- description: Maximum units sellable beyond available stock, capping backorders
- and pre-orders. Null is unlimited.
- nullable: true
- tax_category_id:
- type: string
- position:
- type: integer
- prices:
- type: array
- items:
- "$ref": "#/components/schemas/PriceParams"
- description: Per-currency prices. Upserted by currency.
- stock_levels:
- type: array
- items:
- "$ref": "#/components/schemas/StockLevelParams"
- description: Stock per location. Upserted by location; omitted locations
- are removed.
- options:
- type: array
- items:
- "$ref": "#/components/schemas/VariantOptionParams"
- description: One pair per option type the variant takes part in (size, color).
- Option types and values are created when missing.
+ allOf:
+ - "$ref": "#/components/schemas/VariantParams"
+ - type: object
+ properties:
+ id:
+ type: string
PromotionActionCalculatorParams:
type: object
properties:
@@ -81903,12 +81788,7 @@ components:
type: string
example: Europe/Berlin
weight_unit:
- type: string
- enum:
- - g
- - kg
- - lb
- - oz
+ "$ref": "#/components/schemas/WeightUnit"
unit_system:
type: string
enum:
@@ -82511,132 +82391,27 @@ components:
required:
- translations
VariantCreateParams:
- type: object
- properties:
- external_references:
- type: object
- additionalProperties: true
- description: 'Identities the record has in external systems, keyed by system:
- the same `{ system: external_id }` map the Admin API renders, so what
- you read can be sent straight back. Systems you do not name keep the reference
- they have. A list of `{ system, external_id }` entries is accepted too.'
- sku:
- type: string
- barcode:
- type: string
- cost_price:
- type: string
- format: decimal
- pattern: "^-?\\d+(\\.\\d+)?$"
- nullable: true
- cost_currency:
- "$ref": "#/components/schemas/CurrencyCode"
- weight:
- type: number
- nullable: true
- height:
- type: number
- nullable: true
- width:
- type: number
- nullable: true
- depth:
- type: number
- nullable: true
- weight_unit:
- type: string
- enum:
- - g
- - kg
- - lb
- - oz
- dimensions_unit:
- type: string
- enum:
- - mm
- - cm
- - in
- - ft
- hs_code:
- type: string
- customs_description:
- type: string
- country_of_origin:
- "$ref": "#/components/schemas/CountryCode"
- minimum_order_quantity:
- type: integer
- nullable: true
- order_multiple:
- type: integer
- nullable: true
- purchase_unit:
- type: string
- units_per_carton:
- type: integer
- description: How many units fill one carton.
- nullable: true
- carton_package_type_id:
- type: string
- description: 'The carton this variant is packed into: a package type of
- kind `carton`. Its dimensions are shared by every product packed the same
- way, so a corrected carton size fixes all of them at once.'
- nullable: true
- carton_weight:
- type: number
- description: What one packed carton weighs, in the variant's weight unit.
- nullable: true
- cartons_per_pallet:
- type: integer
- description: How many cartons stack on one pallet.
- nullable: true
- seller_id:
- type: string
- delivery_profile_id:
- type: string
- nullable: true
- track_inventory:
- type: boolean
- preorderable:
- type: boolean
- description: Sell this variant before it's in stock. Adds the pre-order
- label and ships-by promise; the cap comes from `backorder_limit`, an incoming
- stock count, or backorder.
- preorder_ships_at:
- type: string
- format: date-time
- description: The "ships by" date shown to customers while the variant is
- a pre-order. Once it passes, the variant is no longer a pre-order. Null
- clears it.
- nullable: true
- backorder_limit:
- type: integer
- description: Maximum units sellable beyond available stock, capping backorders
- and pre-orders. Null is unlimited.
- nullable: true
- tax_category_id:
- type: string
- position:
- type: integer
- prices:
- type: array
- items:
- "$ref": "#/components/schemas/PriceParams"
- description: Per-currency prices. Upserted by currency.
- stock_levels:
- type: array
- items:
- "$ref": "#/components/schemas/StockLevelParams"
- description: Stock per location. Upserted by location; omitted locations
- are removed.
- options:
- type: array
- items:
- "$ref": "#/components/schemas/VariantOptionParams"
- description: One pair per option type the variant takes part in (size, color).
- Option types and values are created when missing. On update, omit to leave
- the option values untouched.
- required:
- - options
+ allOf:
+ - "$ref": "#/components/schemas/VariantParams"
+ - type: object
+ properties:
+ options:
+ type: array
+ items:
+ "$ref": "#/components/schemas/VariantOptionParams"
+ description: One pair per option type the variant takes part in (size,
+ color). Option types and values are created when missing. On update,
+ omit to leave the option values untouched.
+ external_references:
+ type: object
+ additionalProperties: true
+ description: 'Identities the record has in external systems, keyed by
+ system: the same `{ system: external_id }` map the Admin API renders,
+ so what you read can be sent straight back. Systems you do not name
+ keep the reference they have. A list of `{ system, external_id }` entries
+ is accepted too.'
+ required:
+ - options
VariantOptionParams:
type: object
properties:
@@ -82649,16 +82424,9 @@ components:
required:
- name
- value
- VariantUpdateParams:
+ VariantParams:
type: object
properties:
- external_references:
- type: object
- additionalProperties: true
- description: 'Identities the record has in external systems, keyed by system:
- the same `{ system: external_id }` map the Admin API renders, so what
- you read can be sent straight back. Systems you do not name keep the reference
- they have. A list of `{ system, external_id }` entries is accepted too.'
sku:
type: string
barcode:
@@ -82683,19 +82451,15 @@ components:
type: number
nullable: true
weight_unit:
- type: string
- enum:
- - g
- - kg
- - lb
- - oz
+ allOf:
+ - "$ref": "#/components/schemas/WeightUnit"
+ description: Null falls back to the store's weight unit.
+ nullable: true
dimensions_unit:
- type: string
- enum:
- - mm
- - cm
- - in
- - ft
+ allOf:
+ - "$ref": "#/components/schemas/DimensionUnit"
+ description: Null falls back to the store's unit system.
+ nullable: true
hs_code:
type: string
customs_description:
@@ -82710,6 +82474,10 @@ components:
nullable: true
purchase_unit:
type: string
+ enum:
+ - unit
+ - carton
+ nullable: true
units_per_carton:
type: integer
description: How many units fill one carton.
@@ -82728,11 +82496,6 @@ components:
type: integer
description: How many cartons stack on one pallet.
nullable: true
- seller_id:
- type: string
- delivery_profile_id:
- type: string
- nullable: true
track_inventory:
type: boolean
preorderable:
@@ -82752,10 +82515,21 @@ components:
description: Maximum units sellable beyond available stock, capping backorders
and pre-orders. Null is unlimited.
nullable: true
- tax_category_id:
- type: string
position:
type: integer
+ options:
+ type: array
+ items:
+ "$ref": "#/components/schemas/VariantOptionParams"
+ description: One pair per option type the variant takes part in (size, color).
+ Option types and values are created when missing.
+ seller_id:
+ type: string
+ delivery_profile_id:
+ type: string
+ nullable: true
+ tax_category_id:
+ type: string
prices:
type: array
items:
@@ -82767,13 +82541,26 @@ components:
"$ref": "#/components/schemas/StockLevelParams"
description: Stock per location. Upserted by location; omitted locations
are removed.
- options:
- type: array
- items:
- "$ref": "#/components/schemas/VariantOptionParams"
- description: One pair per option type the variant takes part in (size, color).
- Option types and values are created when missing. On update, omit to leave
- the option values untouched.
+ VariantUpdateParams:
+ allOf:
+ - "$ref": "#/components/schemas/VariantParams"
+ - type: object
+ properties:
+ options:
+ type: array
+ items:
+ "$ref": "#/components/schemas/VariantOptionParams"
+ description: One pair per option type the variant takes part in (size,
+ color). Option types and values are created when missing. On update,
+ omit to leave the option values untouched.
+ external_references:
+ type: object
+ additionalProperties: true
+ description: 'Identities the record has in external systems, keyed by
+ system: the same `{ system: external_id }` map the Admin API renders,
+ so what you read can be sent straight back. Systems you do not name
+ keep the reference they have. A list of `{ system, external_id }` entries
+ is accepted too.'
WebhookEndpointCreateParams:
type: object
properties:
diff --git a/docs/api-reference/seller.yaml b/docs/api-reference/seller.yaml
index 55b380c09a..d2850fc216 100644
--- a/docs/api-reference/seller.yaml
+++ b/docs/api-reference/seller.yaml
@@ -108,7 +108,7 @@ paths:
selected_locale:
sellers:
- id: sel_UkLWZg9DAJ
- name: Seller 2
+ name: Seller 6
status: approved
schema:
"$ref": "#/components/schemas/AuthResponse"
@@ -171,7 +171,7 @@ paths:
selected_locale:
sellers:
- id: sel_UkLWZg9DAJ
- name: Seller 4
+ name: Seller 8
status: approved
schema:
"$ref": "#/components/schemas/AuthResponse"
@@ -365,7 +365,7 @@ paths:
selected_locale:
sellers:
- id: sel_UkLWZg9DAJ
- name: Seller 75
+ name: Seller 79
status: approved
schema:
"$ref": "#/components/schemas/AuthResponse"
@@ -487,7 +487,7 @@ paths:
selected_locale:
sellers:
- id: sel_UkLWZg9DAJ
- name: Seller 113
+ name: Seller 117
status: approved
schema:
"$ref": "#/components/schemas/AuthResponse"
@@ -560,8 +560,8 @@ paths:
selected_locale:
sellers:
- id: sel_UkLWZg9DAJ
- name: Seller 85
- slug: seller-85
+ name: Seller 89
+ slug: seller-89
status: approved
permissions:
- allow: true
@@ -831,8 +831,8 @@ paths:
selected_locale:
sellers:
- id: sel_UkLWZg9DAJ
- name: Seller 87
- slug: seller-87
+ name: Seller 91
+ slug: seller-91
status: approved
permissions: []
permission_keys: []
@@ -14172,8 +14172,8 @@ paths:
example:
data:
- id: prod_UkLWZg9DAJ
- name: Product 2793250
- slug: product-2793250
+ name: Product 2823250
+ slug: product-2823250
meta_title:
meta_description:
meta_keywords:
@@ -14386,8 +14386,8 @@ paths:
application/json:
example:
id: prod_UkLWZg9DAJ
- name: Product 2826710
- slug: product-2826710
+ name: Product 2856710
+ slug: product-2856710
meta_title:
meta_description:
meta_keywords:
@@ -14477,7 +14477,7 @@ paths:
example:
id: prod_UkLWZg9DAJ
name: Hand-thrown mug, large
- slug: product-2858212
+ slug: product-2888212
meta_title:
meta_description:
meta_keywords:
@@ -14600,8 +14600,8 @@ paths:
application/json:
example:
id: prod_gbHJdmfrXB
- name: Product 2887816
- slug: product-2887816
+ name: Product 2917816
+ slug: product-2917816
meta_title:
meta_description:
meta_keywords:
@@ -14711,8 +14711,8 @@ paths:
application/json:
example:
id: prod_UkLWZg9DAJ
- name: Product 290209
- slug: product-290209
+ name: Product 293209
+ slug: product-293209
meta_title:
meta_description:
meta_keywords:
@@ -14801,8 +14801,8 @@ paths:
application/json:
example:
id: prod_UkLWZg9DAJ
- name: Product 2919405
- slug: product-2919405
+ name: Product 2949405
+ slug: product-2949405
meta_title:
meta_description:
meta_keywords:
@@ -15020,8 +15020,8 @@ paths:
application/json:
example:
id: sel_UkLWZg9DAJ
- name: Seller 140
- slug: seller-140
+ name: Seller 144
+ slug: seller-144
about: ''
about_html: ''
logo_url:
@@ -15111,7 +15111,7 @@ paths:
example:
id: sel_UkLWZg9DAJ
name: Acme Supplies
- slug: seller-142
+ slug: seller-146
about: ''
about_html: ''
logo_url:
@@ -15990,7 +15990,7 @@ paths:
content:
application/json:
example:
- signed_id: eyJfcmFpbHMiOnsiZGF0YSI6MSwiZXhwIjoiMjAyNi0wMS0xNlQxMjowMDowMC4wMDBaIiwicHVyIjoiYmxvYl9pZCJ9fQ==--e3e622807fc2a4cbaf839915644236c074b14c7b
+ signed_id: eyJfcmFpbHMiOnsiZGF0YSI6MSwiZXhwIjoiMjAyNi0wMS0xNlQxMjowMDowMC4wMDBaIiwicHVyIjoiYmxvYl9pZCJ9fQ==--37ea8559a3ea6e9f4877608b795389de5d0a2325
filename: registration.pdf
content_type: application/pdf
byte_size: 51234
@@ -15998,7 +15998,7 @@ paths:
expires_at: '2026-01-16T12:00:00.000Z'
upload:
method: PUT
- url: http://www.example.com/rails/active_storage/disk/eyJfcmFpbHMiOnsiZGF0YSI6eyJrZXkiOiI4NDFrenlvbTQ5cnRhcDk0cmZxbGV6dnM1cGJsIiwiY29udGVudF90eXBlIjoiYXBwbGljYXRpb24vcGRmIiwiY29udGVudF9sZW5ndGgiOjUxMjM0LCJjaGVja3N1bSI6IlZqaHowNGxRdUVHdXY0bkR2aHNhTlE9PSIsInNlcnZpY2VfbmFtZSI6InRlc3QifSwiZXhwIjoiMjAyNi0wMS0xNVQxMjowNTowMC4wMDBaIiwicHVyIjoiYmxvYl90b2tlbiJ9fQ==--5d9d0b86e73fd398b0da66a7fd3ed0f444c4c192
+ url: http://www.example.com/rails/active_storage/disk/eyJfcmFpbHMiOnsiZGF0YSI6eyJrZXkiOiI4NDFrenlvbTQ5cnRhcDk0cmZxbGV6dnM1cGJsIiwiY29udGVudF90eXBlIjoiYXBwbGljYXRpb24vcGRmIiwiY29udGVudF9sZW5ndGgiOjUxMjM0LCJjaGVja3N1bSI6IlZqaHowNGxRdUVHdXY0bkR2aHNhTlE9PSIsInNlcnZpY2VfbmFtZSI6InRlc3QifSwiZXhwIjoiMjAyNi0wMS0xNVQxMjowNTowMC4wMDBaIiwicHVyIjoiYmxvYl90b2tlbiJ9fQ==--db026124d00ca5e74d7fe8d3b919aaf931a505f7
headers:
Content-Type: application/pdf
schema:
@@ -17461,8 +17461,8 @@ paths:
quantity: 1
line_item_id: li_UkLWZg9DAJ
variant_id: variant_UkLWZg9DAJ
- name: Product 2479315
- sku: SKU-331
+ name: Product 2509315
+ sku: SKU-334
options_text: ''
selected_delivery_rate_id: dr_gbHJdmfrXB
delivery_rates:
@@ -17584,8 +17584,8 @@ paths:
quantity: 1
line_item_id: li_UkLWZg9DAJ
variant_id: variant_UkLWZg9DAJ
- name: Product 248961
- sku: SKU-332
+ name: Product 251961
+ sku: SKU-335
options_text: ''
selected_delivery_rate_id: dr_gbHJdmfrXB
delivery_rates:
@@ -17682,8 +17682,8 @@ paths:
quantity: 1
line_item_id: li_UkLWZg9DAJ
variant_id: variant_UkLWZg9DAJ
- name: Product 2492065
- sku: SKU-333
+ name: Product 2522065
+ sku: SKU-336
options_text: ''
selected_delivery_rate_id: dr_gbHJdmfrXB
delivery_rates:
@@ -17768,8 +17768,8 @@ paths:
quantity: 1
line_item_id: li_UkLWZg9DAJ
variant_id: variant_UkLWZg9DAJ
- name: Product 2503170
- sku: SKU-334
+ name: Product 2533170
+ sku: SKU-337
options_text: ''
selected_delivery_rate_id: dr_gbHJdmfrXB
delivery_rates:
@@ -17868,8 +17868,8 @@ paths:
quantity: 1
line_item_id: li_UkLWZg9DAJ
variant_id: variant_UkLWZg9DAJ
- name: Product 2517276
- sku: SKU-335
+ name: Product 2547276
+ sku: SKU-338
options_text: ''
selected_delivery_rate_id: dr_gbHJdmfrXB
delivery_rates:
@@ -17971,8 +17971,8 @@ paths:
quantity: 1
line_item_id: li_gbHJdmfrXB
variant_id: variant_gbHJdmfrXB
- name: Product 2531765
- sku: SKU-337
+ name: Product 2561765
+ sku: SKU-340
options_text: ''
selected_delivery_rate_id: dr_EfhxLZ9ck8
delivery_rates:
@@ -18017,8 +18017,8 @@ paths:
quantity: 1
line_item_id: li_UkLWZg9DAJ
variant_id: variant_UkLWZg9DAJ
- name: Product 2523520
- sku: SKU-336
+ name: Product 2553520
+ sku: SKU-339
options_text: ''
selected_delivery_rate_id: dr_VqXmZF31wY
delivery_rates:
@@ -20763,7 +20763,7 @@ paths:
cancel_note:
items:
- id: li_UkLWZg9DAJ
- name: Product 26595
+ name: Product 26895
options_text: ''
quantity: 1
currency: USD
@@ -20772,7 +20772,7 @@ paths:
additional_tax_total: '0.00'
total: '10.00'
variant_id: variant_UkLWZg9DAJ
- sku: SKU-349
+ sku: SKU-352
thumbnail_url:
fulfillments:
- id: ful_UkLWZg9DAJ
@@ -20793,8 +20793,8 @@ paths:
quantity: 1
line_item_id: li_UkLWZg9DAJ
variant_id: variant_UkLWZg9DAJ
- name: Product 26595
- sku: SKU-349
+ name: Product 26895
+ sku: SKU-352
options_text: ''
selected_delivery_rate_id: dr_gbHJdmfrXB
delivery_rates:
@@ -20959,7 +20959,7 @@ paths:
cancel_note:
items:
- id: li_UkLWZg9DAJ
- name: Product 2669755
+ name: Product 2699755
options_text: ''
quantity: 1
currency: USD
@@ -20968,7 +20968,7 @@ paths:
additional_tax_total: '0.00'
total: '10.00'
variant_id: variant_UkLWZg9DAJ
- sku: SKU-350
+ sku: SKU-353
thumbnail_url:
fulfillments:
- id: ful_UkLWZg9DAJ
@@ -20989,8 +20989,8 @@ paths:
quantity: 1
line_item_id: li_UkLWZg9DAJ
variant_id: variant_UkLWZg9DAJ
- name: Product 2669755
- sku: SKU-350
+ name: Product 2699755
+ sku: SKU-353
options_text: ''
selected_delivery_rate_id: dr_gbHJdmfrXB
delivery_rates:
@@ -21155,7 +21155,7 @@ paths:
cancel_note:
items:
- id: li_UkLWZg9DAJ
- name: Product 2696554
+ name: Product 2726554
options_text: ''
quantity: 1
currency: USD
@@ -21164,7 +21164,7 @@ paths:
additional_tax_total: '0.00'
total: '10.00'
variant_id: variant_UkLWZg9DAJ
- sku: SKU-353
+ sku: SKU-356
thumbnail_url:
fulfillments:
- id: ful_UkLWZg9DAJ
@@ -21185,8 +21185,8 @@ paths:
quantity: 1
line_item_id: li_UkLWZg9DAJ
variant_id: variant_UkLWZg9DAJ
- name: Product 2696554
- sku: SKU-353
+ name: Product 2726554
+ sku: SKU-356
options_text: ''
selected_delivery_rate_id: dr_gbHJdmfrXB
delivery_rates:
@@ -21341,7 +21341,7 @@ paths:
cancel_note:
items:
- id: li_UkLWZg9DAJ
- name: Product 2705038
+ name: Product 2735038
options_text: ''
quantity: 1
currency: USD
@@ -21350,7 +21350,7 @@ paths:
additional_tax_total: '0.00'
total: '10.00'
variant_id: variant_UkLWZg9DAJ
- sku: SKU-354
+ sku: SKU-357
thumbnail_url:
fulfillments:
- id: ful_UkLWZg9DAJ
@@ -21371,8 +21371,8 @@ paths:
quantity: 1
line_item_id: li_UkLWZg9DAJ
variant_id: variant_UkLWZg9DAJ
- name: Product 2705038
- sku: SKU-354
+ name: Product 2735038
+ sku: SKU-357
options_text: ''
selected_delivery_rate_id: dr_gbHJdmfrXB
delivery_rates:
@@ -21534,7 +21534,7 @@ paths:
cancel_note:
items:
- id: li_UkLWZg9DAJ
- name: Product 2723962
+ name: Product 2753962
options_text: ''
quantity: 1
currency: USD
@@ -21543,7 +21543,7 @@ paths:
additional_tax_total: '0.00'
total: '10.00'
variant_id: variant_UkLWZg9DAJ
- sku: SKU-356
+ sku: SKU-359
thumbnail_url:
fulfillments:
- id: ful_UkLWZg9DAJ
@@ -21564,8 +21564,8 @@ paths:
quantity: 1
line_item_id: li_UkLWZg9DAJ
variant_id: variant_UkLWZg9DAJ
- name: Product 2723962
- sku: SKU-356
+ name: Product 2753962
+ sku: SKU-359
options_text: ''
selected_delivery_rate_id: dr_gbHJdmfrXB
delivery_rates:
@@ -21704,7 +21704,7 @@ paths:
cancel_note:
items:
- id: li_UkLWZg9DAJ
- name: Product 2735749
+ name: Product 2765749
options_text: ''
quantity: 1
currency: USD
@@ -21713,7 +21713,7 @@ paths:
additional_tax_total: '0.00'
total: '10.00'
variant_id: variant_UkLWZg9DAJ
- sku: SKU-357
+ sku: SKU-360
thumbnail_url:
fulfillments:
- id: ful_UkLWZg9DAJ
@@ -21734,8 +21734,8 @@ paths:
quantity: 1
line_item_id: li_UkLWZg9DAJ
variant_id: variant_UkLWZg9DAJ
- name: Product 2735749
- sku: SKU-357
+ name: Product 2765749
+ sku: SKU-360
options_text: ''
selected_delivery_rate_id: dr_gbHJdmfrXB
delivery_rates:
@@ -22391,7 +22391,7 @@ paths:
content: |-
## Filters
- Filter with `q[<attribute>_<predicate>]=value`, for example `q[currency_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/admin-api/querying#which-filters-an-endpoint-accepts).
+ Filter with `q[<attribute>_<predicate>]=value`, for example `q[provider_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/admin-api/querying#which-filters-an-endpoint-accepts).
| Attribute | Kind | Predicates |
|---|---|---|
@@ -22710,7 +22710,7 @@ paths:
example:
error:
code: processing_error
- message: Only 1 of Product 2987120 can be returned
+ message: Only 1 of Product 3017120 can be returned
requestBody:
content:
application/json:
@@ -23504,7 +23504,7 @@ paths:
content: |-
## Filters
- Filter with `q[<attribute>_<predicate>]=value`, for example `q[currency_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/admin-api/querying#which-filters-an-endpoint-accepts).
+ Filter with `q[<attribute>_<predicate>]=value`, for example `q[provider_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/admin-api/querying#which-filters-an-endpoint-accepts).
| Attribute | Kind | Predicates |
|---|---|---|
@@ -31119,6 +31119,20 @@ components:
- ZA
- ZM
- ZW
+ DimensionUnit:
+ type: string
+ enum:
+ - mm
+ - cm
+ - in
+ - ft
+ WeightUnit:
+ type: string
+ enum:
+ - g
+ - kg
+ - lb
+ - oz
AccountUpdateParams:
type: object
properties:
@@ -31720,12 +31734,8 @@ components:
type: number
nullable: true
dimensions_unit:
- type: string
- enum:
- - mm
- - cm
- - in
- - ft
+ allOf:
+ - "$ref": "#/components/schemas/DimensionUnit"
nullable: true
weight:
type: number
@@ -31735,12 +31745,8 @@ components:
type: number
nullable: true
weight_unit:
- type: string
- enum:
- - g
- - kg
- - lb
- - oz
+ allOf:
+ - "$ref": "#/components/schemas/WeightUnit"
nullable: true
default:
type: boolean
@@ -31775,12 +31781,8 @@ components:
type: number
nullable: true
dimensions_unit:
- type: string
- enum:
- - mm
- - cm
- - in
- - ft
+ allOf:
+ - "$ref": "#/components/schemas/DimensionUnit"
nullable: true
weight:
type: number
@@ -31790,12 +31792,8 @@ components:
type: number
nullable: true
weight_unit:
- type: string
- enum:
- - g
- - kg
- - lb
- - oz
+ allOf:
+ - "$ref": "#/components/schemas/WeightUnit"
nullable: true
default:
type: boolean
@@ -31973,7 +31971,7 @@ components:
variants:
type: array
items:
- "$ref": "#/components/schemas/SellerProductVariantParams"
+ "$ref": "#/components/schemas/ProductVariantParams"
description: 'The variants, as a whole: one absent from the list is removed.
Pass `id` to update an existing variant.'
required:
@@ -32045,9 +32043,16 @@ components:
variants:
type: array
items:
- "$ref": "#/components/schemas/SellerProductVariantParams"
+ "$ref": "#/components/schemas/ProductVariantParams"
description: 'The variants, as a whole: one absent from the list is removed.
Pass `id` to update an existing variant.'
+ ProductVariantParams:
+ allOf:
+ - "$ref": "#/components/schemas/VariantParams"
+ - type: object
+ properties:
+ id:
+ type: string
ProfileUpdateParams:
type: object
properties:
@@ -32284,134 +32289,6 @@ components:
type: string
description: Replaces the variants this media is linked to. An empty list
clears them.
- SellerProductVariantParams:
- type: object
- properties:
- id:
- type: string
- sku:
- type: string
- barcode:
- type: string
- cost_price:
- type: string
- format: decimal
- pattern: "^-?\\d+(\\.\\d+)?$"
- nullable: true
- cost_currency:
- "$ref": "#/components/schemas/CurrencyCode"
- weight:
- type: number
- nullable: true
- height:
- type: number
- nullable: true
- width:
- type: number
- nullable: true
- depth:
- type: number
- nullable: true
- weight_unit:
- type: string
- enum:
- - g
- - kg
- - lb
- - oz
- dimensions_unit:
- type: string
- enum:
- - mm
- - cm
- - in
- - ft
- hs_code:
- type: string
- customs_description:
- type: string
- country_of_origin:
- "$ref": "#/components/schemas/CountryCode"
- minimum_order_quantity:
- type: integer
- nullable: true
- order_multiple:
- type: integer
- nullable: true
- purchase_unit:
- type: string
- units_per_carton:
- type: integer
- description: How many units fill one carton.
- nullable: true
- carton_package_type_id:
- type: string
- description: 'The carton this variant is packed into: a package type of
- kind `carton`.'
- nullable: true
- carton_weight:
- type: number
- description: What one packed carton weighs, in the variant's weight unit.
- nullable: true
- cartons_per_pallet:
- type: integer
- description: How many cartons stack on one pallet.
- nullable: true
- track_inventory:
- type: boolean
- preorderable:
- type: boolean
- preorder_ships_at:
- type: string
- format: date-time
- description: The "ships by" date shown to customers while the variant is
- a pre-order. Null clears it.
- nullable: true
- backorder_limit:
- type: integer
- description: Maximum units sellable beyond available stock, capping backorders
- and pre-orders. Null is unlimited.
- nullable: true
- position:
- type: integer
- options:
- type: array
- items:
- "$ref": "#/components/schemas/VariantOptionParams"
- description: One pair per option type the variant takes part in (size, color).
- prices:
- type: array
- items:
- type: object
- properties:
- currency:
- allOf:
- - "$ref": "#/components/schemas/CurrencyCode"
- description: Omit to price in the store's currency. A seller has no
- currency of their own.
- example: USD
- amount:
- type: string
- format: decimal
- pattern: "^-?\\d+(\\.\\d+)?$"
- description: 'A canonical decimal string (`"1234.56"`: period decimal,
- no grouping). The API does not parse localized input.'
- example: '24.00'
- compare_at_amount:
- type: string
- format: decimal
- pattern: "^-?\\d+(\\.\\d+)?$"
- example: '30.00'
- nullable: true
- required:
- - amount
- description: Per-currency prices. Upserted by currency.
- stock_levels:
- type: array
- items:
- "$ref": "#/components/schemas/StockLevelParams"
- description: 'Stock per location, at this seller''s own locations only:
- a location belonging to anyone else is ignored.'
SellerTaxIdentifierCreateParams:
type: object
properties:
@@ -32686,6 +32563,138 @@ components:
required:
- name
- value
+ VariantParams:
+ type: object
+ properties:
+ sku:
+ type: string
+ barcode:
+ type: string
+ cost_price:
+ type: string
+ format: decimal
+ pattern: "^-?\\d+(\\.\\d+)?$"
+ nullable: true
+ cost_currency:
+ "$ref": "#/components/schemas/CurrencyCode"
+ weight:
+ type: number
+ nullable: true
+ height:
+ type: number
+ nullable: true
+ width:
+ type: number
+ nullable: true
+ depth:
+ type: number
+ nullable: true
+ weight_unit:
+ allOf:
+ - "$ref": "#/components/schemas/WeightUnit"
+ description: Null falls back to the store's weight unit.
+ nullable: true
+ dimensions_unit:
+ allOf:
+ - "$ref": "#/components/schemas/DimensionUnit"
+ description: Null falls back to the store's unit system.
+ nullable: true
+ hs_code:
+ type: string
+ customs_description:
+ type: string
+ country_of_origin:
+ "$ref": "#/components/schemas/CountryCode"
+ minimum_order_quantity:
+ type: integer
+ nullable: true
+ order_multiple:
+ type: integer
+ nullable: true
+ purchase_unit:
+ type: string
+ enum:
+ - unit
+ - carton
+ nullable: true
+ units_per_carton:
+ type: integer
+ description: How many units fill one carton.
+ nullable: true
+ carton_package_type_id:
+ type: string
+ description: 'The carton this variant is packed into: a package type of
+ kind `carton`. Its dimensions are shared by every product packed the same
+ way, so a corrected carton size fixes all of them at once.'
+ nullable: true
+ carton_weight:
+ type: number
+ description: What one packed carton weighs, in the variant's weight unit.
+ nullable: true
+ cartons_per_pallet:
+ type: integer
+ description: How many cartons stack on one pallet.
+ nullable: true
+ track_inventory:
+ type: boolean
+ preorderable:
+ type: boolean
+ description: Sell this variant before it's in stock. Adds the pre-order
+ label and ships-by promise; the cap comes from `backorder_limit`, an incoming
+ stock count, or backorder.
+ preorder_ships_at:
+ type: string
+ format: date-time
+ description: The "ships by" date shown to customers while the variant is
+ a pre-order. Once it passes, the variant is no longer a pre-order. Null
+ clears it.
+ nullable: true
+ backorder_limit:
+ type: integer
+ description: Maximum units sellable beyond available stock, capping backorders
+ and pre-orders. Null is unlimited.
+ nullable: true
+ position:
+ type: integer
+ options:
+ type: array
+ items:
+ "$ref": "#/components/schemas/VariantOptionParams"
+ description: One pair per option type the variant takes part in (size, color).
+ Option types and values are created when missing.
+ prices:
+ type: array
+ items:
+ type: object
+ properties:
+ currency:
+ allOf:
+ - "$ref": "#/components/schemas/CurrencyCode"
+ description: Omit to price in the store's currency. A seller has no
+ currency of their own.
+ example: USD
+ amount:
+ type: string
+ format: decimal
+ pattern: "^-?\\d+(\\.\\d+)?$"
+ description: 'A canonical decimal string (`"1234.56"`: period decimal,
+ no grouping). The API does not parse localized input.'
+ example: '24.00'
+ compare_at_amount:
+ type: string
+ format: decimal
+ pattern: "^-?\\d+(\\.\\d+)?$"
+ example: '30.00'
+ nullable: true
+ required:
+ - amount
+ description: Per-currency prices. Upserted by currency.
+ stock_levels:
+ type: array
+ items:
+ "$ref": "#/components/schemas/StockLevelParams"
+ description: 'Stock per location, at this seller''s own locations only:
+ a location belonging to anyone else is ignored.'
x-spree-filter-tables:
Claim:
attributes:
diff --git a/docs/api-reference/store.yaml b/docs/api-reference/store.yaml
index fe6a5f045b..475008d880 100644
--- a/docs/api-reference/store.yaml
+++ b/docs/api-reference/store.yaml
@@ -1097,8 +1097,8 @@ paths:
example:
data:
- id: prod_UkLWZg9DAJ
- name: Product 3406979
- slug: product-3406979
+ name: Product 3436979
+ slug: product-3436979
meta_title:
meta_description:
meta_keywords:
@@ -1390,8 +1390,8 @@ paths:
example:
data:
- id: prod_UkLWZg9DAJ
- name: Product 3889085
- slug: product-3889085
+ name: Product 3919085
+ slug: product-3919085
meta_title:
meta_description:
meta_keywords:
@@ -1422,8 +1422,8 @@ paths:
original_price:
seller_id:
- id: prod_gbHJdmfrXB
- name: Product 3898209
- slug: product-3898209
+ name: Product 3928209
+ slug: product-3928209
meta_title:
meta_description:
meta_keywords:
@@ -1552,8 +1552,8 @@ paths:
application/json:
example:
id: prod_UkLWZg9DAJ
- name: Product 4166885
- slug: product-4166885
+ name: Product 4196885
+ slug: product-4196885
meta_title:
meta_description:
meta_keywords:
@@ -1946,7 +1946,7 @@ paths:
content:
application/json:
example:
- signed_id: eyJfcmFpbHMiOnsiZGF0YSI6MSwiZXhwIjoiMjAyNi0wMS0xNlQxMjowMDowMC4wMDBaIiwicHVyIjoiYmxvYl9pZCJ9fQ==--e3e622807fc2a4cbaf839915644236c074b14c7b
+ signed_id: eyJfcmFpbHMiOnsiZGF0YSI6MSwiZXhwIjoiMjAyNi0wMS0xNlQxMjowMDowMC4wMDBaIiwicHVyIjoiYmxvYl9pZCJ9fQ==--37ea8559a3ea6e9f4877608b795389de5d0a2325
filename: purchase-order.pdf
content_type: application/pdf
byte_size: 48210
@@ -1954,7 +1954,7 @@ paths:
expires_at: '2026-01-16T12:00:00.000Z'
upload:
method: PUT
- url: http://www.example.com/rails/active_storage/disk/eyJfcmFpbHMiOnsiZGF0YSI6eyJrZXkiOiIwc3NuNW5kM3RneWtwcWJndXdybGprZjNwbjc4IiwiY29udGVudF90eXBlIjoiYXBwbGljYXRpb24vcGRmIiwiY29udGVudF9sZW5ndGgiOjQ4MjEwLCJjaGVja3N1bSI6IjVXMjhrY2ZxcDlLMGY1djRZN2VyUkE9PSIsInNlcnZpY2VfbmFtZSI6InRlc3QifSwiZXhwIjoiMjAyNi0wMS0xNVQxMjowNTowMC4wMDBaIiwicHVyIjoiYmxvYl90b2tlbiJ9fQ==--3750f7691683b5375486d3266b42be430e421821
+ url: http://www.example.com/rails/active_storage/disk/eyJfcmFpbHMiOnsiZGF0YSI6eyJrZXkiOiIwc3NuNW5kM3RneWtwcWJndXdybGprZjNwbjc4IiwiY29udGVudF90eXBlIjoiYXBwbGljYXRpb24vcGRmIiwiY29udGVudF9sZW5ndGgiOjQ4MjEwLCJjaGVja3N1bSI6IjVXMjhrY2ZxcDlLMGY1djRZN2VyUkE9PSIsInNlcnZpY2VfbmFtZSI6InRlc3QifSwiZXhwIjoiMjAyNi0wMS0xNVQxMjowNTowMC4wMDBaIiwicHVyIjoiYmxvYl90b2tlbiJ9fQ==--c371f81d2998190ebc1edf0b658c9b3921921de1
headers:
Content-Type: application/pdf
schema:
@@ -2261,8 +2261,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 311715
- slug: product-311715
+ name: Product 314715
+ slug: product-314715
options_text: ''
price: '10.00'
display_price: "$10.00"
@@ -2382,8 +2382,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 3122171
- slug: product-3122171
+ name: Product 3152171
+ slug: product-3152171
options_text: ''
price: '10.00'
display_price: "$10.00"
@@ -2671,7 +2671,7 @@ paths:
total_quantity: 0
warnings:
- code: line_item_removed
- message: Product 316307 was removed because it was sold out
+ message: Product 319307 was removed because it was sold out
line_item_id: li_UkLWZg9DAJ
variant_id: variant_UkLWZg9DAJ
coupon_code:
@@ -2914,8 +2914,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 3173263
- slug: product-3173263
+ name: Product 3203263
+ slug: product-3203263
options_text: ''
price: '10.00'
display_price: "$10.00"
@@ -3138,8 +3138,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 3198992
- slug: product-3198992
+ name: Product 3228992
+ slug: product-3228992
options_text: ''
price: '10.00'
display_price: "$10.00"
@@ -3378,8 +3378,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 3224794
- slug: product-3224794
+ name: Product 3254794
+ slug: product-3254794
options_text: ''
price: '10.00'
display_price: "$10.00"
@@ -3697,8 +3697,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 3552614
- slug: product-3552614
+ name: Product 3582614
+ slug: product-3582614
options_text: ''
price: '10.00'
display_price: "$10.00"
@@ -3892,8 +3892,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 3563461
- slug: product-3563461
+ name: Product 3593461
+ slug: product-3593461
options_text: ''
price: '10.00'
display_price: "$10.00"
@@ -4081,8 +4081,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 3588182
- slug: product-3588182
+ name: Product 3618182
+ slug: product-3618182
options_text: ''
price: '10.00'
display_price: "$10.00"
@@ -4401,8 +4401,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 3605702
- slug: product-3605702
+ name: Product 3635702
+ slug: product-3635702
options_text: ''
price: '10.00'
display_price: "$10.00"
@@ -4645,8 +4645,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 3649569
- slug: product-3649569
+ name: Product 3679569
+ slug: product-3679569
options_text: ''
price: '10.00'
display_price: "$10.00"
@@ -4775,10 +4775,10 @@ paths:
total_quantity: 2
warnings:
- code: delivery_unavailable
- message: Product 36763 cannot be delivered to the selected address
+ message: Product 37063 cannot be delivered to the selected address
line_item_id: li_UkLWZg9DAJ
- code: delivery_unavailable
- message: Product 368298 cannot be delivered to the selected address
+ message: Product 371298 cannot be delivered to the selected address
line_item_id: li_gbHJdmfrXB
coupon_code:
item_total: '29.99'
@@ -4837,8 +4837,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 36763
- slug: product-36763
+ name: Product 37063
+ slug: product-37063
options_text: ''
price: '10.00'
display_price: "$10.00"
@@ -4868,8 +4868,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 368298
- slug: product-368298
+ name: Product 371298
+ slug: product-371298
options_text: ''
price: '19.99'
display_price: "$19.99"
@@ -5084,8 +5084,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 3749165
- slug: product-3749165
+ name: Product 3779165
+ slug: product-3779165
options_text: ''
price: '10.00'
display_price: "$10.00"
@@ -5892,8 +5892,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 4399789
- slug: product-4399789
+ name: Product 4429789
+ slug: product-4429789
options_text: ''
price: '10.00'
display_price: "$10.00"
@@ -6077,8 +6077,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 441179
- slug: product-441179
+ name: Product 444179
+ slug: product-444179
options_text: ''
price: '10.00'
display_price: "$10.00"
@@ -6437,8 +6437,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 378496
- slug: product-378496
+ name: Product 381496
+ slug: product-381496
options_text: ''
price: '10.00'
display_price: "$10.00"
@@ -7790,8 +7790,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 3425270
- slug: product-3425270
+ name: Product 3455270
+ slug: product-3455270
options_text: ''
price: '10.00'
display_price: "$10.00"
@@ -8116,8 +8116,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 3445633
- slug: product-3445633
+ name: Product 3475633
+ slug: product-3475633
options_text: ''
price: '10.00'
display_price: "$10.00"
@@ -9537,7 +9537,7 @@ paths:
content: |-
## Filters
- Filter with `q[<attribute>_<predicate>]=value`, for example `q[currency_cont]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).
+ Filter with `q[<attribute>_<predicate>]=value`, for example `q[amount_eq]=…`. Send a list as `q[<attribute>_in][]=a&q[<attribute>_in][]=b`. [How filters work](/api-reference/store-api/querying#which-filters-an-endpoint-accepts).
| Attribute | Kind | Predicates |
|---|---|---|
@@ -10809,7 +10809,7 @@ paths:
variant:
id: variant_gbHJdmfrXB
product_id: prod_gbHJdmfrXB
- sku: SKU-547
+ sku: SKU-550
options_text: ''
track_inventory: true
media_count: 0
@@ -10895,7 +10895,7 @@ paths:
variant:
id: variant_UkLWZg9DAJ
product_id: prod_UkLWZg9DAJ
- sku: SKU-548
+ sku: SKU-551
options_text: ''
track_inventory: true
media_count: 0
@@ -12412,8 +12412,8 @@ paths:
preorder_ships_at:
quantity: 1
currency: USD
- name: Product 3415649
- slug: product-3415649
+ name: Product 3445649
+ slug: product-3445649
options_text: ''
price: '10.00'
display_price: "$10.00"
diff --git a/lefthook.yml b/lefthook.yml
index a3fc00961b..ca5c8f1658 100644
--- a/lefthook.yml
+++ b/lefthook.yml
@@ -49,15 +49,16 @@ pre-commit:
pnpm generate:params
git add packages/sdk/src/types/params/ packages/admin-sdk/src/types/params/ packages/seller-sdk/src/types/params/
- iso-codes:
- # The country, currency and locale lists come from the Store API
- # reference; regenerating it, or changing the generator, needs fresh lists.
+ code-lists:
+ # The country, currency, locale and unit lists come from the Store and
+ # Admin API references; regenerating them, or changing the generator,
+ # needs fresh lists.
glob:
- - "docs/api-reference/store.yaml"
- - "packages/sdk-core/scripts/generate-iso-codes.ts"
+ - "docs/api-reference/{store,admin}.yaml"
+ - "packages/sdk-core/scripts/generate-code-lists.ts"
run: |
- pnpm generate:iso-codes
- git add packages/sdk-core/src/iso-codes.generated.ts
+ pnpm generate:code-lists
+ git add packages/sdk-core/src/code-lists.generated.ts
pre-push:
commands:
diff --git a/package.json b/package.json
index 2f4755e7c5..ffede294a2 100644
--- a/package.json
+++ b/package.json
@@ -9,7 +9,7 @@
"generate:zod": "pnpm --recursive --filter \"./packages/*\" run generate:zod",
"generate:filters": "pnpm --recursive --filter \"./packages/*\" run generate:filters",
"generate:params": "pnpm --recursive --filter \"./packages/*\" run generate:params",
- "generate:iso-codes": "pnpm --filter @spree/sdk run generate:iso-codes",
+ "generate:code-lists": "pnpm --filter @spree/sdk run generate:code-lists",
"lint": "turbo lint",
"lint:fix": "turbo lint:fix",
"format": "turbo format",
diff --git a/packages/admin-sdk/src/index.ts b/packages/admin-sdk/src/index.ts
index 1a7df89fe6..eb20dc119f 100644
--- a/packages/admin-sdk/src/index.ts
+++ b/packages/admin-sdk/src/index.ts
@@ -14,6 +14,7 @@ export {
CountryCode,
CurrencyCode,
compareMoney,
+ DimensionUnit,
decimalPlaces,
formatMoney,
isDecimalString,
@@ -24,6 +25,7 @@ export {
SpreeError,
subtractMoney,
sumMoney,
+ WeightUnit,
} from '@spree/sdk-core'
export type {
AuthTokens,
diff --git a/packages/admin-sdk/src/types/generated/Enums.ts b/packages/admin-sdk/src/types/generated/Enums.ts
index e87a0700ba..204eb4fa65 100644
--- a/packages/admin-sdk/src/types/generated/Enums.ts
+++ b/packages/admin-sdk/src/types/generated/Enums.ts
@@ -1,4 +1,4 @@
-// Typelizer digest 1b0f946b6277c28f8492b314c3982c8c
+// Typelizer digest 447e80c3166e5f6fecb839a9bbf3bf2e
//
// DO NOT MODIFY: This file was automatically generated by Typelizer.
export type ActorKind = 'admin_user' | 'api_key' | (string & {});
@@ -6,6 +6,7 @@ export type ClaimStatus = 'open' | 'approved' | 'resolved' | 'denied' | 'cancele
export type { CountryCode } from '@spree/sdk-core';
export type { CurrencyCode } from '@spree/sdk-core';
export type DataRequestStatus = 'pending' | 'processing' | 'completed' | 'failed' | (string & {});
+export type { DimensionUnit } from '@spree/sdk-core';
export type ExchangeStatus = 'requested' | 'approved' | 'received' | 'fulfilled' | 'canceled' | (string & {});
export type FeeKind = 'surcharge' | 'handling' | 'gift_wrap' | 'cod' | 'payment' | 'duty' | 'exchange' | (string & {});
export type FulfillmentItemStatus = 'on_hand' | 'backordered' | 'shipped' | 'returned' | (string & {});
@@ -27,3 +28,4 @@ export type SellerTransferStatus = 'pending' | 'processing' | 'completed' | 'fai
export type ShippingLabelStatus = 'purchased' | 'refund_requested' | 'refunded' | (string & {});
export type StockLocationKind = 'warehouse' | 'store' | 'fulfillment_center' | (string & {});
export type TaxExemptionCertificateStatus = 'pending' | 'verified' | 'expired' | 'revoked' | (string & {});
+export type { WeightUnit } from '@spree/sdk-core';
diff --git a/packages/admin-sdk/src/types/generated/PackageType.ts b/packages/admin-sdk/src/types/generated/PackageType.ts
index 426f4021fc..39a66549fe 100644
--- a/packages/admin-sdk/src/types/generated/PackageType.ts
+++ b/packages/admin-sdk/src/types/generated/PackageType.ts
@@ -1,6 +1,7 @@
-// Typelizer digest f4cf50ee5d4323e266b6f196e1957621
+// Typelizer digest f8fce4158f49c94c93611bbeaaf795f2
//
// DO NOT MODIFY: This file was automatically generated by Typelizer.
+import type {DimensionUnit, WeightUnit} from '@/types'
interface PackageType {
id: string;
@@ -15,8 +16,8 @@ interface PackageType {
metadata: Record<string, unknown> | null;
created_at: string;
updated_at: string;
- dimensions_unit: 'mm' | 'cm' | 'in' | 'ft';
- weight_unit: 'g' | 'kg' | 'lb' | 'oz';
+ dimensions_unit: DimensionUnit;
+ weight_unit: WeightUnit;
volume: string | null;
seller_id: string | null;
seller_name: string | null;
diff --git a/packages/admin-sdk/src/types/generated/Store.ts b/packages/admin-sdk/src/types/generated/Store.ts
index 4ee9dfbcd2..d4245693e5 100644
--- a/packages/admin-sdk/src/types/generated/Store.ts
+++ b/packages/admin-sdk/src/types/generated/Store.ts
@@ -1,7 +1,7 @@
-// Typelizer digest cc400af37e825faf41d1b6d588e96370
+// Typelizer digest ce801fb0d3e343de46a8e6f7e78ec5cf
//
// DO NOT MODIFY: This file was automatically generated by Typelizer.
-import type {SetupTask, CurrencyCode, LocaleCode} from '@/types'
+import type {SetupTask, CurrencyCode, LocaleCode, WeightUnit} from '@/types'
interface Store {
id: string;
@@ -23,7 +23,7 @@ interface Store {
admin_locale: string | null;
timezone: string;
storefront_url: string | null;
- weight_unit: 'g' | 'kg' | 'lb' | 'oz';
+ weight_unit: WeightUnit;
unit_system: 'metric' | 'imperial';
storefront_access: 'public' | 'prices_hidden' | 'login_required';
guest_checkout: boolean;
diff --git a/packages/admin-sdk/src/types/generated/Variant.ts b/packages/admin-sdk/src/types/generated/Variant.ts
index 45abb1a7fa..40fb5a4286 100644
--- a/packages/admin-sdk/src/types/generated/Variant.ts
+++ b/packages/admin-sdk/src/types/generated/Variant.ts
@@ -1,7 +1,7 @@
-// Typelizer digest 7ab02f3076b20b11128f8f2ed1dc26a0
+// Typelizer digest df2caf951c22d8471f40a4d39811cb5a
//
// DO NOT MODIFY: This file was automatically generated by Typelizer.
-import type {Price, PriceHistory, Seller, Media, OptionValue, CustomField, StockLevel, CurrencyCode, CountryCode} from '@/types'
+import type {Price, PriceHistory, Seller, Media, OptionValue, CustomField, StockLevel, WeightUnit, DimensionUnit, CurrencyCode, CountryCode} from '@/types'
interface Variant {
id: string;
@@ -20,8 +20,8 @@ interface Variant {
height: number | null;
width: number | null;
depth: number | null;
- weight_unit: 'g' | 'kg' | 'lb' | 'oz';
- dimensions_unit: 'mm' | 'cm' | 'in' | 'ft';
+ weight_unit: WeightUnit;
+ dimensions_unit: DimensionUnit;
minimum_order_quantity: number | null;
order_multiple: number | null;
purchase_unit: 'unit' | 'carton' | null;
diff --git a/packages/admin-sdk/src/types/generated/index.ts b/packages/admin-sdk/src/types/generated/index.ts
index ad17bb0142..f687ccb726 100644
--- a/packages/admin-sdk/src/types/generated/index.ts
+++ b/packages/admin-sdk/src/types/generated/index.ts
@@ -1,7 +1,7 @@
-// Typelizer digest 7d9152446131bb96c25de2ab10467fd8
+// Typelizer digest 89833a8cea1c379ef8e7070bba4ca299
//
// DO NOT MODIFY: This file was automatically generated by Typelizer.
-export type { ActorKind, ClaimStatus, CountryCode, CurrencyCode, DataRequestStatus, ExchangeStatus, FeeKind, FulfillmentItemStatus, FulfillmentStatus, GiftCardStatus, ImportRowStatus, ImportStatus, InvitationStatus, LocaleCode, PaymentStatus, PriceListStatus, ProductStatus, ProductSubmissionStatus, ReturnStatus, SellerPayoutStatus, SellerRequirementSubmissionStatus, SellerStatus, SellerTransferStatus, ShippingLabelStatus, StockLocationKind, TaxExemptionCertificateStatus } from './Enums'
+export type { ActorKind, ClaimStatus, CountryCode, CurrencyCode, DataRequestStatus, DimensionUnit, ExchangeStatus, FeeKind, FulfillmentItemStatus, FulfillmentStatus, GiftCardStatus, ImportRowStatus, ImportStatus, InvitationStatus, LocaleCode, PaymentStatus, PriceListStatus, ProductStatus, ProductSubmissionStatus, ReturnStatus, SellerPayoutStatus, SellerRequirementSubmissionStatus, SellerStatus, SellerTransferStatus, ShippingLabelStatus, StockLocationKind, TaxExemptionCertificateStatus, WeightUnit } from './Enums'
export type { default as Actor } from './Actor'
export type { default as Address } from './Address'
export type { default as AdminUser } from './AdminUser'
diff --git a/packages/admin-sdk/src/types/params/PackageTypeCreateParams.ts b/packages/admin-sdk/src/types/params/PackageTypeCreateParams.ts
index 82a16a1a58..00527d61be 100644
--- a/packages/admin-sdk/src/types/params/PackageTypeCreateParams.ts
+++ b/packages/admin-sdk/src/types/params/PackageTypeCreateParams.ts
@@ -1,5 +1,8 @@
// This file is auto-generated from the request schemas in docs/api-reference by `pnpm generate:params`. Do not edit directly.
+import type { DimensionUnit } from '../generated'
+import type { WeightUnit } from '../generated'
+
export type PackageTypeCreateParams = {
/** Unique within the store. */
name: string
@@ -12,12 +15,12 @@ export type PackageTypeCreateParams = {
width?: number | null
height?: number | null
/** Unit the three dimensions are in; falls back to the store's unit system. */
- dimensions_unit?: 'mm' | 'cm' | 'in' | 'ft' | null
+ dimensions_unit?: DimensionUnit | null
/** The empty package's own weight, added to content weight on every quote. */
weight?: number | null
/** What the package can hold, not the same as its own weight. */
max_weight?: number | null
- weight_unit?: 'g' | 'kg' | 'lb' | 'oz' | null
+ weight_unit?: WeightUnit | null
/** The box every parcel quote is built on. Setting this demotes whichever row held it. */
default?: boolean
metadata?: Record<string, unknown>
diff --git a/packages/admin-sdk/src/types/params/PackageTypeUpdateParams.ts b/packages/admin-sdk/src/types/params/PackageTypeUpdateParams.ts
index 19bbdd322f..1762e5f3b8 100644
--- a/packages/admin-sdk/src/types/params/PackageTypeUpdateParams.ts
+++ b/packages/admin-sdk/src/types/params/PackageTypeUpdateParams.ts
@@ -1,5 +1,8 @@
// This file is auto-generated from the request schemas in docs/api-reference by `pnpm generate:params`. Do not edit directly.
+import type { DimensionUnit } from '../generated'
+import type { WeightUnit } from '../generated'
+
export type PackageTypeUpdateParams = {
/** Unique within the store. */
name?: string
@@ -12,12 +15,12 @@ export type PackageTypeUpdateParams = {
width?: number | null
height?: number | null
/** Unit the three dimensions are in; falls back to the store's unit system. */
- dimensions_unit?: 'mm' | 'cm' | 'in' | 'ft' | null
+ dimensions_unit?: DimensionUnit | null
/** The empty package's own weight, added to content weight on every quote. */
weight?: number | null
/** What the package can hold, not the same as its own weight. */
max_weight?: number | null
- weight_unit?: 'g' | 'kg' | 'lb' | 'oz' | null
+ weight_unit?: WeightUnit | null
/** The box every parcel quote is built on. Setting this demotes whichever row held it. */
default?: boolean
metadata?: Record<string, unknown>
diff --git a/packages/admin-sdk/src/types/params/ProductVariantParams.ts b/packages/admin-sdk/src/types/params/ProductVariantParams.ts
index 466c6444c8..f584df36c6 100644
--- a/packages/admin-sdk/src/types/params/ProductVariantParams.ts
+++ b/packages/admin-sdk/src/types/params/ProductVariantParams.ts
@@ -1,68 +1,7 @@
// This file is auto-generated from the request schemas in docs/api-reference by `pnpm generate:params`. Do not edit directly.
-import type { CountryCode } from '../generated'
-import type { CurrencyCode } from '../generated'
-import type { PriceParams } from './PriceParams'
-import type { StockLevelParams } from './StockLevelParams'
-import type { VariantOptionParams } from './VariantOptionParams'
+import type { VariantParams } from './VariantParams'
-export type ProductVariantParams = {
+export type ProductVariantParams = VariantParams & {
id?: string
- sku?: string
- barcode?: string
- cost_price?: string | null
- cost_currency?: CurrencyCode
- weight?: number | null
- height?: number | null
- width?: number | null
- depth?: number | null
- weight_unit?: 'g' | 'kg' | 'lb' | 'oz'
- dimensions_unit?: 'mm' | 'cm' | 'in' | 'ft'
- hs_code?: string
- customs_description?: string
- country_of_origin?: CountryCode
- minimum_order_quantity?: number | null
- order_multiple?: number | null
- purchase_unit?: string
- /** How many units fill one carton. */
- units_per_carton?: number | null
- /**
- * The carton this variant is packed into: a package type of kind `carton`. Its dimensions are
- * shared by every product packed the same way, so a corrected carton size fixes all of them at
- * once.
- */
- carton_package_type_id?: string | null
- /** What one packed carton weighs, in the variant's weight unit. */
- carton_weight?: number | null
- /** How many cartons stack on one pallet. */
- cartons_per_pallet?: number | null
- seller_id?: string
- delivery_profile_id?: string | null
- track_inventory?: boolean
- /**
- * Sell this variant before it's in stock. Adds the pre-order label and ships-by promise; the cap
- * comes from `backorder_limit`, an incoming stock count, or backorder.
- */
- preorderable?: boolean
- /**
- * The "ships by" date shown to customers while the variant is a pre-order. Once it passes, the
- * variant is no longer a pre-order. Null clears it.
- */
- preorder_ships_at?: string | null
- /**
- * Maximum units sellable beyond available stock, capping backorders and pre-orders. Null is
- * unlimited.
- */
- backorder_limit?: number | null
- tax_category_id?: string
- position?: number
- /** Per-currency prices. Upserted by currency. */
- prices?: PriceParams[]
- /** Stock per location. Upserted by location; omitted locations are removed. */
- stock_levels?: StockLevelParams[]
- /**
- * One pair per option type the variant takes part in (size, color). Option types and values are
- * created when missing.
- */
- options?: VariantOptionParams[]
}
diff --git a/packages/admin-sdk/src/types/params/StoreUpdateParams.ts b/packages/admin-sdk/src/types/params/StoreUpdateParams.ts
index a8e6f66e1e..f556e8236c 100644
--- a/packages/admin-sdk/src/types/params/StoreUpdateParams.ts
+++ b/packages/admin-sdk/src/types/params/StoreUpdateParams.ts
@@ -1,10 +1,12 @@
// This file is auto-generated from the request schemas in docs/api-reference by `pnpm generate:params`. Do not edit directly.
+import type { WeightUnit } from '../generated'
+
export type StoreUpdateParams = {
name?: string
admin_locale?: string
timezone?: string
- weight_unit?: 'g' | 'kg' | 'lb' | 'oz'
+ weight_unit?: WeightUnit
unit_system?: 'metric' | 'imperial'
/**
* The store-wide default for what anonymous visitors can see. Channels fall back to it when they
diff --git a/packages/admin-sdk/src/types/params/VariantCreateParams.ts b/packages/admin-sdk/src/types/params/VariantCreateParams.ts
index 6566852e06..985837c80d 100644
--- a/packages/admin-sdk/src/types/params/VariantCreateParams.ts
+++ b/packages/admin-sdk/src/types/params/VariantCreateParams.ts
@@ -1,12 +1,14 @@
// This file is auto-generated from the request schemas in docs/api-reference by `pnpm generate:params`. Do not edit directly.
-import type { CountryCode } from '../generated'
-import type { CurrencyCode } from '../generated'
-import type { PriceParams } from './PriceParams'
-import type { StockLevelParams } from './StockLevelParams'
import type { VariantOptionParams } from './VariantOptionParams'
+import type { VariantParams } from './VariantParams'
-export type VariantCreateParams = {
+export type VariantCreateParams = VariantParams & {
+ /**
+ * One pair per option type the variant takes part in (size, color). Option types and values are
+ * created when missing. On update, omit to leave the option values untouched.
+ */
+ options: VariantOptionParams[]
/**
* Identities the record has in external systems, keyed by system: the same
* `{ system: external_id }` map the Admin API renders, so what you read can be sent straight
@@ -14,61 +16,4 @@ export type VariantCreateParams = {
* entries is accepted too.
*/
external_references?: Record<string, unknown>
- sku?: string
- barcode?: string
- cost_price?: string | null
- cost_currency?: CurrencyCode
- weight?: number | null
- height?: number | null
- width?: number | null
- depth?: number | null
- weight_unit?: 'g' | 'kg' | 'lb' | 'oz'
- dimensions_unit?: 'mm' | 'cm' | 'in' | 'ft'
- hs_code?: string
- customs_description?: string
- country_of_origin?: CountryCode
- minimum_order_quantity?: number | null
- order_multiple?: number | null
- purchase_unit?: string
- /** How many units fill one carton. */
- units_per_carton?: number | null
- /**
- * The carton this variant is packed into: a package type of kind `carton`. Its dimensions are
- * shared by every product packed the same way, so a corrected carton size fixes all of them at
- * once.
- */
- carton_package_type_id?: string | null
- /** What one packed carton weighs, in the variant's weight unit. */
- carton_weight?: number | null
- /** How many cartons stack on one pallet. */
- cartons_per_pallet?: number | null
- seller_id?: string
- delivery_profile_id?: string | null
- track_inventory?: boolean
- /**
- * Sell this variant before it's in stock. Adds the pre-order label and ships-by promise; the cap
- * comes from `backorder_limit`, an incoming stock count, or backorder.
- */
- preorderable?: boolean
- /**
- * The "ships by" date shown to customers while the variant is a pre-order. Once it passes, the
- * variant is no longer a pre-order. Null clears it.
- */
- preorder_ships_at?: string | null
- /**
- * Maximum units sellable beyond available stock, capping backorders and pre-orders. Null is
- * unlimited.
- */
- backorder_limit?: number | null
- tax_category_id?: string
- position?: number
- /** Per-currency prices. Upserted by currency. */
- prices?: PriceParams[]
- /** Stock per location. Upserted by location; omitted locations are removed. */
- stock_levels?: StockLevelParams[]
- /**
- * One pair per option type the variant takes part in (size, color). Option types and values are
- * created when missing. On update, omit to leave the option values untouched.
- */
- options: VariantOptionParams[]
}
diff --git a/packages/admin-sdk/src/types/params/VariantParams.ts b/packages/admin-sdk/src/types/params/VariantParams.ts
new file mode 100644
index 0000000000..5eff18a820
--- /dev/null
+++ b/packages/admin-sdk/src/types/params/VariantParams.ts
@@ -0,0 +1,71 @@
+// This file is auto-generated from the request schemas in docs/api-reference by `pnpm generate:params`. Do not edit directly.
+
+import type { CountryCode } from '../generated'
+import type { CurrencyCode } from '../generated'
+import type { DimensionUnit } from '../generated'
+import type { PriceParams } from './PriceParams'
+import type { StockLevelParams } from './StockLevelParams'
+import type { VariantOptionParams } from './VariantOptionParams'
+import type { WeightUnit } from '../generated'
+
+export type VariantParams = {
+ sku?: string
+ barcode?: string
+ cost_price?: string | null
+ cost_currency?: CurrencyCode
+ weight?: number | null
+ height?: number | null
+ width?: number | null
+ depth?: number | null
+ /** Null falls back to the store's weight unit. */
+ weight_unit?: WeightUnit | null
+ /** Null falls back to the store's unit system. */
+ dimensions_unit?: DimensionUnit | null
+ hs_code?: string
+ customs_description?: string
+ country_of_origin?: CountryCode
+ minimum_order_quantity?: number | null
+ order_multiple?: number | null
+ purchase_unit?: 'unit' | 'carton' | null
+ /** How many units fill one carton. */
+ units_per_carton?: number | null
+ /**
+ * The carton this variant is packed into: a package type of kind `carton`. Its dimensions are
+ * shared by every product packed the same way, so a corrected carton size fixes all of them at
+ * once.
+ */
+ carton_package_type_id?: string | null
+ /** What one packed carton weighs, in the variant's weight unit. */
+ carton_weight?: number | null
+ /** How many cartons stack on one pallet. */
+ cartons_per_pallet?: number | null
+ track_inventory?: boolean
+ /**
+ * Sell this variant before it's in stock. Adds the pre-order label and ships-by promise; the cap
+ * comes from `backorder_limit`, an incoming stock count, or backorder.
+ */
+ preorderable?: boolean
+ /**
+ * The "ships by" date shown to customers while the variant is a pre-order. Once it passes, the
+ * variant is no longer a pre-order. Null clears it.
+ */
+ preorder_ships_at?: string | null
+ /**
+ * Maximum units sellable beyond available stock, capping backorders and pre-orders. Null is
+ * unlimited.
+ */
+ backorder_limit?: number | null
+ position?: number
+ /**
+ * One pair per option type the variant takes part in (size, color). Option types and values are
+ * created when missing.
+ */
+ options?: VariantOptionParams[]
+ seller_id?: string
+ delivery_profile_id?: string | null
+ tax_category_id?: string
+ /** Per-currency prices. Upserted by currency. */
+ prices?: PriceParams[]
+ /** Stock per location. Upserted by location; omitted locations are removed. */
+ stock_levels?: StockLevelParams[]
+}
diff --git a/packages/admin-sdk/src/types/params/VariantUpdateParams.ts b/packages/admin-sdk/src/types/params/VariantUpdateParams.ts
index 2d1c9d4ea5..cf6ff0a053 100644
--- a/packages/admin-sdk/src/types/params/VariantUpdateParams.ts
+++ b/packages/admin-sdk/src/types/params/VariantUpdateParams.ts
@@ -1,12 +1,14 @@
// This file is auto-generated from the request schemas in docs/api-reference by `pnpm generate:params`. Do not edit directly.
-import type { CountryCode } from '../generated'
-import type { CurrencyCode } from '../generated'
-import type { PriceParams } from './PriceParams'
-import type { StockLevelParams } from './StockLevelParams'
import type { VariantOptionParams } from './VariantOptionParams'
+import type { VariantParams } from './VariantParams'
-export type VariantUpdateParams = {
+export type VariantUpdateParams = VariantParams & {
+ /**
+ * One pair per option type the variant takes part in (size, color). Option types and values are
+ * created when missing. On update, omit to leave the option values untouched.
+ */
+ options?: VariantOptionParams[]
/**
* Identities the record has in external systems, keyed by system: the same
* `{ system: external_id }` map the Admin API renders, so what you read can be sent straight
@@ -14,61 +16,4 @@ export type VariantUpdateParams = {
* entries is accepted too.
*/
external_references?: Record<string, unknown>
- sku?: string
- barcode?: string
- cost_price?: string | null
- cost_currency?: CurrencyCode
- weight?: number | null
- height?: number | null
- width?: number | null
- depth?: number | null
- weight_unit?: 'g' | 'kg' | 'lb' | 'oz'
- dimensions_unit?: 'mm' | 'cm' | 'in' | 'ft'
- hs_code?: string
- customs_description?: string
- country_of_origin?: CountryCode
- minimum_order_quantity?: number | null
- order_multiple?: number | null
- purchase_unit?: string
- /** How many units fill one carton. */
- units_per_carton?: number | null
- /**
- * The carton this variant is packed into: a package type of kind `carton`. Its dimensions are
- * shared by every product packed the same way, so a corrected carton size fixes all of them at
- * once.
- */
- carton_package_type_id?: string | null
- /** What one packed carton weighs, in the variant's weight unit. */
- carton_weight?: number | null
- /** How many cartons stack on one pallet. */
- cartons_per_pallet?: number | null
- seller_id?: string
- delivery_profile_id?: string | null
- track_inventory?: boolean
- /**
- * Sell this variant before it's in stock. Adds the pre-order label and ships-by promise; the cap
- * comes from `backorder_limit`, an incoming stock count, or backorder.
- */
- preorderable?: boolean
- /**
- * The "ships by" date shown to customers while the variant is a pre-order. Once it passes, the
- * variant is no longer a pre-order. Null clears it.
- */
- preorder_ships_at?: string | null
- /**
- * Maximum units sellable beyond available stock, capping backorders and pre-orders. Null is
- * unlimited.
- */
- backorder_limit?: number | null
- tax_category_id?: string
- position?: number
- /** Per-currency prices. Upserted by currency. */
- prices?: PriceParams[]
- /** Stock per location. Upserted by location; omitted locations are removed. */
- stock_levels?: StockLevelParams[]
- /**
- * One pair per option type the variant takes part in (size, color). Option types and values are
- * created when missing. On update, omit to leave the option values untouched.
- */
- options?: VariantOptionParams[]
}
diff --git a/packages/admin-sdk/src/types/params/index.ts b/packages/admin-sdk/src/types/params/index.ts
index 6c84d25785..deb586c567 100644
--- a/packages/admin-sdk/src/types/params/index.ts
+++ b/packages/admin-sdk/src/types/params/index.ts
@@ -231,6 +231,7 @@ export type { TranslationBatchEntryParams } from './TranslationBatchEntryParams'
export type { TranslationBatchParams } from './TranslationBatchParams'
export type { VariantCreateParams } from './VariantCreateParams'
export type { VariantOptionParams } from './VariantOptionParams'
+export type { VariantParams } from './VariantParams'
export type { VariantUpdateParams } from './VariantUpdateParams'
export type { WebhookEndpointCreateParams } from './WebhookEndpointCreateParams'
export type { WebhookEndpointDisableParams } from './WebhookEndpointDisableParams'
diff --git a/packages/dashboard-core/src/api-client.ts b/packages/dashboard-core/src/api-client.ts
index d9fd0ccdfe..903f21c03f 100644
--- a/packages/dashboard-core/src/api-client.ts
+++ b/packages/dashboard-core/src/api-client.ts
@@ -14,7 +14,13 @@
* promise the seller panel methods its API does not have.
*/
-import type { CountryCode, PermissionRule, UploadFileOptions } from '@spree/admin-sdk'
+import type {
+ CountryCode,
+ DimensionUnit,
+ PermissionRule,
+ UploadFileOptions,
+ WeightUnit,
+} from '@spree/admin-sdk'
/** What a panel may change on the signed-in person's own account. */
export interface PanelAccountParams {
@@ -354,10 +360,10 @@ export interface PanelPackageTypeParams {
length?: number | null
width?: number | null
height?: number | null
- dimensions_unit?: PanelPackageDimensionUnit | null
+ dimensions_unit?: DimensionUnit | null
weight?: number | null
max_weight?: number | null
- weight_unit?: PanelPackageWeightUnit | null
+ weight_unit?: WeightUnit | null
default?: boolean
/**
* Not nullable: both SDKs take a merge, so clearing a key is sending the
@@ -387,8 +393,10 @@ export interface PanelPackageTypeWrites extends PanelPackageTypeReads {
}
export type PanelPackageTypeKind = 'box' | 'envelope' | 'carton' | 'pallet' | 'container'
-export type PanelPackageDimensionUnit = 'mm' | 'cm' | 'in' | 'ft'
-export type PanelPackageWeightUnit = 'g' | 'kg' | 'lb' | 'oz'
+/** @deprecated Use `DimensionUnit` from `@spree/admin-sdk`. */
+export type PanelPackageDimensionUnit = DimensionUnit
+/** @deprecated Use `WeightUnit` from `@spree/admin-sdk`. */
+export type PanelPackageWeightUnit = WeightUnit
/**
* A new row must say what it is and what to call it — packaging without
diff --git a/packages/dashboard-core/src/pages/package-types.tsx b/packages/dashboard-core/src/pages/package-types.tsx
index 18315c10e0..f6922e6f59 100644
--- a/packages/dashboard-core/src/pages/package-types.tsx
+++ b/packages/dashboard-core/src/pages/package-types.tsx
@@ -1,4 +1,5 @@
import { zodResolver } from '@hookform/resolvers/zod'
+import { DimensionUnit, WeightUnit } from '@spree/admin-sdk'
import {
Button,
Field,
@@ -45,10 +46,8 @@ import { mapSpreeErrorsToForm } from '../lib/form-errors'
import { Subject } from '../lib/permissions'
import { usePermissions } from '../providers/permission-provider'
import {
- PACKAGE_DIMENSION_UNITS,
PACKAGE_TYPE_DEFAULTS,
PACKAGE_TYPE_KINDS,
- PACKAGE_WEIGHT_UNITS,
type PackageTypeFormValues,
packageTypeFormSchema,
packageTypeFormValuesToParams,
@@ -376,7 +375,7 @@ function PackageTypeFormFields({ form }: { form: UseFormReturn<PackageTypeFormVa
<UnitField
form={form}
name="dimensions_unit"
- units={PACKAGE_DIMENSION_UNITS}
+ units={Object.values(DimensionUnit)}
label={t('admin.fields.package_type.dimensions_unit.label')}
/>
</div>
@@ -416,7 +415,7 @@ function PackageTypeFormFields({ form }: { form: UseFormReturn<PackageTypeFormVa
<UnitField
form={form}
name="weight_unit"
- units={PACKAGE_WEIGHT_UNITS}
+ units={Object.values(WeightUnit)}
label={t('admin.fields.package_type.weight_unit.label')}
/>
</div>
diff --git a/packages/dashboard-core/src/products/bulk-variants-dialog.tsx b/packages/dashboard-core/src/products/bulk-variants-dialog.tsx
index d849248d69..f46176a698 100644
--- a/packages/dashboard-core/src/products/bulk-variants-dialog.tsx
+++ b/packages/dashboard-core/src/products/bulk-variants-dialog.tsx
@@ -1,3 +1,4 @@
+import { DimensionUnit, WeightUnit } from '@spree/admin-sdk'
import type { ProductFormValues, VariantFormValues } from '@spree/dashboard-core'
import { useCountries, useCountryDisplayName } from '@spree/dashboard-core'
import {
@@ -23,9 +24,6 @@ import {
} from './use-product-form-data'
import { composeOptionsText } from './variants-matrix'
-const WEIGHT_UNITS = ['g', 'kg', 'lb', 'oz'] as const
-const DIMENSION_UNITS = ['mm', 'cm', 'in'] as const
-
interface Props {
// eslint-disable-next-line @typescript-eslint/no-explicit-any
form: UseFormReturn<ProductFormValues, any, any>
@@ -242,8 +240,8 @@ export function BulkVariantsDialog({ form, open, onOpenChange }: Props) {
<BulkVariantsTable
rows={rows}
onChange={handleChange}
- weightUnitOptions={unitOptions(WEIGHT_UNITS)}
- dimensionUnitOptions={unitOptions(DIMENSION_UNITS)}
+ weightUnitOptions={unitOptions(Object.values(WeightUnit))}
+ dimensionUnitOptions={unitOptions(Object.values(DimensionUnit))}
taxCategoryOptions={
taxCategories.length > 0
? taxCategories.map((c) => ({ value: c.id, label: c.name }))
diff --git a/packages/dashboard-core/src/products/variant-edit-sheet.tsx b/packages/dashboard-core/src/products/variant-edit-sheet.tsx
index d99df7d49d..6cdb62cedc 100644
--- a/packages/dashboard-core/src/products/variant-edit-sheet.tsx
+++ b/packages/dashboard-core/src/products/variant-edit-sheet.tsx
@@ -1,3 +1,4 @@
+import { DimensionUnit, WeightUnit } from '@spree/admin-sdk'
import type { ProductFormValues, VariantFormValues } from '@spree/dashboard-core'
import { CountryCombobox, StoreDatePicker } from '@spree/dashboard-core'
import {
@@ -43,9 +44,6 @@ import {
} from './use-product-form-data'
import { variantDisplayLabel } from './variants-matrix'
-const WEIGHT_UNITS = ['g', 'kg', 'lb', 'oz'] as const
-const DIMENSION_UNITS = ['mm', 'cm', 'in'] as const
-
interface Props {
// eslint-disable-next-line @typescript-eslint/no-explicit-any
form: UseFormReturn<ProductFormValues, any, any>
@@ -230,7 +228,7 @@ export function VariantEditSheet({ form, variantIndex, open, onOpenChange }: Pro
<SelectValue>{(v) => (v as string) || '—'}</SelectValue>
</SelectTrigger>
<SelectContent>
- {WEIGHT_UNITS.map((u) => (
+ {Object.values(WeightUnit).map((u) => (
<SelectItem key={u} value={u}>
{u}
</SelectItem>
@@ -295,7 +293,7 @@ export function VariantEditSheet({ form, variantIndex, open, onOpenChange }: Pro
<SelectValue>{(v) => (v as string) || '—'}</SelectValue>
</SelectTrigger>
<SelectContent>
- {DIMENSION_UNITS.map((u) => (
+ {Object.values(DimensionUnit).map((u) => (
<SelectItem key={u} value={u}>
{u}
</SelectItem>
diff --git a/packages/dashboard-core/src/schemas/package-type.ts b/packages/dashboard-core/src/schemas/package-type.ts
index fb12a0c9c0..aa11de536e 100644
--- a/packages/dashboard-core/src/schemas/package-type.ts
+++ b/packages/dashboard-core/src/schemas/package-type.ts
@@ -1,3 +1,4 @@
+import { DimensionUnit, WeightUnit } from '@spree/admin-sdk'
import { requiredMessage } from '@spree/dashboard-ui'
import i18n from 'i18next'
import { z } from 'zod/v4'
@@ -6,12 +7,17 @@ import type { PanelPackageType, PanelPackageTypeCreateParams } from '../api-clie
// The vocabulary the server validates against; typing anything else could
// only fail on save.
export const PACKAGE_TYPE_KINDS = ['box', 'envelope', 'carton', 'pallet', 'container'] as const
-export const PACKAGE_DIMENSION_UNITS = ['mm', 'cm', 'in', 'ft'] as const
-export const PACKAGE_WEIGHT_UNITS = ['g', 'kg', 'lb', 'oz'] as const
export type PackageTypeKind = (typeof PACKAGE_TYPE_KINDS)[number]
-export type PackageDimensionUnit = (typeof PACKAGE_DIMENSION_UNITS)[number]
-export type PackageWeightUnit = (typeof PACKAGE_WEIGHT_UNITS)[number]
+
+/** @deprecated Use `Object.values(DimensionUnit)` from `@spree/admin-sdk`. */
+export const PACKAGE_DIMENSION_UNITS = Object.values(DimensionUnit)
+/** @deprecated Use `Object.values(WeightUnit)` from `@spree/admin-sdk`. */
+export const PACKAGE_WEIGHT_UNITS = Object.values(WeightUnit)
+/** @deprecated Use `DimensionUnit` from `@spree/admin-sdk`. */
+export type PackageDimensionUnit = DimensionUnit
+/** @deprecated Use `WeightUnit` from `@spree/admin-sdk`. */
+export type PackageWeightUnit = WeightUnit
// Blank is how a merchant says "not measured", so every number is optional
// and an empty string reaches the API as null rather than zero — a box
@@ -33,10 +39,10 @@ export const packageTypeFormSchema = z.object({
length: optionalNumber,
width: optionalNumber,
height: optionalNumber,
- dimensions_unit: z.enum(PACKAGE_DIMENSION_UNITS).optional(),
+ dimensions_unit: z.enum(DimensionUnit).optional(),
weight: optionalNumber,
max_weight: optionalNumber,
- weight_unit: z.enum(PACKAGE_WEIGHT_UNITS).optional(),
+ weight_unit: z.enum(WeightUnit).optional(),
default: z.boolean().optional(),
})
@@ -89,10 +95,10 @@ export function packageTypeToFormValues(packageType: PanelPackageType): PackageT
length: packageType.length ?? '',
width: packageType.width ?? '',
height: packageType.height ?? '',
- dimensions_unit: (packageType.dimensions_unit ?? undefined) as PackageDimensionUnit | undefined,
+ dimensions_unit: (packageType.dimensions_unit ?? undefined) as DimensionUnit | undefined,
weight: packageType.weight ?? '',
max_weight: packageType.max_weight ?? '',
- weight_unit: (packageType.weight_unit ?? undefined) as PackageWeightUnit | undefined,
+ weight_unit: (packageType.weight_unit ?? undefined) as WeightUnit | undefined,
default: packageType.default ?? false,
}
}
diff --git a/packages/dashboard/e2e/products-variants.spec.ts b/packages/dashboard/e2e/products-variants.spec.ts
index 4205321886..6224c262c6 100644
--- a/packages/dashboard/e2e/products-variants.spec.ts
+++ b/packages/dashboard/e2e/products-variants.spec.ts
@@ -78,8 +78,9 @@ test.describe('product variants', () => {
await expect(variantsCard.getByText('Blue')).toHaveCount(0)
})
- // Skipped: pre-existing flake — both the matrix and the edit sheet register
- test('opens the per-variant edit sheet and edits SKU + weight', async ({ page }) => {
+ test('opens the per-variant edit sheet and edits SKU, weight and dimension unit', async ({
+ page,
+ }) => {
const creds = await login(page)
const colorLabel = await seedOptionType(page, creds.store_id, 'color', ['red'])
@@ -100,6 +101,10 @@ test.describe('product variants', () => {
// verify the sheet's UI specifically).
await sheet.getByLabel(/^sku$/i).fill('SKU-SHEET-1')
await sheet.getByLabel(/^weight$/i).fill('1.5')
+ // Feet: the last unit the server accepts, once missing from this picker.
+ await sheet.locator('[id$="-dim-unit"]').click()
+ await page.getByRole('option', { name: 'ft', exact: true }).click()
+ await expect(sheet.locator('[id$="-dim-unit"]')).toHaveText('ft')
await sheet.getByRole('button', { name: /^done$/i }).click()
await expect(sheet).toBeHidden()
@@ -114,5 +119,6 @@ test.describe('product variants', () => {
const reopened = page.getByRole('dialog')
await expect(reopened.getByLabel(/^sku$/i)).toHaveValue('SKU-SHEET-1')
await expect(reopened.getByLabel(/^weight$/i)).toHaveValue('1.5')
+ await expect(reopened.locator('[id$="-dim-unit"]')).toHaveText('ft')
})
})
diff --git a/packages/dashboard/src/schemas/store.ts b/packages/dashboard/src/schemas/store.ts
index f568f5a943..0333f40051 100644
--- a/packages/dashboard/src/schemas/store.ts
+++ b/packages/dashboard/src/schemas/store.ts
@@ -1,3 +1,4 @@
+import { WeightUnit } from '@spree/admin-sdk'
import { requiredMessage } from '@spree/dashboard-ui'
import { z } from 'zod/v4'
@@ -5,12 +6,10 @@ import { z } from 'zod/v4'
// `admin.store.weight_units.*`. Consumers translate at render time.
export type UnitSystem = 'metric' | 'imperial'
export const UNIT_SYSTEMS: readonly UnitSystem[] = ['metric', 'imperial']
-export type WeightUnit = 'kg' | 'g' | 'lb' | 'oz'
export const WEIGHT_UNITS: Record<UnitSystem, readonly WeightUnit[]> = {
metric: ['kg', 'g'],
imperial: ['lb', 'oz'],
}
-const ALL_WEIGHT_UNITS = [...WEIGHT_UNITS.metric, ...WEIGHT_UNITS.imperial] as const
// Store-wide storefront posture. Unlike the channel field there is no blank
// "inherit" option — the store is the terminal fallback in the resolution
@@ -45,7 +44,7 @@ export const storeSettingsFormSchema = z.object({
admin_locale: z.string().nullable().optional(),
timezone: z.string().min(1, { error: requiredMessage('store.timezone') }),
unit_system: z.enum(['metric', 'imperial']),
- weight_unit: z.enum(ALL_WEIGHT_UNITS),
+ weight_unit: z.enum(WeightUnit),
storefront_access: z.enum(STOREFRONT_ACCESS_LEVELS),
guest_checkout: z.boolean(),
always_include_confirm_step: z.boolean(),
diff --git a/packages/sdk-core/scripts/generate-code-lists.ts b/packages/sdk-core/scripts/generate-code-lists.ts
new file mode 100644
index 0000000000..1b8c5d85f2
--- /dev/null
+++ b/packages/sdk-core/scripts/generate-code-lists.ts
@@ -0,0 +1,121 @@
+import * as fs from 'node:fs'
+import * as path from 'node:path'
+import { parse } from 'yaml'
+
+// Writes the closed code lists every SDK exports — countries, currencies,
+// locales and measurement units — from the named schemas in the API
+// references, the server's own lists. Each code is documented with its English
+// name, so editors show "US Dollar" when hovering `USD`:
+//
+// pnpm generate:code-lists
+//
+// A country, currency or locale name comes from the runtime's
+// `Intl.DisplayNames` only the first time its code appears; after that it is
+// read back from the generated file. Names differ between Node versions, so
+// this keeps the output the same on every machine and lets CI check it.
+
+type Spec = { components?: { schemas?: Record<string, { enum?: string[] }> } }
+
+const root = path.resolve(import.meta.dirname, '../../..')
+// Units are only written through the Admin and Seller APIs, so their lists
+// are published there rather than in the Store API reference.
+const specs = ['store', 'admin'].map(
+ (api) =>
+ parse(fs.readFileSync(path.join(root, `docs/api-reference/${api}.yaml`), 'utf8')) as Spec,
+)
+const outputPath = path.resolve(import.meta.dirname, '../src/code-lists.generated.ts')
+
+// Names already written, keyed by list and code: a unit and a locale may
+// share a code (`kg`).
+const existingNames = new Map<string, string>()
+if (fs.existsSync(outputPath)) {
+ const previous = fs.readFileSync(outputPath, 'utf8')
+ for (const [, list, body] of previous.matchAll(
+ /export const (\w+) = \{\n([\s\S]*?)\n\} as const/g,
+ )) {
+ for (const [, name, code] of body.matchAll(/\/\*\* (.+) \*\/\n {2}\S+: '([^']+)',/g)) {
+ existingNames.set(`${list}:${code}`, name)
+ }
+ }
+}
+
+const LISTS = [
+ {
+ name: 'CountryCode',
+ summary: 'ISO 3166-1 alpha-2 country codes, as Spree accepts them.',
+ displayNames: new Intl.DisplayNames('en', { type: 'region' }),
+ },
+ {
+ name: 'CurrencyCode',
+ summary: 'ISO 4217 currency codes, as Spree accepts them.',
+ displayNames: new Intl.DisplayNames('en', { type: 'currency' }),
+ },
+ {
+ name: 'LocaleCode',
+ summary:
+ 'Locale codes (an ISO 639-1 language, optionally with a region) a store may sell and translate content in.',
+ displayNames: new Intl.DisplayNames('en', { type: 'language' }),
+ },
+ {
+ name: 'WeightUnit',
+ summary: 'Units a weight is measured in.',
+ names: { g: 'Gram', kg: 'Kilogram', lb: 'Pound', oz: 'Ounce' },
+ },
+ {
+ name: 'DimensionUnit',
+ summary: 'Units a length, width, height or depth is measured in.',
+ names: { mm: 'Millimeter', cm: 'Centimeter', in: 'Inch', ft: 'Foot' },
+ },
+] as const satisfies ReadonlyArray<{
+ name: string
+ summary: string
+ displayNames?: Intl.DisplayNames
+ names?: Record<string, string>
+}>
+
+// `Intl.DisplayNames#of` throws on a code it considers malformed; the bare code
+// is the fallback name then.
+const displayName = (displayNames: Intl.DisplayNames, code: string) => {
+ try {
+ return displayNames.of(code) ?? code
+ } catch {
+ return code
+ }
+}
+
+// A locale's region needs a property name an identifier can use: `pt-BR` → `pt_BR`.
+const keyFor = (code: string) =>
+ /^[A-Za-z_][A-Za-z0-9_]*$/.test(code) ? code : code.replace(/-/g, '_')
+
+const sections = LISTS.map((list) => {
+ const { name, summary } = list
+ const codes = specs.map((spec) => spec.components?.schemas?.[name]?.enum).find(Boolean)
+ if (!codes?.length) throw new Error(`No API reference in docs/api-reference has a ${name} schema`)
+
+ // Units keep the server's order, smallest first, which is how a picker lists
+ // them; the long ISO lists are sorted.
+ const ordered = 'names' in list ? codes : [...codes].sort()
+ const nameOf = (code: string) =>
+ 'names' in list
+ ? ((list.names as Record<string, string>)[code] ?? code)
+ : (existingNames.get(`${name}:${code}`) ?? displayName(list.displayNames, code))
+
+ const entries = ordered
+ .map((code) => ` /** ${nameOf(code)} */\n ${keyFor(code)}: '${code}',`)
+ .join('\n')
+
+ return `/** ${summary} */
+export const ${name} = {
+${entries}
+} as const
+
+export type ${name} = (typeof ${name})[keyof typeof ${name}]`
+})
+
+const source = `// This file is auto-generated from docs/api-reference by \`pnpm generate:code-lists\`. Do not edit directly.
+
+${sections.join('\n\n')}
+`
+
+fs.writeFileSync(outputPath, source)
+console.log(`Wrote ${path.relative(root, outputPath)}`)
diff --git a/packages/sdk-core/scripts/generate-iso-codes.ts b/packages/sdk-core/scripts/generate-iso-codes.ts
deleted file mode 100644
index 262c39107f..0000000000
--- a/packages/sdk-core/scripts/generate-iso-codes.ts
+++ /dev/null
@@ -1,93 +0,0 @@
-import * as fs from 'node:fs'
-import * as path from 'node:path'
-import { parse } from 'yaml'
-
-// Writes the country, currency and locale code lists every SDK exports, from
-// the closed `CountryCode` / `CurrencyCode` / `LocaleCode` schemas in the Store
-// API reference — the server's own lists. Each code is documented with its
-// English name, so editors show "US Dollar" when hovering `USD`:
-//
-// pnpm generate:iso-codes
-//
-// A name comes from the runtime's `Intl.DisplayNames` only the first time its
-// code appears; after that it is read back from the generated file. Names
-// differ between Node versions, so this keeps the output the same on every
-// machine and lets CI check it.
-
-type Spec = { components: { schemas: Record<string, { enum?: string[] }> } }
-
-const root = path.resolve(import.meta.dirname, '../../..')
-const spec = parse(
- fs.readFileSync(path.join(root, 'docs/api-reference/store.yaml'), 'utf8'),
-) as Spec
-const outputPath = path.resolve(import.meta.dirname, '../src/iso-codes.generated.ts')
-
-// Names already written, keyed by code (the three lists never share a code).
-const existingNames = new Map<string, string>()
-if (fs.existsSync(outputPath)) {
- const previous = fs.readFileSync(outputPath, 'utf8')
- for (const [, name, code] of previous.matchAll(/\/\*\* (.+) \*\/\n {2}\S+: '([^']+)',/g)) {
- existingNames.set(code, name)
- }
-}
-
-const LISTS = [
- {
- name: 'CountryCode',
- summary: 'ISO 3166-1 alpha-2 country codes, as Spree accepts them.',
- displayNames: new Intl.DisplayNames('en', { type: 'region' }),
- },
- {
- name: 'CurrencyCode',
- summary: 'ISO 4217 currency codes, as Spree accepts them.',
- displayNames: new Intl.DisplayNames('en', { type: 'currency' }),
- },
- {
- name: 'LocaleCode',
- summary:
- 'Locale codes (an ISO 639-1 language, optionally with a region) a store may sell and translate content in.',
- displayNames: new Intl.DisplayNames('en', { type: 'language' }),
- },
-] as const
-
-// `Intl.DisplayNames#of` throws on a code it considers malformed; the bare code
-// is the fallback name then.
-const displayName = (displayNames: Intl.DisplayNames, code: string) => {
- try {
- return displayNames.of(code) ?? code
- } catch {
- return code
- }
-}
-
-// A locale's region needs a property name an identifier can use: `pt-BR` → `pt_BR`.
-const keyFor = (code: string) =>
- /^[A-Za-z_][A-Za-z0-9_]*$/.test(code) ? code : code.replace(/-/g, '_')
-
-const sections = LISTS.map(({ name, summary, displayNames }) => {
- const codes = spec.components.schemas[name]?.enum
- if (!codes?.length) throw new Error(`docs/api-reference/store.yaml has no ${name} schema`)
-
- const entries = [...codes]
- .sort()
- .map(
- (code) =>
- ` /** ${existingNames.get(code) ?? displayName(displayNames, code)} */\n ${keyFor(code)}: '${code}',`,
- )
- .join('\n')
-
- return `/** ${summary} */
-export const ${name} = {
-${entries}
-} as const
-
-export type ${name} = (typeof ${name})[keyof typeof ${name}]`
-})
-
-const source = `// This file is auto-generated from docs/api-reference/store.yaml by \`pnpm generate:iso-codes\`. Do not edit directly.
-
-${sections.join('\n\n')}
-`
-
-fs.writeFileSync(outputPath, source)
-console.log(`Wrote ${path.relative(root, outputPath)}`)
diff --git a/packages/sdk-core/src/iso-codes.generated.ts b/packages/sdk-core/src/code-lists.generated.ts
similarity index 96%
rename from packages/sdk-core/src/iso-codes.generated.ts
rename to packages/sdk-core/src/code-lists.generated.ts
index 9c4e824360..2a9869d8b8 100644
--- a/packages/sdk-core/src/iso-codes.generated.ts
+++ b/packages/sdk-core/src/code-lists.generated.ts
@@ -1,4 +1,4 @@
-// This file is auto-generated from docs/api-reference/store.yaml by `pnpm generate:iso-codes`. Do not edit directly.
+// This file is auto-generated from docs/api-reference by `pnpm generate:code-lists`. Do not edit directly.
/** ISO 3166-1 alpha-2 country codes, as Spree accepts them. */
export const CountryCode = {
@@ -1257,3 +1257,31 @@ export const LocaleCode = {
} as const
export type LocaleCode = (typeof LocaleCode)[keyof typeof LocaleCode]
+
+/** Units a weight is measured in. */
+export const WeightUnit = {
+ /** Gram */
+ g: 'g',
+ /** Kilogram */
+ kg: 'kg',
+ /** Pound */
+ lb: 'lb',
+ /** Ounce */
+ oz: 'oz',
+} as const
+
+export type WeightUnit = (typeof WeightUnit)[keyof typeof WeightUnit]
+
+/** Units a length, width, height or depth is measured in. */
+export const DimensionUnit = {
+ /** Millimeter */
+ mm: 'mm',
+ /** Centimeter */
+ cm: 'cm',
+ /** Inch */
+ in: 'in',
+ /** Foot */
+ ft: 'ft',
+} as const
+
+export type DimensionUnit = (typeof DimensionUnit)[keyof typeof DimensionUnit]
diff --git a/packages/sdk-core/src/index.ts b/packages/sdk-core/src/index.ts
index 6a18c0e829..90c90e5a27 100644
--- a/packages/sdk-core/src/index.ts
+++ b/packages/sdk-core/src/index.ts
@@ -1,5 +1,13 @@
// Request infrastructure
+// Code lists
+export {
+ CountryCode,
+ CurrencyCode,
+ DimensionUnit,
+ LocaleCode,
+ WeightUnit,
+} from './code-lists.generated'
export type { FilterSpec } from './filter-types'
export { renderAppFilterTypes, renderFilterTypes } from './filter-types'
export type {
@@ -17,8 +25,6 @@ export type {
export type { ResolvedRetryConfig } from './helpers'
// Helpers
export { getParams, resolveRetryConfig } from './helpers'
-// ISO codes
-export { CountryCode, CurrencyCode, LocaleCode } from './iso-codes.generated'
// Money
export {
compareMoney,
diff --git a/packages/sdk-core/src/params-types.ts b/packages/sdk-core/src/params-types.ts
index 87b250fa92..b280317e65 100644
--- a/packages/sdk-core/src/params-types.ts
+++ b/packages/sdk-core/src/params-types.ts
@@ -29,10 +29,16 @@ export interface ParamsSpec {
const isRequestSchema = (name: string) => name.endsWith('Params')
// Code lists the request schemas reference by name: ISO countries and
-// currencies, and Spree's locales. The response types generated beside these
-// files declare the same named types, so a request imports them from there
-// rather than repeating them.
-const SHARED_CODE_LISTS = new Set(['CountryCode', 'CurrencyCode', 'LocaleCode'])
+// currencies, Spree's locales and measurement units. The response types
+// generated beside these files declare the same named types, so a request
+// imports them from there rather than repeating them.
+const SHARED_CODE_LISTS = new Set([
+ 'CountryCode',
+ 'CurrencyCode',
+ 'LocaleCode',
+ 'WeightUnit',
+ 'DimensionUnit',
+])
function refName(ref: string): string {
const name = ref.replace('#/components/schemas/', '')
@@ -165,7 +171,9 @@ export function renderParamsTypes(spec: ParamsSpec): Map<string, string> {
}
if (imports.length) out.push('')
out.push(...docComment(schema.description, ''))
- out.push(`export type ${name} = ${objectType(schema, '')}`)
+ out.push(
+ `export type ${name} = ${schema.allOf ? valueType(schema, '') : objectType(schema, '')}`,
+ )
files.set(`${name}.ts`, `${out.join('\n')}\n`)
}
diff --git a/packages/sdk/package.json b/packages/sdk/package.json
index 8583beac41..2e95720d14 100644
--- a/packages/sdk/package.json
+++ b/packages/sdk/package.json
@@ -57,7 +57,7 @@
"generate:zod": "tsx ../sdk-core/scripts/generate-zod.ts",
"generate:filters": "tsx ../sdk-core/scripts/generate-filters.ts store",
"generate:params": "tsx ../sdk-core/scripts/generate-params.ts store",
- "generate:iso-codes": "tsx ../sdk-core/scripts/generate-iso-codes.ts",
+ "generate:code-lists": "tsx ../sdk-core/scripts/generate-code-lists.ts",
"build": "tsup",
"dev": "tsup --watch",
"console": "tsx console.ts",
diff --git a/packages/sdk/src/index.ts b/packages/sdk/src/index.ts
index 365565375a..7e0eb5564a 100644
--- a/packages/sdk/src/index.ts
+++ b/packages/sdk/src/index.ts
@@ -6,6 +6,7 @@ export {
CountryCode,
CurrencyCode,
compareMoney,
+ DimensionUnit,
decimalPlaces,
formatMoney,
isDecimalString,
@@ -16,6 +17,7 @@ export {
SpreeError,
subtractMoney,
sumMoney,
+ WeightUnit,
} from '@spree/sdk-core'
export type { Client, ClientConfig } from './client'
export { createClient } from './client'
diff --git a/packages/sdk/src/types/generated/Enums.ts b/packages/sdk/src/types/generated/Enums.ts
index b9ad04d723..5b05bd1859 100644
--- a/packages/sdk/src/types/generated/Enums.ts
+++ b/packages/sdk/src/types/generated/Enums.ts
@@ -1,10 +1,11 @@
-// Typelizer digest cf76bb0ba7923a1de42aef279d23dbc7
+// Typelizer digest d6c31229658dad8df6d30a1b0cd15713
//
// DO NOT MODIFY: This file was automatically generated by Typelizer.
export type ClaimStatus = 'open' | 'approved' | 'resolved' | 'denied' | 'canceled' | (string & {});
export type { CountryCode } from '@spree/sdk-core';
export type { CurrencyCode } from '@spree/sdk-core';
export type DataRequestStatus = 'pending' | 'processing' | 'completed' | 'failed' | (string & {});
+export type { DimensionUnit } from '@spree/sdk-core';
export type ExchangeStatus = 'requested' | 'approved' | 'received' | 'fulfilled' | 'canceled' | (string & {});
export type FeeKind = 'surcharge' | 'handling' | 'gift_wrap' | 'cod' | 'payment' | 'duty' | 'exchange' | (string & {});
export type FulfillmentStatus = 'unfulfilled' | 'fulfilled' | 'delivered' | 'canceled' | (string & {});
@@ -19,3 +20,4 @@ export type PaymentStatus = 'checkout' | 'processing' | 'pending' | 'completed'
export type ProductSubmissionStatus = 'pending' | 'approved' | 'rejected' | 'withdrawn' | (string & {});
export type ReturnStatus = 'requested' | 'approved' | 'received' | 'refunded' | 'canceled' | (string & {});
export type ShippingLabelStatus = 'purchased' | 'refund_requested' | 'refunded' | (string & {});
+export type { WeightUnit } from '@spree/sdk-core';
diff --git a/packages/sdk/src/types/generated/Variant.ts b/packages/sdk/src/types/generated/Variant.ts
index ab779ebd9d..85e270bc25 100644
--- a/packages/sdk/src/types/generated/Variant.ts
+++ b/packages/sdk/src/types/generated/Variant.ts
@@ -1,7 +1,7 @@
-// Typelizer digest 1186949b299953f6034501b5fcbf4d3a
+// Typelizer digest 05ca910d3ebb0c6ce232fd224b019df4
//
// DO NOT MODIFY: This file was automatically generated by Typelizer.
-import type {Price, PriceHistory, Seller, Media, OptionValue, CustomField} from '@/types'
+import type {Price, PriceHistory, Seller, Media, OptionValue, CustomField, WeightUnit, DimensionUnit} from '@/types'
interface Variant {
id: string;
@@ -20,8 +20,8 @@ interface Variant {
height: number | null;
width: number | null;
depth: number | null;
- weight_unit: 'g' | 'kg' | 'lb' | 'oz';
- dimensions_unit: 'mm' | 'cm' | 'in' | 'ft';
+ weight_unit: WeightUnit;
+ dimensions_unit: DimensionUnit;
minimum_order_quantity: number;
order_multiple: number;
purchase_unit: 'unit' | 'carton';
diff --git a/packages/sdk/src/types/generated/index.ts b/packages/sdk/src/types/generated/index.ts
index 6bab01e480..0166711ce3 100644
--- a/packages/sdk/src/types/generated/index.ts
+++ b/packages/sdk/src/types/generated/index.ts
@@ -1,7 +1,7 @@
-// Typelizer digest ae942ced59c0aa34ba85a81e7fe50929
+// Typelizer digest 38b1abb78a641134b2e2551384a19f9d
//
// DO NOT MODIFY: This file was automatically generated by Typelizer.
-export type { ClaimStatus, CountryCode, CurrencyCode, DataRequestStatus, ExchangeStatus, FeeKind, FulfillmentStatus, GiftCardStatus, ImportRowStatus, ImportStatus, InvitationStatus, LocaleCode, PaymentSessionStatus, PaymentSetupSessionStatus, PaymentStatus, ProductSubmissionStatus, ReturnStatus, ShippingLabelStatus } from './Enums'
+export type { ClaimStatus, CountryCode, CurrencyCode, DataRequestStatus, DimensionUnit, ExchangeStatus, FeeKind, FulfillmentStatus, GiftCardStatus, ImportRowStatus, ImportStatus, InvitationStatus, LocaleCode, PaymentSessionStatus, PaymentSetupSessionStatus, PaymentStatus, ProductSubmissionStatus, ReturnStatus, ShippingLabelStatus, WeightUnit } from './Enums'
export type { default as Address } from './Address'
export type { default as AppliedPromotion } from './AppliedPromotion'
export type { default as Base } from './Base'
diff --git a/packages/seller-sdk/src/index.ts b/packages/seller-sdk/src/index.ts
index 6660cb35e2..2ba6058caf 100644
--- a/packages/seller-sdk/src/index.ts
+++ b/packages/seller-sdk/src/index.ts
@@ -11,6 +11,7 @@ export {
CountryCode,
CurrencyCode,
compareMoney,
+ DimensionUnit,
decimalPlaces,
formatMoney,
isDecimalString,
@@ -21,6 +22,7 @@ export {
SpreeError,
subtractMoney,
sumMoney,
+ WeightUnit,
} from '@spree/sdk-core'
// `Client` is the whole configured client (auth + resources + token/seller
// setters); `SellerClient` below is just the resource group. Exported under
@@ -51,6 +53,7 @@ export type {
SellerCountry,
SellerExportCreateParams,
SellerExportType,
+ SellerProductVariantParams,
StockLocationCreateParams,
StockLocationUpdateParams,
} from './seller-client'
diff --git a/packages/seller-sdk/src/seller-client.ts b/packages/seller-sdk/src/seller-client.ts
index f109859d5f..9b95cf4f38 100644
--- a/packages/seller-sdk/src/seller-client.ts
+++ b/packages/seller-sdk/src/seller-client.ts
@@ -107,6 +107,7 @@ import type {
ProductBulkSubmitParams,
ProductCreateParams,
ProductUpdateParams,
+ ProductVariantParams,
ProfileUpdateParams,
RequirementSubmissionParams,
ReturnCancelParams,
@@ -124,6 +125,9 @@ import type {
export type * from './types/params'
+/** @deprecated Renamed to `ProductVariantParams`. */
+export type SellerProductVariantParams = ProductVariantParams
+
/**
* Resource methods for the Spree Seller API — the marketplace seller panel.
*
diff --git a/packages/seller-sdk/src/types/generated/Enums.ts b/packages/seller-sdk/src/types/generated/Enums.ts
index b8cb9c2998..6b88b6a7df 100644
--- a/packages/seller-sdk/src/types/generated/Enums.ts
+++ b/packages/seller-sdk/src/types/generated/Enums.ts
@@ -1,9 +1,10 @@
-// Typelizer digest abc180ca671a51568e4acdd2b19a54a6
+// Typelizer digest 4510ea48f0daea8d6b462a6990fedf77
//
// DO NOT MODIFY: This file was automatically generated by Typelizer.
export type ClaimStatus = 'open' | 'approved' | 'resolved' | 'denied' | 'canceled' | (string & {});
export type { CountryCode } from '@spree/sdk-core';
export type { CurrencyCode } from '@spree/sdk-core';
+export type { DimensionUnit } from '@spree/sdk-core';
export type ExchangeStatus = 'requested' | 'approved' | 'received' | 'fulfilled' | 'canceled' | (string & {});
export type FulfillmentStatus = 'unfulfilled' | 'fulfilled' | 'delivered' | 'canceled' | (string & {});
export type ImportRowStatus = 'pending' | 'processing' | 'completed' | 'failed' | (string & {});
@@ -16,3 +17,4 @@ export type SellerRequirementSubmissionStatus = 'pending' | 'accepted' | 'reject
export type SellerStatus = 'pending' | 'invited' | 'canceled' | 'onboarding' | 'ready_for_review' | 'approved' | 'rejected' | 'suspended' | (string & {});
export type ShippingLabelStatus = 'purchased' | 'refund_requested' | 'refunded' | (string & {});
export type StockLocationKind = 'warehouse' | 'store' | 'fulfillment_center' | (string & {});
+export type { WeightUnit } from '@spree/sdk-core';
diff --git a/packages/seller-sdk/src/types/generated/PackageType.ts b/packages/seller-sdk/src/types/generated/PackageType.ts
index dd922fa88f..d62ffe86ca 100644
--- a/packages/seller-sdk/src/types/generated/PackageType.ts
+++ b/packages/seller-sdk/src/types/generated/PackageType.ts
@@ -1,6 +1,7 @@
-// Typelizer digest c9be44dbd031312ad424cf48212eaf83
+// Typelizer digest abb3545569a8ce72b4c66999664fca9c
//
// DO NOT MODIFY: This file was automatically generated by Typelizer.
+import type {DimensionUnit, WeightUnit} from '@/types'
type PackageType = {
id: string;
@@ -15,8 +16,8 @@ type PackageType = {
metadata: Record<string, unknown> | null;
created_at: string;
updated_at: string;
- dimensions_unit: 'mm' | 'cm' | 'in' | 'ft';
- weight_unit: 'g' | 'kg' | 'lb' | 'oz';
+ dimensions_unit: DimensionUnit;
+ weight_unit: WeightUnit;
volume: string | null;
editable: boolean;
}
diff --git a/packages/seller-sdk/src/types/generated/Variant.ts b/packages/seller-sdk/src/types/generated/Variant.ts
index 496c1b6452..9b2d31e898 100644
--- a/packages/seller-sdk/src/types/generated/Variant.ts
+++ b/packages/seller-sdk/src/types/generated/Variant.ts
@@ -1,7 +1,7 @@
-// Typelizer digest 8a85f7a21938b71b0aeecb1809e9861b
+// Typelizer digest 7dec84a4d81d921f20568d64bcc06d4a
//
// DO NOT MODIFY: This file was automatically generated by Typelizer.
-import type {Price, PriceHistory, Seller, Media, OptionValue, CustomField, StockLevel, CurrencyCode, CountryCode} from '@/types'
+import type {Price, PriceHistory, Seller, Media, OptionValue, CustomField, StockLevel, WeightUnit, DimensionUnit, CurrencyCode, CountryCode} from '@/types'
type Variant = {
id: string;
@@ -20,8 +20,8 @@ type Variant = {
height: number | null;
width: number | null;
depth: number | null;
- weight_unit: 'g' | 'kg' | 'lb' | 'oz';
- dimensions_unit: 'mm' | 'cm' | 'in' | 'ft';
+ weight_unit: WeightUnit;
+ dimensions_unit: DimensionUnit;
minimum_order_quantity: number | null;
order_multiple: number | null;
purchase_unit: 'unit' | 'carton' | null;
diff --git a/packages/seller-sdk/src/types/generated/index.ts b/packages/seller-sdk/src/types/generated/index.ts
index ad1ddd6a61..c84e51f3d9 100644
--- a/packages/seller-sdk/src/types/generated/index.ts
+++ b/packages/seller-sdk/src/types/generated/index.ts
@@ -1,7 +1,7 @@
-// Typelizer digest 5318e9b64792e9a196e8f346a2883e01
+// Typelizer digest cf1009151ae7c417f75ea6a9689fd70a
//
// DO NOT MODIFY: This file was automatically generated by Typelizer.
-export type { ClaimStatus, CountryCode, CurrencyCode, ExchangeStatus, FulfillmentStatus, ImportRowStatus, ImportStatus, InvitationStatus, ProductStatus, ProductSubmissionStatus, ReturnStatus, SellerRequirementSubmissionStatus, SellerStatus, ShippingLabelStatus, StockLocationKind } from './Enums'
+export type { ClaimStatus, CountryCode, CurrencyCode, DimensionUnit, ExchangeStatus, FulfillmentStatus, ImportRowStatus, ImportStatus, InvitationStatus, ProductStatus, ProductSubmissionStatus, ReturnStatus, SellerRequirementSubmissionStatus, SellerStatus, ShippingLabelStatus, StockLocationKind, WeightUnit } from './Enums'
export type { default as Category } from './Category'
export type { default as CustomField } from './CustomField'
export type { default as OptionType } from './OptionType'
diff --git a/packages/seller-sdk/src/types/params/PackageTypeCreateParams.ts b/packages/seller-sdk/src/types/params/PackageTypeCreateParams.ts
index 864ba9233d..0d719e4991 100644
--- a/packages/seller-sdk/src/types/params/PackageTypeCreateParams.ts
+++ b/packages/seller-sdk/src/types/params/PackageTypeCreateParams.ts
@@ -1,16 +1,19 @@
// This file is auto-generated from the request schemas in docs/api-reference by `pnpm generate:params`. Do not edit directly.
+import type { DimensionUnit } from '../generated'
+import type { WeightUnit } from '../generated'
+
export type PackageTypeCreateParams = {
name: string
kind?: 'box' | 'envelope' | 'carton' | 'pallet' | 'container'
length?: number | null
width?: number | null
height?: number | null
- dimensions_unit?: 'mm' | 'cm' | 'in' | 'ft' | null
+ dimensions_unit?: DimensionUnit | null
/** The empty package's own weight, added to every quote. */
weight?: number | null
max_weight?: number | null
- weight_unit?: 'g' | 'kg' | 'lb' | 'oz' | null
+ weight_unit?: WeightUnit | null
/**
* Makes this the box this seller's parcels are quoted with. One default per seller, so it never
* displaces the marketplace's.
diff --git a/packages/seller-sdk/src/types/params/PackageTypeUpdateParams.ts b/packages/seller-sdk/src/types/params/PackageTypeUpdateParams.ts
index a617580b2b..a35be7b71c 100644
--- a/packages/seller-sdk/src/types/params/PackageTypeUpdateParams.ts
+++ b/packages/seller-sdk/src/types/params/PackageTypeUpdateParams.ts
@@ -1,16 +1,19 @@
// This file is auto-generated from the request schemas in docs/api-reference by `pnpm generate:params`. Do not edit directly.
+import type { DimensionUnit } from '../generated'
+import type { WeightUnit } from '../generated'
+
export type PackageTypeUpdateParams = {
name?: string
kind?: 'box' | 'envelope' | 'carton' | 'pallet' | 'container'
length?: number | null
width?: number | null
height?: number | null
- dimensions_unit?: 'mm' | 'cm' | 'in' | 'ft' | null
+ dimensions_unit?: DimensionUnit | null
/** The empty package's own weight, added to every quote. */
weight?: number | null
max_weight?: number | null
- weight_unit?: 'g' | 'kg' | 'lb' | 'oz' | null
+ weight_unit?: WeightUnit | null
/**
* Makes this the box this seller's parcels are quoted with. One default per seller, so it never
* displaces the marketplace's.
diff --git a/packages/seller-sdk/src/types/params/ProductCreateParams.ts b/packages/seller-sdk/src/types/params/ProductCreateParams.ts
index b39dee7ff6..c67fbaab65 100644
--- a/packages/seller-sdk/src/types/params/ProductCreateParams.ts
+++ b/packages/seller-sdk/src/types/params/ProductCreateParams.ts
@@ -1,8 +1,8 @@
// This file is auto-generated from the request schemas in docs/api-reference by `pnpm generate:params`. Do not edit directly.
import type { CurrencyCode } from '../generated'
+import type { ProductVariantParams } from './ProductVariantParams'
import type { SellerProductMediaParams } from './SellerProductMediaParams'
-import type { SellerProductVariantParams } from './SellerProductVariantParams'
export type ProductCreateParams = {
name: string
@@ -45,5 +45,5 @@ export type ProductCreateParams = {
* The variants, as a whole: one absent from the list is removed. Pass `id` to update an existing
* variant.
*/
- variants?: SellerProductVariantParams[]
+ variants?: ProductVariantParams[]
}
diff --git a/packages/seller-sdk/src/types/params/ProductUpdateParams.ts b/packages/seller-sdk/src/types/params/ProductUpdateParams.ts
index f10d2b1ac3..058f6103b6 100644
--- a/packages/seller-sdk/src/types/params/ProductUpdateParams.ts
+++ b/packages/seller-sdk/src/types/params/ProductUpdateParams.ts
@@ -1,8 +1,8 @@
// This file is auto-generated from the request schemas in docs/api-reference by `pnpm generate:params`. Do not edit directly.
import type { CurrencyCode } from '../generated'
+import type { ProductVariantParams } from './ProductVariantParams'
import type { SellerProductMediaParams } from './SellerProductMediaParams'
-import type { SellerProductVariantParams } from './SellerProductVariantParams'
export type ProductUpdateParams = {
name?: string
@@ -45,5 +45,5 @@ export type ProductUpdateParams = {
* The variants, as a whole: one absent from the list is removed. Pass `id` to update an existing
* variant.
*/
- variants?: SellerProductVariantParams[]
+ variants?: ProductVariantParams[]
}
diff --git a/packages/seller-sdk/src/types/params/ProductVariantParams.ts b/packages/seller-sdk/src/types/params/ProductVariantParams.ts
new file mode 100644
index 0000000000..f584df36c6
--- /dev/null
+++ b/packages/seller-sdk/src/types/params/ProductVariantParams.ts
@@ -0,0 +1,7 @@
+// This file is auto-generated from the request schemas in docs/api-reference by `pnpm generate:params`. Do not edit directly.
+
+import type { VariantParams } from './VariantParams'
+
+export type ProductVariantParams = VariantParams & {
+ id?: string
+}
diff --git a/packages/seller-sdk/src/types/params/SellerProductVariantParams.ts b/packages/seller-sdk/src/types/params/VariantParams.ts
similarity index 63%
rename from packages/seller-sdk/src/types/params/SellerProductVariantParams.ts
rename to packages/seller-sdk/src/types/params/VariantParams.ts
index 3d1e7a498f..0a70542207 100644
--- a/packages/seller-sdk/src/types/params/SellerProductVariantParams.ts
+++ b/packages/seller-sdk/src/types/params/VariantParams.ts
@@ -2,11 +2,12 @@
import type { CountryCode } from '../generated'
import type { CurrencyCode } from '../generated'
+import type { DimensionUnit } from '../generated'
import type { StockLevelParams } from './StockLevelParams'
import type { VariantOptionParams } from './VariantOptionParams'
+import type { WeightUnit } from '../generated'
-export type SellerProductVariantParams = {
- id?: string
+export type VariantParams = {
sku?: string
barcode?: string
cost_price?: string | null
@@ -15,25 +16,38 @@ export type SellerProductVariantParams = {
height?: number | null
width?: number | null
depth?: number | null
- weight_unit?: 'g' | 'kg' | 'lb' | 'oz'
- dimensions_unit?: 'mm' | 'cm' | 'in' | 'ft'
+ /** Null falls back to the store's weight unit. */
+ weight_unit?: WeightUnit | null
+ /** Null falls back to the store's unit system. */
+ dimensions_unit?: DimensionUnit | null
hs_code?: string
customs_description?: string
country_of_origin?: CountryCode
minimum_order_quantity?: number | null
order_multiple?: number | null
- purchase_unit?: string
+ purchase_unit?: 'unit' | 'carton' | null
/** How many units fill one carton. */
units_per_carton?: number | null
- /** The carton this variant is packed into: a package type of kind `carton`. */
+ /**
+ * The carton this variant is packed into: a package type of kind `carton`. Its dimensions are
+ * shared by every product packed the same way, so a corrected carton size fixes all of them at
+ * once.
+ */
carton_package_type_id?: string | null
/** What one packed carton weighs, in the variant's weight unit. */
carton_weight?: number | null
/** How many cartons stack on one pallet. */
cartons_per_pallet?: number | null
track_inventory?: boolean
+ /**
+ * Sell this variant before it's in stock. Adds the pre-order label and ships-by promise; the cap
+ * comes from `backorder_limit`, an incoming stock count, or backorder.
+ */
preorderable?: boolean
- /** The "ships by" date shown to customers while the variant is a pre-order. Null clears it. */
+ /**
+ * The "ships by" date shown to customers while the variant is a pre-order. Once it passes, the
+ * variant is no longer a pre-order. Null clears it.
+ */
preorder_ships_at?: string | null
/**
* Maximum units sellable beyond available stock, capping backorders and pre-orders. Null is
@@ -41,7 +55,10 @@ export type SellerProductVariantParams = {
*/
backorder_limit?: number | null
position?: number
- /** One pair per option type the variant takes part in (size, color). */
+ /**
+ * One pair per option type the variant takes part in (size, color). Option types and values are
+ * created when missing.
+ */
options?: VariantOptionParams[]
/** Per-currency prices. Upserted by currency. */
prices?: {
diff --git a/packages/seller-sdk/src/types/params/index.ts b/packages/seller-sdk/src/types/params/index.ts
index bc7f1dc1dc..cae2166093 100644
--- a/packages/seller-sdk/src/types/params/index.ts
+++ b/packages/seller-sdk/src/types/params/index.ts
@@ -39,6 +39,7 @@ export type { ProductBulkStatusParams } from './ProductBulkStatusParams'
export type { ProductBulkSubmitParams } from './ProductBulkSubmitParams'
export type { ProductCreateParams } from './ProductCreateParams'
export type { ProductUpdateParams } from './ProductUpdateParams'
+export type { ProductVariantParams } from './ProductVariantParams'
export type { ProfileUpdateParams } from './ProfileUpdateParams'
export type { RequirementSubmissionParams } from './RequirementSubmissionParams'
export type { ReturnCancelParams } from './ReturnCancelParams'
@@ -48,7 +49,6 @@ export type { ReturnRefundParams } from './ReturnRefundParams'
export type { SellerAddressParams } from './SellerAddressParams'
export type { SellerExportCreateParams } from './SellerExportCreateParams'
export type { SellerProductMediaParams } from './SellerProductMediaParams'
-export type { SellerProductVariantParams } from './SellerProductVariantParams'
export type { SellerTaxIdentifierCreateParams } from './SellerTaxIdentifierCreateParams'
export type { SellerTaxIdentifierUpdateParams } from './SellerTaxIdentifierUpdateParams'
export type { ShippingLabelCreateParams } from './ShippingLabelCreateParams'
@@ -57,3 +57,4 @@ export type { StockLocationCreateParams } from './StockLocationCreateParams'
export type { StockLocationUpdateParams } from './StockLocationUpdateParams'
export type { TeamMemberCreateParams } from './TeamMemberCreateParams'
export type { VariantOptionParams } from './VariantOptionParams'
+export type { VariantParams } from './VariantParams'
diff --git a/spree/api/app/controllers/spree/api/v3/admin/package_types_controller.rb b/spree/api/app/controllers/spree/api/v3/admin/package_types_controller.rb
index 88e89b6736..4347e3b5b4 100644
--- a/spree/api/app/controllers/spree/api/v3/admin/package_types_controller.rb
+++ b/spree/api/app/controllers/spree/api/v3/admin/package_types_controller.rb
@@ -27,9 +27,8 @@ module Spree
body.attribute :length, :number, nullable: true
body.attribute :width, :number, nullable: true
body.attribute :height, :number, nullable: true
- body.attribute :dimensions_unit, :string,
+ body.attribute :dimensions_unit, :dimension_unit,
nullable: true,
- choices: Spree::Variant::DIMENSION_UNITS,
example: 'cm',
description: "Unit the three dimensions are in; falls back to the store's unit system."
body.attribute :weight, :number,
@@ -38,7 +37,7 @@ module Spree
body.attribute :max_weight, :number,
nullable: true,
description: 'What the package can hold, not the same as its own weight.'
- body.attribute :weight_unit, :string, nullable: true, choices: Spree::Variant::WEIGHT_UNITS, example: 'kg'
+ body.attribute :weight_unit, :weight_unit, nullable: true, example: 'kg'
body.attribute :default, :boolean,
description: 'The box every parcel quote is built on. Setting this demotes whichever row held it.'
body.attribute :metadata, :hash
diff --git a/spree/api/app/controllers/spree/api/v3/admin/products/variants_controller.rb b/spree/api/app/controllers/spree/api/v3/admin/products/variants_controller.rb
index 6ffc570deb..5f74d8a999 100644
--- a/spree/api/app/controllers/spree/api/v3/admin/products/variants_controller.rb
+++ b/spree/api/app/controllers/spree/api/v3/admin/products/variants_controller.rb
@@ -7,11 +7,10 @@ module Spree
scoped_resource :products
request_params :variant do |body|
+ body.extends Spree::Api::V3::Admin::VariantRequestSchema
body.external_references
- body.include_attributes Spree::Api::V3::VariantRequestSchema
- body.attribute :options, :array, of: Spree::Api::V3::VariantOptionRequestSchema,
- required: true, on: :create,
- description: 'One pair per option type the variant takes part in (size, color). Option types and values are created when missing. On update, omit to leave the option values untouched.'
+ body.require_attributes :options, on: :create
+ body.describe_attribute :options, 'One pair per option type the variant takes part in (size, color). Option types and values are created when missing. On update, omit to leave the option values untouched.'
end
protected
diff --git a/spree/api/app/controllers/spree/api/v3/admin/products_controller.rb b/spree/api/app/controllers/spree/api/v3/admin/products_controller.rb
index 6277fa0c08..7577786951 100644
--- a/spree/api/app/controllers/spree/api/v3/admin/products_controller.rb
+++ b/spree/api/app/controllers/spree/api/v3/admin/products_controller.rb
@@ -77,10 +77,8 @@ module Spree
body.attribute :variants, :array,
as: 'ProductVariantParams',
description: 'Every purchasable attribute (sku, prices, stock, weight, dimensions) lives on variants. An entry without `options` upserts onto the default variant of a simple product; pass `id` to update an existing variant.' do |variant|
+ variant.extends Spree::Api::V3::Admin::VariantRequestSchema
variant.attribute :id, :id
- variant.include_attributes Spree::Api::V3::VariantRequestSchema
- variant.attribute :options, :array, of: Spree::Api::V3::VariantOptionRequestSchema,
- description: 'One pair per option type the variant takes part in (size, color). Option types and values are created when missing.'
end
end
diff --git a/spree/api/app/controllers/spree/api/v3/admin/store_controller.rb b/spree/api/app/controllers/spree/api/v3/admin/store_controller.rb
index 22f4ea5d29..c5017b490a 100644
--- a/spree/api/app/controllers/spree/api/v3/admin/store_controller.rb
+++ b/spree/api/app/controllers/spree/api/v3/admin/store_controller.rb
@@ -9,7 +9,7 @@ module Spree
body.attribute :name, :string, example: 'My Store'
body.attribute :admin_locale, :string, example: 'en'
body.attribute :timezone, :string, example: 'Europe/Berlin'
- body.attribute :weight_unit, :string, choices: Spree::Variant::WEIGHT_UNITS
+ body.attribute :weight_unit, :weight_unit
body.attribute :unit_system, :string, choices: Spree::Store::UNIT_SYSTEMS
body.attribute :storefront_access, :string,
choices: Spree::Channel::Gating::STOREFRONT_ACCESS,
diff --git a/spree/api/app/controllers/spree/api/v3/seller/package_types_controller.rb b/spree/api/app/controllers/spree/api/v3/seller/package_types_controller.rb
index 400c368358..2122a753c7 100644
--- a/spree/api/app/controllers/spree/api/v3/seller/package_types_controller.rb
+++ b/spree/api/app/controllers/spree/api/v3/seller/package_types_controller.rb
@@ -28,12 +28,12 @@ module Spree
body.attribute :length, :number, nullable: true
body.attribute :width, :number, nullable: true
body.attribute :height, :number, nullable: true
- body.attribute :dimensions_unit, :string, nullable: true, choices: Spree::Variant::DIMENSION_UNITS
+ body.attribute :dimensions_unit, :dimension_unit, nullable: true
body.attribute :weight, :number,
nullable: true,
description: "The empty package's own weight, added to every quote."
body.attribute :max_weight, :number, nullable: true
- body.attribute :weight_unit, :string, nullable: true, choices: Spree::Variant::WEIGHT_UNITS
+ body.attribute :weight_unit, :weight_unit, nullable: true
body.attribute :default, :boolean,
description: "Makes this the box this seller's parcels are quoted with. One default per seller, so it never displaces the marketplace's."
body.attribute :metadata, :hash, nullable: true
diff --git a/spree/api/app/controllers/spree/api/v3/seller/products_controller.rb b/spree/api/app/controllers/spree/api/v3/seller/products_controller.rb
index 33648d0769..5e58919206 100644
--- a/spree/api/app/controllers/spree/api/v3/seller/products_controller.rb
+++ b/spree/api/app/controllers/spree/api/v3/seller/products_controller.rb
@@ -41,19 +41,6 @@ module Spree
'archived' => -> { Spree.product_archive_workflow }
}.freeze
- # The operator's price shape, except `currency` may be left out: the
- # store's currency is assumed (see `default_price_currencies`).
- PRICE = Spree::Api::V3::RequestSchema.new do |schema|
- schema.attribute :currency, :currency,
- example: 'USD',
- description: "Omit to price in the store's currency. A seller has no currency of their own."
- schema.attribute :amount, :decimal,
- required: true,
- example: '24.00',
- description: 'A canonical decimal string (`"1234.56"`: period decimal, no grouping). The API does not parse localized input.'
- schema.attribute :compare_at_amount, :decimal, nullable: true, example: '30.00'
- end
-
scoped_resource :products
request_params :product do |body|
@@ -69,7 +56,7 @@ module Spree
description: "The marketplace's product type this product is listed against, from the product types endpoint. Null detaches it. Saving with a type seeds its option types onto the product."
body.attribute :delivery_profile_id, :id,
description: "Which of the marketplace's delivery profiles the product ships under. A new product sent without one lands on the profile marked default."
- body.attribute :prices, :array, of: PRICE,
+ body.attribute :prices, :array, of: Spree::Api::V3::Seller::PriceRequestSchema,
description: "Shorthand for a simple (no-options) product: per-currency prices that forward to the product's sole variant."
# `external_url` stays out for the same reason it does on the
# operator's endpoint: it would make the server fetch a URL the
@@ -83,56 +70,11 @@ module Spree
media_item.attribute :variant_ids, :array, of: :id,
description: 'Replaces the variants this media is linked to. An empty list clears them.'
end
- # Narrower than the operator's variant set: `seller_id` would let a
- # payload hand a variant to somebody else, and
- # `tax_category_id`/`delivery_profile_id` are marketplace
- # configuration.
body.attribute :variants, :array,
- as: 'SellerProductVariantParams',
+ as: 'ProductVariantParams',
description: 'The variants, as a whole: one absent from the list is removed. Pass `id` to update an existing variant.' do |variant|
+ variant.extends Spree::Api::V3::Seller::VariantRequestSchema
variant.attribute :id, :id
- variant.attribute :sku, :string
- variant.attribute :barcode, :string
- variant.attribute :cost_price, :decimal, nullable: true
- variant.attribute :cost_currency, :currency
- variant.attribute :weight, :number, nullable: true
- variant.attribute :height, :number, nullable: true
- variant.attribute :width, :number, nullable: true
- variant.attribute :depth, :number, nullable: true
- variant.attribute :weight_unit, :string, choices: Spree::Variant::WEIGHT_UNITS
- variant.attribute :dimensions_unit, :string, choices: Spree::Variant::DIMENSION_UNITS
- variant.attribute :hs_code, :string
- variant.attribute :customs_description, :string
- variant.attribute :country_of_origin, :country
- variant.attribute :minimum_order_quantity, :integer, nullable: true
- variant.attribute :order_multiple, :integer, nullable: true
- variant.attribute :purchase_unit, :string
- variant.attribute :units_per_carton, :integer,
- nullable: true,
- description: 'How many units fill one carton.'
- variant.attribute :carton_package_type_id, :id,
- nullable: true,
- description: 'The carton this variant is packed into: a package type of kind `carton`.'
- variant.attribute :carton_weight, :number,
- nullable: true,
- description: "What one packed carton weighs, in the variant's weight unit."
- variant.attribute :cartons_per_pallet, :integer,
- nullable: true,
- description: 'How many cartons stack on one pallet.'
- variant.attribute :track_inventory, :boolean
- variant.attribute :preorderable, :boolean
- variant.attribute :preorder_ships_at, :datetime,
- nullable: true,
- description: 'The "ships by" date shown to customers while the variant is a pre-order. Null clears it.'
- variant.attribute :backorder_limit, :integer,
- nullable: true,
- description: 'Maximum units sellable beyond available stock, capping backorders and pre-orders. Null is unlimited.'
- variant.attribute :position, :integer
- variant.attribute :options, :array, of: Spree::Api::V3::VariantOptionRequestSchema,
- description: 'One pair per option type the variant takes part in (size, color).'
- variant.attribute :prices, :array, of: PRICE, description: 'Per-currency prices. Upserted by currency.'
- variant.attribute :stock_levels, :array, of: Spree::Api::V3::StockLevelRequestSchema,
- description: "Stock per location, at this seller's own locations only: a location belonging to anyone else is ignored."
end
end
diff --git a/spree/api/app/request_schemas/spree/api/v3/admin/variant_request_schema.rb b/spree/api/app/request_schemas/spree/api/v3/admin/variant_request_schema.rb
new file mode 100644
index 0000000000..3f32fdb1eb
--- /dev/null
+++ b/spree/api/app/request_schemas/spree/api/v3/admin/variant_request_schema.rb
@@ -0,0 +1,21 @@
+module Spree
+ module Api
+ module V3
+ module Admin
+ # The shared variant attributes, plus the marketplace configuration
+ # only an operator sets.
+ class VariantRequestSchema < Spree::Api::V3::VariantRequestSchema
+ publishes 'VariantParams'
+
+ attribute :seller_id, :id
+ attribute :delivery_profile_id, :id, nullable: true
+ attribute :tax_category_id, :id
+ attribute :prices, :array, of: Spree::Api::V3::PriceRequestSchema,
+ description: 'Per-currency prices. Upserted by currency.'
+ attribute :stock_levels, :array, of: Spree::Api::V3::StockLevelRequestSchema,
+ description: 'Stock per location. Upserted by location; omitted locations are removed.'
+ end
+ end
+ end
+ end
+end
diff --git a/spree/api/app/request_schemas/spree/api/v3/seller/price_request_schema.rb b/spree/api/app/request_schemas/spree/api/v3/seller/price_request_schema.rb
new file mode 100644
index 0000000000..1731f69d58
--- /dev/null
+++ b/spree/api/app/request_schemas/spree/api/v3/seller/price_request_schema.rb
@@ -0,0 +1,20 @@
+module Spree
+ module Api
+ module V3
+ module Seller
+ # The operator's price shape, except `currency` may be left out: the
+ # store's currency is assumed (see `default_price_currencies`).
+ class PriceRequestSchema < Spree::Api::V3::RequestSchema
+ attribute :currency, :currency,
+ example: 'USD',
+ description: "Omit to price in the store's currency. A seller has no currency of their own."
+ attribute :amount, :decimal,
+ required: true,
+ example: '24.00',
+ description: 'A canonical decimal string (`"1234.56"`: period decimal, no grouping). The API does not parse localized input.'
+ attribute :compare_at_amount, :decimal, nullable: true, example: '30.00'
+ end
+ end
+ end
+ end
+end
diff --git a/spree/api/app/request_schemas/spree/api/v3/seller/variant_request_schema.rb b/spree/api/app/request_schemas/spree/api/v3/seller/variant_request_schema.rb
new file mode 100644
index 0000000000..2fde283d80
--- /dev/null
+++ b/spree/api/app/request_schemas/spree/api/v3/seller/variant_request_schema.rb
@@ -0,0 +1,19 @@
+module Spree
+ module Api
+ module V3
+ module Seller
+ # The shared variant attributes. Narrower than the operator's set:
+ # `seller_id` would let a payload hand a variant to somebody else, and
+ # `tax_category_id`/`delivery_profile_id` are marketplace configuration.
+ class VariantRequestSchema < Spree::Api::V3::VariantRequestSchema
+ publishes 'VariantParams'
+
+ attribute :prices, :array, of: Spree::Api::V3::Seller::PriceRequestSchema,
+ description: 'Per-currency prices. Upserted by currency.'
+ attribute :stock_levels, :array, of: Spree::Api::V3::StockLevelRequestSchema,
+ description: "Stock per location, at this seller's own locations only: a location belonging to anyone else is ignored."
+ end
+ end
+ end
+ end
+end
diff --git a/spree/api/app/request_schemas/spree/api/v3/variant_request_schema.rb b/spree/api/app/request_schemas/spree/api/v3/variant_request_schema.rb
index 2b3e7cdd66..e7f199dfa8 100644
--- a/spree/api/app/request_schemas/spree/api/v3/variant_request_schema.rb
+++ b/spree/api/app/request_schemas/spree/api/v3/variant_request_schema.rb
@@ -1,9 +1,9 @@
module Spree
module Api
module V3
- # A variant's own attributes, shared by the variant endpoints and the
- # variants nested in a product payload. Not published on its own: each
- # endpoint includes these fields into its own type.
+ # A variant's own attributes, the ones a seller may write too. Each API
+ # publishes its own `VariantParams` from a subclass, which the variant
+ # endpoints and the variants nested in a product payload both extend.
class VariantRequestSchema < Spree::Api::V3::RequestSchema
attribute :sku, :string
attribute :barcode, :string
@@ -13,14 +13,14 @@ module Spree
attribute :height, :number, nullable: true
attribute :width, :number, nullable: true
attribute :depth, :number, nullable: true
- attribute :weight_unit, :string, choices: Spree::Variant::WEIGHT_UNITS
- attribute :dimensions_unit, :string, choices: Spree::Variant::DIMENSION_UNITS
+ attribute :weight_unit, :weight_unit, nullable: true, description: "Null falls back to the store's weight unit."
+ attribute :dimensions_unit, :dimension_unit, nullable: true, description: "Null falls back to the store's unit system."
attribute :hs_code, :string
attribute :customs_description, :string
attribute :country_of_origin, :country
attribute :minimum_order_quantity, :integer, nullable: true
attribute :order_multiple, :integer, nullable: true
- attribute :purchase_unit, :string
+ attribute :purchase_unit, :string, nullable: true, choices: Spree::Variant::PURCHASE_UNITS
attribute :units_per_carton, :integer, nullable: true, description: 'How many units fill one carton.'
attribute :carton_package_type_id, :id,
nullable: true,
@@ -29,8 +29,6 @@ module Spree
nullable: true,
description: "What one packed carton weighs, in the variant's weight unit."
attribute :cartons_per_pallet, :integer, nullable: true, description: 'How many cartons stack on one pallet.'
- attribute :seller_id, :id
- attribute :delivery_profile_id, :id, nullable: true
attribute :track_inventory, :boolean
attribute :preorderable, :boolean,
description: "Sell this variant before it's in stock. Adds the pre-order label and ships-by promise; the cap comes from `backorder_limit`, an incoming stock count, or backorder."
@@ -40,12 +38,9 @@ module Spree
attribute :backorder_limit, :integer,
nullable: true,
description: 'Maximum units sellable beyond available stock, capping backorders and pre-orders. Null is unlimited.'
- attribute :tax_category_id, :id
attribute :position, :integer
- attribute :prices, :array, of: Spree::Api::V3::PriceRequestSchema,
- description: 'Per-currency prices. Upserted by currency.'
- attribute :stock_levels, :array, of: Spree::Api::V3::StockLevelRequestSchema,
- description: 'Stock per location. Upserted by location; omitted locations are removed.'
+ attribute :options, :array, of: Spree::Api::V3::VariantOptionRequestSchema,
+ description: 'One pair per option type the variant takes part in (size, color). Option types and values are created when missing.'
end
end
end
diff --git a/spree/api/app/serializers/spree/api/v3/admin/package_type_serializer.rb b/spree/api/app/serializers/spree/api/v3/admin/package_type_serializer.rb
index ec69c46f66..be92cf43de 100644
--- a/spree/api/app/serializers/spree/api/v3/admin/package_type_serializer.rb
+++ b/spree/api/app/serializers/spree/api/v3/admin/package_type_serializer.rb
@@ -11,10 +11,10 @@ module Spree
length: [:string, nullable: true],
width: [:string, nullable: true],
height: [:string, nullable: true],
- dimensions_unit: [:string, enum: Spree::Variant::DIMENSION_UNITS],
+ dimensions_unit: [:string, enum: Spree::Variant::DIMENSION_UNITS, enum_type_name: 'DimensionUnit'],
weight: [:string, nullable: true],
max_weight: [:string, nullable: true],
- weight_unit: [:string, enum: Spree::Variant::WEIGHT_UNITS],
+ weight_unit: [:string, enum: Spree::Variant::WEIGHT_UNITS, enum_type_name: 'WeightUnit'],
volume: [:string, nullable: true],
default: :boolean,
seller_id: [:string, nullable: true],
diff --git a/spree/api/app/serializers/spree/api/v3/admin/store_serializer.rb b/spree/api/app/serializers/spree/api/v3/admin/store_serializer.rb
index d38adf0ec1..ab8e7c867d 100644
--- a/spree/api/app/serializers/spree/api/v3/admin/store_serializer.rb
+++ b/spree/api/app/serializers/spree/api/v3/admin/store_serializer.rb
@@ -36,6 +36,7 @@ module Spree
# and rate settings are formatted below.
preference_attributes Spree::Store, except: %i[order_routing_strategy payout_provider
default_minimum_payout_amount default_commission_tax_rate]
+ typelize weight_unit: [:string, enum: Spree::Variant::WEIGHT_UNITS, enum_type_name: 'WeightUnit']
# Once the counter has issued a number the starting value no longer
# applies, so the settings page can say that instead of accepting a
diff --git a/spree/api/app/serializers/spree/api/v3/seller/package_type_serializer.rb b/spree/api/app/serializers/spree/api/v3/seller/package_type_serializer.rb
index bc2e4e8dbd..38160b7363 100644
--- a/spree/api/app/serializers/spree/api/v3/seller/package_type_serializer.rb
+++ b/spree/api/app/serializers/spree/api/v3/seller/package_type_serializer.rb
@@ -19,10 +19,10 @@ module Spree
length: [:string, nullable: true],
width: [:string, nullable: true],
height: [:string, nullable: true],
- dimensions_unit: [:string, enum: Spree::Variant::DIMENSION_UNITS],
+ dimensions_unit: [:string, enum: Spree::Variant::DIMENSION_UNITS, enum_type_name: 'DimensionUnit'],
weight: [:string, nullable: true],
max_weight: [:string, nullable: true],
- weight_unit: [:string, enum: Spree::Variant::WEIGHT_UNITS],
+ weight_unit: [:string, enum: Spree::Variant::WEIGHT_UNITS, enum_type_name: 'WeightUnit'],
volume: [:string, nullable: true],
default: :boolean,
editable: :boolean,
diff --git a/spree/api/app/serializers/spree/api/v3/variant_serializer.rb b/spree/api/app/serializers/spree/api/v3/variant_serializer.rb
index 906ca54c54..2aba789fc6 100644
--- a/spree/api/app/serializers/spree/api/v3/variant_serializer.rb
+++ b/spree/api/app/serializers/spree/api/v3/variant_serializer.rb
@@ -10,7 +10,7 @@ module Spree
purchasable: :boolean, in_stock: :boolean, backorderable: :boolean, preorder: :boolean,
preorder_ships_at: [:string, nullable: true],
weight: [:number, nullable: true], height: [:number, nullable: true], width: [:number, nullable: true], depth: [:number, nullable: true],
- weight_unit: [:string, enum: Spree::Variant::WEIGHT_UNITS], dimensions_unit: [:string, enum: Spree::Variant::DIMENSION_UNITS],
+ weight_unit: [:string, enum: Spree::Variant::WEIGHT_UNITS, enum_type_name: 'WeightUnit'], dimensions_unit: [:string, enum: Spree::Variant::DIMENSION_UNITS, enum_type_name: 'DimensionUnit'],
price: 'Price',
original_price: ['Price', nullable: true],
minimum_order_quantity: :number, order_multiple: :number,
diff --git a/spree/api/app/services/spree/api/v3/request_schema.rb b/spree/api/app/services/spree/api/v3/request_schema.rb
index 86b7b00b81..296e7022f3 100644
--- a/spree/api/app/services/spree/api/v3/request_schema.rb
+++ b/spree/api/app/services/spree/api/v3/request_schema.rb
@@ -40,20 +40,24 @@ module Spree
datetime: { type: :string, format: :'date-time' },
id: { type: :string },
any: {},
- # ISO codes, from the closed lists below.
+ # Codes from the closed lists below.
country: { type: :string },
currency: { type: :string },
- locale: { type: :string }
+ locale: { type: :string },
+ weight_unit: { type: :string },
+ dimension_unit: { type: :string }
}.freeze
- # The ISO lists a `country` or `currency` field takes, published once
- # per API as a named component — the same `CountryCode` and
- # `CurrencyCode` types the serializers declare, so a value read from
- # a response is the type a request takes.
+ # The closed lists a code field takes, published once per API as a
+ # named component — the same `CountryCode`, `CurrencyCode` and
+ # `WeightUnit` types the serializers declare, so a value read from a
+ # response is the type a request takes.
CODE_LISTS = {
country: ['CountryCode', -> { Spree::IsoData.country_codes }],
currency: ['CurrencyCode', -> { Spree::Money::Rounding::CURRENCY_CODES }],
- locale: ['LocaleCode', -> { Spree::Locales::ALL }]
+ locale: ['LocaleCode', -> { Spree::Locales::ALL }],
+ weight_unit: ['WeightUnit', -> { Spree::Variant::WEIGHT_UNITS }],
+ dimension_unit: ['DimensionUnit', -> { Spree::Variant::DIMENSION_UNITS }]
}.freeze
ACTIONS = %i[create update].freeze
@@ -119,7 +123,7 @@ module Spree
end
end
- attr_reader :name, :fields
+ attr_reader :name, :fields, :base
# The types an attribute takes: the scalars above, plus `:hash` (any
# keys), `:object` (a block or a `shape:`) and `:array` (`of:` a type
@@ -172,7 +176,7 @@ module Spree
value.is_a?(Class) ? value.definition : value
end
- %i[attribute include_attributes require_attributes external_references].each do |method|
+ %i[attribute extends include_attributes require_attributes external_references].each do |method|
define_method(method) { |*args, **options, &block| definition.public_send(method, *args, **options, &block) }
end
end
@@ -229,6 +233,19 @@ module Spree
TEXT
end
+ # Builds on a published shape: the body accepts all of its attributes,
+ # and the published type is that shape's type plus what this schema
+ # adds, so clients write one type wherever the shape is accepted.
+ #
+ # @param other [RequestSchema, Class] a shape with a published name
+ def extends(other)
+ parent = RequestSchema.resolve(other)
+ raise ArgumentError, "#{parent.class.name} has no published name to extend" unless shape?(parent)
+
+ include_attributes(parent)
+ @base = parent
+ end
+
# Adds the attributes of another schema, for endpoints that extend a
# shared set.
#
@@ -253,6 +270,19 @@ module Spree
@permit_lists = nil
end
+ # Replaces the description of an attribute this schema took from
+ # another, for an endpoint where it behaves differently.
+ #
+ # @param name [Symbol]
+ # @param description [String]
+ # @return [void]
+ def describe_attribute(name, description)
+ field = fields.fetch(name) { raise ArgumentError, "#{name} is not an attribute of this schema" }
+ copy = field.dup
+ copy.instance_variable_set(:@description, description)
+ fields[name] = copy
+ end
+
# The `params.permit` list for an action.
#
# @param action [Symbol, String, nil] `create` or `update`; nil
@@ -269,12 +299,21 @@ module Spree
# @return [Hash]
def json_schema(action = nil)
action = action&.to_sym
- fields = fields_for(action)
- required = fields.select { |field| field.required_on?(action) }.map { |field| field.name.to_s }
+ # A base field this action does not take would still reach clients
+ # through the base's type, so such a body is published in full.
+ unless base && base.fields.each_value.all? { |field| field.accepted_on?(action) }
+ return object_schema(fields_for(action), action)
+ end
- schema = { type: :object, properties: fields.to_h { |field| [field.name, property_schema(field)] } }
- schema[:required] = required if required.any?
- schema
+ # Attributes the base describes the same way for this action are
+ # left to its type.
+ own = fields_for(action).reject do |field|
+ inherited = base.fields[field.name]
+ inherited && inherited.required_on?(action) == field.required_on?(action) &&
+ property_schema(inherited) == property_schema(field)
+ end
+ reference = { '$ref': "#/components/schemas/#{base.name}" }
+ own.any? ? { allOf: [reference, object_schema(own, action)] } : reference
end
# The component name published for an action.
@@ -291,15 +330,15 @@ module Spree
#
# @return [Array<RequestSchema>]
def shapes
- fields.each_value.flat_map do |field|
+ (base ? [base, *base.shapes] : []).concat(fields.each_value.flat_map do |field|
next [] unless field.schema
nested = field.schema.shapes
shape?(field.schema) ? [field.schema, *nested] : nested
- end.uniq
+ end).uniq
end
- # The ISO code lists this schema's fields reach, nested ones included,
+ # The code lists this schema's fields reach, nested ones included,
# as the components they publish.
#
# @return [Hash{String => Hash}]
@@ -374,6 +413,14 @@ module Spree
end
+ def object_schema(fields, action)
+ required = fields.select { |field| field.required_on?(action) }.map { |field| field.name.to_s }
+
+ schema = { type: :object, properties: fields.to_h { |field| [field.name, property_schema(field)] } }
+ schema[:required] = required if required.any?
+ schema
+ end
+
def fields_for(action)
fields.values.select { |field| field.accepted_on?(action) }
end
diff --git a/spree/api/lib/spree/api/agent_write_schemas.rb b/spree/api/lib/spree/api/agent_write_schemas.rb
index f7eaefc276..107cd4ce90 100644
--- a/spree/api/lib/spree/api/agent_write_schemas.rb
+++ b/spree/api/lib/spree/api/agent_write_schemas.rb
@@ -100,19 +100,31 @@ module Spree
# A request body is declared once per endpoint and published as a
# component, so the operation carries a `$ref` to it rather than the
- # properties themselves. Followed a few hops, which is as deep as the
- # generated document nests them.
+ # properties themselves. A body that builds on a shared shape is an
+ # `allOf` of that shape and its own fields, read as one object.
+ # Followed a few hops, which is as deep as the generated document
+ # nests them.
#
# @param schema [Hash, nil] a schema that may be a reference
# @return [Hash, nil] the schema it names
def resolve_schema(schema, depth = 0)
return unless schema.is_a?(Hash)
- return schema unless schema.key?('$ref')
return if depth > 3
+ return merge_all_of(schema['allOf'], depth) if schema.key?('allOf')
+ return schema unless schema.key?('$ref')
name = schema['$ref'].to_s.split('/').last
resolve_schema(document.dig('components', 'schemas', name), depth + 1)
end
+
+ private
+
+ def merge_all_of(parts, depth)
+ parts.filter_map { |part| resolve_schema(part, depth + 1) }.each_with_object({}) do |part, merged|
+ merged['properties'] = (merged['properties'] || {}).merge(part['properties'] || {})
+ merged['required'] = (merged['required'] || []) | Array(part['required'])
+ end
+ end
end
end
end
diff --git a/spree/api/lib/typelizer/open_enums.rb b/spree/api/lib/typelizer/open_enums.rb
index fc8320dcba..42a8114762 100644
--- a/spree/api/lib/typelizer/open_enums.rb
+++ b/spree/api/lib/typelizer/open_enums.rb
@@ -8,15 +8,15 @@ module Typelizer
# from either still accepts an added value while every built-in value stays
# documented and autocompletable.
#
- # ISO lists are the exception: a named type several serializers and the
- # request types share, but closed, since nothing outside the standard can
- # add a country or a currency, and markets only accept the locales
- # `Spree::Locales::ALL` lists. The SDKs define them once, as values and
- # types, in `@spree/sdk-core` (generated from the API reference by
- # `pnpm generate:iso-codes`), so each SDK's `Enums.ts` re-exports that
+ # Shared code lists are the exception: a named type several serializers and
+ # the request types share, but closed, since nothing outside the standard
+ # can add a country, a currency or a unit, and markets only accept the
+ # locales `Spree::Locales::ALL` lists. The SDKs define them once, as values
+ # and types, in `@spree/sdk-core` (generated from the API reference by
+ # `pnpm generate:code-lists`), so each SDK's `Enums.ts` re-exports that
# definition instead of carrying a copy of the list.
module OpenEnums
- CLOSED_TYPE_NAMES = %w[CountryCode CurrencyCode LocaleCode].freeze
+ CLOSED_TYPE_NAMES = %w[CountryCode CurrencyCode LocaleCode WeightUnit DimensionUnit].freeze
module Property
def enum_definition(...)
diff --git a/spree/api/spec/services/spree/api/v3/request_schema_spec.rb b/spree/api/spec/services/spree/api/v3/request_schema_spec.rb
index 91597c2376..84932ee0ab 100644
--- a/spree/api/spec/services/spree/api/v3/request_schema_spec.rb
+++ b/spree/api/spec/services/spree/api/v3/request_schema_spec.rb
@@ -183,6 +183,79 @@ RSpec.describe Spree::Api::V3::RequestSchema do
it 'refuses publishes after the fields' do
expect { Class.new(described_class) { attribute :city, :string; publishes 'LateParams' } }.to raise_error(ArgumentError, /before the attributes/)
end
+
+ describe 'extended by another schema' do
+ it "accepts the base's fields and publishes only what it adds or changes" do
+ parent = base
+ schema = described_class.new(:widget) do |schema|
+ schema.extends parent
+ schema.attribute :id, :id
+ schema.attribute :note, :string, required: true, on: :create
+ end
+
+ expect(schema.permit_list(:create)).to eq(%i[city id note])
+ expect(schema.shapes.map(&:name)).to eq(['TestAddressParams'])
+ expect(schema.json_schema(:create)).to eq(
+ allOf: [
+ { '$ref': '#/components/schemas/TestAddressParams' },
+ { type: :object, properties: { id: { type: :string }, note: { type: :string } }, required: ['note'] }
+ ]
+ )
+ end
+
+ it 'publishes every shape its base builds on' do
+ parent = base
+ middle = Class.new(described_class) do
+ publishes 'TestShippingAddressParams'
+ extends parent
+ end
+ schema = described_class.new(:widget) { |schema| schema.extends middle }
+
+ expect(schema.shapes.map(&:name)).to eq(%w[TestShippingAddressParams TestAddressParams])
+ end
+
+ it 'restates a base field it requires' do
+ parent = Class.new(described_class) do
+ publishes 'TestOptionalCityParams'
+ attribute :city, :string
+ end
+ schema = described_class.new(:widget) do |schema|
+ schema.extends parent
+ schema.require_attributes :city, on: :create
+ end
+
+ expect(schema.json_schema(:create)[:allOf].last).to eq(type: :object, properties: { city: { type: :string } }, required: ['city'])
+ expect(schema.json_schema(:update)).to eq('$ref': '#/components/schemas/TestOptionalCityParams')
+ end
+
+ it "publishes the body in full when the base has a field this action doesn't take" do
+ parent = Class.new(described_class) do
+ publishes 'TestOneShotParams'
+ attribute :city, :string
+ attribute :code, :string, only: :create
+ end
+ schema = described_class.new(:widget) { |schema| schema.extends parent }
+
+ expect(schema.json_schema(:create)).to eq('$ref': '#/components/schemas/TestOneShotParams')
+ expect(schema.json_schema(:update)).to eq(type: :object, properties: { city: { type: :string } })
+ end
+
+ it 'restates a base field it describes differently' do
+ parent = base
+ schema = described_class.new(:widget) do |schema|
+ schema.extends parent
+ schema.describe_attribute :city, 'Where the widget ships from.'
+ end
+
+ expect(schema.json_schema(:update)[:allOf].last).to eq(
+ type: :object, properties: { city: { type: :string, description: 'Where the widget ships from.' } }, required: ['city']
+ )
+ end
+
+ it 'refuses a base without a published name' do
+ expect { described_class.new { |schema| schema.extends described_class.new } }.to raise_error(ArgumentError, /no published name/)
+ end
+ end
end
it 'refuses a deprecation that names no replacement' do