@solomon-tech/events-eitri 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,68 @@
-# Temporary Holding Version
+# @solomon-tech/events-eitri
 
-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.
+SDK de analytics da Solomon para **apps Eitri** (TypeScript, sobre o Bifrost).
+
+Rastreia eventos de funil de e-commerce em apps Eitri e os envia para o backend de analytics da Solomon (pixel + webanalytics), que faz a atribuição. É um módulo TypeScript puro que roda no runtime do eitri-app e usa a API `Eitri.*` (`eitri-bifrost`) para rede, storage e device.
+
+## Instalação
+
+```bash
+npm install @solomon-tech/events-eitri
+```
+
+`eitri-bifrost` é uma `peerDependency` — já está disponível no runtime do eitri-app.
+
+## Uso
+
+```ts
+import SolomonSDK, { registerSolomonHost } from '@solomon-tech/events-eitri';
+
+const solomon = new SolomonSDK({
+  companyId: 'SEU_COMPANY_ID',
+  useTouchpoint: true,          // default true
+  installStateFromHost: true,   // o host (Eitri) informa install/reinstall
+  onDeepLink: (deepLinkValue, params) => {
+    // rotear a navegação do app com base no deep link
+  },
+});
+
+// Expõe o SDK para o host (Eitri) chamar os métodos de sessão/instalação:
+registerSolomonHost(solomon);
+
+// Rastreio de tela + eventos:
+solomon.setScreenName('ProductScreen');
+solomon.track('ADD_TO_CART', { item_id: '123', item_quantity: 2 }, { email: 'x@y.com' });
+```
+
+## Integração com o host (Eitri)
+
+A Eitri resolve o deep link e o lifecycle de instalação e **chama** o SDK:
+
+```ts
+// Params de todos os query params da URL que abriu/reativou o app
+// (utm_*, sol_*, click_id, fbclid, deep_link_value). Cold start E runtime.
+solomon.setSessionAttributes(urlParams);
+
+// Lifecycle vindo do host (install referrer / ciclo de vida nativo).
+solomon.setInstallState({ isInstall, isReinstall });
+```
+
+Se o host chamar por um ponto global em vez da instância, `registerSolomonHost(solomon)`
+expõe `globalThis.__SOLOMON_EITRI__` com os mesmos dois métodos.
+
+## Eventos
+
+`VIEW_PAGE`, `CONTENT_VIEW`, `ADD_TO_CART`, `INITIATE_CHECKOUT`, `ADD_SHIPPING_INFO`,
+`ADD_CUSTOMER_INFO`, `ADD_PAYMENT_INFO`, `CHECKOUT_COMPLETED`, além de `APP_INSTALL` /
+`APP_REINSTALL` (automáticos).
+
+## Notas
+
+- **Install referrer**: o Bifrost não expõe install referrer; a atribuição de instalação usa
+  `click_id` + fingerprint (fallback). `id_source='shared_storage'`.
+- Campos de enriquecimento ausentes no runtime (locale/timezone/dimensões de tela) degradam para
+  `''`/`0` sem quebrar os eventos.
+
+## Licença
+
+MIT

package/dist/attribution/deep-link.d.ts

@@ -0,0 +1,24 @@
+export interface DeepLinkParams {
+    utm_source: string;
+    utm_medium: string;
+    utm_campaign: string;
+    utm_term: string;
+    utm_content: string;
+    sol_source: string;
+    sol_medium: string;
+    sol_campaign: string;
+    sol_content: string;
+    fbclid: string;
+    click_id: string;
+    queryString: string;
+}
+export declare function parseDeepLinkUrl(url: string): DeepLinkParams;
+/** True se a URL é um link do link-service (host = linkDomain) com slug — ex.: l.solomon.com.br/2leihlnl */
+export declare function isSolomonLink(url: string, linkDomain: string): boolean;
+export interface ResolvedLink {
+    params: DeepLinkParams;
+    deep_link_value: string;
+}
+export declare function resolveSolomonLink(url: string): Promise<ResolvedLink | null>;
+export declare function parseInstallReferrer(referrer: string): DeepLinkParams;
+//# sourceMappingURL=deep-link.d.ts.map

package/dist/attribution/deep-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-link.d.ts","sourceRoot":"","sources":["../../src/attribution/deep-link.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AA8CD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAY5D;AAED,4GAA4G;AAC5G,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAMtE;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,cAAc,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB;AAeD,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAsBlF;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAWrE"}

package/dist/attribution/deep-link.js

