@endora-commerce/contracts 0.108.0 → 0.110.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 (309) hide show
  1. package/dist/actor.d.ts +16 -0
  2. package/dist/actor.d.ts.map +1 -1
  3. package/dist/addresses.d.ts +35 -0
  4. package/dist/addresses.d.ts.map +1 -1
  5. package/dist/addresses.js +8 -1
  6. package/dist/addresses.js.map +1 -1
  7. package/dist/admin-actions.d.ts +12 -3
  8. package/dist/admin-actions.d.ts.map +1 -1
  9. package/dist/admin-actions.js +34 -3
  10. package/dist/admin-actions.js.map +1 -1
  11. package/dist/admin-contributions.d.ts +94 -10
  12. package/dist/admin-contributions.d.ts.map +1 -1
  13. package/dist/admin-contributions.js +65 -0
  14. package/dist/admin-contributions.js.map +1 -1
  15. package/dist/admin-notifications.d.ts +17 -1
  16. package/dist/admin-notifications.d.ts.map +1 -1
  17. package/dist/admin-preferences.d.ts +108 -0
  18. package/dist/admin-preferences.d.ts.map +1 -0
  19. package/dist/admin-preferences.js +133 -0
  20. package/dist/admin-preferences.js.map +1 -0
  21. package/dist/admin-roles.d.ts +8 -2
  22. package/dist/admin-roles.d.ts.map +1 -1
  23. package/dist/admin-roles.js.map +1 -1
  24. package/dist/admin-users.d.ts +9 -0
  25. package/dist/admin-users.d.ts.map +1 -1
  26. package/dist/admin.d.ts +92 -5
  27. package/dist/admin.d.ts.map +1 -1
  28. package/dist/admin.js +86 -3
  29. package/dist/admin.js.map +1 -1
  30. package/dist/assets-library.d.ts +123 -3
  31. package/dist/assets-library.d.ts.map +1 -1
  32. package/dist/assets-library.js +11 -3
  33. package/dist/assets-library.js.map +1 -1
  34. package/dist/audit-logs.d.ts +12 -0
  35. package/dist/audit-logs.d.ts.map +1 -1
  36. package/dist/audit-logs.js +12 -0
  37. package/dist/audit-logs.js.map +1 -1
  38. package/dist/blog.d.ts +431 -14
  39. package/dist/blog.d.ts.map +1 -1
  40. package/dist/blog.js +251 -7
  41. package/dist/blog.js.map +1 -1
  42. package/dist/carts.d.ts +507 -92
  43. package/dist/carts.d.ts.map +1 -1
  44. package/dist/carts.js +197 -21
  45. package/dist/carts.js.map +1 -1
  46. package/dist/catalog.d.ts +515 -144
  47. package/dist/catalog.d.ts.map +1 -1
  48. package/dist/catalog.js +356 -68
  49. package/dist/catalog.js.map +1 -1
  50. package/dist/cms-brand.d.ts +2233 -0
  51. package/dist/cms-brand.d.ts.map +1 -0
  52. package/dist/cms-brand.js +311 -0
  53. package/dist/cms-brand.js.map +1 -0
  54. package/dist/cms-contact-form.d.ts +55 -0
  55. package/dist/cms-contact-form.d.ts.map +1 -0
  56. package/dist/cms-contact-form.js +100 -0
  57. package/dist/cms-contact-form.js.map +1 -0
  58. package/dist/cms.d.ts +576 -17
  59. package/dist/cms.d.ts.map +1 -1
  60. package/dist/cms.js +251 -0
  61. package/dist/cms.js.map +1 -1
  62. package/dist/common.d.ts +23 -6
  63. package/dist/common.d.ts.map +1 -1
  64. package/dist/common.js +25 -2
  65. package/dist/common.js.map +1 -1
  66. package/dist/comparisons.d.ts +28 -21
  67. package/dist/comparisons.d.ts.map +1 -1
  68. package/dist/comparisons.js +2 -1
  69. package/dist/comparisons.js.map +1 -1
  70. package/dist/credit-limits.d.ts +1 -0
  71. package/dist/credit-limits.d.ts.map +1 -1
  72. package/dist/credit-limits.js +14 -0
  73. package/dist/credit-limits.js.map +1 -1
  74. package/dist/crm-rich-text.d.ts +10 -61
  75. package/dist/crm-rich-text.d.ts.map +1 -1
  76. package/dist/crm-rich-text.js +10 -300
  77. package/dist/crm-rich-text.js.map +1 -1
  78. package/dist/crm.d.ts +173 -115
  79. package/dist/crm.d.ts.map +1 -1
  80. package/dist/crm.js +35 -88
  81. package/dist/crm.js.map +1 -1
  82. package/dist/custom-fields.d.ts +54 -22
  83. package/dist/custom-fields.d.ts.map +1 -1
  84. package/dist/custom-fields.js +21 -1
  85. package/dist/custom-fields.js.map +1 -1
  86. package/dist/customer-accounts.d.ts +216 -22
  87. package/dist/customer-accounts.d.ts.map +1 -1
  88. package/dist/customer-accounts.js +70 -0
  89. package/dist/customer-accounts.js.map +1 -1
  90. package/dist/customers.d.ts +40 -73
  91. package/dist/customers.d.ts.map +1 -1
  92. package/dist/customers.js +45 -10
  93. package/dist/customers.js.map +1 -1
  94. package/dist/document-templates.d.ts +35 -23
  95. package/dist/document-templates.d.ts.map +1 -1
  96. package/dist/document-values.d.ts +8 -0
  97. package/dist/document-values.d.ts.map +1 -1
  98. package/dist/document-values.js +24 -6
  99. package/dist/document-values.js.map +1 -1
  100. package/dist/email.d.ts +5 -0
  101. package/dist/email.d.ts.map +1 -1
  102. package/dist/errors.d.ts +224 -1
  103. package/dist/errors.d.ts.map +1 -1
  104. package/dist/errors.js +269 -1
  105. package/dist/errors.js.map +1 -1
  106. package/dist/forms-logic.d.ts +79 -0
  107. package/dist/forms-logic.d.ts.map +1 -0
  108. package/dist/forms-logic.fixtures.d.ts +52 -0
  109. package/dist/forms-logic.fixtures.d.ts.map +1 -0
  110. package/dist/forms-logic.fixtures.js +610 -0
  111. package/dist/forms-logic.fixtures.js.map +1 -0
  112. package/dist/forms-logic.js +699 -0
  113. package/dist/forms-logic.js.map +1 -0
  114. package/dist/forms.d.ts +9833 -0
  115. package/dist/forms.d.ts.map +1 -0
  116. package/dist/forms.js +827 -0
  117. package/dist/forms.js.map +1 -0
  118. package/dist/import-export.d.ts +180 -0
  119. package/dist/import-export.d.ts.map +1 -1
  120. package/dist/import-export.js +60 -0
  121. package/dist/import-export.js.map +1 -1
  122. package/dist/index.d.ts +22 -1
  123. package/dist/index.d.ts.map +1 -1
  124. package/dist/index.js +45 -1
  125. package/dist/index.js.map +1 -1
  126. package/dist/inventory.d.ts +6 -6
  127. package/dist/invoice-ledger.d.ts +7 -7
  128. package/dist/invoices.d.ts +6 -2
  129. package/dist/invoices.d.ts.map +1 -1
  130. package/dist/invoices.js +7 -0
  131. package/dist/invoices.js.map +1 -1
  132. package/dist/megamenu.d.ts +674 -0
  133. package/dist/megamenu.d.ts.map +1 -1
  134. package/dist/megamenu.js +96 -3
  135. package/dist/megamenu.js.map +1 -1
  136. package/dist/mfa.d.ts +125 -4
  137. package/dist/mfa.d.ts.map +1 -1
  138. package/dist/mfa.js +54 -2
  139. package/dist/mfa.js.map +1 -1
  140. package/dist/modules.d.ts +44 -5
  141. package/dist/modules.d.ts.map +1 -1
  142. package/dist/modules.js +73 -0
  143. package/dist/modules.js.map +1 -1
  144. package/dist/money-decimal.d.ts +54 -0
  145. package/dist/money-decimal.d.ts.map +1 -1
  146. package/dist/money-decimal.js +95 -0
  147. package/dist/money-decimal.js.map +1 -1
  148. package/dist/newsletter.d.ts +7 -7
  149. package/dist/orders.d.ts +128 -10
  150. package/dist/orders.d.ts.map +1 -1
  151. package/dist/orders.js +74 -4
  152. package/dist/orders.js.map +1 -1
  153. package/dist/organization-registry-lookup.d.ts +362 -0
  154. package/dist/organization-registry-lookup.d.ts.map +1 -0
  155. package/dist/organization-registry-lookup.js +196 -0
  156. package/dist/organization-registry-lookup.js.map +1 -0
  157. package/dist/organization-roles.d.ts +340 -0
  158. package/dist/organization-roles.d.ts.map +1 -0
  159. package/dist/organization-roles.js +211 -0
  160. package/dist/organization-roles.js.map +1 -0
  161. package/dist/organizations.d.ts +123 -89
  162. package/dist/organizations.d.ts.map +1 -1
  163. package/dist/organizations.js +68 -24
  164. package/dist/organizations.js.map +1 -1
  165. package/dist/page-builder-props.d.ts +1401 -0
  166. package/dist/page-builder-props.d.ts.map +1 -0
  167. package/dist/page-builder-props.js +266 -0
  168. package/dist/page-builder-props.js.map +1 -0
  169. package/dist/page-builder-values.d.ts +95 -0
  170. package/dist/page-builder-values.d.ts.map +1 -0
  171. package/dist/page-builder-values.js +164 -0
  172. package/dist/page-builder-values.js.map +1 -0
  173. package/dist/pim-connector.d.ts +6 -2
  174. package/dist/pim-connector.d.ts.map +1 -1
  175. package/dist/pim-connector.js +6 -2
  176. package/dist/pim-connector.js.map +1 -1
  177. package/dist/pim-field-path.d.ts +5 -1
  178. package/dist/pim-field-path.d.ts.map +1 -1
  179. package/dist/pim-field-path.js +37 -81
  180. package/dist/pim-field-path.js.map +1 -1
  181. package/dist/pim-locale-mapping.d.ts +131 -0
  182. package/dist/pim-locale-mapping.d.ts.map +1 -0
  183. package/dist/pim-locale-mapping.js +193 -0
  184. package/dist/pim-locale-mapping.js.map +1 -0
  185. package/dist/platform-language.d.ts +9 -0
  186. package/dist/platform-language.d.ts.map +1 -1
  187. package/dist/platform-language.js +14 -0
  188. package/dist/platform-language.js.map +1 -1
  189. package/dist/price-books.d.ts +47 -43
  190. package/dist/price-books.d.ts.map +1 -1
  191. package/dist/price-books.js +6 -2
  192. package/dist/price-books.js.map +1 -1
  193. package/dist/price-lists.d.ts +48 -14
  194. package/dist/price-lists.d.ts.map +1 -1
  195. package/dist/price-lists.js +24 -1
  196. package/dist/price-lists.js.map +1 -1
  197. package/dist/product-feeds.d.ts +144 -84
  198. package/dist/product-feeds.d.ts.map +1 -1
  199. package/dist/product-feeds.js +23 -0
  200. package/dist/product-feeds.js.map +1 -1
  201. package/dist/product-scope-model.d.ts +161 -0
  202. package/dist/product-scope-model.d.ts.map +1 -0
  203. package/dist/product-scope-model.js +161 -0
  204. package/dist/product-scope-model.js.map +1 -0
  205. package/dist/product-scope-overrides.d.ts +0 -103
  206. package/dist/product-scope-overrides.d.ts.map +1 -1
  207. package/dist/product-scope-overrides.js +0 -54
  208. package/dist/product-scope-overrides.js.map +1 -1
  209. package/dist/product-scoped-values.d.ts +2610 -0
  210. package/dist/product-scoped-values.d.ts.map +1 -0
  211. package/dist/product-scoped-values.js +425 -0
  212. package/dist/product-scoped-values.js.map +1 -0
  213. package/dist/product-scopes.d.ts +746 -0
  214. package/dist/product-scopes.d.ts.map +1 -0
  215. package/dist/product-scopes.js +436 -0
  216. package/dist/product-scopes.js.map +1 -0
  217. package/dist/product-summary-text.d.ts +23 -0
  218. package/dist/product-summary-text.d.ts.map +1 -0
  219. package/dist/product-summary-text.js +64 -0
  220. package/dist/product-summary-text.js.map +1 -0
  221. package/dist/product-tax-rates.d.ts +38 -0
  222. package/dist/product-tax-rates.d.ts.map +1 -0
  223. package/dist/product-tax-rates.js +45 -0
  224. package/dist/product-tax-rates.js.map +1 -0
  225. package/dist/product-url-keys.d.ts +210 -0
  226. package/dist/product-url-keys.d.ts.map +1 -0
  227. package/dist/product-url-keys.js +200 -0
  228. package/dist/product-url-keys.js.map +1 -0
  229. package/dist/product-value-resolver.d.ts +37 -60
  230. package/dist/product-value-resolver.d.ts.map +1 -1
  231. package/dist/product-value-resolver.js +36 -96
  232. package/dist/product-value-resolver.js.map +1 -1
  233. package/dist/projects.d.ts +2370 -0
  234. package/dist/projects.d.ts.map +1 -0
  235. package/dist/projects.js +843 -0
  236. package/dist/projects.js.map +1 -0
  237. package/dist/promotions.d.ts +10 -10
  238. package/dist/prompt-actions.d.ts +19 -1
  239. package/dist/prompt-actions.d.ts.map +1 -1
  240. package/dist/prompt-actions.js +31 -2
  241. package/dist/prompt-actions.js.map +1 -1
  242. package/dist/pwa.d.ts +2 -2
  243. package/dist/quick-order.d.ts +150 -7
  244. package/dist/quick-order.d.ts.map +1 -1
  245. package/dist/quick-order.js +76 -2
  246. package/dist/quick-order.js.map +1 -1
  247. package/dist/quote-requests.d.ts +99 -13
  248. package/dist/quote-requests.d.ts.map +1 -1
  249. package/dist/quote-requests.js +66 -1
  250. package/dist/quote-requests.js.map +1 -1
  251. package/dist/record-references.d.ts +252 -0
  252. package/dist/record-references.d.ts.map +1 -0
  253. package/dist/record-references.js +178 -0
  254. package/dist/record-references.js.map +1 -0
  255. package/dist/record-rich-text.d.ts +66 -0
  256. package/dist/record-rich-text.d.ts.map +1 -0
  257. package/dist/record-rich-text.js +304 -0
  258. package/dist/record-rich-text.js.map +1 -0
  259. package/dist/returns.d.ts +234 -52
  260. package/dist/returns.d.ts.map +1 -1
  261. package/dist/returns.js +139 -26
  262. package/dist/returns.js.map +1 -1
  263. package/dist/sales-channels.d.ts +51 -7
  264. package/dist/sales-channels.d.ts.map +1 -1
  265. package/dist/sales-channels.js +38 -4
  266. package/dist/sales-channels.js.map +1 -1
  267. package/dist/saved-list-views.d.ts +56 -0
  268. package/dist/saved-list-views.d.ts.map +1 -1
  269. package/dist/saved-list-views.js +27 -1
  270. package/dist/saved-list-views.js.map +1 -1
  271. package/dist/scoped-write-encoding.d.ts +100 -0
  272. package/dist/scoped-write-encoding.d.ts.map +1 -0
  273. package/dist/scoped-write-encoding.js +135 -0
  274. package/dist/scoped-write-encoding.js.map +1 -0
  275. package/dist/search.d.ts +25 -15
  276. package/dist/search.d.ts.map +1 -1
  277. package/dist/seo.d.ts +127 -15
  278. package/dist/seo.d.ts.map +1 -1
  279. package/dist/seo.js +38 -4
  280. package/dist/seo.js.map +1 -1
  281. package/dist/settings.d.ts +161 -3
  282. package/dist/settings.d.ts.map +1 -1
  283. package/dist/settings.js +73 -3
  284. package/dist/settings.js.map +1 -1
  285. package/dist/shopping-lists.d.ts +24 -3
  286. package/dist/shopping-lists.d.ts.map +1 -1
  287. package/dist/shopping-lists.js +20 -0
  288. package/dist/shopping-lists.js.map +1 -1
  289. package/dist/storefront-cache-tags.d.ts +41 -0
  290. package/dist/storefront-cache-tags.d.ts.map +1 -1
  291. package/dist/storefront-cache-tags.js +36 -0
  292. package/dist/storefront-cache-tags.js.map +1 -1
  293. package/dist/storefront-language-path.d.ts +77 -0
  294. package/dist/storefront-language-path.d.ts.map +1 -0
  295. package/dist/storefront-language-path.js +123 -0
  296. package/dist/storefront-language-path.js.map +1 -0
  297. package/dist/storefront-value-overrides.d.ts +18 -56
  298. package/dist/storefront-value-overrides.d.ts.map +1 -1
  299. package/dist/storefront-value-overrides.js +11 -86
  300. package/dist/storefront-value-overrides.js.map +1 -1
  301. package/dist/tasks.d.ts +2842 -0
  302. package/dist/tasks.d.ts.map +1 -0
  303. package/dist/tasks.js +901 -0
  304. package/dist/tasks.js.map +1 -0
  305. package/dist/transactional-emails.d.ts +14 -11
  306. package/dist/transactional-emails.d.ts.map +1 -1
  307. package/dist/transactional-emails.js +13 -0
  308. package/dist/transactional-emails.js.map +1 -1
  309. package/package.json +3 -3
