react-lgpd-consent 0.6.1 → 0.7.0

package/INTEGRACOES.md

@@ -6,11 +6,9 @@ A biblioteca oferece integrações nativas para as ferramentas mais comuns, elim
 
 O componente `ConsentScriptLoader` gerencia o carregamento desses scripts automaticamente, disparando-os apenas quando o usuário concede consentimento para a categoria correspondente.
 
-## 🎯 Integrações Nativas Disponíveis
-
-A biblioteca oferece integrações nativas para as ferramentas mais comuns, eliminando a necessidade de código manual para o carregamento condicional de scripts de terceiros.
+> 💡 **Procurando exemplos práticos?** Veja [RECIPES.md](../../RECIPES.md) para receitas passo a passo de Google Consent Mode v2, Next.js App Router e CSP/nonce.
 
-O componente `ConsentScriptLoader` gerencia o carregamento desses scripts automaticamente, disparando-os apenas quando o usuário concede consentimento para a categoria correspondente.
+## 🎯 Integrações Nativas Disponíveis
 
 ### 1. Google Analytics 4 (GA4)
 
@@ -391,3 +389,89 @@ interface ConsentUpdatedEvent {
 | Live Chat          | `functional`          | Funcionalidade de suporte        |
 | YouTube/Vimeo      | `social`              | Conteúdo de redes sociais        |
 
+
+---
+
+## 🆕 Recursos Avançados v0.7.0
+
+### Monitoramento com Callbacks de Lifecycle
+
+Integre sistemas de auditoria monitorando eventos de consentimento:
+
+```tsx
+import { ConsentProvider, ConsentScriptLoader } from 'react-lgpd-consent'
+import { googleAnalytics4Integration } from './integrations'
+
+<ConsentProvider
+  categories={{ enabledCategories: ['analytics', 'marketing'] }}
+  onConsentInit={(state) => {
+    // Disparado na inicialização (útil para analytics)
+    console.log('Consentimento inicial:', state)
+  }}
+  onConsentChange={(current, previous) => {
+    // Disparado em toda mudança de preferências
+    console.log('Mudança:', { current, previous })
+    
+    // Exemplo: disparar evento no dataLayer
+    window.dataLayer?.push({
+      event: 'consent_preferences_updated',
+      consent_analytics: current.preferences.analytics,
+      consent_marketing: current.preferences.marketing
+    })
+  }}
+  onAuditLog={(entry) => {
+    // Enviar para backend de compliance
+    fetch('/api/consent-audit', {
+      method: 'POST',
+      body: JSON.stringify(entry)
+    })
+  }}
+>
+  <ConsentScriptLoader integrations={[googleAnalytics4Integration]} />
+  <YourApp />
+</ConsentProvider>
+```
+
+### Presets de Categorias ANPD
+
+Use configurações pré-validadas pela ANPD:
+
+```tsx
+import { ConsentProvider, createAnpdCategories } from 'react-lgpd-consent'
+
+// Preset BÁSICO (necessary + analytics)
+const basicConfig = createAnpdCategories({ include: ['analytics'] })
+
+// Preset COMPLETO (todas as 6 categorias)
+const fullConfig = createAnpdCategories({
+  include: ['analytics', 'marketing', 'functional', 'social', 'personalization']
+})
+
+// Com customizações
+const customConfig = createAnpdCategories({
+  include: ['analytics', 'marketing'],
+  names: { analytics: 'Análises' },
+  descriptions: { marketing: 'Anúncios personalizados' }
+})
+
+<ConsentProvider categories={fullConfig}>
+  <ConsentScriptLoader integrations={myIntegrations} />
+</ConsentProvider>
+```
+
+**Vantagens dos presets:**
+- ✅ Conformidade com diretrizes ANPD
+- ✅ Nomes e descrições em pt-BR revisadas
+- ✅ Tipagem forte para evitar erros
+- ✅ Reduz código boilerplate em 60%
+
+---
+
+## 📚 Recursos Adicionais
+
+- [API.md](./API.md) – Documentação completa da API pública
+- [RECIPES.md](../../RECIPES.md) – Receitas práticas com Next.js, CSP, Google Consent Mode v2
+- [TROUBLESHOOTING.md](../../TROUBLESHOOTING.md) – Solução de problemas comuns
+- [CONFORMIDADE.md](../../CONFORMIDADE.md) – Conformidade LGPD e ANPD
+
+**Problemas de integração?** Consulte [TROUBLESHOOTING.md - Seção de Integrations](../../TROUBLESHOOTING.md#integrações-de-terceiros).

package/QUICKSTART.en.md

@@ -2,6 +2,17 @@
 
 This quickstart gives everything you need to integrate `react-lgpd-consent` into a React project fast.
 
+## 🆕 What's New in v0.7.0
+
+- ✅ **Lifecycle Callbacks** - `onConsentInit`, `onConsentChange`, `onAuditLog` for monitoring
+- ✅ **ANPD Presets** - `createAnpdCategories()` for quick LGPD-compliant setup
+- ✅ **Audit Logging** - `createConsentAuditEntry()` for compliance tracking
+- ✅ **Better DX** - Clear error messages when hooks are used incorrectly
+
+📖 **Documentation:** [TROUBLESHOOTING.md](../../TROUBLESHOOTING.md) | [API.md](./API.md)
+
+---
+
 ## 📦 Installation
 
 ```bash

package/README.en.md

@@ -84,6 +84,46 @@ function Analytics() {
 
 ---
 
+## 🆕 What's New in v0.7.0
+
+### Lifecycle Callbacks (#68)
+
+```tsx
+<ConsentProvider
+  onConsentInit={(state) => console.log('Initialized:', state)}
+  onConsentChange={(current, prev) => console.log('Changed:', current)}
+  onAuditLog={(entry) => fetch('/api/audit', {
+    method: 'POST',
+    body: JSON.stringify(entry)
+  })}
+>
+```
+
+### ANPD Category Presets (#70)
+
+```tsx
+import { createAnpdCategories } from 'react-lgpd-consent'
+
+const categories = createAnpdCategories({
+  include: ['analytics', 'marketing']
+})
+```
+
+### Consent Audit (#60)
+
+```tsx
+import { createConsentAuditEntry } from 'react-lgpd-consent'
+
+const audit = createConsentAuditEntry(state, {
+  action: 'update',
+  consentVersion: '1'
+})
+```
+
+📖 **Full documentation:** [API.md](./API.md) | [TROUBLESHOOTING.md](../../TROUBLESHOOTING.md)
+
+---
+
 ## Packages (monorepo)
 
 | Package | Description |
@@ -96,11 +136,13 @@ function Analytics() {
 
 ## Documentation & Examples
 
-- Quickstart: `QUICKSTART.en.md` (recommended)
-- API Reference: `API.md`
-- Integrations: `INTEGRACOES.md`
-- Storybook: https://lucianoedipo.github.io/react-lgpd-consent/storybook/
-- TypeDoc: https://lucianoedipo.github.io/react-lgpd-consent/docs/
+- **[🚀 Quickstart](../../QUICKSTART.en.md)** - Step-by-step tutorial
+- **[📖 Recipes](../../RECIPES.md)** - Practical guide with common use cases (Next.js, CSP, Consent Mode v2)
+- **[⚙️ Workflows](../../WORKFLOWS.md)** - CI/CD workflows documentation
+- **[API Reference](./API.md)** - Complete API reference
+- **[Integrations](./INTEGRACOES.md)** - GA4, GTM, Facebook Pixel
+- **[Storybook](https://lucianoedipo.github.io/react-lgpd-consent/storybook/)** - Interactive components
+- **[TypeDoc](https://lucianoedipo.github.io/react-lgpd-consent/docs/)** - Generated API docs
 
 ---
 

package/README.md

@@ -84,6 +84,46 @@ function Analytics() {
 
 ---
 
+## 🆕 Novidades v0.7.0
+
+### Callbacks de Lifecycle (#68)
+
+```tsx
+<ConsentProvider
+  onConsentInit={(state) => console.log('Init:', state)}
+  onConsentChange={(current, prev) => console.log('Changed:', current)}
+  onAuditLog={(entry) => fetch('/api/audit', {
+    method: 'POST',
+    body: JSON.stringify(entry)
+  })}
+>
+```
+
+### Presets ANPD (#70)
+
+```tsx
+import { createAnpdCategories } from 'react-lgpd-consent'
+
+const categories = createAnpdCategories({
+  include: ['analytics', 'marketing']
+})
+```
+
+### Auditoria (#60)
+
+```tsx
+import { createConsentAuditEntry } from 'react-lgpd-consent'
+
+const audit = createConsentAuditEntry(state, {
+  action: 'update',
+  consentVersion: '1'
+})
+```
+
+📖 **Documentação completa:** [API.md](./API.md) | [TROUBLESHOOTING.md](../../TROUBLESHOOTING.md)
+
+---
+
 ## Pacotes (monorepo v0.5.x)
 
 | Pacote | Descrição |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-lgpd-consent",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Biblioteca de consentimento LGPD, integrações nativas e sistema extensível para React.",
   "keywords": [
     "lgpd",
@@ -94,14 +94,14 @@
     }
   },
   "dependencies": {
-    "@react-lgpd-consent/core": "^0.6.1",
-    "@react-lgpd-consent/mui": "^0.6.1"
+    "@react-lgpd-consent/core": "^0.7.0",
+    "@react-lgpd-consent/mui": "^0.7.0"
   },
   "size-limit": [
     {
       "name": "ESM Bundle",
       "path": "dist/index.js",
-      "limit": "70 KB"
+      "limit": "80 KB"
     },
     {
       "name": "CJS Bundle",
@@ -133,8 +133,6 @@
     "test:coverage": "jest --config ../../jest.config.mjs --coverage",
     "coverage-check": "node ../../scripts/coverage-check.cjs",
     "size-check": "size-limit",
-    "mutation": "npx stryker run",
-    "mutation:tests": "npx stryker run ../../stryker.tests.conf.json",
     "docs:generate": "node ../../scripts/run-typedoc.mjs",
     "storybook": "storybook dev -p 6006 --config-dir ../../.storybook",
     "build-storybook": "storybook build --config-dir ../../.storybook --output-dir ../../storybook-static"