@endora-commerce/mod-catalog 0.106.0 → 0.108.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (140) hide show
  1. package/dist/admin/components/PackagingUnitsEditor.d.ts +3 -0
  2. package/dist/admin/components/PackagingUnitsEditor.d.ts.map +1 -1
  3. package/dist/admin/components/PackagingUnitsEditor.js +51 -5
  4. package/dist/admin/components/PackagingUnitsEditor.js.map +1 -1
  5. package/dist/admin/components/ProductOrderRulesCard.d.ts +19 -0
  6. package/dist/admin/components/ProductOrderRulesCard.d.ts.map +1 -0
  7. package/dist/admin/components/ProductOrderRulesCard.js +147 -0
  8. package/dist/admin/components/ProductOrderRulesCard.js.map +1 -0
  9. package/dist/admin/components/ProductsBulkEditDialog.d.ts.map +1 -1
  10. package/dist/admin/components/ProductsBulkEditDialog.js +31 -3
  11. package/dist/admin/components/ProductsBulkEditDialog.js.map +1 -1
  12. package/dist/admin/pages/CategoriesTree.d.ts.map +1 -1
  13. package/dist/admin/pages/CategoriesTree.js +21 -4
  14. package/dist/admin/pages/CategoriesTree.js.map +1 -1
  15. package/dist/admin/pages/ProductEditor.d.ts.map +1 -1
  16. package/dist/admin/pages/ProductEditor.js +12 -33
  17. package/dist/admin/pages/ProductEditor.js.map +1 -1
  18. package/dist/admin/pages/ProductsList.d.ts.map +1 -1
  19. package/dist/admin/pages/ProductsList.js +36 -3
  20. package/dist/admin/pages/ProductsList.js.map +1 -1
  21. package/dist/backend/admin-search-provider.d.ts +56 -0
  22. package/dist/backend/admin-search-provider.d.ts.map +1 -0
  23. package/dist/backend/admin-search-provider.js +109 -0
  24. package/dist/backend/admin-search-provider.js.map +1 -0
  25. package/dist/backend/demo/reset.d.ts +1 -1
  26. package/dist/backend/demo/rows.d.ts +7 -3
  27. package/dist/backend/demo/rows.d.ts.map +1 -1
  28. package/dist/backend/demo/rows.js +7 -5
  29. package/dist/backend/demo/rows.js.map +1 -1
  30. package/dist/backend/demo/seed.d.ts.map +1 -1
  31. package/dist/backend/demo/seed.js +1 -4
  32. package/dist/backend/demo/seed.js.map +1 -1
  33. package/dist/backend/entities/product-list-saved-view.entity.d.ts +31 -0
  34. package/dist/backend/entities/product-list-saved-view.entity.d.ts.map +1 -0
  35. package/dist/backend/entities/product-list-saved-view.entity.js +75 -0
  36. package/dist/backend/entities/product-list-saved-view.entity.js.map +1 -0
  37. package/dist/backend/entities/product-packaging-unit.entity.d.ts +7 -1
  38. package/dist/backend/entities/product-packaging-unit.entity.d.ts.map +1 -1
  39. package/dist/backend/entities/product-packaging-unit.entity.js +10 -0
  40. package/dist/backend/entities/product-packaging-unit.entity.js.map +1 -1
  41. package/dist/backend/entities/product-variant.entity.d.ts +1 -2
  42. package/dist/backend/entities/product-variant.entity.d.ts.map +1 -1
  43. package/dist/backend/entities/product-variant.entity.js +0 -5
  44. package/dist/backend/entities/product-variant.entity.js.map +1 -1
  45. package/dist/backend/entities/product.entity.d.ts +25 -1
  46. package/dist/backend/entities/product.entity.d.ts.map +1 -1
  47. package/dist/backend/entities/product.entity.js +60 -0
  48. package/dist/backend/entities/product.entity.js.map +1 -1
  49. package/dist/backend/index.d.ts +5 -5
  50. package/dist/backend/index.d.ts.map +1 -1
  51. package/dist/backend/index.js +24 -4
  52. package/dist/backend/index.js.map +1 -1
  53. package/dist/backend/plugin.d.ts +7 -2
  54. package/dist/backend/plugin.d.ts.map +1 -1
  55. package/dist/backend/plugin.js +4 -0
  56. package/dist/backend/plugin.js.map +1 -1
  57. package/dist/backend/routes.admin.d.ts +6 -0
  58. package/dist/backend/routes.admin.d.ts.map +1 -1
  59. package/dist/backend/routes.admin.js +68 -2
  60. package/dist/backend/routes.admin.js.map +1 -1
  61. package/dist/backend/routes.public.d.ts.map +1 -1
  62. package/dist/backend/routes.public.js +13 -8
  63. package/dist/backend/routes.public.js.map +1 -1
  64. package/dist/backend/saved-view-actor.d.ts +16 -0
  65. package/dist/backend/saved-view-actor.d.ts.map +1 -0
  66. package/dist/backend/saved-view-actor.js +24 -0
  67. package/dist/backend/saved-view-actor.js.map +1 -0
  68. package/dist/backend/services/catalog-admin-search.service.d.ts +32 -0
  69. package/dist/backend/services/catalog-admin-search.service.d.ts.map +1 -0
  70. package/dist/backend/services/catalog-admin-search.service.js +141 -0
  71. package/dist/backend/services/catalog-admin-search.service.js.map +1 -0
  72. package/dist/backend/services/catalog-admin.service.d.ts +14 -0
  73. package/dist/backend/services/catalog-admin.service.d.ts.map +1 -1
  74. package/dist/backend/services/catalog-admin.service.js +69 -22
  75. package/dist/backend/services/catalog-admin.service.js.map +1 -1
  76. package/dist/backend/services/catalog-bulk-update.service.d.ts.map +1 -1
  77. package/dist/backend/services/catalog-bulk-update.service.js +8 -1
  78. package/dist/backend/services/catalog-bulk-update.service.js.map +1 -1
  79. package/dist/backend/services/catalog-org-price-decorator.d.ts +7 -3
  80. package/dist/backend/services/catalog-org-price-decorator.d.ts.map +1 -1
  81. package/dist/backend/services/catalog-org-price-decorator.js +32 -23
  82. package/dist/backend/services/catalog-org-price-decorator.js.map +1 -1
  83. package/dist/backend/services/catalog-product-read.service.d.ts +52 -3
  84. package/dist/backend/services/catalog-product-read.service.d.ts.map +1 -1
  85. package/dist/backend/services/catalog-product-read.service.js +153 -3
  86. package/dist/backend/services/catalog-product-read.service.js.map +1 -1
  87. package/dist/backend/services/catalog-query.service.d.ts +19 -3
  88. package/dist/backend/services/catalog-query.service.d.ts.map +1 -1
  89. package/dist/backend/services/catalog-query.service.js +416 -89
  90. package/dist/backend/services/catalog-query.service.js.map +1 -1
  91. package/dist/backend/services/packaging-unit.service.d.ts.map +1 -1
  92. package/dist/backend/services/packaging-unit.service.js +39 -4
  93. package/dist/backend/services/packaging-unit.service.js.map +1 -1
  94. package/dist/backend/services/product-link.service.d.ts +5 -0
  95. package/dist/backend/services/product-link.service.d.ts.map +1 -1
  96. package/dist/backend/services/product-link.service.js +18 -6
  97. package/dist/backend/services/product-link.service.js.map +1 -1
  98. package/dist/backend/services/product-list-view-service.d.ts +53 -0
  99. package/dist/backend/services/product-list-view-service.d.ts.map +1 -0
  100. package/dist/backend/services/product-list-view-service.js +191 -0
  101. package/dist/backend/services/product-list-view-service.js.map +1 -0
  102. package/dist/backend/services/product-value-resolver.service.d.ts +11 -1
  103. package/dist/backend/services/product-value-resolver.service.d.ts.map +1 -1
  104. package/dist/backend/services/product-value-resolver.service.js +29 -9
  105. package/dist/backend/services/product-value-resolver.service.js.map +1 -1
  106. package/dist/backend/services/storefront-value-overrides.d.ts +31 -0
  107. package/dist/backend/services/storefront-value-overrides.d.ts.map +1 -0
  108. package/dist/backend/services/storefront-value-overrides.js +48 -0
  109. package/dist/backend/services/storefront-value-overrides.js.map +1 -0
  110. package/dist/manifest.d.ts +6 -2
  111. package/dist/manifest.d.ts.map +1 -1
  112. package/dist/manifest.js +39 -3
  113. package/dist/manifest.js.map +1 -1
  114. package/dist/migrations/20261014T170531_catalog_product_list_saved_views.d.ts +22 -0
  115. package/dist/migrations/20261014T170531_catalog_product_list_saved_views.d.ts.map +1 -0
  116. package/dist/migrations/20261014T170531_catalog_product_list_saved_views.js +38 -0
  117. package/dist/migrations/20261014T170531_catalog_product_list_saved_views.js.map +1 -0
  118. package/dist/migrations/20261016T082008_catalog_order_rules.d.ts +22 -0
  119. package/dist/migrations/20261016T082008_catalog_order_rules.d.ts.map +1 -0
  120. package/dist/migrations/20261016T082008_catalog_order_rules.js +48 -0
  121. package/dist/migrations/20261016T082008_catalog_order_rules.js.map +1 -0
  122. package/dist/migrations/20261022T111811_catalog_price_fields_removed.d.ts +26 -0
  123. package/dist/migrations/20261022T111811_catalog_price_fields_removed.d.ts.map +1 -0
  124. package/dist/migrations/20261022T111811_catalog_price_fields_removed.js +32 -0
  125. package/dist/migrations/20261022T111811_catalog_price_fields_removed.js.map +1 -0
  126. package/dist/migrations/20261022T182523_catalog_admin_name_keys.d.ts +38 -0
  127. package/dist/migrations/20261022T182523_catalog_admin_name_keys.d.ts.map +1 -0
  128. package/dist/migrations/20261022T182523_catalog_admin_name_keys.js +89 -0
  129. package/dist/migrations/20261022T182523_catalog_admin_name_keys.js.map +1 -0
  130. package/dist/migrations/index.d.ts +5 -1
  131. package/dist/migrations/index.d.ts.map +1 -1
  132. package/dist/migrations/index.js +9 -1
  133. package/dist/migrations/index.js.map +1 -1
  134. package/docs/catalog/attributes.md +11 -6
  135. package/docs/catalog/packaging-units.md +44 -7
  136. package/docs/catalog/per-channel-per-language-overrides.md +36 -9
  137. package/docs/catalog.md +276 -4
  138. package/i18n/en.json +41 -5
  139. package/i18n/pl.json +41 -5
  140. package/package.json +9 -9
