@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
@@ -2566,8 +2566,6 @@ msgid "This site publishes Atom feeds. Copy one of these addresses into a feed r
2566
2566
  msgstr "This site publishes Atom feeds. Copy one of these addresses into a feed reader."
2567
2567
 
2568
2568
  #. @context: Error shown when a hosted upload would exceed the shared account media limit
2569
- #. @context: Error shown when a hosted upload would exceed the shared account media limit
2570
- #: src/routes/api/upload-multipart.ts
2571
2569
  #: src/routes/api/upload.ts
2572
2570
  msgid "This upload would exceed your shared hosted media limit. Remove files or upgrade storage to continue."
2573
2571
  msgstr "This upload would exceed your shared hosted media limit. Remove files or upgrade storage to continue."
@@ -2563,8 +2563,6 @@ msgid "This site publishes Atom feeds. Copy one of these addresses into a feed r
2563
2563
  msgstr ""
2564
2564
 
2565
2565
  #. @context: Error shown when a hosted upload would exceed the shared account media limit
2566
- #. @context: Error shown when a hosted upload would exceed the shared account media limit
2567
- #: src/routes/api/upload-multipart.ts
2568
2566
  #: src/routes/api/upload.ts
2569
2567
  msgid "This upload would exceed your shared hosted media limit. Remove files or upgrade storage to continue."
2570
2568
  msgstr ""
@@ -2563,8 +2563,6 @@ msgid "This site publishes Atom feeds. Copy one of these addresses into a feed r
2563
2563
  msgstr ""
2564
2564
 
2565
2565
  #. @context: Error shown when a hosted upload would exceed the shared account media limit
2566
- #. @context: Error shown when a hosted upload would exceed the shared account media limit
2567
- #: src/routes/api/upload-multipart.ts
2568
2566
  #: src/routes/api/upload.ts
2569
2567
  msgid "This upload would exceed your shared hosted media limit. Remove files or upgrade storage to continue."
2570
2568
  msgstr ""
package/src/index.ts CHANGED
@@ -1,84 +1,13 @@
1
1
  /**
2
2
  * Jant - A microblog system
3
3
  *
4
+ * The public JavaScript API is `createApp`. A site's entry point is
5
+ * `export default createApp();`, and every setting comes from the
6
+ * environment. Everything else under `src/` is internal and can change in
7
+ * any release; see `docs/compatibility.md`.
8
+ *
4
9
  * @packageDocumentation
5
10
  */
6
11
 
7
- // Main app factory
8
12
  export { createApp } from "./app.js";
