@mobana/react-native-sdk 0.2.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mobana
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,249 @@
+<p align="center">
+  <a href="https://mobana.ai" style="vertical-align: middle;">
+    <img alt="Mobana" src="https://mobana.ai/images/logos/mobana-transparent.png" height="32">
+  </a>
+  <br/>
+  <strong style="font-size: 1.3em">Mobana</strong>
+</p>
+
+<p align="center">
+  Simple, privacy-focused mobile app attribution, conversions, and remote flows for React Native.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@mobana/react-native-sdk"><img src="https://img.shields.io/npm/v/@mobana/react-native-sdk.svg?style=flat-square" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/@mobana/react-native-sdk"><img src="https://img.shields.io/npm/dm/@mobana/react-native-sdk.svg?style=flat-square" alt="npm downloads"></a>
+  <a href="https://github.com/mobana-hq/react-native-sdk/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/@mobana/react-native-sdk.svg?style=flat-square" alt="license"></a>
+  <img src="https://img.shields.io/badge/platform-iOS%20%7C%20Android-lightgrey?style=flat-square" alt="platforms">
+</p>
+
+<p align="center">
+  <a href="https://mobana.ai/docs">Documentation</a> ·
+  <a href="https://mobana.ai/docs/quick-start">Quick Start</a> ·
+  <a href="https://mobana.ai/docs/sdk/overview">SDK Reference</a> ·
+  <a href="https://mobana.ai/docs/flows/bridge-overview">Flow Bridge</a> ·
+  <a href="https://mobana.ai/docs/guides/gdpr">Privacy & GDPR</a>
+</p>
+
+---
+
+## Core Features
+
+- **[Attribution & Deeplinking](https://mobana.ai/attribution)** — Know where your installs come from and pass custom data (promo codes, referral IDs, content) through app store installs. No IDFA/GAID required.
+- **[Conversion Tracking](https://mobana.ai/conversion-tracking)** — Track post-install events and tie them back to campaigns for ROI measurement.
+- **[Flows](https://mobana.ai/flows)** — Display dynamic remote experiences (onboarding, permission prompts, paywalls) built from the Mobana dashboard — no app store updates required.
+
+## Requirements
+
+| Dependency | Minimum Version |
+|------------|-----------------|
+| React Native | `>= 0.72` |
+| React | `>= 17.0` |
+| Expo SDK | `50+` (Expo Go not supported) |
+| iOS | `13.4+` |
+| Android | API `23+` (Android 6.0) |
+
+## Table of Contents
+
+- [Installation](#installation)
+  - [Bare React Native](#bare-react-native)
+  - [Expo](#expo)
+  - [Optional Peer Dependencies](#optional-peer-dependencies)
+- [Quick Start](#quick-start)
+  - [Initialize the SDK](#1-initialize-the-sdk)
+  - [Get Attribution](#2-get-attribution)
+  - [Track Conversions](#3-track-conversions)
+  - [Show a Flow](#4-show-a-flow-optional)
+- [API](#api)
+- [Flows](#flows)
+- [Privacy & GDPR](#privacy--gdpr)
+- [Documentation](#documentation)
+- [License](#license)
+
+## Installation
+
+The SDK supports both **bare React Native** and **Expo**. Pick the section that matches your project setup — the SDK API is identical in both environments.
+
+### Bare React Native
+
+Attribution and conversion tracking:
+
+```bash
+npm install @mobana/react-native-sdk \
+  @react-native-async-storage/async-storage
+```
+
+Add [Flows](#flows) support (requires `react-native-webview`):
+
+```bash
+npm install @mobana/react-native-sdk \
+  @react-native-async-storage/async-storage \
+  react-native-webview
+```
+
+> If your flows use native permissions, you'll need to configure your iOS **Podfile** and Android **AndroidManifest.xml**. See the **[full installation guide](https://mobana.ai/docs/installation)** for platform-specific setup.
+
+### Expo
+
+Attribution and conversion tracking:
+
+```bash
+npx expo install @mobana/react-native-sdk \
+  @react-native-async-storage/async-storage
+```
+
+Add [Flows](#flows) support:
+
+```bash
+npx expo install @mobana/react-native-sdk \
+  @react-native-async-storage/async-storage \
+  react-native-webview
+```
+
+Add the plugin to your `app.json`:
+
+```json
+{
+  "expo": {
+    "plugins": ["@mobana/react-native-sdk"]
+  }
+}
+```
+
+> **Note:** This SDK uses native code — Expo Go is not supported. Use `expo-dev-client` for development builds.
+
+### Optional Peer Dependencies
+
+If your Flows use permissions, haptics, reviews, or location, install the relevant optional packages:
+
+```bash
+npm install react-native-permissions \
+  react-native-haptic-feedback \
+  react-native-in-app-review \
+  react-native-geolocation-service \
+  react-native-safe-area-context
+```
+
+> For iOS Podfile setup, Android manifest permissions, and Expo plugin configuration, see the **[full installation guide](https://mobana.ai/docs/installation)**.
+
+## Quick Start
+
+### 1. Initialize the SDK
+
+Call `init` once when your app starts. Get your App ID from the [Mobana dashboard](https://mobana.ai).
+
+```typescript
+import { Mobana } from '@mobana/react-native-sdk';
+
+await Mobana.init({
+  appId: 'YOUR_APP_ID',
+  debug: __DEV__,
+});
+```
+
+### 2. Get Attribution
+
+```typescript
+const attribution = await Mobana.getAttribution();
+
+if (attribution) {
+  console.log(attribution.utm_source);     // e.g. "facebook"
+  console.log(attribution.utm_campaign);   // e.g. "summer_sale"
+  console.log(attribution.confidence);     // 0.0–1.0
+
+  if (attribution.data?.promo) {
+    applyPromoCode(attribution.data.promo);
+  }
+}
+```
+
+`getAttribution()` never throws — it returns `null` when there's no match or on error.
+
+### 3. Track Conversions
+
+```typescript
+Mobana.trackConversion('signup');
+Mobana.trackConversion('purchase', 49.99);
+```
+
+### 4. Show a Flow (optional)
+
+Wrap your app with `MobanaProvider` and start flows by slug:
+
+```tsx
+import { MobanaProvider, Mobana } from '@mobana/react-native-sdk';
+
+function App() {
+  return (
+    <MobanaProvider>
+      <YourApp />
+    </MobanaProvider>
+  );
+}
+
+// Somewhere in your app
+const result = await Mobana.startFlow('onboarding');
+
+if (result.completed) {
+  console.log('User completed onboarding!', result.data);
+}
+```
+
+> For the full walkthrough, see the **[Quick Start guide](https://mobana.ai/docs/quick-start)**.
+
+## API
+
+| Method | Description | Reference |
+|--------|-------------|-----------|
+| `Mobana.init(config)` | Initialize the SDK with your App ID | [Docs →](https://mobana.ai/docs/sdk/init) |
+| `Mobana.getAttribution()` | Get install attribution and deeplink data | [Docs →](https://mobana.ai/docs/sdk/get-attribution) |
+| `Mobana.trackConversion(name, value?)` | Track post-install conversion events | [Docs →](https://mobana.ai/docs/sdk/track-conversion) |
+| `Mobana.startFlow(slug, options?)` | Display an in-app flow | [Docs →](https://mobana.ai/docs/sdk/start-flow) |
+| `Mobana.prefetchFlow(slug)` | Prefetch a flow for instant display | [Docs →](https://mobana.ai/docs/sdk/prefetch-flow) |
+| `Mobana.setEnabled(enabled)` | Enable/disable the SDK (GDPR consent) | [Docs →](https://mobana.ai/docs/sdk/set-enabled) |
+| `Mobana.reset()` | Clear stored data, generate new install ID | [Docs →](https://mobana.ai/docs/sdk/reset) |
+| `<MobanaProvider>` | Context provider for Flows (wraps your app) | [Docs →](https://mobana.ai/docs/sdk/provider) |
+
+> For full API reference with all options and return types, see the **[SDK Overview](https://mobana.ai/docs/sdk/overview)**.
+
+## Flows
+
+Flows are rich in-app experiences (onboarding, permission prompts, paywalls, announcements) you build visually in the Mobana dashboard. They run inside a WebView and communicate with your app through a JavaScript bridge.
+
+Inside a flow, you have access to attribution data, custom parameters, native permissions, haptics, sounds, and more — all through the `Mobana` bridge object.
+
+| Topic | Link |
+|-------|------|
+| What are Flows? | [mobana.ai/flows](https://mobana.ai/flows) |
+| Building Flows | [Guide →](https://mobana.ai/docs/guides/building-flows) |
+| Bridge Overview | [Docs →](https://mobana.ai/docs/flows/bridge-overview) |
+| Permissions | [Docs →](https://mobana.ai/docs/flows/bridge-permissions) |
+| Events & Tracking | [Guide →](https://mobana.ai/docs/guides/flow-events-tracking) |
+| CSS Variables | [Docs →](https://mobana.ai/docs/flows/css-variables) |
+
+## Privacy & GDPR
+
+Mobana is built with privacy at its core:
+
+- **No device IDs** — IDFA/GAID are never required or collected
+- **Privacy-first matching** — attribution works without invasive device fingerprinting
+- **Minimal data** — only what's needed for attribution, nothing more
+- **Opt-out support** — call `Mobana.setEnabled(false)` to disable all tracking
+- **GDPR/CCPA compliant** — see our [GDPR guide](https://mobana.ai/docs/guides/gdpr) and [Privacy Policy](https://mobana.ai/privacy)
+
+## Documentation
+
+| Resource | Link |
+|----------|------|
+| Full Documentation | [mobana.ai/docs](https://mobana.ai/docs) |
+| Installation Guide | [mobana.ai/docs/installation](https://mobana.ai/docs/installation) |
+| Quick Start | [mobana.ai/docs/quick-start](https://mobana.ai/docs/quick-start) |
+| SDK Reference | [mobana.ai/docs/sdk/overview](https://mobana.ai/docs/sdk/overview) |
+| Flow Bridge API | [mobana.ai/docs/flows/bridge-overview](https://mobana.ai/docs/flows/bridge-overview) |
+| Custom Endpoints | [mobana.ai/docs/guides/custom-endpoints](https://mobana.ai/docs/guides/custom-endpoints) |
+| GDPR & Privacy | [mobana.ai/docs/guides/gdpr](https://mobana.ai/docs/guides/gdpr) |
+| Test Setup | [mobana.ai/docs/test-setup](https://mobana.ai/docs/test-setup) |
+
+## License
+
+MIT — see [LICENSE](./LICENSE) for details.

package/android/build.gradle

@@ -0,0 +1,50 @@
+apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
+
+def safeExtGet(prop, fallback) {
+    rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+}
+
+android {
+    namespace 'ai.mobana.sdk'
+    compileSdkVersion safeExtGet('compileSdkVersion', 34)
+
+    defaultConfig {
+        minSdkVersion safeExtGet('minSdkVersion', 23)
+        targetSdkVersion safeExtGet('targetSdkVersion', 34)
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+
+    kotlinOptions {
+        jvmTarget = '17'
+    }
+
+    sourceSets {
+        main {
+            java.srcDirs = ['src/main/java']
+        }
+    }
+}
+
+repositories {
+    google()
+    mavenCentral()
+}
+
+dependencies {
+    implementation "com.facebook.react:react-native:+"
+    implementation "org.jetbrains.kotlin:kotlin-stdlib:${safeExtGet('kotlinVersion', '1.9.0')}"
+    
+    // Google Play Install Referrer API
+    implementation 'com.android.installreferrer:installreferrer:2.2'
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,6 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    
+    <!-- Install Referrer requires INTERNET permission -->
+    <uses-permission android:name="android.permission.INTERNET" />
+    
+</manifest>

package/android/src/main/java/ai/mobana/sdk/MobanaModule.kt

@@ -0,0 +1,67 @@
+package ai.mobana.sdk
+
+import com.android.installreferrer.api.InstallReferrerClient
+import com.android.installreferrer.api.InstallReferrerStateListener
+import com.facebook.react.bridge.*
+
+/**
+ * Native module for Mobana SDK
+ * Provides Android Install Referrer functionality
+ */
+class MobanaModule(reactContext: ReactApplicationContext) :
+    ReactContextBaseJavaModule(reactContext) {
+
+    override fun getName(): String = "Mobana"
+
+    /**
+     * Get the Install Referrer string from Google Play Store
+     * Returns the full referrer string which contains UTM params and dacid
+     */
+    @ReactMethod
+    fun getInstallReferrer(promise: Promise) {
+        val context = reactApplicationContext
+
+        try {
+            val referrerClient = InstallReferrerClient.newBuilder(context).build()
+
+            referrerClient.startConnection(object : InstallReferrerStateListener {
+                override fun onInstallReferrerSetupFinished(responseCode: Int) {
+                    when (responseCode) {
+                        InstallReferrerClient.InstallReferrerResponse.OK -> {
+                            try {
+                                val response = referrerClient.installReferrer
+                                val referrer = response.installReferrer
+                                referrerClient.endConnection()
+                                promise.resolve(referrer)
+                            } catch (e: Exception) {
+                                referrerClient.endConnection()
+                                promise.resolve(null)
+                            }
+                        }
+                        InstallReferrerClient.InstallReferrerResponse.FEATURE_NOT_SUPPORTED -> {
+                            // Install Referrer API not supported on this device
+                            referrerClient.endConnection()
+                            promise.resolve(null)
+                        }
+                        InstallReferrerClient.InstallReferrerResponse.SERVICE_UNAVAILABLE -> {
+                            // Connection could not be established
+                            referrerClient.endConnection()
+                            promise.resolve(null)
+                        }
+                        else -> {
+                            referrerClient.endConnection()
+                            promise.resolve(null)
+                        }
+                    }
+                }
+
+                override fun onInstallReferrerServiceDisconnected() {
+                    // Connection was lost, but promise may already be resolved
+                    // Do nothing - don't reject as this can happen after successful read
+                }
+            })
+        } catch (e: Exception) {
+            promise.resolve(null)
+        }
+    }
+}

package/android/src/main/java/ai/mobana/sdk/MobanaPackage.kt

@@ -0,0 +1,19 @@
+package ai.mobana.sdk
+
+import com.facebook.react.ReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.uimanager.ViewManager
+
+/**
+ * React Native package that registers the Mobana native module
+ */
+class MobanaPackage : ReactPackage {
+    override fun createNativeModules(reactContext: ReactApplicationContext): List<NativeModule> {
+        return listOf(MobanaModule(reactContext))
+    }
+
+    override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> {
+        return emptyList()
+    }
+}

package/app.plugin.js

@@ -0,0 +1,274 @@
+/**
+ * Expo Config Plugin for @mobana/react-native-sdk
+ * 
+ * This plugin automatically configures native dependencies for Expo projects.
+ * 
+ * Usage in app.json / app.config.js:
+ * {
+ *   "expo": {
+ *     "plugins": [
+ *       // Attribution-only (no special permissions needed):
+ *       "@mobana/react-native-sdk"
+ *       
+ *       // Or with Flows that need permissions:
+ *       ["@mobana/react-native-sdk", {
+ *         "permissions": ["Notifications", "AppTrackingTransparency"]
+ *       }]
+ *     ]
+ *   }
+ * }
+ * 
+ * Available permissions (opt-in, none enabled by default):
+ * - Notifications (for push notification prompts)
+ * - AppTrackingTransparency (for ATT prompts on iOS 14.5+)
+ * - LocationWhenInUse (for location-based flows)
+ * - LocationAlways (for background location flows)
+ */
+
+const { 
+  withProjectBuildGradle, 
+  withMainApplication,
+  withDangerousMod,
+  withInfoPlist,
+  withAndroidManifest,
+} = require('@expo/config-plugins');
+const fs = require('fs');
+const path = require('path');
+
+// No permissions enabled by default - users must explicitly opt-in
+// This prevents unexpected permission entries in Info.plist / AndroidManifest
+const DEFAULT_PERMISSIONS = [];
+
+/**
+ * Add Install Referrer dependency to Android build.gradle
+ */
+function withInstallReferrerDependency(config) {
+  return withProjectBuildGradle(config, (config) => {
+    if (config.modResults.language === 'groovy') {
+      const buildGradle = config.modResults.contents;
+      
+      // Check if already added
+      if (!buildGradle.includes('com.android.installreferrer:installreferrer')) {
+        // Add to allprojects dependencies
+        const allProjectsPattern = /allprojects\s*\{[\s\S]*?repositories\s*\{/;
+        
+        if (allProjectsPattern.test(buildGradle)) {
+          // Project has allprojects block, the dependency will be resolved
+          // through the library's own build.gradle
+        }
+      }
+    }
+    return config;
+  });
+}
+
+/**
+ * Add MobanaPackage to MainApplication.java
+ */
+function withMobanaPackage(config) {
+  return withMainApplication(config, (config) => {
+    const mainApplication = config.modResults.contents;
+    
+    // Check if already imported
+    if (!mainApplication.includes('ai.mobana.sdk.MobanaPackage')) {
+      // Add import
+      const importPattern = /^import.*$/m;
+      config.modResults.contents = mainApplication.replace(
+        importPattern,
+        (match) => `${match}\nimport ai.mobana.sdk.MobanaPackage;`
+      );
+      
+      // Add to getPackages
+      const packagesPattern = /new PackageList\(this\)\.getPackages\(\)/;
+      if (packagesPattern.test(config.modResults.contents)) {
+        // Using autolinking, package should be auto-registered
+        // No manual addition needed
+      }
+    }
+    
+    return config;
+  });
+}
+
+/**
+ * Add required Android permissions to AndroidManifest.xml
+ * This enables react-native-permissions to request these permissions at runtime
+ */
+function withAndroidPermissions(config, permissions) {
+  // Skip if no permissions configured
+  if (!permissions || permissions.length === 0) {
+    return config;
+  }
+  
+  return withAndroidManifest(config, (config) => {
+    const manifest = config.modResults.manifest;
+    
+    // Ensure uses-permission array exists
+    if (!manifest['uses-permission']) {
+      manifest['uses-permission'] = [];
+    }
+    
+    // Helper to add a permission if not already present
+    const addPermission = (permissionName) => {
+      const exists = manifest['uses-permission'].some(
+        (p) => p.$?.['android:name'] === permissionName
+      );
+      if (!exists) {
+        manifest['uses-permission'].push({
+          $: { 'android:name': permissionName },
+        });
+      }
+    };
+    
+    // Add POST_NOTIFICATIONS for Android 13+ (API 33+)
+    if (permissions.includes('Notifications')) {
+      addPermission('android.permission.POST_NOTIFICATIONS');
+    }
+    
+    // Add location permissions
+    if (permissions.includes('LocationWhenInUse') || permissions.includes('LocationAlways')) {
+      addPermission('android.permission.ACCESS_FINE_LOCATION');
+      addPermission('android.permission.ACCESS_COARSE_LOCATION');
+    }
+    
+    // Add background location permission
+    if (permissions.includes('LocationAlways')) {
+      addPermission('android.permission.ACCESS_BACKGROUND_LOCATION');
+    }
+    
+    return config;
+  });
+}
+
+/**
+ * Configure iOS Podfile for react-native-permissions
+ * This adds the setup_permissions call to enable the required permission pods
+ */
+function withReactNativePermissionsPodfile(config, permissions) {
+  // Skip if no permissions configured - don't inject setup_permissions at all
+  if (!permissions || permissions.length === 0) {
+    return config;
+  }
+  
+  return withDangerousMod(config, [
+    'ios',
+    async (config) => {
+      const podfilePath = path.join(config.modRequest.platformProjectRoot, 'Podfile');
+      
+      if (!fs.existsSync(podfilePath)) {
+        return config;
+      }
+      
+      let podfileContents = fs.readFileSync(podfilePath, 'utf-8');
+      
+      // Check if react-native-permissions setup is already configured
+      if (podfileContents.includes('react-native-permissions/scripts/setup')) {
+        return config;
+      }
+      
+      // Build the setup_permissions call
+      const permissionsArray = permissions.map(p => `    '${p}'`).join(',\n');
+      const setupBlock = `
+# react-native-permissions setup for Mobana SDK
+def node_require(script)
+  require Pod::Executable.execute_command('node', ['-p',
+    "require.resolve('\#{script}', {paths: [process.argv[1]]})",
+    __dir__]).strip
+end
+
+node_require('react-native-permissions/scripts/setup.rb')
+
+setup_permissions([
+${permissionsArray}
+])
+`;
+      
+      // Insert after the 'platform :ios' line or at the beginning of target block
+      const platformPattern = /^platform :ios.*$/m;
+      const targetPattern = /^target\s+['"].*['"]\s+do$/m;
+      
+      if (platformPattern.test(podfileContents)) {
+        podfileContents = podfileContents.replace(
+          platformPattern,
+          (match) => `${match}\n${setupBlock}`
+        );
+      } else if (targetPattern.test(podfileContents)) {
+        podfileContents = podfileContents.replace(
+          targetPattern,
+          (match) => `${setupBlock}\n${match}`
+        );
+      } else {
+        // Fallback: prepend to file
+        podfileContents = setupBlock + '\n' + podfileContents;
+      }
+      
+      fs.writeFileSync(podfilePath, podfileContents);
+      
+      return config;
+    },
+  ]);
+}
+
+/**
+ * Add required iOS Info.plist entries for permissions
+ */
+function withPermissionInfoPlist(config, permissions) {
+  // Skip if no permissions configured
+  if (!permissions || permissions.length === 0) {
+    return config;
+  }
+  
+  return withInfoPlist(config, (config) => {
+    // Add usage description strings for permissions that require them
+    if (permissions.includes('Notifications')) {
+      // Notifications don't require a usage description, but we can add a background mode
+    }
+    
+    if (permissions.includes('AppTrackingTransparency')) {
+      if (!config.modResults.NSUserTrackingUsageDescription) {
+        config.modResults.NSUserTrackingUsageDescription = 
+          'This identifier will be used to deliver personalized ads to you.';
+      }
+    }
+    
+    if (permissions.includes('LocationWhenInUse') || permissions.includes('LocationAlways')) {
+      if (!config.modResults.NSLocationWhenInUseUsageDescription) {
+        config.modResults.NSLocationWhenInUseUsageDescription = 
+          'This app needs access to your location.';
+      }
+    }
+    
+    if (permissions.includes('LocationAlways')) {
+      if (!config.modResults.NSLocationAlwaysAndWhenInUseUsageDescription) {
+        config.modResults.NSLocationAlwaysAndWhenInUseUsageDescription = 
+          'This app needs access to your location in the background.';
+      }
+    }
+    
+    return config;
+  });
+}
+
+/**
+ * Main plugin entry point
+ * @param {object} config - Expo config
+ * @param {object} props - Plugin props
+ * @param {string[]} props.permissions - Array of permissions to enable
+ */
+function withMobana(config, props = {}) {
+  const permissions = props.permissions || DEFAULT_PERMISSIONS;
+  
+  // Android configuration
+  config = withInstallReferrerDependency(config);
+  config = withAndroidPermissions(config, permissions);
+  // Note: For Expo SDK 50+, native modules are auto-linked
+  // withMobanaPackage is kept for older versions
+  
+  // iOS configuration for react-native-permissions
+  config = withReactNativePermissionsPodfile(config, permissions);
+  config = withPermissionInfoPlist(config, permissions);
+  
+  return config;
+}
+
+module.exports = withMobana;