@oxyhq/services 6.9.13 → 6.9.15

package/src/ui/hooks/mutations/useAccountMutations.js

@@ -0,0 +1,274 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useUploadFile = exports.useUpdatePrivacySettings = exports.useUpdateAccountSettings = exports.useUploadAvatar = exports.useUpdateProfile = void 0;
+const react_query_1 = require("@tanstack/react-query");
+const core_1 = require("@oxyhq/core");
+const queryKeys_1 = require("../queries/queryKeys");
+const OxyContext_1 = require("../../context/OxyContext");
+const sonner_1 = require("../../../lib/sonner");
+const avatarUtils_1 = require("../../utils/avatarUtils");
+const authStore_1 = require("../../stores/authStore");
+/**
+ * Update user profile with optimistic updates and offline queue support
+ */
+const useUpdateProfile = () => {
+    const { oxyServices, activeSessionId, user } = (0, OxyContext_1.useOxy)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: async (updates) => {
+            return (0, core_1.authenticatedApiCall)(oxyServices, activeSessionId, () => oxyServices.updateProfile(updates));
+        },
+        // Optimistic update
+        onMutate: async (updates) => {
+            // Cancel outgoing refetches
+            await queryClient.cancelQueries({ queryKey: queryKeys_1.queryKeys.accounts.current() });
+            // Snapshot previous value
+            const previousUser = queryClient.getQueryData(queryKeys_1.queryKeys.accounts.current());
+            // Optimistically update
+            if (previousUser) {
+                queryClient.setQueryData(queryKeys_1.queryKeys.accounts.current(), {
+                    ...previousUser,
+                    ...updates,
+                });
+                // Also update profile query if sessionId is available
+                if (activeSessionId) {
+                    queryClient.setQueryData(queryKeys_1.queryKeys.users.profile(activeSessionId), {
+                        ...previousUser,
+                        ...updates,
+                    });
+                }
+            }
+            return { previousUser };
+        },
+        // On error, rollback
+        onError: (error, updates, context) => {
+            if (context?.previousUser) {
+                queryClient.setQueryData(queryKeys_1.queryKeys.accounts.current(), context.previousUser);
+                if (activeSessionId) {
+                    queryClient.setQueryData(queryKeys_1.queryKeys.users.profile(activeSessionId), context.previousUser);
+                }
+            }
+            sonner_1.toast.error(error instanceof Error ? error.message : 'Failed to update profile');
+        },
+        // On success, invalidate and refetch
+        onSuccess: (data, updates) => {
+            // Update cache with server response
+            queryClient.setQueryData(queryKeys_1.queryKeys.accounts.current(), data);
+            if (activeSessionId) {
+                queryClient.setQueryData(queryKeys_1.queryKeys.users.profile(activeSessionId), data);
+            }
+            // Update authStore so frontend components see the changes immediately
+            authStore_1.useAuthStore.getState().setUser(data);
+            // If avatar was updated, refresh accountStore with cache-busted URL
+            if (updates.avatar && activeSessionId && oxyServices) {
+                (0, avatarUtils_1.refreshAvatarInStore)(activeSessionId, updates.avatar, oxyServices);
+            }
+            // Invalidate all related queries to refresh everywhere
+            (0, queryKeys_1.invalidateUserQueries)(queryClient);
+            (0, queryKeys_1.invalidateAccountQueries)(queryClient);
+        },
+    });
+};
+exports.useUpdateProfile = useUpdateProfile;
+/**
+ * Upload avatar with progress tracking and offline queue support
+ */
+const useUploadAvatar = () => {
+    const { oxyServices, activeSessionId } = (0, OxyContext_1.useOxy)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: async (file) => {
+            return (0, core_1.authenticatedApiCall)(oxyServices, activeSessionId, async () => {
+                const uploadResult = await oxyServices.assetUpload(file, 'public');
+                const fileId = uploadResult?.file?.id;
+                if (!fileId || typeof fileId !== 'string') {
+                    throw new Error('Upload succeeded but response did not contain a file ID');
+                }
+                // Update profile with file ID
+                return await oxyServices.updateProfile({ avatar: fileId });
+            });
+        },
+        onMutate: async (file) => {
+            await queryClient.cancelQueries({ queryKey: queryKeys_1.queryKeys.accounts.current() });
+            const previousUser = queryClient.getQueryData(queryKeys_1.queryKeys.accounts.current());
+            // Optimistically set a temporary avatar (using file URI as placeholder)
+            if (previousUser) {
+                const optimisticUser = {
+                    ...previousUser,
+                    avatar: file.uri, // Temporary, will be replaced with fileId
+                };
+                queryClient.setQueryData(queryKeys_1.queryKeys.accounts.current(), optimisticUser);
+                if (activeSessionId) {
+                    queryClient.setQueryData(queryKeys_1.queryKeys.users.profile(activeSessionId), optimisticUser);
+                }
+            }
+            return { previousUser };
+        },
+        onError: (error, file, context) => {
+            if (context?.previousUser) {
+                queryClient.setQueryData(queryKeys_1.queryKeys.accounts.current(), context.previousUser);
+                if (activeSessionId) {
+                    queryClient.setQueryData(queryKeys_1.queryKeys.users.profile(activeSessionId), context.previousUser);
+                }
+            }
+            sonner_1.toast.error(error instanceof Error ? error.message : 'Failed to upload avatar');
+        },
+        onSuccess: (data) => {
+            queryClient.setQueryData(queryKeys_1.queryKeys.accounts.current(), data);
+            if (activeSessionId) {
+                queryClient.setQueryData(queryKeys_1.queryKeys.users.profile(activeSessionId), data);
+            }
+            // Update authStore so frontend components see the changes immediately
+            authStore_1.useAuthStore.getState().setUser(data);
+            // Refresh accountStore with cache-busted URL if avatar was updated
+            if (data?.avatar && activeSessionId && oxyServices) {
+                (0, avatarUtils_1.refreshAvatarInStore)(activeSessionId, data.avatar, oxyServices);
+            }
+            // Invalidate all related queries to refresh everywhere
+            (0, queryKeys_1.invalidateUserQueries)(queryClient);
+            (0, queryKeys_1.invalidateAccountQueries)(queryClient);
+            sonner_1.toast.success('Avatar updated successfully');
+        },
+    });
+};
+exports.useUploadAvatar = useUploadAvatar;
+/**
+ * Update account settings
+ */
+const useUpdateAccountSettings = () => {
+    const { oxyServices, activeSessionId } = (0, OxyContext_1.useOxy)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: async (settings) => {
+            return await oxyServices.updateProfile({ privacySettings: settings });
+        },
+        onMutate: async (settings) => {
+            await queryClient.cancelQueries({ queryKey: queryKeys_1.queryKeys.accounts.settings() });
+            const previousUser = queryClient.getQueryData(queryKeys_1.queryKeys.accounts.current());
+            if (previousUser) {
+                queryClient.setQueryData(queryKeys_1.queryKeys.accounts.current(), {
+                    ...previousUser,
+                    privacySettings: {
+                        ...previousUser.privacySettings,
+                        ...settings,
+                    },
+                });
+            }
+            return { previousUser };
+        },
+        onError: (error, settings, context) => {
+            if (context?.previousUser) {
+                queryClient.setQueryData(queryKeys_1.queryKeys.accounts.current(), context.previousUser);
+            }
+            sonner_1.toast.error(error instanceof Error ? error.message : 'Failed to update settings');
+        },
+        onSuccess: (data) => {
+            queryClient.setQueryData(queryKeys_1.queryKeys.accounts.current(), data);
+            // Update authStore so frontend components see the changes immediately
+            authStore_1.useAuthStore.getState().setUser(data);
+            (0, queryKeys_1.invalidateAccountQueries)(queryClient);
+            sonner_1.toast.success('Settings updated successfully');
+        },
+        onSettled: () => {
+            queryClient.invalidateQueries({ queryKey: queryKeys_1.queryKeys.accounts.settings() });
+        },
+    });
+};
+exports.useUpdateAccountSettings = useUpdateAccountSettings;
+/**
+ * Update privacy settings with optimistic updates and authentication handling
+ */
+const useUpdatePrivacySettings = () => {
+    const { oxyServices, activeSessionId, user } = (0, OxyContext_1.useOxy)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: async ({ settings, userId }) => {
+            const targetUserId = userId || user?.id;
+            if (!targetUserId) {
+                throw new Error('User ID is required');
+            }
+            return (0, core_1.authenticatedApiCall)(oxyServices, activeSessionId, () => oxyServices.updatePrivacySettings(settings, targetUserId));
+        },
+        // Optimistic update
+        onMutate: async ({ settings, userId }) => {
+            const targetUserId = userId || user?.id;
+            if (!targetUserId)
+                return;
+            // Cancel outgoing refetches
+            await queryClient.cancelQueries({ queryKey: queryKeys_1.queryKeys.privacy.settings(targetUserId) });
+            await queryClient.cancelQueries({ queryKey: queryKeys_1.queryKeys.accounts.current() });
+            // Snapshot previous values
+            const previousPrivacySettings = queryClient.getQueryData(queryKeys_1.queryKeys.privacy.settings(targetUserId));
+            const previousUser = queryClient.getQueryData(queryKeys_1.queryKeys.accounts.current());
+            // Optimistically update privacy settings
+            if (previousPrivacySettings) {
+                queryClient.setQueryData(queryKeys_1.queryKeys.privacy.settings(targetUserId), {
+                    ...previousPrivacySettings,
+                    ...settings,
+                });
+            }
+            // Also update user query if available
+            if (previousUser) {
+                queryClient.setQueryData(queryKeys_1.queryKeys.accounts.current(), {
+                    ...previousUser,
+                    privacySettings: {
+                        ...previousUser.privacySettings,
+                        ...settings,
+                    },
+                });
+            }
+            return { previousPrivacySettings, previousUser };
+        },
+        // On error, rollback
+        onError: (error, { userId }, context) => {
+            const targetUserId = userId || user?.id;
+            if (context?.previousPrivacySettings && targetUserId) {
+                queryClient.setQueryData(queryKeys_1.queryKeys.privacy.settings(targetUserId), context.previousPrivacySettings);
+            }
+            if (context?.previousUser) {
+                queryClient.setQueryData(queryKeys_1.queryKeys.accounts.current(), context.previousUser);
+            }
+            sonner_1.toast.error(error instanceof Error ? error.message : 'Failed to update privacy settings');
+        },
+        // On success, invalidate and refetch
+        onSuccess: (data, { userId }) => {
+            const targetUserId = userId || user?.id;
+            if (targetUserId) {
+                queryClient.setQueryData(queryKeys_1.queryKeys.privacy.settings(targetUserId), data);
+            }
+            // Also update account query if it contains privacy settings
+            const currentUser = queryClient.getQueryData(queryKeys_1.queryKeys.accounts.current());
+            if (currentUser) {
+                const updatedUser = {
+                    ...currentUser,
+                    privacySettings: data,
+                };
+                queryClient.setQueryData(queryKeys_1.queryKeys.accounts.current(), updatedUser);
+                // Update authStore so frontend components see the changes immediately
+                authStore_1.useAuthStore.getState().setUser(updatedUser);
+            }
+            (0, queryKeys_1.invalidateAccountQueries)(queryClient);
+        },
+        // Always refetch after error or success
+        onSettled: (data, error, { userId }) => {
+            const targetUserId = userId || user?.id;
+            if (targetUserId) {
+                queryClient.invalidateQueries({ queryKey: queryKeys_1.queryKeys.privacy.settings(targetUserId) });
+            }
+            queryClient.invalidateQueries({ queryKey: queryKeys_1.queryKeys.accounts.current() });
+        },
+    });
+};
+exports.useUpdatePrivacySettings = useUpdatePrivacySettings;
+/**
+ * Upload file with authentication handling and progress tracking
+ */
+const useUploadFile = () => {
+    const { oxyServices, activeSessionId } = (0, OxyContext_1.useOxy)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: async ({ file, visibility, metadata, onProgress }) => {
+            return (0, core_1.authenticatedApiCall)(oxyServices, activeSessionId, () => oxyServices.assetUpload(file, visibility, metadata, onProgress));
+        },
+    });
+};
+exports.useUploadFile = useUploadFile;

