@zayne-labs/callapi-plugins 4.0.23 → 4.0.25

package/dist/index.d.ts

@@ -10,7 +10,7 @@ declare const fallBackRouteSchemaKey = "@default";
 type FallBackRouteSchemaKey = typeof fallBackRouteSchemaKey;
 //#endregion
 //#endregion
-//#region ../callapi/dist/common-BKNanXjv.d.ts
+//#region ../callapi/dist/validation-BXtphXvQ.d.ts
 //#region src/types/type-helpers.d.ts
 type AnyString = string & NonNullable<unknown>;
 type AnyNumber = number & NonNullable<unknown>;
@@ -31,6 +31,7 @@ type UnmaskType<TValue$1> = {
 }["_"];
 type RemovePrefix<TPrefix extends "dedupe" | "retry", TKey extends string> = TKey extends `${TPrefix}${infer TRest}` ? Uncapitalize<TRest> : TKey;
 type Awaitable<TValue$1> = Promise<TValue$1> | TValue$1;
+type DistributiveOmit<TObject, TKeysToOmit extends keyof TObject> = TObject extends unknown ? Omit<TObject, TKeysToOmit> : never;
 type CommonRequestHeaders = "Access-Control-Allow-Credentials" | "Access-Control-Allow-Headers" | "Access-Control-Allow-Methods" | "Access-Control-Allow-Origin" | "Access-Control-Expose-Headers" | "Access-Control-Max-Age" | "Age" | "Allow" | "Cache-Control" | "Clear-Site-Data" | "Content-Disposition" | "Content-Encoding" | "Content-Language" | "Content-Length" | "Content-Location" | "Content-Range" | "Content-Security-Policy-Report-Only" | "Content-Security-Policy" | "Cookie" | "Cross-Origin-Embedder-Policy" | "Cross-Origin-Opener-Policy" | "Cross-Origin-Resource-Policy" | "Date" | "ETag" | "Expires" | "Last-Modified" | "Location" | "Permissions-Policy" | "Pragma" | "Retry-After" | "Save-Data" | "Sec-CH-Prefers-Color-Scheme" | "Sec-CH-Prefers-Reduced-Motion" | "Sec-CH-UA-Arch" | "Sec-CH-UA-Bitness" | "Sec-CH-UA-Form-Factor" | "Sec-CH-UA-Full-Version-List" | "Sec-CH-UA-Full-Version" | "Sec-CH-UA-Mobile" | "Sec-CH-UA-Model" | "Sec-CH-UA-Platform-Version" | "Sec-CH-UA-Platform" | "Sec-CH-UA-WoW64" | "Sec-CH-UA" | "Sec-Fetch-Dest" | "Sec-Fetch-Mode" | "Sec-Fetch-Site" | "Sec-Fetch-User" | "Sec-GPC" | "Server-Timing" | "Server" | "Service-Worker-Navigation-Preload" | "Set-Cookie" | "Strict-Transport-Security" | "Timing-Allow-Origin" | "Trailer" | "Transfer-Encoding" | "Upgrade" | "Vary" | "Warning" | "WWW-Authenticate" | "X-Content-Type-Options" | "X-DNS-Prefetch-Control" | "X-Frame-Options" | "X-Permitted-Cross-Domain-Policies" | "X-Powered-By" | "X-Robots-Tag" | "X-XSS-Protection" | AnyString;
 type CommonAuthorizationHeaders = `${"Basic" | "Bearer" | "Token"} ${string}`;
 type CommonContentTypes = "application/epub+zip" | "application/gzip" | "application/json" | "application/ld+json" | "application/octet-stream" | "application/ogg" | "application/pdf" | "application/rtf" | "application/vnd.ms-fontobject" | "application/wasm" | "application/xhtml+xml" | "application/xml" | "application/zip" | "audio/aac" | "audio/mpeg" | "audio/ogg" | "audio/opus" | "audio/webm" | "audio/x-midi" | "font/otf" | "font/ttf" | "font/woff" | "font/woff2" | "image/avif" | "image/bmp" | "image/gif" | "image/jpeg" | "image/png" | "image/svg+xml" | "image/tiff" | "image/webp" | "image/x-icon" | "model/gltf-binary" | "model/gltf+json" | "text/calendar" | "text/css" | "text/csv" | "text/html" | "text/javascript" | "text/plain" | "video/3gpp" | "video/3gpp2" | "video/av1" | "video/mp2t" | "video/mp4" | "video/mpeg" | "video/ogg" | "video/webm" | "video/x-msvideo" | AnyString;
