@vibesdotdev/client 0.1.0

package/SPEC.md

@@ -0,0 +1,107 @@
+# Client Package SPEC
+
+**Status:** Production
+**Package:** `@vibesdotdev/client`
+**Location:** `packages/client`
+
+## Overview
+
+Base API client with runtime kind integration and per-app client factories. Wraps `@vibesdotdev/kit`'s VibesClient with a standardized `ApiClientImplementation` interface and registers `api/client` as a runtime kind for descriptor-based client resolution.
+
+## Architecture
+
+```
++-----------------------------------------------------------------------+
+|                        Client Package                                 |
++-----------------------------------------------------------------------+
+|  FACTORY                                                              |
+|  -------                                                              |
+|  vibesApiClient(config)    -> Create API client from config           |
+|  fromVibesClient(client)   -> Wrap existing VibesClient               |
+|  ApiClientConfig           -> baseUrl, auth, fetch, timeout, headers  |
++-----------------------------------------------------------------------+
+|  SCHEMAS                                                              |
+|  -------                                                              |
+|  ApiClientDescriptor       -> Runtime descriptor for api/client kind  |
+|    kind: 'api/client'      -> Runtime kind identifier                 |
+|    baseUrl, timeout, debug -> Per-client configuration                |
+|  ApiClientImplementation   -> Standard interface: get/post/put/delete |
+|  ApiRequestOptions         -> query, headers, timeout, params         |
++-----------------------------------------------------------------------+
+|  RUNTIME PLUGIN                                                       |
+|  --------------                                                       |
+|  clientPlugin              -> Registers 'api/client' kind             |
+|  DefaultApiClient          -> Default implementation from descriptor  |
+|  Runtime query:                                                       |
+|    runtime.query('api/client').withId('auth').resolve()               |
++-----------------------------------------------------------------------+
+```
+
+## Key Exports
+
+### Factory (`@vibesdotdev/client` or `@vibesdotdev/client/factory`)
+- `vibesApiClient(config?)` -- Create new API client instance
+- `fromVibesClient(client)` -- Wrap existing VibesClient
+- `ApiClientConfig` -- Configuration type
+
+### Schemas (`@vibesdotdev/client/schemas`)
+- `ApiClientDescriptor` -- Runtime descriptor interface
+- `ApiClientDescriptorSchema` -- Zod validation schema
+- `ApiClientImplementation` -- Standard client interface (get/post/put/delete/request)
+- `ApiRequestOptions` -- Per-request options (query, headers, timeout, params)
+
+### Plugin (`@vibesdotdev/client/plugin`)
+- `clientPlugin` -- Runtime plugin registering `api/client` kind
+- Enables `runtime.query('api/client').withId('auth').resolve()`
+
+## ApiClientImplementation Interface
+
+```typescript
+interface ApiClientImplementation {
+  get<T>(endpoint: string, options?: ApiRequestOptions): Promise<T>;
+  post<T>(endpoint: string, body?: unknown, options?: ApiRequestOptions): Promise<T>;
+  put<T>(endpoint: string, body?: unknown, options?: ApiRequestOptions): Promise<T>;
+  delete<T>(endpoint: string, options?: ApiRequestOptions): Promise<T>;
+  request<T>(endpoint: string, options?: ApiRequestOptions & { method?: string; body?: unknown }): Promise<T>;
+}
+```
+
+## Runtime Integration
+
+The plugin registers `api/client` as a runtime kind. Apps register descriptors:
+
+```typescript
+// auth-client.client-api.descriptor.ts
+export default {
+  id: 'auth',
+  kind: 'api/client',
+  baseUrl: 'https://auth.vibes.dev',
+  timeout: 10000
+};
+```
+
+Other packages resolve clients via the runtime:
+
+```typescript
+const authClient = await runtime.query('api/client').withId('auth').resolve();
+const session = await authClient.get('/api/session');
+```
+
+## Done Means
+
+- [ ] `vibesApiClient` creates working clients with proper auth, headers, and timeout
+- [ ] `fromVibesClient` correctly wraps VibesClient to ApiClientImplementation
+- [ ] Custom headers hook applies headers to all requests
+- [ ] Runtime plugin registers `api/client` kind and resolves descriptors
+- [ ] DefaultApiClient constructs from descriptor config (baseUrl, timeout, debug)
+- [ ] All HTTP methods (GET, POST, PUT, DELETE, generic request) work correctly
+- [ ] ApiRequestOptions supports query params, custom headers, and timeout override
+- [ ] Error handling propagates HTTP errors with useful context
+- [ ] Tests cover factory creation, plugin registration, and request lifecycle
+
+## Dependencies
+
+- `@vibesdotdev/kit` -- VibesClient base class and client types
+- `@vibesdotdev/runtime` -- Runtime plugin registration and kind system
+- `@vibesdotdev/logging` -- Structured logging
+- `zod` -- Schema validation for descriptors

