@zayne-labs/callapi 0.6.0 → 0.7.1

package/dist/cjs/index.d.cts

@@ -1,267 +1,16 @@
-type AnyString = string & {
-    placeholder?: never;
-};
-type AnyNumber = number & {
-    placeholder?: never;
-};
-type Prettify<TObject> = {
-    [Key in keyof TObject]: TObject[Key];
-} & NonNullable<unknown>;
-
-type ToQueryStringFn = {
-    (params: ExtraOptions["query"]): string | null;
-    (params: Required<ExtraOptions>["query"]): string;
-};
-declare const toQueryString: ToQueryStringFn;
-declare const fetchSpecificKeys: ("body" | "method" | "headers" | "cache" | "credentials" | "integrity" | "keepalive" | "mode" | "priority" | "redirect" | "referrer" | "referrerPolicy" | "signal" | "window")[];
-declare const handleResponseType: <TResponse>(response: Response, parser?: Required<ExtraOptions>["responseParser"]) => {
-    json: () => Promise<Record<string, unknown> | TResponse>;
-    arrayBuffer: () => Promise<TResponse>;
-    blob: () => Promise<TResponse>;
-    formData: () => Promise<TResponse>;
-    text: () => Promise<TResponse>;
-};
-declare const isHTTPError: <TErrorData>(error: ApiErrorVariant<TErrorData>["error"] | null) => error is {
-    name: "HTTPError";
-    errorData: TErrorData;
-    message: string;
-};
-type ErrorDetails<TErrorResponse> = {
-    errorData: TErrorResponse;
-    response: Response;
-    defaultErrorMessage: string;
-};
-type ErrorOptions = {
-    cause?: unknown;
-};
-declare class HTTPError<TErrorResponse = Record<string, unknown>> extends Error {
-    response: ErrorDetails<TErrorResponse>["response"];
-    errorData: ErrorDetails<TErrorResponse>["errorData"];
-    name: "HTTPError";
-    isHTTPError: boolean;
-    constructor(errorDetails: ErrorDetails<TErrorResponse>, errorOptions?: ErrorOptions);
-}
-declare const isHTTPErrorInstance: <TErrorResponse>(error: unknown) => error is HTTPError<TErrorResponse>;
-
-interface $RequestOptions extends Pick<FetchConfig, (typeof fetchSpecificKeys)[number]> {
-}
-interface ExtraOptions<TData = unknown, TErrorData = unknown, TResultMode extends ResultModeUnion = ResultModeUnion> {
-    /** Optional body of the request, can be a object or any other supported body type. */
-    body?: Record<string, unknown> | RequestInit["body"];
-    /**
-     * @description HTTP method for the request.
-     * @default "GET"
-     */
-    method?: "GET" | "POST" | "PATCH" | "PUT" | "DELETE" | AnyString;
-    /**
-     * @description Query parameters to append to the URL.
-     */
-    query?: Record<string, string | number | boolean>;
-    /**
-     * @description Authorization header value.
-     */
-    auth?: string | {
-        bearer: string;
-        token?: never;
-    } | {
-        token: string;
-        bearer?: never;
-    };
-    /**
-     * @description Custom function to validate the response data.
-     */
-    responseValidator?: (data: unknown) => TData;
-    /**
-     * @description Custom function to serialize the body object into a string.
-     */
-    bodySerializer?: (bodyData: Record<string, unknown>) => string;
-    /**
-     * @description Custom function to parse the response string into a object.
-     */
-    responseParser?: (responseString: string) => Record<string, unknown>;
-    /**
-     * @description Mode of the result, can influence how results are handled or returned.
-     * Can be set to "all" | "onlySuccess" | "onlyError" | "onlyResponse".
-     * @default "all"
-     */
-    resultMode?: TResultMode;
-    /**
-     * @description If true, cancels previous unfinished requests to the same URL.
-     * @default true
-     */
-    cancelRedundantRequests?: boolean;
-    /**
-     * @description Base URL to be prepended to all request URLs
-     */
-    baseURL?: string;
-    /**
-     * @description Request timeout in milliseconds
-     */
-    timeout?: number;
-    /**
-     * @description Default error message to use if none is provided from a response.
-     * @default "Failed to fetch data from server!"
-     */
-    defaultErrorMessage?: string;
-    /**
-     * @description Whether to clone the response, so response.json and the like can used in the interceptors.
-     * @default false
-     */
-    cloneResponse?: boolean;
-    /**
-     * If true or the function returns true, throws errors instead of returning them
-     * The function is passed the error object and can be used to conditionally throw the error
-     * @default false
-     */
-    throwOnError?: boolean | ((error?: Error | HTTPError<TErrorData>) => boolean);
-    /**
-     * @description Expected response type, affects how response is parsed
-     * @default "json"
-     */
-    responseType?: keyof ReturnType<typeof handleResponseType>;
-    /**
-     * @description Number of retry attempts for failed requests
-     * @default 0
-     */
-    retries?: number;
-    /**
-     * @description Delay between retries in milliseconds
-     * @default 500
-     */
-    retryDelay?: number;
-    /**
-     * @description HTTP status codes that trigger a retry
-     * @default [409, 425, 429, 500, 502, 503, 504]
-     */
-    retryCodes?: Array<409 | 425 | 429 | 500 | 502 | 503 | 504 | AnyNumber>;
-    /**
-     * HTTP methods that are allowed to retry
-     * @default ["GET", "POST"]
-     */
-    retryMethods?: Array<"GET" | "POST" | AnyString>;
-    /**
-     * @description 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?: Record<string, unknown>;
-    /** @description Interceptor to be called just before the request is made, allowing for modifications or additional operations. */
-    onRequest?: (requestContext: {
-        request: $RequestOptions;
-        options: ExtraOptions;
-    }) => void | Promise<void>;
-    /** @description Interceptor to be called when an error occurs during the fetch request. */
-    onRequestError?: (requestErrorContext: {
-        error: Error;
-        request: $RequestOptions;
-        options: ExtraOptions;
-    }) => void | Promise<void>;
-    /** @description Interceptor to be called when a successful response is received from the api. */
-    onResponse?: (responseContext: ResponseContext<TData>) => void | Promise<void>;
-    /** @description Interceptor to be called when an error response is received from the api. */
-    onResponseError?: (responseErrorContext: ResponseErrorContext<TErrorData>) => void | Promise<void>;
-    /**
-     * @description Interceptor to be called when an error occurs during the fetch request OR when an error response is received from the api
-     * It is basically a combination of `onRequestError` and `onResponseError` interceptors
-     */
-    onError?: (anyErrorContext: ErrorContext<TErrorData>) => void | Promise<void>;
-}
-type ResponseContext<TData> = Prettify<{
-    data: TData;
-    response: Response;
-    request: $RequestOptions;
-    options: ExtraOptions;
-}>;
-type ResponseErrorContext<TErrorData> = Prettify<{
-    errorData: TErrorData;
-    response: Response;
-    request: $RequestOptions;
-    options: ExtraOptions;
-}>;
-type ErrorContext<TErrorData> = Prettify<{
-    errorData?: TErrorData;
-    error: null;
-    response: Response;
-    request: $RequestOptions;
-    options: ExtraOptions;
-} | {
-    error: Error;
-    errorData?: null;
-    response: null;
-    request: $RequestOptions;
-    options: ExtraOptions;
-}>;
-interface FetchConfig<TData = unknown, TErrorData = unknown, TResultMode extends ResultModeUnion = "all"> extends Omit<RequestInit, "method" | "body">, ExtraOptions<TData, TErrorData, TResultMode> {
-}
-type BaseConfig<TBaseData = unknown, TBaseErrorData = unknown, TBaseResultMode extends ResultModeUnion = "all"> = FetchConfig<TBaseData, TBaseErrorData, TBaseResultMode>;
-type ApiSuccessVariant<TData> = {
-    data: TData;
-    error: null;
-    response: Response;
-};
-type PossibleErrorNames = {
-    _: "AbortError" | "TimeoutError" | "SyntaxError" | "TypeError" | "Error" | "UnknownError";
-}["_"];
-type ApiErrorVariant<TErrorData> = {
-    data: null;
-    error: {
-        name: "HTTPError";
-        errorData: TErrorData;
-        message: string;
-    };
-    response: Response;
-} | {
-    data: null;
-    error: {
-        name: PossibleErrorNames;
-        errorData: Error;
-        message: string;
-    };
-    response: null;
-};
-type ResultModeMap<TData = unknown, TErrorData = unknown> = {
-    all: ApiSuccessVariant<TData> | ApiErrorVariant<TErrorData>;
-    onlySuccess: ApiSuccessVariant<TData>["data"];
-    onlyError: ApiErrorVariant<TErrorData>["error"];
-    onlyResponse: Response;
-};
-type ResultModeUnion = {
-    _: {
-        [Key in keyof ResultModeMap]: Key;
-    }[keyof ResultModeMap];
-}["_"];
-type GetCallApiResult<TData, TErrorData, TResultMode extends ResultModeUnion> = ResultModeMap<TData, TErrorData>[TResultMode];
+import { R as ResultModeUnion, B as BaseConfig, F as FetchConfig, G as GetCallApiResult } from './index-DDD_c4ys.cjs';
+export { $ as $RequestOptions, c as ErrorContext, E as ExtraOptions, a as ResponseContext, b as ResponseErrorContext } from './index-DDD_c4ys.cjs';
 
