@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
package/package.json CHANGED
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "@jant/core",
3
- "version": "0.10.0",
3
+ "version": "0.11.0",
4
4
  "description": "A modern, open-source microblogging platform built on Cloudflare Workers",
5
5
  "type": "module",
6
6
  "exports": {
7
7
  ".": {
8
- "types": "./src/index.ts",
8
+ "types": "./dist/index.d.ts",
9
9
  "default": "./dist/index.js"
10
10
  },
11
11
  "./i18n": "./src/i18n/index.ts"
@@ -29,9 +29,8 @@
29
29
  "@fontsource-variable/newsreader": "^5.2.10",
30
30
  "@fontsource-variable/source-sans-3": "^5.2.9",
31
31
  "@fontsource/news-cycle": "^5.2.7",
32
- "@hono/node-server": "^1.19.11",
33
- "@lingui/core": "^5.9.3",
34
- "@lingui/react": "^5.9.3",
32
+ "@hono/node-server": "^2.1.1",
33
+ "@lingui/core": "^6.8.0",
35
34
  "@tailwindcss/typography": "^0.5.19",
36
35
  "@tiptap/core": "^3.27.3",
37
36
  "@tiptap/extension-bold": "^3.31.3",
@@ -50,7 +49,7 @@
50
49
  "@tiptap/starter-kit": "^3.27.3",
51
50
  "@tiptap/suggestion": "^3.27.3",
52
51
  "basecoat-css": "^0.3.11",
53
- "better-auth": "1.6.27",
52
+ "better-auth": "~1.7.6",
54
53
  "better-sqlite3": "^12.8.0",
55
54
  "blurhash": "^2.0.5",
56
55
  "client-zip": "^2.5.1",
@@ -62,12 +61,11 @@
62
61
  "limax": "^4.2.2",
63
62
  "lit": "^3.3.2",
64
63
  "lucide-static": "^0.577.0",
65
- "marked": "^17.0.4",
66
64
  "mdast-util-from-markdown": "^2.0.3",
67
65
  "mdast-util-gfm": "^3.1.0",
68
66
  "mediabunny": "^1.39.2",
69
67
  "micromark-extension-gfm": "^3.0.0",
70
- "nanoid": "^5.1.7",
68
+ "nanoid": "^6.0.1",
71
69
  "parse5": "^8.0.0",
72
70
  "pg": "^8.20.0",
73
71
  "smol-toml": "^1.6.0",
@@ -80,10 +78,6 @@
80
78
  "yazl": "^3.3.1",
81
79
  "zod": "^4.3.6"
82
80
  },
83
- "peerDependencies": {
84
- "hono": "^4.0.0",
85
- "tailwindcss": "^4.0.0"
86
- },
87
81
  "devDependencies": {
88
82
  "@cloudflare/vite-plugin": "^1.29.1",
89
83
  "@cloudflare/workers-types": "^4.20260317.1",
@@ -91,11 +85,11 @@
91
85
  "@fontsource/noto-serif-kr": "^5.2.9",
92
86
  "@fontsource/noto-serif-sc": "^5.2.9",
93
87
  "@fontsource/noto-serif-tc": "^5.2.9",
94
- "@lingui/cli": "^5.9.3",
95
- "@lingui/conf": "^5.9.3",
96
- "@lingui/format-po": "^5.9.3",
97
- "@lingui/swc-plugin": "^5.11.0",
98
- "@swc/core": "1.15.47",
88
+ "@lingui/cli": "^6.8.0",
89
+ "@lingui/conf": "^6.8.0",
90
+ "@lingui/format-po": "^6.8.0",
91
+ "@lingui/swc-plugin": "^6.7.0",
92
+ "@swc/core": "1.16.2",
99
93
  "@tailwindcss/vite": "^4.2.2",
100
94
  "@types/better-sqlite3": "^7.6.13",
101
95
  "@types/node": "^25.5.0",
@@ -106,7 +100,8 @@
106
100
  "drizzle-kit": "^0.31.10",
107
101
  "glob": "^13.0.6",
108
102
  "happy-dom": "^20.8.4",
109
- "sharp": "^0.34.5",
103
+ "hono": "^4.13.10",
104
+ "sharp": "^0.35.5",
110
105
  "tailwindcss": "^4.2.2",
111
106
  "typescript": "^6.0.2",
112
107
  "unplugin-swc": "^1.5.9",
@@ -8,6 +8,11 @@
8
8
  * is now built field by field in `lib/api-*.ts`; this test holds those
9
9
  * builders and the tables to each other. A field added to one fails until the
10
10
  * other lists it too.
11
+ *
12
+ * The JSON examples are held to the same tables: an example object may leave
13
+ * fields out, but every field it shows must be one its table lists. Examples
14
+ * once kept a renamed field (`sort` for `sortOrder`) and a media ID as
15
+ * `nextCursor` long after the API changed.
11
16
  */
12
17
 
13
18
  import { readFileSync } from "node:fs";
@@ -21,7 +26,7 @@ import {
21
26
  import { toApiCustomUrl } from "../lib/api-custom-urls.js";
22
27
  import { toApiMedia } from "../lib/api-media.js";
23
28
  import { toApiNavItem } from "../lib/api-nav-items.js";
24
- import { toApiPost } from "../lib/api-posts.js";
29
+ import { toApiAttachment, toApiPost } from "../lib/api-posts.js";
25
30
  import { toPublicPost } from "../lib/api-public-posts.js";
26
31
  import { toSearchApiResult } from "../lib/api-search.js";
27
32
  import { toApiThreadResponse } from "../lib/api-threads.js";
@@ -101,6 +106,7 @@ describe("API docs", () => {
101
106
  keysOf(
102
107
  toApiPost(post(), extras),
103
108
  toApiPost(post({ format: "quote" }), extras),
109
+ toApiPost(post(), extras, { content: "markdown" }),
104
110
  ),
105
111
  ).toEqual(documentedFields("Post responses include these fields:"));
106
112
  });
@@ -262,3 +268,164 @@ describe("API docs", () => {
262
268
  ).toEqual(documentedFields("Result objects include these fields:"));
263
269
  });
