@jant/core 0.9.0 → 0.10.0

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 (493) hide show
  1. package/bin/commands/site/import.js +5 -2
  2. package/bin/jant.js +37 -19
  3. package/bin/lib/migration-rehearsal.js +27 -0
  4. package/dist/{app-BzH8jmh3.js → app-DIVtyB4m.js} +12236 -12100
  5. package/dist/client/.vite/manifest.json +20 -20
  6. package/dist/client/_assets/chunks/{settings-paths-BcdySNx6.js → settings-paths-C-ZZBTau.js} +1 -1
  7. package/dist/client/_assets/chunks/{slug-format-CRXO1AL5.js → slug-format-BcIsNKz-.js} +1 -1
  8. package/dist/client/_assets/chunks/{unsafe-svg-BkscJx69.js → unsafe-svg-DU_DNMy5.js} +2 -2
  9. package/dist/client/_assets/client-D4AT9Iqr.js +295 -0
  10. package/dist/client/_assets/{client-BCumu1-D.css → client-DRuw7XCt.css} +1 -1
  11. package/dist/client/_assets/{client-auth-Ds9G0IgR.js → client-auth-BpkkKTsV.js} +1 -1
  12. package/dist/client/_assets/{client-compose-D6rExKVK.js → client-compose-C-DXzcFR.js} +2 -2
  13. package/dist/client/_assets/{client-manage-sVOkqVbH.js → client-manage-BfT7ht4M.js} +4 -4
  14. package/dist/index.js +1 -1
  15. package/dist/node.js +2 -2
  16. package/package.json +1 -1
  17. package/src/__tests__/api-docs.test.ts +264 -0
  18. package/src/__tests__/cli-commands.test.ts +21 -1
  19. package/src/__tests__/config-docs.test.ts +15 -1
  20. package/src/__tests__/export-docs.test.ts +264 -0
  21. package/src/__tests__/fixtures/releases/0.8.1/site-export/README.md +130 -0
  22. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/2thjq/_index.md +25 -0
  23. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/2u5e5/_index.md +35 -0
  24. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/41q27/0x4nv/index.md +18 -0
  25. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/41q27/_index.md +44 -0
  26. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/41q27/faqyt/index.md +30 -0
  27. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/41q27/the-potting-mix-guide-i-keep-rereading/index.md +20 -0
  28. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/5kayp/_index.md +23 -0
  29. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/5ynfs/_index.md +31 -0
  30. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/5ynfs/hu597/index.md +21 -0
  31. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/_index.md +5 -0
  32. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/a-night-heron-field-guide-for-my-walk-folder/_index.md +31 -0
  33. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/a-quiet-saturday-after-a-busy-week/_index.md +36 -0
  34. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/archive/_index.md +8 -0
  35. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/are-na-is-the-only-bookmark-pile-i-still-revisit/_index.md +30 -0
  36. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/bought-too-many-lemons-again/_index.md +37 -0
  37. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/city-walks/_index.md +12 -0
  38. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/cleanshot-for-screenshots-ocr-and-screen-recording-on-the-mac/_index.md +33 -0
  39. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/cleanshotmac-shang-de-jie-tu-ocr-lu-ping-gong-ju/_index.md +32 -0
  40. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/co344/_index.md +25 -0
  41. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/collections/_index.md +5 -0
  42. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/current-tea-rotation/_index.md +34 -0
  43. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/derek-sivers-still-writes-the-kind-of-internet-i-want-more-of/_index.md +30 -0
  44. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/desk-but-better/_index.md +25 -0
  45. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/e0kcg/_index.md +22 -0
  46. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/egi3c/_index.md +24 -0
  47. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/evf9j/_index.md +152 -0
  48. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/featured/_index.md +8 -0
  49. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/from-basho/_index.md +25 -0
  50. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/from-epictetus/_index.md +25 -0
  51. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/from-marcus-aurelius/_index.md +25 -0
  52. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/from-seneca/_index.md +26 -0
  53. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/from-thoreau/_index.md +25 -0
  54. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/gkbvv/2cl6d/index.md +18 -0
  55. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/gkbvv/3zqv7/index.md +30 -0
  56. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/gkbvv/5oxsv/index.md +18 -0
  57. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/gkbvv/_index.md +39 -0
  58. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/gwob9/_index.md +25 -0
  59. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/home-cooking/_index.md +12 -0
  60. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/hz729/_index.md +24 -0
  61. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/inaturalist-ai-zi-ran-she-qu/_index.md +44 -0
  62. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/j4v0q/_index.md +35 -0
  63. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/k278t/_index.md +25 -0
  64. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/k4eee/_index.md +22 -0
  65. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/k5vh8/_index.md +32 -0
  66. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/k5vh8/a-reading-log-idea-i-might-steal/index.md +20 -0
  67. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/k5vh8/a83qu/index.md +18 -0
  68. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/k5vh8/from-seneca-5hibo/index.md +21 -0
  69. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/kan-qi-lai-bi-jiao-ku-de-gong-si-men/_index.md +41 -0
  70. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/l2m7y/_index.md +29 -0
  71. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/lan-ya-yao-kong-qi-chuang-shang-yue-du-de-fan-ye-shen-qi/_index.md +57 -0
  72. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/mynoise-for-rainy-afternoons/_index.md +30 -0
  73. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/n09le/_index.md +23 -0
  74. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/ni-fu-jin-de-wei-ji-bai-ke-tiao-mu/_index.md +42 -0
  75. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/nts-archives-are-good-cleaning-music/_index.md +30 -0
  76. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/qgfcu/_index.md +32 -0
  77. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/qgfcu/c91j0/index.md +18 -0
  78. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/qgfcu/qyucy/index.md +18 -0
  79. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/qgfcu/wsgck/index.md +18 -0
  80. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/rain-makes-my-neighborhood-look-better/_index.md +46 -0
  81. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/reading-notes/_index.md +12 -0
  82. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/s4r3e/_index.md +25 -0
  83. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/serious-eats-on-tomato-and-egg-soup/_index.md +30 -0
  84. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/te812/_index.md +44 -0
  85. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/te812/cxiu6/index.md +18 -0
  86. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/te812/t77ms/index.md +18 -0
  87. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/te812/the-soup-trick-i-always-forget/index.md +20 -0
  88. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/telk3/_index.md +30 -0
  89. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/telk3/from-thoreau-pawt2/index.md +21 -0
  90. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/the-five-minute-reset-is-still-the-best-habit-i-have/_index.md +36 -0
  91. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/the-hallway-light-took-12-minutes-and-3-months/_index.md +32 -0
  92. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/the-recurse-center-manual-is-weirdly-calming/_index.md +30 -0
  93. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/tiny-projects/_index.md +12 -0
  94. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/tong-wang-xing-fu-zhi-lu/_index.md +68 -0
  95. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/tou-ma-yan-jiang-ju-le-bu-chu-ti-yan/_index.md +62 -0
  96. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/useful-links/_index.md +12 -0
  97. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/weekend-notes/_index.md +12 -0
  98. package/src/__tests__/fixtures/releases/0.8.1/site-export/content/what-i-actually-use-my-notebook-for/_index.md +52 -0
  99. package/src/__tests__/fixtures/releases/0.8.1/site-export/data/jant.toml +124 -0
  100. package/src/__tests__/fixtures/releases/0.8.1/site-export/hugo.toml +45 -0
  101. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/_redirects +25 -0
  102. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/c1185ba312ca-med_01kn8jtq3penf98tfq4gzmh9g9.png +0 -0
  103. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01kn8jtx8qenf98tm9ahxr48sw.webp +0 -0
  104. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01kn8jv0jdenf98tp6qr9zgjjc.webp +0 -0
  105. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01kn8jv452enf98trbkwrvhvgd.webp +0 -0
  106. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01kn8jvb16enf98txp7p0pf5ge.webp +0 -0
  107. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01kn8jve5nenf98tzap11gpxzr.webp +0 -0
  108. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01kn8jvq58enf98v538w5vsqp4.webp +0 -0
  109. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01kn8jvsaeenf98v6ct4gjzppc.webp +0 -0
  110. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01kn8jw26cenf98vc7k0ppz5k8.webp +0 -0
  111. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01m313q1hme4e8cmby77dn66yy.webp +0 -0
  112. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01m313q2w7e4e8cmc20036yh66.webp +0 -0
  113. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01m313q7d2e4e8cmdeqjmyafby.webp +0 -0
  114. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01m313q887e4e8cmdjssych7yh.webp +0 -0
  115. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01m3167jx2f6ct88pkz45j3ycp-poster.webp +0 -0
  116. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01m3167jx2f6ct88pkz45j3ycp.mp4 +0 -0
  117. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01m3167mbdf6ct88pr4ga1b9kf-poster.webp +0 -0
  118. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01m3167mbdf6ct88pr4ga1b9kf.mp4 +0 -0
  119. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01m3167nsvf6ct88q1anhz4svb-poster.webp +0 -0
  120. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01m3167nsvf6ct88q1anhz4svb.mp4 +0 -0
  121. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01m3167qaxf6ct88qfndwzxx83-poster.webp +0 -0
  122. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01m3167qaxf6ct88qfndwzxx83.mp4 +0 -0
  123. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01m3167sm0f6ct88qw5brtsgcw.webp +0 -0
  124. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01m3167tf8f6ct88r169s51j49.webp +0 -0
  125. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01m3167vaaf6ct88rbx5ztenwb.webp +0 -0
  126. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01m3167w51f6ct88rp19pybkw1.webp +0 -0
  127. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01m3167x0nf6ct88rzajb84tw3.webp +0 -0
  128. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01m3167xxbf6ct88s5t2300bjk.webp +0 -0
  129. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01m3167yq5f6ct88s9pjwt5fxg.webp +0 -0
  130. package/src/__tests__/fixtures/releases/0.8.1/site-export/static/media/med_01m3167zg4f6ct88sge8jp28ja.webp +0 -0
  131. package/src/__tests__/fixtures/releases/0.8.1/site-export/themes/jant/static/apple-touch-icon.png +0 -0
  132. package/src/__tests__/fixtures/releases/0.8.1/site-export/themes/jant/static/custom.css +0 -0
  133. package/src/__tests__/fixtures/releases/0.8.1/site-export/themes/jant/static/favicon.ico +0 -0
  134. package/src/__tests__/fixtures/releases/0.8.1/site-export/wrangler.jsonc +24 -0
  135. package/src/__tests__/fixtures/releases/0.8.1/snapshot/db.sql +322 -0
  136. package/src/__tests__/fixtures/releases/0.8.1/snapshot/meta.json +11 -0
  137. package/src/__tests__/fixtures/releases/0.9.0/site-export/README.md +130 -0
  138. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/2thjq/_index.md +25 -0
  139. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/2u5e5/_index.md +35 -0
  140. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/41q27/0x4nv/index.md +18 -0
  141. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/41q27/_index.md +44 -0
  142. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/41q27/faqyt/index.md +30 -0
  143. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/41q27/the-potting-mix-guide-i-keep-rereading/index.md +20 -0
  144. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/5kayp/_index.md +23 -0
  145. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/5ynfs/_index.md +31 -0
  146. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/5ynfs/hu597/index.md +21 -0
  147. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/_index.md +5 -0
  148. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/a-night-heron-field-guide-for-my-walk-folder/_index.md +31 -0
  149. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/a-quiet-saturday-after-a-busy-week/_index.md +36 -0
  150. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/archive/_index.md +8 -0
  151. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/are-na-is-the-only-bookmark-pile-i-still-revisit/_index.md +30 -0
  152. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/bought-too-many-lemons-again/_index.md +37 -0
  153. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/city-walks/_index.md +12 -0
  154. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/cleanshot-for-screenshots-ocr-and-screen-recording-on-the-mac/_index.md +33 -0
  155. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/cleanshotmac-shang-de-jie-tu-ocr-lu-ping-gong-ju/_index.md +32 -0
  156. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/co344/_index.md +25 -0
  157. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/collections/_index.md +5 -0
  158. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/current-tea-rotation/_index.md +34 -0
  159. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/derek-sivers-still-writes-the-kind-of-internet-i-want-more-of/_index.md +30 -0
  160. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/desk-but-better/_index.md +25 -0
  161. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/e0kcg/_index.md +22 -0
  162. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/egi3c/_index.md +24 -0
  163. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/evf9j/_index.md +152 -0
  164. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/featured/_index.md +8 -0
  165. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/from-basho/_index.md +25 -0
  166. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/from-epictetus/_index.md +25 -0
  167. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/from-marcus-aurelius/_index.md +25 -0
  168. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/from-seneca/_index.md +26 -0
  169. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/from-thoreau/_index.md +25 -0
  170. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/gkbvv/2cl6d/index.md +18 -0
  171. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/gkbvv/3zqv7/index.md +30 -0
  172. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/gkbvv/5oxsv/index.md +18 -0
  173. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/gkbvv/_index.md +39 -0
  174. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/gwob9/_index.md +25 -0
  175. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/home-cooking/_index.md +12 -0
  176. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/hz729/_index.md +24 -0
  177. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/inaturalist-ai-zi-ran-she-qu/_index.md +44 -0
  178. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/j4v0q/_index.md +35 -0
  179. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/k278t/_index.md +25 -0
  180. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/k4eee/_index.md +22 -0
  181. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/k5vh8/_index.md +32 -0
  182. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/k5vh8/a-reading-log-idea-i-might-steal/index.md +20 -0
  183. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/k5vh8/a83qu/index.md +18 -0
  184. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/k5vh8/from-seneca-5hibo/index.md +21 -0
  185. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/kan-qi-lai-bi-jiao-ku-de-gong-si-men/_index.md +41 -0
  186. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/l2m7y/_index.md +29 -0
  187. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/lan-ya-yao-kong-qi-chuang-shang-yue-du-de-fan-ye-shen-qi/_index.md +57 -0
  188. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/mynoise-for-rainy-afternoons/_index.md +30 -0
  189. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/n09le/_index.md +23 -0
  190. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/ni-fu-jin-de-wei-ji-bai-ke-tiao-mu/_index.md +42 -0
  191. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/nts-archives-are-good-cleaning-music/_index.md +30 -0
  192. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/qgfcu/_index.md +32 -0
  193. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/qgfcu/c91j0/index.md +18 -0
  194. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/qgfcu/qyucy/index.md +18 -0
  195. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/qgfcu/wsgck/index.md +18 -0
  196. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/rain-makes-my-neighborhood-look-better/_index.md +46 -0
  197. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/reading-notes/_index.md +12 -0
  198. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/s4r3e/_index.md +25 -0
  199. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/serious-eats-on-tomato-and-egg-soup/_index.md +30 -0
  200. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/te812/_index.md +44 -0
  201. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/te812/cxiu6/index.md +18 -0
  202. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/te812/t77ms/index.md +18 -0
  203. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/te812/the-soup-trick-i-always-forget/index.md +20 -0
  204. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/telk3/_index.md +30 -0
  205. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/telk3/from-thoreau-pawt2/index.md +21 -0
  206. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/the-five-minute-reset-is-still-the-best-habit-i-have/_index.md +36 -0
  207. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/the-hallway-light-took-12-minutes-and-3-months/_index.md +32 -0
  208. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/the-recurse-center-manual-is-weirdly-calming/_index.md +30 -0
  209. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/tiny-projects/_index.md +12 -0
  210. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/tong-wang-xing-fu-zhi-lu/_index.md +68 -0
  211. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/tou-ma-yan-jiang-ju-le-bu-chu-ti-yan/_index.md +62 -0
  212. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/useful-links/_index.md +12 -0
  213. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/weekend-notes/_index.md +12 -0
  214. package/src/__tests__/fixtures/releases/0.9.0/site-export/content/what-i-actually-use-my-notebook-for/_index.md +52 -0
  215. package/src/__tests__/fixtures/releases/0.9.0/site-export/data/jant.toml +124 -0
  216. package/src/__tests__/fixtures/releases/0.9.0/site-export/hugo.toml +45 -0
  217. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/_redirects +25 -0
  218. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/46bc15f2b4e1-med_01kn8jtq3penf98tfq4gzmh9g9.png +0 -0
  219. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01kn8jtx8qenf98tm9ahxr48sw.webp +0 -0
  220. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01kn8jv0jdenf98tp6qr9zgjjc.webp +0 -0
  221. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01kn8jv452enf98trbkwrvhvgd.webp +0 -0
  222. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01kn8jvb16enf98txp7p0pf5ge.webp +0 -0
  223. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01kn8jve5nenf98tzap11gpxzr.webp +0 -0
  224. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01kn8jvq58enf98v538w5vsqp4.webp +0 -0
  225. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01kn8jvsaeenf98v6ct4gjzppc.webp +0 -0
  226. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01kn8jw26cenf98vc7k0ppz5k8.webp +0 -0
  227. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01m313q1hme4e8cmby77dn66yy.webp +0 -0
  228. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01m313q2w7e4e8cmc20036yh66.webp +0 -0
  229. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01m313q7d2e4e8cmdeqjmyafby.webp +0 -0
  230. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01m313q887e4e8cmdjssych7yh.webp +0 -0
  231. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01m3167jx2f6ct88pkz45j3ycp-poster.webp +0 -0
  232. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01m3167jx2f6ct88pkz45j3ycp.mp4 +0 -0
  233. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01m3167mbdf6ct88pr4ga1b9kf-poster.webp +0 -0
  234. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01m3167mbdf6ct88pr4ga1b9kf.mp4 +0 -0
  235. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01m3167nsvf6ct88q1anhz4svb-poster.webp +0 -0
  236. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01m3167nsvf6ct88q1anhz4svb.mp4 +0 -0
  237. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01m3167qaxf6ct88qfndwzxx83-poster.webp +0 -0
  238. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01m3167qaxf6ct88qfndwzxx83.mp4 +0 -0
  239. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01m3167sm0f6ct88qw5brtsgcw.webp +0 -0
  240. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01m3167tf8f6ct88r169s51j49.webp +0 -0
  241. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01m3167vaaf6ct88rbx5ztenwb.webp +0 -0
  242. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01m3167w51f6ct88rp19pybkw1.webp +0 -0
  243. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01m3167x0nf6ct88rzajb84tw3.webp +0 -0
  244. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01m3167xxbf6ct88s5t2300bjk.webp +0 -0
  245. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01m3167yq5f6ct88s9pjwt5fxg.webp +0 -0
  246. package/src/__tests__/fixtures/releases/0.9.0/site-export/static/media/med_01m3167zg4f6ct88sge8jp28ja.webp +0 -0
  247. package/src/__tests__/fixtures/releases/0.9.0/site-export/themes/jant/static/apple-touch-icon.png +0 -0
  248. package/src/__tests__/fixtures/releases/0.9.0/site-export/themes/jant/static/custom.css +0 -0
  249. package/src/__tests__/fixtures/releases/0.9.0/site-export/themes/jant/static/favicon.ico +0 -0
  250. package/src/__tests__/fixtures/releases/0.9.0/site-export/wrangler.jsonc +24 -0
  251. package/src/__tests__/fixtures/releases/0.9.0/snapshot/db.sql +322 -0
  252. package/src/__tests__/fixtures/releases/0.9.0/snapshot/meta.json +11 -0
  253. package/src/__tests__/fixtures/releases/0.9.1/site-export/README.md +130 -0
  254. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/2thjq/_index.md +25 -0
  255. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/2u5e5/_index.md +35 -0
  256. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/41q27/0x4nv/index.md +18 -0
  257. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/41q27/_index.md +44 -0
  258. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/41q27/faqyt/index.md +30 -0
  259. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/41q27/the-potting-mix-guide-i-keep-rereading/index.md +20 -0
  260. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/5kayp/_index.md +23 -0
  261. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/5ynfs/_index.md +31 -0
  262. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/5ynfs/hu597/index.md +21 -0
  263. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/_index.md +5 -0
  264. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/a-night-heron-field-guide-for-my-walk-folder/_index.md +31 -0
  265. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/a-quiet-saturday-after-a-busy-week/_index.md +36 -0
  266. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/archive/_index.md +8 -0
  267. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/are-na-is-the-only-bookmark-pile-i-still-revisit/_index.md +30 -0
  268. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/bought-too-many-lemons-again/_index.md +37 -0
  269. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/city-walks/_index.md +12 -0
  270. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/cleanshot-for-screenshots-ocr-and-screen-recording-on-the-mac/_index.md +33 -0
  271. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/cleanshotmac-shang-de-jie-tu-ocr-lu-ping-gong-ju/_index.md +32 -0
  272. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/co344/_index.md +25 -0
  273. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/collections/_index.md +5 -0
  274. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/current-tea-rotation/_index.md +34 -0
  275. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/derek-sivers-still-writes-the-kind-of-internet-i-want-more-of/_index.md +30 -0
  276. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/desk-but-better/_index.md +25 -0
  277. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/e0kcg/_index.md +22 -0
  278. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/egi3c/_index.md +24 -0
  279. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/evf9j/_index.md +152 -0
  280. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/featured/_index.md +8 -0
  281. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/from-basho/_index.md +25 -0
  282. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/from-epictetus/_index.md +25 -0
  283. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/from-marcus-aurelius/_index.md +25 -0
  284. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/from-seneca/_index.md +26 -0
  285. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/from-thoreau/_index.md +25 -0
  286. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/gkbvv/2cl6d/index.md +18 -0
  287. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/gkbvv/3zqv7/index.md +30 -0
  288. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/gkbvv/5oxsv/index.md +18 -0
  289. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/gkbvv/_index.md +39 -0
  290. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/gwob9/_index.md +25 -0
  291. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/home-cooking/_index.md +12 -0
  292. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/hz729/_index.md +24 -0
  293. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/inaturalist-ai-zi-ran-she-qu/_index.md +44 -0
  294. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/j4v0q/_index.md +35 -0
  295. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/k278t/_index.md +25 -0
  296. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/k4eee/_index.md +22 -0
  297. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/k5vh8/_index.md +32 -0
  298. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/k5vh8/a-reading-log-idea-i-might-steal/index.md +20 -0
  299. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/k5vh8/a83qu/index.md +18 -0
  300. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/k5vh8/from-seneca-5hibo/index.md +21 -0
  301. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/kan-qi-lai-bi-jiao-ku-de-gong-si-men/_index.md +41 -0
  302. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/l2m7y/_index.md +29 -0
  303. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/lan-ya-yao-kong-qi-chuang-shang-yue-du-de-fan-ye-shen-qi/_index.md +57 -0
  304. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/mynoise-for-rainy-afternoons/_index.md +30 -0
  305. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/n09le/_index.md +23 -0
  306. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/ni-fu-jin-de-wei-ji-bai-ke-tiao-mu/_index.md +42 -0
  307. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/nts-archives-are-good-cleaning-music/_index.md +30 -0
  308. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/qgfcu/_index.md +32 -0
  309. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/qgfcu/c91j0/index.md +18 -0
  310. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/qgfcu/qyucy/index.md +18 -0
  311. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/qgfcu/wsgck/index.md +18 -0
  312. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/rain-makes-my-neighborhood-look-better/_index.md +46 -0
  313. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/reading-notes/_index.md +12 -0
  314. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/s4r3e/_index.md +25 -0
  315. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/serious-eats-on-tomato-and-egg-soup/_index.md +30 -0
  316. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/te812/_index.md +44 -0
  317. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/te812/cxiu6/index.md +18 -0
  318. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/te812/t77ms/index.md +18 -0
  319. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/te812/the-soup-trick-i-always-forget/index.md +20 -0
  320. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/telk3/_index.md +30 -0
  321. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/telk3/from-thoreau-pawt2/index.md +21 -0
  322. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/the-five-minute-reset-is-still-the-best-habit-i-have/_index.md +36 -0
  323. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/the-hallway-light-took-12-minutes-and-3-months/_index.md +32 -0
  324. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/the-recurse-center-manual-is-weirdly-calming/_index.md +30 -0
  325. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/tiny-projects/_index.md +12 -0
  326. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/tong-wang-xing-fu-zhi-lu/_index.md +68 -0
  327. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/tou-ma-yan-jiang-ju-le-bu-chu-ti-yan/_index.md +62 -0
  328. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/useful-links/_index.md +12 -0
  329. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/weekend-notes/_index.md +12 -0
  330. package/src/__tests__/fixtures/releases/0.9.1/site-export/content/what-i-actually-use-my-notebook-for/_index.md +52 -0
  331. package/src/__tests__/fixtures/releases/0.9.1/site-export/data/jant.toml +124 -0
  332. package/src/__tests__/fixtures/releases/0.9.1/site-export/hugo.toml +45 -0
  333. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/_redirects +25 -0
  334. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/c0ef5dbd2a2d-med_01kn8jtq3penf98tfq4gzmh9g9.png +0 -0
  335. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01kn8jtx8qenf98tm9ahxr48sw.webp +0 -0
  336. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01kn8jv0jdenf98tp6qr9zgjjc.webp +0 -0
  337. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01kn8jv452enf98trbkwrvhvgd.webp +0 -0
  338. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01kn8jvb16enf98txp7p0pf5ge.webp +0 -0
  339. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01kn8jve5nenf98tzap11gpxzr.webp +0 -0
  340. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01kn8jvq58enf98v538w5vsqp4.webp +0 -0
  341. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01kn8jvsaeenf98v6ct4gjzppc.webp +0 -0
  342. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01kn8jw26cenf98vc7k0ppz5k8.webp +0 -0
  343. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01m313q1hme4e8cmby77dn66yy.webp +0 -0
  344. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01m313q2w7e4e8cmc20036yh66.webp +0 -0
  345. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01m313q7d2e4e8cmdeqjmyafby.webp +0 -0
  346. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01m313q887e4e8cmdjssych7yh.webp +0 -0
  347. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01m3167jx2f6ct88pkz45j3ycp-poster.webp +0 -0
  348. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01m3167jx2f6ct88pkz45j3ycp.mp4 +0 -0
  349. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01m3167mbdf6ct88pr4ga1b9kf-poster.webp +0 -0
  350. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01m3167mbdf6ct88pr4ga1b9kf.mp4 +0 -0
  351. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01m3167nsvf6ct88q1anhz4svb-poster.webp +0 -0
  352. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01m3167nsvf6ct88q1anhz4svb.mp4 +0 -0
  353. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01m3167qaxf6ct88qfndwzxx83-poster.webp +0 -0
  354. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01m3167qaxf6ct88qfndwzxx83.mp4 +0 -0
  355. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01m3167sm0f6ct88qw5brtsgcw.webp +0 -0
  356. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01m3167tf8f6ct88r169s51j49.webp +0 -0
  357. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01m3167vaaf6ct88rbx5ztenwb.webp +0 -0
  358. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01m3167w51f6ct88rp19pybkw1.webp +0 -0
  359. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01m3167x0nf6ct88rzajb84tw3.webp +0 -0
  360. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01m3167xxbf6ct88s5t2300bjk.webp +0 -0
  361. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01m3167yq5f6ct88s9pjwt5fxg.webp +0 -0
  362. package/src/__tests__/fixtures/releases/0.9.1/site-export/static/media/med_01m3167zg4f6ct88sge8jp28ja.webp +0 -0
  363. package/src/__tests__/fixtures/releases/0.9.1/site-export/themes/jant/static/apple-touch-icon.png +0 -0
  364. package/src/__tests__/fixtures/releases/0.9.1/site-export/themes/jant/static/custom.css +0 -0
  365. package/src/__tests__/fixtures/releases/0.9.1/site-export/themes/jant/static/favicon.ico +0 -0
  366. package/src/__tests__/fixtures/releases/0.9.1/site-export/wrangler.jsonc +24 -0
  367. package/src/__tests__/fixtures/releases/0.9.1/snapshot/db.sql +322 -0
  368. package/src/__tests__/fixtures/releases/0.9.1/snapshot/meta.json +11 -0
  369. package/src/__tests__/helpers/app.ts +5 -1
  370. package/src/__tests__/helpers/cursor-walk.ts +2 -1
  371. package/src/__tests__/import-site-command.test.ts +2 -0
  372. package/src/__tests__/theme-docs.test.ts +24 -2
  373. package/src/__tests__/url-params-docs.test.ts +177 -0
  374. package/src/app.tsx +5 -59
  375. package/src/client/components/__tests__/jant-collection-directory.test.ts +1 -1
  376. package/src/client/components/__tests__/jant-smart-collection-dialog.test.ts +19 -25
  377. package/src/client/components/__tests__/jant-text-preview.test.ts +20 -25
  378. package/src/client/components/collection-manager-types.ts +1 -1
  379. package/src/client/components/jant-collection-directory.ts +2 -2
  380. package/src/client/components/jant-smart-collection-dialog.ts +6 -9
  381. package/src/client/components/jant-text-preview.ts +23 -29
  382. package/src/client/components/smart-collection-dialog-types.ts +1 -1
  383. package/src/client/compose-bridge.ts +6 -2
  384. package/src/db/__tests__/migration-rehearsal.test.ts +45 -31
  385. package/src/db/__tests__/schema-parity.test.ts +100 -0
  386. package/src/db/rehearsal-fixtures/pg-v0.3.39.json +159 -0
  387. package/src/db/rehearsal-fixtures/pg-v0.3.39.sql +78 -0
  388. package/src/db/rehearsal-fixtures/{demo-current.json → pinned-reply-memberships.json} +2 -2
  389. package/src/db/rehearsal-fixtures/{demo-current.sql → pinned-reply-memberships.sql} +6 -3
  390. package/src/db/rehearsal-fixtures/v0.3.39.json +170 -0
  391. package/src/db/rehearsal-fixtures/v0.3.39.sql +78 -0
  392. package/src/i18n/locales/public/en.po +10 -10
  393. package/src/i18n/locales/public/en.ts +1 -1
  394. package/src/i18n/locales/public/zh-Hans.po +10 -10
  395. package/src/i18n/locales/public/zh-Hans.ts +1 -1
  396. package/src/i18n/locales/public/zh-Hant.po +10 -10
  397. package/src/i18n/locales/public/zh-Hant.ts +1 -1
  398. package/src/lib/__tests__/constants.test.ts +37 -0
  399. package/src/lib/__tests__/discover.test.ts +24 -0
  400. package/src/{middleware → lib}/__tests__/rate-limit.test.ts +41 -39
  401. package/src/lib/__tests__/theme.test.ts +38 -23
  402. package/src/lib/api-collections.ts +173 -0
  403. package/src/lib/api-custom-urls.ts +44 -0
  404. package/src/lib/api-media.ts +66 -15
  405. package/src/lib/api-nav-items.ts +66 -0
  406. package/src/lib/api-post-input.ts +123 -0
  407. package/src/lib/api-posts.ts +124 -46
  408. package/src/lib/api-public-posts.ts +1 -14
  409. package/src/lib/api-search.ts +4 -0
  410. package/src/lib/collection-sort.ts +71 -0
  411. package/src/lib/constants.ts +17 -0
  412. package/src/lib/discover.ts +34 -0
  413. package/src/lib/errors.ts +0 -7
  414. package/src/lib/post-list-cursor.ts +9 -3
  415. package/src/lib/rate-limit.ts +58 -0
  416. package/src/lib/schemas.ts +26 -2
  417. package/src/lib/storage.ts +19 -0
  418. package/src/lib/theme.ts +27 -22
  419. package/src/middleware/__tests__/public-content-access.test.ts +0 -34
  420. package/src/middleware/config.ts +1 -5
  421. package/src/middleware/cors.ts +1 -8
  422. package/src/middleware/error-handler.ts +33 -3
  423. package/src/middleware/public-content-access.ts +0 -25
  424. package/src/routes/api/__tests__/collections.test.ts +36 -6
  425. package/src/routes/api/__tests__/custom-urls.test.ts +93 -0
  426. package/src/routes/api/__tests__/error-shape.test.ts +109 -0
  427. package/src/routes/api/__tests__/mcp.test.ts +213 -4
  428. package/src/routes/api/__tests__/{upload.test.ts → media.test.ts} +18 -18
  429. package/src/routes/api/__tests__/nav-items.test.ts +2 -2
  430. package/src/routes/api/__tests__/posts.test.ts +4 -1
  431. package/src/routes/api/__tests__/public-access.test.ts +42 -37
  432. package/src/routes/api/__tests__/search.test.ts +134 -52
  433. package/src/routes/api/collections.ts +27 -24
  434. package/src/routes/api/custom-urls.ts +28 -41
  435. package/src/routes/api/github-sync.tsx +2 -2
  436. package/src/routes/api/internal/sites.ts +8 -13
  437. package/src/routes/api/internal/uploads.ts +2 -7
  438. package/src/routes/api/mcp.ts +3 -0
  439. package/src/routes/api/media.ts +86 -0
  440. package/src/routes/api/nav-items.ts +11 -10
  441. package/src/routes/api/posts.ts +23 -82
  442. package/src/routes/api/public/__tests__/posts.test.ts +51 -782
  443. package/src/routes/api/public/__tests__/threads-collections.test.ts +310 -0
  444. package/src/routes/api/public/__tests__/threads.test.ts +159 -44
  445. package/src/routes/api/public/posts.ts +6 -120
  446. package/src/routes/api/search.ts +32 -17
  447. package/src/routes/api/settings.ts +18 -18
  448. package/src/routes/api/smart-collections.ts +40 -17
  449. package/src/routes/api/telegram.ts +5 -8
  450. package/src/routes/api/upload.ts +29 -253
  451. package/src/routes/api/uploads.ts +12 -53
  452. package/src/routes/auth/__tests__/setup-discover.test.ts +29 -1
  453. package/src/routes/auth/__tests__/setup-page.test.tsx +59 -1
  454. package/src/routes/auth/setup.tsx +48 -9
  455. package/src/routes/dash/__tests__/font-theme.test.ts +2 -2
  456. package/src/routes/pages/__tests__/archive-params.test.ts +3 -3
  457. package/src/routes/pages/__tests__/collection-routing.test.ts +41 -0
  458. package/src/routes/pages/__tests__/language-routing.test.ts +8 -8
  459. package/src/routes/pages/__tests__/search.test.ts +119 -0
  460. package/src/routes/pages/__tests__/smart-collection.test.ts +37 -0
  461. package/src/routes/pages/__tests__/text-preview-partial.test.ts +140 -0
  462. package/src/routes/pages/brand.tsx +1 -1
  463. package/src/routes/pages/collection.tsx +7 -7
  464. package/src/routes/pages/page.tsx +7 -14
  465. package/src/routes/pages/partials.tsx +34 -0
  466. package/src/routes/pages/search.tsx +24 -5
  467. package/src/routes/pages/smart-collection.tsx +19 -27
  468. package/src/routes/pages/theme-sample.tsx +2 -4
  469. package/src/services/__tests__/media.test.ts +0 -38
  470. package/src/services/__tests__/search.test.ts +211 -0
  471. package/src/services/custom-url.ts +108 -5
  472. package/src/services/index.ts +6 -0
  473. package/src/services/mcp.ts +102 -184
  474. package/src/services/media.ts +0 -45
  475. package/src/services/search.ts +77 -66
  476. package/src/services/site-admin.ts +1 -5
  477. package/src/services/text-attachment.ts +94 -0
  478. package/src/styles/tokens.css +14 -20
  479. package/src/types/config.ts +5 -2
  480. package/src/types/constants.ts +11 -0
  481. package/src/types/props.ts +9 -12
  482. package/src/ui/color-themes.ts +0 -4
  483. package/src/ui/layouts/BaseLayout.tsx +2 -2
  484. package/src/ui/pages/CollectionPage.tsx +5 -4
  485. package/src/ui/pages/SearchPage.tsx +17 -1
  486. package/src/ui/pages/SmartCollectionPage.tsx +5 -4
  487. package/dist/client/_assets/client-S8oryJ0m.js +0 -295
  488. package/src/db/rehearsal-fixtures/pg-demo-current.json +0 -55
  489. package/src/db/rehearsal-fixtures/pg-demo-current.sql +0 -431
  490. package/src/middleware/deprecation.ts +0 -48
  491. package/src/middleware/rate-limit.ts +0 -54
  492. package/src/routes/api/public/__tests__/archive.test.ts +0 -734
  493. package/src/routes/api/public/archive.ts +0 -135
