@oxyhq/services 5.7.5 → 5.8.2

package/README.md

@@ -1,100 +1,95 @@
 # OxyHQServices
 
-🚀 **Zero-config authentication and user management** for React, React Native, and Node.js applications. No manual token handling, no interceptor setup, no middleware configuration required.
+A TypeScript client library for the Oxy API providing authentication, user management, and UI components for React and React Native applications.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Documentation](#documentation)
+- [UI Components](#ui-components)
+- [Package Exports](#package-exports)
+- [Requirements](#requirements)
+- [Development](#development)
+- [Integration](#integration)
+- [License](#license)
 
-## ✨ Quick Start (Zero Config)
+## Features
 
-### Frontend (React/React Native)
+- 🔐 **Streamlined Authentication**: Zero-config authentication with automatic token management
+- 🔄 **Auto Token Refresh**: Seamless token lifecycle management behind the scenes
+- 👥 **User Management**: Profile operations and social features
+- 🎨 **UI Components**: Pre-built React components for common functionality
+- 📱 **Cross-Platform**: Works in React Native and web applications
+- 🔧 **TypeScript**: Full type safety and IntelliSense support
+- 🚀 **Performance**: Optimized with automatic caching and state management
+
+## Quick Start
+
+```bash
+npm install @oxyhq/services
+```
 
-```tsx
-import React from 'react';
-import { AuthProvider, useAuth } from '@oxyhq/services';
+### Streamlined Authentication (Recommended)
+
+```typescript
+import { OxyProvider, useOxy } from '@oxyhq/services';
 
-// 1. Wrap your app (that's it for setup!)
 function App() {
   return (
-    <AuthProvider baseURL="https://api.oxy.so">
-      <MainApp />
-    </AuthProvider>
+    <OxyProvider baseURL="https://api.example.com">
+      <YourApp />
+    </OxyProvider>
   );
 }
 
-// 2. Use authentication anywhere
-function MainApp() {
-  const { isAuthenticated, user, login, logout } = useAuth();
+function UserProfile() {
+  const { oxyServices } = useOxy();
   
-  if (!isAuthenticated) {
-    return <button onClick={() => login('user', 'pass')}>Login</button>;
-  }
-  
-  return (
-    <div>
-      <h1>Welcome {user?.username}!</h1>
-      <button onClick={logout}>Logout</button>
-    </div>
-  );
+  const fetchData = async () => {
+    // No manual authentication needed - everything is automatic!
+    const user = await oxyServices.getCurrentUser();
+    const notifications = await oxyServices.getNotifications();
+  };
 }
 ```
 
-### Backend (Express.js)
+### With Built-in Bottom Sheet
+
+The OxyProvider now includes a built-in gorhom bottom sheet - no manual setup required!
 
 ```typescript
-import express from 'express';
-import { authenticateRequest, OxyRequest } from '@oxyhq/services/api';
+import { OxyProvider, useOxy, OxySignInButton } from '@oxyhq/services';
 
-const app = express();
+function App() {
+  return (
+    <OxyProvider 
+      baseURL="https://api.example.com"
+      initialScreen="SignIn"
+      theme="light"
+    >
+      <YourApp />
+    </OxyProvider>
+  );
+}
 
-// Zero-config authentication - just add the middleware
-app.get('/profile', authenticateRequest(), (req: OxyRequest, res) => {
-  // req.user is automatically populated!
-  res.json({ 
-    message: `Hello ${req.user!.username}!`,
-    user: req.user 
-  });
-});
+function Component() {
+  const { showBottomSheet } = useOxy();
+  
+  const openSignIn = () => {
+    showBottomSheet('SignIn'); // Works automatically!
+  };
+  
+  return (
+    <div>
+      <button onClick={openSignIn}>Sign In</button>
+      <OxySignInButton /> {/* Also works automatically! */}
+    </div>
+  );
+}
 ```
 
-That's it! 🎉 Authentication is now fully automated with:
-- ✅ Automatic token management and refresh
-- ✅ Secure storage across app restarts  
-- ✅ Built-in error handling and retry logic
-- ✅ Cross-platform support (React Native + Web)
-- ✅ TypeScript support throughout
-
-## 📖 Documentation
-
-- **[🚀 Zero-Config Authentication Guide](./packages/services/ZERO_CONFIG_AUTH.md)** - Complete setup guide
-- **[🔧 Migration Guide](./packages/services/ZERO_CONFIG_AUTH.md#migration-from-legacy-authentication)** - Upgrade from legacy auth
-- **[📚 Examples](./packages/services/examples/)** - Complete integration examples
-- **[🔐 API Reference](./packages/services/ZERO_CONFIG_AUTH.md#complete-api-reference)** - All components and hooks
-
-## Table of Contents
-
-- [Legacy Features](#features)
-- [Legacy Quick Start](#quick-start)
-- [Package Exports](#package-exports)
-- [Requirements](#requirements)
-- [Development](#development)
-- [Integration](#integration)
-- [License](#license)
-
----
-
-## Legacy Features (Still Supported)
-
-A TypeScript client library for the Oxy API providing authentication, user management, and UI components for React and React Native applications.
-
-- 🔐 **Authentication**: JWT-based auth with automatic token refresh
-- 👥 **User Management**: Profile operations and social features  
-- 🎨 **UI Components**: Pre-built React components for common functionality
-- 📱 **Cross-Platform**: Works in React Native and web applications
-- 🔧 **TypeScript**: Full type safety and IntelliSense support
-
-## Legacy Quick Start
-
-```bash
-npm install @oxyhq/services
-```
+### Traditional Usage
 
 ```typescript
 import { OxyServices } from '@oxyhq/services';
@@ -113,9 +108,14 @@ const response = await oxy.auth.login({
 const user = await oxy.users.getCurrentUser();
 ```
 
+## Documentation
+
+For comprehensive documentation, API reference, and examples:
+
 - [📚 Full Documentation](./docs/README.md)
 - [🚀 Quick Start Guide](./docs/quick-start.md)
 - [🔐 Core API Reference](./docs/core-api.md)
+- [⚡ Streamlined Authentication](./docs/core-api.md#streamlined-authentication) - **NEW!**
 - [💼 Integration Examples](./docs/examples/)
 
 ## UI Components

package/lib/commonjs/core/index.js

@@ -6,29 +6,8 @@ Object.defineProperty(exports, "__esModule", {
 var _exportNames = {
   OXY_CLOUD_URL: true,
   OxyServices: true,
-  AuthenticationManager: true,
-  initializeAuth: true,
-  getAuthManager: true,
-  AuthProvider: true,
-  useAuth: true,
-  useOxyClient: true,
-  useAuthStatus: true,
-  useCurrentUser: true,
-  withAuth: true,
   DeviceManager: true
 };
-Object.defineProperty(exports, "AuthProvider", {
-  enumerable: true,
-  get: function () {
-    return _useAuth.AuthProvider;
-  }
-});
-Object.defineProperty(exports, "AuthenticationManager", {
-  enumerable: true,
-  get: function () {
-    return _authManager.AuthenticationManager;
-  }
-});
 Object.defineProperty(exports, "DeviceManager", {
   enumerable: true,
   get: function () {
@@ -36,52 +15,8 @@ Object.defineProperty(exports, "DeviceManager", {
   }
 });
 exports.default = exports.OxyServices = exports.OXY_CLOUD_URL = void 0;
-Object.defineProperty(exports, "getAuthManager", {
-  enumerable: true,
-  get: function () {
-    return _authManager.getAuthManager;
-  }
-});
-Object.defineProperty(exports, "initializeAuth", {
-  enumerable: true,
-  get: function () {
-    return _authManager.initializeAuth;
-  }
-});
-Object.defineProperty(exports, "useAuth", {
-  enumerable: true,
-  get: function () {
-    return _useAuth.useAuth;
-  }
-});
-Object.defineProperty(exports, "useAuthStatus", {
-  enumerable: true,
-  get: function () {
-    return _useAuth.useAuthStatus;
-  }
-});
-Object.defineProperty(exports, "useCurrentUser", {
-  enumerable: true,
-  get: function () {
-    return _useAuth.useCurrentUser;
-  }
-});
-Object.defineProperty(exports, "useOxyClient", {
-  enumerable: true,
-  get: function () {
-    return _useAuth.useOxyClient;
-  }
-});
-Object.defineProperty(exports, "withAuth", {
-  enumerable: true,
-  get: function () {
-    return _useAuth.withAuth;
-  }
-});
 var _axios = _interopRequireDefault(require("axios"));
 var _jwtDecode = require("jwt-decode");
-var _authManager = require("./auth-manager");
-var _useAuth = require("./use-auth");
 var _deviceManager = require("../utils/deviceManager");
 var _interfaces = require("../models/interfaces");
 Object.keys(_interfaces).forEach(function (key) {
@@ -108,8 +43,6 @@ Object.keys(_secureSession).forEach(function (key) {
   });
 });
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-// Zero-Config Authentication Exports
-
 // Remove all FormData, form-data, and polyfill logic. Delete uploadFile and uploadFiles methods. Add a comment to use the new raw upload approach instead.
 
 // Import secure session types
@@ -124,54 +57,24 @@ const OXY_CLOUD_URL = exports.OXY_CLOUD_URL = 'https://cloud.oxy.so';
 /**
  * OxyServices - Client library for interacting with the Oxy API
  * 
- * ZERO-CONFIG MODE:
- * Use the new AuthProvider and useAuth hooks for automatic authentication management:
- * 
- * import { AuthProvider, useAuth } from '@oxyhq/services';
- * 
- * <AuthProvider baseURL="https://api.oxy.so">
- *   <App />
- * </AuthProvider>
- * 
- * Then in components:
- * const { login, user, isAuthenticated } = useAuth();
- * 
- * LEGACY MODE:
- * The OxyServices class below is maintained for backward compatibility
- * but we recommend migrating to the new zero-config approach.
- * 
- * Note: For authentication status in UI components, use `isAuthenticated` from useAuth() context
+ * Note: For authentication status in UI components, use `isAuthenticated` from useOxy() context
  * instead of checking token status directly on this service.
  */
 class OxyServices {
   accessToken = null;
   refreshToken = null;
   refreshPromise = null;
-  authManager = null;
 
   /**
    * Creates a new instance of the OxyServices client
    * @param config - Configuration for the client
    */
   constructor(config) {
-    // Try to use the new auth manager if available, otherwise fall back to legacy mode
-    try {
-      this.authManager = (0, _authManager.initializeAuth)(config.baseURL);
-      this.client = this.authManager.getClient();
-    } catch {
-      // Fall back to legacy implementation
-      this.client = _axios.default.create({
-        baseURL: config.baseURL,
-        timeout: 10000 // 10 second timeout
-      });
-      this.setupLegacyInterceptors();
-    }
-  }
+    this.client = _axios.default.create({
+      baseURL: config.baseURL,
+      timeout: 10000 // 10 second timeout
+    });
 
-  /**
-   * Setup legacy interceptors (only used if auth manager is not available)
-   */
-  setupLegacyInterceptors() {
     // Interceptor for adding auth header and handling token refresh
     this.client.interceptors.request.use(async req => {
       if (!this.accessToken) {
@@ -613,9 +516,17 @@ class OxyServices {
    */
   async getCurrentUser() {
     try {
+      console.log('OxyServices: Fetching current user...');
       const res = await this.client.get('/users/me');
+      console.log('OxyServices: Current user response:', {
+        hasUser: !!res.data,
+        userLinksMetadata: res.data?.linksMetadata,
+        userLinks: res.data?.links,
+        userWebsite: res.data?.website
+      });
       return res.data;
     } catch (error) {
+      console.error('OxyServices: Error fetching current user:', error);
       throw this.handleError(error);
     }
   }
@@ -627,9 +538,12 @@ class OxyServices {
    */
   async updateProfile(updates) {
     try {
+      console.log('OxyServices: Updating profile with:', updates);
       const res = await this.client.put('/users/me', updates);
+      console.log('OxyServices: Profile update response:', res.data);
       return res.data;
     } catch (error) {
+      console.error('OxyServices: Error updating profile:', error);
       throw this.handleError(error);
     }
   }
@@ -1343,10 +1257,13 @@ class OxyServices {
    * @returns Array of user sessions
    */
   async getSessionsBySessionId(sessionId) {
+    console.log('getSessionsBySessionId called with sessionId:', sessionId);
     try {
       const res = await this.client.get(`/secure-session/sessions/${sessionId}`);
+      console.log('getSessionsBySessionId response:', res.data);
       return res.data.sessions;
     } catch (error) {
+      console.error('getSessionsBySessionId error:', error);
       throw this.handleError(error);
     }
   }
@@ -1815,6 +1732,164 @@ class OxyServices {
       throw this.handleError(error);
     }
   }
+
+  /**
+   * Fetch metadata for a URL (title, description, image)
+   * @param url - The URL to fetch metadata for
+   * @returns Promise with metadata object
+   */
+  async fetchLinkMetadata(url) {
+    try {
+      const response = await this.client.post('/link-metadata/fetch-metadata', {
+        url
+      });
+      return response.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Search for locations using the enhanced location search API
+   * @param query - Search query string
+   * @param limit - Maximum number of results (default: 5)
+   * @param countrycodes - Optional country codes filter (e.g., "us,ca")
+   * @returns Promise with array of location results
+   */
+  async searchLocations(query, limit = 5, countrycodes) {
+    try {
+      const params = new URLSearchParams({
+        query,
+        limit: limit.toString()
+      });
+      if (countrycodes) {
+        params.append('countrycodes', countrycodes);
+      }
+      const res = await this.client.get(`/location-search/search?${params.toString()}`);
+      return res.data.results;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get detailed information about a specific location by coordinates
+   * @param lat - Latitude
+   * @param lon - Longitude
+   * @returns Promise with detailed location information
+   */
+  async getLocationDetails(lat, lon) {
+    try {
+      const res = await this.client.get(`/location-search/details?lat=${lat}&lon=${lon}`);
+      return res.data.result;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Find locations near a point using geospatial queries
+   * @param lat - Latitude
+   * @param lon - Longitude
+   * @param maxDistance - Maximum distance in meters (default: 10000)
+   * @param limit - Maximum number of results (default: 10)
+   * @param skip - Number of results to skip (default: 0)
+   * @returns Promise with nearby locations
+   */
+  async findLocationsNear(lat, lon, maxDistance = 10000, limit = 10, skip = 0) {
+    try {
+      const params = new URLSearchParams({
+        lat: lat.toString(),
+        lon: lon.toString(),
+        maxDistance: maxDistance.toString(),
+        limit: limit.toString(),
+        skip: skip.toString()
+      });
+      const res = await this.client.get(`/location-search/near?${params.toString()}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Search locations in database by text
+   * @param query - Search query
+   * @param limit - Maximum number of results (default: 10)
+   * @param skip - Number of results to skip (default: 0)
+   * @param type - Filter by location type
+   * @param country - Filter by country
+   * @param city - Filter by city
+   * @returns Promise with search results
+   */
+  async searchLocationsInDB(query, limit = 10, skip = 0, type, country, city) {
+    try {
+      const params = new URLSearchParams({
+        query,
+        limit: limit.toString(),
+        skip: skip.toString()
+      });
+      if (type) params.append('type', type);
+      if (country) params.append('country', country);
+      if (city) params.append('city', city);
+      const res = await this.client.get(`/location-search/db-search?${params.toString()}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get location statistics
+   * @returns Promise with location statistics
+   */
+  async getLocationStats() {
+    try {
+      const res = await this.client.get('/location-search/stats');
+      return res.data.stats;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get cache statistics
+   * @returns Promise with cache statistics
+   */
+  async getLocationCacheStats() {
+    try {
+      const res = await this.client.get('/location-search/cache/stats');
+      return res.data.stats;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Clear location cache
+   * @returns Promise with success status
+   */
+  async clearLocationCache() {
+    try {
+      const res = await this.client.delete('/location-search/cache');
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get performance statistics
+   * @returns Promise with performance statistics
+   */
+  async getLocationPerformanceStats() {
+    try {
+      const res = await this.client.get('/location-search/performance');
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
 }
 
 // Default export for backward compatibility