@jant/core 0.10.0 → 0.12.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 (625) 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/deploy.js +179 -0
  4. package/bin/commands/migrate.js +4 -4
  5. package/bin/commands/posts/rebuild-html.js +1 -1
  6. package/bin/commands/reset-password.js +1 -1
  7. package/bin/commands/search/reindex.js +1 -1
  8. package/bin/commands/setup.js +4 -2
  9. package/bin/commands/site/export.js +3 -0
  10. package/bin/commands/site/import.js +178 -91
  11. package/bin/commands/site/pull-media.js +3 -2
  12. package/bin/commands/site/snapshot/export.js +3 -1
  13. package/bin/commands/site/snapshot/import.js +3 -2
  14. package/bin/commands/start.js +44 -0
  15. package/bin/commands/telegram/register-webhooks.js +1 -1
  16. package/bin/commands/uploads/cleanup.js +48 -9
  17. package/bin/jant.js +39 -4
  18. package/bin/lib/cloudflare-setup.js +499 -0
  19. package/bin/lib/d1-query.js +26 -1
  20. package/bin/lib/import-sources.js +151 -0
  21. package/bin/lib/node-env.js +14 -9
  22. package/bin/lib/r2-query.js +2 -2
  23. package/bin/lib/runtime-target.js +1 -1
  24. package/bin/lib/site-pull-media.js +56 -4
  25. package/bin/lib/site-snapshot.js +39 -2
  26. package/bin/lib/sql-export.js +66 -10
  27. package/dist/{app-DIVtyB4m.js → app-DSwsDBD0.js} +38257 -9662
  28. package/dist/client/.vite/manifest.json +38 -38
  29. package/dist/client/_assets/chunks/{create-editor-B-m7X7S5.js → create-editor-5Y49x7h5.js} +2 -2
  30. package/dist/client/_assets/chunks/{footnote-rail-CmeoVtnU.js → footnote-rail-BJwswtVQ.js} +1 -1
  31. package/dist/client/_assets/chunks/{settings-paths-C-ZZBTau.js → settings-paths-h6RjIe3C.js} +2 -2
  32. package/dist/client/_assets/chunks/{slug-format-BcIsNKz-.js → slug-format-Dsi0e9Xn.js} +1 -1
  33. package/dist/client/_assets/chunks/{slugify-373citbs.js → slugify-DlHLyUHS.js} +1 -1
  34. package/dist/client/_assets/chunks/sortable-list-DYMcJrlS.js +2 -0
  35. package/dist/client/_assets/chunks/unsafe-svg-DxrzM_Gb.js +2 -0
  36. package/dist/client/_assets/client-BaqmpPQ-.css +2 -0
  37. package/dist/client/_assets/client-DPByjWoU.js +296 -0
  38. package/dist/client/_assets/{client-auth-BpkkKTsV.js → client-auth-CPqPTX1B.js} +2 -2
  39. package/dist/client/_assets/client-author-CGVvrNZ8.css +2 -0
  40. package/dist/client/_assets/{client-compose-C-DXzcFR.js → client-compose-CzEwT5qX.js} +4 -4
  41. package/dist/client/_assets/{client-manage-BfT7ht4M.js → client-manage-CF7x21L4.js} +37 -37
  42. package/dist/client/_assets/{client-settings-CGR_nZ78.js → client-settings-DIM44Zqh.js} +2 -2
  43. package/dist/{url-CKlGzvdN.js → constants-DEgyqWDl.js} +340 -1
  44. package/dist/index.d.ts +44 -0
  45. package/dist/index.js +33 -1
  46. package/dist/node.js +57 -13
  47. package/package.json +43 -48
  48. package/src/__tests__/api-docs.test.ts +168 -1
  49. package/src/__tests__/bin/deploy.test.ts +163 -0
  50. package/src/__tests__/bin/import-sources.test.ts +85 -0
  51. package/src/__tests__/bin/uploads-cleanup.test.ts +66 -26
  52. package/src/__tests__/cli-commands.test.ts +40 -0
  53. package/src/__tests__/config-docs.test.ts +119 -16
  54. package/src/__tests__/custom-url-redirects.test.ts +108 -0
  55. package/src/__tests__/export-collection-custom-urls.test.ts +69 -0
  56. package/src/__tests__/export-docs.test.ts +113 -41
  57. package/src/__tests__/export-feed-ids.test.ts +1 -0
  58. package/src/__tests__/export-format-version.test.ts +88 -0
  59. package/src/__tests__/export-hugo-build.test.ts +143 -8
  60. package/src/__tests__/export-import-roundtrip.test.ts +3 -2
  61. package/src/__tests__/export-service.test.ts +44 -15
  62. package/src/__tests__/export-smart-collection.test.ts +1 -1
  63. package/src/__tests__/feed-docs.test.ts +287 -21
  64. package/src/__tests__/feed-reply-addresses.test.ts +100 -0
  65. package/src/__tests__/feeds-disabled.test.ts +98 -0
  66. package/src/__tests__/fixtures/export-format/1.json +76 -0
  67. package/src/__tests__/fixtures/export-format/2.json +80 -0
  68. package/src/__tests__/fixtures/releases/0.10.0/site-export/README.md +130 -0
  69. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/2thjq/_index.md +25 -0
  70. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/2u5e5/_index.md +35 -0
  71. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/41q27/0x4nv/index.md +18 -0
  72. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/41q27/_index.md +44 -0
  73. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/41q27/faqyt/index.md +30 -0
  74. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/41q27/the-potting-mix-guide-i-keep-rereading/index.md +20 -0
  75. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/5kayp/_index.md +23 -0
  76. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/5ynfs/_index.md +31 -0
  77. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/5ynfs/hu597/index.md +21 -0
  78. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/_index.md +5 -0
  79. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/a-night-heron-field-guide-for-my-walk-folder/_index.md +31 -0
  80. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/a-quiet-saturday-after-a-busy-week/_index.md +36 -0
  81. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/archive/_index.md +8 -0
  82. 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
  83. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/bought-too-many-lemons-again/_index.md +37 -0
  84. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/city-walks/_index.md +12 -0
  85. 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
  86. 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
  87. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/co344/_index.md +25 -0
  88. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/collections/_index.md +5 -0
  89. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/current-tea-rotation/_index.md +34 -0
  90. 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
  91. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/desk-but-better/_index.md +25 -0
  92. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/e0kcg/_index.md +22 -0
  93. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/egi3c/_index.md +24 -0
  94. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/evf9j/_index.md +152 -0
  95. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/featured/_index.md +8 -0
  96. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/from-basho/_index.md +25 -0
  97. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/from-epictetus/_index.md +25 -0
  98. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/from-marcus-aurelius/_index.md +25 -0
  99. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/from-seneca/_index.md +26 -0
  100. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/from-thoreau/_index.md +25 -0
  101. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/gkbvv/2cl6d/index.md +18 -0
  102. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/gkbvv/3zqv7/index.md +30 -0
  103. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/gkbvv/5oxsv/index.md +18 -0
  104. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/gkbvv/_index.md +39 -0
  105. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/gwob9/_index.md +25 -0
  106. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/home-cooking/_index.md +12 -0
  107. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/hz729/_index.md +24 -0
  108. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/inaturalist-ai-zi-ran-she-qu/_index.md +44 -0
  109. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/j4v0q/_index.md +35 -0
  110. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/k278t/_index.md +25 -0
  111. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/k4eee/_index.md +22 -0
  112. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/k5vh8/_index.md +32 -0
  113. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/k5vh8/a-reading-log-idea-i-might-steal/index.md +20 -0
  114. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/k5vh8/a83qu/index.md +18 -0
  115. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/k5vh8/from-seneca-5hibo/index.md +21 -0
  116. 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
  117. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/l2m7y/_index.md +29 -0
  118. 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
  119. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/mynoise-for-rainy-afternoons/_index.md +30 -0
  120. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/n09le/_index.md +23 -0
  121. 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
  122. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/nts-archives-are-good-cleaning-music/_index.md +30 -0
  123. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/qgfcu/_index.md +32 -0
  124. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/qgfcu/c91j0/index.md +18 -0
  125. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/qgfcu/qyucy/index.md +18 -0
  126. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/qgfcu/wsgck/index.md +18 -0
  127. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/rain-makes-my-neighborhood-look-better/_index.md +46 -0
  128. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/reading-notes/_index.md +12 -0
  129. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/s4r3e/_index.md +25 -0
  130. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/serious-eats-on-tomato-and-egg-soup/_index.md +30 -0
  131. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/te812/_index.md +44 -0
  132. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/te812/cxiu6/index.md +18 -0
  133. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/te812/t77ms/index.md +18 -0
  134. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/te812/the-soup-trick-i-always-forget/index.md +20 -0
  135. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/telk3/_index.md +30 -0
  136. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/telk3/from-thoreau-pawt2/index.md +21 -0
  137. 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
  138. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/the-hallway-light-took-12-minutes-and-3-months/_index.md +32 -0
  139. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/the-recurse-center-manual-is-weirdly-calming/_index.md +30 -0
  140. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/tiny-projects/_index.md +12 -0
  141. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/tong-wang-xing-fu-zhi-lu/_index.md +68 -0
  142. 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
  143. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/useful-links/_index.md +12 -0
  144. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/weekend-notes/_index.md +12 -0
  145. package/src/__tests__/fixtures/releases/0.10.0/site-export/content/what-i-actually-use-my-notebook-for/_index.md +52 -0
  146. package/src/__tests__/fixtures/releases/0.10.0/site-export/data/jant.toml +124 -0
  147. package/src/__tests__/fixtures/releases/0.10.0/site-export/hugo.toml +45 -0
  148. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/_redirects +25 -0
  149. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/40bc6cd1f12e-med_01kn8jtq3penf98tfq4gzmh9g9.png +0 -0
  150. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01kn8jtx8qenf98tm9ahxr48sw.webp +0 -0
  151. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01kn8jv0jdenf98tp6qr9zgjjc.webp +0 -0
  152. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01kn8jv452enf98trbkwrvhvgd.webp +0 -0
  153. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01kn8jvb16enf98txp7p0pf5ge.webp +0 -0
  154. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01kn8jve5nenf98tzap11gpxzr.webp +0 -0
  155. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01kn8jvq58enf98v538w5vsqp4.webp +0 -0
  156. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01kn8jvsaeenf98v6ct4gjzppc.webp +0 -0
  157. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01kn8jw26cenf98vc7k0ppz5k8.webp +0 -0
  158. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m313q1hme4e8cmby77dn66yy.webp +0 -0
  159. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m313q2w7e4e8cmc20036yh66.webp +0 -0
  160. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m313q7d2e4e8cmdeqjmyafby.webp +0 -0
  161. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m313q887e4e8cmdjssych7yh.webp +0 -0
  162. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167jx2f6ct88pkz45j3ycp-poster.webp +0 -0
  163. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167jx2f6ct88pkz45j3ycp.mp4 +0 -0
  164. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167mbdf6ct88pr4ga1b9kf-poster.webp +0 -0
  165. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167mbdf6ct88pr4ga1b9kf.mp4 +0 -0
  166. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167nsvf6ct88q1anhz4svb-poster.webp +0 -0
  167. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167nsvf6ct88q1anhz4svb.mp4 +0 -0
  168. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167qaxf6ct88qfndwzxx83-poster.webp +0 -0
  169. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167qaxf6ct88qfndwzxx83.mp4 +0 -0
  170. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167sm0f6ct88qw5brtsgcw.webp +0 -0
  171. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167tf8f6ct88r169s51j49.webp +0 -0
  172. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167vaaf6ct88rbx5ztenwb.webp +0 -0
  173. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167w51f6ct88rp19pybkw1.webp +0 -0
  174. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167x0nf6ct88rzajb84tw3.webp +0 -0
  175. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167xxbf6ct88s5t2300bjk.webp +0 -0
  176. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167yq5f6ct88s9pjwt5fxg.webp +0 -0
  177. package/src/__tests__/fixtures/releases/0.10.0/site-export/static/media/med_01m3167zg4f6ct88sge8jp28ja.webp +0 -0
  178. package/src/__tests__/fixtures/releases/0.10.0/site-export/themes/jant/static/apple-touch-icon.png +0 -0
  179. package/src/__tests__/fixtures/releases/0.10.0/site-export/themes/jant/static/custom.css +0 -0
  180. package/src/__tests__/fixtures/releases/0.10.0/site-export/themes/jant/static/favicon.ico +0 -0
  181. package/src/__tests__/fixtures/releases/0.10.0/site-export/wrangler.jsonc +24 -0
  182. package/src/__tests__/fixtures/releases/0.10.0/snapshot/db.sql +322 -0
  183. package/src/__tests__/fixtures/releases/0.10.0/snapshot/meta.json +11 -0
  184. package/src/__tests__/fixtures/releases/0.11.0/site-export/README.md +130 -0
  185. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/297kg/_index.md +14 -0
  186. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/2thjq/_index.md +25 -0
  187. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/2u5e5/_index.md +33 -0
  188. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/41q27/0x4nv/index.md +18 -0
  189. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/41q27/_index.md +42 -0
  190. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/41q27/faqyt/index.md +28 -0
  191. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/41q27/the-potting-mix-guide-i-keep-rereading/index.md +20 -0
  192. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/5kayp/_index.md +23 -0
  193. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/5ynfs/_index.md +31 -0
  194. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/5ynfs/hu597/index.md +21 -0
  195. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/_index.md +5 -0
  196. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/a-night-heron-field-guide-for-my-walk-folder/_index.md +31 -0
  197. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/a-quiet-saturday-after-a-busy-week/_index.md +36 -0
  198. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/archive/_index.md +8 -0
  199. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/are-na-is-the-only-bookmark-pile-i-still-revisit/_index.md +30 -0
  200. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/bought-too-many-lemons-again/_index.md +35 -0
  201. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/city-walks/_index.md +14 -0
  202. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/cleanshot-for-screenshots-ocr-and-screen-recording-on-the-mac/_index.md +33 -0
  203. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/cleanshotmac-shang-de-jie-tu-ocr-lu-ping-gong-ju/_index.md +32 -0
  204. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/co344/_index.md +25 -0
  205. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/collections/_index.md +5 -0
  206. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/current-tea-rotation/_index.md +34 -0
  207. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/derek-sivers-still-writes-the-kind-of-internet-i-want-more-of/_index.md +30 -0
  208. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/desk-but-better/_index.md +25 -0
  209. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/e0kcg/_index.md +22 -0
  210. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/egi3c/_index.md +24 -0
  211. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/evf9j/_index.md +129 -0
  212. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/featured/_index.md +8 -0
  213. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/fixture-draft/_index.md +17 -0
  214. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/fixture-quotes/_index.md +13 -0
  215. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/fixture-text-attachment/_index.md +29 -0
  216. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/from-basho/_index.md +25 -0
  217. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/from-epictetus/_index.md +25 -0
  218. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/from-marcus-aurelius/_index.md +25 -0
  219. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/from-seneca/_index.md +26 -0
  220. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/from-thoreau/_index.md +25 -0
  221. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/gkbvv/2cl6d/index.md +18 -0
  222. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/gkbvv/3zqv7/index.md +28 -0
  223. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/gkbvv/5oxsv/index.md +18 -0
  224. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/gkbvv/_index.md +37 -0
  225. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/gwob9/_index.md +25 -0
  226. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/home-cooking/_index.md +12 -0
  227. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/hz729/_index.md +24 -0
  228. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/inaturalist-ai-zi-ran-she-qu/_index.md +42 -0
  229. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/j4v0q/_index.md +33 -0
  230. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/k278t/_index.md +25 -0
  231. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/k4eee/_index.md +22 -0
  232. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/k5vh8/_index.md +32 -0
  233. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/k5vh8/a-reading-log-idea-i-might-steal/index.md +20 -0
  234. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/k5vh8/a83qu/index.md +18 -0
  235. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/k5vh8/from-seneca-5hibo/index.md +21 -0
  236. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/kan-qi-lai-bi-jiao-ku-de-gong-si-men/_index.md +41 -0
  237. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/l2m7y/_index.md +29 -0
  238. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/lan-ya-yao-kong-qi-chuang-shang-yue-du-de-fan-ye-shen-qi/_index.md +52 -0
  239. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/mynoise-for-rainy-afternoons/_index.md +30 -0
  240. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/n09le/_index.md +23 -0
  241. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/ni-fu-jin-de-wei-ji-bai-ke-tiao-mu/_index.md +40 -0
  242. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/nts-archives-are-good-cleaning-music/_index.md +30 -0
  243. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/qgfcu/_index.md +32 -0
  244. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/qgfcu/c91j0/index.md +18 -0
  245. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/qgfcu/qyucy/index.md +18 -0
  246. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/qgfcu/wsgck/index.md +18 -0
  247. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/rain-makes-my-neighborhood-look-better/_index.md +44 -0
  248. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/reading-notes/_index.md +12 -0
  249. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/s4r3e/_index.md +25 -0
  250. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/serious-eats-on-tomato-and-egg-soup/_index.md +30 -0
  251. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/te812/_index.md +42 -0
  252. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/te812/cxiu6/index.md +18 -0
  253. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/te812/t77ms/index.md +18 -0
  254. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/te812/the-soup-trick-i-always-forget/index.md +20 -0
  255. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/telk3/_index.md +30 -0
  256. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/telk3/from-thoreau-pawt2/index.md +21 -0
  257. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/the-five-minute-reset-is-still-the-best-habit-i-have/_index.md +36 -0
  258. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/the-hallway-light-took-12-minutes-and-3-months/_index.md +32 -0
  259. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/the-recurse-center-manual-is-weirdly-calming/_index.md +30 -0
  260. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/tiny-projects/_index.md +12 -0
  261. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/tong-wang-xing-fu-zhi-lu/_index.md +68 -0
  262. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/tou-ma-yan-jiang-ju-le-bu-chu-ti-yan/_index.md +62 -0
  263. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/useful-links/_index.md +12 -0
  264. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/weekend-notes/_index.md +12 -0
  265. package/src/__tests__/fixtures/releases/0.11.0/site-export/content/what-i-actually-use-my-notebook-for/_index.md +50 -0
  266. package/src/__tests__/fixtures/releases/0.11.0/site-export/data/jant.toml +155 -0
  267. package/src/__tests__/fixtures/releases/0.11.0/site-export/hugo.toml +45 -0
  268. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/_redirects +30 -0
  269. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/3c46a9ea6fe0-med_01kn8jtq3penf98tfq4gzmh9g9.png +0 -0
  270. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01kn8jtx8qenf98tm9ahxr48sw.webp +0 -0
  271. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01kn8jv0jdenf98tp6qr9zgjjc.webp +0 -0
  272. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01kn8jv452enf98trbkwrvhvgd.webp +0 -0
  273. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01kn8jvb16enf98txp7p0pf5ge.webp +0 -0
  274. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01kn8jve5nenf98tzap11gpxzr.webp +0 -0
  275. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01kn8jvq58enf98v538w5vsqp4.webp +0 -0
  276. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01kn8jvsaeenf98v6ct4gjzppc.webp +0 -0
  277. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01kn8jw26cenf98vc7k0ppz5k8.webp +0 -0
  278. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01m313q1hme4e8cmby77dn66yy.webp +0 -0
  279. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01m313q2w7e4e8cmc20036yh66.webp +0 -0
  280. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01m313q7d2e4e8cmdeqjmyafby.webp +0 -0
  281. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01m313q887e4e8cmdjssych7yh.webp +0 -0
  282. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01m3167jx2f6ct88pkz45j3ycp-poster.webp +0 -0
  283. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01m3167jx2f6ct88pkz45j3ycp.mp4 +0 -0
  284. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01m3167mbdf6ct88pr4ga1b9kf-poster.webp +0 -0
  285. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01m3167mbdf6ct88pr4ga1b9kf.mp4 +0 -0
  286. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01m3167nsvf6ct88q1anhz4svb-poster.webp +0 -0
  287. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01m3167nsvf6ct88q1anhz4svb.mp4 +0 -0
  288. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01m3167qaxf6ct88qfndwzxx83-poster.webp +0 -0
  289. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01m3167qaxf6ct88qfndwzxx83.mp4 +0 -0
  290. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01m3167sm0f6ct88qw5brtsgcw.webp +0 -0
  291. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01m3167tf8f6ct88r169s51j49.webp +0 -0
  292. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01m3167vaaf6ct88rbx5ztenwb.webp +0 -0
  293. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01m3167w51f6ct88rp19pybkw1.webp +0 -0
  294. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01m3167x0nf6ct88rzajb84tw3.webp +0 -0
  295. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01m3167xxbf6ct88s5t2300bjk.webp +0 -0
  296. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01m3167yq5f6ct88s9pjwt5fxg.webp +0 -0
  297. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01m3167zg4f6ct88sge8jp28ja.webp +0 -0
  298. package/src/__tests__/fixtures/releases/0.11.0/site-export/static/media/med_01m50607a6e8h8gfpa8byqtt7h.md +3 -0
  299. package/src/__tests__/fixtures/releases/0.11.0/site-export/themes/jant/static/apple-touch-icon.png +0 -0
  300. package/src/__tests__/fixtures/releases/0.11.0/site-export/themes/jant/static/custom.css +0 -0
  301. package/src/__tests__/fixtures/releases/0.11.0/site-export/themes/jant/static/favicon.ico +0 -0
  302. package/src/__tests__/fixtures/releases/0.11.0/site-export/wrangler.jsonc +24 -0
  303. package/src/__tests__/fixtures/releases/0.11.0/snapshot/db.sql +339 -0
  304. package/src/__tests__/fixtures/releases/0.11.0/snapshot/meta.json +11 -0
  305. package/src/__tests__/helpers/app.ts +6 -1
  306. package/src/__tests__/helpers/d1-round-trips.ts +213 -0
  307. package/src/__tests__/helpers/export-fixtures.ts +1 -0
  308. package/src/__tests__/import-refused-aliases.test.ts +98 -0
  309. package/src/__tests__/import-site-command.test.ts +73 -8
  310. package/src/__tests__/package-dependencies.test.ts +123 -0
  311. package/src/__tests__/public-page-round-trips.test.ts +203 -0
  312. package/src/__tests__/public-types.test.ts +64 -0
  313. package/src/__tests__/release-fixtures.test.ts +79 -24
  314. package/src/__tests__/release-version.test.ts +84 -0
  315. package/src/__tests__/site-pull-media.test.ts +48 -0
  316. package/src/__tests__/snapshot-tables.test.ts +37 -0
  317. package/src/__tests__/sql-export.test.ts +21 -1
  318. package/src/__tests__/stored-file-headers.test.ts +94 -0
  319. package/src/__tests__/template-deploy-workflow.test.ts +57 -0
  320. package/src/__tests__/theme-docs.test.ts +113 -24
  321. package/src/__tests__/toolchain-versions.test.ts +54 -0
  322. package/src/__tests__/trailing-slash-redirect.test.ts +61 -0
  323. package/src/__tests__/vite-config-graph.test.ts +98 -0
  324. package/src/__tests__/vite-config.test.ts +32 -0
  325. package/src/app.tsx +96 -67
  326. package/src/client/__tests__/compose-bridge-image-upload.test.ts +1 -0
  327. package/src/client/__tests__/compose-bridge.test.ts +87 -0
  328. package/src/client/__tests__/compose-shortcuts.test.ts +4 -4
  329. package/src/client/__tests__/footnote-rail.test.ts +1 -1
  330. package/src/client/__tests__/lazy-entries.test.ts +1 -1
  331. package/src/client/__tests__/media-scroll-hint.test.ts +2 -2
  332. package/src/client/avatar-upload.ts +10 -10
  333. package/src/client/components/__tests__/jant-compose-dialog.test.ts +295 -4
  334. package/src/client/components/__tests__/jant-compose-editor.test.ts +34 -0
  335. package/src/client/components/__tests__/jant-settings-general.test.ts +0 -32
  336. package/src/client/components/compose-types.ts +14 -0
  337. package/src/client/components/jant-compose-dialog.ts +96 -41
  338. package/src/client/components/jant-compose-editor.ts +21 -4
  339. package/src/client/components/jant-config-editor.ts +4 -6
  340. package/src/client/components/jant-media-lightbox.ts +4 -4
  341. package/src/client/components/jant-settings-general.ts +0 -4
  342. package/src/client/components/nav-manager-types.ts +6 -5
  343. package/src/client/compose-bridge.ts +15 -4
  344. package/src/client/compose-launch.ts +4 -6
  345. package/src/client/compose-shortcuts.ts +1 -1
  346. package/src/client/footnote-rail.ts +1 -1
  347. package/src/client/icons.ts +5 -6
  348. package/src/client/lazy-entries.ts +1 -1
  349. package/src/client/media-scroll-hint.ts +2 -2
  350. package/src/client/tiptap/__tests__/markdown-clipboard.test.ts +55 -0
  351. package/src/client/tiptap/markdown-clipboard.ts +50 -2
  352. package/src/client/upload-session.ts +7 -6
  353. package/src/db/__tests__/backfill-external-redirects.test.ts +59 -0
  354. package/src/db/__tests__/backfill-featured-discover.test.ts +56 -0
  355. package/src/db/__tests__/d1-query.test.ts +29 -0
  356. package/src/db/__tests__/migration-rehearsal.test.ts +2 -2
  357. package/src/db/backfills/0007_restore_external_redirect_scheme.sql +20 -0
  358. package/src/db/backfills/0008_turn_off_featured_only_discover.sql +11 -0
  359. package/src/i18n/locales/public/en.po +46 -48
  360. package/src/i18n/locales/public/en.ts +1 -1
  361. package/src/i18n/locales/public/zh-Hans.po +45 -46
  362. package/src/i18n/locales/public/zh-Hans.ts +1 -1
  363. package/src/i18n/locales/public/zh-Hant.po +45 -46
  364. package/src/i18n/locales/public/zh-Hant.ts +1 -1
  365. package/src/i18n/locales/settings/en.po +15 -29
  366. package/src/i18n/locales/settings/en.ts +1 -1
  367. package/src/i18n/locales/settings/zh-Hans.po +15 -29
  368. package/src/i18n/locales/settings/zh-Hans.ts +1 -1
  369. package/src/i18n/locales/settings/zh-Hant.po +15 -29
  370. package/src/i18n/locales/settings/zh-Hant.ts +1 -1
  371. package/src/index.ts +43 -2
  372. package/src/lib/__tests__/api-settings.test.ts +3 -3
  373. package/src/lib/__tests__/constants.test.ts +10 -0
  374. package/src/lib/__tests__/discover.test.ts +8 -9
  375. package/src/lib/__tests__/env-values.test.ts +125 -0
  376. package/src/lib/__tests__/feed-path.test.ts +29 -0
  377. package/src/lib/__tests__/feed.test.ts +50 -22
  378. package/src/lib/__tests__/filter-dimensions.test.ts +22 -8
  379. package/src/lib/__tests__/icons.test.ts +21 -10
  380. package/src/lib/__tests__/post-list-cursor.test.ts +0 -10
  381. package/src/lib/__tests__/rate-limit.test.ts +22 -7
  382. package/src/lib/__tests__/resolve-config.test.ts +5 -3
  383. package/src/lib/__tests__/schemas.test.ts +72 -23
  384. package/src/lib/__tests__/slugify.test.ts +9 -0
  385. package/src/lib/__tests__/startup-config.test.ts +12 -0
  386. package/src/lib/__tests__/storage-s3.test.ts +214 -0
  387. package/src/lib/__tests__/theme.test.ts +20 -1
  388. package/src/lib/__tests__/time.test.ts +56 -0
  389. package/src/lib/__tests__/timeline.test.ts +46 -0
  390. package/src/lib/__tests__/url-fetch.test.ts +65 -1
  391. package/src/lib/__tests__/url.test.ts +60 -1
  392. package/src/lib/api-nav-items.ts +16 -20
  393. package/src/lib/api-post-input.ts +34 -1
  394. package/src/lib/api-posts.ts +128 -24
  395. package/src/lib/api-public-posts.ts +31 -38
  396. package/src/lib/api-search.ts +49 -2
  397. package/src/lib/api-settings.ts +159 -54
  398. package/src/lib/api-threads.ts +34 -11
  399. package/src/lib/constants.ts +26 -0
  400. package/src/lib/discover.ts +7 -23
  401. package/src/lib/env-values.ts +140 -0
  402. package/src/lib/env.ts +203 -12
  403. package/src/lib/feed-path.ts +8 -2
  404. package/src/lib/feed-policy.ts +110 -7
  405. package/src/lib/feed.ts +69 -25
  406. package/src/lib/filter-dimensions.ts +17 -10
  407. package/src/lib/github-sync-site-config.ts +1 -0
  408. package/src/lib/hugo-markdown.ts +5 -6
  409. package/src/lib/icons.ts +96 -34
  410. package/src/lib/navigation.ts +4 -1
  411. package/src/lib/post-display.ts +13 -9
  412. package/src/lib/post-list-cursor.ts +33 -29
  413. package/src/lib/public-storage.ts +43 -0
  414. package/src/lib/rate-limit.ts +31 -16
  415. package/src/lib/render.tsx +5 -0
  416. package/src/lib/resolve-config.ts +16 -19
  417. package/src/lib/schemas.ts +248 -180
  418. package/src/lib/slugify.ts +6 -1
  419. package/src/lib/sse.ts +1 -1
  420. package/src/lib/startup-config.ts +20 -1
  421. package/src/lib/theme.ts +8 -5
  422. package/src/lib/thread-fold.ts +6 -0
  423. package/src/lib/thread-query.ts +19 -24
  424. package/src/lib/time.ts +137 -17
  425. package/src/lib/timeline.ts +76 -31
  426. package/src/lib/url-fetch.ts +141 -40
  427. package/src/lib/url.ts +86 -1
  428. package/src/lib/view.ts +3 -2
  429. package/src/middleware/__tests__/auth.test.ts +27 -0
  430. package/src/middleware/__tests__/cors.test.ts +54 -0
  431. package/src/middleware/__tests__/cross-origin.test.ts +149 -0
  432. package/src/middleware/__tests__/onboarding.test.ts +5 -3
  433. package/src/middleware/__tests__/public-content-access.test.ts +2 -42
  434. package/src/middleware/__tests__/secure-headers.test.ts +40 -42
  435. package/src/middleware/auth.ts +34 -3
  436. package/src/middleware/config.ts +44 -2
  437. package/src/middleware/cors.ts +4 -4
  438. package/src/middleware/cross-origin.ts +124 -0
  439. package/src/middleware/error-handler.ts +7 -0
  440. package/src/middleware/onboarding.ts +12 -3
  441. package/src/middleware/public-content-access.ts +3 -26
  442. package/src/middleware/secure-headers.ts +32 -37
  443. package/src/node/__tests__/cli-deploy-setup.test.ts +373 -0
  444. package/src/node/__tests__/cli-deploy.test.ts +55 -0
  445. package/src/node/__tests__/cli-migrate.test.ts +2 -2
  446. package/src/node/__tests__/cli-runtime-target.test.ts +13 -2
  447. package/src/node/__tests__/cli-site-snapshot.test.ts +57 -0
  448. package/src/node/__tests__/cli-snapshot-meta.test.ts +11 -1
  449. package/src/node/__tests__/cli-sql-export.test.ts +25 -1
  450. package/src/node/__tests__/cli-start.test.ts +66 -0
  451. package/src/node/__tests__/request-handler.test.ts +37 -0
  452. package/src/node/__tests__/runtime.test.ts +56 -1
  453. package/src/node/request-handler.ts +58 -5
  454. package/src/node/runtime.ts +37 -11
  455. package/src/preset.css +3 -3
  456. package/src/routes/__tests__/compose.test.ts +84 -0
  457. package/src/routes/api/__tests__/collections.test.ts +68 -0
  458. package/src/routes/api/__tests__/mcp.test.ts +164 -9
  459. package/src/routes/api/__tests__/media.test.ts +9 -1
  460. package/src/routes/api/__tests__/nav-items.test.ts +27 -1
  461. package/src/routes/api/__tests__/posts.test.ts +269 -78
  462. package/src/routes/api/__tests__/search.test.ts +17 -4
  463. package/src/routes/api/__tests__/settings.test.ts +119 -85
  464. package/src/routes/api/__tests__/telegram.test.ts +11 -6
  465. package/src/routes/api/__tests__/threads.test.ts +11 -0
  466. package/src/routes/api/__tests__/upload-response.test.ts +48 -0
  467. package/src/routes/api/__tests__/uploads.test.ts +35 -2
  468. package/src/routes/api/collections.ts +3 -3
  469. package/src/routes/api/custom-urls.ts +2 -1
  470. package/src/routes/api/export.ts +1 -0
  471. package/src/routes/api/internal/__tests__/post-body-html.test.ts +19 -0
  472. package/src/routes/api/internal/__tests__/uploads.test.ts +2 -0
  473. package/src/routes/api/internal/sites.ts +16 -4
  474. package/src/routes/api/mcp.ts +1 -0
  475. package/src/routes/api/media.ts +7 -8
  476. package/src/routes/api/nav-items.ts +2 -1
  477. package/src/routes/api/posts.ts +18 -24
  478. package/src/routes/api/public/__tests__/posts.test.ts +15 -0
  479. package/src/routes/api/public/__tests__/threads-collections.test.ts +12 -45
  480. package/src/routes/api/public/__tests__/threads.test.ts +41 -9
  481. package/src/routes/api/public/posts.ts +2 -2
  482. package/src/routes/api/public/threads.ts +16 -26
  483. package/src/routes/api/search.ts +7 -41
  484. package/src/routes/api/settings.ts +32 -28
  485. package/src/routes/api/smart-collections.ts +6 -1
  486. package/src/routes/api/threads.ts +25 -26
  487. package/src/routes/api/upload.ts +6 -21
  488. package/src/routes/api/uploads.ts +14 -20
  489. package/src/routes/auth/__tests__/dev.test.ts +16 -13
  490. package/src/routes/auth/__tests__/hosted-sso.test.ts +51 -0
  491. package/src/routes/auth/__tests__/setup-auth.test.ts +2 -0
  492. package/src/routes/auth/__tests__/setup-discover.test.ts +2 -0
  493. package/src/routes/auth/__tests__/setup-flow.test.ts +32 -0
  494. package/src/routes/auth/__tests__/setup-rate-limit.test.ts +72 -0
  495. package/src/routes/auth/__tests__/setup-steps.test.ts +2 -0
  496. package/src/routes/auth/__tests__/signin.test.ts +167 -2
  497. package/src/routes/auth/dev.ts +4 -6
  498. package/src/routes/auth/hosted-sso.ts +9 -6
  499. package/src/routes/auth/setup.tsx +35 -5
  500. package/src/routes/auth/signin.tsx +96 -1
  501. package/src/routes/compose.tsx +47 -47
  502. package/src/routes/dash/__tests__/settings-avatar.test.ts +59 -4
  503. package/src/routes/dash/__tests__/settings-demo-locks.test.ts +147 -0
  504. package/src/routes/dash/custom-urls.tsx +2 -0
  505. package/src/routes/dash/settings.tsx +79 -32
  506. package/src/routes/feed/__tests__/feed.test.ts +93 -3
  507. package/src/routes/feed/__tests__/sitemap.test.ts +42 -0
  508. package/src/routes/feed/feed.ts +130 -175
  509. package/src/routes/feed/sitemap.ts +9 -7
  510. package/src/routes/pages/__tests__/archive-years.test.ts +45 -0
  511. package/src/routes/pages/__tests__/collection-routing.test.ts +40 -0
  512. package/src/routes/pages/__tests__/collections.test.ts +3 -0
  513. package/src/routes/pages/__tests__/language-routing.test.ts +31 -0
  514. package/src/routes/pages/__tests__/post-page-round-trips.test.ts +44 -12
  515. package/src/routes/pages/__tests__/search.test.ts +5 -2
  516. package/src/routes/pages/__tests__/thread-gap.test.ts +207 -0
  517. package/src/routes/pages/archive.tsx +69 -111
  518. package/src/routes/pages/brand.tsx +1 -0
  519. package/src/routes/pages/collection.tsx +86 -120
  520. package/src/routes/pages/collections.tsx +2 -0
  521. package/src/routes/pages/featured.tsx +7 -2
  522. package/src/routes/pages/home.tsx +1 -0
  523. package/src/routes/pages/latest.tsx +6 -2
  524. package/src/routes/pages/new.tsx +1 -0
  525. package/src/routes/pages/page.tsx +113 -66
  526. package/src/routes/pages/search.tsx +8 -4
  527. package/src/routes/pages/smart-collection.tsx +11 -70
  528. package/src/routes/pages/subscribe.tsx +1 -0
  529. package/src/routes/pages/theme-sample.tsx +1 -0
  530. package/src/runtime/__tests__/readiness.test.ts +16 -0
  531. package/src/runtime/cloudflare.ts +2 -3
  532. package/src/runtime/index.ts +3 -1
  533. package/src/runtime/node.ts +3 -5
  534. package/src/runtime/readiness.ts +5 -0
  535. package/src/services/__tests__/auth.test.ts +115 -0
  536. package/src/services/__tests__/collection.test.ts +11 -4
  537. package/src/services/__tests__/github-sync-webhook.test.ts +78 -0
  538. package/src/services/__tests__/hosted-handoff.test.ts +208 -1
  539. package/src/services/__tests__/media.test.ts +47 -27
  540. package/src/services/__tests__/navigation.test.ts +67 -15
  541. package/src/services/__tests__/post.test.ts +103 -56
  542. package/src/services/__tests__/search.test.ts +38 -0
  543. package/src/services/__tests__/settings.test.ts +2 -14
  544. package/src/services/__tests__/smart-collection.test.ts +2 -2
  545. package/src/services/__tests__/telegram-ingest.test.ts +113 -0
  546. package/src/services/__tests__/thread.test.ts +26 -11
  547. package/src/services/auth.ts +36 -4
  548. package/src/services/collection.ts +141 -76
  549. package/src/services/custom-url.ts +11 -4
  550. package/src/services/export-theme/assets/client-site.css +1 -1
  551. package/src/services/export-theme/assets/client-site.js +2 -2
  552. package/src/services/export-theme/layouts/_default/baseof.html +1 -1
  553. package/src/services/export-theme/layouts/collection/single.html +1 -1
  554. package/src/services/export-theme/layouts/partials/featured-thread.html +8 -1
  555. package/src/services/export-theme/layouts/partials/head.html +1 -1
  556. package/src/services/export-theme/layouts/partials/media-gallery.html +6 -3
  557. package/src/services/export-theme/layouts/smart_collection/list.html +1 -1
  558. package/src/services/export-theme/styles/main.css +3 -3
  559. package/src/services/export.ts +70 -20
  560. package/src/services/github-sync.ts +10 -10
  561. package/src/services/hosted-handoff.ts +106 -6
  562. package/src/services/index.ts +3 -1
  563. package/src/services/language.ts +33 -0
  564. package/src/services/mcp.ts +176 -438
  565. package/src/services/media.ts +69 -21
  566. package/src/services/navigation.ts +19 -4
  567. package/src/services/path.ts +45 -3
  568. package/src/services/post.ts +460 -400
  569. package/src/services/search.ts +22 -3
  570. package/src/services/settings.ts +40 -11
  571. package/src/services/site-admin.ts +1 -0
  572. package/src/services/smart-collection.ts +10 -3
  573. package/src/services/telegram.ts +23 -6
  574. package/src/services/thread.ts +11 -3
  575. package/src/services/upload-session.ts +14 -15
  576. package/src/styles/components.css +2 -2
  577. package/src/styles/site-media.css +2 -2
  578. package/src/styles/tokens.css +19 -22
  579. package/src/styles/ui-author.css +73 -94
  580. package/src/styles/ui.css +62 -62
  581. package/src/types/app-context.ts +10 -1
  582. package/src/types/bindings.ts +11 -0
  583. package/src/types/config.ts +4 -4
  584. package/src/types/constants.ts +20 -0
  585. package/src/types/props.ts +34 -8
  586. package/src/types/views.ts +28 -13
  587. package/src/ui/color-themes.ts +6 -5
  588. package/src/ui/dash/settings/GeneralContent.tsx +0 -22
  589. package/src/ui/dash/settings/__tests__/GeneralContent.test.tsx +0 -21
  590. package/src/ui/feed/CuratedThreadPreview.tsx +7 -2
  591. package/src/ui/feed/LinkCard.tsx +1 -2
  592. package/src/ui/feed/NoteCard.tsx +1 -2
  593. package/src/ui/feed/QuoteCard.tsx +2 -2
  594. package/src/ui/feed/ThreadPreview.tsx +6 -6
  595. package/src/ui/feed/TimelineFeed.tsx +1 -7
  596. package/src/ui/feed/__tests__/thread-preview.test.ts +123 -10
  597. package/src/ui/feed/__tests__/timeline-cards.test.ts +18 -1
  598. package/src/ui/layouts/BaseLayout.tsx +5 -0
  599. package/src/ui/pages/ArchivePage.tsx +35 -35
  600. package/src/ui/pages/BrandPage.tsx +1 -1
  601. package/src/ui/pages/CollectionPage.tsx +1 -2
  602. package/src/ui/pages/CollectionsPage.tsx +2 -2
  603. package/src/ui/pages/ComposePage.tsx +1 -1
  604. package/src/ui/pages/FeaturedPage.tsx +1 -1
  605. package/src/ui/pages/HomePage.tsx +1 -1
  606. package/src/ui/pages/PostPage.tsx +1 -1
  607. package/src/ui/pages/SearchPage.tsx +1 -1
  608. package/src/ui/pages/SmartCollectionPage.tsx +4 -5
  609. package/src/ui/pages/SubscribePage.tsx +3 -5
  610. package/src/ui/pages/ThemeSamplePage.tsx +1 -1
  611. package/src/ui/shared/CollectionDirectory.tsx +2 -2
  612. package/src/ui/shared/CollectionsManager.tsx +1 -1
  613. package/src/ui/shared/CopyField.tsx +1 -1
  614. package/src/ui/shared/Icon.tsx +5 -5
  615. package/src/ui/shared/IconSprite.tsx +10 -11
  616. package/src/ui/shared/MediaGallery.tsx +1 -1
  617. package/src/ui/shared/custom-icons.ts +38 -7
  618. package/src/ui/shared/icon-collector.ts +7 -5
  619. package/src/vendor/datastar.js +9 -1956
  620. package/src/vendor/datastar.js.map +4 -4
  621. package/dist/client/_assets/chunks/sortable-list-BJyd-LXE.js +0 -2
  622. package/dist/client/_assets/chunks/unsafe-svg-DU_DNMy5.js +0 -2
  623. package/dist/client/_assets/client-D4AT9Iqr.js +0 -295
  624. package/dist/client/_assets/client-DRuw7XCt.css +0 -2
  625. package/dist/client/_assets/client-author-DQ8R-8KR.css +0 -2
