@oxyhq/services 5.26.3 → 5.27.0

package/dist/web/types/ui/hooks/mutations/mutationFactory.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Mutation Factory - Creates standardized mutations with optimistic updates
+ *
+ * This factory reduces boilerplate code for mutations that follow the common pattern:
+ * 1. Cancel outgoing queries
+ * 2. Snapshot previous data
+ * 3. Apply optimistic update
+ * 4. On error: rollback and show toast
+ * 5. On success: update cache, stores, and invalidate queries
+ */
+import { QueryClient, UseMutationOptions } from '@tanstack/react-query';
+import type { User } from '../../../models/interfaces';
+/**
+ * Configuration for creating a standard profile mutation
+ */
+export interface ProfileMutationConfig<TData, TVariables> {
+    /** The mutation function that makes the API call */
+    mutationFn: (variables: TVariables) => Promise<TData>;
+    /** Query keys to cancel before mutation */
+    cancelQueryKeys?: unknown[][];
+    /** Function to apply optimistic update to the user data */
+    optimisticUpdate?: (previousUser: User, variables: TVariables) => Partial<User>;
+    /** Error message to show on failure */
+    errorMessage?: string | ((error: Error) => string);
+    /** Success message to show (optional) */
+    successMessage?: string;
+    /** Whether to update authStore on success (default: true) */
+    updateAuthStore?: boolean;
+    /** Whether to invalidate user queries on success (default: true) */
+    invalidateUserQueries?: boolean;
+    /** Whether to invalidate account queries on success (default: true) */
+    invalidateAccountQueries?: boolean;
+    /** Custom onSuccess handler */
+    onSuccess?: (data: TData, variables: TVariables, queryClient: QueryClient) => void;
+}
+/**
+ * Creates a standard profile mutation with optimistic updates
+ *
+ * @example
+ * ```ts
+ * const updateProfile = createProfileMutation({
+ *   mutationFn: (updates) => oxyServices.updateProfile(updates),
+ *   optimisticUpdate: (user, updates) => updates,
+ *   errorMessage: 'Failed to update profile',
+ * });
+ * ```
+ */
+export declare function createProfileMutation<TVariables>(config: ProfileMutationConfig<User, TVariables>, queryClient: QueryClient, activeSessionId: string | null): UseMutationOptions<User, Error, TVariables, {
+    previousUser?: User;
+}>;
+/**
+ * Configuration for creating a generic mutation (non-profile)
+ */
+export interface GenericMutationConfig<TData, TVariables, TContext> {
+    /** The mutation function */
+    mutationFn: (variables: TVariables) => Promise<TData>;
+    /** Query key for optimistic data */
+    queryKey: unknown[];
+    /** Function to create optimistic data */
+    optimisticData?: (previous: TData | undefined, variables: TVariables) => TData;
+    /** Error message */
+    errorMessage?: string;
+    /** Success message */
+    successMessage?: string;
+    /** Additional queries to invalidate on success */
+    invalidateQueries?: unknown[][];
+}
+/**
+ * Creates a generic mutation with optimistic updates
+ */
+export declare function createGenericMutation<TData, TVariables>(config: GenericMutationConfig<TData, TVariables, {
+    previous?: TData;
+}>, queryClient: QueryClient): UseMutationOptions<TData, Error, TVariables, {
+    previous?: TData;
+}>;

package/dist/web/types/ui/hooks/mutations/useAccountMutations.d.ts

