@blotoutio/providers-dataflywheel-sdk 1.63.0

package/README.md

@@ -0,0 +1,5 @@
+# DataFlywheel Browser SDK
+
+Browser helper loaded by EdgeTag for DataFlywheel session bootstrap.
+
+It calls the DataFlywheel global worker `/v1/session` directly with credentialed fetches. EdgeTag delivers this helper and forwards event payloads, but it does not mint or decide DataFlywheel sessions.

package/index.cjs.js

@@ -0,0 +1,202 @@
+'use strict';
+
+const packageName = 'dataFlywheel';
+const sessionStateKeyPrefix = 'dfw_sdk_state';
+const sessionBootstrapPath = 'v1/session';
+
+// 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.
+const inFlight = new Map();
+const memoryStates = new Map();
+const stringValue = (value) => typeof value === 'string' && value.trim() ? value.trim() : undefined;
+const numberValue = (value) => typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+const isEnabledFlag = (value, defaultValue = true) => {
+    if (value == null || value === '')
+        return defaultValue;
+    return value !== '0' && value.toLowerCase() !== 'false';
+};
+const shouldBootstrap = (now, expiresAt) => expiresAt == null || now >= expiresAt;
+const stateKey = (merchantId) => `${sessionStateKeyPrefix}:${merchantId}`;
+const browserStorage = () => {
+    var _a;
+    try {
+        if (typeof window === 'undefined')
+            return null;
+        return (_a = window.sessionStorage) !== null && _a !== void 0 ? _a : null;
+    }
+    catch {
+        return null;
+    }
+};
+const sessionStorageFor = (storage) => (storage === undefined ? browserStorage() : storage);
+const readSessionState = (storage, merchantId) => {
+    var _a;
+    const key = stateKey(merchantId);
+    const fallback = () => { var _a; return (_a = memoryStates.get(key)) !== null && _a !== void 0 ? _a : null; };
+    if (!storage)
+        return fallback();
+    try {
+        const raw = storage.getItem(key);
+        if (!raw)
+            return fallback();
+        const parsed = JSON.parse(raw);
+        const nId = stringValue(parsed.n_id);
+        const sessionId = stringValue(parsed.session_id);
+        const expiresAt = stringValue(parsed.expires_at);
+        if (!nId || !sessionId || !expiresAt)
+            return fallback();
+        return {
+            n_id: nId,
+            session_id: sessionId,
+            expires_at: expiresAt,
+            last_touch_at: (_a = numberValue(parsed.last_touch_at)) !== null && _a !== void 0 ? _a : 0,
+        };
+    }
+    catch {
+        return fallback();
+    }
+};
+const writeSessionState = (storage, merchantId, state) => {
+    const key = stateKey(merchantId);
+    if (!storage) {
+        memoryStates.set(key, state);
+        return;
+    }
+    try {
+        storage.setItem(key, JSON.stringify(state));
+    }
+    catch {
+        memoryStates.set(key, state);
+        // Storage can be disabled or full. The worker cookies remain authoritative.
+    }
+};
+function expiresAtMs(state) {
+    if (!state)
+        return null;
+    const expiresAt = Date.parse(state.expires_at);
+    return Number.isFinite(expiresAt) ? expiresAt : null;
+}
+function bootstrapUrl(input) {
+    const base = input.dataFlywheelUrl.endsWith('/')
+        ? input.dataFlywheelUrl
+        : `${input.dataFlywheelUrl}/`;
+    const url = new URL(sessionBootstrapPath, base);
+    url.searchParams.set('merchant_id', input.merchantId);
+    const pageUrl = stringValue(input.pageUrl);
+    if (pageUrl) {
+        url.searchParams.set('page_url', pageUrl);
+    }
+    return url.toString();
+}
+function parseBootstrapResponse(body, now) {
+    var _a, _b;
+    const nId = stringValue(body.n_id);
+    const sessionId = stringValue((_a = body.session) === null || _a === void 0 ? void 0 : _a.session_id);
+    const expiresAt = stringValue((_b = body.session) === null || _b === void 0 ? void 0 : _b.expires_at);
+    if (!nId || !sessionId || !expiresAt)
+        return null;
+    return {
+        n_id: nId,
+        session_id: sessionId,
+        expires_at: expiresAt,
+        last_touch_at: now,
+    };
+}
+async function bootstrapSession(input) {
+    try {
+        const response = await input.fetcher(bootstrapUrl({
+            dataFlywheelUrl: input.dataFlywheelUrl,
+            merchantId: input.merchantId,
+            pageUrl: input.pageUrl,
+        }), { credentials: 'include' });
+        if (!response.ok)
+            return null;
+        const state = parseBootstrapResponse((await response.json()), input.now);
+        if (!state)
+            return null;
+        writeSessionState(input.storage, input.merchantId, state);
+        return state;
+    }
+    catch {
+        return null;
+    }
+}
+function ensureSession(input) {
+    var _a, _b, _c, _d;
+    const variables = (_a = input.variables) !== null && _a !== void 0 ? _a : {};
+    const dataFlywheelUrl = stringValue(variables.dataFlywheelUrl);
+    const merchantId = stringValue(variables.merchantId);
+    if (!dataFlywheelUrl ||
+        !merchantId ||
+        !isEnabledFlag(variables.dataFlywheelSessionEnabled)) {
+        return Promise.resolve(null);
+    }
+    const storage = sessionStorageFor(input.storage);
+    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))) {
+        return Promise.resolve(existing);
+    }
+    const key = stateKey(merchantId);
+    const existingBootstrap = inFlight.get(key);
+    if (existingBootstrap)
+        return existingBootstrap;
+    const fetcher = (_d = input.fetcher) !== null && _d !== void 0 ? _d : (typeof fetch === 'function' ? fetch.bind(globalThis) : null);
+    if (!fetcher)
+        return Promise.resolve(null);
+    const bootstrap = bootstrapSession({
+        dataFlywheelUrl,
+        merchantId,
+        pageUrl: input.pageUrl,
+        storage,
+        fetcher,
+        now,
+    }).finally(() => {
+        inFlight.delete(key);
+    });
+    inFlight.set(key, bootstrap);
+    return bootstrap;
+}
+function toProviderData(state) {
+    if (!state)
+        return {};
+    return {
+        n_id: state.n_id,
+        session_id: state.session_id,
+        expires_at: state.expires_at,
+    };
+}
+
+const init = (params) => {
+    void ensureSession({
+        variables: params.manifest.variables,
+        pageUrl: params.pageUrl,
+    });
+};
+
+const tag = async ({ manifestVariables, pageUrl, }) => {
+    const state = await ensureSession({
+        variables: manifestVariables,
+        pageUrl,
+    });
+    return toProviderData(state);
+};
+
+// eslint-disable-next-line @nx/enforce-module-boundaries
+const data = {
+    name: packageName,
+    init,
+    tag,
+};
+try {
+    if (typeof window !== 'undefined') {
+        window.edgetagProviders = window.edgetagProviders || [];
+        window.edgetagProviders.push(data);
+    }
+}
+catch {
+    // no window
+}
+
+module.exports = data;

