@walkeros/web-destination-segment 4.7.2 → 4.8.0-next-1791441510508

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/types/index.ts"],"sourcesContent":["import type { WalkerOS } from '@walkeros/core';\nimport { getMappingValue, isArray, isObject, isString } from '@walkeros/core';\nimport { AnalyticsBrowser } from '@segment/analytics-next';\nimport type {\n  Destination,\n  Env,\n  RuntimeState,\n  SegmentAnalytics,\n  SegmentEventOptions,\n  SegmentSDK,\n  Settings,\n} from './types';\n\n// Types export\nexport * as DestinationSegment from './types';\n\n/**\n * Real-SDK adapter - wraps AnalyticsBrowser's static load() in our\n * SegmentSDK shape so `env?.analytics ?? realSegment` works.\n *\n * Task 1 confirmed AnalyticsBrowser.load(settings, options) returns an\n * AnalyticsBrowser instance that exposes track/identify/group/page/...\n * The returned instance buffers method calls pre-load and replays them\n * once the internal load promise resolves.\n */\nconst realSegment: SegmentSDK = {\n  load: (settings, options) =>\n    AnalyticsBrowser.load(settings, options) as unknown as SegmentAnalytics,\n};\n\nfunction getSegment(env: Env | undefined): SegmentSDK {\n  return env?.analytics ?? realSegment;\n}\n\n/**\n * Call sdk.load() with destructured Segment settings. Strips walkerOS-\n * specific keys from the options arg passed to the real SDK.\n */\nfunction loadAnalytics(sdk: SegmentSDK, settings: Settings): SegmentAnalytics {\n  const {\n    apiKey,\n    identify: _identify,\n    group: _group,\n    consent: _consent,\n    _state: _existingState,\n    ...initOptions\n  } = settings;\n\n  // Apply walkerOS defaults that differ from Segment defaults.\n  const options = {\n    initialPageview: false,\n    ...initOptions,\n  };\n\n  return sdk.load({ writeKey: apiKey }, options);\n}\n\n/**\n * Resolve the live analytics instance, loading on demand if deferred.\n * Returns undefined if load() was deferred and consent hasn't fired yet.\n */\nfunction resolveAnalytics(\n  sdk: SegmentSDK,\n  settings: Settings,\n  state: RuntimeState,\n): SegmentAnalytics | undefined {\n  if (state.analytics) return state.analytics;\n  if (state.loaded) return undefined;\n  state.analytics = loadAnalytics(sdk, settings);\n  state.loaded = true;\n  return state.analytics;\n}\n\n/**\n * Stable hash of a traits object for state-diffing. Uses a deterministic\n * JSON stringify - key order matters but is consistent within a session\n * because object literal keys come in insertion order.\n */\nfunction hashTraits(traits: Record<string, unknown> | undefined): string {\n  if (!traits) return '';\n  try {\n    return JSON.stringify(traits);\n  } catch {\n    return '';\n  }\n}\n\n/**\n * Build the Segment event options object with consent context from the\n * current walker consent state. Returns undefined unless the user has\n * explicitly opted in by configuring `settings.consent` - this keeps the\n * consent forwarding feature off-by-default so events stay clean.\n *\n * `settings.consent` maps walkerOS consent keys → Segment category names.\n * Only walker keys present in the mapping are forwarded.\n */\nfunction buildEventOptions(\n  event: WalkerOS.Event,\n  settings: Settings,\n): SegmentEventOptions | undefined {\n  const map = settings.consent;\n  if (!map || Object.keys(map).length === 0) return undefined;\n\n  const consentState = event.consent;\n  if (!isObject(consentState)) return undefined;\n\n  const categoryPreferences: Record<string, boolean> = {};\n  for (const [walkerKey, segmentKey] of Object.entries(map)) {\n    if (walkerKey in consentState) {\n      categoryPreferences[segmentKey] = consentState[walkerKey] === true;\n    }\n  }\n\n  if (Object.keys(categoryPreferences).length === 0) return undefined;\n\n  return {\n    context: {\n      consent: {\n        categoryPreferences,\n      },\n    },\n  };\n}\n\n/**\n * Resolve and apply identity mapping. Calls analytics.identify() only\n * when the resolved value differs from the last-fired identity.\n */\nfunction applyIdentify(\n  analytics: SegmentAnalytics,\n  resolved: Record<string, unknown>,\n  state: RuntimeState,\n  options?: SegmentEventOptions,\n): void {\n  const last = state.lastIdentity || {};\n  const userId = isString(resolved.userId) ? resolved.userId : undefined;\n  const anonymousId = isString(resolved.anonymousId)\n    ? resolved.anonymousId\n    : undefined;\n  const traits =\n    isObject(resolved.traits) && !isArray(resolved.traits)\n      ? (resolved.traits as Record<string, unknown>)\n      : undefined;\n\n  if (anonymousId && anonymousId !== last.anonymousId) {\n    analytics.setAnonymousId(anonymousId);\n  }\n\n  const traitsHash = hashTraits(traits);\n  const userIdChanged = userId !== last.userId;\n  const traitsChanged = traitsHash !== (last.traitsHash ?? '');\n  const hasChange = userIdChanged || (traits !== undefined && traitsChanged);\n\n  if (!hasChange && !anonymousId) return;\n\n  if (options) {\n    analytics.identify(userId, traits || {}, options);\n  } else {\n    analytics.identify(userId, traits || {});\n  }\n\n  state.lastIdentity = {\n    userId,\n    anonymousId: anonymousId ?? last.anonymousId,\n    traitsHash,\n  };\n}\n\nfunction applyGroup(\n  analytics: SegmentAnalytics,\n  resolved: Record<string, unknown>,\n  state: RuntimeState,\n  options?: SegmentEventOptions,\n): void {\n  const groupId = isString(resolved.groupId) ? resolved.groupId : undefined;\n  if (!groupId) return;\n\n  const traits =\n    isObject(resolved.traits) && !isArray(resolved.traits)\n      ? (resolved.traits as Record<string, unknown>)\n      : undefined;\n\n  const last = state.lastGroup || {};\n  const traitsHash = hashTraits(traits);\n  const groupIdChanged = groupId !== last.groupId;\n  const traitsChanged = traitsHash !== (last.traitsHash ?? '');\n  if (!groupIdChanged && !traitsChanged) return;\n\n  if (options) {\n    analytics.group(groupId, traits || {}, options);\n  } else {\n    analytics.group(groupId, traits || {});\n  }\n\n  state.lastGroup = { groupId, traitsHash };\n}\n\nasync function applyPage(\n  analytics: SegmentAnalytics,\n  pageMapping: unknown,\n  event: WalkerOS.Event,\n  collector: unknown,\n  options?: SegmentEventOptions,\n): Promise<void> {\n  // Boolean true → call page() with no args (SDK auto-collect).\n  if (pageMapping === true) {\n    if (options) {\n      analytics.page(undefined, undefined, undefined, options);\n    } else {\n      analytics.page();\n    }\n    return;\n  }\n\n  const resolved = await getMappingValue(\n    event,\n    pageMapping as Parameters<typeof getMappingValue>[1],\n    { collector } as Parameters<typeof getMappingValue>[2],\n  );\n  if (!isObject(resolved)) return;\n\n  const r = resolved as {\n    category?: unknown;\n    name?: unknown;\n    properties?: unknown;\n  };\n  const category = isString(r.category) ? r.category : undefined;\n  const name = isString(r.name) ? r.name : undefined;\n  const properties =\n    isObject(r.properties) && !isArray(r.properties)\n      ? (r.properties as Record<string, unknown>)\n      : undefined;\n\n  if (options) {\n    analytics.page(category ?? null, name ?? null, properties ?? {}, options);\n  } else if (properties !== undefined) {\n    analytics.page(category ?? null, name ?? null, properties);\n  } else if (name !== undefined || category !== undefined) {\n    analytics.page(category ?? null, name ?? null);\n  } else {\n    analytics.page();\n  }\n}\n\nexport const destinationSegment: Destination = {\n  type: 'segment',\n\n  config: {},\n\n  init({ config, env }) {\n    if (!config.settings?.apiKey) return false;\n    const settings = config.settings as Settings;\n\n    const sdk = getSegment(env as Env | undefined);\n    const _state: RuntimeState = {\n      lastIdentity: {},\n      lastGroup: {},\n      loaded: false,\n    };\n\n    // If config.consent is declared, defer load() until on('consent').\n    // Otherwise load immediately.\n    const requiresConsent =\n      !!config.consent && Object.keys(config.consent).length > 0;\n\n    if (!requiresConsent) {\n      _state.analytics = loadAnalytics(sdk, settings);\n      _state.loaded = true;\n    }\n\n    return { ...config, settings: { ...settings, _state } };\n  },\n\n  async push(event, { config, rule, env, data, collector }) {\n    const sdk = getSegment(env as Env | undefined);\n    const settings = (config.settings || {}) as Settings;\n    const state: RuntimeState = settings._state || {};\n    const analytics = resolveAnalytics(sdk, settings, state);\n    if (!analytics) return;\n\n    const mappingSettings = rule?.settings || {};\n    const options = buildEventOptions(event, settings);\n\n    // 1. Reset fires first so subsequent identity calls start clean.\n    if (mappingSettings.reset !== undefined) {\n      const resolved =\n        typeof mappingSettings.reset === 'boolean'\n          ? mappingSettings.reset\n          : await getMappingValue(event, mappingSettings.reset, { collector });\n      if (resolved) {\n        analytics.reset();\n        state.lastIdentity = {};\n        state.lastGroup = {};\n      }\n    }\n\n    // 2. Identity - rule-level override wins over destination-level.\n    const identifyMapping = mappingSettings.identify ?? settings.identify;\n    if (identifyMapping !== undefined) {\n      const resolved = await getMappingValue(event, identifyMapping, {\n        collector,\n      });\n      if (isObject(resolved)) {\n        applyIdentify(\n          analytics,\n          resolved as Record<string, unknown>,\n          state,\n          options,\n        );\n      }\n    }\n\n    // 3. Group - rule-level override wins over destination-level.\n    const groupMapping = mappingSettings.group ?? settings.group;\n    if (groupMapping !== undefined) {\n      const resolved = await getMappingValue(event, groupMapping, {\n        collector,\n      });\n      if (isObject(resolved)) {\n        applyGroup(\n          analytics,\n          resolved as Record<string, unknown>,\n          state,\n          options,\n        );\n      }\n    }\n\n    // 4. Page (explicit first-class Segment pattern)\n    if (mappingSettings.page !== undefined) {\n      await applyPage(\n        analytics,\n        mappingSettings.page,\n        event,\n        collector,\n        options,\n      );\n    }\n\n    // 5. Default track call unless rule opts out via silent.\n    if (rule?.silent !== true) {\n      const eventName = isString(rule?.name) ? rule.name : event.name;\n      const properties = isObject(data)\n        ? (data as Record<string, unknown>)\n        : {};\n\n      if (options) {\n        analytics.track(eventName, properties, options);\n      } else {\n        analytics.track(eventName, properties);\n      }\n    }\n\n    settings._state = state;\n  },\n\n  on(type, context) {\n    if (type !== 'consent' || !context.data) return;\n\n    const consent = context.data as WalkerOS.Consent;\n    const required = context.config?.consent;\n    if (!required || Object.keys(required).length === 0) return;\n\n    const settings = (context.config?.settings || {}) as Settings;\n    const state: RuntimeState = settings._state || {};\n    const sdk = getSegment(context.env as Env | undefined);\n\n    const allGranted = Object.keys(required).every(\n      (key) => consent[key] === true,\n    );\n\n    if (allGranted && !state.loaded) {\n      state.analytics = loadAnalytics(sdk, settings);\n      state.loaded = true;\n      settings._state = state;\n    }\n    // If not all granted, walkerOS's config.consent gate blocks subsequent\n    // push() calls - no SDK action needed (Segment has no opt-out method).\n  },\n};\n\nexport default destinationSegment;\n","import type {\n  Mapping as WalkerOSMapping,\n  Destination as CoreDestination,\n} from '@walkeros/core';\nimport type { DestinationWeb } from '@walkeros/web-core';\nimport type {\n  AnalyticsBrowserSettings,\n  InitOptions,\n} from '@segment/analytics-next';\n\n/**\n * Destination-level settings.\n *\n * Extends Segment's `InitOptions` (minus the `group` key which clashes with\n * walkerOS's own `group` mapping) so every passthrough option (cookie,\n * storage, integrations, plan, etc.) keeps IntelliSense intact. walkerOS\n * adds:\n *  - `apiKey` (required) — maps to `writeKey` in `AnalyticsBrowser.load()`\n *  - `identify` — destination-level identity mapping (Segment `identify()`)\n *  - `group` — destination-level group mapping (Segment `group()`)\n *  - `include` — event sections flattened into track `properties`\n *  - `consent` — walkerOS consent key → Segment category name mapping\n *  - `_state` — runtime state (not user-facing, mutated by init/push)\n */\nexport interface Settings extends Omit<InitOptions, 'group'> {\n  /** Segment write key. Maps to `writeKey` in the load() settings arg. */\n  apiKey: string;\n  /** walkerOS mapping value resolving to an identity object (userId, traits, anonymousId). */\n  identify?: WalkerOSMapping.Value;\n  /** walkerOS mapping value resolving to a group object (groupId, traits). */\n  group?: WalkerOSMapping.Value;\n  /**\n   * Mapping from walkerOS consent keys → Segment `categoryPreferences` keys.\n   * Example: { marketing: \"Advertising\", analytics: \"Analytics\" }\n   * If omitted, walkerOS keys are forwarded 1:1.\n   */\n  consent?: Record<string, string>;\n  /** Runtime state — populated by init() and mutated by push(). Not user-facing. */\n  _state?: RuntimeState;\n}\n\nexport interface RuntimeState {\n  /** Last-set identity values, used to skip redundant identify() calls. */\n  lastIdentity?: {\n    userId?: string;\n    anonymousId?: string;\n    traitsHash?: string;\n  };\n  /** Last-set group assignment, used to skip redundant group() calls. */\n  lastGroup?: {\n    groupId?: string;\n    traitsHash?: string;\n  };\n  /** Holds the AnalyticsBrowser instance created in init(). */\n  analytics?: SegmentAnalytics;\n  /** True once load() has been called (may be deferred pending consent). */\n  loaded?: boolean;\n}\n\nexport type InitSettings = Partial<Settings>;\n\n/**\n * Per-rule mapping settings. Every feature here is a walkerOS mapping\n * value resolved via getMappingValue(). The resolved object's keys drive\n * which Segment SDK methods to call.\n */\nexport interface Mapping {\n  identify?: WalkerOSMapping.Value;\n  group?: WalkerOSMapping.Value;\n  page?: WalkerOSMapping.Value | boolean;\n  reset?: WalkerOSMapping.Value | boolean;\n}\n\n/**\n * Segment SDK surface — the subset of @segment/analytics-next the\n * destination actually uses. Mirrors the AnalyticsBrowser instance shape\n * so tests can mock each method individually via env.analytics.\n */\nexport interface SegmentAnalytics {\n  track: (\n    event: string,\n    properties?: Record<string, unknown>,\n    options?: SegmentEventOptions,\n  ) => Promise<unknown> | void;\n  identify: (\n    userId?: string | Record<string, unknown>,\n    traits?: Record<string, unknown>,\n    options?: SegmentEventOptions,\n  ) => Promise<unknown> | void;\n  group: (\n    groupId: string,\n    traits?: Record<string, unknown>,\n    options?: SegmentEventOptions,\n  ) => Promise<unknown> | void;\n  page: (\n    category?: string | null,\n    name?: string | null,\n    properties?: Record<string, unknown>,\n    options?: SegmentEventOptions,\n  ) => Promise<unknown> | void;\n  alias: (\n    to: string,\n    from?: string,\n    options?: SegmentEventOptions,\n  ) => Promise<unknown> | void;\n  reset: () => Promise<unknown> | void;\n  setAnonymousId: (id: string) => Promise<unknown> | void;\n}\n\n/**\n * Segment event options — the fourth argument to track/identify/group/page\n * that carries context and integration overrides. The destination uses\n * this to stamp consent context on every event.\n */\nexport interface SegmentEventOptions {\n  context?: {\n    consent?: {\n      categoryPreferences?: Record<string, boolean>;\n    };\n    [key: string]: unknown;\n  };\n  integrations?: Record<string, boolean | Record<string, unknown>>;\n}\n\n/**\n * The module namespace used for `env?.analytics ?? realSegment`.\n * AnalyticsBrowser is the class; tests mock with a factory that returns\n * an object matching SegmentAnalytics.\n *\n * Task 1 verified: `AnalyticsBrowser.load(settings, options)` returns an\n * `AnalyticsBrowser` instance **synchronously**. The instance buffers\n * method calls until the internal load promise resolves.\n */\nexport interface SegmentSDK {\n  load: (\n    settings: AnalyticsBrowserSettings,\n    options?: InitOptions,\n  ) => SegmentAnalytics;\n}\n\n/**\n * Env — optional SDK override. Production leaves this undefined and the\n * destination falls back to the real @segment/analytics-next module.\n * Tests provide a mock via env.analytics = { ... }.\n */\nexport interface Env extends DestinationWeb.Env {\n  analytics?: SegmentSDK;\n}\n\nexport type Types = CoreDestination.Types<Settings, Mapping, Env, InitSettings>;\n\nexport type Destination = DestinationWeb.Destination<Types>;\nexport type Config = DestinationWeb.Config<Types>;\n\nexport interface SegmentDestination extends Destination {\n  env?: Env;\n}\n\nexport type Rule = WalkerOSMapping.Rule<Mapping>;\nexport type Rules = WalkerOSMapping.Rules<Rule>;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,kBAA6D;AAC7D,4BAAiC;;;ACFjC;;;ADyBA,IAAM,cAA0B;AAAA,EAC9B,MAAM,CAAC,UAAU,YACf,uCAAiB,KAAK,UAAU,OAAO;AAC3C;AAEA,SAAS,WAAW,KAAkC;AA9BtD;AA+BE,UAAO,gCAAK,cAAL,YAAkB;AAC3B;AAMA,SAAS,cAAc,KAAiB,UAAsC;AAC5E,QAAM;AAAA,IACJ;AAAA,IACA,UAAU;AAAA,IACV,OAAO;AAAA,IACP,SAAS;AAAA,IACT,QAAQ;AAAA,IACR,GAAG;AAAA,EACL,IAAI;AAGJ,QAAM,UAAU;AAAA,IACd,iBAAiB;AAAA,IACjB,GAAG;AAAA,EACL;AAEA,SAAO,IAAI,KAAK,EAAE,UAAU,OAAO,GAAG,OAAO;AAC/C;AAMA,SAAS,iBACP,KACA,UACA,OAC8B;AAC9B,MAAI,MAAM,UAAW,QAAO,MAAM;AAClC,MAAI,MAAM,OAAQ,QAAO;AACzB,QAAM,YAAY,cAAc,KAAK,QAAQ;AAC7C,QAAM,SAAS;AACf,SAAO,MAAM;AACf;AAOA,SAAS,WAAW,QAAqD;AACvE,MAAI,CAAC,OAAQ,QAAO;AACpB,MAAI;AACF,WAAO,KAAK,UAAU,MAAM;AAAA,EAC9B,SAAQ;AACN,WAAO;AAAA,EACT;AACF;AAWA,SAAS,kBACP,OACA,UACiC;AACjC,QAAM,MAAM,SAAS;AACrB,MAAI,CAAC,OAAO,OAAO,KAAK,GAAG,EAAE,WAAW,EAAG,QAAO;AAElD,QAAM,eAAe,MAAM;AAC3B,MAAI,KAAC,sBAAS,YAAY,EAAG,QAAO;AAEpC,QAAM,sBAA+C,CAAC;AACtD,aAAW,CAAC,WAAW,UAAU,KAAK,OAAO,QAAQ,GAAG,GAAG;AACzD,QAAI,aAAa,cAAc;AAC7B,0BAAoB,UAAU,IAAI,aAAa,SAAS,MAAM;AAAA,IAChE;AAAA,EACF;AAEA,MAAI,OAAO,KAAK,mBAAmB,EAAE,WAAW,EAAG,QAAO;AAE1D,SAAO;AAAA,IACL,SAAS;AAAA,MACP,SAAS;AAAA,QACP;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAMA,SAAS,cACP,WACA,UACA,OACA,SACM;AArIR;AAsIE,QAAM,OAAO,MAAM,gBAAgB,CAAC;AACpC,QAAM,aAAS,sBAAS,SAAS,MAAM,IAAI,SAAS,SAAS;AAC7D,QAAM,kBAAc,sBAAS,SAAS,WAAW,IAC7C,SAAS,cACT;AACJ,QAAM,aACJ,sBAAS,SAAS,MAAM,KAAK,KAAC,qBAAQ,SAAS,MAAM,IAChD,SAAS,SACV;AAEN,MAAI,eAAe,gBAAgB,KAAK,aAAa;AACnD,cAAU,eAAe,WAAW;AAAA,EACtC;AAEA,QAAM,aAAa,WAAW,MAAM;AACpC,QAAM,gBAAgB,WAAW,KAAK;AACtC,QAAM,gBAAgB,iBAAgB,UAAK,eAAL,YAAmB;AACzD,QAAM,YAAY,iBAAkB,WAAW,UAAa;AAE5D,MAAI,CAAC,aAAa,CAAC,YAAa;AAEhC,MAAI,SAAS;AACX,cAAU,SAAS,QAAQ,UAAU,CAAC,GAAG,OAAO;AAAA,EAClD,OAAO;AACL,cAAU,SAAS,QAAQ,UAAU,CAAC,CAAC;AAAA,EACzC;AAEA,QAAM,eAAe;AAAA,IACnB;AAAA,IACA,aAAa,oCAAe,KAAK;AAAA,IACjC;AAAA,EACF;AACF;AAEA,SAAS,WACP,WACA,UACA,OACA,SACM;AA7KR;AA8KE,QAAM,cAAU,sBAAS,SAAS,OAAO,IAAI,SAAS,UAAU;AAChE,MAAI,CAAC,QAAS;AAEd,QAAM,aACJ,sBAAS,SAAS,MAAM,KAAK,KAAC,qBAAQ,SAAS,MAAM,IAChD,SAAS,SACV;AAEN,QAAM,OAAO,MAAM,aAAa,CAAC;AACjC,QAAM,aAAa,WAAW,MAAM;AACpC,QAAM,iBAAiB,YAAY,KAAK;AACxC,QAAM,gBAAgB,iBAAgB,UAAK,eAAL,YAAmB;AACzD,MAAI,CAAC,kBAAkB,CAAC,cAAe;AAEvC,MAAI,SAAS;AACX,cAAU,MAAM,SAAS,UAAU,CAAC,GAAG,OAAO;AAAA,EAChD,OAAO;AACL,cAAU,MAAM,SAAS,UAAU,CAAC,CAAC;AAAA,EACvC;AAEA,QAAM,YAAY,EAAE,SAAS,WAAW;AAC1C;AAEA,eAAe,UACb,WACA,aACA,OACA,WACA,SACe;AAEf,MAAI,gBAAgB,MAAM;AACxB,QAAI,SAAS;AACX,gBAAU,KAAK,QAAW,QAAW,QAAW,OAAO;AAAA,IACzD,OAAO;AACL,gBAAU,KAAK;AAAA,IACjB;AACA;AAAA,EACF;AAEA,QAAM,WAAW,UAAM;AAAA,IACrB;AAAA,IACA;AAAA,IACA,EAAE,UAAU;AAAA,EACd;AACA,MAAI,KAAC,sBAAS,QAAQ,EAAG;AAEzB,QAAM,IAAI;AAKV,QAAM,eAAW,sBAAS,EAAE,QAAQ,IAAI,EAAE,WAAW;AACrD,QAAM,WAAO,sBAAS,EAAE,IAAI,IAAI,EAAE,OAAO;AACzC,QAAM,iBACJ,sBAAS,EAAE,UAAU,KAAK,KAAC,qBAAQ,EAAE,UAAU,IAC1C,EAAE,aACH;AAEN,MAAI,SAAS;AACX,cAAU,KAAK,8BAAY,MAAM,sBAAQ,MAAM,kCAAc,CAAC,GAAG,OAAO;AAAA,EAC1E,WAAW,eAAe,QAAW;AACnC,cAAU,KAAK,8BAAY,MAAM,sBAAQ,MAAM,UAAU;AAAA,EAC3D,WAAW,SAAS,UAAa,aAAa,QAAW;AACvD,cAAU,KAAK,8BAAY,MAAM,sBAAQ,IAAI;AAAA,EAC/C,OAAO;AACL,cAAU,KAAK;AAAA,EACjB;AACF;AAEO,IAAM,qBAAkC;AAAA,EAC7C,MAAM;AAAA,EAEN,QAAQ,CAAC;AAAA,EAET,KAAK,EAAE,QAAQ,IAAI,GAAG;AAzPxB;AA0PI,QAAI,GAAC,YAAO,aAAP,mBAAiB,QAAQ,QAAO;AACrC,UAAM,WAAW,OAAO;AAExB,UAAM,MAAM,WAAW,GAAsB;AAC7C,UAAM,SAAuB;AAAA,MAC3B,cAAc,CAAC;AAAA,MACf,WAAW,CAAC;AAAA,MACZ,QAAQ;AAAA,IACV;AAIA,UAAM,kBACJ,CAAC,CAAC,OAAO,WAAW,OAAO,KAAK,OAAO,OAAO,EAAE,SAAS;AAE3D,QAAI,CAAC,iBAAiB;AACpB,aAAO,YAAY,cAAc,KAAK,QAAQ;AAC9C,aAAO,SAAS;AAAA,IAClB;AAEA,WAAO,EAAE,GAAG,QAAQ,UAAU,EAAE,GAAG,UAAU,OAAO,EAAE;AAAA,EACxD;AAAA,EAEA,MAAM,KAAK,OAAO,EAAE,QAAQ,MAAM,KAAK,MAAM,UAAU,GAAG;AAjR5D;AAkRI,UAAM,MAAM,WAAW,GAAsB;AAC7C,UAAM,WAAY,OAAO,YAAY,CAAC;AACtC,UAAM,QAAsB,SAAS,UAAU,CAAC;AAChD,UAAM,YAAY,iBAAiB,KAAK,UAAU,KAAK;AACvD,QAAI,CAAC,UAAW;AAEhB,UAAM,mBAAkB,6BAAM,aAAY,CAAC;AAC3C,UAAM,UAAU,kBAAkB,OAAO,QAAQ;AAGjD,QAAI,gBAAgB,UAAU,QAAW;AACvC,YAAM,WACJ,OAAO,gBAAgB,UAAU,YAC7B,gBAAgB,QAChB,UAAM,6BAAgB,OAAO,gBAAgB,OAAO,EAAE,UAAU,CAAC;AACvE,UAAI,UAAU;AACZ,kBAAU,MAAM;AAChB,cAAM,eAAe,CAAC;AACtB,cAAM,YAAY,CAAC;AAAA,MACrB;AAAA,IACF;AAGA,UAAM,mBAAkB,qBAAgB,aAAhB,YAA4B,SAAS;AAC7D,QAAI,oBAAoB,QAAW;AACjC,YAAM,WAAW,UAAM,6BAAgB,OAAO,iBAAiB;AAAA,QAC7D;AAAA,MACF,CAAC;AACD,cAAI,sBAAS,QAAQ,GAAG;AACtB;AAAA,UACE;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAGA,UAAM,gBAAe,qBAAgB,UAAhB,YAAyB,SAAS;AACvD,QAAI,iBAAiB,QAAW;AAC9B,YAAM,WAAW,UAAM,6BAAgB,OAAO,cAAc;AAAA,QAC1D;AAAA,MACF,CAAC;AACD,cAAI,sBAAS,QAAQ,GAAG;AACtB;AAAA,UACE;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAGA,QAAI,gBAAgB,SAAS,QAAW;AACtC,YAAM;AAAA,QACJ;AAAA,QACA,gBAAgB;AAAA,QAChB;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAGA,SAAI,6BAAM,YAAW,MAAM;AACzB,YAAM,gBAAY,sBAAS,6BAAM,IAAI,IAAI,KAAK,OAAO,MAAM;AAC3D,YAAM,iBAAa,sBAAS,IAAI,IAC3B,OACD,CAAC;AAEL,UAAI,SAAS;AACX,kBAAU,MAAM,WAAW,YAAY,OAAO;AAAA,MAChD,OAAO;AACL,kBAAU,MAAM,WAAW,UAAU;AAAA,MACvC;AAAA,IACF;AAEA,aAAS,SAAS;AAAA,EACpB;AAAA,EAEA,GAAG,MAAM,SAAS;AApWpB;AAqWI,QAAI,SAAS,aAAa,CAAC,QAAQ,KAAM;AAEzC,UAAM,UAAU,QAAQ;AACxB,UAAM,YAAW,aAAQ,WAAR,mBAAgB;AACjC,QAAI,CAAC,YAAY,OAAO,KAAK,QAAQ,EAAE,WAAW,EAAG;AAErD,UAAM,aAAY,aAAQ,WAAR,mBAAgB,aAAY,CAAC;AAC/C,UAAM,QAAsB,SAAS,UAAU,CAAC;AAChD,UAAM,MAAM,WAAW,QAAQ,GAAsB;AAErD,UAAM,aAAa,OAAO,KAAK,QAAQ,EAAE;AAAA,MACvC,CAAC,QAAQ,QAAQ,GAAG,MAAM;AAAA,IAC5B;AAEA,QAAI,cAAc,CAAC,MAAM,QAAQ;AAC/B,YAAM,YAAY,cAAc,KAAK,QAAQ;AAC7C,YAAM,SAAS;AACf,eAAS,SAAS;AAAA,IACpB;AAAA,EAGF;AACF;AAEA,IAAO,gBAAQ;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/types/index.ts"],"sourcesContent":["import type { WalkerOS } from '@walkeros/core';\nimport { getMappingValue, isArray, isObject, isString } from '@walkeros/core';\nimport { AnalyticsBrowser } from '@segment/analytics-next';\nimport type {\n  Destination,\n  Env,\n  RuntimeState,\n  SegmentAnalytics,\n  SegmentEventOptions,\n  SegmentSDK,\n  Settings,\n} from './types';\n\n// Types export\nexport * as DestinationSegment from './types';\n\n/**\n * Real-SDK adapter - wraps AnalyticsBrowser's static load() in our\n * SegmentSDK shape so `env?.analytics ?? realSegment` works.\n *\n * Task 1 confirmed AnalyticsBrowser.load(settings, options) returns an\n * AnalyticsBrowser instance that exposes track/identify/group/page/...\n * The returned instance buffers method calls pre-load and replays them\n * once the internal load promise resolves.\n */\nconst realSegment: SegmentSDK = {\n  load: (settings, options) =>\n    AnalyticsBrowser.load(settings, options) as unknown as SegmentAnalytics,\n};\n\nfunction getSegment(env: Env | undefined): SegmentSDK {\n  return env?.analytics ?? realSegment;\n}\n\n/**\n * Call sdk.load() with destructured Segment settings. Strips walkerOS-\n * specific keys from the options arg passed to the real SDK.\n */\nfunction loadAnalytics(sdk: SegmentSDK, settings: Settings): SegmentAnalytics {\n  const {\n    apiKey,\n    identify: _identify,\n    group: _group,\n    consent: _consent,\n    _state: _existingState,\n    ...initOptions\n  } = settings;\n\n  // Apply walkerOS defaults that differ from Segment defaults.\n  const options = {\n    initialPageview: false,\n    ...initOptions,\n  };\n\n  return sdk.load({ writeKey: apiKey }, options);\n}\n\n/**\n * Resolve the live analytics instance, loading on demand if deferred.\n * Returns undefined if load() was deferred and consent hasn't fired yet.\n */\nfunction resolveAnalytics(\n  sdk: SegmentSDK,\n  settings: Settings,\n  state: RuntimeState,\n): SegmentAnalytics | undefined {\n  if (state.analytics) return state.analytics;\n  if (state.loaded) return undefined;\n  state.analytics = loadAnalytics(sdk, settings);\n  state.loaded = true;\n  return state.analytics;\n}\n\n/**\n * Stable hash of a traits object for state-diffing. Uses a deterministic\n * JSON stringify - key order matters but is consistent within a session\n * because object literal keys come in insertion order.\n */\nfunction hashTraits(traits: Record<string, unknown> | undefined): string {\n  if (!traits) return '';\n  try {\n    return JSON.stringify(traits);\n  } catch {\n    return '';\n  }\n}\n\n/**\n * Build the Segment event options object with consent context from the\n * current walker consent state. Returns undefined unless the user has\n * explicitly opted in by configuring `settings.consent` - this keeps the\n * consent forwarding feature off-by-default so events stay clean.\n *\n * `settings.consent` maps walkerOS consent keys → Segment category names.\n * Only walker keys present in the mapping are forwarded.\n */\nfunction buildEventOptions(\n  event: WalkerOS.Event,\n  settings: Settings,\n): SegmentEventOptions | undefined {\n  const map = settings.consent;\n  if (!map || Object.keys(map).length === 0) return undefined;\n\n  const consentState = event.consent;\n  if (!isObject(consentState)) return undefined;\n\n  const categoryPreferences: Record<string, boolean> = {};\n  for (const [walkerKey, segmentKey] of Object.entries(map)) {\n    if (walkerKey in consentState) {\n      categoryPreferences[segmentKey] = consentState[walkerKey] === true;\n    }\n  }\n\n  if (Object.keys(categoryPreferences).length === 0) return undefined;\n\n  return {\n    context: {\n      consent: {\n        categoryPreferences,\n      },\n    },\n  };\n}\n\n/**\n * Resolve and apply identity mapping. Calls analytics.identify() only\n * when the resolved value differs from the last-fired identity.\n */\nfunction applyIdentify(\n  analytics: SegmentAnalytics,\n  resolved: Record<string, unknown>,\n  state: RuntimeState,\n  options?: SegmentEventOptions,\n): void {\n  const last = state.lastIdentity || {};\n  const userId = isString(resolved.userId) ? resolved.userId : undefined;\n  const anonymousId = isString(resolved.anonymousId)\n    ? resolved.anonymousId\n    : undefined;\n  const traits =\n    isObject(resolved.traits) && !isArray(resolved.traits)\n      ? (resolved.traits as Record<string, unknown>)\n      : undefined;\n\n  if (anonymousId && anonymousId !== last.anonymousId) {\n    analytics.setAnonymousId(anonymousId);\n  }\n\n  const traitsHash = hashTraits(traits);\n  const userIdChanged = userId !== last.userId;\n  const traitsChanged = traitsHash !== (last.traitsHash ?? '');\n  const hasChange = userIdChanged || (traits !== undefined && traitsChanged);\n\n  if (!hasChange && !anonymousId) return;\n\n  if (options) {\n    analytics.identify(userId, traits || {}, options);\n  } else {\n    analytics.identify(userId, traits || {});\n  }\n\n  state.lastIdentity = {\n    userId,\n    anonymousId: anonymousId ?? last.anonymousId,\n    traitsHash,\n  };\n}\n\nfunction applyGroup(\n  analytics: SegmentAnalytics,\n  resolved: Record<string, unknown>,\n  state: RuntimeState,\n  options?: SegmentEventOptions,\n): void {\n  const groupId = isString(resolved.groupId) ? resolved.groupId : undefined;\n  if (!groupId) return;\n\n  const traits =\n    isObject(resolved.traits) && !isArray(resolved.traits)\n      ? (resolved.traits as Record<string, unknown>)\n      : undefined;\n\n  const last = state.lastGroup || {};\n  const traitsHash = hashTraits(traits);\n  const groupIdChanged = groupId !== last.groupId;\n  const traitsChanged = traitsHash !== (last.traitsHash ?? '');\n  if (!groupIdChanged && !traitsChanged) return;\n\n  if (options) {\n    analytics.group(groupId, traits || {}, options);\n  } else {\n    analytics.group(groupId, traits || {});\n  }\n\n  state.lastGroup = { groupId, traitsHash };\n}\n\nasync function applyPage(\n  analytics: SegmentAnalytics,\n  pageMapping: unknown,\n  event: WalkerOS.Event,\n  collector: unknown,\n  options?: SegmentEventOptions,\n): Promise<void> {\n  // Boolean true → call page() with no args (SDK auto-collect).\n  if (pageMapping === true) {\n    if (options) {\n      analytics.page(undefined, undefined, undefined, options);\n    } else {\n      analytics.page();\n    }\n    return;\n  }\n\n  const resolved = await getMappingValue(\n    event,\n    pageMapping as Parameters<typeof getMappingValue>[1],\n    { collector } as Parameters<typeof getMappingValue>[2],\n  );\n  if (!isObject(resolved)) return;\n\n  const r = resolved as {\n    category?: unknown;\n    name?: unknown;\n    properties?: unknown;\n  };\n  const category = isString(r.category) ? r.category : undefined;\n  const name = isString(r.name) ? r.name : undefined;\n  const properties =\n    isObject(r.properties) && !isArray(r.properties)\n      ? (r.properties as Record<string, unknown>)\n      : undefined;\n\n  if (options) {\n    analytics.page(category ?? null, name ?? null, properties ?? {}, options);\n  } else if (properties !== undefined) {\n    analytics.page(category ?? null, name ?? null, properties);\n  } else if (name !== undefined || category !== undefined) {\n    analytics.page(category ?? null, name ?? null);\n  } else {\n    analytics.page();\n  }\n}\n\nexport const destinationSegment: Destination = {\n  type: 'segment',\n\n  config: {},\n\n  init({ config, env }) {\n    if (!config.settings?.apiKey) return false;\n    const settings = config.settings as Settings;\n\n    const sdk = getSegment(env as Env | undefined);\n    const _state: RuntimeState = {\n      lastIdentity: {},\n      lastGroup: {},\n      loaded: false,\n    };\n\n    // If config.consent is declared, defer load() until on('consent').\n    // Otherwise load immediately.\n    const requiresConsent =\n      !!config.consent && Object.keys(config.consent).length > 0;\n\n    if (!requiresConsent) {\n      _state.analytics = loadAnalytics(sdk, settings);\n      _state.loaded = true;\n    }\n\n    return { ...config, settings: { ...settings, _state } };\n  },\n\n  async push(event, { config, rule, env, data, collector }) {\n    const sdk = getSegment(env as Env | undefined);\n    const settings = (config.settings || {}) as Settings;\n    const state: RuntimeState = settings._state || {};\n    const analytics = resolveAnalytics(sdk, settings, state);\n    if (!analytics) return;\n\n    const mappingSettings = rule?.settings || {};\n    const options = buildEventOptions(event, settings);\n\n    // 1. Reset fires first so subsequent identity calls start clean.\n    if (mappingSettings.reset !== undefined) {\n      const resolved =\n        typeof mappingSettings.reset === 'boolean'\n          ? mappingSettings.reset\n          : await getMappingValue(event, mappingSettings.reset, { collector });\n      if (resolved) {\n        analytics.reset();\n        state.lastIdentity = {};\n        state.lastGroup = {};\n      }\n    }\n\n    // 2. Identity - rule-level override wins over destination-level.\n    const identifyMapping = mappingSettings.identify ?? settings.identify;\n    if (identifyMapping !== undefined) {\n      const resolved = await getMappingValue(event, identifyMapping, {\n        collector,\n      });\n      if (isObject(resolved)) {\n        applyIdentify(\n          analytics,\n          resolved as Record<string, unknown>,\n          state,\n          options,\n        );\n      }\n    }\n\n    // 3. Group - rule-level override wins over destination-level.\n    const groupMapping = mappingSettings.group ?? settings.group;\n    if (groupMapping !== undefined) {\n      const resolved = await getMappingValue(event, groupMapping, {\n        collector,\n      });\n      if (isObject(resolved)) {\n        applyGroup(\n          analytics,\n          resolved as Record<string, unknown>,\n          state,\n          options,\n        );\n      }\n    }\n\n    // 4. Page (explicit first-class Segment pattern)\n    if (mappingSettings.page !== undefined) {\n      await applyPage(\n        analytics,\n        mappingSettings.page,\n        event,\n        collector,\n        options,\n      );\n    }\n\n    // 5. Default track call unless rule opts out via silent.\n    if (rule?.silent !== true) {\n      const eventName = isString(rule?.name) ? rule.name : event.name;\n      const properties = isObject(data)\n        ? (data as Record<string, unknown>)\n        : {};\n\n      if (options) {\n        analytics.track(eventName, properties, options);\n      } else {\n        analytics.track(eventName, properties);\n      }\n    }\n\n    settings._state = state;\n  },\n\n  on(type, context) {\n    if (type !== 'consent' || !context.data) return;\n\n    const consent = context.data as WalkerOS.Consent;\n    const required = context.config?.consent;\n    if (!required || Object.keys(required).length === 0) return;\n\n    const settings = (context.config?.settings || {}) as Settings;\n    const state: RuntimeState = settings._state || {};\n    const sdk = getSegment(context.env as Env | undefined);\n\n    const allGranted = Object.keys(required).every(\n      (key) => consent[key] === true,\n    );\n\n    if (allGranted && !state.loaded) {\n      state.analytics = loadAnalytics(sdk, settings);\n      state.loaded = true;\n      settings._state = state;\n    }\n    // If not all granted, walkerOS's config.consent gate blocks subsequent\n    // push() calls - no SDK action needed (Segment has no opt-out method).\n  },\n};\n\nexport default destinationSegment;\n","import type {\n  Mapping as WalkerOSMapping,\n  Destination as CoreDestination,\n} from '@walkeros/core';\nimport type { DestinationWeb } from '@walkeros/web-core';\nimport type {\n  AnalyticsBrowserSettings,\n  InitOptions,\n} from '@segment/analytics-next';\n\n/**\n * Destination-level settings.\n *\n * Extends Segment's `InitOptions` (minus the `group` key which clashes with\n * walkerOS's own `group` mapping) so every passthrough option (cookie,\n * storage, integrations, plan, etc.) keeps IntelliSense intact. walkerOS\n * adds:\n *  - `apiKey` (required): maps to `writeKey` in `AnalyticsBrowser.load()`\n *  - `identify`: destination-level identity mapping (Segment `identify()`)\n *  - `group`: destination-level group mapping (Segment `group()`)\n *  - `consent`: walkerOS consent key → Segment category name mapping\n *  - `_state`: runtime state (not user-facing, mutated by init/push)\n */\nexport interface Settings extends Omit<InitOptions, 'group'> {\n  /** Segment write key. Maps to `writeKey` in the load() settings arg. */\n  apiKey: string;\n  /** walkerOS mapping value resolving to an identity object (userId, traits, anonymousId). */\n  identify?: WalkerOSMapping.Value;\n  /** walkerOS mapping value resolving to a group object (groupId, traits). */\n  group?: WalkerOSMapping.Value;\n  /**\n   * Mapping from walkerOS consent keys → Segment `categoryPreferences` keys.\n   * Example: { marketing: \"Advertising\", analytics: \"Analytics\" }\n   * Only mapped keys are forwarded. If omitted, no consent context is sent.\n   */\n  consent?: Record<string, string>;\n  /** Runtime state: populated by init() and mutated by push(). Not user-facing. */\n  _state?: RuntimeState;\n}\n\nexport interface RuntimeState {\n  /** Last-set identity values, used to skip redundant identify() calls. */\n  lastIdentity?: {\n    userId?: string;\n    anonymousId?: string;\n    traitsHash?: string;\n  };\n  /** Last-set group assignment, used to skip redundant group() calls. */\n  lastGroup?: {\n    groupId?: string;\n    traitsHash?: string;\n  };\n  /** Holds the AnalyticsBrowser instance created in init(). */\n  analytics?: SegmentAnalytics;\n  /** True once load() has been called (may be deferred pending consent). */\n  loaded?: boolean;\n}\n\nexport type InitSettings = Partial<Settings>;\n\n/**\n * Per-rule mapping settings. Every feature here is a walkerOS mapping\n * value resolved via getMappingValue(). The resolved object's keys drive\n * which Segment SDK methods to call.\n */\nexport interface Mapping {\n  identify?: WalkerOSMapping.Value;\n  group?: WalkerOSMapping.Value;\n  page?: WalkerOSMapping.Value | boolean;\n  reset?: WalkerOSMapping.Value | boolean;\n}\n\n/**\n * Segment SDK surface: the subset of @segment/analytics-next the\n * destination actually uses. Mirrors the AnalyticsBrowser instance shape\n * so tests can mock each method individually via env.analytics.\n */\nexport interface SegmentAnalytics {\n  track: (\n    event: string,\n    properties?: Record<string, unknown>,\n    options?: SegmentEventOptions,\n  ) => Promise<unknown> | void;\n  identify: (\n    userId?: string | Record<string, unknown>,\n    traits?: Record<string, unknown>,\n    options?: SegmentEventOptions,\n  ) => Promise<unknown> | void;\n  group: (\n    groupId: string,\n    traits?: Record<string, unknown>,\n    options?: SegmentEventOptions,\n  ) => Promise<unknown> | void;\n  page: (\n    category?: string | null,\n    name?: string | null,\n    properties?: Record<string, unknown>,\n    options?: SegmentEventOptions,\n  ) => Promise<unknown> | void;\n  alias: (\n    to: string,\n    from?: string,\n    options?: SegmentEventOptions,\n  ) => Promise<unknown> | void;\n  reset: () => Promise<unknown> | void;\n  setAnonymousId: (id: string) => Promise<unknown> | void;\n}\n\n/**\n * Segment event options: the fourth argument to track/identify/group/page\n * that carries context and integration overrides. The destination uses\n * this to stamp consent context on every event.\n */\nexport interface SegmentEventOptions {\n  context?: {\n    consent?: {\n      categoryPreferences?: Record<string, boolean>;\n    };\n    [key: string]: unknown;\n  };\n  integrations?: Record<string, boolean | Record<string, unknown>>;\n}\n\n/**\n * The module namespace used for `env?.analytics ?? realSegment`.\n * AnalyticsBrowser is the class; tests mock with a factory that returns\n * an object matching SegmentAnalytics.\n *\n * Task 1 verified: `AnalyticsBrowser.load(settings, options)` returns an\n * `AnalyticsBrowser` instance **synchronously**. The instance buffers\n * method calls until the internal load promise resolves.\n */\nexport interface SegmentSDK {\n  load: (\n    settings: AnalyticsBrowserSettings,\n    options?: InitOptions,\n  ) => SegmentAnalytics;\n}\n\n/**\n * Env: optional SDK override. Production leaves this undefined and the\n * destination falls back to the real @segment/analytics-next module.\n * Tests provide a mock via env.analytics = { ... }.\n */\nexport interface Env extends DestinationWeb.Env {\n  analytics?: SegmentSDK;\n}\n\nexport type Types = CoreDestination.Types<Settings, Mapping, Env, InitSettings>;\n\nexport type Destination = DestinationWeb.Destination<Types>;\nexport type Config = DestinationWeb.Config<Types>;\n\nexport interface SegmentDestination extends Destination {\n  env?: Env;\n}\n\nexport type Rule = WalkerOSMapping.Rule<Mapping>;\nexport type Rules = WalkerOSMapping.Rules<Rule>;\n"],"mappings":"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","names":[]}

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/types/index.ts"],"sourcesContent":["import type { WalkerOS } from '@walkeros/core';\nimport { getMappingValue, isArray, isObject, isString } from '@walkeros/core';\nimport { AnalyticsBrowser } from '@segment/analytics-next';\nimport type {\n  Destination,\n  Env,\n  RuntimeState,\n  SegmentAnalytics,\n  SegmentEventOptions,\n  SegmentSDK,\n  Settings,\n} from './types';\n\n// Types export\nexport * as DestinationSegment from './types';\n\n/**\n * Real-SDK adapter - wraps AnalyticsBrowser's static load() in our\n * SegmentSDK shape so `env?.analytics ?? realSegment` works.\n *\n * Task 1 confirmed AnalyticsBrowser.load(settings, options) returns an\n * AnalyticsBrowser instance that exposes track/identify/group/page/...\n * The returned instance buffers method calls pre-load and replays them\n * once the internal load promise resolves.\n */\nconst realSegment: SegmentSDK = {\n  load: (settings, options) =>\n    AnalyticsBrowser.load(settings, options) as unknown as SegmentAnalytics,\n};\n\nfunction getSegment(env: Env | undefined): SegmentSDK {\n  return env?.analytics ?? realSegment;\n}\n\n/**\n * Call sdk.load() with destructured Segment settings. Strips walkerOS-\n * specific keys from the options arg passed to the real SDK.\n */\nfunction loadAnalytics(sdk: SegmentSDK, settings: Settings): SegmentAnalytics {\n  const {\n    apiKey,\n    identify: _identify,\n    group: _group,\n    consent: _consent,\n    _state: _existingState,\n    ...initOptions\n  } = settings;\n\n  // Apply walkerOS defaults that differ from Segment defaults.\n  const options = {\n    initialPageview: false,\n    ...initOptions,\n  };\n\n  return sdk.load({ writeKey: apiKey }, options);\n}\n\n/**\n * Resolve the live analytics instance, loading on demand if deferred.\n * Returns undefined if load() was deferred and consent hasn't fired yet.\n */\nfunction resolveAnalytics(\n  sdk: SegmentSDK,\n  settings: Settings,\n  state: RuntimeState,\n): SegmentAnalytics | undefined {\n  if (state.analytics) return state.analytics;\n  if (state.loaded) return undefined;\n  state.analytics = loadAnalytics(sdk, settings);\n  state.loaded = true;\n  return state.analytics;\n}\n\n/**\n * Stable hash of a traits object for state-diffing. Uses a deterministic\n * JSON stringify - key order matters but is consistent within a session\n * because object literal keys come in insertion order.\n */\nfunction hashTraits(traits: Record<string, unknown> | undefined): string {\n  if (!traits) return '';\n  try {\n    return JSON.stringify(traits);\n  } catch {\n    return '';\n  }\n}\n\n/**\n * Build the Segment event options object with consent context from the\n * current walker consent state. Returns undefined unless the user has\n * explicitly opted in by configuring `settings.consent` - this keeps the\n * consent forwarding feature off-by-default so events stay clean.\n *\n * `settings.consent` maps walkerOS consent keys → Segment category names.\n * Only walker keys present in the mapping are forwarded.\n */\nfunction buildEventOptions(\n  event: WalkerOS.Event,\n  settings: Settings,\n): SegmentEventOptions | undefined {\n  const map = settings.consent;\n  if (!map || Object.keys(map).length === 0) return undefined;\n\n  const consentState = event.consent;\n  if (!isObject(consentState)) return undefined;\n\n  const categoryPreferences: Record<string, boolean> = {};\n  for (const [walkerKey, segmentKey] of Object.entries(map)) {\n    if (walkerKey in consentState) {\n      categoryPreferences[segmentKey] = consentState[walkerKey] === true;\n    }\n  }\n\n  if (Object.keys(categoryPreferences).length === 0) return undefined;\n\n  return {\n    context: {\n      consent: {\n        categoryPreferences,\n      },\n    },\n  };\n}\n\n/**\n * Resolve and apply identity mapping. Calls analytics.identify() only\n * when the resolved value differs from the last-fired identity.\n */\nfunction applyIdentify(\n  analytics: SegmentAnalytics,\n  resolved: Record<string, unknown>,\n  state: RuntimeState,\n  options?: SegmentEventOptions,\n): void {\n  const last = state.lastIdentity || {};\n  const userId = isString(resolved.userId) ? resolved.userId : undefined;\n  const anonymousId = isString(resolved.anonymousId)\n    ? resolved.anonymousId\n    : undefined;\n  const traits =\n    isObject(resolved.traits) && !isArray(resolved.traits)\n      ? (resolved.traits as Record<string, unknown>)\n      : undefined;\n\n  if (anonymousId && anonymousId !== last.anonymousId) {\n    analytics.setAnonymousId(anonymousId);\n  }\n\n  const traitsHash = hashTraits(traits);\n  const userIdChanged = userId !== last.userId;\n  const traitsChanged = traitsHash !== (last.traitsHash ?? '');\n  const hasChange = userIdChanged || (traits !== undefined && traitsChanged);\n\n  if (!hasChange && !anonymousId) return;\n\n  if (options) {\n    analytics.identify(userId, traits || {}, options);\n  } else {\n    analytics.identify(userId, traits || {});\n  }\n\n  state.lastIdentity = {\n    userId,\n    anonymousId: anonymousId ?? last.anonymousId,\n    traitsHash,\n  };\n}\n\nfunction applyGroup(\n  analytics: SegmentAnalytics,\n  resolved: Record<string, unknown>,\n  state: RuntimeState,\n  options?: SegmentEventOptions,\n): void {\n  const groupId = isString(resolved.groupId) ? resolved.groupId : undefined;\n  if (!groupId) return;\n\n  const traits =\n    isObject(resolved.traits) && !isArray(resolved.traits)\n      ? (resolved.traits as Record<string, unknown>)\n      : undefined;\n\n  const last = state.lastGroup || {};\n  const traitsHash = hashTraits(traits);\n  const groupIdChanged = groupId !== last.groupId;\n  const traitsChanged = traitsHash !== (last.traitsHash ?? '');\n  if (!groupIdChanged && !traitsChanged) return;\n\n  if (options) {\n    analytics.group(groupId, traits || {}, options);\n  } else {\n    analytics.group(groupId, traits || {});\n  }\n\n  state.lastGroup = { groupId, traitsHash };\n}\n\nasync function applyPage(\n  analytics: SegmentAnalytics,\n  pageMapping: unknown,\n  event: WalkerOS.Event,\n  collector: unknown,\n  options?: SegmentEventOptions,\n): Promise<void> {\n  // Boolean true → call page() with no args (SDK auto-collect).\n  if (pageMapping === true) {\n    if (options) {\n      analytics.page(undefined, undefined, undefined, options);\n    } else {\n      analytics.page();\n    }\n    return;\n  }\n\n  const resolved = await getMappingValue(\n    event,\n    pageMapping as Parameters<typeof getMappingValue>[1],\n    { collector } as Parameters<typeof getMappingValue>[2],\n  );\n  if (!isObject(resolved)) return;\n\n  const r = resolved as {\n    category?: unknown;\n    name?: unknown;\n    properties?: unknown;\n  };\n  const category = isString(r.category) ? r.category : undefined;\n  const name = isString(r.name) ? r.name : undefined;\n  const properties =\n    isObject(r.properties) && !isArray(r.properties)\n      ? (r.properties as Record<string, unknown>)\n      : undefined;\n\n  if (options) {\n    analytics.page(category ?? null, name ?? null, properties ?? {}, options);\n  } else if (properties !== undefined) {\n    analytics.page(category ?? null, name ?? null, properties);\n  } else if (name !== undefined || category !== undefined) {\n    analytics.page(category ?? null, name ?? null);\n  } else {\n    analytics.page();\n  }\n}\n\nexport const destinationSegment: Destination = {\n  type: 'segment',\n\n  config: {},\n\n  init({ config, env }) {\n    if (!config.settings?.apiKey) return false;\n    const settings = config.settings as Settings;\n\n    const sdk = getSegment(env as Env | undefined);\n    const _state: RuntimeState = {\n      lastIdentity: {},\n      lastGroup: {},\n      loaded: false,\n    };\n\n    // If config.consent is declared, defer load() until on('consent').\n    // Otherwise load immediately.\n    const requiresConsent =\n      !!config.consent && Object.keys(config.consent).length > 0;\n\n    if (!requiresConsent) {\n      _state.analytics = loadAnalytics(sdk, settings);\n      _state.loaded = true;\n    }\n\n    return { ...config, settings: { ...settings, _state } };\n  },\n\n  async push(event, { config, rule, env, data, collector }) {\n    const sdk = getSegment(env as Env | undefined);\n    const settings = (config.settings || {}) as Settings;\n    const state: RuntimeState = settings._state || {};\n    const analytics = resolveAnalytics(sdk, settings, state);\n    if (!analytics) return;\n\n    const mappingSettings = rule?.settings || {};\n    const options = buildEventOptions(event, settings);\n\n    // 1. Reset fires first so subsequent identity calls start clean.\n    if (mappingSettings.reset !== undefined) {\n      const resolved =\n        typeof mappingSettings.reset === 'boolean'\n          ? mappingSettings.reset\n          : await getMappingValue(event, mappingSettings.reset, { collector });\n      if (resolved) {\n        analytics.reset();\n        state.lastIdentity = {};\n        state.lastGroup = {};\n      }\n    }\n\n    // 2. Identity - rule-level override wins over destination-level.\n    const identifyMapping = mappingSettings.identify ?? settings.identify;\n    if (identifyMapping !== undefined) {\n      const resolved = await getMappingValue(event, identifyMapping, {\n        collector,\n      });\n      if (isObject(resolved)) {\n        applyIdentify(\n          analytics,\n          resolved as Record<string, unknown>,\n          state,\n          options,\n        );\n      }\n    }\n\n    // 3. Group - rule-level override wins over destination-level.\n    const groupMapping = mappingSettings.group ?? settings.group;\n    if (groupMapping !== undefined) {\n      const resolved = await getMappingValue(event, groupMapping, {\n        collector,\n      });\n      if (isObject(resolved)) {\n        applyGroup(\n          analytics,\n          resolved as Record<string, unknown>,\n          state,\n          options,\n        );\n      }\n    }\n\n    // 4. Page (explicit first-class Segment pattern)\n    if (mappingSettings.page !== undefined) {\n      await applyPage(\n        analytics,\n        mappingSettings.page,\n        event,\n        collector,\n        options,\n      );\n    }\n\n    // 5. Default track call unless rule opts out via silent.\n    if (rule?.silent !== true) {\n      const eventName = isString(rule?.name) ? rule.name : event.name;\n      const properties = isObject(data)\n        ? (data as Record<string, unknown>)\n        : {};\n\n      if (options) {\n        analytics.track(eventName, properties, options);\n      } else {\n        analytics.track(eventName, properties);\n      }\n    }\n\n    settings._state = state;\n  },\n\n  on(type, context) {\n    if (type !== 'consent' || !context.data) return;\n\n    const consent = context.data as WalkerOS.Consent;\n    const required = context.config?.consent;\n    if (!required || Object.keys(required).length === 0) return;\n\n    const settings = (context.config?.settings || {}) as Settings;\n    const state: RuntimeState = settings._state || {};\n    const sdk = getSegment(context.env as Env | undefined);\n\n    const allGranted = Object.keys(required).every(\n      (key) => consent[key] === true,\n    );\n\n    if (allGranted && !state.loaded) {\n      state.analytics = loadAnalytics(sdk, settings);\n      state.loaded = true;\n      settings._state = state;\n    }\n    // If not all granted, walkerOS's config.consent gate blocks subsequent\n    // push() calls - no SDK action needed (Segment has no opt-out method).\n  },\n};\n\nexport default destinationSegment;\n","import type {\n  Mapping as WalkerOSMapping,\n  Destination as CoreDestination,\n} from '@walkeros/core';\nimport type { DestinationWeb } from '@walkeros/web-core';\nimport type {\n  AnalyticsBrowserSettings,\n  InitOptions,\n} from '@segment/analytics-next';\n\n/**\n * Destination-level settings.\n *\n * Extends Segment's `InitOptions` (minus the `group` key which clashes with\n * walkerOS's own `group` mapping) so every passthrough option (cookie,\n * storage, integrations, plan, etc.) keeps IntelliSense intact. walkerOS\n * adds:\n *  - `apiKey` (required) — maps to `writeKey` in `AnalyticsBrowser.load()`\n *  - `identify` — destination-level identity mapping (Segment `identify()`)\n *  - `group` — destination-level group mapping (Segment `group()`)\n *  - `include` — event sections flattened into track `properties`\n *  - `consent` — walkerOS consent key → Segment category name mapping\n *  - `_state` — runtime state (not user-facing, mutated by init/push)\n */\nexport interface Settings extends Omit<InitOptions, 'group'> {\n  /** Segment write key. Maps to `writeKey` in the load() settings arg. */\n  apiKey: string;\n  /** walkerOS mapping value resolving to an identity object (userId, traits, anonymousId). */\n  identify?: WalkerOSMapping.Value;\n  /** walkerOS mapping value resolving to a group object (groupId, traits). */\n  group?: WalkerOSMapping.Value;\n  /**\n   * Mapping from walkerOS consent keys → Segment `categoryPreferences` keys.\n   * Example: { marketing: \"Advertising\", analytics: \"Analytics\" }\n   * If omitted, walkerOS keys are forwarded 1:1.\n   */\n  consent?: Record<string, string>;\n  /** Runtime state — populated by init() and mutated by push(). Not user-facing. */\n  _state?: RuntimeState;\n}\n\nexport interface RuntimeState {\n  /** Last-set identity values, used to skip redundant identify() calls. */\n  lastIdentity?: {\n    userId?: string;\n    anonymousId?: string;\n    traitsHash?: string;\n  };\n  /** Last-set group assignment, used to skip redundant group() calls. */\n  lastGroup?: {\n    groupId?: string;\n    traitsHash?: string;\n  };\n  /** Holds the AnalyticsBrowser instance created in init(). */\n  analytics?: SegmentAnalytics;\n  /** True once load() has been called (may be deferred pending consent). */\n  loaded?: boolean;\n}\n\nexport type InitSettings = Partial<Settings>;\n\n/**\n * Per-rule mapping settings. Every feature here is a walkerOS mapping\n * value resolved via getMappingValue(). The resolved object's keys drive\n * which Segment SDK methods to call.\n */\nexport interface Mapping {\n  identify?: WalkerOSMapping.Value;\n  group?: WalkerOSMapping.Value;\n  page?: WalkerOSMapping.Value | boolean;\n  reset?: WalkerOSMapping.Value | boolean;\n}\n\n/**\n * Segment SDK surface — the subset of @segment/analytics-next the\n * destination actually uses. Mirrors the AnalyticsBrowser instance shape\n * so tests can mock each method individually via env.analytics.\n */\nexport interface SegmentAnalytics {\n  track: (\n    event: string,\n    properties?: Record<string, unknown>,\n    options?: SegmentEventOptions,\n  ) => Promise<unknown> | void;\n  identify: (\n    userId?: string | Record<string, unknown>,\n    traits?: Record<string, unknown>,\n    options?: SegmentEventOptions,\n  ) => Promise<unknown> | void;\n  group: (\n    groupId: string,\n    traits?: Record<string, unknown>,\n    options?: SegmentEventOptions,\n  ) => Promise<unknown> | void;\n  page: (\n    category?: string | null,\n    name?: string | null,\n    properties?: Record<string, unknown>,\n    options?: SegmentEventOptions,\n  ) => Promise<unknown> | void;\n  alias: (\n    to: string,\n    from?: string,\n    options?: SegmentEventOptions,\n  ) => Promise<unknown> | void;\n  reset: () => Promise<unknown> | void;\n  setAnonymousId: (id: string) => Promise<unknown> | void;\n}\n\n/**\n * Segment event options — the fourth argument to track/identify/group/page\n * that carries context and integration overrides. The destination uses\n * this to stamp consent context on every event.\n */\nexport interface SegmentEventOptions {\n  context?: {\n    consent?: {\n      categoryPreferences?: Record<string, boolean>;\n    };\n    [key: string]: unknown;\n  };\n  integrations?: Record<string, boolean | Record<string, unknown>>;\n}\n\n/**\n * The module namespace used for `env?.analytics ?? realSegment`.\n * AnalyticsBrowser is the class; tests mock with a factory that returns\n * an object matching SegmentAnalytics.\n *\n * Task 1 verified: `AnalyticsBrowser.load(settings, options)` returns an\n * `AnalyticsBrowser` instance **synchronously**. The instance buffers\n * method calls until the internal load promise resolves.\n */\nexport interface SegmentSDK {\n  load: (\n    settings: AnalyticsBrowserSettings,\n    options?: InitOptions,\n  ) => SegmentAnalytics;\n}\n\n/**\n * Env — optional SDK override. Production leaves this undefined and the\n * destination falls back to the real @segment/analytics-next module.\n * Tests provide a mock via env.analytics = { ... }.\n */\nexport interface Env extends DestinationWeb.Env {\n  analytics?: SegmentSDK;\n}\n\nexport type Types = CoreDestination.Types<Settings, Mapping, Env, InitSettings>;\n\nexport type Destination = DestinationWeb.Destination<Types>;\nexport type Config = DestinationWeb.Config<Types>;\n\nexport interface SegmentDestination extends Destination {\n  env?: Env;\n}\n\nexport type Rule = WalkerOSMapping.Rule<Mapping>;\nexport type Rules = WalkerOSMapping.Rules<Rule>;\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/types/index.ts"],"sourcesContent":["import type { WalkerOS } from '@walkeros/core';\nimport { getMappingValue, isArray, isObject, isString } from '@walkeros/core';\nimport { AnalyticsBrowser } from '@segment/analytics-next';\nimport type {\n  Destination,\n  Env,\n  RuntimeState,\n  SegmentAnalytics,\n  SegmentEventOptions,\n  SegmentSDK,\n  Settings,\n} from './types';\n\n// Types export\nexport * as DestinationSegment from './types';\n\n/**\n * Real-SDK adapter - wraps AnalyticsBrowser's static load() in our\n * SegmentSDK shape so `env?.analytics ?? realSegment` works.\n *\n * Task 1 confirmed AnalyticsBrowser.load(settings, options) returns an\n * AnalyticsBrowser instance that exposes track/identify/group/page/...\n * The returned instance buffers method calls pre-load and replays them\n * once the internal load promise resolves.\n */\nconst realSegment: SegmentSDK = {\n  load: (settings, options) =>\n    AnalyticsBrowser.load(settings, options) as unknown as SegmentAnalytics,\n};\n\nfunction getSegment(env: Env | undefined): SegmentSDK {\n  return env?.analytics ?? realSegment;\n}\n\n/**\n * Call sdk.load() with destructured Segment settings. Strips walkerOS-\n * specific keys from the options arg passed to the real SDK.\n */\nfunction loadAnalytics(sdk: SegmentSDK, settings: Settings): SegmentAnalytics {\n  const {\n    apiKey,\n    identify: _identify,\n    group: _group,\n    consent: _consent,\n    _state: _existingState,\n    ...initOptions\n  } = settings;\n\n  // Apply walkerOS defaults that differ from Segment defaults.\n  const options = {\n    initialPageview: false,\n    ...initOptions,\n  };\n\n  return sdk.load({ writeKey: apiKey }, options);\n}\n\n/**\n * Resolve the live analytics instance, loading on demand if deferred.\n * Returns undefined if load() was deferred and consent hasn't fired yet.\n */\nfunction resolveAnalytics(\n  sdk: SegmentSDK,\n  settings: Settings,\n  state: RuntimeState,\n): SegmentAnalytics | undefined {\n  if (state.analytics) return state.analytics;\n  if (state.loaded) return undefined;\n  state.analytics = loadAnalytics(sdk, settings);\n  state.loaded = true;\n  return state.analytics;\n}\n\n/**\n * Stable hash of a traits object for state-diffing. Uses a deterministic\n * JSON stringify - key order matters but is consistent within a session\n * because object literal keys come in insertion order.\n */\nfunction hashTraits(traits: Record<string, unknown> | undefined): string {\n  if (!traits) return '';\n  try {\n    return JSON.stringify(traits);\n  } catch {\n    return '';\n  }\n}\n\n/**\n * Build the Segment event options object with consent context from the\n * current walker consent state. Returns undefined unless the user has\n * explicitly opted in by configuring `settings.consent` - this keeps the\n * consent forwarding feature off-by-default so events stay clean.\n *\n * `settings.consent` maps walkerOS consent keys → Segment category names.\n * Only walker keys present in the mapping are forwarded.\n */\nfunction buildEventOptions(\n  event: WalkerOS.Event,\n  settings: Settings,\n): SegmentEventOptions | undefined {\n  const map = settings.consent;\n  if (!map || Object.keys(map).length === 0) return undefined;\n\n  const consentState = event.consent;\n  if (!isObject(consentState)) return undefined;\n\n  const categoryPreferences: Record<string, boolean> = {};\n  for (const [walkerKey, segmentKey] of Object.entries(map)) {\n    if (walkerKey in consentState) {\n      categoryPreferences[segmentKey] = consentState[walkerKey] === true;\n    }\n  }\n\n  if (Object.keys(categoryPreferences).length === 0) return undefined;\n\n  return {\n    context: {\n      consent: {\n        categoryPreferences,\n      },\n    },\n  };\n}\n\n/**\n * Resolve and apply identity mapping. Calls analytics.identify() only\n * when the resolved value differs from the last-fired identity.\n */\nfunction applyIdentify(\n  analytics: SegmentAnalytics,\n  resolved: Record<string, unknown>,\n  state: RuntimeState,\n  options?: SegmentEventOptions,\n): void {\n  const last = state.lastIdentity || {};\n  const userId = isString(resolved.userId) ? resolved.userId : undefined;\n  const anonymousId = isString(resolved.anonymousId)\n    ? resolved.anonymousId\n    : undefined;\n  const traits =\n    isObject(resolved.traits) && !isArray(resolved.traits)\n      ? (resolved.traits as Record<string, unknown>)\n      : undefined;\n\n  if (anonymousId && anonymousId !== last.anonymousId) {\n    analytics.setAnonymousId(anonymousId);\n  }\n\n  const traitsHash = hashTraits(traits);\n  const userIdChanged = userId !== last.userId;\n  const traitsChanged = traitsHash !== (last.traitsHash ?? '');\n  const hasChange = userIdChanged || (traits !== undefined && traitsChanged);\n\n  if (!hasChange && !anonymousId) return;\n\n  if (options) {\n    analytics.identify(userId, traits || {}, options);\n  } else {\n    analytics.identify(userId, traits || {});\n  }\n\n  state.lastIdentity = {\n    userId,\n    anonymousId: anonymousId ?? last.anonymousId,\n    traitsHash,\n  };\n}\n\nfunction applyGroup(\n  analytics: SegmentAnalytics,\n  resolved: Record<string, unknown>,\n  state: RuntimeState,\n  options?: SegmentEventOptions,\n): void {\n  const groupId = isString(resolved.groupId) ? resolved.groupId : undefined;\n  if (!groupId) return;\n\n  const traits =\n    isObject(resolved.traits) && !isArray(resolved.traits)\n      ? (resolved.traits as Record<string, unknown>)\n      : undefined;\n\n  const last = state.lastGroup || {};\n  const traitsHash = hashTraits(traits);\n  const groupIdChanged = groupId !== last.groupId;\n  const traitsChanged = traitsHash !== (last.traitsHash ?? '');\n  if (!groupIdChanged && !traitsChanged) return;\n\n  if (options) {\n    analytics.group(groupId, traits || {}, options);\n  } else {\n    analytics.group(groupId, traits || {});\n  }\n\n  state.lastGroup = { groupId, traitsHash };\n}\n\nasync function applyPage(\n  analytics: SegmentAnalytics,\n  pageMapping: unknown,\n  event: WalkerOS.Event,\n  collector: unknown,\n  options?: SegmentEventOptions,\n): Promise<void> {\n  // Boolean true → call page() with no args (SDK auto-collect).\n  if (pageMapping === true) {\n    if (options) {\n      analytics.page(undefined, undefined, undefined, options);\n    } else {\n      analytics.page();\n    }\n    return;\n  }\n\n  const resolved = await getMappingValue(\n    event,\n    pageMapping as Parameters<typeof getMappingValue>[1],\n    { collector } as Parameters<typeof getMappingValue>[2],\n  );\n  if (!isObject(resolved)) return;\n\n  const r = resolved as {\n    category?: unknown;\n    name?: unknown;\n    properties?: unknown;\n  };\n  const category = isString(r.category) ? r.category : undefined;\n  const name = isString(r.name) ? r.name : undefined;\n  const properties =\n    isObject(r.properties) && !isArray(r.properties)\n      ? (r.properties as Record<string, unknown>)\n      : undefined;\n\n  if (options) {\n    analytics.page(category ?? null, name ?? null, properties ?? {}, options);\n  } else if (properties !== undefined) {\n    analytics.page(category ?? null, name ?? null, properties);\n  } else if (name !== undefined || category !== undefined) {\n    analytics.page(category ?? null, name ?? null);\n  } else {\n    analytics.page();\n  }\n}\n\nexport const destinationSegment: Destination = {\n  type: 'segment',\n\n  config: {},\n\n  init({ config, env }) {\n    if (!config.settings?.apiKey) return false;\n    const settings = config.settings as Settings;\n\n    const sdk = getSegment(env as Env | undefined);\n    const _state: RuntimeState = {\n      lastIdentity: {},\n      lastGroup: {},\n      loaded: false,\n    };\n\n    // If config.consent is declared, defer load() until on('consent').\n    // Otherwise load immediately.\n    const requiresConsent =\n      !!config.consent && Object.keys(config.consent).length > 0;\n\n    if (!requiresConsent) {\n      _state.analytics = loadAnalytics(sdk, settings);\n      _state.loaded = true;\n    }\n\n    return { ...config, settings: { ...settings, _state } };\n  },\n\n  async push(event, { config, rule, env, data, collector }) {\n    const sdk = getSegment(env as Env | undefined);\n    const settings = (config.settings || {}) as Settings;\n    const state: RuntimeState = settings._state || {};\n    const analytics = resolveAnalytics(sdk, settings, state);\n    if (!analytics) return;\n\n    const mappingSettings = rule?.settings || {};\n    const options = buildEventOptions(event, settings);\n\n    // 1. Reset fires first so subsequent identity calls start clean.\n    if (mappingSettings.reset !== undefined) {\n      const resolved =\n        typeof mappingSettings.reset === 'boolean'\n          ? mappingSettings.reset\n          : await getMappingValue(event, mappingSettings.reset, { collector });\n      if (resolved) {\n        analytics.reset();\n        state.lastIdentity = {};\n        state.lastGroup = {};\n      }\n    }\n\n    // 2. Identity - rule-level override wins over destination-level.\n    const identifyMapping = mappingSettings.identify ?? settings.identify;\n    if (identifyMapping !== undefined) {\n      const resolved = await getMappingValue(event, identifyMapping, {\n        collector,\n      });\n      if (isObject(resolved)) {\n        applyIdentify(\n          analytics,\n          resolved as Record<string, unknown>,\n          state,\n          options,\n        );\n      }\n    }\n\n    // 3. Group - rule-level override wins over destination-level.\n    const groupMapping = mappingSettings.group ?? settings.group;\n    if (groupMapping !== undefined) {\n      const resolved = await getMappingValue(event, groupMapping, {\n        collector,\n      });\n      if (isObject(resolved)) {\n        applyGroup(\n          analytics,\n          resolved as Record<string, unknown>,\n          state,\n          options,\n        );\n      }\n    }\n\n    // 4. Page (explicit first-class Segment pattern)\n    if (mappingSettings.page !== undefined) {\n      await applyPage(\n        analytics,\n        mappingSettings.page,\n        event,\n        collector,\n        options,\n      );\n    }\n\n    // 5. Default track call unless rule opts out via silent.\n    if (rule?.silent !== true) {\n      const eventName = isString(rule?.name) ? rule.name : event.name;\n      const properties = isObject(data)\n        ? (data as Record<string, unknown>)\n        : {};\n\n      if (options) {\n        analytics.track(eventName, properties, options);\n      } else {\n        analytics.track(eventName, properties);\n      }\n    }\n\n    settings._state = state;\n  },\n\n  on(type, context) {\n    if (type !== 'consent' || !context.data) return;\n\n    const consent = context.data as WalkerOS.Consent;\n    const required = context.config?.consent;\n    if (!required || Object.keys(required).length === 0) return;\n\n    const settings = (context.config?.settings || {}) as Settings;\n    const state: RuntimeState = settings._state || {};\n    const sdk = getSegment(context.env as Env | undefined);\n\n    const allGranted = Object.keys(required).every(\n      (key) => consent[key] === true,\n    );\n\n    if (allGranted && !state.loaded) {\n      state.analytics = loadAnalytics(sdk, settings);\n      state.loaded = true;\n      settings._state = state;\n    }\n    // If not all granted, walkerOS's config.consent gate blocks subsequent\n    // push() calls - no SDK action needed (Segment has no opt-out method).\n  },\n};\n\nexport default destinationSegment;\n","import type {\n  Mapping as WalkerOSMapping,\n  Destination as CoreDestination,\n} from '@walkeros/core';\nimport type { DestinationWeb } from '@walkeros/web-core';\nimport type {\n  AnalyticsBrowserSettings,\n  InitOptions,\n} from '@segment/analytics-next';\n\n/**\n * Destination-level settings.\n *\n * Extends Segment's `InitOptions` (minus the `group` key which clashes with\n * walkerOS's own `group` mapping) so every passthrough option (cookie,\n * storage, integrations, plan, etc.) keeps IntelliSense intact. walkerOS\n * adds:\n *  - `apiKey` (required): maps to `writeKey` in `AnalyticsBrowser.load()`\n *  - `identify`: destination-level identity mapping (Segment `identify()`)\n *  - `group`: destination-level group mapping (Segment `group()`)\n *  - `consent`: walkerOS consent key → Segment category name mapping\n *  - `_state`: runtime state (not user-facing, mutated by init/push)\n */\nexport interface Settings extends Omit<InitOptions, 'group'> {\n  /** Segment write key. Maps to `writeKey` in the load() settings arg. */\n  apiKey: string;\n  /** walkerOS mapping value resolving to an identity object (userId, traits, anonymousId). */\n  identify?: WalkerOSMapping.Value;\n  /** walkerOS mapping value resolving to a group object (groupId, traits). */\n  group?: WalkerOSMapping.Value;\n  /**\n   * Mapping from walkerOS consent keys → Segment `categoryPreferences` keys.\n   * Example: { marketing: \"Advertising\", analytics: \"Analytics\" }\n   * Only mapped keys are forwarded. If omitted, no consent context is sent.\n   */\n  consent?: Record<string, string>;\n  /** Runtime state: populated by init() and mutated by push(). Not user-facing. */\n  _state?: RuntimeState;\n}\n\nexport interface RuntimeState {\n  /** Last-set identity values, used to skip redundant identify() calls. */\n  lastIdentity?: {\n    userId?: string;\n    anonymousId?: string;\n    traitsHash?: string;\n  };\n  /** Last-set group assignment, used to skip redundant group() calls. */\n  lastGroup?: {\n    groupId?: string;\n    traitsHash?: string;\n  };\n  /** Holds the AnalyticsBrowser instance created in init(). */\n  analytics?: SegmentAnalytics;\n  /** True once load() has been called (may be deferred pending consent). */\n  loaded?: boolean;\n}\n\nexport type InitSettings = Partial<Settings>;\n\n/**\n * Per-rule mapping settings. Every feature here is a walkerOS mapping\n * value resolved via getMappingValue(). The resolved object's keys drive\n * which Segment SDK methods to call.\n */\nexport interface Mapping {\n  identify?: WalkerOSMapping.Value;\n  group?: WalkerOSMapping.Value;\n  page?: WalkerOSMapping.Value | boolean;\n  reset?: WalkerOSMapping.Value | boolean;\n}\n\n/**\n * Segment SDK surface: the subset of @segment/analytics-next the\n * destination actually uses. Mirrors the AnalyticsBrowser instance shape\n * so tests can mock each method individually via env.analytics.\n */\nexport interface SegmentAnalytics {\n  track: (\n    event: string,\n    properties?: Record<string, unknown>,\n    options?: SegmentEventOptions,\n  ) => Promise<unknown> | void;\n  identify: (\n    userId?: string | Record<string, unknown>,\n    traits?: Record<string, unknown>,\n    options?: SegmentEventOptions,\n  ) => Promise<unknown> | void;\n  group: (\n    groupId: string,\n    traits?: Record<string, unknown>,\n    options?: SegmentEventOptions,\n  ) => Promise<unknown> | void;\n  page: (\n    category?: string | null,\n    name?: string | null,\n    properties?: Record<string, unknown>,\n    options?: SegmentEventOptions,\n  ) => Promise<unknown> | void;\n  alias: (\n    to: string,\n    from?: string,\n    options?: SegmentEventOptions,\n  ) => Promise<unknown> | void;\n  reset: () => Promise<unknown> | void;\n  setAnonymousId: (id: string) => Promise<unknown> | void;\n}\n\n/**\n * Segment event options: the fourth argument to track/identify/group/page\n * that carries context and integration overrides. The destination uses\n * this to stamp consent context on every event.\n */\nexport interface SegmentEventOptions {\n  context?: {\n    consent?: {\n      categoryPreferences?: Record<string, boolean>;\n    };\n    [key: string]: unknown;\n  };\n  integrations?: Record<string, boolean | Record<string, unknown>>;\n}\n\n/**\n * The module namespace used for `env?.analytics ?? realSegment`.\n * AnalyticsBrowser is the class; tests mock with a factory that returns\n * an object matching SegmentAnalytics.\n *\n * Task 1 verified: `AnalyticsBrowser.load(settings, options)` returns an\n * `AnalyticsBrowser` instance **synchronously**. The instance buffers\n * method calls until the internal load promise resolves.\n */\nexport interface SegmentSDK {\n  load: (\n    settings: AnalyticsBrowserSettings,\n    options?: InitOptions,\n  ) => SegmentAnalytics;\n}\n\n/**\n * Env: optional SDK override. Production leaves this undefined and the\n * destination falls back to the real @segment/analytics-next module.\n * Tests provide a mock via env.analytics = { ... }.\n */\nexport interface Env extends DestinationWeb.Env {\n  analytics?: SegmentSDK;\n}\n\nexport type Types = CoreDestination.Types<Settings, Mapping, Env, InitSettings>;\n\nexport type Destination = DestinationWeb.Destination<Types>;\nexport type Config = DestinationWeb.Config<Types>;\n\nexport interface SegmentDestination extends Destination {\n  env?: Env;\n}\n\nexport type Rule = WalkerOSMapping.Rule<Mapping>;\nexport type Rules = WalkerOSMapping.Rules<Rule>;\n"],"mappings":"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","names":[]}

