@oxyhq/services 5.13.1 → 5.13.2

package/README.md

@@ -15,6 +15,7 @@ A comprehensive TypeScript client library for the Oxy API providing authenticati
 - [Configuration](#configuration)
 - [Authentication](#authentication)
 - [UI Components](#ui-components)
+- [Internationalization (i18n)](#internationalization-i18n)
 - [Troubleshooting](#troubleshooting)
 - [Requirements](#requirements)
 
@@ -569,6 +570,76 @@ function MyComponent() {
 }
 ```
 
+## 🌍 Internationalization (i18n)
+
+OxyHQ Services includes built-in language selection and storage. The selected language can be accessed and synced with your app's i18n system.
+
+### Getting Current Language
+
+```typescript
+import { useOxy } from '@oxyhq/services';
+
+function MyComponent() {
+  const { 
+    currentLanguage,           // 'en-US'
+    currentLanguageName,       // 'English'
+    currentNativeLanguageName, // 'Español' (if Spanish is selected)
+    currentLanguageMetadata    // Full metadata object
+  } = useOxy();
+  
+  return <Text>Current language: {currentLanguageName}</Text>;
+}
+```
+
+### Syncing with Your i18n Library
+
+To integrate with react-i18next, i18n-js, next-intl, or other i18n libraries, see the comprehensive guide:
+
+📖 **[Complete i18n Integration Guide](./I18N_INTEGRATION.md)**
+
+This guide includes:
+- Step-by-step integration with popular i18n libraries
+- Bidirectional sync between services and your i18n system
+- Language code format conversion utilities
+- Complete working examples
+
+### Using OxyServices (Non-React)
+
+```typescript
+import { OxyServices } from '@oxyhq/services/core';
+
+const oxy = new OxyServices({ baseURL: 'https://api.oxy.so' });
+
+// Get current language code
+const languageCode = await oxy.getCurrentLanguage();
+
+// Get language name
+const languageName = await oxy.getCurrentLanguageName();
+
+// Get full metadata
+const metadata = await oxy.getCurrentLanguageMetadata();
+```
+
+### Language Utilities
+
+```typescript
+import { 
+  SUPPORTED_LANGUAGES,
+  getLanguageName,
+  getLanguageMetadata 
+} from '@oxyhq/services';
+
+// Get all supported languages
+const languages = SUPPORTED_LANGUAGES;
+
+// Get language name from code
+const name = getLanguageName('es-ES'); // 'Spanish'
+
+// Get full metadata
+const metadata = getLanguageMetadata('es-ES');
+// { id: 'es-ES', name: 'Spanish', nativeName: 'Español', flag: '🇪🇸', ... }
+```
+
 ## 🛠️ Troubleshooting
 
 ### Common Issues

package/lib/commonjs/core/HttpClient.js

@@ -0,0 +1,238 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.HttpClient = void 0;
+var _axios = _interopRequireDefault(require("axios"));
+var _jwtDecode = require("jwt-decode");
+var _errorUtils = require("../utils/errorUtils");
+var _requestUtils = require("../utils/requestUtils");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * HTTP Client Service
+ * 
+ * Handles all HTTP communication with authentication, interceptors, and error handling.
+ * This is the single source of truth for making authenticated HTTP requests.
+ */
+
+/**
+ * Token store for authentication
+ */
+class TokenStore {
+  accessToken = null;
+  refreshToken = null;
+  constructor() {}
+  static getInstance() {
+    if (!TokenStore.instance) {
+      TokenStore.instance = new TokenStore();
+    }
+    return TokenStore.instance;
+  }
+  setTokens(accessToken, refreshToken = '') {
+    this.accessToken = accessToken;
+    this.refreshToken = refreshToken;
+  }
+  getAccessToken() {
+    return this.accessToken;
+  }
+  getRefreshToken() {
+    return this.refreshToken;
+  }
+  clearTokens() {
+    this.accessToken = null;
+    this.refreshToken = null;
+  }
+  hasAccessToken() {
+    return !!this.accessToken;
+  }
+}
+
+/**
+ * HTTP Client Service
+ * 
+ * Manages Axios instance with authentication interceptors.
+ * All HTTP requests should go through this service to ensure authentication.
+ */
+class HttpClient {
+  constructor(config) {
+    this.baseURL = config.baseURL;
+    this.tokenStore = TokenStore.getInstance();
+    this.logger = new _requestUtils.SimpleLogger(config.enableLogging || false, config.logLevel || 'error', 'HttpClient');
+    const timeout = config.requestTimeout || 5000;
+
+    // Create Axios instance with optimized configuration
+    this.client = _axios.default.create({
+      baseURL: config.baseURL,
+      timeout,
+      headers: {
+        'Accept': 'application/json'
+      },
+      // Enable HTTP keep-alive for connection reuse (Node.js only)
+      ...(typeof process !== 'undefined' && process.env && typeof window === 'undefined' && typeof require !== 'undefined' ? {
+        httpAgent: new (require('http').Agent)({
+          keepAlive: true,
+          keepAliveMsecs: 1000,
+          maxSockets: 50
+        }),
+        httpsAgent: new (require('https').Agent)({
+          keepAlive: true,
+          keepAliveMsecs: 1000,
+          maxSockets: 50
+        })
+      } : {})
+    });
+    this.setupInterceptors();
+  }
+
+  /**
+   * Setup axios interceptors for authentication and error handling
+   */
+  setupInterceptors() {
+    // Request interceptor: Add authentication header
+    this.client.interceptors.request.use(async req => {
+      const accessToken = this.tokenStore.getAccessToken();
+      if (!accessToken) {
+        return req;
+      }
+      try {
+        const decoded = (0, _jwtDecode.jwtDecode)(accessToken);
+        const currentTime = Math.floor(Date.now() / 1000);
+
+        // If token expires in less than 60 seconds, refresh it
+        if (decoded.exp && decoded.exp - currentTime < 60) {
+          if (decoded.sessionId) {
+            try {
+              // Create a new axios instance to avoid interceptor recursion
+              const refreshClient = _axios.default.create({
+                baseURL: this.client.defaults.baseURL,
+                timeout: this.client.defaults.timeout
+              });
+              const res = await refreshClient.get(`/api/session/token/${decoded.sessionId}`);
+              this.tokenStore.setTokens(res.data.accessToken);
+              req.headers.Authorization = `Bearer ${res.data.accessToken}`;
+              this.logger.debug('Token refreshed');
+            } catch (refreshError) {
+              // If refresh fails, use current token anyway
+              req.headers.Authorization = `Bearer ${accessToken}`;
+              this.logger.warn('Token refresh failed, using current token');
+            }
+          } else {
+            req.headers.Authorization = `Bearer ${accessToken}`;
+          }
+        } else {
+          req.headers.Authorization = `Bearer ${accessToken}`;
+        }
+      } catch (error) {
+        this.logger.error('Error processing token:', error);
+        // Even if there's an error, still try to use the token
+        req.headers.Authorization = `Bearer ${accessToken}`;
+      }
+      return req;
+    }, error => {
+      this.logger.error('Request interceptor error:', error);
+      return Promise.reject(error);
+    });
+
+    // Response interceptor: Handle auth errors
+    this.client.interceptors.response.use(response => response, error => {
+      if (error.response?.status === 401) {
+        this.logger.warn('401 Unauthorized, clearing tokens');
+        this.tokenStore.clearTokens();
+      }
+      return Promise.reject(error);
+    });
+  }
+
+  /**
+   * Get the underlying Axios instance
+   * Use this only when you need direct access to Axios features
+   */
+  getAxiosInstance() {
+    return this.client;
+  }
+
+  /**
+   * Make a raw HTTP request (no caching, deduplication, etc.)
+   * Use this for requests that need to bypass performance features
+   */
+  async request(config) {
+    try {
+      const response = await this.client.request({
+        method: config.method,
+        url: config.url,
+        data: config.data,
+        params: config.params,
+        timeout: config.timeout,
+        signal: config.signal
+      });
+
+      // Unwrap standardized API response format: { data: ... }
+      // This handles responses from sendSuccess() and sendPaginated() helpers
+      const responseData = response.data;
+
+      // Handle paginated responses: { data: [...], pagination: {...} }
+      // Return the data array directly - the calling method will wrap it appropriately
+      if (responseData && typeof responseData === 'object' && 'data' in responseData && 'pagination' in responseData) {
+        // For paginated responses, return the data array directly
+        // The calling methods like getUserFollowers/getUserFollowing will handle wrapping
+        // We return the whole response so methods can access both data and pagination
+        return responseData;
+      }
+
+      // Handle regular success responses: { data: ... }
+      if (responseData && typeof responseData === 'object' && 'data' in responseData) {
+        return responseData.data;
+      }
+
+      // Return as-is for responses that don't use sendSuccess wrapper
+      return responseData;
+    } catch (error) {
+      throw (0, _errorUtils.handleHttpError)(error);
+    }
+  }
+
+  /**
+   * Get base URL
+   */
+  getBaseURL() {
+    return this.baseURL;
+  }
+
+  /**
+   * Set authentication tokens
+   */
+  setTokens(accessToken, refreshToken = '') {
+    this.tokenStore.setTokens(accessToken, refreshToken);
+  }
+
+  /**
+   * Clear authentication tokens
+   */
+  clearTokens() {
+    this.tokenStore.clearTokens();
+  }
+
+  /**
+   * Get access token
+   */
+  getAccessToken() {
+    return this.tokenStore.getAccessToken();
+  }
+
+  /**
+   * Check if has access token
+   */
+  hasAccessToken() {
+    return this.tokenStore.hasAccessToken();
+  }
+
+  // Test-only utility to reset global tokens between jest tests
+  static __resetTokensForTests() {
+    try {
+      TokenStore.getInstance().clearTokens();
+    } catch {}
+  }
+}
+exports.HttpClient = HttpClient;
+//# sourceMappingURL=HttpClient.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_axios","_interopRequireDefault","require","_jwtDecode","_errorUtils","_requestUtils","e","__esModule","default","TokenStore","accessToken","refreshToken","constructor","getInstance","instance","setTokens","getAccessToken","getRefreshToken","clearTokens","hasAccessToken","HttpClient","config","baseURL","tokenStore","logger","SimpleLogger","enableLogging","logLevel","timeout","requestTimeout","client","axios","create","headers","process","env","window","httpAgent","Agent","keepAlive","keepAliveMsecs","maxSockets","httpsAgent","setupInterceptors","interceptors","request","use","req","decoded","jwtDecode","currentTime","Math","floor","Date","now","exp","sessionId","refreshClient","defaults","res","get","data","Authorization","debug","refreshError","warn","error","Promise","reject","response","status","getAxiosInstance","method","url","params","signal","responseData","handleHttpError","getBaseURL","__resetTokensForTests","exports"],"sourceRoot":"../../../src","sources":["core/HttpClient.ts"],"mappings":"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","ignoreList":[]}