package/index.d.ts

@@ -0,0 +1 @@
+export {}

package/index.js

@@ -0,0 +1,205 @@
+var ProvidersDataflywheelSdk = (function () {
+    'use strict';
+
+    const packageName = 'dataFlywheel';
+    const sessionStateKeyPrefix = 'dfw_sdk_state';
+    const sessionBootstrapPath = 'v1/session';
+
+    // 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.
+    const inFlight = new Map();
+    const memoryStates = new Map();
+    const stringValue = (value) => typeof value === 'string' && value.trim() ? value.trim() : undefined;
+    const numberValue = (value) => typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+    const isEnabledFlag = (value, defaultValue = true) => {
+        if (value == null || value === '')
+            return defaultValue;
+        return value !== '0' && value.toLowerCase() !== 'false';
+    };
+    const shouldBootstrap = (now, expiresAt) => expiresAt == null || now >= expiresAt;
+    const stateKey = (merchantId) => `${sessionStateKeyPrefix}:${merchantId}`;
+    const browserStorage = () => {
+        var _a;
+        try {
+            if (typeof window === 'undefined')
+                return null;
+            return (_a = window.sessionStorage) !== null && _a !== void 0 ? _a : null;
+        }
+        catch {
+            return null;
+        }
+    };
+    const sessionStorageFor = (storage) => (storage === undefined ? browserStorage() : storage);
+    const readSessionState = (storage, merchantId) => {
+        var _a;
+        const key = stateKey(merchantId);
+        const fallback = () => { var _a; return (_a = memoryStates.get(key)) !== null && _a !== void 0 ? _a : null; };
+        if (!storage)
+            return fallback();
+        try {
+            const raw = storage.getItem(key);
+            if (!raw)
+                return fallback();
+            const parsed = JSON.parse(raw);
+            const nId = stringValue(parsed.n_id);
+            const sessionId = stringValue(parsed.session_id);
+            const expiresAt = stringValue(parsed.expires_at);
+            if (!nId || !sessionId || !expiresAt)
+                return fallback();
+            return {
+                n_id: nId,
+                session_id: sessionId,
+                expires_at: expiresAt,
+                last_touch_at: (_a = numberValue(parsed.last_touch_at)) !== null && _a !== void 0 ? _a : 0,
+            };
+        }
+        catch {
+            return fallback();
+        }
+    };
+    const writeSessionState = (storage, merchantId, state) => {
+        const key = stateKey(merchantId);
+        if (!storage) {
+            memoryStates.set(key, state);
+            return;
+        }
+        try {
+            storage.setItem(key, JSON.stringify(state));
+        }
+        catch {
+            memoryStates.set(key, state);
+            // Storage can be disabled or full. The worker cookies remain authoritative.
+        }
+    };
+    function expiresAtMs(state) {
+        if (!state)
+            return null;
+        const expiresAt = Date.parse(state.expires_at);
+        return Number.isFinite(expiresAt) ? expiresAt : null;
+    }
+    function bootstrapUrl(input) {
+        const base = input.dataFlywheelUrl.endsWith('/')
+            ? input.dataFlywheelUrl
+            : `${input.dataFlywheelUrl}/`;
+        const url = new URL(sessionBootstrapPath, base);
+        url.searchParams.set('merchant_id', input.merchantId);
+        const pageUrl = stringValue(input.pageUrl);
+        if (pageUrl) {
+            url.searchParams.set('page_url', pageUrl);
+        }
+        return url.toString();
+    }
+    function parseBootstrapResponse(body, now) {
+        var _a, _b;
+        const nId = stringValue(body.n_id);
+        const sessionId = stringValue((_a = body.session) === null || _a === void 0 ? void 0 : _a.session_id);
+        const expiresAt = stringValue((_b = body.session) === null || _b === void 0 ? void 0 : _b.expires_at);
+        if (!nId || !sessionId || !expiresAt)
+            return null;
+        return {
+            n_id: nId,
+            session_id: sessionId,
+            expires_at: expiresAt,
+            last_touch_at: now,
+        };
+    }
+    async function bootstrapSession(input) {
+        try {
+            const response = await input.fetcher(bootstrapUrl({
+                dataFlywheelUrl: input.dataFlywheelUrl,
+                merchantId: input.merchantId,
+                pageUrl: input.pageUrl,
+            }), { credentials: 'include' });
+            if (!response.ok)
+                return null;
+            const state = parseBootstrapResponse((await response.json()), input.now);
+            if (!state)
+                return null;
+            writeSessionState(input.storage, input.merchantId, state);
+            return state;
+        }
+        catch {
+            return null;
+        }
+    }
+    function ensureSession(input) {
+        var _a, _b, _c, _d;
+        const variables = (_a = input.variables) !== null && _a !== void 0 ? _a : {};
+        const dataFlywheelUrl = stringValue(variables.dataFlywheelUrl);
+        const merchantId = stringValue(variables.merchantId);
+        if (!dataFlywheelUrl ||
+            !merchantId ||
+            !isEnabledFlag(variables.dataFlywheelSessionEnabled)) {
+            return Promise.resolve(null);
+        }
+        const storage = sessionStorageFor(input.storage);
+        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))) {
+            return Promise.resolve(existing);
+        }
+        const key = stateKey(merchantId);
+        const existingBootstrap = inFlight.get(key);
+        if (existingBootstrap)
+            return existingBootstrap;
+        const fetcher = (_d = input.fetcher) !== null && _d !== void 0 ? _d : (typeof fetch === 'function' ? fetch.bind(globalThis) : null);
+        if (!fetcher)
+            return Promise.resolve(null);
+        const bootstrap = bootstrapSession({
+            dataFlywheelUrl,
+            merchantId,
+            pageUrl: input.pageUrl,
+            storage,
+            fetcher,
+            now,
+        }).finally(() => {
+            inFlight.delete(key);
+        });
+        inFlight.set(key, bootstrap);
+        return bootstrap;
+    }
+    function toProviderData(state) {
+        if (!state)
+            return {};
+        return {
+            n_id: state.n_id,
+            session_id: state.session_id,
+            expires_at: state.expires_at,
+        };
+    }
+
+    const init = (params) => {
+        void ensureSession({
+            variables: params.manifest.variables,
+            pageUrl: params.pageUrl,
+        });
+    };
+
+    const tag = async ({ manifestVariables, pageUrl, }) => {
+        const state = await ensureSession({
+            variables: manifestVariables,
+            pageUrl,
+        });
+        return toProviderData(state);
+    };
+
+    // eslint-disable-next-line @nx/enforce-module-boundaries
+    const data = {
+        name: packageName,
+        init,
+        tag,
+    };
+    try {
+        if (typeof window !== 'undefined') {
+            window.edgetagProviders = window.edgetagProviders || [];
+            window.edgetagProviders.push(data);
+        }
+    }
+    catch {
+        // no window
+    }
+
+    return data;
+
+})();

