create-nextblock 0.2.78 → 0.8.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 (413) hide show
  1. package/bin/create-nextblock.js +740 -459
  2. package/package.json +1 -2
  3. package/scripts/sync-template.js +18 -1
  4. package/templates/nextblock-template/.browserslistrc +11 -0
  5. package/templates/nextblock-template/.swcrc +30 -30
  6. package/templates/nextblock-template/README.md +23 -114
  7. package/templates/nextblock-template/app/(auth-pages)/post-sign-in/page.tsx +27 -28
  8. package/templates/nextblock-template/app/(auth-pages)/sign-in/page.tsx +50 -25
  9. package/templates/nextblock-template/app/(auth-pages)/sign-up/page.tsx +111 -56
  10. package/templates/nextblock-template/app/(auth-pages)/two-factor/actions.ts +91 -0
  11. package/templates/nextblock-template/app/(auth-pages)/two-factor/components/TwoFactorForm.tsx +118 -0
  12. package/templates/nextblock-template/app/(auth-pages)/two-factor/page.tsx +51 -0
  13. package/templates/nextblock-template/app/.well-known/ucp/route.ts +16 -0
  14. package/templates/nextblock-template/app/[slug]/PageClientContent.tsx +48 -28
  15. package/templates/nextblock-template/app/[slug]/page.tsx +63 -6
  16. package/templates/nextblock-template/app/[slug]/page.utils.ts +374 -157
  17. package/templates/nextblock-template/app/[slug]/pageClientActions.ts +7 -0
  18. package/templates/nextblock-template/app/actions/consent.ts +57 -0
  19. package/templates/nextblock-template/app/actions/formActions.ts +130 -11
  20. package/templates/nextblock-template/app/actions/languageActions.ts +31 -30
  21. package/templates/nextblock-template/app/actions/package-actions.ts +183 -0
  22. package/templates/nextblock-template/app/actions/postActions.ts +146 -48
  23. package/templates/nextblock-template/app/actions/twoFactorEmail.ts +21 -0
  24. package/templates/nextblock-template/app/actions/visualEditingActions.test.ts +179 -0
  25. package/templates/nextblock-template/app/actions/visualEditingActions.ts +345 -0
  26. package/templates/nextblock-template/app/actions.ts +67 -12
  27. package/templates/nextblock-template/app/api/ai/cortex/build-widget/route.ts +153 -0
  28. package/templates/nextblock-template/app/api/ai/generate-blocks/route.ts +96 -0
  29. package/templates/nextblock-template/app/api/ai/global-agent/route.ts +965 -0
  30. package/templates/nextblock-template/app/api/checkout/freemius/sync/route.ts +29 -0
  31. package/templates/nextblock-template/app/api/checkout/route.ts +146 -0
  32. package/templates/nextblock-template/app/api/cms/full-backup/export/route.ts +33 -0
  33. package/templates/nextblock-template/app/api/cms/full-backup/restore/route.ts +63 -0
  34. package/templates/nextblock-template/app/api/cron/reset-sandbox/route.ts +3413 -17
  35. package/templates/nextblock-template/app/api/cron/reset-sandbox/sandboxResetSql.ts +7830 -0
  36. package/templates/nextblock-template/app/api/cron/sync-currencies/route.ts +35 -0
  37. package/templates/nextblock-template/app/api/custom-blocks/db-relations/route.ts +92 -0
  38. package/templates/nextblock-template/app/api/custom-blocks/editor-definitions/route.ts +43 -0
  39. package/templates/nextblock-template/app/api/draft/disable/route.ts +25 -0
  40. package/templates/nextblock-template/app/api/draft/route.ts +93 -0
  41. package/templates/nextblock-template/app/api/draft/start/route.ts +77 -0
  42. package/templates/nextblock-template/app/api/media/library/route.ts +65 -0
  43. package/templates/nextblock-template/app/api/media/r2-presigned/route.ts +53 -0
  44. package/templates/nextblock-template/app/api/media/record/route.ts +160 -0
  45. package/templates/nextblock-template/app/api/search/route.ts +43 -0
  46. package/templates/nextblock-template/app/api/visual-editing/block-draft/route.ts +47 -0
  47. package/templates/nextblock-template/app/api/visual-editing/product-draft/route.ts +47 -0
  48. package/templates/nextblock-template/app/api/webhooks/freemius/route.ts +34 -0
  49. package/templates/nextblock-template/app/api/webhooks/stripe/route.ts +27 -0
  50. package/templates/nextblock-template/app/article/[slug]/PostClientContent.tsx +392 -128
  51. package/templates/nextblock-template/app/article/[slug]/page.tsx +179 -127
  52. package/templates/nextblock-template/app/article/[slug]/page.utils.ts +262 -77
  53. package/templates/nextblock-template/app/auth/callback/route.ts +31 -58
  54. package/templates/nextblock-template/app/cart/page.tsx +7 -0
  55. package/templates/nextblock-template/app/checkout/UcpCartHydrator.tsx +20 -0
  56. package/templates/nextblock-template/app/checkout/page.tsx +52 -0
  57. package/templates/nextblock-template/app/checkout/success/actions.ts +136 -0
  58. package/templates/nextblock-template/app/checkout/success/page.tsx +186 -0
  59. package/templates/nextblock-template/app/cms/CmsClientLayout.tsx +163 -33
  60. package/templates/nextblock-template/app/cms/blocks/actions.ts +424 -235
  61. package/templates/nextblock-template/app/cms/blocks/components/BackgroundSelector.tsx +212 -151
  62. package/templates/nextblock-template/app/cms/blocks/components/BlockEditorArea.tsx +41 -20
  63. package/templates/nextblock-template/app/cms/blocks/components/BlockEditorModal.tsx +152 -19
  64. package/templates/nextblock-template/app/cms/blocks/components/BlockTypeCard.tsx +25 -17
  65. package/templates/nextblock-template/app/cms/blocks/components/BlockTypeSelector.tsx +200 -18
  66. package/templates/nextblock-template/app/cms/blocks/components/ColumnEditor.tsx +33 -16
  67. package/templates/nextblock-template/app/cms/blocks/components/CustomBlockEditorPreview.tsx +160 -0
  68. package/templates/nextblock-template/app/cms/blocks/components/EditableBlock.tsx +37 -18
  69. package/templates/nextblock-template/app/cms/blocks/components/MediaLibraryModal.tsx +149 -67
  70. package/templates/nextblock-template/app/cms/blocks/components/SectionConfigPanel.tsx +108 -31
  71. package/templates/nextblock-template/app/cms/blocks/editors/DynamicCustomBlockEditor.tsx +167 -0
  72. package/templates/nextblock-template/app/cms/blocks/editors/FeaturedProductBlockEditor.tsx +31 -0
  73. package/templates/nextblock-template/app/cms/blocks/editors/FormBlockEditor.tsx +2 -2
  74. package/templates/nextblock-template/app/cms/blocks/editors/HeadingBlockEditor.tsx +1 -1
  75. package/templates/nextblock-template/app/cms/blocks/editors/ImageBlockEditor.tsx +29 -29
  76. package/templates/nextblock-template/app/cms/blocks/editors/PostsGridBlockEditor.tsx +14 -18
  77. package/templates/nextblock-template/app/cms/blocks/editors/ProductGridBlockEditor.tsx +41 -0
  78. package/templates/nextblock-template/app/cms/blocks/editors/SectionBlockEditor.tsx +318 -118
  79. package/templates/nextblock-template/app/cms/blocks/editors/TextBlockEditor.tsx +98 -21
  80. package/templates/nextblock-template/app/cms/blocks/editors/VideoEmbedBlockEditor.tsx +1 -1
  81. package/templates/nextblock-template/app/cms/components/ContentLanguageSwitcher.tsx +27 -9
  82. package/templates/nextblock-template/app/cms/components/CopyContentFromLanguage.tsx +1 -1
  83. package/templates/nextblock-template/app/cms/components/CortexAiActiveContext.tsx +23 -0
  84. package/templates/nextblock-template/app/cms/components/CortexAiPageContext.tsx +58 -0
  85. package/templates/nextblock-template/app/cms/components/CortexGlobalAgentChat.tsx +1507 -0
  86. package/templates/nextblock-template/app/cms/components/DraftStatusActions.tsx +145 -0
  87. package/templates/nextblock-template/app/cms/components/FeatureImageField.tsx +244 -0
  88. package/templates/nextblock-template/app/cms/components/FeedbackModal.tsx +38 -24
  89. package/templates/nextblock-template/app/cms/coupons/[id]/edit/page.tsx +16 -0
  90. package/templates/nextblock-template/app/cms/coupons/page.tsx +16 -0
  91. package/templates/nextblock-template/app/cms/custom-blocks/[id]/edit/page.tsx +66 -0
  92. package/templates/nextblock-template/app/cms/custom-blocks/actions.ts +519 -0
  93. package/templates/nextblock-template/app/cms/custom-blocks/components/BlockComposer.tsx +1522 -0
  94. package/templates/nextblock-template/app/cms/custom-blocks/components/BlocksLibraryTransferControls.tsx +256 -0
  95. package/templates/nextblock-template/app/cms/custom-blocks/components/DBRelationSelect.tsx +384 -0
  96. package/templates/nextblock-template/app/cms/custom-blocks/components/ImageR2Picker.tsx +221 -0
  97. package/templates/nextblock-template/app/cms/custom-blocks/new/page.tsx +12 -0
  98. package/templates/nextblock-template/app/cms/custom-blocks/page.tsx +438 -0
  99. package/templates/nextblock-template/app/cms/dashboard/actions.ts +228 -98
  100. package/templates/nextblock-template/app/cms/dashboard/components/DashboardComponents.tsx +200 -0
  101. package/templates/nextblock-template/app/cms/dashboard/page.tsx +182 -154
  102. package/templates/nextblock-template/app/cms/import-export/ContentTransferControls.tsx +391 -0
  103. package/templates/nextblock-template/app/cms/import-export/actions.ts +226 -0
  104. package/templates/nextblock-template/app/cms/layout.tsx +29 -10
  105. package/templates/nextblock-template/app/cms/media/UploadFolderContext.tsx +22 -22
  106. package/templates/nextblock-template/app/cms/media/actions.ts +45 -124
  107. package/templates/nextblock-template/app/cms/media/components/DeleteMediaButtonClient.tsx +1 -1
  108. package/templates/nextblock-template/app/cms/media/components/MediaEditForm.tsx +26 -26
  109. package/templates/nextblock-template/app/cms/media/components/MediaGridClient.tsx +69 -64
  110. package/templates/nextblock-template/app/cms/media/components/MediaPickerDialog.tsx +227 -158
  111. package/templates/nextblock-template/app/cms/media/components/MediaUploadForm.tsx +101 -89
  112. package/templates/nextblock-template/app/cms/media/page.tsx +1 -1
  113. package/templates/nextblock-template/app/cms/navigation/components/NavigationItemForm.tsx +2 -2
  114. package/templates/nextblock-template/app/cms/orders/[id]/MarkPaidButton.tsx +44 -0
  115. package/templates/nextblock-template/app/cms/orders/[id]/page.tsx +16 -0
  116. package/templates/nextblock-template/app/cms/orders/actions.ts +201 -0
  117. package/templates/nextblock-template/app/cms/orders/page.tsx +20 -0
  118. package/templates/nextblock-template/app/cms/orders/types.ts +20 -0
  119. package/templates/nextblock-template/app/cms/pages/[id]/edit/EditPageClient.tsx +156 -121
  120. package/templates/nextblock-template/app/cms/pages/[id]/edit/page.tsx +79 -26
  121. package/templates/nextblock-template/app/cms/pages/actions.ts +54 -38
  122. package/templates/nextblock-template/app/cms/pages/components/DeletePageButtonClient.tsx +1 -1
  123. package/templates/nextblock-template/app/cms/pages/components/PageForm.tsx +267 -116
  124. package/templates/nextblock-template/app/cms/pages/page.tsx +25 -18
  125. package/templates/nextblock-template/app/cms/payments/page.tsx +16 -0
  126. package/templates/nextblock-template/app/cms/posts/[id]/edit/page.tsx +132 -90
  127. package/templates/nextblock-template/app/cms/posts/actions.ts +71 -72
  128. package/templates/nextblock-template/app/cms/posts/components/DeletePostButtonClient.tsx +1 -1
  129. package/templates/nextblock-template/app/cms/posts/components/PostForm.tsx +256 -245
  130. package/templates/nextblock-template/app/cms/posts/new/page.tsx +1 -1
  131. package/templates/nextblock-template/app/cms/posts/page.tsx +20 -13
  132. package/templates/nextblock-template/app/cms/products/ClientNotionEditor.tsx +16 -0
  133. package/templates/nextblock-template/app/cms/products/ProductFormClientShell.tsx +56 -0
  134. package/templates/nextblock-template/app/cms/products/[id]/edit/page.tsx +292 -0
  135. package/templates/nextblock-template/app/cms/products/attributes/page.tsx +12 -0
  136. package/templates/nextblock-template/app/cms/products/categories/page.tsx +12 -0
  137. package/templates/nextblock-template/app/cms/products/inventory/page.tsx +13 -0
  138. package/templates/nextblock-template/app/cms/products/new/page.tsx +143 -0
  139. package/templates/nextblock-template/app/cms/products/page.tsx +42 -0
  140. package/templates/nextblock-template/app/cms/products/productFormData.ts +133 -0
  141. package/templates/nextblock-template/app/cms/products/settings/page.tsx +5 -0
  142. package/templates/nextblock-template/app/cms/promotions/PromotionsWorkspace.tsx +456 -0
  143. package/templates/nextblock-template/app/cms/promotions/actions.ts +115 -0
  144. package/templates/nextblock-template/app/cms/promotions/page.tsx +31 -0
  145. package/templates/nextblock-template/app/cms/revisions/RevisionHistoryButton.tsx +2 -2
  146. package/templates/nextblock-template/app/cms/revisions/actions.ts +285 -285
  147. package/templates/nextblock-template/app/cms/revisions/service.ts +19 -16
  148. package/templates/nextblock-template/app/cms/revisions/utils.ts +8 -3
  149. package/templates/nextblock-template/app/cms/settings/backup-restore/BackupRestoreWorkspace.tsx +1004 -0
  150. package/templates/nextblock-template/app/cms/settings/backup-restore/page.tsx +29 -0
  151. package/templates/nextblock-template/app/cms/settings/bot-protection/actions.ts +93 -0
  152. package/templates/nextblock-template/app/cms/settings/bot-protection/components/BotProtectionForm.tsx +129 -0
  153. package/templates/nextblock-template/app/cms/settings/bot-protection/page.tsx +24 -0
  154. package/templates/nextblock-template/app/cms/settings/copyright/actions.ts +1 -1
  155. package/templates/nextblock-template/app/cms/settings/copyright/components/CopyrightForm.tsx +2 -2
  156. package/templates/nextblock-template/app/cms/settings/copyright/page.tsx +1 -1
  157. package/templates/nextblock-template/app/cms/settings/cortex-ai/SandboxCortexAiSettingsClient.tsx +496 -0
  158. package/templates/nextblock-template/app/cms/settings/cortex-ai/StoredCortexAiSettingsClient.tsx +410 -0
  159. package/templates/nextblock-template/app/cms/settings/cortex-ai/actions.ts +248 -0
  160. package/templates/nextblock-template/app/cms/settings/cortex-ai/page.tsx +80 -0
  161. package/templates/nextblock-template/app/cms/settings/currencies/actions.ts +331 -0
  162. package/templates/nextblock-template/app/cms/settings/currencies/page.tsx +494 -0
  163. package/templates/nextblock-template/app/cms/settings/extra-translations/ExtraTranslationsWorkspace.tsx +767 -0
  164. package/templates/nextblock-template/app/cms/settings/extra-translations/actions.ts +203 -44
  165. package/templates/nextblock-template/app/cms/settings/extra-translations/page.tsx +93 -242
  166. package/templates/nextblock-template/app/cms/settings/global-css/actions.ts +65 -0
  167. package/templates/nextblock-template/app/cms/settings/global-css/components/GlobalCssForm.tsx +46 -0
  168. package/templates/nextblock-template/app/cms/settings/global-css/page.tsx +24 -0
  169. package/templates/nextblock-template/app/cms/settings/languages/components/DeleteLanguageButton.tsx +1 -1
  170. package/templates/nextblock-template/app/cms/settings/languages/components/LanguageForm.tsx +2 -2
  171. package/templates/nextblock-template/app/cms/settings/languages/page.tsx +1 -1
  172. package/templates/nextblock-template/app/cms/settings/logos/[id]/edit/page.tsx +7 -7
  173. package/templates/nextblock-template/app/cms/settings/logos/actions.ts +82 -6
  174. package/templates/nextblock-template/app/cms/settings/logos/components/BrandingSettingsForm.tsx +339 -0
  175. package/templates/nextblock-template/app/cms/settings/logos/components/DeleteLogoButton.tsx +21 -18
  176. package/templates/nextblock-template/app/cms/settings/logos/components/LogoForm.tsx +20 -16
  177. package/templates/nextblock-template/app/cms/settings/logos/components/SiteSeoSettingsForm.tsx +133 -0
  178. package/templates/nextblock-template/app/cms/settings/logos/new/page.tsx +8 -8
  179. package/templates/nextblock-template/app/cms/settings/logos/page.tsx +120 -82
  180. package/templates/nextblock-template/app/cms/settings/logos/types.ts +8 -8
  181. package/templates/nextblock-template/app/cms/settings/packages/activation-form.tsx +84 -0
  182. package/templates/nextblock-template/app/cms/settings/packages/package-card.tsx +122 -0
  183. package/templates/nextblock-template/app/cms/settings/packages/page.tsx +49 -0
  184. package/templates/nextblock-template/app/cms/settings/privacy/actions.ts +53 -0
  185. package/templates/nextblock-template/app/cms/settings/privacy/components/PrivacyForm.tsx +196 -0
  186. package/templates/nextblock-template/app/cms/settings/privacy/page.tsx +26 -0
  187. package/templates/nextblock-template/app/cms/settings/security/actions.ts +251 -0
  188. package/templates/nextblock-template/app/cms/settings/security/components/SecurityPanel.tsx +453 -0
  189. package/templates/nextblock-template/app/cms/settings/security/page.tsx +13 -0
  190. package/templates/nextblock-template/app/cms/settings/taxes/page.tsx +21 -0
  191. package/templates/nextblock-template/app/cms/shipping/page.tsx +20 -0
  192. package/templates/nextblock-template/app/cms/users/[id]/edit/page.tsx +28 -23
  193. package/templates/nextblock-template/app/cms/users/actions.ts +105 -40
  194. package/templates/nextblock-template/app/cms/users/components/DeleteUserButton.tsx +1 -1
  195. package/templates/nextblock-template/app/cms/users/components/UserForm.tsx +65 -152
  196. package/templates/nextblock-template/app/cms/users/page.tsx +15 -10
  197. package/templates/nextblock-template/app/globals.css +9 -0
  198. package/templates/nextblock-template/app/layout.tsx +372 -120
  199. package/templates/nextblock-template/app/lib/seo.test.ts +52 -0
  200. package/templates/nextblock-template/app/lib/seo.ts +279 -0
  201. package/templates/nextblock-template/app/lib/site-settings.ts +87 -0
  202. package/templates/nextblock-template/app/lib/sitemap-utils.ts +224 -39
  203. package/templates/nextblock-template/app/lib/ucp/protocol.ts +190 -0
  204. package/templates/nextblock-template/app/lib/ucp/server.test.ts +56 -0
  205. package/templates/nextblock-template/app/lib/ucp/server.ts +1914 -0
  206. package/templates/nextblock-template/app/page.tsx +165 -73
  207. package/templates/nextblock-template/app/product/[slug]/page.tsx +433 -0
  208. package/templates/nextblock-template/app/profile/ProfileAccountSidebar.tsx +73 -0
  209. package/templates/nextblock-template/app/profile/ProfilePageHeader.tsx +16 -0
  210. package/templates/nextblock-template/app/profile/ProfilePageMissingState.tsx +9 -0
  211. package/templates/nextblock-template/app/profile/account-data.ts +37 -0
  212. package/templates/nextblock-template/app/profile/account-links.ts +22 -0
  213. package/templates/nextblock-template/app/profile/account-types.ts +11 -0
  214. package/templates/nextblock-template/app/profile/orders/CustomerOrdersPageClient.tsx +124 -0
  215. package/templates/nextblock-template/app/profile/orders/[id]/CustomerOrderDetailPageClient.tsx +79 -0
  216. package/templates/nextblock-template/app/profile/orders/[id]/page.tsx +32 -0
  217. package/templates/nextblock-template/app/profile/orders/page.tsx +19 -0
  218. package/templates/nextblock-template/app/profile/page.tsx +51 -0
  219. package/templates/nextblock-template/app/profile/password/PasswordSettingsPageClient.tsx +128 -0
  220. package/templates/nextblock-template/app/profile/password/actions.ts +59 -0
  221. package/templates/nextblock-template/app/profile/password/page.tsx +27 -0
  222. package/templates/nextblock-template/app/providers.tsx +55 -17
  223. package/templates/nextblock-template/app/robots.txt/route.ts +11 -1
  224. package/templates/nextblock-template/app/sitemap.ts +128 -0
  225. package/templates/nextblock-template/app/ucp/v1/carts/[id]/cancel/route.ts +38 -0
  226. package/templates/nextblock-template/app/ucp/v1/carts/[id]/route.ts +68 -0
  227. package/templates/nextblock-template/app/ucp/v1/carts/route.ts +35 -0
  228. package/templates/nextblock-template/app/ucp/v1/catalog/lookup/route.ts +35 -0
  229. package/templates/nextblock-template/app/ucp/v1/catalog/product/route.ts +35 -0
  230. package/templates/nextblock-template/app/ucp/v1/catalog/search/route.ts +34 -0
  231. package/templates/nextblock-template/components/AppShell.tsx +154 -0
  232. package/templates/nextblock-template/components/BlockRenderer.tsx +210 -64
  233. package/templates/nextblock-template/components/CartDrawerLoader.tsx +7 -0
  234. package/templates/nextblock-template/components/CartTranslator.tsx +210 -0
  235. package/templates/nextblock-template/components/CurrentContentSetter.tsx +25 -0
  236. package/templates/nextblock-template/components/DeferredCartDrawer.tsx +23 -0
  237. package/templates/nextblock-template/components/DeferredCartTranslator.tsx +51 -0
  238. package/templates/nextblock-template/components/DeferredGlobalSearch.tsx +68 -0
  239. package/templates/nextblock-template/components/DeferredGoogleTagManager.tsx +70 -0
  240. package/templates/nextblock-template/components/DeferredSpeedInsights.tsx +69 -0
  241. package/templates/nextblock-template/components/FeatureImageHero.tsx +47 -0
  242. package/templates/nextblock-template/components/GitHubLoginButton.tsx +36 -0
  243. package/templates/nextblock-template/components/GlobalSearch.tsx +557 -0
  244. package/templates/nextblock-template/components/Header.tsx +49 -41
  245. package/templates/nextblock-template/components/LanguageSwitcher.tsx +55 -32
  246. package/templates/nextblock-template/components/ResponsiveNav.tsx +138 -43
  247. package/templates/nextblock-template/components/blocks/PostCardSkeleton.tsx +12 -8
  248. package/templates/nextblock-template/components/blocks/PostsGridBlock.tsx +12 -55
  249. package/templates/nextblock-template/components/blocks/PostsGridClient.tsx +42 -37
  250. package/templates/nextblock-template/components/blocks/TestimonialBlock.tsx +6 -2
  251. package/templates/nextblock-template/components/blocks/ecommerceRendererLoaders.ts +23 -0
  252. package/templates/nextblock-template/components/blocks/publicRendererLoaders.ts +25 -0
  253. package/templates/nextblock-template/components/blocks/renderers/ButtonBlockRenderer.tsx +92 -84
  254. package/templates/nextblock-template/components/blocks/renderers/CartBlockRenderer.tsx +17 -0
  255. package/templates/nextblock-template/components/blocks/renderers/CheckoutBlockRenderer.tsx +19 -0
  256. package/templates/nextblock-template/components/blocks/renderers/ClientTextBlockRenderer.tsx +262 -8
  257. package/templates/nextblock-template/components/blocks/renderers/FeaturedProductBlockRenderer.tsx +22 -0
  258. package/templates/nextblock-template/components/blocks/renderers/FormBlockRenderer.tsx +320 -37
  259. package/templates/nextblock-template/components/blocks/renderers/HeadingBlockRenderer.tsx +11 -8
  260. package/templates/nextblock-template/components/blocks/renderers/ImageBlockRenderer.tsx +12 -3
  261. package/templates/nextblock-template/components/blocks/renderers/PostsGridBlockRenderer.tsx +18 -13
  262. package/templates/nextblock-template/components/blocks/renderers/ProductDetailsBlockRenderer.tsx +90 -0
  263. package/templates/nextblock-template/components/blocks/renderers/ProductGridBlockRenderer.tsx +31 -0
  264. package/templates/nextblock-template/components/blocks/renderers/SectionBlockRenderer.tsx +424 -55
  265. package/templates/nextblock-template/components/blocks/renderers/SectionSlider.tsx +137 -0
  266. package/templates/nextblock-template/components/blocks/renderers/TestimonialBlockRenderer.tsx +57 -0
  267. package/templates/nextblock-template/components/blocks/renderers/TextBlockRenderer.tsx +37 -22
  268. package/templates/nextblock-template/components/blocks/renderers/VideoEmbedBlockRenderer.tsx +23 -15
  269. package/templates/nextblock-template/components/blocks/renderers/inline/AlertWidgetRenderer.tsx +1 -3
  270. package/templates/nextblock-template/components/blocks/renderers/inline/CtaWidgetRenderer.tsx +1 -3
  271. package/templates/nextblock-template/components/blocks/types.ts +7 -6
  272. package/templates/nextblock-template/components/env-var-warning.tsx +3 -3
  273. package/templates/nextblock-template/components/form-message.tsx +32 -26
  274. package/templates/nextblock-template/components/header-auth.tsx +69 -17
  275. package/templates/nextblock-template/components/privacy/ConsentBanner.tsx +127 -0
  276. package/templates/nextblock-template/components/privacy/ConsentGatedAnalytics.tsx +59 -0
  277. package/templates/nextblock-template/components/renderers/CachedDynamicLayoutEngine.tsx +28 -0
  278. package/templates/nextblock-template/components/renderers/DynamicLayoutEngine.test.tsx +166 -0
  279. package/templates/nextblock-template/components/renderers/DynamicLayoutEngine.tsx +464 -0
  280. package/templates/nextblock-template/components/theme-switcher.tsx +8 -8
  281. package/templates/nextblock-template/components/visual-editing/DeferredVisualEditing.tsx +21 -0
  282. package/templates/nextblock-template/components/visual-editing/NextblockVisualEditing.tsx +1172 -0
  283. package/templates/nextblock-template/context/AuthContext.tsx +23 -90
  284. package/templates/nextblock-template/context/CurrentContentContext.tsx +10 -4
  285. package/templates/nextblock-template/context/LanguageContext.tsx +16 -16
  286. package/templates/nextblock-template/context/language-rest-client.ts +31 -0
  287. package/templates/nextblock-template/docs/01-PROJECT-OVERVIEW.md +94 -0
  288. package/templates/nextblock-template/docs/02-ECOMMERCE-CAPABILITIES.md +364 -0
  289. package/templates/nextblock-template/docs/03-CMS-AND-EDITOR.md +202 -0
  290. package/templates/nextblock-template/docs/04-DATABASE-AND-AUTH.md +252 -0
  291. package/templates/nextblock-template/docs/05-DEVELOPER-GUIDE.md +238 -0
  292. package/templates/nextblock-template/docs/06-CLI-AND-SCAFFOLDING.md +125 -0
  293. package/templates/nextblock-template/docs/07-BLOCK-SDK-AND-EXTENSIBILITY.md +146 -0
  294. package/templates/nextblock-template/docs/08-NEXTBLOCK-CORTEX-AI-ARCHITECTURE.md +1319 -0
  295. package/templates/nextblock-template/docs/09-LIVE-DRAFT-MODE.md +104 -0
  296. package/templates/nextblock-template/docs/10-CUSTOM-BLOCKS.md +222 -0
  297. package/templates/nextblock-template/docs/README.md +34 -0
  298. package/templates/nextblock-template/docs/TECHNICAL_SPECIFICATION.md +12507 -0
  299. package/templates/nextblock-template/hooks/use-hotkeys.ts +21 -14
  300. package/templates/nextblock-template/hooks/useGlobalSearch.ts +101 -0
  301. package/templates/nextblock-template/index.d.ts +2 -0
  302. package/templates/nextblock-template/lib/ai-block-generation.ts +339 -0
  303. package/templates/nextblock-template/lib/ai-client.ts +247 -0
  304. package/templates/nextblock-template/lib/ai-config.ts +81 -0
  305. package/templates/nextblock-template/lib/ai-cortex-widget-builder.ts +125 -0
  306. package/templates/nextblock-template/lib/ai-global-agent-custom-block-tools.ts +363 -0
  307. package/templates/nextblock-template/lib/ai-global-agent-db-tools.test.ts +405 -0
  308. package/templates/nextblock-template/lib/ai-global-agent-db-tools.ts +1228 -0
  309. package/templates/nextblock-template/lib/ai-global-agent-ecommerce.ts +5 -0
  310. package/templates/nextblock-template/lib/ai-global-agent-tools-stats.test.ts +223 -0
  311. package/templates/nextblock-template/lib/ai-global-agent-tools.test.ts +2183 -0
  312. package/templates/nextblock-template/lib/ai-global-agent-tools.ts +4807 -0
  313. package/templates/nextblock-template/lib/ai-key-crypto.test.ts +70 -0
  314. package/templates/nextblock-template/lib/ai-key-crypto.ts +132 -0
  315. package/templates/nextblock-template/lib/ai-model-catalog.test.ts +49 -0
  316. package/templates/nextblock-template/lib/ai-model-catalog.ts +41 -0
  317. package/templates/nextblock-template/lib/ai-model-registry.test.ts +231 -0
  318. package/templates/nextblock-template/lib/ai-model-registry.ts +522 -0
  319. package/templates/nextblock-template/lib/auth/cookies.ts +47 -0
  320. package/templates/nextblock-template/lib/auth/crypto.ts +42 -0
  321. package/templates/nextblock-template/lib/auth/trustedDevices.ts +92 -0
  322. package/templates/nextblock-template/lib/auth/twoFactor.ts +167 -0
  323. package/templates/nextblock-template/lib/auth-redirects.ts +46 -0
  324. package/templates/nextblock-template/lib/blocks/FeaturedProductBlock.tsx +94 -0
  325. package/templates/nextblock-template/lib/blocks/ProductGridBlock.tsx +137 -0
  326. package/templates/nextblock-template/lib/blocks/README.md +13 -670
  327. package/templates/nextblock-template/lib/blocks/blockRegistry.ts +138 -56
  328. package/templates/nextblock-template/lib/blocks/blockTypes.ts +18 -0
  329. package/templates/nextblock-template/lib/blocks/ecommerce-block-schemas.ts +31 -0
  330. package/templates/nextblock-template/lib/cms-transfer/csv.test.ts +77 -0
  331. package/templates/nextblock-template/lib/cms-transfer/csv.ts +399 -0
  332. package/templates/nextblock-template/lib/cms-transfer/server.ts +2243 -0
  333. package/templates/nextblock-template/lib/cms-transfer/types.ts +145 -0
  334. package/templates/nextblock-template/lib/cortex-widget-registry.test.ts +199 -0
  335. package/templates/nextblock-template/lib/cortex-widget-registry.ts +88 -0
  336. package/templates/nextblock-template/lib/cortex-widget-schema.test.tsx +237 -0
  337. package/templates/nextblock-template/lib/cortex-widget-schema.ts +393 -0
  338. package/templates/nextblock-template/lib/custom-block-definitions.ts +87 -0
  339. package/templates/nextblock-template/lib/custom-block-r2-upload-shared.ts +178 -0
  340. package/templates/nextblock-template/lib/custom-block-r2-upload.test.ts +140 -0
  341. package/templates/nextblock-template/lib/custom-block-r2-upload.ts +68 -0
  342. package/templates/nextblock-template/lib/custom-block-relation-registry.ts +256 -0
  343. package/templates/nextblock-template/lib/custom-block-relations.test.ts +227 -0
  344. package/templates/nextblock-template/lib/custom-block-relations.ts +279 -0
  345. package/templates/nextblock-template/lib/custom-block-safelist.ts +14 -0
  346. package/templates/nextblock-template/lib/editor/dynamic-extension-core.test.ts +172 -0
  347. package/templates/nextblock-template/lib/editor/dynamic-extension-core.ts +213 -0
  348. package/templates/nextblock-template/lib/editor/dynamic-extension-loader.ts +22 -0
  349. package/templates/nextblock-template/lib/editor/dynamic-extensions.tsx +193 -0
  350. package/templates/nextblock-template/lib/full-backup/manifest.test.ts +121 -0
  351. package/templates/nextblock-template/lib/full-backup/manifest.ts +206 -0
  352. package/templates/nextblock-template/lib/full-backup/server.ts +743 -0
  353. package/templates/nextblock-template/lib/media/resolveMediaUrl.ts +45 -0
  354. package/templates/nextblock-template/lib/posts/readTime.ts +60 -0
  355. package/templates/nextblock-template/lib/privacy/consent-client.ts +57 -0
  356. package/templates/nextblock-template/lib/privacy/settings.ts +103 -0
  357. package/templates/nextblock-template/lib/privacy/types.ts +67 -0
  358. package/templates/nextblock-template/lib/promotions/server.test.ts +74 -0
  359. package/templates/nextblock-template/lib/promotions/server.ts +741 -0
  360. package/templates/nextblock-template/lib/resolve-block-relations.test.ts +142 -0
  361. package/templates/nextblock-template/lib/resolve-block-relations.ts +255 -0
  362. package/templates/nextblock-template/lib/search/server.ts +585 -0
  363. package/templates/nextblock-template/lib/search/types.ts +27 -0
  364. package/templates/nextblock-template/lib/visual-editing/draft-content.test.ts +105 -0
  365. package/templates/nextblock-template/lib/visual-editing/draft-content.ts +380 -0
  366. package/templates/nextblock-template/lib/visual-editing/draft-route.test.ts +42 -0
  367. package/templates/nextblock-template/lib/visual-editing/draft-route.ts +82 -0
  368. package/templates/nextblock-template/lib/visual-editing/edit-info.test.ts +143 -0
  369. package/templates/nextblock-template/lib/visual-editing/edit-info.ts +94 -0
  370. package/templates/nextblock-template/lib/visual-editing/mutations.ts +190 -0
  371. package/templates/nextblock-template/lib/visual-editing/product-drafts.test.ts +81 -0
  372. package/templates/nextblock-template/lib/visual-editing/product-drafts.ts +511 -0
  373. package/templates/nextblock-template/lib/visual-editing/types.ts +122 -0
  374. package/templates/nextblock-template/lib/zod-config.ts +5 -0
  375. package/templates/nextblock-template/next.config.js +190 -66
  376. package/templates/nextblock-template/package.json +34 -30
  377. package/templates/nextblock-template/proxy.ts +435 -253
  378. package/templates/nextblock-template/public/images/NBcover.webp +0 -0
  379. package/templates/nextblock-template/public/images/cap.webp +0 -0
  380. package/templates/nextblock-template/public/images/commerce-plan.webp +0 -0
  381. package/templates/nextblock-template/public/images/commerce-square.webp +0 -0
  382. package/templates/nextblock-template/public/images/commerce-wide.webp +0 -0
  383. package/templates/nextblock-template/public/images/cortex-ai-square.webp +0 -0
  384. package/templates/nextblock-template/public/images/cortex-ai.webp +0 -0
  385. package/templates/nextblock-template/public/images/extensibility.webp +0 -0
  386. package/templates/nextblock-template/public/images/goals.webp +0 -0
  387. package/templates/nextblock-template/public/images/included.webp +0 -0
  388. package/templates/nextblock-template/public/images/nx-graph.webp +0 -0
  389. package/templates/nextblock-template/public/images/pants.webp +0 -0
  390. package/templates/nextblock-template/public/images/t-shirt.webp +0 -0
  391. package/templates/nextblock-template/scripts/validate-editor-block-schema.ts +112 -0
  392. package/templates/nextblock-template/scripts/verify-cortex-ai-build-widget.tsx +100 -0
  393. package/templates/nextblock-template/scripts/verify-cortex-ai-generate-blocks.ts +62 -0
  394. package/templates/nextblock-template/scripts/verify-cortex-ai-global-tools.ts +537 -0
  395. package/templates/nextblock-template/scripts/verify-cortex-ai-routing.ts +58 -0
  396. package/templates/nextblock-template/scripts/verify-custom-block-definitions.ts +188 -0
  397. package/templates/nextblock-template/scripts/verify-dynamic-custom-block-extensions.ts +123 -0
  398. package/templates/nextblock-template/scripts/verify-dynamic-layout-engine.tsx +133 -0
  399. package/templates/nextblock-template/scripts/verify-milestone-2-custom-blocks.ts +65 -0
  400. package/templates/nextblock-template/tailwind.config.js +1 -0
  401. package/templates/nextblock-template/tools/configure-supabase-auth.js +282 -0
  402. package/templates/nextblock-template/tools/deploy-supabase.js +69 -71
  403. package/templates/nextblock-template/tsconfig.json +52 -66
  404. package/templates/nextblock-template/tsconfig.tsbuildinfo +1 -1
  405. package/templates/nextblock-template/types/jsdom.d.ts +6 -0
  406. package/templates/nextblock-template/app/force-styles.tsx +0 -31
  407. package/templates/nextblock-template/app/sitemap.xml/route.ts +0 -63
  408. package/templates/nextblock-template/components/blocks/renderers/HeroBlockRenderer.tsx +0 -273
  409. package/templates/nextblock-template/docs/How to Create a Custom Block.md +0 -149
  410. package/templates/nextblock-template/docs/cms-application-overview.md +0 -56
  411. package/templates/nextblock-template/docs/cms-architecture-overview.md +0 -73
  412. package/templates/nextblock-template/docs/files-structure.md +0 -426
  413. package/templates/nextblock-template/docs/tiptap-bundle-optimization-summary.md +0 -174
