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

package/dist/providers/PersSDKProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PersSDKProvider.d.ts","sourceRoot":"","sources":["../../src/providers/PersSDKProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAuC,SAAS,EAA2C,MAAM,OAAO,CAAC;AAEvH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAIpF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAkB3D,YAAY,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAE7B,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IAGpB,YAAY,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAGzC,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,CAAC;IAGhC,UAAU,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,sBAAsB,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,EAAE,eAAe,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5F,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,cAAc,EAAE,MAAM,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CAC/C;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC;IACrC,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,CAwOA,CAAC;AAGF,eAAO,MAAM,UAAU,QAAO,cAQ7B,CAAC"}
+{"version":3,"file":"PersSDKProvider.d.ts","sourceRoot":"","sources":["../../src/providers/PersSDKProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAuC,SAAS,EAA2C,MAAM,OAAO,CAAC;AAEvH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAIpF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAkB3D,YAAY,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAE7B,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IAGpB,YAAY,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAGzC,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,CAAC;IAGhC,UAAU,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,sBAAsB,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,EAAE,eAAe,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5F,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,cAAc,EAAE,MAAM,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CAC/C;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC;IACrC,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,CA6NA,CAAC;AAGF,eAAO,MAAM,UAAU,QAAO,cAQ7B,CAAC"}

package/dist/providers/PersSDKProvider.js

@@ -38,6 +38,7 @@ const SDKContext = createContext(null);
  */
 export const PersSDKProvider = ({ children, config }) => {
     const initializingRef = useRef(false);
+    const eventUnsubscribeRef = useRef(null);
     // State refs for stable functions to read current values
     const sdkRef = useRef(null);
     const isInitializedRef = useRef(false);
@@ -91,6 +92,21 @@ export const PersSDKProvider = ({ children, config }) => {
             };
             // Initialize PersSDK with platform-aware auth provider
             const sdkInstance = new PersSDK(httpClient, sdkConfig);
+            // Subscribe to auth events BEFORE exposing SDK to consumers
+            // This ensures no events are missed due to React timing
+            eventUnsubscribeRef.current = sdkInstance.events.subscribe((event) => {
+                if (event.type === 'session_restored' || event.type === 'login_success') {
+                    const details = event.details;
+                    if (details?.user) {
+                        setUser(details.user);
+                        setIsAuthenticated(true);
+                    }
+                }
+                if (event.type === 'logout_success' || event.type === 'session_restoration_failed' || event.code === 'AUTH_FAILED') {
+                    setUser(null);
+                    setIsAuthenticated(false);
+                }
+            }, { domains: ['authentication'], replay: true });
             setAuthProvider(authProvider);
             setSdk(sdkInstance);
             setIsInitialized(true);
@@ -104,6 +120,15 @@ export const PersSDKProvider = ({ children, config }) => {
             initializingRef.current = false;
         }
     }, [isInitialized]);