package/src/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/src/ui/hooks/mutations/useServicesMutations.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useRemoveDevice = exports.useUpdateDeviceName = exports.useLogoutAll = exports.useLogoutSession = exports.useSwitchSession = void 0;
+const react_query_1 = require("@tanstack/react-query");
+const queryKeys_1 = require("../queries/queryKeys");
+const OxyContext_1 = require("../../context/OxyContext");
+const sonner_1 = require("../../../lib/sonner");
+/**
+ * Switch active session
+ */
+const useSwitchSession = () => {
+    const { switchSession, activeSessionId } = (0, OxyContext_1.useOxy)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: async (sessionId) => {
+            return await switchSession(sessionId);
+        },
+        onSuccess: (user) => {
+            // Invalidate all session queries
+            (0, queryKeys_1.invalidateSessionQueries)(queryClient);
+            // Update current user query
+            queryClient.setQueryData(queryKeys_1.queryKeys.accounts.current(), user);
+            // Invalidate account queries
+            queryClient.invalidateQueries({ queryKey: queryKeys_1.queryKeys.accounts.all });
+        },
+        onError: (error) => {
+            sonner_1.toast.error(error instanceof Error ? error.message : 'Failed to switch session');
+        },
+    });
+};
+exports.useSwitchSession = useSwitchSession;
+/**
+ * Logout from a session
+ */
+const useLogoutSession = () => {
+    const { oxyServices, activeSessionId, sessions } = (0, OxyContext_1.useOxy)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: async (targetSessionId) => {
+            if (!activeSessionId) {
+                throw new Error('No active session');
+            }
+            const sessionToLogout = targetSessionId || activeSessionId;
+            await oxyServices.logoutSession(activeSessionId, sessionToLogout);
+            return sessionToLogout;
+        },
+        onMutate: async (targetSessionId) => {
+            // Cancel outgoing queries
+            await queryClient.cancelQueries({ queryKey: queryKeys_1.queryKeys.sessions.all });
+            // Snapshot previous sessions
+            const previousSessions = queryClient.getQueryData(queryKeys_1.queryKeys.sessions.list());
+            // Optimistically remove session
+            if (previousSessions) {
+                const sessionToLogout = targetSessionId || activeSessionId;
+                const updatedSessions = previousSessions.filter((s) => s.sessionId !== sessionToLogout);
+                queryClient.setQueryData(queryKeys_1.queryKeys.sessions.list(), updatedSessions);
+            }
+            return { previousSessions };
+        },
+        onError: (error, targetSessionId, context) => {
+            // Rollback on error
+            if (context?.previousSessions) {
+                queryClient.setQueryData(queryKeys_1.queryKeys.sessions.list(), context.previousSessions);
+            }
+            sonner_1.toast.error(error instanceof Error ? error.message : 'Failed to logout');
+        },
+        onSuccess: () => {
+            // Invalidate all session queries
+            (0, queryKeys_1.invalidateSessionQueries)(queryClient);
+        },
+        onSettled: () => {
+            queryClient.invalidateQueries({ queryKey: queryKeys_1.queryKeys.sessions.all });
+        },
+    });
+};
+exports.useLogoutSession = useLogoutSession;
+/**
+ * Logout from all sessions
+ */
+const useLogoutAll = () => {
+    const { oxyServices, activeSessionId, clearSessionState } = (0, OxyContext_1.useOxy)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: async () => {
+            if (!activeSessionId) {
+                throw new Error('No active session');
+            }
+            await oxyServices.logoutAllSessions(activeSessionId);
+            await clearSessionState();
+        },
+        onSuccess: () => {
+            // Clear all queries
+            queryClient.clear();
+            sonner_1.toast.success('Logged out from all sessions');
+        },
+        onError: (error) => {
+            sonner_1.toast.error(error instanceof Error ? error.message : 'Failed to logout from all sessions');
+        },
+    });
+};
+exports.useLogoutAll = useLogoutAll;
+/**
+ * Update device name
+ */
+const useUpdateDeviceName = () => {
+    const { oxyServices, activeSessionId } = (0, OxyContext_1.useOxy)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: async (deviceName) => {
+            if (!activeSessionId) {
+                throw new Error('No active session');
+            }
+            return await oxyServices.updateDeviceName(activeSessionId, deviceName);
+        },
+        onSuccess: () => {
+            // Invalidate device and session queries
+            queryClient.invalidateQueries({ queryKey: queryKeys_1.queryKeys.devices.all });
+            queryClient.invalidateQueries({ queryKey: queryKeys_1.queryKeys.sessions.all });
+            sonner_1.toast.success('Device name updated');
+        },
+        onError: (error) => {
+            sonner_1.toast.error(error instanceof Error ? error.message : 'Failed to update device name');
+        },
+    });
+};
+exports.useUpdateDeviceName = useUpdateDeviceName;
+/**
+ * Remove a device
+ */
+const useRemoveDevice = () => {
+    const { oxyServices } = (0, OxyContext_1.useOxy)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: async (deviceId) => {
+            await oxyServices.removeDevice(deviceId);
+            return deviceId;
+        },
+        onSuccess: () => {
+            // Invalidate device queries
+            queryClient.invalidateQueries({ queryKey: queryKeys_1.queryKeys.devices.all });
+            queryClient.invalidateQueries({ queryKey: queryKeys_1.queryKeys.sessions.all });
+            sonner_1.toast.success('Device removed');
+        },
+        onError: (error) => {
+            sonner_1.toast.error(error instanceof Error ? error.message : 'Failed to remove device');
+        },
+    });
+};
+exports.useRemoveDevice = useRemoveDevice;

