@jant/core 0.8.0 → 0.9.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 (160) hide show
  1. package/dist/{app-CFsmRVJN.js → app-BzH8jmh3.js} +1619 -500
  2. package/dist/client/.vite/manifest.json +2 -2
  3. package/dist/client/_assets/{client-DTLBOHqD.js → client-S8oryJ0m.js} +1 -1
  4. package/dist/client/_assets/{client-auth-D6Ix6SmE.js → client-auth-Ds9G0IgR.js} +1 -1
  5. package/dist/index.js +1 -1
  6. package/dist/node.js +2 -2
  7. package/package.json +1 -1
  8. package/src/__tests__/fixtures/releases/0.8.0/site-export/README.md +130 -0
  9. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/2thjq/_index.md +25 -0
  10. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/2u5e5/_index.md +35 -0
  11. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/41q27/0x4nv/index.md +18 -0
  12. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/41q27/_index.md +44 -0
  13. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/41q27/faqyt/index.md +30 -0
  14. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/41q27/the-potting-mix-guide-i-keep-rereading/index.md +20 -0
  15. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/5kayp/_index.md +23 -0
  16. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/5ynfs/_index.md +31 -0
  17. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/5ynfs/hu597/index.md +21 -0
  18. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/_index.md +5 -0
  19. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/a-night-heron-field-guide-for-my-walk-folder/_index.md +31 -0
  20. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/a-quiet-saturday-after-a-busy-week/_index.md +36 -0
  21. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/archive/_index.md +8 -0
  22. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/are-na-is-the-only-bookmark-pile-i-still-revisit/_index.md +30 -0
  23. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/bought-too-many-lemons-again/_index.md +37 -0
  24. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/city-walks/_index.md +12 -0
  25. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/cleanshot-for-screenshots-ocr-and-screen-recording-on-the-mac/_index.md +33 -0
  26. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/cleanshotmac-shang-de-jie-tu-ocr-lu-ping-gong-ju/_index.md +32 -0
  27. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/co344/_index.md +25 -0
  28. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/collections/_index.md +5 -0
  29. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/current-tea-rotation/_index.md +34 -0
  30. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/derek-sivers-still-writes-the-kind-of-internet-i-want-more-of/_index.md +30 -0
  31. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/desk-but-better/_index.md +25 -0
  32. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/e0kcg/_index.md +22 -0
  33. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/egi3c/_index.md +24 -0
  34. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/evf9j/_index.md +152 -0
  35. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/featured/_index.md +8 -0
  36. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-basho/_index.md +25 -0
  37. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-epictetus/_index.md +25 -0
  38. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-marcus-aurelius/_index.md +25 -0
  39. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-seneca/_index.md +26 -0
  40. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-thoreau/_index.md +25 -0
  41. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gkbvv/2cl6d/index.md +18 -0
  42. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gkbvv/3zqv7/index.md +30 -0
  43. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gkbvv/5oxsv/index.md +18 -0
  44. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gkbvv/_index.md +39 -0
  45. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gwob9/_index.md +25 -0
  46. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/home-cooking/_index.md +12 -0
  47. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/hz729/_index.md +24 -0
  48. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/inaturalist-ai-zi-ran-she-qu/_index.md +44 -0
  49. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/j4v0q/_index.md +35 -0
  50. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k278t/_index.md +25 -0
  51. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k4eee/_index.md +22 -0
  52. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k5vh8/_index.md +32 -0
  53. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k5vh8/a-reading-log-idea-i-might-steal/index.md +20 -0
  54. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k5vh8/a83qu/index.md +18 -0
  55. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k5vh8/from-seneca-5hibo/index.md +21 -0
  56. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/kan-qi-lai-bi-jiao-ku-de-gong-si-men/_index.md +41 -0
  57. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/l2m7y/_index.md +29 -0
  58. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/lan-ya-yao-kong-qi-chuang-shang-yue-du-de-fan-ye-shen-qi/_index.md +57 -0
  59. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/mynoise-for-rainy-afternoons/_index.md +30 -0
  60. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/n09le/_index.md +23 -0
  61. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/ni-fu-jin-de-wei-ji-bai-ke-tiao-mu/_index.md +42 -0
  62. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/nts-archives-are-good-cleaning-music/_index.md +30 -0
  63. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/qgfcu/_index.md +32 -0
  64. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/qgfcu/c91j0/index.md +18 -0
  65. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/qgfcu/qyucy/index.md +18 -0
  66. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/qgfcu/wsgck/index.md +18 -0
  67. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/rain-makes-my-neighborhood-look-better/_index.md +46 -0
  68. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/reading-notes/_index.md +12 -0
  69. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/s4r3e/_index.md +25 -0
  70. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/serious-eats-on-tomato-and-egg-soup/_index.md +30 -0
  71. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/te812/_index.md +44 -0
  72. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/te812/cxiu6/index.md +18 -0
  73. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/te812/t77ms/index.md +18 -0
  74. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/te812/the-soup-trick-i-always-forget/index.md +20 -0
  75. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/telk3/_index.md +30 -0
  76. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/telk3/from-thoreau-pawt2/index.md +21 -0
  77. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/the-five-minute-reset-is-still-the-best-habit-i-have/_index.md +36 -0
  78. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/the-hallway-light-took-12-minutes-and-3-months/_index.md +32 -0
  79. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/the-recurse-center-manual-is-weirdly-calming/_index.md +30 -0
  80. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/tiny-projects/_index.md +12 -0
  81. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/tong-wang-xing-fu-zhi-lu/_index.md +68 -0
  82. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/tou-ma-yan-jiang-ju-le-bu-chu-ti-yan/_index.md +62 -0
  83. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/useful-links/_index.md +12 -0
  84. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/weekend-notes/_index.md +12 -0
  85. package/src/__tests__/fixtures/releases/0.8.0/site-export/content/what-i-actually-use-my-notebook-for/_index.md +52 -0
  86. package/src/__tests__/fixtures/releases/0.8.0/site-export/data/jant.toml +124 -0
  87. package/src/__tests__/fixtures/releases/0.8.0/site-export/hugo.toml +45 -0
  88. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/_redirects +25 -0
  89. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/15d51730a4f7-med_01kn8jtq3penf98tfq4gzmh9g9.png +0 -0
  90. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jtx8qenf98tm9ahxr48sw.webp +0 -0
  91. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jv0jdenf98tp6qr9zgjjc.webp +0 -0
  92. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jv452enf98trbkwrvhvgd.webp +0 -0
  93. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jvb16enf98txp7p0pf5ge.webp +0 -0
  94. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jve5nenf98tzap11gpxzr.webp +0 -0
  95. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jvq58enf98v538w5vsqp4.webp +0 -0
  96. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jvsaeenf98v6ct4gjzppc.webp +0 -0
  97. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jw26cenf98vc7k0ppz5k8.webp +0 -0
  98. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m313q1hme4e8cmby77dn66yy.webp +0 -0
  99. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m313q2w7e4e8cmc20036yh66.webp +0 -0
  100. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m313q7d2e4e8cmdeqjmyafby.webp +0 -0
  101. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m313q887e4e8cmdjssych7yh.webp +0 -0
  102. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167jx2f6ct88pkz45j3ycp-poster.webp +0 -0
  103. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167jx2f6ct88pkz45j3ycp.mp4 +0 -0
  104. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167mbdf6ct88pr4ga1b9kf-poster.webp +0 -0
  105. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167mbdf6ct88pr4ga1b9kf.mp4 +0 -0
  106. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167nsvf6ct88q1anhz4svb-poster.webp +0 -0
  107. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167nsvf6ct88q1anhz4svb.mp4 +0 -0
  108. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167qaxf6ct88qfndwzxx83-poster.webp +0 -0
  109. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167qaxf6ct88qfndwzxx83.mp4 +0 -0
  110. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167sm0f6ct88qw5brtsgcw.webp +0 -0
  111. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167tf8f6ct88r169s51j49.webp +0 -0
  112. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167vaaf6ct88rbx5ztenwb.webp +0 -0
  113. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167w51f6ct88rp19pybkw1.webp +0 -0
  114. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167x0nf6ct88rzajb84tw3.webp +0 -0
  115. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167xxbf6ct88s5t2300bjk.webp +0 -0
  116. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167yq5f6ct88s9pjwt5fxg.webp +0 -0
  117. package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167zg4f6ct88sge8jp28ja.webp +0 -0
  118. package/src/__tests__/fixtures/releases/0.8.0/site-export/themes/jant/static/apple-touch-icon.png +0 -0
  119. package/src/__tests__/fixtures/releases/0.8.0/site-export/themes/jant/static/custom.css +0 -0
  120. package/src/__tests__/fixtures/releases/0.8.0/site-export/themes/jant/static/favicon.ico +0 -0
  121. package/src/__tests__/fixtures/releases/0.8.0/site-export/wrangler.jsonc +24 -0
  122. package/src/__tests__/fixtures/releases/0.8.0/snapshot/db.sql +322 -0
  123. package/src/__tests__/fixtures/releases/0.8.0/snapshot/meta.json +11 -0
  124. package/src/__tests__/helpers/cursor-walk.ts +82 -0
  125. package/src/__tests__/release-fixtures.test.ts +6 -2
  126. package/src/app.tsx +4 -0
  127. package/src/lib/__tests__/post-list-cursor.test.ts +105 -0
  128. package/src/lib/__tests__/thread-fold.test.ts +43 -0
  129. package/src/lib/__tests__/timeline.test.ts +14 -14
  130. package/src/lib/api-posts.ts +110 -2
  131. package/src/lib/api-public-posts.ts +263 -0
  132. package/src/lib/api-threads.ts +207 -0
  133. package/src/lib/post-list-cursor.ts +211 -0
  134. package/src/lib/thread-fold.ts +83 -41
  135. package/src/lib/thread-query.ts +143 -0
  136. package/src/middleware/cors.ts +8 -1
  137. package/src/middleware/deprecation.ts +48 -0
  138. package/src/routes/api/__tests__/mcp.test.ts +147 -0
  139. package/src/routes/api/__tests__/posts.test.ts +157 -0
  140. package/src/routes/api/__tests__/public-access.test.ts +5 -0
  141. package/src/routes/api/__tests__/threads.test.ts +115 -0
  142. package/src/routes/api/posts.ts +19 -112
  143. package/src/routes/api/public/__tests__/archive.test.ts +261 -0
  144. package/src/routes/api/public/__tests__/posts.test.ts +344 -19
  145. package/src/routes/api/public/__tests__/threads.test.ts +363 -0
  146. package/src/routes/api/public/archive.ts +82 -79
  147. package/src/routes/api/public/posts.ts +97 -299
  148. package/src/routes/api/public/threads.ts +141 -0
  149. package/src/routes/api/threads.ts +128 -0
  150. package/src/services/__tests__/post.test.ts +342 -36
  151. package/src/services/__tests__/thread.test.ts +495 -0
  152. package/src/services/index.ts +4 -0
  153. package/src/services/mcp.ts +213 -63
  154. package/src/services/post.ts +734 -361
  155. package/src/services/thread.ts +392 -0
  156. package/src/types/constants.ts +25 -0
  157. package/src/ui/feed/ThreadPreview.tsx +9 -14
  158. package/src/ui/feed/__tests__/thread-preview.test.ts +18 -22
  159. package/src/ui/feed/thread-preview-state.ts +0 -35
  160. package/src/ui/shared/Pagination.tsx +1 -1
