@shware/analytics 8.2.0 → 8.5.0

package/dist/server/index.d.mts

@@ -1,8 +1,9 @@
-import { FBC_COOKIE, GCL_AW_COOKIE, GCL_GB_COOKIE, ParsedFbc, ParsedGcl, RDT_CID_COOKIE, ResolveClickIdCookiesInput, ResolveClickIdCookiesResult, formatFbc, formatGcl, parseFbc, parseGcl, resolveClickIdCookies, toSetCookieHeaders } from "../click-id/index.mjs";
+import { FBC_COOKIE, GCL_AW_COOKIE, GCL_GB_COOKIE, ParsedFbc, ParsedGcl, RDT_CID_COOKIE, ResolveClickIdCookiesInput, ResolveClickIdCookiesResult, UET_MSCLKID_COOKIE, formatFbc, formatGcl, formatMsclkid, formatUetMsclkid, parseFbc, parseGcl, parseUetMsclkid, resolveClickIdCookies, toSetCookieHeaders } from "../click-id/index.mjs";
 import { EventActionSource } from "./action-source.mjs";
 import { DataManagerEvent, DataManagerResponse, GoogleAdsAuth, GoogleAdsConsent, GoogleAdsConversionConfig, GoogleAdsConversionsOptions, getDataManagerEvent, normalizeEmail, sendEvents } from "./google-data-manager.mjs";
 import { CapiEvent, MetaConversionsOptions, MetaConversionsResponse, getCapiEvent, sendEvents as sendEvents$2 } from "./meta-capi.mjs";
-import { sendEvents as sendEvents$4 } from "./reddit-conversions-api.mjs";
+import { sendEvents as sendEvents$5 } from "./reddit-conversions-api.mjs";
 import { LinkedinConversionConfig, sendEvents as sendEvents$1 } from "./linkedin-conversions-api.mjs";
-import { sendEvents as sendEvents$3 } from "./openai-conversions-api.mjs";
-export { type CapiEvent, type DataManagerEvent, type DataManagerResponse, type EventActionSource, FBC_COOKIE, GCL_AW_COOKIE, GCL_GB_COOKIE, type GoogleAdsAuth, type GoogleAdsConsent, type GoogleAdsConversionConfig, type GoogleAdsConversionsOptions, type LinkedinConversionConfig, type MetaConversionsOptions, type MetaConversionsResponse, type ParsedFbc, type ParsedGcl, RDT_CID_COOKIE, type ResolveClickIdCookiesInput, type ResolveClickIdCookiesResult, formatFbc, formatGcl, getCapiEvent, getDataManagerEvent, normalizeEmail, parseFbc, parseGcl, resolveClickIdCookies, sendEvents as sendGoogleAdsEvents, sendEvents$1 as sendLinkedinEvents, sendEvents$2 as sendMetaEvents, sendEvents$3 as sendOpenAIEvents, sendEvents$4 as sendRedditEvents, toSetCookieHeaders };
+import { sendEvents as sendEvents$4 } from "./openai-conversions-api.mjs";
+import { MicrosoftConversionsOptions, MicrosoftConversionsResponse, MicrosoftCustomData, MicrosoftEvent, MicrosoftEventOptions, MicrosoftUserData, MicrosoftValidationDetail, getServerEvent, normalizeEmail as normalizeEmail$1, sendEvents as sendEvents$3 } from "./microsoft-conversions-api.mjs";
+export { type CapiEvent, type DataManagerEvent, type DataManagerResponse, type EventActionSource, FBC_COOKIE, GCL_AW_COOKIE, GCL_GB_COOKIE, type GoogleAdsAuth, type GoogleAdsConsent, type GoogleAdsConversionConfig, type GoogleAdsConversionsOptions, type LinkedinConversionConfig, type MetaConversionsOptions, type MetaConversionsResponse, type MicrosoftConversionsOptions, type MicrosoftConversionsResponse, type MicrosoftCustomData, type MicrosoftEvent, type MicrosoftEventOptions, type MicrosoftUserData, type MicrosoftValidationDetail, type ParsedFbc, type ParsedGcl, RDT_CID_COOKIE, type ResolveClickIdCookiesInput, type ResolveClickIdCookiesResult, UET_MSCLKID_COOKIE, formatFbc, formatGcl, formatMsclkid, formatUetMsclkid, getCapiEvent, getDataManagerEvent, getServerEvent as getMicrosoftEvent, normalizeEmail, normalizeEmail$1 as normalizeMicrosoftEmail, parseFbc, parseGcl, parseUetMsclkid, resolveClickIdCookies, sendEvents as sendGoogleAdsEvents, sendEvents$1 as sendLinkedinEvents, sendEvents$2 as sendMetaEvents, sendEvents$3 as sendMicrosoftEvents, sendEvents$4 as sendOpenAIEvents, sendEvents$5 as sendRedditEvents, toSetCookieHeaders };

package/dist/server/index.mjs

@@ -1,7 +1,8 @@
-import { FBC_COOKIE, GCL_AW_COOKIE, GCL_GB_COOKIE, RDT_CID_COOKIE, formatFbc, formatGcl, parseFbc, parseGcl, resolveClickIdCookies, toSetCookieHeaders } from "../click-id/index.mjs";
+import { FBC_COOKIE, GCL_AW_COOKIE, GCL_GB_COOKIE, RDT_CID_COOKIE, UET_MSCLKID_COOKIE, formatFbc, formatGcl, formatMsclkid, formatUetMsclkid, parseFbc, parseGcl, parseUetMsclkid, resolveClickIdCookies, toSetCookieHeaders } from "../click-id/index.mjs";
 import { getDataManagerEvent, normalizeEmail, sendEvents } from "./google-data-manager.mjs";
 import { getCapiEvent, sendEvents as sendEvents$2 } from "./meta-capi.mjs";
