@se-studio/hubspot 17.4.0 → 17.5.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @se-studio/hubspot
 
+## 17.5.0
+
+### Minor Changes
+
+- f1656f5: Assert HubSpot official third-party banner consent (`disableHubSpotCookieBanner` + `_hsp.setHubSpotConsent`) from `HubSpotAnalyticsAdapter` on every initialize and consent change. Mirror analytics to all three categories by default; keep `_hsq.doNotTrack` as opt-in via `hardDoNotTrack`.
+
+## 17.4.1
+
+### Patch Changes
+
+- Updated dependencies
+  - @se-studio/core-ui@1.35.1
+
 ## 17.4.0
 
 ### Minor Changes

package/README.md

@@ -25,6 +25,15 @@ pnpm add @se-studio/hubspot
 
 ## Analytics (with GTM)
 
+`HubSpotAnalyticsAdapter` implements HubSpot’s [third-party consent banner API](https://developers.hubspot.com/docs/api-reference/latest/account/settings/consent-banner/consent-banner-api):
+
+1. Sets `window.disableHubSpotCookieBanner = true` **before** injecting `js.hs-scripts.com`
+2. Pushes `_hsp.setHubSpotConsent({ analytics, advertisement, functionality })` on every `initialize` / `updateConsent` (HubSpot does **not** persist this — re-assert every page / change)
+3. By default mirrors analytics consent to all three categories; pass `resolveHubSpotConsent` or `updateConsent({ advertising })` for explicit flags
+4. `_hsq.doNotTrack` is **opt-in** via `hardDoNotTrack: true` (stricter than official decline — blocks anonymized page views)
+
+`ConsentAwareAdapter({ syncConsent: true })` already forwards analytics into `updateConsent`, so HubSpot category sync runs inside the HubSpot adapter when `getConsent` / `updateConsent` is used.
+
 ```tsx
 import { AnalyticsPageTracker, AnalyticsProvider, CompositeAnalyticsAdapter, ConsentAwareAdapter, GoogleTagManagerAdapter, createConsentGetter } from '@se-studio/core-ui';
 import { AbTestReporter } from '@se-studio/ab-testing/components';
@@ -48,6 +57,7 @@ const adapter = new ConsentAwareAdapter(
     new HubSpotAnalyticsAdapter({
       portalId: process.env.HUBSPOT_PORTAL_ID!,
       getConsent: hasConsent,
+      // Optional: hardDoNotTrack: true — also pushes `_hsq.doNotTrack` (zero anonymized hits)
     }),
   ]),
   'analytics',
@@ -56,7 +66,8 @@ const adapter = new ConsentAwareAdapter(
 );
 adapter.initialize();
 
-// layout.tsx — before HubSpot script loads (no args = SSG-safe; uses window.location.pathname)
+// layout.tsx — before HubSpot script loads (no args = SSG-safe; uses window.location.pathname).
+// Bootstrap also sets `disableHubSpotCookieBanner` and initialises `_hsp` / `_hsq`.
 <Script id="hubspot-bootstrap" strategy="beforeInteractive"
   dangerouslySetInnerHTML={{ __html: createHubSpotBootstrapScript() }} />
 

package/dist/index.d.ts

@@ -7,6 +7,6 @@ export { classifyHubspotFormAnalyticsError, hubspotFormAnalyticsIdentity, useHub
 export { HUBSPOT_MIN_SUBMIT_MS, HUBSPOT_SUBMIT_TOO_FAST_MESSAGE, isHubspotSubmitTooFast, } from './forms/submitGuard';
 export type { HubspotFieldResponse, HubspotFormClassNames, HubspotFormContext, HubspotFormDefinition, HubspotFormExternalData, HubspotFormSubmissionResponse, } from './forms/types';
 export { createHubSpotBootstrapScript } from './tracking/createHubSpotBootstrapScript';
-export type { HubSpotAnalyticsAdapterConfig } from './tracking/HubSpotAnalyticsAdapter';
+export type { HubSpotAnalyticsAdapterConfig, HubSpotConsentCategories, } from './tracking/HubSpotAnalyticsAdapter';
 export { HubSpotAnalyticsAdapter } from './tracking/HubSpotAnalyticsAdapter';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC3F,OAAO,EACL,kCAAkC,EAClC,sBAAsB,EACtB,kBAAkB,EAClB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,YAAY,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,EACL,iCAAiC,EACjC,4BAA4B,EAC5B,gBAAgB,GACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,qBAAqB,EACrB,+BAA+B,EAC/B,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AACvF,YAAY,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACxF,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC3F,OAAO,EACL,kCAAkC,EAClC,sBAAsB,EACtB,kBAAkB,EAClB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,YAAY,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,EACL,iCAAiC,EACjC,4BAA4B,EAC5B,gBAAgB,GACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,qBAAqB,EACrB,+BAA+B,EAC/B,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AACvF,YAAY,EACV,6BAA6B,EAC7B,wBAAwB,GACzB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC3F,OAAO,EACL,kCAAkC,EAClC,sBAAsB,EACtB,kBAAkB,EAClB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,EACL,iCAAiC,EACjC,4BAA4B,EAC5B,gBAAgB,GACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,qBAAqB,EACrB,+BAA+B,EAC/B,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAS7B,OAAO,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AAEvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC3F,OAAO,EACL,kCAAkC,EAClC,sBAAsB,EACtB,kBAAkB,EAClB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,EACL,iCAAiC,EACjC,4BAA4B,EAC5B,gBAAgB,GACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,qBAAqB,EACrB,+BAA+B,EAC/B,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAS7B,OAAO,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AAKvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/tracking/HubSpotAnalyticsAdapter.d.ts

@@ -2,8 +2,16 @@ import type { AnalyticsAdapter, AnalyticsConsentState, ClickTrackingProperties,
 declare global {
     interface Window {
         _hsq?: unknown[][];
+        _hsp?: unknown[][];
+        disableHubSpotCookieBanner?: boolean;
     }
 }
+/** HubSpot third-party banner categories (`setHubSpotConsent`). */
+export interface HubSpotConsentCategories {
+    analytics: boolean;
+    advertisement: boolean;
+    functionality: boolean;
+}
 export interface HubSpotAnalyticsAdapterConfig {
     portalId: string;
     /** Map analytics event names to HubSpot behavioural event names. */
@@ -14,21 +22,42 @@ export interface HubSpotAnalyticsAdapterConfig {
      * When provided, `initialize()` does not inject the HubSpot script and
      * `track*` does not push `_hsq` events while this returns false.
      * Omit it for unchanged behaviour (script loads, events fire).
+     * Consent categories are still asserted via `_hsp.setHubSpotConsent`.
      */
     getConsent?: () => boolean;
+    /**
+     * When true, a deny also pushes `_hsq.doNotTrack` (blocks anonymized page
+     * views). Default `false`: official third-party banner path uses only
+     * `setHubSpotConsent`.
+     */
+    hardDoNotTrack?: boolean;
+    /**
+     * Explicit HubSpot category mapping. When omitted, analytics consent is
+     * mirrored to `analytics`, `advertisement`, and `functionality`.
+     * `advertising` from `updateConsent` is passed through when present.
+     */
+    resolveHubSpotConsent?: (input: {
+        analytics: boolean;
+        advertising?: boolean;
+    }) => HubSpotConsentCategories;
 }
 export declare class HubSpotAnalyticsAdapter implements AnalyticsAdapter {
     private initialized;
     private readonly config;
     /** Last explicit `updateConsent` analytics flag. Default allow when unset. */
     private allowedFromUpdate;
+    private lastAdvertising;
     private doNotTrackSent;
     constructor(config: HubSpotAnalyticsAdapterConfig);
     private isAllowed;
+    private resolveCategories;
+    private assertHubSpotConsent;
     private sendDoNotTrack;
+    private injectTrackingScript;
     initialize(): void;
     /**
-     * `analytics: false` pushes HubSpot `doNotTrack` and blocks later events.
+     * Asserts HubSpot category consent via `_hsp.setHubSpotConsent`.
+     * `analytics: false` optionally pushes `_hsq.doNotTrack` when `hardDoNotTrack`.
      * `analytics: true` allows `initialize()` to load the script on a later grant.
      */
     updateConsent(consent: AnalyticsConsentState): void;

package/dist/tracking/HubSpotAnalyticsAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HubSpotAnalyticsAdapter.d.ts","sourceRoot":"","sources":["../../src/tracking/HubSpotAnalyticsAdapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;KACpB;CACF;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,oFAAoF;IACpF,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;CAC5B;AA8BD,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,8EAA8E;IAC9E,OAAO,CAAC,iBAAiB,CAAQ;IACjC,OAAO,CAAC,cAAc,CAAS;IAE/B,YAAY,MAAM,EAAE,6BAA6B,EAEhD;IAED,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,cAAc;IAQtB,UAAU,IAAI,IAAI,CA2BjB;IAED;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAgBlD;IAED,OAAO,CAAC,UAAU;IAQlB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,sBAAsB,GAAG,IAAI,CAMhE;IAED,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAgBnE;IAED,UAAU,CAAC,UAAU,EAAE,uBAAuB,GAAG,IAAI,CAwBpD;CACF"}
+{"version":3,"file":"HubSpotAnalyticsAdapter.d.ts","sourceRoot":"","sources":["../../src/tracking/HubSpotAnalyticsAdapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;QACnB,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;QACnB,0BAA0B,CAAC,EAAE,OAAO,CAAC;KACtC;CACF;AAED,mEAAmE;AACnE,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,oFAAoF;IACpF,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;IAC3B;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE;QAC9B,SAAS,EAAE,OAAO,CAAC;QACnB,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,KAAK,wBAAwB,CAAC;CAChC;AAyDD,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,8EAA8E;IAC9E,OAAO,CAAC,iBAAiB,CAAQ;IACjC,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,cAAc,CAAS;IAE/B,YAAY,MAAM,EAAE,6BAA6B,EAEhD;IAED,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,oBAAoB;IAoB5B,UAAU,IAAI,IAAI,CAoBjB;IAED;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAqBlD;IAED,OAAO,CAAC,UAAU;IAQlB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,sBAAsB,GAAG,IAAI,CAMhE;IAED,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAgBnE;IAED,UAAU,CAAC,UAAU,EAAE,uBAAuB,GAAG,IAAI,CAwBpD;CACF"}

package/dist/tracking/HubSpotAnalyticsAdapter.js

@@ -6,6 +6,27 @@ function pushHsq(args) {
     window._hsq = window._hsq || [];
     window._hsq.push(args);
 }
+function pushHsp(args) {
+    if (typeof window === 'undefined') {
+        return;
+    }
+    window._hsp = window._hsp || [];
+    window._hsp.push(args);
+}
+function disableHubSpotBanner() {
+    if (typeof window === 'undefined') {
+        return;
+    }
+    window.disableHubSpotCookieBanner = true;
+}
+function defaultHubSpotConsent(input) {
+    const advertisement = input.advertising ?? input.analytics;
+    return {
+        analytics: input.analytics,
+        advertisement,
+        functionality: input.analytics,
+    };
+}
 function getHubspotEventName(event, properties, eventNameMap) {
     const fromProps = properties.hubspotEvent ||
         properties.hubspot_event;
@@ -23,6 +44,7 @@ export class HubSpotAnalyticsAdapter {
     config;
     /** Last explicit `updateConsent` analytics flag. Default allow when unset. */
     allowedFromUpdate = true;
+    lastAdvertising;
     doNotTrackSent = false;
     constructor(config) {
         this.config = config;
@@ -33,24 +55,33 @@ export class HubSpotAnalyticsAdapter {
         }
         return this.allowedFromUpdate;
     }
+    resolveCategories(analytics) {
+        const input = {
+            analytics,
+            advertising: this.lastAdvertising,
+        };
+        if (this.config.resolveHubSpotConsent) {
+            return this.config.resolveHubSpotConsent(input);
+        }
+        return defaultHubSpotConsent(input);
+    }
+    assertHubSpotConsent(analytics) {
+        disableHubSpotBanner();
+        pushHsp(['setHubSpotConsent', this.resolveCategories(analytics)]);
+    }
     sendDoNotTrack() {
-        if (this.doNotTrackSent || !this.initialized) {
+        if (!this.config.hardDoNotTrack || this.doNotTrackSent || !this.initialized) {
             return;
         }
         pushHsq(['doNotTrack']);
         this.doNotTrackSent = true;
     }
-    initialize() {
-        if (typeof window === 'undefined' || this.initialized) {
-            return;
-        }
-        if (!this.isAllowed()) {
-            return;
-        }
+    injectTrackingScript() {
         const { portalId } = this.config;
         if (!portalId) {
             return;
         }
+        disableHubSpotBanner();
         const scriptId = 'hs-script-loader';
         if (!document.getElementById(scriptId)) {
             const script = document.createElement('script');
@@ -61,11 +92,27 @@ export class HubSpotAnalyticsAdapter {
             script.src = `https://js.hs-scripts.com/${portalId}.js`;
             document.head.appendChild(script);
         }
