@jant/core 0.9.1 → 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 (486) 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-B3P2N2vM.js → app-DIVtyB4m.js} +11928 -11891
  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-CeGBe0qG.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/{middleware → lib}/__tests__/rate-limit.test.ts +41 -39
  400. package/src/lib/__tests__/theme.test.ts +38 -23
  401. package/src/lib/api-collections.ts +173 -0
  402. package/src/lib/api-custom-urls.ts +44 -0
  403. package/src/lib/api-media.ts +66 -15
  404. package/src/lib/api-nav-items.ts +66 -0
  405. package/src/lib/api-post-input.ts +123 -0
  406. package/src/lib/api-posts.ts +124 -46
  407. package/src/lib/api-public-posts.ts +1 -14
  408. package/src/lib/api-search.ts +4 -0
  409. package/src/lib/collection-sort.ts +71 -0
  410. package/src/lib/constants.ts +17 -0
  411. package/src/lib/errors.ts +0 -7
  412. package/src/lib/post-list-cursor.ts +9 -3
  413. package/src/lib/rate-limit.ts +58 -0
  414. package/src/lib/schemas.ts +26 -2
  415. package/src/lib/storage.ts +19 -0
  416. package/src/lib/theme.ts +27 -22
  417. package/src/middleware/__tests__/public-content-access.test.ts +0 -34
  418. package/src/middleware/config.ts +1 -5
  419. package/src/middleware/cors.ts +1 -8
  420. package/src/middleware/error-handler.ts +33 -3
  421. package/src/middleware/public-content-access.ts +0 -25
  422. package/src/routes/api/__tests__/collections.test.ts +36 -6
  423. package/src/routes/api/__tests__/custom-urls.test.ts +93 -0
  424. package/src/routes/api/__tests__/error-shape.test.ts +109 -0
  425. package/src/routes/api/__tests__/mcp.test.ts +161 -6
  426. package/src/routes/api/__tests__/{upload.test.ts → media.test.ts} +18 -18
  427. package/src/routes/api/__tests__/nav-items.test.ts +2 -2
  428. package/src/routes/api/__tests__/posts.test.ts +4 -1
  429. package/src/routes/api/__tests__/public-access.test.ts +42 -37
  430. package/src/routes/api/__tests__/search.test.ts +65 -87
  431. package/src/routes/api/collections.ts +27 -24
  432. package/src/routes/api/custom-urls.ts +28 -41
  433. package/src/routes/api/github-sync.tsx +2 -2
  434. package/src/routes/api/internal/sites.ts +8 -13
  435. package/src/routes/api/internal/uploads.ts +2 -7
  436. package/src/routes/api/mcp.ts +3 -0
  437. package/src/routes/api/media.ts +86 -0
  438. package/src/routes/api/nav-items.ts +11 -10
  439. package/src/routes/api/posts.ts +23 -82
  440. package/src/routes/api/public/__tests__/posts.test.ts +51 -782
  441. package/src/routes/api/public/__tests__/threads-collections.test.ts +310 -0
  442. package/src/routes/api/public/__tests__/threads.test.ts +159 -44
  443. package/src/routes/api/public/posts.ts +6 -120
  444. package/src/routes/api/search.ts +5 -19
  445. package/src/routes/api/settings.ts +18 -18
  446. package/src/routes/api/smart-collections.ts +40 -17
  447. package/src/routes/api/telegram.ts +5 -8
  448. package/src/routes/api/upload.ts +29 -253
  449. package/src/routes/api/uploads.ts +12 -53
  450. package/src/routes/dash/__tests__/font-theme.test.ts +2 -2
  451. package/src/routes/pages/__tests__/archive-params.test.ts +3 -3
  452. package/src/routes/pages/__tests__/collection-routing.test.ts +41 -0
  453. package/src/routes/pages/__tests__/language-routing.test.ts +8 -8
  454. package/src/routes/pages/__tests__/search.test.ts +61 -0
  455. package/src/routes/pages/__tests__/smart-collection.test.ts +37 -0
  456. package/src/routes/pages/__tests__/text-preview-partial.test.ts +140 -0
  457. package/src/routes/pages/brand.tsx +1 -1
  458. package/src/routes/pages/collection.tsx +7 -7
  459. package/src/routes/pages/page.tsx +7 -14
  460. package/src/routes/pages/partials.tsx +34 -0
  461. package/src/routes/pages/search.tsx +21 -4
  462. package/src/routes/pages/smart-collection.tsx +19 -27
  463. package/src/routes/pages/theme-sample.tsx +2 -4
  464. package/src/services/__tests__/media.test.ts +0 -38
  465. package/src/services/custom-url.ts +108 -5
  466. package/src/services/index.ts +6 -0
  467. package/src/services/mcp.ts +102 -189
  468. package/src/services/media.ts +0 -45
  469. package/src/services/site-admin.ts +1 -5
  470. package/src/services/text-attachment.ts +94 -0
  471. package/src/styles/tokens.css +14 -20
  472. package/src/types/config.ts +5 -2
  473. package/src/types/constants.ts +11 -0
  474. package/src/types/props.ts +9 -12
  475. package/src/ui/color-themes.ts +0 -4
  476. package/src/ui/layouts/BaseLayout.tsx +2 -2
  477. package/src/ui/pages/CollectionPage.tsx +5 -4
  478. package/src/ui/pages/SearchPage.tsx +17 -1
  479. package/src/ui/pages/SmartCollectionPage.tsx +5 -4
  480. package/dist/client/_assets/client-nByuF0Ct.js +0 -295
  481. package/src/db/rehearsal-fixtures/pg-demo-current.json +0 -55
  482. package/src/db/rehearsal-fixtures/pg-demo-current.sql +0 -431
  483. package/src/middleware/deprecation.ts +0 -48
  484. package/src/middleware/rate-limit.ts +0 -54
  485. package/src/routes/api/public/__tests__/archive.test.ts +0 -734
  486. package/src/routes/api/public/archive.ts +0 -135
