@walkeros/web-source-cmp-cookiefirst 3.0.2 → 3.1.0

package/dist/index.js

@@ -1 +1 @@
-"use strict";var n,e=Object.defineProperty,t=Object.getOwnPropertyDescriptor,i=Object.getOwnPropertyNames,o=Object.prototype.hasOwnProperty,a=(n,t)=>{for(var i in t)e(n,i,{get:t[i],enumerable:!0})},r={};a(r,{DEFAULT_CATEGORY_MAP:()=>x,SourceCookieFirst:()=>s,analyticsOnlyConsent:()=>p,analyticsOnlyMapped:()=>v,createMockCookieFirstAPI:()=>O,createMockElbFn:()=>b,createMockWindow:()=>M,default:()=>N,fullConsent:()=>l,fullConsentMapped:()=>d,marketingOnlyConsent:()=>g,marketingOnlyMapped:()=>k,minimalConsent:()=>u,minimalConsentMapped:()=>m,mockEnv:()=>E,noConsent:()=>f,noopLogger:()=>w,partialConsent:()=>c,partialConsentMapped:()=>y,setup:()=>P,sourceCookieFirst:()=>A,step:()=>h}),module.exports=(n=r,((n,a,r,s)=>{if(a&&"object"==typeof a||"function"==typeof a)for(let l of i(a))o.call(n,l)||l===r||e(n,l,{get:()=>a[l],enumerable:!(s=t(a,l))||s.enumerable});return n})(e({},"__esModule",{value:!0}),n));var s={},l={necessary:!0,functional:!0,performance:!0,advertising:!0},c={necessary:!0,functional:!0,performance:!1,advertising:!1},u={necessary:!0,functional:!1,performance:!1,advertising:!1},f=null,p={necessary:!0,functional:!1,performance:!0,advertising:!1},g={necessary:!0,functional:!1,performance:!1,advertising:!0},d={functional:!0,analytics:!0,marketing:!0},y={functional:!0,analytics:!1,marketing:!1},m={functional:!0,analytics:!1,marketing:!1},v={functional:!0,analytics:!0,marketing:!1},k={functional:!0,analytics:!1,marketing:!0},C=()=>{},b=()=>()=>Promise.resolve({ok:!0}),w={error:C,warn:C,info:C,debug:C,throw:n=>{throw"string"==typeof n?new Error(n):n},json:C,scope:()=>w},O=(n=null)=>({consent:n}),M=(n=null)=>({CookieFirst:O(n),addEventListener:C,removeEventListener:C}),E={get push(){return b()},get command(){return b()},get elb(){return b()},get window(){return M()},logger:w},h={};a(h,{categoryMapOverride:()=>_,cfInitDetection:()=>L,fullConsent:()=>j,partialConsent:()=>F});var j={in:{necessary:!0,functional:!0,performance:!0,advertising:!0},out:{functional:!0,analytics:!0,marketing:!0}},F={in:{necessary:!0,functional:!0,performance:!1,advertising:!1},out:{functional:!0,analytics:!1,marketing:!1}},_={description:"Custom categoryMap remaps performance to statistics instead of analytics",in:{necessary:!0,functional:!1,performance:!0,advertising:!1},mapping:{settings:{categoryMap:{performance:"statistics"}}},out:{functional:!0,statistics:!0,marketing:!1}},L={description:"CMP detected via cf_init CustomEvent (primary detection path)",in:{necessary:!0,functional:!1,performance:!1,advertising:!0},out:{functional:!0,analytics:!1,marketing:!0}},P=(n,e)=>{n&&"object"==typeof n&&(e.window.CookieFirst={consent:n})},x={necessary:"functional",functional:"functional",performance:"analytics",advertising:"marketing"},A=async n=>{var e,t,i,o,a,r,s;const{config:l,env:c}=n,{elb:u}=c,f=null!=(e=c.window)?e:void 0!==globalThis.window?globalThis.window:void 0,p={categoryMap:{...x,...null==(t=null==l?void 0:l.settings)?void 0:t.categoryMap},explicitOnly:null==(o=null==(i=null==l?void 0:l.settings)?void 0:i.explicitOnly)||o,globalName:null!=(r=null==(a=null==l?void 0:l.settings)?void 0:a.globalName)?r:"CookieFirst"},g={settings:p};let d,y;if(f){const n=n=>{if(p.explicitOnly&&!n)return;if(!n)return;const e={};Object.entries(n).forEach(([n,t])=>{var i,o;if("boolean"!=typeof t)return;const a=null!=(o=null==(i=p.categoryMap)?void 0:i[n])?o:n;e[a]=e[a]||t}),Object.keys(e).length>0&&u("walker consent",e)},e=null!=(s=p.globalName)?s:"CookieFirst",t=f[e];(null==t?void 0:t.consent)&&n(t.consent),d=()=>{var t;const i=f[e];n(null!=(t=null==i?void 0:i.consent)?t:null)},f.addEventListener("cf_init",d),y=e=>{n(e.detail)},f.addEventListener("cf_consent",y)}return{type:"cookiefirst",config:g,push:u,destroy:async n=>{f&&d&&f.removeEventListener("cf_init",d),f&&y&&f.removeEventListener("cf_consent",y)}}},N=A;//# sourceMappingURL=index.js.map
+"use strict";var e,n=Object.defineProperty,t=Object.getOwnPropertyDescriptor,i=Object.getOwnPropertyNames,r=Object.prototype.hasOwnProperty,o=(e,t)=>{for(var i in t)n(e,i,{get:t[i],enumerable:!0})},a={};o(a,{DEFAULT_CATEGORY_MAP:()=>A,SourceCookieFirst:()=>s,analyticsOnlyConsent:()=>f,analyticsOnlyMapped:()=>v,createMockCookieFirstAPI:()=>O,createMockElbFn:()=>b,createMockWindow:()=>M,createTrigger:()=>T,default:()=>D,fullConsent:()=>c,fullConsentMapped:()=>y,marketingOnlyConsent:()=>p,marketingOnlyMapped:()=>k,minimalConsent:()=>u,minimalConsentMapped:()=>m,mockEnv:()=>E,noConsent:()=>g,noopLogger:()=>C,partialConsent:()=>l,partialConsentMapped:()=>d,sourceCookieFirst:()=>N,step:()=>h,trigger:()=>x}),module.exports=(e=a,((e,o,a,s)=>{if(o&&"object"==typeof o||"function"==typeof o)for(let c of i(o))r.call(e,c)||c===a||n(e,c,{get:()=>o[c],enumerable:!(s=t(o,c))||s.enumerable});return e})(n({},"__esModule",{value:!0}),e));var s={},c={necessary:!0,functional:!0,performance:!0,advertising:!0},l={necessary:!0,functional:!0,performance:!1,advertising:!1},u={necessary:!0,functional:!1,performance:!1,advertising:!1},g=null,f={necessary:!0,functional:!1,performance:!0,advertising:!1},p={necessary:!0,functional:!1,performance:!1,advertising:!0},y={functional:!0,analytics:!0,marketing:!0},d={functional:!0,analytics:!1,marketing:!1},m={functional:!0,analytics:!1,marketing:!1},v={functional:!0,analytics:!0,marketing:!1},k={functional:!0,analytics:!1,marketing:!0},w=()=>{},b=()=>()=>Promise.resolve({ok:!0}),C={error:w,warn:w,info:w,debug:w,throw:e=>{throw"string"==typeof e?new Error(e):e},json:w,scope:()=>C},O=(e=null)=>({consent:e}),M=(e=null)=>({CookieFirst:O(e),addEventListener:w,removeEventListener:w}),E={get push(){return b()},get command(){return b()},get elb(){return b()},get window(){return M()},logger:C},h={};o(h,{categoryMapOverride:()=>j,cfInitDetection:()=>L,fullConsent:()=>F,partialConsent:()=>_});var F={trigger:{type:"consent"},in:{necessary:!0,functional:!0,performance:!0,advertising:!0},out:{functional:!0,analytics:!0,marketing:!0}},_={trigger:{type:"consent"},in:{necessary:!0,functional:!0,performance:!1,advertising:!1},out:{functional:!0,analytics:!1,marketing:!1}},j={description:"Custom categoryMap remaps performance to statistics instead of analytics",trigger:{type:"consent"},in:{necessary:!0,functional:!1,performance:!0,advertising:!1},mapping:{settings:{categoryMap:{performance:"statistics"}}},out:{functional:!0,statistics:!0,marketing:!1}},L={description:"CMP detected via cf_init CustomEvent (primary detection path)",trigger:{type:"consent"},in:{necessary:!0,functional:!1,performance:!1,advertising:!0},out:{functional:!0,analytics:!1,marketing:!0}},P=require("@walkeros/collector"),T=async e=>{let n;return{get flow(){return n},trigger:()=>async t=>{var i;if(window.CookieFirst={consent:t},!n){const t=await(0,P.startFlow)({...e,run:null==(i=e.run)||i});n={collector:t.collector,elb:t.elb}}window.dispatchEvent(new Event("cf_init"))}}},x=(e,n)=>{e&&"object"==typeof e&&(n.window.CookieFirst={consent:e})},A={necessary:"functional",functional:"functional",performance:"analytics",advertising:"marketing"},N=async e=>{var n,t,i,r,o,a,s;const{config:c,env:l}=e,{elb:u}=l,g=null!=(n=l.window)?n:void 0!==globalThis.window?globalThis.window:void 0,f={categoryMap:{...A,...null==(t=null==c?void 0:c.settings)?void 0:t.categoryMap},explicitOnly:null==(r=null==(i=null==c?void 0:c.settings)?void 0:i.explicitOnly)||r,globalName:null!=(a=null==(o=null==c?void 0:c.settings)?void 0:o.globalName)?a:"CookieFirst"},p={settings:f};let y,d;if(g){const e=e=>{if(f.explicitOnly&&!e)return;if(!e)return;const n={};Object.entries(e).forEach(([e,t])=>{var i,r;if("boolean"!=typeof t)return;const o=null!=(r=null==(i=f.categoryMap)?void 0:i[e])?r:e;n[o]=n[o]||t}),Object.keys(n).length>0&&u("walker consent",n)},n=null!=(s=f.globalName)?s:"CookieFirst",t=g[n];(null==t?void 0:t.consent)&&e(t.consent),y=()=>{var t;const i=g[n];e(null!=(t=null==i?void 0:i.consent)?t:null)},g.addEventListener("cf_init",y),d=n=>{e(n.detail)},g.addEventListener("cf_consent",d)}return{type:"cookiefirst",config:p,push:u,destroy:async e=>{g&&y&&g.removeEventListener("cf_init",y),g&&d&&g.removeEventListener("cf_consent",d)}}},D=N;//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/types/index.ts","../src/examples/inputs.ts","../src/examples/outputs.ts","../src/examples/env.ts","../src/examples/step.ts","../src/examples/setup.ts"],"sourcesContent":["import type { Source, WalkerOS } from '@walkeros/core';\nimport type {\n  Types,\n  Settings,\n  CookieFirstConsent,\n  CookieFirstAPI,\n} from './types';\n\n// Export types for external usage\nexport * as SourceCookieFirst from './types';\n\n// Export examples\nexport * from './examples';\n\n/**\n * Default category mapping from CookieFirst to walkerOS consent groups.\n *\n * Maps CookieFirst's standard categories to walkerOS convention:\n * - necessary/functional → functional (essential)\n * - performance → analytics (measurement)\n * - advertising → marketing (ads)\n */\nexport const DEFAULT_CATEGORY_MAP: Record<string, string> = {\n  necessary: 'functional',\n  functional: 'functional',\n  performance: 'analytics',\n  advertising: 'marketing',\n};\n\n/**\n * CookieFirst consent management source for walkerOS.\n *\n * This source listens to CookieFirst CMP events and translates\n * consent states to walkerOS consent commands.\n *\n * @example\n * ```typescript\n * import { sourceCookieFirst } from '@walkeros/web-source-cmp-cookiefirst';\n *\n * await startFlow({\n *   sources: {\n *     consent: {\n *       code: sourceCookieFirst,\n *       config: {\n *         settings: {\n *           categoryMap: {\n *             performance: 'statistics', // Custom mapping\n *           },\n *         },\n *       },\n *     },\n *   },\n * });\n * ```\n */\nexport const sourceCookieFirst: Source.Init<Types> = async (context) => {\n  const { config, env } = context;\n  const { elb } = env;\n\n  // Resolve window with fallback to globalThis\n  const actualWindow =\n    env.window ??\n    (typeof globalThis.window !== 'undefined' ? globalThis.window : undefined);\n\n  // Merge user settings with defaults\n  const settings: Settings = {\n    categoryMap: { ...DEFAULT_CATEGORY_MAP, ...config?.settings?.categoryMap },\n    explicitOnly: config?.settings?.explicitOnly ?? true,\n    globalName: config?.settings?.globalName ?? 'CookieFirst',\n  };\n\n  const fullConfig: Source.Config<Types> = { settings };\n\n  // Track listener references for cleanup\n  let initListener: (() => void) | undefined;\n  let consentListener: ((e: Event) => void) | undefined;\n\n  // Only setup if in browser environment\n  if (actualWindow) {\n    /**\n     * Handle consent state from CookieFirst.\n     * Maps CookieFirst categories to walkerOS consent groups and calls elb.\n     *\n     * When multiple CookieFirst categories map to the same walkerOS group,\n     * uses OR logic: if ANY category is true, the group is true.\n     */\n    const handleConsent = (consent: CookieFirstConsent | null) => {\n      // Skip if explicitOnly and no explicit consent given\n      if (settings.explicitOnly && !consent) return;\n      if (!consent) return;\n\n      // Map CookieFirst categories to walkerOS consent groups\n      // Use OR logic: if ANY source category is true, the target group is true\n      const state: WalkerOS.Consent = {};\n      Object.entries(consent).forEach(([category, value]) => {\n        if (typeof value !== 'boolean') return;\n        const mapped = settings.categoryMap?.[category] ?? category;\n        // OR logic: once true, stays true\n        state[mapped] = state[mapped] || value;\n      });\n\n      // Only call if we have consent state to report\n      if (Object.keys(state).length > 0) {\n        elb('walker consent', state);\n      }\n    };\n\n    const globalName = settings.globalName ?? 'CookieFirst';\n    const cmp = actualWindow[globalName] as CookieFirstAPI | undefined;\n\n    // Process existing consent if CMP already loaded\n    if (cmp?.consent) {\n      handleConsent(cmp.consent);\n    }\n\n    // Listen for CMP initialization\n    initListener = () => {\n      const cmp = actualWindow[globalName] as CookieFirstAPI | undefined;\n      handleConsent(cmp?.consent ?? null);\n    };\n    actualWindow.addEventListener('cf_init', initListener);\n\n    // Listen for consent changes\n    consentListener = (e: Event) => {\n      const customEvent = e as CustomEvent<CookieFirstConsent>;\n      handleConsent(customEvent.detail);\n    };\n    actualWindow.addEventListener('cf_consent', consentListener);\n  }\n\n  return {\n    type: 'cookiefirst',\n    config: fullConfig,\n    push: elb,\n    destroy: async (_context) => {\n      // Remove event listeners on cleanup\n      if (actualWindow && initListener) {\n        actualWindow.removeEventListener('cf_init', initListener);\n      }\n      if (actualWindow && consentListener) {\n        actualWindow.removeEventListener('cf_consent', consentListener);\n      }\n    },\n  };\n};\n\nexport default sourceCookieFirst;\n","import type { Source, Elb } from '@walkeros/core';\n\n/**\n * CookieFirst consent object structure\n */\nexport interface CookieFirstConsent {\n  necessary?: boolean;\n  functional?: boolean;\n  performance?: boolean;\n  advertising?: boolean;\n  [category: string]: boolean | undefined;\n}\n\n/**\n * CookieFirst global API interface\n */\nexport interface CookieFirstAPI {\n  consent: CookieFirstConsent | null;\n}\n\ndeclare global {\n  interface Window {\n    CookieFirst?: CookieFirstAPI;\n    [key: string]: CookieFirstAPI | unknown;\n  }\n\n  interface WindowEventMap {\n    cf_init: Event;\n    cf_consent: CustomEvent<CookieFirstConsent>;\n  }\n}\n\n/**\n * Settings for CookieFirst source\n */\nexport interface Settings {\n  /**\n   * Map CookieFirst categories to walkerOS consent groups.\n   * Keys: CookieFirst category names\n   * Values: walkerOS consent group names\n   *\n   * Default maps to standard walkerOS groups:\n   * - necessary → functional\n   * - functional → functional\n   * - performance → analytics\n   * - advertising → marketing\n   */\n  categoryMap?: Record<string, string>;\n\n  /**\n   * Only process explicit consent (user made a choice).\n   * When true: Ignores consent if CookieFirst.consent is null\n   * When false: Processes any consent state including defaults\n   *\n   * Default: true\n   */\n  explicitOnly?: boolean;\n\n  /**\n   * Custom name for window.CookieFirst object.\n   * Some implementations use a different global name.\n   *\n   * Default: 'CookieFirst'\n   */\n  globalName?: string;\n}\n\n/**\n * User input settings (all optional)\n */\nexport type InitSettings = Partial<Settings>;\n\n/**\n * No mapping configuration for this source\n */\nexport interface Mapping {}\n\n/**\n * Push function type - uses elb for consent commands\n */\nexport type Push = Elb.Fn;\n\n/**\n * Environment interface for CookieFirst source\n */\nexport interface Env extends Source.BaseEnv {\n  window?: Window & typeof globalThis;\n}\n\n/**\n * Types bundle for CookieFirst source\n */\nexport type Types = Source.Types<Settings, Mapping, Push, Env, InitSettings>;\n\n/**\n * Config type alias\n */\nexport type Config = Source.Config<Types>;\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  warn: noop,\n  info: noop,\n  debug: noop,\n  throw: (message: string | Error) => {\n    throw typeof message === 'string' ? new Error(message) : message;\n  },\n  json: noop,\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","import type { Flow } from '@walkeros/core';\n\nexport const fullConsent: Flow.StepExample = {\n  in: {\n    necessary: true,\n    functional: true,\n    performance: true,\n    advertising: true,\n  },\n  out: {\n    functional: true,\n    analytics: true,\n    marketing: true,\n  },\n};\n\nexport const partialConsent: Flow.StepExample = {\n  in: {\n    necessary: true,\n    functional: true,\n    performance: false,\n    advertising: false,\n  },\n  out: {\n    functional: true,\n    analytics: false,\n    marketing: false,\n  },\n};\n\nexport const categoryMapOverride: Flow.StepExample = {\n  description:\n    'Custom categoryMap remaps performance to statistics instead of analytics',\n  in: {\n    necessary: true,\n    functional: false,\n    performance: true,\n    advertising: false,\n  },\n  mapping: {\n    settings: {\n      categoryMap: {\n        performance: 'statistics',\n      },\n    },\n  },\n  out: {\n    functional: true,\n    statistics: true,\n    marketing: false,\n  },\n};\n\nexport const cfInitDetection: Flow.StepExample = {\n  description: 'CMP detected via cf_init CustomEvent (primary detection path)',\n  in: {\n    necessary: true,\n    functional: false,\n    performance: false,\n    advertising: true,\n  },\n  out: {\n    functional: true,\n    analytics: false,\n    marketing: true,\n  },\n};\n","import type { Source } from '@walkeros/core';\n\n/** Sets window.CookieFirst.consent before source init. */\nexport const setup: Source.SetupFn = (input, env) => {\n  if (!input || typeof input !== 'object') return;\n  (env.window as Record<string, unknown>).CookieFirst = { consent: input };\n};\n"],"mappings":"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","names":["fullConsent","partialConsent","_a","_b","cmp"]}
+{"version":3,"sources":["../src/index.ts","../src/types/index.ts","../src/examples/inputs.ts","../src/examples/outputs.ts","../src/examples/env.ts","../src/examples/step.ts","../src/examples/trigger.ts"],"sourcesContent":["import type { Source, WalkerOS } from '@walkeros/core';\nimport type {\n  Types,\n  Settings,\n  CookieFirstConsent,\n  CookieFirstAPI,\n} from './types';\n\n// Export types for external usage\nexport * as SourceCookieFirst from './types';\n\n// Export examples\nexport * from './examples';\n\n/**\n * Default category mapping from CookieFirst to walkerOS consent groups.\n *\n * Maps CookieFirst's standard categories to walkerOS convention:\n * - necessary/functional → functional (essential)\n * - performance → analytics (measurement)\n * - advertising → marketing (ads)\n */\nexport const DEFAULT_CATEGORY_MAP: Record<string, string> = {\n  necessary: 'functional',\n  functional: 'functional',\n  performance: 'analytics',\n  advertising: 'marketing',\n};\n\n/**\n * CookieFirst consent management source for walkerOS.\n *\n * This source listens to CookieFirst CMP events and translates\n * consent states to walkerOS consent commands.\n *\n * @example\n * ```typescript\n * import { sourceCookieFirst } from '@walkeros/web-source-cmp-cookiefirst';\n *\n * await startFlow({\n *   sources: {\n *     consent: {\n *       code: sourceCookieFirst,\n *       config: {\n *         settings: {\n *           categoryMap: {\n *             performance: 'statistics', // Custom mapping\n *           },\n *         },\n *       },\n *     },\n *   },\n * });\n * ```\n */\nexport const sourceCookieFirst: Source.Init<Types> = async (context) => {\n  const { config, env } = context;\n  const { elb } = env;\n\n  // Resolve window with fallback to globalThis\n  const actualWindow =\n    env.window ??\n    (typeof globalThis.window !== 'undefined' ? globalThis.window : undefined);\n\n  // Merge user settings with defaults\n  const settings: Settings = {\n    categoryMap: { ...DEFAULT_CATEGORY_MAP, ...config?.settings?.categoryMap },\n    explicitOnly: config?.settings?.explicitOnly ?? true,\n    globalName: config?.settings?.globalName ?? 'CookieFirst',\n  };\n\n  const fullConfig: Source.Config<Types> = { settings };\n\n  // Track listener references for cleanup\n  let initListener: (() => void) | undefined;\n  let consentListener: ((e: Event) => void) | undefined;\n\n  // Only setup if in browser environment\n  if (actualWindow) {\n    /**\n     * Handle consent state from CookieFirst.\n     * Maps CookieFirst categories to walkerOS consent groups and calls elb.\n     *\n     * When multiple CookieFirst categories map to the same walkerOS group,\n     * uses OR logic: if ANY category is true, the group is true.\n     */\n    const handleConsent = (consent: CookieFirstConsent | null) => {\n      // Skip if explicitOnly and no explicit consent given\n      if (settings.explicitOnly && !consent) return;\n      if (!consent) return;\n\n      // Map CookieFirst categories to walkerOS consent groups\n      // Use OR logic: if ANY source category is true, the target group is true\n      const state: WalkerOS.Consent = {};\n      Object.entries(consent).forEach(([category, value]) => {\n        if (typeof value !== 'boolean') return;\n        const mapped = settings.categoryMap?.[category] ?? category;\n        // OR logic: once true, stays true\n        state[mapped] = state[mapped] || value;\n      });\n\n      // Only call if we have consent state to report\n      if (Object.keys(state).length > 0) {\n        elb('walker consent', state);\n      }\n    };\n\n    const globalName = settings.globalName ?? 'CookieFirst';\n    const cmp = actualWindow[globalName] as CookieFirstAPI | undefined;\n\n    // Process existing consent if CMP already loaded\n    if (cmp?.consent) {\n      handleConsent(cmp.consent);\n    }\n\n    // Listen for CMP initialization\n    initListener = () => {\n      const cmp = actualWindow[globalName] as CookieFirstAPI | undefined;\n      handleConsent(cmp?.consent ?? null);\n    };\n    actualWindow.addEventListener('cf_init', initListener);\n\n    // Listen for consent changes\n    consentListener = (e: Event) => {\n      const customEvent = e as CustomEvent<CookieFirstConsent>;\n      handleConsent(customEvent.detail);\n    };\n    actualWindow.addEventListener('cf_consent', consentListener);\n  }\n\n  return {\n    type: 'cookiefirst',\n    config: fullConfig,\n    push: elb,\n    destroy: async (_context) => {\n      // Remove event listeners on cleanup\n      if (actualWindow && initListener) {\n        actualWindow.removeEventListener('cf_init', initListener);\n      }\n      if (actualWindow && consentListener) {\n        actualWindow.removeEventListener('cf_consent', consentListener);\n      }\n    },\n  };\n};\n\nexport default sourceCookieFirst;\n","import type { Source, Elb } from '@walkeros/core';\n\n/**\n * CookieFirst consent object structure\n */\nexport interface CookieFirstConsent {\n  necessary?: boolean;\n  functional?: boolean;\n  performance?: boolean;\n  advertising?: boolean;\n  [category: string]: boolean | undefined;\n}\n\n/**\n * CookieFirst global API interface\n */\nexport interface CookieFirstAPI {\n  consent: CookieFirstConsent | null;\n}\n\ndeclare global {\n  interface Window {\n    CookieFirst?: CookieFirstAPI;\n    [key: string]: CookieFirstAPI | unknown;\n  }\n\n  interface WindowEventMap {\n    cf_init: Event;\n    cf_consent: CustomEvent<CookieFirstConsent>;\n  }\n}\n\n/**\n * Settings for CookieFirst source\n */\nexport interface Settings {\n  /**\n   * Map CookieFirst categories to walkerOS consent groups.\n   * Keys: CookieFirst category names\n   * Values: walkerOS consent group names\n   *\n   * Default maps to standard walkerOS groups:\n   * - necessary → functional\n   * - functional → functional\n   * - performance → analytics\n   * - advertising → marketing\n   */\n  categoryMap?: Record<string, string>;\n\n  /**\n   * Only process explicit consent (user made a choice).\n   * When true: Ignores consent if CookieFirst.consent is null\n   * When false: Processes any consent state including defaults\n   *\n   * Default: true\n   */\n  explicitOnly?: boolean;\n\n  /**\n   * Custom name for window.CookieFirst object.\n   * Some implementations use a different global name.\n   *\n   * Default: 'CookieFirst'\n   */\n  globalName?: string;\n}\n\n/**\n * User input settings (all optional)\n */\nexport type InitSettings = Partial<Settings>;\n\n/**\n * No mapping configuration for this source\n */\nexport interface Mapping {}\n\n/**\n * Push function type - uses elb for consent commands\n */\nexport type Push = Elb.Fn;\n\n/**\n * Environment interface for CookieFirst source\n */\nexport interface Env extends Source.BaseEnv {\n  window?: Window & typeof globalThis;\n}\n\n/**\n * Types bundle for CookieFirst source\n */\nexport type Types = Source.Types<Settings, Mapping, Push, Env, InitSettings>;\n\n/**\n * Config type alias\n */\nexport type Config = Source.Config<Types>;\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  warn: noop,\n  info: noop,\n  debug: noop,\n  throw: (message: string | Error) => {\n    throw typeof message === 'string' ? new Error(message) : message;\n  },\n  json: noop,\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","import type { Flow } from '@walkeros/core';\n\nexport const fullConsent: Flow.StepExample = {\n  trigger: { type: 'consent' },\n  in: {\n    necessary: true,\n    functional: true,\n    performance: true,\n    advertising: true,\n  },\n  out: {\n    functional: true,\n    analytics: true,\n    marketing: true,\n  },\n};\n\nexport const partialConsent: Flow.StepExample = {\n  trigger: { type: 'consent' },\n  in: {\n    necessary: true,\n    functional: true,\n    performance: false,\n    advertising: false,\n  },\n  out: {\n    functional: true,\n    analytics: false,\n    marketing: false,\n  },\n};\n\nexport const categoryMapOverride: Flow.StepExample = {\n  description:\n    'Custom categoryMap remaps performance to statistics instead of analytics',\n  trigger: { type: 'consent' },\n  in: {\n    necessary: true,\n    functional: false,\n    performance: true,\n    advertising: false,\n  },\n  mapping: {\n    settings: {\n      categoryMap: {\n        performance: 'statistics',\n      },\n    },\n  },\n  out: {\n    functional: true,\n    statistics: true,\n    marketing: false,\n  },\n};\n\nexport const cfInitDetection: Flow.StepExample = {\n  description: 'CMP detected via cf_init CustomEvent (primary detection path)',\n  trigger: { type: 'consent' },\n  in: {\n    necessary: true,\n    functional: false,\n    performance: false,\n    advertising: true,\n  },\n  out: {\n    functional: true,\n    analytics: false,\n    marketing: true,\n  },\n};\n","import type { Trigger, Collector } from '@walkeros/core';\nimport { startFlow } from '@walkeros/collector';\n\ninterface CookieFirstConsent {\n  necessary?: boolean;\n  functional?: boolean;\n  performance?: boolean;\n  advertising?: boolean;\n  [category: string]: boolean | undefined;\n}\n\nconst createTrigger: Trigger.CreateFn<CookieFirstConsent, void> = async (\n  config: Collector.InitConfig,\n) => {\n  let flow: Trigger.FlowHandle | undefined;\n\n  const trigger: Trigger.Fn<CookieFirstConsent, void> =\n    () => async (content: CookieFirstConsent) => {\n      // Pre-init: set CookieFirst global (source reads this during init)\n      (window as unknown as Record<string, unknown>).CookieFirst = {\n        consent: content,\n      };\n\n      // Lazy startFlow — source reads global + registers event listeners\n      if (!flow) {\n        const result = await startFlow({ ...config, run: config.run ?? true });\n        flow = { collector: result.collector, elb: result.elb };\n      }\n\n      // Post-init: dispatch cf_init to trigger consent processing\n      window.dispatchEvent(new Event('cf_init'));\n    };\n\n  return {\n    get flow() {\n      return flow;\n    },\n    trigger,\n  };\n};\n\n/** Sets window.CookieFirst.consent before source init (legacy). */\nconst trigger = (input: unknown, env: Record<string, unknown>): void => {\n  if (!input || typeof input !== 'object') return;\n  (env.window as Record<string, unknown>).CookieFirst = { consent: input };\n};\n\nexport { createTrigger, trigger };\n"],"mappings":"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","names":["fullConsent","partialConsent","trigger","_a","_b","cmp"]}

