@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.
- package/dist/admin/components/CopyToChannelsDialog.d.ts +37 -0
- package/dist/admin/components/CopyToChannelsDialog.js +83 -0
- package/dist/admin/components/PackagingUnitsEditor.d.ts +13 -4
- package/dist/admin/components/PackagingUnitsEditor.js +21 -85
- package/dist/admin/components/ProductAttachmentsSection.d.ts +1 -3
- package/dist/admin/components/ProductAttachmentsSection.js +59 -98
- package/dist/admin/components/ProductAttributesTab.d.ts +1 -11
- package/dist/admin/components/ProductAttributesTab.js +128 -119
- package/dist/admin/components/ProductContentCard.d.ts +41 -0
- package/dist/admin/components/ProductContentCard.js +28 -0
- package/dist/admin/components/ProductEditorSaveAction.d.ts +22 -0
- package/dist/admin/components/ProductEditorSaveAction.js +23 -0
- package/dist/admin/components/ProductGallerySection.d.ts +2 -13
- package/dist/admin/components/ProductGallerySection.js +98 -354
- package/dist/admin/components/ProductInventoryTab.d.ts +12 -1
- package/dist/admin/components/ProductInventoryTab.js +52 -115
- package/dist/admin/components/ProductOrderRulesCard.d.ts +11 -15
- package/dist/admin/components/ProductOrderRulesCard.js +15 -268
- package/dist/admin/components/ProductScopeBar.d.ts +34 -0
- package/dist/admin/components/ProductScopeBar.js +70 -0
- package/dist/admin/components/ProductScopeOverview.d.ts +13 -1
- package/dist/admin/components/ProductScopeOverview.js +56 -37
- package/dist/admin/components/ProductUrlRedirects.d.ts +15 -0
- package/dist/admin/components/ProductUrlRedirects.js +70 -0
- package/dist/admin/components/ProductsBulkEditDialog.js +4 -3
- package/dist/admin/components/editor/DetailsTab.d.ts +30 -0
- package/dist/admin/components/editor/DetailsTab.js +60 -0
- package/dist/admin/components/editor/SectionHeading.d.ts +22 -0
- package/dist/admin/components/editor/SectionHeading.js +19 -0
- package/dist/admin/components/editor/confirm-removal.d.ts +13 -0
- package/dist/admin/components/editor/confirm-removal.js +33 -0
- package/dist/admin/components/editor/editor-context.d.ts +55 -0
- package/dist/admin/components/editor/editor-context.js +88 -0
- package/dist/admin/components/editor/scoped-controls.d.ts +46 -0
- package/dist/admin/components/editor/scoped-controls.js +64 -0
- package/dist/admin/index.d.ts +1 -1
- package/dist/admin/index.js +11 -0
- package/dist/admin/lib/attribute-scope.d.ts +17 -14
- package/dist/admin/lib/attribute-scope.js +12 -9
- package/dist/admin/lib/bulk-result-outcome.d.ts +14 -0
- package/dist/admin/lib/bulk-result-outcome.js +13 -0
- package/dist/admin/lib/editor-scope.d.ts +35 -0
- package/dist/admin/lib/editor-scope.js +114 -0
- package/dist/admin/lib/order-minimum-input.d.ts +13 -0
- package/dist/admin/lib/order-minimum-input.js +16 -0
- package/dist/admin/lib/product-labels.d.ts +0 -2
- package/dist/admin/lib/product-labels.js +1 -5
- package/dist/admin/lib/product-scopes-api.d.ts +5 -22
- package/dist/admin/lib/product-scopes-api.js +4 -48
- package/dist/admin/lib/product-url-keys-api.d.ts +4 -27
- package/dist/admin/lib/product-url-keys-api.js +1 -50
- package/dist/admin/lib/scope-overview.d.ts +13 -14
- package/dist/admin/lib/scope-overview.js +36 -31
- package/dist/admin/lib/scoped-editor-store.d.ts +81 -0
- package/dist/admin/lib/scoped-editor-store.js +198 -0
- package/dist/admin/lib/scoped-values-api.d.ts +14 -0
- package/dist/admin/lib/scoped-values-api.js +55 -0
- package/dist/admin/pages/AttachmentTypesPage.js +14 -4
- package/dist/admin/pages/AttributeSetsPage.js +11 -4
- package/dist/admin/pages/AttributesManager.js +130 -40
- package/dist/admin/pages/BulkOperationDetailPage.js +11 -4
- package/dist/admin/pages/CategoriesTree.d.ts +5 -0
- package/dist/admin/pages/CategoriesTree.js +226 -40
- package/dist/admin/pages/ProductContentPage.d.ts +27 -0
- package/dist/admin/pages/ProductContentPage.js +161 -0
- package/dist/admin/pages/ProductCreateForm.d.ts +3 -0
- package/dist/admin/pages/ProductCreateForm.js +87 -0
- package/dist/admin/pages/ProductEditor.js +938 -458
- package/dist/admin/pages/ProductsList.js +33 -38
- package/dist/backend/admin-search-provider.d.ts +2 -1
- package/dist/backend/admin-search-provider.js +1 -1
- package/dist/backend/commands/attribute-commands.d.ts +4 -3
- package/dist/backend/commands/attribute-commands.js +137 -30
- package/dist/backend/commands/product-content-commands.d.ts +31 -0
- package/dist/backend/commands/product-content-commands.js +70 -0
- package/dist/backend/commands/scoped-values.commands.d.ts +95 -0
- package/dist/backend/commands/scoped-values.commands.js +235 -0
- package/dist/backend/demo/reset.js +2 -1
- package/dist/backend/demo/rows.d.ts +18 -0
- package/dist/backend/demo/rows.js +18 -0
- package/dist/backend/demo/seed.d.ts +2 -1
- package/dist/backend/demo/seed.js +20 -6
- package/dist/backend/entities/gallery-item-scope-override.entity.d.ts +30 -0
- package/dist/backend/entities/gallery-item-scope-override.entity.js +80 -0
- package/dist/backend/entities/gallery-item.entity.d.ts +7 -6
- package/dist/backend/entities/gallery-item.entity.js +11 -6
- package/dist/backend/entities/gallery-role-scope-override.entity.d.ts +28 -0
- package/dist/backend/entities/gallery-role-scope-override.entity.js +75 -0
- package/dist/backend/entities/product-attachment-scope-override.entity.d.ts +30 -0
- package/dist/backend/entities/product-attachment-scope-override.entity.js +80 -0
- package/dist/backend/entities/product-attachment.entity.d.ts +4 -6
- package/dist/backend/entities/product-attachment.entity.js +6 -12
- package/dist/backend/entities/product-attribute.entity.d.ts +5 -9
- package/dist/backend/entities/product-attribute.entity.js +5 -13
- package/dist/backend/entities/product-channel-scope.entity.d.ts +7 -2
- package/dist/backend/entities/product-channel-scope.entity.js +10 -1
- package/dist/backend/entities/product-content-value.entity.d.ts +39 -0
- package/dist/backend/entities/product-content-value.entity.js +81 -0
- package/dist/backend/entities/product-packaging-unit-scope-override.entity.d.ts +30 -0
- package/dist/backend/entities/product-packaging-unit-scope-override.entity.js +80 -0
- package/dist/backend/entities/product-packaging-unit.entity.d.ts +1 -7
- package/dist/backend/entities/product-packaging-unit.entity.js +0 -10
- package/dist/backend/entities/product-url-key.entity.d.ts +14 -19
- package/dist/backend/entities/product-url-key.entity.js +17 -22
- package/dist/backend/entities/product-url-redirect.entity.d.ts +8 -13
- package/dist/backend/entities/product-url-redirect.entity.js +13 -14
- package/dist/backend/entities/product-variant.entity.d.ts +8 -1
- package/dist/backend/entities/product-variant.entity.js +13 -2
- package/dist/backend/entities/product.entity.d.ts +31 -14
- package/dist/backend/entities/product.entity.js +41 -34
- package/dist/backend/index.d.ts +11 -3
- package/dist/backend/index.js +155 -49
- package/dist/backend/plugin.d.ts +36 -6
- package/dist/backend/plugin.js +36 -13
- package/dist/backend/prompt-tools.d.ts +3 -2
- package/dist/backend/prompt-tools.js +18 -7
- package/dist/backend/routes.admin.d.ts +15 -16
- package/dist/backend/routes.admin.js +122 -103
- package/dist/backend/routes.api-key.js +4 -2
- package/dist/backend/routes.external.js +3 -2
- package/dist/backend/routes.public.d.ts +8 -1
- package/dist/backend/routes.public.js +68 -11
- package/dist/backend/services/asset-references.d.ts +12 -1
- package/dist/backend/services/asset-references.js +42 -2
- package/dist/backend/services/attachment-packaging-scopes.d.ts +38 -20
- package/dist/backend/services/attachment-packaging-scopes.js +58 -75
- package/dist/backend/services/attachment.service.d.ts +4 -8
- package/dist/backend/services/attachment.service.js +35 -49
- package/dist/backend/services/attribute-filter-match.d.ts +14 -0
- package/dist/backend/services/attribute-filter-match.js +19 -0
- package/dist/backend/services/attribute-scope-preview.d.ts +17 -7
- package/dist/backend/services/attribute-scope-preview.js +30 -20
- package/dist/backend/services/attribute-set.service.d.ts +10 -1
- package/dist/backend/services/attribute-set.service.js +30 -4
- package/dist/backend/services/attribute-type-mapping.d.ts +2 -2
- package/dist/backend/services/attribute-type-mapping.js +6 -0
- package/dist/backend/services/attribute-usage.d.ts +31 -0
- package/dist/backend/services/attribute-usage.js +29 -0
- package/dist/backend/services/bulk-operation.service.d.ts +1 -1
- package/dist/backend/services/bulk-operation.service.js +16 -6
- package/dist/backend/services/bundle.service.js +19 -1
- package/dist/backend/services/catalog-admin-search.service.d.ts +3 -2
- package/dist/backend/services/catalog-admin-search.service.js +6 -6
- package/dist/backend/services/catalog-admin.service.d.ts +63 -12
- package/dist/backend/services/catalog-admin.service.js +368 -195
- package/dist/backend/services/catalog-attribute-read.service.d.ts +14 -0
- package/dist/backend/services/catalog-attribute-read.service.js +9 -19
- package/dist/backend/services/catalog-bulk-import.service.d.ts +58 -5
- package/dist/backend/services/catalog-bulk-import.service.js +192 -142
- package/dist/backend/services/catalog-bulk-update.service.d.ts +5 -3
- package/dist/backend/services/catalog-bulk-update.service.js +21 -8
- package/dist/backend/services/catalog-product-read.service.d.ts +11 -1
- package/dist/backend/services/catalog-product-read.service.js +37 -17
- package/dist/backend/services/catalog-query.service.d.ts +48 -8
- package/dist/backend/services/catalog-query.service.js +180 -116
- package/dist/backend/services/catalog-quick-search.service.js +5 -5
- package/dist/backend/services/catalog-write-ports.d.ts +14 -16
- package/dist/backend/services/catalog-write-ports.js +11 -70
- package/dist/backend/services/category-admin.service.js +29 -5
- package/dist/backend/services/content-attribute-rules.d.ts +61 -0
- package/dist/backend/services/content-attribute-rules.js +102 -0
- package/dist/backend/services/effective-value.sql.d.ts +24 -38
- package/dist/backend/services/effective-value.sql.js +37 -87
- package/dist/backend/services/gallery-scopes.d.ts +45 -22
- package/dist/backend/services/gallery-scopes.js +116 -109
- package/dist/backend/services/gallery.service.d.ts +13 -27
- package/dist/backend/services/gallery.service.js +75 -199
- package/dist/backend/services/grouped.service.js +20 -3
- package/dist/backend/services/packaging-unit.service.js +7 -12
- package/dist/backend/services/page-builder-content.d.ts +64 -0
- package/dist/backend/services/page-builder-content.js +113 -0
- package/dist/backend/services/primary-asset-url.d.ts +6 -1
- package/dist/backend/services/primary-asset-url.js +9 -4
- package/dist/backend/services/product-availability.service.d.ts +16 -3
- package/dist/backend/services/product-availability.service.js +58 -21
- package/dist/backend/services/product-content.service.d.ts +62 -0
- package/dist/backend/services/product-content.service.js +122 -0
- package/dist/backend/services/product-editor-preferences.service.d.ts +6 -0
- package/dist/backend/services/product-editor-preferences.service.js +12 -0
- package/dist/backend/services/product-global-field-rules.d.ts +39 -0
- package/dist/backend/services/product-global-field-rules.js +84 -0
- package/dist/backend/services/product-link.service.js +14 -16
- package/dist/backend/services/product-list-view-service.js +5 -8
- package/dist/backend/services/product-page-revalidation.d.ts +9 -0
- package/dist/backend/services/product-page-revalidation.js +19 -0
- package/dist/backend/services/product-scopes.service.d.ts +18 -8
- package/dist/backend/services/product-scopes.service.js +91 -36
- package/dist/backend/services/product-value-resolver.service.d.ts +2 -2
- package/dist/backend/services/product-value-resolver.service.js +4 -7
- package/dist/backend/services/publication-window-sweep.d.ts +61 -7
- package/dist/backend/services/publication-window-sweep.js +106 -19
- package/dist/backend/services/scheduled-work-probe.d.ts +34 -0
- package/dist/backend/services/scheduled-work-probe.js +30 -0
- package/dist/backend/services/scope-completeness.d.ts +11 -11
- package/dist/backend/services/scope-completeness.js +26 -33
- package/dist/backend/services/scope-overview.service.d.ts +24 -24
- package/dist/backend/services/scope-overview.service.js +33 -76
- package/dist/backend/services/scoped-store-adapters.d.ts +58 -0
- package/dist/backend/services/scoped-store-adapters.js +92 -0
- package/dist/backend/services/scoped-values-global-only.d.ts +36 -0
- package/dist/backend/services/scoped-values-global-only.js +92 -0
- package/dist/backend/services/scoped-values-import.d.ts +86 -0
- package/dist/backend/services/scoped-values-import.js +320 -0
- package/dist/backend/services/scoped-values-read.service.d.ts +56 -0
- package/dist/backend/services/scoped-values-read.service.js +289 -0
- package/dist/backend/services/scoped-values-save.service.d.ts +79 -0
- package/dist/backend/services/scoped-values-save.service.js +675 -0
- package/dist/backend/services/scoped-values-state.d.ts +94 -0
- package/dist/backend/services/scoped-values-state.js +159 -0
- package/dist/backend/services/scoped-values.service.d.ts +36 -0
- package/dist/backend/services/scoped-values.service.js +92 -0
- package/dist/backend/services/storefront-value-overrides.d.ts +7 -8
- package/dist/backend/services/storefront-value-overrides.js +11 -14
- package/dist/backend/services/table-maintenance-queue.d.ts +78 -0
- package/dist/backend/services/table-maintenance-queue.js +97 -0
- package/dist/backend/services/url-key-resolution.service.d.ts +12 -18
- package/dist/backend/services/url-key-resolution.service.js +43 -43
- package/dist/backend/services/url-key.service.d.ts +87 -135
- package/dist/backend/services/url-key.service.js +447 -619
- package/dist/manifest.d.ts +51 -1
- package/dist/manifest.js +111 -7
- package/dist/migrations/20261030T113855_catalog_scope_model_texts.d.ts +36 -0
- package/dist/migrations/20261030T113855_catalog_scope_model_texts.js +225 -0
- package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.d.ts +18 -0
- package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.js +39 -0
- package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.d.ts +6 -0
- package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.js +119 -0
- package/dist/migrations/20261030T113908_catalog_scope_model_media.d.ts +6 -0
- package/dist/migrations/20261030T113908_catalog_scope_model_media.js +185 -0
- package/dist/migrations/20261104T121504_catalog_product_content_values.d.ts +36 -0
- package/dist/migrations/20261104T121504_catalog_product_content_values.js +53 -0
- package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.d.ts +33 -0
- package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.js +58 -0
- package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.d.ts +36 -0
- package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.js +40 -0
- package/dist/migrations/20261114T000706_catalog_category_main_image.d.ts +37 -0
- package/dist/migrations/20261114T000706_catalog_category_main_image.js +56 -0
- package/dist/migrations/index.d.ts +9 -1
- package/dist/migrations/index.js +17 -1
- package/docs/catalog/attachments.md +53 -43
- package/docs/catalog/attribute-sets.md +3 -2
- package/docs/catalog/attributes.md +99 -25
- package/docs/catalog/category-content.md +9 -3
- package/docs/catalog/composite-products.md +5 -3
- package/docs/catalog/editing-a-product-at-a-scope.md +151 -0
- package/docs/catalog/gallery-and-labels.md +61 -60
- package/docs/catalog/packaging-units.md +43 -34
- package/docs/catalog/per-channel-per-language-overrides.md +83 -410
- package/docs/catalog/product-content.md +184 -0
- package/docs/catalog/product-links.md +2 -2
- package/docs/catalog/url-keys-and-redirects.md +79 -79
- package/docs/catalog.md +113 -31
- package/i18n/en.json +317 -274
- package/i18n/pl.json +319 -276
- package/package.json +13 -12
- package/dist/admin/components/AttachmentScopesDialog.d.ts +0 -22
- package/dist/admin/components/AttachmentScopesDialog.d.ts.map +0 -1
- package/dist/admin/components/AttachmentScopesDialog.js +0 -70
- package/dist/admin/components/AttachmentScopesDialog.js.map +0 -1
- package/dist/admin/components/PackagingUnitsEditor.d.ts.map +0 -1
- package/dist/admin/components/PackagingUnitsEditor.js.map +0 -1
- package/dist/admin/components/ProductAttachmentsSection.d.ts.map +0 -1
- package/dist/admin/components/ProductAttachmentsSection.js.map +0 -1
- package/dist/admin/components/ProductAttributesTab.d.ts.map +0 -1
- package/dist/admin/components/ProductAttributesTab.js.map +0 -1
- package/dist/admin/components/ProductGallerySection.d.ts.map +0 -1
- package/dist/admin/components/ProductGallerySection.js.map +0 -1
- package/dist/admin/components/ProductInventoryTab.d.ts.map +0 -1
- package/dist/admin/components/ProductInventoryTab.js.map +0 -1
- package/dist/admin/components/ProductOrderRulesCard.d.ts.map +0 -1
- package/dist/admin/components/ProductOrderRulesCard.js.map +0 -1
- package/dist/admin/components/ProductScopeControls.d.ts +0 -31
- package/dist/admin/components/ProductScopeControls.d.ts.map +0 -1
- package/dist/admin/components/ProductScopeControls.js +0 -243
- package/dist/admin/components/ProductScopeControls.js.map +0 -1
- package/dist/admin/components/ProductScopeEditor.d.ts +0 -88
- package/dist/admin/components/ProductScopeEditor.d.ts.map +0 -1
- package/dist/admin/components/ProductScopeEditor.js +0 -396
- package/dist/admin/components/ProductScopeEditor.js.map +0 -1
- package/dist/admin/components/ProductScopeOverview.d.ts.map +0 -1
- package/dist/admin/components/ProductScopeOverview.js.map +0 -1
- package/dist/admin/components/ProductStatusPills.d.ts.map +0 -1
- package/dist/admin/components/ProductStatusPills.js.map +0 -1
- package/dist/admin/components/ProductUrlKeysPanel.d.ts +0 -17
- package/dist/admin/components/ProductUrlKeysPanel.d.ts.map +0 -1
- package/dist/admin/components/ProductUrlKeysPanel.js +0 -215
- package/dist/admin/components/ProductUrlKeysPanel.js.map +0 -1
- package/dist/admin/components/ProductsBulkEditDialog.d.ts.map +0 -1
- package/dist/admin/components/ProductsBulkEditDialog.js.map +0 -1
- package/dist/admin/components/ScopedDialogParts.d.ts +0 -23
- package/dist/admin/components/ScopedDialogParts.d.ts.map +0 -1
- package/dist/admin/components/ScopedDialogParts.js +0 -16
- package/dist/admin/components/ScopedDialogParts.js.map +0 -1
- package/dist/admin/index.d.ts.map +0 -1
- package/dist/admin/index.js.map +0 -1
- package/dist/admin/lib/attribute-scope.d.ts.map +0 -1
- package/dist/admin/lib/attribute-scope.js.map +0 -1
- package/dist/admin/lib/bulk-operation-log-text.d.ts.map +0 -1
- package/dist/admin/lib/bulk-operation-log-text.js.map +0 -1
- package/dist/admin/lib/media-scopes.d.ts +0 -41
- package/dist/admin/lib/media-scopes.d.ts.map +0 -1
- package/dist/admin/lib/media-scopes.js +0 -66
- package/dist/admin/lib/media-scopes.js.map +0 -1
- package/dist/admin/lib/product-labels.d.ts.map +0 -1
- package/dist/admin/lib/product-labels.js.map +0 -1
- package/dist/admin/lib/product-scope-drafts.d.ts +0 -77
- package/dist/admin/lib/product-scope-drafts.d.ts.map +0 -1
- package/dist/admin/lib/product-scope-drafts.js +0 -133
- package/dist/admin/lib/product-scope-drafts.js.map +0 -1
- package/dist/admin/lib/product-scopes-api.d.ts.map +0 -1
- package/dist/admin/lib/product-scopes-api.js.map +0 -1
- package/dist/admin/lib/product-url-keys-api.d.ts.map +0 -1
- package/dist/admin/lib/product-url-keys-api.js.map +0 -1
- package/dist/admin/lib/resolve-product-selection.d.ts.map +0 -1
- package/dist/admin/lib/resolve-product-selection.js.map +0 -1
- package/dist/admin/lib/scope-overview.d.ts.map +0 -1
- package/dist/admin/lib/scope-overview.js.map +0 -1
- package/dist/admin/pages/AttachmentTypesPage.d.ts.map +0 -1
- package/dist/admin/pages/AttachmentTypesPage.js.map +0 -1
- package/dist/admin/pages/AttributeSetsPage.d.ts.map +0 -1
- package/dist/admin/pages/AttributeSetsPage.js.map +0 -1
- package/dist/admin/pages/AttributesManager.d.ts.map +0 -1
- package/dist/admin/pages/AttributesManager.js.map +0 -1
- package/dist/admin/pages/BulkOperationDetailPage.d.ts.map +0 -1
- package/dist/admin/pages/BulkOperationDetailPage.js.map +0 -1
- package/dist/admin/pages/BulkOperationsPage.d.ts.map +0 -1
- package/dist/admin/pages/BulkOperationsPage.js.map +0 -1
- package/dist/admin/pages/CategoriesTree.d.ts.map +0 -1
- package/dist/admin/pages/CategoriesTree.js.map +0 -1
- package/dist/admin/pages/CategoryContentPage.d.ts.map +0 -1
- package/dist/admin/pages/CategoryContentPage.js.map +0 -1
- package/dist/admin/pages/ProductEditor.d.ts.map +0 -1
- package/dist/admin/pages/ProductEditor.js.map +0 -1
- package/dist/admin/pages/ProductsList.d.ts.map +0 -1
- package/dist/admin/pages/ProductsList.js.map +0 -1
- package/dist/backend/admin-search-provider.d.ts.map +0 -1
- package/dist/backend/admin-search-provider.js.map +0 -1
- package/dist/backend/commands/attribute-commands.d.ts.map +0 -1
- package/dist/backend/commands/attribute-commands.js.map +0 -1
- package/dist/backend/demo/reset.d.ts.map +0 -1
- package/dist/backend/demo/reset.js.map +0 -1
- package/dist/backend/demo/rows.d.ts.map +0 -1
- package/dist/backend/demo/rows.js.map +0 -1
- package/dist/backend/demo/seed.d.ts.map +0 -1
- package/dist/backend/demo/seed.js.map +0 -1
- package/dist/backend/entities/attachment-type.entity.d.ts.map +0 -1
- package/dist/backend/entities/attachment-type.entity.js.map +0 -1
- package/dist/backend/entities/attribute-set-attribute.entity.d.ts.map +0 -1
- package/dist/backend/entities/attribute-set-attribute.entity.js.map +0 -1
- package/dist/backend/entities/attribute-set.entity.d.ts.map +0 -1
- package/dist/backend/entities/attribute-set.entity.js.map +0 -1
- package/dist/backend/entities/bulk-operation.entity.d.ts.map +0 -1
- package/dist/backend/entities/bulk-operation.entity.js.map +0 -1
- package/dist/backend/entities/bundle-slot-option.entity.d.ts.map +0 -1
- package/dist/backend/entities/bundle-slot-option.entity.js.map +0 -1
- package/dist/backend/entities/bundle-slot.entity.d.ts.map +0 -1
- package/dist/backend/entities/bundle-slot.entity.js.map +0 -1
- package/dist/backend/entities/category.entity.d.ts.map +0 -1
- package/dist/backend/entities/category.entity.js.map +0 -1
- package/dist/backend/entities/gallery-item-channel-hidden.entity.d.ts +0 -14
- package/dist/backend/entities/gallery-item-channel-hidden.entity.d.ts.map +0 -1
- package/dist/backend/entities/gallery-item-channel-hidden.entity.js +0 -42
- package/dist/backend/entities/gallery-item-channel-hidden.entity.js.map +0 -1
- package/dist/backend/entities/gallery-item-channel-label.entity.d.ts +0 -18
- package/dist/backend/entities/gallery-item-channel-label.entity.d.ts.map +0 -1
- package/dist/backend/entities/gallery-item-channel-label.entity.js +0 -49
- package/dist/backend/entities/gallery-item-channel-label.entity.js.map +0 -1
- package/dist/backend/entities/gallery-item-label.entity.d.ts.map +0 -1
- package/dist/backend/entities/gallery-item-label.entity.js.map +0 -1
- package/dist/backend/entities/gallery-item.entity.d.ts.map +0 -1
- package/dist/backend/entities/gallery-item.entity.js.map +0 -1
- package/dist/backend/entities/grouped-item.entity.d.ts.map +0 -1
- package/dist/backend/entities/grouped-item.entity.js.map +0 -1
- package/dist/backend/entities/product-attachment-channel-hidden.entity.d.ts +0 -13
- package/dist/backend/entities/product-attachment-channel-hidden.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-attachment-channel-hidden.entity.js +0 -41
- package/dist/backend/entities/product-attachment-channel-hidden.entity.js.map +0 -1
- package/dist/backend/entities/product-attachment.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-attachment.entity.js.map +0 -1
- package/dist/backend/entities/product-attribute.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-attribute.entity.js.map +0 -1
- package/dist/backend/entities/product-channel-language-scope.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-channel-language-scope.entity.js.map +0 -1
- package/dist/backend/entities/product-channel-scope.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-channel-scope.entity.js.map +0 -1
- package/dist/backend/entities/product-editor-preference.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-editor-preference.entity.js.map +0 -1
- package/dist/backend/entities/product-link.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-link.entity.js.map +0 -1
- package/dist/backend/entities/product-list-saved-view.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-list-saved-view.entity.js.map +0 -1
- package/dist/backend/entities/product-packaging-unit.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-packaging-unit.entity.js.map +0 -1
- package/dist/backend/entities/product-url-key.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-url-key.entity.js.map +0 -1
- package/dist/backend/entities/product-url-redirect.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-url-redirect.entity.js.map +0 -1
- package/dist/backend/entities/product-value-override.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-value-override.entity.js.map +0 -1
- package/dist/backend/entities/product-variant.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-variant.entity.js.map +0 -1
- package/dist/backend/entities/product.entity.d.ts.map +0 -1
- package/dist/backend/entities/product.entity.js.map +0 -1
- package/dist/backend/index.d.ts.map +0 -1
- package/dist/backend/index.js.map +0 -1
- package/dist/backend/plugin.d.ts.map +0 -1
- package/dist/backend/plugin.js.map +0 -1
- package/dist/backend/prompt-tools.d.ts.map +0 -1
- package/dist/backend/prompt-tools.js.map +0 -1
- package/dist/backend/routes.admin.d.ts.map +0 -1
- package/dist/backend/routes.admin.js.map +0 -1
- package/dist/backend/routes.admin.url-keys.d.ts.map +0 -1
- package/dist/backend/routes.admin.url-keys.js.map +0 -1
- package/dist/backend/routes.api-key.d.ts.map +0 -1
- package/dist/backend/routes.api-key.js.map +0 -1
- package/dist/backend/routes.external.d.ts.map +0 -1
- package/dist/backend/routes.external.js.map +0 -1
- package/dist/backend/routes.public.d.ts.map +0 -1
- package/dist/backend/routes.public.js.map +0 -1
- package/dist/backend/routes.public.url-keys.d.ts.map +0 -1
- package/dist/backend/routes.public.url-keys.js.map +0 -1
- package/dist/backend/saved-view-actor.d.ts.map +0 -1
- package/dist/backend/saved-view-actor.js.map +0 -1
- package/dist/backend/services/asset-references.d.ts.map +0 -1
- package/dist/backend/services/asset-references.js.map +0 -1
- package/dist/backend/services/attachment-packaging-scopes.d.ts.map +0 -1
- package/dist/backend/services/attachment-packaging-scopes.js.map +0 -1
- package/dist/backend/services/attachment.service.d.ts.map +0 -1
- package/dist/backend/services/attachment.service.js.map +0 -1
- package/dist/backend/services/attribute-option-validator.d.ts.map +0 -1
- package/dist/backend/services/attribute-option-validator.js.map +0 -1
- package/dist/backend/services/attribute-scope-preview.d.ts.map +0 -1
- package/dist/backend/services/attribute-scope-preview.js.map +0 -1
- package/dist/backend/services/attribute-set-validations.d.ts.map +0 -1
- package/dist/backend/services/attribute-set-validations.js.map +0 -1
- package/dist/backend/services/attribute-set.service.d.ts.map +0 -1
- package/dist/backend/services/attribute-set.service.js.map +0 -1
- package/dist/backend/services/attribute-type-mapping.d.ts.map +0 -1
- package/dist/backend/services/attribute-type-mapping.js.map +0 -1
- package/dist/backend/services/attribute-value-key.service.d.ts.map +0 -1
- package/dist/backend/services/attribute-value-key.service.js.map +0 -1
- package/dist/backend/services/audit-references.d.ts.map +0 -1
- package/dist/backend/services/audit-references.js.map +0 -1
- package/dist/backend/services/bulk-operation-queue.d.ts.map +0 -1
- package/dist/backend/services/bulk-operation-queue.js.map +0 -1
- package/dist/backend/services/bulk-operation.service.d.ts.map +0 -1
- package/dist/backend/services/bulk-operation.service.js.map +0 -1
- package/dist/backend/services/bundle.service.d.ts.map +0 -1
- package/dist/backend/services/bundle.service.js.map +0 -1
- package/dist/backend/services/catalog-admin-search.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-admin-search.service.js.map +0 -1
- package/dist/backend/services/catalog-admin.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-admin.service.js.map +0 -1
- package/dist/backend/services/catalog-attribute-read.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-attribute-read.service.js.map +0 -1
- package/dist/backend/services/catalog-bulk-import.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-bulk-import.service.js.map +0 -1
- package/dist/backend/services/catalog-bulk-update.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-bulk-update.service.js.map +0 -1
- package/dist/backend/services/catalog-category-read.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-category-read.service.js.map +0 -1
- package/dist/backend/services/catalog-org-price-decorator.d.ts.map +0 -1
- package/dist/backend/services/catalog-org-price-decorator.js.map +0 -1
- package/dist/backend/services/catalog-product-filter.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-product-filter.service.js.map +0 -1
- package/dist/backend/services/catalog-product-read.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-product-read.service.js.map +0 -1
- package/dist/backend/services/catalog-query.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-query.service.js.map +0 -1
- package/dist/backend/services/catalog-quick-search.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-quick-search.service.js.map +0 -1
- package/dist/backend/services/catalog-write-ports.d.ts.map +0 -1
- package/dist/backend/services/catalog-write-ports.js.map +0 -1
- package/dist/backend/services/category-admin.service.d.ts.map +0 -1
- package/dist/backend/services/category-admin.service.js.map +0 -1
- package/dist/backend/services/channel-url-facts.d.ts.map +0 -1
- package/dist/backend/services/channel-url-facts.js.map +0 -1
- package/dist/backend/services/effective-value.sql.d.ts.map +0 -1
- package/dist/backend/services/effective-value.sql.js.map +0 -1
- package/dist/backend/services/gallery-scopes.d.ts.map +0 -1
- package/dist/backend/services/gallery-scopes.js.map +0 -1
- package/dist/backend/services/gallery.service.d.ts.map +0 -1
- package/dist/backend/services/gallery.service.js.map +0 -1
- package/dist/backend/services/grouped.service.d.ts.map +0 -1
- package/dist/backend/services/grouped.service.js.map +0 -1
- package/dist/backend/services/label-resolver.d.ts.map +0 -1
- package/dist/backend/services/label-resolver.js.map +0 -1
- package/dist/backend/services/linkable-asset.d.ts.map +0 -1
- package/dist/backend/services/linkable-asset.js.map +0 -1
- package/dist/backend/services/packaging-unit.service.d.ts.map +0 -1
- package/dist/backend/services/packaging-unit.service.js.map +0 -1
- package/dist/backend/services/primary-asset-url.d.ts.map +0 -1
- package/dist/backend/services/primary-asset-url.js.map +0 -1
- package/dist/backend/services/product-availability.service.d.ts.map +0 -1
- package/dist/backend/services/product-availability.service.js.map +0 -1
- package/dist/backend/services/product-availability.sql.d.ts.map +0 -1
- package/dist/backend/services/product-availability.sql.js.map +0 -1
- package/dist/backend/services/product-editor-preferences.service.d.ts.map +0 -1
- package/dist/backend/services/product-editor-preferences.service.js.map +0 -1
- package/dist/backend/services/product-link.service.d.ts.map +0 -1
- package/dist/backend/services/product-link.service.js.map +0 -1
- package/dist/backend/services/product-list-view-service.d.ts.map +0 -1
- package/dist/backend/services/product-list-view-service.js.map +0 -1
- package/dist/backend/services/product-overrides.service.d.ts +0 -84
- package/dist/backend/services/product-overrides.service.d.ts.map +0 -1
- package/dist/backend/services/product-overrides.service.js +0 -211
- package/dist/backend/services/product-overrides.service.js.map +0 -1
- package/dist/backend/services/product-page-revalidation.d.ts.map +0 -1
- package/dist/backend/services/product-page-revalidation.js.map +0 -1
- package/dist/backend/services/product-scope-context.service.d.ts +0 -36
- package/dist/backend/services/product-scope-context.service.d.ts.map +0 -1
- package/dist/backend/services/product-scope-context.service.js +0 -107
- package/dist/backend/services/product-scope-context.service.js.map +0 -1
- package/dist/backend/services/product-scopes.service.d.ts.map +0 -1
- package/dist/backend/services/product-scopes.service.js.map +0 -1
- package/dist/backend/services/product-summary-text.d.ts.map +0 -1
- package/dist/backend/services/product-summary-text.js.map +0 -1
- package/dist/backend/services/product-type-validations.d.ts.map +0 -1
- package/dist/backend/services/product-type-validations.js.map +0 -1
- package/dist/backend/services/product-value-resolver.service.d.ts.map +0 -1
- package/dist/backend/services/product-value-resolver.service.js.map +0 -1
- package/dist/backend/services/publication-window-sweep.d.ts.map +0 -1
- package/dist/backend/services/publication-window-sweep.js.map +0 -1
- package/dist/backend/services/scope-completeness.d.ts.map +0 -1
- package/dist/backend/services/scope-completeness.js.map +0 -1
- package/dist/backend/services/scope-overview.service.d.ts.map +0 -1
- package/dist/backend/services/scope-overview.service.js.map +0 -1
- package/dist/backend/services/sql-id-arrays.d.ts.map +0 -1
- package/dist/backend/services/sql-id-arrays.js.map +0 -1
- package/dist/backend/services/storefront-value-overrides.d.ts.map +0 -1
- package/dist/backend/services/storefront-value-overrides.js.map +0 -1
- package/dist/backend/services/system-attribute-scopes.d.ts.map +0 -1
- package/dist/backend/services/system-attribute-scopes.js.map +0 -1
- package/dist/backend/services/url-key-resolution.service.d.ts.map +0 -1
- package/dist/backend/services/url-key-resolution.service.js.map +0 -1
- package/dist/backend/services/url-key.service.d.ts.map +0 -1
- package/dist/backend/services/url-key.service.js.map +0 -1
- package/dist/backend/services/viewer-organization.d.ts.map +0 -1
- package/dist/backend/services/viewer-organization.js.map +0 -1
- package/dist/manifest.d.ts.map +0 -1
- package/dist/manifest.js.map +0 -1
- package/dist/migrations/20260429T064146_catalog_attribute_sets_init.d.ts.map +0 -1
- package/dist/migrations/20260429T064146_catalog_attribute_sets_init.js.map +0 -1
- package/dist/migrations/20260429T070004_catalog_product_attribute_extensions.d.ts.map +0 -1
- package/dist/migrations/20260429T070004_catalog_product_attribute_extensions.js.map +0 -1
- package/dist/migrations/20260429T102322_catalog_product_type_and_virtual_fields.d.ts.map +0 -1
- package/dist/migrations/20260429T102322_catalog_product_type_and_virtual_fields.js.map +0 -1
- package/dist/migrations/20260429T111839_catalog_gallery_items_and_labels.d.ts.map +0 -1
- package/dist/migrations/20260429T111839_catalog_gallery_items_and_labels.js.map +0 -1
- package/dist/migrations/20260429T112543_catalog_product_attachments.d.ts.map +0 -1
- package/dist/migrations/20260429T112543_catalog_product_attachments.js.map +0 -1
- package/dist/migrations/20260429T123726_catalog_product_links.d.ts.map +0 -1
- package/dist/migrations/20260429T123726_catalog_product_links.js.map +0 -1
- package/dist/migrations/20260429T130803_catalog_grouped_and_bundle.d.ts.map +0 -1
- package/dist/migrations/20260429T130803_catalog_grouped_and_bundle.js.map +0 -1
- package/dist/migrations/20260501T185835_catalog_product_attribute_is_comparable.d.ts.map +0 -1
- package/dist/migrations/20260501T185835_catalog_product_attribute_is_comparable.js.map +0 -1
- package/dist/migrations/20260505T060113_catalog_attribute_options_and_flags.d.ts.map +0 -1
- package/dist/migrations/20260505T060113_catalog_attribute_options_and_flags.js.map +0 -1
- package/dist/migrations/20260515T082629_catalog_attribute_mass_editable.d.ts.map +0 -1
- package/dist/migrations/20260515T082629_catalog_attribute_mass_editable.js.map +0 -1
- package/dist/migrations/20260526T124736_catalog_product_status_inactive.d.ts.map +0 -1
- package/dist/migrations/20260526T124736_catalog_product_status_inactive.js.map +0 -1
- package/dist/migrations/20260611T140346_catalog_product_value_overrides_init.d.ts.map +0 -1
- package/dist/migrations/20260611T140346_catalog_product_value_overrides_init.js.map +0 -1
- package/dist/migrations/20260611T140400_catalog_attribute_quick_searchable.d.ts.map +0 -1
- package/dist/migrations/20260611T140400_catalog_attribute_quick_searchable.js.map +0 -1
- package/dist/migrations/20260611T140407_catalog_bulk_operations.d.ts.map +0 -1
- package/dist/migrations/20260611T140407_catalog_bulk_operations.js.map +0 -1
- package/dist/migrations/20260611T140408_catalog_bulk_operation_logs.d.ts.map +0 -1
- package/dist/migrations/20260611T140408_catalog_bulk_operation_logs.js.map +0 -1
- package/dist/migrations/20260611T140412_catalog_product_packaging_units.d.ts.map +0 -1
- package/dist/migrations/20260611T140412_catalog_product_packaging_units.js.map +0 -1
- package/dist/migrations/20260718T060659_catalog_bulk_operation_revert_state.d.ts.map +0 -1
- package/dist/migrations/20260718T060659_catalog_bulk_operation_revert_state.js.map +0 -1
- package/dist/migrations/20260718T200343_catalog_category_custom_field_values.d.ts.map +0 -1
- package/dist/migrations/20260718T200343_catalog_category_custom_field_values.js.map +0 -1
- package/dist/migrations/20260723T230401_catalog_attributes_on_custom_fields.d.ts.map +0 -1
- package/dist/migrations/20260723T230401_catalog_attributes_on_custom_fields.js.map +0 -1
- package/dist/migrations/20260804T152604_catalog_widen_product_sku.d.ts.map +0 -1
- package/dist/migrations/20260804T152604_catalog_widen_product_sku.js.map +0 -1
- package/dist/migrations/20260804T160244_catalog_category_activation.d.ts.map +0 -1
- package/dist/migrations/20260804T160244_catalog_category_activation.js.map +0 -1
- package/dist/migrations/20260912T094557_catalog_sales_channel_products.d.ts.map +0 -1
- package/dist/migrations/20260912T094557_catalog_sales_channel_products.js.map +0 -1
- package/dist/migrations/20260912T094623_catalog_sales_channel_categories.d.ts.map +0 -1
- package/dist/migrations/20260912T094623_catalog_sales_channel_categories.js.map +0 -1
- package/dist/migrations/20260925T125527_catalog_inventory_columns.d.ts.map +0 -1
- package/dist/migrations/20260925T125527_catalog_inventory_columns.js.map +0 -1
- package/dist/migrations/20261008T080839_catalog_product_attribute_is_price_rule.d.ts.map +0 -1
- package/dist/migrations/20261008T080839_catalog_product_attribute_is_price_rule.js.map +0 -1
- package/dist/migrations/20261008T092714_catalog_category_content.d.ts.map +0 -1
- package/dist/migrations/20261008T092714_catalog_category_content.js.map +0 -1
- package/dist/migrations/20261014T170531_catalog_product_list_saved_views.d.ts.map +0 -1
- package/dist/migrations/20261014T170531_catalog_product_list_saved_views.js.map +0 -1
- package/dist/migrations/20261016T082008_catalog_order_rules.d.ts.map +0 -1
- package/dist/migrations/20261016T082008_catalog_order_rules.js.map +0 -1
- package/dist/migrations/20261022T035133_catalog_product_scopes.d.ts.map +0 -1
- package/dist/migrations/20261022T035133_catalog_product_scopes.js.map +0 -1
- package/dist/migrations/20261022T054223_catalog_product_url_keys.d.ts.map +0 -1
- package/dist/migrations/20261022T054223_catalog_product_url_keys.js.map +0 -1
- package/dist/migrations/20261022T111811_catalog_price_fields_removed.d.ts.map +0 -1
- package/dist/migrations/20261022T111811_catalog_price_fields_removed.js.map +0 -1
- package/dist/migrations/20261022T182523_catalog_admin_name_keys.d.ts.map +0 -1
- package/dist/migrations/20261022T182523_catalog_admin_name_keys.js.map +0 -1
- package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.d.ts.map +0 -1
- package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.js.map +0 -1
- package/dist/migrations/20261026T033453_catalog_product_media_scopes.d.ts.map +0 -1
- package/dist/migrations/20261026T033453_catalog_product_media_scopes.js.map +0 -1
- package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.d.ts.map +0 -1
- package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.js.map +0 -1
- package/dist/migrations/index.d.ts.map +0 -1
- package/dist/migrations/index.js.map +0 -1
- package/dist/ports/index.d.ts.map +0 -1
- package/dist/ports/index.js.map +0 -1
|
@@ -0,0 +1,320 @@
|
|
|
1
|
+
import { randomUUID } from 'node:crypto';
|
|
2
|
+
import { ERROR_CODES, PRODUCT_SCOPED_WRITE_CELLS_MAX, integrationWritableField, scopedValueChangesSchema, } from '@endora-commerce/contracts';
|
|
3
|
+
import { HttpError } from '@endora-commerce/platform/http';
|
|
4
|
+
import { auditStates, ownValues, planScopedSave, withoutUnchangedCells, writeScopedSave } from './scoped-values-save.service.js';
|
|
5
|
+
import { bumpScopeVersion, loadScopedState, resolveRequestScope } from './scoped-values-state.js';
|
|
6
|
+
const SOURCE_SHAPE = /^[a-z][a-z0-9_]{1,63}$/;
|
|
7
|
+
const scopeKey = (scope) => scope.level === 'global'
|
|
8
|
+
? 'G'
|
|
9
|
+
: scope.level === 'channel'
|
|
10
|
+
? `C:${scope.channelId}`
|
|
11
|
+
: `CL:${scope.channelId}/${scope.languageCode.toLowerCase()}`;
|
|
12
|
+
/**
|
|
13
|
+
* The call-level checks of the connector port (R13a, R21): a registered source module, at most
|
|
14
|
+
* {@link PRODUCT_SCOPED_WRITE_CELLS_MAX} cells, no (field, scope) twice. Throws
|
|
15
|
+
* `422 VALIDATION_FAILED` naming `source` or `cells`; nothing is written.
|
|
16
|
+
*/
|
|
17
|
+
export function assertIntegrationCall(cells, source, isRegisteredModule) {
|
|
18
|
+
if (!SOURCE_SHAPE.test(source) || !isRegisteredModule(source)) {
|
|
19
|
+
throw new HttpError(422, ERROR_CODES.VALIDATION_FAILED, 'The source is not a registered module.', { field: 'source' });
|
|
20
|
+
}
|
|
21
|
+
if (cells.length > PRODUCT_SCOPED_WRITE_CELLS_MAX) {
|
|
22
|
+
throw new HttpError(422, ERROR_CODES.VALIDATION_FAILED, `At most ${PRODUCT_SCOPED_WRITE_CELLS_MAX} cells per call.`, {
|
|
23
|
+
field: 'cells',
|
|
24
|
+
});
|
|
25
|
+
}
|
|
26
|
+
// C2/C3 security review warn 2 — the op's shape, at runtime: an untyped caller's malformed op
|
|
27
|
+
// is refused here and never read as an inherit (which would delete an override).
|
|
28
|
+
const malformed = cells.findIndex((cell) => !isWriteOp(cell.op));
|
|
29
|
+
if (malformed !== -1) {
|
|
30
|
+
throw new HttpError(422, ERROR_CODES.VALIDATION_FAILED, 'A cell carries no valid write operation.', {
|
|
31
|
+
field: 'cells',
|
|
32
|
+
index: malformed,
|
|
33
|
+
});
|
|
34
|
+
}
|
|
35
|
+
const duplicate = firstDuplicateCell(cells);
|
|
36
|
+
if (duplicate !== null) {
|
|
37
|
+
throw new HttpError(422, ERROR_CODES.VALIDATION_FAILED, 'The same (field, scope) cell appears twice.', {
|
|
38
|
+
field: 'cells',
|
|
39
|
+
index: duplicate,
|
|
40
|
+
});
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
/** Exactly `{ op: 'set', value }`, `{ op: 'empty' }` or `{ op: 'inherit' }` — no other keys. */
|
|
44
|
+
function isWriteOp(op) {
|
|
45
|
+
if (typeof op !== 'object' || op === null || Array.isArray(op))
|
|
46
|
+
return false;
|
|
47
|
+
const keys = Object.keys(op).sort().join(',');
|
|
48
|
+
const kind = op.op;
|
|
49
|
+
if (kind === 'set')
|
|
50
|
+
return keys === 'op,value' && op.value !== undefined;
|
|
51
|
+
return (kind === 'empty' || kind === 'inherit') && keys === 'op';
|
|
52
|
+
}
|
|
53
|
+
/** The index of the first cell whose (field, scope) an earlier cell already named, else `null`. */
|
|
54
|
+
export function firstDuplicateCell(cells) {
|
|
55
|
+
const seen = new Set();
|
|
56
|
+
for (const [index, cell] of cells.entries()) {
|
|
57
|
+
const key = `${cell.field}@${scopeKey(cell.scope)}`;
|
|
58
|
+
if (seen.has(key))
|
|
59
|
+
return index;
|
|
60
|
+
seen.add(key);
|
|
61
|
+
}
|
|
62
|
+
return null;
|
|
63
|
+
}
|
|
64
|
+
const raw = (op) => {
|
|
65
|
+
if (op.op === 'set')
|
|
66
|
+
return op.value;
|
|
67
|
+
if (op.op === 'empty')
|
|
68
|
+
return null;
|
|
69
|
+
if (op.op === 'inherit')
|
|
70
|
+
return { inherit: true };
|
|
71
|
+
// Fail closed: an op that is none of the three never becomes an inherit.
|
|
72
|
+
throw new Error(`scoped import: not a write operation: ${String(op.op)}`);
|
|
73
|
+
};
|
|
74
|
+
/** One allowlisted cell as the save's `changes` body, or `null` when the path names no such field. */
|
|
75
|
+
export function cellChanges(field, op) {
|
|
76
|
+
const value = raw(op);
|
|
77
|
+
if (field === 'name' ||
|
|
78
|
+
field === 'description' ||
|
|
79
|
+
field === 'status' ||
|
|
80
|
+
field === 'window' ||
|
|
81
|
+
field === 'urlKey' ||
|
|
82
|
+
field === 'minOrderQuantity' ||
|
|
83
|
+
field === 'returnable') {
|
|
84
|
+
return { [field]: value };
|
|
85
|
+
}
|
|
86
|
+
const attribute = /^attribute:([a-z0-9_]{1,64})$/.exec(field);
|
|
87
|
+
if (attribute)
|
|
88
|
+
return { attributes: { [attribute[1]]: value } };
|
|
89
|
+
const gallery = /^gallery:([0-9a-f-]{36}):altText$/.exec(field);
|
|
90
|
+
if (gallery)
|
|
91
|
+
return { gallery: { items: { [gallery[1]]: { altText: value } } } };
|
|
92
|
+
const attachment = /^attachment:([0-9a-f-]{36}):(name|description)$/.exec(field);
|
|
93
|
+
if (attachment)
|
|
94
|
+
return { attachments: { [attachment[1]]: { [attachment[2]]: value } } };
|
|
95
|
+
const unit = /^packagingUnit:([0-9a-f-]{36}):name$/.exec(field);
|
|
96
|
+
if (unit)
|
|
97
|
+
return { packagingUnits: { [unit[1]]: { name: value } } };
|
|
98
|
+
return null;
|
|
99
|
+
}
|
|
100
|
+
/** Deep-merges one cell's `changes` into a scope's body (the paths never collide: duplicates are refused first). */
|
|
101
|
+
function mergeChanges(target, source) {
|
|
102
|
+
for (const [key, value] of Object.entries(source)) {
|
|
103
|
+
const existing = target[key];
|
|
104
|
+
const isObject = (v) => typeof v === 'object' && v !== null && !Array.isArray(v) && !Object.hasOwn(v, 'inherit');
|
|
105
|
+
if (isObject(existing) && isObject(value) && !['window', 'audience'].includes(key))
|
|
106
|
+
mergeChanges(existing, value);
|
|
107
|
+
else
|
|
108
|
+
target[key] = value;
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
/** A refusal of the save's planner, as the cell's code. */
|
|
112
|
+
function refusalOf(error) {
|
|
113
|
+
if (error instanceof HttpError) {
|
|
114
|
+
if (error.code === ERROR_CODES.FIELD_NOT_AT_SCOPE)
|
|
115
|
+
return 'FIELD_NOT_AT_SCOPE';
|
|
116
|
+
if (error.code === ERROR_CODES.SCOPE_INVALID)
|
|
117
|
+
return 'SCOPE_INVALID';
|
|
118
|
+
if (error.code === ERROR_CODES.GLOBAL_ONLY_FIELD)
|
|
119
|
+
return 'not_supported';
|
|
120
|
+
if (error.code === ERROR_CODES.SCOPED_VALUE_INVALID) {
|
|
121
|
+
const reason = error.details?.fields?.[0]?.reason;
|
|
122
|
+
if (reason === 'required_empty' ||
|
|
123
|
+
reason === 'not_emptyable' ||
|
|
124
|
+
reason === 'inherit_at_global' ||
|
|
125
|
+
reason === 'subject_not_found' ||
|
|
126
|
+
reason === 'not_supported') {
|
|
127
|
+
return reason;
|
|
128
|
+
}
|
|
129
|
+
return 'invalid';
|
|
130
|
+
}
|
|
131
|
+
if (error.code === ERROR_CODES.VALIDATION_FAILED)
|
|
132
|
+
return 'invalid';
|
|
133
|
+
}
|
|
134
|
+
throw error;
|
|
135
|
+
}
|
|
136
|
+
/**
|
|
137
|
+
* Pure over the product's state: each cell checked alone (allowlist, scope, the save's planner),
|
|
138
|
+
* the accepted ones planned per scope. `trustedChanges` (the products file's Global columns)
|
|
139
|
+
* are added to the Global plan without the allowlist.
|
|
140
|
+
*/
|
|
141
|
+
export function planIntegrationCells(state, cells, trustedGlobal,
|
|
142
|
+
/**
|
|
143
|
+
* `connector` — the PIM port's allowlist (R13a); `import` — the products file, which also writes
|
|
144
|
+
* `minOrderQuantity` and `returnable` (coordinator decision, S1 block 2: the CSV grammar covers
|
|
145
|
+
* every scoped product value; the connector exclusions apply to the PIM port only).
|
|
146
|
+
*/
|
|
147
|
+
path = 'connector') {
|
|
148
|
+
const refused = [];
|
|
149
|
+
const byScope = new Map();
|
|
150
|
+
const urlKeyCells = [];
|
|
151
|
+
let accepted = 0;
|
|
152
|
+
const bodyAt = (scope) => {
|
|
153
|
+
const key = scopeKey(scope);
|
|
154
|
+
let entry = byScope.get(key);
|
|
155
|
+
if (!entry) {
|
|
156
|
+
entry = { scope, changes: {} };
|
|
157
|
+
byScope.set(key, entry);
|
|
158
|
+
}
|
|
159
|
+
return entry;
|
|
160
|
+
};
|
|
161
|
+
if (trustedGlobal && Object.keys(trustedGlobal).length > 0)
|
|
162
|
+
mergeChanges(bodyAt({ level: 'global' }).changes, trustedGlobal);
|
|
163
|
+
for (const [index, cell] of cells.entries()) {
|
|
164
|
+
const refuse = (code) => refused.push({ index, scope: cell.scope, field: cell.field, code });
|
|
165
|
+
const writable = integrationWritableField(cell.field) || (path === 'import' && (cell.field === 'minOrderQuantity' || cell.field === 'returnable'));
|
|
166
|
+
const changes = writable ? cellChanges(cell.field, cell.op) : null;
|
|
167
|
+
if (changes === null) {
|
|
168
|
+
refuse('not_supported');
|
|
169
|
+
continue;
|
|
170
|
+
}
|
|
171
|
+
let scope;
|
|
172
|
+
try {
|
|
173
|
+
scope = resolveRequestScope(state.members, cell.scope.level === 'global'
|
|
174
|
+
? {}
|
|
175
|
+
: cell.scope.level === 'channel'
|
|
176
|
+
? { channelId: cell.scope.channelId }
|
|
177
|
+
: { channelId: cell.scope.channelId, languageCode: cell.scope.languageCode });
|
|
178
|
+
}
|
|
179
|
+
catch (error) {
|
|
180
|
+
refuse(refusalOf(error));
|
|
181
|
+
continue;
|
|
182
|
+
}
|
|
183
|
+
const parsed = scopedValueChangesSchema.safeParse(changes);
|
|
184
|
+
if (!parsed.success) {
|
|
185
|
+
refuse('invalid');
|
|
186
|
+
continue;
|
|
187
|
+
}
|
|
188
|
+
try {
|
|
189
|
+
// `""` is "no change" in the write encoding: such a cell plans nothing and counts nowhere.
|
|
190
|
+
if (planScopedSave(state, scope, parsed.data).cells.length === 0)
|
|
191
|
+
continue;
|
|
192
|
+
// A stored `''` Global description is "no description" (S2 block 2 review): re-importing
|
|
193
|
+
// `NULL` there writes nothing.
|
|
194
|
+
if (cell.field === 'description' && scope.level === 'global' && cell.op.op === 'empty' && (state.product.description ?? '') === '') {
|
|
195
|
+
continue;
|
|
196
|
+
}
|
|
197
|
+
}
|
|
198
|
+
catch (error) {
|
|
199
|
+
refuse(refusalOf(error));
|
|
200
|
+
continue;
|
|
201
|
+
}
|
|
202
|
+
if (cell.field === 'urlKey') {
|
|
203
|
+
urlKeyCells.push({ index, scope, op: cell.op });
|
|
204
|
+
continue;
|
|
205
|
+
}
|
|
206
|
+
mergeChanges(bodyAt(scope).changes, parsed.data);
|
|
207
|
+
accepted += 1;
|
|
208
|
+
}
|
|
209
|
+
const plans = [...byScope.values()]
|
|
210
|
+
.map(({ scope, changes }) => planScopedSave(state, scope, scopedValueChangesSchema.parse(changes)))
|
|
211
|
+
.filter((plan) => plan.cells.length > 0);
|
|
212
|
+
return { plans, urlKeyCells, refused, accepted };
|
|
213
|
+
}
|
|
214
|
+
/** Thrown inside the Command when nothing applies, so the version bump rolls back with it. */
|
|
215
|
+
class NothingApplied extends Error {
|
|
216
|
+
result;
|
|
217
|
+
constructor(result) {
|
|
218
|
+
super('nothing applied');
|
|
219
|
+
this.result = result;
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
/**
|
|
223
|
+
* The Command `product.scoped_values.import` for one product: the version bump first (R7, an
|
|
224
|
+
* unconditional `+ 1` — an integration holds no version), then the plan, the save's writers per
|
|
225
|
+
* scope, the URL keys in `integration` mode, and one audit entry (`source` and every written cell
|
|
226
|
+
* keyed `field@scope`). A call where nothing applies writes, audits and bumps nothing.
|
|
227
|
+
*/
|
|
228
|
+
export async function runScopedImport(commandBus, deps, productId, cells, options) {
|
|
229
|
+
const command = {
|
|
230
|
+
action: 'product.scoped_values.import',
|
|
231
|
+
objectType: 'product',
|
|
232
|
+
objectId: productId,
|
|
233
|
+
run: async ({ em }) => {
|
|
234
|
+
await bumpScopeVersion(em, productId);
|
|
235
|
+
const state = await loadScopedState(em, productId, deps);
|
|
236
|
+
const planned = planIntegrationCells(state, cells, trustedChangesOf(state, options.extras), options.path ?? 'connector');
|
|
237
|
+
// FR-114 — a cell that writes what the scope already holds is not a change.
|
|
238
|
+
planned.plans = planned.plans.map((plan) => withoutUnchangedCells(state, plan)).filter((plan) => plan.cells.length > 0);
|
|
239
|
+
const audit = { before: {}, after: {} };
|
|
240
|
+
for (const plan of planned.plans) {
|
|
241
|
+
const states = auditStates(plan, ownValues(state, plan));
|
|
242
|
+
Object.assign(audit.before, states.before['cells']);
|
|
243
|
+
Object.assign(audit.after, states.after['cells']);
|
|
244
|
+
await writeScopedSave(em, state, plan);
|
|
245
|
+
}
|
|
246
|
+
const urlKeys = [];
|
|
247
|
+
let urlKeysWritten = 0;
|
|
248
|
+
let urlKeyEffects;
|
|
249
|
+
if (planned.urlKeyCells.length > 0) {
|
|
250
|
+
const writes = planned.urlKeyCells.map((cell) => ({
|
|
251
|
+
scope: cell.scope,
|
|
252
|
+
op: cell.op.op === 'set' ? { op: 'set', key: String(cell.op.value) } : { op: 'inherit' },
|
|
253
|
+
}));
|
|
254
|
+
const effects = await deps.urlKeys().lockAndCheck(em, productId, writes, { mode: 'integration' });
|
|
255
|
+
for (const write of writes) {
|
|
256
|
+
const key = write.op.op === 'set' ? write.op.key.normalize('NFC').toLowerCase() : null;
|
|
257
|
+
const issue = key === null ? undefined : effects.issues.find((candidate) => candidate.key === key);
|
|
258
|
+
urlKeys.push(issue ? { written: false, issue } : { written: true });
|
|
259
|
+
if (!issue && effects.changed)
|
|
260
|
+
urlKeysWritten += 1;
|
|
261
|
+
}
|
|
262
|
+
if (effects.changed)
|
|
263
|
+
urlKeyEffects = { before: effects.before, after: effects.after };
|
|
264
|
+
}
|
|
265
|
+
const changedFields = [...new Set([...planned.plans.flatMap((plan) => plan.changedFields), ...(urlKeysWritten > 0 ? ['urlKeys'] : [])])];
|
|
266
|
+
const result = {
|
|
267
|
+
applied: planned.accepted + urlKeysWritten,
|
|
268
|
+
refused: planned.refused,
|
|
269
|
+
urlKeys,
|
|
270
|
+
changedFields,
|
|
271
|
+
};
|
|
272
|
+
// Nothing written (every cell refused, or each already what the scope holds): roll back.
|
|
273
|
+
if (planned.plans.length === 0 && urlKeysWritten === 0)
|
|
274
|
+
throw new NothingApplied(result);
|
|
275
|
+
return {
|
|
276
|
+
result,
|
|
277
|
+
before: { source: options.source, cells: audit.before, ...(urlKeyEffects ? { urlKey: urlKeyEffects.before } : {}) },
|
|
278
|
+
after: {
|
|
279
|
+
source: options.source,
|
|
280
|
+
cells: audit.after,
|
|
281
|
+
changedFields,
|
|
282
|
+
...(planned.refused.length > 0 ? { refused: planned.refused.length } : {}),
|
|
283
|
+
...(urlKeyEffects ? { urlKey: urlKeyEffects.after } : {}),
|
|
284
|
+
},
|
|
285
|
+
};
|
|
286
|
+
},
|
|
287
|
+
event: ({ changedFields }) => changedFields.length === 0
|
|
288
|
+
? undefined
|
|
289
|
+
: {
|
|
290
|
+
eventName: 'product.updated.v1',
|
|
291
|
+
payload: { eventId: randomUUID(), occurredAt: new Date().toISOString(), productId, changedFields },
|
|
292
|
+
},
|
|
293
|
+
};
|
|
294
|
+
try {
|
|
295
|
+
return await commandBus.run(command);
|
|
296
|
+
}
|
|
297
|
+
catch (error) {
|
|
298
|
+
if (error instanceof NothingApplied)
|
|
299
|
+
return error.result;
|
|
300
|
+
throw error;
|
|
301
|
+
}
|
|
302
|
+
}
|
|
303
|
+
/** The plan of an import without writing (the products import's dry run). */
|
|
304
|
+
export async function planScopedImport(em, deps, productId, cells, extras) {
|
|
305
|
+
const state = await loadScopedState(em, productId, deps);
|
|
306
|
+
const planned = planIntegrationCells(state, cells, trustedChangesOf(state, extras), 'import');
|
|
307
|
+
return {
|
|
308
|
+
applied: planned.accepted + planned.urlKeyCells.length,
|
|
309
|
+
refused: planned.refused,
|
|
310
|
+
urlKeys: planned.urlKeyCells.map(() => ({ written: true })),
|
|
311
|
+
};
|
|
312
|
+
}
|
|
313
|
+
function trustedChangesOf(state, extras) {
|
|
314
|
+
if (extras?.visibility === undefined)
|
|
315
|
+
return undefined;
|
|
316
|
+
return scopedValueChangesSchema.parse({
|
|
317
|
+
audience: { visibility: extras.visibility, allowedOrganizationIds: [...state.product.allowedOrganizationIds] },
|
|
318
|
+
});
|
|
319
|
+
}
|
|
320
|
+
//# sourceMappingURL=scoped-values-import.js.map
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
import type { EntityManager } from '@mikro-orm/postgresql';
|
|
2
|
+
import { type AssetReadPort, type CatalogAttributeView, type CompletenessSummary, type FieldScopeSpec, type LanguageReadPort, type OrganizationDetailsPort, type ScopeRef, type ScopedFieldView, type ScopedRow, type ScopedValuesData } from '@endora-commerce/contracts';
|
|
3
|
+
import type { SalesChannelMembershipPort } from '@endora-commerce/platform/kernel';
|
|
4
|
+
import { type CompletenessFacts } from './scope-completeness.js';
|
|
5
|
+
import { type MemberChannel, type ScopedProductState } from './scoped-values-state.js';
|
|
6
|
+
/**
|
|
7
|
+
* Feature 174 (T036; `contracts/scoped-values-api.md` §2) — `GET …/products/:id/scoped-values`:
|
|
8
|
+
* every scoped field of the product at one scope, with its source, in **one** request per scope
|
|
9
|
+
* switch (FR-109). Orphaned rows never contribute. `seo` is `seo`'s own view at the scope
|
|
10
|
+
* (`seoProductMetaPort.readScoped`, US10), `null` while `seo` is off.
|
|
11
|
+
*/
|
|
12
|
+
/** The camelCase role keys of the API (Principle VI) for the stored labels. */
|
|
13
|
+
export declare const GALLERY_ROLE_KEYS: {
|
|
14
|
+
readonly base_image: "baseImage";
|
|
15
|
+
readonly small_image: "smallImage";
|
|
16
|
+
readonly thumbnail: "thumbnail";
|
|
17
|
+
};
|
|
18
|
+
export interface ScopedValuesReadDeps {
|
|
19
|
+
membership: Pick<SalesChannelMembershipPort, 'listChannelsForEntity'>;
|
|
20
|
+
listAttributes: () => Promise<CatalogAttributeView[]>;
|
|
21
|
+
languages?: Pick<LanguageReadPort, 'list'>;
|
|
22
|
+
assets?: Pick<AssetReadPort, 'findByIds'>;
|
|
23
|
+
organizations?: Pick<OrganizationDetailsPort, 'findByIds'>;
|
|
24
|
+
/**
|
|
25
|
+
* Feature 174 (T123, FR-090, FR-092) — `seo`'s view of the product's metadata at one scope
|
|
26
|
+
* (`seoProductMetaPort.readScoped`), `null` while `seo` is not effectively present. Absent = no
|
|
27
|
+
* SEO block.
|
|
28
|
+
*/
|
|
29
|
+
readSeo?: ReadSeoProductScoped;
|
|
30
|
+
}
|
|
31
|
+
/** `seo`'s five fields at one scope, or `null` while `seo` is off (presence decided by the wiring). */
|
|
32
|
+
export type ReadSeoProductScoped = (productId: string, scope: ScopeRef) => Promise<ScopedValuesData['seo']>;
|
|
33
|
+
/** One field's view at `scope` (FR-109): the effective value, its source and the own value. */
|
|
34
|
+
export declare function fieldView<T>(spec: FieldScopeSpec, global: T | null | undefined, rows: readonly ScopedRow<T>[], scope: ScopeRef, members: readonly MemberChannel[]): ScopedFieldView<T>;
|
|
35
|
+
/** The facts the completeness rule reads (R16), from the loaded state. */
|
|
36
|
+
export declare function completenessFacts(state: ScopedProductState): CompletenessFacts;
|
|
37
|
+
/** §2.1 — the completeness summary at the scope's level. */
|
|
38
|
+
export declare function completenessSummary(state: ScopedProductState, scope: ScopeRef): CompletenessSummary;
|
|
39
|
+
/** The `fields`, `attributes`, `gallery`, `attachments` and `packagingUnits` of a read, at `scope`. */
|
|
40
|
+
export declare function scopedViews(state: ScopedProductState, scope: ScopeRef): Pick<ScopedValuesData, 'fields' | 'attributes' | 'gallery' | 'attachments' | 'packagingUnits'> & {
|
|
41
|
+
galleryAssetIds: string[];
|
|
42
|
+
};
|
|
43
|
+
export declare class ScopedValuesReadService {
|
|
44
|
+
#private;
|
|
45
|
+
private readonly emFactory;
|
|
46
|
+
private readonly deps;
|
|
47
|
+
constructor(emFactory: () => EntityManager, deps: ScopedValuesReadDeps);
|
|
48
|
+
/** `GET …/products/:id/scoped-values` — the product at the request's scope. */
|
|
49
|
+
read(productId: string, request: {
|
|
50
|
+
channelId?: string | undefined;
|
|
51
|
+
languageCode?: string | undefined;
|
|
52
|
+
}): Promise<ScopedValuesData>;
|
|
53
|
+
/** The read body for an already-loaded state — the save answers with it, re-read at the same scope. */
|
|
54
|
+
project(state: ScopedProductState, scope: ScopeRef): Promise<ScopedValuesData>;
|
|
55
|
+
}
|
|
56
|
+
//# sourceMappingURL=scoped-values-read.service.d.ts.map
|
|
@@ -0,0 +1,289 @@
|
|
|
1
|
+
import { GALLERY_ROLE_LABELS, PRODUCT_FIELD_SCOPE_SETS, attributeFieldSpec, levelOf, resolveScoped, } from '@endora-commerce/contracts';
|
|
2
|
+
import { checkCompleteness, requiredAttributeKeys } from './scope-completeness.js';
|
|
3
|
+
import { channelScopeRows, familyOverrideRows, galleryRoleRows, languageStatusRows, valueOverrideRows, } from './scoped-store-adapters.js';
|
|
4
|
+
import { atValidScopes, loadScopedState, resolveRequestScope, } from './scoped-values-state.js';
|
|
5
|
+
/**
|
|
6
|
+
* Feature 174 (T036; `contracts/scoped-values-api.md` §2) — `GET …/products/:id/scoped-values`:
|
|
7
|
+
* every scoped field of the product at one scope, with its source, in **one** request per scope
|
|
8
|
+
* switch (FR-109). Orphaned rows never contribute. `seo` is `seo`'s own view at the scope
|
|
9
|
+
* (`seoProductMetaPort.readScoped`, US10), `null` while `seo` is off.
|
|
10
|
+
*/
|
|
11
|
+
/** The camelCase role keys of the API (Principle VI) for the stored labels. */
|
|
12
|
+
export const GALLERY_ROLE_KEYS = {
|
|
13
|
+
base_image: 'baseImage',
|
|
14
|
+
small_image: 'smallImage',
|
|
15
|
+
thumbnail: 'thumbnail',
|
|
16
|
+
};
|
|
17
|
+
/** The scope is one the product sells at now — `seo`'s scoped read refuses any other (422). */
|
|
18
|
+
function isLiveScope(state, scope) {
|
|
19
|
+
if (scope.level === 'global')
|
|
20
|
+
return true;
|
|
21
|
+
const channel = state.members.find((member) => member.id === scope.channelId);
|
|
22
|
+
if (!channel)
|
|
23
|
+
return false;
|
|
24
|
+
if (scope.level === 'channel')
|
|
25
|
+
return true;
|
|
26
|
+
return channel.languages.some((code) => code.toLowerCase() === scope.languageCode.toLowerCase());
|
|
27
|
+
}
|
|
28
|
+
/** One field's view at `scope` (FR-109): the effective value, its source and the own value. */
|
|
29
|
+
export function fieldView(spec, global, rows, scope, members) {
|
|
30
|
+
const valid = atValidScopes(rows, members);
|
|
31
|
+
const resolved = resolveScoped({ global: global ?? null, rows: valid, scope, levels: spec.levels });
|
|
32
|
+
const own = resolved.source === 'set' || resolved.source === 'set_empty';
|
|
33
|
+
return {
|
|
34
|
+
value: resolved.value,
|
|
35
|
+
source: resolved.source,
|
|
36
|
+
...(own ? { ownValue: resolved.value } : {}),
|
|
37
|
+
...(scope.level === 'global' ? {} : { inheritedValue: inheritedAt(spec, global ?? null, valid, scope) }),
|
|
38
|
+
levels: [...spec.levels],
|
|
39
|
+
supportedHere: spec.levels.includes(levelOf(scope)),
|
|
40
|
+
required: spec.required,
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* What the field would read if it inherited at `scope` (owner decision 2026-11-03): the same
|
|
45
|
+
* resolution without the scope's own row, so an empty parent stays empty rather than falling
|
|
46
|
+
* through to Global.
|
|
47
|
+
*/
|
|
48
|
+
function inheritedAt(spec, global, rows, scope) {
|
|
49
|
+
const isOwn = (row) => row.channelId === scope.channelId &&
|
|
50
|
+
(scope.level === 'channel'
|
|
51
|
+
? row.languageCode === null
|
|
52
|
+
: row.languageCode !== null && row.languageCode.toLowerCase() === scope.languageCode.toLowerCase());
|
|
53
|
+
const resolved = resolveScoped({ global, rows: rows.filter((row) => !isOwn(row)), scope, levels: spec.levels });
|
|
54
|
+
// Without its own row a non-Global scope resolves to the channel row or to Global (which may
|
|
55
|
+
// hold no value: `value: null`, level `G`).
|
|
56
|
+
return { value: resolved.value, level: resolved.source === 'inherited_channel' ? 'C' : 'G' };
|
|
57
|
+
}
|
|
58
|
+
const textOf = (name, fallback) => {
|
|
59
|
+
if (typeof name === 'string' && name !== '')
|
|
60
|
+
return name;
|
|
61
|
+
if (name && typeof name === 'object') {
|
|
62
|
+
return name['en-US'] ?? Object.values(name).find((value) => typeof value === 'string' && value !== '') ?? fallback;
|
|
63
|
+
}
|
|
64
|
+
return fallback;
|
|
65
|
+
};
|
|
66
|
+
/** The facts the completeness rule reads (R16), from the loaded state. */
|
|
67
|
+
export function completenessFacts(state) {
|
|
68
|
+
const views = [...state.attributes.values()];
|
|
69
|
+
return {
|
|
70
|
+
name: state.product.name ?? '',
|
|
71
|
+
slug: state.product.slug ?? '',
|
|
72
|
+
attributeValues: state.product.attributeValues ?? {},
|
|
73
|
+
requiredAttributes: requiredAttributeKeys(views, new Set(views.map((view) => view.customFieldDefinitionId))),
|
|
74
|
+
attributeLevels: new Map(views.map((view) => [view.key, view.scopeLevels])),
|
|
75
|
+
valueOverrides: state.valueOverrides.map((row) => ({
|
|
76
|
+
attributeKey: row.attributeKey,
|
|
77
|
+
channelId: row.channelId,
|
|
78
|
+
languageCode: row.languageCode ?? null,
|
|
79
|
+
value: row.value,
|
|
80
|
+
})),
|
|
81
|
+
urlKeys: state.urlKeys.map((row) => ({ languageCode: row.languageCode, salesChannelId: row.salesChannelId })),
|
|
82
|
+
};
|
|
83
|
+
}
|
|
84
|
+
/** §2.1 — the completeness summary at the scope's level. */
|
|
85
|
+
export function completenessSummary(state, scope) {
|
|
86
|
+
const facts = completenessFacts(state);
|
|
87
|
+
if (scope.level === 'channel_language') {
|
|
88
|
+
return { level: 'channel_language', missing: checkCompleteness(facts, scope.channelId, scope.languageCode) };
|
|
89
|
+
}
|
|
90
|
+
if (scope.level === 'channel') {
|
|
91
|
+
const channel = state.members.find((member) => member.id === scope.channelId);
|
|
92
|
+
const byField = new Map();
|
|
93
|
+
for (const languageCode of channel?.languages ?? []) {
|
|
94
|
+
for (const field of checkCompleteness(facts, scope.channelId, languageCode)) {
|
|
95
|
+
byField.set(field, [...(byField.get(field) ?? []), languageCode]);
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
return { level: 'channel', missing: [...byField].map(([field, languages]) => ({ field, languages })) };
|
|
99
|
+
}
|
|
100
|
+
let incompleteScopes = 0;
|
|
101
|
+
for (const channel of state.members) {
|
|
102
|
+
for (const languageCode of channel.languages) {
|
|
103
|
+
if (checkCompleteness(facts, channel.id, languageCode).length > 0)
|
|
104
|
+
incompleteScopes += 1;
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
return { level: 'global', incompleteScopes };
|
|
108
|
+
}
|
|
109
|
+
/** The `fields`, `attributes`, `gallery`, `attachments` and `packagingUnits` of a read, at `scope`. */
|
|
110
|
+
export function scopedViews(state, scope) {
|
|
111
|
+
const { product, members } = state;
|
|
112
|
+
const sets = PRODUCT_FIELD_SCOPE_SETS;
|
|
113
|
+
const overrides = state.valueOverrides.map((row) => ({
|
|
114
|
+
attributeKey: row.attributeKey,
|
|
115
|
+
channelId: row.channelId,
|
|
116
|
+
languageCode: row.languageCode ?? null,
|
|
117
|
+
value: row.value,
|
|
118
|
+
}));
|
|
119
|
+
const statusRows = [...channelScopeRows(state.channelRows, 'status'), ...languageStatusRows(state.languageRows)];
|
|
120
|
+
const urlKeyRows = state.urlKeys.map((row) => ({
|
|
121
|
+
channelId: row.salesChannelId,
|
|
122
|
+
languageCode: row.languageCode,
|
|
123
|
+
value: { kind: 'value', value: row.key },
|
|
124
|
+
}));
|
|
125
|
+
const fields = {
|
|
126
|
+
name: fieldView(sets.name, product.name, valueOverrideRows(overrides, 'name'), scope, members),
|
|
127
|
+
description: fieldView(sets.description, product.description, valueOverrideRows(overrides, 'description'), scope, members),
|
|
128
|
+
status: fieldView(sets.status, product.status, statusRows, scope, members),
|
|
129
|
+
window: fieldView(sets.window, { from: product.publishFrom?.toISOString() ?? null, until: product.publishUntil?.toISOString() ?? null }, channelScopeRows(state.channelRows, 'window'), scope, members),
|
|
130
|
+
audience: fieldView(sets.audience, { visibility: product.visibility, allowedOrganizationIds: [...product.allowedOrganizationIds] }, channelScopeRows(state.channelRows, 'audience'), scope, members),
|
|
131
|
+
minOrderQuantity: fieldView(sets.minOrderQuantity, product.minOrderQuantity ?? null, channelScopeRows(state.channelRows, 'minOrderQuantity'), scope, members),
|
|
132
|
+
returnable: fieldView(sets.returnable, product.returnable, channelScopeRows(state.channelRows, 'returnable'), scope, members),
|
|
133
|
+
urlKey: fieldView(sets.urlKey, product.slug, urlKeyRows, scope, members),
|
|
134
|
+
};
|
|
135
|
+
const attributes = [...state.attributes.values()]
|
|
136
|
+
.sort((a, b) => a.key.localeCompare(b.key))
|
|
137
|
+
.map((view) => ({
|
|
138
|
+
key: view.key,
|
|
139
|
+
label: view.label,
|
|
140
|
+
valueType: view.valueType,
|
|
141
|
+
isRequired: view.isRequired,
|
|
142
|
+
view: fieldView(attributeFieldSpec(view), product.attributeValues?.[view.key] ?? null, valueOverrideRows(overrides, view.key), scope, members),
|
|
143
|
+
}));
|
|
144
|
+
const itemOverrides = state.galleryOverrides.map((row) => ({ ...row, subjectId: row.galleryItemId }));
|
|
145
|
+
const items = state.galleryItems.map((item) => ({
|
|
146
|
+
id: item.id,
|
|
147
|
+
assetId: item.assetId,
|
|
148
|
+
url: '',
|
|
149
|
+
position: item.position,
|
|
150
|
+
altText: fieldView(sets['gallery:altText'], item.altText, familyOverrideRows(itemOverrides, item.id, 'alt_text'), scope, members),
|
|
151
|
+
hidden: fieldView(sets['gallery:hidden'], item.hidden, familyOverrideRows(itemOverrides, item.id, 'hidden'), scope, members),
|
|
152
|
+
assetAltText: null,
|
|
153
|
+
}));
|
|
154
|
+
const roles = Object.fromEntries(GALLERY_ROLE_LABELS.map((label) => {
|
|
155
|
+
const holder = state.galleryLabels.find((row) => row.label === label)?.galleryItemId ?? null;
|
|
156
|
+
const view = fieldView(sets.galleryRole, holder, galleryRoleRows(state.roleOverrides, label), scope, members);
|
|
157
|
+
// A holder effectively hidden at this scope holds the role for nobody (163 rule kept).
|
|
158
|
+
const held = items.find((item) => item.id === view.value);
|
|
159
|
+
if (view.value !== null && (!held || held.hidden.value === true))
|
|
160
|
+
view.value = null;
|
|
161
|
+
const inheritedHolder = view.inheritedValue ? items.find((item) => item.id === view.inheritedValue.value) : undefined;
|
|
162
|
+
if (view.inheritedValue && view.inheritedValue.value !== null && (!inheritedHolder || inheritedHolder.hidden.value === true)) {
|
|
163
|
+
view.inheritedValue.value = null;
|
|
164
|
+
}
|
|
165
|
+
return [GALLERY_ROLE_KEYS[label], view];
|
|
166
|
+
}));
|
|
167
|
+
const attachmentOverrides = state.attachmentOverrides.map((row) => ({ ...row, subjectId: row.attachmentId }));
|
|
168
|
+
const attachments = state.attachments.map((attachment) => ({
|
|
169
|
+
id: attachment.id,
|
|
170
|
+
assetId: attachment.assetId,
|
|
171
|
+
typeId: attachment.attachmentTypeId,
|
|
172
|
+
position: attachment.position,
|
|
173
|
+
fileName: '',
|
|
174
|
+
name: fieldView(sets['attachment:name'], attachment.name, familyOverrideRows(attachmentOverrides, attachment.id, 'name'), scope, members),
|
|
175
|
+
description: fieldView(sets['attachment:description'], attachment.description ?? null, familyOverrideRows(attachmentOverrides, attachment.id, 'description'), scope, members),
|
|
176
|
+
hidden: fieldView(sets['attachment:hidden'], attachment.hidden, familyOverrideRows(attachmentOverrides, attachment.id, 'hidden'), scope, members),
|
|
177
|
+
}));
|
|
178
|
+
const unitOverrides = state.packagingOverrides.map((row) => ({ ...row, subjectId: row.packagingUnitId }));
|
|
179
|
+
const packagingUnits = state.packagingUnits.map((unit) => ({
|
|
180
|
+
id: unit.id,
|
|
181
|
+
baseQuantity: unit.baseQuantity,
|
|
182
|
+
position: unit.position,
|
|
183
|
+
isDefault: unit.isDefault,
|
|
184
|
+
minOrderUnits: unit.minOrderUnits ?? null,
|
|
185
|
+
name: fieldView(sets['packagingUnit:name'], unit.name, familyOverrideRows(unitOverrides, unit.id, 'name'), scope, members),
|
|
186
|
+
}));
|
|
187
|
+
return {
|
|
188
|
+
fields,
|
|
189
|
+
attributes,
|
|
190
|
+
gallery: { items, roles },
|
|
191
|
+
attachments,
|
|
192
|
+
packagingUnits,
|
|
193
|
+
galleryAssetIds: [...new Set([...state.galleryItems.map((item) => item.assetId), ...state.attachments.map((a) => a.assetId)])],
|
|
194
|
+
};
|
|
195
|
+
}
|
|
196
|
+
export class ScopedValuesReadService {
|
|
197
|
+
emFactory;
|
|
198
|
+
deps;
|
|
199
|
+
constructor(emFactory, deps) {
|
|
200
|
+
this.emFactory = emFactory;
|
|
201
|
+
this.deps = deps;
|
|
202
|
+
}
|
|
203
|
+
/** `GET …/products/:id/scoped-values` — the product at the request's scope. */
|
|
204
|
+
async read(productId, request) {
|
|
205
|
+
const em = this.emFactory();
|
|
206
|
+
const state = await loadScopedState(em, productId, this.deps);
|
|
207
|
+
const scope = resolveRequestScope(state.members, request);
|
|
208
|
+
return this.project(state, scope);
|
|
209
|
+
}
|
|
210
|
+
/** The read body for an already-loaded state — the save answers with it, re-read at the same scope. */
|
|
211
|
+
async project(state, scope) {
|
|
212
|
+
const { product } = state;
|
|
213
|
+
const views = scopedViews(state, scope);
|
|
214
|
+
const languageCode = scope.level === 'channel_language' ? scope.languageCode : null;
|
|
215
|
+
const assets = views.galleryAssetIds.length > 0 && this.deps.assets ? await this.deps.assets.findByIds(views.galleryAssetIds) : [];
|
|
216
|
+
const assetById = new Map(assets.map((asset) => [asset.id, asset]));
|
|
217
|
+
for (const item of views.gallery.items) {
|
|
218
|
+
const asset = assetById.get(item.assetId);
|
|
219
|
+
item.url = asset?.storageUrl ?? '';
|
|
220
|
+
const alt = asset?.altText ?? null;
|
|
221
|
+
item.assetAltText = alt ? (languageCode ? (alt[languageCode] ?? null) : (alt['en-US'] ?? Object.values(alt)[0] ?? null)) : null;
|
|
222
|
+
}
|
|
223
|
+
for (const attachment of views.attachments)
|
|
224
|
+
attachment.fileName = assetById.get(attachment.assetId)?.filename ?? '';
|
|
225
|
+
const languageNames = new Map();
|
|
226
|
+
if (this.deps.languages) {
|
|
227
|
+
for (const language of await this.deps.languages.list())
|
|
228
|
+
languageNames.set(language.code.toLowerCase(), language.label);
|
|
229
|
+
}
|
|
230
|
+
const named = new Set();
|
|
231
|
+
for (const row of state.channelRows)
|
|
232
|
+
for (const id of row.allowedOrganizationIds ?? [])
|
|
233
|
+
named.add(id);
|
|
234
|
+
for (const id of product.allowedOrganizationIds)
|
|
235
|
+
named.add(id);
|
|
236
|
+
const organizations = await this.#organizationNames([...named]);
|
|
237
|
+
return {
|
|
238
|
+
scope,
|
|
239
|
+
version: state.version,
|
|
240
|
+
validScopes: {
|
|
241
|
+
channels: state.members.map((channel) => ({
|
|
242
|
+
channelId: channel.id,
|
|
243
|
+
name: textOf(channel.name, channel.code),
|
|
244
|
+
languages: channel.languages.map((code) => ({ code, name: languageNames.get(code.toLowerCase()) ?? code })),
|
|
245
|
+
})),
|
|
246
|
+
},
|
|
247
|
+
product: {
|
|
248
|
+
sku: product.sku,
|
|
249
|
+
type: product.type,
|
|
250
|
+
attributeSetId: product.attributeSetId,
|
|
251
|
+
categoryIds: state.categoryIds,
|
|
252
|
+
archivedAt: product.archivedAt?.toISOString() ?? null,
|
|
253
|
+
slugGlobal: product.slug,
|
|
254
|
+
manageStock: product.manageStock,
|
|
255
|
+
backorderEnabled: product.backorderEnabled,
|
|
256
|
+
lowStockThreshold: product.lowStockThreshold ?? null,
|
|
257
|
+
lowStockThresholdMode: product.lowStockThresholdMode,
|
|
258
|
+
fulfilmentStrategy: product.fulfilmentStrategy ?? null,
|
|
259
|
+
fulfilmentStrategyWarehouseOrder: product.fulfilmentStrategyWarehouseOrder ?? null,
|
|
260
|
+
downloadAssetId: product.downloadAssetId ?? null,
|
|
261
|
+
downloadUrl: product.downloadUrl ?? null,
|
|
262
|
+
allowedOrganizationIds: [...product.allowedOrganizationIds],
|
|
263
|
+
},
|
|
264
|
+
fields: views.fields,
|
|
265
|
+
attributes: views.attributes,
|
|
266
|
+
gallery: views.gallery,
|
|
267
|
+
attachments: views.attachments,
|
|
268
|
+
packagingUnits: views.packagingUnits,
|
|
269
|
+
// An orphaned scope (a removal-only save's answer) has no SEO view: seo refuses that scope.
|
|
270
|
+
seo: this.deps.readSeo && isLiveScope(state, scope) ? await this.deps.readSeo(product.id, scope) : null,
|
|
271
|
+
completeness: completenessSummary(state, scope),
|
|
272
|
+
organizations,
|
|
273
|
+
};
|
|
274
|
+
}
|
|
275
|
+
async #organizationNames(ids) {
|
|
276
|
+
if (!this.deps.organizations || ids.length === 0)
|
|
277
|
+
return [];
|
|
278
|
+
let records;
|
|
279
|
+
try {
|
|
280
|
+
records = await this.deps.organizations.findByIds(ids);
|
|
281
|
+
}
|
|
282
|
+
catch {
|
|
283
|
+
// Best effort (163 U1): with `organizations` off or refusing, the editor shows ids.
|
|
284
|
+
return [];
|
|
285
|
+
}
|
|
286
|
+
return records.map((record) => ({ id: record.id, name: record.name }));
|
|
287
|
+
}
|
|
288
|
+
}
|
|
289
|
+
//# sourceMappingURL=scoped-values-read.service.js.map
|