@zayne-labs/callapi-plugins 4.0.10 → 4.0.11

package/dist/esm/index.d.ts

@@ -1,6 +1,7 @@
+import * as _zayne_labs_callapi_utils0 from "@zayne-labs/callapi/utils";
 import { AnyFunction } from "@zayne-labs/toolkit-type-helpers";
 
-//#region ../callapi/dist/esm/common-DvPxUh-h.d.ts
+//#region ../callapi/dist/esm/common-DTliA7CY.d.ts
 //#region src/types/type-helpers.d.ts
 type AnyString = string & NonNullable<unknown>;
 type AnyNumber = number & NonNullable<unknown>;
@@ -289,6 +290,7 @@ interface URLOptions {
 //#endregion
 //#region src/validation.d.ts
 type InferSchemaOutputResult<TSchema$1, TFallbackResult = unknown> = undefined extends TSchema$1 ? TFallbackResult : TSchema$1 extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TSchema$1> : TSchema$1 extends AnyFunction$1<infer TResult> ? Awaited<TResult> : TFallbackResult;
+type InferSchemaInputResult<TSchema$1, TFallbackResult = unknown> = undefined extends TSchema$1 ? TFallbackResult : TSchema$1 extends StandardSchemaV1 ? StandardSchemaV1.InferInput<TSchema$1> : TSchema$1 extends AnyFunction$1<infer TResult> ? Awaited<TResult> : TFallbackResult;
 interface CallApiSchemaConfig {
   /**
    * The base url of the schema. By default it's the baseURL of the callApi instance.
@@ -370,23 +372,31 @@ type BaseCallApiSchemaAndConfig = {
 declare const fallBackRouteSchemaKey = ".";
 type FallBackRouteSchemaKey = typeof fallBackRouteSchemaKey;
 //#endregion
-//#region src/error.d.ts
-type HTTPErrorDetails<TErrorData> = Pick<CallApiExtraOptions, "defaultHTTPErrorMessage"> & {
-  errorData: TErrorData;
+//#region src/utils/external/body.d.ts
+
+//#endregion
+//#region src/types/default-types.d.ts
+type DefaultDataType = unknown;
+type DefaultPluginArray = CallApiPlugin[];
+type DefaultThrowOnError = boolean;
+//#endregion
+//#region src/utils/external/error.d.ts
+type HTTPErrorDetails<TErrorData$1> = Pick<CallApiExtraOptions, "defaultHTTPErrorMessage"> & {
+  errorData: TErrorData$1;
   response: Response;
 };
-declare class HTTPError<TErrorData = Record<string, unknown>> extends Error {
-  errorData: HTTPErrorDetails<TErrorData>["errorData"];
+declare class HTTPError<TErrorData$1 = Record<string, unknown>> extends Error {
+  errorData: HTTPErrorDetails<TErrorData$1>["errorData"];
   readonly httpErrorSymbol: symbol;
   name: "HTTPError";
-  response: HTTPErrorDetails<TErrorData>["response"];
-  constructor(errorDetails: HTTPErrorDetails<TErrorData>, errorOptions?: ErrorOptions);
+  response: HTTPErrorDetails<TErrorData$1>["response"];
+  constructor(errorDetails: HTTPErrorDetails<TErrorData$1>, errorOptions?: ErrorOptions);
   /**
    * @description Checks if the given error is an instance of HTTPError
    * @param error - The error to check
    * @returns true if the error is an instance of HTTPError, false otherwise
    */
-  static isError<TErrorData>(error: unknown): error is HTTPError<TErrorData>;
+  static isError<TErrorData>(error: unknown): error is HTTPError<TErrorData$1>;
 }
 type SafeExtract<TUnion, TKey extends TUnion> = Extract<TUnion, TKey>;
 type ValidationErrorDetails = {
@@ -420,6 +430,69 @@ declare class ValidationError extends Error {
   static isError(error: unknown): error is ValidationError;
 }
 //#endregion
+//#region src/result.d.ts
+type Parser<TData$1> = (responseString: string) => Awaitable<TData$1>;
+declare const getResponseType: <TResponse>(response: Response, parser: Parser<TResponse>) => {
+  arrayBuffer: () => Promise<ArrayBuffer>;
+  blob: () => Promise<Blob>;
+  formData: () => Promise<FormData>;
+  json: () => Promise<TResponse>;
+  stream: () => ReadableStream<Uint8Array<ArrayBuffer>> | null;
+  text: () => Promise<string>;
+};
+type InitResponseTypeMap<TResponse$1 = unknown> = ReturnType<typeof getResponseType<TResponse$1>>;
+type ResponseTypeUnion = keyof InitResponseTypeMap | null;
+type ResponseTypeMap<TResponse$1> = { [Key in keyof InitResponseTypeMap<TResponse$1>]: Awaited<ReturnType<InitResponseTypeMap<TResponse$1>[Key]>> };
+type GetResponseType<TResponse$1, TResponseType extends ResponseTypeUnion, TComputedResponseTypeMap extends ResponseTypeMap<TResponse$1> = ResponseTypeMap<TResponse$1>> = null extends TResponseType ? TComputedResponseTypeMap["json"] : TResponseType extends NonNullable<ResponseTypeUnion> ? TComputedResponseTypeMap[TResponseType] : never;
+type CallApiResultSuccessVariant<TData$1> = {
+  data: NoInfer<TData$1>;
+  error: null;
+  response: Response;
+};
+type PossibleJavaScriptError = UnmaskType<{
+  errorData: false;
+  message: string;
+  name: "AbortError" | "Error" | "SyntaxError" | "TimeoutError" | "TypeError" | AnyString;
+  originalError: DOMException | Error | SyntaxError | TypeError;
+}>;
+type PossibleHTTPError<TErrorData$1> = UnmaskType<{
+  errorData: NoInfer<TErrorData$1>;
+  message: string;
+  name: "HTTPError";
+  originalError: HTTPError;
+}>;
+type PossibleValidationError = UnmaskType<{
+  errorData: ValidationError["errorData"];
+  issueCause: ValidationError["issueCause"];
+  message: string;
+  name: "ValidationError";
+  originalError: ValidationError;
+}>;
+type PossibleJavaScriptOrValidationError = UnmaskType<PossibleJavaScriptError | PossibleValidationError>;
+type CallApiResultErrorVariant<TErrorData$1> = {
+  data: null;
+  error: PossibleHTTPError<TErrorData$1>;
+  response: Response;
+} | {
+  data: null;
+  error: PossibleJavaScriptOrValidationError;
+  response: Response | null;
+};
+type CallApiSuccessOrErrorVariant<TData$1, TError> = CallApiResultErrorVariant<TError> | CallApiResultSuccessVariant<TData$1>;
+type ResultModeMapWithoutException<TData$1, TErrorData$1, TResponseType extends ResponseTypeUnion, TComputedData = GetResponseType<TData$1, TResponseType>, TComputedErrorData = GetResponseType<TErrorData$1, TResponseType>, TComputedResult extends CallApiSuccessOrErrorVariant<TComputedData, TComputedErrorData> = CallApiSuccessOrErrorVariant<TComputedData, TComputedErrorData>> = UnmaskType<{
+  all: TComputedResult;
+  onlyData: TComputedResult["data"];
+  onlyResponse: TComputedResult["response"];
+}>;
+type ResultModeMapWithException<TData$1, TResponseType extends ResponseTypeUnion, TComputedData = GetResponseType<TData$1, TResponseType>, TComputedResult extends CallApiResultSuccessVariant<TComputedData> = CallApiResultSuccessVariant<TComputedData>> = {
+  all: TComputedResult;
+  onlyData: TComputedResult["data"];
+  onlyResponse: TComputedResult["response"];
+};
+type ResultModeMap<TData$1 = DefaultDataType, TErrorData$1 = DefaultDataType, TResponseType extends ResponseTypeUnion = ResponseTypeUnion, TThrowOnError extends ThrowOnErrorUnion = DefaultThrowOnError> = TThrowOnError extends true ? ResultModeMapWithException<TData$1, TResponseType> : ResultModeMapWithoutException<TData$1, TErrorData$1, TResponseType>;
+type ResultModePlaceholder = null;
+type ResultModeUnion = keyof ResultModeMap | ResultModePlaceholder;
+//#endregion
 //#region src/middlewares.d.ts
 type FetchImpl = UnmaskType<(input: string | Request | URL, init?: RequestInit) => Promise<Response>>;
 interface Middlewares {
@@ -467,7 +540,7 @@ type PluginInitResult = Partial<Omit<PluginSetupContext, "initURL" | "request">
   initURL: InitURLOrURLObject;
   request: CallApiRequestOptions;
 }>;
-type PluginHooks<TData = never, TErrorData = never, TMoreOptions = unknown> = HooksOrHooksArray<TData, TErrorData, TMoreOptions>;
+type PluginHooks<TData$1 = never, TErrorData$1 = never, TMoreOptions = unknown> = HooksOrHooksArray<TData$1, TErrorData$1, TMoreOptions>;
 interface CallApiPlugin {
   /**
    * Defines additional options that can be passed to callApi
@@ -507,73 +580,8 @@ interface CallApiPlugin {
   version?: string;
 }
 //#endregion
-//#region src/types/default-types.d.ts
-type DefaultDataType = unknown;
-type DefaultPluginArray = CallApiPlugin[];
-type DefaultThrowOnError = boolean;
-//#endregion
-//#region src/result.d.ts
-type Parser<TData> = (responseString: string) => Awaitable<TData>;
-declare const getResponseType: <TResponse>(response: Response, parser: Parser<TResponse>) => {
-  arrayBuffer: () => Promise<ArrayBuffer>;
-  blob: () => Promise<Blob>;
-  formData: () => Promise<FormData>;
-  json: () => Promise<TResponse>;
-  stream: () => ReadableStream<Uint8Array<ArrayBuffer>> | null;
-  text: () => Promise<string>;
-};
-type InitResponseTypeMap<TResponse$1 = unknown> = ReturnType<typeof getResponseType<TResponse$1>>;
-type ResponseTypeUnion = keyof InitResponseTypeMap | null;
-type ResponseTypeMap<TResponse$1> = { [Key in keyof InitResponseTypeMap<TResponse$1>]: Awaited<ReturnType<InitResponseTypeMap<TResponse$1>[Key]>> };
-type GetResponseType<TResponse$1, TResponseType extends ResponseTypeUnion, TComputedResponseTypeMap extends ResponseTypeMap<TResponse$1> = ResponseTypeMap<TResponse$1>> = null extends TResponseType ? TComputedResponseTypeMap["json"] : TResponseType extends NonNullable<ResponseTypeUnion> ? TComputedResponseTypeMap[TResponseType] : never;
-type CallApiResultSuccessVariant<TData> = {
-  data: NoInfer<TData>;
-  error: null;
-  response: Response;
-};
-type PossibleJavaScriptError = UnmaskType<{
-  errorData: false;
-  message: string;
-  name: "AbortError" | "Error" | "SyntaxError" | "TimeoutError" | "TypeError" | AnyString;
-  originalError: DOMException | Error | SyntaxError | TypeError;
-}>;
-type PossibleHTTPError<TErrorData> = UnmaskType<{
-  errorData: NoInfer<TErrorData>;
-  message: string;
-  name: "HTTPError";
-  originalError: HTTPError;
-}>;
-type PossibleValidationError = UnmaskType<{
-  errorData: ValidationError["errorData"];
-  issueCause: ValidationError["issueCause"];
-  message: string;
-  name: "ValidationError";
-  originalError: ValidationError;
-}>;
-type PossibleJavaScriptOrValidationError = UnmaskType<PossibleJavaScriptError | PossibleValidationError>;
-type CallApiResultErrorVariant<TErrorData> = {
-  data: null;
-  error: PossibleHTTPError<TErrorData>;
-  response: Response;
-} | {
-  data: null;
-  error: PossibleJavaScriptOrValidationError;
-  response: Response | null;
-};
-type CallApiSuccessOrErrorVariant<TData, TError> = CallApiResultErrorVariant<TError> | CallApiResultSuccessVariant<TData>;
-type ResultModeMapWithoutException<TData, TErrorData, TResponseType extends ResponseTypeUnion, TComputedData = GetResponseType<TData, TResponseType>, TComputedErrorData = GetResponseType<TErrorData, TResponseType>, TComputedResult extends CallApiSuccessOrErrorVariant<TComputedData, TComputedErrorData> = CallApiSuccessOrErrorVariant<TComputedData, TComputedErrorData>> = UnmaskType<{
-  all: TComputedResult;
-  onlyData: TComputedResult["data"];
-  onlyResponse: TComputedResult["response"];
-}>;
-type ResultModeMapWithException<TData, TResponseType extends ResponseTypeUnion, TComputedData = GetResponseType<TData, TResponseType>, TComputedResult extends CallApiResultSuccessVariant<TComputedData> = CallApiResultSuccessVariant<TComputedData>> = {
-  all: TComputedResult;
-  onlyData: TComputedResult["data"];
-  onlyResponse: TComputedResult["response"];
-};
-type ResultModeMap<TData = DefaultDataType, TErrorData = DefaultDataType, TResponseType extends ResponseTypeUnion = ResponseTypeUnion, TThrowOnError extends ThrowOnErrorUnion = DefaultThrowOnError> = TThrowOnError extends true ? ResultModeMapWithException<TData, TResponseType> : ResultModeMapWithoutException<TData, TErrorData, TResponseType>;
-type ResultModePlaceholder = null;
-type ResultModeUnion = keyof ResultModeMap | ResultModePlaceholder;
+//#region src/utils/external/define.d.ts
+
 //#endregion
 //#region src/stream.d.ts
 type StreamProgressEvent = {
@@ -605,7 +613,7 @@ type PluginExtraOptions<TPluginOptions = unknown> = {
   /** Plugin-specific options passed to the plugin configuration */
   options: Partial<TPluginOptions>;
 };
-interface Hooks<TData = DefaultDataType, TErrorData = DefaultDataType, TPluginOptions = unknown> {
+interface Hooks<TData$1 = DefaultDataType, TErrorData$1 = DefaultDataType, TPluginOptions = unknown> {
   /**
    * Hook called when any error occurs within the request/response lifecycle.
    *
@@ -616,7 +624,7 @@ interface Hooks<TData = DefaultDataType, TErrorData = DefaultDataType, TPluginOp
    * @param context - Error context containing error details, request info, and response (if available)
    * @returns Promise or void - Hook can be async or sync
    */
-  onError?: (context: ErrorContext<TErrorData> & PluginExtraOptions<TPluginOptions>) => Awaitable<unknown>;
+  onError?: (context: ErrorContext<TErrorData$1> & PluginExtraOptions<TPluginOptions>) => Awaitable<unknown>;
   /**
    * Hook called before the HTTP request is sent and before any internal processing of the request object begins.
    *
@@ -668,7 +676,7 @@ interface Hooks<TData = DefaultDataType, TErrorData = DefaultDataType, TPluginOp
    * @returns Promise or void - Hook can be async or sync
    *
    */
-  onResponse?: (context: ResponseContext<TData, TErrorData> & PluginExtraOptions<TPluginOptions>) => Awaitable<unknown>;
+  onResponse?: (context: ResponseContext<TData$1, TErrorData$1> & PluginExtraOptions<TPluginOptions>) => Awaitable<unknown>;
   /**
    * Hook called when an HTTP error response (4xx, 5xx) is received from the API.
    *
@@ -679,7 +687,7 @@ interface Hooks<TData = DefaultDataType, TErrorData = DefaultDataType, TPluginOp
    * @param context - Response error context with HTTP error details and response
    * @returns Promise or void - Hook can be async or sync
    */
-  onResponseError?: (context: ResponseErrorContext<TErrorData> & PluginExtraOptions<TPluginOptions>) => Awaitable<unknown>;
+  onResponseError?: (context: ResponseErrorContext<TErrorData$1> & PluginExtraOptions<TPluginOptions>) => Awaitable<unknown>;
   /**
    * Hook called during download stream progress tracking.
    *
@@ -703,7 +711,7 @@ interface Hooks<TData = DefaultDataType, TErrorData = DefaultDataType, TPluginOp
    * @returns Promise or void - Hook can be async or sync
    *
    */
-  onRetry?: (response: RetryContext<TErrorData> & PluginExtraOptions<TPluginOptions>) => Awaitable<unknown>;
+  onRetry?: (response: RetryContext<TErrorData$1> & PluginExtraOptions<TPluginOptions>) => Awaitable<unknown>;
   /**
    * Hook called when a successful response (2xx status) is received from the API.
    *
@@ -715,7 +723,7 @@ interface Hooks<TData = DefaultDataType, TErrorData = DefaultDataType, TPluginOp
    * @returns Promise or void - Hook can be async or sync
    *
    */
-  onSuccess?: (context: SuccessContext<TData> & PluginExtraOptions<TPluginOptions>) => Awaitable<unknown>;
+  onSuccess?: (context: SuccessContext<TData$1> & PluginExtraOptions<TPluginOptions>) => Awaitable<unknown>;
   /**
    * Hook called when a validation error occurs.
    *
@@ -729,7 +737,7 @@ interface Hooks<TData = DefaultDataType, TErrorData = DefaultDataType, TPluginOp
    */
   onValidationError?: (context: ValidationErrorContext & PluginExtraOptions<TPluginOptions>) => Awaitable<unknown>;
 }
-type HooksOrHooksArray<TData = DefaultDataType, TErrorData = DefaultDataType, TMoreOptions = unknown> = { [Key in keyof Hooks<TData, TErrorData, TMoreOptions>]: Hooks<TData, TErrorData, TMoreOptions>[Key] | Array<Hooks<TData, TErrorData, TMoreOptions>[Key]> };
+type HooksOrHooksArray<TData$1 = DefaultDataType, TErrorData$1 = DefaultDataType, TMoreOptions = unknown> = { [Key in keyof Hooks<TData$1, TErrorData$1, TMoreOptions>]: Hooks<TData$1, TErrorData$1, TMoreOptions>[Key] | Array<Hooks<TData$1, TErrorData$1, TMoreOptions>[Key]> };
 interface HookConfigOptions {
   /**
    * Controls the execution mode of all composed hooks (main + plugin hooks).
@@ -790,14 +798,14 @@ type RequestContext = {
    * made by this client instance, such as baseURL, default headers, and
    * global options.
    */
-  baseConfig: BaseCallApiExtraOptions & CallApiRequestOptions;
+  baseConfig: Exclude<BaseCallApiConfig, AnyFunction$1>;
   /**
    * Instance-specific configuration object passed to the callApi instance.
    *
    * Contains configuration specific to this particular API call, which
    * can override or extend the base configuration.
    */
-  config: CallApiExtraOptions & CallApiRequestOptions;
+  config: CallApiConfig;
   /**
    * Merged options combining base config, instance config, and default options.
    *
@@ -820,14 +828,14 @@ type ValidationErrorContext = UnmaskType<RequestContext & {
   /** HTTP response object if validation failed on response, null if on request */
   response: Response | null;
 }>;
-type SuccessContext<TData> = UnmaskType<RequestContext & {
+type SuccessContext<TData$1> = UnmaskType<RequestContext & {
   /** Parsed response data with the expected success type */
-  data: TData;
+  data: TData$1;
   /** HTTP response object for the successful request */
   response: Response;
 }>;
-type ResponseContext<TData, TErrorData> = UnmaskType<RequestContext & (Prettify<CallApiResultSuccessVariant<TData>> | Prettify<Extract<CallApiResultErrorVariant<TErrorData>, {
-  error: PossibleHTTPError<TErrorData>;
+type ResponseContext<TData$1, TErrorData$1> = UnmaskType<RequestContext & (Prettify<CallApiResultSuccessVariant<TData$1>> | Prettify<Extract<CallApiResultErrorVariant<TErrorData$1>, {
+  error: PossibleHTTPError<TErrorData$1>;
 }>>)>;
 type RequestErrorContext = RequestContext & {
   /** Error that occurred during the request (network, timeout, etc.) */
@@ -835,9 +843,9 @@ type RequestErrorContext = RequestContext & {
   /** Always null for request errors since no response was received */
   response: null;
 };
-type ErrorContext<TErrorData> = UnmaskType<RequestContext & ({
+type ErrorContext<TErrorData$1> = UnmaskType<RequestContext & ({
   /** HTTP error with response data */
-  error: PossibleHTTPError<TErrorData>;
+  error: PossibleHTTPError<TErrorData$1>;
   /** HTTP response object containing error status */
   response: Response;
 } | {
@@ -846,10 +854,10 @@ type ErrorContext<TErrorData> = UnmaskType<RequestContext & ({
   /** Response object if available, null for request errors */
   response: Response | null;
 })>;
-type ResponseErrorContext<TErrorData> = UnmaskType<Extract<ErrorContext<TErrorData>, {
-  error: PossibleHTTPError<TErrorData>;
+type ResponseErrorContext<TErrorData$1> = UnmaskType<Extract<ErrorContext<TErrorData$1>, {
+  error: PossibleHTTPError<TErrorData$1>;
 }> & RequestContext>;
-type RetryContext<TErrorData> = UnmaskType<ErrorContext<TErrorData> & {
+type RetryContext<TErrorData$1> = UnmaskType<ErrorContext<TErrorData$1> & {
   /** Current retry attempt number (1-based, so 1 = first retry) */
   retryAttemptCount: number;
 }>;
@@ -1094,10 +1102,10 @@ declare const defaultRetryStatusCodesLookup: () => Readonly<{
   504: "Gateway Timeout";
 }>;
 type RetryStatusCodes = UnmaskType<AnyNumber | keyof ReturnType<typeof defaultRetryStatusCodesLookup>>;
-type RetryCondition<TErrorData> = (context: ErrorContext<TErrorData>) => Awaitable<boolean>;
-type RetryOptionKeys<TErrorData> = Exclude<keyof RetryOptions<TErrorData>, "~retryAttemptCount" | "retry">;
-type InnerRetryOptions<TErrorData> = { [Key in RetryOptionKeys<TErrorData> as RemovePrefix<"retry", Key>]?: RetryOptions<TErrorData>[Key] };
-interface RetryOptions<TErrorData> {
+type RetryCondition<TErrorData$1> = (context: ErrorContext<TErrorData$1>) => Awaitable<boolean>;
+type RetryOptionKeys<TErrorData$1> = Exclude<keyof RetryOptions<TErrorData$1>, "~retryAttemptCount" | "retry">;
+type InnerRetryOptions<TErrorData$1> = { [Key in RetryOptionKeys<TErrorData$1> as RemovePrefix<"retry", Key>]?: RetryOptions<TErrorData$1>[Key] };
+interface RetryOptions<TErrorData$1> {
   /**
    * Keeps track of the number of times the request has already been retried
    * @internal
@@ -1107,7 +1115,7 @@ interface RetryOptions<TErrorData> {
   /**
    * All retry options in a single object instead of separate properties
    */
-  retry?: InnerRetryOptions<TErrorData>;
+  retry?: InnerRetryOptions<TErrorData$1>;
   /**
    * Number of allowed retry attempts on HTTP errors
    * @default 0
@@ -1116,7 +1124,7 @@ interface RetryOptions<TErrorData> {
   /**
    * Callback whose return value determines if a request should be retried or not
    */
-  retryCondition?: RetryCondition<TErrorData>;
+  retryCondition?: RetryCondition<TErrorData$1>;
   /**
    * Delay between retries in milliseconds
    * @default 1000
@@ -1147,34 +1155,112 @@ interface RetryOptions<TErrorData> {
 /**
  * @description Makes a type partial if the output type of TSchema is not provided or has undefined in the union, otherwise makes it required
  */
-
-type GetCurrentRouteSchema<TBaseSchemaRoutes extends BaseCallApiSchemaRoutes, TCurrentRouteSchemaKey extends string, TComputedFallBackRouteSchema = TBaseSchemaRoutes[FallBackRouteSchemaKey], TComputedCurrentRouteSchema = TBaseSchemaRoutes[TCurrentRouteSchemaKey], TComputedRouteSchema extends CallApiSchema = NonNullable<Omit<TComputedFallBackRouteSchema, keyof TComputedCurrentRouteSchema> & TComputedCurrentRouteSchema>> = TComputedRouteSchema extends CallApiSchema ? Writeable<TComputedRouteSchema, "deep"> : CallApiSchema;
+type MakeSchemaOptionRequiredIfDefined<TSchemaOption extends CallApiSchema[keyof CallApiSchema], TObject> = undefined extends InferSchemaInputResult<TSchemaOption, undefined> ? TObject : Required<TObject>;
+type ApplyURLBasedConfig<TSchemaConfig$1 extends CallApiSchemaConfig, TSchemaRouteKeys extends string> = TSchemaConfig$1["prefix"] extends string ? `${TSchemaConfig$1["prefix"]}${TSchemaRouteKeys}` : TSchemaConfig$1["baseURL"] extends string ? `${TSchemaConfig$1["baseURL"]}${TSchemaRouteKeys}` : TSchemaRouteKeys;
+type ApplyStrictConfig<TSchemaConfig$1 extends CallApiSchemaConfig, TSchemaRouteKeys extends string> = TSchemaConfig$1["strict"] extends true ? TSchemaRouteKeys :
+// eslint-disable-next-line perfectionist/sort-union-types -- Don't sort union types
+TSchemaRouteKeys | Exclude<InitURLOrURLObject, RouteKeyMethodsURLUnion>;
+type ApplySchemaConfiguration<TSchemaConfig$1 extends CallApiSchemaConfig, TSchemaRouteKeys extends string> = ApplyStrictConfig<TSchemaConfig$1, ApplyURLBasedConfig<TSchemaConfig$1, TSchemaRouteKeys>>;
+type InferAllRouteKeys<TBaseSchemaRoutes$1 extends BaseCallApiSchemaRoutes, TSchemaConfig$1 extends CallApiSchemaConfig> = ApplySchemaConfiguration<TSchemaConfig$1, Exclude<Extract<keyof TBaseSchemaRoutes$1, string>, FallBackRouteSchemaKey>>;
+type InferInitURL<TBaseSchemaRoutes$1 extends BaseCallApiSchemaRoutes, TSchemaConfig$1 extends CallApiSchemaConfig> = keyof TBaseSchemaRoutes$1 extends never ? InitURLOrURLObject : InferAllRouteKeys<TBaseSchemaRoutes$1, TSchemaConfig$1>;
+type GetCurrentRouteSchema<TBaseSchemaRoutes$1 extends BaseCallApiSchemaRoutes, TCurrentRouteSchemaKey extends string, TComputedFallBackRouteSchema = TBaseSchemaRoutes$1[FallBackRouteSchemaKey], TComputedCurrentRouteSchema = TBaseSchemaRoutes$1[TCurrentRouteSchemaKey], TComputedRouteSchema extends CallApiSchema = NonNullable<Omit<TComputedFallBackRouteSchema, keyof TComputedCurrentRouteSchema> & TComputedCurrentRouteSchema>> = TComputedRouteSchema extends CallApiSchema ? Writeable<TComputedRouteSchema, "deep"> : CallApiSchema;
 type JsonPrimitive = boolean | number | string | null | undefined;
 type SerializableObject = Record<keyof object, unknown>;
-type SerializableArray = Array<JsonPrimitive | SerializableArray | SerializableObject> | ReadonlyArray<JsonPrimitive | SerializableArray | SerializableObject>;
+type SerializableArray = Array<JsonPrimitive | SerializableObject> | ReadonlyArray<JsonPrimitive | SerializableObject>;
 type Body = UnmaskType<RequestInit["body"] | SerializableArray | SerializableObject>;
+type InferBodyOption<TSchema$1 extends CallApiSchema> = MakeSchemaOptionRequiredIfDefined<TSchema$1["body"], {
+  /**
+   * Body of the request, can be a object or any other supported body type.
+   */
+  body?: InferSchemaInputResult<TSchema$1["body"], Body>;
+}>;
 type MethodUnion = UnmaskType<"CONNECT" | "DELETE" | "GET" | "HEAD" | "OPTIONS" | "PATCH" | "POST" | "PUT" | "TRACE" | AnyString>;
+type InferMethodFromURL<TInitURL> = string extends TInitURL ? MethodUnion : TInitURL extends `@${infer TMethod extends RouteKeyMethods}/${string}` ? Uppercase<TMethod> : MethodUnion;
+type InferMethodOption<TSchema$1 extends CallApiSchema, TInitURL> = MakeSchemaOptionRequiredIfDefined<TSchema$1["method"], {
+  /**
+   * HTTP method for the request.
+   * @default "GET"
+   */
+  method?: InferSchemaInputResult<TSchema$1["method"], InferMethodFromURL<TInitURL>>;
+}>;
 type HeadersOption = UnmaskType<Record<"Authorization", CommonAuthorizationHeaders | undefined> | Record<"Content-Type", CommonContentTypes | undefined> | Record<CommonRequestHeaders, string | undefined> | Record<string, string | undefined> | Array<[string, string]>>;
+type InferHeadersOption<TSchema$1 extends CallApiSchema> = MakeSchemaOptionRequiredIfDefined<TSchema$1["headers"], {
+  /**
+   * Headers to be used in the request.
+   */
+  headers?: InferSchemaInputResult<TSchema$1["headers"], HeadersOption> | ((context: {
+    baseHeaders: NonNullable<HeadersOption>;
+  }) => InferSchemaInputResult<TSchema$1["headers"], HeadersOption>);
+}>;
+type InferRequestOptions<TSchema$1 extends CallApiSchema, TInitURL extends InferInitURL<BaseCallApiSchemaRoutes, CallApiSchemaConfig>> = InferBodyOption<TSchema$1> & InferHeadersOption<TSchema$1> & InferMethodOption<TSchema$1, TInitURL>;
 interface Register {}
 type GlobalMeta = Register extends {
   meta?: infer TMeta extends Record<string, unknown>;
 } ? TMeta : never;
+type InferMetaOption<TSchema$1 extends CallApiSchema> = MakeSchemaOptionRequiredIfDefined<TSchema$1["meta"], {
+  /**
+   * - An optional field you can fill with additional information,
+   * to associate with the request, typically used for logging or tracing.
+   *
+   * - A good use case for this, would be to use the info to handle specific cases in any of the shared interceptors.
+   *
+   * @example
+   * ```ts
+   * const callMainApi = callApi.create({
+   * 	baseURL: "https://main-api.com",
+   * 	onResponseError: ({ response, options }) => {
+   * 		if (options.meta?.userId) {
+   * 			console.error(`User ${options.meta.userId} made an error`);
+   * 		}
+   * 	},
+   * });
+   *
+   * const response = await callMainApi({
+   * 	url: "https://example.com/api/data",
+   * 	meta: { userId: "123" },
+   * });
+   * ```
+   */
+  meta?: InferSchemaInputResult<TSchema$1["meta"], GlobalMeta>;
+}>;
+type InferQueryOption<TSchema$1 extends CallApiSchema> = MakeSchemaOptionRequiredIfDefined<TSchema$1["query"], {
+  /**
+   * Parameters to be appended to the URL (i.e: /:id)
+   */
+  query?: InferSchemaInputResult<TSchema$1["query"], Query>;
+}>;
+type EmptyString = "";
+type EmptyTuple = readonly [];
+type StringTuple = readonly string[];
+type PossibleParamNamePatterns = `${string}:${string}` | `${string}{${string}}${"" | AnyString}`;
+type ExtractRouteParamNames<TCurrentRoute$1, TParamNamesAccumulator extends StringTuple = EmptyTuple> = TCurrentRoute$1 extends PossibleParamNamePatterns ? TCurrentRoute$1 extends `${infer TRoutePrefix}:${infer TParamAndRemainingRoute}` ? TParamAndRemainingRoute extends `${infer TCurrentParam}/${infer TRemainingRoute}` ? TCurrentParam extends EmptyString ? ExtractRouteParamNames<`${TRoutePrefix}/${TRemainingRoute}`, TParamNamesAccumulator> : ExtractRouteParamNames<`${TRoutePrefix}/${TRemainingRoute}`, [...TParamNamesAccumulator, TCurrentParam]> : TParamAndRemainingRoute extends `${infer TCurrentParam}` ? TCurrentParam extends EmptyString ? ExtractRouteParamNames<TRoutePrefix, TParamNamesAccumulator> : ExtractRouteParamNames<TRoutePrefix, [...TParamNamesAccumulator, TCurrentParam]> : ExtractRouteParamNames<TRoutePrefix, TParamNamesAccumulator> : TCurrentRoute$1 extends `${infer TRoutePrefix}{${infer TCurrentParam}}${infer TRemainingRoute}` ? TCurrentParam extends EmptyString ? ExtractRouteParamNames<`${TRoutePrefix}${TRemainingRoute}`, TParamNamesAccumulator> : ExtractRouteParamNames<`${TRoutePrefix}${TRemainingRoute}`, [...TParamNamesAccumulator, TCurrentParam]> : TParamNamesAccumulator : TParamNamesAccumulator;
+type ConvertParamNamesToRecord<TParamNames extends StringTuple> = Prettify<TParamNames extends (readonly [infer TFirstParamName extends string, ...infer TRemainingParamNames extends StringTuple]) ? Record<TFirstParamName, AllowedQueryParamValues> & ConvertParamNamesToRecord<TRemainingParamNames> : NonNullable<unknown>>;
+type ConvertParamNamesToTuple<TParamNames extends StringTuple> = TParamNames extends readonly [string, ...infer TRemainingParamNames extends StringTuple] ? [AllowedQueryParamValues, ...ConvertParamNamesToTuple<TRemainingParamNames>] : [];
+type InferParamsFromRoute<TCurrentRoute$1> = ExtractRouteParamNames<TCurrentRoute$1> extends StringTuple ? ExtractRouteParamNames<TCurrentRoute$1> extends EmptyTuple ? Params : ConvertParamNamesToRecord<ExtractRouteParamNames<TCurrentRoute$1>> | ConvertParamNamesToTuple<ExtractRouteParamNames<TCurrentRoute$1>> : Params;
+type MakeParamsOptionRequired<TParamsSchemaOption extends CallApiSchema["params"], TBaseSchemaRoutes$1 extends BaseCallApiSchemaRoutes, TCurrentRouteSchemaKey extends string, TObject> = MakeSchemaOptionRequiredIfDefined<TParamsSchemaOption, Params extends InferParamsFromRoute<TCurrentRouteSchemaKey> ? TObject : TCurrentRouteSchemaKey extends Extract<keyof TBaseSchemaRoutes$1, TCurrentRouteSchemaKey> ? undefined extends InferSchemaInputResult<TParamsSchemaOption, null> ? TObject : Required<TObject> : TObject>;
+type InferParamsOption<TSchema$1 extends CallApiSchema, TBaseSchemaRoutes$1 extends BaseCallApiSchemaRoutes, TCurrentRouteSchemaKey extends string> = MakeParamsOptionRequired<TSchema$1["params"], TBaseSchemaRoutes$1, TCurrentRouteSchemaKey, {
+  /**
+   * Parameters to be appended to the URL (i.e: /:id)
+   */
+  params?: InferSchemaInputResult<TSchema$1["params"], InferParamsFromRoute<TCurrentRouteSchemaKey>>;
+}>;
+type InferExtraOptions<TSchema$1 extends CallApiSchema, TBaseSchemaRoutes$1 extends BaseCallApiSchemaRoutes, TCurrentRouteSchemaKey extends string> = InferMetaOption<TSchema$1> & InferParamsOption<TSchema$1, TBaseSchemaRoutes$1, TCurrentRouteSchemaKey> & InferQueryOption<TSchema$1>;
 type InferPluginOptions<TPluginArray extends CallApiPlugin[]> = UnionToIntersection<TPluginArray extends Array<infer TPlugin> ? TPlugin extends CallApiPlugin ? TPlugin["defineExtraOptions"] extends AnyFunction$1<infer TReturnedSchema> ? InferSchemaOutputResult<TReturnedSchema> : never : never : never>;
-type ResultModeOption<TErrorData, TResultMode extends ResultModeUnion> = TErrorData extends false ? {
+type ResultModeOption<TErrorData$1, TResultMode extends ResultModeUnion> = TErrorData$1 extends false ? {
   resultMode: "onlyData";
-} : TErrorData extends false | undefined ? {
+} : TErrorData$1 extends false | undefined ? {
   resultMode?: "onlyData";
 } : {
   resultMode?: TResultMode;
 };
 type ThrowOnErrorUnion = boolean;
-type ThrowOnErrorType<TErrorData, TThrowOnError extends ThrowOnErrorUnion> = TThrowOnError | ((context: ErrorContext<TErrorData>) => TThrowOnError);
-type ThrowOnErrorOption<TErrorData, TThrowOnError extends ThrowOnErrorUnion> = TErrorData extends false ? {
+type ThrowOnErrorType<TErrorData$1, TThrowOnError extends ThrowOnErrorUnion> = TThrowOnError | ((context: ErrorContext<TErrorData$1>) => TThrowOnError);
+type ThrowOnErrorOption<TErrorData$1, TThrowOnError extends ThrowOnErrorUnion> = TErrorData$1 extends false ? {
   throwOnError: true;
-} : TErrorData extends false | undefined ? {
+} : TErrorData$1 extends false | undefined ? {
   throwOnError?: true;
 } : {
-  throwOnError?: ThrowOnErrorType<TErrorData, TThrowOnError>;
+  throwOnError?: ThrowOnErrorType<TErrorData$1, TThrowOnError>;
 };
 //#endregion
 //#region src/types/common.d.ts
@@ -1200,7 +1286,7 @@ type CallApiRequestOptions = Prettify<{
 type CallApiRequestOptionsForHooks = Omit<CallApiRequestOptions, "headers"> & {
   headers: Record<string, string | undefined>;
 };
-type SharedExtraOptions<TData = DefaultDataType, TErrorData = DefaultDataType, TResultMode extends ResultModeUnion = ResultModeUnion, TThrowOnError extends ThrowOnErrorUnion = DefaultThrowOnError, TResponseType extends ResponseTypeUnion = ResponseTypeUnion, TPluginArray extends CallApiPlugin[] = DefaultPluginArray> = DedupeOptions & HookConfigOptions & HooksOrHooksArray<TData, TErrorData, Partial<InferPluginOptions<TPluginArray>>> & Middlewares & Partial<InferPluginOptions<TPluginArray>> & ResultModeOption<TErrorData, TResultMode> & RetryOptions<TErrorData> & ThrowOnErrorOption<TErrorData, TThrowOnError> & URLOptions & {
+type SharedExtraOptions<TData$1 = DefaultDataType, TErrorData$1 = DefaultDataType, TResultMode extends ResultModeUnion = ResultModeUnion, TThrowOnError extends ThrowOnErrorUnion = DefaultThrowOnError, TResponseType extends ResponseTypeUnion = ResponseTypeUnion, TPluginArray extends CallApiPlugin[] = DefaultPluginArray> = DedupeOptions & HookConfigOptions & HooksOrHooksArray<TData$1, TErrorData$1, Partial<InferPluginOptions<TPluginArray>>> & Middlewares & Partial<InferPluginOptions<TPluginArray>> & ResultModeOption<TErrorData$1, TResultMode> & RetryOptions<TErrorData$1> & ThrowOnErrorOption<TErrorData$1, TThrowOnError> & URLOptions & {
   /**
    * Automatically add an Authorization header value.
    *
@@ -1322,7 +1408,7 @@ type SharedExtraOptions<TData = DefaultDataType, TErrorData = DefaultDataType, T
    * }
    * ```
    */
-  defaultHTTPErrorMessage?: string | ((context: Pick<HTTPError<TErrorData>, "errorData" | "response">) => string);
+  defaultHTTPErrorMessage?: string | ((context: Pick<HTTPError<TErrorData$1>, "errorData" | "response">) => string);
   /**
    * Forces calculation of total byte size from request/response body streams.
    *
@@ -1413,7 +1499,7 @@ type SharedExtraOptions<TData = DefaultDataType, TErrorData = DefaultDataType, T
    *
    * ```
    */
-  responseParser?: (responseString: string) => Awaitable<TData>;
+  responseParser?: (responseString: string) => Awaitable<TData$1>;
   /**
    * Expected response type, determines how the response body is parsed.
    *
@@ -1548,7 +1634,7 @@ type SharedExtraOptions<TData = DefaultDataType, TErrorData = DefaultDataType, T
    * }
    * ```
    */
-  throwOnError?: ThrowOnErrorType<TErrorData, TThrowOnError>;
+  throwOnError?: ThrowOnErrorType<TErrorData$1, TThrowOnError>;
   /**
    * Request timeout in milliseconds. Request will be aborted if it takes longer.
    *
@@ -1674,9 +1760,9 @@ type BaseCallApiExtraOptions<TBaseData = DefaultDataType, TBaseErrorData = Defau
    */
   skipAutoMergeFor?: "all" | "options" | "request";
 };
-type InferExtendSchemaContext<TBaseSchemaRoutes extends BaseCallApiSchemaRoutes, TCurrentRouteSchemaKey extends string> = {
-  baseSchemaRoutes: TBaseSchemaRoutes;
-  currentRouteSchema: GetCurrentRouteSchema<TBaseSchemaRoutes, TCurrentRouteSchemaKey>;
+type InferExtendSchemaContext<TBaseSchemaRoutes$1 extends BaseCallApiSchemaRoutes, TCurrentRouteSchemaKey extends string> = {
+  baseSchemaRoutes: TBaseSchemaRoutes$1;
+  currentRouteSchema: GetCurrentRouteSchema<TBaseSchemaRoutes$1, TCurrentRouteSchemaKey>;
 };
 type InferExtendSchemaConfigContext<TBaseSchemaConfig extends CallApiSchemaConfig> = {
   baseSchemaConfig: TBaseSchemaConfig;
@@ -1684,7 +1770,7 @@ type InferExtendSchemaConfigContext<TBaseSchemaConfig extends CallApiSchemaConfi
 type InferExtendPluginContext<TBasePluginArray extends CallApiPlugin[]> = {
   basePlugins: TBasePluginArray;
 };
-type CallApiExtraOptions<TData = DefaultDataType, TErrorData = DefaultDataType, TResultMode extends ResultModeUnion = ResultModeUnion, TThrowOnError extends ThrowOnErrorUnion = DefaultThrowOnError, TResponseType extends ResponseTypeUnion = ResponseTypeUnion, TBasePluginArray extends CallApiPlugin[] = DefaultPluginArray, TPluginArray extends CallApiPlugin[] = DefaultPluginArray, TBaseSchemaRoutes extends BaseCallApiSchemaRoutes = BaseCallApiSchemaRoutes, TSchema$1 extends CallApiSchema = CallApiSchema, TBaseSchemaConfig extends CallApiSchemaConfig = CallApiSchemaConfig, TSchemaConfig extends CallApiSchemaConfig = CallApiSchemaConfig, TCurrentRouteSchemaKey extends string = string, TComputedPluginContext = InferExtendPluginContext<TBasePluginArray>, TComputedSchemaContext = InferExtendSchemaContext<TBaseSchemaRoutes, TCurrentRouteSchemaKey>, TComputedSchemaConfigContext = InferExtendSchemaConfigContext<TBaseSchemaConfig>> = SharedExtraOptions<TData, TErrorData, TResultMode, TThrowOnError, TResponseType, TPluginArray> & {
+type CallApiExtraOptions<TData$1 = DefaultDataType, TErrorData$1 = DefaultDataType, TResultMode extends ResultModeUnion = ResultModeUnion, TThrowOnError extends ThrowOnErrorUnion = DefaultThrowOnError, TResponseType extends ResponseTypeUnion = ResponseTypeUnion, TBasePluginArray extends CallApiPlugin[] = DefaultPluginArray, TPluginArray extends CallApiPlugin[] = DefaultPluginArray, TBaseSchemaRoutes$1 extends BaseCallApiSchemaRoutes = BaseCallApiSchemaRoutes, TSchema$1 extends CallApiSchema = CallApiSchema, TBaseSchemaConfig extends CallApiSchemaConfig = CallApiSchemaConfig, TSchemaConfig$1 extends CallApiSchemaConfig = CallApiSchemaConfig, TCurrentRouteSchemaKey extends string = string, TComputedPluginContext = InferExtendPluginContext<TBasePluginArray>, TComputedSchemaContext = InferExtendSchemaContext<TBaseSchemaRoutes$1, TCurrentRouteSchemaKey>, TComputedSchemaConfigContext = InferExtendSchemaConfigContext<TBaseSchemaConfig>> = SharedExtraOptions<TData$1, TErrorData$1, TResultMode, TThrowOnError, TResponseType, TPluginArray> & {
   /**
    * Array of instance-specific CallApi plugins or a function to configure plugins.
    *
@@ -1710,9 +1796,16 @@ type CallApiExtraOptions<TData = DefaultDataType, TErrorData = DefaultDataType,
    * Can override base schema configuration or extend it with instance-specific validation rules.
    *
    */
-  schemaConfig?: TSchemaConfig | ((context: TComputedSchemaConfigContext) => TSchemaConfig);
+  schemaConfig?: TSchemaConfig$1 | ((context: TComputedSchemaConfigContext) => TSchemaConfig$1);
 };
 type CallApiExtraOptionsForHooks = Hooks & Omit<CallApiExtraOptions, keyof Hooks>;
+type BaseInstanceContext = {
+  initURL: string;
+  options: CallApiExtraOptions;
+  request: CallApiRequestOptions;
+};
+type BaseCallApiConfig<TBaseData = DefaultDataType, TBaseErrorData = DefaultDataType, TBaseResultMode extends ResultModeUnion = ResultModeUnion, TBaseThrowOnError extends ThrowOnErrorUnion = DefaultThrowOnError, TBaseResponseType extends ResponseTypeUnion = ResponseTypeUnion, TBaseSchemaAndConfig extends BaseCallApiSchemaAndConfig = BaseCallApiSchemaAndConfig, TBasePluginArray extends CallApiPlugin[] = DefaultPluginArray, TComputedBaseConfig = BaseCallApiExtraOptions<TBaseData, TBaseErrorData, TBaseResultMode, TBaseThrowOnError, TBaseResponseType, TBasePluginArray, TBaseSchemaAndConfig>> = (CallApiRequestOptions & TComputedBaseConfig) | ((context: BaseInstanceContext) => CallApiRequestOptions & TComputedBaseConfig);
+type CallApiConfig<TData$1 = DefaultDataType, TErrorData$1 = DefaultDataType, TResultMode extends ResultModeUnion = ResultModeUnion, TThrowOnError extends ThrowOnErrorUnion = DefaultThrowOnError, TResponseType extends ResponseTypeUnion = ResponseTypeUnion, TBaseSchemaRoutes$1 extends BaseCallApiSchemaRoutes = BaseCallApiSchemaRoutes, TSchema$1 extends CallApiSchema = CallApiSchema, TBaseSchemaConfig extends CallApiSchemaConfig = CallApiSchemaConfig, TSchemaConfig$1 extends CallApiSchemaConfig = CallApiSchemaConfig, TInitURL extends InitURLOrURLObject = InitURLOrURLObject, TCurrentRouteSchemaKey extends string = string, TBasePluginArray extends CallApiPlugin[] = DefaultPluginArray, TPluginArray extends CallApiPlugin[] = DefaultPluginArray> = InferExtraOptions<TSchema$1, TBaseSchemaRoutes$1, TCurrentRouteSchemaKey> & InferRequestOptions<TSchema$1, TInitURL> & Omit<CallApiExtraOptions<TData$1, TErrorData$1, TResultMode, TThrowOnError, TResponseType, TBasePluginArray, TPluginArray, TBaseSchemaRoutes$1, TSchema$1, TBaseSchemaConfig, TSchemaConfig$1, TCurrentRouteSchemaKey>, keyof InferExtraOptions<CallApiSchema, BaseCallApiSchemaRoutes, string>> & Omit<CallApiRequestOptions, keyof InferRequestOptions<CallApiSchema, string>>;
 //#endregion
 //#region src/logger/logger.d.ts
 type ConsoleLikeObject = {
@@ -1762,7 +1855,7 @@ declare const loggerPlugin: (options?: LoggerOptions) => {
         errorData: never;
         message: string;
         name: "HTTPError";
-        originalError: HTTPError;
+        originalError: _zayne_labs_callapi_utils0.HTTPError;
       };
       response: Response;
     } & PluginExtraOptions<unknown>) => void;
@@ -1774,7 +1867,7 @@ declare const loggerPlugin: (options?: LoggerOptions) => {
         errorData: never;
         message: string;
         name: "HTTPError";
-        originalError: HTTPError;
+        originalError: _zayne_labs_callapi_utils0.HTTPError;
       };
       response: Response;
     })) & {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zayne-labs/callapi-plugins",
   "type": "module",
-  "version": "4.0.10",
+  "version": "4.0.11",
   "description": "A collection of plugins for callapi",
   "author": "Ryan Zayne",
   "license": "MIT",
@@ -21,7 +21,7 @@
   "peerDependencies": {
     "@zayne-labs/toolkit-type-helpers": ">=0.11.17",
     "consola": "3.x.x",
-    "@zayne-labs/callapi": "1.11.10"
+    "@zayne-labs/callapi": "1.11.11"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "0.18.2",
@@ -38,7 +38,7 @@
     "tsdown": "^0.15.9",
     "typescript": "5.9.3",
     "vitest": "^4.0.1",
-    "@zayne-labs/callapi": "1.11.10"
+    "@zayne-labs/callapi": "1.11.11"
   },
   "publishConfig": {
     "access": "public",