@spfn/core 0.1.0-alpha.8 → 0.1.0-alpha.81

package/dist/client/index.js

@@ -1,72 +1,27 @@
 // src/client/contract-client.ts
 var ApiClientError = class extends Error {
-  constructor(message, status, url, response) {
+  constructor(message, status, url, response, errorType) {
     super(message);
     this.status = status;
     this.url = url;
     this.response = response;
+    this.errorType = errorType;
     this.name = "ApiClientError";
   }
 };
-function buildUrl(path, params) {
-  if (!params) return path;
-  let url = path;
-  for (const [key, value] of Object.entries(params)) {
-    url = url.replace(`:${key}`, String(value));
-  }
-  return url;
-}
-function buildQuery(query) {
-  if (!query || Object.keys(query).length === 0) return "";
-  const params = new URLSearchParams();
-  for (const [key, value] of Object.entries(query)) {
-    if (Array.isArray(value)) {
-      value.forEach((v) => params.append(key, String(v)));
-    } else if (value !== void 0 && value !== null) {
-      params.append(key, String(value));
-    }
-  }
-  const queryString = params.toString();
-  return queryString ? `?${queryString}` : "";
-}
-function getHttpMethod(contract, options) {
-  if ("method" in contract && typeof contract.method === "string") {
-    return contract.method.toUpperCase();
-  }
-  if (options?.body !== void 0) {
-    return "POST";
-  }
-  return "GET";
-}
 var ContractClient = class _ContractClient {
   config;
   interceptors = [];
   constructor(config = {}) {
     this.config = {
-      baseUrl: config.baseUrl || process.env.NEXT_PUBLIC_API_URL || "http://localhost:4000",
+      baseUrl: config.baseUrl || process.env.SERVER_API_URL || process.env.NEXT_PUBLIC_API_URL || "http://localhost:4000",
       headers: config.headers || {},
       timeout: config.timeout || 3e4,
-      fetch: config.fetch || globalThis.fetch
+      fetch: config.fetch || globalThis.fetch.bind(globalThis)
     };
   }
   /**
    * Add request interceptor
-   *
-   * Interceptors are executed in the order they are added
-   *
-   * @example
-   * ```ts
-   * client.use(async (url, init) => {
-   *   // Add auth header
-   *   return {
-   *     ...init,
-   *     headers: {
-   *       ...init.headers,
-   *       Authorization: `Bearer ${token}`
-   *     }
-   *   };
-   * });
-   * ```
    */
   use(interceptor) {
     this.interceptors.push(interceptor);
@@ -74,30 +29,26 @@ var ContractClient = class _ContractClient {
   /**
    * Make a type-safe API call using a contract
    *
-   * @example
-   * ```ts
-   * const getUserContract = {
-   *   params: Type.Object({ id: Type.String() }),
-   *   response: Type.Object({ id: Type.Number(), name: Type.String() })
-   * } as const satisfies RouteContract;
-   *
-   * const user = await client.call('/users/:id', getUserContract, {
-   *   params: { id: '123' }
-   * });
-   * // ✅ user.name is typed as string
-   * ```
+   * @param contract - Route contract with absolute path
+   * @param options - Call options (params, query, body, headers)
    */
-  async call(path, contract, options) {
+  async call(contract, options) {
     const baseUrl = options?.baseUrl || this.config.baseUrl;
-    const urlPath = buildUrl(path, options?.params);
-    const queryString = buildQuery(options?.query);
+    const urlPath = _ContractClient.buildUrl(
+      contract.path,
+      options?.params
+    );
+    const queryString = _ContractClient.buildQuery(
+      options?.query
+    );
     const url = `${baseUrl}${urlPath}${queryString}`;
-    const method = getHttpMethod(contract, options);
+    const method = _ContractClient.getHttpMethod(contract, options);
     const headers = {
       ...this.config.headers,
       ...options?.headers
     };
-    if (options?.body !== void 0 && !headers["Content-Type"]) {
+    const isFormData = _ContractClient.isFormData(options?.body);
+    if (options?.body !== void 0 && !isFormData && !headers["Content-Type"]) {
       headers["Content-Type"] = "application/json";
     }
     let init = {
@@ -105,7 +56,7 @@ var ContractClient = class _ContractClient {
       headers
     };
     if (options?.body !== void 0) {
-      init.body = JSON.stringify(options.body);
+      init.body = isFormData ? options.body : JSON.stringify(options.body);
     }
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
@@ -117,18 +68,20 @@ var ContractClient = class _ContractClient {
       clearTimeout(timeoutId);
       if (error instanceof Error && error.name === "AbortError") {
         throw new ApiClientError(
-          `${method} ${urlPath} timed out after ${this.config.timeout}ms`,
+          `Request timed out after ${this.config.timeout}ms`,
           0,
-          "Timeout",
-          url
+          url,
+          void 0,
+          "timeout"
         );
       }
       if (error instanceof Error) {
         throw new ApiClientError(
-          `${method} ${urlPath} network error: ${error.message}`,
+          `Network error: ${error.message}`,
           0,
-          "Network Error",
-          url
+          url,
+          void 0,
+          "network"
         );
       }
       throw error;
@@ -140,7 +93,8 @@ var ContractClient = class _ContractClient {
         `${method} ${urlPath} failed: ${response.status} ${response.statusText}`,
         response.status,
         url,
-        errorBody
+        errorBody,
+        "http"
       );
     }
     const data = await response.json();
@@ -148,15 +102,6 @@ var ContractClient = class _ContractClient {
   }
   /**
    * Create a new client with merged configuration
-   *
-   * Useful for creating clients with specific auth tokens or custom headers
-   *
-   * @example
-   * ```ts
-   * const authClient = client.withConfig({
-   *   headers: { Authorization: `Bearer ${token}` }
-   * });
-   * ```
    */
   withConfig(config) {
     return new _ContractClient({
@@ -166,12 +111,75 @@ var ContractClient = class _ContractClient {
       fetch: config.fetch || this.config.fetch
     });
   }
+  static buildUrl(path, params) {
+    if (!params) return path;
+    let url = path;
+    for (const [key, value] of Object.entries(params)) {
+      url = url.replace(`:${key}`, String(value));
+    }
+    return url;
+  }
+  static buildQuery(query) {
+    if (!query || Object.keys(query).length === 0) return "";
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+      if (Array.isArray(value)) {
+        value.forEach((v) => params.append(key, String(v)));
+      } else if (value !== void 0 && value !== null) {
+        params.append(key, String(value));
+      }
+    }
+    const queryString = params.toString();
+    return queryString ? `?${queryString}` : "";
+  }
+  static getHttpMethod(contract, options) {
+    if ("method" in contract && typeof contract.method === "string") {
+      return contract.method.toUpperCase();
+    }
+    if (options?.body !== void 0) {
+      return "POST";
+    }
+    return "GET";
+  }
+  static isFormData(body) {
+    return body instanceof FormData;
+  }
 };
 function createClient(config) {
   return new ContractClient(config);
 }
-var client = createClient();
+var _clientInstance = new ContractClient();
+function configureClient(config) {
+  _clientInstance = new ContractClient(config);
+}
+var client = new Proxy({}, {
+  get(_target, prop) {
+    return _clientInstance[prop];
+  }
+});
+function isTimeoutError(error) {
+  return error instanceof ApiClientError && error.errorType === "timeout";
+}
+function isNetworkError(error) {
+  return error instanceof ApiClientError && error.errorType === "network";
+}
+function isHttpError(error) {
+  return error instanceof ApiClientError && error.errorType === "http";
+}
+function isServerError(error, errorType) {
+  if (!isHttpError(error)) return false;
+  const response = error.response;
+  return response?.error?.type === errorType;
+}
+function getServerErrorType(error) {
+  const response = error.response;
+  return response?.error?.type;
+}
+function getServerErrorDetails(error) {
+  const response = error.response;
+  return response?.error?.details;
+}
 
-export { ApiClientError, ContractClient, client, createClient };
+export { ApiClientError, ContractClient, client, configureClient, createClient, getServerErrorDetails, getServerErrorType, isHttpError, isNetworkError, isServerError, isTimeoutError };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/client/contract-client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Contract-Based API Client\n *\n * Type-safe HTTP client that works with RouteContract for full end-to-end type safety\n *\n * @example\n * ```ts\n * import { createClient } from '@spfn/core/client';\n * import { getUserContract } from './contracts';\n *\n * const client = createClient({ baseUrl: 'http://localhost:4000' });\n * const user = await client.call(getUserContract, { params: { id: '123' } });\n * // ✅ user is fully typed based on contract.response\n * ```\n */\n\nimport type { RouteContract, InferContract } from '../route';\n\n/**\n * Request interceptor function\n *\n * Allows modifying request before it's sent\n */\nexport type RequestInterceptor = (\n    url: string,\n    init: RequestInit\n) => Promise<RequestInit> | RequestInit;\n\n/**\n * Client configuration\n */\nexport interface ClientConfig\n{\n    /**\n     * API base URL (e.g., http://localhost:4000)\n     * Can be overridden per request\n     */\n    baseUrl?: string;\n\n    /**\n     * Default headers to include in all requests\n     */\n    headers?: Record<string, string>;\n\n    /**\n     * Request timeout in milliseconds\n     */\n    timeout?: number;\n\n    /**\n     * Custom fetch implementation (for testing or custom behavior)\n     */\n    fetch?: typeof fetch;\n}\n\n/**\n * Request options for API calls\n */\nexport interface CallOptions<TContract extends RouteContract>\n{\n    /**\n     * Path parameters (for dynamic routes like /users/:id)\n     */\n    params?: InferContract<TContract>['params'];\n\n    /**\n     * Query parameters (for URL query strings)\n     */\n    query?: InferContract<TContract>['query'];\n\n    /**\n     * Request body (for POST, PUT, PATCH)\n     */\n    body?: InferContract<TContract>['body'];\n\n    /**\n     * Additional headers for this specific request\n     */\n    headers?: Record<string, string>;\n\n    /**\n     * Override base URL for this request\n     */\n    baseUrl?: string;\n}\n\n/**\n * API Client Error\n */\nexport class ApiClientError extends Error\n{\n    constructor(\n        message: string,\n        public readonly status: number,\n        public readonly url: string,\n        public readonly response?: unknown\n    )\n    {\n        super(message);\n        this.name = 'ApiClientError';\n    }\n}\n\n/**\n * Build URL with path parameters replaced\n *\n * @example\n * buildUrl('/users/:id', { id: '123' }) → '/users/123'\n * buildUrl('/posts/:postId/comments/:id', { postId: '1', id: '2' }) → '/posts/1/comments/2'\n */\nfunction buildUrl(path: string, params?: Record<string, string | number>): string\n{\n    if (!params) return path;\n\n    let url = path;\n    for (const [key, value] of Object.entries(params))\n    {\n        url = url.replace(`:${key}`, String(value));\n    }\n\n    return url;\n}\n\n/**\n * Build query string from object\n *\n * @example\n * buildQuery({ page: '1', limit: '10' }) → '?page=1&limit=10'\n */\nfunction buildQuery(query?: Record<string, string | string[] | number | boolean>): string\n{\n    if (!query || Object.keys(query).length === 0) return '';\n\n    const params = new URLSearchParams();\n    for (const [key, value] of Object.entries(query))\n    {\n        if (Array.isArray(value))\n        {\n            value.forEach((v) => params.append(key, String(v)));\n        }\n        else if (value !== undefined && value !== null)\n        {\n            params.append(key, String(value));\n        }\n    }\n\n    const queryString = params.toString();\n    return queryString ? `?${queryString}` : '';\n}\n\n/**\n * Extract HTTP method from contract or infer from request type\n */\nfunction getHttpMethod<TContract extends RouteContract>(\n    contract: TContract,\n    options?: CallOptions<TContract>\n): string\n{\n    // If contract has explicit method, use it\n    if ('method' in contract && typeof contract.method === 'string')\n    {\n        return contract.method.toUpperCase();\n    }\n\n    // Infer from presence of body\n    if (options?.body !== undefined)\n    {\n        return 'POST';\n    }\n\n    // Default to GET\n    return 'GET';\n}\n\n/**\n * Contract-based API Client\n */\nexport class ContractClient\n{\n    private readonly config: Required<ClientConfig>;\n    private readonly interceptors: RequestInterceptor[] = [];\n\n    constructor(config: ClientConfig = {})\n    {\n        this.config = {\n            baseUrl: config.baseUrl || process.env.NEXT_PUBLIC_API_URL || 'http://localhost:4000',\n            headers: config.headers || {},\n            timeout: config.timeout || 30000,\n            fetch: config.fetch || globalThis.fetch,\n        };\n    }\n\n    /**\n     * Add request interceptor\n     *\n     * Interceptors are executed in the order they are added\n     *\n     * @example\n     * ```ts\n     * client.use(async (url, init) => {\n     *   // Add auth header\n     *   return {\n     *     ...init,\n     *     headers: {\n     *       ...init.headers,\n     *       Authorization: `Bearer ${token}`\n     *     }\n     *   };\n     * });\n     * ```\n     */\n    use(interceptor: RequestInterceptor): void\n    {\n        this.interceptors.push(interceptor);\n    }\n\n    /**\n     * Make a type-safe API call using a contract\n     *\n     * @example\n     * ```ts\n     * const getUserContract = {\n     *   params: Type.Object({ id: Type.String() }),\n     *   response: Type.Object({ id: Type.Number(), name: Type.String() })\n     * } as const satisfies RouteContract;\n     *\n     * const user = await client.call('/users/:id', getUserContract, {\n     *   params: { id: '123' }\n     * });\n     * // ✅ user.name is typed as string\n     * ```\n     */\n    async call<TContract extends RouteContract>(\n        path: string,\n        contract: TContract,\n        options?: CallOptions<TContract>\n    ): Promise<InferContract<TContract>['response']>\n    {\n        // Build URL\n        const baseUrl = options?.baseUrl || this.config.baseUrl;\n        const urlPath = buildUrl(path, options?.params as Record<string, string | number>);\n        const queryString = buildQuery(options?.query as Record<string, string | string[] | number | boolean>);\n        const url = `${baseUrl}${urlPath}${queryString}`;\n\n        // Determine HTTP method\n        const method = getHttpMethod(contract, options);\n\n        // Build headers\n        const headers: Record<string, string> = {\n            ...this.config.headers,\n            ...options?.headers,\n        };\n\n        // Add Content-Type for requests with body\n        if (options?.body !== undefined && !headers['Content-Type'])\n        {\n            headers['Content-Type'] = 'application/json';\n        }\n\n        // Build request init\n        let init: RequestInit = {\n            method,\n            headers,\n        };\n\n        // Add body for POST/PUT/PATCH\n        if (options?.body !== undefined)\n        {\n            init.body = JSON.stringify(options.body);\n        }\n\n        // Create abort controller for timeout\n        const controller = new AbortController();\n        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);\n        init.signal = controller.signal;\n\n        // Execute interceptors\n        for (const interceptor of this.interceptors)\n        {\n            init = await interceptor(url, init);\n        }\n\n        // Make request\n        const response = await this.config.fetch(url, init).catch((error) =>\n        {\n            clearTimeout(timeoutId);\n\n            // Handle abort (timeout)\n            if (error instanceof Error && error.name === 'AbortError')\n            {\n                throw new ApiClientError(\n                    `${method} ${urlPath} timed out after ${this.config.timeout}ms`,\n                    0,\n                    'Timeout',\n                    url\n                );\n            }\n\n            // Handle network errors\n            if (error instanceof Error)\n            {\n                throw new ApiClientError(\n                    `${method} ${urlPath} network error: ${error.message}`,\n                    0,\n                    'Network Error',\n                    url\n                );\n            }\n\n            // Unknown error\n            throw error;\n        });\n\n        // Clear timeout\n        clearTimeout(timeoutId);\n\n        // Handle non-OK responses\n        if (!response.ok)\n        {\n            const errorBody = await response.json().catch(() => null);\n            throw new ApiClientError(\n                `${method} ${urlPath} failed: ${response.status} ${response.statusText}`,\n                response.status,\n                url,\n                errorBody\n            );\n        }\n\n        // Parse and return response\n        const data = await response.json();\n        return data as InferContract<TContract>['response'];\n    }\n\n    /**\n     * Create a new client with merged configuration\n     *\n     * Useful for creating clients with specific auth tokens or custom headers\n     *\n     * @example\n     * ```ts\n     * const authClient = client.withConfig({\n     *   headers: { Authorization: `Bearer ${token}` }\n     * });\n     * ```\n     */\n    withConfig(config: Partial<ClientConfig>): ContractClient\n    {\n        return new ContractClient({\n            baseUrl: config.baseUrl || this.config.baseUrl,\n            headers: { ...this.config.headers, ...config.headers },\n            timeout: config.timeout || this.config.timeout,\n            fetch: config.fetch || this.config.fetch,\n        });\n    }\n}\n\n/**\n * Create a new contract-based API client\n *\n * @example\n * ```ts\n * const client = createClient({\n *   baseUrl: 'http://localhost:4000',\n *   headers: { 'X-Custom': 'header' }\n * });\n *\n * const user = await client.call('/users/:id', getUserContract, {\n *   params: { id: '123' }\n * });\n * ```\n */\nexport function createClient(config?: ClientConfig): ContractClient\n{\n    return new ContractClient(config);\n}\n\n/**\n * Default client instance\n *\n * @example\n * ```ts\n * import { client } from '@spfn/core/client';\n *\n * const user = await client.call('/users/:id', getUserContract, {\n *   params: { id: '123' }\n * });\n * ```\n */\nexport const client = createClient();"]}
+{"version":3,"sources":["../../src/client/contract-client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Contract-Based API Client\n *\n * Type-safe HTTP client that works with RouteContract for full end-to-end type safety\n */\nimport type { RouteContract, InferContract } from '../route';\n\nexport type RequestInterceptor = (\n    url: string,\n    init: RequestInit\n) => Promise<RequestInit> | RequestInit;\n\nexport interface ClientConfig\n{\n    /**\n     * API base URL (e.g., http://localhost:4000)\n     */\n    baseUrl?: string;\n\n    /**\n     * Default headers to include in all requests\n     */\n    headers?: Record<string, string>;\n\n    /**\n     * Request timeout in milliseconds\n     */\n    timeout?: number;\n\n    /**\n     * Custom fetch implementation\n     */\n    fetch?: typeof fetch;\n}\n\nexport interface CallOptions<TContract extends RouteContract>\n{\n    params?: InferContract<TContract>['params'];\n    query?: InferContract<TContract>['query'];\n    body?: InferContract<TContract>['body'];\n    headers?: Record<string, string>;\n    baseUrl?: string;\n}\n\n/**\n * API Client Error\n */\nexport class ApiClientError extends Error\n{\n    constructor(\n        message: string,\n        public readonly status: number,\n        public readonly url: string,\n        public readonly response?: unknown,\n        public readonly errorType?: 'timeout' | 'network' | 'http'\n    )\n    {\n        super(message);\n        this.name = 'ApiClientError';\n    }\n}\n\n/**\n * Contract-based API Client\n */\nexport class ContractClient\n{\n    private readonly config: Required<ClientConfig>;\n    private readonly interceptors: RequestInterceptor[] = [];\n\n    constructor(config: ClientConfig = {})\n    {\n        this.config = {\n            baseUrl: config.baseUrl || process.env.SERVER_API_URL || process.env.NEXT_PUBLIC_API_URL || 'http://localhost:4000',\n            headers: config.headers || {},\n            timeout: config.timeout || 30000,\n            fetch: config.fetch || globalThis.fetch.bind(globalThis),\n        };\n    }\n\n    /**\n     * Add request interceptor\n     */\n    use(interceptor: RequestInterceptor): void\n    {\n        this.interceptors.push(interceptor);\n    }\n\n    /**\n     * Make a type-safe API call using a contract\n     *\n     * @param contract - Route contract with absolute path\n     * @param options - Call options (params, query, body, headers)\n     */\n    async call<TContract extends RouteContract>(\n        contract: TContract,\n        options?: CallOptions<TContract>\n    ): Promise<InferContract<TContract>['response']>\n    {\n        const baseUrl = options?.baseUrl || this.config.baseUrl;\n\n        // Use contract.path directly (contracts use absolute paths)\n        const urlPath = ContractClient.buildUrl(\n            contract.path,\n            options?.params as Record<string, string | number> | undefined\n        );\n\n        const queryString = ContractClient.buildQuery(\n            options?.query as Record<string, string | string[] | number | boolean> | undefined\n        );\n\n        const url = `${baseUrl}${urlPath}${queryString}`;\n\n        const method = ContractClient.getHttpMethod(contract, options);\n\n        const headers: Record<string, string> = {\n            ...this.config.headers,\n            ...options?.headers,\n        };\n\n        const isFormData = ContractClient.isFormData(options?.body);\n\n        if (options?.body !== undefined && !isFormData && !headers['Content-Type'])\n        {\n            headers['Content-Type'] = 'application/json';\n        }\n\n        let init: RequestInit = {\n            method,\n            headers,\n        };\n\n        if (options?.body !== undefined)\n        {\n            init.body = isFormData ? (options.body as FormData) : JSON.stringify(options.body);\n        }\n\n        const controller = new AbortController();\n        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);\n        init.signal = controller.signal;\n\n        for (const interceptor of this.interceptors)\n        {\n            init = await interceptor(url, init);\n        }\n\n        const response = await this.config.fetch(url, init).catch((error) =>\n        {\n            clearTimeout(timeoutId);\n\n            if (error instanceof Error && error.name === 'AbortError')\n            {\n                throw new ApiClientError(\n                    `Request timed out after ${this.config.timeout}ms`,\n                    0,\n                    url,\n                    undefined,\n                    'timeout'\n                );\n            }\n\n            if (error instanceof Error)\n            {\n                throw new ApiClientError(\n                    `Network error: ${error.message}`,\n                    0,\n                    url,\n                    undefined,\n                    'network'\n                );\n            }\n\n            throw error;\n        });\n\n        clearTimeout(timeoutId);\n\n        if (!response.ok)\n        {\n            const errorBody = await response.json().catch(() => null);\n            throw new ApiClientError(\n                `${method} ${urlPath} failed: ${response.status} ${response.statusText}`,\n                response.status,\n                url,\n                errorBody,\n                'http'\n            );\n        }\n\n        const data = await response.json();\n        return data as InferContract<TContract>['response'];\n    }\n\n    /**\n     * Create a new client with merged configuration\n     */\n    withConfig(config: Partial<ClientConfig>): ContractClient\n    {\n        return new ContractClient({\n            baseUrl: config.baseUrl || this.config.baseUrl,\n            headers: { ...this.config.headers, ...config.headers },\n            timeout: config.timeout || this.config.timeout,\n            fetch: config.fetch || this.config.fetch,\n        });\n    }\n\n    private static buildUrl(path: string, params?: Record<string, string | number>): string\n    {\n        if (!params) return path;\n\n        let url = path;\n        for (const [key, value] of Object.entries(params))\n        {\n            url = url.replace(`:${key}`, String(value));\n        }\n\n        return url;\n    }\n\n    private static buildQuery(query?: Record<string, string | string[] | number | boolean>): string\n    {\n        if (!query || Object.keys(query).length === 0) return '';\n\n        const params = new URLSearchParams();\n        for (const [key, value] of Object.entries(query))\n        {\n            if (Array.isArray(value))\n            {\n                value.forEach((v) => params.append(key, String(v)));\n            }\n            else if (value !== undefined && value !== null)\n            {\n                params.append(key, String(value));\n            }\n        }\n\n        const queryString = params.toString();\n        return queryString ? `?${queryString}` : '';\n    }\n\n    private static getHttpMethod<TContract extends RouteContract>(\n        contract: TContract,\n        options?: CallOptions<TContract>\n    ): string\n    {\n        if ('method' in contract && typeof contract.method === 'string')\n        {\n            return contract.method.toUpperCase();\n        }\n\n        if (options?.body !== undefined)\n        {\n            return 'POST';\n        }\n\n        return 'GET';\n    }\n\n    private static isFormData(body: unknown): body is FormData\n    {\n        return body instanceof FormData;\n    }\n}\n\n/**\n * Create a new contract-based API client\n */\nexport function createClient(config?: ClientConfig): ContractClient\n{\n    return new ContractClient(config);\n}\n\n/**\n * Global client singleton instance\n */\nlet _clientInstance: ContractClient = new ContractClient();\n\n/**\n * Configure the global client instance\n *\n * Call this in your app initialization to set default configuration\n * for all auto-generated API calls.\n *\n * @example\n * ```ts\n * // In app initialization (layout.tsx, _app.tsx, etc)\n * import { configureClient } from '@spfn/core/client';\n *\n * configureClient({\n *   baseUrl: process.env.NEXT_PUBLIC_API_URL || 'http://localhost:4000',\n *   timeout: 60000,\n *   headers: {\n *     'X-App-Version': '1.0.0'\n *   }\n * });\n *\n * // Add interceptors\n * import { client } from '@spfn/core/client';\n * client.use(async (url, init) => {\n *   // Add auth header\n *   return {\n *     ...init,\n *     headers: {\n *       ...init.headers,\n *       Authorization: `Bearer ${getToken()}`\n *     }\n *   };\n * });\n * ```\n */\nexport function configureClient(config: ClientConfig): void\n{\n    _clientInstance = new ContractClient(config);\n}\n\n/**\n * Global client singleton with Proxy\n *\n * This client can be configured using configureClient() before use.\n * Used by auto-generated API client code.\n */\nexport const client = new Proxy({} as ContractClient, {\n    get(_target, prop)\n    {\n        return _clientInstance[prop as keyof ContractClient];\n    }\n});\n\n/**\n * Type guard for timeout errors\n *\n * @example\n * ```ts\n * try {\n *   await api.users.getById({ params: { id: '123' } });\n * } catch (error) {\n *   if (isTimeoutError(error)) {\n *     console.error('Request timed out, retrying...');\n *     // Implement retry logic\n *   }\n * }\n * ```\n */\nexport function isTimeoutError(error: unknown): error is ApiClientError\n{\n    return error instanceof ApiClientError && error.errorType === 'timeout';\n}\n\n/**\n * Type guard for network errors\n *\n * @example\n * ```ts\n * try {\n *   await api.users.list();\n * } catch (error) {\n *   if (isNetworkError(error)) {\n *     showOfflineMessage();\n *   }\n * }\n * ```\n */\nexport function isNetworkError(error: unknown): error is ApiClientError\n{\n    return error instanceof ApiClientError && error.errorType === 'network';\n}\n\n/**\n * Type guard for HTTP errors (4xx, 5xx)\n *\n * @example\n * ```ts\n * try {\n *   await api.users.create({ body: userData });\n * } catch (error) {\n *   if (isHttpError(error)) {\n *     if (error.status === 401) {\n *       redirectToLogin();\n *     } else if (error.status === 404) {\n *       showNotFoundMessage();\n *     }\n *   }\n * }\n * ```\n */\nexport function isHttpError(error: unknown): error is ApiClientError\n{\n    return error instanceof ApiClientError && error.errorType === 'http';\n}\n\n/**\n * Check if error is a specific server error type\n *\n * @example\n * ```ts\n * try {\n *   await api.workflows.getById({ params: { uuid: 'xxx' } });\n * } catch (error) {\n *   if (isServerError(error, 'NotFoundError')) {\n *     showNotFoundMessage();\n *   } else if (isServerError(error, 'ValidationError')) {\n *     showValidationErrors(getServerErrorDetails(error));\n *   }\n * }\n * ```\n */\nexport function isServerError(error: unknown, errorType: string): error is ApiClientError\n{\n    if (!isHttpError(error)) return false;\n    const response = error.response as any;\n    return response?.error?.type === errorType;\n}\n\n/**\n * Get server error type from ApiClientError\n *\n * @example\n * ```ts\n * const errorType = getServerErrorType(error);\n * // 'NotFoundError', 'ValidationError', 'PaymentFailedError', etc.\n * ```\n */\nexport function getServerErrorType(error: ApiClientError): string | undefined\n{\n    const response = error.response as any;\n    return response?.error?.type;\n}\n\n/**\n * Get server error details from ApiClientError\n *\n * @example\n * ```ts\n * if (isServerError(error, 'PaymentFailedError')) {\n *   const details = getServerErrorDetails(error);\n *   console.log('Payment ID:', details.paymentId);\n * }\n * ```\n */\nexport function getServerErrorDetails<T = any>(error: ApiClientError): T | undefined\n{\n    const response = error.response as any;\n    return response?.error?.details;\n}\n"]}

package/dist/codegen/generators/index.d.ts

@@ -0,0 +1,19 @@
+import { c as createContractGenerator } from '../../index-DHiAqhKv.js';
+export { C as ContractGeneratorConfig } from '../../index-DHiAqhKv.js';
+
+/**
+ * Built-in Generators Export
+ *
+ * Provides a registry of all built-in generators
+ */
+
+/**
+ * Registry of available generators
+ *
+ * Used by package-based generator loading (e.g., "@spfn/core:contract")
+ */
+declare const generators: {
+    contract: typeof createContractGenerator;
+};
+
+export { createContractGenerator, generators };