@jant/core 0.7.1 → 0.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (329) 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/site/export.js +48 -36
  6. package/bin/commands/site/import.js +3074 -2
  7. package/bin/commands/site/snapshot/import.js +2 -0
  8. package/bin/commands/telegram/register-webhooks.js +48 -23
  9. package/bin/jant.js +16 -11
  10. package/bin/lib/command-registry.js +120 -0
  11. package/bin/lib/migration-artifacts.js +19 -0
  12. package/bin/lib/renamed-arguments.js +56 -0
  13. package/bin/lib/site-snapshot.js +83 -1
  14. package/dist/{app-ZcaI1kPN.js → app--uxnaIRV.js} +8339 -740
  15. package/dist/client/.vite/manifest.json +3 -3
  16. package/dist/client/_assets/{client-DAhoqPdr.css → client-BCumu1-D.css} +1 -1
  17. package/dist/client/_assets/{client-knSEyUJO.js → client-BT6kpcuG.js} +1 -1
  18. package/dist/client/_assets/{client-auth-CAMfTrKW.js → client-auth-begiT1tq.js} +1 -1
  19. package/dist/index.js +2 -3
  20. package/dist/node.js +2 -3
  21. package/dist/url-CKlGzvdN.js +428 -0
  22. package/package.json +1 -5
  23. package/src/__tests__/cli-commands.test.ts +144 -0
  24. package/src/__tests__/config-docs.test.ts +148 -0
  25. package/src/__tests__/export-import-roundtrip.test.ts +1 -1
  26. package/src/__tests__/feed-docs.test.ts +36 -0
  27. package/src/__tests__/fixtures/releases/0.7.0/site-export/README.md +89 -0
  28. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/41q27/0x4nv/index.md +16 -0
  29. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/41q27/_index.md +41 -0
  30. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/41q27/faqyt/index.md +28 -0
  31. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/41q27/the-potting-mix-guide-i-keep-rereading/index.md +18 -0
  32. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/_index.md +4 -0
  33. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/a-night-heron-field-guide-for-my-walk-folder/_index.md +27 -0
  34. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/a-quiet-saturday-after-a-busy-week/_index.md +32 -0
  35. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/archive/_index.md +7 -0
  36. 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
  37. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/bought-too-many-lemons-again/_index.md +34 -0
  38. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/city-walks/_index.md +11 -0
  39. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/collections/_index.md +4 -0
  40. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/current-tea-rotation/_index.md +31 -0
  41. 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
  42. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/desk-but-better/_index.md +22 -0
  43. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/e0kcg/_index.md +19 -0
  44. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/featured/_index.md +7 -0
  45. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-basho/_index.md +22 -0
  46. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-epictetus/_index.md +22 -0
  47. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-marcus-aurelius/_index.md +22 -0
  48. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-seneca/_index.md +22 -0
  49. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-thoreau/_index.md +22 -0
  50. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/gkbvv/2cl6d/index.md +16 -0
  51. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/gkbvv/3zqv7/index.md +28 -0
  52. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/gkbvv/5oxsv/index.md +16 -0
  53. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/gkbvv/_index.md +36 -0
  54. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/home-cooking/_index.md +11 -0
  55. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/k5vh8/_index.md +29 -0
  56. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/k5vh8/a-reading-log-idea-i-might-steal/index.md +18 -0
  57. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/k5vh8/a83qu/index.md +16 -0
  58. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/k5vh8/from-seneca-5hibo/index.md +19 -0
  59. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/mynoise-for-rainy-afternoons/_index.md +27 -0
  60. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/nts-archives-are-good-cleaning-music/_index.md +27 -0
  61. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/qgfcu/_index.md +29 -0
  62. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/qgfcu/c91j0/index.md +16 -0
  63. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/qgfcu/qyucy/index.md +16 -0
  64. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/qgfcu/wsgck/index.md +16 -0
  65. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/rain-makes-my-neighborhood-look-better/_index.md +43 -0
  66. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/reading-notes/_index.md +11 -0
  67. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/serious-eats-on-tomato-and-egg-soup/_index.md +27 -0
  68. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/te812/_index.md +41 -0
  69. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/te812/cxiu6/index.md +16 -0
  70. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/te812/t77ms/index.md +16 -0
  71. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/te812/the-soup-trick-i-always-forget/index.md +18 -0
  72. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/telk3/_index.md +27 -0
  73. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/telk3/from-thoreau-pawt2/index.md +17 -0
  74. 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
  75. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/the-hallway-light-took-12-minutes-and-3-months/_index.md +29 -0
  76. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/the-recurse-center-manual-is-weirdly-calming/_index.md +27 -0
  77. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/tiny-projects/_index.md +11 -0
  78. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/useful-links/_index.md +11 -0
  79. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/weekend-notes/_index.md +11 -0
  80. package/src/__tests__/fixtures/releases/0.7.0/site-export/content/what-i-actually-use-my-notebook-for/_index.md +49 -0
  81. package/src/__tests__/fixtures/releases/0.7.0/site-export/data/jant.toml +119 -0
  82. package/src/__tests__/fixtures/releases/0.7.0/site-export/hugo.toml +43 -0
  83. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/021801c20ab3-med_01kn8jw26cenf98vc7k0ppz5k8.webp +0 -0
  84. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/0f868ce9ac84-med_01kn8jtx8qenf98tm9ahxr48sw.webp +0 -0
  85. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/50c2ad911bad-med_01kn8jvb16enf98txp7p0pf5ge.webp +0 -0
  86. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/7a91f0960491-med_01kn8jvq58enf98v538w5vsqp4.webp +0 -0
  87. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/8714116d3c8e-med_01kn8jve5nenf98tzap11gpxzr.webp +0 -0
  88. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/8a0b4277443f-med_01kn8jv0jdenf98tp6qr9zgjjc.webp +0 -0
  89. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/a7d1c8a1afd9-med_01kn8jv452enf98trbkwrvhvgd.webp +0 -0
  90. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/e25570b405f5-med_01kn8jvsaeenf98v6ct4gjzppc.webp +0 -0
  91. package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/e89ea4eabf01-med_01kn8jtq3penf98tfq4gzmh9g9.png +0 -0
  92. package/src/__tests__/fixtures/releases/0.7.0/site-export/themes/jant/static/apple-touch-icon.png +0 -0
  93. package/src/__tests__/fixtures/releases/0.7.0/site-export/themes/jant/static/custom.css +0 -0
  94. package/src/__tests__/fixtures/releases/0.7.0/site-export/themes/jant/static/favicon.ico +0 -0
  95. package/src/__tests__/fixtures/releases/0.7.0/snapshot/db.sql +218 -0
  96. package/src/__tests__/fixtures/releases/0.7.0/snapshot/meta.json +9 -0
  97. package/src/__tests__/fixtures/releases/0.7.1/site-export/README.md +89 -0
  98. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/41q27/0x4nv/index.md +16 -0
  99. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/41q27/_index.md +41 -0
  100. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/41q27/faqyt/index.md +28 -0
  101. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/41q27/the-potting-mix-guide-i-keep-rereading/index.md +18 -0
  102. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/_index.md +4 -0
  103. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/a-night-heron-field-guide-for-my-walk-folder/_index.md +27 -0
  104. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/a-quiet-saturday-after-a-busy-week/_index.md +32 -0
  105. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/archive/_index.md +7 -0
  106. 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
  107. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/bought-too-many-lemons-again/_index.md +34 -0
  108. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/city-walks/_index.md +11 -0
  109. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/collections/_index.md +4 -0
  110. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/current-tea-rotation/_index.md +31 -0
  111. 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
  112. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/desk-but-better/_index.md +22 -0
  113. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/e0kcg/_index.md +19 -0
  114. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/featured/_index.md +7 -0
  115. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-basho/_index.md +22 -0
  116. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-epictetus/_index.md +22 -0
  117. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-marcus-aurelius/_index.md +22 -0
  118. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-seneca/_index.md +22 -0
  119. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-thoreau/_index.md +22 -0
  120. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/gkbvv/2cl6d/index.md +16 -0
  121. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/gkbvv/3zqv7/index.md +28 -0
  122. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/gkbvv/5oxsv/index.md +16 -0
  123. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/gkbvv/_index.md +36 -0
  124. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/home-cooking/_index.md +11 -0
  125. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/k5vh8/_index.md +29 -0
  126. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/k5vh8/a-reading-log-idea-i-might-steal/index.md +18 -0
  127. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/k5vh8/a83qu/index.md +16 -0
  128. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/k5vh8/from-seneca-5hibo/index.md +19 -0
  129. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/mynoise-for-rainy-afternoons/_index.md +27 -0
  130. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/nts-archives-are-good-cleaning-music/_index.md +27 -0
  131. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/qgfcu/_index.md +29 -0
  132. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/qgfcu/c91j0/index.md +16 -0
  133. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/qgfcu/qyucy/index.md +16 -0
  134. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/qgfcu/wsgck/index.md +16 -0
  135. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/rain-makes-my-neighborhood-look-better/_index.md +43 -0
  136. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/reading-notes/_index.md +11 -0
  137. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/serious-eats-on-tomato-and-egg-soup/_index.md +27 -0
  138. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/te812/_index.md +41 -0
  139. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/te812/cxiu6/index.md +16 -0
  140. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/te812/t77ms/index.md +16 -0
  141. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/te812/the-soup-trick-i-always-forget/index.md +18 -0
  142. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/telk3/_index.md +27 -0
  143. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/telk3/from-thoreau-pawt2/index.md +17 -0
  144. 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
  145. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/the-hallway-light-took-12-minutes-and-3-months/_index.md +29 -0
  146. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/the-recurse-center-manual-is-weirdly-calming/_index.md +27 -0
  147. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/tiny-projects/_index.md +11 -0
  148. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/useful-links/_index.md +11 -0
  149. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/weekend-notes/_index.md +11 -0
  150. package/src/__tests__/fixtures/releases/0.7.1/site-export/content/what-i-actually-use-my-notebook-for/_index.md +49 -0
  151. package/src/__tests__/fixtures/releases/0.7.1/site-export/data/jant.toml +119 -0
  152. package/src/__tests__/fixtures/releases/0.7.1/site-export/hugo.toml +43 -0
  153. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/021801c20ab3-med_01kn8jw26cenf98vc7k0ppz5k8.webp +0 -0
  154. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/0f868ce9ac84-med_01kn8jtx8qenf98tm9ahxr48sw.webp +0 -0
  155. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/50c2ad911bad-med_01kn8jvb16enf98txp7p0pf5ge.webp +0 -0
  156. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/7a91f0960491-med_01kn8jvq58enf98v538w5vsqp4.webp +0 -0
  157. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/8714116d3c8e-med_01kn8jve5nenf98tzap11gpxzr.webp +0 -0
  158. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/8a0b4277443f-med_01kn8jv0jdenf98tp6qr9zgjjc.webp +0 -0
  159. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/a7d1c8a1afd9-med_01kn8jv452enf98trbkwrvhvgd.webp +0 -0
  160. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/e25570b405f5-med_01kn8jvsaeenf98v6ct4gjzppc.webp +0 -0
  161. package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/e89ea4eabf01-med_01kn8jtq3penf98tfq4gzmh9g9.png +0 -0
  162. package/src/__tests__/fixtures/releases/0.7.1/site-export/themes/jant/static/apple-touch-icon.png +0 -0
  163. package/src/__tests__/fixtures/releases/0.7.1/site-export/themes/jant/static/custom.css +0 -0
  164. package/src/__tests__/fixtures/releases/0.7.1/site-export/themes/jant/static/favicon.ico +0 -0
  165. package/src/__tests__/fixtures/releases/0.7.1/snapshot/db.sql +322 -0
  166. package/src/__tests__/fixtures/releases/0.7.1/snapshot/meta.json +9 -0
  167. package/src/__tests__/fixtures/releases/0.8.0/site-export/README.md +130 -0
  168. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/2thjq/_index.md +25 -0
  169. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/2u5e5/_index.md +35 -0
  170. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/41q27/0x4nv/index.md +18 -0
  171. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/41q27/_index.md +44 -0
  172. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/41q27/faqyt/index.md +30 -0
  173. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/41q27/the-potting-mix-guide-i-keep-rereading/index.md +20 -0
  174. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/5kayp/_index.md +23 -0
  175. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/5ynfs/_index.md +31 -0
  176. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/5ynfs/hu597/index.md +21 -0
  177. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/_index.md +5 -0
  178. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/a-night-heron-field-guide-for-my-walk-folder/_index.md +31 -0
  179. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/a-quiet-saturday-after-a-busy-week/_index.md +36 -0
  180. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/archive/_index.md +8 -0
  181. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/are-na-is-the-only-bookmark-pile-i-still-revisit/_index.md +30 -0
  182. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/bought-too-many-lemons-again/_index.md +37 -0
  183. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/city-walks/_index.md +12 -0
  184. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/cleanshot-for-screenshots-ocr-and-screen-recording-on-the-mac/_index.md +33 -0
  185. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/cleanshotmac-shang-de-jie-tu-ocr-lu-ping-gong-ju/_index.md +32 -0
  186. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/co344/_index.md +25 -0
  187. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/collections/_index.md +5 -0
  188. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/current-tea-rotation/_index.md +34 -0
  189. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/derek-sivers-still-writes-the-kind-of-internet-i-want-more-of/_index.md +30 -0
  190. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/desk-but-better/_index.md +25 -0
  191. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/e0kcg/_index.md +22 -0
  192. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/egi3c/_index.md +24 -0
  193. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/evf9j/_index.md +152 -0
  194. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/featured/_index.md +8 -0
  195. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-basho/_index.md +25 -0
  196. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-epictetus/_index.md +25 -0
  197. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-marcus-aurelius/_index.md +25 -0
  198. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-seneca/_index.md +26 -0
  199. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-thoreau/_index.md +25 -0
  200. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gkbvv/2cl6d/index.md +18 -0
  201. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gkbvv/3zqv7/index.md +30 -0
  202. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gkbvv/5oxsv/index.md +18 -0
  203. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gkbvv/_index.md +39 -0
  204. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gwob9/_index.md +25 -0
  205. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/home-cooking/_index.md +12 -0
  206. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/hz729/_index.md +24 -0
  207. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/inaturalist-ai-zi-ran-she-qu/_index.md +44 -0
  208. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/j4v0q/_index.md +35 -0
  209. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k278t/_index.md +25 -0
  210. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k4eee/_index.md +22 -0
  211. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k5vh8/_index.md +32 -0
  212. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k5vh8/a-reading-log-idea-i-might-steal/index.md +20 -0
  213. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k5vh8/a83qu/index.md +18 -0
  214. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k5vh8/from-seneca-5hibo/index.md +21 -0
  215. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/kan-qi-lai-bi-jiao-ku-de-gong-si-men/_index.md +41 -0
  216. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/l2m7y/_index.md +29 -0
  217. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/lan-ya-yao-kong-qi-chuang-shang-yue-du-de-fan-ye-shen-qi/_index.md +57 -0
  218. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/mynoise-for-rainy-afternoons/_index.md +30 -0
  219. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/n09le/_index.md +23 -0
  220. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/ni-fu-jin-de-wei-ji-bai-ke-tiao-mu/_index.md +42 -0
  221. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/nts-archives-are-good-cleaning-music/_index.md +30 -0
  222. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/qgfcu/_index.md +32 -0
  223. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/qgfcu/c91j0/index.md +18 -0
  224. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/qgfcu/qyucy/index.md +18 -0
  225. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/qgfcu/wsgck/index.md +18 -0
  226. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/rain-makes-my-neighborhood-look-better/_index.md +46 -0
  227. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/reading-notes/_index.md +12 -0
  228. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/s4r3e/_index.md +25 -0
  229. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/serious-eats-on-tomato-and-egg-soup/_index.md +30 -0
  230. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/te812/_index.md +44 -0
  231. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/te812/cxiu6/index.md +18 -0
  232. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/te812/t77ms/index.md +18 -0
  233. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/te812/the-soup-trick-i-always-forget/index.md +20 -0
  234. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/telk3/_index.md +30 -0
  235. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/telk3/from-thoreau-pawt2/index.md +21 -0
  236. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/the-five-minute-reset-is-still-the-best-habit-i-have/_index.md +36 -0
  237. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/the-hallway-light-took-12-minutes-and-3-months/_index.md +32 -0
  238. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/the-recurse-center-manual-is-weirdly-calming/_index.md +30 -0
  239. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/tiny-projects/_index.md +12 -0
  240. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/tong-wang-xing-fu-zhi-lu/_index.md +68 -0
  241. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/tou-ma-yan-jiang-ju-le-bu-chu-ti-yan/_index.md +62 -0
  242. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/useful-links/_index.md +12 -0
  243. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/weekend-notes/_index.md +12 -0
  244. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/what-i-actually-use-my-notebook-for/_index.md +52 -0
  245. package/src/__tests__/fixtures/releases/0.8.0/site-export/data/jant.toml +124 -0
  246. package/src/__tests__/fixtures/releases/0.8.0/site-export/hugo.toml +45 -0
  247. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/_redirects +25 -0
  248. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/15d51730a4f7-med_01kn8jtq3penf98tfq4gzmh9g9.png +0 -0
  249. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jtx8qenf98tm9ahxr48sw.webp +0 -0
  250. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jv0jdenf98tp6qr9zgjjc.webp +0 -0
  251. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jv452enf98trbkwrvhvgd.webp +0 -0
  252. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jvb16enf98txp7p0pf5ge.webp +0 -0
  253. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jve5nenf98tzap11gpxzr.webp +0 -0
  254. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jvq58enf98v538w5vsqp4.webp +0 -0
  255. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jvsaeenf98v6ct4gjzppc.webp +0 -0
  256. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jw26cenf98vc7k0ppz5k8.webp +0 -0
  257. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m313q1hme4e8cmby77dn66yy.webp +0 -0
  258. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m313q2w7e4e8cmc20036yh66.webp +0 -0
  259. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m313q7d2e4e8cmdeqjmyafby.webp +0 -0
  260. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m313q887e4e8cmdjssych7yh.webp +0 -0
  261. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167jx2f6ct88pkz45j3ycp-poster.webp +0 -0
  262. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167jx2f6ct88pkz45j3ycp.mp4 +0 -0
  263. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167mbdf6ct88pr4ga1b9kf-poster.webp +0 -0
  264. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167mbdf6ct88pr4ga1b9kf.mp4 +0 -0
  265. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167nsvf6ct88q1anhz4svb-poster.webp +0 -0
  266. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167nsvf6ct88q1anhz4svb.mp4 +0 -0
  267. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167qaxf6ct88qfndwzxx83-poster.webp +0 -0
  268. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167qaxf6ct88qfndwzxx83.mp4 +0 -0
  269. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167sm0f6ct88qw5brtsgcw.webp +0 -0
  270. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167tf8f6ct88r169s51j49.webp +0 -0
  271. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167vaaf6ct88rbx5ztenwb.webp +0 -0
  272. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167w51f6ct88rp19pybkw1.webp +0 -0
  273. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167x0nf6ct88rzajb84tw3.webp +0 -0
  274. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167xxbf6ct88s5t2300bjk.webp +0 -0
  275. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167yq5f6ct88s9pjwt5fxg.webp +0 -0
  276. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167zg4f6ct88sge8jp28ja.webp +0 -0
  277. package/src/__tests__/fixtures/releases/0.8.0/site-export/themes/jant/static/apple-touch-icon.png +0 -0
  278. package/src/__tests__/fixtures/releases/0.8.0/site-export/themes/jant/static/custom.css +0 -0
  279. package/src/__tests__/fixtures/releases/0.8.0/site-export/themes/jant/static/favicon.ico +0 -0
  280. package/src/__tests__/fixtures/releases/0.8.0/site-export/wrangler.jsonc +24 -0
  281. package/src/__tests__/fixtures/releases/0.8.0/snapshot/db.sql +322 -0
  282. package/src/__tests__/fixtures/releases/0.8.0/snapshot/meta.json +11 -0
  283. package/src/__tests__/helpers/cursor-walk.ts +52 -0
  284. package/src/__tests__/helpers/site-export-import.ts +97 -0
  285. package/src/__tests__/import-site-command.test.ts +27 -1
  286. package/src/__tests__/release-fixtures.test.ts +136 -0
  287. package/src/__tests__/site-export-canonical-import.test.ts +11 -47
  288. package/src/__tests__/theme-docs.test.ts +109 -0
  289. package/src/app.tsx +1 -5
  290. package/src/db/rehearsal-fixtures/pg-demo-current.json +55 -0
  291. package/src/db/rehearsal-fixtures/pg-demo-current.sql +431 -0
  292. package/src/i18n/locales/public/en.po +0 -2
  293. package/src/i18n/locales/public/zh-Hans.po +0 -2
  294. package/src/i18n/locales/public/zh-Hant.po +0 -2
  295. package/src/index.ts +6 -77
  296. package/src/lib/__tests__/post-list-cursor.test.ts +105 -0
  297. package/src/lib/__tests__/timeline.test.ts +14 -14
  298. package/src/lib/__tests__/view.test.ts +0 -46
  299. package/src/lib/feed.ts +0 -6
  300. package/src/lib/post-list-cursor.ts +211 -0
  301. package/src/lib/view.ts +0 -27
  302. package/src/node/__tests__/cli-export.test.ts +2 -2
  303. package/src/node/__tests__/cli-site-snapshot.test.ts +6 -0
  304. package/src/node/__tests__/cli-site-token-env.test.ts +4 -1
  305. package/src/node/__tests__/cli-snapshot-meta.test.ts +64 -0
  306. package/src/routes/api/__tests__/mcp.test.ts +58 -0
  307. package/src/routes/api/__tests__/posts.test.ts +79 -0
  308. package/src/routes/api/internal/search-reindex.ts +1 -1
  309. package/src/routes/api/posts.ts +5 -9
  310. package/src/routes/api/public/__tests__/archive.test.ts +261 -0
  311. package/src/routes/api/public/__tests__/posts.test.ts +344 -19
  312. package/src/routes/api/public/archive.ts +18 -16
  313. package/src/routes/api/public/posts.ts +15 -16
  314. package/src/services/__tests__/media.test.ts +0 -271
  315. package/src/services/__tests__/post.test.ts +342 -36
  316. package/src/services/export.ts +13 -5
  317. package/src/services/mcp.ts +6 -11
  318. package/src/services/media.ts +1 -219
  319. package/src/services/post.ts +513 -319
  320. package/src/styles/ui.css +0 -118
  321. package/src/ui/shared/Pagination.tsx +1 -1
  322. package/bin/commands/export.js +0 -120
  323. package/bin/commands/import-site.js +0 -3034
  324. package/bin/commands/migrate-text-attachments.js +0 -181
  325. package/dist/github-sync-Gw4orAHk.js +0 -8398
  326. package/src/client/multipart-upload.ts +0 -206
  327. package/src/routes/api/__tests__/upload-multipart.test.ts +0 -739
  328. package/src/routes/api/internal/text-attachments.ts +0 -60
  329. package/src/routes/api/upload-multipart.ts +0 -366
