quickbase-js 1.2.0 → 2.0.0-alpha.2

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAGrE,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpF,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,oBAAoB,EACpB,KAAK,EACL,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAUpB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,mBAAmB,GACpB,MAAM,iBAAiB,CAAC"}

package/dist/client/pagination.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Pagination support with fluent API
+ *
+ * Provides automatic pagination for QuickBase API endpoints that return
+ * paginated results. Supports both skip-based and token-based pagination.
+ *
+ * @example
+ * ```typescript
+ * // Fetch single page (default)
+ * const page = await client.runQuery({ ... });
+ *
+ * // Fetch all pages automatically
+ * const all = await client.runQuery({ ... }).all();
+ *
+ * // Fetch with record limit
+ * const limited = await client.runQuery({ ... }).paginate({ limit: 500 });
+ *
+ * // Explicitly single page (if autoPaginate is enabled globally)
+ * const single = await client.runQuery({ ... }).noPaginate();
+ * ```
+ */
+/**
+ * Pagination options for controlling automatic pagination behavior
+ */
+export interface PaginationOptions {
+    /** Maximum number of records to fetch across all pages */
+    limit?: number;
+    /** Starting offset for skip-based pagination */
+    skip?: number;
+}
+/**
+ * Metadata returned with paginated responses
+ */
+export interface PaginationMetadata {
+    totalRecords?: number;
+    numRecords?: number;
+    numFields?: number;
+    skip?: number;
+    top?: number;
+    nextPageToken?: string;
+    nextToken?: string;
+}
+/**
+ * A paginated response from the QuickBase API
+ */
+export interface PaginatedResponse<T = unknown> {
+    data?: T[];
+    fields?: Array<{
+        id: number;
+        label: string;
+        type: string;
+    }>;
+    metadata: PaginationMetadata;
+    [key: string]: unknown;
+}
+/**
+ * Determines the type of pagination from a response
+ */
+export type PaginationType = 'skip' | 'token' | 'none';
+/**
+ * Detect pagination type from response metadata
+ */
+export declare function detectPaginationType(metadata: PaginationMetadata): PaginationType;
+/**
+ * Check if a response has more pages available
+ */
+export declare function hasMorePages(response: PaginatedResponse, paginationType: PaginationType, currentCount: number): boolean;
+/**
+ * Find the data array key in a response object
+ */
+export declare function findDataKey(response: PaginatedResponse): string;
+/**
+ * Check if a response looks like a paginated response
+ */
+export declare function isPaginatedResponse(response: unknown): response is PaginatedResponse;
+/**
+ * Request executor function type
+ */
+export type RequestExecutor<T> = () => Promise<T>;
+/**
+ * Request executor with pagination parameters
+ */
+export type PaginatedRequestExecutor<T> = (params: {
+    skip?: number;
+    nextPageToken?: string;
+    nextToken?: string;
+}) => Promise<T>;
+/**
+ * A thenable request that supports fluent pagination methods
+ *
+ * This class wraps an API request and allows chaining pagination methods
+ * while still being directly awaitable.
+ */
+export declare class PaginatedRequest<T> implements PromiseLike<T> {
+    private readonly executor;
+    private readonly paginatedExecutor?;
+    private readonly defaultAutoPaginate;
+    constructor(executor: RequestExecutor<T>, options?: {
+        paginatedExecutor?: PaginatedRequestExecutor<T>;
+        autoPaginate?: boolean;
+    });
+    /**
+     * Implement PromiseLike to allow direct awaiting
+     * Default behavior respects the global autoPaginate setting
+     */
+    then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+    /**
+     * Fetch all pages and combine results
+     */
+    all(): Promise<T>;
+    /**
+     * Fetch pages with optional limit
+     */
+    paginate(options?: PaginationOptions): Promise<T>;
+    /**
+     * Explicitly fetch only a single page (no pagination)
+     */
+    noPaginate(): Promise<T>;
+    /**
+     * Get the underlying promise (for compatibility)
+     */
+    toPromise(): Promise<T>;
+}
+/**
+ * Create a paginated request wrapper
+ */
+export declare function createPaginatedRequest<T>(executor: RequestExecutor<T>, options?: {
+    paginatedExecutor?: PaginatedRequestExecutor<T>;
+    autoPaginate?: boolean;
+}): PaginatedRequest<T>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/client/pagination.d.ts.map

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

