@endora-commerce/mod-catalog 0.108.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 (571) 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 +16 -1
  6. package/dist/admin/components/PackagingUnitsEditor.d.ts.map +1 -1
  7. package/dist/admin/components/PackagingUnitsEditor.js +20 -14
  8. package/dist/admin/components/PackagingUnitsEditor.js.map +1 -1
  9. package/dist/admin/components/ProductAttachmentsSection.d.ts +3 -0
  10. package/dist/admin/components/ProductAttachmentsSection.d.ts.map +1 -0
  11. package/dist/admin/components/ProductAttachmentsSection.js +98 -0
  12. package/dist/admin/components/ProductAttachmentsSection.js.map +1 -0
  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 +3 -0
  22. package/dist/admin/components/ProductGallerySection.d.ts.map +1 -0
  23. package/dist/admin/components/ProductGallerySection.js +129 -0
  24. package/dist/admin/components/ProductGallerySection.js.map +1 -0
  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 -140
  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 +38 -0
  34. package/dist/admin/components/ProductScopeOverview.d.ts.map +1 -0
  35. package/dist/admin/components/ProductScopeOverview.js +222 -0
  36. package/dist/admin/components/ProductScopeOverview.js.map +1 -0
  37. package/dist/admin/components/ProductStatusPills.d.ts +17 -0
  38. package/dist/admin/components/ProductStatusPills.d.ts.map +1 -0
  39. package/dist/admin/components/ProductStatusPills.js +23 -0
  40. package/dist/admin/components/ProductStatusPills.js.map +1 -0
  41. package/dist/admin/components/ProductUrlRedirects.d.ts +15 -0
  42. package/dist/admin/components/ProductUrlRedirects.d.ts.map +1 -0
  43. package/dist/admin/components/ProductUrlRedirects.js +70 -0
  44. package/dist/admin/components/ProductUrlRedirects.js.map +1 -0
  45. package/dist/admin/components/ProductsBulkEditDialog.d.ts +30 -0
  46. package/dist/admin/components/ProductsBulkEditDialog.d.ts.map +1 -1
  47. package/dist/admin/components/ProductsBulkEditDialog.js +288 -133
  48. package/dist/admin/components/ProductsBulkEditDialog.js.map +1 -1
  49. package/dist/admin/components/editor/DetailsTab.d.ts +30 -0
  50. package/dist/admin/components/editor/DetailsTab.d.ts.map +1 -0
  51. package/dist/admin/components/editor/DetailsTab.js +59 -0
  52. package/dist/admin/components/editor/DetailsTab.js.map +1 -0
  53. package/dist/admin/components/editor/ImmediateBadge.d.ts +21 -0
  54. package/dist/admin/components/editor/ImmediateBadge.d.ts.map +1 -0
  55. package/dist/admin/components/editor/ImmediateBadge.js +21 -0
  56. package/dist/admin/components/editor/ImmediateBadge.js.map +1 -0
  57. package/dist/admin/components/editor/confirm-removal.d.ts +13 -0
  58. package/dist/admin/components/editor/confirm-removal.d.ts.map +1 -0
  59. package/dist/admin/components/editor/confirm-removal.js +33 -0
  60. package/dist/admin/components/editor/confirm-removal.js.map +1 -0
  61. package/dist/admin/components/editor/editor-context.d.ts +53 -0
  62. package/dist/admin/components/editor/editor-context.d.ts.map +1 -0
  63. package/dist/admin/components/editor/editor-context.js +88 -0
  64. package/dist/admin/components/editor/editor-context.js.map +1 -0
  65. package/dist/admin/components/editor/scoped-controls.d.ts +46 -0
  66. package/dist/admin/components/editor/scoped-controls.d.ts.map +1 -0
  67. package/dist/admin/components/editor/scoped-controls.js +64 -0
  68. package/dist/admin/components/editor/scoped-controls.js.map +1 -0
  69. package/dist/admin/index.d.ts +2 -2
  70. package/dist/admin/index.d.ts.map +1 -1
  71. package/dist/admin/index.js +20 -0
  72. package/dist/admin/index.js.map +1 -1
  73. package/dist/admin/lib/attribute-scope.d.ts +23 -0
  74. package/dist/admin/lib/attribute-scope.d.ts.map +1 -0
  75. package/dist/admin/lib/attribute-scope.js +21 -0
  76. package/dist/admin/lib/attribute-scope.js.map +1 -0
  77. package/dist/admin/lib/bulk-operation-log-text.d.ts +9 -0
  78. package/dist/admin/lib/bulk-operation-log-text.d.ts.map +1 -0
  79. package/dist/admin/lib/bulk-operation-log-text.js +13 -0
  80. package/dist/admin/lib/bulk-operation-log-text.js.map +1 -0
  81. package/dist/admin/lib/editor-scope.d.ts +35 -0
  82. package/dist/admin/lib/editor-scope.d.ts.map +1 -0
  83. package/dist/admin/lib/editor-scope.js +114 -0
  84. package/dist/admin/lib/editor-scope.js.map +1 -0
  85. package/dist/admin/lib/order-minimum-input.d.ts +13 -0
  86. package/dist/admin/lib/order-minimum-input.d.ts.map +1 -0
  87. package/dist/admin/lib/order-minimum-input.js +16 -0
  88. package/dist/admin/lib/order-minimum-input.js.map +1 -0
  89. package/dist/admin/lib/product-labels.d.ts +12 -0
  90. package/dist/admin/lib/product-labels.d.ts.map +1 -0
  91. package/dist/admin/lib/product-labels.js +23 -0
  92. package/dist/admin/lib/product-labels.js.map +1 -0
  93. package/dist/admin/lib/product-scopes-api.d.ts +23 -0
  94. package/dist/admin/lib/product-scopes-api.d.ts.map +1 -0
  95. package/dist/admin/lib/product-scopes-api.js +57 -0
  96. package/dist/admin/lib/product-scopes-api.js.map +1 -0
  97. package/dist/admin/lib/product-url-keys-api.d.ts +23 -0
  98. package/dist/admin/lib/product-url-keys-api.d.ts.map +1 -0
  99. package/dist/admin/lib/product-url-keys-api.js +61 -0
  100. package/dist/admin/lib/product-url-keys-api.js.map +1 -0
  101. package/dist/admin/lib/resolve-product-selection.d.ts +29 -1
  102. package/dist/admin/lib/resolve-product-selection.d.ts.map +1 -1
  103. package/dist/admin/lib/resolve-product-selection.js +42 -6
  104. package/dist/admin/lib/resolve-product-selection.js.map +1 -1
  105. package/dist/admin/lib/scope-overview.d.ts +73 -0
  106. package/dist/admin/lib/scope-overview.d.ts.map +1 -0
  107. package/dist/admin/lib/scope-overview.js +178 -0
  108. package/dist/admin/lib/scope-overview.js.map +1 -0
  109. package/dist/admin/lib/scoped-editor-store.d.ts +81 -0
  110. package/dist/admin/lib/scoped-editor-store.d.ts.map +1 -0
  111. package/dist/admin/lib/scoped-editor-store.js +198 -0
  112. package/dist/admin/lib/scoped-editor-store.js.map +1 -0
  113. package/dist/admin/lib/scoped-values-api.d.ts +14 -0
  114. package/dist/admin/lib/scoped-values-api.d.ts.map +1 -0
  115. package/dist/admin/lib/scoped-values-api.js +55 -0
  116. package/dist/admin/lib/scoped-values-api.js.map +1 -0
  117. package/dist/admin/pages/AttributesManager.d.ts.map +1 -1
  118. package/dist/admin/pages/AttributesManager.js +186 -28
  119. package/dist/admin/pages/AttributesManager.js.map +1 -1
  120. package/dist/admin/pages/BulkOperationDetailPage.d.ts.map +1 -1
  121. package/dist/admin/pages/BulkOperationDetailPage.js +4 -19
  122. package/dist/admin/pages/BulkOperationDetailPage.js.map +1 -1
  123. package/dist/admin/pages/ProductContentPage.d.ts +27 -0
  124. package/dist/admin/pages/ProductContentPage.d.ts.map +1 -0
  125. package/dist/admin/pages/ProductContentPage.js +161 -0
  126. package/dist/admin/pages/ProductContentPage.js.map +1 -0
  127. package/dist/admin/pages/ProductCreateForm.d.ts +3 -0
  128. package/dist/admin/pages/ProductCreateForm.d.ts.map +1 -0
  129. package/dist/admin/pages/ProductCreateForm.js +87 -0
  130. package/dist/admin/pages/ProductCreateForm.js.map +1 -0
  131. package/dist/admin/pages/ProductEditor.d.ts +0 -4
  132. package/dist/admin/pages/ProductEditor.d.ts.map +1 -1
  133. package/dist/admin/pages/ProductEditor.js +878 -627
  134. package/dist/admin/pages/ProductEditor.js.map +1 -1
  135. package/dist/admin/pages/ProductsList.d.ts +12 -0
  136. package/dist/admin/pages/ProductsList.d.ts.map +1 -1
  137. package/dist/admin/pages/ProductsList.js +111 -54
  138. package/dist/admin/pages/ProductsList.js.map +1 -1
  139. package/dist/backend/admin-search-provider.d.ts +3 -2
  140. package/dist/backend/admin-search-provider.d.ts.map +1 -1
  141. package/dist/backend/admin-search-provider.js +2 -3
  142. package/dist/backend/admin-search-provider.js.map +1 -1
  143. package/dist/backend/commands/attribute-commands.d.ts +4 -3
  144. package/dist/backend/commands/attribute-commands.d.ts.map +1 -1
  145. package/dist/backend/commands/attribute-commands.js +82 -21
  146. package/dist/backend/commands/attribute-commands.js.map +1 -1
  147. package/dist/backend/commands/product-content-commands.d.ts +31 -0
  148. package/dist/backend/commands/product-content-commands.d.ts.map +1 -0
  149. package/dist/backend/commands/product-content-commands.js +70 -0
  150. package/dist/backend/commands/product-content-commands.js.map +1 -0
  151. package/dist/backend/commands/scoped-values.commands.d.ts +95 -0
  152. package/dist/backend/commands/scoped-values.commands.d.ts.map +1 -0
  153. package/dist/backend/commands/scoped-values.commands.js +235 -0
  154. package/dist/backend/commands/scoped-values.commands.js.map +1 -0
  155. package/dist/backend/demo/reset.d.ts.map +1 -1
  156. package/dist/backend/demo/reset.js +2 -1
  157. package/dist/backend/demo/reset.js.map +1 -1
  158. package/dist/backend/demo/rows.d.ts +25 -0
  159. package/dist/backend/demo/rows.d.ts.map +1 -1
  160. package/dist/backend/demo/rows.js +35 -12
  161. package/dist/backend/demo/rows.js.map +1 -1
  162. package/dist/backend/demo/seed.d.ts +2 -1
  163. package/dist/backend/demo/seed.d.ts.map +1 -1
  164. package/dist/backend/demo/seed.js +22 -8
  165. package/dist/backend/demo/seed.js.map +1 -1
  166. package/dist/backend/entities/bulk-operation.entity.d.ts +10 -0
  167. package/dist/backend/entities/bulk-operation.entity.d.ts.map +1 -1
  168. package/dist/backend/entities/bulk-operation.entity.js.map +1 -1
  169. package/dist/backend/entities/gallery-item-scope-override.entity.d.ts +30 -0
  170. package/dist/backend/entities/gallery-item-scope-override.entity.d.ts.map +1 -0
  171. package/dist/backend/entities/gallery-item-scope-override.entity.js +80 -0
  172. package/dist/backend/entities/gallery-item-scope-override.entity.js.map +1 -0
  173. package/dist/backend/entities/gallery-item.entity.d.ts +9 -1
  174. package/dist/backend/entities/gallery-item.entity.d.ts.map +1 -1
  175. package/dist/backend/entities/gallery-item.entity.js +16 -0
  176. package/dist/backend/entities/gallery-item.entity.js.map +1 -1
  177. package/dist/backend/entities/gallery-role-scope-override.entity.d.ts +28 -0
  178. package/dist/backend/entities/gallery-role-scope-override.entity.d.ts.map +1 -0
  179. package/dist/backend/entities/gallery-role-scope-override.entity.js +75 -0
  180. package/dist/backend/entities/gallery-role-scope-override.entity.js.map +1 -0
  181. package/dist/backend/entities/product-attachment-scope-override.entity.d.ts +30 -0
  182. package/dist/backend/entities/product-attachment-scope-override.entity.d.ts.map +1 -0
  183. package/dist/backend/entities/product-attachment-scope-override.entity.js +80 -0
  184. package/dist/backend/entities/product-attachment-scope-override.entity.js.map +1 -0
  185. package/dist/backend/entities/product-attachment.entity.d.ts +6 -1
  186. package/dist/backend/entities/product-attachment.entity.d.ts.map +1 -1
  187. package/dist/backend/entities/product-attachment.entity.js +9 -0
  188. package/dist/backend/entities/product-attachment.entity.js.map +1 -1
  189. package/dist/backend/entities/product-attribute.entity.d.ts +5 -9
  190. package/dist/backend/entities/product-attribute.entity.d.ts.map +1 -1
  191. package/dist/backend/entities/product-attribute.entity.js +5 -13
  192. package/dist/backend/entities/product-attribute.entity.js.map +1 -1
  193. package/dist/backend/entities/product-channel-language-scope.entity.d.ts +23 -0
  194. package/dist/backend/entities/product-channel-language-scope.entity.d.ts.map +1 -0
  195. package/dist/backend/entities/product-channel-language-scope.entity.js +61 -0
  196. package/dist/backend/entities/product-channel-language-scope.entity.js.map +1 -0
  197. package/dist/backend/entities/product-channel-scope.entity.d.ts +47 -0
  198. package/dist/backend/entities/product-channel-scope.entity.d.ts.map +1 -0
  199. package/dist/backend/entities/product-channel-scope.entity.js +113 -0
  200. package/dist/backend/entities/product-channel-scope.entity.js.map +1 -0
  201. package/dist/backend/entities/product-content-value.entity.d.ts +39 -0
  202. package/dist/backend/entities/product-content-value.entity.d.ts.map +1 -0
  203. package/dist/backend/entities/product-content-value.entity.js +81 -0
  204. package/dist/backend/entities/product-content-value.entity.js.map +1 -0
  205. package/dist/backend/entities/product-packaging-unit-scope-override.entity.d.ts +30 -0
  206. package/dist/backend/entities/product-packaging-unit-scope-override.entity.d.ts.map +1 -0
  207. package/dist/backend/entities/product-packaging-unit-scope-override.entity.js +80 -0
  208. package/dist/backend/entities/product-packaging-unit-scope-override.entity.js.map +1 -0
  209. package/dist/backend/entities/product-url-key.entity.d.ts +27 -0
  210. package/dist/backend/entities/product-url-key.entity.d.ts.map +1 -0
  211. package/dist/backend/entities/product-url-key.entity.js +70 -0
  212. package/dist/backend/entities/product-url-key.entity.js.map +1 -0
  213. package/dist/backend/entities/product-url-redirect.entity.d.ts +18 -0
  214. package/dist/backend/entities/product-url-redirect.entity.d.ts.map +1 -0
  215. package/dist/backend/entities/product-url-redirect.entity.js +57 -0
  216. package/dist/backend/entities/product-url-redirect.entity.js.map +1 -0
  217. package/dist/backend/entities/product-variant.entity.d.ts +8 -1
  218. package/dist/backend/entities/product-variant.entity.d.ts.map +1 -1
  219. package/dist/backend/entities/product-variant.entity.js +13 -2
  220. package/dist/backend/entities/product-variant.entity.js.map +1 -1
  221. package/dist/backend/entities/product.entity.d.ts +48 -16
  222. package/dist/backend/entities/product.entity.d.ts.map +1 -1
  223. package/dist/backend/entities/product.entity.js +65 -35
  224. package/dist/backend/entities/product.entity.js.map +1 -1
  225. package/dist/backend/index.d.ts +29 -2
  226. package/dist/backend/index.d.ts.map +1 -1
  227. package/dist/backend/index.js +311 -29
  228. package/dist/backend/index.js.map +1 -1
  229. package/dist/backend/plugin.d.ts +79 -8
  230. package/dist/backend/plugin.d.ts.map +1 -1
  231. package/dist/backend/plugin.js +98 -17
  232. package/dist/backend/plugin.js.map +1 -1
  233. package/dist/backend/prompt-tools.d.ts +11 -0
  234. package/dist/backend/prompt-tools.d.ts.map +1 -1
  235. package/dist/backend/prompt-tools.js +124 -9
  236. package/dist/backend/prompt-tools.js.map +1 -1
  237. package/dist/backend/routes.admin.d.ts +42 -14
  238. package/dist/backend/routes.admin.d.ts.map +1 -1
  239. package/dist/backend/routes.admin.js +214 -134
  240. package/dist/backend/routes.admin.js.map +1 -1
  241. package/dist/backend/routes.admin.url-keys.d.ts +23 -0
  242. package/dist/backend/routes.admin.url-keys.d.ts.map +1 -0
  243. package/dist/backend/routes.admin.url-keys.js +14 -0
  244. package/dist/backend/routes.admin.url-keys.js.map +1 -0
  245. package/dist/backend/routes.api-key.d.ts.map +1 -1
  246. package/dist/backend/routes.api-key.js +18 -3
  247. package/dist/backend/routes.api-key.js.map +1 -1
  248. package/dist/backend/routes.external.d.ts.map +1 -1
  249. package/dist/backend/routes.external.js +6 -1
  250. package/dist/backend/routes.external.js.map +1 -1
  251. package/dist/backend/routes.public.d.ts +31 -7
  252. package/dist/backend/routes.public.d.ts.map +1 -1
  253. package/dist/backend/routes.public.js +114 -33
  254. package/dist/backend/routes.public.js.map +1 -1
  255. package/dist/backend/routes.public.url-keys.d.ts +26 -0
  256. package/dist/backend/routes.public.url-keys.d.ts.map +1 -0
  257. package/dist/backend/routes.public.url-keys.js +17 -0
  258. package/dist/backend/routes.public.url-keys.js.map +1 -0
  259. package/dist/backend/services/asset-references.d.ts +12 -1
  260. package/dist/backend/services/asset-references.d.ts.map +1 -1
  261. package/dist/backend/services/asset-references.js +85 -32
  262. package/dist/backend/services/asset-references.js.map +1 -1
  263. package/dist/backend/services/attachment-packaging-scopes.d.ts +61 -0
  264. package/dist/backend/services/attachment-packaging-scopes.d.ts.map +1 -0
  265. package/dist/backend/services/attachment-packaging-scopes.js +98 -0
  266. package/dist/backend/services/attachment-packaging-scopes.js.map +1 -0
  267. package/dist/backend/services/attachment.service.d.ts +8 -1
  268. package/dist/backend/services/attachment.service.d.ts.map +1 -1
  269. package/dist/backend/services/attachment.service.js +105 -21
  270. package/dist/backend/services/attachment.service.js.map +1 -1
  271. package/dist/backend/services/attribute-filter-match.d.ts +14 -0
  272. package/dist/backend/services/attribute-filter-match.d.ts.map +1 -0
  273. package/dist/backend/services/attribute-filter-match.js +19 -0
  274. package/dist/backend/services/attribute-filter-match.js.map +1 -0
  275. package/dist/backend/services/attribute-scope-preview.d.ts +48 -0
  276. package/dist/backend/services/attribute-scope-preview.d.ts.map +1 -0
  277. package/dist/backend/services/attribute-scope-preview.js +76 -0
  278. package/dist/backend/services/attribute-scope-preview.js.map +1 -0
  279. package/dist/backend/services/attribute-set.service.d.ts +10 -1
  280. package/dist/backend/services/attribute-set.service.d.ts.map +1 -1
  281. package/dist/backend/services/attribute-set.service.js +30 -4
  282. package/dist/backend/services/attribute-set.service.js.map +1 -1
  283. package/dist/backend/services/attribute-type-mapping.d.ts +2 -2
  284. package/dist/backend/services/attribute-type-mapping.d.ts.map +1 -1
  285. package/dist/backend/services/attribute-type-mapping.js +6 -0
  286. package/dist/backend/services/attribute-type-mapping.js.map +1 -1
  287. package/dist/backend/services/attribute-usage.d.ts +31 -0
  288. package/dist/backend/services/attribute-usage.d.ts.map +1 -0
  289. package/dist/backend/services/attribute-usage.js +29 -0
  290. package/dist/backend/services/attribute-usage.js.map +1 -0
  291. package/dist/backend/services/bulk-operation.service.d.ts +36 -0
  292. package/dist/backend/services/bulk-operation.service.d.ts.map +1 -1
  293. package/dist/backend/services/bulk-operation.service.js +210 -37
  294. package/dist/backend/services/bulk-operation.service.js.map +1 -1
  295. package/dist/backend/services/bundle.service.d.ts +9 -1
  296. package/dist/backend/services/bundle.service.d.ts.map +1 -1
  297. package/dist/backend/services/bundle.service.js +31 -3
  298. package/dist/backend/services/bundle.service.js.map +1 -1
  299. package/dist/backend/services/catalog-admin-search.service.d.ts +4 -3
  300. package/dist/backend/services/catalog-admin-search.service.d.ts.map +1 -1
  301. package/dist/backend/services/catalog-admin-search.service.js +7 -7
  302. package/dist/backend/services/catalog-admin-search.service.js.map +1 -1
  303. package/dist/backend/services/catalog-admin.service.d.ts +171 -27
  304. package/dist/backend/services/catalog-admin.service.d.ts.map +1 -1
  305. package/dist/backend/services/catalog-admin.service.js +634 -315
  306. package/dist/backend/services/catalog-admin.service.js.map +1 -1
  307. package/dist/backend/services/catalog-attribute-read.service.d.ts +14 -0
  308. package/dist/backend/services/catalog-attribute-read.service.d.ts.map +1 -1
  309. package/dist/backend/services/catalog-attribute-read.service.js +7 -19
  310. package/dist/backend/services/catalog-attribute-read.service.js.map +1 -1
  311. package/dist/backend/services/catalog-bulk-import.service.d.ts +72 -3
  312. package/dist/backend/services/catalog-bulk-import.service.d.ts.map +1 -1
  313. package/dist/backend/services/catalog-bulk-import.service.js +212 -38
  314. package/dist/backend/services/catalog-bulk-import.service.js.map +1 -1
  315. package/dist/backend/services/catalog-bulk-update.service.d.ts +35 -5
  316. package/dist/backend/services/catalog-bulk-update.service.d.ts.map +1 -1
  317. package/dist/backend/services/catalog-bulk-update.service.js +123 -14
  318. package/dist/backend/services/catalog-bulk-update.service.js.map +1 -1
  319. package/dist/backend/services/catalog-org-price-decorator.d.ts +12 -25
  320. package/dist/backend/services/catalog-org-price-decorator.d.ts.map +1 -1
  321. package/dist/backend/services/catalog-org-price-decorator.js +48 -13
  322. package/dist/backend/services/catalog-org-price-decorator.js.map +1 -1
  323. package/dist/backend/services/catalog-product-filter.service.d.ts +16 -2
  324. package/dist/backend/services/catalog-product-filter.service.d.ts.map +1 -1
  325. package/dist/backend/services/catalog-product-filter.service.js +80 -3
  326. package/dist/backend/services/catalog-product-filter.service.js.map +1 -1
  327. package/dist/backend/services/catalog-product-read.service.d.ts +11 -1
  328. package/dist/backend/services/catalog-product-read.service.d.ts.map +1 -1
  329. package/dist/backend/services/catalog-product-read.service.js +40 -23
  330. package/dist/backend/services/catalog-product-read.service.js.map +1 -1
  331. package/dist/backend/services/catalog-query.service.d.ts +170 -42
  332. package/dist/backend/services/catalog-query.service.d.ts.map +1 -1
  333. package/dist/backend/services/catalog-query.service.js +797 -430
  334. package/dist/backend/services/catalog-query.service.js.map +1 -1
  335. package/dist/backend/services/catalog-quick-search.service.d.ts +18 -2
  336. package/dist/backend/services/catalog-quick-search.service.d.ts.map +1 -1
  337. package/dist/backend/services/catalog-quick-search.service.js +53 -21
  338. package/dist/backend/services/catalog-quick-search.service.js.map +1 -1
  339. package/dist/backend/services/catalog-write-ports.d.ts +16 -1
  340. package/dist/backend/services/catalog-write-ports.d.ts.map +1 -1
  341. package/dist/backend/services/catalog-write-ports.js +18 -0
  342. package/dist/backend/services/catalog-write-ports.js.map +1 -1
  343. package/dist/backend/services/category-admin.service.d.ts +12 -1
  344. package/dist/backend/services/category-admin.service.d.ts.map +1 -1
  345. package/dist/backend/services/category-admin.service.js +32 -3
  346. package/dist/backend/services/category-admin.service.js.map +1 -1
  347. package/dist/backend/services/channel-url-facts.d.ts +17 -0
  348. package/dist/backend/services/channel-url-facts.d.ts.map +1 -0
  349. package/dist/backend/services/channel-url-facts.js +20 -0
  350. package/dist/backend/services/channel-url-facts.js.map +1 -0
  351. package/dist/backend/services/content-attribute-rules.d.ts +49 -0
  352. package/dist/backend/services/content-attribute-rules.d.ts.map +1 -0
  353. package/dist/backend/services/content-attribute-rules.js +89 -0
  354. package/dist/backend/services/content-attribute-rules.js.map +1 -0
  355. package/dist/backend/services/effective-value.sql.d.ts +42 -0
  356. package/dist/backend/services/effective-value.sql.d.ts.map +1 -0
  357. package/dist/backend/services/effective-value.sql.js +61 -0
  358. package/dist/backend/services/effective-value.sql.js.map +1 -0
  359. package/dist/backend/services/gallery-scopes.d.ts +63 -0
  360. package/dist/backend/services/gallery-scopes.d.ts.map +1 -0
  361. package/dist/backend/services/gallery-scopes.js +158 -0
  362. package/dist/backend/services/gallery-scopes.js.map +1 -0
  363. package/dist/backend/services/gallery.service.d.ts +32 -4
  364. package/dist/backend/services/gallery.service.d.ts.map +1 -1
  365. package/dist/backend/services/gallery.service.js +182 -44
  366. package/dist/backend/services/gallery.service.js.map +1 -1
  367. package/dist/backend/services/grouped.service.d.ts.map +1 -1
  368. package/dist/backend/services/grouped.service.js +13 -1
  369. package/dist/backend/services/grouped.service.js.map +1 -1
  370. package/dist/backend/services/linkable-asset.d.ts +21 -0
  371. package/dist/backend/services/linkable-asset.d.ts.map +1 -0
  372. package/dist/backend/services/linkable-asset.js +31 -0
  373. package/dist/backend/services/linkable-asset.js.map +1 -0
  374. package/dist/backend/services/packaging-unit.service.d.ts.map +1 -1
  375. package/dist/backend/services/packaging-unit.service.js +73 -47
  376. package/dist/backend/services/packaging-unit.service.js.map +1 -1
  377. package/dist/backend/services/page-builder-content.d.ts +64 -0
  378. package/dist/backend/services/page-builder-content.d.ts.map +1 -0
  379. package/dist/backend/services/page-builder-content.js +113 -0
  380. package/dist/backend/services/page-builder-content.js.map +1 -0
  381. package/dist/backend/services/primary-asset-url.d.ts +12 -1
  382. package/dist/backend/services/primary-asset-url.d.ts.map +1 -1
  383. package/dist/backend/services/primary-asset-url.js +50 -14
  384. package/dist/backend/services/primary-asset-url.js.map +1 -1
  385. package/dist/backend/services/product-availability.service.d.ts +92 -0
  386. package/dist/backend/services/product-availability.service.d.ts.map +1 -0
  387. package/dist/backend/services/product-availability.service.js +260 -0
  388. package/dist/backend/services/product-availability.service.js.map +1 -0
  389. package/dist/backend/services/product-availability.sql.d.ts +71 -0
  390. package/dist/backend/services/product-availability.sql.d.ts.map +1 -0
  391. package/dist/backend/services/product-availability.sql.js +77 -0
  392. package/dist/backend/services/product-availability.sql.js.map +1 -0
  393. package/dist/backend/services/product-content.service.d.ts +62 -0
  394. package/dist/backend/services/product-content.service.d.ts.map +1 -0
  395. package/dist/backend/services/product-content.service.js +122 -0
  396. package/dist/backend/services/product-content.service.js.map +1 -0
  397. package/dist/backend/services/product-editor-preferences.service.d.ts +6 -0
  398. package/dist/backend/services/product-editor-preferences.service.d.ts.map +1 -1
  399. package/dist/backend/services/product-editor-preferences.service.js +12 -0
  400. package/dist/backend/services/product-editor-preferences.service.js.map +1 -1
  401. package/dist/backend/services/product-global-field-rules.d.ts +39 -0
  402. package/dist/backend/services/product-global-field-rules.d.ts.map +1 -0
  403. package/dist/backend/services/product-global-field-rules.js +84 -0
  404. package/dist/backend/services/product-global-field-rules.js.map +1 -0
  405. package/dist/backend/services/product-link.service.d.ts +10 -9
  406. package/dist/backend/services/product-link.service.d.ts.map +1 -1
  407. package/dist/backend/services/product-link.service.js +44 -36
  408. package/dist/backend/services/product-link.service.js.map +1 -1
  409. package/dist/backend/services/product-list-view-service.d.ts.map +1 -1
  410. package/dist/backend/services/product-list-view-service.js +5 -8
  411. package/dist/backend/services/product-list-view-service.js.map +1 -1
  412. package/dist/backend/services/product-page-revalidation.d.ts +60 -0
  413. package/dist/backend/services/product-page-revalidation.d.ts.map +1 -0
  414. package/dist/backend/services/product-page-revalidation.js +165 -0
  415. package/dist/backend/services/product-page-revalidation.js.map +1 -0
  416. package/dist/backend/services/product-scopes.service.d.ts +221 -0
  417. package/dist/backend/services/product-scopes.service.d.ts.map +1 -0
  418. package/dist/backend/services/product-scopes.service.js +692 -0
  419. package/dist/backend/services/product-scopes.service.js.map +1 -0
  420. package/dist/backend/services/product-summary-text.d.ts +8 -0
  421. package/dist/backend/services/product-summary-text.d.ts.map +1 -0
  422. package/dist/backend/services/product-summary-text.js +8 -0
  423. package/dist/backend/services/product-summary-text.js.map +1 -0
  424. package/dist/backend/services/product-value-resolver.service.d.ts +2 -2
  425. package/dist/backend/services/product-value-resolver.service.d.ts.map +1 -1
  426. package/dist/backend/services/product-value-resolver.service.js +4 -7
  427. package/dist/backend/services/product-value-resolver.service.js.map +1 -1
  428. package/dist/backend/services/publication-window-sweep.d.ts +131 -0
  429. package/dist/backend/services/publication-window-sweep.d.ts.map +1 -0
  430. package/dist/backend/services/publication-window-sweep.js +204 -0
  431. package/dist/backend/services/publication-window-sweep.js.map +1 -0
  432. package/dist/backend/services/scheduled-work-probe.d.ts +34 -0
  433. package/dist/backend/services/scheduled-work-probe.d.ts.map +1 -0
  434. package/dist/backend/services/scheduled-work-probe.js +30 -0
  435. package/dist/backend/services/scheduled-work-probe.js.map +1 -0
  436. package/dist/backend/services/scope-completeness.d.ts +107 -0
  437. package/dist/backend/services/scope-completeness.d.ts.map +1 -0
  438. package/dist/backend/services/scope-completeness.js +173 -0
  439. package/dist/backend/services/scope-completeness.js.map +1 -0
  440. package/dist/backend/services/scope-overview.service.d.ts +112 -0
  441. package/dist/backend/services/scope-overview.service.d.ts.map +1 -0
  442. package/dist/backend/services/scope-overview.service.js +329 -0
  443. package/dist/backend/services/scope-overview.service.js.map +1 -0
  444. package/dist/backend/services/scoped-store-adapters.d.ts +58 -0
  445. package/dist/backend/services/scoped-store-adapters.d.ts.map +1 -0
  446. package/dist/backend/services/scoped-store-adapters.js +92 -0
  447. package/dist/backend/services/scoped-store-adapters.js.map +1 -0
  448. package/dist/backend/services/scoped-values-global-only.d.ts +36 -0
  449. package/dist/backend/services/scoped-values-global-only.d.ts.map +1 -0
  450. package/dist/backend/services/scoped-values-global-only.js +92 -0
  451. package/dist/backend/services/scoped-values-global-only.js.map +1 -0
  452. package/dist/backend/services/scoped-values-import.d.ts +86 -0
  453. package/dist/backend/services/scoped-values-import.d.ts.map +1 -0
  454. package/dist/backend/services/scoped-values-import.js +320 -0
  455. package/dist/backend/services/scoped-values-import.js.map +1 -0
  456. package/dist/backend/services/scoped-values-read.service.d.ts +56 -0
  457. package/dist/backend/services/scoped-values-read.service.d.ts.map +1 -0
  458. package/dist/backend/services/scoped-values-read.service.js +289 -0
  459. package/dist/backend/services/scoped-values-read.service.js.map +1 -0
  460. package/dist/backend/services/scoped-values-save.service.d.ts +79 -0
  461. package/dist/backend/services/scoped-values-save.service.d.ts.map +1 -0
  462. package/dist/backend/services/scoped-values-save.service.js +675 -0
  463. package/dist/backend/services/scoped-values-save.service.js.map +1 -0
  464. package/dist/backend/services/scoped-values-state.d.ts +94 -0
  465. package/dist/backend/services/scoped-values-state.d.ts.map +1 -0
  466. package/dist/backend/services/scoped-values-state.js +159 -0
  467. package/dist/backend/services/scoped-values-state.js.map +1 -0
  468. package/dist/backend/services/scoped-values.service.d.ts +36 -0
  469. package/dist/backend/services/scoped-values.service.d.ts.map +1 -0
  470. package/dist/backend/services/scoped-values.service.js +92 -0
  471. package/dist/backend/services/scoped-values.service.js.map +1 -0
  472. package/dist/backend/services/sql-id-arrays.d.ts +16 -0
  473. package/dist/backend/services/sql-id-arrays.d.ts.map +1 -0
  474. package/dist/backend/services/sql-id-arrays.js +24 -0
  475. package/dist/backend/services/sql-id-arrays.js.map +1 -0
  476. package/dist/backend/services/storefront-value-overrides.d.ts +7 -8
  477. package/dist/backend/services/storefront-value-overrides.d.ts.map +1 -1
  478. package/dist/backend/services/storefront-value-overrides.js +11 -14
  479. package/dist/backend/services/storefront-value-overrides.js.map +1 -1
  480. package/dist/backend/services/url-key-resolution.service.d.ts +70 -0
  481. package/dist/backend/services/url-key-resolution.service.d.ts.map +1 -0
  482. package/dist/backend/services/url-key-resolution.service.js +179 -0
  483. package/dist/backend/services/url-key-resolution.service.js.map +1 -0
  484. package/dist/backend/services/url-key.service.d.ts +123 -0
  485. package/dist/backend/services/url-key.service.d.ts.map +1 -0
  486. package/dist/backend/services/url-key.service.js +566 -0
  487. package/dist/backend/services/url-key.service.js.map +1 -0
  488. package/dist/manifest.d.ts +9 -1
  489. package/dist/manifest.d.ts.map +1 -1
  490. package/dist/manifest.js +204 -10
  491. package/dist/manifest.js.map +1 -1
  492. package/dist/migrations/20261022T035133_catalog_product_scopes.d.ts +28 -0
  493. package/dist/migrations/20261022T035133_catalog_product_scopes.d.ts.map +1 -0
  494. package/dist/migrations/20261022T035133_catalog_product_scopes.js +92 -0
  495. package/dist/migrations/20261022T035133_catalog_product_scopes.js.map +1 -0
  496. package/dist/migrations/20261022T054223_catalog_product_url_keys.d.ts +32 -0
  497. package/dist/migrations/20261022T054223_catalog_product_url_keys.d.ts.map +1 -0
  498. package/dist/migrations/20261022T054223_catalog_product_url_keys.js +81 -0
  499. package/dist/migrations/20261022T054223_catalog_product_url_keys.js.map +1 -0
  500. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.d.ts +34 -0
  501. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.d.ts.map +1 -0
  502. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.js +57 -0
  503. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.js.map +1 -0
  504. package/dist/migrations/20261026T033453_catalog_product_media_scopes.d.ts +26 -0
  505. package/dist/migrations/20261026T033453_catalog_product_media_scopes.d.ts.map +1 -0
  506. package/dist/migrations/20261026T033453_catalog_product_media_scopes.js +54 -0
  507. package/dist/migrations/20261026T033453_catalog_product_media_scopes.js.map +1 -0
  508. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.d.ts +27 -0
  509. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.d.ts.map +1 -0
  510. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.js +45 -0
  511. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.js.map +1 -0
  512. package/dist/migrations/20261030T113855_catalog_scope_model_texts.d.ts +36 -0
  513. package/dist/migrations/20261030T113855_catalog_scope_model_texts.d.ts.map +1 -0
  514. package/dist/migrations/20261030T113855_catalog_scope_model_texts.js +225 -0
  515. package/dist/migrations/20261030T113855_catalog_scope_model_texts.js.map +1 -0
  516. package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.d.ts +18 -0
  517. package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.d.ts.map +1 -0
  518. package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.js +39 -0
  519. package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.js.map +1 -0
  520. package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.d.ts +6 -0
  521. package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.d.ts.map +1 -0
  522. package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.js +119 -0
  523. package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.js.map +1 -0
  524. package/dist/migrations/20261030T113908_catalog_scope_model_media.d.ts +6 -0
  525. package/dist/migrations/20261030T113908_catalog_scope_model_media.d.ts.map +1 -0
  526. package/dist/migrations/20261030T113908_catalog_scope_model_media.js +185 -0
  527. package/dist/migrations/20261030T113908_catalog_scope_model_media.js.map +1 -0
  528. package/dist/migrations/20261104T121504_catalog_product_content_values.d.ts +36 -0
  529. package/dist/migrations/20261104T121504_catalog_product_content_values.d.ts.map +1 -0
  530. package/dist/migrations/20261104T121504_catalog_product_content_values.js +53 -0
  531. package/dist/migrations/20261104T121504_catalog_product_content_values.js.map +1 -0
  532. package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.d.ts +33 -0
  533. package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.d.ts.map +1 -0
  534. package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.js +58 -0
  535. package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.js.map +1 -0
  536. package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.d.ts +36 -0
  537. package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.d.ts.map +1 -0
  538. package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.js +40 -0
  539. package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.js.map +1 -0
  540. package/dist/migrations/index.d.ts +13 -1
  541. package/dist/migrations/index.d.ts.map +1 -1
  542. package/dist/migrations/index.js +25 -1
  543. package/dist/migrations/index.js.map +1 -1
  544. package/docs/catalog/attachments.md +60 -8
  545. package/docs/catalog/attribute-sets.md +2 -2
  546. package/docs/catalog/attributes.md +68 -8
  547. package/docs/catalog/category-content.md +3 -0
  548. package/docs/catalog/composite-products.md +2 -2
  549. package/docs/catalog/editing-a-product-at-a-scope.md +95 -0
  550. package/docs/catalog/gallery-and-labels.md +68 -8
  551. package/docs/catalog/packaging-units.md +56 -10
  552. package/docs/catalog/per-channel-per-language-overrides.md +68 -237
  553. package/docs/catalog/product-content.md +180 -0
  554. package/docs/catalog/product-links.md +2 -2
  555. package/docs/catalog/url-keys-and-redirects.md +142 -0
  556. package/docs/catalog.md +241 -20
  557. package/i18n/en.json +977 -123
  558. package/i18n/pl.json +976 -122
  559. package/package.json +12 -12
  560. package/dist/admin/components/ProductScopeEditor.d.ts +0 -94
  561. package/dist/admin/components/ProductScopeEditor.d.ts.map +0 -1
  562. package/dist/admin/components/ProductScopeEditor.js +0 -395
  563. package/dist/admin/components/ProductScopeEditor.js.map +0 -1
  564. package/dist/backend/services/product-overrides.service.d.ts +0 -77
  565. package/dist/backend/services/product-overrides.service.d.ts.map +0 -1
  566. package/dist/backend/services/product-overrides.service.js +0 -204
  567. package/dist/backend/services/product-overrides.service.js.map +0 -1
  568. package/dist/backend/services/product-scope-context.service.d.ts +0 -36
  569. package/dist/backend/services/product-scope-context.service.d.ts.map +0 -1
  570. package/dist/backend/services/product-scope-context.service.js +0 -106
  571. package/dist/backend/services/product-scope-context.service.js.map +0 -1
