@endora-commerce/mod-catalog 0.107.0 → 0.109.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (403) hide show
  1. package/dist/admin/components/AttachmentScopesDialog.d.ts +22 -0
  2. package/dist/admin/components/AttachmentScopesDialog.d.ts.map +1 -0
  3. package/dist/admin/components/AttachmentScopesDialog.js +70 -0
  4. package/dist/admin/components/AttachmentScopesDialog.js.map +1 -0
  5. package/dist/admin/components/PackagingUnitsEditor.d.ts +10 -1
  6. package/dist/admin/components/PackagingUnitsEditor.d.ts.map +1 -1
  7. package/dist/admin/components/PackagingUnitsEditor.js +127 -10
  8. package/dist/admin/components/PackagingUnitsEditor.js.map +1 -1
  9. package/dist/admin/components/ProductAttachmentsSection.d.ts +5 -0
  10. package/dist/admin/components/ProductAttachmentsSection.d.ts.map +1 -0
  11. package/dist/admin/components/ProductAttachmentsSection.js +137 -0
  12. package/dist/admin/components/ProductAttachmentsSection.js.map +1 -0
  13. package/dist/admin/components/ProductGallerySection.d.ts +14 -0
  14. package/dist/admin/components/ProductGallerySection.d.ts.map +1 -0
  15. package/dist/admin/components/ProductGallerySection.js +385 -0
  16. package/dist/admin/components/ProductGallerySection.js.map +1 -0
  17. package/dist/admin/components/ProductOrderRulesCard.d.ts +19 -0
  18. package/dist/admin/components/ProductOrderRulesCard.d.ts.map +1 -0
  19. package/dist/admin/components/ProductOrderRulesCard.js +275 -0
  20. package/dist/admin/components/ProductOrderRulesCard.js.map +1 -0
  21. package/dist/admin/components/ProductScopeControls.d.ts +31 -0
  22. package/dist/admin/components/ProductScopeControls.d.ts.map +1 -0
  23. package/dist/admin/components/ProductScopeControls.js +243 -0
  24. package/dist/admin/components/ProductScopeControls.js.map +1 -0
  25. package/dist/admin/components/ProductScopeEditor.d.ts +12 -18
  26. package/dist/admin/components/ProductScopeEditor.d.ts.map +1 -1
  27. package/dist/admin/components/ProductScopeEditor.js +5 -4
  28. package/dist/admin/components/ProductScopeEditor.js.map +1 -1
  29. package/dist/admin/components/ProductScopeOverview.d.ts +26 -0
  30. package/dist/admin/components/ProductScopeOverview.d.ts.map +1 -0
  31. package/dist/admin/components/ProductScopeOverview.js +207 -0
  32. package/dist/admin/components/ProductScopeOverview.js.map +1 -0
  33. package/dist/admin/components/ProductStatusPills.d.ts +17 -0
  34. package/dist/admin/components/ProductStatusPills.d.ts.map +1 -0
  35. package/dist/admin/components/ProductStatusPills.js +23 -0
  36. package/dist/admin/components/ProductStatusPills.js.map +1 -0
  37. package/dist/admin/components/ProductUrlKeysPanel.d.ts +17 -0
  38. package/dist/admin/components/ProductUrlKeysPanel.d.ts.map +1 -0
  39. package/dist/admin/components/ProductUrlKeysPanel.js +215 -0
  40. package/dist/admin/components/ProductUrlKeysPanel.js.map +1 -0
  41. package/dist/admin/components/ProductsBulkEditDialog.d.ts +30 -0
  42. package/dist/admin/components/ProductsBulkEditDialog.d.ts.map +1 -1
  43. package/dist/admin/components/ProductsBulkEditDialog.js +308 -125
  44. package/dist/admin/components/ProductsBulkEditDialog.js.map +1 -1
  45. package/dist/admin/components/ScopedDialogParts.d.ts +23 -0
  46. package/dist/admin/components/ScopedDialogParts.d.ts.map +1 -0
  47. package/dist/admin/components/ScopedDialogParts.js +16 -0
  48. package/dist/admin/components/ScopedDialogParts.js.map +1 -0
  49. package/dist/admin/index.d.ts +2 -2
  50. package/dist/admin/index.d.ts.map +1 -1
  51. package/dist/admin/index.js +9 -0
  52. package/dist/admin/index.js.map +1 -1
  53. package/dist/admin/lib/attribute-scope.d.ts +20 -0
  54. package/dist/admin/lib/attribute-scope.d.ts.map +1 -0
  55. package/dist/admin/lib/attribute-scope.js +18 -0
  56. package/dist/admin/lib/attribute-scope.js.map +1 -0
  57. package/dist/admin/lib/bulk-operation-log-text.d.ts +9 -0
  58. package/dist/admin/lib/bulk-operation-log-text.d.ts.map +1 -0
  59. package/dist/admin/lib/bulk-operation-log-text.js +13 -0
  60. package/dist/admin/lib/bulk-operation-log-text.js.map +1 -0
  61. package/dist/admin/lib/media-scopes.d.ts +41 -0
  62. package/dist/admin/lib/media-scopes.d.ts.map +1 -0
  63. package/dist/admin/lib/media-scopes.js +66 -0
  64. package/dist/admin/lib/media-scopes.js.map +1 -0
  65. package/dist/admin/lib/product-labels.d.ts +14 -0
  66. package/dist/admin/lib/product-labels.d.ts.map +1 -0
  67. package/dist/admin/lib/product-labels.js +27 -0
  68. package/dist/admin/lib/product-labels.js.map +1 -0
  69. package/dist/admin/lib/product-scope-drafts.d.ts +77 -0
  70. package/dist/admin/lib/product-scope-drafts.d.ts.map +1 -0
  71. package/dist/admin/lib/product-scope-drafts.js +133 -0
  72. package/dist/admin/lib/product-scope-drafts.js.map +1 -0
  73. package/dist/admin/lib/product-scopes-api.d.ts +40 -0
  74. package/dist/admin/lib/product-scopes-api.d.ts.map +1 -0
  75. package/dist/admin/lib/product-scopes-api.js +101 -0
  76. package/dist/admin/lib/product-scopes-api.js.map +1 -0
  77. package/dist/admin/lib/product-url-keys-api.d.ts +46 -0
  78. package/dist/admin/lib/product-url-keys-api.d.ts.map +1 -0
  79. package/dist/admin/lib/product-url-keys-api.js +110 -0
  80. package/dist/admin/lib/product-url-keys-api.js.map +1 -0
  81. package/dist/admin/lib/resolve-product-selection.d.ts +29 -1
  82. package/dist/admin/lib/resolve-product-selection.d.ts.map +1 -1
  83. package/dist/admin/lib/resolve-product-selection.js +42 -6
  84. package/dist/admin/lib/resolve-product-selection.js.map +1 -1
  85. package/dist/admin/lib/scope-overview.d.ts +74 -0
  86. package/dist/admin/lib/scope-overview.d.ts.map +1 -0
  87. package/dist/admin/lib/scope-overview.js +173 -0
  88. package/dist/admin/lib/scope-overview.js.map +1 -0
  89. package/dist/admin/pages/AttributesManager.d.ts.map +1 -1
  90. package/dist/admin/pages/AttributesManager.js +84 -7
  91. package/dist/admin/pages/AttributesManager.js.map +1 -1
  92. package/dist/admin/pages/BulkOperationDetailPage.d.ts.map +1 -1
  93. package/dist/admin/pages/BulkOperationDetailPage.js +4 -19
  94. package/dist/admin/pages/BulkOperationDetailPage.js.map +1 -1
  95. package/dist/admin/pages/ProductEditor.d.ts +0 -4
  96. package/dist/admin/pages/ProductEditor.d.ts.map +1 -1
  97. package/dist/admin/pages/ProductEditor.js +221 -374
  98. package/dist/admin/pages/ProductEditor.js.map +1 -1
  99. package/dist/admin/pages/ProductsList.d.ts +12 -0
  100. package/dist/admin/pages/ProductsList.d.ts.map +1 -1
  101. package/dist/admin/pages/ProductsList.js +105 -38
  102. package/dist/admin/pages/ProductsList.js.map +1 -1
  103. package/dist/backend/admin-search-provider.d.ts +1 -1
  104. package/dist/backend/admin-search-provider.d.ts.map +1 -1
  105. package/dist/backend/admin-search-provider.js +1 -2
  106. package/dist/backend/admin-search-provider.js.map +1 -1
  107. package/dist/backend/demo/reset.d.ts +1 -1
  108. package/dist/backend/demo/rows.d.ts +14 -3
  109. package/dist/backend/demo/rows.d.ts.map +1 -1
  110. package/dist/backend/demo/rows.js +24 -17
  111. package/dist/backend/demo/rows.js.map +1 -1
  112. package/dist/backend/demo/seed.d.ts.map +1 -1
  113. package/dist/backend/demo/seed.js +3 -6
  114. package/dist/backend/demo/seed.js.map +1 -1
  115. package/dist/backend/entities/bulk-operation.entity.d.ts +10 -0
  116. package/dist/backend/entities/bulk-operation.entity.d.ts.map +1 -1
  117. package/dist/backend/entities/bulk-operation.entity.js.map +1 -1
  118. package/dist/backend/entities/gallery-item-channel-hidden.entity.d.ts +14 -0
  119. package/dist/backend/entities/gallery-item-channel-hidden.entity.d.ts.map +1 -0
  120. package/dist/backend/entities/gallery-item-channel-hidden.entity.js +42 -0
  121. package/dist/backend/entities/gallery-item-channel-hidden.entity.js.map +1 -0
  122. package/dist/backend/entities/gallery-item-channel-label.entity.d.ts +18 -0
  123. package/dist/backend/entities/gallery-item-channel-label.entity.d.ts.map +1 -0
  124. package/dist/backend/entities/gallery-item-channel-label.entity.js +49 -0
  125. package/dist/backend/entities/gallery-item-channel-label.entity.js.map +1 -0
  126. package/dist/backend/entities/gallery-item.entity.d.ts +8 -1
  127. package/dist/backend/entities/gallery-item.entity.d.ts.map +1 -1
  128. package/dist/backend/entities/gallery-item.entity.js +11 -0
  129. package/dist/backend/entities/gallery-item.entity.js.map +1 -1
  130. package/dist/backend/entities/product-attachment-channel-hidden.entity.d.ts +13 -0
  131. package/dist/backend/entities/product-attachment-channel-hidden.entity.d.ts.map +1 -0
  132. package/dist/backend/entities/product-attachment-channel-hidden.entity.js +41 -0
  133. package/dist/backend/entities/product-attachment-channel-hidden.entity.js.map +1 -0
  134. package/dist/backend/entities/product-attachment.entity.d.ts +8 -1
  135. package/dist/backend/entities/product-attachment.entity.d.ts.map +1 -1
  136. package/dist/backend/entities/product-attachment.entity.js +15 -0
  137. package/dist/backend/entities/product-attachment.entity.js.map +1 -1
  138. package/dist/backend/entities/product-channel-language-scope.entity.d.ts +23 -0
  139. package/dist/backend/entities/product-channel-language-scope.entity.d.ts.map +1 -0
  140. package/dist/backend/entities/product-channel-language-scope.entity.js +61 -0
  141. package/dist/backend/entities/product-channel-language-scope.entity.js.map +1 -0
  142. package/dist/backend/entities/product-channel-scope.entity.d.ts +42 -0
  143. package/dist/backend/entities/product-channel-scope.entity.d.ts.map +1 -0
  144. package/dist/backend/entities/product-channel-scope.entity.js +104 -0
  145. package/dist/backend/entities/product-channel-scope.entity.js.map +1 -0
  146. package/dist/backend/entities/product-packaging-unit.entity.d.ts +13 -1
  147. package/dist/backend/entities/product-packaging-unit.entity.d.ts.map +1 -1
  148. package/dist/backend/entities/product-packaging-unit.entity.js +20 -0
  149. package/dist/backend/entities/product-packaging-unit.entity.js.map +1 -1
  150. package/dist/backend/entities/product-url-key.entity.d.ts +32 -0
  151. package/dist/backend/entities/product-url-key.entity.d.ts.map +1 -0
  152. package/dist/backend/entities/product-url-key.entity.js +75 -0
  153. package/dist/backend/entities/product-url-key.entity.js.map +1 -0
  154. package/dist/backend/entities/product-url-redirect.entity.d.ts +23 -0
  155. package/dist/backend/entities/product-url-redirect.entity.d.ts.map +1 -0
  156. package/dist/backend/entities/product-url-redirect.entity.js +58 -0
  157. package/dist/backend/entities/product-url-redirect.entity.js.map +1 -0
  158. package/dist/backend/entities/product-variant.entity.d.ts +1 -2
  159. package/dist/backend/entities/product-variant.entity.d.ts.map +1 -1
  160. package/dist/backend/entities/product-variant.entity.js +0 -5
  161. package/dist/backend/entities/product-variant.entity.js.map +1 -1
  162. package/dist/backend/entities/product.entity.d.ts +41 -2
  163. package/dist/backend/entities/product.entity.d.ts.map +1 -1
  164. package/dist/backend/entities/product.entity.js +84 -1
  165. package/dist/backend/entities/product.entity.js.map +1 -1
  166. package/dist/backend/index.d.ts +27 -6
  167. package/dist/backend/index.d.ts.map +1 -1
  168. package/dist/backend/index.js +209 -15
  169. package/dist/backend/index.js.map +1 -1
  170. package/dist/backend/plugin.d.ts +45 -4
  171. package/dist/backend/plugin.d.ts.map +1 -1
  172. package/dist/backend/plugin.js +67 -9
  173. package/dist/backend/plugin.js.map +1 -1
  174. package/dist/backend/prompt-tools.d.ts +10 -0
  175. package/dist/backend/prompt-tools.d.ts.map +1 -1
  176. package/dist/backend/prompt-tools.js +108 -4
  177. package/dist/backend/prompt-tools.js.map +1 -1
  178. package/dist/backend/routes.admin.d.ts +29 -0
  179. package/dist/backend/routes.admin.d.ts.map +1 -1
  180. package/dist/backend/routes.admin.js +161 -55
  181. package/dist/backend/routes.admin.js.map +1 -1
  182. package/dist/backend/routes.admin.url-keys.d.ts +23 -0
  183. package/dist/backend/routes.admin.url-keys.d.ts.map +1 -0
  184. package/dist/backend/routes.admin.url-keys.js +14 -0
  185. package/dist/backend/routes.admin.url-keys.js.map +1 -0
  186. package/dist/backend/routes.api-key.d.ts.map +1 -1
  187. package/dist/backend/routes.api-key.js +14 -1
  188. package/dist/backend/routes.api-key.js.map +1 -1
  189. package/dist/backend/routes.external.d.ts.map +1 -1
  190. package/dist/backend/routes.external.js +6 -1
  191. package/dist/backend/routes.external.js.map +1 -1
  192. package/dist/backend/routes.public.d.ts +24 -7
  193. package/dist/backend/routes.public.d.ts.map +1 -1
  194. package/dist/backend/routes.public.js +58 -29
  195. package/dist/backend/routes.public.js.map +1 -1
  196. package/dist/backend/routes.public.url-keys.d.ts +26 -0
  197. package/dist/backend/routes.public.url-keys.d.ts.map +1 -0
  198. package/dist/backend/routes.public.url-keys.js +17 -0
  199. package/dist/backend/routes.public.url-keys.js.map +1 -0
  200. package/dist/backend/services/asset-references.js +43 -30
  201. package/dist/backend/services/asset-references.js.map +1 -1
  202. package/dist/backend/services/attachment-packaging-scopes.d.ts +43 -0
  203. package/dist/backend/services/attachment-packaging-scopes.d.ts.map +1 -0
  204. package/dist/backend/services/attachment-packaging-scopes.js +115 -0
  205. package/dist/backend/services/attachment-packaging-scopes.js.map +1 -0
  206. package/dist/backend/services/attachment.service.d.ts +12 -1
  207. package/dist/backend/services/attachment.service.d.ts.map +1 -1
  208. package/dist/backend/services/attachment.service.js +119 -21
  209. package/dist/backend/services/attachment.service.js.map +1 -1
  210. package/dist/backend/services/attribute-scope-preview.d.ts +38 -0
  211. package/dist/backend/services/attribute-scope-preview.d.ts.map +1 -0
  212. package/dist/backend/services/attribute-scope-preview.js +66 -0
  213. package/dist/backend/services/attribute-scope-preview.js.map +1 -0
  214. package/dist/backend/services/bulk-operation.service.d.ts +36 -0
  215. package/dist/backend/services/bulk-operation.service.d.ts.map +1 -1
  216. package/dist/backend/services/bulk-operation.service.js +203 -36
  217. package/dist/backend/services/bulk-operation.service.js.map +1 -1
  218. package/dist/backend/services/bundle.service.d.ts +9 -1
  219. package/dist/backend/services/bundle.service.d.ts.map +1 -1
  220. package/dist/backend/services/bundle.service.js +12 -2
  221. package/dist/backend/services/bundle.service.js.map +1 -1
  222. package/dist/backend/services/catalog-admin-search.service.d.ts +1 -1
  223. package/dist/backend/services/catalog-admin-search.service.js +1 -1
  224. package/dist/backend/services/catalog-admin.service.d.ts +125 -18
  225. package/dist/backend/services/catalog-admin.service.d.ts.map +1 -1
  226. package/dist/backend/services/catalog-admin.service.js +367 -164
  227. package/dist/backend/services/catalog-admin.service.js.map +1 -1
  228. package/dist/backend/services/catalog-bulk-import.service.d.ts +24 -2
  229. package/dist/backend/services/catalog-bulk-import.service.d.ts.map +1 -1
  230. package/dist/backend/services/catalog-bulk-import.service.js +132 -6
  231. package/dist/backend/services/catalog-bulk-import.service.js.map +1 -1
  232. package/dist/backend/services/catalog-bulk-update.service.d.ts +32 -4
  233. package/dist/backend/services/catalog-bulk-update.service.d.ts.map +1 -1
  234. package/dist/backend/services/catalog-bulk-update.service.js +115 -12
  235. package/dist/backend/services/catalog-bulk-update.service.js.map +1 -1
  236. package/dist/backend/services/catalog-org-price-decorator.d.ts +18 -27
  237. package/dist/backend/services/catalog-org-price-decorator.d.ts.map +1 -1
  238. package/dist/backend/services/catalog-org-price-decorator.js +77 -33
  239. package/dist/backend/services/catalog-org-price-decorator.js.map +1 -1
  240. package/dist/backend/services/catalog-product-filter.service.d.ts +16 -2
  241. package/dist/backend/services/catalog-product-filter.service.d.ts.map +1 -1
  242. package/dist/backend/services/catalog-product-filter.service.js +80 -3
  243. package/dist/backend/services/catalog-product-filter.service.js.map +1 -1
  244. package/dist/backend/services/catalog-product-read.service.d.ts +45 -3
  245. package/dist/backend/services/catalog-product-read.service.d.ts.map +1 -1
  246. package/dist/backend/services/catalog-product-read.service.js +130 -3
  247. package/dist/backend/services/catalog-product-read.service.js.map +1 -1
  248. package/dist/backend/services/catalog-query.service.d.ts +145 -40
  249. package/dist/backend/services/catalog-query.service.d.ts.map +1 -1
  250. package/dist/backend/services/catalog-query.service.js +1048 -391
  251. package/dist/backend/services/catalog-query.service.js.map +1 -1
  252. package/dist/backend/services/catalog-quick-search.service.d.ts +18 -2
  253. package/dist/backend/services/catalog-quick-search.service.d.ts.map +1 -1
  254. package/dist/backend/services/catalog-quick-search.service.js +52 -20
  255. package/dist/backend/services/catalog-quick-search.service.js.map +1 -1
  256. package/dist/backend/services/catalog-write-ports.d.ts +18 -1
  257. package/dist/backend/services/catalog-write-ports.d.ts.map +1 -1
  258. package/dist/backend/services/catalog-write-ports.js +77 -0
  259. package/dist/backend/services/catalog-write-ports.js.map +1 -1
  260. package/dist/backend/services/category-admin.service.d.ts +12 -1
  261. package/dist/backend/services/category-admin.service.d.ts.map +1 -1
  262. package/dist/backend/services/category-admin.service.js +23 -2
  263. package/dist/backend/services/category-admin.service.js.map +1 -1
  264. package/dist/backend/services/channel-url-facts.d.ts +17 -0
  265. package/dist/backend/services/channel-url-facts.d.ts.map +1 -0
  266. package/dist/backend/services/channel-url-facts.js +20 -0
  267. package/dist/backend/services/channel-url-facts.js.map +1 -0
  268. package/dist/backend/services/effective-value.sql.d.ts +56 -0
  269. package/dist/backend/services/effective-value.sql.d.ts.map +1 -0
  270. package/dist/backend/services/effective-value.sql.js +111 -0
  271. package/dist/backend/services/effective-value.sql.js.map +1 -0
  272. package/dist/backend/services/gallery-scopes.d.ts +40 -0
  273. package/dist/backend/services/gallery-scopes.d.ts.map +1 -0
  274. package/dist/backend/services/gallery-scopes.js +151 -0
  275. package/dist/backend/services/gallery-scopes.js.map +1 -0
  276. package/dist/backend/services/gallery.service.d.ts +46 -4
  277. package/dist/backend/services/gallery.service.d.ts.map +1 -1
  278. package/dist/backend/services/gallery.service.js +308 -46
  279. package/dist/backend/services/gallery.service.js.map +1 -1
  280. package/dist/backend/services/linkable-asset.d.ts +21 -0
  281. package/dist/backend/services/linkable-asset.d.ts.map +1 -0
  282. package/dist/backend/services/linkable-asset.js +31 -0
  283. package/dist/backend/services/linkable-asset.js.map +1 -0
  284. package/dist/backend/services/packaging-unit.service.d.ts.map +1 -1
  285. package/dist/backend/services/packaging-unit.service.js +95 -29
  286. package/dist/backend/services/packaging-unit.service.js.map +1 -1
  287. package/dist/backend/services/primary-asset-url.d.ts +7 -1
  288. package/dist/backend/services/primary-asset-url.d.ts.map +1 -1
  289. package/dist/backend/services/primary-asset-url.js +45 -14
  290. package/dist/backend/services/primary-asset-url.js.map +1 -1
  291. package/dist/backend/services/product-availability.service.d.ts +79 -0
  292. package/dist/backend/services/product-availability.service.d.ts.map +1 -0
  293. package/dist/backend/services/product-availability.service.js +223 -0
  294. package/dist/backend/services/product-availability.service.js.map +1 -0
  295. package/dist/backend/services/product-availability.sql.d.ts +71 -0
  296. package/dist/backend/services/product-availability.sql.d.ts.map +1 -0
  297. package/dist/backend/services/product-availability.sql.js +77 -0
  298. package/dist/backend/services/product-availability.sql.js.map +1 -0
  299. package/dist/backend/services/product-link.service.d.ts +10 -9
  300. package/dist/backend/services/product-link.service.d.ts.map +1 -1
  301. package/dist/backend/services/product-link.service.js +48 -23
  302. package/dist/backend/services/product-link.service.js.map +1 -1
  303. package/dist/backend/services/product-overrides.service.d.ts +9 -2
  304. package/dist/backend/services/product-overrides.service.d.ts.map +1 -1
  305. package/dist/backend/services/product-overrides.service.js +13 -6
  306. package/dist/backend/services/product-overrides.service.js.map +1 -1
  307. package/dist/backend/services/product-page-revalidation.d.ts +51 -0
  308. package/dist/backend/services/product-page-revalidation.d.ts.map +1 -0
  309. package/dist/backend/services/product-page-revalidation.js +146 -0
  310. package/dist/backend/services/product-page-revalidation.js.map +1 -0
  311. package/dist/backend/services/product-scope-context.service.d.ts.map +1 -1
  312. package/dist/backend/services/product-scope-context.service.js +3 -2
  313. package/dist/backend/services/product-scope-context.service.js.map +1 -1
  314. package/dist/backend/services/product-scopes.service.d.ts +212 -0
  315. package/dist/backend/services/product-scopes.service.d.ts.map +1 -0
  316. package/dist/backend/services/product-scopes.service.js +638 -0
  317. package/dist/backend/services/product-scopes.service.js.map +1 -0
  318. package/dist/backend/services/product-summary-text.d.ts +8 -0
  319. package/dist/backend/services/product-summary-text.d.ts.map +1 -0
  320. package/dist/backend/services/product-summary-text.js +8 -0
  321. package/dist/backend/services/product-summary-text.js.map +1 -0
  322. package/dist/backend/services/product-value-resolver.service.d.ts +11 -1
  323. package/dist/backend/services/product-value-resolver.service.d.ts.map +1 -1
  324. package/dist/backend/services/product-value-resolver.service.js +29 -9
  325. package/dist/backend/services/product-value-resolver.service.js.map +1 -1
  326. package/dist/backend/services/publication-window-sweep.d.ts +77 -0
  327. package/dist/backend/services/publication-window-sweep.d.ts.map +1 -0
  328. package/dist/backend/services/publication-window-sweep.js +117 -0
  329. package/dist/backend/services/publication-window-sweep.js.map +1 -0
  330. package/dist/backend/services/scope-completeness.d.ts +107 -0
  331. package/dist/backend/services/scope-completeness.d.ts.map +1 -0
  332. package/dist/backend/services/scope-completeness.js +180 -0
  333. package/dist/backend/services/scope-completeness.js.map +1 -0
  334. package/dist/backend/services/scope-overview.service.d.ts +112 -0
  335. package/dist/backend/services/scope-overview.service.d.ts.map +1 -0
  336. package/dist/backend/services/scope-overview.service.js +372 -0
  337. package/dist/backend/services/scope-overview.service.js.map +1 -0
  338. package/dist/backend/services/sql-id-arrays.d.ts +16 -0
  339. package/dist/backend/services/sql-id-arrays.d.ts.map +1 -0
  340. package/dist/backend/services/sql-id-arrays.js +24 -0
  341. package/dist/backend/services/sql-id-arrays.js.map +1 -0
  342. package/dist/backend/services/storefront-value-overrides.d.ts +31 -0
  343. package/dist/backend/services/storefront-value-overrides.d.ts.map +1 -0
  344. package/dist/backend/services/storefront-value-overrides.js +48 -0
  345. package/dist/backend/services/storefront-value-overrides.js.map +1 -0
  346. package/dist/backend/services/url-key-resolution.service.d.ts +76 -0
  347. package/dist/backend/services/url-key-resolution.service.d.ts.map +1 -0
  348. package/dist/backend/services/url-key-resolution.service.js +179 -0
  349. package/dist/backend/services/url-key-resolution.service.js.map +1 -0
  350. package/dist/backend/services/url-key.service.d.ts +171 -0
  351. package/dist/backend/services/url-key.service.d.ts.map +1 -0
  352. package/dist/backend/services/url-key.service.js +738 -0
  353. package/dist/backend/services/url-key.service.js.map +1 -0
  354. package/dist/manifest.d.ts +3 -1
  355. package/dist/manifest.d.ts.map +1 -1
  356. package/dist/manifest.js +188 -13
  357. package/dist/manifest.js.map +1 -1
  358. package/dist/migrations/20261016T082008_catalog_order_rules.d.ts +22 -0
  359. package/dist/migrations/20261016T082008_catalog_order_rules.d.ts.map +1 -0
  360. package/dist/migrations/20261016T082008_catalog_order_rules.js +48 -0
  361. package/dist/migrations/20261016T082008_catalog_order_rules.js.map +1 -0
  362. package/dist/migrations/20261022T035133_catalog_product_scopes.d.ts +28 -0
  363. package/dist/migrations/20261022T035133_catalog_product_scopes.d.ts.map +1 -0
  364. package/dist/migrations/20261022T035133_catalog_product_scopes.js +92 -0
  365. package/dist/migrations/20261022T035133_catalog_product_scopes.js.map +1 -0
  366. package/dist/migrations/20261022T054223_catalog_product_url_keys.d.ts +32 -0
  367. package/dist/migrations/20261022T054223_catalog_product_url_keys.d.ts.map +1 -0
  368. package/dist/migrations/20261022T054223_catalog_product_url_keys.js +81 -0
  369. package/dist/migrations/20261022T054223_catalog_product_url_keys.js.map +1 -0
  370. package/dist/migrations/20261022T111811_catalog_price_fields_removed.d.ts +26 -0
  371. package/dist/migrations/20261022T111811_catalog_price_fields_removed.d.ts.map +1 -0
  372. package/dist/migrations/20261022T111811_catalog_price_fields_removed.js +32 -0
  373. package/dist/migrations/20261022T111811_catalog_price_fields_removed.js.map +1 -0
  374. package/dist/migrations/20261022T182523_catalog_admin_name_keys.d.ts +38 -0
  375. package/dist/migrations/20261022T182523_catalog_admin_name_keys.d.ts.map +1 -0
  376. package/dist/migrations/20261022T182523_catalog_admin_name_keys.js +89 -0
  377. package/dist/migrations/20261022T182523_catalog_admin_name_keys.js.map +1 -0
  378. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.d.ts +34 -0
  379. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.d.ts.map +1 -0
  380. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.js +57 -0
  381. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.js.map +1 -0
  382. package/dist/migrations/20261026T033453_catalog_product_media_scopes.d.ts +26 -0
  383. package/dist/migrations/20261026T033453_catalog_product_media_scopes.d.ts.map +1 -0
  384. package/dist/migrations/20261026T033453_catalog_product_media_scopes.js +54 -0
  385. package/dist/migrations/20261026T033453_catalog_product_media_scopes.js.map +1 -0
  386. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.d.ts +27 -0
  387. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.d.ts.map +1 -0
  388. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.js +45 -0
  389. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.js.map +1 -0
  390. package/dist/migrations/index.d.ts +9 -1
  391. package/dist/migrations/index.d.ts.map +1 -1
  392. package/dist/migrations/index.js +17 -1
  393. package/dist/migrations/index.js.map +1 -1
  394. package/docs/catalog/attachments.md +46 -4
  395. package/docs/catalog/attributes.md +11 -6
  396. package/docs/catalog/gallery-and-labels.md +63 -4
  397. package/docs/catalog/packaging-units.md +82 -8
  398. package/docs/catalog/per-channel-per-language-overrides.md +195 -10
  399. package/docs/catalog/url-keys-and-redirects.md +142 -0
  400. package/docs/catalog.md +326 -17
  401. package/i18n/en.json +931 -53
  402. package/i18n/pl.json +930 -52
  403. package/package.json +10 -10
