@endora-commerce/mod-catalog 0.103.1 → 0.105.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.
Files changed (79) hide show
  1. package/dist/admin/index.d.ts.map +1 -1
  2. package/dist/admin/index.js +11 -0
  3. package/dist/admin/index.js.map +1 -1
  4. package/dist/admin/pages/AttributesManager.d.ts.map +1 -1
  5. package/dist/admin/pages/AttributesManager.js +8 -2
  6. package/dist/admin/pages/AttributesManager.js.map +1 -1
  7. package/dist/admin/pages/CategoriesTree.d.ts.map +1 -1
  8. package/dist/admin/pages/CategoriesTree.js +20 -2
  9. package/dist/admin/pages/CategoriesTree.js.map +1 -1
  10. package/dist/admin/pages/CategoryContentPage.d.ts +28 -0
  11. package/dist/admin/pages/CategoryContentPage.d.ts.map +1 -0
  12. package/dist/admin/pages/CategoryContentPage.js +159 -0
  13. package/dist/admin/pages/CategoryContentPage.js.map +1 -0
  14. package/dist/backend/commands/attribute-commands.d.ts.map +1 -1
  15. package/dist/backend/commands/attribute-commands.js +8 -0
  16. package/dist/backend/commands/attribute-commands.js.map +1 -1
  17. package/dist/backend/demo/reset.d.ts.map +1 -1
  18. package/dist/backend/demo/reset.js +8 -4
  19. package/dist/backend/demo/reset.js.map +1 -1
  20. package/dist/backend/entities/category.entity.d.ts +3 -1
  21. package/dist/backend/entities/category.entity.d.ts.map +1 -1
  22. package/dist/backend/entities/category.entity.js +14 -0
  23. package/dist/backend/entities/category.entity.js.map +1 -1
  24. package/dist/backend/entities/product-attribute.entity.d.ts +5 -3
  25. package/dist/backend/entities/product-attribute.entity.d.ts.map +1 -1
  26. package/dist/backend/entities/product-attribute.entity.js +8 -2
  27. package/dist/backend/entities/product-attribute.entity.js.map +1 -1
  28. package/dist/backend/index.d.ts.map +1 -1
  29. package/dist/backend/index.js +35 -1
  30. package/dist/backend/index.js.map +1 -1
  31. package/dist/backend/routes.admin.d.ts.map +1 -1
  32. package/dist/backend/routes.admin.js +19 -1
  33. package/dist/backend/routes.admin.js.map +1 -1
  34. package/dist/backend/routes.public.d.ts.map +1 -1
  35. package/dist/backend/routes.public.js +42 -7
  36. package/dist/backend/routes.public.js.map +1 -1
  37. package/dist/backend/services/asset-references.d.ts.map +1 -1
  38. package/dist/backend/services/asset-references.js +49 -5
  39. package/dist/backend/services/asset-references.js.map +1 -1
  40. package/dist/backend/services/bulk-operation.service.d.ts.map +1 -1
  41. package/dist/backend/services/bulk-operation.service.js +4 -1
  42. package/dist/backend/services/bulk-operation.service.js.map +1 -1
  43. package/dist/backend/services/catalog-admin.service.d.ts +6 -4
  44. package/dist/backend/services/catalog-admin.service.d.ts.map +1 -1
  45. package/dist/backend/services/catalog-admin.service.js +67 -12
  46. package/dist/backend/services/catalog-admin.service.js.map +1 -1
  47. package/dist/backend/services/catalog-attribute-read.service.d.ts.map +1 -1
  48. package/dist/backend/services/catalog-attribute-read.service.js +1 -0
  49. package/dist/backend/services/catalog-attribute-read.service.js.map +1 -1
  50. package/dist/backend/services/catalog-query.service.d.ts +28 -4
  51. package/dist/backend/services/catalog-query.service.d.ts.map +1 -1
  52. package/dist/backend/services/catalog-query.service.js +305 -30
  53. package/dist/backend/services/catalog-query.service.js.map +1 -1
  54. package/dist/backend/services/category-admin.service.d.ts +32 -1
  55. package/dist/backend/services/category-admin.service.d.ts.map +1 -1
  56. package/dist/backend/services/category-admin.service.js +54 -0
  57. package/dist/backend/services/category-admin.service.js.map +1 -1
  58. package/dist/manifest.d.ts +2 -2
  59. package/dist/manifest.d.ts.map +1 -1
  60. package/dist/manifest.js +20 -4
  61. package/dist/manifest.js.map +1 -1
  62. package/dist/migrations/20261008T080839_catalog_product_attribute_is_price_rule.d.ts +22 -0
  63. package/dist/migrations/20261008T080839_catalog_product_attribute_is_price_rule.d.ts.map +1 -0
  64. package/dist/migrations/20261008T080839_catalog_product_attribute_is_price_rule.js +29 -0
  65. package/dist/migrations/20261008T080839_catalog_product_attribute_is_price_rule.js.map +1 -0
  66. package/dist/migrations/20261008T092714_catalog_category_content.d.ts +21 -0
  67. package/dist/migrations/20261008T092714_catalog_category_content.d.ts.map +1 -0
  68. package/dist/migrations/20261008T092714_catalog_category_content.js +25 -0
  69. package/dist/migrations/20261008T092714_catalog_category_content.js.map +1 -0
  70. package/dist/migrations/index.d.ts +3 -1
  71. package/dist/migrations/index.d.ts.map +1 -1
  72. package/dist/migrations/index.js +5 -1
  73. package/dist/migrations/index.js.map +1 -1
  74. package/docs/catalog/attributes.md +9 -2
  75. package/docs/catalog/category-content.md +81 -0
  76. package/docs/catalog.md +50 -4
  77. package/i18n/en.json +16 -0
  78. package/i18n/pl.json +16 -0
  79. package/package.json +9 -9
