@adatechnology/notification-ui 0.1.0-rc.1 → 0.1.0-rc.2

package/dist/headless.js

@@ -1,293 +1,22 @@
-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");
+import {
+  DEFAULT_LOCALE,
+  NOTIFICATION_QUERY_KEYS,
+  NotificationProvider,
+  flattenNotificationPages,
+  resolveMessages,
+  useDeleteNotification,
+  useMarkAllAsRead,
+  useMarkAsRead,
+  useNotificationContext,
+  useNotificationStream,
+  useNotifications,
+  usePreferences,
+  useTemplateEditor,
+  useTemplates,
+  useUnreadCount,
+  useUpdatePreferences,
+  useUpsertTemplate
+} from "./chunk-FNUYTJ36.js";
 export {
   DEFAULT_LOCALE,
   NOTIFICATION_QUERY_KEYS,
@@ -301,8 +30,10 @@ export {
   useNotificationStream,
   useNotifications,
   usePreferences,
+  useTemplateEditor,
   useTemplates,
   useUnreadCount,
-  useUpdatePreferences
+  useUpdatePreferences,
+  useUpsertTemplate
 };
 //# sourceMappingURL=headless.js.map

package/dist/headless.js.map

@@ -1 +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"]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-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';
+export { DEFAULT_LOCALE, NOTIFICATION_QUERY_KEYS, NotificationContextValue, NotificationLocale, NotificationMessages, NotificationProvider, NotificationProviderProps, NotificationTheme, TemplateDraft, UseNotificationStreamOptions, UseNotificationsOptions, UseTemplateEditorParams, UseTemplateEditorResult, flattenNotificationPages, resolveMessages, useDeleteNotification, useMarkAllAsRead, useMarkAsRead, useNotificationContext, useNotificationStream, useNotifications, usePreferences, useTemplateEditor, useTemplates, useUnreadCount, useUpdatePreferences, useUpsertTemplate } from './headless.js';
 import * as react from 'react';
-import { NotificationSummary } from '@adatechnology/notification-contracts';
+import { ReactNode } from 'react';
+import { NotificationSummary, NotificationTemplate } from '@adatechnology/notification-contracts';
 import '@adatechnology/notification-client';
 import '@tanstack/react-query';
 
@@ -41,4 +42,69 @@ type PreferencesPanelProps = {
 };
 declare function PreferencesPanel({ className }: PreferencesPanelProps): react.JSX.Element;
 
-export { NotificationBell, type NotificationBellProps, NotificationItem, type NotificationItemProps, NotificationList, type NotificationListProps, PreferencesPanel, type PreferencesPanelProps };
+type NotificationsWorkspaceProps = {
+    /** Sobrescreve textos pontuais sem trocar o locale inteiro. */
+    readonly labels?: Partial<Record<string, string>>;
+    /** Filtra a inbox por assunto. Ausente, mostra tudo. */
+    readonly category?: string;
+    /**
+     * Coluna de preferências ao lado da inbox.
+     *
+     * Ligada por padrão porque é o caso comum; um produto que gerencia preferência noutra tela passa
+     * `false` e fica só com a inbox, em largura cheia.
+     */
+    readonly showPreferences?: boolean;
+    /** Ausente, o link de configuração não aparece — o produto pode não ter essa tela. */
+    readonly settingsHref?: string | undefined;
+    /** Clique numa notificação. Ausente, a linha não é clicável. */
+    readonly onSelectNotification?: (notification: NotificationSummary) => void;
+    /** Ações do produto no cabeçalho, ao lado do link de configuração. */
+    readonly renderHeaderActions?: () => ReactNode;
+    /** Aviso ou filtro do produto, entre o cabeçalho e a lista. */
+    readonly renderAboveList?: () => ReactNode;
+    /** Substitui o vazio padrão — útil quando o produto sabe explicar por que está vazio. */
+    readonly renderEmpty?: () => ReactNode;
+    readonly className?: string;
+};
+declare function NotificationsWorkspace({ labels: labelsOverride, category, showPreferences, settingsHref, onSelectNotification, renderHeaderActions, renderAboveList, renderEmpty, className, }: NotificationsWorkspaceProps): react.JSX.Element;
+
+type NotificationChannelOption = {
+    readonly id: string;
+    readonly label: string;
+    /** O custo do canal, em uma linha. É o que faz alguém decidir em vez de chutar. */
+    readonly hint?: string;
+};
+type NotificationCategoryOption = {
+    readonly id: string;
+    readonly label: string;
+    readonly hint?: string;
+};
+type NotificationSettingsWorkspaceProps = {
+    readonly labels?: Partial<Record<string, string>>;
+    /** Os canais que ESTE produto oferece — o pacote despacha em cinco e não opina sobre quais usar. */
+    readonly channels: readonly NotificationChannelOption[];
+    /** Os assuntos que este produto dispara. */
+    readonly categories: readonly NotificationCategoryOption[];
+    /**
+     * Valores de exemplo do preview, por assunto do template. Ausente, o preview mostra campo vazio —
+     * que é honesto, mas menos útil para quem está escrevendo o texto.
+     */
+    readonly previewPayload?: Readonly<Record<string, unknown>>;
+    /** Traduz `order.status.preparing` no rótulo que o produto usa. Ausente, mostra a chave crua. */
+    readonly templateLabelOf?: (template: NotificationTemplate) => string;
+    /**
+     * Campo extra por canal — é onde entra o nome do template aprovado na Meta, que só o WhatsApp tem.
+     * Ausente, nenhum campo extra aparece.
+     */
+    readonly renderChannelFields?: (params: {
+        readonly channel: string;
+        readonly value: string;
+        readonly onChange: (value: string) => void;
+    }) => ReactNode;
+    /** Ações do produto no cabeçalho. */
+    readonly renderHeaderActions?: () => ReactNode;
+    readonly className?: string;
+};
+declare function NotificationSettingsWorkspace({ labels: labelsOverride, channels, categories, previewPayload, templateLabelOf, renderChannelFields, renderHeaderActions, className, }: NotificationSettingsWorkspaceProps): react.JSX.Element;
+
+export { NotificationBell, type NotificationBellProps, type NotificationCategoryOption, type NotificationChannelOption, NotificationItem, type NotificationItemProps, NotificationList, type NotificationListProps, NotificationSettingsWorkspace, type NotificationSettingsWorkspaceProps, NotificationsWorkspace, type NotificationsWorkspaceProps, PreferencesPanel, type PreferencesPanelProps };