@auth-craft/client 0.1.0 → 0.1.2

package/dist/transport/types.d.ts

@@ -0,0 +1,488 @@
+import type { Result } from 'ts-micro-result';
+/**
+ * FetchGuard Business Types
+ *
+ * Contains domain logic types: Provider, Config, API Response, etc.
+ * For message protocol types, see messages.ts
+ */
+/**
+ * Token info returned from provider
+ *
+ * All fields are optional to support various custom auth methods:
+ * - Standard login/refresh: returns token + optional fields
+ * - Update user info: may only return user (no token update)
+ * - Verify OTP: may return nothing (just validation)
+ * - Custom auth flows: flexible field combinations
+ */
+export interface TokenInfo {
+    token?: string | null;
+    expiresAt?: number | null;
+    refreshToken?: string | null;
+    user?: unknown;
+}
+/**
+ * Options for token exchange operation
+ *
+ * Used when switching tenant, changing scope, or any operation
+ * that exchanges current token for a new one with different claims
+ */
+export interface ExchangeTokenOptions {
+    /** HTTP method to use. Default: 'POST' */
+    method?: 'POST' | 'PUT';
+    /** Payload to send with the request (e.g., tenantId, scope) */
+    payload?: Record<string, unknown>;
+    /** Custom headers for this request. Overrides defaultHeaders if same key. */
+    headers?: Record<string, string>;
+}
+/**
+ * Auth result returned from auth operations and auth state changes
+ * Used by: login(), logout(), refreshToken(), onAuthStateChanged()
+ */
+export interface AuthResult {
+    /** Whether user is authenticated (has valid non-expired token) */
+    authenticated: boolean;
+    /** User info from token (if available) */
+    user?: unknown;
+    /** Token expiry timestamp in milliseconds (if available) */
+    expiresAt?: number | null;
+}
+/**
+ * Interface for token provider
+ *
+ * Provider has 3 required methods:
+ * - refreshToken: Refresh access token when expired
+ * - login: Login with credentials
+ * - logout: Logout (clear tokens)
+ *
+ * User can add custom auth methods (loginWithPhone, loginWithGoogle, etc.)
+ * All custom methods must return Result<TokenInfo> for token retrieval
+ */
+export interface TokenProvider {
+    /**
+     * Refresh tokens (required)
+     * @param refreshToken - Current refresh token (from worker memory, null if not available)
+     * @returns Result<TokenInfo> with new tokens
+     */
+    refreshToken(refreshToken: string | null): Promise<Result<TokenInfo>>;
+    /**
+     * Login with credentials (required)
+     * @param payload - Login credentials (email/password, etc.)
+     * @param url - Optional URL override (if not provided, uses configured loginUrl)
+     * @returns Result<TokenInfo> with tokens
+     */
+    login(payload: unknown, url?: string): Promise<Result<TokenInfo>>;
+    /**
+     * Logout - clear tokens (required)
+     * @param payload - Optional logout payload
+     * @returns Result<TokenInfo> with all fields reset (token = '', refreshToken = undefined, user = undefined)
+     */
+    logout(payload?: unknown): Promise<Result<TokenInfo>>;
+    /**
+     * Exchange current token for a new one with different context
+     *
+     * Useful for switching tenants, changing scopes, or any operation
+     * that requires exchanging the current token for a new one.
+     *
+     * @param accessToken - Current access token (injected by worker)
+     * @param url - URL to call for token exchange
+     * @param options - Exchange options (method, payload)
+     * @returns Result<TokenInfo> with new tokens
+     */
+    exchangeToken(accessToken: string, url: string, options?: ExchangeTokenOptions): Promise<Result<TokenInfo>>;
+    /**
+     * Custom auth methods (optional)
+     * Examples: loginWithPhone, loginWithGoogle, loginWithFacebook, etc.
+     * All must return Result<TokenInfo> for token retrieval
+     *
+     * Note: `never[]` args (not `any[]`) keep the index signature compatible with
+     * the specific method signatures above (parameter bivariance) without `any`.
+     */
+    [key: string]: (...args: never[]) => Promise<Result<TokenInfo>>;
+}
+/**
+ * Storage error context for debugging
+ */
+export type StorageErrorContext = 'get' | 'set' | 'delete' | 'open';
+/**
+ * Storage error callback type
+ * Called when IndexedDB operations fail (quota exceeded, permission denied, etc.)
+ * Storage still fails closed (returns null), but this allows logging/debugging.
+ */
+export type StorageErrorCallback = (error: Error, context: StorageErrorContext) => void;
+/**
+ * Interface for refresh token storage - only stores refresh token
+ *
+ * Access token is always stored in worker memory.
+ * Refresh token storage is OPTIONAL:
+ * - If available (IndexedDB): persist refresh token for reuse after reload
+ * - If not (undefined): cookie-based auth (httpOnly cookie)
+ */
+export interface RefreshTokenStorage {
+    get(): Promise<string | null>;
+    set(token: string | null): Promise<void>;
+}
+/**
+ * Interface for token parser - parse token from backend response
+ * Parser returns complete TokenInfo (including user data)
+ */
+export interface TokenParser {
+    parse(response: Response): Promise<TokenInfo>;
+}
+/**
+ * Interface for auth strategy - defines how to call auth APIs
+ *
+ * Strategy focuses only on API calls, returns Response
+ * Provider handles parsing and storage
+ *
+ * All methods are required
+ */
+export interface AuthStrategy {
+    /** Refresh access token */
+    refresh(refreshToken: string | null): Promise<Response>;
+    /**
+     * Login with credentials
+     * @param payload - Login credentials
+     * @param url - Optional URL override (if not provided, uses configured loginUrl)
+     */
+    login(payload: unknown, url?: string): Promise<Response>;
+    /** Logout */
+    logout(payload?: unknown): Promise<Response>;
+    /**
+     * Exchange current token for a new one with different context
+     * @param accessToken - Current access token
+     * @param url - URL to call for token exchange
+     * @param options - Exchange options (method, payload)
+     */
+    exchangeToken(accessToken: string, url: string, options?: ExchangeTokenOptions): Promise<Response>;
+}
+/**
+ * Provider preset configuration for built-in auth strategies
+ */
+export interface ProviderPresetConfig {
+    type: 'cookie-auth' | 'body-auth';
+    refreshUrl: string;
+    loginUrl: string;
+    logoutUrl: string;
+    refreshTokenKey?: string;
+    /** Custom headers to include in all auth requests (login, logout, refresh) */
+    headers?: Record<string, string>;
+}
+/**
+ * Configuration for FetchGuard client
+ */
+export interface FetchGuardOptions {
+    /**
+     * Token provider - 3 options:
+     * 1. TokenProvider instance (for custom providers)
+     * 2. ProviderPresetConfig object (for built-in presets)
+     * 3. string (for registry lookup - advanced usage)
+     */
+    provider: TokenProvider | ProviderPresetConfig | string;
+    /** List of allowed domains (wildcard supported) */
+    allowedDomains?: string[];
+    /** Early refresh time for tokens (ms) */
+    refreshEarlyMs?: number;
+    /** Default headers to include in all requests */
+    defaultHeaders?: Record<string, string>;
+    /**
+     * Maximum concurrent requests to worker (default: 6)
+     * Controls how many requests can be in-flight simultaneously.
+     * Set to 1 for strictly sequential processing.
+     * Higher values increase throughput but may cause worker congestion.
+     */
+    maxConcurrent?: number;
+    /**
+     * Maximum queue size for pending requests (default: 1000)
+     * When queue is full, new requests will immediately fail with QUEUE_FULL error.
+     * Prevents memory leak if worker is unresponsive.
+     */
+    maxQueueSize?: number;
+    /**
+     * Worker setup timeout in milliseconds (default: 10000)
+     * How long to wait for worker to be ready before failing.
+     */
+    setupTimeout?: number;
+    /**
+     * Default request timeout in milliseconds (default: 30000)
+     * How long to wait for a request to complete before timing out.
+     * Can be overridden per-request via fetch options.
+     */
+    requestTimeout?: number;
+    /**
+     * Debug hooks for observing operations (logging, monitoring)
+     * All hooks are observe-only - they cannot modify requests/responses.
+     */
+    debug?: DebugHooks;
+    /**
+     * Retry configuration for network errors
+     * Only retries on transport failures, NOT on HTTP errors (4xx/5xx)
+     */
+    retry?: RetryConfig;
+    /**
+     * Request deduplication configuration
+     * When enabled, duplicate requests to the same URL within a time window
+     * will share the same response instead of making multiple requests.
+     */
+    dedupe?: DedupeConfig;
+    /**
+     * Custom worker factory function
+     *
+     * Use this when you need a custom provider with parser/strategy functions.
+     * Create a custom worker file that imports 'fetchguard/worker' and registers
+     * your provider, then pass a factory function that creates that worker.
+     *
+     * @example
+     * ```ts
+     * // my-worker.ts
+     * import 'fetchguard/worker'
+     * import { registerProvider, createProvider, ... } from 'fetchguard'
+     * const myProvider = createProvider({ parser: myParser, strategy: myStrategy, ... })
+     * registerProvider('my-auth', myProvider)
+     *
+     * // main.ts
+     * import MyWorker from './my-worker?worker'
+     * const api = createClient({
+     *   provider: 'my-auth',
+     *   workerFactory: () => new MyWorker()
+     * })
+     * ```
+     */
+    workerFactory?: () => Worker;
+}
+/**
+ * Internal worker configuration
+ */
+export interface WorkerConfig {
+    allowedDomains: string[];
+    refreshEarlyMs: number;
+    defaultHeaders: Record<string, string>;
+}
+/**
+ * Extended RequestInit with FetchGuard-specific options
+ */
+export interface FetchGuardRequestInit extends RequestInit {
+    /** Whether this request requires authentication. Default: true */
+    requiresAuth?: boolean;
+    /** Include response headers in result metadata and FETCH_RESULT payload */
+    includeHeaders?: boolean;
+}
+/**
+ * Fetch envelope - raw HTTP response from worker
+ *
+ * Worker only fetches and returns raw data, does NOT judge HTTP status.
+ * Client receives envelope and decides ok/err based on business logic.
+ *
+ * - status: HTTP status code (2xx, 3xx, 4xx, 5xx)
+ * - body: string (text/JSON) or base64 (binary)
+ * - contentType: always present, indicates how to decode body
+ * - headers: empty object if includeHeaders: false
+ */
+export interface FetchEnvelope {
+    status: number;
+    body: string;
+    contentType: string;
+    headers: Record<string, string>;
+}
+/**
+ * Serialized file data for transfer over postMessage
+ * Uses ArrayBuffer for zero-copy transfer via Transferable
+ */
+export interface SerializedFile {
+    name: string;
+    type: string;
+    /** ArrayBuffer - transferred via postMessage Transferable for zero-copy */
+    buffer: ArrayBuffer;
+}
+/**
+ * Serialized FormData entry - can be string or file
+ */
+export type SerializedFormDataEntry = string | SerializedFile;
+/**
+ * Serialized FormData for transfer over postMessage
+ */
+export interface SerializedFormData {
+    _type: 'FormData';
+    entries: Array<[string, SerializedFormDataEntry]>;
+}
+/**
+ * Result of FormData serialization with transferables
+ * Used for zero-copy transfer via postMessage
+ */
+export interface SerializedFormDataResult {
+    data: SerializedFormData;
+    /** ArrayBuffers to transfer - pass to postMessage as second argument */
+    transferables: ArrayBuffer[];
+}
+/**
+ * Network error detail for transport failures
+ * Used when no HTTP response is received (connection failed, timeout, cancelled)
+ */
+export interface NetworkErrorDetail {
+    code: 'NETWORK_ERROR' | 'REQUEST_CANCELLED' | 'RESPONSE_PARSE_FAILED';
+    message: string;
+}
+/**
+ * Reason for token refresh
+ */
+export type RefreshReason = 'expired' | 'proactive' | 'manual';
+/**
+ * Request timing metrics for performance monitoring
+ *
+ * All times are in milliseconds.
+ */
+export interface RequestMetrics {
+    /** When request was initiated (Date.now()) */
+    startTime: number;
+    /** When response was received (Date.now()) */
+    endTime: number;
+    /** Total duration (endTime - startTime) */
+    duration: number;
+    /** Time spent waiting in queue before processing */
+    queueTime: number;
+    /** Time spent in IPC (postMessage round-trip overhead) */
+    ipcTime: number;
+}
+/**
+ * Debug hooks for observing FetchGuard operations
+ *
+ * All hooks are observe-only - they cannot modify requests/responses.
+ * Useful for logging, debugging, and monitoring.
+ *
+ * Note: Hooks run synchronously and should not perform heavy operations.
+ */
+export interface DebugHooks {
+    /**
+     * Called before each request is sent to worker
+     * @param url - Request URL
+     * @param options - Request options (method, headers, etc.)
+     */
+    onRequest?: (url: string, options: FetchGuardRequestInit) => void;
+    /**
+     * Called when response is received from worker
+     * @param url - Request URL
+     * @param envelope - Response envelope (status, body, headers)
+     * @param metrics - Request timing metrics (optional, for performance monitoring)
+     */
+    onResponse?: (url: string, envelope: FetchEnvelope, metrics?: RequestMetrics) => void;
+    /**
+     * Called when token refresh occurs
+     * @param reason - Why refresh happened: 'expired', 'proactive', or 'manual'
+     */
+    onRefresh?: (reason: RefreshReason) => void;
+    /**
+     * Called when transport error occurs (network failure, timeout, cancelled)
+     * @param url - Request URL
+     * @param error - Error detail with code and message
+     * @param metrics - Request timing metrics (optional)
+     */
+    onError?: (url: string, error: NetworkErrorDetail, metrics?: RequestMetrics) => void;
+    /**
+     * Called when worker is ready after initialization
+     */
+    onWorkerReady?: () => void;
+    /**
+     * Called when worker encounters a fatal error
+     * @param error - Error event from worker
+     */
+    onWorkerError?: (error: ErrorEvent) => void;
+}
+/**
+ * Retry configuration for network errors
+ *
+ * Only retries on transport failures (network error, timeout).
+ * Does NOT retry on HTTP errors (4xx/5xx) - those are valid responses.
+ * Does NOT retry cancelled requests.
+ */
+export interface RetryConfig {
+    /**
+     * Maximum number of retry attempts (default: 0 = no retry)
+     */
+    maxAttempts?: number;
+    /**
+     * Delay between retries in milliseconds (default: 1000)
+     */
+    delay?: number;
+    /**
+     * Exponential backoff multiplier (default: 1 = no backoff)
+     * Example: delay=1000, backoff=2 => 1s, 2s, 4s, 8s...
+     */
+    backoff?: number;
+    /**
+     * Maximum delay in milliseconds (default: 30000)
+     * Caps the delay when using exponential backoff
+     */
+    maxDelay?: number;
+    /**
+     * Jitter factor to add randomness to retry delays (default: 0 = no jitter)
+     * Range: 0 to 1 (e.g., 0.5 = ±50% randomness)
+     * Helps prevent thundering herd when many clients retry simultaneously.
+     *
+     * Note: Jitter is only applied when shouldRetry returns true.
+     * If request fails permanently, no jitter delay occurs.
+     *
+     * Example: delay=1000, jitter=0.5 => delay between 500ms and 1500ms
+     */
+    jitter?: number;
+    /**
+     * Custom condition to determine if error should be retried
+     * Default: retry on NETWORK_ERROR only
+     * @param error - The error that occurred
+     * @returns true to retry, false to fail immediately
+     */
+    shouldRetry?: (error: NetworkErrorDetail) => boolean;
+}
+/**
+ * Request deduplication configuration
+ *
+ * When enabled, identical GET requests (same URL) within a time window
+ * will share the same in-flight request instead of making duplicates.
+ *
+ * IMPORTANT:
+ * - Only applies to GET requests (POST/PUT/DELETE are never deduplicated)
+ * - Only deduplicates in-flight requests (not caching)
+ * - Safe for most read operations
+ */
+export interface DedupeConfig {
+    /**
+     * Enable deduplication (default: false)
+     */
+    enabled?: boolean;
+    /**
+     * Time window in milliseconds to consider requests as duplicates (default: 0)
+     * 0 = only dedupe concurrent/in-flight requests
+     * >0 = also dedupe requests within this time window after completion
+     */
+    window?: number;
+    /**
+     * Custom key generator for deduplication
+     * Default: uses URL only for GET requests
+     * @param url - Request URL
+     * @param options - Request options
+     * @returns Key string, or null to skip deduplication for this request
+     */
+    keyGenerator?: (url: string, options: FetchGuardRequestInit) => string | null;
+}
+/**
+ * Transport result - represents the outcome of a network request
+ *
+ * IMPORTANT: This is a TRANSPORT result, not a business result.
+ * - ok = HTTP response received (check envelope.status for 2xx/4xx/5xx)
+ * - err = Network failure (no response received)
+ *
+ * Example:
+ * ```typescript
+ * const result = await api.get('/users')
+ * if (result.ok) {
+ *   // Transport succeeded - got HTTP response
+ *   if (result.data.status >= 200 && result.data.status < 400) {
+ *     // Business success
+ *   } else {
+ *     // Business error (4xx/5xx) - still has response body
+ *   }
+ * } else {
+ *   // Transport failed - no response (network error, timeout, cancelled)
+ * }
+ * ```
+ */
+export type TransportResult = Result<FetchEnvelope>;
+//# sourceMappingURL=types.d.ts.map

