react-lgpd-consent 0.2.1 → 0.2.3

package/dist/{chunk-QCERRRSC.js → chunk-E763JXNL.js}

@@ -8,10 +8,238 @@ import FormControlLabel from "@mui/material/FormControlLabel";
 import FormGroup from "@mui/material/FormGroup";
 import Switch from "@mui/material/Switch";
 import Typography2 from "@mui/material/Typography";
-import { useEffect as useEffect2, useState as useState2 } from "react";
+import { useEffect as useEffect4, useState as useState2 } from "react";
 
-// src/context/ConsentContext.tsx
+// src/context/CategoriesContext.tsx
 import * as React2 from "react";
+
+// src/utils/developerGuidance.ts
+import * as React from "react";
+var DEFAULT_PROJECT_CATEGORIES = {
+  enabledCategories: ["analytics"],
+  // Só analytics além de necessary
+  customCategories: []
+};
+function analyzeDeveloperConfiguration(config) {
+  const guidance = {
+    warnings: [],
+    suggestions: [],
+    activeCategoriesInfo: [],
+    usingDefaults: !config
+  };
+  const finalConfig = config || DEFAULT_PROJECT_CATEGORIES;
+  if (!config) {
+    guidance.warnings.push(
+      'LGPD-CONSENT: Nenhuma configura\xE7\xE3o de categorias especificada. Usando padr\xE3o: necessary + analytics. Para produ\xE7\xE3o, recomenda-se especificar explicitamente as categorias via prop "categories".'
+    );
+  }
+  guidance.activeCategoriesInfo.push({
+    id: "necessary",
+    name: "Cookies Necess\xE1rios",
+    description: "Essenciais para funcionamento b\xE1sico do site",
+    essential: true,
+    uiRequired: false
+    // Não precisa de toggle (sempre ativo)
+  });
+  const enabledCategories = finalConfig.enabledCategories || [];
+  const categoryNames = {
+    analytics: {
+      name: "Cookies Anal\xEDticos",
+      description: "Medem uso e performance do site"
+    },
+    functional: {
+      name: "Cookies Funcionais",
+      description: "Melhoram experi\xEAncia e funcionalidades"
+    },
+    marketing: {
+      name: "Cookies de Marketing",
+      description: "Publicidade direcionada e campanhas"
+    },
+    social: {
+      name: "Cookies de Redes Sociais",
+      description: "Integra\xE7\xE3o com plataformas sociais"
+    },
+    personalization: {
+      name: "Cookies de Personaliza\xE7\xE3o",
+      description: "Adaptam conte\xFAdo \xE0s prefer\xEAncias do usu\xE1rio"
+    }
+  };
+  enabledCategories.forEach((categoryId) => {
+    const categoryInfo = categoryNames[categoryId];
+    if (categoryInfo) {
+      guidance.activeCategoriesInfo.push({
+        id: categoryId,
+        name: categoryInfo.name,
+        description: categoryInfo.description,
+        essential: false,
+        uiRequired: true
+        // Precisa de toggle na UI
+      });
+    }
+  });
+  const customCategories = finalConfig.customCategories || [];
+  customCategories.forEach((category) => {
+    guidance.activeCategoriesInfo.push({
+      id: category.id,
+      name: category.name,
+      description: category.description,
+      essential: category.essential === true,
+      uiRequired: category.essential !== true
+      // Apenas não-essenciais precisam toggle
+    });
+  });
+  const totalToggleable = guidance.activeCategoriesInfo.filter(
+    (c) => c.uiRequired
+  ).length;
+  if (totalToggleable === 0) {
+    guidance.suggestions.push(
+      'Apenas cookies necess\xE1rios est\xE3o configurados. Para compliance completo LGPD, considere adicionar categorias como "analytics" ou "functional" conforme uso real.'
+    );
+  }
+  if (totalToggleable > 5) {
+    guidance.warnings.push(
+      `${totalToggleable} categorias opcionais detectadas. UI com muitas op\xE7\xF5es pode ' +
+      'prejudicar experi\xEAncia do usu\xE1rio. Considere agrupar categorias similares.`
+    );
+  }
+  const poorDescriptions = customCategories.filter(
+    (c) => !c.description || c.description.length < 10
+  );
+  if (poorDescriptions.length > 0) {
+    guidance.warnings.push(
+      `Categorias customizadas com descri\xE7\xF5es inadequadas: ${poorDescriptions.map((c) => c.id).join(", ")}. Descri\xE7\xF5es claras s\xE3o obrigat\xF3rias para compliance LGPD.`
+    );
+  }
+  return guidance;
+}
+function logDeveloperGuidance(guidance) {
+  try {
+    const isProduction = (
+      // 1. NODE_ENV de bundlers (Vite, webpack, etc.)
+      typeof globalThis.process !== "undefined" && globalThis.process.env?.NODE_ENV === "production" || // 2. Vite/bundler env vars (apenas em ESM)
+      typeof globalThis !== "undefined" && typeof globalThis.import !== "undefined" && globalThis.import.meta?.env?.PROD === true || // 3. Flag customizada para desabilitar logs
+      typeof globalThis !== "undefined" && globalThis.__LGPD_PRODUCTION__ || // 4. Flag de desenvolvimento desabilitada
+      typeof window !== "undefined" && window.__LGPD_DISABLE_GUIDANCE__
+    );
+    if (isProduction) return;
+    const PREFIX = "[\u{1F36A} LGPD-CONSENT]";
+    if (guidance.warnings.length > 0) {
+      console.group(`${PREFIX} \u26A0\uFE0F  Avisos de Configura\xE7\xE3o`);
+      guidance.warnings.forEach(
+        (warning) => console.warn(`${PREFIX} ${warning}`)
+      );
+      console.groupEnd();
+    }
+    if (guidance.suggestions.length > 0) {
+      console.group(`${PREFIX} \u{1F4A1} Sugest\xF5es`);
+      guidance.suggestions.forEach(
+        (suggestion) => console.info(`${PREFIX} ${suggestion}`)
+      );
+      console.groupEnd();
+    }
+    if (guidance.usingDefaults) {
+      console.info(
+        `${PREFIX} \u{1F4CB} Usando configura\xE7\xE3o padr\xE3o. Para personalizar, use a prop "categories" no ConsentProvider.`
+      );
+    }
+    console.group(`${PREFIX} \u{1F527} Categorias Ativas (para UI customizada)`);
+    console.table(
+      guidance.activeCategoriesInfo.map((cat) => ({
+        ID: cat.id,
+        Nome: cat.name,
+        "Toggle UI?": cat.uiRequired ? "\u2705 SIM" : "\u274C N\xC3O (sempre ativo)",
+        "Essencial?": cat.essential ? "\u{1F512} SIM" : "\u2699\uFE0F N\xC3O"
+      }))
+    );
+    console.info(
+      `${PREFIX} \u2139\uFE0F  Use estes dados para criar componentes customizados adequados.`
+    );
+    console.groupEnd();
+  } catch (error) {
+    if (typeof console !== "undefined" && console.warn) {
+      console.warn(
+        "[\u{1F36A} LGPD-CONSENT] Sistema de orienta\xE7\xF5es encontrou erro:",
+        error
+      );
+    }
+  }
+}
+function useDeveloperGuidance(config) {
+  const guidance = analyzeDeveloperConfiguration(config);
+  React.useEffect(() => {
+    logDeveloperGuidance(guidance);
+  }, [JSON.stringify(config)]);
+  return guidance;
+}
+
+// src/context/CategoriesContext.tsx
+import { jsx } from "react/jsx-runtime";
+var CategoriesContext = React2.createContext(
+  null
+);
+var CategoriesCtx = React2.createContext([]);
+function CategoriesProvider({
+  children,
+  categories,
+  // LEGACY: prop antiga (apenas customCategories)
+  config
+  // NOVO: configuração completa
+}) {
+  const contextValue = React2.useMemo(() => {
+    let finalConfig;
+    if (categories && !config) {
+      finalConfig = {
+        enabledCategories: DEFAULT_PROJECT_CATEGORIES.enabledCategories,
+        customCategories: categories
+      };
+    } else {
+      finalConfig = config || DEFAULT_PROJECT_CATEGORIES;
+    }
+    const guidance = analyzeDeveloperConfiguration(
+      config || (categories ? { customCategories: categories } : void 0)
+    );
+    const toggleableCategories = guidance.activeCategoriesInfo.filter(
+      (cat) => cat.uiRequired
+    );
+    return {
+      config: finalConfig,
+      guidance,
+      toggleableCategories,
+      allCategories: guidance.activeCategoriesInfo,
+      legacyCategories: categories || []
+    };
+  }, [config, categories]);
+  React2.useEffect(() => {
+    logDeveloperGuidance(contextValue.guidance);
+  }, [contextValue.guidance]);
+  return /* @__PURE__ */ jsx(CategoriesContext.Provider, { value: contextValue, children: /* @__PURE__ */ jsx(CategoriesCtx.Provider, { value: contextValue.legacyCategories, children }) });
+}
+function useCategories() {
+  const context = React2.useContext(CategoriesContext);
+  if (!context) {
+    throw new Error(
+      "useCategories deve ser usado dentro de CategoriesProvider. Certifique-se de que o ConsentProvider est\xE1 envolvendo seu componente."
+    );
+  }
+  return context;
+}
+function useCategoryStatus(categoryId) {
+  const { allCategories } = useCategories();
+  const category = allCategories.find((cat) => cat.id === categoryId);
+  return {
+    isActive: !!category,
+    isEssential: category?.essential || false,
+    needsToggle: category?.uiRequired || false,
+    name: category?.name,
+    description: category?.description
+  };
+}
+function useCustomCategories() {
+  return React2.useContext(CategoriesCtx);
+}
+
+// src/context/ConsentContext.tsx
+import * as React3 from "react";
 import { ThemeProvider } from "@mui/material/styles";
 
 // src/utils/cookieUtils.ts