-declare const createFetchClient: <TBaseData, TBaseErrorData = unknown, TBaseResultMode extends ResultModeUnion = "all">(baseConfig?: BaseConfig<TBaseData, TBaseErrorData, TBaseResultMode>) => {
+declare const createFetchClient: <TBaseData, TBaseErrorData = unknown, TBaseResultMode extends ResultModeUnion = undefined>(baseConfig?: BaseConfig<TBaseData, TBaseErrorData, TBaseResultMode>) => {
     <TData = TBaseData, TErrorData = TBaseErrorData, TResultMode extends ResultModeUnion = TBaseResultMode>(url: string, config?: FetchConfig<TData, TErrorData, TResultMode>): Promise<GetCallApiResult<TData, TErrorData, TResultMode>>;
     create: any;
-    cancel(url: string, reason?: unknown): void;
 };
 declare const callApi: {
-    <TData = unknown, TErrorData = unknown, TResultMode extends ResultModeUnion = "all">(url: string, config?: FetchConfig<TData, TErrorData, TResultMode> | undefined): Promise<GetCallApiResult<TData, TErrorData, TResultMode>>;
-    create: <TBaseData, TBaseErrorData = unknown, TBaseResultMode extends ResultModeUnion = "all">(baseConfig?: BaseConfig<TBaseData, TBaseErrorData, TBaseResultMode>) => {
+    <TData = unknown, TErrorData = unknown, TResultMode extends ResultModeUnion = undefined>(url: string, config?: FetchConfig<TData, TErrorData, TResultMode> | undefined): Promise<GetCallApiResult<TData, TErrorData, TResultMode>>;
+    create: <TBaseData, TBaseErrorData = unknown, TBaseResultMode extends ResultModeUnion = undefined>(baseConfig?: BaseConfig<TBaseData, TBaseErrorData, TBaseResultMode>) => {
         <TData = TBaseData, TErrorData = TBaseErrorData, TResultMode extends ResultModeUnion = TBaseResultMode>(url: string, config?: FetchConfig<TData, TErrorData, TResultMode>): Promise<GetCallApiResult<TData, TErrorData, TResultMode>>;
         create: any;
-        cancel(url: string, reason?: unknown): void;
     };
-    cancel(url: string, reason?: unknown): void;
 };
 
-export { type $RequestOptions, type ErrorContext, type ExtraOptions, type FetchConfig, HTTPError, type ResponseContext, type ResponseErrorContext, callApi, createFetchClient, isHTTPError, isHTTPErrorInstance, toQueryString };
+export { FetchConfig, callApi, createFetchClient };

package/dist/cjs/utils/index.cjs

@@ -0,0 +1 @@
+"use strict";var r,e=Object.defineProperty,o=Object.getOwnPropertyDescriptor,t=Object.getOwnPropertyNames,a=Object.prototype.hasOwnProperty,s={};((r,o)=>{for(var t in o)e(r,t,{get:o[t],enumerable:!0})})(s,{HTTPError:()=>u,isHTTPError:()=>c,isHTTPErrorInstance:()=>l,toQueryString:()=>i}),module.exports=(r=s,((r,s,n,i)=>{if(s&&"object"==typeof s||"function"==typeof s)for(let c of t(s))a.call(r,c)||c===n||e(r,c,{get:()=>s[c],enumerable:!(i=o(s,c))||i.enumerable});return r})(e({},"__esModule",{value:!0}),r));var n=r=>!("object"!=typeof r||null===r||r instanceof FormData||Array.isArray(r)),i=r=>r?new URLSearchParams(r).toString():(console.error("toQueryString:","No query params provided!"),null),c=(Object.keys({408:"Request Timeout",409:"Conflict",425:"Too Early",429:"Too Many Requests",500:"Internal Server Error",502:"Bad Gateway",503:"Service Unavailable",504:"Gateway Timeout"}).map(Number),r=>n(r)&&"HTTPError"===r.name),u=class extends Error{errorData;isHTTPError=!0;name="HTTPError";response;constructor(r,e){const{defaultErrorMessage:o,errorData:t,response:a}=r;super(t.message??o,e),this.errorData=t,this.response=a}},l=r=>r instanceof u||n(r)&&"HTTPError"===r.name&&!0===r.isHTTPError;//# sourceMappingURL=index.cjs.map

package/dist/cjs/utils/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/index.ts","../../../src/typeof.ts","../../../src/utils/utils.ts"],"sourcesContent":["export { HTTPError, isHTTPError, isHTTPErrorInstance, toQueryString } from \"./utils\";\n","import type { AnyFunction } from \"./type-helpers\";\n\nexport const isArray = <TArray>(value: unknown): value is TArray[] => Array.isArray(value);\n\nexport const isObject = <TObject extends Record<string, unknown>>(value: unknown): value is TObject => {\n\treturn (\n\t\ttypeof value === \"object\" && value !== null && !(value instanceof FormData) && !Array.isArray(value)\n\t);\n};\n\nexport const isFunction = <TFunction extends AnyFunction>(value: unknown): value is TFunction =>\n\ttypeof value === \"function\";\n\nexport const isString = (value: unknown) => typeof value === \"string\";\n\nexport const isQueryString = (value: unknown): value is string =>\n\ttypeof value === \"string\" && value.includes(\"=\");\n","import { isArray, isFunction, isObject } from \"../typeof\";\nimport type {\n\t$BaseRequestOptions,\n\t$RequestOptions,\n\tApiErrorVariant,\n\tBaseConfig,\n\tExtraOptions,\n\tFetchConfig,\n\tPossibleErrorObject,\n} from \"../types\";\n\n// prettier-ignore\nexport const getRequestKey = <TConfig extends Record<string, unknown>>(url: string, config?: TConfig) => `${url} | ${JSON.stringify(config ?? {})}`;\n\ntype ToQueryStringFn = {\n\t(params: ExtraOptions[\"query\"]): null | string;\n\t(params: Required<ExtraOptions>[\"query\"]): string;\n};\n\nexport const toQueryString: ToQueryStringFn = (params) => {\n\tif (!params) {\n\t\tconsole.error(\"toQueryString:\", \"No query params provided!\");\n\n\t\treturn null as never;\n\t}\n\n\treturn new URLSearchParams(params as Record<string, string>).toString();\n};\n\nexport const mergeUrlWithParams = (url: string, params: ExtraOptions[\"query\"]): string => {\n\tif (!params) {\n\t\treturn url;\n\t}\n\n\tconst paramsString = toQueryString(params);\n\n\tif (url.endsWith(\"?\")) {\n\t\treturn `${url}${paramsString}`;\n\t}\n\n\tif (url.includes(\"?\")) {\n\t\treturn `${url}&${paramsString}`;\n\t}\n\n\treturn `${url}?${paramsString}`;\n};\n\nexport const objectifyHeaders = (headers: RequestInit[\"headers\"]): Record<string, string> | undefined => {\n\tif (!headers || isObject(headers)) {\n\t\treturn headers;\n\t}\n\n\treturn Object.fromEntries(isArray(headers) ? headers : headers.entries());\n};\n\nconst retryCodesLookup = {\n\t408: \"Request Timeout\",\n\t409: \"Conflict\",\n\t425: \"Too Early\",\n\t429: \"Too Many Requests\",\n\t500: \"Internal Server Error\",\n\t502: \"Bad Gateway\",\n\t503: \"Service Unavailable\",\n\t504: \"Gateway Timeout\",\n};\n\nexport const defaultRetryCodes: Required<BaseConfig>[\"retryCodes\"] =\n\tObject.keys(retryCodesLookup).map(Number);\n\nexport const defaultRetryMethods: Required<BaseConfig>[\"retryMethods\"] = [\"GET\"];\n\nexport const fetchSpecificKeys = [\n\t\"body\",\n\t\"integrity\",\n\t\"method\",\n\t\"headers\",\n\t\"signal\",\n\t\"cache\",\n\t\"redirect\",\n\t\"window\",\n\t\"credentials\",\n\t\"keepalive\",\n\t\"referrer\",\n\t\"priority\",\n\t\"mode\",\n\t\"referrerPolicy\",\n] satisfies Array<keyof FetchConfig>;\n\nexport const omitKeys = <\n\tTObject extends Record<string, unknown>,\n\tconst TOmitArray extends Array<keyof TObject>,\n>(\n\tinitialObject: TObject,\n\tkeysToOmit: TOmitArray\n) => {\n\tconst arrayFromFilteredObject = Object.entries(initialObject).filter(\n\t\t([key]) => !keysToOmit.includes(key)\n\t);\n\n\tconst updatedObject = Object.fromEntries(arrayFromFilteredObject);\n\n\treturn updatedObject as Omit<TObject, keyof TOmitArray>;\n};\n\nconst pickKeys = <TObject extends Record<string, unknown>, const TPickArray extends Array<keyof TObject>>(\n\tinitialObject: TObject,\n\tkeysToPick: TPickArray\n) => {\n\tconst keysToPickSet = new Set(keysToPick);\n\n\tconst arrayFromInitObject = Object.entries(initialObject);\n\n\tconst filteredArray = arrayFromInitObject.filter(([objectKey]) => keysToPickSet.has(objectKey));\n\n\tconst updatedObject = Object.fromEntries(filteredArray);\n\n\treturn updatedObject as Pick<TObject, TPickArray[number]>;\n};\n\nexport const splitConfig = <TObject extends object>(\n\tconfig: TObject\n): [\"body\" extends keyof TObject ? $RequestOptions : $BaseRequestOptions, ExtraOptions] => [\n\tpickKeys(config as Record<string, unknown>, fetchSpecificKeys) as never,\n\tomitKeys(config as Record<string, unknown>, fetchSpecificKeys) as never,\n];\n\nexport const handleResponseType = <TResponse>(\n\tresponse: Response,\n\tparser?: Required<ExtraOptions>[\"responseParser\"]\n) => ({\n\tarrayBuffer: () => response.arrayBuffer() as Promise<TResponse>,\n\tblob: () => response.blob() as Promise<TResponse>,\n\tformData: () => response.formData() as Promise<TResponse>,\n\tjson: async () => {\n\t\tif (parser) {\n\t\t\treturn parser(await response.text());\n\t\t}\n\n\t\treturn response.json() as Promise<TResponse>;\n\t},\n\ttext: () => response.text() as Promise<TResponse>,\n});\n\nexport const getResponseData = <TResponse>(\n\tresponse: Response,\n\tresponseType: keyof ReturnType<typeof handleResponseType>,\n\tparser: ExtraOptions[\"responseParser\"]\n) => {\n\tconst RESPONSE_TYPE_LOOKUP = handleResponseType<TResponse>(response, parser);\n\n\tif (!Object.hasOwn(RESPONSE_TYPE_LOOKUP, responseType)) {\n\t\tthrow new Error(`Invalid response type: ${responseType}`);\n\t}\n\n\treturn RESPONSE_TYPE_LOOKUP[responseType]();\n};\n\ntype data = {\n\toptions: ExtraOptions;\n\tresponse: Response;\n\tsuccessData: unknown;\n};\n\n// == The CallApiResult type is used to cast all return statements due to a design limitation in ts.\n// LINK - See https://www.zhenghao.io/posts/type-functions for more info\nexport const resolveSuccessResult = <CallApiResult>(info: data): CallApiResult => {\n\tconst { options, response, successData } = info;\n\n\tconst apiDetails = {\n\t\tdata: successData,\n\t\terror: null,\n\t\tresponse,\n\t};\n\n\tif (!options.resultMode || options.resultMode === \"all\") {\n\t\treturn apiDetails as CallApiResult;\n\t}\n\n\treturn {\n\t\tonlyError: apiDetails.error,\n\t\tonlyResponse: apiDetails.response,\n\t\tonlySuccess: apiDetails.data,\n\t}[options.resultMode] as CallApiResult;\n};\n\n// == Using curring here so error and options are not required to be passed every time, instead to be captured once by way of closure\nexport const getResolveErrorResultFn = <CallApiResult>($info: {\n\terror?: unknown;\n\toptions: ExtraOptions;\n}) => {\n\tconst { error, options } = $info;\n\n\ttype ErrorInfo = {\n\t\terrorData?: unknown;\n\t\tmessage?: string;\n\t\tresponse?: Response;\n\t};\n\n\tconst resolveErrorResult = (info: ErrorInfo = {}): CallApiResult => {\n\t\tconst { errorData, message, response } = info;\n\n\t\tconst shouldThrowOnError = isFunction(options.throwOnError)\n\t\t\t? options.throwOnError(error as Error)\n\t\t\t: options.throwOnError;\n\n\t\tif (shouldThrowOnError) {\n\t\t\tthrow error;\n\t\t}\n\n\t\treturn {\n\t\t\tdata: null,\n\t\t\terror: {\n\t\t\t\terrorData: errorData ?? error,\n\t\t\t\tmessage: message ?? (error as PossibleErrorObject)?.message ?? options.defaultErrorMessage,\n\t\t\t\tname: (error as PossibleErrorObject)?.name ?? \"UnknownError\",\n\t\t\t},\n\t\t\tresponse: response ?? null,\n\t\t} as CallApiResult;\n\t};\n\n\treturn resolveErrorResult;\n};\n\nexport const isHTTPError = <TErrorData>(error: ApiErrorVariant<TErrorData>[\"error\"] | null) => {\n\treturn isObject(error) && error.name === \"HTTPError\";\n};\n\ntype ErrorDetails<TErrorResponse> = {\n\tdefaultErrorMessage: string;\n\terrorData: TErrorResponse;\n\tresponse: Response;\n};\n\ntype ErrorOptions = {\n\tcause?: unknown;\n};\n\nexport class HTTPError<TErrorResponse = Record<string, unknown>> extends Error {\n\terrorData: ErrorDetails<TErrorResponse>[\"errorData\"];\n\tisHTTPError = true;\n\n\toverride name = \"HTTPError\" as const;\n\n\tresponse: ErrorDetails<TErrorResponse>[\"response\"];\n\n\tconstructor(errorDetails: ErrorDetails<TErrorResponse>, errorOptions?: ErrorOptions) {\n\t\tconst { defaultErrorMessage, errorData, response } = errorDetails;\n\n\t\tsuper((errorData as { message?: string }).message ?? defaultErrorMessage, errorOptions);\n\n\t\tthis.errorData = errorData;\n\t\tthis.response = response;\n\t}\n}\n\n// prettier-ignore\nexport const isHTTPErrorInstance = <TErrorResponse>(\n\terror: unknown\n): error is HTTPError<TErrorResponse> => {\n\treturn (\n\t\terror instanceof HTTPError || (isObject(error) && error.name === \"HTTPError\" && error.isHTTPError === true)\n\t);\n};\n\nexport const waitUntil = (delay: number) => {\n\tif (delay === 0) return;\n\n\tconst { promise, resolve } = Promise.withResolvers();\n\n\tsetTimeout(resolve, delay);\n\n\treturn promise;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACIO,IAAM,WAAW,CAA0C,UAAqC;AACtG,SACC,OAAO,UAAU,YAAY,UAAU,QAAQ,EAAE,iBAAiB,aAAa,CAAC,MAAM,QAAQ,KAAK;AAErG;;;ACWO,IAAM,gBAAiC,CAAC,WAAW;AACzD,MAAI,CAAC,QAAQ;AACZ,YAAQ,MAAM,kBAAkB,2BAA2B;AAE3D,WAAO;AAAA,EACR;AAEA,SAAO,IAAI,gBAAgB,MAAgC,EAAE,SAAS;AACvE;AA4BA,IAAM,mBAAmB;AAAA,EACxB,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AACN;AAEO,IAAM,oBACZ,OAAO,KAAK,gBAAgB,EAAE,IAAI,MAAM;AA4JlC,IAAM,cAAc,CAAa,UAAuD;AAC9F,SAAO,SAAS,KAAK,KAAK,MAAM,SAAS;AAC1C;AAYO,IAAM,YAAN,cAAkE,MAAM;AAAA,EAC9E;AAAA,EACA,cAAc;AAAA,EAEL,OAAO;AAAA,EAEhB;AAAA,EAEA,YAAY,cAA4C,cAA6B;AACpF,UAAM,EAAE,qBAAqB,WAAW,SAAS,IAAI;AAErD,UAAO,UAAmC,WAAW,qBAAqB,YAAY;AAEtF,SAAK,YAAY;AACjB,SAAK,WAAW;AAAA,EACjB;AACD;AAGO,IAAM,sBAAsB,CAClC,UACwC;AACxC,SACC,iBAAiB,aAAc,SAAS,KAAK,KAAK,MAAM,SAAS,eAAe,MAAM,gBAAgB;AAExG;","names":[]}

package/dist/cjs/utils/index.d.cts

@@ -0,0 +1 @@
+export { H as HTTPError, i as isHTTPError, d as isHTTPErrorInstance, t as toQueryString } from '../index-DDD_c4ys.cjs';

package/dist/esm/chunk-YYBXXYTQ.js

@@ -0,0 +1 @@
+var r=r=>!("object"!=typeof r||null===r||r instanceof FormData||Array.isArray(r)),e=r=>"string"==typeof r,t=r=>"string"==typeof r&&r.includes("="),o=(r,e)=>`${r} | ${JSON.stringify(e??{})}`,s=r=>r?new URLSearchParams(r).toString():(console.error("toQueryString:","No query params provided!"),null),n=(r,e)=>{if(!e)return r;const t=s(e);return r.endsWith("?")?`${r}${t}`:r.includes("?")?`${r}&${t}`:`${r}?${t}`},a=e=>{return!e||r(e)?e:Object.fromEntries((t=e,Array.isArray(t)?e:e.entries()));var t},i=Object.keys({408:"Request Timeout",409:"Conflict",425:"Too Early",429:"Too Many Requests",500:"Internal Server Error",502:"Bad Gateway",503:"Service Unavailable",504:"Gateway Timeout"}).map(Number),l=["GET"],c=["body","integrity","method","headers","signal","cache","redirect","window","credentials","keepalive","referrer","priority","mode","referrerPolicy"],u=(r,e)=>{const t=Object.entries(r).filter((([r])=>!e.includes(r)));return Object.fromEntries(t)},f=(r,e)=>{const t=new Set(e),o=Object.entries(r).filter((([r])=>t.has(r)));return Object.fromEntries(o)},y=r=>[f(r,c),u(r,c)],m=(r,e,t)=>{const o=((r,e)=>({arrayBuffer:()=>r.arrayBuffer(),blob:()=>r.blob(),formData:()=>r.formData(),json:async()=>e?e(await r.text()):r.json(),text:()=>r.text()}))(r,t);if(!Object.hasOwn(o,e))throw new Error(`Invalid response type: ${e}`);return o[e]()},p=r=>{const{options:e,response:t,successData:o}=r,s={data:o,error:null,response:t};return e.resultMode&&"all"!==e.resultMode?{onlyError:s.error,onlyResponse:s.response,onlySuccess:s.data}[e.resultMode]:s},d=r=>{const{error:e,options:t}=r;return(r={})=>{const{errorData:o,message:s,response:n}=r;if("function"==typeof t.throwOnError?t.throwOnError(e):t.throwOnError)throw e;return{data:null,error:{errorData:o??e,message:s??e?.message??t.defaultErrorMessage,name:e?.name??"UnknownError"},response:n??null}}},E=e=>r(e)&&"HTTPError"===e.name,w=class extends Error{errorData;isHTTPError=!0;name="HTTPError";response;constructor(r,e){const{defaultErrorMessage:t,errorData:o,response:s}=r;super(o.message??t,e),this.errorData=o,this.response=s}},T=e=>e instanceof w||r(e)&&"HTTPError"===e.name&&!0===e.isHTTPError,b=r=>{if(0===r)return;const{promise:e,resolve:t}=Promise.withResolvers();return setTimeout(t,r),e};export{w as HTTPError,i as defaultRetryCodes,l as defaultRetryMethods,o as getRequestKey,d as getResolveErrorResultFn,m as getResponseData,E as isHTTPError,T as isHTTPErrorInstance,r as isObject,t as isQueryString,e as isString,n as mergeUrlWithParams,a as objectifyHeaders,u as omitKeys,p as resolveSuccessResult,y as splitConfig,s as toQueryString,b as waitUntil};//# sourceMappingURL=chunk-YYBXXYTQ.js.map

package/dist/esm/chunk-YYBXXYTQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/typeof.ts","../../src/utils/utils.ts"],"names":[],"mappings":"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","file":"chunk-YYBXXYTQ.js","sourcesContent":["import type { AnyFunction } from \"./type-helpers\";\n\nexport const isArray = <TArray>(value: unknown): value is TArray[] => Array.isArray(value);\n\nexport const isObject = <TObject extends Record<string, unknown>>(value: unknown): value is TObject => {\n\treturn (\n\t\ttypeof value === \"object\" && value !== null && !(value instanceof FormData) && !Array.isArray(value)\n\t);\n};\n\nexport const isFunction = <TFunction extends AnyFunction>(value: unknown): value is TFunction =>\n\ttypeof value === \"function\";\n\nexport const isString = (value: unknown) => typeof value === \"string\";\n\nexport const isQueryString = (value: unknown): value is string =>\n\ttypeof value === \"string\" && value.includes(\"=\");\n","import { isArray, isFunction, isObject } from \"../typeof\";\nimport type {\n\t$BaseRequestOptions,\n\t$RequestOptions,\n\tApiErrorVariant,\n\tBaseConfig,\n\tExtraOptions,\n\tFetchConfig,\n\tPossibleErrorObject,\n} from \"../types\";\n\n// prettier-ignore\nexport const getRequestKey = <TConfig extends Record<string, unknown>>(url: string, config?: TConfig) => `${url} | ${JSON.stringify(config ?? {})}`;\n\ntype ToQueryStringFn = {\n\t(params: ExtraOptions[\"query\"]): null | string;\n\t(params: Required<ExtraOptions>[\"query\"]): string;\n};\n\nexport const toQueryString: ToQueryStringFn = (params) => {\n\tif (!params) {\n\t\tconsole.error(\"toQueryString:\", \"No query params provided!\");\n\n\t\treturn null as never;\n\t}\n\n\treturn new URLSearchParams(params as Record<string, string>).toString();\n};\n\nexport const mergeUrlWithParams = (url: string, params: ExtraOptions[\"query\"]): string => {\n\tif (!params) {\n\t\treturn url;\n\t}\n\n\tconst paramsString = toQueryString(params);\n\n\tif (url.endsWith(\"?\")) {\n\t\treturn `${url}${paramsString}`;\n\t}\n\n\tif (url.includes(\"?\")) {\n\t\treturn `${url}&${paramsString}`;\n\t}\n\n\treturn `${url}?${paramsString}`;\n};\n\nexport const objectifyHeaders = (headers: RequestInit[\"headers\"]): Record<string, string> | undefined => {\n\tif (!headers || isObject(headers)) {\n\t\treturn headers;\n\t}\n\n\treturn Object.fromEntries(isArray(headers) ? headers : headers.entries());\n};\n\nconst retryCodesLookup = {\n\t408: \"Request Timeout\",\n\t409: \"Conflict\",\n\t425: \"Too Early\",\n\t429: \"Too Many Requests\",\n\t500: \"Internal Server Error\",\n\t502: \"Bad Gateway\",\n\t503: \"Service Unavailable\",\n\t504: \"Gateway Timeout\",\n};\n\nexport const defaultRetryCodes: Required<BaseConfig>[\"retryCodes\"] =\n\tObject.keys(retryCodesLookup).map(Number);\n\nexport const defaultRetryMethods: Required<BaseConfig>[\"retryMethods\"] = [\"GET\"];\n\nexport const fetchSpecificKeys = [\n\t\"body\",\n\t\"integrity\",\n\t\"method\",\n\t\"headers\",\n\t\"signal\",\n\t\"cache\",\n\t\"redirect\",\n\t\"window\",\n\t\"credentials\",\n\t\"keepalive\",\n\t\"referrer\",\n\t\"priority\",\n\t\"mode\",\n\t\"referrerPolicy\",\n] satisfies Array<keyof FetchConfig>;\n\nexport const omitKeys = <\n\tTObject extends Record<string, unknown>,\n\tconst TOmitArray extends Array<keyof TObject>,\n>(\n\tinitialObject: TObject,\n\tkeysToOmit: TOmitArray\n) => {\n\tconst arrayFromFilteredObject = Object.entries(initialObject).filter(\n\t\t([key]) => !keysToOmit.includes(key)\n\t);\n\n\tconst updatedObject = Object.fromEntries(arrayFromFilteredObject);\n\n\treturn updatedObject as Omit<TObject, keyof TOmitArray>;\n};\n\nconst pickKeys = <TObject extends Record<string, unknown>, const TPickArray extends Array<keyof TObject>>(\n\tinitialObject: TObject,\n\tkeysToPick: TPickArray\n) => {\n\tconst keysToPickSet = new Set(keysToPick);\n\n\tconst arrayFromInitObject = Object.entries(initialObject);\n\n\tconst filteredArray = arrayFromInitObject.filter(([objectKey]) => keysToPickSet.has(objectKey));\n\n\tconst updatedObject = Object.fromEntries(filteredArray);\n\n\treturn updatedObject as Pick<TObject, TPickArray[number]>;\n};\n\nexport const splitConfig = <TObject extends object>(\n\tconfig: TObject\n): [\"body\" extends keyof TObject ? $RequestOptions : $BaseRequestOptions, ExtraOptions] => [\n\tpickKeys(config as Record<string, unknown>, fetchSpecificKeys) as never,\n\tomitKeys(config as Record<string, unknown>, fetchSpecificKeys) as never,\n];\n\nexport const handleResponseType = <TResponse>(\n\tresponse: Response,\n\tparser?: Required<ExtraOptions>[\"responseParser\"]\n) => ({\n\tarrayBuffer: () => response.arrayBuffer() as Promise<TResponse>,\n\tblob: () => response.blob() as Promise<TResponse>,\n\tformData: () => response.formData() as Promise<TResponse>,\n\tjson: async () => {\n\t\tif (parser) {\n\t\t\treturn parser(await response.text());\n\t\t}\n\n\t\treturn response.json() as Promise<TResponse>;\n\t},\n\ttext: () => response.text() as Promise<TResponse>,\n});\n\nexport const getResponseData = <TResponse>(\n\tresponse: Response,\n\tresponseType: keyof ReturnType<typeof handleResponseType>,\n\tparser: ExtraOptions[\"responseParser\"]\n) => {\n\tconst RESPONSE_TYPE_LOOKUP = handleResponseType<TResponse>(response, parser);\n\n\tif (!Object.hasOwn(RESPONSE_TYPE_LOOKUP, responseType)) {\n\t\tthrow new Error(`Invalid response type: ${responseType}`);\n\t}\n\n\treturn RESPONSE_TYPE_LOOKUP[responseType]();\n};\n\ntype data = {\n\toptions: ExtraOptions;\n\tresponse: Response;\n\tsuccessData: unknown;\n};\n\n// == The CallApiResult type is used to cast all return statements due to a design limitation in ts.\n// LINK - See https://www.zhenghao.io/posts/type-functions for more info\nexport const resolveSuccessResult = <CallApiResult>(info: data): CallApiResult => {\n\tconst { options, response, successData } = info;\n\n\tconst apiDetails = {\n\t\tdata: successData,\n\t\terror: null,\n\t\tresponse,\n\t};\n\n\tif (!options.resultMode || options.resultMode === \"all\") {\n\t\treturn apiDetails as CallApiResult;\n\t}\n\n\treturn {\n\t\tonlyError: apiDetails.error,\n\t\tonlyResponse: apiDetails.response,\n\t\tonlySuccess: apiDetails.data,\n\t}[options.resultMode] as CallApiResult;\n};\n\n// == Using curring here so error and options are not required to be passed every time, instead to be captured once by way of closure\nexport const getResolveErrorResultFn = <CallApiResult>($info: {\n\terror?: unknown;\n\toptions: ExtraOptions;\n}) => {\n\tconst { error, options } = $info;\n\n\ttype ErrorInfo = {\n\t\terrorData?: unknown;\n\t\tmessage?: string;\n\t\tresponse?: Response;\n\t};\n\n\tconst resolveErrorResult = (info: ErrorInfo = {}): CallApiResult => {\n\t\tconst { errorData, message, response } = info;\n\n\t\tconst shouldThrowOnError = isFunction(options.throwOnError)\n\t\t\t? options.throwOnError(error as Error)\n\t\t\t: options.throwOnError;\n\n\t\tif (shouldThrowOnError) {\n\t\t\tthrow error;\n\t\t}\n\n\t\treturn {\n\t\t\tdata: null,\n\t\t\terror: {\n\t\t\t\terrorData: errorData ?? error,\n\t\t\t\tmessage: message ?? (error as PossibleErrorObject)?.message ?? options.defaultErrorMessage,\n\t\t\t\tname: (error as PossibleErrorObject)?.name ?? \"UnknownError\",\n\t\t\t},\n\t\t\tresponse: response ?? null,\n\t\t} as CallApiResult;\n\t};\n\n\treturn resolveErrorResult;\n};\n\nexport const isHTTPError = <TErrorData>(error: ApiErrorVariant<TErrorData>[\"error\"] | null) => {\n\treturn isObject(error) && error.name === \"HTTPError\";\n};\n\ntype ErrorDetails<TErrorResponse> = {\n\tdefaultErrorMessage: string;\n\terrorData: TErrorResponse;\n\tresponse: Response;\n};\n\ntype ErrorOptions = {\n\tcause?: unknown;\n};\n\nexport class HTTPError<TErrorResponse = Record<string, unknown>> extends Error {\n\terrorData: ErrorDetails<TErrorResponse>[\"errorData\"];\n\tisHTTPError = true;\n\n\toverride name = \"HTTPError\" as const;\n\n\tresponse: ErrorDetails<TErrorResponse>[\"response\"];\n\n\tconstructor(errorDetails: ErrorDetails<TErrorResponse>, errorOptions?: ErrorOptions) {\n\t\tconst { defaultErrorMessage, errorData, response } = errorDetails;\n\n\t\tsuper((errorData as { message?: string }).message ?? defaultErrorMessage, errorOptions);\n\n\t\tthis.errorData = errorData;\n\t\tthis.response = response;\n\t}\n}\n\n// prettier-ignore\nexport const isHTTPErrorInstance = <TErrorResponse>(\n\terror: unknown\n): error is HTTPError<TErrorResponse> => {\n\treturn (\n\t\terror instanceof HTTPError || (isObject(error) && error.name === \"HTTPError\" && error.isHTTPError === true)\n\t);\n};\n\nexport const waitUntil = (delay: number) => {\n\tif (delay === 0) return;\n\n\tconst { promise, resolve } = Promise.withResolvers();\n\n\tsetTimeout(resolve, delay);\n\n\treturn promise;\n};\n"]}

