@riverbankcms/sdk 0.129.0 → 0.129.1

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 (260) hide show
  1. package/README.md +19 -256
  2. package/dist/{PreviewEditorSidebar-B43CJ0g_.mjs → PreviewEditorSidebar-DceRseRV.mjs} +3 -3
  3. package/dist/{PreviewEditorUI-DHirVkeM.mjs → PreviewEditorUI-BNunq3kk.mjs} +2 -2
  4. package/dist/{SdkPreviewModeRuntime-BJumZy1B.mjs → SdkPreviewModeRuntime-Bt87-62u.mjs} +3 -3
  5. package/dist/{SiteChromeCustomizeContext-D9SlpwEj.mjs → SiteChromeCustomizeContext-BLl-OlL4.mjs} +460 -393
  6. package/dist/_dts/ai/src/contracts/commandExposure.d.ts +1 -1
  7. package/dist/_dts/ai/src/contracts/proposals.d.ts +4897 -4897
  8. package/dist/_dts/api/src/index.d.ts +2 -1
  9. package/dist/_dts/api/src/sdk-event-management.d.ts +53 -0
  10. package/dist/_dts/api/src/sdk-event-schedule.d.ts +3 -6
  11. package/dist/_dts/api/src/sdkContracts.d.ts +37 -50
  12. package/dist/_dts/api/src/sdkThemeWire.d.ts +2595 -0
  13. package/dist/_dts/api/src/sitePlatformEndpoints.d.ts +13 -29
  14. package/dist/_dts/media-core/src/index.d.ts +1 -0
  15. package/dist/_dts/sdk/src/config/types.d.ts +4 -4
  16. package/dist/_dts/sdk/src/version.d.ts +1 -1
  17. package/dist/_dts/theme-core/src/buttons/index.d.ts +1 -0
  18. package/dist/_dts/theme-core/src/palette/index.d.ts +1 -0
  19. package/dist/_dts/theme-core/src/site-styles/headerLayoutStyleCatalog.d.ts +254 -0
  20. package/dist/_dts/theme-core/src/site-styles/headerLegacyLooks.d.ts +372 -0
  21. package/dist/_dts/theme-core/src/site-styles/headerLookBranding.d.ts +106 -0
  22. package/dist/_dts/theme-core/src/site-styles/headerLookSelection.d.ts +2 -0
  23. package/dist/_dts/theme-core/src/site-styles/headerLookTypes.d.ts +212 -0
  24. package/dist/_dts/theme-core/src/site-styles/headerLooks.d.ts +7 -841
  25. package/dist/_dts/theme-core/src/site-styles/headerStyleCompiler.d.ts +3 -0
  26. package/dist/_dts/theme-core/src/site-styles/headerStyleCompilerPrimitives.d.ts +23 -0
  27. package/dist/client/client.mjs +492 -426
  28. package/dist/client/hooks.mjs +59 -36
  29. package/dist/client/rendering/client.mjs +593 -547
  30. package/dist/client/rendering.mjs +491 -425
  31. package/dist/preview-next/client/runtime.mjs +3 -3
  32. package/dist/{sdk-runtime-CfZd5pAm.mjs → sdk-runtime-C20CVWbb.mjs} +1 -1
  33. package/dist/{separator-DkTe68HE.mjs → separator-BE3NCquy.mjs} +1 -1
  34. package/dist/server/components.mjs +72 -49
  35. package/dist/server/config-validation.mjs +59 -36
  36. package/dist/server/config.mjs +59 -36
  37. package/dist/server/data.mjs +59 -36
  38. package/dist/server/index.mjs +1 -1
  39. package/dist/server/manifest.mjs +4966 -0
  40. package/dist/server/next.mjs +73 -50
  41. package/dist/server/page-converter.mjs +40 -36
  42. package/dist/server/prebuild.mjs +1 -1
  43. package/dist/server/rendering/server.mjs +72 -49
  44. package/dist/server/rendering.mjs +72 -49
  45. package/dist/server/routing.mjs +472 -402
  46. package/dist/server/server.mjs +60 -37
  47. package/dist/server/theme-bridge.mjs +70 -66
  48. package/package.json +9 -12
  49. package/dist/_dts/api/src/event-presentation.d.ts +0 -14
  50. package/dist/_dts/blocks/src/definitions.d.ts +0 -14
  51. package/dist/_dts/sdk/src/cli/canonical-entry-policy.d.ts +0 -53
  52. package/dist/_dts/sdk/src/cli/commands/audit.d.ts +0 -101
  53. package/dist/_dts/sdk/src/cli/commands/block.d.ts +0 -24
  54. package/dist/_dts/sdk/src/cli/commands/compare.d.ts +0 -62
  55. package/dist/_dts/sdk/src/cli/commands/content-type.d.ts +0 -10
  56. package/dist/_dts/sdk/src/cli/commands/content.d.ts +0 -56
  57. package/dist/_dts/sdk/src/cli/commands/delete.d.ts +0 -14
  58. package/dist/_dts/sdk/src/cli/commands/deploy.d.ts +0 -43
  59. package/dist/_dts/sdk/src/cli/commands/drafts.d.ts +0 -18
  60. package/dist/_dts/sdk/src/cli/commands/entry.d.ts +0 -55
  61. package/dist/_dts/sdk/src/cli/commands/env.d.ts +0 -31
  62. package/dist/_dts/sdk/src/cli/commands/event.d.ts +0 -23
  63. package/dist/_dts/sdk/src/cli/commands/eventOccurrenceSchedule.d.ts +0 -12
  64. package/dist/_dts/sdk/src/cli/commands/identifiers.d.ts +0 -10
  65. package/dist/_dts/sdk/src/cli/commands/init-docs.d.ts +0 -13
  66. package/dist/_dts/sdk/src/cli/commands/manifest.d.ts +0 -10
  67. package/dist/_dts/sdk/src/cli/commands/media-validation.d.ts +0 -3
  68. package/dist/_dts/sdk/src/cli/commands/migrate.d.ts +0 -11
  69. package/dist/_dts/sdk/src/cli/commands/navigation.d.ts +0 -12
  70. package/dist/_dts/sdk/src/cli/commands/page.d.ts +0 -14
  71. package/dist/_dts/sdk/src/cli/commands/publish-all.d.ts +0 -50
  72. package/dist/_dts/sdk/src/cli/commands/pull-dated-offering-scope.d.ts +0 -10
  73. package/dist/_dts/sdk/src/cli/commands/pull-dry-run.d.ts +0 -70
  74. package/dist/_dts/sdk/src/cli/commands/pull-scope-diff.d.ts +0 -8
  75. package/dist/_dts/sdk/src/cli/commands/pull.d.ts +0 -43
  76. package/dist/_dts/sdk/src/cli/commands/push/consts.d.ts +0 -3
  77. package/dist/_dts/sdk/src/cli/commands/push/execute/diff.d.ts +0 -19
  78. package/dist/_dts/sdk/src/cli/commands/push/execute/footer.d.ts +0 -42
  79. package/dist/_dts/sdk/src/cli/commands/push/execute/localMediaReporting.d.ts +0 -23
  80. package/dist/_dts/sdk/src/cli/commands/push/execute/media.d.ts +0 -22
  81. package/dist/_dts/sdk/src/cli/commands/push/execute/metadata.d.ts +0 -1
  82. package/dist/_dts/sdk/src/cli/commands/push/execute/reporting.d.ts +0 -7
  83. package/dist/_dts/sdk/src/cli/commands/push/execute/theme.d.ts +0 -63
  84. package/dist/_dts/sdk/src/cli/commands/push/filter.d.ts +0 -15
  85. package/dist/_dts/sdk/src/cli/commands/push/metadata.d.ts +0 -29
  86. package/dist/_dts/sdk/src/cli/commands/push/normalizeLocalContent.d.ts +0 -2
  87. package/dist/_dts/sdk/src/cli/commands/push/options.d.ts +0 -32
  88. package/dist/_dts/sdk/src/cli/commands/push/publishGuidance.d.ts +0 -15
  89. package/dist/_dts/sdk/src/cli/commands/push/pushAllExtras.d.ts +0 -25
  90. package/dist/_dts/sdk/src/cli/commands/push/scopes/commandBackedDatedOfferingScope.d.ts +0 -83
  91. package/dist/_dts/sdk/src/cli/commands/push/scopes/eventCategories.d.ts +0 -4
  92. package/dist/_dts/sdk/src/cli/commands/push/scopes/events.d.ts +0 -4
  93. package/dist/_dts/sdk/src/cli/commands/push/scopes/mediaPrep.d.ts +0 -14
  94. package/dist/_dts/sdk/src/cli/commands/push/scopes/pushScopeGeneric.d.ts +0 -6
  95. package/dist/_dts/sdk/src/cli/commands/push/scopes/types.d.ts +0 -87
  96. package/dist/_dts/sdk/src/cli/commands/push/scopes/venues.d.ts +0 -4
  97. package/dist/_dts/sdk/src/cli/commands/push/stale-resolution.d.ts +0 -48
  98. package/dist/_dts/sdk/src/cli/commands/push/stale.d.ts +0 -17
  99. package/dist/_dts/sdk/src/cli/commands/push/verification.d.ts +0 -56
  100. package/dist/_dts/sdk/src/cli/commands/push/workflowPlan.d.ts +0 -34
  101. package/dist/_dts/sdk/src/cli/commands/push-execute.d.ts +0 -54
  102. package/dist/_dts/sdk/src/cli/commands/push.d.ts +0 -40
  103. package/dist/_dts/sdk/src/cli/commands/setup.d.ts +0 -3
  104. package/dist/_dts/sdk/src/cli/commands/style.d.ts +0 -60
  105. package/dist/_dts/sdk/src/cli/commands/verify.d.ts +0 -11
  106. package/dist/_dts/sdk/src/cli/commands/webhooks.d.ts +0 -44
  107. package/dist/_dts/sdk/src/cli/config-loader.d.ts +0 -47
  108. package/dist/_dts/sdk/src/cli/content/collectionWriters.d.ts +0 -23
  109. package/dist/_dts/sdk/src/cli/content/edit/format.d.ts +0 -2
  110. package/dist/_dts/sdk/src/cli/content/edit/path.d.ts +0 -14
  111. package/dist/_dts/sdk/src/cli/content/edit/planner.d.ts +0 -46
  112. package/dist/_dts/sdk/src/cli/content/entryPaths.d.ts +0 -6
  113. package/dist/_dts/sdk/src/cli/content/footerFile.d.ts +0 -10
  114. package/dist/_dts/sdk/src/cli/content/fs-utils.d.ts +0 -39
  115. package/dist/_dts/sdk/src/cli/content/legacyEventScheduleShapeError.d.ts +0 -5
  116. package/dist/_dts/sdk/src/cli/content/localEventSchedule.d.ts +0 -17
  117. package/dist/_dts/sdk/src/cli/content/media-manifest.d.ts +0 -13
  118. package/dist/_dts/sdk/src/cli/content/metadataAfterPush.d.ts +0 -25
  119. package/dist/_dts/sdk/src/cli/content/metadataStore.d.ts +0 -29
  120. package/dist/_dts/sdk/src/cli/content/reader.d.ts +0 -488
  121. package/dist/_dts/sdk/src/cli/content/writer.d.ts +0 -142
  122. package/dist/_dts/sdk/src/cli/env-scope.d.ts +0 -2
  123. package/dist/_dts/sdk/src/cli/env.d.ts +0 -71
  124. package/dist/_dts/sdk/src/cli/errors.d.ts +0 -62
  125. package/dist/_dts/sdk/src/cli/helpers/ai-runtime.d.ts +0 -2
  126. package/dist/_dts/sdk/src/cli/helpers.d.ts +0 -399
  127. package/dist/_dts/sdk/src/cli/index.d.ts +0 -11
  128. package/dist/_dts/sdk/src/cli/init-docs/constants.d.ts +0 -16
  129. package/dist/_dts/sdk/src/cli/init-docs/index.d.ts +0 -12
  130. package/dist/_dts/sdk/src/cli/init-docs/templates.d.ts +0 -18
  131. package/dist/_dts/sdk/src/cli/init-docs/zod-to-markdown.d.ts +0 -28
  132. package/dist/_dts/sdk/src/cli/load-config.d.ts +0 -14
  133. package/dist/_dts/sdk/src/cli/media/identifiers.d.ts +0 -18
  134. package/dist/_dts/sdk/src/cli/media/local-media.d.ts +0 -14
  135. package/dist/_dts/sdk/src/cli/media/local-sync.d.ts +0 -91
  136. package/dist/_dts/sdk/src/cli/media/portable.d.ts +0 -11
  137. package/dist/_dts/sdk/src/cli/media/rich-text.d.ts +0 -12
  138. package/dist/_dts/sdk/src/cli/media/value-utils.d.ts +0 -15
  139. package/dist/_dts/sdk/src/cli/media/write-guard.d.ts +0 -52
  140. package/dist/_dts/sdk/src/cli/merge-remote/entryLocal.d.ts +0 -3
  141. package/dist/_dts/sdk/src/cli/merge-remote/entryMerge.d.ts +0 -78
  142. package/dist/_dts/sdk/src/cli/merge-remote/entryMergePlan.d.ts +0 -45
  143. package/dist/_dts/sdk/src/cli/merge-remote/entryMergePush.d.ts +0 -24
  144. package/dist/_dts/sdk/src/cli/merge-remote/entryMergeReport.d.ts +0 -18
  145. package/dist/_dts/sdk/src/cli/merge-remote/entryRemote.d.ts +0 -9
  146. package/dist/_dts/sdk/src/cli/merge-remote/entrySnapshots.d.ts +0 -48
  147. package/dist/_dts/sdk/src/cli/merge-remote/mergeFieldChanges.d.ts +0 -22
  148. package/dist/_dts/sdk/src/cli/merge-remote/pageLocal.d.ts +0 -3
  149. package/dist/_dts/sdk/src/cli/merge-remote/pageMerge.d.ts +0 -78
  150. package/dist/_dts/sdk/src/cli/merge-remote/pageMergePlan.d.ts +0 -36
  151. package/dist/_dts/sdk/src/cli/merge-remote/pageMergePush.d.ts +0 -23
  152. package/dist/_dts/sdk/src/cli/merge-remote/pageMergeReport.d.ts +0 -17
  153. package/dist/_dts/sdk/src/cli/merge-remote/pageSnapshots.d.ts +0 -46
  154. package/dist/_dts/sdk/src/cli/merge-remote/sharedBaseSnapshots.d.ts +0 -32
  155. package/dist/_dts/sdk/src/cli/merge-remote/sharedMergePlan.d.ts +0 -27
  156. package/dist/_dts/sdk/src/cli/merge-remote/sharedMergeReport.d.ts +0 -63
  157. package/dist/_dts/sdk/src/cli/migrations/entries.d.ts +0 -28
  158. package/dist/_dts/sdk/src/cli/migrations/events.d.ts +0 -73
  159. package/dist/_dts/sdk/src/cli/navigationIdentity.d.ts +0 -11
  160. package/dist/_dts/sdk/src/cli/output.d.ts +0 -133
  161. package/dist/_dts/sdk/src/cli/program.d.ts +0 -29
  162. package/dist/_dts/sdk/src/cli/push-config.d.ts +0 -49
  163. package/dist/_dts/sdk/src/cli/setup/setupPlan.d.ts +0 -51
  164. package/dist/_dts/sdk/src/cli/site-commands/commandKeys.d.ts +0 -13
  165. package/dist/_dts/sdk/src/cli/site-commands/commandRuntime.d.ts +0 -170
  166. package/dist/_dts/sdk/src/cli/site-commands/commandRuntimeCompat.d.ts +0 -21
  167. package/dist/_dts/sdk/src/cli/site-commands/commandSurfaceDispatch.d.ts +0 -32
  168. package/dist/_dts/sdk/src/cli/site-commands/datedOfferingCommands.d.ts +0 -53
  169. package/dist/_dts/sdk/src/cli/site-commands/entryCommands.d.ts +0 -65
  170. package/dist/_dts/sdk/src/cli/site-commands/eventScheduleCompiler.d.ts +0 -24
  171. package/dist/_dts/sdk/src/cli/site-commands/footerCommands.d.ts +0 -68
  172. package/dist/_dts/sdk/src/cli/site-commands/formCommands.d.ts +0 -53
  173. package/dist/_dts/sdk/src/cli/site-commands/index.d.ts +0 -8
  174. package/dist/_dts/sdk/src/cli/site-commands/localBlockManifestResolver.d.ts +0 -31
  175. package/dist/_dts/sdk/src/cli/site-commands/navigationCommands.d.ts +0 -57
  176. package/dist/_dts/sdk/src/cli/site-commands/oneOffCommands.d.ts +0 -82
  177. package/dist/_dts/sdk/src/cli/site-commands/pageCommands.d.ts +0 -84
  178. package/dist/_dts/sdk/src/cli/site-commands/pushExecution.d.ts +0 -39
  179. package/dist/_dts/sdk/src/cli/site-commands/pushExecutionPlan.d.ts +0 -8
  180. package/dist/_dts/sdk/src/cli/site-commands/pushExecutionTypes.d.ts +0 -97
  181. package/dist/_dts/sdk/src/cli/site-commands/residualSettingsTrimming.d.ts +0 -15
  182. package/dist/_dts/sdk/src/cli/sync/diff.d.ts +0 -222
  183. package/dist/_dts/sdk/src/cli/sync/executor.d.ts +0 -84
  184. package/dist/_dts/sdk/src/cli/sync/field-diff.d.ts +0 -39
  185. package/dist/_dts/sdk/src/cli/sync/index.d.ts +0 -10
  186. package/dist/_dts/sdk/src/cli/sync/mapper.d.ts +0 -41
  187. package/dist/_dts/sdk/src/cli/sync/media-sync.d.ts +0 -15
  188. package/dist/_dts/sdk/src/cli/sync/media.d.ts +0 -158
  189. package/dist/_dts/sdk/src/cli/sync/syncResultAggregation.d.ts +0 -4
  190. package/dist/_dts/sdk/src/cli/sync/validation.d.ts +0 -68
  191. package/dist/_dts/sdk/src/cli/utils/checksum.d.ts +0 -1
  192. package/dist/_dts/sdk/src/client/management/blocks.d.ts +0 -19
  193. package/dist/_dts/sdk/src/client/management/catalog.d.ts +0 -10
  194. package/dist/_dts/sdk/src/client/management/entries.d.ts +0 -6
  195. package/dist/_dts/sdk/src/client/management/eventCategories.d.ts +0 -6
  196. package/dist/_dts/sdk/src/client/management/events.d.ts +0 -7
  197. package/dist/_dts/sdk/src/client/management/footer.d.ts +0 -9
  198. package/dist/_dts/sdk/src/client/management/forms.d.ts +0 -6
  199. package/dist/_dts/sdk/src/client/management/http.d.ts +0 -79
  200. package/dist/_dts/sdk/src/client/management/identifiers.d.ts +0 -11
  201. package/dist/_dts/sdk/src/client/management/index.d.ts +0 -41
  202. package/dist/_dts/sdk/src/client/management/media.d.ts +0 -72
  203. package/dist/_dts/sdk/src/client/management/navigation.d.ts +0 -6
  204. package/dist/_dts/sdk/src/client/management/pages.d.ts +0 -6
  205. package/dist/_dts/sdk/src/client/management/pull.d.ts +0 -6
  206. package/dist/_dts/sdk/src/client/management/settings-branding.d.ts +0 -32
  207. package/dist/_dts/sdk/src/client/management/settings.d.ts +0 -6
  208. package/dist/_dts/sdk/src/client/management/theme.d.ts +0 -8
  209. package/dist/_dts/sdk/src/client/management/types.d.ts +0 -1069
  210. package/dist/_dts/sdk/src/client/management/venues.d.ts +0 -6
  211. package/dist/_dts/sdk/src/client/management/webhooks.d.ts +0 -3
  212. package/dist/_dts/sdk/src/test/env.d.ts +0 -4
  213. package/dist/_dts/site-commands/src/adapter.d.ts +0 -23
  214. package/dist/_dts/site-commands/src/appointmentCommandSchemas.d.ts +0 -100
  215. package/dist/_dts/site-commands/src/capabilityGaps.d.ts +0 -8
  216. package/dist/_dts/site-commands/src/commandContract.d.ts +0 -1277
  217. package/dist/_dts/site-commands/src/commandDomain.d.ts +0 -20
  218. package/dist/_dts/site-commands/src/commandIdentifiers.d.ts +0 -7
  219. package/dist/_dts/site-commands/src/commandValidation.d.ts +0 -10
  220. package/dist/_dts/site-commands/src/commands.d.ts +0 -1983
  221. package/dist/_dts/site-commands/src/domain.d.ts +0 -104
  222. package/dist/_dts/site-commands/src/eventCommandContent.d.ts +0 -11
  223. package/dist/_dts/site-commands/src/exposure.d.ts +0 -41
  224. package/dist/_dts/site-commands/src/guards.d.ts +0 -1
  225. package/dist/_dts/site-commands/src/index.d.ts +0 -18
  226. package/dist/_dts/site-commands/src/metadata.d.ts +0 -555
  227. package/dist/_dts/site-commands/src/pagePaths.d.ts +0 -6
  228. package/dist/_dts/site-commands/src/planner.d.ts +0 -58
  229. package/dist/_dts/site-commands/src/refContributions.d.ts +0 -11
  230. package/dist/_dts/site-commands/src/refs.d.ts +0 -90
  231. package/dist/_dts/site-commands/src/siteStyleCommandSchema.d.ts +0 -405
  232. package/dist/_dts/site-commands/src/siteStyleSelectionSchemaBuilder.d.ts +0 -46
  233. package/dist/_dts/site-commands/src/stableJson.d.ts +0 -5
  234. package/dist/_dts/site-commands/src/staticExecutionGaps.d.ts +0 -10
  235. package/dist/_dts/site-commands/src/venueCommandMapping.d.ts +0 -21
  236. package/dist/_dts/theme-core/src/data.d.ts +0 -12
  237. package/dist/_dts/theme-core/src/site-styles/headerStyleParts.d.ts +0 -4
  238. package/dist/cli/index.mjs +0 -162988
  239. package/dist/cli/init-docs/content/agents-section.md +0 -67
  240. package/dist/cli/init-docs/content/cli-reference.md +0 -1238
  241. package/dist/cli/init-docs/content/content-management.md +0 -792
  242. package/dist/cli/init-docs/content/context-brand.md +0 -125
  243. package/dist/cli/init-docs/content/context-brief.md +0 -77
  244. package/dist/cli/init-docs/content/context-knowledge.md +0 -111
  245. package/dist/cli/init-docs/content/getting-started.md +0 -171
  246. package/dist/cli/init-docs/content/site-workflows-readme.md +0 -96
  247. package/dist/cli/init-docs/content/workflow-add-block.md +0 -299
  248. package/dist/cli/init-docs/content/workflow-agent-safe-sync.md +0 -83
  249. package/dist/cli/init-docs/content/workflow-block-extensions.md +0 -370
  250. package/dist/cli/init-docs/content/workflow-cmsify-page.md +0 -357
  251. package/dist/cli/init-docs/content/workflow-content-types.md +0 -330
  252. package/dist/cli/init-docs/content/workflow-create-page.md +0 -212
  253. package/dist/cli/init-docs/content/workflow-custom-block.md +0 -470
  254. package/dist/cli/init-docs/content/workflow-editor-workflows.md +0 -130
  255. package/dist/cli/init-docs/content/workflow-isr-revalidation.md +0 -158
  256. package/dist/cli/init-docs/content/workflow-preview-mode.md +0 -252
  257. package/dist/cli/init-docs/content/workflow-publish.md +0 -285
  258. package/dist/cli/init-docs/content/workflow-remote-setup.md +0 -51
  259. package/dist/cli/init-docs/content/workflow-templates.md +0 -381
  260. /package/dist/_dts/{sdk/src/cli/utils/mime.d.ts → media-core/src/mimeType.d.ts} +0 -0
