@zerotal/client 1.6.3 → 1.7.2

package/CHANGELOG.md

@@ -8,6 +8,35 @@ follows the Zerotal monorepo's unified versioning.
 
 ## [Unreleased]
 
+### Fixed
+
+- **The documented import could not be bundled for a browser.** `import { Socket } from
+  "@zerotal/client"` — the line the broadcasting guide taught — failed with `Browser build cannot
+  import() Bun builtin: "bun"`. The root entry also exports `ClientProvider`, which extends core's
+  `ServiceProvider`, which reaches `CommandRunner`, which reaches the built-in CLI commands, one of
+  which does `await import("bun")`. That is a *resolution*-time error, so tree-shaking never got the
+  chance to drop the half nobody in a browser wanted: one server-only export made the whole package
+  unusable in the environment it exists for.
+
+  `@zerotal/client` now resolves to a browser-safe entry under the `browser` export condition —
+  `Socket`, `ApiClient`, `CircuitBreaker`, `createApiClient` and their types, and none of the
+  server-side exports. Bun and Node consumers still get the full barrel, `ClientProvider` included,
+  so nothing about registering the package changes. `@zerotal/client/Socket` still works and is
+  still the leanest import when `Socket` is all you need; `ClientProvider` also gained an explicit
+  `./provider` subpath.
+
+  Two supporting changes: `createApiClient` moved out of `index.ts` into its own module, because a
+  browser entry re-exporting it from the barrel pulls the barrel back in — the first attempt at this
+  fix did exactly that and bundled straight back into the same error. And the modules a browser can
+  reach now import from narrow core subpaths (`@zerotal/core/errors`, `@zerotal/core/helpers`)
+  rather than the root, because importing *anything at all* from core's root is enough to poison a
+  browser bundle.
+
+  Guarded by a test that runs `Bun.build` with `target: "browser"` — no unit test can see this,
+  since every module imports fine under Bun — plus one that holds the browser entry in step with
+  the barrel, since two entry points means two places to remember to add an export to.
+
+
 ## [1.0.3] — 2026-08-07
 
 ### Changed

package/api-surface.md