@@ -1,261 +1,92 @@
1
1
  ---
2
- title: Per-Channel + Per-Language Overrides
2
+ title: Product scopes — Global, channel and channel × language
3
+ description: How a product value is set once for every channel and overridden per sales channel or per sales channel and language.
3
4
  ---
4
5
 
5
- # Per-Channel + Per-Language Overrides
6
+ # Product scopes — Global, channel and channel × language
6
7
 
7
- The Catalog uses a **four-scope value model** for product attribute
8
- values. The same attribute key can hold up to four addressable slots
9
- per product:
8
+ Every scoped product value lives at one of **three levels**:
10
9
 
11
- - `global` — one value across every Sales Channel and every language;
12
- - `language` — one value per language (e.g. system Name, Description);
13
- - `channel` — one value per Sales Channel the product is assigned to;
14
- - `channel+language` — one value per `(channel, language)` pair.
10
+ - **Global** — one value for every sales channel and every language;
11
+ - **Channel** — one value for one sales channel, in every language that channel offers;
12
+ - **Channel × language** — one value for one sales channel in one of its languages.
15
13
 
16
- Which slots are addressable for a given attribute is governed by two
17
- flags on the attribute definition, `channelScoped` and `languageScoped`.
18
- System attributes `name` and `description` are pinned channel-scoped +
19
- language-scoped via a backend constant
20
- (`SYSTEM_ATTRIBUTE_SCOPES`). User-defined attributes default to
21
- global-only and opt in via the attribute editor.
14
+ There is no language-only level. A translation is a Channel × language value, or a Channel value when the channel
15
+ sells in one language. A value is resolved from the narrowest level that holds one:
16
+ **Channel × language → Channel → Global**.
22
17
 
