flowgrid-sdk 1.7.10 → 1.8.1

package/dist/index.d.ts

@@ -46,7 +46,7 @@ export { getCookie, getVisitorId, getSessionId, getWebId, getUTM, getUTMHistory,
 export type { FlowGridUTM, FlowGridUTMHistoryEntry, } from "./lib/utils/storage";
 export { IdentityManager } from "./lib/utils/identity";
 export type { IdentityConfig, ServerCookieReader, } from "./lib/utils/identity";
-export { ConsentManager, wireDeclarativeBanners } from "./lib/consent";
+export { ConsentManager, wireDeclarativeBanners, grantConsentOnAuth } from "./lib/consent";
 export type { ConsentConfig, ConsentPreferences, ConsentCategory as ConsentCategoryType, ConsentChangeEvent, CookieBannerConfig, CookieBannerTheme, WireDeclarativeBannersOptions, DeclarativeBannersHandle, } from "./lib/consent";
 export { getOrCreateAnonId, getOrCreateCartId, resetCartId, setupConsent, attachConsentBanner, renderConsentBanner, } from "./lib/helpers";
 export type { ConsentBannerOptions, ConsentBannerHandle, RenderConsentBannerOptions, } from "./lib/helpers";

package/dist/index.js

@@ -31,8 +31,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getOrCreateCartId = exports.getOrCreateAnonId = exports.wireDeclarativeBanners = exports.ConsentManager = exports.IdentityManager = exports.getUTMHistory = exports.getUTM = exports.getWebId = exports.getSessionId = exports.getVisitorId = exports.getCookie = exports.Forecasting = exports.SecurityAnalytics = exports.AlertsAnalytics = exports.PathAnalytics = exports.AcquisitionAnalytics = exports.SupportAnalytics = exports.MultiPathFunnels = exports.Monetization = exports.ChurnAnalytics = exports.Cohorts = exports.Engagement = exports.FlowGridTransport = exports.Subscriptions = exports.SearchAnalytics = exports.CustomerLTV = exports.WishlistTracking = exports.Promotions = exports.Refunds = exports.Purchases = exports.Checkout = exports.CartTracking = exports.Products = exports.SessionReplay = exports.Performance = exports.PerformanceTracking = exports.Heatmaps = exports.Attribution = exports.Retention = exports.Funnels = exports.Identify = exports.Events = exports.Sessions = exports.PageViews = exports.Experiment = exports.TrackPrompt = exports.TrackFeature = exports.Activation = exports.default = exports.FlowGrid = void 0;
-exports.renderConsentBanner = exports.attachConsentBanner = exports.setupConsent = exports.resetCartId = void 0;
+exports.getOrCreateAnonId = exports.grantConsentOnAuth = exports.wireDeclarativeBanners = exports.ConsentManager = exports.IdentityManager = exports.getUTMHistory = exports.getUTM = exports.getWebId = exports.getSessionId = exports.getVisitorId = exports.getCookie = exports.Forecasting = exports.SecurityAnalytics = exports.AlertsAnalytics = exports.PathAnalytics = exports.AcquisitionAnalytics = exports.SupportAnalytics = exports.MultiPathFunnels = exports.Monetization = exports.ChurnAnalytics = exports.Cohorts = exports.Engagement = exports.FlowGridTransport = exports.Subscriptions = exports.SearchAnalytics = exports.CustomerLTV = exports.WishlistTracking = exports.Promotions = exports.Refunds = exports.Purchases = exports.Checkout = exports.CartTracking = exports.Products = exports.SessionReplay = exports.Performance = exports.PerformanceTracking = exports.Heatmaps = exports.Attribution = exports.Retention = exports.Funnels = exports.Identify = exports.Events = exports.Sessions = exports.PageViews = exports.Experiment = exports.TrackPrompt = exports.TrackFeature = exports.Activation = exports.default = exports.FlowGrid = void 0;
+exports.renderConsentBanner = exports.attachConsentBanner = exports.setupConsent = exports.resetCartId = exports.getOrCreateCartId = void 0;
 // ============================================================================
 // UNIFIED SDK CLASS
 // ============================================================================
@@ -117,6 +117,7 @@ Object.defineProperty(exports, "IdentityManager", { enumerable: true, get: funct
 var consent_1 = require("./lib/consent");
 Object.defineProperty(exports, "ConsentManager", { enumerable: true, get: function () { return consent_1.ConsentManager; } });
 Object.defineProperty(exports, "wireDeclarativeBanners", { enumerable: true, get: function () { return consent_1.wireDeclarativeBanners; } });
+Object.defineProperty(exports, "grantConsentOnAuth", { enumerable: true, get: function () { return consent_1.grantConsentOnAuth; } });
 // ============================================================================
 // DROP-IN HELPERS
 //

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;;;;;AAEH,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,2CAA0C;AAAjC,oGAAA,QAAQ,OAAA;AACjB,2CAAyC;AAAhC,oHAAA,OAAO,OAAA;AAGhB,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,4CAK6B;AAJ3B,kGAAA,UAAU,OAAA;AACV,oGAAA,YAAY,OAAA;AACZ,mGAAA,WAAW,OAAA;AACX,kGAAA,UAAU,OAAA;AA8BZ,+EAA+E;AAC/E,4BAA4B;AAC5B,+EAA+E;AAE/E,sDAYkC;AAXhC,sGAAA,SAAS,OAAA;AACT,qGAAA,QAAQ,OAAA;AACR,mGAAA,MAAM,OAAA;AACN,qGAAA,QAAQ,OAAA;AACR,oGAAA,OAAO,OAAA;AACP,sGAAA,SAAS,OAAA;AACT,wGAAA,WAAW,OAAA;AACX,qGAAA,QAAQ,OAAA;AACR,gHAAA,mBAAmB,OAAA;AACnB,wGAAA,mBAAmB,OAAe;AAClC,0GAAA,aAAa,OAAA;AAiEf,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,sDAWkC;AAVhC,qGAAA,QAAQ,OAAA;AACR,yGAAA,YAAY,OAAA;AACZ,qGAAA,QAAQ,OAAA;AACR,sGAAA,SAAS,OAAA;AACT,oGAAA,OAAO,OAAA;AACP,uGAAA,UAAU,OAAA;AACV,6GAAA,gBAAgB,OAAA;AAChB,wGAAA,WAAW,OAAA;AACX,4GAAA,eAAe,OAAA;AACf,0GAAA,aAAa,OAAA;AAqDf,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E,sDAAsD;AACtD,oDAA2D;AAAlD,8GAAA,iBAAiB,OAAA;AAG1B,wDAYmC;AAXjC,wGAAA,UAAU,OAAA;AACV,qGAAA,OAAO,OAAA;AACP,4GAAA,cAAc,OAAA;AACd,0GAAA,YAAY,OAAA;AACZ,8GAAA,gBAAgB,OAAA;AAChB,8GAAA,gBAAgB,OAAA;AAChB,kHAAA,oBAAoB,OAAA;AACpB,2GAAA,aAAa,OAAA;AACb,6GAAA,eAAe,OAAA;AACf,+GAAA,iBAAiB,OAAA;AACjB,yGAAA,WAAW,OAAA;AAwNb,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,kFAAkF;AAClF,+CAO6B;AAN3B,oGAAA,SAAS,OAAA;AACT,uGAAA,YAAY,OAAA;AACZ,uGAAA,YAAY,OAAA;AACZ,mGAAA,QAAQ,OAAA;AACR,iGAAA,MAAM,OAAA;AACN,wGAAA,aAAa,OAAA;AAQf,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,iDAAuD;AAA9C,2GAAA,eAAe,OAAA;AAOxB,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,yCAAuE;AAA9D,yGAAA,cAAc,OAAA;AAAE,iHAAA,sBAAsB,OAAA;AAa/C,+EAA+E;AAC/E,kBAAkB;AAClB,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,+EAA+E;AAE/E,yCAOuB;AANrB,4GAAA,iBAAiB,OAAA;AACjB,4GAAA,iBAAiB,OAAA;AACjB,sGAAA,WAAW,OAAA;AACX,uGAAA,YAAY,OAAA;AACZ,8GAAA,mBAAmB,OAAA;AACnB,8GAAA,mBAAmB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;;;;;AAEH,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,2CAA0C;AAAjC,oGAAA,QAAQ,OAAA;AACjB,2CAAyC;AAAhC,oHAAA,OAAO,OAAA;AAGhB,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,4CAK6B;AAJ3B,kGAAA,UAAU,OAAA;AACV,oGAAA,YAAY,OAAA;AACZ,mGAAA,WAAW,OAAA;AACX,kGAAA,UAAU,OAAA;AA8BZ,+EAA+E;AAC/E,4BAA4B;AAC5B,+EAA+E;AAE/E,sDAYkC;AAXhC,sGAAA,SAAS,OAAA;AACT,qGAAA,QAAQ,OAAA;AACR,mGAAA,MAAM,OAAA;AACN,qGAAA,QAAQ,OAAA;AACR,oGAAA,OAAO,OAAA;AACP,sGAAA,SAAS,OAAA;AACT,wGAAA,WAAW,OAAA;AACX,qGAAA,QAAQ,OAAA;AACR,gHAAA,mBAAmB,OAAA;AACnB,wGAAA,mBAAmB,OAAe;AAClC,0GAAA,aAAa,OAAA;AAiEf,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,sDAWkC;AAVhC,qGAAA,QAAQ,OAAA;AACR,yGAAA,YAAY,OAAA;AACZ,qGAAA,QAAQ,OAAA;AACR,sGAAA,SAAS,OAAA;AACT,oGAAA,OAAO,OAAA;AACP,uGAAA,UAAU,OAAA;AACV,6GAAA,gBAAgB,OAAA;AAChB,wGAAA,WAAW,OAAA;AACX,4GAAA,eAAe,OAAA;AACf,0GAAA,aAAa,OAAA;AAqDf,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E,sDAAsD;AACtD,oDAA2D;AAAlD,8GAAA,iBAAiB,OAAA;AAG1B,wDAYmC;AAXjC,wGAAA,UAAU,OAAA;AACV,qGAAA,OAAO,OAAA;AACP,4GAAA,cAAc,OAAA;AACd,0GAAA,YAAY,OAAA;AACZ,8GAAA,gBAAgB,OAAA;AAChB,8GAAA,gBAAgB,OAAA;AAChB,kHAAA,oBAAoB,OAAA;AACpB,2GAAA,aAAa,OAAA;AACb,6GAAA,eAAe,OAAA;AACf,+GAAA,iBAAiB,OAAA;AACjB,yGAAA,WAAW,OAAA;AAwNb,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,kFAAkF;AAClF,+CAO6B;AAN3B,oGAAA,SAAS,OAAA;AACT,uGAAA,YAAY,OAAA;AACZ,uGAAA,YAAY,OAAA;AACZ,mGAAA,QAAQ,OAAA;AACR,iGAAA,MAAM,OAAA;AACN,wGAAA,aAAa,OAAA;AAQf,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,iDAAuD;AAA9C,2GAAA,eAAe,OAAA;AAOxB,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,yCAA2F;AAAlF,yGAAA,cAAc,OAAA;AAAE,iHAAA,sBAAsB,OAAA;AAAE,6GAAA,kBAAkB,OAAA;AAanE,+EAA+E;AAC/E,kBAAkB;AAClB,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,+EAA+E;AAE/E,yCAOuB;AANrB,4GAAA,iBAAiB,OAAA;AACjB,4GAAA,iBAAiB,OAAA;AACjB,sGAAA,WAAW,OAAA;AACX,uGAAA,YAAY,OAAA;AACZ,8GAAA,mBAAmB,OAAA;AACnB,8GAAA,mBAAmB,OAAA"}

package/dist/lib/consent/index.d.ts

@@ -29,6 +29,7 @@
  * @see {@link ConsentManager} for the core API.
  */
 export { ConsentManager } from './manager';
+export { grantConsentOnAuth } from './registry';
 export { wireDeclarativeBanners } from './declarativeBanner';
 export type { WireDeclarativeBannersOptions, DeclarativeBannersHandle, } from './declarativeBanner';
 export type { ConsentCategory, ConsentPreferences, ConsentConfig, ConsentChangeEvent, CookieBannerConfig, CookieBannerTheme, } from './types';

package/dist/lib/consent/index.js

@@ -30,9 +30,11 @@
  * @see {@link ConsentManager} for the core API.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.wireDeclarativeBanners = exports.ConsentManager = void 0;
+exports.wireDeclarativeBanners = exports.grantConsentOnAuth = exports.ConsentManager = void 0;
 var manager_1 = require("./manager");
 Object.defineProperty(exports, "ConsentManager", { enumerable: true, get: function () { return manager_1.ConsentManager; } });
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "grantConsentOnAuth", { enumerable: true, get: function () { return registry_1.grantConsentOnAuth; } });
 var declarativeBanner_1 = require("./declarativeBanner");
 Object.defineProperty(exports, "wireDeclarativeBanners", { enumerable: true, get: function () { return declarativeBanner_1.wireDeclarativeBanners; } });
 //# sourceMappingURL=index.js.map

package/dist/lib/consent/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/consent/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;;;AAEH,qCAA2C;AAAlC,yGAAA,cAAc,OAAA;AAEvB,yDAA6D;AAApD,2HAAA,sBAAsB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/consent/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;;;AAEH,qCAA2C;AAAlC,yGAAA,cAAc,OAAA;AACvB,uCAAgD;AAAvC,8GAAA,kBAAkB,OAAA;AAE3B,yDAA6D;AAApD,2HAAA,sBAAsB,OAAA"}

package/dist/lib/consent/manager.js

@@ -48,6 +48,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConsentManager = void 0;
+const registry_1 = require("./registry");
 // ============================================================================
 // DEFAULTS
 // ============================================================================
@@ -124,6 +125,8 @@ class ConsentManager {
             // responsibility — the SDK does not block essential or analytics data,
             // including session replay, out of the box.
             requireExplicitConsent: config?.requireExplicitConsent ?? false,
+            // Logging in = accepting tracking (see registry.ts). Opt out per manager.
+            grantOnAuth: config?.grantOnAuth ?? true,
             onChange: config?.onChange,
             defaultPreferences: {
                 ...DEFAULT_PREFERENCES,
@@ -157,6 +160,11 @@ class ConsentManager {
                 preferences: true,
             };
         }
+        // Logging in = accepting tracking: the auth helpers auto-acceptAll() on
+        // every registered manager. Opt out per manager with `grantOnAuth: false`.
+        if (config?.grantOnAuth !== false) {
+            (0, registry_1.registerConsentManager)(this);
+        }
     }
     // ---------------------------------------------------------------------------
     // PUBLIC API

package/dist/lib/consent/manager.js.map

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

package/dist/lib/consent/registry.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview Consent-manager registry + login auto-grant.
+ * @module consent/registry
+ *
+ * @description
+ * Logging in counts as accepting tracking: an authenticated user has agreed to
+ * the app's terms, so the auth helpers (`completeAuth`, `trackAuth`,
+ * `pingActiveUser`) auto-accept consent instead of leaving a banner up — the
+ * same behaviour a hand-rolled auth beacon would implement.
+ *
+ * Every {@link ConsentManager} registers itself here on construction (unless
+ * created with `grantOnAuth: false`), so the grant reaches whichever manager(s)
+ * the app wired — `setupConsent`, `attachConsentBanner`, `renderConsentBanner`
+ * or a bare `new ConsentManager()` — without the SDK knowing cookie names.
+ */
+import type { ConsentManager } from './manager';
+/** Register a manager for the login auto-grant. Called from the constructor. */
+export declare function registerConsentManager(manager: ConsentManager): void;
+/**
+ * Accept all consent categories because the visitor authenticated.
+ *
+ * Fired automatically by the auth helpers ({@link FlowGrid.completeAuth},
+ * {@link FlowGrid.trackAuth}, {@link FlowGrid.pingActiveUser}); call it
+ * yourself only from a fully custom auth flow that bypasses them.
+ *
+ * Semantics mirror clicking "Accept all" on every registered manager: the
+ * choice is persisted in each manager's cookie (so banners gated on
+ * `hasConsented()` stay hidden on future visits), each manager's `onChange`
+ * fires (starting consent-gated streams like session replay), and it
+ * supersedes an earlier anonymous decline — logging in wins. Managers created
+ * with `grantOnAuth: false` are left untouched. Already fully-granted managers
+ * are skipped so repeated auth pings don't rewrite cookies.
+ *
+ * With no manager registered, it just opens the transport-level gates, which
+ * covers apps that called `FlowGridTransport.setConsent` by hand.
+ */
+export declare function grantConsentOnAuth(): void;

package/dist/lib/consent/registry.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * @fileoverview Consent-manager registry + login auto-grant.
+ * @module consent/registry
+ *
+ * @description
+ * Logging in counts as accepting tracking: an authenticated user has agreed to
+ * the app's terms, so the auth helpers (`completeAuth`, `trackAuth`,
+ * `pingActiveUser`) auto-accept consent instead of leaving a banner up — the
+ * same behaviour a hand-rolled auth beacon would implement.
+ *
+ * Every {@link ConsentManager} registers itself here on construction (unless
+ * created with `grantOnAuth: false`), so the grant reaches whichever manager(s)
+ * the app wired — `setupConsent`, `attachConsentBanner`, `renderConsentBanner`
+ * or a bare `new ConsentManager()` — without the SDK knowing cookie names.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerConsentManager = registerConsentManager;
+exports.grantConsentOnAuth = grantConsentOnAuth;
+const transport_1 = require("../client/transport");
+const managers = new Set();
+/** Register a manager for the login auto-grant. Called from the constructor. */
+function registerConsentManager(manager) {
+    managers.add(manager);
+}
+/**
+ * Accept all consent categories because the visitor authenticated.
+ *
+ * Fired automatically by the auth helpers ({@link FlowGrid.completeAuth},
+ * {@link FlowGrid.trackAuth}, {@link FlowGrid.pingActiveUser}); call it
+ * yourself only from a fully custom auth flow that bypasses them.
+ *
+ * Semantics mirror clicking "Accept all" on every registered manager: the
+ * choice is persisted in each manager's cookie (so banners gated on
+ * `hasConsented()` stay hidden on future visits), each manager's `onChange`
+ * fires (starting consent-gated streams like session replay), and it
+ * supersedes an earlier anonymous decline — logging in wins. Managers created
+ * with `grantOnAuth: false` are left untouched. Already fully-granted managers
+ * are skipped so repeated auth pings don't rewrite cookies.
+ *
+ * With no manager registered, it just opens the transport-level gates, which
+ * covers apps that called `FlowGridTransport.setConsent` by hand.
+ */
+function grantConsentOnAuth() {
+    if (managers.size === 0) {
+        transport_1.FlowGridTransport.setConsent({ analytics: true, marketing: true });
+        return;
+    }
+    for (const manager of managers) {
+        try {
+            const prefs = manager.getPreferences();
+            if (!manager.hasConsented() || !prefs.analytics || !prefs.marketing) {
+                manager.acceptAll();
+            }
+        }
+        catch {
+            /* consent stamping is best-effort — never let it break auth tracking */
+        }
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/lib/consent/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/lib/consent/registry.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;AAQH,wDAEC;AAoBD,gDAeC;AA1CD,mDAAwD;AAExD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;AAE3C,gFAAgF;AAChF,SAAgB,sBAAsB,CAAC,OAAuB;IAC5D,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,kBAAkB;IAChC,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACxB,6BAAiB,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,OAAO;IACT,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;YACvC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;gBACpE,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,wEAAwE;QAC1E,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/lib/consent/types.d.ts

@@ -76,6 +76,14 @@ export interface ConsentConfig {
      * GDPR-style opt-in flow.
      */
     requireExplicitConsent?: boolean;
+    /**
+     * Treat logging in as accepting tracking. Defaults to `true`: when the auth
+     * helpers (`completeAuth`, `trackAuth`, `pingActiveUser`) see an
+     * authenticated user, this manager auto-runs `acceptAll()` — persisting the
+     * choice, hiding consent banners, and superseding an earlier anonymous
+     * decline. Set `false` if authenticated users must still consent explicitly.
+     */
+    grantOnAuth?: boolean;
 }
 /**
  * Event emitted when consent changes.

package/dist/lib/flowgrid.d.ts

@@ -874,6 +874,11 @@ export declare class FlowGrid {
     private readonly _wrapped;
     /** Last identified user id — used by {@link logout} when none is passed. */
     private _identifiedUserId;
+    /**
+     * In-memory fallback for the once-per-day {@link pingActiveUser} dedupe,
+     * used when localStorage is unavailable (privacy mode, non-browser runtime).
+     */
+    private _lastActivePing;
     /**
      * One-line init. Idempotent — calling twice returns the same instance and
      * logs a warning instead of starting auto-instrumentation again.
@@ -1011,6 +1016,11 @@ export declare class FlowGrid {
      * user active for DAU/WAU/MAU. Framework-agnostic: call it from a React
      * effect, a Vue watcher, a Svelte reactive block — wherever the id lands.
      *
+     * Also auto-accepts cookie consent: logging in counts as opting in to
+     * tracking, so every {@link ConsentManager} (banner or headless) runs
+     * `acceptAll()` and consent-gated streams start. Disable per manager with
+     * `grantOnAuth: false`.
+     *
      * @example
      * ```ts
      * fg.completeAuth(user.id, { email: user.email, name: user.name });
@@ -1056,7 +1066,9 @@ export declare class FlowGrid {
      * One-call auth tracking for apps that DON'T redirect (email/password, magic
      * link resolved in-page): identify + fire the login/signup event + mark the
      * user active, in a single call. Prefer {@link markLogin} + {@link completeAuth}
-     * when your provider redirects.
+     * when your provider redirects. Like {@link completeAuth}, it auto-accepts
+     * cookie consent (logging in = opting in; disable per manager with
+     * `grantOnAuth: false`).
      *
      * @example
      * ```ts
@@ -1078,9 +1090,14 @@ export declare class FlowGrid {
     /**
      * Emit an "active user" signal for an identified user so the dashboard can
      * compute DAU / WAU / MAU *by identity*. Fired automatically by the auth
-     * helpers; call it yourself once per session on app open to also count
-     * returning users who don't re-authenticate. Carries email/name for parity
-     * with the Known-visitor identity.
+     * helpers; call it yourself on app open to also count returning users who
+     * don't re-authenticate. Carries email/name for parity with the
+     * Known-visitor identity.
+     *
+     * **Self-throttling** — pings dedupe to once per user per UTC day (the
+     * granularity DAU is counted at), so call this as often as you like: every
+     * page load, every render, every route change. Repeat same-day calls are
+     * dropped before they reach the network and never inflate event volume.
      *
      * @example
      * ```ts
@@ -1091,7 +1108,7 @@ export declare class FlowGrid {
     pingActiveUser(userId: string, traits?: {
         email?: string;
         name?: string;
-    } & Record<string, unknown>): Promise<import("..").ActivationResponse>;
+    } & Record<string, unknown>): Promise<import("..").ActivationResponse> | undefined;
     /**
      * Clear the identified user on logout so a shared device doesn't attribute the
      * next visitor to the previous user. Resets the identity server-side and

package/dist/lib/flowgrid.js

@@ -71,6 +71,7 @@ const authIntent_1 = require("./features/analytics/authIntent");
 const core_1 = require("./features/core");
 const analytics_1 = require("./features/analytics");
 const ecommerce_1 = require("./features/ecommerce");
+const registry_1 = require("./consent/registry");
 const core_2 = require("./tracking/core");
 const analytics_2 = require("./tracking/analytics");
 const ecommerce_2 = require("./tracking/ecommerce");
@@ -271,6 +272,11 @@ class FlowGrid {
         this._wrapped = new Map();
         /** Last identified user id — used by {@link logout} when none is passed. */
         this._identifiedUserId = null;
+        /**
+         * In-memory fallback for the once-per-day {@link pingActiveUser} dedupe,
+         * used when localStorage is unavailable (privacy mode, non-browser runtime).
+         */
+        this._lastActivePing = null;
         this.webId = webId;
         this.endpoint = endpoint;
         this.apiKey = apiKey;
@@ -410,6 +416,11 @@ class FlowGrid {
      * user active for DAU/WAU/MAU. Framework-agnostic: call it from a React
      * effect, a Vue watcher, a Svelte reactive block — wherever the id lands.
      *
+     * Also auto-accepts cookie consent: logging in counts as opting in to
+     * tracking, so every {@link ConsentManager} (banner or headless) runs
+     * `acceptAll()` and consent-gated streams start. Disable per manager with
+     * `grantOnAuth: false`.
+     *
      * @example
      * ```ts
      * fg.completeAuth(user.id, { email: user.email, name: user.name });
@@ -468,7 +479,9 @@ class FlowGrid {
      * One-call auth tracking for apps that DON'T redirect (email/password, magic
      * link resolved in-page): identify + fire the login/signup event + mark the
      * user active, in a single call. Prefer {@link markLogin} + {@link completeAuth}
-     * when your provider redirects.
+     * when your provider redirects. Like {@link completeAuth}, it auto-accepts
+     * cookie consent (logging in = opting in; disable per manager with
+     * `grantOnAuth: false`).
      *
      * @example
      * ```ts
@@ -492,9 +505,14 @@ class FlowGrid {
     /**
      * Emit an "active user" signal for an identified user so the dashboard can
      * compute DAU / WAU / MAU *by identity*. Fired automatically by the auth
-     * helpers; call it yourself once per session on app open to also count
-     * returning users who don't re-authenticate. Carries email/name for parity
-     * with the Known-visitor identity.
+     * helpers; call it yourself on app open to also count returning users who
+     * don't re-authenticate. Carries email/name for parity with the
+     * Known-visitor identity.
+     *
+     * **Self-throttling** — pings dedupe to once per user per UTC day (the
+     * granularity DAU is counted at), so call this as often as you like: every
+     * page load, every render, every route change. Repeat same-day calls are
+     * dropped before they reach the network and never inflate event volume.
      *
      * @example
      * ```ts
@@ -503,6 +521,28 @@ class FlowGrid {
      * ```
      */
     pingActiveUser(userId, traits) {
+        // Logging in = accepting tracking: every auth helper (completeAuth,
+        // trackAuth) and the once-per-session app-boot ping funnels through here,
+        // so this is the one place that knows "this browser belongs to an
+        // authenticated user". Auto-accept consent on the app's managers/banners —
+        // opt out per manager with `grantOnAuth: false`.
+        (0, registry_1.grantConsentOnAuth)();
+        // Once per user per UTC day (the same `date` bucket the event carries):
+        // DAU/WAU/MAU count distinct users, so repeat same-day pings only burn
+        // event volume. Throttle here so no caller ever has to.
+        const stamp = `${userId}:${new Date().toISOString().slice(0, 10)}`;
+        try {
+            if (localStorage.getItem("fg_active_user_ping") === stamp)
+                return undefined;
+            localStorage.setItem("fg_active_user_ping", stamp);
+        }
+        catch {
+            // Storage unavailable (privacy mode, non-browser) — dedupe in memory,
+            // which still collapses same-page-load repeats.
+            if (this._lastActivePing === stamp)
+                return undefined;
+            this._lastActivePing = stamp;
+        }
         // Rides the activation pipe (subtype `active_user`) so the wire event_name
         // is `active_user` — the generic custom_event pipe stored it under
         // event_name "custom_event", which the DAU/WAU/MAU pipes can't see.