@@ -20,6 +20,13 @@ language-scoped via a backend constant
20
20
  (`SYSTEM_ATTRIBUTE_SCOPES`). User-defined attributes default to
21
21
  global-only and opt in via the attribute editor.
22
22
 
23
+ The same scopes also decide **where a product is available**: its status,
24
+ publication window, audience and order rules can differ per Sales Channel,
25
+ and its status per channel × language. That is described in
26
+ *Availability per sales channel and language* below. A product's URL keys per
27
+ language and per channel × language have their own page,
28
+ [URL Keys and Redirects](./url-keys-and-redirects.md).
29
+
23
30
  ## Why
24
31
 
25
32
  A B2B catalog routinely needs to overlay channel-specific marketing
@@ -159,7 +166,7 @@ additive.
159
166
 
160
167
  ## Read paths
161
168
 
162
- Three consumers go through the resolver:
169
+ These consumers go through the resolver:
163
170
 
164
171
  - **Admin endpoint** — `GET /api/v1/admin/catalog/products/:id?channelId=&languageCode=&includeOverridesMap=true`
165
172
  returns the baseline product PLUS, when context params are passed, a
@@ -168,13 +175,45 @@ Three consumers go through the resolver:
168
175
  is attached for client-side switcher previews.
169
176
  - **Storefront public read** — pulls the channel from the
