@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
@@ -15,7 +15,7 @@ import { requireAuthApi } from "../../middleware/auth.js";
15
15
  import { assertFound, parseIdParam } from "../../lib/errors.js";
16
16
  import { ID_PREFIX } from "../../lib/ids.js";
17
17
  import {
18
- MediaIdSchema,
18
+ pageLimitSchema,
19
19
  parseValidated,
20
20
  readJsonBody,
21
21
  } from "../../lib/schemas.js";
@@ -26,9 +26,9 @@ type Env = { Bindings: Bindings; Variables: AppVariables };
26
26
  export const mediaApiRoutes = new Hono<Env>();
27
27
 
28
28
  const ListMediaQuerySchema = z.object({
29
- limit: z.coerce.number().int().min(1).max(200).optional().default(50),
29
+ limit: pageLimitSchema(200, 50),
30
30
  mimePrefix: z.string().trim().min(1).optional(),
31
- cursor: MediaIdSchema.optional(),
31
+ cursor: z.string().optional(),
32
32
  });
33
33
 
34
34
  const UpdateMediaSchema = z.object({
@@ -46,16 +46,15 @@ mediaApiRoutes.get("/", async (c) => {
46
46
  ListMediaQuerySchema,
47
47
  c.req.query(),
48
48
  );
49
- const mediaList = await c.var.services.media.list({
49
+ const page = await c.var.services.media.listPage({
50
50
  limit,
51
51
  mimePrefix,
52
52
  cursor,
53
53
  });
54
54
 
55
55
  return c.json({
56
- media: mediaList.map((media) => toApiMedia(media, c.var.appConfig)),
57
- nextCursor:
58
- mediaList.length === limit ? (mediaList.at(-1)?.id ?? null) : null,
56
+ media: page.media.map((media) => toApiMedia(media, c.var.appConfig)),
57
+ nextCursor: page.nextCursor,
59
58
  });
60
59
  });
61
60
 
@@ -65,7 +64,7 @@ mediaApiRoutes.get("/:id", async (c) => {
65
64
  return c.json(toApiMedia(media, c.var.appConfig));
66
65
  });
67
66
 
68
- mediaApiRoutes.patch("/:id", async (c) => {
67
+ mediaApiRoutes.put("/:id", async (c) => {
69
68
  const id = parseIdParam(c.req.param("id"), ID_PREFIX.media);
70
69
  const { alt } = parseValidated(UpdateMediaSchema, await readJsonBody(c));
71
70
  assertFound(await c.var.services.media.getById(id), "Media");
@@ -12,6 +12,7 @@ import { requireAuthApi } from "../../middleware/auth.js";
12
12
  import {
13
13
  CreateNavItemSchema,
14
14
  NavItemIdSchema,
15
+ pageLimitSchema,
15
16
  parseValidated,
16
17
  readJsonBody,
17
18
  UpdateNavItemSchema,
@@ -36,7 +37,7 @@ const MoveSchema = z.object({
36
37
 
37
38
  const PageCandidatesQuerySchema = z.object({
38
39
  q: z.string().trim().max(200).optional(),
39
- limit: z.coerce.number().int().min(1).max(50).optional(),
40
+ limit: pageLimitSchema(50, 20),
40
41
  });
41
42
 
42
43
  async function withSiteHeaderHtml<T extends object>(
@@ -10,7 +10,9 @@ import {
10
10
  ContentLanguageSchema,
11
11
  CreatePostApiSchema,
12
12
  FormatSchema,
13
+ pageLimitSchema,
13
14
  parseValidated,
15
+ PostContentSchema,
14
16
  PostIdSchema,
15
17
  readJsonBody,
16
18
  StatusSchema,
@@ -19,6 +21,7 @@ import {
19
21
  import { requireAuthApi } from "../../middleware/auth.js";
20
22
  import {
21
23
  apiPostListOrder,
24
+ loadApiPostDetail,
22
25
  loadApiPostResponse,
23
26
  loadApiPostResponses,
24
27
  } from "../../lib/api-posts.js";
@@ -32,6 +35,7 @@ import {
32
35
  postWriteDeps,
33
36
  toCreatePostInput,
34
37
  toUpdatePostInput,
38
+ assertUpdateFitsFormat,
35
39
  } from "../../lib/api-post-input.js";
36
40
 
37
41
  type Env = { Bindings: Bindings; Variables: AppVariables };
@@ -42,7 +46,12 @@ const ListPostsQuerySchema = z.object({
42
46
  format: FormatSchema.optional(),
43
47
  status: StatusSchema.optional(),
44
48
  cursor: z.string().optional(),
45
- limit: z.coerce.number().int().min(1).max(100).optional().default(100),
49
+ limit: pageLimitSchema(100, 100),
50
+ content: PostContentSchema.optional(),
51
+ });
52
+
53
+ const GetPostQuerySchema = z.object({
54
+ content: PostContentSchema.optional(),
46
55
  });
47
56
 
48
57
  const PostSlugQuerySchema = z.discriminatedUnion("mode", [
@@ -60,7 +69,7 @@ const PostSlugQuerySchema = z.discriminatedUnion("mode", [
60
69
 
61
70
  // List posts (requires auth)
62
71
  postsApiRoutes.get("/", requireAuthApi(), async (c) => {
63
- const { format, status, cursor, limit } = parseValidated(
72
+ const { format, status, cursor, limit, content } = parseValidated(
64
73
  ListPostsQuerySchema,
65
74
  c.req.query(),
66
75
  );
@@ -72,7 +81,7 @@ postsApiRoutes.get("/", requireAuthApi(), async (c) => {
72
81
  );
73
82
 
74
83
  return c.json({
75
- posts: await loadApiPostResponses(c.var, posts),
84
+ posts: await loadApiPostResponses(c.var, posts, { content }),
76
85
  nextCursor,
77
86
  });
78
87
  });
@@ -99,31 +108,14 @@ postsApiRoutes.get("/slug", requireAuthApi(), async (c) => {
99
108
  });
100
109
  });
101
110
 
102
- // Get post body content (requires auth)
103
- postsApiRoutes.get("/:id/content", requireAuthApi(), async (c) => {
104
- const id = parseIdParam(c.req.param("id"), ID_PREFIX.post);
105
- const content = assertFound(
106
- await c.var.services.posts.getBodyContent(id),
107
- "Post",
108
- );
109
-
110
- return c.json(content);
111
- });
112
-
113
111
  // Get single post (requires auth)
114
112
  postsApiRoutes.get("/:id", requireAuthApi(), async (c) => {
115
113
  const id = parseIdParam(c.req.param("id"), ID_PREFIX.post);
114
+ const { content } = parseValidated(GetPostQuerySchema, c.req.query());
116
115
 
117
- const [post, threadPosition] = await Promise.all([
118
- c.var.services.posts.getById(id),
119
- c.var.services.posts.getThreadPosition(id),
120
- ]);
121
- const foundPost = assertFound(post, "Post");
116
+ const post = assertFound(await c.var.services.posts.getById(id), "Post");
122
117
 
123
- return c.json({
124
- ...(await loadApiPostResponse(c.var, foundPost, { collectionIds: true })),
125
- threadPosition,
126
- });
118
+ return c.json(await loadApiPostDetail(c.var, post, { content }));
127
119
  });
128
120
 
129
121
  // Create post (requires auth)
@@ -149,6 +141,8 @@ postsApiRoutes.put("/:id", requireAuthApi(), async (c) => {
149
141
  const id = parseIdParam(c.req.param("id"), ID_PREFIX.post);
150
142
 
151
143
  const body = parseValidated(UpdatePostApiSchema, await readJsonBody(c));
144
+ const existing = assertFound(await c.var.services.posts.getById(id), "Post");
145
+ assertUpdateFitsFormat(body, existing.format);
152
146
  const deps = postWriteDeps(c.var);
153
147
  const post = assertFound(
154
148
  await c.var.services.posts.updateWithAttachments(
@@ -174,7 +168,7 @@ postsApiRoutes.put("/:id", requireAuthApi(), async (c) => {
174
168
  const SetLanguageSchema = z.object({ language: ContentLanguageSchema });
175
169
  const TranslationCandidatesQuerySchema = z.object({
176
170
  q: z.string().trim().min(1).max(200),
177
- limit: z.coerce.number().int().min(1).max(20).optional().default(8),
171
+ limit: pageLimitSchema(20, 8),
178
172
  });
179
173
  const LinkTranslationSchema = z.object({ postId: PostIdSchema });
180
174
 
@@ -40,6 +40,21 @@ describe("Public Posts API Routes", () => {
40
40
  expect(body).not.toHaveProperty("body");
41
41
  });
42
42
 
43
+ // The permalink is the address the page and the feed's `<id>` use; `/slug`
44
+ // only redirects there.
45
+ it("gives a post's first custom URL as its permalink", async () => {
46
+ const { app, services } = createTestApp({ authenticated: false });
47
+ app.route("/api/public/posts", publicPostsApiRoutes);
48
+ const post = await services.posts.create({
49
+ format: "note",
50
+ bodyMarkdown: "body",
51
+ path: "blog/hello",
52
+ });
53
+
54
+ const res = await app.request(`/api/public/posts/${post.slug}`);
55
+ expect((await res.json()).permalink).toBe("/blog/hello");
56
+ });
57
+
43
58
  it("returns the shared Thread Collections for a child post", async () => {
44
59
  const { app, services } = createTestApp({ authenticated: false });
45
60
  app.route("/api/public/posts", publicPostsApiRoutes);
@@ -3,7 +3,6 @@ import { eq } from "drizzle-orm";
3
3
  import { createTestApp } from "../../../../__tests__/helpers/app.js";
4
4
  import { walkThreadPages } from "../../../../__tests__/helpers/cursor-walk.js";
5
5
  import { threadCollections } from "../../../../db/schema.js";
6
- import { createEntityId } from "../../../../lib/ids.js";
7
6
  import type {
8
7
  CollectionSortOrder,
9
8
  CreatePost,
@@ -222,52 +221,20 @@ describe("GET /api/public/threads with a collection", () => {
222
221
  expect(page4.nextCursor).toBeNull();
223
222
  });
224
223
 
225
- it("resumes from a bare root ID the collection lists, and refuses any other", async () => {
226
- const { services, collection, post, get } = setup();
227
- const legacy = await collection("legacy");
228
- const inCollection = (n: number, extra: Partial<CreatePost> = {}) =>
229
- post({ publishedAt: day(n), collectionIds: [legacy.id], ...extra });
230
- const first = await inCollection(1);
231
- const second = await inCollection(2);
232
- const third = await inCollection(3);
233
-
234
- // The bare root ID earlier releases returned as `nextCursor`.
235
- const resumed = await get(
236
- `/api/public/threads?collection=legacy&cursor=${third.id}`,
237
- );
238
- expect(resumed.status).toBe(200);
239
- expect(ids(resumed.body.threads)).toEqual([second.id, first.id]);
240
- expect(resumed.body.nextCursor).toBeNull();
241
-
242
- const privateRoot = await inCollection(4, { visibility: "private" });
243
- const hiddenRoot = await inCollection(5, { visibility: "latest_hidden" });
244
- const draftRoot = await post({
245
- status: "draft",
246
- collectionIds: [legacy.id],
224
+ it("refuses a root ID as a cursor", async () => {
225
+ const { collection, post, get } = setup();
226
+ const listed = await collection("listed");
227
+ await post({ publishedAt: day(1), collectionIds: [listed.id] });
228
+ const second = await post({
229
+ publishedAt: day(2),
230
+ collectionIds: [listed.id],
247
231
  });
248
- const elsewhere = await post({ publishedAt: day(6) });
249
- const deleted = await inCollection(7);
250
- await services.posts.delete(deleted.id);
251
232
 
252
- const answers = [];
253
- for (const id of [
254
- privateRoot.id,
255
- hiddenRoot.id,
256
- draftRoot.id,
257
- elsewhere.id,
258
- deleted.id,
259
- createEntityId("post"),
260
- ]) {
261
- const { status, body } = await get(
262
- `/api/public/threads?collection=legacy&cursor=${id}`,
263
- );
264
- expect(status).toBe(400);
265
- expect(body.code).toBe("VALIDATION_ERROR");
266
- answers.push(body.error);
267
- }
268
- // Nothing in the answer tells a private Thread from one that never
269
- // existed.
270
- expect(new Set(answers).size).toBe(1);
233
+ const { status, body } = await get(
234
+ `/api/public/threads?collection=listed&cursor=${second.id}`,
235
+ );
236
+ expect(status).toBe(400);
237
+ expect(body.code).toBe("VALIDATION_ERROR");
271
238
  });
272
239
 
273
240
  it("refuses a cursor from another order, in the collection or out of it", async () => {
@@ -102,6 +102,7 @@ describe("GET /api/public/threads", () => {
102
102
  id: all[3]?.id,
103
103
  slug: all[3]?.slug,
104
104
  permalink: `/${all[3]?.slug}`,
105
+ cursor: expect.any(String),
105
106
  });
106
107
  // Oldest first, the newest reply last.
107
108
  expect(ids(long.fold.trailing)).toEqual(ids(all.slice(6)));
@@ -116,6 +117,19 @@ describe("GET /api/public/threads", () => {
116
117
  });
117
118
  });
118
119
 
120
+ it("links a fold's gap by the hidden post's custom URL", async () => {
121
+ const { thread, get, services } = setup();
122
+ const all = await thread(8);
123
+ await services.paths.create({
124
+ path: "notes/first-hidden",
125
+ kind: "alias",
126
+ postId: all[3]?.id,
127
+ });
128
+
129
+ const { body } = await get("/api/public/threads?include=fold");
130
+ expect(body.threads[0].fold.gap.permalink).toBe("/notes/first-hidden");
131
+ });
132
+
119
133
  it("opens the run a fold hides with one request", async () => {
120
134
  const { thread, get, app } = setup();
121
135
  const all = await thread(10);
@@ -123,10 +137,9 @@ describe("GET /api/public/threads", () => {
123
137
  body: { threads },
124
138
  } = await get("/api/public/threads?include=fold");
125
139
  const fold = threads[0].fold;
126
- const lastLeading = fold.leading[fold.leading.length - 1].id;
127
140
 
128
141
  const { body } = await get(
129
- `/api/public/threads/${all[0]?.slug}/posts?cursor=${lastLeading}&limit=${fold.hidden}`,
142
+ `/api/public/threads/${all[0]?.slug}/posts?cursor=${fold.gap.cursor}&limit=${fold.hidden}`,
130
143
  );
131
144
  expect(body.posts[0].id).toBe(fold.gap.id);
132
145
  expect(ids(body.posts)).toEqual(ids(all.slice(3, 3 + fold.hidden)));
@@ -312,13 +325,33 @@ describe("GET /api/public/threads", () => {
312
325
  expect(await list("hasMedia=1")).toEqual([pictured.id]);
313
326
  });
314
327
 
328
+ it("ignores an unknown parameter", async () => {
329
+ const { get } = setup();
330
+ const { status } = await get("/api/public/threads?sorting=published");
331
+ expect(status).toBe(200);
332
+ });
333
+
334
+ // A later release adds `include` values; a client asking this one for
335
+ // them still gets the Threads and the extras it has.
336
+ it("skips an include value it doesn't offer", async () => {
337
+ const { services, get } = setup();
338
+ await services.posts.create({ format: "note", bodyMarkdown: "root" });
339
+
340
+ const unknownOnly = await get("/api/public/threads?include=collections");
341
+ expect(unknownOnly.status).toBe(200);
342
+ expect(unknownOnly.body.threads).toHaveLength(1);
343
+ expect(unknownOnly.body.threads[0]).not.toHaveProperty("fold");
344
+
345
+ const withFold = await get("/api/public/threads?include=collections,fold");
346
+ expect(withFold.status).toBe(200);
347
+ expect(withFold.body.threads[0]).toHaveProperty("fold");
348
+ });
349
+
315
350
  it.each([
316
- ["an unknown parameter", "?sorting=published"],
317
351
  ["visibility=all", "?visibility=all"],
318
352
  ["visibility=private", "?visibility=private"],
319
353
  ["an unknown visibility", "?visibility=nonsense"],
320
354
  ["an unknown media kind", "?media=invalid"],
321
- ["an unknown include", "?include=replies"],
322
355
  ["an unknown sort", "?sort=newest"],
323
356
  ["featured with another order", "?visibility=featured&sort=activity"],
324
357
  ])("refuses %s", async (_label, query) => {
@@ -466,12 +499,11 @@ describe("GET /api/public/threads/:slug/posts", () => {
466
499
  );
467
500
  });
468
501
 
469
- it("refuses a cursor that names a Post outside the Thread", async () => {
470
- const { post, thread, get } = setup();
471
- const all = await thread(1);
472
- const other = await post({ publishedAt: day(3) });
502
+ it("refuses a post ID as a cursor", async () => {
503
+ const { thread, get } = setup();
504
+ const all = await thread(3);
473
505
  const { status } = await get(
474
- `/api/public/threads/${all[0]?.slug}/posts?cursor=${other.id}`,
506
+ `/api/public/threads/${all[0]?.slug}/posts?cursor=${all[1]?.id}`,
475
507
  );
476
508
  expect(status).toBe(400);
477
509
  });
@@ -2,7 +2,7 @@ import { Hono } from "hono";
2
2
  import { z } from "zod";
3
3
  import type { Bindings, Post } from "../../../types.js";
4
4
  import type { AppVariables } from "../../../types/app-context.js";
5
- import { parseValidated } from "../../../lib/schemas.js";
5
+ import { parseValidated, PostContentSchema } from "../../../lib/schemas.js";
6
6
  import { NotFoundError } from "../../../lib/errors.js";
7
7
  import { loadPublicPostResponses } from "../../../lib/api-public-posts.js";
8
8
  import { requirePublicApiEnabled } from "../../../middleware/public-content-access.js";
@@ -19,7 +19,7 @@ export const publicPostsApiRoutes = new Hono<Env>();
19
19
  publicPostsApiRoutes.use("*", requirePublicApiEnabled());
20
20
 
21
21
  const PublicPostContentQuerySchema = z.object({
22
- content: z.enum(["markdown"]).optional(),
22
+ content: PostContentSchema.optional(),
23
23
  });
24
24
 
25
25
  function isPublicDetailVisible(post: Post | null): post is Post {
@@ -12,7 +12,12 @@ import { z } from "zod";
12
12
  import type { Bindings } from "../../../types.js";
13
13
  import { THREAD_SORTS } from "../../../types.js";
14
14
  import type { AppVariables } from "../../../types/app-context.js";
15
- import { ContentLanguageSchema, parseValidated } from "../../../lib/schemas.js";
15
+ import {
16
+ ContentLanguageSchema,
17
+ pageLimitSchema,
18
+ parseValidated,
19
+ PostContentSchema,
20
+ } from "../../../lib/schemas.js";
16
21
  import { NotFoundError } from "../../../lib/errors.js";
17
22
  import { loadPublicPostResponses } from "../../../lib/api-public-posts.js";
18
23
  import { loadPublicThreadResponses } from "../../../lib/api-threads.js";
@@ -28,50 +33,34 @@ export const publicThreadsApiRoutes = new Hono<Env>();
28
33
 
29
34
  publicThreadsApiRoutes.use("*", requirePublicApiEnabled());
30
35
 
31
- const ContentSchema = z.enum(["markdown"]).optional();
32
-
33
36
  /** The list's own parameters; everything else is a filter dimension. */
34
37
  const ListThreadsQuerySchema = z.object({
35
38
  lang: ContentLanguageSchema.optional(),
36
39
  sort: z.enum(THREAD_SORTS).optional(),
37
40
  include: z.string().optional(),
38
41
  cursor: z.string().optional(),
39
- limit: z.coerce.number().int().min(1).max(100).optional().default(20),
40
- content: ContentSchema,
42
+ limit: pageLimitSchema(100, 20),
43
+ content: PostContentSchema.optional(),
41
44
  });
42
45
 
43
- const LIST_PARAMS = [
44
- "lang",
45
- "sort",
46
- "include",
47
- "cursor",
48
- "limit",
49
- "content",
50
- ] as const;
51
-
52
46
  const GetThreadQuerySchema = z.object({
53
47
  include: z.string().optional(),
54
- content: ContentSchema,
48
+ content: PostContentSchema.optional(),
55
49
  });
56
50
 
57
51
  const ListThreadPostsQuerySchema = z.object({
58
52
  cursor: z.string().optional(),
59
- limit: z.coerce.number().int().min(1).max(100).optional().default(100),
60
- content: ContentSchema,
53
+ limit: pageLimitSchema(100, 100),
54
+ content: PostContentSchema.optional(),
61
55
  });
62
56
 
63
57
  publicThreadsApiRoutes.get("/", async (c) => {
64
58
  const query = parseValidated(ListThreadsQuerySchema, c.req.query());
65
59
  const { fold } = parseThreadInclude(query.include);
66
- const parsed = await parseThreadSelection(
67
- (key) => c.req.query(key),
68
- Object.keys(c.req.query()),
69
- {
70
- allow: LIST_PARAMS,
71
- audience: "reader",
72
- loadCollections: () => c.var.services.collections.list(),
73
- },
74
- );
60
+ const parsed = await parseThreadSelection((key) => c.req.query(key), {
61
+ audience: "reader",
62
+ loadCollections: () => c.var.services.collections.list(),
63
+ });
75
64
  if (parsed.kind === "empty") {
76
65
  return c.json({ threads: [], nextCursor: null });
77
66
  }
@@ -84,6 +73,7 @@ publicThreadsApiRoutes.get("/", async (c) => {
84
73
  lang: query.lang,
85
74
  sort: query.sort,
86
75
  fold,
76
+ timeZone: c.var.appConfig.timeZone,
87
77
  },
88
78
  { cursor: query.cursor, limit: query.limit },
89
79
  );
@@ -6,37 +6,12 @@ import { Hono } from "hono";
6
6
  import type { Bindings } from "../../types.js";
7
7
  import type { AppVariables } from "../../types/app-context.js";
8
8
  import { ValidationError, ExternalServiceError } from "../../lib/errors.js";
9
- import { toSearchApiResult } from "../../lib/api-search.js";
9
+ import { loadSearchApiResults } from "../../lib/api-search.js";
10
+ import { parseValidated, SearchPostsQuerySchema } from "../../lib/schemas.js";
10
11
  import { requireAuthApi } from "../../middleware/auth.js";
11
12
 
12
13
  type Env = { Bindings: Bindings; Variables: AppVariables };
13
14
 
14
- const DEFAULT_SEARCH_LIMIT = 20;
15
- const MAX_SEARCH_LIMIT = 50;
16
-
17
- /**
18
- * Read `limit` from the query string, clamped to 1–50.
19
- *
20
- * Clamped rather than rejected: the endpoint has always capped a large value
21
- * at 50, and a small one gets the same treatment. Anything that isn't a number
22
- * falls back to the default.
23
- *
24
- * @param value - Raw `limit` query parameter
25
- * @returns A page size between 1 and 50
26
- *
27
- * @example
28
- * ```ts
29
- * parseSearchLimit(undefined); // 20
30
- * parseSearchLimit("-1"); // 1
31
- * parseSearchLimit("500"); // 50
32
- * ```
33
- */
34
- function parseSearchLimit(value: string | undefined): number {
35
- const parsed = value === undefined ? Number.NaN : Number.parseInt(value, 10);
36
- if (Number.isNaN(parsed)) return DEFAULT_SEARCH_LIMIT;
37
- return Math.min(Math.max(parsed, 1), MAX_SEARCH_LIMIT);
38
- }
39
-
40
15
  export const searchApiRoutes = new Hono<Env>();
41
16
 
42
17
  // The author's search, like the rest of the author API: readers search on the
@@ -45,17 +20,10 @@ searchApiRoutes.use("*", requireAuthApi());
45
20
 
46
21
  // Search posts
47
22
  searchApiRoutes.get("/", async (c) => {
48
- const query = c.req.query("q");
49
-
50
- if (!query || query.trim().length === 0) {
51
- throw new ValidationError("Query parameter 'q' is required");
52
- }
53
-
54
- if (query.length > 200) {
55
- throw new ValidationError("Query too long");
56
- }
57
-
58
- const limit = parseSearchLimit(c.req.query("limit"));
23
+ const { q: query, limit } = parseValidated(
24
+ SearchPostsQuerySchema,
25
+ c.req.query(),
26
+ );
59
27
 
60
28
  try {
61
29
  const results = await c.var.services.search.search(query, {
@@ -66,9 +34,7 @@ searchApiRoutes.get("/", async (c) => {
66
34
 
67
35
  return c.json({
68
36
  query,
69
- results: results.map((r) =>
70
- toSearchApiResult(r.post, r.snippet, c.var.appConfig.sitePathPrefix),
71
- ),
37
+ results: await loadSearchApiResults(c.var, results),
72
38
  count: results.length,
73
39
  });
74
40
  } catch (err) {
@@ -2,6 +2,7 @@
2
2
  * Settings API Routes
3
3
  */
4
4
 
5
+ import { parseLanguageList } from "../../i18n/locales.js";
5
6
  import { Hono } from "hono";
6
7
  import type { Bindings } from "../../types.js";
7
8
  import type { AppVariables } from "../../types/app-context.js";
@@ -18,12 +19,11 @@ import {
18
19
  import { requireStorage } from "../../lib/storage.js";
19
20
  import { syncHostedControlPlaneSiteAvatar } from "../../lib/hosted-control-plane-sync.js";
20
21
  import {
21
- buildConfigEditorFields,
22
- buildEditableSettingsResponse,
22
+ buildApiSettingsResponse,
23
23
  demoLockedSettingKeys,
24
24
  isResettableConfigEditorKey,
25
- partitionEditableSettingUpdates,
26
- partitionImportableSettingUpdates,
25
+ partitionApiSettingUpdates,
26
+ partitionLanguageSettingUpdates,
27
27
  } from "../../lib/api-settings.js";
28
28
 
29
29
  type Env = { Bindings: Bindings; Variables: AppVariables };
@@ -36,7 +36,7 @@ const UpdateSettingsSchema = z.record(z.string(), z.string());
36
36
  settingsApiRoutes.get("/", requireAuthApi(), async (c) => {
37
37
  const allSettings = await c.var.services.settings.getAll();
38
38
  return c.json({
39
- settings: buildEditableSettingsResponse(
39
+ settings: buildApiSettingsResponse(
40
40
  allSettings,
41
41
  c.var.appConfig.demoMode,
42
42
  c.env,
@@ -47,7 +47,7 @@ settingsApiRoutes.get("/", requireAuthApi(), async (c) => {
47
47
  // Update settings (requires auth)
48
48
  settingsApiRoutes.put("/", requireAuthApi(), async (c) => {
49
49
  const updates = parseValidated(UpdateSettingsSchema, await readJsonBody(c));
50
- const { filteredUpdates, rejectedKeys } = partitionEditableSettingUpdates(
50
+ const { filteredUpdates, rejectedKeys } = partitionApiSettingUpdates(
51
51
  updates,
52
52
  c.var.appConfig.demoMode,
53
53
  );
@@ -67,7 +67,7 @@ settingsApiRoutes.put("/", requireAuthApi(), async (c) => {
67
67
  const allSettings = await c.var.services.settings.getAll();
68
68
 
69
69
  return c.json({
70
- settings: buildEditableSettingsResponse(
70
+ settings: buildApiSettingsResponse(
71
71
  allSettings,
72
72
  c.var.appConfig.demoMode,
73
73
  c.env,
@@ -76,29 +76,37 @@ settingsApiRoutes.put("/", requireAuthApi(), async (c) => {
76
76
  });
77
77
  });
78
78
 
79
- // Import internal-config settings (requires auth). Used by the site importer
80
- // to restore config-like internal keys (theme, font, mode, custom CSS, header
81
- // avatar toggle) that are not writable through the regular settings route.
79
+ // Restore the site's languages from a site export (requires auth). The pair
80
+ // is only valid together and against the site's paths, so the language
81
+ // service applies it rather than writing it as given.
82
82
  settingsApiRoutes.put("/import", requireAuthApi(), async (c) => {
83
83
  const updates = parseValidated(UpdateSettingsSchema, await readJsonBody(c));
84
- const { filteredUpdates, rejectedKeys } = partitionImportableSettingUpdates(
85
- updates,
86
- c.var.appConfig.demoMode,
87
- );
84
+ const { filteredUpdates, rejectedKeys } =
85
+ partitionLanguageSettingUpdates(updates);
88
86
 
89
- if (rejectedKeys.length > 0 && Object.keys(filteredUpdates).length === 0) {
90
- const message = c.var.appConfig.demoMode
91
- ? "Demo mode locks these settings"
92
- : "None of the provided keys are importable";
93
- throw new ValidationError(message, { rejectedKeys });
87
+ if (Object.keys(filteredUpdates).length === 0) {
88
+ throw new ValidationError("None of the provided keys are importable", {
89
+ rejectedKeys,
90
+ });
94
91
  }
95
92
 
96
- if (Object.keys(filteredUpdates).length > 0) {
97
- await c.var.services.settings.setMany(filteredUpdates as never);
98
- }
93
+ const current = await c.var.services.settings.getAll();
94
+ const additional =
95
+ filteredUpdates.ADDITIONAL_LANGUAGES ?? current.ADDITIONAL_LANGUAGES;
96
+ const enabled =
97
+ filteredUpdates.MULTILINGUAL_ENABLED ?? current.MULTILINGUAL_ENABLED;
98
+ await c.var.services.language.restore({
99
+ additional: parseLanguageList(additional),
100
+ enabled: enabled === "true",
101
+ });
99
102
 
103
+ const allSettings = await c.var.services.settings.getAll();
100
104
  return c.json({
101
- success: true,
105
+ settings: buildApiSettingsResponse(
106
+ allSettings,
107
+ c.var.appConfig.demoMode,
108
+ c.env,
109
+ ),
102
110
  ...(rejectedKeys.length > 0 && { rejectedKeys }),
103
111
  });
104
112
  });
@@ -240,12 +248,8 @@ settingsApiRoutes.delete("/:key", requireAuthApi(), async (c) => {
240
248
 
241
249
  await c.var.services.settings.remove(key);
242
250
  const allSettings = await c.var.services.settings.getAll();
243
- const setting = buildConfigEditorFields(allSettings, c.env, demoMode).find(
244
- (field) => field.key === key,
245
- );
246
251
 
247
252
  return c.json({
248
- settings: buildEditableSettingsResponse(allSettings, demoMode, c.env),
249
- setting,
253
+ settings: buildApiSettingsResponse(allSettings, demoMode, c.env),
250
254
  });
251
255
  });