@blotoutio/providers-snapchat-sdk 1.68.2 → 1.69.1

package/index.mjs

@@ -34,7 +34,725 @@ const STANDARD_SNAPCHAT_EVENTS = new Set([
     'CUSTOM_EVENT_5',
 ]);
 
-// eslint-disable-next-line @nx/enforce-module-boundaries
+const keyPrefix = `_worker`;
+
+const getProductIdFromMapping = (item, productIdMapping) => {
+    if (productIdMapping === '1' && item['variantId']) {
+        return item['variantId'];
+    }
+    if (productIdMapping === '2' && item['sku']) {
+        return item['sku'];
+    }
+    return item['id'];
+};
+
+const initKey = `${keyPrefix}StoreMultiple`;
+const getData = (destination, persistType, key = initKey) => {
+    let data;
+    if (persistType === 'session') {
+        data = getSession(key);
+    }
+    else {
+        data = getLocal(key);
+    }
+    return (data === null || data === void 0 ? void 0 : data[destination]) || {};
+};
+const getLocal = (key) => {
+    try {
+        if (!localStorage) {
+            return {};
+        }
+        const data = localStorage.getItem(key);
+        if (!data) {
+            return {};
+        }
+        return JSON.parse(data) || {};
+    }
+    catch {
+        return {};
+    }
+};
+const getSession = (key) => {
+    try {
+        if (!sessionStorage) {
+            return {};
+        }
+        const data = sessionStorage.getItem(key);
+        if (!data) {
+            return {};
+        }
+        return JSON.parse(data) || {};
+    }
+    catch {
+        return {};
+    }
+};
+
+/**
+ * Known ad-network click ID query parameters and the human-readable provider
+ * label each one maps to. Used by the CDN worker to resolve `inSessionTouch`
+ * and by the analytics API to classify paid-media touch sessions.
+ *
+ * Keep this list in sync with `defaultParams` in queryParams.ts when new
+ * click ID providers are added.
+ */
+const CLICK_IDS = [
+    { param: 'fbclid', label: 'Facebook' }, // Facebook Ads
+    { param: 'gclid', label: 'Google' }, // Google Ads (click)
+    { param: 'gbraid', label: 'Google' }, // Google Ads (iOS app)
+    { param: 'wbraid', label: 'Google' }, // Google Ads (iOS web)
+    { param: 'msclkid', label: 'Bing' }, // Microsoft Bing Ads
+    { param: 'ttclid', label: 'TikTok' }, // TikTok Ads
+    { param: 'ScCid', label: 'Snapchat' }, // Snapchat Ads
+    { param: 'epik', label: 'Pinterest' }, // Pinterest Ads
+    { param: 'li_fat_id', label: 'LinkedIn' }, // LinkedIn Ads
+    { param: 'twclid', label: 'Twitter' }, // X (Twitter) Ads
+    { param: 'rdt_cid', label: 'Reddit' }, // Reddit Ads
+    { param: 'aleid', label: 'AppLovin' }, // AppLovin
+    { param: 'tabclid', label: 'Taboola' }, // Taboola
+    { param: 'obclid', label: 'Outbrain' }, // Outbrain
+    { param: 'trybe', label: 'Trybe' }, // Trybe
+    { param: '_kx', label: 'Klaviyo' }, // Klaviyo email campaigns
+    { param: 'mc_eid', label: 'Mailchimp' }, // Mailchimp email campaigns
+    { param: 'ttd_id', label: 'The Trade Desk' }, // The Trade Desk programmatic
+    { param: 'evsclid', label: 'EvoSearch' }, // EvoSearch
+    { param: 'li_did', label: 'Live Intent' }, // LiveIntent device-level ad
+    { param: '_raclid', label: 'Rumble' }, // Rumble Ads
+    { param: 'ref_id', label: 'StackAdapt' }, // StackAdapt programmatic
+    { param: 'duel_a', label: 'Duel' }, // Duel referral/advocacy
+];
+
+const expand = (str) => str.split(',').flatMap((entry) => {
+    if (!entry.includes('-')) {
+        return entry;
+    }
+    const result = [];
+    const [start, end] = entry.split('-').map(Number);
+    for (let i = start; i <= end; i++) {
+        result.push(i.toString());
+    }
+    return result;
+});
+/**
+ * Exported from https://en.wikipedia.org/wiki/List_of_North_American_Numbering_Plan_area_codes
+ *
+ * In Dev Tools, select the `tbody` element containing the area codes and run the following code,
+ * replacing the emdash character with a simple endash:
+ *
+ * ```ts
+ * [...$0.querySelectorAll('td:first-child')]
+ *   .filter(cell => cell.firstChild.nodeName != 'A')
+ *   .map(cell => cell.textContent.trim()).join(',')
+ * ```
+ */
+const invalidNANPAreaCodes = new Set([
+    ...expand('200,211,221,222,230,232,233,235,237-238,241,243,244,245,247,255,257,258-259,261,265,266,271,273,274,275,277,278,280,282,283,285-287,288,290-299'),
+    ...expand('300,311,322,324,327,328,333,335,338,342,344,348-349,353,355,356,357-359,362,366,369,370-379,381,382,383-384,387,388,389,390-399'),
+    ...expand('400,411,420,421-422,426-427,428,429,433,439,444,446,449,451-454,455,456,457,459,460,461-462,465,466,467,471,476,477,481-483,485-486,487,488,489,490-499'),
+    ...expand('511,532,535,536,537,538,542-543,545-547,549-550,552-554,555,556,558,560,565,568,569,576,578,583,589,590-599'),
+    ...expand('611,621,624,625,627,632,633,634-635,637-638,642-643,644,648,652-654,655,663,665,666,668,673-676,677,679,685,686,687,688,690-699'),
+    ...expand('711,722,723,729,733,735-736,739,741,744,745-746,748,749-751,752,755,756,759,761,764,766,768,776,777,783,788,789,790-799'),
+    ...expand('811,821,822,823-824,827,834,836,841-842,846,851,852-853,871,874-875,879,880-887,889,890-899'),
+    ...expand('911,921,922,923,924,926,927,932,933,935,942,944,946,950,953,955,957-958,960-969,974,975,976,977,981-982,987,988,990-999'),
+]);
+const isValidZone1AreaCode = (num) => {
+    if (!/^[2-9]\d{2}$/.test(num)) {
+        return false;
+    }
+    return !invalidNANPAreaCodes.has(num);
+};
+
+// North America; assume local numbers as NANP
+const ZONE_1 = /^[+]1([2-9][0-8][0-9])[2-9][0-9]{6}$/;
+// Africa
+const ZONE_2 = /^[+]2([07][0-9]{4,13}|(1[12368]|[234][0-9]|5[0-8]|6[0-9]|9[01789])[0-9]{4,12})$/;
+// Europe
+const EU_TWO_DIGIT = `(3[0-469]|4[013-9])[0-9]{4,15}`;
+const EU_THREE_DIGIT = `((3[578]|42)[0-9])[0-9]{4,12}`;
+const ZONE_3_4 = new RegExp(`^[+](${EU_TWO_DIGIT}|${EU_THREE_DIGIT})$`);
+// South America
+const ZONE_5 = /^[+]5([1-8][0-9]{4,13}|[09][0-9][0-9]{4,12})$/;
+// Southeast Asia & Oceania
+const ZONE_6 = /^[+]6([0-6][0-9]{4,13}|(7[02-9]|8[0-35-9]|9[0-2])[0-9]{4,12})$/;
+// Russia & Kazakhstan
+const ZONE_7 = /^[+]7([1-9])[0-9]{4,13}$/;
+// East & South Asia
+const ZONE_8 = /^[+]8([1246][0-9]{4,13}|(0[08]|5[02356]|70|8[0-36])[0-9]{4,12})$/;
+// Middle East, West & Central Asia, South Asia, Eastern Europe
+const ZONE_9 = /^[+]9([0123458][0-9]{4,13}|(6[0-8]|7[0-79]|9[2-8])[0-9]{4,12})$/;
+const checkers = [
+    (num) => {
+        const match = num.match(ZONE_1);
+        if (!match) {
+            return false;
+        }
+        return isValidZone1AreaCode(match[1]);
+    },
+    (num) => ZONE_2.test(num),
+    (num) => ZONE_3_4.test(num),
+    (num) => ZONE_5.test(num),
+    (num) => ZONE_6.test(num),
+    (num) => ZONE_7.test(num),
+    (num) => ZONE_8.test(num),
+    (num) => ZONE_9.test(num),
+];
+/**
+ * Returns a boolean indicating whether or not a phone number conforms to a
+ * plausible E.164 phone number. It does not guarantee validity as each national
+ * operator may have various phone number lengths per area code or national
+ * scheme. It only validates currently active country codes and length
+ * restrictions.
+ *
+ * > *NOTE:* `E.164` format requires a leading plus sign, so you must set
+ * > `keepPlus` to `true` when normalising numbers:
+ *
+ * @example
+ * ```ts
+ * const number = isPlausibleE164Number(normalizePhoneNumber(str, true))
+ * ```
+ */
+const isPlausibleE164Number = (str) => str.startsWith('+') && checkers.some((check) => check(str));
+const INTL_PREFIX = /^00|[+]+/;
+/**
+ * Attempts to convert a given phone number string into an E.164 formatted
+ * number. In order to check whether the number is plausibly a real number, it
+ * must be checked with `isPlausibleE164Number` after normalising.
+ */
+const normalizePhoneNumber = (str, keepPlus = false) => {
+    if (!str) {
+        return '';
+    }
+    let normalized = str;
+    // assume non-international numbers are US numbers
+    if (!INTL_PREFIX.test(normalized)) {
+        normalized = `+1${normalized}`;
+    }
+    normalized = normalized.replace(/[^+0-9]/g, '').replace(INTL_PREFIX, '+');
+    return keepPlus ? normalized : normalized.slice(1);
+};
+
+/**
+ * ISO-3166 2-leter country codes and their names
+ * @see https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
+ */
+const isoCountries = new Map([
+    ['AD', 'Andorra'],
+    ['AE', 'United Arab Emirates'],
+    ['AF', 'Afghanistan'],
+    ['AG', 'Antigua and Barbuda'],
+    ['AI', 'Anguilla'],
+    ['AL', 'Albania'],
+    ['AM', 'Armenia'],
+    ['AO', 'Angola'],
+    ['AQ', 'Antarctica'],
+    ['AR', 'Argentina'],
+    ['AS', 'American Samoa'],
+    ['AT', 'Austria'],
+    ['AU', 'Australia'],
+    ['AW', 'Aruba'],
+    ['AX', 'Åland Islands'],
+    ['AZ', 'Azerbaijan'],
+    ['BA', 'Bosnia and Herzegovina'],
+    ['BB', 'Barbados'],
+    ['BD', 'Bangladesh'],
+    ['BE', 'Belgium'],
+    ['BF', 'Burkina Faso'],
+    ['BG', 'Bulgaria'],
+    ['BH', 'Bahrain'],
+    ['BI', 'Burundi'],
+    ['BJ', 'Benin'],
+    ['BL', 'Saint Barthélemy'],
+    ['BM', 'Bermuda'],
+    ['BN', 'Brunei Darussalam'],
+    ['BO', 'Bolivia, Plurinational State of'],
+    ['BQ', 'Bonaire, Sint Eustatius and Saba'],
+    ['BR', 'Brazil'],
+    ['BS', 'Bahamas'],
+    ['BT', 'Bhutan'],
+    ['BV', 'Bouvet Island'],
+    ['BW', 'Botswana'],
+    ['BY', 'Belarus'],
+    ['BZ', 'Belize'],
+    ['CA', 'Canada'],
+    ['CC', 'Cocos (Keeling) Islands'],
+    ['CD', 'Congo, Democratic Republic of the'],
+    ['CF', 'Central African Republic'],
+    ['CG', 'Congo'],
+    ['CH', 'Switzerland'],
+    ['CI', "Côte d'Ivoire"],
+    ['CK', 'Cook Islands'],
+    ['CL', 'Chile'],
+    ['CM', 'Cameroon'],
+    ['CN', 'China'],
+    ['CO', 'Colombia'],
+    ['CR', 'Costa Rica'],
+    ['CU', 'Cuba'],
+    ['CV', 'Cabo Verde'],
+    ['CW', 'Curaçao'],
+    ['CX', 'Christmas Island'],
+    ['CY', 'Cyprus'],
+    ['CZ', 'Czechia'],
+    ['DE', 'Germany'],
+    ['DJ', 'Djibouti'],
+    ['DK', 'Denmark'],
+    ['DM', 'Dominica'],
+    ['DO', 'Dominican Republic'],
+    ['DZ', 'Algeria'],
+    ['EC', 'Ecuador'],
+    ['EE', 'Estonia'],
+    ['EG', 'Egypt'],
+    ['EH', 'Western Sahara'],
+    ['ER', 'Eritrea'],
+    ['ES', 'Spain'],
+    ['ET', 'Ethiopia'],
+    ['EU', 'European Union'],
+    ['FI', 'Finland'],
+    ['FJ', 'Fiji'],
+    ['FK', 'Falkland Islands (Malvinas)'],
+    ['FM', 'Micronesia, Federated States of'],
+    ['FO', 'Faroe Islands'],
+    ['FR', 'France'],
+    ['GA', 'Gabon'],
+    ['GB', 'Great Britain'],
+    ['GD', 'Grenada'],
+    ['GE', 'Georgia'],
+    ['GF', 'French Guiana'],
+    ['GG', 'Guernsey'],
+    ['GH', 'Ghana'],
+    ['GI', 'Gibraltar'],
+    ['GL', 'Greenland'],
+    ['GM', 'Gambia'],
+    ['GN', 'Guinea'],
+    ['GP', 'Guadeloupe'],
+    ['GQ', 'Equatorial Guinea'],
+    ['GR', 'Greece'],
+    ['GS', 'South Georgia and the South Sandwich Islands'],
+    ['GT', 'Guatemala'],
+    ['GU', 'Guam'],
+    ['GW', 'Guinea-Bissau'],
+    ['GY', 'Guyana'],
+    ['HK', 'Hong Kong'],
+    ['HM', 'Heard Island and McDonald Islands'],
+    ['HN', 'Honduras'],
+    ['HR', 'Croatia'],
+    ['HT', 'Haiti'],
+    ['HU', 'Hungary'],
+    ['ID', 'Indonesia'],
+    ['IE', 'Ireland'],
+    ['IL', 'Israel'],
+    ['IM', 'Isle of Man'],
+    ['IN', 'India'],
+    ['IO', 'British Indian Ocean Territory'],
+    ['IQ', 'Iraq'],
+    ['IR', 'Iran, Islamic Republic of'],
+    ['IS', 'Iceland'],
+    ['IT', 'Italy'],
+    ['JE', 'Jersey'],
+    ['JM', 'Jamaica'],
+    ['JO', 'Jordan'],
+    ['JP', 'Japan'],
+    ['KE', 'Kenya'],
+    ['KG', 'Kyrgyzstan'],
+    ['KH', 'Cambodia'],
+    ['KI', 'Kiribati'],
+    ['KM', 'Comoros'],
+    ['KN', 'Saint Kitts and Nevis'],
+    ['KP', "Korea, Democratic People's Republic of"],
+    ['KR', 'Korea, Republic of'],
+    ['KW', 'Kuwait'],
+    ['KY', 'Cayman Islands'],
+    ['KZ', 'Kazakhstan'],
+    ['LA', "Lao People's Democratic Republic"],
+    ['LB', 'Lebanon'],
+    ['LC', 'Saint Lucia'],
+    ['LI', 'Liechtenstein'],
+    ['LK', 'Sri Lanka'],
+    ['LR', 'Liberia'],
+    ['LS', 'Lesotho'],
+    ['LT', 'Lithuania'],
+    ['LU', 'Luxembourg'],
+    ['LV', 'Latvia'],
+    ['LY', 'Libya'],
+    ['MA', 'Morocco'],
+    ['MC', 'Monaco'],
+    ['MD', 'Moldova, Republic of'],
+    ['ME', 'Montenegro'],
+    ['MF', 'Saint Martin (French part)'],
+    ['MG', 'Madagascar'],
+    ['MH', 'Marshall Islands'],
+    ['MK', 'North Macedonia'],
+    ['ML', 'Mali'],
+    ['MM', 'Myanmar'],
+    ['MN', 'Mongolia'],
+    ['MO', 'Macao'],
+    ['MP', 'Northern Mariana Islands'],
+    ['MQ', 'Martinique'],
+    ['MR', 'Mauritania'],
+    ['MS', 'Montserrat'],
+    ['MT', 'Malta'],
+    ['MU', 'Mauritius'],
+    ['MV', 'Maldives'],
+    ['MW', 'Malawi'],
+    ['MX', 'Mexico'],
+    ['MY', 'Malaysia'],
+    ['MZ', 'Mozambique'],
+    ['NA', 'Namibia'],
+    ['NC', 'New Caledonia'],
+    ['NE', 'Niger'],
+    ['NF', 'Norfolk Island'],
+    ['NG', 'Nigeria'],
+    ['NI', 'Nicaragua'],
+    ['NL', 'Netherlands, Kingdom of the'],
+    ['NO', 'Norway'],
+    ['NP', 'Nepal'],
+    ['NR', 'Nauru'],
+    ['NU', 'Niue'],
+    ['NZ', 'New Zealand'],
+    ['OM', 'Oman'],
+    ['PA', 'Panama'],
+    ['PE', 'Peru'],
+    ['PF', 'French Polynesia'],
+    ['PG', 'Papua New Guinea'],
+    ['PH', 'Philippines'],
+    ['PK', 'Pakistan'],
+    ['PL', 'Poland'],
+    ['PM', 'Saint Pierre and Miquelon'],
+    ['PN', 'Pitcairn'],
+    ['PR', 'Puerto Rico'],
+    ['PS', 'Palestine, State of'],
+    ['PT', 'Portugal'],
+    ['PW', 'Palau'],
+    ['PY', 'Paraguay'],
+    ['QA', 'Qatar'],
+    ['RE', 'Réunion'],
+    ['RO', 'Romania'],
+    ['RS', 'Serbia'],
+    ['RU', 'Russian Federation'],
+    ['RW', 'Rwanda'],
+    ['SA', 'Saudi Arabia'],
+    ['SB', 'Solomon Islands'],
+    ['SC', 'Seychelles'],
+    ['SD', 'Sudan'],
+    ['SE', 'Sweden'],
+    ['SG', 'Singapore'],
+    ['SH', 'Saint Helena, Ascension and Tristan da Cunha'],
+    ['SI', 'Slovenia'],
+    ['SJ', 'Svalbard and Jan Mayen'],
+    ['SK', 'Slovakia'],
+    ['SL', 'Sierra Leone'],
+    ['SM', 'San Marino'],
+    ['SN', 'Senegal'],
+    ['SO', 'Somalia'],
+    ['SR', 'Suriname'],
+    ['SS', 'South Sudan'],
+    ['ST', 'Sao Tome and Principe'],
+    ['SV', 'El Salvador'],
+    ['SX', 'Sint Maarten (Dutch part)'],
+    ['SY', 'Syrian Arab Republic'],
+    ['SZ', 'Eswatini'],
+    ['TC', 'Turks and Caicos Islands'],
+    ['TD', 'Chad'],
+    ['TF', 'French Southern Territories'],
+    ['TG', 'Togo'],
+    ['TH', 'Thailand'],
+    ['TJ', 'Tajikistan'],
+    ['TK', 'Tokelau'],
+    ['TL', 'Timor-Leste'],
+    ['TM', 'Turkmenistan'],
+    ['TN', 'Tunisia'],
+    ['TO', 'Tonga'],
+    ['TR', 'Türkiye'],
+    ['TT', 'Trinidad and Tobago'],
+    ['TV', 'Tuvalu'],
+    ['TW', 'Taiwan, Province of China'],
+    ['TZ', 'Tanzania, United Republic of'],
+    ['UA', 'Ukraine'],
+    ['UG', 'Uganda'],
+    ['UK', 'United Kingdom of Great Britain and Northern Ireland'],
+    ['UM', 'United States Minor Outlying Islands'],
+    ['US', 'United States of America'],
+    ['UY', 'Uruguay'],
+    ['UZ', 'Uzbekistan'],
+    ['VA', 'Holy See'],
+    ['VC', 'Saint Vincent and the Grenadines'],
+    ['VE', 'Venezuela, Bolivarian Republic of'],
+    ['VG', 'Virgin Islands (British)'],
+    ['VI', 'Virgin Islands (U.S.)'],
+    ['VN', 'Viet Nam'],
+    ['VU', 'Vanuatu'],
+    ['WF', 'Wallis and Futuna'],
+    ['WS', 'Samoa'],
+    ['YE', 'Yemen'],
+    ['YT', 'Mayotte'],
+    ['ZA', 'South Africa'],
+    ['ZM', 'Zambia'],
+    ['ZW', 'Zimbabwe'],
+]);
+/**
+ * ISO-3166 US state ISO codes
+ * @see https://en.wikipedia.org/wiki/ISO_3166-2:US
+ * */
+const usStates = new Map([
+    ['US-AL', 'Alabama'],
+    ['US-AK', 'Alaska'],
+    ['US-AZ', 'Arizona'],
+    ['US-AR', 'Arkansas'],
+    ['US-CA', 'California'],
+    ['US-CO', 'Colorado'],
+    ['US-CT', 'Connecticut'],
+    ['US-DE', 'Delaware'],
+    ['US-FL', 'Florida'],
+    ['US-GA', 'Georgia'],
+    ['US-HI', 'Hawaii'],
+    ['US-ID', 'Idaho'],
+    ['US-IL', 'Illinois'],
+    ['US-IN', 'Indiana'],
+    ['US-IA', 'Iowa'],
+    ['US-KS', 'Kansas'],
+    ['US-KY', 'Kentucky'],
+    ['US-LA', 'Louisiana'],
+    ['US-ME', 'Maine'],
+    ['US-MD', 'Maryland'],
+    ['US-MA', 'Massachusetts'],
+    ['US-MI', 'Michigan'],
+    ['US-MN', 'Minnesota'],
+    ['US-MS', 'Mississippi'],
+    ['US-MO', 'Missouri'],
+    ['US-MT', 'Montana'],
+    ['US-NE', 'Nebraska'],
+    ['US-NV', 'Nevada'],
+    ['US-NH', 'New Hampshire'],
+    ['US-NJ', 'New Jersey'],
+    ['US-NM', 'New Mexico'],
+    ['US-NY', 'New York'],
+    ['US-NC', 'North Carolina'],
+    ['US-ND', 'North Dakota'],
+    ['US-OH', 'Ohio'],
+    ['US-OK', 'Oklahoma'],
+    ['US-OR', 'Oregon'],
+    ['US-PA', 'Pennsylvania'],
+    ['US-RI', 'Rhode Island'],
+    ['US-SC', 'South Carolina'],
+    ['US-SD', 'South Dakota'],
+    ['US-TN', 'Tennessee'],
+    ['US-TX', 'Texas'],
+    ['US-UT', 'Utah'],
+    ['US-VT', 'Vermont'],
+    ['US-VA', 'Virginia'],
+    ['US-WA', 'Washington'],
+    ['US-WV', 'West Virginia'],
+    ['US-WI', 'Wisconsin'],
+    ['US-WY', 'Wyoming'],
+    ['US-DC', 'District of Columbia'],
+    ['US-AS', 'American Samoa'],
+    ['US-GU', 'Guam'],
+    ['US-MP', 'Northern Mariana Islands'],
+    ['US-PR', 'Puerto Rico'],
+    ['US-UM', 'United States Minor Outlying Islands'],
+    ['US-VI', 'Virgin Islands, U.S.'],
+]);
+/**
+ * ISO 3166-2:CA province and territory codes, keyed `CA-XX` to mirror
+ * `usStates`. Used by the consent banner's Canada region to offer province
+ * selection (Québec is treated specially by the regional consent config).
+ */
+const caProvinces = new Map([
+    ['CA-AB', 'Alberta'],
+    ['CA-BC', 'British Columbia'],
+    ['CA-MB', 'Manitoba'],
+    ['CA-NB', 'New Brunswick'],
+    ['CA-NL', 'Newfoundland and Labrador'],
+    ['CA-NS', 'Nova Scotia'],
+    ['CA-NT', 'Northwest Territories'],
+    ['CA-NU', 'Nunavut'],
+    ['CA-ON', 'Ontario'],
+    ['CA-PE', 'Prince Edward Island'],
+    ['CA-QC', 'Quebec'],
+    ['CA-SK', 'Saskatchewan'],
+    ['CA-YT', 'Yukon'],
+]);
+new Set([
+    ...isoCountries.keys(),
+    ...usStates.keys(),
+    ...caProvinces.keys(),
+]);
+
+/**
+ * Exact utm_source normalization (lowercase key → canonical name).
+ *
+ * Use exact match when the key is short, generic, or must not accidentally
+ * absorb variant spellings (e.g. "impact" must not match "impact_radius").
+ *
+ * Ordering: Paid (search/social → ad networks → affiliates) →
+ *           Organic (AI/discovery) → Retention (email → SMS → push → post-purchase)
+ */
+const UTM_SOURCE_EXACT = {
+    // ── Paid – Search & Social ────────────────────────────────────────────────
+    google: 'Google',
+    adwords: 'Google',
+    youtube: 'Google',
+    yt: 'Google',
+    meta: 'Facebook',
+    facebook: 'Facebook',
+    instagram: 'Facebook',
+    ig: 'Facebook',
+    igshopping: 'Facebook',
+    threads: 'Facebook',
+    twitter: 'Twitter',
+    snapchat: 'Snapchat',
+    pinterest: 'Pinterest',
+    bing: 'Bing',
+    microsoft: 'Bing',
+    tiktok: 'TikTok',
+    // ── Paid – Ad Networks ───────────────────────────────────────────────────
+    rtbhouse: 'RTB House',
+    applovin: 'AppLovin',
+    ttd: 'The Trade Desk',
+    amazondsp: 'Amazon DSP',
+    axon: 'Axon',
+    duel: 'Duel',
+    // ── Paid – Affiliates ────────────────────────────────────────────────────
+    awin: 'Awin',
+    'affiliate-cj': 'CJ Affiliate',
+    impact: 'Impact',
+    rakuten: 'Rakuten',
+    superfiliate: 'Superfiliate',
+    // ── Organic – AI & Discovery ─────────────────────────────────────────────
+    perplexity: 'Perplexity',
+    chatgpt: 'ChatGPT',
+    'chatgpt.com': 'ChatGPT',
+    openai: 'ChatGPT',
+    'copilot.com': 'Microsoft Copilot',
+    copilot: 'Microsoft Copilot',
+    applenews: 'Apple News',
+    whatsapp: 'WhatsApp',
+    podcast: 'Podcast',
+    // ── Retention – Email ────────────────────────────────────────────────────
+    mailchimp: 'Mailchimp',
+    omnisend: 'Omnisend',
+    iterable: 'Iterable',
+    listrak: 'Listrak',
+    sailthru: 'Sailthru',
+    // ── Retention – Push ─────────────────────────────────────────────────────
+    pushowl: 'PushOwl',
+    // ── Retention – Post-purchase / Payment ──────────────────────────────────
+    narvar: 'Narvar',
+    shop_app: 'Shop App',
+    salesforce: 'Salesforce',
+    yotpo: 'Yotpo',
+};
+/**
+ * Partial utm_source normalization (startsWith prefix check, lowercase).
+ *
+ * Checked after exact match so short exact keys (e.g. "ig", "yt") win first.
+ */
+const UTM_SOURCE_PARTIAL = [
+    // ── Paid – Social ─────────────────────────────────────────────────────────
+    { prefix: 'tiktok', name: 'TikTok' },
+    // ── Paid – Ad Networks ───────────────────────────────────────────────────
+    { prefix: 'criteo', name: 'Criteo' },
+    // ── Retention – Email ────────────────────────────────────────────────────
+    { prefix: 'klaviyo', name: 'Klaviyo' },
+    // ── Retention – SMS ──────────────────────────────────────────────────────
+    { prefix: 'attentive', name: 'Attentive' },
+    { prefix: 'postscript', name: 'Postscript' },
+    // ── Retention – Post-purchase / Payment ──────────────────────────────────
+    { prefix: 'afterpay', name: 'Afterpay' },
+    { prefix: 'klarna', name: 'Klarna' },
+];
+const ORGANIC_SEARCH_ENGINES = [
+    { match: 'google', name: 'Google' },
+    { match: 'bing', name: 'Bing' },
+    { match: 'yahoo', name: 'Yahoo' },
+    { match: 'duckduckgo', name: 'DuckDuckGo' },
+    { match: 'baidu', name: 'Baidu' },
+    { match: 'yandex', name: 'Yandex' },
+    { match: 'brave', name: 'Brave' },
+];
+const KNOWN_REFERRAL_PLATFORMS = [
+    { match: 'facebook', name: 'Facebook' },
+    { match: 'instagram', name: 'Facebook' },
+    { match: 'twitter', name: 'Twitter' },
+    { match: 'x.com', name: 'Twitter' },
+    { match: 'tiktok', name: 'TikTok' },
+    { match: 'pinterest', name: 'Pinterest' },
+    { match: 'linkedin', name: 'LinkedIn' },
+    { match: 'youtube', name: 'YouTube' },
+    { match: 'chatgpt', name: 'ChatGPT' },
+    { match: 'claude', name: 'Claude' },
+    { match: 'perplexity', name: 'Perplexity' },
+    { match: 'shop.app', name: 'Shop App' },
+    { match: 'amazon', name: 'Amazon' },
+    { match: 'attentive', name: 'Attentive' },
+];
+const OFFLINE_TOUCH = 'Blotout_Offline';
+new Set([
+    ...CLICK_IDS.map((c) => c.label),
+    ...Object.values(UTM_SOURCE_EXACT),
+    ...UTM_SOURCE_PARTIAL.map((e) => e.name),
+    ...ORGANIC_SEARCH_ENGINES.map((e) => `Organic Search - ${e.name}`),
+    ...KNOWN_REFERRAL_PLATFORMS.map((e) => `Referral - ${e.name}`),
+    'Referral - Other',
+    'Direct Traffic',
+    'Other',
+    OFFLINE_TOUCH,
+]);
+
+const getString = (kv, key) => {
+    const value = kv === null || kv === void 0 ? void 0 : kv[key];
+    return typeof value === 'string' && value ? value : undefined;
+};
+/**
+ * Maps session KV onto the params Snap's tag accepts on `init`. Everything goes
+ * across raw: the tag strips the phone to digits and lowercases the rest before
+ * hashing it in the browser.
+ *
+ * `gender` and `dateOfBirth` are deliberately left out. Snap transmits gender
+ * unhashed, and it parses `db` as an integer age bounded to 0-130, so a
+ * YYYYMMDD date is rejected.
+ */
+const buildIdentity = (kv, userId) => {
+    const identity = {};
+    const email = getString(kv, 'email');
+    if (email) {
+        identity['user_email'] = email;
+    }
+    const phone = getString(kv, 'phone');
+    if (phone && isPlausibleE164Number(normalizePhoneNumber(phone, true))) {
+        // Snap normalizes before hashing, so the raw value goes across. The guard
+        // only keeps junk from being sent as a hash that matches nobody.
+        identity['user_phone_number'] = phone;
+    }
+    const firstName = getString(kv, 'firstName');
+    if (firstName) {
+        identity['firstname'] = firstName;
+    }
+    const lastName = getString(kv, 'lastName');
+    if (lastName) {
+        identity['lastname'] = lastName;
+    }
+    const city = getString(kv, 'city');
+    if (city) {
+        identity['geo_city'] = city;
+    }
+    const state = getString(kv, 'state');
+    if (state) {
+        identity['geo_region'] = state;
+    }
+    const zip = getString(kv, 'zip');
+    if (zip) {
+        identity['geo_postal_code'] = zip;
+    }
+    const country = getString(kv, 'country');
+    if (country) {
+        identity['geo_country'] = country;
+    }
+    if (userId) {
+        identity['external_id'] = userId;
+    }
+    return identity;
+};
+
 const snippet = () => {
     if (!window || !document || window.snaptr) {
         return;
@@ -55,7 +773,7 @@ const snippet = () => {
         script.parentNode.insertBefore(element, script);
     }
 };
-const init = ({ manifest }) => {
+const init = ({ manifest, userId, destination }) => {
     if (!manifest.variables ||
         !manifest.variables['pixelId'] ||
         manifest.variables['enableBrowser'] !== '1') {
@@ -65,17 +783,8 @@ const init = ({ manifest }) => {
     if (!window.snaptr) {
         return;
     }
-    window.snaptr('init', manifest.variables['pixelId']);
-};
-
-const getProductIdFromMapping = (item, productIdMapping) => {
-    if (productIdMapping === '1' && item['variantId']) {
-        return item['variantId'];
-    }
-    if (productIdMapping === '2' && item['sku']) {
-        return item['sku'];
-    }
-    return item['id'];
+    const identity = buildIdentity(getData(destination, 'session')['kv'], userId);
+    window.snaptr('init', manifest.variables['pixelId'], identity);
 };
 
 // eslint-disable-next-line @nx/enforce-module-boundaries
@@ -176,7 +885,7 @@ const getSnapEventName = (name) => {
     return name.toUpperCase();
 };
 const tag = ({ data, eventName, manifestVariables, eventId, executionContext, }) => {
-    const result = { sdkVersion: "1.68.2"  };
+    const result = { sdkVersion: "1.69.1"  };
     if (executionContext.get('pixelFired')) {
         return result;
     }
@@ -200,11 +909,30 @@ const tag = ({ data, eventName, manifestVariables, eventId, executionContext, })
     return result;
 };
 
+const user = ({ userId, manifestVariables, destination }) => {
+    if (!window ||
+        !window.snaptr ||
+        !manifestVariables['pixelId'] ||
+        manifestVariables['enableBrowser'] !== '1') {
+        return;
+    }
+    // KV is read rather than `data` because `data` carries only what just
+    // changed, and saveKV has already merged it in by the time this runs.
+    const identity = buildIdentity(getData(destination, 'session')['kv'], userId);
+    if (!Object.keys(identity).length) {
+        return;
+    }
+    // A second init on the same pixel merges the new params over the stored ones
+    // and skips the first-init side effects, so nothing re-registers or re-fires.
+    window.snaptr('init', manifestVariables['pixelId'], identity);
+};
+
 // eslint-disable-next-line @nx/enforce-module-boundaries
 const data = {
     name: packageName,
     tag,
     init,
+    user,
 };
 try {
     if (window) {