package/dist/index.mjs

@@ -1 +1 @@
-var n=Object.defineProperty,e={},t={necessary:!0,functional:!0,performance:!0,advertising:!0},i={necessary:!0,functional:!0,performance:!1,advertising:!1},a={necessary:!0,functional:!1,performance:!1,advertising:!1},o=null,r={necessary:!0,functional:!1,performance:!0,advertising:!1},s={necessary:!0,functional:!1,performance:!1,advertising:!0},c={functional:!0,analytics:!0,marketing:!0},l={functional:!0,analytics:!1,marketing:!1},u={functional:!0,analytics:!1,marketing:!1},f={functional:!0,analytics:!0,marketing:!1},g={functional:!0,analytics:!1,marketing:!0},d=()=>{},v=()=>()=>Promise.resolve({ok:!0}),p={error:d,warn:d,info:d,debug:d,throw:n=>{throw"string"==typeof n?new Error(n):n},json:d,scope:()=>p},y=(n=null)=>({consent:n}),m=(n=null)=>({CookieFirst:y(n),addEventListener:d,removeEventListener:d}),k={get push(){return v()},get command(){return v()},get elb(){return v()},get window(){return m()},logger:p},w={};((e,t)=>{for(var i in t)n(e,i,{get:t[i],enumerable:!0})})(w,{categoryMapOverride:()=>h,cfInitDetection:()=>E,fullConsent:()=>b,partialConsent:()=>C});var b={in:{necessary:!0,functional:!0,performance:!0,advertising:!0},out:{functional:!0,analytics:!0,marketing:!0}},C={in:{necessary:!0,functional:!0,performance:!1,advertising:!1},out:{functional:!0,analytics:!1,marketing:!1}},h={description:"Custom categoryMap remaps performance to statistics instead of analytics",in:{necessary:!0,functional:!1,performance:!0,advertising:!1},mapping:{settings:{categoryMap:{performance:"statistics"}}},out:{functional:!0,statistics:!0,marketing:!1}},E={description:"CMP detected via cf_init CustomEvent (primary detection path)",in:{necessary:!0,functional:!1,performance:!1,advertising:!0},out:{functional:!0,analytics:!1,marketing:!0}},M=(n,e)=>{n&&"object"==typeof n&&(e.window.CookieFirst={consent:n})},O={necessary:"functional",functional:"functional",performance:"analytics",advertising:"marketing"},L=async n=>{var e,t,i,a,o,r,s;const{config:c,env:l}=n,{elb:u}=l,f=null!=(e=l.window)?e:void 0!==globalThis.window?globalThis.window:void 0,g={categoryMap:{...O,...null==(t=null==c?void 0:c.settings)?void 0:t.categoryMap},explicitOnly:null==(a=null==(i=null==c?void 0:c.settings)?void 0:i.explicitOnly)||a,globalName:null!=(r=null==(o=null==c?void 0:c.settings)?void 0:o.globalName)?r:"CookieFirst"},d={settings:g};let v,p;if(f){const n=n=>{if(g.explicitOnly&&!n)return;if(!n)return;const e={};Object.entries(n).forEach(([n,t])=>{var i,a;if("boolean"!=typeof t)return;const o=null!=(a=null==(i=g.categoryMap)?void 0:i[n])?a:n;e[o]=e[o]||t}),Object.keys(e).length>0&&u("walker consent",e)},e=null!=(s=g.globalName)?s:"CookieFirst",t=f[e];(null==t?void 0:t.consent)&&n(t.consent),v=()=>{var t;const i=f[e];n(null!=(t=null==i?void 0:i.consent)?t:null)},f.addEventListener("cf_init",v),p=e=>{n(e.detail)},f.addEventListener("cf_consent",p)}return{type:"cookiefirst",config:d,push:u,destroy:async n=>{f&&v&&f.removeEventListener("cf_init",v),f&&p&&f.removeEventListener("cf_consent",p)}}},j=L;export{O as DEFAULT_CATEGORY_MAP,e as SourceCookieFirst,r as analyticsOnlyConsent,f as analyticsOnlyMapped,y as createMockCookieFirstAPI,v as createMockElbFn,m as createMockWindow,j as default,t as fullConsent,c as fullConsentMapped,s as marketingOnlyConsent,g as marketingOnlyMapped,a as minimalConsent,u as minimalConsentMapped,k as mockEnv,o as noConsent,p as noopLogger,i as partialConsent,l as partialConsentMapped,M as setup,L as sourceCookieFirst,w as step};//# sourceMappingURL=index.mjs.map
+var n=Object.defineProperty,e={},t={necessary:!0,functional:!0,performance:!0,advertising:!0},i={necessary:!0,functional:!0,performance:!1,advertising:!1},r={necessary:!0,functional:!1,performance:!1,advertising:!1},o=null,a={necessary:!0,functional:!1,performance:!0,advertising:!1},s={necessary:!0,functional:!1,performance:!1,advertising:!0},c={functional:!0,analytics:!0,marketing:!0},l={functional:!0,analytics:!1,marketing:!1},u={functional:!0,analytics:!1,marketing:!1},f={functional:!0,analytics:!0,marketing:!1},g={functional:!0,analytics:!1,marketing:!0},d=()=>{},p=()=>()=>Promise.resolve({ok:!0}),v={error:d,warn:d,info:d,debug:d,throw:n=>{throw"string"==typeof n?new Error(n):n},json:d,scope:()=>v},y=(n=null)=>({consent:n}),m=(n=null)=>({CookieFirst:y(n),addEventListener:d,removeEventListener:d}),w={get push(){return p()},get command(){return p()},get elb(){return p()},get window(){return m()},logger:v},k={};((e,t)=>{for(var i in t)n(e,i,{get:t[i],enumerable:!0})})(k,{categoryMapOverride:()=>E,cfInitDetection:()=>h,fullConsent:()=>b,partialConsent:()=>C});var b={trigger:{type:"consent"},in:{necessary:!0,functional:!0,performance:!0,advertising:!0},out:{functional:!0,analytics:!0,marketing:!0}},C={trigger:{type:"consent"},in:{necessary:!0,functional:!0,performance:!1,advertising:!1},out:{functional:!0,analytics:!1,marketing:!1}},E={description:"Custom categoryMap remaps performance to statistics instead of analytics",trigger:{type:"consent"},in:{necessary:!0,functional:!1,performance:!0,advertising:!1},mapping:{settings:{categoryMap:{performance:"statistics"}}},out:{functional:!0,statistics:!0,marketing:!1}},h={description:"CMP detected via cf_init CustomEvent (primary detection path)",trigger:{type:"consent"},in:{necessary:!0,functional:!1,performance:!1,advertising:!0},out:{functional:!0,analytics:!1,marketing:!0}};import{startFlow as M}from"@walkeros/collector";var O=async n=>{let e;return{get flow(){return e},trigger:()=>async t=>{var i;if(window.CookieFirst={consent:t},!e){const t=await M({...n,run:null==(i=n.run)||i});e={collector:t.collector,elb:t.elb}}window.dispatchEvent(new Event("cf_init"))}}},F=(n,e)=>{n&&"object"==typeof n&&(e.window.CookieFirst={consent:n})},L={necessary:"functional",functional:"functional",performance:"analytics",advertising:"marketing"},_=async n=>{var e,t,i,r,o,a,s;const{config:c,env:l}=n,{elb:u}=l,f=null!=(e=l.window)?e:void 0!==globalThis.window?globalThis.window:void 0,g={categoryMap:{...L,...null==(t=null==c?void 0:c.settings)?void 0:t.categoryMap},explicitOnly:null==(r=null==(i=null==c?void 0:c.settings)?void 0:i.explicitOnly)||r,globalName:null!=(a=null==(o=null==c?void 0:c.settings)?void 0:o.globalName)?a:"CookieFirst"},d={settings:g};let p,v;if(f){const n=n=>{if(g.explicitOnly&&!n)return;if(!n)return;const e={};Object.entries(n).forEach(([n,t])=>{var i,r;if("boolean"!=typeof t)return;const o=null!=(r=null==(i=g.categoryMap)?void 0:i[n])?r:n;e[o]=e[o]||t}),Object.keys(e).length>0&&u("walker consent",e)},e=null!=(s=g.globalName)?s:"CookieFirst",t=f[e];(null==t?void 0:t.consent)&&n(t.consent),p=()=>{var t;const i=f[e];n(null!=(t=null==i?void 0:i.consent)?t:null)},f.addEventListener("cf_init",p),v=e=>{n(e.detail)},f.addEventListener("cf_consent",v)}return{type:"cookiefirst",config:d,push:u,destroy:async n=>{f&&p&&f.removeEventListener("cf_init",p),f&&v&&f.removeEventListener("cf_consent",v)}}},j=_;export{L as DEFAULT_CATEGORY_MAP,e as SourceCookieFirst,a as analyticsOnlyConsent,f as analyticsOnlyMapped,y as createMockCookieFirstAPI,p as createMockElbFn,m as createMockWindow,O as createTrigger,j as default,t as fullConsent,c as fullConsentMapped,s as marketingOnlyConsent,g as marketingOnlyMapped,r as minimalConsent,u as minimalConsentMapped,w as mockEnv,o as noConsent,v as noopLogger,i as partialConsent,l as partialConsentMapped,_ as sourceCookieFirst,k as step,F as trigger};//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types/index.ts","../src/examples/inputs.ts","../src/examples/outputs.ts","../src/examples/env.ts","../src/examples/step.ts","../src/examples/setup.ts","../src/index.ts"],"sourcesContent":["import type { Source, Elb } from '@walkeros/core';\n\n/**\n * CookieFirst consent object structure\n */\nexport interface CookieFirstConsent {\n  necessary?: boolean;\n  functional?: boolean;\n  performance?: boolean;\n  advertising?: boolean;\n  [category: string]: boolean | undefined;\n}\n\n/**\n * CookieFirst global API interface\n */\nexport interface CookieFirstAPI {\n  consent: CookieFirstConsent | null;\n}\n\ndeclare global {\n  interface Window {\n    CookieFirst?: CookieFirstAPI;\n    [key: string]: CookieFirstAPI | unknown;\n  }\n\n  interface WindowEventMap {\n    cf_init: Event;\n    cf_consent: CustomEvent<CookieFirstConsent>;\n  }\n}\n\n/**\n * Settings for CookieFirst source\n */\nexport interface Settings {\n  /**\n   * Map CookieFirst categories to walkerOS consent groups.\n   * Keys: CookieFirst category names\n   * Values: walkerOS consent group names\n   *\n   * Default maps to standard walkerOS groups:\n   * - necessary → functional\n   * - functional → functional\n   * - performance → analytics\n   * - advertising → marketing\n   */\n  categoryMap?: Record<string, string>;\n\n  /**\n   * Only process explicit consent (user made a choice).\n   * When true: Ignores consent if CookieFirst.consent is null\n   * When false: Processes any consent state including defaults\n   *\n   * Default: true\n   */\n  explicitOnly?: boolean;\n\n  /**\n   * Custom name for window.CookieFirst object.\n   * Some implementations use a different global name.\n   *\n   * Default: 'CookieFirst'\n   */\n  globalName?: string;\n}\n\n/**\n * User input settings (all optional)\n */\nexport type InitSettings = Partial<Settings>;\n\n/**\n * No mapping configuration for this source\n */\nexport interface Mapping {}\n\n/**\n * Push function type - uses elb for consent commands\n */\nexport type Push = Elb.Fn;\n\n/**\n * Environment interface for CookieFirst source\n */\nexport interface Env extends Source.BaseEnv {\n  window?: Window & typeof globalThis;\n}\n\n/**\n * Types bundle for CookieFirst source\n */\nexport type Types = Source.Types<Settings, Mapping, Push, Env, InitSettings>;\n\n/**\n * Config type alias\n */\nexport type Config = Source.Config<Types>;\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  warn: noop,\n  info: noop,\n  debug: noop,\n  throw: (message: string | Error) => {\n    throw typeof message === 'string' ? new Error(message) : message;\n  },\n  json: noop,\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","import type { Flow } from '@walkeros/core';\n\nexport const fullConsent: Flow.StepExample = {\n  in: {\n    necessary: true,\n    functional: true,\n    performance: true,\n    advertising: true,\n  },\n  out: {\n    functional: true,\n    analytics: true,\n    marketing: true,\n  },\n};\n\nexport const partialConsent: Flow.StepExample = {\n  in: {\n    necessary: true,\n    functional: true,\n    performance: false,\n    advertising: false,\n  },\n  out: {\n    functional: true,\n    analytics: false,\n    marketing: false,\n  },\n};\n\nexport const categoryMapOverride: Flow.StepExample = {\n  description:\n    'Custom categoryMap remaps performance to statistics instead of analytics',\n  in: {\n    necessary: true,\n    functional: false,\n    performance: true,\n    advertising: false,\n  },\n  mapping: {\n    settings: {\n      categoryMap: {\n        performance: 'statistics',\n      },\n    },\n  },\n  out: {\n    functional: true,\n    statistics: true,\n    marketing: false,\n  },\n};\n\nexport const cfInitDetection: Flow.StepExample = {\n  description: 'CMP detected via cf_init CustomEvent (primary detection path)',\n  in: {\n    necessary: true,\n    functional: false,\n    performance: false,\n    advertising: true,\n  },\n  out: {\n    functional: true,\n    analytics: false,\n    marketing: true,\n  },\n};\n","import type { Source } from '@walkeros/core';\n\n/** Sets window.CookieFirst.consent before source init. */\nexport const setup: Source.SetupFn = (input, env) => {\n  if (!input || typeof input !== 'object') return;\n  (env.window as Record<string, unknown>).CookieFirst = { consent: input };\n};\n","import type { Source, WalkerOS } from '@walkeros/core';\nimport type {\n  Types,\n  Settings,\n  CookieFirstConsent,\n  CookieFirstAPI,\n} from './types';\n\n// Export types for external usage\nexport * as SourceCookieFirst from './types';\n\n// Export examples\nexport * from './examples';\n\n/**\n * Default category mapping from CookieFirst to walkerOS consent groups.\n *\n * Maps CookieFirst's standard categories to walkerOS convention:\n * - necessary/functional → functional (essential)\n * - performance → analytics (measurement)\n * - advertising → marketing (ads)\n */\nexport const DEFAULT_CATEGORY_MAP: Record<string, string> = {\n  necessary: 'functional',\n  functional: 'functional',\n  performance: 'analytics',\n  advertising: 'marketing',\n};\n\n/**\n * CookieFirst consent management source for walkerOS.\n *\n * This source listens to CookieFirst CMP events and translates\n * consent states to walkerOS consent commands.\n *\n * @example\n * ```typescript\n * import { sourceCookieFirst } from '@walkeros/web-source-cmp-cookiefirst';\n *\n * await startFlow({\n *   sources: {\n *     consent: {\n *       code: sourceCookieFirst,\n *       config: {\n *         settings: {\n *           categoryMap: {\n *             performance: 'statistics', // Custom mapping\n *           },\n *         },\n *       },\n *     },\n *   },\n * });\n * ```\n */\nexport const sourceCookieFirst: Source.Init<Types> = async (context) => {\n  const { config, env } = context;\n  const { elb } = env;\n\n  // Resolve window with fallback to globalThis\n  const actualWindow =\n    env.window ??\n    (typeof globalThis.window !== 'undefined' ? globalThis.window : undefined);\n\n  // Merge user settings with defaults\n  const settings: Settings = {\n    categoryMap: { ...DEFAULT_CATEGORY_MAP, ...config?.settings?.categoryMap },\n    explicitOnly: config?.settings?.explicitOnly ?? true,\n    globalName: config?.settings?.globalName ?? 'CookieFirst',\n  };\n\n  const fullConfig: Source.Config<Types> = { settings };\n\n  // Track listener references for cleanup\n  let initListener: (() => void) | undefined;\n  let consentListener: ((e: Event) => void) | undefined;\n\n  // Only setup if in browser environment\n  if (actualWindow) {\n    /**\n     * Handle consent state from CookieFirst.\n     * Maps CookieFirst categories to walkerOS consent groups and calls elb.\n     *\n     * When multiple CookieFirst categories map to the same walkerOS group,\n     * uses OR logic: if ANY category is true, the group is true.\n     */\n    const handleConsent = (consent: CookieFirstConsent | null) => {\n      // Skip if explicitOnly and no explicit consent given\n      if (settings.explicitOnly && !consent) return;\n      if (!consent) return;\n\n      // Map CookieFirst categories to walkerOS consent groups\n      // Use OR logic: if ANY source category is true, the target group is true\n      const state: WalkerOS.Consent = {};\n      Object.entries(consent).forEach(([category, value]) => {\n        if (typeof value !== 'boolean') return;\n        const mapped = settings.categoryMap?.[category] ?? category;\n        // OR logic: once true, stays true\n        state[mapped] = state[mapped] || value;\n      });\n\n      // Only call if we have consent state to report\n      if (Object.keys(state).length > 0) {\n        elb('walker consent', state);\n      }\n    };\n\n    const globalName = settings.globalName ?? 'CookieFirst';\n    const cmp = actualWindow[globalName] as CookieFirstAPI | undefined;\n\n    // Process existing consent if CMP already loaded\n    if (cmp?.consent) {\n      handleConsent(cmp.consent);\n    }\n\n    // Listen for CMP initialization\n    initListener = () => {\n      const cmp = actualWindow[globalName] as CookieFirstAPI | undefined;\n      handleConsent(cmp?.consent ?? null);\n    };\n    actualWindow.addEventListener('cf_init', initListener);\n\n    // Listen for consent changes\n    consentListener = (e: Event) => {\n      const customEvent = e as CustomEvent<CookieFirstConsent>;\n      handleConsent(customEvent.detail);\n    };\n    actualWindow.addEventListener('cf_consent', consentListener);\n  }\n\n  return {\n    type: 'cookiefirst',\n    config: fullConfig,\n    push: elb,\n    destroy: async (_context) => {\n      // Remove event listeners on cleanup\n      if (actualWindow && initListener) {\n        actualWindow.removeEventListener('cf_init', initListener);\n      }\n      if (actualWindow && consentListener) {\n        actualWindow.removeEventListener('cf_consent', consentListener);\n      }\n    },\n  };\n};\n\nexport default sourceCookieFirst;\n"],"mappings":"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","names":["fullConsent","partialConsent","_a","_b","cmp"]}
+{"version":3,"sources":["../src/types/index.ts","../src/examples/inputs.ts","../src/examples/outputs.ts","../src/examples/env.ts","../src/examples/step.ts","../src/examples/trigger.ts","../src/index.ts"],"sourcesContent":["import type { Source, Elb } from '@walkeros/core';\n\n/**\n * CookieFirst consent object structure\n */\nexport interface CookieFirstConsent {\n  necessary?: boolean;\n  functional?: boolean;\n  performance?: boolean;\n  advertising?: boolean;\n  [category: string]: boolean | undefined;\n}\n\n/**\n * CookieFirst global API interface\n */\nexport interface CookieFirstAPI {\n  consent: CookieFirstConsent | null;\n}\n\ndeclare global {\n  interface Window {\n    CookieFirst?: CookieFirstAPI;\n    [key: string]: CookieFirstAPI | unknown;\n  }\n\n  interface WindowEventMap {\n    cf_init: Event;\n    cf_consent: CustomEvent<CookieFirstConsent>;\n  }\n}\n\n/**\n * Settings for CookieFirst source\n */\nexport interface Settings {\n  /**\n   * Map CookieFirst categories to walkerOS consent groups.\n   * Keys: CookieFirst category names\n   * Values: walkerOS consent group names\n   *\n   * Default maps to standard walkerOS groups:\n   * - necessary → functional\n   * - functional → functional\n   * - performance → analytics\n   * - advertising → marketing\n   */\n  categoryMap?: Record<string, string>;\n\n  /**\n   * Only process explicit consent (user made a choice).\n   * When true: Ignores consent if CookieFirst.consent is null\n   * When false: Processes any consent state including defaults\n   *\n   * Default: true\n   */\n  explicitOnly?: boolean;\n\n  /**\n   * Custom name for window.CookieFirst object.\n   * Some implementations use a different global name.\n   *\n   * Default: 'CookieFirst'\n   */\n  globalName?: string;\n}\n\n/**\n * User input settings (all optional)\n */\nexport type InitSettings = Partial<Settings>;\n\n/**\n * No mapping configuration for this source\n */\nexport interface Mapping {}\n\n/**\n * Push function type - uses elb for consent commands\n */\nexport type Push = Elb.Fn;\n\n/**\n * Environment interface for CookieFirst source\n */\nexport interface Env extends Source.BaseEnv {\n  window?: Window & typeof globalThis;\n}\n\n/**\n * Types bundle for CookieFirst source\n */\nexport type Types = Source.Types<Settings, Mapping, Push, Env, InitSettings>;\n\n/**\n * Config type alias\n */\nexport type Config = Source.Config<Types>;\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  warn: noop,\n  info: noop,\n  debug: noop,\n  throw: (message: string | Error) => {\n    throw typeof message === 'string' ? new Error(message) : message;\n  },\n  json: noop,\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","import type { Flow } from '@walkeros/core';\n\nexport const fullConsent: Flow.StepExample = {\n  trigger: { type: 'consent' },\n  in: {\n    necessary: true,\n    functional: true,\n    performance: true,\n    advertising: true,\n  },\n  out: {\n    functional: true,\n    analytics: true,\n    marketing: true,\n  },\n};\n\nexport const partialConsent: Flow.StepExample = {\n  trigger: { type: 'consent' },\n  in: {\n    necessary: true,\n    functional: true,\n    performance: false,\n    advertising: false,\n  },\n  out: {\n    functional: true,\n    analytics: false,\n    marketing: false,\n  },\n};\n\nexport const categoryMapOverride: Flow.StepExample = {\n  description:\n    'Custom categoryMap remaps performance to statistics instead of analytics',\n  trigger: { type: 'consent' },\n  in: {\n    necessary: true,\n    functional: false,\n    performance: true,\n    advertising: false,\n  },\n  mapping: {\n    settings: {\n      categoryMap: {\n        performance: 'statistics',\n      },\n    },\n  },\n  out: {\n    functional: true,\n    statistics: true,\n    marketing: false,\n  },\n};\n\nexport const cfInitDetection: Flow.StepExample = {\n  description: 'CMP detected via cf_init CustomEvent (primary detection path)',\n  trigger: { type: 'consent' },\n  in: {\n    necessary: true,\n    functional: false,\n    performance: false,\n    advertising: true,\n  },\n  out: {\n    functional: true,\n    analytics: false,\n    marketing: true,\n  },\n};\n","import type { Trigger, Collector } from '@walkeros/core';\nimport { startFlow } from '@walkeros/collector';\n\ninterface CookieFirstConsent {\n  necessary?: boolean;\n  functional?: boolean;\n  performance?: boolean;\n  advertising?: boolean;\n  [category: string]: boolean | undefined;\n}\n\nconst createTrigger: Trigger.CreateFn<CookieFirstConsent, void> = async (\n  config: Collector.InitConfig,\n) => {\n  let flow: Trigger.FlowHandle | undefined;\n\n  const trigger: Trigger.Fn<CookieFirstConsent, void> =\n    () => async (content: CookieFirstConsent) => {\n      // Pre-init: set CookieFirst global (source reads this during init)\n      (window as unknown as Record<string, unknown>).CookieFirst = {\n        consent: content,\n      };\n\n      // Lazy startFlow — source reads global + registers event listeners\n      if (!flow) {\n        const result = await startFlow({ ...config, run: config.run ?? true });\n        flow = { collector: result.collector, elb: result.elb };\n      }\n\n      // Post-init: dispatch cf_init to trigger consent processing\n      window.dispatchEvent(new Event('cf_init'));\n    };\n\n  return {\n    get flow() {\n      return flow;\n    },\n    trigger,\n  };\n};\n\n/** Sets window.CookieFirst.consent before source init (legacy). */\nconst trigger = (input: unknown, env: Record<string, unknown>): void => {\n  if (!input || typeof input !== 'object') return;\n  (env.window as Record<string, unknown>).CookieFirst = { consent: input };\n};\n\nexport { createTrigger, trigger };\n","import type { Source, WalkerOS } from '@walkeros/core';\nimport type {\n  Types,\n  Settings,\n  CookieFirstConsent,\n  CookieFirstAPI,\n} from './types';\n\n// Export types for external usage\nexport * as SourceCookieFirst from './types';\n\n// Export examples\nexport * from './examples';\n\n/**\n * Default category mapping from CookieFirst to walkerOS consent groups.\n *\n * Maps CookieFirst's standard categories to walkerOS convention:\n * - necessary/functional → functional (essential)\n * - performance → analytics (measurement)\n * - advertising → marketing (ads)\n */\nexport const DEFAULT_CATEGORY_MAP: Record<string, string> = {\n  necessary: 'functional',\n  functional: 'functional',\n  performance: 'analytics',\n  advertising: 'marketing',\n};\n\n/**\n * CookieFirst consent management source for walkerOS.\n *\n * This source listens to CookieFirst CMP events and translates\n * consent states to walkerOS consent commands.\n *\n * @example\n * ```typescript\n * import { sourceCookieFirst } from '@walkeros/web-source-cmp-cookiefirst';\n *\n * await startFlow({\n *   sources: {\n *     consent: {\n *       code: sourceCookieFirst,\n *       config: {\n *         settings: {\n *           categoryMap: {\n *             performance: 'statistics', // Custom mapping\n *           },\n *         },\n *       },\n *     },\n *   },\n * });\n * ```\n */\nexport const sourceCookieFirst: Source.Init<Types> = async (context) => {\n  const { config, env } = context;\n  const { elb } = env;\n\n  // Resolve window with fallback to globalThis\n  const actualWindow =\n    env.window ??\n    (typeof globalThis.window !== 'undefined' ? globalThis.window : undefined);\n\n  // Merge user settings with defaults\n  const settings: Settings = {\n    categoryMap: { ...DEFAULT_CATEGORY_MAP, ...config?.settings?.categoryMap },\n    explicitOnly: config?.settings?.explicitOnly ?? true,\n    globalName: config?.settings?.globalName ?? 'CookieFirst',\n  };\n\n  const fullConfig: Source.Config<Types> = { settings };\n\n  // Track listener references for cleanup\n  let initListener: (() => void) | undefined;\n  let consentListener: ((e: Event) => void) | undefined;\n\n  // Only setup if in browser environment\n  if (actualWindow) {\n    /**\n     * Handle consent state from CookieFirst.\n     * Maps CookieFirst categories to walkerOS consent groups and calls elb.\n     *\n     * When multiple CookieFirst categories map to the same walkerOS group,\n     * uses OR logic: if ANY category is true, the group is true.\n     */\n    const handleConsent = (consent: CookieFirstConsent | null) => {\n      // Skip if explicitOnly and no explicit consent given\n      if (settings.explicitOnly && !consent) return;\n      if (!consent) return;\n\n      // Map CookieFirst categories to walkerOS consent groups\n      // Use OR logic: if ANY source category is true, the target group is true\n      const state: WalkerOS.Consent = {};\n      Object.entries(consent).forEach(([category, value]) => {\n        if (typeof value !== 'boolean') return;\n        const mapped = settings.categoryMap?.[category] ?? category;\n        // OR logic: once true, stays true\n        state[mapped] = state[mapped] || value;\n      });\n\n      // Only call if we have consent state to report\n      if (Object.keys(state).length > 0) {\n        elb('walker consent', state);\n      }\n    };\n\n    const globalName = settings.globalName ?? 'CookieFirst';\n    const cmp = actualWindow[globalName] as CookieFirstAPI | undefined;\n\n    // Process existing consent if CMP already loaded\n    if (cmp?.consent) {\n      handleConsent(cmp.consent);\n    }\n\n    // Listen for CMP initialization\n    initListener = () => {\n      const cmp = actualWindow[globalName] as CookieFirstAPI | undefined;\n      handleConsent(cmp?.consent ?? null);\n    };\n    actualWindow.addEventListener('cf_init', initListener);\n\n    // Listen for consent changes\n    consentListener = (e: Event) => {\n      const customEvent = e as CustomEvent<CookieFirstConsent>;\n      handleConsent(customEvent.detail);\n    };\n    actualWindow.addEventListener('cf_consent', consentListener);\n  }\n\n  return {\n    type: 'cookiefirst',\n    config: fullConfig,\n    push: elb,\n    destroy: async (_context) => {\n      // Remove event listeners on cleanup\n      if (actualWindow && initListener) {\n        actualWindow.removeEventListener('cf_init', initListener);\n      }\n      if (actualWindow && consentListener) {\n        actualWindow.removeEventListener('cf_consent', consentListener);\n      }\n    },\n  };\n};\n\nexport default sourceCookieFirst;\n"],"mappings":"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","names":["fullConsent","partialConsent","trigger","_a","_b","cmp"]}

