@shware/analytics 5.1.1 → 6.0.0

package/dist/schema/index.mjs

@@ -35,11 +35,6 @@ const tagsSchema = object({
 	language: optional(string()),
 	time_zone: optional(string()),
 	source_url: optional(string()),
-	source: optional(enum$1([
-		"web",
-		"app",
-		"offline"
-	])),
 	page_referrer: optional(string()),
 	advertising_id: optional(string()),
 	install_referrer: optional(string()),

package/dist/schema/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["_null","_enum"],"sources":["../../src/schema/index.ts"],"sourcesContent":["import {\n  enum as _enum,\n  null as _null,\n  array,\n  boolean,\n  e164,\n  email,\n  iso,\n  maxLength,\n  minLength,\n  number,\n  object,\n  optional,\n  pipe,\n  record,\n  refine,\n  regex,\n  string,\n  toLowerCase,\n  toUpperCase,\n  transform,\n  trim,\n  union,\n  url,\n  uuid,\n  type z,\n} from 'zod/mini';\nimport type { Environment, Platform } from '../track/types';\n\nconst items = array(\n  record(\n    string().check(trim(), minLength(1), maxLength(128)),\n    union([string().check(maxLength(512)), number(), boolean(), _null()])\n  )\n);\n\nexport const ALL_PLATFORMS = [\n  'ios',\n  'android',\n  'web',\n  'macos',\n  'windows',\n  'linux',\n  'unknown',\n] as const satisfies Platform[];\n\nexport const ALL_ENVIRONMENTS = ['development', 'production'] as const satisfies Environment[];\n\nexport const tagsSchema = object({\n  os: optional(string()),\n  os_name: optional(string()),\n  os_version: optional(string()),\n  browser: optional(string()),\n  browser_name: optional(string()),\n  browser_version: optional(string()),\n  device: optional(string()),\n  device_id: optional(string().check(trim(), minLength(1), maxLength(36))),\n  device_type: optional(string()),\n  device_vendor: optional(string()),\n  device_pixel_ratio: optional(number()),\n  screen_width: optional(number()),\n  screen_height: optional(number()),\n  screen_resolution: optional(\n    pipe(\n      string().check(regex(/^\\d+x\\d+$/)),\n      transform((v) => v as `${number}x${number}`)\n    )\n  ),\n  release: optional(string()),\n  language: optional(string()),\n  time_zone: optional(string()),\n  source_url: optional(string()),\n  source: optional(_enum(['web', 'app', 'offline'])),\n  page_referrer: optional(string()),\n  // app info\n  advertising_id: optional(string()),\n  install_referrer: optional(string()),\n  // Meta Ads\n  fbc: optional(string()),\n  fbp: optional(string()),\n  fbclid: optional(string()),\n  ad_id: optional(string()),\n  ad_name: optional(string()),\n  adset_id: optional(string()),\n  adset_name: optional(string()),\n  campaign_id: optional(string()),\n  campaign_name: optional(string()),\n  placement: optional(string()),\n  site_source_name: optional(string()),\n  // Google Ads\n  gclid: optional(string()),\n  gclsrc: optional(string()),\n  gad_source: optional(string()),\n  gad_campaignid: optional(string()),\n  // Reddit ads\n  rdt_cid: optional(string()),\n  rdt_uuid: optional(string()),\n  // click ids\n  dclid: optional(string()),\n  ko_click_id: optional(string()),\n  li_fat_id: optional(string()),\n  msclkid: optional(string()),\n  sccid: optional(string()),\n  ttclid: optional(string()),\n  twclid: optional(string()),\n  wbraid: optional(string()),\n  yclid: optional(string()),\n  // utm params\n  utm_source: optional(string()),\n  utm_medium: optional(string()),\n  utm_campaign: optional(string()),\n  utm_term: optional(string()),\n  utm_content: optional(string()),\n  utm_id: optional(string()),\n  utm_source_platform: optional(string()),\n  utm_creative_format: optional(string()),\n  utm_marketing_tactic: optional(string()),\n});\n\nexport const propertiesSchema = optional(\n  record(\n    string().check(trim(), minLength(1), maxLength(128)),\n    union([string().check(maxLength(512)), number(), boolean(), _null(), items])\n  ).check(refine((data) => Object.keys(data).length <= 64))\n);\n\nexport const createTrackEventSchema = array(\n  object({\n    name: string().check(trim(), minLength(1), maxLength(64)),\n    visitor_id: uuid(),\n    session_id: uuid(),\n    platform: _enum(ALL_PLATFORMS),\n    environment: _enum(ALL_ENVIRONMENTS),\n    timestamp: iso.datetime(),\n    tags: tagsSchema,\n    properties: propertiesSchema,\n  })\n).check(minLength(1), maxLength(100));\n\nexport const createVisitorSchema = object({\n  device_id: string().check(trim(), minLength(1), maxLength(36)),\n  platform: _enum(ALL_PLATFORMS),\n  environment: _enum(ALL_ENVIRONMENTS),\n  tags: tagsSchema,\n  properties: optional(\n    record(\n      string().check(trim(), minLength(1), maxLength(128)),\n      union([string().check(maxLength(512)), number(), boolean(), _null()])\n    ).check(refine((data) => Object.keys(data).length <= 64))\n  ),\n});\n\nconst emailValue = pipe(string().check(trim(), toLowerCase(), maxLength(320)), email());\n\n/** E.164: a plus sign (+) prefix, country code, then digits only, no dashes/parens/spaces. */\nconst phoneValue = pipe(string().check(trim()), e164());\n\nconst addressValue = object({\n  first_name: optional(string().check(trim(), maxLength(128))),\n  last_name: optional(string().check(trim(), maxLength(128))),\n  street: optional(string().check(trim(), maxLength(256))),\n  city: optional(string().check(trim(), maxLength(128))),\n  /** User province, state, or region. Example: `Hampshire` */\n  region: optional(string().check(trim(), maxLength(128))),\n  postal_code: optional(string().check(trim(), maxLength(32))),\n  /** 2-letter country code, per the ISO 3166-1 alpha-2 standard. Example: `UK` */\n  country: optional(string().check(trim(), toUpperCase(), regex(/^[A-Z]{2}$/))),\n});\n\n/**\n * User-provided data (UPD) used for enhanced conversions, Customer Match, and demographics.\n * Values are sent unhashed; Google normalizes and hashes them before they reach its servers.\n *\n * Multiple values may be sent to increase the match rate: up to 3 emails, 3 phone numbers, and\n * 2 addresses.\n *\n * @see https://support.google.com/analytics/answer/14078702\n * @see https://support.google.com/google-ads/answer/13258081\n */\nexport const userProvidedDataSchema = object({\n  email: optional(union([emailValue, array(emailValue).check(minLength(1), maxLength(3))])),\n  phone_number: optional(union([phoneValue, array(phoneValue).check(minLength(1), maxLength(3))])),\n  address: optional(union([addressValue, array(addressValue).check(minLength(1), maxLength(2))])),\n});\n\nexport const updateVisitorSchema = object({\n  user_id: optional(uuid()),\n  user_data: optional(userProvidedDataSchema),\n  distinct_id: optional(string().check(trim(), minLength(1), maxLength(36))),\n  tags: tagsSchema,\n  properties: optional(\n    record(\n      string().check(trim(), minLength(1), maxLength(128)),\n      union([string().check(maxLength(512)), number(), boolean(), _null()])\n    ).check(refine((data) => Object.keys(data).length <= 64))\n  ),\n});\n\nexport const createFeedbackSchema = object({\n  name: string().check(minLength(1), maxLength(256)),\n  email: email().check(maxLength(320)),\n  message: string().check(minLength(1), maxLength(65536)),\n});\n\nconst noEmptyString = pipe(\n  string().check(maxLength(256)),\n  transform((v) => (v ? v : undefined))\n);\n\n/**\n * The schema for creating a link.\n * @see https://support.google.com/analytics/answer/10917952\n * */\nexport const createLinkSchema = object({\n  /** The URL that the user is redirected to. */\n  url: url().check(minLength(1), maxLength(1024)), // required\n\n  /**\n   * Campaign ID. Used to identify a specific campaign or promotion. This is a required key for GA4\n   * data import. Use the same IDs that you use when uploading campaign cost data.\n   */\n  utm_id: optional(noEmptyString),\n\n  /** Referrer, for example: google, newsletter4, billboard */\n  utm_source: string().check(minLength(1), maxLength(256)), // required\n\n  /** Marketing medium, for example: cpc, banner, email */\n  utm_medium: string().check(minLength(1), maxLength(256)), // required\n\n  /** Product, slogan, promo code, for example, spring_sale */\n  utm_campaign: string().check(minLength(1), maxLength(256)), // required\n\n  /** Paid keyword */\n  utm_term: optional(noEmptyString),\n\n  /**\n   * Use to differentiate creatives. For example, if you have two call-to-action links within the\n   * same email message, you can use utm_content and set different values for each so you can tell\n   * which version is more effective.\n   */\n  utm_content: optional(noEmptyString),\n\n  /**\n   * The platform responsible for directing traffic to a given Analytics property (such as a buying\n   * platform that sets budgets and targeting criteria or a platform that manages organic traffic\n   * data). For example, Search Ads 360 or Display & Video 360.\n   */\n  utm_source_platform: optional(noEmptyString),\n\n  /**\n   * Type of creative, for example, display, native, video, search, utm_creative_format is not\n   * currently reported in Google Analytics 4 properties.\n   */\n  utm_creative_format: optional(noEmptyString),\n\n  /**\n   * Targeting criteria applied to a campaign, for example, remarketing, prospecting,\n   * utm_marketing_tactic is not currently reported in Google Analytics 4 properties.\n   * */\n  utm_marketing_tactic: optional(noEmptyString),\n});\n\nexport type CreateTrackEventDTO = z.output<typeof createTrackEventSchema>;\nexport type CreateFeedbackDTO = z.output<typeof createFeedbackSchema>;\nexport type CreateLinkDTO = z.output<typeof createLinkSchema>;\nexport type CreateVisitorDTO = z.output<typeof createVisitorSchema>;\nexport type UserProvidedDataDTO = z.output<typeof userProvidedDataSchema>;\nexport type UpdateVisitorDTO = z.output<typeof updateVisitorSchema>;\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["_null","_enum"],"sources":["../../src/schema/index.ts"],"sourcesContent":["import {\n  enum as _enum,\n  null as _null,\n  array,\n  boolean,\n  e164,\n  email,\n  iso,\n  maxLength,\n  minLength,\n  number,\n  object,\n  optional,\n  pipe,\n  record,\n  refine,\n  regex,\n  string,\n  toLowerCase,\n  toUpperCase,\n  transform,\n  trim,\n  union,\n  url,\n  uuid,\n  type z,\n} from 'zod/mini';\nimport type { Environment, Platform } from '../track/types';\n\nconst items = array(\n  record(\n    string().check(trim(), minLength(1), maxLength(128)),\n    union([string().check(maxLength(512)), number(), boolean(), _null()])\n  )\n);\n\nexport const ALL_PLATFORMS = [\n  'ios',\n  'android',\n  'web',\n  'macos',\n  'windows',\n  'linux',\n  'unknown',\n] as const satisfies Platform[];\n\nexport const ALL_ENVIRONMENTS = ['development', 'production'] as const satisfies Environment[];\n\nexport const tagsSchema = object({\n  os: optional(string()),\n  os_name: optional(string()),\n  os_version: optional(string()),\n  browser: optional(string()),\n  browser_name: optional(string()),\n  browser_version: optional(string()),\n  device: optional(string()),\n  device_id: optional(string().check(trim(), minLength(1), maxLength(36))),\n  device_type: optional(string()),\n  device_vendor: optional(string()),\n  device_pixel_ratio: optional(number()),\n  screen_width: optional(number()),\n  screen_height: optional(number()),\n  screen_resolution: optional(\n    pipe(\n      string().check(regex(/^\\d+x\\d+$/)),\n      transform((v) => v as `${number}x${number}`)\n    )\n  ),\n  release: optional(string()),\n  language: optional(string()),\n  time_zone: optional(string()),\n  source_url: optional(string()),\n  page_referrer: optional(string()),\n  // app info\n  advertising_id: optional(string()),\n  install_referrer: optional(string()),\n  // Meta Ads\n  fbc: optional(string()),\n  fbp: optional(string()),\n  fbclid: optional(string()),\n  ad_id: optional(string()),\n  ad_name: optional(string()),\n  adset_id: optional(string()),\n  adset_name: optional(string()),\n  campaign_id: optional(string()),\n  campaign_name: optional(string()),\n  placement: optional(string()),\n  site_source_name: optional(string()),\n  // Google Ads\n  gclid: optional(string()),\n  gclsrc: optional(string()),\n  gad_source: optional(string()),\n  gad_campaignid: optional(string()),\n  // Reddit ads\n  rdt_cid: optional(string()),\n  rdt_uuid: optional(string()),\n  // click ids\n  dclid: optional(string()),\n  ko_click_id: optional(string()),\n  li_fat_id: optional(string()),\n  msclkid: optional(string()),\n  sccid: optional(string()),\n  ttclid: optional(string()),\n  twclid: optional(string()),\n  wbraid: optional(string()),\n  yclid: optional(string()),\n  // utm params\n  utm_source: optional(string()),\n  utm_medium: optional(string()),\n  utm_campaign: optional(string()),\n  utm_term: optional(string()),\n  utm_content: optional(string()),\n  utm_id: optional(string()),\n  utm_source_platform: optional(string()),\n  utm_creative_format: optional(string()),\n  utm_marketing_tactic: optional(string()),\n});\n\nexport const propertiesSchema = optional(\n  record(\n    string().check(trim(), minLength(1), maxLength(128)),\n    union([string().check(maxLength(512)), number(), boolean(), _null(), items])\n  ).check(refine((data) => Object.keys(data).length <= 64))\n);\n\nexport const createTrackEventSchema = array(\n  object({\n    name: string().check(trim(), minLength(1), maxLength(64)),\n    visitor_id: uuid(),\n    session_id: uuid(),\n    platform: _enum(ALL_PLATFORMS),\n    environment: _enum(ALL_ENVIRONMENTS),\n    timestamp: iso.datetime(),\n    tags: tagsSchema,\n    properties: propertiesSchema,\n  })\n).check(minLength(1), maxLength(100));\n\nexport const createVisitorSchema = object({\n  device_id: string().check(trim(), minLength(1), maxLength(36)),\n  platform: _enum(ALL_PLATFORMS),\n  environment: _enum(ALL_ENVIRONMENTS),\n  tags: tagsSchema,\n  properties: optional(\n    record(\n      string().check(trim(), minLength(1), maxLength(128)),\n      union([string().check(maxLength(512)), number(), boolean(), _null()])\n    ).check(refine((data) => Object.keys(data).length <= 64))\n  ),\n});\n\nconst emailValue = pipe(string().check(trim(), toLowerCase(), maxLength(320)), email());\n\n/** E.164: a plus sign (+) prefix, country code, then digits only, no dashes/parens/spaces. */\nconst phoneValue = pipe(string().check(trim()), e164());\n\nconst addressValue = object({\n  first_name: optional(string().check(trim(), maxLength(128))),\n  last_name: optional(string().check(trim(), maxLength(128))),\n  street: optional(string().check(trim(), maxLength(256))),\n  city: optional(string().check(trim(), maxLength(128))),\n  /** User province, state, or region. Example: `Hampshire` */\n  region: optional(string().check(trim(), maxLength(128))),\n  postal_code: optional(string().check(trim(), maxLength(32))),\n  /** 2-letter country code, per the ISO 3166-1 alpha-2 standard. Example: `UK` */\n  country: optional(string().check(trim(), toUpperCase(), regex(/^[A-Z]{2}$/))),\n});\n\n/**\n * User-provided data (UPD) used for enhanced conversions, Customer Match, and demographics.\n * Values are sent unhashed; Google normalizes and hashes them before they reach its servers.\n *\n * Multiple values may be sent to increase the match rate: up to 3 emails, 3 phone numbers, and\n * 2 addresses.\n *\n * @see https://support.google.com/analytics/answer/14078702\n * @see https://support.google.com/google-ads/answer/13258081\n */\nexport const userProvidedDataSchema = object({\n  email: optional(union([emailValue, array(emailValue).check(minLength(1), maxLength(3))])),\n  phone_number: optional(union([phoneValue, array(phoneValue).check(minLength(1), maxLength(3))])),\n  address: optional(union([addressValue, array(addressValue).check(minLength(1), maxLength(2))])),\n});\n\nexport const updateVisitorSchema = object({\n  user_id: optional(uuid()),\n  user_data: optional(userProvidedDataSchema),\n  distinct_id: optional(string().check(trim(), minLength(1), maxLength(36))),\n  tags: tagsSchema,\n  properties: optional(\n    record(\n      string().check(trim(), minLength(1), maxLength(128)),\n      union([string().check(maxLength(512)), number(), boolean(), _null()])\n    ).check(refine((data) => Object.keys(data).length <= 64))\n  ),\n});\n\nexport const createFeedbackSchema = object({\n  name: string().check(minLength(1), maxLength(256)),\n  email: email().check(maxLength(320)),\n  message: string().check(minLength(1), maxLength(65536)),\n});\n\nconst noEmptyString = pipe(\n  string().check(maxLength(256)),\n  transform((v) => (v ? v : undefined))\n);\n\n/**\n * The schema for creating a link.\n * @see https://support.google.com/analytics/answer/10917952\n * */\nexport const createLinkSchema = object({\n  /** The URL that the user is redirected to. */\n  url: url().check(minLength(1), maxLength(1024)), // required\n\n  /**\n   * Campaign ID. Used to identify a specific campaign or promotion. This is a required key for GA4\n   * data import. Use the same IDs that you use when uploading campaign cost data.\n   */\n  utm_id: optional(noEmptyString),\n\n  /** Referrer, for example: google, newsletter4, billboard */\n  utm_source: string().check(minLength(1), maxLength(256)), // required\n\n  /** Marketing medium, for example: cpc, banner, email */\n  utm_medium: string().check(minLength(1), maxLength(256)), // required\n\n  /** Product, slogan, promo code, for example, spring_sale */\n  utm_campaign: string().check(minLength(1), maxLength(256)), // required\n\n  /** Paid keyword */\n  utm_term: optional(noEmptyString),\n\n  /**\n   * Use to differentiate creatives. For example, if you have two call-to-action links within the\n   * same email message, you can use utm_content and set different values for each so you can tell\n   * which version is more effective.\n   */\n  utm_content: optional(noEmptyString),\n\n  /**\n   * The platform responsible for directing traffic to a given Analytics property (such as a buying\n   * platform that sets budgets and targeting criteria or a platform that manages organic traffic\n   * data). For example, Search Ads 360 or Display & Video 360.\n   */\n  utm_source_platform: optional(noEmptyString),\n\n  /**\n   * Type of creative, for example, display, native, video, search, utm_creative_format is not\n   * currently reported in Google Analytics 4 properties.\n   */\n  utm_creative_format: optional(noEmptyString),\n\n  /**\n   * Targeting criteria applied to a campaign, for example, remarketing, prospecting,\n   * utm_marketing_tactic is not currently reported in Google Analytics 4 properties.\n   * */\n  utm_marketing_tactic: optional(noEmptyString),\n});\n\nexport type CreateTrackEventDTO = z.output<typeof createTrackEventSchema>;\nexport type CreateFeedbackDTO = z.output<typeof createFeedbackSchema>;\nexport type CreateLinkDTO = z.output<typeof createLinkSchema>;\nexport type CreateVisitorDTO = z.output<typeof createVisitorSchema>;\nexport type UserProvidedDataDTO = z.output<typeof userProvidedDataSchema>;\nexport type UpdateVisitorDTO = z.output<typeof updateVisitorSchema>;\n"],"mappings":"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"}

package/dist/server/action-source.cjs

@@ -0,0 +1,28 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/server/action-source.ts
+/**
+* An OS name means the event came from a native app, `web` means a browser page. A caller that
+* declares `macos`/`windows`/`linux` is declaring a desktop app — a page running in a webview
+* should declare `web`.
+*
+* `unknown` maps to nothing, since no vendor value fits; each sender picks its own fallback.
+*/
+function getActionSource(platform) {
+	switch (platform) {
+		case "web": return "web";
+		case "ios":
+		case "android":
+		case "macos":
+		case "windows":
+		case "linux": return "app";
+		case "unknown": return;
+	}
+}
+/** An explicit action source always wins; otherwise it is derived from the event's platform. */
+function resolveActionSource(platform, actionSource) {
+	return actionSource ?? getActionSource(platform);
+}
+//#endregion
+exports.resolveActionSource = resolveActionSource;
+
+//# sourceMappingURL=action-source.cjs.map

package/dist/server/action-source.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-source.cjs","names":[],"sources":["../../src/server/action-source.ts"],"sourcesContent":["import type { Platform } from '../track/types';\n\n/**\n * The coarse \"where did this happen\" categorization every conversions API asks for, under its\n * own name and its own spelling: Meta `action_source`, Reddit `action_source`, OpenAI\n * `action_source`. Each sender maps this to its vendor vocabulary.\n */\nexport type ActionSource = 'web' | 'app';\n\n/**\n * What a caller may state explicitly. `offline` is deliberately absent from the derived set:\n * it describes how a conversion was collected — in store, imported from a CRM, taken over the\n * phone — not what device it came from, so no platform implies it. Such events are built by a\n * backend rather than reported by a client SDK, which is why the sender takes it as an argument.\n */\nexport type EventActionSource = ActionSource | 'offline';\n\n/**\n * An OS name means the event came from a native app, `web` means a browser page. A caller that\n * declares `macos`/`windows`/`linux` is declaring a desktop app — a page running in a webview\n * should declare `web`.\n *\n * `unknown` maps to nothing, since no vendor value fits; each sender picks its own fallback.\n */\nfunction getActionSource(platform: Platform): ActionSource | undefined {\n  switch (platform) {\n    case 'web':\n      return 'web';\n    case 'ios':\n    case 'android':\n    case 'macos':\n    case 'windows':\n    case 'linux':\n      return 'app';\n    case 'unknown':\n      return undefined;\n  }\n}\n\n/** An explicit action source always wins; otherwise it is derived from the event's platform. */\nexport function resolveActionSource(\n  platform: Platform,\n  actionSource?: EventActionSource\n): EventActionSource | undefined {\n  return actionSource ?? getActionSource(platform);\n}\n"],"mappings":";;;;;;;;;AAwBA,SAAS,gBAAgB,UAA8C;CACrE,QAAQ,UAAR;EACE,KAAK,OACH,OAAO;EACT,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,SACH,OAAO;EACT,KAAK,WACH;CACJ;AACF;;AAGA,SAAgB,oBACd,UACA,cAC+B;CAC/B,OAAO,gBAAgB,gBAAgB,QAAQ;AACjD"}

package/dist/server/action-source.d.cts

@@ -0,0 +1,20 @@
+import { Platform } from "../track/types.cjs";
+//#region src/server/action-source.d.ts
+/**
+ * The coarse "where did this happen" categorization every conversions API asks for, under its
+ * own name and its own spelling: Meta `action_source`, Reddit `action_source`, OpenAI
+ * `action_source`. Each sender maps this to its vendor vocabulary.
+ */
+type ActionSource = 'web' | 'app';
+/**
+ * What a caller may state explicitly. `offline` is deliberately absent from the derived set:
+ * it describes how a conversion was collected — in store, imported from a CRM, taken over the
+ * phone — not what device it came from, so no platform implies it. Such events are built by a
+ * backend rather than reported by a client SDK, which is why the sender takes it as an argument.
+ */
+type EventActionSource = ActionSource | 'offline';
+/** An explicit action source always wins; otherwise it is derived from the event's platform. */
+declare function resolveActionSource(platform: Platform, actionSource?: EventActionSource): EventActionSource | undefined;
+//#endregion
+export { ActionSource, EventActionSource, resolveActionSource };
+//# sourceMappingURL=action-source.d.cts.map

package/dist/server/action-source.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-source.d.cts","names":[],"sources":["../../src/server/action-source.ts"],"mappings":";;;;;;;KAOY;;;;;;;KAQA,oBAAoB;;iBAyBhB,oBACd,UAAU,UACV,eAAe,oBACd"}

package/dist/server/action-source.d.mts

@@ -0,0 +1,20 @@
+import { Platform } from "../track/types.mjs";
+//#region src/server/action-source.d.ts
+/**
+ * The coarse "where did this happen" categorization every conversions API asks for, under its
+ * own name and its own spelling: Meta `action_source`, Reddit `action_source`, OpenAI
+ * `action_source`. Each sender maps this to its vendor vocabulary.
+ */
+type ActionSource = 'web' | 'app';
+/**
+ * What a caller may state explicitly. `offline` is deliberately absent from the derived set:
+ * it describes how a conversion was collected — in store, imported from a CRM, taken over the
+ * phone — not what device it came from, so no platform implies it. Such events are built by a
+ * backend rather than reported by a client SDK, which is why the sender takes it as an argument.
+ */
+type EventActionSource = ActionSource | 'offline';
+/** An explicit action source always wins; otherwise it is derived from the event's platform. */
+declare function resolveActionSource(platform: Platform, actionSource?: EventActionSource): EventActionSource | undefined;
+//#endregion
+export { ActionSource, EventActionSource, resolveActionSource };
+//# sourceMappingURL=action-source.d.mts.map

package/dist/server/action-source.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-source.d.mts","names":[],"sources":["../../src/server/action-source.ts"],"mappings":";;;;;;;KAOY;;;;;;;KAQA,oBAAoB;;iBAyBhB,oBACd,UAAU,UACV,eAAe,oBACd"}

package/dist/server/action-source.mjs

@@ -0,0 +1,27 @@
+//#region src/server/action-source.ts
+/**
+* An OS name means the event came from a native app, `web` means a browser page. A caller that
+* declares `macos`/`windows`/`linux` is declaring a desktop app — a page running in a webview
+* should declare `web`.
+*
+* `unknown` maps to nothing, since no vendor value fits; each sender picks its own fallback.
+*/
+function getActionSource(platform) {
+	switch (platform) {
+		case "web": return "web";
+		case "ios":
+		case "android":
+		case "macos":
+		case "windows":
+		case "linux": return "app";
+		case "unknown": return;
+	}
+}
+/** An explicit action source always wins; otherwise it is derived from the event's platform. */
+function resolveActionSource(platform, actionSource) {
+	return actionSource ?? getActionSource(platform);
+}
+//#endregion
+export { resolveActionSource };
+
+//# sourceMappingURL=action-source.mjs.map

package/dist/server/action-source.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-source.mjs","names":[],"sources":["../../src/server/action-source.ts"],"sourcesContent":["import type { Platform } from '../track/types';\n\n/**\n * The coarse \"where did this happen\" categorization every conversions API asks for, under its\n * own name and its own spelling: Meta `action_source`, Reddit `action_source`, OpenAI\n * `action_source`. Each sender maps this to its vendor vocabulary.\n */\nexport type ActionSource = 'web' | 'app';\n\n/**\n * What a caller may state explicitly. `offline` is deliberately absent from the derived set:\n * it describes how a conversion was collected — in store, imported from a CRM, taken over the\n * phone — not what device it came from, so no platform implies it. Such events are built by a\n * backend rather than reported by a client SDK, which is why the sender takes it as an argument.\n */\nexport type EventActionSource = ActionSource | 'offline';\n\n/**\n * An OS name means the event came from a native app, `web` means a browser page. A caller that\n * declares `macos`/`windows`/`linux` is declaring a desktop app — a page running in a webview\n * should declare `web`.\n *\n * `unknown` maps to nothing, since no vendor value fits; each sender picks its own fallback.\n */\nfunction getActionSource(platform: Platform): ActionSource | undefined {\n  switch (platform) {\n    case 'web':\n      return 'web';\n    case 'ios':\n    case 'android':\n    case 'macos':\n    case 'windows':\n    case 'linux':\n      return 'app';\n    case 'unknown':\n      return undefined;\n  }\n}\n\n/** An explicit action source always wins; otherwise it is derived from the event's platform. */\nexport function resolveActionSource(\n  platform: Platform,\n  actionSource?: EventActionSource\n): EventActionSource | undefined {\n  return actionSource ?? getActionSource(platform);\n}\n"],"mappings":";;;;;;;;AAwBA,SAAS,gBAAgB,UAA8C;CACrE,QAAQ,UAAR;EACE,KAAK,OACH,OAAO;EACT,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,SACH,OAAO;EACT,KAAK,WACH;CACJ;AACF;;AAGA,SAAgB,oBACd,UACA,cAC+B;CAC/B,OAAO,gBAAgB,gBAAgB,QAAQ;AACjD"}

package/dist/server/index.d.cts

@@ -1,6 +1,7 @@
 import { FBC_COOKIE, ParsedFbc, RDT_CID_COOKIE, ResolveClickIdCookiesInput, ResolveClickIdCookiesResult, formatFbc, parseFbc, resolveClickIdCookies, toSetCookieHeaders } from "../click-id/index.cjs";
+import { EventActionSource } from "./action-source.cjs";
 import { sendEvents as sendEvents$1 } from "./meta-conversions-api.cjs";
 import { sendEvents as sendEvents$3 } from "./reddit-conversions-api.cjs";
 import { LinkedinConversionConfig, sendEvents } from "./linkedin-conversions-api.cjs";
 import { sendEvents as sendEvents$2 } from "./openai-conversions-api.cjs";
-export { FBC_COOKIE, type LinkedinConversionConfig, type ParsedFbc, RDT_CID_COOKIE, type ResolveClickIdCookiesInput, type ResolveClickIdCookiesResult, formatFbc, parseFbc, resolveClickIdCookies, sendEvents as sendLinkedinEvents, sendEvents$1 as sendMetaEvents, sendEvents$2 as sendOpenAIEvents, sendEvents$3 as sendRedditEvents, toSetCookieHeaders };
+export { type EventActionSource, FBC_COOKIE, type LinkedinConversionConfig, type ParsedFbc, RDT_CID_COOKIE, type ResolveClickIdCookiesInput, type ResolveClickIdCookiesResult, formatFbc, parseFbc, resolveClickIdCookies, sendEvents as sendLinkedinEvents, sendEvents$1 as sendMetaEvents, sendEvents$2 as sendOpenAIEvents, sendEvents$3 as sendRedditEvents, toSetCookieHeaders };

package/dist/server/index.d.mts

@@ -1,6 +1,7 @@
 import { FBC_COOKIE, ParsedFbc, RDT_CID_COOKIE, ResolveClickIdCookiesInput, ResolveClickIdCookiesResult, formatFbc, parseFbc, resolveClickIdCookies, toSetCookieHeaders } from "../click-id/index.mjs";
+import { EventActionSource } from "./action-source.mjs";
 import { sendEvents as sendEvents$1 } from "./meta-conversions-api.mjs";
 import { sendEvents as sendEvents$3 } from "./reddit-conversions-api.mjs";
 import { LinkedinConversionConfig, sendEvents } from "./linkedin-conversions-api.mjs";
 import { sendEvents as sendEvents$2 } from "./openai-conversions-api.mjs";
-export { FBC_COOKIE, type LinkedinConversionConfig, type ParsedFbc, RDT_CID_COOKIE, type ResolveClickIdCookiesInput, type ResolveClickIdCookiesResult, formatFbc, parseFbc, resolveClickIdCookies, sendEvents as sendLinkedinEvents, sendEvents$1 as sendMetaEvents, sendEvents$2 as sendOpenAIEvents, sendEvents$3 as sendRedditEvents, toSetCookieHeaders };
+export { type EventActionSource, FBC_COOKIE, type LinkedinConversionConfig, type ParsedFbc, RDT_CID_COOKIE, type ResolveClickIdCookiesInput, type ResolveClickIdCookiesResult, formatFbc, parseFbc, resolveClickIdCookies, sendEvents as sendLinkedinEvents, sendEvents$1 as sendMetaEvents, sendEvents$2 as sendOpenAIEvents, sendEvents$3 as sendRedditEvents, toSetCookieHeaders };

package/dist/server/meta-conversions-api.cjs

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_third_parties_ignored_events = require("../third-parties/ignored-events.cjs");
 const require_track_fbq = require("../track/fbq.cjs");
+const require_server_action_source = require("./action-source.cjs");
 let facebook_nodejs_business_sdk = require("facebook-nodejs-business-sdk");
 //#region src/server/meta-conversions-api.ts
 const USER_ASSIGNED_COUNTRIES = ["xk"];
@@ -120,24 +121,27 @@ function getCustomData({ name, properties }) {
 	data.setCustomProperties(custom_properties);
 	return data;
 }
-function getServerEvent(event, data, appPackageName) {
+function getServerEvent(event, data, appPackageName, actionSource) {
 	const userData = getUserData(event.tags, data);
 	const customData = getCustomData(event);
 	const [_, eventName] = require_track_fbq.mapFBEvent(event.name, event.properties);
 	const serverEvent = new facebook_nodejs_business_sdk.ServerEvent().setEventId(event.tags.idempotency_key ?? event.id).setEventName(eventName).setEventTime(Math.round(Date.now() / 1e3)).setUserData(userData).setCustomData(customData);
-	if (event.tags.source === "app" && appPackageName) {
+	const source = require_server_action_source.resolveActionSource(event.platform, actionSource);
+	if (source === "app" && appPackageName) {
 		const appData = getAppData(event.tags, appPackageName);
 		serverEvent.setAppData(appData);
 	}
 	if (event.tags.source_url) serverEvent.setEventSourceUrl(event.tags.source_url);
-	switch (event.tags.source) {
+	switch (source) {
 		case "app":
 			serverEvent.setActionSource("app");
 			break;
 		case "web":
 			serverEvent.setActionSource("website");
 			break;
-		default: break;
+		default:
+			serverEvent.setActionSource("other");
+			break;
 	}
 	return serverEvent;
 }
@@ -154,10 +158,10 @@ function logError(error) {
 	}
 	console.error(`Failed to send Meta conversion, status: ${status}, body: ${JSON.stringify(response)}`);
 }
-async function sendEvent(accessToken, pixelId, event, data = {}, appPackageName) {
+async function sendEvent(accessToken, pixelId, event, data = {}, appPackageName, actionSource) {
 	if (require_third_parties_ignored_events.IGNORED_EVENTS.includes(event.name)) return void 0;
 	const request = new facebook_nodejs_business_sdk.EventRequest(accessToken, pixelId);
-	const fbEvent = getServerEvent(event, data, appPackageName);
+	const fbEvent = getServerEvent(event, data, appPackageName, actionSource);
 	request.setEvents([fbEvent]);
 	try {
 		return await request.execute();
@@ -166,8 +170,8 @@ async function sendEvent(accessToken, pixelId, event, data = {}, appPackageName)
 		return;
 	}
 }
-async function sendEvents(accessToken, pixelId, events, data = {}, appPackageName) {
-	const fbEvents = events.filter((event) => !require_third_parties_ignored_events.IGNORED_EVENTS.includes(event.name)).map((event) => getServerEvent(event, data, appPackageName));
+async function sendEvents(accessToken, pixelId, events, data = {}, appPackageName, actionSource) {
+	const fbEvents = events.filter((event) => !require_third_parties_ignored_events.IGNORED_EVENTS.includes(event.name)).map((event) => getServerEvent(event, data, appPackageName, actionSource));
 	if (fbEvents.length === 0) return void 0;
 	const request = new facebook_nodejs_business_sdk.EventRequest(accessToken, pixelId);
 	request.setEvents(fbEvents);

package/dist/server/meta-conversions-api.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"meta-conversions-api.cjs","names":["UserData","ExtendedDeviceInfo","AppData","CustomData","mapFBEvent","Content","ServerEvent","IGNORED_EVENTS","EventRequest"],"sources":["../../src/server/meta-conversions-api.ts"],"sourcesContent":["import {\n  AppData,\n  Content,\n  CustomData,\n  EventRequest,\n  ExtendedDeviceInfo,\n  ServerEvent,\n  UserData,\n} from 'facebook-nodejs-business-sdk';\nimport { IGNORED_EVENTS } from '../third-parties/ignored-events';\nimport { mapFBEvent } from '../track/fbq';\nimport type { TrackEvent, TrackTags, UserProvidedData } from '../track/types';\n\nconst USER_ASSIGNED_COUNTRIES: string[] = ['xk'];\nfunction normalizeCountry(input: string | undefined): string | undefined {\n  const country = input?.split(/[-_]/).at(0)?.toLowerCase();\n  if (!country) return undefined;\n  return USER_ASSIGNED_COUNTRIES.includes(country) ? undefined : country;\n}\n\nfunction getUserData(tags: TrackTags, data: UserProvidedData) {\n  const userData = new UserData();\n\n  // set user-provided data\n  if (data.email) {\n    if (Array.isArray(data.email)) {\n      userData.setEmails(data.email);\n    } else {\n      userData.setEmail(data.email);\n    }\n  }\n  if (data.phone_number) {\n    if (Array.isArray(data.phone_number)) {\n      userData.setPhones(data.phone_number);\n    } else {\n      userData.setPhone(data.phone_number);\n    }\n  }\n  if (data.gender) {\n    if (data.gender === 'female') {\n      userData.setGender('f');\n      // oxlint-disable-next-line typescript/no-unnecessary-condition -- user-provided data may carry values outside the declared union at runtime\n    } else if (data.gender === 'male') {\n      userData.setGender('m');\n    }\n  }\n  if (data.address) {\n    if (Array.isArray(data.address)) {\n      const firstNames = data.address.map((a) => a.first_name).filter(Boolean);\n      const lastNames = data.address.map((a) => a.last_name).filter(Boolean);\n      const cities = data.address.map((a) => a.city).filter(Boolean);\n      const states = data.address.map((a) => a.region).filter(Boolean);\n      const postalCodes = data.address.map((a) => a.postal_code).filter(Boolean);\n      const countries = data.address.map((a) => normalizeCountry(a.country)).filter(Boolean);\n\n      userData.setFirstNames(firstNames as string[]);\n      userData.setLastNames(lastNames as string[]);\n      userData.setCities(cities as string[]);\n      userData.setStates(states as string[]);\n      userData.setZips(postalCodes as string[]);\n      userData.setCountries(countries as string[]);\n    } else {\n      if (data.address.first_name) {\n        userData.setFirstName(data.address.first_name);\n        userData.setF5First(data.address.first_name.slice(0, 5));\n      }\n      if (data.address.last_name) {\n        userData.setLastName(data.address.last_name);\n        userData.setF5Last(data.address.last_name.slice(0, 5));\n      }\n      if (data.address.city) userData.setCity(data.address.city);\n      if (data.address.region) userData.setState(data.address.region);\n      if (data.address.postal_code) userData.setZip(data.address.postal_code);\n      if (data.address.country) {\n        const country = normalizeCountry(data.address.country);\n        if (country) userData.setCountry(country);\n      }\n    }\n  }\n  if (data.birthday) {\n    userData.setDoby(data.birthday.year.toString());\n    userData.setDobm(data.birthday.month.toString());\n    userData.setDobd(data.birthday.day.toString());\n  }\n  if (data.user_id && data.user_id.length !== 0) {\n    userData.setExternalId(data.user_id);\n  }\n  if (data.ip_address) {\n    userData.setClientIpAddress(data.ip_address);\n  }\n  if (data.user_agent) {\n    userData.setClientUserAgent(data.user_agent);\n  }\n  if (data.fb_login_id) {\n    userData.setFbLoginId(data.fb_login_id);\n  }\n  if (data.fb_page_id) {\n    userData.setPageId(data.fb_page_id);\n  }\n\n  // set tags info\n  if (tags.fbc) {\n    userData.setFbc(tags.fbc);\n  } else if (tags.fbclid) {\n    // ref: https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/fbp-and-fbc#2--format-clickid\n    // The formatted ClickID value must be of the form `version.subdomainIndex.creationTime.<fbclid>`, where:\n    // - version is always this prefix: fb\n    // - subdomainIndex is which domain the cookie is defined on ('com' = 0, 'example.com' = 1, 'www.example.com' = 2)\n    // - creationTime is the UNIX time since epoch in milliseconds when the _fbc was stored. If you don't save the _fbc cookie, use the timestamp when you first observed or received this fbclid value\n    // - <fbclid> is the value for the fbclid query parameter in the page URL.\n\n    const fbc = `fb.1.${Date.now()}.${tags.fbclid}`;\n    userData.setFbc(fbc);\n  }\n\n  if (tags.fbp) {\n    userData.setFbp(tags.fbp);\n  }\n  if (tags.advertising_id) {\n    userData.setMadid(tags.advertising_id);\n  }\n  if (tags.ip_address && typeof tags.ip_address === 'string') {\n    userData.setClientIpAddress(tags.ip_address);\n  }\n\n  return userData;\n}\n\nfunction getAppData(tags: TrackTags, appPackageName: string) {\n  const extinfo = new ExtendedDeviceInfo();\n  if (tags.os_name) {\n    if (tags.os_name === 'iOS' || tags.os_name === 'iPadOS') {\n      extinfo.setExtInfoVersion('i2');\n    } else if (tags.os_name === 'Android') {\n      extinfo.setExtInfoVersion('a2');\n    }\n  }\n  extinfo.setAppPackageName(appPackageName);\n  const shortVersion = tags.release?.split('.').at(0);\n  if (shortVersion) {\n    extinfo.setShortVersion(shortVersion);\n  }\n  if (tags.release) {\n    extinfo.setLongVersion(tags.release);\n  }\n  if (tags.os_version) {\n    extinfo.setOsVersion(tags.os_version);\n  }\n  if (tags.device_model_id) {\n    extinfo.setDeviceModelName(tags.device_model_id);\n  }\n  if (tags.language) {\n    extinfo.setLocale(tags.language);\n  }\n  if (tags.screen_width) {\n    extinfo.setScreenWidth(tags.screen_width);\n  }\n  if (tags.screen_height) {\n    extinfo.setScreenHeight(tags.screen_height);\n  }\n  if (tags.device_pixel_ratio) {\n    extinfo.setScreenDensity(tags.device_pixel_ratio.toString());\n  }\n\n  const appData = new AppData();\n  appData.setExtinfo(extinfo);\n  if (tags.install_referrer) {\n    appData.setInstallReferrer(tags.install_referrer);\n  }\n  if (tags.advertising_id) {\n    appData.setAdvertiserTrackingEnabled(true);\n  }\n  if (tags.install_referrer) {\n    appData.setInstallReferrer(tags.install_referrer);\n  }\n\n  return appData;\n}\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\nfunction getCustomData({ name, properties }: TrackEvent<any>) {\n  const data = new CustomData();\n  const [_, _name, fbEventProperties] = mapFBEvent(name, properties);\n  const {\n    value,\n    currency,\n    content_name,\n    content_category,\n    content_ids,\n    contents,\n    content_type,\n    // order_id,\n    predicted_ltv,\n    num_items,\n    search_string,\n    status,\n    // item_number,\n    delivery_category,\n    ...custom_properties\n  } = fbEventProperties;\n  // oxlint-disable-next-line typescript/no-unnecessary-condition -- custom event properties may carry `value: null` at runtime despite the declared type\n  if (value !== undefined && value !== null) data.setValue(value);\n  if (currency) data.setCurrency(currency);\n  if (content_name) data.setContentName(content_name);\n  if (content_category) data.setContentCategory(content_category);\n  if (content_ids) data.setContentIds(content_ids);\n  if (contents)\n    data.setContents(\n      contents.map((c) => {\n        const result = new Content().setId(c.id).setQuantity(c.quantity);\n        if (c.item_price) result.setItemPrice(c.item_price);\n        if (c.title) result.setTitle(c.title);\n        if (c.description) result.setDescription(c.description);\n        if (c.brand) result.setBrand(c.brand);\n        if (c.category) result.setCategory(c.category);\n        if (c.delivery_category) result.setDeliveryCategory(c.delivery_category);\n        return result;\n      })\n    );\n  if (content_type) data.setContentType(content_type);\n  // if (order_id) data.setOrderId(order_id);\n  if (predicted_ltv) data.setPredictedLtv(predicted_ltv);\n  if (num_items) data.setNumItems(num_items);\n  if (search_string) data.setSearchString(search_string);\n  if (status) data.setStatus(status.toString());\n  // if (item_number) data.setItemNumber(item_number);\n  if (delivery_category) data.setDeliveryCategory(delivery_category);\n  data.setCustomProperties(custom_properties);\n  return data;\n}\n\nexport function getServerEvent(\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  event: TrackEvent<any>,\n  data: UserProvidedData,\n  appPackageName?: string\n) {\n  const userData = getUserData(event.tags, data);\n  const customData = getCustomData(event);\n  const [_, eventName] = mapFBEvent(event.name, event.properties);\n  const serverEvent = new ServerEvent()\n    .setEventId(event.tags.idempotency_key ?? event.id)\n    .setEventName(eventName)\n    .setEventTime(Math.round(Date.now() / 1000))\n    .setUserData(userData)\n    .setCustomData(customData);\n\n  if (event.tags.source === 'app' && appPackageName) {\n    const appData = getAppData(event.tags, appPackageName);\n    serverEvent.setAppData(appData);\n  }\n  if (event.tags.source_url) {\n    serverEvent.setEventSourceUrl(event.tags.source_url);\n  }\n  switch (event.tags.source) {\n    case 'app':\n      serverEvent.setActionSource('app');\n      break;\n    case 'web':\n      serverEvent.setActionSource('website');\n      break;\n    default:\n      break;\n  }\n  return serverEvent;\n}\n\n/**\n * The shape `FacebookRequestError` exposes: `status` and `response` are the HTTP status and the\n * parsed error body, and both are null when the request never received a response.\n */\ntype MetaRequestError = { status?: number | null; message?: string; response?: unknown };\n\n/**\n * Meta's SDK rejects on API errors, where every other conversion sender here logs and resolves.\n * Keep the failure inside this module, so one rejected batch cannot fail the caller's request.\n * Never log the error itself: it also carries the access token, in both `url` and `data`.\n */\nfunction logError(error: unknown) {\n  const { status, message, response } = (error ?? {}) as MetaRequestError;\n  if (typeof status !== 'number') {\n    console.error(`Failed to send Meta conversion, network error: ${message ?? String(error)}`);\n    return;\n  }\n  console.error(\n    `Failed to send Meta conversion, status: ${status}, body: ${JSON.stringify(response)}`\n  );\n}\n\nexport async function sendEvent(\n  accessToken: string,\n  pixelId: string,\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  event: TrackEvent<any>,\n  data: UserProvidedData = {},\n  appPackageName?: string\n) {\n  if (IGNORED_EVENTS.includes(event.name)) return undefined;\n  const request = new EventRequest(accessToken, pixelId);\n  const fbEvent = getServerEvent(event, data, appPackageName);\n  request.setEvents([fbEvent]);\n  try {\n    return await request.execute();\n  } catch (error) {\n    logError(error);\n    return undefined;\n  }\n}\n\nexport async function sendEvents(\n  accessToken: string,\n  pixelId: string,\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  events: TrackEvent<any>[],\n  data: UserProvidedData = {},\n  appPackageName?: string\n) {\n  const fbEvents = events\n    .filter((event) => !IGNORED_EVENTS.includes(event.name))\n    .map((event) => getServerEvent(event, data, appPackageName));\n  if (fbEvents.length === 0) return undefined;\n  const request = new EventRequest(accessToken, pixelId);\n  request.setEvents(fbEvents);\n  try {\n    return await request.execute();\n  } catch (error) {\n    logError(error);\n    return undefined;\n  }\n}\n\nexport async function sendTestEvent(accessToken: string, pixelId: string, testEventCode: string) {\n  const extinfo = new ExtendedDeviceInfo()\n    .setExtInfoVersion('a2')\n    .setAppPackageName('com.some.app')\n    .setShortVersion('771')\n    .setLongVersion('Version 7.7.1')\n    .setOsVersion('10.1.1')\n    .setDeviceModelName('OnePlus6')\n    .setLocale('en_US')\n    .setTimezoneAbbreviation('GMT-1')\n    .setCarrier('TMobile')\n    .setScreenWidth(1920)\n    .setScreenHeight(1080)\n    .setScreenDensity('2.00')\n    .setCpuCoreCount(2)\n    .setTotalDiskSpaceGb(128)\n    .setFreeDiskSpaceGb(8)\n    .setDeviceTimeZone('USA/New York');\n\n  const userData = new UserData().setEmail('test@example.com');\n  const appData = new AppData().setExtinfo(extinfo);\n  const event = new ServerEvent()\n    .setEventId(Math.round(Math.random() * 1000_000).toString())\n    .setEventName('TestEvent')\n    .setEventTime(Math.round(Date.now() / 1000))\n    .setUserData(userData)\n    .setAppData(appData)\n    .setActionSource('app');\n\n  const request = new EventRequest(accessToken, pixelId);\n  request.setTestEventCode(testEventCode);\n  request.setEvents([event]);\n  return request.execute();\n}\n"],"mappings":"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"}
+{"version":3,"file":"meta-conversions-api.cjs","names":["UserData","ExtendedDeviceInfo","AppData","CustomData","mapFBEvent","Content","ServerEvent","resolveActionSource","IGNORED_EVENTS","EventRequest"],"sources":["../../src/server/meta-conversions-api.ts"],"sourcesContent":["import {\n  AppData,\n  Content,\n  CustomData,\n  EventRequest,\n  ExtendedDeviceInfo,\n  ServerEvent,\n  UserData,\n} from 'facebook-nodejs-business-sdk';\nimport { IGNORED_EVENTS } from '../third-parties/ignored-events';\nimport { mapFBEvent } from '../track/fbq';\nimport type { TrackEvent, TrackTags, UserProvidedData } from '../track/types';\nimport { type EventActionSource, resolveActionSource } from './action-source';\n\nconst USER_ASSIGNED_COUNTRIES: string[] = ['xk'];\nfunction normalizeCountry(input: string | undefined): string | undefined {\n  const country = input?.split(/[-_]/).at(0)?.toLowerCase();\n  if (!country) return undefined;\n  return USER_ASSIGNED_COUNTRIES.includes(country) ? undefined : country;\n}\n\nfunction getUserData(tags: TrackTags, data: UserProvidedData) {\n  const userData = new UserData();\n\n  // set user-provided data\n  if (data.email) {\n    if (Array.isArray(data.email)) {\n      userData.setEmails(data.email);\n    } else {\n      userData.setEmail(data.email);\n    }\n  }\n  if (data.phone_number) {\n    if (Array.isArray(data.phone_number)) {\n      userData.setPhones(data.phone_number);\n    } else {\n      userData.setPhone(data.phone_number);\n    }\n  }\n  if (data.gender) {\n    if (data.gender === 'female') {\n      userData.setGender('f');\n      // oxlint-disable-next-line typescript/no-unnecessary-condition -- user-provided data may carry values outside the declared union at runtime\n    } else if (data.gender === 'male') {\n      userData.setGender('m');\n    }\n  }\n  if (data.address) {\n    if (Array.isArray(data.address)) {\n      const firstNames = data.address.map((a) => a.first_name).filter(Boolean);\n      const lastNames = data.address.map((a) => a.last_name).filter(Boolean);\n      const cities = data.address.map((a) => a.city).filter(Boolean);\n      const states = data.address.map((a) => a.region).filter(Boolean);\n      const postalCodes = data.address.map((a) => a.postal_code).filter(Boolean);\n      const countries = data.address.map((a) => normalizeCountry(a.country)).filter(Boolean);\n\n      userData.setFirstNames(firstNames as string[]);\n      userData.setLastNames(lastNames as string[]);\n      userData.setCities(cities as string[]);\n      userData.setStates(states as string[]);\n      userData.setZips(postalCodes as string[]);\n      userData.setCountries(countries as string[]);\n    } else {\n      if (data.address.first_name) {\n        userData.setFirstName(data.address.first_name);\n        userData.setF5First(data.address.first_name.slice(0, 5));\n      }\n      if (data.address.last_name) {\n        userData.setLastName(data.address.last_name);\n        userData.setF5Last(data.address.last_name.slice(0, 5));\n      }\n      if (data.address.city) userData.setCity(data.address.city);\n      if (data.address.region) userData.setState(data.address.region);\n      if (data.address.postal_code) userData.setZip(data.address.postal_code);\n      if (data.address.country) {\n        const country = normalizeCountry(data.address.country);\n        if (country) userData.setCountry(country);\n      }\n    }\n  }\n  if (data.birthday) {\n    userData.setDoby(data.birthday.year.toString());\n    userData.setDobm(data.birthday.month.toString());\n    userData.setDobd(data.birthday.day.toString());\n  }\n  if (data.user_id && data.user_id.length !== 0) {\n    userData.setExternalId(data.user_id);\n  }\n  if (data.ip_address) {\n    userData.setClientIpAddress(data.ip_address);\n  }\n  if (data.user_agent) {\n    userData.setClientUserAgent(data.user_agent);\n  }\n  if (data.fb_login_id) {\n    userData.setFbLoginId(data.fb_login_id);\n  }\n  if (data.fb_page_id) {\n    userData.setPageId(data.fb_page_id);\n  }\n\n  // set tags info\n  if (tags.fbc) {\n    userData.setFbc(tags.fbc);\n  } else if (tags.fbclid) {\n    // ref: https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/fbp-and-fbc#2--format-clickid\n    // The formatted ClickID value must be of the form `version.subdomainIndex.creationTime.<fbclid>`, where:\n    // - version is always this prefix: fb\n    // - subdomainIndex is which domain the cookie is defined on ('com' = 0, 'example.com' = 1, 'www.example.com' = 2)\n    // - creationTime is the UNIX time since epoch in milliseconds when the _fbc was stored. If you don't save the _fbc cookie, use the timestamp when you first observed or received this fbclid value\n    // - <fbclid> is the value for the fbclid query parameter in the page URL.\n\n    const fbc = `fb.1.${Date.now()}.${tags.fbclid}`;\n    userData.setFbc(fbc);\n  }\n\n  if (tags.fbp) {\n    userData.setFbp(tags.fbp);\n  }\n  if (tags.advertising_id) {\n    userData.setMadid(tags.advertising_id);\n  }\n  if (tags.ip_address && typeof tags.ip_address === 'string') {\n    userData.setClientIpAddress(tags.ip_address);\n  }\n\n  return userData;\n}\n\nfunction getAppData(tags: TrackTags, appPackageName: string) {\n  const extinfo = new ExtendedDeviceInfo();\n  if (tags.os_name) {\n    if (tags.os_name === 'iOS' || tags.os_name === 'iPadOS') {\n      extinfo.setExtInfoVersion('i2');\n    } else if (tags.os_name === 'Android') {\n      extinfo.setExtInfoVersion('a2');\n    }\n  }\n  extinfo.setAppPackageName(appPackageName);\n  const shortVersion = tags.release?.split('.').at(0);\n  if (shortVersion) {\n    extinfo.setShortVersion(shortVersion);\n  }\n  if (tags.release) {\n    extinfo.setLongVersion(tags.release);\n  }\n  if (tags.os_version) {\n    extinfo.setOsVersion(tags.os_version);\n  }\n  if (tags.device_model_id) {\n    extinfo.setDeviceModelName(tags.device_model_id);\n  }\n  if (tags.language) {\n    extinfo.setLocale(tags.language);\n  }\n  if (tags.screen_width) {\n    extinfo.setScreenWidth(tags.screen_width);\n  }\n  if (tags.screen_height) {\n    extinfo.setScreenHeight(tags.screen_height);\n  }\n  if (tags.device_pixel_ratio) {\n    extinfo.setScreenDensity(tags.device_pixel_ratio.toString());\n  }\n\n  const appData = new AppData();\n  appData.setExtinfo(extinfo);\n  if (tags.install_referrer) {\n    appData.setInstallReferrer(tags.install_referrer);\n  }\n  if (tags.advertising_id) {\n    appData.setAdvertiserTrackingEnabled(true);\n  }\n  if (tags.install_referrer) {\n    appData.setInstallReferrer(tags.install_referrer);\n  }\n\n  return appData;\n}\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\nfunction getCustomData({ name, properties }: TrackEvent<any>) {\n  const data = new CustomData();\n  const [_, _name, fbEventProperties] = mapFBEvent(name, properties);\n  const {\n    value,\n    currency,\n    content_name,\n    content_category,\n    content_ids,\n    contents,\n    content_type,\n    // order_id,\n    predicted_ltv,\n    num_items,\n    search_string,\n    status,\n    // item_number,\n    delivery_category,\n    ...custom_properties\n  } = fbEventProperties;\n  // oxlint-disable-next-line typescript/no-unnecessary-condition -- custom event properties may carry `value: null` at runtime despite the declared type\n  if (value !== undefined && value !== null) data.setValue(value);\n  if (currency) data.setCurrency(currency);\n  if (content_name) data.setContentName(content_name);\n  if (content_category) data.setContentCategory(content_category);\n  if (content_ids) data.setContentIds(content_ids);\n  if (contents)\n    data.setContents(\n      contents.map((c) => {\n        const result = new Content().setId(c.id).setQuantity(c.quantity);\n        if (c.item_price) result.setItemPrice(c.item_price);\n        if (c.title) result.setTitle(c.title);\n        if (c.description) result.setDescription(c.description);\n        if (c.brand) result.setBrand(c.brand);\n        if (c.category) result.setCategory(c.category);\n        if (c.delivery_category) result.setDeliveryCategory(c.delivery_category);\n        return result;\n      })\n    );\n  if (content_type) data.setContentType(content_type);\n  // if (order_id) data.setOrderId(order_id);\n  if (predicted_ltv) data.setPredictedLtv(predicted_ltv);\n  if (num_items) data.setNumItems(num_items);\n  if (search_string) data.setSearchString(search_string);\n  if (status) data.setStatus(status.toString());\n  // if (item_number) data.setItemNumber(item_number);\n  if (delivery_category) data.setDeliveryCategory(delivery_category);\n  data.setCustomProperties(custom_properties);\n  return data;\n}\n\nexport function getServerEvent(\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  event: TrackEvent<any>,\n  data: UserProvidedData,\n  appPackageName?: string,\n  actionSource?: EventActionSource\n) {\n  const userData = getUserData(event.tags, data);\n  const customData = getCustomData(event);\n  const [_, eventName] = mapFBEvent(event.name, event.properties);\n  const serverEvent = new ServerEvent()\n    .setEventId(event.tags.idempotency_key ?? event.id)\n    .setEventName(eventName)\n    .setEventTime(Math.round(Date.now() / 1000))\n    .setUserData(userData)\n    .setCustomData(customData);\n\n  const source = resolveActionSource(event.platform, actionSource);\n  if (source === 'app' && appPackageName) {\n    const appData = getAppData(event.tags, appPackageName);\n    serverEvent.setAppData(appData);\n  }\n  if (event.tags.source_url) {\n    serverEvent.setEventSourceUrl(event.tags.source_url);\n  }\n  switch (source) {\n    case 'app':\n      serverEvent.setActionSource('app');\n      break;\n    case 'web':\n      serverEvent.setActionSource('website');\n      break;\n    default:\n      // `action_source` is required on a server event, so both an offline conversion and an\n      // undeterminable platform still have to send something. Meta has no generic offline\n      // value: 'physical_store' and 'system_generated' are narrower claims only the caller can\n      // make, so everything left lands in Meta's own catch-all.\n      serverEvent.setActionSource('other');\n      break;\n  }\n  return serverEvent;\n}\n\n/**\n * The shape `FacebookRequestError` exposes: `status` and `response` are the HTTP status and the\n * parsed error body, and both are null when the request never received a response.\n */\ntype MetaRequestError = { status?: number | null; message?: string; response?: unknown };\n\n/**\n * Meta's SDK rejects on API errors, where every other conversion sender here logs and resolves.\n * Keep the failure inside this module, so one rejected batch cannot fail the caller's request.\n * Never log the error itself: it also carries the access token, in both `url` and `data`.\n */\nfunction logError(error: unknown) {\n  const { status, message, response } = (error ?? {}) as MetaRequestError;\n  if (typeof status !== 'number') {\n    console.error(`Failed to send Meta conversion, network error: ${message ?? String(error)}`);\n    return;\n  }\n  console.error(\n    `Failed to send Meta conversion, status: ${status}, body: ${JSON.stringify(response)}`\n  );\n}\n\nexport async function sendEvent(\n  accessToken: string,\n  pixelId: string,\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  event: TrackEvent<any>,\n  data: UserProvidedData = {},\n  appPackageName?: string,\n  actionSource?: EventActionSource\n) {\n  if (IGNORED_EVENTS.includes(event.name)) return undefined;\n  const request = new EventRequest(accessToken, pixelId);\n  const fbEvent = getServerEvent(event, data, appPackageName, actionSource);\n  request.setEvents([fbEvent]);\n  try {\n    return await request.execute();\n  } catch (error) {\n    logError(error);\n    return undefined;\n  }\n}\n\nexport async function sendEvents(\n  accessToken: string,\n  pixelId: string,\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  events: TrackEvent<any>[],\n  data: UserProvidedData = {},\n  appPackageName?: string,\n  actionSource?: EventActionSource\n) {\n  const fbEvents = events\n    .filter((event) => !IGNORED_EVENTS.includes(event.name))\n    .map((event) => getServerEvent(event, data, appPackageName, actionSource));\n  if (fbEvents.length === 0) return undefined;\n  const request = new EventRequest(accessToken, pixelId);\n  request.setEvents(fbEvents);\n  try {\n    return await request.execute();\n  } catch (error) {\n    logError(error);\n    return undefined;\n  }\n}\n\nexport async function sendTestEvent(accessToken: string, pixelId: string, testEventCode: string) {\n  const extinfo = new ExtendedDeviceInfo()\n    .setExtInfoVersion('a2')\n    .setAppPackageName('com.some.app')\n    .setShortVersion('771')\n    .setLongVersion('Version 7.7.1')\n    .setOsVersion('10.1.1')\n    .setDeviceModelName('OnePlus6')\n    .setLocale('en_US')\n    .setTimezoneAbbreviation('GMT-1')\n    .setCarrier('TMobile')\n    .setScreenWidth(1920)\n    .setScreenHeight(1080)\n    .setScreenDensity('2.00')\n    .setCpuCoreCount(2)\n    .setTotalDiskSpaceGb(128)\n    .setFreeDiskSpaceGb(8)\n    .setDeviceTimeZone('USA/New York');\n\n  const userData = new UserData().setEmail('test@example.com');\n  const appData = new AppData().setExtinfo(extinfo);\n  const event = new ServerEvent()\n    .setEventId(Math.round(Math.random() * 1000_000).toString())\n    .setEventName('TestEvent')\n    .setEventTime(Math.round(Date.now() / 1000))\n    .setUserData(userData)\n    .setAppData(appData)\n    .setActionSource('app');\n\n  const request = new EventRequest(accessToken, pixelId);\n  request.setTestEventCode(testEventCode);\n  request.setEvents([event]);\n  return request.execute();\n}\n"],"mappings":"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"}

package/dist/server/meta-conversions-api.d.cts

@@ -1,9 +1,10 @@
 import { TrackEvent, UserProvidedData } from "../track/types.cjs";
+import { EventActionSource } from "./action-source.cjs";
 import { ServerEvent } from "facebook-nodejs-business-sdk";
 //#region src/server/meta-conversions-api.d.ts
-declare function getServerEvent(event: TrackEvent<any>, data: UserProvidedData, appPackageName?: string): ServerEvent;
-declare function sendEvent(accessToken: string, pixelId: string, event: TrackEvent<any>, data?: UserProvidedData, appPackageName?: string): Promise<import("facebook-nodejs-business-sdk").EventResponse | undefined>;
-declare function sendEvents(accessToken: string, pixelId: string, events: TrackEvent<any>[], data?: UserProvidedData, appPackageName?: string): Promise<import("facebook-nodejs-business-sdk").EventResponse | undefined>;
+declare function getServerEvent(event: TrackEvent<any>, data: UserProvidedData, appPackageName?: string, actionSource?: EventActionSource): ServerEvent;
+declare function sendEvent(accessToken: string, pixelId: string, event: TrackEvent<any>, data?: UserProvidedData, appPackageName?: string, actionSource?: EventActionSource): Promise<import("facebook-nodejs-business-sdk").EventResponse | undefined>;
+declare function sendEvents(accessToken: string, pixelId: string, events: TrackEvent<any>[], data?: UserProvidedData, appPackageName?: string, actionSource?: EventActionSource): Promise<import("facebook-nodejs-business-sdk").EventResponse | undefined>;
 declare function sendTestEvent(accessToken: string, pixelId: string, testEventCode: string): Promise<import("facebook-nodejs-business-sdk").EventResponse>;
 //#endregion
 export { getServerEvent, sendEvent, sendEvents, sendTestEvent };

package/dist/server/meta-conversions-api.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"meta-conversions-api.d.cts","names":[],"sources":["../../src/server/meta-conversions-api.ts"],"mappings":";;;iBAuOgB,eAEd,OAAO,iBACP,MAAM,kBACN,0BAAuB;iBAsDH,UACpB,qBACA,iBAEA,OAAO,iBACP,OAAM,kBACN,0BAAuB,+CAAA;iBAcH,WACpB,qBACA,iBAEA,QAAQ,mBACR,OAAM,kBACN,0BAAuB,+CAAA;iBAgBH,cAAc,qBAAqB,iBAAiB,wBAAqB,+CAAA"}
+{"version":3,"file":"meta-conversions-api.d.cts","names":[],"sources":["../../src/server/meta-conversions-api.ts"],"mappings":";;;;iBAwOgB,eAEd,OAAO,iBACP,MAAM,kBACN,yBACA,eAAe,oBAAiB;iBA4DZ,UACpB,qBACA,iBAEA,OAAO,iBACP,OAAM,kBACN,yBACA,eAAe,oBAAiB,+CAAA;iBAcZ,WACpB,qBACA,iBAEA,QAAQ,mBACR,OAAM,kBACN,yBACA,eAAe,oBAAiB,+CAAA;iBAgBZ,cAAc,qBAAqB,iBAAiB,wBAAqB,+CAAA"}

package/dist/server/meta-conversions-api.d.mts

@@ -1,9 +1,10 @@
 import { TrackEvent, UserProvidedData } from "../track/types.mjs";
+import { EventActionSource } from "./action-source.mjs";
 import { ServerEvent } from "facebook-nodejs-business-sdk";
 //#region src/server/meta-conversions-api.d.ts
-declare function getServerEvent(event: TrackEvent<any>, data: UserProvidedData, appPackageName?: string): ServerEvent;
-declare function sendEvent(accessToken: string, pixelId: string, event: TrackEvent<any>, data?: UserProvidedData, appPackageName?: string): Promise<import("facebook-nodejs-business-sdk").EventResponse | undefined>;
-declare function sendEvents(accessToken: string, pixelId: string, events: TrackEvent<any>[], data?: UserProvidedData, appPackageName?: string): Promise<import("facebook-nodejs-business-sdk").EventResponse | undefined>;
+declare function getServerEvent(event: TrackEvent<any>, data: UserProvidedData, appPackageName?: string, actionSource?: EventActionSource): ServerEvent;
+declare function sendEvent(accessToken: string, pixelId: string, event: TrackEvent<any>, data?: UserProvidedData, appPackageName?: string, actionSource?: EventActionSource): Promise<import("facebook-nodejs-business-sdk").EventResponse | undefined>;
+declare function sendEvents(accessToken: string, pixelId: string, events: TrackEvent<any>[], data?: UserProvidedData, appPackageName?: string, actionSource?: EventActionSource): Promise<import("facebook-nodejs-business-sdk").EventResponse | undefined>;
 declare function sendTestEvent(accessToken: string, pixelId: string, testEventCode: string): Promise<import("facebook-nodejs-business-sdk").EventResponse>;
 //#endregion
 export { getServerEvent, sendEvent, sendEvents, sendTestEvent };

package/dist/server/meta-conversions-api.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"meta-conversions-api.d.mts","names":[],"sources":["../../src/server/meta-conversions-api.ts"],"mappings":";;;iBAuOgB,eAEd,OAAO,iBACP,MAAM,kBACN,0BAAuB;iBAsDH,UACpB,qBACA,iBAEA,OAAO,iBACP,OAAM,kBACN,0BAAuB,+CAAA;iBAcH,WACpB,qBACA,iBAEA,QAAQ,mBACR,OAAM,kBACN,0BAAuB,+CAAA;iBAgBH,cAAc,qBAAqB,iBAAiB,wBAAqB,+CAAA"}
+{"version":3,"file":"meta-conversions-api.d.mts","names":[],"sources":["../../src/server/meta-conversions-api.ts"],"mappings":";;;;iBAwOgB,eAEd,OAAO,iBACP,MAAM,kBACN,yBACA,eAAe,oBAAiB;iBA4DZ,UACpB,qBACA,iBAEA,OAAO,iBACP,OAAM,kBACN,yBACA,eAAe,oBAAiB,+CAAA;iBAcZ,WACpB,qBACA,iBAEA,QAAQ,mBACR,OAAM,kBACN,yBACA,eAAe,oBAAiB,+CAAA;iBAgBZ,cAAc,qBAAqB,iBAAiB,wBAAqB,+CAAA"}

package/dist/server/meta-conversions-api.mjs

@@ -1,5 +1,6 @@
 import { IGNORED_EVENTS } from "../third-parties/ignored-events.mjs";
 import { mapFBEvent } from "../track/fbq.mjs";
+import { resolveActionSource } from "./action-source.mjs";
 import { AppData, Content, CustomData, EventRequest, ExtendedDeviceInfo, ServerEvent, UserData } from "facebook-nodejs-business-sdk";
 //#region src/server/meta-conversions-api.ts
 const USER_ASSIGNED_COUNTRIES = ["xk"];
@@ -119,24 +120,27 @@ function getCustomData({ name, properties }) {
 	data.setCustomProperties(custom_properties);
 	return data;
 }
-function getServerEvent(event, data, appPackageName) {
+function getServerEvent(event, data, appPackageName, actionSource) {
 	const userData = getUserData(event.tags, data);
 	const customData = getCustomData(event);
 	const [_, eventName] = mapFBEvent(event.name, event.properties);
 	const serverEvent = new ServerEvent().setEventId(event.tags.idempotency_key ?? event.id).setEventName(eventName).setEventTime(Math.round(Date.now() / 1e3)).setUserData(userData).setCustomData(customData);
-	if (event.tags.source === "app" && appPackageName) {
+	const source = resolveActionSource(event.platform, actionSource);
+	if (source === "app" && appPackageName) {
 		const appData = getAppData(event.tags, appPackageName);
 		serverEvent.setAppData(appData);
 	}
 	if (event.tags.source_url) serverEvent.setEventSourceUrl(event.tags.source_url);
-	switch (event.tags.source) {
+	switch (source) {
 		case "app":
 			serverEvent.setActionSource("app");
 			break;
 		case "web":
 			serverEvent.setActionSource("website");
 			break;
-		default: break;
+		default:
+			serverEvent.setActionSource("other");
+			break;
 	}
 	return serverEvent;
 }
@@ -153,10 +157,10 @@ function logError(error) {
 	}
 	console.error(`Failed to send Meta conversion, status: ${status}, body: ${JSON.stringify(response)}`);
 }
-async function sendEvent(accessToken, pixelId, event, data = {}, appPackageName) {
+async function sendEvent(accessToken, pixelId, event, data = {}, appPackageName, actionSource) {
 	if (IGNORED_EVENTS.includes(event.name)) return void 0;
 	const request = new EventRequest(accessToken, pixelId);
-	const fbEvent = getServerEvent(event, data, appPackageName);
+	const fbEvent = getServerEvent(event, data, appPackageName, actionSource);
 	request.setEvents([fbEvent]);
 	try {
 		return await request.execute();
@@ -165,8 +169,8 @@ async function sendEvent(accessToken, pixelId, event, data = {}, appPackageName)
 		return;
 	}
 }
-async function sendEvents(accessToken, pixelId, events, data = {}, appPackageName) {
-	const fbEvents = events.filter((event) => !IGNORED_EVENTS.includes(event.name)).map((event) => getServerEvent(event, data, appPackageName));
+async function sendEvents(accessToken, pixelId, events, data = {}, appPackageName, actionSource) {
+	const fbEvents = events.filter((event) => !IGNORED_EVENTS.includes(event.name)).map((event) => getServerEvent(event, data, appPackageName, actionSource));
 	if (fbEvents.length === 0) return void 0;
 	const request = new EventRequest(accessToken, pixelId);
 	request.setEvents(fbEvents);

package/dist/server/meta-conversions-api.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"meta-conversions-api.mjs","names":[],"sources":["../../src/server/meta-conversions-api.ts"],"sourcesContent":["import {\n  AppData,\n  Content,\n  CustomData,\n  EventRequest,\n  ExtendedDeviceInfo,\n  ServerEvent,\n  UserData,\n} from 'facebook-nodejs-business-sdk';\nimport { IGNORED_EVENTS } from '../third-parties/ignored-events';\nimport { mapFBEvent } from '../track/fbq';\nimport type { TrackEvent, TrackTags, UserProvidedData } from '../track/types';\n\nconst USER_ASSIGNED_COUNTRIES: string[] = ['xk'];\nfunction normalizeCountry(input: string | undefined): string | undefined {\n  const country = input?.split(/[-_]/).at(0)?.toLowerCase();\n  if (!country) return undefined;\n  return USER_ASSIGNED_COUNTRIES.includes(country) ? undefined : country;\n}\n\nfunction getUserData(tags: TrackTags, data: UserProvidedData) {\n  const userData = new UserData();\n\n  // set user-provided data\n  if (data.email) {\n    if (Array.isArray(data.email)) {\n      userData.setEmails(data.email);\n    } else {\n      userData.setEmail(data.email);\n    }\n  }\n  if (data.phone_number) {\n    if (Array.isArray(data.phone_number)) {\n      userData.setPhones(data.phone_number);\n    } else {\n      userData.setPhone(data.phone_number);\n    }\n  }\n  if (data.gender) {\n    if (data.gender === 'female') {\n      userData.setGender('f');\n      // oxlint-disable-next-line typescript/no-unnecessary-condition -- user-provided data may carry values outside the declared union at runtime\n    } else if (data.gender === 'male') {\n      userData.setGender('m');\n    }\n  }\n  if (data.address) {\n    if (Array.isArray(data.address)) {\n      const firstNames = data.address.map((a) => a.first_name).filter(Boolean);\n      const lastNames = data.address.map((a) => a.last_name).filter(Boolean);\n      const cities = data.address.map((a) => a.city).filter(Boolean);\n      const states = data.address.map((a) => a.region).filter(Boolean);\n      const postalCodes = data.address.map((a) => a.postal_code).filter(Boolean);\n      const countries = data.address.map((a) => normalizeCountry(a.country)).filter(Boolean);\n\n      userData.setFirstNames(firstNames as string[]);\n      userData.setLastNames(lastNames as string[]);\n      userData.setCities(cities as string[]);\n      userData.setStates(states as string[]);\n      userData.setZips(postalCodes as string[]);\n      userData.setCountries(countries as string[]);\n    } else {\n      if (data.address.first_name) {\n        userData.setFirstName(data.address.first_name);\n        userData.setF5First(data.address.first_name.slice(0, 5));\n      }\n      if (data.address.last_name) {\n        userData.setLastName(data.address.last_name);\n        userData.setF5Last(data.address.last_name.slice(0, 5));\n      }\n      if (data.address.city) userData.setCity(data.address.city);\n      if (data.address.region) userData.setState(data.address.region);\n      if (data.address.postal_code) userData.setZip(data.address.postal_code);\n      if (data.address.country) {\n        const country = normalizeCountry(data.address.country);\n        if (country) userData.setCountry(country);\n      }\n    }\n  }\n  if (data.birthday) {\n    userData.setDoby(data.birthday.year.toString());\n    userData.setDobm(data.birthday.month.toString());\n    userData.setDobd(data.birthday.day.toString());\n  }\n  if (data.user_id && data.user_id.length !== 0) {\n    userData.setExternalId(data.user_id);\n  }\n  if (data.ip_address) {\n    userData.setClientIpAddress(data.ip_address);\n  }\n  if (data.user_agent) {\n    userData.setClientUserAgent(data.user_agent);\n  }\n  if (data.fb_login_id) {\n    userData.setFbLoginId(data.fb_login_id);\n  }\n  if (data.fb_page_id) {\n    userData.setPageId(data.fb_page_id);\n  }\n\n  // set tags info\n  if (tags.fbc) {\n    userData.setFbc(tags.fbc);\n  } else if (tags.fbclid) {\n    // ref: https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/fbp-and-fbc#2--format-clickid\n    // The formatted ClickID value must be of the form `version.subdomainIndex.creationTime.<fbclid>`, where:\n    // - version is always this prefix: fb\n    // - subdomainIndex is which domain the cookie is defined on ('com' = 0, 'example.com' = 1, 'www.example.com' = 2)\n    // - creationTime is the UNIX time since epoch in milliseconds when the _fbc was stored. If you don't save the _fbc cookie, use the timestamp when you first observed or received this fbclid value\n    // - <fbclid> is the value for the fbclid query parameter in the page URL.\n\n    const fbc = `fb.1.${Date.now()}.${tags.fbclid}`;\n    userData.setFbc(fbc);\n  }\n\n  if (tags.fbp) {\n    userData.setFbp(tags.fbp);\n  }\n  if (tags.advertising_id) {\n    userData.setMadid(tags.advertising_id);\n  }\n  if (tags.ip_address && typeof tags.ip_address === 'string') {\n    userData.setClientIpAddress(tags.ip_address);\n  }\n\n  return userData;\n}\n\nfunction getAppData(tags: TrackTags, appPackageName: string) {\n  const extinfo = new ExtendedDeviceInfo();\n  if (tags.os_name) {\n    if (tags.os_name === 'iOS' || tags.os_name === 'iPadOS') {\n      extinfo.setExtInfoVersion('i2');\n    } else if (tags.os_name === 'Android') {\n      extinfo.setExtInfoVersion('a2');\n    }\n  }\n  extinfo.setAppPackageName(appPackageName);\n  const shortVersion = tags.release?.split('.').at(0);\n  if (shortVersion) {\n    extinfo.setShortVersion(shortVersion);\n  }\n  if (tags.release) {\n    extinfo.setLongVersion(tags.release);\n  }\n  if (tags.os_version) {\n    extinfo.setOsVersion(tags.os_version);\n  }\n  if (tags.device_model_id) {\n    extinfo.setDeviceModelName(tags.device_model_id);\n  }\n  if (tags.language) {\n    extinfo.setLocale(tags.language);\n  }\n  if (tags.screen_width) {\n    extinfo.setScreenWidth(tags.screen_width);\n  }\n  if (tags.screen_height) {\n    extinfo.setScreenHeight(tags.screen_height);\n  }\n  if (tags.device_pixel_ratio) {\n    extinfo.setScreenDensity(tags.device_pixel_ratio.toString());\n  }\n\n  const appData = new AppData();\n  appData.setExtinfo(extinfo);\n  if (tags.install_referrer) {\n    appData.setInstallReferrer(tags.install_referrer);\n  }\n  if (tags.advertising_id) {\n    appData.setAdvertiserTrackingEnabled(true);\n  }\n  if (tags.install_referrer) {\n    appData.setInstallReferrer(tags.install_referrer);\n  }\n\n  return appData;\n}\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\nfunction getCustomData({ name, properties }: TrackEvent<any>) {\n  const data = new CustomData();\n  const [_, _name, fbEventProperties] = mapFBEvent(name, properties);\n  const {\n    value,\n    currency,\n    content_name,\n    content_category,\n    content_ids,\n    contents,\n    content_type,\n    // order_id,\n    predicted_ltv,\n    num_items,\n    search_string,\n    status,\n    // item_number,\n    delivery_category,\n    ...custom_properties\n  } = fbEventProperties;\n  // oxlint-disable-next-line typescript/no-unnecessary-condition -- custom event properties may carry `value: null` at runtime despite the declared type\n  if (value !== undefined && value !== null) data.setValue(value);\n  if (currency) data.setCurrency(currency);\n  if (content_name) data.setContentName(content_name);\n  if (content_category) data.setContentCategory(content_category);\n  if (content_ids) data.setContentIds(content_ids);\n  if (contents)\n    data.setContents(\n      contents.map((c) => {\n        const result = new Content().setId(c.id).setQuantity(c.quantity);\n        if (c.item_price) result.setItemPrice(c.item_price);\n        if (c.title) result.setTitle(c.title);\n        if (c.description) result.setDescription(c.description);\n        if (c.brand) result.setBrand(c.brand);\n        if (c.category) result.setCategory(c.category);\n        if (c.delivery_category) result.setDeliveryCategory(c.delivery_category);\n        return result;\n      })\n    );\n  if (content_type) data.setContentType(content_type);\n  // if (order_id) data.setOrderId(order_id);\n  if (predicted_ltv) data.setPredictedLtv(predicted_ltv);\n  if (num_items) data.setNumItems(num_items);\n  if (search_string) data.setSearchString(search_string);\n  if (status) data.setStatus(status.toString());\n  // if (item_number) data.setItemNumber(item_number);\n  if (delivery_category) data.setDeliveryCategory(delivery_category);\n  data.setCustomProperties(custom_properties);\n  return data;\n}\n\nexport function getServerEvent(\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  event: TrackEvent<any>,\n  data: UserProvidedData,\n  appPackageName?: string\n) {\n  const userData = getUserData(event.tags, data);\n  const customData = getCustomData(event);\n  const [_, eventName] = mapFBEvent(event.name, event.properties);\n  const serverEvent = new ServerEvent()\n    .setEventId(event.tags.idempotency_key ?? event.id)\n    .setEventName(eventName)\n    .setEventTime(Math.round(Date.now() / 1000))\n    .setUserData(userData)\n    .setCustomData(customData);\n\n  if (event.tags.source === 'app' && appPackageName) {\n    const appData = getAppData(event.tags, appPackageName);\n    serverEvent.setAppData(appData);\n  }\n  if (event.tags.source_url) {\n    serverEvent.setEventSourceUrl(event.tags.source_url);\n  }\n  switch (event.tags.source) {\n    case 'app':\n      serverEvent.setActionSource('app');\n      break;\n    case 'web':\n      serverEvent.setActionSource('website');\n      break;\n    default:\n      break;\n  }\n  return serverEvent;\n}\n\n/**\n * The shape `FacebookRequestError` exposes: `status` and `response` are the HTTP status and the\n * parsed error body, and both are null when the request never received a response.\n */\ntype MetaRequestError = { status?: number | null; message?: string; response?: unknown };\n\n/**\n * Meta's SDK rejects on API errors, where every other conversion sender here logs and resolves.\n * Keep the failure inside this module, so one rejected batch cannot fail the caller's request.\n * Never log the error itself: it also carries the access token, in both `url` and `data`.\n */\nfunction logError(error: unknown) {\n  const { status, message, response } = (error ?? {}) as MetaRequestError;\n  if (typeof status !== 'number') {\n    console.error(`Failed to send Meta conversion, network error: ${message ?? String(error)}`);\n    return;\n  }\n  console.error(\n    `Failed to send Meta conversion, status: ${status}, body: ${JSON.stringify(response)}`\n  );\n}\n\nexport async function sendEvent(\n  accessToken: string,\n  pixelId: string,\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  event: TrackEvent<any>,\n  data: UserProvidedData = {},\n  appPackageName?: string\n) {\n  if (IGNORED_EVENTS.includes(event.name)) return undefined;\n  const request = new EventRequest(accessToken, pixelId);\n  const fbEvent = getServerEvent(event, data, appPackageName);\n  request.setEvents([fbEvent]);\n  try {\n    return await request.execute();\n  } catch (error) {\n    logError(error);\n    return undefined;\n  }\n}\n\nexport async function sendEvents(\n  accessToken: string,\n  pixelId: string,\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  events: TrackEvent<any>[],\n  data: UserProvidedData = {},\n  appPackageName?: string\n) {\n  const fbEvents = events\n    .filter((event) => !IGNORED_EVENTS.includes(event.name))\n    .map((event) => getServerEvent(event, data, appPackageName));\n  if (fbEvents.length === 0) return undefined;\n  const request = new EventRequest(accessToken, pixelId);\n  request.setEvents(fbEvents);\n  try {\n    return await request.execute();\n  } catch (error) {\n    logError(error);\n    return undefined;\n  }\n}\n\nexport async function sendTestEvent(accessToken: string, pixelId: string, testEventCode: string) {\n  const extinfo = new ExtendedDeviceInfo()\n    .setExtInfoVersion('a2')\n    .setAppPackageName('com.some.app')\n    .setShortVersion('771')\n    .setLongVersion('Version 7.7.1')\n    .setOsVersion('10.1.1')\n    .setDeviceModelName('OnePlus6')\n    .setLocale('en_US')\n    .setTimezoneAbbreviation('GMT-1')\n    .setCarrier('TMobile')\n    .setScreenWidth(1920)\n    .setScreenHeight(1080)\n    .setScreenDensity('2.00')\n    .setCpuCoreCount(2)\n    .setTotalDiskSpaceGb(128)\n    .setFreeDiskSpaceGb(8)\n    .setDeviceTimeZone('USA/New York');\n\n  const userData = new UserData().setEmail('test@example.com');\n  const appData = new AppData().setExtinfo(extinfo);\n  const event = new ServerEvent()\n    .setEventId(Math.round(Math.random() * 1000_000).toString())\n    .setEventName('TestEvent')\n    .setEventTime(Math.round(Date.now() / 1000))\n    .setUserData(userData)\n    .setAppData(appData)\n    .setActionSource('app');\n\n  const request = new EventRequest(accessToken, pixelId);\n  request.setTestEventCode(testEventCode);\n  request.setEvents([event]);\n  return request.execute();\n}\n"],"mappings":"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"}
+{"version":3,"file":"meta-conversions-api.mjs","names":[],"sources":["../../src/server/meta-conversions-api.ts"],"sourcesContent":["import {\n  AppData,\n  Content,\n  CustomData,\n  EventRequest,\n  ExtendedDeviceInfo,\n  ServerEvent,\n  UserData,\n} from 'facebook-nodejs-business-sdk';\nimport { IGNORED_EVENTS } from '../third-parties/ignored-events';\nimport { mapFBEvent } from '../track/fbq';\nimport type { TrackEvent, TrackTags, UserProvidedData } from '../track/types';\nimport { type EventActionSource, resolveActionSource } from './action-source';\n\nconst USER_ASSIGNED_COUNTRIES: string[] = ['xk'];\nfunction normalizeCountry(input: string | undefined): string | undefined {\n  const country = input?.split(/[-_]/).at(0)?.toLowerCase();\n  if (!country) return undefined;\n  return USER_ASSIGNED_COUNTRIES.includes(country) ? undefined : country;\n}\n\nfunction getUserData(tags: TrackTags, data: UserProvidedData) {\n  const userData = new UserData();\n\n  // set user-provided data\n  if (data.email) {\n    if (Array.isArray(data.email)) {\n      userData.setEmails(data.email);\n    } else {\n      userData.setEmail(data.email);\n    }\n  }\n  if (data.phone_number) {\n    if (Array.isArray(data.phone_number)) {\n      userData.setPhones(data.phone_number);\n    } else {\n      userData.setPhone(data.phone_number);\n    }\n  }\n  if (data.gender) {\n    if (data.gender === 'female') {\n      userData.setGender('f');\n      // oxlint-disable-next-line typescript/no-unnecessary-condition -- user-provided data may carry values outside the declared union at runtime\n    } else if (data.gender === 'male') {\n      userData.setGender('m');\n    }\n  }\n  if (data.address) {\n    if (Array.isArray(data.address)) {\n      const firstNames = data.address.map((a) => a.first_name).filter(Boolean);\n      const lastNames = data.address.map((a) => a.last_name).filter(Boolean);\n      const cities = data.address.map((a) => a.city).filter(Boolean);\n      const states = data.address.map((a) => a.region).filter(Boolean);\n      const postalCodes = data.address.map((a) => a.postal_code).filter(Boolean);\n      const countries = data.address.map((a) => normalizeCountry(a.country)).filter(Boolean);\n\n      userData.setFirstNames(firstNames as string[]);\n      userData.setLastNames(lastNames as string[]);\n      userData.setCities(cities as string[]);\n      userData.setStates(states as string[]);\n      userData.setZips(postalCodes as string[]);\n      userData.setCountries(countries as string[]);\n    } else {\n      if (data.address.first_name) {\n        userData.setFirstName(data.address.first_name);\n        userData.setF5First(data.address.first_name.slice(0, 5));\n      }\n      if (data.address.last_name) {\n        userData.setLastName(data.address.last_name);\n        userData.setF5Last(data.address.last_name.slice(0, 5));\n      }\n      if (data.address.city) userData.setCity(data.address.city);\n      if (data.address.region) userData.setState(data.address.region);\n      if (data.address.postal_code) userData.setZip(data.address.postal_code);\n      if (data.address.country) {\n        const country = normalizeCountry(data.address.country);\n        if (country) userData.setCountry(country);\n      }\n    }\n  }\n  if (data.birthday) {\n    userData.setDoby(data.birthday.year.toString());\n    userData.setDobm(data.birthday.month.toString());\n    userData.setDobd(data.birthday.day.toString());\n  }\n  if (data.user_id && data.user_id.length !== 0) {\n    userData.setExternalId(data.user_id);\n  }\n  if (data.ip_address) {\n    userData.setClientIpAddress(data.ip_address);\n  }\n  if (data.user_agent) {\n    userData.setClientUserAgent(data.user_agent);\n  }\n  if (data.fb_login_id) {\n    userData.setFbLoginId(data.fb_login_id);\n  }\n  if (data.fb_page_id) {\n    userData.setPageId(data.fb_page_id);\n  }\n\n  // set tags info\n  if (tags.fbc) {\n    userData.setFbc(tags.fbc);\n  } else if (tags.fbclid) {\n    // ref: https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/fbp-and-fbc#2--format-clickid\n    // The formatted ClickID value must be of the form `version.subdomainIndex.creationTime.<fbclid>`, where:\n    // - version is always this prefix: fb\n    // - subdomainIndex is which domain the cookie is defined on ('com' = 0, 'example.com' = 1, 'www.example.com' = 2)\n    // - creationTime is the UNIX time since epoch in milliseconds when the _fbc was stored. If you don't save the _fbc cookie, use the timestamp when you first observed or received this fbclid value\n    // - <fbclid> is the value for the fbclid query parameter in the page URL.\n\n    const fbc = `fb.1.${Date.now()}.${tags.fbclid}`;\n    userData.setFbc(fbc);\n  }\n\n  if (tags.fbp) {\n    userData.setFbp(tags.fbp);\n  }\n  if (tags.advertising_id) {\n    userData.setMadid(tags.advertising_id);\n  }\n  if (tags.ip_address && typeof tags.ip_address === 'string') {\n    userData.setClientIpAddress(tags.ip_address);\n  }\n\n  return userData;\n}\n\nfunction getAppData(tags: TrackTags, appPackageName: string) {\n  const extinfo = new ExtendedDeviceInfo();\n  if (tags.os_name) {\n    if (tags.os_name === 'iOS' || tags.os_name === 'iPadOS') {\n      extinfo.setExtInfoVersion('i2');\n    } else if (tags.os_name === 'Android') {\n      extinfo.setExtInfoVersion('a2');\n    }\n  }\n  extinfo.setAppPackageName(appPackageName);\n  const shortVersion = tags.release?.split('.').at(0);\n  if (shortVersion) {\n    extinfo.setShortVersion(shortVersion);\n  }\n  if (tags.release) {\n    extinfo.setLongVersion(tags.release);\n  }\n  if (tags.os_version) {\n    extinfo.setOsVersion(tags.os_version);\n  }\n  if (tags.device_model_id) {\n    extinfo.setDeviceModelName(tags.device_model_id);\n  }\n  if (tags.language) {\n    extinfo.setLocale(tags.language);\n  }\n  if (tags.screen_width) {\n    extinfo.setScreenWidth(tags.screen_width);\n  }\n  if (tags.screen_height) {\n    extinfo.setScreenHeight(tags.screen_height);\n  }\n  if (tags.device_pixel_ratio) {\n    extinfo.setScreenDensity(tags.device_pixel_ratio.toString());\n  }\n\n  const appData = new AppData();\n  appData.setExtinfo(extinfo);\n  if (tags.install_referrer) {\n    appData.setInstallReferrer(tags.install_referrer);\n  }\n  if (tags.advertising_id) {\n    appData.setAdvertiserTrackingEnabled(true);\n  }\n  if (tags.install_referrer) {\n    appData.setInstallReferrer(tags.install_referrer);\n  }\n\n  return appData;\n}\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\nfunction getCustomData({ name, properties }: TrackEvent<any>) {\n  const data = new CustomData();\n  const [_, _name, fbEventProperties] = mapFBEvent(name, properties);\n  const {\n    value,\n    currency,\n    content_name,\n    content_category,\n    content_ids,\n    contents,\n    content_type,\n    // order_id,\n    predicted_ltv,\n    num_items,\n    search_string,\n    status,\n    // item_number,\n    delivery_category,\n    ...custom_properties\n  } = fbEventProperties;\n  // oxlint-disable-next-line typescript/no-unnecessary-condition -- custom event properties may carry `value: null` at runtime despite the declared type\n  if (value !== undefined && value !== null) data.setValue(value);\n  if (currency) data.setCurrency(currency);\n  if (content_name) data.setContentName(content_name);\n  if (content_category) data.setContentCategory(content_category);\n  if (content_ids) data.setContentIds(content_ids);\n  if (contents)\n    data.setContents(\n      contents.map((c) => {\n        const result = new Content().setId(c.id).setQuantity(c.quantity);\n        if (c.item_price) result.setItemPrice(c.item_price);\n        if (c.title) result.setTitle(c.title);\n        if (c.description) result.setDescription(c.description);\n        if (c.brand) result.setBrand(c.brand);\n        if (c.category) result.setCategory(c.category);\n        if (c.delivery_category) result.setDeliveryCategory(c.delivery_category);\n        return result;\n      })\n    );\n  if (content_type) data.setContentType(content_type);\n  // if (order_id) data.setOrderId(order_id);\n  if (predicted_ltv) data.setPredictedLtv(predicted_ltv);\n  if (num_items) data.setNumItems(num_items);\n  if (search_string) data.setSearchString(search_string);\n  if (status) data.setStatus(status.toString());\n  // if (item_number) data.setItemNumber(item_number);\n  if (delivery_category) data.setDeliveryCategory(delivery_category);\n  data.setCustomProperties(custom_properties);\n  return data;\n}\n\nexport function getServerEvent(\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  event: TrackEvent<any>,\n  data: UserProvidedData,\n  appPackageName?: string,\n  actionSource?: EventActionSource\n) {\n  const userData = getUserData(event.tags, data);\n  const customData = getCustomData(event);\n  const [_, eventName] = mapFBEvent(event.name, event.properties);\n  const serverEvent = new ServerEvent()\n    .setEventId(event.tags.idempotency_key ?? event.id)\n    .setEventName(eventName)\n    .setEventTime(Math.round(Date.now() / 1000))\n    .setUserData(userData)\n    .setCustomData(customData);\n\n  const source = resolveActionSource(event.platform, actionSource);\n  if (source === 'app' && appPackageName) {\n    const appData = getAppData(event.tags, appPackageName);\n    serverEvent.setAppData(appData);\n  }\n  if (event.tags.source_url) {\n    serverEvent.setEventSourceUrl(event.tags.source_url);\n  }\n  switch (source) {\n    case 'app':\n      serverEvent.setActionSource('app');\n      break;\n    case 'web':\n      serverEvent.setActionSource('website');\n      break;\n    default:\n      // `action_source` is required on a server event, so both an offline conversion and an\n      // undeterminable platform still have to send something. Meta has no generic offline\n      // value: 'physical_store' and 'system_generated' are narrower claims only the caller can\n      // make, so everything left lands in Meta's own catch-all.\n      serverEvent.setActionSource('other');\n      break;\n  }\n  return serverEvent;\n}\n\n/**\n * The shape `FacebookRequestError` exposes: `status` and `response` are the HTTP status and the\n * parsed error body, and both are null when the request never received a response.\n */\ntype MetaRequestError = { status?: number | null; message?: string; response?: unknown };\n\n/**\n * Meta's SDK rejects on API errors, where every other conversion sender here logs and resolves.\n * Keep the failure inside this module, so one rejected batch cannot fail the caller's request.\n * Never log the error itself: it also carries the access token, in both `url` and `data`.\n */\nfunction logError(error: unknown) {\n  const { status, message, response } = (error ?? {}) as MetaRequestError;\n  if (typeof status !== 'number') {\n    console.error(`Failed to send Meta conversion, network error: ${message ?? String(error)}`);\n    return;\n  }\n  console.error(\n    `Failed to send Meta conversion, status: ${status}, body: ${JSON.stringify(response)}`\n  );\n}\n\nexport async function sendEvent(\n  accessToken: string,\n  pixelId: string,\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  event: TrackEvent<any>,\n  data: UserProvidedData = {},\n  appPackageName?: string,\n  actionSource?: EventActionSource\n) {\n  if (IGNORED_EVENTS.includes(event.name)) return undefined;\n  const request = new EventRequest(accessToken, pixelId);\n  const fbEvent = getServerEvent(event, data, appPackageName, actionSource);\n  request.setEvents([fbEvent]);\n  try {\n    return await request.execute();\n  } catch (error) {\n    logError(error);\n    return undefined;\n  }\n}\n\nexport async function sendEvents(\n  accessToken: string,\n  pixelId: string,\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  events: TrackEvent<any>[],\n  data: UserProvidedData = {},\n  appPackageName?: string,\n  actionSource?: EventActionSource\n) {\n  const fbEvents = events\n    .filter((event) => !IGNORED_EVENTS.includes(event.name))\n    .map((event) => getServerEvent(event, data, appPackageName, actionSource));\n  if (fbEvents.length === 0) return undefined;\n  const request = new EventRequest(accessToken, pixelId);\n  request.setEvents(fbEvents);\n  try {\n    return await request.execute();\n  } catch (error) {\n    logError(error);\n    return undefined;\n  }\n}\n\nexport async function sendTestEvent(accessToken: string, pixelId: string, testEventCode: string) {\n  const extinfo = new ExtendedDeviceInfo()\n    .setExtInfoVersion('a2')\n    .setAppPackageName('com.some.app')\n    .setShortVersion('771')\n    .setLongVersion('Version 7.7.1')\n    .setOsVersion('10.1.1')\n    .setDeviceModelName('OnePlus6')\n    .setLocale('en_US')\n    .setTimezoneAbbreviation('GMT-1')\n    .setCarrier('TMobile')\n    .setScreenWidth(1920)\n    .setScreenHeight(1080)\n    .setScreenDensity('2.00')\n    .setCpuCoreCount(2)\n    .setTotalDiskSpaceGb(128)\n    .setFreeDiskSpaceGb(8)\n    .setDeviceTimeZone('USA/New York');\n\n  const userData = new UserData().setEmail('test@example.com');\n  const appData = new AppData().setExtinfo(extinfo);\n  const event = new ServerEvent()\n    .setEventId(Math.round(Math.random() * 1000_000).toString())\n    .setEventName('TestEvent')\n    .setEventTime(Math.round(Date.now() / 1000))\n    .setUserData(userData)\n    .setAppData(appData)\n    .setActionSource('app');\n\n  const request = new EventRequest(accessToken, pixelId);\n  request.setTestEventCode(testEventCode);\n  request.setEvents([event]);\n  return request.execute();\n}\n"],"mappings":"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"}