@blotoutio/providers-dataflywheel-sdk 1.68.1 → 1.69.0

package/index.cjs.js

@@ -1,9 +1,139 @@
 'use strict';
 
 const packageName = 'dataFlywheel';
+// Browser identifiers the edge persists against the EdgeTag user id, the way
+// Facebook stores _fbp/_fbc. The identify request carries no providerData and
+// dfw_nid is third-party to the merchant, so this is n_id's only route there.
+const storedNIdKey = 'n_id';
+const storedSessionIdKey = 'session_id';
+const storedSessionExpiryKey = 'session_expires_at';
+// The same identifiers published into the EdgeTag SDK's kv store, which rides
+// on every request including identify. Namespaced the way the edge splits them
+// back apart, as Facebook does with facebook::_fbp.
+const kvKey = (key) => `${packageName}::${key}`;
 const sessionStateKeyPrefix = 'dfw_sdk_state';
 const sessionBootstrapPath = 'v1/session';
 
+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 saveKV = (destination, data) => {
+    const currentSession = getData(destination, 'session');
+    if (!currentSession['kv']) {
+        currentSession['kv'] = {};
+    }
+    currentSession['kv'] = {
+        ...currentSession['kv'],
+        ...data,
+    };
+    saveData(destination, 'session', currentSession);
+};
+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 {};
+    }
+};
+
 // eslint-disable-next-line @nx/enforce-module-boundaries
 // Coalesces concurrent cold bootstraps per merchant: events firing in the same
 // tick share one in-flight /v1/session call instead of racing N handshakes.
@@ -92,6 +222,38 @@ function expiresAtMs(state) {
     const expiresAt = Date.parse(state.expires_at);
     return Number.isFinite(expiresAt) ? expiresAt : null;
 }
