@endora-commerce/mod-catalog 0.108.0 → 0.109.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (374) hide show
  1. package/dist/admin/components/AttachmentScopesDialog.d.ts +22 -0
  2. package/dist/admin/components/AttachmentScopesDialog.d.ts.map +1 -0
  3. package/dist/admin/components/AttachmentScopesDialog.js +70 -0
  4. package/dist/admin/components/AttachmentScopesDialog.js.map +1 -0
  5. package/dist/admin/components/PackagingUnitsEditor.d.ts +7 -1
  6. package/dist/admin/components/PackagingUnitsEditor.d.ts.map +1 -1
  7. package/dist/admin/components/PackagingUnitsEditor.js +82 -11
  8. package/dist/admin/components/PackagingUnitsEditor.js.map +1 -1
  9. package/dist/admin/components/ProductAttachmentsSection.d.ts +5 -0
  10. package/dist/admin/components/ProductAttachmentsSection.d.ts.map +1 -0
  11. package/dist/admin/components/ProductAttachmentsSection.js +137 -0
  12. package/dist/admin/components/ProductAttachmentsSection.js.map +1 -0
  13. package/dist/admin/components/ProductGallerySection.d.ts +14 -0
  14. package/dist/admin/components/ProductGallerySection.d.ts.map +1 -0
  15. package/dist/admin/components/ProductGallerySection.js +385 -0
  16. package/dist/admin/components/ProductGallerySection.js.map +1 -0
  17. package/dist/admin/components/ProductOrderRulesCard.d.ts.map +1 -1
  18. package/dist/admin/components/ProductOrderRulesCard.js +134 -6
  19. package/dist/admin/components/ProductOrderRulesCard.js.map +1 -1
  20. package/dist/admin/components/ProductScopeControls.d.ts +31 -0
  21. package/dist/admin/components/ProductScopeControls.d.ts.map +1 -0
  22. package/dist/admin/components/ProductScopeControls.js +243 -0
  23. package/dist/admin/components/ProductScopeControls.js.map +1 -0
  24. package/dist/admin/components/ProductScopeEditor.d.ts +12 -18
  25. package/dist/admin/components/ProductScopeEditor.d.ts.map +1 -1
  26. package/dist/admin/components/ProductScopeEditor.js +5 -4
  27. package/dist/admin/components/ProductScopeEditor.js.map +1 -1
  28. package/dist/admin/components/ProductScopeOverview.d.ts +26 -0
  29. package/dist/admin/components/ProductScopeOverview.d.ts.map +1 -0
  30. package/dist/admin/components/ProductScopeOverview.js +207 -0
  31. package/dist/admin/components/ProductScopeOverview.js.map +1 -0
  32. package/dist/admin/components/ProductStatusPills.d.ts +17 -0
  33. package/dist/admin/components/ProductStatusPills.d.ts.map +1 -0
  34. package/dist/admin/components/ProductStatusPills.js +23 -0
  35. package/dist/admin/components/ProductStatusPills.js.map +1 -0
  36. package/dist/admin/components/ProductUrlKeysPanel.d.ts +17 -0
  37. package/dist/admin/components/ProductUrlKeysPanel.d.ts.map +1 -0
  38. package/dist/admin/components/ProductUrlKeysPanel.js +215 -0
  39. package/dist/admin/components/ProductUrlKeysPanel.js.map +1 -0
  40. package/dist/admin/components/ProductsBulkEditDialog.d.ts +30 -0
  41. package/dist/admin/components/ProductsBulkEditDialog.d.ts.map +1 -1
  42. package/dist/admin/components/ProductsBulkEditDialog.js +288 -133
  43. package/dist/admin/components/ProductsBulkEditDialog.js.map +1 -1
  44. package/dist/admin/components/ScopedDialogParts.d.ts +23 -0
  45. package/dist/admin/components/ScopedDialogParts.d.ts.map +1 -0
  46. package/dist/admin/components/ScopedDialogParts.js +16 -0
  47. package/dist/admin/components/ScopedDialogParts.js.map +1 -0
  48. package/dist/admin/index.d.ts +2 -2
  49. package/dist/admin/index.d.ts.map +1 -1
  50. package/dist/admin/index.js +9 -0
  51. package/dist/admin/index.js.map +1 -1
  52. package/dist/admin/lib/attribute-scope.d.ts +20 -0
  53. package/dist/admin/lib/attribute-scope.d.ts.map +1 -0
  54. package/dist/admin/lib/attribute-scope.js +18 -0
  55. package/dist/admin/lib/attribute-scope.js.map +1 -0
  56. package/dist/admin/lib/bulk-operation-log-text.d.ts +9 -0
  57. package/dist/admin/lib/bulk-operation-log-text.d.ts.map +1 -0
  58. package/dist/admin/lib/bulk-operation-log-text.js +13 -0
  59. package/dist/admin/lib/bulk-operation-log-text.js.map +1 -0
  60. package/dist/admin/lib/media-scopes.d.ts +41 -0
  61. package/dist/admin/lib/media-scopes.d.ts.map +1 -0
  62. package/dist/admin/lib/media-scopes.js +66 -0
  63. package/dist/admin/lib/media-scopes.js.map +1 -0
  64. package/dist/admin/lib/product-labels.d.ts +14 -0
  65. package/dist/admin/lib/product-labels.d.ts.map +1 -0
  66. package/dist/admin/lib/product-labels.js +27 -0
  67. package/dist/admin/lib/product-labels.js.map +1 -0
  68. package/dist/admin/lib/product-scope-drafts.d.ts +77 -0
  69. package/dist/admin/lib/product-scope-drafts.d.ts.map +1 -0
  70. package/dist/admin/lib/product-scope-drafts.js +133 -0
  71. package/dist/admin/lib/product-scope-drafts.js.map +1 -0
  72. package/dist/admin/lib/product-scopes-api.d.ts +40 -0
  73. package/dist/admin/lib/product-scopes-api.d.ts.map +1 -0
  74. package/dist/admin/lib/product-scopes-api.js +101 -0
  75. package/dist/admin/lib/product-scopes-api.js.map +1 -0
  76. package/dist/admin/lib/product-url-keys-api.d.ts +46 -0
  77. package/dist/admin/lib/product-url-keys-api.d.ts.map +1 -0
  78. package/dist/admin/lib/product-url-keys-api.js +110 -0
  79. package/dist/admin/lib/product-url-keys-api.js.map +1 -0
  80. package/dist/admin/lib/resolve-product-selection.d.ts +29 -1
  81. package/dist/admin/lib/resolve-product-selection.d.ts.map +1 -1
  82. package/dist/admin/lib/resolve-product-selection.js +42 -6
  83. package/dist/admin/lib/resolve-product-selection.js.map +1 -1
  84. package/dist/admin/lib/scope-overview.d.ts +74 -0
  85. package/dist/admin/lib/scope-overview.d.ts.map +1 -0
  86. package/dist/admin/lib/scope-overview.js +173 -0
  87. package/dist/admin/lib/scope-overview.js.map +1 -0
  88. package/dist/admin/pages/AttributesManager.d.ts.map +1 -1
  89. package/dist/admin/pages/AttributesManager.js +84 -7
  90. package/dist/admin/pages/AttributesManager.js.map +1 -1
  91. package/dist/admin/pages/BulkOperationDetailPage.d.ts.map +1 -1
  92. package/dist/admin/pages/BulkOperationDetailPage.js +4 -19
  93. package/dist/admin/pages/BulkOperationDetailPage.js.map +1 -1
  94. package/dist/admin/pages/ProductEditor.d.ts +0 -4
  95. package/dist/admin/pages/ProductEditor.d.ts.map +1 -1
  96. package/dist/admin/pages/ProductEditor.js +214 -346
  97. package/dist/admin/pages/ProductEditor.js.map +1 -1
  98. package/dist/admin/pages/ProductsList.d.ts +12 -0
  99. package/dist/admin/pages/ProductsList.d.ts.map +1 -1
  100. package/dist/admin/pages/ProductsList.js +105 -38
  101. package/dist/admin/pages/ProductsList.js.map +1 -1
  102. package/dist/backend/admin-search-provider.d.ts +1 -1
  103. package/dist/backend/admin-search-provider.d.ts.map +1 -1
  104. package/dist/backend/admin-search-provider.js +1 -2
  105. package/dist/backend/admin-search-provider.js.map +1 -1
  106. package/dist/backend/demo/rows.d.ts +7 -0
  107. package/dist/backend/demo/rows.d.ts.map +1 -1
  108. package/dist/backend/demo/rows.js +17 -12
  109. package/dist/backend/demo/rows.js.map +1 -1
  110. package/dist/backend/demo/seed.js +2 -2
  111. package/dist/backend/demo/seed.js.map +1 -1
  112. package/dist/backend/entities/bulk-operation.entity.d.ts +10 -0
  113. package/dist/backend/entities/bulk-operation.entity.d.ts.map +1 -1
  114. package/dist/backend/entities/bulk-operation.entity.js.map +1 -1
  115. package/dist/backend/entities/gallery-item-channel-hidden.entity.d.ts +14 -0
  116. package/dist/backend/entities/gallery-item-channel-hidden.entity.d.ts.map +1 -0
  117. package/dist/backend/entities/gallery-item-channel-hidden.entity.js +42 -0
  118. package/dist/backend/entities/gallery-item-channel-hidden.entity.js.map +1 -0
  119. package/dist/backend/entities/gallery-item-channel-label.entity.d.ts +18 -0
  120. package/dist/backend/entities/gallery-item-channel-label.entity.d.ts.map +1 -0
  121. package/dist/backend/entities/gallery-item-channel-label.entity.js +49 -0
  122. package/dist/backend/entities/gallery-item-channel-label.entity.js.map +1 -0
  123. package/dist/backend/entities/gallery-item.entity.d.ts +8 -1
  124. package/dist/backend/entities/gallery-item.entity.d.ts.map +1 -1
  125. package/dist/backend/entities/gallery-item.entity.js +11 -0
  126. package/dist/backend/entities/gallery-item.entity.js.map +1 -1
  127. package/dist/backend/entities/product-attachment-channel-hidden.entity.d.ts +13 -0
  128. package/dist/backend/entities/product-attachment-channel-hidden.entity.d.ts.map +1 -0
  129. package/dist/backend/entities/product-attachment-channel-hidden.entity.js +41 -0
  130. package/dist/backend/entities/product-attachment-channel-hidden.entity.js.map +1 -0
  131. package/dist/backend/entities/product-attachment.entity.d.ts +8 -1
  132. package/dist/backend/entities/product-attachment.entity.d.ts.map +1 -1
  133. package/dist/backend/entities/product-attachment.entity.js +15 -0
  134. package/dist/backend/entities/product-attachment.entity.js.map +1 -1
  135. package/dist/backend/entities/product-channel-language-scope.entity.d.ts +23 -0
  136. package/dist/backend/entities/product-channel-language-scope.entity.d.ts.map +1 -0
  137. package/dist/backend/entities/product-channel-language-scope.entity.js +61 -0
  138. package/dist/backend/entities/product-channel-language-scope.entity.js.map +1 -0
  139. package/dist/backend/entities/product-channel-scope.entity.d.ts +42 -0
  140. package/dist/backend/entities/product-channel-scope.entity.d.ts.map +1 -0
  141. package/dist/backend/entities/product-channel-scope.entity.js +104 -0
  142. package/dist/backend/entities/product-channel-scope.entity.js.map +1 -0
  143. package/dist/backend/entities/product-packaging-unit.entity.d.ts +7 -1
  144. package/dist/backend/entities/product-packaging-unit.entity.d.ts.map +1 -1
  145. package/dist/backend/entities/product-packaging-unit.entity.js +10 -0
  146. package/dist/backend/entities/product-packaging-unit.entity.js.map +1 -1
  147. package/dist/backend/entities/product-url-key.entity.d.ts +32 -0
  148. package/dist/backend/entities/product-url-key.entity.d.ts.map +1 -0
  149. package/dist/backend/entities/product-url-key.entity.js +75 -0
  150. package/dist/backend/entities/product-url-key.entity.js.map +1 -0
  151. package/dist/backend/entities/product-url-redirect.entity.d.ts +23 -0
  152. package/dist/backend/entities/product-url-redirect.entity.d.ts.map +1 -0
  153. package/dist/backend/entities/product-url-redirect.entity.js +58 -0
  154. package/dist/backend/entities/product-url-redirect.entity.js.map +1 -0
  155. package/dist/backend/entities/product.entity.d.ts +17 -2
  156. package/dist/backend/entities/product.entity.d.ts.map +1 -1
  157. package/dist/backend/entities/product.entity.js +24 -1
  158. package/dist/backend/entities/product.entity.js.map +1 -1
  159. package/dist/backend/index.d.ts +24 -2
  160. package/dist/backend/index.d.ts.map +1 -1
  161. package/dist/backend/index.js +206 -11
  162. package/dist/backend/index.js.map +1 -1
  163. package/dist/backend/plugin.d.ts +44 -3
  164. package/dist/backend/plugin.d.ts.map +1 -1
  165. package/dist/backend/plugin.js +67 -9
  166. package/dist/backend/plugin.js.map +1 -1
  167. package/dist/backend/prompt-tools.d.ts +10 -0
  168. package/dist/backend/prompt-tools.d.ts.map +1 -1
  169. package/dist/backend/prompt-tools.js +108 -4
  170. package/dist/backend/prompt-tools.js.map +1 -1
  171. package/dist/backend/routes.admin.d.ts +29 -0
  172. package/dist/backend/routes.admin.d.ts.map +1 -1
  173. package/dist/backend/routes.admin.js +123 -54
  174. package/dist/backend/routes.admin.js.map +1 -1
  175. package/dist/backend/routes.admin.url-keys.d.ts +23 -0
  176. package/dist/backend/routes.admin.url-keys.d.ts.map +1 -0
  177. package/dist/backend/routes.admin.url-keys.js +14 -0
  178. package/dist/backend/routes.admin.url-keys.js.map +1 -0
  179. package/dist/backend/routes.api-key.d.ts.map +1 -1
  180. package/dist/backend/routes.api-key.js +14 -1
  181. package/dist/backend/routes.api-key.js.map +1 -1
  182. package/dist/backend/routes.external.d.ts.map +1 -1
  183. package/dist/backend/routes.external.js +6 -1
  184. package/dist/backend/routes.external.js.map +1 -1
  185. package/dist/backend/routes.public.d.ts +24 -7
  186. package/dist/backend/routes.public.d.ts.map +1 -1
  187. package/dist/backend/routes.public.js +55 -26
  188. package/dist/backend/routes.public.js.map +1 -1
  189. package/dist/backend/routes.public.url-keys.d.ts +26 -0
  190. package/dist/backend/routes.public.url-keys.d.ts.map +1 -0
  191. package/dist/backend/routes.public.url-keys.js +17 -0
  192. package/dist/backend/routes.public.url-keys.js.map +1 -0
  193. package/dist/backend/services/asset-references.js +43 -30
  194. package/dist/backend/services/asset-references.js.map +1 -1
  195. package/dist/backend/services/attachment-packaging-scopes.d.ts +43 -0
  196. package/dist/backend/services/attachment-packaging-scopes.d.ts.map +1 -0
  197. package/dist/backend/services/attachment-packaging-scopes.js +115 -0
  198. package/dist/backend/services/attachment-packaging-scopes.js.map +1 -0
  199. package/dist/backend/services/attachment.service.d.ts +12 -1
  200. package/dist/backend/services/attachment.service.d.ts.map +1 -1
  201. package/dist/backend/services/attachment.service.js +119 -21
  202. package/dist/backend/services/attachment.service.js.map +1 -1
  203. package/dist/backend/services/attribute-scope-preview.d.ts +38 -0
  204. package/dist/backend/services/attribute-scope-preview.d.ts.map +1 -0
  205. package/dist/backend/services/attribute-scope-preview.js +66 -0
  206. package/dist/backend/services/attribute-scope-preview.js.map +1 -0
  207. package/dist/backend/services/bulk-operation.service.d.ts +36 -0
  208. package/dist/backend/services/bulk-operation.service.d.ts.map +1 -1
  209. package/dist/backend/services/bulk-operation.service.js +203 -36
  210. package/dist/backend/services/bulk-operation.service.js.map +1 -1
  211. package/dist/backend/services/bundle.service.d.ts +9 -1
  212. package/dist/backend/services/bundle.service.d.ts.map +1 -1
  213. package/dist/backend/services/bundle.service.js +12 -2
  214. package/dist/backend/services/bundle.service.js.map +1 -1
  215. package/dist/backend/services/catalog-admin-search.service.d.ts +1 -1
  216. package/dist/backend/services/catalog-admin-search.service.js +1 -1
  217. package/dist/backend/services/catalog-admin.service.d.ts +111 -18
  218. package/dist/backend/services/catalog-admin.service.d.ts.map +1 -1
  219. package/dist/backend/services/catalog-admin.service.js +298 -142
  220. package/dist/backend/services/catalog-admin.service.js.map +1 -1
  221. package/dist/backend/services/catalog-bulk-import.service.d.ts +24 -2
  222. package/dist/backend/services/catalog-bulk-import.service.d.ts.map +1 -1
  223. package/dist/backend/services/catalog-bulk-import.service.js +132 -6
  224. package/dist/backend/services/catalog-bulk-import.service.js.map +1 -1
  225. package/dist/backend/services/catalog-bulk-update.service.d.ts +32 -4
  226. package/dist/backend/services/catalog-bulk-update.service.d.ts.map +1 -1
  227. package/dist/backend/services/catalog-bulk-update.service.js +107 -11
  228. package/dist/backend/services/catalog-bulk-update.service.js.map +1 -1
  229. package/dist/backend/services/catalog-org-price-decorator.d.ts +12 -25
  230. package/dist/backend/services/catalog-org-price-decorator.d.ts.map +1 -1
  231. package/dist/backend/services/catalog-org-price-decorator.js +48 -13
  232. package/dist/backend/services/catalog-org-price-decorator.js.map +1 -1
  233. package/dist/backend/services/catalog-product-filter.service.d.ts +16 -2
  234. package/dist/backend/services/catalog-product-filter.service.d.ts.map +1 -1
  235. package/dist/backend/services/catalog-product-filter.service.js +80 -3
  236. package/dist/backend/services/catalog-product-filter.service.js.map +1 -1
  237. package/dist/backend/services/catalog-product-read.service.d.ts.map +1 -1
  238. package/dist/backend/services/catalog-product-read.service.js +5 -8
  239. package/dist/backend/services/catalog-product-read.service.js.map +1 -1
  240. package/dist/backend/services/catalog-query.service.d.ts +135 -38
  241. package/dist/backend/services/catalog-query.service.d.ts.map +1 -1
  242. package/dist/backend/services/catalog-query.service.js +683 -354
  243. package/dist/backend/services/catalog-query.service.js.map +1 -1
  244. package/dist/backend/services/catalog-quick-search.service.d.ts +18 -2
  245. package/dist/backend/services/catalog-quick-search.service.d.ts.map +1 -1
  246. package/dist/backend/services/catalog-quick-search.service.js +52 -20
  247. package/dist/backend/services/catalog-quick-search.service.js.map +1 -1
  248. package/dist/backend/services/catalog-write-ports.d.ts +18 -1
  249. package/dist/backend/services/catalog-write-ports.d.ts.map +1 -1
  250. package/dist/backend/services/catalog-write-ports.js +77 -0
  251. package/dist/backend/services/catalog-write-ports.js.map +1 -1
  252. package/dist/backend/services/category-admin.service.d.ts +12 -1
  253. package/dist/backend/services/category-admin.service.d.ts.map +1 -1
  254. package/dist/backend/services/category-admin.service.js +23 -2
  255. package/dist/backend/services/category-admin.service.js.map +1 -1
  256. package/dist/backend/services/channel-url-facts.d.ts +17 -0
  257. package/dist/backend/services/channel-url-facts.d.ts.map +1 -0
  258. package/dist/backend/services/channel-url-facts.js +20 -0
  259. package/dist/backend/services/channel-url-facts.js.map +1 -0
  260. package/dist/backend/services/effective-value.sql.d.ts +56 -0
  261. package/dist/backend/services/effective-value.sql.d.ts.map +1 -0
  262. package/dist/backend/services/effective-value.sql.js +111 -0
  263. package/dist/backend/services/effective-value.sql.js.map +1 -0
  264. package/dist/backend/services/gallery-scopes.d.ts +40 -0
  265. package/dist/backend/services/gallery-scopes.d.ts.map +1 -0
  266. package/dist/backend/services/gallery-scopes.js +151 -0
  267. package/dist/backend/services/gallery-scopes.js.map +1 -0
  268. package/dist/backend/services/gallery.service.d.ts +46 -4
  269. package/dist/backend/services/gallery.service.d.ts.map +1 -1
  270. package/dist/backend/services/gallery.service.js +308 -46
  271. package/dist/backend/services/gallery.service.js.map +1 -1
  272. package/dist/backend/services/linkable-asset.d.ts +21 -0
  273. package/dist/backend/services/linkable-asset.d.ts.map +1 -0
  274. package/dist/backend/services/linkable-asset.js +31 -0
  275. package/dist/backend/services/linkable-asset.js.map +1 -0
  276. package/dist/backend/services/packaging-unit.service.d.ts.map +1 -1
  277. package/dist/backend/services/packaging-unit.service.js +76 -45
  278. package/dist/backend/services/packaging-unit.service.js.map +1 -1
  279. package/dist/backend/services/primary-asset-url.d.ts +7 -1
  280. package/dist/backend/services/primary-asset-url.d.ts.map +1 -1
  281. package/dist/backend/services/primary-asset-url.js +45 -14
  282. package/dist/backend/services/primary-asset-url.js.map +1 -1
  283. package/dist/backend/services/product-availability.service.d.ts +79 -0
  284. package/dist/backend/services/product-availability.service.d.ts.map +1 -0
  285. package/dist/backend/services/product-availability.service.js +223 -0
  286. package/dist/backend/services/product-availability.service.js.map +1 -0
  287. package/dist/backend/services/product-availability.sql.d.ts +71 -0
  288. package/dist/backend/services/product-availability.sql.d.ts.map +1 -0
  289. package/dist/backend/services/product-availability.sql.js +77 -0
  290. package/dist/backend/services/product-availability.sql.js.map +1 -0
  291. package/dist/backend/services/product-link.service.d.ts +10 -9
  292. package/dist/backend/services/product-link.service.d.ts.map +1 -1
  293. package/dist/backend/services/product-link.service.js +32 -22
  294. package/dist/backend/services/product-link.service.js.map +1 -1
  295. package/dist/backend/services/product-overrides.service.d.ts +9 -2
  296. package/dist/backend/services/product-overrides.service.d.ts.map +1 -1
  297. package/dist/backend/services/product-overrides.service.js +13 -6
  298. package/dist/backend/services/product-overrides.service.js.map +1 -1
  299. package/dist/backend/services/product-page-revalidation.d.ts +51 -0
  300. package/dist/backend/services/product-page-revalidation.d.ts.map +1 -0
  301. package/dist/backend/services/product-page-revalidation.js +146 -0
  302. package/dist/backend/services/product-page-revalidation.js.map +1 -0
  303. package/dist/backend/services/product-scope-context.service.d.ts.map +1 -1
  304. package/dist/backend/services/product-scope-context.service.js +3 -2
  305. package/dist/backend/services/product-scope-context.service.js.map +1 -1
  306. package/dist/backend/services/product-scopes.service.d.ts +212 -0
  307. package/dist/backend/services/product-scopes.service.d.ts.map +1 -0
  308. package/dist/backend/services/product-scopes.service.js +638 -0
  309. package/dist/backend/services/product-scopes.service.js.map +1 -0
  310. package/dist/backend/services/product-summary-text.d.ts +8 -0
  311. package/dist/backend/services/product-summary-text.d.ts.map +1 -0
  312. package/dist/backend/services/product-summary-text.js +8 -0
  313. package/dist/backend/services/product-summary-text.js.map +1 -0
  314. package/dist/backend/services/publication-window-sweep.d.ts +77 -0
  315. package/dist/backend/services/publication-window-sweep.d.ts.map +1 -0
  316. package/dist/backend/services/publication-window-sweep.js +117 -0
  317. package/dist/backend/services/publication-window-sweep.js.map +1 -0
  318. package/dist/backend/services/scope-completeness.d.ts +107 -0
  319. package/dist/backend/services/scope-completeness.d.ts.map +1 -0
  320. package/dist/backend/services/scope-completeness.js +180 -0
  321. package/dist/backend/services/scope-completeness.js.map +1 -0
  322. package/dist/backend/services/scope-overview.service.d.ts +112 -0
  323. package/dist/backend/services/scope-overview.service.d.ts.map +1 -0
  324. package/dist/backend/services/scope-overview.service.js +372 -0
  325. package/dist/backend/services/scope-overview.service.js.map +1 -0
  326. package/dist/backend/services/sql-id-arrays.d.ts +16 -0
  327. package/dist/backend/services/sql-id-arrays.d.ts.map +1 -0
  328. package/dist/backend/services/sql-id-arrays.js +24 -0
  329. package/dist/backend/services/sql-id-arrays.js.map +1 -0
  330. package/dist/backend/services/url-key-resolution.service.d.ts +76 -0
  331. package/dist/backend/services/url-key-resolution.service.d.ts.map +1 -0
  332. package/dist/backend/services/url-key-resolution.service.js +179 -0
  333. package/dist/backend/services/url-key-resolution.service.js.map +1 -0
  334. package/dist/backend/services/url-key.service.d.ts +171 -0
  335. package/dist/backend/services/url-key.service.d.ts.map +1 -0
  336. package/dist/backend/services/url-key.service.js +738 -0
  337. package/dist/backend/services/url-key.service.js.map +1 -0
  338. package/dist/manifest.d.ts +3 -1
  339. package/dist/manifest.d.ts.map +1 -1
  340. package/dist/manifest.js +170 -10
  341. package/dist/manifest.js.map +1 -1
  342. package/dist/migrations/20261022T035133_catalog_product_scopes.d.ts +28 -0
  343. package/dist/migrations/20261022T035133_catalog_product_scopes.d.ts.map +1 -0
  344. package/dist/migrations/20261022T035133_catalog_product_scopes.js +92 -0
  345. package/dist/migrations/20261022T035133_catalog_product_scopes.js.map +1 -0
  346. package/dist/migrations/20261022T054223_catalog_product_url_keys.d.ts +32 -0
  347. package/dist/migrations/20261022T054223_catalog_product_url_keys.d.ts.map +1 -0
  348. package/dist/migrations/20261022T054223_catalog_product_url_keys.js +81 -0
  349. package/dist/migrations/20261022T054223_catalog_product_url_keys.js.map +1 -0
  350. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.d.ts +34 -0
  351. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.d.ts.map +1 -0
  352. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.js +57 -0
  353. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.js.map +1 -0
  354. package/dist/migrations/20261026T033453_catalog_product_media_scopes.d.ts +26 -0
  355. package/dist/migrations/20261026T033453_catalog_product_media_scopes.d.ts.map +1 -0
  356. package/dist/migrations/20261026T033453_catalog_product_media_scopes.js +54 -0
  357. package/dist/migrations/20261026T033453_catalog_product_media_scopes.js.map +1 -0
  358. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.d.ts +27 -0
  359. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.d.ts.map +1 -0
  360. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.js +45 -0
  361. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.js.map +1 -0
  362. package/dist/migrations/index.d.ts +6 -1
  363. package/dist/migrations/index.d.ts.map +1 -1
  364. package/dist/migrations/index.js +11 -1
  365. package/dist/migrations/index.js.map +1 -1
  366. package/docs/catalog/attachments.md +46 -4
  367. package/docs/catalog/gallery-and-labels.md +63 -4
  368. package/docs/catalog/packaging-units.md +42 -5
  369. package/docs/catalog/per-channel-per-language-overrides.md +166 -8
  370. package/docs/catalog/url-keys-and-redirects.md +142 -0
  371. package/docs/catalog.md +182 -15
  372. package/i18n/en.json +903 -49
  373. package/i18n/pl.json +902 -48
  374. package/package.json +10 -10
