@jant/core 0.3.36 → 0.3.37

package/src/services/__tests__/post.test.ts

@@ -1,23 +1,19 @@
 import { describe, it, expect, beforeEach } from "vitest";
+import { eq } from "drizzle-orm";
 import { createTestDatabase } from "../../__tests__/helpers/db.js";
+import { posts } from "../../db/schema.js";
 import { createPostService } from "../post.js";
-import { createPageService } from "../page.js";
-import { createPathRegistryService } from "../path-registry.js";
-import { ValidationError, ConflictError } from "../../lib/errors.js";
 import type { Database } from "../../db/index.js";
+import { createPathService } from "../path.js";
 
 describe("PostService", () => {
   let db: Database;
   let postService: ReturnType<typeof createPostService>;
-  let pageService: ReturnType<typeof createPageService>;
-  let pathRegistry: ReturnType<typeof createPathRegistryService>;
 
   beforeEach(() => {
     const testDb = createTestDatabase();
     db = testDb.db as unknown as Database;
-    pathRegistry = createPathRegistryService(db);
-    postService = createPostService(db, pathRegistry);
-    pageService = createPageService(db, pathRegistry);
+    postService = createPostService(db, { slugIdLength: 5 });
   });
 
   describe("create", () => {
@@ -36,17 +32,21 @@ describe("PostService", () => {
         body,
       });
 
-      expect(post.id).toBe(1);
+      expect(typeof post.id).toBe("string");
+      expect(post.id).toMatch(
+        /^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/,
+      );
       expect(post.format).toBe("note");
       expect(post.body).toBe(body);
       expect(post.status).toBe("published"); // default
-      expect(post.visibility).toBe("listed");
-      expect(post.pinned).toBe(0);
+      expect(post.visibility).toBe("public");
+      expect(post.pinnedAt).toBeNull();
       expect(post.bodyHtml).toContain("<p>Hello world</p>");
       expect(post.deletedAt).toBeNull();
+      expect(post.threadId).toBe(post.id);
     });
 
-    it("creates a post with all fields", async () => {
+    it("creates a link post with commentary", async () => {
       const body = JSON.stringify({
         type: "doc",
         content: [
@@ -66,22 +66,23 @@ describe("PostService", () => {
         title: "My Link",
         body,
         status: "published",
-        visibility: "featured",
+        visibility: "public",
+        featured: true,
         pinned: true,
-        path: "my-link",
+        slug: "my-link",
         url: "https://example.com/source",
-        quoteText: "A notable quote",
         rating: 5,
       });
 
       expect(post.format).toBe("link");
       expect(post.title).toBe("My Link");
       expect(post.status).toBe("published");
-      expect(post.visibility).toBe("featured");
-      expect(post.pinned).toBe(1);
-      expect(post.path).toBe("my-link");
+      expect(post.visibility).toBe("public");
+      expect(post.featuredAt).toBeTypeOf("number");
+      expect(post.pinnedAt).toBeTypeOf("number");
+      expect(post.slug).toBe("my-link");
       expect(post.url).toBe("https://example.com/source");
-      expect(post.quoteText).toBe("A notable quote");
+      expect(post.quoteText).toBeNull();
       expect(post.rating).toBe(5);
       expect(post.bodyHtml).toContain("<h1>");
     });
@@ -115,7 +116,7 @@ describe("PostService", () => {
     it("sets publishedAt and timestamps", async () => {
       const post = await postService.create({
         format: "note",
-        body: "test",
+        bodyMarkdown: "test",
       });
 
       expect(post.publishedAt).toBeGreaterThan(0);
@@ -127,31 +128,33 @@ describe("PostService", () => {
       const customTime = 1706745600;
       const post = await postService.create({
         format: "note",
-        body: "test",
+        bodyMarkdown: "test",
         publishedAt: customTime,
       });
 
       expect(post.publishedAt).toBe(customTime);
     });
 
-    it("creates incrementing IDs", async () => {
+    it("creates unique UUIDv7 IDs that sort chronologically", async () => {
       const post1 = await postService.create({
         format: "note",
-        body: "first",
+        bodyMarkdown: "first",
       });
       const post2 = await postService.create({
         format: "note",
-        body: "second",
+        bodyMarkdown: "second",
       });
 
-      expect(post2.id).toBeGreaterThan(post1.id);
+      expect(post1.id).not.toBe(post2.id);
+      // UUIDv7 strings sort chronologically
+      expect(post2.id > post1.id).toBe(true);
     });
 
     it("creates a quote post", async () => {
       const post = await postService.create({
         format: "quote",
         quoteText: "To be or not to be",
-        body: "Shakespeare's famous line",
+        bodyMarkdown: "Shakespeare's famous line",
         url: "https://example.com/hamlet",
       });
 
@@ -163,11 +166,110 @@ describe("PostService", () => {
     it("creates a draft post", async () => {
       const post = await postService.create({
         format: "note",
-        body: "draft content",
+        bodyMarkdown: "draft content",
         status: "draft",
       });
 
       expect(post.status).toBe("draft");
+      expect(post.publishedAt).toBeNull();
+    });
+
+    it("rejects ratings outside the database range", async () => {
+      await expect(
+        postService.create({
+          format: "note",
+          bodyMarkdown: "test",
+          rating: 6,
+        }),
+      ).rejects.toThrow();
+    });
+
+    it("rejects draft posts with an explicit publish time", async () => {
+      await expect(
+        postService.create({
+          format: "note",
+          bodyMarkdown: "draft content",
+          status: "draft",
+          publishedAt: 1706745600,
+        }),
+      ).rejects.toThrow("Drafts can't set a publish time.");
+    });
+
+    it("rejects note posts with a URL", async () => {
+      await expect(
+        postService.create({
+          format: "note",
+          url: "https://example.com",
+        }),
+      ).rejects.toThrow("Notes can't include a URL.");
+    });
+
+    it("rejects link posts without a URL", async () => {
+      await expect(
+        postService.create({
+          format: "link",
+          bodyMarkdown: "commentary",
+        }),
+      ).rejects.toThrow("Link posts need a URL.");
+    });
+
+    it("rejects link posts with quoted text", async () => {
+      await expect(
+        postService.create({
+          format: "link",
+          url: "https://example.com",
+          quoteText: "A notable quote",
+        }),
+      ).rejects.toThrow("Link posts can't include quoted text.");
+    });
+
+    it("rejects quote posts without quoted text", async () => {
+      await expect(
+        postService.create({
+          format: "quote",
+          bodyMarkdown: "commentary",
+        }),
+      ).rejects.toThrow("Quote posts need quoted text.");
+    });
+
+    it("rejects replies to missing posts", async () => {
+      await expect(
+        postService.create({
+          format: "note",
+          bodyMarkdown: "reply",
+          replyToId: "00000000-0000-0000-0000-000000009999",
+        }),
+      ).rejects.toThrow("Parent post not found");
+    });
+
+    it("rolls back the post insert when slug persistence fails inside the batch", async () => {
+      await postService.create({
+        format: "note",
+        bodyMarkdown: "existing",
+        slug: "race-condition",
+      });
+
+      const paths = createPathService(db);
+      const raceyPaths = {
+        ...paths,
+        isPathAvailable: async () => true,
+      };
+      const raceyPostService = createPostService(
+        db,
+        { slugIdLength: 5 },
+        raceyPaths,
+      );
+
+      await expect(
+        raceyPostService.create({
+          format: "note",
+          bodyMarkdown: "test",
+          slug: "race-condition",
+        }),
+      ).rejects.toThrow('Slug "race-condition" is already in use');
+
+      const rows = await db.select({ id: posts.id }).from(posts);
+      expect(rows).toHaveLength(1);
     });
   });
 
@@ -175,13 +277,13 @@ describe("PostService", () => {
     it("returns a post by ID", async () => {
       const created = await postService.create({
         format: "note",
-        body: "test",
+        bodyMarkdown: "test",
       });
 
       const found = await postService.getById(created.id);
       expect(found).not.toBeNull();
       expect(found?.id).toBe(created.id);
-      expect(found?.body).toBe("test");
+      expect(found?.bodyText).toBe("test");
     });
 
     it("returns null for non-existent ID", async () => {
@@ -192,7 +294,7 @@ describe("PostService", () => {
     it("excludes soft-deleted posts", async () => {
       const post = await postService.create({
         format: "note",
-        body: "test",
+        bodyMarkdown: "test",
       });
       await postService.delete(post.id);
 
@@ -201,47 +303,35 @@ describe("PostService", () => {
     });
   });
 
-  describe("getByPath", () => {
-    it("returns a post by path", async () => {
+  describe("getBySlug", () => {
+    it("returns a post by slug", async () => {
       await postService.create({
         format: "note",
-        body: "About page",
-        path: "about",
+        bodyMarkdown: "About page",
+        slug: "about",
       });
 
-      const found = await postService.getByPath("about");
+      const found = await postService.getBySlug("about");
       expect(found).not.toBeNull();
-      expect(found?.path).toBe("about");
+      expect(found?.slug).toBe("about");
     });
 
-    it("returns null for non-existent path", async () => {
-      const found = await postService.getByPath("nonexistent");
+    it("returns null for non-existent slug", async () => {
+      const found = await postService.getBySlug("nonexistent");
       expect(found).toBeNull();
     });
 
     it("excludes soft-deleted posts", async () => {
       const post = await postService.create({
         format: "note",
-        body: "test",
-        path: "test-page",
+        bodyMarkdown: "test",
+        slug: "test-page",
       });
       await postService.delete(post.id);
 
-      const found = await postService.getByPath("test-page");
+      const found = await postService.getBySlug("test-page");
       expect(found).toBeNull();
     });
-
-    it("finds a post with a multi-level path", async () => {
-      await postService.create({
-        format: "note",
-        body: "Blog migration",
-        path: "2024/01/my-post",
-      });
-
-      const found = await postService.getByPath("2024/01/my-post");
-      expect(found).not.toBeNull();
-      expect(found?.path).toBe("2024/01/my-post");
-    });
   });
 
   describe("list", () => {
@@ -251,9 +341,9 @@ describe("PostService", () => {
     });
 
     it("returns all non-deleted posts", async () => {
-      await postService.create({ format: "note", body: "first" });
-      await postService.create({ format: "note", body: "second" });
-      await postService.create({ format: "note", body: "third" });
+      await postService.create({ format: "note", bodyMarkdown: "first" });
+      await postService.create({ format: "note", bodyMarkdown: "second" });
+      await postService.create({ format: "note", bodyMarkdown: "third" });
 
       const posts = await postService.list();
       expect(posts).toHaveLength(3);
@@ -262,25 +352,50 @@ describe("PostService", () => {
     it("orders by publishedAt descending", async () => {
       await postService.create({
         format: "note",
-        body: "old",
+        bodyMarkdown: "old",
         publishedAt: 1000,
       });
       await postService.create({
         format: "note",
-        body: "new",
+        bodyMarkdown: "new",
         publishedAt: 2000,
       });
 
       const posts = await postService.list();
-      expect(posts[0]?.body).toBe("new");
-      expect(posts[1]?.body).toBe("old");
+      expect(posts[0]?.bodyText).toBe("new");
+      expect(posts[1]?.bodyText).toBe("old");
+    });
+
+    it("orders drafts by updatedAt descending", async () => {
+      const older = await postService.create({
+        format: "note",
+        bodyMarkdown: "older draft",
+        status: "draft",
+      });
+
+      await new Promise((r) => setTimeout(r, 1100));
+
+      const newer = await postService.create({
+        format: "note",
+        bodyMarkdown: "newer draft",
+        status: "draft",
+      });
+
+      await new Promise((r) => setTimeout(r, 1100));
+      await postService.update(older.id, {
+        bodyMarkdown: "older draft edited",
+      });
+
+      const drafts = await postService.list({ status: "draft" });
+      expect(drafts[0]?.id).toBe(older.id);
+      expect(drafts[1]?.id).toBe(newer.id);
     });
 
     it("filters by format", async () => {
-      await postService.create({ format: "note", body: "a note" });
+      await postService.create({ format: "note", bodyMarkdown: "a note" });
       await postService.create({
         format: "link",
-        body: "a link",
+        bodyMarkdown: "a link",
         title: "Link",
         url: "https://example.com",
       });
@@ -293,12 +408,12 @@ describe("PostService", () => {
     it("filters by status", async () => {
       await postService.create({
         format: "note",
-        body: "published post",
+        bodyMarkdown: "published post",
         status: "published",
       });
       await postService.create({
         format: "note",
-        body: "draft post",
+        bodyMarkdown: "draft post",
         status: "draft",
       });
 
@@ -310,98 +425,146 @@ describe("PostService", () => {
     it("filters by visibility", async () => {
       await postService.create({
         format: "note",
-        body: "featured post",
-        visibility: "featured",
+        bodyMarkdown: "public post",
       });
       await postService.create({
         format: "note",
-        body: "normal post",
+        bodyMarkdown: "unlisted post",
+        visibility: "unlisted",
       });
       await postService.create({
         format: "note",
-        body: "unlisted post",
-        visibility: "unlisted",
+        bodyMarkdown: "private post",
+        visibility: "private",
       });
 
-      const featured = await postService.list({ visibility: "featured" });
-      expect(featured).toHaveLength(1);
-      expect(featured[0]?.visibility).toBe("featured");
-      expect(featured[0]?.body).toBe("featured post");
-
-      const listed = await postService.list({ visibility: "listed" });
-      expect(listed).toHaveLength(1);
-      expect(listed[0]?.visibility).toBe("listed");
-      expect(listed[0]?.body).toBe("normal post");
+      const publicPosts = await postService.list({ visibility: "public" });
+      expect(publicPosts).toHaveLength(1);
+      expect(publicPosts[0]?.visibility).toBe("public");
+      expect(publicPosts[0]?.bodyText).toBe("public post");
 
       const unlisted = await postService.list({ visibility: "unlisted" });
       expect(unlisted).toHaveLength(1);
       expect(unlisted[0]?.visibility).toBe("unlisted");
-      expect(unlisted[0]?.body).toBe("unlisted post");
+      expect(unlisted[0]?.bodyText).toBe("unlisted post");
+
+      const privatePosts = await postService.list({ visibility: "private" });
+      expect(privatePosts).toHaveLength(1);
+      expect(privatePosts[0]?.visibility).toBe("private");
+      expect(privatePosts[0]?.bodyText).toBe("private post");
+    });
+
+    it("filters by featured", async () => {
+      await postService.create({
+        format: "note",
+        bodyMarkdown: "featured post",
+        featured: true,
+      });
+      await postService.create({
+        format: "note",
+        bodyMarkdown: "normal post",
+      });
+
+      const featured = await postService.list({ featured: true });
+      expect(featured).toHaveLength(1);
+      expect(featured[0]?.featuredAt).toBeTypeOf("number");
+      expect(featured[0]?.bodyText).toBe("featured post");
+
+      const notFeatured = await postService.list({ featured: false });
+      expect(notFeatured).toHaveLength(1);
+      expect(notFeatured[0]?.featuredAt).toBeNull();
+      expect(notFeatured[0]?.bodyText).toBe("normal post");
     });
 
     it("excludes unlisted posts when requested", async () => {
       await postService.create({
         format: "note",
-        body: "listed post",
+        bodyMarkdown: "public post",
       });
       await postService.create({
         format: "note",
-        body: "unlisted post",
+        bodyMarkdown: "unlisted post",
         visibility: "unlisted",
       });
       await postService.create({
         format: "note",
-        body: "featured post",
-        visibility: "featured",
+        bodyMarkdown: "featured post",
+        featured: true,
       });
 
       const posts = await postService.list({ excludeUnlisted: true });
       expect(posts).toHaveLength(2);
-      expect(posts.map((p) => p.body).sort()).toEqual([
+      // Featured posts have visibility "public", so both public and featured appear
+      expect(posts.map((p) => p.bodyText).sort()).toEqual([
+        "featured post",
+        "public post",
+      ]);
+    });
+
+    it("excludes private posts when excludePrivate is set", async () => {
+      await postService.create({
+        format: "note",
+        bodyMarkdown: "public post",
+      });
+      await postService.create({
+        format: "note",
+        bodyMarkdown: "private post",
+        visibility: "private",
+      });
+      await postService.create({
+        format: "note",
+        bodyMarkdown: "featured post",
+        featured: true,
+      });
+
+      const posts = await postService.list({ excludePrivate: true });
+      expect(posts).toHaveLength(2);
+      // Featured posts have visibility "public", so both public and featured appear
+      expect(posts.map((p) => p.bodyText).sort()).toEqual([
         "featured post",
-        "listed post",
+        "public post",
       ]);
     });
 
     it("filters by pinned", async () => {
       await postService.create({
         format: "note",
-        body: "pinned post",
+        bodyMarkdown: "pinned post",
         pinned: true,
       });
       await postService.create({
         format: "note",
-        body: "normal post",
+        bodyMarkdown: "normal post",
       });
 
       const pinned = await postService.list({ pinned: true });
       expect(pinned).toHaveLength(1);
-      expect(pinned[0]?.pinned).toBe(1);
-      expect(pinned[0]?.body).toBe("pinned post");
+      expect(pinned[0]?.pinnedAt).toBeTypeOf("number");
+      expect(pinned[0]?.bodyText).toBe("pinned post");
 
       const notPinned = await postService.list({ pinned: false });
       expect(notPinned).toHaveLength(1);
-      expect(notPinned[0]?.pinned).toBe(0);
-      expect(notPinned[0]?.body).toBe("normal post");
+      expect(notPinned[0]?.pinnedAt).toBeNull();
+      expect(notPinned[0]?.bodyText).toBe("normal post");
     });
 
     it("excludes deleted posts by default", async () => {
       const post = await postService.create({
         format: "note",
-        body: "test",
+        bodyMarkdown: "test",
       });
-      await postService.create({ format: "note", body: "kept" });
+      await postService.create({ format: "note", bodyMarkdown: "kept" });
       await postService.delete(post.id);
 
       const posts = await postService.list();
       expect(posts).toHaveLength(1);
-      expect(posts[0]?.body).toBe("kept");
+      expect(posts[0]?.bodyText).toBe("kept");
     });
 
     it("includes deleted posts when requested", async () => {
       const post = await postService.create({
         format: "note",
-        body: "test",
+        bodyMarkdown: "test",
       });
       await postService.delete(post.id);
 
@@ -411,7 +574,7 @@ describe("PostService", () => {
 
     it("supports limit", async () => {
       for (let i = 0; i < 5; i++) {
-        await postService.create({ format: "note", body: `post ${i}` });
+        await postService.create({ format: "note", bodyMarkdown: `post ${i}` });
       }
 
       const posts = await postService.list({ limit: 2 });
@@ -424,7 +587,7 @@ describe("PostService", () => {
         created.push(
           await postService.create({
             format: "note",
-            body: `post ${i}`,
+            bodyMarkdown: `post ${i}`,
             publishedAt: 1000 + i,
           }),
         );
@@ -439,24 +602,24 @@ describe("PostService", () => {
     it("excludes replies when requested", async () => {
       const root = await postService.create({
         format: "note",
-        body: "root post",
+        bodyMarkdown: "root post",
       });
       await postService.create({
         format: "note",
-        body: "reply",
+        bodyMarkdown: "reply",
         replyToId: root.id,
       });
 
       const posts = await postService.list({ excludeReplies: true });
       expect(posts).toHaveLength(1);
-      expect(posts[0]?.body).toBe("root post");
+      expect(posts[0]?.bodyText).toBe("root post");
     });
 
     it("supports offset pagination", async () => {
       for (let i = 0; i < 5; i++) {
         await postService.create({
           format: "note",
-          body: `post ${i}`,
+          bodyMarkdown: `post ${i}`,
           publishedAt: 1000 + i,
         });
       }
@@ -464,8 +627,8 @@ describe("PostService", () => {
       // Skip the first 2 posts (newest), get 2 more
       const posts = await postService.list({ limit: 2, offset: 2 });
       expect(posts).toHaveLength(2);
-      expect(posts[0]?.body).toBe("post 2");
-      expect(posts[1]?.body).toBe("post 1");
+      expect(posts[0]?.bodyText).toBe("post 2");
+      expect(posts[1]?.bodyText).toBe("post 1");
     });
   });
 
@@ -476,9 +639,9 @@ describe("PostService", () => {
     });
 
     it("counts all non-deleted posts", async () => {
-      await postService.create({ format: "note", body: "first" });
-      await postService.create({ format: "note", body: "second" });
-      await postService.create({ format: "note", body: "third" });
+      await postService.create({ format: "note", bodyMarkdown: "first" });
+      await postService.create({ format: "note", bodyMarkdown: "second" });
+      await postService.create({ format: "note", bodyMarkdown: "third" });
 
       const count = await postService.count();
       expect(count).toBe(3);
@@ -487,12 +650,12 @@ describe("PostService", () => {
     it("filters by status", async () => {
       await postService.create({
         format: "note",
-        body: "published",
+        bodyMarkdown: "published",
         status: "published",
       });
       await postService.create({
         format: "note",
-        body: "draft",
+        bodyMarkdown: "draft",
         status: "draft",
       });
 
@@ -503,21 +666,36 @@ describe("PostService", () => {
     it("filters by visibility", async () => {
       await postService.create({
         format: "note",
-        body: "featured",
-        visibility: "featured",
+        bodyMarkdown: "unlisted",
+        visibility: "unlisted",
       });
-      await postService.create({ format: "note", body: "normal" });
+      await postService.create({ format: "note", bodyMarkdown: "normal" });
 
-      const count = await postService.count({ visibility: "featured" });
+      const count = await postService.count({ visibility: "unlisted" });
       expect(count).toBe(1);
     });
 
+    it("filters by featured", async () => {
+      await postService.create({
+        format: "note",
+        bodyMarkdown: "featured",
+        featured: true,
+      });
+      await postService.create({ format: "note", bodyMarkdown: "normal" });
+
+      const featuredCount = await postService.count({ featured: true });
+      expect(featuredCount).toBe(1);
+
+      const notFeaturedCount = await postService.count({ featured: false });
+      expect(notFeaturedCount).toBe(1);
+    });
+
     it("excludes deleted posts by default", async () => {
       const post = await postService.create({
         format: "note",
-        body: "to delete",
+        bodyMarkdown: "to delete",
       });
-      await postService.create({ format: "note", body: "keep" });
+      await postService.create({ format: "note", bodyMarkdown: "keep" });
       await postService.delete(post.id);
 
       const count = await postService.count();
@@ -527,11 +705,11 @@ describe("PostService", () => {
     it("excludes replies when requested", async () => {
       const root = await postService.create({
         format: "note",
-        body: "root",
+        bodyMarkdown: "root",
       });
       await postService.create({
         format: "note",
-        body: "reply",
+        bodyMarkdown: "reply",
         replyToId: root.id,
       });
 
@@ -576,7 +754,7 @@ describe("PostService", () => {
     it("updates post title", async () => {
       const post = await postService.create({
         format: "link",
-        body: "body",
+        bodyMarkdown: "body",
         title: "Original Title",
         url: "https://example.com",
       });
@@ -591,7 +769,7 @@ describe("PostService", () => {
     it("updates post url", async () => {
       const post = await postService.create({
         format: "link",
-        body: "link post",
+        bodyMarkdown: "link post",
         url: "https://old.com",
       });
 
@@ -602,29 +780,29 @@ describe("PostService", () => {
       expect(updated?.url).toBe("https://new-source.com/path");
     });
 
-    it("clears url when set to null", async () => {
+    it("rejects clearing url from a link post", async () => {
       const post = await postService.create({
         format: "link",
-        body: "test",
+        bodyMarkdown: "test",
         url: "https://example.com",
       });
 
-      const updated = await postService.update(post.id, {
-        url: null,
-      });
-
-      expect(updated?.url).toBeNull();
+      await expect(
+        postService.update(post.id, {
+          url: null,
+        }),
+      ).rejects.toThrow("Link posts need a URL.");
     });
 
     it("returns null for non-existent post", async () => {
-      const result = await postService.update(9999, { body: "test" });
+      const result = await postService.update(9999, { bodyMarkdown: "test" });
       expect(result).toBeNull();
     });
 
     it("updates updatedAt timestamp", async () => {
       const post = await postService.create({
         format: "note",
-        body: "test",
+        bodyMarkdown: "test",
       });
       const originalUpdatedAt = post.updatedAt;
 
@@ -632,54 +810,124 @@ describe("PostService", () => {
       await new Promise((r) => setTimeout(r, 1100));
 
       const updated = await postService.update(post.id, {
-        body: "modified",
+        bodyMarkdown: "modified",
       });
 
       expect(updated?.updatedAt).toBeGreaterThanOrEqual(originalUpdatedAt);
     });
 
+    it("sets publishedAt when publishing a draft", async () => {
+      const post = await postService.create({
+        format: "note",
+        bodyMarkdown: "draft",
+        status: "draft",
+      });
+
+      expect(post.publishedAt).toBeNull();
+
+      await new Promise((r) => setTimeout(r, 1100));
+
+      const published = await postService.update(post.id, {
+        status: "published",
+      });
+
+      expect(published?.status).toBe("published");
+      expect(published?.publishedAt).toBeTypeOf("number");
+      expect((published?.publishedAt ?? 0) >= post.updatedAt).toBe(true);
+    });
+
+    it("clears publishedAt when converting a published post back to draft", async () => {
+      const post = await postService.create({
+        format: "note",
+        bodyMarkdown: "published",
+        publishedAt: 1706745600,
+      });
+
+      const draft = await postService.update(post.id, {
+        status: "draft",
+      });
+
+      expect(draft?.status).toBe("draft");
+      expect(draft?.publishedAt).toBeNull();
+    });
+
+    it("rejects setting publishedAt while remaining a draft", async () => {
+      const post = await postService.create({
+        format: "note",
+        bodyMarkdown: "draft",
+        status: "draft",
+      });
+
+      await expect(
+        postService.update(post.id, {
+          publishedAt: 1706745600,
+        }),
+      ).rejects.toThrow("Drafts can't set a publish time.");
+    });
+
     it("updates visibility", async () => {
       const post = await postService.create({
         format: "note",
-        body: "test",
+        bodyMarkdown: "test",
       });
 
-      expect(post.visibility).toBe("listed");
+      expect(post.visibility).toBe("public");
 
       const updated = await postService.update(post.id, {
-        visibility: "featured",
+        visibility: "unlisted",
       });
 
-      expect(updated?.visibility).toBe("featured");
+      expect(updated?.visibility).toBe("unlisted");
+    });
+
+    it("updates featured flag", async () => {
+      const post = await postService.create({
+        format: "note",
+        bodyMarkdown: "test",
+      });
+
+      expect(post.featuredAt).toBeNull();
+
+      const featured = await postService.update(post.id, {
+        featured: true,
+      });
+
+      expect(featured?.featuredAt).toBeTypeOf("number");
+
+      const unfeatured = await postService.update(post.id, {
+        featured: false,
+      });
+
+      expect(unfeatured?.featuredAt).toBeNull();
     });
 
     it("updates pinned flag", async () => {
       const post = await postService.create({
         format: "note",
-        body: "test",
+        bodyMarkdown: "test",
       });
 
-      expect(post.pinned).toBe(0);
+      expect(post.pinnedAt).toBeNull();
 
       const updated = await postService.update(post.id, {
         pinned: true,
       });
 
-      expect(updated?.pinned).toBe(1);
+      expect(updated?.pinnedAt).toBeTypeOf("number");
     });
 
-    it("updates path", async () => {
+    it("updates slug", async () => {
       const post = await postService.create({
         format: "note",
-        body: "test",
-        path: "old-path",
+        bodyMarkdown: "test",
+        slug: "old-slug",
       });
 
       const updated = await postService.update(post.id, {
-        path: "new-path",
+        slug: "new-slug",
       });
 
-      expect(updated?.path).toBe("new-path");
+      expect(updated?.slug).toBe("new-slug");
     });
 
     it("updates quoteText and rating", async () => {
@@ -697,13 +945,40 @@ describe("PostService", () => {
       expect(updated?.quoteText).toBe("Updated quote");
       expect(updated?.rating).toBe(5);
     });
+
+    it("rejects switching a note to link without adding a URL", async () => {
+      const post = await postService.create({
+        format: "note",
+        bodyMarkdown: "test",
+      });
+
+      await expect(
+        postService.update(post.id, {
+          format: "link",
+        }),
+      ).rejects.toThrow("Link posts need a URL.");
+    });
+
+    it("rejects switching a link to note without clearing the URL", async () => {
+      const post = await postService.create({
+        format: "link",
+        bodyMarkdown: "test",
+        url: "https://example.com",
+      });
+
+      await expect(
+        postService.update(post.id, {
+          format: "note",
+        }),
+      ).rejects.toThrow("Notes can't include a URL.");
+    });
   });
 
   describe("delete (soft delete)", () => {
     it("soft-deletes a post", async () => {
       const post = await postService.create({
         format: "note",
-        body: "test",
+        bodyMarkdown: "test",
       });
 
       const result = await postService.delete(post.id);
@@ -722,11 +997,11 @@ describe("PostService", () => {
     it("cascade deletes thread when deleting root post", async () => {
       const root = await postService.create({
         format: "note",
-        body: "root",
+        bodyMarkdown: "root",
       });
       const reply = await postService.create({
         format: "note",
-        body: "reply",
+        bodyMarkdown: "reply",
         replyToId: root.id,
       });
 
@@ -740,16 +1015,16 @@ describe("PostService", () => {
     it("only deletes single post when deleting a reply", async () => {
       const root = await postService.create({
         format: "note",
-        body: "root",
+        bodyMarkdown: "root",
       });
       const reply1 = await postService.create({
         format: "note",
-        body: "reply1",
+        bodyMarkdown: "reply1",
         replyToId: root.id,
       });
       await postService.create({
         format: "note",
-        body: "reply2",
+        bodyMarkdown: "reply2",
         replyToId: root.id,
       });
 
@@ -766,11 +1041,11 @@ describe("PostService", () => {
     it("sets threadId on reply to a root post", async () => {
       const root = await postService.create({
         format: "note",
-        body: "root",
+        bodyMarkdown: "root",
       });
       const reply = await postService.create({
         format: "note",
-        body: "reply",
+        bodyMarkdown: "reply",
         replyToId: root.id,
       });
 
@@ -781,16 +1056,16 @@ describe("PostService", () => {
     it("inherits threadId from parent in nested replies", async () => {
       const root = await postService.create({
         format: "note",
-        body: "root",
+        bodyMarkdown: "root",
       });
       const reply1 = await postService.create({
         format: "note",
-        body: "reply1",
+        bodyMarkdown: "reply1",
         replyToId: root.id,
       });
       const reply2 = await postService.create({
         format: "note",
-        body: "reply2",
+        bodyMarkdown: "reply2",
         replyToId: reply1.id,
       });
 
@@ -802,63 +1077,121 @@ describe("PostService", () => {
     it("inherits status from root post", async () => {
       const root = await postService.create({
         format: "note",
-        body: "root",
+        bodyMarkdown: "root",
         status: "draft",
       });
       const reply = await postService.create({
         format: "note",
-        body: "reply",
+        bodyMarkdown: "reply",
         replyToId: root.id,
       });
 
       expect(reply.status).toBe("draft");
     });
 
+    it("preserves draft status when reply explicitly requests it", async () => {
+      const root = await postService.create({
+        format: "note",
+        bodyMarkdown: "root",
+        status: "published",
+      });
+      const reply = await postService.create({
+        format: "note",
+        bodyMarkdown: "reply",
+        status: "draft",
+        replyToId: root.id,
+      });
+
+      expect(reply.status).toBe("draft");
+      expect(reply.threadId).toBe(root.id);
+    });
+
     it("inherits visibility from root post", async () => {
       const root = await postService.create({
         format: "note",
-        body: "root",
-        visibility: "featured",
+        bodyMarkdown: "root",
+        visibility: "unlisted",
+      });
+      const reply = await postService.create({
+        format: "note",
+        bodyMarkdown: "reply",
+        replyToId: root.id,
+      });
+
+      expect(reply.visibility).toBe("unlisted");
+    });
+
+    it("stores reply visibility as null and resolves it from the root", async () => {
+      const root = await postService.create({
+        format: "note",
+        bodyMarkdown: "root",
+        visibility: "private",
       });
       const reply = await postService.create({
         format: "note",
-        body: "reply",
+        bodyMarkdown: "reply",
         replyToId: root.id,
       });
 
-      expect(reply.visibility).toBe("featured");
+      const rows = await db
+        .select({ visibility: posts.visibility })
+        .from(posts)
+        .where(eq(posts.id, reply.id))
+        .limit(1);
+
+      expect(rows[0]?.visibility).toBeNull();
+      expect(reply.visibility).toBe("private");
+    });
+
+    it("does not inherit featuredAt from root post", async () => {
+      const root = await postService.create({
+        format: "note",
+        bodyMarkdown: "root",
+        featured: true,
+      });
+
+      expect(root.featuredAt).toBeTypeOf("number");
+
+      const reply = await postService.create({
+        format: "note",
+        bodyMarkdown: "reply",
+        replyToId: root.id,
+      });
+
+      // featuredAt is an independent property — replies should NOT inherit it
+      expect(reply.featuredAt).toBeNull();
     });
 
     it("getThread returns all posts in a thread", async () => {
       const root = await postService.create({
         format: "note",
-        body: "root",
+        bodyMarkdown: "root",
       });
       await postService.create({
         format: "note",
-        body: "reply1",
+        bodyMarkdown: "reply1",
         replyToId: root.id,
       });
       await postService.create({
         format: "note",
-        body: "reply2",
+        bodyMarkdown: "reply2",
         replyToId: root.id,
       });
 
       const thread = await postService.getThread(root.id);
       expect(thread).toHaveLength(3);
       // Ordered by createdAt
-      expect(thread[0]?.body).toBe("root");
+      expect(thread[0]?.bodyText).toBe("root");
     });
 
     it("getThread excludes deleted posts", async () => {
       const root = await postService.create({
         format: "note",
-        body: "root",
+        bodyMarkdown: "root",
       });
       const reply = await postService.create({
         format: "note",
-        body: "reply",
+        bodyMarkdown: "reply",
         replyToId: root.id,
       });
 
@@ -871,12 +1204,12 @@ describe("PostService", () => {
     it("cascades status changes from root to thread", async () => {
       const root = await postService.create({
         format: "note",
-        body: "root",
+        bodyMarkdown: "root",
         status: "published",
       });
       await postService.create({
         format: "note",
-        body: "reply",
+        bodyMarkdown: "reply",
         replyToId: root.id,
       });
 
@@ -885,27 +1218,151 @@ describe("PostService", () => {
       const thread = await postService.getThread(root.id);
       for (const post of thread) {
         expect(post.status).toBe("draft");
+        expect(post.publishedAt).toBeNull();
+      }
+    });
+
+    it("publishing a draft thread stamps publishedAt on all posts", async () => {
+      const root = await postService.create({
+        format: "note",
+        bodyMarkdown: "root",
+        status: "draft",
+      });
+      await postService.create({
+        format: "note",
+        bodyMarkdown: "reply",
+        replyToId: root.id,
+      });
+
+      await new Promise((r) => setTimeout(r, 1100));
+      await postService.update(root.id, { status: "published" });
+
+      const thread = await postService.getThread(root.id);
+      for (const post of thread) {
+        expect(post.status).toBe("published");
+        expect(post.publishedAt).toBeTypeOf("number");
       }
     });
 
     it("cascades visibility changes from root to thread", async () => {
       const root = await postService.create({
         format: "note",
-        body: "root",
+        bodyMarkdown: "root",
       });
       await postService.create({
         format: "note",
-        body: "reply",
+        bodyMarkdown: "reply",
         replyToId: root.id,
       });
 
-      await postService.update(root.id, { visibility: "featured" });
+      await postService.update(root.id, { visibility: "unlisted" });
 
       const thread = await postService.getThread(root.id);
       for (const post of thread) {
-        expect(post.visibility).toBe("featured");
+        expect(post.visibility).toBe("unlisted");
       }
     });
+
+    it("filters replies by the root post visibility", async () => {
+      const unlistedRoot = await postService.create({
+        format: "note",
+        bodyMarkdown: "root",
+        visibility: "unlisted",
+      });
+      const unlistedReply = await postService.create({
+        format: "note",
+        bodyMarkdown: "reply",
+        replyToId: unlistedRoot.id,
+      });
+      await postService.create({
+        format: "note",
+        bodyMarkdown: "public root",
+      });
+
+      const postsByVisibility = await postService.list({
+        visibility: "unlisted",
+      });
+
+      expect(postsByVisibility.map((post) => post.id)).toEqual([
+        unlistedReply.id,
+        unlistedRoot.id,
+      ]);
+    });
+
+    it("rejects visibility changes on thread replies", async () => {
+      const root = await postService.create({
+        format: "note",
+        bodyMarkdown: "root",
+      });
+      const reply = await postService.create({
+        format: "note",
+        bodyMarkdown: "reply",
+        replyToId: root.id,
+      });
+
+      await expect(
+        postService.update(reply.id, { visibility: "unlisted" }),
+      ).rejects.toThrow(
+        "Cannot change visibility of a thread reply. Update the root post instead.",
+      );
+    });
+
+    it("allows featuring a thread reply", async () => {
+      const root = await postService.create({
+        format: "note",
+        bodyMarkdown: "root",
+      });
+      const reply = await postService.create({
+        format: "note",
+        bodyMarkdown: "reply",
+        replyToId: root.id,
+      });
+
+      // Featured is independent of visibility — replies can be featured
+      const updated = await postService.update(reply.id, { featured: true });
+      expect(updated?.featuredAt).toBeTypeOf("number");
+
+      const unfeatured = await postService.update(reply.id, {
+        featured: false,
+      });
+      expect(unfeatured?.featuredAt).toBeNull();
+    });
+
+    it("rejects creating a pinned thread reply", async () => {
+      const root = await postService.create({
+        format: "note",
+        bodyMarkdown: "root",
+      });
+
+      await expect(
+        postService.create({
+          format: "note",
+          bodyMarkdown: "reply",
+          replyToId: root.id,
+          pinned: true,
+        }),
+      ).rejects.toThrow(
+        "Cannot pin a thread reply. Pin the root post instead.",
+      );
+    });
+
+    it("rejects pinning a thread reply", async () => {
+      const root = await postService.create({
+        format: "note",
+        bodyMarkdown: "root",
+      });
+      const reply = await postService.create({
+        format: "note",
+        bodyMarkdown: "reply",
+        replyToId: root.id,
+      });
+
+      await expect(
+        postService.update(reply.id, { pinned: true }),
+      ).rejects.toThrow(
+        "Cannot pin a thread reply. Pin the root post instead.",
+      );
+    });
   });
 
   describe("getReplyCounts", () => {
@@ -917,16 +1374,16 @@ describe("PostService", () => {
     it("returns reply counts for posts", async () => {
       const root = await postService.create({
         format: "note",
-        body: "root",
+        bodyMarkdown: "root",
       });
       await postService.create({
         format: "note",
-        body: "reply1",
+        bodyMarkdown: "reply1",
         replyToId: root.id,
       });
       await postService.create({
         format: "note",
-        body: "reply2",
+        bodyMarkdown: "reply2",
         replyToId: root.id,
       });
 
@@ -937,7 +1394,7 @@ describe("PostService", () => {
     it("returns 0 (missing) for posts without replies", async () => {
       const post = await postService.create({
         format: "note",
-        body: "no replies",
+        bodyMarkdown: "no replies",
       });
 
       const counts = await postService.getReplyCounts([post.id]);
@@ -947,16 +1404,16 @@ describe("PostService", () => {
     it("excludes deleted replies from count", async () => {
       const root = await postService.create({
         format: "note",
-        body: "root",
+        bodyMarkdown: "root",
       });
       const reply = await postService.create({
         format: "note",
-        body: "reply",
+        bodyMarkdown: "reply",
         replyToId: root.id,
       });
       await postService.create({
         format: "note",
-        body: "reply2",
+        bodyMarkdown: "reply2",
         replyToId: root.id,
       });
 
@@ -965,100 +1422,122 @@ describe("PostService", () => {
       const counts = await postService.getReplyCounts([root.id]);
       expect(counts.get(root.id)).toBe(1);
     });
-  });
 
-  describe("path registry integration", () => {
-    it("claims path on create", async () => {
-      const post = await postService.create({
+    it("excludes draft replies from count", async () => {
+      const root = await postService.create({
         format: "note",
-        body: "test",
-        path: "my-post",
+        bodyMarkdown: "root",
       });
-
-      const entry = await pathRegistry.getByPath("my-post");
-      expect(entry).not.toBeNull();
-      expect(entry?.ownerType).toBe("post");
-      expect(entry?.ownerId).toBe(post.id);
-    });
-
-    it("does not claim when no path provided", async () => {
       await postService.create({
         format: "note",
-        body: "test",
+        bodyMarkdown: "published reply",
+        replyToId: root.id,
+      });
+      await postService.create({
+        format: "note",
+        bodyMarkdown: "draft reply",
+        replyToId: root.id,
+        status: "draft",
       });
 
-      // No path registry entries should exist
-      expect(await pathRegistry.isAvailable("test")).toBe(true);
-    });
-
-    it("rejects path that conflicts with a page slug", async () => {
-      await pageService.create({ slug: "about", title: "About" });
-
-      await expect(
-        postService.create({ format: "note", body: "test", path: "about" }),
-      ).rejects.toThrow(ConflictError);
-    });
-
-    it("rejects reserved path on create", async () => {
-      await expect(
-        postService.create({ format: "note", body: "test", path: "dash" }),
-      ).rejects.toThrow(ValidationError);
+      const counts = await postService.getReplyCounts([root.id]);
+      expect(counts.get(root.id)).toBe(1);
     });
+  });
 
-    it("releases old path and claims new on update", async () => {
+  describe("lastActivityAt (thread bump-to-top)", () => {
+    it("sets lastActivityAt equal to publishedAt for non-thread posts", async () => {
       const post = await postService.create({
         format: "note",
-        body: "test",
-        path: "old-path",
+        bodyMarkdown: "standalone",
+        publishedAt: 5000,
       });
 
-      await postService.update(post.id, { path: "new-path" });
-
-      expect(await pathRegistry.isAvailable("old-path")).toBe(true);
-      expect(await pathRegistry.isAvailable("new-path")).toBe(false);
+      expect(post.lastActivityAt).toBe(5000);
     });
 
-    it("releases path when cleared to null on update", async () => {
-      const post = await postService.create({
+    it("updates root lastActivityAt when a reply is created", async () => {
+      const root = await postService.create({
         format: "note",
-        body: "test",
-        path: "my-path",
+        bodyMarkdown: "root",
+        publishedAt: 1000,
       });
+      expect(root.lastActivityAt).toBe(1000);
 
-      await postService.update(post.id, { path: null });
+      await postService.create({
+        format: "note",
+        bodyMarkdown: "reply",
+        replyToId: root.id,
+        publishedAt: 9000,
+      });
 
-      expect(await pathRegistry.isAvailable("my-path")).toBe(true);
+      const updatedRoot = await postService.getById(root.id);
+      expect(updatedRoot?.lastActivityAt).toBe(9000);
     });
 
-    it("releases path on soft-delete", async () => {
-      const post = await postService.create({
+    it("list returns thread root bumped to top after reply", async () => {
+      const oldPost = await postService.create({
+        format: "note",
+        bodyMarkdown: "old thread root",
+        publishedAt: 1000,
+      });
+      await postService.create({
         format: "note",
-        body: "test",
-        path: "my-path",
+        bodyMarkdown: "newer standalone",
+        publishedAt: 5000,
       });
 
-      await postService.delete(post.id);
+      // Reply to old post with a newer timestamp — should bump it above standalone
+      await postService.create({
+        format: "note",
+        bodyMarkdown: "reply",
+        replyToId: oldPost.id,
+        publishedAt: 9000,
+      });
 
-      expect(await pathRegistry.isAvailable("my-path")).toBe(true);
+      const listed = await postService.list({ excludeReplies: true });
+      expect(listed[0]?.bodyText).toBe("old thread root");
+      expect(listed[1]?.bodyText).toBe("newer standalone");
     });
 
-    it("releases paths for all thread posts on root delete", async () => {
+    it("recalculates root lastActivityAt when a reply is deleted", async () => {
       const root = await postService.create({
         format: "note",
-        body: "root",
-        path: "thread-root",
+        bodyMarkdown: "root",
+        publishedAt: 1000,
+      });
+      const reply1 = await postService.create({
+        format: "note",
+        bodyMarkdown: "reply1",
+        replyToId: root.id,
+        publishedAt: 3000,
       });
       await postService.create({
         format: "note",
-        body: "reply",
-        path: "thread-reply",
+        bodyMarkdown: "reply2",
         replyToId: root.id,
+        publishedAt: 5000,
       });
 
-      await postService.delete(root.id);
+      // Root should be bumped to latest reply
+      let updatedRoot = await postService.getById(root.id);
+      expect(updatedRoot?.lastActivityAt).toBe(5000);
+
+      // Delete the latest reply — root should fall back to reply1's time
+      const reply2 = (await postService.list({ threadId: root.id })).find(
+        (p) => p.bodyText === "reply2",
+      );
+      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- test setup guarantees reply2 exists
+      await postService.delete(reply2!.id);
+
+      updatedRoot = await postService.getById(root.id);
+      expect(updatedRoot?.lastActivityAt).toBe(3000);
+
+      // Delete the remaining reply — root should fall back to its own publishedAt
+      await postService.delete(reply1.id);
 
-      expect(await pathRegistry.isAvailable("thread-root")).toBe(true);
-      expect(await pathRegistry.isAvailable("thread-reply")).toBe(true);
+      updatedRoot = await postService.getById(root.id);
+      expect(updatedRoot?.lastActivityAt).toBe(1000);
     });
   });
 });