@shware/analytics 3.6.4 → 3.8.0

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

@@ -1,107 +1,80 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/server/openai-conversions-api.ts
-var openai_conversions_api_exports = {};
-__export(openai_conversions_api_exports, {
-  getServerEvent: () => getServerEvent,
-  sendEvents: () => sendEvents
-});
-module.exports = __toCommonJS(openai_conversions_api_exports);
-var import_node_crypto = require("crypto");
-var import_utils = require("@shware/utils");
-var import_ignored_events = require("../third-parties/ignored-events.cjs");
-var import_oaiq = require("../track/oaiq.cjs");
-var import_field = require("../utils/field.cjs");
-var ENDPOINT = "https://bzr.openai.com/v1/events";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_third_parties_ignored_events = require("../third-parties/ignored-events.cjs");
+const require_utils_field = require("../utils/field.cjs");
+const require_track_oaiq = require("../track/oaiq.cjs");
+let _shware_utils = require("@shware/utils");
+let node_crypto = require("node:crypto");
+//#region src/server/openai-conversions-api.ts
+/**
+* OpenAI Conversions API
+* https://developers.openai.com/ads/conversions-api
+* https://developers.openai.com/ads/supported-events
+*/
+const ENDPOINT = "https://bzr.openai.com/v1/events";
 function sha256(value) {
-  return (0, import_node_crypto.createHash)("sha256").update(value).digest("hex");
+	return (0, node_crypto.createHash)("sha256").update(value).digest("hex");
 }
 function mapActionSource(source) {
-  switch (source) {
-    case "web":
-      return "web";
-    case "app":
-      return "mobile_app";
-    case "offline":
-      return "offline";
-    default:
-      return void 0;
-  }
+	switch (source) {
+		case "web": return "web";
+		case "app": return "mobile_app";
+		case "offline": return "offline";
+		default: return;
+	}
 }
 function getUser(data) {
-  var _a, _b, _c;
-  const email = (_a = (0, import_field.getFirst)(data.email)) == null ? void 0 : _a.trim().toLowerCase();
-  const address = (0, import_field.getFirst)(data.address);
-  const user = {
-    email_sha256: email ? sha256(email) : void 0,
-    external_id_sha256: data.user_id ? sha256(data.user_id) : void 0,
-    country: (_b = address == null ? void 0 : address.country) == null ? void 0 : _b.trim().toUpperCase(),
-    city: (_c = address == null ? void 0 : address.city) == null ? void 0 : _c.trim().toLowerCase(),
-    zip_code: address == null ? void 0 : address.postal_code,
-    ip_address: data.ip_address,
-    user_agent: data.user_agent
-  };
-  return Object.values(user).some((value) => value !== void 0) ? user : void 0;
+	const email = require_utils_field.getFirst(data.email)?.trim().toLowerCase();
+	const address = require_utils_field.getFirst(data.address);
+	const user = {
+		email_sha256: email ? sha256(email) : void 0,
+		external_id_sha256: data.user_id ? sha256(data.user_id) : void 0,
+		country: address?.country?.trim().toUpperCase(),
+		city: address?.city?.trim().toLowerCase(),
+		zip_code: address?.postal_code,
+		ip_address: data.ip_address,
+		user_agent: data.user_agent
+	};
+	return Object.values(user).some((value) => value !== void 0) ? user : void 0;
 }
 function getServerEvent(event, data) {
-  const { type, data: eventData } = (0, import_oaiq.mapOAIEvent)(event.name, event.properties);
-  return {
-    id: event.tags.idempotency_key ?? event.id.toString(),
-    type,
-    // For custom events the original track name is the OpenAI custom_event_name; this matches
-    // the browser pixel so the two deduplicate. Standard events omit it.
-    custom_event_name: type === "custom" ? event.name : void 0,
-    timestamp_ms: Date.now(),
-    source_url: event.tags.source_url,
-    action_source: mapActionSource(event.tags.source),
-    user: getUser(data),
-    data: eventData
-  };
+	const { type, data: eventData } = require_track_oaiq.mapOAIEvent(event.name, event.properties);
+	return {
+		id: event.tags.idempotency_key ?? event.id.toString(),
+		type,
+		custom_event_name: type === "custom" ? event.name : void 0,
+		timestamp_ms: Date.now(),
+		source_url: event.tags.source_url,
+		action_source: mapActionSource(event.tags.source),
+		user: getUser(data),
+		data: eventData
+	};
 }
 async function sendEvents(apiKey, pixelId, events, data = {}, validateOnly = false) {
-  const dto = {
-    validate_only: validateOnly,
-    events: events.filter((event) => !import_ignored_events.IGNORED_EVENTS.includes(event.name)).filter((event) => !import_oaiq.NON_AD_EVENTS.includes(event.name)).map((event) => getServerEvent(event, data))
-  };
-  if (dto.events.length === 0) return;
-  try {
-    const response = await (0, import_utils.fetch)(`${ENDPOINT}?pid=${pixelId}`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Accept: "application/json",
-        Authorization: `Bearer ${apiKey}`
-      },
-      body: JSON.stringify(dto)
-    });
-    if (response.ok) return;
-    const { status } = response;
-    const message = await response.text();
-    console.error(`Failed to send OpenAI conversion, status: ${status}, body: ${message}`);
-  } catch (error) {
-    console.error("Failed to send OpenAI conversion, network error:", error);
-  }
+	const dto = {
+		validate_only: validateOnly,
+		events: events.filter((event) => !require_third_parties_ignored_events.IGNORED_EVENTS.includes(event.name)).filter((event) => !require_track_oaiq.NON_AD_EVENTS.includes(event.name)).map((event) => getServerEvent(event, data))
+	};
+	if (dto.events.length === 0) return;
+	try {
+		const response = await (0, _shware_utils.fetch)(`${ENDPOINT}?pid=${pixelId}`, {
+			method: "POST",
+			headers: {
+				"Content-Type": "application/json",
+				Accept: "application/json",
+				Authorization: `Bearer ${apiKey}`
+			},
+			body: JSON.stringify(dto)
+		});
+		if (response.ok) return;
+		const { status } = response;
+		const message = await response.text();
+		console.error(`Failed to send OpenAI conversion, status: ${status}, body: ${message}`);
+	} catch (error) {
+		console.error("Failed to send OpenAI conversion, network error:", error);
+	}
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getServerEvent,
-  sendEvents
-});
+//#endregion
+exports.getServerEvent = getServerEvent;
+exports.sendEvents = sendEvents;
+
 //# sourceMappingURL=openai-conversions-api.cjs.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/server/openai-conversions-api.ts"],"sourcesContent":["/**\n * OpenAI Conversions API\n * https://developers.openai.com/ads/conversions-api\n * https://developers.openai.com/ads/supported-events\n */\nimport { createHash } from 'node:crypto';\nimport { fetch } from '@shware/utils';\nimport { IGNORED_EVENTS } from '../third-parties/ignored-events';\nimport { type EventData, NON_AD_EVENTS, mapOAIEvent } from '../track/oaiq';\nimport type { TrackEvent, TrackTags, UserProvidedData } from '../track/types';\nimport { getFirst } from '../utils/field';\n\nconst ENDPOINT = 'https://bzr.openai.com/v1/events';\n\ntype ActionSource =\n  | 'web'\n  | 'mobile_app'\n  | 'offline'\n  | 'physical_store'\n  | 'phone_call'\n  | 'email'\n  | 'other';\n\n/**\n * User/identity fields. Email and external id must be sent as lowercase 64-char SHA-256 hex\n * strings; geographic, IP, and user-agent fields are sent as raw values.\n */\nexport interface OpenAIUser {\n  email_sha256?: string;\n  external_id_sha256?: string;\n  /** Two-letter ISO 3166-1 country code (e.g. \"US\"). */\n  country?: string;\n  city?: string;\n  zip_code?: string;\n  ip_address?: string;\n  user_agent?: string;\n}\n\nexport interface OpenAIEvent {\n  /** Unique event id; combined with `type` for deduplication against pixel events. */\n  id: string;\n  /** Standard event name or `custom`. */\n  type: string;\n  /** Required when `type` is `custom`. */\n  custom_event_name?: string;\n  /** Event timestamp in ms; must be within 7 days and no more than 10 minutes in the future. */\n  timestamp_ms: number;\n  /** Required for `action_source: \"web\"`. */\n  source_url?: string;\n  action_source?: ActionSource;\n  /** OpenAI-provided privacy-preserving identifier. */\n  oppref?: string;\n  /** When true, opts the event out of personalization. */\n  opt_out?: boolean;\n  user?: OpenAIUser;\n  data: EventData;\n}\n\nexport interface CreateOpenAIEventsDTO {\n  /** When true, validates the events without persisting them. */\n  validate_only?: boolean;\n  events: OpenAIEvent[];\n}\n\nfunction sha256(value: string): string {\n  return createHash('sha256').update(value).digest('hex');\n}\n\nfunction mapActionSource(source: TrackTags['source']): ActionSource | undefined {\n  switch (source) {\n    case 'web':\n      return 'web';\n    case 'app':\n      return 'mobile_app';\n    case 'offline':\n      return 'offline';\n    default:\n      return undefined;\n  }\n}\n\nfunction getUser(data: UserProvidedData): OpenAIUser | undefined {\n  const email = getFirst(data.email)?.trim().toLowerCase();\n  const address = getFirst(data.address);\n\n  const user: OpenAIUser = {\n    email_sha256: email ? sha256(email) : undefined,\n    external_id_sha256: data.user_id ? sha256(data.user_id) : undefined,\n    country: address?.country?.trim().toUpperCase(),\n    city: address?.city?.trim().toLowerCase(),\n    zip_code: address?.postal_code,\n    ip_address: data.ip_address,\n    user_agent: data.user_agent,\n  };\n\n  return Object.values(user).some((value) => value !== undefined) ? user : undefined;\n}\n\nexport function getServerEvent(\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  event: TrackEvent<any>,\n  data: UserProvidedData\n): OpenAIEvent {\n  const { type, data: eventData } = mapOAIEvent(event.name, event.properties);\n\n  return {\n    id: event.tags.idempotency_key ?? event.id.toString(),\n    type,\n    // For custom events the original track name is the OpenAI custom_event_name; this matches\n    // the browser pixel so the two deduplicate. Standard events omit it.\n    custom_event_name: type === 'custom' ? event.name : undefined,\n    timestamp_ms: Date.now(),\n    source_url: event.tags.source_url,\n    action_source: mapActionSource(event.tags.source),\n    user: getUser(data),\n    data: eventData,\n  };\n}\n\nexport async function sendEvents(\n  apiKey: string,\n  pixelId: string,\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  events: TrackEvent<any>[],\n  data: UserProvidedData = {},\n  validateOnly = false\n) {\n  const dto: CreateOpenAIEventsDTO = {\n    validate_only: validateOnly,\n    events: events\n      .filter((event) => !IGNORED_EVENTS.includes(event.name))\n      .filter((event) => !NON_AD_EVENTS.includes(event.name))\n      .map((event) => getServerEvent(event, data)),\n  };\n\n  if (dto.events.length === 0) return;\n\n  try {\n    const response = await fetch(`${ENDPOINT}?pid=${pixelId}`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        Accept: 'application/json',\n        Authorization: `Bearer ${apiKey}`,\n      },\n      body: JSON.stringify(dto),\n    });\n\n    if (response.ok) return;\n    const { status } = response;\n    const message = await response.text();\n    console.error(`Failed to send OpenAI conversion, status: ${status}, body: ${message}`);\n  } catch (error) {\n    console.error('Failed to send OpenAI conversion, network error:', error);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,yBAA2B;AAC3B,mBAAsB;AACtB,4BAA+B;AAC/B,kBAA2D;AAE3D,mBAAyB;AAEzB,IAAM,WAAW;AAoDjB,SAAS,OAAO,OAAuB;AACrC,aAAO,+BAAW,QAAQ,EAAE,OAAO,KAAK,EAAE,OAAO,KAAK;AACxD;AAEA,SAAS,gBAAgB,QAAuD;AAC9E,UAAQ,QAAQ;AAAA,IACd,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;AAEA,SAAS,QAAQ,MAAgD;AAjFjE;AAkFE,QAAM,SAAQ,gCAAS,KAAK,KAAK,MAAnB,mBAAsB,OAAO;AAC3C,QAAM,cAAU,uBAAS,KAAK,OAAO;AAErC,QAAM,OAAmB;AAAA,IACvB,cAAc,QAAQ,OAAO,KAAK,IAAI;AAAA,IACtC,oBAAoB,KAAK,UAAU,OAAO,KAAK,OAAO,IAAI;AAAA,IAC1D,UAAS,wCAAS,YAAT,mBAAkB,OAAO;AAAA,IAClC,OAAM,wCAAS,SAAT,mBAAe,OAAO;AAAA,IAC5B,UAAU,mCAAS;AAAA,IACnB,YAAY,KAAK;AAAA,IACjB,YAAY,KAAK;AAAA,EACnB;AAEA,SAAO,OAAO,OAAO,IAAI,EAAE,KAAK,CAAC,UAAU,UAAU,MAAS,IAAI,OAAO;AAC3E;AAEO,SAAS,eAEd,OACA,MACa;AACb,QAAM,EAAE,MAAM,MAAM,UAAU,QAAI,yBAAY,MAAM,MAAM,MAAM,UAAU;AAE1E,SAAO;AAAA,IACL,IAAI,MAAM,KAAK,mBAAmB,MAAM,GAAG,SAAS;AAAA,IACpD;AAAA;AAAA;AAAA,IAGA,mBAAmB,SAAS,WAAW,MAAM,OAAO;AAAA,IACpD,cAAc,KAAK,IAAI;AAAA,IACvB,YAAY,MAAM,KAAK;AAAA,IACvB,eAAe,gBAAgB,MAAM,KAAK,MAAM;AAAA,IAChD,MAAM,QAAQ,IAAI;AAAA,IAClB,MAAM;AAAA,EACR;AACF;AAEA,eAAsB,WACpB,QACA,SAEA,QACA,OAAyB,CAAC,GAC1B,eAAe,OACf;AACA,QAAM,MAA6B;AAAA,IACjC,eAAe;AAAA,IACf,QAAQ,OACL,OAAO,CAAC,UAAU,CAAC,qCAAe,SAAS,MAAM,IAAI,CAAC,EACtD,OAAO,CAAC,UAAU,CAAC,0BAAc,SAAS,MAAM,IAAI,CAAC,EACrD,IAAI,CAAC,UAAU,eAAe,OAAO,IAAI,CAAC;AAAA,EAC/C;AAEA,MAAI,IAAI,OAAO,WAAW,EAAG;AAE7B,MAAI;AACF,UAAM,WAAW,UAAM,oBAAM,GAAG,QAAQ,QAAQ,OAAO,IAAI;AAAA,MACzD,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,QAAQ;AAAA,QACR,eAAe,UAAU,MAAM;AAAA,MACjC;AAAA,MACA,MAAM,KAAK,UAAU,GAAG;AAAA,IAC1B,CAAC;AAED,QAAI,SAAS,GAAI;AACjB,UAAM,EAAE,OAAO,IAAI;AACnB,UAAM,UAAU,MAAM,SAAS,KAAK;AACpC,YAAQ,MAAM,6CAA6C,MAAM,WAAW,OAAO,EAAE;AAAA,EACvF,SAAS,OAAO;AACd,YAAQ,MAAM,oDAAoD,KAAK;AAAA,EACzE;AACF;","names":[]}
