@explorins/pers-sdk-react-native 1.5.36 → 2.0.0

package/dist/index.d.ts

@@ -144,6 +144,7 @@ export { PersSDKProvider, usePersSDK, type PersConfig, type PersSDKContext } fro
  * - `useAnalytics` - Usage analytics and reporting
  * - `useFiles` - File upload and management
  * - `useWeb3` - Blockchain integration and wallet operations
+ * - `useEvents` - ** SDK event subscriptions for notifications**
  *
  * @example
  * **Token Operations:**
@@ -184,9 +185,30 @@ export { PersSDKProvider, usePersSDK, type PersConfig, type PersSDKContext } fro
  *   };
  * }
  * ```
+ *
+ * @example
+ * **Event Subscriptions:**
+ * ```typescript
+ * import { useEvents, useEffect } from '@explorins/pers-sdk-react-native';
+ *
+ * function NotificationHandler() {
+ *   const { subscribe, isAvailable } = useEvents();
+ *
+ *   useEffect(() => {
+ *     if (!isAvailable) return;
+ *
+ *     const unsubscribe = subscribe((event) => {
+ *       showNotification(event.userMessage, event.level);
+ *     });
+ *
+ *     return () => unsubscribe();
+ *   }, [subscribe, isAvailable]);
+ * }
+ * ```
  */
-export { useAuth, useTokens, useTransactions, useTransactionSigner, SigningStatus, useBusiness, useCampaigns, useRedemptions, useWeb3, usePurchases, useTenants, useUsers, useUserStatus, useFiles, useAnalytics, useDonations } from './hooks';
+export { useAuth, useTokens, useTransactions, useTransactionSigner, SigningStatus, useBusiness, useCampaigns, useRedemptions, useWeb3, usePurchases, useTenants, useUsers, useUserStatus, useFiles, useAnalytics, useDonations, useEvents } from './hooks';
 export type { OnStatusUpdateFn, StatusUpdateData, SigningStatusType } from './hooks';
+export type { EventsHook, PersEvent, EventHandler, EventFilter, Unsubscribe } from './hooks';
 /**
  * React Native-optimized HTTP client with automatic request/response handling
  *
@@ -235,4 +257,64 @@ export * from '@explorins/pers-shared';
  * @see {@link TokenCollection} - Collection of tokens for batch operations
  */
 export type { TokenBalanceRequest, TokenBalance, TokenMetadata, TokenCollection, TokenCollectionRequest } from '@explorins/pers-sdk/web3';
+/**
+ * Transaction Request Factory Functions
+ *
+ * Factory functions for creating properly structured transaction DTOs.
+ * Prioritizes accountId/accountType over raw addresses for security and consistency.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   buildMintRequest,
+ *   buildTransferRequest,
+ *   buildBurnRequest,
+ *   useTransactions,
+ *   AccountOwnerType
+ * } from '@explorins/pers-sdk-react-native';
+ *
+ * function TokenOperations() {
+ *   const { createTransaction } = useTransactions();
+ *
+ *   const handleMint = async () => {
+ *     const request = buildMintRequest({
+ *       amount: 100,
+ *       contractAddress: '0x...',
+ *       chainId: 137,
+ *       recipientAccountType: AccountOwnerType.USER,
+ *       recipientAccountId: 'user-123'
+ *     });
+ *     await createTransaction(request);
+ *   };
+ * }
+ * ```
+ *
+ * @see {@link buildMintRequest} - Create mint transaction requests
+ * @see {@link buildBurnRequest} - Create burn transaction requests
+ * @see {@link buildTransferRequest} - Create transfer transaction requests
+ * @see {@link buildPOSTransferRequest} - Create POS transfer requests (business submits on behalf of user)
+ * @see {@link buildPOSBurnRequest} - Create POS burn requests (business submits burn on behalf of user)
+ * @see {@link buildSubmissionRequest} - Create submission requests from QR/signature data
+ */
+export { buildMintRequest, buildBurnRequest, buildTransferRequest, buildPOSTransferRequest, buildPOSBurnRequest, buildSubmissionRequest } from '@explorins/pers-sdk/transaction';
+export type { POSAuthorizationOptions } from '@explorins/pers-sdk/transaction';
+/**
+ * SDK Error classes for type checking in catch blocks
+ *
+ * @example
+ * ```typescript
+ * import { PersApiError } from '@explorins/pers-sdk-react-native';
+ *
+ * try {
+ *   await sdk.campaigns.claimCampaign({ campaignId });
+ * } catch (error) {
+ *   if (error instanceof PersApiError) {
+ *     console.log(error.message);  // Clean backend message
+ *     console.log(error.code);     // e.g., 'CAMPAIGN_BUSINESS_REQUIRED'
+ *     console.log(error.status);   // e.g., 400
+ *   }
+ * }
+ * ```
+ */
+export { PersApiError, AuthenticationError } from '@explorins/pers-sdk/core';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAGH,OAAO,aAAa,CAAC;AAMrB;;;;;;;;GAQG;AACH,OAAO,EACL,6BAA6B,EAC7B,KAAK,qBAAqB,EAC3B,MAAM,wCAAwC,CAAC;AAMhD;;;;;;;;;;GAUG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAEvE;;;;;;;;GAQG;AACH,OAAO,EACL,wBAAwB,GACzB,MAAM,uCAAuC,CAAC;AAM/C;;;GAGG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAMvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,EACL,eAAe,EACf,UAAU,EACV,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,6BAA6B,CAAC;AAMrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AACH,OAAO,EACL,OAAO,EACP,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,cAAc,EACd,OAAO,EACP,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,YAAY,EACb,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAMrF;;;;;;GAMG;AACH,OAAO,EACL,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAM9C;;;;;;;;GAQG;AACH,OAAO,EACL,8BAA8B,EAC/B,MAAM,aAAa,CAAC;AAMrB;;;;;;;;;;;;;;;GAeG;AACH,cAAc,wBAAwB,CAAC;AAEvC;;;;;;;;;;;GAWG;AACH,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,sBAAsB,EACvB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAGH,OAAO,aAAa,CAAC;AAMrB;;;;;;;;GAQG;AACH,OAAO,EACL,6BAA6B,EAC7B,KAAK,qBAAqB,EAC3B,MAAM,wCAAwC,CAAC;AAMhD;;;;;;;;;;GAUG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAEvE;;;;;;;;GAQG;AACH,OAAO,EACL,wBAAwB,GACzB,MAAM,uCAAuC,CAAC;AAM/C;;;GAGG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAMvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,EACL,eAAe,EACf,UAAU,EACV,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,6BAA6B,CAAC;AAMrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0FG;AACH,OAAO,EACL,OAAO,EACP,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,cAAc,EACd,OAAO,EACP,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,SAAS,EACV,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAGrF,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAM7F;;;;;;GAMG;AACH,OAAO,EACL,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAM9C;;;;;;;;GAQG;AACH,OAAO,EACL,8BAA8B,EAC/B,MAAM,aAAa,CAAC;AAMrB;;;;;;;;;;;;;;;GAeG;AACH,cAAc,wBAAwB,CAAC;AAEvC;;;;;;;;;;;GAWG;AACH,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAMlC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,iCAAiC,CAAC;AAEzC,YAAY,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAM/E;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}