Merge pull request #78 from frontegg/feature/open-admin-portal-bump-versions

Author: dianaKhortiuk-frontegg

FronteggRN.podspec

@@ -20,10 +20,10 @@ Pod::Spec.new do |s|
   # See https://github.com/facebook/react-native/blob/febf6b7f33fdb4904669f99d795eba4c0f95d7bf/scripts/cocoapods/new_architecture.rb#L79.
   if respond_to?(:install_modules_dependencies, true)
     install_modules_dependencies(s)
-    s.dependency "FronteggSwift", "1.2.76"
+    s.dependency "FronteggSwift", "1.3.10"
   else
     s.dependency "React-Core"
-    s.dependency "FronteggSwift", "1.2.76"
+    s.dependency "FronteggSwift", "1.3.10"
 
     # Don't install the dependencies when we run `pod install` in the old architecture.
     if ENV['RCT_NEW_ARCH_ENABLED'] == '1' then

android/build.gradle

@@ -80,7 +80,7 @@ dependencies {
   implementation "androidx.browser:browser:1.8.0"
   implementation 'io.reactivex.rxjava3:rxkotlin:3.0.1'
   implementation 'com.google.code.gson:gson:2.10.1'
-  implementation 'com.frontegg.sdk:android:1.3.18'
+  implementation 'com.frontegg.sdk:android:1.3.34'
 }
 
 if (isNewArchitectureEnabled()) {

android/src/main/java/com/frontegg/reactnative/FronteggRNModule.kt

@@ -10,6 +10,7 @@ import com.facebook.react.bridge.ReactMethod
 import com.facebook.react.bridge.WritableMap
 import com.facebook.react.common.LifecycleState
 import com.facebook.react.modules.core.DeviceEventManagerModule
+import com.frontegg.android.AdminPortalActivity
 import com.frontegg.android.fronteggAuth
 import io.reactivex.rxjava3.core.Observable
 import io.reactivex.rxjava3.disposables.Disposable
@@ -189,6 +190,18 @@ class FronteggRNModule(val reactContext: ReactApplicationContext) :
     }
   }
 
+  @ReactMethod
+  fun openAdminPortal(promise: Promise) {
+    val activity = currentActivity
+    if (activity == null) {
+      promise.reject("NO_ACTIVITY", "Cannot open Admin Portal without an active Activity")
+      return
+    }
+
+    AdminPortalActivity.open(activity)
+    promise.resolve(null)
+  }
+
   override fun getConstants(): MutableMap<String, Any?> = fronteggConstants.toMap()
 
   companion object {

docs/README.md

@@ -34,6 +34,28 @@ For full documentation, visit the Frontegg Developer Portal:
 
 ---
 
+## 🔐 Native SDK versions
+
+The React Native wrapper depends on the underlying native SDKs:
+
+- On **Android**, the plugin and example app use `com.frontegg.sdk:android:1.3.34`.
+- On **iOS**, the plugin depends on `FronteggSwift` **1.3.10** via CocoaPods.
+
+After upgrading, run `pod install` in your iOS project and rebuild both platforms.
+
+---
+
+## 🔐 Native SDK versions
+
+The React Native wrapper depends on the underlying native SDKs:
+
+- On **Android**, the plugin and example app use `com.frontegg.sdk:android:1.3.34`.
+- On **iOS**, the plugin depends on `FronteggSwift` **1.3.10** via CocoaPods.
+
+After upgrading, run `pod install` in your iOS project and rebuild both platforms.
+
+---
+
 ## 🧑‍💻 Getting Started with Frontegg
 
 Don't have a Frontegg account yet?

docs/_sidebar.md

@@ -3,3 +3,4 @@
 - [Setup Guide](setup.md)
 - [Usage Examples](usage.md)
 - [Advanced Topics](advanced.md)
+- [API Reference](api.md)

docs/advanced.md

@@ -53,7 +53,7 @@ Passkeys provide a seamless, passwordless login experience using WebAuthn and pl
 
 1. **iOS Version**:  Ensure your project targets iOS 15 or later to support the necessary WebAuthn APIs.
 2. **Android**: Use Android SDK 26+.
-3. **Frontegg SDK Version**: Use Frontegg iOS SDK version 1.2.24 or later.
+3. **Frontegg SDK Version**: Use Frontegg iOS SDK version 1.3.10 or later.
 
 #### Android setup
 
@@ -63,7 +63,7 @@ Passkeys provide a seamless, passwordless login experience using WebAuthn and pl
    ```groovy
       dependencies {
        implementation 'androidx.browser:browser:1.8.0'
-       implementation 'com.frontegg.sdk:android:1.2.30'
+       implementation 'com.frontegg.sdk:android:1.3.34'
    }
    ```
 
@@ -131,4 +131,35 @@ async function handleLoginWithPasskeys() {
     console.error('Error logging in with Passkeys:', error);
   }
 }
