@short.io/client-node 2.0.1 → 2.2.0

package/README.md

@@ -21,14 +21,9 @@ First you need to get your API key from the Short.io dashboard in the [Integrati
 Then you need to set the configuration for the client:
 
 ```js
-import { client } from "@short.io/client-node";
+import { setApiKey } from "@short.io/client-node";
 
-client.setConfig({
-    baseUrl: "https://api.short.io",
-    headers: {
-        Authorization: "YOUR_API_KEY",
-    },
-});
+setApiKey("YOUR_API_KEY");
 ```
 
 ## Usage
@@ -37,17 +32,12 @@ Import the needed methods from the SDK and use them in your code:
 
 ```js
 import {
-    client,
     getApiDomains,
     getLinksExpand,
     // and other needed methods
 } from "@short.io/client-node";
-```
-
-Pass created client to the methods:
 
-```js
-const domainsResp = await getApiDomains({ client });
+const domainsResp = await getApiDomains();
 ```
 
 `domainsResp.data` will contain the list of domains.

package/dist/client/index.d.ts

@@ -0,0 +1,4 @@
+import type { Client, Config } from './types.js';
+export declare const createClient: (config?: Config) => Client;
+export type { Client, Config, Options, OptionsLegacyParser, RequestOptionsBase, RequestResult, } from './types.js';
+export { createConfig, formDataBodySerializer, jsonBodySerializer, type QuerySerializerOptions, urlSearchParamsBodySerializer, } from './utils.js';

package/dist/client/index.js

@@ -0,0 +1,115 @@
+import { createConfig, createInterceptors, createQuerySerializer, getParseAs, getUrl, mergeConfigs, mergeHeaders, } from './utils.js';
+export const createClient = (config = {}) => {
+    let _config = mergeConfigs(createConfig(), config);
+    const getConfig = () => ({ ..._config });
+    const setConfig = (config) => {
+        _config = mergeConfigs(_config, config);
+        return getConfig();
+    };
+    const buildUrl = (options) => {
+        const url = getUrl({
+            baseUrl: options.baseUrl ?? '',
+            path: options.path,
+            query: options.query,
+            querySerializer: typeof options.querySerializer === 'function'
+                ? options.querySerializer
+                : createQuerySerializer(options.querySerializer),
+            url: options.url,
+        });
+        return url;
+    };
+    const interceptors = createInterceptors();
+    const request = async (options) => {
+        const opts = {
+            ..._config,
+            ...options,
+            headers: mergeHeaders(_config.headers, options.headers),
+        };
+        if (opts.body && opts.bodySerializer) {
+            opts.body = opts.bodySerializer(opts.body);
+        }
+        if (!opts.body) {
+            opts.headers.delete('Content-Type');
+        }
+        const url = buildUrl(opts);
+        const requestInit = {
+            redirect: 'follow',
+            ...opts,
+        };
+        let request = new Request(url, requestInit);
+        for (const fn of interceptors.request._fns) {
+            request = await fn(request, opts);
+        }
+        const _fetch = opts.fetch;
+        let response = await _fetch(request);
+        for (const fn of interceptors.response._fns) {
+            response = await fn(response, request, opts);
+        }
+        const result = {
+            request,
+            response,
+        };
+        if (response.ok) {
+            if (response.status === 204 ||
+                response.headers.get('Content-Length') === '0') {
+                return {
+                    data: {},
+                    ...result,
+                };
+            }
+            if (opts.parseAs === 'stream') {
+                return {
+                    data: response.body,
+                    ...result,
+                };
+            }
+            const parseAs = (opts.parseAs === 'auto'
+                ? getParseAs(response.headers.get('Content-Type'))
+                : opts.parseAs) ?? 'json';
+            let data = await response[parseAs]();
+            if (parseAs === 'json' && opts.responseTransformer) {
+                data = await opts.responseTransformer(data);
+            }
+            return {
+                data,
+                ...result,
+            };
+        }
+        let error = await response.text();
+        try {
+            error = JSON.parse(error);
+        }
+        catch {
+        }
+        let finalError = error;
+        for (const fn of interceptors.error._fns) {
+            finalError = (await fn(error, response, request, opts));
+        }
+        finalError = finalError || {};
+        if (opts.throwOnError) {
+            throw finalError;
+        }
+        return {
+            error: finalError,
+            ...result,
+        };
+    };
+    return {
+        buildUrl,
+        connect: (options) => request({ ...options, method: 'CONNECT' }),
+        delete: (options) => request({ ...options, method: 'DELETE' }),
+        get: (options) => request({ ...options, method: 'GET' }),
+        getConfig,
+        head: (options) => request({ ...options, method: 'HEAD' }),
+        interceptors,
+        options: (options) => request({ ...options, method: 'OPTIONS' }),
+        patch: (options) => request({ ...options, method: 'PATCH' }),
+        post: (options) => request({ ...options, method: 'POST' }),
+        put: (options) => request({ ...options, method: 'PUT' }),
+        request,
+        setConfig,
+        trace: (options) => request({ ...options, method: 'TRACE' }),
+    };
+};
+export { createConfig, formDataBodySerializer, jsonBodySerializer, urlSearchParamsBodySerializer, } from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Client, Config, RequestOptions } from './types';\nimport {\n  createConfig,\n  createInterceptors,\n  createQuerySerializer,\n  getParseAs,\n  getUrl,\n  mergeConfigs,\n  mergeHeaders,\n} from './utils';\n\ntype ReqInit = Omit<RequestInit, 'body' | 'headers'> & {\n  body?: any;\n  headers: ReturnType<typeof mergeHeaders>;\n};\n\nexport const createClient = (config: Config = {}): Client => {\n  let _config = mergeConfigs(createConfig(), config);\n\n  const getConfig = (): Config => ({ ..._config });\n\n  const setConfig = (config: Config): Config => {\n    _config = mergeConfigs(_config, config);\n    return getConfig();\n  };\n\n  const buildUrl: Client['buildUrl'] = (options) => {\n    const url = getUrl({\n      baseUrl: options.baseUrl ?? '',\n      path: options.path,\n      query: options.query,\n      querySerializer:\n        typeof options.querySerializer === 'function'\n          ? options.querySerializer\n          : createQuerySerializer(options.querySerializer),\n      url: options.url,\n    });\n    return url;\n  };\n\n  const interceptors = createInterceptors<\n    Request,\n    Response,\n    unknown,\n    RequestOptions\n  >();\n\n  // @ts-expect-error\n  const request: Client['request'] = async (options) => {\n    // @ts-expect-error\n    const opts: RequestOptions = {\n      ..._config,\n      ...options,\n      headers: mergeHeaders(_config.headers, options.headers),\n    };\n    if (opts.body && opts.bodySerializer) {\n      opts.body = opts.bodySerializer(opts.body);\n    }\n\n    // remove Content-Type header if body is empty to avoid sending invalid requests\n    if (!opts.body) {\n      opts.headers.delete('Content-Type');\n    }\n\n    const url = buildUrl(opts);\n    const requestInit: ReqInit = {\n      redirect: 'follow',\n      ...opts,\n    };\n\n    let request = new Request(url, requestInit);\n\n    for (const fn of interceptors.request._fns) {\n      request = await fn(request, opts);\n    }\n\n    const _fetch = opts.fetch!;\n    let response = await _fetch(request);\n\n    for (const fn of interceptors.response._fns) {\n      response = await fn(response, request, opts);\n    }\n\n    const result = {\n      request,\n      response,\n    };\n\n    if (response.ok) {\n      if (\n        response.status === 204 ||\n        response.headers.get('Content-Length') === '0'\n      ) {\n        return {\n          data: {},\n          ...result,\n        };\n      }\n\n      if (opts.parseAs === 'stream') {\n        return {\n          data: response.body,\n          ...result,\n        };\n      }\n\n      const parseAs =\n        (opts.parseAs === 'auto'\n          ? getParseAs(response.headers.get('Content-Type'))\n          : opts.parseAs) ?? 'json';\n\n      let data = await response[parseAs]();\n      if (parseAs === 'json' && opts.responseTransformer) {\n        data = await opts.responseTransformer(data);\n      }\n\n      return {\n        data,\n        ...result,\n      };\n    }\n\n    let error = await response.text();\n\n    try {\n      error = JSON.parse(error);\n    } catch {\n      // noop\n    }\n\n    let finalError = error;\n\n    for (const fn of interceptors.error._fns) {\n      finalError = (await fn(error, response, request, opts)) as string;\n    }\n\n    finalError = finalError || ({} as string);\n\n    if (opts.throwOnError) {\n      throw finalError;\n    }\n\n    return {\n      error: finalError,\n      ...result,\n    };\n  };\n\n  return {\n    buildUrl,\n    connect: (options) => request({ ...options, method: 'CONNECT' }),\n    delete: (options) => request({ ...options, method: 'DELETE' }),\n    get: (options) => request({ ...options, method: 'GET' }),\n    getConfig,\n    head: (options) => request({ ...options, method: 'HEAD' }),\n    interceptors,\n    options: (options) => request({ ...options, method: 'OPTIONS' }),\n    patch: (options) => request({ ...options, method: 'PATCH' }),\n    post: (options) => request({ ...options, method: 'POST' }),\n    put: (options) => request({ ...options, method: 'PUT' }),\n    request,\n    setConfig,\n    trace: (options) => request({ ...options, method: 'TRACE' }),\n  };\n};\n\nexport type {\n  Client,\n  Config,\n  Options,\n  OptionsLegacyParser,\n  RequestOptionsBase,\n  RequestResult,\n} from './types';\nexport {\n  createConfig,\n  formDataBodySerializer,\n  jsonBodySerializer,\n  type QuerySerializerOptions,\n  urlSearchParamsBodySerializer,\n} from './utils';\n"]}

package/dist/client/types.d.ts

@@ -0,0 +1,78 @@
+import type { BodySerializer, Middleware, QuerySerializer, QuerySerializerOptions } from './utils.js';
+type OmitKeys<T, K> = Pick<T, Exclude<keyof T, K>>;
+export interface Config<ThrowOnError extends boolean = boolean> extends Omit<RequestInit, 'body' | 'headers' | 'method'> {
+    baseUrl?: string;
+    body?: RequestInit['body'] | Record<string, unknown> | Array<Record<string, unknown>> | Array<unknown> | number;
+    bodySerializer?: BodySerializer;
+    fetch?: (request: Request) => ReturnType<typeof fetch>;
+    headers?: RequestInit['headers'] | Record<string, string | number | boolean | (string | number | boolean)[] | null | undefined | unknown>;
+    method?: 'CONNECT' | 'DELETE' | 'GET' | 'HEAD' | 'OPTIONS' | 'PATCH' | 'POST' | 'PUT' | 'TRACE';
+    parseAs?: Exclude<keyof Body, 'body' | 'bodyUsed'> | 'auto' | 'stream';
+    querySerializer?: QuerySerializer | QuerySerializerOptions;
+    responseTransformer?: (data: unknown) => Promise<unknown>;
+    throwOnError?: ThrowOnError;
+}
+export interface RequestOptionsBase<ThrowOnError extends boolean, Url extends string = string> extends Config<ThrowOnError> {
+    path?: Record<string, unknown>;
+    query?: Record<string, unknown>;
+    url: Url;
+}
+export type RequestResult<Data = unknown, TError = unknown, ThrowOnError extends boolean = boolean> = ThrowOnError extends true ? Promise<{
+    data: Data;
+    request: Request;
+    response: Response;
+}> : Promise<({
+    data: Data;
+    error: undefined;
+} | {
+    data: undefined;
+    error: TError;
+}) & {
+    request: Request;
+    response: Response;
+}>;
+type MethodFn = <Data = unknown, TError = unknown, ThrowOnError extends boolean = false>(options: Omit<RequestOptionsBase<ThrowOnError>, 'method'>) => RequestResult<Data, TError, ThrowOnError>;
+type RequestFn = <Data = unknown, TError = unknown, ThrowOnError extends boolean = false>(options: Omit<RequestOptionsBase<ThrowOnError>, 'method'> & Pick<Required<RequestOptionsBase<ThrowOnError>>, 'method'>) => RequestResult<Data, TError, ThrowOnError>;
+export interface Client<Req = Request, Res = Response, Err = unknown, Opts = RequestOptions> {
+    buildUrl: <T extends {
+        url: string;
+    }>(options: T & Options<T>) => string;
+    connect: MethodFn;
+    delete: MethodFn;
+    get: MethodFn;
+    getConfig: () => Config;
+    head: MethodFn;
+    interceptors: Middleware<Req, Res, Err, Opts>;
+    options: MethodFn;
+    patch: MethodFn;
+    post: MethodFn;
+    put: MethodFn;
+    request: RequestFn;
+    setConfig: (config: Config) => Config;
+    trace: MethodFn;
+}
+export type RequestOptions = RequestOptionsBase<false> & Config<false> & {
+    headers: Headers;
+};
+type OptionsBase<ThrowOnError extends boolean> = Omit<RequestOptionsBase<ThrowOnError>, 'url'> & {
+    client?: Client;
+};
+export type Options<T extends {
+    url: string;
+} = {
+    url: string;
+}, ThrowOnError extends boolean = boolean> = T extends {
+    body?: any;
+} ? T extends {
+    headers?: any;
+} ? OmitKeys<OptionsBase<ThrowOnError>, 'body' | 'headers'> & Omit<T, 'url'> : OmitKeys<OptionsBase<ThrowOnError>, 'body'> & Omit<T, 'url'> & Pick<OptionsBase<ThrowOnError>, 'headers'> : T extends {
+    headers?: any;
+} ? OmitKeys<OptionsBase<ThrowOnError>, 'headers'> & Omit<T, 'url'> & Pick<OptionsBase<ThrowOnError>, 'body'> : OptionsBase<ThrowOnError> & Omit<T, 'url'>;
+export type OptionsLegacyParser<T = unknown, ThrowOnError extends boolean = boolean> = T extends {
+    body?: any;
+} ? T extends {
+    headers?: any;
+} ? OmitKeys<OptionsBase<ThrowOnError>, 'body' | 'headers'> & T : OmitKeys<OptionsBase<ThrowOnError>, 'body'> & T & Pick<OptionsBase<ThrowOnError>, 'headers'> : T extends {
+    headers?: any;
+} ? OmitKeys<OptionsBase<ThrowOnError>, 'headers'> & T & Pick<OptionsBase<ThrowOnError>, 'body'> : OptionsBase<ThrowOnError> & T;
+export {};

package/dist/client/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  BodySerializer,\n  Middleware,\n  QuerySerializer,\n  QuerySerializerOptions,\n} from './utils';\n\ntype OmitKeys<T, K> = Pick<T, Exclude<keyof T, K>>;\n\nexport interface Config<ThrowOnError extends boolean = boolean>\n  extends Omit<RequestInit, 'body' | 'headers' | 'method'> {\n  /**\n   * Base URL for all requests made by this client.\n   * @default ''\n   */\n  baseUrl?: string;\n  /**\n   * Any body that you want to add to your request.\n   *\n   * {@link https://developer.mozilla.org/docs/Web/API/fetch#body}\n   */\n  body?:\n    | RequestInit['body']\n    | Record<string, unknown>\n    | Array<Record<string, unknown>>\n    | Array<unknown>\n    | number;\n  /**\n   * A function for serializing request body parameter. By default,\n   * {@link JSON.stringify()} will be used.\n   */\n  bodySerializer?: BodySerializer;\n  /**\n   * Fetch API implementation. You can use this option to provide a custom\n   * fetch instance.\n   * @default globalThis.fetch\n   */\n  fetch?: (request: Request) => ReturnType<typeof fetch>;\n  /**\n   * An object containing any HTTP headers that you want to pre-populate your\n   * `Headers` object with.\n   *\n   * {@link https://developer.mozilla.org/docs/Web/API/Headers/Headers#init See more}\n   */\n  headers?:\n    | RequestInit['headers']\n    | Record<\n        string,\n        | string\n        | number\n        | boolean\n        | (string | number | boolean)[]\n        | null\n        | undefined\n        | unknown\n      >;\n  /**\n   * The request method.\n   *\n   * {@link https://developer.mozilla.org/docs/Web/API/fetch#method See more}\n   */\n  method?:\n    | 'CONNECT'\n    | 'DELETE'\n    | 'GET'\n    | 'HEAD'\n    | 'OPTIONS'\n    | 'PATCH'\n    | 'POST'\n    | 'PUT'\n    | 'TRACE';\n  /**\n   * Return the response data parsed in a specified format. By default, `auto`\n   * will infer the appropriate method from the `Content-Type` response header.\n   * You can override this behavior with any of the {@link Body} methods.\n   * Select `stream` if you don't want to parse response data at all.\n   * @default 'auto'\n   */\n  parseAs?: Exclude<keyof Body, 'body' | 'bodyUsed'> | 'auto' | 'stream';\n  /**\n   * A function for serializing request query parameters. By default, arrays\n   * will be exploded in form style, objects will be exploded in deepObject\n   * style, and reserved characters are percent-encoded.\n   *\n   * {@link https://swagger.io/docs/specification/serialization/#query View examples}\n   */\n  querySerializer?: QuerySerializer | QuerySerializerOptions;\n  /**\n   * A function for transforming response data before it's returned to the\n   * caller function. This is an ideal place to post-process server data,\n   * e.g. convert date ISO strings into native Date objects.\n   */\n  responseTransformer?: (data: unknown) => Promise<unknown>;\n  /**\n   * Throw an error instead of returning it in the response?\n   * @default false\n   */\n  throwOnError?: ThrowOnError;\n}\n\nexport interface RequestOptionsBase<\n  ThrowOnError extends boolean,\n  Url extends string = string,\n> extends Config<ThrowOnError> {\n  path?: Record<string, unknown>;\n  query?: Record<string, unknown>;\n  url: Url;\n}\n\nexport type RequestResult<\n  Data = unknown,\n  TError = unknown,\n  ThrowOnError extends boolean = boolean,\n> = ThrowOnError extends true\n  ? Promise<{\n      data: Data;\n      request: Request;\n      response: Response;\n    }>\n  : Promise<\n      (\n        | { data: Data; error: undefined }\n        | { data: undefined; error: TError }\n      ) & {\n        request: Request;\n        response: Response;\n      }\n    >;\n\ntype MethodFn = <\n  Data = unknown,\n  TError = unknown,\n  ThrowOnError extends boolean = false,\n>(\n  options: Omit<RequestOptionsBase<ThrowOnError>, 'method'>,\n) => RequestResult<Data, TError, ThrowOnError>;\n\ntype RequestFn = <\n  Data = unknown,\n  TError = unknown,\n  ThrowOnError extends boolean = false,\n>(\n  options: Omit<RequestOptionsBase<ThrowOnError>, 'method'> &\n    Pick<Required<RequestOptionsBase<ThrowOnError>>, 'method'>,\n) => RequestResult<Data, TError, ThrowOnError>;\n\nexport interface Client<\n  Req = Request,\n  Res = Response,\n  Err = unknown,\n  Opts = RequestOptions,\n> {\n  /**\n   * Returns the final request URL. This method works only with experimental parser.\n   */\n  buildUrl: <T extends { url: string }>(options: T & Options<T>) => string;\n  connect: MethodFn;\n  delete: MethodFn;\n  get: MethodFn;\n  getConfig: () => Config;\n  head: MethodFn;\n  interceptors: Middleware<Req, Res, Err, Opts>;\n  options: MethodFn;\n  patch: MethodFn;\n  post: MethodFn;\n  put: MethodFn;\n  request: RequestFn;\n  setConfig: (config: Config) => Config;\n  trace: MethodFn;\n}\n\nexport type RequestOptions = RequestOptionsBase<false> &\n  Config<false> & {\n    headers: Headers;\n  };\n\ntype OptionsBase<ThrowOnError extends boolean> = Omit<\n  RequestOptionsBase<ThrowOnError>,\n  'url'\n> & {\n  /**\n   * You can provide a client instance returned by `createClient()` instead of\n   * individual options. This might be also useful if you want to implement a\n   * custom client.\n   */\n  client?: Client;\n};\n\nexport type Options<\n  T extends { url: string } = { url: string },\n  ThrowOnError extends boolean = boolean,\n> = T extends { body?: any }\n  ? T extends { headers?: any }\n    ? OmitKeys<OptionsBase<ThrowOnError>, 'body' | 'headers'> & Omit<T, 'url'>\n    : OmitKeys<OptionsBase<ThrowOnError>, 'body'> &\n        Omit<T, 'url'> &\n        Pick<OptionsBase<ThrowOnError>, 'headers'>\n  : T extends { headers?: any }\n    ? OmitKeys<OptionsBase<ThrowOnError>, 'headers'> &\n        Omit<T, 'url'> &\n        Pick<OptionsBase<ThrowOnError>, 'body'>\n    : OptionsBase<ThrowOnError> & Omit<T, 'url'>;\n\nexport type OptionsLegacyParser<\n  T = unknown,\n  ThrowOnError extends boolean = boolean,\n> = T extends { body?: any }\n  ? T extends { headers?: any }\n    ? OmitKeys<OptionsBase<ThrowOnError>, 'body' | 'headers'> & T\n    : OmitKeys<OptionsBase<ThrowOnError>, 'body'> &\n        T &\n        Pick<OptionsBase<ThrowOnError>, 'headers'>\n  : T extends { headers?: any }\n    ? OmitKeys<OptionsBase<ThrowOnError>, 'headers'> &\n        T &\n        Pick<OptionsBase<ThrowOnError>, 'body'>\n    : OptionsBase<ThrowOnError> & T;\n"]}