@@ -0,0 +1,140 @@
1
+ /**
2
+ * Environment values
3
+ *
4
+ * The one reader for a setting's environment variable, and the startup check
5
+ * that names every environment value Jant can't use.
6
+ *
7
+ * A setting the dashboard can also change is checked by the rules the
8
+ * dashboard applies (`normalizeEditableSettingValue`) and read back in the
9
+ * form the dashboard stores. `PUBLIC_API_ENABLED=TRUE` therefore means what
10
+ * `true` means, both where the site acts on it and where `GET /api/settings`
11
+ * reports it. An environment-only variable is checked by its rule in
12
+ * `ENV_RULES`.
13
+ */
14
+
15
+ import { CONFIG_FIELDS, type ConfigKey } from "../types/config.js";
16
+ import {
17
+ checkEnvValue,
18
+ ENV_RULES,
19
+ getEnvString,
20
+ hasEnvRule,
21
+ type EnvValueCheck,
22
+ } from "./env.js";
23
+ import { ValidationError } from "./errors.js";
24
+ import { normalizeEditableSettingValue } from "./schemas.js";
25
+
26
+ type EnvSource = object | undefined | null;
27
+
28
+ /** An environment variable holding a value Jant can't use. */
29
+ export interface EnvValueIssue {
30
+ variable: string;
31
+ message: string;
32
+ }
33
+
34
+ function checkConfigEnvValue(
35
+ key: ConfigKey,
36
+ variable: string,
37
+ raw: string,
38
+ ): EnvValueCheck {
39
+ const field = CONFIG_FIELDS[key];
40
+ if ("editor" in field) {
41
+ try {
42
+ return { ok: true, value: normalizeEditableSettingValue(key, raw) };
43
+ } catch (error) {
44
+ if (error instanceof ValidationError) {
45
+ return { ok: false, message: error.message };
46
+ }
47
+ throw error;
48
+ }
49
+ }
50
+ return hasEnvRule(variable)
51
+ ? checkEnvValue(variable, raw)
52
+ : { ok: true, value: raw };
53
+ }
54
+
55
+ function configEnvKeys(key: ConfigKey): readonly string[] {
56
+ const field = CONFIG_FIELDS[key];
57
+ return "envKeys" in field ? field.envKeys : [];
58
+ }
59
+
60
+ /**
61
+ * A setting's value from the environment, in the form the dashboard stores.
62
+ *
63
+ * @param env - Runtime environment bindings
64
+ * @param key - The setting
65
+ * @returns The first of its variables that is set, normalized; `undefined`
66
+ * when none is set or the value is one the startup check reports
67
+ * @example
68
+ * ```ts
69
+ * readConfigEnvValue({ PUBLIC_API_ENABLED: "TRUE" }, "PUBLIC_API_ENABLED");
70
+ * // "true"
71
+ * ```
72
+ */
73
+ export function readConfigEnvValue(
74
+ env: EnvSource,
75
+ key: ConfigKey,
76
+ ): string | undefined {
77
+ for (const variable of configEnvKeys(key)) {
78
+ const raw = getEnvString(env, variable)?.trim();
79
+ if (!raw) continue;
80
+ const checked = checkConfigEnvValue(key, variable, raw);
81
+ return checked.ok ? checked.value : undefined;
82
+ }
83
+ return undefined;
84
+ }
85
+
86
+ function issue(variable: string, raw: string, message: string): EnvValueIssue {
87
+ return { variable, message: `${variable} can't be "${raw}". ${message}` };
88
+ }
89
+
90
+ /**
91
+ * Every environment value Jant can't use: a setting's variable the dashboard
92
+ * would refuse, and an environment-only variable outside its rule.
93
+ *
94
+ * @param env - Runtime environment bindings
95
+ * @returns One issue per variable, in no particular order; empty when all
96
+ * values are usable
97
+ * @example
98
+ * ```ts
99
+ * getEnvValueIssues({ PAGE_SIZE: "500" });
100
+ * // [{ variable: "PAGE_SIZE", message: 'PAGE_SIZE can\'t be "500". …' }]
101
+ * ```
102
+ */
103
+ export function getEnvValueIssues(env: EnvSource): EnvValueIssue[] {
104
+ // The check runs before every request; bindings don't change while a
105
+ // Worker isolate or a Node process lives, so one answer per object serves.
106
+ if (env) {
107
+ const cached = issuesByEnv.get(env);
108
+ if (cached) return cached;
109
+ }
110
+ const issues = collectEnvValueIssues(env);
111
+ if (env) issuesByEnv.set(env, issues);
112
+ return issues;
113
+ }
114
+
115
+ const issuesByEnv = new WeakMap<object, EnvValueIssue[]>();
116
+
117
+ function collectEnvValueIssues(env: EnvSource): EnvValueIssue[] {
118
+ const issues: EnvValueIssue[] = [];
119
+ const checked = new Set<string>();
120
+
121
+ for (const key of Object.keys(CONFIG_FIELDS) as ConfigKey[]) {
122
+ for (const variable of configEnvKeys(key)) {
123
+ checked.add(variable);
124
+ const raw = getEnvString(env, variable)?.trim();
125
+ if (!raw) continue;
126
+ const result = checkConfigEnvValue(key, variable, raw);
127
+ if (!result.ok) issues.push(issue(variable, raw, result.message));
128
+ }
129
+ }
130
+
131
+ for (const variable of Object.keys(ENV_RULES)) {
132
+ if (checked.has(variable) || !hasEnvRule(variable)) continue;
133
+ const raw = getEnvString(env, variable)?.trim();
134
+ if (!raw) continue;
135
+ const result = checkEnvValue(variable, raw);
136
+ if (!result.ok) issues.push(issue(variable, raw, result.message));
137
+ }
138
+
139
+ return issues;
140
+ }
package/src/lib/env.ts CHANGED
@@ -1,3 +1,4 @@
1
+ import { STORAGE_DRIVERS } from "../types/constants.js";
1
2
  import { normalizeDisplayText } from "./display-text.js";
