@endora-commerce/mod-catalog 0.107.0 → 0.109.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 (403) hide show
  1. package/dist/admin/components/AttachmentScopesDialog.d.ts +22 -0
  2. package/dist/admin/components/AttachmentScopesDialog.d.ts.map +1 -0
  3. package/dist/admin/components/AttachmentScopesDialog.js +70 -0
  4. package/dist/admin/components/AttachmentScopesDialog.js.map +1 -0
  5. package/dist/admin/components/PackagingUnitsEditor.d.ts +10 -1
  6. package/dist/admin/components/PackagingUnitsEditor.d.ts.map +1 -1
  7. package/dist/admin/components/PackagingUnitsEditor.js +127 -10
  8. package/dist/admin/components/PackagingUnitsEditor.js.map +1 -1
  9. package/dist/admin/components/ProductAttachmentsSection.d.ts +5 -0
  10. package/dist/admin/components/ProductAttachmentsSection.d.ts.map +1 -0
  11. package/dist/admin/components/ProductAttachmentsSection.js +137 -0
  12. package/dist/admin/components/ProductAttachmentsSection.js.map +1 -0
  13. package/dist/admin/components/ProductGallerySection.d.ts +14 -0
  14. package/dist/admin/components/ProductGallerySection.d.ts.map +1 -0
  15. package/dist/admin/components/ProductGallerySection.js +385 -0
  16. package/dist/admin/components/ProductGallerySection.js.map +1 -0
  17. package/dist/admin/components/ProductOrderRulesCard.d.ts +19 -0
  18. package/dist/admin/components/ProductOrderRulesCard.d.ts.map +1 -0
  19. package/dist/admin/components/ProductOrderRulesCard.js +275 -0
  20. package/dist/admin/components/ProductOrderRulesCard.js.map +1 -0
  21. package/dist/admin/components/ProductScopeControls.d.ts +31 -0
  22. package/dist/admin/components/ProductScopeControls.d.ts.map +1 -0
  23. package/dist/admin/components/ProductScopeControls.js +243 -0
  24. package/dist/admin/components/ProductScopeControls.js.map +1 -0
  25. package/dist/admin/components/ProductScopeEditor.d.ts +12 -18
  26. package/dist/admin/components/ProductScopeEditor.d.ts.map +1 -1
  27. package/dist/admin/components/ProductScopeEditor.js +5 -4
  28. package/dist/admin/components/ProductScopeEditor.js.map +1 -1
  29. package/dist/admin/components/ProductScopeOverview.d.ts +26 -0
  30. package/dist/admin/components/ProductScopeOverview.d.ts.map +1 -0
  31. package/dist/admin/components/ProductScopeOverview.js +207 -0
  32. package/dist/admin/components/ProductScopeOverview.js.map +1 -0
  33. package/dist/admin/components/ProductStatusPills.d.ts +17 -0
  34. package/dist/admin/components/ProductStatusPills.d.ts.map +1 -0
  35. package/dist/admin/components/ProductStatusPills.js +23 -0
  36. package/dist/admin/components/ProductStatusPills.js.map +1 -0
  37. package/dist/admin/components/ProductUrlKeysPanel.d.ts +17 -0
  38. package/dist/admin/components/ProductUrlKeysPanel.d.ts.map +1 -0
  39. package/dist/admin/components/ProductUrlKeysPanel.js +215 -0
  40. package/dist/admin/components/ProductUrlKeysPanel.js.map +1 -0
  41. package/dist/admin/components/ProductsBulkEditDialog.d.ts +30 -0
  42. package/dist/admin/components/ProductsBulkEditDialog.d.ts.map +1 -1
  43. package/dist/admin/components/ProductsBulkEditDialog.js +308 -125
  44. package/dist/admin/components/ProductsBulkEditDialog.js.map +1 -1
  45. package/dist/admin/components/ScopedDialogParts.d.ts +23 -0
  46. package/dist/admin/components/ScopedDialogParts.d.ts.map +1 -0
  47. package/dist/admin/components/ScopedDialogParts.js +16 -0
  48. package/dist/admin/components/ScopedDialogParts.js.map +1 -0
  49. package/dist/admin/index.d.ts +2 -2
  50. package/dist/admin/index.d.ts.map +1 -1
  51. package/dist/admin/index.js +9 -0
  52. package/dist/admin/index.js.map +1 -1
  53. package/dist/admin/lib/attribute-scope.d.ts +20 -0
  54. package/dist/admin/lib/attribute-scope.d.ts.map +1 -0
  55. package/dist/admin/lib/attribute-scope.js +18 -0
  56. package/dist/admin/lib/attribute-scope.js.map +1 -0
  57. package/dist/admin/lib/bulk-operation-log-text.d.ts +9 -0
  58. package/dist/admin/lib/bulk-operation-log-text.d.ts.map +1 -0
  59. package/dist/admin/lib/bulk-operation-log-text.js +13 -0
  60. package/dist/admin/lib/bulk-operation-log-text.js.map +1 -0
  61. package/dist/admin/lib/media-scopes.d.ts +41 -0
  62. package/dist/admin/lib/media-scopes.d.ts.map +1 -0
  63. package/dist/admin/lib/media-scopes.js +66 -0
  64. package/dist/admin/lib/media-scopes.js.map +1 -0
  65. package/dist/admin/lib/product-labels.d.ts +14 -0
  66. package/dist/admin/lib/product-labels.d.ts.map +1 -0
  67. package/dist/admin/lib/product-labels.js +27 -0
  68. package/dist/admin/lib/product-labels.js.map +1 -0
  69. package/dist/admin/lib/product-scope-drafts.d.ts +77 -0
  70. package/dist/admin/lib/product-scope-drafts.d.ts.map +1 -0
  71. package/dist/admin/lib/product-scope-drafts.js +133 -0
  72. package/dist/admin/lib/product-scope-drafts.js.map +1 -0
  73. package/dist/admin/lib/product-scopes-api.d.ts +40 -0
  74. package/dist/admin/lib/product-scopes-api.d.ts.map +1 -0
  75. package/dist/admin/lib/product-scopes-api.js +101 -0
  76. package/dist/admin/lib/product-scopes-api.js.map +1 -0
  77. package/dist/admin/lib/product-url-keys-api.d.ts +46 -0
  78. package/dist/admin/lib/product-url-keys-api.d.ts.map +1 -0
  79. package/dist/admin/lib/product-url-keys-api.js +110 -0
  80. package/dist/admin/lib/product-url-keys-api.js.map +1 -0
  81. package/dist/admin/lib/resolve-product-selection.d.ts +29 -1
  82. package/dist/admin/lib/resolve-product-selection.d.ts.map +1 -1
  83. package/dist/admin/lib/resolve-product-selection.js +42 -6
  84. package/dist/admin/lib/resolve-product-selection.js.map +1 -1
  85. package/dist/admin/lib/scope-overview.d.ts +74 -0
  86. package/dist/admin/lib/scope-overview.d.ts.map +1 -0
  87. package/dist/admin/lib/scope-overview.js +173 -0
  88. package/dist/admin/lib/scope-overview.js.map +1 -0
  89. package/dist/admin/pages/AttributesManager.d.ts.map +1 -1
  90. package/dist/admin/pages/AttributesManager.js +84 -7
  91. package/dist/admin/pages/AttributesManager.js.map +1 -1
  92. package/dist/admin/pages/BulkOperationDetailPage.d.ts.map +1 -1
  93. package/dist/admin/pages/BulkOperationDetailPage.js +4 -19
  94. package/dist/admin/pages/BulkOperationDetailPage.js.map +1 -1
  95. package/dist/admin/pages/ProductEditor.d.ts +0 -4
  96. package/dist/admin/pages/ProductEditor.d.ts.map +1 -1
  97. package/dist/admin/pages/ProductEditor.js +221 -374
  98. package/dist/admin/pages/ProductEditor.js.map +1 -1
  99. package/dist/admin/pages/ProductsList.d.ts +12 -0
  100. package/dist/admin/pages/ProductsList.d.ts.map +1 -1
  101. package/dist/admin/pages/ProductsList.js +105 -38
  102. package/dist/admin/pages/ProductsList.js.map +1 -1
  103. package/dist/backend/admin-search-provider.d.ts +1 -1
  104. package/dist/backend/admin-search-provider.d.ts.map +1 -1
  105. package/dist/backend/admin-search-provider.js +1 -2
  106. package/dist/backend/admin-search-provider.js.map +1 -1
  107. package/dist/backend/demo/reset.d.ts +1 -1
  108. package/dist/backend/demo/rows.d.ts +14 -3
  109. package/dist/backend/demo/rows.d.ts.map +1 -1
  110. package/dist/backend/demo/rows.js +24 -17
  111. package/dist/backend/demo/rows.js.map +1 -1
  112. package/dist/backend/demo/seed.d.ts.map +1 -1
  113. package/dist/backend/demo/seed.js +3 -6
  114. package/dist/backend/demo/seed.js.map +1 -1
  115. package/dist/backend/entities/bulk-operation.entity.d.ts +10 -0
  116. package/dist/backend/entities/bulk-operation.entity.d.ts.map +1 -1
  117. package/dist/backend/entities/bulk-operation.entity.js.map +1 -1
  118. package/dist/backend/entities/gallery-item-channel-hidden.entity.d.ts +14 -0
  119. package/dist/backend/entities/gallery-item-channel-hidden.entity.d.ts.map +1 -0
  120. package/dist/backend/entities/gallery-item-channel-hidden.entity.js +42 -0
  121. package/dist/backend/entities/gallery-item-channel-hidden.entity.js.map +1 -0
  122. package/dist/backend/entities/gallery-item-channel-label.entity.d.ts +18 -0
  123. package/dist/backend/entities/gallery-item-channel-label.entity.d.ts.map +1 -0
  124. package/dist/backend/entities/gallery-item-channel-label.entity.js +49 -0
  125. package/dist/backend/entities/gallery-item-channel-label.entity.js.map +1 -0
  126. package/dist/backend/entities/gallery-item.entity.d.ts +8 -1
  127. package/dist/backend/entities/gallery-item.entity.d.ts.map +1 -1
  128. package/dist/backend/entities/gallery-item.entity.js +11 -0
  129. package/dist/backend/entities/gallery-item.entity.js.map +1 -1
  130. package/dist/backend/entities/product-attachment-channel-hidden.entity.d.ts +13 -0
  131. package/dist/backend/entities/product-attachment-channel-hidden.entity.d.ts.map +1 -0
  132. package/dist/backend/entities/product-attachment-channel-hidden.entity.js +41 -0
  133. package/dist/backend/entities/product-attachment-channel-hidden.entity.js.map +1 -0
  134. package/dist/backend/entities/product-attachment.entity.d.ts +8 -1
  135. package/dist/backend/entities/product-attachment.entity.d.ts.map +1 -1
  136. package/dist/backend/entities/product-attachment.entity.js +15 -0
  137. package/dist/backend/entities/product-attachment.entity.js.map +1 -1
  138. package/dist/backend/entities/product-channel-language-scope.entity.d.ts +23 -0
  139. package/dist/backend/entities/product-channel-language-scope.entity.d.ts.map +1 -0
  140. package/dist/backend/entities/product-channel-language-scope.entity.js +61 -0
  141. package/dist/backend/entities/product-channel-language-scope.entity.js.map +1 -0
  142. package/dist/backend/entities/product-channel-scope.entity.d.ts +42 -0
  143. package/dist/backend/entities/product-channel-scope.entity.d.ts.map +1 -0
  144. package/dist/backend/entities/product-channel-scope.entity.js +104 -0
  145. package/dist/backend/entities/product-channel-scope.entity.js.map +1 -0
  146. package/dist/backend/entities/product-packaging-unit.entity.d.ts +13 -1
  147. package/dist/backend/entities/product-packaging-unit.entity.d.ts.map +1 -1
  148. package/dist/backend/entities/product-packaging-unit.entity.js +20 -0
  149. package/dist/backend/entities/product-packaging-unit.entity.js.map +1 -1
  150. package/dist/backend/entities/product-url-key.entity.d.ts +32 -0
  151. package/dist/backend/entities/product-url-key.entity.d.ts.map +1 -0
  152. package/dist/backend/entities/product-url-key.entity.js +75 -0
  153. package/dist/backend/entities/product-url-key.entity.js.map +1 -0
  154. package/dist/backend/entities/product-url-redirect.entity.d.ts +23 -0
  155. package/dist/backend/entities/product-url-redirect.entity.d.ts.map +1 -0
  156. package/dist/backend/entities/product-url-redirect.entity.js +58 -0
  157. package/dist/backend/entities/product-url-redirect.entity.js.map +1 -0
  158. package/dist/backend/entities/product-variant.entity.d.ts +1 -2
  159. package/dist/backend/entities/product-variant.entity.d.ts.map +1 -1
  160. package/dist/backend/entities/product-variant.entity.js +0 -5
  161. package/dist/backend/entities/product-variant.entity.js.map +1 -1
  162. package/dist/backend/entities/product.entity.d.ts +41 -2
  163. package/dist/backend/entities/product.entity.d.ts.map +1 -1
  164. package/dist/backend/entities/product.entity.js +84 -1
  165. package/dist/backend/entities/product.entity.js.map +1 -1
  166. package/dist/backend/index.d.ts +27 -6
  167. package/dist/backend/index.d.ts.map +1 -1
  168. package/dist/backend/index.js +209 -15
  169. package/dist/backend/index.js.map +1 -1
  170. package/dist/backend/plugin.d.ts +45 -4
  171. package/dist/backend/plugin.d.ts.map +1 -1
  172. package/dist/backend/plugin.js +67 -9
  173. package/dist/backend/plugin.js.map +1 -1
  174. package/dist/backend/prompt-tools.d.ts +10 -0
  175. package/dist/backend/prompt-tools.d.ts.map +1 -1
  176. package/dist/backend/prompt-tools.js +108 -4
  177. package/dist/backend/prompt-tools.js.map +1 -1
  178. package/dist/backend/routes.admin.d.ts +29 -0
  179. package/dist/backend/routes.admin.d.ts.map +1 -1
  180. package/dist/backend/routes.admin.js +161 -55
  181. package/dist/backend/routes.admin.js.map +1 -1
  182. package/dist/backend/routes.admin.url-keys.d.ts +23 -0
  183. package/dist/backend/routes.admin.url-keys.d.ts.map +1 -0
  184. package/dist/backend/routes.admin.url-keys.js +14 -0
  185. package/dist/backend/routes.admin.url-keys.js.map +1 -0
  186. package/dist/backend/routes.api-key.d.ts.map +1 -1
  187. package/dist/backend/routes.api-key.js +14 -1
  188. package/dist/backend/routes.api-key.js.map +1 -1
  189. package/dist/backend/routes.external.d.ts.map +1 -1
  190. package/dist/backend/routes.external.js +6 -1
  191. package/dist/backend/routes.external.js.map +1 -1
  192. package/dist/backend/routes.public.d.ts +24 -7
  193. package/dist/backend/routes.public.d.ts.map +1 -1
  194. package/dist/backend/routes.public.js +58 -29
  195. package/dist/backend/routes.public.js.map +1 -1
  196. package/dist/backend/routes.public.url-keys.d.ts +26 -0
  197. package/dist/backend/routes.public.url-keys.d.ts.map +1 -0
  198. package/dist/backend/routes.public.url-keys.js +17 -0
  199. package/dist/backend/routes.public.url-keys.js.map +1 -0
  200. package/dist/backend/services/asset-references.js +43 -30
  201. package/dist/backend/services/asset-references.js.map +1 -1
  202. package/dist/backend/services/attachment-packaging-scopes.d.ts +43 -0
  203. package/dist/backend/services/attachment-packaging-scopes.d.ts.map +1 -0
  204. package/dist/backend/services/attachment-packaging-scopes.js +115 -0
  205. package/dist/backend/services/attachment-packaging-scopes.js.map +1 -0
  206. package/dist/backend/services/attachment.service.d.ts +12 -1
  207. package/dist/backend/services/attachment.service.d.ts.map +1 -1
  208. package/dist/backend/services/attachment.service.js +119 -21
  209. package/dist/backend/services/attachment.service.js.map +1 -1
  210. package/dist/backend/services/attribute-scope-preview.d.ts +38 -0
  211. package/dist/backend/services/attribute-scope-preview.d.ts.map +1 -0
  212. package/dist/backend/services/attribute-scope-preview.js +66 -0
  213. package/dist/backend/services/attribute-scope-preview.js.map +1 -0
  214. package/dist/backend/services/bulk-operation.service.d.ts +36 -0
  215. package/dist/backend/services/bulk-operation.service.d.ts.map +1 -1
  216. package/dist/backend/services/bulk-operation.service.js +203 -36
  217. package/dist/backend/services/bulk-operation.service.js.map +1 -1
  218. package/dist/backend/services/bundle.service.d.ts +9 -1
  219. package/dist/backend/services/bundle.service.d.ts.map +1 -1
  220. package/dist/backend/services/bundle.service.js +12 -2
  221. package/dist/backend/services/bundle.service.js.map +1 -1
  222. package/dist/backend/services/catalog-admin-search.service.d.ts +1 -1
  223. package/dist/backend/services/catalog-admin-search.service.js +1 -1
  224. package/dist/backend/services/catalog-admin.service.d.ts +125 -18
  225. package/dist/backend/services/catalog-admin.service.d.ts.map +1 -1
  226. package/dist/backend/services/catalog-admin.service.js +367 -164
  227. package/dist/backend/services/catalog-admin.service.js.map +1 -1
  228. package/dist/backend/services/catalog-bulk-import.service.d.ts +24 -2
  229. package/dist/backend/services/catalog-bulk-import.service.d.ts.map +1 -1
  230. package/dist/backend/services/catalog-bulk-import.service.js +132 -6
  231. package/dist/backend/services/catalog-bulk-import.service.js.map +1 -1
  232. package/dist/backend/services/catalog-bulk-update.service.d.ts +32 -4
  233. package/dist/backend/services/catalog-bulk-update.service.d.ts.map +1 -1
  234. package/dist/backend/services/catalog-bulk-update.service.js +115 -12
  235. package/dist/backend/services/catalog-bulk-update.service.js.map +1 -1
  236. package/dist/backend/services/catalog-org-price-decorator.d.ts +18 -27
  237. package/dist/backend/services/catalog-org-price-decorator.d.ts.map +1 -1
  238. package/dist/backend/services/catalog-org-price-decorator.js +77 -33
  239. package/dist/backend/services/catalog-org-price-decorator.js.map +1 -1
  240. package/dist/backend/services/catalog-product-filter.service.d.ts +16 -2
  241. package/dist/backend/services/catalog-product-filter.service.d.ts.map +1 -1
  242. package/dist/backend/services/catalog-product-filter.service.js +80 -3
  243. package/dist/backend/services/catalog-product-filter.service.js.map +1 -1
  244. package/dist/backend/services/catalog-product-read.service.d.ts +45 -3
  245. package/dist/backend/services/catalog-product-read.service.d.ts.map +1 -1
  246. package/dist/backend/services/catalog-product-read.service.js +130 -3
  247. package/dist/backend/services/catalog-product-read.service.js.map +1 -1
  248. package/dist/backend/services/catalog-query.service.d.ts +145 -40
  249. package/dist/backend/services/catalog-query.service.d.ts.map +1 -1
  250. package/dist/backend/services/catalog-query.service.js +1048 -391
  251. package/dist/backend/services/catalog-query.service.js.map +1 -1
  252. package/dist/backend/services/catalog-quick-search.service.d.ts +18 -2
  253. package/dist/backend/services/catalog-quick-search.service.d.ts.map +1 -1
  254. package/dist/backend/services/catalog-quick-search.service.js +52 -20
  255. package/dist/backend/services/catalog-quick-search.service.js.map +1 -1
  256. package/dist/backend/services/catalog-write-ports.d.ts +18 -1
  257. package/dist/backend/services/catalog-write-ports.d.ts.map +1 -1
  258. package/dist/backend/services/catalog-write-ports.js +77 -0
  259. package/dist/backend/services/catalog-write-ports.js.map +1 -1
  260. package/dist/backend/services/category-admin.service.d.ts +12 -1
  261. package/dist/backend/services/category-admin.service.d.ts.map +1 -1
  262. package/dist/backend/services/category-admin.service.js +23 -2
  263. package/dist/backend/services/category-admin.service.js.map +1 -1
  264. package/dist/backend/services/channel-url-facts.d.ts +17 -0
  265. package/dist/backend/services/channel-url-facts.d.ts.map +1 -0
  266. package/dist/backend/services/channel-url-facts.js +20 -0
  267. package/dist/backend/services/channel-url-facts.js.map +1 -0
  268. package/dist/backend/services/effective-value.sql.d.ts +56 -0
  269. package/dist/backend/services/effective-value.sql.d.ts.map +1 -0
  270. package/dist/backend/services/effective-value.sql.js +111 -0
  271. package/dist/backend/services/effective-value.sql.js.map +1 -0
  272. package/dist/backend/services/gallery-scopes.d.ts +40 -0
  273. package/dist/backend/services/gallery-scopes.d.ts.map +1 -0
  274. package/dist/backend/services/gallery-scopes.js +151 -0
  275. package/dist/backend/services/gallery-scopes.js.map +1 -0
  276. package/dist/backend/services/gallery.service.d.ts +46 -4
  277. package/dist/backend/services/gallery.service.d.ts.map +1 -1
  278. package/dist/backend/services/gallery.service.js +308 -46
  279. package/dist/backend/services/gallery.service.js.map +1 -1
  280. package/dist/backend/services/linkable-asset.d.ts +21 -0
  281. package/dist/backend/services/linkable-asset.d.ts.map +1 -0
  282. package/dist/backend/services/linkable-asset.js +31 -0
  283. package/dist/backend/services/linkable-asset.js.map +1 -0
  284. package/dist/backend/services/packaging-unit.service.d.ts.map +1 -1
  285. package/dist/backend/services/packaging-unit.service.js +95 -29
  286. package/dist/backend/services/packaging-unit.service.js.map +1 -1
  287. package/dist/backend/services/primary-asset-url.d.ts +7 -1
  288. package/dist/backend/services/primary-asset-url.d.ts.map +1 -1
  289. package/dist/backend/services/primary-asset-url.js +45 -14
  290. package/dist/backend/services/primary-asset-url.js.map +1 -1
  291. package/dist/backend/services/product-availability.service.d.ts +79 -0
  292. package/dist/backend/services/product-availability.service.d.ts.map +1 -0
  293. package/dist/backend/services/product-availability.service.js +223 -0
  294. package/dist/backend/services/product-availability.service.js.map +1 -0
  295. package/dist/backend/services/product-availability.sql.d.ts +71 -0
  296. package/dist/backend/services/product-availability.sql.d.ts.map +1 -0
  297. package/dist/backend/services/product-availability.sql.js +77 -0
  298. package/dist/backend/services/product-availability.sql.js.map +1 -0
  299. package/dist/backend/services/product-link.service.d.ts +10 -9
  300. package/dist/backend/services/product-link.service.d.ts.map +1 -1
  301. package/dist/backend/services/product-link.service.js +48 -23
  302. package/dist/backend/services/product-link.service.js.map +1 -1
  303. package/dist/backend/services/product-overrides.service.d.ts +9 -2
  304. package/dist/backend/services/product-overrides.service.d.ts.map +1 -1
  305. package/dist/backend/services/product-overrides.service.js +13 -6
  306. package/dist/backend/services/product-overrides.service.js.map +1 -1
  307. package/dist/backend/services/product-page-revalidation.d.ts +51 -0
  308. package/dist/backend/services/product-page-revalidation.d.ts.map +1 -0
  309. package/dist/backend/services/product-page-revalidation.js +146 -0
  310. package/dist/backend/services/product-page-revalidation.js.map +1 -0
  311. package/dist/backend/services/product-scope-context.service.d.ts.map +1 -1
  312. package/dist/backend/services/product-scope-context.service.js +3 -2
  313. package/dist/backend/services/product-scope-context.service.js.map +1 -1
  314. package/dist/backend/services/product-scopes.service.d.ts +212 -0
  315. package/dist/backend/services/product-scopes.service.d.ts.map +1 -0
  316. package/dist/backend/services/product-scopes.service.js +638 -0
  317. package/dist/backend/services/product-scopes.service.js.map +1 -0
  318. package/dist/backend/services/product-summary-text.d.ts +8 -0
  319. package/dist/backend/services/product-summary-text.d.ts.map +1 -0
  320. package/dist/backend/services/product-summary-text.js +8 -0
  321. package/dist/backend/services/product-summary-text.js.map +1 -0
  322. package/dist/backend/services/product-value-resolver.service.d.ts +11 -1
  323. package/dist/backend/services/product-value-resolver.service.d.ts.map +1 -1
  324. package/dist/backend/services/product-value-resolver.service.js +29 -9
  325. package/dist/backend/services/product-value-resolver.service.js.map +1 -1
  326. package/dist/backend/services/publication-window-sweep.d.ts +77 -0
  327. package/dist/backend/services/publication-window-sweep.d.ts.map +1 -0
  328. package/dist/backend/services/publication-window-sweep.js +117 -0
  329. package/dist/backend/services/publication-window-sweep.js.map +1 -0
  330. package/dist/backend/services/scope-completeness.d.ts +107 -0
  331. package/dist/backend/services/scope-completeness.d.ts.map +1 -0
  332. package/dist/backend/services/scope-completeness.js +180 -0
  333. package/dist/backend/services/scope-completeness.js.map +1 -0
  334. package/dist/backend/services/scope-overview.service.d.ts +112 -0
  335. package/dist/backend/services/scope-overview.service.d.ts.map +1 -0
  336. package/dist/backend/services/scope-overview.service.js +372 -0
  337. package/dist/backend/services/scope-overview.service.js.map +1 -0
  338. package/dist/backend/services/sql-id-arrays.d.ts +16 -0
  339. package/dist/backend/services/sql-id-arrays.d.ts.map +1 -0
  340. package/dist/backend/services/sql-id-arrays.js +24 -0
  341. package/dist/backend/services/sql-id-arrays.js.map +1 -0
  342. package/dist/backend/services/storefront-value-overrides.d.ts +31 -0
  343. package/dist/backend/services/storefront-value-overrides.d.ts.map +1 -0
  344. package/dist/backend/services/storefront-value-overrides.js +48 -0
  345. package/dist/backend/services/storefront-value-overrides.js.map +1 -0
  346. package/dist/backend/services/url-key-resolution.service.d.ts +76 -0
  347. package/dist/backend/services/url-key-resolution.service.d.ts.map +1 -0
  348. package/dist/backend/services/url-key-resolution.service.js +179 -0
  349. package/dist/backend/services/url-key-resolution.service.js.map +1 -0
  350. package/dist/backend/services/url-key.service.d.ts +171 -0
  351. package/dist/backend/services/url-key.service.d.ts.map +1 -0
  352. package/dist/backend/services/url-key.service.js +738 -0
  353. package/dist/backend/services/url-key.service.js.map +1 -0
  354. package/dist/manifest.d.ts +3 -1
  355. package/dist/manifest.d.ts.map +1 -1
  356. package/dist/manifest.js +188 -13
  357. package/dist/manifest.js.map +1 -1
  358. package/dist/migrations/20261016T082008_catalog_order_rules.d.ts +22 -0
  359. package/dist/migrations/20261016T082008_catalog_order_rules.d.ts.map +1 -0
  360. package/dist/migrations/20261016T082008_catalog_order_rules.js +48 -0
  361. package/dist/migrations/20261016T082008_catalog_order_rules.js.map +1 -0
  362. package/dist/migrations/20261022T035133_catalog_product_scopes.d.ts +28 -0
  363. package/dist/migrations/20261022T035133_catalog_product_scopes.d.ts.map +1 -0
  364. package/dist/migrations/20261022T035133_catalog_product_scopes.js +92 -0
  365. package/dist/migrations/20261022T035133_catalog_product_scopes.js.map +1 -0
  366. package/dist/migrations/20261022T054223_catalog_product_url_keys.d.ts +32 -0
  367. package/dist/migrations/20261022T054223_catalog_product_url_keys.d.ts.map +1 -0
  368. package/dist/migrations/20261022T054223_catalog_product_url_keys.js +81 -0
  369. package/dist/migrations/20261022T054223_catalog_product_url_keys.js.map +1 -0
  370. package/dist/migrations/20261022T111811_catalog_price_fields_removed.d.ts +26 -0
  371. package/dist/migrations/20261022T111811_catalog_price_fields_removed.d.ts.map +1 -0
  372. package/dist/migrations/20261022T111811_catalog_price_fields_removed.js +32 -0
  373. package/dist/migrations/20261022T111811_catalog_price_fields_removed.js.map +1 -0
  374. package/dist/migrations/20261022T182523_catalog_admin_name_keys.d.ts +38 -0
  375. package/dist/migrations/20261022T182523_catalog_admin_name_keys.d.ts.map +1 -0
  376. package/dist/migrations/20261022T182523_catalog_admin_name_keys.js +89 -0
  377. package/dist/migrations/20261022T182523_catalog_admin_name_keys.js.map +1 -0
  378. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.d.ts +34 -0
  379. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.d.ts.map +1 -0
  380. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.js +57 -0
  381. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.js.map +1 -0
  382. package/dist/migrations/20261026T033453_catalog_product_media_scopes.d.ts +26 -0
  383. package/dist/migrations/20261026T033453_catalog_product_media_scopes.d.ts.map +1 -0
  384. package/dist/migrations/20261026T033453_catalog_product_media_scopes.js +54 -0
  385. package/dist/migrations/20261026T033453_catalog_product_media_scopes.js.map +1 -0
  386. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.d.ts +27 -0
  387. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.d.ts.map +1 -0
  388. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.js +45 -0
  389. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.js.map +1 -0
  390. package/dist/migrations/index.d.ts +9 -1
  391. package/dist/migrations/index.d.ts.map +1 -1
  392. package/dist/migrations/index.js +17 -1
  393. package/dist/migrations/index.js.map +1 -1
  394. package/docs/catalog/attachments.md +46 -4
  395. package/docs/catalog/attributes.md +11 -6
  396. package/docs/catalog/gallery-and-labels.md +63 -4
  397. package/docs/catalog/packaging-units.md +82 -8
  398. package/docs/catalog/per-channel-per-language-overrides.md +195 -10
  399. package/docs/catalog/url-keys-and-redirects.md +142 -0
  400. package/docs/catalog.md +326 -17
  401. package/i18n/en.json +931 -53
  402. package/i18n/pl.json +930 -52
  403. package/package.json +10 -10