package/dist/esm/index-DDD_c4ys.d.ts

@@ -0,0 +1,252 @@
+type AnyString = string & {
+    placeholder?: never;
+};
+type AnyNumber = number & {
+    placeholder?: never;
+};
+type Prettify<TObject> = {
+    [Key in keyof TObject]: TObject[Key];
+} & NonNullable<unknown>;
+
+type ToQueryStringFn = {
+    (params: ExtraOptions["query"]): null | string;
+    (params: Required<ExtraOptions>["query"]): string;
+};
+declare const toQueryString: ToQueryStringFn;
+declare const fetchSpecificKeys: ("body" | "method" | "headers" | "cache" | "credentials" | "integrity" | "keepalive" | "mode" | "priority" | "redirect" | "referrer" | "referrerPolicy" | "signal" | "window")[];
+declare const handleResponseType: <TResponse>(response: Response, parser?: Required<ExtraOptions>["responseParser"]) => {
+    arrayBuffer: () => Promise<TResponse>;
+    blob: () => Promise<TResponse>;
+    formData: () => Promise<TResponse>;
+    json: () => Promise<Record<string, unknown> | TResponse>;
+    text: () => Promise<TResponse>;
+};
+declare const isHTTPError: <TErrorData>(error: ApiErrorVariant<TErrorData>["error"] | null) => error is {
+    errorData: TErrorData;
+    message: string;
+    name: "HTTPError";
+};
+type ErrorDetails<TErrorResponse> = {
+    defaultErrorMessage: string;
+    errorData: TErrorResponse;
+    response: Response;
+};
+type ErrorOptions = {
+    cause?: unknown;
+};
+declare class HTTPError<TErrorResponse = Record<string, unknown>> extends Error {
+    errorData: ErrorDetails<TErrorResponse>["errorData"];
+    isHTTPError: boolean;
+    name: "HTTPError";
+    response: ErrorDetails<TErrorResponse>["response"];
+    constructor(errorDetails: ErrorDetails<TErrorResponse>, errorOptions?: ErrorOptions);
+}
+declare const isHTTPErrorInstance: <TErrorResponse>(error: unknown) => error is HTTPError<TErrorResponse>;
+
+interface $RequestOptions extends Pick<FetchConfig, (typeof fetchSpecificKeys)[number]> {
+}
+interface ExtraOptions<TData = unknown, TErrorData = unknown, TResultMode extends ResultModeUnion = ResultModeUnion> {
+    /**
+     * @description Authorization header value.
+     */
+    auth?: {
+        bearer: string;
+        token?: never;
+    } | {
+        bearer?: never;
+        token: string;
+    } | string;
+    /**
+     * @description Base URL to be prepended to all request URLs
+     */
+    baseURL?: string;
+    /** Optional body of the request, can be a object or any other supported body type. */
+    body?: Record<string, unknown> | RequestInit["body"];
+    /**
+     * @description Custom function to serialize the body object into a string.
+     */
+    bodySerializer?: (bodyData: Record<string, unknown>) => string;
+    /**
+     * @description If true, cancels previous unfinished requests to the same URL.
+     * @default true
+     */
+    cancelRedundantRequests?: boolean;
+    /**
+     * @description Whether to clone the response, so response.json and the like can used in the interceptors.
+     * @default false
+     */
+    cloneResponse?: boolean;
+    /**
+     * @description Default error message to use if none is provided from a response.
+     * @default "Failed to fetch data from server!"
+     */
+    defaultErrorMessage?: string;
+    /**
+     * @description 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?: Record<string, unknown>;
+    /**
+     * @description HTTP method for the request.
+     * @default "GET"
+     */
+    method?: "DELETE" | "GET" | "PATCH" | "POST" | "PUT" | AnyString;
+    /**
+     * @description Interceptor to be called when an error occurs during the fetch request OR when an error response is received from the api
+     * It is basically a combination of `onRequestError` and `onResponseError` interceptors
+     */
+    onError?: (anyErrorContext: ErrorContext<TErrorData>) => Promise<void> | void;
+    /** @description Interceptor to be called just before the request is made, allowing for modifications or additional operations. */
+    onRequest?: (requestContext: {
+        options: ExtraOptions;
+        request: $RequestOptions;
+    }) => Promise<void> | void;
+    /** @description Interceptor to be called when an error occurs during the fetch request. */
+    onRequestError?: (requestErrorContext: {
+        error: Error;
+        options: ExtraOptions;
+        request: $RequestOptions;
+    }) => Promise<void> | void;
+    /** @description Interceptor to be called when a successful response is received from the api. */
+    onResponse?: (responseContext: ResponseContext<TData>) => Promise<void> | void;
+    /** @description Interceptor to be called when an error response is received from the api. */
+    onResponseError?: (responseErrorContext: ResponseErrorContext<TErrorData>) => Promise<void> | void;
+    /**
+     * @description Query parameters to append to the URL.
+     */
+    query?: Record<string, boolean | number | string>;
+    /**
+     * @description Custom function to parse the response string into a object.
+     */
+    responseParser?: (responseString: string) => Record<string, unknown>;
+    /**
+     * @description Expected response type, affects how response is parsed
+     * @default "json"
+     */
+    responseType?: keyof ReturnType<typeof handleResponseType>;
+    /**
+     * @description Custom function to validate the response data.
+     */
+    responseValidator?: (data: unknown) => TData;
+    /**
+     * @description Mode of the result, can influence how results are handled or returned.
+     * Can be set to "all" | "onlySuccess" | "onlyError" | "onlyResponse".
+     * @default "all"
+     */
+    resultMode?: TResultMode;
+    /**
+     * @description Number of retry attempts for failed requests
+     * @default 0
+     */
+    retries?: number;
+    /**
+     * @description HTTP status codes that trigger a retry
+     * @default [409, 425, 429, 500, 502, 503, 504]
+     */
+    retryCodes?: Array<409 | 425 | 429 | 500 | 502 | 503 | 504 | AnyNumber>;
+    /**
+     * @description Delay between retries in milliseconds
+     * @default 500
+     */
+    retryDelay?: number;
+    /**
+     * HTTP methods that are allowed to retry
+     * @default ["GET", "POST"]
+     */
+    retryMethods?: Array<"GET" | "POST" | AnyString>;
+    /**
+     * If true or the function returns true, throws errors instead of returning them
+     * The function is passed the error object and can be used to conditionally throw the error
+     * @default false
+     */
+    throwOnError?: ((error?: Error | HTTPError<TErrorData>) => boolean) | boolean;
+    /**
+     * @description Request timeout in milliseconds
+     */
+    timeout?: number;
+}
+type ResponseContext<TData> = Prettify<{
+    data: TData;
+    options: ExtraOptions;
+    request: $RequestOptions;
+    response: Response;
+}>;
+type ResponseErrorContext<TErrorData> = Prettify<{
+    errorData: TErrorData;
+    options: ExtraOptions;
+    request: $RequestOptions;
+    response: Response;
+}>;
+type ErrorContext<TErrorData> = Prettify<{
+    error: Error;
+    errorData?: null;
+    options: ExtraOptions;
+    request: $RequestOptions;
+    response: null;
+} | {
+    error: null;
+    errorData?: TErrorData;
+    options: ExtraOptions;
+    request: $RequestOptions;
+    response: Response;
+}>;
+interface FetchConfig<TData = unknown, TErrorData = unknown, TResultMode extends ResultModeUnion = "all"> extends Omit<RequestInit, "body" | "method">, ExtraOptions<TData, TErrorData, TResultMode> {
+}
+type BaseConfig<TBaseData = unknown, TBaseErrorData = unknown, TBaseResultMode extends ResultModeUnion = "all"> = FetchConfig<TBaseData, TBaseErrorData, TBaseResultMode>;
+type ApiSuccessVariant<TData> = {
+    data: TData;
+    error: null;
+    response: Response;
+};
+type PossibleErrorNames = {
+    _: "AbortError" | "Error" | "SyntaxError" | "TimeoutError" | "TypeError" | "UnknownError";
+}["_"];
+type ApiErrorVariant<TErrorData> = {
+    data: null;
+    error: {
+        errorData: Error;
+        message: string;
+        name: PossibleErrorNames;
+    };
+    response: null;
+} | {
+    data: null;
+    error: {
+        errorData: TErrorData;
+        message: string;
+        name: "HTTPError";
+    };
+    response: Response;
+};
+type ResultModeMap<TData = unknown, TErrorData = unknown> = {
+    all: ApiErrorVariant<TErrorData> | ApiSuccessVariant<TData>;
+    onlyError: ApiErrorVariant<TErrorData>["error"];
+    onlyResponse: Response;
+    onlySuccess: ApiSuccessVariant<TData>["data"];
+};
+type ResultModeUnion = {
+    _: {
+        [Key in keyof ResultModeMap]: Key;
+    }[keyof ResultModeMap] | undefined;
+}["_"];
+type GetCallApiResult<TData, TErrorData, TResultMode> = TResultMode extends NonNullable<ResultModeUnion> ? ResultModeMap<TData, TErrorData>[TResultMode] : ResultModeMap<TData, TErrorData>["all"];
+
+export { type $RequestOptions as $, type BaseConfig as B, type ExtraOptions as E, type FetchConfig as F, type GetCallApiResult as G, HTTPError as H, type ResultModeUnion as R, type ResponseContext as a, type ResponseErrorContext as b, type ErrorContext as c, isHTTPErrorInstance as d, isHTTPError as i, toQueryString as t };