package/dist/transport/types.d.ts.map

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

package/dist/transport/types.js

@@ -0,0 +1,3 @@
+/// <reference lib="webworker" />
+export {};
+//# sourceMappingURL=types.js.map

package/dist/transport/types.js.map

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

package/dist/transport/utils/binary.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Binary data utilities for Worker
+ * Handles ArrayBuffer <-> Base64 conversion for binary responses
+ */
+/**
+ * Convert ArrayBuffer to base64 string
+ * Used in worker to encode binary responses for postMessage transfer
+ */
+export declare function arrayBufferToBase64(buffer: ArrayBuffer): string;
+/**
+ * Convert base64 string to ArrayBuffer
+ * Used in client to decode binary responses
+ */
+export declare function base64ToArrayBuffer(base64: string): ArrayBuffer;
+/**
+ * Check if content type is binary (should be base64 encoded)
+ * Returns true for images, PDFs, videos, etc.
+ */
+export declare function isBinaryContentType(contentType: string): boolean;
+//# sourceMappingURL=binary.d.ts.map

package/dist/transport/utils/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../../../src/transport/utils/binary.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAO/D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAO/D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAahE"}

package/dist/transport/utils/binary.js

@@ -0,0 +1,51 @@
+/**
+ * Binary data utilities for Worker
+ * Handles ArrayBuffer <-> Base64 conversion for binary responses
+ */
+/**
+ * Convert ArrayBuffer to base64 string
+ * Used in worker to encode binary responses for postMessage transfer
+ */
+export function arrayBufferToBase64(buffer) {
+    const bytes = new Uint8Array(buffer);
+    let binary = '';
+    for (let i = 0; i < bytes.length; i++) {
+        binary += String.fromCharCode(bytes[i]);
+    }
+    return btoa(binary);
+}
+/**
+ * Convert base64 string to ArrayBuffer
+ * Used in client to decode binary responses
+ */
+export function base64ToArrayBuffer(base64) {
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes.buffer;
+}
+/**
+ * Check if content type is binary (should be base64 encoded)
+ * Returns true for images, PDFs, videos, etc.
+ */
+export function isBinaryContentType(contentType) {
+    const normalized = contentType.toLowerCase();
+    // Text types - NOT binary
+    if (normalized.includes('text/'))
+        return false;
+    if (normalized.includes('json'))
+        return false;
+    if (normalized.includes('xml'))
+        return false;
+    if (normalized.includes('javascript'))
+        return false;
+    if (normalized.includes('ecmascript'))
+        return false;
+    if (normalized.includes('html'))
+        return false;
+    // Everything else is considered binary
+    return true;
+}
+//# sourceMappingURL=binary.js.map