@@ -0,0 +1,68 @@
+import type { User } from '../../../models/interfaces';
+/**
+ * Update user profile with optimistic updates and offline queue support
+ */
+export declare const useUpdateProfile: () => import("@tanstack/react-query").UseMutationResult<User, Error, Partial<User>, {
+    previousUser: User | undefined;
+}>;
+/**
+ * Upload avatar with progress tracking and offline queue support
+ */
+export declare const useUploadAvatar: () => import("@tanstack/react-query").UseMutationResult<User, Error, {
+    uri: string;
+    type?: string;
+    name?: string;
+    size?: number;
+}, {
+    previousUser: User | undefined;
+}>;
+/**
+ * Update account settings
+ */
+export declare const useUpdateAccountSettings: () => import("@tanstack/react-query").UseMutationResult<any, Error, Record<string, any>, {
+    previousUser: User | undefined;
+}>;
+/**
+ * Update privacy settings with optimistic updates and authentication handling
+ */
+export declare const useUpdatePrivacySettings: () => import("@tanstack/react-query").UseMutationResult<Record<string, unknown>, Error, {
+    settings: Record<string, any>;
+    userId?: string;
+}, {
+    previousPrivacySettings: unknown;
+    previousUser: User | undefined;
+} | undefined>;
+/** Uploaded file data structure from API */
+interface UploadedFile {
+    id: string;
+    originalName?: string;
+    sha256?: string;
+    mime?: string;
+    size?: number;
+    createdAt?: string;
+    metadata?: Record<string, unknown>;
+    variants?: Array<{
+        type: string;
+        key: string;
+        width?: number;
+        height?: number;
+        readyAt?: string;
+        metadata?: Record<string, unknown>;
+    }>;
+}
+/** Upload result type that supports both single file and batch responses */
+interface UploadResult {
+    file?: UploadedFile;
+    files?: UploadedFile[];
+    id?: string;
+}
+/**
+ * Upload file with authentication handling and progress tracking
+ */
+export declare const useUploadFile: () => import("@tanstack/react-query").UseMutationResult<UploadResult, Error, {
+    file: File;
+    visibility?: "private" | "public" | "unlisted";
+    metadata?: Record<string, any>;
+    onProgress?: (progress: number) => void;
+}, unknown>;
+export {};

package/dist/web/types/ui/hooks/mutations/useServicesMutations.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Switch active session
+ */
+export declare const useSwitchSession: () => import("@tanstack/react-query").UseMutationResult<void, Error, string, unknown>;
+/**
+ * Logout from a session
+ */
+export declare const useLogoutSession: () => import("@tanstack/react-query").UseMutationResult<string, Error, string | undefined, {
+    previousSessions: unknown;
+}>;
+/**
+ * Logout from all sessions
+ */
+export declare const useLogoutAll: () => import("@tanstack/react-query").UseMutationResult<void, Error, void, unknown>;
+/**
+ * Update device name
+ */
+export declare const useUpdateDeviceName: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
+/**
+ * Remove a device
+ */
+export declare const useRemoveDevice: () => import("@tanstack/react-query").UseMutationResult<string, Error, string, unknown>;

package/dist/web/types/ui/hooks/queries/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Query Hooks
+ *
+ * TanStack Query hooks for fetching Oxy services data.
+ * All hooks follow the same pattern with optional `enabled` parameter.
+ */
+export { useUserProfile, useUserProfiles, useCurrentUser, useUserById, useUserByUsername, useUsersBySessions, usePrivacySettings, } from './useAccountQueries';
+export { useSessions, useSession, useDeviceSessions, useUserDevices, useSecurityInfo, } from './useServicesQueries';
+export { useSecurityActivity, useRecentSecurityActivity, } from './useSecurityQueries';
+export { queryKeys, invalidateAccountQueries, invalidateUserQueries, invalidateSessionQueries } from './queryKeys';

