@explorins/pers-sdk-react-native 2.1.13 → 2.1.17

package/README.md

@@ -48,15 +48,110 @@ The SDK automatically installs the following native libraries. **You must rebuil
 npm install react-native-url-polyfill
 ```
 
+### Metro Configuration (Required)
+
+The PERS SDK uses subpath exports (`@explorins/pers-sdk/core`, etc.) which require Metro to be configured. Add to your `metro.config.js`:
+
+```javascript
+const { getDefaultConfig } = require('expo/metro-config');
+// or for bare RN: const { getDefaultConfig } = require('@react-native/metro-config');
+
+const config = getDefaultConfig(__dirname);
+
+// REQUIRED: Enable package exports for PERS SDK subpath imports
+config.resolver.unstable_enablePackageExports = true;
+
+module.exports = config;
+```
+
+---
+
+## ⚠️ Android Architecture Requirements
+
+**The SDK requires React Native New Architecture** starting from v2.1.x.
+
+### Why?
+
+`react-native-quick-crypto` v1.0+ (used for high-performance cryptographic operations) uses [Nitro Modules](https://github.com/margelo/nitro), which require New Architecture.
+
+### Quick Check
+
+If you see errors like:
+```
+NitroModulesProxy.createHybridObject(...) threw an unknown std::runtime_error
+```
+
+Your app is running with **Old Architecture** (`newArchEnabled=false`).
+
+### Solution 1: Enable New Architecture (Recommended)
+
+React Native 0.76+ has stable New Architecture support. Enable it in `android/gradle.properties`:
+
+```properties
+# android/gradle.properties
+
+# Use this property to enable support to the new architecture.
+newArchEnabled=true
+
+# Use this property to enable or disable the Hermes JS engine.
+hermesEnabled=true
+```
+
+Then clean and rebuild:
+
+```bash
+cd android && ./gradlew clean && cd ..
+npx react-native start --reset-cache
+npx react-native run-android
+```
+
+> **Reference**: See the [VQ Demo App's gradle.properties](https://github.com/explorins/vq-pers-integration-demo/blob/main/android/gradle.properties) for a working configuration with Expo SDK 54 and React Native 0.81.5.
+
+### Solution 2: Downgrade quick-crypto (For Old Architecture)
+
+If you must stay on Old Architecture, pin to v0.7.x:
+
+```json
+{
+  "resolutions": {
+    "react-native-quick-crypto": "0.7.17"
+  }
+}
+```
+
+Or for npm (in `package.json`):
+
+```json
+{
+  "overrides": {
+    "react-native-quick-crypto": "0.7.17"
+  }
+}
+```
+
+### Compatibility Matrix
+
+| RN Version | Architecture | quick-crypto | Status |
+|------------|--------------|--------------|--------|
+| 0.76+ | New (`newArchEnabled=true`) | 1.0.6+ | ✅ Recommended |
+| 0.76+ | Old (`newArchEnabled=false`) | 0.7.17 | ⚠️ Requires downgrade |
+| < 0.76 | Old | 0.7.x | ⚠️ Use older quick-crypto |
+
+> **See [Android Compatibility FAQ](https://github.com/eXplorins/pers-sdk/blob/main/packages/pers-sdk-react-native/docs/ANDROID_COMPATIBILITY_FAQ.md)** for detailed troubleshooting.
+
+---
 
 ## Critical Setup Requirement: Passkeys
 
-To enable Passkey authentication (WebAuthn) on iOS and Android, you **must** complete the setup in **[REACT_NATIVE_PASSKEY_SETUP.md](./REACT_NATIVE_PASSKEY_SETUP.md)**.
+To enable Passkey authentication (WebAuthn) on iOS and Android, you **must**:
+
+1. **Register your app with PERS backend** - Contact **support@explorins.com** with:
+   - iOS: Bundle ID + Apple Team ID
+   - Android: Package Name + SHA-256 fingerprint
+
+2. **Configure native files** - See [Passkey Setup Guide](https://github.com/eXplorins/pers-sdk/blob/main/packages/pers-sdk-react-native/REACT_NATIVE_PASSKEY_SETUP.md)
 
-This includes:
-- Registering your app with the PERS backend (required for OS trust)
-- Native configuration (Info.plist, AndroidManifest.xml)
-- Expo/development build setup
+3. **For Expo**: Use development builds (`npx expo run:android`), not Expo Go
 
 ## Quick Start
 
@@ -1027,16 +1122,15 @@ const tokens = (await getTokens()).data;
 
 ## Documentation
 
-### Core Guides
-- **[AUTH_STATE_HANDLING.md](./docs/AUTH_STATE_HANDLING.md)** - Comprehensive guide for handling authentication state changes
-  - Pattern examples for observing `isAuthenticated` state
-  - Custom UI for session expiration
-  - Platform-specific details (iOS Keychain, Android Keystore, Web)
-  - Best practices for auth state observation
+All documentation is available on GitHub:
 
-### Setup & Configuration
-- **[REACT_NATIVE_PASSKEY_SETUP.md](./REACT_NATIVE_PASSKEY_SETUP.md)** - Required setup for WebAuthn/Passkey authentication
-- **[DPOP_IMPLEMENTATION_GUIDE.md](./DPOP_IMPLEMENTATION_GUIDE.md)** - DPoP security implementation details
+| Guide | Description |
+|-------|-------------|
+| [Quick Setup Guide](https://github.com/eXplorins/pers-sdk/blob/main/packages/pers-sdk-react-native/docs/QUICK_SETUP_GUIDE.md) | Android + Passkey setup in one page |
+| [Passkey Setup](https://github.com/eXplorins/pers-sdk/blob/main/packages/pers-sdk-react-native/REACT_NATIVE_PASSKEY_SETUP.md) | WebAuthn/Passkey configuration |
+| [Android Compatibility](https://github.com/eXplorins/pers-sdk/blob/main/packages/pers-sdk-react-native/docs/ANDROID_COMPATIBILITY_FAQ.md) | New Architecture troubleshooting |
+| [Auth State Handling](https://github.com/eXplorins/pers-sdk/blob/main/packages/pers-sdk-react-native/docs/AUTH_STATE_HANDLING.md) | Session management patterns |
+| [Changelog](https://github.com/eXplorins/pers-sdk/blob/main/packages/pers-sdk-react-native/CHANGELOG.md) | Version history |
 
 ---
 

package/dist/hooks/index.d.ts

@@ -21,8 +21,9 @@ export type { TransactionSignerHook, SubmissionResult, AuthenticatedUser, Transa
 export type { AccountOwnedTokensResult, Web3Hook } from './useWeb3';
 export type { EventsHook, PersEvent, EventHandler, EventFilter, Unsubscribe } from './useEvents';
 export type { TokenBalanceWithToken, UseTokenBalancesOptions, UseTokenBalancesResult } from './useTokenBalances';
-export type { CampaignClaimFilters, CampaignHook, GetCampaignsOptions } from './useCampaigns';
-export type { RedemptionRedeemFilters, RedemptionHook } from './useRedemptions';
+export type { CampaignClaimFilters, CampaignFilterOptions, CampaignHook, GetCampaignsOptions } from './useCampaigns';
+export type { RedemptionRedeemFilters, RedemptionFilterOptions, RedemptionHook, GetRedemptionsOptions } from './useRedemptions';
+export type { BusinessFilterOptions, BusinessHook } from './useBusiness';
 export type { TransactionQueryOptions, TransactionHook } from './useTransactions';
 export type { TriggerSourceQueryOptions, TriggerSourceHook } from './useTriggerSources';
 export type { AnalyticsHook } from './useAnalytics';

package/dist/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACxB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,IAAI,iBAAiB,EACnC,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,wBAAwB,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACpE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACjG,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG9F,YAAY,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGhF,YAAY,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGlF,YAAY,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxF,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACxB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,IAAI,iBAAiB,EACnC,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,wBAAwB,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACpE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACjG,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGrH,YAAY,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAGhI,YAAY,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGzE,YAAY,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGlF,YAAY,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxF,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/hooks/useAnalytics.d.ts

@@ -1,4 +1,4 @@
-import { TransactionAnalyticsRequestDTO, TransactionAnalyticsResponseDTO, CampaignClaimAnalyticsRequestDTO, CampaignClaimAnalyticsResponseDTO, UserAnalyticsRequestDTO, UserAnalyticsResponseDTO, UserRankingAnalyticsRequestDTO, UserRankingAnalyticsResponseDTO, BusinessRankingAnalyticsRequestDTO, BusinessRankingAnalyticsResponseDTO, RetentionAnalyticsRequestDTO, RetentionAnalyticsResponseDTO } from '@explorins/pers-shared';
+import { TransactionAnalyticsRequestDTO, TransactionAnalyticsResponseDTO, CampaignClaimAnalyticsRequestDTO, CampaignClaimAnalyticsResponseDTO, UserAnalyticsRequestDTO, UserAnalyticsResponseDTO, UserRankingAnalyticsRequestDTO, UserRankingAnalyticsResponseDTO, BusinessRankingAnalyticsRequestDTO, BusinessRankingAnalyticsResponseDTO, RetentionAnalyticsRequestDTO, RetentionAnalyticsResponseDTO } from '@explorins/pers-sdk';
 /**
  * React hook for analytics operations in the PERS SDK
  *

package/dist/hooks/useAnalytics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAnalytics.d.ts","sourceRoot":"","sources":["../../src/hooks/useAnalytics.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,8BAA8B,EAC9B,+BAA+B,EAC/B,gCAAgC,EAChC,iCAAiC,EACjC,uBAAuB,EACvB,wBAAwB,EACxB,8BAA8B,EAC9B,+BAA+B,EAC/B,kCAAkC,EAClC,mCAAmC,EACnC,4BAA4B,EAC5B,6BAA6B,EAC9B,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,eAAO,MAAM,YAAY;uCAqBZ,8BAA8B,KACtC,QAAQ,+BAA+B,CAAC;yCAoChC,gCAAgC,KACxC,QAAQ,iCAAiC,CAAC;iCA+ClC,uBAAuB,KAC/B,QAAQ,wBAAwB,CAAC;+BAkDzB,8BAA8B,KACtC,QAAQ,+BAA+B,CAAC;mCAuChC,kCAAkC,KAC1C,QAAQ,mCAAmC,CAAC;sCAuCpC,4BAA4B,KACpC,QAAQ,6BAA6B,CAAC;;CAuB1C,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC"}
+{"version":3,"file":"useAnalytics.d.ts","sourceRoot":"","sources":["../../src/hooks/useAnalytics.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,8BAA8B,EAC9B,+BAA+B,EAC/B,gCAAgC,EAChC,iCAAiC,EACjC,uBAAuB,EACvB,wBAAwB,EACxB,8BAA8B,EAC9B,+BAA+B,EAC/B,kCAAkC,EAClC,mCAAmC,EACnC,4BAA4B,EAC5B,6BAA6B,EAC9B,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,eAAO,MAAM,YAAY;uCAqBZ,8BAA8B,KACtC,QAAQ,+BAA+B,CAAC;yCAoChC,gCAAgC,KACxC,QAAQ,iCAAiC,CAAC;iCA+ClC,uBAAuB,KAC/B,QAAQ,wBAAwB,CAAC;+BAkDzB,8BAA8B,KACtC,QAAQ,+BAA+B,CAAC;mCAuChC,kCAAkC,KAC1C,QAAQ,mCAAmC,CAAC;sCAuCpC,4BAA4B,KACpC,QAAQ,6BAA6B,CAAC;;CAuB1C,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/hooks/useAuth.d.ts

@@ -1,6 +1,6 @@
 import type { RawUserData } from '@explorins/pers-sdk/core';
 import { AccountOwnerType } from '@explorins/pers-sdk/core';
-import type { UserDTO, AdminDTO, SessionAuthContextResponseDTO } from '@explorins/pers-shared';
+import type { UserDTO, SessionAuthContextResponseDTO } from '@explorins/pers-sdk';
 export type { RawUserData };
 /**
  * React hook for authentication operations in the PERS SDK
@@ -42,14 +42,14 @@ export type { RawUserData };
 export declare const useAuth: () => {
     isInitialized: boolean;
     isAuthenticated: boolean;
-    user: UserDTO | AdminDTO | null;
+    user: UserDTO | import("@explorins/pers-sdk").AdminDTO | null;
     login: (jwtToken: string, userType?: AccountOwnerType) => Promise<SessionAuthContextResponseDTO>;
     loginWithRawData: (rawUserData: RawUserData) => Promise<void>;
     logout: () => Promise<void>;
     refreshUserData: () => Promise<void>;
     getCurrentUser: () => Promise<UserDTO>;
     checkIsAuthenticated: () => Promise<boolean>;
-    refreshTokens: (refreshToken?: string) => Promise<import("@explorins/pers-shared").SessionAuthResponseDTO>;
+    refreshTokens: (refreshToken?: string) => Promise<import("@explorins/pers-sdk").SessionAuthResponseDTO>;
     clearAuth: () => Promise<void>;
     hasValidAuth: () => Promise<boolean>;
 };

package/dist/hooks/useAuth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAuth.d.ts","sourceRoot":"","sources":["../../src/hooks/useAuth.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAG/F,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,OAAO;;;;sBA0ByB,MAAM,aAAY,gBAAgB,KAA2B,QAAQ,6BAA6B,CAAC;oCAuCrF,WAAW,KAAG,QAAQ,IAAI,CAAC;kBAuC/C,QAAQ,IAAI,CAAC;;0BA0BL,QAAQ,OAAO,CAAC;gCAmBV,QAAQ,OAAO,CAAC;mCAqBX,MAAM;qBAmBtB,QAAQ,IAAI,CAAC;wBAoBV,QAAQ,OAAO,CAAC;CAwB5D,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC"}
+{"version":3,"file":"useAuth.d.ts","sourceRoot":"","sources":["../../src/hooks/useAuth.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAGlF,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,OAAO;;;;sBA0ByB,MAAM,aAAY,gBAAgB,KAA2B,QAAQ,6BAA6B,CAAC;oCAgCrF,WAAW,KAAG,QAAQ,IAAI,CAAC;kBAgC/C,QAAQ,IAAI,CAAC;;0BA0BL,QAAQ,OAAO,CAAC;gCAmBV,QAAQ,OAAO,CAAC;mCAqBX,MAAM;qBAmBtB,QAAQ,IAAI,CAAC;wBAoBV,QAAQ,OAAO,CAAC;CAwB5D,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC"}

package/dist/hooks/useAuth.js

@@ -63,21 +63,15 @@ export const useAuth = () => {
             // Set token in auth provider
             await authProvider.setAccessToken(jwtToken);
             // Perform login using the manager
+            // SDK emits login_success event with user data - PersSDKProvider handles state sync
             const result = await sdk.auth.loginWithToken(jwtToken, userType);
-            const userData = result.user || result.admin;
-            if (userData) {
-                setAuthenticationState(userData, true);
-                return result;
-            }
-            else {
-                throw new Error('No user data returned from login');
-            }
+            return result;
         }
         catch (error) {
             console.error('Login failed:', error);
             throw error;
         }
-    }, [sdk, authProvider, setAuthenticationState]);
+    }, [sdk, authProvider]);
     /**
      * Logs in a user using raw user data (direct authentication bypass)
      *
@@ -96,24 +90,18 @@ export const useAuth = () => {
         }
         try {
             // Use the raw data login from the auth manager
+            // SDK emits login_success event with user data - PersSDKProvider handles state sync
             const result = await sdk.auth.loginWithRawData(rawUserData);
             // Set token from result
             if (result.accessToken) {
                 await authProvider.setAccessToken(result.accessToken);
             }
-            const userData = result.user;
-            if (userData) {
-                setAuthenticationState(userData, true);
-            }
-            else {
-                throw new Error('No user data returned from raw data login');
-            }
         }
         catch (error) {
             console.error('Raw data login failed:', error);
             throw error;
         }
-    }, [sdk, authProvider, setAuthenticationState]);
+    }, [sdk, authProvider]);
     /**
      * Logs out the current user and clears authentication state
      *

package/dist/hooks/useBusiness.d.ts

@@ -1,4 +1,5 @@
-import type { BusinessDTO, BusinessTypeDTO, BusinessUpdateRequestDTO, BusinessToggleActiveRequestDTO, PaginatedResponseDTO } from '@explorins/pers-shared';
+import type { BusinessDTO, BusinessTypeDTO, BusinessUpdateRequestDTO, BusinessToggleActiveRequestDTO, PaginatedResponseDTO, BusinessFilterOptions } from '@explorins/pers-sdk';
+export type { BusinessFilterOptions } from '@explorins/pers-sdk';
 /**
  * React hook for business operations in the PERS SDK
  *
@@ -36,7 +37,7 @@ import type { BusinessDTO, BusinessTypeDTO, BusinessUpdateRequestDTO, BusinessTo
 export declare const useBusiness: () => {
     getActiveBusinesses: () => Promise<PaginatedResponseDTO<BusinessDTO>>;
     getBusinessTypes: () => Promise<PaginatedResponseDTO<BusinessTypeDTO>>;
-    getBusinesses: () => Promise<PaginatedResponseDTO<BusinessDTO>>;
+    getBusinesses: (options?: BusinessFilterOptions) => Promise<PaginatedResponseDTO<BusinessDTO>>;
     getBusinessById: (businessId: string) => Promise<BusinessDTO | null>;
     getBusinessByAccount: (accountAddress: string) => Promise<BusinessDTO>;
     getBusinessesByType: (typeId: string) => Promise<PaginatedResponseDTO<BusinessDTO>>;

package/dist/hooks/useBusiness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useBusiness.d.ts","sourceRoot":"","sources":["../../src/hooks/useBusiness.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE3J;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,WAAW;+BAgB4B,QAAQ,qBAAqB,WAAW,CAAC,CAAC;4BA2B7C,QAAQ,qBAAqB,eAAe,CAAC,CAAC;yBA4BjD,QAAQ,qBAAqB,WAAW,CAAC,CAAC;kCAd/B,MAAM,KAAG,QAAQ,WAAW,GAAG,IAAI,CAAC;2CA4B3B,MAAM,KAAG,QAAQ,WAAW,CAAC;kCActC,MAAM,KAAG,QAAQ,qBAAqB,WAAW,CAAC,CAAC;kCA6BnD,MAAM,KAAG,QAAQ,WAAW,CAAC;iCAc9B,MAAM,gBAAgB,wBAAwB,KAAG,QAAQ,WAAW,CAAC;uCAc/D,MAAM,cAAc,8BAA8B,KAAG,QAAQ,WAAW,CAAC;;CA0BtI,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC"}
+{"version":3,"file":"useBusiness.d.ts","sourceRoot":"","sources":["../../src/hooks/useBusiness.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAG/K,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,WAAW;+BAgB4B,QAAQ,qBAAqB,WAAW,CAAC,CAAC;4BA2B7C,QAAQ,qBAAqB,eAAe,CAAC,CAAC;8BAsD1C,qBAAqB,KAAG,QAAQ,qBAAqB,WAAW,CAAC,CAAC;kCAxC9D,MAAM,KAAG,QAAQ,WAAW,GAAG,IAAI,CAAC;2CAsD3B,MAAM,KAAG,QAAQ,WAAW,CAAC;kCActC,MAAM,KAAG,QAAQ,qBAAqB,WAAW,CAAC,CAAC;kCA6BnD,MAAM,KAAG,QAAQ,WAAW,CAAC;iCAc9B,MAAM,gBAAgB,wBAAwB,KAAG,QAAQ,WAAW,CAAC;uCAc/D,MAAM,cAAc,8BAA8B,KAAG,QAAQ,WAAW,CAAC;;CA0BtI,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/hooks/useBusiness.js

@@ -101,12 +101,38 @@ export const useBusiness = () => {
             throw error;
         }
     }, [sdk, isInitialized]);
-    const getBusinesses = useCallback(async () => {
+    /**
+     * Admin: Get all businesses with optional filtering
+     *
+     * @param options - Filter and pagination options
+     * @returns Promise resolving to paginated businesses
+     *
+     * @example
+     * ```typescript
+     * // Get all businesses
+     * const { data } = await getBusinesses();
+     *
+     * // Filter by tag
+     * const tagged = await getBusinesses({ tag: 'restaurant' });
+     *
+     * // Multiple tags (OR match)
+     * const multiTag = await getBusinesses({ tag: ['restaurant', 'cafe'] });
+     *
+     * // With search and pagination
+     * const filtered = await getBusinesses({
+     *   search: 'coffee',
+     *   active: true,
+     *   page: 1,
+     *   limit: 20
+     * });
+     * ```
+     */
+    const getBusinesses = useCallback(async (options) => {
         if (!isInitialized || !sdk) {
             throw new Error('SDK not initialized. Call initialize() first.');
         }
         try {
-            const result = await sdk.businesses.getBusinesses();
+            const result = await sdk.businesses.getBusinesses(options);
             return result;
         }
         catch (error) {

package/dist/hooks/useCampaigns.d.ts

@@ -1,14 +1,22 @@
-import type { CampaignClaimRequestDTO, CampaignDTO, CampaignClaimDTO, CampaignTriggerDTO, PaginatedResponseDTO, CampaignClaimIncludeRelation, CampaignIncludeRelation, SortOrder } from '@explorins/pers-shared';
+import type { CampaignClaimRequestDTO, CampaignDTO, CampaignClaimDTO, CampaignTriggerDTO, PaginatedResponseDTO, CampaignClaimIncludeRelation, CampaignIncludeRelation, SortOrder } from '@explorins/pers-sdk';
 import type { CampaignClaimFilters } from '@explorins/pers-sdk/campaign';
 export type { CampaignClaimFilters } from '@explorins/pers-sdk/campaign';
+export type { CampaignFilterOptions } from '@explorins/pers-sdk';
 /**
  * Options for fetching campaigns
+ * @deprecated Use CampaignFilterOptions from '@explorins/pers-sdk/campaign' instead
  */
 export interface GetCampaignsOptions {
-    /** Filter by tag */
-    tag?: string;
+    /** Filter by tag(s) - single tag or array for OR match */
+    tags?: string | string[];
+    /** Free text search across name and description (case-insensitive) */
+    search?: string;
     /** Filter by business ID */
     businessId?: string;
+    /** Filter campaigns starting on or after this date */
+    startDate?: Date | string;
+    /** Filter campaigns ending on or before this date */
+    endDate?: Date | string;
     /** Page number (1-indexed) */
     page?: number;
     /** Items per page */
@@ -17,7 +25,7 @@ export interface GetCampaignsOptions {
     sortBy?: 'name' | 'createdAt' | 'startDate';
     /** Sort order */
     sortOrder?: SortOrder;
-    /** Relations to include: 'triggerSources', 'businesses' */
+    /** Relations to include: 'triggerSources', 'businesses', 'claimCount' */
     include?: CampaignIncludeRelation[];
 }
 export declare const useCampaigns: () => {

package/dist/hooks/useCampaigns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCampaigns.d.ts","sourceRoot":"","sources":["../../src/hooks/useCampaigns.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,uBAAuB,EACvB,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,SAAS,EAEV,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAGzE,YAAY,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,oBAAoB;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,CAAC;IAC5C,iBAAiB;IACjB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,uBAAuB,EAAE,CAAC;CACrC;AAED,eAAO,MAAM,YAAY;mCA6BX,mBAAmB,KAC5B,QAAQ,qBAAqB,WAAW,CAAC,CAAC;kCAgC/B,MAAM,YACR,uBAAuB,EAAE,KAClC,QAAQ,WAAW,GAAG,IAAI,CAAC;6BAuEoB,uBAAuB,KAAG,QAAQ,gBAAgB,GAAG,IAAI,CAAC;8BAmCzD;QACjD,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,4BAA4B,EAAE,CAAC;KAC1C,KAAG,QAAQ,qBAAqB,gBAAgB,CAAC,CAAC;+BAkBD,QAAQ,qBAAqB,kBAAkB,CAAC,CAAC;gCA0CvF,mBAAmB,GAAG;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KACnD,QAAQ,qBAAqB,WAAW,CAAC,CAAC;kCA+BjC,oBAAoB,YACpB,4BAA4B,EAAE,KACvC,QAAQ,qBAAqB,gBAAgB,CAAC,CAAC;wCAsBxC,MAAM,YACJ,4BAA4B,EAAE,KACvC,QAAQ,qBAAqB,gBAAgB,CAAC,CAAC;gDAsBpC,MAAM,YACR,4BAA4B,EAAE,KACvC,QAAQ,qBAAqB,gBAAgB,CAAC,CAAC;sCA4CpC,MAAM,mBACD,MAAM,KACtB,QAAQ,WAAW,CAAC;sCA4BT,MAAM,mBACD,MAAM,KACtB,QAAQ,WAAW,CAAC;;CA+BxB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC"}
+{"version":3,"file":"useCampaigns.d.ts","sourceRoot":"","sources":["../../src/hooks/useCampaigns.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,uBAAuB,EACvB,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,SAAS,EAGV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAGzE,YAAY,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC1B,qDAAqD;IACrD,OAAO,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IACxB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,CAAC;IAC5C,iBAAiB;IACjB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,yEAAyE;IACzE,OAAO,CAAC,EAAE,uBAAuB,EAAE,CAAC;CACrC;AAED,eAAO,MAAM,YAAY;mCAiCX,mBAAmB,KAC5B,QAAQ,qBAAqB,WAAW,CAAC,CAAC;kCAoC/B,MAAM,YACR,uBAAuB,EAAE,KAClC,QAAQ,WAAW,GAAG,IAAI,CAAC;6BAuEoB,uBAAuB,KAAG,QAAQ,gBAAgB,GAAG,IAAI,CAAC;8BAmCzD;QACjD,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,4BAA4B,EAAE,CAAC;KAC1C,KAAG,QAAQ,qBAAqB,gBAAgB,CAAC,CAAC;+BAkBD,QAAQ,qBAAqB,kBAAkB,CAAC,CAAC;gCA+CvF,mBAAmB,GAAG;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KACnD,QAAQ,qBAAqB,WAAW,CAAC,CAAC;kCA8CjC,oBAAoB,YACpB,4BAA4B,EAAE,KACvC,QAAQ,qBAAqB,gBAAgB,CAAC,CAAC;wCAsBxC,MAAM,YACJ,4BAA4B,EAAE,KACvC,QAAQ,qBAAqB,gBAAgB,CAAC,CAAC;gDAsBpC,MAAM,YACR,4BAA4B,EAAE,KACvC,QAAQ,qBAAqB,gBAAgB,CAAC,CAAC;sCA4CpC,MAAM,mBACD,MAAM,KACtB,QAAQ,WAAW,CAAC;sCA4BT,MAAM,mBACD,MAAM,KACtB,QAAQ,WAAW,CAAC;;CA+BxB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/hooks/useCampaigns.js

@@ -20,11 +20,15 @@ export const useCampaigns = () => {
      *   include: ['triggerSources', 'businesses']
      * });
      *
-     * // Filter by tag
-     * const { data } = await getActiveCampaigns({ tag: 'summer-promo' });
+     * // Filter by date range
+     * const { data } = await getActiveCampaigns({
+     *   startDate: '2026-05-01',
+     *   endDate: '2026-12-31'
+     * });
      *
-     * // Filter by business
-     * const { data } = await getActiveCampaigns({ businessId: 'business-123' });
+     * // Get campaigns with claim count
+     * const { data } = await getActiveCampaigns({ include: ['claimCount'] });
+     * data.forEach(c => console.log(`${c.name}: ${c.claimCount} claims`));
      * ```
      */
     const getActiveCampaigns = useCallback(async (options) => {
@@ -47,7 +51,7 @@ export const useCampaigns = () => {
      * Get campaign by ID with optional include relations
      *
      * @param campaignId - The campaign ID
-     * @param include - Relations to include: 'triggerSources', 'businesses'
+     * @param include - Relations to include: 'triggerSources', 'businesses', 'claimCount'
      * @returns Promise resolving to campaign data
      *
      * @example
@@ -55,6 +59,10 @@ export const useCampaigns = () => {
      * // Get campaign with all related data
      * const campaign = await getCampaignById('campaign-123', ['triggerSources', 'businesses']);
      * console.log('Trigger sources:', campaign.included?.triggerSources);
+     *
+     * // Get campaign with claim count
+     * const campaign = await getCampaignById('campaign-123', ['claimCount']);
+     * console.log('Total claims:', campaign.claimCount);
      * ```
      */
     const getCampaignById = useCallback(async (campaignId, include) => {
@@ -206,8 +214,13 @@ export const useCampaigns = () => {
      * // Get only active campaigns with trigger sources
      * const { data } = await getAllCampaigns({ active: true, include: ['triggerSources'] });
      *
-     * // Get inactive campaigns
-     * const { data } = await getAllCampaigns({ active: false });
+     * // Filter by date range with claim count
+     * const { data } = await getAllCampaigns({
+     *   startDate: '2026-05-01',
+     *   endDate: '2026-12-31',
+     *   include: ['claimCount']
+     * });
+     * data.forEach(c => console.log(`${c.name}: ${c.claimCount} claims`));
      *
      * // With pagination and sorting
      * const { data } = await getAllCampaigns({
@@ -234,7 +247,16 @@ export const useCampaigns = () => {
     /**
      * Admin: Get campaign claims with optional filters and include relations
      *
-     * @param filters - Optional filters for campaign, user, or business
+     * @param filters - Optional filters for campaign, user, business, and date range
+     * @param filters.campaignId - Filter by specific campaign ID
+     * @param filters.userId - Filter by user ID
+     * @param filters.businessId - Filter by business ID
+     * @param filters.dateFrom - Filter claims created on or after this date (ISO 8601 format)
+     * @param filters.dateTo - Filter claims created on or before this date (ISO 8601 format)
+     * @param filters.page - Page number (1-indexed)
+     * @param filters.limit - Items per page
+     * @param filters.sortBy - Field to sort by
+     * @param filters.sortOrder - Sort direction
      * @param include - Relations to include: 'campaign', 'user', 'business'
      * @returns Promise resolving to paginated campaign claims
      *
@@ -245,6 +267,12 @@ export const useCampaigns = () => {
      *
      * // Get claims for a specific campaign
      * const { data } = await getCampaignClaims({ campaignId: 'campaign-123' }, ['user', 'business']);
+     *
+     * // Filter by date range
+     * const { data } = await getCampaignClaims({
+     *   dateFrom: '2026-01-01',
+     *   dateTo: '2026-03-31'
+     * }, ['campaign']);
      * ```
      */
     const getCampaignClaims = useCallback(async (filters, include) => {

package/dist/hooks/useDonations.d.ts

@@ -1,4 +1,4 @@
-import type { DonationTypeDTO, PaginatedResponseDTO } from '@explorins/pers-shared';
+import type { DonationTypeDTO, PaginatedResponseDTO } from '@explorins/pers-sdk';
 /**
  * React hook for donation operations in the PERS SDK
  *

package/dist/hooks/useDonations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useDonations.d.ts","sourceRoot":"","sources":["../../src/hooks/useDonations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,YAAY;4BAgBwB,QAAQ,qBAAqB,eAAe,CAAC,CAAC;;CAkB9F,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC"}
+{"version":3,"file":"useDonations.d.ts","sourceRoot":"","sources":["../../src/hooks/useDonations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,YAAY;4BAgBwB,QAAQ,qBAAqB,eAAe,CAAC,CAAC;;CAkB9F,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/hooks/usePurchases.d.ts

@@ -1,6 +1,6 @@
-import type { PurchaseTokenDTO, PurchaseDTO, PaginatedResponseDTO } from '@explorins/pers-shared';
+import type { PurchaseTokenDTO, PurchaseDTO, PaginatedResponseDTO } from '@explorins/pers-sdk';
 export declare const usePurchases: () => {
-    createPaymentIntent: (amount: number, currency: string, receiptEmail: string, description: string) => Promise<import("@explorins/pers-shared").PaymentIntentDTO>;
+    createPaymentIntent: (amount: number, currency: string, receiptEmail: string, description: string) => Promise<import("@explorins/pers-sdk").PaymentIntentDTO>;
     getActivePurchaseTokens: () => Promise<PaginatedResponseDTO<PurchaseTokenDTO>>;
     getAllUserPurchases: () => Promise<PaginatedResponseDTO<PurchaseDTO>>;
     isAvailable: boolean;

package/dist/hooks/usePurchases.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePurchases.d.ts","sourceRoot":"","sources":["../../src/hooks/usePurchases.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAElG,eAAO,MAAM,YAAY;kCAIb,MAAM,YACJ,MAAM,gBACF,MAAM,eACP,MAAM;mCAeiC,QAAQ,qBAAqB,gBAAgB,CAAC,CAAC;+BAcnD,QAAQ,qBAAqB,WAAW,CAAC,CAAC;;CAuB7F,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC"}
+{"version":3,"file":"usePurchases.d.ts","sourceRoot":"","sources":["../../src/hooks/usePurchases.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE/F,eAAO,MAAM,YAAY;kCAIb,MAAM,YACJ,MAAM,gBACF,MAAM,eACP,MAAM;mCAeiC,QAAQ,qBAAqB,gBAAgB,CAAC,CAAC;+BAcnD,QAAQ,qBAAqB,WAAW,CAAC,CAAC;;CAuB7F,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/hooks/useRedemptions.d.ts

@@ -1,12 +1,35 @@
 import { OnStatusUpdateFn } from './useTransactionSigner';
-import type { RedemptionCreateRequestDTO, RedemptionDTO, RedemptionRedeemDTO, RedemptionRedeemRequestResponseDTO, RedemptionTypeDTO, PaginatedResponseDTO, RedemptionRedeemIncludeRelation, ProcessRecordStatus, DynamicContext } from '@explorins/pers-shared';
+import type { RedemptionCreateRequestDTO, RedemptionDTO, RedemptionRedeemDTO, RedemptionRedeemRequestResponseDTO, RedemptionTypeDTO, PaginatedResponseDTO, RedemptionRedeemIncludeRelation, RedemptionIncludeRelation, ProcessRecordStatus, DynamicContext, SortOrder } from '@explorins/pers-sdk';
 import type { RedemptionRedeemFilters } from '@explorins/pers-sdk/redemption';
 import type { PaginationOptions } from '@explorins/pers-sdk';
-export type { RedemptionRedeemFilters } from '@explorins/pers-sdk/redemption';
+export type { RedemptionRedeemFilters, RedemptionFilterOptions } from '@explorins/pers-sdk/redemption';
+/**
+ * Options for fetching redemptions with filtering and pagination
+ */
+export interface GetRedemptionsOptions {
+    /** Filter by active status (Admin only - regular users always see active offers) */
+    active?: boolean;
+    /** Free text search across name, description, tags (case-insensitive) */
+    search?: string;
+    /** Filter by tag(s) - single tag or array for OR match */
+    tags?: string | string[];
+    /** Filter redemptions starting on or after this date */
+    startDate?: Date | string;
+    /** Filter redemptions ending on or before this date */
+    endDate?: Date | string;
+    /** Relations to include: 'redeemCount' */
+    include?: RedemptionIncludeRelation[];
+    /** Page number (1-indexed) */
+    page?: number;
+    /** Results per page */
+    limit?: number;
+    /** Field to sort by */
+    sortBy?: 'name' | 'createdAt' | 'startDate';
+    /** Sort direction */
+    sortOrder?: SortOrder;
+}
 export declare const useRedemptions: () => {
-    getRedemptions: (options?: {
-        active?: boolean;
-    }) => Promise<PaginatedResponseDTO<RedemptionDTO>>;
+    getRedemptions: (options?: GetRedemptionsOptions) => Promise<PaginatedResponseDTO<RedemptionDTO>>;
     getUserRedemptions: (filters?: {
         redemptionId?: string;
         status?: ProcessRecordStatus;

package/dist/hooks/useRedemptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useRedemptions.d.ts","sourceRoot":"","sources":["../../src/hooks/useRedemptions.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0C,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAClG,OAAO,KAAK,EACV,0BAA0B,EAC1B,aAAa,EACb,mBAAmB,EACnB,kCAAkC,EAClC,iBAAiB,EACjB,oBAAoB,EACpB,+BAA+B,EAC/B,mBAAmB,EACnB,cAAc,EACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,YAAY,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAE9E,eAAO,MAAM,cAAc;+BAY2B;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAG,QAAQ,qBAAqB,aAAa,CAAC,CAAC;mCAyC3G;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,mBAAmB,CAAA;KAAE,YACvD,iBAAiB,YACjB,+BAA+B,EAAE,KAC1C,QAAQ,qBAAqB,mBAAmB,CAAC,CAAC;2BAkErC,MAAM,YACV;QAAE,OAAO,CAAC,EAAE,cAAc,CAAC;QAAC,cAAc,CAAC,EAAE,gBAAgB,CAAA;KAAE,KACxE,QAAQ,kCAAkC,CAAC;8BAmGG,QAAQ,qBAAqB,iBAAiB,CAAC,CAAC;qCA9BrF,uBAAuB,YACvB,+BAA+B,EAAE,KAC1C,QAAQ,qBAAqB,mBAAmB,CAAC,CAAC;uCAcO,0BAA0B,KAAG,QAAQ,aAAa,CAAC;qCA4BrD,MAAM,kBAAkB,0BAA0B,KAAG,QAAQ,aAAa,CAAC;2CAcrE,MAAM,KAAG,QAAQ,aAAa,CAAC;;;;CA4BhG,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC"}
+{"version":3,"file":"useRedemptions.d.ts","sourceRoot":"","sources":["../../src/hooks/useRedemptions.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0C,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAClG,OAAO,KAAK,EACV,0BAA0B,EAC1B,aAAa,EACb,mBAAmB,EACnB,kCAAkC,EAClC,iBAAiB,EACjB,oBAAoB,EACpB,+BAA+B,EAC/B,yBAAyB,EACzB,mBAAmB,EACnB,cAAc,EACd,SAAS,EACV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,uBAAuB,EAA2B,MAAM,gCAAgC,CAAC;AACvG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,YAAY,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAEvG;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,oFAAoF;IACpF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,wDAAwD;IACxD,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC1B,uDAAuD;IACvD,OAAO,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IACxB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACtC,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,CAAC;IAC5C,qBAAqB;IACrB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,eAAO,MAAM,cAAc;+BAqD2B,qBAAqB,KAAG,QAAQ,qBAAqB,aAAa,CAAC,CAAC;mCAyC5G;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,mBAAmB,CAAA;KAAE,YACvD,iBAAiB,YACjB,+BAA+B,EAAE,KAC1C,QAAQ,qBAAqB,mBAAmB,CAAC,CAAC;2BAkErC,MAAM,YACV;QAAE,OAAO,CAAC,EAAE,cAAc,CAAC;QAAC,cAAc,CAAC,EAAE,gBAAgB,CAAA;KAAE,KACxE,QAAQ,kCAAkC,CAAC;8BAmHG,QAAQ,qBAAqB,iBAAiB,CAAC,CAAC;qCA9BrF,uBAAuB,YACvB,+BAA+B,EAAE,KAC1C,QAAQ,qBAAqB,mBAAmB,CAAC,CAAC;uCAcO,0BAA0B,KAAG,QAAQ,aAAa,CAAC;qCA4BrD,MAAM,kBAAkB,0BAA0B,KAAG,QAAQ,aAAa,CAAC;2CAcrE,MAAM,KAAG,QAAQ,aAAa,CAAC;;;;CA4BhG,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/hooks/useRedemptions.js

@@ -11,6 +11,47 @@ export 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.startDate - Filter redemptions starting on or after this date
+     * @param options.endDate - Filter redemptions ending on or before this date
+     * @param options.include - Relations to include: 'redeemCount'
+     * @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 Filter by date range
+     * ```typescript
+     * const { data: dateFiltered } = await getRedemptions({
+     *   startDate: '2026-05-01',
+     *   endDate: '2026-06-30'
+     * });
+     * ```
+     *
+     * @example Get redemptions with redeem count
+     * ```typescript
+     * const { data: offers } = await getRedemptions({ include: ['redeemCount'] });
+     * offers.forEach(o => console.log(`${o.name}: ${o.redeemCount} redeems`));
+     * ```
+     *
+     * @example Search with pagination
+     * ```typescript
+     * const { data, pagination } = await getRedemptions({
+     *   search: 'discount',
+     *   page: 1,
+     *   limit: 10,
+     *   sortBy: 'name',
+     *   sortOrder: 'ASC'
+     * });
+     * ```
      */
     const getRedemptions = useCallback(async (options) => {
         if (!isInitialized || !sdk) {
@@ -166,7 +207,17 @@ export const useRedemptions = () => {
      *
      * Retrieves all redemption redeems across the platform with filtering.
      *
-     * @param filters - Optional filters for user, redemption, and pagination
+     * @param filters - Optional filters for user, redemption, date range, and pagination
+     * @param filters.userId - Filter by user ID
+     * @param filters.redemptionId - Filter by redemption offer ID
+     * @param filters.businessId - Filter by business ID (admin only)
+     * @param filters.status - Filter by processing status (PENDING, PROCESSING, COMPLETED, FAILED)
+     * @param filters.dateFrom - Filter redeems created on or after this date (ISO 8601 format)
+     * @param filters.dateTo - Filter redeems created on or before this date (ISO 8601 format)
+     * @param filters.page - Page number (1-indexed)
+     * @param filters.limit - Items per page
+     * @param filters.sortBy - Field to sort by
+     * @param filters.sortOrder - Sort direction
      * @param include - Relations to include: 'redemption', 'user', 'business'
      * @returns Promise resolving to paginated redemption redeems
      *
@@ -180,6 +231,12 @@ export const useRedemptions = () => {
      *   { userId: 'user-123' },
      *   ['redemption']
      * );
+     *
+     * // Filter by date range
+     * const { data } = await getRedemptionRedeems({
+     *   dateFrom: '2026-01-01',
+     *   dateTo: '2026-03-31'
+     * }, ['user', 'redemption']);
      * ```
      */
     const getRedemptionRedeems = useCallback(async (filters, include) => {

package/dist/hooks/useTenants.d.ts

@@ -1,4 +1,4 @@
-import type { TenantPublicDTO, TenantClientConfigDTO, AdminDTO, PaginatedResponseDTO } from '@explorins/pers-shared';
+import type { TenantPublicDTO, TenantClientConfigDTO, AdminDTO, PaginatedResponseDTO } from '@explorins/pers-sdk';
 export declare const useTenants: () => {
     getTenantInfo: () => Promise<TenantPublicDTO>;
     getClientConfig: () => Promise<TenantClientConfigDTO>;

package/dist/hooks/useTenants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTenants.d.ts","sourceRoot":"","sources":["../../src/hooks/useTenants.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAErH,eAAO,MAAM,UAAU;yBAGuB,QAAQ,eAAe,CAAC;2BActB,QAAQ,qBAAqB,CAAC;yBAchC,QAAQ,MAAM,CAAC;qBAcnB,QAAQ,qBAAqB,QAAQ,CAAC,CAAC;;CAqBhF,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC"}
+{"version":3,"file":"useTenants.d.ts","sourceRoot":"","sources":["../../src/hooks/useTenants.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAElH,eAAO,MAAM,UAAU;yBAGuB,QAAQ,eAAe,CAAC;2BActB,QAAQ,qBAAqB,CAAC;yBAchC,QAAQ,MAAM,CAAC;qBAcnB,QAAQ,qBAAqB,QAAQ,CAAC,CAAC;;CAqBhF,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC"}