react-lgpd-consent 0.3.0 → 0.3.2

package/dist/index.js

@@ -1,15 +1,26 @@
 import {
   ConsentProvider,
+  CookieBanner,
   DEFAULT_PROJECT_CATEGORIES,
+  FloatingPreferencesButton,
+  LogLevel,
   PreferencesModal,
   analyzeDeveloperConfiguration,
+  createProjectPreferences,
   defaultConsentTheme,
+  defaultTexts,
+  getAllProjectCategories,
+  logger,
+  openPreferencesModal,
+  setDebugLogging,
   useCategories,
   useCategoryStatus,
   useConsent,
   useConsentHydration,
-  useConsentTexts
-} from "./chunk-R3IKVZBC.js";
+  useConsentTexts,
+  useOpenPreferencesModal,
+  validateProjectPreferences
+} from "./chunk-JUZQJHQW.js";
 
 // src/utils/ConsentGate.tsx
 import { Fragment, jsx } from "react/jsx-runtime";
@@ -83,7 +94,7 @@ function ConsentScriptLoader({
           }
           loadedScripts.current.add(integration.id);
         } catch (error) {
-          console.error(`\u274C Failed to load script: ${integration.id}`, error);
+          logger.error(`\u274C Failed to load script: ${integration.id}`, error);
         }
       }
     });