package/dist/factory.d.ts

@@ -0,0 +1,34 @@
+import { VibesClient } from './lib/client/core.ts';
+import type { AuthConfig } from './lib/client/types.ts';
+import type { ApiClientImplementation } from './schemas.ts';
+export interface ApiClientConfig {
+    /** Unique identifier for this client instance */
+    id?: string;
+    /** Base URL for API requests */
+    baseUrl?: string;
+    /** Authentication configuration */
+    auth?: AuthConfig;
+    /** Custom fetch implementation */
+    fetch?: typeof fetch;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Custom headers applied to all requests */
+    headers?: Record<string, string>;
+}
+/**
+ * Create an API client instance.
+ *
+ * @example
+ * ```ts
+ * const client = vibesApiClient({ baseUrl: 'https://api.vibes.dev' });
+ * const data = await client.get('/users');
+ * ```
+ */
+export declare function vibesApiClient(config?: ApiClientConfig): ApiClientImplementation;
+/**
+ * Create an API client from an existing VibesClient instance.
+ */
+export declare function fromVibesClient(client: VibesClient): ApiClientImplementation;
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAgB,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EACX,uBAAuB,EAIvB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,eAAe;IAC/B,iDAAiD;IACjD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,kCAAkC;IAClC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AA+CD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,MAAM,GAAE,eAAoB,GAAG,uBAAuB,CA0BpF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,uBAAuB,CAE5E"}

package/dist/factory.js

