refactor(api): extract createSchemaRoute factory for schema endpoints

Addresses CodeRabbit's suggestion on PR #180 to de-duplicate the
identical route/response-wrapper boilerplate across schema-post.ts,
schema-collection.ts, and schema-author.ts.

Author: bbornino

apps/api/src/routes/content/createSchemaRoute.ts

@@ -0,0 +1,42 @@
+import type { FastifyPluginAsync } from "fastify";
+import { Type, type TSchema } from "typebox";
+
+export const createSchemaRoute = (
+	path: string,
+	description: string,
+	schema: TSchema,
+): FastifyPluginAsync => {
+	const responseSchema = Type.Object(
+		{},
+		{
+			additionalProperties: true,
+			description,
+			examples: [schema],
+		},
+	);
+
+	return async (fastify) => {
+		fastify.get(
+			path,
+			{
+				schema: {
+					description,
+					response: {
+						200: {
+							description: "Successful",
+							content: {
+								"application/json": {
+									schema: responseSchema,
+								},
+							},
+						},
+					},
+				},
+			},
+			async (_request, reply) => {
+				reply.code(200);
+				reply.send(schema);
+			},
+		);
+	};
+};

apps/api/src/routes/content/schema-author.ts

@@ -1,40 +1,10 @@
-import type { FastifyPluginAsync } from "fastify";
-import { Type } from "typebox";
 import { AuthorMetaSchema } from "../../../../worker/src/tasks/sync-author/types.ts";
+import { createSchemaRoute } from "./createSchemaRoute.ts";
 
-const SchemaAuthorResponseSchema = Type.Object(
-	{},
-	{
-		additionalProperties: true,
-		description: "A JSON Schema document describing valid author frontmatter.",
-		examples: [AuthorMetaSchema],
-	},
+const schemaAuthorRoutes = createSchemaRoute(
+	"/content/schema/author",
+	"Fetch the JSON Schema for author frontmatter, as validated by the sync worker.",
+	AuthorMetaSchema,
 );
 
-const schemaAuthorRoutes: FastifyPluginAsync = async (fastify) => {
-	fastify.get(
-		"/content/schema/author",
-		{
-			schema: {
-				description:
-					"Fetch the JSON Schema for author frontmatter, as validated by the sync worker.",
-				response: {
-					200: {
-						description: "Successful",
-						content: {
-							"application/json": {
-								schema: SchemaAuthorResponseSchema,
-							},
-						},
-					},
-				},
-			},
-		},
-		async (_request, reply) => {
-			reply.code(200);
-			reply.send(AuthorMetaSchema);
-		},
-	);
-};
-
 export default schemaAuthorRoutes;

apps/api/src/routes/content/schema-collection.ts

@@ -1,41 +1,10 @@
-import type { FastifyPluginAsync } from "fastify";
-import { Type } from "typebox";
 import { CollectionMetaSchema } from "../../../../worker/src/tasks/sync-collection/types.ts";
+import { createSchemaRoute } from "./createSchemaRoute.ts";
 
-const SchemaCollectionResponseSchema = Type.Object(
-	{},
-	{
-		additionalProperties: true,
-		description:
-			"A JSON Schema document describing valid collection frontmatter.",
-		examples: [CollectionMetaSchema],
-	},
+const schemaCollectionRoutes = createSchemaRoute(
+	"/content/schema/collection",
+	"Fetch the JSON Schema for collection frontmatter, as validated by the sync worker.",
+	CollectionMetaSchema,
 );
 
-const schemaCollectionRoutes: FastifyPluginAsync = async (fastify) => {
-	fastify.get(
-		"/content/schema/collection",
-		{
-			schema: {
-				description:
-					"Fetch the JSON Schema for collection frontmatter, as validated by the sync worker.",
-				response: {
-					200: {
-						description: "Successful",
-						content: {
-							"application/json": {
-								schema: SchemaCollectionResponseSchema,
-							},
-						},
-					},
-				},
-			},
-		},
-		async (_request, reply) => {
-			reply.code(200);
-			reply.send(CollectionMetaSchema);
-		},
-	);
-};
-
 export default schemaCollectionRoutes;

apps/api/src/routes/content/schema-post.ts

@@ -1,40 +1,10 @@
-import type { FastifyPluginAsync } from "fastify";
-import { Type } from "typebox";
 import { PostMetaSchema } from "../../../../worker/src/tasks/sync-post/types.ts";
+import { createSchemaRoute } from "./createSchemaRoute.ts";
 
-const SchemaPostResponseSchema = Type.Object(
-	{},
-	{
-		additionalProperties: true,
-		description: "A JSON Schema document describing valid post frontmatter.",
-		examples: [PostMetaSchema],
-	},
+const schemaPostRoutes = createSchemaRoute(
+	"/content/schema/post",
+	"Fetch the JSON Schema for post frontmatter, as validated by the sync worker.",
+	PostMetaSchema,
 );
 
-const schemaPostRoutes: FastifyPluginAsync = async (fastify) => {
-	fastify.get(
-		"/content/schema/post",
-		{
-			schema: {
-				description:
-					"Fetch the JSON Schema for post frontmatter, as validated by the sync worker.",
-				response: {
-					200: {
-						description: "Successful",
-						content: {
-							"application/json": {
-								schema: SchemaPostResponseSchema,
-							},
-						},
-					},
-				},
-			},
-		},
-		async (_request, reply) => {
-			reply.code(200);
-			reply.send(PostMetaSchema);
-		},
-	);
-};
-
 export default schemaPostRoutes;