@@ -0,0 +1,29 @@
1
+ import { Migration } from '@mikro-orm/migrations';
2
+ /**
3
+ * Adds `product_attributes.is_price_rule` — whether the attribute may be used
4
+ * as a price-building rule in a Price List.
5
+ *
6
+ * Default `false`, NOT NULL, and the default is the whole backfill: at the
7
+ * time this lands no Price List rule can reference an attribute (the
8
+ * application-rule vocabulary is sales channel / customer group /
9
+ * organization / category / currency), so there is no existing rule whose
10
+ * attribute would have to be switched on to keep working.
11
+ *
12
+ * The flag is owned by `catalog`, like its sibling `is_promo_rule`: a property
13
+ * of the attribute. A pricing consumer reads it through
14
+ * `catalogAttributeReadPort` and never writes it.
15
+ *
16
+ * Side effects on flip: none — it is read live from Postgres.
17
+ */
18
+ export class Migration20261008T080839CatalogProductAttributeIsPriceRule extends Migration {
19
+ async up() {
20
+ this.addSql(`
21
+ alter table "product_attributes"
22
+ add column "is_price_rule" boolean not null default false;
23
+ `);
24
+ }
25
+ async down() {
26
+ this.addSql('alter table "product_attributes" drop column if exists "is_price_rule";');
27
+ }
28
+ }
29
+ //# sourceMappingURL=20261008T080839_catalog_product_attribute_is_price_rule.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"20261008T080839_catalog_product_attribute_is_price_rule.js","sourceRoot":"","sources":["../../src/migrations/20261008T080839_catalog_product_attribute_is_price_rule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,0DAA2D,SAAQ,SAAS;IAC9E,KAAK,CAAC,EAAE;QACf,IAAI,CAAC,MAAM,CAAC;;;KAGX,CAAC,CAAC;IACL,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,IAAI,CAAC,MAAM,CAAC,yEAAyE,CAAC,CAAC;IACzF,CAAC;CACF"}
@@ -0,0 +1,21 @@
1
+ import { Migration } from '@mikro-orm/migrations';
2
+ /**
3
+ * Category page content — the Page Builder document an operator authors for a
4
+ * category's storefront page, one per language:
5
+ * `{ "languages": { "<code>": <document> } }`, the envelope a CMS page and a
6
+ * blog category description use.
7
+ *
8
+ * Nullable with no default: `null` is "no content authored", which is every
9
+ * category that exists when this runs, and the storefront renders nothing for
10
+ * it. `jsonb` rather than `json` so a later reference lookup (which library
11
+ * asset does a document embed) can use `jsonb_path_exists`, as the CMS and blog
12
+ * columns do.
13
+ *
14
+ * No index: the column is read by primary key only — one category's page, one
15
+ * category's editor.
16
+ */
17
+ export declare class Migration20261008T092714CatalogCategoryContent extends Migration {
18
+ up(): Promise<void>;
19
+ down(): Promise<void>;
20
+ }
21
+ //# sourceMappingURL=20261008T092714_catalog_category_content.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"20261008T092714_catalog_category_content.d.ts","sourceRoot":"","sources":["../../src/migrations/20261008T092714_catalog_category_content.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,8CAA+C,SAAQ,SAAS;IAC5D,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC;IAInB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAGrC"}
@@ -0,0 +1,25 @@
1
+ import { Migration } from '@mikro-orm/migrations';
2
+ /**
3
+ * Category page content — the Page Builder document an operator authors for a
4
+ * category's storefront page, one per language:
5
+ * `{ "languages": { "<code>": <document> } }`, the envelope a CMS page and a
6
+ * blog category description use.
7
+ *
8
+ * Nullable with no default: `null` is "no content authored", which is every
9
+ * category that exists when this runs, and the storefront renders nothing for
10
+ * it. `jsonb` rather than `json` so a later reference lookup (which library
11
+ * asset does a document embed) can use `jsonb_path_exists`, as the CMS and blog
12
+ * columns do.
13
+ *
14
+ * No index: the column is read by primary key only — one category's page, one
15
+ * category's editor.
16
+ */
17
+ export class Migration20261008T092714CatalogCategoryContent extends Migration {
18
+ async up() {
19
+ this.addSql(`alter table "categories" add column "content" jsonb null;`);
20
+ }
21
+ async down() {
22
+ this.addSql(`alter table "categories" drop column "content";`);
23
+ }
24
+ }
25
+ //# sourceMappingURL=20261008T092714_catalog_category_content.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"20261008T092714_catalog_category_content.js","sourceRoot":"","sources":["../../src/migrations/20261008T092714_catalog_category_content.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,8CAA+C,SAAQ,SAAS;IAClE,KAAK,CAAC,EAAE;QACf,IAAI,CAAC,MAAM,CAAC,2DAA2D,CAAC,CAAC;IAC3E,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,IAAI,CAAC,MAAM,CAAC,iDAAiD,CAAC,CAAC;IACjE,CAAC;CACF"}
@@ -50,6 +50,8 @@ import { Migration20260804T160244CatalogCategoryActivation } from './20260804T16
50
50
  import { Migration20260912T094557CatalogSalesChannelProducts } from './20260912T094557_catalog_sales_channel_products.js';
51
51
  import { Migration20260912T094623CatalogSalesChannelCategories } from './20260912T094623_catalog_sales_channel_categories.js';
52
52
  import { Migration20260925T125527CatalogInventoryColumns } from './20260925T125527_catalog_inventory_columns.js';
53
+ import { Migration20261008T080839CatalogProductAttributeIsPriceRule } from './20261008T080839_catalog_product_attribute_is_price_rule.js';
54
+ import { Migration20261008T092714CatalogCategoryContent } from './20261008T092714_catalog_category_content.js';
53
55
  export declare const migrations: (typeof Migration20260429T070004CatalogProductAttributeExtensions)[];
