@oxyhq/services 5.16.23 → 5.16.25

package/lib/module/core/mixins/OxyServices.user.js

@@ -0,0 +1,399 @@
+"use strict";
+
+/**
+ * User Management Methods Mixin
+ */
+
+import { buildSearchParams, buildPaginationParams } from '../../utils/apiUtils';
+export function OxyServicesUserMixin(Base) {
+  return class extends Base {
+    constructor(...args) {
+      super(...args);
+    }
+    /**
+     * Get profile by username
+     */
+    async getProfileByUsername(username) {
+      try {
+        return await this.makeRequest('GET', `/api/profiles/username/${username}`, undefined, {
+          cache: true,
+          cacheTTL: 5 * 60 * 1000 // 5 minutes cache for profiles
+        });
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+
+    /**
+     * Search user profiles
+     */
+    async searchProfiles(query, pagination) {
+      try {
+        const params = {
+          query,
+          ...pagination
+        };
+        const searchParams = buildSearchParams(params);
+        const paramsObj = Object.fromEntries(searchParams.entries());
+        const response = await this.makeRequest('GET', '/api/profiles/search', paramsObj, {
+          cache: true,
+          cacheTTL: 2 * 60 * 1000 // 2 minutes cache
+        });
+
+        // New API shape: { data: User[], pagination: {...} }
+        const isSearchProfilesResponse = payload => typeof payload === 'object' && payload !== null && Array.isArray(payload.data);
+        if (isSearchProfilesResponse(response)) {
+          const typedResponse = response;
+          const paginationInfo = typedResponse.pagination ?? {
+            total: typedResponse.data.length,
+            limit: pagination?.limit ?? typedResponse.data.length,
+            offset: pagination?.offset ?? 0,
+            hasMore: typedResponse.data.length === (pagination?.limit ?? typedResponse.data.length) && (pagination?.limit ?? typedResponse.data.length) > 0
+          };
+          return {
+            data: typedResponse.data,
+            pagination: paginationInfo
+          };
+        }
+
+        // Legacy API shape: returns raw User[]
+        if (Array.isArray(response)) {
+          const fallbackLimit = pagination?.limit ?? response.length;
+          const fallbackPagination = {
+            total: response.length,
+            limit: fallbackLimit,
+            offset: pagination?.offset ?? 0,
+            hasMore: fallbackLimit > 0 && response.length === fallbackLimit
+          };
+          return {
+            data: response,
+            pagination: fallbackPagination
+          };
+        }
+
+        // If response is unexpected, throw an error
+        throw new Error('Unexpected search response format');
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+
+    /**
+     * Get profile recommendations
+     */
+    async getProfileRecommendations() {
+      return this.withAuthRetry(async () => {
+        return await this.makeRequest('GET', '/api/profiles/recommendations', undefined, {
+          cache: true
+        });
+      }, 'getProfileRecommendations');
+    }
+
+    /**
+     * Get user by ID
+     */
+    async getUserById(userId) {
+      try {
+        return await this.makeRequest('GET', `/api/users/${userId}`, undefined, {
+          cache: true,
+          cacheTTL: 5 * 60 * 1000 // 5 minutes cache
+        });
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+
+    /**
+     * Get current user
+     */
+    async getCurrentUser() {
+      return this.withAuthRetry(async () => {
+        return await this.makeRequest('GET', '/api/users/me', undefined, {
+          cache: true,
+          cacheTTL: 1 * 60 * 1000 // 1 minute cache for current user
+        });
+      }, 'getCurrentUser');
+    }
+
+    /**
+     * Update user profile
+     * TanStack Query handles offline queuing automatically
+     */
+    async updateProfile(updates) {
+      try {
+        return await this.makeRequest('PUT', '/api/users/me', updates, {
+          cache: false
+        });
+      } catch (error) {
+        const errorAny = error;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const status = errorAny?.status || errorAny?.response?.status;
+
+        // Check if it's an authentication error (401)
+        const isAuthError = status === 401 || errorMessage.includes('Authentication required') || errorMessage.includes('Invalid or missing authorization header');
+
+        // If authentication error and we don't have a token, this might be an offline session
+        // The caller should handle syncing the session before retrying
+        if (isAuthError && !this.hasValidToken()) {
+          // Re-throw with a specific message so the caller knows to sync
+          throw new Error('AUTH_REQUIRED_OFFLINE_SESSION: Session needs to be synced to get a token');
+        }
+        throw this.handleError(error);
+      }
+    }
+
+    /**
+     * Get privacy settings for a user
+     * @param userId - The user ID (MongoDB ObjectId, defaults to current user)
+     */
+    async getPrivacySettings(userId) {
+      try {
+        // Use getCurrentUserId() which returns MongoDB ObjectId from JWT token
+        // Never use getCurrentUser().id as it may be set to publicKey
+        const id = userId || this.getCurrentUserId();
+        if (!id) {
+          throw new Error('User ID is required');
+        }
+        return await this.makeRequest('GET', `/api/privacy/${id}/privacy`, undefined, {
+          cache: true,
+          cacheTTL: 2 * 60 * 1000 // 2 minutes cache
+        });
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+
+    /**
+     * Update privacy settings
+     * @param settings - Partial privacy settings object
+     * @param userId - The user ID (MongoDB ObjectId, defaults to current user)
+     */
+    async updatePrivacySettings(settings, userId) {
+      try {
+        // Use getCurrentUserId() which returns MongoDB ObjectId from JWT token
+        // Never use getCurrentUser().id as it may be set to publicKey
+        const id = userId || this.getCurrentUserId();
+        if (!id) {
+          throw new Error('User ID is required');
+        }
+        return await this.makeRequest('PATCH', `/api/privacy/${id}/privacy`, settings, {
+          cache: false
+        });
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+
+    /**
+     * Request account verification
+     */
+    async requestAccountVerification(reason, evidence) {
+      try {
+        return await this.makeRequest('POST', '/api/users/verify/request', {
+          reason,
+          evidence
+        }, {
+          cache: false
+        });
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+
+    /**
+     * Download account data export
+     */
+    async downloadAccountData(format = 'json') {
+      try {
+        // Use httpService for blob responses (it handles blob responses automatically)
+        const result = await this.getClient().request({
+          method: 'GET',
+          url: `/api/users/me/data`,
+          params: {
+            format
+          },
+          cache: false
+        });
+        return result;
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+
+    /**
+     * Delete account permanently
+     * @param password - User password for confirmation
+     * @param confirmText - Confirmation text (usually username)
+     */
+    async deleteAccount(password, confirmText) {
+      try {
+        return await this.makeRequest('DELETE', '/api/users/me', {
+          password,
+          confirmText
+        }, {
+          cache: false
+        });
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+
+    /**
+     * Follow a user
+     */
+    async followUser(userId) {
+      try {
+        return await this.makeRequest('POST', `/api/users/${userId}/follow`, undefined, {
+          cache: false
+        });
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+
+    /**
+     * Unfollow a user
+     */
+    async unfollowUser(userId) {
+      try {
+        return await this.makeRequest('DELETE', `/api/users/${userId}/follow`, undefined, {
+          cache: false
+        });
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+
+    /**
+     * Get follow status
+     */
+    async getFollowStatus(userId) {
+      try {
+        return await this.makeRequest('GET', `/api/users/${userId}/follow-status`, undefined, {
+          cache: true,
+          cacheTTL: 1 * 60 * 1000 // 1 minute cache
+        });
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+
+    /**
+     * Get user followers
+     */
+    async getUserFollowers(userId, pagination) {
+      try {
+        const params = buildPaginationParams(pagination || {});
+        const response = await this.makeRequest('GET', `/api/users/${userId}/followers`, params, {
+          cache: true,
+          cacheTTL: 2 * 60 * 1000 // 2 minutes cache
+        });
+        return {
+          followers: response.data || [],
+          total: response.pagination.total,
+          hasMore: response.pagination.hasMore
+        };
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+
+    /**
+     * Get user following
+     */
+    async getUserFollowing(userId, pagination) {
+      try {
+        const params = buildPaginationParams(pagination || {});
+        const response = await this.makeRequest('GET', `/api/users/${userId}/following`, params, {
+          cache: true,
+          cacheTTL: 2 * 60 * 1000 // 2 minutes cache
+        });
+        return {
+          following: response.data || [],
+          total: response.pagination.total,
+          hasMore: response.pagination.hasMore
+        };
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+
+    /**
+     * Get notifications
+     */
+    async getNotifications() {
+      return this.withAuthRetry(async () => {
+        return await this.makeRequest('GET', '/api/notifications', undefined, {
+          cache: false // Don't cache notifications - always get fresh data
+        });
+      }, 'getNotifications');
+    }
+
+    /**
+     * Get unread notification count
+     */
+    async getUnreadCount() {
+      try {
+        const res = await this.makeRequest('GET', '/api/notifications/unread-count', undefined, {
+          cache: false // Don't cache unread count - always get fresh data
+        });
+        return res.count;
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+
+    /**
+     * Create notification
+     */
+    async createNotification(data) {
+      try {
+        return await this.makeRequest('POST', '/api/notifications', data, {
+          cache: false
+        });
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+
+    /**
+     * Mark notification as read
+     */
+    async markNotificationAsRead(notificationId) {
+      try {
+        await this.makeRequest('PUT', `/api/notifications/${notificationId}/read`, undefined, {
+          cache: false
+        });
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+
+    /**
+     * Mark all notifications as read
+     */
+    async markAllNotificationsAsRead() {
+      try {
+        await this.makeRequest('PUT', '/api/notifications/read-all', undefined, {
+          cache: false
+        });
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+
+    /**
+     * Delete notification
+     */
+    async deleteNotification(notificationId) {
+      try {
+        await this.makeRequest('DELETE', `/api/notifications/${notificationId}`, undefined, {
+          cache: false
+        });
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+  };
+}
+//# sourceMappingURL=OxyServices.user.js.map

package/lib/module/core/mixins/OxyServices.user.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["buildSearchParams","buildPaginationParams","OxyServicesUserMixin","Base","constructor","args","getProfileByUsername","username","makeRequest","undefined","cache","cacheTTL","error","handleError","searchProfiles","query","pagination","params","searchParams","paramsObj","Object","fromEntries","entries","response","isSearchProfilesResponse","payload","Array","isArray","data","typedResponse","paginationInfo","total","length","limit","offset","hasMore","fallbackLimit","fallbackPagination","Error","getProfileRecommendations","withAuthRetry","getUserById","userId","getCurrentUser","updateProfile","updates","errorAny","errorMessage","message","String","status","isAuthError","includes","hasValidToken","getPrivacySettings","id","getCurrentUserId","updatePrivacySettings","settings","requestAccountVerification","reason","evidence","downloadAccountData","format","result","getClient","request","method","url","deleteAccount","password","confirmText","followUser","unfollowUser","getFollowStatus","getUserFollowers","followers","getUserFollowing","following","getNotifications","getUnreadCount","res","count","createNotification","markNotificationAsRead","notificationId","markAllNotificationsAsRead","deleteNotification"],"sourceRoot":"../../../../src","sources":["core/mixins/OxyServices.user.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/core/mixins/OxyServices.utility.js

@@ -0,0 +1,160 @@
+"use strict";
+
+/**
+ * Utility Methods Mixin
+ * 
+ * Provides utility methods including link metadata fetching
+ * and Express.js authentication middleware
+ */
+import { jwtDecode } from 'jwt-decode';
+import { CACHE_TIMES } from './mixinHelpers';
+export function OxyServicesUtilityMixin(Base) {
+  return class extends Base {
+    constructor(...args) {
+      super(...args);
+    }
+    /**
+     * Fetch link metadata
+     */
+    async fetchLinkMetadata(url) {
+      try {
+        return await this.makeRequest('GET', '/api/link-metadata', {
+          url
+        }, {
+          cache: true,
+          cacheTTL: CACHE_TIMES.EXTRA_LONG
+        });
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+
+    /**
+     * Simple Express.js authentication middleware
+     * 
+     * Built-in authentication middleware that validates JWT tokens and adds user data to requests.
+     * 
+     * @example
+     * ```typescript
+     * // Basic usage - just add it to your routes
+     * app.use('/api/protected', oxyServices.auth());
+     * 
+     * // With debug logging
+     * app.use('/api/protected', oxyServices.auth({ debug: true }));
+     * 
+     * // With custom error handling
+     * app.use('/api/protected', oxyServices.auth({
+     *   onError: (error) => console.error('Auth failed:', error)
+     * }));
+     * 
+     * // Load full user data
+     * app.use('/api/protected', oxyServices.auth({ loadUser: true }));
+     * ```
+     * 
+     * @param options Optional configuration
+     * @param options.debug Enable debug logging (default: false)
+     * @param options.onError Custom error handler
+     * @param options.loadUser Load full user data (default: false for performance)
+     * @param options.session Use session-based validation (default: false)
+     * @returns Express middleware function
+     */
+    auth(options = {}) {
+      const {
+        debug = false,
+        onError,
+        loadUser = false,
+        session = false
+      } = options;
+
+      // Return a synchronous middleware function
+      return (req, res, next) => {
+        try {
+          // Extract token from Authorization header
+          const authHeader = req.headers['authorization'];
+          const token = authHeader?.startsWith('Bearer ') ? authHeader.substring(7) : null;
+          if (debug) {
+            console.log(`🔐 Auth: Processing ${req.method} ${req.path}`);
+            console.log(`🔐 Auth: Token present: ${!!token}`);
+          }
+          if (!token) {
+            const error = {
+              message: 'Access token required',
+              code: 'MISSING_TOKEN',
+              status: 401
+            };
+            if (debug) console.log(`❌ Auth: Missing token`);
+            if (onError) return onError(error);
+            return res.status(401).json(error);
+          }
+
+          // Decode and validate token
+          let decoded;
+          try {
+            decoded = jwtDecode(token);
+            if (debug) {
+              console.log(`🔐 Auth: Token decoded, User ID: ${decoded.userId || decoded.id}`);
+            }
+          } catch (decodeError) {
+            const error = {
+              message: 'Invalid token format',
+              code: 'INVALID_TOKEN_FORMAT',
+              status: 403
+            };
+            if (debug) console.log(`❌ Auth: Token decode failed`);
+            if (onError) return onError(error);
+            return res.status(403).json(error);
+          }
+          const userId = decoded.userId || decoded.id;
+          if (!userId) {
+            const error = {
+              message: 'Token missing user ID',
+              code: 'INVALID_TOKEN_PAYLOAD',
+              status: 403
+            };
+            if (debug) console.log(`❌ Auth: Token missing user ID`);
+            if (onError) return onError(error);
+            return res.status(403).json(error);
+          }
+
+          // Check token expiration
+          if (decoded.exp && decoded.exp < Math.floor(Date.now() / 1000)) {
+            const error = {
+              message: 'Token expired',
+              code: 'TOKEN_EXPIRED',
+              status: 403
+            };
+            if (debug) console.log(`❌ Auth: Token expired`);
+            if (onError) return onError(error);
+            return res.status(403).json(error);
+          }
+
+          // For now, skip session validation to keep it simple
+          // Session validation can be added later if needed
+
+          // Set request properties immediately
+          req.userId = userId;
+          req.accessToken = token;
+          req.user = {
+            id: userId
+          };
+
+          // Automatically authenticate the OxyServices instance so all subsequent API calls are authenticated
+          this.setTokens(token);
+          if (debug) {
+            console.log(`✅ Auth: Authentication successful for user ${userId}`);
+          }
+          next();
+        } catch (error) {
+          const apiError = this.handleError(error);
+          if (debug) {
+            // Debug logging - using console.log is acceptable here for development
+            console.log(`❌ Auth: Unexpected error:`, apiError);
+          }
+          if (onError) return onError(apiError);
+          return res.status(apiError && apiError.status || 500).json(apiError);
+        }
+      };
+    }
+  };
+}
+//# sourceMappingURL=OxyServices.utility.js.map

package/lib/module/core/mixins/OxyServices.utility.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["jwtDecode","CACHE_TIMES","OxyServicesUtilityMixin","Base","constructor","args","fetchLinkMetadata","url","makeRequest","cache","cacheTTL","EXTRA_LONG","error","handleError","auth","options","debug","onError","loadUser","session","req","res","next","authHeader","headers","token","startsWith","substring","console","log","method","path","message","code","status","json","decoded","userId","id","decodeError","exp","Math","floor","Date","now","accessToken","user","setTokens","apiError"],"sourceRoot":"../../../../src","sources":["core/mixins/OxyServices.utility.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/core/mixins/index.js

@@ -0,0 +1,36 @@
+"use strict";
+
+/**
+ * Centralized mixin exports and composition helper
+ * 
+ * This module provides a clean way to compose all mixins
+ * and ensures consistent ordering for better maintainability
+ */
+
+import { OxyServicesBase } from '../OxyServices.base';
+import { OxyServicesAuthMixin } from './OxyServices.auth';
+import { OxyServicesUserMixin } from './OxyServices.user';
+import { OxyServicesPrivacyMixin } from './OxyServices.privacy';
+import { OxyServicesLanguageMixin } from './OxyServices.language';
+import { OxyServicesPaymentMixin } from './OxyServices.payment';
+import { OxyServicesKarmaMixin } from './OxyServices.karma';
+import { OxyServicesAssetsMixin } from './OxyServices.assets';
+import { OxyServicesDeveloperMixin } from './OxyServices.developer';
+import { OxyServicesLocationMixin } from './OxyServices.location';
+import { OxyServicesAnalyticsMixin } from './OxyServices.analytics';
+import { OxyServicesDevicesMixin } from './OxyServices.devices';
+import { OxyServicesSecurityMixin } from './OxyServices.security';
+import { OxyServicesUtilityMixin } from './OxyServices.utility';
+
+/**
+ * Composes all OxyServices mixins in the correct order
+ * 
+ * Order matters for mixins - dependencies should be applied first.
+ * This function ensures consistent composition across the codebase.
+ * 
+ * @returns The fully composed OxyServices class with all mixins applied
+ */
+export function composeOxyServices() {
+  return OxyServicesUtilityMixin(OxyServicesSecurityMixin(OxyServicesDevicesMixin(OxyServicesAnalyticsMixin(OxyServicesLocationMixin(OxyServicesDeveloperMixin(OxyServicesAssetsMixin(OxyServicesKarmaMixin(OxyServicesPaymentMixin(OxyServicesLanguageMixin(OxyServicesPrivacyMixin(OxyServicesUserMixin(OxyServicesAuthMixin(OxyServicesBase)))))))))))));
+}
+//# sourceMappingURL=index.js.map

package/lib/module/core/mixins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["OxyServicesBase","OxyServicesAuthMixin","OxyServicesUserMixin","OxyServicesPrivacyMixin","OxyServicesLanguageMixin","OxyServicesPaymentMixin","OxyServicesKarmaMixin","OxyServicesAssetsMixin","OxyServicesDeveloperMixin","OxyServicesLocationMixin","OxyServicesAnalyticsMixin","OxyServicesDevicesMixin","OxyServicesSecurityMixin","OxyServicesUtilityMixin","composeOxyServices"],"sourceRoot":"../../../../src","sources":["core/mixins/index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,eAAe,QAAQ,qBAAqB;AACrD,SAASC,oBAAoB,QAAQ,oBAAoB;AACzD,SAASC,oBAAoB,QAAQ,oBAAoB;AACzD,SAASC,uBAAuB,QAAQ,uBAAuB;AAC/D,SAASC,wBAAwB,QAAQ,wBAAwB;AACjE,SAASC,uBAAuB,QAAQ,uBAAuB;AAC/D,SAASC,qBAAqB,QAAQ,qBAAqB;AAC3D,SAASC,sBAAsB,QAAQ,sBAAsB;AAC7D,SAASC,yBAAyB,QAAQ,yBAAyB;AACnE,SAASC,wBAAwB,QAAQ,wBAAwB;AACjE,SAASC,yBAAyB,QAAQ,yBAAyB;AACnE,SAASC,uBAAuB,QAAQ,uBAAuB;AAC/D,SAASC,wBAAwB,QAAQ,wBAAwB;AACjE,SAASC,uBAAuB,QAAQ,uBAAuB;;AAE/D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAAA,EAAG;EACnC,OAAOD,uBAAuB,CAC5BD,wBAAwB,CACtBD,uBAAuB,CACrBD,yBAAyB,CACvBD,wBAAwB,CACtBD,yBAAyB,CACvBD,sBAAsB,CACpBD,qBAAqB,CACnBD,uBAAuB,CACrBD,wBAAwB,CACtBD,uBAAuB,CACrBD,oBAAoB,CAClBD,oBAAoB,CAACD,eAAe,CACtC,CACF,CACF,CACF,CACF,CACF,CACF,CACF,CACF,CACF,CACF,CACF,CAAC;AACH","ignoreList":[]}

package/lib/module/core/mixins/mixinHelpers.js

@@ -0,0 +1,56 @@
+"use strict";
+
+/**
+ * Helper utilities for mixin classes
+ * Provides common patterns to reduce code duplication
+ */
+
+/**
+ * Wraps an async method with standard error handling
+ * Reduces boilerplate in mixin methods
+ */
+export async function withErrorHandling(operation, handleError) {
+  try {
+    return await operation();
+  } catch (error) {
+    throw handleError(error);
+  }
+}
+
+/**
+ * Creates a standard API request method with error handling
+ * Reduces duplication across mixin methods
+ */
+export function createApiMethod(makeRequest, handleError, method, url, options = {}) {
+  return async (...args) => {
+    const urlString = typeof url === 'function' ? url(...args) : url;
+    const requestData = options.transformData ? options.transformData(args) : args[0];
+    const requestOptions = {
+      cache: options.cache ?? true,
+      cacheTTL: options.cacheTTL,
+      retry: options.retry ?? true
+    };
+    try {
+      const response = await makeRequest(method, urlString, requestData, requestOptions);
+      return options.transformResponse ? options.transformResponse(response) : response;
+    } catch (error) {
+      throw handleError(error);
+    }
+  };
+}
+
+/**
+ * Cache time constants (in milliseconds)
+ */
+export const CACHE_TIMES = {
+  SHORT: 1 * 60 * 1000,
+  // 1 minute
+  MEDIUM: 2 * 60 * 1000,
+  // 2 minutes
+  LONG: 5 * 60 * 1000,
+  // 5 minutes
+  VERY_LONG: 10 * 60 * 1000,
+  // 10 minutes
+  EXTRA_LONG: 30 * 60 * 1000 // 30 minutes
+};
+//# sourceMappingURL=mixinHelpers.js.map