@getpara/react-native-wallet 2.12.0 → 2.14.0

package/dist/react-native/ParaMobile.d.ts

@@ -1,4 +1,4 @@
-import { AuthStateSignup, ConstructorOpts, ParaCore, Environment, PlatformUtils } from '@getpara/web-sdk';
+import { AuthStateSignup, ConstructorOpts, ParaCore, Environment, PlatformUtils, EventData } from '@getpara/web-sdk';
 /**
  * Represents a mobile implementation of the Para SDK.
  * @extends ParaCore
@@ -18,7 +18,7 @@ export declare class ParaMobile extends ParaCore {
      */
     constructor(env: Environment | undefined, apiKey: string, relyingPartyId?: string, opts?: ConstructorOpts);
     constructor(apiKey: string, relyingPartyId?: string, opts?: ConstructorOpts);
-    ready(): Promise<void>;
+    setup(): Promise<void>;
     protected getPlatformUtils(): PlatformUtils;
     isPasskeySupported(): Promise<boolean>;
     /**
@@ -34,4 +34,21 @@ export declare class ParaMobile extends ParaCore {
      * @returns {Promise<void>}
      */
     loginWithPasskey(): Promise<void>;
+    /**
+     * Handles a message from an in-app browser (WebView).
+     * Call this from your WebView's `onMessage` callback to bridge portal events
+     * (e.g. TELEGRAM_SUCCESS, FARCASTER_SUCCESS) into the SDK's event system.
+     *
+     * @example
+     * ```tsx
+     * <WebView
+     *   source={{ uri: portalUrl }}
+     *   onMessage={(event) => {
+     *     const data = JSON.parse(event.nativeEvent.data);
+     *     para.handleWebViewMessage(data);
+     *   }}
+     * />
+     * ```
+     */
+    handleWebViewMessage(data: EventData): void;
 }

package/dist/react-native/ParaMobile.js

@@ -99,9 +99,9 @@ export class ParaMobile extends ParaCore {
             }
         }
     }
-    ready() {
+    setup() {
         return __awaiter(this, void 0, void 0, function* () {
-            this.isReady = true;
+            this.isSetup = true;
         });
     }
     getPlatformUtils() {
@@ -261,4 +261,24 @@ export class ParaMobile extends ParaCore {
             });
         });
     }
+    /**
+     * Handles a message from an in-app browser (WebView).
+     * Call this from your WebView's `onMessage` callback to bridge portal events
+     * (e.g. TELEGRAM_SUCCESS, FARCASTER_SUCCESS) into the SDK's event system.
+     *
+     * @example
+     * ```tsx
+     * <WebView
+     *   source={{ uri: portalUrl }}
+     *   onMessage={(event) => {
+     *     const data = JSON.parse(event.nativeEvent.data);
+     *     para.handleWebViewMessage(data);
+     *   }}
+     * />
+     * ```
+     */
+    handleWebViewMessage(data) {
+        var _a, _b;
+        (_b = (_a = this.platformUtils).postMessage) === null || _b === void 0 ? void 0 : _b.call(_a, { data });
+    }
 }

package/dist/react-native/ReactNativeUtils.d.ts

@@ -1,4 +1,4 @@
-import { PlatformUtils, TPregenIdentifierType } from '@getpara/web-sdk';
+import { PlatformUtils, TPregenIdentifierType, EventHandler, EventData } from '@getpara/web-sdk';
 import { Ctx } from '@getpara/web-sdk';
 import { SignatureRes } from '@getpara/web-sdk';
 import { BackupKitEmailProps, TWalletType, SDKType } from '@getpara/user-management-client';
