@solvenza/cookies-compliance 1.2.1 → 1.5.3

package/dist/wrappers/react.d.cts

@@ -1,4 +1,90 @@
+import { L as LegalPolicyOptions } from '../types--kyI7OOR.cjs';
+import { ReactNode } from 'react';
+
+/**
+ * React hook to reactively subscribe to a consent category.
+ *
+ * @param category - Category ID (e.g. 'analytics', 'marketing')
+ * @returns boolean indicating if the category is allowed
+ */
 declare function useConsent(category: string): boolean;
+/**
+ * React hook to reactively subscribe to a specific service.
+ *
+ * @param serviceId - Service ID (e.g. 'ga4', 'youtube')
+ * @returns boolean indicating if the service is allowed
+ */
 declare function useConsentService(serviceId: string): boolean;
+/**
+ * React hook to reactively subscribe to the cookie consent library's active locale.
+ */
+declare function useConsentLocale(): string;
+/**
+ * Zero-boilerplate React hook to synchronize parent application i18n state
+ * (such as react-i18next i18n.language or next-intl locale) with the consent library.
+ */
+declare function useSyncConsentLocale(locale?: string): void;
+/**
+ * React hook to check if Global Privacy Control (GPC) or Do Not Track (DNT) signal is active.
+ */
+declare function useGpc(): boolean;
+interface ConsentGateFallbackContext {
+    category?: string;
+    service?: string;
+    openPreferences: () => void;
+}
+interface ConsentGateProps {
+    category?: string;
+    service?: string;
+    fallback?: ReactNode | ((context: ConsentGateFallbackContext) => ReactNode);
+    children?: ReactNode;
+}
+/**
+ * Declarative React Component to conditionally render content/media based on consent status.
+ *
+ * @example
+ * ```tsx
+ * <ConsentGate
+ *   category="marketing"
+ *   fallback={(
+ *     <div className="consent-placeholder">
+ *       <p>Este vídeo requiere cookies de marketing para reproducirse.</p>
+ *       <button onClick={() => Consent.openPreferences()}>Configurar permisos</button>
+ *     </div>
+ *   )}
+ * >
+ *   <iframe src="https://www.youtube.com/embed/xyz" />
+ * </ConsentGate>
+ * ```
+ */
+declare function ConsentGate({ category, service, fallback, children, }: ConsentGateProps): any;
+interface CookiePolicyProps {
+    view?: "full" | "table-only" | "summary";
+    options?: LegalPolicyOptions;
+    className?: string;
+    style?: any;
+}
+/**
+ * Declarative React component that renders the full Cookie Policy document or cookie inventory table.
+ */
+declare function CookiePolicy({ view, options, className, style, }: CookiePolicyProps): any;
+interface LegalNoticeProps {
+    options?: LegalPolicyOptions;
+    className?: string;
+    style?: any;
+}
+/**
+ * Declarative React component that renders the Legal Notice (Aviso Legal LSSI-CE art. 10).
+ */
+declare function LegalNotice({ options, className, style }: LegalNoticeProps): any;
+interface PrivacyPolicyProps {
+    options?: LegalPolicyOptions;
+    className?: string;
+    style?: any;
+}
+/**
+ * Declarative React component that renders the GDPR Privacy Policy document.
+ */
+declare function PrivacyPolicy({ options, className, style }: PrivacyPolicyProps): any;
 
-export { useConsent, useConsentService };
+export { ConsentGate, type ConsentGateFallbackContext, type ConsentGateProps, CookiePolicy, type CookiePolicyProps, LegalNotice, type LegalNoticeProps, PrivacyPolicy, type PrivacyPolicyProps, useConsent, useConsentLocale, useConsentService, useGpc, useSyncConsentLocale };

package/dist/wrappers/react.d.ts

@@ -1,4 +1,90 @@
+import { L as LegalPolicyOptions } from '../types--kyI7OOR.js';
+import { ReactNode } from 'react';
+
+/**
+ * React hook to reactively subscribe to a consent category.
+ *
+ * @param category - Category ID (e.g. 'analytics', 'marketing')
+ * @returns boolean indicating if the category is allowed
+ */
 declare function useConsent(category: string): boolean;
+/**
+ * React hook to reactively subscribe to a specific service.
+ *
+ * @param serviceId - Service ID (e.g. 'ga4', 'youtube')
+ * @returns boolean indicating if the service is allowed
+ */
 declare function useConsentService(serviceId: string): boolean;
