@uploadista/client-core 0.0.3

package/.turbo/turbo-build.log

@@ -0,0 +1,5 @@
+
+
+> @uploadista/client-core@0.0.2 build /Users/denislaboureyras/Documents/uploadista/dev/uploadista-workspace/uploadista-sdk/packages/clients/core
+> tsc -b
+

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 uploadista
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,100 @@
+# @uploadista/client-core
+
+Platform-agnostic core upload client logic for Uploadista.
+
+## Overview
+
+This package contains the core upload orchestration logic that is shared across all platform-specific client implementations (browser, React Native, Expo, etc.). It provides:
+
+- Service interfaces for dependency injection
+- Platform-agnostic types and error handling
+- Network monitoring and performance tracking
+- Chunk buffering utilities
+- Upload fingerprinting abstractions
+
+## Architecture
+
+The client-core package is designed to be platform-independent and does NOT include any browser-specific or React Native-specific dependencies. It uses ES2020 as the target and does not include DOM types.
+
+### Service Interfaces
+
+Platform-specific implementations must provide concrete implementations of these services:
+
+- `StorageService` - Persistent storage for upload state (localStorage, AsyncStorage, etc.)
+- `IdGenerationService` - Unique ID generation (crypto.randomUUID, uuid library, etc.)
+- `HttpClient` - HTTP request handling with connection pooling
+- `FileReaderService` - File reading and slicing for chunked uploads
+- `Base64Service` (optional) - Base64 encoding/decoding
+
+### Service Container
+
+The `ServiceContainer` interface defines the required services that must be injected into the upload client:
+
+```typescript
+interface ServiceContainer {
+  storage: StorageService;
+  idGeneration: IdGenerationService;
+  httpClient: HttpClient;
+  fileReader: FileReaderService;
+  base64?: Base64Service;
+}
+```
+
+## Usage
+
+This package is not meant to be used directly. Instead, use one of the platform-specific implementations:
+
+- `@uploadista/client-browser` - For web browsers
+- `@uploadista/client-react-native` - For React Native apps
+- `@uploadista/client-expo` - For Expo apps
+
+## Exports
+
+```typescript
+// Service interfaces
+export * from "./services";
+
+// Core types
+export * from "./types";
+export * from "./error";
+export * from "./logger";
+export * from "./previous-upload";
+export * from "./generate-fingerprint";
+
+// Utilities
+export * from "./network-monitor";
+export * from "./chunk-buffer";
+```
+
+## TypeScript Configuration
+
+This package uses strict TypeScript configuration with:
+- Target: ES2020
+- Lib: ES2020 only (no DOM)
+- Strict mode enabled
+- No unchecked indexed access
+
+## Dependencies
+
+Minimal dependencies:
+- `@uploadista/core` - Core uploadista types and utilities
+
+## Development
+
+```bash
+# Format code
+pnpm run format
+
+# Lint code
+pnpm run lint
+
+# Check (format + lint)
+pnpm run check
+```
+
+## Design Principles
+
+1. **Platform Independence** - No platform-specific code or dependencies
+2. **Dependency Injection** - All platform-specific services are injected
+3. **Type Safety** - Full TypeScript support with strict mode
+4. **Zero Runtime Assumptions** - No assumptions about the runtime environment

package/dist/auth/auth-http-client.d.ts

@@ -0,0 +1,50 @@
+import type { HttpClient, HttpRequestOptions, HttpResponse } from "../services/http-client";
+import type { DirectAuthManager } from "./direct-auth";
+import type { NoAuthManager } from "./no-auth";
+import type { SaasAuthManager } from "./saas-auth";
+/**
+ * Union type of all auth managers
+ */
+export type AuthManager = DirectAuthManager | SaasAuthManager | NoAuthManager;
+/**
+ * Auth-aware HTTP client wrapper.
+ *
+ * Wraps a standard HttpClient and automatically attaches authentication
+ * credentials/tokens to all HTTP requests based on the configured auth manager.
+ *
+ * The wrapper delegates all non-auth concerns (connection pooling, metrics, etc.)
+ * to the underlying HttpClient and only adds the auth layer on top.
+ */
+export declare class AuthHttpClient implements HttpClient {
+    private httpClient;
+    private authManager;
+    constructor(httpClient: HttpClient, authManager: AuthManager);
+    /**
+     * Make an HTTP request with authentication credentials attached.
+     * Calls the auth manager to attach credentials before delegating to the underlying client.
+     */
+    request(url: string, options?: HttpRequestOptions): Promise<HttpResponse>;
+    /**
+     * Attach authentication credentials to request headers.
+     * Delegates to the appropriate auth manager method.
+     */
+    private attachAuthCredentials;
+    /**
+     * Extract job ID from URL for SaaS mode token caching.
+     * Looks for patterns like /upload/{id} or /jobs/{id} in the URL.
+     */
+    private extractJobIdFromUrl;
+    /**
+     * Delegate metrics methods to underlying HTTP client
+     */
+    getMetrics(): import("..").ConnectionMetrics;
+    getDetailedMetrics(): import("..").DetailedConnectionMetrics;
+    reset(): void;
+    close(): Promise<void>;
+    warmupConnections(urls: string[]): Promise<void>;
+    /**
+     * Get the underlying auth manager for advanced use cases
+     */
+    getAuthManager(): AuthManager;
+}
+//# sourceMappingURL=auth-http-client.d.ts.map

