@beworke/pixel-bemony 0.1.0-rc.1

package/CHANGELOG.md

@@ -0,0 +1,157 @@
+# Changelog — `@beworke/pixel-bemony`
+
+## 0.1.0-rc.1 — First public RC
+
+Primeira publicação npm para validação em funis reais.
+
+### Highlights
+
+- Cenários: `offer-page`, `checkout`, `upsell-offer`, `one-click-checkout`, `thank-you`
+- Auto-init browser (IIFE): `data-funnel-id` como chave do pixel; `data-pixel-id` com precedência no checkout
+- Dependência de runtime: `@beworke/pixel` `>=0.1.0-rc.7`
+- Tags npm: `rc` + `latest`
+
+## Unreleased — Remoção do enriquecimento browser / catálogo
+
+### Breaking
+
+- Removida toda a infraestrutura de resolução remota de contexto/catálogo (`src/context/`)
+- Removidos `getResolvedContext`, `getPriceCatalog`, `BEMONY_SCENARIO_AUTO_RESOLVE_CONTEXT`, mock resolver
+- Identidade comercial canônica: `priceCode` (`priceId` deprecated)
+- `declineUpsell` não consulta navegação remota — usar `navigateTo`
+
+### Added
+
+- `resolvePriceCode`, `extractPriceCodeFromUrl`
+- Docs `BROWSER_EVENT_ENRICHMENT.md`
+- Exemplos `*-price-code.html`
+- Testes `browser-price-code.test.ts`
+
+### Changed
+
+- Bootstrap: journey → config → Core init (sem fase de resolução)
+- Eventos browser transportam `priceCode` via `productId` genérico do Core
+
+## Unreleased — B11 URL context + LinkAutoSource + afid
+
+### Added
+
+- `BEMONY_DEFAULT_ALLOWED_DOMAINS` (`security.bemony.com`)
+- Managed param `afid` (lê/persiste/propaga; **nunca gera**)
+- `createBemonyOfferLinkSource` — ADD_TO_CART por destino `/offer_*` sem data attributes
+- Decoração de links somente por `allowedDomains` (sem selector Bemony)
+- Exemplos `url-context-navigation.html` e CTAs HTML puros
+- Testes `browser.url-context-propagation.test.ts`
+- Hardening Core: `LinkDecorator` managed vs forwarded; prefix pathname `/offer_`
+
+### Changed
+
+- `configureBemonyLinks`: denylist Bemony aplicada; `mergeDefaultDenylist: true`; sem `allowlist: ['*']`
+- `offer-page` habilita auto `ADD_TO_CART` via LinkAutoSource
+- Docs: sid vs afid vs session_id; CTAs sem data-*
+
+## Unreleased — B10 Default global auto-init + HTTP
+
+### Added
+
+- Defaults públicos: `BEMONY_DEFAULT_API_ENDPOINT`, `BEMONY_BROWSER_AUTO_INIT_DEFAULTS`
+- Auto-init por padrão no IIFE `pixel-bemony.global.js` (opt-out `data-auto-init="false"`)
+- `window.BemonyPixel.ready` / `whenReady()`
+- Eventos `bemony:pixel:ready` / `bemony:pixel:error`
+- Leitura de `data-funnel-step-id`
+- `resolveBemonyExecutingScript` (currentScript → src → legado)
+- Testes `browser.default-autoinit-http.test.ts` (HTTP com fetch mock)
+- Smoke opt-in `BEMONY_REAL_API_SMOKE=1`
+
+### Changed
+
+- Precedência: defaults → window config → data-* → explicit (merge campo a campo)
+- Exemplos HTML mínimos sem markers obrigatórios
+- Docs: README, TROUBLESHOOTING, TEST_MATRIX, lifecycle package doc
+
+### Notes
+
+- Factory programática `development` + mock preservada
+- Endpoint padrão é infraestrutura pública (não credencial)
+- Core continua compondo `/pixels/public/event` e `/batch`
+
+## Unreleased — B9 Hardening / docs / release interno
+
+### Added
+
+- README completo (cenários, segurança, exports, quick start)
+- `docs/SCENARIOS.md`, `docs/TROUBLESHOOTING.md`, `docs/SECURITY_LIMITATIONS.md`, `docs/TEST_MATRIX.md`
+- `RELEASE_CANDIDATE.md` (proposta `0.1.0-rc.1`, compat Core, naming)
+- Export `./global` (IIFE)
+- Pack/validate/smoke internos (`pack:pixel-bemony`, etc.)
+- `examples/` e `docs/` incluídos no tarball (`files`)
+
+### Changed
+
+- `clearBootstrapStoreForTests` removido da API pública de `/browser` (permanece interno ao módulo)
+
+### Notes
+
+- Sem publish npm
+- Sem alteração de `version` (`0.0.0`)
+- Gates B1–B8 + B9 verdes
+
+## Unreleased — B8 Browser bootstrap / auto-init
+
+### Added
+
+- `@beworke/pixel-bemony/browser` — `bootstrapBemonyPixel`, `installBemonyPixelAutoInit`
+- IIFE `dist/browser/pixel-bemony.global.js` → `window.BemonyPixel`
+- Precedência: explicit → `data-*` → `window.BemonyPixelConfig`
+- Exemplo `examples/browser-bootstrap.html`
+
+## Unreleased — B7 Thank-you + contrato backend
+
+### Added
+
+- Cenário `thank-you` (PAGE_VIEW only)
+- Tipos PLACEHOLDER + validators de redirect/purchase server
+- `docs/BACKEND_PURCHASE_AND_REDIRECTS.md`
+- Exemplo `examples/thank-you.html`
+
+## Unreleased — B6 One-click checkout
+
+### Added
+
+- Cenário `one-click-checkout`
+- `trackOneClickConfirmation`, `withOneClickPaymentContext`
+- Token efêmero privado (não em config/snapshot)
+
+## Unreleased — B5 Upsell / downsell
+
+### Added
+
+- Cenário `upsell-offer`
+- `viewUpsell`, `acceptUpsell`, `declineUpsell` (decline sem evento Core)
+
+## Unreleased — B4 Checkout
+
+### Added
+
+- Cenário `checkout`
+- Lead, order bumps, `trackPaymentMethod` (enum only)
+
+## Unreleased — B3 Offer page
+
+### Added
+
+- Cenário `offer-page`
+- `viewOffer`, `selectOffer`, `getPublicSessionId`
+
+## Unreleased — B2 Lifecycle / factory
+
+### Added
+
+- `BemonyPixel`, `createBemonyPixel`
+- Estados `created` … `destroyed` / `failed`
+
+## Unreleased — B1 Fundação
+
+### Added
+
+- `createBemonyPixelConfig`, contratos de página, link policy, ambientes

