@spfn/core 0.3.0-beta.2 → 0.3.0-beta.21

package/dist/types-9oszaJqp.d.ts

@@ -1,250 +0,0 @@
-import { TSchema, Static } from '@sinclair/typebox';
-import { ErrorRegistry, ErrorRegistryInput } from '@spfn/core/errors';
-import { RouteDef, RouteInput } from '@spfn/core/route';
-
-/**
- * Convert File types in schema to actual File for client usage
- *
- * TypeBox File schemas become actual File objects on the client side.
- */
-type ConvertFileTypes<T> = T extends File ? File : T extends File[] ? File[] : T;
-/**
- * Extract form data input type with File support
- *
- * Maps schema types to runtime types, converting FileSchema to File.
- */
-type FormDataInput<T> = {
-    [K in keyof T]: ConvertFileTypes<T[K]>;
-};
-/**
- * Extract structured input from RouteInput
- *
- * Converts TypeBox schemas to their static types for each input field.
- */
-type StructuredInput<TInput extends RouteInput> = {
-    params: TInput['params'] extends TSchema ? Static<TInput['params']> : {};
-    query: TInput['query'] extends TSchema ? Static<TInput['query']> : {};
-    body: TInput['body'] extends TSchema ? Static<TInput['body']> : {};
-    formData: TInput['formData'] extends TSchema ? FormDataInput<Static<TInput['formData']>> : {};
-    headers: TInput['headers'] extends TSchema ? Static<TInput['headers']> : {};
-    cookies: TInput['cookies'] extends TSchema ? Static<TInput['cookies']> : {};
-};
-/**
- * Infer route input type from RouteDef
- *
- * @example
- * ```typescript
- * // Server route definition
- * const getUser = route.get('/users/:id')
- *   .input({ params: Type.Object({ id: Type.String() }) })
- *   .handler(...);
- *
- * // Client: extract input type
- * type Input = InferRouteInput<typeof getUser>;
- * // { params: { id: string }, query: {}, body: {}, ... }
- * ```
- */
-type InferRouteInput<TRoute> = TRoute extends RouteDef<infer TInput, any, any> ? StructuredInput<TInput> : never;
-/**
- * Infer route output type from RouteDef
- *
- * @example
- * ```typescript
- * // Server route definition
- * const getUser = route.get('/users/:id')
- *   .handler(async (c) => {
- *     return { id: '1', name: 'John' };
- *   });
- *
- * // Client: extract output type
- * type Output = InferRouteOutput<typeof getUser>;
- * // { id: string, name: string }
- * ```
- */
-type InferRouteOutput<TRoute> = TRoute extends RouteDef<any, any, infer TResponse> ? TResponse : never;
-/**
- * Extract routes from Router type
- * Router<TRoutes> has routes in `_routes` property
- */
-type ExtractRoutes<TRouter> = TRouter extends {
-    _routes: infer TRoutes;
-} ? TRoutes : TRouter;
-/**
- * Extract output type for a specific route from router
- *
- * @example
- * ```typescript
- * import type { RouterOutput } from '@spfn/core/nextjs';
- * import type { AppRouter } from '@/server/router';
- *
- * // Get output type for a specific route
- * type ListData = RouterOutput<AppRouter, 'listExamples'>;
- *
- * // Use in props
- * interface Props {
- *     data: RouterOutput<AppRouter, 'listExamples'>;
- * }
- *
- * // Extract item type from paginated response
- * type Example = RouterOutput<AppRouter, 'listExamples'>['items'][number];
- * ```
- */
-type RouterOutput<TRouter, K extends keyof ExtractRoutes<TRouter>> = InferRouteOutput<ExtractRoutes<TRouter>[K]>;
-/**
- * Extract input type for a specific route from router
- *
- * @example
- * ```typescript
- * import type { RouterInput } from '@spfn/core/nextjs';
- * import type { AppRouter } from '@/server/router';
- *
- * // Get input type for a specific route
- * type CreateInput = RouterInput<AppRouter, 'createExample'>;
- *
- * // Use in function parameter
- * function submitForm(data: RouterInput<AppRouter, 'createExample'>['body']) {
- *     // ...
- * }
- * ```
- */
-type RouterInput<TRouter, K extends keyof ExtractRoutes<TRouter>> = InferRouteInput<ExtractRoutes<TRouter>[K]>;
-/**
- * Cookie options for setCookie
- */
-interface CookieOptions {
-    httpOnly?: boolean;
-    secure?: boolean;
-    sameSite?: 'strict' | 'lax' | 'none';
-    maxAge?: number;
-    path?: string;
-    domain?: string;
-}
-/**
- * Cookie to set in response
- */
-interface SetCookie {
-    name: string;
-    value: string;
-    options?: CookieOptions;
-}
-/**
- * Request interceptor - called before fetch
- */
-type RequestInterceptor = (url: string, init: RequestInit) => Promise<RequestInit> | RequestInit;
-/**
- * Response interceptor - called after fetch
- */
-type ResponseInterceptor = (response: Response, body: any) => Promise<{
-    response: Response;
-    body: any;
-}> | {
-    response: Response;
-    body: any;
-};
-/**
- * Client configuration
- */
-interface ApiConfig {
-    /**
-     * Base URL for RPC endpoint
-     *
-     * @default '/api/rpc'
-     * @example '/api/rpc', 'http://localhost:3000/api/rpc'
-     */
-    baseUrl?: string;
-    /**
-     * Default headers for all requests
-     */
-    headers?: Record<string, string>;
-    /**
-     * Request timeout in milliseconds
-     *
-     * @default env.SERVER_TIMEOUT (120000)
-     */
-    timeout?: number;
-    /**
-     * Custom fetch implementation
-     */
-    fetch?: typeof fetch;
-    /**
-     * Global request interceptor
-     */
-    onRequest?: RequestInterceptor;
-    /**
-     * Global response interceptor
-     */
-    onResponse?: ResponseInterceptor;
-    /**
-     * Custom error registry for deserialization
-     *
-     * Core HTTP errors are automatically registered. Use this to add your custom application errors.
-     *
-     * @example
-     * ```typescript
-     * import { errorRegistry } from '@spfn/core/errors';
-     * import { authErrorRegistry } from '@myapp/auth/errors';
-     * import { PaymentFailedError } from '@/server/errors';
-     *
-     * const api = createApi<AppRouter>({
-     *   errorRegistry: [errorRegistry, authErrorRegistry, PaymentFailedError]
-     * });
-     * ```
-     */
-    errorRegistry?: ErrorRegistry | ErrorRegistryInput[];
-    /**
-     * Enable debug logging
-     *
-     * @default false
-     */
-    debug?: boolean;
-}
-/**
- * Per-call options
- */
-interface CallOptions {
-    /**
-     * Request timeout in milliseconds
-     * Overrides the global timeout set in ApiConfig
-     */
-    timeout?: number;
-    /**
-     * Additional headers for this request
-     */
-    headers?: Record<string, string>;
-    /**
-     * Override cookies for this request
-     *
-     * Note: Cookies are automatically forwarded by the proxy.
-     * Use this only when you need to override them.
-     */
-    cookies?: Record<string, string>;
-    /**
-     * Request-specific interceptor
-     */
-    onRequest?: RequestInterceptor;
-    /**
-     * Response-specific interceptor
-     */
-    onResponse?: ResponseInterceptor;
-    /**
-     * Next.js-specific fetch options
-     *
-     * @example
-     * // Time-based revalidation
-     * { next: { revalidate: 60 } }
-     *
-     * // Disable cache
-     * { cache: 'no-store' }
-     *
-     * // Tag-based revalidation
-     * { next: { tags: ['users'] } }
-     */
-    fetchOptions?: RequestInit & {
-        next?: {
-            revalidate?: number | false;
-            tags?: string[];
-        };
-    };
-}
-
-export type { ApiConfig as A, CallOptions as C, InferRouteInput as I, RequestInterceptor as R, SetCookie as S, ResponseInterceptor as a, InferRouteOutput as b, CookieOptions as c, RouterInput as d, RouterOutput as e, StructuredInput as f };