@endora-commerce/mod-catalog 0.109.0 → 0.111.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (615) hide show
  1. package/dist/admin/components/CopyToChannelsDialog.d.ts +37 -0
  2. package/dist/admin/components/CopyToChannelsDialog.js +83 -0
  3. package/dist/admin/components/PackagingUnitsEditor.d.ts +13 -4
  4. package/dist/admin/components/PackagingUnitsEditor.js +21 -85
  5. package/dist/admin/components/ProductAttachmentsSection.d.ts +1 -3
  6. package/dist/admin/components/ProductAttachmentsSection.js +59 -98
  7. package/dist/admin/components/ProductAttributesTab.d.ts +1 -11
  8. package/dist/admin/components/ProductAttributesTab.js +128 -119
  9. package/dist/admin/components/ProductContentCard.d.ts +41 -0
  10. package/dist/admin/components/ProductContentCard.js +28 -0
  11. package/dist/admin/components/ProductEditorSaveAction.d.ts +22 -0
  12. package/dist/admin/components/ProductEditorSaveAction.js +23 -0
  13. package/dist/admin/components/ProductGallerySection.d.ts +2 -13
  14. package/dist/admin/components/ProductGallerySection.js +98 -354
  15. package/dist/admin/components/ProductInventoryTab.d.ts +12 -1
  16. package/dist/admin/components/ProductInventoryTab.js +52 -115
  17. package/dist/admin/components/ProductOrderRulesCard.d.ts +11 -15
  18. package/dist/admin/components/ProductOrderRulesCard.js +15 -268
  19. package/dist/admin/components/ProductScopeBar.d.ts +34 -0
  20. package/dist/admin/components/ProductScopeBar.js +70 -0
  21. package/dist/admin/components/ProductScopeOverview.d.ts +13 -1
  22. package/dist/admin/components/ProductScopeOverview.js +56 -37
  23. package/dist/admin/components/ProductUrlRedirects.d.ts +15 -0
  24. package/dist/admin/components/ProductUrlRedirects.js +70 -0
  25. package/dist/admin/components/ProductsBulkEditDialog.js +4 -3
  26. package/dist/admin/components/editor/DetailsTab.d.ts +30 -0
  27. package/dist/admin/components/editor/DetailsTab.js +60 -0
  28. package/dist/admin/components/editor/SectionHeading.d.ts +22 -0
  29. package/dist/admin/components/editor/SectionHeading.js +19 -0
  30. package/dist/admin/components/editor/confirm-removal.d.ts +13 -0
  31. package/dist/admin/components/editor/confirm-removal.js +33 -0
  32. package/dist/admin/components/editor/editor-context.d.ts +55 -0
  33. package/dist/admin/components/editor/editor-context.js +88 -0
  34. package/dist/admin/components/editor/scoped-controls.d.ts +46 -0
  35. package/dist/admin/components/editor/scoped-controls.js +64 -0
  36. package/dist/admin/index.d.ts +1 -1
  37. package/dist/admin/index.js +11 -0
  38. package/dist/admin/lib/attribute-scope.d.ts +17 -14
  39. package/dist/admin/lib/attribute-scope.js +12 -9
  40. package/dist/admin/lib/bulk-result-outcome.d.ts +14 -0
  41. package/dist/admin/lib/bulk-result-outcome.js +13 -0
  42. package/dist/admin/lib/editor-scope.d.ts +35 -0
  43. package/dist/admin/lib/editor-scope.js +114 -0
  44. package/dist/admin/lib/order-minimum-input.d.ts +13 -0
  45. package/dist/admin/lib/order-minimum-input.js +16 -0
  46. package/dist/admin/lib/product-labels.d.ts +0 -2
  47. package/dist/admin/lib/product-labels.js +1 -5
  48. package/dist/admin/lib/product-scopes-api.d.ts +5 -22
  49. package/dist/admin/lib/product-scopes-api.js +4 -48
  50. package/dist/admin/lib/product-url-keys-api.d.ts +4 -27
  51. package/dist/admin/lib/product-url-keys-api.js +1 -50
  52. package/dist/admin/lib/scope-overview.d.ts +13 -14
  53. package/dist/admin/lib/scope-overview.js +36 -31
  54. package/dist/admin/lib/scoped-editor-store.d.ts +81 -0
  55. package/dist/admin/lib/scoped-editor-store.js +198 -0
  56. package/dist/admin/lib/scoped-values-api.d.ts +14 -0
  57. package/dist/admin/lib/scoped-values-api.js +55 -0
  58. package/dist/admin/pages/AttachmentTypesPage.js +14 -4
  59. package/dist/admin/pages/AttributeSetsPage.js +11 -4
  60. package/dist/admin/pages/AttributesManager.js +130 -40
  61. package/dist/admin/pages/BulkOperationDetailPage.js +11 -4
  62. package/dist/admin/pages/CategoriesTree.d.ts +5 -0
  63. package/dist/admin/pages/CategoriesTree.js +226 -40
  64. package/dist/admin/pages/ProductContentPage.d.ts +27 -0
  65. package/dist/admin/pages/ProductContentPage.js +161 -0
  66. package/dist/admin/pages/ProductCreateForm.d.ts +3 -0
  67. package/dist/admin/pages/ProductCreateForm.js +87 -0
  68. package/dist/admin/pages/ProductEditor.js +938 -458
  69. package/dist/admin/pages/ProductsList.js +33 -38
  70. package/dist/backend/admin-search-provider.d.ts +2 -1
  71. package/dist/backend/admin-search-provider.js +1 -1
  72. package/dist/backend/commands/attribute-commands.d.ts +4 -3
  73. package/dist/backend/commands/attribute-commands.js +137 -30
  74. package/dist/backend/commands/product-content-commands.d.ts +31 -0
  75. package/dist/backend/commands/product-content-commands.js +70 -0
  76. package/dist/backend/commands/scoped-values.commands.d.ts +95 -0
  77. package/dist/backend/commands/scoped-values.commands.js +235 -0
  78. package/dist/backend/demo/reset.js +2 -1
  79. package/dist/backend/demo/rows.d.ts +18 -0
  80. package/dist/backend/demo/rows.js +18 -0
  81. package/dist/backend/demo/seed.d.ts +2 -1
  82. package/dist/backend/demo/seed.js +20 -6
  83. package/dist/backend/entities/gallery-item-scope-override.entity.d.ts +30 -0
  84. package/dist/backend/entities/gallery-item-scope-override.entity.js +80 -0
  85. package/dist/backend/entities/gallery-item.entity.d.ts +7 -6
  86. package/dist/backend/entities/gallery-item.entity.js +11 -6
  87. package/dist/backend/entities/gallery-role-scope-override.entity.d.ts +28 -0
  88. package/dist/backend/entities/gallery-role-scope-override.entity.js +75 -0
  89. package/dist/backend/entities/product-attachment-scope-override.entity.d.ts +30 -0
  90. package/dist/backend/entities/product-attachment-scope-override.entity.js +80 -0
  91. package/dist/backend/entities/product-attachment.entity.d.ts +4 -6
  92. package/dist/backend/entities/product-attachment.entity.js +6 -12
  93. package/dist/backend/entities/product-attribute.entity.d.ts +5 -9
  94. package/dist/backend/entities/product-attribute.entity.js +5 -13
  95. package/dist/backend/entities/product-channel-scope.entity.d.ts +7 -2
  96. package/dist/backend/entities/product-channel-scope.entity.js +10 -1
  97. package/dist/backend/entities/product-content-value.entity.d.ts +39 -0
  98. package/dist/backend/entities/product-content-value.entity.js +81 -0
  99. package/dist/backend/entities/product-packaging-unit-scope-override.entity.d.ts +30 -0
  100. package/dist/backend/entities/product-packaging-unit-scope-override.entity.js +80 -0
  101. package/dist/backend/entities/product-packaging-unit.entity.d.ts +1 -7
  102. package/dist/backend/entities/product-packaging-unit.entity.js +0 -10
  103. package/dist/backend/entities/product-url-key.entity.d.ts +14 -19
  104. package/dist/backend/entities/product-url-key.entity.js +17 -22
  105. package/dist/backend/entities/product-url-redirect.entity.d.ts +8 -13
  106. package/dist/backend/entities/product-url-redirect.entity.js +13 -14
  107. package/dist/backend/entities/product-variant.entity.d.ts +8 -1
  108. package/dist/backend/entities/product-variant.entity.js +13 -2
  109. package/dist/backend/entities/product.entity.d.ts +31 -14
  110. package/dist/backend/entities/product.entity.js +41 -34
  111. package/dist/backend/index.d.ts +11 -3
  112. package/dist/backend/index.js +155 -49
  113. package/dist/backend/plugin.d.ts +36 -6
  114. package/dist/backend/plugin.js +36 -13
  115. package/dist/backend/prompt-tools.d.ts +3 -2
  116. package/dist/backend/prompt-tools.js +18 -7
  117. package/dist/backend/routes.admin.d.ts +15 -16
  118. package/dist/backend/routes.admin.js +122 -103
  119. package/dist/backend/routes.api-key.js +4 -2
  120. package/dist/backend/routes.external.js +3 -2
  121. package/dist/backend/routes.public.d.ts +8 -1
  122. package/dist/backend/routes.public.js +68 -11
  123. package/dist/backend/services/asset-references.d.ts +12 -1
  124. package/dist/backend/services/asset-references.js +42 -2
  125. package/dist/backend/services/attachment-packaging-scopes.d.ts +38 -20
  126. package/dist/backend/services/attachment-packaging-scopes.js +58 -75
  127. package/dist/backend/services/attachment.service.d.ts +4 -8
  128. package/dist/backend/services/attachment.service.js +35 -49
  129. package/dist/backend/services/attribute-filter-match.d.ts +14 -0
  130. package/dist/backend/services/attribute-filter-match.js +19 -0
  131. package/dist/backend/services/attribute-scope-preview.d.ts +17 -7
  132. package/dist/backend/services/attribute-scope-preview.js +30 -20
  133. package/dist/backend/services/attribute-set.service.d.ts +10 -1
  134. package/dist/backend/services/attribute-set.service.js +30 -4
  135. package/dist/backend/services/attribute-type-mapping.d.ts +2 -2
  136. package/dist/backend/services/attribute-type-mapping.js +6 -0
  137. package/dist/backend/services/attribute-usage.d.ts +31 -0
  138. package/dist/backend/services/attribute-usage.js +29 -0
  139. package/dist/backend/services/bulk-operation.service.d.ts +1 -1
  140. package/dist/backend/services/bulk-operation.service.js +16 -6
  141. package/dist/backend/services/bundle.service.js +19 -1
  142. package/dist/backend/services/catalog-admin-search.service.d.ts +3 -2
  143. package/dist/backend/services/catalog-admin-search.service.js +6 -6
  144. package/dist/backend/services/catalog-admin.service.d.ts +63 -12
  145. package/dist/backend/services/catalog-admin.service.js +368 -195
  146. package/dist/backend/services/catalog-attribute-read.service.d.ts +14 -0
  147. package/dist/backend/services/catalog-attribute-read.service.js +9 -19
  148. package/dist/backend/services/catalog-bulk-import.service.d.ts +58 -5
  149. package/dist/backend/services/catalog-bulk-import.service.js +192 -142
  150. package/dist/backend/services/catalog-bulk-update.service.d.ts +5 -3
  151. package/dist/backend/services/catalog-bulk-update.service.js +21 -8
  152. package/dist/backend/services/catalog-product-read.service.d.ts +11 -1
  153. package/dist/backend/services/catalog-product-read.service.js +37 -17
  154. package/dist/backend/services/catalog-query.service.d.ts +48 -8
  155. package/dist/backend/services/catalog-query.service.js +180 -116
  156. package/dist/backend/services/catalog-quick-search.service.js +5 -5
  157. package/dist/backend/services/catalog-write-ports.d.ts +14 -16
  158. package/dist/backend/services/catalog-write-ports.js +11 -70
  159. package/dist/backend/services/category-admin.service.js +29 -5
  160. package/dist/backend/services/content-attribute-rules.d.ts +61 -0
  161. package/dist/backend/services/content-attribute-rules.js +102 -0
  162. package/dist/backend/services/effective-value.sql.d.ts +24 -38
  163. package/dist/backend/services/effective-value.sql.js +37 -87
  164. package/dist/backend/services/gallery-scopes.d.ts +45 -22
  165. package/dist/backend/services/gallery-scopes.js +116 -109
  166. package/dist/backend/services/gallery.service.d.ts +13 -27
  167. package/dist/backend/services/gallery.service.js +75 -199
  168. package/dist/backend/services/grouped.service.js +20 -3
  169. package/dist/backend/services/packaging-unit.service.js +7 -12
  170. package/dist/backend/services/page-builder-content.d.ts +64 -0
  171. package/dist/backend/services/page-builder-content.js +113 -0
  172. package/dist/backend/services/primary-asset-url.d.ts +6 -1
  173. package/dist/backend/services/primary-asset-url.js +9 -4
  174. package/dist/backend/services/product-availability.service.d.ts +16 -3
  175. package/dist/backend/services/product-availability.service.js +58 -21
  176. package/dist/backend/services/product-content.service.d.ts +62 -0
  177. package/dist/backend/services/product-content.service.js +122 -0
  178. package/dist/backend/services/product-editor-preferences.service.d.ts +6 -0
  179. package/dist/backend/services/product-editor-preferences.service.js +12 -0
  180. package/dist/backend/services/product-global-field-rules.d.ts +39 -0
  181. package/dist/backend/services/product-global-field-rules.js +84 -0
  182. package/dist/backend/services/product-link.service.js +14 -16
  183. package/dist/backend/services/product-list-view-service.js +5 -8
  184. package/dist/backend/services/product-page-revalidation.d.ts +9 -0
  185. package/dist/backend/services/product-page-revalidation.js +19 -0
  186. package/dist/backend/services/product-scopes.service.d.ts +18 -8
  187. package/dist/backend/services/product-scopes.service.js +91 -36
  188. package/dist/backend/services/product-value-resolver.service.d.ts +2 -2
  189. package/dist/backend/services/product-value-resolver.service.js +4 -7
  190. package/dist/backend/services/publication-window-sweep.d.ts +61 -7
  191. package/dist/backend/services/publication-window-sweep.js +106 -19
  192. package/dist/backend/services/scheduled-work-probe.d.ts +34 -0
  193. package/dist/backend/services/scheduled-work-probe.js +30 -0
  194. package/dist/backend/services/scope-completeness.d.ts +11 -11
  195. package/dist/backend/services/scope-completeness.js +26 -33
  196. package/dist/backend/services/scope-overview.service.d.ts +24 -24
  197. package/dist/backend/services/scope-overview.service.js +33 -76
  198. package/dist/backend/services/scoped-store-adapters.d.ts +58 -0
  199. package/dist/backend/services/scoped-store-adapters.js +92 -0
  200. package/dist/backend/services/scoped-values-global-only.d.ts +36 -0
  201. package/dist/backend/services/scoped-values-global-only.js +92 -0
  202. package/dist/backend/services/scoped-values-import.d.ts +86 -0
  203. package/dist/backend/services/scoped-values-import.js +320 -0
  204. package/dist/backend/services/scoped-values-read.service.d.ts +56 -0
  205. package/dist/backend/services/scoped-values-read.service.js +289 -0
  206. package/dist/backend/services/scoped-values-save.service.d.ts +79 -0
  207. package/dist/backend/services/scoped-values-save.service.js +675 -0
  208. package/dist/backend/services/scoped-values-state.d.ts +94 -0
  209. package/dist/backend/services/scoped-values-state.js +159 -0
  210. package/dist/backend/services/scoped-values.service.d.ts +36 -0
  211. package/dist/backend/services/scoped-values.service.js +92 -0
  212. package/dist/backend/services/storefront-value-overrides.d.ts +7 -8
  213. package/dist/backend/services/storefront-value-overrides.js +11 -14
  214. package/dist/backend/services/table-maintenance-queue.d.ts +78 -0
  215. package/dist/backend/services/table-maintenance-queue.js +97 -0
  216. package/dist/backend/services/url-key-resolution.service.d.ts +12 -18
  217. package/dist/backend/services/url-key-resolution.service.js +43 -43
  218. package/dist/backend/services/url-key.service.d.ts +87 -135
  219. package/dist/backend/services/url-key.service.js +447 -619
  220. package/dist/manifest.d.ts +51 -1
  221. package/dist/manifest.js +111 -7
  222. package/dist/migrations/20261030T113855_catalog_scope_model_texts.d.ts +36 -0
  223. package/dist/migrations/20261030T113855_catalog_scope_model_texts.js +225 -0
  224. package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.d.ts +18 -0
  225. package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.js +39 -0
  226. package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.d.ts +6 -0
  227. package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.js +119 -0
  228. package/dist/migrations/20261030T113908_catalog_scope_model_media.d.ts +6 -0
  229. package/dist/migrations/20261030T113908_catalog_scope_model_media.js +185 -0
  230. package/dist/migrations/20261104T121504_catalog_product_content_values.d.ts +36 -0
  231. package/dist/migrations/20261104T121504_catalog_product_content_values.js +53 -0
  232. package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.d.ts +33 -0
  233. package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.js +58 -0
  234. package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.d.ts +36 -0
  235. package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.js +40 -0
  236. package/dist/migrations/20261114T000706_catalog_category_main_image.d.ts +37 -0
  237. package/dist/migrations/20261114T000706_catalog_category_main_image.js +56 -0
  238. package/dist/migrations/index.d.ts +9 -1
  239. package/dist/migrations/index.js +17 -1
  240. package/docs/catalog/attachments.md +53 -43
  241. package/docs/catalog/attribute-sets.md +3 -2
  242. package/docs/catalog/attributes.md +99 -25
  243. package/docs/catalog/category-content.md +9 -3
  244. package/docs/catalog/composite-products.md +5 -3
  245. package/docs/catalog/editing-a-product-at-a-scope.md +151 -0
  246. package/docs/catalog/gallery-and-labels.md +61 -60
  247. package/docs/catalog/packaging-units.md +43 -34
  248. package/docs/catalog/per-channel-per-language-overrides.md +83 -410
  249. package/docs/catalog/product-content.md +184 -0
  250. package/docs/catalog/product-links.md +2 -2
  251. package/docs/catalog/url-keys-and-redirects.md +79 -79
  252. package/docs/catalog.md +113 -31
  253. package/i18n/en.json +317 -274
  254. package/i18n/pl.json +319 -276
  255. package/package.json +13 -12
  256. package/dist/admin/components/AttachmentScopesDialog.d.ts +0 -22
  257. package/dist/admin/components/AttachmentScopesDialog.d.ts.map +0 -1
  258. package/dist/admin/components/AttachmentScopesDialog.js +0 -70
  259. package/dist/admin/components/AttachmentScopesDialog.js.map +0 -1
  260. package/dist/admin/components/PackagingUnitsEditor.d.ts.map +0 -1
  261. package/dist/admin/components/PackagingUnitsEditor.js.map +0 -1
  262. package/dist/admin/components/ProductAttachmentsSection.d.ts.map +0 -1
  263. package/dist/admin/components/ProductAttachmentsSection.js.map +0 -1
  264. package/dist/admin/components/ProductAttributesTab.d.ts.map +0 -1
  265. package/dist/admin/components/ProductAttributesTab.js.map +0 -1
  266. package/dist/admin/components/ProductGallerySection.d.ts.map +0 -1
  267. package/dist/admin/components/ProductGallerySection.js.map +0 -1
  268. package/dist/admin/components/ProductInventoryTab.d.ts.map +0 -1
  269. package/dist/admin/components/ProductInventoryTab.js.map +0 -1
  270. package/dist/admin/components/ProductOrderRulesCard.d.ts.map +0 -1
  271. package/dist/admin/components/ProductOrderRulesCard.js.map +0 -1
  272. package/dist/admin/components/ProductScopeControls.d.ts +0 -31
  273. package/dist/admin/components/ProductScopeControls.d.ts.map +0 -1
  274. package/dist/admin/components/ProductScopeControls.js +0 -243
  275. package/dist/admin/components/ProductScopeControls.js.map +0 -1
  276. package/dist/admin/components/ProductScopeEditor.d.ts +0 -88
  277. package/dist/admin/components/ProductScopeEditor.d.ts.map +0 -1
  278. package/dist/admin/components/ProductScopeEditor.js +0 -396
  279. package/dist/admin/components/ProductScopeEditor.js.map +0 -1
  280. package/dist/admin/components/ProductScopeOverview.d.ts.map +0 -1
  281. package/dist/admin/components/ProductScopeOverview.js.map +0 -1
  282. package/dist/admin/components/ProductStatusPills.d.ts.map +0 -1
  283. package/dist/admin/components/ProductStatusPills.js.map +0 -1
  284. package/dist/admin/components/ProductUrlKeysPanel.d.ts +0 -17
  285. package/dist/admin/components/ProductUrlKeysPanel.d.ts.map +0 -1
  286. package/dist/admin/components/ProductUrlKeysPanel.js +0 -215
  287. package/dist/admin/components/ProductUrlKeysPanel.js.map +0 -1
  288. package/dist/admin/components/ProductsBulkEditDialog.d.ts.map +0 -1
  289. package/dist/admin/components/ProductsBulkEditDialog.js.map +0 -1
  290. package/dist/admin/components/ScopedDialogParts.d.ts +0 -23
  291. package/dist/admin/components/ScopedDialogParts.d.ts.map +0 -1
  292. package/dist/admin/components/ScopedDialogParts.js +0 -16
  293. package/dist/admin/components/ScopedDialogParts.js.map +0 -1
  294. package/dist/admin/index.d.ts.map +0 -1
  295. package/dist/admin/index.js.map +0 -1
  296. package/dist/admin/lib/attribute-scope.d.ts.map +0 -1
  297. package/dist/admin/lib/attribute-scope.js.map +0 -1
  298. package/dist/admin/lib/bulk-operation-log-text.d.ts.map +0 -1
  299. package/dist/admin/lib/bulk-operation-log-text.js.map +0 -1
  300. package/dist/admin/lib/media-scopes.d.ts +0 -41
  301. package/dist/admin/lib/media-scopes.d.ts.map +0 -1
  302. package/dist/admin/lib/media-scopes.js +0 -66
  303. package/dist/admin/lib/media-scopes.js.map +0 -1
  304. package/dist/admin/lib/product-labels.d.ts.map +0 -1
  305. package/dist/admin/lib/product-labels.js.map +0 -1
  306. package/dist/admin/lib/product-scope-drafts.d.ts +0 -77
  307. package/dist/admin/lib/product-scope-drafts.d.ts.map +0 -1
  308. package/dist/admin/lib/product-scope-drafts.js +0 -133
  309. package/dist/admin/lib/product-scope-drafts.js.map +0 -1
  310. package/dist/admin/lib/product-scopes-api.d.ts.map +0 -1
  311. package/dist/admin/lib/product-scopes-api.js.map +0 -1
  312. package/dist/admin/lib/product-url-keys-api.d.ts.map +0 -1
  313. package/dist/admin/lib/product-url-keys-api.js.map +0 -1
  314. package/dist/admin/lib/resolve-product-selection.d.ts.map +0 -1
  315. package/dist/admin/lib/resolve-product-selection.js.map +0 -1
  316. package/dist/admin/lib/scope-overview.d.ts.map +0 -1
  317. package/dist/admin/lib/scope-overview.js.map +0 -1
  318. package/dist/admin/pages/AttachmentTypesPage.d.ts.map +0 -1
  319. package/dist/admin/pages/AttachmentTypesPage.js.map +0 -1
  320. package/dist/admin/pages/AttributeSetsPage.d.ts.map +0 -1
  321. package/dist/admin/pages/AttributeSetsPage.js.map +0 -1
  322. package/dist/admin/pages/AttributesManager.d.ts.map +0 -1
  323. package/dist/admin/pages/AttributesManager.js.map +0 -1
  324. package/dist/admin/pages/BulkOperationDetailPage.d.ts.map +0 -1
  325. package/dist/admin/pages/BulkOperationDetailPage.js.map +0 -1
  326. package/dist/admin/pages/BulkOperationsPage.d.ts.map +0 -1
  327. package/dist/admin/pages/BulkOperationsPage.js.map +0 -1
  328. package/dist/admin/pages/CategoriesTree.d.ts.map +0 -1
  329. package/dist/admin/pages/CategoriesTree.js.map +0 -1
  330. package/dist/admin/pages/CategoryContentPage.d.ts.map +0 -1
  331. package/dist/admin/pages/CategoryContentPage.js.map +0 -1
  332. package/dist/admin/pages/ProductEditor.d.ts.map +0 -1
  333. package/dist/admin/pages/ProductEditor.js.map +0 -1
  334. package/dist/admin/pages/ProductsList.d.ts.map +0 -1
  335. package/dist/admin/pages/ProductsList.js.map +0 -1
  336. package/dist/backend/admin-search-provider.d.ts.map +0 -1
  337. package/dist/backend/admin-search-provider.js.map +0 -1
  338. package/dist/backend/commands/attribute-commands.d.ts.map +0 -1
  339. package/dist/backend/commands/attribute-commands.js.map +0 -1
  340. package/dist/backend/demo/reset.d.ts.map +0 -1
  341. package/dist/backend/demo/reset.js.map +0 -1
  342. package/dist/backend/demo/rows.d.ts.map +0 -1
  343. package/dist/backend/demo/rows.js.map +0 -1
  344. package/dist/backend/demo/seed.d.ts.map +0 -1
  345. package/dist/backend/demo/seed.js.map +0 -1
  346. package/dist/backend/entities/attachment-type.entity.d.ts.map +0 -1
  347. package/dist/backend/entities/attachment-type.entity.js.map +0 -1
  348. package/dist/backend/entities/attribute-set-attribute.entity.d.ts.map +0 -1
  349. package/dist/backend/entities/attribute-set-attribute.entity.js.map +0 -1
  350. package/dist/backend/entities/attribute-set.entity.d.ts.map +0 -1
  351. package/dist/backend/entities/attribute-set.entity.js.map +0 -1
  352. package/dist/backend/entities/bulk-operation.entity.d.ts.map +0 -1
  353. package/dist/backend/entities/bulk-operation.entity.js.map +0 -1
  354. package/dist/backend/entities/bundle-slot-option.entity.d.ts.map +0 -1
  355. package/dist/backend/entities/bundle-slot-option.entity.js.map +0 -1
  356. package/dist/backend/entities/bundle-slot.entity.d.ts.map +0 -1
  357. package/dist/backend/entities/bundle-slot.entity.js.map +0 -1
  358. package/dist/backend/entities/category.entity.d.ts.map +0 -1
  359. package/dist/backend/entities/category.entity.js.map +0 -1
  360. package/dist/backend/entities/gallery-item-channel-hidden.entity.d.ts +0 -14
  361. package/dist/backend/entities/gallery-item-channel-hidden.entity.d.ts.map +0 -1
  362. package/dist/backend/entities/gallery-item-channel-hidden.entity.js +0 -42
  363. package/dist/backend/entities/gallery-item-channel-hidden.entity.js.map +0 -1
  364. package/dist/backend/entities/gallery-item-channel-label.entity.d.ts +0 -18
  365. package/dist/backend/entities/gallery-item-channel-label.entity.d.ts.map +0 -1
  366. package/dist/backend/entities/gallery-item-channel-label.entity.js +0 -49
  367. package/dist/backend/entities/gallery-item-channel-label.entity.js.map +0 -1
  368. package/dist/backend/entities/gallery-item-label.entity.d.ts.map +0 -1
  369. package/dist/backend/entities/gallery-item-label.entity.js.map +0 -1
  370. package/dist/backend/entities/gallery-item.entity.d.ts.map +0 -1
  371. package/dist/backend/entities/gallery-item.entity.js.map +0 -1
  372. package/dist/backend/entities/grouped-item.entity.d.ts.map +0 -1
  373. package/dist/backend/entities/grouped-item.entity.js.map +0 -1
  374. package/dist/backend/entities/product-attachment-channel-hidden.entity.d.ts +0 -13
  375. package/dist/backend/entities/product-attachment-channel-hidden.entity.d.ts.map +0 -1
  376. package/dist/backend/entities/product-attachment-channel-hidden.entity.js +0 -41
  377. package/dist/backend/entities/product-attachment-channel-hidden.entity.js.map +0 -1
  378. package/dist/backend/entities/product-attachment.entity.d.ts.map +0 -1
  379. package/dist/backend/entities/product-attachment.entity.js.map +0 -1
  380. package/dist/backend/entities/product-attribute.entity.d.ts.map +0 -1
  381. package/dist/backend/entities/product-attribute.entity.js.map +0 -1
  382. package/dist/backend/entities/product-channel-language-scope.entity.d.ts.map +0 -1
  383. package/dist/backend/entities/product-channel-language-scope.entity.js.map +0 -1
  384. package/dist/backend/entities/product-channel-scope.entity.d.ts.map +0 -1
  385. package/dist/backend/entities/product-channel-scope.entity.js.map +0 -1
  386. package/dist/backend/entities/product-editor-preference.entity.d.ts.map +0 -1
  387. package/dist/backend/entities/product-editor-preference.entity.js.map +0 -1
  388. package/dist/backend/entities/product-link.entity.d.ts.map +0 -1
  389. package/dist/backend/entities/product-link.entity.js.map +0 -1
  390. package/dist/backend/entities/product-list-saved-view.entity.d.ts.map +0 -1
  391. package/dist/backend/entities/product-list-saved-view.entity.js.map +0 -1
  392. package/dist/backend/entities/product-packaging-unit.entity.d.ts.map +0 -1
  393. package/dist/backend/entities/product-packaging-unit.entity.js.map +0 -1
  394. package/dist/backend/entities/product-url-key.entity.d.ts.map +0 -1
  395. package/dist/backend/entities/product-url-key.entity.js.map +0 -1
  396. package/dist/backend/entities/product-url-redirect.entity.d.ts.map +0 -1
  397. package/dist/backend/entities/product-url-redirect.entity.js.map +0 -1
  398. package/dist/backend/entities/product-value-override.entity.d.ts.map +0 -1
  399. package/dist/backend/entities/product-value-override.entity.js.map +0 -1
  400. package/dist/backend/entities/product-variant.entity.d.ts.map +0 -1
  401. package/dist/backend/entities/product-variant.entity.js.map +0 -1
  402. package/dist/backend/entities/product.entity.d.ts.map +0 -1
  403. package/dist/backend/entities/product.entity.js.map +0 -1
  404. package/dist/backend/index.d.ts.map +0 -1
  405. package/dist/backend/index.js.map +0 -1
  406. package/dist/backend/plugin.d.ts.map +0 -1
  407. package/dist/backend/plugin.js.map +0 -1
  408. package/dist/backend/prompt-tools.d.ts.map +0 -1
  409. package/dist/backend/prompt-tools.js.map +0 -1
  410. package/dist/backend/routes.admin.d.ts.map +0 -1
  411. package/dist/backend/routes.admin.js.map +0 -1
  412. package/dist/backend/routes.admin.url-keys.d.ts.map +0 -1
  413. package/dist/backend/routes.admin.url-keys.js.map +0 -1
  414. package/dist/backend/routes.api-key.d.ts.map +0 -1
  415. package/dist/backend/routes.api-key.js.map +0 -1
  416. package/dist/backend/routes.external.d.ts.map +0 -1
  417. package/dist/backend/routes.external.js.map +0 -1
  418. package/dist/backend/routes.public.d.ts.map +0 -1
  419. package/dist/backend/routes.public.js.map +0 -1
  420. package/dist/backend/routes.public.url-keys.d.ts.map +0 -1
  421. package/dist/backend/routes.public.url-keys.js.map +0 -1
  422. package/dist/backend/saved-view-actor.d.ts.map +0 -1
  423. package/dist/backend/saved-view-actor.js.map +0 -1
  424. package/dist/backend/services/asset-references.d.ts.map +0 -1
  425. package/dist/backend/services/asset-references.js.map +0 -1
  426. package/dist/backend/services/attachment-packaging-scopes.d.ts.map +0 -1
  427. package/dist/backend/services/attachment-packaging-scopes.js.map +0 -1
  428. package/dist/backend/services/attachment.service.d.ts.map +0 -1
  429. package/dist/backend/services/attachment.service.js.map +0 -1
  430. package/dist/backend/services/attribute-option-validator.d.ts.map +0 -1
  431. package/dist/backend/services/attribute-option-validator.js.map +0 -1
  432. package/dist/backend/services/attribute-scope-preview.d.ts.map +0 -1
  433. package/dist/backend/services/attribute-scope-preview.js.map +0 -1
  434. package/dist/backend/services/attribute-set-validations.d.ts.map +0 -1
  435. package/dist/backend/services/attribute-set-validations.js.map +0 -1
  436. package/dist/backend/services/attribute-set.service.d.ts.map +0 -1
  437. package/dist/backend/services/attribute-set.service.js.map +0 -1
  438. package/dist/backend/services/attribute-type-mapping.d.ts.map +0 -1
  439. package/dist/backend/services/attribute-type-mapping.js.map +0 -1
  440. package/dist/backend/services/attribute-value-key.service.d.ts.map +0 -1
  441. package/dist/backend/services/attribute-value-key.service.js.map +0 -1
  442. package/dist/backend/services/audit-references.d.ts.map +0 -1
  443. package/dist/backend/services/audit-references.js.map +0 -1
  444. package/dist/backend/services/bulk-operation-queue.d.ts.map +0 -1
  445. package/dist/backend/services/bulk-operation-queue.js.map +0 -1
  446. package/dist/backend/services/bulk-operation.service.d.ts.map +0 -1
  447. package/dist/backend/services/bulk-operation.service.js.map +0 -1
  448. package/dist/backend/services/bundle.service.d.ts.map +0 -1
  449. package/dist/backend/services/bundle.service.js.map +0 -1
  450. package/dist/backend/services/catalog-admin-search.service.d.ts.map +0 -1
  451. package/dist/backend/services/catalog-admin-search.service.js.map +0 -1
  452. package/dist/backend/services/catalog-admin.service.d.ts.map +0 -1
  453. package/dist/backend/services/catalog-admin.service.js.map +0 -1
  454. package/dist/backend/services/catalog-attribute-read.service.d.ts.map +0 -1
  455. package/dist/backend/services/catalog-attribute-read.service.js.map +0 -1
  456. package/dist/backend/services/catalog-bulk-import.service.d.ts.map +0 -1
  457. package/dist/backend/services/catalog-bulk-import.service.js.map +0 -1
  458. package/dist/backend/services/catalog-bulk-update.service.d.ts.map +0 -1
  459. package/dist/backend/services/catalog-bulk-update.service.js.map +0 -1
  460. package/dist/backend/services/catalog-category-read.service.d.ts.map +0 -1
  461. package/dist/backend/services/catalog-category-read.service.js.map +0 -1
  462. package/dist/backend/services/catalog-org-price-decorator.d.ts.map +0 -1
  463. package/dist/backend/services/catalog-org-price-decorator.js.map +0 -1
  464. package/dist/backend/services/catalog-product-filter.service.d.ts.map +0 -1
  465. package/dist/backend/services/catalog-product-filter.service.js.map +0 -1
  466. package/dist/backend/services/catalog-product-read.service.d.ts.map +0 -1
  467. package/dist/backend/services/catalog-product-read.service.js.map +0 -1
  468. package/dist/backend/services/catalog-query.service.d.ts.map +0 -1
  469. package/dist/backend/services/catalog-query.service.js.map +0 -1
  470. package/dist/backend/services/catalog-quick-search.service.d.ts.map +0 -1
  471. package/dist/backend/services/catalog-quick-search.service.js.map +0 -1
  472. package/dist/backend/services/catalog-write-ports.d.ts.map +0 -1
  473. package/dist/backend/services/catalog-write-ports.js.map +0 -1
  474. package/dist/backend/services/category-admin.service.d.ts.map +0 -1
  475. package/dist/backend/services/category-admin.service.js.map +0 -1
  476. package/dist/backend/services/channel-url-facts.d.ts.map +0 -1
  477. package/dist/backend/services/channel-url-facts.js.map +0 -1
  478. package/dist/backend/services/effective-value.sql.d.ts.map +0 -1
  479. package/dist/backend/services/effective-value.sql.js.map +0 -1
  480. package/dist/backend/services/gallery-scopes.d.ts.map +0 -1
  481. package/dist/backend/services/gallery-scopes.js.map +0 -1
  482. package/dist/backend/services/gallery.service.d.ts.map +0 -1
  483. package/dist/backend/services/gallery.service.js.map +0 -1
  484. package/dist/backend/services/grouped.service.d.ts.map +0 -1
  485. package/dist/backend/services/grouped.service.js.map +0 -1
  486. package/dist/backend/services/label-resolver.d.ts.map +0 -1
  487. package/dist/backend/services/label-resolver.js.map +0 -1
  488. package/dist/backend/services/linkable-asset.d.ts.map +0 -1
  489. package/dist/backend/services/linkable-asset.js.map +0 -1
  490. package/dist/backend/services/packaging-unit.service.d.ts.map +0 -1
  491. package/dist/backend/services/packaging-unit.service.js.map +0 -1
  492. package/dist/backend/services/primary-asset-url.d.ts.map +0 -1
  493. package/dist/backend/services/primary-asset-url.js.map +0 -1
  494. package/dist/backend/services/product-availability.service.d.ts.map +0 -1
  495. package/dist/backend/services/product-availability.service.js.map +0 -1
  496. package/dist/backend/services/product-availability.sql.d.ts.map +0 -1
  497. package/dist/backend/services/product-availability.sql.js.map +0 -1
  498. package/dist/backend/services/product-editor-preferences.service.d.ts.map +0 -1
  499. package/dist/backend/services/product-editor-preferences.service.js.map +0 -1
  500. package/dist/backend/services/product-link.service.d.ts.map +0 -1
  501. package/dist/backend/services/product-link.service.js.map +0 -1
  502. package/dist/backend/services/product-list-view-service.d.ts.map +0 -1
  503. package/dist/backend/services/product-list-view-service.js.map +0 -1
  504. package/dist/backend/services/product-overrides.service.d.ts +0 -84
  505. package/dist/backend/services/product-overrides.service.d.ts.map +0 -1
  506. package/dist/backend/services/product-overrides.service.js +0 -211
  507. package/dist/backend/services/product-overrides.service.js.map +0 -1
  508. package/dist/backend/services/product-page-revalidation.d.ts.map +0 -1
  509. package/dist/backend/services/product-page-revalidation.js.map +0 -1
  510. package/dist/backend/services/product-scope-context.service.d.ts +0 -36
  511. package/dist/backend/services/product-scope-context.service.d.ts.map +0 -1
  512. package/dist/backend/services/product-scope-context.service.js +0 -107
  513. package/dist/backend/services/product-scope-context.service.js.map +0 -1
  514. package/dist/backend/services/product-scopes.service.d.ts.map +0 -1
  515. package/dist/backend/services/product-scopes.service.js.map +0 -1
  516. package/dist/backend/services/product-summary-text.d.ts.map +0 -1
  517. package/dist/backend/services/product-summary-text.js.map +0 -1
  518. package/dist/backend/services/product-type-validations.d.ts.map +0 -1
  519. package/dist/backend/services/product-type-validations.js.map +0 -1
  520. package/dist/backend/services/product-value-resolver.service.d.ts.map +0 -1
  521. package/dist/backend/services/product-value-resolver.service.js.map +0 -1
  522. package/dist/backend/services/publication-window-sweep.d.ts.map +0 -1
  523. package/dist/backend/services/publication-window-sweep.js.map +0 -1
  524. package/dist/backend/services/scope-completeness.d.ts.map +0 -1
  525. package/dist/backend/services/scope-completeness.js.map +0 -1
  526. package/dist/backend/services/scope-overview.service.d.ts.map +0 -1
  527. package/dist/backend/services/scope-overview.service.js.map +0 -1
  528. package/dist/backend/services/sql-id-arrays.d.ts.map +0 -1
  529. package/dist/backend/services/sql-id-arrays.js.map +0 -1
  530. package/dist/backend/services/storefront-value-overrides.d.ts.map +0 -1
  531. package/dist/backend/services/storefront-value-overrides.js.map +0 -1
  532. package/dist/backend/services/system-attribute-scopes.d.ts.map +0 -1
  533. package/dist/backend/services/system-attribute-scopes.js.map +0 -1
  534. package/dist/backend/services/url-key-resolution.service.d.ts.map +0 -1
  535. package/dist/backend/services/url-key-resolution.service.js.map +0 -1
  536. package/dist/backend/services/url-key.service.d.ts.map +0 -1
  537. package/dist/backend/services/url-key.service.js.map +0 -1
  538. package/dist/backend/services/viewer-organization.d.ts.map +0 -1
  539. package/dist/backend/services/viewer-organization.js.map +0 -1
  540. package/dist/manifest.d.ts.map +0 -1
  541. package/dist/manifest.js.map +0 -1
  542. package/dist/migrations/20260429T064146_catalog_attribute_sets_init.d.ts.map +0 -1
  543. package/dist/migrations/20260429T064146_catalog_attribute_sets_init.js.map +0 -1
  544. package/dist/migrations/20260429T070004_catalog_product_attribute_extensions.d.ts.map +0 -1
  545. package/dist/migrations/20260429T070004_catalog_product_attribute_extensions.js.map +0 -1
  546. package/dist/migrations/20260429T102322_catalog_product_type_and_virtual_fields.d.ts.map +0 -1
  547. package/dist/migrations/20260429T102322_catalog_product_type_and_virtual_fields.js.map +0 -1
  548. package/dist/migrations/20260429T111839_catalog_gallery_items_and_labels.d.ts.map +0 -1
  549. package/dist/migrations/20260429T111839_catalog_gallery_items_and_labels.js.map +0 -1
  550. package/dist/migrations/20260429T112543_catalog_product_attachments.d.ts.map +0 -1
  551. package/dist/migrations/20260429T112543_catalog_product_attachments.js.map +0 -1
  552. package/dist/migrations/20260429T123726_catalog_product_links.d.ts.map +0 -1
  553. package/dist/migrations/20260429T123726_catalog_product_links.js.map +0 -1
  554. package/dist/migrations/20260429T130803_catalog_grouped_and_bundle.d.ts.map +0 -1
  555. package/dist/migrations/20260429T130803_catalog_grouped_and_bundle.js.map +0 -1
  556. package/dist/migrations/20260501T185835_catalog_product_attribute_is_comparable.d.ts.map +0 -1
  557. package/dist/migrations/20260501T185835_catalog_product_attribute_is_comparable.js.map +0 -1
  558. package/dist/migrations/20260505T060113_catalog_attribute_options_and_flags.d.ts.map +0 -1
  559. package/dist/migrations/20260505T060113_catalog_attribute_options_and_flags.js.map +0 -1
  560. package/dist/migrations/20260515T082629_catalog_attribute_mass_editable.d.ts.map +0 -1
  561. package/dist/migrations/20260515T082629_catalog_attribute_mass_editable.js.map +0 -1
  562. package/dist/migrations/20260526T124736_catalog_product_status_inactive.d.ts.map +0 -1
  563. package/dist/migrations/20260526T124736_catalog_product_status_inactive.js.map +0 -1
  564. package/dist/migrations/20260611T140346_catalog_product_value_overrides_init.d.ts.map +0 -1
  565. package/dist/migrations/20260611T140346_catalog_product_value_overrides_init.js.map +0 -1
  566. package/dist/migrations/20260611T140400_catalog_attribute_quick_searchable.d.ts.map +0 -1
  567. package/dist/migrations/20260611T140400_catalog_attribute_quick_searchable.js.map +0 -1
  568. package/dist/migrations/20260611T140407_catalog_bulk_operations.d.ts.map +0 -1
  569. package/dist/migrations/20260611T140407_catalog_bulk_operations.js.map +0 -1
  570. package/dist/migrations/20260611T140408_catalog_bulk_operation_logs.d.ts.map +0 -1
  571. package/dist/migrations/20260611T140408_catalog_bulk_operation_logs.js.map +0 -1
  572. package/dist/migrations/20260611T140412_catalog_product_packaging_units.d.ts.map +0 -1
  573. package/dist/migrations/20260611T140412_catalog_product_packaging_units.js.map +0 -1
  574. package/dist/migrations/20260718T060659_catalog_bulk_operation_revert_state.d.ts.map +0 -1
  575. package/dist/migrations/20260718T060659_catalog_bulk_operation_revert_state.js.map +0 -1
  576. package/dist/migrations/20260718T200343_catalog_category_custom_field_values.d.ts.map +0 -1
  577. package/dist/migrations/20260718T200343_catalog_category_custom_field_values.js.map +0 -1
  578. package/dist/migrations/20260723T230401_catalog_attributes_on_custom_fields.d.ts.map +0 -1
  579. package/dist/migrations/20260723T230401_catalog_attributes_on_custom_fields.js.map +0 -1
  580. package/dist/migrations/20260804T152604_catalog_widen_product_sku.d.ts.map +0 -1
  581. package/dist/migrations/20260804T152604_catalog_widen_product_sku.js.map +0 -1
  582. package/dist/migrations/20260804T160244_catalog_category_activation.d.ts.map +0 -1
  583. package/dist/migrations/20260804T160244_catalog_category_activation.js.map +0 -1
  584. package/dist/migrations/20260912T094557_catalog_sales_channel_products.d.ts.map +0 -1
  585. package/dist/migrations/20260912T094557_catalog_sales_channel_products.js.map +0 -1
  586. package/dist/migrations/20260912T094623_catalog_sales_channel_categories.d.ts.map +0 -1
  587. package/dist/migrations/20260912T094623_catalog_sales_channel_categories.js.map +0 -1
  588. package/dist/migrations/20260925T125527_catalog_inventory_columns.d.ts.map +0 -1
  589. package/dist/migrations/20260925T125527_catalog_inventory_columns.js.map +0 -1
  590. package/dist/migrations/20261008T080839_catalog_product_attribute_is_price_rule.d.ts.map +0 -1
  591. package/dist/migrations/20261008T080839_catalog_product_attribute_is_price_rule.js.map +0 -1
  592. package/dist/migrations/20261008T092714_catalog_category_content.d.ts.map +0 -1
  593. package/dist/migrations/20261008T092714_catalog_category_content.js.map +0 -1
  594. package/dist/migrations/20261014T170531_catalog_product_list_saved_views.d.ts.map +0 -1
  595. package/dist/migrations/20261014T170531_catalog_product_list_saved_views.js.map +0 -1
  596. package/dist/migrations/20261016T082008_catalog_order_rules.d.ts.map +0 -1
  597. package/dist/migrations/20261016T082008_catalog_order_rules.js.map +0 -1
  598. package/dist/migrations/20261022T035133_catalog_product_scopes.d.ts.map +0 -1
  599. package/dist/migrations/20261022T035133_catalog_product_scopes.js.map +0 -1
  600. package/dist/migrations/20261022T054223_catalog_product_url_keys.d.ts.map +0 -1
  601. package/dist/migrations/20261022T054223_catalog_product_url_keys.js.map +0 -1
  602. package/dist/migrations/20261022T111811_catalog_price_fields_removed.d.ts.map +0 -1
  603. package/dist/migrations/20261022T111811_catalog_price_fields_removed.js.map +0 -1
  604. package/dist/migrations/20261022T182523_catalog_admin_name_keys.d.ts.map +0 -1
  605. package/dist/migrations/20261022T182523_catalog_admin_name_keys.js.map +0 -1
  606. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.d.ts.map +0 -1
  607. package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.js.map +0 -1
  608. package/dist/migrations/20261026T033453_catalog_product_media_scopes.d.ts.map +0 -1
  609. package/dist/migrations/20261026T033453_catalog_product_media_scopes.js.map +0 -1
  610. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.d.ts.map +0 -1
  611. package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.js.map +0 -1
  612. package/dist/migrations/index.d.ts.map +0 -1
  613. package/dist/migrations/index.js.map +0 -1
  614. package/dist/ports/index.d.ts.map +0 -1
  615. package/dist/ports/index.js.map +0 -1
