mkfashion-sdk 2.7.0 → 2.7.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mkfashion-sdk",
-  "version": "2.7.0",
+  "version": "2.7.2",
   "description": "SDK para integrar o provador virtual mKFashion com suporte a Wake Commerce e tracking analytics completo",
   "main": "src/mkfashion.js",
   "scripts": {

package/src/mkfashion.js

@@ -305,12 +305,17 @@ const mkfashion = {
       this._log('Disponibilidade recebida', data)
 
       // NOTA: availability check é decisão interna (mostra botão ou não) e
-      // NÃO é emitido pro collector — não traz valor analítico. O sinal de
-      // "impressão" vem do auto-tracking (page_view), e o sinal de "produto
-      // tem try-on" vem do page_button_rendered no init().
-      // Apenas inicializa _config pra que o auto-tracking saiba quem é o projeto.
+      // NÃO emite evento pro collector — não traz valor analítico.
+      //
+      // MAS é o gatilho mais comum em PDPs: a partir daqui temos projectId
+      // confirmado e ativamos o auto-tracking (page_view, click, scroll,
+      // form, engagement). Sem isso, páginas onde o usuário só visualiza
+      // (sem clicar no try-on) ficariam invisíveis no collector.
       try {
         if (!this._config) this._config = { projectId: resolved, identifier }
+        if (!this._autoTrackInitialized && this.autoTrack !== false) {
+          this._initAutoTrack()
+        }
       } catch (_) {}
 
       return data
@@ -453,10 +458,17 @@ const mkfashion = {
            String(projectId).toLowerCase() === 'gregory'
   },
 
+  // Eventos que NÃO devem virar evento analítico no collector — geralmente
+  // redundantes ou de baixo valor. O callback do cliente segue funcionando.
+  _skipCollectorEvents: ['onReady'],
+
   _triggerCallback(name, data = null) {
-    // Emite pro collector ANTES do callback do cliente (não bloqueia, fire-and-forget).
-    try { this._emitToCollector(name, data) } catch (_) {}
+    // Emite pro collector ANTES do callback do cliente, mas pula os bloqueados.
+    if (!this._skipCollectorEvents || this._skipCollectorEvents.indexOf(name) === -1) {
+      try { this._emitToCollector(name, data) } catch (_) {}
+    }
 
+    // Callback do cliente recebe data ORIGINAL (sem sanitização — pra imagens etc).
     if (this._callbacks && typeof this._callbacks[name] === 'function') {
       try {
         this._callbacks[name](data)
@@ -467,6 +479,37 @@ const mkfashion = {
     }
   },
 
+  /**
+   * Remove campos pesados/inúteis pro collector mantendo o data original
+   * intacto pro callback do cliente. Aplicado em todo evento que vai pro
+   * /v1/track/sdk.
+   *
+   * Regras:
+   *   - Campos de imagem (imageUrl/image/thumbnail/photo) viram <key>Present: boolean
+   *   - Strings > 2KB são truncadas com sufixo informativo
+   *   - Objetos são percorridos rasamente (1 nível) — campos aninhados são preservados
+   */
+  _sanitizeForCollector(data) {
+    if (!data || typeof data !== 'object' || Array.isArray(data)) return data
+    const HEAVY_KEYS = { imageUrl: 1, image: 1, thumbnail: 1, photo: 1, imageBase64: 1 }
+    const MAX_STRING_LEN = 2000
+    const out = {}
+    for (const k in data) {
+      if (!Object.prototype.hasOwnProperty.call(data, k)) continue
+      const v = data[k]
+      if (HEAVY_KEYS[k]) {
+        out[k + 'Present'] = !!v
+        continue
+      }
+      if (typeof v === 'string' && v.length > MAX_STRING_LEN) {
+        out[k] = v.slice(0, 200) + '...[truncated ' + v.length + 'B]'
+        continue
+      }
+      out[k] = v
+    }
+    return out
+  },
+
   // ============ TRACKING (mk-collector-api) ============
 
   _visitorId: null,
@@ -656,15 +699,17 @@ const mkfashion = {
 
   /**
    * Adiciona ao buffer de batch. Flush é disparado por timer ou tamanho.
-   * Todos os eventos recebem prefixo 'page_'.
+   * Todos os eventos recebem prefixo 'page_'. Aplica _sanitizeForCollector
+   * pra remover campos pesados (imageUrl etc) antes de enviar.
    */
   _queueEvent(eventName, data, tsOverride) {
     this._eventQueue = this._eventQueue || []
+    const sanitized = this._sanitizeForCollector(data)
     const params = { identifier: this._config.identifier || null }
-    if (data && typeof data === 'object' && !Array.isArray(data)) {
-      Object.assign(params, data)
-    } else if (data !== null && data !== undefined) {
-      params.value = data
+    if (sanitized && typeof sanitized === 'object' && !Array.isArray(sanitized)) {
+      Object.assign(params, sanitized)
+    } else if (sanitized !== null && sanitized !== undefined) {
+      params.value = sanitized
     }
     this._eventQueue.push({
       name: 'page_' + this._normalizeEventName(eventName),