@explorins/pers-sdk-react-native 2.1.13 → 2.1.14-beta.0

package/dist/index.js

@@ -5938,6 +5938,8 @@ class CampaignApi {
             params.push(`tag=${encodeURIComponent(options.tag)}`);
         if (options?.businessId)
             params.push(`businessId=${encodeURIComponent(options.businessId)}`);
+        if (options?.search)
+            params.push(`search=${encodeURIComponent(options.search)}`);
         if (options?.sortBy)
             params.push(`sortBy=${options.sortBy}`);
         if (options?.sortOrder)
@@ -6304,7 +6306,9 @@ class CampaignService {
     /**
      * Get campaigns with pagination support
      * Intelligent access: Public gets active only, Business gets own campaigns, Admin gets all
-     * @param options.active - Filter by active status
+     * @param options.active - Filter by active status (Admin only)
+     * @param options.tag - Filter by tag
+     * @param options.search - Free text search across name, description, and tags (case-insensitive)
      * @param options.businessId - Filter by business engagement
      * @param options.page - Page number (1-based, default: 1)
      * @param options.limit - Items per page (default: 50)
@@ -6480,15 +6484,23 @@ class RedemptionApi {
      * - Public users: Get active redemptions only
      * - Admin users: Get all redemptions with optional filtering
      *
-     * @param options - Filter and pagination options (active, adminAccess, page, limit, sortBy, sortOrder)
+     * @param options - Filter and pagination options (active, search, adminAccess, page, limit, sortBy, sortOrder)
      * @returns Paginated response with redemptions
      */
     async getRedemptions(options) {
-        const params = buildPaginationParams(options);
-        if (options?.active !== undefined) {
-            params.append('active', String(options.active));
-        }
-        const response = await this.apiClient.get(`${this.basePath}?${params.toString()}`);
+        const params = [];
+        // Always include pagination params to ensure paginated response
+        params.push(`page=${options?.page || 1}`);
+        params.push(`limit=${options?.limit || 50}`);
+        if (options?.active !== undefined)
+            params.push(`active=${options.active}`);
+        if (options?.search)
+            params.push(`search=${encodeURIComponent(options.search)}`);
+        if (options?.sortBy)
+            params.push(`sortBy=${options.sortBy}`);
+        if (options?.sortOrder)
+            params.push(`sortOrder=${options.sortOrder}`);
+        const response = await this.apiClient.get(`${this.basePath}?${params.join('&')}`);
         return normalizeToPaginated(response);
     }
     /**
@@ -6717,7 +6729,12 @@ class RedemptionService {
     /**
      * UNIFIED: Get redemptions with intelligent access control and pagination
      * @param options.active - Filter by active status
+     * @param options.search - Free text search across name, description, tags (case-insensitive)
      * @param options.adminAccess - Force admin access
+     * @param options.page - Page number (1-indexed)
+     * @param options.limit - Results per page
+     * @param options.sortBy - Field to sort by ('name' | 'createdAt')
+     * @param options.sortOrder - Sort direction ('ASC' | 'DESC')
      */
     async getRedemptions(options) {
         return this.redemptionApi.getRedemptions(options);
@@ -6770,10 +6787,11 @@ class RedemptionService {
     // ADMIN OPERATIONS
     // ==========================================
     /**
-     * Convenience: Get redemptions as admin
+     * Convenience: Get redemptions as admin with filtering and search
+     * @param options - Filter options (active, search, pagination)
      */
-    async getRedemptionsAsAdmin(active, options) {
-        return this.redemptionApi.getRedemptions({ active, adminAccess: true, ...options });
+    async getRedemptionsAsAdmin(options) {
+        return this.redemptionApi.getRedemptions({ ...options, adminAccess: true });
     }
     /**
      * ADMIN: Create redemption
@@ -11890,7 +11908,7 @@ class BusinessManager {
  *
  * // Get specific campaign details
  * const campaign = await sdk.campaigns.getCampaignById('summer-promo-2024');
- * console.log('Campaign:', campaign.title);
+ * console.log('Campaign:', campaign.name);
  *
  * // User claims campaign reward
  * const claim = await sdk.campaigns.claimCampaign({
@@ -11906,7 +11924,7 @@ class BusinessManager {
  *
  * console.log('My Campaign Claims:');
  * userClaims.forEach(claim => {
- *   console.log(`- ${claim.campaign.title}`);
+ *   console.log(`- ${claim.campaign.name}`);
  *   console.log(`  Rewards: ${claim.rewards?.length || 0} tokens`);
  *   console.log(`  Date: ${claim.claimedAt}`);
  * });
@@ -11922,7 +11940,7 @@ class BusinessManager {
  * ```typescript
  * // Admin: Create seasonal campaign
  * const newCampaign = await sdk.campaigns.createCampaign({
- *   title: 'Holiday Rewards',
+ *   name: 'Holiday Rewards',
  *   description: 'Special holiday loyalty bonuses',
  *   startDate: '2024-12-01',
  *   endDate: '2024-12-31',
@@ -11961,7 +11979,7 @@ class CampaignManager {
      *   const campaign = await sdk.campaigns.getCampaignById('summer-promo-2024');
      *
      *   console.log('Campaign Details:');
-     *   console.log('Title:', campaign.title);
+     *   console.log('Name:', campaign.name);
      *   console.log('Description:', campaign.description);
      *   console.log('Active:', campaign.isActive);
      *   console.log('Period:', `${campaign.startDate} to ${campaign.endDate}`);
@@ -12075,7 +12093,7 @@ class CampaignManager {
      * console.log(`Campaign History (${userClaims.length} claims):`);
      *
      * userClaims.forEach((claim, index) => {
-     *   console.log(`\n${index + 1}. ${claim.campaign.title}`);
+     *   console.log(`\n${index + 1}. ${claim.campaign.name}`);
      *   console.log(`   Claimed: ${new Date(claim.claimedAt).toLocaleDateString()}`);
      *   console.log(`   Business: ${claim.business?.displayName || 'N/A'}`);
      *
@@ -12105,7 +12123,7 @@ class CampaignManager {
      * Returns campaigns with pagination metadata for efficient data loading.
      * Intelligent access: Public gets active only, Business gets own campaigns, Admin gets all.
      *
-     * @param options - Pagination and filter options (page, limit, sortBy, sortOrder, active, businessId, include)
+     * @param options - Pagination and filter options (page, limit, sortBy, sortOrder, active, tag, search, businessId, include)
      * @returns Promise resolving to paginated campaigns with metadata
      *
      * @example
@@ -12122,6 +12140,19 @@ class CampaignManager {
      *   limit: 20
      * });
      *
+     * // Search campaigns by name or description
+     * const searchResults = await sdk.campaigns.getCampaigns({
+     *   search: 'summer rewards',
+     *   page: 1,
+     *   limit: 20
+     * });
+     *
+     * // Filter by tag
+     * const taggedCampaigns = await sdk.campaigns.getCampaigns({
+     *   tag: 'seasonal',
+     *   active: true
+     * });
+     *
      * // Get active campaigns sorted by creation date
      * const activeCampaigns = await sdk.campaigns.getCampaigns({
      *   active: true,
@@ -12155,7 +12186,7 @@ class CampaignManager {
      * ```typescript
      * // Admin operation - create seasonal campaign
      * const campaign = await sdk.campaigns.createCampaign({
-     *   title: 'Summer Travel Rewards',
+     *   name: 'Summer Travel Rewards',
      *   description: 'Earn bonus points for summer bookings',
      *   startDate: '2024-06-01T00:00:00Z',
      *   endDate: '2024-08-31T23:59:59Z',
@@ -12164,7 +12195,7 @@ class CampaignManager {
      *   campaignType: 'SEASONAL'
      * });
      *
-     * console.log('Campaign created:', campaign.title);
+     * console.log('Campaign created:', campaign.name);
      * console.log('Campaign ID:', campaign.id);
      *
      * // Set up campaign rewards
@@ -12194,13 +12225,13 @@ class CampaignManager {
      * ```typescript
      * // Admin operation - extend campaign duration
      * const updated = await sdk.campaigns.updateCampaign('summer-2024', {
-     *   title: 'Extended Summer Travel Rewards',
+     *   name: 'Extended Summer Travel Rewards',
      *   description: 'Earn bonus points for summer and early fall bookings',
      *   endDate: '2024-09-30T23:59:59Z',  // Extended end date
      *   isActive: true
      * });
      *
-     * console.log('Campaign updated:', updated.title);
+     * console.log('Campaign updated:', updated.name);
      * console.log('New end date:', updated.endDate);
      * ```
      */
@@ -12665,7 +12696,7 @@ class CampaignManager {
      * console.log(`Total campaigns claimed: ${userClaims.length}`);
      *
      * userClaims.forEach((claim, index) => {
-     *   console.log(`\n${index + 1}. ${claim.campaign.title}`);
+     *   console.log(`\n${index + 1}. ${claim.campaign.name}`);
      *   console.log(`   Date: ${claim.claimedAt}`);
      *   console.log(`   Business: ${claim.business?.displayName || 'Direct'}`);
      *   console.log(`   Rewards: ${claim.rewards?.length || 0} items`);
@@ -12702,8 +12733,8 @@ class CampaignManager {
      *
      * // Analyze claims by campaign
      * const claimsByCampaign = businessClaims.reduce((acc, claim) => {
-     *   const title = claim.campaign.title;
-     *   acc[title] = (acc[title] || 0) + 1;
+     *   const campaignName = claim.campaign.name;
+     *   acc[campaignName] = (acc[campaignName] || 0) + 1;
      *   return acc;
      * }, {});
      *
@@ -12907,6 +12938,7 @@ class RedemptionManager {
      *
      * @param options - Optional filters and pagination:
      *   - `active`: Filter by active status (true/false). Admins only - regular users always see active offers
+     *   - `search`: Free text search across name, description, tags (case-insensitive)
      *   - Pagination options: `page`, `limit`, `sortBy`, `sortOrder`
      * @returns Promise resolving to paginated redemption offers
      *
@@ -12919,9 +12951,9 @@ class RedemptionManager {
      * console.log(`Showing ${offers.length} of ${pagination.total} offers`);
      *
      * offers.forEach(offer => {
-     *   console.log(`\n${offer.title}`);
+     *   console.log(`\n${offer.name}`);
      *   console.log(`${offer.description}`);
-     *   console.log(`Type: ${offer.redemptionType?.name || 'General'}`);
+     *   console.log(`Type: ${offer.type?.name || 'General'}`);
      *
      *   if (offer.tokenUnits?.length) {
      *     console.log('Cost:');
@@ -12944,6 +12976,23 @@ class RedemptionManager {
      * console.log(`\n${affordableOffers.length} offers within your budget`);
      * ```
      *
+     * @example Search Redemptions
+     * ```typescript
+     * // Search by text (matches name, description, tags)
+     * const { data: coffeeOffers } = await sdk.redemptions.getRedemptions({
+     *   search: 'coffee'
+     * });
+     *
+     * console.log(`Found ${coffeeOffers.length} coffee-related offers`);
+     *
+     * // Search with sorting
+     * const { data: sortedResults } = await sdk.redemptions.getRedemptions({
+     *   search: 'discount',
+     *   sortBy: 'name',
+     *   sortOrder: 'ASC'
+     * });
+     * ```
+     *
      * @example Admin - Manage All Redemptions
      * ```typescript
      * // Admins can see all redemptions and filter by status
@@ -12956,14 +13005,11 @@ class RedemptionManager {
      * console.log(`Active offers: ${activeOnly.length}`);
      * console.log(`Inactive offers: ${inactiveOnly.length}`);
      *
-     * // Analyze by type
-     * const offersByType = allRedemptions.reduce((acc, offer) => {
-     *   const type = offer.redemptionType?.name || 'Unspecified';
-     *   acc[type] = (acc[type] || 0) + 1;
-     *   return acc;
-     * }, {});
-     *
-     * console.log('\nBy type:', offersByType);
+     * // Search inactive redemptions
+     * const { data: inactiveVouchers } = await sdk.redemptions.getRedemptions({
+     *   active: false,
+     *   search: 'voucher'
+     * });
      * ```
      *
      * @example Pagination
@@ -13163,9 +13209,9 @@ class RedemptionManager {
      * console.log(`Redemption History (${userRedemptions.length} of ${pagination.total} items):`);
      *
      * userRedemptions.forEach((redemption, index) => {
-     *   console.log(`\n${index + 1}. ${redemption.redemption.title}`);
+     *   console.log(`\n${index + 1}. ${redemption.redemption.name}`);
      *   console.log(`   Date: ${new Date(redemption.redeemedAt).toLocaleDateString()}`);
-     *   console.log(`   Type: ${redemption.redemption.redemptionType?.name || 'General'}`);
+     *   console.log(`   Type: ${redemption.redemption.type?.name || 'General'}`);
      *
      *   if (redemption.voucherCode) {
      *     console.log(`   Voucher: ${redemption.voucherCode}`);
@@ -13284,7 +13330,7 @@ class RedemptionManager {
      * ```typescript
      * // Admin operation - create discount redemption
      * const newRedemption = await sdk.redemptions.createRedemption({
-     *   title: '20% Off Weekend Stay',
+     *   name: '20% Off Weekend Stay',
      *   description: 'Get 20% off your next weekend booking at partner hotels',
      *   redemptionTypeId: 'discount-type-id',
      *   isActive: true,
@@ -13293,7 +13339,7 @@ class RedemptionManager {
      *   validUntil: '2024-08-31T23:59:59Z'
      * });
      *
-     * console.log('New redemption created:', newRedemption.title);
+     * console.log('New redemption created:', newRedemption.name);
      * console.log('Redemption ID:', newRedemption.id);
      *
      * // Set redemption cost
@@ -13325,13 +13371,13 @@ class RedemptionManager {
      * ```typescript
      * // Admin operation - update redemption details
      * const updated = await sdk.redemptions.updateRedemption('weekend-discount', {
-     *   title: '25% Off Weekend Stay - Extended!',
+     *   name: '25% Off Weekend Stay - Extended!',
      *   description: 'Enhanced discount - now 25% off weekend bookings',
      *   availableQuantity: 150,  // Increased availability
      *   validUntil: '2024-09-30T23:59:59Z'  // Extended validity
      * });
      *
-     * console.log('Redemption updated:', updated.title);
+     * console.log('Redemption updated:', updated.name);
      * console.log('New quantity available:', updated.availableQuantity);
      * ```
      */
@@ -17630,7 +17676,9 @@ class PersSDK {
             }
         }
         try {
-            // Fetch user data to validate tokens and restore session
+            // Ensure token is valid (refresh if expired) before fetching user
+            await this.auth.ensureValidToken();
+            // Fetch user data to restore session
             const userData = await this.auth.getCurrentUser();
             // Emit event through proper event emitter
             this._events.emitSuccess({
@@ -18490,21 +18538,45 @@ function createReactNativeAuthProvider(projectKey, config = {}) {
     });
 }
 
-// Conditionally require quick-crypto for Native platforms only
-let crypto$1;
-if (reactNative.Platform.OS !== 'web') {
+// Lazy-loaded crypto module - initialized on first use to avoid native module timing issues
+let _crypto = null;
+let _cryptoInitialized = false;
+/**
+ * Lazily load the crypto module.
+ *
+ * Supports customer pre-initialization via global.__QuickCrypto for environments
+ * where native module timing is unpredictable (e.g., certain React Native setups).
+ *
+ * @returns The crypto module or null if unavailable
+ */
+function getCrypto() {
+    if (_cryptoInitialized) {
+        return _crypto;
+    }
+    _cryptoInitialized = true;
+    if (reactNative.Platform.OS === 'web') {
+        // On Web, we shouldn't be using this provider (Core SDK has WebDPoPProvider)
+        _crypto = {
+            generateKeyPair: () => { throw new Error('ReactNativeDPoPProvider not supported on Web'); },
+            randomUUID: () => globalThis.crypto?.randomUUID?.() || `${Date.now()}-${Math.random()}`
+        };
+        return _crypto;
+    }
+    // Check for customer pre-initialized global (for native module timing issues)
+    if (typeof global !== 'undefined' && global.__QuickCrypto) {
+        _crypto = global.__QuickCrypto;
+        return _crypto;
+    }
+    // Standard lazy load
     try {
-        crypto$1 = require('react-native-quick-crypto').default || require('react-native-quick-crypto');
+        _crypto = require('react-native-quick-crypto').default || require('react-native-quick-crypto');
     }
     catch (e) {
-        console.warn('ReactNativeDPoPProvider: Failed to load react-native-quick-crypto', e);
+        console.warn('ReactNativeDPoPProvider: Failed to load react-native-quick-crypto.', e);
+        console.warn('Tip: If you encounter timing issues, pre-initialize in index.js: global.__QuickCrypto = require("react-native-quick-crypto")');
+        _crypto = null;
     }
-}
-else {
-    // on Web, we shouldn't be using this provider anyway (Core SDK has WebDPoPProvider)
-    crypto$1 = {
-        generateKeyPair: () => { throw new Error('ReactNativeDPoPProvider not supported on Web'); }
-    };
+    return _crypto;
 }
 class ReactNativeDPoPProvider {
     /**
@@ -18514,13 +18586,17 @@ class ReactNativeDPoPProvider {
      * Falls back to Node.js crypto API on iOS if needed.
      */
     async generateKeyPair(options) {
+        const crypto = getCrypto();
+        if (!crypto) {
+            throw new Error('Crypto module not available. Install react-native-quick-crypto or pre-initialize global.__QuickCrypto');
+        }
         // Try WebCrypto API first (works on both iOS and Android)
-        if (crypto$1.subtle) {
+        if (crypto.subtle) {
             try {
-                const keyPair = await crypto$1.subtle.generateKey({ name: 'ECDSA', namedCurve: 'P-256' }, true, // extractable - required for JWK export
+                const keyPair = await crypto.subtle.generateKey({ name: 'ECDSA', namedCurve: 'P-256' }, true, // extractable - required for JWK export
                 ['sign', 'verify']);
-                const publicKeyJwk = await crypto$1.subtle.exportKey('jwk', keyPair.publicKey);
-                const privateKeyJwk = await crypto$1.subtle.exportKey('jwk', keyPair.privateKey);
+                const publicKeyJwk = await crypto.subtle.exportKey('jwk', keyPair.publicKey);
+                const privateKeyJwk = await crypto.subtle.exportKey('jwk', keyPair.privateKey);
                 return {
                     publicKey: publicKeyJwk,
                     privateKey: privateKeyJwk
@@ -18532,7 +18608,7 @@ class ReactNativeDPoPProvider {
         }
         // Fallback: Node.js crypto API (works on iOS)
         return new Promise((resolve, reject) => {
-            crypto$1.generateKeyPair('ec', { namedCurve: 'P-256' }, (err, publicKey, privateKey) => {
+            crypto.generateKeyPair('ec', { namedCurve: 'P-256' }, (err, publicKey, privateKey) => {
                 if (err)
                     return reject(err);
                 try {
@@ -18547,6 +18623,10 @@ class ReactNativeDPoPProvider {
         });
     }
     async signProof(payload, keyPair) {
+        const crypto = getCrypto();
+        if (!crypto) {
+            throw new Error('Crypto module not available for signing');
+        }
         // 1. Construct Header
         const header = {
             typ: 'dpop+jwt',
@@ -18557,17 +18637,17 @@ class ReactNativeDPoPProvider {
         const finalPayload = {
             ...payload,
             iat: payload.iat || Math.floor(Date.now() / 1000),
-            jti: payload.jti || crypto$1.randomUUID()
+            jti: payload.jti || (crypto.randomUUID?.() || `${Date.now()}-${Math.random()}`)
         };
         // 3. Encode
         const b64Header = this.base64Url(JSON.stringify(header));
         const b64Payload = this.base64Url(JSON.stringify(finalPayload));
         const signingInput = `${b64Header}.${b64Payload}`;
         // 4. Sign - try WebCrypto first, fallback to Node.js crypto
-        if (crypto$1.subtle) {
+        if (crypto.subtle) {
             try {
-                const privateKey = await crypto$1.subtle.importKey('jwk', keyPair.privateKey, { name: 'ECDSA', namedCurve: 'P-256' }, false, ['sign']);
-                const signatureBuffer = await crypto$1.subtle.sign({ name: 'ECDSA', hash: 'SHA-256' }, privateKey, buffer.Buffer.from(signingInput));
+                const privateKey = await crypto.subtle.importKey('jwk', keyPair.privateKey, { name: 'ECDSA', namedCurve: 'P-256' }, false, ['sign']);
+                const signatureBuffer = await crypto.subtle.sign({ name: 'ECDSA', hash: 'SHA-256' }, privateKey, buffer.Buffer.from(signingInput));
                 // WebCrypto returns signature in IEEE P1363 format (r || s), which is what we need for JWT
                 return `${signingInput}.${this.base64UrlBuffer(buffer.Buffer.from(signatureBuffer))}`;
             }
@@ -18576,24 +18656,28 @@ class ReactNativeDPoPProvider {
             }
         }
         // Fallback: Node.js crypto API
-        const sign = crypto$1.createSign('SHA256');
+        const sign = crypto.createSign('SHA256');
         sign.update(signingInput);
-        const privateKeyObj = crypto$1.createPrivateKey({ key: keyPair.privateKey, format: 'jwk' });
+        const privateKeyObj = crypto.createPrivateKey({ key: keyPair.privateKey, format: 'jwk' });
         const signature = sign.sign(privateKeyObj);
         return `${signingInput}.${this.base64UrlBuffer(signature)}`;
     }
     async hashAccessToken(accessToken) {
+        const crypto = getCrypto();
+        if (!crypto) {
+            throw new Error('Crypto module not available for hashing');
+        }
         // Try WebCrypto first
-        if (crypto$1.subtle) {
+        if (crypto.subtle) {
             try {
-                const hashBuffer = await crypto$1.subtle.digest('SHA-256', buffer.Buffer.from(accessToken));
+                const hashBuffer = await crypto.subtle.digest('SHA-256', buffer.Buffer.from(accessToken));
                 return this.base64UrlBuffer(buffer.Buffer.from(hashBuffer));
             }
             catch (err) {
                 // Fallback to Node.js crypto
             }
         }
-        const hash = crypto$1.createHash('sha256').update(accessToken).digest();
+        const hash = crypto.createHash('sha256').update(accessToken).digest();
         return this.base64UrlBuffer(hash);
     }
     // --- Helpers ---
@@ -40479,15 +40563,41 @@ const SigningStatus = {
     EXPIRED: 'expired'
 };
 
-// Dynamic import the signer SDK to avoid build issues with static dependencies
-let createPersSignerSDK = null;
-try {
-    const signerModule = require('@explorins/pers-signer/react-native');
-    createPersSignerSDK = signerModule.createPersSignerSDK;
-}
-catch (error) {
-    console.warn('[useTransactionSigner] PERS Signer SDK not available:', error.message);
-    console.warn('[useTransactionSigner] Real blockchain signing will not be available');
+// Lazy-loaded signer SDK factory - initialized on first use to avoid native module timing issues
+let _createPersSignerSDK = null;
+let _signerInitAttempted = false;
+/**
+ * Lazily load the PERS Signer SDK.
+ *
+ * Supports customer pre-initialization via global.__PersSigner for environments
+ * where native module timing is unpredictable (e.g., certain React Native setups).
+ *
+ * @returns The createPersSignerSDK function or null if unavailable
+ */
+function getSignerSDKFactory() {
+    if (_signerInitAttempted) {
+        // Already tried - return cached result (could be null if failed)
+        return _createPersSignerSDK;
+    }
+    _signerInitAttempted = true;
+    // Check for customer pre-initialized global (for native module timing issues)
+    if (typeof global !== 'undefined' && global.__PersSigner?.createPersSignerSDK) {
+        _createPersSignerSDK = global.__PersSigner.createPersSignerSDK;
+        return _createPersSignerSDK;
+    }
+    // Standard lazy load
+    try {
+        const signerModule = require('@explorins/pers-signer/react-native');
+        _createPersSignerSDK = signerModule.createPersSignerSDK;
+        return _createPersSignerSDK;
+    }
+    catch (error) {
+        console.warn('[useTransactionSigner] PERS Signer SDK not available:', error.message);
+        console.warn('[useTransactionSigner] Real blockchain signing will not be available');
+        console.warn('[useTransactionSigner] Tip: If timing issues, pre-initialize in index.js: global.__PersSigner = require("@explorins/pers-signer/react-native")');
+        _createPersSignerSDK = null; // Mark as unavailable
+        return null;
+    }
 }
 // Constants - TODO: Move to environment config later
 const DEFAULT_ETHERS_PROVIDER = "https://sepolia.infura.io/v3/2781b4b5242343d5b0954c98f287b29e";
@@ -40677,6 +40787,7 @@ const useTransactionSigner = () => {
     // Auto-initialize signer SDK when PERS SDK is ready
     react.useEffect(() => {
         const initializeSignerSDK = async () => {
+            const createPersSignerSDK = getSignerSDKFactory();
             if (!createPersSignerSDK) {
                 console.warn('[useTransactionSigner] Signer SDK not available');
                 return;
@@ -40791,7 +40902,7 @@ const useTransactionSigner = () => {
         if (!isSignerInitialized || !signerSDKRef.current) {
             throw new Error('Transaction signer not initialized');
         }
-        if (!createPersSignerSDK) {
+        if (!getSignerSDKFactory()) {
             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
@@ -40935,7 +41046,7 @@ const useTransactionSigner = () => {
          * );
          * ```
          */
-        isSignerAvailable: isSignerInitialized && !!createPersSignerSDK,
+        isSignerAvailable: isSignerInitialized && !!getSignerSDKFactory(),
         /**
          * Current signing status for UI feedback
          *
@@ -41830,6 +41941,35 @@ const useRedemptions = () => {
      * **Administrators:** Can see all redemptions and filter by active/inactive status
      *
      * The backend enforces permission-based filtering automatically.
+     *
+     * @param options - Filter and pagination options
+     * @param options.active - Filter by active status (Admin only)
+     * @param options.search - Free text search across name, description, tags
+     * @param options.page - Page number (1-indexed)
+     * @param options.limit - Results per page
+     * @param options.sortBy - Field to sort by ('name' | 'createdAt')
+     * @param options.sortOrder - Sort direction ('ASC' | 'DESC')
+     *
+     * @example Basic usage
+     * ```typescript
+     * const { data: offers } = await getRedemptions();
+     * ```
+     *
+     * @example Search redemptions
+     * ```typescript
+     * const { data: coffeeOffers } = await getRedemptions({ search: 'coffee' });
+     * ```
+     *
+     * @example With pagination and sorting
+     * ```typescript
+     * const { data, pagination } = await getRedemptions({
+     *   search: 'discount',
+     *   page: 1,
+     *   limit: 10,
+     *   sortBy: 'name',
+     *   sortOrder: 'ASC'
+     * });
+     * ```
      */
     const getRedemptions = react.useCallback(async (options) => {
         if (!isInitialized || !sdk) {