@holaboss/app-sdk 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Holaboss
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,94 @@
+# @holaboss/app-sdk
+
+Generated TypeScript client for the Holaboss product API. Consumed by the Holaboss web app and the open-source [holaOS](https://github.com/holaboss-ai/holaOS) desktop.
+
+This package is a thin, type-safe wrapper over the Holaboss REST API (the Hono server that fronts the Python services). It is generated from the server's OpenAPI surface using [Kubb](https://kubb.dev/), so the types, functions, and React Query hooks stay in sync with the live contract.
+
+## Install
+
+```bash
+npm install @holaboss/app-sdk
+# or
+bun add @holaboss/app-sdk
+```
+
+React hooks are optional; if you use them, install the peer:
+
+```bash
+npm install @tanstack/react-query
+```
+
+## Subpath exports
+
+| Subpath | For | Contains |
+|---|---|---|
+| `@holaboss/app-sdk/core` | Non-React consumers, main/preload code in Electron, Node scripts | Generated fetch functions + `createAppClient` |
+| `@holaboss/app-sdk/react` | React UIs | Generated TanStack Query hooks |
+| `@holaboss/app-sdk/zod` | Client-side runtime validation | Generated Zod schemas |
+| `@holaboss/app-sdk/clients/app` | Advanced: configure the underlying fetch client | Low-level `createClient` + request/response types |
+| `@holaboss/app-sdk` | Convenience re-export of `core + react + zod` | Everything |
+
+## Usage
+
+### Create a configured client
+
+```ts
+import { createAppClient } from "@holaboss/app-sdk/core";
+
+export const appClient = createAppClient({
+  baseURL: "https://api.holaboss.ai/api/marketplace",
+  credentials: "include",
+});
+
+export const appClientOptions = { client: appClient } as const;
+```
+
+### Call a generated function (non-React)
+
+```ts
+import { listMarketplaceTemplates } from "@holaboss/app-sdk/core";
+
+const templates = await listMarketplaceTemplates({
+  client: appClient,
+});
+```
+
+### Use a generated React Query hook
+
+```tsx
+import { useListMarketplaceTemplates } from "@holaboss/app-sdk/react";
+
+function TemplatesList() {
+  const { data } = useListMarketplaceTemplates({
+    client: appClientOptions,
+  });
+  return <ul>{data?.map((t) => <li key={t.id}>{t.name}</li>)}</ul>;
+}
+```
+
+## Stability & versioning
+
+This package follows [Semantic Versioning](https://semver.org/).
+
+- **patch** (`0.x.y`) — internal changes to generated code with no observable API change
+- **minor** (`0.x.0`) — additive changes: new endpoints, new optional request/response fields
+- **major** — breaking changes: removed endpoints, removed fields, required field additions, request/response shape changes
+
+While on `0.x`, breaking changes are allowed on minor bumps per standard semver-for-0.x conventions, but we will call them out in release notes and bump conservatively.
+
+**Consumers should pin an exact version** (no `^` ranges) until this package reaches `1.0.0`.
+
+## Regenerating
+
+Code is generated from the Holaboss Hono server's OpenAPI spec at `/api/marketplace/openapi.json`. To regenerate with the server running locally:
+
+```bash
+bun install
+KUBB_APP_OPENAPI_URL=http://127.0.0.1:4000/api/marketplace/openapi.json bun run codegen
+```
+
+The `src/generated/` tree is committed. Do not run codegen as part of the release pipeline — regeneration is a deliberate human action, reviewed in a PR, followed by a version bump.
+
+## License
+
+MIT

package/dist/app-BpcA69HT.d.cts

@@ -0,0 +1,32 @@
+//#region src/clients/base.d.ts
+type HeaderValue = null | string | undefined;
+type RequestHeaders = Headers | Record<string, HeaderValue> | [string, HeaderValue][];
+type QueryParamValue = boolean | null | number | string | undefined | Array<boolean | null | number | string | undefined>;
+type RequestConfig<TData = unknown> = {
+  baseURL?: string;
+  credentials?: RequestCredentials;
+  data?: TData;
+  headers?: RequestHeaders;
+  method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+  params?: Record<string, QueryParamValue>;
+  responseType?: "arraybuffer" | "blob" | "json" | "text";
+  signal?: AbortSignal;
+  url?: string;
+};
+type ResponseConfig<TData = unknown> = {
+  data: TData;
+  headers: Headers;
+  status: number;
+  statusText: string;
+};
+type ResponseErrorConfig<TError = unknown> = Error & {
+  data?: TError;
+  headers?: Headers;
+  status: number;
+  statusText: string;
+};
+declare function baseClient<TData, TError = unknown, TVariables = unknown>(config: RequestConfig<TVariables>): Promise<ResponseConfig<TData>>;
+declare function createClient(defaults: Pick<RequestConfig, "baseURL" | "credentials" | "headers">): <TData, TError = unknown, TVariables = unknown>(config: RequestConfig<TVariables>) => Promise<ResponseConfig<TData>>;
+//#endregion
+export { createClient as a, baseClient as i, ResponseConfig as n, ResponseErrorConfig as r, RequestConfig as t };
+//# sourceMappingURL=app-BpcA69HT.d.cts.map

package/dist/app-BpcA69HT.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-BpcA69HT.d.cts","names":[],"sources":["../src/clients/base.ts"],"mappings":";KAAY,WAAA;AAAA,KAEA,cAAA,GACR,OAAA,GACA,MAAA,SAAe,WAAA,aACN,WAAA;AAAA,KAED,eAAA,kDAMR,KAAA;AAAA,KAEQ,aAAA;EACV,OAAA;EACA,WAAA,GAAc,kBAAA;EACd,IAAA,GAAO,KAAA;EACP,OAAA,GAAU,cAAA;EACV,MAAA;EACA,MAAA,GAAS,MAAA,SAAe,eAAA;EACxB,YAAA;EACA,MAAA,GAAS,WAAA;EACT,GAAA;AAAA;AAAA,KAGU,cAAA;EACV,IAAA,EAAM,KAAA;EACN,OAAA,EAAS,OAAA;EACT,MAAA;EACA,UAAA;AAAA;AAAA,KAGU,mBAAA,qBAAwC,KAAA;EAClD,IAAA,GAAO,MAAA;EACP,OAAA,GAAU,OAAA;EACV,MAAA;EACA,UAAA;AAAA;AAAA,iBAyMa,UAAA,+CAAA,CACb,MAAA,EAAQ,aAAA,CAAc,UAAA,IACrB,OAAA,CAAQ,cAAA,CAAe,KAAA;AAAA,iBAkDV,YAAA,CACd,QAAA,EAAU,IAAA,CAAK,aAAA,2FAGb,MAAA,EAAQ,aAAA,CAAc,UAAA,MAAW,OAAA,CAAA,cAAA,CAAA,KAAA"}

package/dist/app-CPM9G9Ak.d.ts

@@ -0,0 +1,32 @@
+//#region src/clients/base.d.ts
+type HeaderValue = null | string | undefined;
+type RequestHeaders = Headers | Record<string, HeaderValue> | [string, HeaderValue][];
+type QueryParamValue = boolean | null | number | string | undefined | Array<boolean | null | number | string | undefined>;
+type RequestConfig<TData = unknown> = {
+  baseURL?: string;
+  credentials?: RequestCredentials;
+  data?: TData;
+  headers?: RequestHeaders;
+  method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+  params?: Record<string, QueryParamValue>;
+  responseType?: "arraybuffer" | "blob" | "json" | "text";
+  signal?: AbortSignal;
+  url?: string;
+};
+type ResponseConfig<TData = unknown> = {
+  data: TData;
+  headers: Headers;
+  status: number;
+  statusText: string;
+};
+type ResponseErrorConfig<TError = unknown> = Error & {
+  data?: TError;
+  headers?: Headers;
+  status: number;
+  statusText: string;
+};
+declare function baseClient<TData, TError = unknown, TVariables = unknown>(config: RequestConfig<TVariables>): Promise<ResponseConfig<TData>>;
+declare function createClient(defaults: Pick<RequestConfig, "baseURL" | "credentials" | "headers">): <TData, TError = unknown, TVariables = unknown>(config: RequestConfig<TVariables>) => Promise<ResponseConfig<TData>>;
+//#endregion
+export { createClient as a, baseClient as i, ResponseConfig as n, ResponseErrorConfig as r, RequestConfig as t };
+//# sourceMappingURL=app-CPM9G9Ak.d.ts.map

package/dist/app-CPM9G9Ak.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-CPM9G9Ak.d.ts","names":[],"sources":["../src/clients/base.ts"],"mappings":";KAAY,WAAA;AAAA,KAEA,cAAA,GACR,OAAA,GACA,MAAA,SAAe,WAAA,aACN,WAAA;AAAA,KAED,eAAA,kDAMR,KAAA;AAAA,KAEQ,aAAA;EACV,OAAA;EACA,WAAA,GAAc,kBAAA;EACd,IAAA,GAAO,KAAA;EACP,OAAA,GAAU,cAAA;EACV,MAAA;EACA,MAAA,GAAS,MAAA,SAAe,eAAA;EACxB,YAAA;EACA,MAAA,GAAS,WAAA;EACT,GAAA;AAAA;AAAA,KAGU,cAAA;EACV,IAAA,EAAM,KAAA;EACN,OAAA,EAAS,OAAA;EACT,MAAA;EACA,UAAA;AAAA;AAAA,KAGU,mBAAA,qBAAwC,KAAA;EAClD,IAAA,GAAO,MAAA;EACP,OAAA,GAAU,OAAA;EACV,MAAA;EACA,UAAA;AAAA;AAAA,iBAyMa,UAAA,+CAAA,CACb,MAAA,EAAQ,aAAA,CAAc,UAAA,IACrB,OAAA,CAAQ,cAAA,CAAe,KAAA;AAAA,iBAkDV,YAAA,CACd,QAAA,EAAU,IAAA,CAAK,aAAA,2FAGb,MAAA,EAAQ,aAAA,CAAc,UAAA,MAAW,OAAA,CAAA,cAAA,CAAA,KAAA"}

package/dist/app-DvahQ8xx.js

@@ -0,0 +1,147 @@
+//#region src/clients/base.ts
+var UpstreamInvalidResponseError = class extends Error {
+	url;
+	status;
+	contentType;
+	bodySnippet;
+	constructor(params) {
+		const snippet = params.bodySnippet.slice(0, 200);
+		super(`Upstream returned ${params.status} with non-JSON body (content-type="${params.contentType || "<none>"}", length=${params.bodySnippet.length}) from ${params.url}. This usually means the request hit a catchall handler or a misrouted reverse proxy. Body: ${JSON.stringify(snippet)}`);
+		this.name = "UpstreamInvalidResponseError";
+		this.url = params.url;
+		this.status = params.status;
+		this.contentType = params.contentType;
+		this.bodySnippet = snippet;
+	}
+};
+function toHeaders(headers) {
+	const normalized = new Headers();
+	if (!headers) return normalized;
+	if (headers instanceof Headers) {
+		for (const [key, value] of headers.entries()) normalized.set(key, value);
+		return normalized;
+	}
+	if (Array.isArray(headers)) {
+		for (const [key, value] of headers) if (value != null) normalized.set(key, value);
+		return normalized;
+	}
+	for (const [key, value] of Object.entries(headers)) if (value != null) normalized.set(key, value);
+	return normalized;
+}
+function appendQueryParam(searchParams, key, value) {
+	if (value == null) return;
+	searchParams.append(key, String(value));
+}
+function buildUrl({ baseURL, params, url }) {
+	if (!url) throw new Error("Request URL is required.");
+	const hasAbsoluteUrl = /^https?:\/\//u.test(url);
+	if (!(baseURL || hasAbsoluteUrl)) throw new Error(`Relative URL "${url}" requires a baseURL.`);
+	let resolved;
+	if (hasAbsoluteUrl) resolved = new URL(url);
+	else {
+		const trimmedBase = (baseURL ?? "").replace(/\/+$/u, "");
+		const normalizedPath = url.startsWith("/") ? url : `/${url}`;
+		resolved = new URL(`${trimmedBase}${normalizedPath}`);
+	}
+	for (const [key, rawValue] of Object.entries(params ?? {})) {
+		if (Array.isArray(rawValue)) {
+			for (const value of rawValue) appendQueryParam(resolved.searchParams, key, value);
+			continue;
+		}
+		appendQueryParam(resolved.searchParams, key, rawValue);
+	}
+	return resolved;
+}
+function isJsonBody(value) {
+	return typeof value === "object" && value !== null && !(value instanceof ArrayBuffer) && !(value instanceof Blob) && !(value instanceof FormData) && !(value instanceof URLSearchParams);
+}
+async function parseSuccessBody(response, responseType, requestUrl) {
+	if (response.status === 204) return;
+	if (responseType === "arraybuffer") return await response.arrayBuffer();
+	if (responseType === "blob") return await response.blob();
+	if (responseType === "text") return await response.text();
+	const contentType = response.headers.get("content-type") ?? "";
+	if (!contentType.includes("application/json")) {
+		const snippet = await response.text();
+		throw new UpstreamInvalidResponseError({
+			url: requestUrl,
+			status: response.status,
+			contentType,
+			bodySnippet: snippet
+		});
+	}
+	const raw = await response.text();
+	if (raw.length === 0) throw new UpstreamInvalidResponseError({
+		url: requestUrl,
+		status: response.status,
+		contentType,
+		bodySnippet: ""
+	});
+	try {
+		return JSON.parse(raw);
+	} catch (_parseError) {
+		throw new UpstreamInvalidResponseError({
+			url: requestUrl,
+			status: response.status,
+			contentType,
+			bodySnippet: raw
+		});
+	}
+}
+async function parseErrorBody(response) {
+	try {
+		if ((response.headers.get("content-type") ?? "").includes("application/json")) {
+			const raw = await response.text();
+			return raw.length === 0 ? void 0 : JSON.parse(raw);
+		}
+		return await response.text();
+	} catch {
+		return;
+	}
+}
+async function baseClient(config) {
+	const requestUrl = buildUrl(config);
+	const headers = toHeaders(config.headers);
+	const init = {
+		credentials: config.credentials,
+		headers,
+		method: config.method,
+		signal: config.signal
+	};
+	if (config.data !== void 0 && config.method !== "GET") if (isJsonBody(config.data)) {
+		if (!headers.has("content-type")) headers.set("content-type", "application/json");
+		init.body = JSON.stringify(config.data);
+	} else init.body = config.data;
+	const response = await fetch(requestUrl, init);
+	if (!response.ok) {
+		const errorData = await parseErrorBody(response);
+		const error = /* @__PURE__ */ new Error(`Request failed with status ${response.status} ${response.statusText}`);
+		error.status = response.status;
+		error.statusText = response.statusText;
+		error.headers = response.headers;
+		error.data = errorData;
+		throw error;
+	}
+	return {
+		data: await parseSuccessBody(response, config.responseType, requestUrl.toString()),
+		headers: response.headers,
+		status: response.status,
+		statusText: response.statusText
+	};
+}
+function createClient(defaults) {
+	return (config) => {
+		const headers = toHeaders(defaults.headers);
+		for (const [key, value] of toHeaders(config.headers).entries()) headers.set(key, value);
+		return baseClient({
+			...config,
+			baseURL: config.baseURL ?? defaults.baseURL,
+			credentials: config.credentials ?? defaults.credentials,
+			headers
+		});
+	};
+}
+//#endregion
+export { createClient as n, baseClient as t };
+
+//# sourceMappingURL=app-DvahQ8xx.js.map

package/dist/app-DvahQ8xx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-DvahQ8xx.js","names":[],"sources":["../src/clients/base.ts"],"sourcesContent":["export type HeaderValue = null | string | undefined;\n\nexport type RequestHeaders =\n  | Headers\n  | Record<string, HeaderValue>\n  | [string, HeaderValue][];\n\nexport type QueryParamValue =\n  | boolean\n  | null\n  | number\n  | string\n  | undefined\n  | Array<boolean | null | number | string | undefined>;\n\nexport type RequestConfig<TData = unknown> = {\n  baseURL?: string;\n  credentials?: RequestCredentials;\n  data?: TData;\n  headers?: RequestHeaders;\n  method: \"DELETE\" | \"GET\" | \"PATCH\" | \"POST\" | \"PUT\";\n  params?: Record<string, QueryParamValue>;\n  responseType?: \"arraybuffer\" | \"blob\" | \"json\" | \"text\";\n  signal?: AbortSignal;\n  url?: string;\n};\n\nexport type ResponseConfig<TData = unknown> = {\n  data: TData;\n  headers: Headers;\n  status: number;\n  statusText: string;\n};\n\nexport type ResponseErrorConfig<TError = unknown> = Error & {\n  data?: TError;\n  headers?: Headers;\n  status: number;\n  statusText: string;\n};\n\nexport class UpstreamInvalidResponseError extends Error {\n  readonly url: string;\n  readonly status: number;\n  readonly contentType: string;\n  readonly bodySnippet: string;\n\n  constructor(params: {\n    url: string;\n    status: number;\n    contentType: string;\n    bodySnippet: string;\n  }) {\n    const snippet = params.bodySnippet.slice(0, 200);\n    super(\n      `Upstream returned ${params.status} with non-JSON body ` +\n        `(content-type=\"${params.contentType || \"<none>\"}\", length=${params.bodySnippet.length}) ` +\n        `from ${params.url}. This usually means the request hit a catchall handler or a ` +\n        `misrouted reverse proxy. Body: ${JSON.stringify(snippet)}`\n    );\n    this.name = \"UpstreamInvalidResponseError\";\n    this.url = params.url;\n    this.status = params.status;\n    this.contentType = params.contentType;\n    this.bodySnippet = snippet;\n  }\n}\n\nfunction toHeaders(headers?: RequestHeaders): Headers {\n  const normalized = new Headers();\n\n  if (!headers) {\n    return normalized;\n  }\n\n  if (headers instanceof Headers) {\n    for (const [key, value] of headers.entries()) {\n      normalized.set(key, value);\n    }\n    return normalized;\n  }\n\n  if (Array.isArray(headers)) {\n    for (const [key, value] of headers) {\n      if (value != null) {\n        normalized.set(key, value);\n      }\n    }\n    return normalized;\n  }\n\n  for (const [key, value] of Object.entries(headers)) {\n    if (value != null) {\n      normalized.set(key, value);\n    }\n  }\n\n  return normalized;\n}\n\nfunction appendQueryParam(\n  searchParams: URLSearchParams,\n  key: string,\n  value: Exclude<QueryParamValue, QueryParamValue[]>\n) {\n  if (value == null) {\n    return;\n  }\n\n  searchParams.append(key, String(value));\n}\n\nexport function buildUrl({\n  baseURL,\n  params,\n  url,\n}: Pick<RequestConfig, \"baseURL\" | \"params\" | \"url\">): URL {\n  if (!url) {\n    throw new Error(\"Request URL is required.\");\n  }\n\n  const hasAbsoluteUrl = /^https?:\\/\\//u.test(url);\n  if (!(baseURL || hasAbsoluteUrl)) {\n    throw new Error(`Relative URL \"${url}\" requires a baseURL.`);\n  }\n\n  // Concatenate baseURL and url manually so any path segment on the baseURL\n  // (e.g. `/api/marketplace`) is preserved. `new URL(\"/templates\", base)`\n  // would treat the leading slash as path-absolute and discard the\n  // baseURL's existing path component.\n  let resolved: URL;\n  if (hasAbsoluteUrl) {\n    resolved = new URL(url);\n  } else {\n    const trimmedBase = (baseURL ?? \"\").replace(/\\/+$/u, \"\");\n    const normalizedPath = url.startsWith(\"/\") ? url : `/${url}`;\n    resolved = new URL(`${trimmedBase}${normalizedPath}`);\n  }\n\n  for (const [key, rawValue] of Object.entries(params ?? {})) {\n    if (Array.isArray(rawValue)) {\n      for (const value of rawValue) {\n        appendQueryParam(resolved.searchParams, key, value);\n      }\n      continue;\n    }\n\n    appendQueryParam(resolved.searchParams, key, rawValue);\n  }\n\n  return resolved;\n}\n\nfunction isJsonBody(\n  value: unknown\n): value is Record<string, unknown> | unknown[] {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    !(value instanceof ArrayBuffer) &&\n    !(value instanceof Blob) &&\n    !(value instanceof FormData) &&\n    !(value instanceof URLSearchParams)\n  );\n}\n\nasync function parseSuccessBody<TData>(\n  response: Response,\n  responseType: RequestConfig[\"responseType\"] | undefined,\n  requestUrl: string\n): Promise<TData> {\n  if (response.status === 204) {\n    return undefined as TData;\n  }\n\n  if (responseType === \"arraybuffer\") {\n    return (await response.arrayBuffer()) as TData;\n  }\n\n  if (responseType === \"blob\") {\n    return (await response.blob()) as TData;\n  }\n\n  if (responseType === \"text\") {\n    return (await response.text()) as TData;\n  }\n\n  // Default path: caller expects JSON. Treat anything else (empty body, text,\n  // HTML from a reverse-proxy catchall, etc.) as a hard failure so routing\n  // mistakes surface with a clear error instead of bleeding into downstream\n  // Zod \"expected object, received string\" errors.\n  const contentType = response.headers.get(\"content-type\") ?? \"\";\n  if (!contentType.includes(\"application/json\")) {\n    const snippet = await response.text();\n    throw new UpstreamInvalidResponseError({\n      url: requestUrl,\n      status: response.status,\n      contentType,\n      bodySnippet: snippet,\n    });\n  }\n\n  const raw = await response.text();\n  if (raw.length === 0) {\n    throw new UpstreamInvalidResponseError({\n      url: requestUrl,\n      status: response.status,\n      contentType,\n      bodySnippet: \"\",\n    });\n  }\n\n  try {\n    return JSON.parse(raw) as TData;\n  } catch (_parseError) {\n    throw new UpstreamInvalidResponseError({\n      url: requestUrl,\n      status: response.status,\n      contentType,\n      bodySnippet: raw,\n    });\n  }\n}\n\nasync function parseErrorBody(response: Response): Promise<unknown> {\n  // Best-effort on error paths: try JSON when advertised, otherwise text,\n  // and never throw — we always want the caller to see the HTTP failure.\n  try {\n    const contentType = response.headers.get(\"content-type\") ?? \"\";\n    if (contentType.includes(\"application/json\")) {\n      const raw = await response.text();\n      return raw.length === 0 ? undefined : JSON.parse(raw);\n    }\n    return await response.text();\n  } catch {\n    return;\n  }\n}\n\nasync function baseClient<TData, TError = unknown, TVariables = unknown>(\n  config: RequestConfig<TVariables>\n): Promise<ResponseConfig<TData>> {\n  const requestUrl = buildUrl(config);\n  const headers = toHeaders(config.headers);\n\n  const init: RequestInit = {\n    credentials: config.credentials,\n    headers,\n    method: config.method,\n    signal: config.signal,\n  };\n\n  if (config.data !== undefined && config.method !== \"GET\") {\n    if (isJsonBody(config.data)) {\n      if (!headers.has(\"content-type\")) {\n        headers.set(\"content-type\", \"application/json\");\n      }\n      init.body = JSON.stringify(config.data);\n    } else {\n      init.body = config.data as BodyInit;\n    }\n  }\n\n  const response = await fetch(requestUrl, init);\n\n  if (!response.ok) {\n    const errorData = await parseErrorBody(response);\n    const error = new Error(\n      `Request failed with status ${response.status} ${response.statusText}`\n    ) as ResponseErrorConfig<TError>;\n    error.status = response.status;\n    error.statusText = response.statusText;\n    error.headers = response.headers;\n    error.data = errorData as TError;\n    throw error;\n  }\n\n  const data = await parseSuccessBody<TData>(\n    response,\n    config.responseType,\n    requestUrl.toString()\n  );\n\n  return {\n    data,\n    headers: response.headers,\n    status: response.status,\n    statusText: response.statusText,\n  };\n}\n\nexport function createClient(\n  defaults: Pick<RequestConfig, \"baseURL\" | \"credentials\" | \"headers\">\n) {\n  return <TData, TError = unknown, TVariables = unknown>(\n    config: RequestConfig<TVariables>\n  ) => {\n    const headers = toHeaders(defaults.headers);\n    for (const [key, value] of toHeaders(config.headers).entries()) {\n      headers.set(key, value);\n    }\n\n    return baseClient<TData, TError, TVariables>({\n      ...config,\n      baseURL: config.baseURL ?? defaults.baseURL,\n      credentials: config.credentials ?? defaults.credentials,\n      headers,\n    });\n  };\n}\n\nexport default baseClient;\n"],"mappings":"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"}

package/dist/app-mQJKUJHj.cjs

@@ -0,0 +1,156 @@
+//#region src/clients/base.ts
+var UpstreamInvalidResponseError = class extends Error {
+	url;
+	status;
+	contentType;
+	bodySnippet;
+	constructor(params) {
+		const snippet = params.bodySnippet.slice(0, 200);
+		super(`Upstream returned ${params.status} with non-JSON body (content-type="${params.contentType || "<none>"}", length=${params.bodySnippet.length}) from ${params.url}. This usually means the request hit a catchall handler or a misrouted reverse proxy. Body: ${JSON.stringify(snippet)}`);
+		this.name = "UpstreamInvalidResponseError";
+		this.url = params.url;
+		this.status = params.status;
+		this.contentType = params.contentType;
+		this.bodySnippet = snippet;
+	}
+};
+function toHeaders(headers) {
+	const normalized = new Headers();
+	if (!headers) return normalized;
+	if (headers instanceof Headers) {
+		for (const [key, value] of headers.entries()) normalized.set(key, value);
+		return normalized;
+	}
+	if (Array.isArray(headers)) {
+		for (const [key, value] of headers) if (value != null) normalized.set(key, value);
+		return normalized;
+	}
+	for (const [key, value] of Object.entries(headers)) if (value != null) normalized.set(key, value);
+	return normalized;
+}
+function appendQueryParam(searchParams, key, value) {
+	if (value == null) return;
+	searchParams.append(key, String(value));
+}
+function buildUrl({ baseURL, params, url }) {
+	if (!url) throw new Error("Request URL is required.");
+	const hasAbsoluteUrl = /^https?:\/\//u.test(url);
+	if (!(baseURL || hasAbsoluteUrl)) throw new Error(`Relative URL "${url}" requires a baseURL.`);
+	let resolved;
+	if (hasAbsoluteUrl) resolved = new URL(url);
+	else {
+		const trimmedBase = (baseURL ?? "").replace(/\/+$/u, "");
+		const normalizedPath = url.startsWith("/") ? url : `/${url}`;
+		resolved = new URL(`${trimmedBase}${normalizedPath}`);
+	}
+	for (const [key, rawValue] of Object.entries(params ?? {})) {
+		if (Array.isArray(rawValue)) {
+			for (const value of rawValue) appendQueryParam(resolved.searchParams, key, value);
+			continue;
+		}
+		appendQueryParam(resolved.searchParams, key, rawValue);
+	}
+	return resolved;
+}
+function isJsonBody(value) {
+	return typeof value === "object" && value !== null && !(value instanceof ArrayBuffer) && !(value instanceof Blob) && !(value instanceof FormData) && !(value instanceof URLSearchParams);
+}
+async function parseSuccessBody(response, responseType, requestUrl) {
+	if (response.status === 204) return;
+	if (responseType === "arraybuffer") return await response.arrayBuffer();
+	if (responseType === "blob") return await response.blob();
+	if (responseType === "text") return await response.text();
+	const contentType = response.headers.get("content-type") ?? "";
+	if (!contentType.includes("application/json")) {
+		const snippet = await response.text();
+		throw new UpstreamInvalidResponseError({
+			url: requestUrl,
+			status: response.status,
+			contentType,
+			bodySnippet: snippet
+		});
+	}
+	const raw = await response.text();
+	if (raw.length === 0) throw new UpstreamInvalidResponseError({
+		url: requestUrl,
+		status: response.status,
+		contentType,
+		bodySnippet: ""
+	});
+	try {
+		return JSON.parse(raw);
+	} catch (_parseError) {
+		throw new UpstreamInvalidResponseError({
+			url: requestUrl,
+			status: response.status,
+			contentType,
+			bodySnippet: raw
+		});
+	}
+}
+async function parseErrorBody(response) {
+	try {
+		if ((response.headers.get("content-type") ?? "").includes("application/json")) {
+			const raw = await response.text();
+			return raw.length === 0 ? void 0 : JSON.parse(raw);
+		}
+		return await response.text();
+	} catch {
+		return;
+	}
+}
+async function baseClient(config) {
+	const requestUrl = buildUrl(config);
+	const headers = toHeaders(config.headers);
+	const init = {
+		credentials: config.credentials,
+		headers,
+		method: config.method,
+		signal: config.signal
+	};
+	if (config.data !== void 0 && config.method !== "GET") if (isJsonBody(config.data)) {
+		if (!headers.has("content-type")) headers.set("content-type", "application/json");
+		init.body = JSON.stringify(config.data);
+	} else init.body = config.data;
+	const response = await fetch(requestUrl, init);
+	if (!response.ok) {
+		const errorData = await parseErrorBody(response);
+		const error = /* @__PURE__ */ new Error(`Request failed with status ${response.status} ${response.statusText}`);
+		error.status = response.status;
+		error.statusText = response.statusText;
+		error.headers = response.headers;
+		error.data = errorData;
+		throw error;
+	}
+	return {
+		data: await parseSuccessBody(response, config.responseType, requestUrl.toString()),
+		headers: response.headers,
+		status: response.status,
+		statusText: response.statusText
+	};
+}
+function createClient(defaults) {
+	return (config) => {
+		const headers = toHeaders(defaults.headers);
+		for (const [key, value] of toHeaders(config.headers).entries()) headers.set(key, value);
+		return baseClient({
+			...config,
+			baseURL: config.baseURL ?? defaults.baseURL,
+			credentials: config.credentials ?? defaults.credentials,
+			headers
+		});
+	};
+}
+//#endregion
+Object.defineProperty(exports, "baseClient", {
+	enumerable: true,
+	get: function() {
+		return baseClient;
+	}
+});
+Object.defineProperty(exports, "createClient", {
+	enumerable: true,
+	get: function() {
+		return createClient;
+	}
+});