package/dist/auth/auth-http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-http-client.d.ts","sourceRoot":"","sources":["../../src/auth/auth-http-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,YAAY,EACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,iBAAiB,GAAG,eAAe,GAAG,aAAa,CAAC;AAE9E;;;;;;;;GAQG;AACH,qBAAa,cAAe,YAAW,UAAU;IAE7C,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,WAAW;gBADX,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,WAAW;IAGlC;;;OAGG;IACG,OAAO,CACX,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,YAAY,CAAC;IA8BxB;;;OAGG;YACW,qBAAqB;IAoBnC;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IA0B3B;;OAEG;IACH,UAAU;IAIV,kBAAkB;IAIlB,KAAK;IAIC,KAAK;IAIL,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE;IAItC;;OAEG;IACH,cAAc,IAAI,WAAW;CAG9B"}

package/dist/auth/auth-http-client.js

@@ -0,0 +1,110 @@
+/**
+ * Auth-aware HTTP client wrapper.
+ *
+ * Wraps a standard HttpClient and automatically attaches authentication
+ * credentials/tokens to all HTTP requests based on the configured auth manager.
+ *
+ * The wrapper delegates all non-auth concerns (connection pooling, metrics, etc.)
+ * to the underlying HttpClient and only adds the auth layer on top.
+ */
+export class AuthHttpClient {
+    constructor(httpClient, authManager) {
+        this.httpClient = httpClient;
+        this.authManager = authManager;
+    }
+    /**
+     * Make an HTTP request with authentication credentials attached.
+     * Calls the auth manager to attach credentials before delegating to the underlying client.
+     */
+    async request(url, options = {}) {
+        try {
+            // Attach auth credentials to request headers
+            const authenticatedHeaders = await this.attachAuthCredentials(options.headers || {}, url);
+            // Delegate to underlying HTTP client with authenticated headers
+            return await this.httpClient.request(url, {
+                ...options,
+                headers: authenticatedHeaders,
+                // include credentials for cors if needed
+                credentials: this.authManager.getType() === "no-auth" ||
+                    this.authManager.getType() === "saas"
+                    ? "omit"
+                    : (options.credentials ?? "include"),
+            });
+        }
+        catch (error) {
+            // If auth fails, wrap error with context
+            if (error instanceof Error && error.message.includes("auth")) {
+                throw error; // Re-throw auth errors as-is
+            }
+            // For other errors, let them propagate
+            throw error;
+        }
+    }
+    /**
+     * Attach authentication credentials to request headers.
+     * Delegates to the appropriate auth manager method.
+     */
+    async attachAuthCredentials(headers, url) {
+        // Check if this is a DirectAuthManager or SaasAuthManager
+        if ("attachCredentials" in this.authManager) {
+            // DirectAuthManager or NoAuthManager
+            return await this.authManager.attachCredentials(headers);
+        }
+        if ("attachToken" in this.authManager) {
+            // SaasAuthManager - extract job ID from URL if present
+            const jobId = this.extractJobIdFromUrl(url);
+            return await this.authManager.attachToken(headers, jobId);
+        }
+        // Fallback - return headers unchanged
+        return headers;
+    }
+    /**
+     * Extract job ID from URL for SaaS mode token caching.
+     * Looks for patterns like /upload/{id} or /jobs/{id} in the URL.
+     */
+    extractJobIdFromUrl(url) {
+        // Match patterns like:
+        // - /api/upload/{uploadId}
+        // - /api/flow/{flowId}/{storageId}
+        // - /api/jobs/{jobId}/status
+        // - /api/jobs/{jobId}/continue/{nodeId}
+        const uploadMatch = url.match(/\/api\/upload\/([^/?]+)/);
+        if (uploadMatch) {
+            return uploadMatch[1];
+        }
+        const flowMatch = url.match(/\/api\/flow\/([^/?]+)/);
+        if (flowMatch) {
+            return flowMatch[1];
+        }
+        const jobMatch = url.match(/\/api\/jobs\/([^/?]+)/);
+        if (jobMatch) {
+            return jobMatch[1];
+        }
+        // No job ID found - SaaS mode will use global token
+        return undefined;
+    }
+    /**
+     * Delegate metrics methods to underlying HTTP client
+     */
+    getMetrics() {
+        return this.httpClient.getMetrics();
+    }
+    getDetailedMetrics() {
+        return this.httpClient.getDetailedMetrics();
+    }
+    reset() {
+        this.httpClient.reset();
+    }
+    async close() {
+        await this.httpClient.close();
+    }
+    async warmupConnections(urls) {
+        await this.httpClient.warmupConnections(urls);
+    }
+    /**
+     * Get the underlying auth manager for advanced use cases
+     */
+    getAuthManager() {
+        return this.authManager;
+    }
+}

