@endora-commerce/mod-catalog 0.107.0 → 0.109.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/admin/components/AttachmentScopesDialog.d.ts +22 -0
- package/dist/admin/components/AttachmentScopesDialog.d.ts.map +1 -0
- package/dist/admin/components/AttachmentScopesDialog.js +70 -0
- package/dist/admin/components/AttachmentScopesDialog.js.map +1 -0
- package/dist/admin/components/PackagingUnitsEditor.d.ts +10 -1
- package/dist/admin/components/PackagingUnitsEditor.d.ts.map +1 -1
- package/dist/admin/components/PackagingUnitsEditor.js +127 -10
- package/dist/admin/components/PackagingUnitsEditor.js.map +1 -1
- package/dist/admin/components/ProductAttachmentsSection.d.ts +5 -0
- package/dist/admin/components/ProductAttachmentsSection.d.ts.map +1 -0
- package/dist/admin/components/ProductAttachmentsSection.js +137 -0
- package/dist/admin/components/ProductAttachmentsSection.js.map +1 -0
- package/dist/admin/components/ProductGallerySection.d.ts +14 -0
- package/dist/admin/components/ProductGallerySection.d.ts.map +1 -0
- package/dist/admin/components/ProductGallerySection.js +385 -0
- package/dist/admin/components/ProductGallerySection.js.map +1 -0
- package/dist/admin/components/ProductOrderRulesCard.d.ts +19 -0
- package/dist/admin/components/ProductOrderRulesCard.d.ts.map +1 -0
- package/dist/admin/components/ProductOrderRulesCard.js +275 -0
- package/dist/admin/components/ProductOrderRulesCard.js.map +1 -0
- package/dist/admin/components/ProductScopeControls.d.ts +31 -0
- package/dist/admin/components/ProductScopeControls.d.ts.map +1 -0
- package/dist/admin/components/ProductScopeControls.js +243 -0
- package/dist/admin/components/ProductScopeControls.js.map +1 -0
- package/dist/admin/components/ProductScopeEditor.d.ts +12 -18
- package/dist/admin/components/ProductScopeEditor.d.ts.map +1 -1
- package/dist/admin/components/ProductScopeEditor.js +5 -4
- package/dist/admin/components/ProductScopeEditor.js.map +1 -1
- package/dist/admin/components/ProductScopeOverview.d.ts +26 -0
- package/dist/admin/components/ProductScopeOverview.d.ts.map +1 -0
- package/dist/admin/components/ProductScopeOverview.js +207 -0
- package/dist/admin/components/ProductScopeOverview.js.map +1 -0
- package/dist/admin/components/ProductStatusPills.d.ts +17 -0
- package/dist/admin/components/ProductStatusPills.d.ts.map +1 -0
- package/dist/admin/components/ProductStatusPills.js +23 -0
- package/dist/admin/components/ProductStatusPills.js.map +1 -0
- package/dist/admin/components/ProductUrlKeysPanel.d.ts +17 -0
- package/dist/admin/components/ProductUrlKeysPanel.d.ts.map +1 -0
- package/dist/admin/components/ProductUrlKeysPanel.js +215 -0
- package/dist/admin/components/ProductUrlKeysPanel.js.map +1 -0
- package/dist/admin/components/ProductsBulkEditDialog.d.ts +30 -0
- package/dist/admin/components/ProductsBulkEditDialog.d.ts.map +1 -1
- package/dist/admin/components/ProductsBulkEditDialog.js +308 -125
- package/dist/admin/components/ProductsBulkEditDialog.js.map +1 -1
- package/dist/admin/components/ScopedDialogParts.d.ts +23 -0
- package/dist/admin/components/ScopedDialogParts.d.ts.map +1 -0
- package/dist/admin/components/ScopedDialogParts.js +16 -0
- package/dist/admin/components/ScopedDialogParts.js.map +1 -0
- package/dist/admin/index.d.ts +2 -2
- package/dist/admin/index.d.ts.map +1 -1
- package/dist/admin/index.js +9 -0
- package/dist/admin/index.js.map +1 -1
- package/dist/admin/lib/attribute-scope.d.ts +20 -0
- package/dist/admin/lib/attribute-scope.d.ts.map +1 -0
- package/dist/admin/lib/attribute-scope.js +18 -0
- package/dist/admin/lib/attribute-scope.js.map +1 -0
- package/dist/admin/lib/bulk-operation-log-text.d.ts +9 -0
- package/dist/admin/lib/bulk-operation-log-text.d.ts.map +1 -0
- package/dist/admin/lib/bulk-operation-log-text.js +13 -0
- package/dist/admin/lib/bulk-operation-log-text.js.map +1 -0
- package/dist/admin/lib/media-scopes.d.ts +41 -0
- package/dist/admin/lib/media-scopes.d.ts.map +1 -0
- package/dist/admin/lib/media-scopes.js +66 -0
- package/dist/admin/lib/media-scopes.js.map +1 -0
- package/dist/admin/lib/product-labels.d.ts +14 -0
- package/dist/admin/lib/product-labels.d.ts.map +1 -0
- package/dist/admin/lib/product-labels.js +27 -0
- package/dist/admin/lib/product-labels.js.map +1 -0
- package/dist/admin/lib/product-scope-drafts.d.ts +77 -0
- package/dist/admin/lib/product-scope-drafts.d.ts.map +1 -0
- package/dist/admin/lib/product-scope-drafts.js +133 -0
- package/dist/admin/lib/product-scope-drafts.js.map +1 -0
- package/dist/admin/lib/product-scopes-api.d.ts +40 -0
- package/dist/admin/lib/product-scopes-api.d.ts.map +1 -0
- package/dist/admin/lib/product-scopes-api.js +101 -0
- package/dist/admin/lib/product-scopes-api.js.map +1 -0
- package/dist/admin/lib/product-url-keys-api.d.ts +46 -0
- package/dist/admin/lib/product-url-keys-api.d.ts.map +1 -0
- package/dist/admin/lib/product-url-keys-api.js +110 -0
- package/dist/admin/lib/product-url-keys-api.js.map +1 -0
- package/dist/admin/lib/resolve-product-selection.d.ts +29 -1
- package/dist/admin/lib/resolve-product-selection.d.ts.map +1 -1
- package/dist/admin/lib/resolve-product-selection.js +42 -6
- package/dist/admin/lib/resolve-product-selection.js.map +1 -1
- package/dist/admin/lib/scope-overview.d.ts +74 -0
- package/dist/admin/lib/scope-overview.d.ts.map +1 -0
- package/dist/admin/lib/scope-overview.js +173 -0
- package/dist/admin/lib/scope-overview.js.map +1 -0
- package/dist/admin/pages/AttributesManager.d.ts.map +1 -1
- package/dist/admin/pages/AttributesManager.js +84 -7
- package/dist/admin/pages/AttributesManager.js.map +1 -1
- package/dist/admin/pages/BulkOperationDetailPage.d.ts.map +1 -1
- package/dist/admin/pages/BulkOperationDetailPage.js +4 -19
- package/dist/admin/pages/BulkOperationDetailPage.js.map +1 -1
- package/dist/admin/pages/ProductEditor.d.ts +0 -4
- package/dist/admin/pages/ProductEditor.d.ts.map +1 -1
- package/dist/admin/pages/ProductEditor.js +221 -374
- package/dist/admin/pages/ProductEditor.js.map +1 -1
- package/dist/admin/pages/ProductsList.d.ts +12 -0
- package/dist/admin/pages/ProductsList.d.ts.map +1 -1
- package/dist/admin/pages/ProductsList.js +105 -38
- package/dist/admin/pages/ProductsList.js.map +1 -1
- package/dist/backend/admin-search-provider.d.ts +1 -1
- package/dist/backend/admin-search-provider.d.ts.map +1 -1
- package/dist/backend/admin-search-provider.js +1 -2
- package/dist/backend/admin-search-provider.js.map +1 -1
- package/dist/backend/demo/reset.d.ts +1 -1
- package/dist/backend/demo/rows.d.ts +14 -3
- package/dist/backend/demo/rows.d.ts.map +1 -1
- package/dist/backend/demo/rows.js +24 -17
- package/dist/backend/demo/rows.js.map +1 -1
- package/dist/backend/demo/seed.d.ts.map +1 -1
- package/dist/backend/demo/seed.js +3 -6
- package/dist/backend/demo/seed.js.map +1 -1
- package/dist/backend/entities/bulk-operation.entity.d.ts +10 -0
- package/dist/backend/entities/bulk-operation.entity.d.ts.map +1 -1
- package/dist/backend/entities/bulk-operation.entity.js.map +1 -1
- package/dist/backend/entities/gallery-item-channel-hidden.entity.d.ts +14 -0
- package/dist/backend/entities/gallery-item-channel-hidden.entity.d.ts.map +1 -0
- package/dist/backend/entities/gallery-item-channel-hidden.entity.js +42 -0
- package/dist/backend/entities/gallery-item-channel-hidden.entity.js.map +1 -0
- package/dist/backend/entities/gallery-item-channel-label.entity.d.ts +18 -0
- package/dist/backend/entities/gallery-item-channel-label.entity.d.ts.map +1 -0
- package/dist/backend/entities/gallery-item-channel-label.entity.js +49 -0
- package/dist/backend/entities/gallery-item-channel-label.entity.js.map +1 -0
- package/dist/backend/entities/gallery-item.entity.d.ts +8 -1
- package/dist/backend/entities/gallery-item.entity.d.ts.map +1 -1
- package/dist/backend/entities/gallery-item.entity.js +11 -0
- package/dist/backend/entities/gallery-item.entity.js.map +1 -1
- package/dist/backend/entities/product-attachment-channel-hidden.entity.d.ts +13 -0
- package/dist/backend/entities/product-attachment-channel-hidden.entity.d.ts.map +1 -0
- package/dist/backend/entities/product-attachment-channel-hidden.entity.js +41 -0
- package/dist/backend/entities/product-attachment-channel-hidden.entity.js.map +1 -0
- package/dist/backend/entities/product-attachment.entity.d.ts +8 -1
- package/dist/backend/entities/product-attachment.entity.d.ts.map +1 -1
- package/dist/backend/entities/product-attachment.entity.js +15 -0
- package/dist/backend/entities/product-attachment.entity.js.map +1 -1
- package/dist/backend/entities/product-channel-language-scope.entity.d.ts +23 -0
- package/dist/backend/entities/product-channel-language-scope.entity.d.ts.map +1 -0
- package/dist/backend/entities/product-channel-language-scope.entity.js +61 -0
- package/dist/backend/entities/product-channel-language-scope.entity.js.map +1 -0
- package/dist/backend/entities/product-channel-scope.entity.d.ts +42 -0
- package/dist/backend/entities/product-channel-scope.entity.d.ts.map +1 -0
- package/dist/backend/entities/product-channel-scope.entity.js +104 -0
- package/dist/backend/entities/product-channel-scope.entity.js.map +1 -0
- package/dist/backend/entities/product-packaging-unit.entity.d.ts +13 -1
- package/dist/backend/entities/product-packaging-unit.entity.d.ts.map +1 -1
- package/dist/backend/entities/product-packaging-unit.entity.js +20 -0
- package/dist/backend/entities/product-packaging-unit.entity.js.map +1 -1
- package/dist/backend/entities/product-url-key.entity.d.ts +32 -0
- package/dist/backend/entities/product-url-key.entity.d.ts.map +1 -0
- package/dist/backend/entities/product-url-key.entity.js +75 -0
- package/dist/backend/entities/product-url-key.entity.js.map +1 -0
- package/dist/backend/entities/product-url-redirect.entity.d.ts +23 -0
- package/dist/backend/entities/product-url-redirect.entity.d.ts.map +1 -0
- package/dist/backend/entities/product-url-redirect.entity.js +58 -0
- package/dist/backend/entities/product-url-redirect.entity.js.map +1 -0
- package/dist/backend/entities/product-variant.entity.d.ts +1 -2
- package/dist/backend/entities/product-variant.entity.d.ts.map +1 -1
- package/dist/backend/entities/product-variant.entity.js +0 -5
- package/dist/backend/entities/product-variant.entity.js.map +1 -1
- package/dist/backend/entities/product.entity.d.ts +41 -2
- package/dist/backend/entities/product.entity.d.ts.map +1 -1
- package/dist/backend/entities/product.entity.js +84 -1
- package/dist/backend/entities/product.entity.js.map +1 -1
- package/dist/backend/index.d.ts +27 -6
- package/dist/backend/index.d.ts.map +1 -1
- package/dist/backend/index.js +209 -15
- package/dist/backend/index.js.map +1 -1
- package/dist/backend/plugin.d.ts +45 -4
- package/dist/backend/plugin.d.ts.map +1 -1
- package/dist/backend/plugin.js +67 -9
- package/dist/backend/plugin.js.map +1 -1
- package/dist/backend/prompt-tools.d.ts +10 -0
- package/dist/backend/prompt-tools.d.ts.map +1 -1
- package/dist/backend/prompt-tools.js +108 -4
- package/dist/backend/prompt-tools.js.map +1 -1
- package/dist/backend/routes.admin.d.ts +29 -0
- package/dist/backend/routes.admin.d.ts.map +1 -1
- package/dist/backend/routes.admin.js +161 -55
- package/dist/backend/routes.admin.js.map +1 -1
- package/dist/backend/routes.admin.url-keys.d.ts +23 -0
- package/dist/backend/routes.admin.url-keys.d.ts.map +1 -0
- package/dist/backend/routes.admin.url-keys.js +14 -0
- package/dist/backend/routes.admin.url-keys.js.map +1 -0
- package/dist/backend/routes.api-key.d.ts.map +1 -1
- package/dist/backend/routes.api-key.js +14 -1
- package/dist/backend/routes.api-key.js.map +1 -1
- package/dist/backend/routes.external.d.ts.map +1 -1
- package/dist/backend/routes.external.js +6 -1
- package/dist/backend/routes.external.js.map +1 -1
- package/dist/backend/routes.public.d.ts +24 -7
- package/dist/backend/routes.public.d.ts.map +1 -1
- package/dist/backend/routes.public.js +58 -29
- package/dist/backend/routes.public.js.map +1 -1
- package/dist/backend/routes.public.url-keys.d.ts +26 -0
- package/dist/backend/routes.public.url-keys.d.ts.map +1 -0
- package/dist/backend/routes.public.url-keys.js +17 -0
- package/dist/backend/routes.public.url-keys.js.map +1 -0
- package/dist/backend/services/asset-references.js +43 -30
- package/dist/backend/services/asset-references.js.map +1 -1
- package/dist/backend/services/attachment-packaging-scopes.d.ts +43 -0
- package/dist/backend/services/attachment-packaging-scopes.d.ts.map +1 -0
- package/dist/backend/services/attachment-packaging-scopes.js +115 -0
- package/dist/backend/services/attachment-packaging-scopes.js.map +1 -0
- package/dist/backend/services/attachment.service.d.ts +12 -1
- package/dist/backend/services/attachment.service.d.ts.map +1 -1
- package/dist/backend/services/attachment.service.js +119 -21
- package/dist/backend/services/attachment.service.js.map +1 -1
- package/dist/backend/services/attribute-scope-preview.d.ts +38 -0
- package/dist/backend/services/attribute-scope-preview.d.ts.map +1 -0
- package/dist/backend/services/attribute-scope-preview.js +66 -0
- package/dist/backend/services/attribute-scope-preview.js.map +1 -0
- package/dist/backend/services/bulk-operation.service.d.ts +36 -0
- package/dist/backend/services/bulk-operation.service.d.ts.map +1 -1
- package/dist/backend/services/bulk-operation.service.js +203 -36
- package/dist/backend/services/bulk-operation.service.js.map +1 -1
- package/dist/backend/services/bundle.service.d.ts +9 -1
- package/dist/backend/services/bundle.service.d.ts.map +1 -1
- package/dist/backend/services/bundle.service.js +12 -2
- package/dist/backend/services/bundle.service.js.map +1 -1
- package/dist/backend/services/catalog-admin-search.service.d.ts +1 -1
- package/dist/backend/services/catalog-admin-search.service.js +1 -1
- package/dist/backend/services/catalog-admin.service.d.ts +125 -18
- package/dist/backend/services/catalog-admin.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-admin.service.js +367 -164
- package/dist/backend/services/catalog-admin.service.js.map +1 -1
- package/dist/backend/services/catalog-bulk-import.service.d.ts +24 -2
- package/dist/backend/services/catalog-bulk-import.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-bulk-import.service.js +132 -6
- package/dist/backend/services/catalog-bulk-import.service.js.map +1 -1
- package/dist/backend/services/catalog-bulk-update.service.d.ts +32 -4
- package/dist/backend/services/catalog-bulk-update.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-bulk-update.service.js +115 -12
- package/dist/backend/services/catalog-bulk-update.service.js.map +1 -1
- package/dist/backend/services/catalog-org-price-decorator.d.ts +18 -27
- package/dist/backend/services/catalog-org-price-decorator.d.ts.map +1 -1
- package/dist/backend/services/catalog-org-price-decorator.js +77 -33
- package/dist/backend/services/catalog-org-price-decorator.js.map +1 -1
- package/dist/backend/services/catalog-product-filter.service.d.ts +16 -2
- package/dist/backend/services/catalog-product-filter.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-product-filter.service.js +80 -3
- package/dist/backend/services/catalog-product-filter.service.js.map +1 -1
- package/dist/backend/services/catalog-product-read.service.d.ts +45 -3
- package/dist/backend/services/catalog-product-read.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-product-read.service.js +130 -3
- package/dist/backend/services/catalog-product-read.service.js.map +1 -1
- package/dist/backend/services/catalog-query.service.d.ts +145 -40
- package/dist/backend/services/catalog-query.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-query.service.js +1048 -391
- package/dist/backend/services/catalog-query.service.js.map +1 -1
- package/dist/backend/services/catalog-quick-search.service.d.ts +18 -2
- package/dist/backend/services/catalog-quick-search.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-quick-search.service.js +52 -20
- package/dist/backend/services/catalog-quick-search.service.js.map +1 -1
- package/dist/backend/services/catalog-write-ports.d.ts +18 -1
- package/dist/backend/services/catalog-write-ports.d.ts.map +1 -1
- package/dist/backend/services/catalog-write-ports.js +77 -0
- package/dist/backend/services/catalog-write-ports.js.map +1 -1
- package/dist/backend/services/category-admin.service.d.ts +12 -1
- package/dist/backend/services/category-admin.service.d.ts.map +1 -1
- package/dist/backend/services/category-admin.service.js +23 -2
- package/dist/backend/services/category-admin.service.js.map +1 -1
- package/dist/backend/services/channel-url-facts.d.ts +17 -0
- package/dist/backend/services/channel-url-facts.d.ts.map +1 -0
- package/dist/backend/services/channel-url-facts.js +20 -0
- package/dist/backend/services/channel-url-facts.js.map +1 -0
- package/dist/backend/services/effective-value.sql.d.ts +56 -0
- package/dist/backend/services/effective-value.sql.d.ts.map +1 -0
- package/dist/backend/services/effective-value.sql.js +111 -0
- package/dist/backend/services/effective-value.sql.js.map +1 -0
- package/dist/backend/services/gallery-scopes.d.ts +40 -0
- package/dist/backend/services/gallery-scopes.d.ts.map +1 -0
- package/dist/backend/services/gallery-scopes.js +151 -0
- package/dist/backend/services/gallery-scopes.js.map +1 -0
- package/dist/backend/services/gallery.service.d.ts +46 -4
- package/dist/backend/services/gallery.service.d.ts.map +1 -1
- package/dist/backend/services/gallery.service.js +308 -46
- package/dist/backend/services/gallery.service.js.map +1 -1
- package/dist/backend/services/linkable-asset.d.ts +21 -0
- package/dist/backend/services/linkable-asset.d.ts.map +1 -0
- package/dist/backend/services/linkable-asset.js +31 -0
- package/dist/backend/services/linkable-asset.js.map +1 -0
- package/dist/backend/services/packaging-unit.service.d.ts.map +1 -1
- package/dist/backend/services/packaging-unit.service.js +95 -29
- package/dist/backend/services/packaging-unit.service.js.map +1 -1
- package/dist/backend/services/primary-asset-url.d.ts +7 -1
- package/dist/backend/services/primary-asset-url.d.ts.map +1 -1
- package/dist/backend/services/primary-asset-url.js +45 -14
- package/dist/backend/services/primary-asset-url.js.map +1 -1
- package/dist/backend/services/product-availability.service.d.ts +79 -0
- package/dist/backend/services/product-availability.service.d.ts.map +1 -0
- package/dist/backend/services/product-availability.service.js +223 -0
- package/dist/backend/services/product-availability.service.js.map +1 -0
- package/dist/backend/services/product-availability.sql.d.ts +71 -0
- package/dist/backend/services/product-availability.sql.d.ts.map +1 -0
- package/dist/backend/services/product-availability.sql.js +77 -0
- package/dist/backend/services/product-availability.sql.js.map +1 -0
- package/dist/backend/services/product-link.service.d.ts +10 -9
- package/dist/backend/services/product-link.service.d.ts.map +1 -1
- package/dist/backend/services/product-link.service.js +48 -23
- package/dist/backend/services/product-link.service.js.map +1 -1
- package/dist/backend/services/product-overrides.service.d.ts +9 -2
- package/dist/backend/services/product-overrides.service.d.ts.map +1 -1
- package/dist/backend/services/product-overrides.service.js +13 -6
- package/dist/backend/services/product-overrides.service.js.map +1 -1
- package/dist/backend/services/product-page-revalidation.d.ts +51 -0
- package/dist/backend/services/product-page-revalidation.d.ts.map +1 -0
- package/dist/backend/services/product-page-revalidation.js +146 -0
- package/dist/backend/services/product-page-revalidation.js.map +1 -0
- package/dist/backend/services/product-scope-context.service.d.ts.map +1 -1
- package/dist/backend/services/product-scope-context.service.js +3 -2
- package/dist/backend/services/product-scope-context.service.js.map +1 -1
- package/dist/backend/services/product-scopes.service.d.ts +212 -0
- package/dist/backend/services/product-scopes.service.d.ts.map +1 -0
- package/dist/backend/services/product-scopes.service.js +638 -0
- package/dist/backend/services/product-scopes.service.js.map +1 -0
- package/dist/backend/services/product-summary-text.d.ts +8 -0
- package/dist/backend/services/product-summary-text.d.ts.map +1 -0
- package/dist/backend/services/product-summary-text.js +8 -0
- package/dist/backend/services/product-summary-text.js.map +1 -0
- package/dist/backend/services/product-value-resolver.service.d.ts +11 -1
- package/dist/backend/services/product-value-resolver.service.d.ts.map +1 -1
- package/dist/backend/services/product-value-resolver.service.js +29 -9
- package/dist/backend/services/product-value-resolver.service.js.map +1 -1
- package/dist/backend/services/publication-window-sweep.d.ts +77 -0
- package/dist/backend/services/publication-window-sweep.d.ts.map +1 -0
- package/dist/backend/services/publication-window-sweep.js +117 -0
- package/dist/backend/services/publication-window-sweep.js.map +1 -0
- package/dist/backend/services/scope-completeness.d.ts +107 -0
- package/dist/backend/services/scope-completeness.d.ts.map +1 -0
- package/dist/backend/services/scope-completeness.js +180 -0
- package/dist/backend/services/scope-completeness.js.map +1 -0
- package/dist/backend/services/scope-overview.service.d.ts +112 -0
- package/dist/backend/services/scope-overview.service.d.ts.map +1 -0
- package/dist/backend/services/scope-overview.service.js +372 -0
- package/dist/backend/services/scope-overview.service.js.map +1 -0
- package/dist/backend/services/sql-id-arrays.d.ts +16 -0
- package/dist/backend/services/sql-id-arrays.d.ts.map +1 -0
- package/dist/backend/services/sql-id-arrays.js +24 -0
- package/dist/backend/services/sql-id-arrays.js.map +1 -0
- package/dist/backend/services/storefront-value-overrides.d.ts +31 -0
- package/dist/backend/services/storefront-value-overrides.d.ts.map +1 -0
- package/dist/backend/services/storefront-value-overrides.js +48 -0
- package/dist/backend/services/storefront-value-overrides.js.map +1 -0
- package/dist/backend/services/url-key-resolution.service.d.ts +76 -0
- package/dist/backend/services/url-key-resolution.service.d.ts.map +1 -0
- package/dist/backend/services/url-key-resolution.service.js +179 -0
- package/dist/backend/services/url-key-resolution.service.js.map +1 -0
- package/dist/backend/services/url-key.service.d.ts +171 -0
- package/dist/backend/services/url-key.service.d.ts.map +1 -0
- package/dist/backend/services/url-key.service.js +738 -0
- package/dist/backend/services/url-key.service.js.map +1 -0
- package/dist/manifest.d.ts +3 -1
- package/dist/manifest.d.ts.map +1 -1
- package/dist/manifest.js +188 -13
- package/dist/manifest.js.map +1 -1
- package/dist/migrations/20261016T082008_catalog_order_rules.d.ts +22 -0
- package/dist/migrations/20261016T082008_catalog_order_rules.d.ts.map +1 -0
- package/dist/migrations/20261016T082008_catalog_order_rules.js +48 -0
- package/dist/migrations/20261016T082008_catalog_order_rules.js.map +1 -0
- package/dist/migrations/20261022T035133_catalog_product_scopes.d.ts +28 -0
- package/dist/migrations/20261022T035133_catalog_product_scopes.d.ts.map +1 -0
- package/dist/migrations/20261022T035133_catalog_product_scopes.js +92 -0
- package/dist/migrations/20261022T035133_catalog_product_scopes.js.map +1 -0
- package/dist/migrations/20261022T054223_catalog_product_url_keys.d.ts +32 -0
- package/dist/migrations/20261022T054223_catalog_product_url_keys.d.ts.map +1 -0
- package/dist/migrations/20261022T054223_catalog_product_url_keys.js +81 -0
- package/dist/migrations/20261022T054223_catalog_product_url_keys.js.map +1 -0
- package/dist/migrations/20261022T111811_catalog_price_fields_removed.d.ts +26 -0
- package/dist/migrations/20261022T111811_catalog_price_fields_removed.d.ts.map +1 -0
- package/dist/migrations/20261022T111811_catalog_price_fields_removed.js +32 -0
- package/dist/migrations/20261022T111811_catalog_price_fields_removed.js.map +1 -0
- package/dist/migrations/20261022T182523_catalog_admin_name_keys.d.ts +38 -0
- package/dist/migrations/20261022T182523_catalog_admin_name_keys.d.ts.map +1 -0
- package/dist/migrations/20261022T182523_catalog_admin_name_keys.js +89 -0
- package/dist/migrations/20261022T182523_catalog_admin_name_keys.js.map +1 -0
- package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.d.ts +34 -0
- package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.d.ts.map +1 -0
- package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.js +57 -0
- package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.js.map +1 -0
- package/dist/migrations/20261026T033453_catalog_product_media_scopes.d.ts +26 -0
- package/dist/migrations/20261026T033453_catalog_product_media_scopes.d.ts.map +1 -0
- package/dist/migrations/20261026T033453_catalog_product_media_scopes.js +54 -0
- package/dist/migrations/20261026T033453_catalog_product_media_scopes.js.map +1 -0
- package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.d.ts +27 -0
- package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.d.ts.map +1 -0
- package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.js +45 -0
- package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.js.map +1 -0
- package/dist/migrations/index.d.ts +9 -1
- package/dist/migrations/index.d.ts.map +1 -1
- package/dist/migrations/index.js +17 -1
- package/dist/migrations/index.js.map +1 -1
- package/docs/catalog/attachments.md +46 -4
- package/docs/catalog/attributes.md +11 -6
- package/docs/catalog/gallery-and-labels.md +63 -4
- package/docs/catalog/packaging-units.md +82 -8
- package/docs/catalog/per-channel-per-language-overrides.md +195 -10
- package/docs/catalog/url-keys-and-redirects.md +142 -0
- package/docs/catalog.md +326 -17
- package/i18n/en.json +931 -53
- package/i18n/pl.json +930 -52
- package/package.json +10 -10
|
@@ -20,6 +20,13 @@ language-scoped via a backend constant
|
|
|
20
20
|
(`SYSTEM_ATTRIBUTE_SCOPES`). User-defined attributes default to
|
|
21
21
|
global-only and opt in via the attribute editor.
|
|
22
22
|
|
|
23
|
+
The same scopes also decide **where a product is available**: its status,
|
|
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).
|
|
29
|
+
|
|
23
30
|
## Why
|
|
24
31
|
|
|
25
32
|
A B2B catalog routinely needs to overlay channel-specific marketing
|
|
@@ -159,7 +166,7 @@ additive.
|
|
|
159
166
|
|
|
160
167
|
## Read paths
|
|
161
168
|
|
|
162
|
-
|
|
169
|
+
These consumers go through the resolver:
|
|
163
170
|
|
|
164
171
|
- **Admin endpoint** — `GET /api/v1/admin/catalog/products/:id?channelId=&languageCode=&includeOverridesMap=true`
|
|
165
172
|
returns the baseline product PLUS, when context params are passed, a
|
|
@@ -168,13 +175,45 @@ Three consumers go through the resolver:
|
|
|
168
175
|
is attached for client-side switcher previews.
|
|
169
176
|
- **Storefront public read** — pulls the channel from the
|
|
170
177
|
`x-sales-channel` header (the existing convention) and
|
|
171
|
-
the language from `Accept-Language
|
|
172
|
-
to the public client
|
|
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).
|
|
173
204
|
- **Search indexer (Meilisearch)** — builds one document per
|
|
174
205
|
`(product, channel)` pair. Each document's `name` and `description`
|
|
175
206
|
fields are run through the resolver with `channel.defaultLanguage`
|
|
176
207
|
as the active language, so per-channel overrides flow into
|
|
177
|
-
storefront search ranking.
|
|
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.
|
|
178
217
|
|
|
179
218
|
## Admin UI
|
|
180
219
|
|
|
@@ -192,7 +231,7 @@ The product edit page's **Details** tab gains a
|
|
|
192
231
|
source badge per field — `channel + language override` / `channel
|
|
193
232
|
override` / `global baseline (language)` / `global baseline
|
|
194
233
|
(fallback)` / `no value`.
|
|
195
|
-
4. Offers "Add override" / "Edit override" / "
|
|
234
|
+
4. Offers "Add override" / "Edit override" / "Use inherited"
|
|
196
235
|
affordances per field. Edits go through `PATCH /value-overrides`
|
|
197
236
|
with optimistic refresh.
|
|
198
237
|
5. Persists the editor's `(channel, language)` selection back via
|
|
@@ -203,6 +242,157 @@ Edit affordances are gated on a specific channel being selected.
|
|
|
203
242
|
Under Global / no channel, the panel is read-only and a help string
|
|
204
243
|
explains that overrides only apply per-channel.
|
|
205
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 |
|
|
270
|
+
| --- | --- | --- | --- |
|
|
271
|
+
| Status (`active` / `inactive`) | `products.status` | yes | yes |
|
|
272
|
+
| Publication window | `products.publish_from` / `publish_until` | yes | — |
|
|
273
|
+
| Audience (visibility and organisations) | `products.visibility` / `allowed_organization_ids` | yes | — |
|
|
274
|
+
| Minimum order quantity, returnable | `products` | yes | — |
|
|
275
|
+
|
|
276
|
+
Each field takes the value of the most specific scope that sets one: for the
|
|
277
|
+
status, channel × language, then channel, then global; for the others,
|
|
278
|
+
channel, then global. An unset scope **inherits** — there is no "empty"
|
|
279
|
+
value that switches something off. A product with no overrides behaves
|
|
280
|
+
exactly as before.
|
|
281
|
+
|
|
282
|
+
- **Status.** `inactive` at any scope is plain off there, and archiving is not a
|
|
283
|
+
status — see *Product status and archiving* on the
|
|
284
|
+
[Catalog](../catalog.md#product-status-and-archiving) page. A product off
|
|
285
|
+
globally and `active` in one channel is available in that channel only.
|
|
286
|
+
- **Publication window.** `from` and `until`, each optional (an open side);
|
|
287
|
+
both ends are included. A channel window replaces the global window as a
|
|
288
|
+
pair, even when both its sides are open. A window that does not start before
|
|
289
|
+
it ends is refused with `422 VALIDATION_FAILED` (`details.field = 'window'`).
|
|
290
|
+
The window is evaluated when a request is answered; nothing is written when
|
|
291
|
+
it opens or closes. A sweep (`catalog.publication-window.sweep`, every five
|
|
292
|
+
minutes) announces `product.updated.v1` with
|
|
293
|
+
`changedFields: ["publicationWindow"]` for each product whose window bound
|
|
294
|
+
was crossed, so caches and the search index catch up.
|
|
295
|
+
- **Audience.** The visibility mode and the organisation list are one value:
|
|
296
|
+
a channel's audience replaces the global rule whole, never merged with it.
|
|
297
|
+
Naming organisations that are not members of the channel is allowed and
|
|
298
|
+
answered with an `audience_non_members` warning.
|
|
299
|
+
- **Order rules.** See *Per sales channel* under *Order rules* on the
|
|
300
|
+
[Catalog](../catalog.md#per-sales-channel) page.
|
|
301
|
+
|
|
302
|
+
An override is honoured only where it can apply: one for a channel the product
|
|
303
|
+
has left, or for a language the channel no longer offers, is kept but ignored,
|
|
304
|
+
and listed as an orphan (below) until it is removed.
|
|
305
|
+
|
|
306
|
+
### Writing the scopes
|
|
307
|
+
|
|
308
|
+
`GET /api/v1/admin/catalog/products/:id/scopes` (`catalog:read`) answers the
|
|
309
|
+
global values and, per channel, the overrides, the channel's languages and
|
|
310
|
+
whether the product is still a member. `PATCH` on the same path
|
|
311
|
+
(`catalog:write`) writes them:
|
|
312
|
+
|
|
313
|
+
```json
|
|
314
|
+
{
|
|
315
|
+
"channels": [
|
|
316
|
+
{
|
|
317
|
+
"channelId": "<retail-uuid>",
|
|
318
|
+
"status": "active",
|
|
319
|
+
"window": { "from": "2026-11-01T00:00:00Z", "until": null },
|
|
320
|
+
"audience": null,
|
|
321
|
+
"languageStatuses": [{ "languageCode": "de-DE", "status": "inactive" }]
|
|
322
|
+
}
|
|
323
|
+
],
|
|
324
|
+
"global": { "publishUntil": "2026-12-31T23:59:59Z" }
|
|
325
|
+
}
|
|
326
|
+
```
|
|
327
|
+
|
|
328
|
+
An absent key is left as it is; `null` removes the override (use inherited).
|
|
329
|
+
A value for a channel the product is not in, or a language the channel does not
|
|
330
|
+
offer, is refused with `422 SCOPE_INVALID`; removing such an override is always
|
|
331
|
+
allowed. The global window can also be written with the product `PATCH`
|
|
332
|
+
(`publishFrom`, `publishUntil`).
|
|
333
|
+
|
|
334
|
+
Each request is one audited Command, `product.scopes.update`; sending its
|
|
335
|
+
before-state back through the same route restores it. The write announces
|
|
336
|
+
`product.updated.v1` with `changedFields` among `scopedStatus`,
|
|
337
|
+
`publicationWindow`, `audience` and `orderRules`. A status change that switches
|
|
338
|
+
the product on is subject to the completeness check — see the
|
|
339
|
+
[Catalog](../catalog.md#completeness-check-when-switching-a-product-on) page —
|
|
340
|
+
and `warnings` carries what it found. Imports and connectors write the same
|
|
341
|
+
scopes through `catalogProductScopeWritePort`, unchecked; the field-by-field
|
|
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
|
+
|
|
206
396
|
## Migration
|
|
207
397
|
|
|
208
398
|
One migration `20260611T140346_catalog_product_value_overrides_init.ts` ships everything:
|
|
@@ -223,11 +413,6 @@ exact inverse — drop the two tables and the two columns.
|
|
|
223
413
|
surfaces only the system Name + Description today. User attribute
|
|
224
414
|
overrides are accepted by the PATCH endpoint and resolved on read,
|
|
225
415
|
but the admin SPA does not yet expose a write affordance for them.
|
|
226
|
-
- **Storefront public read shape change** — `products.name` and
|
|
227
|
-
`products.description` still ship as `Record<lang, string>` JSONB
|
|
228
|
-
on the public catalog endpoint. Switching to a resolved scalar is
|
|
229
|
-
a breaking change for storefront consumers and is scoped as a
|
|
230
|
-
follow-up.
|
|
231
416
|
- **Channel-aware reindex enqueue** — the PATCH endpoint does not
|
|
232
417
|
yet enqueue a Meilisearch reindex job per touched channel; the
|
|
233
418
|
next per-product upsert (driven by any catalog mutation) picks it
|
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: URL Keys and Redirects
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# URL Keys and Redirects
|
|
6
|
+
|
|
7
|
+
A product's storefront address is `/p/<key>`. The key can differ per language, and per sales
|
|
8
|
+
channel and language:
|
|
9
|
+
|
|
10
|
+
- **global key** — the product's `slug`; it is the key in every language where the product has no
|
|
11
|
+
key of its own;
|
|
12
|
+
- **language key** — one per language, for every sales channel;
|
|
13
|
+
- **sales channel × language key** — one per channel and language, overriding the language key there.
|
|
14
|
+
|
|
15
|
+
The **effective key** at a sales channel and language is the channel × language key, else the
|
|
16
|
+
language key, else the global key. Every product URL the platform emits — the storefront's
|
|
17
|
+
canonical and alternate-language links, the sitemap, a redirect target, the preview address in the
|
|
18
|
+
admin — uses the effective key, with `?lang=<language>` when the language is not the channel's
|
|
19
|
+
default.
|
|
20
|
+
|
|
21
|
+
A key is valid only in its own language, and is unique per language across all sales channels:
|
|
22
|
+
no two products share a key in one language. Changing a key keeps the previous one as a permanent
|
|
23
|
+
redirect in its language, straight to the current key; redirects are kept until an operator deletes
|
|
24
|
+
them. Redirects are served while the `seo` module is switched on; with `seo` off an old key answers
|
|
25
|
+
"not found", and the redirects come back when `seo` is switched on. A product's other **current** keys
|
|
26
|
+
are not redirects: with `seo` off too, a request for its language or global key where a channel ×
|
|
27
|
+
language key overrides it, or for another channel's key, still leads to its URL in that channel.
|
|
28
|
+
|
|
29
|
+
## Managing keys
|
|
30
|
+
|
|
31
|
+
In the product editor, the **URL keys** panel on the SEO tab shows the global key, a key per
|
|
32
|
+
language and a key per sales channel and language — an empty field uses the inherited key — and the
|
|
33
|
+
storefront URL each channel and language ends up with. While the `seo` module is on it also lists
|
|
34
|
+
the redirects the old keys keep.
|
|
35
|
+
|
|
36
|
+
`GET /api/v1/admin/catalog/products/:id/url-keys` (`catalog:read`) answers the same, and `PUT` on
|
|
37
|
+
the same path (`catalog:write`) writes it:
|
|
38
|
+
|
|
39
|
+
```json
|
|
40
|
+
{
|
|
41
|
+
"globalKey": "cordless-drill",
|
|
42
|
+
"languageKeys": [{ "languageCode": "de-DE", "key": "akku-bohrschrauber" }],
|
|
43
|
+
"channelKeys": [{ "channelId": "<retail-uuid>", "languageCode": "pl-PL", "key": null }]
|
|
44
|
+
}
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
A list or key left out is unchanged; `key: null` removes the key at that scope, so the inherited
|
|
48
|
+
key applies there again. A key is lower-case kebab case, at most 160 characters. A key for a sales
|
|
49
|
+
channel the product is not in, or a language the channel does not offer, is refused with
|
|
50
|
+
`422 SCOPE_INVALID`; a key left behind by a channel the product has left is shown as **No longer applies**
|
|
51
|
+
and can be removed.
|
|
52
|
+
|
|
53
|
+
- **A key another product holds** in that language is refused with `409 URL_KEY_TAKEN`, naming the
|
|
54
|
+
product (`details.conflicts`). A deleted product's global key stays taken; its language and
|
|
55
|
+
channel keys are released.
|
|
56
|
+
- **A key that is another product's redirect** answers `409 URL_KEY_REDIRECT_TAKEOVER_REQUIRED`,
|
|
57
|
+
naming the product that would lose the redirect (`details.takeovers`). Sending the same request
|
|
58
|
+
again with the key in `confirmTakeover` takes it over. Only an operator can do this; an
|
|
59
|
+
integration never takes over a redirect.
|
|
60
|
+
- **A changed key stays as a redirect** in its language, pointing at the product, not at a key, so
|
|
61
|
+
redirects never chain. A redirect is kept until an operator deletes it:
|
|
62
|
+
`DELETE /api/v1/admin/catalog/products/:id/url-redirects/:redirectId` (`catalog:write`). Deleting
|
|
63
|
+
a product removes its redirects. While `seo` is off the answer leaves `redirects` out, but the
|
|
64
|
+
rows stay and keep reserving their keys.
|
|
65
|
+
|
|
66
|
+
A `PUT` is one audited Command, `product.url_keys.update`, whose before-state sent back through the
|
|
67
|
+
same route restores the keys; a redirect delete is `product.url_redirect.delete`. Both announce
|
|
68
|
+
`product.updated.v1` with `changedFields: ["urlKeys"]`. A new or duplicated product's global key is
|
|
69
|
+
chosen free of every live product's language, channel and redirect keys.
|
|
70
|
+
|
|
71
|
+
## On the storefront
|
|
72
|
+
|
|
73
|
+
`GET /api/v1/catalog/products/resolve/:key` resolves a key at the request's sales channel and
|
|
74
|
+
language:
|
|
75
|
+
|
|
76
|
+
- the product's effective key there answers `{ kind: "product", productId, key }`;
|
|
77
|
+
- any other current key of the product in that language, and its redirects there (a former global
|
|
78
|
+
key counts in every language), answer `{ kind: "redirect", key, languageCode, path }`, `path`
|
|
79
|
+
being the product's URL to redirect to permanently;
|
|
80
|
+
- a key of no product, a key of another language, and a product that is not available to the caller
|
|
81
|
+
there all answer the same `404 PRODUCT_NOT_FOUND`; an archived product answers
|
|
82
|
+
`410 PRODUCT_ARCHIVED`.
|
|
83
|
+
|
|
84
|
+
`GET /api/v1/catalog/products/:idOrSlug` accepts an id, a current key in the request's language, or
|
|
85
|
+
a product's global key — never a redirect. The product detail carries
|
|
86
|
+
`paths: { canonical, alternates }`: the page's URL at the request's channel and language, and one
|
|
87
|
+
per channel language where the product is available to anonymous visitors. `slug` on the listing,
|
|
88
|
+
the product detail, grouped and bundle children and product-link tiles is the effective key at the
|
|
89
|
+
request's channel and language.
|
|
90
|
+
|
|
91
|
+
## Errors
|
|
92
|
+
|
|
93
|
+
| Code | Status | When |
|
|
94
|
+
| --- | --- | --- |
|
|
95
|
+
| `URL_KEY_TAKEN` | 409 | The key is another product's key in that language |
|
|
96
|
+
| `URL_KEY_REDIRECT_TAKEOVER_REQUIRED` | 409 | The key is another product's redirect and the write did not confirm the takeover |
|
|
97
|
+
| `URL_REDIRECT_NOT_FOUND` | 404 | `:redirectId` is not a redirect of the product |
|
|
98
|
+
| `SCOPE_INVALID` | 422 | A key for a channel the product is not in, or a language the channel does not offer |
|
|
99
|
+
| `PRODUCT_NOT_FOUND` | 404 | The storefront resolve found no product available to the caller |
|
|
100
|
+
| `PRODUCT_ARCHIVED` | 410 | The storefront resolve found an archived product |
|
|
101
|
+
|
|
102
|
+
## Integrations
|
|
103
|
+
|
|
104
|
+
What a connector, a PIM synchronisation or a spreadsheet writes, and at which scope. An integration
|
|
105
|
+
writes only the scopes it names: writing a global value never removes an operator's override at a
|
|
106
|
+
sales channel or language (FR-091).
|
|
107
|
+
|
|
108
|
+
| Field | Scope it is written at | Through |
|
|
109
|
+
| --- | --- | --- |
|
|
110
|
+
| Status | sales channel, or sales channel × language | `catalogProductScopeWritePort.applyScopes` `status`; the products CSV columns `status@<channel code>` and `status@<channel code>/<language>` |
|
|
111
|
+
| Global status, visibility, name, description | global (name and description per language) | `catalogProductWritePort`; the products CSV's `status`, `visibility`, `name_en`, `description_en` |
|
|
112
|
+
| Publication window | global, or sales channel | `applyScopes` `window` (`channelId: null` is the global window) |
|
|
113
|
+
| Audience (visibility and organisations) | sales channel | `applyScopes` `audience` |
|
|
114
|
+
| Minimum order quantity, returnable | sales channel | `applyScopes` `orderRules` |
|
|
115
|
+
| URL key | language, or sales channel × language | `applyScopes` `urlKeys` (`channelId: null` is the language key) |
|
|
116
|
+
| Channel- or language-scoped attribute values | sales channel, language, or both | `catalogProductValueOverrideWritePort` |
|
|
117
|
+
| SEO title and description | language | `seoMetaWritePort` — sales channel SEO overrides are the operator's |
|
|
118
|
+
|
|
119
|
+
`null` as a value means "use inherited": the override at that scope is removed. A field the input
|
|
120
|
+
does not name is left as it is.
|
|
121
|
+
|
|
122
|
+
**URL keys from an integration are never forced.** A key that is another product's key in that
|
|
123
|
+
language, or another product's redirect, is not written: the product keeps its previous key at that
|
|
124
|
+
scope and the call reports, per key, `{ written: false, issue: { languageCode, channelId, key,
|
|
125
|
+
heldByProductId, kind } }` — `kind` is `current` or `redirect`. An integration never takes over
|
|
126
|
+
another product's redirect and is never asked to confirm one; only an operator can, in the product
|
|
127
|
+
editor (FR-093). A key for a sales channel the product is not in, or a language the channel does not
|
|
128
|
+
offer, refuses the whole call.
|
|
129
|
+
|
|
130
|
+
**No completeness check runs** on an integration's write; the operator's warnings about missing
|
|
131
|
+
names and keys in a scope are an editor feature.
|
|
132
|
+
|
|
133
|
+
**The products CSV round-trips.** The export carries one `status@<channel code>` column per sales
|
|
134
|
+
channel and one `status@<channel code>/<language>` column per channel language — the override at
|
|
135
|
+
that scope, empty where the scope inherits. Importing the exported file unchanged changes nothing;
|
|
136
|
+
an edited cell writes that scope, and an emptied one removes the override. A file without these
|
|
137
|
+
columns leaves every scope as it is. One invalid cell — an unknown channel code, a value for a
|
|
138
|
+
channel the product is not in or a language the channel does not offer, a value that is not a
|
|
139
|
+
status — rejects the whole file, as any other invalid row does.
|
|
140
|
+
|
|
141
|
+
Every write is audited and announced with `product.updated.v1`, whose `changedFields` name what
|
|
142
|
+
changed (`scopedStatus`, `publicationWindow`, `audience`, `orderRules`, `urlKeys`).
|