@@ -182,210 +183,6 @@ declare namespace StandardSchemaV1 {
   type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["output"];
 }
 //#endregion
-//#region src/url.d.ts
-type AllowedQueryParamValues = UnmaskType<boolean | number | string>;
-type RecordStyleParams = UnmaskType<Record<string, AllowedQueryParamValues>>;
-type TupleStyleParams = UnmaskType<AllowedQueryParamValues[]>;
-type Params = UnmaskType<RecordStyleParams | TupleStyleParams>;
-type Query = UnmaskType<Record<string, AllowedQueryParamValues>>;
-type InitURLOrURLObject = AnyString | RouteKeyMethodsURLUnion | URL;
-interface URLOptions {
-  /**
-   * Base URL for all API requests. Will only be prepended to relative URLs.
-   *
-   * Absolute URLs (starting with http/https) will not be prepended by the baseURL.
-   *
-   * @example
-   * ```ts
-   * // Set base URL for all requests
-   * baseURL: "https://api.example.com/v1"
-   *
-   * // Then use relative URLs in requests
-   * callApi("/users") // → https://api.example.com/v1/users
-   * callApi("/posts/123") // → https://api.example.com/v1/posts/123
-   *
-   * // Environment-specific base URLs
-   * baseURL: process.env.NODE_ENV === "production"
-   *   ? "https://api.example.com"
-   *   : "http://localhost:3000/api"
-   * ```
-   */
-  baseURL?: string;
-  /**
-   * Resolved request URL after processing baseURL, parameters, and query strings (readonly)
-   *
-   * This is the final URL that will be used for the HTTP request, computed from
-   * baseURL, initURL, params, and query parameters.
-   *
-   */
-  readonly fullURL?: string;
-  /**
-   * The original URL string passed to the callApi instance (readonly)
-   *
-   * This preserves the original URL as provided, including any method modifiers like "@get/" or "@post/".
-   *
-   */
-  readonly initURL?: string;
-  /**
-   * The URL string after normalization, with method modifiers removed(readonly)
-   *
-   * Method modifiers like "@get/", "@post/" are stripped to create a clean URL
-   * for parameter substitution and final URL construction.
-   *
-   */
-  readonly initURLNormalized?: string;
-  /**
-   * Parameters to be substituted into URL path segments.
-   *
-   * Supports both object-style (named parameters) and array-style (positional parameters)
-   * for flexible URL parameter substitution.
-   *
-   * @example
-   * ```typescript
-   * // Object-style parameters (recommended)
-   * const namedParams: URLOptions = {
-   *   initURL: "/users/:userId/posts/:postId",
-   *   params: { userId: "123", postId: "456" }
-   * };
-   * // Results in: /users/123/posts/456
-   *
-   * // Array-style parameters (positional)
-   * const positionalParams: URLOptions = {
-   *   initURL: "/users/:userId/posts/:postId",
-   *   params: ["123", "456"]  // Maps in order: userId=123, postId=456
-   * };
-   * // Results in: /users/123/posts/456
-   *
-   * // Single parameter
-   * const singleParam: URLOptions = {
-   *   initURL: "/users/:id",
-   *   params: { id: "user-123" }
-   * };
-   * // Results in: /users/user-123
-   * ```
-   */
-  params?: Params;
-  /**
-   * Query parameters to append to the URL as search parameters.
-   *
-   * These will be serialized into the URL query string using standard
-   * URL encoding practices.
-   *
-   * @example
-   * ```typescript
-   * // Basic query parameters
-   * const queryOptions: URLOptions = {
-   *   initURL: "/users",
-   *   query: {
-   *     page: 1,
-   *     limit: 10,
-   *     search: "john doe",
-   *     active: true
-   *   }
-   * };
-   * // Results in: /users?page=1&limit=10&search=john%20doe&active=true
-   *
-   * // Filtering and sorting
-   * const filterOptions: URLOptions = {
-   *   initURL: "/products",
-   *   query: {
-   *     category: "electronics",
-   *     minPrice: 100,
-   *     maxPrice: 500,
-   *     sortBy: "price",
-   *     order: "asc"
-   *   }
-   * };
-   * // Results in: /products?category=electronics&minPrice=100&maxPrice=500&sortBy=price&order=asc
-   * ```
-   */
-  query?: Query;
-}
-//#endregion
-//#region src/validation.d.ts
-type ResultVariant = "infer-input" | "infer-output";
-type InferSchemaResult<TSchema$1, TFallbackResult, TResultVariant extends ResultVariant> = undefined extends TSchema$1 ? TFallbackResult : TSchema$1 extends StandardSchemaV1 ? TResultVariant extends "infer-input" ? StandardSchemaV1.InferInput<TSchema$1> : StandardSchemaV1.InferOutput<TSchema$1> : TSchema$1 extends AnyFunction$1<infer TResult> ? Awaited<TResult> : TFallbackResult;
-type InferSchemaOutput<TSchema$1, TFallbackResult = unknown> = InferSchemaResult<TSchema$1, TFallbackResult, "infer-output">;
-interface CallApiSchemaConfig {
-  /**
-   * The base url of the schema. By default it's the baseURL of the callApi instance.
-   */
-  baseURL?: string;
-  /**
-   * Disables runtime validation for the schema.
-   */
-  disableRuntimeValidation?: boolean;
-  /**
-   * If `true`, the original input value will be used instead of the transformed/validated output.
-   *
-   * This is useful when you want to validate the input but don't want any transformations
-   * applied by the validation schema (e.g., type coercion, default values, etc).
-   */
-  disableValidationOutputApplication?: boolean;
-  /**
-   * Optional url prefix that will be substituted for the `baseURL` of the schemaConfig at runtime.
-   *
-   * This allows you to reuse the same schema against different base URLs (for example,
-   * swapping between `/api/v1` and `/api/v2`) without redefining the entire schema.
-   */
-  prefix?: string;
-  /**
-   * Controls the strictness of API route validation.
-   *
-   * When true:
-   * - Only routes explicitly defined in the schema will be considered valid to typescript and the runtime.
-   * - Attempting to call routes not defined in the schema will result in both type errors and runtime validation errors.
-   * - Useful for ensuring API calls conform exactly to your schema definition
-   *
-   * When false or undefined (default):
-   * - All routes will be allowed, whether they are defined in the schema or not
-   */
-  strict?: boolean;
-}
-interface CallApiSchema {
-  /**
-   *  The schema to use for validating the request body.
-   */
-  body?: StandardSchemaV1<Body | undefined> | ((body: Body) => Awaitable<Body | undefined>);
-  /**
-   *  The schema to use for validating the response data.
-   */
-  data?: StandardSchemaV1 | ((data: unknown) => unknown);
-  /**
-   *  The schema to use for validating the response error data.
-   */
-  errorData?: StandardSchemaV1 | ((errorData: unknown) => unknown);
-  /**
-   *  The schema to use for validating the request headers.
-   */
-  headers?: StandardSchemaV1<HeadersOption | undefined> | ((headers: HeadersOption) => Awaitable<HeadersOption | undefined>);
-  /**
-   *  The schema to use for validating the meta option.
-   */
-  meta?: StandardSchemaV1<GlobalMeta | undefined> | ((meta: GlobalMeta) => Awaitable<GlobalMeta | undefined>);
-  /**
-   *  The schema to use for validating the request method.
-   */
-  method?: StandardSchemaV1<MethodUnion | undefined> | ((method: MethodUnion) => Awaitable<MethodUnion | undefined>);
-  /**
-   *  The schema to use for validating the request url parameters.
-   */
-  params?: StandardSchemaV1<Params | undefined> | ((params: Params) => Awaitable<Params | undefined>);
-  /**
-   *  The schema to use for validating the request url queries.
-   */
-  query?: StandardSchemaV1<Query | undefined> | ((query: Query) => Awaitable<Query | undefined>);
-}
-declare const routeKeyMethods: readonly ["delete", "get", "patch", "post", "put"];
-type RouteKeyMethods = (typeof routeKeyMethods)[number];
-type RouteKeyMethodsURLUnion = `@${RouteKeyMethods}/`;
-type BaseSchemaRouteKeyPrefixes = FallBackRouteSchemaKey | RouteKeyMethodsURLUnion;
-type BaseCallApiSchemaRoutes = Partial<Record<AnyString | BaseSchemaRouteKeyPrefixes, CallApiSchema>>;
-type BaseCallApiSchemaAndConfig = {
-  config?: CallApiSchemaConfig;
-  routes: BaseCallApiSchemaRoutes;
-};
-//#endregion
 //#region src/utils/external/error.d.ts
 type HTTPErrorDetails<TErrorData$1> = Pick<CallApiExtraOptions, "defaultHTTPErrorMessage"> & {
   errorData: TErrorData$1;
@@ -457,10 +254,6 @@ type CallApiResultSuccessVariant<TData$1> = {
   error: null;
   response: Response;
 };
-type CallApiResultSuccessVariantWithoutResponse<TData$1> = {
-  data: NoInfer<TData$1>;
-  error: null;
-};
 type PossibleJavaScriptError = UnmaskType<{
   errorData: false;
   message: string;
@@ -490,26 +283,18 @@ type CallApiResultErrorVariant<TErrorData$1> = {
   error: PossibleJavaScriptOrValidationError;
   response: Response | null;
 };
-type CallApiResultErrorVariantWithoutResponse<TErrorData$1> = {
-  data: null;
-  error: PossibleHTTPError<TErrorData$1>;
-} | {
-  data: null;
-  error: PossibleJavaScriptOrValidationError;
-};
 type CallApiSuccessOrErrorVariant<TData$1, TError> = CallApiResultErrorVariant<TError> | CallApiResultSuccessVariant<TData$1>;
-type CallApiSuccessOrErrorVariantWithoutResponse<TData$1, TErrorData$1> = CallApiResultErrorVariantWithoutResponse<TErrorData$1> | CallApiResultSuccessVariantWithoutResponse<TData$1>;
 type ResultModeMapWithoutException<TData$1, TErrorData$1, TResponseType extends ResponseTypeType, 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"];
-  withoutResponse: CallApiSuccessOrErrorVariantWithoutResponse<TComputedData, TComputedErrorData>;
+  withoutResponse: DistributiveOmit<TComputedResult, "response">;
 }>;
 type ResultModeMapWithException<TData$1, TResponseType extends ResponseTypeType, TComputedData = GetResponseType<TData$1, TResponseType>, TComputedResult extends CallApiResultSuccessVariant<TComputedData> = CallApiResultSuccessVariant<TComputedData>> = {
   all: TComputedResult;
   onlyData: TComputedResult["data"];
   onlyResponse: TComputedResult["response"];
-  withoutResponse: CallApiResultSuccessVariantWithoutResponse<TComputedData>;
+  withoutResponse: DistributiveOmit<TComputedResult, "response">;
 };
 type ResultModeMap<TData$1 = DefaultDataType, TErrorData$1 = DefaultDataType, TResponseType extends ResponseTypeType = ResponseTypeType, TThrowOnError extends ThrowOnErrorUnion = DefaultThrowOnError> = TThrowOnError extends true ? ResultModeMapWithException<TData$1, TResponseType> : ResultModeMapWithoutException<TData$1, TErrorData$1, TResponseType>;
 type ResultModePlaceholder = null;
@@ -555,6 +340,126 @@ interface Middlewares {
   }) => FetchImpl;
 }
 //#endregion
