react-native-credentials-manager 0.5.3 → 0.6.0

package/lib/typescript/module/src/index.d.ts

@@ -1,19 +1,25 @@
-import type { Credential, GoogleCredential, SignInOption } from './NativeCredentialsManager';
+import type { Credential, GoogleCredential, AppleCredential, SignInOption } from './NativeCredentialsManager';
 type GoogleSignInParams = {
     nonce?: string;
     serverClientId: string;
     autoSelectEnabled?: boolean;
 };
+type AppleSignInParams = {
+    nonce?: string;
+    requestedScopes?: ('fullName' | 'email')[];
+};
 export declare function signUpWithPasskeys(requestJson: Object, preferImmediatelyAvailableCredentials?: boolean): Promise<Object>;
 export declare function signUpWithPassword({ username, password, }: {
     username: string;
     password: string;
-}): void;
+}): Promise<Object>;
 export declare function signIn(options: SignInOption[], params: {
     passkeys?: Object;
     googleSignIn?: GoogleSignInParams;
+    appleSignIn?: AppleSignInParams;
 }): Promise<Credential>;
-export declare function signUpWithGoogle(params: GoogleSignInParams): Promise<GoogleCredential>;
+export declare function signUpWithGoogle(params: GoogleSignInParams): Promise<GoogleCredential | AppleCredential>;
+export declare function signUpWithApple(params?: AppleSignInParams): Promise<AppleCredential>;
 export declare function signOut(): Promise<null>;
-export {};
+export type { Credential, GoogleCredential, AppleCredential, SignInOption, GoogleSignInParams, AppleSignInParams, };
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,YAAY,EACb,MAAM,4BAA4B,CAAC;AAEpC,KAAK,kBAAkB,GAAG;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,qCAAqC,GAAE,OAAe,GACrD,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,QAEA;AAED,wBAAgB,MAAM,CACpB,OAAO,EAAE,YAAY,EAAE,EACvB,MAAM,EAAE;IACN,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC,GACA,OAAO,CAAC,UAAU,CAAC,CASrB;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAM3B;AAED,wBAAgB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAEvC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,YAAY,EACb,MAAM,4BAA4B,CAAC;AAGpC,KAAK,kBAAkB,GAAG;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,CAAC,UAAU,GAAG,OAAO,CAAC,EAAE,CAAC;CAC5C,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,qCAAqC,GAAE,OAAe,GACrD,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,MAAM,CAAC,CAWlB;AAED,wBAAgB,MAAM,CACpB,OAAO,EAAE,YAAY,EAAE,EACvB,MAAM,EAAE;IACN,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC,GACA,OAAO,CAAC,UAAU,CAAC,CAgCrB;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,gBAAgB,GAAG,eAAe,CAAC,CAe7C;AAED,wBAAgB,eAAe,CAC7B,MAAM,GAAE,iBAAsB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAc1B;AAED,wBAAgB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAEvC;AAGD,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,GAClB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-credentials-manager",
-  "version": "0.5.3",
+  "version": "0.6.0",
   "description": "A React Native library that implements the Credential Manager API for Android. This library allows you to manage passwords and passkeys in your React Native applications.",
   "source": "./src/index.tsx",
   "main": "./lib/commonjs/index.js",

package/react-native-credentials-manager.podspec

@@ -11,12 +11,15 @@ Pod::Spec.new do |s|
   s.license      = package["license"]
   s.authors      = package["author"]
 
-  s.platforms    = { :ios => min_ios_version_supported }
+  s.platforms    = { :ios => "15.1" }
   s.source       = { :git => "https://github.com/benjamineruvieru/react-native-credentials-manager.git", :tag => "#{s.version}" }
 
   s.source_files = "ios/**/*.{h,m,mm,cpp}"
   s.private_header_files = "ios/generated/**/*.h"
 
+  # iOS frameworks for credential management
+  s.frameworks = 'AuthenticationServices', 'LocalAuthentication', 'Security'
+
   # Use install_modules_dependencies helper to install the dependencies if React Native version >=0.71.0.
   # See https://github.com/facebook/react-native/blob/febf6b7f33fdb4904669f99d795eba4c0f95d7bf/scripts/cocoapods/new_architecture.rb#L79.
   if respond_to?(:install_modules_dependencies, true)

