@walkeros/server-destination-tiktok 3.3.0-next-1776098542393

package/dist/index.d.ts

@@ -0,0 +1,101 @@
+import { Mapping as Mapping$1, Destination as Destination$1 } from '@walkeros/core';
+import { DestinationServer, sendServer } from '@walkeros/server-core';
+
+interface Settings {
+    pixelCode: string;
+    accessToken: string;
+    url?: string;
+    test_event_code?: string;
+    doNotHash?: string[];
+    user_data?: Mapping$1.Map;
+    partner_name?: string;
+}
+type InitSettings = Partial<Settings>;
+interface Mapping {
+}
+interface Env extends DestinationServer.Env {
+    sendServer?: typeof sendServer;
+}
+type Types = Destination$1.Types<Settings, Mapping, Env, InitSettings>;
+interface Destination extends DestinationServer.Destination<Types> {
+    init: DestinationServer.InitFn<Types>;
+}
+type Config = {
+    settings: Settings;
+} & DestinationServer.Config<Types>;
+type InitFn = DestinationServer.InitFn<Types>;
+type PushFn = DestinationServer.PushFn<Types>;
+type PartialConfig = DestinationServer.PartialConfig<Types>;
+type PushEvents = DestinationServer.PushEvents<Mapping>;
+type Rule = Mapping$1.Rule<Mapping>;
+type Rules = Mapping$1.Rules<Rule>;
+interface RequestBody {
+    pixel_code: string;
+    partner_name?: string;
+    test_event_code?: string;
+    data: EventData[];
+}
+interface EventData {
+    event: string;
+    event_id: string;
+    timestamp: string;
+    context?: EventContext;
+    properties?: Record<string, unknown>;
+}
+interface EventContext {
+    ip?: string;
+    user_agent?: string;
+    user?: UserData;
+    page?: PageContext;
+    ad?: AdContext;
+}
+interface UserData {
+    email?: string;
+    phone_number?: string;
+    external_id?: string;
+    ttp?: string;
+    ttclid?: string;
+    locale?: string;
+}
+interface PageContext {
+    url?: string;
+    referrer?: string;
+}
+interface AdContext {
+    callback?: string;
+}
+interface ResponseBody {
+    code: number;
+    message: string;
+    data?: Record<string, unknown>;
+}
+type StandardEventName = 'ViewContent' | 'ClickButton' | 'Search' | 'AddToWishlist' | 'AddToCart' | 'InitiateCheckout' | 'AddPaymentInfo' | 'CompletePayment' | 'PlaceAnOrder' | 'Contact' | 'Download' | 'SubmitForm' | 'CompleteRegistration' | 'Subscribe' | (string & {});
+
+type index_AdContext = AdContext;
+type index_Config = Config;
+type index_Destination = Destination;
+type index_Env = Env;
+type index_EventContext = EventContext;
+type index_EventData = EventData;
+type index_InitFn = InitFn;
+type index_InitSettings = InitSettings;
+type index_Mapping = Mapping;
+type index_PageContext = PageContext;
+type index_PartialConfig = PartialConfig;
+type index_PushEvents = PushEvents;
+type index_PushFn = PushFn;
+type index_RequestBody = RequestBody;
+type index_ResponseBody = ResponseBody;
+type index_Rule = Rule;
+type index_Rules = Rules;
+type index_Settings = Settings;
+type index_StandardEventName = StandardEventName;
+type index_Types = Types;
+type index_UserData = UserData;
+declare namespace index {
+  export type { index_AdContext as AdContext, index_Config as Config, index_Destination as Destination, index_Env as Env, index_EventContext as EventContext, index_EventData as EventData, index_InitFn as InitFn, index_InitSettings as InitSettings, index_Mapping as Mapping, index_PageContext as PageContext, index_PartialConfig as PartialConfig, index_PushEvents as PushEvents, index_PushFn as PushFn, index_RequestBody as RequestBody, index_ResponseBody as ResponseBody, index_Rule as Rule, index_Rules as Rules, index_Settings as Settings, index_StandardEventName as StandardEventName, index_Types as Types, index_UserData as UserData };
+}
+
+declare const destinationTikTok: Destination;
+
+export { index as DestinationTikTok, destinationTikTok as default, destinationTikTok };

package/dist/index.js

