refactor: Migrate from NextJs's API routes to Hono based routes for the API (#1432)

* Setup Hono and migrate the highlights API there

* Implement the tags and lists endpoint

* Implement the bookmarks and users endpoints

* Add the trpc error code adapter

* Remove the old nextjs handlers

* fix api key not found handling

* Fix trpc error handling

* Fix 204 handling

* Fix search ordering

* Implement the singlefile endpoint

* Implement the asset serving endpoints

* Implement webauth

* Add hono as a catch all route under api

* fix tests

3 files changed, 0 insertions, 223 deletions

diff --git a/apps/web/app/api/v1/utils/handler.ts b/apps/web/app/api/v1/utils/handler.ts
deleted file mode 100644
index 9154506d..00000000
--- a/apps/web/app/api/v1/utils/handler.ts
+++ /dev/null
@@ -1,170 +0,0 @@
-import { NextRequest } from "next/server";
-import {
-  createContextFromRequest,
-  createTrcpClientFromCtx,
-} from "@/server/api/client";
-import { TRPCError } from "@trpc/server";
-import { z, ZodError } from "zod";
-
-import { Context } from "@karakeep/trpc";
-
-function trpcCodeToHttpCode(code: TRPCError["code"]) {
-  switch (code) {
-    case "BAD_REQUEST":
-    case "PARSE_ERROR":
-      return 400;
-    case "UNAUTHORIZED":
-      return 401;
-    case "FORBIDDEN":
-      return 403;
-    case "NOT_FOUND":
-      return 404;
-    case "METHOD_NOT_SUPPORTED":
-      return 405;
-    case "TIMEOUT":
-      return 408;
-    case "PAYLOAD_TOO_LARGE":
-      return 413;
-    case "INTERNAL_SERVER_ERROR":
-      return 500;
-    default:
-      return 500;
-  }
-}
-
-interface ErrorMessage {
-  path: (string | number)[];
-  message: string;
-}
-
-function formatZodError(error: ZodError): string {
-  if (!error.issues) {
-    return error.message || "An unknown error occurred";
-  }
-
-  const errors: ErrorMessage[] = error.issues.map((issue) => ({
-    path: issue.path,
-    message: issue.message,
-  }));
-
-  const formattedErrors = errors.map((err) => {
-    const path = err.path.join(".");
-    return path ? `${path}: ${err.message}` : err.message;
-  });
-
-  return `${formattedErrors.join(", ")}`;
-}
-
-export interface TrpcAPIRequest<SearchParamsT, BodyType> {
-  ctx: Context;
-  api: ReturnType<typeof createTrcpClientFromCtx>;
-  searchParams: SearchParamsT extends z.ZodTypeAny
-    ? z.infer<SearchParamsT>
-    : undefined;
-  body: BodyType extends z.ZodTypeAny
-    ? z.infer<BodyType> | undefined
-    : undefined;
-}
-
-type SchemaType<T> = T extends z.ZodTypeAny
-  ? z.infer<T> | undefined
-  : undefined;
-
-export async function buildHandler<
-  SearchParamsT extends z.ZodTypeAny | undefined,
-  BodyT extends z.ZodTypeAny | undefined,
-  InputT extends TrpcAPIRequest<SearchParamsT, BodyT>,
->({
-  req,
-  handler,
-  searchParamsSchema,
-  bodySchema,
-}: {
-  req: NextRequest;
-  handler: (req: InputT) => Promise<{ status: number; resp?: object }>;
-  searchParamsSchema?: SearchParamsT | undefined;
-  bodySchema?: BodyT | undefined;
-}) {
-  try {
-    const ctx = await createContextFromRequest(req);
-    const api = createTrcpClientFromCtx(ctx);
-
-    let searchParams: SchemaType<SearchParamsT> | undefined = undefined;
-    if (searchParamsSchema !== undefined) {
-      searchParams = searchParamsSchema.parse(
-        Object.fromEntries(req.nextUrl.searchParams.entries()),
-      ) as SchemaType<SearchParamsT>;
-    }
-
-    let body: SchemaType<BodyT> | undefined = undefined;
-    if (bodySchema) {
-      if (req.headers.get("Content-Type") !== "application/json") {
-        throw new TRPCError({
-          code: "BAD_REQUEST",
-          message: "Content-Type must be application/json",
-        });
-      }
-
-      let bodyJson = undefined;
-      try {
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-        bodyJson = await req.json();
-      } catch (e) {
-        throw new TRPCError({
-          code: "BAD_REQUEST",
-          message: `Invalid JSON: ${(e as Error).message}`,
-        });
-      }
-      body = bodySchema.parse(bodyJson) as SchemaType<BodyT>;
-    }
-
-    const { status, resp } = await handler({
-      ctx,
-      api,
-      searchParams,
-      body,
-    } as InputT);
-
-    return new Response(resp ? JSON.stringify(resp) : null, {
-      status,
-      headers: {
-        "Content-Type": "application/json",
-      },
-    });
-  } catch (e) {
-    if (e instanceof ZodError) {
-      return new Response(
-        JSON.stringify({ code: "ParseError", message: formatZodError(e) }),
-        {
-          status: 400,
-          headers: {
-            "Content-Type": "application/json",
-          },
-        },
-      );
-    }
-    if (e instanceof TRPCError) {
-      let message = e.message;
-      if (e.cause instanceof ZodError) {
-        message = formatZodError(e.cause);
-      }
-      return new Response(JSON.stringify({ code: e.code, error: message }), {
-        status: trpcCodeToHttpCode(e.code),
-        headers: {
-          "Content-Type": "application/json",
-        },
-      });
-    } else {
-      const error = e as Error;
-      console.error(
-        `Unexpected error in: ${req.method} ${req.nextUrl.pathname}:\n${error.stack}`,
-      );
-      return new Response(JSON.stringify({ code: "UnknownError" }), {
-        status: 500,
-        headers: {
-          "Content-Type": "application/json",
-        },
-      });
-    }
-  }
-}
diff --git a/apps/web/app/api/v1/utils/pagination.ts b/apps/web/app/api/v1/utils/pagination.ts
deleted file mode 100644
index 12a0b950..00000000
--- a/apps/web/app/api/v1/utils/pagination.ts
+++ /dev/null
@@ -1,30 +0,0 @@
-import { z } from "zod";
-
-import { MAX_NUM_BOOKMARKS_PER_PAGE } from "@karakeep/shared/types/bookmarks";
-import { zCursorV2 } from "@karakeep/shared/types/pagination";
-
-export const zPagination = z.object({
-  limit: z.coerce.number().max(MAX_NUM_BOOKMARKS_PER_PAGE).optional(),
-  cursor: z
-    .string()
-    .refine((val) => val.includes("_"), "Must be a valid cursor")
-    .transform((val) => {
-      const [id, createdAt] = val.split("_");
-      return { id, createdAt };
-    })
-    .pipe(z.object({ id: z.string(), createdAt: z.coerce.date() }))
-    .optional(),
-});
-
-export function adaptPagination<
-  T extends { nextCursor: z.infer<typeof zCursorV2> | null },
->(input: T) {
-  const { nextCursor, ...rest } = input;
-  if (!nextCursor) {
-    return input;
-  }
-  return {
-    ...rest,
-    nextCursor: `${nextCursor.id}_${nextCursor.createdAt.toISOString()}`,
-  };
-}
diff --git a/apps/web/app/api/v1/utils/types.ts b/apps/web/app/api/v1/utils/types.ts
deleted file mode 100644
index bf181ce4..00000000
--- a/apps/web/app/api/v1/utils/types.ts
+++ /dev/null
@@ -1,23 +0,0 @@
-import { z } from "zod";
-
-import { zSortOrder } from "@karakeep/shared/types/bookmarks";
-
-export const zStringBool = z
-  .string()
-  .refine((val) => val === "true" || val === "false", "Must be true or false")
-  .transform((val) => val === "true");
-
-export const zGetBookmarkQueryParamsSchema = z.object({
-  sortOrder: zSortOrder
-    .exclude([zSortOrder.Enum.relevance])
-    .optional()
-    .default(zSortOrder.Enum.desc),
-  // TODO: Change the default to false in a couple of releases.
-  includeContent: zStringBool.optional().default("true"),
-});
-
-export const zGetBookmarkSearchParamsSchema = z.object({
-  sortOrder: zSortOrder.optional().default(zSortOrder.Enum.relevance),
-  // TODO: Change the default to false in a couple of releases.
-  includeContent: zStringBool.optional().default("true"),
-});