// When user logs in on any device
window.oppla.identify('user_123', {
  email: 'user@example.com',
  name: 'John Doe',
  plan: 'premium',
  // Device-specific attributes
  device: {
    type: getDeviceType(), // 'mobile', 'desktop', 'tablet'
    id: getDeviceId(),
    platform: navigator.platform
  }
});

// This automatically:
// 1. Links current session to user_123
// 2. Connects all past anonymous sessions
// 3. Enables cross-device tracking
// 4. Enriches with IP geolocation

// Anonymous session (before login)
window.oppla.track('product_viewed', {
  productId: 'prod_123',
  sessionId: 'anon_session_456' // Automatic
});

// User logs in
window.oppla.identify('user_123', {
  email: 'user@example.com'
});
// Previous anonymous events are now linked to user_123

// Continued tracking (after login)
window.oppla.track('product_purchased', {
  productId: 'prod_123',
  sessionId: 'auth_session_789' // Automatic
});

// Session Started (with enrichment)
{
  event: 'session_started',
  properties: {
    timestamp: '2024-03-20T10:00:00Z',
    sessionId: 'sess_abc123',
    userId: 'user_123', // If identified
    deviceId: 'device_456',
    referrer: 'https://google.com',
    userAgent: 'Mozilla/5.0...',
    // IP Geolocation (automatic)
    location: {
      ip: '192.168.1.1',
      country: 'United States',
      region: 'California',
      city: 'San Francisco',
      lat: 37.7749,
      lon: -122.4194
    },
    // Device context
    device: {
      type: 'mobile',
      os: 'iOS',
      browser: 'Safari',
      screenResolution: '390x844'
    },
    // Cross-device context
    crossDevice: {
      isReturning: true,
      lastDevice: 'desktop',
      totalDevices: 3
    }
  }
}

// Cross-Device Session Link
{
  event: 'session_linked',
  properties: {
    currentSession: 'sess_mobile_123',
    linkedSessions: ['sess_desktop_456', 'sess_tablet_789'],
    userId: 'user_123',
    linkMethod: 'authentication' // or 'fingerprint', 'email_link'
  }
}

// Session Handoff (device switch)
{
  event: 'session_handoff',
  properties: {
    fromDevice: 'mobile',
    toDevice: 'desktop',
    handoffMethod: 'qr_code', // or 'email_link', 'deep_link'
    continuityScore: 0.95 // Confidence in session continuity
  }
}

// React Native
import OPPLATracker from '@oppla/react-native';

OPPLATracker.initialize({
  productId: 'prod_mobile_app',
  enableCrossDevice: true
});

// Track with device context
OPPLATracker.track('app_opened', {
  deviceId: getDeviceId(),
  platform: Platform.OS,
  appVersion: getVersion()
});

// Link to web session
OPPLATracker.linkWebSession({
  webSessionId: 'sess_web_123',
  method: 'deep_link'
});

// Desktop web app
window.oppla.track('session_started', {
  device: 'desktop',
  screenResolution: `${screen.width}x${screen.height}`,
  // Check for mobile sessions
  checkCrossDevice: true
});

// Generate QR code for mobile continuation
const qrData = window.oppla.generateSessionHandoff({
  targetDevice: 'mobile',
  expiresIn: 300 // 5 minutes
});

// Save session for cross-device access
window.oppla.saveSessionForDevice({
  userId: 'user_123',
  sessionData: {
    cart: getCartItems(),
    preferences: getUserPreferences(),
    progress: getCurrentProgress()
  }
});

// Restore on another device
window.oppla.restoreSession({
  userId: 'user_123',
  merge: true // Merge with current session
});

// Track funnel step with device context
window.oppla.track('funnel_step', {
  funnel: 'purchase_flow',
  step: 2,
  stepName: 'add_to_cart',
  device: getCurrentDevice(),
  // Previous steps on other devices
  crossDeviceJourney: [
    { step: 1, device: 'mobile', timestamp: '2024-01-01T10:00:00Z' }
  ]
});

// Analyze cross-device conversion
const funnelAnalysis = await oppla.analyzeFunnel({
  funnel: 'purchase_flow',
  includeCrossDevice: true,
  attribution: 'last_touch' // or 'linear', 'time_decay'
});

// Track device switch
window.oppla.track('device_switched', {
  from: getPreviousDevice(),
  to: getCurrentDevice(),
  reason: 'user_initiated', // or 'session_timeout', 'app_switch'
  sessionContinuity: true,
  timeBetweenDevices: 120 // seconds
});

// Common patterns
window.oppla.track('device_pattern', {
  pattern: 'research_mobile_purchase_desktop',
  devices: ['mobile', 'desktop'],
  totalTime: 3600, // 1 hour
  conversions: 1
});

// Product A (Web App)
window.oppla.track('cross_product_session', {
  currentProduct: 'web_app',
  userId: 'user_123',
  sessionFlow: ['landing_page', 'signup', 'dashboard']
});

// Product B (Mobile App)
OPPLATracker.track('cross_product_session', {
  currentProduct: 'mobile_app',
  userId: 'user_123',
  previousProduct: 'web_app',
  continuationMethod: 'push_notification'
});

// Product C (API)
oppla.track('cross_product_session', {
  currentProduct: 'api',
  userId: 'user_123',
  apiClient: 'mobile_app',
  sessionChain: ['web_app', 'mobile_app', 'api']
});

// Real-time session feed
const activeSessions = await oppla.getActiveSessions({
  includeCrossDevice: true,
  groupByUser: true
});

// Returns
{
  "user_123": {
    "devices": ["mobile", "desktop"],
    "sessions": [
      {
        "device": "mobile",
        "started": "2024-01-01T10:00:00Z",
        "location": "San Francisco, CA",
        "active": true
      },
      {
        "device": "desktop",
        "started": "2024-01-01T10:05:00Z",
        "location": "San Francisco, CA",
        "active": true
      }
    ],
    "isMultiDevice": true
  }
}

// Identify users consistently across devices
const identifyUser = (userId, userData) => {
  // Always include email for cross-device matching
  window.oppla.identify(userId, {
    email: userData.email, // Key for cross-device
    ...userData,
    identifiedAt: new Date().toISOString(),
    identificationMethod: getIdentificationMethod()
  });
};

// Smooth device handoff
const initiateDeviceHandoff = async () => {
  const handoffToken = await window.oppla.createHandoffToken({
    currentSession: getSessionId(),
    expiresIn: 300,
    targetDevices: ['mobile', 'tablet']
  });
  
  // Display QR code or send email
  displayHandoffQR(handoffToken);
};

// Respect user privacy preferences
window.oppla.configure({
  crossDeviceTracking: getUserConsent('cross_device'),
  ipGeolocation: getUserConsent('location'),
  sessionRecording: getUserConsent('recording')
});

// Enable cross-device debug mode
localStorage.setItem('oppla.crossdevice.debug', 'true');

// Log all session events
window.oppla.onSessionEvent = (event) => {
  console.log('[Oppla Session]', event);
};