@@ -7,25 +7,56 @@ import { getPostDisplayTitle } from "./post-meta.js";
7
7
  import { getImageUrl, getMediaUrl, getPublicUrlForProvider } from "./image.js";
8
8
  import { toPublicPath } from "./url.js";
9
9
 
10
- export type ApiPostResponse = Omit<Post, "title" | "url"> & {
11
- attachments?: ReturnType<typeof toApiAttachment>[];
12
- collectionIds?: string[];
10
+ /**
11
+ * A Post in the author API: `GET /api/posts`, `/api/threads`, and the MCP post
12
+ * tools. Every field is listed here and in docs/API.md's Posts table; nothing
13
+ * reaches the response by being a column. `title` and `url` are present
14
+ * except on quotes, which carry `sourceName` and `sourceUrl` instead.
15
+ */
16
+ export interface ApiPostResponse {
17
+ id: string;
18
+ format: Post["format"];
19
+ status: Post["status"];
20
+ /** Resolved: a reply carries its Thread root's visibility. */
21
+ visibility: Post["visibility"];
22
+ pinnedAt: number | null;
23
+ featuredAt: number | null;
24
+ slug: string;
13
25
  title?: string | null;
26
+ url?: string | null;
27
+ sourceName?: string | null;
28
+ sourceUrl?: string | null;
14
29
  /**
15
30
  * Short plain-text name for this Post, derived when it has no title of its
16
31
  * own. Use it wherever the Post is referenced from somewhere else; a slug is
17
32
  * a URL, not a name.
18
33
  */
19
34
  displayTitle: string;
35
+ body: string | null;
36
+ bodyHtml: string | null;
37
+ bodyText: string | null;
38
+ quoteText: string | null;
39
+ summary: string | null;
40
+ rating: number | null;
41
+ replyToId: string | null;
42
+ threadId: string;
43
+ /** BCP 47 content language, uniform across a Thread. */
44
+ language: string | null;
45
+ quietReply: boolean;
46
+ publishedAt: number | null;
47
+ lastActivityAt: number;
48
+ threadUpdatedAt: number;
20
49
  /**
21
50
  * Published Posts in this Post's Thread, its root included: 1 for a Post on
22
51
  * its own, 0 while nothing in the Thread is published.
23
52
  */
24
53
  threadPostCount: number;
25
- url?: string | null;
26
- sourceName?: string | null;
27
- sourceUrl?: string | null;
28
- };
54
+ createdAt: number;
55
+ updatedAt: number;
56
+ attachments?: ReturnType<typeof toApiAttachment>[];
57
+ /** The Thread's collections; only on single-post reads. */
58
+ collectionIds?: string[];
59
+ }
29
60
 