package/dist/cms.d.ts CHANGED
@@ -1,9 +1,29 @@
1
1
  import { z } from 'zod';
2
+ import { type ChannelUrlFacts } from './storefront-language-path.js';
2
3
  export declare const cmsPageStatusSchema: z.ZodEnum<{
4
+ archived: "archived";
3
5
  draft: "draft";
4
6
  published: "published";
5
- archived: "archived";
6
7
  }>;
8
+ /**
9
+ * One language's own name, slug and description of a CMS page
10
+ * (`specs/163-page-builder-marketing-pages/` R24, issue #521). Every field is
11
+ * optional: an absent or blank one inherits the page's own field, which stays
12
+ * the default for every language that does not override it.
13
+ */
14
+ export declare const cmsPageTranslationSchema: z.ZodObject<{
15
+ name: z.ZodOptional<z.ZodString>;
16
+ slug: z.ZodOptional<z.ZodString>;
17
+ description: z.ZodOptional<z.ZodString>;
18
+ }, z.core.$strip>;
19
+ export type CmsPageTranslation = z.infer<typeof cmsPageTranslationSchema>;
20
+ /** The per-language overrides of a CMS page, by BCP-47 language code (R24). */
21
+ export declare const cmsPageTranslationsSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
22
+ name: z.ZodOptional<z.ZodString>;
23
+ slug: z.ZodOptional<z.ZodString>;
24
+ description: z.ZodOptional<z.ZodString>;
25
+ }, z.core.$strip>>;
26
+ export type CmsPageTranslations = z.infer<typeof cmsPageTranslationsSchema>;
7
27
  export type CmsPageStatus = z.infer<typeof cmsPageStatusSchema>;