package/dist/auth/direct-auth.d.ts

@@ -0,0 +1,38 @@
+import type { Logger } from "../logger";
+import type { PlatformService } from "../services/platform-service";
+import type { DirectAuthConfig } from "./types";
+import { BaseAuthManager } from "./types";
+/**
+ * Direct auth manager - handles credential attachment for "bring your own auth" mode.
+ *
+ * This manager calls the user-provided getCredentials() function before each request
+ * and attaches the returned credentials (headers, cookies) to the HTTP request.
+ *
+ * Supports any authentication protocol: OAuth, JWT, API keys, session cookies, etc.
+ */
+export declare class DirectAuthManager extends BaseAuthManager {
+    private config;
+    private platformService;
+    private logger;
+    constructor(config: DirectAuthConfig, platformService: PlatformService, logger: Logger);
+    /**
+     * Attach credentials to an HTTP request by calling getCredentials() and
+     * merging the returned headers/cookies with the request.
+     *
+     * @param headers - Existing request headers
+     * @returns Updated headers with credentials attached
+     * @throws Error if getCredentials() throws or returns invalid data
+     */
+    attachCredentials(headers?: Record<string, string>): Promise<Record<string, string>>;
+    /**
+     * Validate that headers is a valid object with string keys and values
+     */
+    private validateHeaders;
+    /**
+     * Attach cookies to request headers.
+     * In browser environments, cookies are automatically handled by fetch().
+     * In Node.js, we need to manually add them to the Cookie header.
+     */
+    private attachCookies;
+}
+//# sourceMappingURL=direct-auth.d.ts.map

package/dist/auth/direct-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-auth.d.ts","sourceRoot":"","sources":["../../src/auth/direct-auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;;GAOG;AACH,qBAAa,iBAAkB,SAAQ,eAAe;IAElD,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,MAAM;gBAFN,MAAM,EAAE,gBAAgB,EACxB,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,MAAM;IAKxB;;;;;;;OAOG;IACG,iBAAiB,CACrB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACnC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAuClC;;OAEG;IACH,OAAO,CAAC,eAAe;IAcvB;;;;OAIG;IACH,OAAO,CAAC,aAAa;CA2BtB"}

package/dist/auth/direct-auth.js