@@ -159,7 +159,7 @@ additive.
159
159
 
160
160
  ## Read paths
161
161
 
162
- Three consumers go through the resolver:
162
+ These consumers go through the resolver:
163
163
 
164
164
  - **Admin endpoint** — `GET /api/v1/admin/catalog/products/:id?channelId=&languageCode=&includeOverridesMap=true`
165
165
  returns the baseline product PLUS, when context params are passed, a
@@ -168,13 +168,40 @@ Three consumers go through the resolver:
168
168
  is attached for client-side switcher previews.
169
169
  - **Storefront public read** — pulls the channel from the
170
170
  `x-sales-channel` header (the existing convention) and
171
- the language from `Accept-Language`. The override layer is invisible
172
- to the public client.
171
+ the language from `Accept-Language`, else the channel's default
172
+ language. The override layer is invisible to the public client: it
173
+ receives the effective value. The product page (name, description,
174
+ SEO fields, attribute values, the product-page attribute list, grouped
175
+ children and bundle options) and every listing card walk the storefront's own baseline language pick — requested
176
+ language, then the channel's default language, then `en-US`, `en` and
177
+ the first stored language — and at each language take the
178
+ `(channel + language)` slot if it is filled, else stop there if the
179
+ baseline has text for that language. An override therefore answers
180
+ only for the language whose baseline text the page would show, or an
181
+ earlier one in that order: a request in `en-US` on a channel whose
182
+ default is `pl-PL` shows the `en-US` baseline, not the `pl-PL`
183
+ override, while a `de-DE` request for a product with no `de-DE` text
184
+ falls through to `pl-PL` and shows its override. The `(channel-only)`
185
+ slot is asked last and wins over the baseline wherever the walk
186
+ stopped. Product-link tiles keep their own language pick, which has
187
+ no channel-default leg, and walk the override slots over it, so a
188
+ tile can show the `en-US` baseline where the listing card shows the
189
+ channel default's override. A product without overrides shows exactly what
190
+ it showed before. Listing filters, attribute filters and name sorting
191
+ still read the baseline.
173
192
  - **Search indexer (Meilisearch)** — builds one document per
174
193
  `(product, channel)` pair. Each document's `name` and `description`
175
194
  fields are run through the resolver with `channel.defaultLanguage`
176
195
  as the active language, so per-channel overrides flow into
177
- storefront search ranking.
196
+ storefront search ranking and name sorting.
197
+ - **Search result cards** — the search module re-reads every hit from
198
+ Postgres before it answers, and the card name it shows is resolved
199
+ there, not taken from the index: the request's sales channel override
200
+ rows are read once per results page and the card walks the same
201
+ languages and slots, in the same order, as a listing card above. The indexed name is
202
+ resolved for the channel's default language only, so it would be
203
+ wrong for a request in any other language. A product without an
204
+ override for the channel shows exactly what it showed before.
178
205
 
179
206
  ## Admin UI
180
207
 
@@ -223,11 +250,11 @@ exact inverse — drop the two tables and the two columns.
223
250
  surfaces only the system Name + Description today. User attribute
224
251
  overrides are accepted by the PATCH endpoint and resolved on read,
225
252
  but the admin SPA does not yet expose a write affordance for them.
