react-lgpd-consent 0.4.3 → 0.5.0

package/CHANGELOG.md

@@ -4,6 +4,99 @@ Todas as mudanças notáveis neste projeto serão documentadas neste arquivo.
 
 O formato é baseado em [Keep a Changelog](https://keepachangelog.com/pt-BR/1.0.0/), e este projeto segue [Semantic Versioning](https://semver.org/lang/pt-BR/).
 
+## [0.4.5] - 2025-10-25 — DataLayer Events e CI/CD
+
+### 📊 **DataLayer Events para Google Tag Manager**
+
+- **Eventos Padronizados**: Implementado contrato de eventos `consent_initialized` e `consent_updated` no `window.dataLayer`
+  - `consent_initialized`: Disparado após hidratação inicial do `ConsentProvider`
+  - `consent_updated`: Disparado quando usuário altera preferências via banner, modal ou API
+  - Payload inclui: `event`, `consent_version`, `timestamp` (ISO 8601), `categories`, `origin`, `changed_categories`
+  
+- **Rastreamento de Origem**: Campo `origin` identifica fonte da mudança de consentimento
+  - `'banner'`: Decisão feita no CookieBanner
+  - `'modal'`: Ajuste feito no PreferencesModal
+  - `'reset'`: Reset programático via API
+  - `'programmatic'`: Mudança via `setPreference()` ou `acceptAll()`
+
+- **API Pública**: Novas funções exportadas para uso customizado
+  - `pushConsentInitializedEvent(categories: ConsentPreferences)`
+  - `pushConsentUpdatedEvent(categories: ConsentPreferences, origin: ConsentEventOrigin, previousCategories?: ConsentPreferences)`
+  - Tipos: `ConsentEventOrigin`, `ConsentInitializedEvent`, `ConsentUpdatedEvent`, `ConsentEvent`
+
+- **Integração Automática**: Eventos disparados automaticamente pelo `ConsentContext`
+  - Ref `previousPreferencesRef` rastreia estado anterior para calcular `changed_categories`
+  - Logger integrado para debug de eventos em desenvolvimento
+  - SSR-safe: não quebra quando `window` é undefined
+
+- **Documentação GTM**: Seção completa adicionada em `INTEGRACOES.md`
+  - Schemas dos eventos com exemplos
+  - Passo a passo de configuração do Google Tag Manager
+  - Exemplos TypeScript de triggers e tags customizados
+  - Casos de uso: auditoria LGPD, análise de conversão, triggers condicionais
+
+### 🔧 **CI/CD e Build**
+
+- **Migração para pnpm**: Workflows atualizados de npm para pnpm
+  - `ci.yml`: Adicionado `pnpm/action-setup@v4`, substituído `npm ci` por `pnpm install --frozen-lockfile`
+  - `package-check.yml`: Migrado para pnpm
+  - `publish-github-packages.yml`: Migrado para pnpm
+  - `deploy-docs.yml`: Migrado para pnpm
+  - **Problema Resolvido**: Conflitos `ERESOLVE` com `@eslint/js` eliminados
+  - `.gitignore`: Adicionado `package-lock.json` para evitar conflitos
+
+- **Dependências**: Adicionado `@eslint/js@9.38.0` para resolver missing dependency error
+
+### 🧪 **Testes**
+
+- **dataLayerEvents.test.ts**: 10 novos testes cobrindo eventos dataLayer
+  - Push de eventos `consent_initialized` e `consent_updated`
+  - Cálculo correto de `changed_categories`
+  - Diferentes origens (banner, modal, reset, programmatic)
+  - Inicialização do dataLayer se não existir
+  - SSR-safety (não quebra quando window é undefined)
+  - Formato ISO 8601 de timestamps
+  - **Solução de Isolamento**: Testes usam estratégia de "pegar último evento" para evitar acúmulo entre testes
+
+### 📚 **Documentação**
+
+- **INTEGRACOES.md**: Nova seção "Eventos dataLayer (Google Tag Manager)" com 200+ linhas
+- **README.md**: Seção "Novidades v0.4.5" com resumo de features
+- **README.en.md**: Tradução da seção "What's New in v0.4.5"
+- **tsconfig.typedoc.json**: Corrigido para excluir `*.test.ts` (além de `*.test.tsx`)
+- **API Pública**: Exportações documentadas com TSDoc completo
+
+### 📦 **Build**
+
+- **Versão**: Bump de `0.4.4` → `0.4.5`
+- **Tamanho**: Build otimizado mantém tree-shaking e SSR-safety
+  - ESM: `dist/index.js` ~32.59 KB
+  - CJS: `dist/index.cjs` ~38.17 KB
+  - Types: `dist/index.d.ts` ~132.13 KB
+
+---
+
+## [0.4.4] - 2025-10-06 — Correções de CI/CD e Publicação
+
+### 🔧 **Correções de CI/CD**
+
+- **Workflow de Publicação npm**: Corrigido bug que impedia publicação mesmo quando tag estava na `main`
+  - **Problema**: `git fetch --depth=1` limitava histórico e falhava verificação de ancestralidade
+  - **Solução**: Removido `--depth=1` do fetch, aproveitando `fetch-depth: 0` do checkout
+  - **Impacto**: Tags criadas após merge para `main` agora são publicadas corretamente no npm
+
+### 📊 **Integração com Codecov**
+
+- **Upload de Coverage**: Adicionado `codecov/codecov-action@v5` ao workflow CI
+  - Envia relatórios de cobertura automaticamente para Codecov
+  - Token configurado via `secrets.CODECOV_TOKEN`
+  - Integração com badge de coverage no README
+
+### 📚 **Documentação**
+
+- **Badges**: Badge de coverage já configurado no README (v0.4.3) agora recebe dados em tempo real
+- **Workflows**: Documentação inline sobre fetch depth e verificação de ancestralidade
+
 ## [0.4.3] - 2025-10-06 — Otimizações de Performance e Qualidade
 
 ### 🚀 **Melhorias de Performance**

package/README.en.md

@@ -50,6 +50,21 @@ npm install react-lgpd-consent @mui/material @emotion/react @emotion/styled js-c
 
 ---
 
+## ✨ What's New in v0.4.5
+
+### 📊 DataLayer Events for Google Tag Manager
+- **Standardized Events**: `consent_initialized` and `consent_updated` automatically dispatched
+- **Origin Tracking**: Identifies whether decision came from banner, modal, reset, or programmatic API
+- **LGPD Audit**: Complete change history with `changed_categories` and ISO 8601 timestamps
+- **GTM Integration**: Full documentation with trigger and tag examples
+- **Public API**: Exported `pushConsentInitializedEvent` and `pushConsentUpdatedEvent` functions
+
+### 🔧 CI/CD Improvements
+- **Migration to pnpm**: Workflows updated from npm to pnpm, resolving dependency conflicts
+- **Optimized Build**: Faster and more reliable pipeline
+
+---
+
 ## 📖 Basic Usage
 
 Wrap your app with `ConsentProvider` (minimal example):

package/README.md

@@ -52,6 +52,34 @@ npm install react-lgpd-consent @mui/material @emotion/react @emotion/styled js-c
 
 ---
 
+## ✨ Novidades v0.4.5
+
+### 📊 DataLayer Events para Google Tag Manager
+- **Eventos Padronizados**: `consent_initialized` e `consent_updated` disparados automaticamente
+- **Rastreamento de Origem**: Identifica se decisão veio do banner, modal, reset ou API programática
+- **Auditoria LGPD**: Histórico completo de mudanças com `changed_categories` e timestamps ISO 8601
+- **Integração GTM**: Documentação completa com exemplos de triggers e tags
+- **API Pública**: Funções `pushConsentInitializedEvent` e `pushConsentUpdatedEvent` exportadas
+
+### 🔧 Melhorias de CI/CD
+- **Migração para pnpm**: Workflows atualizados de npm para pnpm, resolvendo conflitos de dependências
+- **Build Otimizado**: Pipeline mais rápido e confiável
+
+---
+
+## ✨ Novidades v0.4.4
+
+### 🔧 CI/CD e Publicação
+- **Workflow de Publicação**: Corrigido bug que impedia publicação automática no npm quando tags eram criadas após merge para `main`
+- **Codecov Integration**: Adicionado upload automático de coverage reports para melhor visualização de cobertura de testes
+- **Badge de Coverage**: Agora atualizado em tempo real via Codecov
+
+### 📊 Qualidade e Confiabilidade
+- **Publicação Confiável**: Tags agora são publicadas corretamente quando commit está no histórico da `main`
+- **Visibilidade de Cobertura**: Integração completa com Codecov para tracking de qualidade
+
+---
+
 ## ✨ Novidades v0.4.1
 
 ### 🎨 Design Tokens Expandidos

package/dist/core.cjs

@@ -0,0 +1,12 @@
+'use strict';
+
+var core = require('@react-lgpd-consent/core');
+
+
+
+Object.keys(core).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return core[k]; }
+	});
+});

package/dist/core.d.cts

@@ -0,0 +1,2 @@
+export * from '@react-lgpd-consent/core';
+import '@react-lgpd-consent/mui';

package/dist/core.d.ts

@@ -0,0 +1,2 @@
+export * from '@react-lgpd-consent/core';
+import '@react-lgpd-consent/mui';

package/dist/core.js

@@ -0,0 +1 @@
+export * from '@react-lgpd-consent/core';