+// The dfw_nid cookie belongs to the DataFlywheel identity host, so the merchant's
+// edge never receives it. Publishing into the SDK's kv store puts the same values
+// on every request body instead -- identify included, which providerData is not.
+const published = new Map();
+function publishToKv(destination, state) {
+    if (!destination || !state)
+        return;
+    // saveKV rewrites the whole multi-destination blob synchronously, and the
+    // cached path runs on every event, so skip when nothing moved.
+    const last = published.get(destination);
+    if (last &&
+        last.n_id === state.n_id &&
+        last.session_id === state.session_id &&
+        last.expires_at === state.expires_at) {
+        return;
+    }
+    published.set(destination, {
+        n_id: state.n_id,
+        session_id: state.session_id,
+        expires_at: state.expires_at,
+    });
+    try {
+        saveKV(destination, {
+            [kvKey(storedNIdKey)]: state.n_id,
+            [kvKey(storedSessionIdKey)]: state.session_id,
+            [kvKey(storedSessionExpiryKey)]: state.expires_at,
+        });
+    }
+    catch {
+        // Storage can be unavailable; the providerData and provider-key routes remain.
+    }
+}
 function bootstrapUrl(input) {
     const base = input.dataFlywheelUrl.endsWith('/')
         ? input.dataFlywheelUrl
@@ -151,6 +313,7 @@ function ensureSession(input) {
     const now = (_c = (_b = input.now) === null || _b === void 0 ? void 0 : _b.call(input)) !== null && _c !== void 0 ? _c : Date.now();
     const existing = readSessionState(storage, merchantId);
     if (!shouldBootstrap(now, expiresAtMs(existing))) {
+        publishToKv(input.destination, existing);
         return Promise.resolve(existing);
     }
     // Opaque origins (sandboxed iframes like Shopify pixels) serialize to the
@@ -174,7 +337,12 @@ function ensureSession(input) {
         storage,
         fetcher,
         now,
-    }).finally(() => {
+    })
+        .then((state) => {
+        publishToKv(input.destination, state);
+        return state;
+    })
+        .finally(() => {
         inFlight.delete(key);
     });
     inFlight.set(key, bootstrap);
@@ -194,13 +362,15 @@ const init = (params) => {
     void ensureSession({
         variables: params.manifest.variables,
         pageUrl: params.pageUrl,
+        destination: params.destination,
     });
 };
 
-const tag = async ({ manifestVariables, pageUrl, }) => {
+const tag = async ({ manifestVariables, pageUrl, destination, }) => {
     const state = await ensureSession({
         variables: manifestVariables,
         pageUrl,
+        destination,
     });
     return toProviderData(state);
 };

package/index.js

@@ -2,9 +2,139 @@ var ProvidersDataflywheelSdk = (function () {
     'use strict';
 
     const packageName = 'dataFlywheel';
+    // Browser identifiers the edge persists against the EdgeTag user id, the way
+    // Facebook stores _fbp/_fbc. The identify request carries no providerData and
+    // dfw_nid is third-party to the merchant, so this is n_id's only route there.
+    const storedNIdKey = 'n_id';
+    const storedSessionIdKey = 'session_id';
+    const storedSessionExpiryKey = 'session_expires_at';
+    // The same identifiers published into the EdgeTag SDK's kv store, which rides
+    // on every request including identify. Namespaced the way the edge splits them
+    // back apart, as Facebook does with facebook::_fbp.
+    const kvKey = (key) => `${packageName}::${key}`;
     const sessionStateKeyPrefix = 'dfw_sdk_state';
     const sessionBootstrapPath = 'v1/session';
 
+    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 saveKV = (destination, data) => {
+        const currentSession = getData(destination, 'session');
+        if (!currentSession['kv']) {
+            currentSession['kv'] = {};
+        }
+        currentSession['kv'] = {
+            ...currentSession['kv'],
+            ...data,
+        };
+        saveData(destination, 'session', currentSession);
+    };
+    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 {};
+        }
+    };
+
     // eslint-disable-next-line @nx/enforce-module-boundaries
     // Coalesces concurrent cold bootstraps per merchant: events firing in the same
     // tick share one in-flight /v1/session call instead of racing N handshakes.
@@ -93,6 +223,38 @@ var ProvidersDataflywheelSdk = (function () {
         const expiresAt = Date.parse(state.expires_at);
         return Number.isFinite(expiresAt) ? expiresAt : null;
     }
+    // The dfw_nid cookie belongs to the DataFlywheel identity host, so the merchant's
+    // edge never receives it. Publishing into the SDK's kv store puts the same values
+    // on every request body instead -- identify included, which providerData is not.
+    const published = new Map();
+    function publishToKv(destination, state) {
+        if (!destination || !state)
+            return;
+        // saveKV rewrites the whole multi-destination blob synchronously, and the
+        // cached path runs on every event, so skip when nothing moved.
+        const last = published.get(destination);
+        if (last &&
+            last.n_id === state.n_id &&
+            last.session_id === state.session_id &&
+            last.expires_at === state.expires_at) {
+            return;
+        }
+        published.set(destination, {
+            n_id: state.n_id,
+            session_id: state.session_id,
+            expires_at: state.expires_at,
+        });
+        try {
+            saveKV(destination, {
+                [kvKey(storedNIdKey)]: state.n_id,
+                [kvKey(storedSessionIdKey)]: state.session_id,
+                [kvKey(storedSessionExpiryKey)]: state.expires_at,
+            });
+        }
+        catch {
+            // Storage can be unavailable; the providerData and provider-key routes remain.
+        }
+    }
     function bootstrapUrl(input) {
         const base = input.dataFlywheelUrl.endsWith('/')
             ? input.dataFlywheelUrl
@@ -152,6 +314,7 @@ var ProvidersDataflywheelSdk = (function () {
         const now = (_c = (_b = input.now) === null || _b === void 0 ? void 0 : _b.call(input)) !== null && _c !== void 0 ? _c : Date.now();
         const existing = readSessionState(storage, merchantId);
         if (!shouldBootstrap(now, expiresAtMs(existing))) {
+            publishToKv(input.destination, existing);
             return Promise.resolve(existing);
         }
         // Opaque origins (sandboxed iframes like Shopify pixels) serialize to the
@@ -175,7 +338,12 @@ var ProvidersDataflywheelSdk = (function () {
             storage,
             fetcher,
             now,
-        }).finally(() => {
+        })
+            .then((state) => {
+            publishToKv(input.destination, state);
+            return state;
+        })
+            .finally(() => {
             inFlight.delete(key);
         });
         inFlight.set(key, bootstrap);
@@ -195,13 +363,15 @@ var ProvidersDataflywheelSdk = (function () {
         void ensureSession({
             variables: params.manifest.variables,
             pageUrl: params.pageUrl,
+            destination: params.destination,
         });
     };
 
-    const tag = async ({ manifestVariables, pageUrl, }) => {
+    const tag = async ({ manifestVariables, pageUrl, destination, }) => {
         const state = await ensureSession({
             variables: manifestVariables,
             pageUrl,
+            destination,
         });
         return toProviderData(state);
     };

package/index.mjs

@@ -1,7 +1,137 @@
 const packageName = 'dataFlywheel';
+// Browser identifiers the edge persists against the EdgeTag user id, the way
+// Facebook stores _fbp/_fbc. The identify request carries no providerData and
+// dfw_nid is third-party to the merchant, so this is n_id's only route there.
+const storedNIdKey = 'n_id';
+const storedSessionIdKey = 'session_id';
+const storedSessionExpiryKey = 'session_expires_at';
+// The same identifiers published into the EdgeTag SDK's kv store, which rides
+// on every request including identify. Namespaced the way the edge splits them
+// back apart, as Facebook does with facebook::_fbp.
+const kvKey = (key) => `${packageName}::${key}`;
 const sessionStateKeyPrefix = 'dfw_sdk_state';
 const sessionBootstrapPath = 'v1/session';
 
+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 saveKV = (destination, data) => {
+    const currentSession = getData(destination, 'session');
+    if (!currentSession['kv']) {
+        currentSession['kv'] = {};
+    }
+    currentSession['kv'] = {
+        ...currentSession['kv'],
+        ...data,
+    };
+    saveData(destination, 'session', currentSession);
+};
+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 {};
+    }
+};
+
 // eslint-disable-next-line @nx/enforce-module-boundaries
 // Coalesces concurrent cold bootstraps per merchant: events firing in the same
 // tick share one in-flight /v1/session call instead of racing N handshakes.
@@ -90,6 +220,38 @@ function expiresAtMs(state) {
     const expiresAt = Date.parse(state.expires_at);
     return Number.isFinite(expiresAt) ? expiresAt : null;
 }
+// The dfw_nid cookie belongs to the DataFlywheel identity host, so the merchant's
+// edge never receives it. Publishing into the SDK's kv store puts the same values
+// on every request body instead -- identify included, which providerData is not.
+const published = new Map();
+function publishToKv(destination, state) {
+    if (!destination || !state)
+        return;
+    // saveKV rewrites the whole multi-destination blob synchronously, and the
+    // cached path runs on every event, so skip when nothing moved.
+    const last = published.get(destination);
+    if (last &&
+        last.n_id === state.n_id &&
+        last.session_id === state.session_id &&
+        last.expires_at === state.expires_at) {
+        return;
+    }
+    published.set(destination, {
+        n_id: state.n_id,
+        session_id: state.session_id,
+        expires_at: state.expires_at,
+    });
+    try {
+        saveKV(destination, {
+            [kvKey(storedNIdKey)]: state.n_id,
+            [kvKey(storedSessionIdKey)]: state.session_id,
+            [kvKey(storedSessionExpiryKey)]: state.expires_at,
+        });
+    }
+    catch {
+        // Storage can be unavailable; the providerData and provider-key routes remain.
+    }
+}
 function bootstrapUrl(input) {
     const base = input.dataFlywheelUrl.endsWith('/')
         ? input.dataFlywheelUrl
@@ -149,6 +311,7 @@ function ensureSession(input) {
     const now = (_c = (_b = input.now) === null || _b === void 0 ? void 0 : _b.call(input)) !== null && _c !== void 0 ? _c : Date.now();
     const existing = readSessionState(storage, merchantId);
     if (!shouldBootstrap(now, expiresAtMs(existing))) {
+        publishToKv(input.destination, existing);
         return Promise.resolve(existing);
     }
     // Opaque origins (sandboxed iframes like Shopify pixels) serialize to the
@@ -172,7 +335,12 @@ function ensureSession(input) {
         storage,
         fetcher,
         now,
-    }).finally(() => {
+    })
+        .then((state) => {
+        publishToKv(input.destination, state);
+        return state;
+    })
+        .finally(() => {
         inFlight.delete(key);
     });
     inFlight.set(key, bootstrap);
@@ -192,13 +360,15 @@ const init = (params) => {
     void ensureSession({
         variables: params.manifest.variables,
         pageUrl: params.pageUrl,
+        destination: params.destination,
     });
 };
 
-const tag = async ({ manifestVariables, pageUrl, }) => {
+const tag = async ({ manifestVariables, pageUrl, destination, }) => {
     const state = await ensureSession({
         variables: manifestVariables,
         pageUrl,
+        destination,
     });
     return toProviderData(state);
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blotoutio/providers-dataflywheel-sdk",
-  "version": "1.68.1",
+  "version": "1.69.0",
   "description": "DataFlywheel browser SDK for EdgeTag",
   "author": "Blotout",
   "license": "MIT",