package/docs/catalog.md CHANGED
@@ -24,16 +24,18 @@ otherwise; every price names its currency either way. A malformed code is refuse
24
24
  | Verb + Path | Audience | Purpose |
25
25
  | --- | --- | --- |
26
26
  | `GET /api/v1/catalog/products` | storefront / API key | List/search/filter products in the active Sales Channel |
27
- | `GET /api/v1/catalog/products/:idOrSlug` | storefront | Product detail (price omitted on non-public Sales Channels) |
27
+ | `GET /api/v1/catalog/products/:idOrSlug` | storefront | Product detail (no amount where the viewer's price display mode is *None*) |
28
28
  | `GET /api/v1/catalog/categories` | storefront | Nested category tree |
29
29
  | `GET /api/v1/catalog/categories/:id/content` | storefront | One category's page content, resolved to the caller's language |
30
30
  | `GET /api/v1/catalog/filters` | storefront | Filterable attributes for the active Sales Channel |
31
31
  | `GET /api/v1/catalog/sitemap.xml` | crawlers | SEO sitemap |
32
- | `GET /api/v1/admin/catalog/products?includeArchived` | admin | Admin product list (includes drafts; archived rows opt-in) |
32
+ | `GET /api/v1/admin/catalog/products?status&archived` | admin | Admin product list. `status` is `active` or `inactive` (any other value: `400 VALIDATION_FAILED`); `archived` is `exclude` (default), `include` or `only` — the legacy `includeArchived=1` means `include`. `counts` is `{ all, active, inactive, archived }` — see *Product status and archiving* |
33
33
  | `GET /api/v1/admin/catalog/products/:id` | admin | Product detail |
34
34
  | `POST /api/v1/admin/catalog/products` | admin | Create product (`type` immutable post-create; `sku` is editable) |
35
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 |
36
- | `DELETE /api/v1/admin/catalog/products/:id` | admin | Archive (soft) |
36
+ | `DELETE /api/v1/admin/catalog/products/:id` | admin | Delete (soft) — not the Archive action |
37
+ | `POST /api/v1/admin/catalog/products/:id/archive` | admin (`catalog:write`) | Archive one product — see *Product status and archiving* |
38
+ | `POST /api/v1/admin/catalog/products/:id/restore` | admin (`catalog:write`) | Restore one archived product |
37
39
  | `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 |
38
40
  | `GET /api/v1/admin/catalog/attributes` | admin | List attributes |
39
41
  | `GET /api/v1/admin/catalog/attributes/by-flag?flag=isPromoRule\|isComparable\|...` | admin | Picker payload — every attribute carrying the requested flag |
@@ -52,7 +54,162 @@ otherwise; every price names its currency either way. A malformed code is refuse
52
54
  | `DELETE /api/v1/admin/catalog/categories/:id` | admin | Soft-delete; rejects with 409 if any active child still references the row |
53
55
  | `GET /api/v1/admin/catalog/categories/:id/content` | admin | The category's page content — one Page Builder document per language ([Category page content](./catalog/category-content.md)) |
54
56
  | `PUT /api/v1/admin/catalog/categories/:id/content` | admin | Replace the category's page content; `null` clears it |
55
- | `PUT /api/v1/catalog/products/by-sku/:sku` | API key | Idempotent upsert (PIM sync) |
57
+ | `PUT /api/v1/catalog/products/by-sku/:sku` | API key | Idempotent upsert (PIM sync); an update is audited as `product.update` naming the key (`apiKeyId`) and is never checked for completeness |
58
+
59
+ ## Product status and archiving
60
+
61
+ A product's **status** is `active` or `inactive`, globally and as an override per
62
+ Sales Channel and per channel × language. `inactive` at any scope is plain **off**
63
+ there: the product is not listed, not searchable, not orderable and its page answers as
64
+ a product that does not exist. Switching a product off never archives it. New and
65
+ duplicated products start `inactive`. Any other status value is refused with
66
+ `400 VALIDATION_FAILED` — on the admin API, the API-key upsert
67
+ `PUT /api/v1/catalog/products/by-sku/:sku` and an import; archiving is not a status.
68
+
69
+ **Archiving** is a separate, product-wide action, offered as **Archive** and
70
+ **Restore** (`POST …/products/:id/archive`, `…/restore`) and gated by `catalog:write`.
71
+ Archive sets the product's archived time and takes it out of every channel; Restore
72
+ clears it. Neither changes the status at any scope, and each writes one audit entry
73
+ with the archived time before and after. Archiving an archived product, or restoring
74
+ one that is not archived, answers `200` and changes nothing — no audit entry, no event.
75
+
76
+ - **Bulk.** `POST /api/v1/admin/catalog/products/bulk-update` with
77
+ `fields: { archived: true }` archives every selected product, `false` restores them,
78
+ each through the same action and audit entry. `archived` must be the only field of
79
+ its request. Large selections run as a background bulk operation, and the
80
+ operation's undo puts every product back as it was. A background operation audits
81
+ each product with the admin who requested it, as a direct one does. Archive and
82
+ Restore lock the product, so two concurrent Archives of one product archive it once.
83
+ - **Setting `active` never restores.** An archived product stays archived whatever its
84
+ status; only Restore brings it back. Restoring an `inactive` product leaves it off.
85
+ - **Products archived before this change.** Until this release a product was archived by
86
+ setting it `inactive`. Every product `inactive` at the upgrade therefore stays
87
+ archived (keeping its archived time, or its last-update time when it had none), and
88
+ **needs an explicit Restore** to come back — setting it `active` alone leaves it
89
+ archived.
90
+ - **The product page.** An archived product's page answers `410 PRODUCT_ARCHIVED`
91
+ ("gone"), but only to a buyer who could otherwise see it there: the check takes the
92
+ archive away and reads the global status as `active`, while every channel and channel
93
+ × language status, the membership, the channel's languages, the publication window and
94
+ the audience still apply. Everywhere else, and for any product that is off without
95
+ being archived, the page answers `404` exactly as for a product that does not exist.
96
+ - **The admin list.** Archived products are hidden by default, whatever their status;
97
+ `archived=only` lists them and `archived=include` lists them beside the rest. The
98
+ `inactive` count and filter cover products that are off but not archived.
99
+ On the product list the **Archived** tab has its own address,
100
+ `/catalog/products/archived`, so the browser's Back button and a reload return to it, and
101
+ the command palette (⌘K / CTRL+K) opens it as **Archived products** — search for
102
+ "archived" or "archiwum".
103
+ With a selection, its bar offers Restore, Bulk edit and Delete; **Edit price** is shown
104
+ on the other tabs but disabled, because prices are set in price books.
105
+ - **From the admin assistant.** The assistant's `catalog.archive_product` and
106
+ `catalog.restore_product` tools (`catalog:write`) archive and restore products after
107
+ you confirm the plan it shows, through the same action and audit entry, with you as
108
+ the actor; larger selections run as the bulk operation above. Its status tool,
109
+ `catalog.set_product_status`, only switches products on or off and never archives or
110
+ restores, and its product search lists archived products and says which they are.
111
+
112
+ ### Status per channel and language, in bulk
113
+
114
+ `POST /api/v1/admin/catalog/products/bulk-update` with
115
+ `fields: { scopedStatus: { channelId, languageCode, value } }` sets the status of every
116
+ selected product at one scope — the Sales Channel (`languageCode: null`) or one
117
+ channel × language — to `active` or `inactive`, or removes the override there with
118
+ `inherit`. Only that scope changes on each product; every other scope and the global
119
+ status stay as they were. A product that is not in the channel, or a language the
120
+ channel does not offer, is skipped and reported as `scope_invalid` — the product is
121
+ never added to the channel. `scopedStatus` cannot be combined with `status` in one
122
+ request. Each product's change is one audit entry naming the scope; large selections
123
+ run as a background bulk operation whose undo puts every scope back as it was and
124
+ reports any product changed since.
125
+
126
+ ### Completeness check when switching a product on
127
+
128
+ When an operator's **status change** switches a product on for a sales channel and
129
+ language — the global status, a channel or channel × language status, single or in
130
+ bulk — the product must have, in that language: a **name** (its own name in that
131
+ language, or a name overridden for that channel; a name in another language does not
132
+ count), a **URL key** (the global key counts) and every **required** language-dependent
133
+ attribute of its attribute set. The setting **Completeness check when switching a
134
+ product on** (`catalog.scope_completeness_gate`, one value for the whole platform)
135
+ decides what happens when something is missing:
136
+
137
+ - **`warn`** (the default) — the change is saved and the answer lists what is missing
138
+ per channel and language (`warnings`, kind `completeness`).
139
+ - **`refuse`** — the change is not saved: `422 SCOPE_INCOMPLETE` names every channel and
140
+ language with what it lacks. A change that would switch the product on in several
141
+ places is refused as a whole if any of them fails. In a bulk edit the products that
142
+ pass are changed and the others are skipped as `completeness_gate`.
143
+
144
+ Only a status change is checked. A product that goes live because it joins a channel,
145
+ a channel gains a language, its publication window opens, its audience changes, or it
146
+ is restored is not checked; the **scope overview** of the product editor shows what is
147
+ missing at every channel and language instead. Setting an archived product `active` is
148
+ checked like any status change, although the product stays archived. Imports, PIM
149
+ synchronisation and the API-key upsert are never checked.
150
+
151
+ ## Prices
152
+
153
+ **A product carries no price of its own.** Every price is a row of a price book of the
154
+ `price_lists` module: the product's base price per currency, its variants' prices, and any
155
+ catalogue, buyer or sale price. Set a product's base price on the product editor's **Pricing** tab
156
+ — the *Base prices* panel there, and the list of the price books that price the product, are
157
+ contributed by `price_lists` — or in the base book's grid. Variant prices are set in the same
158
+ places, never on the variant itself. The `price_lists` module's page explains how the price a
159
+ buyer pays is chosen.
160
+
161
+ - **Listing cards, the product page and related products** show the viewer's own price — their
162
+ organization's and customer group's prices on the request's sales channel and currency. A product
163
+ whose variants cost different amounts shows its lowest price as a *from* price
164
+ (`ProductSummary.price` carries `variesByVariant` and `maxAmount`); a charged sale carries the
165
+ buyer's regular price as the compare-at price; with `pricing.show_list_price` on, a lower buyer
166
+ price carries the catalogue price as `listPrice`. A product nothing prices has no price and
167
+ follows the quote-request path.
168
+ - **Sorting and filtering by price** — `?sort=price`, `?sort=-price`, `minPrice`, `maxPrice` on
169
+ `GET /api/v1/catalog/products` — order and select by the same quantity-1 price the cards show to
170
+ that viewer, the *from* price for a variant product. Priced products always come before unpriced
171
+ ones. A price ordering is always answered from PostgreSQL, never from the search index. Paging
172
+ through a price ordering with the cursor meets every product once, provided its price does not
173
+ change meanwhile; a product repriced during the walk may be met twice or not at all, as with any
174
+ cursor over a live price. A page may be short, or even empty, and still have more after it
175
+ (`hasMore: true`) when most of the rows it read are hidden from the viewer; follow its cursor.
176
+ The cursor of a price ordering or a price range is sealed: it cannot be read or altered, because
177
+ the position it continues from can be a product the viewer may not see. A cursor that does not
178
+ open — altered, issued by a release before the seal, or before the instance's session key was
179
+ changed — starts the listing again at its first page.
180
+ - **Reading named products** — `?ids=<id>,<id>,…` on `GET /api/v1/catalog/products` restricts the
181
+ listing to those products: at most 24 distinct ids, each a uuid, or `400 VALIDATION_FAILED`. The
182
+ answer is the subset the viewer may see, priced exactly as any listing card for that viewer, in
183
+ the listing's own order — a caller that cares about its order re-orders by id. It combines with the
184
+ other filters and is always answered from PostgreSQL. A blog post's related products are read this
185
+ way.
186
+ - **Where the viewer's price display mode is *None*** — for instance an anonymous visitor on a
187
+ channel that hides prices until sign-in — the listing and the product detail carry no amount, and
188
+ a price ordering or range is refused for that page. Sales channels have no price-visibility flag
189
+ of their own any more: the display mode decides, for each viewer.
190
+
191
+ For developers: the listing paths price a whole page in one batched call —
192
+ `resolveListingPrices`, or `resolveListingPriceDetails` where the page renders the split
193
+ (`ProductSummary.resolvedPrice`: `basePrice`, `salePrice`, `listPrice`, `displayMode`) — through the
194
+ `pricingService` port slices of `@endora-commerce/contracts`, passing the viewer's organization and
195
+ customer account rather than a resolved group. A price ordering reads `ListingPriceOrderPort`
196
+ (`orderByUnitPrice`, `pricedProductIds`) over `price_lists`' precomputed price surface and composes
197
+ the unpriced tail itself (`catalog-query.service.ts`). The external catalogue API prices through
198
+ `resolveLinePrices` and builds a bound organization's tier ladder from `listTierStarts`. Product,
199
+ category and attribute writes publish the events `price_lists` subscribes to, which clear the
200
+ pricing caches and mark on the price surface the products each event concerns, for the surface
201
+ worker to refresh.
202
+
203
+ ### Removed price fields (migration note)
204
+
205
+ The release that introduced price books removed the product's *Default unit price* (the
206
+ `defaultPrice` and `price` keys of `attributeValues`, and the editor field) and the variant price
207
+ override (`product_variants.price_override`, and the variant editor's price field), without
208
+ converting either. Product and variant create and update, and the products import, refuse those
209
+ fields with `400 PRICE_SET_IN_PRICE_BOOKS` (`PRICE_FIELDS_REFUSED_ON_PRODUCTS`,
210
+ `PRICE_FIELDS_REFUSED_ON_VARIANTS` in `@endora-commerce/contracts`), saying that prices are set in
211
+ price books. The catalogue's migration `20261022T111811_catalog_price_fields_removed.ts` dropped the
212
+ column and stripped the keys.
56
213
 
57
214
  ## Entities
58
215
 
@@ -190,15 +347,18 @@ modules are present. The payload is sent whole; the strict schemas are
190
347
  | --- | --- | --- |
191
348
  | `product.created.v1` | A product is created — in the Admin UI, through the API-key upsert, by an import or a PIM synchronisation, or by duplicating another product. | `productId` (UUID), `sku` — the SKU it was created with; it can change later, `productId` cannot. |
192
349
  | `product.updated.v1` | A product is written, or one of its variants is created, changed or deleted. | `productId`, `changedFields` — the names of the product fields the write addressed (`name`, `status`, `categoryIds`, …; `variants` for a variant write). Names only, an open list, and it may be empty. |
193
- | `product.archived.v1` | A product's status moves to `inactive` from another status. Once per transition: editing a product that is already inactive does not send it again. | `productId` |
194
-
195
- - **Order.** The archiving write sends `product.updated.v1` (with `status` in
196
- `changedFields`) and then `product.archived.v1`, on every path that can
197
- archive a product: the Admin UI, the API-key upsert, a bulk edit, an import.
198
- - **Reactivation has no event of its own.** A product that leaves `inactive`
199
- sends `product.updated.v1` with `status` in `changedFields` and nothing else —
200
- the same signal as any other status change, a draft being published
201
- included. To tell them apart, read the product: its `status` is the answer.
350
+ | `product.archived.v1` | A product is archived by the Archive action — for one product or in bulk. Once per transition: archiving an archived product sends nothing. A status change never sends it: `inactive` is plain off. | `productId` |
351
+
352
+ - **Order.** Archive sends `product.updated.v1` (with `archivedAt` in
353
+ `changedFields`) and then `product.archived.v1`, for one product and for each
354
+ product of a bulk Archive.
355
+ - **Restore has no event of its own.** Restore sends `product.updated.v1` with
356
+ `archivedAt` in `changedFields` and nothing else. Switching a product on or
357
+ off sends `product.updated.v1` with `status`. To tell them apart, read the
358
+ product: its `status` and `archivedAt` are the answer.
359
+ - **Undo.** Undoing a bulk edit sends `product.updated.v1` for every product it
360
+ put back, naming the fields it restored, and `product.archived.v1` where it
361
+ archives a product again.
202
362
  - **Deletion is not delivered.** Deleting a product emits `product.deleted.v1`
203
363
  on the in-process event bus only; it is not offered to webhooks, and no
204
364
  `product.archived.v1` is sent for it. A receiver that mirrors the catalogue
@@ -219,13 +379,121 @@ modules are present. The payload is sent whole; the strict schemas are
219
379
 
220
380
  ## Extension points
221
381
 
222
- - **Per-Sales-Channel pricing** — query service receives a SalesChannel
223
- context; new gating (e.g. customer-segment-specific catalogs) is added by
224
- composing into `catalog-query.service.ts`.
382
+ - **Per-Sales-Channel listing** — the query service receives a SalesChannel
383
+ context, and every price it renders is resolved for that channel; new gating
384
+ (e.g. customer-segment-specific catalogs) is added by composing into
385
+ `catalog-query.service.ts`.
386
+ - **Product editor zones** — the editor mounts admin zones other modules contribute to;
387
+ `product.editor.seo.after`, at the end of the SEO tab (props: `productId`), is where the
388
+ SEO module puts its link to the meta-tag editor, so the catalog never names that module.
225
389
  - **Slug uniqueness** — the slug is unique across all Sales Channels by
226
390
  default; override the slugifier in `catalog-admin.service.ts` if locale
227
391
  collisions become a concern.
228
392
 
393
+ ## Order rules: minimum order quantity and returnable
394
+
395
+ Two rules on a product decide how it may be ordered and whether it may be sent
396
+ back. Both are edited in the **Order rules** card on the product editor's
397
+ **Inventory** tab.
398
+
399
+ > **Upgrading: every existing product starts as not returnable.** A product on
400
+ > which nobody has set **Returnable** reads as not returnable, and that includes
401
+ > every product that existed before the setting was introduced. Lines of orders
402
+ > placed after the upgrade are therefore not returnable until you mark their
403
+ > products. To mark many at once, select them on the product list and use
404
+ > **Bulk edit → Returnable → Yes — returnable**. Orders placed before the
405
+ > upgrade are unaffected: their lines stay returnable under the usual rules.
406
+
407
+ ### Minimum order quantity
408
+
409
+ - **Minimum order quantity (pcs)** — the fewest pieces of the product a buyer
410
+ may order in one order. Optional; a whole number from **1 to 1 000 000**, or
411
+ empty for no minimum. It applies to `simple` and `configurable` products
412
+ only: on a `grouped`, `bundle` or `virtual` product the card says so, and
413
+ the API refuses the field with `422 VALIDATION_FAILED` naming
414
+ `minOrderQuantity`, on create and on update. A value outside the range is
415
+ refused with `400 VALIDATION_FAILED`.
416
+ - **A minimum per packaging unit** — each packaging unit may carry its own
417
+ minimum number of units; see [Packaging Units](./catalog/packaging-units.md).
418
+
419
+ The minimum is judged on the **product total**: every line of the product in
420
+ the basket counts — single-piece and packaging-unit lines, every variant. A
421
+ packaging-unit minimum counts the units of that unit ordered for the product,
422
+ over every variant. The two checks are independent; a basket must satisfy
423
+ every minimum that is set. Variants inherit the product's minimum.
424
+
425
+ Every way into a basket, a quote request or an order applies it — the cart,
426
+ checkout, quick order, one-click buy, shopping lists, quote requests, the
427
+ admin's Create order screen and the external order API. Each of those modules'
428
+ pages says what its path does with a line below the minimum. A refusal answers
429
+ `422 PRODUCT_BELOW_MINIMUM_QUANTITY` (pieces) or
430
+ `422 PACKAGING_UNIT_BELOW_MINIMUM_QUANTITY` (a packaging unit), with a message
431
+ in the buyer's language naming the product and the minimum. Removing a line is
432
+ always allowed.
433
+
434
+ A product a buyer may not see, or that the request's sales channel does not
435
+ publish, is reported as an unknown product on every path — its name and its
436
+ minimum are never disclosed.
437
+
438
+ The storefront product detail, the product list, search results and the
439
+ comparison carry `minOrderQuantity` (`null` when there is none, or when the
440
+ product's type takes no minimum); the product detail's `packagingUnits[]`
441
+ carries each unit's `minOrderUnits`. The storefront starts the quantity at the
442
+ minimum and does not offer less.
443
+
444
+ ### Returnable
445
+
446
+ **Returnable** (yes / no, on every product type) says whether buyers may
447
+ include the product in a **return**. It does not restrict **complaints**. The
448
+ default is no.
449
+
450
+ The value is **recorded on each order line when the order is placed**
451
+ (`order_items.returnable_at_purchase`); changing the flag later changes no
452
+ order already placed. A line whose product could not be read at placement is
453
+ recorded as not returnable. What the Returns module does with the recorded
454
+ value is on its own page.
455
+
456
+ ### Per sales channel
457
+
458
+ Both rules can be overridden for one sales channel — **Order rules** per channel in the
459
+ product's scopes (`PATCH /api/v1/admin/catalog/products/:id/scopes`, `minOrderQuantity` and
460
+ `returnable` on a channel entry; `null` uses the global value again). The channel's value
461
+ applies wherever a basket, an order or a quote request belongs to that channel: adding to
462
+ the basket, the basket view, submitting for approval, the checkout preview, placement, the
463
+ admin order preview, quote requests and the buyer's quick-order import. A channel minimum
464
+ of 1 means no minimum in that channel, whatever the global value. Placement records the
465
+ order channel's returnable flag on each line, so returns follow the channel the order was
466
+ placed in. The storefront product detail and listing report the minimum of the request's
467
+ channel.
468
+
469
+ ### Audit and copies
470
+
471
+ Setting or clearing either rule is audited like any product edit, with the old
472
+ and the new value. **Bulk edit → Returnable** writes one audit entry per
473
+ product it changes, for up to 200 products in one synchronous request and
474
+ through the queued bulk edit beyond. Changing a rule never alters an existing
475
+ cart, order, quote request or return. **Duplicate** does not copy either rule:
476
+ the copy starts with no minimum and as not returnable.
477
+
478
+ ### API
479
+
480
+ | Field | Where | Values |
481
+ | --- | --- | --- |
482
+ | `minOrderQuantity` | `POST` / `PATCH /api/v1/admin/catalog/products[/:id]`, the admin product response | integer `1…1000000`, or `null` to clear |
483
+ | `returnable` | the same, and `POST /api/v1/admin/catalog/products/bulk-update` | boolean |
484
+ | `minOrderUnits` | `POST` / `PATCH …/packaging-units[/:unitId]`, the packaging-unit response | integer `1…1000000`, or `null` to clear |
485
+
486
+ The catalogue read port (`CatalogProductReadPort`) reports `minOrderQuantity`
487
+ and `returnable` on each product record and `minOrderUnits` on each packaging
488
+ unit, and gains `listPackagingUnitsByProductIds` for batch reads. Like every
489
+ method of the port it applies no visibility policy: a caller passes only
490
+ product ids it has already vetted.
491
+
492
+ Migration `20261016T082008_catalog_order_rules.ts` adds
493
+ `products.min_order_quantity` (nullable, `CHECK` 1–1 000 000),
494
+ `products.returnable` (not null, default `false`) and
495
+ `product_packaging_units.min_order_units` (nullable, `CHECK` 1–1 000 000).
496
+
229
497
  ## Product structure and composition surfaces
230
498
 
231
499
  The catalog grew several capability surfaces, each with its own page:
@@ -247,6 +515,47 @@ Five product types are now supported: `simple`, `configurable`,
247
515
  `grouped`, `bundle`, `virtual`. `simple` and `configurable` are the
248
516
  original pair; the other three were added later.
249
517
 
518
+ ## Page Builder blocks
519
+
520
+ The catalog declares the Page Builder's product and category blocks. Their
521
+ data is read on the server, so the products are in the page's HTML.
522
+
523
+ **Product grid and product slider** (`catalog.ProductGrid`,
524
+ `catalog.ProductSlider`) keep every option they had — the product source
525
+ (picked products, a category, a search), the limit, columns, gap and view —
526
+ and add:
527
+
528
+ | Option | Meaning |
529
+ | --- | --- |
530
+ | Header | An optional heading, lead text and button (for example "See all") above the products. |
531
+ | Card style | Default, compact, horizontal, or **showcase**: the product image on a neutral backdrop, its name, a short summary and a "more" link — no price or SKU. |
532
+ | Text under the product name | The one line under each card's name: the card style's default (the SKU on the default, compact and horizontal cards, the short description on showcase), the **Short description** (the first words of the product's description, at most 160 characters), the SKU, or none. The page editor's preview shows the same line as the storefront. |
533
+ | Card title weight | The weight of each card's product name: **Default** (the card style's own) or 300–800. |
534
+ | Card image background | The colour of the box behind each card's image: a brand colour or a hex value. Empty keeps the card style's own light grey. |
535
+ | Divider under each card | **None** (as before) or **Line**: a 1 px line under each card, in the **Divider color** you pick or the neutral border colour. A bordered card's bottom edge becomes the line; a showcase card gets it 16 px below its text. |
536
+ | Card link label | The text of the showcase card's link; "More" when empty. |
537
+ | Gap (grid) | A spacing step or **Custom gap (px)**, per breakpoint. A grid saved with a gap in pixels opens on Custom with that number and looks as before. The category grid's gap works the same way. |
538
+ | Equal items height (grid) | Per breakpoint, next to the columns and the view, on the **Responsive** tab; a value saved before applies at every width. The category grid's works the same way. |
539
+ | Button below the products | An optional button under the grid or slider. |
540
+
541
+ The slider takes the Page Builder carousel's options: slides per view per
542
+ breakpoint, gap, slide or fade effect, arrow and dot placement, bleed to the
543
+ viewport edge and optional autoplay. A grid or slider saved before these
544
+ options existed renders as it did. To give any of these blocks an anchor, a
545
+ colour scheme, a background, spacing or a width, place it inside a **Section**
546
+ block (`cms.Section`). The header texts, the card
547
+ link label and the footer button label are translatable with the Page
548
+ Builder's **Translate** action.
549
+
550
+ **The product summary.** The storefront product list and product detail
551
+ (`GET /api/v1/catalog/products`, `GET /api/v1/catalog/products/:idOrSlug`)
552
+ return `summary`: the product description in the request language as plain
553
+ text, cut at a word boundary to at most 160 characters with `…`, or `null`
554
+ when the product has no description. It is derived from the description the
555
+ read already loads, so it costs no extra query per product (the module's
556
+ `src/backend/services/product-summary-text.ts`).
557
+ The showcase card shows it.
558
+
250
559
  ## Attribute extensions on the Catalog read paths
251
560
 
252
561
  The Attributes work added the operational surface the storefront
@@ -382,4 +691,4 @@ The admin's global search (the command palette, ⌘K / Ctrl+K) finds products an
382
691
  | Category: Name | yes |
383
692
  | Category: URL key (slug) | yes |
384
693
 
385
- 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`.
694
+ Names match in every language and are shown in the admin's language. Inactive and archived 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`.