+    }
+    initialize() {
+        if (typeof window === 'undefined' || this.initialized) {
+            return;
+        }
+        const allowed = this.isAllowed();
+        // HubSpot does not persist third-party consent — re-assert every load.
+        this.assertHubSpotConsent(allowed);
+        if (!allowed) {
+            return;
+        }
+        if (!this.config.portalId) {
+            return;
+        }
+        this.injectTrackingScript();
         this.initialized = true;
         this.doNotTrackSent = false;
     }
     /**
-     * `analytics: false` pushes HubSpot `doNotTrack` and blocks later events.
+     * Asserts HubSpot category consent via `_hsp.setHubSpotConsent`.
+     * `analytics: false` optionally pushes `_hsq.doNotTrack` when `hardDoNotTrack`.
      * `analytics: true` allows `initialize()` to load the script on a later grant.
      */
     updateConsent(consent) {
@@ -73,6 +120,10 @@ export class HubSpotAnalyticsAdapter {
             return;
         }
         this.allowedFromUpdate = consent.analytics;
+        if (consent.advertising !== undefined) {
+            this.lastAdvertising = consent.advertising;
+        }
+        this.assertHubSpotConsent(consent.analytics);
         if (!consent.analytics) {
             this.sendDoNotTrack();
             return;

package/dist/tracking/HubSpotAnalyticsAdapter.js.map

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

package/dist/tracking/createHubSpotBootstrapScript.d.ts

@@ -1,6 +1,7 @@
 /**
- * Inline script for beforeInteractive: initialises _hsq and sets the path
- * before the HubSpot tracking script loads (SPA Mode B).
+ * Inline script for beforeInteractive: initialises `_hsq` / `_hsp`, disables
+ * HubSpot's own cookie banner, and sets the path before the HubSpot tracking
+ * script loads (SPA Mode B + third-party CMP).
  *
  * Call with no args in root layouts (SSG-safe): uses `window.location.pathname`
  * at script execution time. Pass an explicit pathname only for tests or rare cases.

package/dist/tracking/createHubSpotBootstrapScript.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createHubSpotBootstrapScript.d.ts","sourceRoot":"","sources":["../../src/tracking/createHubSpotBootstrapScript.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAStE"}
+{"version":3,"file":"createHubSpotBootstrapScript.d.ts","sourceRoot":"","sources":["../../src/tracking/createHubSpotBootstrapScript.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAatE"}

package/dist/tracking/createHubSpotBootstrapScript.js

@@ -1,17 +1,21 @@
 /**
- * Inline script for beforeInteractive: initialises _hsq and sets the path
- * before the HubSpot tracking script loads (SPA Mode B).
+ * Inline script for beforeInteractive: initialises `_hsq` / `_hsp`, disables
+ * HubSpot's own cookie banner, and sets the path before the HubSpot tracking
+ * script loads (SPA Mode B + third-party CMP).
  *
  * Call with no args in root layouts (SSG-safe): uses `window.location.pathname`
  * at script execution time. Pass an explicit pathname only for tests or rare cases.
  */
 export function createHubSpotBootstrapScript(pathname) {
+    const bannerAndQueues = `window.disableHubSpotCookieBanner = true;
+var _hsp = window._hsp = window._hsp || [];
+var _hsq = window._hsq = window._hsq || [];`;
     if (pathname === undefined) {
-        return `var _hsq = window._hsq = window._hsq || [];
+        return `${bannerAndQueues}
 _hsq.push(['setPath', window.location.pathname]);`;
     }
     const safePath = pathname.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
-    return `var _hsq = window._hsq = window._hsq || [];
+    return `${bannerAndQueues}
 _hsq.push(['setPath', '${safePath}']);`;
 }
 //# sourceMappingURL=createHubSpotBootstrapScript.js.map

package/dist/tracking/createHubSpotBootstrapScript.js.map

@@ -1 +1 @@
-{"version":3,"file":"createHubSpotBootstrapScript.js","sourceRoot":"","sources":["../../src/tracking/createHubSpotBootstrapScript.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B,CAAC,QAAiB;IAC5D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO;kDACuC,CAAC;IACjD,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACtE,OAAO;yBACgB,QAAQ,MAAM,CAAC;AACxC,CAAC"}
+{"version":3,"file":"createHubSpotBootstrapScript.js","sourceRoot":"","sources":["../../src/tracking/createHubSpotBootstrapScript.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,4BAA4B,CAAC,QAAiB;IAC5D,MAAM,eAAe,GAAG;;4CAEkB,CAAC;IAE3C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,GAAG,eAAe;kDACqB,CAAC;IACjD,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACtE,OAAO,GAAG,eAAe;yBACF,QAAQ,MAAM,CAAC;AACxC,CAAC"}

package/docs/llms.md

@@ -4,7 +4,7 @@
 
 | Import | Contents |
 |--------|----------|
-| `@se-studio/hubspot` | `HubSpotAnalyticsAdapter`, `createHubSpotBootstrapScript`, `HubspotDynamicForm`, `buildDefaultValues`, `captureMarketingParams`, `getMarketingParams`, `applyMarketingParamsToHiddenFields`, `useHubspotSubmit`, `hubspotFormAnalyticsIdentity`, `classifyHubspotFormAnalyticsError`, `navigateAfterSubmit`, `HUBSPOT_MIN_SUBMIT_MS`, `HUBSPOT_SUBMIT_TOO_FAST_MESSAGE`, `isHubspotSubmitTooFast`, types |
+| `@se-studio/hubspot` | `HubSpotAnalyticsAdapter`, `HubSpotConsentCategories`, `createHubSpotBootstrapScript`, `HubspotDynamicForm`, `buildDefaultValues`, `captureMarketingParams`, `getMarketingParams`, `applyMarketingParamsToHiddenFields`, `useHubspotSubmit`, `hubspotFormAnalyticsIdentity`, `classifyHubspotFormAnalyticsError`, `navigateAfterSubmit`, `HUBSPOT_MIN_SUBMIT_MS`, `HUBSPOT_SUBMIT_TOO_FAST_MESSAGE`, `isHubspotSubmitTooFast`, types |
 | `@se-studio/hubspot/server` | `getHubspotFormDefinition`, `submitHubspotForm`, `hubspotFormTag`, `HUBSPOT_MIN_SUBMIT_MS`, `HUBSPOT_SUBMIT_TOO_FAST_MESSAGE`, `isHubspotSubmitTooFast` |
 | `@se-studio/hubspot/external` | `createHubspotFormExternalRenderer` |
 
@@ -58,9 +58,16 @@ After HubSpot form editor changes, revalidate: `revalidateTag(hubspotFormTag(for
 
 Use with `CompositeAnalyticsAdapter` + `AnalyticsPageTracker` from `@se-studio/core-ui`. HubSpot SPA Mode B: bootstrap `setPath` before script load; `AnalyticsPageTracker` skips first mount.
 
-Consent: pass `getConsent` on `HubSpotAnalyticsAdapter`. While it returns false, `initialize()` does not inject the tracking script and `track*` does not push `_hsq` events. A mid-session deny (`updateConsent({ analytics: false })` or `ConsentAwareAdapter` with `{ syncConsent: true }`) pushes `_hsq doNotTrack`. Omit `getConsent` and leave wrapper sync off for unchanged behaviour. Helper: `createConsentGetter` / `resolveAnalyticsConsent` in `@se-studio/core-ui`.
+Consent (official third-party banner API):
 
-**SSG layouts:** call `createHubSpotBootstrapScript()` with **no args** in root layout. Do **not** use `headers()` or middleware to pass pathname — that breaks on-demand SSG routes in `next start`.
+- `initialize` / `updateConsent` set `disableHubSpotCookieBanner = true` before `js.hs-scripts.com` and push `_hsp.setHubSpotConsent({ analytics, advertisement, functionality })`. HubSpot does **not** persist category consent — re-assert every page load and every CMP change.
+- Default mapping: analytics consent → all three categories. Override with `resolveHubSpotConsent`, or pass `advertising` on `updateConsent` to set `advertisement` independently.
+- Pass `getConsent` to skip script inject + `_hsq` track events while false (script gating from #204). Category consent is still asserted.
+- `_hsq.doNotTrack` is **opt-in** (`hardDoNotTrack: true`). Default deny uses only `setHubSpotConsent` (anonymized aggregated views may still be allowed by HubSpot).
+- `ConsentAwareAdapter({ syncConsent: true })` forwards analytics into `updateConsent`; HubSpot category sync happens inside this adapter — do not fork `_hsp` in site code.
+- Helpers: `createConsentGetter` / `resolveAnalyticsConsent` in `@se-studio/core-ui`.
+
+**SSG layouts:** call `createHubSpotBootstrapScript()` with **no args** in root layout. Bootstrap also sets `disableHubSpotCookieBanner` and initialises `_hsp` / `_hsq`. Do **not** use `headers()` or middleware to pass pathname — that breaks on-demand SSG routes in `next start`.
 
 ## Env
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/hubspot",
-  "version": "17.4.0",
+  "version": "17.5.0",
   "description": "HubSpot tracking and API-driven form rendering for Next.js marketing sites",
   "repository": {
     "type": "git",
@@ -41,7 +41,7 @@
   ],
   "peerDependencies": {
     "@se-studio/core-data-types": "1.13.7",
-    "@se-studio/core-ui": "1.35.0",
+    "@se-studio/core-ui": "1.35.1",
     "next": ">=15.5.0 <17",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
@@ -54,7 +54,7 @@
   "devDependencies": {
     "@biomejs/biome": "^2.5.12",
     "@se-studio/core-data-types": "1.13.7",
-    "@se-studio/core-ui": "1.35.0",
+    "@se-studio/core-ui": "1.35.1",
     "@types/node": "^24.13.3",
     "@types/react": "^19.2.18",
     "@types/react-dom": "^19.2.5",