@adatechnology/notification-ui 0.1.0-rc.1

package/README.md

@@ -0,0 +1,54 @@
+# @adatechnology/notification-ui
+
+UI de notificação em React: sino com contador, inbox paginado e painel de preferências. Em duas
+camadas — **headless** (hooks, sem markup) e **componentes** (o visual pronto).
+
+## Instalação
+
+```bash
+bun add @adatechnology/notification-ui
+```
+
+Peers: `react`, `react-dom`, `@tanstack/react-query`.
+
+## Uso
+
+```tsx
+import { NotificationProvider, NotificationBell } from '@adatechnology/notification-ui'
+import '@adatechnology/notification-ui/styles.css'
+
+<NotificationProvider client={notificationClient}>
+  <NotificationBell />
+</NotificationProvider>
+```
+
+Componentes: `NotificationBell`, `NotificationList`, `NotificationItem`, `PreferencesPanel`.
+
+## A camada headless é a que importa em produto com marca
+
+```tsx
+import { useNotifications, useUnreadCount, useMarkAsRead } from '@adatechnology/notification-ui/headless'
+```
+
+Hooks sem markup nenhum: `useNotifications` (paginação infinita), `useUnreadCount`,
+`useNotificationStream`, `useMarkAsRead`, `useMarkAllAsRead`, `useDeleteNotification`,
+`usePreferences`, `useUpdatePreferences`.
+
+Existe porque componente pronto quase nunca sobrevive ao design system do produto. A alternativa
+usual — aceitar 20 props de estilo — vira um tema pela porta dos fundos que não atende ninguém
+direito. Com os hooks, o host escreve o próprio markup e não reimplementa cache, paginação nem
+reconexão de stream.
+
+## Textos
+
+Nada é hardcoded: `resolveMessages` recebe o dicionário do host. O default é pt-BR.
+
+## Estado de servidor
+
+Tudo por TanStack Query — nunca `useEffect` + `useState` para carregar da API. O stream do SSE
+invalida as queries em vez de escrever no cache na mão: a origem da verdade continua sendo a API,
+e a tela não diverge se um evento se perder na reconexão.
+
+## Licença
+
+MIT © Ada Technology

package/dist/headless.d.ts

