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

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @beworke/pixel
 
+## 0.1.0-rc.6 — Public RC docs on npm + install fix
+
+### Fixed
+
+- README npm com links **GitHub** (npm não hospeda páginas `.md` individuais)
+- `docs/public/` incluído no tarball npm → `node_modules/@beworke/pixel/docs/public/`
+- Instalação documentada: `npm install @beworke/pixel@rc` (público, sem token)
+- `publish:rc` publica tags `rc` e `latest` juntas
+
 ## Unreleased — Etapa 20 Runtime Intelligence
 
 ### Added

package/README.md

@@ -2,31 +2,41 @@
 
 SDK de analytics e conversão para web — implemente funis (landing, checkout, upsell, thank-you) em React, Next.js, SPA ou HTML puro **sem conhecer a arquitetura interna**.
 
-**Versão RC:** `0.1.0-rc.5` · **Etapas concluídas:** 1–20 · **Próxima etapa funcional:** 21 — Commerce Lifecycle
+**Versão RC:** `0.1.0-rc.6` · **Etapas concluídas:** 1–20 · **Próxima etapa funcional:** 21 — Commerce Lifecycle
 
-## Documentação pública
+## Instalação (npm — sem token)
 
-**Comece aqui:** [`docs/public/README.md`](./docs/public/README.md)
+Pacote **público**. Qualquer dev instala **sem login** no npm:
 
-| Guia | Link |
-|------|------|
-| Instalação | [docs/public/getting-started/installation.md](./docs/public/getting-started/installation.md) |
-| Quick start | [docs/public/getting-started/quick-start.md](./docs/public/getting-started/quick-start.md) |
-| API Pixel | [docs/public/api/pixel.md](./docs/public/api/pixel.md) |
-| Eventos | [docs/public/events/catalog.md](./docs/public/events/catalog.md) |
-| Configuração | [docs/public/configuration/overview.md](./docs/public/configuration/overview.md) |
-| Funis | [docs/public/guides/funnel-full.md](./docs/public/guides/funnel-full.md) |
-| Privacidade (RC) | [docs/public/privacy/limitations.md](./docs/public/privacy/limitations.md) |
-| Limitações | [docs/public/limitations.md](./docs/public/limitations.md) |
+```bash
+npm install @beworke/pixel@rc
+# ou versão fixa:
+npm install @beworke/pixel@0.1.0-rc.6
+```
 
-Exemplos públicos: [`examples/public/`](./examples/public/) · Next.js: [`examples/nextjs/`](./examples/nextjs/)
+> **Importante:** `npm install @beworke/pixel` sem tag usa `latest`. Use `@rc` ou `@0.1.0-rc.6` até alinhar tags.
 
-## Instalação
+## Documentação pública
 