package/README.md

@@ -0,0 +1,176 @@
+# @beworke/pixel-bemony
+
+Camada tipada da **Bemony** sobre [`@beworke/pixel`](../pixel).
+
+| Campo | Valor |
+|---|---|
+| Status | **privado** (`private: true`) — não publicar |
+| Versão no workspace | `0.0.0` |
+| RC proposta | `0.1.0-rc.1` (ver [`RELEASE_CANDIDATE.md`](./RELEASE_CANDIDATE.md)) |
+| Core mínimo proposto | `@beworke/pixel@0.1.0-rc.6` |
+
+## Objetivo
+
+API de domínio para os cinco cenários do funil Bemony, lifecycle explícito e bootstrap browser com auto-init HTTP no bundle global — sem duplicar visitor/session/attribution do Core e sem purchase no browser por default.
+
+## Instalação (interna / monorepo)
+
+```bash
+pnpm --filter @beworke/pixel-bemony build
+# Artifact interno (não npm publish):
+pnpm pack:pixel-bemony
+pnpm validate:pixel-bemony-package
+pnpm smoke:pixel-bemony-package
+```
+
+Dependência atual no workspace: `"@beworke/pixel": "workspace:*"`.
+
+## Quick start (script mínimo)
+
+```html
+<script
+  src="pixel-bemony.global.js"
+  data-funnel-id="funnel_1"
+  data-funnel-step-id="step_1"
+></script>
+
+<a href="https://security.bemony.com/pri6670988">Comprar agora</a>
+```
+
+Isso inicializa automaticamente com:
+
+- `environment: production`
+- `scenario: offer-page`
+- `pixelId: pix_7704308` / `namespace: bemony-web`
+- transport HTTP + `BEMONY_DEFAULT_API_ENDPOINT`
+- `allowedDomains: [security.bemony.com]`
+- `sid` gerado/lido + `afid` lido (nunca gerado)
+- `PAGE_VIEW` inicial via Core
+- clique em `/pri*` → ADD_TO_CART (`productId` = último segmento do path)
+
+CTAs **não** usam `data-bemony-offer`. Decoração = hostname permitido; evento = `LinkAutoSource`.
+
+```js
+const pixel = await window.BemonyPixel.whenReady();
+```
+
+Opt-out: `data-auto-init="false"`.
+
+Servir exemplos por HTTP local (não `file://`):
+
+```bash
+pnpm dlx serve packages/pixel-bemony
+```
+
+## Quick start (programático)
+
+```typescript
+import { createBemonyPixel } from '@beworke/pixel-bemony';
+
+const pixel = await createBemonyPixel({
+  environment: 'development',
+  scenario: 'offer-page',
+  platform: {
+    pixelId: 'bemony-web',
+    allowedDomains: ['checkout.bemony.com'],
+  },
+  page: { public: { pageId: 'vsl-main', funnelId: 'funnel_1' } },
+});
+
+pixel.selectOffer({ priceCode: 'pri_123' });
+```
+
+> O Pixel extrai `priceCode` do link ou da API de domínio.
+> Nenhuma consulta de catálogo é executada; o backend enriquece o evento.
+> Ver [`docs/BROWSER_EVENT_ENRICHMENT.md`](./docs/BROWSER_EVENT_ENRICHMENT.md).
+
+Entry principal **sem side effects**. Bootstrap/auto-init ESM:
+
+```typescript
+import { bootstrapBemonyPixel } from '@beworke/pixel-bemony/browser';
+```
+
+Global IIFE: `@beworke/pixel-bemony/global` → `window.BemonyPixel`.
+
+## Defaults públicos
+
+| Constante | Valor |
+|---|---|
+| `BEMONY_DEFAULT_API_ENDPOINT` | `https://micro-service-pixel-production-4826.up.railway.app` |
+| `BEMONY_DEFAULT_PIXEL_ID` | `pix_7704308` |
+| `BEMONY_DEFAULT_NAMESPACE` | `bemony-web` |
+| `BEMONY_DEFAULT_ALLOWED_DOMAINS` | `['security.bemony.com']` |
+| `BEMONY_DEFAULT_BROWSER_ENVIRONMENT` | `production` |
+| `BEMONY_DEFAULT_BROWSER_SCENARIO` | `offer-page` |
+
+O endpoint é configuração pública de infraestrutura (não credencial). O Core acrescenta `/pixels/public/event` e `/pixels/public/event/batch`.
+
+## Cenários
+
+| Cenário | Métodos principais | Notas |
+|---|---|---|
+| `offer-page` | `selectOffer`, `getPublicSessionId` | links `/pri*` → ADD_TO_CART |
+| `checkout` | `startCheckout`, `captureLead`, bumps, `trackPaymentMethod` | auto INITIATE_CHECKOUT |
+| `upsell-offer` | `viewUpsell`, `acceptUpsell`, `declineUpsell` | upsell e downsell |
+| `one-click-checkout` | `trackOneClickConfirmation`, `setPublicOrderId` | sem token no Pixel |
+| `thank-you` | `getPublicOrderId` | PAGE_VIEW; sem purchase browser |
+
+Guias: [`docs/SCENARIOS.md`](./docs/SCENARIOS.md).  
+Browser → backend: [`docs/BROWSER_EVENT_ENRICHMENT.md`](./docs/BROWSER_EVENT_ENRICHMENT.md).  
+Backend / redirects: [`docs/BACKEND_PURCHASE_AND_REDIRECTS.md`](./docs/BACKEND_PURCHASE_AND_REDIRECTS.md).
+
+> O Pixel Bemony não consulta catálogo durante a inicialização.
+> Os eventos transportam o `priceCode` observado; o backend enriquece.
+
+## Segurança (resumo)
+
+- Token one-click **nunca** no Pixel (pagamento no backend/app).
+- Purchase browser **desabilitado** em todos os presets.
+- Sem dados de cartão no Pixel.
+- Detalhes: [`docs/SECURITY_LIMITATIONS.md`](./docs/SECURITY_LIMITATIONS.md).
+
+## Relação com o Core
+
+| Responsabilidade | Onde |
+|---|---|
+| Visitor / session / sid / UrlContext | `@beworke/pixel` |
+| Domínio Bemony + cenários + bootstrap | `@beworke/pixel-bemony` |
+| PURCHASE de pagamento | Backend (não browser) |
+
+Sem imports `@beworke/pixel/src/*`.
+
+## Exports
+
+| Subpath | Conteúdo |
+|---|---|
+| `.` | factory, `BemonyPixel`, contratos, helpers, defaults públicos |
+| `./browser` | bootstrap + auto-init (sem side effect no import) |
+| `./global` | IIFE `dist/browser/pixel-bemony.global.js` (auto-init por padrão) |
+
+## Exemplos HTML
+
+Ver guia do funil ponta a ponta: [`examples/README.md`](./examples/README.md).
+
+Em [`examples/`](./examples/): `funnel/` (páginas externas), `security/` (checkout + one-click),
+`*-price-code.html` (sem catálogo), browser-bootstrap.
+
+## Troubleshooting
+
+[`docs/TROUBLESHOOTING.md`](./docs/TROUBLESHOOTING.md)
+
+## Matriz de testes
+
+[`docs/TEST_MATRIX.md`](./docs/TEST_MATRIX.md)
+
+## Changelog
+
+[`CHANGELOG.md`](./CHANGELOG.md)
+
+## Scripts do pacote
+
+```bash
+pnpm --filter @beworke/pixel-bemony lint
+pnpm --filter @beworke/pixel-bemony type-check
+pnpm --filter @beworke/pixel-bemony test
+pnpm --filter @beworke/pixel-bemony build
+```