package/index.mjs

@@ -0,0 +1,200 @@
+const packageName = 'dataFlywheel';
+const sessionStateKeyPrefix = 'dfw_sdk_state';
+const sessionBootstrapPath = 'v1/session';
+
+// 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.
+const inFlight = new Map();
+const memoryStates = new Map();
+const stringValue = (value) => typeof value === 'string' && value.trim() ? value.trim() : undefined;
+const numberValue = (value) => typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+const isEnabledFlag = (value, defaultValue = true) => {
+    if (value == null || value === '')
+        return defaultValue;
+    return value !== '0' && value.toLowerCase() !== 'false';
+};
+const shouldBootstrap = (now, expiresAt) => expiresAt == null || now >= expiresAt;
+const stateKey = (merchantId) => `${sessionStateKeyPrefix}:${merchantId}`;
+const browserStorage = () => {
+    var _a;
+    try {
+        if (typeof window === 'undefined')
+            return null;
+        return (_a = window.sessionStorage) !== null && _a !== void 0 ? _a : null;
+    }
+    catch {
+        return null;
+    }
+};
+const sessionStorageFor = (storage) => (storage === undefined ? browserStorage() : storage);
+const readSessionState = (storage, merchantId) => {
+    var _a;
+    const key = stateKey(merchantId);
+    const fallback = () => { var _a; return (_a = memoryStates.get(key)) !== null && _a !== void 0 ? _a : null; };
+    if (!storage)
+        return fallback();
+    try {
+        const raw = storage.getItem(key);
+        if (!raw)
+            return fallback();
+        const parsed = JSON.parse(raw);
+        const nId = stringValue(parsed.n_id);
+        const sessionId = stringValue(parsed.session_id);
+        const expiresAt = stringValue(parsed.expires_at);
+        if (!nId || !sessionId || !expiresAt)
+            return fallback();
+        return {
+            n_id: nId,
+            session_id: sessionId,
+            expires_at: expiresAt,
+            last_touch_at: (_a = numberValue(parsed.last_touch_at)) !== null && _a !== void 0 ? _a : 0,
+        };
+    }
+    catch {
+        return fallback();
+    }
+};
+const writeSessionState = (storage, merchantId, state) => {
+    const key = stateKey(merchantId);
+    if (!storage) {
+        memoryStates.set(key, state);
+        return;
+    }
+    try {
+        storage.setItem(key, JSON.stringify(state));
+    }
+    catch {
+        memoryStates.set(key, state);
+        // Storage can be disabled or full. The worker cookies remain authoritative.
+    }
+};
+function expiresAtMs(state) {
+    if (!state)
+        return null;
+    const expiresAt = Date.parse(state.expires_at);
+    return Number.isFinite(expiresAt) ? expiresAt : null;
+}
+function bootstrapUrl(input) {
+    const base = input.dataFlywheelUrl.endsWith('/')
+        ? input.dataFlywheelUrl
+        : `${input.dataFlywheelUrl}/`;
+    const url = new URL(sessionBootstrapPath, base);
+    url.searchParams.set('merchant_id', input.merchantId);
+    const pageUrl = stringValue(input.pageUrl);
+    if (pageUrl) {
+        url.searchParams.set('page_url', pageUrl);
+    }
+    return url.toString();
+}
+function parseBootstrapResponse(body, now) {
+    var _a, _b;
+    const nId = stringValue(body.n_id);
+    const sessionId = stringValue((_a = body.session) === null || _a === void 0 ? void 0 : _a.session_id);
+    const expiresAt = stringValue((_b = body.session) === null || _b === void 0 ? void 0 : _b.expires_at);
+    if (!nId || !sessionId || !expiresAt)
+        return null;
+    return {
+        n_id: nId,
+        session_id: sessionId,
+        expires_at: expiresAt,
+        last_touch_at: now,
+    };
+}
+async function bootstrapSession(input) {
+    try {
+        const response = await input.fetcher(bootstrapUrl({
+            dataFlywheelUrl: input.dataFlywheelUrl,
+            merchantId: input.merchantId,
+            pageUrl: input.pageUrl,
+        }), { credentials: 'include' });
+        if (!response.ok)
+            return null;
+        const state = parseBootstrapResponse((await response.json()), input.now);
+        if (!state)
+            return null;
+        writeSessionState(input.storage, input.merchantId, state);
+        return state;
+    }
+    catch {
+        return null;
+    }
+}
+function ensureSession(input) {
+    var _a, _b, _c, _d;
+    const variables = (_a = input.variables) !== null && _a !== void 0 ? _a : {};
+    const dataFlywheelUrl = stringValue(variables.dataFlywheelUrl);
+    const merchantId = stringValue(variables.merchantId);
+    if (!dataFlywheelUrl ||
+        !merchantId ||
+        !isEnabledFlag(variables.dataFlywheelSessionEnabled)) {
+        return Promise.resolve(null);
+    }
+    const storage = sessionStorageFor(input.storage);
+    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))) {
+        return Promise.resolve(existing);
+    }
+    const key = stateKey(merchantId);
+    const existingBootstrap = inFlight.get(key);
+    if (existingBootstrap)
+        return existingBootstrap;
+    const fetcher = (_d = input.fetcher) !== null && _d !== void 0 ? _d : (typeof fetch === 'function' ? fetch.bind(globalThis) : null);
+    if (!fetcher)
+        return Promise.resolve(null);
+    const bootstrap = bootstrapSession({
+        dataFlywheelUrl,
+        merchantId,
+        pageUrl: input.pageUrl,
+        storage,
+        fetcher,
+        now,
+    }).finally(() => {
+        inFlight.delete(key);
+    });
+    inFlight.set(key, bootstrap);
+    return bootstrap;
+}
+function toProviderData(state) {
+    if (!state)
+        return {};
+    return {
+        n_id: state.n_id,
+        session_id: state.session_id,
+        expires_at: state.expires_at,
+    };
+}
+
+const init = (params) => {
+    void ensureSession({
+        variables: params.manifest.variables,
+        pageUrl: params.pageUrl,
+    });
+};
+
+const tag = async ({ manifestVariables, pageUrl, }) => {
+    const state = await ensureSession({
+        variables: manifestVariables,
+        pageUrl,
+    });
+    return toProviderData(state);
+};
+
+// eslint-disable-next-line @nx/enforce-module-boundaries
+const data = {
+    name: packageName,
+    init,
+    tag,
+};
+try {
+    if (typeof window !== 'undefined') {
+        window.edgetagProviders = window.edgetagProviders || [];
+        window.edgetagProviders.push(data);
+    }
+}
+catch {
+    // no window
+}
+
+export { data as default };

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@blotoutio/providers-dataflywheel-sdk",
+  "version": "1.63.0",
+  "description": "DataFlywheel 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",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "require": "./index.cjs.js",
+      "import": "./index.mjs",
+      "default": "./index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/blotoutio/edgetag-sdk.git"
+  },
+  "files": [
+    "package.json",
+    "README.md",
+    "index.js",
+    "index.cjs.js",
+    "index.mjs",
+    "index.d.ts"
+  ]
+}