@se-studio/core-ui 1.33.3 → 1.35.0

package/dist/analytics/adapters/index.d.ts

@@ -1,4 +1,5 @@
 export { CompositeAnalyticsAdapter } from './CompositeAnalyticsAdapter';
+export type { ConsentAwareAdapterOptions } from './ConsentAwareAdapter';
 export { ConsentAwareAdapter } from './ConsentAwareAdapter';
 export { ConsoleAnalyticsAdapter } from './ConsoleAnalyticsAdapter';
 export { GoogleTagManagerAdapter } from './GoogleTagManagerAdapter';

package/dist/analytics/adapters/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analytics/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analytics/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,YAAY,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/analytics/adapters/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analytics/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analytics/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAExE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/analytics/consent/resolveAnalyticsConsent.d.ts

@@ -0,0 +1,39 @@
+export type ConsentStatus = 'granted' | 'denied';
+export type ConsentModel = 'opt-in' | 'opt-out';
+/**
+ * Browser privacy-signal surface. `Navigator` plus GPC (`globalPrivacyControl`).
+ */
+export interface PrivacySignalNavigator {
+    doNotTrack?: string | null;
+    msDoNotTrack?: string | null;
+    globalPrivacyControl?: boolean;
+}
+export interface ResolveAnalyticsConsentOptions {
+    /**
+     * Site-configured consent source (cookie, CMP, orejime, etc.).
+     * `true` / `'granted'` allow tracking; `false` / `'denied'` block it.
+     * `null` / `undefined` means unset — the `model` default applies.
+     */
+    source?: () => boolean | ConsentStatus | null | undefined;
+    /**
+     * When `source` is unset: `opt-out` grants tracking, `opt-in` denies it.
+     * Defaults to `opt-out` so sites that never configure consent keep tracking.
+     */
+    model?: ConsentModel;
+    /** Treat Global Privacy Control as an opt-out. Default `false`. */
+    honorGlobalPrivacyControl?: boolean;
+    /** Treat Do Not Track as an opt-out. Default `false`. */
+    honorDoNotTrack?: boolean;
+    /** Override `navigator` (tests). */
+    navigator?: PrivacySignalNavigator;
+}
+/**
+ * Resolve whether analytics tracking is allowed.
+ *
+ * Unconfigured sites (`{}` or omitted options) return `true` (opt-out / track).
+ * Honored GPC and DNT always deny, even if the site source would grant.
+ */
+export declare function resolveAnalyticsConsent(options?: ResolveAnalyticsConsentOptions): boolean;
+/** Stable getter for `ConsentAwareAdapter` / HubSpot `getConsent`. */
+export declare function createConsentGetter(options?: ResolveAnalyticsConsentOptions): () => boolean;
+//# sourceMappingURL=resolveAnalyticsConsent.d.ts.map

package/dist/analytics/consent/resolveAnalyticsConsent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveAnalyticsConsent.d.ts","sourceRoot":"","sources":["../../../src/analytics/consent/resolveAnalyticsConsent.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,CAAC;AACjD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,8BAA8B;IAC7C;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,OAAO,GAAG,aAAa,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1D;;;OAGG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,mEAAmE;IACnE,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,yDAAyD;IACzD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oCAAoC;IACpC,SAAS,CAAC,EAAE,sBAAsB,CAAC;CACpC;AA+BD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,8BAAmC,GAAG,OAAO,CAmB7F;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,8BAAmC,GAAG,MAAM,OAAO,CAE/F"}

package/dist/analytics/consent/resolveAnalyticsConsent.js

@@ -0,0 +1,53 @@
+function readSource(source) {
+    if (!source) {
+        return undefined;
+    }
+    const value = source();
+    if (value === null || value === undefined) {
+        return undefined;
+    }
+    if (value === 'granted' || value === true) {
+        return true;
+    }
+    if (value === 'denied' || value === false) {
+        return false;
+    }
+    return undefined;
+}
+function isDoNotTrackEnabled(nav) {
+    if (!nav) {
+        return false;
+    }
+    const signal = nav.doNotTrack ?? nav.msDoNotTrack;
+    return signal === '1' || signal === 'yes';
+}
+function isGlobalPrivacyControlEnabled(nav) {
+    return nav?.globalPrivacyControl === true;
+}
+/**
+ * Resolve whether analytics tracking is allowed.
+ *
+ * Unconfigured sites (`{}` or omitted options) return `true` (opt-out / track).
+ * Honored GPC and DNT always deny, even if the site source would grant.
+ */
+export function resolveAnalyticsConsent(options = {}) {
+    const nav = options.navigator ??
+        (typeof navigator !== 'undefined' ? navigator : undefined);
+    if (options.honorGlobalPrivacyControl && isGlobalPrivacyControlEnabled(nav)) {
+        return false;
+    }
+    if (options.honorDoNotTrack && isDoNotTrackEnabled(nav)) {
+        return false;
+    }
+    const fromSource = readSource(options.source);
+    if (fromSource !== undefined) {
+        return fromSource;
+    }
+    const model = options.model ?? 'opt-out';
+    return model === 'opt-out';
+}
+/** Stable getter for `ConsentAwareAdapter` / HubSpot `getConsent`. */
+export function createConsentGetter(options = {}) {
+    return () => resolveAnalyticsConsent(options);
+}
+//# sourceMappingURL=resolveAnalyticsConsent.js.map

