Merge pull request #5 from unicef/app-layer-scaffolding

Add app layer scaffolding: Hono API + React SPA

Author: amoghbanta

.gitignore

@@ -44,3 +44,6 @@ coverage/
 
 # pnpm
 .pnpm-store/
+
+# Local working docs (not tracked)
+.local-docs/

apps/api/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@adt/api",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "tsx watch src/index.ts"
+  },
+  "dependencies": {
+    "@adt/llm": "workspace:*",
+    "@adt/pdf": "workspace:*",
+    "@adt/pipeline": "workspace:*",
+    "@adt/storage": "workspace:*",
+    "@adt/types": "workspace:*",
+    "@hono/node-server": "^1.14.0",
+    "hono": "^4.7.0",
+    "js-yaml": "^4.1.0"
+  }
+}

apps/api/src/.gitkeep

@@ -0,0 +1,22 @@
+import { Hono } from "hono"
+import { cors } from "hono/cors"
+import { logger } from "hono/logger"
+import { errorHandler } from "./middleware/error-handler.js"
+import { healthRoutes } from "./routes/health.js"
+import { bookRoutes } from "./routes/books.js"
+
+const app = new Hono()
+
+app.use("*", logger())
+app.use(
+  "*",
+  cors({
+    origin: "http://localhost:5173",
+  })
+)
+app.onError(errorHandler)
+
+app.route("/api", healthRoutes)
+app.route("/api", bookRoutes)
+
+export default app

apps/api/src/app.ts

@@ -0,0 +1,8 @@
+import { serve } from "@hono/node-server"
+import app from "./app.js"
+
+const port = parseInt(process.env.PORT ?? "3001", 10)
+
+serve({ fetch: app.fetch, port }, (info) => {
+  console.log(`API server running on http://localhost:${info.port}`)
+})

apps/api/src/index.ts

@@ -0,0 +1,10 @@
+import type { ErrorHandler } from "hono"
+import { HTTPException } from "hono/http-exception"
+
+export const errorHandler: ErrorHandler = (err, c) => {
+  if (err instanceof HTTPException) {
+    return c.json({ error: err.message }, err.status)
+  }
+  console.error(err)
+  return c.json({ error: "Internal server error" }, 500)
+}

apps/api/src/middleware/error-handler.ts

@@ -0,0 +1,5 @@
+import { Hono } from "hono"
+
+export const bookRoutes = new Hono()
+
+// Book CRUD routes will be implemented in Increment 2

apps/api/src/routes/books.ts

@@ -0,0 +1,11 @@
+import { describe, it, expect } from "vitest"
+import app from "../app.js"
+
+describe("GET /api/health", () => {
+  it("returns 200 with status ok", async () => {
+    const res = await app.request("/api/health")
+    expect(res.status).toBe(200)
+    const body = await res.json()
+    expect(body).toEqual({ status: "ok" })
+  })
+})

apps/api/src/routes/health.test.ts

@@ -0,0 +1,7 @@
+import { Hono } from "hono"
+
+export const healthRoutes = new Hono()
+
+healthRoutes.get("/health", (c) => {
+  return c.json({ status: "ok" })
+})

apps/api/src/routes/health.ts

@@ -0,0 +1,2 @@
+// Book management service will be implemented in Increment 2
+export {}