@dcl/hooks 1.1.0 → 1.1.1-20260130165526.commit-e8ee72c

package/README.md

@@ -21,6 +21,7 @@ npm install @dcl/hooks
 - `useAsyncMemo`: Async version of useMemo
 - `useInfiniteScroll`: Infinite scroll functionality for loading more content
 - `useTranslation`: Simple and lightweight translation management
+- `useNotifications`: Notification polling and modal state management
 
 ## Examples
 
@@ -505,6 +506,31 @@ function MyComponent() {
 }
 ```
 
+Nested translations (dot notation):
+
+```typescript
+const translations = {
+  en: {
+    components: {
+      blog: {
+        related_post: {
+          title: 'Related posts'
+        }
+      }
+    }
+  }
+}
+
+function MyComponent() {
+  const { t } = useTranslation({
+    locale: 'en',
+    translations
+  })
+
+  return <p>{t('components.blog.related_post.title')}</p>
+}
+```
+
 Using the `intl` object for advanced formatting:
 
 ```typescript
@@ -678,6 +704,100 @@ function MyComponent() {
 }
 ```
 
+### useNotifications
+
+The `useNotifications` hook manages notification polling, modal state, and onboarding flow. It uses Decentraland's notifications API by default.
+
+Basic usage:
+
+```typescript
+import { useNotifications } from '@dcl/hooks'
+import type { AuthIdentity } from 'decentraland-crypto-fetch'
+
+function NotificationsComponent() {
+  const identity: AuthIdentity = useAuthIdentity() // From your auth context
+
+  const {
+    notifications,
+    isLoading,
+    isModalOpen,
+    isNotificationsOnboarding,
+    handleNotificationsOpen,
+    handleOnBegin
+  } = useNotifications({
+    identity,
+    isNotificationsEnabled: !!identity,
+    notificationsUrl: 'https://notifications.decentraland.org' // or .zone for dev
+  })
+
+  if (isNotificationsOnboarding) {
+    return (
+      <div>
+        <h2>Welcome to Notifications!</h2>
+        <button onClick={handleOnBegin}>Get Started</button>
+      </div>
+    )
+  }
+
+  return (
+    <div>
+      <button onClick={handleNotificationsOpen}>
+        Notifications ({notifications.filter(n => !n.read).length})
+      </button>
+
+      {isModalOpen && (
+        <ul>
+          {notifications.map(notification => (
+            <li key={notification.id}>
+              {notification.type} - {notification.read ? 'Read' : 'Unread'}
+            </li>
+          ))}
+        </ul>
+      )}
+    </div>
+  )
+}
+```
+
+With custom polling interval:
+
+```typescript
+const { notifications } = useNotifications({
+  identity,
+  isNotificationsEnabled: !!identity,
+  notificationsUrl: 'https://notifications.decentraland.org',
+  queryIntervalMs: 30000 // Poll every 30 seconds (default: 60000)
+})
+```
+
+With notification type filtering:
+
+```typescript
+const { notifications } = useNotifications({
+  identity,
+  isNotificationsEnabled: !!identity,
+  notificationsUrl: 'https://notifications.decentraland.org',
+  availableNotificationTypes: ['bid', 'sale', 'royalties']
+})
+```
+
+With error handling:
+
+`onError` is called when fetching fails, marking as read fails, or when
+`notificationsUrl` is missing.
+
+```typescript
+const { notifications } = useNotifications({
+  identity,
+  isNotificationsEnabled: !!identity,
+  notificationsUrl: 'https://notifications.decentraland.org',
+  onError: (error) => {
+    console.error('Notification error:', error)
+    Sentry.captureException(error)
+  }
+})
+```
+
 ## License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

package/esm/clients/index.d.ts

@@ -0,0 +1,2 @@
+export { createNotificationsClient } from "./notifications";
+export type { NotificationsClientOptions } from "./notifications";

package/esm/clients/index.js

@@ -0,0 +1,2 @@
+export { createNotificationsClient } from "./notifications";
+//# sourceMappingURL=index.js.map

package/esm/clients/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/clients/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAA"}

package/esm/clients/notifications/createNotificationsClient.d.ts

@@ -0,0 +1,15 @@
+import type { NotificationsClient } from "../../hooks/useNotifications";
+type NotificationsClientOptions = {
+    url: string;
+    limit?: number;
+};
+/**
+ * Creates a Decentraland notifications client.
+ *
+ * @param identity - The AuthIdentity for signing requests
+ * @param options - Configuration with required url
+ * @returns A NotificationsClient instance
+ */
+declare const createNotificationsClient: (identity: unknown, options: NotificationsClientOptions) => NotificationsClient;
+export { createNotificationsClient };
+export type { NotificationsClientOptions };

package/esm/clients/notifications/createNotificationsClient.js

@@ -0,0 +1,55 @@
+import { signedFetchFactory, } from "decentraland-crypto-fetch";
+const DEFAULT_NOTIFICATIONS_LIMIT = 50;
+const parseNotification = (notification) => ({
+    ...notification,
+    timestamp: Number(notification.timestamp),
+});
+/**
+ * Creates a Decentraland notifications client.
+ *
+ * @param identity - The AuthIdentity for signing requests
+ * @param options - Configuration with required url
+ * @returns A NotificationsClient instance
+ */
+const createNotificationsClient = (identity, options) => {
+    const authIdentity = identity;
+    const { url: baseUrl, limit = DEFAULT_NOTIFICATIONS_LIMIT } = options;
+    const signedFetch = signedFetchFactory();
+    const getNotifications = async () => {
+        const params = new URLSearchParams();
+        params.append("limit", String(limit));
+        const url = `${baseUrl}/notifications?${params.toString()}`;
+        const response = await signedFetch(url, {
+            identity: authIdentity,
+            headers: {
+                "Content-Type": "application/json",
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to fetch notifications: ${response.status}`);
+        }
+        const data = await response.json();
+        const notifications = data.notifications ?? [];
+        return notifications.map(parseNotification);
+    };
+    const markNotificationsAsRead = async (ids) => {
+        const url = `${baseUrl}/notifications/read`;
+        const response = await signedFetch(url, {
+            method: "PUT",
+            identity: authIdentity,
+            body: JSON.stringify({ notificationIds: ids }),
+            headers: {
+                "Content-Type": "application/json",
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to mark notifications as read: ${response.status}`);
+        }
+    };
+    return {
+        getNotifications,
+        markNotificationsAsRead,
+    };
+};
+export { createNotificationsClient };
+//# sourceMappingURL=createNotificationsClient.js.map

package/esm/clients/notifications/createNotificationsClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createNotificationsClient.js","sourceRoot":"","sources":["../../../src/clients/notifications/createNotificationsClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,kBAAkB,GACnB,MAAM,2BAA2B,CAAA;AAMlC,MAAM,2BAA2B,GAAG,EAAE,CAAA;AAWtC,MAAM,iBAAiB,GAAG,CACxB,YAAkC,EAChB,EAAE,CAAC,CAAC;IACtB,GAAG,YAAY;IACf,SAAS,EAAE,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC;CAC1C,CAAC,CAAA;AAEF;;;;;;GAMG;AACH,MAAM,yBAAyB,GAAG,CAChC,QAAiB,EACjB,OAAmC,EACd,EAAE;IACvB,MAAM,YAAY,GAAG,QAAwB,CAAA;IAC7C,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,GAAG,2BAA2B,EAAE,GAAG,OAAO,CAAA;IACrE,MAAM,WAAW,GAAG,kBAAkB,EAAE,CAAA;IAExC,MAAM,gBAAgB,GAAG,KAAK,IAAiC,EAAE;QAC/D,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;QACpC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QAErC,MAAM,GAAG,GAAG,GAAG,OAAO,kBAAkB,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAA;QAC3D,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE;YACtC,QAAQ,EAAE,YAAY;YACtB,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;SACF,CAAC,CAAA;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,kCAAkC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;QACtE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAClC,MAAM,aAAa,GAA2B,IAAI,CAAC,aAAa,IAAI,EAAE,CAAA;QAEtE,OAAO,aAAa,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;IAC7C,CAAC,CAAA;IAED,MAAM,uBAAuB,GAAG,KAAK,EAAE,GAAa,EAAiB,EAAE;QACrE,MAAM,GAAG,GAAG,GAAG,OAAO,qBAAqB,CAAA;QAC3C,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE;YACtC,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,YAAY;YACtB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC;YAC9C,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;SACF,CAAC,CAAA;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,yCAAyC,QAAQ,CAAC,MAAM,EAAE,CAC3D,CAAA;QACH,CAAC;IACH,CAAC,CAAA;IAED,OAAO;QACL,gBAAgB;QAChB,uBAAuB;KACxB,CAAA;AACH,CAAC,CAAA;AAED,OAAO,EAAE,yBAAyB,EAAE,CAAA"}

package/esm/clients/notifications/index.d.ts

@@ -0,0 +1,2 @@
+export { createNotificationsClient } from "./createNotificationsClient";
+export type { NotificationsClientOptions } from "./createNotificationsClient";

package/esm/clients/notifications/index.js

@@ -0,0 +1,2 @@
+export { createNotificationsClient } from "./createNotificationsClient";
+//# sourceMappingURL=index.js.map

package/esm/clients/notifications/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/clients/notifications/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA"}

package/esm/hooks/index.d.ts

@@ -2,6 +2,7 @@ export type { AdvancedNavigatorUAData } from "./useAdvancedUserAgentData";
 export type { AsyncMemoResult, AsyncMemoResultState } from "./useAsyncMemo";
 export type { AsyncStateResult, AsyncStateResultState } from "./useAsyncState";
 export type { UseInfiniteScrollOptions } from "./useInfiniteScroll";
+export type { NotificationItem, NotificationsClient, NotificationsState, NotificationsUIState, UseNotificationsOptions, UseNotificationsResult, } from "./useNotifications";
 export type { Translations, LanguageTranslations, TranslationState, TranslationOptions, TranslationResult, } from "./useTranslation";
 export { useAdvancedUserAgentData } from "./useAdvancedUserAgentData";
 export { useAnalytics } from "./useAnalytics";
@@ -11,6 +12,7 @@ export { useAsyncState, createAsyncStateState } from "./useAsyncState";
 export { useAsyncTask } from "./useAsyncTask";
 export { useAsyncTasks } from "./useAsyncTasks";
 export { useInfiniteScroll } from "./useInfiniteScroll";
+export { checkIsOnboarding, setOnboardingDone, useNotifications, } from "./useNotifications";
 export { usePageTracking } from "./usePageTracking";
 export { usePatchState } from "./usePatchState";
 export { useTranslation } from "./useTranslation";

package/esm/hooks/index.js

@@ -7,6 +7,7 @@ export { useAsyncState, createAsyncStateState } from "./useAsyncState";
 export { useAsyncTask } from "./useAsyncTask";
 export { useAsyncTasks } from "./useAsyncTasks";
 export { useInfiniteScroll } from "./useInfiniteScroll";
+export { checkIsOnboarding, setOnboardingDone, useNotifications, } from "./useNotifications";
 export { usePageTracking } from "./usePageTracking";
 export { usePatchState } from "./usePatchState";
 export { useTranslation } from "./useTranslation";

package/esm/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAaA,QAAQ;AACR,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAA;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AACnE,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAqBA,QAAQ;AACR,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAA;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AACnE,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA"}

package/esm/hooks/useNotifications/index.d.ts

@@ -0,0 +1,3 @@
+export { checkIsOnboarding, setOnboardingDone, useNotifications, } from "./useNotifications";
+export { NotificationActiveTab } from "./useNotifications.type";
+export type { NotificationItem, NotificationsClient, NotificationsState, NotificationsUIState, UseNotificationsOptions, UseNotificationsResult, } from "./useNotifications.type";

package/esm/hooks/useNotifications/index.js

@@ -0,0 +1,3 @@
+export { checkIsOnboarding, setOnboardingDone, useNotifications, } from "./useNotifications";
+export { NotificationActiveTab } from "./useNotifications.type";
+//# sourceMappingURL=index.js.map

package/esm/hooks/useNotifications/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/useNotifications/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA"}

package/esm/hooks/useNotifications/useNotifications.d.ts

@@ -0,0 +1,12 @@
+import { UseNotificationsOptions, UseNotificationsResult } from "./useNotifications.type";
+declare const checkIsOnboarding: () => boolean;
+declare const setOnboardingDone: () => void;
+/**
+ * Hook to manage notification polling and modal state.
+ * Uses Decentraland's notifications API.
+ *
+ * @param options - Configuration options for notifications polling and UI state.
+ * @returns Notifications state, modal state, and handlers.
+ */
+declare const useNotifications: (options: UseNotificationsOptions) => UseNotificationsResult;
+export { checkIsOnboarding, setOnboardingDone, useNotifications };

package/esm/hooks/useNotifications/useNotifications.js

@@ -0,0 +1,214 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { NotificationActiveTab, } from "./useNotifications.type";
+import { createNotificationsClient } from "../../clients/notifications";
+import { getStorageItem, setStorageItem } from "../../utils/storage";
+const DEFAULT_QUERY_INTERVAL_MS = 60000;
+const ONBOARDING_KEY = "dcl_notifications_onboarding";
+const checkIsOnboarding = () => {
+    const value = getStorageItem(ONBOARDING_KEY, null);
+    if (value === null) {
+        setStorageItem(ONBOARDING_KEY, true);
+        return true;
+    }
+    return value;
+};
+const setOnboardingDone = () => {
+    setStorageItem(ONBOARDING_KEY, false);
+};
+/**
+ * Hook to manage notification polling and modal state.
+ * Uses Decentraland's notifications API.
+ *
+ * @param options - Configuration options for notifications polling and UI state.
+ * @returns Notifications state, modal state, and handlers.
+ */
+const useNotifications = (options) => {
+    const { identity, isNotificationsEnabled, notificationsUrl, availableNotificationTypes, queryIntervalMs = DEFAULT_QUERY_INTERVAL_MS, initialActiveTab = NotificationActiveTab.NEWEST, onError, renderProfile, } = options;
+    const [notificationsState, setNotificationsState] = useState({
+        isLoading: false,
+        notifications: [],
+    });
+    const [uiState, setUiState] = useState(() => ({
+        activeTab: initialActiveTab,
+        isOnboarding: checkIsOnboarding(),
+        isOpen: false,
+    }));
+    const [notificationsClient, setNotificationsClient] = useState(null);
+    const notificationsRef = useRef([]);
+    const notificationsClientRef = useRef(null);
+    useEffect(() => {
+        notificationsRef.current = notificationsState.notifications;
+    }, [notificationsState.notifications]);
+    useEffect(() => {
+        notificationsClientRef.current = notificationsClient;
+    }, [notificationsClient]);
+    const availableNotifications = useMemo(() => {
+        if (!availableNotificationTypes) {
+            return null;
+        }
+        return new Set(availableNotificationTypes);
+    }, [availableNotificationTypes]);
+    const fetchAndUpdateNotifications = useCallback((client) => {
+        return Promise.resolve()
+            .then(() => client.getNotifications())
+            .then((notificationsFetched) => {
+            const filteredNotifications = availableNotifications
+                ? notificationsFetched.filter((notification) => availableNotifications.has(notification.type))
+                : notificationsFetched;
+            const hasReadNotifications = filteredNotifications.some((notification) => notification.read);
+            setNotificationsState((prevState) => ({
+                ...prevState,
+                isLoading: false,
+                notifications: filteredNotifications,
+            }));
+            if (hasReadNotifications) {
+                setOnboardingDone();
+                setUiState((prevState) => prevState.isOnboarding
+                    ? { ...prevState, isOnboarding: false }
+                    : prevState);
+            }
+        })
+            .catch((error) => {
+            const normalizedError = error instanceof Error ? error : new Error("Unknown error");
+            console.error("Error fetching notifications:", normalizedError);
+            if (onError) {
+                onError(normalizedError);
+            }
+            setNotificationsState((prevState) => ({
+                ...prevState,
+                isLoading: false,
+            }));
+        });
+    }, [availableNotifications, onError]);
+    useEffect(() => {
+        if (!identity) {
+            setNotificationsClient(null);
+            return;
+        }
+        if (!notificationsUrl) {
+            const normalizedError = new Error("notificationsUrl is required");
+            console.error("Notifications URL missing:", normalizedError);
+            if (onError) {
+                onError(normalizedError);
+            }
+            setNotificationsClient(null);
+            return;
+        }
+        const client = createNotificationsClient(identity, {
+            url: notificationsUrl,
+        });
+        setNotificationsClient(client);
+        if (!isNotificationsEnabled) {
+            return;
+        }
+        let cancelled = false;
+        setNotificationsState((prevState) => ({
+            ...prevState,
+            isLoading: true,
+        }));
+        const pollNotifications = () => {
+            if (cancelled) {
+                return;
+            }
+            fetchAndUpdateNotifications(client);
+        };
+        pollNotifications();
+        const intervalId = setInterval(pollNotifications, queryIntervalMs);
+        return () => {
+            cancelled = true;
+            clearInterval(intervalId);
+        };
+    }, [
+        identity,
+        isNotificationsEnabled,
+        notificationsUrl,
+        onError,
+        fetchAndUpdateNotifications,
+        queryIntervalMs,
+    ]);
+    useEffect(() => {
+        const isClosing = !uiState.isOpen;
+        if (!isClosing) {
+            return;
+        }
+        const currentNotifications = notificationsRef.current;
+        const currentClient = notificationsClientRef.current;
+        if (!currentClient) {
+            return;
+        }
+        const unreadNotificationsIds = currentNotifications
+            .filter((notification) => !notification.read)
+            .map((notification) => notification.id);
+        if (unreadNotificationsIds.length === 0) {
+            return;
+        }
+        let cancelled = false;
+        Promise.resolve()
+            .then(() => currentClient.markNotificationsAsRead(unreadNotificationsIds))
+            .then(() => {
+            if (cancelled) {
+                return;
+            }
+            setNotificationsState((prevState) => ({
+                ...prevState,
+                notifications: prevState.notifications.map((notification) => ({
+                    ...notification,
+                    read: unreadNotificationsIds.includes(notification.id)
+                        ? true
+                        : notification.read,
+                })),
+            }));
+        })
+            .catch((error) => {
+            if (cancelled) {
+                return;
+            }
+            const normalizedError = error instanceof Error ? error : new Error("Unknown error");
+            console.error("Error marking notifications as read:", normalizedError);
+            if (onError) {
+                onError(normalizedError);
+            }
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [uiState.isOpen, onError]);
+    const handleOnBegin = useCallback(() => {
+        setOnboardingDone();
+        setUiState((prevState) => ({
+            ...prevState,
+            isOnboarding: false,
+        }));
+    }, []);
+    const handleNotificationsOpen = useCallback(() => {
+        setUiState((prevState) => ({
+            ...prevState,
+            isOpen: !prevState.isOpen,
+        }));
+    }, []);
+    const handleOnChangeModalTab = useCallback((tab) => {
+        setUiState((prevState) => ({
+            ...prevState,
+            activeTab: tab,
+        }));
+    }, []);
+    const handleRenderProfile = useCallback((address) => {
+        if (!renderProfile) {
+            return null;
+        }
+        return renderProfile(address);
+    }, [renderProfile]);
+    return {
+        notifications: notificationsState.notifications,
+        isLoading: notificationsState.isLoading,
+        isModalOpen: uiState.isOpen,
+        modalActiveTab: uiState.activeTab,
+        isNotificationsOnboarding: uiState.isOnboarding,
+        handleOnBegin,
+        handleNotificationsOpen,
+        handleOnChangeModalTab,
+        handleRenderProfile,
+    };
+};
+export { checkIsOnboarding, setOnboardingDone, useNotifications };
+//# sourceMappingURL=useNotifications.js.map

package/esm/hooks/useNotifications/useNotifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNotifications.js","sourceRoot":"","sources":["../../../src/hooks/useNotifications/useNotifications.ts"],"names":[],"mappings":"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"}

package/esm/hooks/useNotifications/useNotifications.type.d.ts

@@ -0,0 +1,47 @@
+import type { ReactNode } from "react";
+declare enum NotificationActiveTab {
+    NEWEST = "newest",
+    READ = "read"
+}
+type NotificationItem = {
+    id: string;
+    type: string;
+    read: boolean;
+    [key: string]: unknown;
+};
+type NotificationsClient = {
+    getNotifications: () => Promise<NotificationItem[]>;
+    markNotificationsAsRead: (ids: string[]) => Promise<void>;
+};
+type NotificationsState = {
+    isLoading: boolean;
+    notifications: NotificationItem[];
+};
+type NotificationsUIState = {
+    activeTab: string;
+    isOnboarding: boolean;
+    isOpen: boolean;
+};
+type UseNotificationsOptions = {
+    identity?: unknown;
+    isNotificationsEnabled: boolean;
+    notificationsUrl: string;
+    availableNotificationTypes?: string[];
+    queryIntervalMs?: number;
+    initialActiveTab?: string;
+    onError?: (error: Error) => void;
+    renderProfile?: (address: string) => ReactNode;
+};
+type UseNotificationsResult = {
+    notifications: NotificationItem[];
+    isLoading: boolean;
+    isModalOpen: boolean;
+    modalActiveTab: string;
+    isNotificationsOnboarding: boolean;
+    handleOnBegin: () => void;
+    handleNotificationsOpen: () => void;
+    handleOnChangeModalTab: (tab: string) => void;
+    handleRenderProfile: (address: string) => ReactNode;
+};
+export { NotificationActiveTab };
+export type { NotificationItem, NotificationsClient, NotificationsState, NotificationsUIState, UseNotificationsOptions, UseNotificationsResult, };

package/esm/hooks/useNotifications/useNotifications.type.js

@@ -0,0 +1,7 @@
+var NotificationActiveTab;
+(function (NotificationActiveTab) {
+    NotificationActiveTab["NEWEST"] = "newest";
+    NotificationActiveTab["READ"] = "read";
+})(NotificationActiveTab || (NotificationActiveTab = {}));
+export { NotificationActiveTab };
+//# sourceMappingURL=useNotifications.type.js.map

package/esm/hooks/useNotifications/useNotifications.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNotifications.type.js","sourceRoot":"","sources":["../../../src/hooks/useNotifications/useNotifications.type.ts"],"names":[],"mappings":"AAEA,IAAK,qBAGJ;AAHD,WAAK,qBAAqB;IACxB,0CAAiB,CAAA;IACjB,sCAAa,CAAA;AACf,CAAC,EAHI,qBAAqB,KAArB,qBAAqB,QAGzB;AAgDD,OAAO,EAAE,qBAAqB,EAAE,CAAA"}

package/esm/hooks/useTranslation/useTranslation.js

@@ -3,6 +3,21 @@ import { createIntl, createIntlCache } from "@formatjs/intl";
 import { TranslationContext } from "../../contexts/translation/TranslationContext";
 // Create a cache for @formatjs/intl to improve performance
 const cache = createIntlCache();
+const flattenTranslations = (translations, parentKey = "", result = {}) => {
+    Object.entries(translations).forEach(([key, value]) => {
+        const translationKey = parentKey ? `${parentKey}.${key}` : key;
+        if (typeof value === "string") {
+            result[translationKey] = value;
+            return;
+        }
+        if (value && typeof value === "object" && !Array.isArray(value)) {
+            flattenTranslations(value, translationKey, result);
+            return;
+        }
+        console.error(`Invalid translation value for key "${translationKey}". Expected string or nested object.`);
+    });
+    return result;
+};
 /**
  * Hook to manage translations in a React application using @formatjs/intl
  *
@@ -97,11 +112,18 @@ const useTranslation = (options) => {
         translations: validatedOptions.translations,
         error: null,
     });
+    const flattenedTranslations = useMemo(() => {
+        const locales = {};
+        Object.entries(state.translations).forEach(([locale, translations]) => {
+            locales[locale] = flattenTranslations(translations);
+        });
+        return locales;
+    }, [state.translations]);
     // Create intl instance with current locale and translations
     const intl = useMemo(() => {
-        const currentTranslations = state.translations[state.locale];
+        const currentTranslations = flattenedTranslations[state.locale];
         const fallbackTranslations = validatedOptions.fallbackLocale &&
-            state.translations[validatedOptions.fallbackLocale];
+            flattenedTranslations[validatedOptions.fallbackLocale];
         if (!currentTranslations && fallbackTranslations) {
             console.error(`No translations found for locale "${state.locale}". Using fallback locale "${validatedOptions.fallbackLocale}".`);
             return createIntl({
@@ -129,7 +151,7 @@ const useTranslation = (options) => {
             locale: state.locale,
             messages,
         }, cache);
-    }, [state.locale, state.translations, validatedOptions.fallbackLocale]);
+    }, [state.locale, flattenedTranslations, validatedOptions.fallbackLocale]);
     // Simplified t() function using intl.formatMessage
     const t = useCallback((key, values) => {
         return intl.formatMessage({ id: key }, values);

package/esm/hooks/useTranslation/useTranslation.js.map

@@ -1 +1 @@
-{"version":3,"file":"useTranslation.js","sourceRoot":"","sources":["../../../src/hooks/useTranslation/useTranslation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useTranslation.js","sourceRoot":"","sources":["../../../src/hooks/useTranslation/useTranslation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAClE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAO5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAA;AAElF,2DAA2D;AAC3D,MAAM,KAAK,GAAG,eAAe,EAAE,CAAA;AAI/B,MAAM,mBAAmB,GAAG,CAC1B,YAA0B,EAC1B,SAAS,GAAG,EAAE,EACd,SAA2B,EAAE,EACX,EAAE;IACpB,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACpD,MAAM,cAAc,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;QAE9D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,cAAc,CAAC,GAAG,KAAK,CAAA;YAC9B,OAAM;QACR,CAAC;QAED,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,mBAAmB,CAAC,KAAqB,EAAE,cAAc,EAAE,MAAM,CAAC,CAAA;YAClE,OAAM;QACR,CAAC;QAED,OAAO,CAAC,KAAK,CACX,sCAAsC,cAAc,sCAAsC,CAC3F,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AACH,MAAM,cAAc,GAAG,CACrB,OAAwC,EACrB,EAAE;IACrB,MAAM,OAAO,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAA;IAE9C,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAA;IACH,CAAC;IAED,IAAI,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC;QACxB,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAA;IAC9E,CAAC;IAED,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CACb,iEAAiE,CAClE,CAAA;IACH,CAAC;IAED,MAAM,gBAAgB,GAAG,OAAgC,CAAA;IACzD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAsB;QACtD,MAAM,EAAE,gBAAgB,CAAC,MAAM;QAC/B,YAAY,EAAE,gBAAgB,CAAC,YAAY;QAC3C,KAAK,EAAE,IAAI;KACZ,CAAC,CAAA;IAEF,MAAM,qBAAqB,GAAG,OAAO,CAAC,GAAG,EAAE;QACzC,MAAM,OAAO,GAAqC,EAAE,CAAA;QAEpD,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,EAAE;YACpE,OAAO,CAAC,MAAM,CAAC,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAA;QACrD,CAAC,CAAC,CAAA;QAEF,OAAO,OAAO,CAAA;IAChB,CAAC,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAA;IAExB,4DAA4D;IAC5D,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE;QACxB,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QAC/D,MAAM,oBAAoB,GACxB,gBAAgB,CAAC,cAAc;YAC/B,qBAAqB,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAA;QAExD,IAAI,CAAC,mBAAmB,IAAI,oBAAoB,EAAE,CAAC;YACjD,OAAO,CAAC,KAAK,CACX,qCAAqC,KAAK,CAAC,MAAM,6BAA6B,gBAAgB,CAAC,cAAc,IAAI,CAClH,CAAA;YACD,OAAO,UAAU,CACf;gBACE,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,QAAQ,EAAE,oBAAoB;aAC/B,EACD,KAAK,CACN,CAAA;QACH,CAAC;QAED,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACzB,OAAO,CAAC,KAAK,CACX,qCAAqC,KAAK,CAAC,MAAM,8BAA8B,CAChF,CAAA;YACD,OAAO,UAAU,CACf;gBACE,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,QAAQ,EAAE,EAAE;aACb,EACD,KAAK,CACN,CAAA;QACH,CAAC;QAED,MAAM,mBAAmB,GACvB,gBAAgB,CAAC,cAAc;YAC/B,KAAK,CAAC,MAAM,KAAK,gBAAgB,CAAC,cAAc;YAChD,oBAAoB,CAAA;QAEtB,MAAM,QAAQ,GAAG,mBAAmB;YAClC,CAAC,CAAC;gBACE,GAAG,oBAAoB;gBACvB,GAAG,mBAAmB;aACvB;YACH,CAAC,CAAC,mBAAmB,CAAA;QAEvB,OAAO,UAAU,CACf;YACE,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,QAAQ;SACT,EACD,KAAK,CACN,CAAA;IACH,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,qBAAqB,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC,CAAA;IAE1E,mDAAmD;IACnD,MAAM,CAAC,GAAG,WAAW,CACnB,CAAC,GAAW,EAAE,MAAwC,EAAU,EAAE;QAChE,OAAO,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,MAAM,CAAC,CAAA;IAChD,CAAC,EACD,CAAC,IAAI,CAAC,CACP,CAAA;IAED,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,SAAiB,EAAE,EAAE;QACpB,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,KAAK,CACX,WAAW,SAAS,mDAAmD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACpH,CAAA;YACD,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBACrB,GAAG,OAAO;gBACV,KAAK,EAAE,WAAW,SAAS,aAAa;aACzC,CAAC,CAAC,CAAA;YACH,OAAM;QACR,CAAC;QAED,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACrB,GAAG,OAAO;YACV,MAAM,EAAE,SAAc;YACtB,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC,CAAA;IACL,CAAC,EACD,CAAC,KAAK,CAAC,YAAY,CAAC,CACrB,CAAA;IAED,OAAO;QACL,CAAC;QACD,IAAI;QACJ,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS;QACT,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAA;AACH,CAAC,CAAA;AAED,OAAO,EAAE,cAAc,EAAE,CAAA"}

package/esm/hooks/useTranslation/useTranslation.type.d.ts

@@ -1,5 +1,7 @@
 import type { IntlShape } from "@formatjs/intl";
-type Translations = Record<string, string>;
+interface Translations {
+    [key: string]: string | Translations;
+}
 type LanguageTranslations = Record<string, Translations>;
 type TranslationState<L extends string = string> = {
     locale: L;

package/esm/index.d.ts

@@ -1,2 +1,4 @@
+export * from "./clients";
 export * from "./contexts";
 export * from "./hooks";
+export * from "./utils";

package/esm/index.js

@@ -1,3 +1,5 @@
+export * from "./clients";
 export * from "./contexts";
 export * from "./hooks";
+export * from "./utils";
 //# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA"}

package/esm/utils/index.d.ts

@@ -0,0 +1 @@
+export { getStorageItem, removeStorageItem, setStorageItem } from "./storage";

package/esm/utils/index.js

@@ -0,0 +1,2 @@
+export { getStorageItem, removeStorageItem, setStorageItem } from "./storage";
+//# sourceMappingURL=index.js.map

package/esm/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA"}

package/esm/utils/storage.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Retrieves and parses a JSON value from localStorage.
+ * Returns the fallback value if the key doesn't exist, parsing fails,
+ * or localStorage throws an error.
+ *
+ * @template T - The expected type of the stored value
+ * @param key - The localStorage key to retrieve
+ * @param fallback - The value to return if retrieval fails
+ * @returns The parsed value or the fallback
+ *
+ * @example
+ * const isEnabled = getStorageItem<boolean>('feature_enabled', false)
+ * const user = getStorageItem<User | null>('current_user', null)
+ */
+declare const getStorageItem: <T>(key: string, fallback: T) => T;
+/**
+ * Stores a value in localStorage as JSON.
+ * Silently fails if localStorage throws an error.
+ *
+ * @template T - The type of the value to store
+ * @param key - The localStorage key
+ * @param value - The value to store (will be JSON stringified)
+ *
+ * @example
+ * setStorageItem('feature_enabled', true)
+ * setStorageItem('current_user', { id: 1, name: 'John' })
+ */
+declare const setStorageItem: <T>(key: string, value: T) => void;
+/**
+ * Removes a key from localStorage.
+ * Silently fails if localStorage throws an error.
+ *
+ * @param key - The localStorage key to remove
+ *
+ * @example
+ * removeStorageItem('current_user')
+ */
+declare const removeStorageItem: (key: string) => void;
+export { getStorageItem, removeStorageItem, setStorageItem };

package/esm/utils/storage.js

@@ -0,0 +1,65 @@
+/**
+ * Retrieves and parses a JSON value from localStorage.
+ * Returns the fallback value if the key doesn't exist, parsing fails,
+ * or localStorage throws an error.
+ *
+ * @template T - The expected type of the stored value
+ * @param key - The localStorage key to retrieve
+ * @param fallback - The value to return if retrieval fails
+ * @returns The parsed value or the fallback
+ *
+ * @example
+ * const isEnabled = getStorageItem<boolean>('feature_enabled', false)
+ * const user = getStorageItem<User | null>('current_user', null)
+ */
+const getStorageItem = (key, fallback) => {
+    try {
+        const value = localStorage.getItem(key);
+        if (value === null) {
+            return fallback;
+        }
+        return JSON.parse(value);
+    }
+    catch {
+        return fallback;
+    }
+};
+/**
+ * Stores a value in localStorage as JSON.
+ * Silently fails if localStorage throws an error.
+ *
+ * @template T - The type of the value to store
+ * @param key - The localStorage key
+ * @param value - The value to store (will be JSON stringified)
+ *
+ * @example
+ * setStorageItem('feature_enabled', true)
+ * setStorageItem('current_user', { id: 1, name: 'John' })
+ */
+const setStorageItem = (key, value) => {
+    try {
+        localStorage.setItem(key, JSON.stringify(value));
+    }
+    catch {
+        // Ignore storage errors
+    }
+};
+/**
+ * Removes a key from localStorage.
+ * Silently fails if localStorage throws an error.
+ *
+ * @param key - The localStorage key to remove
+ *
+ * @example
+ * removeStorageItem('current_user')
+ */
+const removeStorageItem = (key) => {
+    try {
+        localStorage.removeItem(key);
+    }
+    catch {
+        // Ignore storage errors
+    }
+};
+export { getStorageItem, removeStorageItem, setStorageItem };
+//# sourceMappingURL=storage.js.map

package/esm/utils/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/utils/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,cAAc,GAAG,CAAI,GAAW,EAAE,QAAW,EAAK,EAAE;IACxD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QACvC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,OAAO,QAAQ,CAAA;QACjB,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAM,CAAA;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAA;IACjB,CAAC;AACH,CAAC,CAAA;AAED;;;;;;;;;;;GAWG;AACH,MAAM,cAAc,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAQ,EAAE;IACxD,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,wBAAwB;IAC1B,CAAC;AACH,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,iBAAiB,GAAG,CAAC,GAAW,EAAQ,EAAE;IAC9C,IAAI,CAAC;QACH,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,wBAAwB;IAC1B,CAAC;AACH,CAAC,CAAA;AAED,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dcl/hooks",
-  "version": "1.1.0",
+  "version": "1.1.1-20260130165526.commit-e8ee72c",
   "type": "module",
   "main": "esm/index.js",
   "module": "esm/index.js",
@@ -19,6 +19,7 @@
     "test:coverage": "npm run test -- --coverage"
   },
   "peerDependencies": {
+    "decentraland-crypto-fetch": "^2.0.1",
     "react": "^18.0.0"
   },
   "devDependencies": {
@@ -30,6 +31,7 @@
     "@types/ua-parser-js": "^0.7.39",
     "@typescript-eslint/eslint-plugin": "^7.15.0",
     "@typescript-eslint/parser": "^7.15.0",
+    "decentraland-crypto-fetch": "^2.0.1",
     "eslint": "^8.57.0",
     "eslint-config-prettier": "^9.1.0",
     "eslint-import-resolver-jest": "^3.0.2",
@@ -78,5 +80,5 @@
       "<rootDir>/test/setup.ts"
     ]
   },
-  "commit": "7c01c67ea4f59e6cd131b191224dc86e24b568c5"
+  "commit": "e8ee72cf8c4f5342c8da501151fad8310c495ad5"
 }