@berachain/berajs 0.2.13 → 0.3.1

package/dist/chunk-BSOWLS3W.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/actions/clients/fetchOpenApi.ts","../src/actions/clients/fetchBeep.ts"],"sourcesContent":["import type { HttpLink } from \"@berachain/config\";\nimport { getUriFromLink } from \"@berachain/config\";\n\nimport { beraFetchJson } from \"../../utils/beraFetch\";\n\n/**\n * A minimal, fully-typed GET helper for our `openapi-typescript`-generated\n * `beep` backend. beep serves only GETs, so rather than a full OpenAPI client\n * we type a single `fetchOpenApi` against a schema's `paths` and wrap it\n * (`fetchBeep`).\n *\n * The `path`, its path/query params and the response body are all type-checked\n * against the schema, so route shapes can never drift out of sync with the\n * backend. Requests go through {@link beraFetchJson} so they keep the same\n * Sentry tracing, `RequestError` handling and URL sanitization as the rest of\n * the codebase.\n */\n\n/** Any `openapi-typescript` `paths` object. */\n// biome-ignore lint/suspicious/noExplicitAny: schema `paths` are structurally diverse; constrained at call sites by the concrete schema.\ntype AnyPaths = Record<string, any>;\n\n/** Paths in a schema that expose a JSON GET response. */\nexport type GetPath<Paths extends AnyPaths> = {\n  [P in keyof Paths]: Paths[P] extends {\n    get: { responses: { 200: { content: { \"application/json\": unknown } } } };\n  }\n    ? P\n    : never;\n}[keyof Paths];\n\ntype GetParams<\n  Paths extends AnyPaths,\n  P extends GetPath<Paths>,\n> = Paths[P][\"get\"] extends { parameters: infer Params } ? Params : never;\n\nexport type GetResponse<\n  Paths extends AnyPaths,\n  P extends GetPath<Paths>,\n> = Paths[P][\"get\"][\"responses\"][200][\"content\"][\"application/json\"];\n\n// Drop the params keys that are `never` (e.g. an endpoint with no query) so\n// callers only pass what an endpoint actually accepts.\nexport type DefinedParams<Paths extends AnyPaths, P extends GetPath<Paths>> = {\n  [K in keyof GetParams<Paths, P> as GetParams<Paths, P>[K] extends never\n    ? never\n    : K]: GetParams<Paths, P>[K];\n};\n\n/**\n * Perform a typed GET against an OpenAPI backend.\n *\n * @param link    The backend `HttpLink`. The base URL and monitoring name are\n *                read from it.\n * @param path    An OpenAPI path template, e.g. `/v0/stake/{vault}/stats-by-day`.\n * @param params  Path and query params, typed from the schema for `path`.\n * @param fallbackName  Monitoring name to use when `link` is a bare string.\n */\n// biome-ignore lint/complexity/useMaxParams: internal helper; the wrapper (fetchBeep) is the public surface.\nexport function fetchOpenApi<Paths extends AnyPaths, P extends GetPath<Paths>>(\n  link: HttpLink,\n  path: P,\n  params: DefinedParams<Paths, P>,\n  fallbackName: string,\n): Promise<GetResponse<Paths, P>> {\n  const { path: pathParams, query } = params as {\n    path?: Record<string, string | number>;\n    query?: Record<string, string | number | undefined>;\n  };\n\n  // Substitute `{param}` placeholders from the typed path params.\n  const pathStr = path as string;\n  const resolvedPath = pathStr.replace(/\\{([^}]+)\\}/g, (_, key) => {\n    const value = pathParams?.[key];\n    if (value === undefined) {\n      throw new Error(\n        `fetchOpenApi: missing path param \"${key}\" for \"${pathStr}\"`,\n      );\n    }\n    return encodeURIComponent(String(value));\n  });\n\n  // Omit params whose value is `undefined` rather than serializing them as the\n  // literal string \"undefined\" (e.g. optional filters left unset by callers).\n  const search = query\n    ? new URLSearchParams(\n        Object.entries(query)\n          .filter(([, v]) => v !== undefined)\n          .map(([k, v]) => [k, String(v)]),\n      ).toString()\n    : \"\";\n\n  const url = `${getUriFromLink(link)}${resolvedPath}${search ? `?${search}` : \"\"}`;\n  const name = typeof link === \"string\" ? fallbackName : link.name;\n\n  return beraFetchJson<GetResponse<Paths, P>>({ url, name, type: \"rest\" });\n}\n","import type { paths } from \"@berachain/graphql/beep\";\n\nimport { parseBaseArgs } from \"../../utils/parseBaseArgs\";\nimport {\n  type DefinedParams,\n  fetchOpenApi,\n  type GetPath,\n  type GetResponse,\n} from \"./fetchOpenApi\";\n\n/**\n * Typed GET against the next-gen \"beep\" backend.\n *\n * The `path`, its path/query params and the response are all type-checked\n * against the beep schema (`@berachain/graphql/beep`), so route shapes (e.g.\n * the `/v0/stake/*` namespace) can never drift out of sync with the backend.\n * The base URL is resolved from `config.beep`.\n */\nexport function fetchBeep<P extends GetPath<paths>>(\n  path: P,\n  params: DefinedParams<paths, P>,\n  args: BeraJS.BaseFunctionArgs = {},\n): Promise<GetResponse<paths, P>> {\n  const { config } = parseBaseArgs(args);\n\n  return fetchOpenApi<paths, P>(config.beep, path, params, \"beep\");\n}\n"],"mappings":";;;;;;;;AACA,SAAS,sBAAsB;AA0DxB,SAAS,aACd,MACA,MACA,QACA,cACgC;AAChC,QAAM,EAAE,MAAM,YAAY,MAAM,IAAI;AAMpC,QAAM,UAAU;AAChB,QAAM,eAAe,QAAQ,QAAQ,gBAAgB,CAAC,GAAG,QAAQ;AAC/D,UAAM,QAAQ,aAAa,GAAG;AAC9B,QAAI,UAAU,QAAW;AACvB,YAAM,IAAI;AAAA,QACR,qCAAqC,GAAG,UAAU,OAAO;AAAA,MAC3D;AAAA,IACF;AACA,WAAO,mBAAmB,OAAO,KAAK,CAAC;AAAA,EACzC,CAAC;AAID,QAAM,SAAS,QACX,IAAI;AAAA,IACF,OAAO,QAAQ,KAAK,EACjB,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,MAAM,MAAS,EACjC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;AAAA,EACnC,EAAE,SAAS,IACX;AAEJ,QAAM,MAAM,GAAG,eAAe,IAAI,CAAC,GAAG,YAAY,GAAG,SAAS,IAAI,MAAM,KAAK,EAAE;AAC/E,QAAM,OAAO,OAAO,SAAS,WAAW,eAAe,KAAK;AAE5D,SAAO,cAAqC,EAAE,KAAK,MAAM,MAAM,OAAO,CAAC;AACzE;;;AC9EO,SAAS,UACd,MACA,QACA,OAAgC,CAAC,GACD;AAChC,QAAM,EAAE,OAAO,IAAI,cAAc,IAAI;AAErC,SAAO,aAAuB,OAAO,MAAM,MAAM,QAAQ,MAAM;AACjE;","names":[]}