@@ -0,0 +1 @@
+"use strict";var mod,__defProp=Object.defineProperty,__getOwnPropDesc=Object.getOwnPropertyDescriptor,__getOwnPropNames=Object.getOwnPropertyNames,__hasOwnProp=Object.prototype.hasOwnProperty,index_exports={};((target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:!0})})(index_exports,{DestinationTikTok:()=>types_exports,default:()=>index_default,destinationTikTok:()=>destinationTikTok}),module.exports=(mod=index_exports,((to,from,except,desc)=>{if(from&&"object"==typeof from||"function"==typeof from)for(let key of __getOwnPropNames(from))__hasOwnProp.call(to,key)||key===except||__defProp(to,key,{get:()=>from[key],enumerable:!(desc=__getOwnPropDesc(from,key))||desc.enumerable});return to})(__defProp({},"__esModule",{value:!0}),mod));var import_core=require("@walkeros/core"),import_server_core2=require("@walkeros/server-core"),import_server_core=require("@walkeros/server-core"),keysToHash=["email","phone_number","external_id"];async function hashUserData(userData,doNotHash=[]){const entries=await Promise.all(Object.entries(userData).map(async([key,value])=>void 0===value?[key,value]:function(key,doNotHash=[]){return keysToHash.includes(key)&&!doNotHash.includes(key)}(key,doNotHash)?[key,await(0,import_server_core.getHashServer)(String(value))]:[key,value]));return Object.fromEntries(entries)}var types_exports={},destinationTikTok={type:"tiktok",config:{},async init({config:partialConfig,logger:logger}){const config=function(partialConfig={},logger){const settings=partialConfig.settings||{},{accessToken:accessToken,pixelCode:pixelCode}=settings;accessToken||logger.throw("Config settings accessToken missing"),pixelCode||logger.throw("Config settings pixelCode missing");const settingsConfig={partner_name:"walkerOS",...settings,accessToken:accessToken,pixelCode:pixelCode};return{...partialConfig,settings:settingsConfig}}(partialConfig,logger);return config},push:async(event,context)=>await async function(event,{config:config,rule:rule,data:data,collector:collector,env:env,logger:logger}){const{accessToken:accessToken,pixelCode:pixelCode,doNotHash:doNotHash,test_event_code:test_event_code,url:url="https://business-api.tiktok.com/open_api/v1.3/event/track/",user_data:user_data,partner_name:partner_name}=config.settings,eventData=(0,import_core.isObject)(data)?data:{},configData=config.data?await(0,import_core.getMappingValue)(event,config.data):{},userDataCustom=user_data?await(0,import_core.getMappingValue)(event,{map:user_data}):{},userData={...(0,import_core.isObject)(configData)&&(0,import_core.isObject)(configData.user_data)?configData.user_data:{},...(0,import_core.isObject)(userDataCustom)?userDataCustom:{},...(0,import_core.isObject)(eventData.user_data)?eventData.user_data:{}},properties={};if((0,import_core.isObject)(eventData))for(const[key,value]of Object.entries(eventData))"user_data"!==key&&(properties[key]=value);const hashedUserData=await hashUserData(userData,doNotHash),context={};Object.keys(hashedUserData).length>0&&(context.user=hashedUserData),context.page={url:event.source.id};const tiktokEvent={event:event.name,event_id:event.id,timestamp:new Date(event.timestamp).toISOString(),context:context,properties:properties},body={pixel_code:pixelCode,partner_name:partner_name,data:[tiktokEvent]};test_event_code&&(body.test_event_code=test_event_code),logger.debug("Calling TikTok Events API",{endpoint:url,method:"POST",eventName:tiktokEvent.event,eventId:tiktokEvent.event_id});const sendServerFn=(null==env?void 0:env.sendServer)||import_server_core2.sendServer,result=await sendServerFn(url,JSON.stringify(body),{headers:{"Access-Token":accessToken,"Content-Type":"application/json"}});logger.debug("TikTok API response",{ok:!(0,import_core.isObject)(result)||result.ok}),(0,import_core.isObject)(result)&&!1===result.ok&&logger.throw(`TikTok API error: ${JSON.stringify(result)}`)}(event,context)},index_default=destinationTikTok;//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/config.ts","../src/push.ts","../src/hash.ts","../src/types/index.ts"],"sourcesContent":["import type { Destination } from './types';\nimport { getConfig } from './config';\nimport { push } from './push';\n\n// Types\nexport * as DestinationTikTok from './types';\n\nexport const destinationTikTok: Destination = {\n  type: 'tiktok',\n\n  config: {},\n\n  async init({ config: partialConfig, logger }) {\n    const config = getConfig(partialConfig, logger);\n    return config;\n  },\n\n  async push(event, context) {\n    return await push(event, context);\n  },\n};\n\nexport default destinationTikTok;\n","import type { Config, Settings, PartialConfig } from './types';\nimport type { Logger } from '@walkeros/core';\n\nexport function getConfig(\n  partialConfig: PartialConfig = {},\n  logger: Logger.Instance,\n): Config {\n  const settings = (partialConfig.settings || {}) as Partial<Settings>;\n  const { accessToken, pixelCode } = settings;\n\n  if (!accessToken) logger.throw('Config settings accessToken missing');\n  if (!pixelCode) logger.throw('Config settings pixelCode missing');\n\n  const settingsConfig: Settings = {\n    partner_name: 'walkerOS',\n    ...settings,\n    accessToken,\n    pixelCode,\n  };\n\n  return { ...partialConfig, settings: settingsConfig };\n}\n","import type {\n  EventData,\n  EventContext,\n  PushFn,\n  RequestBody,\n  UserData,\n  Env,\n} from './types';\nimport { getMappingValue, isObject } from '@walkeros/core';\nimport { sendServer } from '@walkeros/server-core';\nimport { hashUserData } from './hash';\n\nexport const push: PushFn = async function (\n  event,\n  { config, rule, data, collector, env, logger },\n) {\n  const {\n    accessToken,\n    pixelCode,\n    doNotHash,\n    test_event_code,\n    url = 'https://business-api.tiktok.com/open_api/v1.3/event/track/',\n    user_data,\n    partner_name,\n  } = config.settings as import('./types').Settings;\n\n  const eventData = isObject(data) ? data : {};\n  const configData = config.data\n    ? await getMappingValue(event, config.data)\n    : {};\n  const userDataCustom = user_data\n    ? await getMappingValue(event, { map: user_data })\n    : {};\n\n  // Build user data from multiple sources\n  const userData: UserData = {\n    // Destination config data\n    ...(isObject(configData) && isObject(configData.user_data)\n      ? (configData.user_data as UserData)\n      : {}),\n    // Custom user_data from settings\n    ...(isObject(userDataCustom) ? (userDataCustom as UserData) : {}),\n    // Event mapping data\n    ...(isObject(eventData.user_data) ? (eventData.user_data as UserData) : {}),\n  };\n\n  // Build properties from event data, excluding user_data\n  const properties: Record<string, unknown> = {};\n  if (isObject(eventData)) {\n    for (const [key, value] of Object.entries(eventData)) {\n      if (key !== 'user_data') {\n        properties[key] = value;\n      }\n    }\n  }\n\n  // Hash identity fields\n  const hashedUserData = await hashUserData(userData, doNotHash);\n\n  // Build context\n  const context: EventContext = {};\n\n  // Add user data if non-empty\n  if (Object.keys(hashedUserData).length > 0) {\n    context.user = hashedUserData;\n  }\n\n  // Page context from event source\n  context.page = {\n    url: event.source.id,\n  };\n\n  // Build event data\n  const tiktokEvent: EventData = {\n    event: event.name,\n    event_id: event.id,\n    timestamp: new Date(event.timestamp).toISOString(),\n    context,\n    properties,\n  };\n\n  // Build request body\n  const body: RequestBody = {\n    pixel_code: pixelCode,\n    partner_name,\n    data: [tiktokEvent],\n  };\n\n  // Test event code\n  if (test_event_code) body.test_event_code = test_event_code;\n\n  logger.debug('Calling TikTok Events API', {\n    endpoint: url,\n    method: 'POST',\n    eventName: tiktokEvent.event,\n    eventId: tiktokEvent.event_id,\n  });\n\n  const sendServerFn = (env as Env)?.sendServer || sendServer;\n  const result = await sendServerFn(url, JSON.stringify(body), {\n    headers: {\n      'Access-Token': accessToken,\n      'Content-Type': 'application/json',\n    },\n  });\n\n  logger.debug('TikTok API response', {\n    ok: isObject(result) ? result.ok : true,\n  });\n\n  if (isObject(result) && result.ok === false) {\n    logger.throw(`TikTok API error: ${JSON.stringify(result)}`);\n  }\n};\n","import type { UserData } from './types';\nimport { getHashServer } from '@walkeros/server-core';\n\nconst keysToHash = ['email', 'phone_number', 'external_id'];\n\nfunction shouldBeHashed(key: string, doNotHash: string[] = []): boolean {\n  return keysToHash.includes(key) && !doNotHash.includes(key);\n}\n\nexport async function hashUserData(\n  userData: UserData,\n  doNotHash: string[] = [],\n): Promise<UserData> {\n  const entries = await Promise.all(\n    Object.entries(userData).map(async ([key, value]) => {\n      if (value === undefined) return [key, value];\n      if (shouldBeHashed(key, doNotHash)) {\n        return [key, await getHashServer(String(value))];\n      }\n      return [key, value];\n    }),\n  );\n\n  return Object.fromEntries(entries) as UserData;\n}\n","import type {\n  Mapping as WalkerOSMapping,\n  Destination as CoreDestination,\n} from '@walkeros/core';\nimport type { DestinationServer, sendServer } from '@walkeros/server-core';\n\nexport interface Settings {\n  pixelCode: string;\n  accessToken: string;\n  url?: string;\n  test_event_code?: string;\n  doNotHash?: string[];\n  user_data?: WalkerOSMapping.Map;\n  partner_name?: string;\n}\n\nexport type InitSettings = Partial<Settings>;\n\nexport interface Mapping {}\n\nexport interface Env extends DestinationServer.Env {\n  sendServer?: typeof sendServer;\n}\n\nexport type Types = CoreDestination.Types<Settings, Mapping, Env, InitSettings>;\n\nexport interface Destination extends DestinationServer.Destination<Types> {\n  init: DestinationServer.InitFn<Types>;\n}\n\nexport type Config = {\n  settings: Settings;\n} & DestinationServer.Config<Types>;\n\nexport type InitFn = DestinationServer.InitFn<Types>;\nexport type PushFn = DestinationServer.PushFn<Types>;\n\nexport type PartialConfig = DestinationServer.PartialConfig<Types>;\n\nexport type PushEvents = DestinationServer.PushEvents<Mapping>;\n\nexport type Rule = WalkerOSMapping.Rule<Mapping>;\nexport type Rules = WalkerOSMapping.Rules<Rule>;\n\n// TikTok Events API Request Body\nexport interface RequestBody {\n  pixel_code: string;\n  partner_name?: string;\n  test_event_code?: string;\n  data: EventData[];\n}\n\n// Individual event in the data array\nexport interface EventData {\n  event: string;\n  event_id: string;\n  timestamp: string;\n  context?: EventContext;\n  properties?: Record<string, unknown>;\n}\n\n// Context object within each event\nexport interface EventContext {\n  ip?: string;\n  user_agent?: string;\n  user?: UserData;\n  page?: PageContext;\n  ad?: AdContext;\n}\n\n// User identity fields\nexport interface UserData {\n  email?: string;\n  phone_number?: string;\n  external_id?: string;\n  ttp?: string;\n  ttclid?: string;\n  locale?: string;\n}\n\n// Page context\nexport interface PageContext {\n  url?: string;\n  referrer?: string;\n}\n\n// Ad attribution context\nexport interface AdContext {\n  callback?: string;\n}\n\n// TikTok API response\nexport interface ResponseBody {\n  code: number;\n  message: string;\n  data?: Record<string, unknown>;\n}\n\n// Standard TikTok event names\nexport type StandardEventName =\n  | 'ViewContent'\n  | 'ClickButton'\n  | 'Search'\n  | 'AddToWishlist'\n  | 'AddToCart'\n  | 'InitiateCheckout'\n  | 'AddPaymentInfo'\n  | 'CompletePayment'\n  | 'PlaceAnOrder'\n  | 'Contact'\n  | 'Download'\n  | 'SubmitForm'\n  | 'CompleteRegistration'\n  | 'Subscribe'\n  | (string & {});\n"],"mappings":"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","names":["import_server_core"]}