@@ -0,0 +1,139 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { NotificationClient } from '@adatechnology/notification-client';
+import * as _tanstack_react_query from '@tanstack/react-query';
+import * as _adatechnology_notification_contracts from '@adatechnology/notification-contracts';
+import { NotificationSummary, NotificationPreference } from '@adatechnology/notification-contracts';
+
+var ptBR = {
+	"bell.label": "Notificações",
+	"bell.unreadSuffix": "não lidas",
+	"list.title": "Notificações",
+	"list.empty": "Nenhuma notificação por aqui.",
+	"list.loading": "Carregando…",
+	"list.error": "Não foi possível carregar suas notificações.",
+	"list.retry": "Tentar de novo",
+	"list.loadMore": "Carregar mais",
+	"list.markAllAsRead": "Marcar todas como lidas",
+	"item.markAsRead": "Marcar como lida",
+	"item.delete": "Excluir",
+	"item.unread": "Não lida",
+	"preferences.title": "Preferências de notificação",
+	"preferences.description": "Escolha por onde você quer ser avisado em cada assunto.",
+	"preferences.save": "Salvar preferências",
+	"preferences.saved": "Preferências salvas.",
+	"preferences.error": "Não foi possível salvar. Tente de novo.",
+	"preferences.empty": "Nenhuma preferência configurada ainda.",
+	"preferences.quietHours": "Silêncio entre",
+	"preferences.quietHoursTo": "e",
+	"channel.inbox": "No app",
+	"channel.push": "Push",
+	"channel.email": "E-mail",
+	"channel.whatsapp": "WhatsApp",
+	"channel.sms": "SMS"
+};
+
+/**
+ * Copyright (c) 2026 Ada Technology. MIT License.
+ *
+ * Nenhum texto visível vive em tag ou prop (`web.md` §6). O host sobrescreve chaves pontuais via
+ * `messageOverrides` sem precisar fornecer um locale inteiro.
+ */
+
+type NotificationMessages = typeof ptBR;
+type NotificationLocale = 'pt-BR' | 'en';
+declare const DEFAULT_LOCALE: NotificationLocale;
+declare function resolveMessages(locale: NotificationLocale): NotificationMessages;
+
+type NotificationTheme = {
+    /** Classe aplicada na raiz de cada componente — é por onde o host injeta os tokens dele. */
+    readonly rootClassName?: string;
+    readonly components?: Partial<Record<string, string>>;
+};
+type NotificationContextValue = {
+    readonly client: NotificationClient;
+    readonly messages: NotificationMessages;
+    readonly theme: NotificationTheme;
+    /** Polling de fallback quando o SSE não está disponível (segundos); `0` desliga. */
+    readonly pollIntervalSeconds: number;
+};
+type NotificationProviderProps = {
+    readonly client: NotificationClient;
+    readonly locale?: NotificationLocale;
+    /** Sobrescreve textos pontuais sem trocar o locale inteiro. */
+    readonly messageOverrides?: Partial<NotificationMessages>;
+    readonly theme?: NotificationTheme;
+    readonly pollIntervalSeconds?: number;
+    readonly children: ReactNode;
+};
+declare function NotificationProvider({ client, locale, messageOverrides, theme, pollIntervalSeconds, children, }: NotificationProviderProps): react.JSX.Element;
+declare function useNotificationContext(): NotificationContextValue;
+
+type ListNotificationsPage = {
+    readonly data: readonly NotificationSummary[];
+    readonly nextCursor?: string;
+    readonly unreadCount: number;
+};
+
+type UseNotificationsOptions = {
+    readonly category?: string;
+    readonly read?: boolean;
+    readonly perPage?: number;
+};
+declare function useNotifications(options?: UseNotificationsOptions): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_react_query.InfiniteData<ListNotificationsPage, unknown>, Error>;
+declare function useUnreadCount(): _tanstack_react_query.UseQueryResult<number, Error>;
+declare function useMarkAsRead(): _tanstack_react_query.UseMutationResult<NotificationSummary, Error, string, {
+    previousCount: number | undefined;
+    id: string;
+}>;
+declare function useMarkAllAsRead(): _tanstack_react_query.UseMutationResult<number, Error, void, unknown>;
+declare function useDeleteNotification(): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
+/** Achata as páginas do infinite query — a lista quase sempre quer o array direto. */
+declare function flattenNotificationPages(pages: readonly {
+    data: readonly NotificationSummary[];
+}[] | undefined): readonly NotificationSummary[];
+
+/**
+ * Copyright (c) 2026 Ada Technology. MIT License.
+ */
+type UseNotificationStreamOptions = {
+    /** Desligado por omissão: abrir SSE é decisão do host, que sabe se o backend expõe a rota. */
+    readonly enabled?: boolean;
+    readonly onEvent?: (event: {
+        event: string;
+        data: unknown;
+    }) => void;
+};
+/**
+ * Liga o SSE do inbox ao cache do TanStack: cada evento invalida as chaves, e o badge e a lista
+ * atualizam juntos. `useEffect` aqui é o uso correto do hook — sincronizar com um sistema externo
+ * (`react.md`, "useEffect só para sincronizar com sistemas externos"), não transformar dado.
+ */
+declare function useNotificationStream(options?: UseNotificationStreamOptions): void;
+
+declare function usePreferences(): _tanstack_react_query.UseQueryResult<NoInfer<readonly NotificationPreference[]>, Error>;
+declare function useUpdatePreferences(): _tanstack_react_query.UseMutationResult<readonly NotificationPreference[], Error, readonly NotificationPreference[], unknown>;
+declare function useTemplates(): _tanstack_react_query.UseQueryResult<NoInfer<readonly _adatechnology_notification_contracts.NotificationTemplate[]>, Error>;
+
+/**
+ * Copyright (c) 2026 Ada Technology. MIT License.
+ *
+ * Chaves centralizadas: o sino e a lista leem o mesmo `unreadCount`, e uma invalidação precisa
+ * atingir os dois. Chave montada inline em cada hook é como badge e lista passam a mostrar
+ * números diferentes.
+ */
+declare const NOTIFICATION_QUERY_KEYS: {
+    readonly all: readonly ["notifications"];
+    readonly list: (filters: {
+        category?: string;
+        read?: boolean;
+    }) => readonly ["notifications", "list", {
+        category?: string;
+        read?: boolean;
+    }];
+    readonly unreadCount: () => readonly ["notifications", "unread-count"];
+    readonly preferences: () => readonly ["notifications", "preferences"];
+    readonly templates: () => readonly ["notifications", "templates"];
+};
+
+export { DEFAULT_LOCALE, NOTIFICATION_QUERY_KEYS, type NotificationContextValue, type NotificationLocale, type NotificationMessages, NotificationProvider, type NotificationProviderProps, type NotificationTheme, type UseNotificationStreamOptions, type UseNotificationsOptions, flattenNotificationPages, resolveMessages, useDeleteNotification, useMarkAllAsRead, useMarkAsRead, useNotificationContext, useNotificationStream, useNotifications, usePreferences, useTemplates, useUnreadCount, useUpdatePreferences };

package/dist/headless.js