@@ -0,0 +1,95 @@
+import { BaseAuthManager } from "./types";
+/**
+ * Direct auth manager - handles credential attachment for "bring your own auth" mode.
+ *
+ * This manager calls the user-provided getCredentials() function before each request
+ * and attaches the returned credentials (headers, cookies) to the HTTP request.
+ *
+ * Supports any authentication protocol: OAuth, JWT, API keys, session cookies, etc.
+ */
+export class DirectAuthManager extends BaseAuthManager {
+    constructor(config, platformService, logger) {
+        super("direct");
+        this.config = config;
+        this.platformService = platformService;
+        this.logger = logger;
+    }
+    /**
+     * Attach credentials to an HTTP request by calling getCredentials() and
+     * merging the returned headers/cookies with the request.
+     *
+     * @param headers - Existing request headers
+     * @returns Updated headers with credentials attached
+     * @throws Error if getCredentials() throws or returns invalid data
+     */
+    async attachCredentials(headers = {}) {
+        try {
+            if (!this.config.getCredentials) {
+                return headers;
+            }
+            // Call user's credential provider (may be async)
+            const credentials = await Promise.resolve(this.config.getCredentials());
+            // Validate credentials
+            if (!credentials || typeof credentials !== "object") {
+                throw new Error("getCredentials() must return an object with headers and/or cookies");
+            }
+            // Merge credential headers with existing headers
+            const updatedHeaders = { ...headers };
+            if (credentials.headers) {
+                this.validateHeaders(credentials.headers);
+                Object.assign(updatedHeaders, credentials.headers);
+            }
+            // Note: Cookie handling would be browser-specific
+            // For now, we only support headers as cookies are automatically
+            // handled by the browser when using fetch()
+            if (credentials.cookies) {
+                this.attachCookies(updatedHeaders, credentials.cookies);
+            }
+            return updatedHeaders;
+        }
+        catch (error) {
+            // Wrap errors with context
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to attach auth credentials: ${message}`);
+        }
+    }
+    /**
+     * Validate that headers is a valid object with string keys and values
+     */
+    validateHeaders(headers) {
+        if (typeof headers !== "object" || headers === null) {
+            throw new Error("headers must be an object");
+        }
+        for (const [key, value] of Object.entries(headers)) {
+            if (typeof key !== "string" || typeof value !== "string") {
+                throw new Error(`Invalid header: key and value must be strings (got ${key}: ${typeof value})`);
+            }
+        }
+    }
+    /**
+     * Attach cookies to request headers.
+     * In browser environments, cookies are automatically handled by fetch().
+     * In Node.js, we need to manually add them to the Cookie header.
+     */
+    attachCookies(headers, cookies) {
+        // Check if we're in a browser environment
+        const isBrowser = this.platformService.isBrowser();
+        if (isBrowser) {
+            // In browsers, fetch() automatically sends cookies for same-origin requests
+            // For cross-origin, the server needs to set CORS headers and credentials: 'include'
+            // We can't manually set cookies in headers for security reasons
+            // So we just warn if cookies are provided in direct mode
+            this.logger.warn("DirectAuth: Cookies are automatically handled by the browser. " +
+                "Ensure your server has proper CORS configuration with credentials support.");
+        }
+        else {
+            // In Node.js, we can manually build the Cookie header
+            const cookieString = Object.entries(cookies)
+                .map(([key, value]) => `${key}=${value}`)
+                .join("; ");
+            if (cookieString) {
+                headers.Cookie = cookieString;
+            }
+        }
+    }
+}

package/dist/auth/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./auth-http-client";
+export * from "./direct-auth";
+export * from "./no-auth";
+export * from "./saas-auth";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}

package/dist/auth/index.js

@@ -0,0 +1,5 @@
+export * from "./auth-http-client";
+export * from "./direct-auth";
+export * from "./no-auth";
+export * from "./saas-auth";
+export * from "./types";

package/dist/auth/no-auth.d.ts

@@ -0,0 +1,26 @@
+import { BaseAuthManager } from "./types";
+/**
+ * No-auth manager - pass-through implementation for backward compatibility.
+ *
+ * When no auth configuration is provided, this manager is used to maintain
+ * a consistent interface without adding any authentication to requests.
+ */
+export declare class NoAuthManager extends BaseAuthManager {
+    constructor();
+    /**
+     * Pass through headers without modification.
+     *
+     * @param headers - Existing request headers
+     * @returns Same headers unchanged
+     */
+    attachCredentials(headers?: Record<string, string>): Promise<Record<string, string>>;
+    /**
+     * No-op for clearing tokens (NoAuthManager doesn't cache anything)
+     */
+    clearToken(_jobId: string): void;
+    /**
+     * No-op for clearing all tokens
+     */
+    clearAllTokens(): void;
+}
+//# sourceMappingURL=no-auth.d.ts.map

package/dist/auth/no-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-auth.d.ts","sourceRoot":"","sources":["../../src/auth/no-auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,eAAe;;IAKhD;;;;;OAKG;IACG,iBAAiB,CACrB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACnC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAIlC;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIhC;;OAEG;IACH,cAAc,IAAI,IAAI;CAGvB"}

package/dist/auth/no-auth.js

@@ -0,0 +1,33 @@
+import { BaseAuthManager } from "./types";
+/**
+ * No-auth manager - pass-through implementation for backward compatibility.
+ *
+ * When no auth configuration is provided, this manager is used to maintain
+ * a consistent interface without adding any authentication to requests.
+ */
+export class NoAuthManager extends BaseAuthManager {
+    constructor() {
+        super("no-auth");
+    }
+    /**
+     * Pass through headers without modification.
+     *
+     * @param headers - Existing request headers
+     * @returns Same headers unchanged
+     */
+    async attachCredentials(headers = {}) {
+        return headers;
+    }
+    /**
+     * No-op for clearing tokens (NoAuthManager doesn't cache anything)
+     */
+    clearToken(_jobId) {
+        // No-op
+    }
+    /**
+     * No-op for clearing all tokens
+     */
+    clearAllTokens() {
+        // No-op
+    }
+}

package/dist/auth/saas-auth.d.ts

@@ -0,0 +1,80 @@
+import type { HttpClient } from "../services/http-client";
+import { BaseAuthManager, type SaasAuthConfig } from "./types";
+/**
+ * Token response from the auth server
+ */
+export type TokenResponse = {
+    /** JWT token to use for authentication */
+    token: string;
+    /** Token expiration time in seconds (optional) */
+    expiresIn?: number;
+};
+/**
+ * SaaS auth manager - handles JWT token exchange with an auth server.
+ *
+ * Token exchange flow:
+ * 1. Client calls getCredentials() to get user credentials
+ * 2. Manager sends credentials to authServerUrl
+ * 3. Auth server validates credentials and returns JWT token
+ * 4. Manager caches token and attaches it to uploadista requests
+ * 5. Token is cached per job to minimize auth overhead
+ *
+ * Security: API keys are kept server-side in the auth server, never exposed to clients.
+ */
+export declare class SaasAuthManager extends BaseAuthManager {
+    private config;
+    private httpClient;
+    /** Token cache: maps job ID to cached token */
+    private tokenCache;
+    /** Global token for requests without a specific job ID */
+    private globalToken;
+    constructor(config: SaasAuthConfig, httpClient: HttpClient);
+    /**
+     * Fetch a JWT token from the auth server using user credentials.
+     *
+     * @returns Token response with JWT and optional expiry
+     * @throws Error if auth server is unreachable or returns an error
+     */
+    fetchToken(): Promise<TokenResponse>;
+    /**
+     * Get a cached token for a specific job, or fetch a new one if not cached.
+     *
+     * @param jobId - Optional job ID to cache token for specific job
+     * @returns Cached or newly fetched token
+     */
+    private getOrFetchToken;
+    /**
+     * Check if a cached token is expired.
+     * Adds a 60-second buffer to avoid using tokens that are about to expire.
+     */
+    private isTokenExpired;
+    /**
+     * Attach JWT token to an HTTP request as Authorization Bearer header.
+     *
+     * @param headers - Existing request headers
+     * @param jobId - Optional job ID to use cached token for specific job
+     * @returns Updated headers with Authorization header
+     * @throws Error if token fetch fails
+     */
+    attachToken(headers?: Record<string, string>, jobId?: string): Promise<Record<string, string>>;
+    /**
+     * Clear cached token for a specific job.
+     * Should be called when a job completes to free memory.
+     *
+     * @param jobId - Job ID to clear token for
+     */
+    clearToken(jobId: string): void;
+    /**
+     * Clear all cached tokens.
+     * Useful for logout or when switching users.
+     */
+    clearAllTokens(): void;
+    /**
+     * Get cache statistics for debugging and monitoring.
+     */
+    getCacheStats(): {
+        cachedJobCount: number;
+        hasGlobalToken: boolean;
+    };
+}
+//# sourceMappingURL=saas-auth.d.ts.map

package/dist/auth/saas-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saas-auth.d.ts","sourceRoot":"","sources":["../../src/auth/saas-auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAUF;;;;;;;;;;;GAWG;AACH,qBAAa,eAAgB,SAAQ,eAAe;IAQhD,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,UAAU;IARpB,+CAA+C;IAC/C,OAAO,CAAC,UAAU,CAAkC;IAEpD,0DAA0D;IAC1D,OAAO,CAAC,WAAW,CAA4B;gBAGrC,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,UAAU;IAKhC;;;;;OAKG;IACG,UAAU,IAAI,OAAO,CAAC,aAAa,CAAC;IAgD1C;;;;;OAKG;YACW,eAAe;IAqC7B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAWtB;;;;;;;OAOG;IACG,WAAW,CACf,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACpC,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAgBlC;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI/B;;;OAGG;IACH,cAAc,IAAI,IAAI;IAKtB;;OAEG;IACH,aAAa,IAAI;QACf,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,OAAO,CAAC;KACzB;CAMF"}