@oxyhq/services 5.10.4 → 5.10.6

package/lib/module/core/OxyServices.js

@@ -3,11 +3,12 @@
 import axios from 'axios';
 import { jwtDecode } from 'jwt-decode';
 import { handleHttpError } from '../utils/errorUtils';
+import { buildSearchParams, buildPaginationParams } from '../utils/apiUtils';
 /**
- * OxyServices - Base client library for interacting with the Oxy API
+ * OxyServices - Unified client library for interacting with the Oxy API
  * 
- * This class provides the core HTTP client setup, token management, and error handling.
- * Specific functionality is delegated to focused service modules.
+ * This class provides all API functionality in one simple, easy-to-use interface.
+ * No need to manage multiple service instances - everything is available directly.
  */
 // Centralized token store
 class TokenStore {
@@ -105,6 +106,10 @@ export class OxyServices {
     });
   }
 
+  // ============================================================================
+  // CORE METHODS (HTTP Client, Token Management, Error Handling)
+  // ============================================================================
+
   /**
    * Get the configured base URL
    */
@@ -165,7 +170,7 @@ export class OxyServices {
   }
 
   /**
-   * Get the HTTP client instance (protected for use by service modules)
+   * Get the HTTP client instance (public for external use)
    */
   getClient() {
     return this.client;
@@ -190,6 +195,790 @@ export class OxyServices {
     }
   }
 