package/src/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/src/ui/hooks/queries/index.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * Query Hooks
+ *
+ * TanStack Query hooks for fetching Oxy services data.
+ * All hooks follow the same pattern with optional `enabled` parameter.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invalidateSessionQueries = exports.invalidateUserQueries = exports.invalidateAccountQueries = exports.queryKeys = exports.useRecentSecurityActivity = exports.useSecurityActivity = exports.useSecurityInfo = exports.useUserDevices = exports.useDeviceSessions = exports.useSession = exports.useSessions = exports.usePrivacySettings = exports.useUsersBySessions = exports.useUserByUsername = exports.useUserById = exports.useCurrentUser = exports.useUserProfiles = exports.useUserProfile = void 0;
+// Account and user query hooks
+var useAccountQueries_1 = require("./useAccountQueries");
+Object.defineProperty(exports, "useUserProfile", { enumerable: true, get: function () { return useAccountQueries_1.useUserProfile; } });
+Object.defineProperty(exports, "useUserProfiles", { enumerable: true, get: function () { return useAccountQueries_1.useUserProfiles; } });
+Object.defineProperty(exports, "useCurrentUser", { enumerable: true, get: function () { return useAccountQueries_1.useCurrentUser; } });
+Object.defineProperty(exports, "useUserById", { enumerable: true, get: function () { return useAccountQueries_1.useUserById; } });
+Object.defineProperty(exports, "useUserByUsername", { enumerable: true, get: function () { return useAccountQueries_1.useUserByUsername; } });
+Object.defineProperty(exports, "useUsersBySessions", { enumerable: true, get: function () { return useAccountQueries_1.useUsersBySessions; } });
+Object.defineProperty(exports, "usePrivacySettings", { enumerable: true, get: function () { return useAccountQueries_1.usePrivacySettings; } });
+// Service query hooks (sessions, devices, security)
+var useServicesQueries_1 = require("./useServicesQueries");
+Object.defineProperty(exports, "useSessions", { enumerable: true, get: function () { return useServicesQueries_1.useSessions; } });
+Object.defineProperty(exports, "useSession", { enumerable: true, get: function () { return useServicesQueries_1.useSession; } });
+Object.defineProperty(exports, "useDeviceSessions", { enumerable: true, get: function () { return useServicesQueries_1.useDeviceSessions; } });
+Object.defineProperty(exports, "useUserDevices", { enumerable: true, get: function () { return useServicesQueries_1.useUserDevices; } });
+Object.defineProperty(exports, "useSecurityInfo", { enumerable: true, get: function () { return useServicesQueries_1.useSecurityInfo; } });
+// Security activity query hooks
+var useSecurityQueries_1 = require("./useSecurityQueries");
+Object.defineProperty(exports, "useSecurityActivity", { enumerable: true, get: function () { return useSecurityQueries_1.useSecurityActivity; } });
+Object.defineProperty(exports, "useRecentSecurityActivity", { enumerable: true, get: function () { return useSecurityQueries_1.useRecentSecurityActivity; } });
+// Query keys and invalidation helpers (for advanced usage)
+var queryKeys_1 = require("./queryKeys");
+Object.defineProperty(exports, "queryKeys", { enumerable: true, get: function () { return queryKeys_1.queryKeys; } });
+Object.defineProperty(exports, "invalidateAccountQueries", { enumerable: true, get: function () { return queryKeys_1.invalidateAccountQueries; } });
+Object.defineProperty(exports, "invalidateUserQueries", { enumerable: true, get: function () { return queryKeys_1.invalidateUserQueries; } });
+Object.defineProperty(exports, "invalidateSessionQueries", { enumerable: true, get: function () { return queryKeys_1.invalidateSessionQueries; } });