@@ -0,0 +1,738 @@
1
+ import { randomUUID } from 'crypto';
2
+ import { ERROR_CODES, productPath, putProductUrlKeysRequestSchema, sameLanguage, toScopeChannel, } from '@endora-commerce/contracts';
3
+ import { HttpError } from '@endora-commerce/platform/http';
4
+ import { SalesChannel, effectiveState } from '@endora-commerce/platform/kernel';
5
+ import { Product } from '../entities/product.entity.js';
6
+ import { ProductUrlKey } from '../entities/product-url-key.entity.js';
7
+ import { channelUrlFactsOf } from './channel-url-facts.js';
8
+ import { ProductUrlRedirect } from '../entities/product-url-redirect.entity.js';
9
+ /**
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).
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.
23
+ *
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`.
34
+ */
35
+ const LOCK_PREFIX = 'catalog.url-key:';
36
+ const lower = (value) => value.toLowerCase();
37
+ /**
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.
41
+ */
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);
59
+ }
60
+ return [...keys].sort();
61
+ }
62
+ /**
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).
68
+ */
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
+ }));
79
+ }
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 });
105
+ }
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
+ });
124
+ }
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
+ });
131
+ }
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)
165
+ continue;
166
+ if (languageCode === null || sameLanguage(row.languageCode, languageCode)) {
167
+ out.push({ productId: row.productId, languageCode: languageCode ?? row.languageCode });
168
+ }
169
+ }
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 });
175
+ }
176
+ }
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
+ });
196
+ }
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
+ });
208
+ }
209
+ }
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);
215
+ }
216
+ }
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 });
232
+ }
233
+ }
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);
241
+ }
242
+ candidates.push({ languageCode: op.languageCode, key: op.prev, forced: false });
243
+ }
244
+ }
245
+ if (slugChanged) {
246
+ claim(null, newSlug);
247
+ for (const row of state.ownRedirects) {
248
+ if (row.key !== newSlug)
249
+ 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 });
259
+ }
260
+ else if (!hasLanguageKey(row.languageCode)) {
261
+ ownDeletes.set(row.id, row);
262
+ }
263
+ }
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;
281
+ }
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 });
301
+ }
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 });
308
+ }
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];
404
+ return {
405
+ languageCode: write.languageCode,
406
+ channelId: write.channelId,
407
+ key: conflict.key,
408
+ heldByProductId: conflict.heldByProductId,
409
+ kind: 'current',
410
+ };
411
+ }
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
+ };
421
+ }
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 });
457
+ }
458
+ }
459
+ return { accepted, outcomes };
460
+ }
461
+ export class UrlKeyService {
462
+ emFactory;
463
+ membership;
464
+ commandBus;
465
+ seoPresent;
466
+ constructor(emFactory, membership, commandBus,
467
+ /**
468
+ * Whether `seo` is effectively present: it decides whether redirects are part
469
+ * of the answer (Q-C, Constitution XVII). Writes never ask it.
470
+ */
471
+ seoPresent = () => effectiveState.isPresent('seo')) {
472
+ this.emFactory = emFactory;
473
+ this.membership = membership;
474
+ this.commandBus = commandBus;
475
+ this.seoPresent = seoPresent;
476
+ }
477
+ /** `GET /admin/catalog/products/:id/url-keys` (§1). */
478
+ async read(productId) {
479
+ assertProductIdShape(productId);
480
+ const em = this.emFactory();
481
+ const product = await em.findOne(Product, { id: productId, deletedAt: null });
482
+ if (!product)
483
+ throw new HttpError(404, ERROR_CODES.PRODUCT_NOT_FOUND, 'Product not found.');
484
+ const [members, keyRows, redirects] = await Promise.all([
485
+ this.membership.listChannelsForEntity('product', productId),
486
+ em.find(ProductUrlKey, { productId }),
487
+ em.find(ProductUrlRedirect, { productId }),
488
+ ]);
489
+ 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));
496
+ const effective = [];
497
+ for (const channel of [...members].sort((a, b) => a.code.localeCompare(b.code))) {
498
+ 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'];
506
+ effective.push({
507
+ channelId: channel.id,
508
+ languageCode,
509
+ key,
510
+ source,
511
+ url: productPath({ key, languageCode, channel: channelUrlFactsOf(channel) }),
512
+ });
513
+ }
514
+ }
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
+ return {
519
+ 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);
523
+ 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)),
528
+ };
529
+ }),
530
+ effective,
531
+ ...(listRedirects
532
+ ? {
533
+ redirects: redirects
534
+ .sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime() || a.key.localeCompare(b.key))
535
+ .map((row) => ({
536
+ id: row.id,
537
+ languageCode: row.languageCode ?? null,
538
+ key: row.key,
539
+ createdAt: row.createdAt.toISOString(),
540
+ })),
541
+ }
542
+ : {}),
543
+ };
544
+ }
545
+ /** `PUT /admin/catalog/products/:id/url-keys` (§2) — answers the keys as `read` does. */
546
+ 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)
578
+ 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) } });
627
+ }
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
+ };
668
+ }
669
+ /**
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.
681
+ */
682
+ async importKeys(productId, writes, source) {
683
+ assertProductIdShape(productId);
684
+ if (writes.length === 0)
685
+ 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
+ };
713
+ }
714
+ #deleteRedirectCommand(productId, redirectId) {
715
+ return {
716
+ action: 'product.url_redirect.delete',
717
+ objectType: 'product',
718
+ objectId: productId,
719
+ run: async ({ em }) => {
720
+ const row = await em.findOne(ProductUrlRedirect, { id: redirectId, productId });
721
+ if (!row) {
722
+ throw new HttpError(404, ERROR_CODES.URL_REDIRECT_NOT_FOUND, 'Redirect not found.', { redirectId });
723
+ }
724
+ const before = {
725
+ id: row.id,
726
+ productId: row.productId,
727
+ languageCode: row.languageCode ?? null,
728
+ key: row.key,
729
+ createdAt: row.createdAt.toISOString(),
730
+ };
731
+ em.remove(row);
732
+ await em.flush();
733
+ return { result: { id: row.id }, before, after: null };
734
+ },
735
+ };
736
+ }
737
+ }
738
+ //# sourceMappingURL=url-key.service.js.map