feat(api): Implement the /api/pages/:project/search/query endpoint

Author: takker99

api/pages/project.ts

@@ -135,5 +135,6 @@ export async function* list(
   }
 }
 
-export * as title from "./project/title.ts";
 export * as replace from "./project/replace.ts";
+export * as search from "./project/search.ts";
+export * as title from "./project/title.ts";

api/pages/project/search.ts

@@ -0,0 +1 @@
+export * as query from "./search/query.ts";

api/pages/project/search/query.ts

@@ -0,0 +1,73 @@
+import type {
+  NotFoundError,
+  NotLoggedInError,
+  NotMemberError,
+  SearchResult,
+} from "@cosense/types/rest";
+import type { ResponseOfEndpoint } from "../../../../targeted_response.ts";
+import { type BaseOptions, setDefaults } from "../../../../util.ts";
+import { cookie } from "../../../../rest/auth.ts";
+
+/** Options for {@linkcode getPage} */
+export interface GetPageOption<R extends Response | undefined>
+  extends BaseOptions<R> {
+  /** use `followRename` */
+  followRename?: boolean;
+
+  /** project ids to get External links */
+  projects?: string[];
+}
+
+/** Constructs a request for the `/api/pages/:project/search/query` endpoint
+ *
+ * @param project The name of the project to search within
+ * @param query The search query string to match against pages
+ * @param options - Additional configuration options
+ * @returns A {@linkcode Request} object for fetching page data
+ */
+export const makeGetRequest = <R extends Response | undefined>(
+  project: string,
+  query: string,
+  options?: BaseOptions<R>,
+): Request => {
+  const { sid, hostName } = setDefaults(options ?? {});
+
+  return new Request(
+    `https://${hostName}/api/pages/${project}/search/query?q=${
+      encodeURIComponent(query)
+    }`,
+    sid ? { headers: { Cookie: cookie(sid) } } : undefined,
+  );
+};
+
+/** Search for pages within a specific project
+ *
+ * @param project The name of the project to search within
+ * @param query The search query string to match against pages
+ * @param options Additional configuration options for the request
+ * @returns A {@linkcode Response} object containing the search results
+ */
+export const get = <R extends Response | undefined = Response>(
+  project: string,
+  query: string,
+  options?: BaseOptions<R>,
+): Promise<
+  ResponseOfEndpoint<{
+    200: SearchResult;
+    404: NotFoundError;
+    401: NotLoggedInError;
+    403: NotMemberError;
+    422: { message: string };
+  }, R>
+> =>
+  setDefaults(options ?? {}).fetch(
+    makeGetRequest(project, query, options),
+  ) as Promise<
+    ResponseOfEndpoint<{
+      200: SearchResult;
+      404: NotFoundError;
+      401: NotLoggedInError;
+      403: NotMemberError;
+      422: { message: string };
+    }, R>
+  >;

deno.jsonc

@@ -24,11 +24,13 @@
     "./unstable-api": "./api.ts",
     "./unstable-api/pages": "./api/pages.ts",
     "./unstable-api/pages/project": "./api/pages/project.ts",
+    "./unstable-api/pages/project/replace": "./api/pages/project/replace.ts",
+    "./unstable-api/pages/project/replace/links": "./api/pages/project/replace/links.ts",
+    "./unstable-api/pages/project/search": "./api/pages/project/search.ts",
+    "./unstable-api/pages/project/search/query": "./api/pages/project/search/query.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/pages/project/replace": "./api/pages/project/replace.ts",
-    "./unstable-api/pages/project/replace/links": "./api/pages/project/replace/links.ts",
     "./unstable-api/users": "./api/users.ts",
     "./unstable-api/users/me": "./api/users/me.ts"
   },