package/dist/esm/index.d.ts

@@ -1,3 +1,16 @@
-export { callApi, createFetchClient } from './createFetchClient.js';
-export { $ as $RequestOptions, c as ErrorContext, E as ExtraOptions, F as FetchConfig, H as HTTPError, a as ResponseContext, b as ResponseErrorContext, i as isHTTPError, d as isHTTPErrorInstance, t as toQueryString } from './types-B8FDdcFK.js';
-import './type-helpers-DpDJiTqb.js';
+import { R as ResultModeUnion, B as BaseConfig, F as FetchConfig, G as GetCallApiResult } from './index-DDD_c4ys.js';
+export { $ as $RequestOptions, c as ErrorContext, E as ExtraOptions, a as ResponseContext, b as ResponseErrorContext } from './index-DDD_c4ys.js';
+
+declare const createFetchClient: <TBaseData, TBaseErrorData = unknown, TBaseResultMode extends ResultModeUnion = undefined>(baseConfig?: BaseConfig<TBaseData, TBaseErrorData, TBaseResultMode>) => {
+    <TData = TBaseData, TErrorData = TBaseErrorData, TResultMode extends ResultModeUnion = TBaseResultMode>(url: string, config?: FetchConfig<TData, TErrorData, TResultMode>): Promise<GetCallApiResult<TData, TErrorData, TResultMode>>;
+    create: any;
+};
+declare const callApi: {
+    <TData = unknown, TErrorData = unknown, TResultMode extends ResultModeUnion = undefined>(url: string, config?: FetchConfig<TData, TErrorData, TResultMode> | undefined): Promise<GetCallApiResult<TData, TErrorData, TResultMode>>;
+    create: <TBaseData, TBaseErrorData = unknown, TBaseResultMode extends ResultModeUnion = undefined>(baseConfig?: BaseConfig<TBaseData, TBaseErrorData, TBaseResultMode>) => {
+        <TData = TBaseData, TErrorData = TBaseErrorData, TResultMode extends ResultModeUnion = TBaseResultMode>(url: string, config?: FetchConfig<TData, TErrorData, TResultMode>): Promise<GetCallApiResult<TData, TErrorData, TResultMode>>;
+        create: any;
+    };
+};
+
+export { FetchConfig, callApi, createFetchClient };

