@endora-commerce/mod-catalog 0.109.0 → 0.110.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 (519) hide show
  1. package/dist/admin/components/CopyToChannelsDialog.d.ts +37 -0
  2. package/dist/admin/components/CopyToChannelsDialog.d.ts.map +1 -0
  3. package/dist/admin/components/CopyToChannelsDialog.js +83 -0
  4. package/dist/admin/components/CopyToChannelsDialog.js.map +1 -0
  5. package/dist/admin/components/PackagingUnitsEditor.d.ts +13 -4
  6. package/dist/admin/components/PackagingUnitsEditor.d.ts.map +1 -1
  7. package/dist/admin/components/PackagingUnitsEditor.js +20 -85
  8. package/dist/admin/components/PackagingUnitsEditor.js.map +1 -1
  9. package/dist/admin/components/ProductAttachmentsSection.d.ts +1 -3
  10. package/dist/admin/components/ProductAttachmentsSection.d.ts.map +1 -1
  11. package/dist/admin/components/ProductAttachmentsSection.js +59 -98
  12. package/dist/admin/components/ProductAttachmentsSection.js.map +1 -1
  13. package/dist/admin/components/ProductAttributesTab.d.ts +1 -11
  14. package/dist/admin/components/ProductAttributesTab.d.ts.map +1 -1
  15. package/dist/admin/components/ProductAttributesTab.js +128 -119
  16. package/dist/admin/components/ProductAttributesTab.js.map +1 -1
  17. package/dist/admin/components/ProductContentCard.d.ts +41 -0
  18. package/dist/admin/components/ProductContentCard.d.ts.map +1 -0
  19. package/dist/admin/components/ProductContentCard.js +28 -0
  20. package/dist/admin/components/ProductContentCard.js.map +1 -0
  21. package/dist/admin/components/ProductGallerySection.d.ts +2 -13
  22. package/dist/admin/components/ProductGallerySection.d.ts.map +1 -1
  23. package/dist/admin/components/ProductGallerySection.js +98 -354
  24. package/dist/admin/components/ProductGallerySection.js.map +1 -1
  25. package/dist/admin/components/ProductOrderRulesCard.d.ts +11 -15
  26. package/dist/admin/components/ProductOrderRulesCard.d.ts.map +1 -1
  27. package/dist/admin/components/ProductOrderRulesCard.js +15 -268
  28. package/dist/admin/components/ProductOrderRulesCard.js.map +1 -1
  29. package/dist/admin/components/ProductScopeBar.d.ts +28 -0
  30. package/dist/admin/components/ProductScopeBar.d.ts.map +1 -0
  31. package/dist/admin/components/ProductScopeBar.js +70 -0
  32. package/dist/admin/components/ProductScopeBar.js.map +1 -0
  33. package/dist/admin/components/ProductScopeOverview.d.ts +13 -1
  34. package/dist/admin/components/ProductScopeOverview.d.ts.map +1 -1
  35. package/dist/admin/components/ProductScopeOverview.js +51 -36
  36. package/dist/admin/components/ProductScopeOverview.js.map +1 -1
  37. package/dist/admin/components/ProductUrlRedirects.d.ts +15 -0
  38. package/dist/admin/components/ProductUrlRedirects.d.ts.map +1 -0
  39. package/dist/admin/components/ProductUrlRedirects.js +70 -0
  40. package/dist/admin/components/ProductUrlRedirects.js.map +1 -0
  41. package/dist/admin/components/editor/DetailsTab.d.ts +30 -0
  42. package/dist/admin/components/editor/DetailsTab.d.ts.map +1 -0
  43. package/dist/admin/components/editor/DetailsTab.js +59 -0
  44. package/dist/admin/components/editor/DetailsTab.js.map +1 -0
  45. package/dist/admin/components/editor/ImmediateBadge.d.ts +21 -0
  46. package/dist/admin/components/editor/ImmediateBadge.d.ts.map +1 -0
  47. package/dist/admin/components/editor/ImmediateBadge.js +21 -0
  48. package/dist/admin/components/editor/ImmediateBadge.js.map +1 -0
  49. package/dist/admin/components/editor/confirm-removal.d.ts +13 -0
  50. package/dist/admin/components/editor/confirm-removal.d.ts.map +1 -0
  51. package/dist/admin/components/editor/confirm-removal.js +33 -0
  52. package/dist/admin/components/editor/confirm-removal.js.map +1 -0
  53. package/dist/admin/components/editor/editor-context.d.ts +53 -0
  54. package/dist/admin/components/editor/editor-context.d.ts.map +1 -0
  55. package/dist/admin/components/editor/editor-context.js +88 -0
  56. package/dist/admin/components/editor/editor-context.js.map +1 -0
  57. package/dist/admin/components/editor/scoped-controls.d.ts +46 -0
  58. package/dist/admin/components/editor/scoped-controls.d.ts.map +1 -0
  59. package/dist/admin/components/editor/scoped-controls.js +64 -0
  60. package/dist/admin/components/editor/scoped-controls.js.map +1 -0
  61. package/dist/admin/index.d.ts +1 -1
  62. package/dist/admin/index.d.ts.map +1 -1
  63. package/dist/admin/index.js +11 -0
  64. package/dist/admin/index.js.map +1 -1
  65. package/dist/admin/lib/attribute-scope.d.ts +17 -14
  66. package/dist/admin/lib/attribute-scope.d.ts.map +1 -1
  67. package/dist/admin/lib/attribute-scope.js +12 -9
  68. package/dist/admin/lib/attribute-scope.js.map +1 -1
  69. package/dist/admin/lib/editor-scope.d.ts +35 -0
  70. package/dist/admin/lib/editor-scope.d.ts.map +1 -0
  71. package/dist/admin/lib/editor-scope.js +114 -0
  72. package/dist/admin/lib/editor-scope.js.map +1 -0
  73. package/dist/admin/lib/order-minimum-input.d.ts +13 -0
  74. package/dist/admin/lib/order-minimum-input.d.ts.map +1 -0
  75. package/dist/admin/lib/order-minimum-input.js +16 -0
  76. package/dist/admin/lib/order-minimum-input.js.map +1 -0
  77. package/dist/admin/lib/product-labels.d.ts +0 -2
  78. package/dist/admin/lib/product-labels.d.ts.map +1 -1
  79. package/dist/admin/lib/product-labels.js +1 -5
  80. package/dist/admin/lib/product-labels.js.map +1 -1
  81. package/dist/admin/lib/product-scopes-api.d.ts +5 -22
  82. package/dist/admin/lib/product-scopes-api.d.ts.map +1 -1
  83. package/dist/admin/lib/product-scopes-api.js +1 -45
  84. package/dist/admin/lib/product-scopes-api.js.map +1 -1
  85. package/dist/admin/lib/product-url-keys-api.d.ts +4 -27
  86. package/dist/admin/lib/product-url-keys-api.d.ts.map +1 -1
  87. package/dist/admin/lib/product-url-keys-api.js +0 -49
  88. package/dist/admin/lib/product-url-keys-api.js.map +1 -1
  89. package/dist/admin/lib/scope-overview.d.ts +13 -14
  90. package/dist/admin/lib/scope-overview.d.ts.map +1 -1
  91. package/dist/admin/lib/scope-overview.js +36 -31
  92. package/dist/admin/lib/scope-overview.js.map +1 -1
  93. package/dist/admin/lib/scoped-editor-store.d.ts +81 -0
  94. package/dist/admin/lib/scoped-editor-store.d.ts.map +1 -0
  95. package/dist/admin/lib/scoped-editor-store.js +198 -0
  96. package/dist/admin/lib/scoped-editor-store.js.map +1 -0
  97. package/dist/admin/lib/scoped-values-api.d.ts +14 -0
  98. package/dist/admin/lib/scoped-values-api.d.ts.map +1 -0
  99. package/dist/admin/lib/scoped-values-api.js +55 -0
  100. package/dist/admin/lib/scoped-values-api.js.map +1 -0
  101. package/dist/admin/pages/AttributesManager.d.ts.map +1 -1
  102. package/dist/admin/pages/AttributesManager.js +119 -38
  103. package/dist/admin/pages/AttributesManager.js.map +1 -1
  104. package/dist/admin/pages/ProductContentPage.d.ts +27 -0
  105. package/dist/admin/pages/ProductContentPage.d.ts.map +1 -0
  106. package/dist/admin/pages/ProductContentPage.js +161 -0
  107. package/dist/admin/pages/ProductContentPage.js.map +1 -0
  108. package/dist/admin/pages/ProductCreateForm.d.ts +3 -0
  109. package/dist/admin/pages/ProductCreateForm.d.ts.map +1 -0
  110. package/dist/admin/pages/ProductCreateForm.js +87 -0
  111. package/dist/admin/pages/ProductCreateForm.js.map +1 -0
  112. package/dist/admin/pages/ProductEditor.d.ts.map +1 -1
  113. package/dist/admin/pages/ProductEditor.js +840 -457
  114. package/dist/admin/pages/ProductEditor.js.map +1 -1
  115. package/dist/admin/pages/ProductsList.d.ts.map +1 -1
  116. package/dist/admin/pages/ProductsList.js +9 -19
  117. package/dist/admin/pages/ProductsList.js.map +1 -1
  118. package/dist/backend/admin-search-provider.d.ts +2 -1
  119. package/dist/backend/admin-search-provider.d.ts.map +1 -1
  120. package/dist/backend/admin-search-provider.js +1 -1
  121. package/dist/backend/admin-search-provider.js.map +1 -1
  122. package/dist/backend/commands/attribute-commands.d.ts +4 -3
  123. package/dist/backend/commands/attribute-commands.d.ts.map +1 -1
  124. package/dist/backend/commands/attribute-commands.js +82 -21
  125. package/dist/backend/commands/attribute-commands.js.map +1 -1
  126. package/dist/backend/commands/product-content-commands.d.ts +31 -0
  127. package/dist/backend/commands/product-content-commands.d.ts.map +1 -0
  128. package/dist/backend/commands/product-content-commands.js +70 -0
  129. package/dist/backend/commands/product-content-commands.js.map +1 -0
  130. package/dist/backend/commands/scoped-values.commands.d.ts +95 -0
  131. package/dist/backend/commands/scoped-values.commands.d.ts.map +1 -0
  132. package/dist/backend/commands/scoped-values.commands.js +235 -0
  133. package/dist/backend/commands/scoped-values.commands.js.map +1 -0
  134. package/dist/backend/demo/reset.d.ts.map +1 -1
  135. package/dist/backend/demo/reset.js +2 -1
  136. package/dist/backend/demo/reset.js.map +1 -1
  137. package/dist/backend/demo/rows.d.ts +18 -0
  138. package/dist/backend/demo/rows.d.ts.map +1 -1
  139. package/dist/backend/demo/rows.js +18 -0
  140. package/dist/backend/demo/rows.js.map +1 -1
  141. package/dist/backend/demo/seed.d.ts +2 -1
  142. package/dist/backend/demo/seed.d.ts.map +1 -1
  143. package/dist/backend/demo/seed.js +20 -6
  144. package/dist/backend/demo/seed.js.map +1 -1
  145. package/dist/backend/entities/gallery-item-scope-override.entity.d.ts +30 -0
  146. package/dist/backend/entities/gallery-item-scope-override.entity.d.ts.map +1 -0
  147. package/dist/backend/entities/gallery-item-scope-override.entity.js +80 -0
  148. package/dist/backend/entities/gallery-item-scope-override.entity.js.map +1 -0
  149. package/dist/backend/entities/gallery-item.entity.d.ts +7 -6
  150. package/dist/backend/entities/gallery-item.entity.d.ts.map +1 -1
  151. package/dist/backend/entities/gallery-item.entity.js +11 -6
  152. package/dist/backend/entities/gallery-item.entity.js.map +1 -1
  153. package/dist/backend/entities/gallery-role-scope-override.entity.d.ts +28 -0
  154. package/dist/backend/entities/gallery-role-scope-override.entity.d.ts.map +1 -0
  155. package/dist/backend/entities/gallery-role-scope-override.entity.js +75 -0
  156. package/dist/backend/entities/gallery-role-scope-override.entity.js.map +1 -0
  157. package/dist/backend/entities/product-attachment-scope-override.entity.d.ts +30 -0
  158. package/dist/backend/entities/product-attachment-scope-override.entity.d.ts.map +1 -0
  159. package/dist/backend/entities/product-attachment-scope-override.entity.js +80 -0
  160. package/dist/backend/entities/product-attachment-scope-override.entity.js.map +1 -0
  161. package/dist/backend/entities/product-attachment.entity.d.ts +4 -6
  162. package/dist/backend/entities/product-attachment.entity.d.ts.map +1 -1
  163. package/dist/backend/entities/product-attachment.entity.js +6 -12
  164. package/dist/backend/entities/product-attachment.entity.js.map +1 -1
  165. package/dist/backend/entities/product-attribute.entity.d.ts +5 -9
  166. package/dist/backend/entities/product-attribute.entity.d.ts.map +1 -1
  167. package/dist/backend/entities/product-attribute.entity.js +5 -13
  168. package/dist/backend/entities/product-attribute.entity.js.map +1 -1
  169. package/dist/backend/entities/product-channel-scope.entity.d.ts +7 -2
  170. package/dist/backend/entities/product-channel-scope.entity.d.ts.map +1 -1
  171. package/dist/backend/entities/product-channel-scope.entity.js +10 -1
  172. package/dist/backend/entities/product-channel-scope.entity.js.map +1 -1
  173. package/dist/backend/entities/product-content-value.entity.d.ts +39 -0
  174. package/dist/backend/entities/product-content-value.entity.d.ts.map +1 -0
  175. package/dist/backend/entities/product-content-value.entity.js +81 -0
  176. package/dist/backend/entities/product-content-value.entity.js.map +1 -0
  177. package/dist/backend/entities/product-packaging-unit-scope-override.entity.d.ts +30 -0
  178. package/dist/backend/entities/product-packaging-unit-scope-override.entity.d.ts.map +1 -0
  179. package/dist/backend/entities/product-packaging-unit-scope-override.entity.js +80 -0
  180. package/dist/backend/entities/product-packaging-unit-scope-override.entity.js.map +1 -0
  181. package/dist/backend/entities/product-packaging-unit.entity.d.ts +1 -7
  182. package/dist/backend/entities/product-packaging-unit.entity.d.ts.map +1 -1
  183. package/dist/backend/entities/product-packaging-unit.entity.js +0 -10
  184. package/dist/backend/entities/product-packaging-unit.entity.js.map +1 -1
  185. package/dist/backend/entities/product-url-key.entity.d.ts +14 -19
  186. package/dist/backend/entities/product-url-key.entity.d.ts.map +1 -1
  187. package/dist/backend/entities/product-url-key.entity.js +17 -22
  188. package/dist/backend/entities/product-url-key.entity.js.map +1 -1
  189. package/dist/backend/entities/product-url-redirect.entity.d.ts +8 -13
  190. package/dist/backend/entities/product-url-redirect.entity.d.ts.map +1 -1
  191. package/dist/backend/entities/product-url-redirect.entity.js +13 -14
  192. package/dist/backend/entities/product-url-redirect.entity.js.map +1 -1
  193. package/dist/backend/entities/product-variant.entity.d.ts +8 -1
  194. package/dist/backend/entities/product-variant.entity.d.ts.map +1 -1
  195. package/dist/backend/entities/product-variant.entity.js +13 -2
  196. package/dist/backend/entities/product-variant.entity.js.map +1 -1
  197. package/dist/backend/entities/product.entity.d.ts +31 -14
  198. package/dist/backend/entities/product.entity.d.ts.map +1 -1
  199. package/dist/backend/entities/product.entity.js +41 -34
  200. package/dist/backend/entities/product.entity.js.map +1 -1
  201. package/dist/backend/index.d.ts +8 -3
  202. package/dist/backend/index.d.ts.map +1 -1
  203. package/dist/backend/index.js +136 -49
  204. package/dist/backend/index.js.map +1 -1
  205. package/dist/backend/plugin.d.ts +36 -6
  206. package/dist/backend/plugin.d.ts.map +1 -1
  207. package/dist/backend/plugin.js +36 -13
  208. package/dist/backend/plugin.js.map +1 -1
  209. package/dist/backend/prompt-tools.d.ts +3 -2
  210. package/dist/backend/prompt-tools.d.ts.map +1 -1
  211. package/dist/backend/prompt-tools.js +18 -7
  212. package/dist/backend/prompt-tools.js.map +1 -1
  213. package/dist/backend/routes.admin.d.ts +15 -16
  214. package/dist/backend/routes.admin.d.ts.map +1 -1
  215. package/dist/backend/routes.admin.js +110 -99
  216. package/dist/backend/routes.admin.js.map +1 -1
  217. package/dist/backend/routes.api-key.d.ts.map +1 -1
  218. package/dist/backend/routes.api-key.js +4 -2
  219. package/dist/backend/routes.api-key.js.map +1 -1
  220. package/dist/backend/routes.public.d.ts +8 -1
  221. package/dist/backend/routes.public.d.ts.map +1 -1
  222. package/dist/backend/routes.public.js +60 -8
  223. package/dist/backend/routes.public.js.map +1 -1
  224. package/dist/backend/services/asset-references.d.ts +12 -1
  225. package/dist/backend/services/asset-references.d.ts.map +1 -1
  226. package/dist/backend/services/asset-references.js +42 -2
  227. package/dist/backend/services/asset-references.js.map +1 -1
  228. package/dist/backend/services/attachment-packaging-scopes.d.ts +38 -20
  229. package/dist/backend/services/attachment-packaging-scopes.d.ts.map +1 -1
  230. package/dist/backend/services/attachment-packaging-scopes.js +58 -75
  231. package/dist/backend/services/attachment-packaging-scopes.js.map +1 -1
  232. package/dist/backend/services/attachment.service.d.ts +4 -8
  233. package/dist/backend/services/attachment.service.d.ts.map +1 -1
  234. package/dist/backend/services/attachment.service.js +35 -49
  235. package/dist/backend/services/attachment.service.js.map +1 -1
  236. package/dist/backend/services/attribute-filter-match.d.ts +14 -0
  237. package/dist/backend/services/attribute-filter-match.d.ts.map +1 -0
  238. package/dist/backend/services/attribute-filter-match.js +19 -0
  239. package/dist/backend/services/attribute-filter-match.js.map +1 -0
  240. package/dist/backend/services/attribute-scope-preview.d.ts +17 -7
  241. package/dist/backend/services/attribute-scope-preview.d.ts.map +1 -1
  242. package/dist/backend/services/attribute-scope-preview.js +30 -20
  243. package/dist/backend/services/attribute-scope-preview.js.map +1 -1
  244. package/dist/backend/services/attribute-set.service.d.ts +10 -1
  245. package/dist/backend/services/attribute-set.service.d.ts.map +1 -1
  246. package/dist/backend/services/attribute-set.service.js +30 -4
  247. package/dist/backend/services/attribute-set.service.js.map +1 -1
  248. package/dist/backend/services/attribute-type-mapping.d.ts +2 -2
  249. package/dist/backend/services/attribute-type-mapping.d.ts.map +1 -1
  250. package/dist/backend/services/attribute-type-mapping.js +6 -0
  251. package/dist/backend/services/attribute-type-mapping.js.map +1 -1
  252. package/dist/backend/services/attribute-usage.d.ts +31 -0
  253. package/dist/backend/services/attribute-usage.d.ts.map +1 -0
  254. package/dist/backend/services/attribute-usage.js +29 -0
  255. package/dist/backend/services/attribute-usage.js.map +1 -0
  256. package/dist/backend/services/bulk-operation.service.d.ts.map +1 -1
  257. package/dist/backend/services/bulk-operation.service.js +12 -6
  258. package/dist/backend/services/bulk-operation.service.js.map +1 -1
  259. package/dist/backend/services/bundle.service.d.ts.map +1 -1
  260. package/dist/backend/services/bundle.service.js +19 -1
  261. package/dist/backend/services/bundle.service.js.map +1 -1
  262. package/dist/backend/services/catalog-admin-search.service.d.ts +3 -2
  263. package/dist/backend/services/catalog-admin-search.service.d.ts.map +1 -1
  264. package/dist/backend/services/catalog-admin-search.service.js +6 -6
  265. package/dist/backend/services/catalog-admin-search.service.js.map +1 -1
  266. package/dist/backend/services/catalog-admin.service.d.ts +63 -12
  267. package/dist/backend/services/catalog-admin.service.d.ts.map +1 -1
  268. package/dist/backend/services/catalog-admin.service.js +352 -189
  269. package/dist/backend/services/catalog-admin.service.js.map +1 -1
  270. package/dist/backend/services/catalog-attribute-read.service.d.ts +14 -0
  271. package/dist/backend/services/catalog-attribute-read.service.d.ts.map +1 -1
  272. package/dist/backend/services/catalog-attribute-read.service.js +7 -19
  273. package/dist/backend/services/catalog-attribute-read.service.js.map +1 -1
  274. package/dist/backend/services/catalog-bulk-import.service.d.ts +52 -5
  275. package/dist/backend/services/catalog-bulk-import.service.d.ts.map +1 -1
  276. package/dist/backend/services/catalog-bulk-import.service.js +190 -142
  277. package/dist/backend/services/catalog-bulk-import.service.js.map +1 -1
  278. package/dist/backend/services/catalog-bulk-update.service.d.ts +5 -3
  279. package/dist/backend/services/catalog-bulk-update.service.d.ts.map +1 -1
  280. package/dist/backend/services/catalog-bulk-update.service.js +21 -8
  281. package/dist/backend/services/catalog-bulk-update.service.js.map +1 -1
  282. package/dist/backend/services/catalog-product-read.service.d.ts +11 -1
  283. package/dist/backend/services/catalog-product-read.service.d.ts.map +1 -1
  284. package/dist/backend/services/catalog-product-read.service.js +37 -17
  285. package/dist/backend/services/catalog-product-read.service.js.map +1 -1
  286. package/dist/backend/services/catalog-query.service.d.ts +39 -8
  287. package/dist/backend/services/catalog-query.service.d.ts.map +1 -1
  288. package/dist/backend/services/catalog-query.service.js +154 -116
  289. package/dist/backend/services/catalog-query.service.js.map +1 -1
  290. package/dist/backend/services/catalog-quick-search.service.d.ts.map +1 -1
  291. package/dist/backend/services/catalog-quick-search.service.js +5 -5
  292. package/dist/backend/services/catalog-quick-search.service.js.map +1 -1
  293. package/dist/backend/services/catalog-write-ports.d.ts +14 -16
  294. package/dist/backend/services/catalog-write-ports.d.ts.map +1 -1
  295. package/dist/backend/services/catalog-write-ports.js +11 -70
  296. package/dist/backend/services/catalog-write-ports.js.map +1 -1
  297. package/dist/backend/services/category-admin.service.d.ts.map +1 -1
  298. package/dist/backend/services/category-admin.service.js +9 -1
  299. package/dist/backend/services/category-admin.service.js.map +1 -1
  300. package/dist/backend/services/content-attribute-rules.d.ts +49 -0
  301. package/dist/backend/services/content-attribute-rules.d.ts.map +1 -0
  302. package/dist/backend/services/content-attribute-rules.js +89 -0
  303. package/dist/backend/services/content-attribute-rules.js.map +1 -0
  304. package/dist/backend/services/effective-value.sql.d.ts +24 -38
  305. package/dist/backend/services/effective-value.sql.d.ts.map +1 -1
  306. package/dist/backend/services/effective-value.sql.js +37 -87
  307. package/dist/backend/services/effective-value.sql.js.map +1 -1
  308. package/dist/backend/services/gallery-scopes.d.ts +45 -22
  309. package/dist/backend/services/gallery-scopes.d.ts.map +1 -1
  310. package/dist/backend/services/gallery-scopes.js +116 -109
  311. package/dist/backend/services/gallery-scopes.js.map +1 -1
  312. package/dist/backend/services/gallery.service.d.ts +13 -27
  313. package/dist/backend/services/gallery.service.d.ts.map +1 -1
  314. package/dist/backend/services/gallery.service.js +75 -199
  315. package/dist/backend/services/gallery.service.js.map +1 -1
  316. package/dist/backend/services/grouped.service.d.ts.map +1 -1
  317. package/dist/backend/services/grouped.service.js +13 -1
  318. package/dist/backend/services/grouped.service.js.map +1 -1
  319. package/dist/backend/services/packaging-unit.service.d.ts.map +1 -1
  320. package/dist/backend/services/packaging-unit.service.js +7 -12
  321. package/dist/backend/services/packaging-unit.service.js.map +1 -1
  322. package/dist/backend/services/page-builder-content.d.ts +64 -0
  323. package/dist/backend/services/page-builder-content.d.ts.map +1 -0
  324. package/dist/backend/services/page-builder-content.js +113 -0
  325. package/dist/backend/services/page-builder-content.js.map +1 -0
  326. package/dist/backend/services/primary-asset-url.d.ts +6 -1
  327. package/dist/backend/services/primary-asset-url.d.ts.map +1 -1
  328. package/dist/backend/services/primary-asset-url.js +9 -4
  329. package/dist/backend/services/primary-asset-url.js.map +1 -1
  330. package/dist/backend/services/product-availability.service.d.ts +16 -3
  331. package/dist/backend/services/product-availability.service.d.ts.map +1 -1
  332. package/dist/backend/services/product-availability.service.js +58 -21
  333. package/dist/backend/services/product-availability.service.js.map +1 -1
  334. package/dist/backend/services/product-content.service.d.ts +62 -0
  335. package/dist/backend/services/product-content.service.d.ts.map +1 -0
  336. package/dist/backend/services/product-content.service.js +122 -0
  337. package/dist/backend/services/product-content.service.js.map +1 -0
  338. package/dist/backend/services/product-editor-preferences.service.d.ts +6 -0
  339. package/dist/backend/services/product-editor-preferences.service.d.ts.map +1 -1
  340. package/dist/backend/services/product-editor-preferences.service.js +12 -0
  341. package/dist/backend/services/product-editor-preferences.service.js.map +1 -1
  342. package/dist/backend/services/product-global-field-rules.d.ts +39 -0
  343. package/dist/backend/services/product-global-field-rules.d.ts.map +1 -0
  344. package/dist/backend/services/product-global-field-rules.js +84 -0
  345. package/dist/backend/services/product-global-field-rules.js.map +1 -0
  346. package/dist/backend/services/product-link.service.d.ts.map +1 -1
  347. package/dist/backend/services/product-link.service.js +14 -16
  348. package/dist/backend/services/product-link.service.js.map +1 -1
  349. package/dist/backend/services/product-list-view-service.d.ts.map +1 -1
  350. package/dist/backend/services/product-list-view-service.js +5 -8
  351. package/dist/backend/services/product-list-view-service.js.map +1 -1
  352. package/dist/backend/services/product-page-revalidation.d.ts +9 -0
  353. package/dist/backend/services/product-page-revalidation.d.ts.map +1 -1
  354. package/dist/backend/services/product-page-revalidation.js +19 -0
  355. package/dist/backend/services/product-page-revalidation.js.map +1 -1
  356. package/dist/backend/services/product-scopes.service.d.ts +15 -6
  357. package/dist/backend/services/product-scopes.service.d.ts.map +1 -1
  358. package/dist/backend/services/product-scopes.service.js +87 -33
  359. package/dist/backend/services/product-scopes.service.js.map +1 -1
  360. package/dist/backend/services/product-value-resolver.service.d.ts +2 -2
  361. package/dist/backend/services/product-value-resolver.service.d.ts.map +1 -1
  362. package/dist/backend/services/product-value-resolver.service.js +4 -7
  363. package/dist/backend/services/product-value-resolver.service.js.map +1 -1
  364. package/dist/backend/services/publication-window-sweep.d.ts +61 -7
  365. package/dist/backend/services/publication-window-sweep.d.ts.map +1 -1
  366. package/dist/backend/services/publication-window-sweep.js +106 -19
  367. package/dist/backend/services/publication-window-sweep.js.map +1 -1
  368. package/dist/backend/services/scheduled-work-probe.d.ts +34 -0
  369. package/dist/backend/services/scheduled-work-probe.d.ts.map +1 -0
  370. package/dist/backend/services/scheduled-work-probe.js +30 -0
  371. package/dist/backend/services/scheduled-work-probe.js.map +1 -0
  372. package/dist/backend/services/scope-completeness.d.ts +11 -11
  373. package/dist/backend/services/scope-completeness.d.ts.map +1 -1
  374. package/dist/backend/services/scope-completeness.js +26 -33
  375. package/dist/backend/services/scope-completeness.js.map +1 -1
  376. package/dist/backend/services/scope-overview.service.d.ts +24 -24
  377. package/dist/backend/services/scope-overview.service.d.ts.map +1 -1
  378. package/dist/backend/services/scope-overview.service.js +33 -76
  379. package/dist/backend/services/scope-overview.service.js.map +1 -1
  380. package/dist/backend/services/scoped-store-adapters.d.ts +58 -0
  381. package/dist/backend/services/scoped-store-adapters.d.ts.map +1 -0
  382. package/dist/backend/services/scoped-store-adapters.js +92 -0
  383. package/dist/backend/services/scoped-store-adapters.js.map +1 -0
  384. package/dist/backend/services/scoped-values-global-only.d.ts +36 -0
  385. package/dist/backend/services/scoped-values-global-only.d.ts.map +1 -0
  386. package/dist/backend/services/scoped-values-global-only.js +92 -0
  387. package/dist/backend/services/scoped-values-global-only.js.map +1 -0
  388. package/dist/backend/services/scoped-values-import.d.ts +86 -0
  389. package/dist/backend/services/scoped-values-import.d.ts.map +1 -0
  390. package/dist/backend/services/scoped-values-import.js +320 -0
  391. package/dist/backend/services/scoped-values-import.js.map +1 -0
  392. package/dist/backend/services/scoped-values-read.service.d.ts +56 -0
  393. package/dist/backend/services/scoped-values-read.service.d.ts.map +1 -0
  394. package/dist/backend/services/scoped-values-read.service.js +289 -0
  395. package/dist/backend/services/scoped-values-read.service.js.map +1 -0
  396. package/dist/backend/services/scoped-values-save.service.d.ts +79 -0
  397. package/dist/backend/services/scoped-values-save.service.d.ts.map +1 -0
  398. package/dist/backend/services/scoped-values-save.service.js +675 -0
  399. package/dist/backend/services/scoped-values-save.service.js.map +1 -0
  400. package/dist/backend/services/scoped-values-state.d.ts +94 -0
  401. package/dist/backend/services/scoped-values-state.d.ts.map +1 -0
  402. package/dist/backend/services/scoped-values-state.js +159 -0
  403. package/dist/backend/services/scoped-values-state.js.map +1 -0
  404. package/dist/backend/services/scoped-values.service.d.ts +36 -0
  405. package/dist/backend/services/scoped-values.service.d.ts.map +1 -0
  406. package/dist/backend/services/scoped-values.service.js +92 -0
  407. package/dist/backend/services/scoped-values.service.js.map +1 -0
  408. package/dist/backend/services/storefront-value-overrides.d.ts +7 -8
  409. package/dist/backend/services/storefront-value-overrides.d.ts.map +1 -1
  410. package/dist/backend/services/storefront-value-overrides.js +11 -14
  411. package/dist/backend/services/storefront-value-overrides.js.map +1 -1
  412. package/dist/backend/services/url-key-resolution.service.d.ts +12 -18
  413. package/dist/backend/services/url-key-resolution.service.d.ts.map +1 -1
  414. package/dist/backend/services/url-key-resolution.service.js +43 -43
  415. package/dist/backend/services/url-key-resolution.service.js.map +1 -1
  416. package/dist/backend/services/url-key.service.d.ts +87 -135
  417. package/dist/backend/services/url-key.service.d.ts.map +1 -1
  418. package/dist/backend/services/url-key.service.js +447 -619
  419. package/dist/backend/services/url-key.service.js.map +1 -1
  420. package/dist/manifest.d.ts +7 -1
  421. package/dist/manifest.d.ts.map +1 -1
  422. package/dist/manifest.js +34 -0
  423. package/dist/manifest.js.map +1 -1
  424. package/dist/migrations/20261030T113855_catalog_scope_model_texts.d.ts +36 -0
  425. package/dist/migrations/20261030T113855_catalog_scope_model_texts.d.ts.map +1 -0
  426. package/dist/migrations/20261030T113855_catalog_scope_model_texts.js +225 -0
  427. package/dist/migrations/20261030T113855_catalog_scope_model_texts.js.map +1 -0
  428. package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.d.ts +18 -0
  429. package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.d.ts.map +1 -0
  430. package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.js +39 -0
  431. package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.js.map +1 -0
  432. package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.d.ts +6 -0
  433. package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.d.ts.map +1 -0
  434. package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.js +119 -0
  435. package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.js.map +1 -0
  436. package/dist/migrations/20261030T113908_catalog_scope_model_media.d.ts +6 -0
  437. package/dist/migrations/20261030T113908_catalog_scope_model_media.d.ts.map +1 -0
  438. package/dist/migrations/20261030T113908_catalog_scope_model_media.js +185 -0
  439. package/dist/migrations/20261030T113908_catalog_scope_model_media.js.map +1 -0
  440. package/dist/migrations/20261104T121504_catalog_product_content_values.d.ts +36 -0
  441. package/dist/migrations/20261104T121504_catalog_product_content_values.d.ts.map +1 -0
  442. package/dist/migrations/20261104T121504_catalog_product_content_values.js +53 -0
  443. package/dist/migrations/20261104T121504_catalog_product_content_values.js.map +1 -0
  444. package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.d.ts +33 -0
  445. package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.d.ts.map +1 -0
  446. package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.js +58 -0
  447. package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.js.map +1 -0
  448. package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.d.ts +36 -0
  449. package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.d.ts.map +1 -0
  450. package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.js +40 -0
  451. package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.js.map +1 -0
  452. package/dist/migrations/index.d.ts +8 -1
  453. package/dist/migrations/index.d.ts.map +1 -1
  454. package/dist/migrations/index.js +15 -1
  455. package/dist/migrations/index.js.map +1 -1
  456. package/docs/catalog/attachments.md +53 -43
  457. package/docs/catalog/attribute-sets.md +2 -2
  458. package/docs/catalog/attributes.md +68 -8
  459. package/docs/catalog/category-content.md +3 -0
  460. package/docs/catalog/composite-products.md +2 -2
  461. package/docs/catalog/editing-a-product-at-a-scope.md +95 -0
  462. package/docs/catalog/gallery-and-labels.md +61 -60
  463. package/docs/catalog/packaging-units.md +43 -34
  464. package/docs/catalog/per-channel-per-language-overrides.md +83 -410
  465. package/docs/catalog/product-content.md +180 -0
  466. package/docs/catalog/product-links.md +2 -2
  467. package/docs/catalog/url-keys-and-redirects.md +79 -79
  468. package/docs/catalog.md +68 -14
  469. package/i18n/en.json +270 -270
  470. package/i18n/pl.json +272 -272
  471. package/package.json +11 -11
  472. package/dist/admin/components/AttachmentScopesDialog.d.ts +0 -22
  473. package/dist/admin/components/AttachmentScopesDialog.d.ts.map +0 -1
  474. package/dist/admin/components/AttachmentScopesDialog.js +0 -70
  475. package/dist/admin/components/AttachmentScopesDialog.js.map +0 -1
  476. package/dist/admin/components/ProductScopeControls.d.ts +0 -31
  477. package/dist/admin/components/ProductScopeControls.d.ts.map +0 -1
  478. package/dist/admin/components/ProductScopeControls.js +0 -243
  479. package/dist/admin/components/ProductScopeControls.js.map +0 -1
  480. package/dist/admin/components/ProductScopeEditor.d.ts +0 -88
  481. package/dist/admin/components/ProductScopeEditor.d.ts.map +0 -1
  482. package/dist/admin/components/ProductScopeEditor.js +0 -396
  483. package/dist/admin/components/ProductScopeEditor.js.map +0 -1
  484. package/dist/admin/components/ProductUrlKeysPanel.d.ts +0 -17
  485. package/dist/admin/components/ProductUrlKeysPanel.d.ts.map +0 -1
  486. package/dist/admin/components/ProductUrlKeysPanel.js +0 -215
  487. package/dist/admin/components/ProductUrlKeysPanel.js.map +0 -1
  488. package/dist/admin/components/ScopedDialogParts.d.ts +0 -23
  489. package/dist/admin/components/ScopedDialogParts.d.ts.map +0 -1
  490. package/dist/admin/components/ScopedDialogParts.js +0 -16
  491. package/dist/admin/components/ScopedDialogParts.js.map +0 -1
  492. package/dist/admin/lib/media-scopes.d.ts +0 -41
  493. package/dist/admin/lib/media-scopes.d.ts.map +0 -1
  494. package/dist/admin/lib/media-scopes.js +0 -66
  495. package/dist/admin/lib/media-scopes.js.map +0 -1
  496. package/dist/admin/lib/product-scope-drafts.d.ts +0 -77
  497. package/dist/admin/lib/product-scope-drafts.d.ts.map +0 -1
  498. package/dist/admin/lib/product-scope-drafts.js +0 -133
  499. package/dist/admin/lib/product-scope-drafts.js.map +0 -1
  500. package/dist/backend/entities/gallery-item-channel-hidden.entity.d.ts +0 -14
  501. package/dist/backend/entities/gallery-item-channel-hidden.entity.d.ts.map +0 -1
  502. package/dist/backend/entities/gallery-item-channel-hidden.entity.js +0 -42
  503. package/dist/backend/entities/gallery-item-channel-hidden.entity.js.map +0 -1
  504. package/dist/backend/entities/gallery-item-channel-label.entity.d.ts +0 -18
  505. package/dist/backend/entities/gallery-item-channel-label.entity.d.ts.map +0 -1
  506. package/dist/backend/entities/gallery-item-channel-label.entity.js +0 -49
  507. package/dist/backend/entities/gallery-item-channel-label.entity.js.map +0 -1
  508. package/dist/backend/entities/product-attachment-channel-hidden.entity.d.ts +0 -13
  509. package/dist/backend/entities/product-attachment-channel-hidden.entity.d.ts.map +0 -1
  510. package/dist/backend/entities/product-attachment-channel-hidden.entity.js +0 -41
  511. package/dist/backend/entities/product-attachment-channel-hidden.entity.js.map +0 -1
  512. package/dist/backend/services/product-overrides.service.d.ts +0 -84
  513. package/dist/backend/services/product-overrides.service.d.ts.map +0 -1
  514. package/dist/backend/services/product-overrides.service.js +0 -211
  515. package/dist/backend/services/product-overrides.service.js.map +0 -1
  516. package/dist/backend/services/product-scope-context.service.d.ts +0 -36
  517. package/dist/backend/services/product-scope-context.service.d.ts.map +0 -1
  518. package/dist/backend/services/product-scope-context.service.js +0 -107
  519. package/dist/backend/services/product-scope-context.service.js.map +0 -1