2
3
  import { buildSiteUrl, normalizeSitePathPrefix } from "./url.js";
3
4
 
@@ -62,6 +63,192 @@ export function getEnvString(
62
63
  return undefined;
63
64
  }
64
65
 
66
+ /** What an environment-only variable may hold. */
67
+ type EnvRule =
68
+ | { kind: "boolean" }
69
+ | { kind: "integer"; min: number; max?: number }
70
+ | { kind: "enum"; options: readonly string[] }
71
+ | { kind: "origin" };
72
+
73
+ /**
74
+ * The typed environment-only variables and what each may hold.
75
+ *
76
+ * A variable the dashboard can also set is checked by its Config Editor
77
+ * definition instead, so the two can't disagree; see `env-values.ts`. A value
78
+ * outside its rule is reported by the startup check, which stops the site
79
+ * from serving until it is fixed; the readers below treat it as unset.
80
+ */
81
+ export const ENV_RULES = {
82
+ PORT: { kind: "integer", min: 1, max: 65535 },
83
+ TRUST_PROXY: { kind: "boolean" },
84
+ DEMO_MODE: { kind: "boolean" },
85
+ RATE_LIMIT_ENABLED: { kind: "boolean" },
86
+ RATE_LIMIT_SEARCH_PER_MIN: { kind: "integer", min: 0 },
87
+ UPLOAD_MAX_FILE_SIZE_MB: { kind: "integer", min: 1 },
88
+ SLUG_ID_LENGTH: { kind: "integer", min: 3, max: 32 },
89
+ STORAGE_DRIVER: { kind: "enum", options: STORAGE_DRIVERS },
90
+ SITE_RESOLUTION_MODE: {
91
+ kind: "enum",
92
+ options: ["single-site", "host-based"],
93
+ },
94
+ DISCOVER: { kind: "enum", options: ["latest", "off"] },
95
+ SITE_ORIGIN: { kind: "origin" },
96
+ } as const satisfies Record<string, EnvRule>;
97
+
98
+ type EnvRuleVariable = keyof typeof ENV_RULES;
99
+ type EnvVariableOfKind<K extends EnvRule["kind"]> = {
100
+ [V in EnvRuleVariable]: (typeof ENV_RULES)[V]["kind"] extends K ? V : never;
101
+ }[EnvRuleVariable];
102
+
103
+ /** An environment variable that holds `true` or `false`. */
104
+ export type EnvBooleanVariable = EnvVariableOfKind<"boolean">;
105
+ /** An environment variable that holds a whole number. */
106
+ export type EnvIntegerVariable = EnvVariableOfKind<"integer">;
107
+ /** An environment variable that holds one of a fixed set of values. */
108
+ export type EnvEnumVariable = EnvVariableOfKind<"enum">;
109
+ type EnvEnumValue<V extends EnvEnumVariable> = (typeof ENV_RULES)[V] extends {
110
+ options: readonly (infer O)[];
111
+ }
112
+ ? O
113
+ : never;
114
+
115
+ /** A value checked against its rule: normalized, or why it can't be used. */
116
+ export type EnvValueCheck =
117
+ { ok: true; value: string } | { ok: false; message: string };
118
+
119
+ function describeIntegerRange(rule: { min: number; max?: number }): string {
120
+ return rule.max === undefined
121
+ ? `a whole number of at least ${rule.min}`
122
+ : `a whole number from ${rule.min} to ${rule.max}`;
123
+ }
124
+
125
+ function checkEnvRule(rule: EnvRule, raw: string): EnvValueCheck {
126
+ switch (rule.kind) {
127
+ case "boolean": {
128
+ const value = raw.toLowerCase();
129
+ return value === "true" || value === "false"
130
+ ? { ok: true, value }
131
+ : { ok: false, message: "Use true or false." };
132
+ }
133
+ case "integer": {
134
+ const value = Number(raw);
135
+ return /^-?\d+$/.test(raw) &&
136
+ value >= rule.min &&
137
+ (rule.max === undefined || value <= rule.max)
138
+ ? { ok: true, value: String(value) }
139
+ : { ok: false, message: `Use ${describeIntegerRange(rule)}.` };
140
+ }
141
+ case "enum":
142
+ return rule.options.includes(raw)
143
+ ? { ok: true, value: raw }
144
+ : { ok: false, message: `Use one of: ${rule.options.join(", ")}.` };
145
+ case "origin": {
146
+ const url = URL.canParse(raw) ? new URL(raw) : null;
147
+ return url &&
148
+ (url.protocol === "http:" || url.protocol === "https:") &&
149
+ url.pathname === "/" &&
150
+ !url.search &&
151
+ !url.hash
152
+ ? { ok: true, value: url.origin }
153
+ : {
154
+ ok: false,
155
+ message:
156
+ "Use an http:// or https:// origin such as https://example.com, and put any path in SITE_PATH_PREFIX.",
157
+ };
158
+ }
159
+ }
160
+ }
161
+
162
+ /**
163
+ * Check a value against the rule for an environment-only variable.
164
+ *
165
+ * @param variable - The variable, which must have a rule
166
+ * @param raw - Its trimmed, non-empty value
167
+ * @returns The normalized value, or what to change it to
168
+ * @example
169
+ * ```ts
170
+ * checkEnvValue("TRUST_PROXY", "TRUE"); // { ok: true, value: "true" }
171
+ * checkEnvValue("STORAGE_DRIVER", "S3").ok; // false
172
+ * ```
173
+ */
174
+ export function checkEnvValue(
175
+ variable: EnvRuleVariable,
176
+ raw: string,
177
+ ): EnvValueCheck {
178
+ return checkEnvRule(ENV_RULES[variable], raw);
179
+ }
180
+
181
+ /** Whether a variable has an environment-only rule. */
182
+ export function hasEnvRule(variable: string): variable is EnvRuleVariable {
183
+ return Object.hasOwn(ENV_RULES, variable);
184
+ }
185
+
186
+ function readRuledEnvValue(
187
+ env: EnvSource,
188
+ variable: EnvRuleVariable,
189
+ ): string | undefined {
190
+ const raw = getEnvString(env, variable)?.trim();
191
+ if (!raw) return undefined;
192
+ const checked = checkEnvValue(variable, raw);
193
+ return checked.ok ? checked.value : undefined;
194
+ }
195
+
196
+ /**
197
+ * A boolean environment variable, `true` and `false` in any case.
198
+ *
199
+ * @param env - Runtime environment bindings
200
+ * @param variable - The variable
201
+ * @returns Its value, or `undefined` when unset or not a boolean
202
+ * @example
203
+ * ```ts
204
+ * readEnvBoolean({ TRUST_PROXY: "TRUE" }, "TRUST_PROXY"); // true
205
+ * ```
206
+ */
207
+ export function readEnvBoolean(
208
+ env: EnvSource,
209
+ variable: EnvBooleanVariable,
210
+ ): boolean | undefined {
211
+ const value = readRuledEnvValue(env, variable);
212
+ return value === undefined ? undefined : value === "true";
213
+ }
214
+
215
+ /**
216
+ * A whole-number environment variable, within its range.
217
+ *
218
+ * @param env - Runtime environment bindings
219
+ * @param variable - The variable
220
+ * @returns Its value, or `undefined` when unset or out of range
221
+ * @example
222
+ * ```ts
223
+ * readEnvInteger({ SLUG_ID_LENGTH: "8" }, "SLUG_ID_LENGTH"); // 8
224
+ * ```
225
+ */
226
+ export function readEnvInteger(
227
+ env: EnvSource,
228
+ variable: EnvIntegerVariable,
229
+ ): number | undefined {
230
+ const value = readRuledEnvValue(env, variable);
231
+ return value === undefined ? undefined : Number(value);
232
+ }
233
+
234
+ /**
235
+ * An environment variable that names one of a fixed set of values.
236
+ *
237
+ * @param env - Runtime environment bindings
238
+ * @param variable - The variable
239
+ * @returns Its value, or `undefined` when unset or not one of the set
240
+ * @example
241
+ * ```ts
242
+ * readEnvEnum({ STORAGE_DRIVER: "s3" }, "STORAGE_DRIVER"); // "s3"
243
+ * ```
244
+ */
245
+ export function readEnvEnum<V extends EnvEnumVariable>(
246
+ env: EnvSource,
247
+ variable: V,
248
+ ): EnvEnumValue<V> | undefined {
249
+ return readRuledEnvValue(env, variable) as EnvEnumValue<V> | undefined;
250
+ }
251
+
65
252
  /**
66
253
  * Parse a TCP port from an environment value.
67
254
  *
@@ -101,8 +288,7 @@ export function getPort(env: EnvSource, fallback = DEFAULT_APP_PORT): number {
101
288
  }
102
289
 
103
290
  export function getSiteOrigin(env: EnvSource): string {
104
- const configuredOrigin = getEnvString(env, "SITE_ORIGIN");
105
- return configuredOrigin ? new URL(configuredOrigin).origin : "";
291
+ return readRuledEnvValue(env, "SITE_ORIGIN") ?? "";
106
292
  }
107
293
 
108
294
  export function getSitePathPrefix(env: EnvSource): string {
@@ -141,9 +327,7 @@ export function getConfiguredSingleSiteUrl(env: EnvSource): string {
141
327
  export function getSiteResolutionMode(
142
328
  env: EnvSource,
143
329
  ): "single-site" | "host-based" {
144
- return getEnvString(env, "SITE_RESOLUTION_MODE") === "host-based"
145
- ? "host-based"
146
- : "single-site";
330
+ return readEnvEnum(env, "SITE_RESOLUTION_MODE") ?? "single-site";
147
331
  }
148
332
 
149
333
  export function getAuthSecret(env: EnvSource): string | undefined {
@@ -331,11 +515,13 @@ export function getDiscoverDirectoryBaseUrl(
331
515
  * ```
332
516
  */
