src/local.ts

Functions

Imports

It imports src/adapter.ts, src/client.ts, src/server.ts. Imported by src/admin.ts, src/client.ts.

Source

1// A site's own admin, talking to its own adapter in process. localClient(adapter) answers every
2// method createSiteClient does, with the same types and the same SiteApiError, by handing each
3// request straight to createSiteApi's handler: no network, no configured key, and the very code
4// Carrel's requests meet. So every route rule, version check, upload check and zod parse is the one
5// Carrel gets, and the content kit (./admin) runs the same against either client.
6
7import type { SiteAdapter } from "./adapter.js";
8import { createSiteClient, type SiteClient } from "./client.js";
9import { createSiteApi } from "./server.js";
10
11export interface LocalClientOptions {
12  /** Where adapter failures and contract breaches are logged. Defaults to console, as createSiteApi does. */
13  log?: (entry: Record<string, unknown>) => void;
14}
15
16/** A key that lives only in this closure: the handler insists on one, and nothing outside can learn it. */
17function inProcessKey(): string {
18  const bytes = crypto.getRandomValues(new Uint8Array(32));
19  return [...bytes].map((b) => b.toString(16).padStart(2, "0")).join("");
20}
21
22export function localClient(adapter: SiteAdapter, options: LocalClientOptions = {}): SiteClient {
23  const key = inProcessKey();
24  const api = createSiteApi({
25    adapter,
26    key,
27    // One person in their own admin is not a burst from the internet; the site's own sign-in guards this door.
28    limiter: { limit: async () => ({ success: true }) },
29    ...(options.log ? { log: options.log } : {}),
30  });
31  const handle = (async (input: RequestInfo | URL, init?: RequestInit) => api.handle(new Request(input, init))) as typeof fetch;
32  return createSiteClient({ baseUrl: adapter.site.origin, key, fetch: handle });
33}