@igniter-js/caller 0.1.1 → 0.1.2

package/dist/index.d.mts

@@ -291,7 +291,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 +303,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 +518,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 +540,28 @@ 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>>;
 /**
  * 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 +578,7 @@ declare class IgniterCaller {
         logger?: IgniterLogger;
         requestInterceptors?: IgniterCallerRequestInterceptor[];
         responseInterceptors?: IgniterCallerResponseInterceptor[];
-        schemas?: IgniterCallerSchemaMap;
+        schemas?: TSchemas;
         schemaValidation?: IgniterCallerSchemaValidationOptions;
     });
     /**
@@ -554,11 +586,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,24 +598,33 @@ 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.
      *
+     * 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 URL directly
+     * // With typed schema - response type is inferred
      * const result = await api.get('/users').execute()
+     * // result.data is typed based on schema
      *
-     * // With URL via method
+     * // Without schema or URL set later
      * const result = await api.get().url('/users').execute()
      * ```
      */
-    get(url?: string): IgniterCallerMethodRequestBuilder;
+    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.
+     *
      * @param url Optional URL for the request. Can also be set via `.url()`.
      *
      * @example
@@ -591,10 +632,12 @@ declare class IgniterCaller {
      * const result = await api.post('/users').body({ name: 'John' }).execute()
      * ```
      */
-    post(url?: string): IgniterCallerMethodRequestBuilder;
+    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.
+     *
      * @param url Optional URL for the request. Can also be set via `.url()`.
      *
      * @example
@@ -602,10 +645,12 @@ declare class IgniterCaller {
      * const result = await api.put('/users/1').body({ name: 'Jane' }).execute()
      * ```
      */
-    put(url?: string): IgniterCallerMethodRequestBuilder;
+    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.
+     *
      * @param url Optional URL for the request. Can also be set via `.url()`.
      *
      * @example
@@ -613,10 +658,12 @@ declare class IgniterCaller {
      * const result = await api.patch('/users/1').body({ name: 'Jane' }).execute()
      * ```
      */
-    patch(url?: string): IgniterCallerMethodRequestBuilder;
+    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.
+     *
      * @param url Optional URL for the request. Can also be set via `.url()`.
      *
      * @example
@@ -624,13 +671,15 @@ declare class IgniterCaller {
      * const result = await api.delete('/users/1').execute()
      * ```
      */
-    delete(url?: string): IgniterCallerMethodRequestBuilder;
+    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.
+     *
      * @param url Optional URL for the request. Can also be set via `.url()`.
      */
-    head(url?: string): IgniterCallerMethodRequestBuilder;
+    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 +1021,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 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 };

package/dist/index.d.ts

@@ -291,7 +291,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 +303,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 +518,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 +540,28 @@ 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>>;
 /**
  * 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 +578,7 @@ declare class IgniterCaller {
         logger?: IgniterLogger;
         requestInterceptors?: IgniterCallerRequestInterceptor[];
         responseInterceptors?: IgniterCallerResponseInterceptor[];
-        schemas?: IgniterCallerSchemaMap;
+        schemas?: TSchemas;
         schemaValidation?: IgniterCallerSchemaValidationOptions;
     });
     /**
@@ -554,11 +586,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,24 +598,33 @@ 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.
      *
+     * 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 URL directly
+     * // With typed schema - response type is inferred
      * const result = await api.get('/users').execute()
+     * // result.data is typed based on schema
      *
-     * // With URL via method
+     * // Without schema or URL set later
      * const result = await api.get().url('/users').execute()
      * ```
      */
-    get(url?: string): IgniterCallerMethodRequestBuilder;
+    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.
+     *
      * @param url Optional URL for the request. Can also be set via `.url()`.
      *
      * @example
@@ -591,10 +632,12 @@ declare class IgniterCaller {
      * const result = await api.post('/users').body({ name: 'John' }).execute()
      * ```
      */
-    post(url?: string): IgniterCallerMethodRequestBuilder;
+    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.
+     *
      * @param url Optional URL for the request. Can also be set via `.url()`.
      *
      * @example
@@ -602,10 +645,12 @@ declare class IgniterCaller {
      * const result = await api.put('/users/1').body({ name: 'Jane' }).execute()
      * ```
      */
-    put(url?: string): IgniterCallerMethodRequestBuilder;
+    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.
+     *
      * @param url Optional URL for the request. Can also be set via `.url()`.
      *
      * @example
@@ -613,10 +658,12 @@ declare class IgniterCaller {
      * const result = await api.patch('/users/1').body({ name: 'Jane' }).execute()
      * ```
      */
-    patch(url?: string): IgniterCallerMethodRequestBuilder;
+    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.
+     *
      * @param url Optional URL for the request. Can also be set via `.url()`.
      *
      * @example
@@ -624,13 +671,15 @@ declare class IgniterCaller {
      * const result = await api.delete('/users/1').execute()
      * ```
      */
-    delete(url?: string): IgniterCallerMethodRequestBuilder;
+    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.
+     *
      * @param url Optional URL for the request. Can also be set via `.url()`.
      */
-    head(url?: string): IgniterCallerMethodRequestBuilder;
+    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 +1021,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 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 };

package/dist/index.js

@@ -1307,17 +1307,29 @@ var _IgniterCaller = class _IgniterCaller {
       schemaValidation: this.schemaValidation
     };
   }
+  /**
+   * Resolves the full URL path by prepending baseURL if needed.
+   */
+  resolveSchemaPath(url) {
+    if (this.baseURL && !url.startsWith("http")) {
+      return `${this.baseURL}${url}`;
+    }
+    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 URL directly
+   * // With typed schema - response type is inferred
    * const result = await api.get('/users').execute()
+   * // result.data is typed based on schema
    *
-   * // With URL via method
+   * // Without schema or URL set later
    * const result = await api.get().url('/users').execute()
    * ```
    */
@@ -1330,6 +1342,8 @@ var _IgniterCaller = class _IgniterCaller {
   /**
    * 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
@@ -1346,6 +1360,8 @@ var _IgniterCaller = class _IgniterCaller {
   /**
    * 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
@@ -1362,6 +1378,8 @@ var _IgniterCaller = class _IgniterCaller {
   /**
    * 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
@@ -1378,6 +1396,8 @@ var _IgniterCaller = class _IgniterCaller {
   /**
    * 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
@@ -1394,6 +1414,8 @@ var _IgniterCaller = class _IgniterCaller {
   /**
    * 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) {