@@ -0,0 +1,308 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/NotificationProvider.tsx
+import { createContext, useContext, useMemo } from "react";
+
+// src/locales/pt-BR.json
+var pt_BR_default = {
+  "bell.label": "Notifica\xE7\xF5es",
+  "bell.unreadSuffix": "n\xE3o lidas",
+  "list.title": "Notifica\xE7\xF5es",
+  "list.empty": "Nenhuma notifica\xE7\xE3o por aqui.",
+  "list.loading": "Carregando\u2026",
+  "list.error": "N\xE3o foi poss\xEDvel carregar suas notifica\xE7\xF5es.",
+  "list.retry": "Tentar de novo",
+  "list.loadMore": "Carregar mais",
+  "list.markAllAsRead": "Marcar todas como lidas",
+  "item.markAsRead": "Marcar como lida",
+  "item.delete": "Excluir",
+  "item.unread": "N\xE3o lida",
+  "preferences.title": "Prefer\xEAncias de notifica\xE7\xE3o",
+  "preferences.description": "Escolha por onde voc\xEA quer ser avisado em cada assunto.",
+  "preferences.save": "Salvar prefer\xEAncias",
+  "preferences.saved": "Prefer\xEAncias salvas.",
+  "preferences.error": "N\xE3o foi poss\xEDvel salvar. Tente de novo.",
+  "preferences.empty": "Nenhuma prefer\xEAncia configurada ainda.",
+  "preferences.quietHours": "Sil\xEAncio entre",
+  "preferences.quietHoursTo": "e",
+  "channel.inbox": "No app",
+  "channel.push": "Push",
+  "channel.email": "E-mail",
+  "channel.whatsapp": "WhatsApp",
+  "channel.sms": "SMS"
+};
+
+// src/locales/en.json
+var en_default = {
+  "bell.label": "Notifications",
+  "bell.unreadSuffix": "unread",
+  "list.title": "Notifications",
+  "list.empty": "Nothing here yet.",
+  "list.loading": "Loading\u2026",
+  "list.error": "We couldn't load your notifications.",
+  "list.retry": "Try again",
+  "list.loadMore": "Load more",
+  "list.markAllAsRead": "Mark all as read",
+  "item.markAsRead": "Mark as read",
+  "item.delete": "Delete",
+  "item.unread": "Unread",
+  "preferences.title": "Notification preferences",
+  "preferences.description": "Choose how you want to be notified about each topic.",
+  "preferences.save": "Save preferences",
+  "preferences.saved": "Preferences saved.",
+  "preferences.error": "Couldn't save. Try again.",
+  "preferences.empty": "No preferences configured yet.",
+  "preferences.quietHours": "Quiet between",
+  "preferences.quietHoursTo": "and",
+  "channel.inbox": "In app",
+  "channel.push": "Push",
+  "channel.email": "Email",
+  "channel.whatsapp": "WhatsApp",
+  "channel.sms": "SMS"
+};
+
+// src/locales/index.ts
+var DEFAULT_LOCALE = "pt-BR";
+var MESSAGES_BY_LOCALE = {
+  "pt-BR": pt_BR_default,
+  en: en_default
+};
+function resolveMessages(locale) {
+  return MESSAGES_BY_LOCALE[locale] ?? MESSAGES_BY_LOCALE[DEFAULT_LOCALE];
+}
+__name(resolveMessages, "resolveMessages");
+
+// src/NotificationProvider.tsx
+var NotificationContext = /* @__PURE__ */ createContext(null);
+function NotificationProvider({ client, locale = DEFAULT_LOCALE, messageOverrides, theme = {}, pollIntervalSeconds = 60, children }) {
+  const value = useMemo(() => ({
+    client,
+    messages: {
+      ...resolveMessages(locale),
+      ...messageOverrides
+    },
+    theme,
+    pollIntervalSeconds
+  }), [
+    client,
+    locale,
+    messageOverrides,
+    theme,
+    pollIntervalSeconds
+  ]);
+  return /* @__PURE__ */ React.createElement(NotificationContext.Provider, {
+    value
+  }, children);
+}
+__name(NotificationProvider, "NotificationProvider");
+function useNotificationContext() {
+  const context = useContext(NotificationContext);
+  if (!context) throw new Error("notification-ui: componente usado fora de <NotificationProvider>");
+  return context;
+}
+__name(useNotificationContext, "useNotificationContext");
+
+// src/hooks/useNotifications.ts
+import { useInfiniteQuery, useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+
+// src/hooks/queryKeys.ts
+var NOTIFICATION_QUERY_KEYS = {
+  all: [
+    "notifications"
+  ],
+  list: /* @__PURE__ */ __name((filters) => [
+    "notifications",
+    "list",
+    filters
+  ], "list"),
+  unreadCount: /* @__PURE__ */ __name(() => [
+    "notifications",
+    "unread-count"
+  ], "unreadCount"),
+  preferences: /* @__PURE__ */ __name(() => [
+    "notifications",
+    "preferences"
+  ], "preferences"),
+  templates: /* @__PURE__ */ __name(() => [
+    "notifications",
+    "templates"
+  ], "templates")
+};
+
+// src/hooks/useNotifications.ts
+function useNotifications(options = {}) {
+  const { client } = useNotificationContext();
+  return useInfiniteQuery({
+    queryKey: NOTIFICATION_QUERY_KEYS.list({
+      category: options.category,
+      read: options.read
+    }),
+    initialPageParam: void 0,
+    queryFn: /* @__PURE__ */ __name(({ pageParam }) => client.listNotifications({
+      category: options.category,
+      read: options.read,
+      cursor: pageParam,
+      perPage: options.perPage
+    }), "queryFn"),
+    getNextPageParam: /* @__PURE__ */ __name((lastPage) => lastPage.nextCursor, "getNextPageParam")
+  });
+}
+__name(useNotifications, "useNotifications");
+function useUnreadCount() {
+  const { client, pollIntervalSeconds } = useNotificationContext();
+  return useQuery({
+    queryKey: NOTIFICATION_QUERY_KEYS.unreadCount(),
+    queryFn: /* @__PURE__ */ __name(() => client.countUnread(), "queryFn"),
+    // Polling é o fallback de quem não ligou o SSE. Com o stream ativo,
+    // `useNotificationStream` invalida esta chave e o refetch acontece na hora.
+    refetchInterval: pollIntervalSeconds > 0 ? pollIntervalSeconds * 1e3 : false
+  });
+}
+__name(useUnreadCount, "useUnreadCount");
+function useMarkAsRead() {
+  const { client } = useNotificationContext();
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: /* @__PURE__ */ __name((id) => client.markAsRead(id), "mutationFn"),
+    async onMutate(id) {
+      await queryClient.cancelQueries({
+        queryKey: NOTIFICATION_QUERY_KEYS.all
+      });
+      const previousCount = queryClient.getQueryData(NOTIFICATION_QUERY_KEYS.unreadCount());
+      queryClient.setQueryData(NOTIFICATION_QUERY_KEYS.unreadCount(), (current) => current === void 0 ? current : Math.max(0, current - 1));
+      return {
+        previousCount,
+        id
+      };
+    },
+    onError(_error, _id, context) {
+      if (context?.previousCount !== void 0) {
+        queryClient.setQueryData(NOTIFICATION_QUERY_KEYS.unreadCount(), context.previousCount);
+      }
+    },
+    onSettled() {
+      void queryClient.invalidateQueries({
+        queryKey: NOTIFICATION_QUERY_KEYS.all
+      });
+    }
+  });
+}
+__name(useMarkAsRead, "useMarkAsRead");
+function useMarkAllAsRead() {
+  const { client } = useNotificationContext();
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: /* @__PURE__ */ __name(() => client.markAllAsRead(), "mutationFn"),
+    onSettled() {
+      void queryClient.invalidateQueries({
+        queryKey: NOTIFICATION_QUERY_KEYS.all
+      });
+    }
+  });
+}
+__name(useMarkAllAsRead, "useMarkAllAsRead");
+function useDeleteNotification() {
+  const { client } = useNotificationContext();
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: /* @__PURE__ */ __name((id) => client.deleteNotification(id), "mutationFn"),
+    onSettled() {
+      void queryClient.invalidateQueries({
+        queryKey: NOTIFICATION_QUERY_KEYS.all
+      });
+    }
+  });
+}
+__name(useDeleteNotification, "useDeleteNotification");
+function flattenNotificationPages(pages) {
+  return pages?.flatMap((page) => page.data) ?? [];
+}
+__name(flattenNotificationPages, "flattenNotificationPages");
+
+// src/hooks/useNotificationStream.ts
+import { useEffect } from "react";
+import { useQueryClient as useQueryClient2 } from "@tanstack/react-query";
+import { subscribeToNotificationStream } from "@adatechnology/notification-client";
+function useNotificationStream(options = {}) {
+  const { client } = useNotificationContext();
+  const queryClient = useQueryClient2();
+  const enabled = options.enabled ?? false;
+  const onEvent = options.onEvent;
+  useEffect(() => {
+    if (!enabled) return;
+    let subscription;
+    let cancelled = false;
+    void client.resolveStreamRequest().then(({ url, headers }) => {
+      if (cancelled) return;
+      subscription = subscribeToNotificationStream({
+        url,
+        headers,
+        onEvent: /* @__PURE__ */ __name((event) => {
+          onEvent?.(event);
+          void queryClient.invalidateQueries({
+            queryKey: NOTIFICATION_QUERY_KEYS.all
+          });
+        }, "onEvent")
+      });
+    });
+    return () => {
+      cancelled = true;
+      subscription?.close();
+    };
+  }, [
+    client,
+    queryClient,
+    enabled,
+    onEvent
+  ]);
+}
+__name(useNotificationStream, "useNotificationStream");
+
+// src/hooks/usePreferences.ts
+import { useMutation as useMutation2, useQuery as useQuery2, useQueryClient as useQueryClient3 } from "@tanstack/react-query";
+function usePreferences() {
+  const { client } = useNotificationContext();
+  return useQuery2({
+    queryKey: NOTIFICATION_QUERY_KEYS.preferences(),
+    queryFn: /* @__PURE__ */ __name(() => client.getPreferences(), "queryFn")
+  });
+}
+__name(usePreferences, "usePreferences");
+function useUpdatePreferences() {
+  const { client } = useNotificationContext();
+  const queryClient = useQueryClient3();
+  return useMutation2({
+    mutationFn: /* @__PURE__ */ __name((preferences) => client.updatePreferences(preferences), "mutationFn"),
+    onSuccess(saved) {
+      queryClient.setQueryData(NOTIFICATION_QUERY_KEYS.preferences(), saved);
+    }
+  });
+}
+__name(useUpdatePreferences, "useUpdatePreferences");
+function useTemplates() {
+  const { client } = useNotificationContext();
+  return useQuery2({
+    queryKey: NOTIFICATION_QUERY_KEYS.templates(),
+    queryFn: /* @__PURE__ */ __name(() => client.listTemplates(), "queryFn")
+  });
+}
+__name(useTemplates, "useTemplates");
+export {
+  DEFAULT_LOCALE,
+  NOTIFICATION_QUERY_KEYS,
+  NotificationProvider,
+  flattenNotificationPages,
+  resolveMessages,
+  useDeleteNotification,
+  useMarkAllAsRead,
+  useMarkAsRead,
+  useNotificationContext,
+  useNotificationStream,
+  useNotifications,
+  usePreferences,
+  useTemplates,
+  useUnreadCount,
+  useUpdatePreferences
+};
+//# sourceMappingURL=headless.js.map