@@ -0,0 +1,11 @@
1
+ {
2
+ "format": "jant-site-snapshot",
3
+ "version": 2,
4
+ "dialect": "sqlite",
5
+ "jant": "0.8.0",
6
+ "schema": "0034_cheerful_rumiko_fujikawa",
7
+ "site": {
8
+ "id": "sit_01kn8jq3t4famtyg9hjd074ckr",
9
+ "key": "default"
10
+ }
11
+ }
@@ -0,0 +1,52 @@
1
+ /**
2
+ * Cursor Walk Helper
3
+ *
4
+ * Follows a paginated posts endpoint the way a client does, so route tests can
5
+ * compare a walk against one unpaged request.
6
+ */
7
+
8
+ import { expect } from "vitest";
9
+
10
+ interface RequestTarget {
11
+ request(path: string): Response | Promise<Response>;
12
+ }
13
+
14
+ /**
15
+ * Follow `nextCursor` from the first page until it is null, one request per
16
+ * page, and fail on any non-200 page or a walk that doesn't end.
17
+ *
18
+ * @param app - The test app the endpoint is mounted on
19
+ * @param path - Endpoint path with its query, without `limit` or `cursor`
20
+ * @param limit - Page size
21
+ * @param from - A `nextCursor` to resume from instead of the first page
22
+ * @returns Every post ID, in the order the pages returned them
23
+ * @example
24
+ * ```ts
25
+ * expect(await walkPostPages(app, "/api/public/archive", 1)).toEqual(ids);
26
+ * ```
27
+ */
28
+ export async function walkPostPages(
29
+ app: RequestTarget,
30
+ path: string,
31
+ limit: number,
32
+ from: string | null = null,
33
+ ): Promise<string[]> {
34
+ const separator = path.includes("?") ? "&" : "?";
35
+ const ids: string[] = [];
36
+ let cursor = from;
37
+ for (let page = 0; page < 100; page++) {
38
+ const query: string = cursor
39
+ ? `limit=${limit}&cursor=${encodeURIComponent(cursor)}`
40
+ : `limit=${limit}`;
41
+ const res = await app.request(`${path}${separator}${query}`);
42
+ expect(res.status).toBe(200);
43
+ const body = (await res.json()) as {
44
+ posts: Array<{ id: string }>;
45
+ nextCursor: string | null;
46
+ };
47
+ ids.push(...body.posts.map((post) => post.id));
48
+ if (body.nextCursor === null) return ids;
49
+ cursor = body.nextCursor;
50
+ }
51
+ throw new Error(`The walk of ${path} did not end`);
52
+ }
@@ -0,0 +1,97 @@
1
+ /**
2
+ * Import a Jant site export into a throwaway Node SQLite site, the way
3
+ * `mise run db-node-load-demo` does: migrate, set up, serve on a loopback
4
+ * port, and run `jant site import` against that server.
5
+ *
6
+ * Every request off the machine goes to a closed port, so the export has to
7
+ * import from its own files. The importer falls back to fetching a file from
8
+ * the exported site's URL; with the network up, that fallback hid icons it
9
+ * failed to find in the export.
10
+ */
11
+
12
+ import { spawnSync } from "node:child_process";
13
+ import { mkdtempSync, rmSync } from "node:fs";
14
+ import { tmpdir } from "node:os";
15
+ import { join, resolve } from "node:path";
16
+
17
+ const CORE_DIR = resolve(import.meta.dirname, "../../..");
18
+
19
+ export interface SiteExportImportResult {
20
+ /** SQLite file of the site the export went into. */
21
+ databasePath: string;
22
+ /** Exit status of the import script; `0` on success. */
23
+ status: number | null;
24
+ stdout: string;
25
+ /** stdout and stderr together, for failure messages. */
26
+ output: string;
27
+ /** Spawn error, when the script could not run at all. */
28
+ error: Error | undefined;
29
+ /** Remove the temporary site. */
30
+ cleanup: () => void;
31
+ }
32
+
33
+ /**
34
+ * Import an export directory into a new temporary site.
35
+ *
36
+ * @param exportDir - The export to import; the canonical demo export when omitted
37
+ * @returns The script's result and the database it wrote
38
+ * @example
39
+ * ```ts
40
+ * const result = importSiteExportIntoTempSite(fixtureDir);
41
+ * try {
42
+ * expect(result.status, result.output).toBe(0);
43
+ * } finally {
44
+ * result.cleanup();
45
+ * }
46
+ * ```
47
+ */
48
+ export function importSiteExportIntoTempSite(
49
+ exportDir?: string,
50
+ ): SiteExportImportResult {
51
+ const dir = mkdtempSync(join(tmpdir(), "jant-load-demo-"));
52
+ const databasePath = join(dir, "jant.sqlite");
53
+
54
+ const env: Record<string, string | undefined> = {
55
+ ...process.env,
56
+ JANT_ENV_FILE: "",
57
+ DATABASE_URL: `file:${databasePath}`,
58
+ DATA_DIR: dir,
59
+ LOCAL_STORAGE_PATH: join(dir, "media"),
60
+ STORAGE_DRIVER: "local",
61
+ // No announcement to a Discover directory from a test database.
62
+ DISCOVER_PING_URL: "",
63
+ NODE_USE_ENV_PROXY: "1",
64
+ HTTP_PROXY: "http://127.0.0.1:9",
65
+ HTTPS_PROXY: "http://127.0.0.1:9",
66
+ NO_PROXY: "127.0.0.1",
67
+ };
68
+ delete env.SITE_RESOLUTION_MODE;
69
+ for (const name of [
70
+ "http_proxy",
71
+ "https_proxy",
72
+ "no_proxy",
73
+ "all_proxy",
74
+ "ALL_PROXY",
75
+ ]) {
76
+ delete env[name];
77
+ }
78
+
79
+ const result = spawnSync(
80
+ process.execPath,
81
+ [
82
+ "dev/run-script.mjs",
83
+ "dev/scripts/import-node-demo-site-export.ts",
84
+ ...(exportDir ? ["--path", exportDir] : []),
85
+ ],
86
+ { cwd: CORE_DIR, encoding: "utf8", env, timeout: 120_000 },
87
+ );
88
+
89
+ return {
90
+ databasePath,
91
+ status: result.status,
92
+ stdout: result.stdout,
93
+ output: `${result.stdout}\n${result.stderr}`,
94
+ error: result.error,
95
+ cleanup: () => rmSync(dir, { recursive: true, force: true }),
96
+ };
97
+ }
@@ -12,17 +12,22 @@ import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
12
12
  import { tmpdir } from "node:os";
13
13
  import { join } from "node:path";
14
14
  import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
15
- import { __test__ } from "../../bin/commands/import-site.js";
15
+ import {
16
+ __test__,
17
+ SUPPORTED_SITE_EXPORT_VERSION,
18
+ } from "../../bin/commands/site/import.js";
16
19
  import {
17
20
  partitionEditableSettingUpdates,
18
21
  partitionImportableSettingUpdates,
19
22
  } from "../lib/api-settings.js";
20
23
  import { normalizeEditableSettingValue } from "../lib/schemas.js";
24
+ import { SITE_EXPORT_FORMAT_VERSION } from "../services/export.js";
21
25
  import type { ConfigKey } from "../types/config.js";
22
26
 
23
27
  const {
24
28
  walkHugoContent,
25
29
  loadSiteConfig,
30
+ checkSiteExportVersion,
26
31
  buildSettingsUpdatesFromConfig,
27
32
  splitSettingsUpdatesForImport,
28
33
  buildSiteAvatarImport,
@@ -70,6 +75,27 @@ describe("Hugo import CLI helpers", () => {
70
75
  await rm(tempDir, { recursive: true, force: true });
71
76
  });
72
77
 
78
+ it("reads the export format version the exporter writes", () => {
79
+ expect(SUPPORTED_SITE_EXPORT_VERSION).toBe(SITE_EXPORT_FORMAT_VERSION);
80
+ });
81
+
82
+ it("refuses an export in a newer format version, and accepts older or unversioned ones", async () => {
83
+ const withVersion = async (line: string) => {
84
+ await writeFileTree(tempDir, {
85
+ "data/jant.toml": `format = "jant-site"\n${line}site_name = "Test"\n`,
86
+ });
87
+ return checkSiteExportVersion(await loadSiteConfig(tempDir));
88
+ };
89
+
90
+ expect(
91
+ await withVersion(`version = ${SUPPORTED_SITE_EXPORT_VERSION + 1}\n`),
92
+ ).toMatch(/format version 2.*Upgrade @jant\/core/);
93
+ expect(
94
+ await withVersion(`version = ${SUPPORTED_SITE_EXPORT_VERSION}\n`),
95
+ ).toBeNull();
96
+ expect(await withVersion("")).toBeNull();
97
+ });
98
+
73
99
  it("walkHugoContent classifies root posts, replies, and collection bundles", async () => {
74
100
  await writeFileTree(tempDir, {
75
101
  "content/_index.md": "---\ntype: home\n---\n",
@@ -0,0 +1,136 @@
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). From 0.8.0 on, that release's published
8
+ * package writes both from the canonical demo content at its tag
9
+ * (`scripts/release/freeze-fixtures.mjs`). 0.7.0 and 0.7.1 are copies of the
10
+ * canonical directory at their tags, which earlier versions had written: a
11
+ * July site export and a snapshot without `jant` or `schema`. Fixtures are
12
+ * never edited afterwards.
13
+ *
14
+ * The canonical fixtures under `sites/demo-source/canonical/` are
15
+ * re-exported as the demo changes, so they only prove that head reads what
16
+ * head writes. These prove that head reads what every earlier release wrote,
17
+ * which is what "a backup from 1.x restores on a later 1.x" means. A migration
18
+ * that renames a column, or an importer change that drops an old field,
19
+ * fails here. docs/RELEASING.md adds a directory at each release.
20
+ */
21
+
22
+ import { readdirSync, readFileSync } from "node:fs";
23
+ import { 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
+ assertSnapshotMeta,
29
+ assertSnapshotSchemaInstalled,
30
+ buildReplaceSql,
31
+ getSnapshotBootstrapSite,
32
+ normalizeD1Sql,
33
+ rewriteSnapshotSiteIdentifiers,
34
+ upgradeSnapshotSql,
35
+ } from "../../bin/lib/site-snapshot.js";
36
+ import { DEFAULT_TEST_SITE_ID, createTestDatabase } from "./helpers/db.js";
37
+ import {
38
+ importSiteExportIntoTempSite,
39
+ type SiteExportImportResult,
40
+ } from "./helpers/site-export-import.js";
41
+
42
+ const RELEASES_DIR = resolve(import.meta.dirname, "fixtures/releases");
43
+ const RELEASES = readdirSync(RELEASES_DIR, { withFileTypes: true })
44
+ .filter((entry) => entry.isDirectory())
45
+ .map((entry) => entry.name)
46
+ .sort();
47
+
48
+ function count(sqlite: Database.Database, sql: string, ...params: unknown[]) {
49
+ return (sqlite.prepare(sql).get(...params) as { count: number }).count;
50
+ }
51
+
52
+ describe("release fixtures", () => {
53
+ it("has at least one release to check", () => {
54
+ expect(RELEASES.length).toBeGreaterThan(0);
55
+ });
56
+
57
+ for (const release of RELEASES) {
58
+ describe(release, () => {
59
+ const releaseDir = join(RELEASES_DIR, release);
60
+ const imports: SiteExportImportResult[] = [];
61
+
62
+ afterEach(() => {
63
+ for (const result of imports.splice(0)) result.cleanup();
64
+ });
65
+
66
+ it("restores its snapshot into a database migrated to head", () => {
67
+ const meta = JSON.parse(
68
+ readFileSync(join(releaseDir, "snapshot/meta.json"), "utf8"),
69
+ );
70
+ assertSnapshotMeta(meta);
71
+ assertSnapshotSchemaInstalled(meta);
72
+ const site = getSnapshotBootstrapSite(meta);
73
+ if (!site) throw new Error(`${release} snapshot names no site.`);
74
+
75
+ const sql = normalizeD1Sql(
76
+ rewriteSnapshotSiteIdentifiers(
77
+ upgradeSnapshotSql(
78
+ readFileSync(join(releaseDir, "snapshot/db.sql"), "utf8"),
79
+ meta.version,
80
+ ),
81
+ site.id,
82
+ DEFAULT_TEST_SITE_ID,
83
+ ),
84
+ );
85
+
86
+ const { sqlite } = createTestDatabase();
87
+ expect(() => {
88
+ sqlite.exec(buildReplaceSql(DEFAULT_TEST_SITE_ID));
89
+ sqlite.exec(sql);
90
+ }).not.toThrow();
91
+ expect(
92
+ count(
93
+ sqlite,
94
+ `SELECT COUNT(*) AS count FROM "post" WHERE "site_id" = ?`,
95
+ DEFAULT_TEST_SITE_ID,
96
+ ),
97
+ ).toBeGreaterThan(0);
98
+ });
99
+
100
+ it(
101
+ "imports its site export through `jant site import` at head",
102
+ { timeout: 150_000 },
103
+ async () => {
104
+ const exportDir = join(releaseDir, "site-export");
105
+ const result = importSiteExportIntoTempSite(exportDir);
106
+ imports.push(result);
107
+
108
+ expect(result.error).toBeUndefined();
109
+ expect(result.status, result.output).toBe(0);
110
+ expect(result.output).not.toMatch(/^Warning:/m);
111
+
112
+ const { rootBundles, collectionBundles } =
113
+ await importSite.walkHugoContent(exportDir);
114
+ const replyCount = rootBundles.reduce(
115
+ (sum: number, root: { children: unknown[] }) =>
116
+ sum + root.children.length,
117
+ 0,
118
+ );
119
+ expect(rootBundles.length).toBeGreaterThan(0);
120
+
121
+ const sqlite = new Database(result.databasePath, { readonly: true });
122
+ try {
123
+ expect(count(sqlite, `SELECT COUNT(*) AS count FROM "post"`)).toBe(
124
+ rootBundles.length + replyCount,
125
+ );
126
+ expect(
127
+ count(sqlite, `SELECT COUNT(*) AS count FROM "collection"`),
128
+ ).toBe(collectionBundles.length);
129
+ } finally {
130
+ sqlite.close();
131
+ }
132
+ },
133
+ );
134
+ });
135
+ }
136
+ });
@@ -19,13 +19,15 @@
19
19
  * hence the timeout.
20
20
  */
21
21
 
22
- import { spawnSync } from "node:child_process";
23
- import { mkdtempSync, readdirSync, rmSync } from "node:fs";
24
- import { tmpdir } from "node:os";
22
+ import { readdirSync } from "node:fs";
25
23
  import { basename, join, resolve } from "node:path";
26
24
  import Database from "better-sqlite3";
27
25
  import { afterEach, describe, expect, it } from "vitest";
28
- import { __test__ as importSite } from "../../bin/commands/import-site.js";
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";
29
31
 
30
32
  const CORE_DIR = resolve(import.meta.dirname, "../..");
31
33
  const CANONICAL_DIR = resolve(
@@ -38,57 +40,19 @@ function count(sqlite: Database.Database, sql: string): number {
38
40
  }
39
41
 
40
42
  describe("canonical demo site-export", () => {
41
- const tempDirs: string[] = [];
43
+ const imports: SiteExportImportResult[] = [];
42
44
 
43
45
  afterEach(() => {
44
- for (const dir of tempDirs.splice(0)) {
45
- rmSync(dir, { recursive: true, force: true });
46
- }
46
+ for (const result of imports.splice(0)) result.cleanup();
47
47
  });
48
48
 
49
49
  it(
50
50
  "imports through `jant site import` into a local Node database at head",
51
51
  { timeout: 150_000 },
52
52
  async () => {
53
- const dir = mkdtempSync(join(tmpdir(), "jant-load-demo-"));
54
- tempDirs.push(dir);
55
- const databasePath = join(dir, "jant.sqlite");
56
-
57
- const env: Record<string, string | undefined> = {
58
- ...process.env,
59
- JANT_ENV_FILE: "",
60
- DATABASE_URL: `file:${databasePath}`,
61
- DATA_DIR: dir,
62
- LOCAL_STORAGE_PATH: join(dir, "media"),
63
- STORAGE_DRIVER: "local",
64
- // No announcement to a Discover directory from a test database.
65
- DISCOVER_PING_URL: "",
66
- // Every request off this machine goes to a closed port, so the export
67
- // has to import from its own files. The importer falls back to
68
- // fetching a file from the exported site's URL; with the network up,
69
- // that fallback hid icons it failed to find in the export.
70
- NODE_USE_ENV_PROXY: "1",
71
- HTTP_PROXY: "http://127.0.0.1:9",
72
- HTTPS_PROXY: "http://127.0.0.1:9",
73
- NO_PROXY: "127.0.0.1",
74
- };
75
- delete env.SITE_RESOLUTION_MODE;
76
- for (const name of [
77
- "http_proxy",
78
- "https_proxy",
79
- "no_proxy",
80
- "all_proxy",
81
- "ALL_PROXY",
82
- ]) {
83
- delete env[name];
84
- }
85
-
86
- const result = spawnSync(
87
- process.execPath,
88
- ["dev/run-script.mjs", "dev/scripts/import-node-demo-site-export.ts"],
89
- { cwd: CORE_DIR, encoding: "utf8", env, timeout: 120_000 },
90
- );
91
- const output = `${result.stdout}\n${result.stderr}`;
53
+ const result = importSiteExportIntoTempSite();
54
+ imports.push(result);
55
+ const { databasePath, output } = result;
92
56
 
93
57
  expect(result.error).toBeUndefined();
94
58
  expect(result.status, output).toBe(0);
@@ -0,0 +1,109 @@
1
+ /**
2
+ * The theming docs name only hooks the markup and stylesheets provide.
3
+ *
4
+ * `docs/theming.md` is the public theme contract: the CSS variables it lists,
5
+ * the `data-*` attributes and their values, and the footnote classes. The
6
+ * rest of the roughly 270 custom properties are internal. `--site-width`
7
+ * stayed documented after it was removed, and `data-page="subscribe"` shipped
8
+ * without being documented; these checks fail on both kinds of drift.
9
+ */
10
+
11
+ import { readdirSync, readFileSync } from "node:fs";
12
+ import { join, resolve } from "node:path";
13
+ import { describe, expect, it } from "vitest";
14
+
15
+ const CORE_DIR = resolve(import.meta.dirname, "../..");
16
+ const REPO_ROOT = resolve(CORE_DIR, "../..");
17
+ const SRC_DIR = join(CORE_DIR, "src");
18
+ const THEMING_DOCS = ["docs/theming.md", "docs/zh-Hans/theming.md"];
19
+
20
+ /** `data-page` values of author-only and internal pages, left out of the docs. */
21
+ const UNDOCUMENTED_PAGES = new Set(["compose", "brand", "theme-sample"]);
22
+
23
+ function listSourceFiles(dir: string, extensions: string[]): string[] {
24
+ return readdirSync(dir, { withFileTypes: true }).flatMap((entry) => {
25
+ const fullPath = join(dir, entry.name);
26
+ if (entry.isDirectory()) {
27
+ return entry.name === "__tests__" || entry.name === "i18n"
28
+ ? []
29
+ : listSourceFiles(fullPath, extensions);
30
+ }
31
+ return extensions.some((extension) => entry.name.endsWith(extension))
32
+ ? [fullPath]
33
+ : [];
34
+ });
35
+ }
36
+
37
+ const stylesheets = listSourceFiles(SRC_DIR, [".css"])
38
+ .map((path) => readFileSync(path, "utf8"))
39
+ .join("\n");
40
+ const markup = listSourceFiles(SRC_DIR, [".tsx", ".ts"])
41
+ .map((path) => readFileSync(path, "utf8"))
42
+ .join("\n");
43
+
44
+ const definedVariables = new Set(
45
+ [...stylesheets.matchAll(/(--[a-z][a-z0-9-]*)\s*:/g)].flatMap((match) =>
46
+ match[1] ? [match[1]] : [],
47
+ ),
48
+ );
49
+ const emittedPages = new Set(
50
+ [
51
+ ...markup.matchAll(/data-page="([a-z-]+)"/g),
52
+ ...markup.matchAll(/"data-page": "([a-z-]+)"/g),
53
+ ].flatMap((match) => (match[1] ? [match[1]] : [])),
54
+ );
55
+
56
+ function readRepoFile(path: string): string {
57
+ return readFileSync(join(REPO_ROOT, path), "utf8");
58
+ }
59
+
60
+ /** Variables in the first cell of the docs' tables, e.g. `| `--site-accent` | … |`. */
61
+ function readDocumentedVariables(markdown: string): string[] {
62
+ return [...markdown.matchAll(/^\| `(--[a-z][a-z0-9-]*)`/gm)].flatMap(
63
+ (match) => (match[1] ? [match[1]] : []),
64
+ );
65
+ }
66
+
67
+ function readDocumentedAttributes(markdown: string): string[] {
68
+ return [...markdown.matchAll(/`(data-[a-z][a-z-]*)`/g)].flatMap((match) =>
69
+ match[1] ? [match[1]] : [],
70
+ );
71
+ }
72
+
73
+ function readDocumentedPages(markdown: string): string[] {
74
+ const row = markdown
75
+ .split("\n")
76
+ .find((line) => line.startsWith("| `data-page`"));
77
+ const values = row?.split("|")[3] ?? "";
78
+ return [...values.matchAll(/`([a-z-]+)`/g)].flatMap((match) =>
79
+ match[1] ? [match[1]] : [],
80
+ );
81
+ }
82
+
83
+ describe("theming docs", () => {
84
+ for (const path of THEMING_DOCS) {
85
+ it(`${path} lists only variables the stylesheets define`, () => {
86
+ const markdown = readRepoFile(path);
87
+ const documented = readDocumentedVariables(markdown);
88
+ expect(documented.length).toBeGreaterThan(0);
89
+ expect(documented.filter((name) => !definedVariables.has(name))).toEqual(
90
+ [],
91
+ );
92
+ });
93
+
94
+ it(`${path} lists only data attributes the markup emits`, () => {
95
+ const documented = readDocumentedAttributes(readRepoFile(path));
96
+ expect(documented.length).toBeGreaterThan(0);
97
+ expect(documented.filter((name) => !markup.includes(name))).toEqual([]);
98
+ });
99
+
100
+ it(`${path} lists exactly the reader pages' data-page values`, () => {
101
+ const readerPages = [...emittedPages]
102
+ .filter((page) => !UNDOCUMENTED_PAGES.has(page))
103
+ .sort();
104
+ expect(readDocumentedPages(readRepoFile(path)).sort()).toEqual(
105
+ readerPages,
106
+ );
107
+ });
108
+ }
109
+ });
package/src/app.tsx CHANGED
@@ -43,7 +43,6 @@ import { smartCollectionsApiRoutes } from "./routes/api/smart-collections.js";
43
43
  import { settingsApiRoutes } from "./routes/api/settings.js";
44
44
  import { uploadApiRoutes } from "./routes/api/upload.js";
45
45
  import { uploadsApiRoutes } from "./routes/api/uploads.js";
46
- import { multipartUploadApiRoutes } from "./routes/api/upload-multipart.js";
47
46
  import { searchApiRoutes } from "./routes/api/search.js";
48
47
  import { mcpApiRoutes } from "./routes/api/mcp.js";
49
48
  import { customUrlsApiRoutes } from "./routes/api/custom-urls.js";
@@ -56,7 +55,6 @@ import {
56
55
  githubSyncAdminRoutes,
57
56
  } from "./routes/api/github-sync.js";
58
57
  import { telegramWebhookRoutes } from "./routes/api/telegram.js";
59
- import { internalTextAttachmentsRoutes } from "./routes/api/internal/text-attachments.js";
60
58
  import { internalSearchReindexRoutes } from "./routes/api/internal/search-reindex.js";
61
59
  import { internalPostBodyHtmlRoutes } from "./routes/api/internal/post-body-html.js";
62
60
  import { internalUploadsRoutes } from "./routes/api/internal/uploads.js";
@@ -399,7 +397,6 @@ export function createApp(): App {
399
397
  app.route("/api/attachments", attachmentsApiRoutes);
400
398
  app.route("/api/internal/api-tokens", internalApiTokensRoutes);
401
399
  app.route("/api/internal/sites", internalSitesRoutes);
402
- app.route("/api/internal/text-attachments", internalTextAttachmentsRoutes);
403
400
  app.route("/api/internal/search/reindex", internalSearchReindexRoutes);
404
401
  app.route("/api/internal/posts/body-html", internalPostBodyHtmlRoutes);
405
402
  app.route("/api/internal/uploads", internalUploadsRoutes);
@@ -607,8 +604,7 @@ export function createApp(): App {
607
604
  app.route("/settings/custom-urls", customUrlsRoutes);
608
605
  app.route("/settings", settingsRoutes);
609
606
 
610
- // Protected API routes (multipart must be registered before base upload)
611
- app.route("/api/upload/multipart", multipartUploadApiRoutes);
607
+ // Protected API routes
612
608
  app.route("/api/upload", uploadApiRoutes);
613
609
  app.route("/api/uploads", uploadsApiRoutes);
614
610
  app.route("/api/search", searchApiRoutes);
@@ -0,0 +1,55 @@
1
+ {
2
+ "name": "pg-demo-current",
3
+ "baseMigrationTag": "0032_furry_multiple_man",
4
+ "seedPath": "./pg-demo-current.sql",
5
+ "assertions": [
6
+ {
7
+ "name": "posts survive",
8
+ "sql": "SELECT COUNT(*) AS count FROM post",
9
+ "column": "count",
10
+ "equals": 43
11
+ },
12
+ {
13
+ "name": "collections survive",
14
+ "sql": "SELECT COUNT(*) AS count FROM collection",
15
+ "column": "count",
16
+ "equals": 6
17
+ },
18
+ {
19
+ "name": "thread collection memberships survive",
20
+ "sql": "SELECT COUNT(*) AS count FROM thread_collection",
21
+ "column": "count",
22
+ "equals": 44
23
+ },
24
+ {
25
+ "name": "navigation survives",
26
+ "sql": "SELECT COUNT(*) AS count FROM nav_item",
27
+ "column": "count",
28
+ "equals": 5
29
+ },
30
+ {
31
+ "name": "paths survive",
32
+ "sql": "SELECT COUNT(*) AS count FROM path_registry",
33
+ "column": "count",
34
+ "equals": 49
35
+ },
36
+ {
37
+ "name": "media survives",
38
+ "sql": "SELECT COUNT(*) AS count FROM media",
39
+ "column": "count",
40
+ "equals": 10
41
+ },
42
+ {
43
+ "name": "every post's thread root exists",
44
+ "sql": "SELECT COUNT(*) AS count FROM post p LEFT JOIN post root ON root.site_id = p.site_id AND root.id = p.thread_id WHERE root.id IS NULL",
45
+ "column": "count",
46
+ "equals": 0
47
+ },
48
+ {
49
+ "name": "thread collection targets are roots",
50
+ "sql": "SELECT COUNT(*) AS count FROM thread_collection tc INNER JOIN post root ON root.site_id = tc.site_id AND root.id = tc.thread_id WHERE root.reply_to_id IS NOT NULL OR root.thread_id <> root.id",
51
+ "column": "count",
52
+ "equals": 0
53
+ }
54
+ ]
55
+ }