@jant/core 0.10.0 → 0.11.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 (475) hide show
  1. package/bin/commands/db/execute-file.js +1 -1
  2. package/bin/commands/db/export.js +1 -1
  3. package/bin/commands/migrate.js +4 -4
  4. package/bin/commands/posts/rebuild-html.js +1 -1
  5. package/bin/commands/reset-password.js +1 -1
  6. package/bin/commands/search/reindex.js +1 -1
  7. package/bin/commands/setup.js +4 -2
  8. package/bin/commands/site/export.js +3 -0
  9. package/bin/commands/site/import.js +178 -91
  10. package/bin/commands/site/pull-media.js +3 -2
  11. package/bin/commands/site/snapshot/export.js +3 -1
  12. package/bin/commands/site/snapshot/import.js +3 -2
  13. package/bin/commands/start.js +44 -0
  14. package/bin/commands/telegram/register-webhooks.js +1 -1
  15. package/bin/commands/uploads/cleanup.js +48 -9
  16. package/bin/jant.js +39 -4
  17. package/bin/lib/import-sources.js +151 -0
  18. package/bin/lib/node-env.js +14 -9
  19. package/bin/lib/runtime-target.js +1 -1
  20. package/bin/lib/site-pull-media.js +56 -4
  21. package/bin/lib/site-snapshot.js +39 -2
  22. package/bin/lib/sql-export.js +66 -10
  23. package/dist/{app-DIVtyB4m.js → app-jQI4OPRe.js} +5055 -4448
  24. package/dist/client/.vite/manifest.json +38 -38
  25. package/dist/client/_assets/chunks/{create-editor-B-m7X7S5.js → create-editor-5Y49x7h5.js} +2 -2
  26. package/dist/client/_assets/chunks/{footnote-rail-CmeoVtnU.js → footnote-rail-BJwswtVQ.js} +1 -1
  27. package/dist/client/_assets/chunks/{settings-paths-C-ZZBTau.js → settings-paths-h6RjIe3C.js} +2 -2
  28. package/dist/client/_assets/chunks/{slug-format-BcIsNKz-.js → slug-format-Dsi0e9Xn.js} +1 -1
  29. package/dist/client/_assets/chunks/{slugify-373citbs.js → slugify-DlHLyUHS.js} +1 -1
  30. package/dist/client/_assets/chunks/sortable-list-DYMcJrlS.js +2 -0
  31. package/dist/client/_assets/chunks/unsafe-svg-DxrzM_Gb.js +2 -0
  32. package/dist/client/_assets/client-52vQhZAv.js +296 -0
  33. package/dist/client/_assets/client-BaqmpPQ-.css +2 -0
  34. package/dist/client/_assets/{client-auth-BpkkKTsV.js → client-auth-BDcCR6u1.js} +2 -2
  35. package/dist/client/_assets/client-author-CGVvrNZ8.css +2 -0
  36. package/dist/client/_assets/{client-compose-C-DXzcFR.js → client-compose-CzEwT5qX.js} +4 -4
  37. package/dist/client/_assets/{client-manage-BfT7ht4M.js → client-manage-CF7x21L4.js} +37 -37
  38. package/dist/client/_assets/{client-settings-CGR_nZ78.js → client-settings-DIM44Zqh.js} +2 -2
  39. package/dist/{url-CKlGzvdN.js → constants-DEgyqWDl.js} +340 -1
  40. package/dist/index.d.ts +44 -0
  41. package/dist/index.js +33 -1
  42. package/dist/node.js +57 -13
  43. package/package.json +13 -18
  44. package/src/__tests__/api-docs.test.ts +168 -1
  45. package/src/__tests__/bin/import-sources.test.ts +85 -0
  46. package/src/__tests__/bin/uploads-cleanup.test.ts +66 -26
  47. package/src/__tests__/cli-commands.test.ts +40 -0
  48. package/src/__tests__/config-docs.test.ts +119 -16
  49. package/src/__tests__/custom-url-redirects.test.ts +108 -0
  50. package/src/__tests__/export-collection-custom-urls.test.ts +69 -0
  51. package/src/__tests__/export-docs.test.ts +113 -41
  52. package/src/__tests__/export-feed-ids.test.ts +1 -0
  53. package/src/__tests__/export-format-version.test.ts +88 -0
  54. package/src/__tests__/export-hugo-build.test.ts +139 -4
  55. package/src/__tests__/export-import-roundtrip.test.ts +2 -1
  56. package/src/__tests__/export-service.test.ts +42 -13
  57. package/src/__tests__/export-smart-collection.test.ts +1 -1
  58. package/src/__tests__/feed-docs.test.ts +287 -21
  59. package/src/__tests__/feed-reply-addresses.test.ts +100 -0
  60. package/src/__tests__/feeds-disabled.test.ts +98 -0
  61. package/src/__tests__/fixtures/export-format/1.json +76 -0
  62. package/src/__tests__/fixtures/export-format/2.json +80 -0
  63. package/src/__tests__/fixtures/releases/0.10.0/site-export/README.md +130 -0
  64. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/2thjq/_index.md +25 -0
  65. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/2u5e5/_index.md +35 -0
  66. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/41q27/0x4nv/index.md +18 -0
  67. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/41q27/_index.md +44 -0
  68. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/41q27/faqyt/index.md +30 -0
  69. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/41q27/the-potting-mix-guide-i-keep-rereading/index.md +20 -0
  70. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/5kayp/_index.md +23 -0
  71. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/5ynfs/_index.md +31 -0
  72. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/5ynfs/hu597/index.md +21 -0
  73. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/_index.md +5 -0
  74. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/a-night-heron-field-guide-for-my-walk-folder/_index.md +31 -0
  75. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/a-quiet-saturday-after-a-busy-week/_index.md +36 -0
  76. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/archive/_index.md +8 -0
  77. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/are-na-is-the-only-bookmark-pile-i-still-revisit/_index.md +30 -0
  78. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/bought-too-many-lemons-again/_index.md +37 -0
  79. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/city-walks/_index.md +12 -0
  80. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/cleanshot-for-screenshots-ocr-and-screen-recording-on-the-mac/_index.md +33 -0
  81. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/cleanshotmac-shang-de-jie-tu-ocr-lu-ping-gong-ju/_index.md +32 -0
  82. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/co344/_index.md +25 -0
  83. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/collections/_index.md +5 -0
  84. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/current-tea-rotation/_index.md +34 -0
  85. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/derek-sivers-still-writes-the-kind-of-internet-i-want-more-of/_index.md +30 -0
  86. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/desk-but-better/_index.md +25 -0
  87. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/e0kcg/_index.md +22 -0
  88. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/egi3c/_index.md +24 -0
  89. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/evf9j/_index.md +152 -0
  90. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/featured/_index.md +8 -0
  91. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/from-basho/_index.md +25 -0
  92. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/from-epictetus/_index.md +25 -0
  93. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/from-marcus-aurelius/_index.md +25 -0
  94. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/from-seneca/_index.md +26 -0
  95. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/from-thoreau/_index.md +25 -0
  96. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/gkbvv/2cl6d/index.md +18 -0
  97. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/gkbvv/3zqv7/index.md +30 -0
  98. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/gkbvv/5oxsv/index.md +18 -0
  99. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/gkbvv/_index.md +39 -0
  100. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/gwob9/_index.md +25 -0
  101. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/home-cooking/_index.md +12 -0
  102. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/hz729/_index.md +24 -0
  103. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/inaturalist-ai-zi-ran-she-qu/_index.md +44 -0
  104. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/j4v0q/_index.md +35 -0
  105. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/k278t/_index.md +25 -0
  106. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/k4eee/_index.md +22 -0
  107. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/k5vh8/_index.md +32 -0
  108. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/k5vh8/a-reading-log-idea-i-might-steal/index.md +20 -0
  109. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/k5vh8/a83qu/index.md +18 -0
  110. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/k5vh8/from-seneca-5hibo/index.md +21 -0
  111. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/kan-qi-lai-bi-jiao-ku-de-gong-si-men/_index.md +41 -0
  112. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/l2m7y/_index.md +29 -0
  113. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/lan-ya-yao-kong-qi-chuang-shang-yue-du-de-fan-ye-shen-qi/_index.md +57 -0
  114. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/mynoise-for-rainy-afternoons/_index.md +30 -0
  115. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/n09le/_index.md +23 -0
  116. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/ni-fu-jin-de-wei-ji-bai-ke-tiao-mu/_index.md +42 -0
  117. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/nts-archives-are-good-cleaning-music/_index.md +30 -0
  118. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/qgfcu/_index.md +32 -0
  119. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/qgfcu/c91j0/index.md +18 -0
  120. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/qgfcu/qyucy/index.md +18 -0
  121. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/qgfcu/wsgck/index.md +18 -0
  122. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/rain-makes-my-neighborhood-look-better/_index.md +46 -0
  123. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/reading-notes/_index.md +12 -0
  124. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/s4r3e/_index.md +25 -0
  125. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/serious-eats-on-tomato-and-egg-soup/_index.md +30 -0
  126. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/te812/_index.md +44 -0
  127. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/te812/cxiu6/index.md +18 -0
  128. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/te812/t77ms/index.md +18 -0
  129. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/te812/the-soup-trick-i-always-forget/index.md +20 -0
  130. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/telk3/_index.md +30 -0
  131. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/telk3/from-thoreau-pawt2/index.md +21 -0
  132. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/the-five-minute-reset-is-still-the-best-habit-i-have/_index.md +36 -0
  133. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/the-hallway-light-took-12-minutes-and-3-months/_index.md +32 -0
  134. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/the-recurse-center-manual-is-weirdly-calming/_index.md +30 -0
  135. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/tiny-projects/_index.md +12 -0
  136. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/tong-wang-xing-fu-zhi-lu/_index.md +68 -0
  137. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/tou-ma-yan-jiang-ju-le-bu-chu-ti-yan/_index.md +62 -0
  138. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/useful-links/_index.md +12 -0
  139. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/weekend-notes/_index.md +12 -0
  140. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/what-i-actually-use-my-notebook-for/_index.md +52 -0
  141. package/src/__tests__/fixtures/releases/0.10.0/site-export/data/jant.toml +124 -0
  142. package/src/__tests__/fixtures/releases/0.10.0/site-export/hugo.toml +45 -0
  143. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/_redirects +25 -0
  144. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/40bc6cd1f12e-med_01kn8jtq3penf98tfq4gzmh9g9.png +0 -0
  145. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01kn8jtx8qenf98tm9ahxr48sw.webp +0 -0
  146. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01kn8jv0jdenf98tp6qr9zgjjc.webp +0 -0
  147. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01kn8jv452enf98trbkwrvhvgd.webp +0 -0
  148. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01kn8jvb16enf98txp7p0pf5ge.webp +0 -0
  149. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01kn8jve5nenf98tzap11gpxzr.webp +0 -0
  150. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01kn8jvq58enf98v538w5vsqp4.webp +0 -0
  151. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01kn8jvsaeenf98v6ct4gjzppc.webp +0 -0
  152. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01kn8jw26cenf98vc7k0ppz5k8.webp +0 -0
  153. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m313q1hme4e8cmby77dn66yy.webp +0 -0
  154. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m313q2w7e4e8cmc20036yh66.webp +0 -0
  155. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m313q7d2e4e8cmdeqjmyafby.webp +0 -0
  156. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m313q887e4e8cmdjssych7yh.webp +0 -0
  157. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167jx2f6ct88pkz45j3ycp-poster.webp +0 -0
  158. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167jx2f6ct88pkz45j3ycp.mp4 +0 -0
  159. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167mbdf6ct88pr4ga1b9kf-poster.webp +0 -0
  160. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167mbdf6ct88pr4ga1b9kf.mp4 +0 -0
  161. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167nsvf6ct88q1anhz4svb-poster.webp +0 -0
  162. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167nsvf6ct88q1anhz4svb.mp4 +0 -0
  163. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167qaxf6ct88qfndwzxx83-poster.webp +0 -0
  164. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167qaxf6ct88qfndwzxx83.mp4 +0 -0
  165. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167sm0f6ct88qw5brtsgcw.webp +0 -0
  166. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167tf8f6ct88r169s51j49.webp +0 -0
  167. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167vaaf6ct88rbx5ztenwb.webp +0 -0
  168. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167w51f6ct88rp19pybkw1.webp +0 -0
  169. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167x0nf6ct88rzajb84tw3.webp +0 -0
  170. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167xxbf6ct88s5t2300bjk.webp +0 -0
  171. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167yq5f6ct88s9pjwt5fxg.webp +0 -0
  172. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167zg4f6ct88sge8jp28ja.webp +0 -0
  173. package/src/__tests__/fixtures/releases/0.10.0/site-export/themes/jant/static/apple-touch-icon.png +0 -0
  174. package/src/__tests__/fixtures/releases/0.10.0/site-export/themes/jant/static/custom.css +0 -0
  175. package/src/__tests__/fixtures/releases/0.10.0/site-export/themes/jant/static/favicon.ico +0 -0
  176. package/src/__tests__/fixtures/releases/0.10.0/site-export/wrangler.jsonc +24 -0
  177. package/src/__tests__/fixtures/releases/0.10.0/snapshot/db.sql +322 -0
  178. package/src/__tests__/fixtures/releases/0.10.0/snapshot/meta.json +11 -0
  179. package/src/__tests__/helpers/app.ts +6 -1
  180. package/src/__tests__/helpers/export-fixtures.ts +1 -0
  181. package/src/__tests__/import-refused-aliases.test.ts +98 -0
  182. package/src/__tests__/import-site-command.test.ts +73 -8
  183. package/src/__tests__/public-types.test.ts +64 -0
  184. package/src/__tests__/release-fixtures.test.ts +79 -24
  185. package/src/__tests__/release-version.test.ts +84 -0
  186. package/src/__tests__/site-pull-media.test.ts +48 -0
  187. package/src/__tests__/snapshot-tables.test.ts +37 -0
  188. package/src/__tests__/sql-export.test.ts +21 -1
  189. package/src/__tests__/stored-file-headers.test.ts +94 -0
  190. package/src/__tests__/template-deploy-workflow.test.ts +101 -0
  191. package/src/__tests__/theme-docs.test.ts +113 -24
  192. package/src/__tests__/toolchain-versions.test.ts +54 -0
  193. package/src/__tests__/trailing-slash-redirect.test.ts +61 -0
  194. package/src/__tests__/vite-config-graph.test.ts +98 -0
  195. package/src/app.tsx +89 -66
  196. package/src/client/__tests__/compose-bridge-image-upload.test.ts +1 -0
  197. package/src/client/__tests__/compose-bridge.test.ts +87 -0
  198. package/src/client/__tests__/compose-shortcuts.test.ts +4 -4
  199. package/src/client/__tests__/footnote-rail.test.ts +1 -1
  200. package/src/client/__tests__/lazy-entries.test.ts +1 -1
  201. package/src/client/__tests__/media-scroll-hint.test.ts +2 -2
  202. package/src/client/avatar-upload.ts +10 -10
  203. package/src/client/components/__tests__/jant-compose-dialog.test.ts +295 -4
  204. package/src/client/components/__tests__/jant-compose-editor.test.ts +34 -0
  205. package/src/client/components/__tests__/jant-settings-general.test.ts +0 -32
  206. package/src/client/components/compose-types.ts +14 -0
  207. package/src/client/components/jant-compose-dialog.ts +96 -41
  208. package/src/client/components/jant-compose-editor.ts +21 -4
  209. package/src/client/components/jant-config-editor.ts +4 -6
  210. package/src/client/components/jant-media-lightbox.ts +4 -4
  211. package/src/client/components/jant-settings-general.ts +0 -4
  212. package/src/client/components/nav-manager-types.ts +6 -5
  213. package/src/client/compose-bridge.ts +15 -4
  214. package/src/client/compose-launch.ts +4 -6
  215. package/src/client/compose-shortcuts.ts +1 -1
  216. package/src/client/footnote-rail.ts +1 -1
  217. package/src/client/lazy-entries.ts +1 -1
  218. package/src/client/media-scroll-hint.ts +2 -2
  219. package/src/client/tiptap/__tests__/markdown-clipboard.test.ts +55 -0
  220. package/src/client/tiptap/markdown-clipboard.ts +50 -2
  221. package/src/client/upload-session.ts +7 -6
  222. package/src/db/__tests__/backfill-external-redirects.test.ts +59 -0
  223. package/src/db/__tests__/backfill-featured-discover.test.ts +56 -0
  224. package/src/db/backfills/0007_restore_external_redirect_scheme.sql +20 -0
  225. package/src/db/backfills/0008_turn_off_featured_only_discover.sql +11 -0
  226. package/src/i18n/locales/public/en.po +46 -48
  227. package/src/i18n/locales/public/en.ts +1 -1
  228. package/src/i18n/locales/public/zh-Hans.po +45 -46
  229. package/src/i18n/locales/public/zh-Hans.ts +1 -1
  230. package/src/i18n/locales/public/zh-Hant.po +45 -46
  231. package/src/i18n/locales/public/zh-Hant.ts +1 -1
  232. package/src/i18n/locales/settings/en.po +15 -29
  233. package/src/i18n/locales/settings/en.ts +1 -1
  234. package/src/i18n/locales/settings/zh-Hans.po +15 -29
  235. package/src/i18n/locales/settings/zh-Hans.ts +1 -1
  236. package/src/i18n/locales/settings/zh-Hant.po +15 -29
  237. package/src/i18n/locales/settings/zh-Hant.ts +1 -1
  238. package/src/index.ts +43 -2
  239. package/src/lib/__tests__/api-settings.test.ts +3 -3
  240. package/src/lib/__tests__/constants.test.ts +10 -0
  241. package/src/lib/__tests__/discover.test.ts +8 -9
  242. package/src/lib/__tests__/env-values.test.ts +125 -0
  243. package/src/lib/__tests__/feed-path.test.ts +29 -0
  244. package/src/lib/__tests__/feed.test.ts +50 -22
  245. package/src/lib/__tests__/filter-dimensions.test.ts +22 -8
  246. package/src/lib/__tests__/post-list-cursor.test.ts +0 -10
  247. package/src/lib/__tests__/rate-limit.test.ts +22 -7
  248. package/src/lib/__tests__/resolve-config.test.ts +5 -3
  249. package/src/lib/__tests__/schemas.test.ts +72 -23
  250. package/src/lib/__tests__/slugify.test.ts +9 -0
  251. package/src/lib/__tests__/startup-config.test.ts +12 -0
  252. package/src/lib/__tests__/storage-s3.test.ts +214 -0
  253. package/src/lib/__tests__/theme.test.ts +20 -1
  254. package/src/lib/__tests__/time.test.ts +56 -0
  255. package/src/lib/__tests__/timeline.test.ts +46 -0
  256. package/src/lib/__tests__/url-fetch.test.ts +65 -1
  257. package/src/lib/__tests__/url.test.ts +60 -1
  258. package/src/lib/api-nav-items.ts +16 -20
  259. package/src/lib/api-post-input.ts +34 -1
  260. package/src/lib/api-posts.ts +125 -23
  261. package/src/lib/api-public-posts.ts +28 -37
  262. package/src/lib/api-search.ts +49 -2
  263. package/src/lib/api-settings.ts +159 -54
  264. package/src/lib/api-threads.ts +34 -11
  265. package/src/lib/constants.ts +6 -0
  266. package/src/lib/discover.ts +7 -23
  267. package/src/lib/env-values.ts +140 -0
  268. package/src/lib/env.ts +203 -12
  269. package/src/lib/feed-path.ts +8 -2
  270. package/src/lib/feed-policy.ts +110 -7
  271. package/src/lib/feed.ts +69 -25
  272. package/src/lib/filter-dimensions.ts +17 -10
  273. package/src/lib/github-sync-site-config.ts +1 -0
  274. package/src/lib/hugo-markdown.ts +5 -6
  275. package/src/lib/navigation.ts +4 -1
  276. package/src/lib/post-list-cursor.ts +33 -29
  277. package/src/lib/public-storage.ts +43 -0
  278. package/src/lib/rate-limit.ts +31 -16
  279. package/src/lib/render.tsx +5 -0
  280. package/src/lib/resolve-config.ts +16 -19
  281. package/src/lib/schemas.ts +248 -180
  282. package/src/lib/slugify.ts +6 -1
  283. package/src/lib/sse.ts +1 -1
  284. package/src/lib/startup-config.ts +20 -1
  285. package/src/lib/theme.ts +8 -5
  286. package/src/lib/thread-fold.ts +6 -0
  287. package/src/lib/thread-query.ts +19 -24
  288. package/src/lib/time.ts +137 -17
  289. package/src/lib/timeline.ts +56 -13
  290. package/src/lib/url-fetch.ts +141 -40
  291. package/src/lib/url.ts +86 -1
  292. package/src/middleware/__tests__/auth.test.ts +27 -0
  293. package/src/middleware/__tests__/cors.test.ts +54 -0
  294. package/src/middleware/__tests__/cross-origin.test.ts +149 -0
  295. package/src/middleware/__tests__/public-content-access.test.ts +2 -42
  296. package/src/middleware/auth.ts +34 -3
  297. package/src/middleware/cors.ts +4 -4
  298. package/src/middleware/cross-origin.ts +124 -0
  299. package/src/middleware/error-handler.ts +7 -0
  300. package/src/middleware/public-content-access.ts +3 -26
  301. package/src/middleware/secure-headers.ts +8 -2
  302. package/src/node/__tests__/cli-migrate.test.ts +2 -2
  303. package/src/node/__tests__/cli-runtime-target.test.ts +13 -2
  304. package/src/node/__tests__/cli-site-snapshot.test.ts +57 -0
  305. package/src/node/__tests__/cli-snapshot-meta.test.ts +11 -1
  306. package/src/node/__tests__/cli-sql-export.test.ts +25 -1
  307. package/src/node/__tests__/cli-start.test.ts +66 -0
  308. package/src/node/__tests__/request-handler.test.ts +37 -0
  309. package/src/node/__tests__/runtime.test.ts +56 -1
  310. package/src/node/request-handler.ts +58 -5
  311. package/src/node/runtime.ts +37 -11
  312. package/src/preset.css +3 -3
  313. package/src/routes/__tests__/compose.test.ts +84 -0
  314. package/src/routes/api/__tests__/collections.test.ts +68 -0
  315. package/src/routes/api/__tests__/mcp.test.ts +164 -9
  316. package/src/routes/api/__tests__/media.test.ts +9 -1
  317. package/src/routes/api/__tests__/nav-items.test.ts +27 -1
  318. package/src/routes/api/__tests__/posts.test.ts +269 -78
  319. package/src/routes/api/__tests__/search.test.ts +17 -4
  320. package/src/routes/api/__tests__/settings.test.ts +119 -85
  321. package/src/routes/api/__tests__/telegram.test.ts +11 -6
  322. package/src/routes/api/__tests__/threads.test.ts +11 -0
  323. package/src/routes/api/__tests__/upload-response.test.ts +48 -0
  324. package/src/routes/api/__tests__/uploads.test.ts +35 -2
  325. package/src/routes/api/collections.ts +3 -3
  326. package/src/routes/api/custom-urls.ts +2 -1
  327. package/src/routes/api/export.ts +1 -0
  328. package/src/routes/api/internal/__tests__/post-body-html.test.ts +19 -0
  329. package/src/routes/api/internal/__tests__/uploads.test.ts +2 -0
  330. package/src/routes/api/internal/sites.ts +16 -4
  331. package/src/routes/api/mcp.ts +1 -0
  332. package/src/routes/api/media.ts +7 -8
  333. package/src/routes/api/nav-items.ts +2 -1
  334. package/src/routes/api/posts.ts +18 -24
  335. package/src/routes/api/public/__tests__/posts.test.ts +15 -0
  336. package/src/routes/api/public/__tests__/threads-collections.test.ts +12 -45
  337. package/src/routes/api/public/__tests__/threads.test.ts +41 -9
  338. package/src/routes/api/public/posts.ts +2 -2
  339. package/src/routes/api/public/threads.ts +16 -26
  340. package/src/routes/api/search.ts +7 -41
  341. package/src/routes/api/settings.ts +32 -28
  342. package/src/routes/api/smart-collections.ts +6 -1
  343. package/src/routes/api/threads.ts +25 -26
  344. package/src/routes/api/upload.ts +6 -21
  345. package/src/routes/api/uploads.ts +14 -20
  346. package/src/routes/auth/__tests__/dev.test.ts +16 -13
  347. package/src/routes/auth/__tests__/hosted-sso.test.ts +51 -0
  348. package/src/routes/auth/__tests__/setup-auth.test.ts +2 -0
  349. package/src/routes/auth/__tests__/setup-discover.test.ts +2 -0
  350. package/src/routes/auth/__tests__/setup-flow.test.ts +32 -0
  351. package/src/routes/auth/__tests__/setup-rate-limit.test.ts +72 -0
  352. package/src/routes/auth/__tests__/setup-steps.test.ts +2 -0
  353. package/src/routes/auth/__tests__/signin.test.ts +167 -2
  354. package/src/routes/auth/dev.ts +4 -6
  355. package/src/routes/auth/hosted-sso.ts +9 -6
  356. package/src/routes/auth/setup.tsx +35 -5
  357. package/src/routes/auth/signin.tsx +96 -1
  358. package/src/routes/compose.tsx +47 -47
  359. package/src/routes/dash/__tests__/settings-avatar.test.ts +59 -4
  360. package/src/routes/dash/__tests__/settings-demo-locks.test.ts +147 -0
  361. package/src/routes/dash/custom-urls.tsx +2 -0
  362. package/src/routes/dash/settings.tsx +79 -32
  363. package/src/routes/feed/__tests__/feed.test.ts +93 -3
  364. package/src/routes/feed/__tests__/sitemap.test.ts +42 -0
  365. package/src/routes/feed/feed.ts +128 -175
  366. package/src/routes/feed/sitemap.ts +9 -7
  367. package/src/routes/pages/__tests__/archive-years.test.ts +45 -0
  368. package/src/routes/pages/__tests__/collection-routing.test.ts +40 -0
  369. package/src/routes/pages/__tests__/collections.test.ts +3 -0
  370. package/src/routes/pages/__tests__/language-routing.test.ts +31 -0
  371. package/src/routes/pages/__tests__/post-page-round-trips.test.ts +34 -2
  372. package/src/routes/pages/__tests__/search.test.ts +5 -2
  373. package/src/routes/pages/__tests__/thread-gap.test.ts +207 -0
  374. package/src/routes/pages/archive.tsx +33 -94
  375. package/src/routes/pages/brand.tsx +1 -0
  376. package/src/routes/pages/collection.tsx +13 -84
  377. package/src/routes/pages/collections.tsx +2 -0
  378. package/src/routes/pages/featured.tsx +7 -2
  379. package/src/routes/pages/home.tsx +1 -0
  380. package/src/routes/pages/latest.tsx +6 -2
  381. package/src/routes/pages/new.tsx +1 -0
  382. package/src/routes/pages/page.tsx +73 -47
  383. package/src/routes/pages/search.tsx +5 -3
  384. package/src/routes/pages/smart-collection.tsx +11 -70
  385. package/src/routes/pages/subscribe.tsx +1 -0
  386. package/src/routes/pages/theme-sample.tsx +1 -0
  387. package/src/runtime/__tests__/readiness.test.ts +16 -0
  388. package/src/runtime/cloudflare.ts +2 -3
  389. package/src/runtime/index.ts +3 -1
  390. package/src/runtime/node.ts +3 -5
  391. package/src/runtime/readiness.ts +5 -0
  392. package/src/services/__tests__/auth.test.ts +115 -0
  393. package/src/services/__tests__/collection.test.ts +9 -0
  394. package/src/services/__tests__/github-sync-webhook.test.ts +78 -0
  395. package/src/services/__tests__/hosted-handoff.test.ts +208 -1
  396. package/src/services/__tests__/media.test.ts +47 -27
  397. package/src/services/__tests__/navigation.test.ts +67 -15
  398. package/src/services/__tests__/post.test.ts +103 -56
  399. package/src/services/__tests__/search.test.ts +38 -0
  400. package/src/services/__tests__/settings.test.ts +2 -14
  401. package/src/services/__tests__/smart-collection.test.ts +2 -2
  402. package/src/services/__tests__/telegram-ingest.test.ts +113 -0
  403. package/src/services/__tests__/thread.test.ts +26 -11
  404. package/src/services/auth.ts +36 -4
  405. package/src/services/collection.ts +46 -5
  406. package/src/services/custom-url.ts +11 -4
  407. package/src/services/export-theme/assets/client-site.css +1 -1
  408. package/src/services/export-theme/assets/client-site.js +2 -2
  409. package/src/services/export-theme/layouts/_default/baseof.html +1 -1
  410. package/src/services/export-theme/layouts/collection/single.html +1 -1
  411. package/src/services/export-theme/layouts/partials/featured-thread.html +8 -1
  412. package/src/services/export-theme/layouts/partials/head.html +1 -1
  413. package/src/services/export-theme/layouts/partials/media-gallery.html +6 -3
  414. package/src/services/export-theme/layouts/smart_collection/list.html +1 -1
  415. package/src/services/export-theme/styles/main.css +3 -3
  416. package/src/services/export.ts +68 -19
  417. package/src/services/github-sync.ts +10 -10
  418. package/src/services/hosted-handoff.ts +106 -6
  419. package/src/services/index.ts +3 -1
  420. package/src/services/language.ts +33 -0
  421. package/src/services/mcp.ts +176 -438
  422. package/src/services/media.ts +69 -21
  423. package/src/services/navigation.ts +19 -4
  424. package/src/services/path.ts +45 -3
  425. package/src/services/post.ts +329 -214
  426. package/src/services/search.ts +22 -3
  427. package/src/services/settings.ts +36 -3
  428. package/src/services/site-admin.ts +1 -0
  429. package/src/services/smart-collection.ts +10 -3
  430. package/src/services/telegram.ts +23 -6
  431. package/src/services/thread.ts +11 -3
  432. package/src/services/upload-session.ts +14 -15
  433. package/src/styles/components.css +2 -2
  434. package/src/styles/site-media.css +2 -2
  435. package/src/styles/tokens.css +19 -22
  436. package/src/styles/ui-author.css +73 -94
  437. package/src/styles/ui.css +62 -62
  438. package/src/types/app-context.ts +5 -1
  439. package/src/types/bindings.ts +11 -0
  440. package/src/types/config.ts +4 -4
  441. package/src/types/constants.ts +20 -0
  442. package/src/types/props.ts +34 -8
  443. package/src/types/views.ts +28 -13
  444. package/src/ui/color-themes.ts +6 -5
  445. package/src/ui/dash/settings/GeneralContent.tsx +0 -22
  446. package/src/ui/dash/settings/__tests__/GeneralContent.test.tsx +0 -21
  447. package/src/ui/feed/CuratedThreadPreview.tsx +7 -2
  448. package/src/ui/feed/LinkCard.tsx +1 -2
  449. package/src/ui/feed/NoteCard.tsx +1 -2
  450. package/src/ui/feed/QuoteCard.tsx +2 -2
  451. package/src/ui/feed/ThreadPreview.tsx +6 -6
  452. package/src/ui/feed/TimelineFeed.tsx +1 -7
  453. package/src/ui/feed/__tests__/thread-preview.test.ts +123 -10
  454. package/src/ui/feed/__tests__/timeline-cards.test.ts +18 -1
  455. package/src/ui/layouts/BaseLayout.tsx +5 -0
  456. package/src/ui/pages/ArchivePage.tsx +1 -1
  457. package/src/ui/pages/BrandPage.tsx +1 -1
  458. package/src/ui/pages/CollectionPage.tsx +0 -1
  459. package/src/ui/pages/CollectionsPage.tsx +2 -2
  460. package/src/ui/pages/ComposePage.tsx +1 -1
  461. package/src/ui/pages/FeaturedPage.tsx +1 -1
  462. package/src/ui/pages/HomePage.tsx +1 -1
  463. package/src/ui/pages/PostPage.tsx +1 -1
  464. package/src/ui/pages/SearchPage.tsx +1 -1
  465. package/src/ui/pages/SmartCollectionPage.tsx +2 -3
  466. package/src/ui/pages/SubscribePage.tsx +1 -1
  467. package/src/ui/pages/ThemeSamplePage.tsx +1 -1
  468. package/src/ui/shared/MediaGallery.tsx +1 -1
  469. package/src/vendor/datastar.js +9 -1956
  470. package/src/vendor/datastar.js.map +4 -4
  471. package/dist/client/_assets/chunks/sortable-list-BJyd-LXE.js +0 -2
  472. package/dist/client/_assets/chunks/unsafe-svg-DU_DNMy5.js +0 -2
  473. package/dist/client/_assets/client-D4AT9Iqr.js +0 -295
  474. package/dist/client/_assets/client-DRuw7XCt.css +0 -2
  475. package/dist/client/_assets/client-author-DQ8R-8KR.css +0 -2
