⚡ Project management that doesn't become the project. Boards, Gantt charts, and GitHub integration. Self-host it or use Kaneo Cloud.
TypeScript honoissue-managementissue-trackerjira-alternativekanbanlinear-alternativemcpproject-managementreactself-hostedtypescript
feat(api): add OpenAPI endpoint and documentation handler
Andrej Acevski7123a45da014
diff --git a/apps/api/src/index.ts b/apps/api/src/index.tsindex 5b6e32a56..2d66dcbc4 100644--- a/apps/api/src/index.ts+++ b/apps/api/src/index.ts@@ -4,6 +4,7 @@ import { migrate } from "drizzle-orm/postgres-js/migrator";import { Hono } from "hono";import { cors } from "hono/cors";import { HTTPException } from "hono/http-exception";+import { openAPIRouteHandler } from "hono-openapi";import activity from "./activity";import { auth } from "./auth";import config from "./config";@@ -50,9 +51,6 @@ app.use(}),);-// Separate Hono instance for API routes (will be mounted at /api)-// This allows us to define routes without the /api prefix here,-// while the client in hono.ts knows to connect to /apiconst api = new Hono<{Variables: {user: User | null;@@ -65,25 +63,77 @@ api.get("/health", (c) => {return c.json({ status: "ok" });});-const configRoute = api.route("/config", config);--const githubIntegrationRoute = api.route(+const githubIntegrationApi = api.route("/github-integration",githubIntegration,);-const publicProjectRoute = api.get("/public-project/:id", async (c) => {+api.get("/public-project/:id", async (c) => {const { id } = c.req.param();const project = await getPublicProject(id);return c.json(project);});+const configApi = api.route("/config", config);++api.get(+ "/openapi",+ openAPIRouteHandler(api, {+ documentation: {+ openapi: "3.0.0",+ info: {+ title: "Kaneo API",+ version: "1.0.0",+ description:+ "Kaneo Project Management API - Manage projects, tasks, labels, and more",+ },+ servers: [+ {+ url:+ `${process.env.KANEO_API_URL}/api` || "http://localhost:1337/api",+ description: "Kaneo API Server",+ },+ ],+ components: {+ securitySchemes: {+ bearerAuth: {+ type: "http",+ scheme: "bearer",+ description: "API Key authentication",+ },+ },+ },+ security: [{ bearerAuth: [] }],+ },+ }),+);+api.on(["POST", "GET", "PUT", "DELETE"], "/auth/*", (c) =>auth.handler(c.req.raw),);api.use("*", async (c, next) => {+ const authHeader = c.req.header("Authorization");+ if (authHeader?.startsWith("Bearer ")) {+ const apiKey = authHeader.substring(7);++ try {+ const result = await auth.api.verifyApiKey({+ body: { key: apiKey },+ });++ if (result.valid && result.key) {+ c.set("userId", result.key.userId);+ c.set("user", null);+ c.set("session", null);+ return next();+ }+ } catch (error) {+ console.error("API key verification failed:", error);+ }+ }+const session = await auth.api.getSession({ headers: c.req.raw.headers });c.set("user", session?.user || null);c.set("session", session?.session || null);@@ -96,15 +146,14 @@ api.use("*", async (c, next) => {return next();});-const projectRoute = api.route("/project", project);-const taskRoute = api.route("/task", task);-const activityRoute = api.route("/activity", activity);-const timeEntryRoute = api.route("/time-entry", timeEntry);-const labelRoute = api.route("/label", label);-const notificationRoute = api.route("/notification", notification);-const searchRoute = api.route("/search", search);+const projectApi = api.route("/project", project);+const taskApi = api.route("/task", task);+const activityApi = api.route("/activity", activity);+const timeEntryApi = api.route("/time-entry", timeEntry);+const labelApi = api.route("/label", label);+const notificationApi = api.route("/notification", notification);+const searchApi = api.route("/search", search);-// Mount API routes under /apiapp.route("/api", api);(async () => {@@ -136,15 +185,14 @@ serve();export type AppType =- | typeof projectRoute- | typeof taskRoute- | typeof activityRoute- | typeof timeEntryRoute- | typeof labelRoute- | typeof notificationRoute- | typeof searchRoute- | typeof publicProjectRoute- | typeof githubIntegrationRoute- | typeof configRoute;+ | typeof configApi+ | typeof projectApi+ | typeof taskApi+ | typeof activityApi+ | typeof timeEntryApi+ | typeof labelApi+ | typeof notificationApi+ | typeof searchApi+ | typeof githubIntegrationApi;export default app;