@adatechnology/notification-ui 0.4.0 → 0.5.0

package/dist/{headless-03_gfBEI.d.ts → headless--Os4o240.d.ts}

@@ -2,9 +2,9 @@ import * as react from 'react';
 import { ReactNode } from 'react';
 import * as _adatechnology_notification_client from '@adatechnology/notification-client';
 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, PreviewViewportSpec, RenderedTemplatePreview, NotificationTemplate, StandardEmailAssessment, TemplateVariableDefinition, TemplateVariableDiff } from '@adatechnology/notification-contracts';
+import { WebPushSubscription, NotificationSummary, NotificationPreference, PreviewViewportSpec, RenderedTemplatePreview, NotificationTemplate, StandardEmailAssessment, TemplateVariableDefinition, TemplateVariableDiff } from '@adatechnology/notification-contracts';
+import * as _tanstack_react_query from '@tanstack/react-query';
 
 var ptBR = {
 	"bell.label": "Notificações",
@@ -20,6 +20,7 @@ var ptBR = {
 	"item.markAsRead": "Marcar como lida",
 	"item.delete": "Excluir",
 	"item.unread": "Não lida",
+	"item.addToCalendar": "Adicionar à agenda",
 	"preferences.title": "Preferências de notificação",
 	"preferences.description": "Escolha por onde você quer ser avisado em cada assunto.",
 	"preferences.save": "Salvar preferências",
@@ -115,7 +116,17 @@ var ptBR = {
 	"toolbar.italic": "Italico",
 	"toolbar.strikethrough": "Tachado",
 	"toolbar.monospace": "Monoespacado",
-	"toolbar.emoji": "Emoji"
+	"toolbar.emoji": "Emoji",
+	"banner.title": "Ativar notificações",
+	"banner.description": "Receba lembretes de atividades, mensagens e avisos importantes diretamente no seu navegador.",
+	"banner.allow": "Permitir notificações",
+	"banner.dismiss": "Agora não",
+	"banner.activeTitle": "Notificações ativas",
+	"banner.activeDescription": "Você está recebendo notificações neste navegador.",
+	"banner.disable": "Desativar notificações",
+	"banner.disabling": "Desativando…",
+	"banner.deniedTitle": "Notificações bloqueadas",
+	"banner.deniedDescription": "As notificações estão bloqueadas no navegador. Para receber alertas, permita nas configurações do site."
 };
 
 /**
@@ -159,6 +170,45 @@ type NotificationProviderProps = {
 };
 declare function NotificationProvider({ client, locale, messageOverrides, theme, pollIntervalSeconds, children, }: NotificationProviderProps): react.JSX.Element;
 declare function useNotificationContext(): NotificationContextValue;
+declare function useOptionalNotificationContext(): NotificationContextValue | null;
+
+/**
+ * Copyright (c) 2026 Ada Technology. MIT License.
+ *
+ * Hook headless para gerenciar permissão e ciclo de vida de Web Push no navegador.
+ * Isomórfico: seguro em SSR/Node/Bun sem quebrar quando `window` ou `Notification` não existem.
+ */
+
+type NotificationPermissionStatus = 'default' | 'granted' | 'denied' | 'unsupported';
+type UseNotificationPermissionOptions = {
+    /** Chave pública VAPID necessária para inscrição Web Push. Se omitida, tenta buscar via client.getVapidPublicKey(). */
+    readonly vapidPublicKey?: string;
+    /** Chave do localStorage para guardar a dispensa temporária do banner. Padrão: 'adatechnology:notification:permission-dismissed' */
+    readonly storageKey?: string;
+    /** Validade da dispensa em ms (padrão: 7 dias). 0 para permanente. */
+    readonly dismissTtlMs?: number;
+    /** Chave do localStorage onde o id do dispositivo registrado é salvo. Padrão: 'adatechnology:notification:device-id' */
+    readonly deviceStorageKey?: string;
+    /** Callback executado após inscrição bem-sucedida. */
+    readonly onSubscribe?: (subscription: WebPushSubscription) => Promise<void> | void;
+    /** Callback executado após cancelamento/desativação. */
+    readonly onUnsubscribe?: () => Promise<void> | void;
+    /** ServiceWorkerRegistration específico (opcional, senão aguarda navigator.serviceWorker.ready). */
+    readonly serviceWorkerRegistration?: ServiceWorkerRegistration;
+};
+type UseNotificationPermissionResult = {
+    readonly permission: NotificationPermissionStatus;
+    readonly isSupported: boolean;
+    readonly isSubscribed: boolean;
+    readonly isDismissed: boolean;
+    readonly isPending: boolean;
+    readonly error: Error | null;
+    readonly requestPermission: () => Promise<boolean>;
+    readonly disableNotifications: () => Promise<boolean>;
+    readonly dismiss: () => void;
+    readonly resetDismissed: () => void;
+};
+declare function useNotificationPermission(options?: UseNotificationPermissionOptions): UseNotificationPermissionResult;
 
 type UseNotificationsOptions = {
     readonly category?: string;
@@ -485,4 +535,4 @@ type UseTemplateEditorResult = {
 };
 declare function useTemplateEditor(params?: UseTemplateEditorParams): UseTemplateEditorResult;
 
-export { useDeleteNotification as A, useMarkAllAsRead as B, useMarkAsRead as C, DEFAULT_LOCALE as D, useNotificationContext as E, useNotificationStream as F, useNotifications as G, usePreferences as H, useRestoreTemplateDefault as I, useTemplateEditor as J, useTemplateVariables as K, useTemplates as L, useUnreadCount as M, NOTIFICATION_QUERY_KEYS as N, useUpdatePreferences as O, useUpsertTemplate as P, SORT_DIRECTIONS as S, TEMPLATE_COLUMNS as T, type UseCategoryPoliciesResult as U, type NotificationContextValue as a, type NotificationLocale as b, type NotificationMessages as c, NotificationProvider as d, type NotificationProviderProps as e, type NotificationTheme as f, type SortDirection as g, TEMPLATE_SORT_FIELDS as h, TEMPLATE_VIEWS as i, type TemplateColumn as j, type TemplateDraft as k, type TemplateDraftField as l, type TemplatePreviewFrame as m, type TemplateSort as n, type TemplateSortField as o, type TemplateView as p, type UseNotificationStreamOptions as q, type UseNotificationsOptions as r, type UseTemplateEditorParams as s, type UseTemplateEditorResult as t, flattenNotificationPages as u, formatNotificationTime as v, formatNotificationTimestamp as w, resolveMessages as x, useCategoryPolicies as y, useDeactivateTemplate as z };
+export { resolveMessages as A, useCategoryPolicies as B, useDeactivateTemplate as C, DEFAULT_LOCALE as D, useDeleteNotification as E, useMarkAllAsRead as F, useMarkAsRead as G, useNotificationContext as H, useNotificationPermission as I, useNotificationStream as J, useNotifications as K, useOptionalNotificationContext as L, usePreferences as M, NOTIFICATION_QUERY_KEYS as N, useRestoreTemplateDefault as O, useTemplateEditor as P, useTemplateVariables as Q, useTemplates as R, SORT_DIRECTIONS as S, TEMPLATE_COLUMNS as T, type UseCategoryPoliciesResult as U, useUnreadCount as V, useUpdatePreferences as W, useUpsertTemplate as X, type NotificationContextValue as a, type NotificationLocale as b, type NotificationMessages as c, type NotificationPermissionStatus as d, NotificationProvider as e, type NotificationProviderProps as f, type NotificationTheme as g, type SortDirection as h, TEMPLATE_SORT_FIELDS as i, TEMPLATE_VIEWS as j, type TemplateColumn as k, type TemplateDraft as l, type TemplateDraftField as m, type TemplatePreviewFrame as n, type TemplateSort as o, type TemplateSortField as p, type TemplateView as q, type UseNotificationPermissionOptions as r, type UseNotificationPermissionResult as s, type UseNotificationStreamOptions as t, type UseNotificationsOptions as u, type UseTemplateEditorParams as v, type UseTemplateEditorResult as w, flattenNotificationPages as x, formatNotificationTime as y, formatNotificationTimestamp as z };

package/dist/headless.d.ts

@@ -1,5 +1,5 @@
-export { D as DEFAULT_LOCALE, N as NOTIFICATION_QUERY_KEYS, a as NotificationContextValue, b as NotificationLocale, c as NotificationMessages, d as NotificationProvider, e as NotificationProviderProps, f as NotificationTheme, k as TemplateDraft, l as TemplateDraftField, m as TemplatePreviewFrame, U as UseCategoryPoliciesResult, q as UseNotificationStreamOptions, r as UseNotificationsOptions, s as UseTemplateEditorParams, t as UseTemplateEditorResult, u as flattenNotificationPages, v as formatNotificationTime, w as formatNotificationTimestamp, x as resolveMessages, y as useCategoryPolicies, z as useDeactivateTemplate, A as useDeleteNotification, B as useMarkAllAsRead, C as useMarkAsRead, E as useNotificationContext, F as useNotificationStream, G as useNotifications, H as usePreferences, I as useRestoreTemplateDefault, J as useTemplateEditor, K as useTemplateVariables, L as useTemplates, M as useUnreadCount, O as useUpdatePreferences, P as useUpsertTemplate } from './headless-03_gfBEI.js';
+export { D as DEFAULT_LOCALE, N as NOTIFICATION_QUERY_KEYS, a as NotificationContextValue, b as NotificationLocale, c as NotificationMessages, d as NotificationPermissionStatus, e as NotificationProvider, f as NotificationProviderProps, g as NotificationTheme, l as TemplateDraft, m as TemplateDraftField, n as TemplatePreviewFrame, U as UseCategoryPoliciesResult, r as UseNotificationPermissionOptions, s as UseNotificationPermissionResult, t as UseNotificationStreamOptions, u as UseNotificationsOptions, v as UseTemplateEditorParams, w as UseTemplateEditorResult, x as flattenNotificationPages, y as formatNotificationTime, z as formatNotificationTimestamp, A as resolveMessages, B as useCategoryPolicies, C as useDeactivateTemplate, E as useDeleteNotification, F as useMarkAllAsRead, G as useMarkAsRead, H as useNotificationContext, I as useNotificationPermission, J as useNotificationStream, K as useNotifications, L as useOptionalNotificationContext, M as usePreferences, O as useRestoreTemplateDefault, P as useTemplateEditor, Q as useTemplateVariables, R as useTemplates, V as useUnreadCount, W as useUpdatePreferences, X as useUpsertTemplate } from './headless--Os4o240.js';
 import 'react';
 import '@adatechnology/notification-client';
-import '@tanstack/react-query';
 import '@adatechnology/notification-contracts';
+import '@tanstack/react-query';

package/dist/headless.js

@@ -12,8 +12,10 @@ import {
   useMarkAllAsRead,
   useMarkAsRead,
   useNotificationContext,
+  useNotificationPermission,
   useNotificationStream,
   useNotifications,
+  useOptionalNotificationContext,
   usePreferences,
   useRestoreTemplateDefault,
   useTemplateEditor,
@@ -22,7 +24,7 @@ import {
   useUnreadCount,
   useUpdatePreferences,
   useUpsertTemplate
-} from "./chunk-SFMOFCHV.js";
+} from "./chunk-7A6A4MNA.js";
 export {
   DEFAULT_LOCALE,
   NOTIFICATION_QUERY_KEYS,
@@ -37,8 +39,10 @@ export {
   useMarkAllAsRead,
   useMarkAsRead,
   useNotificationContext,
+  useNotificationPermission,
   useNotificationStream,
   useNotifications,
+  useOptionalNotificationContext,
   usePreferences,
   useRestoreTemplateDefault,
   useTemplateEditor,

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-export { D as DEFAULT_LOCALE, N as NOTIFICATION_QUERY_KEYS, a as NotificationContextValue, b as NotificationLocale, c as NotificationMessages, d as NotificationProvider, e as NotificationProviderProps, f as NotificationTheme, S as SORT_DIRECTIONS, g as SortDirection, T as TEMPLATE_COLUMNS, h as TEMPLATE_SORT_FIELDS, i as TEMPLATE_VIEWS, j as TemplateColumn, k as TemplateDraft, l as TemplateDraftField, m as TemplatePreviewFrame, n as TemplateSort, o as TemplateSortField, p as TemplateView, U as UseCategoryPoliciesResult, q as UseNotificationStreamOptions, r as UseNotificationsOptions, s as UseTemplateEditorParams, t as UseTemplateEditorResult, u as flattenNotificationPages, v as formatNotificationTime, w as formatNotificationTimestamp, x as resolveMessages, y as useCategoryPolicies, z as useDeactivateTemplate, A as useDeleteNotification, B as useMarkAllAsRead, C as useMarkAsRead, E as useNotificationContext, F as useNotificationStream, G as useNotifications, H as usePreferences, I as useRestoreTemplateDefault, J as useTemplateEditor, K as useTemplateVariables, L as useTemplates, M as useUnreadCount, O as useUpdatePreferences, P as useUpsertTemplate } from './headless-03_gfBEI.js';
+export { D as DEFAULT_LOCALE, N as NOTIFICATION_QUERY_KEYS, a as NotificationContextValue, b as NotificationLocale, c as NotificationMessages, d as NotificationPermissionStatus, e as NotificationProvider, f as NotificationProviderProps, g as NotificationTheme, S as SORT_DIRECTIONS, h as SortDirection, T as TEMPLATE_COLUMNS, i as TEMPLATE_SORT_FIELDS, j as TEMPLATE_VIEWS, k as TemplateColumn, l as TemplateDraft, m as TemplateDraftField, n as TemplatePreviewFrame, o as TemplateSort, p as TemplateSortField, q as TemplateView, U as UseCategoryPoliciesResult, r as UseNotificationPermissionOptions, s as UseNotificationPermissionResult, t as UseNotificationStreamOptions, u as UseNotificationsOptions, v as UseTemplateEditorParams, w as UseTemplateEditorResult, x as flattenNotificationPages, y as formatNotificationTime, z as formatNotificationTimestamp, A as resolveMessages, B as useCategoryPolicies, C as useDeactivateTemplate, E as useDeleteNotification, F as useMarkAllAsRead, G as useMarkAsRead, H as useNotificationContext, I as useNotificationPermission, J as useNotificationStream, K as useNotifications, L as useOptionalNotificationContext, M as usePreferences, O as useRestoreTemplateDefault, P as useTemplateEditor, Q as useTemplateVariables, R as useTemplates, V as useUnreadCount, W as useUpdatePreferences, X as useUpsertTemplate } from './headless--Os4o240.js';
 import * as react from 'react';
-import { ReactNode } from 'react';
-import { NotificationSummary, NotificationTemplate, RenderedTemplatePreview } from '@adatechnology/notification-contracts';
+import react__default, { ReactNode } from 'react';
+import { NotificationSummary, WebPushSubscription, NotificationTemplate, RenderedTemplatePreview } from '@adatechnology/notification-contracts';
 import '@adatechnology/notification-client';
 import '@tanstack/react-query';
 
@@ -47,6 +47,32 @@ type PreferencesPanelProps = {
 };
 declare function PreferencesPanel({ className }: PreferencesPanelProps): react.JSX.Element;
 
+/**
+ * Copyright (c) 2026 Ada Technology. MIT License.
+ *
+ * Componente acessível de aviso para permitir ou desativar notificações do navegador (Web Push).
+ */
+
+type NotificationPermissionBannerProps = {
+    /** Chave pública VAPID para registro do Web Push. */
+    readonly vapidPublicKey?: string;
+    /** Chave do localStorage para persistir a dispensa do banner. */
+    readonly storageKey?: string;
+    /** Mostra o banner quando as notificações já estão ativas (permite desativação). Padrão: false */
+    readonly showWhenGranted?: boolean;
+    /** Mostra o banner informativo quando as notificações foram bloqueadas no navegador. Padrão: true */
+    readonly showWhenDenied?: boolean;
+    /** Callback opcional ao se inscrever com sucesso. */
+    readonly onSubscribe?: (subscription: WebPushSubscription) => void | Promise<void>;
+    /** Callback opcional ao desativar notificações. */
+    readonly onUnsubscribe?: () => void | Promise<void>;
+    /** Callback disparado quando o usuário clica em dispensar/fechar. */
+    readonly onDismiss?: () => void;
+    /** Classe CSS customizada para o contêiner raiz. */
+    readonly className?: string;
+};
+declare function NotificationPermissionBanner({ vapidPublicKey, storageKey, showWhenGranted, showWhenDenied, onSubscribe, onUnsubscribe, onDismiss, className, }: NotificationPermissionBannerProps): react__default.JSX.Element | null;
+
 type NotificationsWorkspaceProps = {
     /** Sobrescreve textos pontuais sem trocar o locale inteiro. */
     readonly labels?: Partial<Record<string, string>>;
@@ -359,4 +385,4 @@ declare function insertAt({ text, insertion, selectionStart, selectionEnd, }: {
     readonly selectionEnd: number;
 }): ApplyMarkResult;
 
-export { HTML_TOKEN, HtmlCodeField, type HtmlCodeFieldProblem, type HtmlCodeFieldProps, type HtmlToken, type HtmlTokenKind, MESSAGE_EMOJI, MESSAGE_FORMAT, MESSAGE_FORMAT_MARKS, MessageBodyField, type MessageBodyFieldProps, type MessageFormat, type MessageFormatMark, MessageToolbar, type MessageToolbarProps, NotificationBell, type NotificationBellProps, type NotificationCategoryOption, type NotificationChannelOption, NotificationItem, type NotificationItemProps, NotificationList, type NotificationListProps, NotificationSettingsWorkspace, type NotificationSettingsWorkspaceProps, NotificationsWorkspace, type NotificationsWorkspaceProps, PreferencesPanel, type PreferencesPanelProps, type PreviewAttachment, type PreviewLabels, TemplatePreview, type TemplatePreviewProps, applyMark, insertAt, tokenizeHtml };
+export { HTML_TOKEN, HtmlCodeField, type HtmlCodeFieldProblem, type HtmlCodeFieldProps, type HtmlToken, type HtmlTokenKind, MESSAGE_EMOJI, MESSAGE_FORMAT, MESSAGE_FORMAT_MARKS, MessageBodyField, type MessageBodyFieldProps, type MessageFormat, type MessageFormatMark, MessageToolbar, type MessageToolbarProps, NotificationBell, type NotificationBellProps, type NotificationCategoryOption, type NotificationChannelOption, NotificationItem, type NotificationItemProps, NotificationList, type NotificationListProps, NotificationPermissionBanner, type NotificationPermissionBannerProps, NotificationSettingsWorkspace, type NotificationSettingsWorkspaceProps, NotificationsWorkspace, type NotificationsWorkspaceProps, PreferencesPanel, type PreferencesPanelProps, type PreviewAttachment, type PreviewLabels, TemplatePreview, type TemplatePreviewProps, applyMark, insertAt, tokenizeHtml };