54
- 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, };
56
+ 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, };
55
57
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,gDAAgD,EAAE,MAAM,kDAAkD,CAAC;AACpH,OAAO,EAAE,yDAAyD,EAAE,MAAM,2DAA2D,CAAC;AACtI,OAAO,EAAE,0DAA0D,EAAE,MAAM,8DAA8D,CAAC;AAC1I,OAAO,EAAE,oDAAoD,EAAE,MAAM,uDAAuD,CAAC;AAC7H,OAAO,EAAE,iDAAiD,EAAE,MAAM,kDAAkD,CAAC;AACrH,OAAO,EAAE,2CAA2C,EAAE,MAAM,4CAA4C,CAAC;AACzG,OAAO,EAAE,+CAA+C,EAAE,MAAM,iDAAiD,CAAC;AAClH,OAAO,EAAE,2DAA2D,EAAE,MAAM,8DAA8D,CAAC;AAC3I,OAAO,EAAE,uDAAuD,EAAE,MAAM,0DAA0D,CAAC;AACnI,OAAO,EAAE,oDAAoD,EAAE,MAAM,sDAAsD,CAAC;AAC5H,OAAO,EAAE,oDAAoD,EAAE,MAAM,sDAAsD,CAAC;AAC5H,OAAO,EAAE,wDAAwD,EAAE,MAAM,2DAA2D,CAAC;AACrI,OAAO,EAAE,uDAAuD,EAAE,MAAM,yDAAyD,CAAC;AAClI,OAAO,EAAE,6CAA6C,EAAE,MAAM,8CAA8C,CAAC;AAC7G,OAAO,EAAE,gDAAgD,EAAE,MAAM,kDAAkD,CAAC;AACpH,OAAO,EAAE,oDAAoD,EAAE,MAAM,sDAAsD,CAAC;AAC5H,OAAO,EAAE,uDAAuD,EAAE,MAAM,0DAA0D,CAAC;AACnI,OAAO,EAAE,wDAAwD,EAAE,MAAM,2DAA2D,CAAC;AACrI,OAAO,EAAE,uDAAuD,EAAE,MAAM,0DAA0D,CAAC;AACnI,OAAO,EAAE,8CAA8C,EAAE,MAAM,gDAAgD,CAAC;AAChH,OAAO,EAAE,iDAAiD,EAAE,MAAM,kDAAkD,CAAC;AACrH,OAAO,EAAE,mDAAmD,EAAE,MAAM,qDAAqD,CAAC;AAC1H,OAAO,EAAE,qDAAqD,EAAE,MAAM,uDAAuD,CAAC;AAC9H,OAAO,EAAE,+CAA+C,EAAE,MAAM,gDAAgD,CAAC;AAEjH,eAAO,MAAM,UAAU,sEAyBtB,CAAC;AAEF,OAAO,EACL,gDAAgD,EAChD,yDAAyD,EACzD,0DAA0D,EAC1D,oDAAoD,EACpD,iDAAiD,EACjD,2CAA2C,EAC3C,+CAA+C,EAC/C,2DAA2D,EAC3D,uDAAuD,EACvD,oDAAoD,EACpD,oDAAoD,EACpD,wDAAwD,EACxD,uDAAuD,EACvD,6CAA6C,EAC7C,gDAAgD,EAChD,oDAAoD,EACpD,uDAAuD,EACvD,wDAAwD,EACxD,uDAAuD,EACvD,8CAA8C,EAC9C,iDAAiD,EACjD,mDAAmD,EACnD,qDAAqD,EACrD,+CAA+C,GAChD,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,gDAAgD,EAAE,MAAM,kDAAkD,CAAC;AACpH,OAAO,EAAE,yDAAyD,EAAE,MAAM,2DAA2D,CAAC;AACtI,OAAO,EAAE,0DAA0D,EAAE,MAAM,8DAA8D,CAAC;AAC1I,OAAO,EAAE,oDAAoD,EAAE,MAAM,uDAAuD,CAAC;AAC7H,OAAO,EAAE,iDAAiD,EAAE,MAAM,kDAAkD,CAAC;AACrH,OAAO,EAAE,2CAA2C,EAAE,MAAM,4CAA4C,CAAC;AACzG,OAAO,EAAE,+CAA+C,EAAE,MAAM,iDAAiD,CAAC;AAClH,OAAO,EAAE,2DAA2D,EAAE,MAAM,8DAA8D,CAAC;AAC3I,OAAO,EAAE,uDAAuD,EAAE,MAAM,0DAA0D,CAAC;AACnI,OAAO,EAAE,oDAAoD,EAAE,MAAM,sDAAsD,CAAC;AAC5H,OAAO,EAAE,oDAAoD,EAAE,MAAM,sDAAsD,CAAC;AAC5H,OAAO,EAAE,wDAAwD,EAAE,MAAM,2DAA2D,CAAC;AACrI,OAAO,EAAE,uDAAuD,EAAE,MAAM,yDAAyD,CAAC;AAClI,OAAO,EAAE,6CAA6C,EAAE,MAAM,8CAA8C,CAAC;AAC7G,OAAO,EAAE,gDAAgD,EAAE,MAAM,kDAAkD,CAAC;AACpH,OAAO,EAAE,oDAAoD,EAAE,MAAM,sDAAsD,CAAC;AAC5H,OAAO,EAAE,uDAAuD,EAAE,MAAM,0DAA0D,CAAC;AACnI,OAAO,EAAE,wDAAwD,EAAE,MAAM,2DAA2D,CAAC;AACrI,OAAO,EAAE,uDAAuD,EAAE,MAAM,0DAA0D,CAAC;AACnI,OAAO,EAAE,8CAA8C,EAAE,MAAM,gDAAgD,CAAC;AAChH,OAAO,EAAE,iDAAiD,EAAE,MAAM,kDAAkD,CAAC;AACrH,OAAO,EAAE,mDAAmD,EAAE,MAAM,qDAAqD,CAAC;AAC1H,OAAO,EAAE,qDAAqD,EAAE,MAAM,uDAAuD,CAAC;AAC9H,OAAO,EAAE,+CAA+C,EAAE,MAAM,gDAAgD,CAAC;AACjH,OAAO,EAAE,0DAA0D,EAAE,MAAM,8DAA8D,CAAC;AAC1I,OAAO,EAAE,8CAA8C,EAAE,MAAM,+CAA+C,CAAC;AAE/G,eAAO,MAAM,UAAU,sEA2BtB,CAAC;AAEF,OAAO,EACL,gDAAgD,EAChD,yDAAyD,EACzD,0DAA0D,EAC1D,oDAAoD,EACpD,iDAAiD,EACjD,2CAA2C,EAC3C,+CAA+C,EAC/C,2DAA2D,EAC3D,uDAAuD,EACvD,oDAAoD,EACpD,oDAAoD,EACpD,wDAAwD,EACxD,uDAAuD,EACvD,6CAA6C,EAC7C,gDAAgD,EAChD,oDAAoD,EACpD,uDAAuD,EACvD,wDAAwD,EACxD,uDAAuD,EACvD,8CAA8C,EAC9C,iDAAiD,EACjD,mDAAmD,EACnD,qDAAqD,EACrD,+CAA+C,EAC/C,0DAA0D,EAC1D,8CAA8C,GAC/C,CAAC"}
@@ -50,6 +50,8 @@ import { Migration20260804T160244CatalogCategoryActivation } from './20260804T16
50
50
  import { Migration20260912T094557CatalogSalesChannelProducts } from './20260912T094557_catalog_sales_channel_products.js';
51
51
  import { Migration20260912T094623CatalogSalesChannelCategories } from './20260912T094623_catalog_sales_channel_categories.js';