@@ -158,75 +386,10 @@ var defaultConsentTheme = createTheme({
   }
 });
 
-// src/context/CategoriesContext.tsx
-import * as React from "react";
-import { jsx } from "react/jsx-runtime";
-var CategoriesCtx = React.createContext([]);
-function CategoriesProvider({
-  categories,
-  children
-}) {
-  const value = React.useMemo(() => categories || [], [categories]);
-  return /* @__PURE__ */ jsx(CategoriesCtx.Provider, { value, children });
-}
-function useCustomCategories() {
-  return React.useContext(CategoriesCtx);
-}
-function useAllCategories() {
-  const customCategories = useCustomCategories();
-  return React.useMemo(() => {
-    const defaultCategories = [
-      {
-        id: "necessary",
-        name: "Cookies Necess\xE1rios",
-        description: "Essenciais para o funcionamento b\xE1sico do site. Incluem cookies de sess\xE3o, autentica\xE7\xE3o e seguran\xE7a.",
-        essential: true,
-        cookies: ["PHPSESSID", "JSESSIONID", "cookieConsent", "csrf_token"]
-      },
-      {
-        id: "analytics",
-        name: "Analytics e Estat\xEDsticas",
-        description: "Permitem medir audi\xEAncia e desempenho, gerando estat\xEDsticas an\xF4nimas de uso.",
-        essential: false,
-        cookies: ["_ga", "_ga_*", "_gid", "_gat", "gtag"]
-      },
-      {
-        id: "functional",
-        name: "Cookies Funcionais",
-        description: "Melhoram a experi\xEAncia do usu\xE1rio, lembrando prefer\xEAncias e configura\xE7\xF5es.",
-        essential: false,
-        cookies: ["language", "theme", "timezone", "preferences"]
-      },
-      {
-        id: "marketing",
-        name: "Marketing e Publicidade",
-        description: "Utilizados para publicidade direcionada e medi\xE7\xE3o de campanhas publicit\xE1rias.",
-        essential: false,
-        cookies: ["_fbp", "fr", "tr", "ads_*", "doubleclick"]
-      },
-      {
-        id: "social",
-        name: "Redes Sociais",
-        description: "Permitem compartilhamento e integra\xE7\xE3o com redes sociais como Facebook, YouTube, etc.",
-        essential: false,
-        cookies: ["__Secure-*", "sb", "datr", "c_user", "social_*"]
-      },
-      {
-        id: "personalization",
-        name: "Personaliza\xE7\xE3o",
-        description: "Adaptam o conte\xFAdo e interface \xE0s prefer\xEAncias individuais do usu\xE1rio.",
-        essential: false,
-        cookies: ["personalization_*", "content_*", "layout_*"]
-      }
-    ];
-    return [...defaultCategories, ...customCategories];
-  }, [customCategories]);
-}
-
 // src/context/ConsentContext.tsx
 import { jsx as jsx2, jsxs } from "react/jsx-runtime";
