@endora-commerce/mod-cms 0.107.0 → 0.109.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (227) hide show
  1. package/README.md +1 -0
  2. package/dist/admin/api/cms-client.d.ts +19 -3
  3. package/dist/admin/api/cms-client.d.ts.map +1 -1
  4. package/dist/admin/api/cms-client.js +23 -2
  5. package/dist/admin/api/cms-client.js.map +1 -1
  6. package/dist/admin/components/AdminCatalogPreviewProvider.d.ts.map +1 -1
  7. package/dist/admin/components/AdminCatalogPreviewProvider.js +51 -0
  8. package/dist/admin/components/AdminCatalogPreviewProvider.js.map +1 -1
  9. package/dist/admin/components/BackgroundFields.d.ts +16 -0
  10. package/dist/admin/components/BackgroundFields.d.ts.map +1 -1
  11. package/dist/admin/components/BackgroundFields.js +58 -11
  12. package/dist/admin/components/BackgroundFields.js.map +1 -1
  13. package/dist/admin/components/BrandFontFields.d.ts +17 -0
  14. package/dist/admin/components/BrandFontFields.d.ts.map +1 -0
  15. package/dist/admin/components/BrandFontFields.js +39 -0
  16. package/dist/admin/components/BrandFontFields.js.map +1 -0
  17. package/dist/admin/components/BrandPreview.d.ts +29 -0
  18. package/dist/admin/components/BrandPreview.d.ts.map +1 -0
  19. package/dist/admin/components/BrandPreview.js +130 -0
  20. package/dist/admin/components/BrandPreview.js.map +1 -0
  21. package/dist/admin/components/CarouselAddSlideMenu.d.ts +5 -0
  22. package/dist/admin/components/CarouselAddSlideMenu.d.ts.map +1 -0
  23. package/dist/admin/components/CarouselAddSlideMenu.js +84 -0
  24. package/dist/admin/components/CarouselAddSlideMenu.js.map +1 -0
  25. package/dist/admin/components/CarouselFields.d.ts +6 -0
  26. package/dist/admin/components/CarouselFields.d.ts.map +1 -0
  27. package/dist/admin/components/CarouselFields.js +55 -0
  28. package/dist/admin/components/CarouselFields.js.map +1 -0
  29. package/dist/admin/components/ContentSliderActionBarExtras.d.ts.map +1 -1
  30. package/dist/admin/components/ContentSliderActionBarExtras.js +13 -6
  31. package/dist/admin/components/ContentSliderActionBarExtras.js.map +1 -1
  32. package/dist/admin/components/HeroFields.d.ts +47 -0
  33. package/dist/admin/components/HeroFields.d.ts.map +1 -0
  34. package/dist/admin/components/HeroFields.js +92 -0
  35. package/dist/admin/components/HeroFields.js.map +1 -0
  36. package/dist/admin/components/ListingFields.d.ts +6 -0
  37. package/dist/admin/components/ListingFields.d.ts.map +1 -0
  38. package/dist/admin/components/ListingFields.js +54 -0
  39. package/dist/admin/components/ListingFields.js.map +1 -0
  40. package/dist/admin/components/NewsletterSignupFields.d.ts +18 -0
  41. package/dist/admin/components/NewsletterSignupFields.d.ts.map +1 -0
  42. package/dist/admin/components/NewsletterSignupFields.js +38 -0
  43. package/dist/admin/components/NewsletterSignupFields.js.map +1 -0
  44. package/dist/admin/components/PageBuilderActionBar.d.ts.map +1 -1
  45. package/dist/admin/components/PageBuilderActionBar.js +1 -6
  46. package/dist/admin/components/PageBuilderActionBar.js.map +1 -1
  47. package/dist/admin/components/PageBuilderEditor.d.ts +43 -2
  48. package/dist/admin/components/PageBuilderEditor.d.ts.map +1 -1
  49. package/dist/admin/components/PageBuilderEditor.js +207 -121
  50. package/dist/admin/components/PageBuilderEditor.js.map +1 -1
  51. package/dist/admin/components/PageNavigationFields.d.ts +6 -0
  52. package/dist/admin/components/PageNavigationFields.d.ts.map +1 -0
  53. package/dist/admin/components/PageNavigationFields.js +29 -0
  54. package/dist/admin/components/PageNavigationFields.js.map +1 -0
  55. package/dist/admin/components/PreviewBrandTokens.d.ts +25 -0
  56. package/dist/admin/components/PreviewBrandTokens.d.ts.map +1 -0
  57. package/dist/admin/components/PreviewBrandTokens.js +68 -0
  58. package/dist/admin/components/PreviewBrandTokens.js.map +1 -0
  59. package/dist/admin/components/SectionBlockFields.d.ts +44 -0
  60. package/dist/admin/components/SectionBlockFields.d.ts.map +1 -0
  61. package/dist/admin/components/SectionBlockFields.js +114 -0
  62. package/dist/admin/components/SectionBlockFields.js.map +1 -0
  63. package/dist/admin/components/SectionPresetsPanel.d.ts +11 -0
  64. package/dist/admin/components/SectionPresetsPanel.d.ts.map +1 -0
  65. package/dist/admin/components/SectionPresetsPanel.js +82 -0
  66. package/dist/admin/components/SectionPresetsPanel.js.map +1 -0
  67. package/dist/admin/components/SliderPreviewActionBarExtras.d.ts +1 -1
  68. package/dist/admin/components/SliderPreviewActionBarExtras.d.ts.map +1 -1
  69. package/dist/admin/components/SliderPreviewActionBarExtras.js +1 -5
  70. package/dist/admin/components/SliderPreviewActionBarExtras.js.map +1 -1
  71. package/dist/admin/components/admin-catalog-preview-map.d.ts +9 -0
  72. package/dist/admin/components/admin-catalog-preview-map.d.ts.map +1 -1
  73. package/dist/admin/components/admin-catalog-preview-map.js +10 -0
  74. package/dist/admin/components/admin-catalog-preview-map.js.map +1 -1
  75. package/dist/admin/components/page-builder-i18n.d.ts +24 -2
  76. package/dist/admin/components/page-builder-i18n.d.ts.map +1 -1
  77. package/dist/admin/components/page-builder-i18n.js +102 -9
  78. package/dist/admin/components/page-builder-i18n.js.map +1 -1
  79. package/dist/admin/editors/PageEditor.d.ts.map +1 -1
  80. package/dist/admin/editors/PageEditor.js +270 -38
  81. package/dist/admin/editors/PageEditor.js.map +1 -1
  82. package/dist/admin/index.d.ts +1 -1
  83. package/dist/admin/index.d.ts.map +1 -1
  84. package/dist/admin/index.js +21 -1
  85. package/dist/admin/index.js.map +1 -1
  86. package/dist/admin/pages/BrandPage.d.ts +19 -0
  87. package/dist/admin/pages/BrandPage.d.ts.map +1 -0
  88. package/dist/admin/pages/BrandPage.js +316 -0
  89. package/dist/admin/pages/BrandPage.js.map +1 -0
  90. package/dist/admin/pages/PagesListPage.d.ts.map +1 -1
  91. package/dist/admin/pages/PagesListPage.js +4 -1
  92. package/dist/admin/pages/PagesListPage.js.map +1 -1
  93. package/dist/backend/cli/block-names.d.ts +2 -1
  94. package/dist/backend/cli/block-names.d.ts.map +1 -1
  95. package/dist/backend/cli/block-names.js.map +1 -1
  96. package/dist/backend/entities/cms-brand-tokens.entity.d.ts +20 -0
  97. package/dist/backend/entities/cms-brand-tokens.entity.d.ts.map +1 -0
  98. package/dist/backend/entities/cms-brand-tokens.entity.js +57 -0
  99. package/dist/backend/entities/cms-brand-tokens.entity.js.map +1 -0
  100. package/dist/backend/entities/cms-page.entity.d.ts +32 -1
  101. package/dist/backend/entities/cms-page.entity.d.ts.map +1 -1
  102. package/dist/backend/entities/cms-page.entity.js +63 -0
  103. package/dist/backend/entities/cms-page.entity.js.map +1 -1
  104. package/dist/backend/index.d.ts +5 -1
  105. package/dist/backend/index.d.ts.map +1 -1
  106. package/dist/backend/index.js +78 -8
  107. package/dist/backend/index.js.map +1 -1
  108. package/dist/backend/plugin.d.ts +16 -2
  109. package/dist/backend/plugin.d.ts.map +1 -1
  110. package/dist/backend/plugin.js +20 -1
  111. package/dist/backend/plugin.js.map +1 -1
  112. package/dist/backend/routes.admin.d.ts +2 -0
  113. package/dist/backend/routes.admin.d.ts.map +1 -1
  114. package/dist/backend/routes.admin.js +39 -4
  115. package/dist/backend/routes.admin.js.map +1 -1
  116. package/dist/backend/routes.storefront.d.ts +24 -1
  117. package/dist/backend/routes.storefront.d.ts.map +1 -1
  118. package/dist/backend/routes.storefront.js +55 -2
  119. package/dist/backend/routes.storefront.js.map +1 -1
  120. package/dist/backend/services/anchor-guard.d.ts +10 -0
  121. package/dist/backend/services/anchor-guard.d.ts.map +1 -0
  122. package/dist/backend/services/anchor-guard.js +132 -0
  123. package/dist/backend/services/anchor-guard.js.map +1 -0
  124. package/dist/backend/services/asset-references.d.ts.map +1 -1
  125. package/dist/backend/services/asset-references.js +46 -30
  126. package/dist/backend/services/asset-references.js.map +1 -1
  127. package/dist/backend/services/brand-tokens-service.d.ts +84 -0
  128. package/dist/backend/services/brand-tokens-service.d.ts.map +1 -0
  129. package/dist/backend/services/brand-tokens-service.js +159 -0
  130. package/dist/backend/services/brand-tokens-service.js.map +1 -0
  131. package/dist/backend/services/channel-language-prefixes.d.ts +11 -0
  132. package/dist/backend/services/channel-language-prefixes.d.ts.map +1 -0
  133. package/dist/backend/services/channel-language-prefixes.js +24 -0
  134. package/dist/backend/services/channel-language-prefixes.js.map +1 -0
  135. package/dist/backend/services/cms-block-service.d.ts.map +1 -1
  136. package/dist/backend/services/cms-block-service.js +3 -0
  137. package/dist/backend/services/cms-block-service.js.map +1 -1
  138. package/dist/backend/services/cms-cache.d.ts +10 -0
  139. package/dist/backend/services/cms-cache.d.ts.map +1 -1
  140. package/dist/backend/services/cms-cache.js +9 -0
  141. package/dist/backend/services/cms-cache.js.map +1 -1
  142. package/dist/backend/services/cms-content-invalidator.d.ts +13 -4
  143. package/dist/backend/services/cms-content-invalidator.d.ts.map +1 -1
  144. package/dist/backend/services/cms-content-invalidator.js +13 -6
  145. package/dist/backend/services/cms-content-invalidator.js.map +1 -1
  146. package/dist/backend/services/cms-page-read-port.d.ts +6 -1
  147. package/dist/backend/services/cms-page-read-port.d.ts.map +1 -1
  148. package/dist/backend/services/cms-page-read-port.js +27 -0
  149. package/dist/backend/services/cms-page-read-port.js.map +1 -1
  150. package/dist/backend/services/cms-page-service.d.ts +72 -1
  151. package/dist/backend/services/cms-page-service.d.ts.map +1 -1
  152. package/dist/backend/services/cms-page-service.js +317 -17
  153. package/dist/backend/services/cms-page-service.js.map +1 -1
  154. package/dist/backend/services/cms-template-service.d.ts.map +1 -1
  155. package/dist/backend/services/cms-template-service.js +3 -0
  156. package/dist/backend/services/cms-template-service.js.map +1 -1
  157. package/dist/backend/services/contact-form/contact-form-mail.d.ts +22 -0
  158. package/dist/backend/services/contact-form/contact-form-mail.d.ts.map +1 -0
  159. package/dist/backend/services/contact-form/contact-form-mail.js +64 -0
  160. package/dist/backend/services/contact-form/contact-form-mail.js.map +1 -0
  161. package/dist/backend/services/contact-form/contact-form.service.d.ts +35 -0
  162. package/dist/backend/services/contact-form/contact-form.service.d.ts.map +1 -0
  163. package/dist/backend/services/contact-form/contact-form.service.js +75 -0
  164. package/dist/backend/services/contact-form/contact-form.service.js.map +1 -0
  165. package/dist/backend/services/contact-form/recipients-validator.d.ts +8 -0
  166. package/dist/backend/services/contact-form/recipients-validator.d.ts.map +1 -0
  167. package/dist/backend/services/contact-form/recipients-validator.js +23 -0
  168. package/dist/backend/services/contact-form/recipients-validator.js.map +1 -0
  169. package/dist/backend/services/content-tree-walker.d.ts +12 -0
  170. package/dist/backend/services/content-tree-walker.d.ts.map +1 -1
  171. package/dist/backend/services/content-tree-walker.js +40 -0
  172. package/dist/backend/services/content-tree-walker.js.map +1 -1
  173. package/dist/backend/services/page-builder-registry.d.ts +11 -2
  174. package/dist/backend/services/page-builder-registry.d.ts.map +1 -1
  175. package/dist/backend/services/page-builder-registry.js +10 -1
  176. package/dist/backend/services/page-builder-registry.js.map +1 -1
  177. package/dist/backend/services/page-paths.d.ts +87 -0
  178. package/dist/backend/services/page-paths.d.ts.map +1 -0
  179. package/dist/backend/services/page-paths.js +177 -0
  180. package/dist/backend/services/page-paths.js.map +1 -0
  181. package/dist/backend/services/storefront-resolver.d.ts +53 -2
  182. package/dist/backend/services/storefront-resolver.d.ts.map +1 -1
  183. package/dist/backend/services/storefront-resolver.js +313 -22
  184. package/dist/backend/services/storefront-resolver.js.map +1 -1
  185. package/dist/backend/services/translation/extract.d.ts.map +1 -1
  186. package/dist/backend/services/translation/extract.js +9 -1
  187. package/dist/backend/services/translation/extract.js.map +1 -1
  188. package/dist/manifest.d.ts +13 -1
  189. package/dist/manifest.d.ts.map +1 -1
  190. package/dist/manifest.js +592 -73
  191. package/dist/manifest.js.map +1 -1
  192. package/dist/migrations/20261022T163218_cms_brand_tokens.d.ts +24 -0
  193. package/dist/migrations/20261022T163218_cms_brand_tokens.d.ts.map +1 -0
  194. package/dist/migrations/20261022T163218_cms_brand_tokens.js +38 -0
  195. package/dist/migrations/20261022T163218_cms_brand_tokens.js.map +1 -0
  196. package/dist/migrations/20261023T052237_cms_page_tree_and_share.d.ts +24 -0
  197. package/dist/migrations/20261023T052237_cms_page_tree_and_share.d.ts.map +1 -0
  198. package/dist/migrations/20261023T052237_cms_page_tree_and_share.js +51 -0
  199. package/dist/migrations/20261023T052237_cms_page_tree_and_share.js.map +1 -0
  200. package/dist/migrations/20261027T165458_cms_page_parent_path_in_url.d.ts +16 -0
  201. package/dist/migrations/20261027T165458_cms_page_parent_path_in_url.d.ts.map +1 -0
  202. package/dist/migrations/20261027T165458_cms_page_parent_path_in_url.js +20 -0
  203. package/dist/migrations/20261027T165458_cms_page_parent_path_in_url.js.map +1 -0
  204. package/dist/migrations/20261028T090524_cms_page_breadcrumbs_overlay.d.ts +14 -0
  205. package/dist/migrations/20261028T090524_cms_page_breadcrumbs_overlay.d.ts.map +1 -0
  206. package/dist/migrations/20261028T090524_cms_page_breadcrumbs_overlay.js +18 -0
  207. package/dist/migrations/20261028T090524_cms_page_breadcrumbs_overlay.js.map +1 -0
  208. package/dist/migrations/20261029T131218_cms_page_translations.d.ts +15 -0
  209. package/dist/migrations/20261029T131218_cms_page_translations.d.ts.map +1 -0
  210. package/dist/migrations/20261029T131218_cms_page_translations.js +19 -0
  211. package/dist/migrations/20261029T131218_cms_page_translations.js.map +1 -0
  212. package/dist/migrations/index.d.ts +6 -1
  213. package/dist/migrations/index.d.ts.map +1 -1
  214. package/dist/migrations/index.js +11 -1
  215. package/dist/migrations/index.js.map +1 -1
  216. package/docs/cms/brand.md +310 -0
  217. package/docs/cms/contact-form.md +161 -0
  218. package/docs/cms/extending-page-builder.md +210 -15
  219. package/docs/cms/index.md +1232 -39
  220. package/docs/cms/page-navigation.md +83 -0
  221. package/i18n/en.json +2758 -22
  222. package/i18n/pl.json +2758 -22
  223. package/package.json +18 -16
  224. package/dist/admin/components/ButtonLinkFields.d.ts +0 -6
  225. package/dist/admin/components/ButtonLinkFields.d.ts.map +0 -1
  226. package/dist/admin/components/ButtonLinkFields.js +0 -127
  227. package/dist/admin/components/ButtonLinkFields.js.map +0 -1
