@bureau/device-intelligence

React Native SDK for Bureau Device Intelligence with sophisticated native module integration.

Installation

yarn add @bureau/device-intelligence

iOS Setup

cd ios && pod install

Android Setup

No additional setup required for Android.

Usage

import { BureauSDK, Environment } from '@bureau/device-intelligence';

// Initialize the SDK
BureauSDK.init({
  credentialId: 'your-credential-id',
  env: Environment.STAGING,
});

// Set user information
BureauSDK.setUserId('user-123');
BureauSDK.setMetaInfo({
  sessionId: 'session-456',
  flow: 'onboarding',
});

// Submit device intelligence data
const result = await BureauSDK.submit();
console.log('Device insights:', result.insights);

API Reference

Core Functions

• BureauSDK.init(config: BureauConfig): void - Initialize the SDK
• BureauSDK.submit(): Promise<SubmitResponse> - Submit device data
• BureauSDK.isInitialized(): Promise<boolean> - Check if SDK is initialized
• BureauSDK.getUserId(): Promise<string> - Get current user ID

Configuration Functions

• (Deprecated) Functions such as setUserId, setMetaInfo, setFlow, enableRiskMonitoring, and disableMonitoring have been removed from the public API.

Types

• BureauConfig - SDK configuration
• MetaInfo - Metadata information
• SubmitResponse - Response from device intelligence submission
• RiskMonitoringOptions - Risk monitoring configuration
• SuspiciousSignalCallback - Callback functions for suspicious signals
• Environment - SDK environment (PRODUCTION, STAGING)
• RiskMonitoringMode - Monitoring mode (CONTINUOUS, INSTANT)

Native Module Integration

iOS

The iOS native module provides:

• Device fingerprinting
• Jailbreak detection
• App store validation
• Frida detection
• Risk assessment

Android

The Android native module provides:

• Device fingerprinting
• Root detection
• ADB status monitoring
• App cloning detection
• Debugging detection
• Risk assessment

Permissions

The SDK requires the following permissions:

Android

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

iOS

No additional permissions required.

License

MIT