feat(backend): Route API endpoints

Under the `/api`, data can be got by several ways.

.github/README.md

@@ -1,16 +1,11 @@
 # online-2024-e
 
-```sh
-# For development
-deno task dev
-```
+## Backend
 
-```sh
-# For production
-deno task start
-```
+You can import the API entrypoints and the cocktail type with the following code:
 
-```sh
-# For test
-deno task test
+```ts
+import type { API, Cocktail } from "/backend/src/api/mod.ts";
 ```
+
+For more information, see [the Hono RPC documentation](https://hono.dev/docs/guides/rpc#client).

backend/client.http

@@ -0,0 +1,23 @@
+###
+
+GET http://localhost:8000
+
+###
+
+GET http://localhost:8000/api
+
+###
+
+GET http://localhost:8000/api/get?name=アイリッシュコーヒー
+
+###
+
+GET http://localhost:8000/api/get?name=none
+
+###
+
+GET http://localhost:8000/api/get
+
+###
+
+GET http://localhost:8000/api/all

backend/src/api/mod.test.ts

@@ -0,0 +1,47 @@
+import { assertEquals, assertExists } from "@std/assert";
+import { STATUS_CODE } from "@std/http/status";
+
+import { app } from "./mod.ts";
+
+Deno.test("API", async (t: Deno.TestContext) => {
+  await t.step("GET /", async () => {
+    const res: Response = await app.request("/");
+
+    assertEquals(await res.text(), "Cocktail API");
+    assertEquals(res.status, STATUS_CODE.OK);
+  });
+
+  await t.step("GET /get", async () => {
+    const res: Response = await app.request("/get");
+
+    assertEquals(await res.json(), {
+      success: false,
+      message: "The name query is required",
+    });
+    assertEquals(res.status, STATUS_CODE.BadRequest);
+  });
+
+  await t.step("GET /get?name=none", async () => {
+    const res: Response = await app.request("/get?name=none");
+
+    assertEquals(await res.json(), {
+      success: false,
+      message: 'The cocktail, "none" not found',
+    });
+    assertEquals(res.status, STATUS_CODE.NotFound);
+  });
+
+  await t.step("GET /get?name=アイリッシュコーヒー", async () => {
+    const res: Response = await app.request("/get?name=アイリッシュコーヒー");
+
+    assertExists(await res.json());
+    assertEquals(res.status, STATUS_CODE.OK);
+  });
+
+  await t.step("/all", async () => {
+    const res: Response = await app.request("/all");
+
+    assertExists(await res.json());
+    assertEquals(res.status, STATUS_CODE.OK);
+  });
+});

backend/src/api/mod.ts

@@ -0,0 +1,59 @@
+import { type Context, Hono } from "@hono/hono";
+export type { Hono };
+import { STATUS_CODE } from "@std/http/status";
+
+import { Cocktail } from "./utils/types.ts";
+export { Cocktail };
+import { cocktails } from "./utils/data.ts";
+
+/**
+ * The cocktail API
+ *
+ * @example Return a response
+ * ```ts
+ * const res: Response = await api.request("/");
+ * ```
+ * @example Return the requested cocktail detail
+ * ```ts
+ * const res: Response = await api.request("/get?name=アイリッシュコーヒー");
+ * ```
+ * @example Return an array of all cocktails
+ * ```ts
+ * const res: Response = await api.request("/all");
+ * ```
+ */
+export const app: Hono = new Hono();
+
+/**
+ * The cocktail API type
+ *
+ * @example
+ * ```ts
+ * const client = hc<API>("/");
+ * ```
+ */
+export type API = typeof route;
+
+/**
+ * The cocktail API route
+ */
+export const route: Hono = app
+  .get("/", (ctx: Context) => ctx.text("Cocktail API"))
+  .get("/get", (ctx: Context) => {
+    const name: string | undefined = ctx.req.query("name");
+    if (!name) {
+      return ctx.json(
+        { success: false, message: "The name query is required" },
+        STATUS_CODE.BadRequest,
+      );
+    }
+
+    const cocktail: Cocktail | undefined = cocktails.find((c: Cocktail) =>
+      c.name === name
+    );
+    return cocktail ? ctx.json({ success: true, data: cocktail }) : ctx.json(
+      { success: false, message: `The cocktail, "${name}" not found` },
+      STATUS_CODE.NotFound,
+    );
+  })
+  .get("/all", (ctx: Context) => ctx.json(cocktails));

backend/src/server.ts

@@ -2,6 +2,8 @@ import { type Context, Hono } from "@hono/hono";
 export type { Hono };
 import { logger } from "@hono/hono/logger";
 
+import { app as api } from "./api/mod.ts";
+
 /**
  * The Hono application for this project.
  *
@@ -13,6 +15,7 @@ import { logger } from "@hono/hono/logger";
 export const app: Hono = new Hono();
 app.use(logger());
 app
-  .get("/", (ctx: Context) => ctx.text("Hello, World!"));
+  .get("/", (ctx: Context) => ctx.text("Hello, World!"))
+  .route("/api", api);
 
 Deno.serve(app.fetch);