@walkeros/web-source-cmp-usercentrics 4.2.0 → 4.2.1-next-1781526381392

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @walkeros/web-source-cmp-usercentrics
 
+## 4.2.1-next-1781526381392
+
+### Patch Changes
+
+- ec84331: Use the official Usercentrics events (UC_UI_INITIALIZED,
+  UC_UI_CMP_EVENT) and consent getters so a returning visitor's prior choice is
+  applied on load and first-visit defaults stay suppressed under explicitOnly.
+  The configurable eventName data-layer setting is removed; the source now uses
+  the always-emitted official events. Fixes consent-change events being dropped
+  on the current Usercentrics Web CMP.
+- Updated dependencies [5cbcd23]
+  - @walkeros/core@4.2.1-next-1781526381392
+  - @walkeros/collector@4.2.1-next-1781526381392
+
 ## 4.2.0
 
 ### Patch Changes

package/README.md

@@ -6,9 +6,9 @@
 
 # @walkeros/web-source-cmp-usercentrics
 
-Integrates Usercentrics consent management with walkerOS by listening for a
-configured window event and mapping category or service consent state to
-walkerOS consent groups.
+Integrates Usercentrics consent management with walkerOS using the official
+Usercentrics events and consent getters, mapping category or service consent
+state to walkerOS consent groups.
 
 [Documentation](https://www.walkeros.io/docs/sources/web/cmps/usercentrics)
 •
@@ -37,6 +37,39 @@ await startFlow({
 });
 ```
 
+## How it works
+
+The source uses Usercentrics' official integration surface, no custom data-layer
+event is required:
+
+1. Already initialized: if the CMP has loaded before the source, consent is read
+   statically through the official getters (V2 `UC_UI.getServicesBaseInfo()`, V3
+   `__ucCmp.getConsentDetails()`).
+2. CMP loads after the source: the source listens for `UC_UI_INITIALIZED` and
+   reads the current consent state once the CMP signals it is ready.
+3. User decisions: the source listens for `UC_UI_CMP_EVENT` (consent actions
+   `ACCEPT_ALL`, `DENY_ALL`, and `SAVE`) and republishes the updated state.
+
+Consent is then mapped via `categoryMap` and published with
+`elb('walker consent', state)`.
+
+## Timing considerations
+
+A returning visitor's prior choice is applied on page load, either from the
+static getter read (CMP already initialized) or on `UC_UI_INITIALIZED` (CMP
+loads later). First-visit defaults are suppressed under the default
+`explicitOnly: true`: only a state the user has actively decided is published
+(V3 `consent.type === EXPLICIT`; V2 an `EXPLICIT` entry in the service consent
+history). Set `explicitOnly: false` to publish any consent snapshot, including
+implicit first-visit defaults.
+
+## Settings
+
+`explicitOnly` (default `true`) is the cross-version gate for "the user has
+actively decided," applied identically for V2 and V3. There is no configurable
+data-layer event setting: the `eventName` setting has been removed, and the
+source listens to the always-emitted official events.
+
 ## Documentation
 
 Full configuration, mapping, and examples live in the docs:

package/dist/dev.d.mts

@@ -31,9 +31,20 @@ interface UsercentricsEventDetail {
 declare global {
     interface WindowEventMap {
         ucEvent: CustomEvent<UsercentricsEventDetail>;
+        UC_UI_INITIALIZED: Event;
         UC_UI_CMP_EVENT: CustomEvent<UsercentricsV3CmpEventDetail>;
     }
 }
+/** Usercentrics CONSENT_TYPE values (history entry type / V3 consent type). */
+type UsercentricsConsentType = 'explicit' | 'implicit';
+/** A single entry in a V2 service's consent history (getServicesBaseInfo). */
+interface UsercentricsV2ConsentHistoryEntry {
+    type: UsercentricsConsentType;
+    status: boolean;
+    /** CONSENT_ACTION, e.g. 'onAcceptAllServices' | 'onInitialPageLoad'. Not read for the gate. */
+    action?: string;
+    timestamp?: number;
+}
 /**
  * Usercentrics V2 service info shape returned by `UC_UI.getServicesBaseInfo()`.
  * Only the fields we use are typed - minimal surface, not a full V2 API mirror.
@@ -41,9 +52,13 @@ declare global {
 interface UsercentricsV2Service {
     /** Category slug: 'essential' | 'functional' | 'marketing' | custom */
     categorySlug: string;
+    /** Service display name (used for service-level consent keys) */
+    name?: string;
     /** Consent state for this service */
     consent: {
         status: boolean;
+        /** Consent decision history; an 'explicit' entry proves a real user decision. */
+        history?: UsercentricsV2ConsentHistoryEntry[];
     };
 }
 /**
@@ -55,6 +70,7 @@ interface UsercentricsV2Service {
 interface UsercentricsV2Api {
     isInitialized?: () => boolean;
     getServicesBaseInfo?: () => UsercentricsV2Service[];
+    getServicesFullInfo?: () => Promise<UsercentricsV2Service[]>;
     areAllConsentsAccepted?: () => boolean;
 }
 /**
@@ -101,8 +117,9 @@ interface UsercentricsV3Api {
  * `source: 'CMP'` + a decision `type` tells us a user action has been taken.
  */
 interface UsercentricsV3CmpEventDetail {
-    source?: string;
+    source?: 'none' | 'button' | 'first' | 'second' | 'embeddings' | '__ucCmp' | string;
     type?: string;
+    abTestVariant?: string;
 }
 declare global {
     interface Window {
@@ -122,71 +139,61 @@ declare global {
 }
 
 /**
- * Example Usercentrics consent event detail inputs.
+ * Example Usercentrics V2 service inputs.
  *
- * These represent real event.detail payloads from Usercentrics CMP.
- */
-/**
- * Full consent - user accepted all categories (explicit)
+ * These mirror the shape returned by `window.UC_UI.getServicesBaseInfo()`:
+ * an array of services, each carrying a `categorySlug`, optional display
+ * `name`, and a `consent` block with the current `status` plus a decision
+ * `history`. The adapter derives the explicit/implicit gate from whether any
+ * history entry is `explicit`, and aggregates services into group-level
+ * consent via strict AND per `categorySlug`.
  */
-declare const fullConsent$1: UsercentricsEventDetail;
 /**
- * Partial consent - user accepted only essential and functional (explicit)
+ * Full consent - every category accepted via an explicit decision
+ * (user clicked "Accept all").
  */
-declare const partialConsent: UsercentricsEventDetail;
+declare const servicesFullExplicit: UsercentricsV2Service[];
 /**
- * Minimal consent - user denied everything except essential (explicit)
+ * Minimal consent - only essential accepted, others denied via an explicit
+ * decision (user clicked "Deny all").
  */
-declare const minimalConsent$1: UsercentricsEventDetail;
+declare const servicesMinimalExplicit: UsercentricsV2Service[];
 /**
- * Implicit consent - page load with default consent state
- * (not an explicit user choice)
+ * Partial consent - essential and functional accepted, marketing denied,
+ * all via an explicit decision (user saved a custom selection).
  */
-declare const implicitConsent: UsercentricsEventDetail;
+declare const servicesPartialExplicit: UsercentricsV2Service[];
 /**
- * Explicit consent with uppercase type field (Usercentrics docs are
- * inconsistent about casing - some show 'EXPLICIT', others 'explicit')
+ * First-visit implicit state - the CMP reports page-load defaults with only
+ * implicit history. The default `explicitOnly` gate suppresses this, so no
+ * consent command is emitted.
  */
-declare const fullConsentUpperCase: UsercentricsEventDetail;
-/**
- * Service-level consent - ucCategory has mixed types (non-boolean values
- * indicate individual service-level choice rather than group-level)
- */
-declare const serviceLevelConsent: UsercentricsEventDetail;
-/**
- * Non-consent event (should be ignored)
- */
-declare const nonConsentEvent: UsercentricsEventDetail;
+declare const servicesFirstVisitImplicit: UsercentricsV2Service[];
 
 /**
  * Expected walkerOS consent outputs.
  *
- * These represent the consent state after parsing Usercentrics event details
- * with no category mapping configured (pass-through).
+ * These represent the consent state emitted via `elb('walker consent', state)`
+ * after the V2 adapter aggregates `getServicesBaseInfo()` into group-level
+ * consent (no category mapping configured: pass-through by `categorySlug`).
  */
 /**
- * Full consent - all categories true (group-level)
+ * Full consent - all categories granted.
  */
 declare const fullConsentMapped: WalkerOS.Consent;
 /**
- * Partial consent - essential and functional true, marketing false
+ * Partial consent - essential and functional granted, marketing denied.
  */
 declare const partialConsentMapped: WalkerOS.Consent;
 /**
- * Minimal consent - only essential true
+ * Minimal consent - only essential granted.
  */
 declare const minimalConsentMapped: WalkerOS.Consent;
 /**
- * Full consent with custom category mapping applied
- * (essential->functional, functional->functional, marketing->marketing)
+ * Full consent with a custom category mapping applied
+ * (essential->functional, functional->analytics).
  */
 declare const fullConsentCustomMapped: WalkerOS.Consent;
-/**
- * Service-level consent - individual service booleans + boolean ucCategory entries
- * (services normalized: lowercase, spaces to underscores)
- * (ucCategory boolean entries mapped through categoryMap)
- */
-declare const serviceLevelMapped: WalkerOS.Consent;
 
 /**
  * Create a properly typed elb/push function mock
@@ -197,17 +204,32 @@ declare const createMockElbFn: () => Elb.Fn;
  */
 declare const noopLogger: Logger.Instance;
 
+/**
+ * Step examples for the Usercentrics V2 path.
+ *
+ * `in` is the array returned by `window.UC_UI.getServicesBaseInfo()`. The test
+ * runner attaches it as the V2 API, then drives the official trigger named in
+ * `trigger.options.dispatch`:
+ *   - 'init'  (default): UC_UI is present when the source runs, so the static
+ *     read at init emits the snapshot (also the `UC_UI_INITIALIZED` path).
+ *   - 'cmp': UC_UI is attached only after init, then a `UC_UI_CMP_EVENT`
+ *     decision (ACCEPT_ALL) re-reads and emits — the consent-change path.
+ */
 declare const fullConsent: Flow.StepExample;
 declare const minimalConsent: Flow.StepExample;
+declare const returningVisitor: Flow.StepExample;
+declare const firstVisitImplicit: Flow.StepExample;
+declare const consentChange: Flow.StepExample;
 declare const categoryMapOverride: Flow.StepExample;
-declare const customEventName: Flow.StepExample;
 
 declare const step_categoryMapOverride: typeof categoryMapOverride;
-declare const step_customEventName: typeof customEventName;
+declare const step_consentChange: typeof consentChange;
+declare const step_firstVisitImplicit: typeof firstVisitImplicit;
 declare const step_fullConsent: typeof fullConsent;
 declare const step_minimalConsent: typeof minimalConsent;
+declare const step_returningVisitor: typeof returningVisitor;
 declare namespace step {
-  export { step_categoryMapOverride as categoryMapOverride, step_customEventName as customEventName, step_fullConsent as fullConsent, step_minimalConsent as minimalConsent };
+  export { step_categoryMapOverride as categoryMapOverride, step_consentChange as consentChange, step_firstVisitImplicit as firstVisitImplicit, step_fullConsent as fullConsent, step_minimalConsent as minimalConsent, step_returningVisitor as returningVisitor };
 }
 
 interface UsercentricsContent {
@@ -225,26 +247,23 @@ declare const index$1_createMockElbFn: typeof createMockElbFn;
 declare const index$1_createTrigger: typeof createTrigger;
 declare const index$1_fullConsentCustomMapped: typeof fullConsentCustomMapped;
 declare const index$1_fullConsentMapped: typeof fullConsentMapped;
-declare const index$1_fullConsentUpperCase: typeof fullConsentUpperCase;
-declare const index$1_implicitConsent: typeof implicitConsent;
 declare const index$1_minimalConsentMapped: typeof minimalConsentMapped;
-declare const index$1_nonConsentEvent: typeof nonConsentEvent;
 declare const index$1_noopLogger: typeof noopLogger;
-declare const index$1_partialConsent: typeof partialConsent;
 declare const index$1_partialConsentMapped: typeof partialConsentMapped;
-declare const index$1_serviceLevelConsent: typeof serviceLevelConsent;
-declare const index$1_serviceLevelMapped: typeof serviceLevelMapped;
+declare const index$1_servicesFirstVisitImplicit: typeof servicesFirstVisitImplicit;
+declare const index$1_servicesFullExplicit: typeof servicesFullExplicit;
+declare const index$1_servicesMinimalExplicit: typeof servicesMinimalExplicit;
+declare const index$1_servicesPartialExplicit: typeof servicesPartialExplicit;
 declare const index$1_step: typeof step;
 declare const index$1_trigger: typeof trigger;
 declare namespace index$1 {
-  export { index$1_createMockElbFn as createMockElbFn, index$1_createTrigger as createTrigger, fullConsent$1 as fullConsent, index$1_fullConsentCustomMapped as fullConsentCustomMapped, index$1_fullConsentMapped as fullConsentMapped, index$1_fullConsentUpperCase as fullConsentUpperCase, index$1_implicitConsent as implicitConsent, minimalConsent$1 as minimalConsent, index$1_minimalConsentMapped as minimalConsentMapped, index$1_nonConsentEvent as nonConsentEvent, index$1_noopLogger as noopLogger, index$1_partialConsent as partialConsent, index$1_partialConsentMapped as partialConsentMapped, index$1_serviceLevelConsent as serviceLevelConsent, index$1_serviceLevelMapped as serviceLevelMapped, index$1_step as step, index$1_trigger as trigger };
+  export { index$1_createMockElbFn as createMockElbFn, index$1_createTrigger as createTrigger, index$1_fullConsentCustomMapped as fullConsentCustomMapped, index$1_fullConsentMapped as fullConsentMapped, index$1_minimalConsentMapped as minimalConsentMapped, index$1_noopLogger as noopLogger, index$1_partialConsentMapped as partialConsentMapped, index$1_servicesFirstVisitImplicit as servicesFirstVisitImplicit, index$1_servicesFullExplicit as servicesFullExplicit, index$1_servicesMinimalExplicit as servicesMinimalExplicit, index$1_servicesPartialExplicit as servicesPartialExplicit, index$1_step as step, index$1_trigger as trigger };
 }
 
 /**
  * Usercentrics source settings schema
  */
 declare const SettingsSchema: z.ZodObject<{
-    eventName: z.ZodOptional<z.ZodString>;
     categoryMap: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     explicitOnly: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;

package/dist/dev.d.ts

@@ -31,9 +31,20 @@ interface UsercentricsEventDetail {
 declare global {
     interface WindowEventMap {
         ucEvent: CustomEvent<UsercentricsEventDetail>;
+        UC_UI_INITIALIZED: Event;
         UC_UI_CMP_EVENT: CustomEvent<UsercentricsV3CmpEventDetail>;
     }
 }
+/** Usercentrics CONSENT_TYPE values (history entry type / V3 consent type). */
+type UsercentricsConsentType = 'explicit' | 'implicit';
+/** A single entry in a V2 service's consent history (getServicesBaseInfo). */
+interface UsercentricsV2ConsentHistoryEntry {
+    type: UsercentricsConsentType;
+    status: boolean;
+    /** CONSENT_ACTION, e.g. 'onAcceptAllServices' | 'onInitialPageLoad'. Not read for the gate. */
+    action?: string;
+    timestamp?: number;
+}
 /**
  * Usercentrics V2 service info shape returned by `UC_UI.getServicesBaseInfo()`.
  * Only the fields we use are typed - minimal surface, not a full V2 API mirror.
@@ -41,9 +52,13 @@ declare global {
 interface UsercentricsV2Service {
     /** Category slug: 'essential' | 'functional' | 'marketing' | custom */
     categorySlug: string;
+    /** Service display name (used for service-level consent keys) */
+    name?: string;
     /** Consent state for this service */
     consent: {
         status: boolean;
+        /** Consent decision history; an 'explicit' entry proves a real user decision. */
+        history?: UsercentricsV2ConsentHistoryEntry[];
     };
 }
 /**
@@ -55,6 +70,7 @@ interface UsercentricsV2Service {
 interface UsercentricsV2Api {
     isInitialized?: () => boolean;
     getServicesBaseInfo?: () => UsercentricsV2Service[];
+    getServicesFullInfo?: () => Promise<UsercentricsV2Service[]>;
     areAllConsentsAccepted?: () => boolean;
 }
 /**
@@ -101,8 +117,9 @@ interface UsercentricsV3Api {
  * `source: 'CMP'` + a decision `type` tells us a user action has been taken.
  */
 interface UsercentricsV3CmpEventDetail {
-    source?: string;
+    source?: 'none' | 'button' | 'first' | 'second' | 'embeddings' | '__ucCmp' | string;
     type?: string;
+    abTestVariant?: string;
 }
 declare global {
     interface Window {
@@ -122,71 +139,61 @@ declare global {
 }
 
 /**
- * Example Usercentrics consent event detail inputs.
+ * Example Usercentrics V2 service inputs.
  *
- * These represent real event.detail payloads from Usercentrics CMP.
- */
-/**
- * Full consent - user accepted all categories (explicit)
+ * These mirror the shape returned by `window.UC_UI.getServicesBaseInfo()`:
+ * an array of services, each carrying a `categorySlug`, optional display
+ * `name`, and a `consent` block with the current `status` plus a decision
+ * `history`. The adapter derives the explicit/implicit gate from whether any
+ * history entry is `explicit`, and aggregates services into group-level
+ * consent via strict AND per `categorySlug`.
  */
-declare const fullConsent$1: UsercentricsEventDetail;
 /**
- * Partial consent - user accepted only essential and functional (explicit)
+ * Full consent - every category accepted via an explicit decision
+ * (user clicked "Accept all").
  */
-declare const partialConsent: UsercentricsEventDetail;
+declare const servicesFullExplicit: UsercentricsV2Service[];
 /**
- * Minimal consent - user denied everything except essential (explicit)
+ * Minimal consent - only essential accepted, others denied via an explicit
+ * decision (user clicked "Deny all").
  */
-declare const minimalConsent$1: UsercentricsEventDetail;
+declare const servicesMinimalExplicit: UsercentricsV2Service[];
 /**
- * Implicit consent - page load with default consent state
- * (not an explicit user choice)
+ * Partial consent - essential and functional accepted, marketing denied,
+ * all via an explicit decision (user saved a custom selection).
  */
-declare const implicitConsent: UsercentricsEventDetail;
+declare const servicesPartialExplicit: UsercentricsV2Service[];
 /**
- * Explicit consent with uppercase type field (Usercentrics docs are
- * inconsistent about casing - some show 'EXPLICIT', others 'explicit')
+ * First-visit implicit state - the CMP reports page-load defaults with only
+ * implicit history. The default `explicitOnly` gate suppresses this, so no
+ * consent command is emitted.
  */
-declare const fullConsentUpperCase: UsercentricsEventDetail;
-/**
- * Service-level consent - ucCategory has mixed types (non-boolean values
- * indicate individual service-level choice rather than group-level)
- */
-declare const serviceLevelConsent: UsercentricsEventDetail;
-/**
- * Non-consent event (should be ignored)
- */
-declare const nonConsentEvent: UsercentricsEventDetail;
+declare const servicesFirstVisitImplicit: UsercentricsV2Service[];
 
 /**
  * Expected walkerOS consent outputs.
  *
- * These represent the consent state after parsing Usercentrics event details
- * with no category mapping configured (pass-through).
+ * These represent the consent state emitted via `elb('walker consent', state)`
+ * after the V2 adapter aggregates `getServicesBaseInfo()` into group-level
+ * consent (no category mapping configured: pass-through by `categorySlug`).
  */
 /**
- * Full consent - all categories true (group-level)
+ * Full consent - all categories granted.
  */
 declare const fullConsentMapped: WalkerOS.Consent;
 /**
- * Partial consent - essential and functional true, marketing false
+ * Partial consent - essential and functional granted, marketing denied.
  */
 declare const partialConsentMapped: WalkerOS.Consent;
 /**
- * Minimal consent - only essential true
+ * Minimal consent - only essential granted.
  */
 declare const minimalConsentMapped: WalkerOS.Consent;
 /**
- * Full consent with custom category mapping applied
- * (essential->functional, functional->functional, marketing->marketing)
+ * Full consent with a custom category mapping applied
+ * (essential->functional, functional->analytics).
  */
 declare const fullConsentCustomMapped: WalkerOS.Consent;
-/**
- * Service-level consent - individual service booleans + boolean ucCategory entries
- * (services normalized: lowercase, spaces to underscores)
- * (ucCategory boolean entries mapped through categoryMap)
- */
-declare const serviceLevelMapped: WalkerOS.Consent;
 
 /**
  * Create a properly typed elb/push function mock
@@ -197,17 +204,32 @@ declare const createMockElbFn: () => Elb.Fn;
  */
 declare const noopLogger: Logger.Instance;
 
+/**
+ * Step examples for the Usercentrics V2 path.
+ *
+ * `in` is the array returned by `window.UC_UI.getServicesBaseInfo()`. The test
+ * runner attaches it as the V2 API, then drives the official trigger named in
+ * `trigger.options.dispatch`:
+ *   - 'init'  (default): UC_UI is present when the source runs, so the static
+ *     read at init emits the snapshot (also the `UC_UI_INITIALIZED` path).
+ *   - 'cmp': UC_UI is attached only after init, then a `UC_UI_CMP_EVENT`
+ *     decision (ACCEPT_ALL) re-reads and emits — the consent-change path.
+ */
 declare const fullConsent: Flow.StepExample;
 declare const minimalConsent: Flow.StepExample;
+declare const returningVisitor: Flow.StepExample;
+declare const firstVisitImplicit: Flow.StepExample;
+declare const consentChange: Flow.StepExample;
 declare const categoryMapOverride: Flow.StepExample;
-declare const customEventName: Flow.StepExample;
 
 declare const step_categoryMapOverride: typeof categoryMapOverride;
-declare const step_customEventName: typeof customEventName;
+declare const step_consentChange: typeof consentChange;
+declare const step_firstVisitImplicit: typeof firstVisitImplicit;
 declare const step_fullConsent: typeof fullConsent;
 declare const step_minimalConsent: typeof minimalConsent;
+declare const step_returningVisitor: typeof returningVisitor;
 declare namespace step {
-  export { step_categoryMapOverride as categoryMapOverride, step_customEventName as customEventName, step_fullConsent as fullConsent, step_minimalConsent as minimalConsent };
+  export { step_categoryMapOverride as categoryMapOverride, step_consentChange as consentChange, step_firstVisitImplicit as firstVisitImplicit, step_fullConsent as fullConsent, step_minimalConsent as minimalConsent, step_returningVisitor as returningVisitor };
 }
 
 interface UsercentricsContent {
@@ -225,26 +247,23 @@ declare const index$1_createMockElbFn: typeof createMockElbFn;
 declare const index$1_createTrigger: typeof createTrigger;
 declare const index$1_fullConsentCustomMapped: typeof fullConsentCustomMapped;
 declare const index$1_fullConsentMapped: typeof fullConsentMapped;
-declare const index$1_fullConsentUpperCase: typeof fullConsentUpperCase;
-declare const index$1_implicitConsent: typeof implicitConsent;
 declare const index$1_minimalConsentMapped: typeof minimalConsentMapped;
-declare const index$1_nonConsentEvent: typeof nonConsentEvent;
 declare const index$1_noopLogger: typeof noopLogger;
-declare const index$1_partialConsent: typeof partialConsent;
 declare const index$1_partialConsentMapped: typeof partialConsentMapped;
-declare const index$1_serviceLevelConsent: typeof serviceLevelConsent;
-declare const index$1_serviceLevelMapped: typeof serviceLevelMapped;
+declare const index$1_servicesFirstVisitImplicit: typeof servicesFirstVisitImplicit;
+declare const index$1_servicesFullExplicit: typeof servicesFullExplicit;
+declare const index$1_servicesMinimalExplicit: typeof servicesMinimalExplicit;
+declare const index$1_servicesPartialExplicit: typeof servicesPartialExplicit;
 declare const index$1_step: typeof step;
 declare const index$1_trigger: typeof trigger;
 declare namespace index$1 {
-  export { index$1_createMockElbFn as createMockElbFn, index$1_createTrigger as createTrigger, fullConsent$1 as fullConsent, index$1_fullConsentCustomMapped as fullConsentCustomMapped, index$1_fullConsentMapped as fullConsentMapped, index$1_fullConsentUpperCase as fullConsentUpperCase, index$1_implicitConsent as implicitConsent, minimalConsent$1 as minimalConsent, index$1_minimalConsentMapped as minimalConsentMapped, index$1_nonConsentEvent as nonConsentEvent, index$1_noopLogger as noopLogger, index$1_partialConsent as partialConsent, index$1_partialConsentMapped as partialConsentMapped, index$1_serviceLevelConsent as serviceLevelConsent, index$1_serviceLevelMapped as serviceLevelMapped, index$1_step as step, index$1_trigger as trigger };
+  export { index$1_createMockElbFn as createMockElbFn, index$1_createTrigger as createTrigger, index$1_fullConsentCustomMapped as fullConsentCustomMapped, index$1_fullConsentMapped as fullConsentMapped, index$1_minimalConsentMapped as minimalConsentMapped, index$1_noopLogger as noopLogger, index$1_partialConsentMapped as partialConsentMapped, index$1_servicesFirstVisitImplicit as servicesFirstVisitImplicit, index$1_servicesFullExplicit as servicesFullExplicit, index$1_servicesMinimalExplicit as servicesMinimalExplicit, index$1_servicesPartialExplicit as servicesPartialExplicit, index$1_step as step, index$1_trigger as trigger };
 }
 
 /**
  * Usercentrics source settings schema
  */
 declare const SettingsSchema: z.ZodObject<{
-    eventName: z.ZodOptional<z.ZodString>;
     categoryMap: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     explicitOnly: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;

package/dist/dev.js

@@ -1 +1 @@
-"use strict";var e,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,i=Object.getOwnPropertyNames,o=Object.prototype.hasOwnProperty,a=(e,n)=>{for(var i in n)t(e,i,{get:n[i],enumerable:!0})},s={};a(s,{examples:()=>r,schemas:()=>O}),module.exports=(e=s,((e,a,s,r)=>{if(a&&"object"==typeof a||"function"==typeof a)for(let l of i(a))o.call(e,l)||l===s||t(e,l,{get:()=>a[l],enumerable:!(r=n(a,l))||r.enumerable});return e})(t({},"__esModule",{value:!0}),e));var r={};a(r,{createMockElbFn:()=>_,createTrigger:()=>x,fullConsent:()=>l,fullConsentCustomMapped:()=>k,fullConsentMapped:()=>y,fullConsentUpperCase:()=>u,implicitConsent:()=>p,minimalConsent:()=>g,minimalConsentMapped:()=>f,nonConsentEvent:()=>v,noopLogger:()=>b,partialConsent:()=>c,partialConsentMapped:()=>d,serviceLevelConsent:()=>m,serviceLevelMapped:()=>C,step:()=>A,trigger:()=>D});var l={event:"consent_status",type:"explicit",action:"onAcceptAllServices",ucCategory:{essential:!0,functional:!0,marketing:!0},"Google Analytics":!0,"Google Ads Remarketing":!0},c={event:"consent_status",type:"explicit",action:"onUpdateServices",ucCategory:{essential:!0,functional:!0,marketing:!1},"Google Analytics":!0,"Google Ads Remarketing":!1},g={event:"consent_status",type:"explicit",action:"onDenyAllServices",ucCategory:{essential:!0,functional:!1,marketing:!1},"Google Analytics":!1,"Google Ads Remarketing":!1},p={event:"consent_status",type:"implicit",ucCategory:{essential:!0,functional:!1,marketing:!1},"Google Analytics":!1,"Google Ads Remarketing":!1},u={event:"consent_status",type:"EXPLICIT",action:"onAcceptAllServices",ucCategory:{essential:!0,functional:!0,marketing:!0}},m={event:"consent_status",type:"explicit",action:"onUpdateServices",ucCategory:{essential:!0,functional:"partial",marketing:"partial"},"Google Analytics":!0,"Google Ads Remarketing":!1,Hotjar:!0},v={event:"other_event",type:"explicit"},y={essential:!0,functional:!0,marketing:!0},d={essential:!0,functional:!0,marketing:!1},f={essential:!0,functional:!1,marketing:!1},k={functional:!0,marketing:!0},C={essential:!0,google_analytics:!0,google_ads_remarketing:!1,hotjar:!0},w=()=>{},_=()=>()=>Promise.resolve({ok:!0}),b={error:w,warn:w,info:w,debug:w,throw:e=>{throw"string"==typeof e?new Error(e):e},json:w,scope:()=>b},A={};a(A,{categoryMapOverride:()=>h,customEventName:()=>M,fullConsent:()=>E,minimalConsent:()=>S});var E={title:"Full consent",description:"A Usercentrics onAcceptAllServices event emits a walker consent command with essential, functional, and marketing granted.",trigger:{type:"consent"},in:{event:"consent_status",type:"explicit",action:"onAcceptAllServices",ucCategory:{essential:!0,functional:!0,marketing:!0}},out:[["elb","walker consent",{essential:!0,functional:!0,marketing:!0}]]},S={title:"Minimal consent",description:"A Usercentrics onDenyAllServices event emits a walker consent command with only essential granted.",trigger:{type:"consent"},in:{event:"consent_status",type:"explicit",action:"onDenyAllServices",ucCategory:{essential:!0,functional:!1,marketing:!1}},out:[["elb","walker consent",{essential:!0,functional:!1,marketing:!1}]]},h={title:"Category map override",description:"Custom categoryMap remaps essential to functional and functional to analytics",trigger:{type:"consent"},in:{event:"consent_status",type:"explicit",ucCategory:{essential:!0,functional:!0,marketing:!1}},mapping:{categoryMap:{essential:"functional",functional:"analytics"}},out:[["elb","walker consent",{functional:!0,analytics:!0,marketing:!1}]]},M={title:"Custom event name",description:"Using UC_SDK_EVENT instead of ucEvent for Usercentrics SDK v2",trigger:{type:"consent",options:{eventName:"UC_SDK_EVENT"}},in:{event:"consent_status",type:"explicit",ucCategory:{essential:!0,functional:!0,marketing:!0}},mapping:{eventName:"UC_SDK_EVENT"},out:[["elb","walker consent",{essential:!0,functional:!0,marketing:!0}]]},U=require("@walkeros/collector"),x=async e=>{let t;return{get flow(){return t},trigger:(n,i)=>async n=>{var o;if(!t){const n=await(0,U.startFlow)({...e,run:null==(o=e.run)||o});t={collector:n.collector,elb:n.elb}}const a=(null==i?void 0:i.eventName)||"ucEvent";window.dispatchEvent(new CustomEvent(a,{detail:n}))}}},D=(e,t)=>{if(e&&"object"==typeof e)return()=>{t.window.dispatchEvent(new CustomEvent("ucEvent",{detail:e}))}},O={};a(O,{SettingsSchema:()=>N,settings:()=>P});var j=require("@walkeros/core/dev"),G=require("@walkeros/core/dev"),N=G.z.object({eventName:G.z.string().describe("Window event name to listen for, configured in the Usercentrics admin (Implementation > Data Layer & Events). Use 'UC_SDK_EVENT' for the built-in Browser SDK event. Default: 'ucEvent'.").optional(),categoryMap:G.z.record(G.z.string(),G.z.string()).describe("Map the CMP's consent categories (keys) to walkerOS consent groups (values).").optional(),explicitOnly:G.z.boolean().describe("Only process consent_status events where type is 'explicit'. Ignores implicit/default page-load events. Default: true.").optional()}).meta({id:"UsercentricsSettings",title:"Settings",description:"Settings for the Usercentrics CMP source."}),P=(0,j.zodToSchema)(N);//# sourceMappingURL=dev.js.map
+"use strict";var t,e=Object.defineProperty,i=Object.getOwnPropertyDescriptor,s=Object.getOwnPropertyNames,n=Object.prototype.hasOwnProperty,o=(t,i)=>{for(var s in i)e(t,s,{get:i[s],enumerable:!0})},a={};o(a,{examples:()=>r,schemas:()=>j}),module.exports=(t=a,((t,o,a,r)=>{if(o&&"object"==typeof o||"function"==typeof o)for(let c of s(o))n.call(t,c)||c===a||e(t,c,{get:()=>o[c],enumerable:!(r=i(o,c))||r.enumerable});return t})(e({},"__esModule",{value:!0}),t));var r={};o(r,{createMockElbFn:()=>f,createTrigger:()=>P,fullConsentCustomMapped:()=>m,fullConsentMapped:()=>g,minimalConsentMapped:()=>d,noopLogger:()=>v,partialConsentMapped:()=>y,servicesFirstVisitImplicit:()=>u,servicesFullExplicit:()=>c,servicesMinimalExplicit:()=>l,servicesPartialExplicit:()=>p,step:()=>w,trigger:()=>O});var c=[{categorySlug:"essential",consent:{status:!0,history:[{type:"explicit",status:!0}]}},{categorySlug:"functional",consent:{status:!0,history:[{type:"explicit",status:!0}]}},{categorySlug:"marketing",consent:{status:!0,history:[{type:"explicit",status:!0}]}}],l=[{categorySlug:"essential",consent:{status:!0,history:[{type:"explicit",status:!0}]}},{categorySlug:"functional",consent:{status:!1,history:[{type:"explicit",status:!1}]}},{categorySlug:"marketing",consent:{status:!1,history:[{type:"explicit",status:!1}]}}],p=[{categorySlug:"essential",consent:{status:!0,history:[{type:"explicit",status:!0}]}},{categorySlug:"functional",consent:{status:!0,history:[{type:"explicit",status:!0}]}},{categorySlug:"marketing",consent:{status:!1,history:[{type:"explicit",status:!1}]}}],u=[{categorySlug:"essential",consent:{status:!0,history:[{type:"implicit",status:!0}]}},{categorySlug:"functional",consent:{status:!1,history:[{type:"implicit",status:!1}]}},{categorySlug:"marketing",consent:{status:!1,history:[{type:"implicit",status:!1}]}}],g={essential:!0,functional:!0,marketing:!0},y={essential:!0,functional:!0,marketing:!1},d={essential:!0,functional:!1,marketing:!1},m={functional:!0,analytics:!0,marketing:!0},h=()=>{},f=()=>()=>Promise.resolve({ok:!0}),v={error:h,warn:h,info:h,debug:h,throw:t=>{throw"string"==typeof t?new Error(t):t},json:h,scope:()=>v},w={};o(w,{categoryMapOverride:()=>M,consentChange:()=>x,firstVisitImplicit:()=>S,fullConsent:()=>b,minimalConsent:()=>k,returningVisitor:()=>C});var b={title:"Full consent",description:"Usercentrics reports every category accepted via an explicit decision; the source emits a walker consent command granting essential, functional, and marketing.",trigger:{type:"consent",options:{dispatch:"init"}},in:c,out:[["elb","walker consent",g]]},k={title:"Minimal consent",description:'A "Deny all" explicit decision leaves only essential granted; functional and marketing are emitted as false.',trigger:{type:"consent",options:{dispatch:"init"}},in:l,out:[["elb","walker consent",d]]},C={title:"Returning visitor static read",description:"When the CMP is already initialized with a stored explicit decision, the static read at init re-publishes that choice without any further event.",trigger:{type:"consent",options:{dispatch:"init"}},in:p,out:[["elb","walker consent",{essential:!0,functional:!0,marketing:!1}]]},S={title:"First visit implicit (suppressed)",description:"A first-visit snapshot carrying only implicit history is suppressed by the default explicitOnly gate, so no consent command is emitted.",trigger:{type:"consent",options:{dispatch:"init"}},in:u,out:[]},x={title:"Consent change via CMP event",description:"An ACCEPT_ALL decision fires UC_UI_CMP_EVENT; the source re-reads the services and emits the updated consent.",trigger:{type:"consent",options:{dispatch:"cmp"}},in:c,out:[["elb","walker consent",g]]},M={title:"Category map override",description:"A custom categoryMap remaps essential to functional and functional to analytics before emitting the walker consent command.",trigger:{type:"consent",options:{dispatch:"init"}},in:c,mapping:{settings:{categoryMap:{essential:"functional",functional:"analytics"}}},out:[["elb","walker consent",m]]},E=require("@walkeros/collector"),P=async t=>{let e;return{get flow(){return e},trigger:(i,s)=>async i=>{var n;if(!e){const i=await(0,E.startFlow)({...t,run:null==(n=t.run)||n});e={collector:i.collector,elb:i.elb}}const o=(null==s?void 0:s.eventName)||"ucEvent";window.dispatchEvent(new CustomEvent(o,{detail:i}))}}},O=(t,e)=>{if(t&&"object"==typeof t)return()=>{e.window.dispatchEvent(new CustomEvent("ucEvent",{detail:t}))}},j={};o(j,{SettingsSchema:()=>A,settings:()=>F});var I=require("@walkeros/core/dev"),z=require("@walkeros/core/dev"),A=z.z.object({categoryMap:z.z.record(z.z.string(),z.z.string()).describe("Map the CMP's consent categories (keys) to walkerOS consent groups (values).").optional(),explicitOnly:z.z.boolean().describe("Only publish when the user has actively decided (V3: consent.type EXPLICIT; V2: an EXPLICIT entry in service consent history). Implicit/default page-load states are suppressed. Set false to publish any snapshot including implicit. Default: true.").optional()}).meta({id:"UsercentricsSettings",title:"Settings",description:"Settings for the Usercentrics CMP source."}),F=(0,I.zodToSchema)(A);//# sourceMappingURL=dev.js.map