package/dist/walkerOS.json

@@ -1,7 +1,7 @@
 {
   "$meta": {
     "package": "@walkeros/web-destination-segment",
-    "version": "4.7.2",
+    "version": "4.8.0-next-1791441510508",
     "type": "destination",
     "platform": [
       "web"
@@ -41,11 +41,11 @@
         },
         "cdnURL": {
           "type": "string",
-          "description": "Override the CDN URL used for settings fetch. Default: https://cdn.segment.com. Useful for self-hosted Segment proxies."
+          "description": "Not applied: the destination passes it in the load() options, where Analytics.js does not read it, so settings are always fetched from https://cdn.segment.com."
         },
         "initialPageview": {
           "type": "boolean",
-          "description": "When true, the SDK fires an automatic initial page() call on load. Default: false — walkerOS sources handle page tracking, so this is disabled to avoid duplicate page views."
+          "description": "When true, the SDK fires an automatic initial page() call on load. Default: false (walkerOS sources handle page tracking, so this is disabled to avoid duplicate page views)."
         },
         "disableClientPersistence": {
           "type": "boolean",
@@ -72,7 +72,7 @@
           "description": "Enable/disable downstream Segment destinations. Example: { \"All\": true, \"Mixpanel\": false }."
         },
         "identify": {
-          "description": "Destination-level identity mapping. Resolves to an object with any of: userId, traits, anonymousId. Fires on the first push and re-fires when the resolved value changes."
+          "description": "Destination-level identity mapping. Resolves to an object with any of: userId, traits, anonymousId. Resolved on every push: analytics.identify fires on the first push and when userId or traits change, and on every push while anonymousId is set."
         },
         "group": {
           "description": "Destination-level group mapping. Resolves to an object with: groupId, traits. Fires on the first push and re-fires on change."
@@ -85,7 +85,7 @@
           "additionalProperties": {
             "type": "string"
           },
-          "description": "Mapping from walkerOS consent keys → Segment `categoryPreferences` keys. Example: { \"marketing\": \"Advertising\", \"analytics\": \"Analytics\" }. When omitted, walkerOS keys are forwarded 1:1 to Segment."
+          "description": "Mapping from walkerOS consent keys → Segment `categoryPreferences` keys. Example: { \"marketing\": \"Advertising\", \"analytics\": \"Analytics\" }. Only mapped keys are forwarded; when omitted, no consent context is sent."
         }
       },
       "required": [
@@ -162,7 +162,7 @@
           "consent": {
             "functional": true
           },
-          "id": "cf9c67d4cae4c237",
+          "id": "faaf22436bb0122a",
           "trigger": "test",
           "entity": "company",
           "action": "update",
@@ -208,7 +208,7 @@
       },
       "consentContextForwarded": {
         "title": "Consent context",
-        "description": "Walker consent is stamped on every Segment call via context.consent.categoryPreferences for downstream filtering.",
+        "description": "With settings.consent mapping analytics to Analytics and marketing to Advertising, the event consent is stamped on every Segment call via context.consent.categoryPreferences for downstream filtering.",
         "in": {
           "name": "product view",
           "data": {
@@ -240,7 +240,7 @@
             "analytics": true,
             "marketing": true
           },
-          "id": "88d5e01a8873800b",
+          "id": "f2d033cf93d5c0bd",
           "trigger": "load",
           "entity": "product",
           "action": "view",
@@ -277,9 +277,63 @@
           ]
         ]
       },
