@explorins/pers-sdk-react-native 2.3.7 → 2.3.8

package/dist/__tests__/PersSDKProvider.test.js

@@ -30,8 +30,11 @@ jest.mock('@explorins/pers-sdk/core', () => {
     };
     const MockPersSDK = jest.fn().mockImplementation(() => {
         const events = createMockEventEmitter();
+        let currentLocale = null;
         mockSdkInstance = {
             events,
+            getLocale: jest.fn(() => currentLocale),
+            setLocale: jest.fn((next) => { currentLocale = next ? next.toLowerCase() : null; }),
             auth: {
                 ensureValidToken: jest.fn().mockResolvedValue(true)
             },
@@ -119,6 +122,36 @@ describe('PersSDKProvider', () => {
             expect(PersSDK).toHaveBeenCalledTimes(1);
         });
     });
+    describe('locale', () => {
+        it('exposes a null locale until one is set', async () => {
+            let capturedContext = null;
+            render(_jsx(PersSDKProvider, { config: { apiProjectKey: 'test-project' }, children: _jsx(TestConsumer, { onContext: (ctx) => { capturedContext = ctx; } }) }));
+            await waitFor(() => expect(capturedContext?.isInitialized).toBe(true));
+            expect(capturedContext.locale).toBeNull();
+        });
+        it('passes the configured locale through to the SDK config', async () => {
+            const { PersSDK } = require('@explorins/pers-sdk/core');
+            render(_jsx(PersSDKProvider, { config: { apiProjectKey: 'test-project', locale: 'auto' }, children: _jsx("div", {}) }));
+            await waitFor(() => expect(PersSDK).toHaveBeenCalledTimes(1));
+            expect(PersSDK.mock.calls[0][1]).toMatchObject({ locale: 'auto' });
+        });
+        it('setLocale updates the SDK and the context so consumers re-render', async () => {
+            let capturedContext = null;
+            render(_jsx(PersSDKProvider, { config: { apiProjectKey: 'test-project' }, children: _jsx(TestConsumer, { onContext: (ctx) => { capturedContext = ctx; } }) }));
+            await waitFor(() => expect(capturedContext?.isInitialized).toBe(true));
+            act(() => { capturedContext.setLocale('ar-SA'); });
+            await waitFor(() => expect(capturedContext?.locale).toBe('ar-sa'));
+            expect(mockSdkInstance.setLocale).toHaveBeenCalledWith('ar-SA');
+            act(() => { capturedContext.setLocale(null); });
+            await waitFor(() => expect(capturedContext?.locale).toBeNull());
+        });
+        it('setLocale throws before the SDK is initialized', async () => {
+            let capturedContext = null;
+            render(_jsx(PersSDKProvider, { children: _jsx(TestConsumer, { onContext: (ctx) => { capturedContext = ctx; } }) }));
+            await waitFor(() => expect(capturedContext).not.toBeNull());
+            expect(() => capturedContext.setLocale('de')).toThrow('SDK not initialized');
+        });
+    });
     describe('event handling', () => {
         it('should set user on session_restored event', async () => {
             let capturedContext = null;

package/dist/hooks/useBusiness.d.ts

@@ -1,4 +1,4 @@
-import type { BusinessDTO, BusinessTypeDTO, BusinessUpdateRequestDTO, BusinessToggleActiveRequestDTO, PaginatedResponseDTO, BusinessFilterOptions } from '@explorins/pers-sdk';
+import type { BusinessDTO, BusinessCreateRequestDTO, BusinessTypeDTO, BusinessUpdateRequestDTO, BusinessToggleActiveRequestDTO, PaginatedResponseDTO, BusinessFilterOptions } from '@explorins/pers-sdk';
 export type { BusinessFilterOptions } from '@explorins/pers-sdk';
 /**
  * React hook for business operations in the PERS SDK
@@ -41,7 +41,7 @@ export declare const useBusiness: () => {
     getBusinessById: (businessId: string) => Promise<BusinessDTO | null>;
     getBusinessByAccount: (accountAddress: string) => Promise<BusinessDTO>;
     getBusinessesByType: (typeId: string) => Promise<PaginatedResponseDTO<BusinessDTO>>;
-    createBusiness: (displayName: string) => Promise<BusinessDTO>;
+    createBusiness: (dto: BusinessCreateRequestDTO) => Promise<BusinessDTO>;
     updateBusiness: (businessId: string, businessData: BusinessUpdateRequestDTO) => Promise<BusinessDTO>;
     toggleBusinessStatus: (businessId: string, toggleData: BusinessToggleActiveRequestDTO) => Promise<BusinessDTO>;
     isAvailable: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"useBusiness.d.ts","sourceRoot":"","sources":["../../src/hooks/useBusiness.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAG/K,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,WAAW;+BAgB4B,QAAQ,qBAAqB,WAAW,CAAC,CAAC;4BA2B7C,QAAQ,qBAAqB,eAAe,CAAC,CAAC;8BAsD1C,qBAAqB,KAAG,QAAQ,qBAAqB,WAAW,CAAC,CAAC;kCAxC9D,MAAM,KAAG,QAAQ,WAAW,GAAG,IAAI,CAAC;2CAsD3B,MAAM,KAAG,QAAQ,WAAW,CAAC;kCActC,MAAM,KAAG,QAAQ,qBAAqB,WAAW,CAAC,CAAC;kCA6BnD,MAAM,KAAG,QAAQ,WAAW,CAAC;iCAc9B,MAAM,gBAAgB,wBAAwB,KAAG,QAAQ,WAAW,CAAC;uCAc/D,MAAM,cAAc,8BAA8B,KAAG,QAAQ,WAAW,CAAC;;CA0BtI,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC"}
+{"version":3,"file":"useBusiness.d.ts","sourceRoot":"","sources":["../../src/hooks/useBusiness.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,wBAAwB,EAAE,eAAe,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAGzM,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,WAAW;+BAgB4B,QAAQ,qBAAqB,WAAW,CAAC,CAAC;4BA2B7C,QAAQ,qBAAqB,eAAe,CAAC,CAAC;8BAsD1C,qBAAqB,KAAG,QAAQ,qBAAqB,WAAW,CAAC,CAAC;kCAxC9D,MAAM,KAAG,QAAQ,WAAW,GAAG,IAAI,CAAC;2CAsD3B,MAAM,KAAG,QAAQ,WAAW,CAAC;kCActC,MAAM,KAAG,QAAQ,qBAAqB,WAAW,CAAC,CAAC;0BA6B3D,wBAAwB,KAAG,QAAQ,WAAW,CAAC;iCAcxC,MAAM,gBAAgB,wBAAwB,KAAG,QAAQ,WAAW,CAAC;uCAc/D,MAAM,cAAc,8BAA8B,KAAG,QAAQ,WAAW,CAAC;;CA0BtI,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/hooks/useBusiness.js

@@ -181,12 +181,12 @@ export const useBusiness = () => {
      * console.log('Business created:', business);
      * ```
      */
-    const createBusiness = useCallback(async (displayName) => {
+    const createBusiness = useCallback(async (dto) => {
         if (!isInitialized || !sdk) {
             throw new Error('SDK not initialized. Call initialize() first.');
         }
         try {
-            const result = await sdk.businesses.createBusiness(displayName);
+            const result = await sdk.businesses.createBusiness(dto);
             return result;
         }
         catch (error) {

package/dist/hooks/useIPFSUrl.d.ts

@@ -5,7 +5,7 @@ import type { TokenMetadata } from '@explorins/pers-sdk';
  * Automatically handles IPFS URLs by resolving them to HTTPS via tenant's gateway.
  * Non-IPFS URLs are returned as-is. Handles loading and error states.
  *
- * Uses sdk.tenants for IPFS resolution (lightweight, no Web3 deps).
+ * Uses sdk.ipfs for IPFS resolution (lightweight, no Web3 deps).
  *
  * @param url - The URL to resolve (can be ipfs://, https://, or undefined)
  * @returns Object with resolved URL, loading state, and error
@@ -34,7 +34,7 @@ export declare function useResolvedUrl(url: string | undefined | null): {
  * Handles IPFS resolution automatically and returns parsed metadata
  * with all nested IPFS URLs already resolved to HTTPS.
  *
- * Uses sdk.tenants for metadata fetching (lightweight, no Web3 deps).
+ * Uses sdk.ipfs for metadata fetching (lightweight, no Web3 deps).
  *
  * @param metadataUri - The metadata URI to fetch (can be ipfs:// or https://)
  * @returns Object with metadata, loading state, error, and refresh function
@@ -59,7 +59,7 @@ export declare function useResolvedUrl(url: string | undefined | null): {
  * ```
  */
 export declare function useMetadata(metadataUri: string | undefined | null): {
-    /** Parsed metadata with resolved IPFS URLs (imageUrl, animationUrl, etc.) */
+    /** Parsed metadata with resolved IPFS URLs (imageUrl, animationUrl, etc.), localized for the current locale */
     metadata: TokenMetadata | null;
     /** Whether fetch is in progress */
     isLoading: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"useIPFSUrl.d.ts","sourceRoot":"","sources":["../../src/hooks/useIPFSUrl.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAmCzD,mDAAmD;;IAEnD,wCAAwC;;IAExC,yCAAyC;;EAG5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IA+B9D,6EAA6E;;IAE7E,mCAAmC;;IAEnC,oCAAoC;;IAEpC,gCAAgC;;EAGnC;AAGD,OAAO,EAAE,cAAc,IAAI,UAAU,EAAE,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS;IAIlG,yCAAyC;;IAEzC,kCAAkC;;IAElC,oCAAoC;;IAEpC,qDAAqD;;IAErD,iDAAiD;;IAEjD,wDAAwD;;IAExD,gCAAgC;;EAGnC"}
+{"version":3,"file":"useIPFSUrl.d.ts","sourceRoot":"","sources":["../../src/hooks/useIPFSUrl.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAmCzD,mDAAmD;;IAEnD,wCAAwC;;IAExC,yCAAyC;;EAG5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IA+B9D,+GAA+G;;IAE/G,mCAAmC;;IAEnC,oCAAoC;;IAEpC,gCAAgC;;EAGnC;AAGD,OAAO,EAAE,cAAc,IAAI,UAAU,EAAE,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS;IAIlG,yCAAyC;;IAEzC,kCAAkC;;IAElC,oCAAoC;;IAEpC,qDAAqD;;IAErD,iDAAiD;;IAEjD,wDAAwD;;IAExD,gCAAgC;;EAGnC"}

package/dist/hooks/useIPFSUrl.js

@@ -6,7 +6,7 @@ import { usePersSDK } from '../providers/PersSDKProvider';
  * Automatically handles IPFS URLs by resolving them to HTTPS via tenant's gateway.
  * Non-IPFS URLs are returned as-is. Handles loading and error states.
  *
- * Uses sdk.tenants for IPFS resolution (lightweight, no Web3 deps).
+ * Uses sdk.ipfs for IPFS resolution (lightweight, no Web3 deps).
  *
  * @param url - The URL to resolve (can be ipfs://, https://, or undefined)
  * @returns Object with resolved URL, loading state, and error
@@ -38,7 +38,7 @@ export function useResolvedUrl(url) {
         }
         setIsLoading(true);
         setError(null);
-        sdk.tenants.resolveIpfsUrl(url)
+        sdk.ipfs.resolveUrl(url)
             .then((resolved) => {
             setResolvedUrl(resolved);
         })
@@ -65,7 +65,7 @@ export function useResolvedUrl(url) {
  * Handles IPFS resolution automatically and returns parsed metadata
  * with all nested IPFS URLs already resolved to HTTPS.
  *
- * Uses sdk.tenants for metadata fetching (lightweight, no Web3 deps).
+ * Uses sdk.ipfs for metadata fetching (lightweight, no Web3 deps).
  *
  * @param metadataUri - The metadata URI to fetch (can be ipfs:// or https://)
  * @returns Object with metadata, loading state, error, and refresh function
@@ -90,7 +90,7 @@ export function useResolvedUrl(url) {
  * ```
  */
 export function useMetadata(metadataUri) {
-    const { sdk, isInitialized } = usePersSDK();
+    const { sdk, isInitialized, locale } = usePersSDK();
     const [metadata, setMetadata] = useState(null);
     const [isLoading, setIsLoading] = useState(false);
     const [error, setError] = useState(null);
@@ -102,7 +102,7 @@ export function useMetadata(metadataUri) {
         setIsLoading(true);
         setError(null);
         try {
-            const result = await sdk.tenants.fetchAndProcessMetadata(metadataUri);
+            const result = await sdk.ipfs.fetchMetadata(metadataUri);
             setMetadata(result);
         }
         catch (err) {
@@ -112,12 +112,12 @@ export function useMetadata(metadataUri) {
         finally {
             setIsLoading(false);
         }
-    }, [metadataUri, isInitialized, sdk]);
+    }, [metadataUri, isInitialized, sdk, locale]);
     useEffect(() => {
         fetchMetadata();
     }, [fetchMetadata]);
     return {
-        /** Parsed metadata with resolved IPFS URLs (imageUrl, animationUrl, etc.) */
+        /** Parsed metadata with resolved IPFS URLs (imageUrl, animationUrl, etc.), localized for the current locale */
         metadata,
         /** Whether fetch is in progress */
         isLoading,

package/dist/hooks/useWeb3.js

@@ -148,7 +148,7 @@ export const useWeb3 = () => {
      * Converts an ipfs:// URL to an HTTPS URL using the tenant's configured IPFS gateway.
      * Non-IPFS URLs are returned unchanged.
      *
-     * Note: Uses sdk.tenants for IPFS resolution (chain-agnostic).
+     * Note: Uses sdk.ipfs for IPFS resolution (chain-agnostic).
      *
      * @param url - IPFS URL to resolve (ipfs://...)
      * @returns Promise resolving to HTTP gateway URL
@@ -165,7 +165,7 @@ export const useWeb3 = () => {
             throw new Error('SDK not initialized. Call initialize() first.');
         }
         try {
-            const result = await sdk.tenants.resolveIpfsUrl(url);
+            const result = await sdk.ipfs.resolveUrl(url);
             return result;
         }
         catch (error) {
@@ -176,7 +176,7 @@ export const useWeb3 = () => {
     /**
      * Fetch and process token metadata from a URI
      *
-     * Note: Uses sdk.tenants for metadata fetching (chain-agnostic IPFS).
+     * Note: Uses sdk.ipfs for metadata fetching (chain-agnostic IPFS).
      *
      * @param tokenUri - Token URI to fetch metadata from
      * @returns Promise resolving to processed metadata or null
@@ -186,7 +186,7 @@ export const useWeb3 = () => {
             throw new Error('SDK not initialized. Call initialize() first.');
         }
         try {
-            const result = await sdk.tenants.fetchAndProcessMetadata(tokenUri);
+            const result = await sdk.ipfs.fetchMetadata(tokenUri);
             return result;
         }
         catch (error) {