@grainql/analytics-web 2.8.0 → 3.0.0

package/dist/cjs/react/hooks/useConsent.js.map

@@ -1 +1 @@
-{"version":3,"file":"useConsent.js","sourceRoot":"","sources":["../../../../src/react/hooks/useConsent.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMH,gCAyDC;AA7DD,6CAA+B;AAC/B,2DAAwD;AAGxD,SAAgB,UAAU;IACxB,MAAM,MAAM,GAAG,IAAA,qCAAiB,GAAE,CAAC;IACnC,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAsB,IAAI,CAAC,CAAC;IAElF,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,4BAA4B;QAC5B,MAAM,YAAY,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;QAC9C,eAAe,CAAC,YAAY,CAAC,CAAC;QAE9B,6BAA6B;QAC7B,MAAM,QAAQ,GAAG,CAAC,KAAmB,EAAE,EAAE;YACvC,eAAe,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC,CAAC;QAEF,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QAEjC,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,MAAM,YAAY,GAAG,KAAK,CAAC,WAAW,CACpC,CAAC,UAAqB,EAAE,EAAE;QACxB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAClC,CAAC;IACH,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,MAAM,aAAa,GAAG,KAAK,CAAC,WAAW,CACrC,CAAC,UAAqB,EAAE,EAAE;QACxB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,CAClC,CAAC,QAAiB,EAAE,EAAE;QACpB,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC1B,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,OAAO;QACL,YAAY;QACZ,YAAY;QACZ,aAAa;QACb,UAAU;QACV,SAAS,EAAE,YAAY,EAAE,OAAO,IAAI,KAAK;QACzC,UAAU,EAAE,YAAY,EAAE,UAAU,IAAI,EAAE;KAC3C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"useConsent.js","sourceRoot":"","sources":["../../../../src/react/hooks/useConsent.ts"],"names":[],"mappings":"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"}

package/dist/consent.d.ts

@@ -1,8 +1,13 @@
 /**
- * Consent management for Grain Analytics
- * Handles GDPR-compliant consent tracking and state management
+ * Consent management for Grain Analytics v2.0
+ * Privacy-first, cookie-less by default
+ *
+ * Consent Modes:
+ * - cookieless: Default mode, daily rotating IDs, no consent needed
+ * - gdpr-strict: Requires explicit consent, falls back to cookieless
+ * - gdpr-opt-out: Permanent IDs by default, cookieless on opt-out
  */
-export type ConsentMode = 'opt-in' | 'opt-out' | 'disabled';
+export type ConsentMode = 'cookieless' | 'gdpr-strict' | 'gdpr-opt-out';
 export interface ConsentState {
     granted: boolean;
     categories: string[];
@@ -13,6 +18,7 @@ export declare const DEFAULT_CONSENT_CATEGORIES: string[];
 export declare const CONSENT_VERSION = "1.0.0";
 /**
  * Consent manager for handling user consent state
+ * v2.0: Cookie-less by default, privacy-first approach
  */
 export declare class ConsentManager {
     private consentState;
@@ -23,9 +29,8 @@ export declare class ConsentManager {
     /**
      * Load consent state from localStorage
      *
-     * GDPR Compliance: In opt-in mode, we can use localStorage for consent preferences
-     * since storing consent choices is a legitimate interest and necessary for compliance.
-     * The consent preference itself is not tracking data.
+     * GDPR Compliance: localStorage only used for storing consent preferences
+     * (not for tracking), which is a legitimate interest for compliance.
      */
     private loadConsentState;
     /**
@@ -45,11 +50,28 @@ export declare class ConsentManager {
      */
     getConsentState(): ConsentState | null;
     /**
-     * Check if user has granted consent
+     * Check if user has granted consent for permanent IDs
      */
     hasConsent(category?: string): boolean;
+    /**
+     * Check if permanent IDs are allowed
+     */
+    shouldUsePermanentId(): boolean;
+    /**
+     * Check if we should strip query parameters from URLs
+     * Query params stripped unless:
+     * - Mode is gdpr-opt-out, OR
+     * - Mode is gdpr-strict AND consent given
+     */
+    shouldStripQueryParams(): boolean;
+    /**
+     * Check if we can track events (always true in v2.0)
+     * Even cookieless mode allows basic analytics with daily IDs
+     */
+    canTrack(): boolean;
     /**
      * Check if we should wait for consent before tracking
+     * Only relevant for GDPR Strict mode
      */
     shouldWaitForConsent(): boolean;
     /**
@@ -68,5 +90,14 @@ export declare class ConsentManager {
      * Clear all consent data
      */
     clearConsent(): void;
+    /**
+     * Get current consent mode
+     */
+    getConsentMode(): ConsentMode;
+    /**
+     * Get ID mode based on consent state
+     * Returns 'cookieless' or 'permanent'
+     */
+    getIdMode(): 'cookieless' | 'permanent';
 }
 //# sourceMappingURL=consent.d.ts.map

package/dist/consent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../src/consent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,0BAA0B,UAA2C,CAAC;AACnF,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAA4C;gBAEjD,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAE,WAAuB;IAMlE;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IA2BxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAczC;;OAEG;IACH,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IA8B1C;;OAEG;IACH,eAAe,IAAI,YAAY,GAAG,IAAI;IAItC;;OAEG;IACH,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAwBtC;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAI1D;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAO7D;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACH,YAAY,IAAI,IAAI;CAUrB"}
+{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../src/consent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,aAAa,GAAG,cAAc,CAAC;AAExE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,0BAA0B,UAA2C,CAAC;AACnF,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAA4C;gBAEjD,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAE,WAA0B;IAMrE;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IA2BxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAczC;;OAEG;IACH,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IA8B1C;;OAEG;IACH,eAAe,IAAI,YAAY,GAAG,IAAI;IAItC;;OAEG;IACH,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAiCtC;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;;;;OAKG;IACH,sBAAsB,IAAI,OAAO;IAgBjC;;;OAGG;IACH,QAAQ,IAAI,OAAO;IAInB;;;OAGG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAI1D;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAO7D;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACH,YAAY,IAAI,IAAI;IAWpB;;OAEG;IACH,cAAc,IAAI,WAAW;IAI7B;;;OAGG;IACH,SAAS,IAAI,YAAY,GAAG,WAAW;CAGxC"}

package/dist/consent.js

@@ -1,7 +1,12 @@
 "use strict";
 /**
- * Consent management for Grain Analytics
- * Handles GDPR-compliant consent tracking and state management
+ * Consent management for Grain Analytics v2.0
+ * Privacy-first, cookie-less by default
+ *
+ * Consent Modes:
+ * - cookieless: Default mode, daily rotating IDs, no consent needed
+ * - gdpr-strict: Requires explicit consent, falls back to cookieless
+ * - gdpr-opt-out: Permanent IDs by default, cookieless on opt-out
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConsentManager = exports.CONSENT_VERSION = exports.DEFAULT_CONSENT_CATEGORIES = void 0;
@@ -9,9 +14,10 @@ exports.DEFAULT_CONSENT_CATEGORIES = ['necessary', 'analytics', 'functional'];
 exports.CONSENT_VERSION = '1.0.0';
 /**
  * Consent manager for handling user consent state
+ * v2.0: Cookie-less by default, privacy-first approach
  */
 class ConsentManager {
-    constructor(tenantId, consentMode = 'opt-out') {
+    constructor(tenantId, consentMode = 'cookieless') {
         this.consentState = null;
         this.listeners = [];
         this.consentMode = consentMode;
@@ -21,9 +27,8 @@ class ConsentManager {
     /**
      * Load consent state from localStorage
      *
-     * GDPR Compliance: In opt-in mode, we can use localStorage for consent preferences
-     * since storing consent choices is a legitimate interest and necessary for compliance.
-     * The consent preference itself is not tracking data.
+     * GDPR Compliance: localStorage only used for storing consent preferences
+     * (not for tracking), which is a legitimate interest for compliance.
      */
     loadConsentState() {
         if (typeof window === 'undefined')
@@ -37,8 +42,8 @@ class ConsentManager {
                     timestamp: new Date(parsed.timestamp),
                 };
             }
-            else if (this.consentMode === 'opt-out' || this.consentMode === 'disabled') {
-                // Auto-grant consent for opt-out and disabled modes
+            else if (this.consentMode === 'gdpr-opt-out') {
+                // Auto-grant consent for opt-out mode (user hasn't opted out yet)
                 this.consentState = {
                     granted: true,
                     categories: exports.DEFAULT_CONSENT_CATEGORIES,
@@ -47,10 +52,10 @@ class ConsentManager {
                 };
                 this.saveConsentState();
             }
-            // Note: In opt-in mode without stored consent, consentState remains null (no consent)
+            // Note: cookieless and gdpr-strict modes without stored consent → no permanent tracking
         }
         catch (error) {
-            // Silent failure - consent will be requested when needed
+            // Silent failure - will use cookieless mode by default
         }
     }
     /**
@@ -120,32 +125,73 @@ class ConsentManager {
         return this.consentState ? { ...this.consentState } : null;
     }
     /**
-     * Check if user has granted consent
+     * Check if user has granted consent for permanent IDs
      */
     hasConsent(category) {
-        // Disabled mode always returns true (no consent required)
-        if (this.consentMode === 'disabled') {
-            return true;
+        // Cookie-less mode: no consent needed (no permanent tracking)
+        if (this.consentMode === 'cookieless') {
+            return false; // No permanent IDs
         }
-        // No consent state in opt-in mode means no consent
-        if (this.consentMode === 'opt-in' && !this.consentState) {
-            return false;
+        // GDPR Strict: requires explicit consent
+        if (this.consentMode === 'gdpr-strict') {
+            if (!this.consentState?.granted) {
+                return false;
+            }
         }
-        // Check consent state
-        if (!this.consentState?.granted) {
-            return false;
+        // GDPR Opt-out: consent by default unless explicitly revoked
+        if (this.consentMode === 'gdpr-opt-out') {
+            // If no state, assume consent (opt-out model)
+            if (!this.consentState) {
+                return true;
+            }
+            // Check if consent was revoked
+            if (!this.consentState.granted) {
+                return false;
+            }
         }
         // Check specific category if provided
-        if (category) {
+        if (category && this.consentState) {
             return this.consentState.categories.includes(category);
         }
-        return true;
+        return this.consentState?.granted ?? (this.consentMode === 'gdpr-opt-out');
+    }
+    /**
+     * Check if permanent IDs are allowed
+     */
+    shouldUsePermanentId() {
+        return this.hasConsent();
+    }
+    /**
+     * Check if we should strip query parameters from URLs
+     * Query params stripped unless:
+     * - Mode is gdpr-opt-out, OR
+     * - Mode is gdpr-strict AND consent given
+     */
+    shouldStripQueryParams() {
+        if (this.consentMode === 'cookieless') {
+            return true; // Always strip in cookieless mode
+        }
+        if (this.consentMode === 'gdpr-strict') {
+            return !this.hasConsent(); // Strip unless consented
+        }
+        if (this.consentMode === 'gdpr-opt-out') {
+            return false; // Don't strip in opt-out mode
+        }
+        return true; // Default: strip
+    }
+    /**
+     * Check if we can track events (always true in v2.0)
+     * Even cookieless mode allows basic analytics with daily IDs
+     */
+    canTrack() {
+        return true; // All modes allow some form of tracking
     }
     /**
      * Check if we should wait for consent before tracking
+     * Only relevant for GDPR Strict mode
      */
     shouldWaitForConsent() {
-        return this.consentMode === 'opt-in' && !this.consentState?.granted;
+        return this.consentMode === 'gdpr-strict' && !this.consentState?.granted;
     }
     /**
      * Add consent change listener
@@ -191,6 +237,19 @@ class ConsentManager {
             // Silent failure - consent state may not be fully cleared
         }
     }
+    /**
+     * Get current consent mode
+     */
+    getConsentMode() {
+        return this.consentMode;
+    }
+    /**
+     * Get ID mode based on consent state
+     * Returns 'cookieless' or 'permanent'
+     */
+    getIdMode() {
+        return this.shouldUsePermanentId() ? 'permanent' : 'cookieless';
+    }
 }
 exports.ConsentManager = ConsentManager;
 //# sourceMappingURL=consent.js.map

package/dist/esm/consent.d.ts

@@ -1,8 +1,13 @@
 /**
- * Consent management for Grain Analytics
- * Handles GDPR-compliant consent tracking and state management
+ * Consent management for Grain Analytics v2.0
+ * Privacy-first, cookie-less by default
+ *
+ * Consent Modes:
+ * - cookieless: Default mode, daily rotating IDs, no consent needed
+ * - gdpr-strict: Requires explicit consent, falls back to cookieless
+ * - gdpr-opt-out: Permanent IDs by default, cookieless on opt-out
  */
-export type ConsentMode = 'opt-in' | 'opt-out' | 'disabled';
+export type ConsentMode = 'cookieless' | 'gdpr-strict' | 'gdpr-opt-out';
 export interface ConsentState {
     granted: boolean;
     categories: string[];
@@ -13,6 +18,7 @@ export declare const DEFAULT_CONSENT_CATEGORIES: string[];
 export declare const CONSENT_VERSION = "1.0.0";
 /**
  * Consent manager for handling user consent state
+ * v2.0: Cookie-less by default, privacy-first approach
  */
 export declare class ConsentManager {
     private consentState;
@@ -23,9 +29,8 @@ export declare class ConsentManager {
     /**
      * Load consent state from localStorage
      *
-     * GDPR Compliance: In opt-in mode, we can use localStorage for consent preferences
-     * since storing consent choices is a legitimate interest and necessary for compliance.
-     * The consent preference itself is not tracking data.
+     * GDPR Compliance: localStorage only used for storing consent preferences
+     * (not for tracking), which is a legitimate interest for compliance.
      */
     private loadConsentState;
     /**
@@ -45,11 +50,28 @@ export declare class ConsentManager {
      */
     getConsentState(): ConsentState | null;
     /**
-     * Check if user has granted consent
+     * Check if user has granted consent for permanent IDs
      */
     hasConsent(category?: string): boolean;
+    /**
+     * Check if permanent IDs are allowed
+     */
+    shouldUsePermanentId(): boolean;
+    /**
+     * Check if we should strip query parameters from URLs
+     * Query params stripped unless:
+     * - Mode is gdpr-opt-out, OR
+     * - Mode is gdpr-strict AND consent given
+     */
+    shouldStripQueryParams(): boolean;
+    /**
+     * Check if we can track events (always true in v2.0)
+     * Even cookieless mode allows basic analytics with daily IDs
+     */
+    canTrack(): boolean;
     /**
      * Check if we should wait for consent before tracking
+     * Only relevant for GDPR Strict mode
      */
     shouldWaitForConsent(): boolean;
     /**
@@ -68,5 +90,14 @@ export declare class ConsentManager {
      * Clear all consent data
      */
     clearConsent(): void;
+    /**
+     * Get current consent mode
+     */
+    getConsentMode(): ConsentMode;
+    /**
+     * Get ID mode based on consent state
+     * Returns 'cookieless' or 'permanent'
+     */
+    getIdMode(): 'cookieless' | 'permanent';
 }
 //# sourceMappingURL=consent.d.ts.map

package/dist/esm/consent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../../src/consent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,0BAA0B,UAA2C,CAAC;AACnF,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAA4C;gBAEjD,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAE,WAAuB;IAMlE;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IA2BxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAczC;;OAEG;IACH,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IA8B1C;;OAEG;IACH,eAAe,IAAI,YAAY,GAAG,IAAI;IAItC;;OAEG;IACH,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAwBtC;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAI1D;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAO7D;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACH,YAAY,IAAI,IAAI;CAUrB"}
+{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../../src/consent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,aAAa,GAAG,cAAc,CAAC;AAExE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,0BAA0B,UAA2C,CAAC;AACnF,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAA4C;gBAEjD,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAE,WAA0B;IAMrE;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IA2BxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAczC;;OAEG;IACH,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IA8B1C;;OAEG;IACH,eAAe,IAAI,YAAY,GAAG,IAAI;IAItC;;OAEG;IACH,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAiCtC;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;;;;OAKG;IACH,sBAAsB,IAAI,OAAO;IAgBjC;;;OAGG;IACH,QAAQ,IAAI,OAAO;IAInB;;;OAGG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAI1D;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAO7D;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACH,YAAY,IAAI,IAAI;IAWpB;;OAEG;IACH,cAAc,IAAI,WAAW;IAI7B;;;OAGG;IACH,SAAS,IAAI,YAAY,GAAG,WAAW;CAGxC"}

package/dist/esm/consent.js

@@ -1,14 +1,20 @@
 /**
- * Consent management for Grain Analytics
- * Handles GDPR-compliant consent tracking and state management
+ * Consent management for Grain Analytics v2.0
+ * Privacy-first, cookie-less by default
+ *
+ * Consent Modes:
+ * - cookieless: Default mode, daily rotating IDs, no consent needed
+ * - gdpr-strict: Requires explicit consent, falls back to cookieless
+ * - gdpr-opt-out: Permanent IDs by default, cookieless on opt-out
  */
 export const DEFAULT_CONSENT_CATEGORIES = ['necessary', 'analytics', 'functional'];
 export const CONSENT_VERSION = '1.0.0';
 /**
  * Consent manager for handling user consent state
+ * v2.0: Cookie-less by default, privacy-first approach
  */
 export class ConsentManager {
-    constructor(tenantId, consentMode = 'opt-out') {
+    constructor(tenantId, consentMode = 'cookieless') {
         this.consentState = null;
         this.listeners = [];
         this.consentMode = consentMode;
@@ -18,9 +24,8 @@ export class ConsentManager {
     /**
      * Load consent state from localStorage
      *
-     * GDPR Compliance: In opt-in mode, we can use localStorage for consent preferences
-     * since storing consent choices is a legitimate interest and necessary for compliance.
-     * The consent preference itself is not tracking data.
+     * GDPR Compliance: localStorage only used for storing consent preferences
+     * (not for tracking), which is a legitimate interest for compliance.
      */
     loadConsentState() {
         if (typeof window === 'undefined')
@@ -34,8 +39,8 @@ export class ConsentManager {
                     timestamp: new Date(parsed.timestamp),
                 };
             }
-            else if (this.consentMode === 'opt-out' || this.consentMode === 'disabled') {
-                // Auto-grant consent for opt-out and disabled modes
+            else if (this.consentMode === 'gdpr-opt-out') {
+                // Auto-grant consent for opt-out mode (user hasn't opted out yet)
                 this.consentState = {
                     granted: true,
                     categories: DEFAULT_CONSENT_CATEGORIES,
@@ -44,10 +49,10 @@ export class ConsentManager {
                 };
                 this.saveConsentState();
             }
-            // Note: In opt-in mode without stored consent, consentState remains null (no consent)
+            // Note: cookieless and gdpr-strict modes without stored consent → no permanent tracking
         }
         catch (error) {
-            // Silent failure - consent will be requested when needed
+            // Silent failure - will use cookieless mode by default
         }
     }
     /**
@@ -117,32 +122,73 @@ export class ConsentManager {
         return this.consentState ? { ...this.consentState } : null;
     }
     /**
-     * Check if user has granted consent
+     * Check if user has granted consent for permanent IDs
      */
     hasConsent(category) {
-        // Disabled mode always returns true (no consent required)
-        if (this.consentMode === 'disabled') {
-            return true;
+        // Cookie-less mode: no consent needed (no permanent tracking)
+        if (this.consentMode === 'cookieless') {
+            return false; // No permanent IDs
         }
-        // No consent state in opt-in mode means no consent
-        if (this.consentMode === 'opt-in' && !this.consentState) {
-            return false;
+        // GDPR Strict: requires explicit consent
+        if (this.consentMode === 'gdpr-strict') {
+            if (!this.consentState?.granted) {
+                return false;
+            }
         }
-        // Check consent state
-        if (!this.consentState?.granted) {
-            return false;
+        // GDPR Opt-out: consent by default unless explicitly revoked
+        if (this.consentMode === 'gdpr-opt-out') {
+            // If no state, assume consent (opt-out model)
+            if (!this.consentState) {
+                return true;
+            }
+            // Check if consent was revoked
+            if (!this.consentState.granted) {
+                return false;
+            }
         }
         // Check specific category if provided
-        if (category) {
+        if (category && this.consentState) {
             return this.consentState.categories.includes(category);
         }
-        return true;
+        return this.consentState?.granted ?? (this.consentMode === 'gdpr-opt-out');
+    }
+    /**
+     * Check if permanent IDs are allowed
+     */
+    shouldUsePermanentId() {
+        return this.hasConsent();
+    }
+    /**
+     * Check if we should strip query parameters from URLs
+     * Query params stripped unless:
+     * - Mode is gdpr-opt-out, OR
+     * - Mode is gdpr-strict AND consent given
+     */
+    shouldStripQueryParams() {
+        if (this.consentMode === 'cookieless') {
+            return true; // Always strip in cookieless mode
+        }
+        if (this.consentMode === 'gdpr-strict') {
+            return !this.hasConsent(); // Strip unless consented
+        }
+        if (this.consentMode === 'gdpr-opt-out') {
+            return false; // Don't strip in opt-out mode
+        }
+        return true; // Default: strip
+    }
+    /**
+     * Check if we can track events (always true in v2.0)
+     * Even cookieless mode allows basic analytics with daily IDs
+     */
+    canTrack() {
+        return true; // All modes allow some form of tracking
     }
     /**
      * Check if we should wait for consent before tracking
+     * Only relevant for GDPR Strict mode
      */
     shouldWaitForConsent() {
-        return this.consentMode === 'opt-in' && !this.consentState?.granted;
+        return this.consentMode === 'gdpr-strict' && !this.consentState?.granted;
     }
     /**
      * Add consent change listener
@@ -188,5 +234,18 @@ export class ConsentManager {
             // Silent failure - consent state may not be fully cleared
         }
     }
+    /**
+     * Get current consent mode
+     */
+    getConsentMode() {
+        return this.consentMode;
+    }
+    /**
+     * Get ID mode based on consent state
+     * Returns 'cookieless' or 'permanent'
+     */
+    getIdMode() {
+        return this.shouldUsePermanentId() ? 'permanent' : 'cookieless';
+    }
 }
 //# sourceMappingURL=consent.js.map

package/dist/esm/consent.js.map

@@ -1 +1 @@
-{"version":3,"file":"consent.js","sourceRoot":"","sources":["../../src/consent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"consent.js","sourceRoot":"","sources":["../../src/consent.ts"],"names":[],"mappings":"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"}

package/dist/esm/id-manager.d.ts

@@ -0,0 +1,66 @@
+/**
+ * ID Manager for Grain Analytics
+ * Generates and manages user IDs based on consent mode
+ *
+ * Privacy-first implementation:
+ * - Cookie-less mode: Daily rotating IDs (no persistence)
+ * - GDPR Strict: Permanent IDs only with consent
+ * - GDPR Opt-out: Permanent IDs by default
+ */
+export type IdMode = 'cookieless' | 'permanent';
+export interface IdConfig {
+    mode: IdMode;
+    tenantId: string;
+    useLocalStorage?: boolean;
+}
+/**
+ * ID Manager class
+ * Handles both daily rotating IDs and permanent IDs
+ */
+export declare class IdManager {
+    private config;
+    private cachedDailyId;
+    private dailyIdDate;
+    private permanentId;
+    constructor(config: IdConfig);
+    /**
+     * Generate a daily rotating ID
+     * Rotates at midnight in user's local timezone
+     * Provides same-day continuity without persistent tracking
+     */
+    generateDailyRotatingId(): string;
+    /**
+     * Generate or retrieve permanent user ID
+     * Only used when consent is given
+     */
+    generatePermanentId(): string;
+    /**
+     * Get the current user ID based on mode
+     */
+    getCurrentUserId(): string;
+    /**
+     * Switch ID mode (e.g., when consent is granted/revoked)
+     */
+    setMode(mode: IdMode): void;
+    /**
+     * Load permanent ID from localStorage
+     */
+    private loadPermanentId;
+    /**
+     * Save permanent ID to localStorage
+     */
+    private savePermanentId;
+    /**
+     * Clear permanent ID from localStorage
+     */
+    private clearPermanentId;
+    /**
+     * Get info about current ID for debugging
+     */
+    getIdInfo(): {
+        mode: IdMode;
+        id: string;
+        isDailyRotating: boolean;
+    };
+}
+//# sourceMappingURL=id-manager.d.ts.map

package/dist/esm/id-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-manager.d.ts","sourceRoot":"","sources":["../../src/id-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,MAAM,GAAG,YAAY,GAAG,WAAW,CAAC;AAEhD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AA2DD;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,WAAW,CAAuB;gBAE9B,MAAM,EAAE,QAAQ;IAS5B;;;;OAIG;IACH,uBAAuB,IAAI,MAAM;IAoBjC;;;OAGG;IACH,mBAAmB,IAAI,MAAM;IAyB7B;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAQ1B;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAkB3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAWvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,SAAS,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,OAAO,CAAA;KAAE;CAQpE"}