catalyst-core 0.1.0-canary.3 → 0.1.0-canary.4

package/changelog.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [0.1.0-canary.4] - 2026-02-12
+
+- Added Google Sign-In support for both Android and iOS in Catalyst, enabling a unified native authentication experience for apps built on the framework.
+- Improved release/build reliability with related bridge and CI updates, making integration smoother and more consistent across platforms.
+
+## [0.1.0-canary.3] - 2026-02-04
+
+- Android device security: added root, emulator, and Frida detection with launch-time checks and a Material Design 3 bottom sheet threat alert UI
+
 ## [0.1.0-canary.2] - 2026-01-28
 
 - Adds mono-repository support for catalyst

package/dist/native/androidProject/app/build.gradle.kts

@@ -171,8 +171,10 @@ dependencies {
     androidTestImplementation(libs.androidx.junit)
     androidTestImplementation(libs.androidx.espresso.core)
     implementation(libs.androidx.webkit)
+    implementation(libs.androidx.credentials)
+    implementation(libs.androidx.credentials.play.services.auth)
+    implementation(libs.googleid)
     implementation("org.json:json:20231013")
-
     // Ktor Server dependencies for FrameworkServer (~200KB total)
     implementation("io.ktor:ktor-server-core:3.0.3")
     implementation("io.ktor:ktor-server-netty:3.0.3")

package/dist/native/androidProject/app/src/main/java/io/yourname/androidproject/NativeBridge.kt

@@ -10,12 +10,19 @@ import android.webkit.WebView
 import androidx.activity.result.ActivityResultLauncher
 import androidx.activity.result.contract.ActivityResultContracts
 import androidx.core.app.NotificationCompat
+import androidx.credentials.CredentialManager
+import androidx.credentials.GetCredentialRequest
+import androidx.credentials.exceptions.GetCredentialCancellationException
+import androidx.credentials.exceptions.GetCredentialException
+import com.google.android.libraries.identity.googleid.GetSignInWithGoogleOption
+import com.google.android.libraries.identity.googleid.GoogleIdTokenCredential
 import io.yourname.androidproject.MainActivity
 import io.yourname.androidproject.utils.*
 import kotlinx.coroutines.*
 import org.json.JSONArray
 import org.json.JSONObject
 import java.util.Properties
+import java.util.concurrent.atomic.AtomicBoolean
 
 private data class FilePickerOptions(
     val mimeType: String = "*/*",
@@ -86,6 +93,38 @@ private fun JSONObject.optIntNullable(key: String): Int? =
 private fun JSONObject.optLongNullable(key: String): Long? =
     if (has(key) && !isNull(key)) getLong(key) else null
 
+private data class GoogleSignInOptions(
+    val clientId: String,
+    val nonce: String? = null,
+    val autoSelect: Boolean = false,
+    val filterByAuthorizedAccounts: Boolean = false
+) {
+    companion object {
+        fun fromRaw(raw: String?): GoogleSignInOptions {
+            if (raw.isNullOrBlank()) {
+                // Allow fallback to config-supplied clientId
+                return GoogleSignInOptions(clientId = "")
+            }
+
+            return try {
+                val json = JSONObject(raw)
+                val resolvedClientId = json.optString("clientId")
+                    .ifBlank { json.optString("webClientId") }
+
+                GoogleSignInOptions(
+                    clientId = resolvedClientId,
+                    nonce = json.optString("nonce").takeIf { it.isNotBlank() },
+                    autoSelect = json.optBoolean("autoSelect", false),
+                    filterByAuthorizedAccounts = json.optBoolean("filterByAuthorizedAccounts", false)
+                )
+            } catch (e: Exception) {
+                BridgeUtils.logDebug("NativeBridge", "Failed to parse options JSON: ${e.message}")
+                GoogleSignInOptions(clientId = raw.trim())
+            }
+        }
+    }
+}
+
 class NativeBridge(
     private val mainActivity: MainActivity,
     private val webView: WebView,
@@ -104,6 +143,12 @@ class NativeBridge(
     private lateinit var permissionLauncher: ActivityResultLauncher<String>
     private lateinit var filePickerLauncher: ActivityResultLauncher<Intent>
     private var currentFilePickerOptions: FilePickerOptions = FilePickerOptions()
+    private val isGoogleSignInInProgress = AtomicBoolean(false)
+    private val credentialManager: CredentialManager by lazy { CredentialManager.create(mainActivity) }
+    private val isGoogleSignInEnabled: Boolean by lazy {
+        properties.getProperty("googleSignIn.enabled", "false").toBoolean()
+    }
+    
     private var networkMonitor: NetworkMonitor? = null
 
     // Unified notification manager
@@ -111,6 +156,7 @@ class NativeBridge(
 
     companion object {
         private const val TAG = "NativeBridge"
+        private const val GOOGLE_SIGN_IN_SAFE_EXECUTE_ACTION = "start Google Sign-In"
 
         /**
          * Parse and validate bridge message
@@ -237,6 +283,55 @@ class NativeBridge(
         }
     }
 
+    @JavascriptInterface
+    fun googleSignIn(optionsRaw: String?) {
+        BridgeUtils.safeExecute(
+            webView,
+            BridgeUtils.WebEvents.ON_GOOGLE_SIGN_IN_ERROR,
+            GOOGLE_SIGN_IN_SAFE_EXECUTE_ACTION
+        ) {
+            if (!isGoogleSignInEnabled) {
+                BridgeUtils.notifyWebError(
+                    webView,
+                    BridgeUtils.WebEvents.ON_GOOGLE_SIGN_IN_ERROR,
+                    "Google Sign-In is disabled in config"
+                )
+                return@safeExecute
+            }
+
+            val options = GoogleSignInOptions.fromRaw(optionsRaw)
+
+            val resolvedClientId = when {
+                options.clientId.isNotBlank() -> options.clientId
+                !properties.getProperty("googleSignIn.clientId", "").isNullOrBlank() ->
+                    properties.getProperty("googleSignIn.clientId", "")
+                else -> ""
+            }
+
+            if (resolvedClientId.isBlank()) {
+                BridgeUtils.notifyWebError(
+                    webView,
+                    BridgeUtils.WebEvents.ON_GOOGLE_SIGN_IN_ERROR,
+                    "clientId is required for Google Sign-In"
+                )
+                return@safeExecute
+            }
+
+            if (!isGoogleSignInInProgress.compareAndSet(false, true)) {
+                BridgeUtils.notifyWebError(
+                    webView,
+                    BridgeUtils.WebEvents.ON_GOOGLE_SIGN_IN_ERROR,
+                    "A Google Sign-In request is already in progress"
+                )
+                return@safeExecute
+            }
+
+            BridgeUtils.logDebug(TAG, "Google Sign-In using clientId prefix: ${resolvedClientId.take(12)}...")
+
+            launchGoogleSignIn(options.copy(clientId = resolvedClientId))
+        }
+    }
+
     @JavascriptInterface
     fun openFileWithIntent(params: String?) {
         BridgeUtils.safeExecute(webView, BridgeUtils.WebEvents.ON_INTENT_ERROR, "open file with intent") {
@@ -626,6 +721,115 @@ class NativeBridge(
             }
         }
     }
+
+    private fun launchGoogleSignIn(options: GoogleSignInOptions) {
+        launch {
+            try {
+                val googleOptionBuilder = GetSignInWithGoogleOption.Builder(options.clientId)
+                options.nonce?.let { googleOptionBuilder.setNonce(it) }
+                val googleOption = googleOptionBuilder.build()
+
+                val request = GetCredentialRequest.Builder()
+                    .addCredentialOption(googleOption)
+                    .build()
+
+                BridgeUtils.logDebug(
+                    TAG,
+                    "Starting Google Sign-In via CredentialManager (hasNonce=${options.nonce != null})"
+                )
+
+                val response = credentialManager.getCredential(mainActivity, request)
+                handleCredentialResponse(response)
+            } catch (e: GetCredentialCancellationException) {
+                isGoogleSignInInProgress.set(false)
+                BridgeUtils.logDebug(
+                    TAG,
+                    "Google Sign-In cancelled: ${e.message} :: ${e.javaClass.simpleName}"
+                )
+                BridgeUtils.notifyWeb(
+                    webView,
+                    BridgeUtils.WebEvents.ON_GOOGLE_SIGN_IN_CANCELLED,
+                    "User cancelled Google sign-in"
+                )
+            } catch (e: GetCredentialException) {
+                isGoogleSignInInProgress.set(false)
+                val message = e.errorMessage?.toString() ?: e.message ?: "Credential request failed"
+                BridgeUtils.logError(
+                    TAG,
+                    "Google Sign-In credential error: $message :: ${e.javaClass.simpleName}",
+                    e
+                )
+                BridgeUtils.notifyWebError(
+                    webView,
+                    BridgeUtils.WebEvents.ON_GOOGLE_SIGN_IN_ERROR,
+                    message
+                )
+            } catch (e: Exception) {
+                isGoogleSignInInProgress.set(false)
+                BridgeUtils.logError(
+                    TAG,
+                    "Google Sign-In unexpected error: ${e.message} :: ${e.javaClass.simpleName}",
+                    e
+                )
+                BridgeUtils.notifyWebError(
+                    webView,
+                    BridgeUtils.WebEvents.ON_GOOGLE_SIGN_IN_ERROR,
+                    "Error preparing Google sign-in: ${e.message}"
+                )
+            }
+        }
+    }
+
+    private fun handleCredentialResponse(response: androidx.credentials.GetCredentialResponse) {
+        try {
+            val credential = response.credential
+            if (credential.type != GoogleIdTokenCredential.TYPE_GOOGLE_ID_TOKEN_CREDENTIAL) {
+                BridgeUtils.logError(TAG, "Unexpected credential type: ${credential.type}")
+                isGoogleSignInInProgress.set(false)
+                BridgeUtils.notifyWebError(
+                    webView,
+                    BridgeUtils.WebEvents.ON_GOOGLE_SIGN_IN_ERROR,
+                    "Unsupported credential type returned"
+                )
+                return
+            }
+
+            val googleCredential = GoogleIdTokenCredential.createFrom(credential.data)
+            val idToken = googleCredential.idToken
+
+            if (idToken.isNullOrBlank()) {
+                isGoogleSignInInProgress.set(false)
+                BridgeUtils.notifyWebError(
+                    webView,
+                    BridgeUtils.WebEvents.ON_GOOGLE_SIGN_IN_ERROR,
+                    "No ID token returned from Google sign-in"
+                )
+                return
+            }
+
+            val payload = JSONObject().apply {
+                put("idToken", idToken)
+                googleCredential.id?.let { put("email", it) }
+                googleCredential.displayName?.let { put("name", it) }
+                googleCredential.profilePictureUri?.toString()?.let { put("photoUrl", it) }
+                put("provider", "google")
+            }
+
+            isGoogleSignInInProgress.set(false)
+            BridgeUtils.notifyWebJson(
+                webView,
+                BridgeUtils.WebEvents.ON_GOOGLE_SIGN_IN_SUCCESS,
+                payload
+            )
+        } catch (e: Exception) {
+            isGoogleSignInInProgress.set(false)
+            BridgeUtils.notifyWebError(
+                webView,
+                BridgeUtils.WebEvents.ON_GOOGLE_SIGN_IN_ERROR,
+                "Error handling Google credential: ${e.message}"
+            )
+        }
+    }
     
     private fun processSelectedFiles(uris: List<Uri>, options: FilePickerOptions) {
         launch {

package/dist/native/androidProject/app/src/main/java/io/yourname/androidproject/utils/BridgeUtils.kt

@@ -4,6 +4,7 @@ import android.util.Log
 import android.webkit.WebView
 import io.yourname.androidproject.CatalystConstants
 import org.json.JSONObject
+import android.os.Looper
 
 /**
  * Common utilities for native bridge operations
@@ -65,9 +66,13 @@ object BridgeUtils {
         TOPIC_SUBSCRIPTION_RESULT("TOPIC_SUBSCRIPTION_RESULT"),
         SUBSCRIBED_TOPICS_RESULT("SUBSCRIBED_TOPICS_RESULT"),
 
+        // Auth events
+        ON_GOOGLE_SIGN_IN_SUCCESS("ON_GOOGLE_SIGN_IN_SUCCESS"),
+        ON_GOOGLE_SIGN_IN_ERROR("ON_GOOGLE_SIGN_IN_ERROR"),
+        ON_GOOGLE_SIGN_IN_CANCELLED("ON_GOOGLE_SIGN_IN_CANCELLED"),
+
         // Network events
         NETWORK_STATUS_CHANGED("NETWORK_STATUS_CHANGED"),
-
         // Safe area events
         ON_SAFE_AREA_INSETS_UPDATED("ON_SAFE_AREA_INSETS_UPDATED"),
     }
@@ -80,6 +85,12 @@ object BridgeUtils {
      * @param data The data to send (can be null)
      */
     fun notifyWeb(webView: WebView, event: WebEvents, data: String? = null) {
+        // Ensure WebView interactions happen on the main thread
+        if (Looper.myLooper() != Looper.getMainLooper()) {
+            webView.post { notifyWeb(webView, event, data) }
+            return
+        }
+
         try {
             val safeData = data?.replace("'", "\\'") ?: ""
             val jsCode = if (data != null) {

package/dist/native/androidProject/gradle/libs.versions.toml

@@ -10,6 +10,8 @@ material = "1.12.0"
 constraintlayout = "2.1.4"
 webkit = "1.13.0"
 googleServices = "4.4.0"
+androidxCredentials = "1.3.0"
+googleId = "1.1.1"
 
 [libraries]
 androidx-core-ktx = { group = "androidx.core", name = "core-ktx", version.ref = "coreKtx" }
@@ -20,9 +22,11 @@ androidx-appcompat = { group = "androidx.appcompat", name = "appcompat", version
 material = { group = "com.google.android.material", name = "material", version.ref = "material" }
 androidx-constraintlayout = { group = "androidx.constraintlayout", name = "constraintlayout", version.ref = "constraintlayout" }
 androidx-webkit = { group = "androidx.webkit", name = "webkit", version.ref = "webkit" }
+androidx-credentials = { group = "androidx.credentials", name = "credentials", version.ref = "androidxCredentials" }
+androidx-credentials-play-services-auth = { group = "androidx.credentials", name = "credentials-play-services-auth", version.ref = "androidxCredentials" }
+googleid = { group = "com.google.android.libraries.identity.googleid", name = "googleid", version.ref = "googleId" }
 
 [plugins]
 android-application = { id = "com.android.application", version.ref = "agp" }
 jetbrains-kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
 google-services = { id = "com.google.gms.google-services", version.ref = "googleServices" }
-

package/dist/native/bridge/constants/NativeInterfaces.js

@@ -6,7 +6,9 @@ OPEN_CAMERA:"openCamera",REQUEST_CAMERA_PERMISSION:"requestCameraPermission",//
 PICK_FILE:"pickFile",OPEN_FILE_WITH_INTENT:"openFileWithIntent",// Haptic feedback commands
 REQUEST_HAPTIC_FEEDBACK:"requestHapticFeedback",// Notification commands
 SCHEDULE_LOCAL_NOTIFICATION:"scheduleLocalNotification",CANCEL_LOCAL_NOTIFICATION:"cancelLocalNotification",REQUEST_NOTIFICATION_PERMISSION:"requestNotificationPermission",REGISTER_FOR_PUSH_NOTIFICATIONS:"registerForPushNotifications",UPDATE_BADGE_COUNT:"updateBadgeCount",SUBSCRIBE_TO_TOPIC:"subscribeToTopic",UNSUBSCRIBE_FROM_TOPIC:"unsubscribeFromTopic",GET_SUBSCRIBED_TOPICS:"getSubscribedTopics",// Device info commands
-GET_DEVICE_INFO:"getDeviceInfo",GET_NETWORK_STATUS:"getNetworkStatus",// Safe area commands
+GET_DEVICE_INFO:"getDeviceInfo",// Network commands
+GET_NETWORK_STATUS:"getNetworkStatus",// Auth commands
+GOOGLE_SIGN_IN:"googleSignIn",// Safe area commands
 GET_SAFE_AREA:"getSafeArea"};// Callback Interfaces: Native → Web (incoming events/callbacks)
 const NATIVE_CALLBACKS=exports.NATIVE_CALLBACKS={// Camera callbacks
 CAMERA_PERMISSION_STATUS:"CAMERA_PERMISSION_STATUS",ON_CAMERA_CAPTURE:"ON_CAMERA_CAPTURE",ON_CAMERA_ERROR:"ON_CAMERA_ERROR",// File picker callbacks
@@ -14,10 +16,11 @@ ON_FILE_PICKED:"ON_FILE_PICKED",ON_FILE_PICK_ERROR:"ON_FILE_PICK_ERROR",ON_FILE_
 ON_INTENT_SUCCESS:"ON_INTENT_SUCCESS",ON_INTENT_ERROR:"ON_INTENT_ERROR",ON_INTENT_CANCELLED:"ON_INTENT_CANCELLED",// Haptic feedback callbacks
 HAPTIC_FEEDBACK:"HAPTIC_FEEDBACK",// Notification callbacks
 NOTIFICATION_PERMISSION_STATUS:"NOTIFICATION_PERMISSION_STATUS",LOCAL_NOTIFICATION_SCHEDULED:"LOCAL_NOTIFICATION_SCHEDULED",LOCAL_NOTIFICATION_CANCELLED:"LOCAL_NOTIFICATION_CANCELLED",PUSH_NOTIFICATION_TOKEN:"PUSH_NOTIFICATION_TOKEN",NOTIFICATION_RECEIVED:"NOTIFICATION_RECEIVED",NOTIFICATION_ACTION_PERFORMED:"NOTIFICATION_ACTION_PERFORMED",NOTIFICATION_TAPPED:"NOTIFICATION_TAPPED",TOPIC_SUBSCRIPTION_RESULT:"TOPIC_SUBSCRIPTION_RESULT",SUBSCRIBED_TOPICS_RESULT:"SUBSCRIBED_TOPICS_RESULT",// Device info callbacks
-ON_DEVICE_INFO_SUCCESS:"ON_DEVICE_INFO_SUCCESS",ON_DEVICE_INFO_ERROR:"ON_DEVICE_INFO_ERROR",// Network callbacks
+ON_DEVICE_INFO_SUCCESS:"ON_DEVICE_INFO_SUCCESS",ON_DEVICE_INFO_ERROR:"ON_DEVICE_INFO_ERROR",// Auth callbacks
+ON_GOOGLE_SIGN_IN_SUCCESS:"ON_GOOGLE_SIGN_IN_SUCCESS",ON_GOOGLE_SIGN_IN_ERROR:"ON_GOOGLE_SIGN_IN_ERROR",ON_GOOGLE_SIGN_IN_CANCELLED:"ON_GOOGLE_SIGN_IN_CANCELLED",// Network callbacks
 NETWORK_STATUS_CHANGED:"NETWORK_STATUS_CHANGED",// Safe area callbacks
 ON_SAFE_AREA_INSETS_UPDATED:"ON_SAFE_AREA_INSETS_UPDATED"};// Interface Categories for easier management
-const INTERFACE_CATEGORIES=exports.INTERFACE_CATEGORIES={CAMERA:{commands:[NATIVE_COMMANDS.OPEN_CAMERA,NATIVE_COMMANDS.REQUEST_CAMERA_PERMISSION],callbacks:[NATIVE_CALLBACKS.CAMERA_PERMISSION_STATUS,NATIVE_CALLBACKS.ON_CAMERA_CAPTURE,NATIVE_CALLBACKS.ON_CAMERA_ERROR]},FILE:{commands:[NATIVE_COMMANDS.PICK_FILE,NATIVE_COMMANDS.OPEN_FILE_WITH_INTENT],callbacks:[NATIVE_CALLBACKS.ON_FILE_PICKED,NATIVE_CALLBACKS.ON_FILE_PICK_ERROR,NATIVE_CALLBACKS.ON_FILE_PICK_CANCELLED,NATIVE_CALLBACKS.ON_FILE_PICK_STATE_UPDATE]},INTENT:{commands:[NATIVE_COMMANDS.OPEN_FILE_WITH_INTENT],callbacks:[NATIVE_CALLBACKS.ON_INTENT_SUCCESS,NATIVE_CALLBACKS.ON_INTENT_ERROR,NATIVE_CALLBACKS.ON_INTENT_CANCELLED]},HAPTIC:{commands:[NATIVE_COMMANDS.REQUEST_HAPTIC_FEEDBACK],callbacks:[NATIVE_CALLBACKS.HAPTIC_FEEDBACK]},NOTIFICATION:{commands:[NATIVE_COMMANDS.SCHEDULE_LOCAL_NOTIFICATION,NATIVE_COMMANDS.CANCEL_LOCAL_NOTIFICATION,NATIVE_COMMANDS.REQUEST_NOTIFICATION_PERMISSION,NATIVE_COMMANDS.REGISTER_FOR_PUSH_NOTIFICATIONS,NATIVE_COMMANDS.UPDATE_BADGE_COUNT,NATIVE_COMMANDS.SUBSCRIBE_TO_TOPIC,NATIVE_COMMANDS.UNSUBSCRIBE_FROM_TOPIC,NATIVE_COMMANDS.GET_SUBSCRIBED_TOPICS],callbacks:[NATIVE_CALLBACKS.NOTIFICATION_PERMISSION_STATUS,NATIVE_CALLBACKS.LOCAL_NOTIFICATION_SCHEDULED,NATIVE_CALLBACKS.LOCAL_NOTIFICATION_CANCELLED,NATIVE_CALLBACKS.PUSH_NOTIFICATION_TOKEN,NATIVE_CALLBACKS.NOTIFICATION_RECEIVED,NATIVE_CALLBACKS.NOTIFICATION_ACTION_PERFORMED,NATIVE_CALLBACKS.NOTIFICATION_TAPPED,NATIVE_CALLBACKS.TOPIC_SUBSCRIPTION_RESULT,NATIVE_CALLBACKS.SUBSCRIBED_TOPICS_RESULT]},DEVICE_INFO:{commands:[NATIVE_COMMANDS.GET_DEVICE_INFO],callbacks:[NATIVE_CALLBACKS.ON_DEVICE_INFO_SUCCESS,NATIVE_CALLBACKS.ON_DEVICE_INFO_ERROR]},NETWORK:{commands:[NATIVE_COMMANDS.GET_NETWORK_STATUS],callbacks:[NATIVE_CALLBACKS.NETWORK_STATUS_CHANGED]}};// All available interfaces (for validation)
+const INTERFACE_CATEGORIES=exports.INTERFACE_CATEGORIES={CAMERA:{commands:[NATIVE_COMMANDS.OPEN_CAMERA,NATIVE_COMMANDS.REQUEST_CAMERA_PERMISSION],callbacks:[NATIVE_CALLBACKS.CAMERA_PERMISSION_STATUS,NATIVE_CALLBACKS.ON_CAMERA_CAPTURE,NATIVE_CALLBACKS.ON_CAMERA_ERROR]},FILE:{commands:[NATIVE_COMMANDS.PICK_FILE,NATIVE_COMMANDS.OPEN_FILE_WITH_INTENT],callbacks:[NATIVE_CALLBACKS.ON_FILE_PICKED,NATIVE_CALLBACKS.ON_FILE_PICK_ERROR,NATIVE_CALLBACKS.ON_FILE_PICK_CANCELLED,NATIVE_CALLBACKS.ON_FILE_PICK_STATE_UPDATE]},INTENT:{commands:[NATIVE_COMMANDS.OPEN_FILE_WITH_INTENT],callbacks:[NATIVE_CALLBACKS.ON_INTENT_SUCCESS,NATIVE_CALLBACKS.ON_INTENT_ERROR,NATIVE_CALLBACKS.ON_INTENT_CANCELLED]},HAPTIC:{commands:[NATIVE_COMMANDS.REQUEST_HAPTIC_FEEDBACK],callbacks:[NATIVE_CALLBACKS.HAPTIC_FEEDBACK]},NOTIFICATION:{commands:[NATIVE_COMMANDS.SCHEDULE_LOCAL_NOTIFICATION,NATIVE_COMMANDS.CANCEL_LOCAL_NOTIFICATION,NATIVE_COMMANDS.REQUEST_NOTIFICATION_PERMISSION,NATIVE_COMMANDS.REGISTER_FOR_PUSH_NOTIFICATIONS,NATIVE_COMMANDS.UPDATE_BADGE_COUNT,NATIVE_COMMANDS.SUBSCRIBE_TO_TOPIC,NATIVE_COMMANDS.UNSUBSCRIBE_FROM_TOPIC,NATIVE_COMMANDS.GET_SUBSCRIBED_TOPICS],callbacks:[NATIVE_CALLBACKS.NOTIFICATION_PERMISSION_STATUS,NATIVE_CALLBACKS.LOCAL_NOTIFICATION_SCHEDULED,NATIVE_CALLBACKS.LOCAL_NOTIFICATION_CANCELLED,NATIVE_CALLBACKS.PUSH_NOTIFICATION_TOKEN,NATIVE_CALLBACKS.NOTIFICATION_RECEIVED,NATIVE_CALLBACKS.NOTIFICATION_ACTION_PERFORMED,NATIVE_CALLBACKS.NOTIFICATION_TAPPED,NATIVE_CALLBACKS.TOPIC_SUBSCRIPTION_RESULT,NATIVE_CALLBACKS.SUBSCRIBED_TOPICS_RESULT]},DEVICE_INFO:{commands:[NATIVE_COMMANDS.GET_DEVICE_INFO],callbacks:[NATIVE_CALLBACKS.ON_DEVICE_INFO_SUCCESS,NATIVE_CALLBACKS.ON_DEVICE_INFO_ERROR]},AUTH:{commands:[NATIVE_COMMANDS.GOOGLE_SIGN_IN],callbacks:[NATIVE_CALLBACKS.ON_GOOGLE_SIGN_IN_SUCCESS,NATIVE_CALLBACKS.ON_GOOGLE_SIGN_IN_ERROR,NATIVE_CALLBACKS.ON_GOOGLE_SIGN_IN_CANCELLED]},NETWORK:{commands:[NATIVE_COMMANDS.GET_NETWORK_STATUS],callbacks:[NATIVE_CALLBACKS.NETWORK_STATUS_CHANGED]}};// All available interfaces (for validation)
 const ALL_COMMANDS=exports.ALL_COMMANDS=Object.values(NATIVE_COMMANDS);const ALL_CALLBACKS=exports.ALL_CALLBACKS=Object.values(NATIVE_CALLBACKS);const ALL_INTERFACES=exports.ALL_INTERFACES=[...ALL_COMMANDS,...ALL_CALLBACKS];// Permission status constants
 const PERMISSION_STATUS=exports.PERMISSION_STATUS={GRANTED:"GRANTED",DENIED:"DENIED",NOT_DETERMINED:"NOT_DETERMINED",RESTRICTED:"RESTRICTED"};// Haptic feedback types (matching Android implementation)
 const HAPTIC_FEEDBACK_TYPES=exports.HAPTIC_FEEDBACK_TYPES={VIRTUAL_KEY:"VIRTUAL_KEY",LONG_PRESS:"LONG_PRESS",DEFAULT:"DEFAULT",// Legacy types for backward compatibility

package/dist/native/bridge/errors.js

@@ -22,7 +22,7 @@ const ERROR_DEFINITIONS=exports.ERROR_DEFINITIONS={[ERROR_CODES.PERMISSION_DENIE
  * Translate native error to standardized error
  * @param {any} nativeError - Native error from Android/iOS
  * @returns {Object} Standardized error object
- */exports.createStandardError=createStandardError;const translateError=nativeError=>{if(!nativeError){return createStandardError(ERROR_CODES.INTERNAL_ERROR,null,nativeError);}const errorString=nativeError.toString().toLowerCase();// Permission errors
+ */exports.createStandardError=createStandardError;const translateError=nativeError=>{if(!nativeError){return createStandardError(ERROR_CODES.INTERNAL_ERROR,null,nativeError);}const errorString=nativeError.toString().toLowerCase();if(errorString.includes("disabled")&&errorString.includes("config")){return createStandardError(ERROR_CODES.FEATURE_UNSUPPORTED,nativeError.toString(),nativeError);}// Permission errors
 if(errorString.includes("permission")&&errorString.includes("denied")){if(errorString.includes("camera")){return createStandardError(ERROR_CODES.PERMISSION_DENIED,"Camera permission denied",nativeError);}if(errorString.includes("storage")||errorString.includes("external_storage")){return createStandardError(ERROR_CODES.PERMISSION_DENIED,"Storage permission denied",nativeError);}return createStandardError(ERROR_CODES.PERMISSION_DENIED,null,nativeError);}// File system errors
 if(errorString.includes("filenotfound")||errorString.includes("file not found")){return createStandardError(ERROR_CODES.FILE_NOT_FOUND,null,nativeError);}if(errorString.includes("storage")&&errorString.includes("full")){return createStandardError(ERROR_CODES.STORAGE_FULL,null,nativeError);}// Network errors
 if(errorString.includes("network")||errorString.includes("connection")||errorString.includes("internet")){return createStandardError(ERROR_CODES.NETWORK_UNAVAILABLE,null,nativeError);}// User cancellation

package/dist/native/bridge/hooks.js

@@ -1,8 +1,12 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.useSafeArea=exports.useNotificationPermission=exports.useNotification=exports.useNetworkStatus=exports.useIntent=exports.useHapticFeedback=exports.useFilePicker=exports.useCameraPermission=exports.useCamera=exports.requestNotificationPermission=exports.requestHapticFeedback=exports.requestCameraPermission=void 0;var _react=require("react");var _NativeBridge=_interopRequireDefault(require("./utils/NativeBridge.js"));var _NativeInterfaces=require("./constants/NativeInterfaces.js");var _useBaseHook=require("./useBaseHook.js");var _errors=require("./errors.js");var _FileObjectConverter=require("./utils/FileObjectConverter.js");var _safeArea=require("./safeArea.js");function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e};}/* eslint-disable react-compiler/react-compiler, react-hooks/exhaustive-deps */// Shared callback system for notification permission status
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.useSafeArea=exports.useNotificationPermission=exports.useNotification=exports.useNetworkStatus=exports.useIntent=exports.useHapticFeedback=exports.useGoogleSignIn=exports.useFilePicker=exports.useCameraPermission=exports.useCamera=exports.requestNotificationPermission=exports.requestHapticFeedback=exports.requestCameraPermission=void 0;var _react=require("react");var _NativeBridge=_interopRequireDefault(require("./utils/NativeBridge.js"));var _NativeInterfaces=require("./constants/NativeInterfaces.js");var _useBaseHook=require("./useBaseHook.js");var _errors=require("./errors.js");var _FileObjectConverter=require("./utils/FileObjectConverter.js");var _safeArea=require("./safeArea.js");function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e};}/* eslint-disable react-compiler/react-compiler, react-hooks/exhaustive-deps */// Shared callback system for notification permission status
 // This allows multiple listeners (hook + requestNotificationPermission) to receive updates
 const permissionStatusListeners=new Set();let isPermissionCallbackRegistered=false;const registerPermissionStatusListener=callback=>{permissionStatusListeners.add(callback);// Register the shared handler with WebBridge if this is the first listener
 if(!isPermissionCallbackRegistered&&typeof window!=="undefined"&&window.WebBridge){isPermissionCallbackRegistered=true;window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.NOTIFICATION_PERMISSION_STATUS,data=>{// Notify all listeners
-permissionStatusListeners.forEach(listener=>{try{listener(data);}catch(error){console.error("Error in permission status listener:",error);}});});}return()=>{permissionStatusListeners.delete(callback);};};const unregisterPermissionStatusListener=callback=>{permissionStatusListeners.delete(callback);};const noop=()=>{};const createSSRUnavailable=methodName=>async()=>{throw new Error(`${methodName} is not available in SSR environment`);};const SSR_FILE_PICKER_STUB={data:null,loading:false,progress:null,error:null,isWeb:true,isNative:false,execute:noop,clear:noop,clearError:noop,getFileObject:createSSRUnavailable("getFileObject"),getAllFileObjects:createSSRUnavailable("getAllFileObjects"),canCreateFileObject:false,canCreateFileObjects:[],selectedFile:null,selectedFiles:[],pickFile:noop,isLoading:false,processingState:null,clearFile:noop};const parseNativePayload=payload=>{if(payload==null)return null;if(typeof payload!=="string")return payload;return JSON.parse(payload);};const extractFiles=value=>{if(!value)return[];if(Array.isArray(value))return value.filter(Boolean);if(Array.isArray(value.files))return value.files.filter(Boolean);if(value.files)return[value.files];return[value].filter(Boolean);};const normalizeFilePickResult=payload=>{const parsed=parseNativePayload(payload);if(!parsed)return null;const files=extractFiles(parsed);if(!files.length)return null;const first=files[0];const rawOptions=!Array.isArray(parsed)&&parsed&&typeof parsed.options==="object"?parsed.options:null;let normalizedOptions=rawOptions||null;if(rawOptions){try{normalizedOptions=sanitizeFilePickerOptions(rawOptions);}catch(_error){normalizedOptions=rawOptions;}}const totalSize=parsed.totalSize??files.reduce((sum,file)=>{const size=typeof file?.size==="number"?file.size:0;return sum+size;},0);const base=Array.isArray(parsed)?{}:parsed;return{...base,files,multiple:parsed.multiple??files.length>1,count:parsed.count??files.length,totalSize,fileName:parsed.fileName??first?.fileName??first?.name??null,fileSrc:parsed.fileSrc??first?.fileSrc??first?.src??null,filePath:parsed.filePath??first?.filePath??null,size:parsed.size??first?.size??null,mimeType:parsed.mimeType??first?.mimeType??first?.type??null,transport:parsed.transport??first?.transport??null,options:normalizedOptions};};const updateProgressFromResult=(updateProgress,result)=>{if(!result)return;const first=result.files?.[0];const transport=result.transport??first?.transport??null;const bytesTotal=result.totalSize??result.size??(typeof first?.size==="number"?first.size:null);if(transport||bytesTotal!=null){updateProgress({transport:transport??null,bytesTotal});}};const mapStateToProgress=state=>{if(state==null){return{state:"starting",phase:null,message:"File picker: starting..."};}const rawState=String(state);const normalized=rawState.toLowerCase();const allowedStates=new Set(["opening","processing","routing"]);const progressState=allowedStates.has(normalized)?normalized:"starting";return{state:progressState,phase:rawState,message:`File picker: ${rawState}...`};};const sanitizeFilePickerOptions=input=>{const options={...input};const mime=typeof options.mimeType==="string"?options.mimeType.trim():"";options.mimeType=mime.length>0?mime:"*/*";const coerceInteger=(value,min)=>{if(value==null)return undefined;const numeric=typeof value==="string"?Number(value.trim()):Number(value);if(!Number.isFinite(numeric)){throw new Error("File picker numeric options must be valid numbers");}if(!Number.isInteger(numeric)){throw new Error("File picker numeric options must be integers");}if(numeric<min){throw new Error(`File picker numeric options must be ≥ ${min}`);}return numeric;};const minFiles=coerceInteger(options.minFiles,1);const maxFiles=coerceInteger(options.maxFiles,1);const minFileSize=coerceInteger(options.minFileSize,0);const maxFileSize=coerceInteger(options.maxFileSize,0);if(minFiles!==undefined)options.minFiles=minFiles;if(maxFiles!==undefined)options.maxFiles=maxFiles;if(minFileSize!==undefined)options.minFileSize=minFileSize;if(maxFileSize!==undefined)options.maxFileSize=maxFileSize;if(minFiles!==undefined&&maxFiles!==undefined&&minFiles>maxFiles){throw new Error("minFiles cannot be greater than maxFiles");}if(minFileSize!==undefined&&maxFileSize!==undefined&&minFileSize>maxFileSize){throw new Error("minFileSize cannot be greater than maxFileSize");}const multiple=typeof options.multiple==="boolean"?options.multiple:Boolean(options.multiple);options.multiple=multiple||minFiles&&minFiles>1||maxFiles&&maxFiles>1;return options;};const resolvePickPayload=input=>{if(input==null)return"*/*";if(typeof input==="string")return input.trim()||"*/*";return sanitizeFilePickerOptions(input);};const registerNativeHandlers=handlers=>{handlers.forEach(([event,handler])=>window.WebBridge.register(event,handler));return()=>{handlers.forEach(([event])=>window.WebBridge.unregister(event));};};/**
+permissionStatusListeners.forEach(listener=>{try{listener(data);}catch(error){console.error("Error in permission status listener:",error);}});});}return()=>{permissionStatusListeners.delete(callback);};};const unregisterPermissionStatusListener=callback=>{permissionStatusListeners.delete(callback);};const noop=()=>{};const createSSRUnavailable=methodName=>async()=>{throw new Error(`${methodName} is not available in SSR environment`);};const SSR_FILE_PICKER_STUB={data:null,loading:false,progress:null,error:null,isWeb:true,isNative:false,execute:noop,clear:noop,clearError:noop,getFileObject:createSSRUnavailable("getFileObject"),getAllFileObjects:createSSRUnavailable("getAllFileObjects"),canCreateFileObject:false,canCreateFileObjects:[],selectedFile:null,selectedFiles:[],pickFile:noop,isLoading:false,processingState:null,clearFile:noop};const parseNativePayload=payload=>{if(payload==null)return null;if(typeof payload!=="string")return payload;return JSON.parse(payload);};const extractFiles=value=>{if(!value)return[];if(Array.isArray(value))return value.filter(Boolean);if(Array.isArray(value.files))return value.files.filter(Boolean);if(value.files)return[value.files];return[value].filter(Boolean);};const normalizeFilePickResult=payload=>{const parsed=parseNativePayload(payload);if(!parsed)return null;const files=extractFiles(parsed);if(!files.length)return null;const first=files[0];const rawOptions=!Array.isArray(parsed)&&parsed&&typeof parsed.options==="object"?parsed.options:null;let normalizedOptions=rawOptions||null;if(rawOptions){try{normalizedOptions=sanitizeFilePickerOptions(rawOptions);}catch(_error){normalizedOptions=rawOptions;}}const totalSize=parsed.totalSize??files.reduce((sum,file)=>{const size=typeof file?.size==="number"?file.size:0;return sum+size;},0);const base=Array.isArray(parsed)?{}:parsed;return{...base,files,multiple:parsed.multiple??files.length>1,count:parsed.count??files.length,totalSize,fileName:parsed.fileName??first?.fileName??first?.name??null,fileSrc:parsed.fileSrc??first?.fileSrc??first?.src??null,filePath:parsed.filePath??first?.filePath??null,size:parsed.size??first?.size??null,mimeType:parsed.mimeType??first?.mimeType??first?.type??null,transport:parsed.transport??first?.transport??null,options:normalizedOptions};};/**
+ * Google Sign-In hook (Android-first, Credential Manager)
+ * Provides a promise-like sign-in call and standardized callbacks
+ */const useGoogleSignIn=(defaultOptions={})=>{const base=(0,_useBaseHook.useBaseHook)("useGoogleSignIn");// Server-side rendering safety
+if(typeof window==="undefined"){return{data:null,loading:false,error:null,progress:null,isWeb:true,isNative:false,signIn:()=>{},execute:()=>{},clear:()=>{},clearError:()=>{}};}if(!window.WebBridge){throw new Error("WebBridge is not initialized. Call WebBridge.init() first.");}(0,_react.useEffect)(()=>{const handleSuccess=payload=>{try{const parsed=typeof payload==="string"?JSON.parse(payload):payload;base.setDataAndComplete(parsed);}catch(err){base.handleNativeError(err);}};const handleError=nativeError=>{base.handleNativeError(nativeError);};const handleCancelled=()=>{const error=(0,_errors.createStandardError)(_errors.ERROR_CODES.OPERATION_CANCELLED,"Google sign-in cancelled",null,"User dismissed Google sign-in");base.handleNativeError(error);};window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.ON_GOOGLE_SIGN_IN_SUCCESS,handleSuccess);window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.ON_GOOGLE_SIGN_IN_ERROR,handleError);window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.ON_GOOGLE_SIGN_IN_CANCELLED,handleCancelled);return()=>{window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.ON_GOOGLE_SIGN_IN_SUCCESS);window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.ON_GOOGLE_SIGN_IN_ERROR);window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.ON_GOOGLE_SIGN_IN_CANCELLED);};},[base]);const signIn=(0,_react.useCallback)((options={})=>{base.executeOperation(()=>{const payload={...defaultOptions,...options};_NativeBridge.default.auth.googleSignIn(payload);},"google sign-in");},[base,defaultOptions]);return{data:base.data,loading:base.loading,progress:base.progress,error:base.error,isWeb:base.isWeb,isNative:base.isNative,signIn,execute:signIn,clear:base.clear,clearError:base.clearError};};exports.useGoogleSignIn=useGoogleSignIn;const updateProgressFromResult=(updateProgress,result)=>{if(!result)return;const first=result.files?.[0];const transport=result.transport??first?.transport??null;const bytesTotal=result.totalSize??result.size??(typeof first?.size==="number"?first.size:null);if(transport||bytesTotal!=null){updateProgress({transport:transport??null,bytesTotal});}};const mapStateToProgress=state=>{if(state==null){return{state:"starting",phase:null,message:"File picker: starting..."};}const rawState=String(state);const normalized=rawState.toLowerCase();const allowedStates=new Set(["opening","processing","routing"]);const progressState=allowedStates.has(normalized)?normalized:"starting";return{state:progressState,phase:rawState,message:`File picker: ${rawState}...`};};const sanitizeFilePickerOptions=input=>{const options={...input};const mime=typeof options.mimeType==="string"?options.mimeType.trim():"";options.mimeType=mime.length>0?mime:"*/*";const coerceInteger=(value,min)=>{if(value==null)return undefined;const numeric=typeof value==="string"?Number(value.trim()):Number(value);if(!Number.isFinite(numeric)){throw new Error("File picker numeric options must be valid numbers");}if(!Number.isInteger(numeric)){throw new Error("File picker numeric options must be integers");}if(numeric<min){throw new Error(`File picker numeric options must be ≥ ${min}`);}return numeric;};const minFiles=coerceInteger(options.minFiles,1);const maxFiles=coerceInteger(options.maxFiles,1);const minFileSize=coerceInteger(options.minFileSize,0);const maxFileSize=coerceInteger(options.maxFileSize,0);if(minFiles!==undefined)options.minFiles=minFiles;if(maxFiles!==undefined)options.maxFiles=maxFiles;if(minFileSize!==undefined)options.minFileSize=minFileSize;if(maxFileSize!==undefined)options.maxFileSize=maxFileSize;if(minFiles!==undefined&&maxFiles!==undefined&&minFiles>maxFiles){throw new Error("minFiles cannot be greater than maxFiles");}if(minFileSize!==undefined&&maxFileSize!==undefined&&minFileSize>maxFileSize){throw new Error("minFileSize cannot be greater than maxFileSize");}const multiple=typeof options.multiple==="boolean"?options.multiple:Boolean(options.multiple);options.multiple=multiple||minFiles&&minFiles>1||maxFiles&&maxFiles>1;return options;};const resolvePickPayload=input=>{if(input==null)return"*/*";if(typeof input==="string")return input.trim()||"*/*";return sanitizeFilePickerOptions(input);};const registerNativeHandlers=handlers=>{handlers.forEach(([event,handler])=>window.WebBridge.register(event,handler));return()=>{handlers.forEach(([event])=>window.WebBridge.unregister(event));};};/**
  * React hook for camera functionality using standardized interface
  * Handles camera permissions, photo capture, and error states
  */const useCamera=()=>{// Use standardized base hook

package/dist/native/bridge/utils/NativeBridge.js

@@ -80,7 +80,11 @@ if(process.env.NODE_ENV==="development"){console.warn(`🌉 Development mode: Na
          * Get device information
          * @returns {Promise} - Returns device info through callback
          */getDeviceInfo:()=>this.call(_NativeInterfaces.NATIVE_COMMANDS.GET_DEVICE_INFO)};/**
-     * Safe area methods
+     * Auth methods
+     */auth={/**
+         * Trigger Google Sign-In (Credential Manager)
+         * @param {Object} options - config (clientId, nonce, autoSelect, etc.)
+         */googleSignIn:(options={})=>{const payload=options&&typeof options==="object"?JSON.stringify(options):options?.toString?.();return this.call(_NativeInterfaces.NATIVE_COMMANDS.GOOGLE_SIGN_IN,payload);}};/** Safe area methods
      */safeArea={/**
          * Get current safe area insets
          * Returns insets through ON_SAFE_AREA_INSETS_UPDATED callback

package/dist/native/buildAppIos.js

@@ -1,12 +1,12 @@
 "use strict";const{exec,execSync}=require("child_process");const fs=require("fs");const path=require("path");const TerminalProgress=require("./TerminalProgress.js").default;const crypto=require("crypto");const catalystCorePath=path.dirname(require.resolve("catalyst-core/package.json"));const pwd=path.join(catalystCorePath,"dist/native");const{WEBVIEW_CONFIG,BUILD_OUTPUT_PATH}=require(`${process.env.PWD}/config/config.json`);// Configuration constants
-const iosConfig=WEBVIEW_CONFIG.ios;const protocol=WEBVIEW_CONFIG.useHttps?"https":"http";const ip=WEBVIEW_CONFIG.LOCAL_IP||"localhost";const port=WEBVIEW_CONFIG.port?WEBVIEW_CONFIG.useHttps?443:WEBVIEW_CONFIG.port:null;let url=port?`${protocol}://${ip}:${port}`:`${protocol}://${ip}`;const PUBLIC_PATH=`${process.env.PWD}/public`;const PROJECT_DIR=`${pwd}/iosnativeWebView`;const SCHEME_NAME="iosnativeWebView";const APP_BUNDLE_ID=iosConfig.appBundleId||"com.debug.webview";const PROJECT_NAME=path.basename(PROJECT_DIR);const IPHONE_MODEL=iosConfig.simulatorName;const GOOGLE_SERVICES_FILENAME="GoogleService-Info.plist";function generateProjectObjectId(identifier,suffix=""){return crypto.createHash("md5").update(`${identifier}:${suffix}`).digest("hex").substring(0,24).toUpperCase();}function getXcodeProjectFilePath(){return path.join(PROJECT_DIR,`${PROJECT_NAME}.xcodeproj`,"project.pbxproj");}// Define build steps for progress tracking
+const iosConfig=WEBVIEW_CONFIG.ios;const isGoogleSignInEnabled=WEBVIEW_CONFIG.googleSignIn?.enabled??false;const protocol=WEBVIEW_CONFIG.useHttps?"https":"http";const ip=WEBVIEW_CONFIG.LOCAL_IP||"localhost";const port=WEBVIEW_CONFIG.port?WEBVIEW_CONFIG.useHttps?443:WEBVIEW_CONFIG.port:null;let url=port?`${protocol}://${ip}:${port}`:`${protocol}://${ip}`;const PUBLIC_PATH=`${process.env.PWD}/public`;const PROJECT_DIR=`${pwd}/iosnativeWebView`;const SCHEME_NAME="iosnativeWebView";const APP_BUNDLE_ID=iosConfig.appBundleId||"com.debug.webview";const PROJECT_NAME=path.basename(PROJECT_DIR);const IPHONE_MODEL=iosConfig.simulatorName;const GOOGLE_SERVICES_FILENAME="GoogleService-Info.plist";function generateProjectObjectId(identifier,suffix=""){return crypto.createHash("md5").update(`${identifier}:${suffix}`).digest("hex").substring(0,24).toUpperCase();}function getXcodeProjectFilePath(){return path.join(PROJECT_DIR,`${PROJECT_NAME}.xcodeproj`,"project.pbxproj");}// Define build steps for progress tracking
 const steps={config:"Generating Required Configuration for build",deviceDetection:"Detecting Physical Device",launchSimulator:"Launch iOS Simulator",clean:"Clean Build Artifacts",assets:"Process Notification Assets",build:"Build IOS Project",findApp:"Locate Built Application",install:"Install Application",launch:"Launch Application"};// Configure progress display
 const progressConfig={titlePaddingTop:2,titlePaddingBottom:1,stepPaddingLeft:4,stepSpacing:1,errorPaddingLeft:6,bottomMargin:2};const progress=new TerminalProgress(steps,"Catalyst iOS Build",progressConfig);// Utility function to run shell commands
 function runCommand(command,options={}){return new Promise((resolve,reject)=>{// eslint-disable-next-line security/detect-child-process
 exec(command,{maxBuffer:1024*1024*10,...options},(error,stdout,stderr)=>{if(error){console.error(`Command failed: ${command}`);console.error(`Error: ${error.message}`);console.error(`stderr: ${stderr}`);reject(error);return;}if(stderr){console.warn(`Warning: ${stderr}`);}resolve(stdout.trim());});});}async function getBootedSimulatorUUID(modelName){try{// First try to find a booted simulator of the specified model
 let command=`xcrun simctl list devices | grep "${modelName}" | grep "Booted" | grep -E -o -i "([0-9a-f]{8}-([0-9a-f]{4}-){3}[0-9a-f]{12})" | head -n 1`;let uuid=execSync(command).toString().trim();if(uuid){console.log(`Found booted simulator of model ${modelName}`);return uuid;}// If no booted simulator of the specified model is found, check any booted simulator
 console.log(`No booted simulator of model ${modelName} found, checking for any booted simulator...`);command=`xcrun simctl list devices | grep "Booted" | grep -E -o -i "([0-9a-f]{8}-([0-9a-f]{4}-){3}[0-9a-f]{12})" | head -n 1`;uuid=execSync(command).toString().trim();if(uuid){console.log("Found another booted simulator, will use it instead");return uuid;}return null;}catch(error){console.log("No booted simulators found");return null;}}async function getBootedSimulatorInfo(){try{const listCommand="xcrun simctl list devices --json";const simulatorList=JSON.parse(execSync(listCommand).toString());for(const runtime in simulatorList.devices){const devices=simulatorList.devices[runtime];for(const device of devices){if(device.state==="Booted"){return{udid:device.udid,name:device.name,runtime:runtime};}}}return null;}catch(error){console.log("Failed to get booted simulator info:",error.message);return null;}}async function generatePackageSwift(){try{const isNotificationsEnabled=WEBVIEW_CONFIG.notifications?.enabled??false;progress.log(`🔧 Generating Package.swift (notifications: ${isNotificationsEnabled})`,"info");// Create hash of current config to detect changes
-const configHash=crypto.createHash("md5").update(JSON.stringify({notifications:isNotificationsEnabled})).digest("hex");const hashFilePath=path.join(PROJECT_DIR,".package-config-hash");const targetPath=path.join(PROJECT_DIR,"Package.swift");let shouldUpdate=true;// Check if we need to update based on config change
+const configHash=crypto.createHash("md5").update(JSON.stringify({notifications:isNotificationsEnabled,googleSignIn:isGoogleSignInEnabled})).digest("hex");const hashFilePath=path.join(PROJECT_DIR,".package-config-hash");const targetPath=path.join(PROJECT_DIR,"Package.swift");let shouldUpdate=true;// Check if we need to update based on config change
 if(fs.existsSync(hashFilePath)){const previousHash=fs.readFileSync(hashFilePath,"utf8");if(previousHash===configHash){shouldUpdate=false;progress.log("Package.swift already up to date","info");}}// Ensure Package.swift exists even if hash matches
 if(!fs.existsSync(targetPath)){shouldUpdate=true;progress.log("Package.swift missing, will generate it now","info");}if(shouldUpdate){progress.log("Generating Package.swift dynamically","info");// Build the Package.swift content dynamically
 let packageContent=`// swift-tools-version: 5.9
@@ -23,7 +23,8 @@ if(isNotificationsEnabled){packageContent+=`,
         .library(name: "CatalystNotifications", targets: ["CatalystNotifications"])`;}packageContent+=`
     ],
     dependencies: [
-        .package(url: "https://github.com/kylef/JSONSchema.swift", from: "0.6.0")`;// Add Firebase dependency only if notifications enabled
+        .package(url: "https://github.com/kylef/JSONSchema.swift", from: "0.6.0"),
+        .package(url: "https://github.com/google/GoogleSignIn-iOS", from: "7.0.0")`;// Add Firebase dependency only if notifications enabled
 if(isNotificationsEnabled){packageContent+=`,
         .package(url: "https://github.com/firebase/firebase-ios-sdk", from: "12.3.0")`;}packageContent+=`
     ],
@@ -33,7 +34,8 @@ if(isNotificationsEnabled){packageContent+=`,
         .target(
             name: "CatalystCore",
             dependencies: [
-                .product(name: "JSONSchema", package: "JSONSchema.swift")
+                .product(name: "JSONSchema", package: "JSONSchema.swift"),
+                .product(name: "GoogleSignIn", package: "GoogleSignIn-iOS")
             ],
             path: "Sources/Core"
         )`;// Add CatalystNotifications target only if enabled
@@ -63,9 +65,9 @@ projectContent=projectContent.replace(/(C99974342E97D56900C25611 \/\* CatalystCo
 projectContent=projectContent.replace(/(C99974342E97D56900C25611 \/\* CatalystCore in Frameworks \*\/,)/,`$1\n\t\t\t\t${NOTIF_BUILD_FILE_ID} /* CatalystNotifications in Frameworks */,`);// 3. Add to packageProductDependencies array
 projectContent=projectContent.replace(/(packageProductDependencies = \(\s*C99974332E97D56900C25611 \/\* CatalystCore \*\/,)/,`$1\n\t\t\t\t${NOTIF_PRODUCT_ID} /* CatalystNotifications */,`);// 4. Add to XCSwiftPackageProductDependency section
 projectContent=projectContent.replace(/(\/\* End XCSwiftPackageProductDependency section \*\/)/,`\t\t${NOTIF_PRODUCT_ID} /* CatalystNotifications */ = {\n\t\t\tisa = XCSwiftPackageProductDependency;\n\t\t\tpackage = C99974322E97D56900C25611 /* XCLocalSwiftPackageReference "." */;\n\t\t\tproductName = CatalystNotifications;\n\t\t};\n$1`);fs.writeFileSync(projectFilePath,projectContent,"utf8");progress.log("✅ CatalystNotifications added to Xcode project","success");}else if(!isNotificationsEnabled&&hasNotifications){progress.log("Removing CatalystNotifications from Xcode project","info");// Remove all CatalystNotifications entries
-projectContent=projectContent.replace(/\t\t[A-F0-9]+ \/\* CatalystNotifications in Frameworks \*\/ = {isa = PBXBuildFile; productRef = [A-F0-9]+ \/\* CatalystNotifications \*\/; };\n/g,"");projectContent=projectContent.replace(/\t\t\t\t[A-F0-9]+ \/\* CatalystNotifications in Frameworks \*\/,\n/g,"");projectContent=projectContent.replace(/\t\t\t\t[A-F0-9]+ \/\* CatalystNotifications \*\/,\n/g,"");projectContent=projectContent.replace(/\t\t[A-F0-9]+ \/\* CatalystNotifications \*\/ = {\n\t\t\tisa = XCSwiftPackageProductDependency;\n\t\t\tpackage = [A-F0-9]+ \/\* XCLocalSwiftPackageReference "." \*\/;\n\t\t\tproductName = CatalystNotifications;\n\t\t};\n/g,"");fs.writeFileSync(projectFilePath,projectContent,"utf8");progress.log("✅ CatalystNotifications removed from Xcode project","success");}else{progress.log("Package dependencies already correct","info");}}catch(error){progress.log(`❌ Failed to update package dependencies: ${error.message}`,"error");throw error;}}async function updateInfoPlist(){try{const infoPlistPath=path.join(PROJECT_DIR,PROJECT_NAME,"Info.plist");if(fs.existsSync(infoPlistPath)){let plistContent=fs.readFileSync(infoPlistPath,"utf8");// Add CFBundleDisplayName if it doesn't exist
-if(!plistContent.includes("CFBundleDisplayName")){const insertPoint=plistContent.lastIndexOf("</dict>");const newEntry=`\t<key>CFBundleDisplayName</key>\n\t<string>${iosConfig.appName||"Catalyst Application"}</string>\n`;plistContent=plistContent.slice(0,insertPoint)+newEntry+plistContent.slice(insertPoint);fs.writeFileSync(infoPlistPath,plistContent,"utf8");}else{// Update existing CFBundleDisplayName with new appName
-const displayNameRegex=/(<key>CFBundleDisplayName<\/key>\s*<string>)([^<]*)(<\/string>)/;if(displayNameRegex.test(plistContent)){plistContent=plistContent.replace(displayNameRegex,`$1${iosConfig.appName||"Catalyst Application"}$3`);fs.writeFileSync(infoPlistPath,plistContent,"utf8");}}}}catch(err){progress.fail("config",err);process.exit(1);}}// Function to convert JSON value to Swift property
+projectContent=projectContent.replace(/\t\t[A-F0-9]+ \/\* CatalystNotifications in Frameworks \*\/ = {isa = PBXBuildFile; productRef = [A-F0-9]+ \/\* CatalystNotifications \*\/; };\n/g,"");projectContent=projectContent.replace(/\t\t\t\t[A-F0-9]+ \/\* CatalystNotifications in Frameworks \*\/,\n/g,"");projectContent=projectContent.replace(/\t\t\t\t[A-F0-9]+ \/\* CatalystNotifications \*\/,\n/g,"");projectContent=projectContent.replace(/\t\t[A-F0-9]+ \/\* CatalystNotifications \*\/ = {\n\t\t\tisa = XCSwiftPackageProductDependency;\n\t\t\tpackage = [A-F0-9]+ \/\* XCLocalSwiftPackageReference "." \*\/;\n\t\t\tproductName = CatalystNotifications;\n\t\t};\n/g,"");fs.writeFileSync(projectFilePath,projectContent,"utf8");progress.log("✅ CatalystNotifications removed from Xcode project","success");}else{progress.log("Package dependencies already correct","info");}}catch(error){progress.log(`❌ Failed to update package dependencies: ${error.message}`,"error");throw error;}}async function updateInfoPlist(){try{const infoPlistPath=path.join(PROJECT_DIR,PROJECT_NAME,"Info.plist");const infoReleasePlistPath=path.join(PROJECT_DIR,PROJECT_NAME,"Info-Release.plist");const googleServicesPlistPath=path.join(PROJECT_DIR,PROJECT_NAME,GOOGLE_SERVICES_FILENAME);const googleClientId=WEBVIEW_CONFIG.googleSignIn?.clientId||WEBVIEW_CONFIG.googleSignIn?.webClientId||"";const iosClientId=WEBVIEW_CONFIG.googleSignIn?.iosClientId||"";const googleServicesContent=fs.existsSync(googleServicesPlistPath)?fs.readFileSync(googleServicesPlistPath,"utf8"):null;const reversedClientIdFromServices=googleServicesContent?(googleServicesContent.match(/<key>REVERSED_CLIENT_ID<\/key>\s*<string>([^<]+)<\/string>/)||[])[1]:null;const clientIdFromServices=googleServicesContent?(googleServicesContent.match(/<key>CLIENT_ID<\/key>\s*<string>([^<]+)<\/string>/)||[])[1]:null;const computeReversed=value=>{if(!value)return"";return value.split(".").reverse().join(".");};const resolvedClientIdForScheme=iosClientId||googleClientId||clientIdFromServices||"";const resolvedReversedClientId=reversedClientIdFromServices||computeReversed(resolvedClientIdForScheme);if(isGoogleSignInEnabled&&!resolvedReversedClientId){progress.fail("config","Google Sign-In enabled but no valid clientId found");process.exit(1);}const plistTargets=[infoPlistPath,infoReleasePlistPath];const findMatchingArrayCloseTag=(content,arrayStartIndex)=>{if(arrayStartIndex<0)return-1;const tokenRegex=/<array>|<\/array>/g;tokenRegex.lastIndex=arrayStartIndex;let depth=0;let match;while((match=tokenRegex.exec(content))!==null){if(match[0]==="<array>"){depth+=1;}else{depth-=1;if(depth===0){return match.index;}}}return-1;};const ensureGoogleUrlScheme=plistPath=>{if(!isGoogleSignInEnabled||!resolvedReversedClientId){return;}if(!fs.existsSync(plistPath)){return;}let plistContent=fs.readFileSync(plistPath,"utf8");if(plistContent.includes(resolvedReversedClientId)){return;}const urlTypeEntry=`\n\t<key>CFBundleURLTypes</key>\n\t<array>\n\t\t<dict>\n\t\t\t<key>CFBundleURLName</key>\n\t\t\t<string>googleSignIn</string>\n\t\t\t<key>CFBundleURLSchemes</key>\n\t\t\t<array>\n\t\t\t\t<string>${resolvedReversedClientId}</string>\n\t\t\t</array>\n\t\t</dict>\n\t</array>\n`;const urlTypeDictEntry=`\n\t\t<dict>\n\t\t\t<key>CFBundleURLName</key>\n\t\t\t<string>googleSignIn</string>\n\t\t\t<key>CFBundleURLSchemes</key>\n\t\t\t<array>\n\t\t\t\t<string>${resolvedReversedClientId}</string>\n\t\t\t</array>\n\t\t</dict>\n`;if(plistContent.includes("<key>CFBundleURLTypes</key>")){const urlTypesKeyIndex=plistContent.indexOf("<key>CFBundleURLTypes</key>");const urlTypesArrayStart=plistContent.indexOf("<array>",urlTypesKeyIndex);const urlTypesArrayClose=findMatchingArrayCloseTag(plistContent,urlTypesArrayStart);if(urlTypesArrayStart>=0&&urlTypesArrayClose>=0){plistContent=plistContent.slice(0,urlTypesArrayClose)+urlTypeDictEntry+plistContent.slice(urlTypesArrayClose);}else{const insertPoint=plistContent.lastIndexOf("</dict>");plistContent=plistContent.slice(0,insertPoint)+urlTypeEntry+plistContent.slice(insertPoint);progress.log(`CFBundleURLTypes block could not be parsed in ${path.basename(plistPath)}; appended block instead`,"warning");}}else{const insertPoint=plistContent.lastIndexOf("</dict>");plistContent=plistContent.slice(0,insertPoint)+urlTypeEntry+plistContent.slice(insertPoint);}fs.writeFileSync(plistPath,plistContent,"utf8");progress.log(`Added Google Sign-In URL scheme to ${path.basename(plistPath)}`,"info");};const ensureLSApplicationQueriesSchemes=plistPath=>{if(!isGoogleSignInEnabled||!resolvedReversedClientId){return;}if(!fs.existsSync(plistPath)){return;}let plistContent=fs.readFileSync(plistPath,"utf8");const matches=plistContent.match(/<key>LSApplicationQueriesSchemes<\/key>\s*<array>([\s\S]*?)<\/array>/);const existingSchemes=new Set();if(matches&&matches[1]){const schemeRegex=/<string>([^<]+)<\/string>/g;let match;while((match=schemeRegex.exec(matches[1]))!==null){existingSchemes.add(match[1]);}}const targetSchemes=["google",resolvedReversedClientId];targetSchemes.forEach(scheme=>{if(scheme&&!existingSchemes.has(scheme)){existingSchemes.add(scheme);}});const schemesArrayContent=Array.from(existingSchemes).map(s=>`\n\t\t<string>${s}</string>`).join("");const newLSBlock=`\n\t<key>LSApplicationQueriesSchemes</key>\n\t<array>${schemesArrayContent}\n\t</array>\n`;if(matches){plistContent=plistContent.replace(/<key>LSApplicationQueriesSchemes<\/key>\s*<array>[\s\S]*?<\/array>/,newLSBlock.trimEnd());}else{const insertPoint=plistContent.lastIndexOf("</dict>");plistContent=plistContent.slice(0,insertPoint)+newLSBlock+plistContent.slice(insertPoint);}fs.writeFileSync(plistPath,plistContent,"utf8");progress.log(`Ensured LSApplicationQueriesSchemes for Google in ${path.basename(plistPath)}`,"info");};const ensureDisplayName=plistPath=>{if(!fs.existsSync(plistPath))return;let plistContent=fs.readFileSync(plistPath,"utf8");// Add CFBundleDisplayName if it doesn't exist
+if(!plistContent.includes("CFBundleDisplayName")){const insertPoint=plistContent.lastIndexOf("</dict>");const newEntry=`\t<key>CFBundleDisplayName</key>\n\t<string>${iosConfig.appName||"Catalyst Application"}</string>\n`;plistContent=plistContent.slice(0,insertPoint)+newEntry+plistContent.slice(insertPoint);fs.writeFileSync(plistPath,plistContent,"utf8");}else{// Update existing CFBundleDisplayName with new appName
+const displayNameRegex=/(<key>CFBundleDisplayName<\/key>\s*<string>)([^<]*)(<\/string>)/;if(displayNameRegex.test(plistContent)){plistContent=plistContent.replace(displayNameRegex,`$1${iosConfig.appName||"Catalyst Application"}$3`);fs.writeFileSync(plistPath,plistContent,"utf8");}}};plistTargets.forEach(plistPath=>{ensureDisplayName(plistPath);ensureGoogleUrlScheme(plistPath);ensureLSApplicationQueriesSchemes(plistPath);});}catch(err){progress.fail("config",err);process.exit(1);}}// Function to convert JSON value to Swift property
 function generateSwiftProperty(key,value,indent="    "){if(value===null||value===undefined){return`${indent}public static let ${key}: String? = nil`;}// Special handling for cachePattern - always convert to array
 if(key==="cachePattern"){if(typeof value==="string"){// Convert single string to array
 return`${indent}public static let ${key}: [String] = ["${value}"]`;}else if(Array.isArray(value)){const arrayValues=value.map(v=>`"${v}"`).join(", ");return`${indent}public static let ${key}: [String] = [${arrayValues}]`;}}if(typeof value==="string"){return`${indent}public static let ${key} = "${value}"`;}if(typeof value==="number"){return Number.isInteger(value)?`${indent}public static let ${key} = ${value}`:`${indent}public static let ${key} = ${value}`;}if(typeof value==="boolean"){return`${indent}public static let ${key} = ${value}`;}if(Array.isArray(value)){if(value.length===0){return`${indent}public static let ${key}: [String] = []`;}// Determine array type from first element
@@ -112,7 +114,8 @@ const imageWidth=splashConfig.imageWidth||120;const imageHeight=splashConfig.ima
     public static let splashScreenImageWidth: CGFloat = 120
     public static let splashScreenImageHeight: CGFloat = 120
     public static let splashScreenCornerRadius: CGFloat = 20`;}// Ensure Notifications.enabled always exists (default to false if not configured)
-if(!addedKeys.has("notifications")){progress.log("Notifications not found in config, adding default (false)","info");configContent+="\n    public enum Notifications {\n        public static let enabled = false\n    }";addedKeys.add("notifications");}else{progress.log("Notifications config was processed from WEBVIEW_CONFIG","info");}// Ensure EdgeToEdge.enabled always exists (default to false if not configured)
+if(!addedKeys.has("notifications")){progress.log("Notifications not found in config, adding default (false)","info");configContent+="\n    public enum Notifications {\n        public static let enabled = false\n    }";addedKeys.add("notifications");}else{progress.log("Notifications config was processed from WEBVIEW_CONFIG","info");}// Ensure Google Sign-In defaults exist to keep compile-time references stable
+if(!addedKeys.has("googleSignIn")){progress.log("Google Sign-In not found in config, adding defaults (disabled)","info");configContent+='\n    public enum GoogleSignIn {\n        public static let enabled = false\n        public static let clientId = ""\n        public static let iosClientId = ""\n    }';addedKeys.add("googleSignIn");}// Ensure EdgeToEdge.enabled always exists (default to false if not configured)
 if(!addedKeys.has("edgeToEdge")){progress.log("EdgeToEdge not found in config, adding default (false)","info");configContent+="\n    public enum EdgeToEdge {\n        public static let enabled = false\n    }";addedKeys.add("edgeToEdge");}else{progress.log("EdgeToEdge config was processed from WEBVIEW_CONFIG","info");}// Close the enum
 configContent+=`
 }`;fs.writeFileSync(appConfigPath,configContent,"utf8");progress.log("Configuration constants generated successfully (SPM Package)","success");progress.complete("config");}catch(error){progress.fail("config",error.message);process.exit(1);}}// MARK: - Notification Asset Processing

package/dist/native/iosnativeWebView/Package.swift

@@ -3,6 +3,7 @@
 // This minimal version allows Xcode to open the project without resolving Firebase
 import PackageDescription
 
+// TODO: haven't made this conditional yet
 let package = Package(
     name: "iosnativeWebView",
     platforms: [.iOS(.v17)],
@@ -10,7 +11,8 @@ let package = Package(
         .library(name: "CatalystCore", targets: ["CatalystCore"])
     ],
     dependencies: [
-        .package(url: "https://github.com/kylef/JSONSchema.swift", from: "0.6.0")
+        .package(url: "https://github.com/kylef/JSONSchema.swift", from: "0.6.0"),
+        .package(url: "https://github.com/google/GoogleSignIn-iOS", from: "7.0.0")
     ],
     targets: [
         // Core functionality (WebView, bridge, utils, constants)
@@ -18,7 +20,8 @@ let package = Package(
         .target(
             name: "CatalystCore",
             dependencies: [
-                .product(name: "JSONSchema", package: "JSONSchema.swift")
+                .product(name: "JSONSchema", package: "JSONSchema.swift"),
+                .product(name: "GoogleSignIn", package: "GoogleSignIn-iOS")
             ],
             path: "Sources/Core"
         )

package/dist/native/iosnativeWebView/Sources/CatalystNotifications/NotificationManager.swift

@@ -296,4 +296,4 @@ class NotificationChannelManager {
     static func getChannelConfig(_ channelId: String) -> NotificationChannel {
         return NotificationChannel(rawValue: channelId) ?? .default
     }
-}
+}

package/dist/native/iosnativeWebView/Sources/Core/Constants/CatalystConstants.swift

@@ -65,6 +65,7 @@ public enum CatalystConstants {
                 "pickFile",
                 "openFileWithIntent",
                 "requestHapticFeedback",
+                "googleSignIn",
                 "getSafeArea"
             ]
 
@@ -85,6 +86,8 @@ public enum CatalystConstants {
                 print("❌ DEBUG: Notifications disabled in config - notification commands not available")
             }
 
+            print("🔐 DEBUG: Google Sign-In enabled in config? \(ConfigConstants.GoogleSignIn.enabled)")
+
             print("🔧 DEBUG: Valid commands available: \(commands.sorted().joined(separator: ", "))")
             return commands
         }

package/dist/native/iosnativeWebView/Sources/Core/Constants/ConfigConstants.swift

@@ -12,6 +12,13 @@ public enum ConfigConstants {
     public enum Notifications {
         public static let enabled = false
     }
+    
+    // Google Sign-In configuration (defaults to disabled, populated during build)
+    public enum GoogleSignIn {
+        public static let enabled = false
+        public static let clientId = ""
+        public static let iosClientId = ""
+    }
 
     // Access control configuration
     public static let accessControlEnabled = false

package/dist/native/iosnativeWebView/Sources/Core/WebView/BridgeCommandHandler.swift

@@ -11,6 +11,9 @@ import UIKit
 import AVFoundation
 import os
 import UserNotifications
+#if canImport(GoogleSignIn)
+import GoogleSignIn
+#endif
 
 private let commandLogger = Logger(subsystem: Bundle.main.bundleIdentifier ?? "com.app", category: CatalystConstants.Logging.Categories.commandHandler)
 
@@ -33,6 +36,81 @@ class BridgeCommandHandler {
 
     // Notification handler - injected, defaults to null implementation
     private var notificationHandler: NotificationHandlerProtocol = NullNotificationHandler.shared
+    private var isGoogleSignInInProgress = false
+    private var hasAttemptedGoogleRestore = false
+    private var lastConfiguredGoogleClientId: String?
+
+    private struct GoogleSignInOptions {
+        let clientId: String?
+        let nonce: String?
+        let hint: String?
+        let additionalScopes: [String]?
+        let autoSelect: Bool
+        let filterByAuthorizedAccounts: Bool
+
+        static func from(params: Any?) -> GoogleSignInOptions {
+            if let stringParam = params as? String, !stringParam.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty {
+                if let data = stringParam.data(using: .utf8),
+                   let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any] {
+                    return GoogleSignInOptions.fromDictionary(json)
+                }
+
+                let trimmed = stringParam.trimmingCharacters(in: .whitespacesAndNewlines)
+                return GoogleSignInOptions(
+                    clientId: trimmed,
+                    nonce: nil,
+                    hint: nil,
+                    additionalScopes: nil,
+                    autoSelect: false,
+                    filterByAuthorizedAccounts: false
+                )
+            }
+
+            if let dict = params as? [String: Any] {
+                return GoogleSignInOptions.fromDictionary(dict)
+            }
+
+            return GoogleSignInOptions(
+                clientId: nil,
+                nonce: nil,
+                hint: nil,
+                additionalScopes: nil,
+                autoSelect: false,
+                filterByAuthorizedAccounts: false
+            )
+        }
+
+        private static func fromDictionary(_ dict: [String: Any]) -> GoogleSignInOptions {
+            func clean(_ value: String?) -> String? {
+                guard let value = value?.trimmingCharacters(in: .whitespacesAndNewlines), !value.isEmpty else { return nil }
+                return value
+            }
+
+            let resolvedClientId = clean(dict["clientId"] as? String) ??
+                clean(dict["webClientId"] as? String)
+
+            let nonce = clean(dict["nonce"] as? String)
+            let hint = clean(dict["hint"] as? String ?? dict["email"] as? String)
+            var scopes: [String]?
+
+            if let scopesArray = dict["additionalScopes"] as? [String] {
+                let filtered = scopesArray.compactMap { clean($0) }
+                scopes = filtered.isEmpty ? nil : filtered
+            } else if let scopesString = clean(dict["additionalScopes"] as? String) {
+                let splitScopes = scopesString.split(separator: ",").map { clean(String($0)) }.compactMap { $0 }
+                scopes = splitScopes.isEmpty ? nil : splitScopes
+            }
+
+            return GoogleSignInOptions(
+                clientId: resolvedClientId,
+                nonce: nonce,
+                hint: hint,
+                additionalScopes: scopes,
+                autoSelect: dict["autoSelect"] as? Bool ?? false,
+                filterByAuthorizedAccounts: dict["filterByAuthorizedAccounts"] as? Bool ?? false
+            )
+        }
+    }
 
     init(viewController: UIViewController, imageHandler: ImageHandler, filePickerHandler: FilePickerHandler) {
         self.viewController = viewController
@@ -170,6 +248,139 @@ class BridgeCommandHandler {
         }
     }
 
+    func googleSignIn(params: Any?) {
+        #if canImport(GoogleSignIn)
+        guard ConfigConstants.GoogleSignIn.enabled else {
+            delegate?.sendErrorCallback(
+                eventName: "ON_GOOGLE_SIGN_IN_ERROR",
+                error: "Google Sign-In is disabled in config",
+                code: "GOOGLE_SIGN_IN_ERROR"
+            )
+            return
+        }
+
+        let options = GoogleSignInOptions.from(params: params)
+
+        let resolvedClientId = (options.clientId ?? ConfigConstants.GoogleSignIn.clientId)
+            .trimmingCharacters(in: .whitespacesAndNewlines)
+
+        guard !resolvedClientId.isEmpty else {
+            delegate?.sendErrorCallback(
+                eventName: "ON_GOOGLE_SIGN_IN_ERROR",
+                error: "clientId is required for Google Sign-In",
+                code: "GOOGLE_SIGN_IN_ERROR"
+            )
+            return
+        }
+
+        guard !isGoogleSignInInProgress else {
+            delegate?.sendErrorCallback(
+                eventName: "ON_GOOGLE_SIGN_IN_ERROR",
+                error: "A Google Sign-In request is already in progress",
+                code: "GOOGLE_SIGN_IN_ERROR"
+            )
+            return
+        }
+
+        guard let presentingVC = resolvePresentingViewController() else {
+            delegate?.sendErrorCallback(
+                eventName: "ON_GOOGLE_SIGN_IN_ERROR",
+                error: "No valid view controller available for Google Sign-In",
+                code: "GOOGLE_SIGN_IN_ERROR"
+            )
+            return
+        }
+
+        isGoogleSignInInProgress = true
+        commandLogger.debug("Starting Google Sign-In with clientId prefix: \(resolvedClientId.prefix(12))...")
+
+        configureGoogleSignIn(clientId: resolvedClientId)
+
+        if options.autoSelect || options.filterByAuthorizedAccounts {
+            commandLogger.debug("Google Sign-In options autoSelect/filterByAuthorizedAccounts are not supported on iOS SDK and will be ignored")
+        }
+
+        DispatchQueue.main.async { [weak self] in
+            guard let self = self else { return }
+            GIDSignIn.sharedInstance.signIn(
+                withPresenting: presentingVC,
+                hint: options.hint,
+                additionalScopes: options.additionalScopes
+            ) { [weak self] result, error in
+                guard let self = self else { return }
+                self.isGoogleSignInInProgress = false
+
+                let hasValidUserData = result?.user != nil && result?.user.idToken?.tokenString != nil
+
+                if let error = error as NSError? {
+                    if self.isCancelledGoogleError(error) {
+                        self.delegate?.sendErrorCallback(
+                            eventName: "ON_GOOGLE_SIGN_IN_CANCELLED",
+                            error: "User cancelled Google sign-in",
+                            code: "OPERATION_CANCELLED"
+                        )
+                        return
+                    }
+
+                    let errorDescription = error.localizedDescription.lowercased()
+                    let isKeychainError = errorDescription.contains("keychain")
+
+                    if isKeychainError && hasValidUserData {
+                        commandLogger.warning("Google Sign-In keychain error (common on simulators), but user data is valid: \(error.localizedDescription)")
+                    } else {
+                        commandLogger.error("Google Sign-In error: \(error.localizedDescription)")
+                        self.delegate?.sendErrorCallback(
+                            eventName: "ON_GOOGLE_SIGN_IN_ERROR",
+                            error: error.localizedDescription,
+                            code: "GOOGLE_SIGN_IN_ERROR"
+                        )
+                        return
+                    }
+                }
+
+                guard let user = result?.user, let idToken = user.idToken?.tokenString else {
+                    self.delegate?.sendErrorCallback(
+                        eventName: "ON_GOOGLE_SIGN_IN_ERROR",
+                        error: "No ID token returned from Google sign-in",
+                        code: "GOOGLE_SIGN_IN_ERROR"
+                    )
+                    return
+                }
+
+                var payload: [String: Any] = [
+                    "idToken": idToken,
+                    "provider": "google"
+                ]
+
+                if let email = user.profile?.email, !email.isEmpty {
+                    payload["email"] = email
+                }
+
+                if let name = user.profile?.name, !name.isEmpty {
+                    payload["name"] = name
+                }
+
+                if let photoUrl = user.profile?.imageURL(withDimension: 160)?.absoluteString, !photoUrl.isEmpty {
+                    payload["photoUrl"] = photoUrl
+                }
+
+                if let serverAuthCode = result?.serverAuthCode, !serverAuthCode.isEmpty {
+                    payload["serverAuthCode"] = serverAuthCode
+                }
+
+                commandLogger.debug("Google Sign-In success (idToken length: \(idToken.count))")
+                self.delegate?.sendJSONCallback(eventName: "ON_GOOGLE_SIGN_IN_SUCCESS", data: payload)
+            }
+        }
+        #else
+        delegate?.sendErrorCallback(
+            eventName: "ON_GOOGLE_SIGN_IN_ERROR",
+            error: "Google Sign-In SDK not available on this build",
+            code: "GOOGLE_SIGN_IN_UNAVAILABLE"
+        )
+        #endif
+    }
+
     // Get device information
     func getDeviceInfo() {
         commandLogger.debug("getDeviceInfo called")
@@ -641,4 +852,57 @@ class BridgeCommandHandler {
         }
     }
 
+    // MARK: - Helpers
+
+    private func resolvePresentingViewController() -> UIViewController? {
+        if let scene = UIApplication.shared.connectedScenes.first as? UIWindowScene {
+            if let window = scene.windows.first(where: { $0.isKeyWindow }),
+               let rootVC = window.rootViewController {
+                return rootVC.presentedViewController ?? rootVC
+            }
+        }
+
+        return viewController
+    }
+
+    private func configureGoogleSignIn(clientId: String) {
+        guard lastConfiguredGoogleClientId != clientId else { return }
+        lastConfiguredGoogleClientId = clientId
+
+        let iosClientId = ConfigConstants.GoogleSignIn.iosClientId
+        let serverClientId = clientId  // This is the Web Client ID
+        let configClientId = !iosClientId.isEmpty ? iosClientId : serverClientId
+
+        GIDSignIn.sharedInstance.configuration = GIDConfiguration(
+            clientID: configClientId,
+            serverClientID: serverClientId
+        )
+
+        if !hasAttemptedGoogleRestore {
+            hasAttemptedGoogleRestore = true
+            GIDSignIn.sharedInstance.restorePreviousSignIn { user, error in
+                if let error = error {
+                    commandLogger.debug("Google Sign-In restore failed: \(error.localizedDescription)")
+                } else if user != nil {
+                    commandLogger.debug("Google Sign-In restored previous session")
+                } else {
+                    commandLogger.debug("Google Sign-In restore found no previous user")
+                }
+            }
+        }
+    }
+
+    private func isCancelledGoogleError(_ error: NSError) -> Bool {
+        let description = error.localizedDescription.lowercased()
+        if description.contains("cancel") {
+            return true
+        }
+
+        // GIDSignIn cancellation historically uses code -5; keep the check resilient
+        if error.code == -5 {
+            return true
+        }
+
+        return false
+    }
 }

package/dist/native/iosnativeWebView/Sources/Core/WebView/BridgeMessageValidator.swift

@@ -134,6 +134,23 @@ class BridgeMessageValidator {
             "properties": [:],
             "additionalProperties": false
         ],
+        "googleSignIn": [
+            "type": "object",
+            "properties": [
+                "clientId": ["type": "string"],
+                "webClientId": ["type": "string"],
+                "nonce": ["type": "string"],
+                "hint": ["type": "string"],
+                "email": ["type": "string"],
+                "autoSelect": ["type": "boolean"],
+                "filterByAuthorizedAccounts": ["type": "boolean"],
+                "additionalScopes": [
+                    "type": "array",
+                    "items": ["type": "string"]
+                ]
+            ],
+            "additionalProperties": false
+        ],
         // Notification commands
         "requestNotificationPermission": [
             "type": "object",
@@ -345,6 +362,7 @@ class BridgeMessageValidator {
             "getDeviceInfo",
             "getNetworkStatus",
             "logger",
+            "googleSignIn",
             "getSubscribedTopics",
             "requestNotificationPermission",
             "registerForPushNotifications",

package/dist/native/iosnativeWebView/Sources/Core/WebView/NativeBridge.swift

@@ -258,6 +258,8 @@ extension NativeBridge: WKScriptMessageHandler {
         case "requestHapticFeedback":
             let feedbackType = delegateHandler.extractFeedbackType(from: params)
             commandHandler.requestHapticFeedback(feedbackType: feedbackType)
+        case "googleSignIn":
+            commandHandler.googleSignIn(params: params)
 
         // Notification commands (handled via protocol)
         case "requestNotificationPermission":

package/dist/native/iosnativeWebView/iosnativeWebView/AppDelegate.swift

@@ -9,6 +9,9 @@ import UIKit
 import WebKit
 import os
 import CatalystCore
+#if canImport(GoogleSignIn)
+import GoogleSignIn
+#endif
 
 private let logger = Logger(subsystem: Bundle.main.bundleIdentifier ?? "com.app", category: "AppDelegate")
 
@@ -68,4 +71,14 @@ public class AppDelegate: NSObject, UIApplicationDelegate {
             userInfo: ["notification": userInfo, "completion": completionHandler]
         )
     }
+
+    public func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
+        #if canImport(GoogleSignIn)
+        if GIDSignIn.sharedInstance.handle(url) {
+            logWithTimestamp("🔐 Google Sign-In handled openURL callback")
+            return true
+        }
+        #endif
+        return false
+    }
 }

package/dist/native/iosnativeWebView/iosnativeWebView/iosnativeWebView.entitlements

@@ -4,5 +4,9 @@
 <dict>
 	<key>aps-environment</key>
 	<string>development</string>
+	<key>keychain-access-groups</key>
+	<array>
+		<string>$(AppIdentifierPrefix)$(CFBundleIdentifier)</string>
+	</array>
 </dict>
 </plist>

package/dist/native/iosnativeWebView/iosnativeWebView/iosnativeWebViewApp.swift

@@ -9,6 +9,9 @@ import SwiftUI
 import UIKit
 import os
 import CatalystCore
+#if canImport(GoogleSignIn)
+import GoogleSignIn
+#endif
 
 // IMPORTANT: This is the App target, so it CAN import CatalystNotifications safely
 // This does not create a compile-time dependency in CatalystCore
@@ -82,6 +85,13 @@ struct iosnativeWebViewApp: App {
                 .onAppear {
                     logWithTimestamp("🎨 WindowGroup ContentView appeared")
                 }
+                .onOpenURL { url in
+                    #if canImport(GoogleSignIn)
+                    if GIDSignIn.sharedInstance.handle(url) {
+                        logWithTimestamp("🔐 Google Sign-In handled via onOpenURL")
+                    }
+                    #endif
+                }
         }
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "catalyst-core",
-    "version": "0.1.0-canary.3",
+    "version": "0.1.0-canary.4",
     "main": "index.js",
     "description": "Web framework that provides great performance out of the box",
     "bin": {