@@ -0,0 +1,367 @@
+# @zerotal/client — public API surface
+
+<!-- AUTO-GENERATED by scripts/api-surface.ts. Do not edit by hand.
+     Run `bun run api:surface` to regenerate after an intentional API change. -->
+
+## .  `(./src/index.ts)`
+
+class ApiClient = {
+  new <Routes extends ApiRouteMap>(config?: ApiClientConfig): ApiClient<Routes>
+  delete: <Path extends PathsFor<Routes, 'DELETE'>>(path: Path, params?: ParamRecord<Path & string>, options?: RequestOptions) => Promise<ResponseOf<Routes, 'DELETE', Path & string>>
+  get: <Path extends PathsFor<Routes, 'GET'>>(path: Path, params?: ParamRecord<Path & string>, options?: GetOptions<QueryOf<Routes, 'GET', Path & string>>) => Promise<ResponseOf<Routes, 'GET', Path & string>>
+  patch: <Path extends PathsFor<Routes, 'PATCH'>>(path: Path, body?: BodyOf<Routes, 'PATCH', Path & string>, options?: MutationOptions<QueryOf<Routes, 'PATCH', Path & string>>) => Promise<ResponseOf<Routes, 'PATCH', Path & string>>
+  post: <Path extends PathsFor<Routes, 'POST'>>(path: Path, body?: BodyOf<Routes, 'POST', Path & string>, options?: MutationOptions<QueryOf<Routes, 'POST', Path & string>>) => Promise<ResponseOf<Routes, 'POST', Path & string>>
+  put: <Path extends PathsFor<Routes, 'PUT'>>(path: Path, body?: BodyOf<Routes, 'PUT', Path & string>, options?: MutationOptions<QueryOf<Routes, 'PUT', Path & string>>) => Promise<ResponseOf<Routes, 'PUT', Path & string>>
+  setToken: (token: TokenSource | null) => void
+}
+
+class ApiClientError = {
+  new (status: number, statusText: string, body: string, headers?: Headers): ApiClientError
+  readonly body: string
+  readonly code: string
+  readonly context?: Record<string, unknown> | undefined
+  readonly headers: Headers | undefined
+  readonly status: number
+  readonly statusText: string
+  retryAfterMs: number | null
+}
+
+class Channel = {
+  new (name: string, _socket: Socket): Channel
+  _dispatch: (frame: ServerFrame) => void
+  error: (cb: Listener) => Channel
+  listen: (event: string, cb: Listener) => Channel
+  readonly name: string
+  stopListening: (event: string, cb?: Listener) => Channel
+  subscribed: (cb: Listener) => Channel
+  unsubscribe: () => void
+}
+
+class CircuitBreaker = {
+  new (options?: CircuitBreakerOptions): CircuitBreaker
+  call: <T>(fn: () => Promise<T>) => Promise<T>
+  failures: number
+  reset: () => void
+  state: CircuitState
+}
+
+class CircuitBreakerOpenError = {
+  new (): CircuitBreakerOpenError
+  readonly code: string
+  readonly context?: Record<string, unknown> | undefined
+  readonly status: number
+}
+
+class ClientProvider = {
+  new (app: Application): ClientProvider
+  static dependsOn?: (new (app: Application) => ServiceProvider)[]
+  static environments: AppEnvironment[]
+  static priority?: number
+  static provides: readonly ['client']
+  devProcesses: () => DevProcessDefinition[]
+  doctorChecks: () => DoctorCheck[]
+  onBooted: () => Promise<void>
+  onBooting: () => Promise<void>
+  onRegister: () => void
+  onRequestProcessed: (_ctx: HttpContext) => Promise<void>
+  onRequestReceived: (_ctx: HttpContext) => Promise<void>
+  onResponseSent: (_ctx: HttpContext) => Promise<void>
+  onStarted: () => Promise<void>
+  onStarting: () => Promise<void>
+  onStopped: () => Promise<void>
+  onStopping: () => Promise<void>
+  replContext: () => Record<string, unknown>
+}
+
+class PresenceChannel = {
+  new (name: string, _socket: Socket): PresenceChannel
+  _dispatch: (frame: ServerFrame) => void
+  error: (cb: Listener) => PresenceChannel
+  here: (cb: (members: PresenceMember[]) => void) => PresenceChannel
+  joining: (cb: (member: PresenceMember) => void) => PresenceChannel
+  leaving: (cb: (member: PresenceMember) => void) => PresenceChannel
+  listen: (event: string, cb: Listener) => PresenceChannel
+  readonly name: string
+  stopListening: (event: string, cb?: Listener) => PresenceChannel
+  subscribed: (cb: Listener) => PresenceChannel
+  unsubscribe: () => void
+}
+
+class Socket = {
+  new (options?: SocketOptions): Socket
+  channel: (name: string) => Channel
+  channels: () => Channel[]
+  connect: () => void
+  disconnect: () => void
+  join: (name: string) => PresenceChannel
+  leave: (name: string) => void
+  leaveChannel: (wireName: string) => void
+  on: (state: SocketState, cb: (detail?: unknown) => void) => () => void
+  presence: (name: string) => PresenceChannel
+  private: (name: string) => Channel
+  socketId: () => string | null
+  state: SocketState
+}
+
+class ValidationError = {
+  new (statusText: string, body: string, errors: Record<string, string[]>, validationMessage: string, headers?: Headers): ValidationError
+  all: () => Record<string, string[]>
+  fields: () => string[]
+  first: (field: string) => string | undefined
+  has: (field: string) => boolean
+  readonly body: string
+  readonly code: string
+  readonly context?: Record<string, unknown> | undefined
+  readonly errors: Record<string, string[]>
+  readonly headers: Headers | undefined
+  readonly status: number
+  readonly statusText: string
+  readonly validationMessage: string
+  retryAfterMs: number | null
+}
+
+const Client = ApiClient<Partial<Record<`GET ${string}` | `POST ${string}` | `PUT ${string}` | `PATCH ${string}` | `DELETE ${string}`, RouteShape>>>
+
+function ClientConfig = (options?: Partial<ClientConfigShape>) => Partial<ClientConfigShape>
+
+function createApiClient = <Routes extends ApiRouteMap>(config?: ApiClientConfig) => ApiClient<Routes>
+
+interface ApiClientConfig = {
+  baseUrl?: string
+  circuitBreaker?: CircuitBreaker | CircuitBreakerOptions
+  csrf?: boolean | {    cookie?: string;    header?: string;}
+  headers?: Record<string, string>
+  onError?: (error: ApiClientError) => void | Promise<void>
+  onForbidden?: (error: ApiClientError) => void | Promise<void>
+  onRequest?: RequestInterceptor | RequestInterceptor[]
+  onResponse?: ResponseInterceptor | ResponseInterceptor[]
+  onUnauthorized?: (error: ApiClientError, retry: (headerOverrides?: Record<string, string>) => Promise<unknown>) => Promise<unknown> | void
+  retry?: number | RetryOptions
+  timeout?: number
+  token?: TokenSource
+  withCredentials?: boolean
+}
+
+interface CircuitBreakerOptions = {
+  isFailure?: (error: unknown) => boolean
+  resetTimeout?: number
+  threshold?: number
+}
+
+interface ClientConfigShape = {
+  baseUrl?: string
+  circuitBreaker?: CircuitBreaker | CircuitBreakerOptions
+  csrf?: boolean | {    cookie?: string;    header?: string;}
+  headers?: Record<string, string>
+  onError?: (error: ApiClientError) => void | Promise<void>
+  onForbidden?: (error: ApiClientError) => void | Promise<void>
+  onRequest?: RequestInterceptor | RequestInterceptor[]
+  onResponse?: ResponseInterceptor | ResponseInterceptor[]
+  onUnauthorized?: (error: ApiClientError, retry: (headerOverrides?: Record<string, string>) => Promise<unknown>) => Promise<unknown> | void
+  retry?: number | RetryOptions
+  timeout?: number
+  token?: TokenSource
+  withCredentials?: boolean
+}
+
+interface GetOptions = {
+  headers?: Record<string, string>
+  init?: Omit<RequestInit, 'method' | 'headers' | 'body'>
+  meta?: (meta: ResponseMeta) => void
+  query?: Q
+  responseType?: 'text' | 'json' | 'auto' | 'blob' | 'arrayBuffer'
+  retry?: number | false | RetryOptions
+  signal?: AbortSignal
+  timeout?: number
+}
+
+interface MutationOptions = {
+  headers?: Record<string, string>
+  init?: Omit<RequestInit, 'method' | 'headers' | 'body'>
+  meta?: (meta: ResponseMeta) => void
+  params?: Record<string, string | number>
+  query?: Q
+  responseType?: 'text' | 'json' | 'auto' | 'blob' | 'arrayBuffer'
+  retry?: number | false | RetryOptions
+  signal?: AbortSignal
+  timeout?: number
+}
+
+interface PresenceMember = {
+  id: string | number
+  info: Record<string, unknown>
+}
+
+interface RequestConfig = {
+  body: BodyInit | undefined
+  headers: Record<string, string>
+  method: string
+  url: string
+}
+
+interface RequestOptions = {
+  headers?: Record<string, string>
+  init?: Omit<RequestInit, 'method' | 'headers' | 'body'>
+  meta?: (meta: ResponseMeta) => void
+  responseType?: 'text' | 'json' | 'auto' | 'blob' | 'arrayBuffer'
+  retry?: number | false | RetryOptions
+  signal?: AbortSignal
+  timeout?: number
+}
+
+interface ResponseContext = {
+  data: unknown
+  headers: Headers
+  request: RequestConfig
+  status: number
+}
+
+interface ResponseMeta = {
+  headers: Headers
+  status: number
+}
+
+interface RetryOptions = {
+  attempts?: number
+  backoff?: (attempt: number, retryAfterMs: number | null) => number
+  methods?: string[]
+  respectRetryAfter?: boolean
+  statuses?: number[]
+}
+
+interface RouteShape = {
+  body?: Record<string, unknown>
+  params?: Record<string, string | number>
+  query?: Record<string, string | number | boolean | undefined>
+  response?: unknown
+}
+
+interface SocketLike = {
+  close: (code?: number, reason?: string) => void
+  onclose: ((ev: {    code?: number;    reason?: string;}) => void) | null
+  onerror: ((ev: unknown) => void) | null
+  onmessage: ((ev: {    data: unknown;}) => void) | null
+  onopen: ((ev: unknown) => void) | null
+  readyState: number
+  send: (data: string) => void
+}
+
+interface SocketOptions = {
+  WebSocket?: new (url: string) => SocketLike
+  auth?: {    params?: Record<string, string>;    headers?: Record<string, string>;}
+  authEndpoint?: string | false
+  autoConnect?: boolean
+  fetch?: typeof fetch
+  host?: string
+  maxReconnectDelay?: number
+  path?: string
+  pingInterval?: number
+  port?: string | number
+  reconnect?: boolean
+  reconnectDelay?: number
+  scheme?: 'ws' | 'wss'
+  url?: string
+}
+
+type ApiRouteMap = {    [x: `GET ${string}`]: RouteShape | undefined;    [x: `POST ${string}`]: RouteShape | undefined;    [x: `PUT ${string}`]: RouteShape | undefined;    [x: `PATCH ${string}`]: RouteShape | undefined;    [x: `DELETE ${string}`]: RouteShape | undefined;}
+
+type BodyOf = `${Method} ${Path}` extends keyof Routes ? Routes[`${Method} ${Path}`] extends {    body: infer B;} ? B : Record<string, unknown> : Record<string, unknown>
+
+type CircuitState = 'closed' | 'open' | 'half-open'
+
+type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'
+
+type ParamRecord = [PathParams<Path>] extends [never] ? undefined : { [K in PathParams<Path>]: string | number; }
+
+type PathParams = Path extends `${string}{${infer Param}}${infer Tail}` ? Param | PathParams<Tail> : never
+
+type PathsFor = { [K in keyof Routes & string]: K extends `${Method} ${infer Path}` ? Path : never; }[keyof Routes & string]
+
+type QueryOf = `${Method} ${Path}` extends keyof Routes ? Routes[`${Method} ${Path}`] extends {    query: infer Q;} ? Q : Record<string, string | number | boolean | undefined> : Record<string, string | number | boolean | undefined>
+
+type RequestInterceptor = (config: RequestConfig) => RequestConfig | Promise<RequestConfig>
+
+type ResponseInterceptor = (ctx: ResponseContext) => ResponseContext | Promise<ResponseContext>
+
+type ResponseOf = `${Method} ${Path}` extends keyof Routes ? Routes[`${Method} ${Path}`] extends {    response: infer R;} ? R : unknown : unknown
+
+type SocketState = 'error' | 'connecting' | 'connected' | 'disconnected' | 'reconnecting'
+
+type TokenSource = string | (() => string | null | undefined | Promise<string | null | undefined>)
+
+## ./Socket  `(./src/Socket.ts)`
+
+class Channel = {
+  new (name: string, _socket: Socket): Channel
+  _dispatch: (frame: ServerFrame) => void
+  error: (cb: Listener) => Channel
+  listen: (event: string, cb: Listener) => Channel
+  readonly name: string
+  stopListening: (event: string, cb?: Listener) => Channel
+  subscribed: (cb: Listener) => Channel
+  unsubscribe: () => void
+}
+
+class PresenceChannel = {
+  new (name: string, _socket: Socket): PresenceChannel
+  _dispatch: (frame: ServerFrame) => void
+  error: (cb: Listener) => PresenceChannel
+  here: (cb: (members: PresenceMember[]) => void) => PresenceChannel
+  joining: (cb: (member: PresenceMember) => void) => PresenceChannel
+  leaving: (cb: (member: PresenceMember) => void) => PresenceChannel
+  listen: (event: string, cb: Listener) => PresenceChannel
+  readonly name: string
+  stopListening: (event: string, cb?: Listener) => PresenceChannel
+  subscribed: (cb: Listener) => PresenceChannel
+  unsubscribe: () => void
+}
+
+class Socket = {
+  new (options?: SocketOptions): Socket
+  channel: (name: string) => Channel
+  channels: () => Channel[]
+  connect: () => void
+  disconnect: () => void
+  join: (name: string) => PresenceChannel
+  leave: (name: string) => void
+  leaveChannel: (wireName: string) => void
+  on: (state: SocketState, cb: (detail?: unknown) => void) => () => void
+  presence: (name: string) => PresenceChannel
+  private: (name: string) => Channel
+  socketId: () => string | null
+  state: SocketState
+}
+
+interface PresenceMember = {
+  id: string | number
+  info: Record<string, unknown>
+}
+
+interface SocketLike = {
+  close: (code?: number, reason?: string) => void
+  onclose: ((ev: {    code?: number;    reason?: string;}) => void) | null
+  onerror: ((ev: unknown) => void) | null
+  onmessage: ((ev: {    data: unknown;}) => void) | null
+  onopen: ((ev: unknown) => void) | null
+  readyState: number
+  send: (data: string) => void
+}
+
+interface SocketOptions = {
+  WebSocket?: new (url: string) => SocketLike
+  auth?: {    params?: Record<string, string>;    headers?: Record<string, string>;}
+  authEndpoint?: string | false
+  autoConnect?: boolean
+  fetch?: typeof fetch
+  host?: string
+  maxReconnectDelay?: number
+  path?: string
+  pingInterval?: number
+  port?: string | number
+  reconnect?: boolean
+  reconnectDelay?: number
+  scheme?: 'ws' | 'wss'
+  url?: string
+}
+
+type SocketState = 'error' | 'connecting' | 'connected' | 'disconnected' | 'reconnecting'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerotal/client",
-  "version": "1.6.3",
+  "version": "1.7.2",
   "license": "MIT",
   "maturity": "stable",
   "private": false,
