@explorins/pers-sdk-react-native 1.5.30 → 1.5.32

package/src/hooks/useFiles.ts

@@ -75,7 +75,6 @@ export const useFiles = () => {
     
     try {
       const result = await sdk.files.getSignedPutUrl(entityId, entityType, fileExtension);
-      console.log('Signed put URL generated successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to generate signed put URL:', error);
@@ -110,7 +109,6 @@ export const useFiles = () => {
     
     try {
       const result = await sdk.files.getSignedGetUrl(entityId, entityType, expireSeconds);
-      console.log('Signed get URL generated successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to generate signed get URL:', error);
@@ -125,7 +123,6 @@ export const useFiles = () => {
     
     try {
       const result = await sdk.files.getSignedUrl(request);
-      console.log('Signed URL generated successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to generate signed URL:', error);
@@ -140,7 +137,6 @@ export const useFiles = () => {
     
     try {
       const result = await sdk.files.optimizeMedia(url, width, height);
-      console.log('Media optimized successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to optimize media:', error);

package/src/hooks/usePurchases.ts

@@ -17,7 +17,6 @@ export const usePurchases = () => {
     
     try {
       const result = await sdk.purchases.createPaymentIntent(amount, currency, receiptEmail, description);
-      console.log('Payment intent created successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to create payment intent:', error);
@@ -32,7 +31,6 @@ export const usePurchases = () => {
     
     try {
       const result = await sdk.purchases.getActivePurchaseTokens();
-      console.log('Active purchase tokens fetched successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to fetch active purchase tokens:', error);
@@ -50,7 +48,6 @@ export const usePurchases = () => {
     
     try {
       const result = await sdk.purchases.getAllUserPurchases();
-      console.log('User purchases fetched successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to fetch user purchases:', error);

package/src/hooks/useRedemptions.ts

@@ -1,6 +1,6 @@
 import { useCallback } from 'react';
 import { usePersSDK } from '../providers/PersSDKProvider';
-import { SubmissionResult, useTransactionSigner } from './useTransactionSigner';
+import { SubmissionResult, useTransactionSigner, OnStatusUpdateFn } from './useTransactionSigner';
 import type { 
   RedemptionCreateRequestDTO, 
   RedemptionDTO, 
@@ -11,7 +11,7 @@ import type {
 
 export const useRedemptions = () => {
   const { sdk, isInitialized, isAuthenticated } = usePersSDK();
-  const { signAndSubmitTransactionWithJWT, isSignerAvailable } = useTransactionSigner();
+  const { signAndSubmitTransactionWithJWT, isSignerAvailable, currentStatus, statusMessage } = useTransactionSigner();
 
   const getActiveRedemptions = useCallback(async (): Promise<RedemptionDTO[]> => {
     if (!isInitialized || !sdk) {
@@ -20,7 +20,6 @@ export const useRedemptions = () => {
     
     try {
       const result = await sdk.redemptions.getActiveRedemptions();
-      console.log('Active redemptions fetched successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to fetch active redemptions:', error);
@@ -39,7 +38,6 @@ export const useRedemptions = () => {
     
     try {
       const result = await sdk.redemptions.getUserRedemptions();
-      console.log('User redemptions fetched successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to fetch user redemptions:', error);
@@ -47,7 +45,7 @@ export const useRedemptions = () => {
     }
   }, [sdk, isInitialized, isAuthenticated]);
 
-  const redeem = useCallback(async (redemptionId: string): Promise<RedemptionRedeemRequestResponseDTO> => {
+  const redeem = useCallback(async (redemptionId: string, onStatusUpdate?: OnStatusUpdateFn): Promise<RedemptionRedeemRequestResponseDTO> => {
     if (!isInitialized || !sdk) {
       throw new Error('SDK not initialized. Call initialize() first.');
     }
@@ -56,22 +54,13 @@ export const useRedemptions = () => {
     }
     
     try {
-      console.log('Redeeming redemption:', redemptionId);
       const result = await sdk.redemptions.redeem(redemptionId);
-      
-      // Check if result has signing fields and sign transaction if required and signer is available
-      console.log('Redemption processed successfully:', result);
-
 
       const txToken = result.senderTransaction?.actionable?.authToken;
       if (txToken && isSignerAvailable) {
-        console.log('Transaction requires blockchain signing, processing with WebAuthn signer...');
-        
         try {
-          const signingResult: SubmissionResult = await signAndSubmitTransactionWithJWT(txToken);
-          console.log('Blockchain signing result:', signingResult);
+          const signingResult: SubmissionResult = await signAndSubmitTransactionWithJWT(txToken, onStatusUpdate);
           if (signingResult.success) {
-            console.log('Transaction signed successfully:', signingResult.transactionHash);
             // Return enhanced result with signing information
             return {
               ...result,
@@ -108,9 +97,7 @@ export const useRedemptions = () => {
     }
     
     try {
-      console.log('Creating redemption offer with data:', redemptionData);
       const result = await sdk.redemptions.createRedemption(redemptionData);
-      console.log('Redemption offer created successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to create redemption offer:', error);
@@ -125,7 +112,6 @@ export const useRedemptions = () => {
     
     try {
       const result = await sdk.redemptions.getAllRedemptions(active);
-      console.log('All redemptions fetched successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to fetch all redemptions:', error);
@@ -140,7 +126,6 @@ export const useRedemptions = () => {
     
     try {
       const result = await sdk.redemptions.getRedemptionTypes();
-      console.log('Redemption types fetched successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to fetch redemption types:', error);
@@ -155,7 +140,6 @@ export const useRedemptions = () => {
     
     try {
       const result = await sdk.redemptions.updateRedemption(redemptionId, redemptionData);
-      console.log('Redemption updated successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to update redemption:', error);
@@ -170,7 +154,6 @@ export const useRedemptions = () => {
     
     try {
       const result = await sdk.redemptions.toggleRedemptionStatus(redemptionId);
-      console.log('Redemption status toggled successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to toggle redemption status:', error);
@@ -188,6 +171,9 @@ export const useRedemptions = () => {
     updateRedemption,
     toggleRedemptionStatus,
     isAvailable: isInitialized && !!sdk?.redemptions,
+    // Expose signing status for UI feedback
+    signingStatus: currentStatus,
+    signingStatusMessage: statusMessage,
   };
 };
 

package/src/hooks/useTenants.ts

@@ -26,7 +26,6 @@ export const useTenants = () => {
     
     try {
       const result = await sdk.tenants.getClientConfig();
-      console.log('Client config fetched successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to fetch client config:', error);
@@ -41,7 +40,6 @@ export const useTenants = () => {
     
     try {
       const result = await sdk.tenants.getLoginToken();
-      console.log('Login token fetched successfully');
       return result;
     } catch (error) {
       console.error('Failed to fetch login token:', error);
@@ -56,7 +54,6 @@ export const useTenants = () => {
     
     try {
       const result = await sdk.tenants.getAdmins();
-      console.log('Admins fetched successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to fetch admins:', error);

package/src/hooks/useTokens.ts

@@ -57,7 +57,6 @@ export const useTokens = () => {
     
     try {
       const result = await sdk.tokens.getTokens();
-      console.log('Tokens fetched successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to fetch tokens:', error);
@@ -85,7 +84,6 @@ export const useTokens = () => {
     
     try {
       const result = await sdk.tokens.getActiveCreditToken();
-      console.log('Active credit token fetched successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to fetch active credit token:', error);
@@ -113,7 +111,6 @@ export const useTokens = () => {
     
     try {
       const result = await sdk.tokens.getRewardTokens();
-      console.log('Reward tokens fetched successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to fetch reward tokens:', error);
@@ -141,7 +138,6 @@ export const useTokens = () => {
     
     try {
       const result = await sdk.tokens.getTokenTypes();
-      console.log('Token types fetched successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to fetch token types:', error);
@@ -169,7 +165,6 @@ export const useTokens = () => {
     
     try {
       const result = await sdk.tokens.getStatusTokens();
-      console.log('Status tokens fetched successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to fetch status tokens:', error);
@@ -199,7 +194,6 @@ export const useTokens = () => {
     
     try {
       const result = await sdk.tokens.getTokenByContract(contractAddress, contractTokenId);
-      console.log('Token by contract fetched successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to fetch token by contract:', error);

package/src/hooks/useTransactionSigner.ts

@@ -1,6 +1,6 @@
 import { useCallback, useState, useRef, useEffect } from 'react';
 // import { usePersSDK } from '../providers/PersSDKProvider';
-import { PersSignerConfig } from '@explorins/pers-signer';
+import { PersSignerConfig, SigningStatus, StatusCallback, StatusUpdateData } from '@explorins/pers-signer';
 
 // Import actual SDK types from the React Native-specific export
 type PersSignerSDK = import('@explorins/pers-signer/react-native').PersSignerSDK;
@@ -8,6 +8,16 @@ 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 };
+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;
+
 
 // Dynamic import the signer SDK to avoid build issues with static dependencies
 let createPersSignerSDK: ((config: PersSignerConfig) => Promise<PersSignerSDK>) | null = null;
@@ -30,11 +40,15 @@ try {
  * @property {Function} signAndSubmitTransactionWithJWT - Main method to sign and submit transactions
  * @property {boolean} isSignerInitialized - Whether the signer SDK has been initialized
  * @property {boolean} isSignerAvailable - Whether signing functionality is fully available
+ * @property {SigningStatus | null} currentStatus - Current signing status for UI feedback
+ * @property {string | null} statusMessage - Human-readable status message
  */
 export interface TransactionSignerHook {
-  signAndSubmitTransactionWithJWT: (jwt: string) => Promise<SubmissionResult>;
+  signAndSubmitTransactionWithJWT: (jwt: string, onStatusUpdate?: OnStatusUpdateFn) => Promise<SubmissionResult>;
   isSignerInitialized: boolean;
   isSignerAvailable: boolean;
+  currentStatus: SigningStatus | null;
+  statusMessage: string | null;
 }
 
 // Constants - TODO: Move to environment config later
@@ -220,6 +234,8 @@ 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 [statusMessage, setStatusMessage] = useState<string | null>(null);
   const signerSDKRef = useRef<PersSignerSDK | null>(null);
 
   // Auto-initialize signer SDK when PERS SDK is ready
@@ -273,6 +289,7 @@ export const useTransactionSigner = (): TransactionSignerHook => {
    * 
    * @param {string} jwt - JWT token containing transaction ID and user information
    *   Must include: `transactionId`, `identifierEmail`, `tenantId`
+   * @param {StatusCallback} [onStatusUpdate] - Optional callback for real-time status updates
    * @returns {Promise<SubmissionResult>} Complete transaction result
    * 
    * @throws {Error} 'Transaction signer not initialized' - Hook not ready
@@ -295,6 +312,15 @@ export const useTransactionSigner = (): TransactionSignerHook => {
    * ```
    * 
    * @example
+   * **With Status Updates:**
+   * ```typescript
+   * const result = await signAndSubmitTransactionWithJWT(jwtToken, (status, message) => {
+   *   console.log(`Status: ${status} - ${message}`);
+   *   setStatusText(message);
+   * });
+   * ```
+   * 
+   * @example
    * **With Error Handling:**
    * ```typescript
    * try {
@@ -329,7 +355,7 @@ export const useTransactionSigner = (): TransactionSignerHook => {
    * 
    * @see {@link SubmissionResult} for detailed result structure
    */
-  const signAndSubmitTransactionWithJWT = useCallback(async (jwt: string): Promise<SubmissionResult> => {
+  const signAndSubmitTransactionWithJWT = useCallback(async (jwt: string, onStatusUpdate?: OnStatusUpdateFn): Promise<SubmissionResult> => {
     if (!isSignerInitialized || !signerSDKRef.current) {
       throw new Error('Transaction signer not initialized');
     }
@@ -337,14 +363,25 @@ export const useTransactionSigner = (): TransactionSignerHook => {
       throw new Error('PERS Signer SDK not available. Blockchain signing is not supported.');
     }
 
+    // Create status callback wrapper that updates both hook state and calls user callback
+    const statusCallback: StatusCallback = {
+      onStatusUpdate: (status: SigningStatus, message: string, data?: StatusUpdateData) => {
+        setCurrentStatus(status);
+        setStatusMessage(message);
+        onStatusUpdate?.(status, message, data);
+      }
+    };
+
     try {
       // Use the actual SDK method that handles the complete sign + submit flow
-      const submissionResult = await signerSDKRef.current.signAndSubmitPersTransaction(jwt);
+      const submissionResult = await signerSDKRef.current.signAndSubmitPersTransaction(jwt, statusCallback);
       
       return submissionResult;
       
     } catch (error) {
       console.error('[useTransactionSigner] JWT transaction signing failed:', error);
+      setCurrentStatus(SigningStatus.ERROR);
+      setStatusMessage(error instanceof Error ? error.message : 'Transaction failed');
       throw error; // Re-throw to maintain error handling upstream
     }
   }, [isSignerInitialized]);
@@ -357,6 +394,7 @@ export const useTransactionSigner = (): TransactionSignerHook => {
      * from authentication to blockchain submission in a single call.
      * 
      * @param {string} jwt - JWT token with transaction and user data
+     * @param {StatusCallback} [onStatusUpdate] - Optional callback for real-time status updates
      * @returns {Promise<SubmissionResult>} Transaction result with hash and status
      */
     signAndSubmitTransactionWithJWT,
@@ -404,6 +442,38 @@ export const useTransactionSigner = (): TransactionSignerHook => {
      * ```
      */
     isSignerAvailable: isSignerInitialized && !!createPersSignerSDK,
+    
+    /**
+     * Current signing status for UI feedback
+     * 
+     * Tracks the current state of the signing process. Use this to show
+     * progress indicators or status messages during transaction signing.
+     * 
+     * Possible values: 'initializing', 'authenticating', 'preparing', 
+     * 'signing', 'submitting', 'completed', 'error', 'expired'
+     * 
+     * @example
+     * ```typescript
+     * const { currentStatus, statusMessage } = useTransactionSigner();
+     * 
+     * return (
+     *   <View>
+     *     {currentStatus && (
+     *       <Text>Status: {statusMessage}</Text>
+     *     )}
+     *   </View>
+     * );
+     * ```
+     */
+    currentStatus,
+    
+    /**
+     * Human-readable status message
+     * 
+     * Provides a user-friendly description of the current signing status.
+     * Updates in real-time as the transaction progresses.
+     */
+    statusMessage,
   };
 };
 

package/src/hooks/useTransactions.ts

@@ -1,6 +1,6 @@
 import { useCallback } from 'react';
 import { usePersSDK } from '../providers/PersSDKProvider';
-import { useTransactionSigner } from './useTransactionSigner';
+import { useTransactionSigner, OnStatusUpdateFn } from './useTransactionSigner';
 import type { 
   TransactionRequestDTO, 
   TransactionRequestResponseDTO, 
@@ -47,7 +47,7 @@ import type {
  */
 export const useTransactions = () => {
   const { sdk, isInitialized, isAuthenticated } = usePersSDK();
-  const { signAndSubmitTransactionWithJWT, isSignerAvailable } = useTransactionSigner();
+  const { signAndSubmitTransactionWithJWT, isSignerAvailable, currentStatus, statusMessage } = useTransactionSigner();
 
   if (!isAuthenticated && isInitialized) {
     console.warn('SDK not authenticated. Some transaction operations may fail.');
@@ -71,11 +71,13 @@ export const useTransactions = () => {
    *   recipient: '0x123...',
    *   tokenId: 'token-123'
    * };
-   * const result = await createTransaction(request);
+   * const result = await createTransaction(request, (status, message) => {
+   *   console.log(`Status: ${status} - ${message}`);
+   * });
    * console.log('Transaction created:', result);
    * ```
    */
-  const createTransaction = useCallback(async (request: TransactionRequestDTO): Promise<TransactionRequestResponseDTO> => {
+  const createTransaction = useCallback(async (request: TransactionRequestDTO, onStatusUpdate?: OnStatusUpdateFn): Promise<TransactionRequestResponseDTO> => {
     if (!isInitialized || !sdk) {
       throw new Error('SDK not initialized. Call initialize() first.');
     }
@@ -83,13 +85,10 @@ export const useTransactions = () => {
     try {
       const result = await sdk.transactions.createTransaction(request);
       
-      console.log('Transaction created successfully:', result);
-      
       // Check if transaction requires signing (contains actionable authToken)
       // Type assertion needed as TransactionRequestResponseDTO type may not include all dynamic properties
       const txToken = result?.actionable?.authToken;
       if (txToken) {
-        console.log('[useTransactions] Transaction requires signing, attempting automatic signature...');
         
         try {
           if (!isSignerAvailable) {
@@ -98,7 +97,7 @@ export const useTransactions = () => {
           }
 
           // Automatically sign the transaction using the authToken
-          const signingResult = await signAndSubmitTransactionWithJWT(txToken);
+          const signingResult = await signAndSubmitTransactionWithJWT(txToken, onStatusUpdate);
           
           if (signingResult.success) {
             console.log('[useTransactions] Transaction signed successfully:', signingResult.transactionHash);
@@ -144,7 +143,6 @@ export const useTransactions = () => {
     
     try {
       const result = await sdk.transactions.getTransactionById(transactionId);
-      console.log('Transaction fetched successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to fetch transaction:', error);
@@ -174,7 +172,6 @@ export const useTransactions = () => {
     
     try {
       const result = await sdk.transactions.getUserTransactionHistory(role);
-      console.log('Transaction history fetched successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to fetch transaction history:', error);
@@ -203,7 +200,6 @@ export const useTransactions = () => {
     
     try {
       const result = await sdk.transactions.getPaginatedTransactions(params);
-      console.log('Paginated transactions fetched successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to fetch paginated transactions:', error);
@@ -218,7 +214,6 @@ export const useTransactions = () => {
     
     try {
       const result = await sdk.transactions.exportTransactionsCSV();
-      console.log('Transactions CSV exported successfully');
       return result;
     } catch (error) {
       console.error('Failed to export transactions CSV:', error);
@@ -234,6 +229,9 @@ export const useTransactions = () => {
     getPaginatedTransactions,
     exportTransactionsCSV,
     isAvailable: isInitialized && !!sdk?.transactions,
+    // Expose signing status for UI feedback
+    signingStatus: currentStatus,
+    signingStatusMessage: statusMessage,
   };
 };
 

package/src/hooks/useUserStatus.ts

@@ -12,7 +12,6 @@ export const useUserStatus = () => {
     
     try {
       const result = await sdk.userStatus.getUserStatusTypes();
-      console.log('User status types fetched successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to fetch user status types:', error);
@@ -30,7 +29,6 @@ export const useUserStatus = () => {
     
     try {
       const result = await sdk.userStatus.getEarnedUserStatus();
-      console.log('Earned user status fetched successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to fetch earned user status:', error);
@@ -46,7 +44,6 @@ export const useUserStatus = () => {
     
     try {
       const result = await sdk.userStatus.createUserStatusType(userStatusType);
-      console.log('User status type created successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to create user status type:', error);

package/src/hooks/useUsers.ts

@@ -16,7 +16,6 @@ export const useUsers = () => {
     
     try {
       const result = await sdk.users.getCurrentUser();
-      console.log('Current user fetched successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to fetch current user:', error);
@@ -34,7 +33,6 @@ export const useUsers = () => {
     
     try {
       const result = await sdk.users.updateCurrentUser(userData);
-      console.log('Current user updated successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to update current user:', error);
@@ -49,7 +47,6 @@ export const useUsers = () => {
     
     try {
       const result = await sdk.users.getUserById(userId);
-      console.log('User fetched successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to fetch user:', error);
@@ -64,7 +61,6 @@ export const useUsers = () => {
     
     try {
       const result = await sdk.users.getAllUsersPublic(filter);
-      console.log('Public users fetched successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to fetch public users:', error);
@@ -80,7 +76,6 @@ export const useUsers = () => {
     
     try {
       const result = await sdk.users.getAllUsers();
-      console.log('All users fetched successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to fetch all users:', error);
@@ -95,7 +90,6 @@ export const useUsers = () => {
     
     try {
       const result = await sdk.users.updateUser(userId, userData);
-      console.log('User updated successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to update user:', error);
@@ -110,7 +104,6 @@ export const useUsers = () => {
     
     try {
       const result = await sdk.users.toggleUserStatus(user);
-      console.log('User status toggled successfully:', result);
       return result;
     } catch (error) {
       console.error('Failed to toggle user status:', error);