52
52
  import { Migration20260925T125527CatalogInventoryColumns } from './20260925T125527_catalog_inventory_columns.js';
53
+ import { Migration20261008T080839CatalogProductAttributeIsPriceRule } from './20261008T080839_catalog_product_attribute_is_price_rule.js';
54
+ import { Migration20261008T092714CatalogCategoryContent } from './20261008T092714_catalog_category_content.js';
53
55
  export const migrations = [
54
56
  Migration20260429T064146CatalogAttributeSetsInit,
55
57
  Migration20260429T070004CatalogProductAttributeExtensions,
@@ -75,6 +77,8 @@ export const migrations = [
75
77
  Migration20260912T094557CatalogSalesChannelProducts,
76
78
  Migration20260912T094623CatalogSalesChannelCategories,
77
79
  Migration20260925T125527CatalogInventoryColumns,
80
+ Migration20261008T080839CatalogProductAttributeIsPriceRule,
81
+ Migration20261008T092714CatalogCategoryContent,
78
82
  ];
79
- 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, };
83
+ 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, };
80
84
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,gDAAgD,EAAE,MAAM,kDAAkD,CAAC;AACpH,OAAO,EAAE,yDAAyD,EAAE,MAAM,2DAA2D,CAAC;AACtI,OAAO,EAAE,0DAA0D,EAAE,MAAM,8DAA8D,CAAC;AAC1I,OAAO,EAAE,oDAAoD,EAAE,MAAM,uDAAuD,CAAC;AAC7H,OAAO,EAAE,iDAAiD,EAAE,MAAM,kDAAkD,CAAC;AACrH,OAAO,EAAE,2CAA2C,EAAE,MAAM,4CAA4C,CAAC;AACzG,OAAO,EAAE,+CAA+C,EAAE,MAAM,iDAAiD,CAAC;AAClH,OAAO,EAAE,2DAA2D,EAAE,MAAM,8DAA8D,CAAC;AAC3I,OAAO,EAAE,uDAAuD,EAAE,MAAM,0DAA0D,CAAC;AACnI,OAAO,EAAE,oDAAoD,EAAE,MAAM,sDAAsD,CAAC;AAC5H,OAAO,EAAE,oDAAoD,EAAE,MAAM,sDAAsD,CAAC;AAC5H,OAAO,EAAE,wDAAwD,EAAE,MAAM,2DAA2D,CAAC;AACrI,OAAO,EAAE,uDAAuD,EAAE,MAAM,yDAAyD,CAAC;AAClI,OAAO,EAAE,6CAA6C,EAAE,MAAM,8CAA8C,CAAC;AAC7G,OAAO,EAAE,gDAAgD,EAAE,MAAM,kDAAkD,CAAC;AACpH,OAAO,EAAE,oDAAoD,EAAE,MAAM,sDAAsD,CAAC;AAC5H,OAAO,EAAE,uDAAuD,EAAE,MAAM,0DAA0D,CAAC;AACnI,OAAO,EAAE,wDAAwD,EAAE,MAAM,2DAA2D,CAAC;AACrI,OAAO,EAAE,uDAAuD,EAAE,MAAM,0DAA0D,CAAC;AACnI,OAAO,EAAE,8CAA8C,EAAE,MAAM,gDAAgD,CAAC;AAChH,OAAO,EAAE,iDAAiD,EAAE,MAAM,kDAAkD,CAAC;AACrH,OAAO,EAAE,mDAAmD,EAAE,MAAM,qDAAqD,CAAC;AAC1H,OAAO,EAAE,qDAAqD,EAAE,MAAM,uDAAuD,CAAC;AAC9H,OAAO,EAAE,+CAA+C,EAAE,MAAM,gDAAgD,CAAC;AAEjH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,gDAAgD;IAChD,yDAAyD;IACzD,0DAA0D;IAC1D,oDAAoD;IACpD,iDAAiD;IACjD,2CAA2C;IAC3C,+CAA+C;IAC/C,2DAA2D;IAC3D,uDAAuD;IACvD,oDAAoD;IACpD,oDAAoD;IACpD,wDAAwD;IACxD,uDAAuD;IACvD,6CAA6C;IAC7C,gDAAgD;IAChD,oDAAoD;IACpD,uDAAuD;IACvD,wDAAwD;IACxD,uDAAuD;IACvD,8CAA8C;IAC9C,iDAAiD;IACjD,mDAAmD;IACnD,qDAAqD;IACrD,+CAA+C;CAChD,CAAC;AAEF,OAAO,EACL,gDAAgD,EAChD,yDAAyD,EACzD,0DAA0D,EAC1D,oDAAoD,EACpD,iDAAiD,EACjD,2CAA2C,EAC3C,+CAA+C,EAC/C,2DAA2D,EAC3D,uDAAuD,EACvD,oDAAoD,EACpD,oDAAoD,EACpD,wDAAwD,EACxD,uDAAuD,EACvD,6CAA6C,EAC7C,gDAAgD,EAChD,oDAAoD,EACpD,uDAAuD,EACvD,wDAAwD,EACxD,uDAAuD,EACvD,8CAA8C,EAC9C,iDAAiD,EACjD,mDAAmD,EACnD,qDAAqD,EACrD,+CAA+C,GAChD,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,gDAAgD,EAAE,MAAM,kDAAkD,CAAC;AACpH,OAAO,EAAE,yDAAyD,EAAE,MAAM,2DAA2D,CAAC;AACtI,OAAO,EAAE,0DAA0D,EAAE,MAAM,8DAA8D,CAAC;AAC1I,OAAO,EAAE,oDAAoD,EAAE,MAAM,uDAAuD,CAAC;AAC7H,OAAO,EAAE,iDAAiD,EAAE,MAAM,kDAAkD,CAAC;AACrH,OAAO,EAAE,2CAA2C,EAAE,MAAM,4CAA4C,CAAC;AACzG,OAAO,EAAE,+CAA+C,EAAE,MAAM,iDAAiD,CAAC;AAClH,OAAO,EAAE,2DAA2D,EAAE,MAAM,8DAA8D,CAAC;AAC3I,OAAO,EAAE,uDAAuD,EAAE,MAAM,0DAA0D,CAAC;AACnI,OAAO,EAAE,oDAAoD,EAAE,MAAM,sDAAsD,CAAC;AAC5H,OAAO,EAAE,oDAAoD,EAAE,MAAM,sDAAsD,CAAC;AAC5H,OAAO,EAAE,wDAAwD,EAAE,MAAM,2DAA2D,CAAC;AACrI,OAAO,EAAE,uDAAuD,EAAE,MAAM,yDAAyD,CAAC;AAClI,OAAO,EAAE,6CAA6C,EAAE,MAAM,8CAA8C,CAAC;AAC7G,OAAO,EAAE,gDAAgD,EAAE,MAAM,kDAAkD,CAAC;AACpH,OAAO,EAAE,oDAAoD,EAAE,MAAM,sDAAsD,CAAC;AAC5H,OAAO,EAAE,uDAAuD,EAAE,MAAM,0DAA0D,CAAC;AACnI,OAAO,EAAE,wDAAwD,EAAE,MAAM,2DAA2D,CAAC;AACrI,OAAO,EAAE,uDAAuD,EAAE,MAAM,0DAA0D,CAAC;AACnI,OAAO,EAAE,8CAA8C,EAAE,MAAM,gDAAgD,CAAC;AAChH,OAAO,EAAE,iDAAiD,EAAE,MAAM,kDAAkD,CAAC;AACrH,OAAO,EAAE,mDAAmD,EAAE,MAAM,qDAAqD,CAAC;AAC1H,OAAO,EAAE,qDAAqD,EAAE,MAAM,uDAAuD,CAAC;AAC9H,OAAO,EAAE,+CAA+C,EAAE,MAAM,gDAAgD,CAAC;AACjH,OAAO,EAAE,0DAA0D,EAAE,MAAM,8DAA8D,CAAC;AAC1I,OAAO,EAAE,8CAA8C,EAAE,MAAM,+CAA+C,CAAC;AAE/G,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,gDAAgD;IAChD,yDAAyD;IACzD,0DAA0D;IAC1D,oDAAoD;IACpD,iDAAiD;IACjD,2CAA2C;IAC3C,+CAA+C;IAC/C,2DAA2D;IAC3D,uDAAuD;IACvD,oDAAoD;IACpD,oDAAoD;IACpD,wDAAwD;IACxD,uDAAuD;IACvD,6CAA6C;IAC7C,gDAAgD;IAChD,oDAAoD;IACpD,uDAAuD;IACvD,wDAAwD;IACxD,uDAAuD;IACvD,8CAA8C;IAC9C,iDAAiD;IACjD,mDAAmD;IACnD,qDAAqD;IACrD,+CAA+C;IAC/C,0DAA0D;IAC1D,8CAA8C;CAC/C,CAAC;AAEF,OAAO,EACL,gDAAgD,EAChD,yDAAyD,EACzD,0DAA0D,EAC1D,oDAAoD,EACpD,iDAAiD,EACjD,2CAA2C,EAC3C,+CAA+C,EAC/C,2DAA2D,EAC3D,uDAAuD,EACvD,oDAAoD,EACpD,oDAAoD,EACpD,wDAAwD,EACxD,uDAAuD,EACvD,6CAA6C,EAC7C,gDAAgD,EAChD,oDAAoD,EACpD,uDAAuD,EACvD,wDAAwD,EACxD,uDAAuD,EACvD,8CAA8C,EAC9C,iDAAiD,EACjD,mDAAmD,EACnD,qDAAqD,EACrD,+CAA+C,EAC/C,0DAA0D,EAC1D,8CAA8C,GAC/C,CAAC"}
@@ -38,6 +38,7 @@ Plus the behavioural flags and a numeric position:
38
38
  | `isVariantAxis` | `false` | Configurable-product variant picker |