23
- ## Why
18
+ ## Which fields live where
24
19
 
25
- A B2B catalog routinely needs to overlay channel-specific marketing
26
- copy (wholesale vs. retail) and language-specific translation on the
27
- same product. The legacy storage — JSONB on `products.name` /
28
- `products.description` + a flat `products.attribute_values` JSONB —
29
- could express only the language dimension. The four-scope model lifts
30
- that ceiling without rewriting baseline storage; it adds a sibling
31
- overrides table that holds the channel-aware slots, and a single
32
- resolver function fuses the two on read.
20
+ | Field | Global | Channel | Channel × language |
21
+ | --- | --- | --- | --- |
22
+ | Name, description | yes | yes | yes |
23
+ | Text attributes marked *scopable* | yes | yes | yes |
24
+ | Other scopable attributes (numbers, selects, booleans) | yes | yes | — |
25
+ | Attributes not marked scopable | yes | — | — |
26
+ | Status | yes | yes | yes |
27
+ | Publication window, audience, minimum order quantity, returnable | yes | yes | — |
28
+ | URL key | yes | yes | yes |
29
+ | Gallery alt text, hide image, gallery roles | yes | yes | yes |
30
+ | Attachment name, description, hidden | yes | yes | yes |
31
+ | Packaging-unit name | yes | yes | yes |
32
+ | SEO title, description, Open Graph fields (owned by the `seo` module) | yes | yes | yes |
33
33
 
