@spfn/core 0.1.0-alpha.56 → 0.1.0-alpha.60

package/dist/{auto-loader-s1OVKtxe.d.ts → auto-loader-CdsxOceW.d.ts}

@@ -38,8 +38,7 @@ type RouteStats = {
 declare class AutoRouteLoader {
     private routesDir;
     private routes;
-    private registeredRoutes;
-    private debug;
+    private readonly debug;
     private readonly middlewares;
     constructor(routesDir: string, debug?: boolean, middlewares?: Array<{
         name: string;
@@ -47,23 +46,24 @@ declare class AutoRouteLoader {
     }>);
     load(app: Hono): Promise<RouteStats>;
     /**
-     * Load routes from a directory and mount with basePath prefix
-     * Used for loading function routes
+     * Load routes from an external directory (e.g., from SPFN function packages)
+     * Routes use contract-based absolute paths, so no basePath prefix needed
+     *
+     * @param app - Hono app instance
+     * @param routesDir - Directory containing route handlers
+     * @param packageName - Name of the package (for logging)
+     * @returns Route statistics
      */
-    loadWithBasePath(app: Hono, routesDir: string, basePath: string): Promise<RouteStats>;
+    loadExternalRoutes(app: Hono, routesDir: string, packageName: string): Promise<RouteStats>;
     getStats(): RouteStats;
     private scanFiles;
     private isValidRouteFile;
     private loadRoute;
+    private extractContractPaths;
+    private calculateContractPriority;
     private validateModule;
-    private checkRouteConflict;
     private registerContractBasedMiddlewares;
-    private registerFileBasedMiddlewares;
     private categorizeAndLogError;
-    private fileToPath;
-    private calculatePriority;
-    private normalizePath;
-    private logRegistrationOrder;
     private logStats;
 }
 declare function loadRoutes(app: Hono, options?: {

package/dist/client/index.d.ts

@@ -1,4 +1,4 @@
-import '../auto-loader-s1OVKtxe.js';
+import '../auto-loader-CdsxOceW.js';
 import { R as RouteContract, I as InferContract } from '../types-Bd8YsFSU.js';
 import 'hono';
 import 'hono/utils/http-status';
@@ -60,24 +60,14 @@ declare class ContractClient {
     /**
      * Make a type-safe API call using a contract
      *
-     * @param basePath - Base path from file-based routing (e.g., '/organizations')
-     * @param contract - Route contract
+     * @param contract - Route contract with absolute path
      * @param options - Call options (params, query, body, headers)
      */
-    call<TContract extends RouteContract>(basePath: string, contract: TContract, options?: CallOptions<TContract>): Promise<InferContract<TContract>['response']>;
+    call<TContract extends RouteContract>(contract: TContract, options?: CallOptions<TContract>): Promise<InferContract<TContract>['response']>;
     /**
      * Create a new client with merged configuration
      */
     withConfig(config: Partial<ClientConfig>): ContractClient;
-    /**
-     * Combine basePath and contract.path, handling trailing/leading slashes
-     *
-     * @example
-     * combinePaths('/organizations', '/') → '/organizations'
-     * combinePaths('/organizations', '/:id') → '/organizations/:id'
-     * combinePaths('/', '/health') → '/health'
-     */
-    private static combinePaths;
     private static buildUrl;
     private static buildQuery;
     private static getHttpMethod;

package/dist/client/index.js

@@ -29,15 +29,13 @@ var ContractClient = class _ContractClient {
   /**
    * Make a type-safe API call using a contract
    *
-   * @param basePath - Base path from file-based routing (e.g., '/organizations')
-   * @param contract - Route contract
+   * @param contract - Route contract with absolute path
    * @param options - Call options (params, query, body, headers)
    */
-  async call(basePath, contract, options) {
+  async call(contract, options) {
     const baseUrl = options?.baseUrl || this.config.baseUrl;
-    const combinedPath = _ContractClient.combinePaths(basePath, contract.path);
     const urlPath = _ContractClient.buildUrl(
-      combinedPath,
+      contract.path,
       options?.params
     );
     const queryString = _ContractClient.buildQuery(
@@ -113,22 +111,6 @@ var ContractClient = class _ContractClient {
       fetch: config.fetch || this.config.fetch
     });
   }
-  /**
-   * Combine basePath and contract.path, handling trailing/leading slashes
-   *
-   * @example
-   * combinePaths('/organizations', '/') → '/organizations'
-   * combinePaths('/organizations', '/:id') → '/organizations/:id'
-   * combinePaths('/', '/health') → '/health'
-   */
-  static combinePaths(basePath, contractPath) {
-    const normalizedBase = basePath === "/" ? "" : basePath.replace(/\/$/, "");
-    const normalizedContract = contractPath.replace(/^\//, "");
-    if (!normalizedContract || normalizedContract === "") {
-      return basePath;
-    }
-    return `${normalizedBase}/${normalizedContract}`;
-  }
   static buildUrl(path, params) {
     if (!params) return path;
     let url = path;

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/client/contract-client.ts"],"names":[],"mappings":";AA+CO,IAAM,cAAA,GAAN,cAA6B,KAAA,CACpC;AAAA,EACI,WAAA,CACI,OAAA,EACgB,MAAA,EACA,GAAA,EACA,UACA,SAAA,EAEpB;AACI,IAAA,KAAA,CAAM,OAAO,CAAA;AANG,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AACA,IAAA,IAAA,CAAA,GAAA,GAAA,GAAA;AACA,IAAA,IAAA,CAAA,QAAA,GAAA,QAAA;AACA,IAAA,IAAA,CAAA,SAAA,GAAA,SAAA;AAIhB,IAAA,IAAA,CAAK,IAAA,GAAO,gBAAA;AAAA,EAChB;AACJ;AAKO,IAAM,cAAA,GAAN,MAAM,eAAA,CACb;AAAA,EACqB,MAAA;AAAA,EACA,eAAqC,EAAC;AAAA,EAEvD,WAAA,CAAY,MAAA,GAAuB,EAAC,EACpC;AACI,IAAA,IAAA,CAAK,MAAA,GAAS;AAAA,MACV,OAAA,EAAS,OAAO,OAAA,IAAW,OAAA,CAAQ,IAAI,cAAA,IAAkB,OAAA,CAAQ,IAAI,mBAAA,IAAuB,uBAAA;AAAA,MAC5F,OAAA,EAAS,MAAA,CAAO,OAAA,IAAW,EAAC;AAAA,MAC5B,OAAA,EAAS,OAAO,OAAA,IAAW,GAAA;AAAA,MAC3B,OAAO,MAAA,CAAO,KAAA,IAAS,UAAA,CAAW,KAAA,CAAM,KAAK,UAAU;AAAA,KAC3D;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,WAAA,EACJ;AACI,IAAA,IAAA,CAAK,YAAA,CAAa,KAAK,WAAW,CAAA;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,IAAA,CACF,QAAA,EACA,QAAA,EACA,OAAA,EAEJ;AACI,IAAA,MAAM,OAAA,GAAU,OAAA,EAAS,OAAA,IAAW,IAAA,CAAK,MAAA,CAAO,OAAA;AAGhD,IAAA,MAAM,YAAA,GAAe,eAAA,CAAe,YAAA,CAAa,QAAA,EAAU,SAAS,IAAI,CAAA;AAExE,IAAA,MAAM,UAAU,eAAA,CAAe,QAAA;AAAA,MAC3B,YAAA;AAAA,MACA,OAAA,EAAS;AAAA,KACb;AACA,IAAA,MAAM,cAAc,eAAA,CAAe,UAAA;AAAA,MAC/B,OAAA,EAAS;AAAA,KACb;AACA,IAAA,MAAM,MAAM,CAAA,EAAG,OAAO,CAAA,EAAG,OAAO,GAAG,WAAW,CAAA,CAAA;AAE9C,IAAA,MAAM,MAAA,GAAS,eAAA,CAAe,aAAA,CAAc,QAAA,EAAU,OAAO,CAAA;AAE7D,IAAA,MAAM,OAAA,GAAkC;AAAA,MACpC,GAAG,KAAK,MAAA,CAAO,OAAA;AAAA,MACf,GAAG,OAAA,EAAS;AAAA,KAChB;AAEA,IAAA,MAAM,UAAA,GAAa,eAAA,CAAe,UAAA,CAAW,OAAA,EAAS,IAAI,CAAA;AAE1D,IAAA,IAAI,OAAA,EAAS,SAAS,MAAA,IAAa,CAAC,cAAc,CAAC,OAAA,CAAQ,cAAc,CAAA,EACzE;AACI,MAAA,OAAA,CAAQ,cAAc,CAAA,GAAI,kBAAA;AAAA,IAC9B;AAEA,IAAA,IAAI,IAAA,GAAoB;AAAA,MACpB,MAAA;AAAA,MACA;AAAA,KACJ;AAEA,IAAA,IAAI,OAAA,EAAS,SAAS,MAAA,EACtB;AACI,MAAA,IAAA,CAAK,OAAO,UAAA,GAAc,OAAA,CAAQ,OAAoB,IAAA,CAAK,SAAA,CAAU,QAAQ,IAAI,CAAA;AAAA,IACrF;AAEA,IAAA,MAAM,UAAA,GAAa,IAAI,eAAA,EAAgB;AACvC,IAAA,MAAM,SAAA,GAAY,WAAW,MAAM,UAAA,CAAW,OAAM,EAAG,IAAA,CAAK,OAAO,OAAO,CAAA;AAC1E,IAAA,IAAA,CAAK,SAAS,UAAA,CAAW,MAAA;AAEzB,IAAA,KAAA,MAAW,WAAA,IAAe,KAAK,YAAA,EAC/B;AACI,MAAA,IAAA,GAAO,MAAM,WAAA,CAAY,GAAA,EAAK,IAAI,CAAA;AAAA,IACtC;AAEA,IAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,MAAA,CAAO,KAAA,CAAM,KAAK,IAAI,CAAA,CAAE,KAAA,CAAM,CAAC,KAAA,KAC3D;AACI,MAAA,YAAA,CAAa,SAAS,CAAA;AAEtB,MAAA,IAAI,KAAA,YAAiB,KAAA,IAAS,KAAA,CAAM,IAAA,KAAS,YAAA,EAC7C;AACI,QAAA,MAAM,IAAI,cAAA;AAAA,UACN,CAAA,wBAAA,EAA2B,IAAA,CAAK,MAAA,CAAO,OAAO,CAAA,EAAA,CAAA;AAAA,UAC9C,CAAA;AAAA,UACA,GAAA;AAAA,UACA,MAAA;AAAA,UACA;AAAA,SACJ;AAAA,MACJ;AAEA,MAAA,IAAI,iBAAiB,KAAA,EACrB;AACI,QAAA,MAAM,IAAI,cAAA;AAAA,UACN,CAAA,eAAA,EAAkB,MAAM,OAAO,CAAA,CAAA;AAAA,UAC/B,CAAA;AAAA,UACA,GAAA;AAAA,UACA,MAAA;AAAA,UACA;AAAA,SACJ;AAAA,MACJ;AAEA,MAAA,MAAM,KAAA;AAAA,IACV,CAAC,CAAA;AAED,IAAA,YAAA,CAAa,SAAS,CAAA;AAEtB,IAAA,IAAI,CAAC,SAAS,EAAA,EACd;AACI,MAAA,MAAM,YAAY,MAAM,QAAA,CAAS,MAAK,CAAE,KAAA,CAAM,MAAM,IAAI,CAAA;AACxD,MAAA,MAAM,IAAI,cAAA;AAAA,QACN,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,OAAO,YAAY,QAAA,CAAS,MAAM,CAAA,CAAA,EAAI,QAAA,CAAS,UAAU,CAAA,CAAA;AAAA,QACtE,QAAA,CAAS,MAAA;AAAA,QACT,GAAA;AAAA,QACA,SAAA;AAAA,QACA;AAAA,OACJ;AAAA,IACJ;AAEA,IAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,IAAA,EAAK;AACjC,IAAA,OAAO,IAAA;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW,MAAA,EACX;AACI,IAAA,OAAO,IAAI,eAAA,CAAe;AAAA,MACtB,OAAA,EAAS,MAAA,CAAO,OAAA,IAAW,IAAA,CAAK,MAAA,CAAO,OAAA;AAAA,MACvC,OAAA,EAAS,EAAE,GAAG,IAAA,CAAK,OAAO,OAAA,EAAS,GAAG,OAAO,OAAA,EAAQ;AAAA,MACrD,OAAA,EAAS,MAAA,CAAO,OAAA,IAAW,IAAA,CAAK,MAAA,CAAO,OAAA;AAAA,MACvC,KAAA,EAAO,MAAA,CAAO,KAAA,IAAS,IAAA,CAAK,MAAA,CAAO;AAAA,KACtC,CAAA;AAAA,EACL;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,OAAe,YAAA,CAAa,QAAA,EAAkB,YAAA,EAC9C;AAEI,IAAA,MAAM,iBAAiB,QAAA,KAAa,GAAA,GAAM,KAAK,QAAA,CAAS,OAAA,CAAQ,OAAO,EAAE,CAAA;AAGzE,IAAA,MAAM,kBAAA,GAAqB,YAAA,CAAa,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAA;AAGzD,IAAA,IAAI,CAAC,kBAAA,IAAsB,kBAAA,KAAuB,EAAA,EAClD;AACI,MAAA,OAAO,QAAA;AAAA,IACX;AAGA,IAAA,OAAO,CAAA,EAAG,cAAc,CAAA,CAAA,EAAI,kBAAkB,CAAA,CAAA;AAAA,EAClD;AAAA,EAEA,OAAe,QAAA,CAAS,IAAA,EAAc,MAAA,EACtC;AACI,IAAA,IAAI,CAAC,QAAQ,OAAO,IAAA;AAEpB,IAAA,IAAI,GAAA,GAAM,IAAA;AACV,IAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,EAChD;AACI,MAAA,GAAA,GAAM,IAAI,OAAA,CAAQ,CAAA,CAAA,EAAI,GAAG,CAAA,CAAA,EAAI,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,IAC9C;AAEA,IAAA,OAAO,GAAA;AAAA,EACX;AAAA,EAEA,OAAe,WAAW,KAAA,EAC1B;AACI,IAAA,IAAI,CAAC,SAAS,MAAA,CAAO,IAAA,CAAK,KAAK,CAAA,CAAE,MAAA,KAAW,GAAG,OAAO,EAAA;AAEtD,IAAA,MAAM,MAAA,GAAS,IAAI,eAAA,EAAgB;AACnC,IAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA,EAC/C;AACI,MAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EACvB;AACI,QAAA,KAAA,CAAM,OAAA,CAAQ,CAAC,CAAA,KAAM,MAAA,CAAO,OAAO,GAAA,EAAK,MAAA,CAAO,CAAC,CAAC,CAAC,CAAA;AAAA,MACtD,CAAA,MAAA,IACS,KAAA,KAAU,MAAA,IAAa,KAAA,KAAU,IAAA,EAC1C;AACI,QAAA,MAAA,CAAO,MAAA,CAAO,GAAA,EAAK,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,MACpC;AAAA,IACJ;AAEA,IAAA,MAAM,WAAA,GAAc,OAAO,QAAA,EAAS;AACpC,IAAA,OAAO,WAAA,GAAc,CAAA,CAAA,EAAI,WAAW,CAAA,CAAA,GAAK,EAAA;AAAA,EAC7C;AAAA,EAEA,OAAe,aAAA,CACX,QAAA,EACA,OAAA,EAEJ;AACI,IAAA,IAAI,QAAA,IAAY,QAAA,IAAY,OAAO,QAAA,CAAS,WAAW,QAAA,EACvD;AACI,MAAA,OAAO,QAAA,CAAS,OAAO,WAAA,EAAY;AAAA,IACvC;AAEA,IAAA,IAAI,OAAA,EAAS,SAAS,MAAA,EACtB;AACI,MAAA,OAAO,MAAA;AAAA,IACX;AAEA,IAAA,OAAO,KAAA;AAAA,EACX;AAAA,EAEA,OAAe,WAAW,IAAA,EAC1B;AACI,IAAA,OAAO,IAAA,YAAgB,QAAA;AAAA,EAC3B;AACJ;AAKO,SAAS,aAAa,MAAA,EAC7B;AACI,EAAA,OAAO,IAAI,eAAe,MAAM,CAAA;AACpC;AAKA,IAAI,eAAA,GAAkC,IAAI,cAAA,EAAe;AAmClD,SAAS,gBAAgB,MAAA,EAChC;AACI,EAAA,eAAA,GAAkB,IAAI,eAAe,MAAM,CAAA;AAC/C;AAQO,IAAM,MAAA,GAAS,IAAI,KAAA,CAAM,EAAC,EAAqB;AAAA,EAClD,GAAA,CAAI,SAAS,IAAA,EACb;AACI,IAAA,OAAO,gBAAgB,IAA4B,CAAA;AAAA,EACvD;AACJ,CAAC;AAiBM,SAAS,eAAe,KAAA,EAC/B;AACI,EAAA,OAAO,KAAA,YAAiB,cAAA,IAAkB,KAAA,CAAM,SAAA,KAAc,SAAA;AAClE;AAgBO,SAAS,eAAe,KAAA,EAC/B;AACI,EAAA,OAAO,KAAA,YAAiB,cAAA,IAAkB,KAAA,CAAM,SAAA,KAAc,SAAA;AAClE;AAoBO,SAAS,YAAY,KAAA,EAC5B;AACI,EAAA,OAAO,KAAA,YAAiB,cAAA,IAAkB,KAAA,CAAM,SAAA,KAAc,MAAA;AAClE","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 basePath - Base path from file-based routing (e.g., '/organizations')\n     * @param contract - Route contract\n     * @param options - Call options (params, query, body, headers)\n     */\n    async call<TContract extends RouteContract>(\n        basePath: string,\n        contract: TContract,\n        options?: CallOptions<TContract>\n    ): Promise<InferContract<TContract>['response']>\n    {\n        const baseUrl = options?.baseUrl || this.config.baseUrl;\n\n        // Combine basePath and contract.path, handling trailing/leading slashes\n        const combinedPath = ContractClient.combinePaths(basePath, contract.path);\n\n        const urlPath = ContractClient.buildUrl(\n            combinedPath,\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    /**\n     * Combine basePath and contract.path, handling trailing/leading slashes\n     *\n     * @example\n     * combinePaths('/organizations', '/') → '/organizations'\n     * combinePaths('/organizations', '/:id') → '/organizations/:id'\n     * combinePaths('/', '/health') → '/health'\n     */\n    private static combinePaths(basePath: string, contractPath: string): string\n    {\n        // Remove trailing slash from basePath (unless it's root '/')\n        const normalizedBase = basePath === '/' ? '' : basePath.replace(/\\/$/, '');\n\n        // Remove leading slash from contractPath\n        const normalizedContract = contractPath.replace(/^\\//, '');\n\n        // If contractPath is empty or just '/', return basePath\n        if (!normalizedContract || normalizedContract === '')\n        {\n            return basePath;\n        }\n\n        // Combine with single slash\n        return `${normalizedBase}/${normalizedContract}`;\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        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"]}

package/dist/codegen/generators/index.js

@@ -1,7 +1,7 @@
 import { join, dirname } from 'path';
+import { existsSync, mkdirSync, accessSync, constants, writeFileSync, unlinkSync, createWriteStream, statSync, readdirSync, renameSync, readFileSync } from 'fs';
 import { mkdir, writeFile, readdir, stat } from 'fs/promises';
 import * as ts from 'typescript';
-import { existsSync, mkdirSync, accessSync, constants, writeFileSync, unlinkSync, createWriteStream, statSync, readdirSync, renameSync, readFileSync } from 'fs';
 import pino from 'pino';
 
 // src/codegen/generators/contract-generator.ts
@@ -11,15 +11,24 @@ async function scanContracts(routesDir) {
   for (let i = 0; i < contractFiles.length; i++) {
     const filePath = contractFiles[i];
     const exports = extractContractExports(filePath);
-    const basePath = getBasePathFromFile(filePath, routesDir);
     for (let j = 0; j < exports.length; j++) {
       const contractExport = exports[j];
-      const fullPath = combinePaths(basePath, contractExport.path);
+      const isAbsolutePath = contractExport.path.startsWith("/") && contractExport.path.length > 1;
+      let fullPath;
+      let importPath;
+      if (isAbsolutePath) {
+        fullPath = contractExport.path;
+        importPath = getImportPath(filePath, routesDir);
+      } else {
+        const basePath = getBasePathFromFile(filePath, routesDir);
+        fullPath = combinePaths(basePath, contractExport.path);
+        importPath = getImportPathFromRoutes(filePath, routesDir);
+      }
       mappings.push({
         method: contractExport.method,
         path: fullPath,
         contractName: contractExport.name,
-        contractImportPath: getImportPathFromRoutes(filePath, routesDir),
+        contractImportPath: importPath,
         routeFile: "",
         // Not needed anymore
         contractFile: filePath,
@@ -34,14 +43,21 @@ async function scanContracts(routesDir) {
 async function scanContractFiles(dir, files = []) {
   try {
     const entries = await readdir(dir);
+    const isLibContracts = dir.includes("/lib/contracts");
     for (let i = 0; i < entries.length; i++) {
       const entry = entries[i];
       const fullPath = join(dir, entry);
       const fileStat = await stat(fullPath);
       if (fileStat.isDirectory()) {
         await scanContractFiles(fullPath, files);
-      } else if (entry === "contract.ts") {
-        files.push(fullPath);
+      } else if (isLibContracts) {
+        if (entry.endsWith(".ts") && !entry.endsWith(".d.ts") && !entry.endsWith(".test.ts")) {
+          files.push(fullPath);
+        }
+      } else {
+        if (entry === "contract.ts") {
+          files.push(fullPath);
+        }
       }
     }
   } catch (error) {
@@ -66,15 +82,26 @@ function extractContractExports(filePath) {
         const declaration = node.declarationList.declarations[0];
         if (ts.isVariableDeclaration(declaration) && ts.isIdentifier(declaration.name) && declaration.initializer) {
           const name = declaration.name.text;
-          if (isContractName(name)) {
-            let objectLiteral;
-            if (ts.isObjectLiteralExpression(declaration.initializer)) {
-              objectLiteral = declaration.initializer;
-            } else if (ts.isSatisfiesExpression(declaration.initializer) && ts.isAsExpression(declaration.initializer.expression) && ts.isObjectLiteralExpression(declaration.initializer.expression.expression)) {
-              objectLiteral = declaration.initializer.expression.expression;
-            } else if (ts.isAsExpression(declaration.initializer) && ts.isObjectLiteralExpression(declaration.initializer.expression)) {
-              objectLiteral = declaration.initializer.expression;
+          const hasSatisfiesRouteContract = checkSatisfiesRouteContract(declaration.initializer);
+          if (hasSatisfiesRouteContract) {
+            const objectLiteral = extractObjectLiteral(declaration.initializer);
+            if (objectLiteral) {
+              const contractData = extractContractData(objectLiteral);
+              if (contractData.method && contractData.path) {
+                exports.push({
+                  name,
+                  method: contractData.method,
+                  path: contractData.path,
+                  hasQuery: contractData.hasQuery,
+                  hasBody: contractData.hasBody,
+                  hasParams: contractData.hasParams
+                });
+              }
             }
+            return;
+          }
+          if (isContractName(name)) {
+            const objectLiteral = extractObjectLiteral(declaration.initializer);
             if (objectLiteral) {
               const contractData = extractContractData(objectLiteral);
               if (contractData.method && contractData.path) {
@@ -97,6 +124,28 @@ function extractContractExports(filePath) {
   visit(sourceFile);
   return exports;
 }
+function checkSatisfiesRouteContract(initializer) {
+  if (!ts.isSatisfiesExpression(initializer)) {
+    return false;
+  }
+  const typeNode = initializer.type;
+  if (ts.isTypeReferenceNode(typeNode) && ts.isIdentifier(typeNode.typeName)) {
+    return typeNode.typeName.text === "RouteContract";
+  }
+  return false;
+}
+function extractObjectLiteral(initializer) {
+  if (ts.isObjectLiteralExpression(initializer)) {
+    return initializer;
+  }
+  if (ts.isSatisfiesExpression(initializer)) {
+    return extractObjectLiteral(initializer.expression);
+  }
+  if (ts.isAsExpression(initializer)) {
+    return extractObjectLiteral(initializer.expression);
+  }
+  return void 0;
+}
 function extractContractData(objectLiteral) {
   const result = {};
   for (let i = 0; i < objectLiteral.properties.length; i++) {
@@ -187,6 +236,18 @@ function getImportPathFromRoutes(filePath, routesDir) {
   }
   return "@/server/routes/" + relativePath;
 }
+function getImportPath(filePath, scanDir) {
+  const srcIndex = filePath.indexOf("/src/");
+  if (srcIndex === -1) {
+    return getImportPathFromRoutes(filePath, scanDir);
+  }
+  const fromSrc = filePath.substring(srcIndex + 5);
+  let cleanPath = fromSrc;
+  if (cleanPath.endsWith(".ts")) {
+    cleanPath = cleanPath.slice(0, -3);
+  }
+  return "@/" + cleanPath;
+}
 
 // src/codegen/route-scanner.ts
 function groupByResource(mappings) {
@@ -377,8 +438,7 @@ function generateMethodCode(mapping, options) {
     code += `options: { ${params.join(", ")} }`;
   }
   code += `) => `;
-  const basePath = mapping.path.replace(/\/:[^/]+$/, "") || "/";
-  code += `client.call('${basePath}', ${mapping.contractName}`;
+  code += `client.call(${mapping.contractName}`;
   if (params.length > 0) {
     code += `, options`;
   }
@@ -1210,20 +1270,32 @@ var contractLogger = logger.child("contract-gen");
 function createContractGenerator(config = {}) {
   return {
     name: "contract",
-    watchPatterns: [config.routesDir ?? "src/server/routes/**/*.ts"],
+    watchPatterns: [
+      config.routesDir ?? "src/server/routes/**/*.ts",
+      "src/lib/contracts/**/*.ts"
+    ],
     async generate(options) {
       const cwd = options.cwd;
       const routesDir = config.routesDir ?? join(cwd, "src", "server", "routes");
+      const libContractsDir = join(cwd, "src", "lib", "contracts");
       const outputPath = config.outputPath ?? join(cwd, "src", "lib", "api.ts");
       try {
-        const contracts = await scanContracts(routesDir);
-        if (contracts.length === 0) {
+        const contractDirs = [routesDir];
+        if (existsSync(libContractsDir)) {
+          contractDirs.push(libContractsDir);
+        }
+        let allContracts = [];
+        for (const dir of contractDirs) {
+          const contracts = await scanContracts(dir);
+          allContracts = allContracts.concat(contracts);
+        }
+        if (allContracts.length === 0) {
           if (options.debug) {
             contractLogger.warn("No contracts found");
           }
           return;
         }
-        const stats = await generateClient(contracts, {
+        const stats = await generateClient(allContracts, {
           outputPath});
         if (options.debug) {
           contractLogger.info("Client generated", {