@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
@@ -573,277 +573,6 @@ describe("MediaService", () => {
573
573
  });
574
574
  });
575
575
 
576
- describe("migrateLegacyTextAttachments", () => {
577
- /**
578
- * Seed a row representing the envelope-era format (single JSON blob with
579
- * `{ json, html }`), bypassing the current service APIs.
580
- */
581
- async function seedEnvelopeRow(
582
- storage: ReturnType<typeof createMockStorage>,
583
- key: string,
584
- envelope: { json: unknown; html: string },
585
- ) {
586
- const bytes = new TextEncoder().encode(JSON.stringify(envelope));
587
- await storage.put(key, bytes, { contentType: "text/x-tiptap+json" });
588
- return mediaService.create({
589
- filename: key.split("/").pop() ?? "attached-text.md",
590
- originalName: "attached-text.md",
591
- mimeType: "text/x-tiptap+json",
592
- size: bytes.byteLength,
593
- storageKey: key,
594
- provider: "local",
595
- mediaKind: "text",
596
- summary: "Legacy envelope",
597
- chars: 10,
598
- });
599
- }
600
-
601
- /**
602
- * Seed a row representing the split-era format (`.html` primary object
603
- * with a `.json` sibling at the swapped suffix), bypassing current APIs.
604
- */
605
- async function seedSplitRow(
606
- storage: ReturnType<typeof createMockStorage>,
607
- htmlKey: string,
608
- json: unknown,
609
- html: string,
610
- ) {
611
- const jsonKey = htmlKey.replace(/\.html$/, ".json");
612
- const htmlBytes = new TextEncoder().encode(html);
613
- const jsonBytes = new TextEncoder().encode(JSON.stringify(json));
614
- await storage.put(jsonKey, jsonBytes, {
615
- contentType: "application/json",
616
- });
617
- await storage.put(htmlKey, htmlBytes, {
618
- contentType: "text/html; charset=utf-8",
619
- });
620
- return mediaService.create({
621
- filename: htmlKey.split("/").pop() ?? "attached-text.html",
622
- originalName: "attached-text.html",
623
- mimeType: "text/html; charset=utf-8",
624
- size: htmlBytes.byteLength,
625
- storageKey: htmlKey,
626
- provider: "local",
627
- mediaKind: "text",
628
- summary: "Legacy split",
629
- chars: 10,
630
- });
631
- }
632
-
633
- it("converts an envelope row into a single .md file", async () => {
634
- const storage = createMockStorage();
635
- // Real legacy envelopes were named `attached-text.md` — so their
636
- // storageKey already ends in `.md`. Migration overwrites the same
637
- // key with markdown bytes rather than writing a new file; this is
638
- // fine because the DB row still points at the same key and the old
639
- // envelope contents are gone.
640
- const legacyKey = "media/legacy-env.md";
641
- const envelope = {
642
- json: {
643
- type: "doc",
644
- content: [
645
- {
646
- type: "paragraph",
647
- content: [{ type: "text", text: "Hello" }],
648
- },
649
- ],
650
- },
651
- html: "<p>Hello</p>",
652
- };
653
- const row = await seedEnvelopeRow(storage, legacyKey, envelope);
654
-
655
- const result = await mediaService.migrateLegacyTextAttachments({
656
- storage,
657
- storageDriver: "local",
658
- });
659
-
660
- expect(result).toEqual({
661
- migrated: 1,
662
- failed: 0,
663
- remaining: 0,
664
- errors: [],
665
- });
666
-
667
- // Exactly one storage object — the same key, now with markdown bytes
668
- // and markdown metadata. The old envelope JSON is gone (overwritten).
669
- expect(storage.files.size).toBe(1);
670
- const file = storage.files.get(legacyKey)!;
671
- expect(file.contentType).toBe("text/markdown; charset=utf-8");
672
- expect(file.cacheControl).toBe("public, max-age=31536000, immutable");
673
- expect(file.contentDisposition).toBe("inline");
674
- const mdText = new TextDecoder().decode(file.body);
675
- expect(mdText).toContain("Hello");
676
- // Sanity check: no trace of the envelope JSON structure.
677
- expect(mdText.trim().startsWith("{")).toBe(false);
678
-
679
- const updated = await mediaService.getById(row.id);
680
- expect(updated?.storageKey).toBe(legacyKey);
681
- expect(updated?.mimeType).toBe("text/markdown; charset=utf-8");
682
- expect(updated?.originalName).toBe("attached-text.md");
683
- expect(updated?.size).toBe(file.body.byteLength);
684
- expect(updated?.filename).toBe("legacy-env.md");
685
- });
686
-
687
- it("converts a split (.html + .json) row into a single .md file", async () => {
688
- const storage = createMockStorage();
689
- const htmlKey = "media/legacy-split.html";
690
- const jsonKey = "media/legacy-split.json";
691
- const row = await seedSplitRow(
692
- storage,
693
- htmlKey,
694
- {
695
- type: "doc",
696
- content: [
697
- {
698
- type: "paragraph",
699
- content: [{ type: "text", text: "split world" }],
700
- },
701
- ],
702
- },
703
- "<p>split world</p>",
704
- );
705
-
706
- const result = await mediaService.migrateLegacyTextAttachments({
707
- storage,
708
- storageDriver: "local",
709
- });
710
-
711
- expect(result.migrated).toBe(1);
712
- expect(result.failed).toBe(0);
713
- expect(result.remaining).toBe(0);
714
-
715
- // Both old siblings gone; single .md written.
716
- expect(storage.files.has(htmlKey)).toBe(false);
717
- expect(storage.files.has(jsonKey)).toBe(false);
718
- const mdKey = "media/legacy-split.md";
719
- expect(storage.files.has(mdKey)).toBe(true);
720
-
721
- const file = storage.files.get(mdKey)!;
722
- const mdText = new TextDecoder().decode(file.body);
723
- expect(mdText).toContain("split world");
724
-
725
- const updated = await mediaService.getById(row.id);
726
- expect(updated?.storageKey).toBe(mdKey);
727
- expect(updated?.mimeType).toBe("text/markdown; charset=utf-8");
728
- });
729
-
730
- it("is idempotent: current markdown rows are skipped", async () => {
731
- const storage = createMockStorage();
732
- await seedEnvelopeRow(storage, "media/legacy-idemp.md", {
733
- json: {
734
- type: "doc",
735
- content: [
736
- {
737
- type: "paragraph",
738
- content: [{ type: "text", text: "hello" }],
739
- },
740
- ],
741
- },
742
- html: "<p>hello</p>",
743
- });
744
-
745
- const first = await mediaService.migrateLegacyTextAttachments({
746
- storage,
747
- storageDriver: "local",
748
- });
749
- expect(first.migrated).toBe(1);
750
-
751
- const second = await mediaService.migrateLegacyTextAttachments({
752
- storage,
753
- storageDriver: "local",
754
- });
755
- expect(second).toEqual({
756
- migrated: 0,
757
- failed: 0,
758
- remaining: 0,
759
- errors: [],
760
- });
761
- });
762
-
763
- it("respects the batch limit and reports remaining count accurately", async () => {
764
- const storage = createMockStorage();
765
- for (let i = 0; i < 3; i += 1) {
766
- await seedEnvelopeRow(storage, `media/legacy-batch-${i}.md`, {
767
- json: {
768
- type: "doc",
769
- content: [
770
- {
771
- type: "paragraph",
772
- content: [{ type: "text", text: `batch ${i}` }],
773
- },
774
- ],
775
- },
776
- html: `<p>batch ${i}</p>`,
777
- });
778
- }
779
-
780
- const first = await mediaService.migrateLegacyTextAttachments({
781
- storage,
782
- storageDriver: "local",
783
- limit: 2,
784
- });
785
- expect(first.migrated).toBe(2);
786
- expect(first.remaining).toBeGreaterThan(0);
787
-
788
- const second = await mediaService.migrateLegacyTextAttachments({
789
- storage,
790
- storageDriver: "local",
791
- limit: 2,
792
- });
793
- expect(second.migrated).toBe(1);
794
- expect(second.remaining).toBe(0);
795
- });
796
-
797
- it("continues processing the batch when one record fails", async () => {
798
- const storage = createMockStorage();
799
- await seedEnvelopeRow(storage, "media/legacy-good.md", {
800
- json: {
801
- type: "doc",
802
- content: [
803
- {
804
- type: "paragraph",
805
- content: [{ type: "text", text: "good" }],
806
- },
807
- ],
808
- },
809
- html: "<p>good</p>",
810
- });
811
- // Broken envelope — missing json field.
812
- const brokenKey = "media/legacy-broken.md";
813
- const brokenBytes = new TextEncoder().encode(
814
- JSON.stringify({ html: "<p>broken</p>" }),
815
- );
816
- await storage.put(brokenKey, brokenBytes, {
817
- contentType: "text/x-tiptap+json",
818
- });
819
- const brokenRow = await mediaService.create({
820
- filename: "legacy-broken.md",
821
- originalName: "attached-text.md",
822
- mimeType: "text/x-tiptap+json",
823
- size: brokenBytes.byteLength,
824
- storageKey: brokenKey,
825
- provider: "local",
826
- mediaKind: "text",
827
- summary: "Broken",
828
- chars: 1,
829
- });
830
-
831
- const result = await mediaService.migrateLegacyTextAttachments({
832
- storage,
833
- storageDriver: "local",
834
- });
835
-
836
- expect(result.migrated).toBe(1);
837
- expect(result.failed).toBe(1);
838
- expect(result.errors).toHaveLength(1);
839
- expect(result.errors[0].mediaId).toBe(brokenRow.id);
840
-
841
- // Broken record is untouched and still flagged as legacy for later retry.
842
- const stillBroken = await mediaService.getById(brokenRow.id);
843
- expect(stillBroken?.mimeType).toBe("text/x-tiptap+json");
844
- });
845
- });
846
-
847
576
  describe("getById", () => {
848
577
  it("returns media by ID", async () => {
849
578
  const created = await mediaService.create(sampleMedia);
@@ -683,13 +683,17 @@ describe("PostService", () => {
683
683
  ]);
684
684
 
685
685
  // The keyset cursor reads the same keys or pagination skips rows.
686
+ const first = await postService.listPage(
687
+ { sortOrder: "newest" },
688
+ { limit: 1 },
689
+ );
686
690
  expect(
687
691
  (
688
- await postService.list({
689
- sortOrder: "newest",
690
- cursor: ordered[0]?.id,
691
- })
692
- ).map((post) => post.bodyText),
692
+ await postService.listPage(
693
+ { sortOrder: "newest" },
694
+ { cursor: first.nextCursor ?? undefined, limit: 10 },
695
+ )
696
+ ).posts.map((post) => post.bodyText),
693
697
  ).toEqual(["middle, worst", "oldest, best"]);
694
698
  });
695
699
 
@@ -858,20 +862,21 @@ describe("PostService", () => {
858
862
  .set({ featuredAt: 7000 })
859
863
  .where(eq(posts.id, newest.id));
860
864
 
861
- const firstPage = await postService.list({
862
- featured: true,
863
- ignorePinnedSort: true,
864
- limit: 2,
865
- });
866
- const secondPage = await postService.list({
867
- featured: true,
868
- ignorePinnedSort: true,
869
- cursor: middle.id,
870
- limit: 2,
871
- });
865
+ const firstPage = await postService.listPage(
866
+ { featured: true, ignorePinnedSort: true },
867
+ { limit: 2 },
868
+ );
869
+ const secondPage = await postService.listPage(
870
+ { featured: true, ignorePinnedSort: true },
871
+ { cursor: firstPage.nextCursor ?? undefined, limit: 2 },
872
+ );
872
873
 
873
- expect(firstPage.map((post) => post.id)).toEqual([newest.id, middle.id]);
874
- expect(secondPage.map((post) => post.id)).toEqual([oldest.id]);
874
+ expect(firstPage.posts.map((post) => post.id)).toEqual([
875
+ newest.id,
876
+ middle.id,
877
+ ]);
878
+ expect(secondPage.posts.map((post) => post.id)).toEqual([oldest.id]);
879
+ expect(secondPage.nextCursor).toBeNull();
875
880
  });
876
881
 
877
882
  it("excludes posts hidden from Latest when requested", async () => {
@@ -1032,24 +1037,6 @@ describe("PostService", () => {
1032
1037
  expect(posts).toHaveLength(2);
1033
1038
  });
1034
1039
 
1035
- it("supports cursor pagination", async () => {
1036
- const created = [];
1037
- for (let i = 0; i < 5; i++) {
1038
- created.push(
1039
- await postService.create({
1040
- format: "note",
1041
- bodyMarkdown: `post ${i}`,
1042
- publishedAt: 1000 + i,
1043
- }),
1044
- );
1045
- }
1046
-
1047
- // Get posts with ID less than the 3rd post
1048
- const thirdPostId = created[2]?.id ?? 0;
1049
- const posts = await postService.list({ cursor: thirdPostId });
1050
- expect(posts.every((p) => p.id < thirdPostId)).toBe(true);
1051
- });
1052
-
1053
1040
  it("excludes replies when requested", async () => {
1054
1041
  const root = await postService.create({
1055
1042
  format: "note",
@@ -1136,6 +1123,325 @@ describe("PostService", () => {
1136
1123
  });
1137
1124
  });
1138
1125
 
1126
+ describe("listPage", () => {
1127
+ type PageFilters = Parameters<typeof postService.listPage>[0];
1128
+
1129
+ /** Every page of a walk, one request per page, until `nextCursor` is null. */
1130
+ async function walk(filters: PageFilters, limit: number) {
1131
+ const ids: string[] = [];
1132
+ let cursor: string | undefined;
1133
+ // A walk that never ends is a failure too; bound it by the corpus size.
1134
+ for (let page = 0; page < 100; page++) {
1135
+ const result = await postService.listPage(filters, { cursor, limit });
1136
+ ids.push(...result.posts.map((post) => post.id));
1137
+ if (result.nextCursor === null) return ids;
1138
+ cursor = result.nextCursor;
1139
+ }
1140
+ throw new Error("The walk did not end");
1141
+ }
1142
+
1143
+ async function publishSeries(count: number, from = 1000) {
1144
+ const created = [];
1145
+ for (let i = 0; i < count; i++) {
1146
+ created.push(
1147
+ await postService.create({
1148
+ format: "note",
1149
+ bodyMarkdown: `post ${i}`,
1150
+ publishedAt: from + i,
1151
+ }),
1152
+ );
1153
+ }
1154
+ return created;
1155
+ }
1156
+
1157
+ /**
1158
+ * A corpus where every sort key has ties and NULLs, and the three time
1159
+ * axes disagree, so some page boundary lands on each case a wrong keyset
1160
+ * would get wrong.
1161
+ */
1162
+ async function seedSortCorpus() {
1163
+ const at = 1_700_000_000;
1164
+ const note = (body: string, extra: Record<string, unknown> = {}) =>
1165
+ postService.create({ format: "note", bodyMarkdown: body, ...extra });
1166
+
1167
+ await note("pinned, older pin", {
1168
+ publishedAt: at + 10,
1169
+ pinnedAt: at + 500,
1170
+ rating: 3,
1171
+ });
1172
+ await note("pinned, newer pin", {
1173
+ publishedAt: at + 20,
1174
+ pinnedAt: at + 600,
1175
+ });
1176
+ await note("pinned, same pin and time", {
1177
+ publishedAt: at + 20,
1178
+ pinnedAt: at + 600,
1179
+ });
1180
+ await note("featured, rated 5", {
1181
+ publishedAt: at + 30,
1182
+ featuredAt: at + 700,
1183
+ rating: 5,
1184
+ });
1185
+ await note("featured, same time and rating", {
1186
+ publishedAt: at + 30,
1187
+ featuredAt: at + 710,
1188
+ rating: 5,
1189
+ });
1190
+ await note("featured, oldest", {
1191
+ publishedAt: at + 5,
1192
+ featuredAt: at + 720,
1193
+ });
1194
+ await note("same time, rated 2", { publishedAt: at + 40, rating: 2 });
1195
+ await note("same time, also rated 2", {
1196
+ publishedAt: at + 40,
1197
+ rating: 2,
1198
+ });
1199
+ await note("same time, unrated", { publishedAt: at + 40 });
1200
+ const announced = await note("old root, announced reply", {
1201
+ publishedAt: at + 1,
1202
+ rating: 4,
1203
+ });
1204
+ await note("announced reply", {
1205
+ replyToId: announced.id,
1206
+ publishedAt: at + 100,
1207
+ });
1208
+ const quiet = await note("old root, quiet reply", {
1209
+ publishedAt: at + 2,
1210
+ });
1211
+ await note("quiet reply", {
1212
+ replyToId: quiet.id,
1213
+ quietReply: true,
1214
+ publishedAt: at + 200,
1215
+ });
1216
+ await note("private", { publishedAt: at + 50, visibility: "private" });
1217
+ await note("hidden from Latest", {
1218
+ publishedAt: at + 60,
1219
+ visibility: "latest_hidden",
1220
+ });
1221
+ await note("draft one", { status: "draft" });
1222
+ await note("draft two", { status: "draft", rating: 1 });
1223
+ }
1224
+
1225
+ const ORDERS = ["newest", "oldest", "rating_desc"] as const;
1226
+ const AXES = ["activity", "thread_updated", "published"] as const;
1227
+ const MODES: Array<{ name: string; filters: PageFilters }> = [
1228
+ ...ORDERS.flatMap((sortOrder) =>
1229
+ AXES.flatMap((sortBy) =>
1230
+ [false, true].map((ignorePinnedSort) => ({
1231
+ name: `${sortOrder} by ${sortBy}, ${ignorePinnedSort ? "unpinned" : "pinned"}`,
1232
+ filters: { sortOrder, sortBy, ignorePinnedSort },
1233
+ })),
1234
+ ),
1235
+ ),
1236
+ { name: "featured, pinned", filters: { featured: true } },
1237
+ {
1238
+ name: "featured, unpinned",
1239
+ filters: { featured: true, ignorePinnedSort: true },
1240
+ },
1241
+ ];
1242
+
1243
+ // Walking page by page must return exactly the unpaged order: nothing
1244
+ // skipped, nothing repeated, at every page size. Drafts are in the set,
1245
+ // so the activity axis also covers its draft branch.
1246
+ it.each(MODES)("walks $name in list order", async ({ filters }) => {
1247
+ await seedSortCorpus();
1248
+ const expected = (
1249
+ await postService.list({ ...filters, limit: 1000 })
1250
+ ).map((post) => post.id);
1251
+ expect(new Set(expected).size).toBe(expected.length);
1252
+ expect(expected.length).toBeGreaterThan(2);
1253
+
1254
+ for (const limit of [1, 2, 3, 7]) {
1255
+ expect(await walk(filters, limit)).toEqual(expected);
1256
+ }
1257
+ const published = { ...filters, status: "published" as const };
1258
+ const expectedPublished = (
1259
+ await postService.list({ ...published, limit: 1000 })
1260
+ ).map((post) => post.id);
1261
+ expect(await walk(published, 2)).toEqual(expectedPublished);
1262
+ });
1263
+
1264
+ it("ends with a null cursor on a page that exactly fills", async () => {
1265
+ await publishSeries(4);
1266
+
1267
+ const first = await postService.listPage({}, { limit: 2 });
1268
+ expect(first.posts).toHaveLength(2);
1269
+ expect(first.nextCursor).not.toBeNull();
1270
+
1271
+ const second = await postService.listPage(
1272
+ {},
1273
+ { cursor: first.nextCursor ?? undefined, limit: 2 },
1274
+ );
1275
+ expect(second.posts).toHaveLength(2);
1276
+ expect(second.nextCursor).toBeNull();
1277
+ });
1278
+
1279
+ it("keeps walking past a row it can't return", async () => {
1280
+ // Hydration drops a Post with no slug. The page it was on comes back
1281
+ // short; the walk must not read that as the end.
1282
+ const [oldest, middle, newest] = await publishSeries(3);
1283
+ sqlite
1284
+ .prepare("DELETE FROM path_registry WHERE post_id = ?")
1285
+ .run(middle?.id);
1286
+
1287
+ const first = await postService.listPage({}, { limit: 1 });
1288
+ expect(first.posts.map((post) => post.id)).toEqual([newest?.id]);
1289
+ const second = await postService.listPage(
1290
+ {},
1291
+ { cursor: first.nextCursor ?? undefined, limit: 1 },
1292
+ );
1293
+ expect(second.posts).toEqual([]);
1294
+ expect(second.nextCursor).not.toBeNull();
1295
+ const third = await postService.listPage(
1296
+ {},
1297
+ { cursor: second.nextCursor ?? undefined, limit: 1 },
1298
+ );
1299
+ expect(third.posts.map((post) => post.id)).toEqual([oldest?.id]);
1300
+ expect(third.nextCursor).toBeNull();
1301
+ });
1302
+
1303
+ it("continues after the post the cursor was taken on is deleted", async () => {
1304
+ const [oldest, middle, newest] = await publishSeries(3);
1305
+
1306
+ const first = await postService.listPage({}, { limit: 2 });
1307
+ expect(first.posts.map((post) => post.id)).toEqual([
1308
+ newest?.id,
1309
+ middle?.id,
1310
+ ]);
1311
+ await postService.delete(middle?.id ?? "");
1312
+
1313
+ const second = await postService.listPage(
1314
+ {},
1315
+ { cursor: first.nextCursor ?? undefined, limit: 2 },
1316
+ );
1317
+ expect(second.posts.map((post) => post.id)).toEqual([oldest?.id]);
1318
+ });
1319
+
1320
+ it("resumes from where the page ended when that post is re-dated", async () => {
1321
+ const [oldest, middle, newest] = await publishSeries(3);
1322
+ const filters = { sortBy: "published" as const };
1323
+
1324
+ const first = await postService.listPage(filters, { limit: 2 });
1325
+ expect(first.posts.map((post) => post.id)).toEqual([
1326
+ newest?.id,
1327
+ middle?.id,
1328
+ ]);
1329
+ // Moved before `oldest`: a cursor that looked the post up would resume
1330
+ // from its new place and skip `oldest`; moved to the top, it would
1331
+ // return `newest` again.
1332
+ await postService.update(middle?.id ?? "", { publishedAt: 500 });
1333
+
1334
+ const second = await postService.listPage(filters, {
1335
+ cursor: first.nextCursor ?? undefined,
1336
+ limit: 2,
1337
+ });
1338
+ // `middle` comes round again because its own sort key changed, which
1339
+ // the guarantee leaves open. `oldest`, which stayed put, is not skipped.
1340
+ expect(second.posts.map((post) => post.id)).toEqual([
1341
+ oldest?.id,
1342
+ middle?.id,
1343
+ ]);
1344
+
1345
+ await postService.update(middle?.id ?? "", { publishedAt: 5000 });
1346
+ const again = await postService.listPage(filters, {
1347
+ cursor: first.nextCursor ?? undefined,
1348
+ limit: 2,
1349
+ });
1350
+ expect(again.posts.map((post) => post.id)).toEqual([oldest?.id]);
1351
+ });
1352
+
1353
+ it("treats an empty cursor as the first page", async () => {
1354
+ await publishSeries(2);
1355
+
1356
+ const page = await postService.listPage({}, { cursor: "", limit: 5 });
1357
+ expect(page.posts).toHaveLength(2);
1358
+ });
1359
+
1360
+ it("resumes after a bare post ID, as earlier releases' cursors are", async () => {
1361
+ const created = await publishSeries(5);
1362
+ const third = created[2];
1363
+
1364
+ const page = await postService.listPage(
1365
+ {},
1366
+ { cursor: third?.id, limit: 10 },
1367
+ );
1368
+ expect(page.posts.map((post) => post.id)).toEqual([
1369
+ created[1]?.id,
1370
+ created[0]?.id,
1371
+ ]);
1372
+ });
1373
+
1374
+ it("rejects a bare post ID the caller can't see, whatever the reason", async () => {
1375
+ const [visible] = await publishSeries(1);
1376
+ const draft = await postService.create({
1377
+ format: "note",
1378
+ bodyMarkdown: "draft",
1379
+ status: "draft",
1380
+ });
1381
+ const hidden = await postService.create({
1382
+ format: "note",
1383
+ bodyMarkdown: "private",
1384
+ visibility: "private",
1385
+ });
1386
+ const deleted = await postService.create({
1387
+ format: "note",
1388
+ bodyMarkdown: "deleted",
1389
+ });
1390
+ await postService.delete(deleted.id);
1391
+ const publicFilters = {
1392
+ status: "published" as const,
1393
+ excludePrivate: true,
1394
+ };
1395
+
1396
+ const errors = [];
1397
+ for (const cursor of [draft.id, hidden.id, deleted.id]) {
1398
+ const error = await postService
1399
+ .listPage(publicFilters, { cursor, limit: 5 })
1400
+ .catch((caught: unknown) => caught);
1401
+ expect(error).toBeInstanceOf(ValidationError);
1402
+ errors.push((error as ValidationError).message);
1403
+ }
1404
+ // One message for all three, so the answer says nothing about the post.
1405
+ expect(new Set(errors).size).toBe(1);
1406
+
1407
+ // A post the caller can see still resumes.
1408
+ await expect(
1409
+ postService.listPage(publicFilters, { cursor: visible?.id, limit: 5 }),
1410
+ ).resolves.toEqual({ posts: [], nextCursor: null });
1411
+ });
1412
+
1413
+ it("rejects a cursor taken in another sort mode", async () => {
1414
+ await publishSeries(3);
1415
+ const first = await postService.listPage(
1416
+ { sortBy: "published" },
1417
+ { limit: 1 },
1418
+ );
1419
+
1420
+ await expect(
1421
+ postService.listPage(
1422
+ { sortBy: "activity" },
1423
+ { cursor: first.nextCursor ?? undefined, limit: 1 },
1424
+ ),
1425
+ ).rejects.toThrow(/different order/);
1426
+ await expect(
1427
+ postService.listPage(
1428
+ { sortBy: "published", ignorePinnedSort: true },
1429
+ { cursor: first.nextCursor ?? undefined, limit: 1 },
1430
+ ),
1431
+ ).rejects.toThrow(/different order/);
1432
+ });
1433
+
1434
+ it("rejects a cursor it can't read", async () => {
1435
+ await publishSeries(1);
1436
+
1437
+ for (const cursor of ["not a cursor", "eyJ2IjoxfQ", "pst_nope"]) {
1438
+ await expect(
1439
+ postService.listPage({}, { cursor, limit: 1 }),
1440
+ ).rejects.toBeInstanceOf(ValidationError);
1441
+ }
1442
+ });
1443
+ });
1444
+
1139
1445
  describe("count", () => {
1140
1446
  it("returns 0 when no posts exist", async () => {
1141
1447
  const count = await postService.count();