package/dist/analytics/consent/resolveAnalyticsConsent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveAnalyticsConsent.js","sourceRoot":"","sources":["../../../src/analytics/consent/resolveAnalyticsConsent.ts"],"names":[],"mappings":"AAgCA,SAAS,UAAU,CAAC,MAAgD;IAClE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC;IACvB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,mBAAmB,CAAC,GAAuC;IAClE,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,YAAY,CAAC;IAClD,OAAO,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,KAAK,CAAC;AAC5C,CAAC;AAED,SAAS,6BAA6B,CAAC,GAAuC;IAC5E,OAAO,GAAG,EAAE,oBAAoB,KAAK,IAAI,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAO,GAAmC,EAAE;IAClF,MAAM,GAAG,GACP,OAAO,CAAC,SAAS;QACjB,CAAC,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC,CAAE,SAAoC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEzF,IAAI,OAAO,CAAC,yBAAyB,IAAI,6BAA6B,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,CAAC,eAAe,IAAI,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC;QACxD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,SAAS,CAAC;IACzC,OAAO,KAAK,KAAK,SAAS,CAAC;AAC7B,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,mBAAmB,CAAC,OAAO,GAAmC,EAAE;IAC9E,OAAO,GAAG,EAAE,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;AAChD,CAAC"}

package/dist/analytics/form/createFormAnalyticsSession.d.ts

@@ -0,0 +1,36 @@
+import type { FormAnalyticsErrorInfo, FormAnalyticsTrackFn } from './formAnalyticsTypes';
+import { type FormAnalyticsIdentity } from './formAnalyticsTypes';
+export interface CreateFormAnalyticsSessionOptions {
+    identity: FormAnalyticsIdentity;
+    track: FormAnalyticsTrackFn;
+}
+export interface FormAnalyticsSession {
+    /** Fire `form_view` once for this form instance. */
+    markView: () => void;
+    /** Fire `form_start` once on first interaction. */
+    markStart: () => void;
+    /** Fire `form_submit` on successful accept (each success). */
+    markSubmit: () => void;
+    /**
+     * Fire `form_error`. Validation errors are deduped per attempt (multiple
+     * invalid fields on one submit → one event). API/network errors fire each time.
+     */
+    markError: (info?: FormAnalyticsErrorInfo) => void;
+    /**
+     * Snapshot for unit tests / debugging only.
+     */
+    getState: () => Readonly<FormAnalyticsSessionState>;
+}
+export interface FormAnalyticsSessionState {
+    viewed: boolean;
+    started: boolean;
+    submitCount: number;
+    errorCount: number;
+    validationErrorThisAttempt: boolean;
+}
+/**
+ * Pure form analytics session. Callers (hooks / HubSpot submit) translate DOM
+ * events into these methods. Never pass field values into `track`.
+ */
+export declare function createFormAnalyticsSession(options: CreateFormAnalyticsSessionOptions): FormAnalyticsSession;
+//# sourceMappingURL=createFormAnalyticsSession.d.ts.map

package/dist/analytics/form/createFormAnalyticsSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFormAnalyticsSession.d.ts","sourceRoot":"","sources":["../../../src/analytics/form/createFormAnalyticsSession.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,EAAyB,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGzF,MAAM,WAAW,iCAAiC;IAChD,QAAQ,EAAE,qBAAqB,CAAC;IAChC,KAAK,EAAE,oBAAoB,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,mDAAmD;IACnD,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,8DAA8D;IAC9D,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB;;;OAGG;IACH,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,sBAAsB,KAAK,IAAI,CAAC;IACnD;;OAEG;IACH,QAAQ,EAAE,MAAM,QAAQ,CAAC,yBAAyB,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B,EAAE,OAAO,CAAC;CACrC;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,iCAAiC,GACzC,oBAAoB,CAyDtB"}

