@aifabrix/miso-client 3.1.2 → 3.2.5

package/dist/utils/data-client-auto-init.js

@@ -0,0 +1,259 @@
+"use strict";
+/**
+ * DataClient Auto-Initialization Helper
+ * Automatically fetches configuration from server and initializes DataClient
+ *
+ * Provides zero-config client-side setup for DataClient initialization
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCachedDataClientConfig = getCachedDataClientConfig;
+exports.autoInitializeDataClient = autoInitializeDataClient;
+const data_client_1 = require("./data-client");
+const data_client_utils_1 = require("./data-client-utils");
+const client_token_endpoint_1 = require("../express/client-token-endpoint");
+/**
+ * Get cached config from localStorage
+ *
+ * @returns Cached config or null if not found or expired
+ */
+function getCachedConfig() {
+    if (!(0, data_client_utils_1.isBrowser)()) {
+        return null;
+    }
+    try {
+        const cachedStr = (0, data_client_utils_1.getLocalStorage)("miso:dataclient-config");
+        if (!cachedStr) {
+            return null;
+        }
+        const cached = JSON.parse(cachedStr);
+        // Check if expired
+        if (cached.expiresAt && cached.expiresAt < Date.now()) {
+            (0, data_client_utils_1.removeLocalStorage)("miso:dataclient-config");
+            return null;
+        }
+        return cached;
+    }
+    catch {
+        // Invalid cache, remove it
+        (0, data_client_utils_1.removeLocalStorage)("miso:dataclient-config");
+        return null;
+    }
+}
+/**
+ * Get cached DataClient configuration from localStorage
+ *
+ * Returns the cached configuration that was stored by autoInitializeDataClient.
+ * Useful for reading configuration without re-initializing DataClient.
+ *
+ * @returns Cached config or null if not found or expired
+ *
+ * @example
+ * ```typescript
+ * import { getCachedDataClientConfig } from '@aifabrix/miso-client';
+ *
+ * const cachedConfig = getCachedDataClientConfig();
+ * if (cachedConfig) {
+ *   console.log('Base URL:', cachedConfig.baseUrl);
+ *   console.log('Controller URL:', cachedConfig.controllerUrl);
+ *   console.log('Client ID:', cachedConfig.clientId);
+ * }
+ * ```
+ */
+function getCachedDataClientConfig() {
+    const cached = getCachedConfig();
+    return cached?.config || null;
+}
+/**
+ * Cache config in localStorage
+ *
+ * @param config - Config to cache
+ * @param expiresIn - Expiration time in seconds
+ */
+function cacheConfig(config, expiresIn) {
+    if (!(0, data_client_utils_1.isBrowser)()) {
+        return;
+    }
+    try {
+        const cached = {
+            config,
+            expiresAt: Date.now() + expiresIn * 1000,
+        };
+        (0, data_client_utils_1.setLocalStorage)("miso:dataclient-config", JSON.stringify(cached));
+    }
+    catch {
+        // Ignore localStorage errors (SSR, private browsing, etc.)
+    }
+}
+/**
+ * Fetch config from server endpoint
+ *
+ * @param baseUrl - Base URL for the API
+ * @param clientTokenUri - Client token endpoint URI
+ * @returns Config response
+ */
+async function fetchConfig(baseUrl, clientTokenUri) {
+    // Build full URL
+    const fullUrl = /^https?:\/\//i.test(clientTokenUri)
+        ? clientTokenUri
+        : `${baseUrl}${clientTokenUri}`;
+    // Add timeout to prevent hanging (30 seconds)
+    const timeout = 30000;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    try {
+        // Try POST first (standard), fallback to GET
+        let response;
+        try {
+            response = await fetch(fullUrl, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                },
+                credentials: "include",
+                signal: controller.signal,
+            });
+        }
+        catch (fetchError) {
+            clearTimeout(timeoutId);
+            // Handle timeout and network errors
+            const errorMessage = fetchError instanceof Error ? fetchError.message : String(fetchError);
+            const errorName = fetchError instanceof Error ? fetchError.name : "Unknown";
+            if (errorName === "AbortError" || errorMessage.includes("aborted")) {
+                throw new Error(`Request timeout: The client token endpoint did not respond within ${timeout}ms. ` +
+                    `Please check if the server is running and accessible at ${fullUrl}`);
+            }
+            if (errorMessage.includes("ERR_EMPTY_RESPONSE") || errorMessage.includes("empty response")) {
+                throw new Error(`Connection error: The server closed the connection without sending a response. ` +
+                    `Please check if the server is running and accessible at ${fullUrl}`);
+            }
+            if (errorMessage.includes("Failed to fetch") || errorMessage.includes("network")) {
+                throw new Error(`Network error: Cannot connect to ${fullUrl}. ` +
+                    `Please check your network connection and ensure the server is running.`);
+            }
+            throw new Error(`Failed to fetch config: ${errorMessage}`);
+        }
+        clearTimeout(timeoutId);
+        // If POST fails with 405, try GET
+        if (response.status === 405) {
+            const getController = new AbortController();
+            const getTimeoutId = setTimeout(() => getController.abort(), timeout);
+            try {
+                response = await fetch(fullUrl, {
+                    method: "GET",
+                    credentials: "include",
+                    signal: getController.signal,
+                });
+                clearTimeout(getTimeoutId);
+            }
+            catch (fetchError) {
+                clearTimeout(getTimeoutId);
+                const errorMessage = fetchError instanceof Error ? fetchError.message : String(fetchError);
+                const errorName = fetchError instanceof Error ? fetchError.name : "Unknown";
+                if (errorName === "AbortError" || errorMessage.includes("aborted")) {
+                    throw new Error(`Request timeout: The client token endpoint did not respond within ${timeout}ms. ` +
+                        `Please check if the server is running and accessible at ${fullUrl}`);
+                }
+                throw new Error(`Failed to fetch config: ${errorMessage}`);
+            }
+        }
+        if (!response.ok) {
+            const errorText = await response.text().catch(() => "Unable to read error response");
+            throw new Error(`Failed to fetch config: ${response.status} ${response.statusText}. ${errorText}`);
+        }
+        const data = (await response.json());
+        // Check if response has config
+        if (!(0, client_token_endpoint_1.hasConfig)(data)) {
+            throw new Error("Invalid response format: config not found in response. " +
+                "Make sure your server endpoint uses createClientTokenEndpoint() helper.");
+        }
+        return data.config;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw error;
+        }
+        throw new Error(`Network error: ${String(error)}`);
+    }
+}
+/**
+ * Auto-initialize DataClient with server-provided configuration
+ *
+ * Automatically:
+ * 1. Detects if running in browser
+ * 2. Checks localStorage cache first
+ * 3. Fetches config from server endpoint if needed
+ * 4. Initializes DataClient with server-provided config
+ * 5. Caches config for future use
+ *
+ * @param options - Optional configuration
+ * @returns Initialized DataClient instance
+ * @throws Error if initialization fails
+ *
+ * @example
+ * ```typescript
+ * import { autoInitializeDataClient } from '@aifabrix/miso-client';
+ *
+ * // One line - everything is automatic
+ * const dataClient = await autoInitializeDataClient();
+ * ```
+ */
+async function autoInitializeDataClient(options) {
+    // Check if running in browser
+    if (!(0, data_client_utils_1.isBrowser)()) {
+        throw new Error("autoInitializeDataClient() is only available in browser environment");
+    }
+    const opts = {
+        clientTokenUri: options?.clientTokenUri || "/api/v1/auth/client-token",
+        cacheConfig: options?.cacheConfig ?? true,
+        baseUrl: options?.baseUrl,
+        onError: options?.onError,
+    };
+    try {
+        // Auto-detect baseUrl from window.location if not provided
+        const baseUrl = opts.baseUrl ||
+            ((0, data_client_utils_1.isBrowser)()
+                ? globalThis.window.location.origin
+                : "");
+        if (!baseUrl) {
+            throw new Error("Unable to detect baseUrl. Please provide baseUrl option.");
+        }
+        let config = null;
+        // Check cache first if enabled
+        if (opts.cacheConfig) {
+            const cached = getCachedConfig();
+            if (cached) {
+                config = cached.config;
+            }
+        }
+        // Fetch from server if not cached
+        if (!config) {
+            config = await fetchConfig(baseUrl, opts.clientTokenUri);
+            // Cache config if enabled (use expiresIn from token response if available)
+            // Default to 30 minutes (1800 seconds) if not available
+            if (opts.cacheConfig) {
+                cacheConfig(config, 1800);
+            }
+        }
+        // Build DataClient config
+        const dataClientConfig = {
+            baseUrl: config.baseUrl,
+            misoConfig: {
+                clientId: config.clientId,
+                controllerUrl: config.controllerUrl,
+                controllerPublicUrl: config.controllerPublicUrl,
+                clientTokenUri: config.clientTokenUri,
+            },
+        };
+        // Initialize and return DataClient
+        return new data_client_1.DataClient(dataClientConfig);
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        // Call error callback if provided
+        if (opts.onError) {
+            opts.onError(err);
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=data-client-auto-init.js.map

package/dist/utils/data-client-auto-init.js.map

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

package/dist/utils/data-client-redirect.d.ts

@@ -0,0 +1,52 @@
+/**
+ * DataClient redirect utilities
+ * Handles redirect to login/logout flows
+ */
+import { MisoClient } from "../index";
+import { DataClientConfig } from "../types/data-client.types";
+/**
+ * Synchronously get and validate redirect URL
+ * Validates the URL before returning it
+ * @param url - URL to validate and return
+ * @param fallbackUrl - Optional fallback URL if primary is invalid
+ * @returns Validated URL string or null if both are invalid
+ */
+export declare function getValidatedRedirectUrl(url: string | null, fallbackUrl?: string | null): string | null;
+/**
+ * Redirect to controller login page
+ * Redirects user browser directly to controller's login URL with client token
+ * NO API CALLS - just browser redirect
+ *
+ * Flow:
+ * 1. User visits: http://localhost:4111/dataplane/
+ * 2. redirectToLogin() redirects to: {controllerPublicUrl}{loginUrl}?redirect={redirectUrl}&x-client-token={token}
+ * 3. Controller handles OAuth flow and redirects back after authentication
+ * 4. Controller redirects to: {redirectUrl}#token={userToken}
+ * 5. DataClient.handleOAuthCallback() extracts token from hash and stores securely
+ *
+ * Security:
+ * - Token is passed in hash fragment (#token=...) not query parameter
+ * - Hash fragments are NOT sent to server (not in logs)
+ * - Hash fragments are NOT stored in browser history
+ * - Token is immediately removed from URL after extraction
+ *
+ * @param config - DataClient configuration
+ * @param getClientTokenFn - Function to get client token
+ * @param redirectUrl - Optional redirect URL to return to after login (defaults to current page URL)
+ */
+export declare function redirectToLogin(config: DataClientConfig, getClientTokenFn: () => Promise<string | null>, redirectUrl?: string): Promise<void>;
+/**
+ * Logout user and redirect to controller logout page
+ * Clears tokens from localStorage, clears cache, and redirects to controller logout URL
+ * NO API CALLS - just browser redirect
+ * Controller handles the logout process
+ *
+ * @param config - DataClient configuration
+ * @param getTokenFn - Function to get user token
+ * @param getClientTokenFn - Function to get client token
+ * @param clearCacheFn - Function to clear HTTP cache
+ * @param redirectUrl - Optional redirect URL after logout (defaults to logoutUrl or loginUrl)
+ * @param _misoClient - MisoClient instance (not used, kept for API compatibility)
+ */
+export declare function logout(config: DataClientConfig, getTokenFn: () => string | null, getClientTokenFn: () => Promise<string | null>, clearCacheFn: () => void, redirectUrl?: string, _misoClient?: MisoClient | null): Promise<void>;
+//# sourceMappingURL=data-client-redirect.d.ts.map

package/dist/utils/data-client-redirect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-client-redirect.d.ts","sourceRoot":"","sources":["../../src/utils/data-client-redirect.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAkD9D;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAiBtG;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,gBAAgB,EACxB,gBAAgB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,EAC9C,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CA2Df;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,MAAM,CAC1B,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,MAAM,GAAG,IAAI,EAC/B,gBAAgB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,EAC9C,YAAY,EAAE,MAAM,IAAI,EACxB,WAAW,CAAC,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,UAAU,GAAG,IAAI,GAC9B,OAAO,CAAC,IAAI,CAAC,CAiFf"}

package/dist/utils/data-client-redirect.js

@@ -0,0 +1,233 @@
+"use strict";
+/**
+ * DataClient redirect utilities
+ * Handles redirect to login/logout flows
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getValidatedRedirectUrl = getValidatedRedirectUrl;
+exports.redirectToLogin = redirectToLogin;
+exports.logout = logout;
+const data_client_auth_1 = require("./data-client-auth");
+const data_client_utils_1 = require("./data-client-utils");
+/**
+ * Validate redirect URL for safety and format
+ * Checks for valid URL format and safe protocols (http, https)
+ * @param url - URL to validate
+ * @returns Validated URL string or null if invalid
+ */
+function validateRedirectUrl(url) {
+    if (!url || typeof url !== 'string' || url.trim() === '') {
+        return null;
+    }
+    const trimmedUrl = url.trim();
+    // Check for dangerous protocols (javascript:, data:, etc.)
+    const dangerousProtocols = ['javascript:', 'data:', 'vbscript:', 'file:', 'about:'];
+    const lowerUrl = trimmedUrl.toLowerCase();
+    for (const protocol of dangerousProtocols) {
+        if (lowerUrl.startsWith(protocol)) {
+            return null;
+        }
+    }
+    // Try to parse as URL
+    let parsedUrl;
+    try {
+        // If it's a relative URL, create a full URL using current origin
+        if (trimmedUrl.startsWith('/') || !trimmedUrl.includes('://')) {
+            const origin = globalThis.window.location.origin;
+            parsedUrl = new URL(trimmedUrl, origin);
+        }
+        else {
+            parsedUrl = new URL(trimmedUrl);
+        }
+    }
+    catch (error) {
+        return null;
+    }
+    // Only allow http and https protocols
+    if (parsedUrl.protocol !== 'http:' && parsedUrl.protocol !== 'https:') {
+        return null;
+    }
+    // Return the validated URL (use href to get full URL)
+    const validatedUrl = parsedUrl.href;
+    return validatedUrl;
+}
+/**
+ * Synchronously get and validate redirect URL
+ * Validates the URL before returning it
+ * @param url - URL to validate and return
+ * @param fallbackUrl - Optional fallback URL if primary is invalid
+ * @returns Validated URL string or null if both are invalid
+ */
+function getValidatedRedirectUrl(url, fallbackUrl) {
+    // Try primary URL first
+    const validatedUrl = validateRedirectUrl(url);
+    if (validatedUrl) {
+        return validatedUrl;
+    }
+    // Try fallback URL if provided
+    if (fallbackUrl) {
+        const validatedFallback = validateRedirectUrl(fallbackUrl);
+        if (validatedFallback) {
+            return validatedFallback;
+        }
+    }
+    // Both URLs invalid
+    return null;
+}
+/**
+ * Redirect to controller login page
+ * Redirects user browser directly to controller's login URL with client token
+ * NO API CALLS - just browser redirect
+ *
+ * Flow:
+ * 1. User visits: http://localhost:4111/dataplane/
+ * 2. redirectToLogin() redirects to: {controllerPublicUrl}{loginUrl}?redirect={redirectUrl}&x-client-token={token}
+ * 3. Controller handles OAuth flow and redirects back after authentication
+ * 4. Controller redirects to: {redirectUrl}#token={userToken}
+ * 5. DataClient.handleOAuthCallback() extracts token from hash and stores securely
+ *
+ * Security:
+ * - Token is passed in hash fragment (#token=...) not query parameter
+ * - Hash fragments are NOT sent to server (not in logs)
+ * - Hash fragments are NOT stored in browser history
+ * - Token is immediately removed from URL after extraction
+ *
+ * @param config - DataClient configuration
+ * @param getClientTokenFn - Function to get client token
+ * @param redirectUrl - Optional redirect URL to return to after login (defaults to current page URL)
+ */
+async function redirectToLogin(config, getClientTokenFn, redirectUrl) {
+    if (!(0, data_client_utils_1.isBrowser)()) {
+        return;
+    }
+    const currentUrl = globalThis.window.location.href;
+    const finalRedirectUrl = redirectUrl || currentUrl;
+    // Get controller public URL (for browser environments)
+    const controllerUrl = (0, data_client_auth_1.getControllerUrl)(config.misoConfig);
+    if (!controllerUrl) {
+        const error = new Error("Controller URL is not configured. Please configure controllerUrl or controllerPublicUrl in your DataClient configuration.");
+        error.details = {
+            hasMisoConfig: !!config.misoConfig,
+            controllerUrl: config.misoConfig?.controllerUrl,
+            controllerPublicUrl: config.misoConfig?.controllerPublicUrl,
+            controllerPrivateUrl: config.misoConfig?.controllerPrivateUrl,
+        };
+        throw error;
+    }
+    // Get client token
+    const clientToken = await getClientTokenFn();
+    // Get login URL from config (defaults to '/login')
+    // Validate that loginUrl is not an API endpoint (should be a page, not /api/...)
+    let loginPath = config.loginUrl || '/login';
+    // Warn if loginUrl looks like an API endpoint (common mistake)
+    if (loginPath.startsWith('/api/')) {
+        console.warn(`⚠️ Warning: loginUrl is set to an API endpoint (${loginPath}). ` +
+            `redirectToLogin() should redirect to a login PAGE (e.g., '/login'), not an API endpoint. ` +
+            `Using default '/login' instead.`);
+        loginPath = '/login';
+    }
+    // Build full controller login URL
+    // If loginPath is already a full URL, use it; otherwise prepend controllerUrl
+    let loginUrl;
+    if (/^https?:\/\//i.test(loginPath)) {
+        loginUrl = new URL(loginPath);
+    }
+    else {
+        loginUrl = new URL(loginPath, controllerUrl);
+    }
+    // Add redirect parameter
+    loginUrl.searchParams.set('redirect', finalRedirectUrl);
+    // Add client token as query parameter (controller will read it)
+    if (clientToken) {
+        loginUrl.searchParams.set('x-client-token', clientToken);
+    }
+    // Redirect user directly to controller login page
+    // Controller handles OAuth flow and redirects back after authentication
+    globalThis.window.location.href = loginUrl.toString();
+}
+/**
+ * Logout user and redirect to controller logout page
+ * Clears tokens from localStorage, clears cache, and redirects to controller logout URL
+ * NO API CALLS - just browser redirect
+ * Controller handles the logout process
+ *
+ * @param config - DataClient configuration
+ * @param getTokenFn - Function to get user token
+ * @param getClientTokenFn - Function to get client token
+ * @param clearCacheFn - Function to clear HTTP cache
+ * @param redirectUrl - Optional redirect URL after logout (defaults to logoutUrl or loginUrl)
+ * @param _misoClient - MisoClient instance (not used, kept for API compatibility)
+ */
+async function logout(config, getTokenFn, getClientTokenFn, clearCacheFn, redirectUrl, _misoClient) {
+    if (!(0, data_client_utils_1.isBrowser)())
+        return;
+    // Get tokens BEFORE clearing (needed for passing to controller)
+    const token = getTokenFn();
+    const clientToken = await getClientTokenFn();
+    // Clear tokens from localStorage
+    const keys = config.tokenKeys || ["token", "accessToken", "authToken"];
+    keys.forEach(key => {
+        try {
+            const storage = globalThis.localStorage;
+            if (storage) {
+                storage.removeItem(key);
+            }
+        }
+        catch (e) {
+            // Ignore localStorage errors (SSR, private browsing, etc.)
+        }
+    });
+    // Clear HTTP cache
+    clearCacheFn();
+    // Get controller public URL (for browser environments)
+    const controllerUrl = (0, data_client_auth_1.getControllerUrl)(config.misoConfig);
+    if (!controllerUrl) {
+        // Fallback to local redirect if controller URL not configured
+        const finalRedirectUrl = redirectUrl || config.logoutUrl || config.loginUrl || "/login";
+        const origin = globalThis.window.location.origin;
+        const fullUrl = /^https?:\/\//i.test(finalRedirectUrl)
+            ? finalRedirectUrl
+            : `${origin}${finalRedirectUrl.startsWith("/") ? finalRedirectUrl : `/${finalRedirectUrl}`}`;
+        const validatedUrl = getValidatedRedirectUrl(fullUrl);
+        if (validatedUrl) {
+            globalThis.window.location.href = validatedUrl;
+        }
+        return;
+    }
+    // Get logout URL from config (defaults to '/logout' or falls back to '/login')
+    const logoutPath = config.logoutUrl || config.loginUrl || '/logout';
+    // Build full controller logout URL
+    // If logoutPath is already a full URL, use it; otherwise prepend controllerUrl
+    let logoutUrl;
+    if (/^https?:\/\//i.test(logoutPath)) {
+        logoutUrl = new URL(logoutPath);
+    }
+    else {
+        logoutUrl = new URL(logoutPath, controllerUrl);
+    }
+    // Determine redirect URL: redirectUrl param > logoutUrl config > loginUrl config > '/login'
+    const finalRedirectUrl = redirectUrl || config.logoutUrl || config.loginUrl || "/login";
+    // Construct full redirect URL (if relative, make absolute)
+    let fullRedirectUrl;
+    if (/^https?:\/\//i.test(finalRedirectUrl)) {
+        fullRedirectUrl = finalRedirectUrl;
+    }
+    else {
+        const origin = globalThis.window.location.origin;
+        fullRedirectUrl = `${origin}${finalRedirectUrl.startsWith("/") ? finalRedirectUrl : `/${finalRedirectUrl}`}`;
+    }
+    logoutUrl.searchParams.set('redirect', fullRedirectUrl);
+    // Add client token as query parameter (controller will read it)
+    if (clientToken) {
+        logoutUrl.searchParams.set('x-client-token', clientToken);
+    }
+    // Add user token as query parameter if available (controller will read it)
+    // Token was retrieved before clearing localStorage
+    if (token) {
+        logoutUrl.searchParams.set('token', token);
+    }
+    // Redirect user directly to controller logout page
+    // Controller handles logout process and redirects back
+    globalThis.window.location.href = logoutUrl.toString();
+}
+//# sourceMappingURL=data-client-redirect.js.map

package/dist/utils/data-client-redirect.js.map

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

package/dist/utils/data-client-request.d.ts

@@ -5,6 +5,13 @@
 import { ApiRequestOptions, DataClientConfig, InterceptorConfig, CacheEntry } from "../types/data-client.types";
 import { HasAnyTokenFn, GetTokenFn } from "./data-client-audit";
 import { MisoClient } from "../index";
+/**
+ * Token refresh callback function type
+ */
+export type RefreshUserTokenFn = () => Promise<{
+    token: string;
+    expiresIn: number;
+} | null>;
 /**
  * Extract headers from Headers object or Record
  */
@@ -24,7 +31,7 @@ export declare function makeFetchRequest(method: string, url: string, config: Da
 /**
  * Execute HTTP request with retry logic
  */
-export declare function executeHttpRequest<T>(method: string, fullUrl: string, endpoint: string, config: DataClientConfig, cache: Map<string, CacheEntry>, cacheKey: string, cacheEnabled: boolean, startTime: number, misoClient: MisoClient | null, hasAnyToken: HasAnyTokenFn, getToken: GetTokenFn, handleAuthError: () => void, interceptors: InterceptorConfig, metrics: {
+export declare function executeHttpRequest<T>(method: string, fullUrl: string, endpoint: string, config: DataClientConfig, cache: Map<string, CacheEntry>, cacheKey: string, cacheEnabled: boolean, startTime: number, misoClient: MisoClient | null, hasAnyToken: HasAnyTokenFn, getToken: GetTokenFn, handleAuthError: () => void, refreshUserToken: RefreshUserTokenFn, interceptors: InterceptorConfig, metrics: {
     totalRequests: number;
     totalFailures: number;
     responseTimes: number[];

package/dist/utils/data-client-request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-client-request.d.ts","sourceRoot":"","sources":["../../src/utils/data-client-request.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAKhB,iBAAiB,EACjB,UAAU,EACX,MAAM,4BAA4B,CAAC;AAOpC,OAAO,EAAsB,aAAa,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,GACnG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAsBpC;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CASrE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,WAAW,GACnB,WAAW,CAkBb;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,UAAU,EACpB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,QAAQ,CAAC,CAqDnB;AA0LD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAC9B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,OAAO,EACrB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,UAAU,GAAG,IAAI,EAC7B,WAAW,EAAE,aAAa,EAC1B,QAAQ,EAAE,UAAU,EACpB,eAAe,EAAE,MAAM,IAAI,EAC3B,YAAY,EAAE,iBAAiB,EAC/B,OAAO,EAAE;IACP,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,EACD,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,CAAC,CAAC,CA+KZ"}
+{"version":3,"file":"data-client-request.d.ts","sourceRoot":"","sources":["../../src/utils/data-client-request.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAKhB,iBAAiB,EACjB,UAAU,EACX,MAAM,4BAA4B,CAAC;AAOpC,OAAO,EAAsB,aAAa,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAAC;AAE5F;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,GACnG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAsBpC;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CASrE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,WAAW,GACnB,WAAW,CAkBb;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,UAAU,EACpB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,QAAQ,CAAC,CAgEnB;AA0LD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAC9B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,OAAO,EACrB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,UAAU,GAAG,IAAI,EAC7B,WAAW,EAAE,aAAa,EAC1B,QAAQ,EAAE,UAAU,EACpB,eAAe,EAAE,MAAM,IAAI,EAC3B,gBAAgB,EAAE,kBAAkB,EACpC,YAAY,EAAE,iBAAiB,EAC/B,OAAO,EAAE;IACP,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,EACD,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,CAAC,CAAC,CAqMZ"}