-import { sendEvents as sendEvents$4 } from "./reddit-conversions-api.mjs";
+import { sendEvents as sendEvents$5 } from "./reddit-conversions-api.mjs";
 import { sendEvents as sendEvents$1 } from "./linkedin-conversions-api.mjs";
-import { sendEvents as sendEvents$3 } from "./openai-conversions-api.mjs";
-export { FBC_COOKIE, GCL_AW_COOKIE, GCL_GB_COOKIE, RDT_CID_COOKIE, formatFbc, formatGcl, getCapiEvent, getDataManagerEvent, normalizeEmail, parseFbc, parseGcl, resolveClickIdCookies, sendEvents as sendGoogleAdsEvents, sendEvents$1 as sendLinkedinEvents, sendEvents$2 as sendMetaEvents, sendEvents$3 as sendOpenAIEvents, sendEvents$4 as sendRedditEvents, toSetCookieHeaders };
+import { sendEvents as sendEvents$4 } from "./openai-conversions-api.mjs";
+import { getServerEvent, normalizeEmail as normalizeEmail$1, sendEvents as sendEvents$3 } from "./microsoft-conversions-api.mjs";
+export { FBC_COOKIE, GCL_AW_COOKIE, GCL_GB_COOKIE, RDT_CID_COOKIE, UET_MSCLKID_COOKIE, formatFbc, formatGcl, formatMsclkid, formatUetMsclkid, getCapiEvent, getDataManagerEvent, getServerEvent as getMicrosoftEvent, normalizeEmail, normalizeEmail$1 as normalizeMicrosoftEmail, parseFbc, parseGcl, parseUetMsclkid, resolveClickIdCookies, sendEvents as sendGoogleAdsEvents, sendEvents$1 as sendLinkedinEvents, sendEvents$2 as sendMetaEvents, sendEvents$3 as sendMicrosoftEvents, sendEvents$4 as sendOpenAIEvents, sendEvents$5 as sendRedditEvents, toSetCookieHeaders };

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