+      "consentContextOmitted": {
+        "public": false,
+        "in": {
+          "name": "product view",
+          "data": {
+            "id": "ers",
+            "name": "Everyday Ruck Snack",
+            "color": "black",
+            "size": "l",
+            "price": 420
+          },
+          "context": {
+            "shopping": [
+              "detail",
+              0
+            ]
+          },
+          "globals": {
+            "pagegroup": "shop"
+          },
+          "custom": {
+            "completely": "random"
+          },
+          "user": {
+            "id": "us3r",
+            "device": "c00k13",
+            "session": "s3ss10n"
+          },
+          "nested": [],
+          "consent": {
+            "analytics": true,
+            "marketing": false
+          },
+          "id": "d0faad707fa9fa38",
+          "trigger": "load",
+          "entity": "product",
+          "action": "view",
+          "timestamp": 1700000113000,
+          "timing": 3.14,
+          "source": {
+            "count": 1,
+            "trace": "0a1b2c3d4e5f60718293a4b5c6d7e8f9",
+            "type": "collector",
+            "schema": "4"
+          }
+        },
+        "out": [
+          [
+            "analytics.track",
+            "product view",
+            {}
+          ]
+        ]
+      },
       "consentGrantDeferredLoad": {
         "title": "Consent deferred load",
-        "description": "A walker consent grant triggers the deferred Segment analytics.load with the configured writeKey.",
+        "description": "With consent: { analytics: true } in the destination config, a walker consent grant triggers the deferred Segment analytics.load with the configured writeKey.",
         "command": "consent",
         "in": {
           "analytics": true
@@ -337,7 +391,7 @@
           "consent": {
             "functional": true
           },
-          "id": "0a2893c66541c74b",
+          "id": "5d677b7e2f5a6369",
           "trigger": "load",
           "entity": "product",
           "action": "view",
@@ -360,7 +414,7 @@
       },
       "destinationLevelIdentify": {
         "title": "Destination identify",
-        "description": "Destination-level identify calls analytics.identify with the resolved userId before firing the default track.",
+        "description": "With settings.identify mapping userId to 'user.id', the destination calls analytics.identify before the default track.",
         "in": {
           "name": "page view",
           "data": {
@@ -399,7 +453,7 @@
           "consent": {
             "functional": true
           },
-          "id": "084486cb752efd30",
+          "id": "539191ad5bece714",
           "trigger": "load",
           "entity": "page",
           "action": "view",
@@ -434,7 +488,7 @@
       },
       "destinationLevelInclude": {
         "title": "Include data",
-        "description": "Destination-level include flattens the event data section into prefixed Segment track properties.",
+        "description": "With include: ['data'] in the destination config, the event data section is flattened into prefixed Segment track properties.",
         "in": {
           "name": "product view",
           "data": {
@@ -465,7 +519,7 @@
           "consent": {
             "functional": true
           },
-          "id": "e5698d94805a2a2f",
+          "id": "9fb483eedd199468",
           "trigger": "load",
           "entity": "product",
           "action": "view",
@@ -595,7 +649,7 @@
           "consent": {
             "functional": true
           },
-          "id": "e8fb0fd70115c36c",
+          "id": "ace963525353e615",
           "trigger": "load",
           "entity": "order",
           "action": "complete",
@@ -714,7 +768,7 @@
           "consent": {
             "functional": true
           },
-          "id": "6ce9d3d39498dcd8",
+          "id": "505e6669f12162b4",
           "trigger": "load",
           "entity": "page",
           "action": "view",
@@ -756,7 +810,7 @@
       },
       "pageViewMinimal": {
         "title": "Page view minimal",
-        "description": "A mapping with page: true fires an empty analytics.page call relying on Segments auto-collection.",
+        "description": "A mapping with page: true fires an empty analytics.page call relying on Segment's auto-collection.",
         "in": {
           "name": "page view",
           "data": {
@@ -795,7 +849,7 @@
           "consent": {
             "functional": true
           },
-          "id": "e11d17d6487a086a",
+          "id": "9b82f9523dad2aff",
           "trigger": "load",
           "entity": "page",
           "action": "view",
@@ -858,7 +912,7 @@
           "consent": {
             "functional": true
           },
-          "id": "b238cbc92bcb9766",
+          "id": "3d74b8e6a352d27d",
           "trigger": "test",
           "entity": "profile",
           "action": "update",
@@ -901,7 +955,7 @@
       },
       "ruleIncludeReplaces": {
         "title": "Rule include overrides",
-        "description": "A per-rule include replaces the destination-level include so this event forwards only globals.",
+        "description": "With include: ['data'] in the destination config, the rule's include: ['globals'] replaces it, so this event forwards only globals.",
         "in": {
           "name": "order complete",
           "data": {
@@ -979,7 +1033,7 @@
           "consent": {
             "functional": true
           },
-          "id": "f5d0f0ebeafe1301",
+          "id": "6f83f93c2785edef",
           "trigger": "load",
           "entity": "order",
           "action": "complete",
@@ -1051,7 +1105,7 @@
           "consent": {
             "functional": true
           },
-          "id": "cedf64c39ea7dfea",
+          "id": "1674200bc045497b",
           "trigger": "test",
           "entity": "user",
           "action": "login",
@@ -1146,7 +1200,7 @@
           "consent": {
             "functional": true
           },
-          "id": "3f981956aa141b42",
+          "id": "1e3f1a26bbe402b5",
           "trigger": "test",
           "entity": "user",
           "action": "logout",
@@ -1213,7 +1267,7 @@
           "consent": {
             "functional": true
           },
-          "id": "6e3c7771e27f84bc",
+          "id": "31169705eeeeefcb",
           "trigger": "test",
           "entity": "debug",
           "action": "noise",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@walkeros/web-destination-segment",
   "description": "Segment CDP web destination for walkerOS (@segment/analytics-next, full Segment Spec)",
-  "version": "4.7.2",
+  "version": "4.8.0-next-1791441510508",
   "license": "MIT",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -39,11 +39,11 @@
   },
   "dependencies": {
     "@segment/analytics-next": "^1.82.0",
-    "@walkeros/core": "4.7.2",
-    "@walkeros/web-core": "4.7.2"
+    "@walkeros/core": "4.8.0-next-1791441510508",
+    "@walkeros/web-core": "4.8.0-next-1791441510508"
   },
   "devDependencies": {
-    "@walkeros/collector": "4.7.2"
+    "@walkeros/collector": "4.8.0-next-1791441510508"
   },
   "repository": {
     "url": "git+https://github.com/elbwalker/walkerOS.git",