package/RELEASE_CANDIDATE.md

@@ -0,0 +1,37 @@
+# Release Candidate — `@beworke/pixel-bemony`
+
+## Status
+
+| Item | Decisão |
+|---|---|
+| Publish npm | **Sim** — RC pública para validação |
+| Versão | `0.1.0-rc.1` |
+| Naming | `@beworke/pixel-bemony` |
+| Tags npm | `rc` + `latest` (ambas apontam para a RC atual) |
+
+## Compatibilidade com o Core
+
+| Pacote | Intervalo |
+|---|---|
+| `@beworke/pixel` (peer) | `>=0.1.0-rc.7` |
+| Dependência no workspace | `workspace:*` (pnpm publish reescreve para a versão concreta do Core) |
+
+## Checklist
+
+1. `pnpm verify:pixel-bemony-rc`
+2. Confirmar: sem token em artefatos, sem purchase browser, entry `.` sem side effects
+3. `pnpm --filter @beworke/pixel-bemony publish:rc`
+4. `npm view @beworke/pixel-bemony dist-tags` → `rc` e `latest` = `0.1.0-rc.1`
+
+## Artifact local
+
+```text
+artifacts/beworke-pixel-bemony-0.1.0-rc.1.tgz
+artifacts/latest-pixel-bemony-package.json
+```
+
+## Fora desta RC
+
+- Versão estável `0.1.0` (sem sufixo)
+- Alias de marca `bemony-pixel`
+- CMP completo / purchase browser