package/dist/client/utils.d.ts

@@ -0,0 +1,57 @@
+import type { Config } from './types.js';
+type ArrayStyle = 'form' | 'spaceDelimited' | 'pipeDelimited';
+type ObjectStyle = 'form' | 'deepObject';
+export type QuerySerializer = (query: Record<string, unknown>) => string;
+export type BodySerializer = (body: any) => any;
+interface SerializerOptions<T> {
+    explode: boolean;
+    style: T;
+}
+export interface QuerySerializerOptions {
+    allowReserved?: boolean;
+    array?: SerializerOptions<ArrayStyle>;
+    object?: SerializerOptions<ObjectStyle>;
+}
+export declare const createQuerySerializer: <T = unknown>({ allowReserved, array, object, }?: QuerySerializerOptions) => (queryParams: T) => string;
+export declare const getParseAs: (contentType: string | null) => Exclude<Config["parseAs"], "auto" | "stream">;
+export declare const getUrl: ({ baseUrl, path, query, querySerializer, url: _url, }: {
+    baseUrl: string;
+    path?: Record<string, unknown>;
+    query?: Record<string, unknown>;
+    querySerializer: QuerySerializer;
+    url: string;
+}) => string;
+export declare const mergeConfigs: (a: Config, b: Config) => Config;
+export declare const mergeHeaders: (...headers: Array<Required<Config>["headers"] | undefined>) => Headers;
+type ErrInterceptor<Err, Res, Req, Options> = (error: Err, response: Res, request: Req, options: Options) => Err | Promise<Err>;
+type ReqInterceptor<Req, Options> = (request: Req, options: Options) => Req | Promise<Req>;
+type ResInterceptor<Res, Req, Options> = (response: Res, request: Req, options: Options) => Res | Promise<Res>;
+declare class Interceptors<Interceptor> {
+    _fns: Interceptor[];
+    constructor();
+    clear(): void;
+    exists(fn: Interceptor): boolean;
+    eject(fn: Interceptor): void;
+    use(fn: Interceptor): void;
+}
+export interface Middleware<Req, Res, Err, Options> {
+    error: Pick<Interceptors<ErrInterceptor<Err, Res, Req, Options>>, 'eject' | 'use'>;
+    request: Pick<Interceptors<ReqInterceptor<Req, Options>>, 'eject' | 'use'>;
+    response: Pick<Interceptors<ResInterceptor<Res, Req, Options>>, 'eject' | 'use'>;
+}
+export declare const createInterceptors: <Req, Res, Err, Options>() => {
+    error: Interceptors<ErrInterceptor<Err, Res, Req, Options>>;
+    request: Interceptors<ReqInterceptor<Req, Options>>;
+    response: Interceptors<ResInterceptor<Res, Req, Options>>;
+};
+export declare const formDataBodySerializer: {
+    bodySerializer: <T extends Record<string, any> | Array<Record<string, any>>>(body: T) => FormData;
+};
+export declare const jsonBodySerializer: {
+    bodySerializer: <T>(body: T) => string;
+};
+export declare const urlSearchParamsBodySerializer: {
+    bodySerializer: <T extends Record<string, any> | Array<Record<string, any>>>(body: T) => URLSearchParams;
+};
+export declare const createConfig: (override?: Config) => Config;
+export {};