refactor: update version handling and improve category retrieval logic

Author: luxass

src/routes/v1_categories.openapi.ts

@@ -1,29 +1,30 @@
 import { createRoute, z } from "@hono/zod-openapi";
-import { ApiErrorSchema, EmojiVersion } from "../schemas";
+import { ApiErrorSchema, EmojiVersionSchema } from "../schemas";
 
+const VERSION_PATH_PARAMETER = {
+  in: "path" as const,
+  name: "version",
+  required: true,
+  example: "latest",
+  schema: {
+    type: "string" as const,
+  },
+};
 export const ALL_CATEGORIES_ROUTE = createRoute({
   method: "get",
   path: "/",
   tags: ["Categories"],
   parameters: [
-    {
-      in: "path",
-      name: "version",
-      required: true,
-      example: "latest",
-      schema: {
-        type: "string",
-      },
-    },
+    VERSION_PATH_PARAMETER,
   ],
   responses: {
     200: {
       content: {
         "application/json": {
-          schema: z.array(EmojiVersion),
+          schema: z.array(z.object({})),
         },
       },
-      description: "Retrieve a list of all emoji versions available",
+      description: "Retrieve a list of all emoji categories available for the specified version",
     },
     500: {
       content: {
@@ -41,10 +42,12 @@ export const GET_CATEGORY_ROUTE = createRoute({
   path: "/{category}",
   tags: ["Categories"],
   parameters: [
+    VERSION_PATH_PARAMETER,
     {
       in: "path",
-      name: "version",
+      name: "category",
       required: true,
+      example: "smileys",
       schema: {
         type: "string",
       },
@@ -54,10 +57,10 @@ export const GET_CATEGORY_ROUTE = createRoute({
     200: {
       content: {
         "application/json": {
-          schema: z.array(EmojiVersion),
+          schema: z.object({}),
         },
       },
-      description: "Retrieve a list of all emoji versions available",
+      description: "Retrieve the information for the specified emoji category",
     },
     500: {
       content: {

src/routes/v1_categories.ts

@@ -1,6 +1,6 @@
 import type { HonoContext } from "../types";
 import { OpenAPIHono } from "@hono/zod-openapi";
-import { createError } from "../utils";
+import { createError, getAvailableVersions } from "../utils";
 import { ALL_CATEGORIES_ROUTE } from "./v1_categories.openapi";
 
 export const V1_CATEGORIES_ROUTER = new OpenAPIHono<HonoContext>().basePath("/api/v1/categories/:version");
@@ -12,20 +12,28 @@ V1_CATEGORIES_ROUTER.use(async (c, next) => {
     return createError(c, 400, "missing version");
   }
 
-  // const availableVersions = await getAvailableVersions();
+  const availableVersions = await getAvailableVersions();
 
-  // if (!availableVersions.includes(version) && version !== "latest") {
-  //   return createError(c, 400, "invalid version");
-  // }
+  if (version !== "latest" && !availableVersions.some((v) => v.emoji_version === version)) {
+    return createError(c, 404, "version not found");
+  }
 
   await next();
 });
 
 V1_CATEGORIES_ROUTER.openapi(ALL_CATEGORIES_ROUTE, async (c) => {
-  const _version = c.req.param("version");
+  const version = c.req.param("version");
+
+  const res = await fetch(`https://raw.githubusercontent.com/mojisdev/emoji-data/refs/heads/main/data/v${version}/groups.json`);
+
+  if (!res.ok) {
+    return createError(c, 500, "failed to fetch categories");
+  }
+
+  const categories = await res.json();
 
   return c.json(
-    [],
+    categories as [],
     200,
   );
 });