@sygnl/mapper 1.0.0

package/README.md

@@ -0,0 +1,130 @@
+# @sygnl/mapper
+
+Declarative event mapper for transforming events between different ad platform formats.
+
+## Install
+
+```bash
+npm install @sygnl/mapper
+```
+
+## Quick Start
+
+```typescript
+import { EventMapper, transforms } from '@sygnl/mapper';
+
+const mapper = new EventMapper({
+  eventNames: [
+    { from: 'purchase', to: 'Purchase' }
+  ],
+  fields: [
+    { from: 'user.email', to: 'userData.em' },
+    { from: 'timestamp', to: 'event_time', transform: transforms.msToSeconds }
+  ],
+  static: [
+    { to: 'action_source', value: 'website' }
+  ]
+});
+
+const result = mapper.map(sourceEvent);
+```
+
+## Use Cases
+
+- Map events to Meta CAPI format
+- Transform for Google Enhanced Conversions
+- Adapt to Snapchat/TikTok/Bing APIs
+- Build platform-agnostic event pipelines
+- Define mappings once, reuse everywhere
+
+## API
+
+### `EventMapper`
+
+```typescript
+const mapper = new EventMapper({
+  eventNames?: EventNameMapping[],
+  fields?: FieldMapping[],
+  static?: StaticField[],
+  sourceRoot?: string,
+  targetRoot?: string
+});
+
+const result = mapper.map(source);
+const results = mapper.mapBatch(sources);
+```
+
+### Field Mapping
+
+```typescript
+{
+  from: 'source.path' | ['path1', 'path2'],  // Fallback sources
+  to: 'target.path',
+  transform?: (value, source) => any,
+  condition?: (source) => boolean,
+  default?: any,
+  skipFalsy?: boolean
+}
+```
+
+## Transforms
+
+Built-in transforms for common conversions:
+
+```typescript
+import { transforms } from '@sygnl/mapper';
+
+transforms.msToSeconds(timestamp);      // 1704067200000 → 1704067200
+transforms.lowercase(str);              // "EMAIL" → "email"
+transforms.toArray(value);              // "foo" → ["foo"]
+transforms.pluck('id')(array);          // [{id:1},{id:2}] → [1,2]
+transforms.pipe(fn1, fn2, fn3);         // Compose transforms
+```
+
+## Examples
+
+### Meta CAPI Mapping
+
+```typescript
+const metaMapper = new EventMapper({
+  eventNames: [
+    { from: ['purchase', 'order_completed'], to: 'Purchase' }
+  ],
+  fields: [
+    { from: 'timestamp', to: 'event_time', transform: transforms.msToSeconds },
+    { from: 'user.email', to: 'user_data.em' },
+    { from: 'products', to: 'custom_data.content_ids', transform: transforms.pluck('id') },
+    { from: 'value', to: 'custom_data.value' }
+  ],
+  static: [
+    { to: 'action_source', value: 'website' }
+  ],
+  targetRoot: 'data.0'
+});
+```
+
+### Conditional Mapping
+
+```typescript
+{
+  from: 'revenue',
+  to: 'purchase_value',
+  condition: (source) => source.event_type === 'purchase',
+  transform: (value) => Math.round(value * 100) / 100
+}
+```
+
+### Multiple Source Fallbacks
+
+```typescript
+{
+  from: ['user.email', 'email', 'user_email'],
+  to: 'email'
+}
+```
+
+## License
+
+Apache-2.0
+
+Copyright 2026 Edge Foundry, Inc.

package/dist/index.cjs