@@ -95,14 +106,12 @@ function useConsentScriptLoader() {
   return React.useCallback(
     async (integration) => {
       if (!consented) {
-        console.warn(
-          `\u26A0\uFE0F Cannot load script ${integration.id}: No consent given`
-        );
+        logger.warn(`\u26A0\uFE0F Cannot load script ${integration.id}: No consent given`);
         return false;
       }
       const shouldLoad = preferences[integration.category];
       if (!shouldLoad) {
-        console.warn(
+        logger.warn(
           `\u26A0\uFE0F Cannot load script ${integration.id}: Category '${integration.category}' not consented`
         );
         return false;
@@ -120,7 +129,7 @@ function useConsentScriptLoader() {
         }
         return true;
       } catch (error) {
-        console.error(`\u274C Failed to load script: ${integration.id}`, error);
+        logger.error(`\u274C Failed to load script: ${integration.id}`, error);
         return false;
       }
     },
@@ -170,8 +179,7 @@ function createUserWayIntegration(config) {
   return {
     id: "userway",
     category: "functional",
-    // Categoria mais apropriada para acessibilidade
-    src: `https://cdn.userway.org/widget.js`,
+    src: "https://cdn.userway.org/widget.js",
     init: () => {
       if (typeof window !== "undefined") {
         window.UserWayWidgetApp = window.UserWayWidgetApp || {};
@@ -191,18 +199,28 @@ export {
   ConsentGate,
   ConsentProvider,
   ConsentScriptLoader,
+  CookieBanner,
   DEFAULT_PROJECT_CATEGORIES,
+  FloatingPreferencesButton,
+  LogLevel,
   PreferencesModal,
   analyzeDeveloperConfiguration,
   createGoogleAnalyticsIntegration,
   createGoogleTagManagerIntegration,
+  createProjectPreferences,
   createUserWayIntegration,
   defaultConsentTheme,
+  defaultTexts,
+  getAllProjectCategories,
   loadScript,
+  openPreferencesModal,
+  setDebugLogging,
   useCategories,
   useCategoryStatus,
   useConsent,
   useConsentHydration,
   useConsentScriptLoader,
-  useConsentTexts
+  useConsentTexts,
+  useOpenPreferencesModal,
+  validateProjectPreferences
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-lgpd-consent",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Biblioteca completa de consentimento LGPD com 6 categorias ANPD, integrações nativas e sistema extensível para React.",
   "keywords": [
     "lgpd",
@@ -33,7 +33,7 @@
   "license": "MIT",
   "type": "module",
   "main": "dist/index.cjs",
-  "module": "dist/index.mjs",
+  "module": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
@@ -48,21 +48,22 @@
     "dist",
     "README.md",
     "LICENSE",
-    "COMPLIANCE.md"
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=18.18"
   },
-  "packageManager": "pnpm@9.0.0",
+  "packageManager": "npm@10.0.0",
   "scripts": {
-    "clean": "rimraf dist",
+    "clean": "rimraf node_modules package-lock.json dist",
     "build": "cross-env NODE_ENV=production tsup src/index.ts --format esm,cjs --dts --clean",
     "dev": "cross-env NODE_ENV=development tsup src/index.ts --format esm,cjs --dts --watch",
     "lint": "eslint . --ext .ts,.tsx",
     "format": "prettier --write \"src/**/*.{ts,tsx,json,md}\" \"eslint.config.js\"",
     "type-check": "tsc --noEmit",
-    "test": "jest",
-    "prepublishOnly": "npm run build"
+    "test": "jest --config jest.config.ts",
+    "prepublishOnly": "npm run build",
+    "docs:generate": "typedoc --out docs"
   },
   "repository": {
     "type": "git",
@@ -92,12 +93,14 @@
     "@eslint/compat": "^1.3.2",
     "@mui/icons-material": "^7.3.1",
     "@mui/material": "^7.3.1",
-    "@testing-library/jest-dom": "^6.6.4",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/jest-dom": "^6.7.0",
     "@testing-library/react": "^16.3.0",
     "@testing-library/user-event": "^14.6.1",
-    "@types/jest": "^30.0.0",
+    "@types/jest": "^29.5.14",
     "@types/js-cookie": "^3.0.6",
-    "@types/react": "^19.1.9",
+    "@types/node": "^24.2.1",
+    "@types/react": "^19.1.10",
     "@types/react-dom": "^19.1.7",
     "@typescript-eslint/eslint-plugin": "^8.39.1",
     "@typescript-eslint/parser": "^8.39.1",
@@ -106,14 +109,16 @@
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-jest": "^29.0.1",
     "eslint-plugin-react-hooks": "^5.2.0",
-    "jest": "^30.0.5",
-    "jest-environment-jsdom": "^30.0.5",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
     "prettier": "^3.6.2",
     "react": "^19.1.1",
     "react-dom": "^19.1.1",
     "rimraf": "^6.0.1",
     "ts-jest": "^29.4.1",
+    "ts-node": "^10.9.2",
     "tsup": "^8.5.0",
+    "typedoc": "^0.28.10",
     "typescript": "^5.9.2",
     "typescript-eslint": "^8.39.1"
   }

package/COMPLIANCE.md

@@ -1,107 +0,0 @@
-# Guia de Conformidade e Funcionalidades - react-lgpd-consent v0.3.0
-
-## 📜 Objetivo
-
-Este documento descreve as medidas de conformidade da biblioteca **react-lgpd-consent** com a Lei Geral de Proteção de Dados (LGPD) e o Guia Orientativo da ANPD, além de detalhar as ferramentas que auxiliam os desenvolvedores a manter essa conformidade.
-
-## ✅ Conformidade com a LGPD
-
-A biblioteca implementa os seguintes princípios e requisitos da LGPD:
-
-- **Consentimento Granular**: O usuário tem controle sobre cada categoria de cookie não essencial.
-- **Minimização de Dados**: Apenas as categorias de cookies ativas no projeto são armazenadas no cookie de consentimento.
-- **Transparência**: O cookie de consentimento armazena metadados de auditoria, como data, versão e origem da decisão.
-- **Facilidade de Revogação**: O usuário pode alterar suas preferências a qualquer momento através do modal.
-- **Segurança**: O cookie é configurado com `SameSite=Lax` e `secure=true` (em HTTPS) por padrão.
-
-## 🧠 Sistema de Orientações para Desenvolvedores
-
-A biblioteca inclui um sistema inteligente que **orienta os desenvolvedores sobre a configuração adequada**, garantindo que a implementação final esteja em conformidade com a LGPD.
-
-### Console de Desenvolvimento
-
-Em ambiente de desenvolvimento, a biblioteca exibe automaticamente no console:
-
-- **⚠️ Avisos**: Sobre configurações ausentes ou inconsistentes.
-- **💡 Sugestões**: Recomendações para melhorar a conformidade e a experiência do usuário.
-- **🔧 Tabela de Categorias Ativas**: Uma lista clara de quais categorias estão em uso, para auxiliar na construção de UIs customizadas.
-
-```
-[🍪 LGPD-CONSENT] ⚠️  Avisos de Configuração
-  [🍪 LGPD-CONSENT] Nenhuma configuração de categorias especificada. Usando padrão: necessary + analytics.
-
-[🍪 LGPD-CONSENT] 🔧 Categorias Ativas (para UI customizada)
-┌─────────────┬──────────────────────┬─────────────┬─────────────┐
-│     ID      │         Nome         │ Toggle UI?  │ Essencial?  │
-├─────────────┼──────────────────────┼─────────────┼─────────────┤
-│ necessary   │ Cookies Necessários  │ ❌ NÃO      │ 🔒 SIM      │
-│ analytics   │ Cookies Analíticos   │ ✅ SIM      │ ⚙️ NÃO      │
-└─────────────┴──────────────────────┴─────────────┴─────────────┘
-```
-
-**Para desabilitar estas mensagens**, use a prop `disableDeveloperGuidance={true}` no `ConsentProvider`.
-
-### Configuração Consciente
-
-Para evitar avisos e garantir a conformidade, especifique explicitamente as categorias de cookies que seu projeto utiliza através da prop `categories`:
-
-```tsx
-<ConsentProvider
-  categories={{
-    // Habilita apenas as categorias padrão que você realmente usa
-    enabledCategories: ['analytics'],
-  }}
->
-  <App />
-</ConsentProvider>
-```
-
-### Hooks de Validação
-
-Para construir componentes de UI customizados que reagem à configuração, utilize os hooks:
-
-- `useCategories()`: Fornece uma lista completa das categorias ativas no projeto.
-- `useCategoryStatus('id')`: Verifica o status de uma categoria específica (se está ativa, se é essencial, etc.).
-
-```tsx
-import { useCategoryStatus } from 'react-lgpd-consent'
-
-function AnalyticsFeature() {
-  const analytics = useCategoryStatus('analytics')
-
-  // Não renderiza o componente se a categoria 'analytics' não estiver configurada no ConsentProvider
-  if (!analytics.isActive) {
-    return null
-  }
-
-  return <AnalyticsDashboard />
-}
-```
-
-## 🚀 Roadmap de Funcionalidades
-
-O foco da biblioteca é estabilidade e conformidade.
-
-### v0.3.0 (Atual)
-
-- **Foco**: Refatoração da arquitetura, melhoria da experiência do desenvolvedor (DX) e quebra de compatibilidade para simplificação.
-- **Status**: Implementado.
-
-### Próximas Versões (Pseudo-Versioning)
-
-- **v0.+1.0 (Multi-Regulamentação e Conformidade Avançada)**:
-  - **Geolocalização-based Consent**: Detecção automática da região do usuário para aplicar a regulamentação relevante (LGPD, GDPR, CCPA).
-  - **Configurable Regulation Profiles**: Definição de perfis de regulamentação com requisitos específicos.
-  - **Dynamic Text Adaptation**: Textos adaptáveis com base na regulamentação ativa.
-  - **Modal Detalhado de Cookies**: Exibição de informações técnicas sobre cada cookie (nome, duração, provedor).
-  - **Logs de Auditoria**: Sistema de log client-side para registrar todas as interações de consentimento do usuário.
-  - **Templates Setoriais**: Configurações e textos pré-definidos para setores específicos (governo, saúde, e-commerce).
-  - **Plugin System**: Sistema de plugins para extensibilidade de integrações e lógica customizada.
-  - **Improved `ConsentGate`**: Controle mais granular (e.g., `analytics AND functional`).
-  - **Enhanced Developer Guidance**: Mais avisos e sugestões detalhadas.
-
-## 🔒 Segurança e Privacidade
-
-- **Armazenamento**: O consentimento é armazenado exclusivamente no cliente (`localStorage` ou `cookie`).
-- **Minimização**: O cookie de consentimento contém apenas as preferências para as categorias ativas no projeto, a versão da configuração e os timestamps necessários para auditoria.
-- **Sem Coleta de Dados Pessoais**: A biblioteca em si não coleta ou transmite dados pessoais.