+{"version":3,"file":"openai-conversions-api.cjs","names":["getFirst","mapOAIEvent","IGNORED_EVENTS","NON_AD_EVENTS"],"sources":["../../src/server/openai-conversions-api.ts"],"sourcesContent":["/**\n * OpenAI Conversions API\n * https://developers.openai.com/ads/conversions-api\n * https://developers.openai.com/ads/supported-events\n */\nimport { createHash } from 'node:crypto';\nimport { fetch } from '@shware/utils';\nimport { IGNORED_EVENTS } from '../third-parties/ignored-events';\nimport { type EventData, NON_AD_EVENTS, mapOAIEvent } from '../track/oaiq';\nimport type { TrackEvent, TrackTags, UserProvidedData } from '../track/types';\nimport { getFirst } from '../utils/field';\n\nconst ENDPOINT = 'https://bzr.openai.com/v1/events';\n\ntype ActionSource =\n  | 'web'\n  | 'mobile_app'\n  | 'offline'\n  | 'physical_store'\n  | 'phone_call'\n  | 'email'\n  | 'other';\n\n/**\n * User/identity fields. Email and external id must be sent as lowercase 64-char SHA-256 hex\n * strings; geographic, IP, and user-agent fields are sent as raw values.\n */\nexport interface OpenAIUser {\n  email_sha256?: string;\n  external_id_sha256?: string;\n  /** Two-letter ISO 3166-1 country code (e.g. \"US\"). */\n  country?: string;\n  city?: string;\n  zip_code?: string;\n  ip_address?: string;\n  user_agent?: string;\n}\n\nexport interface OpenAIEvent {\n  /** Unique event id; combined with `type` for deduplication against pixel events. */\n  id: string;\n  /** Standard event name or `custom`. */\n  type: string;\n  /** Required when `type` is `custom`. */\n  custom_event_name?: string;\n  /** Event timestamp in ms; must be within 7 days and no more than 10 minutes in the future. */\n  timestamp_ms: number;\n  /** Required for `action_source: \"web\"`. */\n  source_url?: string;\n  action_source?: ActionSource;\n  /** OpenAI-provided privacy-preserving identifier. */\n  oppref?: string;\n  /** When true, opts the event out of personalization. */\n  opt_out?: boolean;\n  user?: OpenAIUser;\n  data: EventData;\n}\n\nexport interface CreateOpenAIEventsDTO {\n  /** When true, validates the events without persisting them. */\n  validate_only?: boolean;\n  events: OpenAIEvent[];\n}\n\nfunction sha256(value: string): string {\n  return createHash('sha256').update(value).digest('hex');\n}\n\nfunction mapActionSource(source: TrackTags['source']): ActionSource | undefined {\n  switch (source) {\n    case 'web':\n      return 'web';\n    case 'app':\n      return 'mobile_app';\n    case 'offline':\n      return 'offline';\n    default:\n      return undefined;\n  }\n}\n\nfunction getUser(data: UserProvidedData): OpenAIUser | undefined {\n  const email = getFirst(data.email)?.trim().toLowerCase();\n  const address = getFirst(data.address);\n\n  const user: OpenAIUser = {\n    email_sha256: email ? sha256(email) : undefined,\n    external_id_sha256: data.user_id ? sha256(data.user_id) : undefined,\n    country: address?.country?.trim().toUpperCase(),\n    city: address?.city?.trim().toLowerCase(),\n    zip_code: address?.postal_code,\n    ip_address: data.ip_address,\n    user_agent: data.user_agent,\n  };\n\n  return Object.values(user).some((value) => value !== undefined) ? user : undefined;\n}\n\nexport function getServerEvent(\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  event: TrackEvent<any>,\n  data: UserProvidedData\n): OpenAIEvent {\n  const { type, data: eventData } = mapOAIEvent(event.name, event.properties);\n\n  return {\n    id: event.tags.idempotency_key ?? event.id.toString(),\n    type,\n    // For custom events the original track name is the OpenAI custom_event_name; this matches\n    // the browser pixel so the two deduplicate. Standard events omit it.\n    custom_event_name: type === 'custom' ? event.name : undefined,\n    timestamp_ms: Date.now(),\n    source_url: event.tags.source_url,\n    action_source: mapActionSource(event.tags.source),\n    user: getUser(data),\n    data: eventData,\n  };\n}\n\nexport async function sendEvents(\n  apiKey: string,\n  pixelId: string,\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  events: TrackEvent<any>[],\n  data: UserProvidedData = {},\n  validateOnly = false\n) {\n  const dto: CreateOpenAIEventsDTO = {\n    validate_only: validateOnly,\n    events: events\n      .filter((event) => !IGNORED_EVENTS.includes(event.name))\n      .filter((event) => !NON_AD_EVENTS.includes(event.name))\n      .map((event) => getServerEvent(event, data)),\n  };\n\n  if (dto.events.length === 0) return;\n\n  try {\n    const response = await fetch(`${ENDPOINT}?pid=${pixelId}`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        Accept: 'application/json',\n        Authorization: `Bearer ${apiKey}`,\n      },\n      body: JSON.stringify(dto),\n    });\n\n    if (response.ok) return;\n    const { status } = response;\n    const message = await response.text();\n    console.error(`Failed to send OpenAI conversion, status: ${status}, body: ${message}`);\n  } catch (error) {\n    console.error('Failed to send OpenAI conversion, network error:', error);\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAYA,MAAM,WAAW;AAoDjB,SAAS,OAAO,OAAuB;CACrC,QAAA,GAAA,YAAA,WAAA,CAAkB,QAAQ,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,KAAK;AACxD;AAEA,SAAS,gBAAgB,QAAuD;CAC9E,QAAQ,QAAR;EACE,KAAK,OACH,OAAO;EACT,KAAK,OACH,OAAO;EACT,KAAK,WACH,OAAO;EACT,SACE;CACJ;AACF;AAEA,SAAS,QAAQ,MAAgD;CAC/D,MAAM,QAAQA,oBAAAA,SAAS,KAAK,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,YAAY;CACvD,MAAM,UAAUA,oBAAAA,SAAS,KAAK,OAAO;CAErC,MAAM,OAAmB;EACvB,cAAc,QAAQ,OAAO,KAAK,IAAI,KAAA;EACtC,oBAAoB,KAAK,UAAU,OAAO,KAAK,OAAO,IAAI,KAAA;EAC1D,SAAS,SAAS,SAAS,KAAK,CAAC,CAAC,YAAY;EAC9C,MAAM,SAAS,MAAM,KAAK,CAAC,CAAC,YAAY;EACxC,UAAU,SAAS;EACnB,YAAY,KAAK;EACjB,YAAY,KAAK;CACnB;CAEA,OAAO,OAAO,OAAO,IAAI,CAAC,CAAC,MAAM,UAAU,UAAU,KAAA,CAAS,IAAI,OAAO,KAAA;AAC3E;AAEA,SAAgB,eAEd,OACA,MACa;CACb,MAAM,EAAE,MAAM,MAAM,cAAcC,mBAAAA,YAAY,MAAM,MAAM,MAAM,UAAU;CAE1E,OAAO;EACL,IAAI,MAAM,KAAK,mBAAmB,MAAM,GAAG,SAAS;EACpD;EAGA,mBAAmB,SAAS,WAAW,MAAM,OAAO,KAAA;EACpD,cAAc,KAAK,IAAI;EACvB,YAAY,MAAM,KAAK;EACvB,eAAe,gBAAgB,MAAM,KAAK,MAAM;EAChD,MAAM,QAAQ,IAAI;EAClB,MAAM;CACR;AACF;AAEA,eAAsB,WACpB,QACA,SAEA,QACA,OAAyB,CAAC,GAC1B,eAAe,OACf;CACA,MAAM,MAA6B;EACjC,eAAe;EACf,QAAQ,OACL,QAAQ,UAAU,CAACC,qCAAAA,eAAe,SAAS,MAAM,IAAI,CAAC,CAAC,CACvD,QAAQ,UAAU,CAACC,mBAAAA,cAAc,SAAS,MAAM,IAAI,CAAC,CAAC,CACtD,KAAK,UAAU,eAAe,OAAO,IAAI,CAAC;CAC/C;CAEA,IAAI,IAAI,OAAO,WAAW,GAAG;CAE7B,IAAI;EACF,MAAM,WAAW,OAAA,GAAA,cAAA,MAAA,CAAY,GAAG,SAAS,OAAO,WAAW;GACzD,QAAQ;GACR,SAAS;IACP,gBAAgB;IAChB,QAAQ;IACR,eAAe,UAAU;GAC3B;GACA,MAAM,KAAK,UAAU,GAAG;EAC1B,CAAC;EAED,IAAI,SAAS,IAAI;EACjB,MAAM,EAAE,WAAW;EACnB,MAAM,UAAU,MAAM,SAAS,KAAK;EACpC,QAAQ,MAAM,6CAA6C,OAAO,UAAU,SAAS;CACvF,SAAS,OAAO;EACd,QAAQ,MAAM,oDAAoD,KAAK;CACzE;AACF"}

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

@@ -1,47 +1,47 @@
-import { EventData } from '../track/oaiq.cjs';
-import { TrackEvent, UserProvidedData } from '../track/types.cjs';
-import '../track/gtag.cjs';
-
+import { TrackEvent, UserProvidedData } from "../track/types.cjs";
+import { EventData } from "../track/oaiq.cjs";
+//#region src/server/openai-conversions-api.d.ts
 type ActionSource = 'web' | 'mobile_app' | 'offline' | 'physical_store' | 'phone_call' | 'email' | 'other';
 /**
  * User/identity fields. Email and external id must be sent as lowercase 64-char SHA-256 hex
  * strings; geographic, IP, and user-agent fields are sent as raw values.
  */
 interface OpenAIUser {
-    email_sha256?: string;
-    external_id_sha256?: string;
-    /** Two-letter ISO 3166-1 country code (e.g. "US"). */
-    country?: string;
-    city?: string;
-    zip_code?: string;
-    ip_address?: string;
-    user_agent?: string;
+  email_sha256?: string;
+  external_id_sha256?: string;
+  /** Two-letter ISO 3166-1 country code (e.g. "US"). */
+  country?: string;
+  city?: string;
+  zip_code?: string;
+  ip_address?: string;
+  user_agent?: string;
 }
 interface OpenAIEvent {
-    /** Unique event id; combined with `type` for deduplication against pixel events. */
-    id: string;
-    /** Standard event name or `custom`. */
-    type: string;
-    /** Required when `type` is `custom`. */
-    custom_event_name?: string;
-    /** Event timestamp in ms; must be within 7 days and no more than 10 minutes in the future. */
-    timestamp_ms: number;
-    /** Required for `action_source: "web"`. */
-    source_url?: string;
-    action_source?: ActionSource;
-    /** OpenAI-provided privacy-preserving identifier. */
-    oppref?: string;
-    /** When true, opts the event out of personalization. */
-    opt_out?: boolean;
-    user?: OpenAIUser;
-    data: EventData;
+  /** Unique event id; combined with `type` for deduplication against pixel events. */
+  id: string;
+  /** Standard event name or `custom`. */
+  type: string;
+  /** Required when `type` is `custom`. */
+  custom_event_name?: string;
+  /** Event timestamp in ms; must be within 7 days and no more than 10 minutes in the future. */
+  timestamp_ms: number;
+  /** Required for `action_source: "web"`. */
+  source_url?: string;
+  action_source?: ActionSource;
+  /** OpenAI-provided privacy-preserving identifier. */
+  oppref?: string;
+  /** When true, opts the event out of personalization. */
+  opt_out?: boolean;
+  user?: OpenAIUser;
+  data: EventData;
 }
 interface CreateOpenAIEventsDTO {
-    /** When true, validates the events without persisting them. */
-    validate_only?: boolean;
-    events: OpenAIEvent[];
+  /** When true, validates the events without persisting them. */
+  validate_only?: boolean;
+  events: OpenAIEvent[];
 }
 declare function getServerEvent(event: TrackEvent<any>, data: UserProvidedData): OpenAIEvent;
 declare function sendEvents(apiKey: string, pixelId: string, events: TrackEvent<any>[], data?: UserProvidedData, validateOnly?: boolean): Promise<void>;
-
-export { type CreateOpenAIEventsDTO, type OpenAIEvent, type OpenAIUser, getServerEvent, sendEvents };
+//#endregion
+export { CreateOpenAIEventsDTO, OpenAIEvent, OpenAIUser, getServerEvent, sendEvents };
+//# sourceMappingURL=openai-conversions-api.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai-conversions-api.d.cts","names":[],"sources":["../../src/server/openai-conversions-api.ts"],"mappings":";;;KAcK;;;;;UAaY;EACf;EACA;;EAEA;EACA;EACA;EACA;EACA;;UAGe;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;EACA,gBAAgB;;EAEhB;;EAEA;EACA,OAAO;EACP,MAAM;;UAGS;;EAEf;EACA,QAAQ;;iBAqCM,eAEd,OAAO,iBACP,MAAM,mBACL;iBAiBmB,WACpB,gBACA,iBAEA,QAAQ,mBACR,OAAM,kBACN,yBAAoB"}

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

@@ -0,0 +1,47 @@
+import { TrackEvent, UserProvidedData } from "../track/types.mjs";
+import { EventData } from "../track/oaiq.mjs";
+//#region src/server/openai-conversions-api.d.ts
+type ActionSource = 'web' | 'mobile_app' | 'offline' | 'physical_store' | 'phone_call' | 'email' | 'other';
+/**
+ * User/identity fields. Email and external id must be sent as lowercase 64-char SHA-256 hex
+ * strings; geographic, IP, and user-agent fields are sent as raw values.
+ */
+interface OpenAIUser {
+  email_sha256?: string;
+  external_id_sha256?: string;
+  /** Two-letter ISO 3166-1 country code (e.g. "US"). */
+  country?: string;
+  city?: string;
+  zip_code?: string;
+  ip_address?: string;
+  user_agent?: string;
+}
+interface OpenAIEvent {
+  /** Unique event id; combined with `type` for deduplication against pixel events. */
+  id: string;
+  /** Standard event name or `custom`. */
+  type: string;
+  /** Required when `type` is `custom`. */
+  custom_event_name?: string;
+  /** Event timestamp in ms; must be within 7 days and no more than 10 minutes in the future. */
+  timestamp_ms: number;
+  /** Required for `action_source: "web"`. */
+  source_url?: string;
+  action_source?: ActionSource;
+  /** OpenAI-provided privacy-preserving identifier. */
+  oppref?: string;
+  /** When true, opts the event out of personalization. */
+  opt_out?: boolean;
+  user?: OpenAIUser;
+  data: EventData;
+}
+interface CreateOpenAIEventsDTO {
+  /** When true, validates the events without persisting them. */
+  validate_only?: boolean;
+  events: OpenAIEvent[];
+}
+declare function getServerEvent(event: TrackEvent<any>, data: UserProvidedData): OpenAIEvent;
+declare function sendEvents(apiKey: string, pixelId: string, events: TrackEvent<any>[], data?: UserProvidedData, validateOnly?: boolean): Promise<void>;
+//#endregion
+export { CreateOpenAIEventsDTO, OpenAIEvent, OpenAIUser, getServerEvent, sendEvents };
+//# sourceMappingURL=openai-conversions-api.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai-conversions-api.d.mts","names":[],"sources":["../../src/server/openai-conversions-api.ts"],"mappings":";;;KAcK;;;;;UAaY;EACf;EACA;;EAEA;EACA;EACA;EACA;EACA;;UAGe;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;EACA,gBAAgB;;EAEhB;;EAEA;EACA,OAAO;EACP,MAAM;;UAGS;;EAEf;EACA,QAAQ;;iBAqCM,eAEd,OAAO,iBACP,MAAM,mBACL;iBAiBmB,WACpB,gBACA,iBAEA,QAAQ,mBACR,OAAM,kBACN,yBAAoB"}

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

@@ -1,81 +1,78 @@
-// src/server/openai-conversions-api.ts
-import { createHash } from "crypto";
-import { fetch } from "@shware/utils";
 import { IGNORED_EVENTS } from "../third-parties/ignored-events.mjs";
-import { NON_AD_EVENTS, mapOAIEvent } from "../track/oaiq.mjs";
 import { getFirst } from "../utils/field.mjs";
-var ENDPOINT = "https://bzr.openai.com/v1/events";
+import { NON_AD_EVENTS, mapOAIEvent } from "../track/oaiq.mjs";
+import { fetch } from "@shware/utils";
+import { createHash } from "node:crypto";
+//#region src/server/openai-conversions-api.ts
+/**
+* OpenAI Conversions API
+* https://developers.openai.com/ads/conversions-api
+* https://developers.openai.com/ads/supported-events
+*/
+const ENDPOINT = "https://bzr.openai.com/v1/events";
 function sha256(value) {
-  return createHash("sha256").update(value).digest("hex");
+	return createHash("sha256").update(value).digest("hex");
 }
 function mapActionSource(source) {
-  switch (source) {
-    case "web":
-      return "web";
-    case "app":
-      return "mobile_app";
-    case "offline":
-      return "offline";
-    default:
-      return void 0;
-  }
+	switch (source) {
+		case "web": return "web";
+		case "app": return "mobile_app";
+		case "offline": return "offline";
+		default: return;
+	}
 }
 function getUser(data) {
-  var _a, _b, _c;
-  const email = (_a = getFirst(data.email)) == null ? void 0 : _a.trim().toLowerCase();
-  const address = getFirst(data.address);
-  const user = {
-    email_sha256: email ? sha256(email) : void 0,
-    external_id_sha256: data.user_id ? sha256(data.user_id) : void 0,
-    country: (_b = address == null ? void 0 : address.country) == null ? void 0 : _b.trim().toUpperCase(),
-    city: (_c = address == null ? void 0 : address.city) == null ? void 0 : _c.trim().toLowerCase(),
-    zip_code: address == null ? void 0 : address.postal_code,
-    ip_address: data.ip_address,
-    user_agent: data.user_agent
-  };
-  return Object.values(user).some((value) => value !== void 0) ? user : void 0;
+	const email = getFirst(data.email)?.trim().toLowerCase();
+	const address = getFirst(data.address);
+	const user = {
+		email_sha256: email ? sha256(email) : void 0,
+		external_id_sha256: data.user_id ? sha256(data.user_id) : void 0,
+		country: address?.country?.trim().toUpperCase(),
+		city: address?.city?.trim().toLowerCase(),
+		zip_code: address?.postal_code,
+		ip_address: data.ip_address,
+		user_agent: data.user_agent
+	};
+	return Object.values(user).some((value) => value !== void 0) ? user : void 0;
 }
 function getServerEvent(event, data) {
-  const { type, data: eventData } = mapOAIEvent(event.name, event.properties);
-  return {
-    id: event.tags.idempotency_key ?? event.id.toString(),
-    type,
-    // For custom events the original track name is the OpenAI custom_event_name; this matches
-    // the browser pixel so the two deduplicate. Standard events omit it.
-    custom_event_name: type === "custom" ? event.name : void 0,
-    timestamp_ms: Date.now(),
-    source_url: event.tags.source_url,
-    action_source: mapActionSource(event.tags.source),
-    user: getUser(data),
-    data: eventData
-  };
+	const { type, data: eventData } = mapOAIEvent(event.name, event.properties);
+	return {
+		id: event.tags.idempotency_key ?? event.id.toString(),
+		type,
+		custom_event_name: type === "custom" ? event.name : void 0,
+		timestamp_ms: Date.now(),
+		source_url: event.tags.source_url,
+		action_source: mapActionSource(event.tags.source),
+		user: getUser(data),
+		data: eventData
+	};
 }
 async function sendEvents(apiKey, pixelId, events, data = {}, validateOnly = false) {
-  const dto = {
-    validate_only: validateOnly,
-    events: events.filter((event) => !IGNORED_EVENTS.includes(event.name)).filter((event) => !NON_AD_EVENTS.includes(event.name)).map((event) => getServerEvent(event, data))
-  };
-  if (dto.events.length === 0) return;
-  try {
-    const response = await fetch(`${ENDPOINT}?pid=${pixelId}`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Accept: "application/json",
-        Authorization: `Bearer ${apiKey}`
-      },
-      body: JSON.stringify(dto)
-    });
-    if (response.ok) return;
-    const { status } = response;
-    const message = await response.text();
-    console.error(`Failed to send OpenAI conversion, status: ${status}, body: ${message}`);
-  } catch (error) {
-    console.error("Failed to send OpenAI conversion, network error:", error);
-  }
+	const dto = {
+		validate_only: validateOnly,
+		events: events.filter((event) => !IGNORED_EVENTS.includes(event.name)).filter((event) => !NON_AD_EVENTS.includes(event.name)).map((event) => getServerEvent(event, data))
+	};
+	if (dto.events.length === 0) return;
+	try {
+		const response = await fetch(`${ENDPOINT}?pid=${pixelId}`, {
+			method: "POST",
+			headers: {
+				"Content-Type": "application/json",
+				Accept: "application/json",
+				Authorization: `Bearer ${apiKey}`
+			},
+			body: JSON.stringify(dto)
+		});
+		if (response.ok) return;
+		const { status } = response;
+		const message = await response.text();
+		console.error(`Failed to send OpenAI conversion, status: ${status}, body: ${message}`);
+	} catch (error) {
+		console.error("Failed to send OpenAI conversion, network error:", error);
+	}
 }
