@oxyhq/services 5.9.1 → 5.9.3

package/README.md

@@ -110,13 +110,7 @@ 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/)
+This package provides a TypeScript client library for the Oxy API with authentication, user management, and UI components.
 
 ## UI Components
 
@@ -141,19 +135,7 @@ import { OxyProvider, Avatar } from '@oxyhq/services/ui';
 import { OxyServices, OxyProvider } from '@oxyhq/services/full';
 ```
 
-## Zero-Config Express Router
-
-Quickly mount authentication routes in any Express app:
-
-```typescript
-import express from 'express';
-import { createAuth } from '@oxyhq/services/core';
-
-const app = express();
-app.use('/auth', createAuth({ baseURL: 'http://localhost:3000' }).middleware());
-```
 
-This automatically provides sign-up, login, logout, refresh, and session management endpoints.
 
 ## Requirements
 
@@ -205,22 +187,8 @@ npm install
 
 # Build the library
 npm run build
-
-# Run tests
-npm test
-
-# Development mode
-npm run dev
 ```
 
-## Integration
-
-This library works with:
-- **[Oxy API](../oxy-api/)** - The companion authentication server
-- **Express.js** - Built-in middleware support
-- **React/React Native** - UI components and hooks
-- **Next.js** - SSR/SSG authentication
-
 ## License
 
 This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

package/lib/commonjs/core/OxyServices.js

