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

package/dist/headless.d.ts

@@ -4,12 +4,13 @@ import * as _adatechnology_notification_client from '@adatechnology/notification
 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, NotificationTemplate, RenderedTemplatePreview } from '@adatechnology/notification-contracts';
+import { NotificationSummary, NotificationPreference, PreviewViewportSpec, RenderedTemplatePreview, NotificationTemplate, TemplateVariableDefinition, TemplateVariableDiff } from '@adatechnology/notification-contracts';
 
 var ptBR = {
 	"bell.label": "Notificações",
 	"bell.unreadSuffix": "não lidas",
-	"list.title": "Notificações",
+	"list.title": "Caixa de entrada",
+	"list.unread": "não lidas",
 	"list.empty": "Nenhuma notificação por aqui.",
 	"list.loading": "Carregando…",
 	"list.error": "Não foi possível carregar suas notificações.",
@@ -51,7 +52,26 @@ var ptBR = {
 	"settings.saving": "Salvando…",
 	"settings.unchanged": "Nada mudou ainda.",
 	"settings.close": "Fechar",
-	"settings.version": "v"
+	"settings.version": "v",
+	"settings.newTemplate": "Nova mensagem",
+	"settings.remove": "Remover",
+	"settings.key": "Chave da notificação",
+	"settings.keyHint": "Não muda depois de criada — é por ela que o envio acha a mensagem.",
+	"settings.channel": "Canal",
+	"settings.locale": "Idioma",
+	"settings.variablesTitle": "Variáveis",
+	"settings.variablesHint": "Clique para inserir no ponto onde o cursor estava.",
+	"settings.unknownVariables": "Variáveis que não existem nesta notificação:",
+	"settings.viewport.desktop": "Computador",
+	"settings.viewport.mobile": "Celular",
+	"settings.constraint.title": "Assunto passa do limite do canal:",
+	"settings.constraint.body": "Texto passa do limite do canal:",
+	"settings.tab.messages": "Mensagens",
+	"settings.tab.routing": "Roteamento",
+	"settings.policiesTitle": "Canais permitidos por assunto",
+	"settings.policiesHint": "Decisão da empresa. Canal desligado aqui não sai, mesmo que o destinatário tenha pedido.",
+	"settings.savePolicies": "Salvar roteamento",
+	"settings.discard": "Descartar"
 };
 
 /**
@@ -73,6 +93,12 @@ type NotificationTheme = {
 };
 type NotificationContextValue = {
     readonly client: NotificationClient;
+    /**
+     * O idioma resolvido, e não só os textos dele: data e número não vivem no arquivo de locale —
+     * quem os formata é `Intl`, e `Intl` precisa da tag do idioma. Sem isto o item da lista teria de
+     * chutar um locale fixo, e a inbox mostraria "5 minutes ago" numa tela em português.
+     */
+    readonly locale: NotificationLocale;
     readonly messages: NotificationMessages;
     readonly theme: NotificationTheme;
     /** Polling de fallback quando o SSE não está disponível (segundos); `0` desliga. */
@@ -126,6 +152,37 @@ type UseNotificationStreamOptions = {
  */
 declare function useNotificationStream(options?: UseNotificationStreamOptions): void;
 
+/**
+ * Copyright (c) 2026 Ada Technology. MIT License.
+ *
+ * O roteamento: por quais canais cada categoria PODE sair, decidido pela empresa.
+ *
+ * É a camada que faltava. O chamador já podia enumerar canais em cada `sendNotification`, e quem
+ * recebe já tinha preferência — mas "cobrança nunca sai por SMS" não cabia em nenhum dos dois:
+ * o primeiro espalha a decisão por todo o código, o segundo deixa ela na mão do destinatário.
+ *
+ * O modelo aqui é de teto, não de piso: desligar barra o canal para todo mundo; ligar apenas
+ * permite, e a preferência de quem recebe continua valendo por cima.
+ */
+type UseCategoryPoliciesResult = {
+    readonly isLoading: boolean;
+    readonly isSaving: boolean;
+    readonly error: string | undefined;
+    readonly isDirty: boolean;
+    /** Linha ausente é permitido — o mesmo default do servidor, para a tela não mentir. */
+    isAllowed: (params: {
+        category: string;
+        channel: string;
+    }) => boolean;
+    toggle: (params: {
+        category: string;
+        channel: string;
+    }) => void;
+    save: () => void;
+    reset: () => void;
+};
+declare function useCategoryPolicies(): UseCategoryPoliciesResult;
+
 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>;
@@ -146,6 +203,17 @@ declare function useUpsertTemplate(): _tanstack_react_query.UseMutationResult<_a
     subject?: string | undefined;
     whatsappTemplateName?: string | undefined;
 }, unknown>;
+/**
+ * O catálogo é config do host: muda com deploy, não com uso. `staleTime: Infinity` evita refetch a
+ * cada foco de janela por um dado que não muda durante a sessão.
+ */
+declare function useTemplateVariables(): _tanstack_react_query.UseQueryResult<NoInfer<Readonly<Record<string, readonly _adatechnology_notification_contracts.TemplateVariableDefinition[]>>>, Error>;
+/**
+ * Desativa o template. Invalida a lista pelo mesmo motivo do upsert: o servidor derruba TODAS as
+ * versões ativas da identidade, e um cache otimista que removesse só a linha clicada mostraria a
+ * versão anterior de volta na tela.
+ */
+declare function useDeactivateTemplate(): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
 
 /**
  * Copyright (c) 2026 Ada Technology. MIT License.
@@ -166,8 +234,23 @@ declare const NOTIFICATION_QUERY_KEYS: {
     readonly unreadCount: () => readonly ["notifications", "unread-count"];
     readonly preferences: () => readonly ["notifications", "preferences"];
     readonly templates: () => readonly ["notifications", "templates"];
+    readonly templateVariables: () => readonly ["notifications", "template-variables"];
+    readonly categoryPolicies: () => readonly ["notifications", "category-policies"];
 };
 
+/**
+ * Copyright (c) 2026 Ada Technology. MIT License.
+ *
+ * Quando o aviso chegou, dito do jeito que se diz em voz alta.
+ *
+ * `Intl` faz o trabalho de idioma — o pacote não guarda "há", "ago" nem nome de mês em lugar nenhum,
+ * o que manteria `web.md` §6 de pé e ainda assim quebraria no primeiro locale novo. O que é decisão
+ * nossa são as faixas: segundo, minuto, hora, dia, e a virada para data absoluta.
+ */
+declare function formatNotificationTime(isoTimestamp: string, locale: string, now: Date): string;
+/** O instante inteiro, para o `title` — é a hora que o texto relativo esconde. */
+declare function formatNotificationTimestamp(isoTimestamp: string, locale: string): string;
+
 /**
  * Copyright (c) 2026 Ada Technology. MIT License.
  *
@@ -185,6 +268,10 @@ declare const NOTIFICATION_QUERY_KEYS: {
  *    derivar título vazio, em vez de cair no fallback que usa o corpo.
  * 4. **Preview pelo `renderTemplate` do contracts**, o mesmo do envio. Reimplementar a interpolação
  *    dá um preview que confere hoje e mente quando o renderer mudar.
+ *
+ * A criação de template novo trouxe uma quinta: **a identidade é imutável depois de criada**.
+ * `key`+`channel`+`locale` é o que o `sendNotification` procura; deixar editar num template
+ * existente não seria edição, seria criar outro e deixar o antigo órfão no ar.
  */
 
 type TemplateDraft = {
@@ -195,27 +282,52 @@ type TemplateDraft = {
     readonly body: string;
     readonly whatsappTemplateName: string;
 };
+type TemplateDraftField = 'subject' | 'body';
+type TemplatePreviewFrame = PreviewViewportSpec & {
+    readonly rendered: RenderedTemplatePreview;
+};
 type UseTemplateEditorParams = {
     /**
-     * Valores de exemplo do preview. É do produto: só ele sabe que `{{shortCode}}` é "QC-1042".
-     * Ausente, o preview mostra os campos vazios — que é o que o destinatário veria mesmo.
+     * Valores de exemplo do preview. Hoje o padrão vem do catálogo de variáveis do servidor; isto
+     * continua existindo para o produto sobrescrever um exemplo pontual sem mexer no catálogo.
      */
     readonly previewPayload?: Readonly<Record<string, unknown>>;
+    /** Canal e locale de um template novo, antes de o operador escolher. */
+    readonly defaultChannel?: string;
+    readonly defaultLocale?: string;
 };
 type UseTemplateEditorResult = {
     readonly templates: readonly NotificationTemplate[];
     readonly isLoading: boolean;
     readonly isSaving: boolean;
+    readonly isDeactivating: boolean;
     readonly error: string | undefined;
     readonly selected: NotificationTemplate | undefined;
     readonly draft: TemplateDraft | undefined;
-    readonly preview: RenderedTemplatePreview | undefined;
+    /** `true` enquanto o rascunho é um template que ainda não existe no servidor. */
+    readonly isNew: boolean;
+    /** Identidade travada — `false` só durante a criação. */
+    readonly isIdentityLocked: boolean;
+    /** Os dois quadros do preview, na ordem em que a tela desenha. */
+    readonly previews: readonly TemplatePreviewFrame[];
+    /** As variáveis que esta `key` declara. Vazio quando o catálogo não conhece a chave. */
+    readonly variables: readonly TemplateVariableDefinition[];
+    readonly variableDiff: TemplateVariableDiff;
     readonly isDirty: boolean;
+    readonly canSave: boolean;
     select: (template: NotificationTemplate) => void;
+    startNew: () => void;
     update: (patch: Partial<TemplateDraft>) => void;
+    /** Insere `{{nome}}` na posição do cursor. O operador nunca digita o nome à mão. */
+    insertVariable: (params: {
+        name: string;
+        field: TemplateDraftField;
+        cursorIndex: number;
+    }) => void;
     save: () => void;
+    deactivate: (id: string) => void;
     clear: () => void;
 };
 declare function useTemplateEditor(params?: UseTemplateEditorParams): UseTemplateEditorResult;
 
-export { DEFAULT_LOCALE, NOTIFICATION_QUERY_KEYS, type NotificationContextValue, type NotificationLocale, type NotificationMessages, NotificationProvider, type NotificationProviderProps, type NotificationTheme, type TemplateDraft, type UseNotificationStreamOptions, type UseNotificationsOptions, type UseTemplateEditorParams, type UseTemplateEditorResult, flattenNotificationPages, resolveMessages, useDeleteNotification, useMarkAllAsRead, useMarkAsRead, useNotificationContext, useNotificationStream, useNotifications, usePreferences, useTemplateEditor, useTemplates, useUnreadCount, useUpdatePreferences, useUpsertTemplate };
+export { DEFAULT_LOCALE, NOTIFICATION_QUERY_KEYS, type NotificationContextValue, type NotificationLocale, type NotificationMessages, NotificationProvider, type NotificationProviderProps, type NotificationTheme, type TemplateDraft, type TemplateDraftField, type TemplatePreviewFrame, type UseCategoryPoliciesResult, type UseNotificationStreamOptions, type UseNotificationsOptions, type UseTemplateEditorParams, type UseTemplateEditorResult, flattenNotificationPages, formatNotificationTime, formatNotificationTimestamp, resolveMessages, useCategoryPolicies, useDeactivateTemplate, useDeleteNotification, useMarkAllAsRead, useMarkAsRead, useNotificationContext, useNotificationStream, useNotifications, usePreferences, useTemplateEditor, useTemplateVariables, useTemplates, useUnreadCount, useUpdatePreferences, useUpsertTemplate };

package/dist/headless.js

@@ -3,7 +3,11 @@ import {
   NOTIFICATION_QUERY_KEYS,
   NotificationProvider,
   flattenNotificationPages,
+  formatNotificationTime,
+  formatNotificationTimestamp,
   resolveMessages,
+  useCategoryPolicies,
+  useDeactivateTemplate,
   useDeleteNotification,
   useMarkAllAsRead,
   useMarkAsRead,
@@ -12,17 +16,22 @@ import {
   useNotifications,
   usePreferences,
   useTemplateEditor,
+  useTemplateVariables,
   useTemplates,
   useUnreadCount,
   useUpdatePreferences,
   useUpsertTemplate
-} from "./chunk-FNUYTJ36.js";
+} from "./chunk-QBQ62VZ3.js";
 export {
   DEFAULT_LOCALE,
   NOTIFICATION_QUERY_KEYS,
   NotificationProvider,
   flattenNotificationPages,
+  formatNotificationTime,
+  formatNotificationTimestamp,
   resolveMessages,
+  useCategoryPolicies,
+  useDeactivateTemplate,
   useDeleteNotification,
   useMarkAllAsRead,
   useMarkAsRead,
@@ -31,6 +40,7 @@ export {
   useNotifications,
   usePreferences,
   useTemplateEditor,
+  useTemplateVariables,
   useTemplates,
   useUnreadCount,
   useUpdatePreferences,

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-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';
+export { DEFAULT_LOCALE, NOTIFICATION_QUERY_KEYS, NotificationContextValue, NotificationLocale, NotificationMessages, NotificationProvider, NotificationProviderProps, NotificationTheme, TemplateDraft, TemplateDraftField, TemplatePreviewFrame, UseCategoryPoliciesResult, UseNotificationStreamOptions, UseNotificationsOptions, UseTemplateEditorParams, UseTemplateEditorResult, flattenNotificationPages, formatNotificationTime, formatNotificationTimestamp, resolveMessages, useCategoryPolicies, useDeactivateTemplate, useDeleteNotification, useMarkAllAsRead, useMarkAsRead, useNotificationContext, useNotificationStream, useNotifications, usePreferences, useTemplateEditor, useTemplateVariables, useTemplates, useUnreadCount, useUpdatePreferences, useUpsertTemplate } from './headless.js';
 import * as react from 'react';
 import { ReactNode } from 'react';
 import { NotificationSummary, NotificationTemplate } from '@adatechnology/notification-contracts';
@@ -14,7 +14,7 @@ type NotificationBellProps = {
     /** 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;
+declare function NotificationBell({ onClick, className, maxBadgeCount, }: NotificationBellProps): react.JSX.Element;
 
 type NotificationItemProps = {
     readonly notification: NotificationSummary;
@@ -27,12 +27,17 @@ type NotificationListProps = {
     readonly category?: string;
     readonly onSelect?: (notification: NotificationSummary) => void;
     readonly className?: string;
+    /**
+     * Substitui o vazio padrão. Quem decide se está vazio é a lista — o host que desenhava o próprio
+     * vazio ao lado dela mostrava "nada por aqui" embaixo das notificações que estavam ali.
+     */
+    readonly renderEmpty?: () => ReactNode;
     /** 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;
+declare function NotificationList({ category, onSelect, className, renderEmpty, components }: NotificationListProps): react.JSX.Element;
 
 /**
  * Copyright (c) 2026 Ada Technology. MIT License.
@@ -58,6 +63,14 @@ type NotificationsWorkspaceProps = {
     readonly settingsHref?: string | undefined;
     /** Clique numa notificação. Ausente, a linha não é clicável. */
     readonly onSelectNotification?: (notification: NotificationSummary) => void;
+    /**
+     * Substitui o cabeçalho padrão inteiro.
+     *
+     * O workspace desenha um `<h1>` porque ele é a tela; a página que já tem o título dela passava a
+     * ter dois `<h1>` dizendo a mesma palavra, e para leitor de tela duas primeiras manchetes é o
+     * mesmo que nenhuma. Ausente, o padrão continua desenhando — slot é substituição, não interruptor.
+     */
+    readonly renderHeader?: () => ReactNode;
     /** 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. */
@@ -66,7 +79,7 @@ type NotificationsWorkspaceProps = {
     readonly renderEmpty?: () => ReactNode;
     readonly className?: string;
 };
-declare function NotificationsWorkspace({ labels: labelsOverride, category, showPreferences, settingsHref, onSelectNotification, renderHeaderActions, renderAboveList, renderEmpty, className, }: NotificationsWorkspaceProps): react.JSX.Element;
+declare function NotificationsWorkspace({ labels: labelsOverride, category, showPreferences, settingsHref, onSelectNotification, renderHeader, renderHeaderActions, renderAboveList, renderEmpty, className, }: NotificationsWorkspaceProps): react.JSX.Element;
 
 type NotificationChannelOption = {
     readonly id: string;
@@ -101,10 +114,12 @@ type NotificationSettingsWorkspaceProps = {
         readonly value: string;
         readonly onChange: (value: string) => void;
     }) => ReactNode;
+    /** Substitui o cabeçalho padrão — a página que já tem título próprio evita o segundo `<h1>`. */
+    readonly renderHeader?: () => 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;
+declare function NotificationSettingsWorkspace({ labels: labelsOverride, channels, categories, previewPayload, templateLabelOf, renderChannelFields, renderHeader, 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 };