226
- - **Storefront public read shape change** — `products.name` and
227
- `products.description` still ship as `Record<lang, string>` JSONB
228
- on the public catalog endpoint. Switching to a resolved scalar is
229
- a breaking change for storefront consumers and is scoped as a
230
- follow-up.
253
+ - **Override-aware listing filters and sorting** — the public catalog
254
+ endpoint returns `name` and `description` as the resolved string for
255
+ the request's sales channel and language (see *Read paths* above), but
256
+ listing filters, attribute filters and name sorting still read the
257
+ baseline values. Making them follow the overrides is a follow-up.
231
258
  - **Channel-aware reindex enqueue** — the PATCH endpoint does not
232
259
  yet enqueue a Meilisearch reindex job per touched channel; the
233
260
  next per-product upsert (driven by any catalog mutation) picks it
package/docs/catalog.md CHANGED
@@ -15,6 +15,12 @@ depends on and the admin-side authoring surface.
15
15
  Admin routes are gated by `catalog:read` (list / get) /
16
16
  `catalog:write` (mutations).
17
17
 
18
+ The storefront reads that carry a price — the product list, the product detail and
19
+ `/products/:idOrSlug/links` — accept `?currency=` (an ISO 4217 code). The response is priced in
20
+ that currency when the Sales Channel offers it, and in the channel's default currency
21
+ otherwise; every price names its currency either way. A malformed code is refused with
22
+ `400 VALIDATION_FAILED`.
23
+
18
24
  | Verb + Path | Audience | Purpose |
19
25
  | --- | --- | --- |
20
26
  | `GET /api/v1/catalog/products` | storefront / API key | List/search/filter products in the active Sales Channel |
@@ -28,6 +34,7 @@ Admin routes are gated by `catalog:read` (list / get) /
28
34
  | `POST /api/v1/admin/catalog/products` | admin | Create product (`type` immutable post-create; `sku` is editable) |
29
35
  | `PATCH /api/v1/admin/catalog/products/:id` | admin | Update (incl. `sku`); writes an audit row with stateBefore / stateAfter; refuses with `409 sku_in_use` if the new SKU already belongs to another product |
30
36
  | `DELETE /api/v1/admin/catalog/products/:id` | admin | Archive (soft) |
37
+ | `GET`, `POST /api/v1/admin/catalog/products/list-views`; `PATCH`, `DELETE …/list-views/:id` | admin | Saved views on the product list — see *Saved views* below |
31
38
  | `GET /api/v1/admin/catalog/attributes` | admin | List attributes |
32
39
  | `GET /api/v1/admin/catalog/attributes/by-flag?flag=isPromoRule\|isComparable\|...` | admin | Picker payload — every attribute carrying the requested flag |
33
40
  | `GET /api/v1/admin/catalog/attributes/:idOrKey` | admin | Single attribute read |
@@ -47,11 +54,169 @@ Admin routes are gated by `catalog:read` (list / get) /
47
54
  | `PUT /api/v1/admin/catalog/categories/:id/content` | admin | Replace the category's page content; `null` clears it |
48
55
  | `PUT /api/v1/catalog/products/by-sku/:sku` | API key | Idempotent upsert (PIM sync) |
49
56
 