@@ -0,0 +1,87 @@
1
+ import type { EntityManager } from '@mikro-orm/postgresql';
2
+ import { type CmsLocalizablePage, type CmsPagePathNode, type CmsPageStorefrontLink, type CmsPageTranslations } from '@endora-commerce/contracts';
3
+ /**
4
+ * One page as one sales channel serves it — the input of the public-path rule
5
+ * (`specs/163-page-builder-marketing-pages/` R19D, T282) plus what the
6
+ * resolver filters candidates by.
7
+ *
8
+ * `slug` is the channel's (`cms_page_sales_channels.slug`), never the page
9
+ * row's: the address is per channel (Constitution XII).
10
+ */
11
+ export interface ChannelPageNode extends CmsPagePathNode {
12
+ salesChannelId: string;
13
+ /** The languages the page declares — the only ones its overrides count in (R24). */
14
+ languages: string[];
15
+ /** R24: the page's per-language overrides; `slug` is what a language's tree reads. */
16
+ translations: CmsPageTranslations;
17
+ status: 'draft' | 'published' | 'archived';
18
+ active: boolean;
19
+ updatedAt: Date | string;
20
+ }
21
+ /**
22
+ * Every page bound to the given channels, as the path rule reads it. One
23
+ * indexed join over narrow columns: a CMS holds hundreds of pages, and a path
24
+ * is a function of the whole channel's tree, so reading the tree is cheaper
25
+ * than walking it a row at a time.
26
+ */
27
+ export declare function loadChannelPageNodes(em: EntityManager, salesChannelIds: readonly string[]): Promise<ChannelPageNode[]>;
28
+ /**
29
+ * The slug a page is served under in one language (R24): the language's
30
+ * override, else the channel's slug. `cmsLocalizedPage` decides, so an override
31
+ * of a language the page does not declare counts nowhere.
32
+ */
33
+ export declare function languageSlug(node: ChannelPageNode, language: string): string;
34
+ /**
35
+ * The public path of every page in one channel, by page id — in one language
36
+ * when `language` is given (R24), else at the channel slugs themselves, which
37
+ * is every path before R24 and still the tree a stored link's slug names.
38
+ */
39
+ export declare function channelPaths(nodes: readonly ChannelPageNode[], salesChannelId: string, language?: string): Map<string, string>;
40
+ /** The languages the channel's pages declare, in first-seen order (R24). */
41
+ export declare function channelLanguages(nodes: readonly ChannelPageNode[], salesChannelId: string): string[];
42
+ /**
43
+ * The first public path two pages of one channel share where one of them is
44
+ * in `pageIds`, or `null` (R19D, T282). A path is an address, and an address
45
+ * names one page: the write that would produce a duplicate is refused.
46
+ *
47
+ * Only duplicates involving `pageIds` count — the page being written and its
48
+ * descendants, whose paths move with it — so a write is never refused for a
49
+ * state it did not create.
50
+ */
51
+ export declare function duplicatePath(nodes: readonly ChannelPageNode[], pageIds: ReadonlySet<string>): {
52
+ salesChannelId: string;
53
+ path: string;
54
+ language?: string;
55
+ } | null;
56
+ /**
57
+ * Every address the given pages answer under, in every channel `nodes`
58
+ * covers: each channel slug (a nested page's flat slug still resolves, as an
59
+ * alias that redirects) and each computed path. What a cache invalidation must
60
+ * name for those pages.
61
+ */
62
+ export declare function addressesOf(nodes: readonly ChannelPageNode[], pageIds: ReadonlySet<string>): Set<string>;
63
+ /**
64
+ * Whether any of the given pages is served at a path other than its slug — a
65
+ * nested page, whose path the resolver writes into the links of *other*
66
+ * pages. When such a path moves, those pages' cached answers are stale too.
67
+ * Asked in every tree (R24): a language slug moves a nested path too.
68
+ */
69
+ export declare function anyNested(nodes: readonly ChannelPageNode[], pageIds: ReadonlySet<string>): boolean;
70
+ /**
71
+ * A storefront link to each of `ids` that the channel serves, in one language
72
+ * (`specs/168-megamenu-navigation-bar/` plan R-8): the page's name in it and
73
+ * its logical path in that language's tree — no language prefix, which the
74
+ * storefront adds (feature 167).
75
+ * A page the channel does not serve is left out; the order is `ids`'.
76
+ *
77
+ * No status or `active` narrowing, on purpose: a menu's link to a draft or a
78
+ * deactivated page has always stayed and answered for itself when followed
79
+ * (`megamenu`'s `resolveCmsPageUrl`), and this keeps that decision.
80
+ */
81
+ export declare function pageStorefrontLinks(nodes: readonly ChannelPageNode[], pages: readonly (CmsLocalizablePage & {
82
+ id: string;
83
+ })[], ids: readonly string[], scope: {
84
+ salesChannelId: string;
85
+ language: string;
86
+ }): CmsPageStorefrontLink[];
87
+ //# sourceMappingURL=page-paths.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"page-paths.d.ts","sourceRoot":"","sources":["../../../src/backend/services/page-paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACzB,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,cAAc,EAAE,MAAM,CAAC;IACvB,oFAAoF;IACpF,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,sFAAsF;IACtF,YAAY,EAAE,mBAAmB,CAAC;IAClC,MAAM,EAAE,OAAO,GAAG,WAAW,GAAG,UAAU,CAAC;IAC3C,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,aAAa,EACjB,eAAe,EAAE,SAAS,MAAM,EAAE,GACjC,OAAO,CAAC,eAAe,EAAE,CAAC,CAoC5B;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG5E;AAQD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,eAAe,EAAE,EACjC,cAAc,EAAE,MAAM,EACtB,QAAQ,CAAC,EAAE,MAAM,GAChB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAErB;AAOD,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,CAOpG;AAWD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,eAAe,EAAE,EACjC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAC3B;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAiBpE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAcxG;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAalG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,eAAe,EAAE,EACjC,KAAK,EAAE,SAAS,CAAC,kBAAkB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,EACvD,GAAG,EAAE,SAAS,MAAM,EAAE,EACtB,KAAK,EAAE;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAClD,qBAAqB,EAAE,CAezB"}
@@ -0,0 +1,177 @@
1
+ import { cmsLocalizedPage, cmsPagePublicPaths, } from '@endora-commerce/contracts';
2
+ /**
3
+ * Every page bound to the given channels, as the path rule reads it. One
4
+ * indexed join over narrow columns: a CMS holds hundreds of pages, and a path
5
+ * is a function of the whole channel's tree, so reading the tree is cheaper
6
+ * than walking it a row at a time.
7
+ */
8
+ export async function loadChannelPageNodes(em, salesChannelIds) {
9
+ if (salesChannelIds.length === 0)
10
+ return [];
11
+ const placeholders = salesChannelIds.map(() => '?').join(', ');
12
+ const rows = (await em.execute(`select p.id::text as id, p.parent_page_id::text as parent_page_id, p.parent_path_in_url,
13
+ cpsc.sales_channel_id::text as sales_channel_id, cpsc.slug, p.languages, p.translations,
14
+ p.status, p.active, p.updated_at
15
+ from cms_page_sales_channels cpsc
16
+ join cms_pages p on p.id = cpsc.page_id
17
+ where cpsc.sales_channel_id in (${placeholders})`, [...salesChannelIds]));
18
+ return rows.map((row) => ({
19
+ id: row.id,
20
+ parentPageId: row.parent_page_id,
21
+ parentPathInUrl: row.parent_path_in_url === true,
22
+ salesChannelId: row.sales_channel_id,
23
+ slug: row.slug,
24
+ languages: row.languages ?? [],
25
+ translations: row.translations ?? {},
26
+ status: row.status,
27
+ active: row.active,
28
+ updatedAt: row.updated_at,
29
+ }));
30
+ }
31
+ /**
32
+ * The slug a page is served under in one language (R24): the language's
33
+ * override, else the channel's slug. `cmsLocalizedPage` decides, so an override
34
+ * of a language the page does not declare counts nowhere.
35
+ */
36
+ export function languageSlug(node, language) {
37
+ return cmsLocalizedPage({ name: '', slug: node.slug, languages: node.languages, translations: node.translations }, language)
38
+ .slug;
39
+ }
40
+ /** The channel's pages as one language's tree reads them — each at its slug in that language. */
41
+ function inLanguage(nodes, language) {
42
+ if (language === undefined)
43
+ return [...nodes];
44
+ return nodes.map((node) => ({ ...node, slug: languageSlug(node, language) }));
45
+ }
46
+ /**
47
+ * The public path of every page in one channel, by page id — in one language
48
+ * when `language` is given (R24), else at the channel slugs themselves, which
49
+ * is every path before R24 and still the tree a stored link's slug names.
50
+ */
51
+ export function channelPaths(nodes, salesChannelId, language) {
52
+ return cmsPagePublicPaths(inLanguage(nodes.filter((node) => node.salesChannelId === salesChannelId), language));
53
+ }
54
+ /** The channels `nodes` covers. */
55
+ function channelsOf(nodes) {
56
+ return [...new Set(nodes.map((node) => node.salesChannelId))];
57
+ }
58
+ /** The languages the channel's pages declare, in first-seen order (R24). */
59
+ export function channelLanguages(nodes, salesChannelId) {
60
+ const out = new Set();
61
+ for (const node of nodes) {
62
+ if (node.salesChannelId !== salesChannelId)
63
+ continue;
64
+ for (const language of node.languages)
65
+ out.add(language);
66
+ }
67
+ return [...out];
68
+ }
69
+ /**
70
+ * The trees one channel is addressed through: the channel slugs (`undefined`)
71
+ * and each language's (R24). A page with no override reads the same in all of
72
+ * them, so a channel whose pages override nothing repeats one tree.
73
+ */
74
+ function treesOf(nodes, salesChannelId) {
75
+ return [undefined, ...channelLanguages(nodes, salesChannelId)];
76
+ }
77
+ /**
78
+ * The first public path two pages of one channel share where one of them is
79
+ * in `pageIds`, or `null` (R19D, T282). A path is an address, and an address
80
+ * names one page: the write that would produce a duplicate is refused.
81
+ *
82
+ * Only duplicates involving `pageIds` count — the page being written and its
83
+ * descendants, whose paths move with it — so a write is never refused for a
84
+ * state it did not create.
85
+ */
86
+ export function duplicatePath(nodes, pageIds) {
87
+ for (const salesChannelId of channelsOf(nodes)) {
88
+ for (const language of treesOf(nodes, salesChannelId)) {
89
+ const owners = new Map();
90
+ for (const [pageId, path] of channelPaths(nodes, salesChannelId, language)) {
91
+ const list = owners.get(path) ?? [];
92
+ list.push(pageId);
93
+ owners.set(path, list);
94
+ }
95
+ for (const [path, ids] of owners) {
96
+ if (ids.length > 1 && ids.some((id) => pageIds.has(id))) {
97
+ return language === undefined ? { salesChannelId, path } : { salesChannelId, path, language };
98
+ }
99
+ }
100
+ }
101
+ }
102
+ return null;
103
+ }
104
+ /**
105
+ * Every address the given pages answer under, in every channel `nodes`
106
+ * covers: each channel slug (a nested page's flat slug still resolves, as an
107
+ * alias that redirects) and each computed path. What a cache invalidation must
108
+ * name for those pages.
109
+ */
110
+ export function addressesOf(nodes, pageIds) {
111
+ const out = new Set();
112
+ for (const salesChannelId of channelsOf(nodes)) {
113
+ for (const language of treesOf(nodes, salesChannelId)) {
114
+ const paths = channelPaths(nodes, salesChannelId, language);
115
+ for (const node of nodes) {
116
+ if (node.salesChannelId !== salesChannelId || !pageIds.has(node.id))
117
+ continue;
118
+ out.add(language === undefined ? node.slug : languageSlug(node, language));
119
+ const path = paths.get(node.id);
120
+ if (path)
121
+ out.add(path);
122
+ }
123
+ }
124
+ }
125
+ return out;
126
+ }
127
+ /**
128
+ * Whether any of the given pages is served at a path other than its slug — a
129
+ * nested page, whose path the resolver writes into the links of *other*
130
+ * pages. When such a path moves, those pages' cached answers are stale too.
131
+ * Asked in every tree (R24): a language slug moves a nested path too.
132
+ */
133
+ export function anyNested(nodes, pageIds) {
134
+ const flat = (slug) => slug.split('/').filter(Boolean).join('/');
135
+ for (const salesChannelId of channelsOf(nodes)) {
136
+ for (const language of treesOf(nodes, salesChannelId)) {
137
+ const paths = channelPaths(nodes, salesChannelId, language);
138
+ for (const node of nodes) {
139
+ if (node.salesChannelId !== salesChannelId || !pageIds.has(node.id))
140
+ continue;
141
+ const slug = language === undefined ? node.slug : languageSlug(node, language);
142
+ if (paths.get(node.id) !== flat(slug))
143
+ return true;
144
+ }
145
+ }
146
+ }
147
+ return false;
148
+ }
149
+ /**
150
+ * A storefront link to each of `ids` that the channel serves, in one language
151
+ * (`specs/168-megamenu-navigation-bar/` plan R-8): the page's name in it and
152
+ * its logical path in that language's tree — no language prefix, which the
153
+ * storefront adds (feature 167).
154
+ * A page the channel does not serve is left out; the order is `ids`'.
155
+ *
156
+ * No status or `active` narrowing, on purpose: a menu's link to a draft or a
157
+ * deactivated page has always stayed and answered for itself when followed
158
+ * (`megamenu`'s `resolveCmsPageUrl`), and this keeps that decision.
159
+ */
160
+ export function pageStorefrontLinks(nodes, pages, ids, scope) {
161
+ const paths = channelPaths(nodes, scope.salesChannelId, scope.language);
162
+ const pageById = new Map(pages.map((page) => [page.id, page]));
163
+ const out = [];
164
+ for (const id of ids) {
165
+ const path = paths.get(id);
166
+ const page = pageById.get(id);
167
+ if (path === undefined || !page)
168
+ continue;
169
+ out.push({
170
+ id,
171
+ name: cmsLocalizedPage(page, scope.language).name,
172
+ url: `/${path}`,
173
+ });
174
+ }
175
+ return out;
176
+ }
177
+ //# sourceMappingURL=page-paths.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"page-paths.js","sourceRoot":"","sources":["../../../src/backend/services/page-paths.ts"],"names":[],"mappings":"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"}
@@ -1,7 +1,13 @@
1
1
  import type { EntityManager } from '@mikro-orm/postgresql';