package/dist/index.mjs

@@ -0,0 +1 @@
+import{getMappingValue,isObject}from"@walkeros/core";import{sendServer}from"@walkeros/server-core";import{getHashServer}from"@walkeros/server-core";var keysToHash=["email","phone_number","external_id"];async function hashUserData(userData,doNotHash=[]){const entries=await Promise.all(Object.entries(userData).map(async([key,value])=>void 0===value?[key,value]:function(key,doNotHash=[]){return keysToHash.includes(key)&&!doNotHash.includes(key)}(key,doNotHash)?[key,await getHashServer(String(value))]:[key,value]));return Object.fromEntries(entries)}var types_exports={},destinationTikTok={type:"tiktok",config:{},async init({config:partialConfig,logger:logger}){const config=function(partialConfig={},logger){const settings=partialConfig.settings||{},{accessToken:accessToken,pixelCode:pixelCode}=settings;accessToken||logger.throw("Config settings accessToken missing"),pixelCode||logger.throw("Config settings pixelCode missing");const settingsConfig={partner_name:"walkerOS",...settings,accessToken:accessToken,pixelCode:pixelCode};return{...partialConfig,settings:settingsConfig}}(partialConfig,logger);return config},push:async(event,context)=>await async function(event,{config:config,rule:rule,data:data,collector:collector,env:env,logger:logger}){const{accessToken:accessToken,pixelCode:pixelCode,doNotHash:doNotHash,test_event_code:test_event_code,url:url="https://business-api.tiktok.com/open_api/v1.3/event/track/",user_data:user_data,partner_name:partner_name}=config.settings,eventData=isObject(data)?data:{},configData=config.data?await getMappingValue(event,config.data):{},userDataCustom=user_data?await getMappingValue(event,{map:user_data}):{},userData={...isObject(configData)&&isObject(configData.user_data)?configData.user_data:{},...isObject(userDataCustom)?userDataCustom:{},...isObject(eventData.user_data)?eventData.user_data:{}},properties={};if(isObject(eventData))for(const[key,value]of Object.entries(eventData))"user_data"!==key&&(properties[key]=value);const hashedUserData=await hashUserData(userData,doNotHash),context={};Object.keys(hashedUserData).length>0&&(context.user=hashedUserData),context.page={url:event.source.id};const tiktokEvent={event:event.name,event_id:event.id,timestamp:new Date(event.timestamp).toISOString(),context:context,properties:properties},body={pixel_code:pixelCode,partner_name:partner_name,data:[tiktokEvent]};test_event_code&&(body.test_event_code=test_event_code),logger.debug("Calling TikTok Events API",{endpoint:url,method:"POST",eventName:tiktokEvent.event,eventId:tiktokEvent.event_id});const sendServerFn=(null==env?void 0:env.sendServer)||sendServer,result=await sendServerFn(url,JSON.stringify(body),{headers:{"Access-Token":accessToken,"Content-Type":"application/json"}});logger.debug("TikTok API response",{ok:!isObject(result)||result.ok}),isObject(result)&&!1===result.ok&&logger.throw(`TikTok API error: ${JSON.stringify(result)}`)}(event,context)},index_default=destinationTikTok;export{types_exports as DestinationTikTok,index_default as default,destinationTikTok};//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts","../src/push.ts","../src/hash.ts","../src/types/index.ts","../src/index.ts"],"sourcesContent":["import type { Config, Settings, PartialConfig } from './types';\nimport type { Logger } from '@walkeros/core';\n\nexport function getConfig(\n  partialConfig: PartialConfig = {},\n  logger: Logger.Instance,\n): Config {\n  const settings = (partialConfig.settings || {}) as Partial<Settings>;\n  const { accessToken, pixelCode } = settings;\n\n  if (!accessToken) logger.throw('Config settings accessToken missing');\n  if (!pixelCode) logger.throw('Config settings pixelCode missing');\n\n  const settingsConfig: Settings = {\n    partner_name: 'walkerOS',\n    ...settings,\n    accessToken,\n    pixelCode,\n  };\n\n  return { ...partialConfig, settings: settingsConfig };\n}\n","import type {\n  EventData,\n  EventContext,\n  PushFn,\n  RequestBody,\n  UserData,\n  Env,\n} from './types';\nimport { getMappingValue, isObject } from '@walkeros/core';\nimport { sendServer } from '@walkeros/server-core';\nimport { hashUserData } from './hash';\n\nexport const push: PushFn = async function (\n  event,\n  { config, rule, data, collector, env, logger },\n) {\n  const {\n    accessToken,\n    pixelCode,\n    doNotHash,\n    test_event_code,\n    url = 'https://business-api.tiktok.com/open_api/v1.3/event/track/',\n    user_data,\n    partner_name,\n  } = config.settings as import('./types').Settings;\n\n  const eventData = isObject(data) ? data : {};\n  const configData = config.data\n    ? await getMappingValue(event, config.data)\n    : {};\n  const userDataCustom = user_data\n    ? await getMappingValue(event, { map: user_data })\n    : {};\n\n  // Build user data from multiple sources\n  const userData: UserData = {\n    // Destination config data\n    ...(isObject(configData) && isObject(configData.user_data)\n      ? (configData.user_data as UserData)\n      : {}),\n    // Custom user_data from settings\n    ...(isObject(userDataCustom) ? (userDataCustom as UserData) : {}),\n    // Event mapping data\n    ...(isObject(eventData.user_data) ? (eventData.user_data as UserData) : {}),\n  };\n\n  // Build properties from event data, excluding user_data\n  const properties: Record<string, unknown> = {};\n  if (isObject(eventData)) {\n    for (const [key, value] of Object.entries(eventData)) {\n      if (key !== 'user_data') {\n        properties[key] = value;\n      }\n    }\n  }\n\n  // Hash identity fields\n  const hashedUserData = await hashUserData(userData, doNotHash);\n\n  // Build context\n  const context: EventContext = {};\n\n  // Add user data if non-empty\n  if (Object.keys(hashedUserData).length > 0) {\n    context.user = hashedUserData;\n  }\n\n  // Page context from event source\n  context.page = {\n    url: event.source.id,\n  };\n\n  // Build event data\n  const tiktokEvent: EventData = {\n    event: event.name,\n    event_id: event.id,\n    timestamp: new Date(event.timestamp).toISOString(),\n    context,\n    properties,\n  };\n\n  // Build request body\n  const body: RequestBody = {\n    pixel_code: pixelCode,\n    partner_name,\n    data: [tiktokEvent],\n  };\n\n  // Test event code\n  if (test_event_code) body.test_event_code = test_event_code;\n\n  logger.debug('Calling TikTok Events API', {\n    endpoint: url,\n    method: 'POST',\n    eventName: tiktokEvent.event,\n    eventId: tiktokEvent.event_id,\n  });\n\n  const sendServerFn = (env as Env)?.sendServer || sendServer;\n  const result = await sendServerFn(url, JSON.stringify(body), {\n    headers: {\n      'Access-Token': accessToken,\n      'Content-Type': 'application/json',\n    },\n  });\n\n  logger.debug('TikTok API response', {\n    ok: isObject(result) ? result.ok : true,\n  });\n\n  if (isObject(result) && result.ok === false) {\n    logger.throw(`TikTok API error: ${JSON.stringify(result)}`);\n  }\n};\n","import type { UserData } from './types';\nimport { getHashServer } from '@walkeros/server-core';\n\nconst keysToHash = ['email', 'phone_number', 'external_id'];\n\nfunction shouldBeHashed(key: string, doNotHash: string[] = []): boolean {\n  return keysToHash.includes(key) && !doNotHash.includes(key);\n}\n\nexport async function hashUserData(\n  userData: UserData,\n  doNotHash: string[] = [],\n): Promise<UserData> {\n  const entries = await Promise.all(\n    Object.entries(userData).map(async ([key, value]) => {\n      if (value === undefined) return [key, value];\n      if (shouldBeHashed(key, doNotHash)) {\n        return [key, await getHashServer(String(value))];\n      }\n      return [key, value];\n    }),\n  );\n\n  return Object.fromEntries(entries) as UserData;\n}\n","import type {\n  Mapping as WalkerOSMapping,\n  Destination as CoreDestination,\n} from '@walkeros/core';\nimport type { DestinationServer, sendServer } from '@walkeros/server-core';\n\nexport interface Settings {\n  pixelCode: string;\n  accessToken: string;\n  url?: string;\n  test_event_code?: string;\n  doNotHash?: string[];\n  user_data?: WalkerOSMapping.Map;\n  partner_name?: string;\n}\n\nexport type InitSettings = Partial<Settings>;\n\nexport interface Mapping {}\n\nexport interface Env extends DestinationServer.Env {\n  sendServer?: typeof sendServer;\n}\n\nexport type Types = CoreDestination.Types<Settings, Mapping, Env, InitSettings>;\n\nexport interface Destination extends DestinationServer.Destination<Types> {\n  init: DestinationServer.InitFn<Types>;\n}\n\nexport type Config = {\n  settings: Settings;\n} & DestinationServer.Config<Types>;\n\nexport type InitFn = DestinationServer.InitFn<Types>;\nexport type PushFn = DestinationServer.PushFn<Types>;\n\nexport type PartialConfig = DestinationServer.PartialConfig<Types>;\n\nexport type PushEvents = DestinationServer.PushEvents<Mapping>;\n\nexport type Rule = WalkerOSMapping.Rule<Mapping>;\nexport type Rules = WalkerOSMapping.Rules<Rule>;\n\n// TikTok Events API Request Body\nexport interface RequestBody {\n  pixel_code: string;\n  partner_name?: string;\n  test_event_code?: string;\n  data: EventData[];\n}\n\n// Individual event in the data array\nexport interface EventData {\n  event: string;\n  event_id: string;\n  timestamp: string;\n  context?: EventContext;\n  properties?: Record<string, unknown>;\n}\n\n// Context object within each event\nexport interface EventContext {\n  ip?: string;\n  user_agent?: string;\n  user?: UserData;\n  page?: PageContext;\n  ad?: AdContext;\n}\n\n// User identity fields\nexport interface UserData {\n  email?: string;\n  phone_number?: string;\n  external_id?: string;\n  ttp?: string;\n  ttclid?: string;\n  locale?: string;\n}\n\n// Page context\nexport interface PageContext {\n  url?: string;\n  referrer?: string;\n}\n\n// Ad attribution context\nexport interface AdContext {\n  callback?: string;\n}\n\n// TikTok API response\nexport interface ResponseBody {\n  code: number;\n  message: string;\n  data?: Record<string, unknown>;\n}\n\n// Standard TikTok event names\nexport type StandardEventName =\n  | 'ViewContent'\n  | 'ClickButton'\n  | 'Search'\n  | 'AddToWishlist'\n  | 'AddToCart'\n  | 'InitiateCheckout'\n  | 'AddPaymentInfo'\n  | 'CompletePayment'\n  | 'PlaceAnOrder'\n  | 'Contact'\n  | 'Download'\n  | 'SubmitForm'\n  | 'CompleteRegistration'\n  | 'Subscribe'\n  | (string & {});\n","import type { Destination } from './types';\nimport { getConfig } from './config';\nimport { push } from './push';\n\n// Types\nexport * as DestinationTikTok from './types';\n\nexport const destinationTikTok: Destination = {\n  type: 'tiktok',\n\n  config: {},\n\n  async init({ config: partialConfig, logger }) {\n    const config = getConfig(partialConfig, logger);\n    return config;\n  },\n\n  async push(event, context) {\n    return await push(event, context);\n  },\n};\n\nexport default destinationTikTok;\n"],"mappings":"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","names":[]}