@@ -1,8 +1,8 @@
1
1
  ---
2
- title: Product Gallery
2
+ title: Product gallery
3
3
  ---
4
4
 
5
- # Product Gallery
5
+ # Product gallery
6
6
 
7
7
  Each Product can carry a curated gallery of image and video Assets, with
8
8
  three labels that pin the storefront's resolution chain:
@@ -24,69 +24,69 @@ typed conflict error rather than silent data corruption.
24
24
  | `GET /api/v1/admin/catalog/products/:id/gallery` | admin | List the Product's gallery |
25
25
  | `POST /api/v1/admin/catalog/products/:id/gallery` | admin | Attach an existing image/video Asset with optional labels |
26
26
  | `POST .../gallery?replace=true` | admin | Atomic-swap: remove conflicting labels from other items in this Product, then assign |
27
- | `PATCH /api/v1/admin/catalog/products/:id/gallery/:itemId` | admin | Update labels (same `?replace=true` toggle), alt text per language, channels the item is hidden in |
28
- | `GET /api/v1/admin/catalog/products/:id/gallery/channel-roles` | admin | Each sales channel's own role holders |
29
- | `PUT /api/v1/admin/catalog/products/:id/gallery/channel-roles` | admin | Set or clear a sales channel's own role holders |
27
+ | `PATCH /api/v1/admin/catalog/products/:id/gallery/:itemId` | admin | Move the item (`position`) |
28
+ | `PUT /api/v1/admin/catalog/products/:id/scoped-values` | admin | Alt text, hidden flag and role holders at Global, a channel, or a channel and language (see below) |
30
29
  | `DELETE /api/v1/admin/catalog/products/:id/gallery/:itemId` | admin | Remove from gallery (Asset row survives) |