package/dist/analytics/form/createFormAnalyticsSession.js

@@ -0,0 +1,62 @@
+import { FORM_ANALYTICS_EVENTS } from './formAnalyticsTypes';
+import { sanitizeFormAnalyticsProperties } from './sanitizeFormAnalyticsProperties';
+/**
+ * Pure form analytics session. Callers (hooks / HubSpot submit) translate DOM
+ * events into these methods. Never pass field values into `track`.
+ */
+export function createFormAnalyticsSession(options) {
+    const { identity, track } = options;
+    const state = {
+        viewed: false,
+        started: false,
+        submitCount: 0,
+        errorCount: 0,
+        validationErrorThisAttempt: false,
+    };
+    const emit = (event, extra) => {
+        const properties = sanitizeFormAnalyticsProperties({
+            ...identity,
+            ...extra,
+        });
+        track(event, properties);
+    };
+    return {
+        markView: () => {
+            if (state.viewed) {
+                return;
+            }
+            state.viewed = true;
+            emit(FORM_ANALYTICS_EVENTS.view);
+        },
+        markStart: () => {
+            if (state.started) {
+                state.validationErrorThisAttempt = false;
+                return;
+            }
+            state.started = true;
+            emit(FORM_ANALYTICS_EVENTS.start);
+        },
+        markSubmit: () => {
+            state.validationErrorThisAttempt = false;
+            state.submitCount += 1;
+            emit(FORM_ANALYTICS_EVENTS.submit);
+        },
+        markError: (info) => {
+            const category = info?.error_category;
+            if (category === 'validation') {
+                if (!state.started) {
+                    state.started = true;
+                    emit(FORM_ANALYTICS_EVENTS.start);
+                }
+                if (state.validationErrorThisAttempt) {
+                    return;
+                }
+                state.validationErrorThisAttempt = true;
+            }
+            state.errorCount += 1;
+            emit(FORM_ANALYTICS_EVENTS.error, info);
+        },
+        getState: () => state,
+    };
+}
+//# sourceMappingURL=createFormAnalyticsSession.js.map

package/dist/analytics/form/createFormAnalyticsSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFormAnalyticsSession.js","sourceRoot":"","sources":["../../../src/analytics/form/createFormAnalyticsSession.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAA8B,MAAM,sBAAsB,CAAC;AACzF,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AAiCpF;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAA0C;IAE1C,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAEpC,MAAM,KAAK,GAA8B;QACvC,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,CAAC;QACd,UAAU,EAAE,CAAC;QACb,0BAA0B,EAAE,KAAK;KAClC,CAAC;IAEF,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,KAA8B,EAAE,EAAE;QAC7D,MAAM,UAAU,GAAG,+BAA+B,CAAC;YACjD,GAAG,QAAQ;YACX,GAAG,KAAK;SACT,CAAC,CAAC;QACH,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAC3B,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,GAAG,EAAE;YACb,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjB,OAAO;YACT,CAAC;YACD,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;YACpB,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QACD,SAAS,EAAE,GAAG,EAAE;YACd,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClB,KAAK,CAAC,0BAA0B,GAAG,KAAK,CAAC;gBACzC,OAAO;YACT,CAAC;YACD,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;YACrB,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QACD,UAAU,EAAE,GAAG,EAAE;YACf,KAAK,CAAC,0BAA0B,GAAG,KAAK,CAAC;YACzC,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;YACvB,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QACD,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;YAClB,MAAM,QAAQ,GAAG,IAAI,EAAE,cAAc,CAAC;YACtC,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;gBAC9B,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;oBACnB,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;oBACrB,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;gBACpC,CAAC;gBACD,IAAI,KAAK,CAAC,0BAA0B,EAAE,CAAC;oBACrC,OAAO;gBACT,CAAC;gBACD,KAAK,CAAC,0BAA0B,GAAG,IAAI,CAAC;YAC1C,CAAC;YACD,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;YACtB,IAAI,CAAC,qBAAqB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC;QACD,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK;KACtB,CAAC;AACJ,CAAC"}

package/dist/analytics/form/formAnalyticsTypes.d.ts