@@ -0,0 +1,139 @@
+import Eitri from 'eitri-bifrost';
+const CLICK_ID_RE = /^[a-f0-9]{16,}$|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/i;
+function emptyParams() {
+    return {
+        utm_source: '', utm_medium: '', utm_campaign: '', utm_term: '', utm_content: '',
+        sol_source: '', sol_medium: '', sol_campaign: '', sol_content: '',
+        fbclid: '', click_id: '', queryString: '',
+    };
+}
+function parseQueryString(query) {
+    const params = emptyParams();
+    if (!query)
+        return params;
+    const pairs = query.split('&');
+    for (const pair of pairs) {
+        const eqIdx = pair.indexOf('=');
+        if (eqIdx === -1)
+            continue;
+        let key;
+        let value;
+        try {
+            key = decodeURIComponent(pair.substring(0, eqIdx));
+            value = decodeURIComponent(pair.substring(eqIdx + 1));
+        }
+        catch (_a) {
+            continue;
+        }
+        switch (key) {
+            case 'utm_source':
+                params.utm_source = value;
+                break;
+            case 'utm_medium':
+                params.utm_medium = value;
+                break;
+            case 'utm_campaign':
+                params.utm_campaign = value;
+                break;
+            case 'utm_term':
+                params.utm_term = value;
+                break;
+            case 'utm_content':
+                params.utm_content = value;
+                break;
+            case 'sol_source':
+                params.sol_source = value;
+                break;
+            case 'sol_medium':
+                params.sol_medium = value;
+                break;
+            case 'sol_campaign':
+                params.sol_campaign = value;
+                break;
+            case 'sol_content':
+                params.sol_content = value;
+                break;
+            case 'fbclid':
+                params.fbclid = value;
+                break;
+            case 'click_id':
+                params.click_id = value;
+                break;
+        }
+    }
+    return params;
+}
+export function parseDeepLinkUrl(url) {
+    let queryString = '';
+    const questionIdx = url.indexOf('?');
+    if (questionIdx !== -1) {
+        queryString = url.substring(questionIdx + 1);
+        const hashIdx = queryString.indexOf('#');
+        if (hashIdx !== -1)
+            queryString = queryString.substring(0, hashIdx);
+    }
+    const params = parseQueryString(queryString);
+    params.queryString = queryString ? '?' + queryString : '';
+    return params;
+}
+/** True se a URL é um link do link-service (host = linkDomain) com slug — ex.: l.solomon.com.br/2leihlnl */
+export function isSolomonLink(url, linkDomain) {
+    if (!url || !linkDomain)
+        return false;
+    const noScheme = url.replace(/^https?:\/\//i, '');
+    const host = noScheme.split('/')[0].split('?')[0].toLowerCase();
+    const path = noScheme.split('/').slice(1).join('/').split('?')[0];
+    return host === linkDomain.toLowerCase() && !!path && !path.startsWith('.well-known');
+}
+/** Extrai o corpo JSON de uma HttpResponse do Bifrost (axios-like `data`, ou `body`/string). */
+function extractJson(resp) {
+    var _a, _b, _c;
+    if (!resp)
+        return null;
+    const status = (_a = resp.status) !== null && _a !== void 0 ? _a : resp.statusCode;
+    if (typeof status === 'number' && (status < 200 || status >= 300))
+        return null;
+    const raw = (_c = (_b = resp.data) !== null && _b !== void 0 ? _b : resp.body) !== null && _c !== void 0 ? _c : resp;
+    if (raw && typeof raw === 'object')
+        return raw;
+    if (typeof raw === 'string') {
+        try {
+            return JSON.parse(raw);
+        }
+        catch (_d) {
+            return null;
+        }
+    }
+    return null;
+}
+export async function resolveSolomonLink(url) {
+    try {
+        const sep = url.includes('?') ? '&' : '?';
+        const resp = await Eitri.http.get(`${url}${sep}mode=resolve`, {
+            headers: { Accept: 'application/json' },
+        });
+        const d = extractJson(resp);
+        if (!d)
+            return null;
+        return {
+            params: Object.assign(Object.assign({}, emptyParams()), { utm_source: d.utm_source || '', utm_medium: d.utm_medium || '', utm_campaign: d.utm_campaign || '', utm_term: d.utm_term || '', utm_content: d.utm_content || '', sol_source: d.sol_source || '', sol_medium: d.sol_medium || '', sol_campaign: d.sol_campaign || '', sol_content: d.sol_content || '', click_id: d.click_id || '' }),
+            deep_link_value: d.deep_link_value || '',
+        };
+    }
+    catch (_a) {
+        return null;
+    }
+}
+export function parseInstallReferrer(referrer) {
+    if (!referrer)
+        return emptyParams();
+    const trimmed = referrer.trim();
+    if (trimmed.includes('=')) {
+        return parseQueryString(trimmed);
+    }
+    if (CLICK_ID_RE.test(trimmed)) {
+        return Object.assign(Object.assign({}, emptyParams()), { click_id: trimmed });
+    }
+    return emptyParams();
+}
+//# sourceMappingURL=deep-link.js.map

package/dist/attribution/deep-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-link.js","sourceRoot":"","sources":["../../src/attribution/deep-link.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,eAAe,CAAC;AAiBlC,MAAM,WAAW,GACf,iFAAiF,CAAC;AAEpF,SAAS,WAAW;IAClB,OAAO;QACL,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE;QAC/E,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE;QACjE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE;KAC1C,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa;IACrC,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;IAC7B,IAAI,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,SAAS;QAC3B,IAAI,GAAW,CAAC;QAChB,IAAI,KAAa,CAAC;QAClB,IAAI,CAAC;YACH,GAAG,GAAG,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;YACnD,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QACxD,CAAC;QAAC,WAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,YAAY;gBAAE,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC;gBAAC,MAAM;YACpD,KAAK,YAAY;gBAAE,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC;gBAAC,MAAM;YACpD,KAAK,cAAc;gBAAE,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC;gBAAC,MAAM;YACxD,KAAK,UAAU;gBAAE,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC;gBAAC,MAAM;YAChD,KAAK,aAAa;gBAAE,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC;gBAAC,MAAM;YACtD,KAAK,YAAY;gBAAE,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC;gBAAC,MAAM;YACpD,KAAK,YAAY;gBAAE,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC;gBAAC,MAAM;YACpD,KAAK,cAAc;gBAAE,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC;gBAAC,MAAM;YACxD,KAAK,aAAa;gBAAE,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC;gBAAC,MAAM;YACtD,KAAK,QAAQ;gBAAE,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;gBAAC,MAAM;YAC5C,KAAK,UAAU;gBAAE,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC;gBAAC,MAAM;QAClD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,WAAW,KAAK,CAAC,CAAC,EAAE,CAAC;QACvB,WAAW,GAAG,GAAG,CAAC,SAAS,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,OAAO,KAAK,CAAC,CAAC;YAAE,WAAW,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,MAAM,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAC7C,MAAM,CAAC,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,4GAA4G;AAC5G,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,UAAkB;IAC3D,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IACtC,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAChE,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,OAAO,IAAI,KAAK,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AACxF,CAAC;AAOD,gGAAgG;AAChG,SAAS,WAAW,CAAC,IAAS;;IAC5B,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,MAAM,GAAG,MAAA,IAAI,CAAC,MAAM,mCAAI,IAAI,CAAC,UAAU,CAAC;IAC9C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,GAAG,GAAG,IAAI,MAAM,IAAI,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/E,MAAM,GAAG,GAAG,MAAA,MAAA,IAAI,CAAC,IAAI,mCAAI,IAAI,CAAC,IAAI,mCAAI,IAAI,CAAC;IAC3C,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAA6B,CAAC;IACzE,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC;YAAC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAAC,WAAM,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;IACxD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAW;IAClD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAC1C,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,cAAc,EAAE;YAC5D,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;SACxC,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACpB,OAAO;YACL,MAAM,kCACD,WAAW,EAAE,KAChB,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE,EAC9D,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE,EAChG,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE,EAC9D,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE,EACpE,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE,GAC3B;YACD,eAAe,EAAE,CAAC,CAAC,eAAe,IAAI,EAAE;SACzC,CAAC;IACJ,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,IAAI,CAAC,QAAQ;QAAE,OAAO,WAAW,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAEhC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,uCAAY,WAAW,EAAE,KAAE,QAAQ,EAAE,OAAO,IAAG;IACjD,CAAC;IACD,OAAO,WAAW,EAAE,CAAC;AACvB,CAAC"}

package/dist/attribution/touchpoint.d.ts

@@ -0,0 +1,14 @@
+import { StorageAdapter } from '../storage/adapter';
+export declare function updateUtmsTrack(storage: StorageAdapter, eventData: {
+    utm_source: string;
+    utm_medium: string;
+    utm_campaign: string;
+    utm_term: string;
+    utm_content: string;
+    sol_source: string;
+    sol_medium: string;
+    sol_campaign: string;
+    sol_content: string;
+}): Promise<string>;
+export declare function getUtmsTrack(storage: StorageAdapter): Promise<string>;
+//# sourceMappingURL=touchpoint.d.ts.map

package/dist/attribution/touchpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"touchpoint.d.ts","sourceRoot":"","sources":["../../src/attribution/touchpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIpD,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE;IACT,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB,GACA,OAAO,CAAC,MAAM,CAAC,CAyBjB;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAE3E"}

package/dist/attribution/touchpoint.js

@@ -0,0 +1,28 @@
+const UTMS_TRACK_KEY = '@solomon/utms_track';
+export async function updateUtmsTrack(storage, eventData) {
+    const utmEntries = {
+        utm_source: eventData.utm_source,
+        utm_medium: eventData.utm_medium,
+        utm_campaign: eventData.utm_campaign,
+        utm_term: eventData.utm_term,
+        utm_content: eventData.utm_content,
+        sol_source: eventData.sol_source,
+        sol_medium: eventData.sol_medium,
+        sol_campaign: eventData.sol_campaign,
+        sol_content: eventData.sol_content,
+    };
+    // Build utmsTrack string only from eventData (which comes from getAllUtms, the single source of truth)
+    const parts = [];
+    for (const key in utmEntries) {
+        if (utmEntries[key]) {
+            parts.push(key + '=' + utmEntries[key]);
+        }
+    }
+    const utmsTrackString = parts.join('&');
+    await storage.setItem(UTMS_TRACK_KEY, utmsTrackString);
+    return utmsTrackString;
+}
+export async function getUtmsTrack(storage) {
+    return (await storage.getItem(UTMS_TRACK_KEY)) || '';
+}
+//# sourceMappingURL=touchpoint.js.map

package/dist/attribution/touchpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"touchpoint.js","sourceRoot":"","sources":["../../src/attribution/touchpoint.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAAG,qBAAqB,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAuB,EACvB,SAUC;IAED,MAAM,UAAU,GAA2B;QACzC,UAAU,EAAE,SAAS,CAAC,UAAU;QAChC,UAAU,EAAE,SAAS,CAAC,UAAU;QAChC,YAAY,EAAE,SAAS,CAAC,YAAY;QACpC,QAAQ,EAAE,SAAS,CAAC,QAAQ;QAC5B,WAAW,EAAE,SAAS,CAAC,WAAW;QAClC,UAAU,EAAE,SAAS,CAAC,UAAU;QAChC,UAAU,EAAE,SAAS,CAAC,UAAU;QAChC,YAAY,EAAE,SAAS,CAAC,YAAY;QACpC,WAAW,EAAE,SAAS,CAAC,WAAW;KACnC,CAAC;IAEF,uGAAuG;IACvG,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;IAEvD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAuB;IACxD,OAAO,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,IAAI,EAAE,CAAC;AACvD,CAAC"}

package/dist/attribution/utm.d.ts

@@ -0,0 +1,19 @@
+import { StorageAdapter } from '../storage/adapter';
+import { DeepLinkParams } from './deep-link';
+export declare function storeUtms(storage: StorageAdapter, params: DeepLinkParams): Promise<void>;
+export declare function getUtm(storage: StorageAdapter, key: string): Promise<string>;
+export interface AllUtms {
+    utm_source: string;
+    utm_medium: string;
+    utm_campaign: string;
+    utm_term: string;
+    utm_content: string;
+    sol_source: string;
+    sol_medium: string;
+    sol_campaign: string;
+    sol_content: string;
+    fbclid: string;
+    click_id: string;
+}
+export declare function getAllUtms(storage: StorageAdapter): Promise<AllUtms>;
+//# sourceMappingURL=utm.d.ts.map

package/dist/attribution/utm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utm.d.ts","sourceRoot":"","sources":["../../src/attribution/utm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAW7C,wBAAsB,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB9F;AAED,wBAAsB,MAAM,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGlF;AAED,MAAM,WAAW,OAAO;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAwB1E"}

package/dist/attribution/utm.js

@@ -0,0 +1,47 @@
+const UTM_KEYS = [
+    'utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',
+    'sol_source', 'sol_medium', 'sol_campaign', 'sol_content',
+];
+const STORAGE_PREFIX = '@solomon/';
+const FBCLID_KEY = '@solomon/fbclid';
+const CLICK_ID_KEY = '@solomon/click_id';
+export async function storeUtms(storage, params) {
+    const promises = [];
+    for (const key of UTM_KEYS) {
+        if (params[key]) {
+            promises.push(storage.setItem(STORAGE_PREFIX + key, params[key]));
+        }
+    }
+    if (params.fbclid) {
+        promises.push(storage.setItem(FBCLID_KEY, params.fbclid));
+    }
+    if (params.click_id) {
+        promises.push(storage.setItem(CLICK_ID_KEY, params.click_id));
+    }
+    await Promise.all(promises);
+}
+export async function getUtm(storage, key) {
+    const value = await storage.getItem(STORAGE_PREFIX + key);
+    return value || '';
+}
+export async function getAllUtms(storage) {
+    const [utm_source, utm_medium, utm_campaign, utm_term, utm_content, sol_source, sol_medium, sol_campaign, sol_content, fbclid, click_id,] = await Promise.all([
+        getUtm(storage, 'utm_source'),
+        getUtm(storage, 'utm_medium'),
+        getUtm(storage, 'utm_campaign'),
+        getUtm(storage, 'utm_term'),
+        getUtm(storage, 'utm_content'),
+        getUtm(storage, 'sol_source'),
+        getUtm(storage, 'sol_medium'),
+        getUtm(storage, 'sol_campaign'),
+        getUtm(storage, 'sol_content'),
+        storage.getItem(FBCLID_KEY).then((v) => v || ''),
+        storage.getItem(CLICK_ID_KEY).then((v) => v || ''),
+    ]);
+    return {
+        utm_source, utm_medium, utm_campaign, utm_term, utm_content,
+        sol_source, sol_medium, sol_campaign, sol_content,
+        fbclid, click_id,
+    };
+}
+//# sourceMappingURL=utm.js.map

package/dist/attribution/utm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utm.js","sourceRoot":"","sources":["../../src/attribution/utm.ts"],"names":[],"mappings":"AAGA,MAAM,QAAQ,GAAG;IACf,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa;IACrE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa;CACjD,CAAC;AAEX,MAAM,cAAc,GAAG,WAAW,CAAC;AACnC,MAAM,UAAU,GAAG,iBAAiB,CAAC;AACrC,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAuB,EAAE,MAAsB;IAC7E,MAAM,QAAQ,GAAoB,EAAE,CAAC;IAErC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YAChB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,GAAG,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAAuB,EAAE,GAAW;IAC/D,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,cAAc,GAAG,GAAG,CAAC,CAAC;IAC1D,OAAO,KAAK,IAAI,EAAE,CAAC;AACrB,CAAC;AAgBD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAuB;IACtD,MAAM,CACJ,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAC3D,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EACjD,MAAM,EAAE,QAAQ,EACjB,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACpB,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC;QAC7B,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC;QAC7B,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC;QAC/B,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC;QAC3B,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC;QAC9B,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC;QAC7B,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC;QAC7B,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC;QAC/B,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC;QAC9B,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAChD,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;KACnD,CAAC,CAAC;IAEH,OAAO;QACL,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW;QAC3D,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW;QACjD,MAAM,EAAE,QAAQ;KACjB,CAAC;AACJ,CAAC"}

package/dist/core/client.d.ts

@@ -0,0 +1,34 @@
+import { SDKConfig, CustomAliases } from './types';
+import { SolomonEvent, SolomonPayload } from './events';
+export declare class SolomonSDK {
+    private config;
+    private storage;
+    private appIdentifier;
+    private currentScreen;
+    private previousScreen;
+    private queryString;
+    private deepLinkValue;
+    private installReferrer;
+    private deviceInfoCache;
+    private stableId;
+    private initPromise;
+    private installEmitted;
+    constructor(config: SDKConfig);
+    private _init;
+    private _emitInstallEvent;
+    setScreenName(name: string): void;
+    setSessionAttributes(attributes: Record<string, any> | null | undefined): Promise<void>;
+    applyInitParams(info: Record<string, any> | null | undefined): Promise<void>;
+    private _buildQueryString;
+    handleDeepLink(url: string): void;
+    getDeepLinkValue(): string;
+    setInstallState(state: {
+        isInstall?: boolean;
+        isReinstall?: boolean;
+    } | null | undefined): Promise<void>;
+    track<E extends SolomonEvent>(event: E, payload?: SolomonPayload<E>, aliases?: CustomAliases): Promise<void>;
+    private _buildEventPayload;
+    flush(): Promise<void>;
+    destroy(): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/core/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AA2BxD,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,eAAe,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,cAAc,CAAkB;gBAE5B,MAAM,EAAE,SAAS;YAaf,KAAK;YAiDL,iBAAiB;IA8C/B,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAU3B,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IA2CvF,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlF,OAAO,CAAC,iBAAiB;IAWzB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAoCjC,gBAAgB,IAAI,MAAM;IAIpB,eAAe,CAAC,KAAK,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBxG,KAAK,CAAC,CAAC,SAAS,YAAY,EAChC,KAAK,EAAE,CAAC,EACR,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,EAC3B,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,IAAI,CAAC;IAsDhB,OAAO,CAAC,kBAAkB;IA0BpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,OAAO,IAAI,IAAI;CAKhB"}