@@ -0,0 +1,159 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.OxyServices = void 0;
+var _axios = _interopRequireDefault(require("axios"));
+var _jwtDecode = require("jwt-decode");
+var _errorUtils = require("../utils/errorUtils");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * OxyServices - Base 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.
+ */
+class OxyServices {
+  accessToken = null;
+  refreshToken = null;
+
+  /**
+   * Creates a new instance of the OxyServices client
+   * @param config - Configuration for the client
+   */
+  constructor(config) {
+    this.client = _axios.default.create({
+      baseURL: config.baseURL,
+      timeout: 10000 // 10 second timeout
+    });
+    this.setupInterceptors();
+  }
+
+  /**
+   * Setup axios interceptors for authentication and error handling
+   */
+  setupInterceptors() {
+    // Request interceptor for adding auth header and handling token refresh
+    this.client.interceptors.request.use(async req => {
+      if (!this.accessToken) {
+        return req;
+      }
+
+      // Check if token is expired and refresh if needed
+      try {
+        const decoded = (0, _jwtDecode.jwtDecode)(this.accessToken);
+        const currentTime = Math.floor(Date.now() / 1000);
+
+        // If token expires in less than 60 seconds, refresh it
+        if (decoded.exp - currentTime < 60) {
+          // For session-based tokens, get a new token from the session
+          if (decoded.sessionId) {
+            try {
+              const res = await this.client.get(`/session/token/${decoded.sessionId}`);
+              this.accessToken = res.data.accessToken;
+            } catch (refreshError) {
+              // If refresh fails, clear tokens
+              this.clearTokens();
+            }
+          }
+        }
+
+        // Add authorization header
+        req.headers.Authorization = `Bearer ${this.accessToken}`;
+      } catch (error) {
+        // If token is invalid, clear it
+        this.clearTokens();
+      }
+      return req;
+    });
+  }
+
+  /**
+   * Get the configured base URL
+   */
+  getBaseURL() {
+    return this.client.defaults.baseURL || '';
+  }
+
+  /**
+   * Set authentication tokens
+   */
+  setTokens(accessToken, refreshToken = '') {
+    this.accessToken = accessToken;
+    this.refreshToken = refreshToken;
+  }
+
+  /**
+   * Clear stored authentication tokens
+   */
+  clearTokens() {
+    this.accessToken = null;
+    this.refreshToken = null;
+  }
+
+  /**
+   * Get the current user ID from the access token
+   */
+  getCurrentUserId() {
+    if (!this.accessToken) {
+      return null;
+    }
+    try {
+      const decoded = (0, _jwtDecode.jwtDecode)(this.accessToken);
+      return decoded.userId || decoded.id || null;
+    } catch (error) {
+      return null;
+    }
+  }
+
+  /**
+   * Check if the client has a valid access token
+   */
+  hasAccessToken() {
+    return !!this.accessToken;
+  }
+
+  /**
+   * Validate the current access token with the server
+   */
+  async validate() {
+    if (!this.hasAccessToken()) {
+      return false;
+    }
+    try {
+      const res = await this.client.get('/auth/validate');
+      return res.data.valid === true;
+    } catch (error) {
+      return false;
+    }
+  }
+
+  /**
+   * Get the HTTP client instance (protected for use by service modules)
+   */
+  getClient() {
+    return this.client;
+  }
+
+  /**
+   * Centralized error handling
+   */
+  handleError(error) {
+    return (0, _errorUtils.handleHttpError)(error);
+  }
+
+  /**
+   * Health check endpoint
+   */
+  async healthCheck() {
+    try {
+      const res = await this.client.get('/health');
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+}
+exports.OxyServices = OxyServices;
+//# sourceMappingURL=OxyServices.js.map

package/lib/commonjs/core/OxyServices.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_axios","_interopRequireDefault","require","_jwtDecode","_errorUtils","e","__esModule","default","OxyServices","accessToken","refreshToken","constructor","config","client","axios","create","baseURL","timeout","setupInterceptors","interceptors","request","use","req","decoded","jwtDecode","currentTime","Math","floor","Date","now","exp","sessionId","res","get","data","refreshError","clearTokens","headers","Authorization","error","getBaseURL","defaults","setTokens","getCurrentUserId","userId","id","hasAccessToken","validate","valid","getClient","handleError","handleHttpError","healthCheck","exports"],"sourceRoot":"../../../src","sources":["core/OxyServices.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/core/OxyServicesMain.js

@@ -0,0 +1,51 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.OxyServicesMain = void 0;
+var _AuthService = require("./auth/AuthService");
+var _UserService = require("./users/UserService");
+var _PaymentService = require("./payments/PaymentService");
+var _KarmaService = require("./karma/KarmaService");
+var _FileService = require("./files/FileService");
+var _LocationService = require("./locations/LocationService");
+var _AnalyticsService = require("./analytics/AnalyticsService");
+var _DeviceService = require("./devices/DeviceService");
+/**
+ * Main OxyServices class that combines all individual services
+ * 
+ * This class provides a unified interface to all Oxy API services while maintaining
+ * backward compatibility with the original monolithic structure.
+ */
+class OxyServicesMain extends _AuthService.AuthService {
+  // Service instances
+
+  constructor(config) {
+    super(config);
+
+    // Initialize all service instances
+    this.users = new _UserService.UserService(config);
+    this.payments = new _PaymentService.PaymentService(config);
+    this.karma = new _KarmaService.KarmaService(config);
+    this.files = new _FileService.FileService(config);
+    this.locations = new _LocationService.LocationService(config);
+    this.analytics = new _AnalyticsService.AnalyticsService(config);
+    this.devices = new _DeviceService.DeviceService(config);
+  }
+
+  // Re-export OXY_CLOUD_URL for convenience
+  static OXY_CLOUD_URL = _FileService.OXY_CLOUD_URL;
+
+  // Additional utility methods that span multiple services
+  async fetchLinkMetadata(url) {
+    try {
+      const res = await this.getClient().get(`/link-metadata?url=${encodeURIComponent(url)}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+}
+exports.OxyServicesMain = OxyServicesMain;
+//# sourceMappingURL=OxyServicesMain.js.map

package/lib/commonjs/core/OxyServicesMain.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_AuthService","require","_UserService","_PaymentService","_KarmaService","_FileService","_LocationService","_AnalyticsService","_DeviceService","OxyServicesMain","AuthService","constructor","config","users","UserService","payments","PaymentService","karma","KarmaService","files","FileService","locations","LocationService","analytics","AnalyticsService","devices","DeviceService","OXY_CLOUD_URL","fetchLinkMetadata","url","res","getClient","get","encodeURIComponent","data","error","handleError","exports"],"sourceRoot":"../../../src","sources":["core/OxyServicesMain.ts"],"mappings":";;;;;;AACA,IAAAA,YAAA,GAAAC,OAAA;AACA,IAAAC,YAAA,GAAAD,OAAA;AACA,IAAAE,eAAA,GAAAF,OAAA;AACA,IAAAG,aAAA,GAAAH,OAAA;AACA,IAAAI,YAAA,GAAAJ,OAAA;AACA,IAAAK,gBAAA,GAAAL,OAAA;AACA,IAAAM,iBAAA,GAAAN,OAAA;AACA,IAAAO,cAAA,GAAAP,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMQ,eAAe,SAASC,wBAAW,CAAC;EAC/C;;EASAC,WAAWA,CAACC,MAAiB,EAAE;IAC7B,KAAK,CAACA,MAAM,CAAC;;IAEb;IACA,IAAI,CAACC,KAAK,GAAG,IAAIC,wBAAW,CAACF,MAAM,CAAC;IACpC,IAAI,CAACG,QAAQ,GAAG,IAAIC,8BAAc,CAACJ,MAAM,CAAC;IAC1C,IAAI,CAACK,KAAK,GAAG,IAAIC,0BAAY,CAACN,MAAM,CAAC;IACrC,IAAI,CAACO,KAAK,GAAG,IAAIC,wBAAW,CAACR,MAAM,CAAC;IACpC,IAAI,CAACS,SAAS,GAAG,IAAIC,gCAAe,CAACV,MAAM,CAAC;IAC5C,IAAI,CAACW,SAAS,GAAG,IAAIC,kCAAgB,CAACZ,MAAM,CAAC;IAC7C,IAAI,CAACa,OAAO,GAAG,IAAIC,4BAAa,CAACd,MAAM,CAAC;EAC1C;;EAEA;EACA,OAAgBe,aAAa,GAAGA,0BAAa;;EAE7C;EACA,MAAMC,iBAAiBA,CAACC,GAAW,EAKhC;IACD,IAAI;MACF,MAAMC,GAAG,GAAG,MAAM,IAAI,CAACC,SAAS,CAAC,CAAC,CAACC,GAAG,CAAC,sBAAsBC,kBAAkB,CAACJ,GAAG,CAAC,EAAE,CAAC;MACvF,OAAOC,GAAG,CAACI,IAAI;IACjB,CAAC,CAAC,OAAOC,KAAK,EAAE;MACd,MAAM,IAAI,CAACC,WAAW,CAACD,KAAK,CAAC;IAC/B;EACF;AACF;AAACE,OAAA,CAAA5B,eAAA,GAAAA,eAAA","ignoreList":[]}

package/lib/commonjs/core/analytics/AnalyticsService.js

@@ -0,0 +1,67 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AnalyticsService = void 0;
+var _OxyServices = require("../OxyServices");
+/**
+ * Analytics service for handling analytics and content viewer operations
+ */
+class AnalyticsService extends _OxyServices.OxyServices {
+  /**
+   * Get analytics data for user
+   */
+  async getAnalytics(userId, period) {
+    try {
+      const params = new URLSearchParams();
+      if (period) params.append('period', period);
+      const res = await this.getClient().get(`/analytics/users/${userId}?${params.toString()}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Update analytics data
+   */
+  async updateAnalytics(userId, type, data) {
+    try {
+      const res = await this.getClient().put(`/analytics/users/${userId}/${type}`, data);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get content viewers for user
+   */
+  async getContentViewers(userId, period) {
+    try {
+      const params = new URLSearchParams();
+      if (period) params.append('period', period);
+      const res = await this.getClient().get(`/analytics/users/${userId}/viewers?${params.toString()}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Get follower details for user
+   */
+  async getFollowerDetails(userId, period) {
+    try {
+      const params = new URLSearchParams();
+      if (period) params.append('period', period);
+      const res = await this.getClient().get(`/analytics/users/${userId}/followers?${params.toString()}`);
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+}
+exports.AnalyticsService = AnalyticsService;
+//# sourceMappingURL=AnalyticsService.js.map

package/lib/commonjs/core/analytics/AnalyticsService.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_OxyServices","require","AnalyticsService","OxyServices","getAnalytics","userId","period","params","URLSearchParams","append","res","getClient","get","toString","data","error","handleError","updateAnalytics","type","put","getContentViewers","getFollowerDetails","exports"],"sourceRoot":"../../../../src","sources":["core/analytics/AnalyticsService.ts"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAGA;AACA;AACA;AACO,MAAMC,gBAAgB,SAASC,wBAAW,CAAC;EAChD;AACF;AACA;EACE,MAAMC,YAAYA,CAACC,MAAc,EAAEC,MAAe,EAA0B;IAC1E,IAAI;MACF,MAAMC,MAAM,GAAG,IAAIC,eAAe,CAAC,CAAC;MACpC,IAAIF,MAAM,EAAEC,MAAM,CAACE,MAAM,CAAC,QAAQ,EAAEH,MAAM,CAAC;MAE3C,MAAMI,GAAG,GAAG,MAAM,IAAI,CAACC,SAAS,CAAC,CAAC,CAACC,GAAG,CAAC,oBAAoBP,MAAM,IAAIE,MAAM,CAACM,QAAQ,CAAC,CAAC,EAAE,CAAC;MACzF,OAAOH,GAAG,CAACI,IAAI;IACjB,CAAC,CAAC,OAAOC,KAAK,EAAE;MACd,MAAM,IAAI,CAACC,WAAW,CAACD,KAAK,CAAC;IAC/B;EACF;;EAEA;AACF;AACA;EACE,MAAME,eAAeA,CAACZ,MAAc,EAAEa,IAAY,EAAEJ,IAAyB,EAAgC;IAC3G,IAAI;MACF,MAAMJ,GAAG,GAAG,MAAM,IAAI,CAACC,SAAS,CAAC,CAAC,CAACQ,GAAG,CAAC,oBAAoBd,MAAM,IAAIa,IAAI,EAAE,EAAEJ,IAAI,CAAC;MAClF,OAAOJ,GAAG,CAACI,IAAI;IACjB,CAAC,CAAC,OAAOC,KAAK,EAAE;MACd,MAAM,IAAI,CAACC,WAAW,CAACD,KAAK,CAAC;IAC/B;EACF;;EAEA;AACF;AACA;EACE,MAAMK,iBAAiBA,CAACf,MAAc,EAAEC,MAAe,EAA4B;IACjF,IAAI;MACF,MAAMC,MAAM,GAAG,IAAIC,eAAe,CAAC,CAAC;MACpC,IAAIF,MAAM,EAAEC,MAAM,CAACE,MAAM,CAAC,QAAQ,EAAEH,MAAM,CAAC;MAE3C,MAAMI,GAAG,GAAG,MAAM,IAAI,CAACC,SAAS,CAAC,CAAC,CAACC,GAAG,CAAC,oBAAoBP,MAAM,YAAYE,MAAM,CAACM,QAAQ,CAAC,CAAC,EAAE,CAAC;MACjG,OAAOH,GAAG,CAACI,IAAI;IACjB,CAAC,CAAC,OAAOC,KAAK,EAAE;MACd,MAAM,IAAI,CAACC,WAAW,CAACD,KAAK,CAAC;IAC/B;EACF;;EAEA;AACF;AACA;EACE,MAAMM,kBAAkBA,CAAChB,MAAc,EAAEC,MAAe,EAA4B;IAClF,IAAI;MACF,MAAMC,MAAM,GAAG,IAAIC,eAAe,CAAC,CAAC;MACpC,IAAIF,MAAM,EAAEC,MAAM,CAACE,MAAM,CAAC,QAAQ,EAAEH,MAAM,CAAC;MAE3C,MAAMI,GAAG,GAAG,MAAM,IAAI,CAACC,SAAS,CAAC,CAAC,CAACC,GAAG,CAAC,oBAAoBP,MAAM,cAAcE,MAAM,CAACM,QAAQ,CAAC,CAAC,EAAE,CAAC;MACnG,OAAOH,GAAG,CAACI,IAAI;IACjB,CAAC,CAAC,OAAOC,KAAK,EAAE;MACd,MAAM,IAAI,CAACC,WAAW,CAACD,KAAK,CAAC;IAC/B;EACF;AACF;AAACO,OAAA,CAAApB,gBAAA,GAAAA,gBAAA","ignoreList":[]}