package/dist/walkerOS.json

@@ -0,0 +1,508 @@
+{
+  "$meta": {
+    "package": "@walkeros/server-destination-tiktok",
+    "version": "0.1.0",
+    "type": "destination",
+    "platform": [
+      "server"
+    ],
+    "docs": "https://www.walkeros.io/docs/destinations/server/tiktok",
+    "source": "https://github.com/elbwalker/walkerOS/tree/main/packages/server/destinations/tiktok/src"
+  },
+  "schemas": {
+    "mapping": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "type": "object",
+      "properties": {},
+      "additionalProperties": false
+    },
+    "settings": {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "type": "object",
+      "properties": {
+        "pixelCode": {
+          "type": "string",
+          "minLength": 1,
+          "description": "TikTok Pixel Code from Events Manager (like C0ABCDEF12345)"
+        },
+        "accessToken": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Events API access token from TikTok Events Manager"
+        },
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "Custom Events API endpoint URL"
+        },
+        "test_event_code": {
+          "type": "string",
+          "description": "Test event code for debugging in TikTok Events Manager (like TEST12345)"
+        },
+        "doNotHash": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "User data fields to skip hashing (like ['email', 'phone_number'])"
+        },
+        "user_data": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Mapping for user data fields (like { email: 'user.email' })"
+        },
+        "partner_name": {
+          "type": "string",
+          "description": "Partner name for TikTok attribution"
+        }
+      },
+      "required": [
+        "pixelCode",
+        "accessToken"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "examples": {
+    "env": {
+      "push": {
+        "sendServer": {
+          "$code": "async function(e,t,a){return{ok:!0,data:{code:0,message:\"OK\"}}}"
+        }
+      },
+      "simulation": [
+        "sendServer"
+      ]
+    },
+    "step": {
+      "addToCart": {
+        "in": {
+          "name": "product add",
+          "data": {
+            "id": "SKU-B2",
+            "name": "Running Shoes",
+            "price": 89.99,
+            "color": "blue"
+          },
+          "context": {
+            "shopping": [
+              "intent",
+              0
+            ]
+          },
+          "globals": {
+            "pagegroup": "shop"
+          },
+          "custom": {
+            "completely": "random"
+          },
+          "user": {
+            "id": "us3r",
+            "device": "c00k13",
+            "session": "s3ss10n"
+          },
+          "nested": [
+            {
+              "entity": "product",
+              "data": {
+                "id": "SKU-B2",
+                "name": "Running Shoes",
+                "price": 89.99,
+                "quantity": 1
+              }
+            }
+          ],
+          "consent": {
+            "functional": true
+          },
+          "id": "1700000901000-gr0up-1",
+          "trigger": "click",
+          "entity": "product",
+          "action": "add",
+          "timestamp": 1700000901000,
+          "timing": 3.14,
+          "group": "gr0up",
+          "count": 1,
+          "version": {
+            "source": "3.2.0",
+            "tagging": 1
+          },
+          "source": {
+            "type": "server",
+            "id": "https://shop.example.com/products/running-shoes",
+            "previous_id": ""
+          }
+        },
+        "mapping": {
+          "name": "AddToCart",
+          "data": {
+            "map": {
+              "content_type": {
+                "value": "product"
+              },
+              "value": "data.price",
+              "currency": {
+                "value": "EUR"
+              },
+              "contents": {
+                "loop": [
+                  "nested",
+                  {
+                    "condition": {
+                      "$code": "e=>h(e)&&\"product\"===e.entity"
+                    },
+                    "map": {
+                      "content_id": "data.id",
+                      "content_name": "data.name",
+                      "quantity": {
+                        "key": "data.quantity",
+                        "value": 1
+                      },
+                      "price": "data.price"
+                    }
+                  }
+                ]
+              }
+            }
+          }
+        },
+        "out": {
+          "pixel_code": "PIXEL_CODE",
+          "partner_name": "walkerOS",
+          "data": [
+            {
+              "event": "AddToCart",
+              "event_id": "1700000901000-gr0up-1",
+              "timestamp": "2023-11-14T22:28:21.000Z",
+              "context": {
+                "page": {
+                  "url": "https://shop.example.com/products/running-shoes"
+                }
+              },
+              "properties": {
+                "content_type": "product",
+                "value": 89.99,
+                "currency": "EUR",
+                "contents": [
+                  {
+                    "content_id": "SKU-B2",
+                    "content_name": "Running Shoes",
+                    "quantity": 1,
+                    "price": 89.99
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      },
+      "lead": {
+        "in": {
+          "name": "form submit",
+          "data": {
+            "type": "newsletter"
+          },
+          "context": {
+            "dev": [
+              "test",
+              1
+            ]
+          },
+          "globals": {
+            "lang": "elb"
+          },
+          "custom": {
+            "completely": "random"
+          },
+          "user": {
+            "email": "user@example.com"
+          },
+          "nested": [
+            {
+              "entity": "child",
+              "data": {
+                "is": "subordinated"
+              },
+              "nested": [],
+              "context": {
+                "element": [
+                  "child",
+                  0
+                ]
+              }
+            }
+          ],
+          "consent": {
+            "functional": true
+          },
+          "id": "1700000903000-gr0up-1",
+          "trigger": "test",
+          "entity": "form",
+          "action": "submit",
+          "timestamp": 1700000903000,
+          "timing": 3.14,
+          "group": "gr0up",
+          "count": 1,
+          "version": {
+            "source": "3.2.0",
+            "tagging": 1
+          },
+          "source": {
+            "type": "server",
+            "id": "https://example.com/contact",
+            "previous_id": ""
+          }
+        },
+        "mapping": {
+          "name": "SubmitForm",
+          "data": {
+            "map": {
+              "user_data": {
+                "map": {
+                  "email": "user.email"
+                }
+              }
+            }
+          }
+        },
+        "out": {
+          "pixel_code": "PIXEL_CODE",
+          "partner_name": "walkerOS",
+          "data": [
+            {
+              "event": "SubmitForm",
+              "event_id": "1700000903000-gr0up-1",
+              "timestamp": "2023-11-14T22:28:23.000Z",
+              "context": {
+                "user": {
+                  "email": "user@example.com"
+                },
+                "page": {
+                  "url": "https://example.com/contact"
+                }
+              },
+              "properties": {}
+            }
+          ]
+        }
+      },
+      "pageView": {
+        "in": {
+          "name": "page view",
+          "data": {
+            "domain": "www.example.com",
+            "title": "walkerOS documentation",
+            "referrer": "https://www.walkeros.io/",
+            "search": "?foo=bar",
+            "hash": "#hash",
+            "id": "/docs/"
+          },
+          "context": {
+            "dev": [
+              "test",
+              1
+            ]
+          },
+          "globals": {
+            "pagegroup": "docs"
+          },
+          "custom": {
+            "completely": "random"
+          },
+          "user": {
+            "id": "us3r",
+            "device": "c00k13",
+            "session": "s3ss10n"
+          },
+          "nested": [
+            {
+              "entity": "child",
+              "data": {
+                "is": "subordinated"
+              },
+              "nested": [],
+              "context": {
+                "element": [
+                  "child",
+                  0
+                ]
+              }
+            }
+          ],
+          "consent": {
+            "functional": true
+          },
+          "id": "1700000902000-gr0up-1",
+          "trigger": "load",
+          "entity": "page",
+          "action": "view",
+          "timestamp": 1700000902000,
+          "timing": 3.14,
+          "group": "gr0up",
+          "count": 1,
+          "version": {
+            "source": "3.2.0",
+            "tagging": 1
+          },
+          "source": {
+            "type": "server",
+            "id": "https://example.com/docs/",
+            "previous_id": ""
+          }
+        },
+        "out": {
+          "pixel_code": "PIXEL_CODE",
+          "partner_name": "walkerOS",
+          "data": [
+            {
+              "event": "page view",
+              "event_id": "1700000902000-gr0up-1",
+              "timestamp": "2023-11-14T22:28:22.000Z",
+              "context": {
+                "page": {
+                  "url": "https://example.com/docs/"
+                }
+              },
+              "properties": {}
+            }
+          ]
+        }
+      },
+      "purchase": {
+        "in": {
+          "name": "order complete",
+          "data": {
+            "id": "ORD-300",
+            "total": 249.99,
+            "currency": "EUR"
+          },
+          "context": {
+            "shopping": [
+              "complete",
+              0
+            ]
+          },
+          "globals": {
+            "pagegroup": "shop"
+          },
+          "custom": {
+            "completely": "random"
+          },
+          "user": {
+            "id": "user-123",
+            "device": "device-456"
+          },
+          "nested": [
+            {
+              "entity": "product",
+              "data": {
+                "id": "SKU-A1",
+                "name": "Widget Pro",
+                "price": 124.99,
+                "quantity": 2
+              }
+            }
+          ],
+          "consent": {
+            "functional": true
+          },
+          "id": "1700000900000-gr0up-1",
+          "trigger": "load",
+          "entity": "order",
+          "action": "complete",
+          "timestamp": 1700000900000,
+          "timing": 3.14,
+          "group": "gr0up",
+          "count": 1,
+          "version": {
+            "source": "3.2.0",
+            "tagging": 1
+          },
+          "source": {
+            "type": "server",
+            "id": "https://shop.example.com/checkout/complete",
+            "previous_id": ""
+          }
+        },
+        "mapping": {
+          "name": "CompletePayment",
+          "data": {
+            "map": {
+              "value": "data.total",
+              "currency": {
+                "key": "data.currency",
+                "value": "EUR"
+              },
+              "order_id": "data.id",
+              "content_type": {
+                "value": "product"
+              },
+              "contents": {
+                "loop": [
+                  "nested",
+                  {
+                    "condition": {
+                      "$code": "e=>h(e)&&\"product\"===e.entity"
+                    },
+                    "map": {
+                      "content_id": "data.id",
+                      "content_name": "data.name",
+                      "quantity": {
+                        "key": "data.quantity",
+                        "value": 1
+                      },
+                      "price": "data.price"
+                    }
+                  }
+                ]
+              },
+              "user_data": {
+                "map": {
+                  "external_id": "user.id"
+                }
+              }
+            }
+          }
+        },
+        "out": {
+          "pixel_code": "PIXEL_CODE",
+          "partner_name": "walkerOS",
+          "data": [
+            {
+              "event": "CompletePayment",
+              "event_id": "1700000900000-gr0up-1",
+              "timestamp": "2023-11-14T22:28:20.000Z",
+              "context": {
+                "user": {
+                  "external_id": "user-123"
+                },
+                "page": {
+                  "url": "https://shop.example.com/checkout/complete"
+                }
+              },
+              "properties": {
+                "value": 249.99,
+                "currency": "EUR",
+                "order_id": "ORD-300",
+                "content_type": "product",
+                "contents": [
+                  {
+                    "content_id": "SKU-A1",
+                    "content_name": "Widget Pro",
+                    "quantity": 2,
+                    "price": 124.99
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  }
+}