@endora-commerce/mod-catalog 0.109.0 → 0.111.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 (615) hide show
  1. package/dist/admin/components/CopyToChannelsDialog.d.ts +37 -0
  2. package/dist/admin/components/CopyToChannelsDialog.js +83 -0
  3. package/dist/admin/components/PackagingUnitsEditor.d.ts +13 -4
  4. package/dist/admin/components/PackagingUnitsEditor.js +21 -85
  5. package/dist/admin/components/ProductAttachmentsSection.d.ts +1 -3
  6. package/dist/admin/components/ProductAttachmentsSection.js +59 -98
  7. package/dist/admin/components/ProductAttributesTab.d.ts +1 -11
  8. package/dist/admin/components/ProductAttributesTab.js +128 -119
  9. package/dist/admin/components/ProductContentCard.d.ts +41 -0
  10. package/dist/admin/components/ProductContentCard.js +28 -0
  11. package/dist/admin/components/ProductEditorSaveAction.d.ts +22 -0
  12. package/dist/admin/components/ProductEditorSaveAction.js +23 -0
  13. package/dist/admin/components/ProductGallerySection.d.ts +2 -13
  14. package/dist/admin/components/ProductGallerySection.js +98 -354
  15. package/dist/admin/components/ProductInventoryTab.d.ts +12 -1
  16. package/dist/admin/components/ProductInventoryTab.js +52 -115
  17. package/dist/admin/components/ProductOrderRulesCard.d.ts +11 -15
  18. package/dist/admin/components/ProductOrderRulesCard.js +15 -268
  19. package/dist/admin/components/ProductScopeBar.d.ts +34 -0
  20. package/dist/admin/components/ProductScopeBar.js +70 -0
  21. package/dist/admin/components/ProductScopeOverview.d.ts +13 -1
  22. package/dist/admin/components/ProductScopeOverview.js +56 -37
  23. package/dist/admin/components/ProductUrlRedirects.d.ts +15 -0
  24. package/dist/admin/components/ProductUrlRedirects.js +70 -0
  25. package/dist/admin/components/ProductsBulkEditDialog.js +4 -3
  26. package/dist/admin/components/editor/DetailsTab.d.ts +30 -0
  27. package/dist/admin/components/editor/DetailsTab.js +60 -0
  28. package/dist/admin/components/editor/SectionHeading.d.ts +22 -0
  29. package/dist/admin/components/editor/SectionHeading.js +19 -0
  30. package/dist/admin/components/editor/confirm-removal.d.ts +13 -0
  31. package/dist/admin/components/editor/confirm-removal.js +33 -0
  32. package/dist/admin/components/editor/editor-context.d.ts +55 -0
  33. package/dist/admin/components/editor/editor-context.js +88 -0
  34. package/dist/admin/components/editor/scoped-controls.d.ts +46 -0
  35. package/dist/admin/components/editor/scoped-controls.js +64 -0
  36. package/dist/admin/index.d.ts +1 -1
  37. package/dist/admin/index.js +11 -0
  38. package/dist/admin/lib/attribute-scope.d.ts +17 -14
  39. package/dist/admin/lib/attribute-scope.js +12 -9
  40. package/dist/admin/lib/bulk-result-outcome.d.ts +14 -0
  41. package/dist/admin/lib/bulk-result-outcome.js +13 -0
  42. package/dist/admin/lib/editor-scope.d.ts +35 -0
  43. package/dist/admin/lib/editor-scope.js +114 -0
  44. package/dist/admin/lib/order-minimum-input.d.ts +13 -0
  45. package/dist/admin/lib/order-minimum-input.js +16 -0
  46. package/dist/admin/lib/product-labels.d.ts +0 -2
  47. package/dist/admin/lib/product-labels.js +1 -5
  48. package/dist/admin/lib/product-scopes-api.d.ts +5 -22
  49. package/dist/admin/lib/product-scopes-api.js +4 -48
  50. package/dist/admin/lib/product-url-keys-api.d.ts +4 -27
  51. package/dist/admin/lib/product-url-keys-api.js +1 -50
  52. package/dist/admin/lib/scope-overview.d.ts +13 -14
  53. package/dist/admin/lib/scope-overview.js +36 -31
  54. package/dist/admin/lib/scoped-editor-store.d.ts +81 -0
  55. package/dist/admin/lib/scoped-editor-store.js +198 -0
  56. package/dist/admin/lib/scoped-values-api.d.ts +14 -0
  57. package/dist/admin/lib/scoped-values-api.js +55 -0
  58. package/dist/admin/pages/AttachmentTypesPage.js +14 -4
  59. package/dist/admin/pages/AttributeSetsPage.js +11 -4
  60. package/dist/admin/pages/AttributesManager.js +130 -40
  61. package/dist/admin/pages/BulkOperationDetailPage.js +11 -4
  62. package/dist/admin/pages/CategoriesTree.d.ts +5 -0
  63. package/dist/admin/pages/CategoriesTree.js +226 -40
  64. package/dist/admin/pages/ProductContentPage.d.ts +27 -0
  65. package/dist/admin/pages/ProductContentPage.js +161 -0
  66. package/dist/admin/pages/ProductCreateForm.d.ts +3 -0
  67. package/dist/admin/pages/ProductCreateForm.js +87 -0
  68. package/dist/admin/pages/ProductEditor.js +938 -458
  69. package/dist/admin/pages/ProductsList.js +33 -38
  70. package/dist/backend/admin-search-provider.d.ts +2 -1
  71. package/dist/backend/admin-search-provider.js +1 -1
  72. package/dist/backend/commands/attribute-commands.d.ts +4 -3
  73. package/dist/backend/commands/attribute-commands.js +137 -30
  74. package/dist/backend/commands/product-content-commands.d.ts +31 -0
  75. package/dist/backend/commands/product-content-commands.js +70 -0
  76. package/dist/backend/commands/scoped-values.commands.d.ts +95 -0
  77. package/dist/backend/commands/scoped-values.commands.js +235 -0
  78. package/dist/backend/demo/reset.js +2 -1
  79. package/dist/backend/demo/rows.d.ts +18 -0
  80. package/dist/backend/demo/rows.js +18 -0
  81. package/dist/backend/demo/seed.d.ts +2 -1
  82. package/dist/backend/demo/seed.js +20 -6
  83. package/dist/backend/entities/gallery-item-scope-override.entity.d.ts +30 -0
  84. package/dist/backend/entities/gallery-item-scope-override.entity.js +80 -0
  85. package/dist/backend/entities/gallery-item.entity.d.ts +7 -6
  86. package/dist/backend/entities/gallery-item.entity.js +11 -6
  87. package/dist/backend/entities/gallery-role-scope-override.entity.d.ts +28 -0
  88. package/dist/backend/entities/gallery-role-scope-override.entity.js +75 -0
  89. package/dist/backend/entities/product-attachment-scope-override.entity.d.ts +30 -0
  90. package/dist/backend/entities/product-attachment-scope-override.entity.js +80 -0
  91. package/dist/backend/entities/product-attachment.entity.d.ts +4 -6
  92. package/dist/backend/entities/product-attachment.entity.js +6 -12
  93. package/dist/backend/entities/product-attribute.entity.d.ts +5 -9
  94. package/dist/backend/entities/product-attribute.entity.js +5 -13
  95. package/dist/backend/entities/product-channel-scope.entity.d.ts +7 -2
  96. package/dist/backend/entities/product-channel-scope.entity.js +10 -1
  97. package/dist/backend/entities/product-content-value.entity.d.ts +39 -0
  98. package/dist/backend/entities/product-content-value.entity.js +81 -0
  99. package/dist/backend/entities/product-packaging-unit-scope-override.entity.d.ts +30 -0
  100. package/dist/backend/entities/product-packaging-unit-scope-override.entity.js +80 -0
  101. package/dist/backend/entities/product-packaging-unit.entity.d.ts +1 -7
  102. package/dist/backend/entities/product-packaging-unit.entity.js +0 -10
  103. package/dist/backend/entities/product-url-key.entity.d.ts +14 -19
  104. package/dist/backend/entities/product-url-key.entity.js +17 -22
  105. package/dist/backend/entities/product-url-redirect.entity.d.ts +8 -13
  106. package/dist/backend/entities/product-url-redirect.entity.js +13 -14
  107. package/dist/backend/entities/product-variant.entity.d.ts +8 -1
  108. package/dist/backend/entities/product-variant.entity.js +13 -2
  109. package/dist/backend/entities/product.entity.d.ts +31 -14
  110. package/dist/backend/entities/product.entity.js +41 -34
  111. package/dist/backend/index.d.ts +11 -3
  112. package/dist/backend/index.js +155 -49
  113. package/dist/backend/plugin.d.ts +36 -6
  114. package/dist/backend/plugin.js +36 -13
  115. package/dist/backend/prompt-tools.d.ts +3 -2
  116. package/dist/backend/prompt-tools.js +18 -7
  117. package/dist/backend/routes.admin.d.ts +15 -16
  118. package/dist/backend/routes.admin.js +122 -103
  119. package/dist/backend/routes.api-key.js +4 -2
  120. package/dist/backend/routes.external.js +3 -2
  121. package/dist/backend/routes.public.d.ts +8 -1
  122. package/dist/backend/routes.public.js +68 -11
  123. package/dist/backend/services/asset-references.d.ts +12 -1
  124. package/dist/backend/services/asset-references.js +42 -2
  125. package/dist/backend/services/attachment-packaging-scopes.d.ts +38 -20
  126. package/dist/backend/services/attachment-packaging-scopes.js +58 -75
  127. package/dist/backend/services/attachment.service.d.ts +4 -8
  128. package/dist/backend/services/attachment.service.js +35 -49
  129. package/dist/backend/services/attribute-filter-match.d.ts +14 -0
  130. package/dist/backend/services/attribute-filter-match.js +19 -0
  131. package/dist/backend/services/attribute-scope-preview.d.ts +17 -7
  132. package/dist/backend/services/attribute-scope-preview.js +30 -20
  133. package/dist/backend/services/attribute-set.service.d.ts +10 -1
  134. package/dist/backend/services/attribute-set.service.js +30 -4
  135. package/dist/backend/services/attribute-type-mapping.d.ts +2 -2
  136. package/dist/backend/services/attribute-type-mapping.js +6 -0
  137. package/dist/backend/services/attribute-usage.d.ts +31 -0
  138. package/dist/backend/services/attribute-usage.js +29 -0
  139. package/dist/backend/services/bulk-operation.service.d.ts +1 -1
  140. package/dist/backend/services/bulk-operation.service.js +16 -6
  141. package/dist/backend/services/bundle.service.js +19 -1
  142. package/dist/backend/services/catalog-admin-search.service.d.ts +3 -2
  143. package/dist/backend/services/catalog-admin-search.service.js +6 -6
  144. package/dist/backend/services/catalog-admin.service.d.ts +63 -12
  145. package/dist/backend/services/catalog-admin.service.js +368 -195
  146. package/dist/backend/services/catalog-attribute-read.service.d.ts +14 -0
  147. package/dist/backend/services/catalog-attribute-read.service.js +9 -19
  148. package/dist/backend/services/catalog-bulk-import.service.d.ts +58 -5
  149. package/dist/backend/services/catalog-bulk-import.service.js +192 -142
  150. package/dist/backend/services/catalog-bulk-update.service.d.ts +5 -3
  151. package/dist/backend/services/catalog-bulk-update.service.js +21 -8
  152. package/dist/backend/services/catalog-product-read.service.d.ts +11 -1
  153. package/dist/backend/services/catalog-product-read.service.js +37 -17
  154. package/dist/backend/services/catalog-query.service.d.ts +48 -8
  155. package/dist/backend/services/catalog-query.service.js +180 -116
  156. package/dist/backend/services/catalog-quick-search.service.js +5 -5
  157. package/dist/backend/services/catalog-write-ports.d.ts +14 -16
  158. package/dist/backend/services/catalog-write-ports.js +11 -70
  159. package/dist/backend/services/category-admin.service.js +29 -5
  160. package/dist/backend/services/content-attribute-rules.d.ts +61 -0
  161. package/dist/backend/services/content-attribute-rules.js +102 -0
  162. package/dist/backend/services/effective-value.sql.d.ts +24 -38
  163. package/dist/backend/services/effective-value.sql.js +37 -87
  164. package/dist/backend/services/gallery-scopes.d.ts +45 -22
  165. package/dist/backend/services/gallery-scopes.js +116 -109
  166. package/dist/backend/services/gallery.service.d.ts +13 -27
  167. package/dist/backend/services/gallery.service.js +75 -199
  168. package/dist/backend/services/grouped.service.js +20 -3
  169. package/dist/backend/services/packaging-unit.service.js +7 -12
  170. package/dist/backend/services/page-builder-content.d.ts +64 -0
  171. package/dist/backend/services/page-builder-content.js +113 -0
  172. package/dist/backend/services/primary-asset-url.d.ts +6 -1
  173. package/dist/backend/services/primary-asset-url.js +9 -4
  174. package/dist/backend/services/product-availability.service.d.ts +16 -3
  175. package/dist/backend/services/product-availability.service.js +58 -21
  176. package/dist/backend/services/product-content.service.d.ts +62 -0
  177. package/dist/backend/services/product-content.service.js +122 -0
  178. package/dist/backend/services/product-editor-preferences.service.d.ts +6 -0
  179. package/dist/backend/services/product-editor-preferences.service.js +12 -0
  180. package/dist/backend/services/product-global-field-rules.d.ts +39 -0
  181. package/dist/backend/services/product-global-field-rules.js +84 -0
  182. package/dist/backend/services/product-link.service.js +14 -16
  183. package/dist/backend/services/product-list-view-service.js +5 -8
  184. package/dist/backend/services/product-page-revalidation.d.ts +9 -0
  185. package/dist/backend/services/product-page-revalidation.js +19 -0
  186. package/dist/backend/services/product-scopes.service.d.ts +18 -8
  187. package/dist/backend/services/product-scopes.service.js +91 -36
  188. package/dist/backend/services/product-value-resolver.service.d.ts +2 -2
  189. package/dist/backend/services/product-value-resolver.service.js +4 -7
  190. package/dist/backend/services/publication-window-sweep.d.ts +61 -7
  191. package/dist/backend/services/publication-window-sweep.js +106 -19
  192. package/dist/backend/services/scheduled-work-probe.d.ts +34 -0
  193. package/dist/backend/services/scheduled-work-probe.js +30 -0
  194. package/dist/backend/services/scope-completeness.d.ts +11 -11
  195. package/dist/backend/services/scope-completeness.js +26 -33
  196. package/dist/backend/services/scope-overview.service.d.ts +24 -24
  197. package/dist/backend/services/scope-overview.service.js +33 -76
  198. package/dist/backend/services/scoped-store-adapters.d.ts +58 -0
  199. package/dist/backend/services/scoped-store-adapters.js +92 -0
  200. package/dist/backend/services/scoped-values-global-only.d.ts +36 -0
  201. package/dist/backend/services/scoped-values-global-only.js +92 -0
  202. package/dist/backend/services/scoped-values-import.d.ts +86 -0
  203. package/dist/backend/services/scoped-values-import.js +320 -0
  204. package/dist/backend/services/scoped-values-read.service.d.ts +56 -0
  205. package/dist/backend/services/scoped-values-read.service.js +289 -0
  206. package/dist/backend/services/scoped-values-save.service.d.ts +79 -0
  207. package/dist/backend/services/scoped-values-save.service.js +675 -0
  208. package/dist/backend/services/scoped-values-state.d.ts +94 -0
  209. package/dist/backend/services/scoped-values-state.js +159 -0
  210. package/dist/backend/services/scoped-values.service.d.ts +36 -0
  211. package/dist/backend/services/scoped-values.service.js +92 -0
  212. package/dist/backend/services/storefront-value-overrides.d.ts +7 -8
  213. package/dist/backend/services/storefront-value-overrides.js +11 -14
  214. package/dist/backend/services/table-maintenance-queue.d.ts +78 -0
  215. package/dist/backend/services/table-maintenance-queue.js +97 -0
  216. package/dist/backend/services/url-key-resolution.service.d.ts +12 -18
  217. package/dist/backend/services/url-key-resolution.service.js +43 -43
  218. package/dist/backend/services/url-key.service.d.ts +87 -135
  219. package/dist/backend/services/url-key.service.js +447 -619
  220. package/dist/manifest.d.ts +51 -1
  221. package/dist/manifest.js +111 -7
  222. package/dist/migrations/20261030T113855_catalog_scope_model_texts.d.ts +36 -0
  223. package/dist/migrations/20261030T113855_catalog_scope_model_texts.js +225 -0
  224. package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.d.ts +18 -0
  225. package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.js +39 -0
  226. package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.d.ts +6 -0
  227. package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.js +119 -0
  228. package/dist/migrations/20261030T113908_catalog_scope_model_media.d.ts +6 -0
  229. package/dist/migrations/20261030T113908_catalog_scope_model_media.js +185 -0
  230. package/dist/migrations/20261104T121504_catalog_product_content_values.d.ts +36 -0
  231. package/dist/migrations/20261104T121504_catalog_product_content_values.js +53 -0
  232. package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.d.ts +33 -0
  233. package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.js +58 -0
  234. package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.d.ts +36 -0
  235. package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.js +40 -0
  236. package/dist/migrations/20261114T000706_catalog_category_main_image.d.ts +37 -0
  237. package/dist/migrations/20261114T000706_catalog_category_main_image.js +56 -0
  238. package/dist/migrations/index.d.ts +9 -1
  239. package/dist/migrations/index.js +17 -1
  240. package/docs/catalog/attachments.md +53 -43
  241. package/docs/catalog/attribute-sets.md +3 -2
  242. package/docs/catalog/attributes.md +99 -25
  243. package/docs/catalog/category-content.md +9 -3
  244. package/docs/catalog/composite-products.md +5 -3
  245. package/docs/catalog/editing-a-product-at-a-scope.md +151 -0
  246. package/docs/catalog/gallery-and-labels.md +61 -60
  247. package/docs/catalog/packaging-units.md +43 -34
  248. package/docs/catalog/per-channel-per-language-overrides.md +83 -410
  249. package/docs/catalog/product-content.md +184 -0
  250. package/docs/catalog/product-links.md +2 -2
  251. package/docs/catalog/url-keys-and-redirects.md +79 -79
  252. package/docs/catalog.md +113 -31
  253. package/i18n/en.json +317 -274
  254. package/i18n/pl.json +319 -276
  255. package/package.json +13 -12
  256. package/dist/admin/components/AttachmentScopesDialog.d.ts +0 -22
  257. package/dist/admin/components/AttachmentScopesDialog.d.ts.map +0 -1
  258. package/dist/admin/components/AttachmentScopesDialog.js +0 -70
  259. package/dist/admin/components/AttachmentScopesDialog.js.map +0 -1
  260. package/dist/admin/components/PackagingUnitsEditor.d.ts.map +0 -1
  261. package/dist/admin/components/PackagingUnitsEditor.js.map +0 -1
  262. package/dist/admin/components/ProductAttachmentsSection.d.ts.map +0 -1
  263. package/dist/admin/components/ProductAttachmentsSection.js.map +0 -1
  264. package/dist/admin/components/ProductAttributesTab.d.ts.map +0 -1
  265. package/dist/admin/components/ProductAttributesTab.js.map +0 -1
  266. package/dist/admin/components/ProductGallerySection.d.ts.map +0 -1
  267. package/dist/admin/components/ProductGallerySection.js.map +0 -1
  268. package/dist/admin/components/ProductInventoryTab.d.ts.map +0 -1
  269. package/dist/admin/components/ProductInventoryTab.js.map +0 -1
  270. package/dist/admin/components/ProductOrderRulesCard.d.ts.map +0 -1
  271. package/dist/admin/components/ProductOrderRulesCard.js.map +0 -1
  272. package/dist/admin/components/ProductScopeControls.d.ts +0 -31
  273. package/dist/admin/components/ProductScopeControls.d.ts.map +0 -1
  274. package/dist/admin/components/ProductScopeControls.js +0 -243
  275. package/dist/admin/components/ProductScopeControls.js.map +0 -1
  276. package/dist/admin/components/ProductScopeEditor.d.ts +0 -88
  277. package/dist/admin/components/ProductScopeEditor.d.ts.map +0 -1
  278. package/dist/admin/components/ProductScopeEditor.js +0 -396
  279. package/dist/admin/components/ProductScopeEditor.js.map +0 -1
  280. package/dist/admin/components/ProductScopeOverview.d.ts.map +0 -1
  281. package/dist/admin/components/ProductScopeOverview.js.map +0 -1
  282. package/dist/admin/components/ProductStatusPills.d.ts.map +0 -1
  283. package/dist/admin/components/ProductStatusPills.js.map +0 -1
  284. package/dist/admin/components/ProductUrlKeysPanel.d.ts +0 -17
  285. package/dist/admin/components/ProductUrlKeysPanel.d.ts.map +0 -1
  286. package/dist/admin/components/ProductUrlKeysPanel.js +0 -215
  287. package/dist/admin/components/ProductUrlKeysPanel.js.map +0 -1
  288. package/dist/admin/components/ProductsBulkEditDialog.d.ts.map +0 -1
  289. package/dist/admin/components/ProductsBulkEditDialog.js.map +0 -1
  290. package/dist/admin/components/ScopedDialogParts.d.ts +0 -23
  291. package/dist/admin/components/ScopedDialogParts.d.ts.map +0 -1
  292. package/dist/admin/components/ScopedDialogParts.js +0 -16
  293. package/dist/admin/components/ScopedDialogParts.js.map +0 -1
  294. package/dist/admin/index.d.ts.map +0 -1
  295. package/dist/admin/index.js.map +0 -1
  296. package/dist/admin/lib/attribute-scope.d.ts.map +0 -1
  297. package/dist/admin/lib/attribute-scope.js.map +0 -1
  298. package/dist/admin/lib/bulk-operation-log-text.d.ts.map +0 -1
  299. package/dist/admin/lib/bulk-operation-log-text.js.map +0 -1
  300. package/dist/admin/lib/media-scopes.d.ts +0 -41
  301. package/dist/admin/lib/media-scopes.d.ts.map +0 -1
  302. package/dist/admin/lib/media-scopes.js +0 -66
  303. package/dist/admin/lib/media-scopes.js.map +0 -1
  304. package/dist/admin/lib/product-labels.d.ts.map +0 -1
  305. package/dist/admin/lib/product-labels.js.map +0 -1
  306. package/dist/admin/lib/product-scope-drafts.d.ts +0 -77
  307. package/dist/admin/lib/product-scope-drafts.d.ts.map +0 -1
  308. package/dist/admin/lib/product-scope-drafts.js +0 -133
  309. package/dist/admin/lib/product-scope-drafts.js.map +0 -1
  310. package/dist/admin/lib/product-scopes-api.d.ts.map +0 -1
  311. package/dist/admin/lib/product-scopes-api.js.map +0 -1
  312. package/dist/admin/lib/product-url-keys-api.d.ts.map +0 -1
  313. package/dist/admin/lib/product-url-keys-api.js.map +0 -1
  314. package/dist/admin/lib/resolve-product-selection.d.ts.map +0 -1
  315. package/dist/admin/lib/resolve-product-selection.js.map +0 -1
  316. package/dist/admin/lib/scope-overview.d.ts.map +0 -1
  317. package/dist/admin/lib/scope-overview.js.map +0 -1
  318. package/dist/admin/pages/AttachmentTypesPage.d.ts.map +0 -1
  319. package/dist/admin/pages/AttachmentTypesPage.js.map +0 -1
  320. package/dist/admin/pages/AttributeSetsPage.d.ts.map +0 -1
  321. package/dist/admin/pages/AttributeSetsPage.js.map +0 -1
  322. package/dist/admin/pages/AttributesManager.d.ts.map +0 -1
  323. package/dist/admin/pages/AttributesManager.js.map +0 -1
  324. package/dist/admin/pages/BulkOperationDetailPage.d.ts.map +0 -1
  325. package/dist/admin/pages/BulkOperationDetailPage.js.map +0 -1
  326. package/dist/admin/pages/BulkOperationsPage.d.ts.map +0 -1
  327. package/dist/admin/pages/BulkOperationsPage.js.map +0 -1
  328. package/dist/admin/pages/CategoriesTree.d.ts.map +0 -1
  329. package/dist/admin/pages/CategoriesTree.js.map +0 -1
  330. package/dist/admin/pages/CategoryContentPage.d.ts.map +0 -1
  331. package/dist/admin/pages/CategoryContentPage.js.map +0 -1
  332. package/dist/admin/pages/ProductEditor.d.ts.map +0 -1
  333. package/dist/admin/pages/ProductEditor.js.map +0 -1
  334. package/dist/admin/pages/ProductsList.d.ts.map +0 -1
  335. package/dist/admin/pages/ProductsList.js.map +0 -1
  336. package/dist/backend/admin-search-provider.d.ts.map +0 -1
  337. package/dist/backend/admin-search-provider.js.map +0 -1
  338. package/dist/backend/commands/attribute-commands.d.ts.map +0 -1
  339. package/dist/backend/commands/attribute-commands.js.map +0 -1
  340. package/dist/backend/demo/reset.d.ts.map +0 -1
  341. package/dist/backend/demo/reset.js.map +0 -1
  342. package/dist/backend/demo/rows.d.ts.map +0 -1
  343. package/dist/backend/demo/rows.js.map +0 -1
  344. package/dist/backend/demo/seed.d.ts.map +0 -1
  345. package/dist/backend/demo/seed.js.map +0 -1
  346. package/dist/backend/entities/attachment-type.entity.d.ts.map +0 -1
  347. package/dist/backend/entities/attachment-type.entity.js.map +0 -1
  348. package/dist/backend/entities/attribute-set-attribute.entity.d.ts.map +0 -1
  349. package/dist/backend/entities/attribute-set-attribute.entity.js.map +0 -1
  350. package/dist/backend/entities/attribute-set.entity.d.ts.map +0 -1
  351. package/dist/backend/entities/attribute-set.entity.js.map +0 -1
  352. package/dist/backend/entities/bulk-operation.entity.d.ts.map +0 -1
  353. package/dist/backend/entities/bulk-operation.entity.js.map +0 -1
  354. package/dist/backend/entities/bundle-slot-option.entity.d.ts.map +0 -1
  355. package/dist/backend/entities/bundle-slot-option.entity.js.map +0 -1
  356. package/dist/backend/entities/bundle-slot.entity.d.ts.map +0 -1
  357. package/dist/backend/entities/bundle-slot.entity.js.map +0 -1
  358. package/dist/backend/entities/category.entity.d.ts.map +0 -1
  359. package/dist/backend/entities/category.entity.js.map +0 -1
  360. package/dist/backend/entities/gallery-item-channel-hidden.entity.d.ts +0 -14
  361. package/dist/backend/entities/gallery-item-channel-hidden.entity.d.ts.map +0 -1
  362. package/dist/backend/entities/gallery-item-channel-hidden.entity.js +0 -42
  363. package/dist/backend/entities/gallery-item-channel-hidden.entity.js.map +0 -1
  364. package/dist/backend/entities/gallery-item-channel-label.entity.d.ts +0 -18
  365. package/dist/backend/entities/gallery-item-channel-label.entity.d.ts.map +0 -1
  366. package/dist/backend/entities/gallery-item-channel-label.entity.js +0 -49
  367. package/dist/backend/entities/gallery-item-channel-label.entity.js.map +0 -1
  368. package/dist/backend/entities/gallery-item-label.entity.d.ts.map +0 -1
  369. package/dist/backend/entities/gallery-item-label.entity.js.map +0 -1
  370. package/dist/backend/entities/gallery-item.entity.d.ts.map +0 -1
  371. package/dist/backend/entities/gallery-item.entity.js.map +0 -1
  372. package/dist/backend/entities/grouped-item.entity.d.ts.map +0 -1
  373. package/dist/backend/entities/grouped-item.entity.js.map +0 -1
  374. package/dist/backend/entities/product-attachment-channel-hidden.entity.d.ts +0 -13
  375. package/dist/backend/entities/product-attachment-channel-hidden.entity.d.ts.map +0 -1
  376. package/dist/backend/entities/product-attachment-channel-hidden.entity.js +0 -41
  377. package/dist/backend/entities/product-attachment-channel-hidden.entity.js.map +0 -1
  378. package/dist/backend/entities/product-attachment.entity.d.ts.map +0 -1
  379. package/dist/backend/entities/product-attachment.entity.js.map +0 -1
  380. package/dist/backend/entities/product-attribute.entity.d.ts.map +0 -1
  381. package/dist/backend/entities/product-attribute.entity.js.map +0 -1
  382. package/dist/backend/entities/product-channel-language-scope.entity.d.ts.map +0 -1
  383. package/dist/backend/entities/product-channel-language-scope.entity.js.map +0 -1
  384. package/dist/backend/entities/product-channel-scope.entity.d.ts.map +0 -1
  385. package/dist/backend/entities/product-channel-scope.entity.js.map +0 -1
  386. package/dist/backend/entities/product-editor-preference.entity.d.ts.map +0 -1
  387. package/dist/backend/entities/product-editor-preference.entity.js.map +0 -1
  388. package/dist/backend/entities/product-link.entity.d.ts.map +0 -1
  389. package/dist/backend/entities/product-link.entity.js.map +0 -1
  390. package/dist/backend/entities/product-list-saved-view.entity.d.ts.map +0 -1
  391. package/dist/backend/entities/product-list-saved-view.entity.js.map +0 -1
  392. package/dist/backend/entities/product-packaging-unit.entity.d.ts.map +0 -1
  393. package/dist/backend/entities/product-packaging-unit.entity.js.map +0 -1
  394. package/dist/backend/entities/product-url-key.entity.d.ts.map +0 -1
  395. package/dist/backend/entities/product-url-key.entity.js.map +0 -1
  396. package/dist/backend/entities/product-url-redirect.entity.d.ts.map +0 -1
  397. package/dist/backend/entities/product-url-redirect.entity.js.map +0 -1
  398. package/dist/backend/entities/product-value-override.entity.d.ts.map +0 -1
  399. package/dist/backend/entities/product-value-override.entity.js.map +0 -1
  400. package/dist/backend/entities/product-variant.entity.d.ts.map +0 -1
  401. package/dist/backend/entities/product-variant.entity.js.map +0 -1
  402. package/dist/backend/entities/product.entity.d.ts.map +0 -1
  403. package/dist/backend/entities/product.entity.js.map +0 -1
  404. package/dist/backend/index.d.ts.map +0 -1
  405. package/dist/backend/index.js.map +0 -1
  406. package/dist/backend/plugin.d.ts.map +0 -1
  407. package/dist/backend/plugin.js.map +0 -1
  408. package/dist/backend/prompt-tools.d.ts.map +0 -1
  409. package/dist/backend/prompt-tools.js.map +0 -1
  410. package/dist/backend/routes.admin.d.ts.map +0 -1
  411. package/dist/backend/routes.admin.js.map +0 -1
  412. package/dist/backend/routes.admin.url-keys.d.ts.map +0 -1
  413. package/dist/backend/routes.admin.url-keys.js.map +0 -1
  414. package/dist/backend/routes.api-key.d.ts.map +0 -1
  415. package/dist/backend/routes.api-key.js.map +0 -1
  416. package/dist/backend/routes.external.d.ts.map +0 -1
  417. package/dist/backend/routes.external.js.map +0 -1
  418. package/dist/backend/routes.public.d.ts.map +0 -1
  419. package/dist/backend/routes.public.js.map +0 -1
  420. package/dist/backend/routes.public.url-keys.d.ts.map +0 -1
  421. package/dist/backend/routes.public.url-keys.js.map +0 -1
  422. package/dist/backend/saved-view-actor.d.ts.map +0 -1
  423. package/dist/backend/saved-view-actor.js.map +0 -1
  424. package/dist/backend/services/asset-references.d.ts.map +0 -1
  425. package/dist/backend/services/asset-references.js.map +0 -1
  426. package/dist/backend/services/attachment-packaging-scopes.d.ts.map +0 -1
  427. package/dist/backend/services/attachment-packaging-scopes.js.map +0 -1
  428. package/dist/backend/services/attachment.service.d.ts.map +0 -1
  429. package/dist/backend/services/attachment.service.js.map +0 -1
  430. package/dist/backend/services/attribute-option-validator.d.ts.map +0 -1
  431. package/dist/backend/services/attribute-option-validator.js.map +0 -1
  432. package/dist/backend/services/attribute-scope-preview.d.ts.map +0 -1
  433. package/dist/backend/services/attribute-scope-preview.js.map +0 -1
  434. package/dist/backend/services/attribute-set-validations.d.ts.map +0 -1
  435. package/dist/backend/services/attribute-set-validations.js.map +0 -1
  436. package/dist/backend/services/attribute-set.service.d.ts.map +0 -1
  437. package/dist/backend/services/attribute-set.service.js.map +0 -1
  438. package/dist/backend/services/attribute-type-mapping.d.ts.map +0 -1
  439. package/dist/backend/services/attribute-type-mapping.js.map +0 -1
  440. package/dist/backend/services/attribute-value-key.service.d.ts.map +0 -1
  441. package/dist/backend/services/attribute-value-key.service.js.map +0 -1
  442. package/dist/backend/services/audit-references.d.ts.map +0 -1
  443. package/dist/backend/services/audit-references.js.map +0 -1
  444. package/dist/backend/services/bulk-operation-queue.d.ts.map +0 -1
  445. package/dist/backend/services/bulk-operation-queue.js.map +0 -1
  446. package/dist/backend/services/bulk-operation.service.d.ts.map +0 -1
  447. package/dist/backend/services/bulk-operation.service.js.map +0 -1
  448. package/dist/backend/services/bundle.service.d.ts.map +0 -1
  449. package/dist/backend/services/bundle.service.js.map +0 -1
  450. package/dist/backend/services/catalog-admin-search.service.d.ts.map +0 -1
  451. package/dist/backend/services/catalog-admin-search.service.js.map +0 -1
  452. package/dist/backend/services/catalog-admin.service.d.ts.map +0 -1
  453. package/dist/backend/services/catalog-admin.service.js.map +0 -1
  454. package/dist/backend/services/catalog-attribute-read.service.d.ts.map +0 -1
  455. package/dist/backend/services/catalog-attribute-read.service.js.map +0 -1
  456. package/dist/backend/services/catalog-bulk-import.service.d.ts.map +0 -1
  457. package/dist/backend/services/catalog-bulk-import.service.js.map +0 -1
  458. package/dist/backend/services/catalog-bulk-update.service.d.ts.map +0 -1
  459. package/dist/backend/services/catalog-bulk-update.service.js.map +0 -1
  460. package/dist/backend/services/catalog-category-read.service.d.ts.map +0 -1
  461. package/dist/backend/services/catalog-category-read.service.js.map +0 -1
  462. package/dist/backend/services/catalog-org-price-decorator.d.ts.map +0 -1
  463. package/dist/backend/services/catalog-org-price-decorator.js.map +0 -1
  464. package/dist/backend/services/catalog-product-filter.service.d.ts.map +0 -1
  465. package/dist/backend/services/catalog-product-filter.service.js.map +0 -1
  466. package/dist/backend/services/catalog-product-read.service.d.ts.map +0 -1
  467. package/dist/backend/services/catalog-product-read.service.js.map +0 -1
  468. package/dist/backend/services/catalog-query.service.d.ts.map +0 -1
  469. package/dist/backend/services/catalog-query.service.js.map +0 -1
  470. package/dist/backend/services/catalog-quick-search.service.d.ts.map +0 -1
  471. package/dist/backend/services/catalog-quick-search.service.js.map +0 -1
  472. package/dist/backend/services/catalog-write-ports.d.ts.map +0 -1
  473. package/dist/backend/services/catalog-write-ports.js.map +0 -1
  474. package/dist/backend/services/category-admin.service.d.ts.map +0 -1
  475. package/dist/backend/services/category-admin.service.js.map +0 -1
  476. package/dist/backend/services/channel-url-facts.d.ts.map +0 -1
  477. package/dist/backend/services/channel-url-facts.js.map +0 -1
  478. package/dist/backend/services/effective-value.sql.d.ts.map +0 -1
  479. package/dist/backend/services/effective-value.sql.js.map +0 -1
  480. package/dist/backend/services/gallery-scopes.d.ts.map +0 -1
  481. package/dist/backend/services/gallery-scopes.js.map +0 -1
  482. package/dist/backend/services/gallery.service.d.ts.map +0 -1
  483. package/dist/backend/services/gallery.service.js.map +0 -1
  484. package/dist/backend/services/grouped.service.d.ts.map +0 -1
  485. package/dist/backend/services/grouped.service.js.map +0 -1
  486. package/dist/backend/services/label-resolver.d.ts.map +0 -1
  487. package/dist/backend/services/label-resolver.js.map +0 -1
  488. package/dist/backend/services/linkable-asset.d.ts.map +0 -1
  489. package/dist/backend/services/linkable-asset.js.map +0 -1
  490. package/dist/backend/services/packaging-unit.service.d.ts.map +0 -1
  491. package/dist/backend/services/packaging-unit.service.js.map +0 -1
  492. package/dist/backend/services/primary-asset-url.d.ts.map +0 -1
  493. package/dist/backend/services/primary-asset-url.js.map +0 -1
  494. package/dist/backend/services/product-availability.service.d.ts.map +0 -1
  495. package/dist/backend/services/product-availability.service.js.map +0 -1
  496. package/dist/backend/services/product-availability.sql.d.ts.map +0 -1
  497. package/dist/backend/services/product-availability.sql.js.map +0 -1
  498. package/dist/backend/services/product-editor-preferences.service.d.ts.map +0 -1
  499. package/dist/backend/services/product-editor-preferences.service.js.map +0 -1
  500. package/dist/backend/services/product-link.service.d.ts.map +0 -1
  501. package/dist/backend/services/product-link.service.js.map +0 -1
  502. package/dist/backend/services/product-list-view-service.d.ts.map +0 -1
  503. package/dist/backend/services/product-list-view-service.js.map +0 -1
  504. package/dist/backend/services/product-overrides.service.d.ts +0 -84
  505. package/dist/backend/services/product-overrides.service.d.ts.map +0 -1
  506. package/dist/backend/services/product-overrides.service.js +0 -211
  507. package/dist/backend/services/product-overrides.service.js.map +0 -1
  508. package/dist/backend/services/product-page-revalidation.d.ts.map +0 -1
  509. package/dist/backend/services/product-page-revalidation.js.map +0 -1
  510. package/dist/backend/services/product-scope-context.service.d.ts +0 -36
  511. package/dist/backend/services/product-scope-context.service.d.ts.map +0 -1
  512. package/dist/backend/services/product-scope-context.service.js +0 -107
  513. package/dist/backend/services/product-scope-context.service.js.map +0 -1
  514. package/dist/backend/services/product-scopes.service.d.ts.map +0 -1
  515. package/dist/backend/services/product-scopes.service.js.map +0 -1
  516. package/dist/backend/services/product-summary-text.d.ts.map +0 -1
  517. package/dist/backend/services/product-summary-text.js.map +0 -1
  518. package/dist/backend/services/product-type-validations.d.ts.map +0 -1
  519. package/dist/backend/services/product-type-validations.js.map +0 -1
  520. package/dist/backend/services/product-value-resolver.service.d.ts.map +0 -1
  521. package/dist/backend/services/product-value-resolver.service.js.map +0 -1
  522. package/dist/backend/services/publication-window-sweep.d.ts.map +0 -1
  523. package/dist/backend/services/publication-window-sweep.js.map +0 -1
  524. package/dist/backend/services/scope-completeness.d.ts.map +0 -1
  525. package/dist/backend/services/scope-completeness.js.map +0 -1
  526. package/dist/backend/services/scope-overview.service.d.ts.map +0 -1
  527. package/dist/backend/services/scope-overview.service.js.map +0 -1
  528. package/dist/backend/services/sql-id-arrays.d.ts.map +0 -1
  529. package/dist/backend/services/sql-id-arrays.js.map +0 -1
  530. package/dist/backend/services/storefront-value-overrides.d.ts.map +0 -1
  531. package/dist/backend/services/storefront-value-overrides.js.map +0 -1
  532. package/dist/backend/services/system-attribute-scopes.d.ts.map +0 -1
  533. package/dist/backend/services/system-attribute-scopes.js.map +0 -1
  534. package/dist/backend/services/url-key-resolution.service.d.ts.map +0 -1
  535. package/dist/backend/services/url-key-resolution.service.js.map +0 -1
  536. package/dist/backend/services/url-key.service.d.ts.map +0 -1
  537. package/dist/backend/services/url-key.service.js.map +0 -1
  538. package/dist/backend/services/viewer-organization.d.ts.map +0 -1
  539. package/dist/backend/services/viewer-organization.js.map +0 -1
  540. package/dist/manifest.d.ts.map +0 -1
  541. package/dist/manifest.js.map +0 -1
  542. package/dist/migrations/20260429T064146_catalog_attribute_sets_init.d.ts.map +0 -1
  543. package/dist/migrations/20260429T064146_catalog_attribute_sets_init.js.map +0 -1
  544. package/dist/migrations/20260429T070004_catalog_product_attribute_extensions.d.ts.map +0 -1
  545. package/dist/migrations/20260429T070004_catalog_product_attribute_extensions.js.map +0 -1
  546. package/dist/migrations/20260429T102322_catalog_product_type_and_virtual_fields.d.ts.map +0 -1
  547. package/dist/migrations/20260429T102322_catalog_product_type_and_virtual_fields.js.map +0 -1
  548. package/dist/migrations/20260429T111839_catalog_gallery_items_and_labels.d.ts.map +0 -1
  549. package/dist/migrations/20260429T111839_catalog_gallery_items_and_labels.js.map +0 -1
  550. package/dist/migrations/20260429T112543_catalog_product_attachments.d.ts.map +0 -1
  551. package/dist/migrations/20260429T112543_catalog_product_attachments.js.map +0 -1
  552. package/dist/migrations/20260429T123726_catalog_product_links.d.ts.map +0 -1
  553. package/dist/migrations/20260429T123726_catalog_product_links.js.map +0 -1
  554. package/dist/migrations/20260429T130803_catalog_grouped_and_bundle.d.ts.map +0 -1
  555. package/dist/migrations/20260429T130803_catalog_grouped_and_bundle.js.map +0 -1
  556. package/dist/migrations/20260501T185835_catalog_product_attribute_is_comparable.d.ts.map +0 -1
  557. package/dist/migrations/20260501T185835_catalog_product_attribute_is_comparable.js.map +0 -1
  558. package/dist/migrations/20260505T060113_catalog_attribute_options_and_flags.d.ts.map +0 -1
  559. package/dist/migrations/20260505T060113_catalog_attribute_options_and_flags.js.map +0 -1
  560. package/dist/migrations/20260515T082629_catalog_attribute_mass_editable.d.ts.map +0 -1
  561. package/dist/migrations/20260515T082629_catalog_attribute_mass_editable.js.map +0 -1
  562. package/dist/migrations/20260526T124736_catalog_product_status_inactive.d.ts.map +0 -1
  563. package/dist/migrations/20260526T124736_catalog_product_status_inactive.js.map +0 -1
  564. package/dist/migrations/20260611T140346_catalog_product_value_overrides_init.d.ts.map +0 -1
  565. package/dist/migrations/20260611T140346_catalog_product_value_overrides_init.js.map +0 -1
  566. package/dist/migrations/20260611T140400_catalog_attribute_quick_searchable.d.ts.map +0 -1
  567. package/dist/migrations/20260611T140400_catalog_attribute_quick_searchable.js.map +0 -1
  568. package/dist/migrations/20260611T140407_catalog_bulk_operations.d.ts.map +0 -1
  569. package/dist/migrations/20260611T140407_catalog_bulk_operations.js.map +0 -1
  570. package/dist/migrations/20260611T140408_catalog_bulk_operation_logs.d.ts.map +0 -1
  571. package/dist/migrations/20260611T140408_catalog_bulk_operation_logs.js.map +0 -1
  572. package/dist/migrations/20260611T140412_catalog_product_packaging_units.d.ts.map +0 -1
  573. package/dist/migrations/20260611T140412_catalog_product_packaging_units.js.map +0 -1
  574. package/dist/migrations/20260718T060659_catalog_bulk_operation_revert_state.d.ts.map +0 -1
  575. package/dist/migrations/20260718T060659_catalog_bulk_operation_revert_state.js.map +0 -1
  576. package/dist/migrations/20260718T200343_catalog_category_custom_field_values.d.ts.map +0 -1
  577. package/dist/migrations/20260718T200343_catalog_category_custom_field_values.js.map +0 -1
  578. package/dist/migrations/20260723T230401_catalog_attributes_on_custom_fields.d.ts.map +0 -1
  579. package/dist/migrations/20260723T230401_catalog_attributes_on_custom_fields.js.map +0 -1
  580. package/dist/migrations/20260804T152604_catalog_widen_product_sku.d.ts.map +0 -1
  581. package/dist/migrations/20260804T152604_catalog_widen_product_sku.js.map +0 -1
  582. package/dist/migrations/20260804T160244_catalog_category_activation.d.ts.map +0 -1
  583. package/dist/migrations/20260804T160244_catalog_category_activation.js.map +0 -1
  584. package/dist/migrations/20260912T094557_catalog_sales_channel_products.d.ts.map +0 -1
  585. package/dist/migrations/20260912T094557_catalog_sales_channel_products.js.map +0 -1
  586. package/dist/migrations/20260912T094623_catalog_sales_channel_categories.d.ts.map +0 -1
  587. package/dist/migrations/20260912T094623_catalog_sales_channel_categories.js.map +0 -1
  588. package/dist/migrations/20260925T125527_catalog_inventory_columns.d.ts.map +0 -1
  589. package/dist/migrations/20260925T125527_catalog_inventory_columns.js.map +0 -1
  590. package/dist/migrations/20261008T080839_catalog_product_attribute_is_price_rule.d.ts.map +0 -1
  591. package/dist/migrations/20261008T080839_catalog_product_attribute_is_price_rule.js.map +0 -1
  592. package/dist/migrations/20261008T092714_catalog_category_content.d.ts.map +0 -1
  593. package/dist/migrations/20261008T092714_catalog_category_content.js.map +0 -1
  594. package/dist/migrations/20261014T170531_catalog_product_list_saved_views.d.ts.map +0 -1
  595. package/dist/migrations/20261014T170531_catalog_product_list_saved_views.js.map +0 -1
  596. package/dist/migrations/20261016T082008_catalog_order_rules.d.ts.map +0 -1
  597. package/dist/migrations/20261016T082008_catalog_order_rules.js.map +0 -1
  598. package/dist/migrations/20261022T035133_catalog_product_scopes.d.ts.map +0 -1
  599. package/dist/migrations/20261022T035133_catalog_product_scopes.js.map +0 -1
  600. package/dist/migrations/20261022T054223_catalog_product_url_keys.d.ts.map +0 -1
  601. package/dist/migrations/20261022T054223_catalog_product_url_keys.js.map +0 -1
  602. package/dist/migrations/20261022T111811_catalog_price_fields_removed.d.ts.map +0 -1
  603. package/dist/migrations/20261022T111811_catalog_price_fields_removed.js.map +0 -1
  604. package/dist/migrations/20261022T182523_catalog_admin_name_keys.d.ts.map +0 -1
  605. package/dist/migrations/20261022T182523_catalog_admin_name_keys.js.map +0 -1
  606. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.d.ts.map +0 -1
  607. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.js.map +0 -1
  608. package/dist/migrations/20261026T033453_catalog_product_media_scopes.d.ts.map +0 -1
  609. package/dist/migrations/20261026T033453_catalog_product_media_scopes.js.map +0 -1
  610. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.d.ts.map +0 -1
  611. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.js.map +0 -1
  612. package/dist/migrations/index.d.ts.map +0 -1
  613. package/dist/migrations/index.js.map +0 -1
  614. package/dist/ports/index.d.ts.map +0 -1
  615. package/dist/ports/index.js.map +0 -1