+/**
+ * React hook to reactively subscribe to the cookie consent library's active locale.
+ */
+declare function useConsentLocale(): string;
+/**
+ * Zero-boilerplate React hook to synchronize parent application i18n state
+ * (such as react-i18next i18n.language or next-intl locale) with the consent library.
+ */
+declare function useSyncConsentLocale(locale?: string): void;
+/**
+ * React hook to check if Global Privacy Control (GPC) or Do Not Track (DNT) signal is active.
+ */
+declare function useGpc(): boolean;
+interface ConsentGateFallbackContext {
+    category?: string;
+    service?: string;
+    openPreferences: () => void;
+}
+interface ConsentGateProps {
+    category?: string;
+    service?: string;
+    fallback?: ReactNode | ((context: ConsentGateFallbackContext) => ReactNode);
+    children?: ReactNode;
+}
+/**
+ * Declarative React Component to conditionally render content/media based on consent status.
+ *
+ * @example
+ * ```tsx
+ * <ConsentGate
+ *   category="marketing"
+ *   fallback={(
+ *     <div className="consent-placeholder">
+ *       <p>Este vídeo requiere cookies de marketing para reproducirse.</p>
+ *       <button onClick={() => Consent.openPreferences()}>Configurar permisos</button>
+ *     </div>
+ *   )}
+ * >
+ *   <iframe src="https://www.youtube.com/embed/xyz" />
+ * </ConsentGate>
+ * ```
+ */
+declare function ConsentGate({ category, service, fallback, children, }: ConsentGateProps): any;
+interface CookiePolicyProps {
+    view?: "full" | "table-only" | "summary";
+    options?: LegalPolicyOptions;
+    className?: string;
+    style?: any;
+}
+/**
+ * Declarative React component that renders the full Cookie Policy document or cookie inventory table.
+ */
+declare function CookiePolicy({ view, options, className, style, }: CookiePolicyProps): any;
+interface LegalNoticeProps {
+    options?: LegalPolicyOptions;
+    className?: string;
+    style?: any;
+}
+/**
+ * Declarative React component that renders the Legal Notice (Aviso Legal LSSI-CE art. 10).
+ */
+declare function LegalNotice({ options, className, style }: LegalNoticeProps): any;
+interface PrivacyPolicyProps {
+    options?: LegalPolicyOptions;
+    className?: string;
+    style?: any;
+}
+/**
+ * Declarative React component that renders the GDPR Privacy Policy document.
+ */
+declare function PrivacyPolicy({ options, className, style }: PrivacyPolicyProps): any;
 
-export { useConsent, useConsentService };
+export { ConsentGate, type ConsentGateFallbackContext, type ConsentGateProps, CookiePolicy, type CookiePolicyProps, LegalNotice, type LegalNoticeProps, PrivacyPolicy, type PrivacyPolicyProps, useConsent, useConsentLocale, useConsentService, useGpc, useSyncConsentLocale };

package/dist/wrappers/react.js

@@ -1,56 +1,26 @@
 import {
-  Consent
-} from "../chunk-FBRP4MSA.js";
-import "../chunk-DDAAVRWG.js";
-
-// src/wrappers/react.ts
-import { useEffect, useState } from "react";
-function useConsent(category) {
-  const [allowed, setAllowed] = useState(() => Consent.has(category));
-  useEffect(() => {
-    const update = () => {
-      setAllowed(Consent.has(category));
-    };
-    update();
-    const unsub1 = Consent.on("consent:changed", update);
-    const unsub2 = Consent.on("consent:accepted", update);
-    const unsub3 = Consent.on("consent:rejected", update);
-    const unsub4 = Consent.on("consent:withdrawn", update);
-    const unsub5 = Consent.on("ready", update);
-    return () => {
-      unsub1();
-      unsub2();
-      unsub3();
-      unsub4();
-      unsub5();
-    };
-  }, [category]);
-  return allowed;
-}
-function useConsentService(serviceId) {
-  const [allowed, setAllowed] = useState(() => Consent.hasService(serviceId));
-  useEffect(() => {
-    const update = () => {
-      setAllowed(Consent.hasService(serviceId));
-    };
-    update();
-    const unsub1 = Consent.on("consent:changed", update);
-    const unsub2 = Consent.on("consent:accepted", update);
-    const unsub3 = Consent.on("consent:rejected", update);
-    const unsub4 = Consent.on("consent:withdrawn", update);
-    const unsub5 = Consent.on("ready", update);
-    return () => {
-      unsub1();
-      unsub2();
-      unsub3();
-      unsub4();
-      unsub5();
-    };
-  }, [serviceId]);
-  return allowed;
-}
+  ConsentGate,
+  CookiePolicy,
+  LegalNotice,
+  PrivacyPolicy,
+  useConsent,
+  useConsentLocale,
+  useConsentService,
+  useGpc,
+  useSyncConsentLocale
+} from "../chunk-UQU54ANZ.js";
+import "../chunk-C5QPXHTH.js";
+import "../chunk-OHOHIAK6.js";
+import "../chunk-Q3FZFXQE.js";
 export {
+  ConsentGate,
+  CookiePolicy,
+  LegalNotice,
+  PrivacyPolicy,
   useConsent,
-  useConsentService
+  useConsentLocale,
+  useConsentService,
+  useGpc,
+  useSyncConsentLocale
 };
 //# sourceMappingURL=react.js.map