-```bash
-npm install ./beworke-pixel-0.1.0-rc.5.tgz
-npm run validate:rc-package   # no repo do SDK
-```
+O **npm não hospeda** arquivos `.md` como site (URLs tipo `npmjs.com/.../installation.md` **não existem**).
+
+| Onde ler | Link |
+|----------|------|
+| **GitHub (recomendado no browser)** | [docs/public/README.md](https://github.com/techionext/Pixel-Global/blob/main/docs/public/README.md) |
+| **Após `npm install`** | `node_modules/@beworke/pixel/docs/public/` |
+
+| Guia | GitHub |
+|------|--------|
+| Instalação | [getting-started/installation.md](https://github.com/techionext/Pixel-Global/blob/main/docs/public/getting-started/installation.md) |
+| Quick start | [getting-started/quick-start.md](https://github.com/techionext/Pixel-Global/blob/main/docs/public/getting-started/quick-start.md) |
+| API Pixel | [api/pixel.md](https://github.com/techionext/Pixel-Global/blob/main/docs/public/api/pixel.md) |
+| Eventos | [events/catalog.md](https://github.com/techionext/Pixel-Global/blob/main/docs/public/events/catalog.md) |
+| Configuração | [configuration/overview.md](https://github.com/techionext/Pixel-Global/blob/main/docs/public/configuration/overview.md) |
+| Funis | [guides/funnel-full.md](https://github.com/techionext/Pixel-Global/blob/main/docs/public/guides/funnel-full.md) |
+| Privacidade (RC) | [privacy/limitations.md](https://github.com/techionext/Pixel-Global/blob/main/docs/public/privacy/limitations.md) |
+| Limitações | [limitations.md](https://github.com/techionext/Pixel-Global/blob/main/docs/public/limitations.md) |
+
+Repositório: https://github.com/techionext/Pixel-Global
 
 ## Quick start
 
@@ -60,11 +70,8 @@ const pixel = new Pixel({
 });
 
 await pixel.init();
-// PAGE_VIEW automático
-
 pixel.lead({ email: 'user@example.com' });
 pixel.purchase({ transactionId: 'ord_1', value: 197, currency: 'BRL' });
-
 await pixel.destroy();
 ```
 
@@ -77,65 +84,27 @@ await pixel.destroy();
 | `purchase`, `lead`, `addToCart`, `removeFromCart` | Conversão |
 | `initiateCheckout`, `addPaymentInfo`, `viewContent`, `search` | Conversão |
 
-Exports: `DEFAULT_PIXEL_CONFIG`, `PixelConfig`, `PixelDebugSnapshot`, `resolveStorageAdapterName`.
-
-Detalhes: [docs/public/api/pixel.md](./docs/public/api/pixel.md)
-
-## Eventos (resumo)
+Detalhes: [api/pixel.md](https://github.com/techionext/Pixel-Global/blob/main/docs/public/api/pixel.md)
 
-Core · Session · Behavior · Conversion — 24 tipos em `PixelEvent`. Catálogo completo: [docs/public/events/catalog.md](./docs/public/events/catalog.md).
-
-## Script tag (CDN / IIFE)
+## Script tag (CDN)
 
 ```html
-<script src="https://unpkg.com/@beworke/pixel@0.1.0-rc.5/dist/v2/global.global.js"></script>
+<script src="https://unpkg.com/@beworke/pixel@rc/dist/v2/global.global.js"></script>
 <script>
   const { Pixel, DEFAULT_PIXEL_CONFIG } = window.PixelV2;
 </script>
 ```
 
-Global oficial: **`window.PixelV2`**. Prefira tarball fixo `0.1.0-rc.5` em testes reprodutíveis.
-
-## Package exports
-
-| Export | Uso |
-|--------|-----|
-| `@beworke/pixel` | Entry principal |
-| `@beworke/pixel/global` | IIFE |
-| `@beworke/pixel/v2` | Alias |
-| `@beworke/pixel/config`, `/events`, `/services`, `/runtime`, `/logger` | Avançado |
-
-Não existe `@beworke/pixel/diagnostics` no RC.
+Global oficial: **`window.PixelV2`**.
 
 ## Limitações do RC
 
-- **Sem Consent Gate / CMP completo** — a aplicação controla quando chamar `init()` ([privacidade](./docs/public/privacy/limitations.md))
-- **Não declarar GDPR/LGPD/CCPA compliant** com este RC
+- Sem Consent Gate / CMP completo — a aplicação controla quando chamar `init()`
+- Não declarar GDPR/LGPD/CCPA compliant com este RC
 - Sem eventos dedicados upsell/downsell — use `VIEW_CONTENT` + `PURCHASE`
-- Etapa 21 (Commerce Lifecycle) e Etapa 25 (Privacy) ainda no roadmap
-
-Lista completa: [docs/public/limitations.md](./docs/public/limitations.md) · [RELEASE_CANDIDATE.md](./RELEASE_CANDIDATE.md)
-
-## Validação
-
-670 testes passando (2 skipped). Comandos:
-
-```bash
-npm run type-check && npm test && npm run build
-npm run validate:public-docs && npm run validate:public-examples
-npm run validate:rc-package
-```
-
-Matriz: [`PIXEL_V2_VALIDATION_MATRIX.md`](./PIXEL_V2_VALIDATION_MATRIX.md)
-
----
-
-## Contribuidores e arquitetura interna
 
-Documentação de engenharia (não necessária para implementar funis):
+Lista: [limitations.md](https://github.com/techionext/Pixel-Global/blob/main/docs/public/limitations.md)
 
-- [`ARCHITECTURE.md`](./ARCHITECTURE.md)
-- [`README_LEGACY_AUDIT.md`](./README_LEGACY_AUDIT.md)
-- Playgrounds internos: [`examples/html-script/`](./examples/html-script/)
+## Contribuidores
 
-Migração v1 → v2: `GomarkePixel` → `Pixel`, `window.gomarkePixel` → `window.PixelV2`.
+Arquitetura interna: [ARCHITECTURE.md](https://github.com/techionext/Pixel-Global/blob/main/ARCHITECTURE.md) · Playgrounds: `examples/html-script/` no repositório.