feat(v1/categories): add EmojiCategory type and tests for category endpoints

Author: luxass

src/types.ts

@@ -1,5 +1,5 @@
 import type { z } from "zod";
-import type { ApiErrorSchema, EMOJI_LOCK_SCHEMA, EmojiVersionSchema } from "./schemas";
+import type { ApiErrorSchema, EMOJI_LOCK_SCHEMA, EmojiCategorySchema, EmojiVersionSchema } from "./schemas";
 
 export interface HonoContext {
   Bindings: {
@@ -13,3 +13,4 @@ export type HonoBindings = HonoContext["Bindings"];
 export type ApiError = z.infer<typeof ApiErrorSchema>;
 export type EmojiLock = z.infer<typeof EMOJI_LOCK_SCHEMA>;
 export type EmojiVersion = z.infer<typeof EmojiVersionSchema>;
+export type EmojiCategory = z.infer<typeof EmojiCategorySchema>;

test/routes/v1_categories.test.ts

@@ -0,0 +1,81 @@
+import type { EmojiCategory } from "../../src/types";
+import {
+  createExecutionContext,
+  env,
+  waitOnExecutionContext,
+} from "cloudflare:test";
+import { describe, expect, it } from "vitest";
+import worker from "../../src";
+
+describe("v1_categories", () => {
+  it("should return 404 for non-existent version", async () => {
+    const request = new Request("https://mojis.dev/api/v1/categories/999.0");
+    const ctx = createExecutionContext();
+    const response = await worker.fetch(request, env, ctx);
+    await waitOnExecutionContext(ctx);
+
+    expect(response.status).toBe(404);
+    expect(await response.json()).toEqual({
+      message: "version not found",
+      status: 404,
+      path: "/api/v1/categories/999.0",
+      timestamp: expect.any(String),
+    });
+  });
+
+  it("should redirect /latest to the actual latest version", async () => {
+    const request = new Request("https://mojis.dev/api/v1/categories/latest");
+    const ctx = createExecutionContext();
+    const response = await worker.fetch(request, env, ctx);
+    await waitOnExecutionContext(ctx);
+
+    expect(response.status).toBe(302);
+    expect(response.headers.get("location")).toMatch(/\/api\/v1\/categories\/\d+\.\d+/);
+  });
+
+  it("should return all categories for a valid version", async () => {
+    const request = new Request("https://mojis.dev/api/v1/categories/15.1");
+    const ctx = createExecutionContext();
+    const response = await worker.fetch(request, env, ctx);
+    await waitOnExecutionContext(ctx);
+
+    expect(response.status).toBe(200);
+    const data = await response.json() as EmojiCategory[];
+    expect(Array.isArray(data)).toBe(true);
+    expect(data[0]).toMatchObject({
+      name: expect.any(String),
+      slug: expect.any(String),
+      subgroups: expect.any(Array),
+    });
+  });
+
+  it("should return a specific category", async () => {
+    const request = new Request("https://mojis.dev/api/v1/categories/15.1/smileys-emotion");
+    const ctx = createExecutionContext();
+    const response = await worker.fetch(request, env, ctx);
+    await waitOnExecutionContext(ctx);
+
+    expect(response.status).toBe(200);
+    const data = await response.json();
+    expect(data).toMatchObject({
+      name: expect.any(String),
+      slug: "smileys-emotion",
+      subgroups: expect.any(Array),
+    });
+  });
+
+  it("should handle missing version parameter", async () => {
+    const request = new Request("https://mojis.dev/api/v1/categories/");
+    const ctx = createExecutionContext();
+    const response = await worker.fetch(request, env, ctx);
+    await waitOnExecutionContext(ctx);
+
+    expect(response.status).toBe(404);
+    expect(await response.json()).toEqual({
+      message: "Not found",
+      status: 404,
+      path: "/api/v1/categories/",
+      timestamp: expect.any(String),
+    });
+  });
+});