333
517
  export function getDiscoverDefault(env: EnvSource): string | undefined {
334
- return getEnvString(env, "DISCOVER");
518
+ return readEnvEnum(env, "DISCOVER");
335
519
  }
336
520
 
337
- export function getStorageDriverEnv(env: EnvSource): string | undefined {
338
- return getEnvString(env, "STORAGE_DRIVER");
521
+ export function getStorageDriverEnv(
522
+ env: EnvSource,
523
+ ): (typeof STORAGE_DRIVERS)[number] | undefined {
524
+ return readEnvEnum(env, "STORAGE_DRIVER");
339
525
  }
340
526
 
341
527
  export function getDataDir(env: EnvSource): string | undefined {
@@ -361,7 +547,9 @@ export function getDefaultStorageDriver(env: EnvSource): "local" | "r2" {
361
547
  return record["NODE_SQLITE"] || record["NODE_DATABASE"] ? "local" : "r2";
362
548
  }
363
549
 
364
- export function getConfiguredStorageDriver(env: EnvSource): string {
550
+ export function getConfiguredStorageDriver(
551
+ env: EnvSource,
552
+ ): (typeof STORAGE_DRIVERS)[number] {
365
553
  return getStorageDriverEnv(env) ?? getDefaultStorageDriver(env);
366
554
  }
367
555
 
@@ -378,13 +566,16 @@ export function getConfiguredStorageDriver(env: EnvSource): string {
378
566
  * getCorsOrigins({ CORS_ORIGINS: "https://a.com,chrome-extension://id" });
379
567
  * // ["https://a.com", "chrome-extension://id"]
380
568
  * getCorsOrigins({}); // "*"
569
+ * getCorsOrigins({ CORS_ORIGINS: "" }); // undefined
381
570
  * ```
382
571
  */
383
572
  export function getCorsOrigins(env: EnvSource): "*" | string[] | undefined {
384
- const raw = getEnvString(env, "CORS_ORIGINS") ?? "*";
385
- if (!raw) {
573
+ // Set but empty is a choice, unlike unset: it turns cross-origin access off.
574
+ const configured = toEnvRecord(env)["CORS_ORIGINS"];
575
+ if (typeof configured === "string" && configured.trim() === "") {
386
576
  return undefined;
387
577
  }
578
+ const raw = getEnvString(env, "CORS_ORIGINS")?.trim() ?? "*";
388
579
 
389
580
  if (raw === "*") {
390
581
  return "*";
@@ -432,7 +623,7 @@ export function getGitHubAppConfig(env: EnvSource): GitHubAppEnvConfig | null {
432
623
  }
433
624
 
434
625
  export function shouldTrustProxy(env: EnvSource): boolean {
435
- return getEnvString(env, "TRUST_PROXY") === "true";
626
+ return readEnvBoolean(env, "TRUST_PROXY") ?? false;
436
627
  }
437
628
 
438
629
  /** A single platform-managed Telegram bot from `TELEGRAM_BOT_TOKENS`. */
@@ -5,10 +5,16 @@ function hasPathPrefix(path: string, prefix: string): boolean {
5
5
  }
6
6
 
7
7
  /**
8
- * Check whether an internal application path is an Atom feed endpoint.
8
+ * Check whether an internal application path has the shape of an Atom feed
9
+ * endpoint, without resolving it.
10
+ *
11
+ * The Worker response cache uses it to decide which requests may be served
12
+ * from cache; what the response itself allows still decides whether one is
13
+ * stored. It is not a routing decision: a custom URL can end in `/feed` and
14
+ * be a post, which is why feed routes check `feedsPublished` themselves.
9
15
  *
10
16
  * @param path - Request pathname after any configured site prefix is removed
11
- * @returns Whether the path is a canonical or legacy feed URL
17
+ * @returns Whether the path looks like a canonical or legacy feed URL
12
18
  * @example
13
19
  * ```ts
14
20
  * isRssFeedPath("/reading/feed"); // true
@@ -1,5 +1,7 @@
1
1
  import type { Context } from "hono";
2
- import type { Bindings, FeedData, Post } from "../types.js";
2
+ import { msg } from "@lingui/core/macro";
3
+ import { getI18n } from "../i18n/index.js";
4
+ import type { Bindings, FeedData, FeedLabels, Post } from "../types.js";
3
5
  import type { AppVariables } from "../types/app-context.js";
4
6
  import type { PostFilters, ThreadRootPageOptions } from "../services/post.js";
5
7
  import { DISCOVER_STATUS_PATH, getDiscoverFeedPath } from "./discover.js";
@@ -20,6 +22,108 @@ const RSS_FEED_CACHE_CONTROL = "public, max-age=60";
20
22
  /** Media type every Jant Atom feed is served as. */
21
23
  const FEED_CONTENT_TYPE = "application/atom+xml; charset=utf-8";
22
24
 
25
+ /**
26
+ * The display text a feed writes, in the language the site's reader pages
27
+ * use, so a feed says "3 more posts" the way the page beside it does.
28
+ *
29
+ * @param c - The feed request, whose locale the reader pages use
30
+ * @returns The labels the renderer writes
31
+ * @example
32
+ * ```ts
33
+ * defaultFeedRenderer({ ...fields, labels: buildFeedLabels(c) });
34
+ * ```
35
+ */
36
+ export function buildFeedLabels(c: FeedContext): FeedLabels {
37
+ const i18n = getI18n(c);
38
+ return {
39
+ watchVideo: i18n._(
40
+ msg({
41
+ message: "Watch video",
42
+ comment: "@context: Feed link under a video attachment or preview",
43
+ }),
44
+ ),
45
+ watchOn: (provider) =>
46
+ i18n._(
47
+ msg({
48
+ message: "Watch on {provider}",
49
+ comment:
50
+ "@context: Feed link under a linked video's preview, naming the site that hosts it",
51
+ }),
52
+ { provider },
53
+ ),
54
+ morePosts: (count) =>
55
+ i18n._(
56
+ msg({
57
+ message: "{count, plural, one {# more post} other {# more posts}}",
58
+ comment:
59
+ "@context: Link showing count of hidden thread posts between root and latest",
60
+ }),
61
+ { count },
62
+ ),
63
+ linkPreview: i18n._(
64
+ msg({
65
+ message: "Link preview",
66
+ comment: "@context: Feed alt text for a link preview image",
67
+ }),
68
+ ),
69
+ videoPreview: i18n._(
70
+ msg({
71
+ message: "Video preview",
72
+ comment: "@context: Feed alt text for a linked video's preview image",
73
+ }),
74
+ ),
75
+ providerVideo: (provider) =>
76
+ i18n._(
77
+ msg({
78
+ message: "{provider} video",
79
+ comment:
80
+ "@context: Feed alt text for a linked video's preview image, naming the site that hosts it",
81
+ }),
82
+ { provider },
83
+ ),
84
+ audio: i18n._(
85
+ msg({
86
+ message: "Audio",
87
+ comment:
88
+ "@context: Feed name for an audio attachment with no file name",
89
+ }),
90
+ ),
91
+ attachedText: i18n._(
92
+ msg({
93
+ message: "Attached text",
94
+ comment: "@context: Feed name for a text attachment with no file name",
95
+ }),
96
+ ),
97
+ attachment: i18n._(
98
+ msg({
99
+ message: "Attachment",
100
+ comment: "@context: Feed name for an attachment with no file name",
101
+ }),
102
+ ),
103
+ };
104
+ }
105
+
106
+ /**
107
+ * Whether the site publishes feeds.
108
+ *
109
+ * Every route that renders a feed, or redirects to one, checks this first and
110
+ * answers 404 when it is off. The check belongs to those routes rather than to
111
+ * a path pattern: a post or custom URL whose address ends in `/feed` is not a
112
+ * feed and stays reachable.
113
+ *
114
+ * @param c - Anything carrying the request's resolved config
115
+ * @returns Whether feed routes should answer
116
+ * @example
117
+ * ```ts
118
+ * if (!feedsPublished(c)) return c.notFound();
119
+ * ```
120
+ */
121
+ export function feedsPublished(c: {
122
+ var: { appConfig: { rssFeedsEnabled: boolean } };
123
+ }): boolean {
124
+ return c.var.appConfig.rssFeedsEnabled;
125
+ }
126
+
23
127
  /**
24
128
  * Serve a rendered Atom document.
25
129
  *
@@ -262,12 +366,11 @@ export function buildFeedDiscoveryFields(
262
366
  );
263
367
  const feedPath = getDiscoverFeedPath(appConfig.discover);
264
368
  const discoverFeedUrl = feedPath ? absoluteFeedUrl(feedPath) : null;
265
- // Only beside `latest`: under `featured` the `feed` attribute already is the
266
- // featured feed, and there is nothing wider to name.
267
- const discoverFeaturedFeedUrl =
268
- appConfig.discover === "latest"
269
- ? absoluteFeedUrl(getDiscoverFeedPath("featured") ?? "/featured/feed")
270
- : null;
369
+ // Named beside `feed`, so a directory shows featured posts on one list and
370
+ // everything on another without guessing the address.
371
+ const discoverFeaturedFeedUrl = feedPath
372
+ ? absoluteFeedUrl("/featured/feed")
373
+ : null;
271
374
  // The API lives outside language views, so the view travels as `lang`: the
272
375
  // answer must be about the feeds this declaration sits in.
273
376
  const viewLang = getViewLang(c);