@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,9 @@
1
1
  import { describe, expect, it } from "vitest";
2
2
  import { eq } from "drizzle-orm";
3
3
  import { createTestApp } from "../../../../__tests__/helpers/app.js";
4
- import { posts } from "../../../../db/schema.js";
4
+ import { walkPostPages } from "../../../../__tests__/helpers/cursor-walk.js";
5
+ import { posts, threadCollections } from "../../../../db/schema.js";
6
+ import { createEntityId } from "../../../../lib/ids.js";
5
7
  import { publicPostsApiRoutes } from "../posts.js";
6
8
 
7
9
  describe("Public Posts API Routes", () => {
@@ -120,6 +122,104 @@ describe("Public Posts API Routes", () => {
120
122
  expect(body.nextCursor).toBeTruthy();
121
123
  });
122
124
 
125
+ it("walks pinned posts and bumped Threads the same as one unpaged request", async () => {
126
+ const { app, services } = createTestApp({ authenticated: false });
127
+ app.route("/api/public/posts", publicPostsApiRoutes);
128
+
129
+ const day = (n: number) => Date.UTC(2025, 0, n) / 1000;
130
+ await services.posts.create({
131
+ format: "note",
132
+ title: "Pinned",
133
+ bodyMarkdown: "pinned",
134
+ publishedAt: day(1),
135
+ pinnedAt: day(20),
136
+ });
137
+ await services.posts.create({
138
+ format: "note",
139
+ title: "Pinned at the same moment",
140
+ bodyMarkdown: "pinned too",
141
+ publishedAt: day(2),
142
+ pinnedAt: day(20),
143
+ });
144
+ const bumped = await services.posts.create({
145
+ format: "note",
146
+ title: "Old root, new reply",
147
+ bodyMarkdown: "bumped",
148
+ publishedAt: day(3),
149
+ });
150
+ await services.posts.create({
151
+ format: "note",
152
+ bodyMarkdown: "reply",
153
+ replyToId: bumped.id,
154
+ publishedAt: day(15),
155
+ });
156
+ for (const title of ["Tie A", "Tie B", "Tie C"]) {
157
+ await services.posts.create({
158
+ format: "note",
159
+ title,
160
+ bodyMarkdown: title,
161
+ publishedAt: day(10),
162
+ });
163
+ }
164
+ await services.posts.create({
165
+ format: "note",
166
+ title: "Hidden from Latest",
167
+ bodyMarkdown: "hidden",
168
+ visibility: "latest_hidden",
169
+ publishedAt: day(11),
170
+ });
171
+
172
+ const res = await app.request("/api/public/posts");
173
+ const expected = (await res.json()).posts.map(
174
+ (post: { id: string }) => post.id,
175
+ );
176
+ expect(expected).toHaveLength(6);
177
+ for (const limit of [1, 2, 4]) {
178
+ expect(await walkPostPages(app, "/api/public/posts", limit)).toEqual(
179
+ expected,
180
+ );
181
+ }
182
+ });
183
+
184
+ it("keeps paging after the cursor post is deleted, and reads old ID cursors", async () => {
185
+ const { app, services } = createTestApp({ authenticated: false });
186
+ app.route("/api/public/posts", publicPostsApiRoutes);
187
+
188
+ const created = [];
189
+ for (let n = 1; n <= 4; n++) {
190
+ created.push(
191
+ await services.posts.create({
192
+ format: "note",
193
+ title: `Post ${n}`,
194
+ bodyMarkdown: `post ${n}`,
195
+ publishedAt: Date.UTC(2025, 0, n) / 1000,
196
+ }),
197
+ );
198
+ }
199
+ const [first, second, third, fourth] = created;
200
+
201
+ const page1 = await (
202
+ await app.request("/api/public/posts?limit=2")
203
+ ).json();
204
+ expect(page1.posts.map((post: { id: string }) => post.id)).toEqual([
205
+ fourth?.id,
206
+ third?.id,
207
+ ]);
208
+ await services.posts.delete(third?.id ?? "");
209
+ expect(
210
+ await walkPostPages(app, "/api/public/posts", 2, page1.nextCursor),
211
+ ).toEqual([second?.id, first?.id]);
212
+
213
+ // The bare post ID earlier releases returned as `nextCursor`.
214
+ const legacy = await app.request(
215
+ `/api/public/posts?cursor=${fourth?.id}`,
216
+ );
217
+ expect(legacy.status).toBe(200);
218
+ expect(
219
+ (await legacy.json()).posts.map((post: { id: string }) => post.id),
220
+ ).toEqual([second?.id, first?.id]);
221
+ });
222
+
123
223
  it("returns markdown instead of rendered fields when content=markdown", async () => {
124
224
  const { app, services } = createTestApp({ authenticated: false });
125
225
  app.route("/api/public/posts", publicPostsApiRoutes);
@@ -363,28 +463,253 @@ describe("Public Posts API Routes", () => {
363
463
  const middle = await createRatedThread("Middle", 2000, 3);
364
464
  const lowest = await createRatedThread("Lowest", 3000, 1);
365
465
 
366
- const firstRes = await app.request(
367
- "/api/public/posts?collection=rated-threads&limit=1",
368
- );
369
- expect(firstRes.status).toBe(200);
370
- const first = await firstRes.json();
371
- expect(first.posts[0].id).toBe(highest.id);
372
- expect(first.nextCursor).toBe(highest.id);
466
+ expect(
467
+ await walkPostPages(
468
+ app,
469
+ "/api/public/posts?collection=rated-threads",
470
+ 1,
471
+ ),
472
+ ).toEqual([highest.id, middle.id, lowest.id]);
473
+ });
474
+
475
+ it("walks a collection in each order the same as one unpaged request", async () => {
476
+ const { app, services, db } = createTestApp({ authenticated: false });
477
+ app.route("/api/public/posts", publicPostsApiRoutes);
478
+
479
+ const collection = await services.collections.create({
480
+ slug: "walked",
481
+ title: "Walked",
482
+ });
483
+ const day = (n: number) => Date.UTC(2025, 0, n) / 1000;
484
+ const thread = async (
485
+ title: string,
486
+ publishedAt: number,
487
+ extra: {
488
+ rating?: number;
489
+ visibility?: "private" | "latest_hidden";
490
+ } = {},
491
+ ) =>
492
+ services.posts.create({
493
+ format: "note",
494
+ title,
495
+ bodyMarkdown: title,
496
+ collectionIds: [collection.id],
497
+ publishedAt,
498
+ ...extra,
499
+ });
373
500
 
374
- const secondRes = await app.request(
375
- `/api/public/posts?collection=rated-threads&limit=1&cursor=${first.nextCursor}`,
501
+ // Pins tie on the pin time, then order by each sort's own keys.
502
+ const pinnedA = await thread("Pinned A", day(1), { rating: 2 });
503
+ const pinnedB = await thread("Pinned B", day(2));
504
+ for (const pinned of [pinnedA, pinnedB]) {
505
+ await db
506
+ .update(threadCollections)
507
+ .set({ pinnedAt: day(30) })
508
+ .where(eq(threadCollections.threadId, pinned.id));
509
+ }
510
+ // A reply moves this Thread up under newest and rating, not oldest.
511
+ const bumped = await thread("Bumped", day(3), { rating: 4 });
512
+ await services.posts.create({
513
+ format: "note",
514
+ bodyMarkdown: "reply",
515
+ replyToId: bumped.id,
516
+ publishedAt: day(20),
517
+ rating: 5,
518
+ });
519
+ // Ties on publication time, activity, and rating.
520
+ for (const title of ["Tie A", "Tie B", "Tie C"]) {
521
+ await thread(title, day(10), { rating: 3 });
522
+ }
523
+ await thread("Unrated", day(12));
524
+ await thread("Private", day(13), { visibility: "private" });
525
+ await thread("Hidden from Latest", day(14), {
526
+ visibility: "latest_hidden",
527
+ });
528
+
529
+ for (const sort of ["newest", "oldest", "rating_desc"]) {
530
+ const path = `/api/public/posts?collection=walked&sort=${sort}`;
531
+ const res = await app.request(`${path}&limit=100`);
532
+ const body = await res.json();
533
+ const expected = body.posts.map((post: { id: string }) => post.id);
534
+ expect(body.nextCursor).toBeNull();
535
+ expect(expected).toHaveLength(7);
536
+ expect(expected.slice(0, 2).sort()).toEqual(
537
+ [pinnedA.id, pinnedB.id].sort(),
538
+ );
539
+ for (const limit of [1, 2, 3]) {
540
+ expect(await walkPostPages(app, path, limit), sort).toEqual(expected);
541
+ }
542
+ }
543
+ });
544
+
545
+ it("keeps paging a collection after the cursor Thread leaves it", async () => {
546
+ const { app, services } = createTestApp({ authenticated: false });
547
+ app.route("/api/public/posts", publicPostsApiRoutes);
548
+
549
+ const collection = await services.collections.create({
550
+ slug: "shrinking",
551
+ title: "Shrinking",
552
+ });
553
+ const roots = [];
554
+ for (let n = 1; n <= 7; n++) {
555
+ roots.push(
556
+ await services.posts.create({
557
+ format: "note",
558
+ title: `Thread ${n}`,
559
+ bodyMarkdown: `thread ${n}`,
560
+ collectionIds: [collection.id],
561
+ publishedAt: Date.UTC(2025, 0, n) / 1000,
562
+ }),
563
+ );
564
+ }
565
+ const ids = roots.map((root) => root.id).reverse();
566
+ const path = "/api/public/posts?collection=shrinking&limit=2";
567
+ const readPage = async (cursor?: string) => {
568
+ const res = await app.request(
569
+ cursor ? `${path}&cursor=${encodeURIComponent(cursor)}` : path,
570
+ );
571
+ expect(res.status).toBe(200);
572
+ return (await res.json()) as {
573
+ posts: { id: string }[];
574
+ nextCursor: string | null;
575
+ };
576
+ };
577
+ const idsOf = (page: { posts: { id: string }[] }) =>
578
+ page.posts.map((post) => post.id);
579
+
580
+ // Each page ends on a Thread that is gone before the next request:
581
+ // deleted, unpublished, then taken out of the collection.
582
+ const page1 = await readPage();
583
+ expect(idsOf(page1)).toEqual(ids.slice(0, 2));
584
+ await services.posts.delete(ids[1] ?? "");
585
+
586
+ const page2 = await readPage(page1.nextCursor ?? undefined);
587
+ expect(idsOf(page2)).toEqual(ids.slice(2, 4));
588
+ await services.posts.update(ids[3] ?? "", { status: "draft" });
589
+
590
+ const page3 = await readPage(page2.nextCursor ?? undefined);
591
+ expect(idsOf(page3)).toEqual(ids.slice(4, 6));
592
+ await services.collections.removeThread(collection.id, ids[5] ?? "");
593
+
594
+ const page4 = await readPage(page3.nextCursor ?? undefined);
595
+ expect(idsOf(page4)).toEqual(ids.slice(6));
596
+ expect(page4.nextCursor).toBeNull();
597
+ });
598
+
599
+ it("resumes a collection from a bare root ID it lists, and rejects any other", async () => {
600
+ const { app, services } = createTestApp({ authenticated: false });
601
+ app.route("/api/public/posts", publicPostsApiRoutes);
602
+
603
+ const collection = await services.collections.create({
604
+ slug: "legacy",
605
+ title: "Legacy",
606
+ });
607
+ const inCollection = async (title: string, n: number) =>
608
+ services.posts.create({
609
+ format: "note",
610
+ title,
611
+ bodyMarkdown: title,
612
+ collectionIds: [collection.id],
613
+ publishedAt: Date.UTC(2025, 0, n) / 1000,
614
+ });
615
+ const first = await inCollection("First", 1);
616
+ const second = await inCollection("Second", 2);
617
+ const third = await inCollection("Third", 3);
618
+
619
+ // The bare root ID earlier releases returned as `nextCursor`.
620
+ const legacy = await app.request(
621
+ `/api/public/posts?collection=legacy&cursor=${third.id}`,
376
622
  );
377
- expect(secondRes.status).toBe(200);
378
- const second = await secondRes.json();
379
- expect(second.posts[0].id).toBe(middle.id);
380
- expect(second.nextCursor).toBe(middle.id);
623
+ expect(legacy.status).toBe(200);
624
+ const body = await legacy.json();
625
+ expect(body.posts.map((post: { id: string }) => post.id)).toEqual([
626
+ second.id,
627
+ first.id,
628
+ ]);
629
+ expect(body.nextCursor).toBeNull();
630
+
631
+ const privateRoot = await services.posts.create({
632
+ format: "note",
633
+ title: "Private",
634
+ bodyMarkdown: "private",
635
+ collectionIds: [collection.id],
636
+ visibility: "private",
637
+ });
638
+ const draftRoot = await services.posts.create({
639
+ format: "note",
640
+ title: "Draft",
641
+ bodyMarkdown: "draft",
642
+ collectionIds: [collection.id],
643
+ status: "draft",
644
+ });
645
+ const elsewhere = await services.posts.create({
646
+ format: "note",
647
+ title: "Not in the collection",
648
+ bodyMarkdown: "elsewhere",
649
+ });
650
+ const deleted = await inCollection("Deleted", 4);
651
+ await services.posts.delete(deleted.id);
652
+
653
+ const answers = [];
654
+ for (const id of [
655
+ privateRoot.id,
656
+ draftRoot.id,
657
+ elsewhere.id,
658
+ deleted.id,
659
+ createEntityId("post"),
660
+ ]) {
661
+ const res = await app.request(
662
+ `/api/public/posts?collection=legacy&cursor=${id}`,
663
+ );
664
+ expect(res.status).toBe(400);
665
+ const error = await res.json();
666
+ expect(error.code).toBe("VALIDATION_ERROR");
667
+ answers.push(error.error);
668
+ }
669
+ // Nothing in the answer tells a private Thread from one that never
670
+ // existed.
671
+ expect(new Set(answers).size).toBe(1);
672
+ });
673
+
674
+ it("rejects a cursor from a collection in another order, or from Latest", async () => {
675
+ const { app, services } = createTestApp({ authenticated: false });
676
+ app.route("/api/public/posts", publicPostsApiRoutes);
677
+
678
+ const collection = await services.collections.create({
679
+ slug: "ordered",
680
+ title: "Ordered",
681
+ });
682
+ for (const n of [1, 2, 3]) {
683
+ await services.posts.create({
684
+ format: "note",
685
+ title: `Thread ${n}`,
686
+ bodyMarkdown: `thread ${n}`,
687
+ collectionIds: [collection.id],
688
+ publishedAt: Date.UTC(2025, 0, n) / 1000,
689
+ });
690
+ }
691
+ const cursorOf = async (path: string) =>
692
+ (await (await app.request(path)).json()).nextCursor as string;
381
693
 
382
- const thirdRes = await app.request(
383
- `/api/public/posts?collection=rated-threads&limit=1&cursor=${second.nextCursor}`,
694
+ const newest = await cursorOf(
695
+ "/api/public/posts?collection=ordered&sort=newest&limit=1",
384
696
  );
385
- expect(thirdRes.status).toBe(200);
386
- const third = await thirdRes.json();
387
- expect(third.posts[0].id).toBe(lowest.id);
697
+ const latest = await cursorOf("/api/public/posts?limit=1");
698
+ for (const path of [
699
+ `/api/public/posts?collection=ordered&sort=oldest&cursor=${newest}`,
700
+ `/api/public/posts?collection=ordered&cursor=${latest}`,
701
+ `/api/public/posts?cursor=${newest}`,
702
+ ]) {
703
+ const res = await app.request(path);
704
+ expect(res.status, path).toBe(400);
705
+ expect((await res.json()).error).toMatch(/different order/);
706
+ }
707
+ for (const cursor of ["garbage", "eyJ2IjoxfQ", "pst_"]) {
708
+ const res = await app.request(
709
+ `/api/public/posts?collection=ordered&cursor=${cursor}`,
710
+ );
711
+ expect(res.status).toBe(400);
712
+ }
388
713
  });
389
714
 
390
715
  it("keeps root format and Latest visibility filters for Collections", async () => {
@@ -95,20 +95,23 @@ publicArchiveApiRoutes.get("/", async (c) => {
95
95
  throw new ValidationError(INVALID_VISIBILITY_MESSAGE);
96
96
  }
97
97
 
98
- const posts = await c.var.services.posts.list({
99
- lang,
100
- status: "published",
101
- cursor: cursor ?? undefined,
102
- limit,
103
- excludePrivate: true,
104
- excludeLatestHidden: false,
105
- excludeReplies: true,
106
- // Ordering is fixed at newest-published-first here, so the year filter
107
- // stays on the publication axis — the page's `?sort=` switch has no
108
- // counterpart on a cursor keyed off the post id.
109
- ...toPostFilters(parsed.selection, { yearAxis: "published" }),
110
- ignorePinnedSort: true,
111
- });
98
+ const { posts, nextCursor } = await c.var.services.posts.listPage(
99
+ {
100
+ lang,
101
+ status: "published",
102
+ excludePrivate: true,
103
+ excludeLatestHidden: false,
104
+ excludeReplies: true,
105
+ // Newest-published-first, the page's default order. Named explicitly:
106
+ // left unset, a published list sorts by activity, and a reply would
107
+ // lift an old root to the top. The year filter reads the same column,
108
+ // and so does the cursor.
109
+ ...toPostFilters(parsed.selection, { yearAxis: "published" }),
110
+ sortBy: "published",
111
+ ignorePinnedSort: true,
112
+ },
113
+ { cursor, limit },
114
+ );
112
115
 
113
116
  const postIds = posts.map((post) => post.id);
114
117
  const [mediaMap, collectionsMap] = await Promise.all([
@@ -126,7 +129,6 @@ publicArchiveApiRoutes.get("/", async (c) => {
126
129
  { content },
127
130
  ),
128
131
  ),
129
- nextCursor:
130
- posts.length === limit ? (posts[posts.length - 1]?.id ?? null) : null,
132
+ nextCursor,
131
133
  });
132
134
  });
@@ -292,8 +292,8 @@ publicPostsApiRoutes.get("/", async (c) => {
292
292
  sortOrder = resolveCollectionSortOrder(sort, defaultSort, showRatingSort);
293
293
  }
294
294
 
295
- const posts = collectionIds
296
- ? await c.var.services.posts.listCollectionThreadRootsForCollections(
295
+ const { posts, nextCursor } = collectionIds
296
+ ? await c.var.services.posts.listCollectionThreadRootPage(
297
297
  collectionIds,
298
298
  {
299
299
  status: "published",
@@ -302,20 +302,20 @@ publicPostsApiRoutes.get("/", async (c) => {
302
302
  rootFormat: format,
303
303
  lang,
304
304
  sortOrder,
305
- cursor: cursor ?? undefined,
306
- limit,
307
305
  },
306
+ { cursor, limit },
308
307
  )
309
- : await c.var.services.posts.list({
310
- format,
311
- lang,
312
- status: "published",
313
- cursor: cursor ?? undefined,
314
- limit,
315
- excludePrivate: true,
316
- excludeLatestHidden: true,
317
- excludeReplies: true,
318
- });
308
+ : await c.var.services.posts.listPage(
309
+ {
310
+ format,
311
+ lang,
312
+ status: "published",
313
+ excludePrivate: true,
314
+ excludeLatestHidden: true,
315
+ excludeReplies: true,
316
+ },
317
+ { cursor, limit },
318
+ );
319
319
 
320
320
  const postIds = posts.map((post) => post.id);
321
321
  const [mediaMap, collectionsMap] = await Promise.all([
@@ -333,8 +333,7 @@ publicPostsApiRoutes.get("/", async (c) => {
333
333
  { content },
334
334
  ),
335
335
  ),
336
- nextCursor:
337
- posts.length === limit ? (posts[posts.length - 1]?.id ?? null) : null,
336
+ nextCursor,
338
337
  });
339
338
  });
340
339