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

package/README.md

@@ -204,6 +204,7 @@ export const listPostsContract = {
 // src/server/routes/posts/index.ts
 import { createApp } from '@spfn/core/route';
 import { Transactional } from '@spfn/core/db';
+import { ConflictError } from '@spfn/core/errors';
 import { findPostBySlug, createPost, findPublishedPosts } from '../../repositories/posts.repository';
 import { createPostContract, listPostsContract } from './contracts';
 
@@ -221,7 +222,7 @@ app.bind(createPostContract, [Transactional()], async (c) => {
   // Check if slug exists
   const existing = await findPostBySlug(slug);
   if (existing) {
-    return c.json({ error: 'Post with this title already exists' }, 409);
+    throw new ConflictError('Post with this title already exists', { slug });
   }
 
   // Create post

package/dist/client/index.d.ts

@@ -1,5 +1,5 @@
 import '../auto-loader-JFaZ9gON.js';
-import { a as RouteContract, I as InferContract } from '../types-Dzggq1Yb.js';
+import { a as RouteContract, I as InferContract } from '../types-DYueuoD6.js';
 import 'hono';
 import 'hono/utils/http-status';
 import '@sinclair/typebox';
@@ -169,5 +169,44 @@ declare function isNetworkError(error: unknown): error is ApiClientError;
  * ```
  */
 declare function isHttpError(error: unknown): error is ApiClientError;
+/**
+ * Check if error is a specific server error type
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await api.workflows.getById({ params: { uuid: 'xxx' } });
+ * } catch (error) {
+ *   if (isServerError(error, 'NotFoundError')) {
+ *     showNotFoundMessage();
+ *   } else if (isServerError(error, 'ValidationError')) {
+ *     showValidationErrors(getServerErrorDetails(error));
+ *   }
+ * }
+ * ```
+ */
+declare function isServerError(error: unknown, errorType: string): error is ApiClientError;
+/**
+ * Get server error type from ApiClientError
+ *
+ * @example
+ * ```ts
+ * const errorType = getServerErrorType(error);
+ * // 'NotFoundError', 'ValidationError', 'PaymentFailedError', etc.
+ * ```
+ */
+declare function getServerErrorType(error: ApiClientError): string | undefined;
+/**
+ * Get server error details from ApiClientError
+ *
+ * @example
+ * ```ts
+ * if (isServerError(error, 'PaymentFailedError')) {
+ *   const details = getServerErrorDetails(error);
+ *   console.log('Payment ID:', details.paymentId);
+ * }
+ * ```
+ */
+declare function getServerErrorDetails<T = any>(error: ApiClientError): T | undefined;
 
-export { ApiClientError, type CallOptions, type ClientConfig, ContractClient, type RequestInterceptor, client, configureClient, createClient, isHttpError, isNetworkError, isTimeoutError };
+export { ApiClientError, type CallOptions, type ClientConfig, ContractClient, type RequestInterceptor, client, configureClient, createClient, getServerErrorDetails, getServerErrorType, isHttpError, isNetworkError, isServerError, isTimeoutError };

package/dist/client/index.js

@@ -166,7 +166,20 @@ function isNetworkError(error) {
 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, configureClient, createClient, isHttpError, isNetworkError, isTimeoutError };
+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 */\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        const queryString = ContractClient.buildQuery(\n            options?.query as Record<string, string | string[] | number | boolean> | undefined\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"]}
+{"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.js

@@ -1247,7 +1247,7 @@ function generateIndexFile(grouped, options) {
       }
     }
     if (typeNames.length > 0) {
-      code += `export type { ${typeNames.join(", ")} } from './${kebabName}.js';
+      code += `export type { ${typeNames.join(", ")} } from './${kebabName}';
 `;
     }
   }
@@ -1258,7 +1258,7 @@ function generateIndexFile(grouped, options) {
     const routes = grouped[resourceName];
     const kebabName = toKebabCase(resourceName);
     const functionNames = routes.map((route) => generateFunctionName(route));
-    code += `import { ${functionNames.join(", ")} } from './${kebabName}.js';
+    code += `import { ${functionNames.join(", ")} } from './${kebabName}';
 `;
   }
   code += `