@jant/core 0.7.0 → 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 (331) hide show
  1. package/bin/commands/assets/prepare.js +3 -3
  2. package/bin/commands/db/export.js +115 -2
  3. package/bin/commands/deploy.js +11 -3
  4. package/bin/commands/{search-reindex.js → search/reindex.js} +5 -5
  5. package/bin/commands/setup.js +136 -0
  6. package/bin/commands/site/export.js +117 -68
  7. package/bin/commands/site/import.js +3074 -2
  8. package/bin/commands/site/pull-media.js +2 -6
  9. package/bin/commands/site/snapshot/export.js +18 -60
  10. package/bin/commands/site/snapshot/import.js +24 -23
  11. package/bin/commands/telegram/register-webhooks.js +48 -23
  12. package/bin/jant.js +16 -11
  13. package/bin/lib/command-registry.js +120 -0
  14. package/bin/lib/d1-query.js +87 -2
  15. package/bin/lib/hugo-markdown.js +4 -0
  16. package/bin/lib/migration-artifacts.js +19 -0
  17. package/bin/lib/renamed-arguments.js +56 -0
  18. package/bin/lib/site-pull-media.js +21 -28
  19. package/bin/lib/site-selection.js +10 -1
  20. package/bin/lib/site-snapshot.js +421 -4
  21. package/bin/lib/sql-export.js +68 -5
  22. package/bin/lib/wrangler-cli.js +9 -0
  23. package/bin/lib/zip-archive.js +187 -0
  24. package/dist/{app-K_Aa1MMn.js → app-CFsmRVJN.js} +8629 -697
  25. package/dist/client/.vite/manifest.json +20 -20
  26. package/dist/client/_assets/chunks/{create-editor-CD3FhrOB.js → create-editor-B-m7X7S5.js} +50 -46
  27. package/dist/client/_assets/chunks/{sortable-list-CgaL2jCs.js → sortable-list-BJyd-LXE.js} +1 -1
  28. package/dist/client/_assets/chunks/{unsafe-svg-0QCkP0vZ.js → unsafe-svg-BkscJx69.js} +2 -2
  29. package/dist/client/_assets/{client-GiYENVw8.css → client-BCumu1-D.css} +1 -1
  30. package/dist/client/_assets/{client-VnFxJN7G.js → client-DTLBOHqD.js} +1 -1
  31. package/dist/client/_assets/{client-auth-k8gJ6QJj.js → client-auth-D6Ix6SmE.js} +1 -1
  32. package/dist/client/_assets/{client-compose-B_kDtWkW.js → client-compose-D6rExKVK.js} +1 -1
  33. package/dist/client/_assets/{client-manage-M90aSTOk.js → client-manage-sVOkqVbH.js} +1 -1
  34. package/dist/client/_assets/{client-settings-DfYs9n1F.js → client-settings-CGR_nZ78.js} +7 -7
  35. package/dist/index.js +2 -3
  36. package/dist/node.js +8 -5
  37. package/dist/url-CKlGzvdN.js +428 -0
  38. package/package.json +13 -7
  39. package/src/__tests__/cli-commands.test.ts +144 -0
  40. package/src/__tests__/config-docs.test.ts +148 -0
  41. package/src/__tests__/dev-scripts.test.ts +203 -0
  42. package/src/__tests__/export-collection-order.test.ts +276 -0
  43. package/src/__tests__/export-feed-ids.test.ts +184 -0
  44. package/src/__tests__/export-feed-order.test.ts +294 -0
  45. package/src/__tests__/export-hugo-build.test.ts +130 -0
  46. package/src/__tests__/export-import-roundtrip.test.ts +95 -1
  47. package/src/__tests__/export-service.test.ts +611 -28
  48. package/src/__tests__/export-smart-collection.test.ts +329 -0
  49. package/src/__tests__/feed-docs.test.ts +36 -0
  50. package/src/__tests__/fixtures/releases/0.7.0/site-export/README.md +89 -0
  51. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/41q27/0x4nv/index.md +16 -0
  52. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/41q27/_index.md +41 -0
  53. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/41q27/faqyt/index.md +28 -0
  54. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/41q27/the-potting-mix-guide-i-keep-rereading/index.md +18 -0
  55. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/_index.md +4 -0
  56. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/a-night-heron-field-guide-for-my-walk-folder/_index.md +27 -0
  57. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/a-quiet-saturday-after-a-busy-week/_index.md +32 -0
  58. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/archive/_index.md +7 -0
  59. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/are-na-is-the-only-bookmark-pile-i-still-revisit/_index.md +27 -0
  60. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/bought-too-many-lemons-again/_index.md +34 -0
  61. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/city-walks/_index.md +11 -0
  62. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/collections/_index.md +4 -0
  63. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/current-tea-rotation/_index.md +31 -0
  64. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/derek-sivers-still-writes-the-kind-of-internet-i-want-more-of/_index.md +27 -0
  65. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/desk-but-better/_index.md +22 -0
  66. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/e0kcg/_index.md +19 -0
  67. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/featured/_index.md +7 -0
  68. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-basho/_index.md +22 -0
  69. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-epictetus/_index.md +22 -0
  70. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-marcus-aurelius/_index.md +22 -0
  71. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-seneca/_index.md +22 -0
  72. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-thoreau/_index.md +22 -0
  73. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/gkbvv/2cl6d/index.md +16 -0
  74. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/gkbvv/3zqv7/index.md +28 -0
  75. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/gkbvv/5oxsv/index.md +16 -0
  76. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/gkbvv/_index.md +36 -0
  77. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/home-cooking/_index.md +11 -0
  78. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/k5vh8/_index.md +29 -0
  79. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/k5vh8/a-reading-log-idea-i-might-steal/index.md +18 -0
  80. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/k5vh8/a83qu/index.md +16 -0
  81. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/k5vh8/from-seneca-5hibo/index.md +19 -0
  82. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/mynoise-for-rainy-afternoons/_index.md +27 -0
  83. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/nts-archives-are-good-cleaning-music/_index.md +27 -0
  84. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/qgfcu/_index.md +29 -0
  85. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/qgfcu/c91j0/index.md +16 -0
  86. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/qgfcu/qyucy/index.md +16 -0
  87. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/qgfcu/wsgck/index.md +16 -0
  88. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/rain-makes-my-neighborhood-look-better/_index.md +43 -0
  89. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/reading-notes/_index.md +11 -0
  90. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/serious-eats-on-tomato-and-egg-soup/_index.md +27 -0
  91. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/te812/_index.md +41 -0
  92. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/te812/cxiu6/index.md +16 -0
  93. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/te812/t77ms/index.md +16 -0
  94. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/te812/the-soup-trick-i-always-forget/index.md +18 -0
  95. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/telk3/_index.md +27 -0
  96. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/telk3/from-thoreau-pawt2/index.md +17 -0
  97. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/the-five-minute-reset-is-still-the-best-habit-i-have/_index.md +32 -0
  98. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/the-hallway-light-took-12-minutes-and-3-months/_index.md +29 -0
  99. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/the-recurse-center-manual-is-weirdly-calming/_index.md +27 -0
  100. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/tiny-projects/_index.md +11 -0
  101. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/useful-links/_index.md +11 -0
  102. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/weekend-notes/_index.md +11 -0
  103. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/what-i-actually-use-my-notebook-for/_index.md +49 -0
  104. package/src/__tests__/fixtures/releases/0.7.0/site-export/data/jant.toml +119 -0
  105. package/src/__tests__/fixtures/releases/0.7.0/site-export/hugo.toml +43 -0
  106. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/021801c20ab3-med_01kn8jw26cenf98vc7k0ppz5k8.webp +0 -0
  107. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/0f868ce9ac84-med_01kn8jtx8qenf98tm9ahxr48sw.webp +0 -0
  108. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/50c2ad911bad-med_01kn8jvb16enf98txp7p0pf5ge.webp +0 -0
  109. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/7a91f0960491-med_01kn8jvq58enf98v538w5vsqp4.webp +0 -0
  110. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/8714116d3c8e-med_01kn8jve5nenf98tzap11gpxzr.webp +0 -0
  111. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/8a0b4277443f-med_01kn8jv0jdenf98tp6qr9zgjjc.webp +0 -0
  112. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/a7d1c8a1afd9-med_01kn8jv452enf98trbkwrvhvgd.webp +0 -0
  113. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/e25570b405f5-med_01kn8jvsaeenf98v6ct4gjzppc.webp +0 -0
  114. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/e89ea4eabf01-med_01kn8jtq3penf98tfq4gzmh9g9.png +0 -0
  115. package/src/__tests__/fixtures/releases/0.7.0/site-export/themes/jant/static/apple-touch-icon.png +0 -0
  116. package/src/__tests__/fixtures/releases/0.7.0/site-export/themes/jant/static/custom.css +0 -0
  117. package/src/__tests__/fixtures/releases/0.7.0/site-export/themes/jant/static/favicon.ico +0 -0
  118. package/src/__tests__/fixtures/releases/0.7.0/snapshot/db.sql +218 -0
  119. package/src/__tests__/fixtures/releases/0.7.0/snapshot/meta.json +9 -0
  120. package/src/__tests__/fixtures/releases/0.7.1/site-export/README.md +89 -0
  121. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/41q27/0x4nv/index.md +16 -0
  122. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/41q27/_index.md +41 -0
  123. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/41q27/faqyt/index.md +28 -0
  124. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/41q27/the-potting-mix-guide-i-keep-rereading/index.md +18 -0
  125. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/_index.md +4 -0
  126. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/a-night-heron-field-guide-for-my-walk-folder/_index.md +27 -0
  127. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/a-quiet-saturday-after-a-busy-week/_index.md +32 -0
  128. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/archive/_index.md +7 -0
  129. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/are-na-is-the-only-bookmark-pile-i-still-revisit/_index.md +27 -0
  130. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/bought-too-many-lemons-again/_index.md +34 -0
  131. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/city-walks/_index.md +11 -0
  132. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/collections/_index.md +4 -0
  133. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/current-tea-rotation/_index.md +31 -0
  134. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/derek-sivers-still-writes-the-kind-of-internet-i-want-more-of/_index.md +27 -0
  135. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/desk-but-better/_index.md +22 -0
  136. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/e0kcg/_index.md +19 -0
  137. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/featured/_index.md +7 -0
  138. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-basho/_index.md +22 -0
  139. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-epictetus/_index.md +22 -0
  140. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-marcus-aurelius/_index.md +22 -0
  141. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-seneca/_index.md +22 -0
  142. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-thoreau/_index.md +22 -0
  143. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/gkbvv/2cl6d/index.md +16 -0
  144. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/gkbvv/3zqv7/index.md +28 -0
  145. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/gkbvv/5oxsv/index.md +16 -0
  146. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/gkbvv/_index.md +36 -0
  147. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/home-cooking/_index.md +11 -0
  148. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/k5vh8/_index.md +29 -0
  149. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/k5vh8/a-reading-log-idea-i-might-steal/index.md +18 -0
  150. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/k5vh8/a83qu/index.md +16 -0
  151. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/k5vh8/from-seneca-5hibo/index.md +19 -0
  152. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/mynoise-for-rainy-afternoons/_index.md +27 -0
  153. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/nts-archives-are-good-cleaning-music/_index.md +27 -0
  154. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/qgfcu/_index.md +29 -0
  155. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/qgfcu/c91j0/index.md +16 -0
  156. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/qgfcu/qyucy/index.md +16 -0
  157. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/qgfcu/wsgck/index.md +16 -0
  158. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/rain-makes-my-neighborhood-look-better/_index.md +43 -0
  159. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/reading-notes/_index.md +11 -0
  160. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/serious-eats-on-tomato-and-egg-soup/_index.md +27 -0
  161. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/te812/_index.md +41 -0
  162. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/te812/cxiu6/index.md +16 -0
  163. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/te812/t77ms/index.md +16 -0
  164. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/te812/the-soup-trick-i-always-forget/index.md +18 -0
  165. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/telk3/_index.md +27 -0
  166. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/telk3/from-thoreau-pawt2/index.md +17 -0
  167. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/the-five-minute-reset-is-still-the-best-habit-i-have/_index.md +32 -0
  168. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/the-hallway-light-took-12-minutes-and-3-months/_index.md +29 -0
  169. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/the-recurse-center-manual-is-weirdly-calming/_index.md +27 -0
  170. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/tiny-projects/_index.md +11 -0
  171. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/useful-links/_index.md +11 -0
  172. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/weekend-notes/_index.md +11 -0
  173. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/what-i-actually-use-my-notebook-for/_index.md +49 -0
  174. package/src/__tests__/fixtures/releases/0.7.1/site-export/data/jant.toml +119 -0
  175. package/src/__tests__/fixtures/releases/0.7.1/site-export/hugo.toml +43 -0
  176. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/021801c20ab3-med_01kn8jw26cenf98vc7k0ppz5k8.webp +0 -0
  177. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/0f868ce9ac84-med_01kn8jtx8qenf98tm9ahxr48sw.webp +0 -0
  178. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/50c2ad911bad-med_01kn8jvb16enf98txp7p0pf5ge.webp +0 -0
  179. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/7a91f0960491-med_01kn8jvq58enf98v538w5vsqp4.webp +0 -0
  180. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/8714116d3c8e-med_01kn8jve5nenf98tzap11gpxzr.webp +0 -0
  181. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/8a0b4277443f-med_01kn8jv0jdenf98tp6qr9zgjjc.webp +0 -0
  182. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/a7d1c8a1afd9-med_01kn8jv452enf98trbkwrvhvgd.webp +0 -0
  183. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/e25570b405f5-med_01kn8jvsaeenf98v6ct4gjzppc.webp +0 -0
  184. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/e89ea4eabf01-med_01kn8jtq3penf98tfq4gzmh9g9.png +0 -0
  185. package/src/__tests__/fixtures/releases/0.7.1/site-export/themes/jant/static/apple-touch-icon.png +0 -0
  186. package/src/__tests__/fixtures/releases/0.7.1/site-export/themes/jant/static/custom.css +0 -0
  187. package/src/__tests__/fixtures/releases/0.7.1/site-export/themes/jant/static/favicon.ico +0 -0
  188. package/src/__tests__/fixtures/releases/0.7.1/snapshot/db.sql +322 -0
  189. package/src/__tests__/fixtures/releases/0.7.1/snapshot/meta.json +9 -0
  190. package/src/__tests__/helpers/hugo-site.ts +146 -0
  191. package/src/__tests__/helpers/site-export-import.ts +97 -0
  192. package/src/__tests__/import-site-command.test.ts +514 -2
  193. package/src/__tests__/mise-config.test.ts +75 -4
  194. package/src/__tests__/node-dev-tasks.test.ts +264 -0
  195. package/src/__tests__/release-fixtures.test.ts +132 -0
  196. package/src/__tests__/site-export-canonical-import.test.ts +113 -0
  197. package/src/__tests__/snapshot-canonical-replay.test.ts +179 -0
  198. package/src/__tests__/snapshot-settings.test.ts +97 -0
  199. package/src/__tests__/snapshot-tables.test.ts +219 -0
  200. package/src/__tests__/sql-export.test.ts +173 -0
  201. package/src/__tests__/theme-docs.test.ts +109 -0
  202. package/src/__tests__/zip-archive.test.ts +106 -0
  203. package/src/app.tsx +16 -11
  204. package/src/client/components/__tests__/jant-settings-avatar.test.ts +1 -1
  205. package/src/client/components/__tests__/jant-settings-general.test.ts +21 -1
  206. package/src/client/components/jant-repo-picker-types.ts +6 -1
  207. package/src/client/components/jant-repo-picker.ts +4 -7
  208. package/src/client/components/jant-settings-general.ts +17 -12
  209. package/src/client/tiptap/__tests__/list-editing.test.ts +224 -86
  210. package/src/client/tiptap/__tests__/mark-exit.test.ts +1 -2
  211. package/src/client/tiptap/__tests__/markdown-clipboard.test.ts +26 -0
  212. package/src/client/tiptap/extensions.ts +0 -3
  213. package/src/client/tiptap/structural-keymap.ts +158 -47
  214. package/src/db/__tests__/d1-query.test.ts +56 -1
  215. package/src/db/rehearsal-fixtures/pg-demo-current.json +55 -0
  216. package/src/db/rehearsal-fixtures/pg-demo-current.sql +431 -0
  217. package/src/i18n/locales/public/en.po +0 -2
  218. package/src/i18n/locales/public/zh-Hans.po +0 -2
  219. package/src/i18n/locales/public/zh-Hant.po +0 -2
  220. package/src/i18n/locales/settings/en.po +8 -8
  221. package/src/i18n/locales/settings/en.ts +1 -1
  222. package/src/i18n/locales/settings/zh-Hans.po +8 -8
  223. package/src/i18n/locales/settings/zh-Hans.ts +1 -1
  224. package/src/i18n/locales/settings/zh-Hant.po +8 -8
  225. package/src/i18n/locales/settings/zh-Hant.ts +1 -1
  226. package/src/index.ts +6 -77
  227. package/src/lib/__tests__/github-sync-repo-name.test.ts +40 -0
  228. package/src/lib/__tests__/image.test.ts +27 -1
  229. package/src/lib/__tests__/markdown-to-tiptap.test.ts +105 -0
  230. package/src/lib/__tests__/markdown.test.ts +10 -0
  231. package/src/lib/__tests__/resolve-config.test.ts +67 -0
  232. package/src/lib/__tests__/schemas.test.ts +27 -1
  233. package/src/lib/__tests__/timeline.test.ts +87 -0
  234. package/src/lib/__tests__/tiptap-to-markdown.test.ts +172 -4
  235. package/src/lib/__tests__/view.test.ts +0 -46
  236. package/src/lib/discover.ts +3 -1
  237. package/src/lib/feed.ts +0 -6
  238. package/src/lib/github-sync-repo-name.ts +45 -0
  239. package/src/lib/hugo-markdown.ts +46 -0
  240. package/src/lib/image.ts +17 -4
  241. package/src/lib/markdown-manager.ts +392 -2
  242. package/src/lib/post-body-html.ts +11 -4
  243. package/src/lib/resolve-config.ts +58 -1
  244. package/src/lib/schemas.ts +50 -5
  245. package/src/lib/thread-fold.ts +3 -3
  246. package/src/lib/timeline.ts +1 -1
  247. package/src/lib/tiptap-to-markdown.ts +13 -7
  248. package/src/lib/url.ts +20 -0
  249. package/src/lib/view.ts +2 -29
  250. package/src/node/__tests__/cli-export.test.ts +2 -2
  251. package/src/node/__tests__/cli-setup.test.ts +163 -0
  252. package/src/node/__tests__/cli-site-snapshot.test.ts +73 -0
  253. package/src/node/__tests__/cli-site-token-env.test.ts +4 -1
  254. package/src/node/__tests__/cli-snapshot-meta.test.ts +84 -0
  255. package/src/node/__tests__/runtime.test.ts +38 -0
  256. package/src/node/index.ts +2 -0
  257. package/src/node/request-handler.ts +3 -1
  258. package/src/routes/api/__tests__/posts.test.ts +24 -0
  259. package/src/routes/api/__tests__/upload.test.ts +34 -0
  260. package/src/routes/api/export.ts +3 -3
  261. package/src/routes/api/internal/search-reindex.ts +1 -1
  262. package/src/routes/api/internal/sites.ts +0 -1
  263. package/src/routes/api/posts.ts +2 -0
  264. package/src/routes/api/public/posts.ts +21 -1
  265. package/src/routes/api/upload.ts +10 -3
  266. package/src/routes/compose.tsx +4 -0
  267. package/src/routes/dash/__tests__/github-sync-app.test.ts +365 -0
  268. package/src/routes/dash/settings.tsx +212 -70
  269. package/src/routes/pages/__tests__/post-page-round-trips.test.ts +211 -0
  270. package/src/routes/pages/__tests__/thread-order.test.ts +179 -0
  271. package/src/routes/pages/archive.tsx +17 -11
  272. package/src/routes/pages/featured.tsx +11 -5
  273. package/src/routes/pages/page.tsx +53 -31
  274. package/src/routes/pages/search.tsx +4 -2
  275. package/src/runtime/__tests__/readiness.test.ts +23 -0
  276. package/src/runtime/node.ts +49 -0
  277. package/src/runtime/readiness.ts +15 -0
  278. package/src/services/__tests__/bootstrap-setup-instance.test.ts +230 -0
  279. package/src/services/__tests__/custom-url.test.ts +34 -0
  280. package/src/services/__tests__/github-app-installations.test.ts +153 -0
  281. package/src/services/__tests__/github-sync-push.test.ts +46 -0
  282. package/src/services/__tests__/media.test.ts +31 -271
  283. package/src/services/__tests__/path.test.ts +56 -0
  284. package/src/services/__tests__/post-timeline.test.ts +127 -0
  285. package/src/services/__tests__/post.test.ts +74 -0
  286. package/src/services/bootstrap.ts +263 -44
  287. package/src/services/custom-url.ts +2 -2
  288. package/src/services/export-theme/layouts/_default/alias.html +27 -1
  289. package/src/services/export-theme/layouts/_default/list.html +2 -63
  290. package/src/services/export-theme/layouts/_default/rss.xml +27 -38
  291. package/src/services/export-theme/layouts/collections/list.html +3 -3
  292. package/src/services/export-theme/layouts/featured/list.html +1 -4
  293. package/src/services/export-theme/layouts/index.html +40 -26
  294. package/src/services/export-theme/layouts/partials/collection-members.html +100 -0
  295. package/src/services/export-theme/layouts/partials/collection-threads.html +33 -0
  296. package/src/services/export-theme/layouts/partials/featured-members.html +35 -0
  297. package/src/services/export-theme/layouts/partials/featured-thread.html +1 -1
  298. package/src/services/export-theme/layouts/partials/footer.html +1 -1
  299. package/src/services/export-theme/layouts/partials/head.html +1 -1
  300. package/src/services/export-theme/layouts/partials/header.html +5 -3
  301. package/src/services/export-theme/layouts/partials/jant-data.html +23 -0
  302. package/src/services/export-theme/layouts/partials/latest-members.html +48 -0
  303. package/src/services/export-theme/layouts/partials/smart-collection-members.html +129 -0
  304. package/src/services/export-theme/layouts/partials/thread-preview.html +1 -1
  305. package/src/services/export-theme/layouts/post/list.html +1 -1
  306. package/src/services/export-theme/layouts/smart_collection/list.html +24 -0
  307. package/src/services/export-theme/styles/main.css +0 -1
  308. package/src/services/export-theme/theme.toml +1 -1
  309. package/src/services/export.ts +630 -73
  310. package/src/services/github-app-installations.ts +171 -4
  311. package/src/services/github-sync.ts +69 -15
  312. package/src/services/mcp.ts +19 -1
  313. package/src/services/media.ts +9 -220
  314. package/src/services/path.ts +34 -1
  315. package/src/services/post.ts +214 -39
  316. package/src/services/site-admin.ts +3 -7
  317. package/src/services/site.ts +83 -31
  318. package/src/styles/ui.css +7 -119
  319. package/src/types/app-context.ts +16 -0
  320. package/src/types/bindings.ts +5 -0
  321. package/src/types/operations.ts +10 -0
  322. package/src/ui/dash/settings/GeneralContent.tsx +10 -8
  323. package/bin/commands/export.js +0 -118
  324. package/bin/commands/import-site.js +0 -2561
  325. package/bin/commands/migrate-text-attachments.js +0 -181
  326. package/dist/github-sync-BPAvT999.js +0 -7709
  327. package/src/client/multipart-upload.ts +0 -206
  328. package/src/client/tiptap/exitable-marks.ts +0 -73
  329. package/src/routes/api/__tests__/upload-multipart.test.ts +0 -739
  330. package/src/routes/api/internal/text-attachments.ts +0 -60
  331. package/src/routes/api/upload-multipart.ts +0 -366