@@ -2,11 +2,25 @@ import { describe, expect, it } from "vitest";
2
2
  import { defaultFeedRenderer } from "../feed.js";
3
3
  import type {
4
4
  FeedData,
5
+ FeedLabels,
5
6
  FeedPostView,
6
7
  MediaView,
7
8
  PostView,
8
9
  } from "../../types.js";
9
10
 
11
+ /** The labels an English site's feed writes. */
12
+ const FEED_LABELS: FeedLabels = {
13
+ watchVideo: "Watch video",
14
+ watchOn: (provider) => `Watch on ${provider}`,
15
+ morePosts: (count) => (count === 1 ? "1 more post" : `${count} more posts`),
16
+ linkPreview: "Link preview",
17
+ videoPreview: "Video preview",
18
+ providerVideo: (provider) => `${provider} video`,
19
+ audio: "Audio",
20
+ attachedText: "Attached text",
21
+ attachment: "Attachment",
22
+ };
23
+
10
24
  function makeMediaView(overrides: Partial<MediaView> = {}): MediaView {
11
25
  return {
12
26
  id: "med_1",
@@ -41,6 +55,7 @@ function makePostView(overrides: Partial<FeedPostView> = {}): FeedPostView {
41
55
 
42
56
  function makeFeedData(post: FeedPostView): FeedData {
43
57
  return {
58
+ labels: FEED_LABELS,
44
59
  siteName: "Jant",
45
60
  siteDescription: "Thoughts, links, and quotes — one post at a time",
46
61
  siteUrl: "https://example.com",
@@ -55,6 +70,7 @@ describe("feed renderers", () => {
55
70
  // on every poll, which is untrue and useless for change detection.
56
71
  it("dates the feed by its newest entry, not the render time", () => {
57
72
  const xml = defaultFeedRenderer({
73
+ labels: FEED_LABELS,
58
74
  ...makeFeedData(makePostView()),
59
75
  posts: [
60
76
  makePostView({
@@ -85,6 +101,7 @@ describe("feed renderers", () => {
85
101
  // an avatar from, so the feed is where it has to be.
86
102
  it("emits the site avatar as an absolute atom:icon", () => {
87
103
  const xml = defaultFeedRenderer({
104
+ labels: FEED_LABELS,
88
105
  ...makeFeedData(makePostView()),
89
106
  siteIconUrl: "/media/avatar.png",
90
107
  });
@@ -100,6 +117,7 @@ describe("feed renderers", () => {
100
117
 
101
118
  it("falls back to the render time for an empty feed", () => {
102
119
  const xml = defaultFeedRenderer({
120
+ labels: FEED_LABELS,
103
121
  ...makeFeedData(makePostView()),
104
122
  posts: [],
105
123
  });
@@ -388,17 +406,14 @@ describe("feed renderers", () => {
388
406
  expect(xml).not.toContain("★");
389
407
  });
390
408
 
391
- it("uses feed-specific timestamps when provided", () => {
409
+ // A curated feed moves an entry's <updated> when it takes a post in; the
410
+ // post's own publication date stays <published>.
411
+ it("dates <published> by the post and <updated> by the feed", () => {
392
412
  const xml = defaultFeedRenderer(
393
- makeFeedData(
394
- makePostView({
395
- feedPublishedAt: "2026-03-20T08:30:00.000Z",
396
- feedUpdatedAt: "2026-03-20T09:45:00.000Z",
397
- }),
398
- ),
413
+ makeFeedData(makePostView({ feedUpdatedAt: "2026-03-20T09:45:00.000Z" })),
399
414
  );
400
415
 
401
- expect(xml).toContain("<published>2026-03-20T08:30:00.000Z</published>");
416
+ expect(xml).toContain("<published>2026-03-19T00:00:00.000Z</published>");
402
417
  expect(xml).toContain("<updated>2026-03-20T09:45:00.000Z</updated>");
403
418
  });
404
419
 
@@ -896,6 +911,7 @@ describe("feed renderers", () => {
896
911
  describe("feed Discover declaration", () => {
897
912
  it("declares the mode and the feeds to poll", () => {
898
913
  const xml = defaultFeedRenderer({
914
+ labels: FEED_LABELS,
899
915
  ...makeFeedData(makePostView()),
900
916
  discover: "latest",
901
917
  discoverFeedUrl: "https://example.com/latest/feed",
@@ -910,6 +926,7 @@ describe("feed Discover declaration", () => {
910
926
 
911
927
  it("names no featured feed when none was given", () => {
912
928
  const xml = defaultFeedRenderer({
929
+ labels: FEED_LABELS,
913
930
  ...makeFeedData(makePostView()),
914
931
  discover: "latest",
915
932
  discoverFeedUrl: "https://example.com/latest/feed",
@@ -920,23 +937,12 @@ describe("feed Discover declaration", () => {
920
937
  );
921
938
  });
922
939
 
923
- it("points featured sites at the featured feed", () => {
924
- const xml = defaultFeedRenderer({
925
- ...makeFeedData(makePostView()),
926
- discover: "featured",
927
- discoverFeedUrl: "https://example.com/featured/feed",
928
- });
929
-
930
- expect(xml).toContain(
931
- '<jant:discover feed="https://example.com/featured/feed">featured</jant:discover>',
932
- );
933
- });
934
-
935
940
  // `none` is an answer, so it is still declared — a crawler that already
936
941
  // knows the site has to be told to stop, and silence would read as "this
937
942
  // site predates Discover" instead.
938
943
  it("declares none without a feed attribute", () => {
939
944
  const xml = defaultFeedRenderer({
945
+ labels: FEED_LABELS,
940
946
  ...makeFeedData(makePostView()),
941
947
  discover: "none",
942
948
  discoverFeedUrl: null,
@@ -957,6 +963,7 @@ describe("feed Discover declaration", () => {
957
963
  // feed that leaves the declaration out is one with nothing in it at all.
958
964
  it("declares no namespace when nothing in it is emitted", () => {
959
965
  const xml = defaultFeedRenderer({
966
+ labels: FEED_LABELS,
960
967
  ...makeFeedData(makePostView()),
961
968
  posts: [],
962
969
  });
@@ -966,6 +973,7 @@ describe("feed Discover declaration", () => {
966
973
 
967
974
  it("keeps a sitePathPrefix in the polled feed URL", () => {
968
975
  const xml = defaultFeedRenderer({
976
+ labels: FEED_LABELS,
969
977
  ...makeFeedData(makePostView()),
970
978
  siteUrl: "https://example.com/blog",
971
979
  discover: "latest",
@@ -979,6 +987,7 @@ describe("feed Discover declaration", () => {
979
987
  describe("feed language alternates", () => {
980
988
  it("links each language's copy of the same feed", () => {
981
989
  const xml = defaultFeedRenderer({
990
+ labels: FEED_LABELS,
982
991
  ...makeFeedData(makePostView()),
983
992
  languageAlternates: [
984
993
  { hreflang: "zh-Hans", href: "https://example.com/latest/feed" },
@@ -996,6 +1005,7 @@ describe("feed language alternates", () => {
996
1005
 
997
1006
  it("emits nothing extra for a single-language site", () => {
998
1007
  const xml = defaultFeedRenderer({
1008
+ labels: FEED_LABELS,
999
1009
  ...makeFeedData(makePostView()),
1000
1010
  languageAlternates: [],
1001
1011
  });
@@ -1010,6 +1020,7 @@ describe("feed author", () => {
1010
1020
  // Atom already has for it.
1011
1021
  it("names the blog, separately from the composed feed title", () => {
1012
1022
  const xml = defaultFeedRenderer({
1023
+ labels: FEED_LABELS,
1013
1024
  ...makeFeedData(makePostView()),
1014
1025
  siteName: "A blog",
1015
1026
  title: "A blog - Latest posts",
@@ -1021,6 +1032,7 @@ describe("feed author", () => {
1021
1032
 
1022
1033
  it("escapes a name that contains markup characters", () => {
1023
1034
  const xml = defaultFeedRenderer({
1035
+ labels: FEED_LABELS,
1024
1036
  ...makeFeedData(makePostView()),
1025
1037
  siteName: "Q&A <notes>",
1026
1038
  });
@@ -1032,6 +1044,7 @@ describe("feed author", () => {
1032
1044
 
1033
1045
  it("emits nothing when the site has no name", () => {
1034
1046
  const xml = defaultFeedRenderer({
1047
+ labels: FEED_LABELS,
1035
1048
  ...makeFeedData(makePostView()),
1036
1049
  siteName: "",
1037
1050
  });
@@ -1484,6 +1497,21 @@ describe("feed entry metadata", () => {
1484
1497
 
1485
1498
  // A collection is a label the author chose, which is what `<category>` is
1486
1499
  // for — unlike the format, which no author typed.
1500
+ it("names the collections scheme under a site's path prefix", () => {
1501
+ const xml = defaultFeedRenderer({
1502
+ ...makeFeedData(
1503
+ makePostView({
1504
+ collections: [
1505
+ { slug: "reading", title: "Reading", url: "/blog/reading" },
1506
+ ],
1507
+ }),
1508
+ ),
1509
+ siteUrl: "https://example.com/blog",
1510
+ });
1511
+
1512
+ expect(xml).toContain('scheme="https://example.com/blog/collections"');
1513
+ });
1514
+
1487
1515
  it("files an entry under its collections", () => {
1488
1516
  const xml = defaultFeedRenderer(
1489
1517
  makeFeedData(
@@ -1499,10 +1527,10 @@ describe("feed entry metadata", () => {
1499
1527
  // A single collection lives in the root URL namespace and a site path
1500
1528
  // prefix makes it unguessable from the term, so the URL rides along.
1501
1529
  expect(xml).toContain(
1502
- '<category term="reading" label="Reading" jant:page="https://example.com/reading"/>',
1530
+ '<category term="reading" scheme="https://example.com/collections" label="Reading" jant:page="https://example.com/reading"/>',
1503
1531
  );
1504
1532
  expect(xml).toContain(
1505
- '<category term="notes" label="Field Notes" jant:page="https://example.com/notes"/>',
1533
+ '<category term="notes" scheme="https://example.com/collections" label="Field Notes" jant:page="https://example.com/notes"/>',
1506
1534
  );
1507
1535
  });
1508
1536
 
@@ -247,39 +247,53 @@ describe("parsePostFilterSelectionStrict", () => {
247
247
  });
248
248
 
249
249
  describe("toPostFilters", () => {
250
+ const UTC = { timeZone: "UTC" };
251
+
252
+ it("reads a year on the site's calendar", () => {
253
+ expect(
254
+ toPostFilters({ year: 2025 }, { timeZone: "Asia/Shanghai" }),
255
+ ).toEqual({
256
+ // 2024-12-31T16:00:00Z to 2025-12-31T16:00:00Z
257
+ publishedAfter: 1735660800,
258
+ publishedBefore: 1767196800,
259
+ });
260
+ });
261
+
250
262
  it("pins the year to publication by default", () => {
251
- expect(toPostFilters({ year: 2024 }, {})).toEqual({
263
+ expect(toPostFilters({ year: 2024 }, UTC)).toEqual({
252
264
  publishedAfter: Date.UTC(2024, 0, 1) / 1000,
253
265
  publishedBefore: Date.UTC(2025, 0, 1) / 1000,
254
266
  });
255
267
  });
256
268
 
257
269
  it("follows the sort axis when the caller asks it to", () => {
258
- expect(toPostFilters({ year: 2024 }, { yearAxis: "sort" })).toEqual({
270
+ expect(
271
+ toPostFilters({ year: 2024 }, { yearAxis: "sort", timeZone: "UTC" }),
272
+ ).toEqual({
259
273
  axisAfter: Date.UTC(2024, 0, 1) / 1000,
260
274
  axisBefore: Date.UTC(2025, 0, 1) / 1000,
261
275
  });
262
276
  });
263
277
 
264
278
  it("fans one media value out into the two fields PostFilters carries", () => {
265
- expect(toPostFilters({ media: "any" }, {})).toEqual({ hasMedia: true });
266
- expect(toPostFilters({ media: "none" }, {})).toEqual({ hasMedia: false });
267
- expect(toPostFilters({ media: ["image"] }, {})).toEqual({
279
+ expect(toPostFilters({ media: "any" }, UTC)).toEqual({ hasMedia: true });
280
+ expect(toPostFilters({ media: "none" }, UTC)).toEqual({ hasMedia: false });
281
+ expect(toPostFilters({ media: ["image"] }, UTC)).toEqual({
268
282
  mediaKinds: ["image"],
269
283
  });
270
284
  });
271
285
 
272
286
  it("treats featured as a flag, not a stored visibility", () => {
273
- expect(toPostFilters({ visibility: "featured" }, {})).toEqual({
287
+ expect(toPostFilters({ visibility: "featured" }, UTC)).toEqual({
274
288
  featured: true,
275
289
  });
276
- expect(toPostFilters({ visibility: "latest_hidden" }, {})).toEqual({
290
+ expect(toPostFilters({ visibility: "latest_hidden" }, UTC)).toEqual({
277
291
  visibility: "latest_hidden",
278
292
  });
279
293
  });
280
294
 
281
295
  it("contributes nothing for an empty selection", () => {
282
- expect(toPostFilters({}, {})).toEqual({});
296
+ expect(toPostFilters({}, UTC)).toEqual({});
283
297
  });
284
298
  });
285
299
 
@@ -3,7 +3,6 @@ import { ValidationError } from "../errors.js";
3
3
  import {
4
4
  decodePostListCursor,
5
5
  encodePostListCursor,
6
- isLegacyPostListCursor,
7
6
  type PostListCursorShape,
8
7
  } from "../post-list-cursor.js";
9
8
 
@@ -50,15 +49,6 @@ describe("post list cursor", () => {
50
49
  expect(cursor.length).toBeLessThan(200);
51
50
  });
52
51
 
53
- it("never looks like a bare post ID", () => {
54
- const cursor = encodePostListCursor(SHAPE.mode, [-1, 0, POST_ID]);
55
- expect(isLegacyPostListCursor(cursor)).toBe(false);
56
- expect(isLegacyPostListCursor(POST_ID)).toBe(true);
57
- expect(isLegacyPostListCursor("med_01jpyx4g9m8b4y50a4gx3t7p1n")).toBe(
58
- false,
59
- );
60
- });
61
-
62
52
  it("rejects a cursor that can't be read", () => {
63
53
  const unreadable = decodeError("not a cursor");
64
54
  for (const raw of [
@@ -17,14 +17,15 @@ type Env = { Bindings: Bindings; Variables: AppVariables };
17
17
  */
18
18
  function buildApp(options: {
19
19
  limiter: RateLimiter;
20
- disabled?: boolean;
20
+ enabled?: boolean;
21
+ key?: string;
21
22
  }): Hono<Env> {
22
23
  const app = new Hono<Env>();
23
24
  app.use("*", async (c, next) => {
24
25
  c.set("rateLimiter", options.limiter);
25
26
  c.set("appConfig", {
26
27
  rateLimit: {
27
- disabled: options.disabled ?? false,
28
+ enabled: options.enabled ?? true,
28
29
  searchPerMinute: 30,
29
30
  },
30
31
  } as AppVariables["appConfig"]);
@@ -32,7 +33,12 @@ function buildApp(options: {
32
33
  });
33
34
  app.get("/", async (c) =>
34
35
  c.json(
35
- await checkRequestRateLimit(c, { name: "test", limit: 2, windowSec: 60 }),
36
+ await checkRequestRateLimit(c, {
37
+ name: "test",
38
+ key: options.key,
39
+ limit: 2,
40
+ windowSec: 60,
41
+ }),
36
42
  ),
37
43
  );
38
44
  return app;
@@ -85,10 +91,10 @@ describe("checkRequestRateLimit", () => {
85
91
  });
86
92
  });
87
93
 
88
- it("counts nothing when rateLimit.disabled is true", async () => {
94
+ it("counts nothing when rate limiting is off", async () => {
89
95
  const { limiter, keys } = scriptedLimiter([{ ok: false }]);
90
96
 
91
- expect(await check(buildApp({ limiter, disabled: true }))).toEqual({
97
+ expect(await check(buildApp({ limiter, enabled: false }))).toEqual({
92
98
  ok: true,
93
99
  });
94
100
  expect(keys()).toEqual([]);
@@ -104,12 +110,21 @@ describe("checkRequestRateLimit", () => {
104
110
  expect(keys()).toEqual(["test:1.2.3.4"]);
105
111
  });
106
112
 
107
- it("falls back to x-forwarded-for (first entry) when cf header is absent", async () => {
113
+ it("uses the entry the nearest proxy added, not one the client sent", async () => {
108
114
  const { limiter, keys } = scriptedLimiter([{ ok: true }]);
109
115
 
110
116
  await check(buildApp({ limiter }), {
111
117
  "x-forwarded-for": "10.0.0.1, 10.0.0.2",
112
118
  });
113
- expect(keys()).toEqual(["test:10.0.0.1"]);
119
+ expect(keys()).toEqual(["test:10.0.0.2"]);
120
+ });
121
+
122
+ it("buckets by a key when one is given", async () => {
123
+ const { limiter, keys } = scriptedLimiter([{ ok: true }]);
124
+
125
+ await check(buildApp({ limiter, key: "owner@example.com" }), {
126
+ "cf-connecting-ip": "1.2.3.4",
127
+ });
128
+ expect(keys()).toEqual(["test:owner@example.com"]);
114
129
  });
115
130
  });
@@ -403,9 +403,11 @@ describe("resolveConfig", () => {
403
403
  }),
404
404
  {},
405
405
  );
406
- expect(config2.pageSize).toBe(50);
407
- expect(config2.searchPageSize).toBe(50);
408
- expect(config2.archivePageSize).toBe(50);
406
+ // A value the startup check reports runs as the default, which is what
407
+ // the settings API reports too.
408
+ expect(config2.pageSize).toBe(25);
409
+ expect(config2.searchPageSize).toBe(25);
410
+ expect(config2.archivePageSize).toBe(25);
409
411
  expect(config2.rssFeedLimit).toBe(50);
410
412
  expect(config2.rssPublishDelaySeconds).toBe(300);
411
413
 
@@ -1,6 +1,7 @@
1
1
  import { describe, it, expect } from "vitest";
2
2
  import { createEntityId } from "../ids.js";
3
3
  import {
4
+ pageLimitSchema,
4
5
  FormatSchema,
5
6
  StatusSchema,
6
7
  RedirectTypeSchema,
@@ -42,6 +43,29 @@ describe("FormatSchema", () => {
42
43
  });
43
44
  });
44
45
 
46
+ describe("pageLimitSchema", () => {
47
+ const limit = pageLimitSchema(100, 20);
48
+
49
+ it("reads a value past either end of the range as that end", () => {
50
+ expect(limit.parse("500")).toBe(100);
51
+ expect(limit.parse(101)).toBe(100);
52
+ expect(limit.parse("0")).toBe(1);
53
+ expect(limit.parse(-3)).toBe(1);
54
+ expect(limit.parse("42")).toBe(42);
55
+ });
56
+
57
+ it("falls back when limit is absent or empty", () => {
58
+ expect(limit.parse(undefined)).toBe(20);
59
+ expect(limit.parse("")).toBe(20);
60
+ });
61
+
62
+ it("refuses a value that isn't an integer", () => {
63
+ for (const value of ["abc", "1.5", 2.5]) {
64
+ expect(limit.safeParse(value).success, String(value)).toBe(false);
65
+ }
66
+ });
67
+ });
68
+
45
69
  describe("StatusSchema", () => {
46
70
  it("accepts all valid statuses", () => {
47
71
  for (const status of STATUSES) {
@@ -394,9 +418,13 @@ describe("CreatePostSchema", () => {
394
418
  expect(result.pinned).toBe(true);
395
419
  });
396
420
 
397
- it("accepts pinned as 'on' (transforms to true)", () => {
398
- const result = CreatePostSchema.parse({ ...validPost, pinned: "on" });
399
- expect(result.pinned).toBe(true);
421
+ it("takes pinned only as a boolean", () => {
422
+ expect(
423
+ CreatePostSchema.safeParse({ ...validPost, pinned: "on" }).success,
424
+ ).toBe(false);
425
+ expect(CreatePostSchema.parse({ ...validPost, pinned: true }).pinned).toBe(
426
+ true,
427
+ );
400
428
  });
401
429
 
402
430
  it("accepts optional quoteText for quote posts", () => {
@@ -521,9 +549,29 @@ describe("CreatePostSchema", () => {
521
549
  expect(result.rating).toBeUndefined();
522
550
  });
523
551
 
524
- it("accepts empty string rating (transforms to undefined)", () => {
525
- const result = CreatePostSchema.parse({ ...validPost, rating: "" });
526
- expect(result.rating).toBeUndefined();
552
+ it("takes a rating only as a number", () => {
553
+ expect(
554
+ CreatePostSchema.safeParse({ ...validPost, rating: "" }).success,
555
+ ).toBe(false);
556
+ expect(
557
+ CreatePostSchema.safeParse({ ...validPost, rating: "3" }).success,
558
+ ).toBe(false);
559
+ expect(
560
+ CreatePostSchema.parse({ ...validPost, rating: 0 }).rating,
561
+ ).toBeUndefined();
562
+ });
563
+
564
+ it("takes pinnedAt and featuredAt only as Unix seconds", () => {
565
+ expect(
566
+ CreatePostSchema.safeParse({
567
+ ...validPost,
568
+ pinnedAt: "2026-09-28T00:00:00Z",
569
+ }).success,
570
+ ).toBe(false);
571
+ expect(
572
+ CreatePostSchema.parse({ ...validPost, featuredAt: 1790000000 })
573
+ .featuredAt,
574
+ ).toBe(1790000000);
527
575
  });
528
576
 
529
577
  it("accepts optional collectionIds as array of non-empty strings", () => {
@@ -545,12 +593,10 @@ describe("CreatePostSchema", () => {
545
593
  ).toThrow();
546
594
  });
547
595
 
548
- it("accepts empty string collectionIds (transforms to undefined)", () => {
549
- const result = CreatePostSchema.parse({
550
- ...validPost,
551
- collectionIds: "",
552
- });
553
- expect(result.collectionIds).toBeUndefined();
596
+ it("takes collectionIds only as an array", () => {
597
+ expect(
598
+ CreatePostSchema.safeParse({ ...validPost, collectionIds: "" }).success,
599
+ ).toBe(false);
554
600
  });
555
601
 
556
602
  it("accepts optional replyToId", () => {
@@ -635,12 +681,14 @@ describe("CreatePostApiSchema", () => {
635
681
  });
636
682
 
637
683
  it("leaves record timestamps out of updates", () => {
684
+ // Unknown fields are ignored rather than refused, so a record timestamp
685
+ // sent with an update never reaches it.
638
686
  expect(
639
- UpdatePostApiSchema.safeParse({ createdAt: 1700000000 }).success,
640
- ).toBe(false);
687
+ UpdatePostApiSchema.parse({ createdAt: 1700000000 }),
688
+ ).not.toHaveProperty("createdAt");
641
689
  expect(
642
- UpdatePostApiSchema.safeParse({ updatedAt: 1700000000 }).success,
643
- ).toBe(false);
690
+ UpdatePostApiSchema.parse({ updatedAt: 1700000000 }),
691
+ ).not.toHaveProperty("updatedAt");
644
692
  });
645
693
 
646
694
  it("accepts ordered attachment inputs", () => {
@@ -669,13 +717,14 @@ describe("CreatePostApiSchema", () => {
669
717
  ]);
670
718
  });
671
719
 
672
- it("rejects legacy mediaIds in API requests", () => {
673
- expect(() =>
674
- CreatePostApiSchema.parse({
675
- ...validPost,
676
- mediaIds: ["media-1"],
677
- }),
678
- ).toThrow();
720
+ it("ignores fields it doesn't know, such as the legacy mediaIds", () => {
721
+ const parsed = CreatePostApiSchema.parse({
722
+ ...validPost,
723
+ mediaIds: ["media-1"],
724
+ somethingNew: true,
725
+ });
726
+ expect(parsed).not.toHaveProperty("mediaIds");
727
+ expect(parsed).not.toHaveProperty("somethingNew");
679
728
  });
680
729
 
681
730
  it("rejects text attachments without content", () => {
@@ -24,6 +24,15 @@ describe("slugify", () => {
24
24
  expect(slugify("hello_world")).toBe("hello-world");
25
25
  });
26
26
 
27
+ // A post created with `path: "_x"` got the slug `-x`, which no slug rule
28
+ // accepts and no link to it reads as intended.
29
+ it("never leads, trails, or doubles a hyphen from underscores", () => {
30
+ expect(slugify("_x")).toBe("x");
31
+ expect(slugify("__notes__")).toBe("notes");
32
+ expect(slugify("a__b")).toBe("a-b");
33
+ expect(slugify("_ drafts _")).toBe("drafts");
34
+ });
35
+
27
36
  it("handles already-slugified text", () => {
28
37
  expect(slugify("already-a-slug")).toBe("already-a-slug");
29
38
  });
@@ -96,6 +96,18 @@ describe("getStartupConfigurationErrorPage", () => {
96
96
  );
97
97
  });
98
98
 
99
+ it("returns an error page naming each environment value Jant can't use", () => {
100
+ const page = getStartupConfigurationErrorPage({
101
+ AUTH_SECRET: "test-secret-with-enough-entropy-for-startup-checks",
102
+ PAGE_SIZE: "500",
103
+ STORAGE_DRIVER: "S3",
104
+ } as Parameters<typeof getStartupConfigurationErrorPage>[0]);
105
+
106
+ expect(page).toContain("Environment values need fixing");
107
+ expect(page).toContain("PAGE_SIZE can&#39;t be &quot;500&quot;");
108
+ expect(page).toContain("STORAGE_DRIVER can&#39;t be &quot;S3&quot;");
109
+ });
110
+
99
111
  it("renders runtime configuration failures as a user-facing error page", () => {
100
112
  const page = getRuntimeConfigurationErrorPage(
101
113
  "single-site mode found multiple sites in the database.",