Merge branch 'main' into copilot/fix-6ec0a2ff-f2ad-42c5-b65e-98e76f6953de

Author: takker99

.github/workflows/ci.yml

@@ -9,10 +9,13 @@ on: [push, pull_request]
 jobs:
   test:
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
     steps:
       - uses: actions/checkout@v4
       - uses: denoland/setup-deno@v2
         with:
           deno-version: ${{ env.DENO_VERSION }}
+          cache: true
       - name: Check fmt & lint & type check & test
         run: deno task check

.github/workflows/publish.yml

@@ -23,9 +23,10 @@ jobs:
       - uses: denoland/setup-deno@v2
         with:
           deno-version: ${{ env.DENO_VERSION }}
+          cache: true
       - name: Publish to JSR
         run: deno run --allow-env --allow-run=deno --allow-read --allow-write=deno.jsonc jsr:@david/[email protected]
-  
+
   publish-npm:
     runs-on: ubuntu-latest
     steps:

.github/workflows/udd.yml

@@ -21,5 +21,6 @@ jobs:
       - uses: denoland/setup-deno@v2
         with:
           deno-version: ${{ env.DENO_VERSION }}
+          cache: true
       - name: Update
         run: deno task update

api.ts

@@ -1,50 +1,6 @@
-export * as pages from "./api/pages.ts";
-export * as projects from "./api/projects.ts";
-export * as users from "./api/users.ts";
+export * from "./api/pages.ts";
+export * from "./api/projects.ts";
+export * from "./api/users.ts";
+export * from "./api/smart-context.ts";
 export type { HTTPError, TypedError } from "./error.ts";
 export type { BaseOptions, ExtendedOptions, OAuthOptions } from "./util.ts";
-
-export {
-  get as listPages,
-  list as listPagesStream,
-  type ListPagesOption,
-  type ListPagesStreamOption,
-  makeGetRequest as makeListPagesRequest,
-} from "./api/pages/project.ts";
-export {
-  makePostRequest as makeReplaceLinksRequest,
-  post as replaceLinks,
-} from "./api/pages/project/replace/links.ts";
-export {
-  get as searchForPages,
-  makeGetRequest as makeSearchForPagesRequest,
-} from "./api/pages/project/search/query.ts";
-export {
-  get as getLinks,
-  type GetLinksOptions,
-  list as readLinks,
-  makeGetRequest as makeGetLinksRequest,
-} from "./api/pages/project/search/titles.ts";
-export {
-  get as getPage,
-  type GetPageOption,
-  makeGetRequest as makeGetPageRequest,
-} from "./api/pages/project/title.ts";
-export {
-  get as getText,
-  type GetTextOption,
-  makeGetRequest as makeGetTextRequest,
-} from "./api/pages/project/title/text.ts";
-export {
-  get as getIcon,
-  type GetIconOption,
-  makeGetRequest as makeGetIconRequest,
-} from "./api/pages/project/title/icon.ts";
-export {
-  get as getProject,
-  makeGetRequest as makeGetProjectRequest,
-} from "./api/projects/project.ts";
-export {
-  get as getUser,
-  makeGetRequest as makeGetUserRequest,
-} from "./api/users/me.ts";

api/pages.ts

@@ -1 +1 @@
-export * as project from "./pages/project.ts";
+export * from "./pages/project.ts";

api/pages/project.ts

@@ -21,7 +21,7 @@ import { pooledMap } from "@std/async/pool";
 import { range } from "@core/iterutil/range";
 import { flatten } from "@core/iterutil/async/flatten";
 
-/** Options for {@linkcode get}
+/** Options for {@linkcode listPages}
  *
  * @experimental **UNSTABLE**: New API, yet to be vetted.
  */