31
30
  | `PUT /api/v1/admin/catalog/products/:id/gallery/order` | admin | Reorder by id list |
32
31
 
33
32
  ## Atomic label swap
34
33
 
35
34
  Without the `?replace=true` query, assigning a label that already exists
36
- on another item returns `409 GALLERY_LABEL_ALREADY_TAKEN`. With it, the
35
+ on another item when adding it returns `409 GALLERY_LABEL_ALREADY_TAKEN`. With it, the
37
36
  service drops the conflicting assignments first then inserts the new
38
37
  one — all in a single transaction, so concurrent admins never see a
39
38
  half-applied state.
40
39
 
41
- ## Per sales channel and per language
40
+ ## Per scope: Global, Channel, Channel × language
42
41
 
43
42
  The set of images is the same in every sales channel: a channel cannot add an image
44
- of its own or reorder the gallery. What a channel can change is which image holds
45
- each role and which images it shows. The alt text can be set per language.
46
-
47
- - **Role per channel.** `PUT …/gallery/channel-roles` with
48
- `{ "channelId": "…", "roles": { "baseImage": "<itemId>", "smallImage": null } }`
49
- gives the channel its own holder of a role. `null` returns the role to the global
50
- holder; a role left out is unchanged. The keys are `baseImage`, `smallImage` and
51
- `thumbnail`. Each role has at most one holder per channel. `GET` lists the
52
- channels that have an override of their own.
53
- - **Hidden per channel.** `PATCH …/gallery/:itemId` with
54
- `{ "hiddenInChannels": ["…"] }` replaces the set of channels the image is hidden
55
- in. A hidden image is not served in that channel: not in the product page's
56
- gallery, not as the listing card's image, not as the Open Graph image, not in a
57
- product feed of that channel and not in a comparison seen in it. A role whose
58
- holder is hidden in a channel has no holder there, so the listing card moves on to
59
- the next image in its chain.
60
- - **Alt text per language.** `PATCH …/gallery/:itemId` with
61
- `{ "altText": { "pl-PL": "…", "de-DE": "" } }` sets the product's own alt text of
62
- the image in each named language. An empty string removes that language, and a
63
- language left out is unchanged. The product page serves the text in the request's
64
- language, else the asset's own alt text.
65
-
66
- You can hide an image or give it a role only in a channel the product is in;
67
- otherwise the request answers `422 SCOPE_INVALID`. Removing an override is always
68
- allowed, even after the product has left the channel.
69
-
70
- Hiding is presentation, not access control. A hidden image is not shown in the
71
- channel, but its file keeps its stable URL, and anyone who has that URL can still
43
+ of its own or reorder the gallery. What a scope can change is the image's alt text,
44
+ whether the image is shown, and which image holds each role. All three are scoped
45
+ fields, saved with the rest of the scope by `PUT …/products/:id/scoped-values`:
46
+
47
+ ```json
48
+ {
49
+ "scope": { "channelId": "<retail-uuid>", "languageCode": "pl-PL" },
50
+ "version": "7",
51
+ "changes": {
52
+ "gallery": {
53
+ "items": { "<itemId>": { "altText": "Wiertarka z boku", "hidden": { "inherit": true } } },
54
+ "roles": { "baseImage": "<itemId>", "smallImage": null }
55
+ }
56
+ }
57
+ }
58
+ ```
59
+
60
+ - **Alt text** — at Global, a channel, or a channel and language. With no product alt
61
+ text anywhere up the chain, the asset's own alt text in the request's language
62
+ applies. A deliberately empty alt text (`null`) renders as `alt=""`: the image is
63
+ decorative there, and the asset's alt text is not used.
64
+ - **Hidden** — at Global, a channel, or a channel and language; `true` or `false`, never
65
+ empty. A hidden image is not served at that scope: not in the product page's gallery,
66
+ not as the listing card's image, not as the Open Graph image, not in a product feed
67
+ and not in a comparison.
68
+ - **Role holders** (`baseImage`, `smallImage`, `thumbnail`) — at Global, a channel, or a
69
+ channel and language. `null` stores an empty override: no image holds the role there.
70
+ `{ "inherit": true }` returns the role to the parent scope. A role whose holder is
71
+ hidden at the scope has no holder there, so the listing card moves on to the next
72
+ image in its chain. Removing the holding image makes an override inherit again.
73
+
74
+ A scope that does not write a field inherits it from the parent scope —
75
+ Channel × language → Channel → Global. Writing at a channel the product is not in,
76
+ or a language the channel does not offer, answers `422 SCOPE_INVALID`. Removing an
77
+ override is always allowed, even after the product has left the channel.
78
+
79
+ Hiding is presentation, not access control. A hidden image is not shown at the
80
+ scope, but its file keeps its stable URL, and anyone who has that URL can still
72
81
  fetch it. Do not rely on hiding to keep an image confidential: a file that must