@@ -8,11 +8,16 @@
   "main": "./src/index.ts",
   "types": "./src/index.ts",
   "exports": {
-    ".": "./src/index.ts",
-    "./Socket": "./src/Socket.ts"
+    ".": {
+      "browser": "./src/browser.ts",
+      "default": "./src/index.ts"
+    },
+    "./Socket": "./src/Socket.ts",
+    "./provider": "./src/provider/ClientProvider.ts"
   },
   "files": [
     "CHANGELOG.md",
+    "api-surface.md",
     "src",
     "!src/**/*.test.ts",
     "!src/**/*.test.tsx",
@@ -30,7 +35,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@zerotal/core": "1.6.3"
+    "@zerotal/core": "1.7.2"
   },
   "devDependencies": {
     "typescript": "^5.8.0"

package/src/CircuitBreaker.ts

@@ -1,4 +1,4 @@
-import { ZerotalError } from "@zerotal/core";
+import { ZerotalError } from "@zerotal/core/errors";
 import { ApiClientError } from "./ApiClient.ts";
 
 // ── Types ─────────────────────────────────────────────────────────────────────

package/src/Socket.ts

@@ -4,7 +4,7 @@
 // broadcasting protocol (the `ws` / `redis` drivers) and exposes a familiar
 // realtime-client API — the same `channel()/private()/join()/leave()` +
 // `listen()/here()/joining()/leaving()` surface — so it works with `@zerotal/flow`'s
-// `@on('echo:…')` listeners with zero external dependencies.
+// `@on('socket:…')` listeners with zero external dependencies.
 //
 //   import { Socket } from "@zerotal/client";
 //
@@ -335,14 +335,14 @@ export class Socket {
     return this._subscribe(wire, () => new PresenceChannel(wire, this)) as PresenceChannel;
   }
 
-  /** Echo alias for {@link presence} (`window.Echo.join(...)`). */
+  /** Alias for {@link presence} (`window.Socket.join(...)`). */
   join(name: string): PresenceChannel {
     return this.presence(name);
   }
 
   /**
    * Leave a channel by its base name — unsubscribes the public, `private-`, and `presence-`
-   * variants (Echo's `leave()` semantics).
+   * variants, which is what `leave()` means here.
    */
   leave(name: string): void {
     this.leaveChannel(name);

package/src/browser.ts

@@ -0,0 +1,54 @@
+/**
+ * The browser-safe half of this package.
+ *
+ * Resolved for `import … from "@zerotal/client"` under the `browser` export
+ * condition, so a bundler targeting a browser gets this file and a Bun/Node
+ * import gets `index.ts` unchanged. Nobody has to know: the documented import
+ * is the same either way.
+ *
+ * What it leaves out is `ClientProvider` and `ClientConfig` — the two things
+ * here that are genuinely server-side. `ClientProvider` extends core's
+ * `ServiceProvider`, which reaches `CommandRunner`, which reaches the built-in
+ * CLI commands, one of which does `await import("bun")`. That is a hard error in
+ * a browser build and it happens during *resolution*, so tree-shaking never gets
+ * a chance to drop the unused half. The whole package became unbundleable
+ * because of one export nobody in a browser wanted.
+ *
+ * The rule this encodes: `@zerotal/core`'s root entry is server-only. A module
+ * that can run in a browser imports from a narrow subpath — `@zerotal/core/errors`,
+ * `@zerotal/core/helpers` — and never from the root.
+ */
+export type {
+  ApiRouteMap,
+  RouteShape,
+  HttpMethod,
+  PathParams,
+  ParamRecord,
+  PathsFor,
+  ResponseOf,
+  BodyOf,
+  QueryOf,
+} from "./types.ts";
+
+export { ApiClient, ApiClientError, ValidationError } from "./ApiClient.ts";
+export type {
+  ApiClientConfig,
+  RequestConfig,
+  RequestInterceptor,
+  ResponseContext,
+  ResponseInterceptor,
+  ResponseMeta,
+  RequestOptions,
+  GetOptions,
+  MutationOptions,
+  TokenSource,
+  RetryOptions,
+} from "./ApiClient.ts";
+
+export { CircuitBreaker, CircuitBreakerOpenError } from "./CircuitBreaker.ts";
+export type { CircuitBreakerOptions, CircuitState } from "./CircuitBreaker.ts";
+
+export { Socket, Channel, PresenceChannel } from "./Socket.ts";
+export type { SocketOptions, SocketState, SocketLike, PresenceMember } from "./Socket.ts";
+
+export { createApiClient } from "./createApiClient.ts";

package/src/config.ts

@@ -1,4 +1,4 @@
-import { deepMerge } from "@zerotal/core";
+import { deepMerge } from "@zerotal/core/helpers";
 import type { ApiClientConfig } from "./ApiClient.ts";
 
 export interface ClientConfigShape extends ApiClientConfig {

package/src/createApiClient.ts

@@ -0,0 +1,36 @@
+// ── Factory function ──────────────────────────────────────────────────────────
+//
+// Its own module rather than a member of `index.ts`, so the browser entry can
+// re-export it without pulling the server half of the barrel back in. That is
+// not hypothetical tidiness: `browser.ts` originally took it from `index.ts`,
+// which re-imported `ClientProvider` and put the bundle straight back into the
+// error this split exists to remove.
+
+import { ApiClient } from "./ApiClient.ts";
+import type { ApiRouteMap } from "./types.ts";
+import type { ApiClientConfig } from "./ApiClient.ts";
+
+/**
+ * Create a type-safe API client bound to your route map.
+ *
+ * @example
+ * // frontend/api.ts
+ * import { createApiClient } from '@zerotal/client';
+ * import type { Routes } from './routes';
+ *
+ * export const api = createApiClient<Routes>({
+ *   baseUrl: '/api',
+ *   headers: { 'X-Requested-With': 'XMLHttpRequest' },
+ * });
+ *
+ * // Anywhere in your UI:
+ * const user = await api.get('/users/{id}', { id: 1 });
+ * //    ^? UserResource  (inferred from Routes)
+ *
+ * const newUser = await api.post('/users', { name: 'Alice', email: 'alice@ex.com' });
+ */
+export function createApiClient<Routes extends ApiRouteMap>(
+  config: ApiClientConfig = {},
+): ApiClient<Routes> {
+  return new ApiClient<Routes>(config);
+}

package/src/errors.ts

@@ -1,4 +1,4 @@
-import { ZerotalError } from "@zerotal/core";
+import { ZerotalError } from "@zerotal/core/errors";
 
 /**
  * Thrown for any non-2xx HTTP response.

package/src/index.ts

@@ -36,33 +36,4 @@ export { ClientProvider, Client } from "./provider/ClientProvider.ts";
 export { ClientConfig } from "./config.ts";
 export type { ClientConfigShape } from "./config.ts";
 
-// ── Factory function ──────────────────────────────────────────────────────────
-
-import { ApiClient } from "./ApiClient.ts";
-import type { ApiRouteMap } from "./types.ts";
-import type { ApiClientConfig } from "./ApiClient.ts";
-
-/**
- * Create a type-safe API client bound to your route map.
- *
- * @example
- * // frontend/api.ts
- * import { createApiClient } from '@zerotal/client';
- * import type { Routes } from './routes';
- *
- * export const api = createApiClient<Routes>({
- *   baseUrl: '/api',
- *   headers: { 'X-Requested-With': 'XMLHttpRequest' },
- * });
- *
- * // Anywhere in your UI:
- * const user = await api.get('/users/{id}', { id: 1 });
- * //    ^? UserResource  (inferred from Routes)
- *
- * const newUser = await api.post('/users', { name: 'Alice', email: 'alice@ex.com' });
- */
-export function createApiClient<Routes extends ApiRouteMap>(
-  config: ApiClientConfig = {},
-): ApiClient<Routes> {
-  return new ApiClient<Routes>(config);
-}
+export { createApiClient } from "./createApiClient.ts";