@beworke/pixel 0.1.0-rc.6 → 0.1.0-rc.8

package/dist/examples/html-script/README.md

@@ -1,93 +1,37 @@
-# Pixel v2 — Playgrounds HTML (Commerce + AutoTrack)
+# Playground HTML — Pixel v2
 
-Playgrounds oficiais da frente **Commerce + AutoTrack Avançado** (Etapas 12L–14C).
+Exemplos HTML internos para validação manual do SDK.
 
-**Versão RC:** `@beworke/pixel` `0.1.0-rc.5` · Etapas 1–20 · contrato `config.commerce` + `auto.detectors[event].sources[]` + Core UrlContext
+## Pré-requisito
 
-> Playgrounds **internos** — podem usar APIs `@internal`. Para exemplos públicos, use [`examples/public/`](../public/).
+Na raiz do monorepo:
 
-Após `npm run build`, os mesmos arquivos ficam em:
-
-```txt
-dist/examples/html-script/
-```
-
-O bundle global usado pelos exemplos:
-
-```txt
-../../../dist/v2/global.global.js
+```bash
+pnpm --filter @beworke/pixel build
 ```
 
-Nome global IIFE: **`PixelV2`** (`Pixel`, `DEFAULT_PIXEL_CONFIG`, …).
-
----
-
-## Eventos (pastas)
+## Bundle global
 
-| Evento | Pasta | Cenários típicos |
-|--------|-------|------------------|
-| LEAD | `lead/` | click, auto, attribute |
-| ADD_TO_CART | `add-to-cart/` | attribute, click, auto, text, manual, dedupe, order-bump |
-| REMOVE_FROM_CART | `remove-from-cart/` | attribute, text, css, manual, state, dedupe, multi |
-| INITIATE_CHECKOUT | `initiate-checkout/` | attribute, click, submit, auto, text, manual, snapshot |
-| ADD_PAYMENT_INFO | `add-payment-info/` | autocomplete, fields, disabled, manual, dedupe, security, rules, data-track |
-| SEARCH | `search/` | attribute, button, input, submit, text, manual, dedupe |
-| VIEW_CONTENT | `view-content/` | attribute, product-card, text, css, manual, empty, dedupe |
+Os HTMLs referenciam o IIFE em:
 
-Cada pasta tem um `README.md` com o mapa dos cenários.
-
----
-
-## Exemplos gerais (raiz)
-
-```txt
-release-candidate.html     # Etapa 13A — consumidor real (script tag + API)
-RELEASE_CANDIDATE.md       # como consumir / testar o RC (14C fechamento)
-example-checkout-commerce.html  # checkout: form ATC → main_offer do cart
-example-landing-commerce.html  # landing_page + PAGE_VIEW enriquecido (14A)
-example-basic.html
-example-behavior.html
-example-conversion.html
-example-transport.html
-example-integration.html
-example-url-context.html              # checkout + upsell (15A)
-example-url-context-landing.html      # landing com sid gerado (15A)
-example-url-context-upsell.html       # upsell com forward params (15A)
-example-url-context-allowed-domains.html  # allowedDomains restrito (15A)
-example-runtime-diagnostics.html          # Etapa 16 — getDebugSnapshot()
-example-behavior-heartbeat.html           # Etapa 17 — Heartbeat Runtime
-example-behavior-viewport.html            # Etapa 18 — Viewport Runtime
-example-behavior-engagement.html          # Etapa 19 — Engagement Runtime
-example-behavior-runtime-intelligence.html # Etapa 20 — Runtime Intelligence
-full-funnel/                              # funil completo (15B) — contrato oficial commerce
+```text
+../../packages/pixel/dist/v2/global.global.js   (raiz do playground)
+../../../packages/pixel/dist/v2/global.global.js   (subpastas)
 ```
 
-Contratos nos exemplos:
+Após o build, abra os `.html` no navegador (servidor estático local recomendado).
 
-- `commerce` na raiz (`enabled`, `cart.initialItems`, `enrichment[event]`)
-- Auto via `sources[]` — **não** `selector`/`selectorForm` soltos no detector
-- Core UrlContext via `modules.core.urlContext` (`query_params`, `url_context`, link decoration)
+## AutoTrack — source `link`
 