57
+ ## Prices
58
+
59
+ **A product carries no price of its own.** Every price is a row of a price book of the
60
+ `price_lists` module: the product's base price per currency, its variants' prices, and any
61
+ catalogue, buyer or sale price. Set a product's base price on the product editor's **Pricing** tab
62
+ — the *Base prices* panel there, and the list of the price books that price the product, are
63
+ contributed by `price_lists` — or in the base book's grid. Variant prices are set in the same
64
+ places, never on the variant itself. The `price_lists` module's page explains how the price a
65
+ buyer pays is chosen.
66
+
67
+ - **Listing cards, the product page and related products** show the viewer's own price — their
68
+ organization's and customer group's prices on the request's sales channel and currency. A product
69
+ whose variants cost different amounts shows its lowest price as a *from* price
70
+ (`ProductSummary.price` carries `variesByVariant` and `maxAmount`); a charged sale carries the
71
+ buyer's regular price as the compare-at price; with `pricing.show_list_price` on, a lower buyer
72
+ price carries the catalogue price as `listPrice`. A product nothing prices has no price and
73
+ follows the quote-request path.
74
+ - **Sorting and filtering by price** — `?sort=price`, `?sort=-price`, `minPrice`, `maxPrice` on
75
+ `GET /api/v1/catalog/products` — order and select by the same quantity-1 price the cards show to
76
+ that viewer, the *from* price for a variant product. Priced products always come before unpriced
77
+ ones. A price ordering is always answered from PostgreSQL, never from the search index. Paging
78
+ through a price ordering with the cursor meets every product once, provided its price does not
79
+ change meanwhile; a product repriced during the walk may be met twice or not at all, as with any
80
+ cursor over a live price. A page may be short, or even empty, and still have more after it
81
+ (`hasMore: true`) when most of the rows it read are hidden from the viewer; follow its cursor.
82
+ - **The product detail on a non-public sales channel** omits the price.
83
+
84
+ For developers: the listing paths price a whole page in one batched call —
85
+ `resolveListingPrices`, or `resolveListingPriceDetails` where the page renders the split
86
+ (`ProductSummary.resolvedPrice`: `basePrice`, `salePrice`, `listPrice`, `displayMode`) — through the
87
+ `pricingService` port slices of `@endora-commerce/contracts`, passing the viewer's organization and
88
+ customer account rather than a resolved group. A price ordering reads `ListingPriceOrderPort`
89
+ (`orderByUnitPrice`, `pricedProductIds`) over `price_lists`' precomputed price surface and composes
90
+ the unpriced tail itself (`catalog-query.service.ts`). The external catalogue API prices through
91
+ `resolveLinePrices` and builds a bound organization's tier ladder from `listTierStarts`. Product,
92
+ category and attribute writes publish the events `price_lists` subscribes to, which clear the
93
+ pricing caches and mark on the price surface the products each event concerns, for the surface
94
+ worker to refresh.
95
+
96
+ ### Removed price fields (migration note)
97
+
98
+ The release that introduced price books removed the product's *Default unit price* (the
99
+ `defaultPrice` and `price` keys of `attributeValues`, and the editor field) and the variant price
100
+ override (`product_variants.price_override`, and the variant editor's price field), without
101
+ converting either. Product and variant create and update, and the products import, refuse those
102
+ fields with `400 PRICE_SET_IN_PRICE_BOOKS` (`PRICE_FIELDS_REFUSED_ON_PRODUCTS`,
103
+ `PRICE_FIELDS_REFUSED_ON_VARIANTS` in `@endora-commerce/contracts`), saying that prices are set in
104
+ price books. The catalogue's migration `20261022T111811_catalog_price_fields_removed.ts` dropped the
105
+ column and stripped the keys.
106
+
50
107
  ## Entities
51
108
 
52
109
  `Product`, `ProductVariant`, `Category`, `ProductAttribute`,
53
110
  `SalesChannel`, plus the M:N bridges
54
- `product_categories`, `sales_channel_products`, `product_assets`.
111
+ `product_categories`, `sales_channel_products`, `product_assets`, and
112
+ `ProductListSavedView` (`product_list_saved_views`, the product list's saved
113
+ views).
114
+
115
+ ## Saved views
116
+
117
+ A saved view is a named set of product-list filters that an admin can apply
118
+ again with one selection.
119
+
120
+ ### Using saved views
121
+
122
+ The product list's toolbar carries a **Saved views** selector, whose first
123
+ entry is **— Select a view —**, and two buttons beside it: **Save view** and
124
+ **Delete view**.
125
+
126
+ - **What a view remembers.** The status, the type and the search text — and
127
+ nothing else. The **Stock**, **Category** and **Channel** chips are not saved.
128
+ Choosing a view sets status, type and search to the view's values (a value
129
+ the list no longer offers loads as *All*), resets the Stock chip to *All*,
130
+ discards anything you had changed and not saved, clears the row selection and
131
+ goes back to the first page.
132
+ - **Saving.** **Save view** opens one dialog with a **Name** field and a
133
+ **Share with every admin who can open this list** checkbox. The checkbox
134
+ starts unchecked, so a new view is private unless you tick it. The name is
135
+ required, leading and trailing spaces are removed, and it can be at most 160
136
+ characters long. Problems are shown on the field and nothing is sent until
137
+ they are fixed; a refusal from the server is shown inside the dialog, which
138
+ stays open with what you typed.
139
+ - **Private or shared.** A private view is listed only for you. A shared view
140
+ is listed for every admin who can open the product list, with **(shared)**
141
+ after its name. The selector does not show who saved a shared view.
142
+ - **One name per admin.** You cannot hold two views on this list whose names
143
+ differ only in letter case or in surrounding spaces. The dialog answers
144
+ **You already have a view with this name.** before sending anything, and the
145
+ server refuses the name as well. Accented letters are different letters:
146
+ *Wózki* and *Wozki* are two names. Names other admins use, and names used on
147
+ other lists, do not count.
148
+ - **Deleting.** **Delete view** is enabled only when the selected view is one
149
+ you may delete. It asks for confirmation and names the view —
150
+ **Delete the view “…”?** — and for a shared view adds that it will disappear
151
+ for every admin who can open this list. Nothing is deleted until you press
152
+ **Delete**.
153
+ - **Who may delete or change a shared view.** Its owner, or **any admin whose
154
+ role is not `sales_representative`** — not only the `platform_admin` role: a
155
+ custom role such as a catalog manager counts as well. **Such a deletion or
156
+ change leaves no audit trail**: saved views are not written to the audit log.
157
+ Decide which roles you grant with that in mind before your team relies on
158
+ shared views. A sales representative can delete only their own views, and
159
+ nobody can see or delete another admin's private view.
160
+ - **Only save, load and delete.** The Admin UI does not rename a view, change
161
+ whether it is shared, or overwrite it with the current filters; save a new
162
+ view and delete the old one instead. There is no limit on the number of
163
+ views.
164
+
165
+ ### Saved views API
166
+
167
+ | Method and path | Answers |
168
+ | --- | --- |
169
+ | `GET /api/v1/admin/catalog/products/list-views` | `200` — the caller's own views plus every shared view, ordered by name |
170
+ | `POST /api/v1/admin/catalog/products/list-views` | `201` — the created view |
171
+ | `PATCH /api/v1/admin/catalog/products/list-views/:id` | `200` — the modified view; any of `name`, `shared`, `filters`. The Admin UI does not call it. A body that changes nothing — empty, or every value as stored — writes nothing, logs nothing and answers the current view |
172
+ | `DELETE /api/v1/admin/catalog/products/list-views/:id` | `200` — `{ data: { deleted: <id> } }` |
173
+
174
+ - **Gate.** All four routes are gated by `catalog:read` — the code that gates
175
+ reading the product list; there is no separate permission code. A request
176
+ without an admin actor is refused with `401 UNAUTHORIZED`. The static
177
+ `list-views` segment takes precedence over `products/:id`.
178
+ - **Body.** `name` (trimmed, 1–160 characters, no Unicode control or format
179
+ characters), `shared` (boolean) and `filters` (an object, at most 8192 bytes
180
+ as UTF-8 JSON). The product list has no sort or column control, so a view
181
+ stores no `sort` or `visibleColumns`; those keys are dropped. The Admin UI
182
+ writes `filters` as `{ status?, type?, q? }`, only the non-default ones.
183
+ Anything outside those bounds is `400 VALIDATION_FAILED`. The shapes are
184
+ `createProductSavedViewRequestSchema` and
185
+ `updateProductSavedViewRequestSchema` in `@endora-commerce/contracts`.
186
+ - **Two caller-relative flags.** Every view in a response carries
187
+ `ownedByCaller` and `canModify` — `true` when the caller owns the view, or
188
+ the view is shared and the caller is a platform admin in the sense below. The
189
+ Admin UI enables **Delete view** from `canModify`, and before saving runs a
190
+ best-effort duplicate-name pre-check against the listed views with
191
+ `ownedByCaller`. The server's `lower(btrim(name))` comparison is
192
+ authoritative: a name the pre-check lets through can still be refused with
193
+ `409`.
194
+ - **Platform admin, for saved views,** is an admin whose request tenant context
195
+ has `mode === 'all'` — every role except `sales_representative`. The order,
196
+ product and quote request lists derive it the same way, and it fails closed:
197
+ an admin whose reach cannot be resolved is not a platform admin.
198
+ - **Refusals.** An absent view, or another admin's private view, is
199
+ `404 NOT_FOUND` — the two are indistinguishable. A shared view the caller
200
+ neither owns nor may modify as a platform admin is `403 FORBIDDEN`. A name
201
+ whose key the view's owner already uses on this list is
202
+ `409 PRODUCT_SAVED_VIEW_NAME_TAKEN`, *"You already have a saved view with this
203
+ name on the product list. Choose a different name."*, in the request's
204
+ language.
205
+ - **The name key** is the name trimmed and lower-cased — no accent folding. The
206
+ rule binds the view's **owner**: a platform admin renaming a colleague's
207
+ shared view is refused when the colleague already uses that key. Creating a
208
+ view and changing a name's key take a transaction-scoped advisory lock keyed
209
+ on the owner, and a unique index on `(owner_admin_user_id, lower(name))`
210
+ backs it, so two concurrent saves under one name leave exactly one view.
211
+ - **No audit.** Saved views are personal UI configuration and do not run
212
+ through the Command Bus. When an admin modifies or deletes a view they do not
213
+ own, the service writes one `info` log record:
214
+ `{ event: 'saved_view.updated' | 'saved_view.deleted', list: 'product_list_saved_views', viewId, ownerAdminUserId, actorAdminUserId }`.
215
+ That log line is the only trace.
216
+ - **Storage.** `product_list_saved_views` (`ProductListSavedView`) is
217
+ platform-global, not organization-scoped: it holds filter values, never list
218
+ results, and every list read after a view is applied runs under the loader's
219
+ own scope.
55
220
 
56
221
  ## Events emitted
57
222
 
@@ -104,13 +269,105 @@ modules are present. The payload is sent whole; the strict schemas are
104
269
 
105
270
  ## Extension points
106
271
 
