// 1. Add via Xcode → File → Add Package Dependencies
//    URL: https://github.com/datasapien/ios-sdk
//    Requires Swift 5.7+ · iOS 15+

import DataSapienSDK

// 2. Configure once — typically in your App entry point
@main
struct MyApp: App {

    init() {
        DataSapien.configure(
            apiKey:      "YOUR_API_KEY",
            environment: .production
        )
    }

    var body: some Scene {
        WindowGroup { ContentView() }
    }
}

// 3. Track an event from anywhere in your app
DataSapien.track("purchase_completed", properties: [
    "product_id": "pro_annual",
    "value":      99.00
])

// 4. Identify a user after sign-in
DataSapien.identify(
    userId: "usr_abc123",
    traits: ["plan": "pro", "company": "Acme Corp"]
)

Swift · iOS 15+

// 1. Add to your app-level build.gradle:
// dependencies {
//     implementation("com.datasapien:android-sdk:2.1.0")
// }
// Requires Android API 24+ (Android 7.0)

import com.datasapien.DataSapien
import com.datasapien.DataSapienConfig

// 2. Configure in your Application class
class MyApp : Application() {

    override fun onCreate() {
        super.onCreate()
        DataSapien.configure(
            context = this,
            config  = DataSapienConfig(
                apiKey      = "YOUR_API_KEY",
                environment = DataSapien.Env.PRODUCTION
            )
        )
    }
}

// 3. Track an event from anywhere in your app
DataSapien.track("purchase_completed", mapOf(
    "product_id" to "pro_annual",
    "value"      to 99.00
))

// 4. Identify a user after sign-in
DataSapien.identify("usr_abc123", mapOf(
    "plan"    to "pro",
    "company" to "Acme Corp"
))

Kotlin · Android API 24+

// 1. Install the SDK
// npm install @datasapien/react-native-sdk
// npx pod-install   ← iOS only
// Requires React Native 0.70+

import DataSapien, { useDataSapien } from '@datasapien/react-native-sdk';

// 2. Configure once at app startup (e.g. index.js)
DataSapien.configure({
  apiKey:      'YOUR_API_KEY',
  environment: 'production',
});

// 3. Track an event from anywhere in your app
DataSapien.track('purchase_completed', {
  product_id: 'pro_annual',
  value:      99.00,
});

// 4. Identify a user after sign-in
DataSapien.identify('usr_abc123', {
  plan:    'pro',
  company: 'Acme Corp',
});

// 5. Use the hook inside a component
function CheckoutScreen() {
  const { track } = useDataSapien();

  const handlePurchase = () => {
    track('purchase_completed', { product_id: 'pro_annual' });
  };

  return <PurchaseButton onPress={handlePurchase} />;
}

JavaScript · React Native 0.70+

// 1. Add to pubspec.yaml:
// dependencies:
//   datasapien_sdk: ^2.1.0
// Then run: flutter pub get
// Requires Flutter 3.0+ · Dart 2.17+

import 'package:datasapien_sdk/datasapien_sdk.dart';

// 2. Configure before runApp()
Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await DataSapien.configure(
    apiKey:      'YOUR_API_KEY',
    environment: DataSapienEnvironment.production,
  );

  runApp(const MyApp());
}

// 3. Track an event from anywhere in your app
await DataSapien.track('purchase_completed', {
  'product_id': 'pro_annual',
  'value':      99.00,
});

// 4. Identify a user after sign-in
await DataSapien.identify('usr_abc123', {
  'plan':    'pro',
  'company': 'Acme Corp',
});

Dart · Flutter 3.0+