@igniter-js/caller 0.1.1 → 0.1.3

package/dist/index.d.mts

@@ -209,6 +209,36 @@ type SchemaMapPaths<TSchemas extends IgniterCallerSchemaMap> = keyof TSchemas &
  * Get available methods for a specific path.
  */
 type SchemaMapMethods<TSchemas extends IgniterCallerSchemaMap, TPath extends keyof TSchemas> = keyof TSchemas[TPath] & IgniterCallerSchemaMethod;
+/**
+ * Get all paths that have a specific method defined.
+ */
+type PathsForMethod<TSchemas extends IgniterCallerSchemaMap, TMethod extends IgniterCallerSchemaMethod> = {
+    [K in keyof TSchemas]: TMethod extends keyof TSchemas[K] ? K : never;
+}[keyof TSchemas] & string;
+/**
+ * Get paths available for GET method.
+ */
+type GetPaths<TSchemas extends IgniterCallerSchemaMap> = PathsForMethod<TSchemas, 'GET'>;
+/**
+ * Get paths available for POST method.
+ */
+type PostPaths<TSchemas extends IgniterCallerSchemaMap> = PathsForMethod<TSchemas, 'POST'>;
+/**
+ * Get paths available for PUT method.
+ */
+type PutPaths<TSchemas extends IgniterCallerSchemaMap> = PathsForMethod<TSchemas, 'PUT'>;
+/**
+ * Get paths available for PATCH method.
+ */
+type PatchPaths<TSchemas extends IgniterCallerSchemaMap> = PathsForMethod<TSchemas, 'PATCH'>;
+/**
+ * Get paths available for DELETE method.
+ */
+type DeletePaths<TSchemas extends IgniterCallerSchemaMap> = PathsForMethod<TSchemas, 'DELETE'>;
+/**
+ * Get paths available for HEAD method.
+ */
+type HeadPaths<TSchemas extends IgniterCallerSchemaMap> = PathsForMethod<TSchemas, 'HEAD'>;
 /**
  * Get endpoint schema for a specific path and method.
  */
@@ -221,6 +251,23 @@ type SchemaMapResponseType<TSchemas extends IgniterCallerSchemaMap, TPath extend
  * Infer request type from schema map for a specific path and method.
  */
 type SchemaMapRequestType<TSchemas extends IgniterCallerSchemaMap, TPath extends keyof TSchemas, TMethod extends keyof TSchemas[TPath]> = TSchemas[TPath][TMethod] extends IgniterCallerEndpointSchema<infer Request, any> ? Request extends StandardSchemaV1 ? StandardSchemaV1.InferInput<Request> : never : never;
+/**
+ * Infer endpoint info for a specific path and method.
+ * Returns an object with response, request, and params types.
+ */
+type EndpointInfo<TSchemas extends IgniterCallerSchemaMap, TPath extends string, TMethod extends IgniterCallerSchemaMethod> = TPath extends keyof TSchemas ? TMethod extends keyof TSchemas[TPath] ? {
+    response: TSchemas[TPath][TMethod] extends IgniterCallerEndpointSchema<any, infer R> ? 200 extends keyof R ? R[200] extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<R[200]> : unknown : 201 extends keyof R ? R[201] extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<R[201]> : unknown : unknown : unknown;
+    request: TSchemas[TPath][TMethod] extends IgniterCallerEndpointSchema<infer Req, any> ? Req extends StandardSchemaV1 ? StandardSchemaV1.InferInput<Req> : never : never;
+    params: ExtractPathParams<TPath & string>;
+} : {
+    response: unknown;
+    request: never;
+    params: Record<never, never>;
+} : {
+    response: unknown;
+    request: never;
+    params: Record<never, never>;
+};
 /**
  * Options for schema validation behavior.
  */
@@ -291,7 +338,7 @@ interface IgniterCallerStoreOptions {
     fallbackToFetch?: boolean;
 }
 
