@oxyhq/services 5.16.44 → 5.17.0

package/lib/commonjs/core/identity-session/DeviceManager.js

@@ -1,237 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.DeviceManager = void 0;
-var _errors = require("./errors");
-/**
- * Device Manager
- * 
- * Manages device identification and device sessions (Native + Web)
- */
-
-const DEVICE_STORAGE_KEY = 'oxy_device_info';
-/**
- * Device Manager Class
- */
-class DeviceManager {
-  cachedDevice = null;
-  constructor(adapter) {
-    this.adapter = adapter;
-  }
-
-  /**
-   * Invalidate cached device
-   */
-  invalidateCache() {
-    this.cachedDevice = null;
-  }
-
-  /**
-   * Get device fingerprint
-   */
-  getDeviceFingerprint() {
-    const fingerprint = {
-      userAgent: typeof navigator !== 'undefined' ? navigator.userAgent : 'unknown',
-      platform: typeof navigator !== 'undefined' ? navigator.platform : 'unknown',
-      language: typeof navigator !== 'undefined' ? navigator.language : undefined,
-      timezone: typeof Intl !== 'undefined' ? Intl.DateTimeFormat().resolvedOptions().timeZone : undefined
-    };
-
-    // Add screen info if available
-    if (typeof screen !== 'undefined') {
-      fingerprint.screen = {
-        width: screen.width,
-        height: screen.height,
-        colorDepth: screen.colorDepth
-      };
-    }
-    return fingerprint;
-  }
-
-  /**
-   * Generate a unique device ID
-   */
-  async generateDeviceId() {
-    const randomBytes = await this.adapter.crypto.getRandomBytes(32);
-    return Array.from(randomBytes, byte => byte.toString(16).padStart(2, '0')).join('');
-  }
-
-  /**
-   * Get a user-friendly device name based on platform
-   */
-  getDefaultDeviceName() {
-    const fingerprint = this.getDeviceFingerprint();
-    const platform = (fingerprint.platform || '').toLowerCase();
-    const userAgent = (fingerprint.userAgent || '').toLowerCase();
-    if (platform.includes('win')) return 'Windows Computer';
-    if (platform.includes('mac')) return 'Mac Computer';
-    if (platform.includes('linux')) return 'Linux Computer';
-    if (userAgent.includes('iphone')) return 'iPhone';
-    if (userAgent.includes('ipad')) return 'iPad';
-    if (userAgent.includes('android')) return 'Android Device';
-    if (this.adapter.platform === 'web') return 'Web Browser';
-    return 'Unknown Device';
-  }
-
-  /**
-   * Get stored device info or create new one
-   */
-  async getCurrentDevice() {
-    if (this.cachedDevice) {
-      return this.cachedDevice;
-    }
-    try {
-      const stored = await this.adapter.storage.get(DEVICE_STORAGE_KEY);
-      if (stored) {
-        const deviceInfo = JSON.parse(stored);
-
-        // Update last used timestamp
-        deviceInfo.lastUsed = new Date().toISOString();
-        await this.saveDeviceInfo(deviceInfo);
-        const device = {
-          deviceId: deviceInfo.deviceId,
-          deviceName: deviceInfo.deviceName,
-          deviceType: this.getDeviceType(),
-          platform: this.adapter.platform === 'native' ? 'ios' : 'web',
-          // Simplified
-          fingerprint: deviceInfo.fingerprint,
-          createdAt: deviceInfo.createdAt,
-          updatedAt: deviceInfo.lastUsed
-        };
-        this.cachedDevice = device;
-        return device;
-      }
-
-      // Create new device info
-      return await this.createNewDevice();
-    } catch (error) {
-      console.error('[DeviceManager] Error getting device info:', error);
-      return await this.createNewDevice();
-    }
-  }
-
-  /**
-   * Create new device info and store it
-   */
-  async createNewDevice() {
-    const deviceId = await this.generateDeviceId();
-    const fingerprint = JSON.stringify(this.getDeviceFingerprint());
-    const now = new Date().toISOString();
-    const device = {
-      deviceId,
-      deviceName: this.getDefaultDeviceName(),
-      deviceType: this.getDeviceType(),
-      platform: this.adapter.platform === 'native' ? 'ios' : 'web',
-      // Simplified
-      fingerprint,
-      createdAt: now,
-      updatedAt: now
-    };
-    const deviceInfo = {
-      deviceId,
-      deviceName: device.deviceName,
-      fingerprint,
-      createdAt: now,
-      lastUsed: now
-    };
-    await this.saveDeviceInfo(deviceInfo);
-    this.cachedDevice = device;
-    return device;
-  }
-
-  /**
-   * Get device type
-   */
-  getDeviceType() {
-    if (this.adapter.platform === 'web') {
-      return 'desktop'; // Simplified - could detect mobile web
-    }
-    // For native, would need Platform.OS detection
-    return 'mobile';
-  }
-
-  /**
-   * Save device info to storage
-   */
-  async saveDeviceInfo(deviceInfo) {
-    try {
-      await this.adapter.storage.set(DEVICE_STORAGE_KEY, JSON.stringify(deviceInfo));
-    } catch (error) {
-      console.error('[DeviceManager] Error saving device info:', error);
-      throw (0, _errors.createIdentitySessionError)(_errors.IdentitySessionErrorCodes.DEVICE_CREATION_FAILED, `Failed to save device info: ${error instanceof Error ? error.message : String(error)}`);
-    }
-  }
-
-  /**
-   * Update device name
-   */
-  async updateDeviceName(deviceName) {
-    const device = await this.getCurrentDevice();
-    if (!device) {
-      throw (0, _errors.createIdentitySessionError)(_errors.IdentitySessionErrorCodes.DEVICE_NOT_FOUND, 'Device not found');
-    }
-    device.deviceName = deviceName;
-    device.updatedAt = new Date().toISOString();
-    const deviceInfo = {
-      deviceId: device.deviceId,
-      deviceName: device.deviceName,
-      fingerprint: device.fingerprint,
-      createdAt: device.createdAt || new Date().toISOString(),
-      lastUsed: device.updatedAt
-    };
-    await this.saveDeviceInfo(deviceInfo);
-    this.cachedDevice = device;
-    return device;
-  }
-
-  /**
-   * Get device info for session creation
-   */
-  async getDeviceInfo() {
-    const device = await this.getCurrentDevice();
-    if (!device) {
-      throw (0, _errors.createIdentitySessionError)(_errors.IdentitySessionErrorCodes.DEVICE_NOT_FOUND, 'Device not found');
-    }
-    const fingerprint = this.getDeviceFingerprint();
-    return {
-      deviceName: device.deviceName,
-      deviceType: device.deviceType,
-      platform: device.platform,
-      browser: typeof navigator !== 'undefined' ? this.getBrowserName() : undefined,
-      os: typeof navigator !== 'undefined' ? navigator.platform : undefined,
-      lastActive: new Date().toISOString(),
-      userAgent: fingerprint.userAgent,
-      fingerprint: device.fingerprint
-    };
-  }
-
-  /**
-   * Get browser name from user agent
-   */
-  getBrowserName() {
-    if (typeof navigator === 'undefined') return undefined;
-    const ua = navigator.userAgent.toLowerCase();
-    if (ua.includes('chrome')) return 'Chrome';
-    if (ua.includes('firefox')) return 'Firefox';
-    if (ua.includes('safari') && !ua.includes('chrome')) return 'Safari';
-    if (ua.includes('edge')) return 'Edge';
-    if (ua.includes('opera')) return 'Opera';
-    return undefined;
-  }
-
-  /**
-   * Clear stored device info
-   */
-  async clearDeviceInfo() {
-    try {
-      await this.adapter.storage.remove(DEVICE_STORAGE_KEY);
-      this.invalidateCache();
-    } catch (error) {
-      console.error('[DeviceManager] Error clearing device info:', error);
-    }
-  }
-}
-exports.DeviceManager = DeviceManager;
-//# sourceMappingURL=DeviceManager.js.map