@@ -1,482 +1,397 @@
1
- import { randomUUID } from 'crypto';
2
- import { ERROR_CODES, productPath, putProductUrlKeysRequestSchema, sameLanguage, toScopeChannel, } from '@endora-commerce/contracts';
1
+ import { randomUUID } from 'node:crypto';
2
+ import { ERROR_CODES, URL_REDIRECTS_PER_CHANNEL_MAX, normaliseUrlKey, productPath, productSlugSchema, sameLanguage, toScopeChannel, isUuidShape, } from '@endora-commerce/contracts';
3
3
  import { HttpError } from '@endora-commerce/platform/http';
4
- import { SalesChannel, effectiveState } from '@endora-commerce/platform/kernel';
4
+ import { effectiveState } from '@endora-commerce/platform/kernel';
5
5
  import { Product } from '../entities/product.entity.js';
6
6
  import { ProductUrlKey } from '../entities/product-url-key.entity.js';
7
- import { channelUrlFactsOf } from './channel-url-facts.js';
8
7
  import { ProductUrlRedirect } from '../entities/product-url-redirect.entity.js';
8
+ import { channelUrlFactsOf } from './channel-url-facts.js';
9
+ import { bumpScopeVersion } from './scoped-values-state.js';
9
10
  /**
10
- * Feature 163 (`specs/163-product-data-scopes/`) — a product's URL keys per language
11
- * and per sales channel × language, and the redirects their changes leave behind
12
- * (`contracts/url-keys-and-redirects.md` §1–§3, data-model §5, research R11, R29).
11
+ * Feature 174 (T039; `contracts/url-keys.md`, research R12) — URL keys at Global (`products.slug`),
12
+ * Channel and Channel × language, and the redirects per (channel, language).
13
13
  *
14
- * **The invariant** (FR-070, FR-072, SC-008): in no language does one key belong to
15
- * two products, current or redirecting. A product's keys in L are its rows of L
16
- * (any channel, orphans included) plus its global key (`products.slug`) where it has
17
- * no language key of L; a language-less redirect counts in every language. No set
18
- * of indexes expresses that, so every write runs as one Command that first locks the
19
- * product row, then takes `pg_advisory_xact_lock(hashtextextended('catalog.url-key:'
20
- * || key, 0))` for every key it can touch **in sorted order** (no deadlock between two
21
- * writers), and only then reads the other products' rows — two writers of one key are
22
- * serialised and the second sees the first's commit.
14
+ * **The one writer.** Every key writer — the product create and duplicate slug, the scoped-values
15
+ * save, `PUT …/url-keys`, the CSV import and the connector port — goes through this service:
16
+ * {@link UrlKeyService.lockAndCheck} for a key write, {@link UrlKeyService.allocateSlug} for a new
17
+ * product's slug. Both take the advisory lock of every key they touch (sorted, `lock_timeout` 5 s)
18
+ * and decide under it. Nothing else writes `product_url_keys`, `product_url_redirects` or
19
+ * `products.slug` (`backend/test/unit/catalog/url-key-writer-ownership.test.ts`, T149).
23
20
  *
24
- * The rules live in {@link planUrlKeyWrite}, a pure function the Command runs inside
25
- * its transaction: a refusal is a refusal of the whole request with nothing written.
26
- * Each write is one audit entry whose `before` is itself a valid request restoring
27
- * every key it touched, plus every redirect row it removed (another product's
28
- * included); `after` holds the keys and the redirect rows it inserted (R29 — no
29
- * single-write undo, Q-D → A). `product.updated.v1` follows with `['urlKeys']`.
30
- *
31
- * Without a `CommandBus` (a composition that wires none, such as a unit rig) every write
32
- * still runs as one transaction, so the locks hold, but it is **not audited** and
33
- * announces no `product.updated.v1`.
21
+ * Invariants (§2): a key text belongs to at most one product per channel across all its
22
+ * languages, orphans included (row vs row: the exclusion constraint; slug vs row and redirects:
23
+ * here); a product's slug equals no other product's slug, row key or redirect; a redirect never
24
+ * points at a product whose key it is in that channel, and at most
25
+ * {@link URL_REDIRECTS_PER_CHANNEL_MAX} exist per (product, channel), oldest dropped.
34
26
  */