107
- - **Per-Sales-Channel pricing** — query service receives a SalesChannel
108
- context; new gating (e.g. customer-segment-specific catalogs) is added by
109
- composing into `catalog-query.service.ts`.
272
+ - **Per-Sales-Channel listing** — the query service receives a SalesChannel
273
+ context, and every price it renders is resolved for that channel; new gating
274
+ (e.g. customer-segment-specific catalogs) is added by composing into
275
+ `catalog-query.service.ts`.
110
276
  - **Slug uniqueness** — the slug is unique across all Sales Channels by
111
277
  default; override the slugifier in `catalog-admin.service.ts` if locale
112
278
  collisions become a concern.
113
279
 
280
+ ## Order rules: minimum order quantity and returnable
281
+
282
+ Two rules on a product decide how it may be ordered and whether it may be sent
283
+ back. Both are edited in the **Order rules** card on the product editor's
284
+ **Inventory** tab.
285
+
286
+ > **Upgrading: every existing product starts as not returnable.** A product on
287
+ > which nobody has set **Returnable** reads as not returnable, and that includes
288
+ > every product that existed before the setting was introduced. Lines of orders
289
+ > placed after the upgrade are therefore not returnable until you mark their
290
+ > products. To mark many at once, select them on the product list and use
291
+ > **Bulk edit → Returnable → Yes — returnable**. Orders placed before the
292
+ > upgrade are unaffected: their lines stay returnable under the usual rules.
293
+
294
+ ### Minimum order quantity
295
+
296
+ - **Minimum order quantity (pcs)** — the fewest pieces of the product a buyer
297
+ may order in one order. Optional; a whole number from **1 to 1 000 000**, or
298
+ empty for no minimum. It applies to `simple` and `configurable` products
299
+ only: on a `grouped`, `bundle` or `virtual` product the card says so, and
300
+ the API refuses the field with `422 VALIDATION_FAILED` naming
301
+ `minOrderQuantity`, on create and on update. A value outside the range is
302
+ refused with `400 VALIDATION_FAILED`.
303
+ - **A minimum per packaging unit** — each packaging unit may carry its own
304
+ minimum number of units; see [Packaging Units](./catalog/packaging-units.md).
305
+
306
+ The minimum is judged on the **product total**: every line of the product in
307
+ the basket counts — single-piece and packaging-unit lines, every variant. A
308
+ packaging-unit minimum counts the units of that unit ordered for the product,
309
+ over every variant. The two checks are independent; a basket must satisfy
310
+ every minimum that is set. Variants inherit the product's minimum.
311
+
312
+ Every way into a basket, a quote request or an order applies it — the cart,
313
+ checkout, quick order, one-click buy, shopping lists, quote requests, the
314
+ admin's Create order screen and the external order API. Each of those modules'
315
+ pages says what its path does with a line below the minimum. A refusal answers
316
+ `422 PRODUCT_BELOW_MINIMUM_QUANTITY` (pieces) or
317
+ `422 PACKAGING_UNIT_BELOW_MINIMUM_QUANTITY` (a packaging unit), with a message
318
+ in the buyer's language naming the product and the minimum. Removing a line is
319
+ always allowed.
320
+
321
+ A product a buyer may not see, or that the request's sales channel does not
322
+ publish, is reported as an unknown product on every path — its name and its
323
+ minimum are never disclosed.
324
+
325
+ The storefront product detail, the product list, search results and the
326
+ comparison carry `minOrderQuantity` (`null` when there is none, or when the
327
+ product's type takes no minimum); the product detail's `packagingUnits[]`
328
+ carries each unit's `minOrderUnits`. The storefront starts the quantity at the
329
+ minimum and does not offer less.
330
+
331
+ ### Returnable
332
+
333
+ **Returnable** (yes / no, on every product type) says whether buyers may
334
+ include the product in a **return**. It does not restrict **complaints**. The
335
+ default is no.
336
+
337
+ The value is **recorded on each order line when the order is placed**
338
+ (`order_items.returnable_at_purchase`); changing the flag later changes no
339
+ order already placed. A line whose product could not be read at placement is
340
+ recorded as not returnable. What the Returns module does with the recorded
341
+ value is on its own page.
342
+
343
+ ### Audit and copies
344
+
345
+ Setting or clearing either rule is audited like any product edit, with the old
346
+ and the new value. **Bulk edit → Returnable** writes one audit entry per
347
+ product it changes, for up to 200 products in one synchronous request and
348
+ through the queued bulk edit beyond. Changing a rule never alters an existing
349
+ cart, order, quote request or return. **Duplicate** does not copy either rule:
350
+ the copy starts with no minimum and as not returnable.
351
+
352
+ ### API
353
+
354
+ | Field | Where | Values |
355
+ | --- | --- | --- |
356
+ | `minOrderQuantity` | `POST` / `PATCH /api/v1/admin/catalog/products[/:id]`, the admin product response | integer `1…1000000`, or `null` to clear |
357
+ | `returnable` | the same, and `POST /api/v1/admin/catalog/products/bulk-update` | boolean |
358
+ | `minOrderUnits` | `POST` / `PATCH …/packaging-units[/:unitId]`, the packaging-unit response | integer `1…1000000`, or `null` to clear |
359
+
360
+ The catalogue read port (`CatalogProductReadPort`) reports `minOrderQuantity`
361
+ and `returnable` on each product record and `minOrderUnits` on each packaging
362
+ unit, and gains `listPackagingUnitsByProductIds` for batch reads. Like every
363
+ method of the port it applies no visibility policy: a caller passes only
364
+ product ids it has already vetted.
365
+
366
+ Migration `20261016T082008_catalog_order_rules.ts` adds
367
+ `products.min_order_quantity` (nullable, `CHECK` 1–1 000 000),
368
+ `products.returnable` (not null, default `false`) and
369
+ `product_packaging_units.min_order_units` (nullable, `CHECK` 1–1 000 000).
370
+
114
371
  ## Product structure and composition surfaces
115
372
 
116
373
  The catalog grew several capability surfaces, each with its own page:
@@ -253,3 +510,18 @@ promotions port, the scope editor) read attributes through the
253
510
  catalog-exported `CatalogAttributeReadService`, which composes the
254
511
  definition and the extension into the legacy-shaped
255
512
  `CatalogAttributeView`.
513
+
514
+ ## Global search
515
+
516
+ The admin's global search (the command palette, ⌘K / Ctrl+K) finds products and categories. This module offers the fields below; which of them are used is chosen on the Global search configuration screen.
517
+
518
+ | Field | Searched by default |
519
+ | --- | --- |
520
+ | Product: SKU | yes |
521
+ | Product: Name | yes |
522
+ | Product: URL key (slug) | no |
523
+ | Product: Quick-search attributes | no |
524
+ | Category: Name | yes |
525
+ | Category: URL key (slug) | yes |
526
+
527
+ Names match in every language and are shown in the admin's language. Drafts and inactive products are found and show their status; deleted products and categories are not. A category result opens the category tree with that category highlighted. Both appear for a role holding `catalog:read`.
package/i18n/en.json CHANGED
@@ -42,6 +42,10 @@
42
42
  "productsList.bulkEdit.section.categories": "Categories",
43
43
  "productsList.bulkEdit.section.attributeSet": "Attribute Set",
