@explorins/pers-sdk-react-native 1.5.33 → 1.5.34

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.
Files changed (2) hide show
  1. package/README.md +105 -45
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -176,17 +176,29 @@ function RewardScreen() {
176
176
  ```typescript
177
177
  // Authentication management
178
178
  const {
179
+ isInitialized,
179
180
  isAuthenticated,
180
181
  user,
181
- login,
182
- logout
182
+ login,
183
+ loginWithRawData,
184
+ logout,
185
+ refreshUserData,
186
+ getCurrentUser,
187
+ checkIsAuthenticated,
188
+ refreshTokens,
189
+ clearAuth,
190
+ hasValidAuth
183
191
  } = useAuth();
184
192
 
185
193
  // User profile operations
186
194
  const {
187
- getUserProfile,
188
- updateUserProfile,
189
- getUserPublicData
195
+ getCurrentUser,
196
+ updateCurrentUser,
197
+ getUserById,
198
+ getAllUsersPublic,
199
+ getAllUsers, // Admin
200
+ updateUser, // Admin
201
+ toggleUserStatus // Admin
190
202
  } = useUsers();
191
203
  ```
192
204
 
@@ -198,21 +210,30 @@ const {
198
210
  getTokens,
199
211
  getActiveCreditToken,
200
212
  getRewardTokens,
213
+ getTokenTypes,
214
+ getStatusTokens,
201
215
  getTokenByContract
202
216
  } = useTokens();
203
217
 
204
218
  // Transaction history
205
219
  const {
206
- getUserTransactionHistory,
220
+ createTransaction,
207
221
  getTransactionById,
208
- createTransaction
222
+ getUserTransactionHistory,
223
+ getTenantTransactions, // Admin
224
+ getPaginatedTransactions, // Admin
225
+ exportTransactionsCSV, // Admin
226
+ signingStatus, // UI feedback during blockchain signing
227
+ signingStatusMessage
209
228
  } = useTransactions();
210
229
 
211
230
  // Blockchain transaction signing
212
231
  const {
213
232
  signAndSubmitTransactionWithJWT,
214
233
  isSignerAvailable,
215
- isSignerInitialized
234
+ isSignerInitialized,
235
+ currentStatus,
236
+ statusMessage
216
237
  } = useTransactionSigner();
217
238
  ```
218
239
 
@@ -221,23 +242,42 @@ const {
221
242
  ```typescript
222
243
  // Business operations
223
244
  const {
224
- getBusinessProfile,
225
- updateBusinessProfile,
226
- getBusinessTypes
245
+ getActiveBusinesses,
246
+ getBusinessTypes,
247
+ getBusinesses,
248
+ getBusinessById,
249
+ getBusinessByAccount,
250
+ getBusinessesByType,
251
+ createBusiness, // Admin
252
+ updateBusiness, // Admin
253
+ toggleBusinessStatus // Admin
227
254
  } = useBusiness();
228
255
 
229
256
  // Campaign management
230
257
  const {
231
258
  getActiveCampaigns,
232
- participateInCampaign,
233
- claimCampaignReward
259
+ getCampaignById,
260
+ claimCampaign,
261
+ getUserClaims,
262
+ getCampaignTriggers,
263
+ getAllCampaigns, // Admin
264
+ getCampaignClaims, // Admin
265
+ getCampaignClaimsByUserId, // Admin
266
+ getCampaignClaimsByBusinessId // Admin
234
267
  } = useCampaigns();
235
268
 
236
269
  // Redemption system
237
270
  const {
238
- redeem,
271
+ getActiveRedemptions,
239
272
  getUserRedemptions,
240
- getActiveRedemptions
273
+ redeem,
274
+ getRedemptionTypes,
275
+ signingStatus, // UI feedback during blockchain signing
276
+ signingStatusMessage,
277
+ createRedemption, // Admin
278
+ getAllRedemptions, // Admin
279
+ updateRedemption, // Admin
280
+ toggleRedemptionStatus // Admin
241
281
  } = useRedemptions();
242
282
  ```
243
283
 
@@ -246,31 +286,54 @@ const {
246
286
  ```typescript
247
287
  // Purchase processing
248
288
  const {
249
- createPurchase,
250
- getUserPurchases,
251
- processPayment
289
+ createPaymentIntent,
290
+ getActivePurchaseTokens,
291
+ getAllUserPurchases
252
292
  } = usePurchases();
253
293
 
254
294
  // Multi-tenant support
255
295
  const {
256
- getTenantConfig,
257
- updateTenantConfig,
258
- getTenantAdmins
296
+ getTenantInfo,
297
+ getClientConfig,
298
+ getLoginToken,
299
+ getAdmins
259
300
  } = useTenants();
260
301
 
261
302
  // Analytics & reporting
262
303
  const {
263
- getTransactionAnalytics,
264
- getUserAnalytics,
265
- getBusinessAnalytics
304
+ getTransactionAnalytics
266
305
  } = useAnalytics();
267
306
 
268
- // Web3 & blockchain
307
+ // Web3 & blockchain (wallet addresses from user.wallets)
269
308
  const {
270
- getWalletBalance,
271
- createWallet,
272
- getTransactionHistory
309
+ getTokenBalance,
310
+ getTokenMetadata,
311
+ getTokenCollection,
312
+ resolveIPFSUrl,
313
+ fetchAndProcessMetadata,
314
+ getChainDataById,
315
+ getExplorerUrl
273
316
  } = useWeb3();
317
+
318
+ // User status & achievements
319
+ const {
320
+ getUserStatusTypes,
321
+ getEarnedUserStatus,
322
+ createUserStatusType // Admin
323
+ } = useUserStatus();
324
+
325
+ // File management
326
+ const {
327
+ getSignedPutUrl,
328
+ getSignedGetUrl,
329
+ getSignedUrl,
330
+ optimizeMedia
331
+ } = useFiles();
332
+
333
+ // Donations
334
+ const {
335
+ getDonationTypes
336
+ } = useDonations();
274
337
  ```
275
338
 
276
339
  ## EVM Blockchain Transaction Signing
@@ -455,25 +518,22 @@ function ErrorHandlingExample() {
455
518
  import { useAnalytics } from '@explorins/pers-sdk-react-native';
456
519
 
457
520
  function AnalyticsExample() {
458
- const {
459
- getTransactionAnalytics,
460
- getUserAnalytics,
461
- trackEvent
462
- } = useAnalytics();
521
+ const { getTransactionAnalytics } = useAnalytics();
463
522
 
464
523
  const loadAnalytics = async () => {
465
- const txAnalytics = await getTransactionAnalytics({
466
- dateRange: { start: '2023-01-01', end: '2023-12-31' }
467
- });
468
-
469
- const userAnalytics = await getUserAnalytics();
470
-
471
- // Track custom events
472
- await trackEvent('reward_claimed', {
473
- amount: 100,
474
- type: 'discount_voucher',
475
- timestamp: new Date().toISOString()
476
- });
524
+ try {
525
+ const txAnalytics = await getTransactionAnalytics({
526
+ groupBy: ['day'],
527
+ metrics: ['count', 'sum'],
528
+ startDate: '2023-01-01',
529
+ endDate: '2023-12-31'
530
+ });
531
+
532
+ console.log('Transaction analytics:', txAnalytics.results);
533
+ console.log('Execution time:', txAnalytics.metadata?.executionTime);
534
+ } catch (error) {
535
+ console.error('Failed to load analytics:', error);
536
+ }
477
537
  };
478
538
  }
479
539
  ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@explorins/pers-sdk-react-native",
3
- "version": "1.5.33",
3
+ "version": "1.5.34",
4
4
  "description": "React Native SDK for PERS Platform - Tourism Loyalty System with Blockchain Transaction Signing and WebAuthn Authentication",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",