@shware/analytics 8.2.0 → 8.3.0

package/dist/track/uetq.d.mts

@@ -0,0 +1,111 @@
+import { Item } from "./gtag.mjs";
+import { EventName, TrackName, TrackProperties } from "./types.mjs";
+//#region src/track/uetq.d.ts
+/**
+ * Microsoft Advertising Universal Event Tracking (UET) — the `uetq` queue that `bat.js` drains.
+ *
+ * UET's modern event API is gtag-shaped: `uetq.push('event', '<action>', { ...params })`, and the
+ * actions it knows (`purchase`, `add_to_cart`, `sign_up`, …) are GA4's recommended event names.
+ * Since this SDK's own event names are GA4's too, a standard event maps onto UET under the same
+ * name — only the parameter spellings differ (`value` → `revenue_value`, `Item` → `items[]`). An
+ * unknown name goes out unchanged as a custom event, which is what a UET *event goal* matches on.
+ *
+ * Parameter names below are taken from `bat.js` itself (`knownParams`); the tag silently drops
+ * any key it does not know, so an unmapped property is lost rather than an error. (bat.js's
+ * `knownEvents` list is not an allow-list — the tag only uses it to inherit page-level `set`
+ * parameters onto the events that carry them.)
+ *
+ * https://help.ads.microsoft.com/#apex/ads/en/56684/2 (custom events)
+ * https://help.ads.microsoft.com/#apex/ads/en/56910/1 (retail / dynamic remarketing)
+ * https://learn.microsoft.com/en-us/advertising/msa-help/hlp_ba_conc_uet_enhancedconversions
+ */
+/** The retail `ecomm_pagetype` values UET validates against. */
+type UETPageType = 'home' | 'searchresults' | 'category' | 'product' | 'cart' | 'purchase' | 'other';
+/** One entry of the `items` array (`items.*` in bat.js's `knownParams`). */
+interface UETItem {
+  id?: string;
+  name?: string;
+  brand?: string;
+  category?: string;
+  variant?: string;
+  price?: number;
+  quantity?: number;
+  list_name?: string;
+  list_position?: number;
+  location_id?: string;
+}
+/**
+ * Enhanced conversions identifiers. Sent RAW: the tag normalizes and SHA-256 hashes them in the
+ * browser before anything leaves the page (bat.js `validatePid`), and rejects a phone that is
+ * not E.164 after stripping separators.
+ */
+interface UETPid {
+  em?: string;
+  ph?: string;
+}
+/** The parameters of one `uetq.push('event', action, params)` call. */
+interface UETEventParams {
+  /** Deduplicates against the same event sent through the Conversions API. */
+  event_id?: string;
+  event_category?: string;
+  event_label?: string;
+  event_value?: number;
+  /** Variable revenue (`gv` on the wire). */
+  revenue_value?: number;
+  /** ISO 4217, uppercase (`gc` on the wire). */
+  currency?: string;
+  transaction_id?: string;
+  tax?: number;
+  shipping?: number;
+  coupon?: string;
+  items?: UETItem[];
+  search_term?: string;
+  method?: string;
+  content_type?: string;
+  content_id?: string;
+  ecomm_prodid?: string | string[];
+  ecomm_pagetype?: UETPageType;
+  ecomm_totalvalue?: number;
+  ecomm_category?: string;
+  pid?: UETPid;
+}
+type UETConsent = {
+  ad_storage: 'granted' | 'denied';
+  /**
+   * `default` only: milliseconds to hold events for an `update` before acting on the default,
+   * so a CMP that answers quickly does not cost the landing page. bat.js reads exactly this
+   * lowercase key (some community snippets spell it `Wait_for_update`, which it ignores) and
+   * caps it at 10,000.
+   */
+  wait_for_update?: number;
+};
+/**
+ * `window.uetq` is a plain array until `bat.js` loads (the snippet does `w[u] = w[u] || []`), then
+ * a `UET` instance that drains the queue; both expose `push`, which is all this SDK uses.
+ */
+interface UETQ {
+  push(command: 'event', action: string, params?: UETEventParams): void;
+  push(command: 'pageLoad'): void;
+  push(command: 'set', params: {
+    pid?: UETPid;
+  }): void;
+  push(command: 'consent', mode: 'default' | 'update', consent: UETConsent): void;
+}
+/** GA4 `Item` → UET `items[]` entry. Undefined fields are left for the caller to strip. */
+declare function mapItems(items?: Item[]): undefined | UETItem[];
+/**
+ * Map an internal track event onto a UET action and its parameters.
+ *
+ * The action is always the internal name: for the GA4-named standard events that is also the
+ * name UET knows, and for everything else it is the custom action a UET event goal is configured
+ * with. Keeping the name identical on both channels is what lets the Conversions API sender
+ * (`eventName`) deduplicate against the browser (`event_id`).
+ *
+ * `page_view` is special to the tag: bat.js routes that action to its page-load beacon (the same
+ * one the snippet fires on load and `enableAutoSpaTracking` fires on history changes), so the
+ * browser tracker does not forward it — see `sendUETEvent`.
+ */
+declare function mapUETEvent<T extends EventName>(name: TrackName<T>, properties?: TrackProperties<T>, eventId?: string): [string, UETEventParams];
+//#endregion
+export { UETConsent, UETEventParams, UETItem, UETPageType, UETPid, UETQ, mapItems, mapUETEvent };
+//# sourceMappingURL=uetq.d.mts.map

package/dist/track/uetq.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uetq.d.mts","names":[],"sources":["../../src/track/uetq.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;KAuBY;;UAUK;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;;UAQe;EACf;EACA;;;UAIe;;EAEf;EACA;EACA;EACA;;EAEA;;EAEA;EACA;EACA;EACA;EACA;EACA,QAAQ;EACR;EACA;EACA;EACA;EACA;EACA,iBAAiB;EACjB;EACA;EACA,MAAM;;KAGI;EACV;;;;;;;EAOA;;;;;;UAOe;EACf,KAAK,kBAAkB,gBAAgB,SAAS;EAChD,KAAK;EACL,KAAK,gBAAgB;IAAU,MAAM;;EACrC,KAAK,oBAAoB,4BAA4B,SAAS;;;iBAIhD,SAAS,QAAQ,qBAAqB;;;;;;;;;;;;;iBAuDtC,YAAY,UAAU,WACpC,MAAM,UAAU,IAChB,aAAa,gBAAgB,IAC7B,4BACU"}

package/dist/track/uetq.mjs