8
28
  export declare const cmsContentEnvelopeSchema: z.ZodObject<{
9
29
  schema_version: z.ZodOptional<z.ZodNumber>;
@@ -15,9 +35,9 @@ export declare const cmsPageSummarySchema: z.ZodObject<{
15
35
  name: z.ZodString;
16
36
  slug: z.ZodString;
17
37
  status: z.ZodEnum<{
38
+ archived: "archived";
18
39
  draft: "draft";
19
40
  published: "published";
20
- archived: "archived";
21
41
  }>;
22
42
  active: z.ZodBoolean;
23
43
  description: z.ZodNullable<z.ZodString>;
@@ -26,16 +46,34 @@ export declare const cmsPageSummarySchema: z.ZodObject<{
26
46
  version: z.ZodNumber;
27
47
  createdAt: z.ZodString;
28
48
  updatedAt: z.ZodString;
49
+ parentPageId: z.ZodNullable<z.ZodString>;
50
+ parentPathInUrl: z.ZodBoolean;
51
+ shadowedByLanguagePrefix: z.ZodOptional<z.ZodObject<{
52
+ prefix: z.ZodString;
53
+ channelCodes: z.ZodArray<z.ZodString>;
54
+ }, z.core.$strip>>;
55
+ translations: z.ZodRecord<z.ZodString, z.ZodObject<{
56
+ name: z.ZodOptional<z.ZodString>;
57
+ slug: z.ZodOptional<z.ZodString>;
58
+ description: z.ZodOptional<z.ZodString>;
59
+ }, z.core.$strip>>;
29
60
  }, z.core.$strip>;
30
61
  export type CmsPageSummary = z.infer<typeof cmsPageSummarySchema>;
62
+ /** The breadcrumb colour scheme of a page (feature 163, FR-031). */
63
+ export declare const cmsBreadcrumbsSchemeSchema: z.ZodEnum<{
64
+ muted: "muted";
65
+ light: "light";
66
+ dark: "dark";
67
+ }>;
68
+ export type CmsBreadcrumbsScheme = z.infer<typeof cmsBreadcrumbsSchemeSchema>;
31
69
  export declare const cmsPageDetailSchema: z.ZodObject<{
32
70
  id: z.ZodString;
33
71
  name: z.ZodString;
34
72
  slug: z.ZodString;
35
73
  status: z.ZodEnum<{
74
+ archived: "archived";
36
75
  draft: "draft";
37
76
  published: "published";
38
- archived: "archived";
39
77
  }>;
40
78
  active: z.ZodBoolean;
41
79
  description: z.ZodNullable<z.ZodString>;
@@ -44,6 +82,17 @@ export declare const cmsPageDetailSchema: z.ZodObject<{
44
82
  version: z.ZodNumber;
45
83
  createdAt: z.ZodString;
46
84
  updatedAt: z.ZodString;
85
+ parentPageId: z.ZodNullable<z.ZodString>;
86
+ parentPathInUrl: z.ZodBoolean;
87
+ shadowedByLanguagePrefix: z.ZodOptional<z.ZodObject<{
88
+ prefix: z.ZodString;
89
+ channelCodes: z.ZodArray<z.ZodString>;
90
+ }, z.core.$strip>>;
91
+ translations: z.ZodRecord<z.ZodString, z.ZodObject<{
92
+ name: z.ZodOptional<z.ZodString>;
93
+ slug: z.ZodOptional<z.ZodString>;
94
+ description: z.ZodOptional<z.ZodString>;
95
+ }, z.core.$strip>>;
47
96
  meta: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
48
97
  title: z.ZodOptional<z.ZodString>;
49
98
  description: z.ZodOptional<z.ZodString>;
@@ -53,6 +102,14 @@ export declare const cmsPageDetailSchema: z.ZodObject<{
53
102
  schema_version: z.ZodOptional<z.ZodNumber>;
54
103
  languages: z.ZodRecord<z.ZodString, z.ZodUnknown>;
55
104
  }, z.core.$strip>;
105
+ breadcrumbsVisible: z.ZodBoolean;
106
+ breadcrumbsScheme: z.ZodEnum<{
107
+ muted: "muted";
108
+ light: "light";
109
+ dark: "dark";
110
+ }>;
111
+ breadcrumbsOverlay: z.ZodBoolean;
112
+ shareImageAssetId: z.ZodNullable<z.ZodString>;
56
113
  }, z.core.$strip>;
57
114
  export type CmsPageDetail = z.infer<typeof cmsPageDetailSchema>;
58
115
  export declare const createCmsPageRequestSchema: z.ZodObject<{
@@ -67,6 +124,21 @@ export declare const createCmsPageRequestSchema: z.ZodObject<{
67
124
  description: z.ZodOptional<z.ZodString>;
68
125
  keywords: z.ZodOptional<z.ZodString>;
69
126
  }, z.core.$strip>>>;
127
+ parentPageId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
128
+ breadcrumbsVisible: z.ZodOptional<z.ZodBoolean>;
129
+ breadcrumbsScheme: z.ZodOptional<z.ZodEnum<{
130
+ muted: "muted";
131
+ light: "light";
132
+ dark: "dark";
133
+ }>>;
134
+ breadcrumbsOverlay: z.ZodOptional<z.ZodBoolean>;
135
+ shareImageAssetId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
136
+ parentPathInUrl: z.ZodOptional<z.ZodBoolean>;
137
+ translations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
138
+ name: z.ZodOptional<z.ZodString>;
139
+ slug: z.ZodOptional<z.ZodString>;
140
+ description: z.ZodOptional<z.ZodString>;
141
+ }, z.core.$strip>>>;
70
142
  }, z.core.$strip>;
71
143
  export type CreateCmsPageRequest = z.infer<typeof createCmsPageRequestSchema>;
72
144
  export declare const patchCmsPageRequestSchema: z.ZodObject<{
@@ -81,6 +153,21 @@ export declare const patchCmsPageRequestSchema: z.ZodObject<{
81
153
  description: z.ZodOptional<z.ZodString>;
82
154
  keywords: z.ZodOptional<z.ZodString>;
83
155
  }, z.core.$strip>>>>;
156
+ parentPageId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
157
+ breadcrumbsVisible: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
158
+ breadcrumbsScheme: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
159
+ muted: "muted";
160
+ light: "light";
161
+ dark: "dark";
162
+ }>>>;
163
+ breadcrumbsOverlay: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
164
+ shareImageAssetId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
165
+ parentPathInUrl: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
166
+ translations: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
167
+ name: z.ZodOptional<z.ZodString>;
168
+ slug: z.ZodOptional<z.ZodString>;
169
+ description: z.ZodOptional<z.ZodString>;
170
+ }, z.core.$strip>>>>;
84
171
  version: z.ZodOptional<z.ZodNumber>;
85
172
  }, z.core.$strip>;