@@ -102,7 +102,7 @@ export const makeGetRequest = <R extends Response | undefined>(
  *            - {@linkcode NotLoggedInError}: Authentication required
  *            - {@linkcode NotMemberError}: User lacks access
  */
-export const get = <R extends Response | undefined = Response>(
+export const listPages = <R extends Response | undefined = Response>(
   project: string,
   options?: ListPagesOption<R>,
 ): Promise<
@@ -125,7 +125,7 @@ export const get = <R extends Response | undefined = Response>(
   >;
 
 /**
- * Options for {@linkcode list}
+ * Options for {@linkcode listPagesStream}
  *
  * @experimental **UNSTABLE**: New API, yet to be vetted.
  */
@@ -147,7 +147,7 @@ export interface ListPagesStreamOption<R extends Response | undefined>
  * @param options Configuration options for pagination and sorting
  * @throws {HTTPError | TypedError<"NotLoggedInError" | "NotMemberError" | "NotFoundError">} If any requests in the pagination sequence fail
  */
-export async function* list(
+export async function* listPagesStream(
   project: string,
   options?: ListPagesStreamOption<Response>,
 ): AsyncGenerator<BasePage, void, unknown> {
@@ -156,7 +156,7 @@ export async function* list(
     skip: options?.skip ?? 0,
     limit: options?.limit ?? 100,
   };
-  const response = await ensureResponse(await get(project, props));
+  const response = await ensureResponse(await listPages(project, props));
   const list = await response.json();
   yield* list.pages;
 
@@ -170,7 +170,7 @@ export async function* list(
       range(0, times - 1),
       async (i) => {
         const response = await ensureResponse(
-          await get(project, { ...props, skip: skip + i * limit, limit }),
+          await listPages(project, { ...props, skip: skip + i * limit, limit }),
         );
         const list = await response.json();
         return list.pages;
@@ -203,6 +203,6 @@ const ensureResponse = async (
   }
 };
 
-export * as replace from "./project/replace.ts";
-export * as search from "./project/search.ts";
-export * as title from "./project/title.ts";
+export * from "./project/replace.ts";
+export * from "./project/search.ts";
+export * from "./project/title.ts";

api/pages/project/replace.ts

@@ -1 +1 @@
-export * as links from "./replace/links.ts";
+export * from "./replace/links.ts";

api/pages/project/replace/links.ts

@@ -6,7 +6,7 @@ import type {
 import type { ResponseOfEndpoint } from "../../../../targeted_response.ts";
 import { type ExtendedOptions, setDefaults } from "../../../../util.ts";
 import { cookie } from "../../../../rest/auth.ts";
-import { get } from "../../../users/me.ts";
+import { getUser } from "../../../users/me.ts";
 
 /** Constructs a request for the `/api/pages/:project/replace/links` endpoint
  *
@@ -18,7 +18,7 @@ import { get } from "../../../users/me.ts";
  * @param init - Additional configuration options
  * @returns A {@linkcode Request} object for replacing links in `project`
  */
-export const makePostRequest = <R extends Response | undefined>(
+export const makeReplaceLinksRequest = <R extends Response | undefined>(
   project: string,
   from: string,
   to: string,
@@ -55,7 +55,7 @@ export const makePostRequest = <R extends Response | undefined>(
  *            - {@linkcode NotLoggedInError}: Authentication required
  *            - {@linkcode NotMemberError}: User lacks access
  */
-export const post = async <R extends Response | undefined = Response>(
+export const replaceLinks = async <R extends Response | undefined = Response>(
   project: string,
   from: string,
   to: string,
@@ -71,13 +71,13 @@ export const post = async <R extends Response | undefined = Response>(
   let { csrf, fetch, ...init2 } = setDefaults(init ?? {});
 
   if (!csrf) {
-    const res = await get(init2);
+    const res = await getUser(init2);
     if (!res.ok) return res;
     csrf = (await res.json()).csrfToken;
   }
 
   return fetch(
-    makePostRequest(project, from, to, { csrf, ...init2 }),
+    makeReplaceLinksRequest(project, from, to, { csrf, ...init2 }),
   ) as Promise<
     ResponseOfEndpoint<{
       200: string;

api/pages/project/search.ts

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

api/pages/project/search/query.ts

@@ -17,7 +17,7 @@ import { cookie } from "../../../../rest/auth.ts";
  * @param options - Additional configuration options
  * @returns A {@linkcode Request} object for fetching page data
  */
-export const makeGetRequest = <R extends Response | undefined>(
+export const makeSearchForPagesRequest = <R extends Response | undefined>(
   project: string,
   query: string,
   options?: BaseOptions<R>,
@@ -41,7 +41,7 @@ export const makeGetRequest = <R extends Response | undefined>(
  * @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>(
+export const searchForPages = <R extends Response | undefined = Response>(
   project: string,
   query: string,
   options?: BaseOptions<R>,
@@ -55,7 +55,7 @@ export const get = <R extends Response | undefined = Response>(
   }, R>
 > =>
   setDefaults(options ?? {}).fetch(
-    makeGetRequest(project, query, options),
+    makeSearchForPagesRequest(project, query, options),
   ) as Promise<
     ResponseOfEndpoint<{
       200: SearchResult;