@oxyhq/services 5.11.12 → 5.12.0

package/package.json

@@ -1,29 +1,42 @@
 {
   "name": "@oxyhq/services",
-  "version": "5.11.12",
+  "version": "5.12.0",
   "description": "Reusable OxyHQ module to handle authentication, user management, karma system, device-based session management and more 🚀",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
   "types": "lib/typescript/index.d.ts",
   "react-native": "src/index.ts",
   "source": "src/index.ts",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
   "exports": {
     ".": {
+      "react-native": "./src/index.ts",
+      "node": {
+        "import": "./lib/module/core/index.js",
+        "require": "./lib/commonjs/core/index.js",
+        "types": "./lib/typescript/core/index.d.ts"
+      },
       "import": "./lib/module/index.js",
       "require": "./lib/commonjs/index.js",
       "types": "./lib/typescript/index.d.ts"
     },
     "./core": {
+      "react-native": "./src/core/index.ts",
       "import": "./lib/module/core/index.js",
       "require": "./lib/commonjs/core/index.js",
       "types": "./lib/typescript/core/index.d.ts"
     },
     "./ui": {
+      "react-native": "./src/ui/index.ts",
       "import": "./lib/module/ui/index.js",
       "require": "./lib/commonjs/ui/index.js",
       "types": "./lib/typescript/ui/index.d.ts"
     },
     "./full": {
+      "react-native": "./src/index.ts",
       "import": "./lib/module/index.js",
       "require": "./lib/commonjs/index.js",
       "types": "./lib/typescript/index.d.ts"
@@ -66,32 +79,25 @@
     "copy-dts": "copyfiles -u 1 \"src/**/*.d.ts\" lib/typescript",
     "delete-debug-view": "rm -rf ./lib/commonjs/components/bottomSheetDebugView ./lib/module/components/bottomSheetDebugView ./lib/typescript/components/bottomSheetDebugView || true",
     "delete-dts.js": "find ./lib/commonjs -name '*.d.js*' -delete && find ./lib/module -name '*.d.js*' -delete",
-    "release": "rm -rf lib && npm run build && release-it"
+    "release": "rm -rf lib && npm run build && release-it",
+    "prepublishOnly": "npm run typescript && npm test && npm run build"
   },
   "dependencies": {
+    "@amir-hossein-karimi/bottom-sheet": "^9.1.2",
+    "@gorhom/bottom-sheet": "^5.1.6",
     "@react-native-async-storage/async-storage": "2.1.2",
-    "@react-navigation/native": "^7.1.14",
+    "@tanstack/react-query": "^5.59.0",
     "@th3rdwave/react-navigation-bottom-sheet": "^0.3.2",
     "axios": "^1.9.0",
-    "expo": "^53.0.20",
-    "expo-font": "^13.3.1",
-    "expo-image": "~2.4.0",
-    "expo-linear-gradient": "^14.1.4",
     "invariant": "^2.2.4",
     "jwt-decode": "^4.0.0",
-    "react-native-iap": "^12.16.4",
     "react-native-qrcode-svg": "^6.3.0",
-    "react-native-safe-area-context": "^5.4.0",
     "react-native-url-polyfill": "^2.0.0",
     "socket.io-client": "^4.8.1",
     "sonner": "^2.0.4",
     "sonner-native": "^0.20.0",
-    "tailwindcss": "^4.1.11",
     "zod": "^3.25.64",
-    "zustand": "^5.0.6",
-    "@tanstack/react-query": "^5.59.0",
-    "@amir-hossein-karimi/bottom-sheet": "^9.1.2",
-    "@gorhom/bottom-sheet": "^5.1.6"
+    "zustand": "^5.0.6"
   },
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
@@ -108,13 +114,17 @@
     "@types/react": "~19.0.10",
     "@types/react-native": "~0.73.0",
     "copyfiles": "^2.4.1",
+    "expo-font": "^13.3.2",
+    "expo-image": "^2.4.0",
     "husky": "^4.3.8",
     "jest": "~29.7.0",
     "lint-staged": "^13.2.2",
     "metro-react-native-babel-preset": "^0.77.0",
     "react-native-builder-bob": "^0.30.3",
     "react-native-gesture-handler": "~2.24.0",
+    "react-native-iap": "^13.0.4",
     "react-native-reanimated": "~3.17.4",
+    "react-native-safe-area-context": "^5.6.1",
     "react-native-svg": "15.11.2",
     "react-test-renderer": "^18.3.1",
     "release-it": "^17.6.0",
@@ -123,14 +133,20 @@
   },
   "peerDependencies": {
     "@expo/vector-icons": "^14.1.0",
+    "@react-navigation/native": "^7.0.0",
     "@types/react": "*",
     "@types/react-native": "*",
     "axios": "^1.9.0",
+    "expo": "^53.0.0",
+    "expo-font": "^13.0.0",
+    "expo-image": "^2.4.0",
+    "expo-linear-gradient": "^14.0.0",
     "invariant": "^2.2.4",
     "jwt-decode": "^4.0.0",
     "react": ">=18.0.0",
     "react-native": ">=0.76.0",
     "react-native-gesture-handler": ">=2.16.1",
+    "react-native-iap": "^12.16.0",
     "react-native-reanimated": ">=3.16.0",
     "react-native-safe-area-context": "^5.4.0",
     "react-native-svg": ">=13.0.0"
@@ -147,6 +163,24 @@
     },
     "react-native-qrcode-svg": {
       "optional": true
+    },
+    "expo": {
+      "optional": true
+    },
+    "expo-font": {
+      "optional": true
+    },
+    "expo-image": {
+      "optional": true
+    },
+    "expo-linear-gradient": {
+      "optional": true
+    },
+    "@react-navigation/native": {
+      "optional": true
+    },
+    "react-native-iap": {
+      "optional": true
     }
   },
   "react-native-builder-bob": {
@@ -163,4 +197,4 @@
     "react-native-gesture-handler": "^2.20.2",
     "react-native-reanimated": "^3.16.1"
   }