package/dist/web/types/ui/hooks/queries/queryKeys.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Centralized query keys for TanStack Query
+ *
+ * Following best practices:
+ * - Use arrays for hierarchical keys
+ * - Include all parameters in the key
+ * - Use consistent naming conventions
+ */
+export declare const queryKeys: {
+    readonly accounts: {
+        readonly all: readonly ["accounts"];
+        readonly lists: () => readonly ["accounts", "list"];
+        readonly list: (sessionIds: string[]) => readonly ["accounts", "list", string[]];
+        readonly details: () => readonly ["accounts", "detail"];
+        readonly detail: (sessionId: string) => readonly ["accounts", "detail", string];
+        readonly current: () => readonly ["accounts", "current"];
+        readonly settings: () => readonly ["accounts", "settings"];
+    };
+    readonly users: {
+        readonly all: readonly ["users"];
+        readonly lists: () => readonly ["users", "list"];
+        readonly list: (userIds: string[]) => readonly ["users", "list", string[]];
+        readonly details: () => readonly ["users", "detail"];
+        readonly detail: (userId: string) => readonly ["users", "detail", string];
+        readonly profile: (sessionId: string) => readonly ["users", "detail", string, "profile"];
+    };
+    readonly sessions: {
+        readonly all: readonly ["sessions"];
+        readonly lists: () => readonly ["sessions", "list"];
+        readonly list: (userId?: string) => readonly ["sessions", "list", string | undefined];
+        readonly details: () => readonly ["sessions", "detail"];
+        readonly detail: (sessionId: string) => readonly ["sessions", "detail", string];
+        readonly active: () => readonly ["sessions", "active"];
+        readonly device: (deviceId: string) => readonly ["sessions", "device", string];
+    };
+    readonly devices: {
+        readonly all: readonly ["devices"];
+        readonly lists: () => readonly ["devices", "list"];
+        readonly list: (userId?: string) => readonly ["devices", "list", string | undefined];
+        readonly details: () => readonly ["devices", "detail"];
+        readonly detail: (deviceId: string) => readonly ["devices", "detail", string];
+    };
+    readonly privacy: {
+        readonly all: readonly ["privacy"];
+        readonly settings: (userId?: string) => readonly ["privacy", "settings", string];
+    };
+    readonly security: {
+        readonly all: readonly ["security"];
+        readonly activity: (limit?: number, offset?: number, eventType?: string) => readonly ["security", "activity", number | undefined, number | undefined, string | undefined];
+        readonly recent: (limit: number) => readonly ["security", "recent", number];
+    };
+};
+/**
+ * Helper to invalidate all account-related queries
+ */
+export declare const invalidateAccountQueries: (queryClient: any) => void;
+/**
+ * Helper to invalidate all user-related queries
+ */
+export declare const invalidateUserQueries: (queryClient: any) => void;
+/**
+ * Helper to invalidate all session-related queries
+ */
+export declare const invalidateSessionQueries: (queryClient: any) => void;