2
- import type { CmsAssetEmbedResolution, CmsPageIndexEntry, CmsResolvedBlock, CmsResolvedHook, CmsResolvedPage } from '@endora-commerce/contracts';
3
- import type { CmsCache } from './cms-cache.js';
2
+ import { type CmsAssetEmbedResolution, type CmsPageIndexEntry, type CmsResolvedBlock, type CmsResolvedHook, type CmsResolvedPage } from '@endora-commerce/contracts';
3
+ import { CmsCache } from './cms-cache.js';
4
4
  export type CmsAssetResolver = (assetId: string) => Promise<CmsAssetEmbedResolution | null>;
5
+ /**
6
+ * The asset id `cms.default_share_image_asset_id` holds for one sales channel,
7
+ * or `null` when it is empty (feature 163, FR-033). Late-bound, like the asset
8
+ * resolver: the setting is read through the settings store per request.
9
+ */
10
+ export type CmsDefaultShareImageResolver = (salesChannelId: string) => Promise<string | null>;
5
11
  /**
6
12
  * The request's resolved sales channel, handed in by the route from the
7
13
  * canonical resolver, read via `getResolvedChannel()` — feature 053 / FR-002. The
@@ -11,19 +17,64 @@ export type ResolvedChannel = {
11
17
  id: string;
12
18
  code: string;
13
19
  defaultLanguage: string;
20
+ /**
21
+ * Feature 167 — the channel's languages and *prefix the default language* setting,
22
+ * for the language prefix on every CMS URL answered. Optional for callers that
23
+ * predate them: the default language alone, prefixed (the column default).
24
+ */
25
+ languages?: readonly string[];
26
+ prefixDefaultLanguage?: boolean;
14
27
  };
