@lifi/perps-sdk 0.1.1-alpha.9 → 1.0.0

package/dist/esm/transport/request.js

@@ -0,0 +1,82 @@
+import { PerpsErrorCode } from '@lifi/perps-types';
+import { PerpsError } from '../errors/PerpsError.js';
+import { version } from '../version.js';
+import { fetchWithRetry } from './fetchWithRetry.js';
+import { LIFI_REQUEST_KEY, LIFI_RETRY_DEFAULTS, resolveRetryPolicy, } from './retryPolicy.js';
+/**
+ * Internal HTTP helper: applies SDK headers, retry policy, and the request
+ * interceptor, then normalizes failures into {@link PerpsError}.
+ *
+ * @internal
+ */
+export async function request(config, url, options = {}, sdkOptions) {
+    const { retry, ...fetchInit } = options;
+    const policy = retry !== undefined
+        ? resolveRetryPolicy(LIFI_RETRY_DEFAULTS, retry, LIFI_REQUEST_KEY)
+        : resolveRetryPolicy(LIFI_RETRY_DEFAULTS, config.retry, LIFI_REQUEST_KEY);
+    const headers = {
+        'Content-Type': 'application/json',
+        'x-lifi-integrator': config.integrator,
+        'x-lifi-perps-sdk': version,
+        ...fetchInit.headers,
+    };
+    if (config.apiKey) {
+        headers['x-lifi-api-key'] = config.apiKey;
+    }
+    let finalOptions = {
+        ...fetchInit,
+        headers,
+        signal: sdkOptions?.signal ?? fetchInit.signal,
+    };
+    if (config.requestInterceptor) {
+        finalOptions = await config.requestInterceptor(url, finalOptions);
+    }
+    try {
+        const response = await fetchWithRetry(url, finalOptions, {
+            policy,
+            fetchImpl: config.fetch,
+            signal: sdkOptions?.signal ?? finalOptions.signal ?? undefined,
+        });
+        if (!response.ok) {
+            let body;
+            try {
+                body = await response.json();
+            }
+            catch { }
+            const fallbackMessage = `Request failed with status code ${response.status}`;
+            if (body &&
+                typeof body.code === 'number' &&
+                typeof body.message === 'string') {
+                const error = new PerpsError(body.code, body.message);
+                error.tool = body.tool ?? 'unknown';
+                throw error;
+            }
+            const error = new PerpsError(PerpsErrorCode.DefaultError, fallbackMessage);
+            error.tool = 'unknown';
+            throw error;
+        }
+        return (await response.json());
+    }
+    catch (error) {
+        if (error instanceof PerpsError) {
+            throw error;
+        }
+        throw new PerpsError(PerpsErrorCode.ServerError, error instanceof Error ? error.message : 'Request failed');
+    }
+}
+/**
+ * Build a URL with a query string from defined params (skips `undefined`).
+ *
+ * @internal
+ */
+export function buildUrl(baseUrl, params) {
+    const searchParams = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined) {
+            searchParams.set(key, String(value));
+        }
+    }
+    const queryString = searchParams.toString();
+    return queryString ? `${baseUrl}?${queryString}` : baseUrl;
+}
+//# sourceMappingURL=request.js.map

package/dist/esm/transport/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../../src/transport/request.ts"],"names":[],"mappings":"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"}

