feat(react-native): added e2e example and ready-to-use component

Author: EricBorland

client/config.ts

@@ -85,11 +85,28 @@ export interface Config {
    * Overriding history implementation. Default: globalThis.history
    */
   history?: MinimalHistory;
+  /**
+   * Overriding URL implementation. Default: globalThis.URL
+   */
+  URL?: MinimalURL;
+  /**
+   * Overriding TextDecoder implementation. Default: globalThis.TextDecoder
+   */
+  TextDecoder?: MinimalTextDecoder;
 }
 
 export type ConfigWithDefaults = Config &
   Required<
-    Pick<Config, "storage" | "crypto" | "fetch" | "location" | "history">
+    Pick<
+      Config,
+      | "storage"
+      | "crypto"
+      | "fetch"
+      | "location"
+      | "history"
+      | "URL"
+      | "TextDecoder"
+    >
   >;
 
 let config_: ConfigWithDefaults | undefined = undefined;
@@ -102,6 +119,8 @@ export function configure(config?: Config) {
       fetch: config.fetch ?? Defaults.fetch,
       location: config.location ?? Defaults.location,
       history: config.history ?? Defaults.history,
+      URL: config.URL ?? Defaults.URL,
+      TextDecoder: config.TextDecoder ?? Defaults.TextDecoder,
     };
     config_.debug?.("Configuration loaded:", config);
   } else {
@@ -227,6 +246,15 @@ class Defaults {
     if (typeof globalThis.history !== "undefined") return globalThis.history;
     return Defaults.getFailingProxy("history") as MinimalHistory;
   }
+  static get URL(): MinimalURL {
+    if (typeof globalThis.URL !== "undefined") return globalThis.URL;
+    return Defaults.getFailingProxy("URL") as MinimalURL;
+  }
+  static get TextDecoder(): MinimalTextDecoder {
+    if (typeof globalThis.TextDecoder !== "undefined")
+      return globalThis.TextDecoder;
+    return Defaults.getFailingProxy("TextDecoder") as MinimalTextDecoder;
+  }
 }
 
 export interface MinimalResponse {
@@ -263,3 +291,15 @@ export interface MinimalCrypto {
     sign: Crypto["subtle"]["sign"];
   };
 }
+
+export interface MinimalURL {
+  new (url: string): {
+    href: string;
+    hash: string;
+  };
+}
+export interface MinimalTextDecoder {
+  new (): {
+    decode(buffer: Uint8Array): string;
+  };
+}

client/fido2.ts

@@ -314,7 +314,7 @@ export async function fido2UpdateCredential({
   }).then(throwIfNot2xx);
 }
 
-interface Fido2Options {
+export interface Fido2Options {
   challenge: string;
   timeout?: number;
   userVerification?: UserVerificationRequirement;
@@ -351,7 +351,7 @@ function assertIsFido2Options(o: unknown): asserts o is Fido2Options {
   }
 }
 
-async function fido2getCredential({
+export async function fido2getCredential({
   relyingPartyId,
   challenge,
   credentials,
@@ -484,7 +484,7 @@ export function authenticateWithFido2({
   }
   const abort = new AbortController();
   const signedIn = (async () => {
-    const { debug, fido2 } = configure();
+    const { debug, fido2, TextDecoder } = configure();
     if (!fido2) {
       throw new Error("Missing Fido2 config");
     }

client/magic-link.ts

@@ -101,11 +101,11 @@ export const requestSignInLink = ({
 
 const failedFragmentIdentifieres = new Set<string>();
 function checkCurrentLocationForSignInLink() {
-  const { debug, location } = configure();
+  const { debug, location, URL } = configure();
   let url: URL;
   let fragmentIdentifier: string;
   try {
-    url = new URL(location.href);
+    url = new URL(location.href) as URL;
     fragmentIdentifier = url.hash?.slice(1);
     if (!fragmentIdentifier) {
       debug?.(