15
28
  export declare class StorefrontResolver {
16
29
  private readonly emFactory;
17
30
  private readonly cache?;
18
31
  private assetResolver;
32
+ private defaultShareImageResolver;
19
33
  constructor(emFactory: () => EntityManager, cache?: CmsCache | undefined);
20
34
  setAssetResolver(resolver: CmsAssetResolver | null): void;
35
+ setDefaultShareImageResolver(resolver: CmsDefaultShareImageResolver | null): void;
36
+ /**
37
+ * One asset as a sharing image: its URL when it resolves and is public —
38
+ * a crawler fetching `og:image` carries no session — else `null`.
39
+ */
40
+ private shareImageUrl;
41
+ /**
42
+ * The deployment default applied to a page without a sharing image of its
43
+ * own (feature 163, FR-033). Applied after the page cache rather than stored
44
+ * in it: the page's own image is part of the page, invalidated with it, while
45
+ * the default is a setting whose change no page write announces. The read is
46
+ * for the request's channel (Constitution XII).
47
+ */
48
+ private withDefaultShareImage;
21
49
  private resolveAssetsForTrees;
22
50
  resolvePageBySlug(input: {
23
51
  resolvedChannel: ResolvedChannel;
24
52
  language?: string | undefined;
25
53
  slug: string;
26
54
  }): Promise<CmsResolvedPage | null>;
55
+ /**
56
+ * The languages the page carries content for, among those it declares — the
57
+ * ones a reader could be served (feature 163, FR-034) — with the served
58
+ * language always among them.
59
+ */
60
+ private servableLanguages;
61
+ /**
62
+ * The breadcrumb trail of one page for one channel (feature 163,
63
+ * data-model §5; FR-030, FR-030a): its ancestors root-first, without Home
64
+ * and without the page itself.
65
+ *
66
+ * An ancestor's link is the slug **this channel** serves it under, read off
67
+ * `cms_page_sales_channels` (Constitution XII) — never the page row's own
68
+ * `slug`, which is one value shared by every channel. An ancestor this
69
+ * channel does not serve, published and active, keeps its place in the trail
70
+ * as text (`slug: null`): the hierarchy is still true, there is just no page
71
+ * here to link to.
72
+ *
73
+ * The name is the ancestor's page name, as the current page's own crumb is
74
+ * (R19C, T270): one source for every crumb. Until R19C an ancestor was named
75
+ * by its meta title, so a trail mixed browser titles and page names.
76
+ */
77
+ private resolveTrail;
27
78
  /**
28
79
  * Every published page of one sales channel, at the slug that channel serves
29
80
  * it under (feature 105, FR-021; `contracts/cms-page-url.md` §4.1).
@@ -1 +1 @@
1
- {"version":3,"file":"storefront-resolver.d.ts","sourceRoot":"","sources":["../../../src/backend/services/storefront-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EACV,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,eAAe,EAEhB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAC;AAiC5F;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AA0BF,qBAAa,kBAAkB;IAI3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IAJzB,OAAO,CAAC,aAAa,CAAiC;gBAGnC,SAAS,EAAE,MAAM,aAAa,EAC9B,KAAK,CAAC,EAAE,QAAQ,YAAA;IAGnC,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI;YAI3C,qBAAqB;IAkB7B,iBAAiB,CAAC,KAAK,EAAE;QAC7B,eAAe,EAAE,eAAe,CAAC;QACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IA0DnC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,kBAAkB,CAAC,KAAK,EAAE;QAC9B,eAAe,EAAE,eAAe,CAAC;KAClC,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAoB1B,kBAAkB,CAAC,KAAK,EAAE;QAC9B,eAAe,EAAE,eAAe,CAAC;QACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAwC9B,iBAAiB,CAAC,KAAK,EAAE;QAC7B,eAAe,EAAE,eAAe,CAAC;QACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAuEnC;;;;OAIG;YACW,YAAY;YA0EZ,kBAAkB;YAkBlB,qBAAqB;IAiBnC,OAAO,CAAC,eAAe;CA6BxB"}
1
+ {"version":3,"file":"storefront-resolver.d.ts","sourceRoot":"","sources":["../../../src/backend/services/storefront-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAIL,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EAEtB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EAErB,MAAM,4BAA4B,CAAC;AASpC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAC;AAE5F;;;;GAIG;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAmD9F;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC,CAAC;AA0CF,qBAAa,kBAAkB;IAK3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IALzB,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,yBAAyB,CAA6C;gBAG3D,SAAS,EAAE,MAAM,aAAa,EAC9B,KAAK,CAAC,EAAE,QAAQ,YAAA;IAGnC,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI;IAIzD,4BAA4B,CAAC,QAAQ,EAAE,4BAA4B,GAAG,IAAI,GAAG,IAAI;IAIjF;;;OAGG;YACW,aAAa;IAM3B;;;;;;OAMG;YACW,qBAAqB;YAyBrB,qBAAqB;IAkB7B,iBAAiB,CAAC,KAAK,EAAE;QAC7B,eAAe,EAAE,eAAe,CAAC;QACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAsGnC;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;;;;;;;;;;;;;;OAeG;YACW,YAAY;IAsD1B;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,kBAAkB,CAAC,KAAK,EAAE;QAC9B,eAAe,EAAE,eAAe,CAAC;KAClC,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA8D1B,kBAAkB,CAAC,KAAK,EAAE;QAC9B,eAAe,EAAE,eAAe,CAAC;QACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAwC9B,iBAAiB,CAAC,KAAK,EAAE;QAC7B,eAAe,EAAE,eAAe,CAAC;QACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAuEnC;;;;OAIG;YACW,YAAY;YA0EZ,kBAAkB;YAkBlB,qBAAqB;IAiBnC,OAAO,CAAC,eAAe;CA6BxB"}