264
270
  });
271
+
272
+ /** The text of each `## ` section of docs/API.md, by heading. */
273
+ function apiDocSections(): Map<string, string> {
274
+ const sections = new Map<string, string>();
275
+ const parts = API_DOC.split(/^## /m).slice(1);
276
+ for (const part of parts) {
277
+ const newline = part.indexOf("\n");
278
+ sections.set(part.slice(0, newline).trim(), part.slice(newline + 1));
279
+ }
280
+ return sections;
281
+ }
282
+
283
+ /** Every JSON example in a section, parsed. */
284
+ function jsonExamples(section: string): unknown[] {
285
+ return [...section.matchAll(/^```json\n([\s\S]*?)^```/gm)].map((match) => {
286
+ const source = match[1] ?? "";
287
+ try {
288
+ return JSON.parse(source) as unknown;
289
+ } catch {
290
+ throw new Error(
291
+ `docs/API.md has a JSON example that doesn't parse:\n${source}`,
292
+ );
293
+ }
294
+ });
295
+ }
296
+
297
+ /** An object in an example, and the key it sits under in its parent. */
298
+ interface ExampleObject {
299
+ value: Record<string, unknown>;
300
+ parentKey: string | null;
301
+ }
302
+
303
+ function exampleObjects(
304
+ value: unknown,
305
+ parentKey: string | null = null,
306
+ ): ExampleObject[] {
307
+ if (Array.isArray(value)) {
308
+ return value.flatMap((item) => exampleObjects(item, parentKey));
309
+ }
310
+ if (typeof value !== "object" || value === null) return [];
311
+ const record = value as Record<string, unknown>;
312
+ return [
313
+ { value: record, parentKey },
314
+ ...Object.entries(record).flatMap(([key, child]) =>
315
+ exampleObjects(child, key),
316
+ ),
317
+ ];
318
+ }
319
+
320
+ /** The fields an example object may carry, or null when no table covers it. */
321
+ type ExampleRule = (object: ExampleObject) => string[] | null;
322
+
323
+ function idPrefix(object: ExampleObject): string | null {
324
+ const id = object.value.id;
325
+ return typeof id === "string" ? (id.split("_")[0] ?? null) : null;
326
+ }
327
+
328
+ describe("API doc examples", () => {
329
+ const authorPost = documentedFields("Post responses include these fields:");
330
+ const publicPost = documentedFields(
331
+ "Public post responses include these fields:",
332
+ );
333
+ const media = documentedFields("Media responses");
334
+ const attachment = keysOf(
335
+ toApiAttachment(makeMedia(), APP_CONFIG),
336
+ toApiAttachment(textMedia, APP_CONFIG),
337
+ );
338
+ const collection = documentedFields(
339
+ "Collection responses include these fields:",
340
+ );
341
+ const directoryItem = documentedFields(
342
+ "Directory item responses include these fields:",
343
+ );
344
+ const smartCollection = documentedFields(
345
+ "Smart collection responses include these fields:",
346
+ );
347
+ // The response fields, plus `threadPosition`, which only the single read
348
+ // carries and the prose beside it names.
349
+ const singlePost = [...authorPost, "threadPosition"];
350
+
351
+ const rules: Record<string, ExampleRule> = {
352
+ Posts: (object) => {
353
+ switch (idPrefix(object)) {
354
+ case "med":
355
+ // A text attachment's content is its own response, documented by
356
+ // its example alone.
357
+ return "content" in object.value ? null : attachment;
358
+ case "pst":
359
+ return singlePost;
360
+ default:
361
+ return null;
362
+ }
363
+ },
364
+ "Public posts": (object) =>
365
+ idPrefix(object) === "pst" ? publicPost : null,
366
+ Threads: (object) => {
367
+ if (object.parentKey === "gap")
368
+ return ["id", "slug", "permalink", "cursor"];
369
+ if ("postCount" in object.value) {
370
+ return documentedFields("Thread responses include these fields:");
371
+ }
372
+ return idPrefix(object) === "pst" ? publicPost : null;
373
+ },
374
+ Media: (object) => (idPrefix(object) === "med" ? media : null),
375
+ Collections: (object) => {
376
+ switch (idPrefix(object)) {
377
+ case "col":
378
+ return collection;
379
+ case "cdi":
380
+ return directoryItem;
381
+ case "smc":
382
+ return smartCollection;
383
+ default:
384
+ return null;
385
+ }
386
+ },
387
+ "Smart Collections": (object) =>
388
+ idPrefix(object) === "smc" ? smartCollection : null,
389
+ "Navigation Items": (object) =>
390
+ idPrefix(object) === "nav"
391
+ ? documentedFields("Nav item responses include these fields:")
392
+ : null,
393
+ "Custom URLs": (object) =>
394
+ idPrefix(object) === "pth"
395
+ ? documentedFields("Custom URL responses include these fields:")
396
+ : null,
397
+ Search: (object) =>
398
+ idPrefix(object) === "pst"
399
+ ? documentedFields("Result objects include these fields:")
400
+ : null,
401
+ };
402
+
403
+ const sections = apiDocSections();
404
+
405
+ it("parse", () => {
406
+ for (const section of sections.values()) {
407
+ expect(() => jsonExamples(section)).not.toThrow();
408
+ }
409
+ });
410
+
411
+ it.each(Object.keys(rules))(
412
+ "in %s carry only fields their table lists",
413
+ (heading) => {
414
+ const section = sections.get(heading);
415
+ expect(section, `docs/API.md has no "## ${heading}"`).toBeDefined();
416
+ const rule = rules[heading];
417
+ if (!section || !rule) return;
418
+ for (const example of jsonExamples(section)) {
419
+ for (const object of exampleObjects(example)) {
420
+ const allowed = rule(object);
421
+ if (!allowed) continue;
422
+ // `"…": "…"` stands for the fields an example leaves out.
423
+ const extra = Object.keys(object.value).filter(
424
+ (key) => key !== "…" && !allowed.includes(key),
425
+ );
426
+ expect(extra, JSON.stringify(object.value)).toEqual([]);
427
+ }
428
+ }
429
+ },
430
+ );
431
+ });
@@ -0,0 +1,85 @@
1
+ import { afterEach, describe, expect, it, vi } from "vitest";
2
+
3
+ const lookup = vi.hoisted(() =>
4
+ vi.fn(async (_host: string, _options?: unknown) => [
5
+ { address: "93.184.215.14", family: 4 },
6
+ ]),
7
+ );
8
+ vi.mock("node:dns/promises", () => ({ lookup, default: { lookup } }));
9
+
10
+ const { assertPublicUrl, fetchPublic, isPrivateAddress, resolveInside } =
11
+ await import("../../../bin/lib/import-sources.js");
12
+
13
+ afterEach(() => {
14
+ vi.unstubAllGlobals();
15
+ });
16
+
17
+ describe("resolveInside", () => {
18
+ it("keeps a path inside the export", () => {
19
+ expect(resolveInside("/tmp/site", "static", "media/a.webp")).toBe(
20
+ "/tmp/site/static/media/a.webp",
21
+ );
22
+ });
23
+
24
+ it.each(["../../.ssh/id_rsa", "/etc/passwd", "media/../../../x"])(
25
+ "refuses %s, which leaves it",
26
+ (path) => {
27
+ expect(resolveInside("/tmp/site/static", path)).toBeNull();
28
+ },
29
+ );
30
+ });
31
+
32
+ describe("isPrivateAddress", () => {
33
+ it.each([
34
+ "127.0.0.1",
35
+ "169.254.169.254",
36
+ "::1",
37
+ "::ffff:10.0.0.1",
38
+ "fd00::1",
39
+ ])("treats %s as private", (address) => {
40
+ expect(isPrivateAddress(address)).toBe(true);
41
+ });
42
+
43
+ it.each(["93.184.215.14", "2606:4700::1111"])(
44
+ "treats %s as public",
45
+ (address) => {
46
+ expect(isPrivateAddress(address)).toBe(false);
47
+ },
48
+ );
49
+ });
50
+
51
+ describe("assertPublicUrl", () => {
52
+ it("refuses a host that resolves to a private address", async () => {
53
+ lookup.mockResolvedValueOnce([{ address: "10.0.0.7", family: 4 }]);
54
+
55
+ await expect(
56
+ assertPublicUrl("https://internal.example/media/a.webp"),
57
+ ).rejects.toThrow("private address");
58
+ });
59
+
60
+ it.each([
61
+ "http://localhost./a.webp",
62
+ "http://169.254.169.254/latest/meta-data",
63
+ "file:///etc/passwd",
64
+ ])("refuses %s", async (url) => {
65
+ await expect(assertPublicUrl(url)).rejects.toThrow("Refusing to fetch");
66
+ });
67
+ });
68
+
69
+ describe("fetchPublic", () => {
70
+ it("checks a redirect's target before following it", async () => {
71
+ const fetchMock = vi.fn(
72
+ async () =>
73
+ new Response(null, {
74
+ status: 302,
75
+ headers: { location: "http://127.0.0.1/secret" },
76
+ }),
77
+ );
78
+ vi.stubGlobal("fetch", fetchMock);
79
+
80
+ await expect(
81
+ fetchPublic("https://example.com/media/a.webp"),
82
+ ).rejects.toThrow("private address");
83
+ expect(fetchMock).toHaveBeenCalledTimes(1);
84
+ });
85
+ });
@@ -30,30 +30,36 @@ afterEach(() => {
30
30
  vi.unstubAllGlobals();
31
31
  });
32
32
 
33
+ function batch(fields: Record<string, unknown>) {
34
+ return new Response(
35
+ JSON.stringify({
36
+ abortedMultipartUploads: 0,
37
+ deletedSessions: 0,
38
+ deletedOrphanMedia: 0,
39
+ purgedStorageObjects: 0,
40
+ done: true,
41
+ ...fields,
42
+ }),
43
+ { status: 200, headers: { "Content-Type": "application/json" } },
44
+ );
45
+ }
46
+
47
+ function setUp(...responses: Response[]) {
48
+ process.env.SITE_ORIGIN = "https://example.com";
49
+ process.env.SITE_PATH_PREFIX = "/blog";
50
+ process.env.INTERNAL_ADMIN_TOKEN = "internal-secret";
51
+ const fetchMock = vi.fn();
52
+ for (const response of responses) fetchMock.mockResolvedValueOnce(response);
53
+ vi.stubGlobal("fetch", fetchMock);
54
+ const logSpy = vi.spyOn(console, "log").mockImplementation(() => {});
55
+ return { fetchMock, logSpy };
56
+ }
57
+
33
58
  describe("jant uploads cleanup", () => {
34
59
  it("calls the internal uploads cleanup endpoint", async () => {
35
- process.env.SITE_ORIGIN = "https://example.com";
36
- process.env.SITE_PATH_PREFIX = "/blog";
37
- process.env.INTERNAL_ADMIN_TOKEN = "internal-secret";
38
-
39
- const fetchMock = vi.fn().mockResolvedValue(
40
- new Response(
41
- JSON.stringify({
42
- abortedMultipartUploads: 1,
43
- deletedSessions: 3,
44
- deletedOrphanMedia: 2,
45
- }),
46
- {
47
- status: 200,
48
- headers: {
49
- "Content-Type": "application/json",
50
- },
51
- },
52
- ),
60
+ const { fetchMock, logSpy } = setUp(
61
+ batch({ abortedMultipartUploads: 1, deletedSessions: 3 }),
53
62
  );
54
- vi.stubGlobal("fetch", fetchMock);
55
-
56
- const logSpy = vi.spyOn(console, "log").mockImplementation(() => {});
57
63
 
58
64
  await run(["--limit", "25"]);
59
65
 
@@ -68,12 +74,46 @@ describe("jant uploads cleanup", () => {
68
74
  body: JSON.stringify({ limit: 25 }),
69
75
  },
70
76
  );
71
- expect(logSpy).toHaveBeenNthCalledWith(
72
- 1,
77
+ expect(logSpy.mock.calls.map(([line]) => line)).toEqual([
73
78
  "Cleaning expired uploads for https://example.com/blog...",
79
+ "Deleted sessions: 3",
80
+ "Aborted multipart uploads: 1",
81
+ "Purged storage objects: 0",
82
+ ]);
83
+ });
84
+
85
+ it("runs batches until the server reports nothing left", async () => {
86
+ const { fetchMock, logSpy } = setUp(
87
+ batch({ deletedSessions: 20, done: false }),
88
+ batch({ deletedSessions: 20, purgedStorageObjects: 4, done: false }),
89
+ batch({ deletedSessions: 5 }),
74
90
  );
75
- expect(logSpy).toHaveBeenNthCalledWith(2, "Deleted sessions: 3");
76
- expect(logSpy).toHaveBeenNthCalledWith(3, "Aborted multipart uploads: 1");
77
- expect(logSpy).toHaveBeenNthCalledWith(4, "Orphaned media deleted: 2");
91
+
92
+ await run([]);
93
+
94
+ expect(fetchMock).toHaveBeenCalledTimes(3);
95
+ expect(logSpy).toHaveBeenCalledWith("Deleted sessions: 45");
96
+ expect(logSpy).toHaveBeenCalledWith("Purged storage objects: 4");
97
+ });
98
+
99
+ it("runs one batch with --once", async () => {
100
+ const { fetchMock } = setUp(batch({ deletedSessions: 20, done: false }));
101
+
102
+ await run(["--once"]);
103
+
104
+ expect(fetchMock).toHaveBeenCalledTimes(1);
105
+ });
106
+
107
+ it("stops when a batch that isn't the last removes nothing", async () => {
108
+ const { fetchMock } = setUp(batch({ done: false }));
109
+ vi.spyOn(console, "error").mockImplementation(() => {});
110
+ const exit = vi.spyOn(process, "exit").mockImplementation((() => {
111
+ throw new Error("exit");
112
+ }) as never);
113
+
114
+ await expect(run([])).rejects.toThrow("exit");
115
+
116
+ expect(fetchMock).toHaveBeenCalledTimes(1);
117
+ expect(exit).toHaveBeenCalledWith(1);
78
118
  });
79
119
  });
@@ -146,6 +146,46 @@ describe("jant CLI surface", () => {
146
146
  expect(result.stdout).toBe("");
147
147
  });
148
148
 
149
+ it.each(["--version", "-v"])("prints the version for jant %s", (flag) => {
150
+ const version = JSON.parse(
151
+ readFileSync(join(CORE_DIR, "package.json"), "utf8"),
152
+ ).version;
153
+ const result = spawnSync("node", ["bin/jant.js", flag], {
154
+ cwd: CORE_DIR,
155
+ encoding: "utf8",
156
+ });
157
+ expect(result.status).toBe(0);
158
+ expect(result.stdout).toBe(`${version}\n`);
159
+ });
160
+
161
+ it.each([
162
+ ["migrate --bogus", "Error: Unknown option '--bogus'.", "migrate"],
163
+ [
164
+ "search reindex --limit",
165
+ "Error: Option '--limit <value>' argument missing.",
166
+ "search reindex",
167
+ ],
168
+ ])("answers a bad argument in one line: jant %s", (args, line, command) => {
169
+ // parseArgs used to surface as a Node stack trace.
170
+ const result = spawnSync("node", ["bin/jant.js", ...args.split(" ")], {
171
+ cwd: CORE_DIR,
172
+ encoding: "utf8",
173
+ });
174
+ expect(result.status).toBe(1);
175
+ expect(result.stderr).toBe(
176
+ `${line}\nRun 'jant ${command} --help' for its options.\n`,
177
+ );
178
+ });
179
+
180
+ it("refuses an option it doesn't know without a command", () => {
181
+ const result = spawnSync("node", ["bin/jant.js", "--bogus"], {
182
+ cwd: CORE_DIR,
183
+ encoding: "utf8",
184
+ });
185
+ expect(result.status).toBe(1);
186
+ expect(result.stderr).toContain("Unknown option: --bogus");
187
+ });
188
+
149
189
  for (const path of CLI_DOCS) {
150
190
  it(`${path} documents each public command with the options its help lists`, () => {
151
191
  const documented = readDocumentedCommands(path);