@igniter-js/caller 0.1.2 → 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.
  */
@@ -553,6 +600,19 @@ type GetEndpoint<TSchemas extends IgniterCallerSchemaMap, TPath extends string,
  * 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.
  *
@@ -605,80 +665,110 @@ declare class IgniterCaller<TSchemas extends IgniterCallerSchemaMap = IgniterCal
     /**
      * Creates a GET request.
      *
-     * When a URL is provided and matches a schema, the response type is automatically inferred.
+     * 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. Can also be set via `.url()`.
+     * @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 typed schema - response type is inferred
-     * 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
      *
-     * // Without schema or URL set later
+     * // Without URL (set later with .url())
      * const result = await api.get().url('/users').execute()
      * ```
      */
+    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.
+     *
+     * 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. Can also be set via `.url()`.
+     * @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<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.
      *
-     * When a URL is provided and matches a schema, the response type is automatically inferred.
+     * 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. Can also be set via `.url()`.
+     * @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<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.
      *
-     * When a URL is provided and matches a schema, the response type is automatically inferred.
+     * 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. Can also be set via `.url()`.
+     * @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<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.
      *
-     * When a URL is provided and matches a schema, the response type is automatically inferred.
+     * 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. Can also be set via `.url()`.
+     * @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<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.
      *
-     * When a URL is provided and matches a schema, the response type is automatically inferred.
+     * 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. Can also be set via `.url()`.
+     * @param url Optional URL for the request.
      */
+    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).
@@ -1021,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 IgniterCallerTypedRequestBuilder, type IgniterCallerUrlPattern, IgniterCallerUrlUtils, type IgniterCallerValidatableContentType, type InferAllResponseTypes, type InferRequestType, type InferResponseType, type InferSuccessResponseType, type ReplaceCallerSchema, 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.
  */
@@ -553,6 +600,19 @@ type GetEndpoint<TSchemas extends IgniterCallerSchemaMap, TPath extends string,
  * 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.
  *
@@ -605,80 +665,110 @@ declare class IgniterCaller<TSchemas extends IgniterCallerSchemaMap = IgniterCal
     /**
      * Creates a GET request.
      *
-     * When a URL is provided and matches a schema, the response type is automatically inferred.
+     * 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. Can also be set via `.url()`.
+     * @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 typed schema - response type is inferred
-     * 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
      *
-     * // Without schema or URL set later
+     * // Without URL (set later with .url())
      * const result = await api.get().url('/users').execute()
      * ```
      */
+    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.
+     *
+     * 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. Can also be set via `.url()`.
+     * @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<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.
      *
-     * When a URL is provided and matches a schema, the response type is automatically inferred.
+     * 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. Can also be set via `.url()`.
+     * @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<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.
      *
-     * When a URL is provided and matches a schema, the response type is automatically inferred.
+     * 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. Can also be set via `.url()`.
+     * @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<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.
      *
-     * When a URL is provided and matches a schema, the response type is automatically inferred.
+     * 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. Can also be set via `.url()`.
+     * @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<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.
      *
-     * When a URL is provided and matches a schema, the response type is automatically inferred.
+     * 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. Can also be set via `.url()`.
+     * @param url Optional URL for the request.
      */
+    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).
@@ -1021,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 IgniterCallerTypedRequestBuilder, type IgniterCallerUrlPattern, IgniterCallerUrlUtils, type IgniterCallerValidatableContentType, type InferAllResponseTypes, type InferRequestType, type InferResponseType, type InferSuccessResponseType, type ReplaceCallerSchema, 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.js

@@ -1316,108 +1316,36 @@ var _IgniterCaller = class _IgniterCaller {
     }
     return url;
   }
-  /**
-   * Creates a GET request.
-   *
-   * When a URL is provided and matches a schema, the response type is automatically inferred.
-   *
-   * @param url Optional URL for the request. Can also be set via `.url()`.
-   *
-   * @example
-   * ```ts
-   * // With typed schema - response type is inferred
-   * const result = await api.get('/users').execute()
-   * // result.data is typed based on schema
-   *
-   * // Without schema or URL set later
-   * const result = await api.get().url('/users').execute()
-   * ```
-   */
   get(url) {
     const builder = new IgniterCallerRequestBuilder(this.createBuilderParams());
     builder._setMethod("GET");
     if (url) builder._setUrl(url);
     return builder;
   }
-  /**
-   * Creates a POST request.
-   *
-   * When a URL is provided and matches a schema, the response type is automatically inferred.
-   *
-   * @param url Optional URL for the request. Can also be set via `.url()`.
-   *
-   * @example
-   * ```ts
-   * const result = await api.post('/users').body({ name: 'John' }).execute()
-   * ```
-   */
   post(url) {
     const builder = new IgniterCallerRequestBuilder(this.createBuilderParams());
     builder._setMethod("POST");
     if (url) builder._setUrl(url);
     return builder;
   }
-  /**
-   * Creates a PUT request.
-   *
-   * When a URL is provided and matches a schema, the response type is automatically inferred.
-   *
-   * @param url Optional URL for the request. Can also be set via `.url()`.
-   *
-   * @example
-   * ```ts
-   * const result = await api.put('/users/1').body({ name: 'Jane' }).execute()
-   * ```
-   */
   put(url) {
     const builder = new IgniterCallerRequestBuilder(this.createBuilderParams());
     builder._setMethod("PUT");
     if (url) builder._setUrl(url);
     return builder;
   }
-  /**
-   * Creates a PATCH request.
-   *
-   * When a URL is provided and matches a schema, the response type is automatically inferred.
-   *
-   * @param url Optional URL for the request. Can also be set via `.url()`.
-   *
-   * @example
-   * ```ts
-   * const result = await api.patch('/users/1').body({ name: 'Jane' }).execute()
-   * ```
-   */
   patch(url) {
     const builder = new IgniterCallerRequestBuilder(this.createBuilderParams());
     builder._setMethod("PATCH");
     if (url) builder._setUrl(url);
     return builder;
   }
-  /**
-   * Creates a DELETE request.
-   *
-   * When a URL is provided and matches a schema, the response type is automatically inferred.
-   *
-   * @param url Optional URL for the request. Can also be set via `.url()`.
-   *
-   * @example
-   * ```ts
-   * const result = await api.delete('/users/1').execute()
-   * ```
-   */
   delete(url) {
     const builder = new IgniterCallerRequestBuilder(this.createBuilderParams());
     builder._setMethod("DELETE");
     if (url) builder._setUrl(url);
     return builder;
   }
-  /**
-   * Creates a HEAD request.
-   *
-   * When a URL is provided and matches a schema, the response type is automatically inferred.
-   *
-   * @param url Optional URL for the request. Can also be set via `.url()`.
-   */
   head(url) {
     const builder = new IgniterCallerRequestBuilder(this.createBuilderParams());
     builder._setMethod("HEAD");