----
+Nova source do Core: observa o **destino** de um `<a href>` (não a URL da página).
 
-## Smoke real (opcional)
+Exemplo dedicado:
 
-```bash
-# sem .env → skip seguro
-npm run test:smoke:real
-
-# com .env (não commitar):
-# PIXEL_REAL_API_SMOKE=true
-# PIXEL_API_ENDPOINT=https://...
-# PIXEL_ID=pix_...
-npm run test:smoke:real
+```text
+add-to-cart/example-add-to-cart-link.html
 ```
 
-Cobre os 8 eventos de conversão em modo Event (1 POST cada) e Batch (1 POST com N eventos).
-
----
-
-## Nota sobre `examples/v2/`
+Também presente em `example-landing-commerce.html` (CTA externo).
 
-O caminho histórico `examples/v2/` foi consolidado em `examples/html-script/`.  
-Um README em `examples/v2/` aponta para cá para compatibilidade documental.
+> **Legado:** na estrutura anterior ao monorepo, este diretório era `examples/html-script/`.  
+> No tarball npm, cópias transformadas ficam em `dist/examples/html-script/` com caminhos relativos ao `dist`.

package/dist/examples/html-script/RELEASE_CANDIDATE.md

@@ -5,24 +5,24 @@ Validação do pacote como **consumidor real** (script tag + bundle global + Tra
 ## Pré-requisitos
 
 ```bash
-npm run build
+pnpm --filter @beworke/pixel build
 ```
 
 Artefatos esperados:
 
 ```txt
-dist/v2/global.global.js          # IIFE → window.PixelV2
-dist/examples/html-script/        # playgrounds + esta página
-dist/index.esm.js / index.cjs.js  # ESM/CJS
-dist/index.d.ts                   # types
+packages/pixel/dist/v2/global.global.js          # IIFE → window.PixelV2
+packages/pixel/dist/examples/html-script/        # cópia empacotada dos playgrounds
+packages/pixel/dist/index.esm.js / index.cjs.js
+packages/pixel/dist/index.d.ts
 ```
 
 ## Abrir a página RC
 
 ```txt
-examples/html-script/release-candidate.html
-# ou pós-build:
-dist/examples/html-script/release-candidate.html
+apps/playground-html/release-candidate.html
+# ou pós-build (tarball / dist):
+packages/pixel/dist/examples/html-script/release-candidate.html
 ```
 
 Abra no navegador (file:// ou servidor estático).
@@ -39,7 +39,7 @@ Abra no navegador (file:// ou servidor estático).
 Valores ficam em `localStorage` (`pixel_rc_conn`) — **não commitar `.env`**.
 
 3. Escolha **Event** (`batchSize=1`) ou **Batch** (`batchSize=10`).
-4. Sender **HTTP** (API real) ou **Mock**.
+4. Sender **internal** (API pública) ou **test** (sem rede).
 5. Clique **Init**.
 
 ## O que a página valida
@@ -83,17 +83,15 @@ Ver `example-checkout-commerce.html` / `release-candidate.html` para checkout co
     identity: { ...DEFAULT_PIXEL_CONFIG.identity, pixelId: 'pix_xxx' },
     transport: {
       ...DEFAULT_PIXEL_CONFIG.transport,
-      apiEndpoint: 'https://sua-api.example.com',
+      enabled: true,
+      sender: {
+        mode: 'internal',
+        baseUrl: 'https://sua-api.example.com',
+      },
     },
     modules: {
       ...DEFAULT_PIXEL_CONFIG.modules,
       conversion: { ...DEFAULT_PIXEL_CONFIG.modules.conversion, enabled: true },
-      transport: {
-        ...DEFAULT_PIXEL_CONFIG.modules.transport,
-        enabled: true,
-        mockSender: { enabled: false },
-        sender: { mode: 'http' },
-      },
     },
   });
   await pixel.init();
@@ -104,9 +102,10 @@ Ver `example-checkout-commerce.html` / `release-candidate.html` para checkout co
 
 ```bash
 pnpm add @beworke/pixel
