@azzas/azzas-tracker-web 1.0.84 → 1.0.85

package/README.md

@@ -1,130 +1,130 @@
-# azzas-tracker-web
-
-Pacote interno para **Data Tracking** das lojas WEB, centralizando a captura e envio de eventos para diferentes plataformas de mídia (Meta, Dito, DataLayer, etc).  
-
-O objetivo é fornecer uma **camada única e consistente de tracking**, garantindo que todos os eventos sejam tratados, formatados e enviados de forma confiável.  
-
-E, principalmente, centralizar a complexidade e a “inteligência” de tracking **fora dos repositórios das lojas**.
-
----
-
-## Fluxo do Tracking
-
-O pacote segue o seguinte fluxo de eventos:
-
-1. **User Action**  
-   Ações do usuário na loja (ex: adicionar ao carrinho, iniciar checkout, finalizar compra).  
-
-2. **Tracks**  
-   Ponto central que recebe o contexto do evento vindo da ação do usuário e encaminha para o *Formatter*.  
-
-3. **Formatter**  
-   Acessa a constante `EVENTS` e, baseado no contexto do evento, puxa os parâmetros obrigatórios e entrega a biblioteca de parâmetros (`/params`).  
-
-4. **Params Library**  
-   Contém **getters** e **resolvers** que garantem que os dados sejam legítimos e que todos os parâmetros sejam corretamente tratados.  
-
-5. **Adapters**  
-   Módulos responsáveis por enviar os dados formatados para cada destino (Meta, Datalayer, Dito, etc).  
-
-![FLUXOGRAMA](/public/fluxograma-lib-params.png)
-
-## Instalação
-
-
-```bash
-npm install /path/azzas-tracker-web
-```
-
-
-## Exemplos
-
-Listagem dos `EVENTS` e função orquestradora `trackWebEvent`:
-```javascript
-  const EVENTS = {
-    ADD_PERSONAL_INFO: {
-      name: 'add_personal_info',
-      destinations: ['DataLayer'],
-      requiredParams: ['brand', 'pre_filled', 'currency', 'value', 'subtotal'],
-    }, 
-    VIEW_CART: {
-      name: 'add_personal_info',
-      destinations: ['DataLayer', 'Meta', 'Dito'],
-      requiredParams: ['....'],
-    }
-  }
-
-  export async function trackWebEvent(event: EventName, context: EventContext = {}) {
-    try {
-      const parameters = await getParameters(context, event);
-      return await dispatchTrackEvent(event, parameters);
-    } catch (err) {
-      return console.error(`[DT] Error tracking event ${event}:`, err);
-    }
-  }
-```
-
-Uso básico da função no consumidor:
-
-
-```javascript
-  import { trackWebEvent } from 'azzas-tracker-web';
-
-  // DATA TRACKING | add_personal_info at submit (pre-filled always false)
-  // @see notion document for more details:
-  const form: Element = document.querySelector('xxxxxx');
-  if (form) {
-    form.addEventListener('submit', () => {
-      trackWebEvent('ADD_PERSONAL_INFO', { preFilled: false, orderForm: vtexjs.checkout.orderForm });
-    });
-  }
-```
-
-***OBS***: atente-se ao adicionar eventos novos e contribua na documentação do NOTION ou apenas DOCUMENTE em algum lugar! Seu futuro EU será grato 👍
-
-## Teste Local para Ambientes CDN/DENO
-
-Para testar alterações na biblioteca localmente, simulando a forma como ela é carregada por uma CDN (<script src="...">), use o script npm run dev:deno.
-
-Este comando realiza o build mais recente da biblioteca, empacota-o e inicia um servidor HTTP local usando o Deno para servir o arquivo
-
-1. Aqui nesse repositório, rode o script que inicia o servidor local:
-
-```bash
-  npm run dev:deno
-```
-
-O servidor será iniciado e começará a servir o seu arquivo de build no seguinte endereço: http://localhost:4507/.
-
-2. No Projeto Consumidor (DENO/FRONT):
-
-Altere o link do <script> no seu projeto para apontar para o servidor local.
-
-Você deve usar: <script src="http://localhost:4507/dist/mod.global.js"></script>
-
-
-## Boas Práticas
-- Sempre garantir que os `requiredParams` de cada evento estejam preenchidos antes de enviar.
-
-- Procure sempre manter o envio das ações de usuário o mais ***genérico*** possível. Toda a inteligência e complexidade do tratamento dos dados deve ficar centralizada na lib, e não nos repositórios das lojas.
-
-- Usar nomes de eventos semânticos e consistentes (ex: VIEW_CART, ADD_PAYMENT_INFO).
-
-- Manter os contextos enxutos, enviando apenas dados realmente necessários.
-
-- Cada novo evento deve ser registrado em `EVENTS` com seus destinos e parâmetros obrigatórios. Essa constante talvez venha a ser dinâmica dependendo da MARCA utilizada
-
-
-## Contribuição
-
-- Adicionar novos eventos em `EVENTS`.
-
-- Criar adapter correspondente caso seja necessário integrar com nova plataforma. Nesse caso deve-se avaliar qual será o serviço feito, o que será consumido, para onde será enviado.
-
-- Garantir que todos os parâmetros obrigatórios estejam mapeados nos getters/resolvers.
-
-- Executar build (npm run build) antes de testar no checkout/loja.
-
-## Authors
-
-- Lucas Soares
+# azzas-tracker-web
+
+Pacote interno para **Data Tracking** das lojas WEB, centralizando a captura e envio de eventos para diferentes plataformas de mídia (Meta, Dito, DataLayer, etc).  
+
+O objetivo é fornecer uma **camada única e consistente de tracking**, garantindo que todos os eventos sejam tratados, formatados e enviados de forma confiável.  
+
+E, principalmente, centralizar a complexidade e a “inteligência” de tracking **fora dos repositórios das lojas**.
+
+---
+
+## Fluxo do Tracking
+
+O pacote segue o seguinte fluxo de eventos:
+
+1. **User Action**  
+   Ações do usuário na loja (ex: adicionar ao carrinho, iniciar checkout, finalizar compra).  
+
+2. **Tracks**  
+   Ponto central que recebe o contexto do evento vindo da ação do usuário e encaminha para o *Formatter*.  
+
+3. **Formatter**  
+   Acessa a constante `EVENTS` e, baseado no contexto do evento, puxa os parâmetros obrigatórios e entrega a biblioteca de parâmetros (`/params`).  
+
+4. **Params Library**  
+   Contém **getters** e **resolvers** que garantem que os dados sejam legítimos e que todos os parâmetros sejam corretamente tratados.  
+
+5. **Adapters**  
+   Módulos responsáveis por enviar os dados formatados para cada destino (Meta, Datalayer, Dito, etc).  
+
+![FLUXOGRAMA](/public/fluxograma-lib-params.png)
+
+## Instalação
+
+
+```bash
+npm install /path/azzas-tracker-web
+```
+
+
+## Exemplos
+
+Listagem dos `EVENTS` e função orquestradora `trackWebEvent`:
+```javascript
+  const EVENTS = {
+    ADD_PERSONAL_INFO: {
+      name: 'add_personal_info',
+      destinations: ['DataLayer'],
+      requiredParams: ['brand', 'pre_filled', 'currency', 'value', 'subtotal'],
+    }, 
+    VIEW_CART: {
+      name: 'add_personal_info',
+      destinations: ['DataLayer', 'Meta', 'Dito'],
+      requiredParams: ['....'],
+    }
+  }
+
+  export async function trackWebEvent(event: EventName, context: EventContext = {}) {
+    try {
+      const parameters = await getParameters(context, event);
+      return await dispatchTrackEvent(event, parameters);
+    } catch (err) {
+      return console.error(`[DT] Error tracking event ${event}:`, err);
+    }
+  }
+```
+
+Uso básico da função no consumidor:
+
+
+```javascript
+  import { trackWebEvent } from 'azzas-tracker-web';
+
+  // DATA TRACKING | add_personal_info at submit (pre-filled always false)
+  // @see notion document for more details:
+  const form: Element = document.querySelector('xxxxxx');
+  if (form) {
+    form.addEventListener('submit', () => {
+      trackWebEvent('ADD_PERSONAL_INFO', { preFilled: false, orderForm: vtexjs.checkout.orderForm });
+    });
+  }
+```
+
+***OBS***: atente-se ao adicionar eventos novos e contribua na documentação do NOTION ou apenas DOCUMENTE em algum lugar! Seu futuro EU será grato 👍
+
+## Teste Local para Ambientes CDN/DENO
+
+Para testar alterações na biblioteca localmente, simulando a forma como ela é carregada por uma CDN (<script src="...">), use o script npm run dev:deno.
+
+Este comando realiza o build mais recente da biblioteca, empacota-o e inicia um servidor HTTP local usando o Deno para servir o arquivo
+
+1. Aqui nesse repositório, rode o script que inicia o servidor local:
+
+```bash
+  npm run dev:deno
+```
+
+O servidor será iniciado e começará a servir o seu arquivo de build no seguinte endereço: http://localhost:4507/.
+
+2. No Projeto Consumidor (DENO/FRONT):
+
+Altere o link do <script> no seu projeto para apontar para o servidor local.
+
+Você deve usar: <script src="http://localhost:4507/dist/mod.global.js"></script>
+
+
+## Boas Práticas
+- Sempre garantir que os `requiredParams` de cada evento estejam preenchidos antes de enviar.
+
+- Procure sempre manter o envio das ações de usuário o mais ***genérico*** possível. Toda a inteligência e complexidade do tratamento dos dados deve ficar centralizada na lib, e não nos repositórios das lojas.
+
+- Usar nomes de eventos semânticos e consistentes (ex: VIEW_CART, ADD_PAYMENT_INFO).
+
+- Manter os contextos enxutos, enviando apenas dados realmente necessários.
+
+- Cada novo evento deve ser registrado em `EVENTS` com seus destinos e parâmetros obrigatórios. Essa constante talvez venha a ser dinâmica dependendo da MARCA utilizada
+
+
+## Contribuição
+
+- Adicionar novos eventos em `EVENTS`.
+
+- Criar adapter correspondente caso seja necessário integrar com nova plataforma. Nesse caso deve-se avaliar qual será o serviço feito, o que será consumido, para onde será enviado.
+
+- Garantir que todos os parâmetros obrigatórios estejam mapeados nos getters/resolvers.
+
+- Executar build (npm run build) antes de testar no checkout/loja.
+
+## Authors
+
+- Lucas Soares