-export {
-  getServerEvent,
-  sendEvents
-};
+//#endregion
+export { getServerEvent, sendEvents };
+
 //# sourceMappingURL=openai-conversions-api.mjs.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/server/openai-conversions-api.ts"],"sourcesContent":["/**\n * OpenAI Conversions API\n * https://developers.openai.com/ads/conversions-api\n * https://developers.openai.com/ads/supported-events\n */\nimport { createHash } from 'node:crypto';\nimport { fetch } from '@shware/utils';\nimport { IGNORED_EVENTS } from '../third-parties/ignored-events';\nimport { type EventData, NON_AD_EVENTS, mapOAIEvent } from '../track/oaiq';\nimport type { TrackEvent, TrackTags, UserProvidedData } from '../track/types';\nimport { getFirst } from '../utils/field';\n\nconst ENDPOINT = 'https://bzr.openai.com/v1/events';\n\ntype ActionSource =\n  | 'web'\n  | 'mobile_app'\n  | 'offline'\n  | 'physical_store'\n  | 'phone_call'\n  | 'email'\n  | 'other';\n\n/**\n * User/identity fields. Email and external id must be sent as lowercase 64-char SHA-256 hex\n * strings; geographic, IP, and user-agent fields are sent as raw values.\n */\nexport interface OpenAIUser {\n  email_sha256?: string;\n  external_id_sha256?: string;\n  /** Two-letter ISO 3166-1 country code (e.g. \"US\"). */\n  country?: string;\n  city?: string;\n  zip_code?: string;\n  ip_address?: string;\n  user_agent?: string;\n}\n\nexport interface OpenAIEvent {\n  /** Unique event id; combined with `type` for deduplication against pixel events. */\n  id: string;\n  /** Standard event name or `custom`. */\n  type: string;\n  /** Required when `type` is `custom`. */\n  custom_event_name?: string;\n  /** Event timestamp in ms; must be within 7 days and no more than 10 minutes in the future. */\n  timestamp_ms: number;\n  /** Required for `action_source: \"web\"`. */\n  source_url?: string;\n  action_source?: ActionSource;\n  /** OpenAI-provided privacy-preserving identifier. */\n  oppref?: string;\n  /** When true, opts the event out of personalization. */\n  opt_out?: boolean;\n  user?: OpenAIUser;\n  data: EventData;\n}\n\nexport interface CreateOpenAIEventsDTO {\n  /** When true, validates the events without persisting them. */\n  validate_only?: boolean;\n  events: OpenAIEvent[];\n}\n\nfunction sha256(value: string): string {\n  return createHash('sha256').update(value).digest('hex');\n}\n\nfunction mapActionSource(source: TrackTags['source']): ActionSource | undefined {\n  switch (source) {\n    case 'web':\n      return 'web';\n    case 'app':\n      return 'mobile_app';\n    case 'offline':\n      return 'offline';\n    default:\n      return undefined;\n  }\n}\n\nfunction getUser(data: UserProvidedData): OpenAIUser | undefined {\n  const email = getFirst(data.email)?.trim().toLowerCase();\n  const address = getFirst(data.address);\n\n  const user: OpenAIUser = {\n    email_sha256: email ? sha256(email) : undefined,\n    external_id_sha256: data.user_id ? sha256(data.user_id) : undefined,\n    country: address?.country?.trim().toUpperCase(),\n    city: address?.city?.trim().toLowerCase(),\n    zip_code: address?.postal_code,\n    ip_address: data.ip_address,\n    user_agent: data.user_agent,\n  };\n\n  return Object.values(user).some((value) => value !== undefined) ? user : undefined;\n}\n\nexport function getServerEvent(\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  event: TrackEvent<any>,\n  data: UserProvidedData\n): OpenAIEvent {\n  const { type, data: eventData } = mapOAIEvent(event.name, event.properties);\n\n  return {\n    id: event.tags.idempotency_key ?? event.id.toString(),\n    type,\n    // For custom events the original track name is the OpenAI custom_event_name; this matches\n    // the browser pixel so the two deduplicate. Standard events omit it.\n    custom_event_name: type === 'custom' ? event.name : undefined,\n    timestamp_ms: Date.now(),\n    source_url: event.tags.source_url,\n    action_source: mapActionSource(event.tags.source),\n    user: getUser(data),\n    data: eventData,\n  };\n}\n\nexport async function sendEvents(\n  apiKey: string,\n  pixelId: string,\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  events: TrackEvent<any>[],\n  data: UserProvidedData = {},\n  validateOnly = false\n) {\n  const dto: CreateOpenAIEventsDTO = {\n    validate_only: validateOnly,\n    events: events\n      .filter((event) => !IGNORED_EVENTS.includes(event.name))\n      .filter((event) => !NON_AD_EVENTS.includes(event.name))\n      .map((event) => getServerEvent(event, data)),\n  };\n\n  if (dto.events.length === 0) return;\n\n  try {\n    const response = await fetch(`${ENDPOINT}?pid=${pixelId}`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        Accept: 'application/json',\n        Authorization: `Bearer ${apiKey}`,\n      },\n      body: JSON.stringify(dto),\n    });\n\n    if (response.ok) return;\n    const { status } = response;\n    const message = await response.text();\n    console.error(`Failed to send OpenAI conversion, status: ${status}, body: ${message}`);\n  } catch (error) {\n    console.error('Failed to send OpenAI conversion, network error:', error);\n  }\n}\n"],"mappings":";AAKA,SAAS,kBAAkB;AAC3B,SAAS,aAAa;AACtB,SAAS,sBAAsB;AAC/B,SAAyB,eAAe,mBAAmB;AAE3D,SAAS,gBAAgB;AAEzB,IAAM,WAAW;AAoDjB,SAAS,OAAO,OAAuB;AACrC,SAAO,WAAW,QAAQ,EAAE,OAAO,KAAK,EAAE,OAAO,KAAK;AACxD;AAEA,SAAS,gBAAgB,QAAuD;AAC9E,UAAQ,QAAQ;AAAA,IACd,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;AAEA,SAAS,QAAQ,MAAgD;AAjFjE;AAkFE,QAAM,SAAQ,cAAS,KAAK,KAAK,MAAnB,mBAAsB,OAAO;AAC3C,QAAM,UAAU,SAAS,KAAK,OAAO;AAErC,QAAM,OAAmB;AAAA,IACvB,cAAc,QAAQ,OAAO,KAAK,IAAI;AAAA,IACtC,oBAAoB,KAAK,UAAU,OAAO,KAAK,OAAO,IAAI;AAAA,IAC1D,UAAS,wCAAS,YAAT,mBAAkB,OAAO;AAAA,IAClC,OAAM,wCAAS,SAAT,mBAAe,OAAO;AAAA,IAC5B,UAAU,mCAAS;AAAA,IACnB,YAAY,KAAK;AAAA,IACjB,YAAY,KAAK;AAAA,EACnB;AAEA,SAAO,OAAO,OAAO,IAAI,EAAE,KAAK,CAAC,UAAU,UAAU,MAAS,IAAI,OAAO;AAC3E;AAEO,SAAS,eAEd,OACA,MACa;AACb,QAAM,EAAE,MAAM,MAAM,UAAU,IAAI,YAAY,MAAM,MAAM,MAAM,UAAU;AAE1E,SAAO;AAAA,IACL,IAAI,MAAM,KAAK,mBAAmB,MAAM,GAAG,SAAS;AAAA,IACpD;AAAA;AAAA;AAAA,IAGA,mBAAmB,SAAS,WAAW,MAAM,OAAO;AAAA,IACpD,cAAc,KAAK,IAAI;AAAA,IACvB,YAAY,MAAM,KAAK;AAAA,IACvB,eAAe,gBAAgB,MAAM,KAAK,MAAM;AAAA,IAChD,MAAM,QAAQ,IAAI;AAAA,IAClB,MAAM;AAAA,EACR;AACF;AAEA,eAAsB,WACpB,QACA,SAEA,QACA,OAAyB,CAAC,GAC1B,eAAe,OACf;AACA,QAAM,MAA6B;AAAA,IACjC,eAAe;AAAA,IACf,QAAQ,OACL,OAAO,CAAC,UAAU,CAAC,eAAe,SAAS,MAAM,IAAI,CAAC,EACtD,OAAO,CAAC,UAAU,CAAC,cAAc,SAAS,MAAM,IAAI,CAAC,EACrD,IAAI,CAAC,UAAU,eAAe,OAAO,IAAI,CAAC;AAAA,EAC/C;AAEA,MAAI,IAAI,OAAO,WAAW,EAAG;AAE7B,MAAI;AACF,UAAM,WAAW,MAAM,MAAM,GAAG,QAAQ,QAAQ,OAAO,IAAI;AAAA,MACzD,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,QAAQ;AAAA,QACR,eAAe,UAAU,MAAM;AAAA,MACjC;AAAA,MACA,MAAM,KAAK,UAAU,GAAG;AAAA,IAC1B,CAAC;AAED,QAAI,SAAS,GAAI;AACjB,UAAM,EAAE,OAAO,IAAI;AACnB,UAAM,UAAU,MAAM,SAAS,KAAK;AACpC,YAAQ,MAAM,6CAA6C,MAAM,WAAW,OAAO,EAAE;AAAA,EACvF,SAAS,OAAO;AACd,YAAQ,MAAM,oDAAoD,KAAK;AAAA,EACzE;AACF;","names":[]}
