@walkeros/web-source-cmp-cookiefirst 1.1.0-next-1771252576264

package/README.md

@@ -0,0 +1,107 @@
+# @walkeros/web-source-cmp-cookiefirst
+
+CookieFirst consent management source for walkerOS.
+
+This source listens to [CookieFirst](https://cookiefirst.com/) CMP events and
+translates consent states to walkerOS consent commands.
+
+## Installation
+
+```bash
+npm install @walkeros/web-source-cmp-cookiefirst
+```
+
+## Usage
+
+```typescript
+import { startFlow } from '@walkeros/collector';
+import { sourceCookieFirst } from '@walkeros/web-source-cmp-cookiefirst';
+
+await startFlow({
+  sources: {
+    consent: {
+      code: sourceCookieFirst,
+    },
+  },
+  destinations: {
+    gtag: {
+      code: destinationGtag,
+      config: {
+        consent: { analytics: true }, // Requires analytics consent
+      },
+    },
+  },
+});
+```
+
+## Configuration
+
+### Settings
+
+| Setting        | Type                     | Default         | Description                                            |
+| -------------- | ------------------------ | --------------- | ------------------------------------------------------ |
+| `categoryMap`  | `Record<string, string>` | See below       | Maps CookieFirst categories to walkerOS consent groups |
+| `explicitOnly` | `boolean`                | `true`          | Only process explicit consent (user made a choice)     |
+| `globalName`   | `string`                 | `'CookieFirst'` | Custom name for `window.CookieFirst` object            |
+
+### Default Category Mapping
+
+```typescript
+{
+  necessary: 'functional',
+  functional: 'functional',
+  performance: 'analytics',
+  advertising: 'marketing',
+}
+```
+
+When multiple CookieFirst categories map to the same walkerOS group (e.g., both
+`necessary` and `functional` → `functional`), the source uses OR logic: if ANY
+source category is `true`, the target group is `true`.
+
+### Custom Mapping Example
+
+```typescript
+await startFlow({
+  sources: {
+    consent: {
+      code: sourceCookieFirst,
+      config: {
+        settings: {
+          categoryMap: {
+            performance: 'statistics', // Use 'statistics' instead of 'analytics'
+          },
+          explicitOnly: true,
+        },
+      },
+    },
+  },
+});
+```
+
+## How It Works
+
+1. **Initialization**: When the source loads, it checks if CookieFirst is
+   already initialized and processes any existing consent state.
+
+2. **cf_init Event**: Listens for the `cf_init` event fired when CookieFirst
+   banner initializes.
+
+3. **cf_consent Event**: Listens for the `cf_consent` event fired when user
+   changes their consent preferences.
+
+4. **Consent Mapping**: Translates CookieFirst categories to walkerOS consent
+   groups and calls `elb('walker consent', state)`.
+
+## CookieFirst API Reference
+
+- [CookieFirst Public API Documentation](https://support.cookiefirst.com/hc/en-us/articles/360011568738-Cookie-Banner-Public-API-documentation)
+
+## Related
+
+- [Consent management guide](https://www.walkeros.io/docs/guides/consent)
+- [CookieFirst documentation](https://www.walkeros.io/docs/sources/web/cmps/cookiefirst)
+
+## License
+
+MIT

package/dist/dev.d.mts

@@ -0,0 +1,149 @@
+import { WalkerOS, Elb, Logger, Source } from '@walkeros/core';
+
+/**
+ * CookieFirst consent object structure
+ */
+interface CookieFirstConsent {
+    necessary?: boolean;
+    functional?: boolean;
+    performance?: boolean;
+    advertising?: boolean;
+    [category: string]: boolean | undefined;
+}
+/**
+ * CookieFirst global API interface
+ */
+interface CookieFirstAPI {
+    consent: CookieFirstConsent | null;
+}
+declare global {
+    interface Window {
+        CookieFirst?: CookieFirstAPI;
+        [key: string]: CookieFirstAPI | unknown;
+    }
+    interface WindowEventMap {
+        cf_init: Event;
+        cf_consent: CustomEvent<CookieFirstConsent>;
+    }
+}
+
+/**
+ * Example CookieFirst consent inputs.
+ *
+ * These represent real consent states from CookieFirst CMP.
+ */
+/**
+ * Full consent - user accepted all categories
+ */
+declare const fullConsent: CookieFirstConsent;
+/**
+ * Partial consent - user accepted only necessary and functional
+ */
+declare const partialConsent: CookieFirstConsent;
+/**
+ * Minimal consent - user accepted only necessary (required)
+ */
+declare const minimalConsent: CookieFirstConsent;
+/**
+ * No consent - user hasn't made a choice yet
+ * CookieFirst returns null when no explicit choice has been made
+ */
+declare const noConsent: CookieFirstConsent | null;
+/**
+ * Analytics only - user accepted performance tracking
+ */
+declare const analyticsOnlyConsent: CookieFirstConsent;
+/**
+ * Marketing only - user accepted advertising
+ */
+declare const marketingOnlyConsent: CookieFirstConsent;
+
+/**
+ * Expected walkerOS consent outputs.
+ *
+ * These represent the consent state after mapping CookieFirst categories
+ * to walkerOS consent groups using the default category map.
+ */
+/**
+ * Full consent mapped to walkerOS groups
+ * (necessary + functional → functional, performance → analytics, advertising → marketing)
+ */
+declare const fullConsentMapped: WalkerOS.Consent;
+/**
+ * Partial consent mapped to walkerOS groups
+ */
+declare const partialConsentMapped: WalkerOS.Consent;
+/**
+ * Minimal consent mapped to walkerOS groups
+ */
+declare const minimalConsentMapped: WalkerOS.Consent;
+/**
+ * Analytics only consent mapped to walkerOS groups
+ * Note: functional is true because necessary=true maps to functional
+ * (OR logic: if ANY source category is true, target group is true)
+ */
+declare const analyticsOnlyMapped: WalkerOS.Consent;
+/**
+ * Marketing only consent mapped to walkerOS groups
+ * Note: functional is true because necessary=true maps to functional
+ * (OR logic: if ANY source category is true, target group is true)
+ */
+declare const marketingOnlyMapped: WalkerOS.Consent;
+
+/**
+ * Create a properly typed elb/push function mock that returns a promise with PushResult
+ */
+declare const createMockElbFn: () => Elb.Fn;
+/**
+ * Simple no-op logger for demo purposes
+ */
+declare const noopLogger: Logger.Instance;
+/**
+ * Environment interface for CookieFirst source
+ */
+interface CookieFirstEnv extends Source.BaseEnv {
+    window?: typeof window;
+}
+/**
+ * Create a mock CookieFirst API object
+ */
+declare const createMockCookieFirstAPI: (consent?: CookieFirstConsent | null) => CookieFirstAPI;
+/**
+ * Create a mock window object with CookieFirst
+ */
+declare const createMockWindow: (consent?: CookieFirstConsent | null) => Partial<Window> & {
+    CookieFirst: CookieFirstAPI;
+};
+/**
+ * Standard mock environment for testing CookieFirst source
+ *
+ * Use this for testing consent handling without requiring
+ * a real browser environment.
+ */
+declare const mockEnv: CookieFirstEnv;
+
+/**
+ * CookieFirst source examples for testing and documentation.
+ */
+
+declare const index_analyticsOnlyConsent: typeof analyticsOnlyConsent;
+declare const index_analyticsOnlyMapped: typeof analyticsOnlyMapped;
+declare const index_createMockCookieFirstAPI: typeof createMockCookieFirstAPI;
+declare const index_createMockElbFn: typeof createMockElbFn;
+declare const index_createMockWindow: typeof createMockWindow;
+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_mockEnv: typeof mockEnv;
+declare const index_noConsent: typeof noConsent;
+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_createMockCookieFirstAPI as createMockCookieFirstAPI, index_createMockElbFn as createMockElbFn, index_createMockWindow as createMockWindow, 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_mockEnv as mockEnv, index_noConsent as noConsent, index_noopLogger as noopLogger, index_partialConsent as partialConsent, index_partialConsentMapped as partialConsentMapped };
+}
+
+export { index as examples };

package/dist/dev.d.ts

@@ -0,0 +1,149 @@
+import { WalkerOS, Elb, Logger, Source } from '@walkeros/core';
+
+/**
+ * CookieFirst consent object structure
+ */
+interface CookieFirstConsent {
+    necessary?: boolean;
+    functional?: boolean;
+    performance?: boolean;
+    advertising?: boolean;
+    [category: string]: boolean | undefined;
+}
+/**
+ * CookieFirst global API interface
+ */
+interface CookieFirstAPI {
+    consent: CookieFirstConsent | null;
+}
+declare global {
+    interface Window {
+        CookieFirst?: CookieFirstAPI;
+        [key: string]: CookieFirstAPI | unknown;
+    }
+    interface WindowEventMap {
+        cf_init: Event;
+        cf_consent: CustomEvent<CookieFirstConsent>;
+    }
+}
+
+/**
+ * Example CookieFirst consent inputs.
+ *
+ * These represent real consent states from CookieFirst CMP.
+ */
+/**
+ * Full consent - user accepted all categories
+ */
+declare const fullConsent: CookieFirstConsent;
+/**
+ * Partial consent - user accepted only necessary and functional
+ */
+declare const partialConsent: CookieFirstConsent;
+/**
+ * Minimal consent - user accepted only necessary (required)
+ */
+declare const minimalConsent: CookieFirstConsent;
+/**
+ * No consent - user hasn't made a choice yet
+ * CookieFirst returns null when no explicit choice has been made
+ */
+declare const noConsent: CookieFirstConsent | null;
+/**
+ * Analytics only - user accepted performance tracking
+ */
+declare const analyticsOnlyConsent: CookieFirstConsent;
+/**
+ * Marketing only - user accepted advertising
+ */
+declare const marketingOnlyConsent: CookieFirstConsent;
+
+/**
+ * Expected walkerOS consent outputs.
+ *
+ * These represent the consent state after mapping CookieFirst categories
+ * to walkerOS consent groups using the default category map.
+ */
+/**
+ * Full consent mapped to walkerOS groups
+ * (necessary + functional → functional, performance → analytics, advertising → marketing)
+ */
+declare const fullConsentMapped: WalkerOS.Consent;
+/**
+ * Partial consent mapped to walkerOS groups
+ */
+declare const partialConsentMapped: WalkerOS.Consent;
+/**
+ * Minimal consent mapped to walkerOS groups
+ */
+declare const minimalConsentMapped: WalkerOS.Consent;
+/**
+ * Analytics only consent mapped to walkerOS groups
+ * Note: functional is true because necessary=true maps to functional
+ * (OR logic: if ANY source category is true, target group is true)
+ */
+declare const analyticsOnlyMapped: WalkerOS.Consent;
+/**
+ * Marketing only consent mapped to walkerOS groups
+ * Note: functional is true because necessary=true maps to functional
+ * (OR logic: if ANY source category is true, target group is true)
+ */
+declare const marketingOnlyMapped: WalkerOS.Consent;
+
+/**
+ * Create a properly typed elb/push function mock that returns a promise with PushResult
+ */
+declare const createMockElbFn: () => Elb.Fn;
+/**
+ * Simple no-op logger for demo purposes
+ */
+declare const noopLogger: Logger.Instance;
+/**
+ * Environment interface for CookieFirst source
+ */
+interface CookieFirstEnv extends Source.BaseEnv {
+    window?: typeof window;
+}
+/**
+ * Create a mock CookieFirst API object
+ */
+declare const createMockCookieFirstAPI: (consent?: CookieFirstConsent | null) => CookieFirstAPI;
+/**
+ * Create a mock window object with CookieFirst
+ */
+declare const createMockWindow: (consent?: CookieFirstConsent | null) => Partial<Window> & {
+    CookieFirst: CookieFirstAPI;
+};
+/**
+ * Standard mock environment for testing CookieFirst source
+ *
+ * Use this for testing consent handling without requiring
+ * a real browser environment.
+ */
+declare const mockEnv: CookieFirstEnv;
+
+/**
+ * CookieFirst source examples for testing and documentation.
+ */
+
+declare const index_analyticsOnlyConsent: typeof analyticsOnlyConsent;
+declare const index_analyticsOnlyMapped: typeof analyticsOnlyMapped;
+declare const index_createMockCookieFirstAPI: typeof createMockCookieFirstAPI;
+declare const index_createMockElbFn: typeof createMockElbFn;
+declare const index_createMockWindow: typeof createMockWindow;
+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_mockEnv: typeof mockEnv;
+declare const index_noConsent: typeof noConsent;
+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_createMockCookieFirstAPI as createMockCookieFirstAPI, index_createMockElbFn as createMockElbFn, index_createMockWindow as createMockWindow, 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_mockEnv as mockEnv, index_noConsent as noConsent, 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,r=Object.getOwnPropertyNames,a=Object.prototype.hasOwnProperty,o=(e,t)=>{for(var r in t)n(e,r,{get:t[r],enumerable:!0})},i={};o(i,{examples:()=>l}),module.exports=(e=i,((e,o,i,l)=>{if(o&&"object"==typeof o||"function"==typeof o)for(let s of r(o))a.call(e,s)||s===i||n(e,s,{get:()=>o[s],enumerable:!(l=t(o,s))||l.enumerable});return e})(n({},"__esModule",{value:!0}),e));var l={};o(l,{analyticsOnlyConsent:()=>f,analyticsOnlyMapped:()=>v,createMockCookieFirstAPI:()=>w,createMockElbFn:()=>C,createMockWindow:()=>M,fullConsent:()=>s,fullConsentMapped:()=>g,marketingOnlyConsent:()=>m,marketingOnlyMapped:()=>k,minimalConsent:()=>p,minimalConsentMapped:()=>d,mockEnv:()=>P,noConsent:()=>u,noopLogger:()=>O,partialConsent:()=>c,partialConsentMapped:()=>y});var s={necessary:!0,functional:!0,performance:!0,advertising:!0},c={necessary:!0,functional:!0,performance:!1,advertising:!1},p={necessary:!0,functional:!1,performance:!1,advertising:!1},u=null,f={necessary:!0,functional:!1,performance:!0,advertising:!1},m={necessary:!0,functional:!1,performance:!1,advertising:!0},g={functional:!0,analytics:!0,marketing:!0},y={functional:!0,analytics:!1,marketing:!1},d={functional:!0,analytics:!1,marketing:!1},v={functional:!0,analytics:!0,marketing:!1},k={functional:!0,analytics:!1,marketing:!0},b=()=>{},C=()=>()=>Promise.resolve({ok:!0}),O={error:b,info:b,debug:b,throw:e=>{throw"string"==typeof e?new Error(e):e},scope:()=>O},w=(e=null)=>({consent:e}),M=(e=null)=>({CookieFirst:w(e),addEventListener:b,removeEventListener:b}),P={get push(){return C()},get command(){return C()},get elb(){return C()},get window(){return M()},logger:O};//# 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","/**\n * CookieFirst source examples for testing and documentation.\n */\n\nexport * from './inputs';\nexport * from './outputs';\nexport * from './env';\n","import type { CookieFirstConsent } from '../types';\n\n/**\n * Example CookieFirst consent inputs.\n *\n * These represent real consent states from CookieFirst CMP.\n */\n\n/**\n * Full consent - user accepted all categories\n */\nexport const fullConsent: CookieFirstConsent = {\n  necessary: true,\n  functional: true,\n  performance: true,\n  advertising: true,\n};\n\n/**\n * Partial consent - user accepted only necessary and functional\n */\nexport const partialConsent: CookieFirstConsent = {\n  necessary: true,\n  functional: true,\n  performance: false,\n  advertising: false,\n};\n\n/**\n * Minimal consent - user accepted only necessary (required)\n */\nexport const minimalConsent: CookieFirstConsent = {\n  necessary: true,\n  functional: false,\n  performance: false,\n  advertising: false,\n};\n\n/**\n * No consent - user hasn't made a choice yet\n * CookieFirst returns null when no explicit choice has been made\n */\nexport const noConsent: CookieFirstConsent | null = null;\n\n/**\n * Analytics only - user accepted performance tracking\n */\nexport const analyticsOnlyConsent: CookieFirstConsent = {\n  necessary: true,\n  functional: false,\n  performance: true,\n  advertising: false,\n};\n\n/**\n * Marketing only - user accepted advertising\n */\nexport const marketingOnlyConsent: CookieFirstConsent = {\n  necessary: true,\n  functional: false,\n  performance: false,\n  advertising: true,\n};\n","import type { WalkerOS } from '@walkeros/core';\n\n/**\n * Expected walkerOS consent outputs.\n *\n * These represent the consent state after mapping CookieFirst categories\n * to walkerOS consent groups using the default category map.\n */\n\n/**\n * Full consent mapped to walkerOS groups\n * (necessary + functional → functional, performance → analytics, advertising → marketing)\n */\nexport const fullConsentMapped: WalkerOS.Consent = {\n  functional: true,\n  analytics: true,\n  marketing: true,\n};\n\n/**\n * Partial consent mapped to walkerOS groups\n */\nexport const partialConsentMapped: WalkerOS.Consent = {\n  functional: true,\n  analytics: false,\n  marketing: false,\n};\n\n/**\n * Minimal consent mapped to walkerOS groups\n */\nexport const minimalConsentMapped: WalkerOS.Consent = {\n  functional: true,\n  analytics: false,\n  marketing: false,\n};\n\n/**\n * Analytics only consent mapped to walkerOS groups\n * Note: functional is true because necessary=true maps to functional\n * (OR logic: if ANY source category is true, target group is true)\n */\nexport const analyticsOnlyMapped: WalkerOS.Consent = {\n  functional: true,\n  analytics: true,\n  marketing: false,\n};\n\n/**\n * Marketing only consent mapped to walkerOS groups\n * Note: functional is true because necessary=true maps to functional\n * (OR logic: if ANY source category is true, target group is true)\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 { CookieFirstAPI, CookieFirstConsent } from '../types';\n\n/**\n * Example environment configurations for CookieFirst source testing.\n *\n * These provide mock structures for testing consent handling\n * without requiring a real browser environment.\n */\n\n// Simple no-op function for mocking\nconst noop = () => {};\n\n/**\n * Create a properly typed elb/push function mock that returns a promise with PushResult\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 * Environment interface for CookieFirst source\n */\ninterface CookieFirstEnv extends Source.BaseEnv {\n  window?: typeof window;\n}\n\n/**\n * Create a mock CookieFirst API object\n */\nexport const createMockCookieFirstAPI = (\n  consent: CookieFirstConsent | null = null,\n): CookieFirstAPI => ({\n  consent,\n});\n\n/**\n * Create a mock window object with CookieFirst\n */\nexport const createMockWindow = (\n  consent: CookieFirstConsent | null = null,\n): Partial<Window> & { CookieFirst: CookieFirstAPI } => ({\n  CookieFirst: createMockCookieFirstAPI(consent),\n  addEventListener: noop,\n  removeEventListener: noop,\n});\n\n/**\n * Standard mock environment for testing CookieFirst source\n *\n * Use this for testing consent handling without requiring\n * a real browser environment.\n */\nexport const mockEnv: CookieFirstEnv = {\n  get push() {\n    return createMockElbFn();\n  },\n  get command() {\n    return createMockElbFn();\n  },\n  get elb() {\n    return createMockElbFn();\n  },\n  get window() {\n    return createMockWindow() as unknown as typeof window;\n  },\n  logger: noopLogger,\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;AAAA;;;ACWO,IAAM,cAAkC;AAAA,EAC7C,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,aAAa;AACf;AAKO,IAAM,iBAAqC;AAAA,EAChD,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,aAAa;AACf;AAKO,IAAM,iBAAqC;AAAA,EAChD,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,aAAa;AACf;AAMO,IAAM,YAAuC;AAK7C,IAAM,uBAA2C;AAAA,EACtD,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,aAAa;AACf;AAKO,IAAM,uBAA2C;AAAA,EACtD,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,aAAa;AACf;;;ACjDO,IAAM,oBAAsC;AAAA,EACjD,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,WAAW;AACb;AAKO,IAAM,uBAAyC;AAAA,EACpD,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,WAAW;AACb;AAKO,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;;;AC9CA,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;AAYO,IAAM,2BAA2B,CACtC,UAAqC,UACjB;AAAA,EACpB;AACF;AAKO,IAAM,mBAAmB,CAC9B,UAAqC,UACkB;AAAA,EACvD,aAAa,yBAAyB,OAAO;AAAA,EAC7C,kBAAkB;AAAA,EAClB,qBAAqB;AACvB;AAQO,IAAM,UAA0B;AAAA,EACrC,IAAI,OAAO;AACT,WAAO,gBAAgB;AAAA,EACzB;AAAA,EACA,IAAI,UAAU;AACZ,WAAO,gBAAgB;AAAA,EACzB;AAAA,EACA,IAAI,MAAM;AACR,WAAO,gBAAgB;AAAA,EACzB;AAAA,EACA,IAAI,SAAS;AACX,WAAO,iBAAiB;AAAA,EAC1B;AAAA,EACA,QAAQ;AACV;","names":[]}

package/dist/dev.mjs

@@ -0,0 +1 @@
+var n=Object.defineProperty,e={};((e,a)=>{for(var r in a)n(e,r,{get:a[r],enumerable:!0})})(e,{analyticsOnlyConsent:()=>i,analyticsOnlyMapped:()=>g,createMockCookieFirstAPI:()=>d,createMockElbFn:()=>f,createMockWindow:()=>k,fullConsent:()=>a,fullConsentMapped:()=>l,marketingOnlyConsent:()=>s,marketingOnlyMapped:()=>m,minimalConsent:()=>t,minimalConsentMapped:()=>p,mockEnv:()=>v,noConsent:()=>o,noopLogger:()=>y,partialConsent:()=>r,partialConsentMapped:()=>c});var a={necessary:!0,functional:!0,performance:!0,advertising:!0},r={necessary:!0,functional:!0,performance:!1,advertising:!1},t={necessary:!0,functional:!1,performance:!1,advertising:!1},o=null,i={necessary:!0,functional:!1,performance:!0,advertising:!1},s={necessary:!0,functional:!1,performance:!1,advertising:!0},l={functional:!0,analytics:!0,marketing:!0},c={functional:!0,analytics:!1,marketing:!1},p={functional:!0,analytics:!1,marketing:!1},g={functional:!0,analytics:!0,marketing:!1},m={functional:!0,analytics:!1,marketing:!0},u=()=>{},f=()=>()=>Promise.resolve({ok:!0}),y={error:u,info:u,debug:u,throw:n=>{throw"string"==typeof n?new Error(n):n},scope:()=>y},d=(n=null)=>({consent:n}),k=(n=null)=>({CookieFirst:d(n),addEventListener:u,removeEventListener:u}),v={get push(){return f()},get command(){return f()},get elb(){return f()},get window(){return k()},logger:y};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":["/**\n * CookieFirst source examples for testing and documentation.\n */\n\nexport * from './inputs';\nexport * from './outputs';\nexport * from './env';\n","import type { CookieFirstConsent } from '../types';\n\n/**\n * Example CookieFirst consent inputs.\n *\n * These represent real consent states from CookieFirst CMP.\n */\n\n/**\n * Full consent - user accepted all categories\n */\nexport const fullConsent: CookieFirstConsent = {\n  necessary: true,\n  functional: true,\n  performance: true,\n  advertising: true,\n};\n\n/**\n * Partial consent - user accepted only necessary and functional\n */\nexport const partialConsent: CookieFirstConsent = {\n  necessary: true,\n  functional: true,\n  performance: false,\n  advertising: false,\n};\n\n/**\n * Minimal consent - user accepted only necessary (required)\n */\nexport const minimalConsent: CookieFirstConsent = {\n  necessary: true,\n  functional: false,\n  performance: false,\n  advertising: false,\n};\n\n/**\n * No consent - user hasn't made a choice yet\n * CookieFirst returns null when no explicit choice has been made\n */\nexport const noConsent: CookieFirstConsent | null = null;\n\n/**\n * Analytics only - user accepted performance tracking\n */\nexport const analyticsOnlyConsent: CookieFirstConsent = {\n  necessary: true,\n  functional: false,\n  performance: true,\n  advertising: false,\n};\n\n/**\n * Marketing only - user accepted advertising\n */\nexport const marketingOnlyConsent: CookieFirstConsent = {\n  necessary: true,\n  functional: false,\n  performance: false,\n  advertising: true,\n};\n","import type { WalkerOS } from '@walkeros/core';\n\n/**\n * Expected walkerOS consent outputs.\n *\n * These represent the consent state after mapping CookieFirst categories\n * to walkerOS consent groups using the default category map.\n */\n\n/**\n * Full consent mapped to walkerOS groups\n * (necessary + functional → functional, performance → analytics, advertising → marketing)\n */\nexport const fullConsentMapped: WalkerOS.Consent = {\n  functional: true,\n  analytics: true,\n  marketing: true,\n};\n\n/**\n * Partial consent mapped to walkerOS groups\n */\nexport const partialConsentMapped: WalkerOS.Consent = {\n  functional: true,\n  analytics: false,\n  marketing: false,\n};\n\n/**\n * Minimal consent mapped to walkerOS groups\n */\nexport const minimalConsentMapped: WalkerOS.Consent = {\n  functional: true,\n  analytics: false,\n  marketing: false,\n};\n\n/**\n * Analytics only consent mapped to walkerOS groups\n * Note: functional is true because necessary=true maps to functional\n * (OR logic: if ANY source category is true, target group is true)\n */\nexport const analyticsOnlyMapped: WalkerOS.Consent = {\n  functional: true,\n  analytics: true,\n  marketing: false,\n};\n\n/**\n * Marketing only consent mapped to walkerOS groups\n * Note: functional is true because necessary=true maps to functional\n * (OR logic: if ANY source category is true, target group is true)\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 { CookieFirstAPI, CookieFirstConsent } from '../types';\n\n/**\n * Example environment configurations for CookieFirst source testing.\n *\n * These provide mock structures for testing consent handling\n * without requiring a real browser environment.\n */\n\n// Simple no-op function for mocking\nconst noop = () => {};\n\n/**\n * Create a properly typed elb/push function mock that returns a promise with PushResult\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 * Environment interface for CookieFirst source\n */\ninterface CookieFirstEnv extends Source.BaseEnv {\n  window?: typeof window;\n}\n\n/**\n * Create a mock CookieFirst API object\n */\nexport const createMockCookieFirstAPI = (\n  consent: CookieFirstConsent | null = null,\n): CookieFirstAPI => ({\n  consent,\n});\n\n/**\n * Create a mock window object with CookieFirst\n */\nexport const createMockWindow = (\n  consent: CookieFirstConsent | null = null,\n): Partial<Window> & { CookieFirst: CookieFirstAPI } => ({\n  CookieFirst: createMockCookieFirstAPI(consent),\n  addEventListener: noop,\n  removeEventListener: noop,\n});\n\n/**\n * Standard mock environment for testing CookieFirst source\n *\n * Use this for testing consent handling without requiring\n * a real browser environment.\n */\nexport const mockEnv: CookieFirstEnv = {\n  get push() {\n    return createMockElbFn();\n  },\n  get command() {\n    return createMockElbFn();\n  },\n  get elb() {\n    return createMockElbFn();\n  },\n  get window() {\n    return createMockWindow() as unknown as typeof window;\n  },\n  logger: noopLogger,\n};\n"],"mappings":";;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACWO,IAAM,cAAkC;AAAA,EAC7C,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,aAAa;AACf;AAKO,IAAM,iBAAqC;AAAA,EAChD,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,aAAa;AACf;AAKO,IAAM,iBAAqC;AAAA,EAChD,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,aAAa;AACf;AAMO,IAAM,YAAuC;AAK7C,IAAM,uBAA2C;AAAA,EACtD,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,aAAa;AACf;AAKO,IAAM,uBAA2C;AAAA,EACtD,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,aAAa;AACf;;;ACjDO,IAAM,oBAAsC;AAAA,EACjD,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,WAAW;AACb;AAKO,IAAM,uBAAyC;AAAA,EACpD,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,WAAW;AACb;AAKO,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;;;AC9CA,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;AAYO,IAAM,2BAA2B,CACtC,UAAqC,UACjB;AAAA,EACpB;AACF;AAKO,IAAM,mBAAmB,CAC9B,UAAqC,UACkB;AAAA,EACvD,aAAa,yBAAyB,OAAO;AAAA,EAC7C,kBAAkB;AAAA,EAClB,qBAAqB;AACvB;AAQO,IAAM,UAA0B;AAAA,EACrC,IAAI,OAAO;AACT,WAAO,gBAAgB;AAAA,EACzB;AAAA,EACA,IAAI,UAAU;AACZ,WAAO,gBAAgB;AAAA,EACzB;AAAA,EACA,IAAI,MAAM;AACR,WAAO,gBAAgB;AAAA,EACzB;AAAA,EACA,IAAI,SAAS;AACX,WAAO,iBAAiB;AAAA,EAC1B;AAAA,EACA,QAAQ;AACV;","names":[]}

package/dist/examples/index.d.mts

@@ -0,0 +1,125 @@
+import { WalkerOS, Elb, Logger, Source } from '@walkeros/core';
+
+/**
+ * CookieFirst consent object structure
+ */
+interface CookieFirstConsent {
+    necessary?: boolean;
+    functional?: boolean;
+    performance?: boolean;
+    advertising?: boolean;
+    [category: string]: boolean | undefined;
+}
+/**
+ * CookieFirst global API interface
+ */
+interface CookieFirstAPI {
+    consent: CookieFirstConsent | null;
+}
+declare global {
+    interface Window {
+        CookieFirst?: CookieFirstAPI;
+        [key: string]: CookieFirstAPI | unknown;
+    }
+    interface WindowEventMap {
+        cf_init: Event;
+        cf_consent: CustomEvent<CookieFirstConsent>;
+    }
+}
+
+/**
+ * Example CookieFirst consent inputs.
+ *
+ * These represent real consent states from CookieFirst CMP.
+ */
+/**
+ * Full consent - user accepted all categories
+ */
+declare const fullConsent: CookieFirstConsent;
+/**
+ * Partial consent - user accepted only necessary and functional
+ */
+declare const partialConsent: CookieFirstConsent;
+/**
+ * Minimal consent - user accepted only necessary (required)
+ */
+declare const minimalConsent: CookieFirstConsent;
+/**
+ * No consent - user hasn't made a choice yet
+ * CookieFirst returns null when no explicit choice has been made
+ */
+declare const noConsent: CookieFirstConsent | null;
+/**
+ * Analytics only - user accepted performance tracking
+ */
+declare const analyticsOnlyConsent: CookieFirstConsent;
+/**
+ * Marketing only - user accepted advertising
+ */
+declare const marketingOnlyConsent: CookieFirstConsent;
+
+/**
+ * Expected walkerOS consent outputs.
+ *
+ * These represent the consent state after mapping CookieFirst categories
+ * to walkerOS consent groups using the default category map.
+ */
+/**
+ * Full consent mapped to walkerOS groups
+ * (necessary + functional → functional, performance → analytics, advertising → marketing)
+ */
+declare const fullConsentMapped: WalkerOS.Consent;
+/**
+ * Partial consent mapped to walkerOS groups
+ */
+declare const partialConsentMapped: WalkerOS.Consent;
+/**
+ * Minimal consent mapped to walkerOS groups
+ */
+declare const minimalConsentMapped: WalkerOS.Consent;
+/**
+ * Analytics only consent mapped to walkerOS groups
+ * Note: functional is true because necessary=true maps to functional
+ * (OR logic: if ANY source category is true, target group is true)
+ */
+declare const analyticsOnlyMapped: WalkerOS.Consent;
+/**
+ * Marketing only consent mapped to walkerOS groups
+ * Note: functional is true because necessary=true maps to functional
+ * (OR logic: if ANY source category is true, target group is true)
+ */
+declare const marketingOnlyMapped: WalkerOS.Consent;
+
+/**
+ * Create a properly typed elb/push function mock that returns a promise with PushResult
+ */
+declare const createMockElbFn: () => Elb.Fn;
+/**
+ * Simple no-op logger for demo purposes
+ */
+declare const noopLogger: Logger.Instance;
+/**
+ * Environment interface for CookieFirst source
+ */
+interface CookieFirstEnv extends Source.BaseEnv {
+    window?: typeof window;
+}
+/**
+ * Create a mock CookieFirst API object
+ */
+declare const createMockCookieFirstAPI: (consent?: CookieFirstConsent | null) => CookieFirstAPI;
+/**
+ * Create a mock window object with CookieFirst
+ */
+declare const createMockWindow: (consent?: CookieFirstConsent | null) => Partial<Window> & {
+    CookieFirst: CookieFirstAPI;
+};
+/**
+ * Standard mock environment for testing CookieFirst source
+ *
+ * Use this for testing consent handling without requiring
+ * a real browser environment.
+ */
+declare const mockEnv: CookieFirstEnv;
+
+export { analyticsOnlyConsent, analyticsOnlyMapped, createMockCookieFirstAPI, createMockElbFn, createMockWindow, fullConsent, fullConsentMapped, marketingOnlyConsent, marketingOnlyMapped, minimalConsent, minimalConsentMapped, mockEnv, noConsent, noopLogger, partialConsent, partialConsentMapped };