34
- ## Storage shape
34
+ SKU, type, attribute set, categories, stock settings and the download file have one value for the whole product and
35
+ are edited at Global only. Writing one of them at another scope is refused with `GLOBAL_ONLY_FIELD`; writing a field
36
+ at a level it does not support is refused with `FIELD_NOT_AT_SCOPE`.
35
37
 
36
- The global baseline keeps living where it has always lived:
38
+ ## Inherit, a value, or deliberately empty
37
39
 
38
- - `products.name` (`Record<lang, string>` JSONB) — language-scoped.
39
- - `products.description` (`Record<lang, string>` JSONB) — language-scoped.
40
- - `products.attribute_values` (`Record<key, value>` JSONB) — global by
41
- default. When the attribute's `languageScoped` flag is `true`, the
42
- inner value is itself keyed by language: `Record<key, Record<lang,
43
- value>>`.
40
+ At Channel and Channel × language each field is in one of three states:
44
41
 
45
- Channel-aware slots land in a new table:
42
+ - **Inherits** — the editor shows "Use value from *parent scope*" and the effective value comes from the level above;
43
+ - **Own value** — the value stored at this scope;
44
+ - **Deliberately empty** — an override that is empty on purpose. It stops the chain: a description emptied for one
45
+ channel stays empty there even though Global has one. A required field (the name, a required attribute) cannot be
46
+ emptied.
46
47
 