@@ -0,0 +1,78 @@
+//#region src/track/uetq.ts
+/** GA4 `Item` → UET `items[]` entry. Undefined fields are left for the caller to strip. */
+function mapItems(items) {
+	if (!items || items.length === 0) return void 0;
+	return items.map((item) => ({
+		id: item.item_id,
+		name: item.item_name,
+		brand: item.item_brand,
+		category: item.item_category,
+		variant: item.item_variant,
+		price: item.price,
+		quantity: item.quantity,
+		list_name: item.item_list_name,
+		list_position: item.index,
+		location_id: item.location_id
+	}));
+}
+function number(value) {
+	return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function string(value) {
+	return typeof value === "string" && value !== "" ? value : void 0;
+}
+function currency(value) {
+	return string(value)?.toUpperCase();
+}
+const PAGE_TYPES = [
+	"home",
+	"searchresults",
+	"category",
+	"product",
+	"cart",
+	"purchase",
+	"other"
+];
+function pageType(value) {
+	const lowered = string(value)?.toLowerCase();
+	return lowered && PAGE_TYPES.includes(lowered) ? lowered : void 0;
+}
+/**
+* Map an internal track event onto a UET action and its parameters.
+*
+* The action is always the internal name: for the GA4-named standard events that is also the
+* name UET knows, and for everything else it is the custom action a UET event goal is configured
+* with. Keeping the name identical on both channels is what lets the Conversions API sender
+* (`eventName`) deduplicate against the browser (`event_id`).
+*
+* `page_view` is special to the tag: bat.js routes that action to its page-load beacon (the same
+* one the snippet fires on load and `enableAutoSpaTracking` fires on history changes), so the
+* browser tracker does not forward it — see `sendUETEvent`.
+*/
+function mapUETEvent(name, properties, eventId) {
+	const p = properties ?? {};
+	const params = { event_id: eventId };
+	params.revenue_value = number(p.value) ?? number(p.revenue_value);
+	params.currency = currency(p.currency);
+	params.transaction_id = string(p.transaction_id);
+	params.tax = number(p.tax);
+	params.shipping = number(p.shipping);
+	params.coupon = string(p.coupon);
+	params.items = Array.isArray(p.items) ? mapItems(p.items) : void 0;
+	params.search_term = string(p.search_term);
+	params.method = string(p.method);
+	params.content_type = string(p.content_type);
+	params.content_id = string(p.content_id);
+	params.event_category = string(p.event_category);
+	params.event_label = string(p.event_label);
+	params.event_value = number(p.event_value);
+	params.ecomm_pagetype = pageType(p.ecomm_pagetype);
+	params.ecomm_prodid = params.ecomm_pagetype ? Array.isArray(p.ecomm_prodid) ? p.ecomm_prodid : string(p.ecomm_prodid) : void 0;
+	params.ecomm_totalvalue = number(p.ecomm_totalvalue);
+	params.ecomm_category = string(p.ecomm_category);
+	return [name, params];
+}
+//#endregion
+export { mapItems, mapUETEvent };
+
+//# sourceMappingURL=uetq.mjs.map

package/dist/track/uetq.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"uetq.mjs","names":[],"sources":["../../src/track/uetq.ts"],"sourcesContent":["import type { Item } from './gtag';\nimport type { EventName, TrackName, TrackProperties } from './types';\n\n/**\n * Microsoft Advertising Universal Event Tracking (UET) — the `uetq` queue that `bat.js` drains.\n *\n * UET's modern event API is gtag-shaped: `uetq.push('event', '<action>', { ...params })`, and the\n * actions it knows (`purchase`, `add_to_cart`, `sign_up`, …) are GA4's recommended event names.\n * Since this SDK's own event names are GA4's too, a standard event maps onto UET under the same\n * name — only the parameter spellings differ (`value` → `revenue_value`, `Item` → `items[]`). An\n * unknown name goes out unchanged as a custom event, which is what a UET *event goal* matches on.\n *\n * Parameter names below are taken from `bat.js` itself (`knownParams`); the tag silently drops\n * any key it does not know, so an unmapped property is lost rather than an error. (bat.js's\n * `knownEvents` list is not an allow-list — the tag only uses it to inherit page-level `set`\n * parameters onto the events that carry them.)\n *\n * https://help.ads.microsoft.com/#apex/ads/en/56684/2 (custom events)\n * https://help.ads.microsoft.com/#apex/ads/en/56910/1 (retail / dynamic remarketing)\n * https://learn.microsoft.com/en-us/advertising/msa-help/hlp_ba_conc_uet_enhancedconversions\n */\n\n/** The retail `ecomm_pagetype` values UET validates against. */\nexport type UETPageType =\n  | 'home'\n  | 'searchresults'\n  | 'category'\n  | 'product'\n  | 'cart'\n  | 'purchase'\n  | 'other';\n\n/** One entry of the `items` array (`items.*` in bat.js's `knownParams`). */\nexport interface UETItem {\n  id?: string;\n  name?: string;\n  brand?: string;\n  category?: string;\n  variant?: string;\n  price?: number;\n  quantity?: number;\n  list_name?: string;\n  list_position?: number;\n  location_id?: string;\n}\n\n/**\n * Enhanced conversions identifiers. Sent RAW: the tag normalizes and SHA-256 hashes them in the\n * browser before anything leaves the page (bat.js `validatePid`), and rejects a phone that is\n * not E.164 after stripping separators.\n */\nexport interface UETPid {\n  em?: string;\n  ph?: string;\n}\n\n/** The parameters of one `uetq.push('event', action, params)` call. */\nexport interface UETEventParams {\n  /** Deduplicates against the same event sent through the Conversions API. */\n  event_id?: string;\n  event_category?: string;\n  event_label?: string;\n  event_value?: number;\n  /** Variable revenue (`gv` on the wire). */\n  revenue_value?: number;\n  /** ISO 4217, uppercase (`gc` on the wire). */\n  currency?: string;\n  transaction_id?: string;\n  tax?: number;\n  shipping?: number;\n  coupon?: string;\n  items?: UETItem[];\n  search_term?: string;\n  method?: string;\n  content_type?: string;\n  content_id?: string;\n  ecomm_prodid?: string | string[];\n  ecomm_pagetype?: UETPageType;\n  ecomm_totalvalue?: number;\n  ecomm_category?: string;\n  pid?: UETPid;\n}\n\nexport type UETConsent = {\n  ad_storage: 'granted' | 'denied';\n  /**\n   * `default` only: milliseconds to hold events for an `update` before acting on the default,\n   * so a CMP that answers quickly does not cost the landing page. bat.js reads exactly this\n   * lowercase key (some community snippets spell it `Wait_for_update`, which it ignores) and\n   * caps it at 10,000.\n   */\n  wait_for_update?: number;\n};\n\n/**\n * `window.uetq` is a plain array until `bat.js` loads (the snippet does `w[u] = w[u] || []`), then\n * a `UET` instance that drains the queue; both expose `push`, which is all this SDK uses.\n */\nexport interface UETQ {\n  push(command: 'event', action: string, params?: UETEventParams): void;\n  push(command: 'pageLoad'): void;\n  push(command: 'set', params: { pid?: UETPid }): void;\n  push(command: 'consent', mode: 'default' | 'update', consent: UETConsent): void;\n}\n\n/** GA4 `Item` → UET `items[]` entry. Undefined fields are left for the caller to strip. */\nexport function mapItems(items?: Item[]): undefined | UETItem[] {\n  if (!items || items.length === 0) return undefined;\n  return items.map((item) => ({\n    id: item.item_id,\n    name: item.item_name,\n    brand: item.item_brand,\n    category: item.item_category,\n    variant: item.item_variant,\n    price: item.price,\n    quantity: item.quantity,\n    list_name: item.item_list_name,\n    list_position: item.index,\n    location_id: item.location_id,\n  }));\n}\n\nfunction number(value: unknown): number | undefined {\n  return typeof value === 'number' && Number.isFinite(value) ? value : undefined;\n}\n\nfunction string(value: unknown): string | undefined {\n  return typeof value === 'string' && value !== '' ? value : undefined;\n}\n\nfunction currency(value: unknown): string | undefined {\n  return string(value)?.toUpperCase();\n}\n\nconst PAGE_TYPES: string[] = [\n  'home',\n  'searchresults',\n  'category',\n  'product',\n  'cart',\n  'purchase',\n  'other',\n];\n\nfunction pageType(value: unknown): UETPageType | undefined {\n  const lowered = string(value)?.toLowerCase();\n  return lowered && PAGE_TYPES.includes(lowered) ? (lowered as UETPageType) : undefined;\n}\n\n/**\n * Map an internal track event onto a UET action and its parameters.\n *\n * The action is always the internal name: for the GA4-named standard events that is also the\n * name UET knows, and for everything else it is the custom action a UET event goal is configured\n * with. Keeping the name identical on both channels is what lets the Conversions API sender\n * (`eventName`) deduplicate against the browser (`event_id`).\n *\n * `page_view` is special to the tag: bat.js routes that action to its page-load beacon (the same\n * one the snippet fires on load and `enableAutoSpaTracking` fires on history changes), so the\n * browser tracker does not forward it — see `sendUETEvent`.\n */\nexport function mapUETEvent<T extends EventName>(\n  name: TrackName<T>,\n  properties?: TrackProperties<T>,\n  eventId?: string\n): [string, UETEventParams] {\n  // A loose view of whatever the caller passed: every branch below reads only the keys it\n  // knows and validates their types, so an event with foreign properties cannot leak them.\n  const p = (properties ?? {}) as Record<string, unknown>;\n  const params: UETEventParams = { event_id: eventId };\n\n  // GA4's commerce parameters, spelled the UET way. `value` is GA4's revenue field and becomes\n  // UET's variable revenue; every key here is one bat.js lists for the events that carry it.\n  params.revenue_value = number(p.value) ?? number(p.revenue_value);\n  params.currency = currency(p.currency);\n  params.transaction_id = string(p.transaction_id);\n  params.tax = number(p.tax);\n  params.shipping = number(p.shipping);\n  params.coupon = string(p.coupon);\n  params.items = Array.isArray(p.items) ? mapItems(p.items as Item[]) : undefined;\n  params.search_term = string(p.search_term);\n  params.method = string(p.method);\n  params.content_type = string(p.content_type);\n  params.content_id = string(p.content_id);\n\n  // The custom-event goal fields and the retail (dynamic remarketing) fields pass through under\n  // their UET names, so a host can attach them to any event it defines.\n  params.event_category = string(p.event_category);\n  params.event_label = string(p.event_label);\n  params.event_value = number(p.event_value);\n  // bat.js throws on a `prodid` without a `pagetype` (`missingPageTypeException`), which would\n  // cost the whole event; a product id on its own is dropped instead.\n  params.ecomm_pagetype = pageType(p.ecomm_pagetype);\n  params.ecomm_prodid = params.ecomm_pagetype\n    ? Array.isArray(p.ecomm_prodid)\n      ? (p.ecomm_prodid as string[])\n      : string(p.ecomm_prodid)\n    : undefined;\n  params.ecomm_totalvalue = number(p.ecomm_totalvalue);\n  params.ecomm_category = string(p.ecomm_category);\n\n  return [name, params];\n}\n"],"mappings":";;AA0GA,SAAgB,SAAS,OAAuC;CAC9D,IAAI,CAAC,SAAS,MAAM,WAAW,GAAG,OAAO,KAAA;CACzC,OAAO,MAAM,KAAK,UAAU;EAC1B,IAAI,KAAK;EACT,MAAM,KAAK;EACX,OAAO,KAAK;EACZ,UAAU,KAAK;EACf,SAAS,KAAK;EACd,OAAO,KAAK;EACZ,UAAU,KAAK;EACf,WAAW,KAAK;EAChB,eAAe,KAAK;EACpB,aAAa,KAAK;CACpB,EAAE;AACJ;AAEA,SAAS,OAAO,OAAoC;CAClD,OAAO,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,IAAI,QAAQ,KAAA;AACvE;AAEA,SAAS,OAAO,OAAoC;CAClD,OAAO,OAAO,UAAU,YAAY,UAAU,KAAK,QAAQ,KAAA;AAC7D;AAEA,SAAS,SAAS,OAAoC;CACpD,OAAO,OAAO,KAAK,CAAC,EAAE,YAAY;AACpC;AAEA,MAAM,aAAuB;CAC3B;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,SAAS,SAAS,OAAyC;CACzD,MAAM,UAAU,OAAO,KAAK,CAAC,EAAE,YAAY;CAC3C,OAAO,WAAW,WAAW,SAAS,OAAO,IAAK,UAA0B,KAAA;AAC9E;;;;;;;;;;;;;AAcA,SAAgB,YACd,MACA,YACA,SAC0B;CAG1B,MAAM,IAAK,cAAc,CAAC;CAC1B,MAAM,SAAyB,EAAE,UAAU,QAAQ;CAInD,OAAO,gBAAgB,OAAO,EAAE,KAAK,KAAK,OAAO,EAAE,aAAa;CAChE,OAAO,WAAW,SAAS,EAAE,QAAQ;CACrC,OAAO,iBAAiB,OAAO,EAAE,cAAc;CAC/C,OAAO,MAAM,OAAO,EAAE,GAAG;CACzB,OAAO,WAAW,OAAO,EAAE,QAAQ;CACnC,OAAO,SAAS,OAAO,EAAE,MAAM;CAC/B,OAAO,QAAQ,MAAM,QAAQ,EAAE,KAAK,IAAI,SAAS,EAAE,KAAe,IAAI,KAAA;CACtE,OAAO,cAAc,OAAO,EAAE,WAAW;CACzC,OAAO,SAAS,OAAO,EAAE,MAAM;CAC/B,OAAO,eAAe,OAAO,EAAE,YAAY;CAC3C,OAAO,aAAa,OAAO,EAAE,UAAU;CAIvC,OAAO,iBAAiB,OAAO,EAAE,cAAc;CAC/C,OAAO,cAAc,OAAO,EAAE,WAAW;CACzC,OAAO,cAAc,OAAO,EAAE,WAAW;CAGzC,OAAO,iBAAiB,SAAS,EAAE,cAAc;CACjD,OAAO,eAAe,OAAO,iBACzB,MAAM,QAAQ,EAAE,YAAY,IACzB,EAAE,eACH,OAAO,EAAE,YAAY,IACvB,KAAA;CACJ,OAAO,mBAAmB,OAAO,EAAE,gBAAgB;CACnD,OAAO,iBAAiB,OAAO,EAAE,cAAc;CAE/C,OAAO,CAAC,MAAM,MAAM;AACtB"}