@@ -0,0 +1,80 @@
+import { VibesClient } from "./lib/client/core.js";
+/**
+ * Wrap a VibesClient to satisfy the ApiClientImplementation interface.
+ */
+function wrapVibesClient(client) {
+    return {
+        get(endpoint, options) {
+            return client.get(endpoint, { method: 'GET', path: endpoint, ...options });
+        },
+        post(endpoint, body, options) {
+            return client.post(endpoint, body, { method: 'POST', path: endpoint, ...options });
+        },
+        put(endpoint, body, options) {
+            return client.put(endpoint, body, { method: 'PUT', path: endpoint, ...options });
+        },
+        patch(endpoint, body, options) {
+            return client.request(endpoint, { method: 'PATCH', body, ...options });
+        },
+        delete(endpoint, options) {
+            return client.delete(endpoint, { method: 'DELETE', path: endpoint, ...options });
+        },
+        request(endpoint, options) {
+            return client.request(endpoint, {
+                method: options?.method ?? 'GET',
+                ...options
+            });
+        },
+        stream(endpoint, options) {
+            return client.stream(endpoint, {
+                method: options?.method ?? 'POST',
+                body: options?.body,
+                headers: options?.headers,
+                params: options?.params,
+                query: options?.query,
+                timeout: options?.timeout
+            });
+        }
+    };
+}
+/**
+ * Create an API client instance.
+ *
+ * @example
+ * ```ts
+ * const client = vibesApiClient({ baseUrl: 'https://api.vibes.dev' });
+ * const data = await client.get('/users');
+ * ```
+ */
+export function vibesApiClient(config = {}) {
+    const clientConfig = {
+        baseUrl: config.baseUrl,
+        auth: config.auth,
+        fetch: config.fetch,
+        timeout: config.timeout,
+        debug: config.debug
+    };
+    if (config.headers && Object.keys(config.headers).length > 0) {
+        const headers = config.headers;
+        clientConfig.hooks = {
+            beforeRequest: async (request) => {
+                const updated = new Headers(request.headers);
+                for (const [key, value] of Object.entries(headers)) {
+                    if (value !== undefined) {
+                        updated.set(key, value);
+                    }
+                }
+                return new Request(request, { headers: updated });
+            }
+        };
+    }
+    const vibes = new VibesClient(clientConfig);
+    return wrapVibesClient(vibes);
+}
+/**
+ * Create an API client from an existing VibesClient instance.
+ */
+export function fromVibesClient(client) {
+    return wrapVibesClient(client);
+}
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { vibesApiClient, fromVibesClient } from './factory.ts';
+export type { ApiClientConfig } from './factory.ts';
+export type { ApiClientDescriptor, ApiClientImplementation, ApiRequestOptions, ApiStreamOptions, ApiStreamEvent } from './schemas.ts';
+export { ApiClientDescriptorSchema } from './schemas.ts';
+export { default as clientPlugin } from './plugin.ts';
+export { SSEClient, createSSEClient } from './sse-client.ts';
+export type { SSEClientOptions, SSEConnectionStatus } from './sse-client.ts';
+export { VibesClient } from './lib/client/core.ts';
+export type { ClientConfig, AuthConfig, ClientHooks, ClientError } from './lib/client/types.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/D,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,YAAY,EACX,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { vibesApiClient, fromVibesClient } from "./factory.js";
+export { ApiClientDescriptorSchema } from "./schemas.js";
+export { default as clientPlugin } from "./plugin.js";
+export { SSEClient, createSSEClient } from "./sse-client.js";
+export { VibesClient } from "./lib/client/core.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAS/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/lib/client/core.d.ts

@@ -0,0 +1,8 @@
+export { VibesClient } from './internal/vibes-client.ts';
+export type { SSEEvent } from './internal/sse-stream.ts';
+export type { ClientConfig, AuthConfig, ClientHooks, ClientUser, RequestOptions } from './types.ts';
+export { ClientError } from './types.ts';
+export { BaseAPIClient } from './internal/base-client.ts';
+export type { BaseAPIConfig, EndpointOptions } from './internal/base-types.ts';
+export { Endpoint } from './internal/endpoint.ts';
+//# sourceMappingURL=core.d.ts.map

package/dist/lib/client/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/lib/client/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,YAAY,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,YAAY,EACX,YAAY,EACZ,UAAU,EACV,WAAW,EACX,UAAU,EACV,cAAc,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/lib/client/core.js

@@ -0,0 +1,5 @@
+export { VibesClient } from "./internal/vibes-client.js";
+export { ClientError } from "./types.js";
+export { BaseAPIClient } from "./internal/base-client.js";
+export { Endpoint } from "./internal/endpoint.js";
+//# sourceMappingURL=core.js.map

package/dist/lib/client/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/lib/client/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AASzD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/lib/client/internal/base-client.d.ts

