feat(api): Implement the /api/pages/:project/:title/icon endpoint

Author: takker99

api/pages/project/title.ts

@@ -82,3 +82,4 @@ export const get = <R extends Response | undefined = Response>(
   >;
 
 export * as text from "./title/text.ts";
+export * as icon from "./title/icon.ts";

api/pages/project/title/icon.ts

@@ -0,0 +1,68 @@
+import type {
+  NotFoundError,
+  NotLoggedInError,
+  NotMemberError,
+} from "@cosense/types/rest";
+import type { ResponseOfEndpoint } from "../../../../targeted_response.ts";
+import { type BaseOptions, setDefaults } from "../../../../util.ts";
+import { encodeTitleURI } from "../../../../title.ts";
+import { cookie } from "../../../../rest/auth.ts";
+
+/** Options for {@linkcode get} */
+export interface GetIconOption<R extends Response | undefined>
+  extends BaseOptions<R> {
+  /** use `followRename` */
+  followRename?: boolean;
+}
+
+/** Constructs a request for the `/api/pages/:project/:title/icon` endpoint
+ *
+ * @param project The project name containing the desired page
+ * @param title The page title to retrieve (case insensitive)
+ * @param options - Additional configuration options
+ * @returns A {@linkcode Request} object for fetching page data
+ */
+export const makeGetRequest = <R extends Response | undefined>(
+  project: string,
+  title: string,
+  options?: GetIconOption<R>,
+): Request => {
+  const { sid, hostName, followRename } = setDefaults(options ?? {});
+
+  return new Request(
+    `https://${hostName}/api/pages/${project}/${
+      encodeTitleURI(title)
+    }/icon?followRename=${followRename ?? true}`,
+    sid ? { headers: { Cookie: cookie(sid) } } : undefined,
+  );
+};
+
+/** Retrieves a specified page image
+ *
+ * @param project The project name containing the desired page
+ * @param title The page title to retrieve (case insensitive)
+ * @param options Additional configuration options for the request
+ * @returns A {@linkcode Response} object containing the page image
+ */
+export const get = <R extends Response | undefined = Response>(
+  project: string,
+  title: string,
+  options?: GetIconOption<R>,
+): Promise<
+  ResponseOfEndpoint<{
+    200: Blob;
+    404: NotFoundError;
+    401: NotLoggedInError;
+    403: NotMemberError;
+  }, R>
+> =>
+  setDefaults(options ?? {}).fetch(
+    makeGetRequest(project, title, options),
+  ) as Promise<
+    ResponseOfEndpoint<{
+      200: Blob;
+      404: NotFoundError;
+      401: NotLoggedInError;
+      403: NotMemberError;
+    }, R>
+  >;

deno.jsonc

@@ -26,6 +26,7 @@
     "./unstable-api/pages/project": "./api/pages/project.ts",
     "./unstable-api/pages/project/title": "./api/pages/project/title.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",
     "./unstable-api/users/me": "./api/users/me.ts"
   },