+{"version":3,"file":"openai-conversions-api.mjs","names":[],"sources":["../../src/server/openai-conversions-api.ts"],"sourcesContent":["/**\n * OpenAI Conversions API\n * https://developers.openai.com/ads/conversions-api\n * https://developers.openai.com/ads/supported-events\n */\nimport { createHash } from 'node:crypto';\nimport { fetch } from '@shware/utils';\nimport { IGNORED_EVENTS } from '../third-parties/ignored-events';\nimport { type EventData, NON_AD_EVENTS, mapOAIEvent } from '../track/oaiq';\nimport type { TrackEvent, TrackTags, UserProvidedData } from '../track/types';\nimport { getFirst } from '../utils/field';\n\nconst ENDPOINT = 'https://bzr.openai.com/v1/events';\n\ntype ActionSource =\n  | 'web'\n  | 'mobile_app'\n  | 'offline'\n  | 'physical_store'\n  | 'phone_call'\n  | 'email'\n  | 'other';\n\n/**\n * User/identity fields. Email and external id must be sent as lowercase 64-char SHA-256 hex\n * strings; geographic, IP, and user-agent fields are sent as raw values.\n */\nexport interface OpenAIUser {\n  email_sha256?: string;\n  external_id_sha256?: string;\n  /** Two-letter ISO 3166-1 country code (e.g. \"US\"). */\n  country?: string;\n  city?: string;\n  zip_code?: string;\n  ip_address?: string;\n  user_agent?: string;\n}\n\nexport interface OpenAIEvent {\n  /** Unique event id; combined with `type` for deduplication against pixel events. */\n  id: string;\n  /** Standard event name or `custom`. */\n  type: string;\n  /** Required when `type` is `custom`. */\n  custom_event_name?: string;\n  /** Event timestamp in ms; must be within 7 days and no more than 10 minutes in the future. */\n  timestamp_ms: number;\n  /** Required for `action_source: \"web\"`. */\n  source_url?: string;\n  action_source?: ActionSource;\n  /** OpenAI-provided privacy-preserving identifier. */\n  oppref?: string;\n  /** When true, opts the event out of personalization. */\n  opt_out?: boolean;\n  user?: OpenAIUser;\n  data: EventData;\n}\n\nexport interface CreateOpenAIEventsDTO {\n  /** When true, validates the events without persisting them. */\n  validate_only?: boolean;\n  events: OpenAIEvent[];\n}\n\nfunction sha256(value: string): string {\n  return createHash('sha256').update(value).digest('hex');\n}\n\nfunction mapActionSource(source: TrackTags['source']): ActionSource | undefined {\n  switch (source) {\n    case 'web':\n      return 'web';\n    case 'app':\n      return 'mobile_app';\n    case 'offline':\n      return 'offline';\n    default:\n      return undefined;\n  }\n}\n\nfunction getUser(data: UserProvidedData): OpenAIUser | undefined {\n  const email = getFirst(data.email)?.trim().toLowerCase();\n  const address = getFirst(data.address);\n\n  const user: OpenAIUser = {\n    email_sha256: email ? sha256(email) : undefined,\n    external_id_sha256: data.user_id ? sha256(data.user_id) : undefined,\n    country: address?.country?.trim().toUpperCase(),\n    city: address?.city?.trim().toLowerCase(),\n    zip_code: address?.postal_code,\n    ip_address: data.ip_address,\n    user_agent: data.user_agent,\n  };\n\n  return Object.values(user).some((value) => value !== undefined) ? user : undefined;\n}\n\nexport function getServerEvent(\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  event: TrackEvent<any>,\n  data: UserProvidedData\n): OpenAIEvent {\n  const { type, data: eventData } = mapOAIEvent(event.name, event.properties);\n\n  return {\n    id: event.tags.idempotency_key ?? event.id.toString(),\n    type,\n    // For custom events the original track name is the OpenAI custom_event_name; this matches\n    // the browser pixel so the two deduplicate. Standard events omit it.\n    custom_event_name: type === 'custom' ? event.name : undefined,\n    timestamp_ms: Date.now(),\n    source_url: event.tags.source_url,\n    action_source: mapActionSource(event.tags.source),\n    user: getUser(data),\n    data: eventData,\n  };\n}\n\nexport async function sendEvents(\n  apiKey: string,\n  pixelId: string,\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  events: TrackEvent<any>[],\n  data: UserProvidedData = {},\n  validateOnly = false\n) {\n  const dto: CreateOpenAIEventsDTO = {\n    validate_only: validateOnly,\n    events: events\n      .filter((event) => !IGNORED_EVENTS.includes(event.name))\n      .filter((event) => !NON_AD_EVENTS.includes(event.name))\n      .map((event) => getServerEvent(event, data)),\n  };\n\n  if (dto.events.length === 0) return;\n\n  try {\n    const response = await fetch(`${ENDPOINT}?pid=${pixelId}`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        Accept: 'application/json',\n        Authorization: `Bearer ${apiKey}`,\n      },\n      body: JSON.stringify(dto),\n    });\n\n    if (response.ok) return;\n    const { status } = response;\n    const message = await response.text();\n    console.error(`Failed to send OpenAI conversion, status: ${status}, body: ${message}`);\n  } catch (error) {\n    console.error('Failed to send OpenAI conversion, network error:', error);\n  }\n}\n"],"mappings":";;;;;;;;;;;AAYA,MAAM,WAAW;AAoDjB,SAAS,OAAO,OAAuB;CACrC,OAAO,WAAW,QAAQ,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,KAAK;AACxD;AAEA,SAAS,gBAAgB,QAAuD;CAC9E,QAAQ,QAAR;EACE,KAAK,OACH,OAAO;EACT,KAAK,OACH,OAAO;EACT,KAAK,WACH,OAAO;EACT,SACE;CACJ;AACF;AAEA,SAAS,QAAQ,MAAgD;CAC/D,MAAM,QAAQ,SAAS,KAAK,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,YAAY;CACvD,MAAM,UAAU,SAAS,KAAK,OAAO;CAErC,MAAM,OAAmB;EACvB,cAAc,QAAQ,OAAO,KAAK,IAAI,KAAA;EACtC,oBAAoB,KAAK,UAAU,OAAO,KAAK,OAAO,IAAI,KAAA;EAC1D,SAAS,SAAS,SAAS,KAAK,CAAC,CAAC,YAAY;EAC9C,MAAM,SAAS,MAAM,KAAK,CAAC,CAAC,YAAY;EACxC,UAAU,SAAS;EACnB,YAAY,KAAK;EACjB,YAAY,KAAK;CACnB;CAEA,OAAO,OAAO,OAAO,IAAI,CAAC,CAAC,MAAM,UAAU,UAAU,KAAA,CAAS,IAAI,OAAO,KAAA;AAC3E;AAEA,SAAgB,eAEd,OACA,MACa;CACb,MAAM,EAAE,MAAM,MAAM,cAAc,YAAY,MAAM,MAAM,MAAM,UAAU;CAE1E,OAAO;EACL,IAAI,MAAM,KAAK,mBAAmB,MAAM,GAAG,SAAS;EACpD;EAGA,mBAAmB,SAAS,WAAW,MAAM,OAAO,KAAA;EACpD,cAAc,KAAK,IAAI;EACvB,YAAY,MAAM,KAAK;EACvB,eAAe,gBAAgB,MAAM,KAAK,MAAM;EAChD,MAAM,QAAQ,IAAI;EAClB,MAAM;CACR;AACF;AAEA,eAAsB,WACpB,QACA,SAEA,QACA,OAAyB,CAAC,GAC1B,eAAe,OACf;CACA,MAAM,MAA6B;EACjC,eAAe;EACf,QAAQ,OACL,QAAQ,UAAU,CAAC,eAAe,SAAS,MAAM,IAAI,CAAC,CAAC,CACvD,QAAQ,UAAU,CAAC,cAAc,SAAS,MAAM,IAAI,CAAC,CAAC,CACtD,KAAK,UAAU,eAAe,OAAO,IAAI,CAAC;CAC/C;CAEA,IAAI,IAAI,OAAO,WAAW,GAAG;CAE7B,IAAI;EACF,MAAM,WAAW,MAAM,MAAM,GAAG,SAAS,OAAO,WAAW;GACzD,QAAQ;GACR,SAAS;IACP,gBAAgB;IAChB,QAAQ;IACR,eAAe,UAAU;GAC3B;GACA,MAAM,KAAK,UAAU,GAAG;EAC1B,CAAC;EAED,IAAI,SAAS,IAAI;EACjB,MAAM,EAAE,WAAW;EACnB,MAAM,UAAU,MAAM,SAAS,KAAK;EACpC,QAAQ,MAAM,6CAA6C,OAAO,UAAU,SAAS;CACvF,SAAS,OAAO;EACd,QAAQ,MAAM,oDAAoD,KAAK;CACzE;AACF"}