35
27
  const LOCK_PREFIX = 'catalog.url-key:';
36
- const lower = (value) => value.toLowerCase();
28
+ // --- Locks ---------------------------------------------------------------------------
37
29
  /**
38
- * Every key a PUT can touch, sorted and once: the keys it writes, the keys it
39
- * replaces at each named scope, the current and the requested global key. These
40
- * are the advisory locks the Command takes, and the keys whose holders it reads.
30
+ * Take the advisory lock of every key, in sorted order, with a 5 s `lock_timeout`. Must run inside
31
+ * the caller's transaction: the locks are released when it ends.
41
32
  */
42
- export function urlKeysToLock(slug, ownKeys, request) {
43
- const keys = new Set([slug]);
44
- if (request.globalKey !== undefined)
45
- keys.add(request.globalKey);
46
- for (const entry of request.languageKeys ?? []) {
47
- if (entry.key !== null)
48
- keys.add(entry.key);
49
- const prev = ownKeys.find((row) => row.channelId === null && sameLanguage(row.languageCode, entry.languageCode));
50
- if (prev)
51
- keys.add(prev.key);
52
- }
53
- for (const entry of request.channelKeys ?? []) {
54
- if (entry.key !== null)
55
- keys.add(entry.key);
56
- const prev = ownKeys.find((row) => row.channelId === entry.channelId && sameLanguage(row.languageCode, entry.languageCode));
57
- if (prev)
58
- keys.add(prev.key);
33
+ export async function lockUrlKeys(em, keys) {
34
+ const sorted = [...new Set(keys)].sort();
35
+ if (sorted.length === 0)
36
+ return;
37
+ await em.execute(`set local lock_timeout = '5s'`);
38
+ for (const key of sorted) {
39
+ await em.execute('select pg_advisory_xact_lock(hashtextextended(?, 0))', [`${LOCK_PREFIX}${key}`]);
59
40
  }
60
- return [...keys].sort();
61
41
  }
62
42
  /**
63
- * The other products whose global key is a touched key, as the planner reads them.
64
- * `products.slug` is unique across soft-deleted rows too, so a deleted product is kept
65
- * — its global key stays taken — but its language keys no longer count, which makes
66
- * that key taken in **every** language (Phase 16 review: without it the planner said
67
- * "free" and the flush answered a unique violation as a 500).
43
+ * Whether `key` is free to become a **new** product's slug (§2.2): no product's slug (soft-deleted
44
+ * ones included — the column is unique), no live product's row key in any channel, no redirect.
68
45
  */
69
- export function otherProductSlugs(products, languageKeys) {
70
- return products.map((product) => ({
71
- productId: product.id,
72
- slug: product.slug,
73
- languageKeyLanguages: product.deletedAt != null
74
- ? []
75
- : languageKeys
76
- .filter((row) => row.productId === product.id && row.channelId === null)
77
- .map((row) => row.languageCode),
78
- }));
46
+ export async function isUrlKeyFree(em, key) {
47
+ const rows = await em.execute(`select 1 from "products" where "slug" = ?
48
+ union all
49
+ select 1 from "product_url_keys" k join "products" p on p."id" = k."product_id"
50
+ where k."key" = ? and p."deleted_at" is null
51
+ union all
52
+ select 1 from "product_url_redirects" where "key" = ?
53
+ limit 1`, [key, key, key]);
54
+ return rows.length === 0;
79
55
  }
80
- function collectScopeOps(state, request) {
81
- const ops = [];
82
- const seen = new Set();
83
- const spelling = (requested, offered, channelId) => offered?.find((code) => sameLanguage(code, requested)) ??
84
- state.ownKeys.find((row) => row.channelId === channelId && sameLanguage(row.languageCode, requested))?.languageCode ??
85
- requested;
86
- for (const entry of request.languageKeys ?? []) {
87
- const id = `*|${lower(entry.languageCode)}`;
88
- if (seen.has(id)) {
89
- throw new HttpError(422, ERROR_CODES.VALIDATION_FAILED, 'A language is named more than once.', {
90
- field: 'languageKeys',
91
- languageCode: entry.languageCode,
92
- });
93
- }
94
- seen.add(id);
95
- const offered = state.channelLanguages.some((code) => sameLanguage(code, entry.languageCode));
96
- if (entry.key !== null && !offered) {
97
- throw new HttpError(422, ERROR_CODES.VALIDATION_FAILED, 'No sales channel offers this language.', {
98
- field: 'languageKeys',
99
- languageCode: entry.languageCode,
100
- });
101
- }
102
- const languageCode = spelling(entry.languageCode, state.channelLanguages, null);
103
- const prev = state.ownKeys.find((row) => row.channelId === null && sameLanguage(row.languageCode, languageCode));
104
- ops.push({ channelId: null, languageCode, prev: prev?.key ?? null, next: entry.key });
56
+ /**
57
+ * {@link UrlKeyService.allocateSlug} as a function, for the product create and duplicate paths that
58
+ * hold no service instance: the free-looking candidates (at most `limit`) are locked together in
59
+ * sorted order and re-checked under the locks in the given order; the first still free wins.
60
+ */
61
+ export async function allocateFreeSlug(em, candidates, limit = candidates.length) {
62
+ const probes = [];
63
+ for (const candidate of candidates) {
64
+ if (probes.length >= limit)
65
+ break;
66
+ if (!probes.includes(candidate) && (await isUrlKeyFree(em, candidate)))
67
+ probes.push(candidate);
105
68
  }
106
- for (const entry of request.channelKeys ?? []) {
107
- const id = `${entry.channelId}|${lower(entry.languageCode)}`;
108
- if (seen.has(id)) {
109
- throw new HttpError(422, ERROR_CODES.VALIDATION_FAILED, 'A channel and language are named more than once.', {
110
- field: 'channelKeys',
111
- channelId: entry.channelId,
112
- languageCode: entry.languageCode,
113
- });
114
- }
115
- seen.add(id);
116
- const languages = state.memberChannels.get(entry.channelId);
117
- // FR-014 for a value; removing an orphaned override is always allowed (FR-015).
118
- if (entry.key !== null) {
119
- if (languages === undefined) {
120
- throw new HttpError(422, ERROR_CODES.SCOPE_INVALID, 'The product is not a member of this sales channel.', {
121
- channelId: entry.channelId,
122
- reason: 'not_a_member',
123
- });
69
+ if (probes.length === 0)
70
+ return null;
71
+ await lockUrlKeys(em, probes);
72
+ for (const candidate of probes)
73
+ if (await isUrlKeyFree(em, candidate))
74
+ return candidate;
75
+ return null;
76
+ }
77
+ /** P's effective key at (C, L): its C×L row → its C row → the slug (§1). */
78
+ export function effectiveKeyAt(rows, slug, channelId, languageCode) {
79
+ const cl = rows.find((row) => row.salesChannelId === channelId && row.languageCode != null && sameLanguage(row.languageCode, languageCode));
80
+ if (cl)
81
+ return cl.key;
82
+ const c = rows.find((row) => row.salesChannelId === channelId && row.languageCode == null);
83
+ return c?.key ?? slug;
84
+ }
85
+ /** P's keys in channel C (§1): every row of C (orphans included), plus the slug where some language of C uses it. */
86
+ export function keysInChannel(rows, slug, channel, channelId) {
87
+ const keys = new Set(rows.filter((row) => row.salesChannelId === channelId).map((row) => row.key));
88
+ if (channel && channel.languages.some((languageCode) => effectiveKeyAt(rows, slug, channelId, languageCode) === slug))
89
+ keys.add(slug);
90
+ return keys;
91
+ }
92
+ const display = (product) => (product.name?.trim() ? product.name : product.sku);
93
+ /** A residual constraint violation is a taken key — never a 500, never the constraint's name. */
94
+ function isKeyViolation(err) {
95
+ const code = err?.code ?? err?.cause?.code;
96
+ return code === '23P01' || code === '23505';
97
+ }
98
+ const keyRowsOf = (rows) => rows.map((row) => ({ salesChannelId: row.salesChannelId, languageCode: row.languageCode ?? null, key: row.key }));
99
+ const keyList = (list) => list
100
+ .map((row) => ({ channelId: row.salesChannelId, languageCode: row.languageCode, key: row.key }))
101
+ .sort((a, b) => a.channelId.localeCompare(b.channelId) || (a.languageCode ?? '').localeCompare(b.languageCode ?? ''));
102
+ function urlKeysUpdatedEvent(productId) {
103
+ return {
104
+ eventName: 'product.updated.v1',
105
+ payload: { eventId: randomUUID(), occurredAt: new Date().toISOString(), productId, changedFields: ['urlKeys'] },
106
+ };
107
+ }
108
+ // --- The service ---------------------------------------------------------------------
109
+ export class UrlKeyService {
110
+ emFactory;
111
+ membership;
112
+ commandBus;
113
+ seoPresent;
114
+ constructor(emFactory, membership, commandBus,
115
+ /** Whether `seo` is effectively present: it decides whether redirects are listed (Q-C). Writes never ask. */
116
+ seoPresent = () => effectiveState.isPresent('seo')) {
117
+ this.emFactory = emFactory;
118
+ this.membership = membership;
119
+ this.commandBus = commandBus;
120
+ this.seoPresent = seoPresent;
121
+ }
122
+ /**
123
+ * §3 — the one key write. On the caller's `em`, inside the caller's transaction: locks, checks
124
+ * and writes. A taken key throws (`interactive`) or is reported and skipped (`integration`);
125
+ * every other refusal (`SCOPE_INVALID`, the grammar) throws in both modes.
126
+ */
127
+ async lockAndCheck(em, productId, writes, options) {
128
+ // command-coverage-ignore: runs only on the caller's Command `em` (the scoped-values save,
129
+ // PUT …/url-keys, the import and connector Commands).
130
+ const product = await em.findOne(Product, { id: productId });
131
+ if (!product || product.deletedAt)
132
+ throw new HttpError(404, ERROR_CODES.PRODUCT_NOT_FOUND, 'Product not found.');
133
+ const [members, ownRows, ownRedirects] = await Promise.all([
134
+ this.membership.listChannelsForEntity('product', productId),
135
+ em.find(ProductUrlKey, { productId }),
136
+ em.find(ProductUrlRedirect, { productId }),
137
+ ]);
138
+ const channels = new Map(members.map((channel) => [channel.id, toScopeChannel(channel)]));
139
+ const confirm = new Set(options.mode === 'interactive' ? (options.confirmTakeover ?? []).map(normaliseUrlKey) : []);
140
+ // The planned state: own rows and slug after every write; languages in the channel's spelling.
141
+ const slugBefore = product.slug;
142
+ const beforeRows = keyRowsOf(ownRows);
143
+ const rows = keyRowsOf(ownRows);
144
+ let slug = slugBefore;
145
+ for (const write of writes) {
146
+ const key = write.op.op === 'set' ? normaliseUrlKey(write.op.key) : null;
147
+ if (key !== null && !productSlugSchema.safeParse(key).success) {
148
+ throw new HttpError(422, ERROR_CODES.VALIDATION_FAILED, 'A URL key must be lower-case words joined by hyphens.', { field: 'urlKey' });
124
149
  }
125
- if (!languages.some((code) => sameLanguage(code, entry.languageCode))) {
126
- throw new HttpError(422, ERROR_CODES.SCOPE_INVALID, 'The sales channel does not offer this language.', {
127
- channelId: entry.channelId,
128
- languageCode: entry.languageCode,
129
- reason: 'language_not_offered',
130
- });
150
+ if (write.scope.level === 'global') {
151
+ if (key === null) {
152
+ throw new HttpError(422, ERROR_CODES.SCOPED_VALUE_INVALID, 'The Global URL key cannot inherit.', {
153
+ fields: [{ field: 'urlKey', scope: write.scope, reason: 'inherit_at_global' }],
154
+ });
155
+ }
156
+ slug = key;
157
+ continue;
131
158
  }
132
- }
133
- const languageCode = spelling(entry.languageCode, languages, entry.channelId);
134
- const prev = state.ownKeys.find((row) => row.channelId === entry.channelId && sameLanguage(row.languageCode, languageCode));
135
- ops.push({ channelId: entry.channelId, languageCode, prev: prev?.key ?? null, next: entry.key });
136
- }
137
- return ops;
138
- }
139
- /**
140
- * What a URL-keys PUT writes (data-model §5's table). Pure; throws the request's
141
- * refusal as an `HttpError` — `URL_KEY_TAKEN` (every holder) before
142
- * `URL_KEY_REDIRECT_TAKEOVER_REQUIRED` (every unconfirmed losing product), so an
143
- * operator is never asked to confirm a write that would be refused anyway.
144
- */
145
- export function planUrlKeyWrite(state, request) {
146
- const ops = collectScopeOps(state, request);
147
- const newSlug = request.globalKey ?? state.slug;
148
- const slugChanged = newSlug !== state.slug;
149
- const finalRows = [
150
- ...state.ownKeys.filter((row) => !ops.some((op) => op.channelId === row.channelId && sameLanguage(op.languageCode, row.languageCode))),
151
- ...ops
152
- .filter((op) => op.next !== null)
153
- .map((op) => ({ productId: state.productId, languageCode: op.languageCode, channelId: op.channelId, key: op.next })),
154
- ];
155
- const hasLanguageKey = (languageCode) => finalRows.some((row) => row.channelId === null && sameLanguage(row.languageCode, languageCode));
156
- const ownRowKeyIn = (languageCode, key) => finalRows.some((row) => row.key === key && sameLanguage(row.languageCode, languageCode));
157
- const isOwnCurrent = (languageCode, key) => ownRowKeyIn(languageCode, key) || (key === newSlug && !hasLanguageKey(languageCode));
158
- const name = (productId) => state.productNames.get(productId) ?? productId;
159
- const confirmed = (languageCode, key) => (request.confirmTakeover ?? []).some((entry) => entry.key === key && sameLanguage(entry.languageCode, languageCode));
160
- /** Other products holding `key` as a current key in `languageCode` (`null` = in any language). */
161
- const otherCurrent = (languageCode, key) => {
162
- const out = [];
163
- for (const row of state.otherKeys) {
164
- if (row.key !== key)
159
+ const channelId = write.scope.channelId;
160
+ const channel = channels.get(channelId);
161
+ let languageCode = null;
162
+ if (write.scope.level === 'channel_language') {
163
+ const wanted = write.scope.languageCode;
164
+ languageCode = channel?.languages.find((code) => sameLanguage(code, wanted)) ?? wanted;
165
+ }
166
+ const index = rows.findIndex((row) => row.salesChannelId === channelId &&
167
+ (languageCode === null ? row.languageCode === null : row.languageCode !== null && sameLanguage(row.languageCode, languageCode)));
168
+ if (key === null) {
169
+ // Removing an own key is always allowed, an orphan's included (163 FR-015).
170
+ if (index !== -1)
171
+ rows.splice(index, 1);
165
172
  continue;
166
- if (languageCode === null || sameLanguage(row.languageCode, languageCode)) {
167
- out.push({ productId: row.productId, languageCode: languageCode ?? row.languageCode });
168
173
  }
174
+ const offered = channel !== undefined && (languageCode === null || channel.languages.some((code) => sameLanguage(code, languageCode)));
175
+ if (!offered) {
176
+ throw new HttpError(422, ERROR_CODES.SCOPE_INVALID, channel ? 'The sales channel does not offer this language.' : 'The product is not a member of this sales channel.', { channelId, ...(languageCode ? { languageCode } : {}), reason: channel ? 'language_not_offered' : 'not_a_member' });
177
+ }
178
+ if (index !== -1)
179
+ rows[index] = { ...rows[index], key };
180
+ else
181
+ rows.push({ salesChannelId: channelId, languageCode, key });
169
182
  }
170
- for (const other of state.otherSlugs) {
171
- if (other.slug !== key)
172
- continue;
173
- if (languageCode === null || !other.languageKeyLanguages.some((code) => sameLanguage(code, languageCode))) {
174
- out.push({ productId: other.productId, languageCode });
183
+ // Lock every key the write touches: both slugs, every outgoing and newly effective key, every new row key.
184
+ const touched = new Set([slugBefore, slug, ...rows.map((row) => row.key)]);
185
+ for (const [channelId, channel] of channels) {
186
+ for (const languageCode of channel.languages) {
187
+ touched.add(effectiveKeyAt(beforeRows, slugBefore, channelId, languageCode));
188
+ touched.add(effectiveKeyAt(rows, slug, channelId, languageCode));
175
189
  }
176
190
  }
177
- return out;
178
- };
179
- /** Other products' redirects with `key` in `languageCode` — a language-less one counts in every language. */
180
- const otherRedirects = (languageCode, key) => state.otherRedirects.filter((row) => row.key === key &&
181
- (languageCode === null || row.languageCode === null || sameLanguage(row.languageCode, languageCode)));
182
- const conflicts = new Map();
183
- const takeovers = new Map();
184
- const taken = new Map();
185
- const ownDeletes = new Map();
186
- const candidates = [];
187
- /** `key` becomes one of the product's keys in `languageCode` (`null` = in every language). */
188
- const claim = (languageCode, key) => {
189
- for (const holder of otherCurrent(languageCode, key)) {
190
- conflicts.set(`${holder.languageCode ?? '*'}|${key}|${holder.productId}`, {
191
- languageCode: holder.languageCode,
192
- key,
193
- heldByProductId: holder.productId,
194
- heldByProductName: name(holder.productId),
195
- });
191
+ await lockUrlKeys(em, [...touched]);
192
+ // Under the locks: the keys P newly holds — the slug anywhere, and per channel every key it did not hold there.
193
+ const conflicts = [];
194
+ if (slug !== slugBefore) {
195
+ for (const holder of await this.#slugConflicts(em, productId, slug))
196
+ conflicts.push({ ...holder, key: slug });
196
197
  }
197
- for (const row of otherRedirects(languageCode, key)) {
198
- if (confirmed(row.languageCode, key)) {
199
- taken.set(row.id, row);
200
- }
201
- else {
202
- takeovers.set(row.id, {
203
- languageCode: row.languageCode,
204
- key,
205
- losingProductId: row.productId,
206
- losingProductName: name(row.productId),
207
- });
198
+ for (const [channelId, channel] of channels) {
199
+ const held = keysInChannel(beforeRows, slugBefore, channel, channelId);
200
+ for (const key of keysInChannel(rows, slug, channel, channelId)) {
201
+ if (held.has(key))
202
+ continue;
203
+ for (const holder of await this.#channelConflicts(em, productId, channelId, key))
204
+ conflicts.push({ ...holder, key, channelId });
208
205
  }
209
206
  }
210
- };
211
- const dropOwnRedirect = (languageCode, key) => {
212
- for (const row of state.ownRedirects) {
213
- if (row.languageCode !== null && row.key === key && sameLanguage(row.languageCode, languageCode)) {
214
- ownDeletes.set(row.id, row);
207
+ if (options.mode === 'integration' && conflicts.length > 0) {
208
+ const blocked = new Set(conflicts.map((conflict) => conflict.key));
209
+ const kept = writes.filter((write) => !(write.op.op === 'set' && blocked.has(normaliseUrlKey(write.op.key))));
210
+ const issues = conflicts.map((conflict) => ({
211
+ channelId: conflict.channelId,
212
+ languageCode: conflict.languageCode,
213
+ key: conflict.key,
214
+ heldByProductId: conflict.holderId,
215
+ kind: conflict.kind,
216
+ }));
217
+ if (kept.length === writes.length) {
218
+ // The conflict comes from a key that only becomes effective (an `inherit`): nothing is written.
219
+ const keys = keyList(beforeRows);
220
+ return { changed: false, before: { slug: slugBefore, keys, redirectsDeleted: [] }, after: { slug: slugBefore, keys, redirectsInserted: [] }, issues };
215
221
  }
222
+ const retried = await this.lockAndCheck(em, productId, kept, options);
223
+ return { ...retried, issues: [...issues, ...retried.issues] };
216
224
  }
217
- };
218
- for (const op of ops) {
219
- if (op.prev === op.next)
220
- continue;
221
- if (op.next !== null) {
222
- claim(op.languageCode, op.next);
223
- // The product's own redirect of this language becomes current again (no self-redirect);
224
- // its own language-less redirect stays, serving every other language (H1).
225
- dropOwnRedirect(op.languageCode, op.next);
226
- if (op.prev !== null) {
227
- candidates.push({ languageCode: op.languageCode, key: op.prev, forced: false });
228
- }
229
- else if (op.channelId === null && !slugChanged) {
230
- // The first language key: the global key becomes a redirect in L only (FR-072 consequence 1).
231
- candidates.push({ languageCode: op.languageCode, key: state.slug, forced: false });
225
+ const current = conflicts.filter((conflict) => conflict.kind === 'current');
226
+ if (current.length > 0) {
227
+ const names = await this.#names(em, current.map((conflict) => conflict.holderId));
228
+ const details = {
229
+ conflicts: current.map((conflict) => ({
230
+ channelId: conflict.channelId,
231
+ languageCode: conflict.languageCode,
232
+ key: conflict.key,
233
+ heldByProductId: conflict.holderId,
234
+ heldByProductName: names.get(conflict.holderId) ?? conflict.holderId,
235
+ })),
236
+ };
237
+ throw new HttpError(409, ERROR_CODES.URL_KEY_TAKEN, 'This URL key is used by another product.', details);
238
+ }
239
+ const redirectConflicts = conflicts.filter((conflict) => conflict.kind === 'redirect');
240
+ const unconfirmed = redirectConflicts.filter((conflict) => !confirm.has(conflict.key));
241
+ if (unconfirmed.length > 0) {
242
+ const names = await this.#names(em, unconfirmed.map((conflict) => conflict.holderId));
243
+ const details = {
244
+ takeovers: unconfirmed.map((conflict) => ({
245
+ channelId: conflict.channelId,
246
+ languageCode: conflict.languageCode,
247
+ key: conflict.key,
248
+ losingProductId: conflict.holderId,
249
+ losingProductName: names.get(conflict.holderId) ?? conflict.holderId,
250
+ })),
251
+ };
252
+ throw new HttpError(409, ERROR_CODES.URL_KEY_REDIRECT_TAKEOVER_REQUIRED, 'This URL key redirects to another product; confirm to take it over.', details);
253
+ }
254
+ // Apply. Takeovers first: another product's redirects for the confirmed keys go (listed in the audit).
255
+ const deleted = [];
256
+ for (const conflict of redirectConflicts) {
257
+ const lost = await em.find(ProductUrlRedirect, {
258
+ key: conflict.key,
259
+ productId: conflict.holderId,
260
+ ...(conflict.channelId ? { salesChannelId: conflict.channelId } : {}),
261
+ });
262
+ for (const row of lost) {
263
+ if (deleted.some((d) => d.id === row.id))
264
+ continue;
265
+ deleted.push({ id: row.id, productId: row.productId, channelId: row.salesChannelId, languageCode: row.languageCode, key: row.key });
266
+ em.remove(row);
232
267
  }
233
268
  }
234
- else {
235
- if (op.channelId === null) {
236
- // "Use inherited": the global key is the product's key in L again — checked as a
237
- // write of it, unless no channel offers L (an orphan's removal is always allowed).
238
- if (state.channelLanguages.some((code) => sameLanguage(code, op.languageCode)))
239
- claim(op.languageCode, newSlug);
240
- dropOwnRedirect(op.languageCode, newSlug);
269
+ // P's redirects: one per pair whose effective key moved from k0, unless k0 is still one of P's keys in C.
270
+ const inserted = [];
271
+ const live = [...ownRedirects];
272
+ for (const [channelId, channel] of channels) {
273
+ const after = keysInChannel(rows, slug, channel, channelId);
274
+ for (const languageCode of channel.languages) {
275
+ const k0 = effectiveKeyAt(beforeRows, slugBefore, channelId, languageCode);
276
+ const k1 = effectiveKeyAt(rows, slug, channelId, languageCode);
277
+ if (k0 === k1 || after.has(k0))
278
+ continue;
279
+ if (live.some((row) => row.salesChannelId === channelId && sameLanguage(row.languageCode, languageCode) && row.key === k0))
280
+ continue;
281
+ const row = em.create(ProductUrlRedirect, { id: randomUUID(), productId, salesChannelId: channelId, languageCode, key: k0, createdAt: new Date() });
282
+ em.persist(row);
283
+ live.push(row);
284
+ inserted.push({ id: row.id, productId, channelId, languageCode, key: k0 });
241
285
  }
242
- candidates.push({ languageCode: op.languageCode, key: op.prev, forced: false });
243
286
  }
244
- }
245
- if (slugChanged) {
246
- claim(null, newSlug);
247
- for (const row of state.ownRedirects) {
248
- if (row.key !== newSlug)
287
+ // No self-redirect (§2.3): a redirect of P whose key is one of P's keys in its channel goes.
288
+ for (const row of [...live]) {
289
+ if (!keysInChannel(rows, slug, channels.get(row.salesChannelId), row.salesChannelId).has(row.key))
249
290
  continue;
250
- if (row.languageCode === null) {
251
- // Its own language-less redirect written back: replaced per language in which the
252
- // product holds a language or channel × language key (there the slug is not its key).
253
- ownDeletes.set(row.id, row);
254
- const held = new Map();
255
- for (const own of finalRows)
256
- held.set(lower(own.languageCode), own.languageCode);
257
- for (const languageCode of held.values())
258
- candidates.push({ languageCode, key: newSlug, forced: true });
291
+ em.remove(row);
292
+ live.splice(live.indexOf(row), 1);
293
+ const fresh = inserted.findIndex((i) => i.id === row.id);
294
+ if (fresh !== -1)
295
+ inserted.splice(fresh, 1);
296
+ else
297
+ deleted.push({ id: row.id, productId, channelId: row.salesChannelId, languageCode: row.languageCode, key: row.key });
298
+ }
299
+ // The cap per (product, channel): the oldest beyond it go, listed in the audit.
300
+ for (const channelId of new Set(live.map((row) => row.salesChannelId))) {
301
+ const list = live
302
+ .filter((row) => row.salesChannelId === channelId)
303
+ .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime() || b.id.localeCompare(a.id));
304
+ for (const row of list.slice(URL_REDIRECTS_PER_CHANNEL_MAX)) {
305
+ em.remove(row);
306
+ deleted.push({ id: row.id, productId, channelId, languageCode: row.languageCode, key: row.key });
259
307
  }
260
- else if (!hasLanguageKey(row.languageCode)) {
261
- ownDeletes.set(row.id, row);
308
+ }
309
+ // The key rows and the slug.
310
+ for (const row of ownRows) {
311
+ const next = rows.find((r) => r.salesChannelId === row.salesChannelId && sameLanguage(r.languageCode, row.languageCode ?? null));
312
+ if (!next)
313
+ em.remove(row);
314
+ else if (next.key !== row.key) {
315
+ row.key = next.key;
316
+ row.updatedAt = new Date();
317
+ em.persist(row);
262
318
  }
263
319
  }
264
- }
265
- if (conflicts.size > 0) {
266
- throw new HttpError(409, ERROR_CODES.URL_KEY_TAKEN, 'This URL key is already used by another product.', {
267
- conflicts: [...conflicts.values()],
268
- });
269
- }
270
- if (takeovers.size > 0) {
271
- throw new HttpError(409, ERROR_CODES.URL_KEY_REDIRECT_TAKEOVER_REQUIRED, "This URL key redirects to another product; confirm taking it over.", { takeovers: [...takeovers.values()] });
272
- }
273
- const inserts = new Map();
274
- const ownRedirectStays = (languageCode, key) => state.ownRedirects.some((row) => row.key === key &&
275
- !ownDeletes.has(row.id) &&
276
- (languageCode === null ? row.languageCode === null : row.languageCode !== null && sameLanguage(row.languageCode, languageCode)));
277
- const freeOfOthers = (languageCode, key) => otherCurrent(languageCode, key).length === 0 && otherRedirects(languageCode, key).every((row) => taken.has(row.id));
278
- const addRedirect = (candidate) => {
279
- if (candidate.forced ? ownRowKeyIn(candidate.languageCode, candidate.key) : isOwnCurrent(candidate.languageCode, candidate.key)) {
280
- return;
320
+ for (const next of rows) {
321
+ if (ownRows.some((row) => row.salesChannelId === next.salesChannelId && sameLanguage(row.languageCode ?? null, next.languageCode)))
322
+ continue;
323
+ em.persist(em.create(ProductUrlKey, { id: randomUUID(), productId, salesChannelId: next.salesChannelId, languageCode: next.languageCode, key: next.key }));
281
324
  }
282
- if (ownRedirectStays(candidate.languageCode, candidate.key))
283
- return;
284
- if (!freeOfOthers(candidate.languageCode, candidate.key))
285
- return;
286
- inserts.set(`${lower(candidate.languageCode)}|${candidate.key}`, {
287
- languageCode: candidate.languageCode,
288
- key: candidate.key,
289
- });
290
- };
291
- for (const candidate of candidates)
292
- addRedirect(candidate);
293
- if (slugChanged) {
294
- // The old global key: one language-less redirect when no other product holds it in any
295
- // language; otherwise one per language where it is free, none where it is taken (HIGH-2).
296
- const old = state.slug;
297
- const othersHold = otherCurrent(null, old).length > 0 || otherRedirects(null, old).some((row) => !taken.has(row.id));
298
- if (!othersHold) {
299
- if (!ownRedirectStays(null, old))
300
- inserts.set(`*|${old}`, { languageCode: null, key: old });
325
+ if (slug !== slugBefore)
326
+ product.slug = slug;
327
+ try {
328
+ await em.flush();
301
329
  }
302
- else {
303
- const languages = new Map();
304
- for (const code of state.channelLanguages)
305
- languages.set(lower(code), code);
306
- for (const languageCode of languages.values())
307
- addRedirect({ languageCode, key: old, forced: false });
330
+ catch (err) {
331
+ if (isKeyViolation(err))
332
+ throw new HttpError(409, ERROR_CODES.URL_KEY_TAKEN, 'This URL key is used by another product.', { conflicts: [] });
333
+ throw err;
308
334
  }
309
- }
310
- const deleteRedirects = [...ownDeletes.values(), ...taken.values()];
311
- const keyRows = ops
312
- .filter((op) => op.prev !== op.next)
313
- .map((op) => ({ languageCode: op.languageCode, channelId: op.channelId, next: op.next }));
314
- const insertRedirects = [...inserts.values()];
315
- const projection = (pick) => ({
316
- ...(request.globalKey !== undefined ? { globalKey: pick === 'prev' ? state.slug : newSlug } : {}),
317
- languageKeys: ops
318
- .filter((op) => op.channelId === null)
319
- .map((op) => ({ languageCode: op.languageCode, key: op[pick] })),
320
- channelKeys: ops
321
- .filter((op) => op.channelId !== null)
322
- .map((op) => ({ channelId: op.channelId, languageCode: op.languageCode, key: op[pick] })),
323
- });
324
- return {
325
- slug: slugChanged ? newSlug : null,
326
- keyRows,
327
- insertRedirects,
328
- deleteRedirects,
329
- before: {
330
- ...projection('prev'),
331
- redirects: deleteRedirects.map((row) => ({
332
- id: row.id,
333
- productId: row.productId,
334
- languageCode: row.languageCode,
335
- key: row.key,
336
- })),
337
- },
338
- after: {
339
- ...projection('next'),
340
- redirects: insertRedirects.map((row) => ({ productId: state.productId, ...row })),
341
- },
342
- changed: slugChanged || keyRows.length > 0 || insertRedirects.length > 0 || deleteRedirects.length > 0,
343
- };
344
- }
345
- // --- Database helpers shared with the product write paths ----------------------------
346
- /**
347
- * Take the advisory lock of every key, in sorted order. Must run inside the caller's
348
- * transaction: the locks are released when it ends.
349
- */
350
- export async function lockUrlKeys(em, keys) {
351
- for (const key of [...new Set(keys)].sort()) {
352
- await em.execute('select pg_advisory_xact_lock(hashtextextended(?, 0))', [`${LOCK_PREFIX}${key}`]);
353
- }
354
- }
355
- /**
356
- * Whether `key` is free to become a **new** product's global key (A-11): not a
357
- * product's global key (any product — `products.slug` is unique), and not a current
358
- * or redirecting key of a live product in any language. Used by slug allocation on
359
- * create and duplicate, which holds the key's lock while it decides.
360
- */
361
- export async function isUrlKeyFree(em, key) {
362
- const rows = (await em.execute(`select 1 from "products" where "slug" = ?
363
- union all
364
- select 1 from "product_url_keys" k join "products" p on p."id" = k."product_id"
365
- where k."key" = ? and p."deleted_at" is null
366
- union all
367
- select 1 from "product_url_redirects" where "key" = ?
368
- limit 1`, [key, key, key]));
369
- return rows.length === 0;
370
- }
371
- // --- The service ---------------------------------------------------------------------
372
- const UUID_SHAPE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
373
- /** A `:id` that is not a UUID names no product: 404, before Postgres refuses the cast as a 500. */
374
- function assertProductIdShape(productId) {
375
- if (!UUID_SHAPE.test(productId))
376
- throw new HttpError(404, ERROR_CODES.PRODUCT_NOT_FOUND, 'Product not found.');
377
- }
378
- function displayName(product) {
379
- const name = product.name ?? {};
380
- return name['en-US'] || Object.values(name).find((value) => typeof value === 'string' && value.trim() !== '') || product.sku;
381
- }
382
- function toKeyRow(row) {
383
- return { productId: row.productId, languageCode: row.languageCode, channelId: row.salesChannelId ?? null, key: row.key };
384
- }
385
- function toRedirectRow(row) {
386
- return { id: row.id, productId: row.productId, languageCode: row.languageCode ?? null, key: row.key };
387
- }
388
- function urlKeysUpdatedEvent(productId) {
389
- return {
390
- eventName: 'product.updated.v1',
391
- payload: { eventId: randomUUID(), occurredAt: new Date().toISOString(), productId, changedFields: ['urlKeys'] },
392
- };
393
- }
394
- /**
395
- * The import-mode issue for a "taken" refusal of `write` (FR-093), or `null` when
396
- * the refusal is of another kind and refuses the whole call.
397
- */
398
- function takenIssue(err, write) {
399
- if (!(err instanceof HttpError))
400
- return null;
401
- const details = (err.details ?? {});
402
- if (err.code === ERROR_CODES.URL_KEY_TAKEN && details.conflicts?.[0]) {
403
- const conflict = details.conflicts[0];
335
+ const changed = slug !== slugBefore || JSON.stringify(keyList(beforeRows)) !== JSON.stringify(keyList(rows)) || inserted.length > 0 || deleted.length > 0;
404
336
  return {
405
- languageCode: write.languageCode,
406
- channelId: write.channelId,
407
- key: conflict.key,
408
- heldByProductId: conflict.heldByProductId,
409
- kind: 'current',
337
+ changed,
338
+ before: { slug: slugBefore, keys: keyList(beforeRows), redirectsDeleted: deleted },
339
+ after: { slug, keys: keyList(rows), redirectsInserted: inserted },
340
+ issues: [],
410
341
  };
411
342
  }
412
- if (err.code === ERROR_CODES.URL_KEY_REDIRECT_TAKEOVER_REQUIRED && details.takeovers?.[0]) {
413
- const takeover = details.takeovers[0];
414
- return {
415
- languageCode: write.languageCode,
416
- channelId: write.channelId,
417
- key: takeover.key,
418
- heldByProductId: takeover.losingProductId,
419
- kind: 'redirect',
420
- };
343
+ /** §2.2 — another product holding `key` as its slug, a row key (any channel) or a redirect. */
344
+ async #slugConflicts(em, productId, key) {
345
+ const rows = await em.execute(`select id::text as product_id, null::text as channel_id, null::text as language_code, 'current' as kind from products where slug = ? and id <> ?
346
+ union all
347
+ select k.product_id::text, k.sales_channel_id::text, k.language_code, 'current' from product_url_keys k
348
+ join products p on p.id = k.product_id where k.key = ? and k.product_id <> ? and p.deleted_at is null
349
+ union all
350
+ select r.product_id::text, r.sales_channel_id::text, r.language_code, 'redirect' from product_url_redirects r where r.key = ? and r.product_id <> ?`, [key, productId, key, productId, key, productId]);
351
+ return rows.map((row) => ({ holderId: row.product_id, channelId: row.channel_id, languageCode: row.language_code, kind: row.kind }));
421
352
  }
422
- return null;
423
- }
424
- /** An integration's keys as the PUT body the planner reads. */
425
- export function importRequest(entries) {
426
- const languageKeys = entries
427
- .filter((entry) => entry.channelId === null)
428
- .map((entry) => ({ languageCode: entry.languageCode, key: entry.key }));
429
- const channelKeys = entries
430
- .filter((entry) => entry.channelId !== null)
431
- .map((entry) => ({ channelId: entry.channelId, languageCode: entry.languageCode, key: entry.key }));
432
- return putProductUrlKeysRequestSchema.parse({
433
- ...(languageKeys.length > 0 ? { languageKeys } : {}),
434
- ...(channelKeys.length > 0 ? { channelKeys } : {}),
435
- });
436
- }
437
- /**
438
- * Import mode (FR-093), pure: each key is admitted only if the keys admitted before
439
- * it plus this one plan without a "taken" refusal; a refused key is reported with
440
- * its holder and left out, so the product keeps its previous key there. Any other
441
- * refusal is thrown — it refuses the whole call. Never passes `confirmTakeover`.
442
- */
443
- export function admitImportKeys(state, writes) {
444
- const accepted = [];
445
- const outcomes = [];
446
- for (const write of writes) {
447
- try {
448
- planUrlKeyWrite(state, importRequest([...accepted, write]));
449
- accepted.push(write);
450
- outcomes.push({ written: true });
451
- }
452
- catch (err) {
453
- const issue = takenIssue(err, write);
454
- if (issue === null)
455
- throw err;
456
- outcomes.push({ written: false, issue });
353
+ /** §3 — `key` taken in channel C by another product: one of its rows in C, its slug where C uses it, or its redirect in C. */
354
+ async #channelConflicts(em, productId, channelId, key) {
355
+ const out = [];
356
+ const rows = await em.execute(`select k.product_id::text as product_id, k.language_code from product_url_keys k
357
+ join products p on p.id = k.product_id
358
+ where k.sales_channel_id = ? and k.key = ? and k.product_id <> ? and p.deleted_at is null`, [channelId, key, productId]);
359
+ for (const row of rows)
360
+ out.push({ holderId: row.product_id, languageCode: row.language_code, kind: 'current' });
361
+ const slugHolders = await em.find(Product, { slug: key, id: { $ne: productId }, deletedAt: null });
362
+ if (slugHolders.length > 0) {
363
+ const members = new Set(await this.membership.filterEntityIdsInChannel(channelId, 'product', slugHolders.map((p) => p.id)));
364
+ for (const holder of slugHolders) {
365
+ if (!members.has(holder.id))
366
+ continue;
367
+ const channel = (await this.membership.listChannelsForEntity('product', holder.id)).find((c) => c.id === channelId);
368
+ const holderRows = keyRowsOf(await em.find(ProductUrlKey, { productId: holder.id, salesChannelId: channelId }));
369
+ if (keysInChannel(holderRows, holder.slug, channel ? toScopeChannel(channel) : undefined, channelId).has(key)) {
370
+ out.push({ holderId: holder.id, languageCode: null, kind: 'current' });
371
+ }
372
+ }
457
373
  }
374
+ const redirects = await em.execute(`select product_id::text as product_id, language_code from product_url_redirects where sales_channel_id = ? and key = ? and product_id <> ?`, [channelId, key, productId]);
375
+ for (const row of redirects)
376
+ out.push({ holderId: row.product_id, languageCode: row.language_code, kind: 'redirect' });
377
+ return out;
378
+ }
379
+ async #names(em, ids) {
380
+ const products = await em.find(Product, { id: { $in: [...new Set(ids)] } }, { fields: ['id', 'name', 'sku'] });
381
+ return new Map(products.map((product) => [product.id, display(product)]));
458
382
  }
459
- return { accepted, outcomes };
460
- }
461
- export class UrlKeyService {
462
- emFactory;
463
- membership;
464
- commandBus;
465
- seoPresent;
466
- constructor(emFactory, membership, commandBus,
467
383
  /**
468
- * Whether `seo` is effectively present: it decides whether redirects are part
469
- * of the answer (Q-C, Constitution XVII). Writes never ask it.
384
+ * A free slug for a **new** product (create, duplicate): the free-looking candidates are locked
385
+ * together in sorted order — the order every key writer locks in — and re-checked under the
386
+ * locks in the given order; the first still free wins. `null` = none is free.
470
387
  */
471
- seoPresent = () => effectiveState.isPresent('seo')) {
472
- this.emFactory = emFactory;
473
- this.membership = membership;
474
- this.commandBus = commandBus;
475
- this.seoPresent = seoPresent;
388
+ allocateSlug(em, candidates) {
389
+ return allocateFreeSlug(em, candidates);
476
390
  }
477
- /** `GET /admin/catalog/products/:id/url-keys` (§1). */
391
+ /** `GET /admin/catalog/products/:id/url-keys` (§5). */
478
392
  async read(productId) {
479
- assertProductIdShape(productId);
393
+ if (!isUuidShape(productId))
394
+ throw new HttpError(404, ERROR_CODES.PRODUCT_NOT_FOUND, 'Product not found.');
480
395
  const em = this.emFactory();
481
396
  const product = await em.findOne(Product, { id: productId, deletedAt: null });
482
397
  if (!product)
@@ -487,54 +402,42 @@ export class UrlKeyService {
487
402
  em.find(ProductUrlRedirect, { productId }),
488
403
  ]);
489
404
  const memberById = new Map(members.map((channel) => [channel.id, channel]));
490
- const languageKeys = keyRows
491
- .filter((row) => row.salesChannelId == null)
492
- .sort((a, b) => a.languageCode.localeCompare(b.languageCode));
493
- const channelKeys = keyRows
494
- .filter((row) => row.salesChannelId != null)
495
- .sort((a, b) => a.salesChannelId.localeCompare(b.salesChannelId) || a.languageCode.localeCompare(b.languageCode));
405
+ const rows = keyRowsOf(keyRows);
496
406
  const effective = [];
497
407
  for (const channel of [...members].sort((a, b) => a.code.localeCompare(b.code))) {
498
408
  for (const languageCode of toScopeChannel(channel).languages) {
499
- const channelKey = channelKeys.find((row) => row.salesChannelId === channel.id && sameLanguage(row.languageCode, languageCode));
500
- const languageKey = languageKeys.find((row) => sameLanguage(row.languageCode, languageCode));
501
- const [key, source] = channelKey
502
- ? [channelKey.key, 'channel_language']
503
- : languageKey
504
- ? [languageKey.key, 'language']
505
- : [product.slug, 'global'];
409
+ const key = effectiveKeyAt(rows, product.slug, channel.id, languageCode);
410
+ const cl = rows.find((row) => row.salesChannelId === channel.id && row.languageCode != null && sameLanguage(row.languageCode, languageCode));
411
+ const c = rows.find((row) => row.salesChannelId === channel.id && row.languageCode == null);
506
412
  effective.push({
507
413
  channelId: channel.id,
508
414
  languageCode,
509
415
  key,
510
- source,
416
+ source: cl ? 'channel_language' : c ? 'channel' : 'global',
511
417
  url: productPath({ key, languageCode, channel: channelUrlFactsOf(channel) }),
512
418
  });
513
419
  }
514
420
  }
515
- // Q-C: the redirect list is `seo`'s surface — omitted while it is off. The rows
516
- // stay, keep reserving their keys, and come back with it (FR-111).
517
- const listRedirects = this.seoPresent();
518
421
  return {
519
422
  globalKey: product.slug,
520
- languageKeys: languageKeys.map((row) => ({ languageCode: row.languageCode, key: row.key })),
521
- channelKeys: channelKeys.map((row) => {
522
- const channel = memberById.get(row.salesChannelId);
423
+ channelKeys: keyList(rows).map((row) => {
424
+ const channel = memberById.get(row.channelId);
523
425
  return {
524
- channelId: row.salesChannelId,
525
- languageCode: row.languageCode,
526
- key: row.key,
527
- orphaned: !channel || !toScopeChannel(channel).languages.some((code) => sameLanguage(code, row.languageCode)),
426
+ ...row,
427
+ orphaned: !channel ||
428
+ (row.languageCode !== null && !toScopeChannel(channel).languages.some((code) => sameLanguage(code, row.languageCode))),
528
429
  };
529
430
  }),
530
431
  effective,
531
- ...(listRedirects
432
+ // Q-C: the redirect list is `seo`'s surface — omitted while it is off; the rows stay and keep reserving.
433
+ ...(this.seoPresent()
532
434
  ? {
533
435
  redirects: redirects
534
436
  .sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime() || a.key.localeCompare(b.key))
535
437
  .map((row) => ({
536
438
  id: row.id,
537
- languageCode: row.languageCode ?? null,
439
+ channelId: row.salesChannelId,
440
+ languageCode: row.languageCode,
538
441
  key: row.key,
539
442
  createdAt: row.createdAt.toISOString(),
540
443
  })),
@@ -542,189 +445,66 @@ export class UrlKeyService {
542
445
  : {}),
543
446
  };
544
447
  }
545
- /** `PUT /admin/catalog/products/:id/url-keys` (§2) — answers the keys as `read` does. */
448
+ /** `PUT /admin/catalog/products/:id/url-keys` (API; §3) — interactive, takeover by confirmation. */
546
449
  async update(productId, request) {
547
- assertProductIdShape(productId);
548
- await this.#run(this.#updateCommand(productId, request));
549
- return this.read(productId);
550
- }
551
- /** `DELETE /admin/catalog/products/:id/url-redirects/:redirectId` (§3). */
552
- async deleteRedirect(productId, redirectId) {
553
- if (!UUID_SHAPE.test(productId) || !UUID_SHAPE.test(redirectId)) {
554
- throw new HttpError(404, ERROR_CODES.URL_REDIRECT_NOT_FOUND, 'Redirect not found.', { redirectId });
555
- }
556
- await this.#run(this.#deleteRedirectCommand(productId, redirectId));
557
- }
558
- async #run(command) {
559
- if (this.commandBus)
560
- return this.commandBus.run(command);
561
- return this.emFactory().transactional(async (em) => {
562
- const outcome = await command.run({
563
- em,
564
- actor: { actorAdminUserId: null, impersonatedCustomerAccountId: null, kind: 'system' },
565
- });
566
- return outcome.result;
567
- });
568
- }
569
- /**
570
- * Inside a Command's transaction: lock the product row (one writer per product),
571
- * take every touched key's advisory lock in sorted order, then read the state the
572
- * planner decides on. `keys` must cover every key any request planned against it
573
- * can touch.
574
- */
575
- async #lockAndLoad(em, productId, keysFor) {
576
- const locked = (await em.execute(`select "id" from "products" where "id" = ? and "deleted_at" is null for update`, [productId]));
577
- if (locked.length === 0)
450
+ if (!isUuidShape(productId))
578
451
  throw new HttpError(404, ERROR_CODES.PRODUCT_NOT_FOUND, 'Product not found.');
579
- const product = await em.findOneOrFail(Product, { id: productId });
580
- const ownKeyEntities = await em.find(ProductUrlKey, { productId });
581
- const ownKeys = ownKeyEntities.map(toKeyRow);
582
- const keys = keysFor(product.slug, ownKeys);
583
- await lockUrlKeys(em, keys);
584
- const [ownRedirects, otherKeys, otherRedirects, otherSlugProducts, channels, members] = await Promise.all([
585
- em.find(ProductUrlRedirect, { productId }),
586
- em.find(ProductUrlKey, { key: { $in: keys }, productId: { $ne: productId } }),
587
- em.find(ProductUrlRedirect, { key: { $in: keys }, productId: { $ne: productId } }),
588
- // Deleted products included: `products.slug` is unique across them (`otherProductSlugs`).
589
- em.find(Product, { slug: { $in: keys }, id: { $ne: productId } }),
590
- em.find(SalesChannel, {}),
591
- this.membership.listChannelsForEntity('product', productId),
592
- ]);
593
- const holderIds = [...new Set([...otherKeys.map((row) => row.productId), ...otherRedirects.map((row) => row.productId)])];
594
- const holders = holderIds.length === 0 ? [] : await em.find(Product, { id: { $in: holderIds } });
595
- const liveHolders = new Set(holders.filter((p) => p.deletedAt == null).map((p) => p.id));
596
- const liveSlugProductIds = otherSlugProducts.filter((p) => p.deletedAt == null).map((p) => p.id);
597
- const slugLanguageKeys = liveSlugProductIds.length === 0
598
- ? []
599
- : await em.find(ProductUrlKey, { productId: { $in: liveSlugProductIds }, salesChannelId: null });
600
- const channelLanguages = new Map();
601
- for (const channel of channels) {
602
- for (const code of toScopeChannel(channel).languages)
603
- if (!channelLanguages.has(lower(code)))
604
- channelLanguages.set(lower(code), code);
605
- }
606
- return {
607
- product,
608
- ownKeyEntities,
609
- state: {
610
- productId,
611
- slug: product.slug,
612
- ownKeys,
613
- ownRedirects: ownRedirects.map(toRedirectRow),
614
- otherKeys: otherKeys.filter((row) => liveHolders.has(row.productId)).map(toKeyRow),
615
- otherSlugs: otherProductSlugs(otherSlugProducts, slugLanguageKeys.map(toKeyRow)),
616
- otherRedirects: otherRedirects.map(toRedirectRow),
617
- productNames: new Map([...holders, ...otherSlugProducts].map((p) => [p.id, displayName(p)])),
618
- channelLanguages: [...channelLanguages.values()],
619
- memberChannels: new Map(members.map((channel) => [channel.id, toScopeChannel(channel).languages])),
620
- },
621
- };
622
- }
623
- /** Writes a plan the planner answered; answers the redirect rows it inserted. */
624
- async #applyPlan(em, productId, product, ownKeyEntities, plan) {
625
- if (plan.deleteRedirects.length > 0) {
626
- await em.nativeDelete(ProductUrlRedirect, { id: { $in: plan.deleteRedirects.map((row) => row.id) } });
452
+ const writes = [];
453
+ if (request.globalKey !== undefined)
454
+ writes.push({ scope: { level: 'global' }, op: { op: 'set', key: request.globalKey } });
455
+ for (const entry of request.channelKeys ?? []) {
456
+ const scope = entry.languageCode
457
+ ? { level: 'channel_language', channelId: entry.channelId, languageCode: entry.languageCode }
458
+ : { level: 'channel', channelId: entry.channelId };
459
+ writes.push({ scope, op: typeof entry.key === 'string' ? { op: 'set', key: entry.key } : { op: 'inherit' } });
627
460
  }
628
- for (const { languageCode, channelId, next } of plan.keyRows) {
629
- const row = ownKeyEntities.find((entity) => (entity.salesChannelId ?? null) === channelId && sameLanguage(entity.languageCode, languageCode));
630
- if (next === null) {
631
- if (row)
632
- em.remove(row);
633
- }
634
- else if (row) {
635
- row.key = next;
636
- }
637
- else {
638
- em.persist(em.create(ProductUrlKey, { id: randomUUID(), productId, languageCode, salesChannelId: channelId, key: next }));
639
- }
640
- }
641
- if (plan.slug !== null)
642
- product.slug = plan.slug;
643
- const inserted = plan.insertRedirects.map((row) => ({ id: randomUUID(), productId, ...row }));
644
- for (const row of inserted)
645
- em.persist(em.create(ProductUrlRedirect, row));
646
- await em.flush();
647
- return inserted;
648
- }
649
- #updateCommand(productId, request) {
650
- return {
651
- action: 'product.url_keys.update',
652
- objectType: 'product',
653
- objectId: productId,
654
- run: async ({ em }) => {
655
- const { product, ownKeyEntities, state } = await this.#lockAndLoad(em, productId, (slug, ownKeys) => urlKeysToLock(slug, ownKeys, request));
656
- const plan = planUrlKeyWrite(state, request);
657
- if (!plan.changed)
658
- return { result: { changed: false }, skipAudit: true };
659
- const inserted = await this.#applyPlan(em, productId, product, ownKeyEntities, plan);
660
- return {
661
- result: { changed: true },
662
- before: plan.before,
663
- after: { ...plan.after, redirects: inserted, changedFields: ['urlKeys'] },
664
- };
665
- },
666
- event: ({ changed }) => (changed ? urlKeysUpdatedEvent(productId) : undefined),
667
- };
461
+ await this.#runWrite(this.#writeCommand(productId, writes, { mode: 'interactive', confirmTakeover: request.confirmTakeover ?? [] }));
462
+ return this.read(productId);
668
463
  }
669
464
  /**
670
- * `catalogProductScopeWritePort.applyScopes(…).urlKeys` (contract §5, FR-093) —
671
- * an integration's keys, in import mode: each key the operator's write would
672
- * refuse as **taken** (another product's current key, or another product's
673
- * redirect) is not written and comes back as an issue naming the holder, and the
674
- * product keeps its previous key at that scope. A redirect is never taken over
675
- * and nothing asks for confirmation — that is an operator's act (FR-072). Every
676
- * other refusal (a channel the product is not in, a language no channel offers)
677
- * refuses the call, as the admin write does.
678
- *
679
- * One Command for the call: the accepted keys are written together, one audit
680
- * entry, `product.updated.v1` with `['urlKeys']` when anything changed.
465
+ * An integration's keys (CSV, connector; §3): a taken key is not written and comes back as an
466
+ * issue naming the holder; a redirect is never taken over. One Command per call.
681
467
  */
682
468
  async importKeys(productId, writes, source) {
683
- assertProductIdShape(productId);
469
+ if (!isUuidShape(productId))
470
+ throw new HttpError(404, ERROR_CODES.PRODUCT_NOT_FOUND, 'Product not found.');
684
471
  if (writes.length === 0)
685
472
  return [];
686
- return this.#run(this.#importCommand(productId, writes, source));
687
- }
688
- #importCommand(productId, writes, source) {
689
- let changed = false;
690
- return {
691
- action: 'product.url_keys.update',
692
- objectType: 'product',
693
- objectId: productId,
694
- run: async ({ em }) => {
695
- const full = importRequest(writes);
696
- const { product, ownKeyEntities, state } = await this.#lockAndLoad(em, productId, (slug, ownKeys) => urlKeysToLock(slug, ownKeys, full));
697
- const { accepted, outcomes } = admitImportKeys(state, writes);
698
- if (accepted.length === 0)
699
- return { result: outcomes, skipAudit: true };
700
- const plan = planUrlKeyWrite(state, importRequest(accepted));
701
- if (!plan.changed)
702
- return { result: outcomes, skipAudit: true };
703
- const inserted = await this.#applyPlan(em, productId, product, ownKeyEntities, plan);
704
- changed = true;
705
- return {
706
- result: outcomes,
707
- before: plan.before,
708
- after: { ...plan.after, redirects: inserted, changedFields: ['urlKeys'], source },
709
- };
710
- },
711
- event: () => (changed ? urlKeysUpdatedEvent(productId) : undefined),
712
- };
473
+ const keyWrites = writes.map((write) => {
474
+ const scope = write.channelId === null
475
+ ? { level: 'global' }
476
+ : write.languageCode
477
+ ? { level: 'channel_language', channelId: write.channelId, languageCode: write.languageCode }
478
+ : { level: 'channel', channelId: write.channelId };
479
+ return { scope, op: write.key === null ? { op: 'inherit' } : { op: 'set', key: write.key } };
480
+ });
481
+ const effects = await this.#runWrite(this.#writeCommand(productId, keyWrites, { mode: 'integration' }, source));
482
+ return writes.map((write) => {
483
+ const issue = effects.issues.find((i) => write.key !== null && i.key === normaliseUrlKey(write.key));
484
+ return issue ? { written: false, issue } : { written: true };
485
+ });
713
486
  }
714
- #deleteRedirectCommand(productId, redirectId) {
715
- return {
487
+ /** `DELETE /admin/catalog/products/:id/url-redirects/:redirectId` (Command `product.url_redirect.delete`). */
488
+ async deleteRedirect(productId, redirectId) {
489
+ if (!isUuidShape(productId) || !isUuidShape(redirectId)) {
490
+ throw new HttpError(404, ERROR_CODES.URL_REDIRECT_NOT_FOUND, 'Redirect not found.', { redirectId });
491
+ }
492
+ await this.#run({
716
493
  action: 'product.url_redirect.delete',
717
494
  objectType: 'product',
718
495
  objectId: productId,
719
496
  run: async ({ em }) => {
720
- const row = await em.findOne(ProductUrlRedirect, { id: redirectId, productId });
721
- if (!row) {
497
+ if (!isUuidShape(redirectId) || !isUuidShape(productId)) {
722
498
  throw new HttpError(404, ERROR_CODES.URL_REDIRECT_NOT_FOUND, 'Redirect not found.', { redirectId });
723
499
  }
500
+ const row = await em.findOne(ProductUrlRedirect, { id: redirectId, productId });
501
+ if (!row)
502
+ throw new HttpError(404, ERROR_CODES.URL_REDIRECT_NOT_FOUND, 'Redirect not found.', { redirectId });
724
503
  const before = {
725
504
  id: row.id,
726
505
  productId: row.productId,
727
- languageCode: row.languageCode ?? null,
506
+ channelId: row.salesChannelId,
507
+ languageCode: row.languageCode,
728
508
  key: row.key,
729
509
  createdAt: row.createdAt.toISOString(),
730
510
  };
@@ -732,7 +512,55 @@ export class UrlKeyService {
732
512
  await em.flush();
733
513
  return { result: { id: row.id }, before, after: null };
734
514
  },
515
+ });
516
+ }
517
+ #writeCommand(productId, writes, options, source) {
518
+ return {
519
+ action: 'product.url_keys.update',
520
+ objectType: 'product',
521
+ objectId: productId,
522
+ run: async ({ em }) => {
523
+ // Feature 174 (R7) — a key write is Save-overwritable: it moves the editor's version.
524
+ await bumpScopeVersion(em, productId);
525
+ const effects = await this.lockAndCheck(em, productId, writes, options);
526
+ // A write that changes nothing rolls the version bump back (code review warn).
527
+ if (!effects.changed)
528
+ throw new UrlKeysNothingChanged(effects);
529
+ return {
530
+ result: effects,
531
+ before: { ...effects.before },
532
+ after: { ...effects.after, changedFields: ['urlKeys'], ...(source ? { source } : {}) },
533
+ };
534
+ },
535
+ event: (effects) => (effects.changed ? urlKeysUpdatedEvent(productId) : undefined),
735
536
  };
736
537
  }
538
+ /** A key write; one that changes nothing answers its effects with nothing committed. */
539
+ async #runWrite(command) {
540
+ try {
541
+ return await this.#run(command);
542
+ }
543
+ catch (error) {
544
+ if (error instanceof UrlKeysNothingChanged)
545
+ return error.effects;
546
+ throw error;
547
+ }
548
+ }
549
+ async #run(command) {
550
+ if (this.commandBus)
551
+ return this.commandBus.run(command);
552
+ return this.emFactory().transactional(async (em) => {
553
+ const outcome = await command.run({ em, actor: { actorAdminUserId: null, impersonatedCustomerAccountId: null, kind: 'system' } });
554
+ return outcome.result;
555
+ });
556
+ }
557
+ }
558
+ /** Thrown inside a key write that changes nothing, so its version bump rolls back. */
559
+ class UrlKeysNothingChanged extends Error {
560
+ effects;
561
+ constructor(effects) {
562
+ super('url keys: nothing changed');
563
+ this.effects = effects;
564
+ }
737
565
  }
738
566
  //# sourceMappingURL=url-key.service.js.map