@@ -0,0 +1,19 @@
+import { type BaseAPIConfig, type EndpointOptions } from './base-types.ts';
+import { Endpoint } from './endpoint.ts';
+export declare abstract class BaseAPIClient {
+    protected config: Required<Omit<BaseAPIConfig, 'auth'>> & {
+        auth: BaseAPIConfig['auth'];
+    };
+    private abortControllers;
+    constructor(config: BaseAPIConfig);
+    protected endpoint(path: string): Endpoint;
+    request<T = unknown>(request: {
+        method: string;
+        path: string;
+        body?: unknown;
+    } & EndpointOptions<T>): Promise<T>;
+    cancelAll(): void;
+    setAuth(auth: BaseAPIConfig['auth']): void;
+    updateConfig(config: Partial<BaseAPIConfig>): void;
+}
+//# sourceMappingURL=base-client.d.ts.map

package/dist/lib/client/internal/base-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-client.d.ts","sourceRoot":"","sources":["../../../../src/lib/client/internal/base-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAY,MAAM,iBAAiB,CAAC;AAErF,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,8BAAsB,aAAa;IAClC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,GAAG;QACzD,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;KAC5B,CAAC;IACF,OAAO,CAAC,gBAAgB,CAA8B;gBAE1C,MAAM,EAAE,aAAa;IAiBjC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAKpC,OAAO,CAAC,CAAC,GAAG,OAAO,EACxB,OAAO,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,OAAO,CAAC;KACf,GAAG,eAAe,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC,CAAC,CAAC;IAwDb,SAAS,IAAI,IAAI;IAKjB,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI;IAI1C,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;CAGlD"}

package/dist/lib/client/internal/base-client.js

@@ -0,0 +1,92 @@
+import { APIError } from "./base-types.js";
+import { buildHeaders, buildUrl, createApiError } from "./base-helpers.js";
+import { Endpoint } from "./endpoint.js";
+export class BaseAPIClient {
+    config;
+    abortControllers = new Set();
+    constructor(config) {
+        const merged = {
+            baseUrl: config.baseUrl,
+            fetch: (config.fetch || globalThis.fetch?.bind(globalThis)),
+            headers: config.headers || {},
+            timeout: config.timeout || 30000,
+            debug: config.debug || false,
+            hooks: config.hooks || {},
+            auth: config.auth ?? null
+        };
+        if (!merged.fetch)
+            throw new Error('Fetch is not available. Please provide a fetch implementation.');
+        this.config = merged;
+    }
+    endpoint(path) {
+        const cleanPath = path.startsWith('/') ? path : `/${path}`;
+        return new Endpoint(this, cleanPath);
+    }
+    async request(request) {
+        const url = buildUrl(this.config.baseUrl, request.path, request.query);
+        const controller = new AbortController();
+        this.abortControllers.add(controller);
+        try {
+            const authForHeaders = this.config.auth ?? { type: 'none' };
+            const headers = await buildHeaders({
+                auth: authForHeaders,
+                headers: { ...this.config.headers, ...request.headers },
+                includeJsonDefaults: request.body !== undefined
+            });
+            const init = {
+                method: request.method,
+                headers,
+                signal: controller.signal
+            };
+            const timeout = setTimeout(() => controller.abort(), request.timeout ?? this.config.timeout);
+            if (request.body !== undefined)
+                init.body = JSON.stringify(request.body);
+            let req = new Request(url.toString(), init);
+            if (this.config.hooks?.beforeRequest)
+                req = await this.config.hooks.beforeRequest(req);
+            const response = await this.config.fetch(req, init);
+            clearTimeout(timeout);
+            const finalResponse = this.config.hooks?.afterResponse
+                ? await this.config.hooks.afterResponse(response)
+                : response;
+            if (!finalResponse.ok) {
+                const error = await createApiError(finalResponse, req);
+                if (this.config.hooks?.onError)
+                    await this.config.hooks.onError(error);
+                throw error;
+            }
+            let data;
+            if (finalResponse.status === 204 || finalResponse.headers.get('Content-Length') === '0')
+                data = undefined;
+            else if (finalResponse.headers.get('Content-Type')?.includes('application/json'))
+                data = await finalResponse.json();
+            else
+                data = await finalResponse.text();
+            if (request.transform)
+                data = request.transform(data);
+            if (request.schema) {
+                const result = request.schema.safeParse(data);
+                if (!result.success) {
+                    throw new APIError(`Response validation failed: ${result.error.message}`, 422, finalResponse, req, data);
+                }
+                return result.data;
+            }
+            return data;
+        }
+        finally {
+            this.abortControllers.delete(controller);
+        }
+    }
+    cancelAll() {
+        for (const controller of this.abortControllers)
+            controller.abort();
+        this.abortControllers.clear();
+    }
+    setAuth(auth) {
+        this.config.auth = auth ?? null;
+    }
+    updateConfig(config) {
+        Object.assign(this.config, config);
+    }
+}
+//# sourceMappingURL=base-client.js.map