package/dist/headless.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/NotificationProvider.tsx","../src/locales/pt-BR.json","../src/locales/en.json","../src/locales/index.ts","../src/hooks/useNotifications.ts","../src/hooks/queryKeys.ts","../src/hooks/useNotificationStream.ts","../src/hooks/usePreferences.ts"],"sourcesContent":["/**\n * Copyright (c) 2026 Ada Technology. MIT License.\n *\n * Provider do pacote. **Não instancia `QueryClient`** — usa o do host (regra de módulos\n * plugáveis §4.2). Instanciar o próprio criaria dois caches na mesma página: a inbox invalidaria\n * um, e a tela do produto continuaria lendo o outro.\n */\n\nimport { createContext, useContext, useMemo, type ReactNode } from 'react'\nimport type { NotificationClient } from '@adatechnology/notification-client'\n\nimport { DEFAULT_LOCALE, resolveMessages, type NotificationLocale, type NotificationMessages } from './locales'\n\nexport type NotificationTheme = {\n  /** Classe aplicada na raiz de cada componente — é por onde o host injeta os tokens dele. */\n  readonly rootClassName?: string\n  readonly components?: Partial<Record<string, string>>\n}\n\nexport type NotificationContextValue = {\n  readonly client: NotificationClient\n  readonly messages: NotificationMessages\n  readonly theme: NotificationTheme\n  /** Polling de fallback quando o SSE não está disponível (segundos); `0` desliga. */\n  readonly pollIntervalSeconds: number\n}\n\nconst NotificationContext = createContext<NotificationContextValue | null>(null)\n\nexport type NotificationProviderProps = {\n  readonly client: NotificationClient\n  readonly locale?: NotificationLocale\n  /** Sobrescreve textos pontuais sem trocar o locale inteiro. */\n  readonly messageOverrides?: Partial<NotificationMessages>\n  readonly theme?: NotificationTheme\n  readonly pollIntervalSeconds?: number\n  readonly children: ReactNode\n}\n\nexport function NotificationProvider({\n  client,\n  locale = DEFAULT_LOCALE,\n  messageOverrides,\n  theme = {},\n  pollIntervalSeconds = 60,\n  children,\n}: NotificationProviderProps) {\n  const value = useMemo<NotificationContextValue>(\n    () => ({\n      client,\n      messages: { ...resolveMessages(locale), ...messageOverrides },\n      theme,\n      pollIntervalSeconds,\n    }),\n    [client, locale, messageOverrides, theme, pollIntervalSeconds],\n  )\n\n  return <NotificationContext.Provider value={value}>{children}</NotificationContext.Provider>\n}\n\nexport function useNotificationContext(): NotificationContextValue {\n  const context = useContext(NotificationContext)\n  if (!context) throw new Error('notification-ui: componente usado fora de <NotificationProvider>')\n  return context\n}\n","{\n  \"bell.label\": \"Notificações\",\n  \"bell.unreadSuffix\": \"não lidas\",\n  \"list.title\": \"Notificações\",\n  \"list.empty\": \"Nenhuma notificação por aqui.\",\n  \"list.loading\": \"Carregando…\",\n  \"list.error\": \"Não foi possível carregar suas notificações.\",\n  \"list.retry\": \"Tentar de novo\",\n  \"list.loadMore\": \"Carregar mais\",\n  \"list.markAllAsRead\": \"Marcar todas como lidas\",\n  \"item.markAsRead\": \"Marcar como lida\",\n  \"item.delete\": \"Excluir\",\n  \"item.unread\": \"Não lida\",\n  \"preferences.title\": \"Preferências de notificação\",\n  \"preferences.description\": \"Escolha por onde você quer ser avisado em cada assunto.\",\n  \"preferences.save\": \"Salvar preferências\",\n  \"preferences.saved\": \"Preferências salvas.\",\n  \"preferences.error\": \"Não foi possível salvar. Tente de novo.\",\n  \"preferences.empty\": \"Nenhuma preferência configurada ainda.\",\n  \"preferences.quietHours\": \"Silêncio entre\",\n  \"preferences.quietHoursTo\": \"e\",\n  \"channel.inbox\": \"No app\",\n  \"channel.push\": \"Push\",\n  \"channel.email\": \"E-mail\",\n  \"channel.whatsapp\": \"WhatsApp\",\n  \"channel.sms\": \"SMS\"\n}\n","{\n  \"bell.label\": \"Notifications\",\n  \"bell.unreadSuffix\": \"unread\",\n  \"list.title\": \"Notifications\",\n  \"list.empty\": \"Nothing here yet.\",\n  \"list.loading\": \"Loading…\",\n  \"list.error\": \"We couldn't load your notifications.\",\n  \"list.retry\": \"Try again\",\n  \"list.loadMore\": \"Load more\",\n  \"list.markAllAsRead\": \"Mark all as read\",\n  \"item.markAsRead\": \"Mark as read\",\n  \"item.delete\": \"Delete\",\n  \"item.unread\": \"Unread\",\n  \"preferences.title\": \"Notification preferences\",\n  \"preferences.description\": \"Choose how you want to be notified about each topic.\",\n  \"preferences.save\": \"Save preferences\",\n  \"preferences.saved\": \"Preferences saved.\",\n  \"preferences.error\": \"Couldn't save. Try again.\",\n  \"preferences.empty\": \"No preferences configured yet.\",\n  \"preferences.quietHours\": \"Quiet between\",\n  \"preferences.quietHoursTo\": \"and\",\n  \"channel.inbox\": \"In app\",\n  \"channel.push\": \"Push\",\n  \"channel.email\": \"Email\",\n  \"channel.whatsapp\": \"WhatsApp\",\n  \"channel.sms\": \"SMS\"\n}\n","/**\n * Copyright (c) 2026 Ada Technology. MIT License.\n *\n * Nenhum texto visível vive em tag ou prop (`web.md` §6). O host sobrescreve chaves pontuais via\n * `messageOverrides` sem precisar fornecer um locale inteiro.\n */\n\nimport ptBR from './pt-BR.json'\nimport en from './en.json'\n\nexport type NotificationMessages = typeof ptBR\nexport type NotificationLocale = 'pt-BR' | 'en'\n\nexport const DEFAULT_LOCALE: NotificationLocale = 'pt-BR'\n\nconst MESSAGES_BY_LOCALE: Record<NotificationLocale, NotificationMessages> = {\n  'pt-BR': ptBR,\n  en: en as NotificationMessages,\n}\n\nexport function resolveMessages(locale: NotificationLocale): NotificationMessages {\n  return MESSAGES_BY_LOCALE[locale] ?? MESSAGES_BY_LOCALE[DEFAULT_LOCALE]\n}\n","/**\n * Copyright (c) 2026 Ada Technology. MIT License.\n *\n * Camada headless — a válvula de escape do item 4 da §4 da regra de módulos plugáveis: quando a\n * tela default não serve, o produto monta a própria sobre estes mesmos hooks e continua herdando\n * upgrades de lógica.\n */\n\nimport { useInfiniteQuery, useMutation, useQuery, useQueryClient } from '@tanstack/react-query'\nimport type { NotificationSummary } from '@adatechnology/notification-contracts'\n\nimport { useNotificationContext } from '../NotificationProvider'\nimport { NOTIFICATION_QUERY_KEYS } from './queryKeys'\n\nexport type UseNotificationsOptions = {\n  readonly category?: string\n  readonly read?: boolean\n  readonly perPage?: number\n}\n\nexport function useNotifications(options: UseNotificationsOptions = {}) {\n  const { client } = useNotificationContext()\n\n  return useInfiniteQuery({\n    queryKey: NOTIFICATION_QUERY_KEYS.list({ category: options.category, read: options.read }),\n    initialPageParam: undefined as string | undefined,\n    queryFn: ({ pageParam }) =>\n      client.listNotifications({\n        category: options.category,\n        read: options.read,\n        cursor: pageParam,\n        perPage: options.perPage,\n      }),\n    getNextPageParam: (lastPage) => lastPage.nextCursor,\n  })\n}\n\nexport function useUnreadCount() {\n  const { client, pollIntervalSeconds } = useNotificationContext()\n\n  return useQuery({\n    queryKey: NOTIFICATION_QUERY_KEYS.unreadCount(),\n    queryFn: () => client.countUnread(),\n    // Polling é o fallback de quem não ligou o SSE. Com o stream ativo,\n    // `useNotificationStream` invalida esta chave e o refetch acontece na hora.\n    refetchInterval: pollIntervalSeconds > 0 ? pollIntervalSeconds * 1000 : false,\n  })\n}\n\nexport function useMarkAsRead() {\n  const { client } = useNotificationContext()\n  const queryClient = useQueryClient()\n\n  return useMutation({\n    mutationFn: (id: string) => client.markAsRead(id),\n    async onMutate(id: string) {\n      // Atualização otimista: marcar como lida é ação de um clique, e esperar o round-trip para\n      // o badge cair faz a interface parecer travada.\n      await queryClient.cancelQueries({ queryKey: NOTIFICATION_QUERY_KEYS.all })\n      const previousCount = queryClient.getQueryData<number>(NOTIFICATION_QUERY_KEYS.unreadCount())\n\n      queryClient.setQueryData<number>(NOTIFICATION_QUERY_KEYS.unreadCount(), (current) =>\n        current === undefined ? current : Math.max(0, current - 1),\n      )\n      return { previousCount, id }\n    },\n    onError(_error, _id, context) {\n      // Rollback: sem isto o badge ficaria mentindo até o próximo refetch.\n      if (context?.previousCount !== undefined) {\n        queryClient.setQueryData(NOTIFICATION_QUERY_KEYS.unreadCount(), context.previousCount)\n      }\n    },\n    onSettled() {\n      void queryClient.invalidateQueries({ queryKey: NOTIFICATION_QUERY_KEYS.all })\n    },\n  })\n}\n\nexport function useMarkAllAsRead() {\n  const { client } = useNotificationContext()\n  const queryClient = useQueryClient()\n\n  return useMutation({\n    mutationFn: () => client.markAllAsRead(),\n    onSettled() {\n      void queryClient.invalidateQueries({ queryKey: NOTIFICATION_QUERY_KEYS.all })\n    },\n  })\n}\n\nexport function useDeleteNotification() {\n  const { client } = useNotificationContext()\n  const queryClient = useQueryClient()\n\n  return useMutation({\n    mutationFn: (id: string) => client.deleteNotification(id),\n    onSettled() {\n      void queryClient.invalidateQueries({ queryKey: NOTIFICATION_QUERY_KEYS.all })\n    },\n  })\n}\n\n/** Achata as páginas do infinite query — a lista quase sempre quer o array direto. */\nexport function flattenNotificationPages(\n  pages: readonly { data: readonly NotificationSummary[] }[] | undefined,\n): readonly NotificationSummary[] {\n  return pages?.flatMap((page) => page.data) ?? []\n}\n","/**\n * Copyright (c) 2026 Ada Technology. MIT License.\n *\n * Chaves centralizadas: o sino e a lista leem o mesmo `unreadCount`, e uma invalidação precisa\n * atingir os dois. Chave montada inline em cada hook é como badge e lista passam a mostrar\n * números diferentes.\n */\n\nexport const NOTIFICATION_QUERY_KEYS = {\n  all: ['notifications'] as const,\n  list: (filters: { category?: string; read?: boolean }) => ['notifications', 'list', filters] as const,\n  unreadCount: () => ['notifications', 'unread-count'] as const,\n  preferences: () => ['notifications', 'preferences'] as const,\n  templates: () => ['notifications', 'templates'] as const,\n} as const\n","/**\n * Copyright (c) 2026 Ada Technology. MIT License.\n */\n\nimport { useEffect } from 'react'\nimport { useQueryClient } from '@tanstack/react-query'\nimport { subscribeToNotificationStream } from '@adatechnology/notification-client'\n\nimport { useNotificationContext } from '../NotificationProvider'\nimport { NOTIFICATION_QUERY_KEYS } from './queryKeys'\n\nexport type UseNotificationStreamOptions = {\n  /** Desligado por omissão: abrir SSE é decisão do host, que sabe se o backend expõe a rota. */\n  readonly enabled?: boolean\n  readonly onEvent?: (event: { event: string; data: unknown }) => void\n}\n\n/**\n * Liga o SSE do inbox ao cache do TanStack: cada evento invalida as chaves, e o badge e a lista\n * atualizam juntos. `useEffect` aqui é o uso correto do hook — sincronizar com um sistema externo\n * (`react.md`, \"useEffect só para sincronizar com sistemas externos\"), não transformar dado.\n */\nexport function useNotificationStream(options: UseNotificationStreamOptions = {}): void {\n  const { client } = useNotificationContext()\n  const queryClient = useQueryClient()\n  const enabled = options.enabled ?? false\n  const onEvent = options.onEvent\n\n  useEffect(() => {\n    if (!enabled) return\n\n    let subscription: { close(): void } | undefined\n    let cancelled = false\n\n    void client.resolveStreamRequest().then(({ url, headers }) => {\n      // A resolução do token é assíncrona; se o componente desmontou nesse meio-tempo, não abre\n      // conexão nenhuma — senão sobraria um stream órfão a cada navegação rápida.\n      if (cancelled) return\n\n      subscription = subscribeToNotificationStream({\n        url,\n        headers,\n        onEvent: (event) => {\n          onEvent?.(event)\n          void queryClient.invalidateQueries({ queryKey: NOTIFICATION_QUERY_KEYS.all })\n        },\n      })\n    })\n\n    return () => {\n      cancelled = true\n      subscription?.close()\n    }\n  }, [client, queryClient, enabled, onEvent])\n}\n","/**\n * Copyright (c) 2026 Ada Technology. MIT License.\n */\n\nimport { useMutation, useQuery, useQueryClient } from '@tanstack/react-query'\nimport type { NotificationPreference } from '@adatechnology/notification-contracts'\n\nimport { useNotificationContext } from '../NotificationProvider'\nimport { NOTIFICATION_QUERY_KEYS } from './queryKeys'\n\nexport function usePreferences() {\n  const { client } = useNotificationContext()\n\n  return useQuery({\n    queryKey: NOTIFICATION_QUERY_KEYS.preferences(),\n    queryFn: () => client.getPreferences(),\n  })\n}\n\nexport function useUpdatePreferences() {\n  const { client } = useNotificationContext()\n  const queryClient = useQueryClient()\n\n  return useMutation({\n    mutationFn: (preferences: readonly NotificationPreference[]) => client.updatePreferences(preferences),\n    onSuccess(saved) {\n      // A resposta já é o estado persistido — usar direto evita um refetch e o piscar do painel\n      // entre o valor otimista e o confirmado.\n      queryClient.setQueryData(NOTIFICATION_QUERY_KEYS.preferences(), saved)\n    },\n  })\n}\n\nexport function useTemplates() {\n  const { client } = useNotificationContext()\n\n  return useQuery({\n    queryKey: NOTIFICATION_QUERY_KEYS.templates(),\n    queryFn: () => client.listTemplates(),\n  })\n}\n"],"mappings":"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","names":["createContext","useContext","useMemo","DEFAULT_LOCALE","MESSAGES_BY_LOCALE","ptBR","en","resolveMessages","locale","NotificationContext","createContext","NotificationProvider","client","locale","DEFAULT_LOCALE","messageOverrides","theme","pollIntervalSeconds","children","value","useMemo","messages","resolveMessages","Provider","useNotificationContext","context","useContext","Error","useInfiniteQuery","useMutation","useQuery","useQueryClient","NOTIFICATION_QUERY_KEYS","all","list","filters","unreadCount","preferences","templates","useNotifications","options","client","useNotificationContext","useInfiniteQuery","queryKey","NOTIFICATION_QUERY_KEYS","list","category","read","initialPageParam","undefined","queryFn","pageParam","listNotifications","cursor","perPage","getNextPageParam","lastPage","nextCursor","useUnreadCount","pollIntervalSeconds","useQuery","unreadCount","countUnread","refetchInterval","useMarkAsRead","queryClient","useQueryClient","useMutation","mutationFn","id","markAsRead","onMutate","cancelQueries","all","previousCount","getQueryData","setQueryData","current","Math","max","onError","_error","_id","context","onSettled","invalidateQueries","useMarkAllAsRead","markAllAsRead","useDeleteNotification","deleteNotification","flattenNotificationPages","pages","flatMap","page","data","useEffect","useQueryClient","subscribeToNotificationStream","useNotificationStream","options","client","useNotificationContext","queryClient","useQueryClient","enabled","onEvent","useEffect","subscription","cancelled","resolveStreamRequest","then","url","headers","subscribeToNotificationStream","event","invalidateQueries","queryKey","NOTIFICATION_QUERY_KEYS","all","close","useMutation","useQuery","useQueryClient","usePreferences","client","useNotificationContext","useQuery","queryKey","NOTIFICATION_QUERY_KEYS","preferences","queryFn","getPreferences","useUpdatePreferences","queryClient","useQueryClient","useMutation","mutationFn","updatePreferences","onSuccess","saved","setQueryData","useTemplates","templates","listTemplates"]}

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+export { DEFAULT_LOCALE, NOTIFICATION_QUERY_KEYS, NotificationContextValue, NotificationLocale, NotificationMessages, NotificationProvider, NotificationProviderProps, NotificationTheme, UseNotificationStreamOptions, UseNotificationsOptions, flattenNotificationPages, resolveMessages, useDeleteNotification, useMarkAllAsRead, useMarkAsRead, useNotificationContext, useNotificationStream, useNotifications, usePreferences, useTemplates, useUnreadCount, useUpdatePreferences } from './headless.js';
+import * as react from 'react';
+import { NotificationSummary } from '@adatechnology/notification-contracts';
+import '@adatechnology/notification-client';
+import '@tanstack/react-query';
+
+/**
+ * Copyright (c) 2026 Ada Technology. MIT License.
+ */
+type NotificationBellProps = {
+    readonly onClick?: () => void;
+    readonly className?: string;
+    /** Acima disso o badge mostra `99+`; um número de 4 dígitos estoura o desenho do badge. */
+    readonly maxBadgeCount?: number;
+};
+declare function NotificationBell({ onClick, className, maxBadgeCount }: NotificationBellProps): react.JSX.Element;
+
+type NotificationItemProps = {
+    readonly notification: NotificationSummary;
+    readonly onSelect?: (notification: NotificationSummary) => void;
+    readonly className?: string;
+};
+declare function NotificationItem({ notification, onSelect, className }: NotificationItemProps): react.JSX.Element;
+
+type NotificationListProps = {
+    readonly category?: string;
+    readonly onSelect?: (notification: NotificationSummary) => void;
+    readonly className?: string;
+    /** Slot: o host troca a linha sem reimplementar a lista (regra §4.3, slots e overrides). */
+    readonly components?: {
+        readonly Item?: typeof NotificationItem;
+    };
+};
+declare function NotificationList({ category, onSelect, className, components }: NotificationListProps): react.JSX.Element;
+
+/**
+ * Copyright (c) 2026 Ada Technology. MIT License.
+ */
+type PreferencesPanelProps = {
+    readonly className?: string;
+};
+declare function PreferencesPanel({ className }: PreferencesPanelProps): react.JSX.Element;
+
+export { NotificationBell, type NotificationBellProps, NotificationItem, type NotificationItemProps, NotificationList, type NotificationListProps, PreferencesPanel, type PreferencesPanelProps };