73
82
  not be public must not be in the product's gallery.
74
83
 
75
- Each of these writes is recorded once in the audit log as
76
- `product.media.update`, with the item's (or the channel's roles') state before and
77
- after. Sending the recorded before-state back through the same route restores it.
78
- The write announces `product.updated.v1` with `changedFields: ["media"]`. A request
79
- that changes nothing writes nothing and announces nothing.
84
+ A save is one audited Command, `product.scoped_values.save`, and announces
85
+ `product.updated.v1`. `PUT …/gallery/order` records `orderedGalleryItemIds` before and
86
+ after, and runs in one transaction. Deleting an item is recorded once, as
87
+ `gallery_item.delete`, and removes its overrides at every scope.
80
88
 
81
- The same holds for an item's labels and for the gallery's order. A `PATCH` that
82
- changes labels records them (`labels`) in the item's state; the labels are
83
- replaced in the same transaction as the rest of the item, so a refused label leaves
84
- the item untouched. With `?replace=true` the entry restores this item only: a label
85
- taken from another item is not handed back by re-sending it. `PUT …/gallery/order`
86
- records `orderedGalleryItemIds` before and after, and runs in one transaction.
87
- Deleting an item is recorded once, as `gallery_item.delete`.
88
-
89
- With no override, every channel shows the global gallery, as before.
89
+ With no override, every channel and language shows the Global gallery.
90
90
 
