@endora-commerce/mod-catalog 0.110.0 → 0.111.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/admin/components/PackagingUnitsEditor.js +2 -1
- package/dist/admin/components/ProductAttachmentsSection.js +1 -1
- package/dist/admin/components/ProductAttributesTab.js +1 -1
- package/dist/admin/components/ProductEditorSaveAction.d.ts +22 -0
- package/dist/admin/components/ProductEditorSaveAction.js +23 -0
- package/dist/admin/components/ProductGallerySection.js +1 -1
- package/dist/admin/components/ProductInventoryTab.d.ts +12 -1
- package/dist/admin/components/ProductInventoryTab.js +52 -115
- package/dist/admin/components/ProductScopeBar.d.ts +6 -0
- package/dist/admin/components/ProductScopeBar.js +2 -2
- package/dist/admin/components/ProductScopeOverview.js +10 -6
- package/dist/admin/components/ProductUrlRedirects.js +1 -1
- package/dist/admin/components/ProductsBulkEditDialog.js +4 -3
- package/dist/admin/components/editor/DetailsTab.js +3 -2
- package/dist/admin/components/editor/{ImmediateBadge.d.ts → SectionHeading.d.ts} +6 -5
- package/dist/admin/components/editor/{ImmediateBadge.js → SectionHeading.js} +8 -10
- package/dist/admin/components/editor/editor-context.d.ts +3 -1
- package/dist/admin/lib/bulk-result-outcome.d.ts +14 -0
- package/dist/admin/lib/bulk-result-outcome.js +13 -0
- package/dist/admin/lib/product-scopes-api.js +3 -3
- package/dist/admin/lib/product-url-keys-api.js +1 -1
- package/dist/admin/pages/AttachmentTypesPage.js +14 -4
- package/dist/admin/pages/AttributeSetsPage.js +11 -4
- package/dist/admin/pages/AttributesManager.js +11 -2
- package/dist/admin/pages/BulkOperationDetailPage.js +11 -4
- package/dist/admin/pages/CategoriesTree.d.ts +5 -0
- package/dist/admin/pages/CategoriesTree.js +226 -40
- package/dist/admin/pages/ProductEditor.js +172 -75
- package/dist/admin/pages/ProductsList.js +25 -20
- package/dist/backend/commands/attribute-commands.js +59 -13
- package/dist/backend/index.d.ts +3 -0
- package/dist/backend/index.js +20 -1
- package/dist/backend/routes.admin.js +12 -4
- package/dist/backend/routes.external.js +3 -2
- package/dist/backend/routes.public.js +9 -4
- package/dist/backend/services/bulk-operation.service.d.ts +1 -1
- package/dist/backend/services/bulk-operation.service.js +4 -0
- package/dist/backend/services/catalog-admin.service.js +19 -9
- package/dist/backend/services/catalog-attribute-read.service.js +2 -0
- package/dist/backend/services/catalog-bulk-import.service.d.ts +6 -0
- package/dist/backend/services/catalog-bulk-import.service.js +2 -0
- package/dist/backend/services/catalog-query.service.d.ts +10 -1
- package/dist/backend/services/catalog-query.service.js +26 -0
- package/dist/backend/services/category-admin.service.js +20 -4
- package/dist/backend/services/content-attribute-rules.d.ts +16 -4
- package/dist/backend/services/content-attribute-rules.js +25 -12
- package/dist/backend/services/grouped.service.js +7 -2
- package/dist/backend/services/product-scopes.service.d.ts +3 -2
- package/dist/backend/services/product-scopes.service.js +4 -3
- package/dist/backend/services/table-maintenance-queue.d.ts +78 -0
- package/dist/backend/services/table-maintenance-queue.js +97 -0
- package/dist/manifest.d.ts +45 -1
- package/dist/manifest.js +77 -7
- package/dist/migrations/20261114T000706_catalog_category_main_image.d.ts +37 -0
- package/dist/migrations/20261114T000706_catalog_category_main_image.js +56 -0
- package/dist/migrations/index.d.ts +2 -1
- package/dist/migrations/index.js +3 -1
- package/docs/catalog/attribute-sets.md +1 -0
- package/docs/catalog/attributes.md +34 -20
- package/docs/catalog/category-content.md +6 -3
- package/docs/catalog/composite-products.md +3 -1
- package/docs/catalog/editing-a-product-at-a-scope.md +60 -4
- package/docs/catalog/product-content.md +10 -6
- package/docs/catalog.md +45 -17
- package/i18n/en.json +48 -5
- package/i18n/pl.json +49 -6
- package/package.json +11 -10
- package/dist/admin/components/CopyToChannelsDialog.d.ts.map +0 -1
- package/dist/admin/components/CopyToChannelsDialog.js.map +0 -1
- package/dist/admin/components/PackagingUnitsEditor.d.ts.map +0 -1
- package/dist/admin/components/PackagingUnitsEditor.js.map +0 -1
- package/dist/admin/components/ProductAttachmentsSection.d.ts.map +0 -1
- package/dist/admin/components/ProductAttachmentsSection.js.map +0 -1
- package/dist/admin/components/ProductAttributesTab.d.ts.map +0 -1
- package/dist/admin/components/ProductAttributesTab.js.map +0 -1
- package/dist/admin/components/ProductContentCard.d.ts.map +0 -1
- package/dist/admin/components/ProductContentCard.js.map +0 -1
- package/dist/admin/components/ProductGallerySection.d.ts.map +0 -1
- package/dist/admin/components/ProductGallerySection.js.map +0 -1
- package/dist/admin/components/ProductInventoryTab.d.ts.map +0 -1
- package/dist/admin/components/ProductInventoryTab.js.map +0 -1
- package/dist/admin/components/ProductOrderRulesCard.d.ts.map +0 -1
- package/dist/admin/components/ProductOrderRulesCard.js.map +0 -1
- package/dist/admin/components/ProductScopeBar.d.ts.map +0 -1
- package/dist/admin/components/ProductScopeBar.js.map +0 -1
- package/dist/admin/components/ProductScopeOverview.d.ts.map +0 -1
- package/dist/admin/components/ProductScopeOverview.js.map +0 -1
- package/dist/admin/components/ProductStatusPills.d.ts.map +0 -1
- package/dist/admin/components/ProductStatusPills.js.map +0 -1
- package/dist/admin/components/ProductUrlRedirects.d.ts.map +0 -1
- package/dist/admin/components/ProductUrlRedirects.js.map +0 -1
- package/dist/admin/components/ProductsBulkEditDialog.d.ts.map +0 -1
- package/dist/admin/components/ProductsBulkEditDialog.js.map +0 -1
- package/dist/admin/components/editor/DetailsTab.d.ts.map +0 -1
- package/dist/admin/components/editor/DetailsTab.js.map +0 -1
- package/dist/admin/components/editor/ImmediateBadge.d.ts.map +0 -1
- package/dist/admin/components/editor/ImmediateBadge.js.map +0 -1
- package/dist/admin/components/editor/confirm-removal.d.ts.map +0 -1
- package/dist/admin/components/editor/confirm-removal.js.map +0 -1
- package/dist/admin/components/editor/editor-context.d.ts.map +0 -1
- package/dist/admin/components/editor/editor-context.js.map +0 -1
- package/dist/admin/components/editor/scoped-controls.d.ts.map +0 -1
- package/dist/admin/components/editor/scoped-controls.js.map +0 -1
- package/dist/admin/index.d.ts.map +0 -1
- package/dist/admin/index.js.map +0 -1
- package/dist/admin/lib/attribute-scope.d.ts.map +0 -1
- package/dist/admin/lib/attribute-scope.js.map +0 -1
- package/dist/admin/lib/bulk-operation-log-text.d.ts.map +0 -1
- package/dist/admin/lib/bulk-operation-log-text.js.map +0 -1
- package/dist/admin/lib/editor-scope.d.ts.map +0 -1
- package/dist/admin/lib/editor-scope.js.map +0 -1
- package/dist/admin/lib/order-minimum-input.d.ts.map +0 -1
- package/dist/admin/lib/order-minimum-input.js.map +0 -1
- package/dist/admin/lib/product-labels.d.ts.map +0 -1
- package/dist/admin/lib/product-labels.js.map +0 -1
- package/dist/admin/lib/product-scopes-api.d.ts.map +0 -1
- package/dist/admin/lib/product-scopes-api.js.map +0 -1
- package/dist/admin/lib/product-url-keys-api.d.ts.map +0 -1
- package/dist/admin/lib/product-url-keys-api.js.map +0 -1
- package/dist/admin/lib/resolve-product-selection.d.ts.map +0 -1
- package/dist/admin/lib/resolve-product-selection.js.map +0 -1
- package/dist/admin/lib/scope-overview.d.ts.map +0 -1
- package/dist/admin/lib/scope-overview.js.map +0 -1
- package/dist/admin/lib/scoped-editor-store.d.ts.map +0 -1
- package/dist/admin/lib/scoped-editor-store.js.map +0 -1
- package/dist/admin/lib/scoped-values-api.d.ts.map +0 -1
- package/dist/admin/lib/scoped-values-api.js.map +0 -1
- package/dist/admin/pages/AttachmentTypesPage.d.ts.map +0 -1
- package/dist/admin/pages/AttachmentTypesPage.js.map +0 -1
- package/dist/admin/pages/AttributeSetsPage.d.ts.map +0 -1
- package/dist/admin/pages/AttributeSetsPage.js.map +0 -1
- package/dist/admin/pages/AttributesManager.d.ts.map +0 -1
- package/dist/admin/pages/AttributesManager.js.map +0 -1
- package/dist/admin/pages/BulkOperationDetailPage.d.ts.map +0 -1
- package/dist/admin/pages/BulkOperationDetailPage.js.map +0 -1
- package/dist/admin/pages/BulkOperationsPage.d.ts.map +0 -1
- package/dist/admin/pages/BulkOperationsPage.js.map +0 -1
- package/dist/admin/pages/CategoriesTree.d.ts.map +0 -1
- package/dist/admin/pages/CategoriesTree.js.map +0 -1
- package/dist/admin/pages/CategoryContentPage.d.ts.map +0 -1
- package/dist/admin/pages/CategoryContentPage.js.map +0 -1
- package/dist/admin/pages/ProductContentPage.d.ts.map +0 -1
- package/dist/admin/pages/ProductContentPage.js.map +0 -1
- package/dist/admin/pages/ProductCreateForm.d.ts.map +0 -1
- package/dist/admin/pages/ProductCreateForm.js.map +0 -1
- package/dist/admin/pages/ProductEditor.d.ts.map +0 -1
- package/dist/admin/pages/ProductEditor.js.map +0 -1
- package/dist/admin/pages/ProductsList.d.ts.map +0 -1
- package/dist/admin/pages/ProductsList.js.map +0 -1
- package/dist/backend/admin-search-provider.d.ts.map +0 -1
- package/dist/backend/admin-search-provider.js.map +0 -1
- package/dist/backend/commands/attribute-commands.d.ts.map +0 -1
- package/dist/backend/commands/attribute-commands.js.map +0 -1
- package/dist/backend/commands/product-content-commands.d.ts.map +0 -1
- package/dist/backend/commands/product-content-commands.js.map +0 -1
- package/dist/backend/commands/scoped-values.commands.d.ts.map +0 -1
- package/dist/backend/commands/scoped-values.commands.js.map +0 -1
- package/dist/backend/demo/reset.d.ts.map +0 -1
- package/dist/backend/demo/reset.js.map +0 -1
- package/dist/backend/demo/rows.d.ts.map +0 -1
- package/dist/backend/demo/rows.js.map +0 -1
- package/dist/backend/demo/seed.d.ts.map +0 -1
- package/dist/backend/demo/seed.js.map +0 -1
- package/dist/backend/entities/attachment-type.entity.d.ts.map +0 -1
- package/dist/backend/entities/attachment-type.entity.js.map +0 -1
- package/dist/backend/entities/attribute-set-attribute.entity.d.ts.map +0 -1
- package/dist/backend/entities/attribute-set-attribute.entity.js.map +0 -1
- package/dist/backend/entities/attribute-set.entity.d.ts.map +0 -1
- package/dist/backend/entities/attribute-set.entity.js.map +0 -1
- package/dist/backend/entities/bulk-operation.entity.d.ts.map +0 -1
- package/dist/backend/entities/bulk-operation.entity.js.map +0 -1
- package/dist/backend/entities/bundle-slot-option.entity.d.ts.map +0 -1
- package/dist/backend/entities/bundle-slot-option.entity.js.map +0 -1
- package/dist/backend/entities/bundle-slot.entity.d.ts.map +0 -1
- package/dist/backend/entities/bundle-slot.entity.js.map +0 -1
- package/dist/backend/entities/category.entity.d.ts.map +0 -1
- package/dist/backend/entities/category.entity.js.map +0 -1
- package/dist/backend/entities/gallery-item-label.entity.d.ts.map +0 -1
- package/dist/backend/entities/gallery-item-label.entity.js.map +0 -1
- package/dist/backend/entities/gallery-item-scope-override.entity.d.ts.map +0 -1
- package/dist/backend/entities/gallery-item-scope-override.entity.js.map +0 -1
- package/dist/backend/entities/gallery-item.entity.d.ts.map +0 -1
- package/dist/backend/entities/gallery-item.entity.js.map +0 -1
- package/dist/backend/entities/gallery-role-scope-override.entity.d.ts.map +0 -1
- package/dist/backend/entities/gallery-role-scope-override.entity.js.map +0 -1
- package/dist/backend/entities/grouped-item.entity.d.ts.map +0 -1
- package/dist/backend/entities/grouped-item.entity.js.map +0 -1
- package/dist/backend/entities/product-attachment-scope-override.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-attachment-scope-override.entity.js.map +0 -1
- package/dist/backend/entities/product-attachment.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-attachment.entity.js.map +0 -1
- package/dist/backend/entities/product-attribute.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-attribute.entity.js.map +0 -1
- package/dist/backend/entities/product-channel-language-scope.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-channel-language-scope.entity.js.map +0 -1
- package/dist/backend/entities/product-channel-scope.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-channel-scope.entity.js.map +0 -1
- package/dist/backend/entities/product-content-value.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-content-value.entity.js.map +0 -1
- package/dist/backend/entities/product-editor-preference.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-editor-preference.entity.js.map +0 -1
- package/dist/backend/entities/product-link.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-link.entity.js.map +0 -1
- package/dist/backend/entities/product-list-saved-view.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-list-saved-view.entity.js.map +0 -1
- package/dist/backend/entities/product-packaging-unit-scope-override.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-packaging-unit-scope-override.entity.js.map +0 -1
- package/dist/backend/entities/product-packaging-unit.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-packaging-unit.entity.js.map +0 -1
- package/dist/backend/entities/product-url-key.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-url-key.entity.js.map +0 -1
- package/dist/backend/entities/product-url-redirect.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-url-redirect.entity.js.map +0 -1
- package/dist/backend/entities/product-value-override.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-value-override.entity.js.map +0 -1
- package/dist/backend/entities/product-variant.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-variant.entity.js.map +0 -1
- package/dist/backend/entities/product.entity.d.ts.map +0 -1
- package/dist/backend/entities/product.entity.js.map +0 -1
- package/dist/backend/index.d.ts.map +0 -1
- package/dist/backend/index.js.map +0 -1
- package/dist/backend/plugin.d.ts.map +0 -1
- package/dist/backend/plugin.js.map +0 -1
- package/dist/backend/prompt-tools.d.ts.map +0 -1
- package/dist/backend/prompt-tools.js.map +0 -1
- package/dist/backend/routes.admin.d.ts.map +0 -1
- package/dist/backend/routes.admin.js.map +0 -1
- package/dist/backend/routes.admin.url-keys.d.ts.map +0 -1
- package/dist/backend/routes.admin.url-keys.js.map +0 -1
- package/dist/backend/routes.api-key.d.ts.map +0 -1
- package/dist/backend/routes.api-key.js.map +0 -1
- package/dist/backend/routes.external.d.ts.map +0 -1
- package/dist/backend/routes.external.js.map +0 -1
- package/dist/backend/routes.public.d.ts.map +0 -1
- package/dist/backend/routes.public.js.map +0 -1
- package/dist/backend/routes.public.url-keys.d.ts.map +0 -1
- package/dist/backend/routes.public.url-keys.js.map +0 -1
- package/dist/backend/saved-view-actor.d.ts.map +0 -1
- package/dist/backend/saved-view-actor.js.map +0 -1
- package/dist/backend/services/asset-references.d.ts.map +0 -1
- package/dist/backend/services/asset-references.js.map +0 -1
- package/dist/backend/services/attachment-packaging-scopes.d.ts.map +0 -1
- package/dist/backend/services/attachment-packaging-scopes.js.map +0 -1
- package/dist/backend/services/attachment.service.d.ts.map +0 -1
- package/dist/backend/services/attachment.service.js.map +0 -1
- package/dist/backend/services/attribute-filter-match.d.ts.map +0 -1
- package/dist/backend/services/attribute-filter-match.js.map +0 -1
- package/dist/backend/services/attribute-option-validator.d.ts.map +0 -1
- package/dist/backend/services/attribute-option-validator.js.map +0 -1
- package/dist/backend/services/attribute-scope-preview.d.ts.map +0 -1
- package/dist/backend/services/attribute-scope-preview.js.map +0 -1
- package/dist/backend/services/attribute-set-validations.d.ts.map +0 -1
- package/dist/backend/services/attribute-set-validations.js.map +0 -1
- package/dist/backend/services/attribute-set.service.d.ts.map +0 -1
- package/dist/backend/services/attribute-set.service.js.map +0 -1
- package/dist/backend/services/attribute-type-mapping.d.ts.map +0 -1
- package/dist/backend/services/attribute-type-mapping.js.map +0 -1
- package/dist/backend/services/attribute-usage.d.ts.map +0 -1
- package/dist/backend/services/attribute-usage.js.map +0 -1
- package/dist/backend/services/attribute-value-key.service.d.ts.map +0 -1
- package/dist/backend/services/attribute-value-key.service.js.map +0 -1
- package/dist/backend/services/audit-references.d.ts.map +0 -1
- package/dist/backend/services/audit-references.js.map +0 -1
- package/dist/backend/services/bulk-operation-queue.d.ts.map +0 -1
- package/dist/backend/services/bulk-operation-queue.js.map +0 -1
- package/dist/backend/services/bulk-operation.service.d.ts.map +0 -1
- package/dist/backend/services/bulk-operation.service.js.map +0 -1
- package/dist/backend/services/bundle.service.d.ts.map +0 -1
- package/dist/backend/services/bundle.service.js.map +0 -1
- package/dist/backend/services/catalog-admin-search.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-admin-search.service.js.map +0 -1
- package/dist/backend/services/catalog-admin.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-admin.service.js.map +0 -1
- package/dist/backend/services/catalog-attribute-read.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-attribute-read.service.js.map +0 -1
- package/dist/backend/services/catalog-bulk-import.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-bulk-import.service.js.map +0 -1
- package/dist/backend/services/catalog-bulk-update.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-bulk-update.service.js.map +0 -1
- package/dist/backend/services/catalog-category-read.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-category-read.service.js.map +0 -1
- package/dist/backend/services/catalog-org-price-decorator.d.ts.map +0 -1
- package/dist/backend/services/catalog-org-price-decorator.js.map +0 -1
- package/dist/backend/services/catalog-product-filter.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-product-filter.service.js.map +0 -1
- package/dist/backend/services/catalog-product-read.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-product-read.service.js.map +0 -1
- package/dist/backend/services/catalog-query.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-query.service.js.map +0 -1
- package/dist/backend/services/catalog-quick-search.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-quick-search.service.js.map +0 -1
- package/dist/backend/services/catalog-write-ports.d.ts.map +0 -1
- package/dist/backend/services/catalog-write-ports.js.map +0 -1
- package/dist/backend/services/category-admin.service.d.ts.map +0 -1
- package/dist/backend/services/category-admin.service.js.map +0 -1
- package/dist/backend/services/channel-url-facts.d.ts.map +0 -1
- package/dist/backend/services/channel-url-facts.js.map +0 -1
- package/dist/backend/services/content-attribute-rules.d.ts.map +0 -1
- package/dist/backend/services/content-attribute-rules.js.map +0 -1
- package/dist/backend/services/effective-value.sql.d.ts.map +0 -1
- package/dist/backend/services/effective-value.sql.js.map +0 -1
- package/dist/backend/services/gallery-scopes.d.ts.map +0 -1
- package/dist/backend/services/gallery-scopes.js.map +0 -1
- package/dist/backend/services/gallery.service.d.ts.map +0 -1
- package/dist/backend/services/gallery.service.js.map +0 -1
- package/dist/backend/services/grouped.service.d.ts.map +0 -1
- package/dist/backend/services/grouped.service.js.map +0 -1
- package/dist/backend/services/label-resolver.d.ts.map +0 -1
- package/dist/backend/services/label-resolver.js.map +0 -1
- package/dist/backend/services/linkable-asset.d.ts.map +0 -1
- package/dist/backend/services/linkable-asset.js.map +0 -1
- package/dist/backend/services/packaging-unit.service.d.ts.map +0 -1
- package/dist/backend/services/packaging-unit.service.js.map +0 -1
- package/dist/backend/services/page-builder-content.d.ts.map +0 -1
- package/dist/backend/services/page-builder-content.js.map +0 -1
- package/dist/backend/services/primary-asset-url.d.ts.map +0 -1
- package/dist/backend/services/primary-asset-url.js.map +0 -1
- package/dist/backend/services/product-availability.service.d.ts.map +0 -1
- package/dist/backend/services/product-availability.service.js.map +0 -1
- package/dist/backend/services/product-availability.sql.d.ts.map +0 -1
- package/dist/backend/services/product-availability.sql.js.map +0 -1
- package/dist/backend/services/product-content.service.d.ts.map +0 -1
- package/dist/backend/services/product-content.service.js.map +0 -1
- package/dist/backend/services/product-editor-preferences.service.d.ts.map +0 -1
- package/dist/backend/services/product-editor-preferences.service.js.map +0 -1
- package/dist/backend/services/product-global-field-rules.d.ts.map +0 -1
- package/dist/backend/services/product-global-field-rules.js.map +0 -1
- package/dist/backend/services/product-link.service.d.ts.map +0 -1
- package/dist/backend/services/product-link.service.js.map +0 -1
- package/dist/backend/services/product-list-view-service.d.ts.map +0 -1
- package/dist/backend/services/product-list-view-service.js.map +0 -1
- package/dist/backend/services/product-page-revalidation.d.ts.map +0 -1
- package/dist/backend/services/product-page-revalidation.js.map +0 -1
- package/dist/backend/services/product-scopes.service.d.ts.map +0 -1
- package/dist/backend/services/product-scopes.service.js.map +0 -1
- package/dist/backend/services/product-summary-text.d.ts.map +0 -1
- package/dist/backend/services/product-summary-text.js.map +0 -1
- package/dist/backend/services/product-type-validations.d.ts.map +0 -1
- package/dist/backend/services/product-type-validations.js.map +0 -1
- package/dist/backend/services/product-value-resolver.service.d.ts.map +0 -1
- package/dist/backend/services/product-value-resolver.service.js.map +0 -1
- package/dist/backend/services/publication-window-sweep.d.ts.map +0 -1
- package/dist/backend/services/publication-window-sweep.js.map +0 -1
- package/dist/backend/services/scheduled-work-probe.d.ts.map +0 -1
- package/dist/backend/services/scheduled-work-probe.js.map +0 -1
- package/dist/backend/services/scope-completeness.d.ts.map +0 -1
- package/dist/backend/services/scope-completeness.js.map +0 -1
- package/dist/backend/services/scope-overview.service.d.ts.map +0 -1
- package/dist/backend/services/scope-overview.service.js.map +0 -1
- package/dist/backend/services/scoped-store-adapters.d.ts.map +0 -1
- package/dist/backend/services/scoped-store-adapters.js.map +0 -1
- package/dist/backend/services/scoped-values-global-only.d.ts.map +0 -1
- package/dist/backend/services/scoped-values-global-only.js.map +0 -1
- package/dist/backend/services/scoped-values-import.d.ts.map +0 -1
- package/dist/backend/services/scoped-values-import.js.map +0 -1
- package/dist/backend/services/scoped-values-read.service.d.ts.map +0 -1
- package/dist/backend/services/scoped-values-read.service.js.map +0 -1
- package/dist/backend/services/scoped-values-save.service.d.ts.map +0 -1
- package/dist/backend/services/scoped-values-save.service.js.map +0 -1
- package/dist/backend/services/scoped-values-state.d.ts.map +0 -1
- package/dist/backend/services/scoped-values-state.js.map +0 -1
- package/dist/backend/services/scoped-values.service.d.ts.map +0 -1
- package/dist/backend/services/scoped-values.service.js.map +0 -1
- package/dist/backend/services/sql-id-arrays.d.ts.map +0 -1
- package/dist/backend/services/sql-id-arrays.js.map +0 -1
- package/dist/backend/services/storefront-value-overrides.d.ts.map +0 -1
- package/dist/backend/services/storefront-value-overrides.js.map +0 -1
- package/dist/backend/services/system-attribute-scopes.d.ts.map +0 -1
- package/dist/backend/services/system-attribute-scopes.js.map +0 -1
- package/dist/backend/services/url-key-resolution.service.d.ts.map +0 -1
- package/dist/backend/services/url-key-resolution.service.js.map +0 -1
- package/dist/backend/services/url-key.service.d.ts.map +0 -1
- package/dist/backend/services/url-key.service.js.map +0 -1
- package/dist/backend/services/viewer-organization.d.ts.map +0 -1
- package/dist/backend/services/viewer-organization.js.map +0 -1
- package/dist/manifest.d.ts.map +0 -1
- package/dist/manifest.js.map +0 -1
- package/dist/migrations/20260429T064146_catalog_attribute_sets_init.d.ts.map +0 -1
- package/dist/migrations/20260429T064146_catalog_attribute_sets_init.js.map +0 -1
- package/dist/migrations/20260429T070004_catalog_product_attribute_extensions.d.ts.map +0 -1
- package/dist/migrations/20260429T070004_catalog_product_attribute_extensions.js.map +0 -1
- package/dist/migrations/20260429T102322_catalog_product_type_and_virtual_fields.d.ts.map +0 -1
- package/dist/migrations/20260429T102322_catalog_product_type_and_virtual_fields.js.map +0 -1
- package/dist/migrations/20260429T111839_catalog_gallery_items_and_labels.d.ts.map +0 -1
- package/dist/migrations/20260429T111839_catalog_gallery_items_and_labels.js.map +0 -1
- package/dist/migrations/20260429T112543_catalog_product_attachments.d.ts.map +0 -1
- package/dist/migrations/20260429T112543_catalog_product_attachments.js.map +0 -1
- package/dist/migrations/20260429T123726_catalog_product_links.d.ts.map +0 -1
- package/dist/migrations/20260429T123726_catalog_product_links.js.map +0 -1
- package/dist/migrations/20260429T130803_catalog_grouped_and_bundle.d.ts.map +0 -1
- package/dist/migrations/20260429T130803_catalog_grouped_and_bundle.js.map +0 -1
- package/dist/migrations/20260501T185835_catalog_product_attribute_is_comparable.d.ts.map +0 -1
- package/dist/migrations/20260501T185835_catalog_product_attribute_is_comparable.js.map +0 -1
- package/dist/migrations/20260505T060113_catalog_attribute_options_and_flags.d.ts.map +0 -1
- package/dist/migrations/20260505T060113_catalog_attribute_options_and_flags.js.map +0 -1
- package/dist/migrations/20260515T082629_catalog_attribute_mass_editable.d.ts.map +0 -1
- package/dist/migrations/20260515T082629_catalog_attribute_mass_editable.js.map +0 -1
- package/dist/migrations/20260526T124736_catalog_product_status_inactive.d.ts.map +0 -1
- package/dist/migrations/20260526T124736_catalog_product_status_inactive.js.map +0 -1
- package/dist/migrations/20260611T140346_catalog_product_value_overrides_init.d.ts.map +0 -1
- package/dist/migrations/20260611T140346_catalog_product_value_overrides_init.js.map +0 -1
- package/dist/migrations/20260611T140400_catalog_attribute_quick_searchable.d.ts.map +0 -1
- package/dist/migrations/20260611T140400_catalog_attribute_quick_searchable.js.map +0 -1
- package/dist/migrations/20260611T140407_catalog_bulk_operations.d.ts.map +0 -1
- package/dist/migrations/20260611T140407_catalog_bulk_operations.js.map +0 -1
- package/dist/migrations/20260611T140408_catalog_bulk_operation_logs.d.ts.map +0 -1
- package/dist/migrations/20260611T140408_catalog_bulk_operation_logs.js.map +0 -1
- package/dist/migrations/20260611T140412_catalog_product_packaging_units.d.ts.map +0 -1
- package/dist/migrations/20260611T140412_catalog_product_packaging_units.js.map +0 -1
- package/dist/migrations/20260718T060659_catalog_bulk_operation_revert_state.d.ts.map +0 -1
- package/dist/migrations/20260718T060659_catalog_bulk_operation_revert_state.js.map +0 -1
- package/dist/migrations/20260718T200343_catalog_category_custom_field_values.d.ts.map +0 -1
- package/dist/migrations/20260718T200343_catalog_category_custom_field_values.js.map +0 -1
- package/dist/migrations/20260723T230401_catalog_attributes_on_custom_fields.d.ts.map +0 -1
- package/dist/migrations/20260723T230401_catalog_attributes_on_custom_fields.js.map +0 -1
- package/dist/migrations/20260804T152604_catalog_widen_product_sku.d.ts.map +0 -1
- package/dist/migrations/20260804T152604_catalog_widen_product_sku.js.map +0 -1
- package/dist/migrations/20260804T160244_catalog_category_activation.d.ts.map +0 -1
- package/dist/migrations/20260804T160244_catalog_category_activation.js.map +0 -1
- package/dist/migrations/20260912T094557_catalog_sales_channel_products.d.ts.map +0 -1
- package/dist/migrations/20260912T094557_catalog_sales_channel_products.js.map +0 -1
- package/dist/migrations/20260912T094623_catalog_sales_channel_categories.d.ts.map +0 -1
- package/dist/migrations/20260912T094623_catalog_sales_channel_categories.js.map +0 -1
- package/dist/migrations/20260925T125527_catalog_inventory_columns.d.ts.map +0 -1
- package/dist/migrations/20260925T125527_catalog_inventory_columns.js.map +0 -1
- package/dist/migrations/20261008T080839_catalog_product_attribute_is_price_rule.d.ts.map +0 -1
- package/dist/migrations/20261008T080839_catalog_product_attribute_is_price_rule.js.map +0 -1
- package/dist/migrations/20261008T092714_catalog_category_content.d.ts.map +0 -1
- package/dist/migrations/20261008T092714_catalog_category_content.js.map +0 -1
- package/dist/migrations/20261014T170531_catalog_product_list_saved_views.d.ts.map +0 -1
- package/dist/migrations/20261014T170531_catalog_product_list_saved_views.js.map +0 -1
- package/dist/migrations/20261016T082008_catalog_order_rules.d.ts.map +0 -1
- package/dist/migrations/20261016T082008_catalog_order_rules.js.map +0 -1
- package/dist/migrations/20261022T035133_catalog_product_scopes.d.ts.map +0 -1
- package/dist/migrations/20261022T035133_catalog_product_scopes.js.map +0 -1
- package/dist/migrations/20261022T054223_catalog_product_url_keys.d.ts.map +0 -1
- package/dist/migrations/20261022T054223_catalog_product_url_keys.js.map +0 -1
- package/dist/migrations/20261022T111811_catalog_price_fields_removed.d.ts.map +0 -1
- package/dist/migrations/20261022T111811_catalog_price_fields_removed.js.map +0 -1
- package/dist/migrations/20261022T182523_catalog_admin_name_keys.d.ts.map +0 -1
- package/dist/migrations/20261022T182523_catalog_admin_name_keys.js.map +0 -1
- package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.d.ts.map +0 -1
- package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.js.map +0 -1
- package/dist/migrations/20261026T033453_catalog_product_media_scopes.d.ts.map +0 -1
- package/dist/migrations/20261026T033453_catalog_product_media_scopes.js.map +0 -1
- package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.d.ts.map +0 -1
- package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.js.map +0 -1
- package/dist/migrations/20261030T113855_catalog_scope_model_texts.d.ts.map +0 -1
- package/dist/migrations/20261030T113855_catalog_scope_model_texts.js.map +0 -1
- package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.d.ts.map +0 -1
- package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.js.map +0 -1
- package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.d.ts.map +0 -1
- package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.js.map +0 -1
- package/dist/migrations/20261030T113908_catalog_scope_model_media.d.ts.map +0 -1
- package/dist/migrations/20261030T113908_catalog_scope_model_media.js.map +0 -1
- package/dist/migrations/20261104T121504_catalog_product_content_values.d.ts.map +0 -1
- package/dist/migrations/20261104T121504_catalog_product_content_values.js.map +0 -1
- package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.d.ts.map +0 -1
- package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.js.map +0 -1
- package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.d.ts.map +0 -1
- package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.js.map +0 -1
- package/dist/migrations/index.d.ts.map +0 -1
- package/dist/migrations/index.js.map +0 -1
- package/dist/ports/index.d.ts.map +0 -1
- package/dist/ports/index.js.map +0 -1
package/dist/migrations/index.js
CHANGED
|
@@ -68,6 +68,7 @@ import { Migration20261030T113908CatalogScopeModelMedia } from './20261030T11390
|
|
|
68
68
|
import { Migration20261104T121504CatalogProductContentValues } from './20261104T121504_catalog_product_content_values.js';
|
|
69
69
|
import { Migration20261107T093126CatalogSkuUniqueAmongLive } from './20261107T093126_catalog_sku_unique_among_live.js';
|
|
70
70
|
import { Migration20261107T120008CatalogProductCreatedAtMilliseconds } from './20261107T120008_catalog_product_created_at_milliseconds.js';
|
|
71
|
+
import { Migration20261114T000706CatalogCategoryMainImage } from './20261114T000706_catalog_category_main_image.js';
|
|
71
72
|
export const migrations = [
|
|
72
73
|
Migration20260429T064146CatalogAttributeSetsInit,
|
|
73
74
|
Migration20260429T070004CatalogProductAttributeExtensions,
|
|
@@ -111,6 +112,7 @@ export const migrations = [
|
|
|
111
112
|
Migration20261104T121504CatalogProductContentValues,
|
|
112
113
|
Migration20261107T093126CatalogSkuUniqueAmongLive,
|
|
113
114
|
Migration20261107T120008CatalogProductCreatedAtMilliseconds,
|
|
115
|
+
Migration20261114T000706CatalogCategoryMainImage,
|
|
114
116
|
];
|
|
115
|
-
export { Migration20260429T064146CatalogAttributeSetsInit, Migration20260429T070004CatalogProductAttributeExtensions, Migration20260429T102322CatalogProductTypeAndVirtualFields, Migration20260429T111839CatalogGalleryItemsAndLabels, Migration20260429T112543CatalogProductAttachments, Migration20260429T123726CatalogProductLinks, Migration20260429T130803CatalogGroupedAndBundle, Migration20260501T185835CatalogProductAttributeIsComparable, Migration20260505T060113CatalogAttributeOptionsAndFlags, Migration20260515T082629CatalogAttributeMassEditable, Migration20260526T124736CatalogProductStatusInactive, Migration20260611T140346CatalogProductValueOverridesInit, Migration20260611T140400CatalogAttributeQuickSearchable, Migration20260611T140407CatalogBulkOperations, Migration20260611T140408CatalogBulkOperationLogs, Migration20260611T140412CatalogProductPackagingUnits, Migration20260718T060659CatalogBulkOperationRevertState, Migration20260718T200343CatalogCategoryCustomFieldValues, Migration20260723T230401CatalogAttributesOnCustomFields, Migration20260804T152604CatalogWidenProductSku, Migration20260804T160244CatalogCategoryActivation, Migration20260912T094557CatalogSalesChannelProducts, Migration20260912T094623CatalogSalesChannelCategories, Migration20260925T125527CatalogInventoryColumns, Migration20261008T080839CatalogProductAttributeIsPriceRule, Migration20261008T092714CatalogCategoryContent, Migration20261014T170531CatalogProductListSavedViews, Migration20261016T082008CatalogOrderRules, Migration20261022T035133CatalogProductScopes, Migration20261022T054223CatalogProductUrlKeys, Migration20261022T111811CatalogPriceFieldsRemoved, Migration20261022T182523CatalogAdminNameKeys, Migration20261025T222634CatalogProductStatusDropDraft, Migration20261026T033453CatalogProductMediaScopes, Migration20261026T084533CatalogAttachmentPackagingTranslations, Migration20261030T113855CatalogScopeModelTexts, Migration20261030T113859CatalogScopeModelOrderRules, Migration20261030T113904CatalogScopeModelUrlKeys, Migration20261030T113908CatalogScopeModelMedia, Migration20261104T121504CatalogProductContentValues, Migration20261107T093126CatalogSkuUniqueAmongLive, Migration20261107T120008CatalogProductCreatedAtMilliseconds, };
|
|
117
|
+
export { Migration20260429T064146CatalogAttributeSetsInit, Migration20260429T070004CatalogProductAttributeExtensions, Migration20260429T102322CatalogProductTypeAndVirtualFields, Migration20260429T111839CatalogGalleryItemsAndLabels, Migration20260429T112543CatalogProductAttachments, Migration20260429T123726CatalogProductLinks, Migration20260429T130803CatalogGroupedAndBundle, Migration20260501T185835CatalogProductAttributeIsComparable, Migration20260505T060113CatalogAttributeOptionsAndFlags, Migration20260515T082629CatalogAttributeMassEditable, Migration20260526T124736CatalogProductStatusInactive, Migration20260611T140346CatalogProductValueOverridesInit, Migration20260611T140400CatalogAttributeQuickSearchable, Migration20260611T140407CatalogBulkOperations, Migration20260611T140408CatalogBulkOperationLogs, Migration20260611T140412CatalogProductPackagingUnits, Migration20260718T060659CatalogBulkOperationRevertState, Migration20260718T200343CatalogCategoryCustomFieldValues, Migration20260723T230401CatalogAttributesOnCustomFields, Migration20260804T152604CatalogWidenProductSku, Migration20260804T160244CatalogCategoryActivation, Migration20260912T094557CatalogSalesChannelProducts, Migration20260912T094623CatalogSalesChannelCategories, Migration20260925T125527CatalogInventoryColumns, Migration20261008T080839CatalogProductAttributeIsPriceRule, Migration20261008T092714CatalogCategoryContent, Migration20261014T170531CatalogProductListSavedViews, Migration20261016T082008CatalogOrderRules, Migration20261022T035133CatalogProductScopes, Migration20261022T054223CatalogProductUrlKeys, Migration20261022T111811CatalogPriceFieldsRemoved, Migration20261022T182523CatalogAdminNameKeys, Migration20261025T222634CatalogProductStatusDropDraft, Migration20261026T033453CatalogProductMediaScopes, Migration20261026T084533CatalogAttachmentPackagingTranslations, Migration20261030T113855CatalogScopeModelTexts, Migration20261030T113859CatalogScopeModelOrderRules, Migration20261030T113904CatalogScopeModelUrlKeys, Migration20261030T113908CatalogScopeModelMedia, Migration20261104T121504CatalogProductContentValues, Migration20261107T093126CatalogSkuUniqueAmongLive, Migration20261107T120008CatalogProductCreatedAtMilliseconds, Migration20261114T000706CatalogCategoryMainImage, };
|
|
116
118
|
//# sourceMappingURL=index.js.map
|
|
@@ -39,6 +39,7 @@ omitted, the system Default Set is used.
|
|
|
39
39
|
| `ATTRIBUTE_SET_CODE_TAKEN` | 409 | `code` already exists |
|
|
40
40
|
| `ATTRIBUTE_SET_IN_USE` | 409 | Delete blocked: at least one Product references the set |
|
|
41
41
|
| `SYSTEM_ATTRIBUTE_SET_IMMUTABLE` | 409 | Mutating the seeded Default Set |
|
|
42
|
+
| `ATTRIBUTE_VALUES_REQUIRED` | 400 | A product save leaves attributes the set requires without a value (`details.attributeKeys`, joined) |
|
|
42
43
|
| `ATTRIBUTE_SET_NOT_FOUND` | 404 | `:id` missing |
|
|
43
44
|
| `ATTRIBUTE_NOT_FOUND` | 404 | `:key` missing on assignment |
|
|
44
45
|
|
|
@@ -27,6 +27,7 @@ Every attribute carries:
|
|
|
27
27
|
| `labelDefault` | Fallback label used when the active storefront / admin locale is missing from `label`. |
|
|
28
28
|
| `valueType` | One of `string`, `number`, `boolean`, `price`, `date`, `select`, `multiselect`, `enum`, `page_builder`. |
|
|
29
29
|
| `options[]` | Ordered list of selectable options — only for `select` / `multiselect` / `enum`. See [Option lists](#option-lists) below. |
|
|
30
|
+
| `adminAccess` | **Admin access**: `edit` (*Editable*, the default), `read` (*Read-only*) or `hidden` (*Hidden*), stored on the attribute's custom-field definition and answered on every attribute response. It only changes the admin panel: it does not restrict the API, filters, exports or the audit log. A required attribute must stay `edit` — anything else is refused with `400 VALIDATION_FAILED`, and the attribute editor keeps *Read-only* and *Hidden* unavailable while the attribute is required. |
|
|
30
31
|
|
|
31
32
|
Plus the behavioural flags and a numeric position:
|
|
32
33
|
|
|
@@ -57,8 +58,8 @@ Plus the behavioural flags and a numeric position:
|
|
|
57
58
|
| `enum` | option `value` | Same storage shape as `select`; renders as a compact pill / segmented control on storefront filters and the PDP rather than a dropdown. |
|
|
58
59
|
| `page_builder` | one Page Builder document per language, stored apart from `attribute_values` | **Page Builder content** — see [Product content](./product-content.md). |
|
|
59
60
|
|
|
60
|
-
Changing `valueType` while any product
|
|
61
|
-
|
|
61
|
+
Changing `valueType` while any product holds a value for the attribute is
|
|
62
|
+
refused with `409 ATTRIBUTE_VALUE_TYPE_LOCKED`; clear the values first.
|
|
62
63
|
|
|
63
64
|
### Page Builder content
|
|
64
65
|
|
|
@@ -71,10 +72,12 @@ tab ([Product content](./product-content.md)). Its settings are fixed:
|
|
|
71
72
|
- `isSearchable`, `isFilterable`, `isVariantAxis`, `displayAsSlider`,
|
|
72
73
|
`isComparable`, `quickSearchable`, `isPromoRule`, `isPriceRule`,
|
|
73
74
|
`massEditable`, `isRequired`, `isVisibleOnProductPage` and `scopable`
|
|
74
|
-
stay `false`. Setting any of them
|
|
75
|
-
`400 VALIDATION_FAILED`, one detail per setting
|
|
75
|
+
stay `false`. Setting any of them is refused and nothing is stored: on
|
|
76
|
+
create with `400 VALIDATION_FAILED`, one detail per setting; on update, where
|
|
77
|
+
the stored type refuses it, with `400 CONTENT_ATTRIBUTE_CAPABILITY_LOCKED`;
|
|
76
78
|
- it has no options;
|
|
77
|
-
- its type cannot be changed, and no attribute can be changed into it
|
|
79
|
+
- its type cannot be changed, and no attribute can be changed into it
|
|
80
|
+
(`409 ATTRIBUTE_VALUE_TYPE_LOCKED`, token `page_builder`).
|
|
78
81
|
|
|
79
82
|
The attribute editor hides those settings for this type, and the list shows the
|
|
80
83
|
row's flags locked. The type is admissible for products only.
|
|
@@ -95,7 +98,7 @@ authored inline on the attribute editor. Each option carries:
|
|
|
95
98
|
Option **values** are immutable while any product still carries them —
|
|
96
99
|
the operator must migrate dependent values first. Option **labels** can
|
|
97
100
|
always be renamed. Deleting an option is refused with
|
|
98
|
-
`409
|
|
101
|
+
`409 ATTRIBUTE_OPTION_IN_USE` while any product still carries that value.
|
|
99
102
|
|
|
100
103
|
## Public surface
|
|
101
104
|
|
|
@@ -107,14 +110,14 @@ Admin routes are gated by `catalog:read` (list / get) /
|
|
|
107
110
|
| `GET /api/v1/admin/catalog/attributes` | admin | List attributes |
|
|
108
111
|
| `GET /api/v1/admin/catalog/attributes/by-flag?flag=isPromoRule\|isComparable\|...` | admin | Picker payload — every attribute carrying the requested flag |
|
|
109
112
|
| `GET /api/v1/admin/catalog/attributes/:idOrKey` | admin | Single attribute read |
|
|
110
|
-
| `POST /api/v1/admin/catalog/attributes` | admin | Create attribute (accepts the flags + inline `options[]` for select-style types) |
|
|
113
|
+
| `POST /api/v1/admin/catalog/attributes` | admin | Create attribute (accepts the flags, `adminAccess` + inline `options[]` for select-style types) |
|
|
111
114
|
| `PATCH /api/v1/admin/catalog/attributes/:key` | admin | Update labels and hot-toggle `isFilterable` / `isSearchable` / `isVariantAxis` / `isPromoRule` / `isPriceRule` / `isComparable` / `isVisibleOnProductPage` / `isRequired` / `filterPosition`. Re-emits `attribute.updated.v1`. |
|
|
112
115
|
| `GET /api/v1/admin/catalog/attributes/:idOrKey/usage` | admin (`catalog:read`) | What deleting the attribute would meet: `{ attributeSetCount, productValueCount, productContentCount }` — see [Deleting an attribute](#deleting-an-attribute) |
|
|
113
116
|
| `DELETE /api/v1/admin/catalog/attributes/:idOrKey` | admin (`catalog:write`) | Delete an attribute of any type; refused with `409` while an Attribute Set contains it or a product holds a value for it — see [Deleting an attribute](#deleting-an-attribute) |
|
|
114
117
|
| `GET /api/v1/admin/catalog/attributes/:idOrKey/options` | admin | List option rows for select / enum / multiselect attributes |
|
|
115
118
|
| `POST /api/v1/admin/catalog/attributes/:idOrKey/options` | admin | Append an option |
|
|
116
|
-
| `PATCH /api/v1/admin/catalog/
|
|
117
|
-
| `DELETE /api/v1/admin/catalog/
|
|
119
|
+
| `PATCH /api/v1/admin/catalog/attributes/:attributeId/options/:optionId` | admin | Patch `label` / `labelDefault` / `isDefault` / `sortOrder` (option `value` is immutable) |
|
|
120
|
+
| `DELETE /api/v1/admin/catalog/attributes/:attributeId/options/:optionId` | admin | Remove; refused with `409 ATTRIBUTE_OPTION_IN_USE` while any product still carries the value |
|
|
118
121
|
|
|
119
122
|
Filter sidebar reads consume `GET /api/v1/catalog/filters` (defined on
|
|
120
123
|
the [Catalog](../catalog.md) page) — that endpoint resolves the
|
|
@@ -158,16 +161,27 @@ deleted product no longer does; and the delete now emits
|
|
|
158
161
|
|
|
159
162
|
## Errors
|
|
160
163
|
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
|
164
|
+
Each refusal the stored attribute or its options make has its own code and a
|
|
165
|
+
sentence in English and Polish that names the values in `details`. Until issue
|
|
166
|
+
#624 (and issue #1218 for Page Builder content attributes) they were
|
|
167
|
+
`VALIDATION_FAILED` with an English message or a machine token
|
|
168
|
+
(`option_in_use: …`). A malformed request — a key that does not match
|
|
169
|
+
`^[a-z][a-z0-9_]*$`, an option value that does not match its pattern, options,
|
|
170
|
+
a slider or a content attribute's locked setting on a type the same request
|
|
171
|
+
names — stays `400 VALIDATION_FAILED`.
|
|
172
|
+
|
|
173
|
+
| Code | Status | When | `details` |
|
|
174
|
+
| --- | --- | --- | --- |
|
|
175
|
+
| `ATTRIBUTE_KEY_TAKEN` | 409 | Another attribute already has the key | `attributeKey` |
|
|
176
|
+
| `ATTRIBUTE_VALUE_TYPE_LOCKED` | 409 | The value type is changed while products hold values for the attribute; token `page_builder`: changed to or from Page Builder content | `attributeKey` |
|
|
177
|
+
| `ATTRIBUTE_IN_USE` | 409 | Delete blocked: an attribute set contains the attribute (token `attribute_sets`), or products hold its values (token `products`) | `attributeKey`, `attributeSetCount` or `productCount` |
|
|
178
|
+
| `ATTRIBUTE_OPTION_VALUE_TAKEN` | 409 | The attribute already has an option with the value | `attributeKey`, `value` |
|
|
179
|
+
| `ATTRIBUTE_DEFAULT_OPTION_TAKEN` | 409 | A second default option on a single-choice attribute, on create or when an option is made the default | `attributeKey`, `value` |
|
|
180
|
+
| `ATTRIBUTE_OPTIONS_NOT_SUPPORTED` | 400 | An option is written to an attribute whose type takes none | `attributeKey`, `valueType` |
|
|
181
|
+
| `ATTRIBUTE_OPTION_IN_USE` | 409 | Delete blocked: products carry the option (token `products` with the count) | `attributeKey`, `value`, `productCount` |
|
|
182
|
+
| `ATTRIBUTE_SLIDER_NOT_SUPPORTED` | 400 | `displayAsSlider` is turned on for an attribute whose stored type is not a number or a price | `attributeKey`, `valueType` |
|
|
183
|
+
| `CONTENT_ATTRIBUTE_CAPABILITY_LOCKED` | 400 | An update switches on a setting a Page Builder content attribute holds off | `attributeKey`, `capabilities` (joined) |
|
|
184
|
+
| `NOT_FOUND` | 404 | `:idOrKey` or `:optionId` missing | — |
|
|
171
185
|
|
|
172
186
|
## Storefront integration
|
|
173
187
|
|
|
@@ -269,7 +283,7 @@ them again.
|
|
|
269
283
|
All attribute and option mutations flow through the catalog Commands
|
|
270
284
|
behind `/catalog/attributes` — the generic Custom Fields admin surface
|
|
271
285
|
lists product definitions read-only and refuses mutations with
|
|
272
|
-
`409
|
|
286
|
+
`409 CUSTOM_FIELD_HOST_MANAGED`.
|
|
273
287
|
|
|
274
288
|
## Events emitted
|
|
275
289
|
|
|
@@ -38,9 +38,12 @@ The category page renders the content between the category heading and the
|
|
|
38
38
|
listing toolbar, on the **first page** of the listing only — a visitor paging
|
|
39
39
|
through products is not shown the introduction again above every page.
|
|
40
40
|
|
|
41
|
-
The document is resolved to one language in this order: the visitor's language
|
|
42
|
-
the sales channel
|
|
43
|
-
|
|
41
|
+
The document is resolved to one language in this order: the visitor's language
|
|
42
|
+
as the sales channel offers it, else the channel's default language; then the
|
|
43
|
+
channel's default language, English, and any language that has content. The
|
|
44
|
+
visitor's language is the first `Accept-Language` entry, by weight, that the
|
|
45
|
+
channel offers (`pl` matches the channel's `pl-PL`); a language the channel does
|
|
46
|
+
not offer is never used, even where a document is stored in it. A language whose document holds no block is skipped.
|
|
44
47
|
|
|
45
48
|
The content follows the category's visibility: an inactive category, or one
|
|
46
49
|
under an inactive parent, has no page and its content is not served.
|
|
@@ -75,7 +75,9 @@ not a bundle, 404 `PRODUCT_NOT_FOUND`) still apply.
|
|
|
75
75
|
|
|
76
76
|
| Code | Status | When |
|
|
77
77
|
| --- | --- | --- |
|
|
78
|
-
| `PRODUCT_TYPE_MISMATCH` | 400 | Calling grouped/bundle endpoints against the wrong parent type |
|
|
78
|
+
| `PRODUCT_TYPE_MISMATCH` | 400 | Calling grouped/bundle endpoints against the wrong parent type; adding a variant to a product that is not configurable (token `variants_need_configurable`, `details.productId`, `productType`) |
|
|
79
|
+
| `SELF_LINK_NOT_ALLOWED` | 400 | A grouped product names itself as a child (token `grouped`, `details.productId`) |
|
|
80
|
+
| `GROUPED_ITEM_ALREADY_EXISTS` | 409 | The child is already in the group (`details.parentProductId`, `childProductId`, `childSku`) |
|
|
79
81
|
| `NESTED_COMPOSITE_NOT_ALLOWED` | 400 | Child / option product is itself grouped or bundle |
|
|
80
82
|
| `INVALID_QUANTITY_RANGE` | 400 | Slot `minQuantity > maxQuantity` |
|
|
81
83
|
| `OPTION_ALREADY_EXISTS` | 409 | Same option product reused in a slot |
|
|
@@ -23,21 +23,77 @@ a channel or language that is no longer valid, the editor opens at the nearest v
|
|
|
23
23
|
…"). A banner reading "Changes apply only to *scope*" is shown whenever you are not at Global, and the editor says in
|
|
24
24
|
words where you are ("Editing …"). Next to it is a link to the **Scope map** tab.
|
|
25
25
|
|
|
26
|
-
Saving applies to the current scope only. A save never changes a value at any other scope.
|
|
26
|
+
Saving applies to the current scope only. A save never changes a value at any other scope. The **Save** button sits
|
|
27
|
+
in the scope bar, next to the scope it saves, and shows how many changes are waiting ("Save 2 changes"). On a wide
|
|
28
|
+
screen the scope bar stays at the top of the window while you scroll, so Save is always in reach; on a narrow screen
|
|
29
|
+
Save is in the bar fixed to the bottom of the screen.
|
|
30
|
+
|
|
31
|
+
## What Save covers
|
|
32
|
+
|
|
33
|
+
Save writes everything you have staged on the product, wherever on the page you staged it:
|
|
34
|
+
|
|
35
|
+
- the product's fields on every tab, at the current scope, the SEO fields included;
|
|
36
|
+
- the product's stock settings on the **Inventory** tab — stock management, backorders, the low-stock threshold and
|
|
37
|
+
its mode, and the fulfilment strategy with its warehouse order. They exist only at Global. The tab has no Save of
|
|
38
|
+
its own, and changing the threshold mode no longer saves by itself; setting a value back to the saved one removes
|
|
39
|
+
it from the count;
|
|
40
|
+
- the **Base prices** on the **Pricing** tab, while the Price lists module is on. There is no *Save prices* button.
|
|
41
|
+
|
|
42
|
+
The count on Save adds them all up ("Save 3 changes"). Changes on a tab you have left stay staged and counted, and
|
|
43
|
+
switching tabs asks nothing. Save is offered to anyone who may change the product or any of these parts, and it
|
|
44
|
+
writes only what they may change.
|
|
45
|
+
|
|
46
|
+
**First, everything is checked.** The product's fields are checked as before, and the base prices are checked by
|
|
47
|
+
the server without being written. If anything is refused, nothing is written and every change stays. A refused
|
|
48
|
+
product field shows its reason on the field, as before. When the base prices have problems, a summary under the
|
|
49
|
+
scope bar lists each part with its problems ("Base prices — 1 problem"); **Show** opens that part's tab and moves to
|
|
50
|
+
the first field with an error.
|
|
51
|
+
|
|
52
|
+
**Then the parts are written, one after another**: the product's fields first, then the base prices. Each part is
|
|
53
|
+
recorded in the audit log as its own module records it — the product's save as one entry, the base prices as
|
|
54
|
+
another.
|
|
55
|
+
|
|
56
|
+
- If the product's fields are refused — someone else saved the product meanwhile, the completeness check refuses a
|
|
57
|
+
status change, a URL key is taken, a value is invalid — the base prices are not written either. The editor says
|
|
58
|
+
why, as before.
|
|
59
|
+
- If the product's fields are saved and the base prices are not, the summary says both ("Saved: Product fields.
|
|
60
|
+
Not saved: Base prices — *reason*"). The product's fields are no longer staged; the base prices still are, Save
|
|
61
|
+
counts only them, and pressing it again writes only the base prices.
|
|
62
|
+
- If the Price lists module is switched off while base prices are staged, those changes are discarded and the editor
|
|
63
|
+
says so. A save the server refuses because the module was switched off is reported as that part not saved.
|
|
64
|
+
|
|
65
|
+
## What applies immediately
|
|
66
|
+
|
|
67
|
+
Some actions on the product are not staged. They are written the moment you use them, each recorded on its own,
|
|
68
|
+
and they neither add to the staged changes nor clear them. Each section holding such an action carries an
|
|
69
|
+
**Applies immediately** badge on its heading, shown only where you may use the action:
|
|
70
|
+
|
|
71
|
+
- adding, removing, reordering or replacing variants, bundle slots, grouped items, links, images, attachments and
|
|
72
|
+
packaging units;
|
|
73
|
+
- deleting a URL redirect;
|
|
74
|
+
- the product's sales channels on the **Channels** tab;
|
|
75
|
+
- **Stock by warehouse** on the **Inventory** tab — each warehouse's stock level and low-stock threshold.
|
|
76
|
+
|
|
77
|
+
The prices in other price books are edited in the book's price grid, not here. The **Pricing** tab carries no badge:
|
|
78
|
+
its base prices save with Save.
|
|
27
79
|
|
|
28
80
|
## Switching with unsaved changes
|
|
29
81
|
|
|
30
82
|
Changes are saved one scope at a time, so switching scope (or leaving the product, or using the browser's Back
|
|
31
|
-
button) with unsaved changes opens a dialog with three choices:
|
|
83
|
+
button) with unsaved changes — base prices included — opens a dialog with three choices:
|
|
32
84
|
|
|
33
|
-
- **Save and continue** — save the changes at the scope you are leaving, then switch;
|
|
34
|
-
|
|
85
|
+
- **Save and continue** — save the changes at the scope you are leaving, then switch; if any part is not saved, you
|
|
86
|
+
stay;
|
|
87
|
+
- **Discard changes** — drop every unsaved change on the page and switch;
|
|
35
88
|
- **Stay here** — close the dialog and keep editing.
|
|
36
89
|
|
|
37
90
|
If the save is refused, you stay where you are and the refusal is shown on the field. If someone else saved the
|
|
38
91
|
product in the meantime, the editor reports a version conflict; **Reload** discards your staged changes and reads the
|
|
39
92
|
product again, and the button says so.
|
|
40
93
|
|
|
94
|
+
There is one such question for the whole page: no tab or panel asks one of its own. Closing or reloading the
|
|
95
|
+
browser tab with unsaved changes makes the browser ask before it leaves.
|
|
96
|
+
|
|
41
97
|
## Inherit, or set a value here
|
|
42
98
|
|
|
43
99
|
At Channel and Channel × language, every field that can be set at that scope shows where its value comes from:
|
|
@@ -20,11 +20,12 @@ content**. The type comes with fixed settings:
|
|
|
20
20
|
- it cannot be searchable, filterable, comparable, a variant axis, a
|
|
21
21
|
promotion or price-list rule, mass-editable, quick-searchable, required,
|
|
22
22
|
shown in the **Parametry** tab, or set per sales channel. The form does not
|
|
23
|
-
offer those settings, the list shows them locked, and the API refuses each one
|
|
24
|
-
with `400 VALIDATION_FAILED
|
|
23
|
+
offer those settings, the list shows them locked, and the API refuses each one,
|
|
24
|
+
naming the setting: with `400 VALIDATION_FAILED` on create and with
|
|
25
|
+
`400 CONTENT_ATTRIBUTE_CAPABILITY_LOCKED` on update;
|
|
25
26
|
- it has no options;
|
|
26
27
|
- its type cannot be changed later, and no other attribute can be changed into
|
|
27
|
-
it (`409`).
|
|
28
|
+
it (`409 ATTRIBUTE_VALUE_TYPE_LOCKED`, token `page_builder`).
|
|
28
29
|
|
|
29
30
|
Then add the attribute to an [attribute set](./attribute-sets.md). Its position
|
|
30
31
|
in the set is the order in which the product page shows the set's content
|
|
@@ -70,9 +71,12 @@ least one content attribute with content. It shows the plain description first,
|
|
|
70
71
|
then each content attribute in the attribute set's order. No heading or label is
|
|
71
72
|
printed above a document — the document carries its own headings.
|
|
72
73
|
|
|
73
|
-
Each document is resolved to one language in this order: the visitor's language
|
|
74
|
-
the sales channel
|
|
75
|
-
|
|
74
|
+
Each document is resolved to one language in this order: the visitor's language
|
|
75
|
+
as the sales channel offers it, else the channel's default language; then the
|
|
76
|
+
channel's default language, English, and any language that has content. The
|
|
77
|
+
visitor's language is the first `Accept-Language` entry, by weight, that the
|
|
78
|
+
channel offers (`pl` matches the channel's `pl-PL`); a language the channel does
|
|
79
|
+
not offer is never used, even where a document is stored in it. A language whose document holds no block is skipped. The content is the
|
|
76
80
|
product's, so it is the same whichever variant is selected.
|
|
77
81
|
|
|
78
82
|
The blocks are drawn by the storefront's Page Builder renderer — the one that
|
package/docs/catalog.md
CHANGED
|
@@ -7,7 +7,8 @@ description: Products, variants, categories, attributes, sales channels
|
|
|
7
7
|
# Catalog (`catalog`)
|
|
8
8
|
|
|
9
9
|
The product catalog: Products, ProductVariants, Categories,
|
|
10
|
-
ProductAttributes, and
|
|
10
|
+
ProductAttributes, and the products' per-Sales-Channel scopes (the Sales
|
|
11
|
+
Channel itself is the platform's). Owns all read paths the storefront
|
|
11
12
|
depends on and the admin-side authoring surface.
|
|
12
13
|
|
|
13
14
|
## Public surface
|
|
@@ -32,11 +33,13 @@ otherwise; every price names its currency either way. A malformed code is refuse
|
|
|
32
33
|
| `GET /api/v1/admin/catalog/products?status&archived` | admin | Admin product list. `status` is `active` or `inactive` (any other value: `400 VALIDATION_FAILED`); `archived` is `exclude` (default), `include` or `only` — the legacy `includeArchived=1` means `include`. `counts` is `{ all, active, inactive, archived }` — see *Product status and archiving* |
|
|
33
34
|
| `GET /api/v1/admin/catalog/products/:id` | admin | Product detail |
|
|
34
35
|
| `POST /api/v1/admin/catalog/products` | admin | Create product (`type` immutable post-create; `sku` is editable) |
|
|
35
|
-
| `PATCH /api/v1/admin/catalog/products/:id` | admin | Update (incl. `sku`); writes an audit row with stateBefore / stateAfter; refuses with `409
|
|
36
|
+
| `PATCH /api/v1/admin/catalog/products/:id` | admin | Update (incl. `sku`); writes an audit row with stateBefore / stateAfter; refuses with `409 SKU_ALREADY_EXISTS` (token `held_by_product` or `held_by_variant`, `details.sku`) if the new SKU already belongs to another product or a variant |
|
|
36
37
|
| `DELETE /api/v1/admin/catalog/products/:id` | admin | Delete (soft) — not the Archive action; frees the SKUs of the product and its variants ([below](#a-deleted-product-frees-its-sku)) |
|
|
37
38
|
| `POST /api/v1/admin/catalog/products/:id/archive` | admin (`catalog:write`) | Archive one product — see *Product status and archiving* |
|
|
38
39
|
| `POST /api/v1/admin/catalog/products/:id/restore` | admin (`catalog:write`) | Restore one archived product |
|
|
39
40
|
| `GET`, `POST /api/v1/admin/catalog/products/list-views`; `PATCH`, `DELETE …/list-views/:id` | admin | Saved views on the product list — see *Saved views* below |
|
|
41
|
+
| `GET /api/v1/admin/catalog/bulk-operations`, `GET …/bulk-operations/:id` | admin (`catalog:read`) | The background bulk operations and one operation's per-product outcome |
|
|
42
|
+
| `POST /api/v1/admin/catalog/bulk-operations/:id/undo` | admin (`catalog:write`) | Undo a finished bulk operation; refused with `409 BULK_OPERATION_RUNNING` while it is pending or running, `409 BULK_OPERATION_ALREADY_REVERTED` once undone and `409 BULK_OPERATION_NOT_REVERSIBLE` when there is nothing to restore (until issue #501 all three were `409 VERSION_CONFLICT`) |
|
|
40
43
|
| `GET /api/v1/admin/catalog/attributes` | admin | List attributes |
|
|
41
44
|
| `GET /api/v1/admin/catalog/attributes/by-flag?flag=isPromoRule\|isComparable\|...` | admin | Picker payload — every attribute carrying the requested flag |
|
|
42
45
|
| `GET /api/v1/admin/catalog/attributes/:idOrKey` | admin | Single attribute read |
|
|
@@ -46,13 +49,13 @@ otherwise; every price names its currency either way. A malformed code is refuse
|
|
|
46
49
|
| `DELETE /api/v1/admin/catalog/attributes/:idOrKey` | admin | Delete an attribute of any type; refused with `409` while an Attribute Set contains it or a live product holds a value for it (on the product, per sales channel or on a variant) |
|
|
47
50
|
| `GET /api/v1/admin/catalog/attributes/:idOrKey/options` | admin | List option-list rows for select/enum/multiselect attributes |
|
|
48
51
|
| `POST /api/v1/admin/catalog/attributes/:idOrKey/options` | admin | Append an option |
|
|
49
|
-
| `PATCH /api/v1/admin/catalog/
|
|
50
|
-
| `DELETE /api/v1/admin/catalog/
|
|
51
|
-
| `POST /api/v1/admin/catalog/attribute-set-preview` | admin | Preview which Set's attributes will be edited / hidden when an operator switches a product's Attribute Set |
|
|
52
|
+
| `PATCH /api/v1/admin/catalog/attributes/:attributeId/options/:optionId` | admin | Patch label / labelDefault / isDefault / sortOrder (option `value` is immutable) |
|
|
53
|
+
| `DELETE /api/v1/admin/catalog/attributes/:attributeId/options/:optionId` | admin | Remove; refused with `409 ATTRIBUTE_OPTION_IN_USE` while any product still carries the value |
|
|
54
|
+
| `POST /api/v1/admin/catalog/products/:id/attribute-set-preview` | admin (`catalog:write`) | Preview which Set's attributes will be edited / hidden when an operator switches a product's Attribute Set |
|
|
52
55
|
| `GET /api/v1/admin/catalog/categories` | admin | Flat list, the UI folds into a tree |
|
|
53
|
-
| `POST /api/v1/admin/catalog/categories` | admin | Create (parent must exist) |
|
|
54
|
-
| `PATCH /api/v1/admin/catalog/categories/:id` | admin | Update; reparenting walks the new parent's chain to refuse cycles (409) |
|
|
55
|
-
| `DELETE /api/v1/admin/catalog/categories/:id` | admin | Soft-delete; rejects with 409 if any active child still references the row |
|
|
56
|
+
| `POST /api/v1/admin/catalog/categories` | admin | Create (parent must exist); a slug a sibling already holds is `409 CATEGORY_SLUG_TAKEN` (`details.slug`, `parentCategoryId`), on create and on update. `customFieldValues` are checked against the category custom-field definitions and stored with the category; a refused value is `422 CUSTOM_FIELD_VALUE_INVALID` (`details` entries `{ path, issue }`) and creates nothing. A **required** category field is enforced on every create, also when the request sends no values |
|
|
57
|
+
| `PATCH /api/v1/admin/catalog/categories/:id` | admin | Update (incl. `customFieldValues`, refused as on create); reparenting walks the new parent's chain to refuse cycles (`409 CATEGORY_MOVE_CYCLE`, `details.categoryId`, `parentCategoryId`) |
|
|
58
|
+
| `DELETE /api/v1/admin/catalog/categories/:id` | admin | Soft-delete; rejects with `409 CATEGORY_HAS_CHILDREN` (`details.categoryId`, `childCount`) if any active child still references the row |
|
|
56
59
|
| `GET /api/v1/admin/catalog/categories/:id/content` | admin | The category's page content — one Page Builder document per language ([Category page content](./catalog/category-content.md)) |
|
|
57
60
|
| `PUT /api/v1/admin/catalog/categories/:id/content` | admin | Replace the category's page content; `null` clears it |
|
|
58
61
|
| `GET /api/v1/admin/catalog/products/:id/content` | admin | The product's content attributes with a per-language summary ([Product content](./catalog/product-content.md)) |
|
|
@@ -194,7 +197,7 @@ buyer pays is chosen.
|
|
|
194
197
|
way.
|
|
195
198
|
- **Where the viewer's price display mode is *None*** — for instance an anonymous visitor on a
|
|
196
199
|
channel that hides prices until sign-in — the listing and the product detail carry no amount, and
|
|
197
|
-
a price ordering or range is refused for that page
|
|
200
|
+
a price ordering or range is refused for that page with `400 PRICE_ORDERING_UNAVAILABLE`. Sales channels have no price-visibility flag
|
|
198
201
|
of their own any more: the display mode decides, for each viewer.
|
|
199
202
|
- **Gross prices use each product's own VAT rate.** Every product on the listing and the product
|
|
200
203
|
detail carries `vatRate`, the VAT rate the viewer is charged for it, as a fraction (`0.08` = 8 %).
|
|
@@ -237,10 +240,31 @@ fields with `400 PRICE_SET_IN_PRICE_BOOKS` (`PRICE_FIELDS_REFUSED_ON_PRODUCTS`,
|
|
|
237
240
|
price books. The catalogue's migration `20261022T111811_catalog_price_fields_removed.ts` dropped the
|
|
238
241
|
column and stripped the keys.
|
|
239
242
|
|
|
243
|
+
## Editing a category
|
|
244
|
+
|
|
245
|
+
*Catalog → Categories* shows the category tree; **Edit** on a category opens its editor beside the tree. The
|
|
246
|
+
editor holds the category's own fields — its names, slug, parent and custom fields — and, while the Price lists
|
|
247
|
+
module is on, the category's **Price display mode**, contributed by that module and shown above the Save and Cancel
|
|
248
|
+
buttons.
|
|
249
|
+
|
|
250
|
+
The editor has **one Save** for all of it. Changing the price display mode only stages it: it is no longer saved
|
|
251
|
+
the moment you choose it. Save reads "Save" while there is nothing to save and "Save 2 changes" once there is,
|
|
252
|
+
counting the category's own changes and the display mode together.
|
|
253
|
+
|
|
254
|
+
- Save checks everything first; if anything is refused, nothing is written.
|
|
255
|
+
- The category is written first, then the display mode. If the category is refused — a slug already in use, an
|
|
256
|
+
invalid custom field — the display mode is not written either.
|
|
257
|
+
- If the category is saved and the display mode is not, the editor stays open and a summary says what was saved
|
|
258
|
+
and what was not. The next Save writes only the display mode.
|
|
259
|
+
- **Cancel** discards every unsaved change without asking.
|
|
260
|
+
- **Edit** on another category with unsaved changes asks first: **Save and continue**, **Discard changes** or
|
|
261
|
+
**Stay here**. Following a link elsewhere in the admin, or closing or reloading the browser tab, asks too. The
|
|
262
|
+
open category is not part of the page address, so the browser's Back button leaves the page without asking.
|
|
263
|
+
|
|
240
264
|
## Entities
|
|
241
265
|
|
|
242
|
-
`Product`, `ProductVariant`, `Category`, `ProductAttribute
|
|
243
|
-
`SalesChannel
|
|
266
|
+
`Product`, `ProductVariant`, `Category`, `ProductAttribute` (the
|
|
267
|
+
`SalesChannel` entity is the platform's), plus the M:N bridges
|
|
244
268
|
`product_categories`, `sales_channel_products`, `product_assets`, and
|
|
245
269
|
`ProductListSavedView` (`product_list_saved_views`, the product list's saved
|
|
246
270
|
views).
|
|
@@ -436,9 +460,10 @@ back. Both are edited in the **Order rules** card on the product editor's
|
|
|
436
460
|
may order in one order. Optional; a whole number from **1 to 1 000 000**, or
|
|
437
461
|
empty for no minimum. It applies to `simple` and `configurable` products
|
|
438
462
|
only: on a `grouped`, `bundle` or `virtual` product the card says so, and
|
|
439
|
-
the API refuses the field with `422
|
|
440
|
-
`minOrderQuantity`, on create
|
|
441
|
-
refused with
|
|
463
|
+
the API refuses the field with `422 MIN_ORDER_QUANTITY_NOT_SUPPORTED_FOR_TYPE`
|
|
464
|
+
naming `minOrderQuantity` (`details.field`, `productType`), on create, on
|
|
465
|
+
update and per channel. A value outside the range is refused with
|
|
466
|
+
`400 VALIDATION_FAILED`.
|
|
442
467
|
- **A minimum per packaging unit** — each packaging unit may carry its own
|
|
443
468
|
minimum number of units; see [Packaging Units](./catalog/packaging-units.md).
|
|
444
469
|
|
|
@@ -632,8 +657,11 @@ compatibility at the API boundary.
|
|
|
632
657
|
Product `sku` is mutable. The internal canonical reference for every
|
|
633
658
|
cross-module link (assets, links, RFQ items, ...) is the `Product.id`
|
|
634
659
|
UUID, which never changes. Updating the SKU writes an audit row and
|
|
635
|
-
refuses with `409
|
|
636
|
-
another product.
|
|
660
|
+
refuses with `409 SKU_ALREADY_EXISTS` if the new value already belongs to
|
|
661
|
+
another product or a variant — the code create answers with. The refusal
|
|
662
|
+
token says which (`held_by_product`, `held_by_variant`), and `details` carries
|
|
663
|
+
`sku` and `conflictingProductId` or `conflictingVariantId`. Until issue #624
|
|
664
|
+
it was `400 VALIDATION_FAILED` with the token `sku_in_use` in the message.
|
|
637
665
|
|
|
638
666
|
### A deleted product frees its SKU
|
|
639
667
|
|
|
@@ -709,7 +737,7 @@ and ownership model is different:
|
|
|
709
737
|
row), using the transactional apply seam exported by
|
|
710
738
|
`custom_fields`. The generic Custom Fields admin surface lists
|
|
711
739
|
product definitions read-only and refuses mutations with
|
|
712
|
-
`409
|
|
740
|
+
`409 CUSTOM_FIELD_HOST_MANAGED`.
|
|
713
741
|
- **Migration `20260723T230401_catalog_attributes_on_custom_fields.ts`** performed the
|
|
714
742
|
one-time convergence in a single transaction: backfilled one
|
|
715
743
|
definition per legacy attribute (key, labels, mapped value type,
|
package/i18n/en.json
CHANGED
|
@@ -141,6 +141,7 @@
|
|
|
141
141
|
"bulkOperations.outcome.succeeded": "Succeeded",
|
|
142
142
|
"bulkOperations.outcome.skipped": "Skipped",
|
|
143
143
|
"bulkOperations.outcome.failed": "Failed",
|
|
144
|
+
"bulkOperations.outcome.unchanged": "Unchanged",
|
|
144
145
|
"attributes.column.massEditable": "Mass-editable",
|
|
145
146
|
"attributes.column.quickSearchable": "Quick-searchable",
|
|
146
147
|
"attributes.column.priceRule": "Price list rules",
|
|
@@ -163,6 +164,11 @@
|
|
|
163
164
|
"productsList.column.type": "Type",
|
|
164
165
|
"productsList.column.visibility": "Visibility",
|
|
165
166
|
"productsList.column.updated": "Updated",
|
|
167
|
+
"productsList.updated.justNow": "just now",
|
|
168
|
+
"productsList.updated.minutesAgo": "{count}m ago",
|
|
169
|
+
"productsList.updated.hoursAgo": "{count}h ago",
|
|
170
|
+
"productsList.updated.yesterday": "yesterday",
|
|
171
|
+
"productsList.updated.daysAgo": "{count}d ago",
|
|
166
172
|
"categories.page.title": "Categories",
|
|
167
173
|
"categories.page.description": "Hierarchical tree. Cycles + non-empty deletions are rejected by the backend.",
|
|
168
174
|
"categories.error.load": "Failed to load.",
|
|
@@ -193,6 +199,15 @@
|
|
|
193
199
|
"categories.action.create": "Create",
|
|
194
200
|
"categories.action.cancel": "Cancel",
|
|
195
201
|
"categories.action.save": "Save",
|
|
202
|
+
"categories.save.hostPartLabel": "Category",
|
|
203
|
+
"categories.guard.title": "Save your changes to {name}?",
|
|
204
|
+
"categories.guard.body.one": "You have {count} unsaved change in this category. Decide what to do with it before you open another one.",
|
|
205
|
+
"categories.guard.body.few": "You have {count} unsaved changes in this category. Decide what to do with them before you open another one.",
|
|
206
|
+
"categories.guard.body.many": "You have {count} unsaved changes in this category. Decide what to do with them before you open another one.",
|
|
207
|
+
"categories.guard.body.other": "You have {count} unsaved changes in this category. Decide what to do with them before you open another one.",
|
|
208
|
+
"categories.guard.save": "Save and continue",
|
|
209
|
+
"categories.guard.discard": "Discard changes",
|
|
210
|
+
"categories.guard.stay": "Stay here",
|
|
196
211
|
"categories.create.under": "New category under",
|
|
197
212
|
"categories.field.slug": "Slug",
|
|
198
213
|
"categories.field.parent": "Parent",
|
|
@@ -362,22 +377,18 @@
|
|
|
362
377
|
"inventoryTab.column.newValue": "New value",
|
|
363
378
|
"inventoryTab.lowStock.title": "Low-stock threshold",
|
|
364
379
|
"inventoryTab.fulfilment.title": "Fulfilment strategy",
|
|
365
|
-
"inventoryTab.fulfilment.saved": "Fulfilment strategy saved.",
|
|
366
380
|
"inventoryTab.lowStock.help": "Cumulative on-hand at or below this value flags the product as low-stock. Leave empty to fall back to the warehouse default or the global threshold.",
|
|
367
381
|
"inventoryTab.lowStock.placeholder": "Inherit from warehouse / global",
|
|
368
382
|
"inventoryTab.lowStock.save": "Save threshold",
|
|
369
383
|
"inventoryTab.lowStock.saving": "Saving…",
|
|
370
|
-
"inventoryTab.lowStock.success": "Low-stock threshold saved.",
|
|
371
384
|
"inventoryTab.lowStock.error": "Could not save low-stock threshold.",
|
|
372
385
|
"inventoryTab.lowStock.modeCumulative": "Single threshold across all warehouses",
|
|
373
386
|
"inventoryTab.lowStock.modePerWarehouse": "Per-warehouse threshold",
|
|
374
|
-
"inventoryTab.lowStock.modeSaved": "Threshold mode saved.",
|
|
375
387
|
"inventoryTab.lowStock.perWarehouseHelp": "Each warehouse below has its own threshold. Leave a row empty to fall back to the warehouse default. The product is flagged as low-stock when ANY warehouse has on-hand at or below its threshold.",
|
|
376
388
|
"inventoryTab.lowStock.perWarehouseSaved": "Per-warehouse threshold saved.",
|
|
377
389
|
"inventoryTab.lowStock.perWarehousePlaceholder": "Warehouse default",
|
|
378
390
|
"inventoryTab.column.threshold": "Threshold",
|
|
379
391
|
"inventoryTab.stockMgmt.title": "Stock management",
|
|
380
|
-
"inventoryTab.stockMgmt.saved": "Stock-management settings saved.",
|
|
381
392
|
"inventoryTab.stockMgmt.disableManageStock": "Disable stock management",
|
|
382
393
|
"inventoryTab.stockMgmt.disableManageStockHelp": "When disabled, the product is always shown as available and customers can order any quantity — stock is never tracked or reserved for it.",
|
|
383
394
|
"inventoryTab.stockMgmt.backorder": "Allow ordering below stock (backorder)",
|
|
@@ -552,6 +563,9 @@
|
|
|
552
563
|
"errors.PRICE_RANGE_INVALID": "The minimum price must not exceed the maximum price.",
|
|
553
564
|
"errors.PRODUCT_NOT_FOUND": "Product not found.",
|
|
554
565
|
"errors.PRODUCT_ARCHIVED": "Product is archived.",
|
|
566
|
+
"errors.BULK_OPERATION_RUNNING": "This bulk operation is still running. Undo it once it has finished.",
|
|
567
|
+
"errors.BULK_OPERATION_ALREADY_REVERTED": "This bulk operation has already been undone.",
|
|
568
|
+
"errors.BULK_OPERATION_NOT_REVERSIBLE": "This bulk operation cannot be undone.",
|
|
555
569
|
"errors.PRODUCT_SAVED_VIEW_NAME_TAKEN": "You already have a saved view with this name on the product list. Choose a different name.",
|
|
556
570
|
"errors.PRODUCT_DELETE_BLOCKED": "This product cannot be deleted because it is still referenced.",
|
|
557
571
|
"errors.SKU_ALREADY_EXISTS": "A product with this SKU already exists. Choose a different SKU.",
|
|
@@ -729,6 +743,29 @@
|
|
|
729
743
|
"adminSearch.category.field.name": "Name",
|
|
730
744
|
"adminSearch.category.field.slug": "URL key (slug)",
|
|
731
745
|
"errors.PRICE_SET_IN_PRICE_BOOKS": "Prices are set in price books, not on the product.",
|
|
746
|
+
"errors.ATTRIBUTE_KEY_TAKEN": "An attribute with the key {attributeKey} already exists. Choose a different key.",
|
|
747
|
+
"errors.ATTRIBUTE_VALUE_TYPE_LOCKED": "The value type of the attribute {attributeKey} cannot change while products hold values for it. Clear those values first.",
|
|
748
|
+
"errors.ATTRIBUTE_IN_USE": "The attribute {attributeKey} is still in use, so it cannot be deleted.",
|
|
749
|
+
"errors.ATTRIBUTE_IN_USE.attribute_sets": "Attribute sets that contain the attribute {attributeKey}: {attributeSetCount}. Remove it from those sets before you delete it.",
|
|
750
|
+
"errors.ATTRIBUTE_IN_USE.products": "Products that hold a value of the attribute {attributeKey}: {productCount}. Clear those values before you delete it.",
|
|
751
|
+
"errors.ATTRIBUTE_OPTION_VALUE_TAKEN": "The attribute {attributeKey} already has an option with the value {value}. Choose a different value.",
|
|
752
|
+
"errors.ATTRIBUTE_DEFAULT_OPTION_TAKEN": "The attribute {attributeKey} already has a default option, so {value} cannot be the default too. Clear the current default first.",
|
|
753
|
+
"errors.ATTRIBUTE_OPTIONS_NOT_SUPPORTED": "The attribute {attributeKey} takes no options: options belong to select and multiselect attributes.",
|
|
754
|
+
"errors.ATTRIBUTE_OPTION_IN_USE": "The option {value} of the attribute {attributeKey} is still used by products. Clear it from them before you delete the option.",
|
|
755
|
+
"errors.ATTRIBUTE_OPTION_IN_USE.products": "Products that carry the option {value} of the attribute {attributeKey}: {productCount}. Clear it from them before you delete the option.",
|
|
756
|
+
"errors.ATTRIBUTE_SLIDER_NOT_SUPPORTED": "The attribute {attributeKey} cannot be shown as a slider: a slider is for number and price attributes.",
|
|
757
|
+
"errors.ATTRIBUTE_VALUES_REQUIRED": "These attributes are required by the product's attribute set and need a value: {attributeKeys}.",
|
|
758
|
+
"errors.SKU_ALREADY_EXISTS.held_by_product": "The SKU {sku} is already used by another product. Choose a different SKU.",
|
|
759
|
+
"errors.SKU_ALREADY_EXISTS.held_by_variant": "The SKU {sku} is already used by a product variant. Choose a different SKU.",
|
|
760
|
+
"errors.PRODUCT_TYPE_MISMATCH.variants_need_configurable": "Variants can be added only to configurable products, and this product is not one.",
|
|
761
|
+
"errors.MIN_ORDER_QUANTITY_NOT_SUPPORTED_FOR_TYPE": "A minimum order quantity applies to simple and configurable products only, so it cannot be set on this product.",
|
|
762
|
+
"errors.CATEGORY_SLUG_TAKEN": "A category with the slug {slug} already exists under this parent. Choose a different slug.",
|
|
763
|
+
"errors.CATEGORY_HAS_CHILDREN": "Subcategories of this category: {childCount}. Move or delete them before you delete the category.",
|
|
764
|
+
"errors.CATEGORY_MOVE_CYCLE": "A category cannot be moved beneath one of its own subcategories. Choose a different parent.",
|
|
765
|
+
"errors.SELF_LINK_NOT_ALLOWED.grouped": "A grouped product cannot contain itself.",
|
|
766
|
+
"errors.GROUPED_ITEM_ALREADY_EXISTS": "The product {childSku} is already in this group.",
|
|
767
|
+
"errors.ATTRIBUTE_VALUE_TYPE_LOCKED.page_builder": "The value type of the attribute {attributeKey} cannot change to or from Page Builder content: a document and a single value cannot be converted into each other. Create a new attribute instead.",
|
|
768
|
+
"errors.CONTENT_ATTRIBUTE_CAPABILITY_LOCKED": "The attribute {attributeKey} holds Page Builder content, so it cannot have: {capabilities}.",
|
|
732
769
|
"blocks.productGrid.fields.source.label": "Source",
|
|
733
770
|
"blocks.productGrid.fields.source.options.manual": "Manual selection",
|
|
734
771
|
"blocks.productGrid.fields.source.options.category": "Category",
|
|
@@ -1192,6 +1229,12 @@
|
|
|
1192
1229
|
"attributes.scope.legend": "Scope",
|
|
1193
1230
|
"attributes.scope.help": "Turning this off keeps the values already set per channel or language, but they stop applying. Each product lists them on its Scope map tab, where they can be deleted.",
|
|
1194
1231
|
"attributes.scope.systemHelp": "A built-in attribute: its scope is fixed.",
|
|
1232
|
+
"attributes.adminAccess.label": "Admin access",
|
|
1233
|
+
"attributes.adminAccess.edit": "Editable",
|
|
1234
|
+
"attributes.adminAccess.read": "Read-only",
|
|
1235
|
+
"attributes.adminAccess.hidden": "Hidden",
|
|
1236
|
+
"attributes.adminAccess.help": "Read-only and hidden only change the admin panel. They do not restrict the API, filters, exports or the audit log.",
|
|
1237
|
+
"attributes.adminAccess.requiredReason": "Read-only and hidden are unavailable while the attribute is required: a required attribute must stay editable in the admin.",
|
|
1195
1238
|
"attributes.scope.readOnly": "You can see the scope but not change it.",
|
|
1196
1239
|
"attributes.type.pageBuilder": "Page Builder content",
|
|
1197
1240
|
"attributes.pageBuilder.languageNote": "Kept per language; editing it requires the CMS module. Content attributes are not searchable, filterable, comparable, editable in bulk, set per sales channel or shown in the \"Parameters\" tab.",
|
|
@@ -1426,7 +1469,6 @@
|
|
|
1426
1469
|
"productEditor.guard.bodyLeave.few": "You have {count} unsaved changes at this scope. Decide what to do with them before you leave this product.",
|
|
1427
1470
|
"productEditor.guard.bodyLeave.many": "You have {count} unsaved changes at this scope. Decide what to do with them before you leave this product.",
|
|
1428
1471
|
"productEditor.guard.bodyLeave.other": "You have {count} unsaved changes at this scope. Decide what to do with them before you leave this product.",
|
|
1429
|
-
"productEditor.immediate.badge": "Applies immediately",
|
|
1430
1472
|
"productEditor.immediate.droppedImage": "Unsaved change to the removed image was discarded.",
|
|
1431
1473
|
"productEditor.immediate.droppedAttachment": "Unsaved change to the removed attachment was discarded.",
|
|
1432
1474
|
"productEditor.immediate.droppedPackagingUnit": "Unsaved change to the removed packaging unit was discarded.",
|
|
@@ -1460,6 +1502,7 @@
|
|
|
1460
1502
|
"productEditor.save.reason.product.attributeSetId": "This attribute set no longer exists. Pick another one.",
|
|
1461
1503
|
"productEditor.save.reason.product.categoryIds": "A selected category no longer exists. Remove it and save again.",
|
|
1462
1504
|
"productEditor.save.error.download": "Nothing was saved: the download of this virtual product is not valid, or its file no longer exists. Check the download on the product's virtual settings.",
|
|
1505
|
+
"productEditor.save.hostPartLabel": "Product fields",
|
|
1463
1506
|
"productEditor.save.actionCount.one": "Save {count} change",
|
|
1464
1507
|
"productEditor.save.actionCount.few": "Save {count} changes",
|
|
1465
1508
|
"productEditor.save.actionCount.many": "Save {count} changes",
|