+    // Cleanup subscription on unmount
+    useEffect(() => {
+        return () => {
+            if (eventUnsubscribeRef.current) {
+                eventUnsubscribeRef.current();
+                eventUnsubscribeRef.current = null;
+            }
+        };
+    }, []);
     const setAuthenticationState = useCallback((user, isAuthenticated) => {
         setUser(user);
         setIsAuthenticated(isAuthenticated);
@@ -150,42 +175,7 @@ export const PersSDKProvider = ({ children, config }) => {
             console.error('[PersSDK] Failed to restore session:', error);
             throw error;
         }
-    }, [setAuthenticationState]); // Depends on setAuthenticationState
-    // Listen for authentication events from core SDK
-    // Set up immediately when SDK is created (don't wait for isInitialized)
-    // to catch session_restored events that fire during SDK initialization
-    useEffect(() => {
-        if (!sdk)
-            return;
-        const unsubscribe = sdk.events.subscribe((event) => {
-            if (event.domain !== 'authentication')
-                return;
-            // Session restored successfully - sync React state
-            if (event.type === 'session_restored') {
-                console.log('[PersSDK] Session restoration event received, syncing state...');
-                // Read user from event details if available, otherwise fetch
-                const userId = event.details?.userId;
-                if (userId) {
-                    // User ID available, fetch user data
-                    sdk.users.getCurrentUser()
-                        .then(userData => {
-                        setAuthenticationState(userData, true);
-                    })
-                        .catch(error => {
-                        console.error('[PersSDK] Failed to sync restored session:', error);
-                    });
-                }
-            }
-            // Session restoration failed or auth error - clear React state
-            if (event.type === 'session_restoration_failed' || event.code === 'AUTH_FAILED') {
-                console.log('[PersSDK] Authentication failed - clearing session');
-                setAuthenticationState(null, false);
-            }
-        }, { domains: ['authentication'] });
-        return () => {
-            unsubscribe();
-        };
-    }, [sdk, setAuthenticationState]);
+    }, [setAuthenticationState]);
     // iOS/Android: Monitor app state and validate tokens when app becomes active
     useEffect(() => {
         if (!sdk || Platform.OS === 'web') {
@@ -193,7 +183,6 @@ export const PersSDKProvider = ({ children, config }) => {
         }
         const handleAppStateChange = async (nextAppState) => {
             if (nextAppState === 'active' && isAuthenticated) {
-                console.log('[PersSDK] App became active - validating tokens');
                 try {
                     // Trigger token validation when app resumes from background
                     // This ensures tokens are checked after extended inactivity

package/package.json

@@ -1,182 +1,182 @@
-{
-  "name": "@explorins/pers-sdk-react-native",
-  "version": "2.1.14-beta.0",
-  "description": "React Native SDK for PERS Platform - Tourism Loyalty System with Blockchain Transaction Signing and WebAuthn Authentication",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "scripts": {
-    "build": "tsc && rollup -c --bundleConfigAsCjs",
-    "build:watch": "rollup -c --bundleConfigAsCjs --watch",
-    "dev": "tsc --watch",
-    "clean": "rimraf dist",
-    "docs": "typedoc",
-    "docs:dev": "typedoc --watch",
-    "docs:json": "typedoc --json docs/api.json",
-    "docs:serve": "npx http-server docs -p 8080",
-    "prepublishOnly": "npm run clean && npm run build",
-    "publish-version": "npm run clean && npm run build && npm version patch && npm publish",
-    "publish-with-docs": "npm run clean && npm run build && npm run docs && npm version patch && npm publish",
-    "yalc:publish": "npm version patch --no-git-tag-version && npm run build && yalc publish",
-    "yalc:push": "npm version patch --no-git-tag-version && npm run build && yalc push"
-  },
-  "keywords": [
-    "pers",
-    "sdk",
-    "react-native",
-    "tourism",
-    "loyalty",
-    "blockchain",
-    "web3",
-    "webauthn",
-    "transaction-signing",
-    "rewards",
-    "authentication",
-    "biometrics",
-    "secure-storage"
-  ],
-  "author": "eXplorins",
-  "license": "MIT",
-  "dependencies": {
-    "@explorins/pers-sdk": "^2.1.21",
-    "@explorins/pers-signer": "^1.0.33",
-    "buffer": "^6.0.3",
-    "ethers": "^6.15.0",
-    "react-native-get-random-values": "^2.0.0",
-    "react-native-keychain": "^10.0.0",
-    "react-native-passkey": "^3.3.2",
-    "react-native-quick-crypto": "^1.0.6"
-  },
-  "browser": {
-    "crypto": false,
-    "url": false,
-    "http": false,
-    "https": false,
-    "zlib": false,
-    "stream": false,
-    "assert": false,
-    "path": false,
-    "fs": false,
-    "os": false,
-    "readable-stream": false,
-    "util": false,
-    "events": false,
-    "net": false,
-    "tls": false,
-    "child_process": false,
-    "pngjs": false,
-    "pngjs/lib/bitmapper": false,
-    "pngjs/lib/parser-async": false,
-    "pngjs/lib/parser-sync": false,
-    "./bitmapper": false,
-    "hash-base": false,
-    "@ethereumjs/common": false,
-    "@ethereumjs/tx": false,
-    "@ethereumjs/util": false,
-    "stream-browserify": false,
-    "crypto-browserify": false,
-    "inherits": false,
-    "safe-buffer": false,
-    "string_decoder": false,
-    "process-nextick-args": false,
-    "isarray": false,
-    "core-util-is": false,
-    "util-deprecate": false,
-    "ethereum-cryptography": false,
-    "keccak": false,
-    "secp256k1": false,
-    "scrypt-js": false,
-    "bech32": false,
-    "ws": false,
-    "xhr2-cookies": false,
-    "aes-js": false,
-    "@ethersproject/sha2": false,
-    "@ethersproject/pbkdf2": false,
-    "@ethersproject/scrypt": false
-  },
-  "peerDependencies": {
-    "@react-native-async-storage/async-storage": ">=1.15.0",
-    "react": ">=16.8.0",
-    "react-native": ">=0.60.0"
-  },
-  "peerDependenciesMeta": {
-    "react-native-keychain": {
-      "optional": true
-    },
-    "@react-native-async-storage/async-storage": {
-      "optional": false
-    },
-    "react-native-get-random-values": {
-      "optional": true
-    },
-    "react-native-url-polyfill": {
-      "optional": true
-    },
-    "react-native-polyfill-globals": {
-      "optional": true
-    },
-    "web-streams-polyfill": {
-      "optional": true
-    }
-  },
-  "overrides": {
-    "readable-stream": false,
-    "@ethereumjs/common": false,
-    "@ethereumjs/util": false,
-    "@ethereumjs/rlp": false,
-    "@ethereumjs/tx": false,
-    "stream": false,
-    "util": false,
-    "events": false,
-    "crypto": false,
-    "fs": false,
-    "path": false,
-    "os": false,
-    "net": false,
-    "tls": false,
-    "child_process": false,
-    "hash-base": false,
-    "inherits": false,
-    "safe-buffer": false,
-    "string_decoder": false,
-    "process-nextick-args": false,
-    "isarray": false,
-    "core-util-is": false,
-    "util-deprecate": false,
-    "ethereum-cryptography": false,
-    "keccak": false,
-    "secp256k1": false,
-    "scrypt-js": false,
-    "bech32": false,
-    "ws": false,
-    "xhr2-cookies": false,
-    "aes-js": false,
-    "@ethersproject/sha2": false,
-    "@ethersproject/pbkdf2": false,
-    "@ethersproject/scrypt": false
-  },
-  "devDependencies": {
-    "@explorins/pers-shared": "^2.1.123",
-    "@react-native-async-storage/async-storage": "^3.0.2",
-    "@rollup/plugin-commonjs": "^25.0.7",
-    "@rollup/plugin-json": "^6.1.0",
-    "@rollup/plugin-node-resolve": "^15.2.3",
-    "@types/react": "^19.1.1",
-    "@types/react-native": "^0.72.8",
-    "rimraf": "^5.0.0",
-    "rollup": "^4.0.0",
-    "rollup-plugin-typescript2": "^0.36.0",
-    "typedoc": "^0.25.13",
-    "typedoc-plugin-markdown": "^3.17.1",
-    "typescript": "^5.2.0"
-  },
-  "files": [
-    "dist/**/*",
-    "src/**/*",
-    "README.md"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/eXplorins/pers-sdk.git",
-    "directory": "packages/pers-sdk-react-native"
-  }
-}
+{
+  "name": "@explorins/pers-sdk-react-native",
+  "version": "2.1.18",
+  "description": "React Native SDK for PERS Platform - Tourism Loyalty System with Blockchain Transaction Signing and WebAuthn Authentication",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc && rollup -c --bundleConfigAsCjs",
+    "build:watch": "rollup -c --bundleConfigAsCjs --watch",
+    "dev": "tsc --watch",
+    "clean": "rimraf dist",
+    "docs": "typedoc",
+    "docs:dev": "typedoc --watch",
+    "docs:json": "typedoc --json docs/api.json",
+    "docs:serve": "npx http-server docs -p 8080",
+    "prepublishOnly": "npm run clean && npm run build",
+    "publish-version": "npm run clean && npm run build && npm version patch && npm publish",
+    "publish-with-docs": "npm run clean && npm run build && npm run docs && npm version patch && npm publish",
+    "yalc:publish": "npm version patch --no-git-tag-version && npm run build && yalc publish",
+    "yalc:push": "npm version patch --no-git-tag-version && npm run build && yalc push"
+  },
+  "keywords": [
+    "pers",
+    "sdk",
+    "react-native",
+    "tourism",
+    "loyalty",
+    "blockchain",
+    "web3",
+    "webauthn",
+    "transaction-signing",
+    "rewards",
+    "authentication",
+    "biometrics",
+    "secure-storage"
+  ],
+  "author": "eXplorins",
+  "license": "MIT",
+  "dependencies": {
+    "@explorins/pers-sdk": "^2.1.26",
+    "@explorins/pers-signer": "^1.0.33",
+    "buffer": "^6.0.3",
+    "ethers": "^6.15.0",
+    "react-native-get-random-values": "^2.0.0",
+    "react-native-keychain": "^10.0.0",
+    "react-native-passkey": "^3.3.2",
+    "react-native-quick-crypto": "^1.0.6"
+  },
+  "browser": {
+    "crypto": false,
+    "url": false,
+    "http": false,
+    "https": false,
+    "zlib": false,
+    "stream": false,
+    "assert": false,
+    "path": false,
+    "fs": false,
+    "os": false,
+    "readable-stream": false,
+    "util": false,
+    "events": false,
+    "net": false,
+    "tls": false,
+    "child_process": false,
+    "pngjs": false,
+    "pngjs/lib/bitmapper": false,
+    "pngjs/lib/parser-async": false,
+    "pngjs/lib/parser-sync": false,
+    "./bitmapper": false,
+    "hash-base": false,
+    "@ethereumjs/common": false,
+    "@ethereumjs/tx": false,
+    "@ethereumjs/util": false,
+    "stream-browserify": false,
+    "crypto-browserify": false,
+    "inherits": false,
+    "safe-buffer": false,
+    "string_decoder": false,
+    "process-nextick-args": false,
+    "isarray": false,
+    "core-util-is": false,
+    "util-deprecate": false,
+    "ethereum-cryptography": false,
+    "keccak": false,
+    "secp256k1": false,
+    "scrypt-js": false,
+    "bech32": false,
+    "ws": false,
+    "xhr2-cookies": false,
+    "aes-js": false,
+    "@ethersproject/sha2": false,
+    "@ethersproject/pbkdf2": false,
+    "@ethersproject/scrypt": false
+  },
+  "peerDependencies": {
+    "@react-native-async-storage/async-storage": ">=1.15.0",
+    "react": ">=16.8.0",
+    "react-native": ">=0.60.0"
+  },
+  "peerDependenciesMeta": {
+    "react-native-keychain": {
+      "optional": true
+    },
+    "@react-native-async-storage/async-storage": {
+      "optional": false
+    },
+    "react-native-get-random-values": {
+      "optional": true
+    },
+    "react-native-url-polyfill": {
+      "optional": true
+    },
+    "react-native-polyfill-globals": {
+      "optional": true
+    },
+    "web-streams-polyfill": {
+      "optional": true
+    }
+  },
+  "overrides": {
+    "readable-stream": false,
+    "@ethereumjs/common": false,
+    "@ethereumjs/util": false,
+    "@ethereumjs/rlp": false,
+    "@ethereumjs/tx": false,
+    "stream": false,
+    "util": false,
+    "events": false,
+    "crypto": false,
+    "fs": false,
+    "path": false,
+    "os": false,
+    "net": false,
+    "tls": false,
+    "child_process": false,
+    "hash-base": false,
+    "inherits": false,
+    "safe-buffer": false,
+    "string_decoder": false,
+    "process-nextick-args": false,
+    "isarray": false,
+    "core-util-is": false,
+    "util-deprecate": false,
+    "ethereum-cryptography": false,
+    "keccak": false,
+    "secp256k1": false,
+    "scrypt-js": false,
+    "bech32": false,
+    "ws": false,
+    "xhr2-cookies": false,
+    "aes-js": false,
+    "@ethersproject/sha2": false,
+    "@ethersproject/pbkdf2": false,
+    "@ethersproject/scrypt": false
+  },
+  "devDependencies": {
+    "@explorins/pers-shared": "^2.1.128",
+    "@react-native-async-storage/async-storage": "^3.0.2",
+    "@rollup/plugin-commonjs": "^25.0.7",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@types/react": "^19.1.1",
+    "@types/react-native": "^0.72.8",
+    "rimraf": "^5.0.0",
+    "rollup": "^4.0.0",
+    "rollup-plugin-typescript2": "^0.36.0",
+    "typedoc": "^0.25.13",
+    "typedoc-plugin-markdown": "^3.17.1",
+    "typescript": "^5.2.0"
+  },
+  "files": [
+    "dist/**/*",
+    "src/**/*",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eXplorins/pers-sdk.git",
+    "directory": "packages/pers-sdk-react-native"
+  }
+}

package/src/hooks/index.ts

@@ -38,10 +38,13 @@ export type {
 } from './useTokenBalances';
 
 // Export campaign-related types
-export type { CampaignClaimFilters, CampaignHook, GetCampaignsOptions } from './useCampaigns';
+export type { CampaignClaimFilters, CampaignFilterOptions, CampaignHook, GetCampaignsOptions } from './useCampaigns';
 
 // Export redemption-related types
-export type { RedemptionRedeemFilters, RedemptionHook } from './useRedemptions';
+export type { RedemptionRedeemFilters, RedemptionFilterOptions, RedemptionHook, GetRedemptionsOptions } from './useRedemptions';
+
+// Export business-related types
+export type { BusinessFilterOptions, BusinessHook } from './useBusiness';
 
 // Export transaction-related types
 export type { TransactionQueryOptions, TransactionHook } from './useTransactions';

package/src/hooks/useAnalytics.ts

@@ -13,7 +13,7 @@ import {
   BusinessRankingAnalyticsResponseDTO,
   RetentionAnalyticsRequestDTO,
   RetentionAnalyticsResponseDTO
-} from '@explorins/pers-shared';
+} from '@explorins/pers-sdk';
 
 /**
  * React hook for analytics operations in the PERS SDK

package/src/hooks/useAuth.ts

@@ -2,7 +2,7 @@ import { useCallback } from 'react';
 import { usePersSDK } from '../providers/PersSDKProvider';
 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';
 
 // Re-export RawUserData for convenience
 export type { RawUserData };
@@ -50,8 +50,7 @@ export const useAuth = () => {
     authProvider, 
     isInitialized, 
     isAuthenticated, 
-    user, 
-    setAuthenticationState, 
+    user,
     refreshUserData 
   } = usePersSDK();
   
@@ -79,23 +78,15 @@ export const useAuth = () => {
       // Set token in auth provider
       await authProvider.setAccessToken(jwtToken);
       
-      // Perform login using the manager
+      // Perform login - emits login_success event which Provider handles
       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)
@@ -115,26 +106,18 @@ export const useAuth = () => {
     }
 
     try {
-      // Use the raw data login from the auth manager
+      // Use the raw data login - emits login_success event which Provider handles
       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
@@ -149,17 +132,18 @@ export const useAuth = () => {
    * ```
    */
   const logout = useCallback(async (): Promise<void> => {
+    if (!sdk) {
+      throw new Error('SDK not initialized. Call initialize() first.');
+    }
+    
     try {
-      if (authProvider) {
-        await authProvider.clearTokens();
-      }
-      
-      setAuthenticationState(null, false);
+      // clearAuth emits logout_success event which Provider handles
+      await sdk.auth.clearAuth();
     } catch (error) {
       console.error('Logout failed:', error);
       throw error;
     }
-  }, [authProvider, setAuthenticationState]);
+  }, [sdk]);
 
   /**
    * Retrieves the current authenticated user data
@@ -237,9 +221,9 @@ export const useAuth = () => {
     if (!sdk) {
       throw new Error('SDK not initialized. Call initialize() first.');
     }
+    // clearAuth emits logout_success event which Provider handles
     await sdk.auth.clearAuth();
-    setAuthenticationState(null, false);
-  }, [sdk, setAuthenticationState]);
+  }, [sdk]);
 
   /**
    * Checks if the current authentication is valid (non-expired)

package/src/hooks/useBusiness.ts

@@ -1,6 +1,9 @@
 import { useCallback } from 'react';
 import { usePersSDK } from '../providers/PersSDKProvider';
-import type { BusinessDTO, BusinessTypeDTO, BusinessUpdateRequestDTO, BusinessToggleActiveRequestDTO, PaginatedResponseDTO } from '@explorins/pers-shared';
+import type { BusinessDTO, BusinessTypeDTO, BusinessUpdateRequestDTO, BusinessToggleActiveRequestDTO, PaginatedResponseDTO, BusinessFilterOptions } from '@explorins/pers-sdk';
+
+// Re-export for consumers
+export type { BusinessFilterOptions } from '@explorins/pers-sdk';
 
 /**
  * React hook for business operations in the PERS SDK
@@ -107,13 +110,39 @@ export const useBusiness = () => {
     }
   }, [sdk, isInitialized]);
 
-  const getBusinesses = useCallback(async (): Promise<PaginatedResponseDTO<BusinessDTO>> => {
+  /**
+   * 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?: BusinessFilterOptions): Promise<PaginatedResponseDTO<BusinessDTO>> => {
     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) {
       console.error('Failed to fetch all businesses:', error);