package/dist/lib/client/internal/base-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-client.js","sourceRoot":"","sources":["../../../../src/lib/client/internal/base-client.ts"],"names":[],"mappings":"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"}

package/dist/lib/client/internal/base-helpers.d.ts

@@ -0,0 +1,9 @@
+import { type BaseAPIConfig, type EndpointOptions, APIError } from './base-types.ts';
+export declare function buildUrl(baseUrl: string, path: string, query?: EndpointOptions['query']): URL;
+export declare function buildHeaders(args: {
+    auth: NonNullable<BaseAPIConfig['auth']>;
+    headers: Record<string, string>;
+    includeJsonDefaults: boolean;
+}): Promise<Headers>;
+export declare function createApiError(response: Response, request: Request): Promise<APIError>;
+//# sourceMappingURL=base-helpers.d.ts.map

package/dist/lib/client/internal/base-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-helpers.d.ts","sourceRoot":"","sources":["../../../../src/lib/client/internal/base-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAErF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,GAAG,CAU7F;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACxC,IAAI,EAAE,WAAW,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;IACzC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,mBAAmB,EAAE,OAAO,CAAC;CAC7B,GAAG,OAAO,CAAC,OAAO,CAAC,CAgCnB;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAqB5F"}

package/dist/lib/client/internal/base-helpers.js

@@ -0,0 +1,79 @@
+import { APIError } from "./base-types.js";
+export function buildUrl(baseUrl, path, query) {
+    const url = new URL(path, baseUrl);
+    if (query) {
+        for (const [key, value] of Object.entries(query)) {
+            if (value === undefined)
+                continue;
+            if (Array.isArray(value))
+                value.forEach((v) => url.searchParams.append(key, String(v)));
+            else
+                url.searchParams.set(key, String(value));
+        }
+    }
+    return url;
+}
+export async function buildHeaders(args) {
+    const requestHeaders = new Headers(args.headers);
+    if (args.includeJsonDefaults && !requestHeaders.has('Content-Type')) {
+        requestHeaders.set('Content-Type', 'application/json');
+    }
+    if (!requestHeaders.has('Accept'))
+        requestHeaders.set('Accept', 'application/json');
+    const auth = args.auth;
+    if (auth) {
+        const token = auth.credentials || (await auth.provider?.());
+        if (token) {
+            switch (auth.type) {
+                case 'bearer':
+                    requestHeaders.set('Authorization', `Bearer ${token}`);
+                    break;
+                case 'apiKey': {
+                    const headerName = auth.headerName || 'X-API-Key';
+                    requestHeaders.set(headerName, token);
+                    break;
+                }
+                case 'basic':
+                    requestHeaders.set('Authorization', `Basic ${token}`);
+                    break;
+                case 'custom':
+                    if (auth.headerName && auth.prefix) {
+                        requestHeaders.set(auth.headerName, `${auth.prefix} ${token}`);
+                    }
+                    break;
+            }
+        }
+    }
+    return requestHeaders;
+}
+export async function createApiError(response, request) {
+    let message = `${response.status} ${response.statusText}`;
+    let body;
+    try {
+        const contentType = response.headers.get('Content-Type');
+        if (contentType?.includes('application/json')) {
+            body = await response.json();
+            if (typeof body === 'object' && body !== null) {
+                const errorBody = body;
+                if (typeof errorBody.message === 'string')
+                    message = errorBody.message;
+                else if (typeof errorBody.error === 'string')
+                    message = errorBody.error;
+                else if (errorBody.error !== undefined)
+                    message = JSON.stringify(errorBody.error);
+            }
+        }
+        else {
+            const text = await response.text();
+            if (text) {
+                message = text;
+                body = text;
+            }
+        }
+    }
+    catch {
+        // ignore parsing errors
+    }
+    return new APIError(message, response.status, response, request, body);
+}
+//# sourceMappingURL=base-helpers.js.map