package/dist/utils/sha256.cjs

@@ -0,0 +1,19 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/utils/sha256.ts
+/**
+* SHA-256 hex digest, lowercase, computed in the browser with SubtleCrypto — the format every
+* ad platform expects for a hashed identifier, and the same digest the server-side senders
+* produce with `node:crypto`, so a value hashed on either side matches.
+*
+* Asynchronous because `crypto.subtle.digest` is; it rejects where SubtleCrypto is unavailable
+* (an insecure context), so callers decide what to send without the hash.
+*/
+async function sha256(value) {
+	const bytes = new TextEncoder().encode(value);
+	const digest = await crypto.subtle.digest("SHA-256", bytes);
+	return Array.from(new Uint8Array(digest)).map((byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+//#endregion
+exports.sha256 = sha256;
+
+//# sourceMappingURL=sha256.cjs.map

package/dist/utils/sha256.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha256.cjs","names":[],"sources":["../../src/utils/sha256.ts"],"sourcesContent":["/**\n * SHA-256 hex digest, lowercase, computed in the browser with SubtleCrypto — the format every\n * ad platform expects for a hashed identifier, and the same digest the server-side senders\n * produce with `node:crypto`, so a value hashed on either side matches.\n *\n * Asynchronous because `crypto.subtle.digest` is; it rejects where SubtleCrypto is unavailable\n * (an insecure context), so callers decide what to send without the hash.\n */\nexport async function sha256(value: string): Promise<string> {\n  const bytes = new TextEncoder().encode(value);\n  const digest = await crypto.subtle.digest('SHA-256', bytes);\n  return Array.from(new Uint8Array(digest))\n    .map((byte) => byte.toString(16).padStart(2, '0'))\n    .join('');\n}\n"],"mappings":";;;;;;;;;;AAQA,eAAsB,OAAO,OAAgC;CAC3D,MAAM,QAAQ,IAAI,YAAY,CAAC,CAAC,OAAO,KAAK;CAC5C,MAAM,SAAS,MAAM,OAAO,OAAO,OAAO,WAAW,KAAK;CAC1D,OAAO,MAAM,KAAK,IAAI,WAAW,MAAM,CAAC,CAAC,CACtC,KAAK,SAAS,KAAK,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,CACjD,KAAK,EAAE;AACZ"}

package/dist/utils/sha256.d.cts

@@ -0,0 +1,13 @@
+//#region src/utils/sha256.d.ts
+/**
+ * SHA-256 hex digest, lowercase, computed in the browser with SubtleCrypto — the format every
+ * ad platform expects for a hashed identifier, and the same digest the server-side senders
+ * produce with `node:crypto`, so a value hashed on either side matches.
+ *
+ * Asynchronous because `crypto.subtle.digest` is; it rejects where SubtleCrypto is unavailable
+ * (an insecure context), so callers decide what to send without the hash.
+ */
+declare function sha256(value: string): Promise<string>;
+//#endregion
+export { sha256 };
+//# sourceMappingURL=sha256.d.cts.map

package/dist/utils/sha256.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha256.d.cts","names":[],"sources":["../../src/utils/sha256.ts"],"mappings":";;;;;;;;;iBAQsB,OAAO,gBAAgB"}

package/dist/utils/sha256.d.mts

@@ -0,0 +1,13 @@
+//#region src/utils/sha256.d.ts
+/**
+ * SHA-256 hex digest, lowercase, computed in the browser with SubtleCrypto — the format every
+ * ad platform expects for a hashed identifier, and the same digest the server-side senders
+ * produce with `node:crypto`, so a value hashed on either side matches.
+ *
+ * Asynchronous because `crypto.subtle.digest` is; it rejects where SubtleCrypto is unavailable
+ * (an insecure context), so callers decide what to send without the hash.
+ */
+declare function sha256(value: string): Promise<string>;
+//#endregion
+export { sha256 };
+//# sourceMappingURL=sha256.d.mts.map

package/dist/utils/sha256.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha256.d.mts","names":[],"sources":["../../src/utils/sha256.ts"],"mappings":";;;;;;;;;iBAQsB,OAAO,gBAAgB"}

package/dist/utils/sha256.mjs

@@ -0,0 +1,18 @@
+//#region src/utils/sha256.ts
+/**
+* SHA-256 hex digest, lowercase, computed in the browser with SubtleCrypto — the format every
+* ad platform expects for a hashed identifier, and the same digest the server-side senders
+* produce with `node:crypto`, so a value hashed on either side matches.
+*
+* Asynchronous because `crypto.subtle.digest` is; it rejects where SubtleCrypto is unavailable
+* (an insecure context), so callers decide what to send without the hash.
+*/
+async function sha256(value) {
+	const bytes = new TextEncoder().encode(value);
+	const digest = await crypto.subtle.digest("SHA-256", bytes);
+	return Array.from(new Uint8Array(digest)).map((byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+//#endregion
+export { sha256 };
+
+//# sourceMappingURL=sha256.mjs.map

package/dist/utils/sha256.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha256.mjs","names":[],"sources":["../../src/utils/sha256.ts"],"sourcesContent":["/**\n * SHA-256 hex digest, lowercase, computed in the browser with SubtleCrypto — the format every\n * ad platform expects for a hashed identifier, and the same digest the server-side senders\n * produce with `node:crypto`, so a value hashed on either side matches.\n *\n * Asynchronous because `crypto.subtle.digest` is; it rejects where SubtleCrypto is unavailable\n * (an insecure context), so callers decide what to send without the hash.\n */\nexport async function sha256(value: string): Promise<string> {\n  const bytes = new TextEncoder().encode(value);\n  const digest = await crypto.subtle.digest('SHA-256', bytes);\n  return Array.from(new Uint8Array(digest))\n    .map((byte) => byte.toString(16).padStart(2, '0'))\n    .join('');\n}\n"],"mappings":";;;;;;;;;AAQA,eAAsB,OAAO,OAAgC;CAC3D,MAAM,QAAQ,IAAI,YAAY,CAAC,CAAC,OAAO,KAAK;CAC5C,MAAM,SAAS,MAAM,OAAO,OAAO,OAAO,WAAW,KAAK;CAC1D,OAAO,MAAM,KAAK,IAAI,WAAW,MAAM,CAAC,CAAC,CACtC,KAAK,SAAS,KAAK,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,CACjD,KAAK,EAAE;AACZ"}

package/dist/web/index.cjs

@@ -87,7 +87,7 @@ async function getTags() {
 		li_fat_id: params.get("li_fat_id") ?? parsed.li_fat_id ?? void 0,
 		dclid: params.get("dclid") ?? void 0,
 		ko_click_id: params.get("ko_click_id") ?? void 0,
-		msclkid: params.get("msclkid") ?? void 0,
+		msclkid: params.get("msclkid") ?? require_click_id_index.parseUetMsclkid(parsed._uetmsclkid),
 		sccid: params.get("sccid") ?? void 0,
 		ttclid: params.get("ttclid") ?? void 0,
 		twclid: params.get("twclid") ?? void 0,

package/dist/web/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["config","keys","uuidv4","getLink","Bowser","parseCookie","parseGcl"],"sources":["../../src/web/index.ts"],"sourcesContent":["import Bowser from 'bowser';\nimport { parseCookie } from 'cookie';\nimport { v4 as uuidv4 } from 'uuid';\nimport { parseGcl } from '../click-id/index';\nimport { keys } from '../constants/storage';\nimport { type Link, getLink } from '../link/index';\nimport { type Storage, cache, config } from '../setup/index';\nimport type { TrackTags } from '../track/types';\n\nexport function getDeviceId() {\n  const cached = config.storage.getItem(keys.device_id);\n  if (cached) return cached;\n  // lib.dom types `crypto.randomUUID` as always present, but it is missing in\n  // insecure contexts and older browsers, so probe it before use.\n  const id = (crypto as Partial<Crypto>).randomUUID ? crypto.randomUUID() : uuidv4();\n  config.storage.setItem(keys.device_id, id);\n  return id;\n}\n\nconst links = new Map<string, Promise<Link | null>>();\n\n/**\n * `getTags` runs once per event now, and the link a `?s=` id points at cannot change while the\n * page is open, so an uncached lookup would put an identical request on the wire for every\n * event the page sends.\n */\nfunction getCachedLink(id: string) {\n  const cached = links.get(id);\n  if (cached) return cached;\n  const link = getLink(id).then((result) => {\n    // A lookup that came back empty must not stick for the lifetime of the page. `getLink`\n    // answers null for a network failure as well as for a link that does not exist, and losing\n    // the link's utm params for every later event costs more than repeating a rare request.\n    if (!result) links.delete(id);\n    return result;\n  });\n  links.set(id, link);\n  return link;\n}\n\n/** The user agent cannot change while the page is open, so it is parsed once. */\nlet parser: ReturnType<typeof Bowser.getParser> | undefined;\n\nexport async function getTags() {\n  // Read the page before the first await: `getTags` runs when the event happens, and a single\n  // page app can navigate while the link lookup below is still in flight.\n  const page_location = window.location.href;\n  const page_referrer = document.referrer || undefined;\n  const page_title = document.title;\n\n  parser ??= Bowser.getParser(window.navigator.userAgent);\n  const params = new URLSearchParams(window.location.search);\n  const os = parser.getOS();\n  const browser = parser.getBrowser();\n  const platform = parser.getPlatform();\n  const parsed = parseCookie(document.cookie);\n\n  const linkId = params.get('s');\n  const link = linkId ? await getCachedLink(linkId) : null;\n\n  const tags: TrackTags = {\n    os: `${os.name} ${os.version}`,\n    os_name: os.name,\n    os_version: os.version,\n    browser: `${browser.name} ${browser.version}`,\n    browser_name: browser.name,\n    browser_version: browser.version,\n    device: platform.model,\n    device_id: getDeviceId(),\n    device_type: platform.type,\n    device_vendor: platform.vendor,\n    device_pixel_ratio: window.devicePixelRatio,\n    screen_width: window.screen.width,\n    screen_height: window.screen.height,\n    screen_resolution: `${window.screen.width}x${window.screen.height}`,\n    release: config.release,\n    language: navigator.language,\n    time_zone: Intl.DateTimeFormat().resolvedOptions().timeZone,\n    page_location,\n    page_referrer,\n    page_title,\n    // Meta Ads — _fbc is set server-side (see @shware/analytics/server resolveClickIdCookies)\n    fbc: parsed._fbc ?? undefined,\n    fbp: parsed._fbp,\n    fbclid: params.get('fbclid') ?? undefined,\n    ad_id: params.get('ad_id') ?? undefined,\n    ad_name: params.get('ad_name') ?? undefined,\n    adset_id: params.get('adset_id') ?? undefined,\n    adset_name: params.get('adset_name') ?? undefined,\n    campaign_id: params.get('campaign_id') ?? undefined,\n    campaign_name: params.get('campaign_name') ?? undefined,\n    placement: params.get('placement') ?? undefined,\n    site_source_name: params.get('site_source_name') ?? undefined,\n    // Google Ads — _gcl_aw/_gcl_gb are written by gtag and kept alive server-side (see\n    // @shware/analytics/server resolveClickIdCookies); the URL wins, the cookie carries the\n    // click id to every later page of the visit and to returning visits.\n    gclid: params.get('gclid') ?? parseGcl(parsed._gcl_aw)?.clickId,\n    gclsrc: params.get('gclsrc') ?? undefined,\n    gad_source: params.get('gad_source') ?? undefined,\n    gad_campaignid: params.get('gad_campaignid') ?? undefined,\n    // Reddit Ads — _rdt_cid is set server-side (see @shware/analytics/server resolveClickIdCookies)\n    rdt_cid: params.get('rdt_cid') ?? parsed._rdt_cid ?? undefined,\n    rdt_uuid: parsed._rdt_uuid,\n    // LinkedIn Ads: get click id from url params or first-party cookie\n    li_fat_id: params.get('li_fat_id') ?? parsed.li_fat_id ?? undefined,\n    // click ids\n    dclid: params.get('dclid') ?? undefined,\n    ko_click_id: params.get('ko_click_id') ?? undefined,\n    msclkid: params.get('msclkid') ?? undefined,\n    sccid: params.get('sccid') ?? undefined,\n    ttclid: params.get('ttclid') ?? undefined,\n    twclid: params.get('twclid') ?? undefined,\n    wbraid: params.get('wbraid') ?? parseGcl(parsed._gcl_gb)?.clickId,\n    gbraid: params.get('gbraid') ?? undefined,\n    yclid: params.get('yclid') ?? undefined,\n    // utm params\n    utm_source: link?.utm_source ?? params.get('utm_source') ?? undefined,\n    utm_medium: link?.utm_medium ?? params.get('utm_medium') ?? undefined,\n    utm_campaign: link?.utm_campaign ?? params.get('utm_campaign') ?? undefined,\n    utm_term: link?.utm_term ?? params.get('utm_term') ?? undefined,\n    utm_content: link?.utm_content ?? params.get('utm_content') ?? undefined,\n    utm_id: link?.utm_id ?? params.get('utm_id') ?? undefined,\n    utm_source_platform:\n      link?.utm_source_platform ?? params.get('utm_source_platform') ?? undefined,\n    utm_creative_format:\n      link?.utm_creative_format ?? params.get('utm_creative_format') ?? undefined,\n    utm_marketing_tactic:\n      link?.utm_marketing_tactic ?? params.get('utm_marketing_tactic') ?? undefined,\n  };\n\n  cache.tags = tags;\n  return tags;\n}\n\nconst map = new Map<string, string>();\n\nexport const storage: Storage = {\n  getItem: (key) => {\n    try {\n      return localStorage.getItem(key);\n    } catch {\n      console.error('localStorage is not available');\n      return map.get(key) ?? null;\n    }\n  },\n  setItem: (key, value) => {\n    try {\n      localStorage.setItem(key, value);\n    } catch {\n      console.error('localStorage is not available');\n      map.set(key, value);\n    }\n  },\n};\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["config","keys","uuidv4","getLink","Bowser","parseCookie","parseGcl","parseUetMsclkid"],"sources":["../../src/web/index.ts"],"sourcesContent":["import Bowser from 'bowser';\nimport { parseCookie } from 'cookie';\nimport { v4 as uuidv4 } from 'uuid';\nimport { parseGcl, parseUetMsclkid } from '../click-id/index';\nimport { keys } from '../constants/storage';\nimport { type Link, getLink } from '../link/index';\nimport { type Storage, cache, config } from '../setup/index';\nimport type { TrackTags } from '../track/types';\n\nexport function getDeviceId() {\n  const cached = config.storage.getItem(keys.device_id);\n  if (cached) return cached;\n  // lib.dom types `crypto.randomUUID` as always present, but it is missing in\n  // insecure contexts and older browsers, so probe it before use.\n  const id = (crypto as Partial<Crypto>).randomUUID ? crypto.randomUUID() : uuidv4();\n  config.storage.setItem(keys.device_id, id);\n  return id;\n}\n\nconst links = new Map<string, Promise<Link | null>>();\n\n/**\n * `getTags` runs once per event now, and the link a `?s=` id points at cannot change while the\n * page is open, so an uncached lookup would put an identical request on the wire for every\n * event the page sends.\n */\nfunction getCachedLink(id: string) {\n  const cached = links.get(id);\n  if (cached) return cached;\n  const link = getLink(id).then((result) => {\n    // A lookup that came back empty must not stick for the lifetime of the page. `getLink`\n    // answers null for a network failure as well as for a link that does not exist, and losing\n    // the link's utm params for every later event costs more than repeating a rare request.\n    if (!result) links.delete(id);\n    return result;\n  });\n  links.set(id, link);\n  return link;\n}\n\n/** The user agent cannot change while the page is open, so it is parsed once. */\nlet parser: ReturnType<typeof Bowser.getParser> | undefined;\n\nexport async function getTags() {\n  // Read the page before the first await: `getTags` runs when the event happens, and a single\n  // page app can navigate while the link lookup below is still in flight.\n  const page_location = window.location.href;\n  const page_referrer = document.referrer || undefined;\n  const page_title = document.title;\n\n  parser ??= Bowser.getParser(window.navigator.userAgent);\n  const params = new URLSearchParams(window.location.search);\n  const os = parser.getOS();\n  const browser = parser.getBrowser();\n  const platform = parser.getPlatform();\n  const parsed = parseCookie(document.cookie);\n\n  const linkId = params.get('s');\n  const link = linkId ? await getCachedLink(linkId) : null;\n\n  const tags: TrackTags = {\n    os: `${os.name} ${os.version}`,\n    os_name: os.name,\n    os_version: os.version,\n    browser: `${browser.name} ${browser.version}`,\n    browser_name: browser.name,\n    browser_version: browser.version,\n    device: platform.model,\n    device_id: getDeviceId(),\n    device_type: platform.type,\n    device_vendor: platform.vendor,\n    device_pixel_ratio: window.devicePixelRatio,\n    screen_width: window.screen.width,\n    screen_height: window.screen.height,\n    screen_resolution: `${window.screen.width}x${window.screen.height}`,\n    release: config.release,\n    language: navigator.language,\n    time_zone: Intl.DateTimeFormat().resolvedOptions().timeZone,\n    page_location,\n    page_referrer,\n    page_title,\n    // Meta Ads — _fbc is set server-side (see @shware/analytics/server resolveClickIdCookies)\n    fbc: parsed._fbc ?? undefined,\n    fbp: parsed._fbp,\n    fbclid: params.get('fbclid') ?? undefined,\n    ad_id: params.get('ad_id') ?? undefined,\n    ad_name: params.get('ad_name') ?? undefined,\n    adset_id: params.get('adset_id') ?? undefined,\n    adset_name: params.get('adset_name') ?? undefined,\n    campaign_id: params.get('campaign_id') ?? undefined,\n    campaign_name: params.get('campaign_name') ?? undefined,\n    placement: params.get('placement') ?? undefined,\n    site_source_name: params.get('site_source_name') ?? undefined,\n    // Google Ads — _gcl_aw/_gcl_gb are written by gtag and kept alive server-side (see\n    // @shware/analytics/server resolveClickIdCookies); the URL wins, the cookie carries the\n    // click id to every later page of the visit and to returning visits.\n    gclid: params.get('gclid') ?? parseGcl(parsed._gcl_aw)?.clickId,\n    gclsrc: params.get('gclsrc') ?? undefined,\n    gad_source: params.get('gad_source') ?? undefined,\n    gad_campaignid: params.get('gad_campaignid') ?? undefined,\n    // Reddit Ads — _rdt_cid is set server-side (see @shware/analytics/server resolveClickIdCookies)\n    rdt_cid: params.get('rdt_cid') ?? parsed._rdt_cid ?? undefined,\n    rdt_uuid: parsed._rdt_uuid,\n    // LinkedIn Ads: get click id from url params or first-party cookie\n    li_fat_id: params.get('li_fat_id') ?? parsed.li_fat_id ?? undefined,\n    // click ids\n    dclid: params.get('dclid') ?? undefined,\n    ko_click_id: params.get('ko_click_id') ?? undefined,\n    // Microsoft Ads — _uetmsclkid is written by the UET tag and kept alive server-side (see\n    // @shware/analytics/server resolveClickIdCookies); the URL wins, the cookie carries the\n    // click id to every later page of the visit and to returning visits.\n    msclkid: params.get('msclkid') ?? parseUetMsclkid(parsed._uetmsclkid),\n    sccid: params.get('sccid') ?? undefined,\n    ttclid: params.get('ttclid') ?? undefined,\n    twclid: params.get('twclid') ?? undefined,\n    wbraid: params.get('wbraid') ?? parseGcl(parsed._gcl_gb)?.clickId,\n    gbraid: params.get('gbraid') ?? undefined,\n    yclid: params.get('yclid') ?? undefined,\n    // utm params\n    utm_source: link?.utm_source ?? params.get('utm_source') ?? undefined,\n    utm_medium: link?.utm_medium ?? params.get('utm_medium') ?? undefined,\n    utm_campaign: link?.utm_campaign ?? params.get('utm_campaign') ?? undefined,\n    utm_term: link?.utm_term ?? params.get('utm_term') ?? undefined,\n    utm_content: link?.utm_content ?? params.get('utm_content') ?? undefined,\n    utm_id: link?.utm_id ?? params.get('utm_id') ?? undefined,\n    utm_source_platform:\n      link?.utm_source_platform ?? params.get('utm_source_platform') ?? undefined,\n    utm_creative_format:\n      link?.utm_creative_format ?? params.get('utm_creative_format') ?? undefined,\n    utm_marketing_tactic:\n      link?.utm_marketing_tactic ?? params.get('utm_marketing_tactic') ?? undefined,\n  };\n\n  cache.tags = tags;\n  return tags;\n}\n\nconst map = new Map<string, string>();\n\nexport const storage: Storage = {\n  getItem: (key) => {\n    try {\n      return localStorage.getItem(key);\n    } catch {\n      console.error('localStorage is not available');\n      return map.get(key) ?? null;\n    }\n  },\n  setItem: (key, value) => {\n    try {\n      localStorage.setItem(key, value);\n    } catch {\n      console.error('localStorage is not available');\n      map.set(key, value);\n    }\n  },\n};\n"],"mappings":";;;;;;;;;;;AASA,SAAgB,cAAc;CAC5B,MAAM,SAASA,oBAAAA,OAAO,QAAQ,QAAQC,0BAAAA,KAAK,SAAS;CACpD,IAAI,QAAQ,OAAO;CAGnB,MAAM,KAAM,OAA2B,aAAa,OAAO,WAAW,KAAA,GAAIC,KAAAA,GAAAA,CAAO;CACjF,oBAAA,OAAO,QAAQ,QAAQD,0BAAAA,KAAK,WAAW,EAAE;CACzC,OAAO;AACT;AAEA,MAAM,wBAAQ,IAAI,IAAkC;;;;;;AAOpD,SAAS,cAAc,IAAY;CACjC,MAAM,SAAS,MAAM,IAAI,EAAE;CAC3B,IAAI,QAAQ,OAAO;CACnB,MAAM,OAAOE,mBAAAA,QAAQ,EAAE,CAAC,CAAC,MAAM,WAAW;EAIxC,IAAI,CAAC,QAAQ,MAAM,OAAO,EAAE;EAC5B,OAAO;CACT,CAAC;CACD,MAAM,IAAI,IAAI,IAAI;CAClB,OAAO;AACT;;AAGA,IAAI;AAEJ,eAAsB,UAAU;CAG9B,MAAM,gBAAgB,OAAO,SAAS;CACtC,MAAM,gBAAgB,SAAS,YAAY,KAAA;CAC3C,MAAM,aAAa,SAAS;CAE5B,WAAWC,WAAAA,QAAO,UAAU,OAAO,UAAU,SAAS;CACtD,MAAM,SAAS,IAAI,gBAAgB,OAAO,SAAS,MAAM;CACzD,MAAM,KAAK,OAAO,MAAM;CACxB,MAAM,UAAU,OAAO,WAAW;CAClC,MAAM,WAAW,OAAO,YAAY;CACpC,MAAM,UAAA,GAASC,OAAAA,YAAAA,CAAY,SAAS,MAAM;CAE1C,MAAM,SAAS,OAAO,IAAI,GAAG;CAC7B,MAAM,OAAO,SAAS,MAAM,cAAc,MAAM,IAAI;CAEpD,MAAM,OAAkB;EACtB,IAAI,GAAG,GAAG,KAAK,GAAG,GAAG;EACrB,SAAS,GAAG;EACZ,YAAY,GAAG;EACf,SAAS,GAAG,QAAQ,KAAK,GAAG,QAAQ;EACpC,cAAc,QAAQ;EACtB,iBAAiB,QAAQ;EACzB,QAAQ,SAAS;EACjB,WAAW,YAAY;EACvB,aAAa,SAAS;EACtB,eAAe,SAAS;EACxB,oBAAoB,OAAO;EAC3B,cAAc,OAAO,OAAO;EAC5B,eAAe,OAAO,OAAO;EAC7B,mBAAmB,GAAG,OAAO,OAAO,MAAM,GAAG,OAAO,OAAO;EAC3D,SAASL,oBAAAA,OAAO;EAChB,UAAU,UAAU;EACpB,WAAW,KAAK,eAAe,CAAC,CAAC,gBAAgB,CAAC,CAAC;EACnD;EACA;EACA;EAEA,KAAK,OAAO,QAAQ,KAAA;EACpB,KAAK,OAAO;EACZ,QAAQ,OAAO,IAAI,QAAQ,KAAK,KAAA;EAChC,OAAO,OAAO,IAAI,OAAO,KAAK,KAAA;EAC9B,SAAS,OAAO,IAAI,SAAS,KAAK,KAAA;EAClC,UAAU,OAAO,IAAI,UAAU,KAAK,KAAA;EACpC,YAAY,OAAO,IAAI,YAAY,KAAK,KAAA;EACxC,aAAa,OAAO,IAAI,aAAa,KAAK,KAAA;EAC1C,eAAe,OAAO,IAAI,eAAe,KAAK,KAAA;EAC9C,WAAW,OAAO,IAAI,WAAW,KAAK,KAAA;EACtC,kBAAkB,OAAO,IAAI,kBAAkB,KAAK,KAAA;EAIpD,OAAO,OAAO,IAAI,OAAO,KAAKM,uBAAAA,SAAS,OAAO,OAAO,CAAC,EAAE;EACxD,QAAQ,OAAO,IAAI,QAAQ,KAAK,KAAA;EAChC,YAAY,OAAO,IAAI,YAAY,KAAK,KAAA;EACxC,gBAAgB,OAAO,IAAI,gBAAgB,KAAK,KAAA;EAEhD,SAAS,OAAO,IAAI,SAAS,KAAK,OAAO,YAAY,KAAA;EACrD,UAAU,OAAO;EAEjB,WAAW,OAAO,IAAI,WAAW,KAAK,OAAO,aAAa,KAAA;EAE1D,OAAO,OAAO,IAAI,OAAO,KAAK,KAAA;EAC9B,aAAa,OAAO,IAAI,aAAa,KAAK,KAAA;EAI1C,SAAS,OAAO,IAAI,SAAS,KAAKC,uBAAAA,gBAAgB,OAAO,WAAW;EACpE,OAAO,OAAO,IAAI,OAAO,KAAK,KAAA;EAC9B,QAAQ,OAAO,IAAI,QAAQ,KAAK,KAAA;EAChC,QAAQ,OAAO,IAAI,QAAQ,KAAK,KAAA;EAChC,QAAQ,OAAO,IAAI,QAAQ,KAAKD,uBAAAA,SAAS,OAAO,OAAO,CAAC,EAAE;EAC1D,QAAQ,OAAO,IAAI,QAAQ,KAAK,KAAA;EAChC,OAAO,OAAO,IAAI,OAAO,KAAK,KAAA;EAE9B,YAAY,MAAM,cAAc,OAAO,IAAI,YAAY,KAAK,KAAA;EAC5D,YAAY,MAAM,cAAc,OAAO,IAAI,YAAY,KAAK,KAAA;EAC5D,cAAc,MAAM,gBAAgB,OAAO,IAAI,cAAc,KAAK,KAAA;EAClE,UAAU,MAAM,YAAY,OAAO,IAAI,UAAU,KAAK,KAAA;EACtD,aAAa,MAAM,eAAe,OAAO,IAAI,aAAa,KAAK,KAAA;EAC/D,QAAQ,MAAM,UAAU,OAAO,IAAI,QAAQ,KAAK,KAAA;EAChD,qBACE,MAAM,uBAAuB,OAAO,IAAI,qBAAqB,KAAK,KAAA;EACpE,qBACE,MAAM,uBAAuB,OAAO,IAAI,qBAAqB,KAAK,KAAA;EACpE,sBACE,MAAM,wBAAwB,OAAO,IAAI,sBAAsB,KAAK,KAAA;CACxE;CAEA,oBAAA,MAAM,OAAO;CACb,OAAO;AACT;AAEA,MAAM,sBAAM,IAAI,IAAoB;AAEpC,MAAa,UAAmB;CAC9B,UAAU,QAAQ;EAChB,IAAI;GACF,OAAO,aAAa,QAAQ,GAAG;EACjC,QAAQ;GACN,QAAQ,MAAM,+BAA+B;GAC7C,OAAO,IAAI,IAAI,GAAG,KAAK;EACzB;CACF;CACA,UAAU,KAAK,UAAU;EACvB,IAAI;GACF,aAAa,QAAQ,KAAK,KAAK;EACjC,QAAQ;GACN,QAAQ,MAAM,+BAA+B;GAC7C,IAAI,IAAI,KAAK,KAAK;EACpB;CACF;AACF"}

package/dist/web/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/web/index.ts"],"mappings":";;;iBASgB;iBAkCM,WAAO,QAAA;cA6FhB,SAAS"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/web/index.ts"],"mappings":";;;iBASgB;iBAkCM,WAAO,QAAA;cAgGhB,SAAS"}

package/dist/web/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/web/index.ts"],"mappings":";;;iBASgB;iBAkCM,WAAO,QAAA;cA6FhB,SAAS"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/web/index.ts"],"mappings":";;;iBASgB;iBAkCM,WAAO,QAAA;cAgGhB,SAAS"}

package/dist/web/index.mjs

@@ -2,7 +2,7 @@ import { __toESM } from "../_virtual/_rolldown/runtime.mjs";
 import { cache, config } from "../setup/index.mjs";
 import { keys } from "../constants/storage.mjs";
 import { getLink } from "../link/index.mjs";
-import { parseGcl } from "../click-id/index.mjs";
+import { parseGcl, parseUetMsclkid } from "../click-id/index.mjs";
 import { require_es5 } from "../node_modules/.pnpm/bowser@2.14.1/node_modules/bowser/es5.mjs";
 import { v4 } from "uuid";
 import { parseCookie } from "cookie";
@@ -86,7 +86,7 @@ async function getTags() {
 		li_fat_id: params.get("li_fat_id") ?? parsed.li_fat_id ?? void 0,
 		dclid: params.get("dclid") ?? void 0,
 		ko_click_id: params.get("ko_click_id") ?? void 0,
-		msclkid: params.get("msclkid") ?? void 0,
+		msclkid: params.get("msclkid") ?? parseUetMsclkid(parsed._uetmsclkid),
 		sccid: params.get("sccid") ?? void 0,
 		ttclid: params.get("ttclid") ?? void 0,
 		twclid: params.get("twclid") ?? void 0,

package/dist/web/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["uuidv4","Bowser"],"sources":["../../src/web/index.ts"],"sourcesContent":["import Bowser from 'bowser';\nimport { parseCookie } from 'cookie';\nimport { v4 as uuidv4 } from 'uuid';\nimport { parseGcl } from '../click-id/index';\nimport { keys } from '../constants/storage';\nimport { type Link, getLink } from '../link/index';\nimport { type Storage, cache, config } from '../setup/index';\nimport type { TrackTags } from '../track/types';\n\nexport function getDeviceId() {\n  const cached = config.storage.getItem(keys.device_id);\n  if (cached) return cached;\n  // lib.dom types `crypto.randomUUID` as always present, but it is missing in\n  // insecure contexts and older browsers, so probe it before use.\n  const id = (crypto as Partial<Crypto>).randomUUID ? crypto.randomUUID() : uuidv4();\n  config.storage.setItem(keys.device_id, id);\n  return id;\n}\n\nconst links = new Map<string, Promise<Link | null>>();\n\n/**\n * `getTags` runs once per event now, and the link a `?s=` id points at cannot change while the\n * page is open, so an uncached lookup would put an identical request on the wire for every\n * event the page sends.\n */\nfunction getCachedLink(id: string) {\n  const cached = links.get(id);\n  if (cached) return cached;\n  const link = getLink(id).then((result) => {\n    // A lookup that came back empty must not stick for the lifetime of the page. `getLink`\n    // answers null for a network failure as well as for a link that does not exist, and losing\n    // the link's utm params for every later event costs more than repeating a rare request.\n    if (!result) links.delete(id);\n    return result;\n  });\n  links.set(id, link);\n  return link;\n}\n\n/** The user agent cannot change while the page is open, so it is parsed once. */\nlet parser: ReturnType<typeof Bowser.getParser> | undefined;\n\nexport async function getTags() {\n  // Read the page before the first await: `getTags` runs when the event happens, and a single\n  // page app can navigate while the link lookup below is still in flight.\n  const page_location = window.location.href;\n  const page_referrer = document.referrer || undefined;\n  const page_title = document.title;\n\n  parser ??= Bowser.getParser(window.navigator.userAgent);\n  const params = new URLSearchParams(window.location.search);\n  const os = parser.getOS();\n  const browser = parser.getBrowser();\n  const platform = parser.getPlatform();\n  const parsed = parseCookie(document.cookie);\n\n  const linkId = params.get('s');\n  const link = linkId ? await getCachedLink(linkId) : null;\n\n  const tags: TrackTags = {\n    os: `${os.name} ${os.version}`,\n    os_name: os.name,\n    os_version: os.version,\n    browser: `${browser.name} ${browser.version}`,\n    browser_name: browser.name,\n    browser_version: browser.version,\n    device: platform.model,\n    device_id: getDeviceId(),\n    device_type: platform.type,\n    device_vendor: platform.vendor,\n    device_pixel_ratio: window.devicePixelRatio,\n    screen_width: window.screen.width,\n    screen_height: window.screen.height,\n    screen_resolution: `${window.screen.width}x${window.screen.height}`,\n    release: config.release,\n    language: navigator.language,\n    time_zone: Intl.DateTimeFormat().resolvedOptions().timeZone,\n    page_location,\n    page_referrer,\n    page_title,\n    // Meta Ads — _fbc is set server-side (see @shware/analytics/server resolveClickIdCookies)\n    fbc: parsed._fbc ?? undefined,\n    fbp: parsed._fbp,\n    fbclid: params.get('fbclid') ?? undefined,\n    ad_id: params.get('ad_id') ?? undefined,\n    ad_name: params.get('ad_name') ?? undefined,\n    adset_id: params.get('adset_id') ?? undefined,\n    adset_name: params.get('adset_name') ?? undefined,\n    campaign_id: params.get('campaign_id') ?? undefined,\n    campaign_name: params.get('campaign_name') ?? undefined,\n    placement: params.get('placement') ?? undefined,\n    site_source_name: params.get('site_source_name') ?? undefined,\n    // Google Ads — _gcl_aw/_gcl_gb are written by gtag and kept alive server-side (see\n    // @shware/analytics/server resolveClickIdCookies); the URL wins, the cookie carries the\n    // click id to every later page of the visit and to returning visits.\n    gclid: params.get('gclid') ?? parseGcl(parsed._gcl_aw)?.clickId,\n    gclsrc: params.get('gclsrc') ?? undefined,\n    gad_source: params.get('gad_source') ?? undefined,\n    gad_campaignid: params.get('gad_campaignid') ?? undefined,\n    // Reddit Ads — _rdt_cid is set server-side (see @shware/analytics/server resolveClickIdCookies)\n    rdt_cid: params.get('rdt_cid') ?? parsed._rdt_cid ?? undefined,\n    rdt_uuid: parsed._rdt_uuid,\n    // LinkedIn Ads: get click id from url params or first-party cookie\n    li_fat_id: params.get('li_fat_id') ?? parsed.li_fat_id ?? undefined,\n    // click ids\n    dclid: params.get('dclid') ?? undefined,\n    ko_click_id: params.get('ko_click_id') ?? undefined,\n    msclkid: params.get('msclkid') ?? undefined,\n    sccid: params.get('sccid') ?? undefined,\n    ttclid: params.get('ttclid') ?? undefined,\n    twclid: params.get('twclid') ?? undefined,\n    wbraid: params.get('wbraid') ?? parseGcl(parsed._gcl_gb)?.clickId,\n    gbraid: params.get('gbraid') ?? undefined,\n    yclid: params.get('yclid') ?? undefined,\n    // utm params\n    utm_source: link?.utm_source ?? params.get('utm_source') ?? undefined,\n    utm_medium: link?.utm_medium ?? params.get('utm_medium') ?? undefined,\n    utm_campaign: link?.utm_campaign ?? params.get('utm_campaign') ?? undefined,\n    utm_term: link?.utm_term ?? params.get('utm_term') ?? undefined,\n    utm_content: link?.utm_content ?? params.get('utm_content') ?? undefined,\n    utm_id: link?.utm_id ?? params.get('utm_id') ?? undefined,\n    utm_source_platform:\n      link?.utm_source_platform ?? params.get('utm_source_platform') ?? undefined,\n    utm_creative_format:\n      link?.utm_creative_format ?? params.get('utm_creative_format') ?? undefined,\n    utm_marketing_tactic:\n      link?.utm_marketing_tactic ?? params.get('utm_marketing_tactic') ?? undefined,\n  };\n\n  cache.tags = tags;\n  return tags;\n}\n\nconst map = new Map<string, string>();\n\nexport const storage: Storage = {\n  getItem: (key) => {\n    try {\n      return localStorage.getItem(key);\n    } catch {\n      console.error('localStorage is not available');\n      return map.get(key) ?? null;\n    }\n  },\n  setItem: (key, value) => {\n    try {\n      localStorage.setItem(key, value);\n    } catch {\n      console.error('localStorage is not available');\n      map.set(key, value);\n    }\n  },\n};\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["uuidv4","Bowser"],"sources":["../../src/web/index.ts"],"sourcesContent":["import Bowser from 'bowser';\nimport { parseCookie } from 'cookie';\nimport { v4 as uuidv4 } from 'uuid';\nimport { parseGcl, parseUetMsclkid } from '../click-id/index';\nimport { keys } from '../constants/storage';\nimport { type Link, getLink } from '../link/index';\nimport { type Storage, cache, config } from '../setup/index';\nimport type { TrackTags } from '../track/types';\n\nexport function getDeviceId() {\n  const cached = config.storage.getItem(keys.device_id);\n  if (cached) return cached;\n  // lib.dom types `crypto.randomUUID` as always present, but it is missing in\n  // insecure contexts and older browsers, so probe it before use.\n  const id = (crypto as Partial<Crypto>).randomUUID ? crypto.randomUUID() : uuidv4();\n  config.storage.setItem(keys.device_id, id);\n  return id;\n}\n\nconst links = new Map<string, Promise<Link | null>>();\n\n/**\n * `getTags` runs once per event now, and the link a `?s=` id points at cannot change while the\n * page is open, so an uncached lookup would put an identical request on the wire for every\n * event the page sends.\n */\nfunction getCachedLink(id: string) {\n  const cached = links.get(id);\n  if (cached) return cached;\n  const link = getLink(id).then((result) => {\n    // A lookup that came back empty must not stick for the lifetime of the page. `getLink`\n    // answers null for a network failure as well as for a link that does not exist, and losing\n    // the link's utm params for every later event costs more than repeating a rare request.\n    if (!result) links.delete(id);\n    return result;\n  });\n  links.set(id, link);\n  return link;\n}\n\n/** The user agent cannot change while the page is open, so it is parsed once. */\nlet parser: ReturnType<typeof Bowser.getParser> | undefined;\n\nexport async function getTags() {\n  // Read the page before the first await: `getTags` runs when the event happens, and a single\n  // page app can navigate while the link lookup below is still in flight.\n  const page_location = window.location.href;\n  const page_referrer = document.referrer || undefined;\n  const page_title = document.title;\n\n  parser ??= Bowser.getParser(window.navigator.userAgent);\n  const params = new URLSearchParams(window.location.search);\n  const os = parser.getOS();\n  const browser = parser.getBrowser();\n  const platform = parser.getPlatform();\n  const parsed = parseCookie(document.cookie);\n\n  const linkId = params.get('s');\n  const link = linkId ? await getCachedLink(linkId) : null;\n\n  const tags: TrackTags = {\n    os: `${os.name} ${os.version}`,\n    os_name: os.name,\n    os_version: os.version,\n    browser: `${browser.name} ${browser.version}`,\n    browser_name: browser.name,\n    browser_version: browser.version,\n    device: platform.model,\n    device_id: getDeviceId(),\n    device_type: platform.type,\n    device_vendor: platform.vendor,\n    device_pixel_ratio: window.devicePixelRatio,\n    screen_width: window.screen.width,\n    screen_height: window.screen.height,\n    screen_resolution: `${window.screen.width}x${window.screen.height}`,\n    release: config.release,\n    language: navigator.language,\n    time_zone: Intl.DateTimeFormat().resolvedOptions().timeZone,\n    page_location,\n    page_referrer,\n    page_title,\n    // Meta Ads — _fbc is set server-side (see @shware/analytics/server resolveClickIdCookies)\n    fbc: parsed._fbc ?? undefined,\n    fbp: parsed._fbp,\n    fbclid: params.get('fbclid') ?? undefined,\n    ad_id: params.get('ad_id') ?? undefined,\n    ad_name: params.get('ad_name') ?? undefined,\n    adset_id: params.get('adset_id') ?? undefined,\n    adset_name: params.get('adset_name') ?? undefined,\n    campaign_id: params.get('campaign_id') ?? undefined,\n    campaign_name: params.get('campaign_name') ?? undefined,\n    placement: params.get('placement') ?? undefined,\n    site_source_name: params.get('site_source_name') ?? undefined,\n    // Google Ads — _gcl_aw/_gcl_gb are written by gtag and kept alive server-side (see\n    // @shware/analytics/server resolveClickIdCookies); the URL wins, the cookie carries the\n    // click id to every later page of the visit and to returning visits.\n    gclid: params.get('gclid') ?? parseGcl(parsed._gcl_aw)?.clickId,\n    gclsrc: params.get('gclsrc') ?? undefined,\n    gad_source: params.get('gad_source') ?? undefined,\n    gad_campaignid: params.get('gad_campaignid') ?? undefined,\n    // Reddit Ads — _rdt_cid is set server-side (see @shware/analytics/server resolveClickIdCookies)\n    rdt_cid: params.get('rdt_cid') ?? parsed._rdt_cid ?? undefined,\n    rdt_uuid: parsed._rdt_uuid,\n    // LinkedIn Ads: get click id from url params or first-party cookie\n    li_fat_id: params.get('li_fat_id') ?? parsed.li_fat_id ?? undefined,\n    // click ids\n    dclid: params.get('dclid') ?? undefined,\n    ko_click_id: params.get('ko_click_id') ?? undefined,\n    // Microsoft Ads — _uetmsclkid is written by the UET tag and kept alive server-side (see\n    // @shware/analytics/server resolveClickIdCookies); the URL wins, the cookie carries the\n    // click id to every later page of the visit and to returning visits.\n    msclkid: params.get('msclkid') ?? parseUetMsclkid(parsed._uetmsclkid),\n    sccid: params.get('sccid') ?? undefined,\n    ttclid: params.get('ttclid') ?? undefined,\n    twclid: params.get('twclid') ?? undefined,\n    wbraid: params.get('wbraid') ?? parseGcl(parsed._gcl_gb)?.clickId,\n    gbraid: params.get('gbraid') ?? undefined,\n    yclid: params.get('yclid') ?? undefined,\n    // utm params\n    utm_source: link?.utm_source ?? params.get('utm_source') ?? undefined,\n    utm_medium: link?.utm_medium ?? params.get('utm_medium') ?? undefined,\n    utm_campaign: link?.utm_campaign ?? params.get('utm_campaign') ?? undefined,\n    utm_term: link?.utm_term ?? params.get('utm_term') ?? undefined,\n    utm_content: link?.utm_content ?? params.get('utm_content') ?? undefined,\n    utm_id: link?.utm_id ?? params.get('utm_id') ?? undefined,\n    utm_source_platform:\n      link?.utm_source_platform ?? params.get('utm_source_platform') ?? undefined,\n    utm_creative_format:\n      link?.utm_creative_format ?? params.get('utm_creative_format') ?? undefined,\n    utm_marketing_tactic:\n      link?.utm_marketing_tactic ?? params.get('utm_marketing_tactic') ?? undefined,\n  };\n\n  cache.tags = tags;\n  return tags;\n}\n\nconst map = new Map<string, string>();\n\nexport const storage: Storage = {\n  getItem: (key) => {\n    try {\n      return localStorage.getItem(key);\n    } catch {\n      console.error('localStorage is not available');\n      return map.get(key) ?? null;\n    }\n  },\n  setItem: (key, value) => {\n    try {\n      localStorage.setItem(key, value);\n    } catch {\n      console.error('localStorage is not available');\n      map.set(key, value);\n    }\n  },\n};\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shware/analytics",
-  "version": "8.2.0",
+  "version": "8.3.0",
   "private": false,
   "repository": {
     "type": "git",