86
173
  export type PatchCmsPageRequest = z.infer<typeof patchCmsPageRequestSchema>;
@@ -244,8 +331,8 @@ export type CmsHookAttachmentRequest = z.infer<typeof cmsHookAttachmentRequestSc
244
331
  * document blocks — never reach the CMS or e-mail palettes.
245
332
  */
246
333
  export declare const pageBuilderContextSchema: z.ZodEnum<{
247
- cms: "cms";
248
334
  email: "email";
335
+ cms: "cms";
249
336
  invoice: "invoice";
250
337
  newsletter: "newsletter";
251
338
  document: "document";
@@ -261,12 +348,12 @@ export declare const cmsFieldDescriptorSchema: z.ZodObject<{
261
348
  number: "number";
262
349
  object: "object";
263
350
  array: "array";
264
- uuid: "uuid";
265
351
  text: "text";
266
- textarea: "textarea";
352
+ external: "external";
267
353
  select: "select";
354
+ uuid: "uuid";
355
+ textarea: "textarea";
268
356
  radio: "radio";
269
- external: "external";
270
357
  richtext: "richtext";
271
358
  }>;
272
359
  label: z.ZodOptional<z.ZodString>;
@@ -385,8 +472,8 @@ export declare const BlockDefinitionSchema: z.ZodObject<{
385
472
  descriptionKey: z.ZodOptional<z.ZodString>;
386
473
  category: z.ZodString;
387
474
  contexts: z.ZodArray<z.ZodEnum<{
388
- cms: "cms";
389
475
  email: "email";
476
+ cms: "cms";
390
477
  invoice: "invoice";
391
478
  newsletter: "newsletter";
392
479
  document: "document";
@@ -396,12 +483,12 @@ export declare const BlockDefinitionSchema: z.ZodObject<{
396
483
  number: "number";
397
484
  object: "object";
398
485
  array: "array";
399
- uuid: "uuid";
400
486
  text: "text";
401
- textarea: "textarea";
487
+ external: "external";
402
488
  select: "select";
489
+ uuid: "uuid";
490
+ textarea: "textarea";
403
491
  radio: "radio";
404
- external: "external";
405
492
  richtext: "richtext";
406
493
  }>;
407
494
  label: z.ZodOptional<z.ZodString>;
@@ -457,8 +544,8 @@ export declare const BlockCategorySchema: z.ZodObject<{
457
544
  key: z.ZodString;
458
545
  titleKey: z.ZodString;
459
546
  contexts: z.ZodArray<z.ZodEnum<{
460
- cms: "cms";
461
547
  email: "email";
548
+ cms: "cms";
462
549
  invoice: "invoice";
463
550
  newsletter: "newsletter";
464
551
  document: "document";
@@ -489,6 +576,299 @@ export declare const cmsPageBuilderDescriptorSchema: z.ZodObject<{
489
576
  name: z.ZodString;
490
577
  hex: z.ZodString;
491
578
  }, z.core.$strip>>>;
579
+ brandTokens: z.ZodOptional<z.ZodObject<{
580
+ version: z.ZodLiteral<1>;
581
+ colors: z.ZodObject<{
582
+ primary: z.ZodString;
583
+ primaryHover: z.ZodString;
584
+ secondary: z.ZodString;
585
+ secondaryHover: z.ZodString;
586
+ neutral: z.ZodObject<{
587
+ 50: z.ZodString;
588
+ 100: z.ZodString;
589
+ 200: z.ZodString;
590
+ 300: z.ZodString;
591
+ 400: z.ZodString;
592
+ 500: z.ZodString;
593
+ 600: z.ZodString;
594
+ 700: z.ZodString;
595
+ 800: z.ZodString;
596
+ 900: z.ZodString;
597
+ }, z.core.$strip>;
598
+ onPrimary: z.ZodString;
599
+ onSecondary: z.ZodString;
600
+ }, z.core.$strip>;
601
+ accentGradient: z.ZodObject<{
602
+ from: z.ZodString;
603
+ to: z.ZodString;
604
+ angle: z.ZodNumber;
605
+ }, z.core.$strip>;
606
+ schemes: z.ZodObject<{
607
+ muted: z.ZodObject<{
608
+ background: z.ZodString;
609
+ text: z.ZodString;
610
+ textMuted: z.ZodString;
611
+ border: z.ZodString;
612
+ link: z.ZodString;
613
+ decorativeAssetId: z.ZodOptional<z.ZodString>;
614
+ decorativeUrl: z.ZodOptional<z.ZodString>;
615
+ }, z.core.$strip>;
616
+ light: z.ZodObject<{
617
+ background: z.ZodString;
618
+ text: z.ZodString;
619
+ textMuted: z.ZodString;
620
+ border: z.ZodString;
621
+ link: z.ZodString;
622
+ decorativeAssetId: z.ZodOptional<z.ZodString>;
623
+ decorativeUrl: z.ZodOptional<z.ZodString>;
624
+ }, z.core.$strip>;
625
+ dark: z.ZodObject<{
626
+ background: z.ZodString;
627
+ text: z.ZodString;
628
+ textMuted: z.ZodString;
629
+ border: z.ZodString;
630
+ link: z.ZodString;
631
+ decorativeAssetId: z.ZodOptional<z.ZodString>;
632
+ decorativeUrl: z.ZodOptional<z.ZodString>;
633
+ }, z.core.$strip>;
634
+ }, z.core.$strip>;
635
+ fonts: z.ZodObject<{
636
+ heading: z.ZodDiscriminatedUnion<[z.ZodObject<{
637
+ kind: z.ZodLiteral<"system">;
638
+ stack: z.ZodEnum<{
639
+ serif: "serif";
640
+ sans: "sans";
641
+ mono: "mono";
642
+ }>;
643
+ }, z.core.$strip>, z.ZodObject<{
644
+ kind: z.ZodLiteral<"asset">;
645
+ family: z.ZodString;
646
+ generic: z.ZodEnum<{
647
+ "sans-serif": "sans-serif";
648
+ serif: "serif";
649
+ }>;
650
+ faces: z.ZodArray<z.ZodObject<{
651
+ weight: z.ZodNumber;
652
+ style: z.ZodEnum<{
653
+ italic: "italic";
654
+ normal: "normal";
655
+ }>;
656
+ fileAssetId: z.ZodString;
657
+ }, z.core.$strip>>;
658
+ }, z.core.$strip>, z.ZodObject<{
659
+ kind: z.ZodLiteral<"stylesheet">;
660
+ family: z.ZodString;
661
+ generic: z.ZodEnum<{
662
+ "sans-serif": "sans-serif";
663
+ serif: "serif";
664
+ }>;
665
+ url: z.ZodString;
666
+ }, z.core.$strip>], "kind">;
667
+ body: z.ZodDiscriminatedUnion<[z.ZodObject<{
668
+ kind: z.ZodLiteral<"system">;
669
+ stack: z.ZodEnum<{
670
+ serif: "serif";
671
+ sans: "sans";
672
+ mono: "mono";
673
+ }>;
674
+ }, z.core.$strip>, z.ZodObject<{
675
+ kind: z.ZodLiteral<"asset">;
676
+ family: z.ZodString;
677
+ generic: z.ZodEnum<{
678
+ "sans-serif": "sans-serif";
679
+ serif: "serif";
680
+ }>;
681
+ faces: z.ZodArray<z.ZodObject<{
682
+ weight: z.ZodNumber;
683
+ style: z.ZodEnum<{
684
+ italic: "italic";
685
+ normal: "normal";
686
+ }>;
687
+ fileAssetId: z.ZodString;
688
+ }, z.core.$strip>>;
689
+ }, z.core.$strip>, z.ZodObject<{
690
+ kind: z.ZodLiteral<"stylesheet">;
691
+ family: z.ZodString;
692
+ generic: z.ZodEnum<{
693
+ "sans-serif": "sans-serif";
694
+ serif: "serif";
695
+ }>;
696
+ url: z.ZodString;
697
+ }, z.core.$strip>], "kind">;
698
+ }, z.core.$strip>;
699
+ typeScale: z.ZodObject<{
700
+ small: z.ZodObject<{
701
+ mobilePx: z.ZodNumber;
702
+ desktopPx: z.ZodNumber;
703
+ lineHeight: z.ZodNumber;
704
+ weight: z.ZodUnion<readonly [z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>]>;
705
+ trackingEm: z.ZodNumber;
706
+ font: z.ZodEnum<{
707
+ body: "body";
708
+ heading: "heading";
709
+ }>;
710
+ }, z.core.$strip>;
711
+ display: z.ZodObject<{
712
+ mobilePx: z.ZodNumber;
713
+ desktopPx: z.ZodNumber;
714
+ lineHeight: z.ZodNumber;
715
+ weight: z.ZodUnion<readonly [z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>]>;
716
+ trackingEm: z.ZodNumber;
717
+ font: z.ZodEnum<{
718
+ body: "body";
719
+ heading: "heading";
720
+ }>;
721
+ }, z.core.$strip>;
722
+ h1: z.ZodObject<{
723
+ mobilePx: z.ZodNumber;
724
+ desktopPx: z.ZodNumber;
725
+ lineHeight: z.ZodNumber;
726
+ weight: z.ZodUnion<readonly [z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>]>;
727
+ trackingEm: z.ZodNumber;
728
+ font: z.ZodEnum<{
729
+ body: "body";
730
+ heading: "heading";
731
+ }>;
732
+ }, z.core.$strip>;
733
+ h2: z.ZodObject<{
734
+ mobilePx: z.ZodNumber;
735
+ desktopPx: z.ZodNumber;
736
+ lineHeight: z.ZodNumber;
737
+ weight: z.ZodUnion<readonly [z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>]>;
738
+ trackingEm: z.ZodNumber;
739
+ font: z.ZodEnum<{
740
+ body: "body";
741
+ heading: "heading";
742
+ }>;
743
+ }, z.core.$strip>;
744
+ h3: z.ZodObject<{
745
+ mobilePx: z.ZodNumber;
746
+ desktopPx: z.ZodNumber;
747
+ lineHeight: z.ZodNumber;
748
+ weight: z.ZodUnion<readonly [z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>]>;
749
+ trackingEm: z.ZodNumber;
750
+ font: z.ZodEnum<{
751
+ body: "body";
752
+ heading: "heading";
753
+ }>;
754
+ }, z.core.$strip>;
755
+ h4: z.ZodObject<{
756
+ mobilePx: z.ZodNumber;
757
+ desktopPx: z.ZodNumber;
758
+ lineHeight: z.ZodNumber;
759
+ weight: z.ZodUnion<readonly [z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>]>;
760
+ trackingEm: z.ZodNumber;
761
+ font: z.ZodEnum<{
762
+ body: "body";
763
+ heading: "heading";
764
+ }>;
765
+ }, z.core.$strip>;
766
+ h5: z.ZodObject<{
767
+ mobilePx: z.ZodNumber;
768
+ desktopPx: z.ZodNumber;
769
+ lineHeight: z.ZodNumber;
770
+ weight: z.ZodUnion<readonly [z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>]>;
771
+ trackingEm: z.ZodNumber;
772
+ font: z.ZodEnum<{
773
+ body: "body";
774
+ heading: "heading";
775
+ }>;
776
+ }, z.core.$strip>;
777
+ h6: z.ZodObject<{
778
+ mobilePx: z.ZodNumber;
779
+ desktopPx: z.ZodNumber;
780
+ lineHeight: z.ZodNumber;
781
+ weight: z.ZodUnion<readonly [z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>]>;
782
+ trackingEm: z.ZodNumber;
783
+ font: z.ZodEnum<{
784
+ body: "body";
785
+ heading: "heading";
786
+ }>;
787
+ }, z.core.$strip>;
788
+ lead: z.ZodObject<{
789
+ mobilePx: z.ZodNumber;
790
+ desktopPx: z.ZodNumber;
791
+ lineHeight: z.ZodNumber;
792
+ weight: z.ZodUnion<readonly [z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>]>;
793
+ trackingEm: z.ZodNumber;
794
+ font: z.ZodEnum<{
795
+ body: "body";
796
+ heading: "heading";
797
+ }>;
798
+ }, z.core.$strip>;
799
+ body: z.ZodObject<{
800
+ mobilePx: z.ZodNumber;
801
+ desktopPx: z.ZodNumber;
802
+ lineHeight: z.ZodNumber;
803
+ weight: z.ZodUnion<readonly [z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>, z.ZodLiteral<800>]>;
804
+ trackingEm: z.ZodNumber;
805
+ font: z.ZodEnum<{
806
+ body: "body";
807
+ heading: "heading";
808
+ }>;
809
+ }, z.core.$strip>;
810
+ }, z.core.$strip>;
811
+ buttons: z.ZodObject<{
812
+ radius: z.ZodEnum<{
813
+ pill: "pill";
814
+ square: "square";
815
+ rounded: "rounded";
816
+ }>;
817
+ heights: z.ZodObject<{
818
+ small: z.ZodNumber;
819
+ medium: z.ZodNumber;
820
+ large: z.ZodNumber;
821
+ }, z.core.$strip>;
822
+ fontWeight: z.ZodUnion<readonly [z.ZodLiteral<400>, z.ZodLiteral<500>, z.ZodLiteral<600>, z.ZodLiteral<700>]>;
823
+ textTransform: z.ZodEnum<{
824
+ none: "none";
825
+ uppercase: "uppercase";
826
+ }>;
827
+ }, z.core.$strip>;
828
+ spacing: z.ZodObject<{
829
+ none: z.ZodObject<{
830
+ mobilePx: z.ZodNumber;
831
+ desktopPx: z.ZodNumber;
832
+ }, z.core.$strip>;
833
+ l: z.ZodObject<{
834
+ mobilePx: z.ZodNumber;
835
+ desktopPx: z.ZodNumber;
836
+ }, z.core.$strip>;
837
+ xs: z.ZodObject<{
838
+ mobilePx: z.ZodNumber;
839
+ desktopPx: z.ZodNumber;
840
+ }, z.core.$strip>;
841
+ s: z.ZodObject<{
842
+ mobilePx: z.ZodNumber;
843
+ desktopPx: z.ZodNumber;
844
+ }, z.core.$strip>;
845
+ m: z.ZodObject<{
846
+ mobilePx: z.ZodNumber;
847
+ desktopPx: z.ZodNumber;
848
+ }, z.core.$strip>;
849
+ xl: z.ZodObject<{
850
+ mobilePx: z.ZodNumber;
851
+ desktopPx: z.ZodNumber;
852
+ }, z.core.$strip>;
853
+ xxl: z.ZodObject<{
854
+ mobilePx: z.ZodNumber;
855
+ desktopPx: z.ZodNumber;
856
+ }, z.core.$strip>;
857
+ }, z.core.$strip>;
858
+ layout: z.ZodObject<{
859
+ containerMaxPx: z.ZodNumber;
860
+ widePx: z.ZodNumber;
861
+ gutterMobilePx: z.ZodNumber;
862
+ gutterDesktopPx: z.ZodNumber;
863
+ }, z.core.$strip>;
864
+ tierScale: z.ZodOptional<z.ZodObject<{
865
+ tablet: z.ZodOptional<z.ZodNumber>;
866
+ smallDesktop: z.ZodOptional<z.ZodNumber>;
867
+ fluidDesktop: z.ZodOptional<z.ZodBoolean>;
868
+ fluidUntilPx: z.ZodOptional<z.ZodNumber>;
869
+ buttons: z.ZodOptional<z.ZodBoolean>;
870
+ }, z.core.$strip>>;
871
+ }, z.core.$strip>>;
492
872
  components: z.ZodArray<z.ZodObject<{
493
873
  name: z.ZodString;
494
874
  ownerModule: z.ZodString;
@@ -497,12 +877,12 @@ export declare const cmsPageBuilderDescriptorSchema: z.ZodObject<{
497
877
  number: "number";
498
878
  object: "object";
499
879
  array: "array";
500
- uuid: "uuid";
501
880
  text: "text";
502
- textarea: "textarea";
881
+ external: "external";
503
882
  select: "select";
883
+ uuid: "uuid";
884
+ textarea: "textarea";
504
885
  radio: "radio";
505
- external: "external";
506
886
  richtext: "richtext";
507
887
  }>;
508
888
  label: z.ZodOptional<z.ZodString>;
@@ -515,8 +895,8 @@ export declare const cmsPageBuilderDescriptorSchema: z.ZodObject<{
515
895
  }, z.core.$strip>>;
516
896
  previewIcon: z.ZodOptional<z.ZodString>;
517
897
  contexts: z.ZodOptional<z.ZodArray<z.ZodEnum<{
518
- cms: "cms";
519
898
  email: "email";
899
+ cms: "cms";
520
900
  invoice: "invoice";
521
901
  newsletter: "newsletter";
522
902
  document: "document";
@@ -540,8 +920,8 @@ export declare const cmsPageBuilderDescriptorSchema: z.ZodObject<{
540
920
  key: z.ZodString;
541
921
  titleKey: z.ZodString;
542
922
  contexts: z.ZodArray<z.ZodEnum<{
543
- cms: "cms";
544
923
  email: "email";
924
+ cms: "cms";
545
925
  invoice: "invoice";
546
926
  newsletter: "newsletter";
547
927
  document: "document";
@@ -584,6 +964,12 @@ export type CmsResolvedTemplate = CmsResolvedBlock;
584
964
  export declare const cmsResolvedPageSchema: z.ZodObject<{
585
965
  id: z.ZodString;
586
966
  slug: z.ZodString;
967
+ path: z.ZodOptional<z.ZodString>;
968
+ url: z.ZodOptional<z.ZodString>;
969
+ alternates: z.ZodOptional<z.ZodArray<z.ZodObject<{
970
+ language: z.ZodString;
971
+ url: z.ZodString;
972
+ }, z.core.$strip>>>;
587
973
  name: z.ZodString;
588
974
  language: z.ZodString;
589
975
  meta: z.ZodObject<{
@@ -622,6 +1008,24 @@ export declare const cmsResolvedPageSchema: z.ZodObject<{
622
1008
  private: "private";
623
1009
  }>;
624
1010
  }, z.core.$strip>>;
1011
+ breadcrumbs: z.ZodObject<{
1012
+ visible: z.ZodBoolean;
1013
+ scheme: z.ZodEnum<{
1014
+ muted: "muted";
1015
+ light: "light";
1016
+ dark: "dark";
1017
+ }>;
1018
+ overlay: z.ZodOptional<z.ZodBoolean>;
1019
+ trail: z.ZodArray<z.ZodObject<{
1020
+ name: z.ZodString;
1021
+ slug: z.ZodNullable<z.ZodString>;
1022
+ path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1023
+ }, z.core.$strip>>;
1024
+ }, z.core.$strip>;
1025
+ share: z.ZodObject<{
1026
+ imageUrl: z.ZodNullable<z.ZodString>;
1027
+ }, z.core.$strip>;
1028
+ languages: z.ZodArray<z.ZodString>;
625
1029
  }, z.core.$strip>;
626
1030
  export type CmsResolvedPage = z.infer<typeof cmsResolvedPageSchema>;
627
1031
  export declare const cmsResolvedHookSchema: z.ZodObject<{
@@ -655,6 +1059,12 @@ export type CmsResolvedHook = z.infer<typeof cmsResolvedHookSchema>;
655
1059
  */
656
1060
  export declare const cmsPageIndexEntrySchema: z.ZodObject<{
657
1061
  slug: z.ZodString;
1062
+ path: z.ZodOptional<z.ZodString>;
1063
+ url: z.ZodOptional<z.ZodString>;
1064
+ alternates: z.ZodOptional<z.ZodArray<z.ZodObject<{
1065
+ language: z.ZodString;
1066
+ url: z.ZodString;
1067
+ }, z.core.$strip>>>;
658
1068
  updatedAt: z.ZodString;
659
1069
  }, z.core.$strip>;
660
1070
  export type CmsPageIndexEntry = z.infer<typeof cmsPageIndexEntrySchema>;
@@ -662,6 +1072,12 @@ export type CmsPageIndexEntry = z.infer<typeof cmsPageIndexEntrySchema>;
662
1072
  export declare const cmsPageIndexResponseSchema: z.ZodObject<{
663
1073
  pages: z.ZodArray<z.ZodObject<{
664
1074
  slug: z.ZodString;
1075
+ path: z.ZodOptional<z.ZodString>;
1076
+ url: z.ZodOptional<z.ZodString>;
1077
+ alternates: z.ZodOptional<z.ZodArray<z.ZodObject<{
1078
+ language: z.ZodString;
1079
+ url: z.ZodString;
1080
+ }, z.core.$strip>>>;
665
1081
  updatedAt: z.ZodString;
666
1082
  }, z.core.$strip>>;
667
1083
  }, z.core.$strip>;
@@ -694,6 +1110,87 @@ export type CmsReservedSegmentsResponse = z.infer<typeof cmsReservedSegmentsResp
694
1110
  * disagree — the discipline `blockNameRe` and `slugify` already keep.
695
1111
  */
696
1112
  export declare function firstSlugSegment(slug: string): string;
1113
+ /**
1114
+ * How many slugs a public path may join — the page tree's own depth limit
1115
+ * (`CMS_PAGE_TREE_MAX_DEPTH`, research R-18), so a well-formed tree always has
1116
+ * its whole path and a stored chain that is too deep still terminates.
1117
+ */
1118
+ export declare const CMS_PAGE_PATH_MAX_LEVELS = 8;
1119
+ /** One page as the public-path rule reads it, in one sales channel. */
1120
+ export interface CmsPagePathNode {
1121
+ id: string;
1122
+ /** The slug the channel serves the page under. */
1123
+ slug: string;
1124
+ parentPageId: string | null;
1125
+ parentPathInUrl: boolean;
1126
+ }
1127
+ /**
1128
+ * The public path of every page in one sales channel, without a leading slash
1129
+ * (`specs/163-page-builder-marketing-pages/` R19D, T280).
1130
+ *
1131
+ * A page that does not include its parent's path is served at its own slug —
1132
+ * every page stored before the option existed, unchanged. A page that does is
1133
+ * served at its parent's public path, a `/`, and its own slug; the parent's
1134
+ * path is computed by the same rule, so the prefix runs up the tree until an
1135
+ * ancestor that did not opt in. It falls back to the page's own slug when the
1136
+ * parent is not among `nodes` (the channel does not serve it), when the chain
1137
+ * loops, or when it would join more than `CMS_PAGE_PATH_MAX_LEVELS` slugs —
1138
+ * the write side refuses the last two, so the fallback answers only stored
1139
+ * data that predates the refusal.
1140
+ *
1141
+ * **It lives here because three programs ask the question and must agree**:
1142
+ * the backend resolving a path and refusing a duplicate, the page editor
1143
+ * showing the address, and the storefront linking to it.
1144
+ */
1145
+ export declare function cmsPagePublicPaths(nodes: Iterable<CmsPagePathNode>): Map<string, string>;
1146
+ /** What `cmsLocalizedPage` reads of a page: its own fields and its overrides. */
1147
+ export interface CmsLocalizablePage {
1148
+ name: string;
1149
+ slug: string;
1150
+ description?: string | null;
1151
+ languages: readonly string[];
1152
+ /** Absent on a page read before R24. */
1153
+ translations?: CmsPageTranslations | null;
1154
+ }
1155
+ /**
1156
+ * A page's name, slug and description in one language
1157
+ * (`specs/163-page-builder-marketing-pages/` R24, issue #521): each field the
1158
+ * language overrides, else the page's own. A blank override inherits, and so
1159
+ * does every override of a language the page does not declare — removing a
1160
+ * language from a page keeps its overrides stored but stops them counting, so
1161
+ * adding it back restores them.
1162
+ *
1163
+ * **It lives here because three programs ask the question and must agree**: the
1164
+ * backend resolving and refusing a path, the page editor previewing the
1165
+ * address, and the storefront through what the backend answers.
1166
+ */
1167
+ export declare function cmsLocalizedPage(page: CmsLocalizablePage, language: string): {
1168
+ name: string;
1169
+ slug: string;
1170
+ description: string | null;
1171
+ };
1172
+ export interface CmsPageUrlInput {
1173
+ /** The page's public path in the language, with or without slashes. */
1174
+ path: string;
1175
+ /** The language the URL is for — already resolved against the page and channel. */
1176
+ languageCode: string;
1177
+ /**
1178
+ * The channel's URL-language facts (feature 167, `specs/167-storefront-locale-path/`):
1179
+ * its languages, default and *prefix the default language* setting.
1180
+ */
1181
+ channel: ChannelUrlFacts;
1182
+ }
1183
+ /**
1184
+ * The storefront URL of a CMS page: `/<path>` in the language, under that language's
1185
+ * path prefix (`/en/about`, or `/o-nas` for the default language of a channel that
1186
+ * does not prefix it) — the rule `productPath` states for a product. A page's slug
1187
+ * may differ in every language (R24), so the language travels with the URL as its
1188
+ * prefix; 163 R24's interim `?lang=` is never appended (feature 167, OR-7).
1189
+ *
1190
+ * The backend calls it for every CMS URL it answers — the resolved page's canonical
1191
+ * and alternates, the channel index.
1192
+ */
1193
+ export declare function cmsPageUrl(input: CmsPageUrlInput): string;
697
1194
  /**
698
1195
  * One thing pointing at a CMS object, as a delete guard reports it.
699
1196
  *
@@ -774,6 +1271,19 @@ export interface CmsPageRecord {
774
1271
  archivedAt: Date | null;
775
1272
  createdAt: Date;
776
1273
  updatedAt: Date;
1274
+ /** The breadcrumb parent (feature 163). Never part of the page's URL. */
1275
+ parentPageId: string | null;
1276
+ /**
1277
+ * The languages the page has content in (feature 167): the sitemap lists the page
1278
+ * under the prefix of each of these the channel serves. Absent — a record from a
1279
+ * reader that predates it — every channel language.
1280
+ */
1281
+ languages?: readonly string[];
1282
+ /**
1283
+ * 163 R24: the page's per-language name, slug and description overrides — the
1284
+ * sitemap lists each language at its own slug (`cmsLocalizedPage`). Absent: none.
1285
+ */
1286
+ translations?: CmsPageTranslations;
777
1287
  }
778
1288
  /**
779
1289
  * Container name: `cmsPageReadPort`. Owner: `cms`.
@@ -795,6 +1305,55 @@ export interface CmsPageReadPort {
795
1305
  findByIds(ids: readonly string[]): Promise<CmsPageRecord[]>;
796
1306
  /** Published pages only, ordered by path — the platform-wide enumeration. */
797
1307
  listPublished(): Promise<CmsPageRecord[]>;
1308
+ /**
1309
+ * A storefront link to each of these pages that the channel serves, in one
1310
+ * language: its localised name and its path in that language's page tree
1311
+ * (`specs/168-megamenu-navigation-bar/` plan R-8). The megamenu's page links
1312
+ * read this, so a link follows the page's slug per language (feature 163 R24)
1313
+ * and its parent's path (R19D). Pages the channel does not serve are absent.
1314
+ */
1315
+ findStorefrontLinks(ids: readonly string[], scope: CmsPageStorefrontLinkScope): Promise<CmsPageStorefrontLink[]>;
1316
+ /**
1317
+ * Feature 171 — the lower-case first slug segment of every page the channel serves,
1318
+ * in every language (its own slug and each translation's), so another module can
1319
+ * refuse an address a page already holds.
1320
+ */
1321
+ firstSegmentsInChannel(salesChannelId: string): Promise<string[]>;
1322
+ }
1323
+ /**
1324
+ * Feature 171 (`specs/171-blog-i18n-authors/` research R5) — a module that serves
1325
+ * first path segments of its own on the storefront (the blog's prefix) claims them
1326
+ * here, and CMS refuses a page slug that starts with a claimed segment, as it does a
1327
+ * language prefix (feature 167). CMS never names the contributor.
1328
+ */
1329
+ export interface CmsReservedSegmentContributor {
1330
+ /** The contributing module — a switched-off contributor claims nothing. */
1331
+ readonly contributorModuleId: string;
1332
+ /** The lower-case first segments the module serves in this channel. */
1333
+ segmentsFor(salesChannelId: string): Promise<string[]>;
1334
+ }
1335
+ /**
1336
+ * Container name: `cmsReservedSegmentRegistry`. Owner: `cms`. An ungated contribution
1337
+ * registry: a module pushes a contributor once, from a boot hook.
1338
+ */
1339
+ export interface CmsReservedSegmentRegistryPort {
1340
+ register(contributor: CmsReservedSegmentContributor): void;
1341
+ }
1342
+ /** Where a {@link CmsPageReadPort.findStorefrontLinks} link is served. */
1343
+ export interface CmsPageStorefrontLinkScope {
1344
+ salesChannelId: string;
1345
+ language: string;
1346
+ }
1347
+ /** A page as a link: what the navigation shows and where it leads. */
1348
+ export interface CmsPageStorefrontLink {
1349
+ id: string;
1350
+ name: string;
1351
+ /**
1352
+ * The page's logical path in the language, with no language prefix: the
1353
+ * storefront puts the current language's prefix on it, as on every menu link
1354
+ * (feature 167), so a menu cached per channel and language holds no URL facts.
1355
+ */
1356
+ url: string;
798
1357
  }
799
1358
  /**
800
1359
  * A predefined block a module asks `cms` to keep in place — feature 075 / D-87.