@endora-commerce/mod-catalog 0.109.0 → 0.110.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/admin/components/CopyToChannelsDialog.d.ts +37 -0
- package/dist/admin/components/CopyToChannelsDialog.d.ts.map +1 -0
- package/dist/admin/components/CopyToChannelsDialog.js +83 -0
- package/dist/admin/components/CopyToChannelsDialog.js.map +1 -0
- package/dist/admin/components/PackagingUnitsEditor.d.ts +13 -4
- package/dist/admin/components/PackagingUnitsEditor.d.ts.map +1 -1
- package/dist/admin/components/PackagingUnitsEditor.js +20 -85
- package/dist/admin/components/PackagingUnitsEditor.js.map +1 -1
- package/dist/admin/components/ProductAttachmentsSection.d.ts +1 -3
- package/dist/admin/components/ProductAttachmentsSection.d.ts.map +1 -1
- package/dist/admin/components/ProductAttachmentsSection.js +59 -98
- package/dist/admin/components/ProductAttachmentsSection.js.map +1 -1
- package/dist/admin/components/ProductAttributesTab.d.ts +1 -11
- package/dist/admin/components/ProductAttributesTab.d.ts.map +1 -1
- package/dist/admin/components/ProductAttributesTab.js +128 -119
- package/dist/admin/components/ProductAttributesTab.js.map +1 -1
- package/dist/admin/components/ProductContentCard.d.ts +41 -0
- package/dist/admin/components/ProductContentCard.d.ts.map +1 -0
- package/dist/admin/components/ProductContentCard.js +28 -0
- package/dist/admin/components/ProductContentCard.js.map +1 -0
- package/dist/admin/components/ProductGallerySection.d.ts +2 -13
- package/dist/admin/components/ProductGallerySection.d.ts.map +1 -1
- package/dist/admin/components/ProductGallerySection.js +98 -354
- package/dist/admin/components/ProductGallerySection.js.map +1 -1
- package/dist/admin/components/ProductOrderRulesCard.d.ts +11 -15
- package/dist/admin/components/ProductOrderRulesCard.d.ts.map +1 -1
- package/dist/admin/components/ProductOrderRulesCard.js +15 -268
- package/dist/admin/components/ProductOrderRulesCard.js.map +1 -1
- package/dist/admin/components/ProductScopeBar.d.ts +28 -0
- package/dist/admin/components/ProductScopeBar.d.ts.map +1 -0
- package/dist/admin/components/ProductScopeBar.js +70 -0
- package/dist/admin/components/ProductScopeBar.js.map +1 -0
- package/dist/admin/components/ProductScopeOverview.d.ts +13 -1
- package/dist/admin/components/ProductScopeOverview.d.ts.map +1 -1
- package/dist/admin/components/ProductScopeOverview.js +51 -36
- package/dist/admin/components/ProductScopeOverview.js.map +1 -1
- package/dist/admin/components/ProductUrlRedirects.d.ts +15 -0
- package/dist/admin/components/ProductUrlRedirects.d.ts.map +1 -0
- package/dist/admin/components/ProductUrlRedirects.js +70 -0
- package/dist/admin/components/ProductUrlRedirects.js.map +1 -0
- package/dist/admin/components/editor/DetailsTab.d.ts +30 -0
- package/dist/admin/components/editor/DetailsTab.d.ts.map +1 -0
- package/dist/admin/components/editor/DetailsTab.js +59 -0
- package/dist/admin/components/editor/DetailsTab.js.map +1 -0
- package/dist/admin/components/editor/ImmediateBadge.d.ts +21 -0
- package/dist/admin/components/editor/ImmediateBadge.d.ts.map +1 -0
- package/dist/admin/components/editor/ImmediateBadge.js +21 -0
- package/dist/admin/components/editor/ImmediateBadge.js.map +1 -0
- package/dist/admin/components/editor/confirm-removal.d.ts +13 -0
- package/dist/admin/components/editor/confirm-removal.d.ts.map +1 -0
- package/dist/admin/components/editor/confirm-removal.js +33 -0
- package/dist/admin/components/editor/confirm-removal.js.map +1 -0
- package/dist/admin/components/editor/editor-context.d.ts +53 -0
- package/dist/admin/components/editor/editor-context.d.ts.map +1 -0
- package/dist/admin/components/editor/editor-context.js +88 -0
- package/dist/admin/components/editor/editor-context.js.map +1 -0
- package/dist/admin/components/editor/scoped-controls.d.ts +46 -0
- package/dist/admin/components/editor/scoped-controls.d.ts.map +1 -0
- package/dist/admin/components/editor/scoped-controls.js +64 -0
- package/dist/admin/components/editor/scoped-controls.js.map +1 -0
- package/dist/admin/index.d.ts +1 -1
- package/dist/admin/index.d.ts.map +1 -1
- package/dist/admin/index.js +11 -0
- package/dist/admin/index.js.map +1 -1
- package/dist/admin/lib/attribute-scope.d.ts +17 -14
- package/dist/admin/lib/attribute-scope.d.ts.map +1 -1
- package/dist/admin/lib/attribute-scope.js +12 -9
- package/dist/admin/lib/attribute-scope.js.map +1 -1
- package/dist/admin/lib/editor-scope.d.ts +35 -0
- package/dist/admin/lib/editor-scope.d.ts.map +1 -0
- package/dist/admin/lib/editor-scope.js +114 -0
- package/dist/admin/lib/editor-scope.js.map +1 -0
- package/dist/admin/lib/order-minimum-input.d.ts +13 -0
- package/dist/admin/lib/order-minimum-input.d.ts.map +1 -0
- package/dist/admin/lib/order-minimum-input.js +16 -0
- package/dist/admin/lib/order-minimum-input.js.map +1 -0
- package/dist/admin/lib/product-labels.d.ts +0 -2
- package/dist/admin/lib/product-labels.d.ts.map +1 -1
- package/dist/admin/lib/product-labels.js +1 -5
- package/dist/admin/lib/product-labels.js.map +1 -1
- package/dist/admin/lib/product-scopes-api.d.ts +5 -22
- package/dist/admin/lib/product-scopes-api.d.ts.map +1 -1
- package/dist/admin/lib/product-scopes-api.js +1 -45
- package/dist/admin/lib/product-scopes-api.js.map +1 -1
- package/dist/admin/lib/product-url-keys-api.d.ts +4 -27
- package/dist/admin/lib/product-url-keys-api.d.ts.map +1 -1
- package/dist/admin/lib/product-url-keys-api.js +0 -49
- package/dist/admin/lib/product-url-keys-api.js.map +1 -1
- package/dist/admin/lib/scope-overview.d.ts +13 -14
- package/dist/admin/lib/scope-overview.d.ts.map +1 -1
- package/dist/admin/lib/scope-overview.js +36 -31
- package/dist/admin/lib/scope-overview.js.map +1 -1
- package/dist/admin/lib/scoped-editor-store.d.ts +81 -0
- package/dist/admin/lib/scoped-editor-store.d.ts.map +1 -0
- package/dist/admin/lib/scoped-editor-store.js +198 -0
- package/dist/admin/lib/scoped-editor-store.js.map +1 -0
- package/dist/admin/lib/scoped-values-api.d.ts +14 -0
- package/dist/admin/lib/scoped-values-api.d.ts.map +1 -0
- package/dist/admin/lib/scoped-values-api.js +55 -0
- package/dist/admin/lib/scoped-values-api.js.map +1 -0
- package/dist/admin/pages/AttributesManager.d.ts.map +1 -1
- package/dist/admin/pages/AttributesManager.js +119 -38
- package/dist/admin/pages/AttributesManager.js.map +1 -1
- package/dist/admin/pages/ProductContentPage.d.ts +27 -0
- package/dist/admin/pages/ProductContentPage.d.ts.map +1 -0
- package/dist/admin/pages/ProductContentPage.js +161 -0
- package/dist/admin/pages/ProductContentPage.js.map +1 -0
- package/dist/admin/pages/ProductCreateForm.d.ts +3 -0
- package/dist/admin/pages/ProductCreateForm.d.ts.map +1 -0
- package/dist/admin/pages/ProductCreateForm.js +87 -0
- package/dist/admin/pages/ProductCreateForm.js.map +1 -0
- package/dist/admin/pages/ProductEditor.d.ts.map +1 -1
- package/dist/admin/pages/ProductEditor.js +840 -457
- package/dist/admin/pages/ProductEditor.js.map +1 -1
- package/dist/admin/pages/ProductsList.d.ts.map +1 -1
- package/dist/admin/pages/ProductsList.js +9 -19
- package/dist/admin/pages/ProductsList.js.map +1 -1
- package/dist/backend/admin-search-provider.d.ts +2 -1
- package/dist/backend/admin-search-provider.d.ts.map +1 -1
- package/dist/backend/admin-search-provider.js +1 -1
- package/dist/backend/admin-search-provider.js.map +1 -1
- package/dist/backend/commands/attribute-commands.d.ts +4 -3
- package/dist/backend/commands/attribute-commands.d.ts.map +1 -1
- package/dist/backend/commands/attribute-commands.js +82 -21
- package/dist/backend/commands/attribute-commands.js.map +1 -1
- package/dist/backend/commands/product-content-commands.d.ts +31 -0
- package/dist/backend/commands/product-content-commands.d.ts.map +1 -0
- package/dist/backend/commands/product-content-commands.js +70 -0
- package/dist/backend/commands/product-content-commands.js.map +1 -0
- package/dist/backend/commands/scoped-values.commands.d.ts +95 -0
- package/dist/backend/commands/scoped-values.commands.d.ts.map +1 -0
- package/dist/backend/commands/scoped-values.commands.js +235 -0
- package/dist/backend/commands/scoped-values.commands.js.map +1 -0
- package/dist/backend/demo/reset.d.ts.map +1 -1
- package/dist/backend/demo/reset.js +2 -1
- package/dist/backend/demo/reset.js.map +1 -1
- package/dist/backend/demo/rows.d.ts +18 -0
- package/dist/backend/demo/rows.d.ts.map +1 -1
- package/dist/backend/demo/rows.js +18 -0
- package/dist/backend/demo/rows.js.map +1 -1
- package/dist/backend/demo/seed.d.ts +2 -1
- package/dist/backend/demo/seed.d.ts.map +1 -1
- package/dist/backend/demo/seed.js +20 -6
- package/dist/backend/demo/seed.js.map +1 -1
- package/dist/backend/entities/gallery-item-scope-override.entity.d.ts +30 -0
- package/dist/backend/entities/gallery-item-scope-override.entity.d.ts.map +1 -0
- package/dist/backend/entities/gallery-item-scope-override.entity.js +80 -0
- package/dist/backend/entities/gallery-item-scope-override.entity.js.map +1 -0
- package/dist/backend/entities/gallery-item.entity.d.ts +7 -6
- package/dist/backend/entities/gallery-item.entity.d.ts.map +1 -1
- package/dist/backend/entities/gallery-item.entity.js +11 -6
- package/dist/backend/entities/gallery-item.entity.js.map +1 -1
- package/dist/backend/entities/gallery-role-scope-override.entity.d.ts +28 -0
- package/dist/backend/entities/gallery-role-scope-override.entity.d.ts.map +1 -0
- package/dist/backend/entities/gallery-role-scope-override.entity.js +75 -0
- package/dist/backend/entities/gallery-role-scope-override.entity.js.map +1 -0
- package/dist/backend/entities/product-attachment-scope-override.entity.d.ts +30 -0
- package/dist/backend/entities/product-attachment-scope-override.entity.d.ts.map +1 -0
- package/dist/backend/entities/product-attachment-scope-override.entity.js +80 -0
- package/dist/backend/entities/product-attachment-scope-override.entity.js.map +1 -0
- package/dist/backend/entities/product-attachment.entity.d.ts +4 -6
- package/dist/backend/entities/product-attachment.entity.d.ts.map +1 -1
- package/dist/backend/entities/product-attachment.entity.js +6 -12
- package/dist/backend/entities/product-attachment.entity.js.map +1 -1
- package/dist/backend/entities/product-attribute.entity.d.ts +5 -9
- package/dist/backend/entities/product-attribute.entity.d.ts.map +1 -1
- package/dist/backend/entities/product-attribute.entity.js +5 -13
- package/dist/backend/entities/product-attribute.entity.js.map +1 -1
- package/dist/backend/entities/product-channel-scope.entity.d.ts +7 -2
- package/dist/backend/entities/product-channel-scope.entity.d.ts.map +1 -1
- package/dist/backend/entities/product-channel-scope.entity.js +10 -1
- package/dist/backend/entities/product-channel-scope.entity.js.map +1 -1
- package/dist/backend/entities/product-content-value.entity.d.ts +39 -0
- package/dist/backend/entities/product-content-value.entity.d.ts.map +1 -0
- package/dist/backend/entities/product-content-value.entity.js +81 -0
- package/dist/backend/entities/product-content-value.entity.js.map +1 -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.d.ts.map +1 -0
- package/dist/backend/entities/product-packaging-unit-scope-override.entity.js +80 -0
- package/dist/backend/entities/product-packaging-unit-scope-override.entity.js.map +1 -0
- package/dist/backend/entities/product-packaging-unit.entity.d.ts +1 -7
- package/dist/backend/entities/product-packaging-unit.entity.d.ts.map +1 -1
- package/dist/backend/entities/product-packaging-unit.entity.js +0 -10
- package/dist/backend/entities/product-packaging-unit.entity.js.map +1 -1
- package/dist/backend/entities/product-url-key.entity.d.ts +14 -19
- package/dist/backend/entities/product-url-key.entity.d.ts.map +1 -1
- package/dist/backend/entities/product-url-key.entity.js +17 -22
- package/dist/backend/entities/product-url-key.entity.js.map +1 -1
- package/dist/backend/entities/product-url-redirect.entity.d.ts +8 -13
- package/dist/backend/entities/product-url-redirect.entity.d.ts.map +1 -1
- package/dist/backend/entities/product-url-redirect.entity.js +13 -14
- package/dist/backend/entities/product-url-redirect.entity.js.map +1 -1
- package/dist/backend/entities/product-variant.entity.d.ts +8 -1
- package/dist/backend/entities/product-variant.entity.d.ts.map +1 -1
- package/dist/backend/entities/product-variant.entity.js +13 -2
- package/dist/backend/entities/product-variant.entity.js.map +1 -1
- package/dist/backend/entities/product.entity.d.ts +31 -14
- package/dist/backend/entities/product.entity.d.ts.map +1 -1
- package/dist/backend/entities/product.entity.js +41 -34
- package/dist/backend/entities/product.entity.js.map +1 -1
- package/dist/backend/index.d.ts +8 -3
- package/dist/backend/index.d.ts.map +1 -1
- package/dist/backend/index.js +136 -49
- package/dist/backend/index.js.map +1 -1
- package/dist/backend/plugin.d.ts +36 -6
- package/dist/backend/plugin.d.ts.map +1 -1
- package/dist/backend/plugin.js +36 -13
- package/dist/backend/plugin.js.map +1 -1
- package/dist/backend/prompt-tools.d.ts +3 -2
- package/dist/backend/prompt-tools.d.ts.map +1 -1
- package/dist/backend/prompt-tools.js +18 -7
- package/dist/backend/prompt-tools.js.map +1 -1
- package/dist/backend/routes.admin.d.ts +15 -16
- package/dist/backend/routes.admin.d.ts.map +1 -1
- package/dist/backend/routes.admin.js +110 -99
- package/dist/backend/routes.admin.js.map +1 -1
- package/dist/backend/routes.api-key.d.ts.map +1 -1
- package/dist/backend/routes.api-key.js +4 -2
- package/dist/backend/routes.api-key.js.map +1 -1
- package/dist/backend/routes.public.d.ts +8 -1
- package/dist/backend/routes.public.d.ts.map +1 -1
- package/dist/backend/routes.public.js +60 -8
- package/dist/backend/routes.public.js.map +1 -1
- package/dist/backend/services/asset-references.d.ts +12 -1
- package/dist/backend/services/asset-references.d.ts.map +1 -1
- package/dist/backend/services/asset-references.js +42 -2
- package/dist/backend/services/asset-references.js.map +1 -1
- package/dist/backend/services/attachment-packaging-scopes.d.ts +38 -20
- package/dist/backend/services/attachment-packaging-scopes.d.ts.map +1 -1
- package/dist/backend/services/attachment-packaging-scopes.js +58 -75
- package/dist/backend/services/attachment-packaging-scopes.js.map +1 -1
- package/dist/backend/services/attachment.service.d.ts +4 -8
- package/dist/backend/services/attachment.service.d.ts.map +1 -1
- package/dist/backend/services/attachment.service.js +35 -49
- package/dist/backend/services/attachment.service.js.map +1 -1
- package/dist/backend/services/attribute-filter-match.d.ts +14 -0
- package/dist/backend/services/attribute-filter-match.d.ts.map +1 -0
- package/dist/backend/services/attribute-filter-match.js +19 -0
- package/dist/backend/services/attribute-filter-match.js.map +1 -0
- package/dist/backend/services/attribute-scope-preview.d.ts +17 -7
- package/dist/backend/services/attribute-scope-preview.d.ts.map +1 -1
- package/dist/backend/services/attribute-scope-preview.js +30 -20
- package/dist/backend/services/attribute-scope-preview.js.map +1 -1
- package/dist/backend/services/attribute-set.service.d.ts +10 -1
- package/dist/backend/services/attribute-set.service.d.ts.map +1 -1
- package/dist/backend/services/attribute-set.service.js +30 -4
- package/dist/backend/services/attribute-set.service.js.map +1 -1
- package/dist/backend/services/attribute-type-mapping.d.ts +2 -2
- package/dist/backend/services/attribute-type-mapping.d.ts.map +1 -1
- package/dist/backend/services/attribute-type-mapping.js +6 -0
- package/dist/backend/services/attribute-type-mapping.js.map +1 -1
- package/dist/backend/services/attribute-usage.d.ts +31 -0
- package/dist/backend/services/attribute-usage.d.ts.map +1 -0
- package/dist/backend/services/attribute-usage.js +29 -0
- package/dist/backend/services/attribute-usage.js.map +1 -0
- package/dist/backend/services/bulk-operation.service.d.ts.map +1 -1
- package/dist/backend/services/bulk-operation.service.js +12 -6
- package/dist/backend/services/bulk-operation.service.js.map +1 -1
- package/dist/backend/services/bundle.service.d.ts.map +1 -1
- package/dist/backend/services/bundle.service.js +19 -1
- package/dist/backend/services/bundle.service.js.map +1 -1
- package/dist/backend/services/catalog-admin-search.service.d.ts +3 -2
- package/dist/backend/services/catalog-admin-search.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-admin-search.service.js +6 -6
- package/dist/backend/services/catalog-admin-search.service.js.map +1 -1
- package/dist/backend/services/catalog-admin.service.d.ts +63 -12
- package/dist/backend/services/catalog-admin.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-admin.service.js +352 -189
- package/dist/backend/services/catalog-admin.service.js.map +1 -1
- package/dist/backend/services/catalog-attribute-read.service.d.ts +14 -0
- package/dist/backend/services/catalog-attribute-read.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-attribute-read.service.js +7 -19
- package/dist/backend/services/catalog-attribute-read.service.js.map +1 -1
- package/dist/backend/services/catalog-bulk-import.service.d.ts +52 -5
- package/dist/backend/services/catalog-bulk-import.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-bulk-import.service.js +190 -142
- package/dist/backend/services/catalog-bulk-import.service.js.map +1 -1
- package/dist/backend/services/catalog-bulk-update.service.d.ts +5 -3
- package/dist/backend/services/catalog-bulk-update.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-bulk-update.service.js +21 -8
- package/dist/backend/services/catalog-bulk-update.service.js.map +1 -1
- package/dist/backend/services/catalog-product-read.service.d.ts +11 -1
- package/dist/backend/services/catalog-product-read.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-product-read.service.js +37 -17
- package/dist/backend/services/catalog-product-read.service.js.map +1 -1
- package/dist/backend/services/catalog-query.service.d.ts +39 -8
- package/dist/backend/services/catalog-query.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-query.service.js +154 -116
- package/dist/backend/services/catalog-query.service.js.map +1 -1
- package/dist/backend/services/catalog-quick-search.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-quick-search.service.js +5 -5
- package/dist/backend/services/catalog-quick-search.service.js.map +1 -1
- package/dist/backend/services/catalog-write-ports.d.ts +14 -16
- package/dist/backend/services/catalog-write-ports.d.ts.map +1 -1
- package/dist/backend/services/catalog-write-ports.js +11 -70
- package/dist/backend/services/catalog-write-ports.js.map +1 -1
- package/dist/backend/services/category-admin.service.d.ts.map +1 -1
- package/dist/backend/services/category-admin.service.js +9 -1
- package/dist/backend/services/category-admin.service.js.map +1 -1
- package/dist/backend/services/content-attribute-rules.d.ts +49 -0
- package/dist/backend/services/content-attribute-rules.d.ts.map +1 -0
- package/dist/backend/services/content-attribute-rules.js +89 -0
- package/dist/backend/services/content-attribute-rules.js.map +1 -0
- package/dist/backend/services/effective-value.sql.d.ts +24 -38
- package/dist/backend/services/effective-value.sql.d.ts.map +1 -1
- package/dist/backend/services/effective-value.sql.js +37 -87
- package/dist/backend/services/effective-value.sql.js.map +1 -1
- package/dist/backend/services/gallery-scopes.d.ts +45 -22
- package/dist/backend/services/gallery-scopes.d.ts.map +1 -1
- package/dist/backend/services/gallery-scopes.js +116 -109
- package/dist/backend/services/gallery-scopes.js.map +1 -1
- package/dist/backend/services/gallery.service.d.ts +13 -27
- package/dist/backend/services/gallery.service.d.ts.map +1 -1
- package/dist/backend/services/gallery.service.js +75 -199
- package/dist/backend/services/gallery.service.js.map +1 -1
- package/dist/backend/services/grouped.service.d.ts.map +1 -1
- package/dist/backend/services/grouped.service.js +13 -1
- package/dist/backend/services/grouped.service.js.map +1 -1
- package/dist/backend/services/packaging-unit.service.d.ts.map +1 -1
- package/dist/backend/services/packaging-unit.service.js +7 -12
- package/dist/backend/services/packaging-unit.service.js.map +1 -1
- package/dist/backend/services/page-builder-content.d.ts +64 -0
- package/dist/backend/services/page-builder-content.d.ts.map +1 -0
- package/dist/backend/services/page-builder-content.js +113 -0
- package/dist/backend/services/page-builder-content.js.map +1 -0
- package/dist/backend/services/primary-asset-url.d.ts +6 -1
- package/dist/backend/services/primary-asset-url.d.ts.map +1 -1
- package/dist/backend/services/primary-asset-url.js +9 -4
- package/dist/backend/services/primary-asset-url.js.map +1 -1
- package/dist/backend/services/product-availability.service.d.ts +16 -3
- package/dist/backend/services/product-availability.service.d.ts.map +1 -1
- package/dist/backend/services/product-availability.service.js +58 -21
- package/dist/backend/services/product-availability.service.js.map +1 -1
- package/dist/backend/services/product-content.service.d.ts +62 -0
- package/dist/backend/services/product-content.service.d.ts.map +1 -0
- package/dist/backend/services/product-content.service.js +122 -0
- package/dist/backend/services/product-content.service.js.map +1 -0
- package/dist/backend/services/product-editor-preferences.service.d.ts +6 -0
- package/dist/backend/services/product-editor-preferences.service.d.ts.map +1 -1
- package/dist/backend/services/product-editor-preferences.service.js +12 -0
- package/dist/backend/services/product-editor-preferences.service.js.map +1 -1
- package/dist/backend/services/product-global-field-rules.d.ts +39 -0
- package/dist/backend/services/product-global-field-rules.d.ts.map +1 -0
- package/dist/backend/services/product-global-field-rules.js +84 -0
- package/dist/backend/services/product-global-field-rules.js.map +1 -0
- package/dist/backend/services/product-link.service.d.ts.map +1 -1
- package/dist/backend/services/product-link.service.js +14 -16
- package/dist/backend/services/product-link.service.js.map +1 -1
- package/dist/backend/services/product-list-view-service.d.ts.map +1 -1
- package/dist/backend/services/product-list-view-service.js +5 -8
- package/dist/backend/services/product-list-view-service.js.map +1 -1
- package/dist/backend/services/product-page-revalidation.d.ts +9 -0
- package/dist/backend/services/product-page-revalidation.d.ts.map +1 -1
- package/dist/backend/services/product-page-revalidation.js +19 -0
- package/dist/backend/services/product-page-revalidation.js.map +1 -1
- package/dist/backend/services/product-scopes.service.d.ts +15 -6
- package/dist/backend/services/product-scopes.service.d.ts.map +1 -1
- package/dist/backend/services/product-scopes.service.js +87 -33
- package/dist/backend/services/product-scopes.service.js.map +1 -1
- package/dist/backend/services/product-value-resolver.service.d.ts +2 -2
- package/dist/backend/services/product-value-resolver.service.d.ts.map +1 -1
- package/dist/backend/services/product-value-resolver.service.js +4 -7
- package/dist/backend/services/product-value-resolver.service.js.map +1 -1
- package/dist/backend/services/publication-window-sweep.d.ts +61 -7
- package/dist/backend/services/publication-window-sweep.d.ts.map +1 -1
- package/dist/backend/services/publication-window-sweep.js +106 -19
- package/dist/backend/services/publication-window-sweep.js.map +1 -1
- package/dist/backend/services/scheduled-work-probe.d.ts +34 -0
- package/dist/backend/services/scheduled-work-probe.d.ts.map +1 -0
- package/dist/backend/services/scheduled-work-probe.js +30 -0
- package/dist/backend/services/scheduled-work-probe.js.map +1 -0
- package/dist/backend/services/scope-completeness.d.ts +11 -11
- package/dist/backend/services/scope-completeness.d.ts.map +1 -1
- package/dist/backend/services/scope-completeness.js +26 -33
- package/dist/backend/services/scope-completeness.js.map +1 -1
- package/dist/backend/services/scope-overview.service.d.ts +24 -24
- package/dist/backend/services/scope-overview.service.d.ts.map +1 -1
- package/dist/backend/services/scope-overview.service.js +33 -76
- package/dist/backend/services/scope-overview.service.js.map +1 -1
- package/dist/backend/services/scoped-store-adapters.d.ts +58 -0
- package/dist/backend/services/scoped-store-adapters.d.ts.map +1 -0
- package/dist/backend/services/scoped-store-adapters.js +92 -0
- package/dist/backend/services/scoped-store-adapters.js.map +1 -0
- package/dist/backend/services/scoped-values-global-only.d.ts +36 -0
- package/dist/backend/services/scoped-values-global-only.d.ts.map +1 -0
- package/dist/backend/services/scoped-values-global-only.js +92 -0
- package/dist/backend/services/scoped-values-global-only.js.map +1 -0
- package/dist/backend/services/scoped-values-import.d.ts +86 -0
- package/dist/backend/services/scoped-values-import.d.ts.map +1 -0
- package/dist/backend/services/scoped-values-import.js +320 -0
- package/dist/backend/services/scoped-values-import.js.map +1 -0
- package/dist/backend/services/scoped-values-read.service.d.ts +56 -0
- package/dist/backend/services/scoped-values-read.service.d.ts.map +1 -0
- package/dist/backend/services/scoped-values-read.service.js +289 -0
- package/dist/backend/services/scoped-values-read.service.js.map +1 -0
- package/dist/backend/services/scoped-values-save.service.d.ts +79 -0
- package/dist/backend/services/scoped-values-save.service.d.ts.map +1 -0
- package/dist/backend/services/scoped-values-save.service.js +675 -0
- package/dist/backend/services/scoped-values-save.service.js.map +1 -0
- package/dist/backend/services/scoped-values-state.d.ts +94 -0
- package/dist/backend/services/scoped-values-state.d.ts.map +1 -0
- package/dist/backend/services/scoped-values-state.js +159 -0
- package/dist/backend/services/scoped-values-state.js.map +1 -0
- package/dist/backend/services/scoped-values.service.d.ts +36 -0
- package/dist/backend/services/scoped-values.service.d.ts.map +1 -0
- package/dist/backend/services/scoped-values.service.js +92 -0
- package/dist/backend/services/scoped-values.service.js.map +1 -0
- package/dist/backend/services/storefront-value-overrides.d.ts +7 -8
- package/dist/backend/services/storefront-value-overrides.d.ts.map +1 -1
- package/dist/backend/services/storefront-value-overrides.js +11 -14
- package/dist/backend/services/storefront-value-overrides.js.map +1 -1
- package/dist/backend/services/url-key-resolution.service.d.ts +12 -18
- package/dist/backend/services/url-key-resolution.service.d.ts.map +1 -1
- package/dist/backend/services/url-key-resolution.service.js +43 -43
- package/dist/backend/services/url-key-resolution.service.js.map +1 -1
- package/dist/backend/services/url-key.service.d.ts +87 -135
- package/dist/backend/services/url-key.service.d.ts.map +1 -1
- package/dist/backend/services/url-key.service.js +447 -619
- package/dist/backend/services/url-key.service.js.map +1 -1
- package/dist/manifest.d.ts +7 -1
- package/dist/manifest.d.ts.map +1 -1
- package/dist/manifest.js +34 -0
- package/dist/manifest.js.map +1 -1
- package/dist/migrations/20261030T113855_catalog_scope_model_texts.d.ts +36 -0
- package/dist/migrations/20261030T113855_catalog_scope_model_texts.d.ts.map +1 -0
- package/dist/migrations/20261030T113855_catalog_scope_model_texts.js +225 -0
- package/dist/migrations/20261030T113855_catalog_scope_model_texts.js.map +1 -0
- package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.d.ts +18 -0
- package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.d.ts.map +1 -0
- package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.js +39 -0
- package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.js.map +1 -0
- package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.d.ts +6 -0
- package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.d.ts.map +1 -0
- package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.js +119 -0
- package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.js.map +1 -0
- package/dist/migrations/20261030T113908_catalog_scope_model_media.d.ts +6 -0
- package/dist/migrations/20261030T113908_catalog_scope_model_media.d.ts.map +1 -0
- package/dist/migrations/20261030T113908_catalog_scope_model_media.js +185 -0
- package/dist/migrations/20261030T113908_catalog_scope_model_media.js.map +1 -0
- package/dist/migrations/20261104T121504_catalog_product_content_values.d.ts +36 -0
- package/dist/migrations/20261104T121504_catalog_product_content_values.d.ts.map +1 -0
- package/dist/migrations/20261104T121504_catalog_product_content_values.js +53 -0
- package/dist/migrations/20261104T121504_catalog_product_content_values.js.map +1 -0
- package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.d.ts +33 -0
- package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.d.ts.map +1 -0
- package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.js +58 -0
- package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.js.map +1 -0
- package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.d.ts +36 -0
- package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.d.ts.map +1 -0
- package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.js +40 -0
- package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.js.map +1 -0
- package/dist/migrations/index.d.ts +8 -1
- package/dist/migrations/index.d.ts.map +1 -1
- package/dist/migrations/index.js +15 -1
- package/dist/migrations/index.js.map +1 -1
- package/docs/catalog/attachments.md +53 -43
- package/docs/catalog/attribute-sets.md +2 -2
- package/docs/catalog/attributes.md +68 -8
- package/docs/catalog/category-content.md +3 -0
- package/docs/catalog/composite-products.md +2 -2
- package/docs/catalog/editing-a-product-at-a-scope.md +95 -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 +180 -0
- package/docs/catalog/product-links.md +2 -2
- package/docs/catalog/url-keys-and-redirects.md +79 -79
- package/docs/catalog.md +68 -14
- package/i18n/en.json +270 -270
- package/i18n/pl.json +272 -272
- package/package.json +11 -11
- 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/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/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/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/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-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/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/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/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-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
|
@@ -1,419 +1,92 @@
|
|
|
1
1
|
---
|
|
2
|
-
title:
|
|
2
|
+
title: Product scopes — Global, channel and channel × language
|
|
3
|
+
description: How a product value is set once for every channel and overridden per sales channel or per sales channel and language.
|
|
3
4
|
---
|
|
4
5
|
|
|
5
|
-
#
|
|
6
|
+
# Product scopes — Global, channel and channel × language
|
|
6
7
|
|
|
7
|
-
|
|
8
|
-
values. The same attribute key can hold up to four addressable slots
|
|
9
|
-
per product:
|
|
8
|
+
Every scoped product value lives at one of **three levels**:
|
|
10
9
|
|
|
11
|
-
-
|
|
12
|
-
-
|
|
13
|
-
-
|
|
14
|
-
- `channel+language` — one value per `(channel, language)` pair.
|
|
10
|
+
- **Global** — one value for every sales channel and every language;
|
|
11
|
+
- **Channel** — one value for one sales channel, in every language that channel offers;
|
|
12
|
+
- **Channel × language** — one value for one sales channel in one of its languages.
|
|
15
13
|
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
language-scoped via a backend constant
|
|
20
|
-
(`SYSTEM_ATTRIBUTE_SCOPES`). User-defined attributes default to
|
|
21
|
-
global-only and opt in via the attribute editor.
|
|
14
|
+
There is no language-only level. A translation is a Channel × language value, or a Channel value when the channel
|
|
15
|
+
sells in one language. A value is resolved from the narrowest level that holds one:
|
|
16
|
+
**Channel × language → Channel → Global**.
|
|
22
17
|
|
|
23
|
-
|
|
24
|
-
publication window, audience and order rules can differ per Sales Channel,
|
|
25
|
-
and its status per channel × language. That is described in
|
|
26
|
-
*Availability per sales channel and language* below. A product's URL keys per
|
|
27
|
-
language and per channel × language have their own page,
|
|
28
|
-
[URL Keys and Redirects](./url-keys-and-redirects.md).
|
|
18
|
+
## Which fields live where
|
|
29
19
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
A B2B catalog routinely needs to overlay channel-specific marketing
|
|
33
|
-
copy (wholesale vs. retail) and language-specific translation on the
|
|
34
|
-
same product. The legacy storage — JSONB on `products.name` /
|
|
35
|
-
`products.description` + a flat `products.attribute_values` JSONB —
|
|
36
|
-
could express only the language dimension. The four-scope model lifts
|
|
37
|
-
that ceiling without rewriting baseline storage; it adds a sibling
|
|
38
|
-
overrides table that holds the channel-aware slots, and a single
|
|
39
|
-
resolver function fuses the two on read.
|
|
40
|
-
|
|
41
|
-
## Storage shape
|
|
42
|
-
|
|
43
|
-
The global baseline keeps living where it has always lived:
|
|
44
|
-
|
|
45
|
-
- `products.name` (`Record<lang, string>` JSONB) — language-scoped.
|
|
46
|
-
- `products.description` (`Record<lang, string>` JSONB) — language-scoped.
|
|
47
|
-
- `products.attribute_values` (`Record<key, value>` JSONB) — global by
|
|
48
|
-
default. When the attribute's `languageScoped` flag is `true`, the
|
|
49
|
-
inner value is itself keyed by language: `Record<key, Record<lang,
|
|
50
|
-
value>>`.
|
|
51
|
-
|
|
52
|
-
Channel-aware slots land in a new table:
|
|
53
|
-
|
|
54
|
-
```sql
|
|
55
|
-
create table "product_value_overrides" (
|
|
56
|
-
"id" uuid primary key default gen_random_uuid(),
|
|
57
|
-
"product_id" uuid not null references "products"("id") on delete cascade,
|
|
58
|
-
"attribute_key" varchar(64) not null,
|
|
59
|
-
"channel_id" uuid not null references "sales_channels"("id") on delete cascade,
|
|
60
|
-
"language_code" varchar(16) null,
|
|
61
|
-
"value" jsonb not null, -- always wrapped { "v": <scalar | object> }
|
|
62
|
-
"created_at" timestamptz not null default now(),
|
|
63
|
-
"updated_at" timestamptz not null default now()
|
|
64
|
-
);
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
The (product, attribute, channel, language) tuple is unique under
|
|
68
|
-
**two partial indexes**:
|
|
69
|
-
|
|
70
|
-
```sql
|
|
71
|
-
create unique index "product_value_overrides_channel_only_uniq"
|
|
72
|
-
on "product_value_overrides" ("product_id", "attribute_key", "channel_id")
|
|
73
|
-
where "language_code" is null;
|
|
74
|
-
|
|
75
|
-
create unique index "product_value_overrides_channel_lang_uniq"
|
|
76
|
-
on "product_value_overrides" ("product_id", "attribute_key", "channel_id", "language_code")
|
|
77
|
-
where "language_code" is not null;
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
PostgreSQL treats `NULL` as distinct in a regular UNIQUE constraint, so
|
|
81
|
-
the only correct way to model "(channel, NULL) and (channel, NULL) are
|
|
82
|
-
the same row" is two partial indexes — one for each NULL semantic.
|
|
83
|
-
|
|
84
|
-
The lookup path used by the resolver in tight loops is a plain btree:
|
|
85
|
-
|
|
86
|
-
```sql
|
|
87
|
-
create index "product_value_overrides_product_attr_idx"
|
|
88
|
-
on "product_value_overrides" ("product_id", "attribute_key");
|
|
89
|
-
```
|
|
90
|
-
|
|
91
|
-
A second table — `product_editor_preferences` — stores the per-(admin
|
|
92
|
-
user, product) last-selected `(channelId, languageCode)` so the
|
|
93
|
-
product edit page seeds the switchers from the editor's prior visit.
|
|
94
|
-
It carries no FK to `sales_channels` so a deleted / un-assigned
|
|
95
|
-
channel is silently tolerated on read.
|
|
96
|
-
|
|
97
|
-
## The resolver
|
|
98
|
-
|
|
99
|
-
The single source of truth for "what value should I show?" lives in
|
|
100
|
-
`packages/contracts/src/product-value-resolver.ts`. The same TypeScript
|
|
101
|
-
file is imported by the backend (admin endpoints, storefront read
|
|
102
|
-
path, search indexer) and the admin SPA. By construction, the admin's
|
|
103
|
-
effective-value preview cannot drift from what the storefront renders.
|
|
104
|
-
|
|
105
|
-
The algorithm — `resolveAttribute({ baseline, overrides, scope, ctx })`
|
|
106
|
-
— walks four steps:
|
|
107
|
-
|
|
108
|
-
1. `(channel + language)` slot — when the attribute is channel-scoped
|
|
109
|
-
AND language-scoped AND the context carries both;
|
|
110
|
-
2. `(channel-only)` slot — when channel-scoped AND a channel is in the
|
|
111
|
-
context;
|
|
112
|
-
3. `(global + language)` baseline — for language-scoped attributes,
|
|
113
|
-
pick the requested language out of the JSONB;
|
|
114
|
-
4. `(global)` baseline — single value (or primary-language pick for
|
|
115
|
-
language-scoped attrs).
|
|
116
|
-
|
|
117
|
-
The first non-empty slot wins. Empty string, `null`, empty object,
|
|
118
|
-
empty array are all treated as "absent" and fall through. The function
|
|
119
|
-
returns both the resolved value AND a `source` tag indicating which
|
|
120
|
-
slot produced the answer — the admin UI consumes this to render the
|
|
121
|
-
"channel + language override" / "global baseline" badge per field.
|
|
122
|
-
|
|
123
|
-
### Orphan tolerance
|
|
124
|
-
|
|
125
|
-
An administrator can flip an attribute's `channelScoped` flag back to
|
|
126
|
-
`false` after channel overrides have already been written. The
|
|
127
|
-
resolver simply skips override rows whose attribute is no longer
|
|
128
|
-
channel-scoped, so the storefront falls back to the baseline without
|
|
129
|
-
any data-loss event. A future maintenance pass can drop orphan rows;
|
|
130
|
-
this feature does not require it.
|
|
131
|
-
|
|
132
|
-
## Write path
|
|
133
|
-
|
|
134
|
-
Channel-aware overrides land through one admin endpoint:
|
|
135
|
-
|
|
136
|
-
```
|
|
137
|
-
PATCH /api/v1/admin/catalog/products/:id/value-overrides
|
|
138
|
-
{
|
|
139
|
-
"upserts": [
|
|
140
|
-
{ "attributeKey": "name", "channelId": "<vip-uuid>", "languageCode": "en-US", "value": { "v": "VIP wholesale name (EN)" } },
|
|
141
|
-
{ "attributeKey": "description", "channelId": "<vip-uuid>", "languageCode": "pl-PL", "value": { "v": "Wholesale-only Polish copy" } }
|
|
142
|
-
],
|
|
143
|
-
"deletes": [
|
|
144
|
-
{ "attributeKey": "description", "channelId": "<retail-uuid>", "languageCode": "en-US" }
|
|
145
|
-
]
|
|
146
|
-
}
|
|
147
|
-
```
|
|
148
|
-
|
|
149
|
-
All requested operations run in a single `em.transactional` pass.
|
|
150
|
-
The handler validates every entry up front against six rules and
|
|
151
|
-
rolls everything back on the first failure:
|
|
152
|
-
|
|
153
|
-
| 422 code | Triggered when |
|
|
154
|
-
| ----------------------------------- | -------------- |
|
|
155
|
-
| `attribute_unknown` | `attributeKey` is neither a system attr (`name`, `description`) nor a row in `product_attributes`. |
|
|
156
|
-
| `attribute_not_channel_scoped` | the attribute's `channelScoped=false`, so it has no channel slot. |
|
|
157
|
-
| `attribute_missing_language` | the attribute's `languageScoped=true`, but the slot has `languageCode=null`. |
|
|
158
|
-
| `channel_not_assigned_to_product` | `channelId` is not in `sales_channel_products` for the product. |
|
|
159
|
-
| `language_not_in_channel` | `languageCode` is non-null and not in the channel's `SalesChannel.languages` array. |
|
|
160
|
-
| `value_invalid` | the wrapped `value.v` does not match the attribute's `valueType`. |
|
|
161
|
-
|
|
162
|
-
The baseline write path (Name / Description per language; global
|
|
163
|
-
`attribute_values`) is unchanged — editors still use the existing
|
|
164
|
-
locale-side-by-side inputs on the Details tab. Channel overrides are
|
|
165
|
-
additive.
|
|
166
|
-
|
|
167
|
-
## Read paths
|
|
168
|
-
|
|
169
|
-
These consumers go through the resolver:
|
|
170
|
-
|
|
171
|
-
- **Admin endpoint** — `GET /api/v1/admin/catalog/products/:id?channelId=&languageCode=&includeOverridesMap=true`
|
|
172
|
-
returns the baseline product PLUS, when context params are passed, a
|
|
173
|
-
`resolved` block with `name`, `description`, `attributeValues`,
|
|
174
|
-
`sources`. When `includeOverridesMap=true`, the full override list
|
|
175
|
-
is attached for client-side switcher previews.
|
|
176
|
-
- **Storefront public read** — pulls the channel from the
|
|
177
|
-
`x-sales-channel` header (the existing convention) and
|
|
178
|
-
the language from `Accept-Language`, else the channel's default
|
|
179
|
-
language. The override layer is invisible to the public client: it
|
|
180
|
-
receives the effective value. The product page (name, description,
|
|
181
|
-
SEO fields, attribute values, the product-page attribute list, grouped
|
|
182
|
-
children and bundle options) and every listing card walk the storefront's own baseline language pick — requested
|
|
183
|
-
language, then the channel's default language, then `en-US`, `en` and
|
|
184
|
-
the first stored language — and at each language take the
|
|
185
|
-
`(channel + language)` slot if it is filled, else stop there if the
|
|
186
|
-
baseline has text for that language. An override therefore answers
|
|
187
|
-
only for the language whose baseline text the page would show, or an
|
|
188
|
-
earlier one in that order: a request in `en-US` on a channel whose
|
|
189
|
-
default is `pl-PL` shows the `en-US` baseline, not the `pl-PL`
|
|
190
|
-
override, while a `de-DE` request for a product with no `de-DE` text
|
|
191
|
-
falls through to `pl-PL` and shows its override. The `(channel-only)`
|
|
192
|
-
slot is asked last and wins over the baseline wherever the walk
|
|
193
|
-
stopped. Product-link tiles keep their own language pick, which has
|
|
194
|
-
no channel-default leg, and walk the override slots over it, so a
|
|
195
|
-
tile can show the `en-US` baseline where the listing card shows the
|
|
196
|
-
channel default's override. A product without overrides shows exactly what
|
|
197
|
-
it showed before. On the listing's Postgres path, `sort=name` orders by
|
|
198
|
-
the effective name at the request's channel and language (ties by id),
|
|
199
|
-
free text `q` matches the effective name and the effective values of
|
|
200
|
-
searchable attributes, and `filter[attr.*]` and the facet counts use the
|
|
201
|
-
channel's effective values at the request language. When the `search`
|
|
202
|
-
module answers the listing, it sorts by the name indexed in the channel's
|
|
203
|
-
default language (see the `search` module's page).
|
|
204
|
-
- **Search indexer (Meilisearch)** — builds one document per
|
|
205
|
-
`(product, channel)` pair. Each document's `name` and `description`
|
|
206
|
-
fields are run through the resolver with `channel.defaultLanguage`
|
|
207
|
-
as the active language, so per-channel overrides flow into
|
|
208
|
-
storefront search ranking and name sorting.
|
|
209
|
-
- **Search result cards** — the search module re-reads every hit from
|
|
210
|
-
Postgres before it answers, and the card name it shows is resolved
|
|
211
|
-
there, not taken from the index: the request's sales channel override
|
|
212
|
-
rows are read once per results page and the card walks the same
|
|
213
|
-
languages and slots, in the same order, as a listing card above. The indexed name is
|
|
214
|
-
resolved for the channel's default language only, so it would be
|
|
215
|
-
wrong for a request in any other language. A product without an
|
|
216
|
-
override for the channel shows exactly what it showed before.
|
|
217
|
-
|
|
218
|
-
## Admin UI
|
|
219
|
-
|
|
220
|
-
The product edit page's **Details** tab gains a
|
|
221
|
-
`<ProductScopeEditor>` panel above the existing locale inputs. It:
|
|
222
|
-
|
|
223
|
-
1. Loads `GET /scope-context` (channels assigned to the product + each
|
|
224
|
-
channel's languages + the platform primary admin language + the
|
|
225
|
-
editor's remembered preference) and `GET /value-overrides` in
|
|
226
|
-
parallel.
|
|
227
|
-
2. Renders a Sales Channel switcher (Global + each assigned channel)
|
|
228
|
-
and a Language switcher narrowed to the active channel's languages
|
|
229
|
-
(or the union of all channel languages when Global).
|
|
230
|
-
3. Shows the resolved Name + Description for the active context with a
|
|
231
|
-
source badge per field — `channel + language override` / `channel
|
|
232
|
-
override` / `global baseline (language)` / `global baseline
|
|
233
|
-
(fallback)` / `no value`.
|
|
234
|
-
4. Offers "Add override" / "Edit override" / "Use inherited"
|
|
235
|
-
affordances per field. Edits go through `PATCH /value-overrides`
|
|
236
|
-
with optimistic refresh.
|
|
237
|
-
5. Persists the editor's `(channel, language)` selection back via
|
|
238
|
-
`PUT /editor-preference` (debounced, best-effort) so the next visit
|
|
239
|
-
seeds the same context.
|
|
240
|
-
|
|
241
|
-
Edit affordances are gated on a specific channel being selected.
|
|
242
|
-
Under Global / no channel, the panel is read-only and a help string
|
|
243
|
-
explains that overrides only apply per-channel.
|
|
244
|
-
|
|
245
|
-
## Availability per sales channel and language
|
|
246
|
-
|
|
247
|
-
A product is **available** to a buyer at a sales channel C and language L when
|
|
248
|
-
all of these hold:
|
|
249
|
-
|
|
250
|
-
1. it is a member of C and not archived;
|
|
251
|
-
2. its effective **status** at (C, L) is `active`;
|
|
252
|
-
3. now is inside its effective **publication window** (both ends included);
|
|
253
|
-
4. its effective **audience** admits the buyer.
|
|
254
|
-
|
|
255
|
-
L is the first `Accept-Language` tag of the request matched to C's languages,
|
|
256
|
-
else C's default language. Every buyer-facing read asks this one rule — the
|
|
257
|
-
listing and its price range, facet and category counts, the product page,
|
|
258
|
-
product links, grouped children and bundle options, the quick search, search,
|
|
259
|
-
the sitemap, product feeds — and so do the places a product is acquired: the
|
|
260
|
-
basket, checkout and placement, quote requests, quick order and the external
|
|
261
|
-
order intake. A product that is not available answers exactly as a product
|
|
262
|
-
that does not exist (`404 PRODUCT_NOT_FOUND`); whether one exists, is off, is
|
|
263
|
-
outside its window or is restricted cannot be told apart. An archived product
|
|
264
|
-
is the exception described under *Product status and archiving* on the
|
|
265
|
-
[Catalog](../catalog.md#product-status-and-archiving) page.
|
|
266
|
-
|
|
267
|
-
### Scopes and inheritance
|
|
268
|
-
|
|
269
|
-
| Field | Global | Sales channel | Channel × language |
|
|
20
|
+
| Field | Global | Channel | Channel × language |
|
|
270
21
|
| --- | --- | --- | --- |
|
|
271
|
-
|
|
|
272
|
-
|
|
|
273
|
-
|
|
|
274
|
-
|
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
[
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
table is on the [URL Keys and Redirects](./url-keys-and-redirects.md#integrations)
|
|
343
|
-
page. Setting one channel's status on many products at once is the bulk edit's
|
|
344
|
-
*Status per channel and language* — see the
|
|
345
|
-
[Catalog](../catalog.md#status-per-channel-and-language-in-bulk) page.
|
|
346
|
-
|
|
347
|
-
In the product editor these are the **scope controls** under the channel
|
|
348
|
-
switcher on the Details tab (status per channel and per language, window,
|
|
349
|
-
audience) and **Order rules per channel** on the Inventory tab; all are
|
|
350
|
-
read-only without `catalog:write`.
|
|
351
|
-
|
|
352
|
-
### Scope overview
|
|
353
|
-
|
|
354
|
-
`GET /api/v1/admin/catalog/products/:id/scope-overview` (`catalog:read`) lays a
|
|
355
|
-
product out as its channels × languages, and the product editor's **Scopes**
|
|
356
|
-
tab shows it. Each cell carries:
|
|
357
|
-
|
|
358
|
-
- the effective status and where it comes from (`channel_language`,
|
|
359
|
-
`channel` or `global`);
|
|
360
|
-
- whether the product is available there now — a member, the language offered,
|
|
361
|
-
on, inside its window, not archived; the audience is shown as a rule, not
|
|
362
|
-
evaluated for anybody;
|
|
363
|
-
- every field overridden at that cell and the level it comes from — `status`,
|
|
364
|
-
`window`, `audience`, `minOrderQuantity`, `returnable`, `name`,
|
|
365
|
-
`description`, `attribute:<key>`, `urlKey`, and the media, attachment,
|
|
366
|
-
packaging-unit and SEO fields set per channel or language;
|
|
367
|
-
- `missing` — what the completeness check would report there, whatever the
|
|
368
|
-
cell's status.
|
|
369
|
-
|
|
370
|
-
Overrides that no longer apply are listed under `orphans` with a reason:
|
|
371
|
-
`not_a_member`, `language_not_offered` or `attribute_scope_changed`. On the
|
|
372
|
-
Scopes tab a scope value, a value override or a URL key is returned to the
|
|
373
|
-
inherited value with **Use inherited** where it is set — a channel's own values
|
|
374
|
-
in its "Whole channel" column, a language's own values in the "Every channel"
|
|
375
|
-
row — and an orphan (listed under **No longer applies**) is deleted; the tab
|
|
376
|
-
calls the endpoint that owns the value (`…/scopes`, `…/value-overrides` or
|
|
377
|
-
`…/url-keys`). Resetting a text value (a name, a description, a URL key, an SEO
|
|
378
|
-
field) and deleting an orphan ask first, naming the field and the scope; other
|
|
379
|
-
values reset in one click. A product in no sales channel answers no channels and
|
|
380
|
-
every active platform language.
|
|
381
|
-
|
|
382
|
-
Before an attribute's `channelScoped` or `languageScoped` flag is turned off,
|
|
383
|
-
`GET /api/v1/admin/catalog/attributes/:idOrKey/scope-change-preview?channelScoped=&languageScoped=`
|
|
384
|
-
answers how many value overrides would stop applying, in total and per
|
|
385
|
-
channel. The change keeps the rows; they become orphans.
|
|
386
|
-
|
|
387
|
-
### Storage
|
|
388
|
-
|
|
389
|
-
`product_channel_scopes` holds one row per product and channel with the status,
|
|
390
|
-
window, audience, minimum order quantity and returnable flag (`NULL` inherits);
|
|
391
|
-
`product_channel_language_scopes` holds the status per channel × language.
|
|
392
|
-
Both cascade on the product's and the channel's delete
|
|
393
|
-
(`20261022T035133_catalog_product_scopes.ts`, with the global window columns
|
|
394
|
-
`products.publish_from` and `publish_until`; no backfill).
|
|
395
|
-
|
|
396
|
-
## Migration
|
|
397
|
-
|
|
398
|
-
One migration `20260611T140346_catalog_product_value_overrides_init.ts` ships everything:
|
|
399
|
-
|
|
400
|
-
- adds `channel_scoped` + `language_scoped` boolean columns to
|
|
401
|
-
`product_attributes` (default `false`);
|
|
402
|
-
- creates `product_value_overrides` with the two partial UNIQUE
|
|
403
|
-
indexes and the `(product_id, attribute_key)` btree;
|
|
404
|
-
- creates `product_editor_preferences` (composite PK
|
|
405
|
-
`(admin_user_id, product_id)`).
|
|
406
|
-
|
|
407
|
-
No baseline data migration. No data backfill. The `down()` is the
|
|
408
|
-
exact inverse — drop the two tables and the two columns.
|
|
409
|
-
|
|
410
|
-
## What is not in scope
|
|
411
|
-
|
|
412
|
-
- **User-defined attribute overrides in the admin UI** — the panel
|
|
413
|
-
surfaces only the system Name + Description today. User attribute
|
|
414
|
-
overrides are accepted by the PATCH endpoint and resolved on read,
|
|
415
|
-
but the admin SPA does not yet expose a write affordance for them.
|
|
416
|
-
- **Channel-aware reindex enqueue** — the PATCH endpoint does not
|
|
417
|
-
yet enqueue a Meilisearch reindex job per touched channel; the
|
|
418
|
-
next per-product upsert (driven by any catalog mutation) picks it
|
|
419
|
-
up. A dedicated reindex on override write is a small follow-up.
|
|
22
|
+
| Name, description | yes | yes | yes |
|
|
23
|
+
| Text attributes marked *scopable* | yes | yes | yes |
|
|
24
|
+
| Other scopable attributes (numbers, selects, booleans) | yes | yes | — |
|
|
25
|
+
| Attributes not marked scopable | yes | — | — |
|
|
26
|
+
| Status | yes | yes | yes |
|
|
27
|
+
| Publication window, audience, minimum order quantity, returnable | yes | yes | — |
|
|
28
|
+
| URL key | yes | yes | yes |
|
|
29
|
+
| Gallery alt text, hide image, gallery roles | yes | yes | yes |
|
|
30
|
+
| Attachment name, description, hidden | yes | yes | yes |
|
|
31
|
+
| Packaging-unit name | yes | yes | yes |
|
|
32
|
+
| SEO title, description, Open Graph fields (owned by the `seo` module) | yes | yes | yes |
|
|
33
|
+
|
|
34
|
+
SKU, type, attribute set, categories, stock settings and the download file have one value for the whole product and
|
|
35
|
+
are edited at Global only. Writing one of them at another scope is refused with `GLOBAL_ONLY_FIELD`; writing a field
|
|
36
|
+
at a level it does not support is refused with `FIELD_NOT_AT_SCOPE`.
|
|
37
|
+
|
|
38
|
+
## Inherit, a value, or deliberately empty
|
|
39
|
+
|
|
40
|
+
At Channel and Channel × language each field is in one of three states:
|
|
41
|
+
|
|
42
|
+
- **Inherits** — the editor shows "Use value from *parent scope*" and the effective value comes from the level above;
|
|
43
|
+
- **Own value** — the value stored at this scope;
|
|
44
|
+
- **Deliberately empty** — an override that is empty on purpose. It stops the chain: a description emptied for one
|
|
45
|
+
channel stays empty there even though Global has one. A required field (the name, a required attribute) cannot be
|
|
46
|
+
emptied.
|
|
47
|
+
|
|
48
|
+
## The write encoding
|
|
49
|
+
|
|
50
|
+
Every writer — the editor's save, the import files and the PIM connector port — uses one encoding:
|
|
51
|
+
|
|
52
|
+
| Intent | JSON | CSV cell |
|
|
53
|
+
| --- | --- | --- |
|
|
54
|
+
| No change | the field absent, or `""` | an empty cell |
|
|
55
|
+
| Deliberately empty | `null` | `NULL` (the whole cell) |
|
|
56
|
+
| Remove the own value and inherit | `{ "inherit": true }` | `INHERIT` (the whole cell) |
|
|
57
|
+
| A value | the value | the text; `\NULL` and `\INHERIT` are the literal words |
|
|
58
|
+
|
|
59
|
+
This is **not** JSON Merge Patch, where `null` removes a member: here `null` stores an empty override and only
|
|
60
|
+
`{ "inherit": true }` removes one. It is also not Magento's `__EMPTY__VALUE__` marker. `INHERIT` at Global and an
|
|
61
|
+
empty required field are refused with `SCOPED_VALUE_INVALID`.
|
|
62
|
+
|
|
63
|
+
## Reading and saving a scope
|
|
64
|
+
|
|
65
|
+
- `GET /api/v1/admin/catalog/products/:id/scoped-values?channelId=&languageCode=` (`catalog:read`) answers every
|
|
66
|
+
field's effective value at the scope, its source (`set`, `set_empty`, `inherited_channel`, `inherited_global`,
|
|
67
|
+
`absent`), the levels it supports, what the completeness check misses at that scope and the product's
|
|
68
|
+
`version`.
|
|
69
|
+
- `PUT /api/v1/admin/catalog/products/:id/scoped-values` (`catalog:write`) saves one scope in one Command with one
|
|
70
|
+
audit entry. The body carries the `version` the editor read; a save made against an older version is refused with
|
|
71
|
+
`409 VERSION_CONFLICT`, so two operators never overwrite each other silently.
|
|
72
|
+
- `POST …/scoped-values/copy` copies one Channel × language value to other channels of the product.
|
|
73
|
+
|
|
74
|
+
## Channels a product leaves
|
|
75
|
+
|
|
76
|
+
A value stored for a channel the product is no longer sold on, or for a language the channel no longer offers, is
|
|
77
|
+
kept but ignored. The scope map lists such rows so they can be removed; they come back into effect if the
|
|
78
|
+
product returns to that channel or language.
|
|
79
|
+
|
|
80
|
+
## Duplicating a product
|
|
81
|
+
|
|
82
|
+
**Duplicate** copies the product's values at every scope — Global, Channel and Channel × language, deliberately empty
|
|
83
|
+
values and inherit states included — for every field family above, in one audited Command. Two things are not
|
|
84
|
+
copied: URL keys (the copy gets a fresh Global key, because a key is one product's per channel) and status (the copy
|
|
85
|
+
starts inactive everywhere, so it is reviewed before it is sold).
|
|
86
|
+
|
|
87
|
+
## Related pages
|
|
88
|
+
|
|
89
|
+
- [Editing a product at a scope](./editing-a-product-at-a-scope.md) — the scope switcher, inherit and the Scope map in the editor.
|
|
90
|
+
- [URL Keys and Redirects](./url-keys-and-redirects.md) — key uniqueness per channel and redirects.
|
|
91
|
+
- [Gallery and Labels](./gallery-and-labels.md), [Attachments](./attachments.md),
|
|
92
|
+
[Packaging Units](./packaging-units.md) — the media and packaging values per scope.
|