47
- ```sql
48
- create table "product_value_overrides" (
49
- "id" uuid primary key default gen_random_uuid(),
50
- "product_id" uuid not null references "products"("id") on delete cascade,
51
- "attribute_key" varchar(64) not null,
52
- "channel_id" uuid not null references "sales_channels"("id") on delete cascade,
53
- "language_code" varchar(16) null,
54
- "value" jsonb not null, -- always wrapped { "v": <scalar | object> }
55
- "created_at" timestamptz not null default now(),
56
- "updated_at" timestamptz not null default now()
57
- );
58
- ```
48
+ ## The write encoding
59
49
 
60
- The (product, attribute, channel, language) tuple is unique under
61
- **two partial indexes**:
50
+ Every writer — the editor's save, the import files and the PIM connector port — uses one encoding:
62
51
 
63
- ```sql
64
- create unique index "product_value_overrides_channel_only_uniq"
65
- on "product_value_overrides" ("product_id", "attribute_key", "channel_id")
66
- where "language_code" is null;
52
+ | Intent | JSON | CSV cell |
53
+ | --- | --- | --- |
54
+ | No change | the field absent, or `""` | an empty cell |
55
+ | Deliberately empty | `null` | `NULL` (the whole cell) |
56
+ | Remove the own value and inherit | `{ "inherit": true }` | `INHERIT` (the whole cell) |
57
+ | A value | the value | the text; `\NULL` and `\INHERIT` are the literal words |
67
58
 
68
- create unique index "product_value_overrides_channel_lang_uniq"
69
- on "product_value_overrides" ("product_id", "attribute_key", "channel_id", "language_code")
70
- where "language_code" is not null;
71
- ```
59
+ This is **not** JSON Merge Patch, where `null` removes a member: here `null` stores an empty override and only
60
+ `{ "inherit": true }` removes one. It is also not Magento's `__EMPTY__VALUE__` marker. `INHERIT` at Global and an
61
+ empty required field are refused with `SCOPED_VALUE_INVALID`.
72
62
 