package/dist/lib/client/internal/base-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-helpers.js","sourceRoot":"","sources":["../../../../src/lib/client/internal/base-helpers.ts"],"names":[],"mappings":"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"}

package/dist/lib/client/internal/base-types.d.ts

@@ -0,0 +1,35 @@
+import type { z } from 'zod/v4';
+export interface BaseAPIConfig {
+    baseUrl: string;
+    fetch?: typeof fetch;
+    headers?: Record<string, string>;
+    timeout?: number;
+    auth?: {
+        type: 'none' | 'bearer' | 'apiKey' | 'basic' | 'custom';
+        credentials?: string;
+        headerName?: string;
+        prefix?: string;
+        provider?: () => Promise<string | null>;
+    } | null;
+    debug?: boolean;
+    hooks?: {
+        beforeRequest?: (request: Request) => Promise<Request> | Request;
+        afterResponse?: (response: Response) => Promise<Response> | Response;
+        onError?: (error: APIError) => Promise<void> | void;
+    };
+}
+export declare class APIError extends Error {
+    readonly status: number;
+    readonly response?: Response | undefined;
+    readonly request?: Request | undefined;
+    readonly body?: unknown | undefined;
+    constructor(message: string, status: number, response?: Response | undefined, request?: Request | undefined, body?: unknown | undefined);
+}
+export interface EndpointOptions<T = unknown> {
+    headers?: Record<string, string>;
+    query?: Record<string, string | number | boolean | string[] | undefined>;
+    timeout?: number;
+    schema?: z.ZodSchema<T>;
+    transform?: (data: unknown) => T;
+}
+//# sourceMappingURL=base-types.d.ts.map

package/dist/lib/client/internal/base-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-types.d.ts","sourceRoot":"","sources":["../../../../src/lib/client/internal/base-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAEhC,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;QACxD,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;KACxC,GAAG,IAAI,CAAC;IACT,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE;QACP,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;QACjE,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;QACrE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;KACpD,CAAC;CACF;AAED,qBAAa,QAAS,SAAQ,KAAK;aAGjB,MAAM,EAAE,MAAM;aACd,QAAQ,CAAC,EAAE,QAAQ;aACnB,OAAO,CAAC,EAAE,OAAO;aACjB,IAAI,CAAC,EAAE,OAAO;gBAJ9B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,QAAQ,YAAA,EACnB,OAAO,CAAC,EAAE,OAAO,YAAA,EACjB,IAAI,CAAC,EAAE,OAAO,YAAA;CAK/B;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACxB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,CAAC,CAAC;CACjC"}

package/dist/lib/client/internal/base-types.js

@@ -0,0 +1,15 @@
+export class APIError extends Error {
+    status;
+    response;
+    request;
+    body;
+    constructor(message, status, response, request, body) {
+        super(message);
+        this.status = status;
+        this.response = response;
+        this.request = request;
+        this.body = body;
+        this.name = 'APIError';
+    }
+}
+//# sourceMappingURL=base-types.js.map

