@spfn/core 0.1.0-alpha.88 → 0.2.0-beta.10

package/dist/nextjs/index.js

@@ -0,0 +1,448 @@
+import { env } from '@spfn/core/config';
+import { ErrorRegistry, errorRegistry } from '@spfn/core/errors';
+import { logger } from '@spfn/core/logger';
+
+// src/nextjs/client/core.ts
+
+// src/nextjs/client/debug-logs.ts
+function logCookieAutoDetection(logger2, cookies) {
+  logger2.debug("Auto-detected server environment, forwarding cookies", {
+    cookieCount: cookies.length,
+    cookieNames: cookies.map((c) => c.name)
+  });
+}
+function logRequest(logger2, routeName, method, url, hasBody) {
+  logger2.debug("\u2192 Request", {
+    route: routeName,
+    method,
+    url,
+    hasBody
+  });
+}
+function logResponse(logger2, routeName, status, hasBody) {
+  logger2.debug("\u2190 Response", {
+    route: routeName,
+    status,
+    hasBody
+  });
+}
+function logErrorResponse(logger2, status, body) {
+  logger2.debug("Error response received", {
+    status,
+    hasBody: !!body,
+    bodyType: typeof body,
+    hasTypeField: body && typeof body === "object" && "__type" in body,
+    typeValue: body?.__type
+  });
+}
+function logErrorDeserializationAttempt(logger2, errorType, registeredTypes) {
+  logger2.debug("Attempting error deserialization", {
+    errorType,
+    hasRegistry: true,
+    registeredTypes
+  });
+}
+function logErrorDeserializationSuccess(logger2, error) {
+  logger2.debug("Error deserialized successfully", {
+    errorName: error?.name,
+    errorConstructor: error?.constructor.name,
+    message: error?.message
+  });
+}
+function logErrorDeserializationFailure(logger2, error) {
+  logger2.debug("Deserialization failed", {
+    errorName: error instanceof Error ? error.name : "unknown",
+    errorMessage: error instanceof Error ? error.message : String(error)
+  });
+}
+function logErrorDeserializationSkipped(logger2, errorRegistry, body) {
+  const reason = !errorRegistry ? "no registry" : !body ? "no body" : typeof body !== "object" ? "body not object" : !("__type" in body) ? "no __type field" : "unknown";
+  logger2.debug("Skipping error deserialization", { reason });
+}
+function logThrowingDeserializedError(logger2, error) {
+  logger2.debug("Throwing deserialized error", {
+    errorName: error.name,
+    errorConstructorName: error.constructor.name,
+    prototype: Object.getPrototypeOf(error).constructor.name
+  });
+}
+
+// src/nextjs/client/errors.ts
+var ApiError = class extends Error {
+  constructor(message, status, url, response, errorType) {
+    super(message);
+    this.status = status;
+    this.url = url;
+    this.response = response;
+    this.errorType = errorType;
+    this.name = "ApiError";
+  }
+};
+
+// src/nextjs/shared.ts
+function buildCookieHeader(cookies) {
+  return Object.entries(cookies).map(([key, value]) => `${key}=${value}`).join("; ");
+}
+async function parseResponseBody(response) {
+  if (response.status === 204) {
+    return null;
+  }
+  const contentType = response.headers.get("content-type");
+  if (contentType?.includes("application/json")) {
+    const text = await response.text();
+    return text ? JSON.parse(text) : null;
+  } else {
+    return await response.text();
+  }
+}
+
+// src/nextjs/client/helpers.ts
+async function autoDetectServerCookies() {
+  try {
+    const { cookies } = await import('next/headers');
+    const cookieStore = await cookies();
+    const allCookies = cookieStore.getAll();
+    return Object.fromEntries(
+      allCookies.map((cookie) => [cookie.name, cookie.value])
+    );
+  } catch (error) {
+    return {};
+  }
+}
+async function executeFetchWithTimeout(url, init, timeout, customFetch = fetch) {
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), timeout);
+  try {
+    const response = await customFetch(url, {
+      ...init,
+      signal: controller.signal
+    });
+    clearTimeout(timeoutId);
+    return response;
+  } catch (error) {
+    clearTimeout(timeoutId);
+    throw error;
+  }
+}
+async function handleErrorResponse(response, body, fullUrl, errorRegistry, debug, logger2) {
+  if (debug) {
+    logErrorResponse(logger2, response.status, body);
+  }
+  let deserializedError = null;
+  if (errorRegistry && body && typeof body === "object" && "__type" in body) {
+    if (debug) {
+      logErrorDeserializationAttempt(logger2, body.__type, errorRegistry.getRegisteredTypes());
+    }
+    try {
+      deserializedError = errorRegistry.deserialize(body);
+      if (debug) {
+        logErrorDeserializationSuccess(logger2, deserializedError);
+      }
+    } catch (deserializeError) {
+      if (debug) {
+        logErrorDeserializationFailure(logger2, deserializeError);
+      }
+    }
+  } else if (debug) {
+    logErrorDeserializationSkipped(logger2, errorRegistry, body);
+  }
+  if (deserializedError) {
+    if (debug) {
+      logThrowingDeserializedError(logger2, deserializedError);
+    }
+    throw deserializedError;
+  }
+  if (response.status === 404 && process.env.NODE_ENV !== "production") {
+    logger2.warn(
+      "\n\u26A0\uFE0F  404 Not Found\n\nCheck the following:\n  1. Routes are registered in server.config.ts:\n     \u2192 defineServerConfig().routes(appRouter)\n  2. Delete .spfn cache if you recently added new routes:\n     \u2192 rm -rf .spfn\n"
+    );
+  }
+  throw new ApiError(
+    body?.message || `HTTP ${response.status}: ${response.statusText}`,
+    response.status,
+    fullUrl,
+    body,
+    "http"
+  );
+}
+
+// src/nextjs/client/builder.ts
+var RouteCallBuilder = class _RouteCallBuilder {
+  constructor(executor, routeName) {
+    this.executor = executor;
+    this.routeName = routeName;
+  }
+  _headers;
+  _cookies;
+  _fetchOptions;
+  _onRequest;
+  _onResponse;
+  /**
+   * Clone builder
+   */
+  clone() {
+    const builder = new _RouteCallBuilder(
+      this.executor,
+      this.routeName
+    );
+    builder._headers = this._headers;
+    builder._cookies = this._cookies;
+    builder._fetchOptions = this._fetchOptions;
+    builder._onRequest = this._onRequest;
+    builder._onResponse = this._onResponse;
+    return builder;
+  }
+  /**
+   * Set request headers
+   */
+  headers(headers) {
+    const builder = this.clone();
+    builder._headers = { ...this._headers, ...headers };
+    return builder;
+  }
+  /**
+   * Set cookies
+   */
+  cookies(cookies) {
+    const builder = this.clone();
+    builder._cookies = { ...this._cookies, ...cookies };
+    return builder;
+  }
+  /**
+   * Set Next.js fetch options
+   */
+  fetchOptions(options) {
+    const builder = this.clone();
+    builder._fetchOptions = { ...this._fetchOptions, ...options };
+    return builder;
+  }
+  /**
+   * Set request interceptor
+   */
+  onRequest(interceptor) {
+    const builder = this.clone();
+    builder._onRequest = interceptor;
+    return builder;
+  }
+  /**
+   * Set response interceptor
+   */
+  onResponse(interceptor) {
+    const builder = this.clone();
+    builder._onResponse = interceptor;
+    return builder;
+  }
+  /**
+   * Execute the API call with structured input
+   *
+   * Input structure matches the server-side route definition:
+   * - params: Path parameters (e.g., { id: '123' } for /users/:id)
+   * - query: Query string parameters
+   * - body: Request body (for POST, PUT, PATCH)
+   */
+  call(input) {
+    const options = {};
+    if (this._headers) {
+      options.headers = this._headers;
+    }
+    if (this._cookies) {
+      options.cookies = this._cookies;
+    }
+    if (this._fetchOptions) {
+      options.fetchOptions = this._fetchOptions;
+    }
+    if (this._onRequest) {
+      options.onRequest = this._onRequest;
+    }
+    if (this._onResponse) {
+      options.onResponse = this._onResponse;
+    }
+    return this.executor(input || {}, options);
+  }
+};
+
+// src/nextjs/client/core.ts
+var apiLogger = logger.child("@spfn/core:api-client");
+function createApi(config = {}) {
+  const {
+    baseUrl = "/api/rpc",
+    headers: defaultHeaders = {},
+    timeout = 3e4,
+    fetch: customFetch = fetch,
+    onRequest: globalOnRequest,
+    onResponse: globalOnResponse,
+    errorRegistry: errorRegistryConfig,
+    debug = false
+  } = config;
+  const errorRegistry$1 = Array.isArray(errorRegistryConfig) ? new ErrorRegistry([errorRegistry, ...errorRegistryConfig]) : errorRegistryConfig ?? errorRegistry;
+  if (debug) {
+    apiLogger.debug("API client initialized", { baseUrl });
+  }
+  async function executeCall(routeName, input = {}, options = {}) {
+    const hasBody = input.body !== void 0;
+    const hasFormData = input.formData !== void 0 && Object.keys(input.formData).length > 0;
+    const method = hasBody || hasFormData ? "POST" : "GET";
+    let appUrl = env.SPFN_APP_URL || "";
+    if (!appUrl && typeof window === "undefined") {
+      try {
+        const { headers: headers2 } = await import('next/headers');
+        const headersList = await headers2();
+        const host = headersList.get("host");
+        const protocol = headersList.get("x-forwarded-proto") || "http";
+        if (host) {
+          appUrl = `${protocol}://${host}`;
+          if (debug) {
+            apiLogger.debug(`Auto-detected app URL from headers: ${appUrl}`);
+          }
+        }
+      } catch {
+        if (debug) {
+          apiLogger.warn("Could not determine app URL in SSR environment, using relative URL");
+        }
+      }
+    }
+    let fullUrl;
+    if (method === "GET") {
+      const inputParam = encodeURIComponent(JSON.stringify(input));
+      fullUrl = `${appUrl}${baseUrl}/${routeName}?input=${inputParam}`;
+    } else {
+      fullUrl = `${appUrl}${baseUrl}/${routeName}`;
+    }
+    const headers = {
+      ...hasFormData ? {} : { "Content-Type": "application/json" },
+      ...defaultHeaders,
+      ...options.headers
+    };
+    const autoDetectedCookies = await autoDetectServerCookies();
+    const cookiesToSend = {
+      ...autoDetectedCookies,
+      ...options.cookies || {}
+    };
+    if (Object.keys(cookiesToSend).length > 0) {
+      headers["Cookie"] = buildCookieHeader(cookiesToSend);
+    }
+    if (debug && Object.keys(autoDetectedCookies).length > 0) {
+      const cookieArray = Object.entries(autoDetectedCookies).map(([name, value]) => ({ name, value }));
+      logCookieAutoDetection(apiLogger, cookieArray);
+    }
+    const requestInit = {
+      method,
+      headers,
+      ...options.fetchOptions
+    };
+    if (method === "POST") {
+      if (hasFormData) {
+        const formData = new FormData();
+        const metadata = {};
+        if (input.params) metadata.params = input.params;
+        if (input.query) metadata.query = input.query;
+        if (input.headers) metadata.headers = input.headers;
+        if (input.cookies) metadata.cookies = input.cookies;
+        if (Object.keys(metadata).length > 0) {
+          formData.append("__metadata", JSON.stringify(metadata));
+        }
+        for (const [key, value] of Object.entries(input.formData)) {
+          if (value instanceof File) {
+            formData.append(key, value);
+          } else if (Array.isArray(value)) {
+            for (const item of value) {
+              if (item instanceof File) {
+                formData.append(key, item);
+              } else {
+                formData.append(key, String(item));
+              }
+            }
+          } else if (value !== void 0 && value !== null) {
+            formData.append(key, String(value));
+          }
+        }
+        requestInit.body = formData;
+      } else {
+        requestInit.body = JSON.stringify(input);
+      }
+    }
+    let init = requestInit;
+    if (globalOnRequest) {
+      init = await globalOnRequest(fullUrl, init);
+    }
+    if (options.onRequest) {
+      init = await options.onRequest(fullUrl, init);
+    }
+    if (debug) {
+      logRequest(apiLogger, routeName, method, fullUrl, !!init.body);
+    }
+    let response;
+    let body;
+    try {
+      response = await executeFetchWithTimeout(fullUrl, init, timeout, customFetch);
+      body = await parseResponseBody(response);
+      if (globalOnResponse) {
+        const result = await globalOnResponse(response, body);
+        response = result.response;
+        body = result.body;
+      }
+      if (options.onResponse) {
+        const result = await options.onResponse(response, body);
+        response = result.response;
+        body = result.body;
+      }
+      if (debug) {
+        logResponse(apiLogger, routeName, response.status, !!body);
+      }
+    } catch (error) {
+      if (error instanceof Error && error.name === "AbortError") {
+        apiLogger.error("Request timeout", {
+          route: routeName,
+          method,
+          url: fullUrl,
+          timeout
+        });
+        throw new ApiError(
+          `Request timeout after ${timeout}ms`,
+          408,
+          fullUrl,
+          void 0,
+          "timeout"
+        );
+      }
+      const errorMessage = error instanceof Error ? error.message : "Network error";
+      apiLogger.error("Network error", {
+        route: routeName,
+        method,
+        url: fullUrl,
+        error: errorMessage,
+        errorName: error instanceof Error ? error.name : "unknown"
+      });
+      throw new ApiError(
+        errorMessage,
+        0,
+        fullUrl,
+        void 0,
+        "network"
+      );
+    }
+    if (!response.ok) {
+      await handleErrorResponse(response, body, fullUrl, errorRegistry$1, debug, apiLogger);
+    }
+    return body;
+  }
+  function buildProxy(prefix = "") {
+    return new Proxy(
+      {},
+      {
+        get(_target, prop) {
+          const currentPath = prefix ? `${prefix}.${prop}` : prop;
+          return new RouteCallBuilder(
+            (input, options) => executeCall(currentPath, input, options),
+            currentPath
+          );
+        }
+      }
+    );
+  }
+  return buildProxy();
+}
+
+export { ApiError, createApi };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/nextjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/nextjs/client/debug-logs.ts","../../src/nextjs/client/errors.ts","../../src/nextjs/shared.ts","../../src/nextjs/client/helpers.ts","../../src/nextjs/client/builder.ts","../../src/nextjs/client/core.ts"],"names":["logger","errorRegistry","coreErrorRegistry","headers"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Debug logging utilities for API client\n * Separates debug logging logic from main client code for better maintainability\n */\nimport type { Logger } from '@spfn/core/logger';\n\nexport function logCookieAutoDetection(\n    logger: Logger,\n    cookies: Array<{ name: string; value: string }>\n): void\n{\n    logger.debug('Auto-detected server environment, forwarding cookies', {\n        cookieCount: cookies.length,\n        cookieNames: cookies.map(c => c.name),\n    });\n}\n\nexport function logRequest(\n    logger: Logger,\n    routeName: string,\n    method: string,\n    url: string,\n    hasBody: boolean\n): void\n{\n    logger.debug('→ Request', {\n        route: routeName,\n        method,\n        url,\n        hasBody,\n    });\n}\n\nexport function logResponse(\n    logger: Logger,\n    routeName: string,\n    status: number,\n    hasBody: boolean\n): void\n{\n    logger.debug('← Response', {\n        route: routeName,\n        status,\n        hasBody,\n    });\n}\n\nexport function logErrorResponse(\n    logger: Logger,\n    status: number,\n    body: any\n): void\n{\n    logger.debug('Error response received', {\n        status,\n        hasBody: !!body,\n        bodyType: typeof body,\n        hasTypeField: body && typeof body === 'object' && '__type' in body,\n        typeValue: body?.__type,\n    });\n}\n\nexport function logErrorDeserializationAttempt(\n    logger: Logger,\n    errorType: string,\n    registeredTypes: string[]\n): void\n{\n    logger.debug('Attempting error deserialization', {\n        errorType,\n        hasRegistry: true,\n        registeredTypes,\n    });\n}\n\nexport function logErrorDeserializationSuccess(\n    logger: Logger,\n    error: Error | null\n): void\n{\n    logger.debug('Error deserialized successfully', {\n        errorName: error?.name,\n        errorConstructor: error?.constructor.name,\n        message: error?.message,\n    });\n}\n\nexport function logErrorDeserializationFailure(\n    logger: Logger,\n    error: unknown\n): void\n{\n    logger.debug('Deserialization failed', {\n        errorName: error instanceof Error ? error.name : 'unknown',\n        errorMessage: error instanceof Error ? error.message : String(error),\n    });\n}\n\nexport function logErrorDeserializationSkipped(\n    logger: Logger,\n    errorRegistry: any,\n    body: any\n): void\n{\n    const reason = !errorRegistry\n        ? 'no registry'\n        : !body\n            ? 'no body'\n            : typeof body !== 'object'\n                ? 'body not object'\n                : !('__type' in body)\n                    ? 'no __type field'\n                    : 'unknown';\n\n    logger.debug('Skipping error deserialization', { reason });\n}\n\nexport function logThrowingDeserializedError(\n    logger: Logger,\n    error: Error\n): void\n{\n    logger.debug('Throwing deserialized error', {\n        errorName: error.name,\n        errorConstructorName: error.constructor.name,\n        prototype: Object.getPrototypeOf(error).constructor.name,\n    });\n}","// ============================================================================\n// Client Error\n// ============================================================================\n\n/**\n * Typed client error\n */\nexport class ApiError 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?: 'http' | 'network' | 'timeout'\n    )\n    {\n        super(message);\n        this.name = 'ApiError';\n    }\n}","/**\n * Shared utilities for Next.js client and proxy modules\n *\n * Contains common functions used by both client and proxy to avoid code duplication.\n */\n\n/**\n * Build URL with path parameters replaced\n *\n * @example\n * buildUrlWithParams('/users/:id/posts/:postId', { id: '123', postId: '456' })\n * // Returns: '/users/123/posts/456'\n */\nexport function buildUrlWithParams(path: string, params: Record<string, any>): string\n{\n    let url = path;\n    for (const [key, value] of Object.entries(params))\n    {\n        url = url.replace(`:${key}`, encodeURIComponent(String(value)));\n    }\n\n    return url;\n}\n\n/**\n * Build query string from object\n *\n * @example\n * buildQueryString({ page: '1', limit: '10', tags: ['foo', 'bar'] })\n * // Returns: '?page=1&limit=10&tags=foo&tags=bar'\n */\nexport function buildQueryString(query: Record<string, any>): string\n{\n    if (Object.keys(query).length === 0)\n    {\n        return '';\n    }\n\n    const searchParams = new URLSearchParams();\n    for (const [key, value] of Object.entries(query))\n    {\n        if (Array.isArray(value))\n        {\n            value.forEach((v) => searchParams.append(key, String(v)));\n        }\n        else\n        {\n            searchParams.append(key, String(value));\n        }\n    }\n\n    return `?${searchParams.toString()}`;\n}\n\n/**\n * Build Cookie header string from cookies object\n *\n * @example\n * buildCookieHeader({ session: 'abc123', theme: 'dark' })\n * // Returns: 'session=abc123; theme=dark'\n */\nexport function buildCookieHeader(cookies: Record<string, string>): string\n{\n    return Object.entries(cookies)\n        .map(([key, value]) => `${key}=${value}`)\n        .join('; ');\n}\n\n/**\n * Parse response body based on content type\n *\n * Handles:\n * - 204 No Content: returns null (no body expected)\n * - application/json: parses JSON body\n * - Other content types: returns raw text\n */\nexport async function parseResponseBody(response: Response): Promise<any>\n{\n    // 204 No Content has no body\n    if (response.status === 204)\n    {\n        return null;\n    }\n\n    const contentType = response.headers.get('content-type');\n\n    if (contentType?.includes('application/json'))\n    {\n        const text = await response.text();\n        return text ? JSON.parse(text) : null;\n    }\n    else\n    {\n        return await response.text();\n    }\n}","import type { Logger } from '@spfn/core/logger';\nimport type { ErrorRegistry } from '@spfn/core/errors';\nimport { ApiError } from './errors';\nimport * as debugLogs from './debug-logs';\n\n// Re-export shared utilities\nexport { buildCookieHeader, parseResponseBody } from '../shared';\n\n/**\n * Auto-detect cookies from Next.js server environment\n * Returns empty object if not in server environment or if cookies are not accessible\n */\nexport async function autoDetectServerCookies(): Promise<Record<string, string>>\n{\n    try\n    {\n        // Next.js cookies() API is only available in server environment\n        const { cookies } = await import('next/headers');\n        const cookieStore = await cookies();\n        const allCookies = cookieStore.getAll();\n\n        return Object.fromEntries(\n            allCookies.map(cookie => [cookie.name, cookie.value])\n        );\n    }\n    catch (error)\n    {\n        // Client environment or cookies not accessible\n        // Browser automatically sends cookies in client components\n        return {};\n    }\n}\n\n/**\n * Execute fetch with timeout and abort controller\n */\nexport async function executeFetchWithTimeout(\n    url: string,\n    init: RequestInit,\n    timeout: number,\n    customFetch: typeof fetch = fetch\n): Promise<Response>\n{\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n    try\n    {\n        const response = await customFetch(url, {\n            ...init,\n            signal: controller.signal,\n        });\n\n        clearTimeout(timeoutId);\n        return response;\n    }\n    catch (error)\n    {\n        clearTimeout(timeoutId);\n        throw error;\n    }\n}\n\n/**\n * Handle error response with deserialization support\n * Attempts to deserialize custom errors if errorRegistry is provided\n * Falls back to ApiError if deserialization fails or is not available\n */\nexport async function handleErrorResponse(\n    response: Response,\n    body: any,\n    fullUrl: string,\n    errorRegistry: ErrorRegistry | undefined,\n    debug: boolean,\n    logger: Logger\n): Promise<never>\n{\n    if (debug)\n    {\n        debugLogs.logErrorResponse(logger, response.status, body);\n    }\n\n    // Try to deserialize error if registry is provided\n    let deserializedError: Error | null = null;\n\n    if (errorRegistry && body && typeof body === 'object' && '__type' in body)\n    {\n        if (debug)\n        {\n            debugLogs.logErrorDeserializationAttempt(logger, body.__type, errorRegistry.getRegisteredTypes());\n        }\n\n        try\n        {\n            deserializedError = errorRegistry.deserialize(body as any);\n\n            if (debug)\n            {\n                debugLogs.logErrorDeserializationSuccess(logger, deserializedError);\n            }\n        }\n        catch (deserializeError)\n        {\n            // Deserialization itself failed (type not found, invalid data, etc.)\n            if (debug)\n            {\n                debugLogs.logErrorDeserializationFailure(logger, deserializeError);\n            }\n            // Fall through to ApiError below\n        }\n    }\n    else if (debug)\n    {\n        debugLogs.logErrorDeserializationSkipped(logger, errorRegistry, body);\n    }\n\n    // If deserialization succeeded, throw the deserialized error\n    if (deserializedError)\n    {\n        if (debug)\n        {\n            debugLogs.logThrowingDeserializedError(logger, deserializedError);\n        }\n\n        throw deserializedError;\n    }\n\n    // Fallback to generic ApiError\n    if (response.status === 404 && process.env.NODE_ENV !== 'production')\n    {\n        logger.warn(\n            '\\n⚠️  404 Not Found\\n\\n' +\n            'Check the following:\\n' +\n            '  1. Routes are registered in server.config.ts:\\n' +\n            '     → defineServerConfig().routes(appRouter)\\n' +\n            '  2. Delete .spfn cache if you recently added new routes:\\n' +\n            '     → rm -rf .spfn\\n'\n        );\n    }\n\n    throw new ApiError(\n        body?.message || `HTTP ${response.status}: ${response.statusText}`,\n        response.status,\n        fullUrl,\n        body,\n        'http'\n    );\n}","// ============================================================================\n// Route Call Builder (Structured Input API)\n// ============================================================================\n\nimport type { RouteDef, Router } from \"@spfn/core/route\";\nimport type {\n    CallOptions,\n    InferRouteInput,\n    InferRouteOutput,\n    RequestInterceptor,\n    ResponseInterceptor,\n} from \"./types\";\n\n/**\n * Pick only non-empty fields from StructuredInput\n *\n * This removes fields that are empty objects `{}` from the input type,\n * so users only need to provide fields that are actually defined in the route.\n */\ntype PickNonEmpty<T> = {\n    [K in keyof T as T[K] extends Record<string, never> ? never : K]: T[K];\n};\n\n/**\n * Make fields that can be undefined into optional fields\n *\n * When a field is defined as `Type.Optional(Type.Object({...}))`,\n * the resulting type is `T | undefined`. This utility converts such fields\n * into proper optional fields (`field?: T`) so users don't need to pass them.\n */\ntype MakeOptionalIfUndefinable<T> =\n    // Required fields (undefined is not assignable)\n    { [K in keyof T as undefined extends T[K] ? never : K]: T[K] }\n    // Optional fields (undefined is assignable)\n    & { [K in keyof T as undefined extends T[K] ? K : never]?: Exclude<T[K], undefined> };\n\n/**\n * Clean structured input - only include fields that have actual schema,\n * and make fields optional if they accept undefined\n */\ntype CleanStructuredInput<TInput> = MakeOptionalIfUndefinable<PickNonEmpty<TInput>>;\n\n/**\n * Check if input has any required fields\n *\n * Returns false if all fields are optional (i.e., {} is assignable to the input type)\n */\ntype HasAnyRequiredFields<TInput> = {} extends CleanStructuredInput<TInput> ? false : true;\n\n/**\n * Route call builder with structured input API\n *\n * Input is structured with explicit params, query, body fields\n * that match the server-side route definition.\n *\n * @example\n * ```typescript\n * // GET /users/:id - params only\n * const user = await api.getUser.call({ params: { id: '1' } });\n *\n * // GET /users/:id?include=posts - params + query\n * const user = await api.getUser.call({\n *     params: { id: '1' },\n *     query: { include: 'posts' }\n * });\n *\n * // POST /users - body only\n * const user = await api.createUser.call({\n *     body: { name: 'John', email: 'john@example.com' }\n * });\n *\n * // PUT /users/:id - params + body\n * const user = await api.updateUser.call({\n *     params: { id: '1' },\n *     body: { name: 'Jane' }\n * });\n *\n * // With options (headers, cookies, Next.js caching)\n * const user = await api.getUser\n *     .headers({ 'X-Custom': 'value' })\n *     .fetchOptions({ next: { revalidate: 60 } })\n *     .call({ params: { id: '1' } });\n * ```\n */\nexport class RouteCallBuilder<\n    TInput,\n    TOutput\n>\n{\n    private _headers?: Record<string, string>;\n    private _cookies?: Record<string, string>;\n    private _fetchOptions?: RequestInit;\n    private _onRequest?: RequestInterceptor;\n    private _onResponse?: ResponseInterceptor;\n\n    constructor(\n        private readonly executor: (input: any, options: CallOptions) => Promise<TOutput>,\n        private readonly routeName: string\n    ) {}\n\n    /**\n     * Clone builder\n     */\n    private clone(): RouteCallBuilder<TInput, TOutput>\n    {\n        const builder = new RouteCallBuilder<TInput, TOutput>(\n            this.executor,\n            this.routeName\n        );\n        builder._headers = this._headers;\n        builder._cookies = this._cookies;\n        builder._fetchOptions = this._fetchOptions;\n        builder._onRequest = this._onRequest;\n        builder._onResponse = this._onResponse;\n        return builder;\n    }\n\n    /**\n     * Set request headers\n     */\n    headers(headers: Record<string, string>): RouteCallBuilder<TInput, TOutput>\n    {\n        const builder = this.clone();\n        builder._headers = { ...this._headers, ...headers };\n        return builder;\n    }\n\n    /**\n     * Set cookies\n     */\n    cookies(cookies: Record<string, string>): RouteCallBuilder<TInput, TOutput>\n    {\n        const builder = this.clone();\n        builder._cookies = { ...this._cookies, ...cookies };\n        return builder;\n    }\n\n    /**\n     * Set Next.js fetch options\n     */\n    fetchOptions(options: RequestInit & { next?: { revalidate?: number | false; tags?: string[] } }): RouteCallBuilder<TInput, TOutput>\n    {\n        const builder = this.clone();\n        builder._fetchOptions = { ...this._fetchOptions, ...options };\n        return builder;\n    }\n\n    /**\n     * Set request interceptor\n     */\n    onRequest(interceptor: RequestInterceptor): RouteCallBuilder<TInput, TOutput>\n    {\n        const builder = this.clone();\n        builder._onRequest = interceptor;\n        return builder;\n    }\n\n    /**\n     * Set response interceptor\n     */\n    onResponse(interceptor: ResponseInterceptor): RouteCallBuilder<TInput, TOutput>\n    {\n        const builder = this.clone();\n        builder._onResponse = interceptor;\n        return builder;\n    }\n\n    /**\n     * Execute the API call with structured input\n     *\n     * Input structure matches the server-side route definition:\n     * - params: Path parameters (e.g., { id: '123' } for /users/:id)\n     * - query: Query string parameters\n     * - body: Request body (for POST, PUT, PATCH)\n     */\n    call(input?: CleanStructuredInput<TInput>): Promise<TOutput>\n    {\n        const options: CallOptions = {};\n\n        if (this._headers)\n        {\n            options.headers = this._headers;\n        }\n\n        if (this._cookies)\n        {\n            options.cookies = this._cookies;\n        }\n\n        if (this._fetchOptions)\n        {\n            options.fetchOptions = this._fetchOptions;\n        }\n\n        if (this._onRequest)\n        {\n            options.onRequest = this._onRequest;\n        }\n\n        if (this._onResponse)\n        {\n            options.onResponse = this._onResponse;\n        }\n\n        return this.executor(input || {}, options);\n    }\n}\n\n/**\n * Individual route client with structured input API\n */\nexport type RouteClient<TRoute extends RouteDef<any, any>> = {\n    /**\n     * Set request headers\n     */\n    headers(headers: Record<string, string>): RouteClient<TRoute>;\n\n    /**\n     * Set cookies\n     */\n    cookies(cookies: Record<string, string>): RouteClient<TRoute>;\n\n    /**\n     * Set Next.js fetch options\n     */\n    fetchOptions(options: RequestInit & { next?: { revalidate?: number | false; tags?: string[] } }): RouteClient<TRoute>;\n\n    /**\n     * Set request interceptor\n     */\n    onRequest(interceptor: RequestInterceptor): RouteClient<TRoute>;\n\n    /**\n     * Set response interceptor\n     */\n    onResponse(interceptor: ResponseInterceptor): RouteClient<TRoute>;\n\n    /**\n     * Execute the API call with structured input\n     *\n     * @example\n     * ```typescript\n     * // GET /users/:id\n     * api.getUser.call({ params: { id: '123' } });\n     *\n     * // PUT /users/:id\n     * api.updateUser.call({ params: { id: '123' }, body: { name: 'Jane' } });\n     * ```\n     */\n    call: HasAnyRequiredFields<InferRouteInput<TRoute>> extends true\n        ? (input: CleanStructuredInput<InferRouteInput<TRoute>>) => Promise<InferRouteOutput<TRoute>>\n        : (input?: CleanStructuredInput<InferRouteInput<TRoute>>) => Promise<InferRouteOutput<TRoute>>;\n};\n\n/**\n * Typed client for entire router\n */\nexport type Client<TRouter extends Router<any>> = {\n    [K in keyof TRouter['routes']]: TRouter['routes'][K] extends RouteDef<any, any, any>\n        ? RouteClient<TRouter['routes'][K]>\n        : TRouter['routes'][K] extends Router<any>\n            ? Client<TRouter['routes'][K]>\n            : never;\n};","/**\n * Type-Safe RPC-Style Client with Structured Input API\n *\n * Provides full end-to-end type safety from server routes to client calls.\n * No metadata codegen required - method/path resolution happens at the proxy layer.\n *\n * @example\n * ```typescript\n * // Server\n * export const appRouter = defineRouter({\n *   getUser: route.get('/users/:id')\n *     .input({ params: Type.Object({ id: Type.String() }) })\n *     .handler(async (c) => { ... }),\n *   createUser: route.post('/users')\n *     .input({ body: Type.Object({ name: Type.String() }) })\n *     .handler(async (c) => { ... }),\n * });\n *\n * export type AppRouter = typeof appRouter;\n *\n * // Client - no metadata needed!\n * const api = createApi<AppRouter>();\n *\n * // ✅ GET (no body) - becomes GET /api/rpc/getUser?input={...}\n * const user = await api.getUser.call({ params: { id: '1' } });\n *\n * // ✅ POST (has body) - becomes POST /api/rpc/createUser\n * const newUser = await api.createUser.call({ body: { name: 'John' } });\n *\n * // ✅ With options (headers, cookies, interceptors)\n * const user = await api.getUser\n *   .headers({ 'X-Custom': 'value' })\n *   .cookies({ session: 'xxx' })\n *   .fetchOptions({ next: { revalidate: 60 } })\n *   .call({ params: { id: '1' } });\n * ```\n */\nimport { env } from '@spfn/core/config';\nimport { ErrorRegistry, errorRegistry as coreErrorRegistry } from '@spfn/core/errors';\nimport { logger } from '@spfn/core/logger';\nimport type { Router } from '@spfn/core/route';\nimport * as debugLogs from './debug-logs';\nimport { ApiError } from \"./errors\";\nimport {\n    parseResponseBody,\n    executeFetchWithTimeout,\n    handleErrorResponse,\n    buildCookieHeader,\n    autoDetectServerCookies,\n} from './helpers';\nimport { RouteCallBuilder } from './builder';\nimport type { ApiConfig, CallOptions } from \"./types\";\nimport type { Client } from \"./builder\";\n\nconst apiLogger = logger.child('@spfn/core:api-client');\n\n// ============================================================================\n// Client Implementation\n// ============================================================================\n\n/**\n * Create type-safe RPC client\n *\n * No metadata required - the client sends routeName + input to the proxy,\n * and the proxy resolves the actual HTTP method and path from the router.\n *\n * @example\n * ```typescript\n * // Client - no metadata needed!\n * const api = createApi<AppRouter>();\n *\n * // GET request (no body) - browser cacheable\n * const user = await api.getUser.call({ params: { id: '1' } });\n *\n * // POST request (has body)\n * const newUser = await api.createUser.call({ body: { name: 'John' } });\n * ```\n */\nexport function createApi<TRouter extends Router<any>>(\n    config: ApiConfig = {}\n): Client<TRouter>\n{\n    const {\n        baseUrl = '/api/rpc',\n        headers: defaultHeaders = {},\n        timeout = 30000,\n        fetch: customFetch = fetch,\n        onRequest: globalOnRequest,\n        onResponse: globalOnResponse,\n        errorRegistry: errorRegistryConfig,\n        debug = false,\n    } = config;\n\n    // Normalize errorRegistry: always include coreErrorRegistry\n    const errorRegistry = Array.isArray(errorRegistryConfig)\n        ? new ErrorRegistry([coreErrorRegistry, ...errorRegistryConfig])\n        : errorRegistryConfig ?? coreErrorRegistry;\n\n    if (debug)\n    {\n        apiLogger.debug('API client initialized', { baseUrl });\n    }\n\n    /**\n     * Execute API call\n     *\n     * Determines GET vs POST based on body/formData presence:\n     * - No body/formData → GET /api/rpc/{routeName}?input={...}\n     * - Has body → POST /api/rpc/{routeName} with JSON body\n     * - Has formData → POST /api/rpc/{routeName} with multipart/form-data\n     */\n    async function executeCall(\n        routeName: string,\n        input: any = {},\n        options: CallOptions = {}\n    ): Promise<any>\n    {\n        const hasBody = input.body !== undefined;\n        const hasFormData = input.formData !== undefined && Object.keys(input.formData).length > 0;\n        const method = (hasBody || hasFormData) ? 'POST' : 'GET';\n\n        // Build full URL - handle SSR case where SPFN_APP_URL might not be set\n        let appUrl = env.SPFN_APP_URL || '';\n\n        // In SSR environment, if SPFN_APP_URL is not set, try to get host from request headers\n        if (!appUrl && typeof window === 'undefined')\n        {\n            try\n            {\n                const { headers } = await import('next/headers');\n                const headersList = await headers();\n                const host = headersList.get('host');\n                const protocol = headersList.get('x-forwarded-proto') || 'http';\n                if (host)\n                {\n                    appUrl = `${protocol}://${host}`;\n                    if (debug)\n                    {\n                        apiLogger.debug(`Auto-detected app URL from headers: ${appUrl}`);\n                    }\n                }\n            }\n            catch\n            {\n                // Fallback: use relative URL and let fetch handle it\n                if (debug)\n                {\n                    apiLogger.warn('Could not determine app URL in SSR environment, using relative URL');\n                }\n            }\n        }\n\n        // Build URL based on method\n        let fullUrl: string;\n        if (method === 'GET')\n        {\n            // GET: encode input in query string\n            const inputParam = encodeURIComponent(JSON.stringify(input));\n            fullUrl = `${appUrl}${baseUrl}/${routeName}?input=${inputParam}`;\n        }\n        else\n        {\n            // POST: input goes in body\n            fullUrl = `${appUrl}${baseUrl}/${routeName}`;\n        }\n\n        // Prepare headers\n        // Note: Don't set Content-Type for formData - browser sets it with boundary\n        const headers: Record<string, string> = {\n            ...(hasFormData ? {} : { 'Content-Type': 'application/json' }),\n            ...defaultHeaders,\n            ...options.headers,\n        };\n\n        // Auto-detect server cookies and merge with user-provided cookies\n        const autoDetectedCookies = await autoDetectServerCookies();\n        const cookiesToSend = {\n            ...autoDetectedCookies,\n            ...(options.cookies || {}),\n        };\n\n        // Add Cookie header if we have cookies to send\n        if (Object.keys(cookiesToSend).length > 0)\n        {\n            headers['Cookie'] = buildCookieHeader(cookiesToSend);\n        }\n\n        // Log cookie auto-detection if debug enabled\n        if (debug && Object.keys(autoDetectedCookies).length > 0)\n        {\n            const cookieArray = Object.entries(autoDetectedCookies).map(([name, value]) => ({ name, value }));\n            debugLogs.logCookieAutoDetection(apiLogger, cookieArray);\n        }\n\n        // Build request init\n        const requestInit: RequestInit = {\n            method,\n            headers,\n            ...options.fetchOptions,\n        };\n\n        // Add body for POST\n        if (method === 'POST')\n        {\n            if (hasFormData)\n            {\n                // Build FormData for file uploads\n                const formData = new FormData();\n\n                // Add non-formData fields (params, query, headers, cookies) as JSON metadata\n                const metadata: Record<string, any> = {};\n                if (input.params) metadata.params = input.params;\n                if (input.query) metadata.query = input.query;\n                if (input.headers) metadata.headers = input.headers;\n                if (input.cookies) metadata.cookies = input.cookies;\n\n                if (Object.keys(metadata).length > 0)\n                {\n                    formData.append('__metadata', JSON.stringify(metadata));\n                }\n\n                // Add formData fields\n                for (const [key, value] of Object.entries(input.formData))\n                {\n                    if (value instanceof File)\n                    {\n                        formData.append(key, value);\n                    }\n                    else if (Array.isArray(value))\n                    {\n                        // Handle array of files or values\n                        for (const item of value)\n                        {\n                            if (item instanceof File)\n                            {\n                                formData.append(key, item);\n                            }\n                            else\n                            {\n                                formData.append(key, String(item));\n                            }\n                        }\n                    }\n                    else if (value !== undefined && value !== null)\n                    {\n                        formData.append(key, String(value));\n                    }\n                }\n\n                requestInit.body = formData;\n            }\n            else\n            {\n                requestInit.body = JSON.stringify(input);\n            }\n        }\n\n        // Execute request interceptors\n        let init = requestInit;\n        if (globalOnRequest)\n        {\n            init = await globalOnRequest(fullUrl, init);\n        }\n        if (options.onRequest)\n        {\n            init = await options.onRequest(fullUrl, init);\n        }\n\n        if (debug)\n        {\n            debugLogs.logRequest(apiLogger, routeName, method, fullUrl, !!init.body);\n        }\n\n        // Execute fetch with timeout\n        let response: Response;\n        let body: any;\n\n        try\n        {\n            response = await executeFetchWithTimeout(fullUrl, init, timeout, customFetch);\n\n            // Parse response\n            body = await parseResponseBody(response);\n\n            // Execute global + local response interceptors\n            if (globalOnResponse)\n            {\n                const result = await globalOnResponse(response, body);\n                response = result.response;\n                body = result.body;\n            }\n            if (options.onResponse)\n            {\n                const result = await options.onResponse(response, body);\n                response = result.response;\n                body = result.body;\n            }\n\n            if (debug)\n            {\n                debugLogs.logResponse(apiLogger, routeName, response.status, !!body);\n            }\n        }\n        catch (error)\n        {\n            // Handle timeout specifically\n            if (error instanceof Error && error.name === 'AbortError')\n            {\n                apiLogger.error('Request timeout', {\n                    route: routeName,\n                    method,\n                    url: fullUrl,\n                    timeout,\n                });\n\n                throw new ApiError(\n                    `Request timeout after ${timeout}ms`,\n                    408,\n                    fullUrl,\n                    undefined,\n                    'timeout'\n                );\n            }\n\n            // Network error\n            const errorMessage = error instanceof Error ? error.message : 'Network error';\n            apiLogger.error('Network error', {\n                route: routeName,\n                method,\n                url: fullUrl,\n                error: errorMessage,\n                errorName: error instanceof Error ? error.name : 'unknown',\n            });\n\n            throw new ApiError(\n                errorMessage,\n                0,\n                fullUrl,\n                undefined,\n                'network'\n            );\n        }\n\n        // Handle error responses\n        if (!response.ok)\n        {\n            await handleErrorResponse(response, body, fullUrl, errorRegistry, debug, apiLogger);\n        }\n\n        return body;\n    }\n\n    /**\n     * Build client proxy\n     *\n     * Every property access returns a RouteCallBuilder.\n     * Nested routers are supported via dot notation in routeName.\n     */\n    function buildProxy(prefix = ''): any\n    {\n        return new Proxy(\n            {},\n            {\n                get(_target, prop: string)\n                {\n                    const currentPath = prefix ? `${prefix}.${prop}` : prop;\n\n                    // Return RouteCallBuilder that can either be called or chained\n                    return new RouteCallBuilder(\n                        (input: any, options: CallOptions) => executeCall(currentPath, input, options),\n                        currentPath\n                    );\n                },\n            }\n        );\n    }\n\n    return buildProxy() as Client<TRouter>;\n}"]}