91
91
  ## Errors
92
92
 
@@ -95,15 +95,15 @@ With no override, every channel shows the global gallery, as before.
95
95
  | `GALLERY_LABEL_ALREADY_TAKEN` | 409 | Label conflict without `?replace=true` |
96
96
  | `GALLERY_LABEL_LIMIT_EXCEEDED` | 400 | More than 3 labels on a single item |
97
97
  | `ASSET_KIND_NOT_SUPPORTED` | 400 | Asset kind ∉ `{image, video}` |
98
- | `GALLERY_ITEM_NOT_FOUND` | 404 | `:itemId` missing, or a channel role names an item of another product |
99
- | `SCOPE_INVALID` | 422 | Hiding an image or giving a role in a channel the product is not in |
98
+ | `GALLERY_ITEM_NOT_FOUND` | 404 | `:itemId` missing |
99
+ | `SCOPE_INVALID` | 422 | A scoped gallery value for a channel the product is not in, or a language the channel does not offer |
100
100
  | `PRODUCT_NOT_FOUND` | 404 | `:id` missing |
101
101
 
102
102
  ## Storefront integration
103
103
 
104
104
  `productDetail.gallery[]` carries `{id, position, labels[], asset{id, kind, url}, altText}`,
105
- as the request's sales channel shows it: hidden items are left out, `labels` are the
106
- channel's roles, and `altText` is in the request's language.
105
+ as the request's sales channel and language show it: hidden items are left out, `labels`
106
+ are the effective roles there, and `altText` is the effective alt text there.
107
107
  The `<GallerySwitcher>` component renders the Base Image as the primary