44
44
  "productsList.bulkEdit.section.attributes": "Attribute values",
45
+ "productsList.bulkEdit.section.returnable": "Returnable",
46
+ "productsList.bulkEdit.returnable.yes": "Yes — returnable",
47
+ "productsList.bulkEdit.returnable.no": "No — not returnable",
48
+ "productsList.bulkEdit.returnable.hint": "Products are not returnable until you mark them — including every product that existed before the Returnable setting was introduced. Select the products buyers may send back and set them returnable here. Orders placed earlier keep the setting they were placed with.",
45
49
  "productsList.bulkEdit.attributeSet.none": "— No attribute set —",
46
50
  "productsList.bulkEdit.untouched": "(leave unchanged)",
47
51
  "productsList.bulkEdit.mode.add": "Add",
@@ -327,6 +331,7 @@
327
331
  "inventoryTab.stockMgmt.backorderGloballyDisabled": "Enable “Allow ordering below stock” in the Settings module (Inventory) first.",
328
332
  "inventoryTab.stockMgmt.backorderUnmanaged": "Not applicable while stock management is disabled — any quantity is already allowed.",
329
333
  "productEditor.loading": "Loading…",
334
+ "productEditor.tab.pricing": "Pricing",
330
335
  "productEditor.scopeEditor.title": "Scope: Sales Channel + Language",
331
336
  "productEditor.scopeEditor.help": "Preview how this product resolves per (channel, language) using the platform's resolver.",
332
337
  "productEditor.scopeEditor.overridesCount": "{count} channel-aware override(s) in place.",
@@ -383,8 +388,6 @@
383
388
  "productEditor.field.status.help": "Choose draft, active, or inactive. Inactive withdraws the product from merchandising without deleting it.",
384
389
  "productEditor.action.delete": "Delete",
385
390
  "productEditor.deleteConfirm": "Permanently delete this product from the catalog? This cannot be undone in the admin.",
386
- "productEditor.field.defaultPrice": "Default unit price",
387
- "productEditor.field.defaultPrice.help": "Price-list overrides take precedence at checkout.",
388
391
  "productEditor.field.localizedName": "Name [{locale}]",
389
392
  "productEditor.field.localizedDescription": "Description [{locale}]",
390
393
  "productEditor.seo.title": "Per-locale SEO",
@@ -400,7 +403,6 @@
400
403
  "productEditor.variants.deleteConfirm": "Delete variant \"{sku}\"?",
401
404
  "productEditor.variants.column.sku": "SKU",
402
405
  "productEditor.variants.column.attributes": "Attributes",
403
- "productEditor.variants.column.priceOverride": "Price override",
404
406
  "productEditor.variants.column.stock": "Stock",
405
407
  "productEditor.variants.column.actions": "Actions",
406
408
  "productEditor.variants.action.delete": "Delete",
@@ -409,7 +411,6 @@
409
411
  "productEditor.variants.field.sku": "SKU",
410
412
  "productEditor.variants.field.attributes": "Attributes",
411
413
  "productEditor.variants.field.attributesPlaceholder": "color=red, size=M",
412
- "productEditor.variants.field.priceOverride": "Price override",
413
414
  "productEditor.variants.field.stock": "Stock",
414
415
  "productEditor.gallery.title": "Gallery",
415
416
  "productEditor.gallery.productImages.title": "Product images",
@@ -541,6 +542,7 @@
541
542
  "errors.PRICE_RANGE_INVALID": "The minimum price must not exceed the maximum price.",
542
543
  "errors.PRODUCT_NOT_FOUND": "Product Not Found.",
543
544
  "errors.PRODUCT_ARCHIVED": "Product is inactive.",
545
+ "errors.PRODUCT_SAVED_VIEW_NAME_TAKEN": "You already have a saved view with this name on the product list. Choose a different name.",
544
546
  "errors.PRODUCT_DELETE_BLOCKED": "This product cannot be deleted because it is still referenced.",
545
547
  "errors.SKU_ALREADY_EXISTS": "Sku Already Exists.",
546
548
  "errors.VARIANT_COMBINATION_EXISTS": "Variant Combination Exists.",
@@ -577,6 +579,9 @@
577
579
  "errors.PRODUCT_NOT_IN_COMPARISON": "Product Not In Comparison.",
578
580
  "errors.PRODUCT_UNMANAGED_STOCK": "Product Unmanaged Stock.",
579
581
  "errors.SYSTEM_ATTRIBUTE_SET_IMMUTABLE": "This attribute set is part of the platform's own configuration. Its code is a stable integration key and cannot be changed, and the set itself cannot be deleted. Create your own attribute set and move the products onto it if you need a different one.",
582
+ "errors.PRODUCT_BELOW_MINIMUM_QUANTITY": "\"{productName}\" has a minimum order quantity of {minimum} pcs.",
583
+ "errors.PACKAGING_UNIT_BELOW_MINIMUM_QUANTITY": "\"{productName}\" must be ordered in at least {minimum} × {packagingUnitName}.",
584
+ "errors.PACKAGING_UNIT_MISMATCH": "The packaging unit on line {lineNumber} (\"{productName}\") does not match the product's packaging units.",
580
585
  "auditLog.product.update": "Product updated",
581
586
  "auditLog.attribute_set.create": "Attribute set created",
582
587
  "auditLog.attribute_set.update": "Attribute set updated",
@@ -621,6 +626,25 @@
621
626
  "packagingUnits.error.load": "Failed to load packaging units.",
622
627
  "packagingUnits.error.save": "Save failed.",
623
628
  "packagingUnits.error.invalid": "Enter a name and a whole number of pieces (at least 1).",
629
+ "packagingUnits.col.minOrderUnits": "Minimum (units)",
630
+ "packagingUnits.newMinimum": "Minimum (optional)",
631
+ "packagingUnits.minOrderUnitsHelp": "Minimum: the fewest of this unit a buyer may order at once. Leave it empty for no minimum.",
632
+ "packagingUnits.error.invalidMinimum": "The minimum must be a whole number from 1 to {max}, or empty for none.",
633
+ "orderRules.title": "Order rules",
634
+ "orderRules.loading": "Loading order rules…",
635
+ "orderRules.error.load": "Could not load the order rules. Reload the page to try again.",
636
+ "orderRules.error.save": "Could not save the order rules. Try again.",
637
+ "orderRules.saving": "Saving…",
638
+ "orderRules.saved": "Order rules saved.",
639
+ "orderRules.returnable.label": "Returnable",
640
+ "orderRules.returnable.help": "Buyers can include this product in a return. Products are not returnable until marked; to mark many at once, select them on the product list and use Bulk edit → Returnable.",
641
+ "orderRules.minimum.label": "Minimum order quantity (pcs)",
642
+ "orderRules.minimum.help": "The fewest pieces a buyer may order in one order. Leave it empty for no minimum.",
643
+ "orderRules.minimum.placeholder": "No minimum",
644
+ "orderRules.minimum.invalid": "Enter a whole number from 1 to {max}, or leave the field empty.",
645
+ "orderRules.minimum.save": "Save minimum",
646
+ "orderRules.minimum.clear": "Remove minimum",
647
+ "orderRules.minimum.notApplicable": "A minimum order quantity applies to simple and configurable products only.",
624
648
  "bulkOperations.undo.action": "Undo",
