@react-lgpd-consent/core 0.6.1 → 0.6.2

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog - @react-lgpd-consent/core
 
+## 0.6.2
+
+### Patch Changes
+
+- [#113](https://github.com/lucianoedipo/react-lgpd-consent/pull/113) [`b51e1f8`](https://github.com/lucianoedipo/react-lgpd-consent/commit/b51e1f8dcac35907e3a30471135da14160c95213) Thanks [@lucianoedipo](https://github.com/lucianoedipo)! - feat: Compatibilidade completa com React 19 StrictMode
+  - Implementado registro global `LOADING_SCRIPTS` em `scriptLoader.ts` para prevenir injeções duplicadas de scripts durante double-invoking de efeitos
+  - Adicionado `setTimeout` com cleanup adequado em `ConsentScriptLoader.tsx` para prevenir race conditions
+  - Scripts agora carregam apenas uma vez mesmo em desenvolvimento com StrictMode ativo
+  - Função `loadScript` é idempotente: múltiplas chamadas simultâneas retornam a mesma Promise
+  - **Correção crítica**: `loadScript` agora aguarda dinamicamente o consentimento em vez de rejeitar imediatamente, permitindo que scripts carreguem quando preferências mudarem
+  - Cleanup automático do registro ao completar/falhar carregamento
+  - Adicionados testes extensivos: `ConsentScriptLoader.strictmode.test.tsx` e `scriptLoader.strictmode.test.ts`
+  - Documentação completa em `docs/REACT19-STRICTMODE.md`
+  - Todos os 302 testes passando, incluindo 5 novos testes de StrictMode
+
+  **Breaking Changes:** Nenhuma - totalmente retrocompatível
+
 ## 0.6.1
 
 ### Patch Changes

package/dist/index.cjs

@@ -436,7 +436,7 @@ function removeConsentCookie(opts) {
 }
 
 // src/utils/dataLayerEvents.ts
-var LIBRARY_VERSION = "0.6.1";
+var LIBRARY_VERSION = "0.6.2";
 function ensureDataLayer() {
   if (typeof window === "undefined") return;
   if (!window.dataLayer) {
@@ -2003,10 +2003,13 @@ function ConsentGate(props) {
 }
 
 // src/utils/scriptLoader.ts
+var LOADING_SCRIPTS = /* @__PURE__ */ new Map();
 function loadScript(id, src, category = null, attrs = {}) {
   if (typeof document === "undefined") return Promise.resolve();
   if (document.getElementById(id)) return Promise.resolve();
-  return new Promise((resolve, reject) => {
+  const existingPromise = LOADING_SCRIPTS.get(id);
+  if (existingPromise) return existingPromise;
+  const promise = new Promise((resolve, reject) => {
     const checkConsent = () => {
       const consentCookie = document.cookie.split("; ").find((row) => row.startsWith("cookieConsent="))?.split("=")[1];
       if (!consentCookie) {
@@ -2020,7 +2023,7 @@ function loadScript(id, src, category = null, attrs = {}) {
           return;
         }
         if (category && !consent.preferences[category]) {
-          reject(new Error(`Consent not given for ${category} scripts`));
+          setTimeout(checkConsent, 100);
           return;
         }
         const s = document.createElement("script");
@@ -2028,8 +2031,14 @@ function loadScript(id, src, category = null, attrs = {}) {
         s.src = src;
         s.async = true;
         for (const [k, v] of Object.entries(attrs)) s.setAttribute(k, v);
-        s.onload = () => resolve();
-        s.onerror = () => reject(new Error(`Failed to load script: ${src}`));
+        s.onload = () => {
+          LOADING_SCRIPTS.delete(id);
+          resolve();
+        };
+        s.onerror = () => {
+          LOADING_SCRIPTS.delete(id);
+          reject(new Error(`Failed to load script: ${src}`));
+        };
         document.body.appendChild(s);
       } catch {
         setTimeout(checkConsent, 100);
@@ -2037,6 +2046,8 @@ function loadScript(id, src, category = null, attrs = {}) {
     };
     checkConsent();
   });
+  LOADING_SCRIPTS.set(id, promise);
+  return promise;
 }
 
 // src/utils/autoConfigureCategories.ts
@@ -2264,21 +2275,29 @@ function ConsentScriptLoader({
   }, [integrations, categories]);
   React4__namespace.useEffect(() => {
     if (!consented) return;
-    integrations.forEach(async (integration) => {
-      const shouldLoad = preferences[integration.category];
-      const alreadyLoaded = loadedScripts.current.has(integration.id);
-      if (shouldLoad && (!alreadyLoaded || reloadOnChange)) {
-        try {
-          await loadScript(integration.id, integration.src, integration.category, integration.attrs);
-          if (integration.init) {
-            integration.init();
+    const timeoutId = setTimeout(async () => {
+      for (const integration of integrations) {
+        const shouldLoad = preferences[integration.category];
+        const alreadyLoaded = loadedScripts.current.has(integration.id);
+        if (shouldLoad && (!alreadyLoaded || reloadOnChange)) {
+          try {
+            await loadScript(
+              integration.id,
+              integration.src,
+              integration.category,
+              integration.attrs
+            );
+            if (integration.init) {
+              integration.init();
+            }
+            loadedScripts.current.add(integration.id);
+          } catch (error) {
+            logger.error(`\u274C Failed to load script: ${integration.id}`, error);
           }
-          loadedScripts.current.add(integration.id);
-        } catch (error) {
-          logger.error(`\u274C Failed to load script: ${integration.id}`, error);
         }
       }
-    });
+    }, 0);
+    return () => clearTimeout(timeoutId);
   }, [preferences, consented, integrations, reloadOnChange]);
   return null;
 }

package/dist/index.d.cts

@@ -784,7 +784,8 @@ type BackdropConfig = boolean | string | {
  *
  * @category Types
  * @since 0.1.3
- * @version 0.4.1 - Expandido substancialmente com novos tokens
+ * @remarks
+ * **Histórico**: v0.4.1 - Expandido substancialmente com novos tokens
  * @public
  *
  * @example Configuração básica
@@ -1475,8 +1476,8 @@ interface ConsentContextValue {
      * @param cat - ID da categoria (predefinida ou customizada)
      * @param value - Valor do consentimento para a categoria
      *
-     * @breakingChange
-     * **v0.4.1**: Parâmetro `cat` mudou de `Category` para `string` para suportar
+     * @remarks
+     * **Breaking Change (v0.4.1)**: Parâmetro `cat` mudou de `Category` para `string` para suportar
      * categorias customizadas. O uso com strings literais continua funcionando.
      *
      * @example
@@ -2252,6 +2253,7 @@ declare function useCategoryStatus(categoryId: string): {
  * }
  * ```
  *
+ *
  * @component
  * @category Context
  * @since 0.1.0
@@ -2361,6 +2363,9 @@ declare function buildConsentStorageKey(options?: {
  * após o consentimento do usuário. Ela garante que o script só seja inserido na página
  * se o consentimento for dado e o contexto estiver disponível.
  *
+ * **React 19 StrictMode**: A função é idempotente e mantém um registro global de scripts
+ * em carregamento para evitar duplicações durante double-invoking de efeitos em desenvolvimento.
+ *
  * @param {string} id Um identificador único para o elemento `<script>` a ser criado.
  * @param {string} src A URL do script externo a ser carregado.
  * @param {string | null} [category=null] A categoria de consentimento exigida para o script. Suporta tanto categorias predefinidas quanto customizadas. Se o consentimento para esta categoria não for dado, o script não será carregado.
@@ -3321,7 +3326,8 @@ type LanguageTexts = Partial<Omit<ConsentTexts, 'i18n' | 'variants' | 'contexts'
  *
  * @category Types
  * @since 0.4.1
- * @version 0.4.1 - Nova interface com suporte avançado a i18n e contextos
+ * @remarks
+ * **Histórico**: v0.4.1 - Nova interface com suporte avançado a i18n e contextos
  *
  * @example Configuração multilíngue
  * ```typescript

package/dist/index.d.ts

@@ -784,7 +784,8 @@ type BackdropConfig = boolean | string | {
  *
  * @category Types
  * @since 0.1.3
- * @version 0.4.1 - Expandido substancialmente com novos tokens
+ * @remarks
+ * **Histórico**: v0.4.1 - Expandido substancialmente com novos tokens
  * @public
  *
  * @example Configuração básica
@@ -1475,8 +1476,8 @@ interface ConsentContextValue {
      * @param cat - ID da categoria (predefinida ou customizada)
      * @param value - Valor do consentimento para a categoria
      *
-     * @breakingChange
-     * **v0.4.1**: Parâmetro `cat` mudou de `Category` para `string` para suportar
+     * @remarks
+     * **Breaking Change (v0.4.1)**: Parâmetro `cat` mudou de `Category` para `string` para suportar
      * categorias customizadas. O uso com strings literais continua funcionando.
      *
      * @example
@@ -2252,6 +2253,7 @@ declare function useCategoryStatus(categoryId: string): {
  * }
  * ```
  *
+ *
  * @component
  * @category Context
  * @since 0.1.0
@@ -2361,6 +2363,9 @@ declare function buildConsentStorageKey(options?: {
  * após o consentimento do usuário. Ela garante que o script só seja inserido na página
  * se o consentimento for dado e o contexto estiver disponível.
  *
+ * **React 19 StrictMode**: A função é idempotente e mantém um registro global de scripts
+ * em carregamento para evitar duplicações durante double-invoking de efeitos em desenvolvimento.
+ *
  * @param {string} id Um identificador único para o elemento `<script>` a ser criado.
  * @param {string} src A URL do script externo a ser carregado.
  * @param {string | null} [category=null] A categoria de consentimento exigida para o script. Suporta tanto categorias predefinidas quanto customizadas. Se o consentimento para esta categoria não for dado, o script não será carregado.
@@ -3321,7 +3326,8 @@ type LanguageTexts = Partial<Omit<ConsentTexts, 'i18n' | 'variants' | 'contexts'
  *
  * @category Types
  * @since 0.4.1
- * @version 0.4.1 - Nova interface com suporte avançado a i18n e contextos
+ * @remarks
+ * **Histórico**: v0.4.1 - Nova interface com suporte avançado a i18n e contextos
  *
  * @example Configuração multilíngue
  * ```typescript

package/dist/index.js

@@ -412,7 +412,7 @@ function removeConsentCookie(opts) {
 }
 
 // src/utils/dataLayerEvents.ts
-var LIBRARY_VERSION = "0.6.1";
+var LIBRARY_VERSION = "0.6.2";
 function ensureDataLayer() {
   if (typeof window === "undefined") return;
   if (!window.dataLayer) {
@@ -1979,10 +1979,13 @@ function ConsentGate(props) {
 }
 
 // src/utils/scriptLoader.ts
+var LOADING_SCRIPTS = /* @__PURE__ */ new Map();
 function loadScript(id, src, category = null, attrs = {}) {
   if (typeof document === "undefined") return Promise.resolve();
   if (document.getElementById(id)) return Promise.resolve();
-  return new Promise((resolve, reject) => {
+  const existingPromise = LOADING_SCRIPTS.get(id);
+  if (existingPromise) return existingPromise;
+  const promise = new Promise((resolve, reject) => {
     const checkConsent = () => {
       const consentCookie = document.cookie.split("; ").find((row) => row.startsWith("cookieConsent="))?.split("=")[1];
       if (!consentCookie) {
@@ -1996,7 +1999,7 @@ function loadScript(id, src, category = null, attrs = {}) {
           return;
         }
         if (category && !consent.preferences[category]) {
-          reject(new Error(`Consent not given for ${category} scripts`));
+          setTimeout(checkConsent, 100);
           return;
         }
         const s = document.createElement("script");
@@ -2004,8 +2007,14 @@ function loadScript(id, src, category = null, attrs = {}) {
         s.src = src;
         s.async = true;
         for (const [k, v] of Object.entries(attrs)) s.setAttribute(k, v);
-        s.onload = () => resolve();
-        s.onerror = () => reject(new Error(`Failed to load script: ${src}`));
+        s.onload = () => {
+          LOADING_SCRIPTS.delete(id);
+          resolve();
+        };
+        s.onerror = () => {
+          LOADING_SCRIPTS.delete(id);
+          reject(new Error(`Failed to load script: ${src}`));
+        };
         document.body.appendChild(s);
       } catch {
         setTimeout(checkConsent, 100);
@@ -2013,6 +2022,8 @@ function loadScript(id, src, category = null, attrs = {}) {
     };
     checkConsent();
   });
+  LOADING_SCRIPTS.set(id, promise);
+  return promise;
 }
 
 // src/utils/autoConfigureCategories.ts
@@ -2240,21 +2251,29 @@ function ConsentScriptLoader({
   }, [integrations, categories]);
   React4.useEffect(() => {
     if (!consented) return;
-    integrations.forEach(async (integration) => {
-      const shouldLoad = preferences[integration.category];
-      const alreadyLoaded = loadedScripts.current.has(integration.id);
-      if (shouldLoad && (!alreadyLoaded || reloadOnChange)) {
-        try {
-          await loadScript(integration.id, integration.src, integration.category, integration.attrs);
-          if (integration.init) {
-            integration.init();
+    const timeoutId = setTimeout(async () => {
+      for (const integration of integrations) {
+        const shouldLoad = preferences[integration.category];
+        const alreadyLoaded = loadedScripts.current.has(integration.id);
+        if (shouldLoad && (!alreadyLoaded || reloadOnChange)) {
+          try {
+            await loadScript(
+              integration.id,
+              integration.src,
+              integration.category,
+              integration.attrs
+            );
+            if (integration.init) {
+              integration.init();
+            }
+            loadedScripts.current.add(integration.id);
+          } catch (error) {
+            logger.error(`\u274C Failed to load script: ${integration.id}`, error);
           }
-          loadedScripts.current.add(integration.id);
-        } catch (error) {
-          logger.error(`\u274C Failed to load script: ${integration.id}`, error);
         }
       }
-    });
+    }, 0);
+    return () => clearTimeout(timeoutId);
   }, [preferences, consented, integrations, reloadOnChange]);
   return null;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-lgpd-consent/core",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "Núcleo da biblioteca de consentimento LGPD para React - Estado, hooks e utilitários sem dependências de UI",
   "keywords": [
     "lgpd",
@@ -53,7 +53,7 @@
   },
   "dependencies": {
     "js-cookie": "^3.0.5",
-    "zod": "^4.1.12"
+    "zod": "^4.1.13"
   },
   "repository": {
     "type": "git",