@@ -0,0 +1,43 @@
+/**
+ * First-party form lifecycle events fired via `trackEvent`.
+ * Sites map these names to GTM tags or HubSpot behavioural events.
+ *
+ * Payloads are non-PII: never field values, emails, names, phones, or free text.
+ */
+export declare const FORM_ANALYTICS_EVENTS: {
+    readonly view: 'form_view';
+    readonly start: 'form_start';
+    readonly submit: 'form_submit';
+    readonly error: 'form_error';
+};
+export type FormAnalyticsEventName = (typeof FORM_ANALYTICS_EVENTS)[keyof typeof FORM_ANALYTICS_EVENTS];
+export declare const FORM_ANALYTICS_EVENT_NAMES: readonly FormAnalyticsEventName[];
+/** Allowed payload keys — anything else is dropped before `trackEvent`. */
+export declare const FORM_ANALYTICS_ALLOWED_KEYS: readonly ['form_id', 'form_name', 'form_type', 'cms_entry_id', 'step', 'error_code', 'error_category'];
+export type FormAnalyticsAllowedKey = (typeof FORM_ANALYTICS_ALLOWED_KEYS)[number];
+/**
+ * Closed set of error categories. Do not pass visitor-facing or API error messages —
+ * those can echo field values.
+ */
+export declare const FORM_ERROR_CATEGORIES: {
+    readonly validation: 'validation';
+    readonly api: 'api';
+    readonly too_fast: 'too_fast';
+    readonly network: 'network';
+    readonly redirect: 'redirect';
+};
+export type FormErrorCategory = (typeof FORM_ERROR_CATEGORIES)[keyof typeof FORM_ERROR_CATEGORIES];
+export interface FormAnalyticsIdentity {
+    form_id?: string;
+    form_name?: string;
+    form_type?: string;
+    cms_entry_id?: string;
+    step?: string | number;
+}
+export interface FormAnalyticsErrorInfo {
+    error_code?: string;
+    error_category?: FormErrorCategory | string;
+}
+export type FormAnalyticsProperties = FormAnalyticsIdentity & FormAnalyticsErrorInfo;
+export type FormAnalyticsTrackFn = (event: string, properties: Record<string, unknown>) => void;
+//# sourceMappingURL=formAnalyticsTypes.d.ts.map

package/dist/analytics/form/formAnalyticsTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formAnalyticsTypes.d.ts","sourceRoot":"","sources":["../../../src/analytics/form/formAnalyticsTypes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;aAChC,IAAI,EAAE,WAAW;aACjB,KAAK,EAAE,YAAY;aACnB,MAAM,EAAE,aAAa;aACrB,KAAK,EAAE,YAAY;CACX,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAChC,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,OAAO,qBAAqB,CAAC,CAAC;AAErE,eAAO,MAAM,0BAA0B,EAAE,SAAS,sBAAsB,EAKvE,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,2BAA2B,YACtC,SAAS,EACT,WAAW,EACX,WAAW,EACX,cAAc,EACd,MAAM,EACN,YAAY,EACZ,gBAAgB,CACR,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnF;;;GAGG;AACH,eAAO,MAAM,qBAAqB;aAChC,UAAU,EAAE,YAAY;aACxB,GAAG,EAAE,KAAK;aACV,QAAQ,EAAE,UAAU;aACpB,OAAO,EAAE,SAAS;aAClB,QAAQ,EAAE,UAAU;CACZ,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,OAAO,qBAAqB,CAAC,CAAC;AAEnG,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC;CAC7C;AAED,MAAM,MAAM,uBAAuB,GAAG,qBAAqB,GAAG,sBAAsB,CAAC;AAErF,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC"}

package/dist/analytics/form/formAnalyticsTypes.js

@@ -0,0 +1,40 @@
+/**
+ * First-party form lifecycle events fired via `trackEvent`.
+ * Sites map these names to GTM tags or HubSpot behavioural events.
+ *
+ * Payloads are non-PII: never field values, emails, names, phones, or free text.
+ */
+export const FORM_ANALYTICS_EVENTS = {
+    view: 'form_view',
+    start: 'form_start',
+    submit: 'form_submit',
+    error: 'form_error',
+};
+export const FORM_ANALYTICS_EVENT_NAMES = [
+    FORM_ANALYTICS_EVENTS.view,
+    FORM_ANALYTICS_EVENTS.start,
+    FORM_ANALYTICS_EVENTS.submit,
+    FORM_ANALYTICS_EVENTS.error,
+];
+/** Allowed payload keys — anything else is dropped before `trackEvent`. */
+export const FORM_ANALYTICS_ALLOWED_KEYS = [
+    'form_id',
+    'form_name',
+    'form_type',
+    'cms_entry_id',
+    'step',
+    'error_code',
+    'error_category',
+];
+/**
+ * Closed set of error categories. Do not pass visitor-facing or API error messages —
+ * those can echo field values.
+ */
+export const FORM_ERROR_CATEGORIES = {
+    validation: 'validation',
+    api: 'api',
+    too_fast: 'too_fast',
+    network: 'network',
+    redirect: 'redirect',
+};
+//# sourceMappingURL=formAnalyticsTypes.js.map