625
649
  "bulkOperations.undo.running": "Undoing…",
626
650
  "bulkOperations.undo.confirm": "Undo this bulk edit and restore {count} product(s) to their previous values?",
@@ -661,5 +685,17 @@
661
685
  "blocks.emailCategoryGrid.label": "Category grid",
662
686
  "blocks.emailCategoryGrid.description": "A grid of catalog categories, rendered for e-mail.",
663
687
  "blocks.category.catalog": "Catalog",
664
- "blocks.category.content": "Content"
688
+ "blocks.category.content": "Content",
689
+ "adminSearch.product.group.label": "Products",
690
+ "adminSearch.product.field.sku": "SKU",
691
+ "adminSearch.product.field.name": "Name",
692
+ "adminSearch.product.field.slug": "URL key (slug)",
693
+ "adminSearch.product.field.quickSearchAttributes": "Quick-search attributes",
694
+ "adminSearch.product.status.draft": "Draft",
695
+ "adminSearch.product.status.active": "Active",
696
+ "adminSearch.product.status.inactive": "Inactive",
697
+ "adminSearch.category.group.label": "Categories",
698
+ "adminSearch.category.field.name": "Name",
699
+ "adminSearch.category.field.slug": "URL key (slug)",
700
+ "errors.PRICE_SET_IN_PRICE_BOOKS": "Prices are set in price books, not on the product."
665
701
  }
package/i18n/pl.json CHANGED
@@ -42,6 +42,10 @@
42
42
  "productsList.bulkEdit.section.categories": "Kategorie",
43
43
  "productsList.bulkEdit.section.attributeSet": "Zestaw atrybutów",
44
44
  "productsList.bulkEdit.section.attributes": "Wartości atrybutów",
45
+ "productsList.bulkEdit.section.returnable": "Podlega zwrotowi",
46
+ "productsList.bulkEdit.returnable.yes": "Tak — podlega zwrotowi",
47
+ "productsList.bulkEdit.returnable.no": "Nie — nie podlega zwrotowi",
48
+ "productsList.bulkEdit.returnable.hint": "Produkty nie podlegają zwrotowi, dopóki ich nie oznaczysz — dotyczy to także wszystkich produktów istniejących przed wprowadzeniem tego ustawienia. Zaznacz produkty, które kupujący mogą odesłać, i oznacz je tutaj jako podlegające zwrotowi. Zamówienia złożone wcześniej zachowują ustawienie z chwili złożenia.",
45
49
  "productsList.bulkEdit.attributeSet.none": "— Brak zestawu atrybutów —",
46
50
  "productsList.bulkEdit.untouched": "(pozostaw bez zmian)",
47
51
  "productsList.bulkEdit.mode.add": "Dodaj",
@@ -327,6 +331,7 @@
327
331
  "inventoryTab.stockMgmt.backorderGloballyDisabled": "Najpierw włącz „Zezwól na zamawianie poniżej stanu” w module Settings (Magazyn).",
328
332
  "inventoryTab.stockMgmt.backorderUnmanaged": "Nie dotyczy, gdy zarządzanie stanem jest wyłączone — dowolna ilość jest już dozwolona.",
329
333
  "productEditor.loading": "Wczytywanie…",
334
+ "productEditor.tab.pricing": "Ceny",
330
335
  "productEditor.scopeEditor.title": "Kontekst: Kanał sprzedaży + Język",
331
336
  "productEditor.scopeEditor.help": "Podgląd jak ten produkt jest rozstrzygany dla danej pary (kanał, język) przez resolver platformy.",
332
337
  "productEditor.scopeEditor.overridesCount": "{count} nadpis(ań|anie) zależnych od kanału.",
@@ -383,8 +388,6 @@
383
388
  "productEditor.field.status.help": "Wybierz szkic, aktywny lub nieaktywny. Nieaktywny wycofuje produkt z oferty bez usuwania go z katalogu.",
384
389
  "productEditor.action.delete": "Usuń",
385
390
  "productEditor.deleteConfirm": "Trwale usunąć ten produkt z katalogu? W panelu admin nie będzie można tego cofnąć.",
386
- "productEditor.field.defaultPrice": "Domyślna cena jednostkowa",
387
- "productEditor.field.defaultPrice.help": "Nadpisania z cenników mają pierwszeństwo przy kasie.",
388
391
  "productEditor.field.localizedName": "Nazwa [{locale}]",
389
392
  "productEditor.field.localizedDescription": "Opis [{locale}]",
390
393
  "productEditor.seo.title": "SEO per locale",
@@ -400,7 +403,6 @@
400
403
  "productEditor.variants.deleteConfirm": "Usunąć wariant „{sku}”?",
401
404
  "productEditor.variants.column.sku": "SKU",
402
405
  "productEditor.variants.column.attributes": "Atrybuty",
403
- "productEditor.variants.column.priceOverride": "Nadpisanie ceny",
404
406
  "productEditor.variants.column.stock": "Stan",
405
407
  "productEditor.variants.column.actions": "Akcje",
406
408
  "productEditor.variants.action.delete": "Usuń",
@@ -409,7 +411,6 @@
409
411
  "productEditor.variants.field.sku": "SKU",
410
412
  "productEditor.variants.field.attributes": "Atrybuty",
411
413
  "productEditor.variants.field.attributesPlaceholder": "color=red, size=M",
412
- "productEditor.variants.field.priceOverride": "Nadpisanie ceny",
413
414
  "productEditor.variants.field.stock": "Stan",
414
415
  "productEditor.gallery.title": "Galeria",
415
416
  "productEditor.gallery.productImages.title": "Zdjęcia produktu",
@@ -541,6 +542,7 @@
541
542
  "errors.PRICE_RANGE_INVALID": "Cena minimalna nie może być wyższa niż maksymalna.",
542
543
  "errors.PRODUCT_NOT_FOUND": "Błąd: product not found.",
543
544
  "errors.PRODUCT_ARCHIVED": "Produkt jest nieaktywny.",
545
+ "errors.PRODUCT_SAVED_VIEW_NAME_TAKEN": "Masz już zapisany widok o tej nazwie na liście produktów. Wybierz inną nazwę.",
544
546
  "errors.PRODUCT_DELETE_BLOCKED": "Nie można usunąć produktu — jest nadal powiązany z innymi rekordami.",
545
547
  "errors.SKU_ALREADY_EXISTS": "Błąd: sku already exists.",
546
548
  "errors.VARIANT_COMBINATION_EXISTS": "Błąd: variant combination exists.",
@@ -577,6 +579,9 @@
577
579
  "errors.PRODUCT_NOT_IN_COMPARISON": "Błąd: product not in comparison.",
578
580
  "errors.PRODUCT_UNMANAGED_STOCK": "Błąd: product unmanaged stock.",
579
581
  "errors.SYSTEM_ATTRIBUTE_SET_IMMUTABLE": "Ten zestaw atrybutów należy do konfiguracji samej platformy. Jego kod jest stałym kluczem integracyjnym i nie można go zmienić, a samego zestawu nie można usunąć. Jeśli potrzebujesz innego, utwórz własny zestaw atrybutów i przenieś na niego produkty.",