package/dist/esm/transport/retryPolicy.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Provider key for LI.FI-backend-proxied requests in a
+ * {@link ProviderRetryConfig}.
+ *
+ * @public
+ */
+export declare const LIFI_REQUEST_KEY: "lifi";
+/**
+ * Outcome of classifying a response/error for retry: the three `retry-*`
+ * variants are retriable; `'fail'` is terminal.
+ *
+ * @public
+ */
+export type RetryClassification = 'retry-rate-limit' | 'retry-server' | 'retry-network' | 'fail';
+/**
+ * Context passed to a {@link RetryPolicy.classify} callback.
+ *
+ * @public
+ */
+export interface RetryClassifyContext {
+    response: Response;
+}
+/**
+ * Context passed to a {@link RetryPolicy.shouldRetry} callback for each
+ * attempt.
+ *
+ * @public
+ */
+export interface RetryAttemptContext {
+    attempt: number;
+    response?: Response;
+    error?: unknown;
+    classification: RetryClassification;
+}
+/**
+ * User-supplied retry tuning. All fields optional — anything left unset
+ * inherits the built-in default for the target provider. `classify` returning
+ * `undefined` defers to the base classifier; returning `'fail'` short-circuits
+ * retry. `shouldRetry` runs after `classify` has already decided to retry and
+ * gives a final yes/no per attempt.
+ *
+ * @public
+ */
+export interface RetryPolicy {
+    maxAttempts?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    respectRetryAfter?: boolean;
+    classify?: (ctx: RetryClassifyContext) => RetryClassification | undefined;
+    shouldRetry?: (ctx: RetryAttemptContext) => boolean | Promise<boolean>;
+}
+/**
+ * A fully resolved retry policy with every field populated — the form
+ * {@link fetchWithRetry} consumes.
+ *
+ * @public
+ */
+export interface ResolvedRetryPolicy {
+    enabled: boolean;
+    maxAttempts: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+    respectRetryAfter: boolean;
+    classify: (ctx: RetryClassifyContext) => RetryClassification;
+    shouldRetry?: (ctx: RetryAttemptContext) => boolean | Promise<boolean>;
+}
+/**
+ * Per-provider overrides keyed by the provider plugin's `type` (e.g. `'hyperliquid'`,
+ * `'lighter'`), plus `'lifi'` for backend-proxied requests. `default` is the
+ * fallback applied to any provider not explicitly listed.
+ *
+ * @public
+ */
+export interface ProviderRetryConfig {
+    default?: RetryPolicy | false;
+    [providerKey: string]: RetryPolicy | false | undefined;
+}
+/**
+ * Top-level `retry` option: a flat {@link RetryPolicy} for all providers,
+ * `false` to disable retries, or a per-provider {@link ProviderRetryConfig}.
+ *
+ * @public
+ */
+export type RetryConfig = RetryPolicy | false | ProviderRetryConfig;
+/**
+ * Built-in default retry policy for LI.FI-backend requests.
+ *
+ * @public
+ */
+export declare const LIFI_RETRY_DEFAULTS: ResolvedRetryPolicy;
+/**
+ * A resolved policy that performs a single attempt with no retries.
+ *
+ * @public
+ */
+export declare const DISABLED_RETRY: ResolvedRetryPolicy;
+/**
+ * Merge a user-supplied {@link RetryConfig} onto a provider's built-in default.
+ * Resolution order when `config` is a {@link ProviderRetryConfig}:
+ * `config[providerKey]` → `config.default` → `base`. A flat {@link RetryPolicy}
+ * applies to every provider. `false` (at any level) disables retries entirely.
+ *
+ * @public
+ */
+export declare function resolveRetryPolicy(base: ResolvedRetryPolicy, config: RetryConfig | undefined, providerKey: string): ResolvedRetryPolicy;
+//# sourceMappingURL=retryPolicy.d.ts.map

package/dist/esm/transport/retryPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retryPolicy.d.ts","sourceRoot":"","sources":["../../../src/transport/retryPolicy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAG,MAAe,CAAA;AAE/C;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAC3B,kBAAkB,GAClB,cAAc,GACd,eAAe,GACf,MAAM,CAAA;AAEV;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,QAAQ,CAAA;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,cAAc,EAAE,mBAAmB,CAAA;CACpC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,oBAAoB,KAAK,mBAAmB,GAAG,SAAS,CAAA;IACzE,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,mBAAmB,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACvE;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,QAAQ,EAAE,CAAC,GAAG,EAAE,oBAAoB,KAAK,mBAAmB,CAAA;IAC5D,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,mBAAmB,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACvE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,WAAW,GAAG,KAAK,CAAA;IAC7B,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,KAAK,GAAG,SAAS,CAAA;CACvD;AAED;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,KAAK,GAAG,mBAAmB,CAAA;AAEnE;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,mBAejC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,mBAO5B,CAAA;AAyCD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,mBAAmB,EACzB,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,WAAW,EAAE,MAAM,GAClB,mBAAmB,CAkBrB"}

package/dist/esm/transport/retryPolicy.js