package/src/lib/theme.ts CHANGED
@@ -6,7 +6,6 @@
6
6
 
7
7
  import type { ColorTheme } from "../ui/color-themes.js";
8
8
  import { BUILTIN_COLOR_THEMES } from "../ui/color-themes.js";
9
- import type { ThemeMode } from "../types/config.js";
10
9
 
11
10
  const DEFAULT_THEME_BROWSER_COLORS = {
12
11
  light: "oklch(1 0 0)",
@@ -147,27 +146,36 @@ export function getThemeBrowserColors(theme?: ColorTheme): {
147
146
  * Build a `<style>` CSS string from a color theme and optional cssVariables overlay.
148
147
  *
149
148
  * Priority (lowest → highest):
150
- * BaseCoat defaults → selected theme → cssVariables
149
+ * BaseCoat and token defaults → selected theme → cssVariables → custom CSS
150
+ *
151
+ * Every Jant rule that sets a theme variable sits on one of two rungs, and
152
+ * source order breaks ties within a rung:
153
+ *
154
+ * - light, `:root` (0,1,0): the defaults in the site stylesheet, then this
155
+ * block, then the author's custom CSS;
156
+ * - dark, `:root[data-theme-mode="dark"]` or, under
157
+ * `prefers-color-scheme: dark`, `:root:not([data-theme-mode="light"])`
158
+ * (0,2,0): the dark defaults, then this block's dark part, then custom CSS
159
+ * written with the same selectors.
160
+ *
161
+ * Every page links the stylesheet before the inline theme and custom CSS, so
162
+ * the theme beats the defaults and the author's custom CSS beats the theme,
163
+ * as docs/theming.md promises. A dark default outranks a light theme value,
164
+ * so a theme that leaves a variable out of its dark block gets the dark
165
+ * default rather than its light value.
151
166
  *
152
167
  * @param theme - The active color theme (undefined = no theme overrides)
153
- * @param cssVariables - Extra CSS variable overrides
168
+ * @param cssVariables - Extra CSS variable overrides, applied in both modes
154
169
  * @returns CSS string to inject in `<head>`, or empty string if nothing to inject
155
170
  *
156
- * Uses `:root:root` for light mode and `@media (prefers-color-scheme: dark)`
157
- * with `:root:root` for dark mode, giving higher specificity than BaseCoat
158
- * defaults (`:root`). This ensures theme overrides win regardless of source
159
- * order — important because Vite dev mode injects CSS as `<style>` tags
160
- * after the theme `<style>`.
161
- *
162
171
  * @example
163
172
  * ```typescript
164
- * const css = buildThemeStyle(blueTheme, "auto", { "--radius": "0.5rem" });
165
- * // => ":root:root { ... }\n@media (prefers-color-scheme: dark) { :root:root { ... } }"
173
+ * const css = buildThemeStyle(blueTheme, { "--radius": "0.5rem" });
174
+ * // => ':root { ... }\n:root[data-theme-mode="dark"] { ... }\n@media (prefers-color-scheme: dark) { ... }'
166
175
  * ```
167
176
  */
168
177
  export function buildThemeStyle(
169
178
  theme: ColorTheme | undefined,
170
- themeMode: ThemeMode = "auto",
171
179
  cssVariables?: Record<string, string>,
172
180
  ): string {
173
181
  const lightVars: Record<string, string> = {
@@ -190,8 +198,7 @@ export function buildThemeStyle(
190
198
  const declarations = Object.entries(lightVars)
191
199
  .map(([k, v]) => ` ${k}: ${v};`)
192
200
  .join("\n");
193
- // :root:root has specificity (0,0,2) > BaseCoat's :root (0,0,1)
194
- parts.push(`:root:root {\n color-scheme: light;\n${declarations}\n}`);
201
+ parts.push(`:root {\n color-scheme: light;\n${declarations}\n}`);
195
202
  }
196
203
 
197
204
  if (hasDark) {
@@ -199,14 +206,12 @@ export function buildThemeStyle(
199
206
  .map(([k, v]) => ` ${k}: ${v};`)
200
207
  .join("\n");
201
208
  const darkBlock = ` color-scheme: dark;\n${declarations}`;
202
- if (themeMode === "dark") {
203
- parts.push(`:root:root {\n${darkBlock}\n}`);
204
- } else {
205
- parts.push(`:root:root[data-theme-mode="dark"] {\n${darkBlock}\n}`);
206
- parts.push(
207
- `@media (prefers-color-scheme: dark) {\n :root:root:not([data-theme-mode="light"]) {\n${darkBlock}\n }\n}`,
208
- );
209
- }
209
+ // A site set to dark carries `data-theme-mode="dark"`; one following the
210
+ // reader's system preference takes the media query unless set to light.
211
+ parts.push(`:root[data-theme-mode="dark"] {\n${darkBlock}\n}`);
212
+ parts.push(
213
+ `@media (prefers-color-scheme: dark) {\n :root:not([data-theme-mode="light"]) {\n${darkBlock}\n }\n}`,
214
+ );
210
215
  }
211
216
 
212
217
  return parts.join("\n");
@@ -2,7 +2,6 @@ import { describe, expect, it } from "vitest";
2
2
  import { createTestApp } from "../../__tests__/helpers/app.js";
3
3
  import { isRssFeedPath } from "../../lib/feed-path.js";
4
4
  import {
5
- requirePublicApiAccess,
6
5
  requirePublicApiEnabled,
7
6
  requireRssFeedsEnabled,
8
7
  } from "../public-content-access.js";
@@ -33,16 +32,6 @@ describe("public content access policies", () => {
33
32
  expect(isRssFeedPath(path)).toBe(false);
34
33
  });
35
34
 
36
- it("requires authentication for JSON reads when public access is off", async () => {
37
- const { app, services } = createTestApp({ authenticated: false });
38
- await services.settings.set("PUBLIC_API_ENABLED", "false");
39
- app.get("/api/data", requirePublicApiAccess(), (c) => c.json({ ok: true }));
40
-
41
- const response = await app.request("/api/data");
42
-
43
- expect(response.status).toBe(401);
44
- });
45
-
46
35
  it("returns 404 for the dedicated public API even with a session", async () => {
47
36
  const { app, services } = createTestApp({ authenticated: true });
48
37
  await services.settings.set("PUBLIC_API_ENABLED", "false");
@@ -55,29 +44,6 @@ describe("public content access policies", () => {
55
44
  expect(response.status).toBe(404);
56
45
  });
57
46
 
58
- it("preserves session access when public JSON reads are off", async () => {
59
- const { app, services } = createTestApp({ authenticated: true });
60
- await services.settings.set("PUBLIC_API_ENABLED", "false");
61
- app.get("/api/data", requirePublicApiAccess(), (c) => c.json({ ok: true }));
62
-
63
- const response = await app.request("/api/data");
64
-
65
- expect(response.status).toBe(200);
66
- });
67
-
68
- it("preserves Bearer-token access when public JSON reads are off", async () => {
69
- const { app, services } = createTestApp({ authenticated: false });
70
- await services.settings.set("PUBLIC_API_ENABLED", "false");
71
- const { plaintext } = await services.apiTokens.create("Test client");
72
- app.get("/api/data", requirePublicApiAccess(), (c) => c.json({ ok: true }));
73
-
74
- const response = await app.request("/api/data", {
75
- headers: { Authorization: `Bearer ${plaintext}` },
76
- });
77
-
78
- expect(response.status).toBe(200);
79
- });
80
-
81
47
  it("returns 404 for feed paths when feed publishing is off", async () => {
82
48
  const { app, services } = createTestApp();
83
49
  await services.settings.set("RSS_FEEDS_ENABLED", "false");
@@ -56,11 +56,7 @@ export function withConfig(): MiddlewareHandler<Env> {
56
56
  );
57
57
  const fontOverrides = fontTheme ? getFontThemeCssVariables(fontTheme) : {};
58
58
 
59
- const themeStyle = buildThemeStyle(
60
- activeTheme,
61
- appConfig.themeMode,
62
- fontOverrides,
63
- );
59
+ const themeStyle = buildThemeStyle(activeTheme, fontOverrides);
64
60
  c.set("themeStyle", themeStyle);
65
61
 
66
62
  await next();
@@ -39,14 +39,7 @@ export function apiCors(): MiddlewareHandler<Env> {
39
39
  origin: origins,
40
40
  allowMethods: ["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS"],
41
41
  allowHeaders: ["Content-Type", "Authorization", "MCP-Protocol-Version"],
42
- // `Deprecation` and `Link` are how a deprecated endpoint names its
43
- // replacement; a browser client can't read either unless exposed.
44
- exposeHeaders: [
45
- "Content-Type",
46
- "MCP-Protocol-Version",
47
- "Deprecation",
48
- "Link",
49
- ],
42
+ exposeHeaders: ["Content-Type", "MCP-Protocol-Version"],
50
43
  credentials: origins !== "*",
51
44
  maxAge: 86400,
52
45
  });
@@ -5,7 +5,7 @@
5
5
  * API routes receive JSON; page routes fall through to Hono defaults.
6
6
  */
7
7
 
8
- import type { ErrorHandler } from "hono";
8
+ import type { ErrorHandler, NotFoundHandler } from "hono";
9
9
  import type { ContentfulStatusCode } from "hono/utils/http-status";
10
10
  import type { Bindings } from "../types.js";
11
11
  import type { AppVariables } from "../types/app-context.js";
@@ -22,6 +22,13 @@ import { getRuntimeConfigurationErrorPage } from "../lib/startup-config.js";
22
22
 
23
23
  type Env = { Bindings: Bindings; Variables: AppVariables };
24
24
 
25
+ /** What every JSON caller gets for an error no handler expected. */
26
+ const INTERNAL_ERROR_BODY = {
27
+ error:
28
+ "The server hit an error it didn't expect. Try again; the server log has the details.",
29
+ code: "INTERNAL_ERROR",
30
+ };
31
+
25
32
  export const errorHandler: ErrorHandler<Env> = (err, c) => {
26
33
  // API routes: always return JSON
27
34
  if (c.req.path.startsWith("/api/")) {
@@ -41,7 +48,7 @@ export const errorHandler: ErrorHandler<Env> = (err, c) => {
41
48
  // Unknown API error
42
49
  // eslint-disable-next-line no-console -- Server error logging is intentional
43
50
  console.error("[Jant] Unhandled error:", err);
44
- return c.json({ error: "Something went wrong on our end" }, 500);
51
+ return c.json(INTERNAL_ERROR_BODY, 500);
45
52
  }
46
53
 
47
54
  // Datastar requests: return toast
@@ -67,7 +74,7 @@ export const errorHandler: ErrorHandler<Env> = (err, c) => {
67
74
  }
68
75
  // eslint-disable-next-line no-console -- Server error logging is intentional
69
76
  console.error("[Jant] Unhandled error:", err);
70
- return c.json({ error: "Something went wrong on our end" }, 500);
77
+ return c.json(INTERNAL_ERROR_BODY, 500);
71
78
  }
72
79
 
73
80
  // A suspended site: the host is real, so answer with a page that says so
@@ -97,3 +104,26 @@ export const errorHandler: ErrorHandler<Env> = (err, c) => {
97
104
  // Everything else: re-throw for Hono's default handling
98
105
  throw err;
99
106
  };
107
+
108
+ /**
109
+ * Answers a request no route matched, and every `c.notFound()`.
110
+ *
111
+ * `/api/*` gets the JSON error shape the API documents, so a client can read
112
+ * `code` the same way for a missing path as for a missing record. Pages keep
113
+ * Hono's plain 404.
114
+ *
115
+ * @example
116
+ * app.notFound(notFoundHandler);
117
+ */
118
+ export const notFoundHandler: NotFoundHandler<Env> = (c) => {
119
+ if (c.req.path.startsWith("/api/")) {
120
+ return c.json(
121
+ {
122
+ error: "Nothing here. Check the method and the path.",
123
+ code: "NOT_FOUND",
124
+ },
125
+ 404,
126
+ );
127
+ }
128
+ return c.text("404 Not Found", 404);
129
+ };
@@ -9,7 +9,6 @@ import type { MiddlewareHandler } from "hono";
9
9
  import type { Bindings } from "../types.js";
10
10
  import type { AppVariables } from "../types/app-context.js";
11
11
  import { isRssFeedPath } from "../lib/feed-path.js";
12
- import { requireAuthApi } from "./auth.js";
13
12
 
14
13
  type Env = { Bindings: Bindings; Variables: AppVariables };
15
14
 
@@ -39,30 +38,6 @@ export function requirePublicApiEnabled(): MiddlewareHandler<Env> {
39
38
  };
40
39
  }
41
40
 
42
- /**
43
- * Require normal authentication for shared JSON reads when public access is off.
44
- *
45
- * @returns Hono middleware that preserves session and Bearer-token access
46
- * @example
47
- * ```ts
48
- * app.get("/api/search", requirePublicApiAccess(), searchHandler);
49
- * ```
50
- */
51
- export function requirePublicApiAccess(): MiddlewareHandler<Env> {
52
- const requireAuthentication = requireAuthApi();
53
-
54
- return async (c, next) => {
55
- if (
56
- (c.req.method !== "GET" && c.req.method !== "HEAD") ||
57
- c.var.appConfig.publicApiEnabled
58
- ) {
59
- return next();
60
- }
61
-
62
- return requireAuthentication(c, next);
63
- };
64
- }
65
-
66
41
  /**
67
42
  * Return 404 for Atom endpoints when feed publishing is disabled.
68
43
  *
@@ -7,7 +7,7 @@ import { collectionsApiRoutes } from "../collections.js";
7
7
  describe("Collections API Routes", () => {
8
8
  describe("GET /api/collections", () => {
9
9
  it("returns empty list when no collections exist", async () => {
10
- const { app } = createTestApp();
10
+ const { app } = createTestApp({ authenticated: true });
11
11
  app.route("/api/collections", collectionsApiRoutes);
12
12
 
13
13
  const res = await app.request("/api/collections");
@@ -19,7 +19,7 @@ describe("Collections API Routes", () => {
19
19
  });
20
20
 
21
21
  it("returns collections with Thread counts and directory items", async () => {
22
- const { app, services } = createTestApp();
22
+ const { app, services } = createTestApp({ authenticated: true });
23
23
  app.route("/api/collections", collectionsApiRoutes);
24
24
 
25
25
  const col = await services.collections.create({
@@ -46,7 +46,7 @@ describe("Collections API Routes", () => {
46
46
  });
47
47
 
48
48
  it("returns smart collections with the same two measures", async () => {
49
- const { app, services } = createTestApp();
49
+ const { app, services } = createTestApp({ authenticated: true });
50
50
  app.route("/api/collections", collectionsApiRoutes);
51
51
 
52
52
  await services.smartCollections.create({
@@ -69,6 +69,36 @@ describe("Collections API Routes", () => {
69
69
  );
70
70
  });
71
71
 
72
+ it("counts private Threads for a Bearer token, as for a session", async () => {
73
+ const { app, services } = createTestApp();
74
+ app.route("/api/collections", collectionsApiRoutes);
75
+ const { plaintext } = await services.apiTokens.create("Test client");
76
+
77
+ const col = await services.collections.create({
78
+ slug: "journal",
79
+ title: "Journal",
80
+ });
81
+ await services.smartCollections.create({
82
+ slug: "notes",
83
+ title: "Notes",
84
+ selection: { format: "note" },
85
+ });
86
+ await services.posts.create({
87
+ format: "note",
88
+ bodyMarkdown: "private entry",
89
+ visibility: "private",
90
+ collectionIds: [col.id],
91
+ });
92
+
93
+ const res = await app.request("/api/collections", {
94
+ headers: { Authorization: `Bearer ${plaintext}` },
95
+ });
96
+ expect(res.status).toBe(200);
97
+ const body = await res.json();
98
+ expect(body.collections[0].threadCount).toBe(1);
99
+ expect(body.smartCollections[0].threadCount).toBe(1);
100
+ });
101
+
72
102
  it("returns divider labels", async () => {
73
103
  const { app, services } = createTestApp({ authenticated: true });
74
104
  app.route("/api/collections", collectionsApiRoutes);
@@ -133,7 +163,7 @@ describe("Collections API Routes", () => {
133
163
 
134
164
  describe("GET /api/collections/:id", () => {
135
165
  it("returns a collection by id", async () => {
136
- const { app, services } = createTestApp();
166
+ const { app, services } = createTestApp({ authenticated: true });
137
167
  app.route("/api/collections", collectionsApiRoutes);
138
168
 
139
169
  const col = await services.collections.create({
@@ -150,7 +180,7 @@ describe("Collections API Routes", () => {
150
180
  });
151
181
 
152
182
  it("returns 400 for invalid id", async () => {
153
- const { app } = createTestApp();
183
+ const { app } = createTestApp({ authenticated: true });
154
184
  app.route("/api/collections", collectionsApiRoutes);
155
185
 
156
186
  const res = await app.request("/api/collections/!!invalid!!");
@@ -158,7 +188,7 @@ describe("Collections API Routes", () => {
158
188
  });
159
189
 
160
190
  it("returns 404 for non-existent collection", async () => {
161
- const { app } = createTestApp();
191
+ const { app } = createTestApp({ authenticated: true });
162
192
  app.route("/api/collections", collectionsApiRoutes);
163
193
  const missingId = createEntityId("collection");
164
194
 
@@ -0,0 +1,93 @@
1
+ import { describe, expect, it } from "vitest";
2
+ import { createTestApp } from "../../../__tests__/helpers/app.js";
3
+ import { customUrlsApiRoutes } from "../custom-urls.js";
4
+
5
+ function setup() {
6
+ const testApp = createTestApp({ authenticated: true });
7
+ testApp.app.route("/api/custom-urls", customUrlsApiRoutes);
8
+ const post = (body: Record<string, unknown>) =>
9
+ testApp.app.request("/api/custom-urls", {
10
+ method: "POST",
11
+ headers: { "Content-Type": "application/json" },
12
+ body: JSON.stringify(body),
13
+ });
14
+ return { ...testApp, post };
15
+ }
16
+
17
+ describe("Custom URLs API", () => {
18
+ it("takes a post by slug or by ID, and answers with the ID and a leading slash", async () => {
19
+ const { services, post } = setup();
20
+ const target = await services.posts.create({
21
+ format: "note",
22
+ title: "On writing",
23
+ bodyMarkdown: "Words",
24
+ });
25
+
26
+ const bySlug = await post({
27
+ path: "essays/on-writing",
28
+ targetType: "post",
29
+ targetId: target.slug,
30
+ });
31
+ expect(bySlug.status).toBe(201);
32
+ expect(await bySlug.json()).toMatchObject({
33
+ path: "/essays/on-writing",
34
+ targetType: "post",
35
+ targetId: target.id,
36
+ });
37
+
38
+ const byId = await post({
39
+ path: "/writing",
40
+ targetType: "post",
41
+ targetId: target.id,
42
+ });
43
+ expect(byId.status).toBe(201);
44
+ expect((await byId.json()).targetId).toBe(target.id);
45
+ });
46
+
47
+ it("answers 404 for a target that doesn't exist, by slug or by ID", async () => {
48
+ const { post } = setup();
49
+
50
+ for (const targetId of ["no-such-post", "pst_01jpyx3m7gw4w3h7m4bknq0v1d"]) {
51
+ const res = await post({
52
+ path: "/elsewhere",
53
+ targetType: "post",
54
+ targetId,
55
+ });
56
+ expect(res.status).toBe(404);
57
+ }
58
+ });
59
+
60
+ it("pages newest first with nextCursor", async () => {
61
+ const { app, post } = setup();
62
+ for (const path of ["/one", "/two", "/three"]) {
63
+ await post({ path, targetType: "redirect", toPath: "/" });
64
+ }
65
+
66
+ const seen: string[] = [];
67
+ let cursor: string | null = null;
68
+ for (let page = 0; page < 3; page++) {
69
+ const res: Response = await app.request(
70
+ `/api/custom-urls?limit=2${cursor ? `&cursor=${cursor}` : ""}`,
71
+ );
72
+ expect(res.status).toBe(200);
73
+ const body = (await res.json()) as {
74
+ customUrls: { path: string }[];
75
+ nextCursor: string | null;
76
+ };
77
+ seen.push(...body.customUrls.map((item) => item.path));
78
+ cursor = body.nextCursor;
79
+ if (!cursor) break;
80
+ }
81
+
82
+ expect(seen.sort()).toEqual(["/one", "/three", "/two"]);
83
+ expect(cursor).toBeNull();
84
+ });
85
+
86
+ it("refuses a cursor it didn't hand out", async () => {
87
+ const { app } = setup();
88
+
89
+ const res = await app.request("/api/custom-urls?cursor=not-a-cursor");
90
+
91
+ expect(res.status).toBe(400);
92
+ });
93
+ });
@@ -0,0 +1,109 @@
1
+ /**
2
+ * Every API error answers `{ error, code }`, the shape docs/API.md's Error
3
+ * Format section documents, so a client can branch on `code` alone.
4
+ *
5
+ * Several paths answered otherwise: a body that wasn't JSON surfaced as a
6
+ * 500, an unknown `/api` path and the public-API switch answered plain text,
7
+ * and the upload endpoints built `{ error }` by hand without a `code`.
8
+ */
9
+
10
+ import { describe, expect, it } from "vitest";
11
+ import { Hono } from "hono";
12
+ import { createTestApp } from "../../../__tests__/helpers/app.js";
13
+ import {
14
+ errorHandler,
15
+ notFoundHandler,
16
+ } from "../../../middleware/error-handler.js";
17
+ import { postsApiRoutes } from "../posts.js";
18
+ import { publicThreadsApiRoutes } from "../public/threads.js";
19
+ import { uploadApiRoutes } from "../upload.js";
20
+
21
+ async function errorOf(res: Response) {
22
+ expect(res.headers.get("content-type")).toContain("application/json");
23
+ return (await res.json()) as { error: string; code: string };
24
+ }
25
+
26
+ describe("API error shape", () => {
27
+ it("answers a body that isn't JSON with 400 VALIDATION_ERROR", async () => {
28
+ const { app } = createTestApp({ authenticated: true });
29
+ app.route("/api/posts", postsApiRoutes);
30
+
31
+ const res = await app.request("/api/posts", {
32
+ method: "POST",
33
+ headers: { "Content-Type": "application/json" },
34
+ body: "{ not json",
35
+ });
36
+
37
+ expect(res.status).toBe(400);
38
+ expect((await errorOf(res)).code).toBe("VALIDATION_ERROR");
39
+ });
40
+
41
+ it("answers an unknown /api path with JSON 404 NOT_FOUND", async () => {
42
+ const { app } = createTestApp({ authenticated: true });
43
+
44
+ const res = await app.request("/api/no-such-endpoint");
45
+
46
+ expect(res.status).toBe(404);
47
+ expect((await errorOf(res)).code).toBe("NOT_FOUND");
48
+ });
49
+
50
+ it("answers the switched-off public API with JSON 404 NOT_FOUND", async () => {
51
+ const { app, services } = createTestApp({ authenticated: false });
52
+ app.route("/api/public/threads", publicThreadsApiRoutes);
53
+ await services.settings.set("PUBLIC_API_ENABLED", "false");
54
+
55
+ const res = await app.request("/api/public/threads");
56
+
57
+ expect(res.status).toBe(404);
58
+ expect((await errorOf(res)).code).toBe("NOT_FOUND");
59
+ });
60
+
61
+ it("gives upload errors a code", async () => {
62
+ const { app } = createTestApp({ authenticated: true });
63
+ app.route("/api/upload", uploadApiRoutes);
64
+
65
+ const noStorage = await app.request("/api/upload", {
66
+ method: "POST",
67
+ body: new FormData(),
68
+ });
69
+ expect(noStorage.status).toBe(500);
70
+ expect((await errorOf(noStorage)).code).toBe("CONFIGURATION_ERROR");
71
+ });
72
+
73
+ it("answers a missing upload file with 400 VALIDATION_ERROR", async () => {
74
+ const storage = {
75
+ async put() {},
76
+ async get() {
77
+ return null;
78
+ },
79
+ async delete() {},
80
+ };
81
+ const { app } = createTestApp({
82
+ authenticated: true,
83
+ storage: storage as never,
84
+ });
85
+ app.route("/api/upload", uploadApiRoutes);
86
+
87
+ const res = await app.request("/api/upload", {
88
+ method: "POST",
89
+ body: new FormData(),
90
+ });
91
+
92
+ expect(res.status).toBe(400);
93
+ expect((await errorOf(res)).code).toBe("VALIDATION_ERROR");
94
+ });
95
+
96
+ it("answers an error no handler expected with 500 INTERNAL_ERROR", async () => {
97
+ const app = new Hono();
98
+ app.onError(errorHandler as never);
99
+ app.notFound(notFoundHandler as never);
100
+ app.get("/api/boom", () => {
101
+ throw new Error("boom");
102
+ });
103
+
104
+ const res = await app.request("/api/boom");
105
+
106
+ expect(res.status).toBe(500);
107
+ expect((await errorOf(res)).code).toBe("INTERNAL_ERROR");
108
+ });
109
+ });