-```
+```
+
+## Admin Portal (Beta)
+
+The Admin Portal is a hosted page that lets end users manage their account, profile, sessions, and tenant settings. The React Native SDK exposes `openAdminPortal()` which delegates to the native SDKs:
+
+- **Android** — launches `AdminPortalActivity` (full-screen `WebView`)
+- **iOS** — presents `AdminPortalView` as a page sheet (`WKWebView`)
+
+The portal loads `${baseUrl}/oauth/portal?appId=<applicationId>` and shares the SDK session, so authenticated users are not asked to sign in again.
+
+> **Beta.** The API may change in future minor releases. Pin to an exact SDK version when embedding this in a shipping app.
+
+### Multi-app prerequisite
+
+For multi-app workspaces, configure `applicationId` in your native setup (see [Multi-app support](#multi-app-support)). Without `?appId=` the portal renders **"Application not found"** after sign-in.
+
+### Open the portal
+
+```tsx
+import { openAdminPortal } from '@frontegg/react-native';
+
+async function handleOpenAdminPortal() {
+  try {
+    await openAdminPortal();
+  } catch (error) {
+    console.error('Failed to open Admin Portal:', error);
+  }
+}
+```
+
+The portal is dismissed when the user swipes down (iOS) or taps the built-in close button. On Android, `window.close()` finishes the activity automatically.

example/android/app/build.gradle

@@ -125,7 +125,7 @@ android {
 dependencies {
     // The version of react-native is set by the React Native Gradle Plugin
     implementation("com.facebook.react:react-android")
-    implementation 'com.frontegg.sdk:android:1.3.18'
+    implementation 'com.frontegg.sdk:android:1.3.34'
     debugImplementation("com.facebook.flipper:flipper:${FLIPPER_VERSION}")
     debugImplementation("com.facebook.flipper:flipper-network-plugin:${FLIPPER_VERSION}") {
         exclude group:'com.squareup.okhttp3', module:'okhttp'

example/src/HomeScreen.tsx

@@ -12,6 +12,7 @@ import {
   registerPasskeys,
   loginWithPasskeys,
   requestAuthorize,
+  openAdminPortal,
 } from '@frontegg/react-native';
 import { useState } from 'react';
 import type { ITenantsResponse } from '@frontegg/rest-api';
@@ -79,6 +80,23 @@ export default function HomeScreen() {
           />
         </View>
 
+        {state.isAuthenticated ? (
+          <View style={styles.listenerButton}>
+            <FronteggButton
+              variant="primary"
+              title="Open Admin Portal"
+              accessibilityLabel="OpenAdminPortalButton"
+              onPress={async () => {
+                try {
+                  await openAdminPortal();
+                } catch (error) {
+                  console.error('Failed to open Admin Portal:', error);
+                }
+              }}
+            />
+          </View>
+        ) : null}
+
         {state.isAuthenticated ? (
           <View style={styles.listenerButton}>
             <FronteggButton

example/src/components/FronteggButton.tsx

@@ -11,6 +11,7 @@ export type FronteggButtonProps = {
   variant?: ButtonVariant;
   style?: StyleProp<ViewStyle>;
   textStyle?: StyleProp<TextStyle>;
+  accessibilityLabel?: string;
 };
 
 const COLORS = {
@@ -29,6 +30,7 @@ export default function FronteggButton({
   variant = 'primary',
   style,
   textStyle,
+  accessibilityLabel,
 }: FronteggButtonProps) {
   const isOutline = variant === 'outline';
   const isDanger = variant === 'danger';
@@ -56,6 +58,7 @@ export default function FronteggButton({
   return (
     <Pressable
       accessibilityRole="button"
+      accessibilityLabel={accessibilityLabel}
       disabled={disabled}
       onPress={onPress}
       style={({ pressed }) => [

ios/FronteggRN.m

@@ -44,4 +44,8 @@ @interface RCT_EXTERN_MODULE(FronteggRN, RCTEventEmitter)
                   resolver: (RCTPromiseResolveBlock)resolve
                   rejecter: (RCTPromiseRejectBlock)reject
                   )
+RCT_EXTERN_METHOD(
+                  openAdminPortal: (RCTPromiseResolveBlock)resolve
+                  rejecter: (RCTPromiseRejectBlock)reject
+                  )
 @end