@@ -0,0 +1,99 @@
+/**
+ * Provider key for LI.FI-backend-proxied requests in a
+ * {@link ProviderRetryConfig}.
+ *
+ * @public
+ */
+export const LIFI_REQUEST_KEY = 'lifi';
+/**
+ * Built-in default retry policy for LI.FI-backend requests.
+ *
+ * @public
+ */
+export const LIFI_RETRY_DEFAULTS = {
+    enabled: true,
+    maxAttempts: 3,
+    baseDelayMs: 500,
+    maxDelayMs: 5_000,
+    respectRetryAfter: true,
+    classify: ({ response }) => {
+        if (response.status === 429) {
+            return 'retry-rate-limit';
+        }
+        if (response.status >= 500 && response.status <= 599) {
+            return 'retry-server';
+        }
+        return 'fail';
+    },
+};
+/**
+ * A resolved policy that performs a single attempt with no retries.
+ *
+ * @public
+ */
+export const DISABLED_RETRY = {
+    enabled: false,
+    maxAttempts: 1,
+    baseDelayMs: 0,
+    maxDelayMs: 0,
+    respectRetryAfter: false,
+    classify: () => 'fail',
+};
+function isProviderRetryConfig(input) {
+    if ('maxAttempts' in input ||
+        'baseDelayMs' in input ||
+        'maxDelayMs' in input ||
+        'respectRetryAfter' in input ||
+        'classify' in input ||
+        'shouldRetry' in input) {
+        return false;
+    }
+    return true;
+}
+function mergePolicy(base, override) {
+    if (override === false) {
+        return DISABLED_RETRY;
+    }
+    if (!override) {
+        return base;
+    }
+    return {
+        enabled: true,
+        maxAttempts: override.maxAttempts ?? base.maxAttempts,
+        baseDelayMs: override.baseDelayMs ?? base.baseDelayMs,
+        maxDelayMs: override.maxDelayMs ?? base.maxDelayMs,
+        respectRetryAfter: override.respectRetryAfter ?? base.respectRetryAfter,
+        classify: override.classify
+            ? (ctx) => override.classify?.(ctx) ?? base.classify(ctx)
+            : base.classify,
+        shouldRetry: override.shouldRetry ?? base.shouldRetry,
+    };
+}
+/**
+ * Merge a user-supplied {@link RetryConfig} onto a provider's built-in default.
+ * Resolution order when `config` is a {@link ProviderRetryConfig}:
+ * `config[providerKey]` → `config.default` → `base`. A flat {@link RetryPolicy}
+ * applies to every provider. `false` (at any level) disables retries entirely.
+ *
+ * @public
+ */
+export function resolveRetryPolicy(base, config, providerKey) {
+    if (config === undefined) {
+        return base;
+    }
+    if (config === false) {
+        return DISABLED_RETRY;
+    }
+    if (isProviderRetryConfig(config)) {
+        const perProvider = config[providerKey];
+        if (perProvider !== undefined) {
+            return mergePolicy(base, perProvider);
+        }
+        if (config.default !== undefined) {
+            return mergePolicy(base, config.default);
+        }
+        return base;
+    }
+    return mergePolicy(base, config);
+}
+//# sourceMappingURL=retryPolicy.js.map

package/dist/esm/transport/retryPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retryPolicy.js","sourceRoot":"","sources":["../../../src/transport/retryPolicy.ts"],"names":[],"mappings":"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"}

package/dist/esm/types/api.d.ts