108
108
  `<img>` (or the first item if no Base Image is set) and emits a thumbnail
109
109
  strip with the Small Image marked via `data-small-image="true"` for
@@ -122,11 +122,12 @@ over the listing thumbnail so social shares get the marketer's hero shot.
122
122
 
123
123
  ## Storage
124
124
 
125
- `gallery_items` (id, product_id FK CASCADE, asset_id FK RESTRICT,
126
- position, timestamps) + `gallery_item_labels` (composite PK on
125
+ `gallery_items` (id, product_id FK CASCADE, asset_id FK RESTRICT, position, the Global
126
+ `alt_text` and `hidden`, timestamps) + `gallery_item_labels` (composite PK on
127
127
  (gallery_item_id, label), `UNIQUE (product_id, label)`, CHECK label IN
128
- ('base_image', 'small_image', 'thumbnail')). `gallery_items.alt_text` holds the alt
129
- text per language. `gallery_item_channel_labels` holds a channel's own role holder
130
- (primary key (product_id, sales_channel_id, label)) and `gallery_item_channel_hidden`
131
- an item hidden in a channel (primary key (gallery_item_id, sales_channel_id)); both
132
- cascade on the product's, the item's and the channel's delete.
128
+ ('base_image', 'small_image', 'thumbnail')) — the Global role holders.
129
+ `gallery_item_scope_overrides` holds an item's alt text and hidden flag at a channel
130
+ or a channel and language, and `gallery_role_scope_overrides` a role's holder there
131
+ (`gallery_item_id` `null` = no image holds it). Both reference the item together with
132
+ its product, so an override cannot point at another product's image, and both cascade
133
+ on the product's, the item's and the channel's delete.
@@ -1,8 +1,8 @@
1
1
  ---