73
- PostgreSQL treats `NULL` as distinct in a regular UNIQUE constraint, so
74
- the only correct way to model "(channel, NULL) and (channel, NULL) are
75
- the same row" is two partial indexes — one for each NULL semantic.
63
+ ## Reading and saving a scope
76
64
 
77
- The lookup path used by the resolver in tight loops is a plain btree:
65
+ - `GET /api/v1/admin/catalog/products/:id/scoped-values?channelId=&languageCode=` (`catalog:read`) answers every
66
+ field's effective value at the scope, its source (`set`, `set_empty`, `inherited_channel`, `inherited_global`,
67
+ `absent`), the levels it supports, what the completeness check misses at that scope and the product's
68
+ `version`.
69
+ - `PUT /api/v1/admin/catalog/products/:id/scoped-values` (`catalog:write`) saves one scope in one Command with one
70
+ audit entry. The body carries the `version` the editor read; a save made against an older version is refused with
71
+ `409 VERSION_CONFLICT`, so two operators never overwrite each other silently.
72
+ - `POST …/scoped-values/copy` copies one Channel × language value to other channels of the product.
78
73
 
79
- ```sql
80
- create index "product_value_overrides_product_attr_idx"
81
- on "product_value_overrides" ("product_id", "attribute_key");
82
- ```
74
+ ## Channels a product leaves
83
75
 
84
- A second table — `product_editor_preferences` — stores the per-(admin
85
- user, product) last-selected `(channelId, languageCode)` so the
86
- product edit page seeds the switchers from the editor's prior visit.
87
- It carries no FK to `sales_channels` so a deleted / un-assigned
88
- channel is silently tolerated on read.
76
+ A value stored for a channel the product is no longer sold on, or for a language the channel no longer offers, is
77
+ kept but ignored. The scope map lists such rows so they can be removed; they come back into effect if the
78
+ product returns to that channel or language.
89
79
 
90
- ## The resolver
80
+ ## Duplicating a product
91
81
 
92
- The single source of truth for "what value should I show?" lives in
93
- `packages/contracts/src/product-value-resolver.ts`. The same TypeScript
94
- file is imported by the backend (admin endpoints, storefront read
95
- path, search indexer) and the admin SPA. By construction, the admin's
96
- effective-value preview cannot drift from what the storefront renders.
82
+ **Duplicate** copies the product's values at every scope — Global, Channel and Channel × language, deliberately empty
83
+ values and inherit states included — for every field family above, in one audited Command. Two things are not
84
+ copied: URL keys (the copy gets a fresh Global key, because a key is one product's per channel) and status (the copy
85
+ starts inactive everywhere, so it is reviewed before it is sold).
97
86
 
98
- The algorithm — `resolveAttribute({ baseline, overrides, scope, ctx })`
99
- — walks four steps:
87
+ ## Related pages
100
88
 