package/dist/transport/utils/binary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.js","sourceRoot":"","sources":["../../../src/transport/utils/binary.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAmB;IACrD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,MAAM,UAAU,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;IAE7C,0BAA0B;IAC1B,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/C,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9C,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,KAAK,CAAC;IACpD,IAAI,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,KAAK,CAAC;IACpD,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAE9C,uCAAuC;IACvC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/transport/utils/formdata.d.ts

@@ -0,0 +1,26 @@
+import type { SerializedFormData, SerializedFormDataResult } from '../types';
+/**
+ * Serialize FormData for transfer over postMessage
+ *
+ * FormData cannot be cloned via postMessage, so we need to serialize it first.
+ * Files are converted to ArrayBuffer and returned as transferables for zero-copy transfer.
+ *
+ * IMPORTANT: Preserves original field order by using single-pass iteration.
+ *
+ * @returns SerializedFormDataResult with data and transferables array
+ */
+export declare function serializeFormData(formData: FormData): Promise<SerializedFormDataResult>;
+/**
+ * Deserialize SerializedFormData back to FormData in worker
+ * Reconstructs File objects from transferred ArrayBuffers
+ */
+export declare function deserializeFormData(serialized: SerializedFormData): FormData;
+/**
+ * Check if body is FormData
+ */
+export declare function isFormData(body: unknown): body is FormData;
+/**
+ * Check if serialized body is SerializedFormData
+ */
+export declare function isSerializedFormData(body: unknown): body is SerializedFormData;
+//# sourceMappingURL=formdata.d.ts.map

package/dist/transport/utils/formdata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formdata.d.ts","sourceRoot":"","sources":["../../../src/transport/utils/formdata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,kBAAkB,EAA2B,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAEtH;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAuC7F;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,kBAAkB,GAAG,QAAQ,CAc5E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,QAAQ,CAE1D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,kBAAkB,CAE9E"}