Add images to feeds

Author: maiertech

src/lib/schemas/index.ts

@@ -1,5 +1,6 @@
 export { default as eoApiErrorSchema } from './eo-api-error-schema';
 export { default as eoListSchema } from './eo-list-schema';
 export { default as eoSubscriberSchema } from './eo-subscriber-schema';
+export { default as rssItemSchema } from './rssItemSchema';
 export { default as subscribeFormSchema } from './subscribeFormSchema';
 export { default as unsubscribeFormSchema } from './unsubscribeFormSchema';

src/lib/schemas/rssItemSchema.ts

@@ -0,0 +1,18 @@
+import * as z from 'zod';
+
+export default z.object({
+	title: z.string().min(1),
+	description: z.string().min(1),
+	link: z.url(),
+	language: z.literal('en-US'),
+	pubDate: z.iso.datetime(),
+	/** Generally, there can be multiple categories. But in our case at most one. */
+	category: z.enum(['Post', 'Note']).optional(),
+	enclosure: z
+		.object({
+			url: z.url(),
+			type: z.literal('image/png'),
+			length: z.int().nonnegative().optional()
+		})
+		.optional()
+});

src/lib/types.ts

@@ -1,8 +1,9 @@
-import { subscribeFormSchema } from '$lib/schemas';
+import { subscribeFormSchema, rssItemSchema } from '$lib/schemas';
 import type { EmbedOptions, Project } from '@stackblitz/sdk';
 import type { z } from 'zod';
 
 // Inferred from schemas.
+export type RssItem = z.infer<typeof rssItemSchema>;
 export type SubscribeForm = z.infer<typeof subscribeFormSchema>;
 
 // Other types.

src/lib/utils/escapeXml.ts

@@ -0,0 +1,12 @@
+/**
+ * Escapes special characters for XML content.
+ * This ensures that content is safe to include in XML documents.
+ */
+export function escapeXml(text: string): string {
+	return text
+		.replace(/&/g, '&')
+		.replace(/</g, '&lt;')
+		.replace(/>/g, '&gt;')
+		.replace(/"/g, '&quot;')
+		.replace(/'/g, '&apos;');
+}

src/routes/api/notes/2025/+server.ts

@@ -1,3 +1,4 @@
+import { resolveNote } from '$lib/server/resolvers';
 import noteAmIStillRelevantAsADeveloper from '$notes/(2025)/am-i-still-relevant-as-a-developer/meta';
 import noteEnvVarsInCode from '$notes/(2025)/env-vars-in-vscode/meta';
 import noteHostingInEurope from '$notes/(2025)/hosting-in-europe-beyond-big-tech/meta';
@@ -13,13 +14,21 @@ export const prerender = true;
 
 export const GET: RequestHandler = async () => {
 	// Sort order: latest first.
-	return json([
+	const notes = [
 		notePenpotsMissingSvgTextToPathFeature,
 		notePrerenderingServerRoutes,
 		noteHostingInEurope,
 		noteAmIStillRelevantAsADeveloper,
 		noteTheUmpteenthInterviewWithRichHarris,
 		noteHowToWriteExceptionalDocs,
 		noteEnvVarsInCode
-	]);
+	];
+
+	const resolvedNotes = await Promise.all(
+		notes.map((note) => {
+			return resolveNote(note);
+		})
+	);
+
+	return json(resolvedNotes);
 };

src/routes/api/notes/rss/+server.ts

@@ -0,0 +1,30 @@
+import { PUBLIC_URL_ORIGIN } from '$env/static/public';
+import type { RssItem } from '$lib/types';
+import { escapeXml } from '$lib/utils/escapeXml';
+import type { NoteMeta } from '@maiertech/sveltekit-helpers';
+import { json } from '@sveltejs/kit';
+import type { RequestHandler } from './$types';
+
+export const prerender = true;
+
+export const GET: RequestHandler = async ({ fetch }) => {
+	const response = await fetch('/api/notes/latest');
+	const notes = (await response.json()) as NoteMeta[];
+
+	const rssItems: RssItem[] = notes.map((note) => ({
+		title: escapeXml(note.title),
+		description: escapeXml(note.description),
+		link: `${PUBLIC_URL_ORIGIN}${note.path}`,
+		language: 'en-US',
+		pubDate: new Date(note.publishedDate).toUTCString(),
+		category: 'Note',
+		enclosure: note.ogImageUrl
+			? {
+					url: escapeXml(note.ogImageUrl),
+					type: 'image/png'
+				}
+			: undefined
+	}));
+
+	return json(rssItems);
+};

src/routes/api/posts/2021/+server.ts

@@ -18,11 +18,11 @@ export const GET: RequestHandler = async (event) => {
 		postMoveYourIdeToTheCloud
 	];
 
-	const transformedPosts = await Promise.all(
+	const resolvedPosts = await Promise.all(
 		posts.map((post) => {
 			return resolvePost({ postMeta: post, event });
 		})
 	);
 
-	return json(transformedPosts);
+	return json(resolvedPosts);
 };

src/routes/api/posts/2022/+server.ts

@@ -26,11 +26,11 @@ export const GET: RequestHandler = async (event) => {
 		postSvelteKitHmrOnGitpod
 	];
 
-	const transformedPosts = await Promise.all(
+	const resolvedPosts = await Promise.all(
 		posts.map((post) => {
 			return resolvePost({ postMeta: post, event });
 		})
 	);
 
-	return json(transformedPosts);
+	return json(resolvedPosts);
 };

src/routes/api/posts/2023/+server.ts

@@ -24,11 +24,11 @@ export const GET: RequestHandler = async (event) => {
 		postStackBlitzCodeflowBeta
 	];
 
-	const transformedPosts = await Promise.all(
+	const resolvedPosts = await Promise.all(
 		posts.map((post) => {
 			return resolvePost({ postMeta: post, event });
 		})
 	);
 
-	return json(transformedPosts);
+	return json(resolvedPosts);
 };

src/routes/api/posts/2024/+server.ts

@@ -10,11 +10,11 @@ export const GET: RequestHandler = async (event) => {
 	// Sort order: latest first.
 	const posts = [postCopilotContext];
 
-	const transformedPosts = await Promise.all(
+	const resolvedPosts = await Promise.all(
 		posts.map((post) => {
 			return resolvePost({ postMeta: post, event });
 		})
 	);
 
-	return json(transformedPosts);
+	return json(resolvedPosts);
 };