@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
@@ -1,7 +1,10 @@
1
1
  import { describe, expect, it } from "vitest";
2
+ import { readFileSync } from "node:fs";
2
3
  import {
3
4
  assertSnapshotDialectMatches,
4
5
  assertSnapshotMeta,
6
+ assertSnapshotSchemaInstalled,
7
+ listInstalledSchemaTags,
5
8
  buildMediaProviderSql,
6
9
  buildSnapshotMeta,
7
10
  getSnapshotDialect,
@@ -32,6 +35,67 @@ describe("buildSnapshotMeta", () => {
32
35
  });
33
36
  });
34
37
 
38
+ describe("snapshot schema", () => {
39
+ const packageVersion = JSON.parse(
40
+ readFileSync(new URL("../../../package.json", import.meta.url), "utf8"),
41
+ ).version;
42
+
43
+ it("records the writing version and its last migration per dialect", () => {
44
+ for (const dialect of ["sqlite", "pg"] as const) {
45
+ const meta = buildSnapshotMeta(SITE, { dialect });
46
+ expect(meta.jant).toBe(packageVersion);
47
+ expect(meta.schema).toBe(listInstalledSchemaTags(dialect).at(-1));
48
+ }
49
+ });
50
+
51
+ it("accepts a snapshot whose schema the installed package ships", () => {
52
+ const meta = buildSnapshotMeta(SITE, { dialect: "pg" });
53
+ expect(() => assertSnapshotSchemaInstalled(meta)).not.toThrow();
54
+ const older = {
55
+ ...meta,
56
+ schema: listInstalledSchemaTags("pg")[0],
57
+ };
58
+ expect(() => assertSnapshotSchemaInstalled(older)).not.toThrow();
59
+ });
60
+
61
+ it("accepts a snapshot from before the schema was recorded", () => {
62
+ const {
63
+ schema: _schema,
64
+ jant: _jant,
65
+ ...legacy
66
+ } = buildSnapshotMeta(SITE, { dialect: "sqlite" });
67
+ expect(() => assertSnapshotSchemaInstalled(legacy)).not.toThrow();
68
+ });
69
+
70
+ it("refuses a snapshot from a newer schema, naming the fix", () => {
71
+ const meta = {
72
+ ...buildSnapshotMeta(SITE, { dialect: "sqlite" }),
73
+ jant: "9.0.0",
74
+ schema: "9999_later_change",
75
+ };
76
+ expect(() => assertSnapshotSchemaInstalled(meta)).toThrow(
77
+ /Jant 9\.0\.0.*9999_later_change.*Upgrade @jant\/core/,
78
+ );
79
+ });
80
+
81
+ it("checks a snapshot against its own dialect's migrations", () => {
82
+ const sqliteTag = listInstalledSchemaTags("sqlite").at(-1);
83
+ const pgTags = listInstalledSchemaTags("pg");
84
+ expect(pgTags).not.toContain(sqliteTag);
85
+ const meta = {
86
+ ...buildSnapshotMeta(SITE, { dialect: "pg" }),
87
+ schema: sqliteTag,
88
+ };
89
+ expect(() => assertSnapshotSchemaInstalled(meta)).toThrow();
90
+ });
91
+
92
+ it("rejects a non-string jant or schema field", () => {
93
+ expect(() =>
94
+ assertSnapshotMeta({ ...buildSnapshotMeta(SITE), schema: 34 }),
95
+ ).toThrow(/schema must be a string/);
96
+ });
97
+ });
98
+
35
99
  describe("assertSnapshotMeta", () => {
36
100
  it("accepts a known dialect", () => {
37
101
  expect(() =>
@@ -213,6 +213,64 @@ describe("MCP API Routes", () => {
213
213
  expect(await services.collections.getThreadIds(collection.id)).toEqual([]);
214
214
  });
215
215
 
216
+ it("pages posts through tools/call with nextCursor", async () => {
217
+ const { app, services } = createTestApp({ authenticated: true });
218
+ app.route("/api/mcp", mcpApiRoutes);
219
+
220
+ const created = [];
221
+ for (let i = 0; i < 3; i++) {
222
+ created.push(
223
+ await services.posts.create({
224
+ format: "note",
225
+ bodyMarkdown: `post ${i}`,
226
+ publishedAt: 1000 + i,
227
+ }),
228
+ );
229
+ }
230
+
231
+ const listPosts = async (args: Record<string, unknown>) => {
232
+ const res = await postMcp(
233
+ app,
234
+ {
235
+ jsonrpc: "2.0",
236
+ id: 30,
237
+ method: "tools/call",
238
+ params: { name: "jant_posts_list", arguments: args },
239
+ },
240
+ { "MCP-Protocol-Version": "2025-06-18" },
241
+ );
242
+ expect(res.status).toBe(200);
243
+ return (await res.json()).result;
244
+ };
245
+
246
+ const ids: string[] = [];
247
+ let cursor: string | undefined;
248
+ for (let page = 0; page < 5; page++) {
249
+ const result = await listPosts({
250
+ limit: 1,
251
+ ...(cursor ? { cursor } : {}),
252
+ });
253
+ expect(result.isError).toBe(false);
254
+ ids.push(
255
+ ...result.structuredContent.posts.map(
256
+ (post: { id: string }) => post.id,
257
+ ),
258
+ );
259
+ cursor = result.structuredContent.nextCursor ?? undefined;
260
+ if (!cursor) break;
261
+ }
262
+ expect(ids).toEqual(created.map((post) => post.id).reverse());
263
+
264
+ const legacy = await listPosts({ cursor: created[2]?.id });
265
+ expect(
266
+ legacy.structuredContent.posts.map((post: { id: string }) => post.id),
267
+ ).toEqual([created[1]?.id, created[0]?.id]);
268
+
269
+ const unreadable = await listPosts({ cursor: "nope" });
270
+ expect(unreadable.isError).toBe(true);
271
+ expect(unreadable.structuredContent.error).toMatch(/cursor/);
272
+ });
273
+
216
274
  it("creates posts through tools/call", async () => {
217
275
  const { app, services } = createTestApp({ authenticated: true });
218
276
  app.route("/api/mcp", mcpApiRoutes);
@@ -1,5 +1,6 @@
1
1
  import { describe, it, expect } from "vitest";
2
2
  import { createTestApp } from "../../../__tests__/helpers/app.js";
3
+ import { walkPostPages } from "../../../__tests__/helpers/cursor-walk.js";
3
4
  import { createEntityId } from "../../../lib/ids.js";
4
5
  import { postsApiRoutes } from "../posts.js";
5
6
 
@@ -143,6 +144,84 @@ describe("Posts API Routes", () => {
143
144
  expect(body.nextCursor).toBeTruthy();
144
145
  });
145
146
 
147
+ it("pages published posts and drafts with an opaque cursor", async () => {
148
+ const { app, services } = createTestApp({ authenticated: true });
149
+ app.route("/api/posts", postsApiRoutes);
150
+
151
+ const published = [];
152
+ for (let i = 0; i < 5; i++) {
153
+ published.push(
154
+ await services.posts.create({
155
+ format: "note",
156
+ bodyMarkdown: `post ${i}`,
157
+ publishedAt: 1000 + (i % 2), // Ties, broken by ID.
158
+ }),
159
+ );
160
+ }
161
+ const root = published[0];
162
+ await services.posts.create({
163
+ format: "note",
164
+ bodyMarkdown: "reply",
165
+ replyToId: root?.id,
166
+ publishedAt: 900,
167
+ });
168
+ for (let i = 0; i < 3; i++) {
169
+ await services.posts.create({
170
+ format: "note",
171
+ bodyMarkdown: `draft ${i}`,
172
+ status: "draft",
173
+ });
174
+ }
175
+
176
+ for (const path of ["/api/posts", "/api/posts?status=draft"]) {
177
+ const res = await app.request(path);
178
+ const expected = (await res.json()).posts.map(
179
+ (post: { id: string }) => post.id,
180
+ );
181
+ expect(expected.length).toBeGreaterThan(2);
182
+ for (const limit of [1, 2]) {
183
+ expect(await walkPostPages(app, path, limit)).toEqual(expected);
184
+ }
185
+ }
186
+
187
+ const first = await (await app.request("/api/posts?limit=2")).json();
188
+ expect(first.nextCursor).not.toMatch(/^pst_/);
189
+ });
190
+
191
+ it("reads a bare post ID as a cursor, and rejects one it can't use", async () => {
192
+ const { app, services } = createTestApp({ authenticated: true });
193
+ app.route("/api/posts", postsApiRoutes);
194
+
195
+ const older = await services.posts.create({
196
+ format: "note",
197
+ bodyMarkdown: "older",
198
+ publishedAt: 1000,
199
+ });
200
+ const newer = await services.posts.create({
201
+ format: "note",
202
+ bodyMarkdown: "newer",
203
+ publishedAt: 2000,
204
+ });
205
+ const draft = await services.posts.create({
206
+ format: "note",
207
+ bodyMarkdown: "draft",
208
+ status: "draft",
209
+ });
210
+
211
+ const legacy = await app.request(`/api/posts?cursor=${newer.id}`);
212
+ expect(legacy.status).toBe(200);
213
+ expect(
214
+ (await legacy.json()).posts.map((post: { id: string }) => post.id),
215
+ ).toEqual([older.id]);
216
+
217
+ // A draft is not in the published list the cursor claims to continue.
218
+ const wrongList = await app.request(`/api/posts?cursor=${draft.id}`);
219
+ expect(wrongList.status).toBe(400);
220
+ const unreadable = await app.request("/api/posts?cursor=nope");
221
+ expect(unreadable.status).toBe(400);
222
+ expect((await unreadable.json()).code).toBe("VALIDATION_ERROR");
223
+ });
224
+
146
225
  it("serializes quote attribution as sourceName/sourceUrl", async () => {
147
226
  const { app, services } = createTestApp({ authenticated: true });
148
227
  app.route("/api/posts", postsApiRoutes);
@@ -20,7 +20,7 @@ export const internalSearchReindexRoutes = new Hono<Env>();
20
20
  * `body_text` changes.
21
21
  *
22
22
  * Idempotent. Callers loop with the returned `nextCursor` until `done: true`.
23
- * Used by the `jant search-reindex` CLI to backfill search indexes for
23
+ * Used by the `jant search reindex` CLI to backfill search indexes for
24
24
  * existing posts after changes to the text extraction logic (e.g. including
25
25
  * link mark hrefs so inline URLs become searchable).
26
26
  */
@@ -59,12 +59,10 @@ postsApiRoutes.get("/", requireAuthApi(), async (c) => {
59
59
  c.req.query(),
60
60
  );
61
61
 
62
- const posts = await c.var.services.posts.list({
63
- format,
64
- status: status ?? "published",
65
- cursor: cursor ?? undefined,
66
- limit,
67
- });
62
+ const { posts, nextCursor } = await c.var.services.posts.listPage(
63
+ { format, status: status ?? "published" },
64
+ { cursor, limit },
65
+ );
68
66
 
69
67
  // Batch load media for all posts
70
68
  const postIds = posts.map((p) => p.id);
@@ -92,9 +90,7 @@ postsApiRoutes.get("/", requireAuthApi(), async (c) => {
92
90
  ),
93
91
  }),
94
92
  ),
95
-
96
- nextCursor:
97
- posts.length === limit ? (posts[posts.length - 1]?.id ?? null) : null,
93
+ nextCursor,
98
94
  });
99
95
  });
100
96
 
@@ -1,6 +1,9 @@
1
1
  import { describe, expect, it } from "vitest";
2
2
  import { createTestApp } from "../../../../__tests__/helpers/app.js";
3
+ import { walkPostPages } from "../../../../__tests__/helpers/cursor-walk.js";
4
+ import { createEntityId } from "../../../../lib/ids.js";
3
5
  import { publicArchiveApiRoutes } from "../archive.js";
6
+ import { publicPostsApiRoutes } from "../posts.js";
4
7
 
5
8
  describe("Public Archive API Routes", () => {
6
9
  describe("GET /api/public/archive", () => {
@@ -234,6 +237,70 @@ describe("Public Archive API Routes", () => {
234
237
  ]);
235
238
  });
236
239
 
240
+ // The failure this guards: with no time axis named, the list fell back to
241
+ // `lastActivityAt`, so a reply lifted a long-published root to the top of
242
+ // an endpoint documented as newest-published-first.
243
+ it("orders by publication date, not by the latest reply", async () => {
244
+ const { app, services } = createTestApp({ authenticated: false });
245
+ app.route("/api/public/archive", publicArchiveApiRoutes);
246
+
247
+ const oldest = await services.posts.create({
248
+ format: "note",
249
+ title: "Published January 2024",
250
+ bodyMarkdown: "oldest",
251
+ publishedAt: Date.UTC(2024, 0, 1) / 1000,
252
+ });
253
+ const extended = await services.posts.create({
254
+ format: "note",
255
+ title: "Published November 2024, replied to in 2026",
256
+ bodyMarkdown: "old root",
257
+ publishedAt: Date.UTC(2024, 10, 19) / 1000,
258
+ });
259
+ await services.posts.create({
260
+ format: "note",
261
+ bodyMarkdown: "new reply",
262
+ replyToId: extended.id,
263
+ publishedAt: Date.UTC(2026, 8, 26) / 1000,
264
+ });
265
+ const middle = await services.posts.create({
266
+ format: "note",
267
+ title: "Published March 2025",
268
+ bodyMarkdown: "middle",
269
+ publishedAt: Date.UTC(2025, 2, 1) / 1000,
270
+ });
271
+ const newest = await services.posts.create({
272
+ format: "note",
273
+ title: "Published December 2025",
274
+ bodyMarkdown: "newest",
275
+ publishedAt: Date.UTC(2025, 11, 1) / 1000,
276
+ });
277
+ const expected = [newest.id, middle.id, extended.id, oldest.id];
278
+
279
+ const all = await app.request("/api/public/archive");
280
+ expect(all.status).toBe(200);
281
+ const allBody = await all.json();
282
+ expect(allBody.posts.map((post: { id: string }) => post.id)).toEqual(
283
+ expected,
284
+ );
285
+
286
+ // One post per page puts a cursor on every boundary, including the two
287
+ // where publication and activity order disagree. A cursor comparison on
288
+ // a different axis from the ORDER BY would skip or repeat a post here.
289
+ const walked: string[] = [];
290
+ let cursor: string | null = null;
291
+ for (let page = 0; page <= expected.length; page++) {
292
+ const query: string = cursor ? `&cursor=${cursor}` : "";
293
+ const res = await app.request(`/api/public/archive?limit=1${query}`);
294
+ expect(res.status).toBe(200);
295
+ const body = await res.json();
296
+ walked.push(...body.posts.map((post: { id: string }) => post.id));
297
+ cursor = body.nextCursor;
298
+ if (cursor === null) break;
299
+ }
300
+ expect(cursor).toBeNull();
301
+ expect(walked).toEqual(expected);
302
+ });
303
+
237
304
  it("filters by year using publishedAt", async () => {
238
305
  const { app, services } = createTestApp({ authenticated: false });
239
306
  app.route("/api/public/archive", publicArchiveApiRoutes);
@@ -470,4 +537,198 @@ describe("Public Archive API Routes", () => {
470
537
  expect(res.status).toBe(400);
471
538
  });
472
539
  });
540
+
541
+ describe("cursors", () => {
542
+ function setup() {
543
+ const { app, services } = createTestApp({ authenticated: false });
544
+ app.route("/api/public/archive", publicArchiveApiRoutes);
545
+ app.route("/api/public/posts", publicPostsApiRoutes);
546
+ return { app, services };
547
+ }
548
+
549
+ /** Four roots published a day apart, oldest first. */
550
+ async function publishDays(services: ReturnType<typeof setup>["services"]) {
551
+ const created = [];
552
+ for (let day = 1; day <= 4; day++) {
553
+ created.push(
554
+ await services.posts.create({
555
+ format: "note",
556
+ title: `Day ${day}`,
557
+ bodyMarkdown: `day ${day}`,
558
+ publishedAt: Date.UTC(2025, 0, day) / 1000,
559
+ }),
560
+ );
561
+ }
562
+ return created;
563
+ }
564
+
565
+ async function page(
566
+ app: ReturnType<typeof setup>["app"],
567
+ path: string,
568
+ ): Promise<{ ids: string[]; nextCursor: string | null }> {
569
+ const res = await app.request(path);
570
+ expect(res.status).toBe(200);
571
+ const body = await res.json();
572
+ return {
573
+ ids: body.posts.map((post: { id: string }) => post.id),
574
+ nextCursor: body.nextCursor,
575
+ };
576
+ }
577
+
578
+ it("continues after the post the cursor was taken on is deleted", async () => {
579
+ const { app, services } = setup();
580
+ const [day1, day2, day3, day4] = await publishDays(services);
581
+
582
+ const first = await page(app, "/api/public/archive?limit=2");
583
+ expect(first.ids).toEqual([day4?.id, day3?.id]);
584
+ await services.posts.delete(day3?.id ?? "");
585
+
586
+ const second = await page(
587
+ app,
588
+ `/api/public/archive?limit=2&cursor=${first.nextCursor}`,
589
+ );
590
+ expect(second.ids).toEqual([day2?.id, day1?.id]);
591
+ expect(second.nextCursor).toBeNull();
592
+ });
593
+
594
+ it("skips nothing when the cursor post is re-dated mid-walk", async () => {
595
+ const { app, services } = setup();
596
+ const [day1, day2, day3, day4] = await publishDays(services);
597
+
598
+ const first = await page(app, "/api/public/archive?limit=2");
599
+ expect(first.ids).toEqual([day4?.id, day3?.id]);
600
+
601
+ // The author moves the page's last post before every other one. Resuming
602
+ // from where it now sits would return nothing more.
603
+ await services.posts.update(day3?.id ?? "", {
604
+ publishedAt: Date.UTC(2024, 0, 1) / 1000,
605
+ });
606
+ expect((await page(app, "/api/public/archive")).ids).toEqual([
607
+ day4?.id,
608
+ day2?.id,
609
+ day1?.id,
610
+ day3?.id,
611
+ ]);
612
+
613
+ const rest = await walkPostPages(
614
+ app,
615
+ "/api/public/archive",
616
+ 2,
617
+ first.nextCursor,
618
+ );
619
+ // Day 3 comes round again: its sort key changed mid-walk, which the
620
+ // paging guarantee does not cover. Nothing that stayed put is skipped.
621
+ expect(rest).toEqual([day2?.id, day1?.id, day3?.id]);
622
+ });
623
+
624
+ it("answers a private post's or a draft's ID as it does an unknown one", async () => {
625
+ const { app, services } = setup();
626
+ await publishDays(services);
627
+ const hidden = await services.posts.create({
628
+ format: "note",
629
+ title: "Private",
630
+ bodyMarkdown: "private",
631
+ visibility: "private",
632
+ });
633
+ const draft = await services.posts.create({
634
+ format: "note",
635
+ title: "Draft",
636
+ bodyMarkdown: "draft",
637
+ status: "draft",
638
+ });
639
+
640
+ const answers = [];
641
+ for (const id of [hidden.id, draft.id, createEntityId("post")]) {
642
+ for (const path of ["/api/public/archive", "/api/public/posts"]) {
643
+ const res = await app.request(`${path}?cursor=${id}`);
644
+ expect(res.status).toBe(400);
645
+ const body = await res.json();
646
+ expect(body.code).toBe("VALIDATION_ERROR");
647
+ answers.push(body.error);
648
+ }
649
+ }
650
+ // Nothing in the answer tells a real post from one that never existed.
651
+ expect(new Set(answers).size).toBe(1);
652
+ });
653
+
654
+ it("still resumes from a bare post ID", async () => {
655
+ const { app, services } = setup();
656
+ const [day1, day2, day3] = await publishDays(services);
657
+
658
+ const res = await page(app, `/api/public/archive?cursor=${day3?.id}`);
659
+ expect(res.ids).toEqual([day2?.id, day1?.id]);
660
+ });
661
+
662
+ it("rejects a cursor it can't read", async () => {
663
+ const { app, services } = setup();
664
+ await publishDays(services);
665
+
666
+ for (const cursor of ["garbage", "eyJ2IjoxfQ", "pst_", "%7B%7D"]) {
667
+ const res = await app.request(`/api/public/archive?cursor=${cursor}`);
668
+ expect(res.status).toBe(400);
669
+ expect((await res.json()).code).toBe("VALIDATION_ERROR");
670
+ }
671
+ });
672
+
673
+ it("rejects a cursor from a list in another order", async () => {
674
+ const { app, services } = setup();
675
+ await publishDays(services);
676
+ await services.posts.create({
677
+ format: "note",
678
+ title: "Featured",
679
+ bodyMarkdown: "featured",
680
+ featured: true,
681
+ });
682
+
683
+ // The archive reads publication order; `/api/public/posts` reads
684
+ // activity with pinned posts first.
685
+ const archive = await page(app, "/api/public/archive?limit=1");
686
+ const posts = await app.request(
687
+ `/api/public/posts?cursor=${archive.nextCursor}`,
688
+ );
689
+ expect(posts.status).toBe(400);
690
+ expect((await posts.json()).error).toMatch(/different order/);
691
+
692
+ // A cursor records a position in an order, not the filters around it:
693
+ // Featured-only reads the same order, so the position carries over.
694
+ const featured = await app.request(
695
+ `/api/public/archive?cursor=${archive.nextCursor}&visibility=featured`,
696
+ );
697
+ expect(featured.status).toBe(200);
698
+ });
699
+
700
+ it("walks every order it serves the same as one unpaged request", async () => {
701
+ const { app, services } = setup();
702
+ await publishDays(services);
703
+ const sameDay = Date.UTC(2025, 5, 1) / 1000;
704
+ for (const title of ["Tie A", "Tie B", "Tie C"]) {
705
+ await services.posts.create({
706
+ format: "note",
707
+ title,
708
+ bodyMarkdown: title,
709
+ publishedAt: sameDay,
710
+ featured: title !== "Tie C",
711
+ });
712
+ }
713
+ await services.posts.create({
714
+ format: "note",
715
+ title: "Pinned, and pinning doesn't count here",
716
+ bodyMarkdown: "pinned",
717
+ pinned: true,
718
+ publishedAt: Date.UTC(2023, 0, 1) / 1000,
719
+ });
720
+
721
+ for (const path of [
722
+ "/api/public/archive",
723
+ "/api/public/archive?visibility=featured",
724
+ "/api/public/archive?format=note&title=any",
725
+ ]) {
726
+ const expected = (await page(app, path)).ids;
727
+ expect(expected.length).toBeGreaterThan(1);
728
+ for (const limit of [1, 2, 3]) {
729
+ expect(await walkPostPages(app, path, limit)).toEqual(expected);
730
+ }
731
+ }
732
+ });
733
+ });
473
734
  });