Merge pull request #70 from techulus/develop

Add endpoint for fetching a post, Update docs

Author: arjunkomath

apps/docs/content/docs/api/page.mdx

@@ -3,7 +3,7 @@ title: Page
 description: These are APIs that can be used to fetch page data
 ---
 
-### Get the latest post
+### Get latest post
 
 This endpoint will return a JSON response of the latest post in the page.
 
@@ -70,3 +70,25 @@ GET https://yourpage.changes.page/changes.json
   }
 ]
 ```
+
+### Get a post by id
+
+This endpoint will return a JSON response of a post by id.
+
+```text title="Request"
+GET https://yourpage.changes.page/changes.json/:id
+```
+
+```json title="Response: 200 OK"
+{
+  "id": "cf8c52a9-27b3-47df-9f22-0c0af15cfaca",
+  "title": "Unlock Teamwork with Our Latest Feature Update",
+  "content": "We're kicking off 2025 by introducing one of our most highly requested features!",
+  "tags": ["announcement", "new"],
+  "publication_date": "2025-02-14T12:22:16.571+00:00",
+  "updated_at": "2025-02-14T12:22:17.887817+00:00",
+  "created_at": "2025-02-14T09:42:52.934045+00:00",
+  "url": "https://hey.changes.page/post/cf8c52a9-27b3-47df-9f22-0c0af15cfaca/unlock-teamwork-with-our-latest-feature-update",
+  "plain_text_content": "We're kicking off 2025 by introducing one of our most highly requested features!"
+}
+```

apps/page/next.config.js

@@ -87,6 +87,10 @@ const moduleExports = {
         source: "/changes.json",
         destination: "/api/json",
       },
+      {
+        source: "/changes.json/:id",
+        destination: "/api/post/:id",
+      },
       {
         source: "/latest.json",
         destination: "/api/latest",

apps/page/pages/api/json.ts

@@ -1,12 +1,12 @@
-import type { NextApiRequest, NextApiResponse } from "next";
 import { IPost } from "@changes-page/supabase/types/page";
+import { convertMarkdownToPlainText } from "@changes-page/utils";
+import type { NextApiRequest, NextApiResponse } from "next";
 import { allowCors } from "../../lib/cors";
 import {
   fetchPosts,
   fetchRenderData,
   translateHostToPageIdentifier,
 } from "../../lib/data";
-import { convertMarkdownToPlainText } from "@changes-page/utils";
 import { getPageUrl, getPostUrl } from "../../lib/url";
 
 async function handler(
@@ -43,7 +43,7 @@ async function handler(
 
     res.status(200).json(postsWithUrl);
   } catch (e: Error | any) {
-    console.log("changes.md [Error]", e);
+    console.log("Failed to fetch posts [Error]", e);
     res.status(200).json([]);
   }
 }

apps/page/pages/api/latest.ts

@@ -59,7 +59,7 @@ async function handler(
 
     res.status(200).json(postsWithUrl[0] ?? null);
   } catch (e: Error | any) {
-    console.log("changes.md [Error]", e);
+    console.log("Failed to fetch latest post [Error]", e);
     res.status(404).json(null);
   }
 }

apps/page/pages/api/markdown.ts

@@ -40,7 +40,7 @@ ${post.content}
 
     res.status(200).send(markdown);
   } catch (e: Error | any) {
-    console.log("changes.md [Error]", e);
+    console.log("Failed to fetch posts [changes.md] [Error]", e);
     res.status(200).send("## No posts Found");
   }
 }

apps/page/pages/api/pinned.ts

@@ -60,7 +60,7 @@ async function handler(
 
     res.status(200).json(postsWithUrl[0]);
   } catch (e: Error | any) {
-    console.log("changes.md [Error]", e);
+    console.log("Failed to fetch pinned post [Error]", e);
     res.status(404).json(null);
   }
 }

apps/page/pages/api/post/[id].ts

@@ -0,0 +1,76 @@
+import { supabaseAdmin } from "@changes-page/supabase/admin";
+import { IPost } from "@changes-page/supabase/types/page";
+import { convertMarkdownToPlainText } from "@changes-page/utils";
+import type { NextApiRequest, NextApiResponse } from "next";
+import { allowCors } from "../../../lib/cors";
+import {
+  fetchRenderData,
+  translateHostToPageIdentifier,
+} from "../../../lib/data";
+import { getPageUrl, getPostUrl } from "../../../lib/url";
+
+type IPostWithUrl = Pick<
+  IPost,
+  "id" | "title" | "content" | "tags" | "created_at"
+> & { url: string; plain_text_content: string };
+
+async function handler(
+  req: NextApiRequest,
+  res: NextApiResponse<IPostWithUrl | null>
+) {
+  const { id } = req.query;
+  if (!id) {
+    res.status(404).json(null);
+    return;
+  }
+
+  await allowCors(req, res);
+
+  const hostname = String(req?.headers?.host);
+  const { domain, page: url_slug } = translateHostToPageIdentifier(hostname);
+
+  try {
+    const { page, settings } = await fetchRenderData(
+      String(domain || url_slug)
+    );
+
+    if (!page) throw new Error("Page not found");
+    if (!settings) throw new Error("Settings not found");
+
+    const pageUrl = getPageUrl(page, settings, hostname);
+
+    const { data, error: postsError } = await supabaseAdmin
+      .from("posts")
+      .select("id,title,content,tags,publication_date,updated_at,created_at")
+      .eq("id", String(id))
+      .eq("page_id", String(page?.id))
+      .eq("status", "published")
+      .order("publication_date", { ascending: false })
+      .limit(1);
+
+    if (postsError) {
+      console.error("Fetch post error", postsError);
+      throw new Error("Failed to fetch posts");
+    }
+
+    const posts = data as Array<IPost>;
+
+    if (!posts?.length) {
+      res.status(404).json(null);
+      return;
+    }
+
+    const post = posts[0];
+
+    res.status(200).json({
+      ...post,
+      url: getPostUrl(pageUrl, post),
+      plain_text_content: convertMarkdownToPlainText(post.content),
+    });
+  } catch (e: Error | any) {
+    console.log("Failed to fetch post [Error]", e);
+    res.status(404).json(null);
+  }
+}
+
+export default handler;