package/dist/mod.cjs

@@ -600,36 +600,6 @@ function getBrand(context, eventName) {
   }
 }
 
-// src/params/resolvers/items/fromOrderForm.ts
-async function itemsFromOrderForm(context) {
-  var _a;
-  const items = ((_a = context.orderForm) == null ? void 0 : _a.items) || [];
-  if (!items.length) return [];
-  return await Promise.all(
-    items.map(async (item) => {
-      var _a2, _b, _c, _d, _e, _f;
-      return {
-        item_id: item.productId,
-        item_category2: getItemCategory2(item),
-        item_category4: getItemCategory4(item),
-        item_shipping_tier: getItemShippingTier(context.orderForm, item),
-        price: parseFloat(((item == null ? void 0 : item.price) / 100).toFixed(2)) || 0,
-        quantity: item.quantity || 1,
-        item_ref: item.refId || null,
-        item_brand: normalizeBrand((_a2 = item.additionalInfo) == null ? void 0 : _a2.brandName) || ((_b = item.additionalInfo) == null ? void 0 : _b.brandName) || null,
-        item_sku: await getItemSku(item) || null,
-        item_name: (item == null ? void 0 : item.name.replace(item == null ? void 0 : item.skuName, "").trim()) || item.name || null,
-        item_category: getItemCategory(item) || null,
-        item_variant: ((_d = (_c = item == null ? void 0 : item.skuName) == null ? void 0 : _c.split(" - ")[0]) == null ? void 0 : _d.trim()) || "",
-        item_variant2: ((_f = (_e = item == null ? void 0 : item.skuName) == null ? void 0 : _e.split(" - ")[1]) == null ? void 0 : _f.trim()) || "",
-        item_url: `https://www.farmrio.com.br${item.detailUrl}` || null,
-        discount: getDiscount(item),
-        image_url: resizeVtexImage(item == null ? void 0 : item.image) || resizeVtexImage(item == null ? void 0 : item.imageUrl) || null
-      };
-    })
-  );
-}
-
 // src/params/utils/itemListAttribution.ts
 var LAST_SELECTED_ITEM_KEY = "last_selected_item";
 var STORAGE_VIEWED = "last_viewed_item";
