@oxyhq/services 5.18.0 → 5.18.2

package/lib/typescript/module/core/mixins/OxyServices.redirect.d.ts

@@ -0,0 +1,246 @@
+import type { OxyServicesBase } from '../OxyServices.base';
+import type { SessionLoginResponse } from '../../models/session';
+export interface RedirectAuthOptions {
+    redirectUri?: string;
+    mode?: 'login' | 'signup';
+    preserveUrl?: boolean;
+}
+/**
+ * Redirect-based Cross-Domain Authentication Mixin
+ *
+ * Implements traditional OAuth2 redirect flow as a fallback when popup or
+ * FedCM are not available or fail (e.g., mobile browsers, popup blockers).
+ *
+ * Flow:
+ * 1. Save current URL
+ * 2. Redirect to auth.oxy.so/login
+ * 3. User signs in
+ * 4. Redirect back with token in URL
+ * 5. Extract token, restore session, clean URL
+ *
+ * Features:
+ * - Works on all browsers (including old mobile browsers)
+ * - Automatic URL cleanup after auth
+ * - State preservation option
+ * - CSRF protection via state parameter
+ *
+ * Trade-offs:
+ * - Loses JavaScript app state (full page navigation)
+ * - Visible redirect (user sees navigation)
+ * - Slower perceived performance
+ */
+export declare function OxyServicesRedirectAuthMixin<T extends typeof OxyServicesBase>(Base: T): {
+    new (...args: any[]): {
+        /**
+         * Sign in using full page redirect
+         *
+         * Redirects the user to auth.oxy.so for authentication. After successful
+         * sign-in, the user will be redirected back to the current page (or custom
+         * redirect URI) with authentication tokens in the URL.
+         *
+         * Call handleAuthCallback() on app startup to complete the flow.
+         *
+         * @param options - Redirect configuration options
+         *
+         * @example
+         * ```typescript
+         * // Initiate sign-in
+         * const handleSignIn = () => {
+         *   oxyServices.signInWithRedirect();
+         * };
+         *
+         * // Handle callback on app startup
+         * useEffect(() => {
+         *   const session = oxyServices.handleAuthCallback();
+         *   if (session) {
+         *     setUser(session.user);
+         *   }
+         * }, []);
+         * ```
+         */
+        signInWithRedirect(options?: RedirectAuthOptions): void;
+        /**
+         * Sign up using full page redirect
+         *
+         * Same as signInWithRedirect but opens the signup page by default.
+         */
+        signUpWithRedirect(options?: RedirectAuthOptions): void;
+        /**
+         * Handle authentication callback
+         *
+         * Call this on app startup to check if the current page load is a
+         * redirect back from the authentication server. If it is, this method
+         * will extract the tokens, store them, and clean up the URL.
+         *
+         * @returns Session data if this is a callback, null otherwise
+         * @throws {OxyAuthenticationError} If state validation fails (CSRF attack)
+         *
+         * @example
+         * ```typescript
+         * // In your app's root component or startup logic
+         * useEffect(() => {
+         *   try {
+         *     const session = oxyServices.handleAuthCallback();
+         *     if (session) {
+         *       console.log('Logged in:', session.user);
+         *       setUser(session.user);
+         *     } else {
+         *       // Not a callback, check for existing session
+         *       const restored = oxyServices.restoreSession();
+         *       if (!restored) {
+         *         // No session, show login button
+         *       }
+         *     }
+         *   } catch (error) {
+         *     console.error('Auth callback failed:', error);
+         *   }
+         * }, []);
+         * ```
+         */
+        handleAuthCallback(): SessionLoginResponse | null;
+        /**
+         * Restore session from storage
+         *
+         * Attempts to restore a previously authenticated session from localStorage.
+         * Call this on app startup if handleAuthCallback() returns null.
+         *
+         * @returns True if session was restored, false otherwise
+         *
+         * @example
+         * ```typescript
+         * useEffect(() => {
+         *   const session = oxyServices.handleAuthCallback();
+         *   if (!session) {
+         *     const restored = oxyServices.restoreSession();
+         *     if (!restored) {
+         *       // No session, user needs to sign in
+         *       setShowLogin(true);
+         *     }
+         *   }
+         * }, []);
+         * ```
+         */
+        restoreSession(): boolean;
+        /**
+         * Clear stored session
+         *
+         * Removes all authentication data from storage. Call this on logout.
+         */
+        clearStoredSession(): void;
+        /**
+         * Get stored session ID
+         */
+        getStoredSessionId(): string | null;
+        /**
+         * Build authentication URL with query parameters
+         *
+         * @private
+         */
+        buildAuthUrl(params: {
+            mode: string;
+            redirectUri: string;
+            state: string;
+            nonce: string;
+            clientId: string;
+        }): string;
+        /**
+         * Store tokens in localStorage
+         *
+         * @private
+         */
+        storeTokens(accessToken: string, sessionId: string): void;
+        /**
+         * Generate cryptographically secure state for CSRF protection
+         *
+         * @private
+         */
+        generateState(): string;
+        /**
+         * Generate nonce for replay attack prevention
+         *
+         * @private
+         */
+        generateNonce(): string;
+        /**
+         * Store auth state in session storage
+         *
+         * @private
+         */
+        storeAuthState(state: string, nonce: string): void;
+        /**
+         * Get stored state
+         *
+         * @private
+         */
+        getStoredState(): string | null;
+        /**
+         * Clear auth state from storage
+         *
+         * @private
+         */
+        clearAuthState(): void;
+        /**
+         * Save pre-authentication URL to restore later
+         *
+         * @private
+         */
+        savePreAuthUrl(url: string): void;
+        /**
+         * Clean authentication parameters from URL
+         *
+         * @private
+         */
+        cleanAuthCallbackUrl(url: URL): void;
+        httpService: import("../HttpService").HttpService;
+        cloudURL: string;
+        config: import("../OxyServices.base").OxyConfig;
+        makeRequest<T_1>(method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE", url: string, data?: any, options?: import("../HttpService").RequestOptions): Promise<T_1>;
+        getBaseURL(): string;
+        getClient(): import("../HttpService").HttpService;
+        getMetrics(): {
+            totalRequests: number;
+            successfulRequests: number;
+            failedRequests: number;
+            cacheHits: number;
+            cacheMisses: number;
+            averageResponseTime: number;
+        };
+        clearCache(): void;
+        clearCacheEntry(key: string): void;
+        getCacheStats(): {
+            size: number;
+            hits: number;
+            misses: number;
+            hitRate: number;
+        };
+        getCloudURL(): string;
+        setTokens(accessToken: string, refreshToken?: string): void;
+        clearTokens(): void;
+        getCurrentUserId(): string | null;
+        hasValidToken(): boolean;
+        getAccessToken(): string | null;
+        waitForAuth(timeoutMs?: number): Promise<boolean>;
+        withAuthRetry<T_1>(operation: () => Promise<T_1>, operationName: string, options?: {
+            maxRetries?: number;
+            retryDelay?: number;
+            authTimeoutMs?: number;
+        }): Promise<T_1>;
+        validate(): Promise<boolean>;
+        handleError(error: unknown): Error;
+        healthCheck(): Promise<{
+            status: string;
+            users?: number;
+            timestamp?: string;
+            [key: string]: any;
+        }>;
+    };
+    readonly AUTH_URL: "https://auth.oxy.so";
+    readonly TOKEN_STORAGE_KEY: "oxy_access_token";
+    readonly SESSION_STORAGE_KEY: "oxy_session_id";
+    readonly STATE_STORAGE_KEY: "oxy_auth_state";
+    readonly PRE_AUTH_URL_KEY: "oxy_pre_auth_url";
+    readonly NONCE_STORAGE_KEY: "oxy_auth_nonce";
+    __resetTokensForTests(): void;
+} & T;
+export { OxyServicesRedirectAuthMixin as RedirectAuthMixin };
+//# sourceMappingURL=OxyServices.redirect.d.ts.map

package/lib/typescript/module/core/mixins/OxyServices.redirect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OxyServices.redirect.d.ts","sourceRoot":"","sources":["../../../../../src/core/mixins/OxyServices.redirect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,SAAS,OAAO,eAAe,EAAE,IAAI,EAAE,CAAC;kBAE7D,GAAG,EAAE;QAU5B;;;;;;;;;;;;;;;;;;;;;;;;;;WA0BG;qCACyB,mBAAmB,GAAQ,IAAI;QA8B3D;;;;WAIG;qCACyB,mBAAmB,GAAQ,IAAI;QAI3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WA+BG;8BACmB,oBAAoB,GAAG,IAAI;QAoDjD;;;;;;;;;;;;;;;;;;;;;WAqBG;0BACe,OAAO;QAgBzB;;;;WAIG;8BACmB,IAAI;QAU1B;;WAEG;8BACmB,MAAM,GAAG,IAAI;QAQnC;;;;WAIG;6BACyB;YAC1B,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,EAAE,MAAM,CAAC;YACpB,KAAK,EAAE,MAAM,CAAC;YACd,KAAK,EAAE,MAAM,CAAC;YACd,QAAQ,EAAE,MAAM,CAAC;SAClB,GAAG,MAAM;QAUV;;;;WAIG;iCAC6B,MAAM,aAAa,MAAM,GAAG,IAAI;QAShE;;;;WAIG;yBACqB,MAAM;QAO9B;;;;WAIG;yBACqB,MAAM;QAO9B;;;;WAIG;8BAC0B,MAAM,SAAS,MAAM,GAAG,IAAI;QASzD;;;;WAIG;0BACsB,MAAM,GAAG,IAAI;QAQtC;;;;WAIG;0BACsB,IAAI;QAU7B;;;;WAIG;4BACwB,MAAM,GAAG,IAAI;QAQxC;;;;WAIG;kCAC8B,GAAG,GAAG,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAnMA,CAAC;sBAGnC,CAAC;yBAA6B,CAAC;;;;;;iBAyH5B,CAAA;qBAAwB,CAAC;;;;uBA7QH,qBAAqB;gCACZ,kBAAkB;kCAChB,gBAAgB;gCAClB,gBAAgB;+BACjB,kBAAkB;gCACjB,gBAAgB;;MA6V5D;AAGD,OAAO,EAAE,4BAA4B,IAAI,iBAAiB,EAAE,CAAC"}

package/lib/typescript/module/core/mixins/OxyServices.security.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Security Methods Mixin
+ */
+import type { OxyServicesBase } from '../OxyServices.base';
+import type { SecurityActivity, SecurityActivityResponse, SecurityEventType } from '../../models/interfaces';
+export declare function OxyServicesSecurityMixin<T extends typeof OxyServicesBase>(Base: T): {
+    new (...args: any[]): {
+        /**
+         * Get user's security activity with pagination
+         * @param limit - Number of results (default: 50, max: 100)
+         * @param offset - Pagination offset (default: 0)
+         * @param eventType - Optional filter by event type
+         * @returns Security activity response with pagination
+         */
+        getSecurityActivity(limit?: number, offset?: number, eventType?: SecurityEventType): Promise<SecurityActivityResponse>;
+        /**
+         * Get recent security activity (convenience method)
+         * @param limit - Number of recent events to fetch (default: 10)
+         * @returns Array of recent security activities
+         */
+        getRecentSecurityActivity(limit?: number): Promise<SecurityActivity[]>;
+        /**
+         * Log private key exported event
+         * @param deviceId - Optional device ID for tracking
+         * @returns Promise that resolves when event is logged
+         */
+        logPrivateKeyExported(deviceId?: string): Promise<void>;
+        /**
+         * Log backup created event
+         * @param deviceId - Optional device ID for tracking
+         * @returns Promise that resolves when event is logged
+         */
+        logBackupCreated(deviceId?: string): Promise<void>;
+        httpService: import("../HttpService").HttpService;
+        cloudURL: string;
+        config: import("../OxyServices.base").OxyConfig;
+        makeRequest<T_1>(method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE", url: string, data?: any, options?: import("../HttpService").RequestOptions): Promise<T_1>;
+        getBaseURL(): string;
+        getClient(): import("../HttpService").HttpService;
+        getMetrics(): {
+            totalRequests: number;
+            successfulRequests: number;
+            failedRequests: number;
+            cacheHits: number;
+            cacheMisses: number;
+            averageResponseTime: number;
+        };
+        clearCache(): void;
+        clearCacheEntry(key: string): void;
+        getCacheStats(): {
+            size: number;
+            hits: number;
+            misses: number;
+            hitRate: number;
+        };
+        getCloudURL(): string;
+        setTokens(accessToken: string, refreshToken?: string): void;
+        clearTokens(): void;
+        getCurrentUserId(): string | null;
+        hasValidToken(): boolean;
+        getAccessToken(): string | null;
+        waitForAuth(timeoutMs?: number): Promise<boolean>;
+        withAuthRetry<T_1>(operation: () => Promise<T_1>, operationName: string, options?: {
+            maxRetries?: number;
+            retryDelay?: number;
+            authTimeoutMs?: number;
+        }): Promise<T_1>;
+        validate(): Promise<boolean>;
+        handleError(error: unknown): Error;
+        healthCheck(): Promise<{
+            status: string;
+            users?: number;
+            timestamp?: string;
+            [key: string]: any;
+        }>;
+    };
+    __resetTokensForTests(): void;
+} & T;
+//# sourceMappingURL=OxyServices.security.d.ts.map

package/lib/typescript/module/core/mixins/OxyServices.security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OxyServices.security.d.ts","sourceRoot":"","sources":["../../../../../src/core/mixins/OxyServices.security.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE7G,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,OAAO,eAAe,EAAE,IAAI,EAAE,CAAC;kBAEzD,GAAG,EAAE;QAI1B;;;;;;WAMG;oCAEO,MAAM,WACL,MAAM,cACH,iBAAiB,GAC5B,OAAO,CAAC,wBAAwB,CAAC;QAoBpC;;;;WAIG;0CACoC,MAAM,GAAQ,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAShF;;;;WAIG;yCACoC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;QAiB7D;;;;WAIG;oCAC+B,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAmBkrF,CAAC;sBAA0B,CAAC;yBAA6B,CAAC;;;;;;iBAAuhG,CAAC;qBAAwB,CAAC;;;;;MAFx1L"}

package/lib/typescript/module/core/mixins/OxyServices.user.d.ts

@@ -0,0 +1,185 @@
+/**
+ * User Management Methods Mixin
+ */
+import type { User, Notification, SearchProfilesResponse } from '../../models/interfaces';
+import type { OxyServicesBase } from '../OxyServices.base';
+import { type PaginationParams } from '../../utils/apiUtils';
+export declare function OxyServicesUserMixin<T extends typeof OxyServicesBase>(Base: T): {
+    new (...args: any[]): {
+        /**
+         * Get profile by username
+         */
+        getProfileByUsername(username: string): Promise<User>;
+        /**
+         * Search user profiles
+         */
+        searchProfiles(query: string, pagination?: PaginationParams): Promise<SearchProfilesResponse>;
+        /**
+         * Get profile recommendations
+         */
+        getProfileRecommendations(): Promise<Array<{
+            id: string;
+            username: string;
+            name?: {
+                first?: string;
+                last?: string;
+                full?: string;
+            };
+            description?: string;
+            _count?: {
+                followers: number;
+                following: number;
+            };
+            [key: string]: any;
+        }>>;
+        /**
+         * Get user by ID
+         */
+        getUserById(userId: string): Promise<User>;
+        /**
+         * Get current user
+         */
+        getCurrentUser(): Promise<User>;
+        /**
+         * Update user profile
+         * TanStack Query handles offline queuing automatically
+         */
+        updateProfile(updates: Record<string, any>): Promise<User>;
+        /**
+         * Get privacy settings for a user
+         * @param userId - The user ID (defaults to current user)
+         */
+        getPrivacySettings(userId?: string): Promise<any>;
+        /**
+         * Update privacy settings
+         * @param settings - Partial privacy settings object
+         * @param userId - The user ID (defaults to current user)
+         */
+        updatePrivacySettings(settings: Record<string, any>, userId?: string): Promise<any>;
+        /**
+         * Request account verification
+         */
+        requestAccountVerification(reason: string, evidence?: string): Promise<{
+            message: string;
+            requestId: string;
+        }>;
+        /**
+         * Download account data export
+         */
+        downloadAccountData(format?: "json" | "csv"): Promise<Blob>;
+        /**
+         * Delete account permanently
+         * @param password - User password for confirmation
+         * @param confirmText - Confirmation text (usually username)
+         */
+        deleteAccount(password: string, confirmText: string): Promise<{
+            message: string;
+        }>;
+        /**
+         * Follow a user
+         */
+        followUser(userId: string): Promise<{
+            success: boolean;
+            message: string;
+        }>;
+        /**
+         * Unfollow a user
+         */
+        unfollowUser(userId: string): Promise<{
+            success: boolean;
+            message: string;
+        }>;
+        /**
+         * Get follow status
+         */
+        getFollowStatus(userId: string): Promise<{
+            isFollowing: boolean;
+        }>;
+        /**
+         * Get user followers
+         */
+        getUserFollowers(userId: string, pagination?: PaginationParams): Promise<{
+            followers: User[];
+            total: number;
+            hasMore: boolean;
+        }>;
+        /**
+         * Get user following
+         */
+        getUserFollowing(userId: string, pagination?: PaginationParams): Promise<{
+            following: User[];
+            total: number;
+            hasMore: boolean;
+        }>;
+        /**
+         * Get notifications
+         */
+        getNotifications(): Promise<Notification[]>;
+        /**
+         * Get unread notification count
+         */
+        getUnreadCount(): Promise<number>;
+        /**
+         * Create notification
+         */
+        createNotification(data: Partial<Notification>): Promise<Notification>;
+        /**
+         * Mark notification as read
+         */
+        markNotificationAsRead(notificationId: string): Promise<void>;
+        /**
+         * Mark all notifications as read
+         */
+        markAllNotificationsAsRead(): Promise<void>;
+        /**
+         * Delete notification
+         */
+        deleteNotification(notificationId: string): Promise<void>;
+        httpService: import("../HttpService").HttpService;
+        cloudURL: string;
+        config: import("../OxyServices.base").OxyConfig;
+        makeRequest<T_1>(method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE", url: string, data?: any, options?: import("../HttpService").RequestOptions): Promise<T_1>;
+        getBaseURL(): string;
+        getClient(): import("../HttpService").HttpService;
+        getMetrics(): {
+            totalRequests: number;
+            successfulRequests: number;
+            failedRequests: number;
+            cacheHits: number;
+            cacheMisses: number;
+            averageResponseTime: number;
+        };
+        clearCache(): void;
+        clearCacheEntry(key: string): void;
+        getCacheStats(): {
+            size: number;
+            hits: number;
+            misses: number;
+            hitRate: number;
+        };
+        getCloudURL(): string;
+        setTokens(accessToken: string, refreshToken?: string): void;
+        clearTokens(): void;
+        getCurrentUserId(): string | null;
+        hasValidToken(): boolean;
+        getAccessToken(): string | null;
+        waitForAuth(timeoutMs?: number): Promise<boolean>;
+        withAuthRetry<T_1>(operation: () => Promise<T_1>, operationName: string, options?: {
+            maxRetries?: number;
+            retryDelay?: number;
+            authTimeoutMs?: number;
+        }): Promise<T_1>;
+        validate(): Promise<boolean>;
+        handleError(error: unknown): Error;
+        healthCheck(): Promise<{
+            status: string;
+            users?: number;
+            timestamp? /**
+             * Get user followers
+             */: string;
+            [key: string]: any;
+        }>;
+    };
+    __resetTokensForTests(): void;
+} & T;
+//# sourceMappingURL=OxyServices.user.d.ts.map

package/lib/typescript/module/core/mixins/OxyServices.user.d.ts.map

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

package/lib/typescript/module/core/mixins/OxyServices.utility.d.ts

@@ -0,0 +1,94 @@
+import type { ApiError } from '../../models/interfaces';
+import type { OxyServicesBase } from '../OxyServices.base';
+export declare function OxyServicesUtilityMixin<T extends typeof OxyServicesBase>(Base: T): {
+    new (...args: any[]): {
+        /**
+         * Fetch link metadata
+         */
+        fetchLinkMetadata(url: string): Promise<{
+            url: string;
+            title: string;
+            description: string;
+            image?: string;
+        }>;
+        /**
+         * Simple Express.js authentication middleware
+         *
+         * Built-in authentication middleware that validates JWT tokens and adds user data to requests.
+         *
+         * @example
+         * ```typescript
+         * // Basic usage - just add it to your routes
+         * app.use('/api/protected', oxyServices.auth());
+         *
+         * // With debug logging
+         * app.use('/api/protected', oxyServices.auth({ debug: true }));
+         *
+         * // With custom error handling
+         * app.use('/api/protected', oxyServices.auth({
+         *   onError: (error) => console.error('Auth failed:', error)
+         * }));
+         *
+         * // Load full user data
+         * app.use('/api/protected', oxyServices.auth({ loadUser: true }));
+         * ```
+         *
+         * @param options Optional configuration
+         * @param options.debug Enable debug logging (default: false)
+         * @param options.onError Custom error handler
+         * @param options.loadUser Load full user data (default: false for performance)
+         * @param options.session Use session-based validation (default: false)
+         * @returns Express middleware function
+         */
+        auth(options?: {
+            debug?: boolean;
+            onError?: (error: ApiError) => any;
+            loadUser?: boolean;
+            session?: boolean;
+        }): (req: any, res: any, next: any) => any;
+        httpService: import("../HttpService").HttpService;
+        cloudURL: string;
+        config: import("../OxyServices.base").OxyConfig;
+        makeRequest<T_1>(method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE", url: string, data?: any, options?: import("../HttpService").RequestOptions): Promise<T_1>;
+        getBaseURL(): string;
+        getClient(): import("../HttpService").HttpService;
+        getMetrics(): {
+            totalRequests: number;
+            successfulRequests: number;
+            failedRequests: number;
+            cacheHits: number;
+            cacheMisses: number;
+            averageResponseTime: number;
+        };
+        clearCache(): void;
+        clearCacheEntry(key: string): void;
+        getCacheStats(): {
+            size: number;
+            hits: number;
+            misses: number;
+            hitRate: number;
+        };
+        getCloudURL(): string;
+        setTokens(accessToken: string, refreshToken?: string): void;
+        clearTokens(): void;
+        getCurrentUserId(): string | null;
+        hasValidToken(): boolean;
+        getAccessToken(): string | null;
+        waitForAuth(timeoutMs?: number): Promise<boolean>;
+        withAuthRetry<T_1>(operation: () => Promise<T_1>, operationName: string, options?: {
+            maxRetries?: number;
+            retryDelay?: number;
+            authTimeoutMs?: number;
+        }): Promise<T_1>;
+        validate(): Promise<boolean>;
+        handleError(error: unknown): Error;
+        healthCheck(): Promise<{
+            status: string;
+            users?: number;
+            timestamp?: string;
+            [key: string]: any;
+        }>;
+    };
+    __resetTokensForTests(): void;
+} & T;
+//# sourceMappingURL=OxyServices.utility.d.ts.map

package/lib/typescript/module/core/mixins/OxyServices.utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OxyServices.utility.d.ts","sourceRoot":"","sources":["../../../../../src/core/mixins/OxyServices.utility.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAQ,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAW3D,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,OAAO,eAAe,EAAE,IAAI,EAAE,CAAC;kBAExD,GAAG,EAAE;QAG1B;;WAEG;+BAC0B,MAAM,GAAG,OAAO,CAAC;YAC5C,GAAG,EAAE,MAAM,CAAC;YACZ,KAAK,EAAE,MAAM,CAAC;YACd,WAAW,EAAE,MAAM,CAAC;YACpB,KAAK,CAAC,EAAE,MAAM,CAAC;SAChB,CAAC;QAgBF;;;;;;;;;;;;;;;;;;;;;;;;;;;;WA4BG;uBACW;YACZ,KAAK,CAAC,EAAE,OAAO,CAAC;YAChB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,GAAG,CAAC;YACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,OAAO,CAAC,EAAE,OAAO,CAAC;SACnB,IAIS,KAAK,GAAG,EAAE,KAAK,GAAG,EAAE,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAkGjC,CAAV;sBAA0B,CAAC;yBAA6B,CAAC;;;;;;iBAOo6F,CAAC;qBAAwB,CAAC;;;;;MAFt/F"}