+  // ============================================================================
+  // AUTHENTICATION METHODS
+  // ============================================================================
+
+  /**
+   * Sign up a new user
+   */
+  async signUp(username, email, password) {
+    try {
+      const res = await this.client.post('/api/auth/signup', {
+        username,
+        email,
+        password
+      });
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Sign in with device management
+   */
+  async signIn(username, password, deviceName, deviceFingerprint) {
+    try {
+      const res = await this.client.post('/api/auth/login', {
+        username,
+        password,
+        deviceName,
+        deviceFingerprint
+      });
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get user by session ID
+   */
+  async getUserBySession(sessionId) {
+    try {
+      const res = await this.client.get(`/api/session/user/${sessionId}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get access token by session ID and set it in the token store
+   */
+  async getTokenBySession(sessionId) {
+    try {
+      console.log('🔑 getTokenBySession - Fetching token for session:', sessionId);
+      const res = await this.client.get(`/api/session/token/${sessionId}`);
+      const {
+        accessToken
+      } = res.data;
+      console.log('🔑 getTokenBySession - Token received:', !!accessToken);
+
+      // Set the token in the centralized token store
+      this.setTokens(accessToken);
+      console.log('🔑 getTokenBySession - Token set in store');
+      return res.data;
+    } catch (error) {
+      console.log('❌ getTokenBySession - Error:', error);
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get sessions by session ID
+   */
+  async getSessionsBySessionId(sessionId) {
+    try {
+      const res = await this.client.get(`/api/session/sessions/${sessionId}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Logout from a specific session
+   */
+  async logoutSession(sessionId, targetSessionId) {
+    try {
+      const url = targetSessionId ? `/api/session/logout/${sessionId}/${targetSessionId}` : `/api/session/logout/${sessionId}`;
+      await this.client.post(url);
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Logout from all sessions
+   */
+  async logoutAllSessions(sessionId) {
+    try {
+      await this.client.post(`/api/session/logout-all/${sessionId}`);
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Validate session
+   */
+  async validateSession(sessionId, options = {}) {
+    try {
+      const params = new URLSearchParams();
+      if (options.deviceFingerprint) {
+        params.append('deviceFingerprint', options.deviceFingerprint);
+      }
+      if (options.useHeaderValidation) {
+        params.append('useHeaderValidation', 'true');
+      }
+      const url = `/api/session/validate/${sessionId}?${params.toString()}`;
+      const res = await this.client.get(url);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Check username availability
+   */
+  async checkUsernameAvailability(username) {
+    try {
+      const res = await this.client.get(`/api/auth/check-username/${username}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Check email availability
+   */
+  async checkEmailAvailability(email) {
+    try {
+      const res = await this.client.get(`/api/auth/check-email/${email}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  // ============================================================================
+  // USER METHODS
+  // ============================================================================
+
+  /**
+   * Get profile by username
+   */
+  async getProfileByUsername(username) {
+    try {
+      const res = await this.client.get(`/api/profiles/username/${username}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Search user profiles
+   */
+  async searchProfiles(query, pagination) {
+    try {
+      const params = {
+        query,
+        ...pagination
+      };
+      const searchParams = buildSearchParams(params);
+      const res = await this.client.get(`/api/profiles/search?${searchParams.toString()}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get profile recommendations
+   */
+  async getProfileRecommendations() {
+    try {
+      const res = await this.client.get('/api/profiles/recommendations');
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get user by ID
+   */
+  async getUserById(userId) {
+    try {
+      const res = await this.client.get(`/api/users/${userId}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get current user
+   */
+  async getCurrentUser() {
+    try {
+      const res = await this.client.get('/api/users/me');
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Update user profile
+   */
+  async updateProfile(updates) {
+    try {
+      const res = await this.client.put('/api/users/me', updates);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Update user by ID (admin function)
+   */
+  async updateUser(userId, updates) {
+    try {
+      const res = await this.client.put(`/api/users/${userId}`, updates);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Follow a user
+   */
+  async followUser(userId) {
+    try {
+      const res = await this.client.post(`/api/users/${userId}/follow`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Unfollow a user
+   */
+  async unfollowUser(userId) {
+    try {
+      const res = await this.client.delete(`/api/users/${userId}/follow`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get follow status
+   */
+  async getFollowStatus(userId) {
+    try {
+      const res = await this.client.get(`/api/users/${userId}/follow-status`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get user followers
+   */
+  async getUserFollowers(userId, pagination) {
+    try {
+      const params = buildPaginationParams(pagination || {});
+      const res = await this.client.get(`/api/users/${userId}/followers?${params.toString()}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get user following
+   */
+  async getUserFollowing(userId, pagination) {
+    try {
+      const params = buildPaginationParams(pagination || {});
+      const res = await this.client.get(`/api/users/${userId}/following?${params.toString()}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get notifications
+   */
+  async getNotifications() {
+    try {
+      const res = await this.client.get('/api/notifications');
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get unread notification count
+   */
+  async getUnreadCount() {
+    try {
+      const res = await this.client.get('/api/notifications/unread-count');
+      return res.data.count;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Create notification
+   */
+  async createNotification(data) {
+    try {
+      const res = await this.client.post('/api/notifications', data);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Mark notification as read
+   */
+  async markNotificationAsRead(notificationId) {
+    try {
+      await this.client.put(`/api/notifications/${notificationId}/read`);
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Mark all notifications as read
+   */
+  async markAllNotificationsAsRead() {
+    try {
+      await this.client.put('/api/notifications/read-all');
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Delete notification
+   */
+  async deleteNotification(notificationId) {
+    try {
+      await this.client.delete(`/api/notifications/${notificationId}`);
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  // ============================================================================
+  // PAYMENT METHODS
+  // ============================================================================
+
+  /**
+   * Create a payment
+   */
+  async createPayment(data) {
+    try {
+      const res = await this.client.post('/api/payments', data);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get payment by ID
+   */
+  async getPayment(paymentId) {
+    try {
+      const res = await this.client.get(`/api/payments/${paymentId}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get user payments
+   */
+  async getUserPayments() {
+    try {
+      const res = await this.client.get('/api/payments/user');
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  // ============================================================================
+  // KARMA METHODS
+  // ============================================================================
+
+  /**
+   * Get user karma
+   */
+  async getUserKarma(userId) {
+    try {
+      const res = await this.client.get(`/api/karma/${userId}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Give karma to user
+   */
+  async giveKarma(userId, amount, reason) {
+    try {
+      const res = await this.client.post(`/api/karma/${userId}/give`, {
+        amount,
+        reason
+      });
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get user karma total
+   */
+  async getUserKarmaTotal(userId) {
+    try {
+      const res = await this.client.get(`/api/karma/${userId}/total`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get user karma history
+   */
+  async getUserKarmaHistory(userId, limit, offset) {
+    try {
+      const params = new URLSearchParams();
+      if (limit) params.append('limit', limit.toString());
+      if (offset) params.append('offset', offset.toString());
+      const res = await this.client.get(`/api/karma/${userId}/history?${params.toString()}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get karma leaderboard
+   */
+  async getKarmaLeaderboard() {
+    try {
+      const res = await this.client.get('/api/karma/leaderboard');
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get karma rules
+   */
+  async getKarmaRules() {
+    try {
+      const res = await this.client.get('/api/karma/rules');
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  // ============================================================================
+  // FILE METHODS
+  // ============================================================================
+
+  /**
+   * Upload file
+   */
+  async uploadFile(file, options) {
+    try {
+      const formData = file instanceof FormData ? file : new FormData();
+      if (file instanceof File) {
+        formData.append('file', file);
+      }
+      const res = await this.client.post('/api/files/upload', formData, {
+        headers: {
+          'Content-Type': 'multipart/form-data'
+        },
+        ...options
+      });
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get file by ID
+   */
+  async getFile(fileId) {
+    try {
+      const res = await this.client.get(`/api/files/${fileId}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Delete file
+   */
+  async deleteFile(fileId) {
+    try {
+      const res = await this.client.delete(`/api/files/${fileId}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get file download URL
+   */
+  getFileDownloadUrl(fileId) {
+    return `${OXY_CLOUD_URL}/files/${fileId}/download`;
+  }
+
+  /**
+   * Get file stream URL
+   */
+  getFileStreamUrl(fileId) {
+    return `${OXY_CLOUD_URL}/files/${fileId}/stream`;
+  }
+
+  /**
+   * List user files
+   */
+  async listUserFiles(userId, limit, offset, filters) {
+    try {
+      const params = new URLSearchParams();
+      if (limit) params.append('limit', limit.toString());
+      if (offset) params.append('offset', offset.toString());
+      if (filters) {
+        Object.entries(filters).forEach(([key, value]) => {
+          params.append(key, value.toString());
+        });
+      }
+      const res = await this.client.get(`/api/files/list/${userId}?${params.toString()}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Download file content
+   */
+  async downloadFileContent(fileId) {
+    try {
+      const res = await this.client.get(`/api/files/${fileId}`, {
+        responseType: 'blob'
+      });
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get file content as text
+   */
+  async getFileContentAsText(fileId) {
+    try {
+      const res = await this.client.get(`/api/files/${fileId}`, {
+        headers: {
+          'Accept': 'text/plain'
+        }
+      });
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get file content as blob
+   */
+  async getFileContentAsBlob(fileId) {
+    try {
+      const res = await this.client.get(`/api/files/${fileId}`, {
+        responseType: 'blob'
+      });
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  // ============================================================================
+  // LOCATION METHODS
+  // ============================================================================
+
+  /**
+   * Update user location
+   */
+  async updateLocation(latitude, longitude) {
+    try {
+      const res = await this.client.post('/api/location', {
+        latitude,
+        longitude
+      });
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get nearby users
+   */
+  async getNearbyUsers(radius) {
+    try {
+      const params = radius ? `?radius=${radius}` : '';
+      const res = await this.client.get(`/api/location/nearby${params}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  // ============================================================================
+  // ANALYTICS METHODS
+  // ============================================================================
+
+  /**
+   * Track event
+   */
+  async trackEvent(eventName, properties) {
+    try {
+      await this.client.post('/api/analytics/events', {
+        event: eventName,
+        properties
+      });
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get analytics data
+   */
+  async getAnalytics(startDate, endDate) {
+    try {
+      const params = new URLSearchParams();
+      if (startDate) params.append('startDate', startDate);
+      if (endDate) params.append('endDate', endDate);
+      const res = await this.client.get(`/api/analytics?${params.toString()}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  // ============================================================================
+  // DEVICE METHODS
+  // ============================================================================
+
+  /**
+   * Register device
+   */
+  async registerDevice(deviceData) {
+    try {
+      const res = await this.client.post('/api/devices', deviceData);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get user devices
+   */
+  async getUserDevices() {
+    try {
+      const res = await this.client.get('/api/devices');
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Remove device
+   */
+  async removeDevice(deviceId) {
+    try {
+      await this.client.delete(`/api/devices/${deviceId}`);
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get device sessions
+   */
+  async getDeviceSessions(sessionId) {
+    try {
+      const res = await this.client.get(`/api/devices/sessions/${sessionId}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Logout all device sessions
+   */
+  async logoutAllDeviceSessions(sessionId, deviceId, excludeCurrent) {
+    try {
+      const params = new URLSearchParams();
+      if (deviceId) params.append('deviceId', deviceId);
+      if (excludeCurrent) params.append('excludeCurrent', 'true');
+      const res = await this.client.post(`/api/devices/logout-all/${sessionId}?${params.toString()}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Update device name
+   */
+  async updateDeviceName(sessionId, deviceName) {
+    try {
+      const res = await this.client.put(`/api/devices/name/${sessionId}`, {
+        deviceName
+      });
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  // ============================================================================
+  // UTILITY METHODS
+  // ============================================================================
+
+  /**
+   * Fetch link metadata
+   */
+  async fetchLinkMetadata(url) {
+    try {
+      const res = await this.client.get(`/api/link-metadata?url=${encodeURIComponent(url)}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
   /**
    * Simple Express.js authentication middleware
    * 
@@ -313,4 +1102,7 @@ export class OxyServices {
     };
   }
 }
+
+// Export the cloud URL constant
+export const OXY_CLOUD_URL = 'https://cloud.oxyhq.com';
 //# sourceMappingURL=OxyServices.js.map