Add the ability to set preferImmediatelyAvailableCredentials on passkey requests

[jhaven-stytch]

Linear Ticket: No ticket

Changes:

1. Adds the ability to set preferImmediatelyAvailableCredentials on passkey requests
2. Bumps version for publishing

Notes:

• Before, we were explicitly setting this to true on registration requests and not setting it (defaulting to false) on authentication requests. Now, it is configurable by the developer in both flows. Notice that the default values, however, are different between register and authenticate. That is to preserve compatibility with the previous behavior.

Checklist:

• I have verified that this change works in the relevant demo app, or N/A
• I have added or updated any tests relevant to this change, or N/A
• I have updated any relevant README files for this change, or N/A

[chris-stytch]

On iOS we name this boolean preferLocalCredentials, suggest we align both names since they cover the same functionality.

[jhaven-stytch]

I slightly disagree, and think that our iOS SDK is in the wrong here.

preferImmediatelyAvailableCredentials is the actual name of the parameter for both iOS and Android; if someone is reading the documentation for either provider, and trying to implement our SDKs, I think it's better to expose the naming they will be familiar with, instead of hiding it behind a Stytch-specific flag

It would obviously be a larger change, but I would prefer to change the name in iOS (deprecate/rename) than change it here.

But I'm not deadset one way or the other ¯\_(ツ)_/¯

[chris-stytch]

In agreement! I primarily care about alignment here so the devx on both is the same; I have no opinion on the actual name of the flag.

I'm totally comfortable changing iOS if you think this name is more correct (note that would be a breaking change so we'll have to just be button'd up on the changelog).

[jhaven-stytch]

@chris-stytch on iOS, we actually don't pass bools for options like on Android, but instead, explicit ASAuthorizationController.RequestOptions types, and the preferLocalCredentials flag toggles setting the type. Aside from "hiding" the implementation detail that a developer might search for, this is also a little brittle if new RequestOptions are added in the future.

So, what I did on iOS is mark the .default(preferLocalCredentials: Bool) enum case as deprecated with a note to switch to .options([]), where a developer can pass the explicit options they want.

See: stytchauth/stytch-ios#588

[jhaven-stytch]

Code Coverage

Overall Project	71.61% -0.07%	🍏
Files changed	28.57%	❌

File	Coverage
PasskeysImpl.kt	69.32% -2.56%	❌
Passkeys.kt	33.33% -66.67%	❌