package/dist/analytics/form/formAnalyticsTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formAnalyticsTypes.js","sourceRoot":"","sources":["../../../src/analytics/form/formAnalyticsTypes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,aAAa;IACrB,KAAK,EAAE,YAAY;CACX,CAAC;AAKX,MAAM,CAAC,MAAM,0BAA0B,GAAsC;IAC3E,qBAAqB,CAAC,IAAI;IAC1B,qBAAqB,CAAC,KAAK;IAC3B,qBAAqB,CAAC,MAAM;IAC5B,qBAAqB,CAAC,KAAK;CAC5B,CAAC;AAEF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,SAAS;IACT,WAAW;IACX,WAAW;IACX,cAAc;IACd,MAAM;IACN,YAAY;IACZ,gBAAgB;CACR,CAAC;AAIX;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,UAAU,EAAE,YAAY;IACxB,GAAG,EAAE,KAAK;IACV,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;CACZ,CAAC"}

package/dist/analytics/form/index.d.ts

@@ -0,0 +1,5 @@
+export { type CreateFormAnalyticsSessionOptions, createFormAnalyticsSession, type FormAnalyticsSession, type FormAnalyticsSessionState, } from './createFormAnalyticsSession';
+export { FORM_ANALYTICS_ALLOWED_KEYS, FORM_ANALYTICS_EVENT_NAMES, FORM_ANALYTICS_EVENTS, FORM_ERROR_CATEGORIES, type FormAnalyticsAllowedKey, type FormAnalyticsErrorInfo, type FormAnalyticsEventName, type FormAnalyticsIdentity, type FormAnalyticsProperties, type FormAnalyticsTrackFn, type FormErrorCategory, } from './formAnalyticsTypes';
+export { sanitizeFormAnalyticsProperties } from './sanitizeFormAnalyticsProperties';
+export { type UseFormAnalyticsOptions, useFormAnalytics } from './useFormAnalytics';
+//# sourceMappingURL=index.d.ts.map

package/dist/analytics/form/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analytics/form/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iCAAiC,EACtC,0BAA0B,EAC1B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,GAC/B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EAAE,KAAK,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/analytics/form/index.js

@@ -0,0 +1,5 @@
+export { createFormAnalyticsSession, } from './createFormAnalyticsSession';
+export { FORM_ANALYTICS_ALLOWED_KEYS, FORM_ANALYTICS_EVENT_NAMES, FORM_ANALYTICS_EVENTS, FORM_ERROR_CATEGORIES, } from './formAnalyticsTypes';
+export { sanitizeFormAnalyticsProperties } from './sanitizeFormAnalyticsProperties';
+export { useFormAnalytics } from './useFormAnalytics';
+//# sourceMappingURL=index.js.map

package/dist/analytics/form/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analytics/form/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,0BAA0B,GAG3B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,GAQtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EAAgC,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/analytics/form/sanitizeFormAnalyticsProperties.d.ts

@@ -0,0 +1,9 @@
+import { type FormAnalyticsProperties } from './formAnalyticsTypes';
+/**
+ * Whitelist form analytics payloads. Drops unknown keys, nested objects, arrays,
+ * and unconstrained free text. Email/phone heuristics apply to `form_name` only;
+ * `form_id`, `cms_entry_id`, and `error_code` use the identifier token pattern
+ * so HubSpot UUIDs and digits-only ids are not dropped.
+ */
+export declare function sanitizeFormAnalyticsProperties(properties: FormAnalyticsProperties | Record<string, unknown>): Record<string, string | number>;
+//# sourceMappingURL=sanitizeFormAnalyticsProperties.d.ts.map

package/dist/analytics/form/sanitizeFormAnalyticsProperties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizeFormAnalyticsProperties.d.ts","sourceRoot":"","sources":["../../../src/analytics/form/sanitizeFormAnalyticsProperties.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AA4C9B;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5D,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAqBjC"}

package/dist/analytics/form/sanitizeFormAnalyticsProperties.js