@@ -721,6 +691,16 @@ function writeCartHistory(history) {
   } catch (e) {
   }
 }
+function getLatestItemListNameById(history) {
+  const byId = /* @__PURE__ */ new Map();
+  for (let index = history.length - 1; index >= 0; index -= 1) {
+    const entry = history[index];
+    if (!byId.has(entry.item_id)) {
+      byId.set(entry.item_id, entry.item_list_name);
+    }
+  }
+  return byId;
+}
 function saveSelectedItem(productId, listName) {
   if (productId == null || !listName) return;
   const payload = {
@@ -771,6 +751,18 @@ function appendCartHistory(productId, listName) {
   });
   writeCartHistory(history);
 }
+function getCartHistoryItemListNameMap() {
+  const history = readCartHistory();
+  if (!history.length) return null;
+  return getLatestItemListNameById(history);
+}
+function resolveItemListNameFromCartHistory(item, cartHistoryMap = null) {
+  const itemId = resolveIdFromUnknownItem(item);
+  const map = cartHistoryMap != null ? cartHistoryMap : getCartHistoryItemListNameMap();
+  if (!itemId) return void 0;
+  const resolved = map == null ? void 0 : map.get(itemId);
+  return resolved;
+}
 function pickSelectedItemFromResolvedItems(items, source) {
   var _a;
   if (!Array.isArray(items) || items.length === 0) return null;
@@ -789,6 +781,38 @@ function persistSelectItemOriginFromResolvedItems(items, source) {
   saveSelectedItem(productId, listName);
 }
 
+// src/params/resolvers/items/fromOrderForm.ts
+async function itemsFromOrderForm(context) {
+  var _a;
+  const items = ((_a = context.orderForm) == null ? void 0 : _a.items) || [];
+  const cartHistoryMap = getCartHistoryItemListNameMap();
+  if (!items.length) return [];
+  return await Promise.all(
+    items.map(async (item) => {
+      var _a2, _b, _c, _d, _e, _f, _g;
+      return {
+        item_id: item.productId,
+        item_category2: getItemCategory2(item),
+        item_category4: getItemCategory4(item),
+        item_shipping_tier: getItemShippingTier(context.orderForm, item),
+        price: parseFloat(((item == null ? void 0 : item.price) / 100).toFixed(2)) || 0,
+        quantity: item.quantity || 1,
+        item_ref: item.refId || null,
+        item_brand: normalizeBrand((_a2 = item.additionalInfo) == null ? void 0 : _a2.brandName) || ((_b = item.additionalInfo) == null ? void 0 : _b.brandName) || null,
+        item_sku: await getItemSku(item) || null,
+        item_name: (item == null ? void 0 : item.name.replace(item == null ? void 0 : item.skuName, "").trim()) || item.name || null,
+        item_category: getItemCategory(item) || null,
+        item_variant: ((_d = (_c = item == null ? void 0 : item.skuName) == null ? void 0 : _c.split(" - ")[0]) == null ? void 0 : _d.trim()) || "",
+        item_variant2: ((_f = (_e = item == null ? void 0 : item.skuName) == null ? void 0 : _e.split(" - ")[1]) == null ? void 0 : _f.trim()) || "",
+        item_url: `https://www.farmrio.com.br${item.detailUrl}` || null,
+        discount: getDiscount(item),
+        image_url: resizeVtexImage(item == null ? void 0 : item.image) || resizeVtexImage(item == null ? void 0 : item.imageUrl) || null,
+        item_list_name: (_g = resolveItemListNameFromCartHistory(item, cartHistoryMap)) != null ? _g : null
+      };
+    })
+  );
+}
+
 // src/params/resolvers/items/fromItem.ts
 async function itemsFromItem(context, event) {
   var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r;