Fix RSS feed markdown handling (#10)

Added markdown-to-HTML conversion for RSS feed descriptions using marked library.
Also added tests to verify that markdown is properly converted in the RSS feed.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: austinlparker

package-lock.json

@@ -16,6 +16,7 @@
     "@netlify/blobs": "^8.1.0",
     "@netlify/functions": "^3.0.0",
     "@octokit/webhooks-types": "^7.6.1",
+    "marked": "^15.0.9",
     "next": "15.3.1",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",

package.json

@@ -17,7 +17,7 @@ export async function POST() {
   const testEntry: ChangelogEntry = {
     id: Date.now(), // Use timestamp as ID for test entries
     title: `Test Entry ${new Date().toISOString()}`,
-    description: "This is a test entry to verify cache revalidation",
+    description: "This is a test entry with **bold text**, *italic* and a [link text](http://example.com) to verify markdown handling in RSS feed.",
     date: new Date().toISOString(),
     metadata: {
       sourceRepo: "open-telemetry/test-repo",

src/app/api/test/route.ts

@@ -4,10 +4,53 @@
  */
 
 import { getAllEntries } from "@/lib/store";
+import { marked } from "marked";
 
 export const dynamic = "force-dynamic";
 export const revalidate = 60;
 
+// Convert markdown to HTML for RSS feeds
+function markdownToHtml(markdown: string): string {
+  try {
+    return marked.parse(markdown);
+  } catch (error) {
+    console.warn("Failed to convert markdown to HTML:", error);
+    return markdown;
+  }
+}
+
+// Process GitHub-specific markdown like PR references, commit SHAs, etc.
+function processGitHubMarkdown(text: string, repoFullName: string): string {
+  let processedText = text;
+
+  // Replace PR references first (including those in parentheses)
+  const prPattern = /(?:^|\s|[([])#(\d+)(?=[\s\n\])]|$)/g;
+  processedText = processedText.replace(prPattern, (match, issue) => {
+    const prefix = match.startsWith("(") || match.startsWith("[") ? match[0] : " ";
+    return `${prefix}[#${issue}](https://github.com/${repoFullName}/issues/${issue})`;
+  });
+
+  // Replace commit SHAs
+  const shaPattern = /(\s|^)([0-9a-f]{40})(?=[\s\n]|$)/g;
+  processedText = processedText.replace(shaPattern, (match, space, sha) => {
+    return `${space}[${sha}](https://github.com/${repoFullName}/commit/${sha})`;
+  });
+
+  // Replace user mentions
+  const userPattern = /(?:^|\s)@([a-zA-Z0-9-]+)(?=[\s\n]|$)/g;
+  processedText = processedText.replace(userPattern, (match, username) => {
+    return ` [@${username}](https://github.com/${username})`;
+  });
+
+  // Replace repository references with issue numbers
+  const repoPattern = /([a-zA-Z0-9-]+\/[a-zA-Z0-9-._-]+)#(\d+)(?=[\s\n]|$)/g;
+  processedText = processedText.replace(repoPattern, (match, repo, issue) => {
+    return `[${repo}#${issue}](https://github.com/${repo}/issues/${issue})`;
+  });
+
+  return processedText;
+}
+
 export async function GET() {
   const entries = await getAllEntries();
   const baseUrl =
@@ -23,13 +66,18 @@ export async function GET() {
         <language>en-US</language>
         ${entries
           .map(
-            (entry) => `
+            (entry) => {
+              // Process GitHub markdown first, then convert to HTML
+              const processedDescription = processGitHubMarkdown(entry.description, entry.metadata.sourceRepo);
+              const htmlDescription = markdownToHtml(processedDescription);
+              
+              return `
           <item>
             <title><![CDATA[${entry.title}]]></title>
             <link>${baseUrl}/entry/${entry.id}</link>
             <guid isPermaLink="false">${entry.id}</guid>
             <pubDate>${new Date(entry.date).toUTCString()}</pubDate>
-            <description><![CDATA[${entry.description}]]></description>
+            <description><![CDATA[${htmlDescription}]]></description>
             ${
               entry.metadata.sourceRepo
                 ? `
@@ -38,7 +86,7 @@ export async function GET() {
                 : ""
             }
           </item>
-        `,
+        `}
           )
           .join("")}
       </channel>

src/app/feed/route.ts

@@ -17,6 +17,19 @@ test.describe('API Routes', () => {
     expect(body).toContain('<rss');
     expect(body).toContain('<channel>');
   });
+  
+  test('feed should handle markdown in descriptions', async ({ request }) => {
+    // This test will pass once we implement the markdown parsing fix
+    const response = await request.get('/feed');
+    expect(response.status()).toBe(200);
+    
+    const body = await response.text();
+    
+    // The test endpoint adds entries with markdown, let's verify we don't see raw markdown
+    // This will initially fail until we fix the issue
+    expect(body).not.toMatch(/\*\*bold text\*\*/);
+    expect(body).not.toMatch(/\[link text\]\(http:\/\/example\.com\)/);
+  });
 
   test('test API should work in development', async ({ request }) => {
     // When testing in CI, we're likely in development mode