30
61
  /**
31
62
  * The order `GET /api/posts` and `jant_posts_list` walk Posts in.
@@ -48,19 +79,58 @@ export function apiPostListOrder(
48
79
  : { sortBy: "published", ignorePinnedSort: true };
49
80
  }
50
81
 
82
+ /**
83
+ * Where the author API reads a text attachment's Markdown as JSON.
84
+ *
85
+ * @param mediaId - The text attachment's media ID
86
+ * @param sitePathPrefix - The site's path prefix, if any
87
+ * @returns The endpoint's public path
88
+ * @example
89
+ * textAttachmentContentUrl("med_01…", "/blog"); // "/blog/api/attachments/med_01…/content"
90
+ */
91
+ export function textAttachmentContentUrl(
92
+ mediaId: string,
93
+ sitePathPrefix?: string,
94
+ ): string {
95
+ return toPublicPath(`/api/attachments/${mediaId}/content`, sitePathPrefix);
96
+ }
97
+
98
+ /** The app config an attachment's addresses are built from. */
99
+ export type AttachmentUrlConfig = Pick<
100
+ AppConfig,
101
+ | "r2PublicUrl"
102
+ | "imageTransformUrl"
103
+ | "s3PublicUrl"
104
+ | "localPublicUrl"
105
+ | "sitePathPrefix"
106
+ >;
107
+
108
+ /**
109
+ * One of a Post's attachments, as the API returns it.
110
+ *
111
+ * Every attachment's `url` is the file itself. A text attachment's file is
112
+ * its Markdown source. The author view adds `contentUrl`, the endpoint that
113
+ * returns that source as JSON; it needs a session or token, so the reader
114
+ * view leaves it out.
115
+ *
116
+ * @param media - The attachment's media row
117
+ * @param config - Public URL settings the addresses are built from
118
+ * @param view - `author` for the author API and MCP, `reader` for `/api/public/*`
119
+ * @returns The attachment object
120
+ * @example
121
+ * post.attachments = media.map((item) => toApiAttachment(item, appConfig, "reader"));
122
+ */
51
123
  export function toApiAttachment(
52
124
  media: Media,
53
- r2PublicUrl?: string,
54
- imageTransformUrl?: string,
55
- s3PublicUrl?: string,
56
- localPublicUrl?: string,
57
- sitePathPrefix?: string,
125
+ config: AttachmentUrlConfig,
126
+ view: "author" | "reader" = "author",
58
127
  ) {
128
+ const { imageTransformUrl, sitePathPrefix } = config;
59
129
  const publicUrl = getPublicUrlForProvider(
60
130
  media.provider,
61
- r2PublicUrl,
62
- s3PublicUrl,
63
- localPublicUrl,
131
+ config.r2PublicUrl,
132
+ config.s3PublicUrl,
133
+ config.localPublicUrl,
64
134
  );
65
135
  const url = getMediaUrl(media.storageKey, publicUrl, sitePathPrefix);
66
136
 
@@ -68,11 +138,11 @@ export function toApiAttachment(
68
138
  return {
69
139
  type: "text" as const,
70
140
  id: media.id,
141
+ url,
71
142
  contentFormat: "markdown" as const,
72
- contentUrl: toPublicPath(
73
- `/api/attachments/${media.id}/content`,
74
- sitePathPrefix,
75
- ),
143
+ ...(view === "author"
144
+ ? { contentUrl: textAttachmentContentUrl(media.id, sitePathPrefix) }
145
+ : {}),
76
146
  summary: media.summary,
77
147
  chars: media.chars,
78
148
  };
@@ -118,27 +188,42 @@ export function toApiPost(
118
188
  collectionIds?: string[];
119
189
  },
120
190
  ): ApiPostResponse {
121
- const { title, url, ...rest } = post;
122
- // A short name for this Post wherever it is referenced from somewhere else —
123
- // notes are usually untitled, so the client cannot just read `title`.
124
- const displayTitle = getPostDisplayTitle(post);
125
-
126
- if (post.format === "quote") {
127
- return {
128
- ...rest,
129
- ...extras,
130
- displayTitle,
131
- sourceName: title ?? null,
132
- sourceUrl: url ?? null,
133
- };
134
- }
191
+ // Quotes name their source where other formats carry a title and link.
192
+ const source =
193
+ post.format === "quote"
194
+ ? { sourceName: post.title ?? null, sourceUrl: post.url ?? null }
195
+ : { title: post.title ?? null, url: post.url ?? null };
135
196
 
136
197
  return {
137
- ...rest,
138
- ...extras,
139
- displayTitle,
140
- title: title ?? null,
141
- url: url ?? null,
198
+ id: post.id,
199
+ format: post.format,
200
+ status: post.status,
201
+ visibility: post.visibility,
202
+ pinnedAt: post.pinnedAt,
203
+ featuredAt: post.featuredAt,
204
+ slug: post.slug,
205
+ ...source,
206
+ // A short name for this Post wherever it is referenced from somewhere
207
+ // else — notes are usually untitled, so the client cannot just read `title`.
208
+ displayTitle: getPostDisplayTitle(post),
209
+ body: post.body,
210
+ bodyHtml: post.bodyHtml,
211
+ bodyText: post.bodyText,
212
+ quoteText: post.quoteText,
213
+ summary: post.summary,
214
+ rating: post.rating,
215
+ replyToId: post.replyToId,
216
+ threadId: post.threadId,
217
+ language: post.language,
218
+ quietReply: post.quietReply,
219
+ publishedAt: post.publishedAt,
220
+ lastActivityAt: post.lastActivityAt,
221
+ threadUpdatedAt: post.threadUpdatedAt,
222
+ threadPostCount: extras.threadPostCount,
223
+ createdAt: post.createdAt,
224
+ updatedAt: post.updatedAt,
225
+ ...(extras.attachments ? { attachments: extras.attachments } : {}),
226
+ ...(extras.collectionIds ? { collectionIds: extras.collectionIds } : {}),
142
227
  };
143
228
  }
144
229
 
@@ -180,14 +265,7 @@ export async function loadApiPostResponses(
180
265
  toApiPost(post, {
181
266
  threadPostCount: threadPostCounts.get(post.threadId) ?? 0,
182
267
  attachments: (mediaMap.get(post.id) ?? []).map((media) =>
183
- toApiAttachment(
184
- media,
185
- appConfig.r2PublicUrl,
186
- appConfig.imageTransformUrl,
187
- appConfig.s3PublicUrl,
188
- appConfig.localPublicUrl,
189
- appConfig.sitePathPrefix,
190
- ),
268
+ toApiAttachment(media, appConfig),
191
269
  ),
192
270
  ...(collectionsMap
193
271
  ? {
@@ -38,11 +38,6 @@ export type PublicPostBaseResponse = {
38
38
  * enabled multilingual content.
39
39
  */
40
40
  language: string | null;
41
- /**
42
- * Shared by every translation of this Thread. Null when the Thread has no
43
- * translations.
44
- */
45
- translationGroupId: string | null;
46
41
  /** Reply published without announcing its Thread. Always false on roots. */
47
42
  quietReply: boolean;
48
43
  pinnedAt: number | null;
@@ -164,7 +159,6 @@ export function toPublicPost(
164
159
  replyToId: post.replyToId,
165
160
  threadId: post.threadId,
166
161
  language: post.language,
167
- translationGroupId: post.translationGroupId,
168
162
  quietReply: post.quietReply,
169
163
  pinnedAt: post.pinnedAt,
170
164
  featuredAt: post.featuredAt,
@@ -175,14 +169,7 @@ export function toPublicPost(
175
169
  createdAt: post.createdAt,
176
170
  updatedAt: post.updatedAt,
177
171
  attachments: related.media.map((media) =>
178
- toApiAttachment(
179
- media,
180
- r2PublicUrl,
181
- imageTransformUrl,
182
- s3PublicUrl,
183
- localPublicUrl,
184
- sitePathPrefix,
185
- ),
172
+ toApiAttachment(media, appConfig, "reader"),
186
173
  ),
187
174
  collections: related.collections.map((collection) => ({
188
175
  id: collection.id,
@@ -8,6 +8,8 @@ export type SearchApiResult = {
8
8
  snippet?: string;
9
9
  publishedAt: number | null;
10
10
  permalink: string;
11
+ /** The Thread's visibility: private results reach the author only. */
12
+ visibility: Post["visibility"];
11
13
  title?: string | null;
12
14
  url?: string | null;
13
15
  sourceName?: string | null;
@@ -29,6 +31,7 @@ export function toSearchApiResult(
29
31
  snippet,
30
32
  publishedAt: post.publishedAt,
31
33
  permalink,
34
+ visibility: post.visibility,
32
35
  sourceName: post.title,
33
36
  sourceUrl: post.url,
34
37
  };
@@ -43,5 +46,6 @@ export function toSearchApiResult(
43
46
  snippet,
44
47
  publishedAt: post.publishedAt,
45
48
  permalink,
49
+ visibility: post.visibility,
46
50
  };
47
51
  }
@@ -61,3 +61,74 @@ export function resolveCollectionSortOrder(
61
61
 
62
62
  return "newest";
63
63
  }
64
+
65
+ /**
66
+ * How a collection or smart collection page spells each order in `?sort=`.
67
+ *
68
+ * Public URL values are single lowercase words, so the stored `rating_desc`
69
+ * is `rating` in an address. The API keeps `rating_desc` as `sortOrder`.
70
+ */
71
+ const SORT_PARAM_BY_ORDER = {
72
+ newest: "newest",
73
+ oldest: "oldest",
74
+ rating_desc: "rating",
75
+ } as const satisfies Record<CollectionSortOrder, string>;
76
+
77
+ /**
78
+ * Older spellings a page still reads and never writes, so links to them keep
79
+ * working: `rating_desc` is what the pages wrote before 1.0, and `updated` was
80
+ * a smart collection's fourth order until `newest` came to mean the same.
81
+ */
82
+ const LEGACY_SORT_PARAMS = {
83
+ rating_desc: "rating_desc",
84
+ updated: "newest",
85
+ } as const satisfies Record<string, CollectionSortOrder>;
86
+
87
+ /** Every `?sort=` value a collection page writes, for the reference docs. */
88
+ export const COLLECTION_SORT_PARAMS: readonly string[] =
89
+ Object.values(SORT_PARAM_BY_ORDER);
90
+
91
+ /** Every older `?sort=` value a collection page still reads. */
92
+ export const LEGACY_COLLECTION_SORT_PARAMS: readonly string[] =
93
+ Object.keys(LEGACY_SORT_PARAMS);
94
+
95
+ const ORDER_BY_SORT_PARAM = new Map<string, CollectionSortOrder>([
96
+ ...Object.entries(LEGACY_SORT_PARAMS),
97
+ ...Object.entries(SORT_PARAM_BY_ORDER).map(
98
+ ([order, param]) => [param, order as CollectionSortOrder] as const,
99
+ ),
100
+ ]);
101
+
102
+ /**
103
+ * The `?sort=` value for an order on a collection or smart collection page.
104
+ *
105
+ * @param sortOrder - The order to link to
106
+ * @returns The value to write after `?sort=`
107
+ *
108
+ * @example
109
+ * ```ts
110
+ * collectionSortParam("rating_desc"); // "rating"
111
+ * ```
112
+ */
113
+ export function collectionSortParam(sortOrder: CollectionSortOrder): string {
114
+ return SORT_PARAM_BY_ORDER[sortOrder];
115
+ }
116
+
117
+ /**
118
+ * Read a collection or smart collection page's `?sort=`, in its current or
119
+ * an older spelling.
120
+ *
121
+ * @param raw - The query value, if any
122
+ * @returns The order it names, or undefined when it names none
123
+ *
124
+ * @example
125
+ * ```ts
126
+ * parseCollectionSortParam("rating"); // "rating_desc"
127
+ * parseCollectionSortParam("rating_desc"); // "rating_desc"
128
+ * ```
129
+ */
130
+ export function parseCollectionSortParam(
131
+ raw: string | undefined,
132
+ ): CollectionSortOrder | undefined {
133
+ return raw === undefined ? undefined : ORDER_BY_SORT_PARAM.get(raw);
134
+ }
@@ -31,8 +31,23 @@ export const RESERVED_PATHS = [
31
31
  "healthz",
32
32
  "readyz",
33
33
  "skill.md",
34
+ // Files served at the root. Only a custom URL could take one of these (a
35
+ // slug has no dot), and the route answering first would leave it unreachable.
36
+ "robots.txt",
37
+ "manifest.webmanifest",
38
+ "favicon.ico",
39
+ "apple-touch-icon.png",
40
+ // Public storage for keys stored before the `media/` layout.
41
+ "sites",
34
42
  ] as const;
35
43
 
44
+ /**
45
+ * Sitemap file names, reserved as a family: `sitemap.xml` and every
46
+ * `sitemap-*.xml` it links to, including the numbered post sitemaps, and any
47
+ * the sitemap adds later.
48
+ */
49
+ const RESERVED_SITEMAP_PATTERN = /^sitemap(?:-[a-z0-9-]+)?\.xml$/;
50
+
36
51
  export type ReservedPath = (typeof RESERVED_PATHS)[number];
37
52
 
38
53
  /**
@@ -47,6 +62,7 @@ export type ReservedPath = (typeof RESERVED_PATHS)[number];
47
62
  * @returns Whether the path's first segment is unavailable
48
63
  * @example
49
64
  * isReservedPath("archive"); // true
65
+ * isReservedPath("sitemap-posts-2.xml"); // true
50
66
  * isReservedPath("ja/hello", ["ja"]); // true
51
67
  * isReservedPath("ja/hello"); // false — no language configured
52
68
  */
@@ -57,6 +73,7 @@ export function isReservedPath(
57
73
  const firstSegment = path.split("/")[0]?.toLowerCase();
58
74
  if (!firstSegment) return false;
59
75
  if (RESERVED_PATHS.includes(firstSegment as ReservedPath)) return true;
76
+ if (RESERVED_SITEMAP_PATTERN.test(firstSegment)) return true;
60
77
  return languagePrefixes.includes(firstSegment);
61
78
  }
62
79
 
package/src/lib/errors.ts CHANGED
@@ -87,13 +87,6 @@ export class MediaQuotaExceededError extends DomainError {
87
87
  }
88
88
  }
89
89
 
90
- /** Too many requests — 429 */
91
- export class RateLimitError extends DomainError {
92
- constructor(message = "Too many requests") {
93
- super(message, 429, "RATE_LIMIT");
94
- }
95
- }
96
-
97
90
  /** Third-party failure — 500 */
98
91
  export class ExternalServiceError extends DomainError {
99
92
  constructor(message: string) {
@@ -20,7 +20,7 @@
20
20
  */
21
21
 
22
22
  import { ValidationError } from "./errors.js";
23
- import { ID_PREFIX, isTypeId } from "./ids.js";
23
+ import { ID_PREFIX, isTypeId, type IdPrefix } from "./ids.js";
24
24
 
25
25
  /** Bumped when the payload shape changes; older versions are rejected. */
26
26
  const POST_LIST_CURSOR_VERSION = 1;
@@ -60,6 +60,11 @@ export interface PostListCursorShape {
60
60
  mode: string;
61
61
  /** One kind per ORDER BY key, in ORDER BY order. */
62
62
  kinds: readonly PostListCursorKeyKind[];
63
+ /**
64
+ * The TypeID prefix an `id` key carries. Post lists leave it out; another
65
+ * list keyed by its own rows' IDs, such as custom URLs, names its prefix.
66
+ */
67
+ idPrefix?: IdPrefix;
63
68
  }
64
69
 
65
70
  interface PostListCursorPayload {
@@ -90,10 +95,11 @@ function isPlainObject(value: unknown): value is Record<string, unknown> {
90
95
  function matchesKind(
91
96
  value: unknown,
92
97
  kind: PostListCursorKeyKind,
98
+ idPrefix: IdPrefix,
93
99
  ): value is PostListCursorValue {
94
100
  return kind === "number"
95
101
  ? Number.isSafeInteger(value)
96
- : typeof value === "string" && isTypeId(value, ID_PREFIX.post);
102
+ : typeof value === "string" && isTypeId(value, idPrefix);
97
103
  }
98
104
 
99
105
  /**
@@ -183,7 +189,7 @@ export function decodePostListCursor(
183
189
  const tuple: PostListCursorValue[] = [];
184
190
  for (const [index, kind] of shape.kinds.entries()) {
185
191
  const value: unknown = values[index];
186
- if (!matchesKind(value, kind)) {
192
+ if (!matchesKind(value, kind, shape.idPrefix ?? ID_PREFIX.post)) {
187
193
  throw new ValidationError(UNREADABLE_MESSAGE);
188
194
  }
189
195
  tuple.push(value);
@@ -10,6 +10,13 @@
10
10
  */
11
11
 
12
12
  import type { Context } from "hono";
13
+ import type { Bindings } from "../types.js";
14
+ import type { AppVariables } from "../types/app-context.js";
15
+
16
+ type RateLimitContext = Context<{
17
+ Bindings: Bindings;
18
+ Variables: AppVariables;
19
+ }>;
13
20
 
14
21
  export interface RateLimitCheckOptions {
15
22
  /** Max requests allowed within `windowSec`. */
@@ -61,3 +68,54 @@ export function getClientIp(c: Context): string {
61
68
  }
62
69
  return "unknown";
63
70
  }
71
+
72
+ /** A per-client limit on one surface. */
73
+ export interface RequestRateLimitOptions extends RateLimitCheckOptions {
74
+ /**
75
+ * Storage-key prefix scoping this limit (e.g. "search"). Keeps counters for
76
+ * different surfaces independent when they share a storage backend.
77
+ */
78
+ name: string;
79
+ }
80
+
81
+ /** Whether a request is under its limit, and how long to wait when it isn't. */
82
+ export type RequestRateLimitResult =
83
+ { ok: true } | { ok: false; retryAfterSec: number };
84
+
85
+ /**
86
+ * Counts this request against its client's bucket and reports whether it is
87
+ * under the limit.
88
+ *
89
+ * Buckets are per client IP (see {@link getClientIp}) and scoped by `name`.
90
+ * When `appConfig.rateLimit.disabled` is set, nothing is counted and every
91
+ * request passes, so test and dev environments don't have to reason about
92
+ * bucket state. The caller decides what an over-limit response looks like:
93
+ * a page and an API answer differently.
94
+ *
95
+ * @param c - Hono context; reads `c.var.rateLimiter` and `c.var.appConfig`
96
+ * @param opts - Bucket name, limit, and window
97
+ * @returns `ok: false` with the seconds to wait when the client is over the limit
98
+ *
99
+ * @example
100
+ * ```ts
101
+ * const limit = await checkRequestRateLimit(c, {
102
+ * name: "search",
103
+ * limit: 30,
104
+ * windowSec: 60,
105
+ * });
106
+ * if (!limit.ok) c.header("Retry-After", String(limit.retryAfterSec));
107
+ * ```
108
+ */
109
+ export async function checkRequestRateLimit(
110
+ c: RateLimitContext,
111
+ opts: RequestRateLimitOptions,
112
+ ): Promise<RequestRateLimitResult> {
113
+ if (c.var.appConfig.rateLimit.disabled) return { ok: true };
114
+
115
+ const result = await c.var.rateLimiter.check(
116
+ `${opts.name}:${getClientIp(c)}`,
117
+ { limit: opts.limit, windowSec: opts.windowSec },
118
+ );
119
+ if (result.ok) return { ok: true };
120
+ return { ok: false, retryAfterSec: result.retryAfterSec ?? opts.windowSec };
121
+ }
@@ -830,7 +830,8 @@ export const CreateSmartCollectionSchema = z.object({
830
830
  description: CollectionDescriptionValueSchema.nullable().optional(),
831
831
  // Omitted means no conditions, which is the honest spelling of "every post".
832
832
  selection: PostFilterSelectionSchema.optional(),
833
- sort: z.enum(SMART_COLLECTION_SORT_ORDERS).optional(),
833
+ // Named as a collection's is, and taking the same values.
834
+ sortOrder: z.enum(SMART_COLLECTION_SORT_ORDERS).optional(),
834
835
  layout: z.enum(ARCHIVE_LAYOUTS).nullable().optional(),
835
836
  });
836
837
 
@@ -1193,6 +1194,29 @@ export function validateAttachmentCount(attachments: unknown[]): string | null {
1193
1194
  return null;
1194
1195
  }
1195
1196
 
1197
+ /**
1198
+ * Read a request's JSON body, answering a body that isn't JSON with a
1199
+ * ValidationError (400) rather than letting the parse error surface as a 500.
1200
+ *
1201
+ * @param c - Anything with Hono's `req.json()`, usually the request context
1202
+ * @returns The parsed body, to validate with {@link parseValidated}
1203
+ * @example
1204
+ * ```ts
1205
+ * const body = parseValidated(CreatePostApiSchema, await readJsonBody(c));
1206
+ * ```
1207
+ */
1208
+ export async function readJsonBody(c: {
1209
+ req: { json(): Promise<unknown> };
1210
+ }): Promise<unknown> {
1211
+ try {
1212
+ return await c.req.json();
1213
+ } catch {
1214
+ throw new ValidationError(
1215
+ "The request body isn't valid JSON. Send a JSON object with Content-Type: application/json.",
1216
+ );
1217
+ }
1218
+ }
1219
+
1196
1220
  /**
1197
1221
  * Parse and validate data against a Zod schema, throwing ValidationError on failure.
1198
1222
  *
@@ -1201,7 +1225,7 @@ export function validateAttachmentCount(attachments: unknown[]): string | null {
1201
1225
  * @returns Validated data
1202
1226
  * @example
1203
1227
  * ```ts
1204
- * const body = parseValidated(CreatePostSchema, await c.req.json());
1228
+ * const body = parseValidated(CreatePostSchema, await readJsonBody(c));
1205
1229
  * ```
1206
1230
  */
1207
1231
  export function parseValidated<T>(schema: z.ZodSchema<T>, data: unknown): T {
@@ -11,6 +11,7 @@ import {
11
11
  getLocalStoragePath,
12
12
  } from "./env.js";
13
13
  import { now } from "./time.js";
14
+ import { ConfigurationError } from "./errors.js";
14
15
 
15
16
  export interface StorageObjectOptions {
16
17
  contentType?: string;
@@ -143,6 +144,24 @@ function assertSupportedStorageDriver(env: Bindings, driver: string): void {
143
144
  }
144
145
  }
145
146
 
147
+ /**
148
+ * The storage driver a file operation needs, or a ConfigurationError that the
149
+ * error handler answers as a 500 with `code: "CONFIGURATION_ERROR"`.
150
+ *
151
+ * @param storage - The request's storage driver, `null` when none is set up
152
+ * @returns The driver
153
+ * @example
154
+ * const storage = requireStorage(c.var.storage);
155
+ */
156
+ export function requireStorage(storage: StorageDriver | null): StorageDriver {
157
+ if (!storage) {
158
+ throw new ConfigurationError(
159
+ "File storage isn't set up. Check your server config.",
160
+ );
161
+ }
162
+ return storage;
163
+ }
164
+
146
165
  /**
147
166
  * Type guard that checks whether a storage driver supports multipart uploads.
148
167
  *