feat: expose new versions supported endpoint

Author: luxass

src/index.ts

@@ -1,7 +1,7 @@
 import type { ApiError, HonoEnv } from "./types";
 import { OpenAPIHono } from "@hono/zod-openapi";
 import { getAllEmojiVersions } from "@mojis/internal-utils/versions";
-import { apiReference } from "@scalar/hono-api-reference";
+import { Scalar } from "@scalar/hono-api-reference";
 import { env } from "hono/adapter";
 import { HTTPException } from "hono/http-exception";
 import { buildOpenApiConfig } from "./openapi";
@@ -18,10 +18,9 @@ app.route("/", V1_CATEGORIES_ROUTER);
 app.route("/", GATEWAY_GITHUB_ROUTER);
 app.route("/", DATA_SCHEMAS_ROUTER);
 app.route("/", RANDOM_EMOJI_ROUTER);
-
 app.get(
   "/scalar",
-  apiReference({
+  Scalar({
     url: "/openapi.json",
     layout: "classic",
     customCss: /* css */`

src/routes/v1_versions.openapi.ts

@@ -100,3 +100,28 @@ export const DRAFT_EMOJI_VERSIONS_ROUTE = createRoute({
     },
   },
 });
+
+export const SUPPORTED_VERSIONS_ROUTE = createRoute({
+  method: "get",
+  path: "/supported",
+  tags: ["Versions"],
+  description: "Retrieve a list of emoji versions that is supported by @mojis",
+  responses: {
+    200: {
+      content: {
+        "application/json": {
+          schema: z.array(z.string()).openapi("SupportedVersions"),
+        },
+      },
+      description: "Retrieve a list of emoji versions that is supported by @mojis",
+    },
+    500: {
+      content: {
+        "application/json": {
+          schema: ApiErrorSchema,
+        },
+      },
+      description: "Internal Server Error",
+    },
+  },
+});

src/routes/v1_versions.ts

@@ -1,8 +1,9 @@
 import type { HonoEnv } from "../types";
 import { OpenAPIHono } from "@hono/zod-openapi";
+import { OFFICIAL_SUPPORTED_VERSIONS } from "@mojis/internal-utils/constants";
 import { cache } from "../middlewares/cache";
 import { createError, getAvailableVersions } from "../utils";
-import { ALL_EMOJI_VERSIONS_ROUTE, DRAFT_EMOJI_VERSIONS_ROUTE, LATEST_EMOJI_VERSIONS_ROUTE } from "./v1_versions.openapi";
+import { ALL_EMOJI_VERSIONS_ROUTE, DRAFT_EMOJI_VERSIONS_ROUTE, LATEST_EMOJI_VERSIONS_ROUTE, SUPPORTED_VERSIONS_ROUTE } from "./v1_versions.openapi";
 
 export const V1_VERSIONS_ROUTER = new OpenAPIHono<HonoEnv>().basePath("/api/v1/versions");
 
@@ -60,3 +61,7 @@ V1_VERSIONS_ROUTER.openapi(DRAFT_EMOJI_VERSIONS_ROUTE, async (c) => {
     return createError(c, 500, "failed to fetch emoji data");
   }
 });
+
+V1_VERSIONS_ROUTER.openapi(SUPPORTED_VERSIONS_ROUTE, (c) => {
+  return c.json(OFFICIAL_SUPPORTED_VERSIONS, 200);
+});