package/dist/esm/index.js

@@ -1 +1 @@
-export{callApi,createFetchClient}from"./chunk-5TFO467R.js";export{HTTPError,isHTTPError,isHTTPErrorInstance,toQueryString}from"./chunk-DWIZQKLW.js";import"./chunk-AKFUJ4JG.js";//# sourceMappingURL=index.js.map
+import{splitConfig as e,defaultRetryCodes as r,defaultRetryMethods as o,isObject as t,isQueryString as s,isString as n,objectifyHeaders as a,getRequestKey as i,omitKeys as u,mergeUrlWithParams as l,waitUntil as c,getResponseData as p,HTTPError as d,resolveSuccessResult as h,getResolveErrorResultFn as m,isHTTPErrorInstance as y}from"./chunk-YYBXXYTQ.js";var f=R=>{const w=new Map,[b,E]=e(R??{}),{body:g,headers:q,signal:D,...$}=b,A=async(f,R)=>{const[b,M]=e(R??{}),{body:T=g,headers:S,signal:k=D,...x}=b,C={baseURL:"",bodySerializer:JSON.stringify,cancelRedundantRequests:!0,defaultErrorMessage:"Failed to fetch data from server!",responseType:"json",retries:0,retryCodes:r,retryDelay:0,retryMethods:o,...E,...M},j={body:t(T)?C.bodySerializer(T):T,headers:q||S||C.auth||t(T)?{...t(T)&&{Accept:"application/json","Content-Type":"application/json"},...s(T)&&{"Content-Type":"application/x-www-form-urlencoded"},...n(C.auth)&&{Authorization:`Bearer ${C.auth}`},...t(C.auth)&&{Authorization:"bearer"in C.auth?`Bearer ${C.auth.bearer}`:`Token ${C.auth.token}`},...a(q),...a(S)}:void 0,method:"GET",...$,...x},v=i(f,u({...j,...C},["onRequest","onResponse","onResponseError","onError","onRequestError"])),z=w.get(v);if(z&&C.cancelRedundantRequests){const e=new DOMException(`Automatic cancelation of the previous unfinished request to the same url, with the same fetch options: ${f}`,"AbortError");z.abort(e)}const O=new AbortController;w.set(v,O);const P=C.timeout?AbortSignal.timeout(C.timeout):null,B=AbortSignal.any([O.signal,...P?[P]:[],...k?[k]:[]]),Y={signal:B,...j};try{await(C.onRequest?.({options:C,request:Y}));const e=await fetch(`${C.baseURL}${l(f,C.query)}`,Y);if(!e.ok&&!B.aborted&&C.retries>0&&C.retryCodes.includes(e.status)&&C.retryMethods.includes(Y.method))return await c(C.retryDelay),await A(f,{...R,retries:C.retries-1});if(!e.ok){const r=await p(C.cloneResponse?e.clone():e,C.responseType,C.responseParser);throw new d({defaultErrorMessage:C.defaultErrorMessage,errorData:r,response:e})}const r=await p(C.cloneResponse?e.clone():e,C.responseType,C.responseParser),o=C.responseValidator?C.responseValidator(r):r;return await(C.onResponse?.({data:o,options:C,request:Y,response:C.cloneResponse?e.clone():e})),h({options:C,response:e,successData:o})}catch(e){const r=m({error:e,options:C});if(e instanceof DOMException&&"TimeoutError"===e.name){const o=`Request timed out after ${C.timeout}ms`;return console.error(`${e.name}:`,o),r({message:o})}if(e instanceof DOMException&&"AbortError"===e.name){const o=`Request aborted due to ${e.message}`;return console.error(`${e.name}:`,o),r({message:o})}if(y(e)){const{errorData:o,response:t}=e;return await Promise.allSettled([C.onResponseError?.({errorData:o,options:C,request:Y,response:C.cloneResponse?t.clone():t}),C.onError?.({error:null,errorData:o,options:C,request:Y,response:t})]),r({errorData:o,message:o?.message,response:t})}return await Promise.allSettled([C.onRequestError?.({error:e,options:C,request:Y}),C.onError?.({error:e,errorData:null,options:C,request:Y,response:null})]),r()}finally{w.delete(v)}};return A.create=f,A},R=f();export{R as callApi,f as createFetchClient};//# sourceMappingURL=index.js.map