@@ -1,82 +0,0 @@
1
- import { type Result, type SiteId } from '../../../../core/src/index';
2
- import type { ManagementBlock, ManagementClient, ManagementNavigationMenu, ManagementPage, NavigationItemInput, UpsertedManagementEntry } from '../../client/management/types';
3
- import type { EnvTarget } from '../helpers';
4
- import { type CliCommandCompileBatchSuccessWithReports, type CliCommandValidationCompileError } from './commandRuntime';
5
- import { type EntryCommandReportSubject, type EntrySiteCommand, type EntrySiteCommandType } from './entryCommands';
6
- import { type NavigationCommandReportSubject, type NavigationSiteCommand, type NavigationSiteCommandType } from './navigationCommands';
7
- import { type PageCommandReportSubject, type PageSiteCommand, type PageSiteCommandType } from './pageCommands';
8
- export type OneOffCommandBatchSource = 'one_off_entry' | 'one_off_page' | 'one_off_block' | 'one_off_navigation';
9
- type OneOffCompileInput<TMutation> = Readonly<{
10
- source: OneOffCommandBatchSource;
11
- siteId: SiteId;
12
- targetEnv: EnvTarget;
13
- mutation: TMutation;
14
- }>;
15
- export type OneOffEntryMutation = Readonly<{
16
- kind: 'upsert';
17
- contentType: string;
18
- identifier: string;
19
- data: Record<string, unknown>;
20
- slug?: string;
21
- }> | Readonly<{
22
- kind: 'publish' | 'unpublish';
23
- contentType: string;
24
- identifier: string;
25
- }>;
26
- export type OneOffPageMutation = Readonly<{
27
- kind: 'upsert';
28
- identifier: string;
29
- title: string;
30
- path: string;
31
- seoTitle?: string;
32
- seoDescription?: string;
33
- }> | Readonly<{
34
- kind: 'publish' | 'unpublish';
35
- identifier: string;
36
- }>;
37
- export type OneOffBlockMutation = Readonly<{
38
- kind: 'upsert';
39
- pageIdentifier: string;
40
- blockIdentifier: string;
41
- blockKind: string;
42
- data: Record<string, unknown>;
43
- }> | Readonly<{
44
- kind: 'reorder';
45
- pageIdentifier: string;
46
- blockIdentifiers: readonly string[];
47
- }>;
48
- export type OneOffNavigationMutation = Readonly<{
49
- kind: 'upsert';
50
- identifier?: string;
51
- menuName: string;
52
- items: readonly NavigationItemInput[];
53
- }>;
54
- export type OneOffEntryCommandCompileSuccess = CliCommandCompileBatchSuccessWithReports<EntrySiteCommandType, EntryCommandReportSubject>;
55
- export type OneOffPageCommandCompileSuccess = CliCommandCompileBatchSuccessWithReports<PageSiteCommandType, PageCommandReportSubject>;
56
- export type OneOffNavigationCommandCompileSuccess = CliCommandCompileBatchSuccessWithReports<NavigationSiteCommandType, NavigationCommandReportSubject>;
57
- export declare function compileOneOffEntryCommand(input: OneOffCompileInput<OneOffEntryMutation>): Result<OneOffEntryCommandCompileSuccess, CliCommandValidationCompileError>;
58
- export declare function compileOneOffPageCommand(input: OneOffCompileInput<OneOffPageMutation>): Result<OneOffPageCommandCompileSuccess, CliCommandValidationCompileError>;
59
- export declare function compileOneOffBlockCommand(input: OneOffCompileInput<OneOffBlockMutation>): Result<OneOffPageCommandCompileSuccess, CliCommandValidationCompileError>;
60
- export declare function compileOneOffNavigationCommand(input: OneOffCompileInput<OneOffNavigationMutation>): Result<OneOffNavigationCommandCompileSuccess, CliCommandValidationCompileError>;
61
- export declare function executeOneOffEntryCommand<TResult>(input: Readonly<{
62
- compiledPlan: Pick<OneOffEntryCommandCompileSuccess, 'plan'>;
63
- client: Pick<ManagementClient, 'entries'>;
64
- apply: (command: EntrySiteCommand, client: Pick<ManagementClient, 'entries'>) => Promise<TResult>;
65
- }>): Promise<TResult>;
66
- export declare function executeOneOffPageCommand<TResult>(input: Readonly<{
67
- compiledPlan: Pick<OneOffPageCommandCompileSuccess, 'plan'>;
68
- client: Pick<ManagementClient, 'pages' | 'blocks'>;
69
- apply: (command: PageSiteCommand, client: Pick<ManagementClient, 'pages' | 'blocks'>) => Promise<TResult>;
70
- }>): Promise<TResult>;
71
- export declare function executeOneOffNavigationCommand<TResult>(input: Readonly<{
72
- compiledPlan: Pick<OneOffNavigationCommandCompileSuccess, 'plan'>;
73
- client: Pick<ManagementClient, 'navigation'>;
74
- apply: (command: NavigationSiteCommand, client: Pick<ManagementClient, 'navigation'>) => Promise<TResult>;
75
- }>): Promise<TResult>;
76
- export declare function applyOneOffEntryCommand(command: EntrySiteCommand, client: Pick<ManagementClient, 'entries'>): Promise<UpsertedManagementEntry | void>;
77
- export declare function applyOneOffEntryCommandReturningEntry(command: EntrySiteCommand, client: Pick<ManagementClient, 'entries'>): Promise<UpsertedManagementEntry>;
78
- export declare function applyOneOffPageCommand(command: PageSiteCommand, client: Pick<ManagementClient, 'pages' | 'blocks'>): Promise<ManagementPage | ManagementBlock | void>;
79
- export declare function applyOneOffPageCommandReturningPage(command: PageSiteCommand, client: Pick<ManagementClient, 'pages' | 'blocks'>): Promise<ManagementPage>;
80
- export declare function applyOneOffPageCommandReturningBlock(command: PageSiteCommand, client: Pick<ManagementClient, 'pages' | 'blocks'>): Promise<ManagementBlock>;
81
- export declare function applyOneOffNavigationCommand(command: NavigationSiteCommand, client: Pick<ManagementClient, 'navigation'>): Promise<ManagementNavigationMenu>;
82
- export {};
@@ -1,84 +0,0 @@
1
- import { type Result, type SiteId } from '../../../../core/src/index';
2
- import { type SiteCommandOf } from '../../../../site-commands/src/index';
3
- import type { ManagementClient } from '../../client/management/types';
4
- import type { LocalContent } from '../content/reader';
5
- import type { EnvTarget } from '../helpers';
6
- import type { BlockFieldExtensionsMap, SdkCustomBlock } from '../../config/types';
7
- import type { ContentDiff } from '../sync/diff';
8
- import type { SyncResult } from '../sync';
9
- import { type CliBlockIdentifier, type CliPageIdentifier } from './commandKeys';
10
- import { type CliCommandCompileBatchSuccessWithReports, type CliCommandExecutionError, type CliCommandExecutionReport, type CliCommandExecutionResult, type CliCommandValidationCompileError } from './commandRuntime';
11
- export type CliPageCommandBatchSource = 'push_pages';
12
- export type CliPageCommandCompileError = Readonly<{
13
- code: 'missing_local_page';
14
- identifier: CliPageIdentifier;
15
- message: string;
16
- }> | Readonly<{
17
- code: 'missing_local_block';
18
- identifier: `${CliPageIdentifier}/${CliBlockIdentifier}`;
19
- message: string;
20
- }> | Readonly<{
21
- code: 'invalid_page_block';
22
- identifier: `${CliPageIdentifier}/${CliBlockIdentifier}`;
23
- warnings: readonly string[];
24
- message: string;
25
- }> | CliCommandValidationCompileError;
26
- export type CliPageCommandCompileInput = Readonly<{
27
- source: CliPageCommandBatchSource;
28
- siteId: SiteId;
29
- targetEnv: EnvTarget;
30
- diff: Pick<ContentDiff, 'pages'>;
31
- local: Pick<LocalContent, 'pages'>;
32
- customBlocks?: readonly SdkCustomBlock[];
33
- blockFieldExtensions?: BlockFieldExtensionsMap;
34
- }>;
35
- export type CliPageCommandCompileSuccess = CliCommandCompileBatchSuccessWithReports<PageSiteCommandType, PageCommandReportSubject> & Readonly<{
36
- warnings: readonly string[];
37
- }>;
38
- export type PageSiteCommandType = 'upsertPage' | 'upsertPageBlock' | 'deletePageBlock' | 'reorderPageBlocks' | 'publishPage' | 'unpublishPage';
39
- export type PageSiteCommand = SiteCommandOf<PageSiteCommandType>;
40
- export type PageSiteCommandPlan = CliPageCommandCompileSuccess['plan'];
41
- export type CliPageCommandExecutionError = CliCommandExecutionError<PageSiteCommandType>;
42
- export type CliPageCommandExecutionResult = CliCommandExecutionResult<PageSiteCommandType>;
43
- export declare const pageSiteCommandTypes: readonly ["upsertPage", "upsertPageBlock", "deletePageBlock", "reorderPageBlocks", "publishPage", "unpublishPage"];
44
- export type PageCommandSyncCounter = 'created' | 'updated' | 'published' | 'unpublished';
45
- export type BlockCommandSyncCounter = 'created' | 'updated' | 'deleted' | 'reordered';
46
- export type PageCommandReportSubject = Readonly<{
47
- resource: 'page';
48
- identifier: CliPageIdentifier;
49
- counter: PageCommandSyncCounter;
50
- }> | Readonly<{
51
- resource: 'block';
52
- pageIdentifier: CliPageIdentifier;
53
- identifier: CliBlockIdentifier | CliPageIdentifier;
54
- counter: BlockCommandSyncCounter;
55
- }>;
56
- export type PageCommandExecutionReport = CliCommandExecutionReport<PageCommandReportSubject>;
57
- export type PageCommandCompiledPlan = Pick<CliPageCommandCompileSuccess, 'plan' | 'reportedCommands' | 'warnings'>;
58
- export declare function compilePagePushCommands(input: CliPageCommandCompileInput): Result<CliPageCommandCompileSuccess, CliPageCommandCompileError>;
59
- export type PageCommandRoutingDecision = Readonly<{
60
- kind: 'no_page_changes';
61
- }> | Readonly<{
62
- kind: 'command_backed';
63
- }>;
64
- export declare function pageCommandRouting(diff: Pick<ContentDiff, 'pages'>): PageCommandRoutingDecision;
65
- export declare function executePageCommandPlan(input: Readonly<{
66
- client: Pick<ManagementClient, 'pages' | 'blocks'>;
67
- plan: Pick<PageSiteCommandPlan, 'commands'>;
68
- }>): Promise<CliPageCommandExecutionResult>;
69
- export declare function executePageCommandPlanAsReport(input: Readonly<{
70
- client: Pick<ManagementClient, 'pages' | 'blocks'>;
71
- compiledPlan: PageCommandCompiledPlan;
72
- onBeforeExecute?: (commandCount: number) => void;
73
- }>): Promise<PageCommandExecutionReport>;
74
- export declare function pageCommandCompileErrorToReport(error: CliPageCommandCompileError): PageCommandExecutionReport;
75
- export declare function pageCommandExecutionToReport(input: Readonly<{
76
- execution: CliPageCommandExecutionResult;
77
- compiledPlan: PageCommandCompiledPlan;
78
- }>): PageCommandExecutionReport;
79
- export declare function preflightPageCommandPlanAsReport(input: Readonly<{
80
- compiledPlan: PageCommandCompiledPlan;
81
- customBlocks?: readonly SdkCustomBlock[];
82
- blockFieldExtensions?: BlockFieldExtensionsMap;
83
- }>): PageCommandExecutionReport;
84
- export declare function pageCommandReportToSyncResult(report: PageCommandExecutionReport): SyncResult;
@@ -1,39 +0,0 @@
1
- import { type SiteId } from '../../../../core/src/index';
2
- import type { ManagementClient } from '../../client/management/types';
3
- import type { LocalContent } from '../content/reader';
4
- import type { EnvTarget } from '../helpers';
5
- import type { OutputContext } from '../output';
6
- import { type ContentDiff, type SyncResult } from '../sync';
7
- import { type CommandSurfaceDispatchDependencies } from './commandSurfaceDispatch';
8
- import { planContentPushExecution } from './pushExecutionPlan';
9
- import type { CommandSurface, CommandSurfaceCompileResult, CommandSurfaceCompileSuccess, CommandSurfaceExecutionReport, CompiledContentPushExecutionPlan, ContentPushScope, ContentPushExecutionPlan, ContentPushExecutionReport, ContentPushExecutionStep } from './pushExecutionTypes';
10
- import type { compilePagePushCommands } from './pageCommands';
11
- export { planContentPushExecution };
12
- export type { CommandSurface, CommandSurfaceCompileResult, CommandSurfaceCompileSuccess, CommandSurfaceExecutionReport, ContentPushScope, ContentPushExecutionPlan, ContentPushExecutionReport, ContentPushExecutionStep, };
13
- export type ContentPushExecutionInput = Readonly<{
14
- pushScope: ContentPushScope;
15
- siteId: SiteId;
16
- target: EnvTarget;
17
- diff: ContentDiff;
18
- local: LocalContent;
19
- client: ManagementClient;
20
- customBlocks?: Parameters<typeof compilePagePushCommands>[0]['customBlocks'];
21
- blockFieldExtensions: Parameters<typeof compilePagePushCommands>[0]['blockFieldExtensions'];
22
- output: OutputContext;
23
- onEntryCommandCount?: (commandCount: number) => void;
24
- onFormCommandCount?: (commandCount: number) => void;
25
- onNavigationCommandCount?: (commandCount: number) => void;
26
- onPageCommandCount?: (commandCount: number) => void;
27
- }>;
28
- export declare function executeContentPushPlan(input: ContentPushExecutionInput): Promise<SyncResult>;
29
- export declare function executeContentPushPlanAsCommandReport(input: ContentPushExecutionInput, dependencies?: CommandSurfaceDispatchDependencies): Promise<ContentPushExecutionReport>;
30
- export type ContentPushPreflightOutcome = Readonly<{
31
- ok: true;
32
- compiled: CompiledContentPushExecutionPlan;
33
- report: ContentPushExecutionReport;
34
- }> | Readonly<{
35
- ok: false;
36
- report: ContentPushExecutionReport;
37
- }>;
38
- export declare function preflightContentPushPlanAsCommandReport(input: ContentPushExecutionInput, dependencies?: CommandSurfaceDispatchDependencies): ContentPushPreflightOutcome;
39
- export declare function contentPushExecutionReportToSyncResult(report: ContentPushExecutionReport): SyncResult;
@@ -1,8 +0,0 @@
1
- import type { LocalContent } from '../content/reader';
2
- import type { ContentDiff } from '../sync';
3
- import type { ContentPushScope, ContentPushExecutionPlan } from './pushExecutionTypes';
4
- export declare function planContentPushExecution(input: Readonly<{
5
- pushScope: ContentPushScope;
6
- diff: ContentDiff;
7
- local: LocalContent;
8
- }>): ContentPushExecutionPlan;
@@ -1,97 +0,0 @@
1
- import type { SiteCommandRef, SiteCommandType } from '../../../../site-commands/src/index';
2
- import type { SyncResult, ResidualSettingsDiff, ResidualSettingsLocalContent } from '../sync';
3
- import type { PushScope } from '../commands/push/consts';
4
- import type { compileEntryPushCommands, EntryCommandExecutionReport } from './entryCommands';
5
- import type { compileFormPushCommands, FormCommandExecutionReport } from './formCommands';
6
- import type { compileNavigationPushCommands, NavigationCommandExecutionReport } from './navigationCommands';
7
- import type { compilePagePushCommands, PageCommandExecutionReport } from './pageCommands';
8
- export type CommandSurface = 'entry' | 'page' | 'form' | 'navigation';
9
- export type CommandSurfaceFailurePolicy = 'continue' | 'stop';
10
- export type ContentPushScope = Extract<PushScope, 'entries' | 'pages' | 'navigation' | 'forms' | 'settings' | 'all'>;
11
- export type ResidualSettingsPushPlan = Readonly<{
12
- diff: ResidualSettingsDiff;
13
- local: ResidualSettingsLocalContent;
14
- }>;
15
- export type CommandSurfaceCompileResult = Readonly<{
16
- surface: 'entry';
17
- compileResult: ReturnType<typeof compileEntryPushCommands>;
18
- }> | Readonly<{
19
- surface: 'page';
20
- compileResult: ReturnType<typeof compilePagePushCommands>;
21
- }> | Readonly<{
22
- surface: 'form';
23
- compileResult: ReturnType<typeof compileFormPushCommands>;
24
- }> | Readonly<{
25
- surface: 'navigation';
26
- compileResult: ReturnType<typeof compileNavigationPushCommands>;
27
- }>;
28
- export type CommandSurfaceCompileSuccess = Readonly<{
29
- surface: 'entry';
30
- compileValue: OkValue<ReturnType<typeof compileEntryPushCommands>>;
31
- }> | Readonly<{
32
- surface: 'page';
33
- compileValue: OkValue<ReturnType<typeof compilePagePushCommands>>;
34
- }> | Readonly<{
35
- surface: 'form';
36
- compileValue: OkValue<ReturnType<typeof compileFormPushCommands>>;
37
- }> | Readonly<{
38
- surface: 'navigation';
39
- compileValue: OkValue<ReturnType<typeof compileNavigationPushCommands>>;
40
- }>;
41
- type OkValue<T> = T extends Readonly<{
42
- ok: true;
43
- value: infer TValue;
44
- }> ? TValue : never;
45
- export type ContentPushExecutionStep = Readonly<{
46
- kind: 'residual-settings-sync';
47
- residual: ResidualSettingsPushPlan;
48
- onFailure: CommandSurfaceFailurePolicy;
49
- }> | Readonly<{
50
- kind: 'command-surface';
51
- surface: CommandSurface;
52
- onFailure: CommandSurfaceFailurePolicy;
53
- }>;
54
- export type CompiledContentPushExecutionStep = Readonly<{
55
- kind: 'residual-settings-sync';
56
- residual: ResidualSettingsPushPlan;
57
- onFailure: CommandSurfaceFailurePolicy;
58
- }> | Readonly<{
59
- kind: 'command-surface';
60
- surface: CommandSurfaceCompileSuccess;
61
- onFailure: CommandSurfaceFailurePolicy;
62
- }>;
63
- export type ContentPushExecutionPlan = Readonly<{
64
- kind: 'sync-steps';
65
- steps: readonly ContentPushExecutionStep[];
66
- }>;
67
- export type CompiledContentPushExecutionPlan = Readonly<{
68
- kind: 'compiled-sync-steps';
69
- steps: readonly CompiledContentPushExecutionStep[];
70
- }>;
71
- export type CommandSurfaceExecutionReport = Readonly<{
72
- surface: 'entry';
73
- report: EntryCommandExecutionReport;
74
- }> | Readonly<{
75
- surface: 'page';
76
- report: PageCommandExecutionReport;
77
- }> | Readonly<{
78
- surface: 'form';
79
- report: FormCommandExecutionReport;
80
- }> | Readonly<{
81
- surface: 'navigation';
82
- report: NavigationCommandExecutionReport;
83
- }>;
84
- export type ContentPushExecutionReport = Readonly<{
85
- commandReports: readonly CommandSurfaceExecutionReport[];
86
- residualSyncResults: readonly SyncResult[];
87
- }>;
88
- export type ReportedCommandWithSubject<TSubject> = Readonly<{
89
- plannedCommand: Readonly<{
90
- command: Readonly<{
91
- ref: SiteCommandRef;
92
- type: SiteCommandType;
93
- }>;
94
- }>;
95
- reportSubject: TSubject;
96
- }>;
97
- export {};
@@ -1,15 +0,0 @@
1
- import type { LocalContent } from '../content/reader';
2
- import type { ContentDiff } from '../sync';
3
- import type { CommandSurface, ResidualSettingsPushPlan } from './pushExecutionTypes';
4
- export declare const baselineResidualOmittedCommandSurfaces: readonly ["navigation"];
5
- export declare const baselineResidualOmittedCommandSurfaceSet: ReadonlySet<CommandSurface>;
6
- export declare function syncPlanResidual(input: Readonly<{
7
- diff: ContentDiff;
8
- local: LocalContent;
9
- omitSurfaces: ReadonlySet<CommandSurface>;
10
- }>): ResidualSettingsPushPlan;
11
- export declare function residualSettingsPlan(input: Readonly<{
12
- diff: ContentDiff;
13
- local: LocalContent;
14
- commandSurfaces: readonly CommandSurface[];
15
- }>): ResidualSettingsPushPlan | null;
@@ -1,222 +0,0 @@
1
- /**
2
- * Content Diff Calculator
3
- *
4
- * Compares local content with remote CMS state to determine
5
- * what changes need to be made during push operations.
6
- */
7
- import type { LocalContent, LocalFooterContent } from '../content/reader';
8
- import type { PulledContent, ManagementFooterContent } from '../../client/management/types';
9
- import { type BuildFieldDiffOptions, type FieldChange } from './field-diff';
10
- export type { FieldChange } from './field-diff';
11
- export type DiffType = 'create' | 'update' | 'unchanged';
12
- export interface EntryDiff {
13
- type: DiffType | 'delete';
14
- identifier: string;
15
- contentType: string;
16
- /** List of changed field paths (for updates) */
17
- changes?: string[];
18
- /** Status change needed: publish or unpublish */
19
- statusChange?: 'publish' | 'unpublish';
20
- }
21
- export interface PageDiff {
22
- type: DiffType;
23
- identifier: string;
24
- /** List of changed field paths (for updates) */
25
- changes?: string[];
26
- /** Block diffs for this page */
27
- blocks?: BlockDiff[];
28
- /** Status change needed: publish or unpublish */
29
- statusChange?: 'publish' | 'unpublish';
30
- }
31
- export interface BlockDiff {
32
- type: DiffType | 'delete' | 'reorder';
33
- identifier: string;
34
- pageIdentifier: string;
35
- /** List of changed field paths (for updates) */
36
- changes?: string[];
37
- }
38
- export interface NavigationDiff {
39
- type: DiffType;
40
- identifier?: string | null;
41
- name: string;
42
- /** List of changed field paths (for updates) */
43
- changes?: string[];
44
- }
45
- export interface SettingsDiff {
46
- type: 'update';
47
- /** List of changed field paths */
48
- changes: string[];
49
- }
50
- export interface FormDiff {
51
- type: DiffType;
52
- slug: string;
53
- /** List of changed field paths (for updates) */
54
- changes?: string[];
55
- }
56
- export interface FooterDiff {
57
- type: 'update' | 'unchanged';
58
- /** List of changed field paths (for updates) */
59
- changes?: string[];
60
- }
61
- export interface ContentDiff {
62
- /** Entry diffs grouped by content type */
63
- entries: Map<string, EntryDiff[]>;
64
- /** Page diffs */
65
- pages: PageDiff[];
66
- /** Navigation menu diffs */
67
- navigation: NavigationDiff[];
68
- /** Settings diff (null if no local settings file) */
69
- settings: SettingsDiff | null;
70
- /** Form diffs */
71
- forms: FormDiff[];
72
- /** Footer diff (null if no local footer file) */
73
- footer: FooterDiff | null;
74
- /** Summary statistics */
75
- summary: {
76
- entries: {
77
- create: number;
78
- update: number;
79
- delete: number;
80
- unchanged: number;
81
- publish: number;
82
- unpublish: number;
83
- };
84
- pages: {
85
- create: number;
86
- update: number;
87
- unchanged: number;
88
- publish: number;
89
- unpublish: number;
90
- };
91
- blocks: {
92
- create: number;
93
- update: number;
94
- delete: number;
95
- unchanged: number;
96
- };
97
- navigation: {
98
- create: number;
99
- update: number;
100
- unchanged: number;
101
- };
102
- settings: {
103
- update: number;
104
- unchanged: number;
105
- };
106
- forms: {
107
- create: number;
108
- update: number;
109
- unchanged: number;
110
- };
111
- footer: {
112
- update: number;
113
- unchanged: number;
114
- };
115
- };
116
- /** Warnings about content that couldn't be processed */
117
- warnings?: {
118
- /** Number of remote entries without identifiers (can't be deleted via CLI) */
119
- entriesWithoutIdentifier?: number;
120
- };
121
- }
122
- export interface DiffOptions {
123
- /** How to handle existing entries: 'skip' ignores updates, 'update' includes them */
124
- existingEntries: 'skip' | 'update';
125
- /** Whether to include delete diffs for remote entries not in local (default: false) */
126
- deleteMissing?: boolean;
127
- }
128
- export type JsonDiffMode = 'summary' | 'full';
129
- export type JsonDiffOperation = 'create' | 'update' | 'delete';
130
- export type JsonDiffChangeType = 'entry' | 'page' | 'block' | 'navigation' | 'settings' | 'form';
131
- export interface JsonDiffChange {
132
- type: JsonDiffChangeType;
133
- identifier: string;
134
- operation: JsonDiffOperation;
135
- before?: unknown;
136
- after?: unknown;
137
- diff?: unknown;
138
- /** Status change: publish or unpublish */
139
- statusChange?: 'publish' | 'unpublish';
140
- }
141
- export interface JsonDiffWarning {
142
- type: 'duplicate_navigation_identity';
143
- source: 'local' | 'remote';
144
- identity: string;
145
- menuNames: readonly string[];
146
- message: string;
147
- }
148
- export interface JsonDiff {
149
- summary: {
150
- creates: number;
151
- updates: number;
152
- deletes: number;
153
- publishes: number;
154
- unpublishes: number;
155
- };
156
- changes: JsonDiffChange[];
157
- warnings?: readonly JsonDiffWarning[];
158
- }
159
- /** JSON diff output for pull --dry-run --json-diff */
160
- export interface PullJsonDiff {
161
- mode: JsonDiffMode;
162
- direction: 'pull';
163
- summary: ContentDiff['summary'];
164
- changes?: PullJsonDiffChange[];
165
- }
166
- export interface PullJsonDiffChange {
167
- type: 'entry' | 'page' | 'navigation' | 'settings';
168
- operation: 'create' | 'update';
169
- identifier: string;
170
- contentType?: string;
171
- before?: unknown;
172
- after?: unknown;
173
- }
174
- export declare function buildJsonDiff(diff: ContentDiff, local: LocalContent, remote: PulledContent, mode: JsonDiffMode): JsonDiff;
175
- export declare function calculateFooterDiff(localFooter: LocalFooterContent | null, remoteFooter: ManagementFooterContent | null): {
176
- diff: FooterDiff | null;
177
- summary: ContentDiff['summary']['footer'];
178
- };
179
- /**
180
- * Calculate differences between local content and remote CMS state.
181
- *
182
- * @param local - Local content from JSON files
183
- * @param remote - Remote content pulled from CMS
184
- * @param options - Diff options
185
- * @returns Content diff with all changes categorized
186
- */
187
- export declare function calculateDiff(local: LocalContent, remote: PulledContent, options: DiffOptions): ContentDiff;
188
- /**
189
- * Check if there are any pending changes in the diff.
190
- */
191
- export declare function hasPendingChanges(diff: ContentDiff): boolean;
192
- /**
193
- * Format diff summary for display.
194
- */
195
- export declare function formatDiffSummary(diff: ContentDiff): string;
196
- /**
197
- * Format detailed diff for display.
198
- */
199
- export declare function formatDiffDetail(diff: ContentDiff): string;
200
- /**
201
- * Calculate differences for pull operation (remote → local).
202
- * This is the inverse of calculateDiff - it shows what would change locally
203
- * if we pulled content from remote.
204
- *
205
- * @param remote - Remote content from CMS (source)
206
- * @param local - Local content from files (target, may be null if no local content)
207
- * @returns Content diff showing what would be created/updated locally
208
- */
209
- export declare function calculatePullDiff(remote: PulledContent, local: LocalContent | null): ContentDiff;
210
- /**
211
- * Find changed fields between two objects with their before/after values.
212
- */
213
- export declare function findChangedFieldsWithValues(local: Record<string, unknown>, remote: Record<string, unknown>, prefix?: string, options?: BuildFieldDiffOptions): FieldChange[];
214
- /**
215
- * Format a value for human-readable display.
216
- */
217
- export declare function formatValue(value: unknown): string;
218
- /**
219
- * Format a ContentDiff with field-level before/after values for human display.
220
- * Used by push --dry-run --diff.
221
- */
222
- export declare function formatHumanDiff(diff: ContentDiff, local: LocalContent, remote: PulledContent): string;
@@ -1,84 +0,0 @@
1
- /**
2
- * Residual Sync Executor
3
- *
4
- * Applies the small set of SDK CLI writes that have not yet moved onto the
5
- * shared site-command IR. Command-backed surfaces fail closed here so direct
6
- * writes cannot silently come back through this path.
7
- */
8
- import type { ManagementClient } from '../../client/management/types';
9
- import type { LocalContent } from '../content/reader';
10
- import type { OutputContext } from '../output';
11
- import type { ContentDiff } from './diff';
12
- /**
13
- * Format API errors with detailed field validation info when available.
14
- */
15
- export declare function formatApiError(error: unknown): string;
16
- export interface SyncOptions {
17
- /** If true, don't actually make changes */
18
- dryRun: boolean;
19
- }
20
- export interface SyncResult {
21
- entries: {
22
- created: number;
23
- updated: number;
24
- deleted: number;
25
- failed: number;
26
- published: number;
27
- unpublished: number;
28
- };
29
- pages: {
30
- created: number;
31
- updated: number;
32
- failed: number;
33
- published: number;
34
- unpublished: number;
35
- };
36
- blocks: {
37
- created: number;
38
- updated: number;
39
- deleted: number;
40
- failed: number;
41
- };
42
- navigation: {
43
- created: number;
44
- updated: number;
45
- failed: number;
46
- };
47
- settings: {
48
- updated: number;
49
- failed: number;
50
- };
51
- forms: {
52
- created: number;
53
- updated: number;
54
- failed: number;
55
- };
56
- footer: {
57
- updated: number;
58
- failed: number;
59
- };
60
- errors: Array<{
61
- resource: string;
62
- identifier: string;
63
- error: string;
64
- }>;
65
- warnings: string[];
66
- }
67
- export type ResidualSettingsDiff = Readonly<Pick<ContentDiff, 'settings' | 'summary'>>;
68
- export type ResidualSettingsLocalContent = Readonly<Pick<LocalContent, 'settings'>>;
69
- export declare function createEmptySyncResult(): SyncResult;
70
- /**
71
- * Execute the remaining settings-only sync plan.
72
- *
73
- * @param client - Management client
74
- * @param diff - Calculated content diff
75
- * @param local - Local content
76
- * @param options - Sync options (dryRun)
77
- * @param output - Output context for progress reporting
78
- * @returns Sync result with counts and errors
79
- */
80
- export declare function executeResidualSettingsSyncPlan(client: ManagementClient, diff: ResidualSettingsDiff, local: ResidualSettingsLocalContent, options: SyncOptions, output: OutputContext): Promise<SyncResult>;
81
- /**
82
- * Format sync result for display.
83
- */
84
- export declare function formatSyncResult(result: SyncResult, dryRun: boolean): string;
@@ -1,39 +0,0 @@
1
- export type FieldPathSegment = Readonly<{
2
- type: 'property';
3
- key: string;
4
- }> | Readonly<{
5
- type: 'index';
6
- index: number;
7
- }> | Readonly<{
8
- type: 'item';
9
- key: string;
10
- }>;
11
- export type FieldDiffKind = 'added' | 'removed' | 'changed' | 'list_reordered';
12
- export type FieldDiff = Readonly<{
13
- kind: FieldDiffKind;
14
- path: readonly FieldPathSegment[];
15
- before: unknown;
16
- after: unknown;
17
- }>;
18
- export type FieldChange = Readonly<{
19
- kind: FieldDiffKind;
20
- path: string;
21
- before: unknown;
22
- after: unknown;
23
- redacted?: true;
24
- }>;
25
- export type FieldDiffIdentityInput = Readonly<{
26
- path: readonly FieldPathSegment[];
27
- item: unknown;
28
- index: number;
29
- }>;
30
- export type FieldDiffIdentity = (input: FieldDiffIdentityInput) => string | null | undefined;
31
- export type BuildFieldDiffOptions = Readonly<{
32
- identifyArrayItem?: FieldDiffIdentity;
33
- }>;
34
- export declare function buildFieldDiffs(local: Record<string, unknown>, remote: Record<string, unknown>, options?: BuildFieldDiffOptions): FieldDiff[];
35
- export declare function formatFieldPath(path: readonly FieldPathSegment[]): string;
36
- export declare function fieldDiffToChange(diff: FieldDiff): FieldChange;
37
- export declare function buildFieldChanges(local: Record<string, unknown>, remote: Record<string, unknown>, options?: BuildFieldDiffOptions): FieldChange[];
38
- export declare function formatFieldDiffValue(value: unknown, maxChars?: number): string;
39
- export declare function formatFieldChange(change: FieldChange): string;