package/dist/client/pagination.js

@@ -0,0 +1,226 @@
+/**
+ * Pagination support with fluent API
+ *
+ * Provides automatic pagination for QuickBase API endpoints that return
+ * paginated results. Supports both skip-based and token-based pagination.
+ *
+ * @example
+ * ```typescript
+ * // Fetch single page (default)
+ * const page = await client.runQuery({ ... });
+ *
+ * // Fetch all pages automatically
+ * const all = await client.runQuery({ ... }).all();
+ *
+ * // Fetch with record limit
+ * const limited = await client.runQuery({ ... }).paginate({ limit: 500 });
+ *
+ * // Explicitly single page (if autoPaginate is enabled globally)
+ * const single = await client.runQuery({ ... }).noPaginate();
+ * ```
+ */
+/**
+ * Detect pagination type from response metadata
+ */
+export function detectPaginationType(metadata) {
+    if (metadata.totalRecords !== undefined && metadata.skip !== undefined) {
+        return 'skip';
+    }
+    if (metadata.nextPageToken !== undefined || metadata.nextToken !== undefined) {
+        return 'token';
+    }
+    return 'none';
+}
+/**
+ * Check if a response has more pages available
+ */
+export function hasMorePages(response, paginationType, currentCount) {
+    const { metadata } = response;
+    if (paginationType === 'skip') {
+        return (metadata.totalRecords !== undefined &&
+            currentCount < metadata.totalRecords);
+    }
+    if (paginationType === 'token') {
+        const nextToken = metadata.nextPageToken ?? metadata.nextToken;
+        return nextToken !== undefined && nextToken !== '';
+    }
+    return false;
+}
+/**
+ * Find the data array key in a response object
+ */
+export function findDataKey(response) {
+    for (const key of Object.keys(response)) {
+        if (Array.isArray(response[key])) {
+            return key;
+        }
+    }
+    return 'data';
+}
+/**
+ * Check if a response looks like a paginated response
+ */
+export function isPaginatedResponse(response) {
+    if (!response || typeof response !== 'object') {
+        return false;
+    }
+    const obj = response;
+    // Must have metadata object
+    if (!obj.metadata || typeof obj.metadata !== 'object') {
+        return false;
+    }
+    // Must have an array field
+    const hasArrayField = Object.values(obj).some(Array.isArray);
+    if (!hasArrayField) {
+        return false;
+    }
+    const metadata = obj.metadata;
+    // Check for pagination indicators
+    return (metadata.totalRecords !== undefined ||
+        metadata.numRecords !== undefined ||
+        metadata.nextPageToken !== undefined ||
+        metadata.nextToken !== undefined);
+}
+/**
+ * A thenable request that supports fluent pagination methods
+ *
+ * This class wraps an API request and allows chaining pagination methods
+ * while still being directly awaitable.
+ */
+export class PaginatedRequest {
+    executor;
+    paginatedExecutor;
+    defaultAutoPaginate;
+    constructor(executor, options) {
+        this.executor = executor;
+        this.paginatedExecutor = options?.paginatedExecutor;
+        this.defaultAutoPaginate = options?.autoPaginate ?? false;
+    }
+    /**
+     * Implement PromiseLike to allow direct awaiting
+     * Default behavior respects the global autoPaginate setting
+     */
+    then(onfulfilled, onrejected) {
+        const promise = this.defaultAutoPaginate ? this.all() : this.executor();
+        return promise.then(onfulfilled, onrejected);
+    }
+    /**
+     * Fetch all pages and combine results
+     */
+    async all() {
+        return this.paginate({});
+    }
+    /**
+     * Fetch pages with optional limit
+     */
+    async paginate(options = {}) {
+        if (!this.paginatedExecutor) {
+            // Not a paginated endpoint, just execute normally
+            return this.executor();
+        }
+        const { limit, skip: initialSkip = 0 } = options;
+        let allRecords = [];
+        let lastResponse = null;
+        let paginationType = 'none';
+        let currentSkip = initialSkip;
+        let nextToken;
+        // Fetch first page
+        const firstResponse = await this.paginatedExecutor({ skip: initialSkip });
+        if (!isPaginatedResponse(firstResponse)) {
+            // Not a paginated response, return as-is
+            return firstResponse;
+        }
+        lastResponse = firstResponse;
+        paginationType = detectPaginationType(firstResponse.metadata);
+        const dataKey = findDataKey(firstResponse);
+        const firstPageData = firstResponse[dataKey] || [];
+        allRecords = [...firstPageData];
+        // Initialize continuation state
+        if (paginationType === 'skip') {
+            currentSkip = initialSkip + firstPageData.length;
+        }
+        else if (paginationType === 'token') {
+            nextToken = firstResponse.metadata.nextPageToken ?? firstResponse.metadata.nextToken;
+        }
+        // Fetch remaining pages
+        while (hasMorePages(lastResponse, paginationType, allRecords.length)) {
+            // Check limit
+            if (limit !== undefined && allRecords.length >= limit) {
+                break;
+            }
+            // Fetch next page
+            let nextResponse;
+            if (paginationType === 'skip') {
+                nextResponse = await this.paginatedExecutor({ skip: currentSkip });
+            }
+            else if (paginationType === 'token' && nextToken) {
+                const tokenKey = lastResponse.metadata.nextPageToken !== undefined
+                    ? 'nextPageToken'
+                    : 'nextToken';
+                nextResponse = await this.paginatedExecutor({ [tokenKey]: nextToken });
+            }
+            else {
+                break;
+            }
+            lastResponse = nextResponse;
+            const pageData = nextResponse[dataKey] || [];
+            // Check for empty response
+            if (pageData.length === 0) {
+                break;
+            }
+            // Apply limit if needed
+            if (limit !== undefined) {
+                const remainingCapacity = limit - allRecords.length;
+                allRecords = allRecords.concat(pageData.slice(0, remainingCapacity));
+            }
+            else {
+                allRecords = allRecords.concat(pageData);
+            }
+            // Update continuation state
+            if (paginationType === 'skip') {
+                currentSkip += pageData.length;
+            }
+            else if (paginationType === 'token') {
+                nextToken = nextResponse.metadata.nextPageToken ?? nextResponse.metadata.nextToken;
+                if (!nextToken) {
+                    break;
+                }
+            }
+        }
+        // Build final response
+        const finalResponse = {
+            ...lastResponse,
+            [dataKey]: allRecords,
+            metadata: {
+                ...lastResponse.metadata,
+                numRecords: allRecords.length,
+                skip: initialSkip,
+            },
+        };
+        // Clear pagination tokens in final response
+        if (paginationType === 'token') {
+            delete finalResponse.metadata.nextPageToken;
+            delete finalResponse.metadata.nextToken;
+        }
+        return finalResponse;
+    }
+    /**
+     * Explicitly fetch only a single page (no pagination)
+     */
+    async noPaginate() {
+        return this.executor();
+    }
+    /**
+     * Get the underlying promise (for compatibility)
+     */
+    toPromise() {
+        return this.then();
+    }
+}
+/**
+ * Create a paginated request wrapper
+ */
+export function createPaginatedRequest(executor, options) {
+    return new PaginatedRequest(executor, options);
+}
+//# sourceMappingURL=pagination.js.map

package/dist/client/pagination.js.map

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

package/dist/client/request.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Request execution module
+ *
+ * Handles the full request lifecycle:
+ * 1. Authentication
+ * 2. Throttling (if enabled)
+ * 3. Request execution
+ * 4. Error handling with retry
+ */
+import type { ResolvedConfig } from '../core/types.js';
+import type { AuthStrategy } from '../auth/types.js';
+import type { Logger } from '../core/logger.js';
+import type { Throttle } from './throttle.js';
+export interface RequestOptions {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    path: string;
+    body?: unknown;
+    query?: Record<string, string | number | boolean | undefined>;
+    /** Database ID for temp token auth */
+    dbid?: string;
+    /** Custom headers */
+    headers?: Record<string, string>;
+}
+export interface RequestExecutorOptions {
+    config: ResolvedConfig;
+    auth: AuthStrategy;
+    throttle: Throttle;
+    logger: Logger;
+}
+/**
+ * Execute a request with full retry logic
+ */
+export declare function executeRequest<T = unknown>(options: RequestOptions, executor: RequestExecutorOptions): Promise<T>;
+/**
+ * Create a request executor
+ */
+export declare function createRequestExecutor(options: RequestExecutorOptions): {
+    execute: <T = unknown>(requestOptions: RequestOptions) => Promise<T>;
+};
+//# sourceMappingURL=request.d.ts.map

package/dist/client/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/client/request.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAkB,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAY9C,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;IAC9D,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAsID;;GAEG;AACH,wBAAsB,cAAc,CAAC,CAAC,GAAG,OAAO,EAC9C,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,sBAAsB,GAC/B,OAAO,CAAC,CAAC,CAAC,CA2EZ;AAcD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB;cAEvD,CAAC,4BAA4B,cAAc;EAGxD"}

package/dist/client/request.js

@@ -0,0 +1,194 @@
+/**
+ * Request execution module
+ *
+ * Handles the full request lifecycle:
+ * 1. Authentication
+ * 2. Throttling (if enabled)
+ * 3. Request execution
+ * 4. Error handling with retry
+ */
+import { QuickbaseError, RateLimitError, TimeoutError, parseErrorResponse, isRetryableError, } from '../core/errors.js';
+import { extractRateLimitInfo, sleep } from './retry.js';
+import { getRealmHostname } from '../core/config.js';
+import { transformDates } from '../core/dates.js';
+/**
+ * Build URL with query parameters
+ */
+function buildUrl(baseUrl, path, query) {
+    const url = new URL(path, baseUrl);
+    if (query) {
+        for (const [key, value] of Object.entries(query)) {
+            if (value !== undefined) {
+                url.searchParams.set(key, String(value));
+            }
+        }
+    }
+    return url.toString();
+}
+/**
+ * Create request headers
+ */
+async function buildHeaders(auth, realmHostname, dbid, customHeaders) {
+    const token = await auth.getToken(dbid);
+    const authHeader = auth.getAuthorizationHeader(token);
+    return {
+        'Content-Type': 'application/json',
+        'QB-Realm-Hostname': realmHostname,
+        'Authorization': authHeader,
+        ...customHeaders,
+    };
+}
+/**
+ * Execute a single request (no retry logic)
+ */
+async function executeSingleRequest(options, executor, _context) {
+    const { config, auth, throttle, logger } = executor;
+    const url = buildUrl(config.baseUrl, options.path, options.query);
+    const realmHostname = getRealmHostname(config.realm);
+    // Get auth headers
+    const headers = await buildHeaders(auth, realmHostname, options.dbid, options.headers);
+    // Apply throttling if enabled
+    await throttle.acquire();
+    // Build fetch options
+    const fetchOptions = {
+        method: options.method,
+        headers,
+    };
+    if (options.body !== undefined) {
+        fetchOptions.body = JSON.stringify(options.body);
+    }
+    // Create abort controller for timeout
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), config.timeout);
+    fetchOptions.signal = controller.signal;
+    const startTime = Date.now();
+    try {
+        const response = await config.fetchApi(url, fetchOptions);
+        const duration = Date.now() - startTime;
+        logger.timing(options.method, options.path, duration);
+        return response;
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'AbortError') {
+            throw new TimeoutError(config.timeout);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+/**
+ * Handle response and throw appropriate errors
+ */
+async function handleResponse(response, requestUrl, context, executor) {
+    const { config, logger } = executor;
+    if (response.ok) {
+        return response;
+    }
+    // Extract rate limit info for 429s
+    if (response.status === 429) {
+        const rateLimitInfo = extractRateLimitInfo(response, requestUrl, context.attempt);
+        logger.rateLimit({
+            url: requestUrl,
+            status: 429,
+            retryAfter: rateLimitInfo.retryAfter,
+            attempt: context.attempt,
+            rayId: rateLimitInfo.qbApiRay || rateLimitInfo.cfRay,
+        });
+        // Notify callback
+        if (config.onRateLimit) {
+            config.onRateLimit(rateLimitInfo);
+        }
+        throw new RateLimitError(rateLimitInfo);
+    }
+    // Parse and throw appropriate error
+    throw await parseErrorResponse(response, requestUrl);
+}
+/**
+ * Execute a request with full retry logic
+ */
+export async function executeRequest(options, executor) {
+    const { config, auth, logger } = executor;
+    const maxAttempts = config.retry.maxAttempts;
+    const context = {
+        methodName: `${options.method} ${options.path}`,
+        attempt: 1,
+        maxAttempts,
+        dbid: options.dbid,
+        startTime: Date.now(),
+    };
+    let lastError = null;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        context.attempt = attempt;
+        try {
+            const response = await executeSingleRequest(options, executor, context);
+            const url = buildUrl(config.baseUrl, options.path, options.query);
+            await handleResponse(response, url, context, executor);
+            // Parse JSON response and optionally transform dates
+            const data = await response.json();
+            return transformDates(data, config.convertDates);
+        }
+        catch (error) {
+            lastError = error;
+            // Check if error is retryable
+            if (!isRetryableError(error)) {
+                throw error;
+            }
+            // Don't retry if we've exhausted attempts
+            if (attempt >= maxAttempts) {
+                throw error;
+            }
+            // Handle auth errors specially - try to refresh token
+            if (error instanceof QuickbaseError && error.statusCode === 401) {
+                const refreshed = await auth.handleAuthError(options.dbid);
+                if (!refreshed) {
+                    throw error;
+                }
+                logger.debug('Token refreshed, retrying request');
+                continue;
+            }
+            // Calculate retry delay
+            let delayMs;
+            let reason;
+            if (error instanceof RateLimitError) {
+                delayMs = error.retryAfter
+                    ? error.retryAfter * 1000
+                    : calculateBackoff(attempt, config.retry);
+                reason = 'Rate limited (429)';
+            }
+            else if (error instanceof TimeoutError) {
+                delayMs = calculateBackoff(attempt, config.retry);
+                reason = 'Timeout';
+            }
+            else if (error instanceof QuickbaseError && error.statusCode >= 500) {
+                delayMs = calculateBackoff(attempt, config.retry);
+                reason = `Server error (${error.statusCode})`;
+            }
+            else {
+                delayMs = calculateBackoff(attempt, config.retry);
+                reason = 'Retryable error';
+            }
+            logger.retry(attempt, maxAttempts, delayMs, reason);
+            await sleep(delayMs);
+        }
+    }
+    throw lastError || new Error('Request failed');
+}
+/**
+ * Calculate exponential backoff delay with jitter
+ */
+function calculateBackoff(attempt, config) {
+    const delay = config.initialDelayMs * Math.pow(config.multiplier, attempt - 1);
+    const jitter = delay * 0.1 * (Math.random() * 2 - 1);
+    return Math.min(delay + jitter, config.maxDelayMs);
+}
+/**
+ * Create a request executor
+ */
+export function createRequestExecutor(options) {
+    return {
+        execute: (requestOptions) => executeRequest(requestOptions, options),
+    };
+}
+//# sourceMappingURL=request.js.map

package/dist/client/request.js.map

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

package/dist/client/retry.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Retry logic with exponential backoff
+ *
+ * Handles:
+ * - HTTP 429 (Rate Limited) - uses Retry-After header
+ * - HTTP 5xx (Server Errors) - exponential backoff
+ * - Timeout errors - exponential backoff
+ */
+import type { RequestContext, RateLimitInfo, ResolvedConfig } from '../core/types.js';
+import type { Logger } from '../core/logger.js';
+export interface RetryOptions {
+    maxAttempts: number;
+    initialDelayMs: number;
+    maxDelayMs: number;
+    multiplier: number;
+}
+/**
+ * Calculate delay for exponential backoff
+ */
+export declare function calculateBackoffDelay(attempt: number, options: RetryOptions): number;
+/**
+ * Get delay from Retry-After header or fall back to backoff calculation
+ */
+export declare function getRetryDelay(response: Response | null, attempt: number, options: RetryOptions): number;
+/**
+ * Extract rate limit info from response headers
+ */
+export declare function extractRateLimitInfo(response: Response, requestUrl: string, attempt: number): RateLimitInfo;
+/**
+ * Sleep for a given duration
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Determine if a response status is retryable
+ */
+export declare function isRetryableStatus(status: number): boolean;
+/**
+ * Execute a request with retry logic
+ */
+export declare function executeWithRetry<T>(fn: (context: RequestContext) => Promise<T>, context: RequestContext, config: ResolvedConfig, logger: Logger): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/client/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/client/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAQhD,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,GACpB,MAAM,CAQR;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,GACpB,MAAM,CAmBR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,aAAa,CAaf;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,EAAE,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,EAC3C,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,CAAC,CAAC,CAuDZ"}