package/src/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/src/ui/hooks/queries/queryKeys.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * Centralized query keys for TanStack Query
+ *
+ * Following best practices:
+ * - Use arrays for hierarchical keys
+ * - Include all parameters in the key
+ * - Use consistent naming conventions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invalidateSessionQueries = exports.invalidateUserQueries = exports.invalidateAccountQueries = exports.queryKeys = void 0;
+exports.queryKeys = {
+    // Account queries
+    accounts: {
+        all: ['accounts'],
+        lists: () => [...exports.queryKeys.accounts.all, 'list'],
+        list: (sessionIds) => [...exports.queryKeys.accounts.lists(), sessionIds],
+        details: () => [...exports.queryKeys.accounts.all, 'detail'],
+        detail: (sessionId) => [...exports.queryKeys.accounts.details(), sessionId],
+        current: () => [...exports.queryKeys.accounts.all, 'current'],
+        settings: () => [...exports.queryKeys.accounts.all, 'settings'],
+    },
+    // User queries
+    users: {
+        all: ['users'],
+        lists: () => [...exports.queryKeys.users.all, 'list'],
+        list: (userIds) => [...exports.queryKeys.users.lists(), userIds],
+        details: () => [...exports.queryKeys.users.all, 'detail'],
+        detail: (userId) => [...exports.queryKeys.users.details(), userId],
+        profile: (sessionId) => [...exports.queryKeys.users.details(), sessionId, 'profile'],
+    },
+    // Session queries
+    sessions: {
+        all: ['sessions'],
+        lists: () => [...exports.queryKeys.sessions.all, 'list'],
+        list: (userId) => [...exports.queryKeys.sessions.lists(), userId],
+        details: () => [...exports.queryKeys.sessions.all, 'detail'],
+        detail: (sessionId) => [...exports.queryKeys.sessions.details(), sessionId],
+        active: () => [...exports.queryKeys.sessions.all, 'active'],
+        device: (deviceId) => [...exports.queryKeys.sessions.all, 'device', deviceId],
+    },
+    // Device queries
+    devices: {
+        all: ['devices'],
+        lists: () => [...exports.queryKeys.devices.all, 'list'],
+        list: (userId) => [...exports.queryKeys.devices.lists(), userId],
+        details: () => [...exports.queryKeys.devices.all, 'detail'],
+        detail: (deviceId) => [...exports.queryKeys.devices.details(), deviceId],
+    },
+    // Privacy settings queries
+    privacy: {
+        all: ['privacy'],
+        settings: (userId) => [...exports.queryKeys.privacy.all, 'settings', userId || 'current'],
+    },
+    // Security activity queries
+    security: {
+        all: ['security'],
+        activity: (limit, offset, eventType) => [...exports.queryKeys.security.all, 'activity', limit, offset, eventType],
+        recent: (limit) => [...exports.queryKeys.security.all, 'recent', limit],
+    },
+};
+/**
+ * Helper to invalidate all account-related queries
+ */
+const invalidateAccountQueries = (queryClient) => {
+    queryClient.invalidateQueries({ queryKey: exports.queryKeys.accounts.all });
+};
+exports.invalidateAccountQueries = invalidateAccountQueries;
+/**
+ * Helper to invalidate all user-related queries
+ */
+const invalidateUserQueries = (queryClient) => {
+    queryClient.invalidateQueries({ queryKey: exports.queryKeys.users.all });
+};
+exports.invalidateUserQueries = invalidateUserQueries;
+/**
+ * Helper to invalidate all session-related queries
+ */
+const invalidateSessionQueries = (queryClient) => {
+    queryClient.invalidateQueries({ queryKey: exports.queryKeys.sessions.all });
+};
+exports.invalidateSessionQueries = invalidateSessionQueries;