package/dist/lib/client/internal/base-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-types.js","sourceRoot":"","sources":["../../../../src/lib/client/internal/base-types.ts"],"names":[],"mappings":"AAsBA,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGjB;IACA;IACA;IACA;IALjB,YACC,OAAe,EACC,MAAc,EACd,QAAmB,EACnB,OAAiB,EACjB,IAAc;QAE9B,KAAK,CAAC,OAAO,CAAC,CAAC;QALC,WAAM,GAAN,MAAM,CAAQ;QACd,aAAQ,GAAR,QAAQ,CAAW;QACnB,YAAO,GAAP,OAAO,CAAU;QACjB,SAAI,GAAJ,IAAI,CAAU;QAG9B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACxB,CAAC;CACD"}

package/dist/lib/client/internal/endpoint.d.ts

@@ -0,0 +1,22 @@
+import type { EndpointOptions } from './base-types.ts';
+type RequestExecutor = {
+    request<T = unknown>(options: {
+        method: string;
+        path: string;
+        body?: unknown;
+    } & EndpointOptions<T>): Promise<T>;
+};
+export declare class Endpoint {
+    private client;
+    private path;
+    constructor(client: RequestExecutor, path: string);
+    endpoint(subPath: string): Endpoint;
+    methods<T extends Record<string, (...args: never[]) => unknown>>(methods: T): T;
+    get<T = unknown>(path?: string, options?: EndpointOptions<T>): Promise<T>;
+    post<T = unknown>(path?: string, body?: unknown, options?: EndpointOptions<T>): Promise<T>;
+    put<T = unknown>(path?: string, body?: unknown, options?: EndpointOptions<T>): Promise<T>;
+    patch<T = unknown>(path?: string, body?: unknown, options?: EndpointOptions<T>): Promise<T>;
+    delete<T = unknown>(path?: string, options?: EndpointOptions<T>): Promise<T>;
+}
+export {};
+//# sourceMappingURL=endpoint.d.ts.map

package/dist/lib/client/internal/endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../../../../src/lib/client/internal/endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,KAAK,eAAe,GAAG;IACtB,OAAO,CAAC,CAAC,GAAG,OAAO,EAClB,OAAO,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,OAAO,CAAC;KACf,GAAG,eAAe,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC,CAAC,CAAC,CAAC;CACd,CAAC;AAEF,qBAAa,QAAQ;IAEnB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,IAAI;gBADJ,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,MAAM;IAGrB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ;IAKnC,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC;IAQ/E,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,SAAK,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIrE,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,SAAK,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAItF,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,SAAK,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIrF,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,SAAK,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIvF,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,SAAK,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAGxE"}

package/dist/lib/client/internal/endpoint.js

@@ -0,0 +1,35 @@
+export class Endpoint {
+    client;
+    path;
+    constructor(client, path) {
+        this.client = client;
+        this.path = path;
+    }
+    endpoint(subPath) {
+        const cleanPath = subPath.startsWith('/') ? subPath : `/${subPath}`;
+        return new Endpoint(this.client, `${this.path}${cleanPath}`);
+    }
+    methods(methods) {
+        const bound = {};
+        for (const key of Object.keys(methods)) {
+            bound[key] = methods[key].bind(this);
+        }
+        return bound;
+    }
+    get(path = '', options) {
+        return this.client.request({ method: 'GET', path: `${this.path}${path}`, ...options });
+    }
+    post(path = '', body, options) {
+        return this.client.request({ method: 'POST', path: `${this.path}${path}`, body, ...options });
+    }
+    put(path = '', body, options) {
+        return this.client.request({ method: 'PUT', path: `${this.path}${path}`, body, ...options });
+    }
+    patch(path = '', body, options) {
+        return this.client.request({ method: 'PATCH', path: `${this.path}${path}`, body, ...options });
+    }
+    delete(path = '', options) {
+        return this.client.request({ method: 'DELETE', path: `${this.path}${path}`, ...options });
+    }
+}
+//# sourceMappingURL=endpoint.js.map