-type IgniterCallerBuilderState<TSchemas extends IgniterCallerSchemaMap = any> = {
+type IgniterCallerBuilderState<TSchemas extends IgniterCallerSchemaMap = IgniterCallerSchemaMap> = {
     baseURL?: string;
     headers?: Record<string, string>;
     cookies?: Record<string, string>;
@@ -303,7 +350,16 @@ type IgniterCallerBuilderState<TSchemas extends IgniterCallerSchemaMap = any> =
     schemas?: TSchemas;
     schemaValidation?: IgniterCallerSchemaValidationOptions;
 };
-type IgniterCallerBuilderFactory<TCaller, TSchemas extends IgniterCallerSchemaMap = any> = (state: IgniterCallerBuilderState<TSchemas>) => TCaller;
+type IgniterCallerBuilderFactory<TCaller, TSchemas extends IgniterCallerSchemaMap = IgniterCallerSchemaMap> = (state: IgniterCallerBuilderState<TSchemas>) => TCaller;
+/**
+ * Utility type to replace the schema type in a caller.
+ * Used by withSchemas to properly type the returned caller.
+ */
+type ReplaceCallerSchema<TCaller, TNewSchemas extends IgniterCallerSchemaMap> = TCaller extends {
+    schemas?: infer _;
+} ? Omit<TCaller, 'schemas'> & {
+    schemas?: TNewSchemas;
+} : TCaller;
 /**
  * Builder used by developers to initialize the `IgniterCaller` client.
  *
@@ -509,6 +565,14 @@ declare class IgniterCallerRequestBuilder<TResponse = unknown> {
  * Used when creating requests via specific HTTP methods (get, post, etc.)
  */
 type IgniterCallerMethodRequestBuilder<TResponse = unknown> = Omit<IgniterCallerRequestBuilder<TResponse>, '_setMethod' | '_setUrl'>;
+/**
+ * Request builder with typed response based on schema inference.
+ * Used when creating requests via HTTP methods with URL that matches a schema.
+ *
+ * This type ensures that the execute() method returns the correct response type
+ * based on the schema map configuration.
+ */
+type IgniterCallerTypedRequestBuilder<TResponse = unknown> = Omit<IgniterCallerRequestBuilder<TResponse>, '_setMethod' | '_setUrl'>;
 
 /**
  * Callback function for event listeners.
@@ -523,13 +587,41 @@ type IgniterCallerEventCallback<T = any> = (result: IgniterCallerApiResponse<T>,
  */
 type IgniterCallerUrlPattern = string | RegExp;
 
+/**
+ * Infer success response type from endpoint schema (200 or 201).
+ */
+type InferSuccessResponse<T> = T extends IgniterCallerEndpointSchema<any, infer R> ? 200 extends keyof R ? R[200] extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<R[200]> : unknown : 201 extends keyof R ? R[201] extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<R[201]> : unknown : unknown : unknown;
+/**
+ * Get the endpoint schema for a path and method from a schema map.
+ */
+type GetEndpoint<TSchemas extends IgniterCallerSchemaMap, TPath extends string, TMethod extends IgniterCallerSchemaMethod> = TPath extends keyof TSchemas ? TMethod extends keyof TSchemas[TPath] ? TSchemas[TPath][TMethod] : undefined : undefined;
+/**
+ * Infer the response type for a given path and method.
+ * Returns `unknown` if the path/method is not in the schema.
+ */
+type InferResponse<TSchemas extends IgniterCallerSchemaMap, TPath extends string, TMethod extends IgniterCallerSchemaMethod> = InferSuccessResponse<GetEndpoint<TSchemas, TPath, TMethod>>;
+/**
+ * Typed request builder with inferred body and params types.
+ */
+type TypedRequestBuilder<TSchemas extends IgniterCallerSchemaMap, TPath extends string, TMethod extends IgniterCallerSchemaMethod> = Omit<IgniterCallerMethodRequestBuilder<EndpointInfo<TSchemas, TPath, TMethod>['response']>, 'body' | 'params'> & {
+    /**
+     * Sets the request body with type inference from schema.
+     */
+    body: EndpointInfo<TSchemas, TPath, TMethod>['request'] extends never ? <TBody>(body: TBody) => TypedRequestBuilder<TSchemas, TPath, TMethod> : (body: EndpointInfo<TSchemas, TPath, TMethod>['request']) => TypedRequestBuilder<TSchemas, TPath, TMethod>;
+    /**
+     * Sets URL path parameters with type inference from URL pattern.
+     */
+    params: keyof EndpointInfo<TSchemas, TPath, TMethod>['params'] extends never ? (params: Record<string, string | number | boolean>) => TypedRequestBuilder<TSchemas, TPath, TMethod> : (params: EndpointInfo<TSchemas, TPath, TMethod>['params'] & Record<string, string | number | boolean>) => TypedRequestBuilder<TSchemas, TPath, TMethod>;
+};
 /**
  * HTTP client runtime for Igniter.js.
  *
  * This module is intentionally structured to be extracted into a standalone package
  * in the Igniter.js ecosystem as `@igniter-js/caller`.
+ *
+ * @template TSchemas - The schema map type for type-safe requests/responses.
  */
-declare class IgniterCaller {
+declare class IgniterCaller<TSchemas extends IgniterCallerSchemaMap = IgniterCallerSchemaMap> {
     /** Global event emitter for observing HTTP responses */
     private static readonly events;
     private baseURL?;
@@ -546,7 +638,7 @@ declare class IgniterCaller {
         logger?: IgniterLogger;
         requestInterceptors?: IgniterCallerRequestInterceptor[];
         responseInterceptors?: IgniterCallerResponseInterceptor[];
-        schemas?: IgniterCallerSchemaMap;
+        schemas?: TSchemas;
         schemaValidation?: IgniterCallerSchemaValidationOptions;
     });
     /**
@@ -554,11 +646,11 @@ declare class IgniterCaller {
      *
      * This is designed to remain stable when extracted to `@igniter-js/caller`.
      */
-    static create(): IgniterCallerBuilder<IgniterCaller>;
+    static create<TInitSchemas extends IgniterCallerSchemaMap = IgniterCallerSchemaMap>(): IgniterCallerBuilder<IgniterCaller<TInitSchemas>, TInitSchemas>;
     /**
      * Returns a new client with the same config and a new logger.
      */
-    withLogger(logger: IgniterLogger): IgniterCaller;
+    withLogger(logger: IgniterLogger): IgniterCaller<TSchemas>;
     setBaseURL(baseURL: string): this;
     setHeaders(headers: Record<string, string>): this;
     setCookies(cookies: Record<string, string>): this;
@@ -566,71 +658,118 @@ declare class IgniterCaller {
      * Creates common request builder params.
      */
     private createBuilderParams;
+    /**
+     * Resolves the full URL path by prepending baseURL if needed.
+     */
+    private resolveSchemaPath;
     /**
      * Creates a GET request.
      *
-     * @param url Optional URL for the request. Can also be set via `.url()`.
+     * When a URL is provided and matches a schema, the response, body, and params types
+     * are automatically inferred from the schema definition.
+     *
+     * @param url Optional URL for the request. When provided and matching a schema path,
+     *            enables full type inference for response, body, and path params.
      *
      * @example
      * ```ts
-     * // With URL directly
-     * const result = await api.get('/users').execute()
+     * // With typed schema - full type inference
+     * const result = await api.get('/users/:id')
+     *   .params({ id: '123' })  // params are typed based on URL pattern
+     *   .execute()
+     * // result.data is typed based on schema
      *
-     * // With URL via method
+     * // Without URL (set later with .url())
      * const result = await api.get().url('/users').execute()
      * ```
      */
-    get(url?: string): IgniterCallerMethodRequestBuilder;
+    get<TPath extends GetPaths<TSchemas>>(url: TPath): TypedRequestBuilder<TSchemas, TPath, 'GET'>;
+    get<TPath extends string>(url?: TPath): IgniterCallerTypedRequestBuilder<InferResponse<TSchemas, TPath, 'GET'>>;
+    /**
+     * Creates a POST request.
+     *
+     * When a URL is provided and matches a schema, the response type is automatically inferred.
     /**
      * Creates a POST request.
      *
-     * @param url Optional URL for the request. Can also be set via `.url()`.
+     * When a URL is provided and matches a schema, the response, body, and params types
+     * are automatically inferred from the schema definition.
+     *
+     * @param url Optional URL for the request.
      *
      * @example
      * ```ts
-     * const result = await api.post('/users').body({ name: 'John' }).execute()
+     * // With typed schema - body type is inferred from schema
+     * const result = await api.post('/users')
+     *   .body({ name: 'John', email: 'john@example.com' })  // body is typed
+     *   .execute()
      * ```
      */
-    post(url?: string): IgniterCallerMethodRequestBuilder;
+    post<TPath extends PostPaths<TSchemas>>(url: TPath): TypedRequestBuilder<TSchemas, TPath, 'POST'>;
+    post<TPath extends string>(url?: TPath): IgniterCallerTypedRequestBuilder<InferResponse<TSchemas, TPath, 'POST'>>;
     /**
      * Creates a PUT request.
      *
-     * @param url Optional URL for the request. Can also be set via `.url()`.
+     * When a URL is provided and matches a schema, the response, body, and params types
+     * are automatically inferred from the schema definition.
+     *
+     * @param url Optional URL for the request.
      *
      * @example
      * ```ts
-     * const result = await api.put('/users/1').body({ name: 'Jane' }).execute()
+     * const result = await api.put('/users/:id')
+     *   .params({ id: '1' })
+     *   .body({ name: 'Jane' })
+     *   .execute()
      * ```
      */
-    put(url?: string): IgniterCallerMethodRequestBuilder;
+    put<TPath extends PutPaths<TSchemas>>(url: TPath): TypedRequestBuilder<TSchemas, TPath, 'PUT'>;
+    put<TPath extends string>(url?: TPath): IgniterCallerTypedRequestBuilder<InferResponse<TSchemas, TPath, 'PUT'>>;
     /**
      * Creates a PATCH request.
      *
-     * @param url Optional URL for the request. Can also be set via `.url()`.
+     * When a URL is provided and matches a schema, the response, body, and params types
+     * are automatically inferred from the schema definition.
+     *
+     * @param url Optional URL for the request.
      *
      * @example
      * ```ts
-     * const result = await api.patch('/users/1').body({ name: 'Jane' }).execute()
+     * const result = await api.patch('/users/:id')
+     *   .params({ id: '1' })
+     *   .body({ name: 'Jane' })
+     *   .execute()
      * ```
      */
-    patch(url?: string): IgniterCallerMethodRequestBuilder;
+    patch<TPath extends PatchPaths<TSchemas>>(url: TPath): TypedRequestBuilder<TSchemas, TPath, 'PATCH'>;
+    patch<TPath extends string>(url?: TPath): IgniterCallerTypedRequestBuilder<InferResponse<TSchemas, TPath, 'PATCH'>>;
     /**
      * Creates a DELETE request.
      *
-     * @param url Optional URL for the request. Can also be set via `.url()`.
+     * When a URL is provided and matches a schema, the response, body, and params types
+     * are automatically inferred from the schema definition.
+     *
+     * @param url Optional URL for the request.
      *
      * @example
      * ```ts
-     * const result = await api.delete('/users/1').execute()
+     * const result = await api.delete('/users/:id')
+     *   .params({ id: '1' })
+     *   .execute()
      * ```
      */
-    delete(url?: string): IgniterCallerMethodRequestBuilder;
+    delete<TPath extends DeletePaths<TSchemas>>(url: TPath): TypedRequestBuilder<TSchemas, TPath, 'DELETE'>;
+    delete<TPath extends string>(url?: TPath): IgniterCallerTypedRequestBuilder<InferResponse<TSchemas, TPath, 'DELETE'>>;
     /**
      * Creates a HEAD request.
      *
-     * @param url Optional URL for the request. Can also be set via `.url()`.
+     * When a URL is provided and matches a schema, the response, body, and params types
+     * are automatically inferred from the schema definition.
+     *
+     * @param url Optional URL for the request.
      */
-    head(url?: string): IgniterCallerMethodRequestBuilder;
+    head<TPath extends HeadPaths<TSchemas>>(url: TPath): TypedRequestBuilder<TSchemas, TPath, 'HEAD'>;
+    head<TPath extends string>(url?: TPath): IgniterCallerTypedRequestBuilder<InferResponse<TSchemas, TPath, 'HEAD'>>;
     /**
      * Executes a request directly with all options in one object (axios-style).
      *
@@ -972,4 +1111,4 @@ declare class IgniterCallerUrlUtils {
     }): string;
 }
 
-export { type ExtractPathParams, IgniterCaller, type IgniterCallerApiResponse, type IgniterCallerBaseRequestOptions, IgniterCallerBodyUtils, IgniterCallerBuilder, type IgniterCallerBuilderFactory, type IgniterCallerBuilderState, IgniterCallerCacheUtils, type IgniterCallerDirectRequestOptions, type IgniterCallerEndpointSchema, IgniterCallerError, type IgniterCallerErrorCode, type IgniterCallerErrorPayload, type IgniterCallerEventCallback, IgniterCallerEvents, type IgniterCallerFileResponse, type IgniterCallerHttpMethod, type IgniterCallerMethodRequestBuilder, IgniterCallerMock, type IgniterCallerOperation, IgniterCallerRequestBuilder, type IgniterCallerRequestBuilderParams, type IgniterCallerRequestInterceptor, type IgniterCallerRequestOptions, type IgniterCallerResponseContentType, type IgniterCallerResponseInterceptor, type IgniterCallerResponseMarker, type IgniterCallerRetryOptions, type IgniterCallerSchemaMap, type IgniterCallerSchemaMethod, IgniterCallerSchemaUtils, type IgniterCallerSchemaValidationOptions, type IgniterCallerStoreAdapter, type IgniterCallerStoreOptions, type IgniterCallerUrlPattern, IgniterCallerUrlUtils, type IgniterCallerValidatableContentType, type InferAllResponseTypes, type InferRequestType, type InferResponseType, type InferSuccessResponseType, type SchemaMapEndpoint, type SchemaMapMethods, type SchemaMapPaths, type SchemaMapRequestType, type SchemaMapResponseType };
+export { type DeletePaths, type EndpointInfo, type ExtractPathParams, type GetPaths, type HeadPaths, IgniterCaller, type IgniterCallerApiResponse, type IgniterCallerBaseRequestOptions, IgniterCallerBodyUtils, IgniterCallerBuilder, type IgniterCallerBuilderFactory, type IgniterCallerBuilderState, IgniterCallerCacheUtils, type IgniterCallerDirectRequestOptions, type IgniterCallerEndpointSchema, IgniterCallerError, type IgniterCallerErrorCode, type IgniterCallerErrorPayload, type IgniterCallerEventCallback, IgniterCallerEvents, type IgniterCallerFileResponse, type IgniterCallerHttpMethod, type IgniterCallerMethodRequestBuilder, IgniterCallerMock, type IgniterCallerOperation, IgniterCallerRequestBuilder, type IgniterCallerRequestBuilderParams, type IgniterCallerRequestInterceptor, type IgniterCallerRequestOptions, type IgniterCallerResponseContentType, type IgniterCallerResponseInterceptor, type IgniterCallerResponseMarker, type IgniterCallerRetryOptions, type IgniterCallerSchemaMap, type IgniterCallerSchemaMethod, IgniterCallerSchemaUtils, type IgniterCallerSchemaValidationOptions, type IgniterCallerStoreAdapter, type IgniterCallerStoreOptions, type IgniterCallerTypedRequestBuilder, type IgniterCallerUrlPattern, IgniterCallerUrlUtils, type IgniterCallerValidatableContentType, type InferAllResponseTypes, type InferRequestType, type InferResponseType, type InferSuccessResponseType, type PatchPaths, type PathsForMethod, type PostPaths, type PutPaths, type ReplaceCallerSchema, type SchemaMapEndpoint, type SchemaMapMethods, type SchemaMapPaths, type SchemaMapRequestType, type SchemaMapResponseType, type TypedRequestBuilder };

package/dist/index.d.ts

@@ -209,6 +209,36 @@ type SchemaMapPaths<TSchemas extends IgniterCallerSchemaMap> = keyof TSchemas &
  * Get available methods for a specific path.
  */
 type SchemaMapMethods<TSchemas extends IgniterCallerSchemaMap, TPath extends keyof TSchemas> = keyof TSchemas[TPath] & IgniterCallerSchemaMethod;
+/**
+ * Get all paths that have a specific method defined.
+ */
+type PathsForMethod<TSchemas extends IgniterCallerSchemaMap, TMethod extends IgniterCallerSchemaMethod> = {
+    [K in keyof TSchemas]: TMethod extends keyof TSchemas[K] ? K : never;
+}[keyof TSchemas] & string;
+/**
+ * Get paths available for GET method.
+ */
+type GetPaths<TSchemas extends IgniterCallerSchemaMap> = PathsForMethod<TSchemas, 'GET'>;
+/**
+ * Get paths available for POST method.
+ */
+type PostPaths<TSchemas extends IgniterCallerSchemaMap> = PathsForMethod<TSchemas, 'POST'>;
+/**
+ * Get paths available for PUT method.
+ */
+type PutPaths<TSchemas extends IgniterCallerSchemaMap> = PathsForMethod<TSchemas, 'PUT'>;
+/**
+ * Get paths available for PATCH method.
+ */
+type PatchPaths<TSchemas extends IgniterCallerSchemaMap> = PathsForMethod<TSchemas, 'PATCH'>;
+/**
+ * Get paths available for DELETE method.
+ */
+type DeletePaths<TSchemas extends IgniterCallerSchemaMap> = PathsForMethod<TSchemas, 'DELETE'>;
+/**
+ * Get paths available for HEAD method.
+ */
+type HeadPaths<TSchemas extends IgniterCallerSchemaMap> = PathsForMethod<TSchemas, 'HEAD'>;
 /**
  * Get endpoint schema for a specific path and method.
  */
@@ -221,6 +251,23 @@ type SchemaMapResponseType<TSchemas extends IgniterCallerSchemaMap, TPath extend
  * Infer request type from schema map for a specific path and method.
  */
 type SchemaMapRequestType<TSchemas extends IgniterCallerSchemaMap, TPath extends keyof TSchemas, TMethod extends keyof TSchemas[TPath]> = TSchemas[TPath][TMethod] extends IgniterCallerEndpointSchema<infer Request, any> ? Request extends StandardSchemaV1 ? StandardSchemaV1.InferInput<Request> : never : never;
+/**
+ * Infer endpoint info for a specific path and method.
+ * Returns an object with response, request, and params types.
+ */
+type EndpointInfo<TSchemas extends IgniterCallerSchemaMap, TPath extends string, TMethod extends IgniterCallerSchemaMethod> = TPath extends keyof TSchemas ? TMethod extends keyof TSchemas[TPath] ? {
+    response: TSchemas[TPath][TMethod] extends IgniterCallerEndpointSchema<any, infer R> ? 200 extends keyof R ? R[200] extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<R[200]> : unknown : 201 extends keyof R ? R[201] extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<R[201]> : unknown : unknown : unknown;
+    request: TSchemas[TPath][TMethod] extends IgniterCallerEndpointSchema<infer Req, any> ? Req extends StandardSchemaV1 ? StandardSchemaV1.InferInput<Req> : never : never;
+    params: ExtractPathParams<TPath & string>;
+} : {
+    response: unknown;
+    request: never;
+    params: Record<never, never>;
+} : {
+    response: unknown;
+    request: never;
+    params: Record<never, never>;
+};
 /**
  * Options for schema validation behavior.
  */
@@ -291,7 +338,7 @@ interface IgniterCallerStoreOptions {
     fallbackToFetch?: boolean;
 }
 
-type IgniterCallerBuilderState<TSchemas extends IgniterCallerSchemaMap = any> = {
+type IgniterCallerBuilderState<TSchemas extends IgniterCallerSchemaMap = IgniterCallerSchemaMap> = {
     baseURL?: string;
     headers?: Record<string, string>;
     cookies?: Record<string, string>;
@@ -303,7 +350,16 @@ type IgniterCallerBuilderState<TSchemas extends IgniterCallerSchemaMap = any> =
     schemas?: TSchemas;
     schemaValidation?: IgniterCallerSchemaValidationOptions;
 };
-type IgniterCallerBuilderFactory<TCaller, TSchemas extends IgniterCallerSchemaMap = any> = (state: IgniterCallerBuilderState<TSchemas>) => TCaller;
+type IgniterCallerBuilderFactory<TCaller, TSchemas extends IgniterCallerSchemaMap = IgniterCallerSchemaMap> = (state: IgniterCallerBuilderState<TSchemas>) => TCaller;
+/**
+ * Utility type to replace the schema type in a caller.
+ * Used by withSchemas to properly type the returned caller.
+ */
+type ReplaceCallerSchema<TCaller, TNewSchemas extends IgniterCallerSchemaMap> = TCaller extends {
+    schemas?: infer _;
+} ? Omit<TCaller, 'schemas'> & {
+    schemas?: TNewSchemas;
+} : TCaller;
 /**
  * Builder used by developers to initialize the `IgniterCaller` client.
  *
@@ -509,6 +565,14 @@ declare class IgniterCallerRequestBuilder<TResponse = unknown> {
  * Used when creating requests via specific HTTP methods (get, post, etc.)
  */
 type IgniterCallerMethodRequestBuilder<TResponse = unknown> = Omit<IgniterCallerRequestBuilder<TResponse>, '_setMethod' | '_setUrl'>;
+/**
+ * Request builder with typed response based on schema inference.
+ * Used when creating requests via HTTP methods with URL that matches a schema.
+ *
+ * This type ensures that the execute() method returns the correct response type
+ * based on the schema map configuration.
+ */
+type IgniterCallerTypedRequestBuilder<TResponse = unknown> = Omit<IgniterCallerRequestBuilder<TResponse>, '_setMethod' | '_setUrl'>;
 
 /**
  * Callback function for event listeners.
@@ -523,13 +587,41 @@ type IgniterCallerEventCallback<T = any> = (result: IgniterCallerApiResponse<T>,
  */
 type IgniterCallerUrlPattern = string | RegExp;
 
+/**
+ * Infer success response type from endpoint schema (200 or 201).
+ */
+type InferSuccessResponse<T> = T extends IgniterCallerEndpointSchema<any, infer R> ? 200 extends keyof R ? R[200] extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<R[200]> : unknown : 201 extends keyof R ? R[201] extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<R[201]> : unknown : unknown : unknown;
+/**
+ * Get the endpoint schema for a path and method from a schema map.
+ */
+type GetEndpoint<TSchemas extends IgniterCallerSchemaMap, TPath extends string, TMethod extends IgniterCallerSchemaMethod> = TPath extends keyof TSchemas ? TMethod extends keyof TSchemas[TPath] ? TSchemas[TPath][TMethod] : undefined : undefined;
+/**
+ * Infer the response type for a given path and method.
+ * Returns `unknown` if the path/method is not in the schema.
+ */
+type InferResponse<TSchemas extends IgniterCallerSchemaMap, TPath extends string, TMethod extends IgniterCallerSchemaMethod> = InferSuccessResponse<GetEndpoint<TSchemas, TPath, TMethod>>;
+/**
+ * Typed request builder with inferred body and params types.
+ */
+type TypedRequestBuilder<TSchemas extends IgniterCallerSchemaMap, TPath extends string, TMethod extends IgniterCallerSchemaMethod> = Omit<IgniterCallerMethodRequestBuilder<EndpointInfo<TSchemas, TPath, TMethod>['response']>, 'body' | 'params'> & {
+    /**
+     * Sets the request body with type inference from schema.
+     */
+    body: EndpointInfo<TSchemas, TPath, TMethod>['request'] extends never ? <TBody>(body: TBody) => TypedRequestBuilder<TSchemas, TPath, TMethod> : (body: EndpointInfo<TSchemas, TPath, TMethod>['request']) => TypedRequestBuilder<TSchemas, TPath, TMethod>;
+    /**
+     * Sets URL path parameters with type inference from URL pattern.
+     */
+    params: keyof EndpointInfo<TSchemas, TPath, TMethod>['params'] extends never ? (params: Record<string, string | number | boolean>) => TypedRequestBuilder<TSchemas, TPath, TMethod> : (params: EndpointInfo<TSchemas, TPath, TMethod>['params'] & Record<string, string | number | boolean>) => TypedRequestBuilder<TSchemas, TPath, TMethod>;
+};
 /**
  * HTTP client runtime for Igniter.js.
  *
  * This module is intentionally structured to be extracted into a standalone package
  * in the Igniter.js ecosystem as `@igniter-js/caller`.
+ *
+ * @template TSchemas - The schema map type for type-safe requests/responses.
  */
-declare class IgniterCaller {
+declare class IgniterCaller<TSchemas extends IgniterCallerSchemaMap = IgniterCallerSchemaMap> {
     /** Global event emitter for observing HTTP responses */
     private static readonly events;
     private baseURL?;
@@ -546,7 +638,7 @@ declare class IgniterCaller {
         logger?: IgniterLogger;
         requestInterceptors?: IgniterCallerRequestInterceptor[];
         responseInterceptors?: IgniterCallerResponseInterceptor[];
-        schemas?: IgniterCallerSchemaMap;
+        schemas?: TSchemas;
         schemaValidation?: IgniterCallerSchemaValidationOptions;
     });
     /**
@@ -554,11 +646,11 @@ declare class IgniterCaller {
      *
      * This is designed to remain stable when extracted to `@igniter-js/caller`.
      */
-    static create(): IgniterCallerBuilder<IgniterCaller>;
+    static create<TInitSchemas extends IgniterCallerSchemaMap = IgniterCallerSchemaMap>(): IgniterCallerBuilder<IgniterCaller<TInitSchemas>, TInitSchemas>;
     /**
      * Returns a new client with the same config and a new logger.
      */
-    withLogger(logger: IgniterLogger): IgniterCaller;
+    withLogger(logger: IgniterLogger): IgniterCaller<TSchemas>;
     setBaseURL(baseURL: string): this;
     setHeaders(headers: Record<string, string>): this;
     setCookies(cookies: Record<string, string>): this;
@@ -566,71 +658,118 @@ declare class IgniterCaller {
      * Creates common request builder params.
      */
     private createBuilderParams;
+    /**
+     * Resolves the full URL path by prepending baseURL if needed.
+     */
+    private resolveSchemaPath;
     /**
      * Creates a GET request.
      *
-     * @param url Optional URL for the request. Can also be set via `.url()`.
+     * When a URL is provided and matches a schema, the response, body, and params types
+     * are automatically inferred from the schema definition.
+     *
+     * @param url Optional URL for the request. When provided and matching a schema path,
+     *            enables full type inference for response, body, and path params.
      *
      * @example
      * ```ts
-     * // With URL directly
-     * const result = await api.get('/users').execute()
+     * // With typed schema - full type inference
+     * const result = await api.get('/users/:id')
+     *   .params({ id: '123' })  // params are typed based on URL pattern
+     *   .execute()
+     * // result.data is typed based on schema
      *
-     * // With URL via method
+     * // Without URL (set later with .url())
      * const result = await api.get().url('/users').execute()
      * ```
      */
-    get(url?: string): IgniterCallerMethodRequestBuilder;
+    get<TPath extends GetPaths<TSchemas>>(url: TPath): TypedRequestBuilder<TSchemas, TPath, 'GET'>;
+    get<TPath extends string>(url?: TPath): IgniterCallerTypedRequestBuilder<InferResponse<TSchemas, TPath, 'GET'>>;
+    /**
+     * Creates a POST request.
+     *
+     * When a URL is provided and matches a schema, the response type is automatically inferred.
     /**
      * Creates a POST request.
      *
-     * @param url Optional URL for the request. Can also be set via `.url()`.
+     * When a URL is provided and matches a schema, the response, body, and params types
+     * are automatically inferred from the schema definition.
+     *
+     * @param url Optional URL for the request.
      *
      * @example
      * ```ts
-     * const result = await api.post('/users').body({ name: 'John' }).execute()
+     * // With typed schema - body type is inferred from schema
+     * const result = await api.post('/users')
+     *   .body({ name: 'John', email: 'john@example.com' })  // body is typed
+     *   .execute()
      * ```
      */
-    post(url?: string): IgniterCallerMethodRequestBuilder;
+    post<TPath extends PostPaths<TSchemas>>(url: TPath): TypedRequestBuilder<TSchemas, TPath, 'POST'>;
+    post<TPath extends string>(url?: TPath): IgniterCallerTypedRequestBuilder<InferResponse<TSchemas, TPath, 'POST'>>;
     /**
      * Creates a PUT request.
      *
-     * @param url Optional URL for the request. Can also be set via `.url()`.
+     * When a URL is provided and matches a schema, the response, body, and params types
+     * are automatically inferred from the schema definition.
+     *
+     * @param url Optional URL for the request.
      *
      * @example
      * ```ts
-     * const result = await api.put('/users/1').body({ name: 'Jane' }).execute()
+     * const result = await api.put('/users/:id')
+     *   .params({ id: '1' })
+     *   .body({ name: 'Jane' })
+     *   .execute()
      * ```
      */
-    put(url?: string): IgniterCallerMethodRequestBuilder;
+    put<TPath extends PutPaths<TSchemas>>(url: TPath): TypedRequestBuilder<TSchemas, TPath, 'PUT'>;
+    put<TPath extends string>(url?: TPath): IgniterCallerTypedRequestBuilder<InferResponse<TSchemas, TPath, 'PUT'>>;
     /**
      * Creates a PATCH request.
      *
-     * @param url Optional URL for the request. Can also be set via `.url()`.
+     * When a URL is provided and matches a schema, the response, body, and params types
+     * are automatically inferred from the schema definition.
+     *
+     * @param url Optional URL for the request.
      *
      * @example
      * ```ts
-     * const result = await api.patch('/users/1').body({ name: 'Jane' }).execute()
+     * const result = await api.patch('/users/:id')
+     *   .params({ id: '1' })
+     *   .body({ name: 'Jane' })
+     *   .execute()
      * ```
      */
-    patch(url?: string): IgniterCallerMethodRequestBuilder;
+    patch<TPath extends PatchPaths<TSchemas>>(url: TPath): TypedRequestBuilder<TSchemas, TPath, 'PATCH'>;
+    patch<TPath extends string>(url?: TPath): IgniterCallerTypedRequestBuilder<InferResponse<TSchemas, TPath, 'PATCH'>>;
     /**
      * Creates a DELETE request.
      *
-     * @param url Optional URL for the request. Can also be set via `.url()`.
+     * When a URL is provided and matches a schema, the response, body, and params types
+     * are automatically inferred from the schema definition.
+     *
+     * @param url Optional URL for the request.
      *
      * @example
      * ```ts
-     * const result = await api.delete('/users/1').execute()
+     * const result = await api.delete('/users/:id')
+     *   .params({ id: '1' })
+     *   .execute()
      * ```
      */
-    delete(url?: string): IgniterCallerMethodRequestBuilder;
+    delete<TPath extends DeletePaths<TSchemas>>(url: TPath): TypedRequestBuilder<TSchemas, TPath, 'DELETE'>;
+    delete<TPath extends string>(url?: TPath): IgniterCallerTypedRequestBuilder<InferResponse<TSchemas, TPath, 'DELETE'>>;
     /**
      * Creates a HEAD request.
      *
-     * @param url Optional URL for the request. Can also be set via `.url()`.
+     * When a URL is provided and matches a schema, the response, body, and params types
+     * are automatically inferred from the schema definition.
+     *
+     * @param url Optional URL for the request.
      */
-    head(url?: string): IgniterCallerMethodRequestBuilder;
+    head<TPath extends HeadPaths<TSchemas>>(url: TPath): TypedRequestBuilder<TSchemas, TPath, 'HEAD'>;
+    head<TPath extends string>(url?: TPath): IgniterCallerTypedRequestBuilder<InferResponse<TSchemas, TPath, 'HEAD'>>;
     /**
      * Executes a request directly with all options in one object (axios-style).
      *
@@ -972,4 +1111,4 @@ declare class IgniterCallerUrlUtils {
     }): string;
 }
 
-export { type ExtractPathParams, IgniterCaller, type IgniterCallerApiResponse, type IgniterCallerBaseRequestOptions, IgniterCallerBodyUtils, IgniterCallerBuilder, type IgniterCallerBuilderFactory, type IgniterCallerBuilderState, IgniterCallerCacheUtils, type IgniterCallerDirectRequestOptions, type IgniterCallerEndpointSchema, IgniterCallerError, type IgniterCallerErrorCode, type IgniterCallerErrorPayload, type IgniterCallerEventCallback, IgniterCallerEvents, type IgniterCallerFileResponse, type IgniterCallerHttpMethod, type IgniterCallerMethodRequestBuilder, IgniterCallerMock, type IgniterCallerOperation, IgniterCallerRequestBuilder, type IgniterCallerRequestBuilderParams, type IgniterCallerRequestInterceptor, type IgniterCallerRequestOptions, type IgniterCallerResponseContentType, type IgniterCallerResponseInterceptor, type IgniterCallerResponseMarker, type IgniterCallerRetryOptions, type IgniterCallerSchemaMap, type IgniterCallerSchemaMethod, IgniterCallerSchemaUtils, type IgniterCallerSchemaValidationOptions, type IgniterCallerStoreAdapter, type IgniterCallerStoreOptions, type IgniterCallerUrlPattern, IgniterCallerUrlUtils, type IgniterCallerValidatableContentType, type InferAllResponseTypes, type InferRequestType, type InferResponseType, type InferSuccessResponseType, type SchemaMapEndpoint, type SchemaMapMethods, type SchemaMapPaths, type SchemaMapRequestType, type SchemaMapResponseType };
+export { type DeletePaths, type EndpointInfo, type ExtractPathParams, type GetPaths, type HeadPaths, IgniterCaller, type IgniterCallerApiResponse, type IgniterCallerBaseRequestOptions, IgniterCallerBodyUtils, IgniterCallerBuilder, type IgniterCallerBuilderFactory, type IgniterCallerBuilderState, IgniterCallerCacheUtils, type IgniterCallerDirectRequestOptions, type IgniterCallerEndpointSchema, IgniterCallerError, type IgniterCallerErrorCode, type IgniterCallerErrorPayload, type IgniterCallerEventCallback, IgniterCallerEvents, type IgniterCallerFileResponse, type IgniterCallerHttpMethod, type IgniterCallerMethodRequestBuilder, IgniterCallerMock, type IgniterCallerOperation, IgniterCallerRequestBuilder, type IgniterCallerRequestBuilderParams, type IgniterCallerRequestInterceptor, type IgniterCallerRequestOptions, type IgniterCallerResponseContentType, type IgniterCallerResponseInterceptor, type IgniterCallerResponseMarker, type IgniterCallerRetryOptions, type IgniterCallerSchemaMap, type IgniterCallerSchemaMethod, IgniterCallerSchemaUtils, type IgniterCallerSchemaValidationOptions, type IgniterCallerStoreAdapter, type IgniterCallerStoreOptions, type IgniterCallerTypedRequestBuilder, type IgniterCallerUrlPattern, IgniterCallerUrlUtils, type IgniterCallerValidatableContentType, type InferAllResponseTypes, type InferRequestType, type InferResponseType, type InferSuccessResponseType, type PatchPaths, type PathsForMethod, type PostPaths, type PutPaths, type ReplaceCallerSchema, type SchemaMapEndpoint, type SchemaMapMethods, type SchemaMapPaths, type SchemaMapRequestType, type SchemaMapResponseType, type TypedRequestBuilder };