package/dist/walkerOS.json

@@ -1,9 +1,11 @@
 {
   "$meta": {
     "package": "@walkeros/web-source-cmp-cookiefirst",
-    "version": "3.0.1",
+    "version": "3.0.2",
     "type": "source",
-    "platform": "web",
+    "platform": [
+      "web"
+    ],
     "renderer": "codebox",
     "docs": "https://www.walkeros.io/docs/sources/web/cmps/cookiefirst",
     "source": "https://github.com/elbwalker/walkerOS/tree/main/packages/web/sources/cmps/cookiefirst/src"
@@ -28,7 +30,10 @@
       "$code": "()=>()=>Promise.resolve({ok:!0})"
     },
     "createMockWindow": {
-      "$code": "(n=null)=>({CookieFirst:v(n),addEventListener:g,removeEventListener:g})"
+      "$code": "(n=null)=>({CookieFirst:v(n),addEventListener:m,removeEventListener:m})"
+    },
+    "createTrigger": {
+      "$code": "async n=>{let e;return{get flow(){return e},trigger:()=>async t=>{var r;if(window.CookieFirst={consent:t},!e){const t=await h({...n,run:null==(r=n.run)||r});e={collector:t.collector,elb:t.elb}}window.dispatchEvent(new Event(\"cf_init\"))}}}"
     },
     "fullConsent": {
       "necessary": true,
@@ -143,12 +148,12 @@
       "analytics": false,
       "marketing": false
     },
-    "setup": {
-      "$code": "(n,e)=>{n&&\"object\"==typeof n&&(e.window.CookieFirst={consent:n})}"
-    },
     "step": {
       "categoryMapOverride": {
         "description": "Custom categoryMap remaps performance to statistics instead of analytics",
+        "trigger": {
+          "type": "consent"
+        },
         "in": {
           "necessary": true,
           "functional": false,
@@ -170,6 +175,9 @@
       },
       "cfInitDetection": {
         "description": "CMP detected via cf_init CustomEvent (primary detection path)",
+        "trigger": {
+          "type": "consent"
+        },
         "in": {
           "necessary": true,
           "functional": false,
@@ -183,6 +191,9 @@
         }
       },
       "fullConsent": {
+        "trigger": {
+          "type": "consent"
+        },
         "in": {
           "necessary": true,
           "functional": true,
@@ -196,6 +207,9 @@
         }
       },
       "partialConsent": {
+        "trigger": {
+          "type": "consent"
+        },
         "in": {
           "necessary": true,
           "functional": true,
@@ -208,6 +222,9 @@
           "marketing": false
         }
       }
+    },
+    "trigger": {
+      "$code": "(n,e)=>{n&&\"object\"==typeof n&&(e.window.CookieFirst={consent:n})}"
     }
   }
 }

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "@walkeros/web-source-cmp-cookiefirst",
   "description": "CookieFirst consent management source for walkerOS",
-  "version": "3.0.2",
+  "version": "3.1.0",
   "license": "MIT",
   "walkerOS": {
     "type": "source",
-    "platform": "web",
+    "platform": [
+      "web"
+    ],
     "renderer": "codebox",
     "docs": "https://www.walkeros.io/docs/sources/web/cmps/cookiefirst"
   },
@@ -41,8 +43,8 @@
     "update": "npx npm-check-updates -u && npm update"
   },
   "dependencies": {
-    "@walkeros/core": "^3.0.2",
-    "@walkeros/collector": "^3.0.2"
+    "@walkeros/core": "^3.1.0",
+    "@walkeros/collector": "^3.1.0"
   },
   "devDependencies": {},
   "repository": {