@@ -11,6 +11,24 @@ export declare class ReactNativeUtils implements PlatformUtils {
     sessionStorage: AsyncStorage;
     secureStorage: KeychainStorage;
     isSyncStorage: boolean;
+    private eventHandlers;
+    addEventListener<T = EventData>({ event, handler }: {
+        ctx: Ctx;
+        event: string;
+        handler: EventHandler<T>;
+    }): void;
+    removeEventListener<T = EventData>({ event, handler }: {
+        event: string;
+        handler: EventHandler<T>;
+    }): void;
+    postMessage({ data }: {
+        data: EventData;
+        target?: string;
+    }): void;
+    emitEvent<T = EventData>({ event, data }: {
+        event: string;
+        data: T;
+    }): void;
     generateBlumPrimes(_ctx: Ctx): Promise<{
         p: string;
         q: string;

package/dist/react-native/ReactNativeUtils.js

@@ -52,6 +52,40 @@ export class ReactNativeUtils {
         this.sessionStorage = new AsyncStorage();
         this.secureStorage = new KeychainStorage();
         this.isSyncStorage = false;
+        this.eventHandlers = new Map();
+    }
+    addEventListener({ event, handler }) {
+        if (!this.eventHandlers.has(event)) {
+            this.eventHandlers.set(event, new Set());
+        }
+        this.eventHandlers.get(event).add(handler);
+    }
+    removeEventListener({ event, handler }) {
+        const handlers = this.eventHandlers.get(event);
+        if (handlers) {
+            handlers.delete(handler);
+            if (handlers.size === 0) {
+                this.eventHandlers.delete(event);
+            }
+        }
+    }
+    postMessage({ data }) {
+        var _a, _b;
+        if (data && typeof data === 'object' && 'type' in data) {
+            const event = data.type;
+            (_a = this.eventHandlers.get(event)) === null || _a === void 0 ? void 0 : _a.forEach(h => h(data));
+            // Also notify 'message' catch-all handlers
+            if (event !== 'message') {
+                (_b = this.eventHandlers.get('message')) === null || _b === void 0 ? void 0 : _b.forEach(h => h(data));
+            }
+        }
+    }
+    emitEvent({ event, data }) {
+        const eventData = {
+            type: event,
+            payload: data,
+        };
+        this.postMessage({ data: eventData });
     }
     // only used in web for now, can implement functionality if ever needed for mobile
     generateBlumPrimes(_ctx) {

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@getpara/react-native-wallet",
   "description": "Para Wallet for React Native",
-  "version": "2.12.0",
+  "version": "2.14.0",
   "author": "Para Team <hello@getpara.com> (https://getpara.com)",
   "dependencies": {
-    "@getpara/core-sdk": "2.12.0",
-    "@getpara/user-management-client": "2.12.0",
-    "@getpara/web-sdk": "2.12.0",
+    "@getpara/core-sdk": "2.14.0",
+    "@getpara/user-management-client": "2.14.0",
+    "@getpara/web-sdk": "2.14.0",
     "@peculiar/webcrypto": "^1.5.0",
     "@ungap/structured-clone": "1.3.0",
     "react-native-url-polyfill": "2.0.0",
@@ -92,5 +92,5 @@
       ]
     }
   },
-  "gitHead": "09c114d148f7a0c2ad250d6346a76aa3b332b2d4"
+  "gitHead": "8ac7cfbe3b106a42e53f6e5439f484ab11b0e1f3"
 }

package/src/react-native/ParaMobile.ts

@@ -4,6 +4,7 @@ import {
   ParaCore,
   Environment,
   PlatformUtils,
+  EventData,
   Wallet,
   decryptPrivateKeyAndDecryptShare,
   encryptPrivateKey,
@@ -130,8 +131,8 @@ export class ParaMobile extends ParaCore {
     }
   }
 