@@ -0,0 +1,743 @@
1
+ import "server-only";
2
+
3
+ import { spawn } from "node:child_process";
4
+ import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
5
+ import { readFileSync } from "node:fs";
6
+ import { tmpdir } from "node:os";
7
+ import path from "node:path";
8
+ import {
9
+ DeleteObjectsCommand,
10
+ GetObjectCommand,
11
+ ListObjectsV2Command,
12
+ PutObjectCommand,
13
+ type S3Client,
14
+ } from "@aws-sdk/client-s3";
15
+ import { createClient, getServiceRoleSupabaseClient } from "@nextblock-cms/db/server";
16
+ import { getS3Client } from "@nextblock-cms/utils/server";
17
+ import { strFromU8, strToU8, unzipSync, zipSync } from "fflate";
18
+
19
+ import { exportBackupBundle } from "../cms-transfer/server";
20
+ import {
21
+ FULL_BACKUP_CONFIRMATION,
22
+ FULL_BACKUP_CONTENT_PATH,
23
+ FULL_BACKUP_DATABASE_PATH,
24
+ FULL_BACKUP_MANIFEST_PATH,
25
+ archivePathForObjectKey,
26
+ isValidFullBackupConfirmation,
27
+ normalizeMediaBaseUrl,
28
+ parseFullBackupManifest,
29
+ replaceMediaBaseUrlInJson,
30
+ replaceMediaBaseUrlInString,
31
+ type FullBackupManifestV1,
32
+ type FullBackupMediaUrlMode,
33
+ type FullBackupStorageObjectManifest,
34
+ } from "./manifest";
35
+
36
+ type SupabaseAny = ReturnType<typeof getServiceRoleSupabaseClient>;
37
+
38
+ interface CommandResult {
39
+ stdout: string;
40
+ stderr: string;
41
+ }
42
+
43
+ interface DatabaseConnectionParts {
44
+ host: string;
45
+ port: string;
46
+ dbName: string;
47
+ user: string;
48
+ password: string;
49
+ sslMode: string;
50
+ }
51
+
52
+ interface FullBackupArchiveInspection {
53
+ manifest: FullBackupManifestV1;
54
+ files: Record<string, Uint8Array>;
55
+ warnings: string[];
56
+ databaseDumpBytes: number;
57
+ contentBundleBytes: number;
58
+ missingStorageObjects: string[];
59
+ }
60
+
61
+ export interface FullBackupReviewSummary {
62
+ success: boolean;
63
+ error?: string;
64
+ exportedAt?: string;
65
+ sourceBucket?: string | null;
66
+ sourceBaseUrl?: string | null;
67
+ databaseDumpBytes?: number;
68
+ contentBundleBytes?: number;
69
+ storageObjects?: number;
70
+ missingStorageObjects?: number;
71
+ warnings: string[];
72
+ }
73
+
74
+ export interface FullBackupRestoreSummary extends FullBackupReviewSummary {
75
+ databaseRestored?: boolean;
76
+ storageObjectsUploaded?: number;
77
+ storageObjectsDeleted?: number;
78
+ mediaUrlRewriteMode?: FullBackupMediaUrlMode;
79
+ mediaUrlRowsUpdated?: number;
80
+ }
81
+
82
+ export interface FullBackupArchiveExport {
83
+ fileName: string;
84
+ mimeType: string;
85
+ content: Buffer;
86
+ manifest: FullBackupManifestV1;
87
+ }
88
+
89
+ const ARCHIVE_MIME_TYPE = "application/zip";
90
+
91
+ function dateStamp() {
92
+ return new Date().toISOString().slice(0, 10);
93
+ }
94
+
95
+ function readAppVersion() {
96
+ try {
97
+ const packageJson = JSON.parse(readFileSync(path.join(process.cwd(), "package.json"), "utf8")) as {
98
+ version?: string;
99
+ };
100
+ return packageJson.version || null;
101
+ } catch {
102
+ return null;
103
+ }
104
+ }
105
+
106
+ async function requireAdminUser() {
107
+ const supabase = createClient();
108
+ const {
109
+ data: { user },
110
+ } = await supabase.auth.getUser();
111
+
112
+ if (!user) {
113
+ throw new Error("User not authenticated.");
114
+ }
115
+
116
+ const { data: profile, error } = await supabase
117
+ .from("profiles")
118
+ .select("role")
119
+ .eq("id", user.id)
120
+ .single();
121
+
122
+ if (error || profile?.role !== "ADMIN") {
123
+ throw new Error("Admin role required.");
124
+ }
125
+ }
126
+
127
+ export async function requireFullBackupAdmin() {
128
+ await requireAdminUser();
129
+ }
130
+
131
+ function getDatabaseConnectionParts(): DatabaseConnectionParts {
132
+ const dbUrl = process.env.POSTGRES_URL || process.env.DATABASE_URL;
133
+ if (!dbUrl) {
134
+ throw new Error("POSTGRES_URL or DATABASE_URL is required for full database backup/restore.");
135
+ }
136
+
137
+ let connectionUrl: URL;
138
+ try {
139
+ connectionUrl = new URL(dbUrl);
140
+ } catch (error) {
141
+ throw new Error(
142
+ `Database connection URL is invalid: ${error instanceof Error ? error.message : "unknown error"}`
143
+ );
144
+ }
145
+
146
+ return {
147
+ host: connectionUrl.hostname,
148
+ port: connectionUrl.port || "5432",
149
+ dbName: decodeURIComponent(connectionUrl.pathname.replace(/^\//, "")),
150
+ user: decodeURIComponent(connectionUrl.username),
151
+ password: decodeURIComponent(connectionUrl.password),
152
+ sslMode: connectionUrl.searchParams.get("sslmode") || "require",
153
+ };
154
+ }
155
+
156
+ function buildDatabaseEnv(parts: DatabaseConnectionParts) {
157
+ return {
158
+ ...process.env,
159
+ PGPASSWORD: parts.password,
160
+ PGSSLMODE: parts.sslMode,
161
+ };
162
+ }
163
+
164
+ function appendLimited(current: string, chunk: Buffer, limit = 16_000) {
165
+ const next = `${current}${chunk.toString()}`;
166
+ return next.length > limit ? next.slice(next.length - limit) : next;
167
+ }
168
+
169
+ function runCommand(command: string, args: string[], options?: { env?: NodeJS.ProcessEnv; cwd?: string }) {
170
+ return new Promise<CommandResult>((resolve, reject) => {
171
+ const child = spawn(command, args, {
172
+ cwd: options?.cwd,
173
+ env: options?.env,
174
+ windowsHide: true,
175
+ });
176
+
177
+ let stdout = "";
178
+ let stderr = "";
179
+
180
+ child.stdout.on("data", (chunk: Buffer) => {
181
+ stdout = appendLimited(stdout, chunk);
182
+ });
183
+ child.stderr.on("data", (chunk: Buffer) => {
184
+ stderr = appendLimited(stderr, chunk);
185
+ });
186
+ child.on("error", (error) => {
187
+ reject(new Error(`${command} could not start: ${error.message}`));
188
+ });
189
+ child.on("close", (code) => {
190
+ if (code === 0) {
191
+ resolve({ stdout, stderr });
192
+ return;
193
+ }
194
+
195
+ reject(
196
+ new Error(
197
+ `${command} exited with code ${code}.${stderr ? `\n${stderr.trim()}` : stdout ? `\n${stdout.trim()}` : ""}`
198
+ )
199
+ );
200
+ });
201
+ });
202
+ }
203
+
204
+ async function assertCommandAvailable(command: "pg_dump" | "psql") {
205
+ try {
206
+ await runCommand(command, ["--version"]);
207
+ } catch (error) {
208
+ throw new Error(
209
+ `${command} is required for full ZIP backup/restore but is not available to the server process. ${
210
+ error instanceof Error ? error.message : ""
211
+ }`.trim()
212
+ );
213
+ }
214
+ }
215
+
216
+ async function createDatabaseDump(dumpFile: string) {
217
+ await assertCommandAvailable("pg_dump");
218
+ const parts = getDatabaseConnectionParts();
219
+ await runCommand(
220
+ "pg_dump",
221
+ [
222
+ "--clean",
223
+ "--if-exists",
224
+ "--quote-all-identifiers",
225
+ "-h",
226
+ parts.host,
227
+ "-U",
228
+ parts.user,
229
+ "-p",
230
+ parts.port,
231
+ "-d",
232
+ parts.dbName,
233
+ "-f",
234
+ dumpFile,
235
+ ],
236
+ { env: buildDatabaseEnv(parts) }
237
+ );
238
+ }
239
+
240
+ async function restoreDatabaseDump(dumpFile: string) {
241
+ await assertCommandAvailable("psql");
242
+ const parts = getDatabaseConnectionParts();
243
+ await runCommand(
244
+ "psql",
245
+ ["-h", parts.host, "-U", parts.user, "-p", parts.port, "-d", parts.dbName, "-f", dumpFile],
246
+ { env: buildDatabaseEnv(parts) }
247
+ );
248
+ }
249
+
250
+ async function requireR2Client() {
251
+ const bucket = process.env.R2_BUCKET_NAME;
252
+ if (!bucket) {
253
+ throw new Error("R2_BUCKET_NAME is required for full ZIP backup/restore.");
254
+ }
255
+
256
+ const client = await getS3Client();
257
+ if (!client) {
258
+ throw new Error("R2 client is not configured. Check R2 account, endpoint, and access key environment variables.");
259
+ }
260
+
261
+ return { client, bucket };
262
+ }
263
+
264
+ async function listR2Objects(client: S3Client, bucket: string) {
265
+ const objects: Array<{
266
+ key: string;
267
+ size: number | null;
268
+ etag: string | null;
269
+ lastModified: string | null;
270
+ }> = [];
271
+ let continuationToken: string | undefined;
272
+
273
+ do {
274
+ const response = await client.send(
275
+ new ListObjectsV2Command({
276
+ Bucket: bucket,
277
+ ContinuationToken: continuationToken,
278
+ })
279
+ );
280
+
281
+ for (const item of response.Contents || []) {
282
+ if (!item.Key) continue;
283
+ objects.push({
284
+ key: item.Key.replace(/^\/+/, ""),
285
+ size: typeof item.Size === "number" ? item.Size : null,
286
+ etag: item.ETag || null,
287
+ lastModified: item.LastModified?.toISOString() || null,
288
+ });
289
+ }
290
+
291
+ continuationToken = response.IsTruncated ? response.NextContinuationToken : undefined;
292
+ } while (continuationToken);
293
+
294
+ return objects;
295
+ }
296
+
297
+ async function r2BodyToUint8Array(body: unknown): Promise<Uint8Array> {
298
+ if (!body) return new Uint8Array();
299
+ if (body instanceof Uint8Array) return body;
300
+
301
+ const maybeTransform = body as { transformToByteArray?: () => Promise<Uint8Array> };
302
+ if (typeof maybeTransform.transformToByteArray === "function") {
303
+ return maybeTransform.transformToByteArray();
304
+ }
305
+
306
+ const maybeArrayBuffer = body as { arrayBuffer?: () => Promise<ArrayBuffer> };
307
+ if (typeof maybeArrayBuffer.arrayBuffer === "function") {
308
+ return new Uint8Array(await maybeArrayBuffer.arrayBuffer());
309
+ }
310
+
311
+ const chunks: Buffer[] = [];
312
+ for await (const chunk of body as AsyncIterable<Buffer | Uint8Array | string>) {
313
+ chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
314
+ }
315
+
316
+ return Buffer.concat(chunks);
317
+ }
318
+
319
+ async function addR2ObjectsToArchive(params: {
320
+ client: S3Client;
321
+ bucket: string;
322
+ archiveEntries: Record<string, Uint8Array>;
323
+ }) {
324
+ const manifestObjects: FullBackupStorageObjectManifest[] = [];
325
+ const objects = await listR2Objects(params.client, params.bucket);
326
+
327
+ for (const object of objects) {
328
+ const response = await params.client.send(
329
+ new GetObjectCommand({
330
+ Bucket: params.bucket,
331
+ Key: object.key,
332
+ })
333
+ );
334
+ const archivePath = archivePathForObjectKey(object.key);
335
+ params.archiveEntries[archivePath] = await r2BodyToUint8Array(response.Body);
336
+ manifestObjects.push({
337
+ key: object.key,
338
+ archive_path: archivePath,
339
+ size: object.size,
340
+ etag: object.etag,
341
+ content_type: response.ContentType || null,
342
+ last_modified: object.lastModified,
343
+ });
344
+ }
345
+
346
+ return manifestObjects;
347
+ }
348
+
349
+ function buildManifest(objects: FullBackupStorageObjectManifest[]): FullBackupManifestV1 {
350
+ return {
351
+ type: "nextblock-full-site-backup",
352
+ version: 1,
353
+ exported_at: new Date().toISOString(),
354
+ app: {
355
+ name: "nextblock",
356
+ version: readAppVersion(),
357
+ },
358
+ database: {
359
+ path: FULL_BACKUP_DATABASE_PATH,
360
+ created_with: "pg_dump",
361
+ },
362
+ content: {
363
+ path: FULL_BACKUP_CONTENT_PATH,
364
+ type: "nextblock-content-backup-v1",
365
+ },
366
+ storage: {
367
+ bucket: process.env.R2_BUCKET_NAME || null,
368
+ source_base_url: normalizeMediaBaseUrl(process.env.NEXT_PUBLIC_R2_BASE_URL),
369
+ public_url: normalizeMediaBaseUrl(process.env.NEXT_PUBLIC_R2_PUBLIC_URL),
370
+ objects,
371
+ },
372
+ };
373
+ }
374
+
375
+ export async function exportFullBackupArchive(): Promise<FullBackupArchiveExport> {
376
+ await requireAdminUser();
377
+ const { client, bucket } = await requireR2Client();
378
+ const tempDir = await mkdtemp(path.join(tmpdir(), "nextblock-full-backup-"));
379
+
380
+ try {
381
+ const dumpFile = path.join(tempDir, "dump.sql");
382
+ await createDatabaseDump(dumpFile);
383
+
384
+ const archiveEntries: Record<string, Uint8Array> = {
385
+ [FULL_BACKUP_DATABASE_PATH]: await readFile(dumpFile),
386
+ [FULL_BACKUP_CONTENT_PATH]: strToU8(await exportBackupBundle()),
387
+ };
388
+
389
+ const storageObjects = await addR2ObjectsToArchive({
390
+ client,
391
+ bucket,
392
+ archiveEntries,
393
+ });
394
+ const manifest = buildManifest(storageObjects);
395
+ archiveEntries[FULL_BACKUP_MANIFEST_PATH] = strToU8(JSON.stringify(manifest, null, 2));
396
+
397
+ return {
398
+ fileName: `nextblock-full-site-backup-${dateStamp()}.zip`,
399
+ mimeType: ARCHIVE_MIME_TYPE,
400
+ content: Buffer.from(zipSync(archiveEntries, { level: 0 })),
401
+ manifest,
402
+ };
403
+ } finally {
404
+ await rm(tempDir, { recursive: true, force: true });
405
+ }
406
+ }
407
+
408
+ function inspectFullBackupArchive(archive: Uint8Array): FullBackupArchiveInspection {
409
+ const files = unzipSync(archive);
410
+ const manifestContent = files[FULL_BACKUP_MANIFEST_PATH];
411
+ if (!manifestContent) {
412
+ throw new Error("Full backup ZIP is missing manifest.json.");
413
+ }
414
+
415
+ const manifest = parseFullBackupManifest(strFromU8(manifestContent));
416
+ const warnings: string[] = [];
417
+ const missingStorageObjects: string[] = [];
418
+ const databaseDumpBytes = files[FULL_BACKUP_DATABASE_PATH]?.byteLength || 0;
419
+ const contentBundleBytes = files[FULL_BACKUP_CONTENT_PATH]?.byteLength || 0;
420
+
421
+ if (!databaseDumpBytes) {
422
+ throw new Error("Full backup ZIP is missing database/dump.sql.");
423
+ }
424
+ if (!contentBundleBytes) {
425
+ warnings.push("Content JSON bundle is missing or empty. Database restore can still continue.");
426
+ }
427
+
428
+ for (const object of manifest.storage.objects) {
429
+ if (!files[object.archive_path]) {
430
+ missingStorageObjects.push(object.key);
431
+ }
432
+ }
433
+
434
+ if (missingStorageObjects.length > 0) {
435
+ warnings.push(`${missingStorageObjects.length} R2 object(s) listed in the manifest are missing from the ZIP.`);
436
+ }
437
+
438
+ return {
439
+ manifest,
440
+ files,
441
+ warnings,
442
+ databaseDumpBytes,
443
+ contentBundleBytes,
444
+ missingStorageObjects,
445
+ };
446
+ }
447
+
448
+ export function reviewFullBackupArchive(archive: Uint8Array): FullBackupReviewSummary {
449
+ try {
450
+ const inspection = inspectFullBackupArchive(archive);
451
+ return {
452
+ success: inspection.missingStorageObjects.length === 0,
453
+ exportedAt: inspection.manifest.exported_at,
454
+ sourceBucket: inspection.manifest.storage.bucket,
455
+ sourceBaseUrl: inspection.manifest.storage.source_base_url,
456
+ databaseDumpBytes: inspection.databaseDumpBytes,
457
+ contentBundleBytes: inspection.contentBundleBytes,
458
+ storageObjects: inspection.manifest.storage.objects.length,
459
+ missingStorageObjects: inspection.missingStorageObjects.length,
460
+ warnings: inspection.warnings,
461
+ };
462
+ } catch (error) {
463
+ return {
464
+ success: false,
465
+ error: error instanceof Error ? error.message : "Failed to review full backup archive.",
466
+ warnings: [],
467
+ };
468
+ }
469
+ }
470
+
471
+ export async function reviewFullBackupArchiveForAdmin(archive: Uint8Array) {
472
+ await requireAdminUser();
473
+ return reviewFullBackupArchive(archive);
474
+ }
475
+
476
+ async function uploadR2Objects(params: {
477
+ client: S3Client;
478
+ bucket: string;
479
+ files: Record<string, Uint8Array>;
480
+ objects: FullBackupStorageObjectManifest[];
481
+ }) {
482
+ let uploaded = 0;
483
+
484
+ for (const object of params.objects) {
485
+ const body = params.files[object.archive_path];
486
+ if (!body) {
487
+ throw new Error(`R2 object ${object.key} is missing from the backup ZIP.`);
488
+ }
489
+
490
+ await params.client.send(
491
+ new PutObjectCommand({
492
+ Bucket: params.bucket,
493
+ Key: object.key,
494
+ Body: body,
495
+ ContentType: object.content_type || undefined,
496
+ ContentLength: body.byteLength,
497
+ })
498
+ );
499
+ uploaded += 1;
500
+ }
501
+
502
+ return uploaded;
503
+ }
504
+
505
+ async function deleteExtraneousR2Objects(params: {
506
+ client: S3Client;
507
+ bucket: string;
508
+ keepKeys: Set<string>;
509
+ }) {
510
+ const existingObjects = await listR2Objects(params.client, params.bucket);
511
+ const deleteKeys = existingObjects
512
+ .map((object) => object.key)
513
+ .filter((key) => !params.keepKeys.has(key));
514
+ let deleted = 0;
515
+
516
+ for (let index = 0; index < deleteKeys.length; index += 1000) {
517
+ const batch = deleteKeys.slice(index, index + 1000);
518
+ if (batch.length === 0) continue;
519
+ await params.client.send(
520
+ new DeleteObjectsCommand({
521
+ Bucket: params.bucket,
522
+ Delete: {
523
+ Objects: batch.map((Key) => ({ Key })),
524
+ },
525
+ })
526
+ );
527
+ deleted += batch.length;
528
+ }
529
+
530
+ return deleted;
531
+ }
532
+
533
+ async function updateJsonColumns(params: {
534
+ supabase: SupabaseAny;
535
+ table: string;
536
+ idColumn: string;
537
+ columns: string[];
538
+ sourceBaseUrl: string;
539
+ destinationBaseUrl: string;
540
+ }) {
541
+ const client = params.supabase as any;
542
+ let updatedRows = 0;
543
+ const pageSize = 500;
544
+
545
+ for (let from = 0; ; from += pageSize) {
546
+ const to = from + pageSize - 1;
547
+ const { data, error } = await client
548
+ .from(params.table)
549
+ .select([params.idColumn, ...params.columns].join(","))
550
+ .range(from, to);
551
+
552
+ if (error) {
553
+ throw new Error(`Failed to scan ${params.table}: ${error.message}`);
554
+ }
555
+ if (!data?.length) break;
556
+
557
+ for (const row of data) {
558
+ const patch: Record<string, unknown> = {};
559
+ for (const column of params.columns) {
560
+ const current = row[column] ?? null;
561
+ const next = replaceMediaBaseUrlInJson(current, params.sourceBaseUrl, params.destinationBaseUrl);
562
+ if (JSON.stringify(current) !== JSON.stringify(next)) {
563
+ patch[column] = next;
564
+ }
565
+ }
566
+
567
+ if (Object.keys(patch).length === 0) continue;
568
+
569
+ const { error: updateError } = await client
570
+ .from(params.table)
571
+ .update(patch)
572
+ .eq(params.idColumn, row[params.idColumn]);
573
+ if (updateError) {
574
+ throw new Error(`Failed to update ${params.table}: ${updateError.message}`);
575
+ }
576
+ updatedRows += 1;
577
+ }
578
+
579
+ if (data.length < pageSize) break;
580
+ }
581
+
582
+ return updatedRows;
583
+ }
584
+
585
+ async function rewriteMediaBaseUrls(params: {
586
+ sourceBaseUrl: string;
587
+ destinationBaseUrl: string;
588
+ warnings: string[];
589
+ }) {
590
+ const sourceBaseUrl = normalizeMediaBaseUrl(params.sourceBaseUrl);
591
+ const destinationBaseUrl = normalizeMediaBaseUrl(params.destinationBaseUrl);
592
+ if (!sourceBaseUrl || !destinationBaseUrl || sourceBaseUrl === destinationBaseUrl) {
593
+ return 0;
594
+ }
595
+
596
+ const supabase = getServiceRoleSupabaseClient();
597
+ const client = supabase as any;
598
+ let updatedRows = 0;
599
+ const pageSize = 500;
600
+
601
+ for (let from = 0; ; from += pageSize) {
602
+ const { data, error } = await client
603
+ .from("media")
604
+ .select("id, file_path, variants")
605
+ .range(from, from + pageSize - 1);
606
+
607
+ if (error) {
608
+ throw new Error(`Failed to scan media URLs: ${error.message}`);
609
+ }
610
+ if (!data?.length) break;
611
+
612
+ for (const row of data) {
613
+ const nextFilePath =
614
+ typeof row.file_path === "string"
615
+ ? replaceMediaBaseUrlInString(row.file_path, sourceBaseUrl, destinationBaseUrl)
616
+ : row.file_path;
617
+ const nextVariants = replaceMediaBaseUrlInJson(row.variants ?? null, sourceBaseUrl, destinationBaseUrl);
618
+ const patch: Record<string, unknown> = {};
619
+
620
+ if (row.file_path !== nextFilePath) patch.file_path = nextFilePath;
621
+ if (JSON.stringify(row.variants ?? null) !== JSON.stringify(nextVariants)) patch.variants = nextVariants;
622
+ if (Object.keys(patch).length === 0) continue;
623
+
624
+ const { error: updateError } = await client.from("media").update(patch).eq("id", row.id);
625
+ if (updateError) {
626
+ throw new Error(`Failed to update media URLs: ${updateError.message}`);
627
+ }
628
+ updatedRows += 1;
629
+ }
630
+
631
+ if (data.length < pageSize) break;
632
+ }
633
+
634
+ const jsonTargets = [
635
+ { table: "blocks", idColumn: "id", columns: ["content"] },
636
+ { table: "content_drafts", idColumn: "id", columns: ["blocks", "meta"] },
637
+ { table: "product_drafts", idColumn: "id", columns: ["blocks", "meta"] },
638
+ { table: "products", idColumn: "id", columns: ["description_json", "metadata"] },
639
+ { table: "page_revisions", idColumn: "id", columns: ["content"] },
640
+ { table: "post_revisions", idColumn: "id", columns: ["content"] },
641
+ { table: "site_settings", idColumn: "key", columns: ["value"] },
642
+ { table: "translations", idColumn: "key", columns: ["translations"] },
643
+ ];
644
+
645
+ for (const target of jsonTargets) {
646
+ try {
647
+ updatedRows += await updateJsonColumns({
648
+ supabase,
649
+ ...target,
650
+ sourceBaseUrl,
651
+ destinationBaseUrl,
652
+ });
653
+ } catch (error) {
654
+ params.warnings.push(error instanceof Error ? error.message : `Failed to rewrite ${target.table}.`);
655
+ }
656
+ }
657
+
658
+ return updatedRows;
659
+ }
660
+
661
+ export async function restoreFullBackupArchive(params: {
662
+ archive: Uint8Array;
663
+ confirmation: string;
664
+ mediaUrlMode: FullBackupMediaUrlMode;
665
+ destinationBaseUrl?: string | null;
666
+ deleteExtraneousR2Objects?: boolean;
667
+ }): Promise<FullBackupRestoreSummary> {
668
+ await requireAdminUser();
669
+ if (!isValidFullBackupConfirmation(params.confirmation)) {
670
+ return {
671
+ success: false,
672
+ error: `Type ${FULL_BACKUP_CONFIRMATION} to confirm full restore.`,
673
+ warnings: [],
674
+ };
675
+ }
676
+
677
+ const inspection = inspectFullBackupArchive(params.archive);
678
+ const warnings = [...inspection.warnings];
679
+ if (inspection.missingStorageObjects.length > 0) {
680
+ return {
681
+ success: false,
682
+ error: "The full backup ZIP is missing one or more R2 objects listed in the manifest.",
683
+ exportedAt: inspection.manifest.exported_at,
684
+ sourceBucket: inspection.manifest.storage.bucket,
685
+ sourceBaseUrl: inspection.manifest.storage.source_base_url,
686
+ databaseDumpBytes: inspection.databaseDumpBytes,
687
+ contentBundleBytes: inspection.contentBundleBytes,
688
+ storageObjects: inspection.manifest.storage.objects.length,
689
+ missingStorageObjects: inspection.missingStorageObjects.length,
690
+ warnings,
691
+ };
692
+ }
693
+
694
+ const { client, bucket } = await requireR2Client();
695
+ const uploaded = await uploadR2Objects({
696
+ client,
697
+ bucket,
698
+ files: inspection.files,
699
+ objects: inspection.manifest.storage.objects,
700
+ });
701
+ const deleted = params.deleteExtraneousR2Objects
702
+ ? await deleteExtraneousR2Objects({
703
+ client,
704
+ bucket,
705
+ keepKeys: new Set(inspection.manifest.storage.objects.map((object) => object.key)),
706
+ })
707
+ : 0;
708
+
709
+ const tempDir = await mkdtemp(path.join(tmpdir(), "nextblock-full-restore-"));
710
+ try {
711
+ const dumpFile = path.join(tempDir, "dump.sql");
712
+ await writeFile(dumpFile, inspection.files[FULL_BACKUP_DATABASE_PATH]);
713
+ await restoreDatabaseDump(dumpFile);
714
+ } finally {
715
+ await rm(tempDir, { recursive: true, force: true });
716
+ }
717
+
718
+ const mediaUrlRowsUpdated =
719
+ params.mediaUrlMode === "rewrite_to_destination"
720
+ ? await rewriteMediaBaseUrls({
721
+ sourceBaseUrl: inspection.manifest.storage.source_base_url || "",
722
+ destinationBaseUrl: params.destinationBaseUrl || process.env.NEXT_PUBLIC_R2_BASE_URL || "",
723
+ warnings,
724
+ })
725
+ : 0;
726
+
727
+ return {
728
+ success: true,
729
+ exportedAt: inspection.manifest.exported_at,
730
+ sourceBucket: inspection.manifest.storage.bucket,
731
+ sourceBaseUrl: inspection.manifest.storage.source_base_url,
732
+ databaseDumpBytes: inspection.databaseDumpBytes,
733
+ contentBundleBytes: inspection.contentBundleBytes,
734
+ storageObjects: inspection.manifest.storage.objects.length,
735
+ missingStorageObjects: inspection.missingStorageObjects.length,
736
+ warnings,
737
+ databaseRestored: true,
738
+ storageObjectsUploaded: uploaded,
739
+ storageObjectsDeleted: deleted,
740
+ mediaUrlRewriteMode: params.mediaUrlMode,
741
+ mediaUrlRowsUpdated,
742
+ };
743
+ }