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

package/docs/public/README.md

@@ -4,13 +4,13 @@ Documentação para desenvolvedores que implementam funis e páginas com `@bewor
 
 **Versão de referência:** `0.1.0-rc.6` · **Etapas concluídas:** 1–20
 
-> Esta pasta é a documentação **pública**. Arquitetura interna, prompts de etapas e relatórios de engenharia ficam na raiz do repositório (`ARCHITECTURE.md`, `PIXEL_V2_*`).
+> Esta pasta é a documentação **pública**. Arquitetura interna, prompts de etapas e relatórios de engenharia ficam em `PLAN_PIXEL/` (`ARCHITECTURE.md`, `PIXEL_V2_*`).
 
 ## Onde ler (importante)
 
 | Contexto | URL / caminho |
 |----------|----------------|
-| **GitHub (browser)** | https://github.com/techionext/Pixel-Global/tree/main/docs/public |
+| **GitHub (browser)** | https://github.com/techionext/Pixel-Global/tree/main/packages/pixel/docs/public |
 | **Pacote npm instalado** | `node_modules/@beworke/pixel/docs/public/` |
 | **npmjs.com** | Só renderiza o `README.md` do pacote — **não** abre `.md` individuais |
 
@@ -49,15 +49,17 @@ Instalação: `npm install @beworke/pixel@rc` (público, sem token).
 
 ## Exemplos públicos
 
-Exemplos em `examples/public/` usam **somente API pública** (sem `getDebugServices`, sem hooks de debug).
+Exemplos em `apps/playground-html/public/` usam **somente API pública** (sem `getDebugServices`, sem hooks de debug).
 
-| Exemplo | Caminho |
-|---------|---------|
-| Landing (HTML) | `examples/public/html/landing.html` |
-| Checkout (HTML) | `examples/public/html/checkout.html` |
-| Next.js (App Router) | `examples/nextjs/` (hooks locais, não exportados pelo SDK) |
+| Exemplo | Caminho no monorepo |
+|---------|---------------------|
+| Landing (HTML) | `apps/playground-html/public/html/landing.html` |
+| Checkout (HTML) | `apps/playground-html/public/html/checkout.html` |
+| Next.js (App Router) | `apps/playground-next/` (hooks locais, não exportados pelo SDK) |
 
-Playgrounds internos de engenharia: `examples/html-script/` (podem usar APIs `@internal`).
+Playgrounds internos de engenharia: `apps/playground-html/` (podem usar APIs `@internal`).
+
+> **Legado:** na estrutura anterior ao monorepo, estes caminhos eram `examples/public/`, `examples/nextjs/` e `examples/html-script/`.
 
 ## Privacidade e limitações
 
@@ -71,5 +73,5 @@ Playgrounds internos de engenharia: `examples/html-script/` (podem usar APIs `@i
 
 | Documento | Conteúdo |
 |-----------|----------|
-| [Validação do pacote](./release-candidate/validation.md) | `validate:rc-package`, smoke, checklist |
-| [RELEASE_CANDIDATE.md](../../RELEASE_CANDIDATE.md) | Notas oficiais do RC na raiz |
+| [Validação do pacote](./release-candidate/validation.md) | `pack:pixel`, smoke, checklist |
+| [RELEASE_CANDIDATE.md](../../RELEASE_CANDIDATE.md) | Notas oficiais do RC |

package/docs/public/api/pixel.md

@@ -62,4 +62,4 @@ Estes existem no código para playgrounds internos:
 - `simulateTransport*`, `manualTransportReplay`, etc.
 - `getDebugDedupeKeys`, `getDebugIntegrationState`, …
 
-Veja `examples/html-script/` apenas para engenharia interna.
+Veja `apps/playground-html/` apenas para engenharia interna.

package/docs/public/configuration/commerce.md

@@ -41,4 +41,4 @@ commerce: {
 },
 ```
 
-Referência completa: `examples/nextjs/lib/pixel-config.ts`.
+Referência completa: `apps/playground-next/lib/pixel-config.ts`.

package/docs/public/getting-started/installation.md

@@ -31,7 +31,7 @@ node -e "console.log(require('@beworke/pixel/package.json').version)"
 
 | Contexto | Caminho |
 |----------|---------|
-| **Browser (GitHub)** | https://github.com/techionext/Pixel-Global/tree/main/docs/public |
+| **Browser (GitHub)** | https://github.com/techionext/Pixel-Global/tree/main/packages/pixel/docs/public |
 | **Após npm install** | `node_modules/@beworke/pixel/docs/public/` |
 
 O site **npmjs.com não abre** arquivos `.md` individuais (ex.: `npmjs.com/package/@beworke/docs/...` → 404). Isso é normal.
@@ -44,12 +44,15 @@ npm install ./beworke-pixel-0.1.0-rc.6.tgz
 
 ## Validar instalação limpa
 
-No repositório do SDK:
+Na raiz do monorepo:
 
 ```bash
-npm run validate:rc-package
+pnpm pack:pixel
+pnpm validate:pixel-package
 ```
 
+O tarball fica em `artifacts/` (não use `pnpm --filter @beworke/pixel pack` como fluxo principal).
+
 ## Imports recomendados
 
 ```typescript

package/docs/public/getting-started/react-nextjs.md

@@ -4,7 +4,7 @@ O SDK não exporta hooks React. O padrão recomendado é um hook **local** no ap
 
 ## Hook local (`usePixel`)
 
-Referência: `examples/nextjs/lib/use-pixel.ts`
+Referência: `apps/playground-next/lib/use-pixel.ts`
 
 ```typescript
 'use client';
@@ -36,7 +36,7 @@ export function usePixel() {
 
 ## Config por página/funil
 
-Centralize em `createPixelConfig()` (`examples/nextjs/lib/pixel-config.ts`):
+Centralize em `createPixelConfig()` (`apps/playground-next/lib/pixel-config.ts`):
 
 - `identity.funnelId`, `funnelStepId`, `pageId` por etapa do funil
 - `commerce.catalog` para produtos da oferta
@@ -50,6 +50,6 @@ Centralize em `createPixelConfig()` (`examples/nextjs/lib/pixel-config.ts`):
 
 ## Checkout
 
-`examples/nextjs/app/checkout/page.tsx` demonstra `initiateCheckout`, `addPaymentInfo`, `purchase` com catálogo commerce.
+`apps/playground-next/app/checkout/page.tsx` demonstra `initiateCheckout`, `addPaymentInfo`, `purchase` com catálogo commerce.
 
 Guia: [Funil checkout](../guides/funnel-checkout.md).

package/docs/public/getting-started/script-tag.md

@@ -49,7 +49,7 @@ Após `npm run build`, o artefato está em `dist/global/` (nome conforme `tsup`
 
 ## Exemplo público
 
-Veja `examples/public/html/landing.html`.
+Veja `apps/playground-html/public/html/landing.html`.
 
 ## Limitações
 

package/docs/public/guides/funnel-checkout.md

@@ -10,7 +10,7 @@ Rastrear início de checkout, carrinho, pagamento e compra.
 - `identity.checkoutId`, `funnelStepId`
 - Transport API habilitado
 
-Ver `examples/nextjs/lib/pixel-config.ts` e `examples/public/html/checkout.html`.
+Ver `apps/playground-next/lib/pixel-config.ts` e `apps/playground-html/public/html/checkout.html`.
 
 ## API manual (ordem recomendada)
 

package/docs/public/guides/funnel-full.md

@@ -57,8 +57,8 @@ Uma instância `Pixel` por aba; `destroy()` ao desmontar componentes React entre
 
 | Etapa | Exemplo |
 |-------|---------|
-| Landing | `examples/public/html/landing.html` |
-| Checkout | `examples/public/html/checkout.html` |
-| Full (Next) | `examples/nextjs/` |
+| Landing | `apps/playground-html/public/html/landing.html` |
+| Checkout | `apps/playground-html/public/html/checkout.html` |
+| Full (Next) | `apps/playground-next/` |
 
 Guias individuais: [landing](./funnel-landing.md), [checkout](./funnel-checkout.md), [upsell](./funnel-upsell.md), [downsell](./funnel-downsell.md), [thank-you](./funnel-thank-you.md).

package/docs/public/guides/funnel-landing.md

@@ -65,4 +65,4 @@ Opcional: `modules.conversion.auto` + detector `lead` com seletores do formulár
 | Sessão zera no reload | Sem `storage.persistence.session` | Configurar `sessionStorage` |
 | Duplo `PAGE_VIEW` | Dois `init()` | Singleton / cleanup `destroy()` |
 
-Exemplo: `examples/public/html/landing.html`
+Exemplo: `apps/playground-html/public/html/landing.html`

package/docs/public/limitations.md

@@ -29,4 +29,4 @@ Versão: `0.1.0-rc.5` · Etapas 1–20 concluídas.
 
 670 testes automatizados (2 skipped). Smoke real requer endpoint configurado.
 
-Veja também [RELEASE_CANDIDATE.md](../../RELEASE_CANDIDATE.md) e [PIXEL_V2_VALIDATION_MATRIX.md](../../PIXEL_V2_VALIDATION_MATRIX.md).
+Veja também [RELEASE_CANDIDATE.md](../../RELEASE_CANDIDATE.md) e [PIXEL_V2_VALIDATION_MATRIX.md](../../../../PLAN_PIXEL/PIXEL_V2_VALIDATION_MATRIX.md).

package/docs/public/release-candidate/validation.md

@@ -1,29 +1,34 @@
 # Validação do Release Candidate
 
-## Comandos (repositório SDK)
+## Comandos (raiz do monorepo)
 
 ```bash
