import { httpRouter } from "convex/server";
import { httpAction } from "./_generated/server";
import { api } from "./_generated/api";
import { rssFeed, rssFullFeed } from "./rss";
const http = httpRouter();
// Site configuration
const SITE_URL = process.env.SITE_URL || "https://www.markdown.fast";
const SITE_NAME = "markdown sync framework";
// RSS feed endpoint (descriptions only)
http.route({
path: "/rss.xml",
method: "GET",
handler: rssFeed,
});
// Full RSS feed endpoint (with complete content for LLMs)
http.route({
path: "/rss-full.xml",
method: "GET",
handler: rssFullFeed,
});
// Sitemap.xml endpoint for search engines (includes posts, pages, and tag pages)
http.route({
path: "/sitemap.xml",
method: "GET",
handler: httpAction(async (ctx) => {
const posts = await ctx.runQuery(api.posts.getAllPosts);
const pages = await ctx.runQuery(api.pages.getAllPages);
const tags = await ctx.runQuery(api.posts.getAllTags);
const urls = [
// Homepage
`
${SITE_URL}/
daily
1.0
`,
// All posts
...posts.map(
(post) => `
${SITE_URL}/${post.slug}
${post.date}
monthly
0.8
`,
),
// All pages
...pages.map(
(page) => `
${SITE_URL}/${page.slug}
monthly
0.7
`,
),
// All tag pages
...tags.map(
(tagInfo) => `
${SITE_URL}/tags/${encodeURIComponent(tagInfo.tag.toLowerCase())}
weekly
0.6
`,
),
];
const xml = `
${urls.join("\n")}
`;
return new Response(xml, {
headers: {
"Content-Type": "application/xml; charset=utf-8",
"Cache-Control": "public, max-age=3600, s-maxage=7200",
},
});
}),
});
// API endpoint: List all posts (JSON for LLMs/agents)
http.route({
path: "/api/posts",
method: "GET",
handler: httpAction(async (ctx) => {
const posts = await ctx.runQuery(api.posts.getAllPosts);
const response = {
site: SITE_NAME,
url: SITE_URL,
description:
"An open-source publishing framework for AI agents and developers. Write markdown, sync from the terminal. Your content is instantly available to browsers, LLMs, and AI agents. Built on Convex and Netlify.",
posts: posts.map((post) => ({
title: post.title,
slug: post.slug,
description: post.description,
date: post.date,
readTime: post.readTime,
tags: post.tags,
url: `${SITE_URL}/${post.slug}`,
markdownUrl: `${SITE_URL}/api/post?slug=${post.slug}`,
})),
};
return new Response(JSON.stringify(response, null, 2), {
headers: {
"Content-Type": "application/json; charset=utf-8",
"Cache-Control": "public, max-age=300, s-maxage=600",
"Access-Control-Allow-Origin": "*",
},
});
}),
});
// API endpoint: Get single post as markdown (for LLMs/agents)
http.route({
path: "/api/post",
method: "GET",
handler: httpAction(async (ctx, request) => {
const url = new URL(request.url);
const slug = url.searchParams.get("slug");
const format = url.searchParams.get("format") || "json";
if (!slug) {
return new Response(JSON.stringify({ error: "Missing slug parameter" }), {
status: 400,
headers: { "Content-Type": "application/json" },
});
}
const post = await ctx.runQuery(api.posts.getPostBySlug, { slug });
if (!post) {
return new Response(JSON.stringify({ error: "Post not found" }), {
status: 404,
headers: { "Content-Type": "application/json" },
});
}
// Return raw markdown if requested
if (format === "markdown" || format === "md") {
const markdown = `# ${post.title}
> ${post.description}
**Published:** ${post.date}${post.readTime ? ` | **Read time:** ${post.readTime}` : ""}
**Tags:** ${post.tags.join(", ")}
**URL:** ${SITE_URL}/${post.slug}
---
${post.content}`;
return new Response(markdown, {
headers: {
"Content-Type": "text/markdown; charset=utf-8",
"Cache-Control": "public, max-age=300, s-maxage=600",
"Access-Control-Allow-Origin": "*",
},
});
}
// Default: JSON response
const response = {
title: post.title,
slug: post.slug,
description: post.description,
date: post.date,
readTime: post.readTime,
tags: post.tags,
url: `${SITE_URL}/${post.slug}`,
content: post.content,
};
return new Response(JSON.stringify(response, null, 2), {
headers: {
"Content-Type": "application/json; charset=utf-8",
"Cache-Control": "public, max-age=300, s-maxage=600",
"Access-Control-Allow-Origin": "*",
},
});
}),
});
// API endpoint: Export all posts with full content (batch for LLMs)
http.route({
path: "/api/export",
method: "GET",
handler: httpAction(async (ctx) => {
const posts = await ctx.runQuery(api.posts.getAllPosts);
// Fetch full content for each post
const fullPosts = await Promise.all(
posts.map(async (post) => {
const fullPost = await ctx.runQuery(api.posts.getPostBySlug, {
slug: post.slug,
});
return {
title: post.title,
slug: post.slug,
description: post.description,
date: post.date,
readTime: post.readTime,
tags: post.tags,
url: `${SITE_URL}/${post.slug}`,
content: fullPost?.content || "",
};
}),
);
const response = {
site: SITE_NAME,
url: SITE_URL,
description:
"An open-source publishing framework for AI agents and developers. Write markdown, sync from the terminal. Your content is instantly available to browsers, LLMs, and AI agents. Built on Convex and Netlify.",
exportedAt: new Date().toISOString(),
totalPosts: fullPosts.length,
posts: fullPosts,
};
return new Response(JSON.stringify(response, null, 2), {
headers: {
"Content-Type": "application/json; charset=utf-8",
"Cache-Control": "public, max-age=300, s-maxage=600",
"Access-Control-Allow-Origin": "*",
},
});
}),
});
// Escape HTML characters to prevent XSS
function escapeHtml(text: string): string {
return text
.replace(/&/g, "&")
.replace(//g, ">")
.replace(/"/g, """)
.replace(/'/g, "'");
}
// Generate Open Graph HTML for a post or page
function generateMetaHtml(content: {
title: string;
description: string;
slug: string;
date?: string;
readTime?: string;
image?: string;
type?: "post" | "page";
}): string {
const siteUrl = process.env.SITE_URL || "https://markdown.fast";
const siteName = "markdown sync framework";
const defaultImage = `${siteUrl}/images/og-default.svg`;
const canonicalUrl = `${siteUrl}/${content.slug}`;
// Resolve image URL: use post image if available, otherwise default
let ogImage = defaultImage;
if (content.image) {
// Handle both absolute URLs and relative paths
ogImage = content.image.startsWith("http")
? content.image
: `${siteUrl}${content.image}`;
}
const safeTitle = escapeHtml(content.title);
const safeDescription = escapeHtml(content.description);
const contentType = content.type || "post";
const ogType = contentType === "post" ? "article" : "website";
return `
${safeTitle} | ${siteName}
${
content.date
? `
`
: ""
}
${safeTitle}
${safeDescription}
${
content.date
? `
${content.date}${content.readTime ? ` ยท ${content.readTime}` : ""}
`
: ""
}
Redirecting to full ${contentType}...
`;
}
// HTTP endpoint for Open Graph metadata (supports both posts and pages)
http.route({
path: "/meta/post",
method: "GET",
handler: httpAction(async (ctx, request) => {
const url = new URL(request.url);
const slug = url.searchParams.get("slug");
if (!slug) {
return new Response("Missing slug parameter", { status: 400 });
}
try {
// First try to find a post
const post = await ctx.runQuery(api.posts.getPostBySlug, { slug });
if (post) {
const html = generateMetaHtml({
title: post.title,
description: post.description,
slug: post.slug,
date: post.date,
readTime: post.readTime,
image: post.image,
type: "post",
});
return new Response(html, {
headers: {
"Content-Type": "text/html; charset=utf-8",
"Cache-Control":
"public, max-age=60, s-maxage=300, stale-while-revalidate=600",
},
});
}
// If no post found, try to find a page
const page = await ctx.runQuery(api.pages.getPageBySlug, { slug });
if (page) {
const html = generateMetaHtml({
title: page.title,
description: page.excerpt || `${page.title} - ${SITE_NAME}`,
slug: page.slug,
image: page.image,
type: "page",
});
return new Response(html, {
headers: {
"Content-Type": "text/html; charset=utf-8",
"Cache-Control":
"public, max-age=60, s-maxage=300, stale-while-revalidate=600",
},
});
}
// Neither post nor page found
return new Response("Content not found", { status: 404 });
} catch {
return new Response("Internal server error", { status: 500 });
}
}),
});
export default http;