@ereo/client-sdk 0.1.6

package/README.md

@@ -0,0 +1,238 @@
+# @ereo/client-sdk
+
+Type-safe client SDK for EreoJS framework APIs. Provides end-to-end type safety for HTTP requests with a clean, ergonomic API.
+
+## Installation
+
+```bash
+bun add @ereo/client-sdk
+```
+
+## Quick Start
+
+```typescript
+import { api, createClient, configureClient } from '@ereo/client-sdk';
+
+// Configure the global client
+configureClient({
+  baseUrl: 'https://api.example.com',
+  headers: { 'Authorization': 'Bearer token' },
+});
+
+// Simple API calls
+const { data: posts } = await api('/api/posts').get();
+const { data: post } = await api('/api/posts').post({
+  body: { title: 'Hello World' },
+});
+
+// Or create a dedicated client instance
+const client = createClient({
+  baseUrl: 'https://api.example.com',
+  timeout: 10000, // default is 30000ms
+});
+
+const { data } = await client.get('/api/users', {
+  query: { page: 1, limit: 10 },
+});
+```
+
+## API
+
+### `api(path)`
+
+Quick helper using the global client.
+
+```typescript
+// GET request
+const { data } = await api('/api/posts').get();
+
+// POST with body
+const { data } = await api('/api/posts').post({
+  body: { title: 'New Post' },
+});
+
+// With path parameters
+const { data } = await api('/api/posts/[id]').get({
+  params: { id: '123' },
+});
+
+// With query parameters
+const { data } = await api('/api/posts').get({
+  query: { page: 1, limit: 10 },
+});
+```
+
+### `createClient(config?)`
+
+Create a new API client instance.
+
+```typescript
+const client = createClient({
+  baseUrl: 'https://api.example.com',
+  timeout: 30000,
+  headers: { 'X-API-Key': 'key' },
+  debug: true,
+  onRequest: async (config) => config,
+  onResponse: async (response) => response,
+  onError: async (error) => console.error(error),
+});
+```
+
+### `configureClient(config)`
+
+Configure the global API client instance. Call once at app startup.
+
+```typescript
+import { configureClient } from '@ereo/client-sdk';
+
+configureClient({
+  baseUrl: '/api',
+  headers: { 'X-API-Version': '1' },
+  onError: async (error) => {
+    if (error.status === 401) {
+      // Handle unauthorized
+    }
+  },
+});
+```
+
+### `getGlobalClient()`
+
+Get the global API client instance, creating one if it does not exist.
+
+```typescript
+import { getGlobalClient } from '@ereo/client-sdk';
+
+const client = getGlobalClient();
+const { data } = await client.get('/api/users');
+```
+
+### `ApiClient` Class
+
+The main client class returned by `createClient()`.
+
+```typescript
+import { createClient, ApiClient } from '@ereo/client-sdk';
+
+const client: ApiClient = createClient({ baseUrl: '/api' });
+
+// Instance methods
+client.configure({ debug: true }); // Update configuration
+client.get(path, options?)         // GET request
+client.post(path, options?)        // POST request
+client.put(path, options?)         // PUT request
+client.patch(path, options?)       // PATCH request
+client.delete(path, options?)      // DELETE request
+client.request(config)             // Generic request
+```
+
+### HTTP Methods
+
+All standard HTTP methods are supported:
+
+```typescript
+client.get(path, options?)
+client.post(path, options?)
+client.put(path, options?)
+client.patch(path, options?)
+client.delete(path, options?)
+```
+
+### Request Options
+
+```typescript
+{
+  params?: Record<string, string>,  // Path parameters
+  query?: Record<string, unknown>,  // Query string parameters
+  body?: unknown,                   // Request body (POST/PUT/PATCH)
+  headers?: Record<string, string>, // Additional headers
+  signal?: AbortSignal,             // Abort controller signal
+}
+```
+
+## Body Types
+
+The client automatically handles different body types:
+
+```typescript
+// JSON body (default)
+await api('/api/posts').post({
+  body: { title: 'Hello', content: 'World' },
+});
+
+// FormData (for file uploads)
+const formData = new FormData();
+formData.append('file', fileInput.files[0]);
+formData.append('name', 'My File');
+
+await api('/api/upload').post({ body: formData });
+
+// URLSearchParams
+const params = new URLSearchParams();
+params.append('grant_type', 'client_credentials');
+
+await api('/api/oauth/token').post({ body: params });
+```
+
+## Error Handling
+
+```typescript
+import { api } from '@ereo/client-sdk';
+import type { ApiError } from '@ereo/client-sdk';
+
+try {
+  const { data } = await api('/api/posts').get();
+} catch (error) {
+  const apiError = error as ApiError;
+  console.log(apiError.status);  // HTTP status code
+  console.log(apiError.path);    // Request path
+  console.log(apiError.method);  // Request method
+  console.log(apiError.message); // Error message
+}
+```
+
+## Type Exports
+
+The package exports the following types for TypeScript users:
+
+```typescript
+import type {
+  HttpMethod,           // 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS'
+  ApiRoutes,            // Module augmentation interface for route types
+  ApiPaths,             // All registered API route paths
+  MethodsFor,           // Get supported methods for a path
+  RequestBody,          // Get request body type for path/method
+  ResponseType,         // Get response type for path/method
+  QueryParams,          // Get query params type for path/method
+  PathParams,           // Extract path params from route string
+  ApiRequestConfig,     // Full request configuration
+  ApiResponse,          // Response wrapper { data, status, headers, ok }
+  ApiError,             // Error with status, path, method
+  ClientConfig,         // Client configuration options
+  DefineApiTypes,       // Helper for defining route API types
+} from '@ereo/client-sdk';
+```
+
+## Key Features
+
+- End-to-end type safety with TypeScript
+- Path parameter substitution (`/api/posts/[id]`)
+- Query string building
+- Automatic JSON serialization
+- FormData and URLSearchParams support
+- Request/response interceptors
+- Error handling with custom callbacks
+- Configurable timeout (default: 30000ms)
+- Debug mode for logging
+
+## Documentation
+
+For full documentation, visit [https://ereo.dev/docs/client-sdk](https://ereo.dev/docs/client-sdk)
+
+## Part of EreoJS
+
+This package is part of the [EreoJS monorepo](https://github.com/anthropics/ereo-js).
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,134 @@
+/**
+ * @ereo/client-sdk - Type-safe API client
+ *
+ * Provides end-to-end type safety for API calls.
+ */
+import type { ApiPaths, HttpMethod, ApiRequestConfig, ApiResponse, ClientConfig, ResponseType, RequestBody, QueryParams, PathParams } from './types';
+/**
+ * Type-safe API client for making HTTP requests.
+ */
+export declare class ApiClient {
+    private config;
+    constructor(config?: ClientConfig);
+    /**
+     * Update client configuration.
+     */
+    configure(config: Partial<ClientConfig>): void;
+    /**
+     * Make a type-safe API request.
+     */
+    request<Path extends ApiPaths, Method extends HttpMethod = 'GET'>(config: ApiRequestConfig<Path, Method>): Promise<ApiResponse<ResponseType<Path, Method>>>;
+    /**
+     * Make a GET request.
+     */
+    get<Path extends ApiPaths>(path: Path, options?: {
+        params?: PathParams<Path extends string ? Path : string>;
+        query?: QueryParams<Path, 'GET'>;
+        headers?: Record<string, string>;
+        signal?: AbortSignal;
+    }): Promise<ApiResponse<ResponseType<Path, 'GET'>>>;
+    /**
+     * Make a POST request.
+     */
+    post<Path extends ApiPaths>(path: Path, options?: {
+        params?: PathParams<Path extends string ? Path : string>;
+        body?: RequestBody<Path, 'POST'>;
+        headers?: Record<string, string>;
+        signal?: AbortSignal;
+    }): Promise<ApiResponse<ResponseType<Path, 'POST'>>>;
+    /**
+     * Make a PUT request.
+     */
+    put<Path extends ApiPaths>(path: Path, options?: {
+        params?: PathParams<Path extends string ? Path : string>;
+        body?: RequestBody<Path, 'PUT'>;
+        headers?: Record<string, string>;
+        signal?: AbortSignal;
+    }): Promise<ApiResponse<ResponseType<Path, 'PUT'>>>;
+    /**
+     * Make a PATCH request.
+     */
+    patch<Path extends ApiPaths>(path: Path, options?: {
+        params?: PathParams<Path extends string ? Path : string>;
+        body?: RequestBody<Path, 'PATCH'>;
+        headers?: Record<string, string>;
+        signal?: AbortSignal;
+    }): Promise<ApiResponse<ResponseType<Path, 'PATCH'>>>;
+    /**
+     * Make a DELETE request.
+     */
+    delete<Path extends ApiPaths>(path: Path, options?: {
+        params?: PathParams<Path extends string ? Path : string>;
+        headers?: Record<string, string>;
+        signal?: AbortSignal;
+    }): Promise<ApiResponse<ResponseType<Path, 'DELETE'>>>;
+    /**
+     * Build the full URL for a request.
+     */
+    private buildUrl;
+    /**
+     * Build fetch init options.
+     */
+    private buildInit;
+    /**
+     * Parse the response.
+     */
+    private parseResponse;
+    /**
+     * Create an API error.
+     */
+    private createError;
+}
+/**
+ * Create a new API client instance.
+ */
+export declare function createClient(config?: ClientConfig): ApiClient;
+/**
+ * Get the global API client instance.
+ * Creates one if it doesn't exist.
+ */
+export declare function getGlobalClient(): ApiClient;
+/**
+ * Configure the global API client.
+ */
+export declare function configureClient(config: ClientConfig): void;
+/**
+ * Type-safe API request helper.
+ * Uses the global client by default.
+ *
+ * @example
+ * const { data: posts } = await api('/api/posts').get();
+ * const { data: post } = await api('/api/posts').post({ body: { title: 'Hello' } });
+ */
+export declare function api<Path extends ApiPaths>(path: Path): {
+    get: (options?: {
+        params?: Record<string, string>;
+        query?: Record<string, unknown>;
+        headers?: Record<string, string>;
+        signal?: AbortSignal;
+    }) => Promise<ApiResponse<ResponseType<Path, "GET">>>;
+    post: (options?: {
+        params?: Record<string, string>;
+        body?: unknown;
+        headers?: Record<string, string>;
+        signal?: AbortSignal;
+    }) => Promise<ApiResponse<ResponseType<Path, "POST">>>;
+    put: (options?: {
+        params?: Record<string, string>;
+        body?: unknown;
+        headers?: Record<string, string>;
+        signal?: AbortSignal;
+    }) => Promise<ApiResponse<ResponseType<Path, "PUT">>>;
+    patch: (options?: {
+        params?: Record<string, string>;
+        body?: unknown;
+        headers?: Record<string, string>;
+        signal?: AbortSignal;
+    }) => Promise<ApiResponse<ResponseType<Path, "PATCH">>>;
+    delete: (options?: {
+        params?: Record<string, string>;
+        headers?: Record<string, string>;
+        signal?: AbortSignal;
+    }) => Promise<ApiResponse<ResponseType<Path, "DELETE">>>;
+};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @ereo/client-sdk - Main exports
+ */
+export { ApiClient, createClient, getGlobalClient, configureClient, api, } from './client';
+export type { HttpMethod, ApiRoutes, ApiPaths, MethodsFor, RequestBody, ResponseType, QueryParams, PathParams, ApiRequestConfig, ApiResponse, ApiError, ClientConfig, DefineApiTypes, } from './types';
+//# 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;;GAEG;AAEH,OAAO,EACL,SAAS,EACT,YAAY,EACZ,eAAe,EACf,eAAe,EACf,GAAG,GACJ,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,UAAU,EACV,SAAS,EACT,QAAQ,EACR,UAAU,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,cAAc,GACf,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,178 @@
+// @bun
+// src/client.ts
+var defaultConfig = {
+  baseUrl: "",
+  timeout: 30000,
+  debug: false
+};
+var globalClient;
+
+class ApiClient {
+  config;
+  constructor(config = {}) {
+    this.config = { ...defaultConfig, ...config };
+  }
+  configure(config) {
+    this.config = { ...this.config, ...config };
+  }
+  async request(config) {
+    const mergedConfig = this.config.onRequest ? await this.config.onRequest(config) : config;
+    const url = this.buildUrl(mergedConfig);
+    const init = this.buildInit(mergedConfig);
+    if (this.config.debug) {
+      console.log(`[API] ${init.method} ${url}`);
+    }
+    try {
+      const fetchFn = this.config.fetch || fetch;
+      const response = await fetchFn(url, init);
+      const apiResponse = await this.parseResponse(response);
+      if (this.config.onResponse) {
+        return this.config.onResponse(apiResponse);
+      }
+      return apiResponse;
+    } catch (error) {
+      const apiError = this.createError(error, config.path, config.method);
+      if (this.config.onError) {
+        await this.config.onError(apiError);
+      }
+      throw apiError;
+    }
+  }
+  async get(path, options) {
+    return this.request({
+      path,
+      method: "GET",
+      ...options
+    });
+  }
+  async post(path, options) {
+    return this.request({
+      path,
+      method: "POST",
+      ...options
+    });
+  }
+  async put(path, options) {
+    return this.request({
+      path,
+      method: "PUT",
+      ...options
+    });
+  }
+  async patch(path, options) {
+    return this.request({
+      path,
+      method: "PATCH",
+      ...options
+    });
+  }
+  async delete(path, options) {
+    return this.request({
+      path,
+      method: "DELETE",
+      ...options
+    });
+  }
+  buildUrl(config) {
+    let path = String(config.path);
+    if (config.params) {
+      for (const [key, value] of Object.entries(config.params)) {
+        path = path.replace(`[${key}]`, encodeURIComponent(String(value)));
+      }
+    }
+    if (config.query) {
+      const params = new URLSearchParams;
+      for (const [key, value] of Object.entries(config.query)) {
+        if (value !== undefined && value !== null) {
+          params.append(key, String(value));
+        }
+      }
+      const queryString = params.toString();
+      if (queryString) {
+        path += `?${queryString}`;
+      }
+    }
+    return `${this.config.baseUrl}${path}`;
+  }
+  buildInit(config) {
+    const headers = {
+      Accept: "application/json",
+      ...this.config.headers,
+      ...config.headers
+    };
+    const init = {
+      method: config.method,
+      headers,
+      signal: config.signal
+    };
+    if (config.body !== undefined) {
+      if (config.body instanceof FormData) {
+        delete headers["Content-Type"];
+        init.body = config.body;
+      } else if (config.body instanceof URLSearchParams) {
+        headers["Content-Type"] = "application/x-www-form-urlencoded";
+        init.body = config.body;
+      } else {
+        headers["Content-Type"] = "application/json";
+        init.body = JSON.stringify(config.body);
+      }
+    }
+    return init;
+  }
+  async parseResponse(response) {
+    const contentType = response.headers.get("content-type") || "";
+    let data;
+    if (contentType.includes("application/json")) {
+      data = await response.json();
+    } else {
+      data = await response.text();
+    }
+    return {
+      data,
+      status: response.status,
+      headers: response.headers,
+      ok: response.ok
+    };
+  }
+  createError(error, path, method) {
+    const apiError = new Error(error.message);
+    apiError.status = 0;
+    apiError.path = path;
+    apiError.method = method;
+    apiError.name = "ApiError";
+    return apiError;
+  }
+}
+function createClient(config) {
+  return new ApiClient(config);
+}
+function getGlobalClient() {
+  if (!globalClient) {
+    globalClient = new ApiClient;
+  }
+  return globalClient;
+}
+function configureClient(config) {
+  if (!globalClient) {
+    globalClient = new ApiClient(config);
+  } else {
+    globalClient.configure(config);
+  }
+}
+function api(path) {
+  const client = getGlobalClient();
+  return {
+    get: (options) => client.get(path, options),
+    post: (options) => client.post(path, options),
+    put: (options) => client.put(path, options),
+    patch: (options) => client.patch(path, options),
+    delete: (options) => client.delete(path, options)
+  };
+}
+export {
+  getGlobalClient,
+  createClient,
+  configureClient,
+  api,
+  ApiClient
+};

package/dist/types.d.ts

@@ -0,0 +1,126 @@
+/**
+ * @ereo/client-sdk - Type definitions for API routes
+ *
+ * These types support end-to-end type safety for API calls.
+ * Routes declare their API types, and the client SDK uses them.
+ */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+/**
+ * Module augmentation target for API route types.
+ * Generated by the bundler during development.
+ *
+ * @example
+ * declare module '@ereo/client-sdk' {
+ *   interface ApiRoutes {
+ *     '/api/posts': {
+ *       GET: {
+ *         response: Post[];
+ *         query?: { limit?: number; offset?: number };
+ *       };
+ *       POST: {
+ *         body: CreatePostInput;
+ *         response: Post;
+ *       };
+ *     };
+ *   }
+ * }
+ */
+export interface ApiRoutes {
+}
+/** All registered API route paths */
+export type ApiPaths = keyof ApiRoutes extends never ? string : keyof ApiRoutes;
+/** Get all supported methods for a path */
+export type MethodsFor<Path extends ApiPaths> = Path extends keyof ApiRoutes ? keyof ApiRoutes[Path] extends HttpMethod ? keyof ApiRoutes[Path] : never : HttpMethod;
+/** Get request body type for a path and method */
+export type RequestBody<Path extends ApiPaths, Method extends HttpMethod = 'POST'> = Path extends keyof ApiRoutes ? Method extends keyof ApiRoutes[Path] ? ApiRoutes[Path][Method] extends {
+    body: infer B;
+} ? B : never : never : unknown;
+/** Get response type for a path and method */
+export type ResponseType<Path extends ApiPaths, Method extends HttpMethod = 'GET'> = Path extends keyof ApiRoutes ? Method extends keyof ApiRoutes[Path] ? ApiRoutes[Path][Method] extends {
+    response: infer R;
+} ? R : unknown : unknown : unknown;
+/** Get query parameters type for a path and method */
+export type QueryParams<Path extends ApiPaths, Method extends HttpMethod = 'GET'> = Path extends keyof ApiRoutes ? Method extends keyof ApiRoutes[Path] ? ApiRoutes[Path][Method] extends {
+    query: infer Q;
+} ? Q : never : never : Record<string, string | number | boolean | undefined>;
+/** Get path parameters type for a path */
+export type PathParams<Path extends string> = Path extends `${infer _}/[${infer Param}]${infer Rest}` ? {
+    [K in Param]: string;
+} & PathParams<Rest> : Path extends `[${infer Param}]${infer Rest}` ? {
+    [K in Param]: string;
+} & PathParams<Rest> : Record<string, never>;
+export interface ApiRequestConfig<Path extends ApiPaths = ApiPaths, Method extends HttpMethod = HttpMethod> {
+    /** Request path */
+    path: Path;
+    /** HTTP method */
+    method: Method;
+    /** Path parameters (for dynamic routes) */
+    params?: PathParams<Path extends string ? Path : string>;
+    /** Query parameters */
+    query?: QueryParams<Path, Method>;
+    /** Request body */
+    body?: RequestBody<Path, Method>;
+    /** Request headers */
+    headers?: Record<string, string>;
+    /** Abort signal */
+    signal?: AbortSignal;
+}
+export interface ApiResponse<T = unknown> {
+    /** Response data */
+    data: T;
+    /** HTTP status code */
+    status: number;
+    /** Response headers */
+    headers: Headers;
+    /** Whether response was successful */
+    ok: boolean;
+}
+export interface ApiError extends Error {
+    /** HTTP status code */
+    status: number;
+    /** Response data (if any) */
+    data?: unknown;
+    /** Request path */
+    path: string;
+    /** Request method */
+    method: string;
+}
+export interface ClientConfig {
+    /** Base URL for API requests */
+    baseUrl?: string;
+    /** Default headers */
+    headers?: Record<string, string>;
+    /** Request timeout (ms) */
+    timeout?: number;
+    /** Enable request/response logging */
+    debug?: boolean;
+    /** Custom fetch implementation */
+    fetch?: typeof fetch;
+    /** Request interceptor */
+    onRequest?: (config: ApiRequestConfig) => ApiRequestConfig | Promise<ApiRequestConfig>;
+    /** Response interceptor */
+    onResponse?: <T>(response: ApiResponse<T>) => ApiResponse<T> | Promise<ApiResponse<T>>;
+    /** Error handler */
+    onError?: (error: ApiError) => void | Promise<void>;
+}
+/**
+ * Helper to define API types for a route module.
+ * Use this to declare types that will be picked up by the client SDK.
+ *
+ * @example
+ * // In app/routes/api/posts.ts
+ * export interface ApiTypes {
+ *   GET: {
+ *     response: Post[];
+ *     query: { limit?: number };
+ *   };
+ *   POST: {
+ *     body: CreatePostInput;
+ *     response: Post;
+ *   };
+ * }
+ */
+export type DefineApiTypes<T extends Record<HttpMethod, {
+    response: unknown;
+}>> = T;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1 @@
+// @bun

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@ereo/client-sdk",
+  "version": "0.1.6",
+  "license": "MIT",
+  "author": "Ereo Team",
+  "homepage": "https://ereo.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ereojs/ereo.git",
+    "directory": "packages/client-sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/ereojs/ereo/issues"
+  },
+  "description": "Type-safe client SDK for EreoJS framework APIs",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "bun build ./src/index.ts ./src/types.ts --outdir ./dist --target bun --external @ereo/core && bun run build:types",
+    "build:types": "tsc --emitDeclarationOnly --outDir dist",
+    "dev": "bun build ./src/index.ts --outdir ./dist --target bun --watch",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@ereo/core": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.1.0",
+    "typescript": "^5.4.0"
+  }
+}