@endora-commerce/mod-catalog 0.108.0 → 0.110.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (571) hide show
  1. package/dist/admin/components/CopyToChannelsDialog.d.ts +37 -0
  2. package/dist/admin/components/CopyToChannelsDialog.d.ts.map +1 -0
  3. package/dist/admin/components/CopyToChannelsDialog.js +83 -0
  4. package/dist/admin/components/CopyToChannelsDialog.js.map +1 -0
  5. package/dist/admin/components/PackagingUnitsEditor.d.ts +16 -1
  6. package/dist/admin/components/PackagingUnitsEditor.d.ts.map +1 -1
  7. package/dist/admin/components/PackagingUnitsEditor.js +20 -14
  8. package/dist/admin/components/PackagingUnitsEditor.js.map +1 -1
  9. package/dist/admin/components/ProductAttachmentsSection.d.ts +3 -0
  10. package/dist/admin/components/ProductAttachmentsSection.d.ts.map +1 -0
  11. package/dist/admin/components/ProductAttachmentsSection.js +98 -0
  12. package/dist/admin/components/ProductAttachmentsSection.js.map +1 -0
  13. package/dist/admin/components/ProductAttributesTab.d.ts +1 -11
  14. package/dist/admin/components/ProductAttributesTab.d.ts.map +1 -1
  15. package/dist/admin/components/ProductAttributesTab.js +128 -119
  16. package/dist/admin/components/ProductAttributesTab.js.map +1 -1
  17. package/dist/admin/components/ProductContentCard.d.ts +41 -0
  18. package/dist/admin/components/ProductContentCard.d.ts.map +1 -0
  19. package/dist/admin/components/ProductContentCard.js +28 -0
  20. package/dist/admin/components/ProductContentCard.js.map +1 -0
  21. package/dist/admin/components/ProductGallerySection.d.ts +3 -0
  22. package/dist/admin/components/ProductGallerySection.d.ts.map +1 -0
  23. package/dist/admin/components/ProductGallerySection.js +129 -0
  24. package/dist/admin/components/ProductGallerySection.js.map +1 -0
  25. package/dist/admin/components/ProductOrderRulesCard.d.ts +11 -15
  26. package/dist/admin/components/ProductOrderRulesCard.d.ts.map +1 -1
  27. package/dist/admin/components/ProductOrderRulesCard.js +15 -140
  28. package/dist/admin/components/ProductOrderRulesCard.js.map +1 -1
  29. package/dist/admin/components/ProductScopeBar.d.ts +28 -0
  30. package/dist/admin/components/ProductScopeBar.d.ts.map +1 -0
  31. package/dist/admin/components/ProductScopeBar.js +70 -0
  32. package/dist/admin/components/ProductScopeBar.js.map +1 -0
  33. package/dist/admin/components/ProductScopeOverview.d.ts +38 -0
  34. package/dist/admin/components/ProductScopeOverview.d.ts.map +1 -0
  35. package/dist/admin/components/ProductScopeOverview.js +222 -0
  36. package/dist/admin/components/ProductScopeOverview.js.map +1 -0
  37. package/dist/admin/components/ProductStatusPills.d.ts +17 -0
  38. package/dist/admin/components/ProductStatusPills.d.ts.map +1 -0
  39. package/dist/admin/components/ProductStatusPills.js +23 -0
  40. package/dist/admin/components/ProductStatusPills.js.map +1 -0
  41. package/dist/admin/components/ProductUrlRedirects.d.ts +15 -0
  42. package/dist/admin/components/ProductUrlRedirects.d.ts.map +1 -0
  43. package/dist/admin/components/ProductUrlRedirects.js +70 -0
  44. package/dist/admin/components/ProductUrlRedirects.js.map +1 -0
  45. package/dist/admin/components/ProductsBulkEditDialog.d.ts +30 -0
  46. package/dist/admin/components/ProductsBulkEditDialog.d.ts.map +1 -1
  47. package/dist/admin/components/ProductsBulkEditDialog.js +288 -133
  48. package/dist/admin/components/ProductsBulkEditDialog.js.map +1 -1
  49. package/dist/admin/components/editor/DetailsTab.d.ts +30 -0
  50. package/dist/admin/components/editor/DetailsTab.d.ts.map +1 -0
  51. package/dist/admin/components/editor/DetailsTab.js +59 -0
  52. package/dist/admin/components/editor/DetailsTab.js.map +1 -0
  53. package/dist/admin/components/editor/ImmediateBadge.d.ts +21 -0
  54. package/dist/admin/components/editor/ImmediateBadge.d.ts.map +1 -0
  55. package/dist/admin/components/editor/ImmediateBadge.js +21 -0
  56. package/dist/admin/components/editor/ImmediateBadge.js.map +1 -0
  57. package/dist/admin/components/editor/confirm-removal.d.ts +13 -0
  58. package/dist/admin/components/editor/confirm-removal.d.ts.map +1 -0
  59. package/dist/admin/components/editor/confirm-removal.js +33 -0
  60. package/dist/admin/components/editor/confirm-removal.js.map +1 -0
  61. package/dist/admin/components/editor/editor-context.d.ts +53 -0
  62. package/dist/admin/components/editor/editor-context.d.ts.map +1 -0
  63. package/dist/admin/components/editor/editor-context.js +88 -0
  64. package/dist/admin/components/editor/editor-context.js.map +1 -0
  65. package/dist/admin/components/editor/scoped-controls.d.ts +46 -0
  66. package/dist/admin/components/editor/scoped-controls.d.ts.map +1 -0
  67. package/dist/admin/components/editor/scoped-controls.js +64 -0
  68. package/dist/admin/components/editor/scoped-controls.js.map +1 -0
  69. package/dist/admin/index.d.ts +2 -2
  70. package/dist/admin/index.d.ts.map +1 -1
  71. package/dist/admin/index.js +20 -0
  72. package/dist/admin/index.js.map +1 -1
  73. package/dist/admin/lib/attribute-scope.d.ts +23 -0
  74. package/dist/admin/lib/attribute-scope.d.ts.map +1 -0
  75. package/dist/admin/lib/attribute-scope.js +21 -0
  76. package/dist/admin/lib/attribute-scope.js.map +1 -0
  77. package/dist/admin/lib/bulk-operation-log-text.d.ts +9 -0
  78. package/dist/admin/lib/bulk-operation-log-text.d.ts.map +1 -0
  79. package/dist/admin/lib/bulk-operation-log-text.js +13 -0
  80. package/dist/admin/lib/bulk-operation-log-text.js.map +1 -0
  81. package/dist/admin/lib/editor-scope.d.ts +35 -0
  82. package/dist/admin/lib/editor-scope.d.ts.map +1 -0
  83. package/dist/admin/lib/editor-scope.js +114 -0
  84. package/dist/admin/lib/editor-scope.js.map +1 -0
  85. package/dist/admin/lib/order-minimum-input.d.ts +13 -0
  86. package/dist/admin/lib/order-minimum-input.d.ts.map +1 -0
  87. package/dist/admin/lib/order-minimum-input.js +16 -0
  88. package/dist/admin/lib/order-minimum-input.js.map +1 -0
  89. package/dist/admin/lib/product-labels.d.ts +12 -0
  90. package/dist/admin/lib/product-labels.d.ts.map +1 -0
  91. package/dist/admin/lib/product-labels.js +23 -0
  92. package/dist/admin/lib/product-labels.js.map +1 -0
  93. package/dist/admin/lib/product-scopes-api.d.ts +23 -0
  94. package/dist/admin/lib/product-scopes-api.d.ts.map +1 -0
  95. package/dist/admin/lib/product-scopes-api.js +57 -0
  96. package/dist/admin/lib/product-scopes-api.js.map +1 -0
  97. package/dist/admin/lib/product-url-keys-api.d.ts +23 -0
  98. package/dist/admin/lib/product-url-keys-api.d.ts.map +1 -0
  99. package/dist/admin/lib/product-url-keys-api.js +61 -0
  100. package/dist/admin/lib/product-url-keys-api.js.map +1 -0
  101. package/dist/admin/lib/resolve-product-selection.d.ts +29 -1
  102. package/dist/admin/lib/resolve-product-selection.d.ts.map +1 -1
  103. package/dist/admin/lib/resolve-product-selection.js +42 -6
  104. package/dist/admin/lib/resolve-product-selection.js.map +1 -1
  105. package/dist/admin/lib/scope-overview.d.ts +73 -0
  106. package/dist/admin/lib/scope-overview.d.ts.map +1 -0
  107. package/dist/admin/lib/scope-overview.js +178 -0
  108. package/dist/admin/lib/scope-overview.js.map +1 -0
  109. package/dist/admin/lib/scoped-editor-store.d.ts +81 -0
  110. package/dist/admin/lib/scoped-editor-store.d.ts.map +1 -0
  111. package/dist/admin/lib/scoped-editor-store.js +198 -0
  112. package/dist/admin/lib/scoped-editor-store.js.map +1 -0
  113. package/dist/admin/lib/scoped-values-api.d.ts +14 -0
  114. package/dist/admin/lib/scoped-values-api.d.ts.map +1 -0
  115. package/dist/admin/lib/scoped-values-api.js +55 -0
  116. package/dist/admin/lib/scoped-values-api.js.map +1 -0
  117. package/dist/admin/pages/AttributesManager.d.ts.map +1 -1
  118. package/dist/admin/pages/AttributesManager.js +186 -28
  119. package/dist/admin/pages/AttributesManager.js.map +1 -1
  120. package/dist/admin/pages/BulkOperationDetailPage.d.ts.map +1 -1
  121. package/dist/admin/pages/BulkOperationDetailPage.js +4 -19
  122. package/dist/admin/pages/BulkOperationDetailPage.js.map +1 -1
  123. package/dist/admin/pages/ProductContentPage.d.ts +27 -0
  124. package/dist/admin/pages/ProductContentPage.d.ts.map +1 -0
  125. package/dist/admin/pages/ProductContentPage.js +161 -0
  126. package/dist/admin/pages/ProductContentPage.js.map +1 -0
  127. package/dist/admin/pages/ProductCreateForm.d.ts +3 -0
  128. package/dist/admin/pages/ProductCreateForm.d.ts.map +1 -0
  129. package/dist/admin/pages/ProductCreateForm.js +87 -0
  130. package/dist/admin/pages/ProductCreateForm.js.map +1 -0
  131. package/dist/admin/pages/ProductEditor.d.ts +0 -4
  132. package/dist/admin/pages/ProductEditor.d.ts.map +1 -1
  133. package/dist/admin/pages/ProductEditor.js +878 -627
  134. package/dist/admin/pages/ProductEditor.js.map +1 -1
  135. package/dist/admin/pages/ProductsList.d.ts +12 -0
  136. package/dist/admin/pages/ProductsList.d.ts.map +1 -1
  137. package/dist/admin/pages/ProductsList.js +111 -54
  138. package/dist/admin/pages/ProductsList.js.map +1 -1
  139. package/dist/backend/admin-search-provider.d.ts +3 -2
  140. package/dist/backend/admin-search-provider.d.ts.map +1 -1
  141. package/dist/backend/admin-search-provider.js +2 -3
  142. package/dist/backend/admin-search-provider.js.map +1 -1
  143. package/dist/backend/commands/attribute-commands.d.ts +4 -3
  144. package/dist/backend/commands/attribute-commands.d.ts.map +1 -1
  145. package/dist/backend/commands/attribute-commands.js +82 -21
  146. package/dist/backend/commands/attribute-commands.js.map +1 -1
  147. package/dist/backend/commands/product-content-commands.d.ts +31 -0
  148. package/dist/backend/commands/product-content-commands.d.ts.map +1 -0
  149. package/dist/backend/commands/product-content-commands.js +70 -0
  150. package/dist/backend/commands/product-content-commands.js.map +1 -0
  151. package/dist/backend/commands/scoped-values.commands.d.ts +95 -0
  152. package/dist/backend/commands/scoped-values.commands.d.ts.map +1 -0
  153. package/dist/backend/commands/scoped-values.commands.js +235 -0
  154. package/dist/backend/commands/scoped-values.commands.js.map +1 -0
  155. package/dist/backend/demo/reset.d.ts.map +1 -1
  156. package/dist/backend/demo/reset.js +2 -1
  157. package/dist/backend/demo/reset.js.map +1 -1
  158. package/dist/backend/demo/rows.d.ts +25 -0
  159. package/dist/backend/demo/rows.d.ts.map +1 -1
  160. package/dist/backend/demo/rows.js +35 -12
  161. package/dist/backend/demo/rows.js.map +1 -1
  162. package/dist/backend/demo/seed.d.ts +2 -1
  163. package/dist/backend/demo/seed.d.ts.map +1 -1
  164. package/dist/backend/demo/seed.js +22 -8
  165. package/dist/backend/demo/seed.js.map +1 -1
  166. package/dist/backend/entities/bulk-operation.entity.d.ts +10 -0
  167. package/dist/backend/entities/bulk-operation.entity.d.ts.map +1 -1
  168. package/dist/backend/entities/bulk-operation.entity.js.map +1 -1
  169. package/dist/backend/entities/gallery-item-scope-override.entity.d.ts +30 -0
  170. package/dist/backend/entities/gallery-item-scope-override.entity.d.ts.map +1 -0
  171. package/dist/backend/entities/gallery-item-scope-override.entity.js +80 -0
  172. package/dist/backend/entities/gallery-item-scope-override.entity.js.map +1 -0
  173. package/dist/backend/entities/gallery-item.entity.d.ts +9 -1
  174. package/dist/backend/entities/gallery-item.entity.d.ts.map +1 -1
  175. package/dist/backend/entities/gallery-item.entity.js +16 -0
  176. package/dist/backend/entities/gallery-item.entity.js.map +1 -1
  177. package/dist/backend/entities/gallery-role-scope-override.entity.d.ts +28 -0
  178. package/dist/backend/entities/gallery-role-scope-override.entity.d.ts.map +1 -0
  179. package/dist/backend/entities/gallery-role-scope-override.entity.js +75 -0
  180. package/dist/backend/entities/gallery-role-scope-override.entity.js.map +1 -0
  181. package/dist/backend/entities/product-attachment-scope-override.entity.d.ts +30 -0
  182. package/dist/backend/entities/product-attachment-scope-override.entity.d.ts.map +1 -0
  183. package/dist/backend/entities/product-attachment-scope-override.entity.js +80 -0
  184. package/dist/backend/entities/product-attachment-scope-override.entity.js.map +1 -0
  185. package/dist/backend/entities/product-attachment.entity.d.ts +6 -1
  186. package/dist/backend/entities/product-attachment.entity.d.ts.map +1 -1
  187. package/dist/backend/entities/product-attachment.entity.js +9 -0
  188. package/dist/backend/entities/product-attachment.entity.js.map +1 -1
  189. package/dist/backend/entities/product-attribute.entity.d.ts +5 -9
  190. package/dist/backend/entities/product-attribute.entity.d.ts.map +1 -1
  191. package/dist/backend/entities/product-attribute.entity.js +5 -13
  192. package/dist/backend/entities/product-attribute.entity.js.map +1 -1
  193. package/dist/backend/entities/product-channel-language-scope.entity.d.ts +23 -0
  194. package/dist/backend/entities/product-channel-language-scope.entity.d.ts.map +1 -0
  195. package/dist/backend/entities/product-channel-language-scope.entity.js +61 -0
  196. package/dist/backend/entities/product-channel-language-scope.entity.js.map +1 -0
  197. package/dist/backend/entities/product-channel-scope.entity.d.ts +47 -0
  198. package/dist/backend/entities/product-channel-scope.entity.d.ts.map +1 -0
  199. package/dist/backend/entities/product-channel-scope.entity.js +113 -0
  200. package/dist/backend/entities/product-channel-scope.entity.js.map +1 -0
  201. package/dist/backend/entities/product-content-value.entity.d.ts +39 -0
  202. package/dist/backend/entities/product-content-value.entity.d.ts.map +1 -0
  203. package/dist/backend/entities/product-content-value.entity.js +81 -0
  204. package/dist/backend/entities/product-content-value.entity.js.map +1 -0
  205. package/dist/backend/entities/product-packaging-unit-scope-override.entity.d.ts +30 -0
  206. package/dist/backend/entities/product-packaging-unit-scope-override.entity.d.ts.map +1 -0
  207. package/dist/backend/entities/product-packaging-unit-scope-override.entity.js +80 -0
  208. package/dist/backend/entities/product-packaging-unit-scope-override.entity.js.map +1 -0
  209. package/dist/backend/entities/product-url-key.entity.d.ts +27 -0
  210. package/dist/backend/entities/product-url-key.entity.d.ts.map +1 -0
  211. package/dist/backend/entities/product-url-key.entity.js +70 -0
  212. package/dist/backend/entities/product-url-key.entity.js.map +1 -0
  213. package/dist/backend/entities/product-url-redirect.entity.d.ts +18 -0
  214. package/dist/backend/entities/product-url-redirect.entity.d.ts.map +1 -0
  215. package/dist/backend/entities/product-url-redirect.entity.js +57 -0
  216. package/dist/backend/entities/product-url-redirect.entity.js.map +1 -0
  217. package/dist/backend/entities/product-variant.entity.d.ts +8 -1
  218. package/dist/backend/entities/product-variant.entity.d.ts.map +1 -1
  219. package/dist/backend/entities/product-variant.entity.js +13 -2
  220. package/dist/backend/entities/product-variant.entity.js.map +1 -1
  221. package/dist/backend/entities/product.entity.d.ts +48 -16
  222. package/dist/backend/entities/product.entity.d.ts.map +1 -1
  223. package/dist/backend/entities/product.entity.js +65 -35
  224. package/dist/backend/entities/product.entity.js.map +1 -1
  225. package/dist/backend/index.d.ts +29 -2
  226. package/dist/backend/index.d.ts.map +1 -1
  227. package/dist/backend/index.js +311 -29
  228. package/dist/backend/index.js.map +1 -1
  229. package/dist/backend/plugin.d.ts +79 -8
  230. package/dist/backend/plugin.d.ts.map +1 -1
  231. package/dist/backend/plugin.js +98 -17
  232. package/dist/backend/plugin.js.map +1 -1
  233. package/dist/backend/prompt-tools.d.ts +11 -0
  234. package/dist/backend/prompt-tools.d.ts.map +1 -1
  235. package/dist/backend/prompt-tools.js +124 -9
  236. package/dist/backend/prompt-tools.js.map +1 -1
  237. package/dist/backend/routes.admin.d.ts +42 -14
  238. package/dist/backend/routes.admin.d.ts.map +1 -1
  239. package/dist/backend/routes.admin.js +214 -134
  240. package/dist/backend/routes.admin.js.map +1 -1
  241. package/dist/backend/routes.admin.url-keys.d.ts +23 -0
  242. package/dist/backend/routes.admin.url-keys.d.ts.map +1 -0
  243. package/dist/backend/routes.admin.url-keys.js +14 -0
  244. package/dist/backend/routes.admin.url-keys.js.map +1 -0
  245. package/dist/backend/routes.api-key.d.ts.map +1 -1
  246. package/dist/backend/routes.api-key.js +18 -3
  247. package/dist/backend/routes.api-key.js.map +1 -1
  248. package/dist/backend/routes.external.d.ts.map +1 -1
  249. package/dist/backend/routes.external.js +6 -1
  250. package/dist/backend/routes.external.js.map +1 -1
  251. package/dist/backend/routes.public.d.ts +31 -7
  252. package/dist/backend/routes.public.d.ts.map +1 -1
  253. package/dist/backend/routes.public.js +114 -33
  254. package/dist/backend/routes.public.js.map +1 -1
  255. package/dist/backend/routes.public.url-keys.d.ts +26 -0
  256. package/dist/backend/routes.public.url-keys.d.ts.map +1 -0
  257. package/dist/backend/routes.public.url-keys.js +17 -0
  258. package/dist/backend/routes.public.url-keys.js.map +1 -0
  259. package/dist/backend/services/asset-references.d.ts +12 -1
  260. package/dist/backend/services/asset-references.d.ts.map +1 -1
  261. package/dist/backend/services/asset-references.js +85 -32
  262. package/dist/backend/services/asset-references.js.map +1 -1
  263. package/dist/backend/services/attachment-packaging-scopes.d.ts +61 -0
  264. package/dist/backend/services/attachment-packaging-scopes.d.ts.map +1 -0
  265. package/dist/backend/services/attachment-packaging-scopes.js +98 -0
  266. package/dist/backend/services/attachment-packaging-scopes.js.map +1 -0
  267. package/dist/backend/services/attachment.service.d.ts +8 -1
  268. package/dist/backend/services/attachment.service.d.ts.map +1 -1
  269. package/dist/backend/services/attachment.service.js +105 -21
  270. package/dist/backend/services/attachment.service.js.map +1 -1
  271. package/dist/backend/services/attribute-filter-match.d.ts +14 -0
  272. package/dist/backend/services/attribute-filter-match.d.ts.map +1 -0
  273. package/dist/backend/services/attribute-filter-match.js +19 -0
  274. package/dist/backend/services/attribute-filter-match.js.map +1 -0
  275. package/dist/backend/services/attribute-scope-preview.d.ts +48 -0
  276. package/dist/backend/services/attribute-scope-preview.d.ts.map +1 -0
  277. package/dist/backend/services/attribute-scope-preview.js +76 -0
  278. package/dist/backend/services/attribute-scope-preview.js.map +1 -0
  279. package/dist/backend/services/attribute-set.service.d.ts +10 -1
  280. package/dist/backend/services/attribute-set.service.d.ts.map +1 -1
  281. package/dist/backend/services/attribute-set.service.js +30 -4
  282. package/dist/backend/services/attribute-set.service.js.map +1 -1
  283. package/dist/backend/services/attribute-type-mapping.d.ts +2 -2
  284. package/dist/backend/services/attribute-type-mapping.d.ts.map +1 -1
  285. package/dist/backend/services/attribute-type-mapping.js +6 -0
  286. package/dist/backend/services/attribute-type-mapping.js.map +1 -1
  287. package/dist/backend/services/attribute-usage.d.ts +31 -0
  288. package/dist/backend/services/attribute-usage.d.ts.map +1 -0
  289. package/dist/backend/services/attribute-usage.js +29 -0
  290. package/dist/backend/services/attribute-usage.js.map +1 -0
  291. package/dist/backend/services/bulk-operation.service.d.ts +36 -0
  292. package/dist/backend/services/bulk-operation.service.d.ts.map +1 -1
  293. package/dist/backend/services/bulk-operation.service.js +210 -37
  294. package/dist/backend/services/bulk-operation.service.js.map +1 -1
  295. package/dist/backend/services/bundle.service.d.ts +9 -1
  296. package/dist/backend/services/bundle.service.d.ts.map +1 -1
  297. package/dist/backend/services/bundle.service.js +31 -3
  298. package/dist/backend/services/bundle.service.js.map +1 -1
  299. package/dist/backend/services/catalog-admin-search.service.d.ts +4 -3
  300. package/dist/backend/services/catalog-admin-search.service.d.ts.map +1 -1
  301. package/dist/backend/services/catalog-admin-search.service.js +7 -7
  302. package/dist/backend/services/catalog-admin-search.service.js.map +1 -1
  303. package/dist/backend/services/catalog-admin.service.d.ts +171 -27
  304. package/dist/backend/services/catalog-admin.service.d.ts.map +1 -1
  305. package/dist/backend/services/catalog-admin.service.js +634 -315
  306. package/dist/backend/services/catalog-admin.service.js.map +1 -1
  307. package/dist/backend/services/catalog-attribute-read.service.d.ts +14 -0
  308. package/dist/backend/services/catalog-attribute-read.service.d.ts.map +1 -1
  309. package/dist/backend/services/catalog-attribute-read.service.js +7 -19
  310. package/dist/backend/services/catalog-attribute-read.service.js.map +1 -1
  311. package/dist/backend/services/catalog-bulk-import.service.d.ts +72 -3
  312. package/dist/backend/services/catalog-bulk-import.service.d.ts.map +1 -1
  313. package/dist/backend/services/catalog-bulk-import.service.js +212 -38
  314. package/dist/backend/services/catalog-bulk-import.service.js.map +1 -1
  315. package/dist/backend/services/catalog-bulk-update.service.d.ts +35 -5
  316. package/dist/backend/services/catalog-bulk-update.service.d.ts.map +1 -1
  317. package/dist/backend/services/catalog-bulk-update.service.js +123 -14
  318. package/dist/backend/services/catalog-bulk-update.service.js.map +1 -1
  319. package/dist/backend/services/catalog-org-price-decorator.d.ts +12 -25
  320. package/dist/backend/services/catalog-org-price-decorator.d.ts.map +1 -1
  321. package/dist/backend/services/catalog-org-price-decorator.js +48 -13
  322. package/dist/backend/services/catalog-org-price-decorator.js.map +1 -1
  323. package/dist/backend/services/catalog-product-filter.service.d.ts +16 -2
  324. package/dist/backend/services/catalog-product-filter.service.d.ts.map +1 -1
  325. package/dist/backend/services/catalog-product-filter.service.js +80 -3
  326. package/dist/backend/services/catalog-product-filter.service.js.map +1 -1
  327. package/dist/backend/services/catalog-product-read.service.d.ts +11 -1
  328. package/dist/backend/services/catalog-product-read.service.d.ts.map +1 -1
  329. package/dist/backend/services/catalog-product-read.service.js +40 -23
  330. package/dist/backend/services/catalog-product-read.service.js.map +1 -1
  331. package/dist/backend/services/catalog-query.service.d.ts +170 -42
  332. package/dist/backend/services/catalog-query.service.d.ts.map +1 -1
  333. package/dist/backend/services/catalog-query.service.js +797 -430
  334. package/dist/backend/services/catalog-query.service.js.map +1 -1
  335. package/dist/backend/services/catalog-quick-search.service.d.ts +18 -2
  336. package/dist/backend/services/catalog-quick-search.service.d.ts.map +1 -1
  337. package/dist/backend/services/catalog-quick-search.service.js +53 -21
  338. package/dist/backend/services/catalog-quick-search.service.js.map +1 -1
  339. package/dist/backend/services/catalog-write-ports.d.ts +16 -1
  340. package/dist/backend/services/catalog-write-ports.d.ts.map +1 -1
  341. package/dist/backend/services/catalog-write-ports.js +18 -0
  342. package/dist/backend/services/catalog-write-ports.js.map +1 -1
  343. package/dist/backend/services/category-admin.service.d.ts +12 -1
  344. package/dist/backend/services/category-admin.service.d.ts.map +1 -1
  345. package/dist/backend/services/category-admin.service.js +32 -3
  346. package/dist/backend/services/category-admin.service.js.map +1 -1
  347. package/dist/backend/services/channel-url-facts.d.ts +17 -0
  348. package/dist/backend/services/channel-url-facts.d.ts.map +1 -0
  349. package/dist/backend/services/channel-url-facts.js +20 -0
  350. package/dist/backend/services/channel-url-facts.js.map +1 -0
  351. package/dist/backend/services/content-attribute-rules.d.ts +49 -0
  352. package/dist/backend/services/content-attribute-rules.d.ts.map +1 -0
  353. package/dist/backend/services/content-attribute-rules.js +89 -0
  354. package/dist/backend/services/content-attribute-rules.js.map +1 -0
  355. package/dist/backend/services/effective-value.sql.d.ts +42 -0
  356. package/dist/backend/services/effective-value.sql.d.ts.map +1 -0
  357. package/dist/backend/services/effective-value.sql.js +61 -0
  358. package/dist/backend/services/effective-value.sql.js.map +1 -0
  359. package/dist/backend/services/gallery-scopes.d.ts +63 -0
  360. package/dist/backend/services/gallery-scopes.d.ts.map +1 -0
  361. package/dist/backend/services/gallery-scopes.js +158 -0
  362. package/dist/backend/services/gallery-scopes.js.map +1 -0
  363. package/dist/backend/services/gallery.service.d.ts +32 -4
  364. package/dist/backend/services/gallery.service.d.ts.map +1 -1
  365. package/dist/backend/services/gallery.service.js +182 -44
  366. package/dist/backend/services/gallery.service.js.map +1 -1
  367. package/dist/backend/services/grouped.service.d.ts.map +1 -1
  368. package/dist/backend/services/grouped.service.js +13 -1
  369. package/dist/backend/services/grouped.service.js.map +1 -1
  370. package/dist/backend/services/linkable-asset.d.ts +21 -0
  371. package/dist/backend/services/linkable-asset.d.ts.map +1 -0
  372. package/dist/backend/services/linkable-asset.js +31 -0
  373. package/dist/backend/services/linkable-asset.js.map +1 -0
  374. package/dist/backend/services/packaging-unit.service.d.ts.map +1 -1
  375. package/dist/backend/services/packaging-unit.service.js +73 -47
  376. package/dist/backend/services/packaging-unit.service.js.map +1 -1
  377. package/dist/backend/services/page-builder-content.d.ts +64 -0
  378. package/dist/backend/services/page-builder-content.d.ts.map +1 -0
  379. package/dist/backend/services/page-builder-content.js +113 -0
  380. package/dist/backend/services/page-builder-content.js.map +1 -0
  381. package/dist/backend/services/primary-asset-url.d.ts +12 -1
  382. package/dist/backend/services/primary-asset-url.d.ts.map +1 -1
  383. package/dist/backend/services/primary-asset-url.js +50 -14
  384. package/dist/backend/services/primary-asset-url.js.map +1 -1
  385. package/dist/backend/services/product-availability.service.d.ts +92 -0
  386. package/dist/backend/services/product-availability.service.d.ts.map +1 -0
  387. package/dist/backend/services/product-availability.service.js +260 -0
  388. package/dist/backend/services/product-availability.service.js.map +1 -0
  389. package/dist/backend/services/product-availability.sql.d.ts +71 -0
  390. package/dist/backend/services/product-availability.sql.d.ts.map +1 -0
  391. package/dist/backend/services/product-availability.sql.js +77 -0
  392. package/dist/backend/services/product-availability.sql.js.map +1 -0
  393. package/dist/backend/services/product-content.service.d.ts +62 -0
  394. package/dist/backend/services/product-content.service.d.ts.map +1 -0
  395. package/dist/backend/services/product-content.service.js +122 -0
  396. package/dist/backend/services/product-content.service.js.map +1 -0
  397. package/dist/backend/services/product-editor-preferences.service.d.ts +6 -0
  398. package/dist/backend/services/product-editor-preferences.service.d.ts.map +1 -1
  399. package/dist/backend/services/product-editor-preferences.service.js +12 -0
  400. package/dist/backend/services/product-editor-preferences.service.js.map +1 -1
  401. package/dist/backend/services/product-global-field-rules.d.ts +39 -0
  402. package/dist/backend/services/product-global-field-rules.d.ts.map +1 -0
  403. package/dist/backend/services/product-global-field-rules.js +84 -0
  404. package/dist/backend/services/product-global-field-rules.js.map +1 -0
  405. package/dist/backend/services/product-link.service.d.ts +10 -9
  406. package/dist/backend/services/product-link.service.d.ts.map +1 -1
  407. package/dist/backend/services/product-link.service.js +44 -36
  408. package/dist/backend/services/product-link.service.js.map +1 -1
  409. package/dist/backend/services/product-list-view-service.d.ts.map +1 -1
  410. package/dist/backend/services/product-list-view-service.js +5 -8
  411. package/dist/backend/services/product-list-view-service.js.map +1 -1
  412. package/dist/backend/services/product-page-revalidation.d.ts +60 -0
  413. package/dist/backend/services/product-page-revalidation.d.ts.map +1 -0
  414. package/dist/backend/services/product-page-revalidation.js +165 -0
  415. package/dist/backend/services/product-page-revalidation.js.map +1 -0
  416. package/dist/backend/services/product-scopes.service.d.ts +221 -0
  417. package/dist/backend/services/product-scopes.service.d.ts.map +1 -0
  418. package/dist/backend/services/product-scopes.service.js +692 -0
  419. package/dist/backend/services/product-scopes.service.js.map +1 -0
  420. package/dist/backend/services/product-summary-text.d.ts +8 -0
  421. package/dist/backend/services/product-summary-text.d.ts.map +1 -0
  422. package/dist/backend/services/product-summary-text.js +8 -0
  423. package/dist/backend/services/product-summary-text.js.map +1 -0
  424. package/dist/backend/services/product-value-resolver.service.d.ts +2 -2
  425. package/dist/backend/services/product-value-resolver.service.d.ts.map +1 -1
  426. package/dist/backend/services/product-value-resolver.service.js +4 -7
  427. package/dist/backend/services/product-value-resolver.service.js.map +1 -1
  428. package/dist/backend/services/publication-window-sweep.d.ts +131 -0
  429. package/dist/backend/services/publication-window-sweep.d.ts.map +1 -0
  430. package/dist/backend/services/publication-window-sweep.js +204 -0
  431. package/dist/backend/services/publication-window-sweep.js.map +1 -0
  432. package/dist/backend/services/scheduled-work-probe.d.ts +34 -0
  433. package/dist/backend/services/scheduled-work-probe.d.ts.map +1 -0
  434. package/dist/backend/services/scheduled-work-probe.js +30 -0
  435. package/dist/backend/services/scheduled-work-probe.js.map +1 -0
  436. package/dist/backend/services/scope-completeness.d.ts +107 -0
  437. package/dist/backend/services/scope-completeness.d.ts.map +1 -0
  438. package/dist/backend/services/scope-completeness.js +173 -0
  439. package/dist/backend/services/scope-completeness.js.map +1 -0
  440. package/dist/backend/services/scope-overview.service.d.ts +112 -0
  441. package/dist/backend/services/scope-overview.service.d.ts.map +1 -0
  442. package/dist/backend/services/scope-overview.service.js +329 -0
  443. package/dist/backend/services/scope-overview.service.js.map +1 -0
  444. package/dist/backend/services/scoped-store-adapters.d.ts +58 -0
  445. package/dist/backend/services/scoped-store-adapters.d.ts.map +1 -0
  446. package/dist/backend/services/scoped-store-adapters.js +92 -0
  447. package/dist/backend/services/scoped-store-adapters.js.map +1 -0
  448. package/dist/backend/services/scoped-values-global-only.d.ts +36 -0
  449. package/dist/backend/services/scoped-values-global-only.d.ts.map +1 -0
  450. package/dist/backend/services/scoped-values-global-only.js +92 -0
  451. package/dist/backend/services/scoped-values-global-only.js.map +1 -0
  452. package/dist/backend/services/scoped-values-import.d.ts +86 -0
  453. package/dist/backend/services/scoped-values-import.d.ts.map +1 -0
  454. package/dist/backend/services/scoped-values-import.js +320 -0
  455. package/dist/backend/services/scoped-values-import.js.map +1 -0
  456. package/dist/backend/services/scoped-values-read.service.d.ts +56 -0
  457. package/dist/backend/services/scoped-values-read.service.d.ts.map +1 -0
  458. package/dist/backend/services/scoped-values-read.service.js +289 -0
  459. package/dist/backend/services/scoped-values-read.service.js.map +1 -0
  460. package/dist/backend/services/scoped-values-save.service.d.ts +79 -0
  461. package/dist/backend/services/scoped-values-save.service.d.ts.map +1 -0
  462. package/dist/backend/services/scoped-values-save.service.js +675 -0
  463. package/dist/backend/services/scoped-values-save.service.js.map +1 -0
  464. package/dist/backend/services/scoped-values-state.d.ts +94 -0
  465. package/dist/backend/services/scoped-values-state.d.ts.map +1 -0
  466. package/dist/backend/services/scoped-values-state.js +159 -0
  467. package/dist/backend/services/scoped-values-state.js.map +1 -0
  468. package/dist/backend/services/scoped-values.service.d.ts +36 -0
  469. package/dist/backend/services/scoped-values.service.d.ts.map +1 -0
  470. package/dist/backend/services/scoped-values.service.js +92 -0
  471. package/dist/backend/services/scoped-values.service.js.map +1 -0
  472. package/dist/backend/services/sql-id-arrays.d.ts +16 -0
  473. package/dist/backend/services/sql-id-arrays.d.ts.map +1 -0
  474. package/dist/backend/services/sql-id-arrays.js +24 -0
  475. package/dist/backend/services/sql-id-arrays.js.map +1 -0
  476. package/dist/backend/services/storefront-value-overrides.d.ts +7 -8
  477. package/dist/backend/services/storefront-value-overrides.d.ts.map +1 -1
  478. package/dist/backend/services/storefront-value-overrides.js +11 -14
  479. package/dist/backend/services/storefront-value-overrides.js.map +1 -1
  480. package/dist/backend/services/url-key-resolution.service.d.ts +70 -0
  481. package/dist/backend/services/url-key-resolution.service.d.ts.map +1 -0
  482. package/dist/backend/services/url-key-resolution.service.js +179 -0
  483. package/dist/backend/services/url-key-resolution.service.js.map +1 -0
  484. package/dist/backend/services/url-key.service.d.ts +123 -0
  485. package/dist/backend/services/url-key.service.d.ts.map +1 -0
  486. package/dist/backend/services/url-key.service.js +566 -0
  487. package/dist/backend/services/url-key.service.js.map +1 -0
  488. package/dist/manifest.d.ts +9 -1
  489. package/dist/manifest.d.ts.map +1 -1
  490. package/dist/manifest.js +204 -10
  491. package/dist/manifest.js.map +1 -1
  492. package/dist/migrations/20261022T035133_catalog_product_scopes.d.ts +28 -0
  493. package/dist/migrations/20261022T035133_catalog_product_scopes.d.ts.map +1 -0
  494. package/dist/migrations/20261022T035133_catalog_product_scopes.js +92 -0
  495. package/dist/migrations/20261022T035133_catalog_product_scopes.js.map +1 -0
  496. package/dist/migrations/20261022T054223_catalog_product_url_keys.d.ts +32 -0
  497. package/dist/migrations/20261022T054223_catalog_product_url_keys.d.ts.map +1 -0
  498. package/dist/migrations/20261022T054223_catalog_product_url_keys.js +81 -0
  499. package/dist/migrations/20261022T054223_catalog_product_url_keys.js.map +1 -0
  500. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.d.ts +34 -0
  501. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.d.ts.map +1 -0
  502. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.js +57 -0
  503. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.js.map +1 -0
  504. package/dist/migrations/20261026T033453_catalog_product_media_scopes.d.ts +26 -0
  505. package/dist/migrations/20261026T033453_catalog_product_media_scopes.d.ts.map +1 -0
  506. package/dist/migrations/20261026T033453_catalog_product_media_scopes.js +54 -0
  507. package/dist/migrations/20261026T033453_catalog_product_media_scopes.js.map +1 -0
  508. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.d.ts +27 -0
  509. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.d.ts.map +1 -0
  510. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.js +45 -0
  511. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.js.map +1 -0
  512. package/dist/migrations/20261030T113855_catalog_scope_model_texts.d.ts +36 -0
  513. package/dist/migrations/20261030T113855_catalog_scope_model_texts.d.ts.map +1 -0
  514. package/dist/migrations/20261030T113855_catalog_scope_model_texts.js +225 -0
  515. package/dist/migrations/20261030T113855_catalog_scope_model_texts.js.map +1 -0
  516. package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.d.ts +18 -0
  517. package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.d.ts.map +1 -0
  518. package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.js +39 -0
  519. package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.js.map +1 -0
  520. package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.d.ts +6 -0
  521. package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.d.ts.map +1 -0
  522. package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.js +119 -0
  523. package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.js.map +1 -0
  524. package/dist/migrations/20261030T113908_catalog_scope_model_media.d.ts +6 -0
  525. package/dist/migrations/20261030T113908_catalog_scope_model_media.d.ts.map +1 -0
  526. package/dist/migrations/20261030T113908_catalog_scope_model_media.js +185 -0
  527. package/dist/migrations/20261030T113908_catalog_scope_model_media.js.map +1 -0
  528. package/dist/migrations/20261104T121504_catalog_product_content_values.d.ts +36 -0
  529. package/dist/migrations/20261104T121504_catalog_product_content_values.d.ts.map +1 -0
  530. package/dist/migrations/20261104T121504_catalog_product_content_values.js +53 -0
  531. package/dist/migrations/20261104T121504_catalog_product_content_values.js.map +1 -0
  532. package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.d.ts +33 -0
  533. package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.d.ts.map +1 -0
  534. package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.js +58 -0
  535. package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.js.map +1 -0
  536. package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.d.ts +36 -0
  537. package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.d.ts.map +1 -0
  538. package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.js +40 -0
  539. package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.js.map +1 -0
  540. package/dist/migrations/index.d.ts +13 -1
  541. package/dist/migrations/index.d.ts.map +1 -1
  542. package/dist/migrations/index.js +25 -1
  543. package/dist/migrations/index.js.map +1 -1
  544. package/docs/catalog/attachments.md +60 -8
  545. package/docs/catalog/attribute-sets.md +2 -2
  546. package/docs/catalog/attributes.md +68 -8
  547. package/docs/catalog/category-content.md +3 -0
  548. package/docs/catalog/composite-products.md +2 -2
  549. package/docs/catalog/editing-a-product-at-a-scope.md +95 -0
  550. package/docs/catalog/gallery-and-labels.md +68 -8
  551. package/docs/catalog/packaging-units.md +56 -10
  552. package/docs/catalog/per-channel-per-language-overrides.md +68 -237
  553. package/docs/catalog/product-content.md +180 -0
  554. package/docs/catalog/product-links.md +2 -2
  555. package/docs/catalog/url-keys-and-redirects.md +142 -0
  556. package/docs/catalog.md +241 -20
  557. package/i18n/en.json +977 -123
  558. package/i18n/pl.json +976 -122
  559. package/package.json +12 -12
  560. package/dist/admin/components/ProductScopeEditor.d.ts +0 -94
  561. package/dist/admin/components/ProductScopeEditor.d.ts.map +0 -1
  562. package/dist/admin/components/ProductScopeEditor.js +0 -395
  563. package/dist/admin/components/ProductScopeEditor.js.map +0 -1
  564. package/dist/backend/services/product-overrides.service.d.ts +0 -77
  565. package/dist/backend/services/product-overrides.service.d.ts.map +0 -1
  566. package/dist/backend/services/product-overrides.service.js +0 -204
  567. package/dist/backend/services/product-overrides.service.js.map +0 -1
  568. package/dist/backend/services/product-scope-context.service.d.ts +0 -36
  569. package/dist/backend/services/product-scope-context.service.d.ts.map +0 -1
  570. package/dist/backend/services/product-scope-context.service.js +0 -106
  571. package/dist/backend/services/product-scope-context.service.js.map +0 -1
