feat(api): Implement the /api/projects/:project endpoint

Author: takker99

api.ts

@@ -1,2 +1,3 @@
 export * as pages from "./api/pages.ts";
+export * as projects from "./api/projects.ts";
 export * as users from "./api/users.ts";

api/projects.ts

@@ -0,0 +1 @@
+export * as project from "./projects/project.ts";

api/projects/project.ts

@@ -0,0 +1,60 @@
+import type {
+  MemberProject,
+  NotFoundError,
+  NotLoggedInError,
+  NotMemberError,
+  NotMemberProject,
+} from "@cosense/types/rest";
+import type { ResponseOfEndpoint } from "../../targeted_response.ts";
+import { type BaseOptions, setDefaults } from "../../util.ts";
+import { cookie } from "../../rest/auth.ts";
+
+/** Create a request to `GET /api/projects/:project`
+ *
+ * @param project - Project name to retrieve information for
+ * @param options - Additional configuration options
+ * @returns A {@linkcode Request} object for fetching project data
+ */
+export const makeGetRequest = <R extends Response | undefined>(
+  project: string,
+  options?: BaseOptions<R>,
+): Request => {
+  const { sid, hostName } = setDefaults(options ?? {});
+
+  return new Request(
+    `https://${hostName}/api/projects/${project}`,
+    sid ? { headers: { Cookie: cookie(sid) } } : undefined,
+  );
+};
+
+/** Get detailed information about a Scrapbox project
+ *
+ * This function retrieves detailed information about a project, including its
+ * access level, settings, and metadata. The returned data type depends on
+ * whether the user has member access to the project.
+ *
+ * @param project - Project name to retrieve information for
+ * @param options Additional configuration options for the request
+ * @returns A {@linkcode Response} object containing the project data
+ */
+export const get = <R extends Response | undefined = Response>(
+  project: string,
+  options?: BaseOptions<R>,
+): Promise<
+  ResponseOfEndpoint<{
+    200: MemberProject | NotMemberProject;
+    404: NotFoundError;
+    401: NotLoggedInError;
+    403: NotMemberError;
+  }, R>
+> =>
+  setDefaults(options ?? {}).fetch(
+    makeGetRequest(project, options),
+  ) as Promise<
+    ResponseOfEndpoint<{
+      200: MemberProject | NotMemberProject;
+      404: NotFoundError;
+      401: NotLoggedInError;
+      403: NotMemberError;
+    }, R>
+  >;

deno.jsonc

@@ -30,6 +30,8 @@
     "./unstable-api/pages/project/search/query": "./api/pages/project/search/query.ts",
     "./unstable-api/pages/project/search/titles": "./api/pages/project/search/titles.ts",
     "./unstable-api/pages/project/title": "./api/pages/project/title.ts",
+    "./unstable-api/pages/projects": "./api/projects.ts",
+    "./unstable-api/pages/projects/project": "./api/projects/project.ts",
     "./unstable-api/pages/project/title/text": "./api/pages/project/title/text.ts",
     "./unstable-api/pages/project/title/icon": "./api/pages/project/title/icon.ts",
     "./unstable-api/users": "./api/users.ts",