package/dist/web/types/ui/hooks/queries/useAccountQueries.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Get user profile by session ID
+ */
+export declare const useUserProfile: (sessionId: string | null, options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<any, Error>;
+/**
+ * Get multiple user profiles by session IDs (batch query)
+ */
+export declare const useUserProfiles: (sessionIds: string[], options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<any, Error>[];
+/**
+ * Get current authenticated user
+ */
+export declare const useCurrentUser: (options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<any, Error>;
+/**
+ * Get user by ID
+ */
+export declare const useUserById: (userId: string | null, options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<any, Error>;
+/**
+ * Get user profile by username
+ */
+export declare const useUserByUsername: (username: string | null, options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<any, Error>;
+/**
+ * Batch get users by session IDs (optimized single API call)
+ */
+export declare const useUsersBySessions: (sessionIds: string[], options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<any, Error>;
+/**
+ * Get privacy settings for a user
+ */
+export declare const usePrivacySettings: (userId?: string, options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<unknown, Error>;

package/dist/web/types/ui/hooks/queries/useSecurityQueries.d.ts

@@ -0,0 +1,14 @@
+import type { SecurityActivity, SecurityEventType } from '../../../models/interfaces';
+/**
+ * Get user's security activity with pagination
+ */
+export declare const useSecurityActivity: (options?: {
+    limit?: number;
+    offset?: number;
+    eventType?: SecurityEventType;
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<any, Error>;
+/**
+ * Get recent security activity (convenience hook)
+ */
+export declare const useRecentSecurityActivity: (limit?: number) => import("@tanstack/react-query").UseQueryResult<SecurityActivity[], Error>;

package/dist/web/types/ui/hooks/queries/useServicesQueries.d.ts

@@ -0,0 +1,31 @@
+import type { ClientSession } from '../../../models/session';
+/**
+ * Get all active sessions for the current user
+ */
+export declare const useSessions: (userId?: string, options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<ClientSession[], Error>;
+/**
+ * Get specific session by ID
+ */
+export declare const useSession: (sessionId: string | null, options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<ClientSession, Error>;
+/**
+ * Get device sessions for the current active session
+ */
+export declare const useDeviceSessions: (options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<any, Error>;
+/**
+ * Get user devices
+ */
+export declare const useUserDevices: (options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<unknown, Error>;
+/**
+ * Get security information
+ */
+export declare const useSecurityInfo: (options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<any, Error>;

package/dist/web/types/ui/hooks/queryClient.d.ts

@@ -0,0 +1,18 @@
+import { QueryClient } from '@tanstack/react-query';
+import type { StorageInterface } from '../utils/storageHelpers';
+/**
+ * Custom persistence adapter for TanStack Query using our StorageInterface
+ */
+export declare const createPersistenceAdapter: (storage: StorageInterface) => {
+    persistClient: (client: any) => Promise<void>;
+    restoreClient: () => Promise<any>;
+    removeClient: () => Promise<void>;
+};
+/**
+ * Create a QueryClient with offline-first configuration
+ */
+export declare const createQueryClient: (storage?: StorageInterface | null) => QueryClient;
+/**
+ * Clear persisted query cache
+ */
+export declare const clearQueryCache: (storage: StorageInterface) => Promise<void>;

package/dist/web/types/ui/hooks/useAssets.d.ts

@@ -0,0 +1,34 @@
+import { OxyServices } from '../../core/OxyServices';
+import { Asset, AssetUploadProgress } from '../../models/interfaces';
+export declare const setOxyAssetInstance: (instance: OxyServices) => void;
+/**
+ * Hook for managing assets with Zustand store integration
+ */
+export declare const useAssets: () => {
+    assets: Asset[];
+    uploadProgress: Record<string, AssetUploadProgress>;
+    loading: {
+        uploading: boolean;
+        linking: boolean;
+        deleting: boolean;
+    };
+    errors: {
+        upload?: string;
+        link?: string;
+        delete?: string;
+    };
+    upload: (file: File, metadata?: Record<string, any>) => Promise<Asset | null>;
+    link: (assetId: string, app: string, entityType: string, entityId: string) => Promise<void>;
+    unlink: (assetId: string, app: string, entityType: string, entityId: string) => Promise<void>;
+    getUrl: (assetId: string, variant?: string, expiresIn?: number) => Promise<string>;
+    getAsset: (assetId: string) => Promise<Asset>;
+    deleteAsset: (assetId: string, force?: boolean) => Promise<void>;
+    restore: (assetId: string) => Promise<void>;
+    getVariants: (assetId: string) => Promise<any>;
+    getAssetsByApp: (app: string) => Asset[];
+    getAssetsByEntity: (app: string, entityType: string, entityId: string) => Asset[];
+    getAssetUsageCount: (assetId: string) => number;
+    isAssetLinked: (assetId: string, app: string, entityType: string, entityId: string) => boolean;
+    clearErrors: () => void;
+    reset: () => void;
+};

package/dist/web/types/ui/hooks/useAsyncAction.d.ts

@@ -0,0 +1,50 @@
+interface UseAsyncActionOptions<T> {
+    /** Function to execute */
+    action: () => Promise<T>;
+    /** Success message to display */
+    successMessage?: string;
+    /** Error message to display (or function to get message from error) */
+    errorMessage?: string | ((error: any) => string);
+    /** Callback on success */
+    onSuccess?: (result: T) => void;
+    /** Callback on error */
+    onError?: (error: any) => void;
+    /** Show loading toast */
+    showLoadingToast?: boolean;
+    /** Loading message */
+    loadingMessage?: string;
+}
+interface UseAsyncActionReturn<T> {
+    /** Execute the action */
+    execute: () => Promise<T | undefined>;
+    /** Whether the action is currently executing */
+    isLoading: boolean;
+    /** The last error that occurred */
+    error: Error | null;
+    /** Reset the error state */
+    resetError: () => void;
+}
+/**
+ * Hook for handling async actions with loading state, error handling, and toast notifications.
+ * Reduces boilerplate for common patterns like try-catch with toast feedback.
+ *
+ * @example
+ * const { execute, isLoading } = useAsyncAction({
+ *   action: () => api.saveSettings(settings),
+ *   successMessage: 'Settings saved!',
+ *   errorMessage: 'Failed to save settings',
+ * });
+ *
+ * <Button onPress={execute} disabled={isLoading}>Save</Button>
+ */
+export declare function useAsyncAction<T = void>(options: UseAsyncActionOptions<T>): UseAsyncActionReturn<T>;
+/**
+ * Simplified version that just executes an async action with toast feedback.
+ * Useful for one-off actions.
+ */
+export declare function executeWithToast<T>(action: () => Promise<T>, options?: {
+    successMessage?: string;
+    errorMessage?: string;
+    loadingMessage?: string;
+}): Promise<T | undefined>;
+export default useAsyncAction;

package/dist/web/types/ui/hooks/useAuth.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Unified Auth Hook
+ *
+ * Provides a clean, standard interface for authentication across all platforms.
+ * This is the recommended way to access auth state in Oxy apps.
+ *
+ * Usage:
+ * ```tsx
+ * import { useAuth } from '@oxyhq/services';
+ *
+ * function MyComponent() {
+ *   const { user, isAuthenticated, isLoading, signIn, signOut } = useAuth();
+ *
+ *   if (isLoading) return <Loading />;
+ *   if (!isAuthenticated) return <SignInButton onClick={() => signIn()} />;
+ *   return <Welcome user={user} />;
+ * }
+ * ```
+ *
+ * Cross-domain SSO:
+ * - Web: Automatic via FedCM (Chrome 108+, Safari 16.4+)
+ * - Native: Automatic via shared Keychain/Account Manager
+ * - Manual sign-in: signIn() opens popup (web) or auth sheet (native)
+ */
+import { useOxy } from '../context/OxyContext';
+import type { User } from '../../models/interfaces';
+export interface AuthState {
+    /** Current authenticated user, null if not authenticated */
+    user: User | null;
+    /** Whether user is authenticated */
+    isAuthenticated: boolean;
+    /** Whether auth state is being determined (initial load) */
+    isLoading: boolean;
+    /** Whether the auth token is ready for API calls */
+    isReady: boolean;
+    /** Current error message, if any */
+    error: string | null;
+}
+export interface AuthActions {
+    /**
+     * Sign in
+     * - Web: Opens popup to auth.oxy.so (no public key needed)
+     * - Native: Uses cryptographic identity from keychain
+     */
+    signIn: (publicKey?: string) => Promise<User>;
+    /**
+     * Sign out current session
+     */
+    signOut: () => Promise<void>;
+    /**
+     * Sign out all sessions across all devices
+     */
+    signOutAll: () => Promise<void>;
+    /**
+     * Refresh auth state (re-check session validity)
+     */
+    refresh: () => Promise<void>;
+}
+export interface UseAuthReturn extends AuthState, AuthActions {
+    /** Access to full OxyServices instance for advanced usage */
+    oxyServices: ReturnType<typeof useOxy>['oxyServices'];
+}
+/**
+ * Unified auth hook for all Oxy apps
+ *
+ * Features:
+ * - Zero config: Just wrap with OxyProvider and use
+ * - Cross-platform: Same API on native and web
+ * - Auto SSO: Web apps automatically check for cross-domain sessions
+ * - Type-safe: Full TypeScript support
+ */
+export declare function useAuth(): UseAuthReturn;
+export { useOxy } from '../context/OxyContext';

package/dist/web/types/ui/hooks/useColorScheme.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Hook to get the current color scheme (theme).
+ * Returns the resolved theme from ThemeContext if available, otherwise falls back to React Native's useColorScheme.
+ *
+ * Always calls hooks in the same order to maintain React hook rules.
+ */
+export declare function useColorScheme(): 'light' | 'dark';

package/dist/web/types/ui/hooks/useDeviceManagement.d.ts

@@ -0,0 +1,26 @@
+import type { ApiError } from '../../models/interfaces';
+import type { OxyServices } from '../../core';
+export interface UseDeviceManagementOptions {
+    oxyServices: OxyServices;
+    activeSessionId: string | null;
+    onError?: (error: ApiError) => void;
+    clearSessionState: () => Promise<void>;
+    logger?: (message: string, error?: unknown) => void;
+}
+export interface UseDeviceManagementResult {
+    getDeviceSessions: () => Promise<Array<{
+        sessionId: string;
+        deviceId: string;
+        deviceName?: string;
+        lastActive?: string;
+        expiresAt?: string;
+    }>>;
+    logoutAllDeviceSessions: () => Promise<void>;
+    updateDeviceName: (deviceName: string) => Promise<void>;
+}
+/**
+ * Provide device session management helpers tied to the current active session.
+ *
+ * @param options - Device management configuration
+ */
+export declare const useDeviceManagement: ({ oxyServices, activeSessionId, onError, clearSessionState, logger, }: UseDeviceManagementOptions) => UseDeviceManagementResult;

package/dist/web/types/ui/hooks/useFileDownloadUrl.d.ts

@@ -0,0 +1,18 @@
+import { OxyServices } from '../../core/OxyServices';
+export declare const setOxyFileUrlInstance: (instance: OxyServices) => void;
+export interface UseFileDownloadUrlOptions {
+    variant?: string;
+    expiresIn?: number;
+}
+export interface UseFileDownloadUrlResult {
+    url: string | null;
+    loading: boolean;
+    error: Error | null;
+}
+/**
+ * Hook to resolve a file's download URL asynchronously.
+ *
+ * Prefers `getFileDownloadUrlAsync` and falls back to the synchronous
+ * `getFileDownloadUrl` helper if the async call fails.
+ */
+export declare const useFileDownloadUrl: (fileId?: string | null, options?: UseFileDownloadUrlOptions) => UseFileDownloadUrlResult;

package/dist/web/types/ui/hooks/useFileFiltering.d.ts

@@ -0,0 +1,28 @@
+import type { FileMetadata } from '../../models/interfaces';
+export type ViewMode = 'all' | 'photos' | 'videos' | 'documents' | 'audio';
+export type SortBy = 'date' | 'size' | 'name' | 'type';
+export type SortOrder = 'asc' | 'desc';
+interface UseFileFilteringOptions {
+    files: FileMetadata[];
+    initialViewMode?: ViewMode;
+    initialSortBy?: SortBy;
+    initialSortOrder?: SortOrder;
+}
+interface UseFileFilteringReturn {
+    filteredFiles: FileMetadata[];
+    viewMode: ViewMode;
+    setViewMode: (mode: ViewMode) => void;
+    searchQuery: string;
+    setSearchQuery: (query: string) => void;
+    sortBy: SortBy;
+    setSortBy: (sort: SortBy) => void;
+    sortOrder: SortOrder;
+    setSortOrder: (order: SortOrder) => void;
+    toggleSortOrder: () => void;
+}
+/**
+ * Hook for file filtering, sorting, and search functionality
+ * Extracts common file management logic for reuse across components
+ */
+export declare function useFileFiltering({ files, initialViewMode, initialSortBy, initialSortOrder, }: UseFileFilteringOptions): UseFileFilteringReturn;
+export {};

package/dist/web/types/ui/hooks/useFollow.d.ts

@@ -0,0 +1,61 @@
+export declare const useFollow: (userId?: string | string[]) => {
+    isFollowing: boolean;
+    isLoading: boolean;
+    error: string | null;
+    toggleFollow: () => Promise<void>;
+    setFollowStatus: (following: boolean) => void;
+    fetchStatus: () => Promise<void>;
+    clearError: () => void;
+    followerCount: number | null;
+    followingCount: number | null;
+    isLoadingCounts: boolean;
+    fetchUserCounts: () => Promise<void>;
+    setFollowerCount: (count: number) => void;
+    setFollowingCount: (count: number) => void;
+    followData?: undefined;
+    toggleFollowForUser?: undefined;
+    setFollowStatusForUser?: undefined;
+    fetchStatusForUser?: undefined;
+    fetchAllStatuses?: undefined;
+    clearErrorForUser?: undefined;
+    isAnyLoading?: undefined;
+    hasAnyError?: undefined;
+    allFollowing?: undefined;
+    allNotFollowing?: undefined;
+} | {
+    followData: Record<string, {
+        isFollowing: boolean;
+        isLoading: boolean;
+        error: string | null;
+    }>;
+    toggleFollowForUser: (targetUserId: string) => Promise<void>;
+    setFollowStatusForUser: (targetUserId: string, following: boolean) => void;
+    fetchStatusForUser: (targetUserId: string) => Promise<void>;
+    fetchAllStatuses: () => Promise<void>;
+    clearErrorForUser: (targetUserId: string) => void;
+    isAnyLoading: boolean;
+    hasAnyError: boolean;
+    allFollowing: boolean;
+    allNotFollowing: boolean;
+    isFollowing?: undefined;
+    isLoading?: undefined;
+    error?: undefined;
+    toggleFollow?: undefined;
+    setFollowStatus?: undefined;
+    fetchStatus?: undefined;
+    clearError?: undefined;
+    followerCount?: undefined;
+    followingCount?: undefined;
+    isLoadingCounts?: undefined;
+    fetchUserCounts?: undefined;
+    setFollowerCount?: undefined;
+    setFollowingCount?: undefined;
+};
+export declare const useFollowerCounts: (userId: string) => {
+    followerCount: number;
+    followingCount: number;
+    isLoadingCounts: boolean;
+    fetchUserCounts: () => Promise<void>;
+    setFollowerCount: (count: number) => void;
+    setFollowingCount: (count: number) => void;
+};