feat(api): Use baseURL instead of hostName

following the style of `jsr:@openai/openai`

Author: takker99

api/pages/project.ts

@@ -53,7 +53,7 @@ export const makeGetRequest = <R extends Response | undefined>(
   project: string,
   options?: ListPagesOption<R>,
 ): Request => {
-  const { sid, hostName, sort, limit, skip } = setDefaults(
+  const { sid, baseURL, sort, limit, skip } = setDefaults(
     options ?? {},
   );
   const params = new URLSearchParams();
@@ -62,7 +62,7 @@ export const makeGetRequest = <R extends Response | undefined>(
   if (skip !== undefined) params.append("skip", `${skip}`);
 
   return new Request(
-    `https://${hostName}/api/pages/${project}?${params}`,
+    `${baseURL}api/pages/${project}?${params}`,
     sid ? { headers: { Cookie: cookie(sid) } } : undefined,
   );
 };

api/pages/project/replace/links.ts

@@ -22,10 +22,10 @@ export const makePostRequest = <R extends Response | undefined>(
   to: string,
   init?: ExtendedOptions<R>,
 ): Request => {
-  const { sid, hostName, csrf } = setDefaults(init ?? {});
+  const { sid, baseURL, csrf } = setDefaults(init ?? {});
 
   return new Request(
-    `https://${hostName}/api/pages/${project}/replace/links`,
+    `${baseURL}api/pages/${project}/replace/links`,
     {
       method: "POST",
       headers: {

api/pages/project/search/query.ts

@@ -20,10 +20,10 @@ export const makeGetRequest = <R extends Response | undefined>(
   query: string,
   options?: BaseOptions<R>,
 ): Request => {
-  const { sid, hostName } = setDefaults(options ?? {});
+  const { sid, baseURL } = setDefaults(options ?? {});
 
   return new Request(
-    `https://${hostName}/api/pages/${project}/search/query?q=${
+    `${baseURL}api/pages/${project}/search/query?q=${
       encodeURIComponent(query)
     }`,
     sid ? { headers: { Cookie: cookie(sid) } } : undefined,

api/pages/project/search/titles.ts

@@ -31,10 +31,10 @@ export const makeGetRequest = <R extends Response | undefined>(
   project: string,
   options?: GetLinksOptions<R>,
 ): Request => {
-  const { sid, hostName, followingId } = setDefaults(options ?? {});
+  const { sid, baseURL, followingId } = setDefaults(options ?? {});
 
   return new Request(
-    `https://${hostName}/api/pages/${project}/search/titles${
+    `${baseURL}api/pages/${project}/search/titles${
       followingId ? `?followingId=${followingId}` : ""
     }`,
     sid ? { headers: { Cookie: cookie(sid) } } : undefined,

api/pages/project/title.ts

@@ -31,17 +31,15 @@ export const makeGetRequest = <R extends Response | undefined>(
   title: string,
   options?: GetPageOption<R>,
 ): Request => {
-  const { sid, hostName, followRename, projects } = setDefaults(options ?? {});
+  const { sid, baseURL, followRename, projects } = setDefaults(options ?? {});
 
   const params = new URLSearchParams([
     ["followRename", `${followRename ?? true}`],
     ...(projects?.map?.((id) => ["projects", id]) ?? []),
   ]);
 
   return new Request(
-    `https://${hostName}/api/pages/${project}/${
-      encodeTitleURI(title)
-    }?${params}`,
+    `${baseURL}api/pages/${project}/${encodeTitleURI(title)}?${params}`,
     sid ? { headers: { Cookie: cookie(sid) } } : undefined,
   );
 };

api/pages/project/title/icon.ts

@@ -27,10 +27,10 @@ export const makeGetRequest = <R extends Response | undefined>(
   title: string,
   options?: GetIconOption<R>,
 ): Request => {
-  const { sid, hostName, followRename } = setDefaults(options ?? {});
+  const { sid, baseURL, followRename } = setDefaults(options ?? {});
 
   return new Request(
-    `https://${hostName}/api/pages/${project}/${
+    `${baseURL}api/pages/${project}/${
       encodeTitleURI(title)
     }/icon?followRename=${followRename ?? true}`,
     sid ? { headers: { Cookie: cookie(sid) } } : undefined,

api/pages/project/title/text.ts

@@ -27,10 +27,10 @@ export const makeGetRequest = <R extends Response | undefined>(
   title: string,
   options?: GetTextOption<R>,
 ): Request => {
-  const { sid, hostName, followRename } = setDefaults(options ?? {});
+  const { sid, baseURL, followRename } = setDefaults(options ?? {});
 
   return new Request(
-    `https://${hostName}/api/pages/${project}/${
+    `${baseURL}api/pages/${project}/${
       encodeTitleURI(title)
     }/text?followRename=${followRename ?? true}`,
     sid ? { headers: { Cookie: cookie(sid) } } : undefined,

api/projects/project.ts

@@ -19,10 +19,10 @@ export const makeGetRequest = <R extends Response | undefined>(
   project: string,
   options?: BaseOptions<R>,
 ): Request => {
-  const { sid, hostName } = setDefaults(options ?? {});
+  const { sid, baseURL } = setDefaults(options ?? {});
 
   return new Request(
-    `https://${hostName}/api/projects/${project}`,
+    `${baseURL}api/projects/${project}`,
     sid ? { headers: { Cookie: cookie(sid) } } : undefined,
   );
 };

api/users/me.ts

@@ -14,9 +14,9 @@ import { cookie } from "../../rest/auth.ts";
 export const makeGetRequest = <R extends Response | undefined>(
   init?: BaseOptions<R>,
 ): Request => {
-  const { sid, hostName } = setDefaults(init ?? {});
+  const { sid, baseURL } = setDefaults(init ?? {});
   return new Request(
-    `https://${hostName}/api/users/me`,
+    `${baseURL}api/users/me`,
     sid ? { headers: { Cookie: cookie(sid) } } : undefined,
   );
 };

util.ts

@@ -36,15 +36,11 @@ export interface BaseOptions<R extends Response | undefined> {
    */
   fetch?: Fetch<R>;
 
-  /** Domain for REST API endpoints
+  /** Base URL for REST API endpoints
    *
-   * Configurable host name for API requests. This allows using the library
-   * with self-hosted Scrapbox instances or other custom deployments that
-   * don't use the default scrapbox.io domain.
-   *
-   * @default {"scrapbox.io"}
+   * @default {"https://scrapbox.io/"}
    */
-  hostName?: string;
+  baseURL?: string;
 }
 
 /** Options for Gyazo API which requires OAuth */
@@ -83,8 +79,11 @@ export const setDefaults = <
   T extends BaseOptions<any> = BaseOptions<Response>,
 >(
   options: T,
-): Omit<T, "fetch" | "hostName"> & Required<Pick<T, "fetch" | "hostName">> => {
-  const { fetch = globalThis.fetch, hostName = "scrapbox.io", ...rest } =
-    options;
-  return { fetch, hostName, ...rest };
+): Omit<T, "fetch" | "baseURL"> & Required<Pick<T, "fetch" | "baseURL">> => {
+  const {
+    fetch = globalThis.fetch,
+    baseURL = "https://scrapbox.io/",
+    ...rest
+  } = options;
+  return { fetch, baseURL, ...rest };
 };