@@ -0,0 +1,107 @@
1
+ import type { EntityManager } from '@mikro-orm/postgresql';
2
+ import { type OverrideRow, type ScopeLevel, type ScopeChannel, type ScopeCompletenessGateMode, type ScopeMissingValue, type ScopeSnapshot, type ScopeWarning } from '@endora-commerce/contracts';
3
+ import type { SalesChannelMembershipPort, SettingsReadPort } from '@endora-commerce/platform/kernel';
4
+ import type { Product } from '../entities/product.entity.js';
5
+ import type { CatalogAttributeReadService } from './catalog-attribute-read.service.js';
6
+ /**
7
+ * Feature 163 (`specs/163-product-data-scopes/`) — the completeness gate (US6, FR-060,
8
+ * FR-061, research R18) and what it would report at a scope-overview cell (FR-041).
9
+ *
10
+ * {@link checkCompleteness} is the one definition of "complete at (C, L)": the name and
11
+ * every required language-scoped attribute count only where they are set at (C, L), at
12
+ * C, or for L itself — the resolver's fallback to another language never satisfies them
13
+ * (FR-060, last sentence) — and the URL key is satisfied by the product's effective key
14
+ * there, the global key included (K3).
15
+ *
16
+ * The gate asks it only about the pairs a **status write** turns on
17
+ * ({@link completenessFailures} over `pairsTurningOn`, owner decision M3 → A): joining a
18
+ * channel, a channel gaining a language, a window opening, an audience change, Archive
19
+ * and Restore never reach it. It runs only where an operator's write asks for it, with
20
+ * the mode the caller read once for the request: imports, connectors and the API-key
21
+ * upsert never pass a mode, so they are never gated (A-6, FR-061).
22
+ */
23
+ /** The setting that chooses the gate's mode — one platform-wide value (FR-060). */
24
+ export declare const SCOPE_COMPLETENESS_GATE_SETTING = "catalog.scope_completeness_gate";
25
+ /** Everything {@link checkCompleteness} reads about one product. */
26
+ export interface CompletenessFacts {
27
+ /** Feature 174 — the Global name, one string. */
28
+ name: string;
29
+ /** The global URL key (`products.slug`). */
30
+ slug: string;
31
+ attributeValues: Readonly<Record<string, unknown>>;
32
+ /** The required user attributes of the product's attribute set, by key (R16). */
33
+ requiredAttributes: readonly string[];
34
+ /** The user-defined attributes' scope sets, by key (`attributeScopeSet`). */
35
+ attributeLevels: ReadonlyMap<string, readonly ScopeLevel[]>;
36
+ valueOverrides: readonly OverrideRow[];
37
+ /** `languageCode` `null` = a Channel key. */
38
+ urlKeys: ReadonlyArray<{
39
+ languageCode: string | null;
40
+ salesChannelId: string;
41
+ }>;
42
+ }
43
+ /** A failing pair: a (channel, language) the write turns on, and what it lacks there. */
44
+ export interface CompletenessFailure {
45
+ channelId: string;
46
+ languageCode: string;
47
+ missing: ScopeMissingValue[];
48
+ }
49
+ /**
50
+ * What the gate reports missing at (channel, language) — `[]` when complete. Name
51
+ * first, then the URL key, then the attributes by key. Status is not an input: the
52
+ * overview asks it for every evaluable cell whatever its status (FR-041).
53
+ */
54
+ export declare function checkCompleteness(facts: CompletenessFacts, channelId: string, languageCode: string): ScopeMissingValue[];
55
+ /** The pairs a status write turns on that lack a required value — the gate's subject. */
56
+ export declare function completenessFailures(before: ScopeSnapshot, after: ScopeSnapshot, channels: readonly ScopeChannel[], facts: CompletenessFacts): CompletenessFailure[];
57
+ /**
58
+ * What the mode makes of the failures (FR-060): `warn` → the write is saved and each
59
+ * failing pair is a `completeness` warning; `refuse` → `422 SCOPE_INCOMPLETE` naming
60
+ * every failing pair, so the write is refused as a whole (N3).
61
+ */
62
+ export declare function completenessOutcome(mode: ScopeCompletenessGateMode, failures: readonly CompletenessFailure[]): ScopeWarning[];
63
+ /** The required, language-scoped user attributes among an attribute set's definitions. */
64
+ export declare function requiredAttributeKeys(views: ReadonlyArray<{
65
+ key: string;
66
+ customFieldDefinitionId: string;
67
+ isRequired: boolean;
68
+ }>, setDefinitionIds: ReadonlySet<string>): string[];
69
+ /** The definitions an attribute set holds. */
70
+ export declare function attributeSetDefinitionIds(em: EntityManager, attributeSetId: string | null | undefined): Promise<Set<string>>;
71
+ /**
72
+ * The gate's I/O: the mode, the product's member channels and the facts
73
+ * {@link checkCompleteness} reads. Composed only into the operator's admin services;
74
+ * the integration ports are built without it.
75
+ */
76
+ export declare class ScopeCompletenessGate {
77
+ private readonly membership;
78
+ private readonly attributeRead;
79
+ private readonly settings;
80
+ constructor(membership: Pick<SalesChannelMembershipPort, 'listChannelsForEntity'>, attributeRead: Pick<CatalogAttributeReadService, 'listAll'>, settings: Pick<SettingsReadPort, 'get'>);
81
+ /** The platform-wide mode (`catalog.scope_completeness_gate`), read once per request. */
82
+ mode(): Promise<ScopeCompletenessGateMode>;
83
+ /** The product's member channels with their languages, as the rule reads them. */
84
+ memberChannels(productId: string): Promise<ScopeChannel[]>;
85
+ /** Everything {@link checkCompleteness} reads about `product`, on `em` (inside the caller's transaction). */
86
+ facts(em: EntityManager, product: Product): Promise<CompletenessFacts>;
87
+ /**
88
+ * Run the gate for one product's status write: the pairs `before` → `after` turns on
89
+ * among `channels`, checked against the product's facts. Returns the warnings in
90
+ * `warn`; throws `SCOPE_INCOMPLETE` in `refuse`. Reads nothing when no pair turns on.
91
+ */
92
+ enforce(em: EntityManager, product: Product, before: ScopeSnapshot, after: ScopeSnapshot, channels: readonly ScopeChannel[], mode: ScopeCompletenessGateMode): Promise<ScopeWarning[]>;
93
+ }
94
+ /**
95
+ * Checkpoint C security review (I7) — the gate composed for the operator's services,
96
+ * or `undefined` with **one** warning naming what the composition lacks: a deployment
97
+ * that wires no settings read (or no membership, no attribute read) must not run with
98
+ * the completeness check silently off.
99
+ */
100
+ export declare function composeCompletenessGate(deps: {
101
+ membership?: Pick<SalesChannelMembershipPort, 'listChannelsForEntity'> | undefined;
102
+ attributeRead?: Pick<CatalogAttributeReadService, 'listAll'> | undefined;
103
+ settings?: Pick<SettingsReadPort, 'get'> | undefined;
104
+ }, log: {
105
+ warn(obj: unknown, msg?: string): void;
106
+ } | undefined): ScopeCompletenessGate | undefined;
107
+ //# sourceMappingURL=scope-completeness.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scope-completeness.d.ts","sourceRoot":"","sources":["../../../src/backend/services/scope-completeness.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,173 @@
1
+ import { z } from 'zod';
2
+ import { ERROR_CODES, SCOPE_COMPLETENESS_GATE_MODES, isNonEmpty, pairsTurningOn, resolveAttribute, toScopeChannel, sameLanguage, } from '@endora-commerce/contracts';
3
+ import { HttpError } from '@endora-commerce/platform/http';
4
+ import { ProductUrlKey } from '../entities/product-url-key.entity.js';
5
+ import { ProductValueOverride } from '../entities/product-value-override.entity.js';
6
+ /**
7
+ * Feature 163 (`specs/163-product-data-scopes/`) — the completeness gate (US6, FR-060,
8
+ * FR-061, research R18) and what it would report at a scope-overview cell (FR-041).
9
+ *
10
+ * {@link checkCompleteness} is the one definition of "complete at (C, L)": the name and
11
+ * every required language-scoped attribute count only where they are set at (C, L), at
12
+ * C, or for L itself — the resolver's fallback to another language never satisfies them
13
+ * (FR-060, last sentence) — and the URL key is satisfied by the product's effective key
14
+ * there, the global key included (K3).
15
+ *
16
+ * The gate asks it only about the pairs a **status write** turns on
17
+ * ({@link completenessFailures} over `pairsTurningOn`, owner decision M3 → A): joining a
18
+ * channel, a channel gaining a language, a window opening, an audience change, Archive
19
+ * and Restore never reach it. It runs only where an operator's write asks for it, with
20
+ * the mode the caller read once for the request: imports, connectors and the API-key
21
+ * upsert never pass a mode, so they are never gated (A-6, FR-061).
22
+ */
23
+ /** The setting that chooses the gate's mode — one platform-wide value (FR-060). */
24
+ export const SCOPE_COMPLETENESS_GATE_SETTING = 'catalog.scope_completeness_gate';
25
+ /** Present, and for text not blank. */
26
+ function hasValue(value) {
27
+ if (typeof value === 'string')
28
+ return value.trim().length > 0;
29
+ return isNonEmpty(value);
30
+ }
31
+ const TEXT_LEVELS = ['G', 'C', 'CL'];
32
+ /**
33
+ * Feature 174 (R16, FR-095, FR-096) — the field's effective value at (C, L) along C×L → C → G,
34
+ * restricted to its scope set: a Global value satisfies every (C, L); an empty override at C×L
35
+ * or C does not.
36
+ */
37
+ function effectiveAt(facts, attributeKey, levels, baseline, channelId, languageCode) {
38
+ return resolveAttribute({
39
+ attributeKey,
40
+ baseline,
41
+ overrides: facts.valueOverrides,
42
+ levels,
43
+ ctx: { channelId, languageCode },
44
+ }).value;
45
+ }
46
+ /**
47
+ * What the gate reports missing at (channel, language) — `[]` when complete. Name
48
+ * first, then the URL key, then the attributes by key. Status is not an input: the
49
+ * overview asks it for every evaluable cell whatever its status (FR-041).
50
+ */
51
+ export function checkCompleteness(facts, channelId, languageCode) {
52
+ const missing = [];
53
+ if (!hasValue(effectiveAt(facts, 'name', TEXT_LEVELS, facts.name, channelId, languageCode)))
54
+ missing.push('name');
55
+ const keyed = hasValue(facts.slug) ||
56
+ facts.urlKeys.some((key) => key.salesChannelId === channelId && (key.languageCode === null || sameLanguage(key.languageCode, languageCode)));
57
+ if (!keyed)
58
+ missing.push('urlKey');
59
+ for (const key of [...facts.requiredAttributes].sort()) {
60
+ const levels = facts.attributeLevels.get(key) ?? ['G'];
61
+ if (hasValue(effectiveAt(facts, key, levels, facts.attributeValues[key], channelId, languageCode)))
62
+ continue;
63
+ missing.push(`attribute:${key}`);
64
+ }
65
+ return missing;
66
+ }
67
+ /** The pairs a status write turns on that lack a required value — the gate's subject. */
68
+ export function completenessFailures(before, after, channels, facts) {
69
+ return pairsTurningOn(before, after, channels).flatMap(({ channelId, languageCode }) => {
70
+ const missing = checkCompleteness(facts, channelId, languageCode);
71
+ return missing.length === 0 ? [] : [{ channelId, languageCode, missing }];
72
+ });
73
+ }
74
+ /**
75
+ * What the mode makes of the failures (FR-060): `warn` → the write is saved and each
76
+ * failing pair is a `completeness` warning; `refuse` → `422 SCOPE_INCOMPLETE` naming
77
+ * every failing pair, so the write is refused as a whole (N3).
78
+ */
79
+ export function completenessOutcome(mode, failures) {
80
+ if (failures.length === 0)
81
+ return [];
82
+ if (mode === 'refuse') {
83
+ throw new HttpError(422, ERROR_CODES.SCOPE_INCOMPLETE, 'The product cannot be switched on where required content is missing.', { pairs: failures.map((failure) => ({ ...failure, missing: [...failure.missing] })) });
84
+ }
85
+ return failures.map((failure) => ({ kind: 'completeness', ...failure, missing: [...failure.missing] }));
86
+ }
87
+ /** The required, language-scoped user attributes among an attribute set's definitions. */
88
+ export function requiredAttributeKeys(views, setDefinitionIds) {
89
+ return views
90
+ .filter((view) => view.isRequired && setDefinitionIds.has(view.customFieldDefinitionId))
91
+ .map((view) => view.key)
92
+ .sort();
93
+ }
94
+ /** The definitions an attribute set holds. */
95
+ export async function attributeSetDefinitionIds(em, attributeSetId) {
96
+ if (!attributeSetId)
97
+ return new Set();
98
+ const rows = await em
99
+ .getConnection()
100
+ .execute(`select custom_field_definition_id from attribute_set_attributes where attribute_set_id = ?`, [attributeSetId], 'all', em.getTransactionContext());
101
+ return new Set(rows.map((row) => row.custom_field_definition_id));
102
+ }
103
+ /**
104
+ * The gate's I/O: the mode, the product's member channels and the facts
105
+ * {@link checkCompleteness} reads. Composed only into the operator's admin services;
106
+ * the integration ports are built without it.
107
+ */
108
+ export class ScopeCompletenessGate {
109
+ membership;
110
+ attributeRead;
111
+ settings;
112
+ constructor(membership, attributeRead, settings) {
113
+ this.membership = membership;
114
+ this.attributeRead = attributeRead;
115
+ this.settings = settings;
116
+ }
117
+ /** The platform-wide mode (`catalog.scope_completeness_gate`), read once per request. */
118
+ mode() {
119
+ return this.settings.get(SCOPE_COMPLETENESS_GATE_SETTING, null, z.enum(SCOPE_COMPLETENESS_GATE_MODES));
120
+ }
121
+ /** The product's member channels with their languages, as the rule reads them. */
122
+ async memberChannels(productId) {
123
+ return (await this.membership.listChannelsForEntity('product', productId)).map((channel) => toScopeChannel(channel));
124
+ }
125
+ /** Everything {@link checkCompleteness} reads about `product`, on `em` (inside the caller's transaction). */
126
+ async facts(em, product) {
127
+ const [overrides, urlKeys, views, setDefinitions] = await Promise.all([
128
+ em.find(ProductValueOverride, { productId: product.id }),
129
+ em.find(ProductUrlKey, { productId: product.id }),
130
+ this.attributeRead.listAll(),
131
+ attributeSetDefinitionIds(em, product.attributeSetId),
132
+ ]);
133
+ return {
134
+ name: product.name ?? '',
135
+ slug: product.slug ?? '',
136
+ attributeValues: product.attributeValues ?? {},
137
+ requiredAttributes: requiredAttributeKeys(views, setDefinitions),
138
+ attributeLevels: new Map(views.map((view) => [view.key, view.scopeLevels])),
139
+ valueOverrides: overrides.map((row) => ({
140
+ attributeKey: row.attributeKey,
141
+ channelId: row.channelId,
142
+ languageCode: row.languageCode ?? null,
143
+ value: row.value,
144
+ })),
145
+ urlKeys: urlKeys.map((row) => ({ languageCode: row.languageCode, salesChannelId: row.salesChannelId })),
146
+ };
147
+ }
148
+ /**
149
+ * Run the gate for one product's status write: the pairs `before` → `after` turns on
150
+ * among `channels`, checked against the product's facts. Returns the warnings in
151
+ * `warn`; throws `SCOPE_INCOMPLETE` in `refuse`. Reads nothing when no pair turns on.
152
+ */
153
+ async enforce(em, product, before, after, channels, mode) {
154
+ if (pairsTurningOn(before, after, channels).length === 0)
155
+ return [];
156
+ return completenessOutcome(mode, completenessFailures(before, after, channels, await this.facts(em, product)));
157
+ }
158
+ }
159
+ /**
160
+ * Checkpoint C security review (I7) — the gate composed for the operator's services,
161
+ * or `undefined` with **one** warning naming what the composition lacks: a deployment
162
+ * that wires no settings read (or no membership, no attribute read) must not run with
163
+ * the completeness check silently off.
164
+ */
165
+ export function composeCompletenessGate(deps, log) {
166
+ if (deps.membership && deps.attributeRead && deps.settings) {
167
+ return new ScopeCompletenessGate(deps.membership, deps.attributeRead, deps.settings);
168
+ }
169
+ const missing = ['membership', 'attributeRead', 'settings'].filter((name) => !deps[name]);
170
+ log?.warn({ missing }, '[catalog] the scope completeness gate is not composed: status writes run unchecked in this composition');
171
+ return undefined;
172
+ }
173
+ //# sourceMappingURL=scope-completeness.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scope-completeness.js","sourceRoot":"","sources":["../../../src/backend/services/scope-completeness.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,112 @@
1
+ import type { EntityManager } from '@mikro-orm/postgresql';
2
+ import { type LanguageReadPort, type OverrideRow, type ProductChannelLanguageScopeRecord, type ProductChannelScopeRecord, type ProductScopeStatus, type PublicationWindow, type ScopeLevel, type ScopeOverviewResponse } from '@endora-commerce/contracts';
3
+ import type { SalesChannelMembershipPort } from '@endora-commerce/platform/kernel';
4
+ import type { CatalogAttributeReadService } from './catalog-attribute-read.service.js';
5
+ /**
6
+ * Feature 163 (`specs/163-product-data-scopes/`) — the scope overview of one product,
7
+ * `GET /api/v1/admin/catalog/products/:id/scope-overview` (`contracts/admin-scopes-api.md`
8
+ * §3; US4, FR-015, FR-041), on feature 174's three levels (FR-010, FR-100, FR-101).
9
+ *
10
+ * A read: channels × languages, each cell's effective status and where it comes from, the
11
+ * fields overridden at the cell (C×L) and at the whole channel (C), and every override the
12
+ * resolution ignores (orphans, FR-015) with the reason. There is no Language level (FR-010):
13
+ * an override sits at C or at C×L, and the Global value is the product's own.
14
+ *
15
+ * Field names are the owning write's: `status`, `window`, `audience`,
16
+ * `minOrderQuantity`, `returnable` (the scopes PATCH), `name`, `description`,
17
+ * `attribute:<key>` (the value overrides — the spelling `ScopeMissingValue` uses) and
18
+ * `urlKey` (the URL keys). A cell lists each field once, at the level that wins there
19
+ * (C×L, then C — FR-013).
20
+ *
21
+ * Every orphan listed can be removed (FR-101): the scopes PATCH and `PUT …/url-keys` remove at
22
+ * any scope, and `PUT …/scoped-values` accepts an `{ inherit: true }`-only save at an orphaned
23
+ * scope (`resolveRequestScope`'s `removalOnly`).
24
+ *
25
+ * Status is shown as stored; "available" is composed from the shared rule's pieces
26
+ * (`isOn`, `effectiveStatus`, `effectiveWindow`, `isInsideWindow`) and the product's
27
+ * `archivedAt`, never from a status value. The audience is shown as the rule, not
28
+ * evaluated (SC-003). `cells[].missing` is the completeness gate's own check
29
+ * (`checkCompleteness`, T080a, FR-041) for every cell whose channel the product is a
30
+ * member of and whose language that channel offers, whatever its status — so a cell
31
+ * made live by a change that does not fire the gate shows what it lacks; absent on
32
+ * every other cell.
33
+ */
34
+ export type ScopeOverview = ScopeOverviewResponse['data'];
35
+ export interface ScopeOverviewChannel {
36
+ id: string;
37
+ name: Record<string, string>;
38
+ /** The channel's current content languages. */
39
+ languages: readonly string[];
40
+ isMember: boolean;
41
+ }
42
+ /** Everything {@link buildScopeOverview} reads, already loaded. */
43
+ export interface ScopeOverviewInput {
44
+ product: {
45
+ status: ProductScopeStatus;
46
+ archivedAt: Date | null;
47
+ window: PublicationWindow;
48
+ /** Feature 174 — the Global name and description, one string each. */
49
+ name: string;
50
+ description: string | null;
51
+ attributeValues: Record<string, unknown>;
52
+ /** The global URL key. */
53
+ slug: string;
54
+ };
55
+ /** The required attributes of the product's attribute set (the gate's list, R16). */
56
+ requiredAttributes: readonly string[];
57
+ /** The member channels and every other channel a row of this product names, in display order. */
58
+ channels: readonly ScopeOverviewChannel[];
59
+ channelRows: readonly ProductChannelScopeRecord[];
60
+ languageRows: readonly ProductChannelLanguageScopeRecord[];
61
+ valueOverrides: readonly OverrideRow[];
62
+ /** `languageCode` `null` = a Channel key. */
63
+ urlKeys: ReadonlyArray<{
64
+ languageCode: string | null;
65
+ salesChannelId: string;
66
+ }>;
67
+ /** The user-defined attributes' scope sets, by key. A key absent here no longer exists. */
68
+ attributeLevels: ReadonlyMap<string, readonly ScopeLevel[]>;
69
+ /** Every active platform language: the languages axis when the product is in no channel (US4 #4). */
70
+ platformLanguages: readonly string[];
71
+ /**
72
+ * Feature 163 (T134b, T139b, T118c) — overrides kept outside the scope and value
73
+ * tables: the gallery (`media:roles`, `media:hidden`, `media:altText`), the
74
+ * attachments (`attachments:hidden`, `attachments:name`, `attachments:description`),
75
+ * the packaging units (`packagingUnits:name`) and SEO (`seo:<field>`). The level is
76
+ * the shape: a channel alone (C) or a channel and a language (C×L); a Global row (SEO) is
77
+ * not an override cell. Absent = none.
78
+ */
79
+ scopedFields?: ReadonlyArray<ScopedField>;
80
+ now: Date;
81
+ }
82
+ /** One override held outside the scope and value tables, at a channel (C) or a channel and a language (C×L). */
83
+ export interface ScopedField {
84
+ field: string;
85
+ channelId: string | null;
86
+ languageCode: string | null;
87
+ }
88
+ /** The pure core of the overview (`admin-scopes-api.md` §3). */
89
+ export declare function buildScopeOverview(input: ScopeOverviewInput): ScopeOverview;
90
+ /**
91
+ * Feature 163 (T118c) — `seo`'s scopes of a product for the overview; `[]` while `seo`
92
+ * is not effectively present (the caller probes before resolving the port).
93
+ */
94
+ export type ListSeoProductScopes = (productId: string) => Promise<Array<{
95
+ channelId: string | null;
96
+ languageCode: string | null;
97
+ fields: readonly string[];
98
+ }>>;
99
+ export declare class ScopeOverviewService {
100
+ private readonly emFactory;
101
+ private readonly membership;
102
+ private readonly languages;
103
+ private readonly attributeRead;
104
+ /** Without it the overview lists no SEO field (as with `seo` off). */
105
+ private readonly seoScopes?;
106
+ constructor(emFactory: () => EntityManager, membership: Pick<SalesChannelMembershipPort, 'listChannelsForEntity'>, languages: Pick<LanguageReadPort, 'listActive' | 'getDefault'>, attributeRead: Pick<CatalogAttributeReadService, 'listAll'>,
107
+ /** Without it the overview lists no SEO field (as with `seo` off). */
108
+ seoScopes?: ListSeoProductScopes | undefined);
109
+ /** `GET /admin/catalog/products/:id/scope-overview`. */
110
+ read(productId: string, now?: Date): Promise<ScopeOverview>;
111
+ }
112
+ //# sourceMappingURL=scope-overview.service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scope-overview.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/scope-overview.service.ts"],"names":[],"mappings":"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"}