@oxyhq/services 5.9.2 → 5.9.3

package/src/ui/context/OxyContext.tsx

@@ -2,7 +2,7 @@ import React, { createContext, useContext, useEffect, useCallback, ReactNode, us
 import { View, Text } from 'react-native';
 import { OxyServices } from '../../core';
 import { User, ApiError } from '../../models/interfaces';
-import { SecureLoginResponse, SecureClientSession, MinimalUserData } from '../../models/secureSession';
+import { SessionLoginResponse, ClientSession, MinimalUserData } from '../../models/session';
 import { DeviceManager } from '../../utils/deviceManager';
 import { useSessionSocket } from '../hooks/useSessionSocket';
 import { toast } from '../../lib/sonner';
@@ -13,7 +13,7 @@ export interface OxyContextState {
   // Authentication state
   user: User | null; // Current active user (loaded from server)
   minimalUser: MinimalUserData | null; // Minimal user data for UI
-  sessions: SecureClientSession[]; // All active sessions
+  sessions: ClientSession[]; // All active sessions
   activeSessionId: string | null;
   isAuthenticated: boolean; // Single source of truth for authentication - use this instead of service methods
   isLoading: boolean;
@@ -111,8 +111,8 @@ const getStorage = async (): Promise<StorageInterface> => {
   return new WebStorage();
 };
 
-// Storage keys for secure sessions
-const getSecureStorageKeys = (prefix = 'oxy_secure') => ({
+// Storage keys for sessions
+const getStorageKeys = (prefix = 'oxy_session') => ({
   activeSessionId: `${prefix}_active_session_id`, // Only store the active session ID
 });
 
@@ -120,7 +120,7 @@ export const OxyProvider: React.FC<OxyContextProviderProps> = ({
   children,
   oxyServices: providedOxyServices,
   baseURL,
-  storageKeyPrefix = 'oxy_secure',
+  storageKeyPrefix = 'oxy_session',
   onAuthStateChange,
   onError,
   bottomSheetRef,
@@ -151,14 +151,14 @@ export const OxyProvider: React.FC<OxyContextProviderProps> = ({
 
   // Local state for non-auth fields
   const [minimalUser, setMinimalUser] = React.useState<MinimalUserData | null>(null);
-  const [sessions, setSessions] = React.useState<SecureClientSession[]>([]);
+  const [sessions, setSessions] = React.useState<ClientSession[]>([]);
   const [activeSessionId, setActiveSessionId] = React.useState<string | null>(null);
   const [storage, setStorage] = React.useState<StorageInterface | null>(null);
   // Add a new state to track token restoration
   const [tokenReady, setTokenReady] = React.useState(false);
 
   // Storage keys (memoized to prevent infinite loops)
-  const keys = useMemo(() => getSecureStorageKeys(storageKeyPrefix), [storageKeyPrefix]);
+  const keys = useMemo(() => getStorageKeys(storageKeyPrefix), [storageKeyPrefix]);
 
   // Clear all storage - defined before initAuth to avoid dependency issues
   const clearAllStorage = useCallback(async (): Promise<void> => {
@@ -166,7 +166,7 @@ export const OxyProvider: React.FC<OxyContextProviderProps> = ({
     try {
       await storage.removeItem(keys.activeSessionId);
     } catch (err) {
-      console.error('Clear secure storage error:', err);
+      console.error('Clear storage error:', err);
     }
   }, [storage, keys]);
 
@@ -195,17 +195,19 @@ export const OxyProvider: React.FC<OxyContextProviderProps> = ({
         // Only load the active session ID from storage
         const storedActiveSessionId = await storage.getItem(keys.activeSessionId);
 
-        console.log('SecureAuth - activeSessionId:', storedActiveSessionId);
-        console.log('SecureAuth - storage available:', !!storage);
-        console.log('SecureAuth - oxyServices available:', !!oxyServices);
+        console.log('Auth - activeSessionId:', storedActiveSessionId);
+        console.log('Auth - storage available:', !!storage);
+        console.log('Auth - oxyServices available:', !!oxyServices);
 
         if (storedActiveSessionId) {
           // Validate the stored session with the backend
           try {
-            const validation = await oxyServices.validateSession(storedActiveSessionId);
+            const validation = await oxyServices.validateSession(storedActiveSessionId, {
+              useHeaderValidation: true
+            });
 
             if (validation.valid) {
-              console.log('SecureAuth - session validated successfully');
+              console.log('Auth - session validated successfully');
               setActiveSessionId(storedActiveSessionId);
 
               // Get access token for API calls
@@ -222,7 +224,7 @@ export const OxyProvider: React.FC<OxyContextProviderProps> = ({
 
               // Load sessions from backend
               const serverSessions = await oxyServices.getSessionsBySessionId(storedActiveSessionId);
-              const clientSessions: SecureClientSession[] = serverSessions.map(serverSession => ({
+              const clientSessions: ClientSession[] = serverSessions.map(serverSession => ({
                 sessionId: serverSession.sessionId,
                 deviceId: serverSession.deviceId,
                 expiresAt: serverSession.expiresAt || new Date().toISOString(),
@@ -235,18 +237,18 @@ export const OxyProvider: React.FC<OxyContextProviderProps> = ({
                 onAuthStateChange(fullUser);
               }
             } else {
-              console.log('SecureAuth - session invalid, clearing storage');
+              console.log('Auth - session invalid, clearing storage');
               await clearAllStorage();
             }
           } catch (error) {
-            console.error('SecureAuth - session validation error:', error);
+            console.error('Auth - session validation error:', error);
             await clearAllStorage();
           }
         } else {
-          console.log('SecureAuth - no stored session found, user needs to login');
+          console.log('Auth - no stored session found, user needs to login');
         }
       } catch (err) {
-        console.error('Secure auth initialization error:', err);
+        console.error('Auth initialization error:', err);
         await clearAllStorage();
       } finally {
         useAuthStore.setState({ isLoading: false });
@@ -320,7 +322,7 @@ export const OxyProvider: React.FC<OxyContextProviderProps> = ({
     }
   }, [oxyServices, onAuthStateChange, loginSuccess, saveActiveSessionId]);
 
-  // Secure login method - only store session ID, retrieve data from backend
+  // Login method - only store session ID, retrieve data from backend
   const login = useCallback(async (username: string, password: string, deviceName?: string): Promise<User> => {
     if (!storage) throw new Error('Storage not initialized');
     useAuthStore.setState({ isLoading: true, error: null });
@@ -332,10 +334,10 @@ export const OxyProvider: React.FC<OxyContextProviderProps> = ({
       // Get or generate persistent device info
       const deviceInfo = await DeviceManager.getDeviceInfo();
 
-      console.log('SecureAuth - Using device fingerprint:', deviceFingerprint);
-      console.log('SecureAuth - Using device ID:', deviceInfo.deviceId);
+      console.log('Auth - Using device fingerprint:', deviceFingerprint);
+      console.log('Auth - Using device ID:', deviceInfo.deviceId);
 
-      const response: SecureLoginResponse = await oxyServices.secureLogin(
+      const response: SessionLoginResponse = await oxyServices.signIn(
         username,
         password,
         deviceName || deviceInfo.deviceName || DeviceManager.getDefaultDeviceName(),
@@ -356,7 +358,7 @@ export const OxyProvider: React.FC<OxyContextProviderProps> = ({
 
       // Load sessions from backend
       const serverSessions = await oxyServices.getSessionsBySessionId(response.sessionId);
-      const clientSessions: SecureClientSession[] = serverSessions.map(serverSession => ({
+      const clientSessions: ClientSession[] = serverSessions.map(serverSession => ({
         sessionId: serverSession.sessionId,
         deviceId: serverSession.deviceId,
         expiresAt: serverSession.expiresAt || new Date().toISOString(),
@@ -384,7 +386,7 @@ export const OxyProvider: React.FC<OxyContextProviderProps> = ({
 
     try {
       const sessionToLogout = targetSessionId || activeSessionId;
-      await oxyServices.logoutSecureSession(activeSessionId, sessionToLogout);
+      await oxyServices.logoutSession(activeSessionId, sessionToLogout);
 
       // Remove session from local state
       const filteredSessions = sessions.filter(s => s.sessionId !== sessionToLogout);
@@ -430,9 +432,9 @@ export const OxyProvider: React.FC<OxyContextProviderProps> = ({
     }
 
     try {
-      console.log('Calling oxyServices.logoutAllSecureSessions with sessionId:', activeSessionId);
-      await oxyServices.logoutAllSecureSessions(activeSessionId);
-      console.log('logoutAllSecureSessions completed successfully');
+      console.log('Calling oxyServices.logoutAllSessions with sessionId:', activeSessionId);
+      await oxyServices.logoutAllSessions(activeSessionId);
+      console.log('logoutAllSessions completed successfully');
 
       // Clear all local data
       setSessions([]);
@@ -485,7 +487,7 @@ export const OxyProvider: React.FC<OxyContextProviderProps> = ({
 
       console.log('SignUp successful:', response);
 
-      // Now log the user in securely to create a session
+      // Now log the user in to create a session
       // This will handle the session creation and device registration
       const user = await login(username, password);
 
@@ -523,7 +525,7 @@ export const OxyProvider: React.FC<OxyContextProviderProps> = ({
       console.log('refreshSessions: Server sessions received:', serverSessions);
 
       // Update local sessions with server data
-      const updatedSessions: SecureClientSession[] = serverSessions.map(serverSession => ({
+      const updatedSessions: ClientSession[] = serverSessions.map(serverSession => ({
         sessionId: serverSession.sessionId,
         deviceId: serverSession.deviceId,
         expiresAt: serverSession.expiresAt || new Date().toISOString(),
@@ -545,7 +547,9 @@ export const OxyProvider: React.FC<OxyContextProviderProps> = ({
         for (const session of otherSessions) {
           try {
             // Try to validate this session
-            await oxyServices.validateSession(session.sessionId);
+            await oxyServices.validateSession(session.sessionId, {
+              useHeaderValidation: true
+            });
             console.log('Found valid session, switching to:', session.sessionId);
             await switchToSession(session.sessionId);
             return; // Successfully switched to another session

package/src/ui/screens/AccountSwitcherScreen.tsx

@@ -13,7 +13,7 @@ import {
 } from 'react-native';
 import { BaseScreenProps } from '../navigation/types';
 import { useOxy } from '../context/OxyContext';
-import { SecureClientSession } from '../../models/secureSession';
+import { ClientSession } from '../../models/session';
 import { fontFamilies } from '../styles/fonts';
 import { User } from '../../models/interfaces';
 import { toast } from '../../lib/sonner';
@@ -23,7 +23,7 @@ import { Ionicons } from '@expo/vector-icons';
 import Avatar from '../components/Avatar';
 import { Header, GroupedSection } from '../components';
 
-interface SessionWithUser extends SecureClientSession {
+interface SessionWithUser extends ClientSession {
     userProfile?: User;
     isLoadingProfile?: boolean;
 }
@@ -217,7 +217,7 @@ const ModernAccountSwitcherScreen: React.FC<BaseScreenProps> = ({
             async () => {
                 setRemoteLogoutSessionId(sessionId);
                 try {
-                    await oxyServices?.logoutSecureSession(user?.sessionId || '', sessionId);
+                    await oxyServices?.logoutSession(user?.sessionId || '', sessionId);
                     // Refresh device sessions list
                     await loadAllDeviceSessions();
                     toast.success(`Signed out from ${deviceName} successfully!`);
@@ -244,7 +244,7 @@ const ModernAccountSwitcherScreen: React.FC<BaseScreenProps> = ({
             async () => {
                 setLoggingOutAllDevices(true);
                 try {
-                    await oxyServices?.logoutAllDeviceSessions(user?.sessionId || '', undefined, true);
+                    await oxyServices?.logoutAllDeviceSessions(user?.sessionId || '');
                     // Refresh device sessions list
                     await loadAllDeviceSessions();
                     toast.success('Signed out from all other devices successfully!');

package/src/ui/screens/FileManagementScreen.tsx

@@ -118,7 +118,7 @@ const FileManagementScreen: React.FC<FileManagementScreenProps> = ({
                 setLoading(true);
             }
 
-            const response = await oxyServices.listUserFiles(targetUserId);
+            const response = await oxyServices.files.listUserFiles(targetUserId);
             setFiles(response.files || []);
         } catch (error: any) {
             console.error('Failed to load files:', error);
@@ -172,7 +172,7 @@ const FileManagementScreen: React.FC<FileManagementScreenProps> = ({
             await Promise.all(
                 photosToLoad.map(async (photo) => {
                     try {
-                        const downloadUrl = oxyServices.getFileDownloadUrl(photo.id);
+                        const downloadUrl = oxyServices.files.getFileDownloadUrl(photo.id);
 
                         if (Platform.OS === 'web') {
                             const img = new (window as any).Image();
@@ -340,7 +340,7 @@ const FileManagementScreen: React.FC<FileManagementScreenProps> = ({
             console.log('Current user ID:', user?.id);
             setDeleting(fileId);
 
-            const result = await oxyServices.deleteFile(fileId);
+            const result = await oxyServices.files.deleteFile(fileId);
             console.log('Delete result:', result);
 
             toast.success('File deleted successfully');
@@ -408,7 +408,7 @@ const FileManagementScreen: React.FC<FileManagementScreenProps> = ({
                 console.log('Downloading file:', { fileId, filename });
 
                 // Use the public download URL method
-                const downloadUrl = oxyServices.getFileDownloadUrl(fileId);
+                const downloadUrl = oxyServices.files.getFileDownloadUrl(fileId);
                 console.log('Download URL:', downloadUrl);
 
                 try {
@@ -426,7 +426,7 @@ const FileManagementScreen: React.FC<FileManagementScreenProps> = ({
                     console.warn('Link download failed, trying fetch method:', linkError);
 
                     // Method 2: Fallback to authenticated download
-                    const blob = await oxyServices.getFileContentAsBlob(fileId);
+                    const blob = await oxyServices.files.getFileContentAsBlob(fileId);
                     const url = window.URL.createObjectURL(blob);
 
                     const link = document.createElement('a');
@@ -491,11 +491,11 @@ const FileManagementScreen: React.FC<FileManagementScreenProps> = ({
                         file.contentType.startsWith('video/') ||
                         file.contentType.startsWith('audio/')) {
                         // For images, PDFs, videos, and audio, we'll use the URL directly
-                        const downloadUrl = oxyServices.getFileDownloadUrl(file.id);
+                        const downloadUrl = oxyServices.files.getFileDownloadUrl(file.id);
                         setFileContent(downloadUrl);
                     } else {
                         // For text files, get the content using authenticated request
-                        const content = await oxyServices.getFileContentAsText(file.id);
+                        const content = await oxyServices.files.getFileContentAsText(file.id);
                         setFileContent(content);
                     }
                 } catch (error: any) {
@@ -532,7 +532,7 @@ const FileManagementScreen: React.FC<FileManagementScreenProps> = ({
     };
 
     const renderSimplePhotoItem = useCallback((photo: FileMetadata, index: number) => {
-        const downloadUrl = oxyServices.getFileDownloadUrl(photo.id);
+        const downloadUrl = oxyServices.files.getFileDownloadUrl(photo.id);
 
         // Calculate photo item width based on actual container size from bottom sheet
         let itemsPerRow = 3; // Default for mobile
@@ -598,7 +598,7 @@ const FileManagementScreen: React.FC<FileManagementScreenProps> = ({
     }, [oxyServices, containerWidth]);
 
     const renderJustifiedPhotoItem = useCallback((photo: FileMetadata, width: number, height: number, isLast: boolean) => {
-        const downloadUrl = oxyServices.getFileDownloadUrl(photo.id);
+        const downloadUrl = oxyServices.files.getFileDownloadUrl(photo.id);
 
         return (
             <TouchableOpacity
@@ -689,7 +689,7 @@ const FileManagementScreen: React.FC<FileManagementScreenProps> = ({
                                 {isImage && (
                                     Platform.OS === 'web' ? (
                                         <img
-                                            src={oxyServices.getFileDownloadUrl(file.id)}
+                                            src={oxyServices.files.getFileDownloadUrl(file.id)}
                                             style={{
                                                 width: '100%',
                                                 height: '100%',
@@ -709,7 +709,7 @@ const FileManagementScreen: React.FC<FileManagementScreenProps> = ({
                                         />
                                     ) : (
                                         <Image
-                                            source={{ uri: oxyServices.getFileDownloadUrl(file.id) }}
+                                            source={{ uri: oxyServices.files.getFileDownloadUrl(file.id) }}
                                             style={styles.previewImage}
                                             resizeMode="cover"
                                             onError={() => {
@@ -817,7 +817,7 @@ const FileManagementScreen: React.FC<FileManagementScreenProps> = ({
     };
 
     const renderPhotoItem = (photo: FileMetadata, index: number) => {
-        const downloadUrl = oxyServices.getFileDownloadUrl(photo.id);
+        const downloadUrl = oxyServices.files.getFileDownloadUrl(photo.id);
 
         // Calculate photo item width based on actual container size from bottom sheet
         let itemsPerRow = 3; // Default for mobile

package/src/ui/screens/ProfileScreen.tsx

@@ -61,7 +61,7 @@ const ProfileScreen: React.FC<ProfileScreenProps> = ({ userId, username, theme,
 
         // Load user profile and karma total
         Promise.all([
-            oxyServices.getUserById(userId).catch(err => {
+            oxyServices.users.getUserById(userId).catch((err: any) => {
                 console.error('getUserById error:', err);
                 // If this is the current user and the API call fails, use current user data as fallback
                 if (currentUser && currentUser.id === userId) {
@@ -70,8 +70,8 @@ const ProfileScreen: React.FC<ProfileScreenProps> = ({ userId, username, theme,
                 }
                 throw err;
             }),
-            oxyServices.getUserKarmaTotal ?
-                oxyServices.getUserKarmaTotal(userId).catch(err => {
+            oxyServices.karma.getUserKarmaTotal ?
+                oxyServices.karma.getUserKarmaTotal(userId).catch((err: any) => {
                     console.warn('getUserKarmaTotal error:', err);
                     return { total: undefined };
                 }) :

package/src/ui/screens/SessionManagementScreen.tsx

@@ -16,7 +16,7 @@ import { fontFamilies } from '../styles/fonts';
 import { toast } from '../../lib/sonner';
 import { Ionicons } from '@expo/vector-icons';
 import OxyIcon from '../components/icon/OxyIcon';
-import { SecureClientSession } from '../../models/secureSession';
+import { ClientSession } from '../../models/session';
 import { confirmAction } from '../utils/confirmAction';
 import { Header } from '../components';
 
@@ -189,7 +189,7 @@ const SessionManagementScreen: React.FC<BaseScreenProps> = ({
             >
                 {userSessions.length > 0 ? (
                     <>
-                        {userSessions.map((session: SecureClientSession) => (
+                        {userSessions.map((session: ClientSession) => (
                             <View
                                 key={session.sessionId}
                                 style={[

package/src/ui/screens/SignInScreen.tsx

@@ -136,7 +136,7 @@ const SignInScreen: React.FC<BaseScreenProps> = ({
 
         try {
             // First check if username exists by trying to get profile
-            const profile = await oxyServices.getUserProfileByUsername(usernameToValidate);
+            const profile = await oxyServices.users.getProfileByUsername(usernameToValidate);
 
             if (profile) {
                 const profileData = {

package/src/ui/screens/karma/KarmaCenterScreen.tsx

@@ -38,8 +38,8 @@ const KarmaCenterScreen: React.FC<BaseScreenProps> = ({
         setIsLoading(true);
         setError(null);
         Promise.all([
-            oxyServices.getUserKarmaTotal(user.id),
-            oxyServices.getUserKarmaHistory(user.id, 20, 0),
+            oxyServices.karma.getUserKarmaTotal(user.id),
+            oxyServices.karma.getUserKarmaHistory(user.id, 20, 0),
         ])
             .then(([totalRes, historyRes]) => {
                 setKarmaTotal(totalRes.total);

package/src/ui/screens/karma/KarmaLeaderboardScreen.tsx

@@ -19,9 +19,9 @@ const KarmaLeaderboardScreen: React.FC<BaseScreenProps> = ({ goBack, theme, navi
     useEffect(() => {
         setIsLoading(true);
         setError(null);
-        oxyServices.getKarmaLeaderboard()
-            .then((data) => setLeaderboard(Array.isArray(data) ? data : []))
-            .catch((err) => setError(err.message || 'Failed to load leaderboard'))
+        oxyServices.karma.getKarmaLeaderboard()
+            .then((data: any) => setLeaderboard(Array.isArray(data) ? data : []))
+            .catch((err: any) => setError(err.message || 'Failed to load leaderboard'))
             .finally(() => setIsLoading(false));
     }, [oxyServices]);
 

package/src/ui/screens/karma/KarmaRulesScreen.tsx

@@ -18,9 +18,9 @@ const KarmaRulesScreen: React.FC<BaseScreenProps> = ({ goBack, theme }) => {
     useEffect(() => {
         setIsLoading(true);
         setError(null);
-        oxyServices.getKarmaRules()
-            .then((data) => setRules(Array.isArray(data) ? data : []))
-            .catch((err) => setError(err.message || 'Failed to load rules'))
+        oxyServices.karma.getKarmaRules()
+            .then((data: any) => setRules(Array.isArray(data) ? data : []))
+            .catch((err: any) => setError(err.message || 'Failed to load rules'))
             .finally(() => setIsLoading(false));
     }, [oxyServices]);
 

package/src/ui/stores/followStore.ts

@@ -53,7 +53,7 @@ export const useFollowStore = create<FollowState>((set: any, get: any) => ({
       errors: { ...state.errors, [userId]: null },
     }));
     try {
-      const response = await oxyServices.getFollowStatus(userId);
+      const response = await oxyServices.users.getFollowStatus(userId);
       set((state: FollowState) => ({
         followingUsers: { ...state.followingUsers, [userId]: response.isFollowing },
         fetchingUsers: { ...state.fetchingUsers, [userId]: false },
@@ -75,10 +75,10 @@ export const useFollowStore = create<FollowState>((set: any, get: any) => ({
       let response: any;
       let newFollowState;
       if (isCurrentlyFollowing) {
-        response = await oxyServices.unfollowUser(userId);
+        response = await oxyServices.users.unfollowUser(userId);
         newFollowState = false;
       } else {
-        response = await oxyServices.followUser(userId);
+        response = await oxyServices.users.followUser(userId);
         newFollowState = true;
       }
       
@@ -158,7 +158,7 @@ export const useFollowStore = create<FollowState>((set: any, get: any) => ({
       loadingCounts: { ...state.loadingCounts, [userId]: true },
     }));
     try {
-      const user = await oxyServices.getUserById(userId);
+      const user = await oxyServices.users.getUserById(userId);
       if (user && user._count) {
         set((state: FollowState) => ({
           followerCounts: { 

package/src/utils/apiUtils.ts

@@ -0,0 +1,102 @@
+/**
+ * Utility functions for common API patterns
+ */
+
+/**
+ * Build URL search parameters from an object
+ * @param params Object with parameter key-value pairs
+ * @returns URLSearchParams instance
+ */
+export function buildSearchParams(params: Record<string, any>): URLSearchParams {
+  const searchParams = new URLSearchParams();
+  
+  for (const [key, value] of Object.entries(params)) {
+    if (value !== undefined && value !== null) {
+      searchParams.append(key, value.toString());
+    }
+  }
+  
+  return searchParams;
+}
+
+/**
+ * Build URL with search parameters
+ * @param baseUrl Base URL
+ * @param params Object with parameter key-value pairs
+ * @returns Complete URL with search parameters
+ */
+export function buildUrl(baseUrl: string, params?: Record<string, any>): string {
+  if (!params) return baseUrl;
+  
+  const searchParams = buildSearchParams(params);
+  const queryString = searchParams.toString();
+  
+  return queryString ? `${baseUrl}?${queryString}` : baseUrl;
+}
+
+/**
+ * Common pagination parameters
+ */
+export interface PaginationParams {
+  limit?: number;
+  offset?: number;
+}
+
+/**
+ * Build pagination search parameters
+ * @param params Pagination parameters
+ * @returns URLSearchParams with pagination
+ */
+export function buildPaginationParams(params: PaginationParams): URLSearchParams {
+  return buildSearchParams(params);
+}
+
+/**
+ * Common API response wrapper
+ */
+export interface ApiResponse<T = any> {
+  data: T;
+  message?: string;
+  success?: boolean;
+}
+
+/**
+ * Common error response wrapper
+ */
+export interface ErrorResponse {
+  message: string;
+  code: string;
+  status: number;
+  details?: any;
+}
+
+/**
+ * Validate required parameters
+ * @param params Object to validate
+ * @param requiredKeys Array of required keys
+ * @throws Error if any required key is missing
+ */
+export function validateRequiredParams(params: Record<string, any>, requiredKeys: string[]): void {
+  const missing = requiredKeys.filter(key => params[key] === undefined || params[key] === null);
+  
+  if (missing.length > 0) {
+    throw new Error(`Missing required parameters: ${missing.join(', ')}`);
+  }
+}
+
+/**
+ * Safe JSON parsing with error handling
+ * @param data Data to parse
+ * @param fallback Fallback value if parsing fails
+ * @returns Parsed data or fallback
+ */
+export function safeJsonParse<T>(data: any, fallback: T): T {
+  if (typeof data === 'string') {
+    try {
+      return JSON.parse(data);
+    } catch {
+      return fallback;
+    }
+  }
+  return data as T;
+}