package/react-native.config.js

@@ -7,7 +7,6 @@ module.exports = {
       android: {
         cmakeListsPath: 'generated/jni/CMakeLists.txt',
       },
-      ios: null,
     },
   },
 };

package/src/NativeCredentialsManager.ts

@@ -1,18 +1,31 @@
 import type { TurboModule } from 'react-native';
 import { TurboModuleRegistry } from 'react-native';
 
-export type SignInOption = 'passkeys' | 'password' | 'google-signin';
+export type SignInOption =
+  | 'passkeys'
+  | 'password'
+  | 'google-signin'
+  | 'apple-signin';
 
+// Password authentication types
 type CredObject = {
   username: string;
   password: string;
 };
 
+type PasswordCredential = {
+  type: 'password';
+  username: string;
+  password: string;
+};
+
+// Passkey authentication types
 type PasskeyCredential = {
   type: 'passkey';
   authenticationResponseJson: string;
 };
 
+// Google Sign In types
 type GoogleSignInParams = {
   nonce: string;
   serverClientId: string;
@@ -30,32 +43,78 @@ export type GoogleCredential = {
   phoneNumber?: string;
 };
 
-type PasswordCredential = {
-  type: 'password';
-  username: string;
-  password: string;
+// Apple Sign In types
+type AppleSignInParams = {
+  nonce: string;
+  requestedScopes: string[];
 };
 
+export type AppleCredential = {
+  type: 'apple-signin';
+  id: string;
+  idToken: string;
+  displayName?: string;
+  familyName?: string;
+  givenName?: string;
+  email?: string;
+};
+
+// Combined credential type
 export type Credential =
   | PasskeyCredential
   | PasswordCredential
-  | GoogleCredential;
+  | GoogleCredential
+  | AppleCredential;
 
+// Native module interface
 export interface Spec extends TurboModule {
+  /**
+   * Sign up with passkeys (supported on both Android and iOS)
+   * @param requestJson WebAuthn request object
+   * @param preferImmediatelyAvailableCredentials Android-specific parameter, ignored on iOS
+   */
   signUpWithPasskeys(
     requestJson: Object,
     preferImmediatelyAvailableCredentials: boolean
   ): Promise<Object>;
-  signUpWithPassword(credObject: CredObject): void;
 
+  /**
+   * Sign up with password (Android only - not supported on iOS)
+   * iOS will reject with UNSUPPORTED_OPERATION error
+   */
+  signUpWithPassword(credObject: CredObject): Promise<Object>;
+
+  /**
+   * Sign in with various methods
+   * - 'passkeys': Supported on both platforms
+   * - 'password': Supported on both platforms (uses AutoFill)
+   * - 'google-signin': Android only
+   * - 'apple-signin': iOS only (not available on Android)
+   */
   signIn(
     options: SignInOption[],
     params: {
       passkeys?: Object;
-      googleSignIn?: GoogleSignInParams;
+      googleSignIn?: GoogleSignInParams; // Used only on Android
+      appleSignIn?: AppleSignInParams; // Used only on iOS
     }
   ): Promise<Credential>;
+
+  /**
+   * Sign up with Google (Android-specific implementation)
+   */
   signUpWithGoogle(params: GoogleSignInParams): Promise<GoogleCredential>;
+
+  /**
+   * Sign up with Apple (iOS-specific implementation)
+   * Will reject with UNSUPPORTED_OPERATION on Android
+   */
+  signUpWithApple(params: AppleSignInParams): Promise<AppleCredential>;
+
+  /**
+   * Sign out (behavior varies by platform)
+   * On iOS, this is a no-op as AuthenticationServices doesn't provide a sign-out method
+   */
   signOut(): Promise<null>;
 }
 

package/src/index.tsx

@@ -2,8 +2,10 @@ import CredentialsManager from './NativeCredentialsManager';
 import type {
   Credential,
   GoogleCredential,
+  AppleCredential,
   SignInOption,
 } from './NativeCredentialsManager';
+import { Platform } from 'react-native';
 
 type GoogleSignInParams = {
   nonce?: string;
@@ -11,6 +13,11 @@ type GoogleSignInParams = {
   autoSelectEnabled?: boolean;
 };
 
+type AppleSignInParams = {
+  nonce?: string;
+  requestedScopes?: ('fullName' | 'email')[];
+};
+
 export function signUpWithPasskeys(
   requestJson: Object,
   preferImmediatelyAvailableCredentials: boolean = false
@@ -27,8 +34,17 @@ export function signUpWithPassword({
 }: {
   username: string;
   password: string;
-}) {
-  CredentialsManager.signUpWithPassword({ password, username });
+}): Promise<Object> {
+  if (Platform.OS === 'ios') {
+    // iOS only supports AutoFill passwords through Apple's Authentication Services
+    // Manual password storage is not supported
+    return Promise.reject(
+      new Error(
+        'Manual password storage is not supported on iOS. Use AutoFill passwords through signIn method instead.'
+      )
+    );
+  }
+  return CredentialsManager.signUpWithPassword({ password, username });
 }
 
 export function signIn(
@@ -36,21 +52,54 @@ export function signIn(
   params: {
     passkeys?: Object;
     googleSignIn?: GoogleSignInParams;
+    appleSignIn?: AppleSignInParams;
   }
 ): Promise<Credential> {
-  return CredentialsManager.signIn(options, {
+  // Transform options for iOS compatibility
+  const processedOptions = options.map((option) => {
+    if (option === 'google-signin' && Platform.OS === 'ios') {
+      // Automatically replace google-signin with apple-signin on iOS
+      return 'apple-signin';
+    }
+    return option;
+  });
+
+  // Prepare parameters for both platforms
+  const signInParams: any = {
     ...params,
     googleSignIn: {
       serverClientId: params?.googleSignIn?.serverClientId ?? '',
       nonce: params?.googleSignIn?.nonce ?? '',
       autoSelectEnabled: params?.googleSignIn?.autoSelectEnabled ?? true,
     },
-  });
+  };
+
+  // If we have Apple Sign In option on iOS, add Apple params
+  if (Platform.OS === 'ios' && processedOptions.includes('apple-signin')) {
+    signInParams.appleSignIn = {
+      nonce: params?.appleSignIn?.nonce || params?.googleSignIn?.nonce || '',
+      requestedScopes: params?.appleSignIn?.requestedScopes || [
+        'fullName',
+        'email',
+      ],
+    };
+  }
+
+  return CredentialsManager.signIn(processedOptions, signInParams);
 }
 
 export function signUpWithGoogle(
   params: GoogleSignInParams
-): Promise<GoogleCredential> {
+): Promise<GoogleCredential | AppleCredential> {
+  if (Platform.OS === 'ios') {
+    // On iOS, automatically use Apple Sign In instead of Google Sign In
+    // This provides seamless cross-platform compatibility
+    return signUpWithApple({
+      nonce: params.nonce,
+      requestedScopes: ['fullName', 'email'],
+    }) as Promise<AppleCredential>;
+  }
+
   return CredentialsManager.signUpWithGoogle({
     ...params,
     nonce: params.nonce ?? '',
@@ -58,6 +107,34 @@ export function signUpWithGoogle(
   });
 }
 
+export function signUpWithApple(
+  params: AppleSignInParams = {}
+): Promise<AppleCredential> {
+  if (Platform.OS !== 'ios') {
+    return Promise.reject(
+      new Error(
+        'Apple Sign In is only available on iOS. Use signUpWithGoogle on Android.'
+      )
+    );
+  }
+
+  // Call the native signUpWithApple method directly - uses Apple's Authentication Services
+  return CredentialsManager.signUpWithApple({
+    nonce: params.nonce || '',
+    requestedScopes: params.requestedScopes || ['fullName', 'email'],
+  });
+}
+
 export function signOut(): Promise<null> {
   return CredentialsManager.signOut();
 }
+
+// Export types
+export type {
+  Credential,
+  GoogleCredential,
+  AppleCredential,
+  SignInOption,
+  GoogleSignInParams,
+  AppleSignInParams,
+};