-# ou validar tarball local:
-npm pack
-# npm install ./beworke-pixel-0.1.0-rc.4.tgz
+# ou validar tarball local (fluxo oficial do monorepo):
+pnpm pack:pixel
+pnpm validate:pixel-package
+# npm install ./artifacts/beworke-pixel-VERSAO.tgz
 ```
 
 ```ts
@@ -118,7 +117,7 @@ Exports: ver `package.json` → `exports` (`.` / `./global` / `./v2` / `./config
 ## Smoke automatizado (complementar)
 
 ```bash
-npm run test:smoke:real          # skip seguro sem .env
+pnpm --filter @beworke/pixel test:smoke:real          # skip seguro sem .env
 # com .env: Event 8× ACK + Batch 8 eventos
 ```
 
@@ -132,4 +131,4 @@ A etapa 13A está **pronta para RC** quando:
 4. HTTP Event/Batch com ACK (se endpoint disponível)  
 5. destroy/reinit sem duplicar listeners  
 
-Pendências futuras: `PIXEL_V2_BACKLOG_PENDENCIAS_ISOLADO.md` (P1/P2).
+Pendências futuras: `PLAN_PIXEL/PIXEL_V2_BACKLOG_PENDENCIAS_ISOLADO.md` (P1/P2).

package/dist/examples/html-script/add-payment-info/example-add-payment-info-card-autocomplete.html

@@ -180,7 +180,7 @@ code { font-size: 0.85em; }
       </div>
     </div>
 
-    <script src="../../../dist/v2/global.global.js"></script>
+    <script src="../../../v2/global.global.js"></script>
     <script>
       const { Pixel, DEFAULT_PIXEL_CONFIG } = window.PixelV2;
       const API_ENDPOINT =
@@ -243,9 +243,46 @@ code { font-size: 0.85em; }
             debug: true,
           },
           transport: {
-            ...DEFAULT_PIXEL_CONFIG.transport,
-            apiEndpoint: API_ENDPOINT,
-            timeoutMs: 10000,
+            ...base.transport,
+            enabled: true,
+            sender: { mode: 'internal', baseUrl: API_ENDPOINT },
+            persistence: { enabled: true },
+            replay: { enabled: true },
+            ordering: { enabled: true },
+            coordination: { enabled: true },
+            circuitBreaker: {
+              enabled: true,
+              failureThreshold: 5,
+              resetTimeoutMs: 30000,
+              halfOpenMaxAttempts: 2,
+            },
+            backpressure: {
+              enabled: true,
+              maxQueueSize: 500,
+              policy: 'drop_oldest',
+              sampleRate: 0.5,
+            },
+            deadLetter: { enabled: true, maxEntries: 200 },
+            compression: { enabled: true, strategy: 'identity' },
+            retry: {
+              enabled: true,
+              maxAttempts: 4,
+              baseDelayMs: 500,
+              maxDelayMs: 4000,
+              multiplier: 2,
+            },
+            batch: {
+              enabled: true,
+              batchSize: 10,
+              maxWaitMs: 5000,
+            },
+            timeout: { enabled: true, timeoutMs: 10000 },
+            offline: { enabled: true },
+            flush: {
+              enabled: true,
+              flushOnDestroy: true,
+              prepareUnloadHooks: true,
+            },
           },
           identity: { ...base.identity, pixelId: PIXEL_ID },
           commerce: {
@@ -301,50 +338,6 @@ code { font-size: 0.85em; }
             },
             behavior: { ...base.modules.behavior, enabled: false },
             privacy: { ...base.modules.privacy, enabled: false },
-            transport: {
-              enabled: true,
-              mockSender: { enabled: false },
-              sender: { mode: 'http' },
-              persistence: { enabled: true },
-              replay: { enabled: true },
-              ordering: { enabled: true },
-              coordination: { enabled: true },
-              circuitBreaker: {
-                enabled: true,
-                failureThreshold: 5,
-                resetTimeoutMs: 30000,
-                halfOpenMaxAttempts: 2,
-              },
-              backpressure: {
-                enabled: true,
-                maxQueueSize: 500,
-                policy: 'drop_oldest',
-                sampleRate: 0.5,
-              },
-              deadLetter: { enabled: true, maxEntries: 200 },
-              compression: { enabled: true, strategy: 'identity' },
-              retry: {
-                enabled: true,
-                maxAttempts: 4,
-                baseDelayMs: 500,
-                maxDelayMs: 4000,
-                multiplier: 2,
-              },
-              batch: {
-                enabled: true,
-                batchSize: 10,
-                flushIntervalMs: 2000,
-                maxWaitMs: 5000,
-              },
-              timeout: { enabled: true, timeoutMs: 10000 },
-              offline: { enabled: true },
-              flush: {
-                enabled: true,
-                flushIntervalMs: 2000,
-                flushOnDestroy: true,
-                prepareUnloadHooks: true,
-              },
-            },
             integrations: { ...base.modules.integrations, enabled: false },
             conversion: {
               enabled: true,

package/dist/examples/html-script/add-payment-info/example-add-payment-info-card-disabled.html

@@ -159,7 +159,7 @@ code { font-size: 0.85em; }
       </div>
     </div>
 
-    <script src="../../../dist/v2/global.global.js"></script>
+    <script src="../../../v2/global.global.js"></script>
     <script>
       const { Pixel, DEFAULT_PIXEL_CONFIG } = window.PixelV2;
       const API_ENDPOINT =
@@ -222,9 +222,46 @@ code { font-size: 0.85em; }
             debug: true,
           },
           transport: {
-            ...DEFAULT_PIXEL_CONFIG.transport,
-            apiEndpoint: API_ENDPOINT,
-            timeoutMs: 10000,
+            ...base.transport,
+            enabled: true,
+            sender: { mode: 'internal', baseUrl: API_ENDPOINT },
+            persistence: { enabled: true },
+            replay: { enabled: true },
+            ordering: { enabled: true },
+            coordination: { enabled: true },
+            circuitBreaker: {
+              enabled: true,
+              failureThreshold: 5,
+              resetTimeoutMs: 30000,
+              halfOpenMaxAttempts: 2,
+            },
+            backpressure: {
+              enabled: true,
+              maxQueueSize: 500,
+              policy: 'drop_oldest',
+              sampleRate: 0.5,
+            },
+            deadLetter: { enabled: true, maxEntries: 200 },
+            compression: { enabled: true, strategy: 'identity' },
+            retry: {
+              enabled: true,
+              maxAttempts: 4,
+              baseDelayMs: 500,
+              maxDelayMs: 4000,
+              multiplier: 2,
+            },
+            batch: {
+              enabled: true,
+              batchSize: 10,
+              maxWaitMs: 5000,
+            },
+            timeout: { enabled: true, timeoutMs: 10000 },
+            offline: { enabled: true },
+            flush: {
+              enabled: true,
+              flushOnDestroy: true,
+              prepareUnloadHooks: true,
+            },
           },
           identity: { ...base.identity, pixelId: PIXEL_ID },
           commerce: {
@@ -280,50 +317,6 @@ code { font-size: 0.85em; }
             },
             behavior: { ...base.modules.behavior, enabled: false },
             privacy: { ...base.modules.privacy, enabled: false },
-            transport: {
-              enabled: true,
-              mockSender: { enabled: false },
-              sender: { mode: 'http' },
-              persistence: { enabled: true },
-              replay: { enabled: true },
-              ordering: { enabled: true },
-              coordination: { enabled: true },
-              circuitBreaker: {
-                enabled: true,
-                failureThreshold: 5,
-                resetTimeoutMs: 30000,
-                halfOpenMaxAttempts: 2,
-              },
-              backpressure: {
-                enabled: true,
-                maxQueueSize: 500,
-                policy: 'drop_oldest',
-                sampleRate: 0.5,
-              },
-              deadLetter: { enabled: true, maxEntries: 200 },
-              compression: { enabled: true, strategy: 'identity' },
-              retry: {
-                enabled: true,
-                maxAttempts: 4,
-                baseDelayMs: 500,
-                maxDelayMs: 4000,
-                multiplier: 2,
-              },
-              batch: {
-                enabled: true,
-                batchSize: 10,
-                flushIntervalMs: 2000,
-                maxWaitMs: 5000,
-              },
-              timeout: { enabled: true, timeoutMs: 10000 },
-              offline: { enabled: true },
-              flush: {
-                enabled: true,
-                flushIntervalMs: 2000,
-                flushOnDestroy: true,
-                prepareUnloadHooks: true,
-              },
-            },
             integrations: { ...base.modules.integrations, enabled: false },
             conversion: {
               enabled: true,

package/dist/examples/html-script/add-payment-info/example-add-payment-info-card-fields.html

@@ -172,7 +172,7 @@ code { font-size: 0.85em; }
       </div>
     </div>
 
-    <script src="../../../dist/v2/global.global.js"></script>
+    <script src="../../../v2/global.global.js"></script>
     <script>
       const { Pixel, DEFAULT_PIXEL_CONFIG } = window.PixelV2;
       const API_ENDPOINT =
@@ -235,9 +235,46 @@ code { font-size: 0.85em; }
             debug: true,
           },
           transport: {
-            ...DEFAULT_PIXEL_CONFIG.transport,
-            apiEndpoint: API_ENDPOINT,
-            timeoutMs: 10000,
+            ...base.transport,
+            enabled: true,
+            sender: { mode: 'internal', baseUrl: API_ENDPOINT },
+            persistence: { enabled: true },
+            replay: { enabled: true },
+            ordering: { enabled: true },
+            coordination: { enabled: true },
+            circuitBreaker: {
+              enabled: true,
+              failureThreshold: 5,
+              resetTimeoutMs: 30000,
+              halfOpenMaxAttempts: 2,
+            },
+            backpressure: {
+              enabled: true,
+              maxQueueSize: 500,
+              policy: 'drop_oldest',
+              sampleRate: 0.5,
+            },
+            deadLetter: { enabled: true, maxEntries: 200 },
+            compression: { enabled: true, strategy: 'identity' },
+            retry: {
+              enabled: true,
+              maxAttempts: 4,
+              baseDelayMs: 500,
+              maxDelayMs: 4000,
+              multiplier: 2,
+            },
+            batch: {
+              enabled: true,
+              batchSize: 10,
+              maxWaitMs: 5000,
+            },
+            timeout: { enabled: true, timeoutMs: 10000 },
+            offline: { enabled: true },
+            flush: {
+              enabled: true,
+              flushOnDestroy: true,
+              prepareUnloadHooks: true,
+            },
           },
           identity: { ...base.identity, pixelId: PIXEL_ID },
           commerce: {
@@ -293,50 +330,6 @@ code { font-size: 0.85em; }
             },
             behavior: { ...base.modules.behavior, enabled: false },
             privacy: { ...base.modules.privacy, enabled: false },
-            transport: {
-              enabled: true,
-              mockSender: { enabled: false },
-              sender: { mode: 'http' },
-              persistence: { enabled: true },
-              replay: { enabled: true },
-              ordering: { enabled: true },
-              coordination: { enabled: true },
-              circuitBreaker: {
-                enabled: true,
-                failureThreshold: 5,
-                resetTimeoutMs: 30000,
-                halfOpenMaxAttempts: 2,
-              },
-              backpressure: {
-                enabled: true,
-                maxQueueSize: 500,
-                policy: 'drop_oldest',
-                sampleRate: 0.5,
-              },
-              deadLetter: { enabled: true, maxEntries: 200 },
-              compression: { enabled: true, strategy: 'identity' },
-              retry: {
-                enabled: true,
-                maxAttempts: 4,
-                baseDelayMs: 500,
-                maxDelayMs: 4000,
-                multiplier: 2,
-              },
-              batch: {
-                enabled: true,
-                batchSize: 10,
-                flushIntervalMs: 2000,
-                maxWaitMs: 5000,
-              },
-              timeout: { enabled: true, timeoutMs: 10000 },
-              offline: { enabled: true },
-              flush: {
-                enabled: true,
-                flushIntervalMs: 2000,
-                flushOnDestroy: true,
-                prepareUnloadHooks: true,
-              },
-            },
             integrations: { ...base.modules.integrations, enabled: false },
             conversion: {
               enabled: true,

package/dist/examples/html-script/add-payment-info/example-add-payment-info-data-track.html

@@ -161,7 +161,7 @@ code { font-size: 0.85em; }
       </div>
     </div>
 
-    <script src="../../../dist/v2/global.global.js"></script>
+    <script src="../../../v2/global.global.js"></script>
     <script>
       const { Pixel, DEFAULT_PIXEL_CONFIG } = window.PixelV2;
       const API_ENDPOINT =
@@ -232,9 +232,46 @@ code { font-size: 0.85em; }
             debug: true,
           },
           transport: {
-            ...DEFAULT_PIXEL_CONFIG.transport,
-            apiEndpoint: API_ENDPOINT,
-            timeoutMs: 10000,
+            ...base.transport,
+            enabled: true,
+            sender: { mode: 'internal', baseUrl: API_ENDPOINT },
+            persistence: { enabled: true },
+            replay: { enabled: true },
+            ordering: { enabled: true },
+            coordination: { enabled: true },
+            circuitBreaker: {
+              enabled: true,
+              failureThreshold: 5,
+              resetTimeoutMs: 30000,
+              halfOpenMaxAttempts: 2,
+            },
+            backpressure: {
+              enabled: true,
+              maxQueueSize: 500,
+              policy: 'drop_oldest',
+              sampleRate: 0.5,
+            },
+            deadLetter: { enabled: true, maxEntries: 200 },
+            compression: { enabled: true, strategy: 'identity' },
+            retry: {
+              enabled: true,
+              maxAttempts: 4,
+              baseDelayMs: 500,
+              maxDelayMs: 4000,
+              multiplier: 2,
+            },
+            batch: {
+              enabled: true,
+              batchSize: 10,
+              maxWaitMs: 5000,
+            },
+            timeout: { enabled: true, timeoutMs: 10000 },
+            offline: { enabled: true },
+            flush: {
+              enabled: true,
+              flushOnDestroy: true,
+              prepareUnloadHooks: true,
+            },
           },
           identity: { ...base.identity, pixelId: PIXEL_ID },
           commerce: {
@@ -290,50 +327,6 @@ code { font-size: 0.85em; }
             },
             behavior: { ...base.modules.behavior, enabled: false },
             privacy: { ...base.modules.privacy, enabled: false },
-            transport: {
-              enabled: true,
-              mockSender: { enabled: false },
-              sender: { mode: 'http' },
-              persistence: { enabled: true },
-              replay: { enabled: true },
-              ordering: { enabled: true },
-              coordination: { enabled: true },
-              circuitBreaker: {
-                enabled: true,
-                failureThreshold: 5,
-                resetTimeoutMs: 30000,
-                halfOpenMaxAttempts: 2,
-              },
-              backpressure: {
-                enabled: true,
-                maxQueueSize: 500,
-                policy: 'drop_oldest',
-                sampleRate: 0.5,
-              },
-              deadLetter: { enabled: true, maxEntries: 200 },
-              compression: { enabled: true, strategy: 'identity' },
-              retry: {
-                enabled: true,
-                maxAttempts: 4,
-                baseDelayMs: 500,
-                maxDelayMs: 4000,
-                multiplier: 2,
-              },
-              batch: {
-                enabled: true,
-                batchSize: 10,
-                flushIntervalMs: 2000,
-                maxWaitMs: 5000,
-              },
-              timeout: { enabled: true, timeoutMs: 10000 },
-              offline: { enabled: true },
-              flush: {
-                enabled: true,
-                flushIntervalMs: 2000,
-                flushOnDestroy: true,
-                prepareUnloadHooks: true,
-              },
-            },
             integrations: { ...base.modules.integrations, enabled: false },
             conversion: {
               enabled: true,