@@ -0,0 +1,62 @@
+import { FORM_ANALYTICS_ALLOWED_KEYS, FORM_ERROR_CATEGORIES, } from './formAnalyticsTypes';
+const ERROR_CATEGORY_SET = new Set(Object.values(FORM_ERROR_CATEGORIES));
+/** Identifier-like tokens: HubSpot GUIDs, Contentful ids, snake_case codes. */
+const SAFE_TOKEN = /^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,99}$/;
+const MAX_STRING_LENGTH = 100;
+function looksLikeEmail(value) {
+    return value.includes('@');
+}
+function looksLikePhone(value) {
+    const digits = value.replace(/\D/g, '');
+    return digits.length >= 7 && digits.length / value.replace(/\s/g, '').length >= 0.6;
+}
+function sanitizeString(key, raw) {
+    const trimmed = raw.trim().slice(0, MAX_STRING_LENGTH);
+    if (!trimmed) {
+        return undefined;
+    }
+    if (key === 'form_name') {
+        if (looksLikeEmail(trimmed) || looksLikePhone(trimmed)) {
+            return undefined;
+        }
+        return trimmed;
+    }
+    if (key === 'error_category') {
+        return ERROR_CATEGORY_SET.has(trimmed) ? trimmed : undefined;
+    }
+    if (key === 'error_code' ||
+        key === 'form_id' ||
+        key === 'form_type' ||
+        key === 'cms_entry_id' ||
+        key === 'step') {
+        return SAFE_TOKEN.test(trimmed) ? trimmed : undefined;
+    }
+    return undefined;
+}
+/**
+ * Whitelist form analytics payloads. Drops unknown keys, nested objects, arrays,
+ * and unconstrained free text. Email/phone heuristics apply to `form_name` only;
+ * `form_id`, `cms_entry_id`, and `error_code` use the identifier token pattern
+ * so HubSpot UUIDs and digits-only ids are not dropped.
+ */
+export function sanitizeFormAnalyticsProperties(properties) {
+    const out = {};
+    for (const key of FORM_ANALYTICS_ALLOWED_KEYS) {
+        const value = properties[key];
+        if (value === undefined || value === null) {
+            continue;
+        }
+        if (typeof value === 'number' && Number.isFinite(value) && key === 'step') {
+            out[key] = value;
+            continue;
+        }
+        if (typeof value === 'string') {
+            const sanitized = sanitizeString(key, value);
+            if (sanitized !== undefined) {
+                out[key] = sanitized;
+            }
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=sanitizeFormAnalyticsProperties.js.map

package/dist/analytics/form/sanitizeFormAnalyticsProperties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizeFormAnalyticsProperties.js","sourceRoot":"","sources":["../../../src/analytics/form/sanitizeFormAnalyticsProperties.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,GAGtB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC;AAEjF,+EAA+E;AAC/E,MAAM,UAAU,GAAG,oCAAoC,CAAC;AAExD,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACxC,OAAO,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC;AACtF,CAAC;AAED,SAAS,cAAc,CAAC,GAA4B,EAAE,GAAW;IAC/D,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;IACvD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;QACxB,IAAI,cAAc,CAAC,OAAO,CAAC,IAAI,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;YACvD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,GAAG,KAAK,gBAAgB,EAAE,CAAC;QAC7B,OAAO,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,CAAC;IACD,IACE,GAAG,KAAK,YAAY;QACpB,GAAG,KAAK,SAAS;QACjB,GAAG,KAAK,WAAW;QACnB,GAAG,KAAK,cAAc;QACtB,GAAG,KAAK,MAAM,EACd,CAAC;QACD,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACxD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAC7C,UAA6D;IAE7D,MAAM,GAAG,GAAoC,EAAE,CAAC;IAEhD,KAAK,MAAM,GAAG,IAAI,2BAA2B,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,SAAS;QACX,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YAC1E,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACjB,SAAS;QACX,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC7C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/analytics/form/useFormAnalytics.d.ts

@@ -0,0 +1,13 @@
+import { type FormAnalyticsSession } from './createFormAnalyticsSession';
+import type { FormAnalyticsIdentity } from './formAnalyticsTypes';
+export interface UseFormAnalyticsOptions {
+    identity: FormAnalyticsIdentity;
+    /** When false, no events are emitted. Default true. */
+    enabled?: boolean;
+}
+/**
+ * Binds a form analytics session to `useAnalytics().trackEvent`.
+ * Fires `form_view` once on mount when enabled (not on viewport impression).
+ */
+export declare function useFormAnalytics({ identity, enabled, }: UseFormAnalyticsOptions): FormAnalyticsSession;
+//# sourceMappingURL=useFormAnalytics.d.ts.map

package/dist/analytics/form/useFormAnalytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormAnalytics.d.ts","sourceRoot":"","sources":["../../../src/analytics/form/useFormAnalytics.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAA0B,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE1F,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,OAAc,GACf,EAAE,uBAAuB,GAAG,oBAAoB,CAsEhD"}

package/dist/analytics/form/useFormAnalytics.js

@@ -0,0 +1,67 @@
+'use client';
+import { useCallback, useEffect, useRef } from 'react';
+import { useAnalytics } from '../useAnalytics';
+import { createFormAnalyticsSession, } from './createFormAnalyticsSession';
+/**
+ * Binds a form analytics session to `useAnalytics().trackEvent`.
+ * Fires `form_view` once on mount when enabled (not on viewport impression).
+ */
+export function useFormAnalytics({ identity, enabled = true, }) {
+    const { trackEvent } = useAnalytics();
+    const trackEventRef = useRef(trackEvent);
+    trackEventRef.current = trackEvent;
+    const sessionRef = useRef(null);
+    const formId = identity.form_id ?? '';
+    const formName = identity.form_name ?? '';
+    const formType = identity.form_type ?? '';
+    const cmsEntryId = identity.cms_entry_id ?? '';
+    const step = identity.step ?? '';
+    useEffect(() => {
+        if (!enabled) {
+            sessionRef.current = null;
+            return;
+        }
+        const session = createFormAnalyticsSession({
+            identity: {
+                form_id: formId || undefined,
+                form_name: formName || undefined,
+                form_type: formType || undefined,
+                cms_entry_id: cmsEntryId || undefined,
+                step: step === '' ? undefined : step,
+            },
+            track: (event, properties) => {
+                trackEventRef.current(event, properties);
+            },
+        });
+        sessionRef.current = session;
+        session.markView();
+        return () => {
+            if (sessionRef.current === session) {
+                sessionRef.current = null;
+            }
+        };
+    }, [enabled, formId, formName, formType, cmsEntryId, step]);
+    const markView = useCallback(() => {
+        sessionRef.current?.markView();
+    }, []);
+    const markStart = useCallback(() => {
+        sessionRef.current?.markStart();
+    }, []);
+    const markSubmit = useCallback(() => {
+        sessionRef.current?.markSubmit();
+    }, []);
+    const markError = useCallback((info) => {
+        sessionRef.current?.markError(info);
+    }, []);
+    const getState = useCallback(() => {
+        return (sessionRef.current?.getState() ?? {
+            viewed: false,
+            started: false,
+            submitCount: 0,
+            errorCount: 0,
+            validationErrorThisAttempt: false,
+        });
+    }, []);
+    return { markView, markStart, markSubmit, markError, getState };
+}
+//# sourceMappingURL=useFormAnalytics.js.map

package/dist/analytics/form/useFormAnalytics.js.map

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

package/dist/analytics/formAnalyticsEntry.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Slim client-safe entry for form lifecycle analytics.
+ * Import from `@se-studio/core-ui/form-analytics` in HubSpot/forms so the
+ * main `core-ui` barrel (Visual / Lottie) is not pulled into the form graph.
+ */
+export { AnalyticsProvider, useAnalyticsContext } from './AnalyticsProvider';
+export { type CreateFormAnalyticsSessionOptions, createFormAnalyticsSession, FORM_ANALYTICS_ALLOWED_KEYS, FORM_ANALYTICS_EVENT_NAMES, FORM_ANALYTICS_EVENTS, FORM_ERROR_CATEGORIES, type FormAnalyticsAllowedKey, type FormAnalyticsErrorInfo, type FormAnalyticsEventName, type FormAnalyticsIdentity, type FormAnalyticsProperties, type FormAnalyticsSession, type FormAnalyticsSessionState, type FormAnalyticsTrackFn, type FormErrorCategory, sanitizeFormAnalyticsProperties, type UseFormAnalyticsOptions, useFormAnalytics, } from './form';
+export type { AnalyticsAdapter, ClickTrackingProperties, PageTrackingProperties } from './types';
+export { useAnalytics } from './useAnalytics';
+//# sourceMappingURL=formAnalyticsEntry.d.ts.map

package/dist/analytics/formAnalyticsEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formAnalyticsEntry.d.ts","sourceRoot":"","sources":["../../src/analytics/formAnalyticsEntry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EACL,KAAK,iCAAiC,EACtC,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,+BAA+B,EAC/B,KAAK,uBAAuB,EAC5B,gBAAgB,GACjB,MAAM,QAAQ,CAAC;AAChB,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AACjG,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/analytics/formAnalyticsEntry.js

@@ -0,0 +1,9 @@
+/**
+ * Slim client-safe entry for form lifecycle analytics.
+ * Import from `@se-studio/core-ui/form-analytics` in HubSpot/forms so the
+ * main `core-ui` barrel (Visual / Lottie) is not pulled into the form graph.
+ */
+export { AnalyticsProvider, useAnalyticsContext } from './AnalyticsProvider';
+export { createFormAnalyticsSession, FORM_ANALYTICS_ALLOWED_KEYS, FORM_ANALYTICS_EVENT_NAMES, FORM_ANALYTICS_EVENTS, FORM_ERROR_CATEGORIES, sanitizeFormAnalyticsProperties, useFormAnalytics, } from './form';
+export { useAnalytics } from './useAnalytics';
+//# sourceMappingURL=formAnalyticsEntry.js.map

package/dist/analytics/formAnalyticsEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formAnalyticsEntry.js","sourceRoot":"","sources":["../../src/analytics/formAnalyticsEntry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAEL,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EAUrB,+BAA+B,EAE/B,gBAAgB,GACjB,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/analytics/types.d.ts

@@ -17,6 +17,15 @@ export interface PageTrackingProperties extends IAnalyticsContext {
     url: string;
     pathname: string;
 }
+/**
+ * Consent Mode / adapter consent payload.
+ * `analytics` maps to analytics_storage (GTM) and HubSpot tracking.
+ * `advertising` maps to ad_storage / ad_user_data / ad_personalization (GTM).
+ */
+export interface AnalyticsConsentState {
+    analytics?: boolean;
+    advertising?: boolean;
+}
 /**
  * Interface that analytics adapters must implement
  */
@@ -38,5 +47,16 @@ export interface AnalyticsAdapter {
      * @param properties - Click tracking properties
      */
     trackClick(properties: ClickTrackingProperties): void;
+    /**
+     * Load vendor scripts. Optional — not all adapters need a script.
+     * `ConsentAwareAdapter` always forwards this; vendors that must not load
+     * while consent is denied (HubSpot) self-gate inside `initialize`.
+     */
+    initialize?(): void;
+    /**
+     * Apply a consent change (GTM Consent Mode update, HubSpot `doNotTrack`).
+     * Called by `ConsentAwareAdapter` on initialize and when consent flips.
+     */
+    updateConsent?(consent: AnalyticsConsentState): void;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/analytics/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/analytics/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAErE;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAEjE;;;OAGG;IACH,UAAU,CAAC,UAAU,EAAE,uBAAuB,GAAG,IAAI,CAAC;CACvD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/analytics/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAErE;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAEjE;;;OAGG;IACH,UAAU,CAAC,UAAU,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAEtD;;;;OAIG;IACH,UAAU,CAAC,IAAI,IAAI,CAAC;IAEpB;;;OAGG;IACH,aAAa,CAAC,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACtD"}

package/dist/index.d.ts

@@ -37,8 +37,11 @@ export type { RenderMark, RenderNode, RenderText } from '@contentful/rich-text-r
 export type { AnalyticsPageTrackerProps } from './analytics/AnalyticsPageTracker';
 export { AnalyticsPageTracker } from './analytics/AnalyticsPageTracker';
 export { AnalyticsProvider, useAnalyticsContext } from './analytics/AnalyticsProvider';
+export type { ConsentAwareAdapterOptions } from './analytics/adapters';
 export { CompositeAnalyticsAdapter, ConsentAwareAdapter, ConsoleAnalyticsAdapter, GoogleTagManagerAdapter, } from './analytics/adapters';
-export type { AnalyticsAdapter, ClickTrackingProperties, PageTrackingProperties, } from './analytics/types';
+export type { ConsentModel, ConsentStatus, PrivacySignalNavigator, ResolveAnalyticsConsentOptions, } from './analytics/consent/resolveAnalyticsConsent';
+export { createConsentGetter, resolveAnalyticsConsent, } from './analytics/consent/resolveAnalyticsConsent';
+export type { AnalyticsAdapter, AnalyticsConsentState, ClickTrackingProperties, PageTrackingProperties, } from './analytics/types';
 export { useAnalytics } from './analytics/useAnalytics';
 export type { CreateVideoEngagementSessionOptions, UseVideoEngagementOptions, VideoEngagementEventName, VideoEngagementIdentity, VideoEngagementSession, VideoEngagementTrackFn, VideoProvider, } from './analytics/video';
 export { createVideoEngagementSession, useHtml5VideoEngagement, useVideoEngagement, VIDEO_ENGAGEMENT_EVENT_NAMES, VIDEO_ENGAGEMENT_EVENTS, VIDEO_ENGAGEMENT_THRESHOLDS, } from './analytics/video';