@@ -0,0 +1,94 @@
1
+ import type { EntityManager } from '@mikro-orm/postgresql';
2
+ import { type CatalogAttributeView, type ScopeChannel, type ScopeRef, type ScopedRow } from '@endora-commerce/contracts';
3
+ import type { SalesChannelMembershipPort } from '@endora-commerce/platform/kernel';
4
+ import { GalleryItem } from '../entities/gallery-item.entity.js';
5
+ import { GalleryItemLabel } from '../entities/gallery-item-label.entity.js';
6
+ import { GalleryItemScopeOverride } from '../entities/gallery-item-scope-override.entity.js';
7
+ import { GalleryRoleScopeOverride } from '../entities/gallery-role-scope-override.entity.js';
8
+ import { Product } from '../entities/product.entity.js';
9
+ import { ProductAttachment } from '../entities/product-attachment.entity.js';
10
+ import { ProductAttachmentScopeOverride } from '../entities/product-attachment-scope-override.entity.js';
11
+ import { ProductChannelLanguageScope } from '../entities/product-channel-language-scope.entity.js';
12
+ import { ProductChannelScope } from '../entities/product-channel-scope.entity.js';
13
+ import { ProductPackagingUnit } from '../entities/product-packaging-unit.entity.js';
14
+ import { ProductPackagingUnitScopeOverride } from '../entities/product-packaging-unit-scope-override.entity.js';
15
+ import { ProductUrlKey } from '../entities/product-url-key.entity.js';
16
+ import { ProductValueOverride } from '../entities/product-value-override.entity.js';
17
+ /**
18
+ * Feature 174 (`contracts/scoped-values-api.md` §1–§3) — everything the scoped-values read and
19
+ * the save Command read about one product, loaded in one place so both see the same stores.
20
+ */
21
+ /** A member channel as the scoped values read it. */
22
+ export interface MemberChannel extends ScopeChannel {
23
+ code: string;
24
+ name: Record<string, string> | string | null;
25
+ }
26
+ export interface ScopedProductState {
27
+ product: Product;
28
+ version: string;
29
+ categoryIds: string[];
30
+ members: MemberChannel[];
31
+ channelRows: ProductChannelScope[];
32
+ languageRows: ProductChannelLanguageScope[];
33
+ valueOverrides: ProductValueOverride[];
34
+ galleryItems: GalleryItem[];
35
+ galleryLabels: GalleryItemLabel[];
36
+ galleryOverrides: GalleryItemScopeOverride[];
37
+ roleOverrides: GalleryRoleScopeOverride[];
38
+ attachments: ProductAttachment[];
39
+ attachmentOverrides: ProductAttachmentScopeOverride[];
40
+ packagingUnits: ProductPackagingUnit[];
41
+ packagingOverrides: ProductPackagingUnitScopeOverride[];
42
+ urlKeys: ProductUrlKey[];
43
+ /**
44
+ * The user attributes of the product's attribute set that hold scoped values, by key. A Page
45
+ * Builder content attribute (`specs/172-product-content-attributes/`) is left out: its document
46
+ * per language lives in `product_content_values` and is edited on the product content screen,
47
+ * so to the read, the save and the import it is no field at all (172 FR-011, FR-014, FR-042).
48
+ */
49
+ attributes: Map<string, CatalogAttributeView>;
50
+ }
51
+ /** A `:id` that is not a uuid names no product — 404, never a 500 from the cast. */
52
+ /**
53
+ * The attributes of a set that hold scoped values, by key: every member but a Page Builder content
54
+ * attribute (`ScopedProductState.attributes`). The one filter for the product's set and for the
55
+ * set a save switches to, so the two cannot disagree.
56
+ */
57
+ export declare function scopedAttributesOf(views: readonly CatalogAttributeView[], setDefinitions: ReadonlySet<string>): Map<string, CatalogAttributeView>;
58
+ export declare function assertProductId(productId: string): void;
59
+ /** The product's current `scope_version` (R7), as the opaque string the API carries. */
60
+ export declare function readScopeVersion(em: EntityManager, productId: string): Promise<string>;
61
+ export declare function loadScopedState(em: EntityManager, productId: string, deps: {
62
+ membership: Pick<SalesChannelMembershipPort, 'listChannelsForEntity'>;
63
+ listAttributes: () => Promise<CatalogAttributeView[]>;
64
+ }): Promise<ScopedProductState>;
65
+ /**
66
+ * The scope a request names (§1), resolved against the product's member channels: neither →
67
+ * Global; a channel → Channel; both → Channel × language, the language in the channel's own
68
+ * spelling. A language without a channel is `422 VALIDATION_FAILED` (`details.field = 'scope'`,
69
+ * FR-010: there is no Language scope); a channel the product is not a member of, or a language
70
+ * it does not offer, is `422 SCOPE_INVALID`.
71
+ */
72
+ export declare function resolveRequestScope(members: readonly ScopeChannel[], request: {
73
+ channelId?: string | null | undefined;
74
+ languageCode?: string | null | undefined;
75
+ },
76
+ /**
77
+ * FR-101 (163 FR-015) — the write only removes overrides (`{ inherit: true }` in every cell):
78
+ * an orphaned scope — a channel the product left, a language the channel dropped — is
79
+ * accepted as named, so the overview's orphan deletion keeps working. A value there is still
80
+ * `SCOPE_INVALID`.
81
+ */
82
+ options?: {
83
+ removalOnly?: boolean;
84
+ }): ScopeRef;
85
+ /** Rows at a valid scope only: a member channel, and at C×L a language that channel offers (orphans dropped). */
86
+ export declare function atValidScopes<T>(rows: readonly ScopedRow<T>[], members: readonly ScopeChannel[]): ScopedRow<T>[];
87
+ /**
88
+ * The **one** writer of `products.scope_version`: `+ 1`, conditioned on `expected` when the
89
+ * caller holds a version (the save, the copy). Runs as the first statement of the Command, so
90
+ * the row lock it takes serialises every later read of the transaction. A stale `expected` is
91
+ * `409 VERSION_CONFLICT`; an unknown or deleted product `404 PRODUCT_NOT_FOUND`.
92
+ */
93
+ export declare function bumpScopeVersion(em: EntityManager, productId: string, expected?: string): Promise<string>;
94
+ //# sourceMappingURL=scoped-values-state.d.ts.map
@@ -0,0 +1,159 @@
1
+ import { ERROR_CODES, isUuidShape, scopeFromRequest, sameLanguage, toScopeChannel, } from '@endora-commerce/contracts';
2
+ import { HttpError } from '@endora-commerce/platform/http';
3
+ import { GalleryItem } from '../entities/gallery-item.entity.js';
4
+ import { GalleryItemLabel } from '../entities/gallery-item-label.entity.js';
5
+ import { GalleryItemScopeOverride } from '../entities/gallery-item-scope-override.entity.js';
6
+ import { GalleryRoleScopeOverride } from '../entities/gallery-role-scope-override.entity.js';
7
+ import { Product } from '../entities/product.entity.js';
8
+ import { ProductAttachment } from '../entities/product-attachment.entity.js';
9
+ import { ProductAttachmentScopeOverride } from '../entities/product-attachment-scope-override.entity.js';
10
+ import { ProductChannelLanguageScope } from '../entities/product-channel-language-scope.entity.js';
11
+ import { ProductChannelScope } from '../entities/product-channel-scope.entity.js';
12
+ import { ProductPackagingUnit } from '../entities/product-packaging-unit.entity.js';
13
+ import { ProductPackagingUnitScopeOverride } from '../entities/product-packaging-unit-scope-override.entity.js';
14
+ import { ProductUrlKey } from '../entities/product-url-key.entity.js';
15
+ import { ProductValueOverride } from '../entities/product-value-override.entity.js';
16
+ import { attributeSetDefinitionIds } from './scope-completeness.js';
17
+ /** A `:id` that is not a uuid names no product — 404, never a 500 from the cast. */
18
+ /**
19
+ * The attributes of a set that hold scoped values, by key: every member but a Page Builder content
20
+ * attribute (`ScopedProductState.attributes`). The one filter for the product's set and for the
21
+ * set a save switches to, so the two cannot disagree.
22
+ */
23
+ export function scopedAttributesOf(views, setDefinitions) {
24
+ return new Map(views
25
+ .filter((view) => setDefinitions.has(view.customFieldDefinitionId) && view.valueType !== 'page_builder')
26
+ .map((view) => [view.key, view]));
27
+ }
28
+ export function assertProductId(productId) {
29
+ if (!isUuidShape(productId))
30
+ throw new HttpError(404, ERROR_CODES.PRODUCT_NOT_FOUND, 'Product not found.');
31
+ }
32
+ /** The product's current `scope_version` (R7), as the opaque string the API carries. */
33
+ export async function readScopeVersion(em, productId) {
34
+ const [row] = await em.execute(`select scope_version::text as v from products where id = ?`, [productId]);
35
+ return row?.v ?? '0';
36
+ }
37
+ export async function loadScopedState(em, productId, deps) {
38
+ assertProductId(productId);
39
+ const product = await em.findOne(Product, { id: productId, deletedAt: null });
40
+ if (!product)
41
+ throw new HttpError(404, ERROR_CODES.PRODUCT_NOT_FOUND, 'Product not found.');
42
+ const [version, categoryRows, members, channelRows, languageRows, valueOverrides, galleryItems, galleryLabels, galleryOverrides, roleOverrides, attachments, attachmentOverrides, packagingUnits, packagingOverrides, urlKeys, views, setDefinitions,] = await Promise.all([
43
+ readScopeVersion(em, productId),
44
+ em.execute(`select category_id::text as category_id from product_categories where product_id = ? order by category_id`, [productId]),
45
+ deps.membership.listChannelsForEntity('product', productId),
46
+ em.find(ProductChannelScope, { productId }),
47
+ em.find(ProductChannelLanguageScope, { productId }),
48
+ em.find(ProductValueOverride, { productId }),
49
+ em.find(GalleryItem, { productId }, { orderBy: { position: 'asc', id: 'asc' } }),
50
+ em.find(GalleryItemLabel, { productId }),
51
+ em.find(GalleryItemScopeOverride, { productId }),
52
+ em.find(GalleryRoleScopeOverride, { productId }),
53
+ em.find(ProductAttachment, { productId }, { orderBy: { position: 'asc', id: 'asc' } }),
54
+ em.find(ProductAttachmentScopeOverride, { productId }),
55
+ em.find(ProductPackagingUnit, { productId }, { orderBy: { position: 'asc', id: 'asc' } }),
56
+ em.find(ProductPackagingUnitScopeOverride, { productId }),
57
+ em.find(ProductUrlKey, { productId }),
58
+ deps.listAttributes(),
59
+ attributeSetDefinitionIds(em, product.attributeSetId),
60
+ ]);
61
+ return {
62
+ product,
63
+ version,
64
+ categoryIds: categoryRows.map((row) => row.category_id),
65
+ members: members
66
+ .map((channel) => ({
67
+ ...toScopeChannel(channel),
68
+ code: channel.code,
69
+ name: channel.name ?? null,
70
+ }))
71
+ .sort((a, b) => a.code.localeCompare(b.code)),
72
+ channelRows,
73
+ languageRows,
74
+ valueOverrides,
75
+ galleryItems,
76
+ galleryLabels,
77
+ galleryOverrides,
78
+ roleOverrides,
79
+ attachments,
80
+ attachmentOverrides,
81
+ packagingUnits,
82
+ packagingOverrides,
83
+ urlKeys,
84
+ attributes: scopedAttributesOf(views, setDefinitions),
85
+ };
86
+ }
87
+ /**
88
+ * The scope a request names (§1), resolved against the product's member channels: neither →
89
+ * Global; a channel → Channel; both → Channel × language, the language in the channel's own
90
+ * spelling. A language without a channel is `422 VALIDATION_FAILED` (`details.field = 'scope'`,
91
+ * FR-010: there is no Language scope); a channel the product is not a member of, or a language
92
+ * it does not offer, is `422 SCOPE_INVALID`.
93
+ */
94
+ export function resolveRequestScope(members, request,
95
+ /**
96
+ * FR-101 (163 FR-015) — the write only removes overrides (`{ inherit: true }` in every cell):
97
+ * an orphaned scope — a channel the product left, a language the channel dropped — is
98
+ * accepted as named, so the overview's orphan deletion keeps working. A value there is still
99
+ * `SCOPE_INVALID`.
100
+ */
101
+ options = {}) {
102
+ const parsed = scopeFromRequest(request);
103
+ if (!parsed.ok) {
104
+ throw new HttpError(422, ERROR_CODES.VALIDATION_FAILED, 'A language scope needs a sales channel.', { field: 'scope' });
105
+ }
106
+ const scope = parsed.scope;
107
+ if (scope.level === 'global')
108
+ return scope;
109
+ const channel = members.find((member) => member.id === scope.channelId);
110
+ if (options.removalOnly === true) {
111
+ const spelling = channel?.languages.find((language) => scope.level === 'channel_language' && sameLanguage(language, scope.languageCode));
112
+ if (!channel || (scope.level === 'channel_language' && spelling === undefined))
113
+ return scope;
114
+ }
115
+ if (!channel) {
116
+ throw new HttpError(422, ERROR_CODES.SCOPE_INVALID, 'The product is not a member of this sales channel.', {
117
+ channelId: scope.channelId,
118
+ reason: 'not_a_member',
119
+ });
120
+ }
121
+ if (scope.level === 'channel')
122
+ return scope;
123
+ const spelling = channel.languages.find((language) => sameLanguage(language, scope.languageCode));
124
+ if (spelling === undefined) {
125
+ throw new HttpError(422, ERROR_CODES.SCOPE_INVALID, 'The sales channel does not offer this language.', {
126
+ channelId: scope.channelId,
127
+ languageCode: scope.languageCode,
128
+ reason: 'language_not_offered',
129
+ });
130
+ }
131
+ return { level: 'channel_language', channelId: channel.id, languageCode: spelling };
132
+ }
133
+ /** Rows at a valid scope only: a member channel, and at C×L a language that channel offers (orphans dropped). */
134
+ export function atValidScopes(rows, members) {
135
+ return rows.filter((row) => {
136
+ const channel = members.find((member) => member.id === row.channelId);
137
+ if (!channel)
138
+ return false;
139
+ return row.languageCode === null || channel.languages.some((language) => sameLanguage(language, row.languageCode));
140
+ });
141
+ }
142
+ /**
143
+ * The **one** writer of `products.scope_version`: `+ 1`, conditioned on `expected` when the
144
+ * caller holds a version (the save, the copy). Runs as the first statement of the Command, so
145
+ * the row lock it takes serialises every later read of the transaction. A stale `expected` is
146
+ * `409 VERSION_CONFLICT`; an unknown or deleted product `404 PRODUCT_NOT_FOUND`.
147
+ */
148
+ export async function bumpScopeVersion(em, productId, expected) {
149
+ const rows = await em.execute(expected === undefined
150
+ ? `update products set scope_version = scope_version + 1 where id = ? and deleted_at is null returning scope_version::text as v`
151
+ : `update products set scope_version = scope_version + 1 where id = ? and deleted_at is null and scope_version = ?::bigint returning scope_version::text as v`, expected === undefined ? [productId] : [productId, expected]);
152
+ if (rows[0])
153
+ return rows[0].v;
154
+ const [exists] = await em.execute(`select id from products where id = ? and deleted_at is null`, [productId]);
155
+ if (!exists)
156
+ throw new HttpError(404, ERROR_CODES.PRODUCT_NOT_FOUND, 'Product not found.');
157
+ throw new HttpError(409, ERROR_CODES.VERSION_CONFLICT, 'The product was saved by someone else; reload it and try again.');
158
+ }
159
+ //# sourceMappingURL=scoped-values-state.js.map
@@ -0,0 +1,36 @@
1
+ import type { EntityManager } from '@mikro-orm/postgresql';
2
+ import type { CopyScopedValueRequest, CopyScopedValueResponse, SaveScopedValuesRequest, SaveScopedValuesResponse, ScopedValuesData } from '@endora-commerce/contracts';
3
+ import type { CommandBus } from '@endora-commerce/platform/commands';
4
+ import { type ScopedValuesCommandDeps } from '../commands/scoped-values.commands.js';
5
+ import { type ScopedValuesReadDeps } from './scoped-values-read.service.js';
6
+ import { type ScopeRef } from '@endora-commerce/contracts';
7
+ /**
8
+ * Feature 174 (T036–T038) — the editor's one read and one save (`contracts/scoped-values-api.md`
9
+ * §2–§3). The save runs as one `CommandBus.run`; its answer is the product re-read at the same
10
+ * scope after commit, with the completeness gate's warn-mode warnings.
11
+ */
12
+ export declare class ScopedValuesService {
13
+ #private;
14
+ private readonly emFactory;
15
+ private readonly deps;
16
+ private readonly commandBus?;
17
+ constructor(emFactory: () => EntityManager, deps: ScopedValuesReadDeps & ScopedValuesCommandDeps, commandBus?: CommandBus | undefined);
18
+ /** The request's scope resolved against the product's channels (§1) — 404 / 422 as the read answers. */
19
+ resolveScope(productId: string, request: {
20
+ channelId?: string | undefined;
21
+ languageCode?: string | undefined;
22
+ }): Promise<ScopeRef>;
23
+ completenessMode(): Promise<"warn" | "refuse"> | undefined;
24
+ read(productId: string, request: {
25
+ channelId?: string | undefined;
26
+ languageCode?: string | undefined;
27
+ }): Promise<ScopedValuesData>;
28
+ save(productId: string, body: SaveScopedValuesRequest): Promise<SaveScopedValuesResponse>;
29
+ /**
30
+ * Feature 174 (T115; §4, FR-086) — "Copy to other channels". A dry run plans the copy on a read
31
+ * (the version compared, never bumped) and lists the overwrites; a copy is one Command
32
+ * `product.scoped_values.copy_to_channels`.
33
+ */
34
+ copy(productId: string, body: CopyScopedValueRequest): Promise<CopyScopedValueResponse>;
35
+ }
36
+ //# sourceMappingURL=scoped-values.service.d.ts.map
@@ -0,0 +1,92 @@
1
+ import { UniqueConstraintViolationException } from '@mikro-orm/core';
2
+ import { rethrowIfModuleDisabled } from '@endora-commerce/platform/kernel';
3
+ import { planCopy, scopedValuesCopyCommand, scopedValuesSaveCommand, ScopedSaveNothingChanged, } from '../commands/scoped-values.commands.js';
4
+ import { ScopedValuesReadService } from './scoped-values-read.service.js';
5
+ import { ERROR_CODES, toScopeChannel } from '@endora-commerce/contracts';
6
+ import { HttpError } from '@endora-commerce/platform/http';
7
+ import { Product } from '../entities/product.entity.js';
8
+ import { assertProductId, loadScopedState, readScopeVersion, resolveRequestScope } from './scoped-values-state.js';
9
+ /**
10
+ * Feature 174 (T036–T038) — the editor's one read and one save (`contracts/scoped-values-api.md`
11
+ * §2–§3). The save runs as one `CommandBus.run`; its answer is the product re-read at the same
12
+ * scope after commit, with the completeness gate's warn-mode warnings.
13
+ */
14
+ export class ScopedValuesService {
15
+ emFactory;
16
+ deps;
17
+ commandBus;
18
+ #read;
19
+ constructor(emFactory, deps, commandBus) {
20
+ this.emFactory = emFactory;
21
+ this.deps = deps;
22
+ this.commandBus = commandBus;
23
+ this.#read = new ScopedValuesReadService(emFactory, deps);
24
+ }
25
+ /** The request's scope resolved against the product's channels (§1) — 404 / 422 as the read answers. */
26
+ async resolveScope(productId, request) {
27
+ assertProductId(productId);
28
+ const em = this.emFactory();
29
+ const product = await em.findOne(Product, { id: productId, deletedAt: null }, { fields: ['id'] });
30
+ if (!product)
31
+ throw new HttpError(404, ERROR_CODES.PRODUCT_NOT_FOUND, 'Product not found.');
32
+ const members = (await this.deps.membership.listChannelsForEntity('product', productId)).map((channel) => toScopeChannel(channel));
33
+ return resolveRequestScope(members, request);
34
+ }
35
+ completenessMode() {
36
+ return this.deps.gate?.mode();
37
+ }
38
+ read(productId, request) {
39
+ return this.#read.read(productId, request);
40
+ }
41
+ async save(productId, body) {
42
+ const touchesStatus = body.changes.status !== undefined;
43
+ const completeness = touchesStatus ? await this.deps.gate?.mode() : undefined;
44
+ const command = scopedValuesSaveCommand(this.deps, productId, body, completeness);
45
+ // Constitution XIII — the editor's main write is audited or refused, never run bare.
46
+ if (!this.commandBus)
47
+ throw new Error('ScopedValuesService: the save needs the command bus.');
48
+ let result;
49
+ try {
50
+ result = await this.commandBus.run(command);
51
+ }
52
+ catch (error) {
53
+ // `seo` off while the save names SEO fields: the port's 503 passes through unchanged.
54
+ rethrowIfModuleDisabled(error);
55
+ if (error instanceof ScopedSaveNothingChanged) {
56
+ result = error.result;
57
+ }
58
+ else if (error instanceof UniqueConstraintViolationException && body.changes.product?.sku !== undefined) {
59
+ // A SKU taken between the step-3a check and the write (code review 1): the same answer.
60
+ throw new HttpError(409, ERROR_CODES.SKU_ALREADY_EXISTS, 'This SKU already exists.', { field: 'product.sku' });
61
+ }
62
+ else {
63
+ throw error;
64
+ }
65
+ }
66
+ const em = this.emFactory().fork();
67
+ const state = await loadScopedState(em, productId, this.deps);
68
+ return { data: await this.#read.project(state, result.scope), warnings: result.warnings };
69
+ }
70
+ /**
71
+ * Feature 174 (T115; §4, FR-086) — "Copy to other channels". A dry run plans the copy on a read
72
+ * (the version compared, never bumped) and lists the overwrites; a copy is one Command
73
+ * `product.scoped_values.copy_to_channels`.
74
+ */
75
+ async copy(productId, body) {
76
+ assertProductId(productId);
77
+ if (body.dryRun === true) {
78
+ const em = this.emFactory().fork();
79
+ const state = await loadScopedState(em, productId, this.deps);
80
+ const version = await readScopeVersion(em, productId);
81
+ if (version !== body.version) {
82
+ throw new HttpError(409, ERROR_CODES.VERSION_CONFLICT, 'The product changed since it was read.', { currentVersion: version });
83
+ }
84
+ return { data: { overwrites: planCopy(state, body).overwrites, applied: 0, version } };
85
+ }
86
+ if (!this.commandBus)
87
+ throw new Error('ScopedValuesService: the copy needs the command bus.');
88
+ const result = await this.commandBus.run(scopedValuesCopyCommand(this.deps, productId, body));
89
+ return { data: { overwrites: result.overwrites, applied: result.applied, version: result.version } };
90
+ }
91
+ }
92
+ //# sourceMappingURL=scoped-values.service.js.map
@@ -1,5 +1,5 @@
1
1
  import type { EntityManager } from '@mikro-orm/postgresql';
2
- import { type AttributeScope, type OverrideRow, type StorefrontOverrideContext } from '@endora-commerce/contracts';
2
+ import { type OverrideRow, type ScopeLevel, type StorefrontOverrideContext } from '@endora-commerce/contracts';
3
3
  /**
4
4
  * Issue #384 — what a storefront read needs to show a product's
5
5
  * per-(sales channel, language) overrides (features 022/023).
@@ -11,7 +11,7 @@ import { type AttributeScope, type OverrideRow, type StorefrontOverrideContext }
11
11
  * in this file is what only `catalog` can do: read the rows, and map a
12
12
  * product's user attributes through their scopes.
13
13
  */
14
- export { channelOverrideFor, effectiveSystemText, overrideLanguages, type StorefrontOverrideContext, } from '@endora-commerce/contracts';
14
+ export { effectiveScopedValue, effectiveSystemText, type StorefrontOverrideContext, } from '@endora-commerce/contracts';
15
15
  /**
16
16
  * Every override row the request's sales channel holds for a set of products,
17
17
  * in one statement, bucketed by product id. Rows are independent of the
@@ -21,11 +21,10 @@ export { channelOverrideFor, effectiveSystemText, overrideLanguages, type Storef
21
21
  */
22
22
  export declare function loadChannelOverridesByProduct(em: EntityManager, productIds: readonly string[], channelId: string): Promise<Map<string, OverrideRow[]>>;
23
23
  /**
24
- * The product's `attributeValues` with every channel-scoped user attribute
25
- * replaced by its override for this context — walked over the attribute's own
26
- * baseline value, so a per-language value stops the walk where it answers. Returns the input record itself
27
- * when no user-attribute override row exists, so a product without overrides
28
- * costs no attribute-metadata read and no copy.
24
+ * The product's `attributeValues` with every scopable user attribute replaced by its effective
25
+ * value at `ctx` (C×L → C → Global, restricted to the attribute's scope set; an empty override
26
+ * answers `null`). Returns the input record itself when no user-attribute override row exists, so
27
+ * a product without overrides costs no attribute-metadata read and no copy.
29
28
  */
30
- export declare function effectiveAttributeValues(values: Record<string, unknown>, overrides: readonly OverrideRow[] | undefined, ctx: StorefrontOverrideContext, scopeOf: () => Promise<Map<string, AttributeScope>>): Promise<Record<string, unknown>>;
29
+ export declare function effectiveAttributeValues(values: Record<string, unknown>, overrides: readonly OverrideRow[] | undefined, ctx: StorefrontOverrideContext, levelsOf: () => Promise<Map<string, readonly ScopeLevel[]>>): Promise<Record<string, unknown>>;
31
30
  //# sourceMappingURL=storefront-value-overrides.d.ts.map
@@ -1,4 +1,4 @@
1
- import { SYSTEM_ATTRIBUTE_SCOPES, channelOverrideFor, } from '@endora-commerce/contracts';
1
+ import { SYSTEM_ATTRIBUTE_SCOPES, effectiveScopedValue, } from '@endora-commerce/contracts';
2
2
  import { loadOverridesByProduct } from './product-value-resolver.service.js';
3
3
  /**
4
4
  * Issue #384 — what a storefront read needs to show a product's
@@ -11,7 +11,7 @@ import { loadOverridesByProduct } from './product-value-resolver.service.js';
11
11
  * in this file is what only `catalog` can do: read the rows, and map a
12
12
  * product's user attributes through their scopes.
13
13
  */
14
- export { channelOverrideFor, effectiveSystemText, overrideLanguages, } from '@endora-commerce/contracts';
14
+ export { effectiveScopedValue, effectiveSystemText, } from '@endora-commerce/contracts';
15
15
  /**
16
16
  * Every override row the request's sales channel holds for a set of products,
17
17
  * in one statement, bucketed by product id. Rows are independent of the
@@ -23,25 +23,22 @@ export function loadChannelOverridesByProduct(em, productIds, channelId) {
23
23
  return loadOverridesByProduct(em, { productIds, channelId });
24
24
  }
25
25
  /**
26
- * The product's `attributeValues` with every channel-scoped user attribute
27
- * replaced by its override for this context — walked over the attribute's own
28
- * baseline value, so a per-language value stops the walk where it answers. Returns the input record itself
29
- * when no user-attribute override row exists, so a product without overrides
30
- * costs no attribute-metadata read and no copy.
26
+ * The product's `attributeValues` with every scopable user attribute replaced by its effective
27
+ * value at `ctx` (C×L → C → Global, restricted to the attribute's scope set; an empty override
28
+ * answers `null`). Returns the input record itself when no user-attribute override row exists, so
29
+ * a product without overrides costs no attribute-metadata read and no copy.
31
30
  */
32
- export async function effectiveAttributeValues(values, overrides, ctx, scopeOf) {
31
+ export async function effectiveAttributeValues(values, overrides, ctx, levelsOf) {
33
32
  const userRows = (overrides ?? []).filter((o) => !Object.prototype.hasOwnProperty.call(SYSTEM_ATTRIBUTE_SCOPES, o.attributeKey));
34
33
  if (userRows.length === 0)
35
34
  return values;
36
- const scopes = await scopeOf();
35
+ const levels = await levelsOf();
37
36
  const out = { ...values };
38
37
  for (const key of new Set(userRows.map((o) => o.attributeKey))) {
39
- const scope = scopes.get(key);
40
- if (!scope)
38
+ const scopeLevels = levels.get(key);
39
+ if (!scopeLevels)
41
40
  continue;
42
- const v = channelOverrideFor(userRows, key, scope, ctx, values[key]);
43
- if (v !== undefined)
44
- out[key] = v;
41
+ out[key] = effectiveScopedValue(userRows, key, scopeLevels, ctx, values[key]);
45
42
  }
46
43
  return out;
47
44
  }
@@ -0,0 +1,78 @@
1
+ import { Worker } from 'bullmq';
2
+ import type { Redis } from 'ioredis';
3
+ import { type PlatformLogger } from '@endora-commerce/platform/kernel';
4
+ /**
5
+ * Table maintenance after a catalogue import — issue #409 (Principle X).
6
+ *
7
+ * Right after a bulk write Postgres has neither fresh statistics nor a
8
+ * visibility map for the rows it rewrote, until autovacuum's first pass —
9
+ * which, for an import below its scale factor, may never come. The admin's
10
+ * ordered walk over `products_admin_order_<lang>` and its search count lean on
11
+ * index-only scans, and without the visibility map each of them fetches every
12
+ * heap tuple (spec 161 R14, `book-lines-page.bench.ts`). So an import asks for
13
+ * `VACUUM (ANALYZE)` of `products` and `product_variants`: `ANALYZE` alone does
14
+ * not set the visibility map, and `VACUUM` cannot run inside a transaction, so
15
+ * it is a job here and never a statement in the import.
16
+ *
17
+ * **One job per table per window.** The job is delayed by the window and
18
+ * deduplicated by its table, so every import while it waits is absorbed — the
19
+ * vacuum still runs after them, because it runs later. An import while it
20
+ * runs keeps one follow-up (`keepLastIfActive`). `import_export` reaches this
21
+ * through `catalogBulkImportPort` — the import is this module's write — and
22
+ * never names a table. `price_lists` keeps its own queue for its own tables.
23
+ *
24
+ * Best effort by design: the import has committed when it asks, so a queue
25
+ * that cannot be reached is logged and the import answers as usual —
26
+ * autovacuum remains the floor. Attached with `ctx.worker`, so it stops with
27
+ * the module (Principle XVII), and built only where the host says this process
28
+ * consumes queues.
29
+ */
30
+ export declare const CATALOG_TABLE_MAINTENANCE_QUEUE = "catalog.table-maintenance";
31
+ export declare const TABLE_MAINTENANCE_JOB = "vacuum-analyze";
32
+ /** The tables a catalogue import rewrites. */
33
+ export declare const CATALOG_BULK_TABLES: readonly ["products", "product_variants"];
34
+ export type CatalogBulkTable = (typeof CATALOG_BULK_TABLES)[number];
35
+ /**
36
+ * How long a request waits before its vacuum runs, and so how many writes one
37
+ * job absorbs. A minute is autovacuum's own default nap, and long enough for
38
+ * imports run back to back to land under one job.
39
+ */
40
+ export declare const TABLE_MAINTENANCE_WINDOW_MS = 60000;
41
+ interface MaintenanceQueue {
42
+ add(name: string, data: {
43
+ table: string;
44
+ }, options: Record<string, unknown>): Promise<unknown>;
45
+ close(): Promise<void>;
46
+ }
47
+ export interface TableMaintenanceProducer {
48
+ /** Ask for `VACUUM (ANALYZE)` of this module's bulk tables; answers whether it was asked. Never throws. */
49
+ request(): Promise<boolean>;
50
+ close(): Promise<void>;
51
+ }
52
+ export declare function createTableMaintenanceProducer(input: {
53
+ readonly redis?: Redis | undefined;
54
+ /** A queue to use instead of one built on `redis` (tests). */
55
+ readonly queue?: MaintenanceQueue;
56
+ readonly onError?: (err: unknown) => void;
57
+ /** {@link TABLE_MAINTENANCE_WINDOW_MS} unless a test shortens it. */
58
+ readonly windowMs?: number;
59
+ }): TableMaintenanceProducer;
60
+ /**
61
+ * The job: `VACUUM (ANALYZE)` of one of this module's tables, on a connection
62
+ * outside any transaction. The name comes off a queue, so it is checked
63
+ * against the module's own list before it reaches the statement.
64
+ */
65
+ export declare function vacuumAnalyzeTable(connection: {
66
+ execute(sql: string): Promise<unknown>;
67
+ }, table: string): Promise<void>;
68
+ export declare function startTableMaintenanceWorker(input: {
69
+ readonly processRunsWorkers: boolean;
70
+ readonly moduleQueueRedis: Redis | undefined;
71
+ readonly connection: () => {
72
+ execute(sql: string): Promise<unknown>;
73
+ };
74
+ readonly log: PlatformLogger;
75
+ readonly attach: (worker: Worker) => void;
76
+ }): boolean;
77
+ export {};
78
+ //# sourceMappingURL=table-maintenance-queue.d.ts.map
@@ -0,0 +1,97 @@
1
+ import { Queue, Worker } from 'bullmq';
2
+ import { enterSystemScope } from '@endora-commerce/platform/kernel';
3
+ /**
4
+ * Table maintenance after a catalogue import — issue #409 (Principle X).
5
+ *
6
+ * Right after a bulk write Postgres has neither fresh statistics nor a
7
+ * visibility map for the rows it rewrote, until autovacuum's first pass —
8
+ * which, for an import below its scale factor, may never come. The admin's
9
+ * ordered walk over `products_admin_order_<lang>` and its search count lean on
10
+ * index-only scans, and without the visibility map each of them fetches every
11
+ * heap tuple (spec 161 R14, `book-lines-page.bench.ts`). So an import asks for
12
+ * `VACUUM (ANALYZE)` of `products` and `product_variants`: `ANALYZE` alone does
13
+ * not set the visibility map, and `VACUUM` cannot run inside a transaction, so
14
+ * it is a job here and never a statement in the import.
15
+ *
16
+ * **One job per table per window.** The job is delayed by the window and
17
+ * deduplicated by its table, so every import while it waits is absorbed — the
18
+ * vacuum still runs after them, because it runs later. An import while it
19
+ * runs keeps one follow-up (`keepLastIfActive`). `import_export` reaches this
20
+ * through `catalogBulkImportPort` — the import is this module's write — and
21
+ * never names a table. `price_lists` keeps its own queue for its own tables.
22
+ *
23
+ * Best effort by design: the import has committed when it asks, so a queue
24
+ * that cannot be reached is logged and the import answers as usual —
25
+ * autovacuum remains the floor. Attached with `ctx.worker`, so it stops with
26
+ * the module (Principle XVII), and built only where the host says this process
27
+ * consumes queues.
28
+ */
29
+ export const CATALOG_TABLE_MAINTENANCE_QUEUE = 'catalog.table-maintenance';
30
+ export const TABLE_MAINTENANCE_JOB = 'vacuum-analyze';
31
+ /** The tables a catalogue import rewrites. */
32
+ export const CATALOG_BULK_TABLES = ['products', 'product_variants'];
33
+ /**
34
+ * How long a request waits before its vacuum runs, and so how many writes one
35
+ * job absorbs. A minute is autovacuum's own default nap, and long enough for
36
+ * imports run back to back to land under one job.
37
+ */
38
+ export const TABLE_MAINTENANCE_WINDOW_MS = 60_000;
39
+ const SCOPE_REASON = 'catalog: vacuum the tables an import rewrote';
40
+ export function createTableMaintenanceProducer(input) {
41
+ const windowMs = input.windowMs ?? TABLE_MAINTENANCE_WINDOW_MS;
42
+ let queue = input.queue;
43
+ return {
44
+ async request() {
45
+ if (queue === undefined) {
46
+ if (input.redis === undefined)
47
+ return false;
48
+ queue = new Queue(CATALOG_TABLE_MAINTENANCE_QUEUE, {
49
+ connection: input.redis,
50
+ defaultJobOptions: { removeOnComplete: true, removeOnFail: true, attempts: 2, backoff: { type: 'fixed', delay: 10_000 } },
51
+ });
52
+ }
53
+ try {
54
+ for (const table of CATALOG_BULK_TABLES) {
55
+ await queue.add(TABLE_MAINTENANCE_JOB, { table }, { delay: windowMs, deduplication: { id: table, keepLastIfActive: true } });
56
+ }
57
+ return true;
58
+ }
59
+ catch (err) {
60
+ input.onError?.(err);
61
+ return false;
62
+ }
63
+ },
64
+ async close() {
65
+ await queue?.close();
66
+ queue = input.queue;
67
+ },
68
+ };
69
+ }
70
+ /**
71
+ * The job: `VACUUM (ANALYZE)` of one of this module's tables, on a connection
72
+ * outside any transaction. The name comes off a queue, so it is checked
73
+ * against the module's own list before it reaches the statement.
74
+ */
75
+ export async function vacuumAnalyzeTable(connection, table) {
76
+ if (!CATALOG_BULK_TABLES.includes(table)) {
77
+ throw new Error(`table maintenance: "${table}" is not a catalog table`);
78
+ }
79
+ await connection.execute(`vacuum (analyze) "${table}"`);
80
+ }
81
+ export function startTableMaintenanceWorker(input) {
82
+ if (!input.processRunsWorkers || input.moduleQueueRedis === undefined)
83
+ return false;
84
+ const worker = new Worker(CATALOG_TABLE_MAINTENANCE_QUEUE, (job) => enterSystemScope(SCOPE_REASON, async () => {
85
+ const start = Date.now();
86
+ await vacuumAnalyzeTable(input.connection(), job.data.table);
87
+ input.log.info({ table: job.data.table, ms: Date.now() - start }, 'catalog: vacuum (analyze) after an import');
88
+ }),
89
+ // One at a time: two vacuums of one table wait on each other anyway.
90
+ { connection: input.moduleQueueRedis, concurrency: 1 });
91
+ worker.on('failed', (job, err) => {
92
+ input.log.error({ err, table: job?.data.table, attemptsMade: job?.attemptsMade }, 'catalog: vacuum (analyze) after an import failed; autovacuum remains the fallback');
93
+ });
94
+ input.attach(worker);
95
+ return true;
96
+ }
97
+ //# sourceMappingURL=table-maintenance-queue.js.map