\r\n );\r\n}\r\n```\r\n\r\n## Service Worker\r\n\r\nO pacote automaticamente copia o service worker (`sw.js`) para a pasta `public/` do seu projeto durante a instalação. Se você precisar usar um caminho customizado:\r\n\r\n```tsx\r\nconst { subscription } = usePush({\r\n apiKey: \"sua-chave-publica-vapid\",\r\n serviceWorkerPath: \"/custom-path/sw.js\", // Caminho customizado\r\n});\r\n```\r\n\r\n## API\r\n\r\n### `usePush(options)`\r\n\r\nHook principal para gerenciar notificações push.\r\n\r\n#### Parâmetros\r\n\r\n- `apiKey` (string, obrigatório): Chave pública VAPID para autenticação\r\n- `serviceWorkerPath` (string, opcional): Caminho customizado para o service worker. Padrão: `/sw.js`\r\n\r\n#### Retorno\r\n\r\n- `isSupported` (boolean): Indica se o navegador suporta notificações push\r\n- `isChecking` (boolean): Indica se está verificando o suporte\r\n- `error` (string | null): Mensagem de erro, se houver\r\n- `subscription` (PushSubscription | null): Objeto de assinatura push\r\n- `requestPermission()`: Função para solicitar permissão de notificação\r\n- `subscribeToPush()`: Função para inscrever-se nas notificações push\r\n\r\n## Exemplo Completo\r\n\r\n```tsx\r\nimport { usePush } from \"@agenus-io/web-push\";\r\nimport { useEffect } from \"react\";\r\n\r\nfunction NotificationButton() {\r\n const {\r\n isSupported,\r\n isChecking,\r\n error,\r\n subscription,\r\n requestPermission,\r\n subscribeToPush,\r\n } = usePush({\r\n apiKey: process.env.NEXT_PUBLIC_VAPID_PUBLIC_KEY || \"\",\r\n });\r\n\r\n useEffect(() => {\r\n if (subscription) {\r\n // Enviar subscription para seu backend\r\n fetch(\"/api/subscribe\", {\r\n method: \"POST\",\r\n headers: { \"Content-Type\": \"application/json\" },\r\n body: JSON.stringify(subscription),\r\n });\r\n }\r\n }, [subscription]);\r\n\r\n if (isChecking) return
Carregando...
;\r\n if (!isSupported) return
Não suportado
;\r\n\r\n return (\r\n
\r\n {error &&
{error}
}\r\n {!subscription ? (\r\n \r\n ) : (\r\n
✓ Notificações ativadas
\r\n )}\r\n
\r\n );\r\n}\r\n```\r\n\r\n## Enviando Notificações\r\n\r\nPara enviar notificações push, você precisa de um servidor backend que use a chave privada VAPID. O service worker incluído no pacote suporta o seguinte formato de payload:\r\n\r\n```json\r\n{\r\n \"title\": \"Título da Notificação\",\r\n \"body\": \"Corpo da mensagem\",\r\n \"icon\": \"/icon.png\",\r\n \"badge\": \"/badge.png\",\r\n \"image\": \"/image.png\",\r\n \"url\": \"/redirect-url\",\r\n \"vibrate\": [200, 100, 200],\r\n \"actions\": [\r\n {\r\n \"action\": \"action1\",\r\n \"title\": \"Ação 1\",\r\n \"icon\": \"/action1-icon.png\",\r\n \"url\": \"/action1-url\"\r\n }\r\n ],\r\n \"data\": {\r\n \"custom\": \"data\"\r\n }\r\n}\r\n```\r\n\r\n## Desenvolvimento\r\n\r\n```bash\r\n# Instalar dependências\r\npnpm install\r\n\r\n# Build\r\npnpm build\r\n\r\n# Desenvolvimento com watch\r\npnpm dev\r\n\r\n# Lint\r\npnpm lint\r\n\r\n# Format\r\npnpm format\r\n```\r\n\r\n## Publicação\r\n\r\nEste projeto usa [Changesets](https://github.com/changesets/changesets) para gerenciar versões e changelogs.\r\n\r\n### Processo de Publicação\r\n\r\n1. **Criar um changeset** (após fazer suas mudanças):\r\n ```bash\r\n pnpm changeset\r\n ```\r\n Isso criará um arquivo em `.changeset/` descrevendo suas mudanças. Escolha o tipo de versão (patch, minor, major).\r\n\r\n2. **Commit e push**:\r\n ```bash\r\n git add .\r\n git commit -m \"feat: sua mudança\"\r\n git push\r\n ```\r\n\r\n3. **Publicar**:\r\n ```bash\r\n pnpm publish\r\n ```\r\n Ou use o script helper:\r\n ```bash\r\n node scripts/publish.js\r\n ```\r\n\r\n O script irá:\r\n - Verificar se você está logado no npm\r\n - Fazer build do projeto\r\n - Aplicar as versões do changeset\r\n - Publicar no npm\r\n\r\n### Scripts Disponíveis\r\n\r\n- `pnpm changeset` - Criar um novo changeset\r\n- `pnpm changeset:version` - Aplicar versões dos changesets\r\n- `pnpm changeset:publish` - Publicar no npm\r\n- `pnpm publish` - Script completo de publicação (recomendado)\r\n\r\n### Primeira Publicação\r\n\r\nAntes da primeira publicação, certifique-se de:\r\n\r\n1. Estar logado no npm com acesso à organização `@agenus-io`:\r\n ```bash\r\n npm login --scope=@agenus-io\r\n ```\r\n\r\n2. Ter configurado o registry correto no `.npmrc` (se necessário)\r\n\r\n**Nota**: O pacote é publicado como **público** automaticamente (não requer plano pago). O script já inclui `--access public`.\r\n\r\n## Licença\r\n\r\nISC\r\n\r\n","readmeFilename":"README.md"}