101
- 1. `(channel + language)` slot — when the attribute is channel-scoped
102
- AND language-scoped AND the context carries both;
103
- 2. `(channel-only)` slot — when channel-scoped AND a channel is in the
104
- context;
105
- 3. `(global + language)` baseline — for language-scoped attributes,
106
- pick the requested language out of the JSONB;
107
- 4. `(global)` baseline — single value (or primary-language pick for
108
- language-scoped attrs).
109
-
110
- The first non-empty slot wins. Empty string, `null`, empty object,
111
- empty array are all treated as "absent" and fall through. The function
112
- returns both the resolved value AND a `source` tag indicating which
113
- slot produced the answer — the admin UI consumes this to render the
114
- "channel + language override" / "global baseline" badge per field.
115
-
116
- ### Orphan tolerance
117
-
118
- An administrator can flip an attribute's `channelScoped` flag back to
119
- `false` after channel overrides have already been written. The
120
- resolver simply skips override rows whose attribute is no longer
121
- channel-scoped, so the storefront falls back to the baseline without
122
- any data-loss event. A future maintenance pass can drop orphan rows;
123
- this feature does not require it.
124
-
125
- ## Write path
126
-
127
- Channel-aware overrides land through one admin endpoint:
128
-
129
- ```
130
- PATCH /api/v1/admin/catalog/products/:id/value-overrides
131
- {
132
- "upserts": [
133
- { "attributeKey": "name", "channelId": "<vip-uuid>", "languageCode": "en-US", "value": { "v": "VIP wholesale name (EN)" } },
134
- { "attributeKey": "description", "channelId": "<vip-uuid>", "languageCode": "pl-PL", "value": { "v": "Wholesale-only Polish copy" } }
135
- ],
136
- "deletes": [
137
- { "attributeKey": "description", "channelId": "<retail-uuid>", "languageCode": "en-US" }
138
- ]
139
- }
140
- ```
141
-
142
- All requested operations run in a single `em.transactional` pass.
143
- The handler validates every entry up front against six rules and
144
- rolls everything back on the first failure:
145
-
146
- | 422 code | Triggered when |
147
- | ----------------------------------- | -------------- |
148
- | `attribute_unknown` | `attributeKey` is neither a system attr (`name`, `description`) nor a row in `product_attributes`. |
149
- | `attribute_not_channel_scoped` | the attribute's `channelScoped=false`, so it has no channel slot. |
150
- | `attribute_missing_language` | the attribute's `languageScoped=true`, but the slot has `languageCode=null`. |
151
- | `channel_not_assigned_to_product` | `channelId` is not in `sales_channel_products` for the product. |
152
- | `language_not_in_channel` | `languageCode` is non-null and not in the channel's `SalesChannel.languages` array. |
153
- | `value_invalid` | the wrapped `value.v` does not match the attribute's `valueType`. |
154
-
155
- The baseline write path (Name / Description per language; global
156
- `attribute_values`) is unchanged — editors still use the existing
157
- locale-side-by-side inputs on the Details tab. Channel overrides are
158
- additive.
159
-
160
- ## Read paths
161
-
162
- These consumers go through the resolver:
163
-
164
- - **Admin endpoint** — `GET /api/v1/admin/catalog/products/:id?channelId=&languageCode=&includeOverridesMap=true`
165
- returns the baseline product PLUS, when context params are passed, a
166
- `resolved` block with `name`, `description`, `attributeValues`,
167
- `sources`. When `includeOverridesMap=true`, the full override list
168
- is attached for client-side switcher previews.
169
- - **Storefront public read** — pulls the channel from the
170
- `x-sales-channel` header (the existing convention) and
171
- the language from `Accept-Language`, else the channel's default
172
- language. The override layer is invisible to the public client: it
173
- receives the effective value. The product page (name, description,
174
- SEO fields, attribute values, the product-page attribute list, grouped
175
- children and bundle options) and every listing card walk the storefront's own baseline language pick — requested
176
- language, then the channel's default language, then `en-US`, `en` and
177
- the first stored language — and at each language take the
178
- `(channel + language)` slot if it is filled, else stop there if the
179
- baseline has text for that language. An override therefore answers
180
- only for the language whose baseline text the page would show, or an
181
- earlier one in that order: a request in `en-US` on a channel whose
182
- default is `pl-PL` shows the `en-US` baseline, not the `pl-PL`
183
- override, while a `de-DE` request for a product with no `de-DE` text
184
- falls through to `pl-PL` and shows its override. The `(channel-only)`
185
- slot is asked last and wins over the baseline wherever the walk
186
- stopped. Product-link tiles keep their own language pick, which has
187
- no channel-default leg, and walk the override slots over it, so a
188
- tile can show the `en-US` baseline where the listing card shows the
189
- channel default's override. A product without overrides shows exactly what
190
- it showed before. Listing filters, attribute filters and name sorting
191
- still read the baseline.
192
- - **Search indexer (Meilisearch)** — builds one document per
193
- `(product, channel)` pair. Each document's `name` and `description`
194
- fields are run through the resolver with `channel.defaultLanguage`
195
- as the active language, so per-channel overrides flow into
196
- storefront search ranking and name sorting.
197
- - **Search result cards** — the search module re-reads every hit from
198
- Postgres before it answers, and the card name it shows is resolved
199
- there, not taken from the index: the request's sales channel override
200
- rows are read once per results page and the card walks the same
201
- languages and slots, in the same order, as a listing card above. The indexed name is
202
- resolved for the channel's default language only, so it would be
203
- wrong for a request in any other language. A product without an
204
- override for the channel shows exactly what it showed before.
205
-
206
- ## Admin UI
207
-
208
- The product edit page's **Details** tab gains a
209
- `<ProductScopeEditor>` panel above the existing locale inputs. It:
210
-
211
- 1. Loads `GET /scope-context` (channels assigned to the product + each
212
- channel's languages + the platform primary admin language + the
213
- editor's remembered preference) and `GET /value-overrides` in
214
- parallel.
215
- 2. Renders a Sales Channel switcher (Global + each assigned channel)
216
- and a Language switcher narrowed to the active channel's languages
217
- (or the union of all channel languages when Global).
218
- 3. Shows the resolved Name + Description for the active context with a
219
- source badge per field — `channel + language override` / `channel
220
- override` / `global baseline (language)` / `global baseline
221
- (fallback)` / `no value`.
222
- 4. Offers "Add override" / "Edit override" / "Reset to Global"
223
- affordances per field. Edits go through `PATCH /value-overrides`
224
- with optimistic refresh.
225
- 5. Persists the editor's `(channel, language)` selection back via
226
- `PUT /editor-preference` (debounced, best-effort) so the next visit
227
- seeds the same context.
228
-
229
- Edit affordances are gated on a specific channel being selected.
230
- Under Global / no channel, the panel is read-only and a help string
231
- explains that overrides only apply per-channel.
232
-
233
- ## Migration
234
-
235
- One migration `20260611T140346_catalog_product_value_overrides_init.ts` ships everything:
236
-
237
- - adds `channel_scoped` + `language_scoped` boolean columns to
238
- `product_attributes` (default `false`);
239
- - creates `product_value_overrides` with the two partial UNIQUE
240
- indexes and the `(product_id, attribute_key)` btree;
241
- - creates `product_editor_preferences` (composite PK
242
- `(admin_user_id, product_id)`).
243
-
244
- No baseline data migration. No data backfill. The `down()` is the
245
- exact inverse — drop the two tables and the two columns.
246
-
247
- ## What is not in scope
248
-
249
- - **User-defined attribute overrides in the admin UI** — the panel
250
- surfaces only the system Name + Description today. User attribute
251
- overrides are accepted by the PATCH endpoint and resolved on read,
252
- but the admin SPA does not yet expose a write affordance for them.
253
- - **Override-aware listing filters and sorting** — the public catalog
254
- endpoint returns `name` and `description` as the resolved string for
255
- the request's sales channel and language (see *Read paths* above), but
256
- listing filters, attribute filters and name sorting still read the
257
- baseline values. Making them follow the overrides is a follow-up.
258
- - **Channel-aware reindex enqueue** — the PATCH endpoint does not
259
- yet enqueue a Meilisearch reindex job per touched channel; the
260
- next per-product upsert (driven by any catalog mutation) picks it
261
- up. A dedicated reindex on override write is a small follow-up.
89
+ - [Editing a product at a scope](./editing-a-product-at-a-scope.md) — the scope switcher, inherit and the Scope map in the editor.
90
+ - [URL Keys and Redirects](./url-keys-and-redirects.md) — key uniqueness per channel and redirects.
91
+ - [Gallery and Labels](./gallery-and-labels.md), [Attachments](./attachments.md),
92
+ [Packaging Units](./packaging-units.md) — the media and packaging values per scope.
@@ -0,0 +1,180 @@
1
+ ---
2
+ title: Product content
3
+ description: Page Builder documents kept per product in content attributes and rendered on the product page's description tab.
4
+ ---
5
+
6
+ # Product content
7
+
8
+ A **content attribute** holds one Page Builder document per language for each
9
+ product — a buying guide, a feature banner, a size chart. The product page shows
10
+ it in the description tab (**Opis**), below the plain description. Anything the
11
+ Page Builder offers can go into it, including formatted text written in its
12
+ rich-text block.
13
+
14
+ ## Defining a content attribute
15
+
16
+ On **Catalog → Attributes**, create an attribute with the type **Page Builder
17
+ content**. The type comes with fixed settings:
18
+
19
+ - it is always kept **per language**;
20
+ - it cannot be searchable, filterable, comparable, a variant axis, a
21
+ promotion or price-list rule, mass-editable, quick-searchable, required,
22
+ shown in the **Parametry** tab, or set per sales channel. The form does not
23
+ offer those settings, the list shows them locked, and the API refuses each one
24
+ with `400 VALIDATION_FAILED`, naming the setting;
25
+ - it has no options;
26
+ - its type cannot be changed later, and no other attribute can be changed into
27
+ it (`409`).
28
+
29
+ Then add the attribute to an [attribute set](./attribute-sets.md). Its position
30
+ in the set is the order in which the product page shows the set's content
31
+ attributes. The type is offered for products only — the generic custom-field
32
+ screens of other records do not offer it.
33
+
34
+ ## Authoring
35
+
36
+ On the product's **Attributes** tab, each content attribute of the product's
37
+ saved attribute set is a card rather than an input, below the attribute values.
38
+ The card shows, per editing language, whether content is filled in, and a short
39
+ summary of what is stored. The cards are the same at every scope of the editor's
40
+ scope switcher: content has no value per sales channel.
41
+ **Edit content** opens the product content screen
42
+ (`/catalog/products/:id/content/:attributeKey`). It has:
43
+
44
+ - a **language** switch — English, Polish, and any other language the stored
45
+ content already has;
46
+ - the **Page Builder** canvas for the selected language;
47
+ - **Save content** — one save stores every language you edited. Leaving the screen with
48
+ unsaved edits asks first. The back link returns to the product's Attributes
49
+ tab.
50
+
51
+ The card offers no link while the product has not been saved yet, or while the
52
+ Details tab shows a different attribute set from the saved one — save the
53
+ product first.
54
+
55
+ To remove a language, delete every block from its document and save. A language
56
+ with no block is not stored, and an attribute with no language left holds no
57
+ value.
58
+
59
+ Reading content needs the catalogue read permission, and saving it the catalogue
60
+ write permission. Without the write permission the screen is read-only.
61
+
62
+ The canvas offers the Page Builder's **Translate** action under its usual
63
+ switch and permission. A translation lands in the canvas and is stored only when
64
+ you press **Save content**.
65
+
66
+ ## On the storefront
67
+
68
+ The description tab is shown when the product has a plain description **or** at
69
+ least one content attribute with content. It shows the plain description first,
70
+ then each content attribute in the attribute set's order. No heading or label is
71
+ printed above a document — the document carries its own headings.
72
+
73
+ Each document is resolved to one language in this order: the visitor's language,
74
+ the sales channel's default language, English, then any language that has
75
+ content. A language whose document holds no block is skipped. The content is the
76
+ product's, so it is the same whichever variant is selected.
77
+
78
+ The blocks are drawn by the storefront's Page Builder renderer — the one that
79
+ draws CMS pages — so HTML an operator typed is sanitised the same way, and a
80
+ block that belongs to a switched-off module is not drawn. A saved change is
81
+ visible on the next load of the product page.
82
+
83
+ Content never appears in the **Parametry** tab. That tab lists only attributes
84
+ marked visible on the product page that hold a value, and it is not shown when
85
+ there is none.
86
+
87
+ ## When the CMS module is off
88
+
89
+ Product content needs the CMS module, which provides the Page Builder:
90
+
91
+ - the product page shows **no** content, and the product API returns none — a
92
+ product whose only description was content shows no description tab;
93
+ - the admin cards keep showing which languages hold content, but offer no
94
+ **Edit content** link, and the content screen explains that no editor is
95
+ available. An operator without access to the CMS module sees the same;
96
+ - nothing stored is changed or deleted. Switching the CMS module back on brings
97
+ the content back on the product page and makes it editable again.
98
+
99
+ This is stricter than [category page content](./category-content.md), which
100
+ keeps rendering while the CMS module is off.
101
+
102
+ ## Lifecycle
103
+
104
+ - **Duplicate** — the copy carries the same content.
105
+ - **Attribute set** — when a content attribute leaves the product's attribute
106
+ set, its content is kept but not offered: the card disappears, the content
107
+ screen answers *not available*, and the product page leaves it out. Adding the
108
+ attribute back brings it all back.
109
+ - **Product delete** — a deleted product's content stays stored with it, and is
110
+ unreachable from the admin, the API and the storefront. Assets embedded in it
111
+ are no longer reported as in use.
112
+ - **Attribute delete** — deleting a content attribute deletes its content on
113
+ every product. The delete confirmation says how many products carry content
114
+ first (see [Attributes](./attributes.md#deleting-an-attribute)).
115
+ - **Assets** — a library asset embedded in a product's content is reported as in
116
+ use by that product, so it cannot be deleted while the content holds it.
117
+
118
+ ## What content does not take part in
119
+
120
+ Content attributes are deliberately left out of:
121
+
122
+ - values per sales channel or per channel language (the editor's Channel and
123
+ Channel × language scopes): the editor's save and the connectors' scoped write
124
+ refuse a content attribute's key;
125
+ - product export and import — export omits them, and a non-empty cell under a
126
+ content attribute's `attribute:<key>` column is refused for that cell
127
+ (`content_attribute`), the rest of the row being imported;
128
+ - the external (integration) API and PIM/ERP connectors, and the API-key read of
129
+ an attribute set;
130
+ - the products bulk editor;
131
+ - product feeds — neither as a feed field nor in a selection rule;
132
+ - storefront search, quick search and the admin product search;
133
+ - promotions, price lists, comparison and storefront filters;
134
+ - the product list, the search response and every other product read except
135
+ the product page's.
136
+
137
+ ## For integrators
138
+
139
+ | Verb + Path | Audience | Purpose |
140
+ | --- | --- | --- |
141
+ | `GET /api/v1/catalog/products/:idOrSlug?include=content` | storefront | The product detail with `contentAttributes`: `[{ key, language, content }]`, each document resolved to the caller's language, in set order. Without `include` the response has no `contentAttributes` key. `include` accepts only `content` |
142
+ | `GET /api/v1/admin/catalog/products/:id/content` | admin (`catalog:read`) | The card list: `{ productId, attributeSetId, attributes: [{ attributeId, key, label, labelDefault, position, languages: [{ language, filled, blocks, excerpt }] }] }`. Summaries only, never documents |
143
+ | `GET /api/v1/admin/catalog/products/:id/content/:attributeKey` | admin (`catalog:read`) | One attribute's envelope: `{ productId, attributeKey, content }` with `content` = `{ languages: { "<code>": <document> } }` or `null` |
144
+ | `PUT /api/v1/admin/catalog/products/:id/content/:attributeKey` | admin (`catalog:write`) | Replaces the envelope; the body is `{ "content": <envelope> }`, and `{ "content": null }` clears it. Answers the stored, normalised value |
145
+
146
+ The envelope is the one a CMS page uses and is limited to 1 MiB (1 048 576
147
+ bytes) of JSON across all languages; a larger one is refused with
148
+ `400 VALIDATION_FAILED`. A key that is not a content attribute of the product's
149
+ current set is refused with `400 ATTRIBUTE_VALUE_REJECTED`. An unknown or deleted
150
+ product answers `404 PRODUCT_NOT_FOUND`. The `PUT` body is validated by the
151
+ handler, so the published OpenAPI document shows no request schema for it.
152
+
153
+ A content attribute's key is refused in `attributeValues` everywhere —
154
+ `POST`/`PATCH /api/v1/admin/catalog/products`, the API-key
155
+ `PUT /api/v1/catalog/products/by-sku/:sku` and the catalogue's write port — with
156
+ `400 ATTRIBUTE_VALUE_REJECTED`; content is written only through the route above.
157
+
158
+ Saving runs the `product.content.update` command — the audit entry records the
159
+ attribute and which languages the envelope carried, not the documents — and
160
+ emits `product.content.updated.v1`, on which the storefront's product cache is
161
+ flushed. It does not emit `product.updated.v1`, so a content save does not
162
+ re-index the product.
163
+
164
+ A connector that maps attribute types should skip `page_builder`: it is a value
165
+ type of `customFieldValueTypeSchema`, `attributeValueTypeSchema` and
166
+ `apiAttributeTypeSchema` in `@endora-commerce/contracts`, and none of the
167
+ integration paths carries it. The content schemas are
168
+ `productContentEnvelopeSchema`, `putProductContentRequestSchema`,
169
+ `adminProductContentSchema`, `adminProductContentListSchema` and
170
+ `productPageContentAttributeSchema`.
171
+
172
+ ## Providing an editor
173
+
174
+ The content screen owns the document and no editor: it renders the admin zone
175
+ `product.content.editor` and saves what the zone reports. A module that owns a
176
+ Page Builder contributes a component there; its props are
177
+ `{ productId, attributeKey, language, data, onChange }`, where `data` is the
178
+ document to open and `onChange` reports every edit. The contributor never saves.
179
+ When nothing contributes, the card and the screen say that no editor is
180
+ available.
@@ -1,8 +1,8 @@
1
1
  ---
2
- title: Product Links
2
+ title: Product links
3
3
  ---
4
4
 
5
- # Product Links
5
+ # Product links
6
6
 
7
7
  Directed links between Products that drive cross-merchandising on the
8
8
  PDP and cart. Three kinds: