@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
@@ -12,6 +12,7 @@ import { deleteR2Object, uploadR2Object } from "../../../lib/r2-query.js";
12
12
  import {
13
13
  assertSnapshotDialectMatches,
14
14
  assertSnapshotMeta,
15
+ assertSnapshotSchemaInstalled,
15
16
  buildMediaProviderSql,
16
17
  DEFER_FOREIGN_KEYS_SQL,
17
18
  buildReplaceSql,
@@ -273,6 +274,7 @@ export async function run(argv) {
273
274
  try {
274
275
  const meta = await readSnapshotJson(materialized.rootDir, "meta.json");
275
276
  assertSnapshotMeta(meta);
277
+ assertSnapshotSchemaInstalled(meta);
276
278
  assertSnapshotDialectMatches(meta, context.dialect);
277
279
  const explicitRemap = values["remap-site"] === true;
278
280
  const snapshotSite = getSnapshotBootstrapSite(meta);
@@ -1,5 +1,7 @@
1
1
  import { parseArgs } from "node:util";
2
2
  import { autoloadNodeEnv } from "../../lib/node-env.js";
3
+ import { findRenamedOption } from "../../lib/renamed-arguments.js";
4
+ import { resolveSiteUrl } from "../../lib/site-url.js";
3
5
 
4
6
  const TELEGRAM_API_BASE = "https://api.telegram.org";
5
7
 
@@ -16,40 +18,63 @@ async function callTelegram(token, method, body) {
16
18
  return payload.result;
17
19
  }
18
20
 
21
+ function printUsage() {
22
+ console.log("Usage: jant telegram register-webhooks [--url <url>]");
23
+ console.log("");
24
+ console.log(
25
+ "Registers a webhook for every bot in TELEGRAM_BOT_TOKENS, pointing at",
26
+ );
27
+ console.log("<url>/api/telegram/webhook/<bot_id> with the shared");
28
+ console.log("TELEGRAM_WEBHOOK_SECRET. Run once after configuring the pool.");
29
+ console.log("");
30
+ console.log("Options:");
31
+ console.log(" --url The site's public URL");
32
+ console.log("");
33
+ console.log(
34
+ "If --url is omitted, uses SITE_ORIGIN + SITE_PATH_PREFIX from the environment.",
35
+ );
36
+ console.log("");
37
+ console.log("Environment (also read from .env.node):");
38
+ console.log(
39
+ " TELEGRAM_BOT_TOKENS Comma-separated <bot_id>:<secret> tokens",
40
+ );
41
+ console.log(
42
+ " TELEGRAM_WEBHOOK_SECRET Shared secret_token for the webhooks",
43
+ );
44
+ }
45
+
19
46
  export async function run(argv) {
47
+ const renamed = findRenamedOption("telegram register-webhooks", argv, {
48
+ "--base-url": "--url",
49
+ });
50
+ if (renamed) {
51
+ console.error(`Error: ${renamed}`);
52
+ process.exit(1);
53
+ }
54
+
20
55
  const { values } = parseArgs({
21
56
  args: argv,
22
57
  options: {
23
- "base-url": { type: "string" },
58
+ url: { type: "string" },
24
59
  help: { type: "boolean", short: "h" },
25
60
  },
26
61
  });
27
62
 
28
- if (values.help || !values["base-url"]) {
29
- console.log(
30
- "Usage: jant telegram register-webhooks --base-url <public-url>",
31
- );
32
- console.log("");
33
- console.log(
34
- "Registers a webhook for every bot in TELEGRAM_BOT_TOKENS, pointing at",
35
- );
36
- console.log("<base-url>/api/telegram/webhook/<bot_id> with the shared");
37
- console.log(
38
- "TELEGRAM_WEBHOOK_SECRET. Run once after configuring the pool.",
39
- );
40
- console.log("");
41
- console.log("Environment (also read from .env.node):");
42
- console.log(
43
- " TELEGRAM_BOT_TOKENS Comma-separated <bot_id>:<secret> tokens",
44
- );
45
- console.log(
46
- " TELEGRAM_WEBHOOK_SECRET Shared secret_token for the webhooks",
47
- );
48
- process.exit(values.help ? 0 : 1);
63
+ if (values.help) {
64
+ printUsage();
65
+ process.exit(0);
49
66
  }
50
67
 
51
68
  autoloadNodeEnv();
52
69
 
70
+ const siteUrl = resolveSiteUrl({ url: values.url });
71
+ if (!siteUrl) {
72
+ console.error(
73
+ "Error: telegram register-webhooks requires --url or SITE_ORIGIN in the environment.",
74
+ );
75
+ process.exit(1);
76
+ }
77
+
53
78
  const rawTokens = process.env.TELEGRAM_BOT_TOKENS ?? "";
54
79
  const secret = process.env.TELEGRAM_WEBHOOK_SECRET ?? "";
55
80
  if (!rawTokens.trim()) {
@@ -61,7 +86,7 @@ export async function run(argv) {
61
86
  process.exit(1);
62
87
  }
63
88
 
64
- const baseUrl = values["base-url"].replace(/\/+$/, "");
89
+ const baseUrl = siteUrl.replace(/\/+$/, "");
65
90
  const tokens = rawTokens
66
91
  .split(",")
67
92
  .map((entry) => entry.trim())
package/bin/jant.js CHANGED
@@ -2,7 +2,8 @@
2
2
 
3
3
  import { readdir } from "node:fs/promises";
4
4
  import { fileURLToPath } from "node:url";
5
- import { dirname, join, basename, relative } from "node:path";
5
+ import { dirname, join, relative } from "node:path";
6
+ import { PUBLIC_COMMAND_GROUPS } from "./lib/command-registry.js";
6
7
 
7
8
  const __dirname = dirname(fileURLToPath(import.meta.url));
8
9
  const commandsDir = join(__dirname, "commands");
@@ -32,15 +33,19 @@ async function listCommands() {
32
33
  return commands;
33
34
  }
34
35
 
35
- async function showHelp() {
36
- const commands = await listCommands();
36
+ function showHelp() {
37
+ const width = Math.max(
38
+ ...PUBLIC_COMMAND_GROUPS.flatMap((group) =>
39
+ group.commands.map((command) => command.name.length),
40
+ ),
41
+ );
37
42
  console.log("Usage: jant <command> [options]");
38
- console.log("");
39
- console.log("Commands:");
40
- for (const cmd of commands
41
- .map((segments) => segments.join(" "))
42
- .sort((a, b) => a.localeCompare(b))) {
43
- console.log(` ${cmd}`);
43
+ for (const group of PUBLIC_COMMAND_GROUPS) {
44
+ console.log("");
45
+ console.log(`${group.title}:`);
46
+ for (const command of group.commands) {
47
+ console.log(` ${command.name.padEnd(width)} ${command.summary}`);
48
+ }
44
49
  }
45
50
  console.log("");
46
51
  console.log("Run 'jant <command> --help' for command-specific help.");
@@ -49,7 +54,7 @@ async function showHelp() {
49
54
  const argv = process.argv.slice(2);
50
55
  const commandStart = argv.findIndex((arg) => !arg.startsWith("-"));
51
56
  if (commandStart === -1) {
52
- await showHelp();
57
+ showHelp();
53
58
  process.exit(0);
54
59
  }
55
60
 
@@ -80,7 +85,7 @@ for (let length = positionalTail.length; length >= 1; length -= 1) {
80
85
  if (!matched) {
81
86
  console.error(`Unknown command: ${positionalTail[0]}`);
82
87
  console.error("");
83
- await showHelp();
88
+ showHelp();
84
89
  process.exit(1);
85
90
  }
86
91
 
@@ -0,0 +1,120 @@
1
+ /**
2
+ * Every `jant` command, classified.
3
+ *
4
+ * Public commands are part of Jant's compatibility promise: their names,
5
+ * options, and behavior change only in a major release, and `docs/cli.md`
6
+ * documents each one. Internal commands are build and operations tooling for
7
+ * the Jant repository and the hosted service. They still run, but help leaves
8
+ * them out and they can change in any release.
9
+ *
10
+ * `src/__tests__/cli-commands.test.ts` fails when a file under
11
+ * `bin/commands/` is in neither list, so a new command has to be classified
12
+ * before it ships.
13
+ */
14
+
15
+ /**
16
+ * @typedef {object} PublicCommand
17
+ * @property {string} name Space-separated command path, e.g. `site export`
18
+ * @property {string} summary One-line description shown by `jant --help`
19
+ */
20
+
21
+ /**
22
+ * @typedef {object} PublicCommandGroup
23
+ * @property {string} title Group heading shown by `jant --help`
24
+ * @property {PublicCommand[]} commands Commands in display order
25
+ */
26
+
27
+ /** @type {PublicCommandGroup[]} */
28
+ export const PUBLIC_COMMAND_GROUPS = [
29
+ {
30
+ title: "Set up and run",
31
+ commands: [
32
+ {
33
+ name: "setup",
34
+ summary: "Create the owner account and site without a browser",
35
+ },
36
+ { name: "start", summary: "Start the Node.js server" },
37
+ {
38
+ name: "migrate",
39
+ summary: "Apply database migrations and data backfills",
40
+ },
41
+ {
42
+ name: "deploy",
43
+ summary: "Apply remote migrations and deploy to Cloudflare Workers",
44
+ },
45
+ {
46
+ name: "reset-password",
47
+ summary: "Generate a password reset token",
48
+ },
49
+ ],
50
+ },
51
+ {
52
+ title: "Move and back up content",
53
+ commands: [
54
+ {
55
+ name: "site export",
56
+ summary: "Export a site as a Hugo site, as a ZIP or a directory",
57
+ },
58
+ { name: "site import", summary: "Import a Hugo site export into a site" },
59
+ {
60
+ name: "site pull-media",
61
+ summary: "Download the media a site export refers to",
62
+ },
63
+ {
64
+ name: "site snapshot export",
65
+ summary: "Export a snapshot that keeps IDs, storage keys, and files",
66
+ },
67
+ {
68
+ name: "site snapshot import",
69
+ summary: "Restore a snapshot into a site",
70
+ },
71
+ { name: "db export", summary: "Export the database to a SQL file" },
72
+ ],
73
+ },
74
+ {
75
+ title: "Maintenance",
76
+ commands: [
77
+ { name: "search reindex", summary: "Rebuild the search index" },
78
+ {
79
+ name: "posts rebuild-html",
80
+ summary: "Rebuild stored post HTML at the current format",
81
+ },
82
+ {
83
+ name: "uploads cleanup",
84
+ summary: "Clear expired uploads and purge deleted media",
85
+ },
86
+ {
87
+ name: "telegram register-webhooks",
88
+ summary: "Register the webhooks of the Telegram bots",
89
+ },
90
+ ],
91
+ },
92
+ ];
93
+
94
+ /**
95
+ * Build and operations tooling, left out of help and out of the
96
+ * compatibility promise.
97
+ *
98
+ * @type {string[]}
99
+ */
100
+ export const INTERNAL_COMMANDS = [
101
+ "assets prepare",
102
+ "assets upload",
103
+ "db execute-file",
104
+ "db rehearse",
105
+ ];
106
+
107
+ /**
108
+ * Names of all public commands, in display order.
109
+ *
110
+ * @returns {string[]} Space-separated command paths
111
+ * @example
112
+ * ```js
113
+ * listPublicCommandNames(); // ["setup", "start", …, "telegram register-webhooks"]
114
+ * ```
115
+ */
116
+ export function listPublicCommandNames() {
117
+ return PUBLIC_COMMAND_GROUPS.flatMap((group) =>
118
+ group.commands.map((command) => command.name),
119
+ );
120
+ }
@@ -19,6 +19,25 @@ export function resolveBundledBackfillsDir(moduleUrl = import.meta.url) {
19
19
  return join(resolveBundledDbDir(moduleUrl), "backfills");
20
20
  }
21
21
 
22
+ /**
23
+ * Directory of the schema migrations this package ships for a dialect.
24
+ *
25
+ * @param {"sqlite" | "pg"} dialect SQLite (D1 and Node) or Postgres
26
+ * @param {string} [moduleUrl] Module URL the package root is resolved from
27
+ * @returns {string} Absolute path of the migrations directory
28
+ * @example
29
+ * ```js
30
+ * resolveBundledSchemaMigrationsDir("pg"); // ".../src/db/migrations/pg"
31
+ * ```
32
+ */
33
+ export function resolveBundledSchemaMigrationsDir(
34
+ dialect,
35
+ moduleUrl = import.meta.url,
36
+ ) {
37
+ const dir = join(resolveBundledDbDir(moduleUrl), "migrations");
38
+ return dialect === "pg" ? join(dir, "pg") : dir;
39
+ }
40
+
22
41
  export function extractNumberPrefix(name) {
23
42
  const match = String(name).match(/^(\d+)/);
24
43
  return match ? match[1] : null;
@@ -0,0 +1,56 @@
1
+ /**
2
+ * Answer the argument forms that 0.8.0 renamed with their replacement.
3
+ *
4
+ * `parseArgs` would report an old option as a bare "Unknown option", and an
5
+ * old positional site URL as an unexpected argument. These helpers name the
6
+ * form to use instead, so a script written for 0.7 fails with the fix in the
7
+ * message.
8
+ */
9
+
10
+ /**
11
+ * Find the first option in `argv` that was renamed.
12
+ *
13
+ * @param {string} command Command path, e.g. `site export`
14
+ * @param {string[]} argv Arguments after the command path
15
+ * @param {Record<string, string>} renamed Old option (`--directory`, `-d`) → what to pass instead
16
+ * @returns {string | null} An error message, or null when no renamed option is used
17
+ * @example
18
+ * ```js
19
+ * findRenamedOption("deploy", ["--site-path-prefix", "/blog"], {
20
+ * "--site-path-prefix": "--path-prefix",
21
+ * });
22
+ * // "jant deploy no longer takes --site-path-prefix. Use --path-prefix."
23
+ * ```
24
+ */
25
+ export function findRenamedOption(command, argv, renamed) {
26
+ for (const arg of argv) {
27
+ if (arg === "--") break;
28
+ if (!arg.startsWith("-")) continue;
29
+ const option = arg.split("=")[0];
30
+ if (Object.hasOwn(renamed, option)) {
31
+ return `jant ${command} no longer takes ${option}. Use ${renamed[option]}.`;
32
+ }
33
+ }
34
+ return null;
35
+ }
36
+
37
+ /**
38
+ * Describe a positional site URL, which `--url` replaced.
39
+ *
40
+ * @param {string} command Command path, e.g. `site import`
41
+ * @param {string[]} positionals Positional arguments `parseArgs` collected
42
+ * @returns {string | null} An error message, or null when there are none
43
+ * @example
44
+ * ```js
45
+ * findPositionalUrl("site export", ["https://example.com"]);
46
+ * // "jant site export takes the site as --url. Run: jant site export --url https://example.com"
47
+ * ```
48
+ */
49
+ export function findPositionalUrl(command, positionals) {
50
+ if (positionals.length === 0) return null;
51
+ const [first] = positionals;
52
+ if (/^https?:\/\//i.test(first)) {
53
+ return `jant ${command} takes the site as --url. Run: jant ${command} --url ${first}`;
54
+ }
55
+ return `jant ${command} takes no positional arguments: ${positionals.join(" ")}`;
56
+ }
@@ -1,5 +1,10 @@
1
+ import { readFileSync } from "node:fs";
1
2
  import { readdir } from "node:fs/promises";
2
3
  import { join, relative } from "node:path";
4
+ import {
5
+ listSchemaMigrationFiles,
6
+ resolveBundledSchemaMigrationsDir,
7
+ } from "./migration-artifacts.js";
3
8
 
4
9
  export const SNAPSHOT_FORMAT = "jant-site-snapshot";
5
10
  export const SNAPSHOT_VERSION = 2;
@@ -346,6 +351,43 @@ export function snapshotObjectPath(key) {
346
351
 
347
352
  export const SNAPSHOT_DIALECTS = ["sqlite", "pg"];
348
353
 
354
+ /**
355
+ * Version of the installed `@jant/core`, which a snapshot records as `jant`.
356
+ *
357
+ * @returns {string} The package version, e.g. `0.8.0`
358
+ */
359
+ export function readInstalledJantVersion() {
360
+ const packageJson = JSON.parse(
361
+ readFileSync(new URL("../../package.json", import.meta.url), "utf8"),
362
+ );
363
+ return String(packageJson.version);
364
+ }
365
+
366
+ /**
367
+ * Schema migrations the installed `@jant/core` ships for a dialect, oldest
368
+ * first.
369
+ *
370
+ * @param {"sqlite" | "pg"} dialect Snapshot dialect
371
+ * @returns {string[]} Migration tags, e.g. `0034_cheerful_rumiko_fujikawa`
372
+ */
373
+ export function listInstalledSchemaTags(dialect) {
374
+ return listSchemaMigrationFiles(
375
+ resolveBundledSchemaMigrationsDir(dialect),
376
+ ).map((migration) => migration.tag);
377
+ }
378
+
379
+ /**
380
+ * Build a snapshot's `meta.json`.
381
+ *
382
+ * Besides the format, it records the `@jant/core` version that wrote the
383
+ * snapshot (`jant`) and, when the dialect is known, the last schema migration
384
+ * that version ships (`schema`). The CLI that exports is the one the site
385
+ * runs and migrates with, so `schema` is the schema the rows were read from.
386
+ *
387
+ * @param {{ id: string, key: string }} site The exported site
388
+ * @param {{ dialect?: "sqlite" | "pg" }} [options] Source database dialect
389
+ * @returns {SnapshotMeta} The object to write as `meta.json`
390
+ */
349
391
  export function buildSnapshotMeta(site, options = {}) {
350
392
  const dialect = options.dialect;
351
393
  if (dialect && !SNAPSHOT_DIALECTS.includes(dialect)) {
@@ -354,10 +396,14 @@ export function buildSnapshotMeta(site, options = {}) {
354
396
  );
355
397
  }
356
398
 
399
+ const schema = dialect ? listInstalledSchemaTags(dialect).at(-1) : undefined;
400
+
357
401
  return {
358
402
  format: SNAPSHOT_FORMAT,
359
403
  version: SNAPSHOT_VERSION,
360
404
  ...(dialect ? { dialect } : {}),
405
+ jant: readInstalledJantVersion(),
406
+ ...(schema ? { schema } : {}),
361
407
  site: {
362
408
  id: site.id,
363
409
  key: site.key,
@@ -372,6 +418,10 @@ export function buildSnapshotMeta(site, options = {}) {
372
418
  * @property {typeof SNAPSHOT_FORMAT} format
373
419
  * @property {number} version One of `SUPPORTED_SNAPSHOT_VERSIONS`
374
420
  * @property {"sqlite" | "pg"} [dialect] Absent from snapshots that predate it
421
+ * @property {string} [jant] The `@jant/core` version that wrote the snapshot;
422
+ * absent before 0.8.0
423
+ * @property {string} [schema] The last schema migration of that version, for
424
+ * `dialect`; absent before 0.8.0
375
425
  * @property {{ id: string, key: string }} [site] The site the snapshot was
376
426
  * exported from; absent from legacy snapshots
377
427
  * @property {unknown} [tables] Listed by legacy snapshots only
@@ -419,6 +469,38 @@ export function assertSnapshotMeta(meta) {
419
469
  ) {
420
470
  throw new Error("Snapshot meta site must contain string id and key.");
421
471
  }
472
+
473
+ for (const field of ["jant", "schema"]) {
474
+ if (meta[field] !== undefined && typeof meta[field] !== "string") {
475
+ throw new Error(`Snapshot meta ${field} must be a string.`);
476
+ }
477
+ }
478
+ }
479
+
480
+ /**
481
+ * Refuse a snapshot written by a newer Jant than the installed one.
482
+ *
483
+ * A snapshot's rows fit the schema it records. When the installed
484
+ * `@jant/core` does not ship that migration, its schema is older than the
485
+ * snapshot's, and the rows can name columns it doesn't have. Snapshots from
486
+ * before 0.8.0 record no schema and are accepted.
487
+ *
488
+ * @param {SnapshotMeta} meta Checked by `assertSnapshotMeta`
489
+ * @returns {void}
490
+ * @throws {Error} When the installed package lacks the snapshot's schema
491
+ * @example
492
+ * assertSnapshotSchemaInstalled({ format: "jant-site-snapshot", version: 2, schema: "9999_later" });
493
+ * // throws: This snapshot was written by a newer Jant …
494
+ */
495
+ export function assertSnapshotSchemaInstalled(meta) {
496
+ if (typeof meta.schema !== "string") return;
497
+ const dialect = meta.dialect ?? "sqlite";
498
+ if (listInstalledSchemaTags(dialect).includes(meta.schema)) return;
499
+
500
+ const writer = meta.jant ? `Jant ${meta.jant}` : "a newer Jant";
501
+ throw new Error(
502
+ `This snapshot was written by ${writer}, whose schema reaches ${meta.schema}. The installed @jant/core (${readInstalledJantVersion()}) doesn't have that migration. Upgrade @jant/core, run jant migrate, then import again.`,
503
+ );
422
504
  }
423
505
 
424
506
  /**
@@ -451,7 +533,7 @@ export function assertSnapshotDialectMatches(meta, targetDialect) {
451
533
  `Snapshot dialect mismatch: source is ${sourceDialect}, target is ${targetDialect}.`,
452
534
  "Snapshot db.sql is dialect-specific (BLOB literals, generated columns, FTS, etc.)",
453
535
  "and cannot be replayed across SQLite and Postgres safely.",
454
- "Use `jant site export <url>` (HTTP, dialect-neutral) to move content between",
536
+ "Use `jant site export --url <url>` (HTTP, dialect-neutral) to move content between",
455
537
  "different DB engines.",
456
538
  ].join("\n"),
457
539
  );