SPB Git

Repository Public

client.ts 4.4 KB 74 lines typescript

1// Typed API access. All types come from the generated contract (schema.d.ts); nothing is hand-written.2import createClient from "openapi-fetch";3import type { components, paths } from "./schema";4import { ApiError, errorFromResponse } from "./errors";5import { createTransport } from "./transport";67export type Schemas = components["schemas"];8export const transport = createTransport();910const client = createClient<paths>({11  baseUrl: "/api/v1",12  credentials: "same-origin",13  cache: "no-store",14  fetch: (request) => transport.fetch(request),15  // the contract declares array parameters as style=form, explode=false (comma-separated)16  querySerializer: { array: { style: "form", explode: false } },17});1819type Method = "get" | "post" | "put" | "patch" | "delete";20type PathsWith<M extends Method> = { [P in keyof paths]: paths[P] extends Record<M, { responses: unknown }> ? P : never }[keyof paths];21type Op<P extends keyof paths, M extends Method> = paths[P] extends Record<M, infer O> ? O : never;22type QueryOf<O> = O extends { parameters: { query?: infer Q } } ? ([NonNullable<Q>] extends [never] ? never : NonNullable<Q>) : never;23type PathParamsOf<O> = O extends { parameters: { path: infer Q } } ? Q : undefined;24type HeaderOf<O> = O extends { parameters: { header?: infer H } } ? NonNullable<H> : never;25type RequestBodyOf<O> = O extends { requestBody?: infer R } ? NonNullable<R> : never;26type BodyOf<O> = [RequestBodyOf<O>] extends [never] ? undefined : RequestBodyOf<O> extends { content: { "application/json": infer B } } ? B : undefined;27type Success<O> = O extends { responses: infer R }28  ? { [S in keyof R]: S extends 200 | 201 ? (R[S] extends { content: { "application/json": infer T } } ? T : R[S] extends { content: { "text/calendar": infer T } } ? T : undefined) : never }[keyof R] extends infer U29    ? [U] extends [never] ? undefined : U30    : never31  : never;3233export type ApiData<P extends keyof paths, M extends Method = "get"> = Success<Op<P, M>>;34export type ApiQuery<P extends keyof paths, M extends Method = "get"> = QueryOf<Op<P, M>>;3536type RequiredKeys<T> = { [K in keyof T]-?: object extends Pick<T, K> ? never : K }[keyof T];37type Init<O> = (PathParamsOf<O> extends undefined ? { path?: undefined } : { path: PathParamsOf<O> }) &38  ([QueryOf<O>] extends [never] ? { query?: undefined } : [RequiredKeys<QueryOf<O>>] extends [never] ? { query?: QueryOf<O> } : { query: QueryOf<O> }) &39  (BodyOf<O> extends undefined ? { body?: undefined } : { body: BodyOf<O> }) & {40    headers?: Partial<Record<keyof HeaderOf<O> & string, string>>;41    signal?: AbortSignal;42  };43type InitArg<O> = [RequiredKeys<Init<O>>] extends [never] ? [init?: Init<O>] : [init: Init<O>];4445type LooseCall = (path: string, init: unknown) => Promise<{ data?: unknown; error?: unknown; response: Response }>;4647async function call<P extends keyof paths, M extends Method>(method: M, path: P, init: Init<Op<P, M>> | undefined): Promise<ApiData<P, M>> {48  const fn = client[method.toUpperCase() as Uppercase<Method>] as unknown as LooseCall;49  let result: { data?: unknown; error?: unknown; response: Response };50  try {51    result = await fn(path, {52      params: { path: init?.path, query: init?.query },53      ...(init?.body !== undefined ? { body: init.body } : {}),54      ...(init?.headers ? { headers: init.headers } : {}),55      ...(init?.signal ? { signal: init.signal } : {}),56    });57  } catch (e) {58    if (e instanceof DOMException && e.name === "AbortError") throw e;59    throw new ApiError({ status: 0, code: "network", message: e instanceof Error ? e.message : "network error" });60  }61  if (!result.response.ok) throw await errorFromResponse(result.response, result.error);62  return result.data as ApiData<P, M>;63}6465export const apiGet = <P extends PathsWith<"get">>(path: P, ...[init]: InitArg<Op<P, "get">>) => call("get", path, init);66export const apiPost = <P extends PathsWith<"post">>(path: P, ...[init]: InitArg<Op<P, "post">>) => call("post", path, init);67export const apiPut = <P extends PathsWith<"put">>(path: P, ...[init]: InitArg<Op<P, "put">>) => call("put", path, init);68export const apiPatch = <P extends PathsWith<"patch">>(path: P, ...[init]: InitArg<Op<P, "patch">>) => call("patch", path, init);69export const apiDelete = <P extends PathsWith<"delete">>(path: P, ...[init]: InitArg<Op<P, "delete">>) => call("delete", path, init);7071export type GetPath = PathsWith<"get">;72export type GetInit<P extends GetPath> = Init<Op<P, "get">>;73export type GetInitArg<P extends GetPath> = InitArg<Op<P, "get">>;74
Files main
Menu

Theme