-  async ready() {
-    this.isReady = true;
+  async setup() {
+    this.isSetup = true;
   }
 
   protected getPlatformUtils(): PlatformUtils {
@@ -144,12 +145,14 @@ export class ParaMobile extends ParaCore {
 
   /**
    * Registers a passkey for the user.
-   * @param {Auth<'email'> | Auth<'phone'>} auth - The user's authentication details
-   * @param {string} biometricsId - The biometrics ID obtained from verification.
+   * @param authState - Either an AuthStateSignup object or a passkeyId string.
    * @returns {Promise<void>}
    */
-  async registerPasskey(authState: AuthStateSignup) {
-    if (!authState.passkeyId) {
+  async registerPasskey(authState: AuthStateSignup): Promise<void>;
+  async registerPasskey(passkeyId: string): Promise<void>;
+  async registerPasskey(authStateOrPasskeyId: AuthStateSignup | string): Promise<void> {
+    const passkeyId = typeof authStateOrPasskeyId === 'string' ? authStateOrPasskeyId : authStateOrPasskeyId.passkeyId;
+    if (!passkeyId) {
       throw new Error('Passkey ID not found. Make sure you have enabled passkey logins in the Para Developer Portal.');
     }
 
@@ -212,7 +215,7 @@ export class ParaMobile extends ParaCore {
     const encryptedPrivateKeyHex = await encryptPrivateKey(keyPair, userHandleEncoded);
 
     const { partnerId } = await this.ctx.client.touchSession();
-    await this.ctx.client.patchSessionPublicKey(partnerId, userId, authState.passkeyId, {
+    await this.ctx.client.patchSessionPublicKey(partnerId, userId, passkeyId, {
       publicKey: resultJson.id,
       sigDerivedPublicKey: publicKeyHex,
       cosePublicKey,
@@ -322,4 +325,24 @@ export class ParaMobile extends ParaCore {
       sessionLookupId,
     });
   }
+
+  /**
+   * Handles a message from an in-app browser (WebView).
+   * Call this from your WebView's `onMessage` callback to bridge portal events
+   * (e.g. TELEGRAM_SUCCESS, FARCASTER_SUCCESS) into the SDK's event system.
+   *
+   * @example
+   * ```tsx
+   * <WebView
+   *   source={{ uri: portalUrl }}
+   *   onMessage={(event) => {
+   *     const data = JSON.parse(event.nativeEvent.data);
+   *     para.handleWebViewMessage(data);
+   *   }}
+   * />
+   * ```
+   */
+  handleWebViewMessage(data: EventData): void {
+    this.platformUtils.postMessage?.({ data });
+  }
 }

package/src/react-native/ReactNativeUtils.ts

@@ -1,4 +1,4 @@
-import { PlatformUtils, TPregenIdentifierType } from '@getpara/web-sdk';
+import { PlatformUtils, TPregenIdentifierType, EventHandler, EventData } from '@getpara/web-sdk';
 import { Ctx } from '@getpara/web-sdk';
 import { SignatureRes } from '@getpara/web-sdk';
 import { BackupKitEmailProps, KeyShareType, TWalletType, SDKType } from '@getpara/user-management-client';
@@ -62,6 +62,45 @@ export class ReactNativeUtils implements PlatformUtils {
   secureStorage = new KeychainStorage();
   isSyncStorage = false;
 
+  private eventHandlers = new Map<string, Set<EventHandler>>();
+
+  addEventListener<T = EventData>({ event, handler }: { ctx: Ctx; event: string; handler: EventHandler<T> }): void {
+    if (!this.eventHandlers.has(event)) {
+      this.eventHandlers.set(event, new Set());
+    }
+    this.eventHandlers.get(event)!.add(handler);
+  }
+
+  removeEventListener<T = EventData>({ event, handler }: { event: string; handler: EventHandler<T> }): void {
+    const handlers = this.eventHandlers.get(event);
+    if (handlers) {
+      handlers.delete(handler);
+      if (handlers.size === 0) {
+        this.eventHandlers.delete(event);
+      }
+    }
+  }
+
+  postMessage({ data }: { data: EventData; target?: string }): void {
+    if (data && typeof data === 'object' && 'type' in data) {
+      const event = data.type;
+      this.eventHandlers.get(event)?.forEach(h => h(data));
+      // Also notify 'message' catch-all handlers
+      if (event !== 'message') {
+        this.eventHandlers.get('message')?.forEach(h => h(data));
+      }
+    }
+  }
+
+  emitEvent<T = EventData>({ event, data }: { event: string; data: T }): void {
+    const eventData = {
+      type: event,
+      payload: data,
+    } as EventData;
+
+    this.postMessage({ data: eventData });
+  }
+
   // only used in web for now, can implement functionality if ever needed for mobile
   async generateBlumPrimes(_ctx: Ctx): Promise<{ p: string; q: string }> {
     throw new Error('method not implemented');