2
- title: Packaging Units
2
+ title: Packaging units
3
3
  ---
4
4
 
5
- # Packaging Units
5
+ # Packaging units
6
6
 
7
7
  Named ordering units attached to a product — for example a **Paleta** worth
8
8
  480 pieces. They let B2B buyers order in bulk units without typing the exact
@@ -14,8 +14,8 @@ request.
14
14
  Manage packaging units in the **Inventory** section of the product card
15
15
  (simple and configurable products only). Each unit has:
16
16
 
17
- - a **name** (operator text, e.g. `Paleta`, `Karton`) — unique within the product,
18
- optionally translated per language (see *Name per language* below),
17
+ - a **name** (operator text, e.g. `Paleta`, `Karton`) — the Global name is unique within
18
+ the product; a channel or a channel and language can override it (see *Name per scope* below),
19
19
  - a **base quantity** (whole number ≥ 1) — how many base pieces the unit holds,
20
20
  - a **default** flag — the unit pre-selected on the storefront,
21
21
  - a **position** — the order units appear in,
@@ -48,38 +48,44 @@ match one of the product's units. Anything else is refused with
48
48
  product's unit all give the same reason.
49
49
 
50
50
  **For API clients:** a name sent without an id is matched against the unit's
51
- **global** name only, never against its translations (see *Name per language*).
52
- A line that sends the name a buyer saw in a translated storefront — `Pallet`
53
- where the global name is `Paleta` — is refused with
51
+ **Global** name only, never against a channel's or a language's name (see *Name per
52
+ scope*). A line that sends the name a buyer saw in a translated storefront — `Pallet`
53
+ where the Global name is `Paleta` — is refused with
54
54
  `422 PACKAGING_UNIT_MISMATCH` (reason `name_unknown`). Send the