39
39
  | `isRequired` | `false` | Product-save validator (only when the attribute is in the assigned Attribute Set) |
40
40
  | `isPromoRule` | `false` | Promotion Rule criterion picker |
41
+ | `isPriceRule` | `false` | Price Lists — whether the attribute may be used as a price-building rule. Price Lists have no attribute-based rule yet, so today the flag is recorded and published, and nothing prices from it. |
41
42
  | `isVisibleOnProductPage` | `false` | PDP "Parametry produktu" tab |
42
43
  | `displayAsSlider` | `false` | Storefront sidebar — renders a range slider; only valid for `valueType ∈ ('number','price')` |
43
44
  | `filterPosition` | `0` | Storefront sidebar sort key (ascending; ties broken alphabetically by the resolved label) |
@@ -87,7 +88,7 @@ Admin routes are gated by `catalog:read` (list / get) /
87
88
  | `GET /api/v1/admin/catalog/attributes/by-flag?flag=isPromoRule\|isComparable\|...` | admin | Picker payload — every attribute carrying the requested flag |
88
89
  | `GET /api/v1/admin/catalog/attributes/:idOrKey` | admin | Single attribute read |
89
90
  | `POST /api/v1/admin/catalog/attributes` | admin | Create attribute (accepts the flags + inline `options[]` for select-style types) |
90
- | `PATCH /api/v1/admin/catalog/attributes/:key` | admin | Update labels and hot-toggle `isFilterable` / `isSearchable` / `isVariantAxis` / `isPromoRule` / `isComparable` / `isVisibleOnProductPage` / `isRequired` / `filterPosition`. Re-emits `attribute.updated.v1`. |
91
+ | `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`. |
91
92
  | `DELETE /api/v1/admin/catalog/attributes/:idOrKey` | admin | Delete; refused with `409 attribute_in_use_by_set` while any Attribute Set still references it |
92
93
  | `GET /api/v1/admin/catalog/attributes/:idOrKey/options` | admin | List option rows for select / enum / multiselect attributes |
93
94
  | `POST /api/v1/admin/catalog/attributes/:idOrKey/options` | admin | Append an option |
@@ -188,7 +189,7 @@ admin surface composes the two back into the legacy form.
188
189
  `custom_field_definitions.id` ON DELETE RESTRICT.
189
190
  - Boolean flags: `is_searchable`, `is_filterable`, `is_variant_axis`,
190
191
  `is_comparable`, `quick_searchable`, `is_promo_rule`,
191
- `is_visible_on_product_page`, `display_as_slider`,
192
+ `is_price_rule`, `is_visible_on_product_page`, `display_as_slider`,
192
193
  `channel_scoped`, `language_scoped`, `mass_editable`.
193
194
  - `filter_position int NOT NULL DEFAULT 0`.
194
195
  - Presentation refinements: `select_display varchar(16) NULL`
@@ -233,6 +234,12 @@ internals:
233
234
  - `buildVisibleAttributesProjection()` — internal, used by the PDP