-var PreferencesModal = React2.lazy(
-  () => import("./PreferencesModal-4WHKT67T.js").then((m) => ({
+var PreferencesModal = React3.lazy(
+  () => import("./PreferencesModal-UMNANMVX.js").then((m) => ({
     default: m.PreferencesModal
   }))
 );
@@ -346,15 +509,18 @@ function reducer(state, action) {
       return state;
   }
 }
-var StateCtx = React2.createContext(null);
-var ActionsCtx = React2.createContext(null);
-var TextsCtx = React2.createContext(DEFAULT_TEXTS);
-var HydrationCtx = React2.createContext(false);
+var StateCtx = React3.createContext(null);
+var ActionsCtx = React3.createContext(null);
+var TextsCtx = React3.createContext(DEFAULT_TEXTS);
+var HydrationCtx = React3.createContext(false);
 function ConsentProvider({
   initialState,
+  categories,
+  // NOVO: configuração completa de categorias
   texts: textsProp,
   theme,
   customCategories,
+  // LEGACY: compatibilidade
   scriptIntegrations,
   PreferencesModalComponent,
   preferencesModalProps = {},
@@ -365,19 +531,31 @@ function ConsentProvider({
   cookie: cookieOpts,
   children
 }) {
-  const texts = React2.useMemo(
+  const texts = React3.useMemo(
     () => ({ ...DEFAULT_TEXTS, ...textsProp ?? {} }),
     [textsProp]
   );
-  const cookie = React2.useMemo(
+  const cookie = React3.useMemo(
     () => ({ ...DEFAULT_COOKIE_OPTS, ...cookieOpts ?? {} }),
     [cookieOpts]
   );
-  const appliedTheme = React2.useMemo(
+  const appliedTheme = React3.useMemo(
     () => theme || defaultConsentTheme,
     [theme]
   );
-  const boot = React2.useMemo(() => {
+  const finalCategoriesConfig = React3.useMemo(() => {
+    if (categories) return categories;
+    if (customCategories) {
+      return {
+        enabledCategories: ["analytics"],
+        // padrão quando usando API antiga
+        customCategories
+      };
+    }
+    return void 0;
+  }, [categories, customCategories]);
+  useDeveloperGuidance(finalCategoriesConfig);
+  const boot = React3.useMemo(() => {
     if (initialState) return { ...initialState, isModalOpen: false };
     return createFullConsentState(
       false,
@@ -386,9 +564,9 @@ function ConsentProvider({
       false
     );
   }, [initialState, customCategories]);
-  const [state, dispatch] = React2.useReducer(reducer, boot);
-  const [isHydrated, setIsHydrated] = React2.useState(false);
-  React2.useEffect(() => {
+  const [state, dispatch] = React3.useReducer(reducer, boot);
+  const [isHydrated, setIsHydrated] = React3.useState(false);
+  React3.useEffect(() => {
     if (!initialState) {
       const saved = readConsentCookie(cookie.name);
       if (saved?.consented) {
@@ -398,24 +576,24 @@ function ConsentProvider({
     }
     setIsHydrated(true);
   }, [cookie.name, initialState]);
-  React2.useEffect(() => {
+  React3.useEffect(() => {
     if (state.consented) writeConsentCookie(state, state.source, cookie);
   }, [state, cookie]);
-  const prevConsented = React2.useRef(state.consented);
-  React2.useEffect(() => {
+  const prevConsented = React3.useRef(state.consented);
+  React3.useEffect(() => {
     if (!prevConsented.current && state.consented && onConsentGiven) {
       setTimeout(() => onConsentGiven(state), 150);
     }
     prevConsented.current = state.consented;
   }, [state, onConsentGiven]);
-  const prevPrefs = React2.useRef(state.preferences);
-  React2.useEffect(() => {
+  const prevPrefs = React3.useRef(state.preferences);
+  React3.useEffect(() => {
     if (state.consented && onPreferencesSaved && prevPrefs.current !== state.preferences) {
       setTimeout(() => onPreferencesSaved(state.preferences), 150);
       prevPrefs.current = state.preferences;
     }
   }, [state, onPreferencesSaved]);
-  const api = React2.useMemo(() => {
+  const api = React3.useMemo(() => {
     const acceptAll = () => dispatch({ type: "ACCEPT_ALL", customCategories });
     const rejectAll = () => dispatch({ type: "REJECT_ALL", customCategories });
     const setPreference = (category, value) => dispatch({ type: "SET_CATEGORY", category, value });
@@ -439,29 +617,36 @@ function ConsentProvider({
       resetConsent
     };
   }, [state, cookie, customCategories]);
-  return /* @__PURE__ */ jsx2(ThemeProvider, { theme: appliedTheme, children: /* @__PURE__ */ jsx2(StateCtx.Provider, { value: state, children: /* @__PURE__ */ jsx2(ActionsCtx.Provider, { value: api, children: /* @__PURE__ */ jsx2(TextsCtx.Provider, { value: texts, children: /* @__PURE__ */ jsx2(HydrationCtx.Provider, { value: isHydrated, children: /* @__PURE__ */ jsxs(CategoriesProvider, { categories: customCategories, children: [
-    children,
-    !disableAutomaticModal && /* @__PURE__ */ jsx2(React2.Suspense, { fallback: null, children: PreferencesModalComponent ? /* @__PURE__ */ jsx2(PreferencesModalComponent, { ...preferencesModalProps }) : /* @__PURE__ */ jsx2(PreferencesModal, { hideBranding }) })
-  ] }) }) }) }) }) });
+  return /* @__PURE__ */ jsx2(ThemeProvider, { theme: appliedTheme, children: /* @__PURE__ */ jsx2(StateCtx.Provider, { value: state, children: /* @__PURE__ */ jsx2(ActionsCtx.Provider, { value: api, children: /* @__PURE__ */ jsx2(TextsCtx.Provider, { value: texts, children: /* @__PURE__ */ jsx2(HydrationCtx.Provider, { value: isHydrated, children: /* @__PURE__ */ jsxs(
+    CategoriesProvider,
+    {
+      config: finalCategoriesConfig,
+      categories: customCategories,
+      children: [
+        children,
+        !disableAutomaticModal && /* @__PURE__ */ jsx2(React3.Suspense, { fallback: null, children: PreferencesModalComponent ? /* @__PURE__ */ jsx2(PreferencesModalComponent, { ...preferencesModalProps }) : /* @__PURE__ */ jsx2(PreferencesModal, { hideBranding }) })
+      ]
+    }
+  ) }) }) }) }) });
 }
 function useConsentStateInternal() {
-  const ctx = React2.useContext(StateCtx);
+  const ctx = React3.useContext(StateCtx);
   if (!ctx)
     throw new Error("useConsentState must be used within ConsentProvider");
   return ctx;
 }
 function useConsentActionsInternal() {
-  const ctx = React2.useContext(ActionsCtx);
+  const ctx = React3.useContext(ActionsCtx);
   if (!ctx)
     throw new Error("useConsentActions must be used within ConsentProvider");
   return ctx;
 }
 function useConsentTextsInternal() {
-  const ctx = React2.useContext(TextsCtx);
+  const ctx = React3.useContext(TextsCtx);
   return ctx;
 }
 function useConsentHydrationInternal() {
-  return React2.useContext(HydrationCtx);
+  return React3.useContext(HydrationCtx);
 }
 
 // src/hooks/useConsent.ts
@@ -555,12 +740,25 @@ function PreferencesModal2({
 }) {
   const { preferences, setPreferences, closePreferences, isModalOpen } = useConsent();
   const texts = useConsentTexts();
-  const [tempPreferences, setTempPreferences] = useState2(preferences);
-  useEffect2(() => {
+  const { toggleableCategories } = useCategories();
+  const [tempPreferences, setTempPreferences] = useState2(
+    () => {
+      const initialPrefs = { necessary: true };
+      toggleableCategories.forEach((category) => {
+        initialPrefs[category.id] = preferences[category.id] ?? false;
+      });
+      return initialPrefs;
+    }
+  );
+  useEffect4(() => {
     if (isModalOpen) {
-      setTempPreferences(preferences);
+      const syncedPrefs = { necessary: true };
+      toggleableCategories.forEach((category) => {
+        syncedPrefs[category.id] = preferences[category.id] ?? false;
+      });
+      setTempPreferences(syncedPrefs);
     }
-  }, [isModalOpen, preferences]);
+  }, [isModalOpen, preferences, toggleableCategories]);
   const open = DialogProps2?.open ?? isModalOpen ?? false;
   const handleSave = () => {
     setPreferences(tempPreferences);
@@ -581,38 +779,23 @@ function PreferencesModal2({
         /* @__PURE__ */ jsxs3(DialogContent, { dividers: true, children: [
           /* @__PURE__ */ jsx4(Typography2, { variant: "body2", sx: { mb: 2 }, children: texts.modalIntro }),
           /* @__PURE__ */ jsxs3(FormGroup, { children: [
-            /* @__PURE__ */ jsx4(
-              FormControlLabel,
-              {
-                control: /* @__PURE__ */ jsx4(
-                  Switch,
-                  {
-                    checked: tempPreferences.analytics,
-                    onChange: (e) => setTempPreferences((prev) => ({
-                      ...prev,
-                      analytics: e.target.checked
-                    }))
-                  }
-                ),
-                label: "Cookies Anal\xEDticos (medem uso do site)"
-              }
-            ),
-            /* @__PURE__ */ jsx4(
+            toggleableCategories.map((category) => /* @__PURE__ */ jsx4(
               FormControlLabel,
               {
                 control: /* @__PURE__ */ jsx4(
                   Switch,
                   {
-                    checked: tempPreferences.marketing,
+                    checked: tempPreferences[category.id] ?? false,
                     onChange: (e) => setTempPreferences((prev) => ({
                       ...prev,
-                      marketing: e.target.checked
+                      [category.id]: e.target.checked
                     }))
                   }
                 ),
-                label: "Cookies de Marketing/Publicidade"
-              }
-            ),
+                label: `${category.name} - ${category.description}`
+              },
+              category.id
+            )),
             /* @__PURE__ */ jsx4(
               FormControlLabel,
               {
@@ -634,8 +817,11 @@ function PreferencesModal2({
 
 export {
   defaultConsentTheme,
+  DEFAULT_PROJECT_CATEGORIES,
+  analyzeDeveloperConfiguration,
+  useCategories,
+  useCategoryStatus,
   useCustomCategories,
-  useAllCategories,
   Branding,
   PreferencesModal2 as PreferencesModal,
   ConsentProvider,