@walkeros/web-source-cmp-cookiepro 0.1.0

package/README.md

@@ -0,0 +1,159 @@
+# @walkeros/web-source-cmp-cookiepro
+
+CookiePro/OneTrust consent management source for walkerOS.
+
+This source listens to
+[CookiePro/OneTrust](https://www.onetrust.com/products/cookie-consent/) CMP
+events and translates consent states to walkerOS consent commands.
+
+## Installation
+
+```bash
+npm install @walkeros/web-source-cmp-cookiepro
+```
+
+## Usage
+
+```typescript
+import { startFlow } from '@walkeros/collector';
+import { sourceCookiePro } from '@walkeros/web-source-cmp-cookiepro';
+// import { destinationGtag } from '@walkeros/web-destination-gtag';
+
+await startFlow({
+  sources: {
+    consent: {
+      code: sourceCookiePro,
+    },
+  },
+  destinations: {
+    gtag: {
+      code: destinationGtag,
+      config: {
+        consent: { analytics: true }, // Requires analytics consent
+      },
+    },
+  },
+});
+```
+
+## Configuration
+
+### Settings
+
+| Setting        | Type                     | Default      | Description                                        |
+| -------------- | ------------------------ | ------------ | -------------------------------------------------- |
+| `categoryMap`  | `Record<string, string>` | See below    | Maps CookiePro category IDs to walkerOS groups     |
+| `explicitOnly` | `boolean`                | `true`       | Only process explicit consent (user made a choice) |
+| `globalName`   | `string`                 | `'OneTrust'` | Custom name for `window.OneTrust` object           |
+
+### Default category mapping
+
+```typescript
+{
+  C0001: 'functional',  // Strictly Necessary
+  C0002: 'analytics',   // Performance
+  C0003: 'functional',  // Functional
+  C0004: 'marketing',   // Targeting
+  C0005: 'marketing',   // Social Media
+}
+```
+
+Category ID comparison is case-insensitive. Unmapped category IDs are ignored
+(not passed through), since CookiePro's opaque IDs are meaningless without a
+mapping. All mapped walkerOS groups receive explicit `true`/`false` values --
+absent groups are set to `false` so destinations know which consent is denied.
+
+### Custom mapping example
+
+```typescript
+import { startFlow } from '@walkeros/collector';
+import { sourceCookiePro } from '@walkeros/web-source-cmp-cookiepro';
+
+await startFlow({
+  sources: {
+    consent: {
+      code: sourceCookiePro,
+      config: {
+        settings: {
+          categoryMap: {
+            C0002: 'statistics', // Use 'statistics' instead of 'analytics'
+          },
+          explicitOnly: true,
+        },
+      },
+    },
+  },
+});
+```
+
+Custom entries are merged with the default mapping. Specify only the categories
+you want to override -- all other defaults remain active.
+
+## How it works
+
+1. **Already loaded**: When the source initializes, it checks if
+   `window.OneTrust` and `window.OptanonActiveGroups` already exist. If so,
+   processes consent immediately.
+
+2. **OptanonWrapper**: If the SDK isn't loaded yet, wraps the global
+   `OptanonWrapper` callback (preserving any existing wrapper). OneTrust calls
+   this function on SDK init. The wrapper self-unwraps after the first call,
+   leaving the event listener to handle subsequent changes.
+
+3. **OneTrustGroupsUpdated event**: Listens for the `OneTrustGroupsUpdated`
+   window event, which fires on every consent change.
+
+4. **Parsing**: Splits the `OptanonActiveGroups` comma-separated string, maps
+   category IDs through `categoryMap`, and calls `elb('walker consent', state)`.
+   Sets explicit `false` for all mapped groups that are not in the active list.
+
+### Timing considerations
+
+The source handles all timing scenarios:
+
+- **SDK loads before source:** The "already loaded" check reads existing consent
+  from `OptanonActiveGroups` immediately. The `OneTrustGroupsUpdated` listener
+  catches future changes.
+- **Source loads before SDK:** The `OptanonWrapper` wrapping intercepts the
+  SDK's init callback. The event listener catches subsequent changes.
+- **`explicitOnly` (default):** Uses `OneTrust.IsAlertBoxClosed()` to determine
+  if the user has actively interacted with the consent banner. Implicit/default
+  consent is ignored.
+
+### OptanonWrapper wrapping
+
+The `OptanonWrapper` function-reassignment pattern is the standard OneTrust
+integration approach. Multiple scripts can wrap it in a chain (each preserving
+the previous). On `destroy()`, the source restores the wrapper it captured at
+init time. If another script wraps `OptanonWrapper` after this source, that
+wrapper will be lost on destroy. This is inherent to the pattern.
+
+## CookiePro API reference
+
+- `window.OptanonActiveGroups`: Comma-separated string of active category IDs
+  (e.g., `",C0001,C0003,"`)
+- `window.OneTrust.IsAlertBoxClosed()`: Returns `true` if user made explicit
+  choice
+- `window.OptanonWrapper()`: Global callback invoked by SDK on load and consent
+  changes
+- `OneTrustGroupsUpdated`: Window event fired on consent changes (event.detail
+  is an array of active group IDs)
+
+## walkerOS.json
+
+```json
+{ "walkerOS": { "type": "source", "platform": "web" } }
+```
+
+## Type definitions
+
+See [src/types/index.ts](./src/types/index.ts) for TypeScript interfaces.
+
+## Related
+
+- [Consent management guide](https://www.walkeros.io/docs/guides/consent)
+- [CookiePro documentation](https://www.walkeros.io/docs/sources/web/cmps/cookiepro)
+
+## License
+
+MIT

package/dist/dev.d.mts

@@ -0,0 +1,148 @@
+import { WalkerOS, Elb, Logger } from '@walkeros/core';
+
+/**
+ * Example CookiePro OptanonActiveGroups strings.
+ *
+ * These represent real consent states from CookiePro/OneTrust CMP.
+ * Format: comma-separated active category IDs with leading/trailing commas.
+ * Only active groups are listed. Absence means denied.
+ */
+/**
+ * Full consent - user accepted all categories
+ */
+declare const fullConsent = ",C0001,C0002,C0003,C0004,C0005,";
+/**
+ * Partial consent - necessary + functional only
+ */
+declare const partialConsent = ",C0001,C0003,";
+/**
+ * Minimal consent - only strictly necessary (always active)
+ */
+declare const minimalConsent = ",C0001,";
+/**
+ * Analytics only - necessary + performance
+ */
+declare const analyticsOnlyConsent = ",C0001,C0002,";
+/**
+ * Marketing only - necessary + targeting
+ */
+declare const marketingOnlyConsent = ",C0001,C0004,";
+/**
+ * Empty string - no consent yet or cleared
+ */
+declare const emptyConsent = "";
+/**
+ * Custom category IDs - some installations use custom IDs
+ */
+declare const customCategoryConsent = ",C0001,CUSTOM01,CUSTOM02,";
+
+/**
+ * Expected walkerOS consent outputs.
+ *
+ * These represent the consent state after parsing OptanonActiveGroups
+ * and mapping through the default categoryMap.
+ *
+ * Default map:
+ * - C0001 -> functional
+ * - C0002 -> analytics
+ * - C0003 -> functional
+ * - C0004 -> marketing
+ * - C0005 -> marketing
+ *
+ * All mapped walkerOS groups get explicit true/false values.
+ * Active groups -> true, absent groups -> false.
+ */
+/**
+ * Full consent mapped to walkerOS groups
+ */
+declare const fullConsentMapped: WalkerOS.Consent;
+/**
+ * Partial consent - necessary + functional mapped
+ * C0001 -> functional (true), C0003 -> functional (true)
+ * analytics and marketing absent -> false
+ */
+declare const partialConsentMapped: WalkerOS.Consent;
+/**
+ * Minimal consent - only strictly necessary
+ * C0001 -> functional (true)
+ * analytics and marketing absent -> false
+ */
+declare const minimalConsentMapped: WalkerOS.Consent;
+/**
+ * Analytics only - necessary + performance
+ * C0001 -> functional (true), C0002 -> analytics (true)
+ * marketing absent -> false
+ */
+declare const analyticsOnlyMapped: WalkerOS.Consent;
+/**
+ * Marketing only - necessary + targeting
+ * C0001 -> functional (true), C0004 -> marketing (true)
+ * analytics absent -> false
+ */
+declare const marketingOnlyMapped: WalkerOS.Consent;
+
+/**
+ * OneTrust global API interface.
+ *
+ * Represents the subset of the OneTrust SDK we interact with.
+ * The full SDK is much larger, but we only need consent-related methods.
+ */
+interface OneTrustAPI {
+    /** Returns true if user has made an explicit consent choice */
+    IsAlertBoxClosed: () => boolean;
+    /** Register a callback for consent changes (callback receives event with detail: string[]) */
+    OnConsentChanged?: (fn: (event: {
+        detail: string[];
+    }) => void) => void;
+}
+declare global {
+    interface Window {
+        /** OneTrust SDK global object */
+        OneTrust?: OneTrustAPI;
+        /** Comma-separated string of active consent category IDs (e.g. ",C0001,C0003,") */
+        OptanonActiveGroups?: string;
+        /** OneTrust callback function, called on SDK load and consent changes */
+        OptanonWrapper?: () => void;
+        /** CookiePro legacy alias for OneTrust */
+        Optanon?: unknown;
+        [key: string]: OneTrustAPI | unknown;
+    }
+    interface WindowEventMap {
+        /** event.detail is an array of active group ID strings (e.g. ["C0001", "C0002"]) */
+        OneTrustGroupsUpdated: CustomEvent<string[]>;
+    }
+}
+
+/**
+ * Create a properly typed elb/push function mock
+ */
+declare const createMockElbFn: () => Elb.Fn;
+/**
+ * Simple no-op logger for demo purposes
+ */
+declare const noopLogger: Logger.Instance;
+/**
+ * Create a mock OneTrust API object
+ */
+declare const createMockOneTrustAPI: (isAlertBoxClosed?: boolean) => OneTrustAPI;
+
+declare const index_analyticsOnlyConsent: typeof analyticsOnlyConsent;
+declare const index_analyticsOnlyMapped: typeof analyticsOnlyMapped;
+declare const index_createMockElbFn: typeof createMockElbFn;
+declare const index_createMockOneTrustAPI: typeof createMockOneTrustAPI;
+declare const index_customCategoryConsent: typeof customCategoryConsent;
+declare const index_emptyConsent: typeof emptyConsent;
+declare const index_fullConsent: typeof fullConsent;
+declare const index_fullConsentMapped: typeof fullConsentMapped;
+declare const index_marketingOnlyConsent: typeof marketingOnlyConsent;
+declare const index_marketingOnlyMapped: typeof marketingOnlyMapped;
+declare const index_minimalConsent: typeof minimalConsent;
+declare const index_minimalConsentMapped: typeof minimalConsentMapped;
+declare const index_noopLogger: typeof noopLogger;
+declare const index_partialConsent: typeof partialConsent;
+declare const index_partialConsentMapped: typeof partialConsentMapped;
+declare namespace index {
+  export { index_analyticsOnlyConsent as analyticsOnlyConsent, index_analyticsOnlyMapped as analyticsOnlyMapped, index_createMockElbFn as createMockElbFn, index_createMockOneTrustAPI as createMockOneTrustAPI, index_customCategoryConsent as customCategoryConsent, index_emptyConsent as emptyConsent, index_fullConsent as fullConsent, index_fullConsentMapped as fullConsentMapped, index_marketingOnlyConsent as marketingOnlyConsent, index_marketingOnlyMapped as marketingOnlyMapped, index_minimalConsent as minimalConsent, index_minimalConsentMapped as minimalConsentMapped, index_noopLogger as noopLogger, index_partialConsent as partialConsent, index_partialConsentMapped as partialConsentMapped };
+}
+
+export { index as examples };

package/dist/dev.d.ts

@@ -0,0 +1,148 @@
+import { WalkerOS, Elb, Logger } from '@walkeros/core';
+
+/**
+ * Example CookiePro OptanonActiveGroups strings.
+ *
+ * These represent real consent states from CookiePro/OneTrust CMP.
+ * Format: comma-separated active category IDs with leading/trailing commas.
+ * Only active groups are listed. Absence means denied.
+ */
+/**
+ * Full consent - user accepted all categories
+ */
+declare const fullConsent = ",C0001,C0002,C0003,C0004,C0005,";
+/**
+ * Partial consent - necessary + functional only
+ */
+declare const partialConsent = ",C0001,C0003,";
+/**
+ * Minimal consent - only strictly necessary (always active)
+ */
+declare const minimalConsent = ",C0001,";
+/**
+ * Analytics only - necessary + performance
+ */
+declare const analyticsOnlyConsent = ",C0001,C0002,";
+/**
+ * Marketing only - necessary + targeting
+ */
+declare const marketingOnlyConsent = ",C0001,C0004,";
+/**
+ * Empty string - no consent yet or cleared
+ */
+declare const emptyConsent = "";
+/**
+ * Custom category IDs - some installations use custom IDs
+ */
+declare const customCategoryConsent = ",C0001,CUSTOM01,CUSTOM02,";
+
+/**
+ * Expected walkerOS consent outputs.
+ *
+ * These represent the consent state after parsing OptanonActiveGroups
+ * and mapping through the default categoryMap.
+ *
+ * Default map:
+ * - C0001 -> functional
+ * - C0002 -> analytics
+ * - C0003 -> functional
+ * - C0004 -> marketing
+ * - C0005 -> marketing
+ *
+ * All mapped walkerOS groups get explicit true/false values.
+ * Active groups -> true, absent groups -> false.
+ */
+/**
+ * Full consent mapped to walkerOS groups
+ */
+declare const fullConsentMapped: WalkerOS.Consent;
+/**
+ * Partial consent - necessary + functional mapped
+ * C0001 -> functional (true), C0003 -> functional (true)
+ * analytics and marketing absent -> false
+ */
+declare const partialConsentMapped: WalkerOS.Consent;
+/**
+ * Minimal consent - only strictly necessary
+ * C0001 -> functional (true)
+ * analytics and marketing absent -> false
+ */
+declare const minimalConsentMapped: WalkerOS.Consent;
+/**
+ * Analytics only - necessary + performance
+ * C0001 -> functional (true), C0002 -> analytics (true)
+ * marketing absent -> false
+ */
+declare const analyticsOnlyMapped: WalkerOS.Consent;
+/**
+ * Marketing only - necessary + targeting
+ * C0001 -> functional (true), C0004 -> marketing (true)
+ * analytics absent -> false
+ */
+declare const marketingOnlyMapped: WalkerOS.Consent;
+
+/**
+ * OneTrust global API interface.
+ *
+ * Represents the subset of the OneTrust SDK we interact with.
+ * The full SDK is much larger, but we only need consent-related methods.
+ */
+interface OneTrustAPI {
+    /** Returns true if user has made an explicit consent choice */
+    IsAlertBoxClosed: () => boolean;
+    /** Register a callback for consent changes (callback receives event with detail: string[]) */
+    OnConsentChanged?: (fn: (event: {
+        detail: string[];
+    }) => void) => void;
+}
+declare global {
+    interface Window {
+        /** OneTrust SDK global object */
+        OneTrust?: OneTrustAPI;
+        /** Comma-separated string of active consent category IDs (e.g. ",C0001,C0003,") */
+        OptanonActiveGroups?: string;
+        /** OneTrust callback function, called on SDK load and consent changes */
+        OptanonWrapper?: () => void;
+        /** CookiePro legacy alias for OneTrust */
+        Optanon?: unknown;
+        [key: string]: OneTrustAPI | unknown;
+    }
+    interface WindowEventMap {
+        /** event.detail is an array of active group ID strings (e.g. ["C0001", "C0002"]) */
+        OneTrustGroupsUpdated: CustomEvent<string[]>;
+    }
+}
+
+/**
+ * Create a properly typed elb/push function mock
+ */
+declare const createMockElbFn: () => Elb.Fn;
+/**
+ * Simple no-op logger for demo purposes
+ */
+declare const noopLogger: Logger.Instance;
+/**
+ * Create a mock OneTrust API object
+ */
+declare const createMockOneTrustAPI: (isAlertBoxClosed?: boolean) => OneTrustAPI;
+
+declare const index_analyticsOnlyConsent: typeof analyticsOnlyConsent;
+declare const index_analyticsOnlyMapped: typeof analyticsOnlyMapped;
+declare const index_createMockElbFn: typeof createMockElbFn;
+declare const index_createMockOneTrustAPI: typeof createMockOneTrustAPI;
+declare const index_customCategoryConsent: typeof customCategoryConsent;
+declare const index_emptyConsent: typeof emptyConsent;
+declare const index_fullConsent: typeof fullConsent;
+declare const index_fullConsentMapped: typeof fullConsentMapped;
+declare const index_marketingOnlyConsent: typeof marketingOnlyConsent;
+declare const index_marketingOnlyMapped: typeof marketingOnlyMapped;
+declare const index_minimalConsent: typeof minimalConsent;
+declare const index_minimalConsentMapped: typeof minimalConsentMapped;
+declare const index_noopLogger: typeof noopLogger;
+declare const index_partialConsent: typeof partialConsent;
+declare const index_partialConsentMapped: typeof partialConsentMapped;
+declare namespace index {
+  export { index_analyticsOnlyConsent as analyticsOnlyConsent, index_analyticsOnlyMapped as analyticsOnlyMapped, index_createMockElbFn as createMockElbFn, index_createMockOneTrustAPI as createMockOneTrustAPI, index_customCategoryConsent as customCategoryConsent, index_emptyConsent as emptyConsent, index_fullConsent as fullConsent, index_fullConsentMapped as fullConsentMapped, index_marketingOnlyConsent as marketingOnlyConsent, index_marketingOnlyMapped as marketingOnlyMapped, index_minimalConsent as minimalConsent, index_minimalConsentMapped as minimalConsentMapped, index_noopLogger as noopLogger, index_partialConsent as partialConsent, index_partialConsentMapped as partialConsentMapped };
+}
+
+export { index as examples };

package/dist/dev.js

@@ -0,0 +1 @@
+"use strict";var e,n=Object.defineProperty,t=Object.getOwnPropertyDescriptor,a=Object.getOwnPropertyNames,o=Object.prototype.hasOwnProperty,r=(e,t)=>{for(var a in t)n(e,a,{get:t[a],enumerable:!0})},l={};r(l,{examples:()=>i}),module.exports=(e=l,((e,r,l,i)=>{if(r&&"object"==typeof r||"function"==typeof r)for(let s of a(r))o.call(e,s)||s===l||n(e,s,{get:()=>r[s],enumerable:!(i=t(r,s))||i.enumerable});return e})(n({},"__esModule",{value:!0}),e));var i={};r(i,{analyticsOnlyConsent:()=>C,analyticsOnlyMapped:()=>b,createMockElbFn:()=>M,createMockOneTrustAPI:()=>w,customCategoryConsent:()=>u,emptyConsent:()=>m,fullConsent:()=>s,fullConsentMapped:()=>f,marketingOnlyConsent:()=>y,marketingOnlyMapped:()=>d,minimalConsent:()=>p,minimalConsentMapped:()=>O,noopLogger:()=>v,partialConsent:()=>c,partialConsentMapped:()=>g});var s=",C0001,C0002,C0003,C0004,C0005,",c=",C0001,C0003,",p=",C0001,",C=",C0001,C0002,",y=",C0001,C0004,",m="",u=",C0001,CUSTOM01,CUSTOM02,",f={functional:!0,analytics:!0,marketing:!0},g={functional:!0,analytics:!1,marketing:!1},O={functional:!0,analytics:!1,marketing:!1},b={functional:!0,analytics:!0,marketing:!1},d={functional:!0,analytics:!1,marketing:!0},k=()=>{},M=()=>()=>Promise.resolve({ok:!0}),v={error:k,info:k,debug:k,throw:e=>{throw"string"==typeof e?new Error(e):e},scope:()=>v},w=(e=!1)=>({IsAlertBoxClosed:()=>e});//# sourceMappingURL=dev.js.map

package/dist/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/dev.ts","../src/examples/index.ts","../src/examples/inputs.ts","../src/examples/outputs.ts","../src/examples/env.ts"],"sourcesContent":["/**\n * Development exports for testing and tooling.\n */\nexport * as examples from './examples';\n","export * from './inputs';\nexport * from './outputs';\nexport * from './env';\n","/**\n * Example CookiePro OptanonActiveGroups strings.\n *\n * These represent real consent states from CookiePro/OneTrust CMP.\n * Format: comma-separated active category IDs with leading/trailing commas.\n * Only active groups are listed. Absence means denied.\n */\n\n/**\n * Full consent - user accepted all categories\n */\nexport const fullConsent = ',C0001,C0002,C0003,C0004,C0005,';\n\n/**\n * Partial consent - necessary + functional only\n */\nexport const partialConsent = ',C0001,C0003,';\n\n/**\n * Minimal consent - only strictly necessary (always active)\n */\nexport const minimalConsent = ',C0001,';\n\n/**\n * Analytics only - necessary + performance\n */\nexport const analyticsOnlyConsent = ',C0001,C0002,';\n\n/**\n * Marketing only - necessary + targeting\n */\nexport const marketingOnlyConsent = ',C0001,C0004,';\n\n/**\n * Empty string - no consent yet or cleared\n */\nexport const emptyConsent = '';\n\n/**\n * Custom category IDs - some installations use custom IDs\n */\nexport const customCategoryConsent = ',C0001,CUSTOM01,CUSTOM02,';\n","import type { WalkerOS } from '@walkeros/core';\n\n/**\n * Expected walkerOS consent outputs.\n *\n * These represent the consent state after parsing OptanonActiveGroups\n * and mapping through the default categoryMap.\n *\n * Default map:\n * - C0001 -> functional\n * - C0002 -> analytics\n * - C0003 -> functional\n * - C0004 -> marketing\n * - C0005 -> marketing\n *\n * All mapped walkerOS groups get explicit true/false values.\n * Active groups -> true, absent groups -> false.\n */\n\n/**\n * Full consent mapped to walkerOS groups\n */\nexport const fullConsentMapped: WalkerOS.Consent = {\n  functional: true,\n  analytics: true,\n  marketing: true,\n};\n\n/**\n * Partial consent - necessary + functional mapped\n * C0001 -> functional (true), C0003 -> functional (true)\n * analytics and marketing absent -> false\n */\nexport const partialConsentMapped: WalkerOS.Consent = {\n  functional: true,\n  analytics: false,\n  marketing: false,\n};\n\n/**\n * Minimal consent - only strictly necessary\n * C0001 -> functional (true)\n * analytics and marketing absent -> false\n */\nexport const minimalConsentMapped: WalkerOS.Consent = {\n  functional: true,\n  analytics: false,\n  marketing: false,\n};\n\n/**\n * Analytics only - necessary + performance\n * C0001 -> functional (true), C0002 -> analytics (true)\n * marketing absent -> false\n */\nexport const analyticsOnlyMapped: WalkerOS.Consent = {\n  functional: true,\n  analytics: true,\n  marketing: false,\n};\n\n/**\n * Marketing only - necessary + targeting\n * C0001 -> functional (true), C0004 -> marketing (true)\n * analytics absent -> false\n */\nexport const marketingOnlyMapped: WalkerOS.Consent = {\n  functional: true,\n  analytics: false,\n  marketing: true,\n};\n","import type { Source, Elb, Logger } from '@walkeros/core';\nimport type { OneTrustAPI } from '../types';\n\n/**\n * Example environment configurations for CookiePro source testing.\n */\n\nconst noop = () => {};\n\n/**\n * Create a properly typed elb/push function mock\n */\nexport const createMockElbFn = (): Elb.Fn => {\n  const fn = (() =>\n    Promise.resolve({\n      ok: true,\n    })) as Elb.Fn;\n  return fn;\n};\n\n/**\n * Simple no-op logger for demo purposes\n */\nexport const noopLogger: Logger.Instance = {\n  error: noop,\n  info: noop,\n  debug: noop,\n  throw: (message: string | Error) => {\n    throw typeof message === 'string' ? new Error(message) : message;\n  },\n  scope: () => noopLogger,\n};\n\n/**\n * Create a mock OneTrust API object\n */\nexport const createMockOneTrustAPI = (\n  isAlertBoxClosed = false,\n): OneTrustAPI => ({\n  IsAlertBoxClosed: () => isAlertBoxClosed,\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACWO,IAAM,cAAc;AAKpB,IAAM,iBAAiB;AAKvB,IAAM,iBAAiB;AAKvB,IAAM,uBAAuB;AAK7B,IAAM,uBAAuB;AAK7B,IAAM,eAAe;AAKrB,IAAM,wBAAwB;;;ACnB9B,IAAM,oBAAsC;AAAA,EACjD,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,WAAW;AACb;AAOO,IAAM,uBAAyC;AAAA,EACpD,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,WAAW;AACb;AAOO,IAAM,uBAAyC;AAAA,EACpD,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,WAAW;AACb;AAOO,IAAM,sBAAwC;AAAA,EACnD,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,WAAW;AACb;AAOO,IAAM,sBAAwC;AAAA,EACnD,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,WAAW;AACb;;;AC/DA,IAAM,OAAO,MAAM;AAAC;AAKb,IAAM,kBAAkB,MAAc;AAC3C,QAAM,MAAM,MACV,QAAQ,QAAQ;AAAA,IACd,IAAI;AAAA,EACN,CAAC;AACH,SAAO;AACT;AAKO,IAAM,aAA8B;AAAA,EACzC,OAAO;AAAA,EACP,MAAM;AAAA,EACN,OAAO;AAAA,EACP,OAAO,CAAC,YAA4B;AAClC,UAAM,OAAO,YAAY,WAAW,IAAI,MAAM,OAAO,IAAI;AAAA,EAC3D;AAAA,EACA,OAAO,MAAM;AACf;AAKO,IAAM,wBAAwB,CACnC,mBAAmB,WACF;AAAA,EACjB,kBAAkB,MAAM;AAC1B;","names":[]}

package/dist/dev.mjs

@@ -0,0 +1 @@
+var n=Object.defineProperty,e={};((e,a)=>{for(var t in a)n(e,t,{get:a[t],enumerable:!0})})(e,{analyticsOnlyConsent:()=>r,analyticsOnlyMapped:()=>m,createMockElbFn:()=>f,createMockOneTrustAPI:()=>k,customCategoryConsent:()=>s,emptyConsent:()=>l,fullConsent:()=>a,fullConsentMapped:()=>C,marketingOnlyConsent:()=>i,marketingOnlyMapped:()=>y,minimalConsent:()=>o,minimalConsentMapped:()=>p,noopLogger:()=>u,partialConsent:()=>t,partialConsentMapped:()=>c});var a=",C0001,C0002,C0003,C0004,C0005,",t=",C0001,C0003,",o=",C0001,",r=",C0001,C0002,",i=",C0001,C0004,",l="",s=",C0001,CUSTOM01,CUSTOM02,",C={functional:!0,analytics:!0,marketing:!0},c={functional:!0,analytics:!1,marketing:!1},p={functional:!0,analytics:!1,marketing:!1},m={functional:!0,analytics:!0,marketing:!1},y={functional:!0,analytics:!1,marketing:!0},g=()=>{},f=()=>()=>Promise.resolve({ok:!0}),u={error:g,info:g,debug:g,throw:n=>{throw"string"==typeof n?new Error(n):n},scope:()=>u},k=(n=!1)=>({IsAlertBoxClosed:()=>n});export{e as examples};//# sourceMappingURL=dev.mjs.map

package/dist/dev.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/examples/index.ts","../src/examples/inputs.ts","../src/examples/outputs.ts","../src/examples/env.ts"],"sourcesContent":["export * from './inputs';\nexport * from './outputs';\nexport * from './env';\n","/**\n * Example CookiePro OptanonActiveGroups strings.\n *\n * These represent real consent states from CookiePro/OneTrust CMP.\n * Format: comma-separated active category IDs with leading/trailing commas.\n * Only active groups are listed. Absence means denied.\n */\n\n/**\n * Full consent - user accepted all categories\n */\nexport const fullConsent = ',C0001,C0002,C0003,C0004,C0005,';\n\n/**\n * Partial consent - necessary + functional only\n */\nexport const partialConsent = ',C0001,C0003,';\n\n/**\n * Minimal consent - only strictly necessary (always active)\n */\nexport const minimalConsent = ',C0001,';\n\n/**\n * Analytics only - necessary + performance\n */\nexport const analyticsOnlyConsent = ',C0001,C0002,';\n\n/**\n * Marketing only - necessary + targeting\n */\nexport const marketingOnlyConsent = ',C0001,C0004,';\n\n/**\n * Empty string - no consent yet or cleared\n */\nexport const emptyConsent = '';\n\n/**\n * Custom category IDs - some installations use custom IDs\n */\nexport const customCategoryConsent = ',C0001,CUSTOM01,CUSTOM02,';\n","import type { WalkerOS } from '@walkeros/core';\n\n/**\n * Expected walkerOS consent outputs.\n *\n * These represent the consent state after parsing OptanonActiveGroups\n * and mapping through the default categoryMap.\n *\n * Default map:\n * - C0001 -> functional\n * - C0002 -> analytics\n * - C0003 -> functional\n * - C0004 -> marketing\n * - C0005 -> marketing\n *\n * All mapped walkerOS groups get explicit true/false values.\n * Active groups -> true, absent groups -> false.\n */\n\n/**\n * Full consent mapped to walkerOS groups\n */\nexport const fullConsentMapped: WalkerOS.Consent = {\n  functional: true,\n  analytics: true,\n  marketing: true,\n};\n\n/**\n * Partial consent - necessary + functional mapped\n * C0001 -> functional (true), C0003 -> functional (true)\n * analytics and marketing absent -> false\n */\nexport const partialConsentMapped: WalkerOS.Consent = {\n  functional: true,\n  analytics: false,\n  marketing: false,\n};\n\n/**\n * Minimal consent - only strictly necessary\n * C0001 -> functional (true)\n * analytics and marketing absent -> false\n */\nexport const minimalConsentMapped: WalkerOS.Consent = {\n  functional: true,\n  analytics: false,\n  marketing: false,\n};\n\n/**\n * Analytics only - necessary + performance\n * C0001 -> functional (true), C0002 -> analytics (true)\n * marketing absent -> false\n */\nexport const analyticsOnlyMapped: WalkerOS.Consent = {\n  functional: true,\n  analytics: true,\n  marketing: false,\n};\n\n/**\n * Marketing only - necessary + targeting\n * C0001 -> functional (true), C0004 -> marketing (true)\n * analytics absent -> false\n */\nexport const marketingOnlyMapped: WalkerOS.Consent = {\n  functional: true,\n  analytics: false,\n  marketing: true,\n};\n","import type { Source, Elb, Logger } from '@walkeros/core';\nimport type { OneTrustAPI } from '../types';\n\n/**\n * Example environment configurations for CookiePro source testing.\n */\n\nconst noop = () => {};\n\n/**\n * Create a properly typed elb/push function mock\n */\nexport const createMockElbFn = (): Elb.Fn => {\n  const fn = (() =>\n    Promise.resolve({\n      ok: true,\n    })) as Elb.Fn;\n  return fn;\n};\n\n/**\n * Simple no-op logger for demo purposes\n */\nexport const noopLogger: Logger.Instance = {\n  error: noop,\n  info: noop,\n  debug: noop,\n  throw: (message: string | Error) => {\n    throw typeof message === 'string' ? new Error(message) : message;\n  },\n  scope: () => noopLogger,\n};\n\n/**\n * Create a mock OneTrust API object\n */\nexport const createMockOneTrustAPI = (\n  isAlertBoxClosed = false,\n): OneTrustAPI => ({\n  IsAlertBoxClosed: () => isAlertBoxClosed,\n});\n"],"mappings":";;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACWO,IAAM,cAAc;AAKpB,IAAM,iBAAiB;AAKvB,IAAM,iBAAiB;AAKvB,IAAM,uBAAuB;AAK7B,IAAM,uBAAuB;AAK7B,IAAM,eAAe;AAKrB,IAAM,wBAAwB;;;ACnB9B,IAAM,oBAAsC;AAAA,EACjD,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,WAAW;AACb;AAOO,IAAM,uBAAyC;AAAA,EACpD,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,WAAW;AACb;AAOO,IAAM,uBAAyC;AAAA,EACpD,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,WAAW;AACb;AAOO,IAAM,sBAAwC;AAAA,EACnD,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,WAAW;AACb;AAOO,IAAM,sBAAwC;AAAA,EACnD,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,WAAW;AACb;;;AC/DA,IAAM,OAAO,MAAM;AAAC;AAKb,IAAM,kBAAkB,MAAc;AAC3C,QAAM,MAAM,MACV,QAAQ,QAAQ;AAAA,IACd,IAAI;AAAA,EACN,CAAC;AACH,SAAO;AACT;AAKO,IAAM,aAA8B;AAAA,EACzC,OAAO;AAAA,EACP,MAAM;AAAA,EACN,OAAO;AAAA,EACP,OAAO,CAAC,YAA4B;AAClC,UAAM,OAAO,YAAY,WAAW,IAAI,MAAM,OAAO,IAAI;AAAA,EAC3D;AAAA,EACA,OAAO,MAAM;AACf;AAKO,IAAM,wBAAwB,CACnC,mBAAmB,WACF;AAAA,EACjB,kBAAkB,MAAM;AAC1B;","names":[]}

package/dist/examples/index.d.mts

@@ -0,0 +1,129 @@
+import { WalkerOS, Elb, Logger } from '@walkeros/core';
+
+/**
+ * Example CookiePro OptanonActiveGroups strings.
+ *
+ * These represent real consent states from CookiePro/OneTrust CMP.
+ * Format: comma-separated active category IDs with leading/trailing commas.
+ * Only active groups are listed. Absence means denied.
+ */
+/**
+ * Full consent - user accepted all categories
+ */
+declare const fullConsent = ",C0001,C0002,C0003,C0004,C0005,";
+/**
+ * Partial consent - necessary + functional only
+ */
+declare const partialConsent = ",C0001,C0003,";
+/**
+ * Minimal consent - only strictly necessary (always active)
+ */
+declare const minimalConsent = ",C0001,";
+/**
+ * Analytics only - necessary + performance
+ */
+declare const analyticsOnlyConsent = ",C0001,C0002,";
+/**
+ * Marketing only - necessary + targeting
+ */
+declare const marketingOnlyConsent = ",C0001,C0004,";
+/**
+ * Empty string - no consent yet or cleared
+ */
+declare const emptyConsent = "";
+/**
+ * Custom category IDs - some installations use custom IDs
+ */
+declare const customCategoryConsent = ",C0001,CUSTOM01,CUSTOM02,";
+
+/**
+ * Expected walkerOS consent outputs.
+ *
+ * These represent the consent state after parsing OptanonActiveGroups
+ * and mapping through the default categoryMap.
+ *
+ * Default map:
+ * - C0001 -> functional
+ * - C0002 -> analytics
+ * - C0003 -> functional
+ * - C0004 -> marketing
+ * - C0005 -> marketing
+ *
+ * All mapped walkerOS groups get explicit true/false values.
+ * Active groups -> true, absent groups -> false.
+ */
+/**
+ * Full consent mapped to walkerOS groups
+ */
+declare const fullConsentMapped: WalkerOS.Consent;
+/**
+ * Partial consent - necessary + functional mapped
+ * C0001 -> functional (true), C0003 -> functional (true)
+ * analytics and marketing absent -> false
+ */
+declare const partialConsentMapped: WalkerOS.Consent;
+/**
+ * Minimal consent - only strictly necessary
+ * C0001 -> functional (true)
+ * analytics and marketing absent -> false
+ */
+declare const minimalConsentMapped: WalkerOS.Consent;
+/**
+ * Analytics only - necessary + performance
+ * C0001 -> functional (true), C0002 -> analytics (true)
+ * marketing absent -> false
+ */
+declare const analyticsOnlyMapped: WalkerOS.Consent;
+/**
+ * Marketing only - necessary + targeting
+ * C0001 -> functional (true), C0004 -> marketing (true)
+ * analytics absent -> false
+ */
+declare const marketingOnlyMapped: WalkerOS.Consent;
+
+/**
+ * OneTrust global API interface.
+ *
+ * Represents the subset of the OneTrust SDK we interact with.
+ * The full SDK is much larger, but we only need consent-related methods.
+ */
+interface OneTrustAPI {
+    /** Returns true if user has made an explicit consent choice */
+    IsAlertBoxClosed: () => boolean;
+    /** Register a callback for consent changes (callback receives event with detail: string[]) */
+    OnConsentChanged?: (fn: (event: {
+        detail: string[];
+    }) => void) => void;
+}
+declare global {
+    interface Window {
+        /** OneTrust SDK global object */
+        OneTrust?: OneTrustAPI;
+        /** Comma-separated string of active consent category IDs (e.g. ",C0001,C0003,") */
+        OptanonActiveGroups?: string;
+        /** OneTrust callback function, called on SDK load and consent changes */
+        OptanonWrapper?: () => void;
+        /** CookiePro legacy alias for OneTrust */
+        Optanon?: unknown;
+        [key: string]: OneTrustAPI | unknown;
+    }
+    interface WindowEventMap {
+        /** event.detail is an array of active group ID strings (e.g. ["C0001", "C0002"]) */
+        OneTrustGroupsUpdated: CustomEvent<string[]>;
+    }
+}
+
+/**
+ * Create a properly typed elb/push function mock
+ */
+declare const createMockElbFn: () => Elb.Fn;
+/**
+ * Simple no-op logger for demo purposes
+ */
+declare const noopLogger: Logger.Instance;
+/**
+ * Create a mock OneTrust API object
+ */
+declare const createMockOneTrustAPI: (isAlertBoxClosed?: boolean) => OneTrustAPI;
+
+export { analyticsOnlyConsent, analyticsOnlyMapped, createMockElbFn, createMockOneTrustAPI, customCategoryConsent, emptyConsent, fullConsent, fullConsentMapped, marketingOnlyConsent, marketingOnlyMapped, minimalConsent, minimalConsentMapped, noopLogger, partialConsent, partialConsentMapped };