package/lib/commonjs/core/identity-session/DeviceManager.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["_errors","require","DEVICE_STORAGE_KEY","DeviceManager","cachedDevice","constructor","adapter","invalidateCache","getDeviceFingerprint","fingerprint","userAgent","navigator","platform","language","undefined","timezone","Intl","DateTimeFormat","resolvedOptions","timeZone","screen","width","height","colorDepth","generateDeviceId","randomBytes","crypto","getRandomBytes","Array","from","byte","toString","padStart","join","getDefaultDeviceName","toLowerCase","includes","getCurrentDevice","stored","storage","get","deviceInfo","JSON","parse","lastUsed","Date","toISOString","saveDeviceInfo","device","deviceId","deviceName","deviceType","getDeviceType","createdAt","updatedAt","createNewDevice","error","console","stringify","now","set","createIdentitySessionError","IdentitySessionErrorCodes","DEVICE_CREATION_FAILED","Error","message","String","updateDeviceName","DEVICE_NOT_FOUND","getDeviceInfo","browser","getBrowserName","os","lastActive","ua","clearDeviceInfo","remove","exports"],"sourceRoot":"../../../../src","sources":["core/identity-session/DeviceManager.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/core/identity-session/INTEGRATION_GUIDE.md

@@ -1,287 +0,0 @@
-# Identity Session Core - Integration Guide
-
-## Overview
-
-The Identity Session Core provides a unified API for identity and session management across all platforms (React Native, Web, Node). All identity and session operations go through this core - never access `KeyManager`, storage, or APIs directly.
-
-## Architecture
-
-```
-UI/Hooks Layer
-    ↓
-IdentitySessionCore (unified API)
-    ↓
-Managers (Identity, Session, Device, Refresh)
-    ↓
-Platform Adapters (Expo 54, Node)
-```
-
-## Key Principles
-
-1. **Frontend: Use `useOxy()` hook** - This is the only API you need for React/React Native applications
-2. **Backend: Use `createIdentitySessionCore()`** - Only for Node.js/backend applications
-3. **Never access storage, APIs, or KeyManager directly** - Always go through the core or `useOxy()`
-4. **Identity operations are NATIVE ONLY** - Web cannot create/import identities
-5. **Session operations work on NATIVE + WEB** - sessions can be used on both platforms
-6. **Models are aligned with backend** - same types, same error codes
-
-## Installation
-
-```bash
-npm install @oxyhq/services
-```
-
-## Basic Usage
-
-### Using the React Hook (Recommended)
-
-```typescript
-import { OxyProvider, useOxy } from '@oxyhq/services';
-import { Platform } from 'react-native';
-
-function App() {
-  return (
-    <OxyProvider baseURL="https://api.example.com">
-      <MyComponent />
-    </OxyProvider>
-  );
-}
-
-function MyComponent() {
-  const { createIdentity, signIn, hasIdentity, isLoading, error } = useOxy();
-
-  const handleCreateIdentity = async () => {
-    if (Platform.OS === 'web') {
-      alert('Identity creation is only available on native platforms');
-      return;
-    }
-
-    try {
-      const result = await createIdentity('myusername');
-      console.log('Identity created, synced:', result.synced);
-    } catch (err) {
-      console.error('Failed to create identity:', err);
-    }
-  };
-
-  const handleSignIn = async () => {
-    try {
-      const user = await signIn('My Device');
-      console.log('Signed in:', user);
-    } catch (err) {
-      console.error('Failed to sign in:', err);
-    }
-  };
-
-  if (error) return <Text>Error: {error}</Text>;
-  if (isLoading) return <Text>Loading...</Text>;
-
-  return (
-    <View>
-      <Button onPress={handleCreateIdentity} title="Create Identity" />
-      <Button onPress={handleSignIn} title="Sign In" />
-    </View>
-  );
-}
-```
-
-### Direct Core Usage (Backend/Node.js Only)
-
-**Note:** For frontend applications, always use `useOxy()` hook. Direct core usage is only for backend/Node.js applications.
-
-```typescript
-import { createIdentitySessionCore } from '@oxyhq/services';
-
-// Backend/Node.js only
-const core = await createIdentitySessionCore('https://api.example.com');
-const identity = await core.getCurrentIdentity();
-const session = await core.getSession();
-```
-
-## API Reference
-
-### Using `useOxy` Hook (Recommended)
-
-The `useOxy` hook provides all identity and session operations through a simple, reactive API:
-
-```typescript
-const {
-  // Identity (Native Only)
-  createIdentity,
-  importIdentity,
-  deleteIdentityAndClearAccount,
-  hasIdentity,
-  getPublicKey,
-  isIdentitySynced,
-  syncIdentity,
-  identity,
-  publicKey,
-  identitySyncState,
-
-  // Session (Native + Web)
-  signIn,
-  logout,
-  logoutAll,
-  switchSession,
-  refreshSession,
-  session,
-  sessions,
-  activeSessionId,
-  isAuthenticated,
-
-  // Device (Native + Web)
-  getDeviceSessions,
-  logoutAllDeviceSessions,
-  updateDeviceName,
-  device,
-
-  // State
-  user,
-  isLoading,
-  isTokenReady,
-  isStorageReady,
-  error,
-} = useOxy();
-```
-
-### Identity Operations (Native Only)
-
-```typescript
-// Create new identity
-const result = await createIdentity(username?);
-// result.synced indicates if identity was synced with backend
-
-// Import identity from backup
-const result = await importIdentity(backupData, password, username?);
-// result.synced indicates if identity was synced with backend
-
-// Delete identity and clear all account data
-await deleteIdentityAndClearAccount(skipBackup?, force?, userConfirmed?);
-
-// Check if identity exists
-const has = await hasIdentity();
-
-// Get public key
-const publicKey = await getPublicKey();
-
-// Check if identity is synced
-const synced = await isIdentitySynced();
-
-// Manually sync identity
-const user = await syncIdentity(username?);
-```
-
-### Session Operations (Native + Web)
-
-```typescript
-// Sign in (create session)
-const user = await signIn(deviceName?);
-
-// Logout (invalidate current or specific session)
-await logout(sessionId?);
-
-// Logout all sessions
-await logoutAll();
-
-// Switch to different session
-await switchSession(sessionId);
-
-// Refresh current session
-const session = await refreshSession();
-```
-
-### Device Operations (Native + Web)
-
-```typescript
-// Get all device sessions
-const deviceSessions = await getDeviceSessions();
-
-// Logout all sessions for current device
-await logoutAllDeviceSessions();
-
-// Update device name
-await updateDeviceName(deviceName);
-```
-
-### Direct Core Usage (Advanced)
-
-For advanced use cases, you can access the core directly:
-
-```typescript
-import { createIdentitySessionCore } from '@oxyhq/services';
-
-const core = await createIdentitySessionCore('https://api.example.com');
-const identity = await core.getCurrentIdentity();
-const session = await core.getSession();
-
-// Subscribe to events
-const unsubscribe = core.subscribe((event) => {
-  switch (event.type) {
-    case 'identity:created':
-      console.log('Identity created:', event.identity);
-      break;
-    case 'session:created':
-      console.log('Session created:', event.session);
-      break;
-    case 'session:invalidated':
-      console.log('Session invalidated:', event.sessionId);
-      break;
-  }
-});
-
-// Cleanup
-unsubscribe();
-```
-
-## Error Handling
-
-All errors use unified error codes:
-
-```typescript
-import { 
-  IdentitySessionError, 
-  IdentitySessionErrorCodes 
-} from '@oxyhq/services';
-
-try {
-  await createIdentity();
-} catch (error) {
-  if (error instanceof IdentitySessionError) {
-    switch (error.code) {
-      case IdentitySessionErrorCodes.IDENTITY_NOT_AVAILABLE_ON_WEB:
-        // Handle web platform error
-        break;
-      case IdentitySessionErrorCodes.IDENTITY_ALREADY_EXISTS:
-        // Handle already exists error
-        break;
-      default:
-        console.error('Error:', error.message);
-    }
-  }
-}
-```
-
-## Type Exports
-
-```typescript
-import type {
-  Identity,
-  Session,
-  Device,
-  DeviceInfo,
-  BackupData,
-  IdentitySessionEvent,
-} from '@oxyhq/services';
-```
-
-## Platform Detection
-
-The core automatically detects the platform and validates operations. Identity operations will throw `IDENTITY_NOT_AVAILABLE_ON_WEB` on web platforms.
-
-## Notes
-
-- The core handles all platform-specific logic internally
-- Storage, crypto, and fetch are abstracted through platform adapters
-- All models are aligned with backend (IUser, ISession)
-- Error codes are unified across frontend and backend
-- The core is designed to be "plugged in" to any Oxy app (Mention, Homiio, Noted, etc.)