@@ -0,0 +1,214 @@
+import type { AccountConfigSetting, AccountResponse, ActionStep, ExecuteActionResponse, MarketRef, ModifyOrderInput, OrderSide, OrderType, SignedActionStep, TimeInForce, TriggerOrderInput, WithdrawalParams } from '@lifi/perps-types';
+import type { Account, Address, WalletClient } from 'viem';
+import type { RetryConfig } from '../transport/retryPolicy.js';
+import type { ProviderConfigs, RequestInterceptor } from './config.js';
+import type { PerpsProviderPlugin } from './provider.js';
+/**
+ * Configuration for {@link createPerpsClient}.
+ *
+ * @public
+ */
+export interface PerpsConfig {
+    integrator: string;
+    apiKey: string;
+    apiUrl?: string;
+    disableVersionCheck?: boolean;
+    requestInterceptor?: RequestInterceptor;
+    /**
+     * Provider plugins or per-provider config. Two shapes are accepted:
+     *
+     * - `PerpsProviderPlugin[]` — plugin objects implementing the read surface
+     *   for one DEX each. Bound to the client at construction and looked up at
+     *   runtime as bound {@link PerpsProvider}s via `client.getProvider(key)`.
+     *   Modelled on `@lifi/sdk`'s `providers: SDKProvider[]`.
+     * - `ProviderConfigs` — keyed config object (e.g.
+     *   `{ hyperliquid: { markets: [...] } }`). Used internally by
+     *   `PerpsWsClient` to filter which markets are subscribed to.
+     *
+     * Both may be supplied during the migration to provider packages;
+     * the array form is preferred for new code.
+     */
+    providers?: PerpsProviderPlugin[] | ProviderConfigs;
+    /**
+     * The end-user's wallet, used whenever an action's descriptor names the user
+     * wallet in its `signers` list. Accepts any viem-compatible WalletClient:
+     *   - Browser wallet: wagmi's useWalletClient() result
+     *   - Private key:    createWalletClient({ account: privateKeyToAccount('0x...'), transport: http() })
+     *   - Mnemonic:       createWalletClient({ account: mnemonicToAccount('word1 ...'), transport: http() })
+     */
+    userWallet?: WalletClient<any, any, Account>;
+    /**
+     * Retry behaviour for HTTP requests. Pass `false` to disable retries
+     * everywhere (single-shot — useful when wrapping with TanStack Query or
+     * similar consumer-side retry). Pass a flat {@link RetryPolicy} to apply
+     * one policy across providers, or a per-provider object keyed by provider
+     * type (`'lifi'`, `'hyperliquid'`, `'lighter'`) with an optional `default`
+     * fallback. Per-provider built-in defaults apply when omitted.
+     */
+    retry?: RetryConfig;
+    /**
+     * Replace the global `fetch` used by the SDK and provider HTTP clients —
+     * for instrumentation, custom proxying, or test injection. Does not affect
+     * retry policy.
+     */
+    fetch?: typeof fetch;
+}
+/**
+ * Options for PerpsClient constructor.
+ *
+ * @public
+ */
+export interface PerpsClientOptions {
+    integrator: string;
+    /** API key for authenticated requests (get one at https://portal.li.fi/) */
+    apiKey: string;
+    /** Defaults to DEFAULT_API_URL */
+    apiUrl?: string;
+    /**
+     * Provider plugins or per-provider config. Accepts the same two shapes as
+     * {@link PerpsConfig.providers}: an array of `PerpsProviderPlugin` plugins or
+     * a keyed `ProviderConfigs` map.
+     */
+    providers?: PerpsProviderPlugin[] | ProviderConfigs;
+}
+/**
+ * Parameters for the internal `buildProviderSetup` helper that materialises
+ * typed-data envelopes for the setup descriptors.
+ *
+ * @public
+ */
+export interface BuildProviderSetupParams {
+    provider: string;
+    address: Address;
+}
+/**
+ * Parameters for placing an order.
+ *
+ * @public
+ */
+export interface PlaceOrderParams {
+    provider: string;
+    address: Address;
+    market: MarketRef;
+    side: OrderSide;
+    type: OrderType;
+    size: string;
+    price: string;
+    leverage?: number;
+    reduceOnly?: boolean;
+    timeInForce?: TimeInForce;
+    expiresAt?: string;
+    takeProfit?: TriggerOrderInput;
+    stopLoss?: TriggerOrderInput;
+}
+/**
+ * Parameters for placing trigger-only orders (TP/SL on existing positions).
+ * Sends a TRIGGER_ONLY order that skips the main order wire.
+ *
+ * @public
+ */
+export interface PlaceTriggerOrderParams {
+    provider: string;
+    address: Address;
+    market: MarketRef;
+    side: OrderSide;
+    takeProfit?: TriggerOrderInput;
+    stopLoss?: TriggerOrderInput;
+}
+/**
+ * Parameters for withdrawing funds.
+ *
+ * @public
+ */
+export interface WithdrawParams {
+    provider: string;
+    address: Address;
+    withdrawal: WithdrawalParams;
+}
+/**
+ * Parameters for canceling orders.
+ *
+ * @public
+ */
+export interface CancelOrdersParams {
+    provider: string;
+    address: Address;
+    ids: string[];
+}
+/**
+ * Parameters for modifying orders.
+ *
+ * @public
+ */
+export interface ModifyOrdersParams {
+    provider: string;
+    address: Address;
+    modifications: ModifyOrderInput[];
+}
+/**
+ * Parameters for {@link PerpsClient.checkSetup}.
+ *
+ * @public
+ */
+export interface GetSetupParams {
+    provider: string;
+    address: Address;
+}
+/**
+ * Result from {@link PerpsClient.checkSetup}.
+ *
+ * Reports the unsatisfied entries on `Provider.setup` for the queried account
+ * as a flat list — each `ActionStep` is self-describing (its action keys back
+ * to the provider's `setup` descriptor, which declares the step's signer and
+ * scheme), so no signer-role partition is exposed here.
+ *
+ * `Provider.options` items are NEVER included here — they don't gate trading
+ * and are surfaced separately via `getAccount().settings`.
+ *
+ * @public
+ */
+export interface ProviderSetup {
+    /** Unsatisfied setup steps, ordered by descriptor `sequence`. */
+    setup: ActionStep[];
+    /** Whether all setup items are already satisfied (ready to trade) */
+    isReady: boolean;
+}
+/**
+ * Parameters for {@link PerpsClient.executeProviderSetup}.
+ *
+ * @public
+ */
+export interface ExecuteProviderSetupParams {
+    /** Provider to satisfy setup for */
+    provider: string;
+    /** User wallet address */
+    address: Address;
+    /** The unsatisfied setup steps from checkSetup() */
+    setup: ActionStep[];
+    /** Signed counterparts of `setup`, in the same order */
+    signedActions: SignedActionStep[];
+}
+/**
+ * Result from {@link PerpsClient.executeProviderSetup}.
+ *
+ * @public
+ */
+export interface ExecuteProviderSetupResult {
+    results: ExecuteActionResponse;
+}
+/**
+ * Result envelope returned by {@link PerpsClient.getAccount} — wraps the
+ * backend's `AccountResponse` with a single SDK-projected `settings` array.
+ *
+ * `settings` contains exactly one `AccountConfigSetting` per descriptor on
+ * `Provider.setup` + `Provider.options` (in that order). Index the
+ * projection by `setting.type === descriptor.type` and read
+ * `setting.values[i].value` for each `Param` the descriptor declared.
+ *
+ * @public
+ */
+export interface GetAccountResult extends AccountResponse {
+    /** SDK-projected current state of every setup + options descriptor. */
+    settings: AccountConfigSetting[];
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/esm/types/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/types/api.ts"],"names":[],"mappings":"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"}

package/dist/esm/types/api.js

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

package/dist/esm/types/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/types/api.ts"],"names":[],"mappings":""}

package/dist/esm/types/config.d.ts

@@ -0,0 +1,70 @@
+import type { Account, WalletClient } from 'viem';
+import type { RetryConfig } from '../transport/retryPolicy.js';
+/**
+ * Viem `WalletClient` shape used by `PerpsSDKClient.userWallet`. Aliased here
+ * so provider plugins can name the type without re-deriving the viem generics.
+ *
+ * @public
+ */
+export type PerpsClientSigner = WalletClient<any, any, Account>;
+/**
+ * Per-provider config — restricts which `markets` the WS client subscribes
+ * to. Indexed by provider key.
+ *
+ * @public
+ */
+export interface ProviderConfig {
+    markets?: string[];
+}
+/**
+ * @deprecated Use {@link ProviderConfig}.
+ * @public
+ */
+export type HyperliquidConfig = ProviderConfig;
+/**
+ * Map of per-provider {@link ProviderConfig}, keyed by provider key.
+ *
+ * @public
+ */
+export interface ProviderConfigs {
+    [provider: string]: ProviderConfig | undefined;
+}
+/**
+ * Hook to rewrite each outgoing request's URL/`RequestInit` before it is sent.
+ *
+ * @public
+ */
+export type RequestInterceptor = (url: string, options: RequestInit) => RequestInit | Promise<RequestInit>;
+/**
+ * Per-call request options threaded through the service functions.
+ *
+ * @public
+ */
+export interface SDKRequestOptions {
+    signal?: AbortSignal;
+    /**
+     * Lighter auth token consumed by provider-direct venue reads (getOrders,
+     * getOrder, getActivity, getAccount). Create via
+     * `lighterSigner.createAuthToken(deadline, context)`. Sent only to Lighter
+     * venue endpoints, never to the LI.FI backend — read-only by design
+     * (8h max TTL, cannot authorize writes).
+     */
+    lighterAuthToken?: string;
+}
+/**
+ * Immutable snapshot of the resolved client configuration after defaults
+ * are applied. Exposed via {@link PerpsSDKClient.config}.
+ *
+ * @public
+ */
+export interface PerpsBaseConfig {
+    integrator: string;
+    apiKey: string;
+    apiUrl: string;
+    disableVersionCheck?: boolean;
+    requestInterceptor?: RequestInterceptor;
+    providers?: ProviderConfigs;
+    retry?: RetryConfig;
+    fetch?: typeof fetch;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/esm/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/types/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAE9D;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,CAAA;AAE/D;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAA;AAE9C;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAA;CAC/C;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,WAAW,KACjB,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;AAEvC;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CACrB"}

package/dist/esm/types/config.js

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

package/dist/esm/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/types/config.ts"],"names":[],"mappings":""}