@@ -0,0 +1,264 @@
1
+ /**
2
+ * Local Node Dev Task Guard
3
+ *
4
+ * `db-node-bootstrap-shell` and `db-node-clean` were added in 4bc0bfe8 and
5
+ * never touched the Node database. The shell migrated it, then set up the
6
+ * local Wrangler D1 database and wrote credentials to `.dev.vars`, leaving the
7
+ * Node site at `/setup`. Clean deleted `packages/core/.data`, a directory the
8
+ * Node runtime no longer uses. Both exited 0, so nothing noticed.
9
+ *
10
+ * These tests run each task's own script through `dev/run-script.mjs` against
11
+ * a throwaway directory, and check the database and env file it leaves. The
12
+ * runner starts Vite, hence the timeouts.
13
+ */
14
+
15
+ import { spawnSync } from "node:child_process";
16
+ import {
17
+ existsSync,
18
+ mkdirSync,
19
+ mkdtempSync,
20
+ readFileSync,
21
+ rmSync,
22
+ writeFileSync,
23
+ } from "node:fs";
24
+ import { tmpdir } from "node:os";
25
+ import { join, resolve } from "node:path";
26
+ import Database from "better-sqlite3";
27
+ import { afterEach, describe, expect, it } from "vitest";
28
+ import { writeScriptEnvValues } from "../../dev/script-env.js";
29
+ import { DEFAULT_NAVIGATION_PROFILE } from "../types/constants.js";
30
+
31
+ const CORE_DIR = resolve(import.meta.dirname, "../..");
32
+
33
+ /** Variables that would point a task somewhere other than the temp directory. */
34
+ const TARGET_VARIABLES = [
35
+ "AUTH_SECRET",
36
+ "DATABASE_URL",
37
+ "DATA_DIR",
38
+ "DEMO_EMAIL",
39
+ "DEMO_PASSWORD",
40
+ "DEV_API_TOKEN",
41
+ "LOCAL_STORAGE_PATH",
42
+ "PORT",
43
+ "SITE_RESOLUTION_MODE",
44
+ "STORAGE_DRIVER",
45
+ ];
46
+
47
+ function taskEnv(
48
+ overrides: Record<string, string>,
49
+ ): Record<string, string | undefined> {
50
+ const env: Record<string, string | undefined> = {
51
+ ...process.env,
52
+ // No announcement to a Discover directory from a test database.
53
+ DISCOVER_PING_URL: "",
54
+ };
55
+ for (const name of TARGET_VARIABLES) {
56
+ delete env[name];
57
+ }
58
+ return { ...env, ...overrides };
59
+ }
60
+
61
+ function runScript(
62
+ script: string,
63
+ args: string[],
64
+ env: Record<string, string | undefined>,
65
+ ) {
66
+ const result = spawnSync(
67
+ process.execPath,
68
+ ["dev/run-script.mjs", `dev/scripts/${script}`, ...args],
69
+ { cwd: CORE_DIR, encoding: "utf8", env, timeout: 120_000 },
70
+ );
71
+ expect(result.error).toBeUndefined();
72
+ return { ...result, output: `${result.stdout}\n${result.stderr}` };
73
+ }
74
+
75
+ function envFileLines(path: string): string[] {
76
+ return readFileSync(path, "utf8").split("\n");
77
+ }
78
+
79
+ describe("local Node dev tasks", () => {
80
+ const tempDirs: string[] = [];
81
+
82
+ afterEach(() => {
83
+ for (const dir of tempDirs.splice(0)) {
84
+ rmSync(dir, { recursive: true, force: true });
85
+ }
86
+ });
87
+
88
+ function makeTempDir(prefix: string): string {
89
+ const dir = mkdtempSync(join(tmpdir(), prefix));
90
+ tempDirs.push(dir);
91
+ return dir;
92
+ }
93
+
94
+ it(
95
+ "db-node-bootstrap-shell sets up the Node database and writes dev credentials to the env file",
96
+ { timeout: 300_000 },
97
+ () => {
98
+ const dir = makeTempDir("jant-bootstrap-shell-");
99
+ const envPath = join(dir, "test.env");
100
+ const ownLines = ["# Local settings", `DATA_DIR=${dir}`];
101
+ writeFileSync(envPath, `${ownLines.join("\n")}\n`);
102
+ const env = taskEnv({ JANT_ENV_FILE: envPath });
103
+
104
+ const first = runScript("bootstrap-node-dev.ts", [], env);
105
+ expect(first.status, first.output).toBe(0);
106
+ expect(first.stdout).toContain("created the site and the dev account");
107
+ expect(first.stdout).not.toMatch(/do(es)? not sign in/);
108
+
109
+ // The file's own lines stay as they were; the credentials follow as one
110
+ // block below a blank line.
111
+ const written = envFileLines(envPath);
112
+ expect(written.slice(0, 3)).toEqual([...ownLines, ""]);
113
+ expect(written.slice(3)).toEqual([
114
+ expect.stringMatching(/^AUTH_SECRET=\S{32,}$/),
115
+ expect.stringMatching(/^DEV_API_TOKEN=jnt_dev_[0-9a-f]{32}$/),
116
+ "DEMO_EMAIL=debug@jant.test",
117
+ "DEMO_PASSWORD=jant-dev-debug-login",
118
+ "",
119
+ ]);
120
+
121
+ const sqlite = new Database(join(dir, "jant.sqlite"), {
122
+ readonly: true,
123
+ });
124
+ try {
125
+ expect(
126
+ sqlite
127
+ .prepare(
128
+ `SELECT "user"."email" FROM "user" JOIN "account" ON "account"."user_id" = "user"."id" WHERE "account"."provider_id" = 'credential'`,
129
+ )
130
+ .all(),
131
+ ).toEqual([{ email: "debug@jant.test" }]);
132
+ expect(
133
+ sqlite
134
+ .prepare(
135
+ `SELECT "value" FROM "site_setting" WHERE "key" = 'ONBOARDING_STATUS'`,
136
+ )
137
+ .get(),
138
+ ).toEqual({ value: "completed" });
139
+ expect(
140
+ (
141
+ sqlite.prepare(`SELECT "system_key" FROM "nav_item"`).all() as {
142
+ system_key: string;
143
+ }[]
144
+ )
145
+ .map((row) => row.system_key)
146
+ .sort(),
147
+ ).toEqual([...DEFAULT_NAVIGATION_PROFILE.systemKeys].sort());
148
+ expect(
149
+ sqlite.prepare(`SELECT COUNT(*) AS count FROM "post"`).get(),
150
+ ).toEqual({ count: 0 });
151
+ } finally {
152
+ sqlite.close();
153
+ }
154
+
155
+ // A second run finds the site set up, and keeps the generated secrets.
156
+ const afterFirst = readFileSync(envPath, "utf8");
157
+ const second = runScript("bootstrap-node-dev.ts", [], env);
158
+ expect(second.status, second.output).toBe(0);
159
+ expect(second.stdout).toContain("already set up, left unchanged");
160
+ expect(second.stdout).not.toMatch(/do(es)? not sign in/);
161
+ expect(readFileSync(envPath, "utf8")).toBe(afterFirst);
162
+
163
+ // A new password is recorded, but not set on the existing account, and
164
+ // the task says so.
165
+ const third = runScript(
166
+ "bootstrap-node-dev.ts",
167
+ ["another-password"],
168
+ env,
169
+ );
170
+ expect(third.status, third.output).toBe(0);
171
+ expect(third.stdout).toContain(
172
+ "debug@jant.test has a different password",
173
+ );
174
+ expect(envFileLines(envPath)).toContain("DEMO_PASSWORD=another-password");
175
+ },
176
+ );
177
+
178
+ it(
179
+ "db-node-clean deletes the SQLite database, its WAL files, and media, and nothing else",
180
+ { timeout: 150_000 },
181
+ () => {
182
+ const dir = makeTempDir("jant-clean-");
183
+ const deleted = [
184
+ join(dir, "jant.sqlite"),
185
+ join(dir, "jant.sqlite-wal"),
186
+ join(dir, "jant.sqlite-shm"),
187
+ join(dir, "media"),
188
+ ];
189
+ const kept = join(dir, "notes.txt");
190
+ mkdirSync(join(dir, "media/2026"), { recursive: true });
191
+ writeFileSync(join(dir, "media/2026/photo.webp"), "image");
192
+ for (const file of deleted.slice(0, 3)) {
193
+ writeFileSync(file, "");
194
+ }
195
+ writeFileSync(kept, "keep");
196
+
197
+ const result = runScript(
198
+ "clean-node-dev.ts",
199
+ [],
200
+ taskEnv({ JANT_ENV_FILE: "", DATA_DIR: dir }),
201
+ );
202
+
203
+ expect(result.status, result.output).toBe(0);
204
+ expect(deleted.filter((path) => existsSync(path))).toEqual([]);
205
+ expect(existsSync(kept)).toBe(true);
206
+ },
207
+ );
208
+
209
+ it("db-node-clean refuses a Postgres database", { timeout: 150_000 }, () => {
210
+ const result = runScript(
211
+ "clean-node-dev.ts",
212
+ [],
213
+ taskEnv({
214
+ JANT_ENV_FILE: "",
215
+ DATABASE_URL: "postgres://jant:jant@127.0.0.1:9/jant_dev",
216
+ }),
217
+ );
218
+
219
+ expect(result.status).not.toBe(0);
220
+ expect(result.output).toContain(
221
+ "db-node-clean only supports Node SQLite development databases.",
222
+ );
223
+ });
224
+ });
225
+
226
+ describe("writeScriptEnvValues", () => {
227
+ const tempDirs: string[] = [];
228
+
229
+ afterEach(() => {
230
+ for (const dir of tempDirs.splice(0)) {
231
+ rmSync(dir, { recursive: true, force: true });
232
+ }
233
+ });
234
+
235
+ it("replaces keys in place and appends new ones as one block", () => {
236
+ const dir = mkdtempSync(join(tmpdir(), "jant-script-env-"));
237
+ tempDirs.push(dir);
238
+ const envPath = join(dir, ".env.node");
239
+ writeFileSync(
240
+ envPath,
241
+ "# Database\nDATABASE_URL=file:./data/jant.sqlite\nDEMO_PASSWORD=old\n\n\n",
242
+ );
243
+
244
+ writeScriptEnvValues(envPath, {
245
+ DEMO_PASSWORD: "new",
246
+ AUTH_SECRET: "secret",
247
+ DEV_API_TOKEN: "token",
248
+ });
249
+
250
+ expect(readFileSync(envPath, "utf8")).toBe(
251
+ "# Database\nDATABASE_URL=file:./data/jant.sqlite\nDEMO_PASSWORD=new\n\nAUTH_SECRET=secret\nDEV_API_TOKEN=token\n",
252
+ );
253
+ });
254
+
255
+ it("writes a new file without a leading blank line", () => {
256
+ const dir = mkdtempSync(join(tmpdir(), "jant-script-env-"));
257
+ tempDirs.push(dir);
258
+ const envPath = join(dir, ".env.node");
259
+
260
+ writeScriptEnvValues(envPath, { AUTH_SECRET: "secret" });
261
+
262
+ expect(readFileSync(envPath, "utf8")).toBe("AUTH_SECRET=secret\n");
263
+ });
264
+ });
@@ -0,0 +1,132 @@
1
+ /**
2
+ * Backups and exports written by a released Jant still load at head.
3
+ *
4
+ * `fixtures/releases/<version>/` freezes what that release wrote: a site
5
+ * snapshot (`snapshot/meta.json` and `snapshot/db.sql`, no objects) and a
6
+ * site export (`site-export/`, without the bundled theme's templates and
7
+ * styles, which import doesn't read). Both come from the canonical demo
8
+ * content at that release's tag and are never edited afterwards.
9
+ *
10
+ * The canonical fixtures under `sites/demo-source/canonical/` are
11
+ * re-exported as the demo changes, so they only prove that head reads what
12
+ * head writes. These prove that head reads what every earlier release wrote,
13
+ * which is what "a backup from 1.x restores on a later 1.x" means. A migration
14
+ * that renames a column, or an importer change that drops an old field,
15
+ * fails here. docs/RELEASING.md adds a directory at each release.
16
+ */
17
+
18
+ import { readdirSync, readFileSync } from "node:fs";
19
+ import { join, resolve } from "node:path";
20
+ import Database from "better-sqlite3";
21
+ import { afterEach, describe, expect, it } from "vitest";
22
+ import { __test__ as importSite } from "../../bin/commands/site/import.js";
23
+ import {
24
+ assertSnapshotMeta,
25
+ assertSnapshotSchemaInstalled,
26
+ buildReplaceSql,
27
+ getSnapshotBootstrapSite,
28
+ normalizeD1Sql,
29
+ rewriteSnapshotSiteIdentifiers,
30
+ upgradeSnapshotSql,
31
+ } from "../../bin/lib/site-snapshot.js";
32
+ import { DEFAULT_TEST_SITE_ID, createTestDatabase } from "./helpers/db.js";
33
+ import {
34
+ importSiteExportIntoTempSite,
35
+ type SiteExportImportResult,
36
+ } from "./helpers/site-export-import.js";
37
+
38
+ const RELEASES_DIR = resolve(import.meta.dirname, "fixtures/releases");
39
+ const RELEASES = readdirSync(RELEASES_DIR, { withFileTypes: true })
40
+ .filter((entry) => entry.isDirectory())
41
+ .map((entry) => entry.name)
42
+ .sort();
43
+
44
+ function count(sqlite: Database.Database, sql: string, ...params: unknown[]) {
45
+ return (sqlite.prepare(sql).get(...params) as { count: number }).count;
46
+ }
47
+
48
+ describe("release fixtures", () => {
49
+ it("has at least one release to check", () => {
50
+ expect(RELEASES.length).toBeGreaterThan(0);
51
+ });
52
+
53
+ for (const release of RELEASES) {
54
+ describe(release, () => {
55
+ const releaseDir = join(RELEASES_DIR, release);
56
+ const imports: SiteExportImportResult[] = [];
57
+
58
+ afterEach(() => {
59
+ for (const result of imports.splice(0)) result.cleanup();
60
+ });
61
+
62
+ it("restores its snapshot into a database migrated to head", () => {
63
+ const meta = JSON.parse(
64
+ readFileSync(join(releaseDir, "snapshot/meta.json"), "utf8"),
65
+ );
66
+ assertSnapshotMeta(meta);
67
+ assertSnapshotSchemaInstalled(meta);
68
+ const site = getSnapshotBootstrapSite(meta);
69
+ if (!site) throw new Error(`${release} snapshot names no site.`);
70
+
71
+ const sql = normalizeD1Sql(
72
+ rewriteSnapshotSiteIdentifiers(
73
+ upgradeSnapshotSql(
74
+ readFileSync(join(releaseDir, "snapshot/db.sql"), "utf8"),
75
+ meta.version,
76
+ ),
77
+ site.id,
78
+ DEFAULT_TEST_SITE_ID,
79
+ ),
80
+ );
81
+
82
+ const { sqlite } = createTestDatabase();
83
+ expect(() => {
84
+ sqlite.exec(buildReplaceSql(DEFAULT_TEST_SITE_ID));
85
+ sqlite.exec(sql);
86
+ }).not.toThrow();
87
+ expect(
88
+ count(
89
+ sqlite,
90
+ `SELECT COUNT(*) AS count FROM "post" WHERE "site_id" = ?`,
91
+ DEFAULT_TEST_SITE_ID,
92
+ ),
93
+ ).toBeGreaterThan(0);
94
+ });
95
+
96
+ it(
97
+ "imports its site export through `jant site import` at head",
98
+ { timeout: 150_000 },
99
+ async () => {
100
+ const exportDir = join(releaseDir, "site-export");
101
+ const result = importSiteExportIntoTempSite(exportDir);
102
+ imports.push(result);
103
+
104
+ expect(result.error).toBeUndefined();
105
+ expect(result.status, result.output).toBe(0);
106
+ expect(result.output).not.toMatch(/^Warning:/m);
107
+
108
+ const { rootBundles, collectionBundles } =
109
+ await importSite.walkHugoContent(exportDir);
110
+ const replyCount = rootBundles.reduce(
111
+ (sum: number, root: { children: unknown[] }) =>
112
+ sum + root.children.length,
113
+ 0,
114
+ );
115
+ expect(rootBundles.length).toBeGreaterThan(0);
116
+
117
+ const sqlite = new Database(result.databasePath, { readonly: true });
118
+ try {
119
+ expect(count(sqlite, `SELECT COUNT(*) AS count FROM "post"`)).toBe(
120
+ rootBundles.length + replyCount,
121
+ );
122
+ expect(
123
+ count(sqlite, `SELECT COUNT(*) AS count FROM "collection"`),
124
+ ).toBe(collectionBundles.length);
125
+ } finally {
126
+ sqlite.close();
127
+ }
128
+ },
129
+ );
130
+ });
131
+ }
132
+ });
@@ -0,0 +1,113 @@
1
+ /**
2
+ * Canonical Site-Export Import Guard
3
+ *
4
+ * `sites/demo-source/canonical/site-export/` is a committed `jant site export`.
5
+ * `mise run db-node-load-demo` loads it the portable way: migrate a local Node
6
+ * database, set it up, serve the app on a loopback port, and run
7
+ * `jant site import` against that server.
8
+ *
9
+ * Nothing ran that path, and it broke twice without a sign. From b259f4e3 the
10
+ * task called `site import` without the site URL the command had come to
11
+ * require. From 6c79f0b4 the importer sent boolean settings the settings route
12
+ * rejects, so importing any export stopped before it created a post. This test
13
+ * runs the task's own script against a throwaway SQLite database, so a change
14
+ * to the importer, the API it calls, the fixture, or the task fails here.
15
+ *
16
+ * `JANT_ENV_FILE` is empty for the whole suite (`vitest.config.ts`), and the
17
+ * script honours it, so a developer's `.env.node` is neither read nor
18
+ * rewritten. The script runs through `dev/run-script.mjs`, which starts Vite,
19
+ * hence the timeout.
20
+ */
21
+
22
+ import { readdirSync } from "node:fs";
23
+ import { basename, join, resolve } from "node:path";
24
+ import Database from "better-sqlite3";
25
+ import { afterEach, describe, expect, it } from "vitest";
26
+ import { __test__ as importSite } from "../../bin/commands/site/import.js";
27
+ import {
28
+ importSiteExportIntoTempSite,
29
+ type SiteExportImportResult,
30
+ } from "./helpers/site-export-import.js";
31
+
32
+ const CORE_DIR = resolve(import.meta.dirname, "../..");
33
+ const CANONICAL_DIR = resolve(
34
+ CORE_DIR,
35
+ "../../sites/demo-source/canonical/site-export",
36
+ );
37
+
38
+ function count(sqlite: Database.Database, sql: string): number {
39
+ return (sqlite.prepare(sql).get() as { count: number }).count;
40
+ }
41
+
42
+ describe("canonical demo site-export", () => {
43
+ const imports: SiteExportImportResult[] = [];
44
+
45
+ afterEach(() => {
46
+ for (const result of imports.splice(0)) result.cleanup();
47
+ });
48
+
49
+ it(
50
+ "imports through `jant site import` into a local Node database at head",
51
+ { timeout: 150_000 },
52
+ async () => {
53
+ const result = importSiteExportIntoTempSite();
54
+ imports.push(result);
55
+ const { databasePath, output } = result;
56
+
57
+ expect(result.error).toBeUndefined();
58
+ expect(result.status, output).toBe(0);
59
+ expect(result.stdout).toContain("(none: JANT_ENV_FILE is empty)");
60
+ // The importer reports a step it gave up on as a warning and carries on,
61
+ // the way it once dropped the site avatar.
62
+ expect(output).not.toMatch(/^Warning:/m);
63
+
64
+ const { rootBundles, collectionBundles } =
65
+ await importSite.walkHugoContent(CANONICAL_DIR);
66
+ const siteConfig = await importSite.loadSiteConfig(CANONICAL_DIR);
67
+ const replyCount = rootBundles.reduce(
68
+ (sum: number, root: { children: unknown[] }) =>
69
+ sum + root.children.length,
70
+ 0,
71
+ );
72
+ // An empty fixture and an import that did nothing would agree on zero.
73
+ expect(rootBundles.length).toBeGreaterThan(0);
74
+ const avatarFile = basename(siteConfig.extra.jant.site_avatar_url);
75
+ const postMediaFiles = readdirSync(
76
+ join(CANONICAL_DIR, "static/media"),
77
+ ).filter((name) => name !== avatarFile);
78
+
79
+ const sqlite = new Database(databasePath, { readonly: true });
80
+ try {
81
+ expect(count(sqlite, `SELECT COUNT(*) AS count FROM "user"`)).toBe(1);
82
+ expect(count(sqlite, `SELECT COUNT(*) AS count FROM "post"`)).toBe(
83
+ rootBundles.length + replyCount,
84
+ );
85
+ expect(
86
+ count(sqlite, `SELECT COUNT(*) AS count FROM "collection"`),
87
+ ).toBe(collectionBundles.length);
88
+ expect(
89
+ count(
90
+ sqlite,
91
+ `SELECT COUNT(*) AS count FROM "media" WHERE "storage_key" LIKE '%/files/%'`,
92
+ ),
93
+ ).toBe(postMediaFiles.length);
94
+
95
+ const settings = new Map(
96
+ (
97
+ sqlite
98
+ .prepare(`SELECT "key", "value" FROM "site_setting"`)
99
+ .all() as { key: string; value: string }[]
100
+ ).map(({ key, value }) => [key, value]),
101
+ );
102
+ expect(settings.get("SITE_NAME")).toBe(siteConfig.title);
103
+ expect(settings.get("SITE_AVATAR")).toMatch(/\/assets\/avatar\//);
104
+ expect(settings.get("SITE_FAVICON_ICO")).toBeTruthy();
105
+ expect(settings.get("SITE_FAVICON_APPLE_TOUCH")).toMatch(
106
+ /\/assets\/favicon\/apple-touch-icon\.png$/,
107
+ );
108
+ } finally {
109
+ sqlite.close();
110
+ }
111
+ },
112
+ );
113
+ });
@@ -0,0 +1,179 @@
1
+ /**
2
+ * Canonical Snapshot Replay Guard
3
+ *
4
+ * `sites/demo-source/canonical/snapshot/` is a committed SQL dump. The nightly
5
+ * demo rebuild migrates demo.jant.me's database to whatever `main` says, then
6
+ * replays that dump into it — so the dump has to stay loadable against head,
7
+ * however long ago it was exported.
8
+ *
9
+ * Nothing checked that. A migration that renamed a column, added a NOT NULL
10
+ * without a default, or reordered the snapshot registries would leave the
11
+ * committed dump unloadable, and the first sign of it would be the reset job
12
+ * failing at ~03:00 UTC — which nothing reports either. This test moves that
13
+ * failure to the pull request that causes it.
14
+ *
15
+ * `createTestDatabase()` applies every migration in order and enables foreign
16
+ * keys, so the replay here is checked at least as strictly as the real target.
17
+ */
18
+
19
+ import { readFileSync } from "node:fs";
20
+ import { resolve } from "node:path";
21
+ import { describe, expect, it } from "vitest";
22
+ import {
23
+ DEFER_FOREIGN_KEYS_SQL,
24
+ SNAPSHOT_TABLES,
25
+ assertSnapshotMeta,
26
+ buildReplaceSql,
27
+ getSnapshotBootstrapSite,
28
+ getSnapshotSelectSql,
29
+ normalizeD1Sql,
30
+ rewriteSnapshotSiteIdentifiers,
31
+ } from "../../bin/lib/site-snapshot.js";
32
+ import { DEFAULT_TEST_SITE_ID, createTestDatabase } from "./helpers/db.js";
33
+
34
+ const CANONICAL_DIR = resolve(
35
+ import.meta.dirname,
36
+ "../../../../sites/demo-source/canonical/snapshot",
37
+ );
38
+
39
+ function readCanonicalSql(): string {
40
+ const meta = JSON.parse(
41
+ readFileSync(resolve(CANONICAL_DIR, "meta.json"), "utf8"),
42
+ );
43
+ assertSnapshotMeta(meta);
44
+
45
+ const snapshotSite = getSnapshotBootstrapSite(meta);
46
+ if (!snapshotSite) {
47
+ throw new Error("Canonical snapshot has no embedded site metadata.");
48
+ }
49
+
50
+ const rawDbSql = readFileSync(resolve(CANONICAL_DIR, "db.sql"), "utf8");
51
+ return normalizeD1Sql(
52
+ rewriteSnapshotSiteIdentifiers(
53
+ rawDbSql,
54
+ snapshotSite.id,
55
+ DEFAULT_TEST_SITE_ID,
56
+ ),
57
+ );
58
+ }
59
+
60
+ describe("canonical demo snapshot", () => {
61
+ it("replays into a database migrated to head", () => {
62
+ const { sqlite } = createTestDatabase();
63
+ const dbSql = readCanonicalSql();
64
+
65
+ expect(() => {
66
+ sqlite.exec(buildReplaceSql(DEFAULT_TEST_SITE_ID));
67
+ sqlite.exec(dbSql);
68
+ }).not.toThrow();
69
+
70
+ // Guard against a vacuous pass: an empty dump would also "not throw".
71
+ const posts = sqlite
72
+ .prepare(`SELECT COUNT(*) AS count FROM "post" WHERE "site_id" = ?`)
73
+ .get(DEFAULT_TEST_SITE_ID) as { count: number };
74
+ expect(posts.count).toBeGreaterThan(0);
75
+ });
76
+
77
+ it("restores the language setup its posts are stamped for", () => {
78
+ // The demo publishes in two languages. When the snapshot carried each
79
+ // post's `language` but not `MULTILINGUAL_ENABLED`, every rebuild left
80
+ // demo.jant.me serving no per-language views at all, and the Chinese side
81
+ // of the demo disappeared at ~00:00 UTC each night.
82
+ const { sqlite } = createTestDatabase();
83
+
84
+ sqlite.exec(buildReplaceSql(DEFAULT_TEST_SITE_ID));
85
+ sqlite.exec(readCanonicalSql());
86
+
87
+ const languages = sqlite
88
+ .prepare(
89
+ `SELECT DISTINCT "language" FROM "post" WHERE "site_id" = ? AND "language" IS NOT NULL`,
90
+ )
91
+ .all(DEFAULT_TEST_SITE_ID) as { language: string }[];
92
+ if (languages.length < 2) return;
93
+
94
+ const settings = sqlite
95
+ .prepare(
96
+ `SELECT "key", "value" FROM "site_setting" WHERE "site_id" = ? AND "key" IN ('SITE_LANGUAGE', 'MULTILINGUAL_ENABLED', 'ADDITIONAL_LANGUAGES')`,
97
+ )
98
+ .all(DEFAULT_TEST_SITE_ID) as { key: string; value: string }[];
99
+ const value = (key: string) =>
100
+ settings.find((row) => row.key === key)?.value ?? "";
101
+
102
+ expect(value("MULTILINGUAL_ENABLED")).toBe("true");
103
+
104
+ const served = new Set([
105
+ value("SITE_LANGUAGE"),
106
+ ...value("ADDITIONAL_LANGUAGES").split(",").filter(Boolean),
107
+ ]);
108
+ expect(
109
+ languages.map((row) => row.language).filter((tag) => !served.has(tag)),
110
+ ).toEqual([]);
111
+ });
112
+
113
+ it("replays twice, the way a nightly rebuild does", () => {
114
+ // `--replace` runs against a site that already holds the previous rebuild's
115
+ // rows, so the delete order matters as much as the insert order. A first
116
+ // load into an empty database would never exercise it.
117
+ const { sqlite } = createTestDatabase();
118
+ const dbSql = readCanonicalSql();
119
+
120
+ sqlite.exec(buildReplaceSql(DEFAULT_TEST_SITE_ID));
121
+ sqlite.exec(dbSql);
122
+
123
+ expect(() => {
124
+ sqlite.exec(buildReplaceSql(DEFAULT_TEST_SITE_ID));
125
+ sqlite.exec(dbSql);
126
+ }).not.toThrow();
127
+ });
128
+ });
129
+
130
+ describe("snapshot export queries", () => {
131
+ it("runs every content table's export query against head", () => {
132
+ // The registry, the SELECT statement and the schema have to agree on
133
+ // column names, not just table names. A stale `ORDER BY` column would
134
+ // otherwise only surface the next time someone exported a snapshot.
135
+ const { sqlite } = createTestDatabase();
136
+
137
+ for (const table of SNAPSHOT_TABLES) {
138
+ expect(() =>
139
+ sqlite.prepare(getSnapshotSelectSql(table, DEFAULT_TEST_SITE_ID)).all(),
140
+ ).not.toThrow();
141
+ }
142
+ });
143
+
144
+ // Snapshots written before posts were ordered parents-first put a reply
145
+ // older than its root ahead of the root. The import checks foreign keys at
146
+ // commit on SQLite and D1, so those snapshots still load.
147
+ it("loads a snapshot that lists a reply before its root", () => {
148
+ const { sqlite } = createTestDatabase();
149
+ const post = (id: string, threadId: string, replyToId: string | null) =>
150
+ `INSERT INTO "post" ("id", "site_id", "format", "status", "visibility", "reply_to_id", "thread_id", "published_at", "last_activity_at", "created_at", "updated_at", "thread_updated_at") VALUES ('${id}', '${DEFAULT_TEST_SITE_ID}', 'note', 'published', 'public', ${replyToId ? `'${replyToId}'` : "NULL"}, '${threadId}', 1, 1, 1, 1, 1);`;
151
+ const dump = [
152
+ post(
153
+ "pst_01aaaaaaaaaaaaaaaaaaaaaaab",
154
+ "pst_01aaaaaaaaaaaaaaaaaaaaaaaa",
155
+ "pst_01aaaaaaaaaaaaaaaaaaaaaaaa",
156
+ ),
157
+ post(
158
+ "pst_01aaaaaaaaaaaaaaaaaaaaaaaa",
159
+ "pst_01aaaaaaaaaaaaaaaaaaaaaaaa",
160
+ null,
161
+ ),
162
+ ].join("\n");
163
+
164
+ expect(() =>
165
+ sqlite.transaction(() => {
166
+ sqlite.exec(buildReplaceSql(DEFAULT_TEST_SITE_ID));
167
+ sqlite.exec(dump);
168
+ })(),
169
+ ).toThrow(/FOREIGN KEY/);
170
+
171
+ expect(() =>
172
+ sqlite.transaction(() => {
173
+ sqlite.exec(DEFER_FOREIGN_KEYS_SQL);
174
+ sqlite.exec(buildReplaceSql(DEFAULT_TEST_SITE_ID));
175
+ sqlite.exec(dump);
176
+ })(),
177
+ ).not.toThrow();
178
+ });
179
+ });