-}
+}

package/src/core/OxyServices.ts

@@ -121,18 +121,10 @@ export class OxyAuthenticationTimeoutError extends OxyAuthenticationError {
  */
 // Centralized token store
 class TokenStore {
-  private static instance: TokenStore;
   private accessToken: string | null = null;
   private refreshToken: string | null = null;
 
-  private constructor() {}
-
-  static getInstance(): TokenStore {
-    if (!TokenStore.instance) {
-      TokenStore.instance = new TokenStore();
-    }
-    return TokenStore.instance;
-  }
+  constructor() {}
 
   setTokens(accessToken: string, refreshToken = ''): void {
     this.accessToken = accessToken;
@@ -177,9 +169,8 @@ export class OxyServices {
       baseURL: config.baseURL,
       timeout: 10000 // 10 second timeout
     });
-    this.cloudURL = config.cloudURL || 'https://cloud.oxyhq.com';
-    this.cloudURL = config.cloudURL || 'https://cloud.oxy.so';
-    this.tokenStore = TokenStore.getInstance();
+    this.cloudURL = config.cloudURL || OXY_CLOUD_URL;
+    this.tokenStore = new TokenStore();
     this.setupInterceptors();
   }
 
@@ -453,8 +444,13 @@ export class OxyServices {
   /**
    * Centralized error handling
    */
-  protected handleError(error: any): ApiError {
-    return handleHttpError(error);
+  protected handleError(error: any): Error {
+    const api = handleHttpError(error);
+    const err = new Error(api.message) as Error & { code?: string; status?: number; details?: Record<string, unknown> };
+    err.code = api.code;
+    err.status = api.status;
+    err.details = api.details as any;
+    return err;
   }
 
   /**
@@ -488,16 +484,90 @@ export class OxyServices {
         email,
         password
       });
+      if (!res || !res.data || (typeof res.data === 'object' && Object.keys(res.data).length === 0)) {
+        throw new OxyAuthenticationError('Sign up failed', 'SIGNUP_FAILED', 400);
+      }
       return res.data;
     } catch (error) {
       throw this.handleError(error);
     }
   }
 
+  /**
+   * Request account recovery (send verification code)
+   */
+  async requestRecovery(identifier: string): Promise<{ delivery?: string; destination?: string }> {
+    try {
+      const res = await this.client.post('/api/auth/recover/request', { identifier });
+      return res.data;
+    } catch (error: any) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Verify recovery code
+   */
+  async verifyRecoveryCode(identifier: string, code: string): Promise<{ verified: boolean }> {
+    try {
+      const res = await this.client.post('/api/auth/recover/verify', { identifier, code });
+      return res.data;
+    } catch (error: any) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Reset password using verified code
+   */
+  async resetPassword(identifier: string, code: string, newPassword: string): Promise<{ success: boolean }> {
+    try {
+      const res = await this.client.post('/api/auth/recover/reset', { identifier, code, newPassword });
+      return res.data;
+    } catch (error: any) {
+      throw this.handleError(error);
+    }
+  }
+
+  /**
+   * Reset password using TOTP code (recommended recovery)
+   */
+  async resetPasswordWithTotp(identifier: string, code: string, newPassword: string): Promise<{ success: boolean }> {
+    try {
+      const res = await this.client.post('/api/auth/recover/totp/reset', { identifier, code, newPassword });
+      return res.data;
+    } catch (error: any) {
+      throw this.handleError(error);
+    }
+  }
+
+  async resetPasswordWithBackupCode(identifier: string, backupCode: string, newPassword: string): Promise<{ success: boolean }> {
+    try {
+      const res = await this.client.post('/api/auth/recover/backup/reset', { identifier, backupCode, newPassword });
+      return res.data;
+    } catch (error: any) {
+      throw this.handleError(error);
+    }
+  }
+
+  async resetPasswordWithRecoveryKey(identifier: string, recoveryKey: string, newPassword: string): Promise<{ success: boolean; nextRecoveryKey?: string }> {
+    try {
+      const res = await this.client.post('/api/auth/recover/recovery-key/reset', { identifier, recoveryKey, newPassword });
+      return res.data;
+    } catch (error: any) {
+      throw this.handleError(error);
+    }
+  }
+
   /**
    * Sign in with device management
    */
-  async signIn(username: string, password: string, deviceName?: string, deviceFingerprint?: any): Promise<SessionLoginResponse> {
+  async signIn(
+    username: string,
+    password: string,
+    deviceName?: string,
+    deviceFingerprint?: any
+  ): Promise<SessionLoginResponse | { mfaRequired: true; mfaToken: string; expiresAt: string }> {
     try {
       const res = await this.client.post('/api/auth/login', {
         username,
@@ -511,6 +581,18 @@ export class OxyServices {
     }
   }
 
+  /**
+   * Complete login by verifying TOTP with MFA token
+   */
+  async verifyTotpLogin(mfaToken: string, code: string): Promise<SessionLoginResponse> {
+    try {
+      const res = await this.client.post('/api/auth/totp/verify-login', { mfaToken, code });
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
   /**
    * Get user by session ID
    */
@@ -657,6 +739,43 @@ export class OxyServices {
     }
   }
 
+  // ============================================================================
+  // TOTP ENROLLMENT
+  // ============================================================================
+
+  async startTotpEnrollment(sessionId: string): Promise<{ secret: string; otpauthUrl: string; issuer: string; label: string }> {
+    try {
+      const res = await this.client.post('/api/auth/totp/enroll/start', { sessionId }, {
+        headers: { 'x-session-id': sessionId }
+      });
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  async verifyTotpEnrollment(sessionId: string, code: string): Promise<{ enabled: boolean; backupCodes?: string[]; recoveryKey?: string }> {
+    try {
+      const res = await this.client.post('/api/auth/totp/enroll/verify', { sessionId, code }, {
+        headers: { 'x-session-id': sessionId }
+      });
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
+  async disableTotp(sessionId: string, code: string): Promise<{ disabled: boolean }> {
+    try {
+      const res = await this.client.post('/api/auth/totp/disable', { sessionId, code }, {
+        headers: { 'x-session-id': sessionId }
+      });
+      return res.data;
+    } catch (error) {
+      throw this.handleError(error);
+    }
+  }
+
   /**
    * Search user profiles
    */
@@ -1631,14 +1750,14 @@ export class OxyServices {
         
         next();
       } catch (error) {
-        const apiError = this.handleError(error);
+        const apiError = this.handleError(error) as any;
         
         if (debug) {
           console.log(`❌ Auth: Unexpected error:`, apiError);
         }
         
         if (onError) return onError(apiError);
-        return res.status(apiError.status || 500).json(apiError);
+        return res.status((apiError && apiError.status) || 500).json(apiError);
       }
     };
   }
@@ -1647,7 +1766,7 @@ export class OxyServices {
 /**
  * Export the default Oxy Cloud URL (for backward compatibility)
  */
-export const OXY_CLOUD_URL = 'https://cloud.oxy.so';
+export const OXY_CLOUD_URL = 'https://cloud.oxyhq.com';
 
 /**
  * Export the default Oxy API URL (for documentation)
@@ -1658,4 +1777,4 @@ export const OXY_API_URL = 'https://api.oxy.so';
  * Pre-configured client instance for easy import
  * Uses OXY_API_URL as baseURL and OXY_CLOUD_URL as cloudURL
  */
-export const oxyClient = new OxyServices({ baseURL: OXY_API_URL, cloudURL: OXY_CLOUD_URL });
+export const oxyClient = new OxyServices({ baseURL: OXY_API_URL, cloudURL: OXY_CLOUD_URL });

package/src/i18n/index.ts

@@ -0,0 +1,39 @@
+// Use JSON locale files (RN Metro supports static requires reliably)
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const enUS = require('./locales/en-US.json') as Record<string, any>;
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const esES = require('./locales/es-ES.json') as Record<string, any>;
+
+export type LocaleDict = Record<string, any>;
+
+const DICTS: Record<string, LocaleDict> = {
+  'en': enUS as LocaleDict,
+  'en-US': enUS as LocaleDict,
+  'es': esES as LocaleDict,
+  'es-ES': esES as LocaleDict,
+};
+
+const FALLBACK = 'en-US';
+
+function getNested(obj: any, path: string): any {
+  return path.split('.').reduce((acc, key) => (acc && acc[key] != null ? acc[key] : undefined), obj);
+}
+
+export function translate(locale: string | undefined, key: string, vars?: Record<string, string | number>): string {
+  const lang = locale && DICTS[locale] ? locale : FALLBACK;
+  const dict = DICTS[lang] || DICTS[FALLBACK];
+  let val = getNested(dict, key);
+  if (typeof val !== 'string') return key; // fallback to key if missing
+  if (vars) {
+    Object.keys(vars).forEach(k => {
+      const token = `{{${k}}}`;
+      val = val.replaceAll(token, String(vars[k]));
+    });
+  }
+  return val;
+}
+
+export function hasKey(locale: string | undefined, key: string): boolean {
+  const lang = locale && DICTS[locale] ? locale : FALLBACK;
+  return getNested(DICTS[lang], key) != null || getNested(DICTS[FALLBACK], key) != null;
+}