-npm run type-check
-npm test
-npm run build
-npm run test:smoke:real
-npm run test:transport
-npm run test:integration
-npm pack --dry-run
-npm pack
-npm run validate:rc-package
-npm run validate:public-docs
-npm run validate:public-examples
+pnpm type-check
+pnpm test
+pnpm build
+pnpm --filter @beworke/pixel test:smoke:real
+pnpm --filter @beworke/pixel test:transport
+pnpm --filter @beworke/pixel test:integration
+
+pnpm pack:pixel
+pnpm validate:pixel-package
+pnpm smoke:pixel-package
+pnpm validate:public-docs
+pnpm validate:public-examples
 ```
 
+O fluxo oficial de empacotamento é **`pnpm pack:pixel`** (tarball em `artifacts/`).  
+Não use `pnpm --filter @beworke/pixel pack` como fluxo principal.
+
 ## Tarball
 
-Nome esperado: `beworke-pixel-0.1.0-rc.5.tgz`
+Nome esperado: `artifacts/beworke-pixel-0.1.0-rc.6.tgz`  
+Manifesto: `artifacts/latest-package.json` (caminho relativo portátil).
 
 Instalação em projeto limpo:
 
 ```bash
-npm install /caminho/para/beworke-pixel-0.1.0-rc.5.tgz
+npm install /caminho/para/artifacts/beworke-pixel-0.1.0-rc.6.tgz
 ```
 
 ## Checklist rápido
@@ -31,7 +36,7 @@ npm install /caminho/para/beworke-pixel-0.1.0-rc.5.tgz
 - [ ] Exports `.`, `./global`, `./v2`, `./config`, `./events`, `./services`, `./runtime`, `./logger`
 - [ ] `window.PixelV2` no build global
 - [ ] Exemplos públicos sem `@internal` / sem import de `src/`
-- [ ] Links em `docs/public/` válidos
-- [ ] README aponta para `docs/public/`
+- [ ] Links em `packages/pixel/docs/public/` válidos
+- [ ] README aponta para `packages/pixel/docs/public/`
 
-Documentos na raiz: [RELEASE_CANDIDATE.md](../../../RELEASE_CANDIDATE.md), [PIXEL_V2_PUBLIC_RC_RELEASE_CHECKLIST.md](../../../PIXEL_V2_PUBLIC_RC_RELEASE_CHECKLIST.md).
+Documentos: [RELEASE_CANDIDATE.md](../../../RELEASE_CANDIDATE.md), [PIXEL_V2_PUBLIC_RC_RELEASE_CHECKLIST.md](../../../../../PLAN_PIXEL/PIXEL_V2_PUBLIC_RC_RELEASE_CHECKLIST.md).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beworke/pixel",
-  "version": "0.1.0-rc.6",
+  "version": "0.1.0-rc.7",
   "description": "Pixel v2 — SDK de analytics e conversão para API própria e destinos browser",
   "main": "./dist/index.cjs.js",
   "module": "./dist/index.esm.js",
@@ -54,15 +54,14 @@
   ],
   "scripts": {
     "dev": "tsup --watch",
-    "build": "tsup",
+    "build": "tsup && node ../../scripts/copy-packaged-examples.mjs",
     "test": "vitest run",
     "test:watch": "vitest",
-    "test:smoke:real": "node ./scripts/run-smoke-real.mjs",
-    "validate:rc-package": "node ./scripts/validate-rc-package.mjs",
-    "validate:public-docs": "node ./scripts/validate-public-docs.mjs",
-    "validate:public-examples": "node ./scripts/validate-public-examples.mjs",
+    "test:smoke:real": "node ../../scripts/run-smoke-real.mjs",
+    "validate:rc-package": "node ../../scripts/validate-rc-package.mjs",
+    "validate:public-docs": "node ../../scripts/validate-public-docs.mjs",
+    "validate:public-examples": "node ../../scripts/validate-public-examples.mjs",
     "publish:rc": "npm publish --tag rc --tag latest",
-    "validate:15b": "node ./scripts/validate-15b.mjs",
     "test:integration": "vitest run src/integration",
     "test:transport": "vitest run src/transport",
     "test:full-funnel": "vitest run src/modules/core/url-context src/integration/stage-15b-module-matrix.test.ts",
@@ -72,9 +71,7 @@
     "format": "prettier --write src/**/*.{ts,tsx,js,jsx,json,css,md}",
     "type-check": "tsc --noEmit",
     "prepublishOnly": "pnpm build",
-    "changeset": "changeset",
-    "version": "changeset version",
-    "release": "pnpm build && changeset publish"
+    "clean": "rimraf dist coverage"
   },
   "keywords": [
     "pixel",
@@ -92,9 +89,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "packageManager": "pnpm@10.7.1",
   "devDependencies": {
-    "@changesets/cli": "^2.29.7",
     "@types/node": "^20.0.0",
     "@typescript-eslint/eslint-plugin": "^6.0.0",
     "@typescript-eslint/parser": "^6.0.0",
@@ -103,6 +98,7 @@
     "eslint-plugin-prettier": "^5.0.0",
     "happy-dom": "^20.6.3",
     "prettier": "^3.0.0",
+    "rimraf": "^6.0.1",
     "tsup": "^8.5.0",
     "typescript": "^5.0.0",
     "vitest": "^4.0.18"