@explorins/pers-sdk-react-native 2.2.0-alpha.3 → 2.2.0-alpha.5

package/dist/storage/async-storage-token-storage.d.ts

@@ -1,9 +1,21 @@
 /**
  * AsyncStorage Token Storage for React Native Mobile Platforms
  *
- * Bundler-agnostic AsyncStorage implementation for mobile platforms
+ * Bundler-agnostic AsyncStorage implementation for mobile platforms.
+ *
+ * IMPORTANT: Due to bundler conflicts between Rollup (SDK) and Metro (app),
+ * the consuming app MUST set global.AsyncStorageModule before using this SDK:
+ *
+ * ```javascript
+ * // In your app's index.js, BEFORE importing the SDK:
+ * import AsyncStorage from '@react-native-async-storage/async-storage';
+ * global.AsyncStorageModule = AsyncStorage;
+ * ```
  */
 import type { TokenStorage } from '@explorins/pers-sdk/core';
+declare global {
+    var AsyncStorageModule: any;
+}
 /**
  * AsyncStorage implementation for mobile platforms
  *

package/dist/storage/async-storage-token-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"async-storage-token-storage.d.ts","sourceRoot":"","sources":["../../src/storage/async-storage-token-storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AA0F7D;;;;;GAKG;AACH,qBAAa,wBAAyB,YAAW,YAAY;IAC3D,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAA8B;gBAEtC,SAAS,GAAE,MAAuB;IAgBxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW9C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAYxC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAgB7B"}
+{"version":3,"file":"async-storage-token-storage.d.ts","sourceRoot":"","sources":["../../src/storage/async-storage-token-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7D,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,kBAAkB,EAAE,GAAG,CAAC;CAC7B;AA4FD;;;;;GAKG;AACH,qBAAa,wBAAyB,YAAW,YAAY;IAC3D,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAA8B;gBAEtC,SAAS,GAAE,MAAuB;IAgBxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW9C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAYxC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAgB7B"}

package/dist/storage/async-storage-token-storage.js

@@ -1,52 +1,62 @@
 /**
  * AsyncStorage Token Storage for React Native Mobile Platforms
  *
- * Bundler-agnostic AsyncStorage implementation for mobile platforms
+ * Bundler-agnostic AsyncStorage implementation for mobile platforms.
+ *
+ * IMPORTANT: Due to bundler conflicts between Rollup (SDK) and Metro (app),
+ * the consuming app MUST set global.AsyncStorageModule before using this SDK:
+ *
+ * ```javascript
+ * // In your app's index.js, BEFORE importing the SDK:
+ * import AsyncStorage from '@react-native-async-storage/async-storage';
+ * global.AsyncStorageModule = AsyncStorage;
+ * ```
  */
 /**
- * Dynamically resolve AsyncStorage at runtime to avoid bundler conflicts
- *
- * When the SDK is pre-bundled (e.g., with Rollup) and then consumed by an app
- * that uses Metro, the static import can get resolved incorrectly due to module
- * hoisting and namespace collisions.
+ * Get AsyncStorage from the global that the app must set.
  *
- * By using require() at runtime, we ensure we get the actual AsyncStorage
- * from the app's node_modules, not a bundled/mangled version.
+ * This bypasses all bundler resolution issues by having the app
+ * explicitly provide the AsyncStorage module via a global variable.
  */
 function getAsyncStorage() {
-    // Use require() to get the module at runtime
-    // This bypasses any bundler transformations that might have corrupted the import
+    // Check if the app has set the global
+    if (global.AsyncStorageModule) {
+        const module = global.AsyncStorageModule;
+        // Validate it has the expected methods
+        if (typeof module?.getItem === 'function') {
+            console.log('[AsyncStorage] Using global.AsyncStorageModule (direct)');
+            return module;
+        }
+        else if (typeof module?.default?.getItem === 'function') {
+            console.log('[AsyncStorage] Using global.AsyncStorageModule.default');
+            return module.default;
+        }
+    }
+    // Fallback: try require (may not work due to bundler conflicts)
     try {
-        // Try default export first (Metro pattern)
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
         const module = require('@react-native-async-storage/async-storage');
-        // Log for debugging what we actually received
-        const hasGetItem = typeof module?.getItem === 'function';
-        const hasDefaultGetItem = typeof module?.default?.getItem === 'function';
-        console.log('[AsyncStorage] Module resolution:', {
-            hasGetItem,
-            hasDefaultGetItem,
-            moduleType: typeof module,
-            keys: module ? Object.keys(module).slice(0, 10) : []
-        });
-        if (hasDefaultGetItem) {
+        if (typeof module?.default?.getItem === 'function') {
+            console.log('[AsyncStorage] Fallback: using require().default');
             return module.default;
         }
-        else if (hasGetItem) {
+        else if (typeof module?.getItem === 'function') {
+            console.log('[AsyncStorage] Fallback: using require() direct');
             return module;
         }
-        else {
-            throw new Error('AsyncStorage module found but missing getItem method');
-        }
     }
-    catch (error) {
-        console.error('[AsyncStorage] Failed to dynamically require:', error);
-        throw new Error('Failed to load @react-native-async-storage/async-storage. ' +
-            'Make sure it is installed and properly linked.');
+    catch (e) {
+        // Ignore require errors
     }
+    // If we get here, provide a helpful error
+    throw new Error('AsyncStorage not available. Please add this to your app\'s index.js BEFORE importing the SDK:\n\n' +
+        '  import AsyncStorage from \'@react-native-async-storage/async-storage\';\n' +
+        '  global.AsyncStorageModule = AsyncStorage;\n\n' +
+        'This is required due to bundler conflicts between Rollup and Metro.');
 }
 /**
  * Bundler-agnostic AsyncStorage wrapper
- * Now uses runtime require() to avoid bundler conflicts
+ * Uses global injection to avoid bundler conflicts
  */
 class BundlerAgnosticAsyncStorage {
     constructor() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explorins/pers-sdk-react-native",
-  "version": "2.2.0-alpha.3",
+  "version": "2.2.0-alpha.5",
   "description": "React Native SDK for PERS Platform - Tourism Loyalty System with Blockchain Transaction Signing and WebAuthn Authentication",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -38,7 +38,7 @@
   "license": "MIT",
   "dependencies": {
     "@explorins/pers-sdk": "^2.1.32",
-    "@explorins/pers-signer": "^1.0.33",
+    "@explorins/pers-signer": "^1.0.34",
     "buffer": "^6.0.3",
     "ethers": "^6.15.0"
   },

package/src/hooks/useTransactionSigner.ts

@@ -1,6 +1,11 @@
 import { useCallback, useState, useRef, useEffect } from 'react';
 // import { usePersSDK } from '../providers/PersSDKProvider';
-import { PersSignerConfig, SigningStatus, StatusCallback, StatusUpdateData } from '@explorins/pers-signer';
+
+// TYPE-ONLY imports from /types entry - NO native module deps, safe at any time
+import type { PersSignerConfig, StatusCallback, StatusUpdateData } from '@explorins/pers-signer/types';
+import type { SigningStatus as SigningStatusType } from '@explorins/pers-signer/types';
+// Runtime const import - also from /types (no native deps)
+import { SigningStatus as SigningStatusConst } from '@explorins/pers-signer/types';
 
 // Import actual SDK types from the React Native-specific export
 type PersSignerSDK = import('@explorins/pers-signer/react-native').PersSignerSDK;
@@ -8,21 +13,29 @@ type SubmissionResult = import('@explorins/pers-signer/react-native').Submission
 type AuthenticatedUser = import('@explorins/pers-signer/react-native').AuthenticatedUser;
 type TransactionSigningResult = import('@explorins/pers-signer/react-native').TransactionSigningResult;
 
-// Re-export signing status types from signer SDK for convenience
-export { SigningStatus };
+// Re-export the type for external consumers
+export type { SigningStatusType as SigningStatus };
 export type { StatusUpdateData };
 
 /**
  * Simple status callback function type for React Native consumers
  * (Simplified from the signer SDK's object-based StatusCallback interface)
  */
-export type OnStatusUpdateFn = (status: SigningStatus, message: string, data?: StatusUpdateData) => void;
+export type OnStatusUpdateFn = (status: SigningStatusType, message: string, data?: StatusUpdateData) => void;
 
 
-// Lazy-loaded signer SDK factory - initialized on first use to avoid native module timing issues
+// Lazy-loaded signer SDK - initialized on first use to avoid native module timing issues
 let _createPersSignerSDK: ((config: PersSignerConfig) => Promise<PersSignerSDK>) | null = null;
 let _signerInitAttempted = false;
 
+/**
+ * Get the SigningStatus const object
+ * Now directly imported from /types (no native deps, always available)
+ */
+function getSigningStatus(): typeof SigningStatusType {
+  return SigningStatusConst;
+}
+
 /**
  * Lazily load the PERS Signer SDK.
  * 
@@ -41,7 +54,8 @@ function getSignerSDKFactory(): ((config: PersSignerConfig) => Promise<PersSigne
   
   // Check for customer pre-initialized global (for native module timing issues)
   if (typeof global !== 'undefined' && (global as any).__PersSigner?.createPersSignerSDK) {
-    _createPersSignerSDK = (global as any).__PersSigner.createPersSignerSDK;
+    const globalModule = (global as any).__PersSigner;
+    _createPersSignerSDK = globalModule.createPersSignerSDK;
     return _createPersSignerSDK;
   }
   
@@ -79,7 +93,7 @@ export interface TransactionSignerHook {
   signPersTransaction: (jwt: string, onStatusUpdate?: OnStatusUpdateFn) => Promise<TransactionSigningResult>;
   isSignerInitialized: boolean;
   isSignerAvailable: boolean;
-  currentStatus: SigningStatus | null;
+  currentStatus: SigningStatusType | null;
   statusMessage: string | null;
 }
 
@@ -266,7 +280,7 @@ const DEFAULT_ETHERS_PROVIDER = "https://sepolia.infura.io/v3/2781b4b5242343d5b0
 export const useTransactionSigner = (): TransactionSignerHook => {
   // const { isInitialized, isAuthenticated, user } = usePersSDK();
   const [isSignerInitialized, setIsSignerInitialized] = useState(false);
-  const [currentStatus, setCurrentStatus] = useState<SigningStatus | null>(null);
+  const [currentStatus, setCurrentStatus] = useState<SigningStatusType | null>(null);
   const [statusMessage, setStatusMessage] = useState<string | null>(null);
   const signerSDKRef = useRef<PersSignerSDK | null>(null);
 
@@ -398,7 +412,7 @@ export const useTransactionSigner = (): TransactionSignerHook => {
 
     // Create status callback wrapper that updates both hook state and calls user callback
     const statusCallback: StatusCallback = {
-      onStatusUpdate: (status: SigningStatus, message: string, data?: StatusUpdateData) => {
+      onStatusUpdate: (status: SigningStatusType, message: string, data?: StatusUpdateData) => {
         setCurrentStatus(status);
         setStatusMessage(message);
         onStatusUpdate?.(status, message, data);
@@ -413,7 +427,8 @@ export const useTransactionSigner = (): TransactionSignerHook => {
       
     } catch (error) {
       console.error('[useTransactionSigner] JWT transaction signing failed:', error);
-      setCurrentStatus(SigningStatus.ERROR);
+      const SigningStatusEnum = getSigningStatus();
+      if (SigningStatusEnum) setCurrentStatus(SigningStatusEnum.ERROR);
       setStatusMessage(error instanceof Error ? error.message : 'Transaction failed');
       throw error; // Re-throw to maintain error handling upstream
     }
@@ -459,7 +474,7 @@ export const useTransactionSigner = (): TransactionSignerHook => {
 
     // Create status callback wrapper
     const statusCallback: StatusCallback = {
-      onStatusUpdate: (status: SigningStatus, message: string, data?: StatusUpdateData) => {
+      onStatusUpdate: (status: SigningStatusType, message: string, data?: StatusUpdateData) => {
         setCurrentStatus(status);
         setStatusMessage(message);
         onStatusUpdate?.(status, message, data);
@@ -472,7 +487,8 @@ export const useTransactionSigner = (): TransactionSignerHook => {
       return signingResult;
     } catch (error) {
       console.error('[useTransactionSigner] Sign-only transaction failed:', error);
-      setCurrentStatus(SigningStatus.ERROR);
+      const SigningStatusEnum = getSigningStatus();
+      if (SigningStatusEnum) setCurrentStatus(SigningStatusEnum.ERROR);
       setStatusMessage(error instanceof Error ? error.message : 'Signing failed');
       throw error;
     }

package/src/storage/async-storage-token-storage.ts

@@ -1,58 +1,74 @@
 /**
  * AsyncStorage Token Storage for React Native Mobile Platforms
  * 
- * Bundler-agnostic AsyncStorage implementation for mobile platforms
+ * Bundler-agnostic AsyncStorage implementation for mobile platforms.
+ * 
+ * IMPORTANT: Due to bundler conflicts between Rollup (SDK) and Metro (app),
+ * the consuming app MUST set global.AsyncStorageModule before using this SDK:
+ * 
+ * ```javascript
+ * // In your app's index.js, BEFORE importing the SDK:
+ * import AsyncStorage from '@react-native-async-storage/async-storage';
+ * global.AsyncStorageModule = AsyncStorage;
+ * ```
  */
 
 import type { TokenStorage } from '@explorins/pers-sdk/core';
 
+// Declare global type for TypeScript
+declare global {
+  var AsyncStorageModule: any;
+}
+
 /**
- * Dynamically resolve AsyncStorage at runtime to avoid bundler conflicts
- * 
- * When the SDK is pre-bundled (e.g., with Rollup) and then consumed by an app
- * that uses Metro, the static import can get resolved incorrectly due to module
- * hoisting and namespace collisions.
+ * Get AsyncStorage from the global that the app must set.
  * 
- * By using require() at runtime, we ensure we get the actual AsyncStorage
- * from the app's node_modules, not a bundled/mangled version.
+ * This bypasses all bundler resolution issues by having the app
+ * explicitly provide the AsyncStorage module via a global variable.
  */
 function getAsyncStorage(): any {
-  // Use require() to get the module at runtime
-  // This bypasses any bundler transformations that might have corrupted the import
+  // Check if the app has set the global
+  if (global.AsyncStorageModule) {
+    const module = global.AsyncStorageModule;
+    
+    // Validate it has the expected methods
+    if (typeof module?.getItem === 'function') {
+      console.log('[AsyncStorage] Using global.AsyncStorageModule (direct)');
+      return module;
+    } else if (typeof module?.default?.getItem === 'function') {
+      console.log('[AsyncStorage] Using global.AsyncStorageModule.default');
+      return module.default;
+    }
+  }
+  
+  // Fallback: try require (may not work due to bundler conflicts)
   try {
-    // Try default export first (Metro pattern)
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
     const module = require('@react-native-async-storage/async-storage');
     
-    // Log for debugging what we actually received
-    const hasGetItem = typeof module?.getItem === 'function';
-    const hasDefaultGetItem = typeof module?.default?.getItem === 'function';
-    
-    console.log('[AsyncStorage] Module resolution:', {
-      hasGetItem,
-      hasDefaultGetItem,
-      moduleType: typeof module,
-      keys: module ? Object.keys(module).slice(0, 10) : []
-    });
-    
-    if (hasDefaultGetItem) {
+    if (typeof module?.default?.getItem === 'function') {
+      console.log('[AsyncStorage] Fallback: using require().default');
       return module.default;
-    } else if (hasGetItem) {
+    } else if (typeof module?.getItem === 'function') {
+      console.log('[AsyncStorage] Fallback: using require() direct');
       return module;
-    } else {
-      throw new Error('AsyncStorage module found but missing getItem method');
     }
-  } catch (error) {
-    console.error('[AsyncStorage] Failed to dynamically require:', error);
-    throw new Error(
-      'Failed to load @react-native-async-storage/async-storage. ' +
-      'Make sure it is installed and properly linked.'
-    );
+  } catch (e) {
+    // Ignore require errors
   }
+  
+  // If we get here, provide a helpful error
+  throw new Error(
+    'AsyncStorage not available. Please add this to your app\'s index.js BEFORE importing the SDK:\n\n' +
+    '  import AsyncStorage from \'@react-native-async-storage/async-storage\';\n' +
+    '  global.AsyncStorageModule = AsyncStorage;\n\n' +
+    'This is required due to bundler conflicts between Rollup and Metro.'
+  );
 }
 
 /**
  * Bundler-agnostic AsyncStorage wrapper
- * Now uses runtime require() to avoid bundler conflicts
+ * Uses global injection to avoid bundler conflicts
  */
 class BundlerAgnosticAsyncStorage {
   private storage: any;