@endora-commerce/mod-catalog 0.109.0 → 0.111.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/admin/components/CopyToChannelsDialog.d.ts +37 -0
- package/dist/admin/components/CopyToChannelsDialog.js +83 -0
- package/dist/admin/components/PackagingUnitsEditor.d.ts +13 -4
- package/dist/admin/components/PackagingUnitsEditor.js +21 -85
- package/dist/admin/components/ProductAttachmentsSection.d.ts +1 -3
- package/dist/admin/components/ProductAttachmentsSection.js +59 -98
- package/dist/admin/components/ProductAttributesTab.d.ts +1 -11
- package/dist/admin/components/ProductAttributesTab.js +128 -119
- package/dist/admin/components/ProductContentCard.d.ts +41 -0
- package/dist/admin/components/ProductContentCard.js +28 -0
- package/dist/admin/components/ProductEditorSaveAction.d.ts +22 -0
- package/dist/admin/components/ProductEditorSaveAction.js +23 -0
- package/dist/admin/components/ProductGallerySection.d.ts +2 -13
- package/dist/admin/components/ProductGallerySection.js +98 -354
- package/dist/admin/components/ProductInventoryTab.d.ts +12 -1
- package/dist/admin/components/ProductInventoryTab.js +52 -115
- package/dist/admin/components/ProductOrderRulesCard.d.ts +11 -15
- package/dist/admin/components/ProductOrderRulesCard.js +15 -268
- package/dist/admin/components/ProductScopeBar.d.ts +34 -0
- package/dist/admin/components/ProductScopeBar.js +70 -0
- package/dist/admin/components/ProductScopeOverview.d.ts +13 -1
- package/dist/admin/components/ProductScopeOverview.js +56 -37
- package/dist/admin/components/ProductUrlRedirects.d.ts +15 -0
- package/dist/admin/components/ProductUrlRedirects.js +70 -0
- package/dist/admin/components/ProductsBulkEditDialog.js +4 -3
- package/dist/admin/components/editor/DetailsTab.d.ts +30 -0
- package/dist/admin/components/editor/DetailsTab.js +60 -0
- package/dist/admin/components/editor/SectionHeading.d.ts +22 -0
- package/dist/admin/components/editor/SectionHeading.js +19 -0
- package/dist/admin/components/editor/confirm-removal.d.ts +13 -0
- package/dist/admin/components/editor/confirm-removal.js +33 -0
- package/dist/admin/components/editor/editor-context.d.ts +55 -0
- package/dist/admin/components/editor/editor-context.js +88 -0
- package/dist/admin/components/editor/scoped-controls.d.ts +46 -0
- package/dist/admin/components/editor/scoped-controls.js +64 -0
- package/dist/admin/index.d.ts +1 -1
- package/dist/admin/index.js +11 -0
- package/dist/admin/lib/attribute-scope.d.ts +17 -14
- package/dist/admin/lib/attribute-scope.js +12 -9
- package/dist/admin/lib/bulk-result-outcome.d.ts +14 -0
- package/dist/admin/lib/bulk-result-outcome.js +13 -0
- package/dist/admin/lib/editor-scope.d.ts +35 -0
- package/dist/admin/lib/editor-scope.js +114 -0
- package/dist/admin/lib/order-minimum-input.d.ts +13 -0
- package/dist/admin/lib/order-minimum-input.js +16 -0
- package/dist/admin/lib/product-labels.d.ts +0 -2
- package/dist/admin/lib/product-labels.js +1 -5
- package/dist/admin/lib/product-scopes-api.d.ts +5 -22
- package/dist/admin/lib/product-scopes-api.js +4 -48
- package/dist/admin/lib/product-url-keys-api.d.ts +4 -27
- package/dist/admin/lib/product-url-keys-api.js +1 -50
- package/dist/admin/lib/scope-overview.d.ts +13 -14
- package/dist/admin/lib/scope-overview.js +36 -31
- package/dist/admin/lib/scoped-editor-store.d.ts +81 -0
- package/dist/admin/lib/scoped-editor-store.js +198 -0
- package/dist/admin/lib/scoped-values-api.d.ts +14 -0
- package/dist/admin/lib/scoped-values-api.js +55 -0
- package/dist/admin/pages/AttachmentTypesPage.js +14 -4
- package/dist/admin/pages/AttributeSetsPage.js +11 -4
- package/dist/admin/pages/AttributesManager.js +130 -40
- package/dist/admin/pages/BulkOperationDetailPage.js +11 -4
- package/dist/admin/pages/CategoriesTree.d.ts +5 -0
- package/dist/admin/pages/CategoriesTree.js +226 -40
- package/dist/admin/pages/ProductContentPage.d.ts +27 -0
- package/dist/admin/pages/ProductContentPage.js +161 -0
- package/dist/admin/pages/ProductCreateForm.d.ts +3 -0
- package/dist/admin/pages/ProductCreateForm.js +87 -0
- package/dist/admin/pages/ProductEditor.js +938 -458
- package/dist/admin/pages/ProductsList.js +33 -38
- package/dist/backend/admin-search-provider.d.ts +2 -1
- package/dist/backend/admin-search-provider.js +1 -1
- package/dist/backend/commands/attribute-commands.d.ts +4 -3
- package/dist/backend/commands/attribute-commands.js +137 -30
- package/dist/backend/commands/product-content-commands.d.ts +31 -0
- package/dist/backend/commands/product-content-commands.js +70 -0
- package/dist/backend/commands/scoped-values.commands.d.ts +95 -0
- package/dist/backend/commands/scoped-values.commands.js +235 -0
- package/dist/backend/demo/reset.js +2 -1
- package/dist/backend/demo/rows.d.ts +18 -0
- package/dist/backend/demo/rows.js +18 -0
- package/dist/backend/demo/seed.d.ts +2 -1
- package/dist/backend/demo/seed.js +20 -6
- package/dist/backend/entities/gallery-item-scope-override.entity.d.ts +30 -0
- package/dist/backend/entities/gallery-item-scope-override.entity.js +80 -0
- package/dist/backend/entities/gallery-item.entity.d.ts +7 -6
- package/dist/backend/entities/gallery-item.entity.js +11 -6
- package/dist/backend/entities/gallery-role-scope-override.entity.d.ts +28 -0
- package/dist/backend/entities/gallery-role-scope-override.entity.js +75 -0
- package/dist/backend/entities/product-attachment-scope-override.entity.d.ts +30 -0
- package/dist/backend/entities/product-attachment-scope-override.entity.js +80 -0
- package/dist/backend/entities/product-attachment.entity.d.ts +4 -6
- package/dist/backend/entities/product-attachment.entity.js +6 -12
- package/dist/backend/entities/product-attribute.entity.d.ts +5 -9
- package/dist/backend/entities/product-attribute.entity.js +5 -13
- package/dist/backend/entities/product-channel-scope.entity.d.ts +7 -2
- package/dist/backend/entities/product-channel-scope.entity.js +10 -1
- package/dist/backend/entities/product-content-value.entity.d.ts +39 -0
- package/dist/backend/entities/product-content-value.entity.js +81 -0
- package/dist/backend/entities/product-packaging-unit-scope-override.entity.d.ts +30 -0
- package/dist/backend/entities/product-packaging-unit-scope-override.entity.js +80 -0
- package/dist/backend/entities/product-packaging-unit.entity.d.ts +1 -7
- package/dist/backend/entities/product-packaging-unit.entity.js +0 -10
- package/dist/backend/entities/product-url-key.entity.d.ts +14 -19
- package/dist/backend/entities/product-url-key.entity.js +17 -22
- package/dist/backend/entities/product-url-redirect.entity.d.ts +8 -13
- package/dist/backend/entities/product-url-redirect.entity.js +13 -14
- package/dist/backend/entities/product-variant.entity.d.ts +8 -1
- package/dist/backend/entities/product-variant.entity.js +13 -2
- package/dist/backend/entities/product.entity.d.ts +31 -14
- package/dist/backend/entities/product.entity.js +41 -34
- package/dist/backend/index.d.ts +11 -3
- package/dist/backend/index.js +155 -49
- package/dist/backend/plugin.d.ts +36 -6
- package/dist/backend/plugin.js +36 -13
- package/dist/backend/prompt-tools.d.ts +3 -2
- package/dist/backend/prompt-tools.js +18 -7
- package/dist/backend/routes.admin.d.ts +15 -16
- package/dist/backend/routes.admin.js +122 -103
- package/dist/backend/routes.api-key.js +4 -2
- package/dist/backend/routes.external.js +3 -2
- package/dist/backend/routes.public.d.ts +8 -1
- package/dist/backend/routes.public.js +68 -11
- package/dist/backend/services/asset-references.d.ts +12 -1
- package/dist/backend/services/asset-references.js +42 -2
- package/dist/backend/services/attachment-packaging-scopes.d.ts +38 -20
- package/dist/backend/services/attachment-packaging-scopes.js +58 -75
- package/dist/backend/services/attachment.service.d.ts +4 -8
- package/dist/backend/services/attachment.service.js +35 -49
- package/dist/backend/services/attribute-filter-match.d.ts +14 -0
- package/dist/backend/services/attribute-filter-match.js +19 -0
- package/dist/backend/services/attribute-scope-preview.d.ts +17 -7
- package/dist/backend/services/attribute-scope-preview.js +30 -20
- package/dist/backend/services/attribute-set.service.d.ts +10 -1
- package/dist/backend/services/attribute-set.service.js +30 -4
- package/dist/backend/services/attribute-type-mapping.d.ts +2 -2
- package/dist/backend/services/attribute-type-mapping.js +6 -0
- package/dist/backend/services/attribute-usage.d.ts +31 -0
- package/dist/backend/services/attribute-usage.js +29 -0
- package/dist/backend/services/bulk-operation.service.d.ts +1 -1
- package/dist/backend/services/bulk-operation.service.js +16 -6
- package/dist/backend/services/bundle.service.js +19 -1
- package/dist/backend/services/catalog-admin-search.service.d.ts +3 -2
- package/dist/backend/services/catalog-admin-search.service.js +6 -6
- package/dist/backend/services/catalog-admin.service.d.ts +63 -12
- package/dist/backend/services/catalog-admin.service.js +368 -195
- package/dist/backend/services/catalog-attribute-read.service.d.ts +14 -0
- package/dist/backend/services/catalog-attribute-read.service.js +9 -19
- package/dist/backend/services/catalog-bulk-import.service.d.ts +58 -5
- package/dist/backend/services/catalog-bulk-import.service.js +192 -142
- package/dist/backend/services/catalog-bulk-update.service.d.ts +5 -3
- package/dist/backend/services/catalog-bulk-update.service.js +21 -8
- package/dist/backend/services/catalog-product-read.service.d.ts +11 -1
- package/dist/backend/services/catalog-product-read.service.js +37 -17
- package/dist/backend/services/catalog-query.service.d.ts +48 -8
- package/dist/backend/services/catalog-query.service.js +180 -116
- package/dist/backend/services/catalog-quick-search.service.js +5 -5
- package/dist/backend/services/catalog-write-ports.d.ts +14 -16
- package/dist/backend/services/catalog-write-ports.js +11 -70
- package/dist/backend/services/category-admin.service.js +29 -5
- package/dist/backend/services/content-attribute-rules.d.ts +61 -0
- package/dist/backend/services/content-attribute-rules.js +102 -0
- package/dist/backend/services/effective-value.sql.d.ts +24 -38
- package/dist/backend/services/effective-value.sql.js +37 -87
- package/dist/backend/services/gallery-scopes.d.ts +45 -22
- package/dist/backend/services/gallery-scopes.js +116 -109
- package/dist/backend/services/gallery.service.d.ts +13 -27
- package/dist/backend/services/gallery.service.js +75 -199
- package/dist/backend/services/grouped.service.js +20 -3
- package/dist/backend/services/packaging-unit.service.js +7 -12
- package/dist/backend/services/page-builder-content.d.ts +64 -0
- package/dist/backend/services/page-builder-content.js +113 -0
- package/dist/backend/services/primary-asset-url.d.ts +6 -1
- package/dist/backend/services/primary-asset-url.js +9 -4
- package/dist/backend/services/product-availability.service.d.ts +16 -3
- package/dist/backend/services/product-availability.service.js +58 -21
- package/dist/backend/services/product-content.service.d.ts +62 -0
- package/dist/backend/services/product-content.service.js +122 -0
- package/dist/backend/services/product-editor-preferences.service.d.ts +6 -0
- package/dist/backend/services/product-editor-preferences.service.js +12 -0
- package/dist/backend/services/product-global-field-rules.d.ts +39 -0
- package/dist/backend/services/product-global-field-rules.js +84 -0
- package/dist/backend/services/product-link.service.js +14 -16
- package/dist/backend/services/product-list-view-service.js +5 -8
- package/dist/backend/services/product-page-revalidation.d.ts +9 -0
- package/dist/backend/services/product-page-revalidation.js +19 -0
- package/dist/backend/services/product-scopes.service.d.ts +18 -8
- package/dist/backend/services/product-scopes.service.js +91 -36
- package/dist/backend/services/product-value-resolver.service.d.ts +2 -2
- package/dist/backend/services/product-value-resolver.service.js +4 -7
- package/dist/backend/services/publication-window-sweep.d.ts +61 -7
- package/dist/backend/services/publication-window-sweep.js +106 -19
- package/dist/backend/services/scheduled-work-probe.d.ts +34 -0
- package/dist/backend/services/scheduled-work-probe.js +30 -0
- package/dist/backend/services/scope-completeness.d.ts +11 -11
- package/dist/backend/services/scope-completeness.js +26 -33
- package/dist/backend/services/scope-overview.service.d.ts +24 -24
- package/dist/backend/services/scope-overview.service.js +33 -76
- package/dist/backend/services/scoped-store-adapters.d.ts +58 -0
- package/dist/backend/services/scoped-store-adapters.js +92 -0
- package/dist/backend/services/scoped-values-global-only.d.ts +36 -0
- package/dist/backend/services/scoped-values-global-only.js +92 -0
- package/dist/backend/services/scoped-values-import.d.ts +86 -0
- package/dist/backend/services/scoped-values-import.js +320 -0
- package/dist/backend/services/scoped-values-read.service.d.ts +56 -0
- package/dist/backend/services/scoped-values-read.service.js +289 -0
- package/dist/backend/services/scoped-values-save.service.d.ts +79 -0
- package/dist/backend/services/scoped-values-save.service.js +675 -0
- package/dist/backend/services/scoped-values-state.d.ts +94 -0
- package/dist/backend/services/scoped-values-state.js +159 -0
- package/dist/backend/services/scoped-values.service.d.ts +36 -0
- package/dist/backend/services/scoped-values.service.js +92 -0
- package/dist/backend/services/storefront-value-overrides.d.ts +7 -8
- package/dist/backend/services/storefront-value-overrides.js +11 -14
- package/dist/backend/services/table-maintenance-queue.d.ts +78 -0
- package/dist/backend/services/table-maintenance-queue.js +97 -0
- package/dist/backend/services/url-key-resolution.service.d.ts +12 -18
- package/dist/backend/services/url-key-resolution.service.js +43 -43
- package/dist/backend/services/url-key.service.d.ts +87 -135
- package/dist/backend/services/url-key.service.js +447 -619
- package/dist/manifest.d.ts +51 -1
- package/dist/manifest.js +111 -7
- package/dist/migrations/20261030T113855_catalog_scope_model_texts.d.ts +36 -0
- package/dist/migrations/20261030T113855_catalog_scope_model_texts.js +225 -0
- package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.d.ts +18 -0
- package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.js +39 -0
- package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.d.ts +6 -0
- package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.js +119 -0
- package/dist/migrations/20261030T113908_catalog_scope_model_media.d.ts +6 -0
- package/dist/migrations/20261030T113908_catalog_scope_model_media.js +185 -0
- package/dist/migrations/20261104T121504_catalog_product_content_values.d.ts +36 -0
- package/dist/migrations/20261104T121504_catalog_product_content_values.js +53 -0
- package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.d.ts +33 -0
- package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.js +58 -0
- package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.d.ts +36 -0
- package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.js +40 -0
- package/dist/migrations/20261114T000706_catalog_category_main_image.d.ts +37 -0
- package/dist/migrations/20261114T000706_catalog_category_main_image.js +56 -0
- package/dist/migrations/index.d.ts +9 -1
- package/dist/migrations/index.js +17 -1
- package/docs/catalog/attachments.md +53 -43
- package/docs/catalog/attribute-sets.md +3 -2
- package/docs/catalog/attributes.md +99 -25
- package/docs/catalog/category-content.md +9 -3
- package/docs/catalog/composite-products.md +5 -3
- package/docs/catalog/editing-a-product-at-a-scope.md +151 -0
- package/docs/catalog/gallery-and-labels.md +61 -60
- package/docs/catalog/packaging-units.md +43 -34
- package/docs/catalog/per-channel-per-language-overrides.md +83 -410
- package/docs/catalog/product-content.md +184 -0
- package/docs/catalog/product-links.md +2 -2
- package/docs/catalog/url-keys-and-redirects.md +79 -79
- package/docs/catalog.md +113 -31
- package/i18n/en.json +317 -274
- package/i18n/pl.json +319 -276
- package/package.json +13 -12
- package/dist/admin/components/AttachmentScopesDialog.d.ts +0 -22
- package/dist/admin/components/AttachmentScopesDialog.d.ts.map +0 -1
- package/dist/admin/components/AttachmentScopesDialog.js +0 -70
- package/dist/admin/components/AttachmentScopesDialog.js.map +0 -1
- package/dist/admin/components/PackagingUnitsEditor.d.ts.map +0 -1
- package/dist/admin/components/PackagingUnitsEditor.js.map +0 -1
- package/dist/admin/components/ProductAttachmentsSection.d.ts.map +0 -1
- package/dist/admin/components/ProductAttachmentsSection.js.map +0 -1
- package/dist/admin/components/ProductAttributesTab.d.ts.map +0 -1
- package/dist/admin/components/ProductAttributesTab.js.map +0 -1
- package/dist/admin/components/ProductGallerySection.d.ts.map +0 -1
- package/dist/admin/components/ProductGallerySection.js.map +0 -1
- package/dist/admin/components/ProductInventoryTab.d.ts.map +0 -1
- package/dist/admin/components/ProductInventoryTab.js.map +0 -1
- package/dist/admin/components/ProductOrderRulesCard.d.ts.map +0 -1
- package/dist/admin/components/ProductOrderRulesCard.js.map +0 -1
- package/dist/admin/components/ProductScopeControls.d.ts +0 -31
- package/dist/admin/components/ProductScopeControls.d.ts.map +0 -1
- package/dist/admin/components/ProductScopeControls.js +0 -243
- package/dist/admin/components/ProductScopeControls.js.map +0 -1
- package/dist/admin/components/ProductScopeEditor.d.ts +0 -88
- package/dist/admin/components/ProductScopeEditor.d.ts.map +0 -1
- package/dist/admin/components/ProductScopeEditor.js +0 -396
- package/dist/admin/components/ProductScopeEditor.js.map +0 -1
- package/dist/admin/components/ProductScopeOverview.d.ts.map +0 -1
- package/dist/admin/components/ProductScopeOverview.js.map +0 -1
- package/dist/admin/components/ProductStatusPills.d.ts.map +0 -1
- package/dist/admin/components/ProductStatusPills.js.map +0 -1
- package/dist/admin/components/ProductUrlKeysPanel.d.ts +0 -17
- package/dist/admin/components/ProductUrlKeysPanel.d.ts.map +0 -1
- package/dist/admin/components/ProductUrlKeysPanel.js +0 -215
- package/dist/admin/components/ProductUrlKeysPanel.js.map +0 -1
- package/dist/admin/components/ProductsBulkEditDialog.d.ts.map +0 -1
- package/dist/admin/components/ProductsBulkEditDialog.js.map +0 -1
- package/dist/admin/components/ScopedDialogParts.d.ts +0 -23
- package/dist/admin/components/ScopedDialogParts.d.ts.map +0 -1
- package/dist/admin/components/ScopedDialogParts.js +0 -16
- package/dist/admin/components/ScopedDialogParts.js.map +0 -1
- package/dist/admin/index.d.ts.map +0 -1
- package/dist/admin/index.js.map +0 -1
- package/dist/admin/lib/attribute-scope.d.ts.map +0 -1
- package/dist/admin/lib/attribute-scope.js.map +0 -1
- package/dist/admin/lib/bulk-operation-log-text.d.ts.map +0 -1
- package/dist/admin/lib/bulk-operation-log-text.js.map +0 -1
- package/dist/admin/lib/media-scopes.d.ts +0 -41
- package/dist/admin/lib/media-scopes.d.ts.map +0 -1
- package/dist/admin/lib/media-scopes.js +0 -66
- package/dist/admin/lib/media-scopes.js.map +0 -1
- package/dist/admin/lib/product-labels.d.ts.map +0 -1
- package/dist/admin/lib/product-labels.js.map +0 -1
- package/dist/admin/lib/product-scope-drafts.d.ts +0 -77
- package/dist/admin/lib/product-scope-drafts.d.ts.map +0 -1
- package/dist/admin/lib/product-scope-drafts.js +0 -133
- package/dist/admin/lib/product-scope-drafts.js.map +0 -1
- package/dist/admin/lib/product-scopes-api.d.ts.map +0 -1
- package/dist/admin/lib/product-scopes-api.js.map +0 -1
- package/dist/admin/lib/product-url-keys-api.d.ts.map +0 -1
- package/dist/admin/lib/product-url-keys-api.js.map +0 -1
- package/dist/admin/lib/resolve-product-selection.d.ts.map +0 -1
- package/dist/admin/lib/resolve-product-selection.js.map +0 -1
- package/dist/admin/lib/scope-overview.d.ts.map +0 -1
- package/dist/admin/lib/scope-overview.js.map +0 -1
- package/dist/admin/pages/AttachmentTypesPage.d.ts.map +0 -1
- package/dist/admin/pages/AttachmentTypesPage.js.map +0 -1
- package/dist/admin/pages/AttributeSetsPage.d.ts.map +0 -1
- package/dist/admin/pages/AttributeSetsPage.js.map +0 -1
- package/dist/admin/pages/AttributesManager.d.ts.map +0 -1
- package/dist/admin/pages/AttributesManager.js.map +0 -1
- package/dist/admin/pages/BulkOperationDetailPage.d.ts.map +0 -1
- package/dist/admin/pages/BulkOperationDetailPage.js.map +0 -1
- package/dist/admin/pages/BulkOperationsPage.d.ts.map +0 -1
- package/dist/admin/pages/BulkOperationsPage.js.map +0 -1
- package/dist/admin/pages/CategoriesTree.d.ts.map +0 -1
- package/dist/admin/pages/CategoriesTree.js.map +0 -1
- package/dist/admin/pages/CategoryContentPage.d.ts.map +0 -1
- package/dist/admin/pages/CategoryContentPage.js.map +0 -1
- package/dist/admin/pages/ProductEditor.d.ts.map +0 -1
- package/dist/admin/pages/ProductEditor.js.map +0 -1
- package/dist/admin/pages/ProductsList.d.ts.map +0 -1
- package/dist/admin/pages/ProductsList.js.map +0 -1
- package/dist/backend/admin-search-provider.d.ts.map +0 -1
- package/dist/backend/admin-search-provider.js.map +0 -1
- package/dist/backend/commands/attribute-commands.d.ts.map +0 -1
- package/dist/backend/commands/attribute-commands.js.map +0 -1
- package/dist/backend/demo/reset.d.ts.map +0 -1
- package/dist/backend/demo/reset.js.map +0 -1
- package/dist/backend/demo/rows.d.ts.map +0 -1
- package/dist/backend/demo/rows.js.map +0 -1
- package/dist/backend/demo/seed.d.ts.map +0 -1
- package/dist/backend/demo/seed.js.map +0 -1
- package/dist/backend/entities/attachment-type.entity.d.ts.map +0 -1
- package/dist/backend/entities/attachment-type.entity.js.map +0 -1
- package/dist/backend/entities/attribute-set-attribute.entity.d.ts.map +0 -1
- package/dist/backend/entities/attribute-set-attribute.entity.js.map +0 -1
- package/dist/backend/entities/attribute-set.entity.d.ts.map +0 -1
- package/dist/backend/entities/attribute-set.entity.js.map +0 -1
- package/dist/backend/entities/bulk-operation.entity.d.ts.map +0 -1
- package/dist/backend/entities/bulk-operation.entity.js.map +0 -1
- package/dist/backend/entities/bundle-slot-option.entity.d.ts.map +0 -1
- package/dist/backend/entities/bundle-slot-option.entity.js.map +0 -1
- package/dist/backend/entities/bundle-slot.entity.d.ts.map +0 -1
- package/dist/backend/entities/bundle-slot.entity.js.map +0 -1
- package/dist/backend/entities/category.entity.d.ts.map +0 -1
- package/dist/backend/entities/category.entity.js.map +0 -1
- package/dist/backend/entities/gallery-item-channel-hidden.entity.d.ts +0 -14
- package/dist/backend/entities/gallery-item-channel-hidden.entity.d.ts.map +0 -1
- package/dist/backend/entities/gallery-item-channel-hidden.entity.js +0 -42
- package/dist/backend/entities/gallery-item-channel-hidden.entity.js.map +0 -1
- package/dist/backend/entities/gallery-item-channel-label.entity.d.ts +0 -18
- package/dist/backend/entities/gallery-item-channel-label.entity.d.ts.map +0 -1
- package/dist/backend/entities/gallery-item-channel-label.entity.js +0 -49
- package/dist/backend/entities/gallery-item-channel-label.entity.js.map +0 -1
- package/dist/backend/entities/gallery-item-label.entity.d.ts.map +0 -1
- package/dist/backend/entities/gallery-item-label.entity.js.map +0 -1
- package/dist/backend/entities/gallery-item.entity.d.ts.map +0 -1
- package/dist/backend/entities/gallery-item.entity.js.map +0 -1
- package/dist/backend/entities/grouped-item.entity.d.ts.map +0 -1
- package/dist/backend/entities/grouped-item.entity.js.map +0 -1
- package/dist/backend/entities/product-attachment-channel-hidden.entity.d.ts +0 -13
- package/dist/backend/entities/product-attachment-channel-hidden.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-attachment-channel-hidden.entity.js +0 -41
- package/dist/backend/entities/product-attachment-channel-hidden.entity.js.map +0 -1
- package/dist/backend/entities/product-attachment.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-attachment.entity.js.map +0 -1
- package/dist/backend/entities/product-attribute.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-attribute.entity.js.map +0 -1
- package/dist/backend/entities/product-channel-language-scope.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-channel-language-scope.entity.js.map +0 -1
- package/dist/backend/entities/product-channel-scope.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-channel-scope.entity.js.map +0 -1
- package/dist/backend/entities/product-editor-preference.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-editor-preference.entity.js.map +0 -1
- package/dist/backend/entities/product-link.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-link.entity.js.map +0 -1
- package/dist/backend/entities/product-list-saved-view.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-list-saved-view.entity.js.map +0 -1
- package/dist/backend/entities/product-packaging-unit.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-packaging-unit.entity.js.map +0 -1
- package/dist/backend/entities/product-url-key.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-url-key.entity.js.map +0 -1
- package/dist/backend/entities/product-url-redirect.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-url-redirect.entity.js.map +0 -1
- package/dist/backend/entities/product-value-override.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-value-override.entity.js.map +0 -1
- package/dist/backend/entities/product-variant.entity.d.ts.map +0 -1
- package/dist/backend/entities/product-variant.entity.js.map +0 -1
- package/dist/backend/entities/product.entity.d.ts.map +0 -1
- package/dist/backend/entities/product.entity.js.map +0 -1
- package/dist/backend/index.d.ts.map +0 -1
- package/dist/backend/index.js.map +0 -1
- package/dist/backend/plugin.d.ts.map +0 -1
- package/dist/backend/plugin.js.map +0 -1
- package/dist/backend/prompt-tools.d.ts.map +0 -1
- package/dist/backend/prompt-tools.js.map +0 -1
- package/dist/backend/routes.admin.d.ts.map +0 -1
- package/dist/backend/routes.admin.js.map +0 -1
- package/dist/backend/routes.admin.url-keys.d.ts.map +0 -1
- package/dist/backend/routes.admin.url-keys.js.map +0 -1
- package/dist/backend/routes.api-key.d.ts.map +0 -1
- package/dist/backend/routes.api-key.js.map +0 -1
- package/dist/backend/routes.external.d.ts.map +0 -1
- package/dist/backend/routes.external.js.map +0 -1
- package/dist/backend/routes.public.d.ts.map +0 -1
- package/dist/backend/routes.public.js.map +0 -1
- package/dist/backend/routes.public.url-keys.d.ts.map +0 -1
- package/dist/backend/routes.public.url-keys.js.map +0 -1
- package/dist/backend/saved-view-actor.d.ts.map +0 -1
- package/dist/backend/saved-view-actor.js.map +0 -1
- package/dist/backend/services/asset-references.d.ts.map +0 -1
- package/dist/backend/services/asset-references.js.map +0 -1
- package/dist/backend/services/attachment-packaging-scopes.d.ts.map +0 -1
- package/dist/backend/services/attachment-packaging-scopes.js.map +0 -1
- package/dist/backend/services/attachment.service.d.ts.map +0 -1
- package/dist/backend/services/attachment.service.js.map +0 -1
- package/dist/backend/services/attribute-option-validator.d.ts.map +0 -1
- package/dist/backend/services/attribute-option-validator.js.map +0 -1
- package/dist/backend/services/attribute-scope-preview.d.ts.map +0 -1
- package/dist/backend/services/attribute-scope-preview.js.map +0 -1
- package/dist/backend/services/attribute-set-validations.d.ts.map +0 -1
- package/dist/backend/services/attribute-set-validations.js.map +0 -1
- package/dist/backend/services/attribute-set.service.d.ts.map +0 -1
- package/dist/backend/services/attribute-set.service.js.map +0 -1
- package/dist/backend/services/attribute-type-mapping.d.ts.map +0 -1
- package/dist/backend/services/attribute-type-mapping.js.map +0 -1
- package/dist/backend/services/attribute-value-key.service.d.ts.map +0 -1
- package/dist/backend/services/attribute-value-key.service.js.map +0 -1
- package/dist/backend/services/audit-references.d.ts.map +0 -1
- package/dist/backend/services/audit-references.js.map +0 -1
- package/dist/backend/services/bulk-operation-queue.d.ts.map +0 -1
- package/dist/backend/services/bulk-operation-queue.js.map +0 -1
- package/dist/backend/services/bulk-operation.service.d.ts.map +0 -1
- package/dist/backend/services/bulk-operation.service.js.map +0 -1
- package/dist/backend/services/bundle.service.d.ts.map +0 -1
- package/dist/backend/services/bundle.service.js.map +0 -1
- package/dist/backend/services/catalog-admin-search.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-admin-search.service.js.map +0 -1
- package/dist/backend/services/catalog-admin.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-admin.service.js.map +0 -1
- package/dist/backend/services/catalog-attribute-read.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-attribute-read.service.js.map +0 -1
- package/dist/backend/services/catalog-bulk-import.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-bulk-import.service.js.map +0 -1
- package/dist/backend/services/catalog-bulk-update.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-bulk-update.service.js.map +0 -1
- package/dist/backend/services/catalog-category-read.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-category-read.service.js.map +0 -1
- package/dist/backend/services/catalog-org-price-decorator.d.ts.map +0 -1
- package/dist/backend/services/catalog-org-price-decorator.js.map +0 -1
- package/dist/backend/services/catalog-product-filter.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-product-filter.service.js.map +0 -1
- package/dist/backend/services/catalog-product-read.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-product-read.service.js.map +0 -1
- package/dist/backend/services/catalog-query.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-query.service.js.map +0 -1
- package/dist/backend/services/catalog-quick-search.service.d.ts.map +0 -1
- package/dist/backend/services/catalog-quick-search.service.js.map +0 -1
- package/dist/backend/services/catalog-write-ports.d.ts.map +0 -1
- package/dist/backend/services/catalog-write-ports.js.map +0 -1
- package/dist/backend/services/category-admin.service.d.ts.map +0 -1
- package/dist/backend/services/category-admin.service.js.map +0 -1
- package/dist/backend/services/channel-url-facts.d.ts.map +0 -1
- package/dist/backend/services/channel-url-facts.js.map +0 -1
- package/dist/backend/services/effective-value.sql.d.ts.map +0 -1
- package/dist/backend/services/effective-value.sql.js.map +0 -1
- package/dist/backend/services/gallery-scopes.d.ts.map +0 -1
- package/dist/backend/services/gallery-scopes.js.map +0 -1
- package/dist/backend/services/gallery.service.d.ts.map +0 -1
- package/dist/backend/services/gallery.service.js.map +0 -1
- package/dist/backend/services/grouped.service.d.ts.map +0 -1
- package/dist/backend/services/grouped.service.js.map +0 -1
- package/dist/backend/services/label-resolver.d.ts.map +0 -1
- package/dist/backend/services/label-resolver.js.map +0 -1
- package/dist/backend/services/linkable-asset.d.ts.map +0 -1
- package/dist/backend/services/linkable-asset.js.map +0 -1
- package/dist/backend/services/packaging-unit.service.d.ts.map +0 -1
- package/dist/backend/services/packaging-unit.service.js.map +0 -1
- package/dist/backend/services/primary-asset-url.d.ts.map +0 -1
- package/dist/backend/services/primary-asset-url.js.map +0 -1
- package/dist/backend/services/product-availability.service.d.ts.map +0 -1
- package/dist/backend/services/product-availability.service.js.map +0 -1
- package/dist/backend/services/product-availability.sql.d.ts.map +0 -1
- package/dist/backend/services/product-availability.sql.js.map +0 -1
- package/dist/backend/services/product-editor-preferences.service.d.ts.map +0 -1
- package/dist/backend/services/product-editor-preferences.service.js.map +0 -1
- package/dist/backend/services/product-link.service.d.ts.map +0 -1
- package/dist/backend/services/product-link.service.js.map +0 -1
- package/dist/backend/services/product-list-view-service.d.ts.map +0 -1
- package/dist/backend/services/product-list-view-service.js.map +0 -1
- package/dist/backend/services/product-overrides.service.d.ts +0 -84
- package/dist/backend/services/product-overrides.service.d.ts.map +0 -1
- package/dist/backend/services/product-overrides.service.js +0 -211
- package/dist/backend/services/product-overrides.service.js.map +0 -1
- package/dist/backend/services/product-page-revalidation.d.ts.map +0 -1
- package/dist/backend/services/product-page-revalidation.js.map +0 -1
- package/dist/backend/services/product-scope-context.service.d.ts +0 -36
- package/dist/backend/services/product-scope-context.service.d.ts.map +0 -1
- package/dist/backend/services/product-scope-context.service.js +0 -107
- package/dist/backend/services/product-scope-context.service.js.map +0 -1
- package/dist/backend/services/product-scopes.service.d.ts.map +0 -1
- package/dist/backend/services/product-scopes.service.js.map +0 -1
- package/dist/backend/services/product-summary-text.d.ts.map +0 -1
- package/dist/backend/services/product-summary-text.js.map +0 -1
- package/dist/backend/services/product-type-validations.d.ts.map +0 -1
- package/dist/backend/services/product-type-validations.js.map +0 -1
- package/dist/backend/services/product-value-resolver.service.d.ts.map +0 -1
- package/dist/backend/services/product-value-resolver.service.js.map +0 -1
- package/dist/backend/services/publication-window-sweep.d.ts.map +0 -1
- package/dist/backend/services/publication-window-sweep.js.map +0 -1
- package/dist/backend/services/scope-completeness.d.ts.map +0 -1
- package/dist/backend/services/scope-completeness.js.map +0 -1
- package/dist/backend/services/scope-overview.service.d.ts.map +0 -1
- package/dist/backend/services/scope-overview.service.js.map +0 -1
- package/dist/backend/services/sql-id-arrays.d.ts.map +0 -1
- package/dist/backend/services/sql-id-arrays.js.map +0 -1
- package/dist/backend/services/storefront-value-overrides.d.ts.map +0 -1
- package/dist/backend/services/storefront-value-overrides.js.map +0 -1
- package/dist/backend/services/system-attribute-scopes.d.ts.map +0 -1
- package/dist/backend/services/system-attribute-scopes.js.map +0 -1
- package/dist/backend/services/url-key-resolution.service.d.ts.map +0 -1
- package/dist/backend/services/url-key-resolution.service.js.map +0 -1
- package/dist/backend/services/url-key.service.d.ts.map +0 -1
- package/dist/backend/services/url-key.service.js.map +0 -1
- package/dist/backend/services/viewer-organization.d.ts.map +0 -1
- package/dist/backend/services/viewer-organization.js.map +0 -1
- package/dist/manifest.d.ts.map +0 -1
- package/dist/manifest.js.map +0 -1
- package/dist/migrations/20260429T064146_catalog_attribute_sets_init.d.ts.map +0 -1
- package/dist/migrations/20260429T064146_catalog_attribute_sets_init.js.map +0 -1
- package/dist/migrations/20260429T070004_catalog_product_attribute_extensions.d.ts.map +0 -1
- package/dist/migrations/20260429T070004_catalog_product_attribute_extensions.js.map +0 -1
- package/dist/migrations/20260429T102322_catalog_product_type_and_virtual_fields.d.ts.map +0 -1
- package/dist/migrations/20260429T102322_catalog_product_type_and_virtual_fields.js.map +0 -1
- package/dist/migrations/20260429T111839_catalog_gallery_items_and_labels.d.ts.map +0 -1
- package/dist/migrations/20260429T111839_catalog_gallery_items_and_labels.js.map +0 -1
- package/dist/migrations/20260429T112543_catalog_product_attachments.d.ts.map +0 -1
- package/dist/migrations/20260429T112543_catalog_product_attachments.js.map +0 -1
- package/dist/migrations/20260429T123726_catalog_product_links.d.ts.map +0 -1
- package/dist/migrations/20260429T123726_catalog_product_links.js.map +0 -1
- package/dist/migrations/20260429T130803_catalog_grouped_and_bundle.d.ts.map +0 -1
- package/dist/migrations/20260429T130803_catalog_grouped_and_bundle.js.map +0 -1
- package/dist/migrations/20260501T185835_catalog_product_attribute_is_comparable.d.ts.map +0 -1
- package/dist/migrations/20260501T185835_catalog_product_attribute_is_comparable.js.map +0 -1
- package/dist/migrations/20260505T060113_catalog_attribute_options_and_flags.d.ts.map +0 -1
- package/dist/migrations/20260505T060113_catalog_attribute_options_and_flags.js.map +0 -1
- package/dist/migrations/20260515T082629_catalog_attribute_mass_editable.d.ts.map +0 -1
- package/dist/migrations/20260515T082629_catalog_attribute_mass_editable.js.map +0 -1
- package/dist/migrations/20260526T124736_catalog_product_status_inactive.d.ts.map +0 -1
- package/dist/migrations/20260526T124736_catalog_product_status_inactive.js.map +0 -1
- package/dist/migrations/20260611T140346_catalog_product_value_overrides_init.d.ts.map +0 -1
- package/dist/migrations/20260611T140346_catalog_product_value_overrides_init.js.map +0 -1
- package/dist/migrations/20260611T140400_catalog_attribute_quick_searchable.d.ts.map +0 -1
- package/dist/migrations/20260611T140400_catalog_attribute_quick_searchable.js.map +0 -1
- package/dist/migrations/20260611T140407_catalog_bulk_operations.d.ts.map +0 -1
- package/dist/migrations/20260611T140407_catalog_bulk_operations.js.map +0 -1
- package/dist/migrations/20260611T140408_catalog_bulk_operation_logs.d.ts.map +0 -1
- package/dist/migrations/20260611T140408_catalog_bulk_operation_logs.js.map +0 -1
- package/dist/migrations/20260611T140412_catalog_product_packaging_units.d.ts.map +0 -1
- package/dist/migrations/20260611T140412_catalog_product_packaging_units.js.map +0 -1
- package/dist/migrations/20260718T060659_catalog_bulk_operation_revert_state.d.ts.map +0 -1
- package/dist/migrations/20260718T060659_catalog_bulk_operation_revert_state.js.map +0 -1
- package/dist/migrations/20260718T200343_catalog_category_custom_field_values.d.ts.map +0 -1
- package/dist/migrations/20260718T200343_catalog_category_custom_field_values.js.map +0 -1
- package/dist/migrations/20260723T230401_catalog_attributes_on_custom_fields.d.ts.map +0 -1
- package/dist/migrations/20260723T230401_catalog_attributes_on_custom_fields.js.map +0 -1
- package/dist/migrations/20260804T152604_catalog_widen_product_sku.d.ts.map +0 -1
- package/dist/migrations/20260804T152604_catalog_widen_product_sku.js.map +0 -1
- package/dist/migrations/20260804T160244_catalog_category_activation.d.ts.map +0 -1
- package/dist/migrations/20260804T160244_catalog_category_activation.js.map +0 -1
- package/dist/migrations/20260912T094557_catalog_sales_channel_products.d.ts.map +0 -1
- package/dist/migrations/20260912T094557_catalog_sales_channel_products.js.map +0 -1
- package/dist/migrations/20260912T094623_catalog_sales_channel_categories.d.ts.map +0 -1
- package/dist/migrations/20260912T094623_catalog_sales_channel_categories.js.map +0 -1
- package/dist/migrations/20260925T125527_catalog_inventory_columns.d.ts.map +0 -1
- package/dist/migrations/20260925T125527_catalog_inventory_columns.js.map +0 -1
- package/dist/migrations/20261008T080839_catalog_product_attribute_is_price_rule.d.ts.map +0 -1
- package/dist/migrations/20261008T080839_catalog_product_attribute_is_price_rule.js.map +0 -1
- package/dist/migrations/20261008T092714_catalog_category_content.d.ts.map +0 -1
- package/dist/migrations/20261008T092714_catalog_category_content.js.map +0 -1
- package/dist/migrations/20261014T170531_catalog_product_list_saved_views.d.ts.map +0 -1
- package/dist/migrations/20261014T170531_catalog_product_list_saved_views.js.map +0 -1
- package/dist/migrations/20261016T082008_catalog_order_rules.d.ts.map +0 -1
- package/dist/migrations/20261016T082008_catalog_order_rules.js.map +0 -1
- package/dist/migrations/20261022T035133_catalog_product_scopes.d.ts.map +0 -1
- package/dist/migrations/20261022T035133_catalog_product_scopes.js.map +0 -1
- package/dist/migrations/20261022T054223_catalog_product_url_keys.d.ts.map +0 -1
- package/dist/migrations/20261022T054223_catalog_product_url_keys.js.map +0 -1
- package/dist/migrations/20261022T111811_catalog_price_fields_removed.d.ts.map +0 -1
- package/dist/migrations/20261022T111811_catalog_price_fields_removed.js.map +0 -1
- package/dist/migrations/20261022T182523_catalog_admin_name_keys.d.ts.map +0 -1
- package/dist/migrations/20261022T182523_catalog_admin_name_keys.js.map +0 -1
- package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.d.ts.map +0 -1
- package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.js.map +0 -1
- package/dist/migrations/20261026T033453_catalog_product_media_scopes.d.ts.map +0 -1
- package/dist/migrations/20261026T033453_catalog_product_media_scopes.js.map +0 -1
- package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.d.ts.map +0 -1
- package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.js.map +0 -1
- package/dist/migrations/index.d.ts.map +0 -1
- package/dist/migrations/index.js.map +0 -1
- package/dist/ports/index.d.ts.map +0 -1
- package/dist/ports/index.js.map +0 -1
package/docs/catalog.md
CHANGED
|
@@ -1,13 +1,14 @@
|
|
|
1
1
|
---
|
|
2
|
-
title:
|
|
2
|
+
title: Catalog
|
|
3
3
|
sidebar_label: Catalog
|
|
4
4
|
description: Products, variants, categories, attributes, sales channels
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
# `catalog`
|
|
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
|
|
@@ -24,7 +25,7 @@ otherwise; every price names its currency either way. A malformed code is refuse
|
|
|
24
25
|
| Verb + Path | Audience | Purpose |
|
|
25
26
|
| --- | --- | --- |
|
|
26
27
|
| `GET /api/v1/catalog/products` | storefront / API key | List/search/filter products in the active Sales Channel |
|
|
27
|
-
| `GET /api/v1/catalog/products/:idOrSlug` | storefront | Product detail (no amount where the viewer's price display mode is *None*) |
|
|
28
|
+
| `GET /api/v1/catalog/products/:idOrSlug` | storefront | Product detail (no amount where the viewer's price display mode is *None*); `?include=content` adds the product's Page Builder content ([Product content](./catalog/product-content.md)) |
|
|
28
29
|
| `GET /api/v1/catalog/categories` | storefront | Nested category tree |
|
|
29
30
|
| `GET /api/v1/catalog/categories/:id/content` | storefront | One category's page content, resolved to the caller's language |
|
|
30
31
|
| `GET /api/v1/catalog/filters` | storefront | Filterable attributes for the active Sales Channel |
|
|
@@ -32,28 +33,34 @@ 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
|
-
| `DELETE /api/v1/admin/catalog/products/:id` | admin | Delete (soft) — not the Archive action |
|
|
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 |
|
|
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 |
|
|
43
46
|
| `POST /api/v1/admin/catalog/attributes` | admin | Create attribute (accepts the new flags + inline `options[]` for select-style types) |
|
|
44
47
|
| `PATCH /api/v1/admin/catalog/attributes/:key` | admin | Hot-toggle `isFilterable` / `isSearchable` / `isVariantAxis` / `isPromoRule` / `isPriceRule` / `isComparable` / `isVisibleOnProductPage` / `isRequired` / `filterPosition` (re-emits `attribute.updated.v1`) |
|
|
45
|
-
| `
|
|
48
|
+
| `GET /api/v1/admin/catalog/attributes/:idOrKey/usage` | admin | What deleting the attribute would meet — set memberships, product values, product content ([Attributes](./catalog/attributes.md#deleting-an-attribute)) |
|
|
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) |
|
|
46
50
|
| `GET /api/v1/admin/catalog/attributes/:idOrKey/options` | admin | List option-list rows for select/enum/multiselect attributes |
|
|
47
51
|
| `POST /api/v1/admin/catalog/attributes/:idOrKey/options` | admin | Append an option |
|
|
48
|
-
| `PATCH /api/v1/admin/catalog/
|
|
49
|
-
| `DELETE /api/v1/admin/catalog/
|
|
50
|
-
| `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 |
|
|
51
55
|
| `GET /api/v1/admin/catalog/categories` | admin | Flat list, the UI folds into a tree |
|
|
52
|
-
| `POST /api/v1/admin/catalog/categories` | admin | Create (parent must exist) |
|
|
53
|
-
| `PATCH /api/v1/admin/catalog/categories/:id` | admin | Update; reparenting walks the new parent's chain to refuse cycles (409) |
|
|
54
|
-
| `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 |
|
|
55
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)) |
|
|
56
60
|
| `PUT /api/v1/admin/catalog/categories/:id/content` | admin | Replace the category's page content; `null` clears it |
|
|
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)) |
|
|
62
|
+
| `GET /api/v1/admin/catalog/products/:id/content/:attributeKey` | admin | One content attribute's envelope — one Page Builder document per language |
|
|
63
|
+
| `PUT /api/v1/admin/catalog/products/:id/content/:attributeKey` | admin | Replace one content attribute's envelope; `null` clears it |
|
|
57
64
|
| `PUT /api/v1/catalog/products/by-sku/:sku` | API key | Idempotent upsert (PIM sync); an update is audited as `product.update` naming the key (`apiKeyId`) and is never checked for completeness |
|
|
58
65
|
|
|
59
66
|
## Product status and archiving
|
|
@@ -127,10 +134,10 @@ reports any product changed since.
|
|
|
127
134
|
|
|
128
135
|
When an operator's **status change** switches a product on for a sales channel and
|
|
129
136
|
language — the global status, a channel or channel × language status, single or in
|
|
130
|
-
bulk — the product must have,
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
attribute of its attribute set. The setting **Completeness check when switching a
|
|
137
|
+
bulk — the product must have, at that channel and language: a non-empty effective
|
|
138
|
+
**name** (Channel × language → Channel → Global; a deliberately empty override counts
|
|
139
|
+
as missing), a **URL key** (the Global key counts) and an effective value for every
|
|
140
|
+
**required** attribute of its attribute set. The setting **Completeness check when switching a
|
|
134
141
|
product on** (`catalog.scope_completeness_gate`, one value for the whole platform)
|
|
135
142
|
decides what happens when something is missing:
|
|
136
143
|
|
|
@@ -143,7 +150,7 @@ decides what happens when something is missing:
|
|
|
143
150
|
|
|
144
151
|
Only a status change is checked. A product that goes live because it joins a channel,
|
|
145
152
|
a channel gains a language, its publication window opens, its audience changes, or it
|
|
146
|
-
is restored is not checked; the **scope
|
|
153
|
+
is restored is not checked; the **scope map** of the product editor shows what is
|
|
147
154
|
missing at every channel and language instead. Setting an archived product `active` is
|
|
148
155
|
checked like any status change, although the product stays archived. Imports, PIM
|
|
149
156
|
synchronisation and the API-key upsert are never checked.
|
|
@@ -177,6 +184,11 @@ buyer pays is chosen.
|
|
|
177
184
|
the position it continues from can be a product the viewer may not see. A cursor that does not
|
|
178
185
|
open — altered, issued by a release before the seal, or before the instance's session key was
|
|
179
186
|
changed — starts the listing again at its first page.
|
|
187
|
+
- **Paging and creation time** — the default ordering, and the order of the unpriced products that
|
|
188
|
+
follow a price ordering, is the product's creation time, newest first. It is stored to the
|
|
189
|
+
millisecond: a value written by SQL, such as an import's or a bulk insert's `now()`, is rounded
|
|
190
|
+
to the millisecond as it is stored. So a walk through the listing by its cursor meets every
|
|
191
|
+
product once, including products created within the same millisecond.
|
|
180
192
|
- **Reading named products** — `?ids=<id>,<id>,…` on `GET /api/v1/catalog/products` restricts the
|
|
181
193
|
listing to those products: at most 24 distinct ids, each a uuid, or `400 VALIDATION_FAILED`. The
|
|
182
194
|
answer is the subset the viewer may see, priced exactly as any listing card for that viewer, in
|
|
@@ -185,8 +197,17 @@ buyer pays is chosen.
|
|
|
185
197
|
way.
|
|
186
198
|
- **Where the viewer's price display mode is *None*** — for instance an anonymous visitor on a
|
|
187
199
|
channel that hides prices until sign-in — the listing and the product detail carry no amount, and
|
|
188
|
-
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
|
|
189
201
|
of their own any more: the display mode decides, for each viewer.
|
|
202
|
+
- **Gross prices use each product's own VAT rate.** Every product on the listing and the product
|
|
203
|
+
detail carries `vatRate`, the VAT rate the viewer is charged for it, as a fraction (`0.08` = 8 %).
|
|
204
|
+
It is the rate the cart and the order apply: the product's tax class (its type) against the
|
|
205
|
+
viewer's organization — its VAT status and registered country. A VAT-exempt or reverse-charge
|
|
206
|
+
organization gets `0`; an anonymous visitor, or a buyer with no organization, is treated as a VAT
|
|
207
|
+
payer in Poland. The storefront derives every product's gross price — on the cards, the list rows
|
|
208
|
+
and the product page — from this rate. Where a reply carries no rate (`null` when the rate could
|
|
209
|
+
not be read, or no field from an older backend), the storefront shows the net price, labelled
|
|
210
|
+
net, and never a gross at an assumed rate.
|
|
190
211
|
|
|
191
212
|
For developers: the listing paths price a whole page in one batched call —
|
|
192
213
|
`resolveListingPrices`, or `resolveListingPriceDetails` where the page renders the split
|
|
@@ -200,6 +221,14 @@ category and attribute writes publish the events `price_lists` subscribes to, wh
|
|
|
200
221
|
pricing caches and mark on the price surface the products each event concerns, for the surface
|
|
201
222
|
worker to refresh.
|
|
202
223
|
|
|
224
|
+
`vatRate` is resolved per reply by `createProductTaxRateResolver` (`@endora-commerce/contracts`),
|
|
225
|
+
the rule the cart uses too, over `organizations`' `organizationTaxProfilePort` and `taxes`'
|
|
226
|
+
`taxService`. It depends on the viewer's organization and nothing else about the viewer, so it
|
|
227
|
+
follows the same cache rule as the price: a reply for a viewer naming an organization is
|
|
228
|
+
`Cache-Control: private, no-store`, and the shareable reply is the anonymous one, which carries the
|
|
229
|
+
guest's rate. A failed resolution answers `vatRate: null` on every product rather than refusing the
|
|
230
|
+
listing.
|
|
231
|
+
|
|
203
232
|
### Removed price fields (migration note)
|
|
204
233
|
|
|
205
234
|
The release that introduced price books removed the product's *Default unit price* (the
|
|
@@ -211,10 +240,31 @@ fields with `400 PRICE_SET_IN_PRICE_BOOKS` (`PRICE_FIELDS_REFUSED_ON_PRODUCTS`,
|
|
|
211
240
|
price books. The catalogue's migration `20261022T111811_catalog_price_fields_removed.ts` dropped the
|
|
212
241
|
column and stripped the keys.
|
|
213
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
|
+
|
|
214
264
|
## Entities
|
|
215
265
|
|
|
216
|
-
`Product`, `ProductVariant`, `Category`, `ProductAttribute
|
|
217
|
-
`SalesChannel
|
|
266
|
+
`Product`, `ProductVariant`, `Category`, `ProductAttribute` (the
|
|
267
|
+
`SalesChannel` entity is the platform's), plus the M:N bridges
|
|
218
268
|
`product_categories`, `sales_channel_products`, `product_assets`, and
|
|
219
269
|
`ProductListSavedView` (`product_list_saved_views`, the product list's saved
|
|
220
270
|
views).
|
|
@@ -346,7 +396,7 @@ modules are present. The payload is sent whole; the strict schemas are
|
|
|
346
396
|
| Event | Sent when | Payload, beside `eventId` and `occurredAt` |
|
|
347
397
|
| --- | --- | --- |
|
|
348
398
|
| `product.created.v1` | A product is created — in the Admin UI, through the API-key upsert, by an import or a PIM synchronisation, or by duplicating another product. | `productId` (UUID), `sku` — the SKU it was created with; it can change later, `productId` cannot. |
|
|
349
|
-
| `product.updated.v1` | A product is written, or one of its variants is created, changed or deleted. | `productId`, `changedFields` — the names of the product fields the write
|
|
399
|
+
| `product.updated.v1` | A product is written, or one of its variants is created, changed or deleted. | `productId`, `changedFields` — the names of the product fields whose stored value the write changed (`name`, `status`, `categoryIds`, …; `variants` for a variant write). Names only, an open list, and it may be empty. A product update that changes nothing is not announced. |
|
|
350
400
|
| `product.archived.v1` | A product is archived by the Archive action — for one product or in bulk. Once per transition: archiving an archived product sends nothing. A status change never sends it: `inactive` is plain off. | `productId` |
|
|
351
401
|
|
|
352
402
|
- **Order.** Archive sends `product.updated.v1` (with `archivedAt` in
|
|
@@ -410,9 +460,10 @@ back. Both are edited in the **Order rules** card on the product editor's
|
|
|
410
460
|
may order in one order. Optional; a whole number from **1 to 1 000 000**, or
|
|
411
461
|
empty for no minimum. It applies to `simple` and `configurable` products
|
|
412
462
|
only: on a `grouped`, `bundle` or `virtual` product the card says so, and
|
|
413
|
-
the API refuses the field with `422
|
|
414
|
-
`minOrderQuantity`, on create
|
|
415
|
-
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`.
|
|
416
467
|
- **A minimum per packaging unit** — each packaging unit may carry its own
|
|
417
468
|
minimum number of units; see [Packaging Units](./catalog/packaging-units.md).
|
|
418
469
|
|
|
@@ -456,8 +507,10 @@ value is on its own page.
|
|
|
456
507
|
### Per sales channel
|
|
457
508
|
|
|
458
509
|
Both rules can be overridden for one sales channel — **Order rules** per channel in the
|
|
459
|
-
product's scopes
|
|
460
|
-
`
|
|
510
|
+
product's scopes — in the product editor at a channel, or through
|
|
511
|
+
`PUT /api/v1/admin/catalog/products/:id/scoped-values` (`minOrderQuantity`, `returnable`) or
|
|
512
|
+
`PATCH /api/v1/admin/catalog/products/:id/scopes` for API clients. `{ "inherit": true }` uses
|
|
513
|
+
the Global value again; `null` on the minimum stores "no minimum" for that channel. The channel's value
|
|
461
514
|
applies wherever a basket, an order or a quote request belongs to that channel: adding to
|
|
462
515
|
the basket, the basket view, submitting for approval, the checkout preview, placement, the
|
|
463
516
|
admin order preview, quote requests and the buyer's quick-order import. A channel minimum
|
|
@@ -510,6 +563,9 @@ The catalog grew several capability surfaces, each with its own page:
|
|
|
510
563
|
- [Composite Products](./catalog/composite-products.md) — `grouped`
|
|
511
564
|
(fixed children), `bundle` (configurable slots), `virtual` (digital
|
|
512
565
|
delivery)
|
|
566
|
+
- [Product content](./catalog/product-content.md) — Page Builder documents
|
|
567
|
+
kept per product in content attributes and shown in the product page's
|
|
568
|
+
description tab
|
|
513
569
|
|
|
514
570
|
Five product types are now supported: `simple`, `configurable`,
|
|
515
571
|
`grouped`, `bundle`, `virtual`. `simple` and `configurable` are the
|
|
@@ -601,8 +657,34 @@ compatibility at the API boundary.
|
|
|
601
657
|
Product `sku` is mutable. The internal canonical reference for every
|
|
602
658
|
cross-module link (assets, links, RFQ items, ...) is the `Product.id`
|
|
603
659
|
UUID, which never changes. Updating the SKU writes an audit row and
|
|
604
|
-
refuses with `409
|
|
605
|
-
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.
|
|
665
|
+
|
|
666
|
+
### A deleted product frees its SKU
|
|
667
|
+
|
|
668
|
+
Deleting a product (`DELETE /api/v1/admin/catalog/products/:id`) frees its
|
|
669
|
+
SKU and the SKUs of its variants: a new product or variant can take them at
|
|
670
|
+
once — in the Admin UI, through `PUT /api/v1/catalog/products/by-sku/:sku`
|
|
671
|
+
(which then creates a new product rather than updating the deleted one), or
|
|
672
|
+
from an import or a PIM synchronisation. Products and variants share one SKU
|
|
673
|
+
namespace, so a deleted variant's SKU can be reused by a product and the
|
|
674
|
+
other way round. This also applies to products deleted before the change.
|
|
675
|
+
|
|
676
|
+
The deleted product keeps its real SKU, so the audit log and a reconciliation
|
|
677
|
+
with an ERP or PIM still show it, and orders, invoices and quotes keep the SKU
|
|
678
|
+
they recorded at the time. A deletion cannot be undone, and a deleted product
|
|
679
|
+
cannot be restored.
|
|
680
|
+
|
|
681
|
+
Every lookup by SKU addresses the live product. A product import and the CSV
|
|
682
|
+
stock import write the live product; on the catalogue's read port
|
|
683
|
+
(`catalogProductReadPort`), `findBySku`, `findBySkus` and `findVariantsBySkus`
|
|
684
|
+
answer the live product or variant when there is one, and otherwise the most
|
|
685
|
+
recently deleted one holding that SKU — at most one per SKU. Pass
|
|
686
|
+
`{ liveOnly: true }` to `findBySku` and `findBySkus` to ignore deleted
|
|
687
|
+
products altogether.
|
|
606
688
|
|
|
607
689
|
### Attribute Set swap
|
|
608
690
|
|
|
@@ -641,7 +723,7 @@ and ownership model is different:
|
|
|
641
723
|
catalog behaviour flags (`isSearchable`, `isFilterable`,
|
|
642
724
|
`isVariantAxis`, `displayAsSlider`, `isComparable`,
|
|
643
725
|
`quickSearchable`, `isPromoRule`, `isPriceRule`, `filterPosition`,
|
|
644
|
-
`isVisibleOnProductPage`, `
|
|
726
|
+
`isVisibleOnProductPage`, `scopable`,
|
|
645
727
|
`massEditable`) plus two presentation refinements (`selectDisplay`,
|
|
646
728
|
`numericKind`) that keep the legacy `enum`/`select` and
|
|
647
729
|
`number`/`price` distinctions lossless. **Flags stay catalog-owned**
|
|
@@ -655,7 +737,7 @@ and ownership model is different:
|
|
|
655
737
|
row), using the transactional apply seam exported by
|
|
656
738
|
`custom_fields`. The generic Custom Fields admin surface lists
|
|
657
739
|
product definitions read-only and refuses mutations with
|
|
658
|
-
`409
|
|
740
|
+
`409 CUSTOM_FIELD_HOST_MANAGED`.
|
|
659
741
|
- **Migration `20260723T230401_catalog_attributes_on_custom_fields.ts`** performed the
|
|
660
742
|
one-time convergence in a single transaction: backfilled one
|
|
661
743
|
definition per legacy attribute (key, labels, mapped value type,
|