582
+ "errors.PRODUCT_BELOW_MINIMUM_QUANTITY": "Minimalna ilość zamówienia produktu „{productName}” to {minimum} szt.",
583
+ "errors.PACKAGING_UNIT_BELOW_MINIMUM_QUANTITY": "Produkt „{productName}” należy zamówić w ilości co najmniej {minimum} × {packagingUnitName}.",
584
+ "errors.PACKAGING_UNIT_MISMATCH": "Jednostka opakowania w pozycji {lineNumber} („{productName}”) nie odpowiada jednostkom opakowania produktu.",
580
585
  "auditLog.product.update": "Zaktualizowano produkt",
581
586
  "auditLog.attribute_set.create": "Utworzono zestaw atrybutów",
582
587
  "auditLog.attribute_set.update": "Zaktualizowano zestaw atrybutów",
@@ -621,6 +626,25 @@
621
626
  "packagingUnits.error.load": "Nie udało się wczytać jednostek opakowaniowych.",
622
627
  "packagingUnits.error.save": "Zapis nie powiódł się.",
623
628
  "packagingUnits.error.invalid": "Podaj nazwę i całkowitą liczbę sztuk (co najmniej 1).",
629
+ "packagingUnits.col.minOrderUnits": "Minimum (w jednostkach)",
630
+ "packagingUnits.newMinimum": "Minimum (opcjonalnie)",
631
+ "packagingUnits.minOrderUnitsHelp": "Minimum: najmniejsza liczba tej jednostki, jaką kupujący może zamówić naraz. Zostaw puste, aby nie ustawiać minimum.",
632
+ "packagingUnits.error.invalidMinimum": "Minimum musi być liczbą całkowitą od 1 do {max} albo pozostać puste.",
633
+ "orderRules.title": "Zasady zamawiania",
634
+ "orderRules.loading": "Wczytywanie zasad zamawiania…",
635
+ "orderRules.error.load": "Nie udało się wczytać zasad zamawiania. Odśwież stronę, aby spróbować ponownie.",
636
+ "orderRules.error.save": "Nie udało się zapisać zasad zamawiania. Spróbuj ponownie.",
637
+ "orderRules.saving": "Zapisywanie…",
638
+ "orderRules.saved": "Zapisano zasady zamawiania.",
639
+ "orderRules.returnable.label": "Podlega zwrotowi",
640
+ "orderRules.returnable.help": "Kupujący mogą zgłosić ten produkt do zwrotu. Produkty nie podlegają zwrotowi, dopóki ich nie oznaczysz; aby oznaczyć wiele naraz, zaznacz je na liście produktów i użyj Edycji masowej → Podlega zwrotowi.",
641
+ "orderRules.minimum.label": "Minimalna ilość zamówienia (szt.)",
642
+ "orderRules.minimum.help": "Najmniejsza liczba sztuk, jaką kupujący może zamówić w jednym zamówieniu. Zostaw puste, aby nie ustawiać minimum.",
643
+ "orderRules.minimum.placeholder": "Brak minimum",
644
+ "orderRules.minimum.invalid": "Wpisz liczbę całkowitą od 1 do {max} albo zostaw pole puste.",
645
+ "orderRules.minimum.save": "Zapisz minimum",
646
+ "orderRules.minimum.clear": "Usuń minimum",
647
+ "orderRules.minimum.notApplicable": "Minimalna ilość zamówienia dotyczy tylko produktów prostych i konfigurowalnych.",
624
648
  "bulkOperations.undo.action": "Cofnij",
625
649
  "bulkOperations.undo.running": "Cofanie…",
626
650
  "bulkOperations.undo.confirm": "Cofnąć tę edycję masową i przywrócić {count} produkt(ów) do poprzednich wartości?",
@@ -661,5 +685,17 @@
661
685
  "blocks.emailCategoryGrid.label": "Siatka kategorii",
662
686
  "blocks.emailCategoryGrid.description": "Siatka kategorii katalogu renderowana na potrzeby e-maila.",
663
687
  "blocks.category.catalog": "Katalog",
664
- "blocks.category.content": "Treść"
688
+ "blocks.category.content": "Treść",
689
+ "adminSearch.product.group.label": "Produkty",
690
+ "adminSearch.product.field.sku": "SKU",
691
+ "adminSearch.product.field.name": "Nazwa",
692
+ "adminSearch.product.field.slug": "Klucz URL (slug)",
693
+ "adminSearch.product.field.quickSearchAttributes": "Atrybuty szybkiego wyszukiwania",
694
+ "adminSearch.product.status.draft": "Roboczy",
695
+ "adminSearch.product.status.active": "Aktywny",
696
+ "adminSearch.product.status.inactive": "Nieaktywny",
697
+ "adminSearch.category.group.label": "Kategorie",
698
+ "adminSearch.category.field.name": "Nazwa",
699
+ "adminSearch.category.field.slug": "Klucz URL (slug)",
700
+ "errors.PRICE_SET_IN_PRICE_BOOKS": "Ceny ustala się w cennikach, a nie w produkcie."
665
701
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@endora-commerce/mod-catalog",
3
- "version": "0.106.0",
3
+ "version": "0.108.0",
4
4
  "type": "module",
5
5
  "sideEffects": false,
6
6
  "description": "Products, variants, categories, attributes, attribute sets, gallery, attachments, links, and bundles.",
@@ -61,10 +61,10 @@
61
61
  "react": "^19",
62
62
  "react-router-dom": "^7",
63
63
  "zod": "^4",
64
- "@endora-commerce/admin-kit": "0.106.0",
65
- "@endora-commerce/contracts": "0.106.0",
66
- "@endora-commerce/mod-custom-fields": "0.106.0",
67
- "@endora-commerce/platform": "0.106.0"
64
+ "@endora-commerce/admin-kit": "0.108.0",
65
+ "@endora-commerce/contracts": "0.108.0",
66
+ "@endora-commerce/mod-custom-fields": "0.108.0",
67
+ "@endora-commerce/platform": "0.108.0"
68
68
  },
69
69
  "peerDependenciesMeta": {
70
70
  "@endora-commerce/admin-kit": {
@@ -95,10 +95,10 @@
95
95
  "typescript": "^5.9.3",
96
96
  "vitest": "^4.1.11",
97
97
  "zod": "^4.2.0",
98
- "@endora-commerce/admin-kit": "0.106.0",
99
- "@endora-commerce/contracts": "0.106.0",
100
- "@endora-commerce/mod-custom-fields": "0.106.0",
101
- "@endora-commerce/platform": "0.106.0"
98
+ "@endora-commerce/admin-kit": "0.108.0",
99
+ "@endora-commerce/contracts": "0.108.0",
100
+ "@endora-commerce/mod-custom-fields": "0.108.0",
101
+ "@endora-commerce/platform": "0.108.0"
102
102
  },
103
103
  "scripts": {
104
104
  "build": "tsc -p tsconfig.build.json && tsc -p tsconfig.ui.json",