9
- export type { App, AppVariables } from "./app.js";
10
-
11
- // Types
12
- export type {
13
- Format,
14
- Status,
15
- SortOrder,
16
- NavItemType,
17
- Bindings,
18
- Post,
19
- Media,
20
- MediaAttachment,
21
- PostWithMedia,
22
- Collection,
23
- NavItem,
24
- CustomUrl,
25
- Setting,
26
- CreatePost,
27
- UpdatePost,
28
- PostAttachmentInput,
29
- TextAttachmentContent,
30
- CreateNavItem,
31
- UpdateNavItem,
32
- CreateCollection,
33
- UpdateCollection,
34
- AppConfig,
35
- TextAttachmentContentFormat,
36
- // View Model types
37
- PostView,
38
- MediaView,
39
- NavItemView,
40
- SearchResultView,
41
- TimelineItemView,
42
- ArchiveGroup,
43
- // Page props
44
- ArchiveFilters,
45
- // Feed types
46
- FeedData,
47
- // Search
48
- SearchResult,
49
- } from "./types.js";
50
-
51
- export type { ColorTheme } from "./ui/color-themes.js";
52
-
53
- export {
54
- FORMATS,
55
- STATUSES,
56
- SORT_ORDERS,
57
- NAV_ITEM_TYPES,
58
- MAX_MEDIA_ATTACHMENTS,
59
- MAX_PINNED_POSTS,
60
- TEXT_ATTACHMENT_CONTENT_FORMATS,
61
- MEDIA_KINDS,
62
- } from "./types.js";
63
-
64
- // Utilities
65
- export * as time from "./lib/time.js";
66
- export * as url from "./lib/url.js";
67
- export * as markdown from "./lib/markdown.js";
68
-
69
- // View Model conversion utilities
70
- export {
71
- createMediaContext,
72
- toPostView,
73
- toPostViews,
74
- toMediaView,
75
- toNavItemView,
76
- toNavItemViews,
77
- toSearchResultView,
78
- toArchiveGroups,
79
- toArchiveGroupsWithMedia,
80
- } from "./lib/view.js";
81
- export type { MediaContext } from "./lib/view.js";
82
-
83
- // Default feed renderers (for custom feed implementations)
84
- export { defaultFeedRenderer } from "./lib/feed.js";
13
+ export type { App } from "./app.js";
@@ -0,0 +1,105 @@
1
+ import { describe, expect, it } from "vitest";
2
+ import { ValidationError } from "../errors.js";
3
+ import {
4
+ decodePostListCursor,
5
+ encodePostListCursor,
6
+ isLegacyPostListCursor,
7
+ type PostListCursorShape,
8
+ } from "../post-list-cursor.js";
9
+
10
+ const POST_ID = "pst_01jpyx3m7gw4w3h7m4bknq0v1d";
11
+ const SHAPE: PostListCursorShape = {
12
+ mode: "newest:activity:pinned",
13
+ kinds: ["number", "number", "id"],
14
+ };
15
+
16
+ /** Encode an arbitrary payload the way the codec would, for hostile inputs. */
17
+ function encodeRaw(payload: unknown): string {
18
+ return btoa(JSON.stringify(payload))
19
+ .replace(/\+/g, "-")
20
+ .replace(/\//g, "_")
21
+ .replace(/=+$/, "");
22
+ }
23
+
24
+ function decodeError(raw: string, shape = SHAPE): string {
25
+ try {
26
+ decodePostListCursor(raw, shape);
27
+ } catch (error) {
28
+ expect(error).toBeInstanceOf(ValidationError);
29
+ return (error as ValidationError).message;
30
+ }
31
+ throw new Error(`Expected ${raw} to be rejected`);
32
+ }
33
+
34
+ describe("post list cursor", () => {
35
+ it("round-trips a key tuple", () => {
36
+ const values = [-1, 1706000000, POST_ID];
37
+ const cursor = encodePostListCursor(SHAPE.mode, values);
38
+
39
+ expect(cursor).toMatch(/^[A-Za-z0-9_-]+$/);
40
+ expect(decodePostListCursor(cursor, SHAPE)).toEqual(values);
41
+ });
42
+
43
+ it("stays short enough for a URL at the widest tuple", () => {
44
+ const cursor = encodePostListCursor("rating_desc:thread_updated:pinned", [
45
+ 1706000000,
46
+ 5,
47
+ 1706000000,
48
+ POST_ID,
49
+ ]);
50
+ expect(cursor.length).toBeLessThan(200);
51
+ });
52
+
53
+ it("never looks like a bare post ID", () => {
54
+ const cursor = encodePostListCursor(SHAPE.mode, [-1, 0, POST_ID]);
55
+ expect(isLegacyPostListCursor(cursor)).toBe(false);
56
+ expect(isLegacyPostListCursor(POST_ID)).toBe(true);
57
+ expect(isLegacyPostListCursor("med_01jpyx4g9m8b4y50a4gx3t7p1n")).toBe(
58
+ false,
59
+ );
60
+ });
61
+
62
+ it("rejects a cursor that can't be read", () => {
63
+ const unreadable = decodeError("not a cursor");
64
+ for (const raw of [
65
+ "",
66
+ "a",
67
+ "%%%",
68
+ "x".repeat(600),
69
+ encodeRaw("just a string"),
70
+ encodeRaw([1, "newest:activity:pinned", []]),
71
+ encodeRaw({ s: SHAPE.mode, k: [-1, 0, POST_ID] }),
72
+ encodeRaw({ v: 1, s: SHAPE.mode }),
73
+ encodeRaw({ v: 1, s: SHAPE.mode, k: [-1, 0, POST_ID], extra: true }),
74
+ encodeRaw({ v: 1, s: 7, k: [-1, 0, POST_ID] }),
75
+ // Wrong length, wrong kinds, a fraction, an unsafe integer, a non-post ID.
76
+ encodeRaw({ v: 1, s: SHAPE.mode, k: [-1, POST_ID] }),
77
+ encodeRaw({ v: 1, s: SHAPE.mode, k: [-1, 0, POST_ID, 4] }),
78
+ encodeRaw({ v: 1, s: SHAPE.mode, k: ["-1", 0, POST_ID] }),
79
+ encodeRaw({ v: 1, s: SHAPE.mode, k: [-1, 0.5, POST_ID] }),
80
+ encodeRaw({ v: 1, s: SHAPE.mode, k: [-1, 2 ** 60, POST_ID] }),
81
+ encodeRaw({
82
+ v: 1,
83
+ s: SHAPE.mode,
84
+ k: [-1, 0, "med_01jpyx4g9m8b4y50a4gx3t7p1n"],
85
+ }),
86
+ encodeRaw({ v: 1, s: SHAPE.mode, k: [-1, 0, null] }),
87
+ ]) {
88
+ expect(decodeError(raw)).toBe(unreadable);
89
+ }
90
+ });
91
+
92
+ it("names an unknown format version", () => {
93
+ expect(
94
+ decodeError(encodeRaw({ v: 2, s: SHAPE.mode, k: [-1, 0, POST_ID] })),
95
+ ).toMatch(/different version/);
96
+ });
97
+
98
+ it("names a cursor taken in another sort mode", () => {
99
+ const cursor = encodePostListCursor("newest:published:unpinned", [
100
+ 0,
101
+ POST_ID,
102
+ ]);
103
+ expect(decodeError(cursor)).toMatch(/different order/);
104
+ });
105
+ });
@@ -219,25 +219,25 @@ describe("Timeline data assembly", () => {
219
219
  );
220
220
  }
221
221
 
222
+ const filters = { status: "published" as const, excludeReplies: true };
223
+
222
224
  // First page
223
- const page1 = await postService.list({
224
- status: "published",
225
- excludeReplies: true,
226
- limit: 3,
227
- });
228
- expect(page1).toHaveLength(3);
225
+ const page1 = await postService.listPage(filters, { limit: 3 });
226
+ expect(page1.posts).toHaveLength(3);
227
+ expect(page1.nextCursor).not.toBeNull();
229
228
 
230
229
  // Second page using cursor
231
- const lastPost = page1[page1.length - 1];
232
- expect(lastPost).toBeDefined();
233
- const page2 = await postService.list({
234
- status: "published",
235
- excludeReplies: true,
230
+ const page2 = await postService.listPage(filters, {
231
+ cursor: page1.nextCursor ?? undefined,
236
232
  limit: 3,
237
- cursor: lastPost?.id,
238
233
  });
239
- expect(page2).toHaveLength(2);
240
- expect(page2.every((p) => p.id < (lastPost?.id ?? 0))).toBe(true);
234
+ expect(page2.posts.map((post) => post.id)).toEqual(
235
+ posts
236
+ .slice(0, 2)
237
+ .map((post) => post.id)
238
+ .reverse(),
239
+ );
240
+ expect(page2.nextCursor).toBeNull();
241
241
  });
242
242
 
243
243
  it("supports offset-based pagination for page navigation", async () => {
@@ -10,7 +10,6 @@ import {
10
10
  toNavItemView,
11
11
  toNavItemViews,
12
12
  toSearchResultView,
13
- toArchiveGroups,
14
13
  } from "../view.js";
15
14
  import type { MediaContext } from "../view.js";
16
15
  import type {
@@ -984,48 +983,3 @@ describe("toSearchResultView", () => {
984
983
  expect(view.post.permalink).toBe("/my-link");
985
984
  });
986
985
  });
987
-
988
- // =============================================================================
989
- // toArchiveGroups
990
- // =============================================================================
991
-
992
- describe("toArchiveGroups", () => {
993
- it("converts grouped map to ArchiveGroup array", () => {
994
- const grouped = new Map<string, Post[]>();
995
- grouped.set("2024-02", [
996
- makePost({ id: UUID_1, publishedAt: 1706745600 }),
997
- makePost({ id: UUID_2, publishedAt: 1706832000 }),
998
- ]);
999
- grouped.set("2024-01", [makePost({ id: UUID_3, publishedAt: 1704067200 })]);
1000
-
1001
- const groups = toArchiveGroups(grouped, EMPTY_CTX);
1002
- expect(groups).toHaveLength(2);
1003
-
1004
- expect(groups[0]).toHaveProperty("year", "2024");
1005
- expect(groups[0]).toHaveProperty("month", "02");
1006
- expect(groups[0]).toHaveProperty("label", "February 2024");
1007
- expect(groups[0]).toHaveProperty("posts");
1008
- expect(groups[0]?.posts).toHaveLength(2);
1009
-
1010
- expect(groups[1]).toHaveProperty("year", "2024");
1011
- expect(groups[1]).toHaveProperty("month", "01");
1012
- expect(groups[1]).toHaveProperty("label", "January 2024");
1013
- expect(groups[1]?.posts).toHaveLength(1);
1014
- });
1015
-
1016
- it("converts posts to PostView within groups", () => {
1017
- const grouped = new Map<string, Post[]>();
1018
- grouped.set("2024-02", [makePost({ id: UUID_1 })]);
1019
-
1020
- const groups = toArchiveGroups(grouped, EMPTY_CTX);
1021
- const post = groups[0]?.posts[0];
1022
- expect(post).toBeDefined();
1023
- expect(post?.permalink).toBeDefined();
1024
- expect(post?.publishedAtFormatted).toBeDefined();
1025
- });
1026
-
1027
- it("handles empty map", () => {
1028
- const groups = toArchiveGroups(new Map(), EMPTY_CTX);
1029
- expect(groups).toHaveLength(0);
1030
- });
1031
- });
package/src/lib/feed.ts CHANGED
@@ -2,12 +2,6 @@
2
2
  * Default Feed Renderers
3
3
  *
4
4
  * Atom and Sitemap XML generators.
5
- * Theme authors can import these to extend/wrap the defaults:
6
- *
7
- * @example
8
- * ```typescript
9
- * import { defaultFeedRenderer } from "@jant/core/lib/feed";
10
- * ```
11
5
  */
12
6
 
13
7
  import type {
@@ -0,0 +1,211 @@
1
+ /**
2
+ * The cursor `posts.listPage()` and `posts.listCollectionThreadRootPage()`
3
+ * hand out as `nextCursor`.
4
+ *
5
+ * A cursor says where the previous page ended: the sort mode it was taken in
6
+ * and the full sort-key tuple of that page's last row, key for key as the
7
+ * ORDER BY reads them. Resuming is a pure keyset comparison against those
8
+ * values, so the post the page ended on can be deleted, unpublished, or edited
9
+ * before the next request without moving the position. The two lists name
10
+ * their sort modes apart, so a cursor from one never resumes the other.
11
+ *
12
+ * Wire format: `base64url(JSON { v, s, k })` — format version, sort mode, and
13
+ * key tuple. It is not signed. A caller who edits one can only move their own
14
+ * position on an axis they may already read; the values are never looked up.
15
+ * Filters stay out: a position on the sort axis is valid under any filter.
16
+ *
17
+ * Callers treat the string as opaque. The one other shape still accepted is
18
+ * the bare post TypeID earlier releases returned; see
19
+ * {@link isLegacyPostListCursor}.
20
+ */
21
+
22
+ import { ValidationError } from "./errors.js";
23
+ import { ID_PREFIX, isTypeId } from "./ids.js";
24
+
25
+ /** Bumped when the payload shape changes; older versions are rejected. */
26
+ const POST_LIST_CURSOR_VERSION = 1;
27
+
28
+ /**
29
+ * Longest encoded cursor accepted. The largest tuple (pinned, rating, time,
30
+ * id) encodes to under 200 characters; the cap only keeps a hostile value from
31
+ * reaching the decoder.
32
+ */
33
+ const MAX_ENCODED_LENGTH = 512;
34
+
35
+ const BASE64URL_PATTERN = /^[A-Za-z0-9_-]+$/;
36
+
37
+ const UNREADABLE_MESSAGE =
38
+ "This cursor can't be read. Pass back nextCursor unchanged, or leave cursor out to start from the first page.";
39
+ const VERSION_MESSAGE =
40
+ "This cursor is from a different version of Jant. Leave cursor out to start from the first page.";
41
+ const MODE_MESSAGE =
42
+ "This cursor is from a list in a different order. Leave cursor out to start from the first page.";
43
+
44
+ /**
45
+ * A legacy cursor naming a Post that is gone, or that the caller can't see.
46
+ * One message for both, so a cursor can't be used to probe for private Posts.
47
+ */
48
+ export const MISSING_LEGACY_CURSOR_MESSAGE =
49
+ "This cursor names a post that can't be found. Leave cursor out to start from the first page.";
50
+
51
+ /** What one position of the key tuple holds. */
52
+ export type PostListCursorKeyKind = "number" | "id";
53
+
54
+ /** One sort-key value: a Unix timestamp, a rating, a pin, or the post ID. */
55
+ export type PostListCursorValue = number | string;
56
+
57
+ /** What a cursor must match to resume the current request. */
58
+ export interface PostListCursorShape {
59
+ /** The request's sort mode, as the service names it. */
60
+ mode: string;
61
+ /** One kind per ORDER BY key, in ORDER BY order. */
62
+ kinds: readonly PostListCursorKeyKind[];
63
+ }
64
+
65
+ interface PostListCursorPayload {
66
+ v: number;
67
+ s: string;
68
+ k: PostListCursorValue[];
69
+ }
70
+
71
+ function encodeBase64Url(text: string): string {
72
+ return btoa(text).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
73
+ }
74
+
75
+ function decodeBase64Url(encoded: string): string | null {
76
+ const padded =
77
+ encoded.replace(/-/g, "+").replace(/_/g, "/") +
78
+ "===".slice((encoded.length + 3) % 4);
79
+ try {
80
+ return atob(padded);
81
+ } catch {
82
+ return null;
83
+ }
84
+ }
85
+
86
+ function isPlainObject(value: unknown): value is Record<string, unknown> {
87
+ return typeof value === "object" && value !== null && !Array.isArray(value);
88
+ }
89
+
90
+ function matchesKind(
91
+ value: unknown,
92
+ kind: PostListCursorKeyKind,
93
+ ): value is PostListCursorValue {
94
+ return kind === "number"
95
+ ? Number.isSafeInteger(value)
96
+ : typeof value === "string" && isTypeId(value, ID_PREFIX.post);
97
+ }
98
+
99
+ /**
100
+ * Encode the position after a page's last row.
101
+ *
102
+ * @param mode - The sort mode the page was read in
103
+ * @param values - That row's sort-key tuple, in ORDER BY order
104
+ * @returns The opaque cursor string
105
+ * @example
106
+ * ```ts
107
+ * encodePostListCursor("newest:activity:pinned", [-1, 1706000000, post.id]);
108
+ * ```
109
+ */
110
+ export function encodePostListCursor(
111
+ mode: string,
112
+ values: readonly PostListCursorValue[],
113
+ ): string {
114
+ const payload: PostListCursorPayload = {
115
+ v: POST_LIST_CURSOR_VERSION,
116
+ s: mode,
117
+ k: [...values],
118
+ };
119
+ // Every value is ASCII — digits, a mode name, a TypeID — so `btoa` can take
120
+ // the JSON text as it is.
121
+ return encodeBase64Url(JSON.stringify(payload));
122
+ }
123
+
124
+ /**
125
+ * Decode a cursor for the current request, strictly.
126
+ *
127
+ * Nothing here falls back to the first page: a cursor that can't be read, that
128
+ * an unknown format version wrote, that was taken in another sort mode, or
129
+ * whose tuple doesn't fit the mode's keys is rejected, because answering with
130
+ * page 1 would hand the caller posts it already has.
131
+ *
132
+ * @param raw - The `cursor` the caller sent
133
+ * @param shape - The current request's sort mode and key kinds
134
+ * @returns The key tuple, in ORDER BY order
135
+ * @throws {ValidationError} When the cursor doesn't resume this request
136
+ * @example
137
+ * ```ts
138
+ * const after = decodePostListCursor(cursor, {
139
+ * mode: "newest:published:unpinned",
140
+ * kinds: ["number", "id"],
141
+ * });
142
+ * ```
143
+ */
144
+ export function decodePostListCursor(
145
+ raw: string,
146
+ shape: PostListCursorShape,
147
+ ): PostListCursorValue[] {
148
+ if (raw.length > MAX_ENCODED_LENGTH || !BASE64URL_PATTERN.test(raw)) {
149
+ throw new ValidationError(UNREADABLE_MESSAGE);
150
+ }
151
+ const text = decodeBase64Url(raw);
152
+ if (text === null) {
153
+ throw new ValidationError(UNREADABLE_MESSAGE);
154
+ }
155
+
156
+ let parsed: unknown;
157
+ try {
158
+ parsed = JSON.parse(text);
159
+ } catch {
160
+ throw new ValidationError(UNREADABLE_MESSAGE);
161
+ }
162
+ if (!isPlainObject(parsed) || !Number.isSafeInteger(parsed.v)) {
163
+ throw new ValidationError(UNREADABLE_MESSAGE);
164
+ }
165
+ if (parsed.v !== POST_LIST_CURSOR_VERSION) {
166
+ throw new ValidationError(VERSION_MESSAGE);
167
+ }
168
+
169
+ const { s: mode, k: values } = parsed;
170
+ if (
171
+ Object.keys(parsed).length !== 3 ||
172
+ typeof mode !== "string" ||
173
+ !Array.isArray(values)
174
+ ) {
175
+ throw new ValidationError(UNREADABLE_MESSAGE);
176
+ }
177
+ if (mode !== shape.mode) {
178
+ throw new ValidationError(MODE_MESSAGE);
179
+ }
180
+ if (values.length !== shape.kinds.length) {
181
+ throw new ValidationError(UNREADABLE_MESSAGE);
182
+ }
183
+ const tuple: PostListCursorValue[] = [];
184
+ for (const [index, kind] of shape.kinds.entries()) {
185
+ const value: unknown = values[index];
186
+ if (!matchesKind(value, kind)) {
187
+ throw new ValidationError(UNREADABLE_MESSAGE);
188
+ }
189
+ tuple.push(value);
190
+ }
191
+ return tuple;
192
+ }
193
+
194
+ /**
195
+ * Whether a cursor is the bare post TypeID that releases before the opaque
196
+ * format returned as `nextCursor`.
197
+ *
198
+ * Accepted indefinitely — a stored cursor, or one a client built from a post
199
+ * ID, must keep resuming. An encoded cursor can never look like one: it opens
200
+ * with the base64url of `{"`, never with `pst_`.
201
+ *
202
+ * @param raw - The `cursor` the caller sent
203
+ * @returns Whether to resolve it as a post ID
204
+ * @example
205
+ * ```ts
206
+ * isLegacyPostListCursor("pst_01jpyx3m7gw4w3h7m4bknq0v1d"); // => true
207
+ * ```
208
+ */
209
+ export function isLegacyPostListCursor(raw: string): boolean {
210
+ return isTypeId(raw, ID_PREFIX.post);
211
+ }
package/src/lib/view.ts CHANGED
@@ -724,35 +724,8 @@ export function toSearchResultViews(
724
724
  // Archive Group Conversions
725
725
  // =============================================================================
726
726
 
727
- /**
728
- * Converts a grouped post map to typed ArchiveGroup[].
729
- */
730
- export function toArchiveGroups(
731
- grouped: Map<string, Post[]>,
732
- ctx: MediaContext,
733
- aliasMap?: Map<string, string>,
734
- ): ArchiveGroup[] {
735
- const groups: ArchiveGroup[] = [];
736
- for (const [yearMonth, posts] of grouped) {
737
- const [year, month] = yearMonth.split("-");
738
- if (!year || !month) continue;
739
-
740
- const label = formatYearMonthLabel(yearMonth);
741
- if (!label) continue;
742
-
743
- groups.push({
744
- year,
745
- month,
746
- label,
747
- posts: toPostViewsFromPosts(posts, ctx, undefined, aliasMap),
748
- });
749
- }
750
- return groups;
751
- }
752
-
753
727
  /**
754
728
  * Converts a grouped PostWithMedia map to typed ArchiveGroup[].
755
- * Unlike toArchiveGroups, this preserves media attachments on each post.
756
729
  *
757
730
  * @param grouped - Map of "YYYY-MM" keys to PostWithMedia arrays
758
731
  * @param ctx - Media context for URL computation
@@ -3,11 +3,11 @@ import { tmpdir } from "node:os";
3
3
  import { join } from "node:path";
4
4
  import Database from "better-sqlite3";
5
5
  import { afterEach, describe, expect, it, vi } from "vitest";
6
- import { run } from "../../../bin/commands/export.js";
6
+ import { run } from "../../../bin/commands/db/export.js";
7
7
  import { migrate } from "../runtime.js";
8
8
  import type { Bindings } from "../../types.js";
9
9
 
10
- describe("jant export", () => {
10
+ describe("jant db export", () => {
11
11
  const tempDirs: string[] = [];
12
12
  const originalEnv = process.env.DATABASE_URL;
13
13
  const siteId = "sit_01jpyz1h3v4m7s2k8r5c9t0qbd";
@@ -4,6 +4,10 @@ import { tmpdir } from "node:os";
4
4
  import { join } from "node:path";
5
5
  import Database from "better-sqlite3";
6
6
  import { afterEach, describe, expect, it, vi } from "vitest";
7
+ import {
8
+ listInstalledSchemaTags,
9
+ readInstalledJantVersion,
10
+ } from "../../../bin/lib/site-snapshot.js";
7
11
  import { createLocalDriver } from "../../lib/storage.js";
8
12
  import { migrate } from "../runtime.js";
9
13
  import type { Bindings } from "../../types.js";
@@ -244,6 +248,8 @@ describe("jant site snapshot export/import", () => {
244
248
  format: "jant-site-snapshot",
245
249
  version: 2,
246
250
  dialect: "sqlite",
251
+ jant: readInstalledJantVersion(),
252
+ schema: listInstalledSchemaTags("sqlite").at(-1),
247
253
  site: { id: SNAPSHOT_SITE_ID, key: SNAPSHOT_SITE_KEY },
248
254
  });
249
255
  expect(existsSync(join(snapshotPath, "storage-manifest.json"))).toBe(false);
@@ -2,7 +2,7 @@ import { mkdtemp, readFile, rm } from "node:fs/promises";
2
2
  import { tmpdir } from "node:os";
3
3
  import { join } from "node:path";
4
4
  import { afterEach, describe, expect, it, vi } from "vitest";
5
- import { run as runImportSite } from "../../../bin/commands/import-site.js";
5
+ import { run as runImportSite } from "../../../bin/commands/site/import.js";
6
6
  import { run as runSiteExport } from "../../../bin/commands/site/export.js";
7
7
  import {
8
8
  CLI_API_TOKEN_ENV_VAR,
@@ -65,6 +65,7 @@ describe("site CLI token env", () => {
65
65
  vi.spyOn(console, "log").mockImplementation(() => {});
66
66
 
67
67
  await runSiteExport([
68
+ "--url",
68
69
  "https://example.com",
69
70
  "--output",
70
71
  outputPath,
@@ -94,6 +95,7 @@ describe("site CLI token env", () => {
94
95
 
95
96
  await expect(
96
97
  runImportSite([
98
+ "--url",
97
99
  "https://example.com",
98
100
  "--path",
99
101
  "/definitely-missing-jant-import-source",
@@ -119,6 +121,7 @@ describe("site CLI token env", () => {
119
121
 
120
122
  await expect(
121
123
  runImportSite([
124
+ "--url",
122
125
  "https://example.com",
123
126
  "--path",
124
127
  "/definitely-missing-jant-import-source",