feat(PSG-3836): users can register with passkey creation options

Author: rickycpadilla

android/src/main/java/com/passagereactnative/PassageReactNativeModule.kt

@@ -4,6 +4,7 @@ import android.os.Build
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.bridge.ReactContextBaseJavaModule
 import com.facebook.react.bridge.ReactMethod
+import com.facebook.react.bridge.ReadableMap
 import com.facebook.react.bridge.Promise
 import kotlinx.coroutines.CoroutineScope
 import kotlinx.coroutines.Dispatchers
@@ -12,11 +13,13 @@ import com.google.gson.Gson
 import id.passage.android.Passage
 import id.passage.android.PassageSocialConnection
 import id.passage.android.PassageToken
+import id.passage.android.PasskeyCreationOptions
 import id.passage.android.exceptions.AddDevicePasskeyCancellationException
 import id.passage.android.exceptions.LoginWithPasskeyCancellationException
 import id.passage.android.exceptions.OneTimePasscodeActivateExceededAttemptsException
 import id.passage.android.exceptions.PassageUserUnauthorizedException
 import id.passage.android.exceptions.RegisterWithPasskeyCancellationException
+import id.passage.android.model.AuthenticatorAttachment
 
 @Suppress("unused")
 class PassageReactNativeModule(reactContext: ReactApplicationContext) :
@@ -45,10 +48,16 @@ class PassageReactNativeModule(reactContext: ReactApplicationContext) :
   // region PASSKEY METHODS
 
   @ReactMethod
-  fun registerWithPasskey(identifier: String, promise: Promise) {
+  fun registerWithPasskey(identifier: String, optionsMap: ReadableMap?, promise: Promise) {
     CoroutineScope(Dispatchers.IO).launch {
       try {
-        val authResult = passage.registerWithPasskey(identifier)
+        var options: PasskeyCreationOptions? = null
+        optionsMap?.getString("authenticatorAttachment")?.let {
+          AuthenticatorAttachment.decode(it)?.let {
+            options = PasskeyCreationOptions(it)
+          }
+        }
+        val authResult = passage.registerWithPasskey(identifier, options)
         val jsonString = Gson().toJson(authResult)
         promise.resolve(jsonString)
       } catch (e: Exception) {

ios/PassageReactNative.m

@@ -8,6 +8,7 @@ @interface RCT_EXTERN_MODULE(PassageReactNative, NSObject)
 
 // MARK: - Passkey Methods
 RCT_EXTERN_METHOD(registerWithPasskey:(NSString *)identifier
+                  withOptionsDictionary:( nullable NSDictionary *)optionsDictionary
                   withResolver:(RCTPromiseResolveBlock)resolve
                   withRejecter:(RCTPromiseRejectBlock)reject);
 

ios/PassageReactNative.swift

@@ -24,9 +24,10 @@ class PassageReactNative: NSObject {
 
     // MARK: - Passkey Methods
 
-    @objc(registerWithPasskey:withResolver:withRejecter:)
+    @objc(registerWithPasskey:withOptionsDictionary:withResolver:withRejecter:)
     func registerWithPasskey(
         identifier: String,
+        optionsDictionary: NSDictionary?,
         resolve: @escaping RCTPromiseResolveBlock,
         reject: @escaping RCTPromiseRejectBlock
     ) -> Void {
@@ -36,7 +37,13 @@ class PassageReactNative: NSObject {
         }
         Task {
             do {
-                let authResult = try await passage.registerWithPasskey(identifier: identifier)
+                var passkeyCreationOptions: PasskeyCreationOptions?
+                if let authenticatorAttachmentString = optionsDictionary?["authenticatorAttachment"] as? String,
+                   let authenticatorAttachment = AuthenticatorAttachment(rawValue: authenticatorAttachmentString)
+                {
+                    passkeyCreationOptions = PasskeyCreationOptions(authenticatorAttachment: authenticatorAttachment)
+                }
+                let authResult = try await passage.registerWithPasskey(identifier: identifier, options: passkeyCreationOptions)
                 resolve(authResult.toJsonString())
             } catch PassageASAuthorizationError.canceled {
                 reject("USER_CANCELLED", "User cancelled interaction", nil)

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@passageidentity/passage-react-native",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "description": "Native passkey authentication for your React Native app",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",

src/index.tsx

@@ -132,6 +132,16 @@ export type EmailAndSMSAuthMethod = {
   ttl_display_unit: DisplayUnit;
 };
 
+export enum AuthenticatorAttachment {
+  Platform = 'platform',
+  CrossPlatform = 'cross-platform',
+  Any = 'any',
+}
+
+export interface PasskeyCreationOptions {
+  authenticatorAttachment?: AuthenticatorAttachment;
+}
+
 export enum DisplayUnit {
   Seconds = 's',
   Minutes = 'm',
@@ -145,7 +155,10 @@ export enum SocialConnection {
   Google = 'google',
 }
 
-type RegisterWithPasskey = (identifier: string) => Promise<AuthResult>;
+type RegisterWithPasskey = (
+  identifier: string,
+  options?: PasskeyCreationOptions
+) => Promise<AuthResult>;
 type LoginWithPasskey = (identifier?: string | null) => Promise<AuthResult>;
 type DeviceSupportsPasskeys = () => Promise<boolean>;
 type AuthWithoutPasskey = (identifier: string) => Promise<string>;
@@ -195,10 +208,14 @@ class Passage {
    * @throws {PassageError} When user cancels operation, user already exists, app configuration was not done properly, etc.
    */
   registerWithPasskey: RegisterWithPasskey = async (
-    identifier: string
+    identifier: string,
+    options?: PasskeyCreationOptions
   ): Promise<AuthResult> => {
     try {
-      const result = await PassageReactNative.registerWithPasskey(identifier);
+      const result = await PassageReactNative.registerWithPasskey(
+        identifier,
+        options || null
+      );
       const parsedResult = JSON.parse(result);
       return parsedResult;
     } catch (error: any) {
@@ -220,7 +237,9 @@ class Passage {
     identifier?: string | null
   ): Promise<AuthResult> => {
     try {
-      const result = await PassageReactNative.loginWithPasskey(identifier || null);
+      const result = await PassageReactNative.loginWithPasskey(
+        identifier || null
+      );
       const parsedResult = JSON.parse(result);
       return parsedResult;
     } catch (error: any) {