234
235
  detail response to assemble the `visibleAttributes[]` payload.
235
236
 
237
+ `isPriceRule` has no method of its own. A pricing consumer reads it
238
+ through the `catalogAttributeReadPort` — `listByFlag('isPriceRule')`
239
+ for the attributes a price rule may name, and `isPriceRule` on every
240
+ attribute view to refuse one that may not — and the admin picker
241
+ payload is `GET /api/v1/admin/catalog/attributes/by-flag?flag=isPriceRule`.
242
+
236
243
  ## See also
237
244
 
238
245
  - [Attribute Sets](./attribute-sets.md) — bundling attributes into
@@ -0,0 +1,81 @@
1
+ ---
2
+ title: Category page content
3
+ ---
4
+
5
+ # Category page content
6
+
7
+ Content an operator authors for one category's storefront page — an
8
+ introduction, a banner, a buying guide — rendered above the product grid. It is
9
+ a Page Builder document, so anything the Page Builder offers can go into it,
10
+ including formatted text written in its rich-text block.
11
+
12
+ ## For operators
13
+
14
+ Open **Catalog → Categories** and choose **Content** on the category's row. The
15
+ content screen has:
16
+
17
+ - a **language** switch — content is kept per language, like the category's
18
+ name. Each language has its own document, and a language you leave empty
19
+ shows the content of another one rather than nothing;
20
+ - the **Page Builder** canvas for the selected language;
21
+ - **Save content** — one save stores every language you edited.
22
+
23
+ The storefront shows a saved change on the next visit to the category page.
24
+
25
+ To remove the content, delete every block from the document and save. A
26
+ category with no content shows its product listing exactly as before.
27
+
28
+ The **Content** action appears only while a module that provides a Page Builder
29
+ (the CMS module) is enabled and you have access to it. Content that is already
30
+ stored is kept while that module is off.
31
+
32
+ ## On the storefront
33
+
34
+ The category page renders the content between the category heading and the
35
+ listing toolbar, on the **first page** of the listing only — a visitor paging
36
+ through products is not shown the introduction again above every page.
37
+
38
+ The document is resolved to one language in this order: the visitor's language,
39
+ the sales channel's default language, English, then any language that has
40
+ content. A language whose document holds no block is skipped.
41
+
42
+ The content follows the category's visibility: an inactive category, or one
43
+ under an inactive parent, has no page and its content is not served.
44
+
45
+ The blocks are drawn by the storefront's Page Builder renderer — the one that
46
+ draws CMS pages — so HTML an operator typed is sanitised the same way, and a
47
+ block that belongs to a switched-off module is not drawn.
48
+
49
+ ## For integrators
50
+
51
+ | Verb + Path | Audience | Purpose |
52
+ | --- | --- | --- |
53
+ | `GET /api/v1/catalog/categories/:id/content` | storefront | The document resolved to the caller's `Accept-Language`: `{ categoryId, language, content }`. `content` is `null` when nothing is authored. `404` for a category the category tree does not list |
54
+ | `GET /api/v1/admin/catalog/categories/:id/content` | admin (`catalog:read`) | The whole envelope: `{ categoryId, content }` with `content` = `{ languages: { "<code>": <document> } }` or `null` |
55
+ | `PUT /api/v1/admin/catalog/categories/:id/content` | admin (`catalog:write`) | Replaces the envelope. `{ "content": null }` clears it |
56
+
57
+ The envelope is the one a CMS page uses and is limited to 1 MiB of JSON across
58
+ all languages. Each document is stored as the Page Builder wrote it and is
59
+ opaque to this module.
60
+
61
+ The category list (`GET /api/v1/admin/catalog/categories`) and the category
62
+ tree do **not** carry the content, and neither does the search index, a product
63
+ feed, or an import or export.
64
+
65
+ Saving runs the `category.content.update` command — the audit entry records
66
+ which languages the envelope carried, not the documents — and emits
67
+ `category.content.updated.v1`, on which the storefront's category cache is
68
+ flushed. It does not emit `category.updated.v1`, so a content save does not
69
+ re-index the category's products.
70
+
71
+ The schemas are `categoryContentEnvelopeSchema`,
72
+ `putCategoryContentRequestSchema`, `adminCategoryContentSchema` and
73
+ `categoryPageContentSchema` in `@endora-commerce/contracts`.
74
+
75
+ ## Providing an editor
76
+
77
+ The content screen owns the document and no editor: it renders the admin zone
78
+ `category.content.editor` and saves what the zone reports. A module that owns a
79
+ Page Builder contributes a component there; its props are
80
+ `{ categoryId, language, data, onChange }`, where `data` is the document to
81
+ open and `onChange` reports every edit. The contributor never saves.
package/docs/catalog.md CHANGED
@@ -20,6 +20,7 @@ Admin routes are gated by `catalog:read` (list / get) /
20
20
  | `GET /api/v1/catalog/products` | storefront / API key | List/search/filter products in the active Sales Channel |
21
21
  | `GET /api/v1/catalog/products/:idOrSlug` | storefront | Product detail (price omitted on non-public Sales Channels) |
22
22
  | `GET /api/v1/catalog/categories` | storefront | Nested category tree |
23
+ | `GET /api/v1/catalog/categories/:id/content` | storefront | One category's page content, resolved to the caller's language |
23
24
  | `GET /api/v1/catalog/filters` | storefront | Filterable attributes for the active Sales Channel |
24
25
  | `GET /api/v1/catalog/sitemap.xml` | crawlers | SEO sitemap |
25
26
  | `GET /api/v1/admin/catalog/products?includeArchived` | admin | Admin product list (includes drafts; archived rows opt-in) |
@@ -31,7 +32,7 @@ Admin routes are gated by `catalog:read` (list / get) /
31
32
  | `GET /api/v1/admin/catalog/attributes/by-flag?flag=isPromoRule\|isComparable\|...` | admin | Picker payload — every attribute carrying the requested flag |
32
33
  | `GET /api/v1/admin/catalog/attributes/:idOrKey` | admin | Single attribute read |
33
34
  | `POST /api/v1/admin/catalog/attributes` | admin | Create attribute (accepts the new flags + inline `options[]` for select-style types) |