@@ -0,0 +1,171 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_third_parties_ignored_events = require("../third-parties/ignored-events.cjs");
+const require_click_id_index = require("../click-id/index.cjs");
+const require_server_page_location = require("./page-location.cjs");
+const require_track_uetq = require("../track/uetq.cjs");
+let _shware_utils = require("@shware/utils");
+let node_crypto = require("node:crypto");
+//#region src/server/microsoft-conversions-api.ts
+/**
+* Microsoft Advertising Conversions API (CAPI) sender — the server-side counterpart of the UET
+* tag, in the same shape as the other senders here: a pure per-event builder, a never-throws
+* `sendEvents`, the token in a header and never in a URL or a log line.
+*
+* Microsoft's recommended deployment is hybrid: keep the UET JavaScript on the page and send the
+* same conversions here too, deduplicated by (`tagId`, `eventName`, `eventId`). Both channels in
+* this SDK are fed from the same `track()` call — the browser sends the internal name as the UET
+* action with the event id as `event_id`, and this builder sends the same name as `eventName`
+* with the same id — so the pair agrees by construction.
+*
+* The token comes from the UET tag's "Use Conversions API" setup step, or from the Campaign
+* Management API's `UetTagAuthKey/Query`. Access is provisioned per customer account: an account
+* whose tag setup has no "Use Conversions API" option has to ask Microsoft Advertising support.
+*
+* https://learn.microsoft.com/en-us/advertising/guides/uet-conversion-api-integration
+*/
+const ENDPOINT = "https://capi.uet.microsoft.com/v1";
+/** The API's hard limit per request. */
+const MAX_EVENTS_PER_REQUEST = 1e3;
+const SHA256 = /^[a-f0-9]{64}$/;
+const sha256 = (value) => (0, node_crypto.createHash)("sha256").update(value).digest("hex");
+/**
+* Microsoft's email normalization: trim, drop the dots and any `+alias` from the user part —
+* for EVERY domain, unlike Google's gmail-only rule — lowercase, SHA-256. A value that is
+* already a SHA-256 hex digest passes through.
+* https://learn.microsoft.com/en-us/advertising/guides/uet-conversion-api-integration#hashed-identifiers
+*/
+function normalizeEmail(input) {
+	const email = input.trim().toLowerCase();
+	const at = email.lastIndexOf("@");
+	if (at === -1) return email;
+	return `${email.slice(0, at).replace(/\./g, "").split("+", 1)[0] ?? ""}@${email.slice(at + 1)}`;
+}
+function hashEmail(input) {
+	const value = input?.trim().toLowerCase();
+	if (!value) return void 0;
+	return SHA256.test(value) ? value : sha256(normalizeEmail(value));
+}
+/**
+* Phones are E.164 by the schema (`+` then 11–15 digits, the range bat.js validates too); the
+* separators bat.js tolerates are stripped, and anything else is dropped rather than guessed —
+* a number with no country code hashed under an assumed one can never match.
+*/
+function hashPhone(input) {
+	const value = input?.trim().toLowerCase();
+	if (!value) return void 0;
+	if (SHA256.test(value)) return value;
+	const phone = value.replace(/[-() \t]/g, "");
+	return /^\+\d{11,15}$/.test(phone) ? sha256(phone) : void 0;
+}
+function getUserData(event, data) {
+	const { tags, platform, visitor_id } = event;
+	const email = Array.isArray(data.email) ? data.email[0] : data.email;
+	const phone = Array.isArray(data.phone_number) ? data.phone_number[0] : data.phone_number;
+	return {
+		msclkid: tags.msclkid ? require_click_id_index.formatMsclkid(tags.msclkid) : void 0,
+		em: hashEmail(email),
+		ph: hashPhone(phone),
+		anonymousId: visitor_id || void 0,
+		externalId: data.user_id ? sha256(data.user_id) : void 0,
+		clientUserAgent: data.user_agent,
+		clientIpAddress: typeof tags.ip_address === "string" && tags.ip_address ? tags.ip_address : data.ip_address,
+		idfa: platform === "ios" ? tags.advertising_id : void 0,
+		gaid: platform === "android" ? tags.advertising_id : void 0
+	};
+}
+function getCustomData(event) {
+	const [, params] = require_track_uetq.mapUETEvent(event.name, event.properties);
+	const customData = {
+		eventCategory: params.event_category,
+		eventLabel: params.event_label,
+		eventValue: params.event_value,
+		searchTerm: params.search_term,
+		transactionId: params.transaction_id,
+		value: params.revenue_value,
+		currency: params.currency,
+		items: params.items?.map(({ id, name, price, quantity }) => ({
+			id,
+			name,
+			price,
+			quantity
+		})),
+		itemIds: Array.isArray(params.ecomm_prodid) ? params.ecomm_prodid : params.ecomm_prodid ? [params.ecomm_prodid] : void 0,
+		pageType: params.ecomm_pagetype,
+		ecommTotalValue: params.ecomm_totalvalue,
+		ecommCategory: params.ecomm_category
+	};
+	return Object.values(customData).some((value) => value !== void 0) ? customData : void 0;
+}
+function getServerEvent(event, data = {}, options = {}) {
+	const { consent, pageLoads = false } = typeof options === "string" ? { consent: options } : options;
+	const { id, name, tags, created_at } = event;
+	const isPageLoad = name === "page_view";
+	return {
+		eventType: isPageLoad ? "pageLoad" : "custom",
+		eventId: tags.idempotency_key ?? id,
+		eventName: isPageLoad ? void 0 : name,
+		eventTime: Math.round(new Date(created_at).getTime() / 1e3),
+		eventSourceUrl: require_server_page_location.pageLocation(tags),
+		pageLoadId: pageLoads ? tags.page_load_id : void 0,
+		referrerUrl: tags.page_referrer,
+		pageTitle: tags.page_title,
+		adStorageConsent: consent === "granted" ? "G" : consent === "denied" ? "D" : void 0,
+		userData: getUserData(event, data),
+		customData: isPageLoad ? void 0 : getCustomData(event)
+	};
+}
+/** Strip undefined fields so the wire payload carries only what was set. */
+function compact(value) {
+	return JSON.parse(JSON.stringify(value));
+}
+/**
+* Send events to `POST /v1/{tagId}/events`. Batches above the API's 1,000-event limit are split
+* into consecutive requests; one response is returned per request made. Never throws: an HTTP
+* or network failure is logged (without the token) and yields no response for that request.
+*/
+async function sendEvents(token, tagId, events, data = {}, options = {}) {
+	const { consent, pageLoads = false, dataProvider, continueOnValidationError = true } = options;
+	const capiEvents = events.filter((event) => pageLoads && event.name === "page_view" || !require_third_parties_ignored_events.IGNORED_EVENTS.includes(event.name)).map((event) => getServerEvent(event, data, {
+		consent,
+		pageLoads
+	})).filter((event) => event.eventType !== "pageLoad" || event.eventSourceUrl);
+	if (capiEvents.length === 0) return [];
+	const responses = [];
+	for (const batch of (0, _shware_utils.chunk)(capiEvents, MAX_EVENTS_PER_REQUEST)) {
+		const body = compact({
+			data: batch,
+			continueOnValidationError,
+			dataProvider
+		});
+		try {
+			const response = await (0, _shware_utils.fetch)(`${ENDPOINT}/${tagId}/events`, {
+				method: "POST",
+				headers: {
+					"Content-Type": "application/json",
+					Accept: "application/json",
+					Authorization: `Bearer ${token}`
+				},
+				body: JSON.stringify(body)
+			});
+			if (response.ok) {
+				const result = await response.json();
+				if (result.error?.details?.length) console.warn(`Microsoft conversion accepted with validation issues: ${JSON.stringify(result.error.details)}`);
+				responses.push(result);
+				continue;
+			}
+			const { status } = response;
+			const message = await response.text();
+			console.error(`Failed to send Microsoft conversion, status: ${status}, body: ${message}`);
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			console.error(`Failed to send Microsoft conversion, network error: ${message}`);
+		}
+	}
+	return responses;
+}
+//#endregion
+exports.getServerEvent = getServerEvent;
+exports.normalizeEmail = normalizeEmail;
+exports.sendEvents = sendEvents;
+
+//# sourceMappingURL=microsoft-conversions-api.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"microsoft-conversions-api.cjs","names":["createHash","formatMsclkid","mapUETEvent","pageLocation","IGNORED_EVENTS","chunk","fetch"],"sources":["../../src/server/microsoft-conversions-api.ts"],"sourcesContent":["/**\n * Microsoft Advertising Conversions API (CAPI) sender — the server-side counterpart of the UET\n * tag, in the same shape as the other senders here: a pure per-event builder, a never-throws\n * `sendEvents`, the token in a header and never in a URL or a log line.\n *\n * Microsoft's recommended deployment is hybrid: keep the UET JavaScript on the page and send the\n * same conversions here too, deduplicated by (`tagId`, `eventName`, `eventId`). Both channels in\n * this SDK are fed from the same `track()` call — the browser sends the internal name as the UET\n * action with the event id as `event_id`, and this builder sends the same name as `eventName`\n * with the same id — so the pair agrees by construction.\n *\n * The token comes from the UET tag's \"Use Conversions API\" setup step, or from the Campaign\n * Management API's `UetTagAuthKey/Query`. Access is provisioned per customer account: an account\n * whose tag setup has no \"Use Conversions API\" option has to ask Microsoft Advertising support.\n *\n * https://learn.microsoft.com/en-us/advertising/guides/uet-conversion-api-integration\n */\nimport { createHash } from 'node:crypto';\nimport { chunk, fetch } from '@shware/utils';\nimport { formatMsclkid } from '../click-id/index';\nimport { IGNORED_EVENTS } from '../third-parties/ignored-events';\nimport type { TrackEvent, UserProvidedData } from '../track/types';\nimport { mapUETEvent } from '../track/uetq';\nimport { pageLocation } from './page-location';\n\nconst ENDPOINT = 'https://capi.uet.microsoft.com/v1';\n\n/** The API's hard limit per request. */\nconst MAX_EVENTS_PER_REQUEST = 1000;\n\nconst SHA256 = /^[a-f0-9]{64}$/;\n\nconst sha256 = (value: string) => createHash('sha256').update(value).digest('hex');\n\n/**\n * Microsoft's email normalization: trim, drop the dots and any `+alias` from the user part —\n * for EVERY domain, unlike Google's gmail-only rule — lowercase, SHA-256. A value that is\n * already a SHA-256 hex digest passes through.\n * https://learn.microsoft.com/en-us/advertising/guides/uet-conversion-api-integration#hashed-identifiers\n */\nexport function normalizeEmail(input: string): string {\n  const email = input.trim().toLowerCase();\n  const at = email.lastIndexOf('@');\n  if (at === -1) return email;\n  const user = email.slice(0, at).replace(/\\./g, '').split('+', 1)[0] ?? '';\n  return `${user}@${email.slice(at + 1)}`;\n}\n\nfunction hashEmail(input: string | undefined): string | undefined {\n  const value = input?.trim().toLowerCase();\n  if (!value) return undefined;\n  return SHA256.test(value) ? value : sha256(normalizeEmail(value));\n}\n\n/**\n * Phones are E.164 by the schema (`+` then 11–15 digits, the range bat.js validates too); the\n * separators bat.js tolerates are stripped, and anything else is dropped rather than guessed —\n * a number with no country code hashed under an assumed one can never match.\n */\nfunction hashPhone(input: string | undefined): string | undefined {\n  const value = input?.trim().toLowerCase();\n  if (!value) return undefined;\n  if (SHA256.test(value)) return value;\n  const phone = value.replace(/[-() \\t]/g, '');\n  return /^\\+\\d{11,15}$/.test(phone) ? sha256(phone) : undefined;\n}\n\nexport interface MicrosoftUserData {\n  /** Microsoft click id, as a dashed UUID. */\n  msclkid?: string;\n  /** SHA-256 of the normalized email. */\n  em?: string;\n  /** SHA-256 of the E.164 phone number. */\n  ph?: string;\n  /** The SDK visitor id — what the client-side ID Sync pixel (`sendUETIdSync`) sends as `VID`. */\n  anonymousId?: string;\n  /** SHA-256 of the signed-in user id — what `sendUETIdSync` sends as `UID`. */\n  externalId?: string;\n  clientUserAgent?: string;\n  clientIpAddress?: string;\n  idfa?: string;\n  gaid?: string;\n}\n\nexport interface MicrosoftItem {\n  id?: string;\n  name?: string;\n  price?: number;\n  quantity?: number;\n}\n\nexport interface MicrosoftCustomData {\n  eventCategory?: string;\n  eventLabel?: string;\n  eventValue?: number;\n  searchTerm?: string;\n  transactionId?: string;\n  value?: number;\n  currency?: string;\n  items?: MicrosoftItem[];\n  itemIds?: string[];\n  pageType?: string;\n  ecommTotalValue?: number;\n  ecommCategory?: string;\n}\n\n/** One entry of the `data` array POSTed to `/v1/{tagId}/events`. */\nexport interface MicrosoftEvent {\n  eventType: 'custom' | 'pageLoad';\n  eventId: string;\n  /** The UET action; absent on `pageLoad` events. */\n  eventName?: string;\n  /** UNIX seconds, UTC; the API rejects anything older than 7 days. */\n  eventTime: number;\n  eventSourceUrl?: string;\n  /** Links a `custom` event to its `pageLoad` event; a v4 UUID (the SDK's `page_load_id` tag). */\n  pageLoadId?: string;\n  referrerUrl?: string;\n  pageTitle?: string;\n  /** `G` granted, `D` denied. Absent means granted. */\n  adStorageConsent?: 'G' | 'D';\n  userData: MicrosoftUserData;\n  customData?: MicrosoftCustomData;\n}\n\nexport interface MicrosoftConversionsOptions {\n  /**\n   * EEA/UK/CH consent for the whole batch. `denied` events are accepted but used for nothing —\n   * no attribution, no audiences. Absent means granted, which is also the API's default.\n   */\n  consent?: 'granted' | 'denied';\n  /**\n   * Also send `page_view` events, as CAPI `pageLoad` events, and link every custom event to the\n   * page load it happened on (`pageLoadId`, from the `page_load_id` tag). Off by default because\n   * the UET JavaScript already reports every page load and the two would double-count\n   * destination-URL goals; turn it on for a CAPI-only site with no tag on the page. Off, no\n   * `pageLoadId` is sent either: it would point at a page load Microsoft only saw from the tag,\n   * under the tag's own id.\n   *\n   * Not yet modelled: the revenue-only custom event a `pageLoad` needs for a destination goal\n   * with variable revenue.\n   */\n  pageLoads?: boolean;\n  /** Identifies a third-party sender in Microsoft's monitoring; leave unset for a first-party build. */\n  dataProvider?: string;\n  /**\n   * Process the valid events of a batch and report the invalid ones, instead of the API's default\n   * all-or-nothing rejection. On by default — one malformed event should cost itself, not the\n   * batch it travelled with.\n   */\n  continueOnValidationError?: boolean;\n}\n\nexport interface MicrosoftValidationDetail {\n  index?: number;\n  propertyName?: string;\n  attemptedValue?: unknown;\n  errorMessage?: string;\n  errorCode?: string;\n  isWarning?: boolean;\n}\n\nexport interface MicrosoftConversionsResponse {\n  eventsReceived?: number;\n  error?: { code?: string; message?: string; details?: MicrosoftValidationDetail[] };\n}\n\nfunction getUserData(\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  event: TrackEvent<any>,\n  data: UserProvidedData\n): MicrosoftUserData {\n  const { tags, platform, visitor_id } = event;\n  const email = Array.isArray(data.email) ? data.email[0] : data.email;\n  const phone = Array.isArray(data.phone_number) ? data.phone_number[0] : data.phone_number;\n\n  return {\n    msclkid: tags.msclkid ? formatMsclkid(tags.msclkid) : undefined,\n    em: hashEmail(email),\n    ph: hashPhone(phone),\n    // Microsoft requires this to equal the `VID` of the client-side ID Sync pixel; both sides use\n    // the SDK visitor id, which every event carries and the client can always read.\n    anonymousId: visitor_id || undefined,\n    // Microsoft asks for an anonymized id and never a real one. SHA-256, the same digest\n    // `sendUETIdSync` applies client-side, so `externalId` and the pixel's `UID` agree too.\n    externalId: data.user_id ? sha256(data.user_id) : undefined,\n    clientUserAgent: data.user_agent,\n    clientIpAddress:\n      typeof tags.ip_address === 'string' && tags.ip_address ? tags.ip_address : data.ip_address,\n    idfa: platform === 'ios' ? tags.advertising_id : undefined,\n    gaid: platform === 'android' ? tags.advertising_id : undefined,\n  };\n}\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\nfunction getCustomData(event: TrackEvent<any>): MicrosoftCustomData | undefined {\n  const [, params] = mapUETEvent(event.name, event.properties);\n  const customData: MicrosoftCustomData = {\n    eventCategory: params.event_category,\n    eventLabel: params.event_label,\n    eventValue: params.event_value,\n    searchTerm: params.search_term,\n    transactionId: params.transaction_id,\n    value: params.revenue_value,\n    currency: params.currency,\n    items: params.items?.map(({ id, name, price, quantity }) => ({ id, name, price, quantity })),\n    itemIds: Array.isArray(params.ecomm_prodid)\n      ? params.ecomm_prodid\n      : params.ecomm_prodid\n        ? [params.ecomm_prodid]\n        : undefined,\n    pageType: params.ecomm_pagetype,\n    ecommTotalValue: params.ecomm_totalvalue,\n    ecommCategory: params.ecomm_category,\n  };\n  return Object.values(customData).some((value) => value !== undefined) ? customData : undefined;\n}\n\n/**\n * Build one CAPI event. `page_view` becomes a `pageLoad` event (the caller decides whether to\n * send those, see `MicrosoftConversionsOptions.pageLoads`); everything else is a `custom` event\n * named after the track event, which is also the UET action the browser sent.\n */\nexport type MicrosoftEventOptions = Pick<MicrosoftConversionsOptions, 'consent' | 'pageLoads'>;\n\nexport function getServerEvent(\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  event: TrackEvent<any>,\n  data: UserProvidedData = {},\n  /** Options, or — the 8.3.0 signature, still accepted — the bare consent value. */\n  options: MicrosoftEventOptions | MicrosoftEventOptions['consent'] = {}\n): MicrosoftEvent {\n  const { consent, pageLoads = false } =\n    typeof options === 'string' ? { consent: options } : options;\n  const { id, name, tags, created_at } = event;\n  const isPageLoad = name === 'page_view';\n\n  return {\n    eventType: isPageLoad ? 'pageLoad' : 'custom',\n    eventId: tags.idempotency_key ?? id,\n    eventName: isPageLoad ? undefined : name,\n    eventTime: Math.round(new Date(created_at).getTime() / 1000),\n    eventSourceUrl: pageLocation(tags),\n    pageLoadId: pageLoads ? tags.page_load_id : undefined,\n    referrerUrl: tags.page_referrer,\n    pageTitle: tags.page_title,\n    adStorageConsent: consent === 'granted' ? 'G' : consent === 'denied' ? 'D' : undefined,\n    userData: getUserData(event, data),\n    customData: isPageLoad ? undefined : getCustomData(event),\n  };\n}\n\n/** Strip undefined fields so the wire payload carries only what was set. */\nfunction compact<T>(value: T): T {\n  return JSON.parse(JSON.stringify(value)) as T;\n}\n\n/**\n * Send events to `POST /v1/{tagId}/events`. Batches above the API's 1,000-event limit are split\n * into consecutive requests; one response is returned per request made. Never throws: an HTTP\n * or network failure is logged (without the token) and yields no response for that request.\n */\nexport async function sendEvents(\n  token: string,\n  tagId: string | number,\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  events: TrackEvent<any>[],\n  data: UserProvidedData = {},\n  options: MicrosoftConversionsOptions = {}\n): Promise<MicrosoftConversionsResponse[]> {\n  const { consent, pageLoads = false, dataProvider, continueOnValidationError = true } = options;\n\n  const capiEvents = events\n    .filter(\n      (event) => (pageLoads && event.name === 'page_view') || !IGNORED_EVENTS.includes(event.name)\n    )\n    .map((event) => getServerEvent(event, data, { consent, pageLoads }))\n    // A pageLoad without a URL is rejected by the API, and a page-less event has nothing to say.\n    .filter((event) => event.eventType !== 'pageLoad' || event.eventSourceUrl);\n  if (capiEvents.length === 0) return [];\n\n  const responses: MicrosoftConversionsResponse[] = [];\n  for (const batch of chunk(capiEvents, MAX_EVENTS_PER_REQUEST)) {\n    const body = compact({ data: batch, continueOnValidationError, dataProvider });\n    try {\n      const response = await fetch(`${ENDPOINT}/${tagId}/events`, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          Accept: 'application/json',\n          Authorization: `Bearer ${token}`,\n        },\n        body: JSON.stringify(body),\n      });\n      if (response.ok) {\n        const result = (await response.json()) as MicrosoftConversionsResponse;\n        // A 200 can still carry field-level warnings (the field was removed) and, with\n        // `continueOnValidationError`, skipped events. Surface them: silent partial data loss is\n        // the one failure mode the caller cannot see from the status code.\n        if (result.error?.details?.length) {\n          console.warn(\n            `Microsoft conversion accepted with validation issues: ${JSON.stringify(result.error.details)}`\n          );\n        }\n        responses.push(result);\n        continue;\n      }\n      const { status } = response;\n      const message = await response.text();\n      console.error(`Failed to send Microsoft conversion, status: ${status}, body: ${message}`);\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      console.error(`Failed to send Microsoft conversion, network error: ${message}`);\n    }\n  }\n  return responses;\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,124 @@
+import { TrackEvent, UserProvidedData } from "../track/types.cjs";
+//#region src/server/microsoft-conversions-api.d.ts
+/**
+ * Microsoft's email normalization: trim, drop the dots and any `+alias` from the user part —
+ * for EVERY domain, unlike Google's gmail-only rule — lowercase, SHA-256. A value that is
+ * already a SHA-256 hex digest passes through.
+ * https://learn.microsoft.com/en-us/advertising/guides/uet-conversion-api-integration#hashed-identifiers
+ */
+declare function normalizeEmail(input: string): string;
+interface MicrosoftUserData {
+  /** Microsoft click id, as a dashed UUID. */
+  msclkid?: string;
+  /** SHA-256 of the normalized email. */
+  em?: string;
+  /** SHA-256 of the E.164 phone number. */
+  ph?: string;
+  /** The SDK visitor id — what the client-side ID Sync pixel (`sendUETIdSync`) sends as `VID`. */
+  anonymousId?: string;
+  /** SHA-256 of the signed-in user id — what `sendUETIdSync` sends as `UID`. */
+  externalId?: string;
+  clientUserAgent?: string;
+  clientIpAddress?: string;
+  idfa?: string;
+  gaid?: string;
+}
+interface MicrosoftItem {
+  id?: string;
+  name?: string;
+  price?: number;
+  quantity?: number;
+}
+interface MicrosoftCustomData {
+  eventCategory?: string;
+  eventLabel?: string;
+  eventValue?: number;
+  searchTerm?: string;
+  transactionId?: string;
+  value?: number;
+  currency?: string;
+  items?: MicrosoftItem[];
+  itemIds?: string[];
+  pageType?: string;
+  ecommTotalValue?: number;
+  ecommCategory?: string;
+}
+/** One entry of the `data` array POSTed to `/v1/{tagId}/events`. */
+interface MicrosoftEvent {
+  eventType: 'custom' | 'pageLoad';
+  eventId: string;
+  /** The UET action; absent on `pageLoad` events. */
+  eventName?: string;
+  /** UNIX seconds, UTC; the API rejects anything older than 7 days. */
+  eventTime: number;
+  eventSourceUrl?: string;
+  /** Links a `custom` event to its `pageLoad` event; a v4 UUID (the SDK's `page_load_id` tag). */
+  pageLoadId?: string;
+  referrerUrl?: string;
+  pageTitle?: string;
+  /** `G` granted, `D` denied. Absent means granted. */
+  adStorageConsent?: 'G' | 'D';
+  userData: MicrosoftUserData;
+  customData?: MicrosoftCustomData;
+}
+interface MicrosoftConversionsOptions {
+  /**
+   * EEA/UK/CH consent for the whole batch. `denied` events are accepted but used for nothing —
+   * no attribution, no audiences. Absent means granted, which is also the API's default.
+   */
+  consent?: 'granted' | 'denied';
+  /**
+   * Also send `page_view` events, as CAPI `pageLoad` events, and link every custom event to the
+   * page load it happened on (`pageLoadId`, from the `page_load_id` tag). Off by default because
+   * the UET JavaScript already reports every page load and the two would double-count
+   * destination-URL goals; turn it on for a CAPI-only site with no tag on the page. Off, no
+   * `pageLoadId` is sent either: it would point at a page load Microsoft only saw from the tag,
+   * under the tag's own id.
+   *
+   * Not yet modelled: the revenue-only custom event a `pageLoad` needs for a destination goal
+   * with variable revenue.
+   */
+  pageLoads?: boolean;
+  /** Identifies a third-party sender in Microsoft's monitoring; leave unset for a first-party build. */
+  dataProvider?: string;
+  /**
+   * Process the valid events of a batch and report the invalid ones, instead of the API's default
+   * all-or-nothing rejection. On by default — one malformed event should cost itself, not the
+   * batch it travelled with.
+   */
+  continueOnValidationError?: boolean;
+}
+interface MicrosoftValidationDetail {
+  index?: number;
+  propertyName?: string;
+  attemptedValue?: unknown;
+  errorMessage?: string;
+  errorCode?: string;
+  isWarning?: boolean;
+}
+interface MicrosoftConversionsResponse {
+  eventsReceived?: number;
+  error?: {
+    code?: string;
+    message?: string;
+    details?: MicrosoftValidationDetail[];
+  };
+}
+/**
+ * Build one CAPI event. `page_view` becomes a `pageLoad` event (the caller decides whether to
+ * send those, see `MicrosoftConversionsOptions.pageLoads`); everything else is a `custom` event
+ * named after the track event, which is also the UET action the browser sent.
+ */
+type MicrosoftEventOptions = Pick<MicrosoftConversionsOptions, 'consent' | 'pageLoads'>;
+declare function getServerEvent(event: TrackEvent<any>, data?: UserProvidedData,
+/** Options, or — the 8.3.0 signature, still accepted — the bare consent value. */
+options?: MicrosoftEventOptions | MicrosoftEventOptions['consent']): MicrosoftEvent;
+/**
+ * Send events to `POST /v1/{tagId}/events`. Batches above the API's 1,000-event limit are split
+ * into consecutive requests; one response is returned per request made. Never throws: an HTTP
+ * or network failure is logged (without the token) and yields no response for that request.
+ */
+declare function sendEvents(token: string, tagId: string | number, events: TrackEvent<any>[], data?: UserProvidedData, options?: MicrosoftConversionsOptions): Promise<MicrosoftConversionsResponse[]>;
+//#endregion
+export { MicrosoftConversionsOptions, MicrosoftConversionsResponse, MicrosoftCustomData, MicrosoftEvent, MicrosoftEventOptions, MicrosoftItem, MicrosoftUserData, MicrosoftValidationDetail, getServerEvent, normalizeEmail, sendEvents };
+//# sourceMappingURL=microsoft-conversions-api.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"microsoft-conversions-api.d.cts","names":[],"sources":["../../src/server/microsoft-conversions-api.ts"],"mappings":";;;;;;;;iBAwCgB,eAAe;UA2Bd;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;EACA;EACA;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;EACR;EACA;EACA;EACA;;;UAIe;EACf;EACA;;EAEA;;EAEA;EACA;;EAEA;EACA;EACA;;EAEA;EACA,UAAU;EACV,aAAa;;UAGE;;;;;EAKf;;;;;;;;;;;;EAYA;;EAEA;;;;;;EAMA;;UAGe;EACf;EACA;EACA;EACA;EACA;EACA;;UAGe;EACf;EACA;IAAU;IAAe;IAAkB,UAAU;;;;;;;;KA2D3C,wBAAwB,KAAK;iBAEzB,eAEd,OAAO,iBACP,OAAM,kBAEN;;AAAA,UAAS,wBAAwB,mCAChC;;;;;;iBA+BmB,WACpB,eACA,wBAEA,QAAQ,mBACR,OAAM,kBACN,UAAS,8BACR,QAAQ"}

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

