@explorins/pers-sdk-react-native 2.1.3 → 2.1.6

package/dist/hooks/useTransactions.js

@@ -109,25 +109,32 @@ export const useTransactions = () => {
         }
     }, [sdk, isInitialized, signAndSubmitTransactionWithJWT, isSignerAvailable]);
     /**
-     * Retrieves a specific transaction by its ID
+     * Retrieves a specific transaction by its ID with optional include relations
      *
      * @param transactionId - Unique identifier of the transaction
+     * @param include - Optional relations to include (sender, recipient, business) for enriched entity data
      * @returns Promise resolving to transaction data or null if not found
      * @throws Error if SDK is not initialized
      *
      * @example
      * ```typescript
      * const { getTransactionById } = useTransactions();
+     *
+     * // Basic retrieval
      * const transaction = await getTransactionById('txn-123');
-     * console.log('Transaction details:', transaction);
+     *
+     * // With enriched sender/recipient data
+     * const enrichedTx = await getTransactionById('txn-123', ['sender', 'recipient', 'business']);
+     * console.log('Sender:', enrichedTx?.included?.sender);
+     * console.log('Business:', enrichedTx?.included?.engagedBusiness?.displayName);
      * ```
      */
-    const getTransactionById = useCallback(async (transactionId) => {
+    const getTransactionById = useCallback(async (transactionId, include) => {
         if (!isInitialized || !sdk) {
             throw new Error('SDK not initialized. Call initialize() first.');
         }
         try {
-            const result = await sdk.transactions.getTransactionById(transactionId);
+            const result = await sdk.transactions.getTransactionById(transactionId, include);
             return result;
         }
         catch (error) {
@@ -136,25 +143,48 @@ export const useTransactions = () => {
         }
     }, [sdk, isInitialized]);
     /**
-     * Retrieves transaction history for the authenticated user, filtered by role
+     * Retrieves transaction history for the authenticated user with comprehensive filtering
      *
-     * @param role - Optional transaction role filter (TransactionRole.SENDER, TransactionRole.RECIPIENT)
-     * @returns Promise resolving to array of user's transactions
+     * Supports filtering by role, status, type, business, token, and more.
+     * Optionally enrich with related entities (sender, recipient, business).
+     *
+     * @param options - Query options including filters, pagination, and include relations
+     * @returns Promise resolving to paginated array of user's transactions
      * @throws Error if SDK is not initialized
      *
      * @example
      * ```typescript
      * const { getUserTransactionHistory } = useTransactions();
-     * const sentTransactions = await getUserTransactionHistory(TransactionRole.SENDER);
-     * const allTransactions = await getUserTransactionHistory(); // No filter
+     *
+     * // Simple: Get all transactions
+     * const allTransactions = await getUserTransactionHistory();
+     *
+     * // Filter by role (legacy support)
+     * const sentTransactions = await getUserTransactionHistory({ role: 'SENDER' });
+     *
+     * // Advanced filtering with include relations
+     * const filtered = await getUserTransactionHistory({
+     *   role: 'SENDER',
+     *   status: 'COMPLETED',
+     *   engagedBusinessId: 'business-123',
+     *   include: ['recipient', 'business'],
+     *   page: 1,
+     *   limit: 20
+     * });
+     *
+     * // Access enriched data
+     * filtered.data.forEach(tx => {
+     *   console.log('Recipient:', tx.included?.recipient);
+     *   console.log('Business:', tx.included?.engagedBusiness?.displayName);
+     * });
      * ```
      */
-    const getUserTransactionHistory = useCallback(async (role) => {
+    const getUserTransactionHistory = useCallback(async (options) => {
         if (!isInitialized || !sdk) {
             throw new Error('SDK not initialized. Call initialize() first.');
         }
         try {
-            const result = await sdk.transactions.getUserTransactionHistory(role);
+            const result = await sdk.transactions.getUserTransactionHistory(options);
             return result;
         }
         catch (error) {
@@ -162,25 +192,39 @@ export const useTransactions = () => {
             throw error;
         }
     }, [sdk, isInitialized]);
-    const getTenantTransactions = useCallback(async () => {
-        if (!isInitialized || !sdk) {
-            throw new Error('SDK not initialized. Call initialize() first.');
-        }
-        try {
-            const result = await sdk.transactions.getTenantTransactions();
-            return result;
-        }
-        catch (error) {
-            console.error('Failed to fetch tenant transactions:', error);
-            throw error;
-        }
-    }, [sdk, isInitialized]);
-    const getPaginatedTransactions = useCallback(async (params) => {
+    /**
+     * Admin: Get paginated transactions with optional include relations
+     *
+     * @param params - Pagination and filtering parameters
+     * @param include - Optional relations to include for enriched entity data
+     * @returns Promise resolving to paginated transaction results
+     * @throws Error if SDK is not initialized
+     *
+     * @example
+     * ```typescript
+     * const { getPaginatedTransactions } = useTransactions();
+     *
+     * // Basic pagination
+     * const result = await getPaginatedTransactions({ page: 1, limit: 50 });
+     *
+     * // With include relations
+     * const enrichedResult = await getPaginatedTransactions(
+     *   { page: 1, limit: 50, sortBy: 'createdAt', sortOrder: 'DESC' },
+     *   include: ['sender', 'recipient', 'business']
+     * });
+     *
+     * enrichedResult.data.forEach(tx => {
+     *   console.log('From:', tx.included?.sender);
+     *   console.log('To:', tx.included?.recipient);
+     * });
+     * ```
+     */
+    const getPaginatedTransactions = useCallback(async (options) => {
         if (!isInitialized || !sdk) {
             throw new Error('SDK not initialized. Call initialize() first.');
         }
         try {
-            const result = await sdk.transactions.getPaginatedTransactions(params);
+            const result = await sdk.transactions.getPaginatedTransactions(options);
             return result;
         }
         catch (error) {
@@ -205,7 +249,6 @@ export const useTransactions = () => {
         createTransaction,
         getTransactionById,
         getUserTransactionHistory,
-        getTenantTransactions,
         getPaginatedTransactions,
         exportTransactionsCSV,
         isAvailable: isInitialized && !!sdk?.transactions,

package/dist/hooks/useTriggerSources.d.ts

@@ -0,0 +1,76 @@
+import type { TriggerSourceDTO, TriggerSourceCreateRequestDTO, PaginatedResponseDTO } from '@explorins/pers-shared';
+import type { TriggerSourceQueryOptions } from '@explorins/pers-sdk/trigger-source';
+export type { TriggerSourceQueryOptions } from '@explorins/pers-sdk/trigger-source';
+/**
+ * React hook for TriggerSource operations in the PERS SDK
+ *
+ * Manages trigger sources which are physical or digital activation points for campaigns:
+ * - **QR_CODE**: Scannable QR codes at physical locations
+ * - **NFC_TAG**: NFC tap points for contactless interactions
+ * - **GPS_GEOFENCE**: Location-based triggers with radius detection
+ * - **API_WEBHOOK**: External system integration triggers
+ * - **TRANSACTION**: Purchase/payment based triggers
+ *
+ * TriggerSources are standalone entities that can be created, managed, and then
+ * assigned to campaigns. This separation allows reuse across multiple campaigns.
+ *
+ * **Admin Only**: All create, update, and delete operations require admin authentication.
+ *
+ * @returns TriggerSource hook with CRUD operations
+ *
+ * @example Basic TriggerSource Operations
+ * ```typescript
+ * function TriggerSourceManager() {
+ *   const {
+ *     getAll,
+ *     getById,
+ *     create,
+ *     update,
+ *     remove
+ *   } = useTriggerSources();
+ *
+ *   // List all QR code trigger sources
+ *   const loadQRSources = async () => {
+ *     const { data: sources } = await getAll({ type: 'QR_CODE' });
+ *     console.log('QR Sources:', sources);
+ *   };
+ *
+ *   // Create a new QR code for a store
+ *   const createStoreQR = async () => {
+ *     const source = await create({
+ *       type: 'QR_CODE',
+ *       name: 'Store Entrance QR',
+ *       description: 'Scan at the entrance',
+ *       businessId: 'business-123',
+ *       coordsLatitude: 47.6062,
+ *       coordsLongitude: -122.3321
+ *     });
+ *     console.log('Created:', source.id);
+ *   };
+ * }
+ * ```
+ *
+ * @example GPS Geofence Trigger
+ * ```typescript
+ * const { create } = useTriggerSources();
+ *
+ * // Create a GPS geofence around a location
+ * const geofence = await create({
+ *   type: 'GPS_GEOFENCE',
+ *   name: 'Downtown Area',
+ *   coordsLatitude: 47.6062,
+ *   coordsLongitude: -122.3321,
+ *   metadata: { radiusMeters: 100 }
+ * });
+ * ```
+ */
+export declare const useTriggerSources: () => {
+    getAll: (options?: TriggerSourceQueryOptions) => Promise<PaginatedResponseDTO<TriggerSourceDTO>>;
+    getById: (triggerSourceId: string) => Promise<TriggerSourceDTO>;
+    create: (triggerSource: TriggerSourceCreateRequestDTO) => Promise<TriggerSourceDTO>;
+    update: (triggerSourceId: string, triggerSource: Partial<TriggerSourceCreateRequestDTO>) => Promise<TriggerSourceDTO>;
+    remove: (triggerSourceId: string) => Promise<boolean>;
+    isAvailable: boolean;
+};
+export type TriggerSourceHook = ReturnType<typeof useTriggerSources>;
+//# sourceMappingURL=useTriggerSources.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useTriggerSources.d.ts","sourceRoot":"","sources":["../../src/hooks/useTriggerSources.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,6BAA6B,EAC7B,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAGpF,YAAY,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH,eAAO,MAAM,iBAAiB;uBAiChB,yBAAyB,KAClC,QAAQ,qBAAqB,gBAAgB,CAAC,CAAC;+BAsC/B,MAAM,KACtB,QAAQ,gBAAgB,CAAC;4BA8CX,6BAA6B,KAC3C,QAAQ,gBAAgB,CAAC;8BAwCT,MAAM,iBACR,QAAQ,6BAA6B,CAAC,KACpD,QAAQ,gBAAgB,CAAC;8BAmCT,MAAM,KACtB,QAAQ,OAAO,CAAC;;CAyBpB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/hooks/useTriggerSources.js

@@ -0,0 +1,272 @@
+import { useCallback } from 'react';
+import { usePersSDK } from '../providers/PersSDKProvider';
+/**
+ * React hook for TriggerSource operations in the PERS SDK
+ *
+ * Manages trigger sources which are physical or digital activation points for campaigns:
+ * - **QR_CODE**: Scannable QR codes at physical locations
+ * - **NFC_TAG**: NFC tap points for contactless interactions
+ * - **GPS_GEOFENCE**: Location-based triggers with radius detection
+ * - **API_WEBHOOK**: External system integration triggers
+ * - **TRANSACTION**: Purchase/payment based triggers
+ *
+ * TriggerSources are standalone entities that can be created, managed, and then
+ * assigned to campaigns. This separation allows reuse across multiple campaigns.
+ *
+ * **Admin Only**: All create, update, and delete operations require admin authentication.
+ *
+ * @returns TriggerSource hook with CRUD operations
+ *
+ * @example Basic TriggerSource Operations
+ * ```typescript
+ * function TriggerSourceManager() {
+ *   const {
+ *     getAll,
+ *     getById,
+ *     create,
+ *     update,
+ *     remove
+ *   } = useTriggerSources();
+ *
+ *   // List all QR code trigger sources
+ *   const loadQRSources = async () => {
+ *     const { data: sources } = await getAll({ type: 'QR_CODE' });
+ *     console.log('QR Sources:', sources);
+ *   };
+ *
+ *   // Create a new QR code for a store
+ *   const createStoreQR = async () => {
+ *     const source = await create({
+ *       type: 'QR_CODE',
+ *       name: 'Store Entrance QR',
+ *       description: 'Scan at the entrance',
+ *       businessId: 'business-123',
+ *       coordsLatitude: 47.6062,
+ *       coordsLongitude: -122.3321
+ *     });
+ *     console.log('Created:', source.id);
+ *   };
+ * }
+ * ```
+ *
+ * @example GPS Geofence Trigger
+ * ```typescript
+ * const { create } = useTriggerSources();
+ *
+ * // Create a GPS geofence around a location
+ * const geofence = await create({
+ *   type: 'GPS_GEOFENCE',
+ *   name: 'Downtown Area',
+ *   coordsLatitude: 47.6062,
+ *   coordsLongitude: -122.3321,
+ *   metadata: { radiusMeters: 100 }
+ * });
+ * ```
+ */
+export const useTriggerSources = () => {
+    const { sdk, isInitialized, isAuthenticated } = usePersSDK();
+    /**
+     * Get trigger sources with optional filters and pagination
+     *
+     * Retrieves trigger sources (QR codes, NFC tags, GPS geofences, webhooks, etc.)
+     * that can be used to activate campaigns. Supports filtering by type, business,
+     * campaign association, and active status.
+     *
+     * @param options - Filter and pagination options
+     * @returns Promise resolving to paginated trigger sources
+     *
+     * @example
+     * ```typescript
+     * // Get all QR code trigger sources
+     * const { data: qrSources } = await getAll({ type: 'QR_CODE' });
+     *
+     * // Get trigger sources for a specific business
+     * const { data: businessSources, pagination } = await getAll({
+     *   businessId: 'business-123',
+     *   active: true,
+     *   page: 1,
+     *   limit: 20
+     * });
+     *
+     * // Get trigger sources assigned to a campaign
+     * const { data: campaignSources } = await getAll({
+     *   campaignId: 'campaign-456'
+     * });
+     * ```
+     */
+    const getAll = useCallback(async (options) => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        try {
+            const result = await sdk.triggerSources.getAll(options);
+            return result;
+        }
+        catch (error) {
+            console.error('Failed to fetch trigger sources:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized]);
+    /**
+     * Get trigger source by ID
+     *
+     * Retrieves detailed information for a specific trigger source including
+     * its type, location, metadata, and configuration.
+     *
+     * @param triggerSourceId - UUID of the trigger source
+     * @returns Promise resolving to trigger source details
+     * @throws {PersApiError} When trigger source with specified ID is not found
+     *
+     * @example
+     * ```typescript
+     * const source = await getById('source-123');
+     *
+     * console.log('Trigger Source:', source.name);
+     * console.log('Type:', source.type);
+     * console.log('Active:', source.isActive);
+     *
+     * if (source.coordsLatitude && source.coordsLongitude) {
+     *   console.log('Location:', source.coordsLatitude, source.coordsLongitude);
+     * }
+     * ```
+     */
+    const getById = useCallback(async (triggerSourceId) => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        try {
+            const result = await sdk.triggerSources.getById(triggerSourceId);
+            return result;
+        }
+        catch (error) {
+            console.error('Failed to fetch trigger source:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized]);
+    /**
+     * Admin: Create a new trigger source
+     *
+     * Creates a new trigger source (QR code, NFC tag, GPS geofence, webhook, or
+     * transaction-based trigger) that can be assigned to campaigns. Requires
+     * administrator privileges.
+     *
+     * @param triggerSource - Trigger source creation data
+     * @returns Promise resolving to created trigger source
+     * @throws {PersApiError} When not authenticated as admin or validation fails
+     *
+     * @example
+     * ```typescript
+     * // Create a QR code trigger source
+     * const qrSource = await create({
+     *   type: 'QR_CODE',
+     *   name: 'Store Entrance QR',
+     *   description: 'QR code at main entrance',
+     *   businessId: 'business-123',
+     *   coordsLatitude: 47.6062,
+     *   coordsLongitude: -122.3321
+     * });
+     *
+     * // Create an NFC tag trigger source
+     * const nfcSource = await create({
+     *   type: 'NFC_TAG',
+     *   name: 'Product Display NFC',
+     *   metadata: { productId: 'SKU-12345' }
+     * });
+     * ```
+     */
+    const create = useCallback(async (triggerSource) => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        if (!isAuthenticated) {
+            throw new Error('SDK not authenticated. create requires admin authentication.');
+        }
+        try {
+            const result = await sdk.triggerSources.create(triggerSource);
+            return result;
+        }
+        catch (error) {
+            console.error('Failed to create trigger source:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized, isAuthenticated]);
+    /**
+     * Admin: Update a trigger source
+     *
+     * Updates an existing trigger source's configuration. All fields are optional;
+     * only provided fields will be updated. Requires administrator privileges.
+     *
+     * @param triggerSourceId - UUID of the trigger source to update
+     * @param triggerSource - Updated trigger source data (partial)
+     * @returns Promise resolving to updated trigger source
+     * @throws {PersApiError} When not authenticated as admin or trigger source not found
+     *
+     * @example
+     * ```typescript
+     * // Update trigger source name and location
+     * const updated = await update('source-123', {
+     *   name: 'Updated Store Entrance QR',
+     *   description: 'New description',
+     *   coordsLatitude: 47.6063,
+     *   coordsLongitude: -122.3322
+     * });
+     * ```
+     */
+    const update = useCallback(async (triggerSourceId, triggerSource) => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        if (!isAuthenticated) {
+            throw new Error('SDK not authenticated. update requires admin authentication.');
+        }
+        try {
+            const result = await sdk.triggerSources.update(triggerSourceId, triggerSource);
+            return result;
+        }
+        catch (error) {
+            console.error('Failed to update trigger source:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized, isAuthenticated]);
+    /**
+     * Admin: Delete a trigger source
+     *
+     * Soft deletes a trigger source, making it inactive. The trigger source will
+     * be removed from any campaigns it was assigned to. Requires administrator
+     * privileges.
+     *
+     * @param triggerSourceId - UUID of the trigger source to delete
+     * @returns Promise resolving to success status
+     * @throws {PersApiError} When not authenticated as admin or trigger source not found
+     *
+     * @example
+     * ```typescript
+     * const success = await remove('source-123');
+     * console.log('Trigger source deleted:', success);
+     * ```
+     */
+    const remove = useCallback(async (triggerSourceId) => {
+        if (!isInitialized || !sdk) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        if (!isAuthenticated) {
+            throw new Error('SDK not authenticated. remove requires admin authentication.');
+        }
+        try {
+            const result = await sdk.triggerSources.delete(triggerSourceId);
+            return result;
+        }
+        catch (error) {
+            console.error('Failed to delete trigger source:', error);
+            throw error;
+        }
+    }, [sdk, isInitialized, isAuthenticated]);
+    return {
+        getAll,
+        getById,
+        create,
+        update,
+        remove,
+        isAvailable: isInitialized && !!sdk?.triggerSources,
+    };
+};

package/dist/hooks/useUsers.d.ts

@@ -1,16 +1,17 @@
 import type { UserDTO, UserCreateRequestDTO, PaginatedResponseDTO } from '@explorins/pers-shared';
-import type { UserPublicProfileDTO } from '@explorins/pers-sdk/user';
+import type { UserPublicProfileDTO, UserQueryOptions } from '@explorins/pers-sdk/user';
+export type { UserQueryOptions } from '@explorins/pers-sdk/user';
 export declare const useUsers: () => {
-    getCurrentUser: () => Promise<UserDTO>;
+    getCurrentUser: (options?: UserQueryOptions) => Promise<UserDTO>;
     updateCurrentUser: (userData: UserCreateRequestDTO) => Promise<UserDTO>;
-    getUserById: (userId: string) => Promise<UserDTO>;
+    getUserById: (userId: string, options?: UserQueryOptions) => Promise<UserDTO>;
     getAllUsersPublic: (filter?: {
         key: string;
         value: string;
     }) => Promise<PaginatedResponseDTO<UserPublicProfileDTO>>;
     getAllUsers: () => Promise<PaginatedResponseDTO<UserDTO>>;
     updateUser: (userId: string, userData: UserCreateRequestDTO) => Promise<UserDTO>;
-    toggleUserStatus: (user: UserDTO) => Promise<UserDTO>;
+    setUserActiveStatus: (userId: string, isActive?: boolean) => Promise<UserDTO>;
     isAvailable: boolean;
 };
 export type UserHook = ReturnType<typeof useUsers>;

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

@@ -1 +1 @@
-{"version":3,"file":"useUsers.d.ts","sourceRoot":"","sources":["../../src/hooks/useUsers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAClG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE,eAAO,MAAM,QAAQ;0BAG0B,QAAQ,OAAO,CAAC;kCAiBN,oBAAoB,KAAG,QAAQ,OAAO,CAAC;0BAiB/C,MAAM,KAAG,QAAQ,OAAO,CAAC;iCAclB;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAG,QAAQ,qBAAqB,oBAAoB,CAAC,CAAC;uBAehG,QAAQ,qBAAqB,OAAO,CAAC,CAAC;yBAclC,MAAM,YAAY,oBAAoB,KAAG,QAAQ,OAAO,CAAC;6BAcrD,OAAO,KAAG,QAAQ,OAAO,CAAC;;CAwB7E,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"useUsers.d.ts","sourceRoot":"","sources":["../../src/hooks/useUsers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAClG,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGvF,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,eAAO,MAAM,QAAQ;+BAmBiC,gBAAgB,KAAG,QAAQ,OAAO,CAAC;kCAiBhC,oBAAoB,KAAG,QAAQ,OAAO,CAAC;0BAiC/C,MAAM,YAAY,gBAAgB,KAAG,QAAQ,OAAO,CAAC;iCAc9C;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAG,QAAQ,qBAAqB,oBAAoB,CAAC,CAAC;uBAehG,QAAQ,qBAAqB,OAAO,CAAC,CAAC;yBAclC,MAAM,YAAY,oBAAoB,KAAG,QAAQ,OAAO,CAAC;kCAqBhD,MAAM,aAAa,OAAO,KAAG,QAAQ,OAAO,CAAC;;CAwBrG,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC"}

package/dist/hooks/useUsers.js

@@ -2,7 +2,23 @@ import { useCallback } from 'react';
 import { usePersSDK } from '../providers/PersSDKProvider';
 export const useUsers = () => {
     const { sdk, isInitialized, isAuthenticated } = usePersSDK();
-    const getCurrentUser = useCallback(async () => {
+    /**
+     * Get the current authenticated user with optional include relations
+     *
+     * @param options - Query options including include relations
+     * @returns Current user data
+     *
+     * @example
+     * ```typescript
+     * // Basic
+     * const user = await getCurrentUser();
+     *
+     * // With wallets included
+     * const userWithWallets = await getCurrentUser({ include: ['wallets'] });
+     * console.log('Wallets:', userWithWallets.included?.wallets);
+     * ```
+     */
+    const getCurrentUser = useCallback(async (options) => {
         if (!isInitialized || !sdk) {
             throw new Error('SDK not initialized. Call initialize() first.');
         }
@@ -10,7 +26,7 @@ export const useUsers = () => {
             throw new Error('SDK not authenticated. getCurrentUser requires authentication.');
         }
         try {
-            const result = await sdk.users.getCurrentUser();
+            const result = await sdk.users.getCurrentUser(options);
             return result;
         }
         catch (error) {
@@ -34,12 +50,28 @@ export const useUsers = () => {
             throw error;
         }
     }, [sdk, isInitialized, isAuthenticated]);
-    const getUserById = useCallback(async (userId) => {
+    /**
+     * Get user by ID with optional include relations
+     *
+     * @param userId - User identifier (id, email, externalId, etc.)
+     * @param options - Query options including include relations
+     * @returns User data
+     *
+     * @example
+     * ```typescript
+     * // Basic
+     * const user = await getUserById('user-123');
+     *
+     * // With wallets included
+     * const userWithWallets = await getUserById('user-123', { include: ['wallets'] });
+     * ```
+     */
+    const getUserById = useCallback(async (userId, options) => {
         if (!isInitialized || !sdk) {
             throw new Error('SDK not initialized. Call initialize() first.');
         }
         try {
-            const result = await sdk.users.getUserById(userId);
+            const result = await sdk.users.getUserById(userId, options);
             return result;
         }
         catch (error) {
@@ -87,16 +119,23 @@ export const useUsers = () => {
             throw error;
         }
     }, [sdk, isInitialized]);
-    const toggleUserStatus = useCallback(async (user) => {
+    /**
+     * Toggle or set a user's active status (admin only)
+     *
+     * @param userId - User ID to update
+     * @param isActive - Optional explicit status. If omitted, toggles current status.
+     * @returns Updated user
+     */
+    const setUserActiveStatus = useCallback(async (userId, isActive) => {
         if (!isInitialized || !sdk) {
             throw new Error('SDK not initialized. Call initialize() first.');
         }
         try {
-            const result = await sdk.users.toggleUserStatus(user);
+            const result = await sdk.users.setUserActiveStatus(userId, isActive);
             return result;
         }
         catch (error) {
-            console.error('Failed to toggle user status:', error);
+            console.error('Failed to set user active status:', error);
             throw error;
         }
     }, [sdk, isInitialized]);
@@ -107,7 +146,7 @@ export const useUsers = () => {
         getAllUsersPublic,
         getAllUsers,
         updateUser,
-        toggleUserStatus,
+        setUserActiveStatus,
         isAvailable: isInitialized && !!sdk?.users,
     };
 };

package/dist/hooks/useWeb3.d.ts

@@ -1,6 +1,7 @@
+import { Web3Manager } from '@explorins/pers-sdk/web3';
 import type { TokenBalance, TokenBalanceRequest, TokenCollectionRequest, TokenCollection, TokenMetadata, AccountOwnedTokensResult } from '@explorins/pers-sdk/web3';
-import type { ChainData } from '@explorins/pers-sdk/web3-chain';
-import type { TokenDTO } from '@explorins/pers-shared';
+import type { TokenDTO } from '@explorins/pers-sdk/token';
+type ChainData = Awaited<ReturnType<Web3Manager['getChainDataById']>>;
 export type { AccountOwnedTokensResult } from '@explorins/pers-sdk/web3';
 /**
  * React hook for Web3 operations in the PERS SDK
@@ -56,9 +57,9 @@ export declare const useWeb3: () => {
     getTokenBalance: (request: TokenBalanceRequest) => Promise<TokenBalance>;
     getTokenMetadata: (request: TokenBalanceRequest) => Promise<TokenMetadata | null>;
     getTokenCollection: (request: TokenCollectionRequest) => Promise<TokenCollection>;
-    resolveIPFSUrl: (url: string, chainId: number) => Promise<string>;
-    fetchAndProcessMetadata: (tokenUri: string, chainId: number) => Promise<TokenMetadata | null>;
-    getChainDataById: (chainId: number) => Promise<ChainData | null>;
+    resolveIPFSUrl: (url: string) => Promise<string>;
+    fetchAndProcessMetadata: (tokenUri: string) => Promise<TokenMetadata | null>;
+    getChainDataById: (chainId: number) => Promise<ChainData>;
     getExplorerUrl: (chainId: number, address: string, type: 'address' | 'tx') => Promise<string>;
     extractTokenIds: (token: TokenDTO) => string[] | undefined;
     getAccountOwnedTokensFromContract: (accountAddress: string, token: TokenDTO, maxTokens?: number) => Promise<AccountOwnedTokensResult>;

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

@@ -1 +1 @@
-{"version":3,"file":"useWeb3.d.ts","sourceRoot":"","sources":["../../src/hooks/useWeb3.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,aAAa,EACb,wBAAwB,EACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGvD,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,eAAO,MAAM,OAAO;+BAmCkC,mBAAmB,KAAG,QAAQ,YAAY,CAAC;gCAiC1C,mBAAmB,KAAG,QAAQ,aAAa,GAAG,IAAI,CAAC;kCAcjD,sBAAsB,KAAG,QAAQ,eAAe,CAAC;0BAczD,MAAM,WAAW,MAAM,KAAG,QAAQ,MAAM,CAAC;wCAc3B,MAAM,WAAW,MAAM,KAAG,QAAQ,aAAa,GAAG,IAAI,CAAC;gCAc/D,MAAM,KAAG,QAAQ,SAAS,GAAG,IAAI,CAAC;8BAcpC,MAAM,WAAW,MAAM,QAAQ,SAAS,GAAG,IAAI,KAAG,QAAQ,MAAM,CAAC;6BAiCxE,QAAQ,KAAG,MAAM,EAAE,GAAG,SAAS;wDAuCzD,MAAM,SACf,QAAQ,cACJ,MAAM,KAChB,QAAQ,wBAAwB,CAAC;6CAqBlB,MAAM,SACf,QAAQ,cACJ,MAAM,KAChB,sBAAsB;;CAqB1B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC"}
+{"version":3,"file":"useWeb3.d.ts","sourceRoot":"","sources":["../../src/hooks/useWeb3.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,aAAa,EACb,wBAAwB,EACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAG1D,KAAK,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;AAGtE,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,eAAO,MAAM,OAAO;+BAmCkC,mBAAmB,KAAG,QAAQ,YAAY,CAAC;gCAiC1C,mBAAmB,KAAG,QAAQ,aAAa,GAAG,IAAI,CAAC;kCAcjD,sBAAsB,KAAG,QAAQ,eAAe,CAAC;0BAqBzD,MAAM,KAAG,QAAQ,MAAM,CAAC;wCAoBV,MAAM,KAAG,QAAQ,aAAa,GAAG,IAAI,CAAC;gCAc9C,MAAM,KAAG,QAAQ,SAAS,CAAC;8BAc7B,MAAM,WAAW,MAAM,QAAQ,SAAS,GAAG,IAAI,KAAG,QAAQ,MAAM,CAAC;6BAiCxE,QAAQ,KAAG,MAAM,EAAE,GAAG,SAAS;wDAuCzD,MAAM,SACf,QAAQ,cACJ,MAAM,KAChB,QAAQ,wBAAwB,CAAC;6CAqBlB,MAAM,SACf,QAAQ,cACJ,MAAM,KAChB,sBAAsB;;CAqB1B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC"}