55
- `packagingUnitId`, or the global name.
55
+ `packagingUnitId`, or the Global name.
56
56
 
57
- ## Name per language
57
+ ## Name per scope
58
58
 
59
- A unit's name can be translated: `nameTranslations` maps a language to a name, e.g.
60
- `{ "en-GB": "Pallet", "de-DE": "" }`. A named language is set, an empty string
61
- removes it, and a language left out is unchanged; each name is at most 160
62
- characters. The unit's own `name` stays the global name: it is the one that must be
63
- unique within the product, the one a quote line sent without an id is matched
64
- against, and the one minimum refusals name.
59
+ A unit's name is a scoped field: it has a Global value and can be overridden at a sales
60
+ channel or at a channel and language. It is saved with the rest of the scope by
61
+ `PUT …/products/:id/scoped-values`, e.g.
62
+ `{ "changes": { "packagingUnits": { "<unitId>": { "name": "Pallet" } } } }` at
63
+ `{ "channelId": "…", "languageCode": "en-US" }`. Each name is at most 160 characters;
64
+ `{ "inherit": true }` removes the scope's own name, and `null` stores a deliberately
65
+ empty name at a channel or a channel and language. The Global name cannot be empty. It
66
+ is the one that must be unique within the product, the one a quote line sent without
67
+ an id is matched against, and the one minimum refusals name.
65
68
 
66
- Where a buyer sees the unit, its name is the translation in the request's language,
67
- else the global name:
69
+ Where a buyer sees the unit, its name is the effective name at the request's channel and
70
+ language — Channel × language → Channel → Global:
68
71
 
69
72
  - the product page's `packagingUnits[].name`;
70
- - the name a basket line snapshots — in the basket's language on its channel. When
73
+ - the name a basket line snapshots — at the basket's channel and language. When
71
74
  an administrator names the channel on a customer's behalf, the name is taken in
72
75
  that channel's default language, like the product name beside it;
73
- - the name a buyer's quote-request line snapshots — in the request's language on the
74
- channel it is raised on.
76
+ - the name a buyer's quote-request line snapshots — at the channel and language the
77
+ request is raised in.
78
+
79
+ A deliberately empty name at the scope does not produce an unnamed line: the basket,
80
+ quote and order snapshots then keep the Global name.
75
81
 
76
82
  Creating or updating a unit is recorded once in the audit log, as
77
83
  `packaging_unit.create` or `packaging_unit.update`, with the unit's state before and
78
- after (its product, name, `nameTranslations`, base quantity, default flag and
79
- minimum). Sending the recorded before-state back through the same route (without
80
- `productId`) restores it. The write announces `product.updated.v1` with
81
- `changedFields: ["packagingUnits"]`. A request that changes nothing writes nothing
82
- and announces nothing.
84
+ after (its product, Global name, base quantity, default flag and minimum). Sending the
85
+ recorded before-state back through the same route (without `productId`) restores it.
86
+ A scoped save is recorded as `product.scoped_values.save`. Both announce
87
+ `product.updated.v1`. A request that changes nothing writes nothing and announces
88
+ nothing. Deleting a unit removes its overrides at every scope.
83
89
 
84
90
  ## For buyers
85
91
 
@@ -92,7 +98,7 @@ line of the same product stay separate.
92
98
  ## How the label travels
93
99
 
94
100
  The unit name and base quantity are **snapshotted** on the line when it is
95
- created — the name in the line's language, as above — so later edits to (or deletion of) a product's packaging units never
101
+ created — the effective name at the line's channel and language, as above — so later edits to (or deletion of) a product's packaging units never
96
102
  change historical carts, orders, or quote requests.
97
103
 
98
104
  - **Cart** — `cart_items` snapshot the unit; the cart serializer composes a
@@ -115,15 +121,16 @@ count.
115
121
 
116
122
  - Admin CRUD: `GET/POST /api/v1/admin/catalog/products/:id/packaging-units`,
117
123
  `PATCH/DELETE …/:unitId`, `PATCH …/packaging-units/reorder`
118
- (gated by `catalog:read` / `catalog:write`). Create and update accept an
119
- optional `nameTranslations` and an optional `minOrderUnits` (`1…1000000`, or `null` to clear); the response
120
- always carries it. The in-process `CatalogPackagingPort`, used by PIM
124
+ (gated by `catalog:read` / `catalog:write`). Create takes the Global name; update
125
+ takes the base quantity, default flag, position and an optional `minOrderUnits`
126
+ (`1…1000000`, or `null` to clear) — the name at any scope is written through
127
+ `PUT …/scoped-values`. The response always carries `minOrderUnits`. The in-process `CatalogPackagingPort`, used by PIM
121
128
  connectors, accepts the same optional field and refuses an out-of-range
122
129
  value with `422 VALIDATION_FAILED`; a writer that never sends it keeps
123
130
  working.
124
131
  - Public: the product detail (`GET /api/v1/catalog/products/:idOrSlug`)
125
- includes an optional `packagingUnits` array; each unit carries its name in
126
- the request's language and `minOrderUnits` (`null` when none).
132
+ includes an optional `packagingUnits` array; each unit carries its effective
133
+ name at the request's channel and language and `minOrderUnits` (`null` when none).
127
134
  - Cart: `POST /api/v1/cart/items` accepts an optional `packagingUnitId`; the
128
135
  resulting line quantity is `baseQuantity × quantity`.
129
136
 
@@ -134,9 +141,11 @@ Table `product_packaging_units` (migration
134
141
  (FK → `products`, cascade delete), `name`, `base_quantity`
135
142
  (`CHECK >= 1`), `position`, `is_default`, timestamps; `UNIQUE (product_id,
136
143
  name)`. Migration `20261016T082008_catalog_order_rules.ts` adds
137
- `min_order_units` (nullable, `CHECK` 1–1 000 000), and
138
- `20261026T084533_catalog_attachment_packaging_translations.ts` adds
139
- `name_translations` (jsonb, `{}` by default). Additive snapshot columns, each added by its owning module:
144
+ `min_order_units` (nullable, `CHECK` 1–1 000 000).
145
+ `20261030T113908_catalog_scope_model_media.ts` replaces the per-language
146
+ `name_translations` with `product_packaging_unit_scope_overrides`: a name at a
147
+ channel or a channel and language, referencing the unit together with its product
148
+ and cascading on the unit's, the product's and the channel's delete. Additive snapshot columns, each added by its owning module:
140
149
  `cart_items` (`20260611T140413_carts_cart_item_packaging.ts`), `order_items`
141
150
  (`20260611T140414_orders_order_item_packaging.ts`), `quote_request_items`
142
151
  (`20260611T140415_quote_requests_qr_item_packaging.ts`; its