@explorins/pers-sdk-react-native 2.3.6 → 2.3.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +1266 -1244
- package/dist/__tests__/PersSDKProvider.test.js +33 -0
- package/dist/hooks/useBusiness.d.ts +2 -2
- package/dist/hooks/useBusiness.d.ts.map +1 -1
- package/dist/hooks/useBusiness.js +2 -2
- package/dist/hooks/useIPFSUrl.d.ts +3 -3
- package/dist/hooks/useIPFSUrl.d.ts.map +1 -1
- package/dist/hooks/useIPFSUrl.js +7 -7
- package/dist/hooks/useTransactions.d.ts.map +1 -1
- package/dist/hooks/useTransactions.js +13 -5
- package/dist/hooks/useWeb3.js +4 -4
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2412 -492
- package/dist/index.js.map +1 -1
- package/dist/providers/PersSDKProvider.d.ts +4 -0
- package/dist/providers/PersSDKProvider.d.ts.map +1 -1
- package/dist/providers/PersSDKProvider.js +14 -0
- package/dist/providers/react-native-http-client.d.ts +2 -0
- package/dist/providers/react-native-http-client.d.ts.map +1 -1
- package/dist/providers/react-native-http-client.js +5 -2
- package/dist/storage/rn-secure-storage.d.ts.map +1 -1
- package/dist/storage/rn-secure-storage.js +21 -8
- package/package.json +3 -3
- package/src/__tests__/PersSDKProvider.test.tsx +484 -420
- package/src/__tests__/setup.ts +40 -40
- package/src/hooks/index.ts +60 -60
- package/src/hooks/useAnalytics.ts +327 -327
- package/src/hooks/useAuth.ts +265 -265
- package/src/hooks/useBookings.ts +191 -191
- package/src/hooks/useBusiness.ts +251 -251
- package/src/hooks/useCampaigns.ts +500 -500
- package/src/hooks/useDonations.ts +66 -66
- package/src/hooks/useEvents.ts +372 -372
- package/src/hooks/useFiles.ts +155 -155
- package/src/hooks/useIPFSUrl.ts +192 -192
- package/src/hooks/usePurchases.ts +65 -65
- package/src/hooks/useRedemptions.ts +467 -467
- package/src/hooks/useTenants.ts +72 -72
- package/src/hooks/useTokenBalances.ts +385 -385
- package/src/hooks/useTokens.ts +313 -313
- package/src/hooks/useTransactionSigner.ts +611 -611
- package/src/hooks/useTransactions.ts +299 -290
- package/src/hooks/useTriggerSources.ts +301 -301
- package/src/hooks/useUserStatus.ts +61 -61
- package/src/hooks/useUsers.ts +167 -167
- package/src/hooks/useWeb3.ts +355 -355
- package/src/index.ts +777 -774
- package/src/polyfills/index.ts +160 -160
- package/src/polyfills/web3-polyfills.ts +97 -97
- package/src/providers/PersSDKProvider.tsx +393 -374
- package/src/providers/react-native-auth-provider.ts +110 -110
- package/src/providers/react-native-http-client.ts +150 -145
- package/src/providers/rn-dpop-provider.ts +190 -190
- package/src/storage/async-storage-token-storage.ts +185 -185
- package/src/storage/rn-secure-storage.ts +182 -170
- package/src/types/react-native-globals.d.ts +45 -45
- package/src/utils/index.ts +8 -8
- package/src/utils/platform-detection.ts +86 -86
- package/dist/index-CzLxqePZ.js +0 -7717
- package/dist/index-CzLxqePZ.js.map +0 -1
|
@@ -1,67 +1,67 @@
|
|
|
1
|
-
import { useCallback } from 'react';
|
|
2
|
-
import { usePersSDK } from '../providers/PersSDKProvider';
|
|
3
|
-
import type { DonationTypeDTO, PaginatedResponseDTO } from '@explorins/pers-sdk';
|
|
4
|
-
|
|
5
|
-
/**
|
|
6
|
-
* React hook for donation operations in the PERS SDK
|
|
7
|
-
*
|
|
8
|
-
* Provides methods for managing donations and donation types within the platform.
|
|
9
|
-
* Supports retrieving available donation categories and types.
|
|
10
|
-
*
|
|
11
|
-
* @returns Donation hook with methods for donation management
|
|
12
|
-
*
|
|
13
|
-
* @example
|
|
14
|
-
* ```typescript
|
|
15
|
-
* function DonationsComponent() {
|
|
16
|
-
* const { getDonationTypes } = useDonations();
|
|
17
|
-
*
|
|
18
|
-
* const loadDonationTypes = async () => {
|
|
19
|
-
* try {
|
|
20
|
-
* const types = await getDonationTypes();
|
|
21
|
-
* console.log('Available donation types:', types);
|
|
22
|
-
* } catch (error) {
|
|
23
|
-
* console.error('Failed to load donation types:', error);
|
|
24
|
-
* }
|
|
25
|
-
* };
|
|
26
|
-
*
|
|
27
|
-
* return <button onClick={loadDonationTypes}>Load Donation Types</button>;
|
|
28
|
-
* }
|
|
29
|
-
* ```
|
|
30
|
-
*/
|
|
31
|
-
export const useDonations = () => {
|
|
32
|
-
const { sdk, isInitialized } = usePersSDK();
|
|
33
|
-
|
|
34
|
-
/**
|
|
35
|
-
* Retrieves all available donation types in the system
|
|
36
|
-
*
|
|
37
|
-
* @returns Promise resolving to array of donation types
|
|
38
|
-
* @throws Error if SDK is not initialized
|
|
39
|
-
*
|
|
40
|
-
* @example
|
|
41
|
-
* ```typescript
|
|
42
|
-
* const { getDonationTypes } = useDonations();
|
|
43
|
-
* const types = await getDonationTypes();
|
|
44
|
-
* console.log('Donation types:', types.map(t => t.name));
|
|
45
|
-
* ```
|
|
46
|
-
*/
|
|
47
|
-
const getDonationTypes = useCallback(async (): Promise<PaginatedResponseDTO<DonationTypeDTO>> => {
|
|
48
|
-
if (!isInitialized || !sdk) {
|
|
49
|
-
throw new Error('SDK not initialized. Call initialize() first.');
|
|
50
|
-
}
|
|
51
|
-
|
|
52
|
-
try {
|
|
53
|
-
const result = await sdk.donations.getDonationTypes();
|
|
54
|
-
return result;
|
|
55
|
-
} catch (error) {
|
|
56
|
-
console.error('Failed to fetch donation types:', error);
|
|
57
|
-
throw error;
|
|
58
|
-
}
|
|
59
|
-
}, [sdk, isInitialized]);
|
|
60
|
-
|
|
61
|
-
return {
|
|
62
|
-
getDonationTypes,
|
|
63
|
-
isAvailable: isInitialized && !!sdk?.donations,
|
|
64
|
-
};
|
|
65
|
-
};
|
|
66
|
-
|
|
1
|
+
import { useCallback } from 'react';
|
|
2
|
+
import { usePersSDK } from '../providers/PersSDKProvider';
|
|
3
|
+
import type { DonationTypeDTO, PaginatedResponseDTO } from '@explorins/pers-sdk';
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* React hook for donation operations in the PERS SDK
|
|
7
|
+
*
|
|
8
|
+
* Provides methods for managing donations and donation types within the platform.
|
|
9
|
+
* Supports retrieving available donation categories and types.
|
|
10
|
+
*
|
|
11
|
+
* @returns Donation hook with methods for donation management
|
|
12
|
+
*
|
|
13
|
+
* @example
|
|
14
|
+
* ```typescript
|
|
15
|
+
* function DonationsComponent() {
|
|
16
|
+
* const { getDonationTypes } = useDonations();
|
|
17
|
+
*
|
|
18
|
+
* const loadDonationTypes = async () => {
|
|
19
|
+
* try {
|
|
20
|
+
* const types = await getDonationTypes();
|
|
21
|
+
* console.log('Available donation types:', types);
|
|
22
|
+
* } catch (error) {
|
|
23
|
+
* console.error('Failed to load donation types:', error);
|
|
24
|
+
* }
|
|
25
|
+
* };
|
|
26
|
+
*
|
|
27
|
+
* return <button onClick={loadDonationTypes}>Load Donation Types</button>;
|
|
28
|
+
* }
|
|
29
|
+
* ```
|
|
30
|
+
*/
|
|
31
|
+
export const useDonations = () => {
|
|
32
|
+
const { sdk, isInitialized } = usePersSDK();
|
|
33
|
+
|
|
34
|
+
/**
|
|
35
|
+
* Retrieves all available donation types in the system
|
|
36
|
+
*
|
|
37
|
+
* @returns Promise resolving to array of donation types
|
|
38
|
+
* @throws Error if SDK is not initialized
|
|
39
|
+
*
|
|
40
|
+
* @example
|
|
41
|
+
* ```typescript
|
|
42
|
+
* const { getDonationTypes } = useDonations();
|
|
43
|
+
* const types = await getDonationTypes();
|
|
44
|
+
* console.log('Donation types:', types.map(t => t.name));
|
|
45
|
+
* ```
|
|
46
|
+
*/
|
|
47
|
+
const getDonationTypes = useCallback(async (): Promise<PaginatedResponseDTO<DonationTypeDTO>> => {
|
|
48
|
+
if (!isInitialized || !sdk) {
|
|
49
|
+
throw new Error('SDK not initialized. Call initialize() first.');
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
try {
|
|
53
|
+
const result = await sdk.donations.getDonationTypes();
|
|
54
|
+
return result;
|
|
55
|
+
} catch (error) {
|
|
56
|
+
console.error('Failed to fetch donation types:', error);
|
|
57
|
+
throw error;
|
|
58
|
+
}
|
|
59
|
+
}, [sdk, isInitialized]);
|
|
60
|
+
|
|
61
|
+
return {
|
|
62
|
+
getDonationTypes,
|
|
63
|
+
isAvailable: isInitialized && !!sdk?.donations,
|
|
64
|
+
};
|
|
65
|
+
};
|
|
66
|
+
|
|
67
67
|
export type DonationHook = ReturnType<typeof useDonations>;
|