34
- | `PATCH /api/v1/admin/catalog/attributes/:key` | admin | Hot-toggle `isFilterable` / `isSearchable` / `isVariantAxis` / `isPromoRule` / `isComparable` / `isVisibleOnProductPage` / `isRequired` / `filterPosition` (re-emits `attribute.updated.v1`) |
35
+ | `PATCH /api/v1/admin/catalog/attributes/:key` | admin | Hot-toggle `isFilterable` / `isSearchable` / `isVariantAxis` / `isPromoRule` / `isPriceRule` / `isComparable` / `isVisibleOnProductPage` / `isRequired` / `filterPosition` (re-emits `attribute.updated.v1`) |
35
36
  | `DELETE /api/v1/admin/catalog/attributes/:idOrKey` | admin | Delete; refused with `409 attribute_in_use_by_set` while any Attribute Set still references it |
36
37
  | `GET /api/v1/admin/catalog/attributes/:idOrKey/options` | admin | List option-list rows for select/enum/multiselect attributes |
37
38
  | `POST /api/v1/admin/catalog/attributes/:idOrKey/options` | admin | Append an option |
@@ -42,6 +43,8 @@ Admin routes are gated by `catalog:read` (list / get) /
42
43
  | `POST /api/v1/admin/catalog/categories` | admin | Create (parent must exist) |
43
44
  | `PATCH /api/v1/admin/catalog/categories/:id` | admin | Update; reparenting walks the new parent's chain to refuse cycles (409) |
44
45
  | `DELETE /api/v1/admin/catalog/categories/:id` | admin | Soft-delete; rejects with 409 if any active child still references the row |