@@ -0,0 +1,124 @@
+import { TrackEvent, UserProvidedData } from "../track/types.mjs";
+//#region src/server/microsoft-conversions-api.d.ts
+/**
+ * Microsoft's email normalization: trim, drop the dots and any `+alias` from the user part —
+ * for EVERY domain, unlike Google's gmail-only rule — lowercase, SHA-256. A value that is
+ * already a SHA-256 hex digest passes through.
+ * https://learn.microsoft.com/en-us/advertising/guides/uet-conversion-api-integration#hashed-identifiers
+ */
+declare function normalizeEmail(input: string): string;
+interface MicrosoftUserData {
+  /** Microsoft click id, as a dashed UUID. */
+  msclkid?: string;
+  /** SHA-256 of the normalized email. */
+  em?: string;
+  /** SHA-256 of the E.164 phone number. */
+  ph?: string;
+  /** The SDK visitor id — what the client-side ID Sync pixel (`sendUETIdSync`) sends as `VID`. */
+  anonymousId?: string;
+  /** SHA-256 of the signed-in user id — what `sendUETIdSync` sends as `UID`. */
+  externalId?: string;
+  clientUserAgent?: string;
+  clientIpAddress?: string;
+  idfa?: string;
+  gaid?: string;
+}
+interface MicrosoftItem {
+  id?: string;
+  name?: string;
+  price?: number;
+  quantity?: number;
+}
+interface MicrosoftCustomData {
+  eventCategory?: string;
+  eventLabel?: string;
+  eventValue?: number;
+  searchTerm?: string;
+  transactionId?: string;
+  value?: number;
+  currency?: string;
+  items?: MicrosoftItem[];
+  itemIds?: string[];
+  pageType?: string;
+  ecommTotalValue?: number;
+  ecommCategory?: string;
+}
+/** One entry of the `data` array POSTed to `/v1/{tagId}/events`. */
+interface MicrosoftEvent {
+  eventType: 'custom' | 'pageLoad';
+  eventId: string;
+  /** The UET action; absent on `pageLoad` events. */
+  eventName?: string;
+  /** UNIX seconds, UTC; the API rejects anything older than 7 days. */
+  eventTime: number;
+  eventSourceUrl?: string;
+  /** Links a `custom` event to its `pageLoad` event; a v4 UUID (the SDK's `page_load_id` tag). */
+  pageLoadId?: string;
+  referrerUrl?: string;
+  pageTitle?: string;
+  /** `G` granted, `D` denied. Absent means granted. */
+  adStorageConsent?: 'G' | 'D';
+  userData: MicrosoftUserData;
+  customData?: MicrosoftCustomData;
+}
+interface MicrosoftConversionsOptions {
+  /**
+   * EEA/UK/CH consent for the whole batch. `denied` events are accepted but used for nothing —
+   * no attribution, no audiences. Absent means granted, which is also the API's default.
+   */
+  consent?: 'granted' | 'denied';
+  /**
+   * Also send `page_view` events, as CAPI `pageLoad` events, and link every custom event to the
+   * page load it happened on (`pageLoadId`, from the `page_load_id` tag). Off by default because
+   * the UET JavaScript already reports every page load and the two would double-count
+   * destination-URL goals; turn it on for a CAPI-only site with no tag on the page. Off, no
+   * `pageLoadId` is sent either: it would point at a page load Microsoft only saw from the tag,
+   * under the tag's own id.
+   *
+   * Not yet modelled: the revenue-only custom event a `pageLoad` needs for a destination goal
+   * with variable revenue.
+   */
+  pageLoads?: boolean;
+  /** Identifies a third-party sender in Microsoft's monitoring; leave unset for a first-party build. */
+  dataProvider?: string;
+  /**
+   * Process the valid events of a batch and report the invalid ones, instead of the API's default
+   * all-or-nothing rejection. On by default — one malformed event should cost itself, not the
+   * batch it travelled with.
+   */
+  continueOnValidationError?: boolean;
+}
+interface MicrosoftValidationDetail {
+  index?: number;
+  propertyName?: string;
+  attemptedValue?: unknown;
+  errorMessage?: string;
+  errorCode?: string;
+  isWarning?: boolean;
+}
+interface MicrosoftConversionsResponse {
+  eventsReceived?: number;
+  error?: {
+    code?: string;
+    message?: string;
+    details?: MicrosoftValidationDetail[];
+  };
+}
+/**
+ * Build one CAPI event. `page_view` becomes a `pageLoad` event (the caller decides whether to
+ * send those, see `MicrosoftConversionsOptions.pageLoads`); everything else is a `custom` event
+ * named after the track event, which is also the UET action the browser sent.
+ */
+type MicrosoftEventOptions = Pick<MicrosoftConversionsOptions, 'consent' | 'pageLoads'>;
+declare function getServerEvent(event: TrackEvent<any>, data?: UserProvidedData,
+/** Options, or — the 8.3.0 signature, still accepted — the bare consent value. */
+options?: MicrosoftEventOptions | MicrosoftEventOptions['consent']): MicrosoftEvent;
+/**
+ * Send events to `POST /v1/{tagId}/events`. Batches above the API's 1,000-event limit are split
+ * into consecutive requests; one response is returned per request made. Never throws: an HTTP
+ * or network failure is logged (without the token) and yields no response for that request.
+ */
+declare function sendEvents(token: string, tagId: string | number, events: TrackEvent<any>[], data?: UserProvidedData, options?: MicrosoftConversionsOptions): Promise<MicrosoftConversionsResponse[]>;
+//#endregion
+export { MicrosoftConversionsOptions, MicrosoftConversionsResponse, MicrosoftCustomData, MicrosoftEvent, MicrosoftEventOptions, MicrosoftItem, MicrosoftUserData, MicrosoftValidationDetail, getServerEvent, normalizeEmail, sendEvents };
+//# sourceMappingURL=microsoft-conversions-api.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"microsoft-conversions-api.d.mts","names":[],"sources":["../../src/server/microsoft-conversions-api.ts"],"mappings":";;;;;;;;iBAwCgB,eAAe;UA2Bd;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;EACA;EACA;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;EACR;EACA;EACA;EACA;;;UAIe;EACf;EACA;;EAEA;;EAEA;EACA;;EAEA;EACA;EACA;;EAEA;EACA,UAAU;EACV,aAAa;;UAGE;;;;;EAKf;;;;;;;;;;;;EAYA;;EAEA;;;;;;EAMA;;UAGe;EACf;EACA;EACA;EACA;EACA;EACA;;UAGe;EACf;EACA;IAAU;IAAe;IAAkB,UAAU;;;;;;;;KA2D3C,wBAAwB,KAAK;iBAEzB,eAEd,OAAO,iBACP,OAAM,kBAEN;;AAAA,UAAS,wBAAwB,mCAChC;;;;;;iBA+BmB,WACpB,eACA,wBAEA,QAAQ,mBACR,OAAM,kBACN,UAAS,8BACR,QAAQ"}