@blotoutio/providers-snapchat-sdk 1.68.1 → 1.69.0

package/index.js

@@ -37,7 +37,725 @@ var ProvidersSnapchatSdk = (function () {
         '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;
@@ -58,7 +776,7 @@ var ProvidersSnapchatSdk = (function () {
             script.parentNode.insertBefore(element, script);
         }
     };
-    const init = ({ manifest }) => {
+    const init = ({ manifest, userId, destination }) => {
         if (!manifest.variables ||
             !manifest.variables['pixelId'] ||
             manifest.variables['enableBrowser'] !== '1') {
@@ -68,17 +786,8 @@ var ProvidersSnapchatSdk = (function () {
         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
@@ -179,7 +888,7 @@ var ProvidersSnapchatSdk = (function () {
         return name.toUpperCase();
     };
     const tag = ({ data, eventName, manifestVariables, eventId, executionContext, }) => {
-        const result = { sdkVersion: "1.68.1"  };
+        const result = { sdkVersion: "1.69.0"  };
         if (executionContext.get('pixelFired')) {
             return result;
         }
@@ -203,11 +912,30 @@ var ProvidersSnapchatSdk = (function () {
         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) {