@@ -0,0 +1,299 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  EventMapper: () => EventMapper,
+  transforms: () => transforms_exports
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/EventMapper.ts
+var EventMapper = class {
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Map an event from source format to target format
+   */
+  map(source) {
+    const result = {
+      data: {},
+      mappedFields: [],
+      skippedFields: [],
+      errors: []
+    };
+    try {
+      const sourceData = this.config.sourceRoot ? this.getValueAtPath(source, this.config.sourceRoot) : source;
+      if (this.config.eventNames) {
+        const eventName = this.mapEventName(sourceData);
+        if (eventName) {
+          this.setValueAtPath(result.data, "event_name", eventName);
+          result.mappedFields.push("event_name");
+        }
+      }
+      if (this.config.fields) {
+        for (const fieldMapping of this.config.fields) {
+          this.mapField(sourceData, result.data, fieldMapping, result);
+        }
+      }
+      if (this.config.static) {
+        for (const staticField of this.config.static) {
+          this.mapStaticField(sourceData, result.data, staticField, result);
+        }
+      }
+      if (this.config.targetRoot) {
+        const wrapped = {};
+        this.setValueAtPath(wrapped, this.config.targetRoot, result.data);
+        result.data = wrapped;
+      }
+    } catch (error) {
+      result.errors.push({
+        field: "_root",
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
+    return result;
+  }
+  /**
+   * Map event name using event name mappings
+   */
+  mapEventName(source) {
+    if (!this.config.eventNames) return void 0;
+    const sourceEventName = source.event_type || source.eventType || source.event_name;
+    if (!sourceEventName) return void 0;
+    for (const mapping of this.config.eventNames) {
+      const fromNames = Array.isArray(mapping.from) ? mapping.from : [mapping.from];
+      if (fromNames.includes(sourceEventName)) {
+        return mapping.to;
+      }
+    }
+    return void 0;
+  }
+  /**
+   * Map a single field
+   */
+  mapField(source, target, mapping, result) {
+    try {
+      if (mapping.condition && !mapping.condition(source)) {
+        result.skippedFields.push(mapping.to);
+        return;
+      }
+      const fromPaths = Array.isArray(mapping.from) ? mapping.from : [mapping.from];
+      let value = void 0;
+      for (const fromPath of fromPaths) {
+        value = this.getValueAtPath(source, fromPath);
+        if (value !== void 0 && value !== null) break;
+      }
+      if (value === void 0 || value === null) {
+        if (mapping.default !== void 0) {
+          value = mapping.default;
+        } else {
+          result.skippedFields.push(mapping.to);
+          return;
+        }
+      }
+      if (mapping.skipFalsy && !value) {
+        result.skippedFields.push(mapping.to);
+        return;
+      }
+      if (mapping.transform) {
+        value = mapping.transform(value, source);
+      }
+      this.setValueAtPath(target, mapping.to, value);
+      result.mappedFields.push(mapping.to);
+    } catch (error) {
+      result.errors.push({
+        field: mapping.to,
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+  /**
+   * Map a static field
+   */
+  mapStaticField(source, target, staticField, result) {
+    try {
+      const value = typeof staticField.value === "function" ? staticField.value(source) : staticField.value;
+      this.setValueAtPath(target, staticField.to, value);
+      result.mappedFields.push(staticField.to);
+    } catch (error) {
+      result.errors.push({
+        field: staticField.to,
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+  /**
+   * Get value at path using dot notation
+   * Supports array indexing (e.g., 'products.0.id')
+   */
+  getValueAtPath(obj, path) {
+    const parts = path.split(".");
+    let value = obj;
+    for (const part of parts) {
+      if (value === void 0 || value === null) return void 0;
+      if (/^\d+$/.test(part)) {
+        value = value[parseInt(part, 10)];
+      } else {
+        value = value[part];
+      }
+    }
+    return value;
+  }
+  /**
+   * Set value at path using dot notation
+   * Creates nested objects/arrays as needed
+   */
+  setValueAtPath(obj, path, value) {
+    const parts = path.split(".");
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+      const part = parts[i];
+      const nextPart = parts[i + 1];
+      if (current[part] === void 0 || current[part] === null) {
+        if (/^\d+$/.test(nextPart)) {
+          current[part] = [];
+        } else {
+          current[part] = {};
+        }
+      }
+      current = current[part];
+    }
+    const lastPart = parts[parts.length - 1];
+    if (/^\d+$/.test(lastPart)) {
+      const index = parseInt(lastPart, 10);
+      if (!Array.isArray(current)) {
+        throw new Error(`Cannot set array index ${index} on non-array`);
+      }
+      current[index] = value;
+    } else {
+      current[lastPart] = value;
+    }
+  }
+  /**
+   * Batch map multiple events
+   */
+  mapBatch(sources) {
+    return sources.map((source) => this.map(source));
+  }
+};
+
+// src/transforms.ts
+var transforms_exports = {};
+__export(transforms_exports, {
+  compose: () => compose,
+  first: () => first,
+  fromISO: () => fromISO,
+  identity: () => identity,
+  join: () => join,
+  lowercase: () => lowercase,
+  msToSeconds: () => msToSeconds,
+  omit: () => omit,
+  pick: () => pick,
+  pipe: () => pipe,
+  pluck: () => pluck,
+  renameKeys: () => renameKeys,
+  round: () => round,
+  secondsToMs: () => secondsToMs,
+  split: () => split,
+  toArray: () => toArray,
+  toBoolean: () => toBoolean,
+  toISO: () => toISO,
+  toNumber: () => toNumber,
+  toString: () => toString,
+  trim: () => trim,
+  uppercase: () => uppercase
+});
+var msToSeconds = (ms) => Math.floor(ms / 1e3);
+var secondsToMs = (seconds) => seconds * 1e3;
+var lowercase = (str) => str.toLowerCase();
+var uppercase = (str) => str.toUpperCase();
+var trim = (str) => str.trim();
+var toString = (value) => String(value);
+var toNumber = (value) => Number(value);
+var toBoolean = (value) => Boolean(value);
+var toArray = (value) => {
+  if (Array.isArray(value)) return value;
+  return [value];
+};
+var first = (value) => {
+  if (Array.isArray(value)) return value[0];
+  return value;
+};
+var pluck = (property) => (arr) => {
+  if (!Array.isArray(arr)) return [];
+  return arr.map((item) => item[property]);
+};
+var join = (separator = ",") => (arr) => {
+  if (!Array.isArray(arr)) return String(arr);
+  return arr.join(separator);
+};
+var split = (separator = ",") => (str) => {
+  return str.split(separator);
+};
+var toISO = (timestamp) => {
+  return new Date(timestamp).toISOString();
+};
+var fromISO = (iso) => {
+  return new Date(iso).getTime();
+};
+var round = (decimals = 0) => (num) => {
+  const factor = Math.pow(10, decimals);
+  return Math.round(num * factor) / factor;
+};
+var compose = (...fns) => {
+  return (value) => fns.reduceRight((acc, fn) => fn(acc), value);
+};
+var pipe = (...fns) => {
+  return (value) => fns.reduce((acc, fn) => fn(acc), value);
+};
+var identity = (value) => value;
+var renameKeys = (keyMap) => (obj) => {
+  const result = {};
+  for (const [oldKey, newKey] of Object.entries(keyMap)) {
+    if (obj[oldKey] !== void 0) {
+      result[newKey] = obj[oldKey];
+    }
+  }
+  return result;
+};
+var pick = (...keys) => (obj) => {
+  const result = {};
+  for (const key of keys) {
+    if (obj[key] !== void 0) {
+      result[key] = obj[key];
+    }
+  }
+  return result;
+};
+var omit = (...keys) => (obj) => {
+  const result = { ...obj };
+  for (const key of keys) {
+    delete result[key];
+  }
+  return result;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EventMapper,
+  transforms
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/EventMapper.ts","../src/transforms.ts"],"sourcesContent":["/**\n * @sygnl/mapper\n * \n * Declarative event mapper for transforming events between different ad platform formats.\n * \n * @example\n * ```typescript\n * import { EventMapper, msToSeconds } from '@sygnl/mapper';\n * \n * const mapper = new EventMapper({\n *   eventNames: [\n *     { from: 'purchase', to: 'Purchase' }\n *   ],\n *   fields: [\n *     { from: 'user.email', to: 'userData.em' },\n *     { from: 'timestamp', to: 'event_time', transform: msToSeconds }\n *   ]\n * });\n * \n * const result = mapper.map(sourceEvent);\n * ```\n */\n\nexport { EventMapper } from './EventMapper';\nexport type {\n  MapperConfig,\n  FieldMapping,\n  EventNameMapping,\n  StaticField,\n  MappingResult,\n  TransformFn,\n  ConditionFn,\n} from './types';\nexport * as transforms from './transforms';\n","/**\n * EventMapper - Declarative event transformation\n * \n * Map events from one format to another using simple configuration.\n * Perfect for ad platform integrations (Meta, Google, Snapchat, etc.)\n */\n\nimport type {\n  MapperConfig,\n  FieldMapping,\n  EventNameMapping,\n  StaticField,\n  MappingResult,\n} from './types';\n\nexport class EventMapper {\n  private config: MapperConfig;\n\n  constructor(config: MapperConfig) {\n    this.config = config;\n  }\n\n  /**\n   * Map an event from source format to target format\n   */\n  map<T = any>(source: any): MappingResult<T> {\n    const result: MappingResult<T> = {\n      data: {} as T,\n      mappedFields: [],\n      skippedFields: [],\n      errors: [],\n    };\n\n    try {\n      // Start with source root if specified\n      const sourceData = this.config.sourceRoot\n        ? this.getValueAtPath(source, this.config.sourceRoot)\n        : source;\n\n      // Map event names\n      if (this.config.eventNames) {\n        const eventName = this.mapEventName(sourceData);\n        if (eventName) {\n          this.setValueAtPath(result.data, 'event_name', eventName);\n          result.mappedFields.push('event_name');\n        }\n      }\n\n      // Map fields\n      if (this.config.fields) {\n        for (const fieldMapping of this.config.fields) {\n          this.mapField(sourceData, result.data, fieldMapping, result);\n        }\n      }\n\n      // Add static fields\n      if (this.config.static) {\n        for (const staticField of this.config.static) {\n          this.mapStaticField(sourceData, result.data, staticField, result);\n        }\n      }\n\n      // Apply target root if specified\n      if (this.config.targetRoot) {\n        const wrapped: any = {};\n        this.setValueAtPath(wrapped, this.config.targetRoot, result.data);\n        result.data = wrapped as T;\n      }\n    } catch (error) {\n      result.errors.push({\n        field: '_root',\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n\n    return result;\n  }\n\n  /**\n   * Map event name using event name mappings\n   */\n  private mapEventName(source: any): string | undefined {\n    if (!this.config.eventNames) return undefined;\n\n    // Try to find event_type in source\n    const sourceEventName = source.event_type || source.eventType || source.event_name;\n    if (!sourceEventName) return undefined;\n\n    // Find matching mapping\n    for (const mapping of this.config.eventNames) {\n      const fromNames = Array.isArray(mapping.from) ? mapping.from : [mapping.from];\n      if (fromNames.includes(sourceEventName)) {\n        return mapping.to;\n      }\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Map a single field\n   */\n  private mapField(\n    source: any,\n    target: any,\n    mapping: FieldMapping,\n    result: MappingResult\n  ): void {\n    try {\n      // Check condition\n      if (mapping.condition && !mapping.condition(source)) {\n        result.skippedFields.push(mapping.to);\n        return;\n      }\n\n      // Get source value(s)\n      const fromPaths = Array.isArray(mapping.from) ? mapping.from : [mapping.from];\n      let value: any = undefined;\n\n      // Try each source path until we find a value\n      for (const fromPath of fromPaths) {\n        value = this.getValueAtPath(source, fromPath);\n        if (value !== undefined && value !== null) break;\n      }\n\n      // Use default if no value found\n      if (value === undefined || value === null) {\n        if (mapping.default !== undefined) {\n          value = mapping.default;\n        } else {\n          result.skippedFields.push(mapping.to);\n          return;\n        }\n      }\n\n      // Skip falsy values if configured\n      if (mapping.skipFalsy && !value) {\n        result.skippedFields.push(mapping.to);\n        return;\n      }\n\n      // Apply transform\n      if (mapping.transform) {\n        value = mapping.transform(value, source);\n      }\n\n      // Set target value\n      this.setValueAtPath(target, mapping.to, value);\n      result.mappedFields.push(mapping.to);\n    } catch (error) {\n      result.errors.push({\n        field: mapping.to,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n\n  /**\n   * Map a static field\n   */\n  private mapStaticField(\n    source: any,\n    target: any,\n    staticField: StaticField,\n    result: MappingResult\n  ): void {\n    try {\n      const value =\n        typeof staticField.value === 'function'\n          ? staticField.value(source)\n          : staticField.value;\n\n      this.setValueAtPath(target, staticField.to, value);\n      result.mappedFields.push(staticField.to);\n    } catch (error) {\n      result.errors.push({\n        field: staticField.to,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n\n  /**\n   * Get value at path using dot notation\n   * Supports array indexing (e.g., 'products.0.id')\n   */\n  private getValueAtPath(obj: any, path: string): any {\n    const parts = path.split('.');\n    let value = obj;\n\n    for (const part of parts) {\n      if (value === undefined || value === null) return undefined;\n\n      // Handle array index\n      if (/^\\d+$/.test(part)) {\n        value = value[parseInt(part, 10)];\n      } else {\n        value = value[part];\n      }\n    }\n\n    return value;\n  }\n\n  /**\n   * Set value at path using dot notation\n   * Creates nested objects/arrays as needed\n   */\n  private setValueAtPath(obj: any, path: string, value: any): void {\n    const parts = path.split('.');\n    let current = obj;\n\n    for (let i = 0; i < parts.length - 1; i++) {\n      const part = parts[i];\n      const nextPart = parts[i + 1];\n\n      // Create nested structure if needed\n      if (current[part] === undefined || current[part] === null) {\n        // Next part is array index\n        if (/^\\d+$/.test(nextPart)) {\n          current[part] = [];\n        } else {\n          current[part] = {};\n        }\n      }\n\n      current = current[part];\n    }\n\n    const lastPart = parts[parts.length - 1];\n\n    // Handle array index\n    if (/^\\d+$/.test(lastPart)) {\n      const index = parseInt(lastPart, 10);\n      if (!Array.isArray(current)) {\n        throw new Error(`Cannot set array index ${index} on non-array`);\n      }\n      current[index] = value;\n    } else {\n      current[lastPart] = value;\n    }\n  }\n\n  /**\n   * Batch map multiple events\n   */\n  mapBatch<T = any>(sources: any[]): MappingResult<T>[] {\n    return sources.map((source) => this.map<T>(source));\n  }\n}\n","/**\n * Common transform functions for event mapping\n */\n\n/**\n * Convert milliseconds to seconds\n */\nexport const msToSeconds = (ms: number): number => Math.floor(ms / 1000);\n\n/**\n * Convert seconds to milliseconds\n */\nexport const secondsToMs = (seconds: number): number => seconds * 1000;\n\n/**\n * Lowercase string\n */\nexport const lowercase = (str: string): string => str.toLowerCase();\n\n/**\n * Uppercase string\n */\nexport const uppercase = (str: string): string => str.toUpperCase();\n\n/**\n * Trim whitespace\n */\nexport const trim = (str: string): string => str.trim();\n\n/**\n * Convert to string\n */\nexport const toString = (value: any): string => String(value);\n\n/**\n * Convert to number\n */\nexport const toNumber = (value: any): number => Number(value);\n\n/**\n * Convert to boolean\n */\nexport const toBoolean = (value: any): boolean => Boolean(value);\n\n/**\n * Wrap value in array\n */\nexport const toArray = (value: any): any[] => {\n  if (Array.isArray(value)) return value;\n  return [value];\n};\n\n/**\n * Get first element of array, or value if not array\n */\nexport const first = (value: any): any => {\n  if (Array.isArray(value)) return value[0];\n  return value;\n};\n\n/**\n * Map array of objects to array of property values\n */\nexport const pluck = (property: string) => (arr: any[]): any[] => {\n  if (!Array.isArray(arr)) return [];\n  return arr.map((item) => item[property]);\n};\n\n/**\n * Join array into string\n */\nexport const join = (separator: string = ',') => (arr: any[]): string => {\n  if (!Array.isArray(arr)) return String(arr);\n  return arr.join(separator);\n};\n\n/**\n * Split string into array\n */\nexport const split = (separator: string = ',') => (str: string): string[] => {\n  return str.split(separator);\n};\n\n/**\n * Format date as ISO 8601\n */\nexport const toISO = (timestamp: number): string => {\n  return new Date(timestamp).toISOString();\n};\n\n/**\n * Parse ISO date to timestamp\n */\nexport const fromISO = (iso: string): number => {\n  return new Date(iso).getTime();\n};\n\n/**\n * Round number to decimals\n */\nexport const round = (decimals: number = 0) => (num: number): number => {\n  const factor = Math.pow(10, decimals);\n  return Math.round(num * factor) / factor;\n};\n\n/**\n * Compose multiple transforms (right to left)\n */\nexport const compose = (...fns: ((value: any) => any)[]): ((value: any) => any) => {\n  return (value: any) => fns.reduceRight((acc, fn) => fn(acc), value);\n};\n\n/**\n * Pipe multiple transforms (left to right)\n */\nexport const pipe = (...fns: ((value: any) => any)[]): ((value: any) => any) => {\n  return (value: any) => fns.reduce((acc, fn) => fn(acc), value);\n};\n\n/**\n * Return value as-is (identity function)\n */\nexport const identity = (value: any): any => value;\n\n/**\n * Rename object keys\n */\nexport const renameKeys = (keyMap: Record<string, string>) => (obj: any): any => {\n  const result: any = {};\n  for (const [oldKey, newKey] of Object.entries(keyMap)) {\n    if (obj[oldKey] !== undefined) {\n      result[newKey] = obj[oldKey];\n    }\n  }\n  return result;\n};\n\n/**\n * Pick specific keys from object\n */\nexport const pick = (...keys: string[]) => (obj: any): any => {\n  const result: any = {};\n  for (const key of keys) {\n    if (obj[key] !== undefined) {\n      result[key] = obj[key];\n    }\n  }\n  return result;\n};\n\n/**\n * Omit specific keys from object\n */\nexport const omit = (...keys: string[]) => (obj: any): any => {\n  const result = { ...obj };\n  for (const key of keys) {\n    delete result[key];\n  }\n  return result;\n};\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,280 @@
+/**
+ * Type definitions for event mapper
+ */
+/**
+ * Transform function to modify a value during mapping
+ */
+type TransformFn = (value: any, source: any) => any;
+/**
+ * Condition function to determine if mapping should apply
+ */
+type ConditionFn = (source: any) => boolean;
+/**
+ * Field mapping configuration
+ */
+interface FieldMapping {
+    /**
+     * Source path in dot notation (e.g., 'user.email', 'products.0.id')
+     */
+    from: string | string[];
+    /**
+     * Target path in dot notation (e.g., 'userData.em', 'items.0.id')
+     */
+    to: string;
+    /**
+     * Optional transform function to modify value
+     */
+    transform?: TransformFn;
+    /**
+     * Optional condition - only map if this returns true
+     */
+    condition?: ConditionFn;
+    /**
+     * Default value if source is undefined/null
+     */
+    default?: any;
+    /**
+     * Whether to skip if value is falsy
+     * @default false
+     */
+    skipFalsy?: boolean;
+}
+/**
+ * Event name mapping configuration
+ */
+interface EventNameMapping {
+    /**
+     * Source event name or names
+     */
+    from: string | string[];
+    /**
+     * Target event name
+     */
+    to: string;
+}
+/**
+ * Static field to always add to output
+ */
+interface StaticField {
+    /**
+     * Target path
+     */
+    to: string;
+    /**
+     * Static value or function to generate value
+     */
+    value: any | ((source: any) => any);
+}
+/**
+ * Mapper configuration
+ */
+interface MapperConfig {
+    /**
+     * Event name mappings
+     */
+    eventNames?: EventNameMapping[];
+    /**
+     * Field mappings
+     */
+    fields?: FieldMapping[];
+    /**
+     * Static fields to always include
+     */
+    static?: StaticField[];
+    /**
+     * Root path for source data
+     * @example 'data' to read from source.data.*
+     */
+    sourceRoot?: string;
+    /**
+     * Root path for target data
+     * @example 'data.0' to write to target.data[0].*
+     */
+    targetRoot?: string;
+}
+/**
+ * Mapping result
+ */
+interface MappingResult<T = any> {
+    /**
+     * Mapped data
+     */
+    data: T;
+    /**
+     * Fields that were mapped
+     */
+    mappedFields: string[];
+    /**
+     * Fields that were skipped (condition/falsy)
+     */
+    skippedFields: string[];
+    /**
+     * Errors encountered during mapping
+     */
+    errors: Array<{
+        field: string;
+        error: string;
+    }>;
+}
+
+/**
+ * EventMapper - Declarative event transformation
+ *
+ * Map events from one format to another using simple configuration.
+ * Perfect for ad platform integrations (Meta, Google, Snapchat, etc.)
+ */
+
+declare class EventMapper {
+    private config;
+    constructor(config: MapperConfig);
+    /**
+     * Map an event from source format to target format
+     */
+    map<T = any>(source: any): MappingResult<T>;
+    /**
+     * Map event name using event name mappings
+     */
+    private mapEventName;
+    /**
+     * Map a single field
+     */
+    private mapField;
+    /**
+     * Map a static field
+     */
+    private mapStaticField;
+    /**
+     * Get value at path using dot notation
+     * Supports array indexing (e.g., 'products.0.id')
+     */
+    private getValueAtPath;
+    /**
+     * Set value at path using dot notation
+     * Creates nested objects/arrays as needed
+     */
+    private setValueAtPath;
+    /**
+     * Batch map multiple events
+     */
+    mapBatch<T = any>(sources: any[]): MappingResult<T>[];
+}
+
+/**
+ * Common transform functions for event mapping
+ */
+/**
+ * Convert milliseconds to seconds
+ */
+declare const msToSeconds: (ms: number) => number;
+/**
+ * Convert seconds to milliseconds
+ */
+declare const secondsToMs: (seconds: number) => number;
+/**
+ * Lowercase string
+ */
+declare const lowercase: (str: string) => string;
+/**
+ * Uppercase string
+ */
+declare const uppercase: (str: string) => string;
+/**
+ * Trim whitespace
+ */
+declare const trim: (str: string) => string;
+/**
+ * Convert to string
+ */
+declare const toString: (value: any) => string;
+/**
+ * Convert to number
+ */
+declare const toNumber: (value: any) => number;
+/**
+ * Convert to boolean
+ */
+declare const toBoolean: (value: any) => boolean;
+/**
+ * Wrap value in array
+ */
+declare const toArray: (value: any) => any[];
+/**
+ * Get first element of array, or value if not array
+ */
+declare const first: (value: any) => any;
+/**
+ * Map array of objects to array of property values
+ */
+declare const pluck: (property: string) => (arr: any[]) => any[];
+/**
+ * Join array into string
+ */
+declare const join: (separator?: string) => (arr: any[]) => string;
+/**
+ * Split string into array
+ */
+declare const split: (separator?: string) => (str: string) => string[];
+/**
+ * Format date as ISO 8601
+ */
+declare const toISO: (timestamp: number) => string;
+/**
+ * Parse ISO date to timestamp
+ */
+declare const fromISO: (iso: string) => number;
+/**
+ * Round number to decimals
+ */
+declare const round: (decimals?: number) => (num: number) => number;
+/**
+ * Compose multiple transforms (right to left)
+ */
+declare const compose: (...fns: ((value: any) => any)[]) => ((value: any) => any);
+/**
+ * Pipe multiple transforms (left to right)
+ */
+declare const pipe: (...fns: ((value: any) => any)[]) => ((value: any) => any);
+/**
+ * Return value as-is (identity function)
+ */
+declare const identity: (value: any) => any;
+/**
+ * Rename object keys
+ */
+declare const renameKeys: (keyMap: Record<string, string>) => (obj: any) => any;
+/**
+ * Pick specific keys from object
+ */
+declare const pick: (...keys: string[]) => (obj: any) => any;
+/**
+ * Omit specific keys from object
+ */
+declare const omit: (...keys: string[]) => (obj: any) => any;
+
+declare const transforms_compose: typeof compose;
+declare const transforms_first: typeof first;
+declare const transforms_fromISO: typeof fromISO;
+declare const transforms_identity: typeof identity;
+declare const transforms_join: typeof join;
+declare const transforms_lowercase: typeof lowercase;
+declare const transforms_msToSeconds: typeof msToSeconds;
+declare const transforms_omit: typeof omit;
+declare const transforms_pick: typeof pick;
+declare const transforms_pipe: typeof pipe;
+declare const transforms_pluck: typeof pluck;
+declare const transforms_renameKeys: typeof renameKeys;
+declare const transforms_round: typeof round;
+declare const transforms_secondsToMs: typeof secondsToMs;
+declare const transforms_split: typeof split;
+declare const transforms_toArray: typeof toArray;
+declare const transforms_toBoolean: typeof toBoolean;
+declare const transforms_toISO: typeof toISO;
+declare const transforms_toNumber: typeof toNumber;
+declare const transforms_toString: typeof toString;
+declare const transforms_trim: typeof trim;
+declare const transforms_uppercase: typeof uppercase;
+declare namespace transforms {
+  export { transforms_compose as compose, transforms_first as first, transforms_fromISO as fromISO, transforms_identity as identity, transforms_join as join, transforms_lowercase as lowercase, transforms_msToSeconds as msToSeconds, transforms_omit as omit, transforms_pick as pick, transforms_pipe as pipe, transforms_pluck as pluck, transforms_renameKeys as renameKeys, transforms_round as round, transforms_secondsToMs as secondsToMs, transforms_split as split, transforms_toArray as toArray, transforms_toBoolean as toBoolean, transforms_toISO as toISO, transforms_toNumber as toNumber, transforms_toString as toString, transforms_trim as trim, transforms_uppercase as uppercase };
+}
+
+export { type ConditionFn, EventMapper, type EventNameMapping, type FieldMapping, type MapperConfig, type MappingResult, type StaticField, type TransformFn, transforms };

package/dist/index.d.ts

@@ -0,0 +1,280 @@
+/**
+ * Type definitions for event mapper
+ */
+/**
+ * Transform function to modify a value during mapping
+ */
+type TransformFn = (value: any, source: any) => any;
+/**
+ * Condition function to determine if mapping should apply
+ */
+type ConditionFn = (source: any) => boolean;
+/**
+ * Field mapping configuration
+ */
+interface FieldMapping {
+    /**
+     * Source path in dot notation (e.g., 'user.email', 'products.0.id')
+     */
+    from: string | string[];
+    /**
+     * Target path in dot notation (e.g., 'userData.em', 'items.0.id')
+     */
+    to: string;
+    /**
+     * Optional transform function to modify value
+     */
+    transform?: TransformFn;
+    /**
+     * Optional condition - only map if this returns true
+     */
+    condition?: ConditionFn;
+    /**
+     * Default value if source is undefined/null
+     */
+    default?: any;
+    /**
+     * Whether to skip if value is falsy
+     * @default false
+     */
+    skipFalsy?: boolean;
+}
+/**
+ * Event name mapping configuration
+ */
+interface EventNameMapping {
+    /**
+     * Source event name or names
+     */
+    from: string | string[];
+    /**
+     * Target event name
+     */
+    to: string;
+}
+/**
+ * Static field to always add to output
+ */
+interface StaticField {
+    /**
+     * Target path
+     */
+    to: string;
+    /**
+     * Static value or function to generate value
+     */
+    value: any | ((source: any) => any);
+}
+/**
+ * Mapper configuration
+ */
+interface MapperConfig {
+    /**
+     * Event name mappings
+     */
+    eventNames?: EventNameMapping[];
+    /**
+     * Field mappings
+     */
+    fields?: FieldMapping[];
+    /**
+     * Static fields to always include
+     */
+    static?: StaticField[];
+    /**
+     * Root path for source data
+     * @example 'data' to read from source.data.*
+     */
+    sourceRoot?: string;
+    /**
+     * Root path for target data
+     * @example 'data.0' to write to target.data[0].*
+     */
+    targetRoot?: string;
+}
+/**
+ * Mapping result
+ */
+interface MappingResult<T = any> {
+    /**
+     * Mapped data
+     */
+    data: T;
+    /**
+     * Fields that were mapped
+     */
+    mappedFields: string[];
+    /**
+     * Fields that were skipped (condition/falsy)
+     */
+    skippedFields: string[];
+    /**
+     * Errors encountered during mapping
+     */
+    errors: Array<{
+        field: string;
+        error: string;
+    }>;
+}
+
+/**
+ * EventMapper - Declarative event transformation
+ *
+ * Map events from one format to another using simple configuration.
+ * Perfect for ad platform integrations (Meta, Google, Snapchat, etc.)
+ */
+
+declare class EventMapper {
+    private config;
+    constructor(config: MapperConfig);
+    /**
+     * Map an event from source format to target format
+     */
+    map<T = any>(source: any): MappingResult<T>;
+    /**
+     * Map event name using event name mappings
+     */
+    private mapEventName;
+    /**
+     * Map a single field
+     */
+    private mapField;
+    /**
+     * Map a static field
+     */
+    private mapStaticField;
+    /**
+     * Get value at path using dot notation
+     * Supports array indexing (e.g., 'products.0.id')
+     */
+    private getValueAtPath;
+    /**
+     * Set value at path using dot notation
+     * Creates nested objects/arrays as needed
+     */
+    private setValueAtPath;
+    /**
+     * Batch map multiple events
+     */
+    mapBatch<T = any>(sources: any[]): MappingResult<T>[];
+}
+
+/**
+ * Common transform functions for event mapping
+ */
+/**
+ * Convert milliseconds to seconds
+ */
+declare const msToSeconds: (ms: number) => number;
+/**
+ * Convert seconds to milliseconds
+ */
+declare const secondsToMs: (seconds: number) => number;
+/**
+ * Lowercase string
+ */
+declare const lowercase: (str: string) => string;
+/**
+ * Uppercase string
+ */
+declare const uppercase: (str: string) => string;
+/**
+ * Trim whitespace
+ */
+declare const trim: (str: string) => string;
+/**
+ * Convert to string
+ */
+declare const toString: (value: any) => string;
+/**
+ * Convert to number
+ */
+declare const toNumber: (value: any) => number;
+/**
+ * Convert to boolean
+ */
+declare const toBoolean: (value: any) => boolean;
+/**
+ * Wrap value in array
+ */
+declare const toArray: (value: any) => any[];
+/**
+ * Get first element of array, or value if not array
+ */
+declare const first: (value: any) => any;
+/**
+ * Map array of objects to array of property values
+ */
+declare const pluck: (property: string) => (arr: any[]) => any[];
+/**
+ * Join array into string
+ */
+declare const join: (separator?: string) => (arr: any[]) => string;
+/**
+ * Split string into array
+ */
+declare const split: (separator?: string) => (str: string) => string[];
+/**
+ * Format date as ISO 8601
+ */
+declare const toISO: (timestamp: number) => string;
+/**
+ * Parse ISO date to timestamp
+ */
+declare const fromISO: (iso: string) => number;
+/**
+ * Round number to decimals
+ */
+declare const round: (decimals?: number) => (num: number) => number;
+/**
+ * Compose multiple transforms (right to left)
+ */
+declare const compose: (...fns: ((value: any) => any)[]) => ((value: any) => any);
+/**
+ * Pipe multiple transforms (left to right)
+ */
+declare const pipe: (...fns: ((value: any) => any)[]) => ((value: any) => any);
+/**
+ * Return value as-is (identity function)
+ */
+declare const identity: (value: any) => any;
+/**
+ * Rename object keys
+ */
+declare const renameKeys: (keyMap: Record<string, string>) => (obj: any) => any;
+/**
+ * Pick specific keys from object
+ */
+declare const pick: (...keys: string[]) => (obj: any) => any;
+/**
+ * Omit specific keys from object
+ */
+declare const omit: (...keys: string[]) => (obj: any) => any;
+
+declare const transforms_compose: typeof compose;
+declare const transforms_first: typeof first;
+declare const transforms_fromISO: typeof fromISO;
+declare const transforms_identity: typeof identity;
+declare const transforms_join: typeof join;
+declare const transforms_lowercase: typeof lowercase;
+declare const transforms_msToSeconds: typeof msToSeconds;
+declare const transforms_omit: typeof omit;
+declare const transforms_pick: typeof pick;
+declare const transforms_pipe: typeof pipe;
+declare const transforms_pluck: typeof pluck;
+declare const transforms_renameKeys: typeof renameKeys;
+declare const transforms_round: typeof round;
+declare const transforms_secondsToMs: typeof secondsToMs;
+declare const transforms_split: typeof split;
+declare const transforms_toArray: typeof toArray;
+declare const transforms_toBoolean: typeof toBoolean;
+declare const transforms_toISO: typeof toISO;
+declare const transforms_toNumber: typeof toNumber;
+declare const transforms_toString: typeof toString;
+declare const transforms_trim: typeof trim;
+declare const transforms_uppercase: typeof uppercase;
+declare namespace transforms {
+  export { transforms_compose as compose, transforms_first as first, transforms_fromISO as fromISO, transforms_identity as identity, transforms_join as join, transforms_lowercase as lowercase, transforms_msToSeconds as msToSeconds, transforms_omit as omit, transforms_pick as pick, transforms_pipe as pipe, transforms_pluck as pluck, transforms_renameKeys as renameKeys, transforms_round as round, transforms_secondsToMs as secondsToMs, transforms_split as split, transforms_toArray as toArray, transforms_toBoolean as toBoolean, transforms_toISO as toISO, transforms_toNumber as toNumber, transforms_toString as toString, transforms_trim as trim, transforms_uppercase as uppercase };
+}
+
+export { type ConditionFn, EventMapper, type EventNameMapping, type FieldMapping, type MapperConfig, type MappingResult, type StaticField, type TransformFn, transforms };

package/dist/index.js

@@ -0,0 +1,277 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/EventMapper.ts
+var EventMapper = class {
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Map an event from source format to target format
+   */
+  map(source) {
+    const result = {
+      data: {},
+      mappedFields: [],
+      skippedFields: [],
+      errors: []
+    };
+    try {
+      const sourceData = this.config.sourceRoot ? this.getValueAtPath(source, this.config.sourceRoot) : source;
+      if (this.config.eventNames) {
+        const eventName = this.mapEventName(sourceData);
+        if (eventName) {
+          this.setValueAtPath(result.data, "event_name", eventName);
+          result.mappedFields.push("event_name");
+        }
+      }
+      if (this.config.fields) {
+        for (const fieldMapping of this.config.fields) {
+          this.mapField(sourceData, result.data, fieldMapping, result);
+        }
+      }
+      if (this.config.static) {
+        for (const staticField of this.config.static) {
+          this.mapStaticField(sourceData, result.data, staticField, result);
+        }
+      }
+      if (this.config.targetRoot) {
+        const wrapped = {};
+        this.setValueAtPath(wrapped, this.config.targetRoot, result.data);
+        result.data = wrapped;
+      }
+    } catch (error) {
+      result.errors.push({
+        field: "_root",
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
+    return result;
+  }
+  /**
+   * Map event name using event name mappings
+   */
+  mapEventName(source) {
+    if (!this.config.eventNames) return void 0;
+    const sourceEventName = source.event_type || source.eventType || source.event_name;
+    if (!sourceEventName) return void 0;
+    for (const mapping of this.config.eventNames) {
+      const fromNames = Array.isArray(mapping.from) ? mapping.from : [mapping.from];
+      if (fromNames.includes(sourceEventName)) {
+        return mapping.to;
+      }
+    }
+    return void 0;
+  }
+  /**
+   * Map a single field
+   */
+  mapField(source, target, mapping, result) {
+    try {
+      if (mapping.condition && !mapping.condition(source)) {
+        result.skippedFields.push(mapping.to);
+        return;
+      }
+      const fromPaths = Array.isArray(mapping.from) ? mapping.from : [mapping.from];
+      let value = void 0;
+      for (const fromPath of fromPaths) {
+        value = this.getValueAtPath(source, fromPath);
+        if (value !== void 0 && value !== null) break;
+      }
+      if (value === void 0 || value === null) {
+        if (mapping.default !== void 0) {
+          value = mapping.default;
+        } else {
+          result.skippedFields.push(mapping.to);
+          return;
+        }
+      }
+      if (mapping.skipFalsy && !value) {
+        result.skippedFields.push(mapping.to);
+        return;
+      }
+      if (mapping.transform) {
+        value = mapping.transform(value, source);
+      }
+      this.setValueAtPath(target, mapping.to, value);
+      result.mappedFields.push(mapping.to);
+    } catch (error) {
+      result.errors.push({
+        field: mapping.to,
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+  /**
+   * Map a static field
+   */
+  mapStaticField(source, target, staticField, result) {
+    try {
+      const value = typeof staticField.value === "function" ? staticField.value(source) : staticField.value;
+      this.setValueAtPath(target, staticField.to, value);
+      result.mappedFields.push(staticField.to);
+    } catch (error) {
+      result.errors.push({
+        field: staticField.to,
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+  /**
+   * Get value at path using dot notation
+   * Supports array indexing (e.g., 'products.0.id')
+   */
+  getValueAtPath(obj, path) {
+    const parts = path.split(".");
+    let value = obj;
+    for (const part of parts) {
+      if (value === void 0 || value === null) return void 0;
+      if (/^\d+$/.test(part)) {
+        value = value[parseInt(part, 10)];
+      } else {
+        value = value[part];
+      }
+    }
+    return value;
+  }
+  /**
+   * Set value at path using dot notation
+   * Creates nested objects/arrays as needed
+   */
+  setValueAtPath(obj, path, value) {
+    const parts = path.split(".");
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+      const part = parts[i];
+      const nextPart = parts[i + 1];
+      if (current[part] === void 0 || current[part] === null) {
+        if (/^\d+$/.test(nextPart)) {
+          current[part] = [];
+        } else {
+          current[part] = {};
+        }
+      }
+      current = current[part];
+    }
+    const lastPart = parts[parts.length - 1];
+    if (/^\d+$/.test(lastPart)) {
+      const index = parseInt(lastPart, 10);
+      if (!Array.isArray(current)) {
+        throw new Error(`Cannot set array index ${index} on non-array`);
+      }
+      current[index] = value;
+    } else {
+      current[lastPart] = value;
+    }
+  }
+  /**
+   * Batch map multiple events
+   */
+  mapBatch(sources) {
+    return sources.map((source) => this.map(source));
+  }
+};
+
+// src/transforms.ts
+var transforms_exports = {};
+__export(transforms_exports, {
+  compose: () => compose,
+  first: () => first,
+  fromISO: () => fromISO,
+  identity: () => identity,
+  join: () => join,
+  lowercase: () => lowercase,
+  msToSeconds: () => msToSeconds,
+  omit: () => omit,
+  pick: () => pick,
+  pipe: () => pipe,
+  pluck: () => pluck,
+  renameKeys: () => renameKeys,
+  round: () => round,
+  secondsToMs: () => secondsToMs,
+  split: () => split,
+  toArray: () => toArray,
+  toBoolean: () => toBoolean,
+  toISO: () => toISO,
+  toNumber: () => toNumber,
+  toString: () => toString,
+  trim: () => trim,
+  uppercase: () => uppercase
+});
+var msToSeconds = (ms) => Math.floor(ms / 1e3);
+var secondsToMs = (seconds) => seconds * 1e3;
+var lowercase = (str) => str.toLowerCase();
+var uppercase = (str) => str.toUpperCase();
+var trim = (str) => str.trim();
+var toString = (value) => String(value);
+var toNumber = (value) => Number(value);
+var toBoolean = (value) => Boolean(value);
+var toArray = (value) => {
+  if (Array.isArray(value)) return value;
+  return [value];
+};
+var first = (value) => {
+  if (Array.isArray(value)) return value[0];
+  return value;
+};
+var pluck = (property) => (arr) => {
+  if (!Array.isArray(arr)) return [];
+  return arr.map((item) => item[property]);
+};
+var join = (separator = ",") => (arr) => {
+  if (!Array.isArray(arr)) return String(arr);
+  return arr.join(separator);
+};
+var split = (separator = ",") => (str) => {
+  return str.split(separator);
+};
+var toISO = (timestamp) => {
+  return new Date(timestamp).toISOString();
+};
+var fromISO = (iso) => {
+  return new Date(iso).getTime();
+};
+var round = (decimals = 0) => (num) => {
+  const factor = Math.pow(10, decimals);
+  return Math.round(num * factor) / factor;
+};
+var compose = (...fns) => {
+  return (value) => fns.reduceRight((acc, fn) => fn(acc), value);
+};
+var pipe = (...fns) => {
+  return (value) => fns.reduce((acc, fn) => fn(acc), value);
+};
+var identity = (value) => value;
+var renameKeys = (keyMap) => (obj) => {
+  const result = {};
+  for (const [oldKey, newKey] of Object.entries(keyMap)) {
+    if (obj[oldKey] !== void 0) {
+      result[newKey] = obj[oldKey];
+    }
+  }
+  return result;
+};
+var pick = (...keys) => (obj) => {
+  const result = {};
+  for (const key of keys) {
+    if (obj[key] !== void 0) {
+      result[key] = obj[key];
+    }
+  }
+  return result;
+};
+var omit = (...keys) => (obj) => {
+  const result = { ...obj };
+  for (const key of keys) {
+    delete result[key];
+  }
+  return result;
+};
+export {
+  EventMapper,
+  transforms_exports as transforms
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/EventMapper.ts","../src/transforms.ts"],"sourcesContent":["/**\n * EventMapper - Declarative event transformation\n * \n * Map events from one format to another using simple configuration.\n * Perfect for ad platform integrations (Meta, Google, Snapchat, etc.)\n */\n\nimport type {\n  MapperConfig,\n  FieldMapping,\n  EventNameMapping,\n  StaticField,\n  MappingResult,\n} from './types';\n\nexport class EventMapper {\n  private config: MapperConfig;\n\n  constructor(config: MapperConfig) {\n    this.config = config;\n  }\n\n  /**\n   * Map an event from source format to target format\n   */\n  map<T = any>(source: any): MappingResult<T> {\n    const result: MappingResult<T> = {\n      data: {} as T,\n      mappedFields: [],\n      skippedFields: [],\n      errors: [],\n    };\n\n    try {\n      // Start with source root if specified\n      const sourceData = this.config.sourceRoot\n        ? this.getValueAtPath(source, this.config.sourceRoot)\n        : source;\n\n      // Map event names\n      if (this.config.eventNames) {\n        const eventName = this.mapEventName(sourceData);\n        if (eventName) {\n          this.setValueAtPath(result.data, 'event_name', eventName);\n          result.mappedFields.push('event_name');\n        }\n      }\n\n      // Map fields\n      if (this.config.fields) {\n        for (const fieldMapping of this.config.fields) {\n          this.mapField(sourceData, result.data, fieldMapping, result);\n        }\n      }\n\n      // Add static fields\n      if (this.config.static) {\n        for (const staticField of this.config.static) {\n          this.mapStaticField(sourceData, result.data, staticField, result);\n        }\n      }\n\n      // Apply target root if specified\n      if (this.config.targetRoot) {\n        const wrapped: any = {};\n        this.setValueAtPath(wrapped, this.config.targetRoot, result.data);\n        result.data = wrapped as T;\n      }\n    } catch (error) {\n      result.errors.push({\n        field: '_root',\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n\n    return result;\n  }\n\n  /**\n   * Map event name using event name mappings\n   */\n  private mapEventName(source: any): string | undefined {\n    if (!this.config.eventNames) return undefined;\n\n    // Try to find event_type in source\n    const sourceEventName = source.event_type || source.eventType || source.event_name;\n    if (!sourceEventName) return undefined;\n\n    // Find matching mapping\n    for (const mapping of this.config.eventNames) {\n      const fromNames = Array.isArray(mapping.from) ? mapping.from : [mapping.from];\n      if (fromNames.includes(sourceEventName)) {\n        return mapping.to;\n      }\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Map a single field\n   */\n  private mapField(\n    source: any,\n    target: any,\n    mapping: FieldMapping,\n    result: MappingResult\n  ): void {\n    try {\n      // Check condition\n      if (mapping.condition && !mapping.condition(source)) {\n        result.skippedFields.push(mapping.to);\n        return;\n      }\n\n      // Get source value(s)\n      const fromPaths = Array.isArray(mapping.from) ? mapping.from : [mapping.from];\n      let value: any = undefined;\n\n      // Try each source path until we find a value\n      for (const fromPath of fromPaths) {\n        value = this.getValueAtPath(source, fromPath);\n        if (value !== undefined && value !== null) break;\n      }\n\n      // Use default if no value found\n      if (value === undefined || value === null) {\n        if (mapping.default !== undefined) {\n          value = mapping.default;\n        } else {\n          result.skippedFields.push(mapping.to);\n          return;\n        }\n      }\n\n      // Skip falsy values if configured\n      if (mapping.skipFalsy && !value) {\n        result.skippedFields.push(mapping.to);\n        return;\n      }\n\n      // Apply transform\n      if (mapping.transform) {\n        value = mapping.transform(value, source);\n      }\n\n      // Set target value\n      this.setValueAtPath(target, mapping.to, value);\n      result.mappedFields.push(mapping.to);\n    } catch (error) {\n      result.errors.push({\n        field: mapping.to,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n\n  /**\n   * Map a static field\n   */\n  private mapStaticField(\n    source: any,\n    target: any,\n    staticField: StaticField,\n    result: MappingResult\n  ): void {\n    try {\n      const value =\n        typeof staticField.value === 'function'\n          ? staticField.value(source)\n          : staticField.value;\n\n      this.setValueAtPath(target, staticField.to, value);\n      result.mappedFields.push(staticField.to);\n    } catch (error) {\n      result.errors.push({\n        field: staticField.to,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n\n  /**\n   * Get value at path using dot notation\n   * Supports array indexing (e.g., 'products.0.id')\n   */\n  private getValueAtPath(obj: any, path: string): any {\n    const parts = path.split('.');\n    let value = obj;\n\n    for (const part of parts) {\n      if (value === undefined || value === null) return undefined;\n\n      // Handle array index\n      if (/^\\d+$/.test(part)) {\n        value = value[parseInt(part, 10)];\n      } else {\n        value = value[part];\n      }\n    }\n\n    return value;\n  }\n\n  /**\n   * Set value at path using dot notation\n   * Creates nested objects/arrays as needed\n   */\n  private setValueAtPath(obj: any, path: string, value: any): void {\n    const parts = path.split('.');\n    let current = obj;\n\n    for (let i = 0; i < parts.length - 1; i++) {\n      const part = parts[i];\n      const nextPart = parts[i + 1];\n\n      // Create nested structure if needed\n      if (current[part] === undefined || current[part] === null) {\n        // Next part is array index\n        if (/^\\d+$/.test(nextPart)) {\n          current[part] = [];\n        } else {\n          current[part] = {};\n        }\n      }\n\n      current = current[part];\n    }\n\n    const lastPart = parts[parts.length - 1];\n\n    // Handle array index\n    if (/^\\d+$/.test(lastPart)) {\n      const index = parseInt(lastPart, 10);\n      if (!Array.isArray(current)) {\n        throw new Error(`Cannot set array index ${index} on non-array`);\n      }\n      current[index] = value;\n    } else {\n      current[lastPart] = value;\n    }\n  }\n\n  /**\n   * Batch map multiple events\n   */\n  mapBatch<T = any>(sources: any[]): MappingResult<T>[] {\n    return sources.map((source) => this.map<T>(source));\n  }\n}\n","/**\n * Common transform functions for event mapping\n */\n\n/**\n * Convert milliseconds to seconds\n */\nexport const msToSeconds = (ms: number): number => Math.floor(ms / 1000);\n\n/**\n * Convert seconds to milliseconds\n */\nexport const secondsToMs = (seconds: number): number => seconds * 1000;\n\n/**\n * Lowercase string\n */\nexport const lowercase = (str: string): string => str.toLowerCase();\n\n/**\n * Uppercase string\n */\nexport const uppercase = (str: string): string => str.toUpperCase();\n\n/**\n * Trim whitespace\n */\nexport const trim = (str: string): string => str.trim();\n\n/**\n * Convert to string\n */\nexport const toString = (value: any): string => String(value);\n\n/**\n * Convert to number\n */\nexport const toNumber = (value: any): number => Number(value);\n\n/**\n * Convert to boolean\n */\nexport const toBoolean = (value: any): boolean => Boolean(value);\n\n/**\n * Wrap value in array\n */\nexport const toArray = (value: any): any[] => {\n  if (Array.isArray(value)) return value;\n  return [value];\n};\n\n/**\n * Get first element of array, or value if not array\n */\nexport const first = (value: any): any => {\n  if (Array.isArray(value)) return value[0];\n  return value;\n};\n\n/**\n * Map array of objects to array of property values\n */\nexport const pluck = (property: string) => (arr: any[]): any[] => {\n  if (!Array.isArray(arr)) return [];\n  return arr.map((item) => item[property]);\n};\n\n/**\n * Join array into string\n */\nexport const join = (separator: string = ',') => (arr: any[]): string => {\n  if (!Array.isArray(arr)) return String(arr);\n  return arr.join(separator);\n};\n\n/**\n * Split string into array\n */\nexport const split = (separator: string = ',') => (str: string): string[] => {\n  return str.split(separator);\n};\n\n/**\n * Format date as ISO 8601\n */\nexport const toISO = (timestamp: number): string => {\n  return new Date(timestamp).toISOString();\n};\n\n/**\n * Parse ISO date to timestamp\n */\nexport const fromISO = (iso: string): number => {\n  return new Date(iso).getTime();\n};\n\n/**\n * Round number to decimals\n */\nexport const round = (decimals: number = 0) => (num: number): number => {\n  const factor = Math.pow(10, decimals);\n  return Math.round(num * factor) / factor;\n};\n\n/**\n * Compose multiple transforms (right to left)\n */\nexport const compose = (...fns: ((value: any) => any)[]): ((value: any) => any) => {\n  return (value: any) => fns.reduceRight((acc, fn) => fn(acc), value);\n};\n\n/**\n * Pipe multiple transforms (left to right)\n */\nexport const pipe = (...fns: ((value: any) => any)[]): ((value: any) => any) => {\n  return (value: any) => fns.reduce((acc, fn) => fn(acc), value);\n};\n\n/**\n * Return value as-is (identity function)\n */\nexport const identity = (value: any): any => value;\n\n/**\n * Rename object keys\n */\nexport const renameKeys = (keyMap: Record<string, string>) => (obj: any): any => {\n  const result: any = {};\n  for (const [oldKey, newKey] of Object.entries(keyMap)) {\n    if (obj[oldKey] !== undefined) {\n      result[newKey] = obj[oldKey];\n    }\n  }\n  return result;\n};\n\n/**\n * Pick specific keys from object\n */\nexport const pick = (...keys: string[]) => (obj: any): any => {\n  const result: any = {};\n  for (const key of keys) {\n    if (obj[key] !== undefined) {\n      result[key] = obj[key];\n    }\n  }\n  return result;\n};\n\n/**\n * Omit specific keys from object\n */\nexport const omit = (...keys: string[]) => (obj: any): any => {\n  const result = { ...obj };\n  for (const key of keys) {\n    delete result[key];\n  }\n  return result;\n};\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@sygnl/mapper",
+  "version": "1.0.0",
+  "description": "Declarative event mapper for transforming events between different ad platform formats",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "mapper",
+    "event-mapping",
+    "transform",
+    "ad-platforms",
+    "meta",
+    "google",
+    "snapchat",
+    "tiktok",
+    "conversion-api"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3",
+    "vitest": "^1.0.4",
+    "@vitest/coverage-v8": "^1.0.4"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "author": "Edge Foundry, Inc.",
+  "license": "Apache-2.0"
+}