170
177
  `x-sales-channel` header (the existing convention) and
171
- the language from `Accept-Language`. The override layer is invisible
172
- to the public client.
178
+ the language from `Accept-Language`, else the channel's default
179
+ language. The override layer is invisible to the public client: it
180
+ receives the effective value. The product page (name, description,
181
+ SEO fields, attribute values, the product-page attribute list, grouped
182
+ children and bundle options) and every listing card walk the storefront's own baseline language pick — requested
183
+ language, then the channel's default language, then `en-US`, `en` and
184
+ the first stored language — and at each language take the
185
+ `(channel + language)` slot if it is filled, else stop there if the
186
+ baseline has text for that language. An override therefore answers
187
+ only for the language whose baseline text the page would show, or an
188
+ earlier one in that order: a request in `en-US` on a channel whose
189
+ default is `pl-PL` shows the `en-US` baseline, not the `pl-PL`
190
+ override, while a `de-DE` request for a product with no `de-DE` text
191
+ falls through to `pl-PL` and shows its override. The `(channel-only)`
192
+ slot is asked last and wins over the baseline wherever the walk
193
+ stopped. Product-link tiles keep their own language pick, which has
194
+ no channel-default leg, and walk the override slots over it, so a
195
+ tile can show the `en-US` baseline where the listing card shows the
196
+ channel default's override. A product without overrides shows exactly what
197
+ it showed before. On the listing's Postgres path, `sort=name` orders by
198
+ the effective name at the request's channel and language (ties by id),
199
+ free text `q` matches the effective name and the effective values of
200
+ searchable attributes, and `filter[attr.*]` and the facet counts use the
201
+ channel's effective values at the request language. When the `search`
202
+ module answers the listing, it sorts by the name indexed in the channel's
203
+ default language (see the `search` module's page).
173
204
  - **Search indexer (Meilisearch)** — builds one document per
174
205
  `(product, channel)` pair. Each document's `name` and `description`
175
206
  fields are run through the resolver with `channel.defaultLanguage`
176
207
  as the active language, so per-channel overrides flow into
177
- storefront search ranking.
208
+ storefront search ranking and name sorting.
209
+ - **Search result cards** — the search module re-reads every hit from
210
+ Postgres before it answers, and the card name it shows is resolved
211
+ there, not taken from the index: the request's sales channel override
212
+ rows are read once per results page and the card walks the same
213
+ languages and slots, in the same order, as a listing card above. The indexed name is
214
+ resolved for the channel's default language only, so it would be
215
+ wrong for a request in any other language. A product without an
216
+ override for the channel shows exactly what it showed before.
178
217
 
179
218
  ## Admin UI
180
219
 
@@ -192,7 +231,7 @@ The product edit page's **Details** tab gains a
192
231
  source badge per field — `channel + language override` / `channel
193
232
  override` / `global baseline (language)` / `global baseline
194
233
  (fallback)` / `no value`.
195
- 4. Offers "Add override" / "Edit override" / "Reset to Global"
234
+ 4. Offers "Add override" / "Edit override" / "Use inherited"
196
235
  affordances per field. Edits go through `PATCH /value-overrides`
197
236
  with optimistic refresh.
198
237
  5. Persists the editor's `(channel, language)` selection back via
@@ -203,6 +242,157 @@ Edit affordances are gated on a specific channel being selected.
203
242
  Under Global / no channel, the panel is read-only and a help string
204
243
  explains that overrides only apply per-channel.
205
244
 
245
+ ## Availability per sales channel and language
246
+
247
+ A product is **available** to a buyer at a sales channel C and language L when
248
+ all of these hold:
249
+
250
+ 1. it is a member of C and not archived;
251
+ 2. its effective **status** at (C, L) is `active`;
252
+ 3. now is inside its effective **publication window** (both ends included);
253
+ 4. its effective **audience** admits the buyer.
254
+
255
+ L is the first `Accept-Language` tag of the request matched to C's languages,
256
+ else C's default language. Every buyer-facing read asks this one rule — the
257
+ listing and its price range, facet and category counts, the product page,
258
+ product links, grouped children and bundle options, the quick search, search,
259
+ the sitemap, product feeds — and so do the places a product is acquired: the
260
+ basket, checkout and placement, quote requests, quick order and the external
261
+ order intake. A product that is not available answers exactly as a product
262
+ that does not exist (`404 PRODUCT_NOT_FOUND`); whether one exists, is off, is
263
+ outside its window or is restricted cannot be told apart. An archived product
264
+ is the exception described under *Product status and archiving* on the
265
+ [Catalog](../catalog.md#product-status-and-archiving) page.
266
+
267
+ ### Scopes and inheritance
268
+
269
+ | Field | Global | Sales channel | Channel × language |
270
+ | --- | --- | --- | --- |
271
+ | Status (`active` / `inactive`) | `products.status` | yes | yes |
272
+ | Publication window | `products.publish_from` / `publish_until` | yes | — |
273
+ | Audience (visibility and organisations) | `products.visibility` / `allowed_organization_ids` | yes | — |
274
+ | Minimum order quantity, returnable | `products` | yes | — |
275
+
276
+ Each field takes the value of the most specific scope that sets one: for the
277
+ status, channel × language, then channel, then global; for the others,
278
+ channel, then global. An unset scope **inherits** — there is no "empty"
279
+ value that switches something off. A product with no overrides behaves
280
+ exactly as before.
281
+
282
+ - **Status.** `inactive` at any scope is plain off there, and archiving is not a
283
+ status — see *Product status and archiving* on the
284
+ [Catalog](../catalog.md#product-status-and-archiving) page. A product off
285
+ globally and `active` in one channel is available in that channel only.
286
+ - **Publication window.** `from` and `until`, each optional (an open side);
287
+ both ends are included. A channel window replaces the global window as a
288
+ pair, even when both its sides are open. A window that does not start before
289
+ it ends is refused with `422 VALIDATION_FAILED` (`details.field = 'window'`).
290
+ The window is evaluated when a request is answered; nothing is written when
291
+ it opens or closes. A sweep (`catalog.publication-window.sweep`, every five
292
+ minutes) announces `product.updated.v1` with
293
+ `changedFields: ["publicationWindow"]` for each product whose window bound
294
+ was crossed, so caches and the search index catch up.
295
+ - **Audience.** The visibility mode and the organisation list are one value:
296
+ a channel's audience replaces the global rule whole, never merged with it.
297
+ Naming organisations that are not members of the channel is allowed and
298
+ answered with an `audience_non_members` warning.
299
+ - **Order rules.** See *Per sales channel* under *Order rules* on the
300
+ [Catalog](../catalog.md#per-sales-channel) page.
301
+
302
+ An override is honoured only where it can apply: one for a channel the product
303
+ has left, or for a language the channel no longer offers, is kept but ignored,
304
+ and listed as an orphan (below) until it is removed.
305
+
306
+ ### Writing the scopes
307
+
308
+ `GET /api/v1/admin/catalog/products/:id/scopes` (`catalog:read`) answers the
309
+ global values and, per channel, the overrides, the channel's languages and
310
+ whether the product is still a member. `PATCH` on the same path
311
+ (`catalog:write`) writes them:
312
+
313
+ ```json
314
+ {
315
+ "channels": [
316
+ {
317
+ "channelId": "<retail-uuid>",
318
+ "status": "active",
319
+ "window": { "from": "2026-11-01T00:00:00Z", "until": null },
320
+ "audience": null,
321
+ "languageStatuses": [{ "languageCode": "de-DE", "status": "inactive" }]
322
+ }
323
+ ],
324
+ "global": { "publishUntil": "2026-12-31T23:59:59Z" }
325
+ }
326
+ ```
327
+
328
+ An absent key is left as it is; `null` removes the override (use inherited).
329
+ A value for a channel the product is not in, or a language the channel does not
330
+ offer, is refused with `422 SCOPE_INVALID`; removing such an override is always
331
+ allowed. The global window can also be written with the product `PATCH`
332
+ (`publishFrom`, `publishUntil`).
333
+
334
+ Each request is one audited Command, `product.scopes.update`; sending its
335
+ before-state back through the same route restores it. The write announces
336
+ `product.updated.v1` with `changedFields` among `scopedStatus`,
337
+ `publicationWindow`, `audience` and `orderRules`. A status change that switches
338
+ the product on is subject to the completeness check — see the
339
+ [Catalog](../catalog.md#completeness-check-when-switching-a-product-on) page —
340
+ and `warnings` carries what it found. Imports and connectors write the same
341
+ scopes through `catalogProductScopeWritePort`, unchecked; the field-by-field
342
+ table is on the [URL Keys and Redirects](./url-keys-and-redirects.md#integrations)
343
+ page. Setting one channel's status on many products at once is the bulk edit's
344
+ *Status per channel and language* — see the
345
+ [Catalog](../catalog.md#status-per-channel-and-language-in-bulk) page.
346
+
347
+ In the product editor these are the **scope controls** under the channel
348
+ switcher on the Details tab (status per channel and per language, window,
349
+ audience) and **Order rules per channel** on the Inventory tab; all are
350
+ read-only without `catalog:write`.
351
+
352
+ ### Scope overview
353
+
354
+ `GET /api/v1/admin/catalog/products/:id/scope-overview` (`catalog:read`) lays a
355
+ product out as its channels × languages, and the product editor's **Scopes**
356
+ tab shows it. Each cell carries:
357
+
358
+ - the effective status and where it comes from (`channel_language`,
359
+ `channel` or `global`);
360
+ - whether the product is available there now — a member, the language offered,
361
+ on, inside its window, not archived; the audience is shown as a rule, not
362
+ evaluated for anybody;
363
+ - every field overridden at that cell and the level it comes from — `status`,
364
+ `window`, `audience`, `minOrderQuantity`, `returnable`, `name`,
365
+ `description`, `attribute:<key>`, `urlKey`, and the media, attachment,
366
+ packaging-unit and SEO fields set per channel or language;
367
+ - `missing` — what the completeness check would report there, whatever the
368
+ cell's status.
369
+
370
+ Overrides that no longer apply are listed under `orphans` with a reason:
371
+ `not_a_member`, `language_not_offered` or `attribute_scope_changed`. On the
372
+ Scopes tab a scope value, a value override or a URL key is returned to the
373
+ inherited value with **Use inherited** where it is set — a channel's own values
374
+ in its "Whole channel" column, a language's own values in the "Every channel"
375
+ row — and an orphan (listed under **No longer applies**) is deleted; the tab
376
+ calls the endpoint that owns the value (`…/scopes`, `…/value-overrides` or
377
+ `…/url-keys`). Resetting a text value (a name, a description, a URL key, an SEO
378
+ field) and deleting an orphan ask first, naming the field and the scope; other
379
+ values reset in one click. A product in no sales channel answers no channels and
380
+ every active platform language.
381
+
382
+ Before an attribute's `channelScoped` or `languageScoped` flag is turned off,
383
+ `GET /api/v1/admin/catalog/attributes/:idOrKey/scope-change-preview?channelScoped=&languageScoped=`
384
+ answers how many value overrides would stop applying, in total and per
385
+ channel. The change keeps the rows; they become orphans.
386
+
387
+ ### Storage
388
+
389
+ `product_channel_scopes` holds one row per product and channel with the status,
390
+ window, audience, minimum order quantity and returnable flag (`NULL` inherits);
391
+ `product_channel_language_scopes` holds the status per channel × language.
392
+ Both cascade on the product's and the channel's delete
393
+ (`20261022T035133_catalog_product_scopes.ts`, with the global window columns
394
+ `products.publish_from` and `publish_until`; no backfill).
395
+
206
396
  ## Migration
207
397
 
208
398
  One migration `20260611T140346_catalog_product_value_overrides_init.ts` ships everything:
@@ -223,11 +413,6 @@ exact inverse — drop the two tables and the two columns.
223
413
  surfaces only the system Name + Description today. User attribute
224
414
  overrides are accepted by the PATCH endpoint and resolved on read,
225
415
  but the admin SPA does not yet expose a write affordance for them.
226
- - **Storefront public read shape change** — `products.name` and
227
- `products.description` still ship as `Record<lang, string>` JSONB
228
- on the public catalog endpoint. Switching to a resolved scalar is
229
- a breaking change for storefront consumers and is scoped as a
230
- follow-up.
231
416
  - **Channel-aware reindex enqueue** — the PATCH endpoint does not
232
417
  yet enqueue a Meilisearch reindex job per touched channel; the
233
418
  next per-product upsert (driven by any catalog mutation) picks it
@@ -0,0 +1,142 @@
1
+ ---
2
+ title: URL Keys and Redirects
3
+ ---
4
+
5
+ # URL Keys and Redirects
6
+
7
+ A product's storefront address is `/p/<key>`. The key can differ per language, and per sales
8
+ channel and language:
9
+
10
+ - **global key** — the product's `slug`; it is the key in every language where the product has no
11
+ key of its own;
12
+ - **language key** — one per language, for every sales channel;
13
+ - **sales channel × language key** — one per channel and language, overriding the language key there.
14
+
15
+ The **effective key** at a sales channel and language is the channel × language key, else the
16
+ language key, else the global key. Every product URL the platform emits — the storefront's
17
+ canonical and alternate-language links, the sitemap, a redirect target, the preview address in the
18
+ admin — uses the effective key, with `?lang=<language>` when the language is not the channel's
19
+ default.
20
+
21
+ A key is valid only in its own language, and is unique per language across all sales channels:
22
+ no two products share a key in one language. Changing a key keeps the previous one as a permanent
23
+ redirect in its language, straight to the current key; redirects are kept until an operator deletes
24
+ them. Redirects are served while the `seo` module is switched on; with `seo` off an old key answers
25
+ "not found", and the redirects come back when `seo` is switched on. A product's other **current** keys
26
+ are not redirects: with `seo` off too, a request for its language or global key where a channel ×
27
+ language key overrides it, or for another channel's key, still leads to its URL in that channel.
28
+
29
+ ## Managing keys
30
+
31
+ In the product editor, the **URL keys** panel on the SEO tab shows the global key, a key per
32
+ language and a key per sales channel and language — an empty field uses the inherited key — and the
33
+ storefront URL each channel and language ends up with. While the `seo` module is on it also lists
34
+ the redirects the old keys keep.
35
+
36
+ `GET /api/v1/admin/catalog/products/:id/url-keys` (`catalog:read`) answers the same, and `PUT` on
37
+ the same path (`catalog:write`) writes it:
38
+
39
+ ```json
40
+ {
41
+ "globalKey": "cordless-drill",
42
+ "languageKeys": [{ "languageCode": "de-DE", "key": "akku-bohrschrauber" }],
43
+ "channelKeys": [{ "channelId": "<retail-uuid>", "languageCode": "pl-PL", "key": null }]
44
+ }
45
+ ```
46
+
47
+ A list or key left out is unchanged; `key: null` removes the key at that scope, so the inherited
48
+ key applies there again. A key is lower-case kebab case, at most 160 characters. A key for a sales
49
+ channel the product is not in, or a language the channel does not offer, is refused with
50
+ `422 SCOPE_INVALID`; a key left behind by a channel the product has left is shown as **No longer applies**
51
+ and can be removed.
52
+
53
+ - **A key another product holds** in that language is refused with `409 URL_KEY_TAKEN`, naming the
54
+ product (`details.conflicts`). A deleted product's global key stays taken; its language and
55
+ channel keys are released.
56
+ - **A key that is another product's redirect** answers `409 URL_KEY_REDIRECT_TAKEOVER_REQUIRED`,
57
+ naming the product that would lose the redirect (`details.takeovers`). Sending the same request
58
+ again with the key in `confirmTakeover` takes it over. Only an operator can do this; an
59
+ integration never takes over a redirect.
60
+ - **A changed key stays as a redirect** in its language, pointing at the product, not at a key, so
61
+ redirects never chain. A redirect is kept until an operator deletes it:
62
+ `DELETE /api/v1/admin/catalog/products/:id/url-redirects/:redirectId` (`catalog:write`). Deleting
63
+ a product removes its redirects. While `seo` is off the answer leaves `redirects` out, but the
64
+ rows stay and keep reserving their keys.
65
+
66
+ A `PUT` is one audited Command, `product.url_keys.update`, whose before-state sent back through the
67
+ same route restores the keys; a redirect delete is `product.url_redirect.delete`. Both announce
68
+ `product.updated.v1` with `changedFields: ["urlKeys"]`. A new or duplicated product's global key is
69
+ chosen free of every live product's language, channel and redirect keys.
70
+
71
+ ## On the storefront
72
+
73
+ `GET /api/v1/catalog/products/resolve/:key` resolves a key at the request's sales channel and
74
+ language:
75
+
76
+ - the product's effective key there answers `{ kind: "product", productId, key }`;
77
+ - any other current key of the product in that language, and its redirects there (a former global
78
+ key counts in every language), answer `{ kind: "redirect", key, languageCode, path }`, `path`
79
+ being the product's URL to redirect to permanently;
80
+ - a key of no product, a key of another language, and a product that is not available to the caller
81
+ there all answer the same `404 PRODUCT_NOT_FOUND`; an archived product answers
82
+ `410 PRODUCT_ARCHIVED`.
83
+
84
+ `GET /api/v1/catalog/products/:idOrSlug` accepts an id, a current key in the request's language, or
85
+ a product's global key — never a redirect. The product detail carries
86
+ `paths: { canonical, alternates }`: the page's URL at the request's channel and language, and one
87
+ per channel language where the product is available to anonymous visitors. `slug` on the listing,
88
+ the product detail, grouped and bundle children and product-link tiles is the effective key at the
89
+ request's channel and language.
90
+
91
+ ## Errors
92
+
93
+ | Code | Status | When |
94
+ | --- | --- | --- |
95
+ | `URL_KEY_TAKEN` | 409 | The key is another product's key in that language |
96
+ | `URL_KEY_REDIRECT_TAKEOVER_REQUIRED` | 409 | The key is another product's redirect and the write did not confirm the takeover |
97
+ | `URL_REDIRECT_NOT_FOUND` | 404 | `:redirectId` is not a redirect of the product |
98
+ | `SCOPE_INVALID` | 422 | A key for a channel the product is not in, or a language the channel does not offer |
99
+ | `PRODUCT_NOT_FOUND` | 404 | The storefront resolve found no product available to the caller |
100
+ | `PRODUCT_ARCHIVED` | 410 | The storefront resolve found an archived product |
101
+
102
+ ## Integrations
103
+
104
+ What a connector, a PIM synchronisation or a spreadsheet writes, and at which scope. An integration
105
+ writes only the scopes it names: writing a global value never removes an operator's override at a
106
+ sales channel or language (FR-091).
107
+
108
+ | Field | Scope it is written at | Through |
109
+ | --- | --- | --- |
110
+ | Status | sales channel, or sales channel × language | `catalogProductScopeWritePort.applyScopes` `status`; the products CSV columns `status@<channel code>` and `status@<channel code>/<language>` |
111
+ | Global status, visibility, name, description | global (name and description per language) | `catalogProductWritePort`; the products CSV's `status`, `visibility`, `name_en`, `description_en` |
112
+ | Publication window | global, or sales channel | `applyScopes` `window` (`channelId: null` is the global window) |
113
+ | Audience (visibility and organisations) | sales channel | `applyScopes` `audience` |
114
+ | Minimum order quantity, returnable | sales channel | `applyScopes` `orderRules` |
115
+ | URL key | language, or sales channel × language | `applyScopes` `urlKeys` (`channelId: null` is the language key) |
116
+ | Channel- or language-scoped attribute values | sales channel, language, or both | `catalogProductValueOverrideWritePort` |
117
+ | SEO title and description | language | `seoMetaWritePort` — sales channel SEO overrides are the operator's |
118
+
119
+ `null` as a value means "use inherited": the override at that scope is removed. A field the input
120
+ does not name is left as it is.
121
+
122
+ **URL keys from an integration are never forced.** A key that is another product's key in that
123
+ language, or another product's redirect, is not written: the product keeps its previous key at that
124
+ scope and the call reports, per key, `{ written: false, issue: { languageCode, channelId, key,
125
+ heldByProductId, kind } }` — `kind` is `current` or `redirect`. An integration never takes over
126
+ another product's redirect and is never asked to confirm one; only an operator can, in the product
127
+ editor (FR-093). A key for a sales channel the product is not in, or a language the channel does not
128
+ offer, refuses the whole call.
129
+
130
+ **No completeness check runs** on an integration's write; the operator's warnings about missing
131
+ names and keys in a scope are an editor feature.
132
+
133
+ **The products CSV round-trips.** The export carries one `status@<channel code>` column per sales
134
+ channel and one `status@<channel code>/<language>` column per channel language — the override at
135
+ that scope, empty where the scope inherits. Importing the exported file unchanged changes nothing;
136
+ an edited cell writes that scope, and an emptied one removes the override. A file without these
137
+ columns leaves every scope as it is. One invalid cell — an unknown channel code, a value for a
138
+ channel the product is not in or a language the channel does not offer, a value that is not a
139
+ status — rejects the whole file, as any other invalid row does.
140
+
141
+ Every write is audited and announced with `product.updated.v1`, whose `changedFields` name what
142
+ changed (`scopedStatus`, `publicationWindow`, `audience`, `orderRules`, `urlKeys`).