@blotoutio/providers-awin-sdk 0.0.0-stage → 1.76.2

package/README.md

@@ -1,3 +1,11 @@
-# Temporary Holding Version
+# providers-awin-sdk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build providers-awin-sdk` to build the library.
+
+## Running unit tests
+
+Run `nx test providers-awin-sdk` to execute the unit tests via [Jest](https://jestjs.io).

package/index.cjs.js

@@ -0,0 +1,373 @@
+'use strict';
+
+const packageName = 'awin';
+const fallbackPixelUrl = 'https://www.awin1.com/sread.img';
+const masterTagUrl = 'https://www.dwin1.com';
+// Click checksum Awin appends to the landing page URL.
+const clickIdQueryKey = 'awc';
+const awinChannel = 'aw';
+const defaultCommissionGroup = 'DEFAULT';
+// Stores the last-click channel for Awin's deduplication.
+const channelKey = 'channel';
+// `aw` for an Awin click, otherwise the name of the other channel's click ID
+// (e.g. `google` for gclid). Null when the landing URL carries no click.
+const getLandingChannel = (search, clickIds) => {
+    const params = new URLSearchParams(search);
+    if (params.get(clickIdQueryKey)) {
+        return awinChannel;
+    }
+    const click = clickIds.find(({ param }) => params.get(param));
+    return click ? click.label.toLowerCase().replace(/\s+/g, '') : null;
+};
+// Purchase is always a conversion; any other event only when it is mapped.
+// Returns null for events that must not be sent to Awin.
+const getCommissionGroup = (eventName, conversions, defaultGroup) => {
+    var _a;
+    const fallback = (defaultGroup === null || defaultGroup === void 0 ? void 0 : defaultGroup.trim()) || defaultCommissionGroup;
+    const mapping = conversions.find((item) => item.event === eventName);
+    if (mapping) {
+        return ((_a = mapping.commissionGroup) === null || _a === void 0 ? void 0 : _a.trim()) || fallback;
+    }
+    return eventName === 'Purchase' ? fallback : null;
+};
+const toNumber = (value) => {
+    const number = Number(value);
+    return value === undefined || value === null || isNaN(number)
+        ? undefined
+        : number;
+};
+// When the checkout total is in another currency than the line items, the
+// Shopify pixel sends value = grossValue = Σ(line price × qty): no tax or
+// shipping in it, while taxCost / shippingCost stay in the checkout currency.
+// Matched with a small tolerance for the worker's per-field currency rounding.
+const isLineSubtotal = (gross, contents) => {
+    var _a;
+    if (!(contents === null || contents === void 0 ? void 0 : contents.length)) {
+        return false;
+    }
+    let subtotal = 0;
+    let units = 0;
+    for (const content of contents) {
+        const price = toNumber(content.item_price);
+        if (price === undefined) {
+            return false;
+        }
+        const quantity = (_a = toNumber(content.quantity)) !== null && _a !== void 0 ? _a : 1;
+        subtotal += price * quantity;
+        units += quantity;
+    }
+    return Math.abs(gross - subtotal) <= 0.01 + units * 0.001;
+};
+// Awin expects the order subtotal excluding tax and shipping, or the number of
+// leads for a valueless lead. Derived here from the gross breakdown when it is
+// present, so the browser and server send the same amount whatever the
+// channel's purchase value mode (which only the worker applies to `value`).
+const getAmount = (eventName, data) => {
+    var _a, _b;
+    const gross = toNumber(data.grossValue);
+    let amount = toNumber(data.value);
+    if (gross !== undefined) {
+        // A line subtotal has nothing to subtract (and the costs may be in another
+        // currency); gross is used as the worker's Net mode rewrites `value`.
+        amount = isLineSubtotal(gross, data.contents)
+            ? gross
+            : Math.max(0, gross -
+                ((_a = toNumber(data.taxCost)) !== null && _a !== void 0 ? _a : 0) -
+                ((_b = toNumber(data.shippingCost)) !== null && _b !== void 0 ? _b : 0));
+    }
+    if (amount === undefined) {
+        return eventName === 'Purchase' ? 0 : 1;
+    }
+    return Number(amount.toFixed(2));
+};
+
+const keyPrefix = `_worker`;
+
+const canLog = () => {
+    try {
+        return localStorage.getItem('edgeTagDebug') === '1';
+    }
+    catch {
+        return false;
+    }
+};
+const prefix = `[EdgeTag]`;
+const logger = {
+    log: (...args) => {
+        if (canLog()) {
+            console.log(prefix, ...args);
+        }
+    },
+    error: (...args) => {
+        if (canLog()) {
+            console.error(prefix, ...args);
+        }
+    },
+    info: (...args) => {
+        if (canLog()) {
+            console.info(prefix, ...args);
+        }
+    },
+    trace: (...args) => {
+        if (canLog()) {
+            console.trace(prefix, ...args);
+        }
+    },
+};
+
+const initKey = `${keyPrefix}StoreMultiple`;
+const saveDataPerKey = (destination, persistType, provider, value, key) => {
+    const storage = getData(destination, persistType);
+    if (!storage['data']) {
+        storage['data'] = {};
+    }
+    if (!storage['data'][provider]) {
+        storage['data'][provider] = {};
+    }
+    storage['data'][provider][key] = value;
+    saveData(destination, persistType, storage);
+};
+const saveData = (destination, persistType, value, key = initKey) => {
+    if (persistType === 'session') {
+        const data = getSession(key);
+        data[destination] = value;
+        saveSession(data, key);
+        return;
+    }
+    const data = getLocal(key);
+    data[destination] = value;
+    saveLocal(data, key);
+};
+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 saveLocal = (value, key) => {
+    try {
+        if (!localStorage) {
+            return;
+        }
+        localStorage.setItem(key, JSON.stringify(value));
+    }
+    catch {
+        logger.log('Local storage not supported.');
+    }
+};
+const getLocal = (key) => {
+    try {
+        if (!localStorage) {
+            return {};
+        }
+        const data = localStorage.getItem(key);
+        if (!data) {
+            return {};
+        }
+        return JSON.parse(data) || {};
+    }
+    catch {
+        return {};
+    }
+};
+const saveSession = (value, key) => {
+    try {
+        if (!sessionStorage) {
+            return;
+        }
+        sessionStorage.setItem(key, JSON.stringify(value));
+    }
+    catch {
+        logger.log('Session storage not supported.');
+    }
+};
+const getSession = (key) => {
+    try {
+        if (!sessionStorage) {
+            return {};
+        }
+        const data = sessionStorage.getItem(key);
+        if (!data) {
+            return {};
+        }
+        return JSON.parse(data) || {};
+    }
+    catch {
+        return {};
+    }
+};
+
+const getUrl = (pageUrl) => {
+    try {
+        return new URL(pageUrl || window.location.href);
+    }
+    catch {
+        return null;
+    }
+};
+// Records the last-click channel so conversions carry `aw` only when Awin won.
+// Kept on the edge for server-side calls and locally for the conversion tag.
+const saveChannel = ({ destination, sendEdgeData, manifest }, url) => {
+    var _a;
+    let clickIds = [];
+    try {
+        clickIds = JSON.parse(((_a = manifest.variables) === null || _a === void 0 ? void 0 : _a['clickIds']) || '[]');
+    }
+    catch {
+        // keep detecting Awin clicks only
+    }
+    const channel = url && getLandingChannel(url.search, clickIds);
+    if (!channel) {
+        return;
+    }
+    sendEdgeData({ [`${packageName}::${channelKey}`]: channel }, {});
+    saveDataPerKey(destination, 'local', packageName, channel, channelKey);
+};
+const isExcluded = (url, excludedPaths) => !!url &&
+    (excludedPaths || '')
+        .split(',')
+        .map((path) => path.trim())
+        .some((path) => path && url.pathname.startsWith(path));
+// Loads the Awin MasterTag on every page except the excluded (payment / PII)
+// paths.
+const init = (params) => {
+    var _a, _b, _c;
+    const { manifest, pageUrl } = params;
+    const advertiserId = (_a = manifest.variables) === null || _a === void 0 ? void 0 : _a['advertiserId'];
+    if (!advertiserId || typeof document === 'undefined') {
+        return;
+    }
+    try {
+        const url = getUrl(pageUrl);
+        if (((_b = manifest.variables) === null || _b === void 0 ? void 0 : _b['deduplication']) === '1') {
+            saveChannel(params, url);
+        }
+        if (isExcluded(url, (_c = manifest.variables) === null || _c === void 0 ? void 0 : _c['excludedPaths'])) {
+            return;
+        }
+        const scriptId = `awin-mastertag-${advertiserId}`;
+        if (document.getElementById(scriptId)) {
+            return;
+        }
+        const script = document.createElement('script');
+        script.id = scriptId;
+        script.defer = true;
+        script.src = `${masterTagUrl}/${advertiserId}.js`;
+        (document.body || document.head).appendChild(script);
+    }
+    catch (e) {
+        logger.error(`[${packageName}] MasterTag injection failed`, e);
+    }
+};
+
+const parseConversions = (value) => {
+    try {
+        const parsed = JSON.parse(value || '[]');
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+};
+// Last-click channel saved on landing when deduplication is on, else `aw`.
+const getChannel = (destination, deduplication) => {
+    var _a, _b;
+    if (deduplication !== '1') {
+        return awinChannel;
+    }
+    const storage = getData(destination, 'local');
+    return ((_b = (_a = storage.data) === null || _a === void 0 ? void 0 : _a[packageName]) === null || _b === void 0 ? void 0 : _b[channelKey]) || awinChannel;
+};
+// The pixel attributes the order from the awin1.com cookies, so they must be
+// sent: an Image does that like Awin's own snippet, and fetch with credentials
+// covers sandboxes without a DOM (Shopify custom pixel).
+const sendPixel = (url) => {
+    if (typeof Image !== 'undefined') {
+        new Image(0, 0).src = url;
+        return;
+    }
+    fetch(url, {
+        mode: 'no-cors',
+        credentials: 'include',
+        keepalive: true,
+    }).catch((e) => logger.error(`[${packageName}] Pixel failed`, e));
+};
+// Declares the Awin Conversion Tag and fires the mandatory Fall-back
+// Conversion Pixel. If the MasterTag is still loading it picks the sale up on
+// load; if it already ran, AWIN.Tracking.run() re-triggers it.
+const tag = ({ data, eventName, eventId, manifestVariables, destination, }) => {
+    var _a;
+    const payload = { sdkVersion: "1.76.2"  };
+    const advertiserId = manifestVariables['advertiserId'];
+    if (typeof window === 'undefined' || !advertiserId) {
+        return payload;
+    }
+    const commissionGroup = getCommissionGroup(eventName, parseConversions(manifestVariables['conversions']), manifestVariables['commissionGroup']);
+    if (!commissionGroup) {
+        return payload;
+    }
+    try {
+        const amount = getAmount(eventName, data).toFixed(2);
+        const discounts = data['discounts'];
+        const orderRef = String(data['orderId'] || eventId);
+        const parts = `${commissionGroup}:${amount}`;
+        const currency = String(data['currency'] || 'USD');
+        const voucher = ((_a = discounts === null || discounts === void 0 ? void 0 : discounts[0]) === null || _a === void 0 ? void 0 : _a.code) || '';
+        const channel = getChannel(destination, manifestVariables['deduplication']);
+        const test = manifestVariables['testMode'] === '1' ? '1' : '0';
+        const pixel = new URL(fallbackPixelUrl);
+        pixel.searchParams.set('tt', 'ns');
+        pixel.searchParams.set('tv', '2');
+        pixel.searchParams.set('merchant', advertiserId);
+        pixel.searchParams.set('amount', amount);
+        pixel.searchParams.set('ch', channel);
+        pixel.searchParams.set('parts', parts);
+        pixel.searchParams.set('ref', orderRef);
+        pixel.searchParams.set('cr', currency);
+        pixel.searchParams.set('vc', voucher);
+        pixel.searchParams.set('testmode', test);
+        sendPixel(pixel.toString());
+        window.AWIN = window.AWIN || {};
+        window.AWIN.Tracking = window.AWIN.Tracking || {};
+        window.AWIN.Tracking.Sale = {
+            amount,
+            channel,
+            orderRef,
+            parts,
+            currency,
+            voucher,
+            test,
+        };
+        if (typeof window.AWIN.Tracking.run === 'function') {
+            window.AWIN.Tracking.run();
+        }
+    }
+    catch (e) {
+        logger.error(`[${packageName}] Conversion tag failed`, e);
+    }
+    return payload;
+};
+
+// eslint-disable-next-line @nx/enforce-module-boundaries
+const data = {
+    name: packageName,
+    init,
+    tag,
+};
+try {
+    if (typeof window !== 'undefined') {
+        if (!window.edgetagProviders) {
+            window.edgetagProviders = [];
+        }
+        window.edgetagProviders.push(data);
+    }
+}
+catch {
+    // No window
+}
+
+module.exports = data;

package/index.js

@@ -0,0 +1,376 @@
+var ProvidersAwinSdk = (function () {
+    'use strict';
+
+    const packageName = 'awin';
+    const fallbackPixelUrl = 'https://www.awin1.com/sread.img';
+    const masterTagUrl = 'https://www.dwin1.com';
+    // Click checksum Awin appends to the landing page URL.
+    const clickIdQueryKey = 'awc';
+    const awinChannel = 'aw';
+    const defaultCommissionGroup = 'DEFAULT';
+    // Stores the last-click channel for Awin's deduplication.
+    const channelKey = 'channel';
+    // `aw` for an Awin click, otherwise the name of the other channel's click ID
+    // (e.g. `google` for gclid). Null when the landing URL carries no click.
+    const getLandingChannel = (search, clickIds) => {
+        const params = new URLSearchParams(search);
+        if (params.get(clickIdQueryKey)) {
+            return awinChannel;
+        }
+        const click = clickIds.find(({ param }) => params.get(param));
+        return click ? click.label.toLowerCase().replace(/\s+/g, '') : null;
+    };
+    // Purchase is always a conversion; any other event only when it is mapped.
+    // Returns null for events that must not be sent to Awin.
+    const getCommissionGroup = (eventName, conversions, defaultGroup) => {
+        var _a;
+        const fallback = (defaultGroup === null || defaultGroup === void 0 ? void 0 : defaultGroup.trim()) || defaultCommissionGroup;
+        const mapping = conversions.find((item) => item.event === eventName);
+        if (mapping) {
+            return ((_a = mapping.commissionGroup) === null || _a === void 0 ? void 0 : _a.trim()) || fallback;
+        }
+        return eventName === 'Purchase' ? fallback : null;
+    };
+    const toNumber = (value) => {
+        const number = Number(value);
+        return value === undefined || value === null || isNaN(number)
+            ? undefined
+            : number;
+    };
+    // When the checkout total is in another currency than the line items, the
+    // Shopify pixel sends value = grossValue = Σ(line price × qty): no tax or
+    // shipping in it, while taxCost / shippingCost stay in the checkout currency.
+    // Matched with a small tolerance for the worker's per-field currency rounding.
+    const isLineSubtotal = (gross, contents) => {
+        var _a;
+        if (!(contents === null || contents === void 0 ? void 0 : contents.length)) {
+            return false;
+        }
+        let subtotal = 0;
+        let units = 0;
+        for (const content of contents) {
+            const price = toNumber(content.item_price);
+            if (price === undefined) {
+                return false;
+            }
+            const quantity = (_a = toNumber(content.quantity)) !== null && _a !== void 0 ? _a : 1;
+            subtotal += price * quantity;
+            units += quantity;
+        }
+        return Math.abs(gross - subtotal) <= 0.01 + units * 0.001;
+    };
+    // Awin expects the order subtotal excluding tax and shipping, or the number of
+    // leads for a valueless lead. Derived here from the gross breakdown when it is
+    // present, so the browser and server send the same amount whatever the
+    // channel's purchase value mode (which only the worker applies to `value`).
+    const getAmount = (eventName, data) => {
+        var _a, _b;
+        const gross = toNumber(data.grossValue);
+        let amount = toNumber(data.value);
+        if (gross !== undefined) {
+            // A line subtotal has nothing to subtract (and the costs may be in another
+            // currency); gross is used as the worker's Net mode rewrites `value`.
+            amount = isLineSubtotal(gross, data.contents)
+                ? gross
+                : Math.max(0, gross -
+                    ((_a = toNumber(data.taxCost)) !== null && _a !== void 0 ? _a : 0) -
+                    ((_b = toNumber(data.shippingCost)) !== null && _b !== void 0 ? _b : 0));
+        }
+        if (amount === undefined) {
+            return eventName === 'Purchase' ? 0 : 1;
+        }
+        return Number(amount.toFixed(2));
+    };
+
+    const keyPrefix = `_worker`;
+
+    const canLog = () => {
+        try {
+            return localStorage.getItem('edgeTagDebug') === '1';
+        }
+        catch {
+            return false;
+        }
+    };
+    const prefix = `[EdgeTag]`;
+    const logger = {
+        log: (...args) => {
+            if (canLog()) {
+                console.log(prefix, ...args);
+            }
+        },
+        error: (...args) => {
+            if (canLog()) {
+                console.error(prefix, ...args);
+            }
+        },
+        info: (...args) => {
+            if (canLog()) {
+                console.info(prefix, ...args);
+            }
+        },
+        trace: (...args) => {
+            if (canLog()) {
+                console.trace(prefix, ...args);
+            }
+        },
+    };
+
+    const initKey = `${keyPrefix}StoreMultiple`;
+    const saveDataPerKey = (destination, persistType, provider, value, key) => {
+        const storage = getData(destination, persistType);
+        if (!storage['data']) {
+            storage['data'] = {};
+        }
+        if (!storage['data'][provider]) {
+            storage['data'][provider] = {};
+        }
+        storage['data'][provider][key] = value;
+        saveData(destination, persistType, storage);
+    };
+    const saveData = (destination, persistType, value, key = initKey) => {
+        if (persistType === 'session') {
+            const data = getSession(key);
+            data[destination] = value;
+            saveSession(data, key);
+            return;
+        }
+        const data = getLocal(key);
+        data[destination] = value;
+        saveLocal(data, key);
+    };
+    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 saveLocal = (value, key) => {
+        try {
+            if (!localStorage) {
+                return;
+            }
+            localStorage.setItem(key, JSON.stringify(value));
+        }
+        catch {
+            logger.log('Local storage not supported.');
+        }
+    };
+    const getLocal = (key) => {
+        try {
+            if (!localStorage) {
+                return {};
+            }
+            const data = localStorage.getItem(key);
+            if (!data) {
+                return {};
+            }
+            return JSON.parse(data) || {};
+        }
+        catch {
+            return {};
+        }
+    };
+    const saveSession = (value, key) => {
+        try {
+            if (!sessionStorage) {
+                return;
+            }
+            sessionStorage.setItem(key, JSON.stringify(value));
+        }
+        catch {
+            logger.log('Session storage not supported.');
+        }
+    };
+    const getSession = (key) => {
+        try {
+            if (!sessionStorage) {
+                return {};
+            }
+            const data = sessionStorage.getItem(key);
+            if (!data) {
+                return {};
+            }
+            return JSON.parse(data) || {};
+        }
+        catch {
+            return {};
+        }
+    };
+
+    const getUrl = (pageUrl) => {
+        try {
+            return new URL(pageUrl || window.location.href);
+        }
+        catch {
+            return null;
+        }
+    };
+    // Records the last-click channel so conversions carry `aw` only when Awin won.
+    // Kept on the edge for server-side calls and locally for the conversion tag.
+    const saveChannel = ({ destination, sendEdgeData, manifest }, url) => {
+        var _a;
+        let clickIds = [];
+        try {
+            clickIds = JSON.parse(((_a = manifest.variables) === null || _a === void 0 ? void 0 : _a['clickIds']) || '[]');
+        }
+        catch {
+            // keep detecting Awin clicks only
+        }
+        const channel = url && getLandingChannel(url.search, clickIds);
+        if (!channel) {
+            return;
+        }
+        sendEdgeData({ [`${packageName}::${channelKey}`]: channel }, {});
+        saveDataPerKey(destination, 'local', packageName, channel, channelKey);
+    };
+    const isExcluded = (url, excludedPaths) => !!url &&
+        (excludedPaths || '')
+            .split(',')
+            .map((path) => path.trim())
+            .some((path) => path && url.pathname.startsWith(path));
+    // Loads the Awin MasterTag on every page except the excluded (payment / PII)
+    // paths.
+    const init = (params) => {
+        var _a, _b, _c;
+        const { manifest, pageUrl } = params;
+        const advertiserId = (_a = manifest.variables) === null || _a === void 0 ? void 0 : _a['advertiserId'];
+        if (!advertiserId || typeof document === 'undefined') {
+            return;
+        }
+        try {
+            const url = getUrl(pageUrl);
+            if (((_b = manifest.variables) === null || _b === void 0 ? void 0 : _b['deduplication']) === '1') {
+                saveChannel(params, url);
+            }
+            if (isExcluded(url, (_c = manifest.variables) === null || _c === void 0 ? void 0 : _c['excludedPaths'])) {
+                return;
+            }
+            const scriptId = `awin-mastertag-${advertiserId}`;
+            if (document.getElementById(scriptId)) {
+                return;
+            }
+            const script = document.createElement('script');
+            script.id = scriptId;
+            script.defer = true;
+            script.src = `${masterTagUrl}/${advertiserId}.js`;
+            (document.body || document.head).appendChild(script);
+        }
+        catch (e) {
+            logger.error(`[${packageName}] MasterTag injection failed`, e);
+        }
+    };
+
+    const parseConversions = (value) => {
+        try {
+            const parsed = JSON.parse(value || '[]');
+            return Array.isArray(parsed) ? parsed : [];
+        }
+        catch {
+            return [];
+        }
+    };
+    // Last-click channel saved on landing when deduplication is on, else `aw`.
+    const getChannel = (destination, deduplication) => {
+        var _a, _b;
+        if (deduplication !== '1') {
+            return awinChannel;
+        }
+        const storage = getData(destination, 'local');
+        return ((_b = (_a = storage.data) === null || _a === void 0 ? void 0 : _a[packageName]) === null || _b === void 0 ? void 0 : _b[channelKey]) || awinChannel;
+    };
+    // The pixel attributes the order from the awin1.com cookies, so they must be
+    // sent: an Image does that like Awin's own snippet, and fetch with credentials
+    // covers sandboxes without a DOM (Shopify custom pixel).
+    const sendPixel = (url) => {
+        if (typeof Image !== 'undefined') {
+            new Image(0, 0).src = url;
+            return;
+        }
+        fetch(url, {
+            mode: 'no-cors',
+            credentials: 'include',
+            keepalive: true,
+        }).catch((e) => logger.error(`[${packageName}] Pixel failed`, e));
+    };
+    // Declares the Awin Conversion Tag and fires the mandatory Fall-back
+    // Conversion Pixel. If the MasterTag is still loading it picks the sale up on
+    // load; if it already ran, AWIN.Tracking.run() re-triggers it.
+    const tag = ({ data, eventName, eventId, manifestVariables, destination, }) => {
+        var _a;
+        const payload = { sdkVersion: "1.76.2"  };
+        const advertiserId = manifestVariables['advertiserId'];
+        if (typeof window === 'undefined' || !advertiserId) {
+            return payload;
+        }
+        const commissionGroup = getCommissionGroup(eventName, parseConversions(manifestVariables['conversions']), manifestVariables['commissionGroup']);
+        if (!commissionGroup) {
+            return payload;
+        }
+        try {
+            const amount = getAmount(eventName, data).toFixed(2);
+            const discounts = data['discounts'];
+            const orderRef = String(data['orderId'] || eventId);
+            const parts = `${commissionGroup}:${amount}`;
+            const currency = String(data['currency'] || 'USD');
+            const voucher = ((_a = discounts === null || discounts === void 0 ? void 0 : discounts[0]) === null || _a === void 0 ? void 0 : _a.code) || '';
+            const channel = getChannel(destination, manifestVariables['deduplication']);
+            const test = manifestVariables['testMode'] === '1' ? '1' : '0';
+            const pixel = new URL(fallbackPixelUrl);
+            pixel.searchParams.set('tt', 'ns');
+            pixel.searchParams.set('tv', '2');
+            pixel.searchParams.set('merchant', advertiserId);
+            pixel.searchParams.set('amount', amount);
+            pixel.searchParams.set('ch', channel);
+            pixel.searchParams.set('parts', parts);
+            pixel.searchParams.set('ref', orderRef);
+            pixel.searchParams.set('cr', currency);
+            pixel.searchParams.set('vc', voucher);
+            pixel.searchParams.set('testmode', test);
+            sendPixel(pixel.toString());
+            window.AWIN = window.AWIN || {};
+            window.AWIN.Tracking = window.AWIN.Tracking || {};
+            window.AWIN.Tracking.Sale = {
+                amount,
+                channel,
+                orderRef,
+                parts,
+                currency,
+                voucher,
+                test,
+            };
+            if (typeof window.AWIN.Tracking.run === 'function') {
+                window.AWIN.Tracking.run();
+            }
+        }
+        catch (e) {
+            logger.error(`[${packageName}] Conversion tag failed`, e);
+        }
+        return payload;
+    };
+
+    // eslint-disable-next-line @nx/enforce-module-boundaries
+    const data = {
+        name: packageName,
+        init,
+        tag,
+    };
+    try {
+        if (typeof window !== 'undefined') {
+            if (!window.edgetagProviders) {
+                window.edgetagProviders = [];
+            }
+            window.edgetagProviders.push(data);
+        }
+    }
+    catch {
+        // No window
+    }
+
+    return data;
+
+})();

package/index.mjs

@@ -0,0 +1,371 @@
+const packageName = 'awin';
+const fallbackPixelUrl = 'https://www.awin1.com/sread.img';
+const masterTagUrl = 'https://www.dwin1.com';
+// Click checksum Awin appends to the landing page URL.
+const clickIdQueryKey = 'awc';
+const awinChannel = 'aw';
+const defaultCommissionGroup = 'DEFAULT';
+// Stores the last-click channel for Awin's deduplication.
+const channelKey = 'channel';
+// `aw` for an Awin click, otherwise the name of the other channel's click ID
+// (e.g. `google` for gclid). Null when the landing URL carries no click.
+const getLandingChannel = (search, clickIds) => {
+    const params = new URLSearchParams(search);
+    if (params.get(clickIdQueryKey)) {
+        return awinChannel;
+    }
+    const click = clickIds.find(({ param }) => params.get(param));
+    return click ? click.label.toLowerCase().replace(/\s+/g, '') : null;
+};
+// Purchase is always a conversion; any other event only when it is mapped.
+// Returns null for events that must not be sent to Awin.
+const getCommissionGroup = (eventName, conversions, defaultGroup) => {
+    var _a;
+    const fallback = (defaultGroup === null || defaultGroup === void 0 ? void 0 : defaultGroup.trim()) || defaultCommissionGroup;
+    const mapping = conversions.find((item) => item.event === eventName);
+    if (mapping) {
+        return ((_a = mapping.commissionGroup) === null || _a === void 0 ? void 0 : _a.trim()) || fallback;
+    }
+    return eventName === 'Purchase' ? fallback : null;
+};
+const toNumber = (value) => {
+    const number = Number(value);
+    return value === undefined || value === null || isNaN(number)
+        ? undefined
+        : number;
+};
+// When the checkout total is in another currency than the line items, the
+// Shopify pixel sends value = grossValue = Σ(line price × qty): no tax or
+// shipping in it, while taxCost / shippingCost stay in the checkout currency.
+// Matched with a small tolerance for the worker's per-field currency rounding.
+const isLineSubtotal = (gross, contents) => {
+    var _a;
+    if (!(contents === null || contents === void 0 ? void 0 : contents.length)) {
+        return false;
+    }
+    let subtotal = 0;
+    let units = 0;
+    for (const content of contents) {
+        const price = toNumber(content.item_price);
+        if (price === undefined) {
+            return false;
+        }
+        const quantity = (_a = toNumber(content.quantity)) !== null && _a !== void 0 ? _a : 1;
+        subtotal += price * quantity;
+        units += quantity;
+    }
+    return Math.abs(gross - subtotal) <= 0.01 + units * 0.001;
+};
+// Awin expects the order subtotal excluding tax and shipping, or the number of
+// leads for a valueless lead. Derived here from the gross breakdown when it is
+// present, so the browser and server send the same amount whatever the
+// channel's purchase value mode (which only the worker applies to `value`).
+const getAmount = (eventName, data) => {
+    var _a, _b;
+    const gross = toNumber(data.grossValue);
+    let amount = toNumber(data.value);
+    if (gross !== undefined) {
+        // A line subtotal has nothing to subtract (and the costs may be in another
+        // currency); gross is used as the worker's Net mode rewrites `value`.
+        amount = isLineSubtotal(gross, data.contents)
+            ? gross
+            : Math.max(0, gross -
+                ((_a = toNumber(data.taxCost)) !== null && _a !== void 0 ? _a : 0) -
+                ((_b = toNumber(data.shippingCost)) !== null && _b !== void 0 ? _b : 0));
+    }
+    if (amount === undefined) {
+        return eventName === 'Purchase' ? 0 : 1;
+    }
+    return Number(amount.toFixed(2));
+};
+
+const keyPrefix = `_worker`;
+
+const canLog = () => {
+    try {
+        return localStorage.getItem('edgeTagDebug') === '1';
+    }
+    catch {
+        return false;
+    }
+};
+const prefix = `[EdgeTag]`;
+const logger = {
+    log: (...args) => {
+        if (canLog()) {
+            console.log(prefix, ...args);
+        }
+    },
+    error: (...args) => {
+        if (canLog()) {
+            console.error(prefix, ...args);
+        }
+    },
+    info: (...args) => {
+        if (canLog()) {
+            console.info(prefix, ...args);
+        }
+    },
+    trace: (...args) => {
+        if (canLog()) {
+            console.trace(prefix, ...args);
+        }
+    },
+};
+
+const initKey = `${keyPrefix}StoreMultiple`;
+const saveDataPerKey = (destination, persistType, provider, value, key) => {
+    const storage = getData(destination, persistType);
+    if (!storage['data']) {
+        storage['data'] = {};
+    }
+    if (!storage['data'][provider]) {
+        storage['data'][provider] = {};
+    }
+    storage['data'][provider][key] = value;
+    saveData(destination, persistType, storage);
+};
+const saveData = (destination, persistType, value, key = initKey) => {
+    if (persistType === 'session') {
+        const data = getSession(key);
+        data[destination] = value;
+        saveSession(data, key);
+        return;
+    }
+    const data = getLocal(key);
+    data[destination] = value;
+    saveLocal(data, key);
+};
+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 saveLocal = (value, key) => {
+    try {
+        if (!localStorage) {
+            return;
+        }
+        localStorage.setItem(key, JSON.stringify(value));
+    }
+    catch {
+        logger.log('Local storage not supported.');
+    }
+};
+const getLocal = (key) => {
+    try {
+        if (!localStorage) {
+            return {};
+        }
+        const data = localStorage.getItem(key);
+        if (!data) {
+            return {};
+        }
+        return JSON.parse(data) || {};
+    }
+    catch {
+        return {};
+    }
+};
+const saveSession = (value, key) => {
+    try {
+        if (!sessionStorage) {
+            return;
+        }
+        sessionStorage.setItem(key, JSON.stringify(value));
+    }
+    catch {
+        logger.log('Session storage not supported.');
+    }
+};
+const getSession = (key) => {
+    try {
+        if (!sessionStorage) {
+            return {};
+        }
+        const data = sessionStorage.getItem(key);
+        if (!data) {
+            return {};
+        }
+        return JSON.parse(data) || {};
+    }
+    catch {
+        return {};
+    }
+};
+
+const getUrl = (pageUrl) => {
+    try {
+        return new URL(pageUrl || window.location.href);
+    }
+    catch {
+        return null;
+    }
+};
+// Records the last-click channel so conversions carry `aw` only when Awin won.
+// Kept on the edge for server-side calls and locally for the conversion tag.
+const saveChannel = ({ destination, sendEdgeData, manifest }, url) => {
+    var _a;
+    let clickIds = [];
+    try {
+        clickIds = JSON.parse(((_a = manifest.variables) === null || _a === void 0 ? void 0 : _a['clickIds']) || '[]');
+    }
+    catch {
+        // keep detecting Awin clicks only
+    }
+    const channel = url && getLandingChannel(url.search, clickIds);
+    if (!channel) {
+        return;
+    }
+    sendEdgeData({ [`${packageName}::${channelKey}`]: channel }, {});
+    saveDataPerKey(destination, 'local', packageName, channel, channelKey);
+};
+const isExcluded = (url, excludedPaths) => !!url &&
+    (excludedPaths || '')
+        .split(',')
+        .map((path) => path.trim())
+        .some((path) => path && url.pathname.startsWith(path));
+// Loads the Awin MasterTag on every page except the excluded (payment / PII)
+// paths.
+const init = (params) => {
+    var _a, _b, _c;
+    const { manifest, pageUrl } = params;
+    const advertiserId = (_a = manifest.variables) === null || _a === void 0 ? void 0 : _a['advertiserId'];
+    if (!advertiserId || typeof document === 'undefined') {
+        return;
+    }
+    try {
+        const url = getUrl(pageUrl);
+        if (((_b = manifest.variables) === null || _b === void 0 ? void 0 : _b['deduplication']) === '1') {
+            saveChannel(params, url);
+        }
+        if (isExcluded(url, (_c = manifest.variables) === null || _c === void 0 ? void 0 : _c['excludedPaths'])) {
+            return;
+        }
+        const scriptId = `awin-mastertag-${advertiserId}`;
+        if (document.getElementById(scriptId)) {
+            return;
+        }
+        const script = document.createElement('script');
+        script.id = scriptId;
+        script.defer = true;
+        script.src = `${masterTagUrl}/${advertiserId}.js`;
+        (document.body || document.head).appendChild(script);
+    }
+    catch (e) {
+        logger.error(`[${packageName}] MasterTag injection failed`, e);
+    }
+};
+
+const parseConversions = (value) => {
+    try {
+        const parsed = JSON.parse(value || '[]');
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+};
+// Last-click channel saved on landing when deduplication is on, else `aw`.
+const getChannel = (destination, deduplication) => {
+    var _a, _b;
+    if (deduplication !== '1') {
+        return awinChannel;
+    }
+    const storage = getData(destination, 'local');
+    return ((_b = (_a = storage.data) === null || _a === void 0 ? void 0 : _a[packageName]) === null || _b === void 0 ? void 0 : _b[channelKey]) || awinChannel;
+};
+// The pixel attributes the order from the awin1.com cookies, so they must be
+// sent: an Image does that like Awin's own snippet, and fetch with credentials
+// covers sandboxes without a DOM (Shopify custom pixel).
+const sendPixel = (url) => {
+    if (typeof Image !== 'undefined') {
+        new Image(0, 0).src = url;
+        return;
+    }
+    fetch(url, {
+        mode: 'no-cors',
+        credentials: 'include',
+        keepalive: true,
+    }).catch((e) => logger.error(`[${packageName}] Pixel failed`, e));
+};
+// Declares the Awin Conversion Tag and fires the mandatory Fall-back
+// Conversion Pixel. If the MasterTag is still loading it picks the sale up on
+// load; if it already ran, AWIN.Tracking.run() re-triggers it.
+const tag = ({ data, eventName, eventId, manifestVariables, destination, }) => {
+    var _a;
+    const payload = { sdkVersion: "1.76.2"  };
+    const advertiserId = manifestVariables['advertiserId'];
+    if (typeof window === 'undefined' || !advertiserId) {
+        return payload;
+    }
+    const commissionGroup = getCommissionGroup(eventName, parseConversions(manifestVariables['conversions']), manifestVariables['commissionGroup']);
+    if (!commissionGroup) {
+        return payload;
+    }
+    try {
+        const amount = getAmount(eventName, data).toFixed(2);
+        const discounts = data['discounts'];
+        const orderRef = String(data['orderId'] || eventId);
+        const parts = `${commissionGroup}:${amount}`;
+        const currency = String(data['currency'] || 'USD');
+        const voucher = ((_a = discounts === null || discounts === void 0 ? void 0 : discounts[0]) === null || _a === void 0 ? void 0 : _a.code) || '';
+        const channel = getChannel(destination, manifestVariables['deduplication']);
+        const test = manifestVariables['testMode'] === '1' ? '1' : '0';
+        const pixel = new URL(fallbackPixelUrl);
+        pixel.searchParams.set('tt', 'ns');
+        pixel.searchParams.set('tv', '2');
+        pixel.searchParams.set('merchant', advertiserId);
+        pixel.searchParams.set('amount', amount);
+        pixel.searchParams.set('ch', channel);
+        pixel.searchParams.set('parts', parts);
+        pixel.searchParams.set('ref', orderRef);
+        pixel.searchParams.set('cr', currency);
+        pixel.searchParams.set('vc', voucher);
+        pixel.searchParams.set('testmode', test);
+        sendPixel(pixel.toString());
+        window.AWIN = window.AWIN || {};
+        window.AWIN.Tracking = window.AWIN.Tracking || {};
+        window.AWIN.Tracking.Sale = {
+            amount,
+            channel,
+            orderRef,
+            parts,
+            currency,
+            voucher,
+            test,
+        };
+        if (typeof window.AWIN.Tracking.run === 'function') {
+            window.AWIN.Tracking.run();
+        }
+    }
+    catch (e) {
+        logger.error(`[${packageName}] Conversion tag failed`, e);
+    }
+    return payload;
+};
+
+// eslint-disable-next-line @nx/enforce-module-boundaries
+const data = {
+    name: packageName,
+    init,
+    tag,
+};
+try {
+    if (typeof window !== 'undefined') {
+        if (!window.edgetagProviders) {
+            window.edgetagProviders = [];
+        }
+        window.edgetagProviders.push(data);
+    }
+}
+catch {
+    // No window
+}
+
+export { data as default };

package/package.json

@@ -1,6 +1,26 @@
 {
   "name": "@blotoutio/providers-awin-sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.76.2",
+  "description": "Awin Browser SDK for EdgeTag",
+  "author": "Blotout",
+  "license": "MIT",
+  "homepage": "https://github.com/blotoutio/edgetag-sdk",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./index.cjs.js",
+  "module": "./index.mjs",
+  "types": "./index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/blotoutio/edgetag-sdk.git"
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "index.cjs.js",
+    "index.mjs",
+    "package.json",
+    "README.md"
+  ]
+}