46
+ | `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)) |
47
+ | `PUT /api/v1/admin/catalog/categories/:id/content` | admin | Replace the category's page content; `null` clears it |
45
48
  | `PUT /api/v1/catalog/products/by-sku/:sku` | API key | Idempotent upsert (PIM sync) |
46
49
 
47
50
  ## Entities
@@ -53,8 +56,51 @@ Admin routes are gated by `catalog:read` (list / get) /
53
56
  ## Events emitted
54
57
 
55
58
  `product.created.v1`, `product.updated.v1`, `product.archived.v1`,
56
- `attribute.updated.v1`. Picked up by the search indexer and bridged to
57
- webhook subscribers.
59
+ `attribute.updated.v1`. Picked up by the search indexer. The three product
60
+ events are also offered to outbound webhooks (next section);
61
+ `attribute.updated.v1` is not.
62
+
63
+ `category.updated.v1` and `category.content.updated.v1` both flush the
64
+ storefront's category cache; the first also re-indexes the products of the
65
+ changed category's subtree.
66
+
67
+ ## Events offered to outbound webhooks
68
+
69
+ The module contributes three event types to the `webhooks` module's
70
+ `webhookEventRegistry`, so a webhook subscription can name them while both
71
+ modules are present. The payload is sent whole; the strict schemas are
72
+ `CATALOG_WEBHOOK_EVENT_SCHEMAS` in `@endora-commerce/contracts`.
73
+
74
+ | Event | Sent when | Payload, beside `eventId` and `occurredAt` |
75
+ | --- | --- | --- |
76
+ | `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. |
77
+ | `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 addressed (`name`, `status`, `categoryIds`, …; `variants` for a variant write). Names only, an open list, and it may be empty. |
78
+ | `product.archived.v1` | A product's status moves to `inactive` from another status. Once per transition: editing a product that is already inactive does not send it again. | `productId` |
79
+
80
+ - **Order.** The archiving write sends `product.updated.v1` (with `status` in
81
+ `changedFields`) and then `product.archived.v1`, on every path that can
82
+ archive a product: the Admin UI, the API-key upsert, a bulk edit, an import.
83
+ - **Reactivation has no event of its own.** A product that leaves `inactive`
84
+ sends `product.updated.v1` with `status` in `changedFields` and nothing else —
85
+ the same signal as any other status change, a draft being published
86
+ included. To tell them apart, read the product: its `status` is the answer.
87
+ - **Deletion is not delivered.** Deleting a product emits `product.deleted.v1`
88
+ on the in-process event bus only; it is not offered to webhooks, and no
89
+ `product.archived.v1` is sent for it. A receiver that mirrors the catalogue
90
+ learns of a deletion by reading: the product is no longer returned by the
91
+ API. Reconcile against a full listing if deletions matter to you.
92
+ - **After the commit.** Each event is sent for a write that was committed. A
93
+ write that is refused or rolled back sends nothing.
94
+ - **No content leaves.** No name, description, price, attribute value or
95
+ Organization allow-list is in any payload. A receiver reads the product
96
+ through the API with its own key.
97
+ - **Platform-wide subscriptions only.** A product is not one Organization's
98
+ data, so the payloads carry no `organizationId` and a subscription bound to
99
+ an Organization never receives a product event.
100
+ - **Volume.** One event per product written. A bulk edit, an import or a PIM
101
+ synchronisation writes products one by one and therefore sends one
102
+ `product.updated.v1` per product; nothing is batched. With no subscription
103
+ naming the type, nothing is enqueued.
58
104
 
59
105
  ## Extension points
60
106
 
@@ -170,7 +216,7 @@ and ownership model is different:
170
216
  row (`custom_field_definition_id` UNIQUE FK) carrying only the
171
217
  catalog behaviour flags (`isSearchable`, `isFilterable`,
172
218
  `isVariantAxis`, `displayAsSlider`, `isComparable`,
173
- `quickSearchable`, `isPromoRule`, `filterPosition`,
219
+ `quickSearchable`, `isPromoRule`, `isPriceRule`, `filterPosition`,
174
220
  `isVisibleOnProductPage`, `channelScoped`, `languageScoped`,
175
221
  `massEditable`) plus two presentation refinements (`selectDisplay`,
176
222
  `numericKind`) that keep the legacy `enum`/`select` and
package/i18n/en.json CHANGED
@@ -111,7 +111,9 @@
111
111
  "bulkOperations.outcome.failed": "Failed",
112
112
  "attributes.column.massEditable": "Mass-editable",
113
113
  "attributes.column.quickSearchable": "Quick-searchable",
114
+ "attributes.column.priceRule": "Price list rules",
114
115
  "attributes.column.promoRule": "Promotion rules",
116
+ "attributes.flag.priceRule": "Usable in price list rules (may be used as a price-building rule in a Price List)",
115
117
  "attributes.flag.promoRule": "Usable in promotion rules (offered in the Promotion Rule criterion picker)",
116
118
  "attributes.flag.massEditable": "Mass-editable (offered in the Products Bulk Edit dialog)",
117
119
  "attributesList.filter.massEditable": "Mass-editable only",
@@ -166,6 +168,20 @@
166
168
  "categories.mainImage.pick": "Pick",
167
169
  "categories.mainImage.change": "Change",
168
170
  "categories.mainImage.clear": "Clear main image",
171
+ "categories.action.content": "Content",
172
+ "categoryContent.page.title": "Page content — {name}",
173
+ "categoryContent.page.description": "What customers see above the product grid on this category's storefront page. One document per language.",
174
+ "categoryContent.action.back": "Back to categories",
175
+ "categoryContent.action.save": "Save content",
176
+ "categoryContent.action.saving": "Saving…",
177
+ "categoryContent.success.save": "Content saved. The storefront shows it on the next visit.",
178
+ "categoryContent.error.load": "Failed to load the category content.",
179
+ "categoryContent.error.save": "Failed to save the category content.",
180
+ "categoryContent.loading": "Loading…",
181
+ "categoryContent.editor.title": "Content [{language}]",
182
+ "categoryContent.noEditor.title": "No content editor is available",
183
+ "categoryContent.noEditor.description": "Category page content is authored in the Page Builder. Enable the module that provides it (CMS) under Platform → Modules, or ask for access to it. Content that is already stored is kept.",
184
+ "categoryContent.readOnly": "You can view this content but not change it.",
169
185
  "attributes.page.title": "Attributes",
170
186
  "attributes.page.description": "Searchable + filterable attributes drive Meilisearch and the storefront filter panel. Hot-toggle to see results within seconds.",
171
187
  "attributes.error.load": "Failed to load.",
package/i18n/pl.json CHANGED
@@ -111,7 +111,9 @@
111
111
  "bulkOperations.outcome.failed": "Niepowodzenie",
112
112
  "attributes.column.massEditable": "Edycja masowa",
113
113
  "attributes.column.quickSearchable": "Szybkie wyszukiwanie",
114
+ "attributes.column.priceRule": "Reguły cennika",
114
115
  "attributes.column.promoRule": "Reguły promocyjne",
116
+ "attributes.flag.priceRule": "Używany w regułach cennika (może służyć jako reguła budowania ceny w Cenniku)",
115
117
  "attributes.flag.promoRule": "Dostępny w regułach promocyjnych (w selektorze kryteriów Reguły Promocyjnej)",
116
118
  "attributes.flag.massEditable": "Włącz do okna „Edycja masowa” produktów",
117
119
  "attributesList.filter.massEditable": "Tylko masowo edytowalne",
@@ -166,6 +168,20 @@
166
168
  "categories.mainImage.pick": "Wybierz",
167
169
  "categories.mainImage.change": "Zmień",
168
170
  "categories.mainImage.clear": "Wyczyść obraz główny",
171
+ "categories.action.content": "Treść",
172
+ "categoryContent.page.title": "Treść strony — {name}",
173
+ "categoryContent.page.description": "To, co klienci widzą nad listą produktów na stronie tej kategorii w sklepie. Jeden dokument na język.",
174
+ "categoryContent.action.back": "Wróć do kategorii",
175
+ "categoryContent.action.save": "Zapisz treść",
176
+ "categoryContent.action.saving": "Zapisywanie…",
177
+ "categoryContent.success.save": "Treść zapisana. Sklep pokaże ją przy następnej wizycie.",
178
+ "categoryContent.error.load": "Nie udało się wczytać treści kategorii.",
179
+ "categoryContent.error.save": "Nie udało się zapisać treści kategorii.",
180
+ "categoryContent.loading": "Ładowanie…",
181
+ "categoryContent.editor.title": "Treść [{language}]",
182
+ "categoryContent.noEditor.title": "Edytor treści jest niedostępny",
183
+ "categoryContent.noEditor.description": "Treść strony kategorii tworzy się w kreatorze stron (Page Builder). Włącz moduł, który go dostarcza (CMS), w sekcji Platforma → Moduły albo poproś o dostęp do niego. Zapisana już treść pozostaje zachowana.",
184
+ "categoryContent.readOnly": "Możesz przeglądać tę treść, ale nie możesz jej zmieniać.",
169
185
  "attributes.page.title": "Atrybuty",
170
186
  "attributes.page.description": "Atrybuty z włączoną wyszukiwarką i filtrami napędzają Meilisearch oraz panel filtrów w sklepie. Przełącznik dla każdego atrybutu działa od ręki — efekty widać w ciągu sekund.",
171
187
  "attributes.error.load": "Nie udało się wczytać.",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@endora-commerce/mod-catalog",
3
- "version": "0.103.1",
3
+ "version": "0.105.0",
4
4
  "type": "module",
5
5
  "sideEffects": false,
6
6
  "description": "Products, variants, categories, attributes, attribute sets, gallery, attachments, links, and bundles.",
@@ -61,10 +61,10 @@
61
61
  "react": "^19",
62
62
  "react-router-dom": "^7",
63
63
  "zod": "^4",
64
- "@endora-commerce/admin-kit": "0.103.1",
65
- "@endora-commerce/contracts": "0.103.1",
66
- "@endora-commerce/mod-custom-fields": "0.103.1",
67
- "@endora-commerce/platform": "0.103.1"
64
+ "@endora-commerce/admin-kit": "0.105.0",
65
+ "@endora-commerce/mod-custom-fields": "0.105.0",
66
+ "@endora-commerce/contracts": "0.105.0",
67
+ "@endora-commerce/platform": "0.105.0"
68
68
  },
69
69
  "peerDependenciesMeta": {
70
70
  "@endora-commerce/admin-kit": {
@@ -95,10 +95,10 @@
95
95
  "typescript": "^5.9.3",
96
96
  "vitest": "^4.1.11",
97
97
  "zod": "^4.2.0",
98
- "@endora-commerce/admin-kit": "0.103.1",
99
- "@endora-commerce/contracts": "0.103.1",
100
- "@endora-commerce/mod-custom-fields": "0.103.1",
101
- "@endora-commerce/platform": "0.103.1"
98
+ "@endora-commerce/admin-kit": "0.105.0",
99
+ "@endora-commerce/contracts": "0.105.0",
100
+ "@endora-commerce/mod-custom-fields": "0.105.0",
101
+ "@endora-commerce/platform": "0.105.0"
102
102
  },
103
103
  "scripts": {
104
104
  "build": "tsc -p tsconfig.build.json && tsc -p tsconfig.ui.json",