@@ -4,12 +4,14 @@ import { collectionsApiRoutes } from "../collections.js";
4
4
  import { navItemsApiRoutes } from "../nav-items.js";
5
5
  import { publicArchiveApiRoutes } from "../public/archive.js";
6
6
  import { publicPostsApiRoutes } from "../public/posts.js";
7
+ import { publicThreadsApiRoutes } from "../public/threads.js";
7
8
  import { searchApiRoutes } from "../search.js";
8
9
 
9
10
  function mountPublicReadRoutes(authenticated = false) {
10
11
  const testApp = createTestApp({ authenticated, fts: true });
11
12
  testApp.app.route("/api/public/posts", publicPostsApiRoutes);
12
13
  testApp.app.route("/api/public/archive", publicArchiveApiRoutes);
14
+ testApp.app.route("/api/public/threads", publicThreadsApiRoutes);
13
15
  testApp.app.route("/api/search", searchApiRoutes);
14
16
  testApp.app.route("/api/collections", collectionsApiRoutes);
15
17
  testApp.app.route("/api/nav-items", navItemsApiRoutes);
@@ -21,6 +23,9 @@ describe("public API access setting", () => {
21
23
  "/api/public/posts",
22
24
  "/api/public/posts/missing",
23
25
  "/api/public/archive",
26
+ "/api/public/threads",
27
+ "/api/public/threads/missing",
28
+ "/api/public/threads/missing/posts",
24
29
  ])("returns 404 for %s when the public API is off", async (path) => {
25
30
  const { app, services } = mountPublicReadRoutes();
26
31
  await services.settings.set("PUBLIC_API_ENABLED", "false");
@@ -0,0 +1,115 @@
1
+ import { describe, expect, it } from "vitest";
2
+ import { createTestApp } from "../../../__tests__/helpers/app.js";
3
+ import { walkThreadPages } from "../../../__tests__/helpers/cursor-walk.js";
4
+ import type { CreatePost } from "../../../types.js";
5
+ import { threadsApiRoutes } from "../threads.js";
6
+
7
+ const DAY = 86_400;
8
+ const BASE = Date.UTC(2025, 0, 1) / 1000;
9
+ const day = (n: number) => BASE + n * DAY;
10
+
11
+ function setup(authenticated = true) {
12
+ const testApp = createTestApp({ authenticated });
13
+ testApp.app.route("/api/threads", threadsApiRoutes);
14
+ const post = (data: Partial<CreatePost>) =>
15
+ testApp.services.posts.create({
16
+ format: "note",
17
+ bodyMarkdown: "body",
18
+ ...data,
19
+ });
20
+ const get = async (path: string) => {
21
+ const res = await testApp.app.request(path);
22
+ return { status: res.status, body: await res.json() };
23
+ };
24
+ return { ...testApp, post, get };
25
+ }
26
+
27
+ const ids = (items: Array<{ id: string }>) => items.map((item) => item.id);
28
+
29
+ describe("Threads API Routes", () => {
30
+ it.each(["/api/threads", "/api/threads/pst_x", "/api/threads/pst_x/posts"])(
31
+ "requires authentication for %s",
32
+ async (path) => {
33
+ const { app } = setup(false);
34
+ expect((await app.request(path)).status).toBe(401);
35
+ },
36
+ );
37
+
38
+ it("lists every visibility by default, in the editing view", async () => {
39
+ const { post, get } = setup();
40
+ const shown = await post({ publishedAt: day(1) });
41
+ const hidden = await post({
42
+ publishedAt: day(2),
43
+ visibility: "latest_hidden",
44
+ });
45
+ const secret = await post({ publishedAt: day(3), visibility: "private" });
46
+ await post({ status: "draft" });
47
+
48
+ const { status, body } = await get("/api/threads");
49
+ expect(status).toBe(200);
50
+ expect(ids(body.threads)).toEqual([secret.id, hidden.id, shown.id]);
51
+ expect(body.threads[0].root).toMatchObject({
52
+ id: secret.id,
53
+ body: expect.any(String),
54
+ displayTitle: expect.any(String),
55
+ threadPostCount: 1,
56
+ });
57
+
58
+ const privateOnly = await get("/api/threads?visibility=private");
59
+ expect(ids(privateOnly.body.threads)).toEqual([secret.id]);
60
+ });
61
+
62
+ it("lists drafts by status", async () => {
63
+ const { post, get } = setup();
64
+ const draft = await post({ status: "draft" });
65
+ await post({ publishedAt: day(1) });
66
+ const { body } = await get("/api/threads?status=draft");
67
+ expect(ids(body.threads)).toEqual([draft.id]);
68
+ expect(body.threads[0].postCount).toBe(0);
69
+ });
70
+
71
+ it("walks with a cursor", async () => {
72
+ const { post, get, app } = setup();
73
+ for (let i = 0; i < 4; i++) await post({ publishedAt: day(i) });
74
+ const { body } = await get("/api/threads?sort=published&limit=100");
75
+ expect(
76
+ await walkThreadPages(app, "/api/threads?sort=published", 1),
77
+ ).toEqual(ids(body.threads));
78
+ });
79
+
80
+ it("returns a Thread, drafts included, by any of its Posts", async () => {
81
+ const { post, get } = setup();
82
+ const draft = await post({ status: "draft" });
83
+ const root = await post({ publishedAt: day(1) });
84
+ const reply = await post({ replyToId: root.id, publishedAt: day(2) });
85
+
86
+ const found = await get(`/api/threads/${reply.id}?include=fold`);
87
+ expect(found.status).toBe(200);
88
+ expect(found.body).toMatchObject({ id: root.id, postCount: 2 });
89
+ expect(found.body.fold).toEqual({
90
+ leading: [],
91
+ hidden: 0,
92
+ gap: null,
93
+ trailing: [expect.objectContaining({ id: reply.id })],
94
+ });
95
+
96
+ expect((await get(`/api/threads/${draft.id}`)).status).toBe(200);
97
+ expect((await get("/api/threads/not-an-id")).status).toBe(400);
98
+ expect(
99
+ (await get("/api/threads/pst_01jpyx3m7gw4w3h7m4bknq0v1d")).status,
100
+ ).toBe(404);
101
+ });
102
+
103
+ it("lists a Thread's Posts by status", async () => {
104
+ const { post, get } = setup();
105
+ const root = await post({ publishedAt: day(1) });
106
+ const reply = await post({ replyToId: root.id, publishedAt: day(2) });
107
+ const unsent = await post({ replyToId: reply.id, status: "draft" });
108
+
109
+ const published = await get(`/api/threads/${root.id}/posts`);
110
+ expect(ids(published.body.posts)).toEqual([root.id, reply.id]);
111
+ expect(published.body.posts[1].threadPostCount).toBe(2);
112
+ const drafts = await get(`/api/threads/${root.id}/posts?status=draft`);
113
+ expect(ids(drafts.body.posts)).toEqual([unsent.id]);
114
+ });
115
+ });
@@ -16,7 +16,11 @@ import {
16
16
  parseValidated,
17
17
  } from "../../lib/schemas.js";
18
18
  import { requireAuthApi } from "../../middleware/auth.js";
19
- import { toApiAttachment, toApiPost } from "../../lib/api-posts.js";
19
+ import {
20
+ apiPostListOrder,
21
+ loadApiPostResponse,
22
+ loadApiPostResponses,
23
+ } from "../../lib/api-posts.js";
20
24
  import { getPostDisplayTitle } from "../../lib/post-meta.js";
21
25
  import { assertFound, NotFoundError, parseIdParam } from "../../lib/errors.js";
22
26
  import { AddressQuerySchema, requestInternalPath } from "../../lib/address.js";
@@ -59,42 +63,15 @@ postsApiRoutes.get("/", requireAuthApi(), async (c) => {
59
63
  c.req.query(),
60
64
  );
61
65
 
62
- const posts = await c.var.services.posts.list({
63
- format,
64
- status: status ?? "published",
65
- cursor: cursor ?? undefined,
66
- limit,
67
- });
68
-
69
- // Batch load media for all posts
70
- const postIds = posts.map((p) => p.id);
71
- const mediaMap = await c.var.services.media.getByPostIds(postIds);
72
- const {
73
- r2PublicUrl,
74
- imageTransformUrl,
75
- s3PublicUrl,
76
- localPublicUrl,
77
- sitePathPrefix,
78
- } = c.var.appConfig;
66
+ const listStatus = status ?? "published";
67
+ const { posts, nextCursor } = await c.var.services.posts.listPage(
68
+ { format, status: listStatus, ...apiPostListOrder(listStatus) },
69
+ { cursor, limit },
70
+ );
79
71
 
80
72
  return c.json({
81
- posts: posts.map((p) =>
82
- toApiPost(p, {
83
- attachments: (mediaMap.get(p.id) ?? []).map((m) =>
84
- toApiAttachment(
85
- m,
86
- r2PublicUrl,
87
- imageTransformUrl,
88
- s3PublicUrl,
89
- localPublicUrl,
90
- sitePathPrefix,
91
- ),
92
- ),
93
- }),
94
- ),
95
-
96
- nextCursor:
97
- posts.length === limit ? (posts[posts.length - 1]?.id ?? null) : null,
73
+ posts: await loadApiPostResponses(c.var, posts),
74
+ nextCursor,
98
75
  });
99
76
  });
100
77
 
@@ -135,39 +112,14 @@ postsApiRoutes.get("/:id/content", requireAuthApi(), async (c) => {
135
112
  postsApiRoutes.get("/:id", requireAuthApi(), async (c) => {
136
113
  const id = parseIdParam(c.req.param("id"), ID_PREFIX.post);
137
114
 
138
- // Fetch post, media, collections and thread position in parallel (all keyed
139
- // by the same id)
140
- const [post, mediaList, threadCollections, threadPosition] =
141
- await Promise.all([
142
- c.var.services.posts.getById(id),
143
- c.var.services.media.getByPostId(id),
144
- c.var.services.collections.getCollectionsByPostId(id),
145
- c.var.services.posts.getThreadPosition(id),
146
- ]);
115
+ const [post, threadPosition] = await Promise.all([
116
+ c.var.services.posts.getById(id),
117
+ c.var.services.posts.getThreadPosition(id),
118
+ ]);
147
119
  const foundPost = assertFound(post, "Post");
148
- const {
149
- r2PublicUrl,
150
- imageTransformUrl,
151
- s3PublicUrl,
152
- localPublicUrl,
153
- sitePathPrefix,
154
- } = c.var.appConfig;
155
- const collectionIds = threadCollections.map((col) => col.id);
156
120
 
157
121
  return c.json({
158
- ...toApiPost(foundPost, {
159
- collectionIds,
160
- attachments: mediaList.map((m) =>
161
- toApiAttachment(
162
- m,
163
- r2PublicUrl,
164
- imageTransformUrl,
165
- s3PublicUrl,
166
- localPublicUrl,
167
- sitePathPrefix,
168
- ),
169
- ),
170
- }),
122
+ ...(await loadApiPostResponse(c.var, foundPost, { collectionIds: true })),
171
123
  threadPosition,
172
124
  });
173
125
  });
@@ -219,33 +171,10 @@ postsApiRoutes.post("/", requireAuthApi(), async (c) => {
219
171
  },
220
172
  );
221
173
 
222
- const mediaList = await c.var.services.media.getByPostId(post.id);
223
- const {
224
- r2PublicUrl,
225
- imageTransformUrl,
226
- s3PublicUrl,
227
- localPublicUrl,
228
- sitePathPrefix,
229
- } = c.var.appConfig;
230
-
231
174
  // Trigger GitHub Sync in background (no-op when sync isn't enabled).
232
175
  await triggerGitHubSyncInline(c);
233
176
 
234
- return c.json(
235
- toApiPost(post, {
236
- attachments: mediaList.map((m) =>
237
- toApiAttachment(
238
- m,
239
- r2PublicUrl,
240
- imageTransformUrl,
241
- s3PublicUrl,
242
- localPublicUrl,
243
- sitePathPrefix,
244
- ),
245
- ),
246
- }),
247
- 201,
248
- );
177
+ return c.json(await loadApiPostResponse(c.var, post), 201);
249
178
  });
250
179
 
251
180
  // Update post (requires auth)
@@ -297,29 +226,7 @@ postsApiRoutes.put("/:id", requireAuthApi(), async (c) => {
297
226
  // Trigger GitHub Sync in background (no-op when sync isn't enabled).
298
227
  await triggerGitHubSyncInline(c);
299
228
 
300
- const mediaList = await c.var.services.media.getByPostId(post.id);
301
- const {
302
- r2PublicUrl,
303
- imageTransformUrl,
304
- s3PublicUrl,
305
- localPublicUrl,
306
- sitePathPrefix,
307
- } = c.var.appConfig;
308
-
309
- return c.json(
310
- toApiPost(post, {
311
- attachments: mediaList.map((m) =>
312
- toApiAttachment(
313
- m,
314
- r2PublicUrl,
315
- imageTransformUrl,
316
- s3PublicUrl,
317
- localPublicUrl,
318
- sitePathPrefix,
319
- ),
320
- ),
321
- }),
322
- );
229
+ return c.json(await loadApiPostResponse(c.var, post));
323
230
  });
324
231
 
325
232
  // =============================================================================
@@ -1,6 +1,9 @@
1
1
  import { describe, expect, it } from "vitest";
2
2
  import { createTestApp } from "../../../../__tests__/helpers/app.js";
3
+ import { walkPostPages } from "../../../../__tests__/helpers/cursor-walk.js";
4
+ import { createEntityId } from "../../../../lib/ids.js";
3
5
  import { publicArchiveApiRoutes } from "../archive.js";
6
+ import { publicPostsApiRoutes } from "../posts.js";
4
7
 
5
8
  describe("Public Archive API Routes", () => {
6
9
  describe("GET /api/public/archive", () => {
@@ -234,6 +237,70 @@ describe("Public Archive API Routes", () => {
234
237
  ]);
235
238
  });
236
239
 
240
+ // The failure this guards: with no time axis named, the list fell back to
241
+ // `lastActivityAt`, so a reply lifted a long-published root to the top of
242
+ // an endpoint documented as newest-published-first.
243
+ it("orders by publication date, not by the latest reply", async () => {
244
+ const { app, services } = createTestApp({ authenticated: false });
245
+ app.route("/api/public/archive", publicArchiveApiRoutes);
246
+
247
+ const oldest = await services.posts.create({
248
+ format: "note",
249
+ title: "Published January 2024",
250
+ bodyMarkdown: "oldest",
251
+ publishedAt: Date.UTC(2024, 0, 1) / 1000,
252
+ });
253
+ const extended = await services.posts.create({
254
+ format: "note",
255
+ title: "Published November 2024, replied to in 2026",
256
+ bodyMarkdown: "old root",
257
+ publishedAt: Date.UTC(2024, 10, 19) / 1000,
258
+ });
259
+ await services.posts.create({
260
+ format: "note",
261
+ bodyMarkdown: "new reply",
262
+ replyToId: extended.id,
263
+ publishedAt: Date.UTC(2026, 8, 26) / 1000,
264
+ });
265
+ const middle = await services.posts.create({
266
+ format: "note",
267
+ title: "Published March 2025",
268
+ bodyMarkdown: "middle",
269
+ publishedAt: Date.UTC(2025, 2, 1) / 1000,
270
+ });
271
+ const newest = await services.posts.create({
272
+ format: "note",
273
+ title: "Published December 2025",
274
+ bodyMarkdown: "newest",
275
+ publishedAt: Date.UTC(2025, 11, 1) / 1000,
276
+ });
277
+ const expected = [newest.id, middle.id, extended.id, oldest.id];
278
+
279
+ const all = await app.request("/api/public/archive");
280
+ expect(all.status).toBe(200);
281
+ const allBody = await all.json();
282
+ expect(allBody.posts.map((post: { id: string }) => post.id)).toEqual(
283
+ expected,
284
+ );
285
+
286
+ // One post per page puts a cursor on every boundary, including the two
287
+ // where publication and activity order disagree. A cursor comparison on
288
+ // a different axis from the ORDER BY would skip or repeat a post here.
289
+ const walked: string[] = [];
290
+ let cursor: string | null = null;
291
+ for (let page = 0; page <= expected.length; page++) {
292
+ const query: string = cursor ? `&cursor=${cursor}` : "";
293
+ const res = await app.request(`/api/public/archive?limit=1${query}`);
294
+ expect(res.status).toBe(200);
295
+ const body = await res.json();
296
+ walked.push(...body.posts.map((post: { id: string }) => post.id));
297
+ cursor = body.nextCursor;
298
+ if (cursor === null) break;
299
+ }
300
+ expect(cursor).toBeNull();
301
+ expect(walked).toEqual(expected);
302
+ });
303
+
237
304
  it("filters by year using publishedAt", async () => {
238
305
  const { app, services } = createTestApp({ authenticated: false });
239
306
  app.route("/api/public/archive", publicArchiveApiRoutes);
@@ -470,4 +537,198 @@ describe("Public Archive API Routes", () => {
470
537
  expect(res.status).toBe(400);
471
538
  });
472
539
  });
540
+
541
+ describe("cursors", () => {
542
+ function setup() {
543
+ const { app, services } = createTestApp({ authenticated: false });
544
+ app.route("/api/public/archive", publicArchiveApiRoutes);
545
+ app.route("/api/public/posts", publicPostsApiRoutes);
546
+ return { app, services };
547
+ }
548
+
549
+ /** Four roots published a day apart, oldest first. */
550
+ async function publishDays(services: ReturnType<typeof setup>["services"]) {
551
+ const created = [];
552
+ for (let day = 1; day <= 4; day++) {
553
+ created.push(
554
+ await services.posts.create({
555
+ format: "note",
556
+ title: `Day ${day}`,
557
+ bodyMarkdown: `day ${day}`,
558
+ publishedAt: Date.UTC(2025, 0, day) / 1000,
559
+ }),
560
+ );
561
+ }
562
+ return created;
563
+ }
564
+
565
+ async function page(
566
+ app: ReturnType<typeof setup>["app"],
567
+ path: string,
568
+ ): Promise<{ ids: string[]; nextCursor: string | null }> {
569
+ const res = await app.request(path);
570
+ expect(res.status).toBe(200);
571
+ const body = await res.json();
572
+ return {
573
+ ids: body.posts.map((post: { id: string }) => post.id),
574
+ nextCursor: body.nextCursor,
575
+ };
576
+ }
577
+
578
+ it("continues after the post the cursor was taken on is deleted", async () => {
579
+ const { app, services } = setup();
580
+ const [day1, day2, day3, day4] = await publishDays(services);
581
+
582
+ const first = await page(app, "/api/public/archive?limit=2");
583
+ expect(first.ids).toEqual([day4?.id, day3?.id]);
584
+ await services.posts.delete(day3?.id ?? "");
585
+
586
+ const second = await page(
587
+ app,
588
+ `/api/public/archive?limit=2&cursor=${first.nextCursor}`,
589
+ );
590
+ expect(second.ids).toEqual([day2?.id, day1?.id]);
591
+ expect(second.nextCursor).toBeNull();
592
+ });
593
+
594
+ it("skips nothing when the cursor post is re-dated mid-walk", async () => {
595
+ const { app, services } = setup();
596
+ const [day1, day2, day3, day4] = await publishDays(services);
597
+
598
+ const first = await page(app, "/api/public/archive?limit=2");
599
+ expect(first.ids).toEqual([day4?.id, day3?.id]);
600
+
601
+ // The author moves the page's last post before every other one. Resuming
602
+ // from where it now sits would return nothing more.
603
+ await services.posts.update(day3?.id ?? "", {
604
+ publishedAt: Date.UTC(2024, 0, 1) / 1000,
605
+ });
606
+ expect((await page(app, "/api/public/archive")).ids).toEqual([
607
+ day4?.id,
608
+ day2?.id,
609
+ day1?.id,
610
+ day3?.id,
611
+ ]);
612
+
613
+ const rest = await walkPostPages(
614
+ app,
615
+ "/api/public/archive",
616
+ 2,
617
+ first.nextCursor,
618
+ );
619
+ // Day 3 comes round again: its sort key changed mid-walk, which the
620
+ // paging guarantee does not cover. Nothing that stayed put is skipped.
621
+ expect(rest).toEqual([day2?.id, day1?.id, day3?.id]);
622
+ });
623
+
624
+ it("answers a private post's or a draft's ID as it does an unknown one", async () => {
625
+ const { app, services } = setup();
626
+ await publishDays(services);
627
+ const hidden = await services.posts.create({
628
+ format: "note",
629
+ title: "Private",
630
+ bodyMarkdown: "private",
631
+ visibility: "private",
632
+ });
633
+ const draft = await services.posts.create({
634
+ format: "note",
635
+ title: "Draft",
636
+ bodyMarkdown: "draft",
637
+ status: "draft",
638
+ });
639
+
640
+ const answers = [];
641
+ for (const id of [hidden.id, draft.id, createEntityId("post")]) {
642
+ for (const path of ["/api/public/archive", "/api/public/posts"]) {
643
+ const res = await app.request(`${path}?cursor=${id}`);
644
+ expect(res.status).toBe(400);
645
+ const body = await res.json();
646
+ expect(body.code).toBe("VALIDATION_ERROR");
647
+ answers.push(body.error);
648
+ }
649
+ }
650
+ // Nothing in the answer tells a real post from one that never existed.
651
+ expect(new Set(answers).size).toBe(1);
652
+ });
653
+
654
+ it("still resumes from a bare post ID", async () => {
655
+ const { app, services } = setup();
656
+ const [day1, day2, day3] = await publishDays(services);
657
+
658
+ const res = await page(app, `/api/public/archive?cursor=${day3?.id}`);
659
+ expect(res.ids).toEqual([day2?.id, day1?.id]);
660
+ });
661
+
662
+ it("rejects a cursor it can't read", async () => {
663
+ const { app, services } = setup();
664
+ await publishDays(services);
665
+
666
+ for (const cursor of ["garbage", "eyJ2IjoxfQ", "pst_", "%7B%7D"]) {
667
+ const res = await app.request(`/api/public/archive?cursor=${cursor}`);
668
+ expect(res.status).toBe(400);
669
+ expect((await res.json()).code).toBe("VALIDATION_ERROR");
670
+ }
671
+ });
672
+
673
+ it("rejects a cursor from a list in another order", async () => {
674
+ const { app, services } = setup();
675
+ await publishDays(services);
676
+ await services.posts.create({
677
+ format: "note",
678
+ title: "Featured",
679
+ bodyMarkdown: "featured",
680
+ featured: true,
681
+ });
682
+
683
+ // The archive reads publication order; `/api/public/posts` reads
684
+ // activity with pinned posts first.
685
+ const archive = await page(app, "/api/public/archive?limit=1");
686
+ const posts = await app.request(
687
+ `/api/public/posts?cursor=${archive.nextCursor}`,
688
+ );
689
+ expect(posts.status).toBe(400);
690
+ expect((await posts.json()).error).toMatch(/different order/);
691
+
692
+ // A cursor records a position in an order, not the filters around it:
693
+ // Featured-only reads the same order, so the position carries over.
694
+ const featured = await app.request(
695
+ `/api/public/archive?cursor=${archive.nextCursor}&visibility=featured`,
696
+ );
697
+ expect(featured.status).toBe(200);
698
+ });
699
+
700
+ it("walks every order it serves the same as one unpaged request", async () => {
701
+ const { app, services } = setup();
702
+ await publishDays(services);
703
+ const sameDay = Date.UTC(2025, 5, 1) / 1000;
704
+ for (const title of ["Tie A", "Tie B", "Tie C"]) {
705
+ await services.posts.create({
706
+ format: "note",
707
+ title,
708
+ bodyMarkdown: title,
709
+ publishedAt: sameDay,
710
+ featured: title !== "Tie C",
711
+ });
712
+ }
713
+ await services.posts.create({
714
+ format: "note",
715
+ title: "Pinned, and pinning doesn't count here",
716
+ bodyMarkdown: "pinned",
717
+ pinned: true,
718
+ publishedAt: Date.UTC(2023, 0, 1) / 1000,
719
+ });
720
+
721
+ for (const path of [
722
+ "/api/public/archive",
723
+ "/api/public/archive?visibility=featured",
724
+ "/api/public/archive?format=note&title=any",
725
+ ]) {
726
+ const expected = (await page(app, path)).ids;
727
+ expect(expected.length).toBeGreaterThan(1);
728
+ for (const limit of [1, 2, 3]) {
729
+ expect(await walkPostPages(app, path, limit)).toEqual(expected);
730
+ }
731
+ }
732
+ });
733
+ });
473
734
  });