+//#region src/url.d.ts
+type AllowedQueryParamValues = UnmaskType<boolean | number | string>;
+type RecordStyleParams = UnmaskType<Record<string, AllowedQueryParamValues>>;
+type TupleStyleParams = UnmaskType<AllowedQueryParamValues[]>;
+type Params = UnmaskType<RecordStyleParams | TupleStyleParams>;
+type Query = UnmaskType<Record<string, AllowedQueryParamValues>>;
+type InitURLOrURLObject = AnyString | RouteKeyMethodsURLUnion | URL;
+interface URLOptions {
+  /**
+   * Base URL for all API requests. Will only be prepended to relative URLs.
+   *
+   * Absolute URLs (starting with http/https) will not be prepended by the baseURL.
+   *
+   * @example
+   * ```ts
+   * // Set base URL for all requests
+   * baseURL: "https://api.example.com/v1"
+   *
+   * // Then use relative URLs in requests
+   * callApi("/users") // → https://api.example.com/v1/users
+   * callApi("/posts/123") // → https://api.example.com/v1/posts/123
+   *
+   * // Environment-specific base URLs
+   * baseURL: process.env.NODE_ENV === "production"
+   *   ? "https://api.example.com"
+   *   : "http://localhost:3000/api"
+   * ```
+   */
+  baseURL?: string;
+  /**
+   * Resolved request URL after processing baseURL, parameters, and query strings (readonly)
+   *
+   * This is the final URL that will be used for the HTTP request, computed from
+   * baseURL, initURL, params, and query parameters.
+   *
+   */
+  readonly fullURL?: string;
+  /**
+   * The original URL string passed to the callApi instance (readonly)
+   *
+   * This preserves the original URL as provided, including any method modifiers like "@get/" or "@post/".
+   *
+   */
+  readonly initURL?: string;
+  /**
+   * The URL string after normalization, with method modifiers removed(readonly)
+   *
+   * Method modifiers like "@get/", "@post/" are stripped to create a clean URL
+   * for parameter substitution and final URL construction.
+   *
+   */
+  readonly initURLNormalized?: string;
+  /**
+   * Parameters to be substituted into URL path segments.
+   *
+   * Supports both object-style (named parameters) and array-style (positional parameters)
+   * for flexible URL parameter substitution.
+   *
+   * @example
+   * ```typescript
+   * // Object-style parameters (recommended)
+   * const namedParams: URLOptions = {
+   *   initURL: "/users/:userId/posts/:postId",
+   *   params: { userId: "123", postId: "456" }
+   * };
+   * // Results in: /users/123/posts/456
+   *
+   * // Array-style parameters (positional)
+   * const positionalParams: URLOptions = {
+   *   initURL: "/users/:userId/posts/:postId",
+   *   params: ["123", "456"]  // Maps in order: userId=123, postId=456
+   * };
+   * // Results in: /users/123/posts/456
+   *
+   * // Single parameter
+   * const singleParam: URLOptions = {
+   *   initURL: "/users/:id",
+   *   params: { id: "user-123" }
+   * };
+   * // Results in: /users/user-123
+   * ```
+   */
+  params?: Params;
+  /**
+   * Query parameters to append to the URL as search parameters.
+   *
+   * These will be serialized into the URL query string using standard
+   * URL encoding practices.
+   *
+   * @example
+   * ```typescript
+   * // Basic query parameters
+   * const queryOptions: URLOptions = {
+   *   initURL: "/users",
+   *   query: {
+   *     page: 1,
+   *     limit: 10,
+   *     search: "john doe",
+   *     active: true
+   *   }
+   * };
+   * // Results in: /users?page=1&limit=10&search=john%20doe&active=true
+   *
+   * // Filtering and sorting
+   * const filterOptions: URLOptions = {
+   *   initURL: "/products",
+   *   query: {
+   *     category: "electronics",
+   *     minPrice: 100,
+   *     maxPrice: 500,
+   *     sortBy: "price",
+   *     order: "asc"
+   *   }
+   * };
+   * // Results in: /products?category=electronics&minPrice=100&maxPrice=500&sortBy=price&order=asc
+   * ```
+   */
+  query?: Query;
+}
+//#endregion
 //#region src/plugins.d.ts
 type PluginSetupContext<TPluginExtraOptions = unknown> = RequestContext & PluginExtraOptions<TPluginExtraOptions> & {
   initURL: string;
@@ -1220,7 +1125,7 @@ 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"], {
+type InferMetaOption<TSchema$1 extends CallApiSchema, TCallApiEnv extends CallApiEnv> = MakeSchemaOptionRequiredIfDefined<TSchema$1["meta"], {
   /**
    * - An optional field you can fill with additional information,
    * to associate with the request, typically used for logging or tracing.
@@ -1244,7 +1149,7 @@ type InferMetaOption<TSchema$1 extends CallApiSchema> = MakeSchemaOptionRequired
    * });
    * ```
    */
-  meta?: InferSchemaOutput<TSchema$1["meta"], GlobalMeta>;
+  meta?: InferSchemaOutput<TSchema$1["meta"], TCallApiEnv["Meta"]>;
 }>;
 type InferQueryOption<TSchema$1 extends CallApiSchema> = MakeSchemaOptionRequiredIfDefined<TSchema$1["query"], {
   /**
@@ -1267,7 +1172,7 @@ type InferParamsOption<TSchema$1 extends CallApiSchema, TBaseSchemaRoutes$1 exte
    */
   params?: InferSchemaOutput<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 InferExtraOptions<TSchema$1 extends CallApiSchema, TBaseSchemaRoutes$1 extends BaseCallApiSchemaRoutes, TCurrentRouteSchemaKey extends string, TCallApiEnv extends CallApiEnv> = InferMetaOption<TSchema$1, TCallApiEnv> & 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> ? InferSchemaOutput<TReturnedSchema> : never : never : never>;
 type ResultModeOption<TErrorData$1, TResultMode extends ResultModeType> = TErrorData$1 extends false ? {
   resultMode: "onlyData";
@@ -1287,6 +1192,10 @@ type ThrowOnErrorOption<TErrorData$1, TThrowOnError extends ThrowOnErrorUnion> =
 };
 //#endregion
 //#region src/types/common.d.ts
+
+type CallApiEnv = {
+  Meta?: GlobalMeta;
+};
 type FetchSpecificKeysUnion = Exclude<(typeof fetchSpecificKeys)[number], "body" | "headers" | "method">;
 type ModifiedRequestInit = RequestInit & {
   duplex?: "half";
@@ -1309,7 +1218,7 @@ type CallApiRequestOptions = Prettify<{
 type CallApiRequestOptionsForHooks = Omit<CallApiRequestOptions, "headers"> & {
   headers: Record<string, string | undefined>;
 };
-type SharedExtraOptions<TData$1 = DefaultDataType, TErrorData$1 = DefaultDataType, TResultMode extends ResultModeType = ResultModeType, TThrowOnError extends ThrowOnErrorUnion = DefaultThrowOnError, TResponseType extends ResponseTypeType = ResponseTypeType, 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 & {
+type SharedExtraOptions<TData$1 = DefaultDataType, TErrorData$1 = DefaultDataType, TResultMode extends ResultModeType = ResultModeType, TCallApiEnv extends CallApiEnv = CallApiEnv, TThrowOnError extends ThrowOnErrorUnion = DefaultThrowOnError, TResponseType extends ResponseTypeType = ResponseTypeType, 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.
    *
@@ -1487,7 +1396,7 @@ type SharedExtraOptions<TData$1 = DefaultDataType, TErrorData$1 = DefaultDataTyp
    * });
    * ```
    */
-  meta?: GlobalMeta;
+  meta?: TCallApiEnv["Meta"];
   /**
    * Custom function to parse response strings into actual value instead of the default response.json().
    *
@@ -1683,7 +1592,7 @@ type SharedExtraOptions<TData$1 = DefaultDataType, TErrorData$1 = DefaultDataTyp
    */
   timeout?: number;
 };
-type BaseCallApiExtraOptions<TBaseData = DefaultDataType, TBaseErrorData = DefaultDataType, TBaseResultMode extends ResultModeType = ResultModeType, TBaseThrowOnError extends ThrowOnErrorUnion = DefaultThrowOnError, TBaseResponseType extends ResponseTypeType = ResponseTypeType, TBasePluginArray extends CallApiPlugin[] = DefaultPluginArray, TBaseSchemaAndConfig extends BaseCallApiSchemaAndConfig = BaseCallApiSchemaAndConfig> = SharedExtraOptions<TBaseData, TBaseErrorData, TBaseResultMode, TBaseThrowOnError, TBaseResponseType, TBasePluginArray> & {
+type BaseCallApiExtraOptions<TBaseData = DefaultDataType, TBaseErrorData = DefaultDataType, TBaseResultMode extends ResultModeType = ResultModeType, TBaseCallApiEnv extends CallApiEnv = CallApiEnv, TBaseThrowOnError extends ThrowOnErrorUnion = DefaultThrowOnError, TBaseResponseType extends ResponseTypeType = ResponseTypeType, TBasePluginArray extends CallApiPlugin[] = DefaultPluginArray, TBaseSchemaAndConfig extends BaseCallApiSchemaAndConfig = BaseCallApiSchemaAndConfig> = SharedExtraOptions<TBaseData, TBaseErrorData, TBaseResultMode, TBaseCallApiEnv, TBaseThrowOnError, TBaseResponseType, TBasePluginArray> & {
   /**
    * Array of base CallApi plugins to extend library functionality.
    *
@@ -1793,7 +1702,7 @@ type InferExtendSchemaConfigContext<TBaseSchemaConfig extends CallApiSchemaConfi
 type InferExtendPluginContext<TBasePluginArray extends CallApiPlugin[]> = {
   basePlugins: TBasePluginArray;
 };
-type CallApiExtraOptions<TData$1 = DefaultDataType, TErrorData$1 = DefaultDataType, TResultMode extends ResultModeType = ResultModeType, TThrowOnError extends ThrowOnErrorUnion = DefaultThrowOnError, TResponseType extends ResponseTypeType = ResponseTypeType, 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> & {
+type CallApiExtraOptions<TData$1 = DefaultDataType, TErrorData$1 = DefaultDataType, TResultMode extends ResultModeType = ResultModeType, TCallApiEnv extends CallApiEnv = CallApiEnv, TThrowOnError extends ThrowOnErrorUnion = DefaultThrowOnError, TResponseType extends ResponseTypeType = ResponseTypeType, 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, TCallApiEnv, TThrowOnError, TResponseType, TPluginArray> & {
   /**
    * Array of instance-specific CallApi plugins or a function to configure plugins.
    *
@@ -1827,8 +1736,93 @@ type InstanceContext = {
   options: CallApiExtraOptions;
   request: CallApiRequestOptions;
 };
-type BaseCallApiConfig<TBaseData = DefaultDataType, TBaseErrorData = DefaultDataType, TBaseResultMode extends ResultModeType = ResultModeType, TBaseThrowOnError extends ThrowOnErrorUnion = DefaultThrowOnError, TBaseResponseType extends ResponseTypeType = ResponseTypeType, TBaseSchemaAndConfig extends BaseCallApiSchemaAndConfig = BaseCallApiSchemaAndConfig, TBasePluginArray extends CallApiPlugin[] = DefaultPluginArray, TComputedBaseConfig = BaseCallApiExtraOptions<TBaseData, TBaseErrorData, TBaseResultMode, TBaseThrowOnError, TBaseResponseType, TBasePluginArray, TBaseSchemaAndConfig>> = (CallApiRequestOptions & TComputedBaseConfig) | ((context: InstanceContext) => CallApiRequestOptions & TComputedBaseConfig);
-type CallApiConfig<TData$1 = DefaultDataType, TErrorData$1 = DefaultDataType, TResultMode extends ResultModeType = ResultModeType, TThrowOnError extends ThrowOnErrorUnion = DefaultThrowOnError, TResponseType extends ResponseTypeType = ResponseTypeType, 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>>;
+type BaseCallApiConfig<TBaseData = DefaultDataType, TBaseErrorData = DefaultDataType, TBaseResultMode extends ResultModeType = ResultModeType, TBaseCallApiEnv extends CallApiEnv = CallApiEnv, TBaseThrowOnError extends ThrowOnErrorUnion = DefaultThrowOnError, TBaseResponseType extends ResponseTypeType = ResponseTypeType, TBaseSchemaAndConfig extends BaseCallApiSchemaAndConfig = BaseCallApiSchemaAndConfig, TBasePluginArray extends CallApiPlugin[] = DefaultPluginArray, TComputedBaseConfig = BaseCallApiExtraOptions<TBaseData, TBaseErrorData, TBaseResultMode, TBaseCallApiEnv, TBaseThrowOnError, TBaseResponseType, TBasePluginArray, TBaseSchemaAndConfig>> = (CallApiRequestOptions & TComputedBaseConfig) | ((context: InstanceContext) => CallApiRequestOptions & TComputedBaseConfig);
+type CallApiConfig<TData$1 = DefaultDataType, TErrorData$1 = DefaultDataType, TResultMode extends ResultModeType = ResultModeType, TCallApiEnv extends CallApiEnv = CallApiEnv, TThrowOnError extends ThrowOnErrorUnion = DefaultThrowOnError, TResponseType extends ResponseTypeType = ResponseTypeType, 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, TCallApiEnv> & InferRequestOptions<TSchema$1, TInitURL> & Omit<CallApiExtraOptions<TData$1, TErrorData$1, TResultMode, TCallApiEnv, TThrowOnError, TResponseType, TBasePluginArray, TPluginArray, TBaseSchemaRoutes$1, TSchema$1, TBaseSchemaConfig, TSchemaConfig$1, TCurrentRouteSchemaKey>, keyof InferExtraOptions<CallApiSchema, BaseCallApiSchemaRoutes, string, CallApiEnv>> & Omit<CallApiRequestOptions, keyof InferRequestOptions<CallApiSchema, string>>;
+//#endregion
+//#region src/validation.d.ts
+type ResultVariant = "infer-input" | "infer-output";
+type InferSchemaResult<TSchema$1, TFallbackResult, TResultVariant extends ResultVariant> = undefined extends TSchema$1 ? TFallbackResult : TSchema$1 extends StandardSchemaV1 ? TResultVariant extends "infer-input" ? StandardSchemaV1.InferInput<TSchema$1> : StandardSchemaV1.InferOutput<TSchema$1> : TSchema$1 extends AnyFunction$1<infer TResult> ? Awaited<TResult> : TFallbackResult;
+type InferSchemaOutput<TSchema$1, TFallbackResult = unknown> = InferSchemaResult<TSchema$1, TFallbackResult, "infer-output">;
+interface CallApiSchemaConfig {
+  /**
+   * The base url of the schema. By default it's the baseURL of the callApi instance.
+   */
+  baseURL?: string;
+  /**
+   * Disables runtime validation for the schema.
+   */
+  disableRuntimeValidation?: boolean;
+  /**
+   * If `true`, the original input value will be used instead of the transformed/validated output.
+   *
+   * This is useful when you want to validate the input but don't want any transformations
+   * applied by the validation schema (e.g., type coercion, default values, etc).
+   */
+  disableValidationOutputApplication?: boolean;
+  /**
+   * Optional url prefix that will be substituted for the `baseURL` of the schemaConfig at runtime.
+   *
+   * This allows you to reuse the same schema against different base URLs (for example,
+   * swapping between `/api/v1` and `/api/v2`) without redefining the entire schema.
+   */
+  prefix?: string;
+  /**
+   * Controls the strictness of API route validation.
+   *
+   * When true:
+   * - Only routes explicitly defined in the schema will be considered valid to typescript and the runtime.
+   * - Attempting to call routes not defined in the schema will result in both type errors and runtime validation errors.
+   * - Useful for ensuring API calls conform exactly to your schema definition
+   *
+   * When false or undefined (default):
+   * - All routes will be allowed, whether they are defined in the schema or not
+   */
+  strict?: boolean;
+}
+interface CallApiSchema {
+  /**
+   *  The schema to use for validating the request body.
+   */
+  body?: StandardSchemaV1<Body | undefined> | ((body: Body) => Awaitable<Body | undefined>);
+  /**
+   *  The schema to use for validating the response data.
+   */
+  data?: StandardSchemaV1 | ((data: unknown) => unknown);
+  /**
+   *  The schema to use for validating the response error data.
+   */
+  errorData?: StandardSchemaV1 | ((errorData: unknown) => unknown);
+  /**
+   *  The schema to use for validating the request headers.
+   */
+  headers?: StandardSchemaV1<HeadersOption | undefined> | ((headers: HeadersOption) => Awaitable<HeadersOption | undefined>);
+  /**
+   *  The schema to use for validating the meta option.
+   */
+  meta?: StandardSchemaV1<GlobalMeta | undefined> | ((meta: GlobalMeta) => Awaitable<GlobalMeta | undefined>);
+  /**
+   *  The schema to use for validating the request method.
+   */
+  method?: StandardSchemaV1<MethodUnion | undefined> | ((method: MethodUnion) => Awaitable<MethodUnion | undefined>);
+  /**
+   *  The schema to use for validating the request url parameters.
+   */
+  params?: StandardSchemaV1<Params | undefined> | ((params: Params) => Awaitable<Params | undefined>);
+  /**
+   *  The schema to use for validating the request url queries.
+   */
+  query?: StandardSchemaV1<Query | undefined> | ((query: Query) => Awaitable<Query | undefined>);
+}
+declare const routeKeyMethods: readonly ["delete", "get", "patch", "post", "put"];
+type RouteKeyMethods = (typeof routeKeyMethods)[number];
+type RouteKeyMethodsURLUnion = `@${RouteKeyMethods}/`;
+type BaseSchemaRouteKeyPrefixes = FallBackRouteSchemaKey | RouteKeyMethodsURLUnion;
+type BaseCallApiSchemaRoutes = Partial<Record<AnyString | BaseSchemaRouteKeyPrefixes, CallApiSchema>>;
+type BaseCallApiSchemaAndConfig = {
+  config?: CallApiSchemaConfig;
+  routes: BaseCallApiSchemaRoutes;
+};
+//#endregion
 //#endregion
 //#region src/logger/logger.d.ts
 type ConsoleLikeObject = {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zayne-labs/callapi-plugins",
   "type": "module",
-  "version": "4.0.23",
+  "version": "4.0.25",
   "description": "A collection of plugins for callapi",
   "author": "Ryan Zayne",
   "license": "MIT",
@@ -21,14 +21,14 @@
   "peerDependencies": {
     "@zayne-labs/toolkit-type-helpers": ">=0.11.17",
     "consola": "3.x.x",
-    "@zayne-labs/callapi": "1.11.23"
+    "@zayne-labs/callapi": "1.11.25"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "0.18.2",
     "@size-limit/esbuild-why": "11.2.0",
     "@size-limit/preset-small-lib": "11.2.0",
     "@total-typescript/ts-reset": "0.6.1",
-    "@zayne-labs/toolkit-type-helpers": "^0.12.12",
+    "@zayne-labs/toolkit-type-helpers": "^0.12.14",
     "@zayne-labs/tsconfig": "0.11.5",
     "concurrently": "^9.2.1",
     "consola": "3.4.2",
@@ -37,8 +37,8 @@
     "size-limit": "11.2.0",
     "tsdown": "0.15.9",
     "typescript": "5.9.3",
-    "vitest": "^4.0.8",
-    "@zayne-labs/callapi": "1.11.23"
+    "vitest": "^4.0.14",
+    "@zayne-labs/callapi": "1.11.25"
   },
   "publishConfig": {
     "access": "public",