package/dist/wrappers/react.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/wrappers/react.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport { Consent } from \"../core/consent-engine.js\";\n\nexport function useConsent(category: string): boolean {\n  const [allowed, setAllowed] = useState<boolean>(() => Consent.has(category));\n\n  useEffect(() => {\n    const update = () => {\n      setAllowed(Consent.has(category));\n    };\n\n    update();\n\n    const unsub1 = Consent.on(\"consent:changed\", update);\n    const unsub2 = Consent.on(\"consent:accepted\", update);\n    const unsub3 = Consent.on(\"consent:rejected\", update);\n    const unsub4 = Consent.on(\"consent:withdrawn\", update);\n    const unsub5 = Consent.on(\"ready\", update);\n\n    return () => {\n      unsub1();\n      unsub2();\n      unsub3();\n      unsub4();\n      unsub5();\n    };\n  }, [category]);\n\n  return allowed;\n}\n\nexport function useConsentService(serviceId: string): boolean {\n  const [allowed, setAllowed] = useState<boolean>(() => Consent.hasService(serviceId));\n\n  useEffect(() => {\n    const update = () => {\n      setAllowed(Consent.hasService(serviceId));\n    };\n\n    update();\n\n    const unsub1 = Consent.on(\"consent:changed\", update);\n    const unsub2 = Consent.on(\"consent:accepted\", update);\n    const unsub3 = Consent.on(\"consent:rejected\", update);\n    const unsub4 = Consent.on(\"consent:withdrawn\", update);\n    const unsub5 = Consent.on(\"ready\", update);\n\n    return () => {\n      unsub1();\n      unsub2();\n      unsub3();\n      unsub4();\n      unsub5();\n    };\n  }, [serviceId]);\n\n  return allowed;\n}\n"],"mappings":";;;;;;AAAA,SAAS,WAAW,gBAAgB;AAG7B,SAAS,WAAW,UAA2B;AACpD,QAAM,CAAC,SAAS,UAAU,IAAI,SAAkB,MAAM,QAAQ,IAAI,QAAQ,CAAC;AAE3E,YAAU,MAAM;AACd,UAAM,SAAS,MAAM;AACnB,iBAAW,QAAQ,IAAI,QAAQ,CAAC;AAAA,IAClC;AAEA,WAAO;AAEP,UAAM,SAAS,QAAQ,GAAG,mBAAmB,MAAM;AACnD,UAAM,SAAS,QAAQ,GAAG,oBAAoB,MAAM;AACpD,UAAM,SAAS,QAAQ,GAAG,oBAAoB,MAAM;AACpD,UAAM,SAAS,QAAQ,GAAG,qBAAqB,MAAM;AACrD,UAAM,SAAS,QAAQ,GAAG,SAAS,MAAM;AAEzC,WAAO,MAAM;AACX,aAAO;AACP,aAAO;AACP,aAAO;AACP,aAAO;AACP,aAAO;AAAA,IACT;AAAA,EACF,GAAG,CAAC,QAAQ,CAAC;AAEb,SAAO;AACT;AAEO,SAAS,kBAAkB,WAA4B;AAC5D,QAAM,CAAC,SAAS,UAAU,IAAI,SAAkB,MAAM,QAAQ,WAAW,SAAS,CAAC;AAEnF,YAAU,MAAM;AACd,UAAM,SAAS,MAAM;AACnB,iBAAW,QAAQ,WAAW,SAAS,CAAC;AAAA,IAC1C;AAEA,WAAO;AAEP,UAAM,SAAS,QAAQ,GAAG,mBAAmB,MAAM;AACnD,UAAM,SAAS,QAAQ,GAAG,oBAAoB,MAAM;AACpD,UAAM,SAAS,QAAQ,GAAG,oBAAoB,MAAM;AACpD,UAAM,SAAS,QAAQ,GAAG,qBAAqB,MAAM;AACrD,UAAM,SAAS,QAAQ,GAAG,SAAS,MAAM;AAEzC,WAAO,MAAM;AACX,aAAO;AACP,aAAO;AACP,aAAO;AACP,aAAO;AACP,aAAO;AAAA,IACT;AAAA,EACF,GAAG,CAAC,SAAS,CAAC;AAEd,SAAO;AACT;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}