fg-tracker-browser 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog — fg-tracker-browser
+
+## 0.2.0 (fg-tracker-browser) — 2026-09-15
+
+- **Renomeado de `stread-track-browser` — nomes antigos continuam funcionando e serão removidos na 1.0.** Veja "Migração de stread-track-browser" no README.
+- Header da chave passa a ser `x-fg-tracker-key` (a API aceita também o legado `x-stread-track-key`, inclusive no CORS). Requer a API do FG Tracker com suporte ao header novo.
+- Novo export `API_KEY_HEADER`. Prefixo dos logs de debug: `[fg-tracker-browser]`.
+- `package.json`: repositório `FORTGROUND/fg-tracker`, `publishConfig.access: public`, `prepack` limpa e recompila `dist/`.
+
+## 0.2.0 (stread-track-browser) — 2026-09-14
+
+- **Tráfego (CONTRATO.md §25)**: opções `analytics` (default `false`) e `trackPageviews` (default = `analytics`). Quem já usa o SDK só para erros não muda de comportamento.
+- Pageview automático na carga inicial e em navegações SPA (`history.pushState`/`replaceState`/`popstate`, compatível com o App Router do Next.js), com dedupe pela URL e checagem periódica como rede de segurança.
+- Visitante anônimo (`fgt_vid`, 1 ano, `SameSite=Lax`) e sessão (`fgt_sid`, 30 min de inatividade) com fallback em `localStorage`.
+- `tracker.page(path?)`, `tracker.identify(userId)`, `tracker.setConsent('granted' | 'denied' | 'pending')`; opções `consent`, `cookieDomain`, `sanitizePath`.
+- Respeita `navigator.doNotTrack === '1'`.
+- `sendBeacon` no `pagehide` passa a enviar `text/plain` (sem preflight de CORS); a API aceita o JSON nesse content-type e a chave em `?key=`.
+
+## 0.1.0
+
+- Primeira versão: erros não tratados, breadcrumbs, usuário/release, fetch com `traceparent`, source maps (§24).

package/README.md

@@ -0,0 +1,93 @@
+# fg-tracker-browser
+
+SDK de navegador do FG Tracker (CONTRATO.md §24). Sem dependências, ESM, ~6 KB. Captura erros não tratados com os últimos **breadcrumbs** (cliques, navegação, console, fetch), o usuário logado, a página e a release; opcionalmente liga o `fetch` do front ao trace da API (`traceparent`).
+
+```ts
+import { init } from 'fg-tracker-browser';
+
+const tracker = init({
+  apiKey: 'stk_...',                         // chave do projeto (só ingere; pode ser pública)
+  endpoint: 'https://<api-do-fg-tracker>',     // URL da API mostrada em Conectar
+  serviceName: 'phase-web',
+  release: import.meta.env.VITE_RELEASE,     // o mesmo valor enviado com os source maps
+  environment: 'production',
+  tracesSampleRate: 0.2,                     // 20% dos fetches viram traces
+  propagateTraceTo: ['api.phasia.studio'],   // quem recebe traceparent (default: mesma origem)
+  ignoreErrors: [/ResizeObserver loop/],
+});
+
+tracker.setUser({ id: user.id, email: user.email });
+tracker.captureException(err, { stage: 'checkout' });
+tracker.captureMessage('cupom aplicado', 'info');
+tracker.addBreadcrumb({ type: 'custom', message: 'modal aberto' });
+```
+
+| opção | default | descrição |
+|---|---|---|
+| `apiKey`, `endpoint` | — | sem `apiKey` o SDK vira no-op (com aviso) |
+| `serviceName`, `release`, `environment`, `user`, `attributes` | — | vão em todo evento |
+| `sampleRate` | `1` | fração de erros enviados |
+| `tracesSampleRate` | `0` | fração de fetches que geram um trace (`browser` → `http.client`) |
+| `propagateTraceTo` | mesma origem | hosts/prefixos/RegExp que recebem `traceparent` |
+| `ignoreErrors` | `[]` | `name: message` (string/RegExp) ignorados |
+| `beforeSend` | — | `(event) => event \| null` |
+| `breadcrumbs` | tudo ligado | `{ click, navigation, console, fetch }` |
+| `maxBreadcrumbs` | `30` | anel de breadcrumbs |
+| `captureGlobalErrors` | `true` | `window.onerror` + `unhandledrejection` |
+| `flushIntervalMs` | `1500` | envio em lote (`keepalive`; `sendBeacon` ao sair da página) |
+| `analytics` | `false` | liga visitantes anônimos + pageviews (§25). Quem não passa a opção não muda nada |
+| `trackPageviews` | `= analytics` | pageviews automáticos (carga inicial, `pushState`/`replaceState`/`popstate`) |
+| `consent` | `'granted'` | `'pending'` guarda em memória sem cookies até `setConsent('granted')`; `'denied'` descarta |
+| `cookieDomain` | — | ex.: `.fortground.com.br` para o mesmo visitante entre subdomínios |
+| `sanitizePath` | `normalizePath` | `(path) => string \| null` antes do envio (`null` não registra) |
+
+Cada erro vira um span `kind: 'browser'`, `name: page:/rota/:id`, com `attributes.breadcrumbs` — o painel mostra "O que o usuário fez antes" no trace e a issue nasce agrupada por assinatura, com usuário afetado e release.
+
+## Tráfego (pageviews)
+
+```ts
+const tracker = init({ apiKey: 'stk_...', endpoint: 'https://<api-do-fg-tracker>',     // URL da API mostrada em Conectar serviceName: 'meu-site', analytics: true });
+tracker.identify(user.id);        // liga o visitante ao usuário (a API guarda só sha256 com sal do projeto)
+tracker.page('/checkout/sucesso'); // pageview manual (dedupe com o automático pela URL)
+tracker.setConsent('granted');     // quando o banner de cookies for aceito (se iniciou com consent: 'pending')
+```
+
+- Visitante: 128 bits aleatórios no cookie first-party `fgt_vid` (1 ano, `SameSite=Lax`, `Secure` em https), com fallback em `localStorage`. Sessão: `fgt_sid`, renovada a cada evento e trocada após 30 min sem atividade.
+- Payload (`analytics[]` no `POST /v1/ingest`): `{ type: 'pageview', url (caminho normalizado + só utm_*), title?, referrer (só a origem externa), utm_source/medium/campaign/term/content, screen (mobile/tablet/desktop), locale, visitor_id, session_id, ts, user_id? }` e `{ type: 'identify', user_id, visitor_id, session_id, ts }`.
+- `navigator.doNotTrack === '1'` desliga a analytics (erros continuam). Nenhuma PII: query string, hash, e-mail e títulos não são guardados pela API.
+- Instalação em Next.js App Router: `docs/instalar-pageviews.md`.
+
+## Source maps
+
+Suba os `.map` da release no deploy (e apague-os do bundle público):
+
+```sh
+FG_TRACKER_KEY=stk_... FG_TRACKER_URL=https://<api-do-fg-tracker> \
+  npx -p fg-tracker-sdk fg-tracker-sourcemaps --dir dist --release "phase-web@$GITHUB_SHA" --url-prefix "~/assets"
+find dist -name '*.map' -delete
+```
+
+A ingestão traduz `app-3f2a1c.js:1:48213` para `src/checkout/Cart.tsx:42:11`: o culpado da issue e os commits suspeitos passam a apontar para o código-fonte.
+
+O `endpoint` é obrigatório: use a URL da API mostrada no painel em **Conectar**. O domínio `https://tracker-api.fortground.com.br` será o endereço definitivo; até ele entrar no ar, use a URL atual do painel. O SDK envia a chave no header `x-fg-tracker-key` (e em `?key=` no `sendBeacon`).
+
+## Migração de stread-track-browser
+
+O pacote foi renomeado de `stread-track-browser` (nunca publicado no npm; usado via workspace/tarball) para `fg-tracker-browser` (mesma versão, 0.2.0, primeira publicação). Nomes antigos continuam funcionando e serão removidos na 1.0.
+
+| antigo | novo | compatibilidade |
+|---|---|---|
+| pacote `stread-track-browser` | `fg-tracker-browser` | mesma API (`init`, `createBrowserTracker`); troque só o import |
+| header `x-stread-track-key` | `x-fg-tracker-key` | a API aceita os dois (e `?key=`); o CORS libera os dois |
+| CLI `stread-track-sourcemaps` (do SDK Node) | `fg-tracker-sourcemaps` (`fg-tracker-sdk`) | alias obsoleto mantido |
+| `STREAD_TRACK_KEY`/`STREAD_TRACK_URL`/`STREAD_TRACK_RELEASE` no CI | `FG_TRACKER_KEY`/`FG_TRACKER_URL`/`FG_TRACKER_RELEASE` | o nome antigo é fallback |
+| prefixo de log `[stread-track-browser]` | `[fg-tracker-browser]` | — |
+
+Cookies (`fgt_vid`, `fgt_sid`) e o formato do payload não mudaram: visitantes e sessões continuam os mesmos após a troca.
+
+## Build e testes
+
+```sh
+pnpm --filter fg-tracker-browser build   # dist/
+pnpm --filter fg-tracker-browser test    # node:test com window/document falsos
+```

package/dist/analytics.d.ts

@@ -0,0 +1,40 @@
+import type { AnalyticsEvent, BrowserEnv, Consent, PageviewEvent } from './types.js';
+/**
+ * Pageviews e visitantes anônimos (CONTRATO.md §25): ids aleatórios em cookies
+ * first-party (`fgt_vid` 1 ano, `fgt_sid` 30 min de inatividade), sem PII.
+ * Só é criado quando `analytics`/`trackPageviews` estão ligados.
+ */
+export declare const VISITOR_COOKIE = "fgt_vid";
+export declare const SESSION_COOKIE = "fgt_sid";
+export declare const VISITOR_TTL_SECONDS: number;
+export declare const SESSION_IDLE_MS: number;
+declare const UTM_KEYS: readonly ["utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"];
+type UtmKey = (typeof UTM_KEYS)[number];
+export declare function randomId(env: BrowserEnv): string;
+/** `Do Not Track` ligado no navegador (`navigator.doNotTrack === '1'`, com as variantes antigas). */
+export declare function doNotTrackEnabled(env: BrowserEnv): boolean;
+/** Bucket de tela: `mobile` (< 768 px), `tablet` (< 1024 px) ou `desktop`. */
+export declare function screenBucket(width: number | undefined | null): PageviewEvent['screen'];
+/** Só a origem do referrer externo; o da própria origem vira `null` (navegação interna). */
+export declare function referrerOrigin(referrer: string | undefined | null, currentOrigin: string | undefined): string | null;
+/** Parâmetros `utm_*` da URL (os únicos que sobrevivem da query string). */
+export declare function utmParams(search: string | undefined | null): Partial<Record<UtmKey, string>>;
+/** Caminho + só os `utm_*` da query (hash e demais parâmetros descartados). */
+export declare function pageUrl(path: string, utm: Partial<Record<UtmKey, string>>): string;
+export interface AnalyticsOptions {
+    consent: Consent;
+    cookieDomain?: string;
+    sanitizePath: (path: string) => string | null;
+    onEvent: (event: AnalyticsEvent) => void;
+}
+export interface Analytics {
+    /** Registra um pageview (dedupe: mesma URL da última vez é ignorada, exceto `force`). */
+    page(path?: string, force?: boolean): void;
+    identify(userId: string | number | null): void;
+    setConsent(consent: Consent): void;
+    /** Eventos retidos enquanto `consent === 'pending'`. */
+    readonly pending: readonly AnalyticsEvent[];
+    readonly consent: Consent;
+}
+export declare function createAnalytics(env: BrowserEnv, options: AnalyticsOptions): Analytics;
+export {};

package/dist/analytics.js

@@ -0,0 +1,252 @@
+/**
+ * Pageviews e visitantes anônimos (CONTRATO.md §25): ids aleatórios em cookies
+ * first-party (`fgt_vid` 1 ano, `fgt_sid` 30 min de inatividade), sem PII.
+ * Só é criado quando `analytics`/`trackPageviews` estão ligados.
+ */
+export const VISITOR_COOKIE = 'fgt_vid';
+export const SESSION_COOKIE = 'fgt_sid';
+export const VISITOR_TTL_SECONDS = 365 * 24 * 60 * 60;
+export const SESSION_IDLE_MS = 30 * 60 * 1000;
+const MAX_ANALYTICS_QUEUE = 200;
+const UTM_KEYS = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content'];
+export function randomId(env) {
+    const cryptoImpl = (env.window?.crypto ?? globalThis.crypto);
+    const out = new Uint8Array(16);
+    if (cryptoImpl?.getRandomValues)
+        cryptoImpl.getRandomValues(out);
+    else
+        for (let i = 0; i < out.length; i += 1)
+            out[i] = Math.floor(Math.random() * 256);
+    return Array.from(out, (b) => b.toString(16).padStart(2, '0')).join('');
+}
+/** `Do Not Track` ligado no navegador (`navigator.doNotTrack === '1'`, com as variantes antigas). */
+export function doNotTrackEnabled(env) {
+    const nav = (env.navigator ?? env.window?.navigator);
+    const win = env.window;
+    return nav?.doNotTrack === '1' || win?.doNotTrack === '1' || nav?.msDoNotTrack === '1';
+}
+/** Bucket de tela: `mobile` (< 768 px), `tablet` (< 1024 px) ou `desktop`. */
+export function screenBucket(width) {
+    if (!width || !Number.isFinite(width))
+        return null;
+    if (width < 768)
+        return 'mobile';
+    if (width < 1024)
+        return 'tablet';
+    return 'desktop';
+}
+/** Só a origem do referrer externo; o da própria origem vira `null` (navegação interna). */
+export function referrerOrigin(referrer, currentOrigin) {
+    if (!referrer)
+        return null;
+    try {
+        const url = new URL(referrer);
+        if (url.protocol !== 'http:' && url.protocol !== 'https:')
+            return null;
+        return url.origin === currentOrigin ? null : url.origin;
+    }
+    catch {
+        return null;
+    }
+}
+/** Parâmetros `utm_*` da URL (os únicos que sobrevivem da query string). */
+export function utmParams(search) {
+    const out = {};
+    if (!search)
+        return out;
+    const params = new URLSearchParams(search.startsWith('?') ? search.slice(1) : search);
+    for (const key of UTM_KEYS) {
+        const value = params.get(key);
+        if (value && value.trim())
+            out[key] = value.trim().slice(0, 200);
+    }
+    return out;
+}
+/** Caminho + só os `utm_*` da query (hash e demais parâmetros descartados). */
+export function pageUrl(path, utm) {
+    const query = new URLSearchParams();
+    for (const key of UTM_KEYS)
+        if (utm[key])
+            query.set(key, utm[key]);
+    const qs = query.toString();
+    return qs ? `${path}?${qs}` : path;
+}
+/** Cookie first-party (SameSite=Lax) com fallback em `localStorage` quando cookies estão bloqueados. */
+function createStorage(env, cookieDomain) {
+    const doc = env.document ?? env.window?.document;
+    const secure = (env.location ?? env.window?.location)?.protocol === 'https:';
+    const local = () => {
+        try {
+            return env.window?.localStorage ?? null;
+        }
+        catch {
+            return null;
+        }
+    };
+    const readCookie = (name) => {
+        try {
+            const raw = doc?.cookie ?? '';
+            for (const part of raw.split(';')) {
+                const [key, ...rest] = part.trim().split('=');
+                if (key === name)
+                    return decodeURIComponent(rest.join('='));
+            }
+        }
+        catch {
+            /* cookies bloqueados */
+        }
+        return null;
+    };
+    return {
+        get(name) {
+            const cookie = readCookie(name);
+            if (cookie)
+                return cookie;
+            try {
+                const raw = local()?.getItem(name);
+                if (!raw)
+                    return null;
+                const [value, expires] = raw.split('|');
+                if (!value || Number(expires) < Date.now())
+                    return null;
+                return value;
+            }
+            catch {
+                return null;
+            }
+        },
+        set(name, value, maxAgeSeconds) {
+            try {
+                if (doc) {
+                    doc.cookie = `${name}=${encodeURIComponent(value)}; Max-Age=${maxAgeSeconds}; Path=/; SameSite=Lax${secure ? '; Secure' : ''}${cookieDomain ? `; Domain=${cookieDomain}` : ''}`;
+                }
+            }
+            catch {
+                /* cookies bloqueados */
+            }
+            if (readCookie(name) === value)
+                return;
+            try {
+                local()?.setItem(name, `${value}|${Date.now() + maxAgeSeconds * 1000}`);
+            }
+            catch {
+                /* sem armazenamento: ids ficam só em memória */
+            }
+        },
+    };
+}
+export function createAnalytics(env, options) {
+    const storage = createStorage(env, options.cookieDomain);
+    let consent = options.consent;
+    const pending = [];
+    let memoryVisitor = null;
+    let memorySession = null;
+    let userId = null;
+    let lastUrl = null;
+    let firstPage = true;
+    const visitorId = () => {
+        if (consent === 'granted') {
+            const stored = storage.get(VISITOR_COOKIE);
+            if (stored && /^[0-9a-f]{32}$/.test(stored)) {
+                memoryVisitor = stored;
+                return stored;
+            }
+        }
+        memoryVisitor ?? (memoryVisitor = randomId(env));
+        if (consent === 'granted')
+            storage.set(VISITOR_COOKIE, memoryVisitor, VISITOR_TTL_SECONDS);
+        return memoryVisitor;
+    };
+    /** Sessão: `<id>.<último uso em ms>`; renova a cada evento e expira após 30 min parada. */
+    const sessionId = (at) => {
+        if (consent === 'granted' && !memorySession) {
+            const [id, last] = (storage.get(SESSION_COOKIE) ?? '').split('.');
+            if (id && /^[0-9a-f]{32}$/.test(id) && Number(last) > 0)
+                memorySession = { id, last: Number(last) };
+        }
+        if (!memorySession || at - memorySession.last > SESSION_IDLE_MS)
+            memorySession = { id: randomId(env), last: at };
+        memorySession.last = Math.max(memorySession.last, at);
+        if (consent === 'granted')
+            storage.set(SESSION_COOKIE, `${memorySession.id}.${memorySession.last}`, SESSION_IDLE_MS / 1000);
+        return memorySession.id;
+    };
+    const emit = (event) => {
+        if (consent === 'denied')
+            return;
+        if (consent === 'pending') {
+            pending.push(event);
+            if (pending.length > MAX_ANALYTICS_QUEUE)
+                pending.splice(0, pending.length - MAX_ANALYTICS_QUEUE);
+            return;
+        }
+        options.onEvent(event);
+    };
+    return {
+        page(path, force = false) {
+            if (consent === 'denied')
+                return;
+            const loc = env.location ?? env.window?.location;
+            const rawPath = (path ?? loc?.pathname ?? '/').split('#')[0];
+            const [pathOnly, query] = rawPath.split('?');
+            const sanitized = options.sanitizePath(pathOnly || '/');
+            if (sanitized === null)
+                return;
+            const utm = utmParams(path !== undefined ? query : loc?.search);
+            const url = pageUrl(sanitized, utm);
+            if (!force && url === lastUrl)
+                return;
+            lastUrl = url;
+            const doc = env.document ?? env.window?.document;
+            const nav = env.navigator ?? env.window?.navigator;
+            const at = Date.now();
+            const event = {
+                type: 'pageview',
+                url,
+                referrer: firstPage ? referrerOrigin(doc?.referrer, loc?.origin) : null,
+                ...utm,
+                screen: screenBucket(env.window?.screen?.width ?? env.window?.innerWidth),
+                locale: nav?.language ?? null,
+                visitor_id: visitorId(),
+                session_id: sessionId(at),
+                ts: new Date(at).toISOString(),
+            };
+            if (doc?.title)
+                event.title = doc.title.slice(0, 200);
+            if (userId)
+                event.user_id = userId;
+            firstPage = false;
+            emit(event);
+        },
+        identify(next) {
+            userId = next === null || next === undefined || next === '' ? null : String(next).slice(0, 200);
+            if (!userId || consent === 'denied')
+                return;
+            const at = Date.now();
+            emit({ type: 'identify', user_id: userId, visitor_id: visitorId(), session_id: sessionId(at), ts: new Date(at).toISOString() });
+        },
+        setConsent(next) {
+            consent = next;
+            if (next === 'denied') {
+                pending.splice(0);
+                return;
+            }
+            if (next === 'granted') {
+                // Persiste os ids gerados em memória durante o `pending` e libera a fila.
+                if (memoryVisitor)
+                    storage.set(VISITOR_COOKIE, memoryVisitor, VISITOR_TTL_SECONDS);
+                if (memorySession)
+                    storage.set(SESSION_COOKIE, `${memorySession.id}.${memorySession.last}`, SESSION_IDLE_MS / 1000);
+                for (const event of pending.splice(0))
+                    options.onEvent(event);
+            }
+        },
+        get pending() {
+            return pending;
+        },
+        get consent() {
+            return consent;
+        },
+    };
+}
+//# sourceMappingURL=analytics.js.map

package/dist/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC;AACxC,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC;AACxC,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AACtD,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAC9C,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAChC,MAAM,QAAQ,GAAG,CAAC,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,CAAU,CAAC;AAGlG,MAAM,UAAU,QAAQ,CAAC,GAAe;IACtC,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,IAAK,UAAkC,CAAC,MAAM,CAAuB,CAAC;IAC5G,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IAC/B,IAAI,UAAU,EAAE,eAAe;QAAE,UAAU,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;;QAC5D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;IACtF,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,iBAAiB,CAAC,GAAe;IAC/C,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,SAAS,CAAwD,CAAC;IAC5G,MAAM,GAAG,GAAG,GAAG,CAAC,MAAwD,CAAC;IACzE,OAAO,GAAG,EAAE,UAAU,KAAK,GAAG,IAAI,GAAG,EAAE,UAAU,KAAK,GAAG,IAAI,GAAG,EAAE,YAAY,KAAK,GAAG,CAAC;AACzF,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,YAAY,CAAC,KAAgC;IAC3D,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,KAAK,GAAG,GAAG;QAAE,OAAO,QAAQ,CAAC;IACjC,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,QAAQ,CAAC;IAClC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,cAAc,CAAC,QAAmC,EAAE,aAAiC;IACnG,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9B,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACvE,OAAO,GAAG,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,SAAS,CAAC,MAAiC;IACzD,MAAM,GAAG,GAAoC,EAAE,CAAC;IAChD,IAAI,CAAC,MAAM;QAAE,OAAO,GAAG,CAAC;IACxB,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACtF,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,GAAoC;IACxE,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;IACpC,KAAK,MAAM,GAAG,IAAI,QAAQ;QAAE,IAAI,GAAG,CAAC,GAAG,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAE,CAAC,CAAC;IACpE,MAAM,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC5B,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACrC,CAAC;AAOD,wGAAwG;AACxG,SAAS,aAAa,CAAC,GAAe,EAAE,YAAgC;IACtE,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC;IACjD,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,KAAK,QAAQ,CAAC;IAC7E,MAAM,KAAK,GAAG,GAA8B,EAAE;QAC5C,IAAI,CAAC;YACH,OAAQ,GAAG,CAAC,MAAuE,EAAE,YAAY,IAAI,IAAI,CAAC;QAC5G,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IACF,MAAM,UAAU,GAAG,CAAC,IAAY,EAAiB,EAAE;QACjD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,GAAG,EAAE,MAAM,IAAI,EAAE,CAAC;YAC9B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClC,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC9C,IAAI,GAAG,KAAK,IAAI;oBAAE,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IACF,OAAO;QACL,GAAG,CAAC,IAAI;YACN,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC;YAC1B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,KAAK,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBACnC,IAAI,CAAC,GAAG;oBAAE,OAAO,IAAI,CAAC;gBACtB,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACxC,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE;oBAAE,OAAO,IAAI,CAAC;gBACxD,OAAO,KAAK,CAAC;YACf,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,aAAa;YAC5B,IAAI,CAAC;gBACH,IAAI,GAAG,EAAE,CAAC;oBACR,GAAG,CAAC,MAAM,GAAG,GAAG,IAAI,IAAI,kBAAkB,CAAC,KAAK,CAAC,aAAa,aAAa,yBAAyB,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,YAAY,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBAClL,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,wBAAwB;YAC1B,CAAC;YACD,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,KAAK;gBAAE,OAAO;YACvC,IAAI,CAAC;gBACH,KAAK,EAAE,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,GAAG,IAAI,EAAE,CAAC,CAAC;YAC1E,CAAC;YAAC,MAAM,CAAC;gBACP,gDAAgD;YAClD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAmBD,MAAM,UAAU,eAAe,CAAC,GAAe,EAAE,OAAyB;IACxE,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACzD,IAAI,OAAO,GAAY,OAAO,CAAC,OAAO,CAAC;IACvC,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,IAAI,aAAa,GAAkB,IAAI,CAAC;IACxC,IAAI,aAAa,GAAwC,IAAI,CAAC;IAC9D,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,IAAI,SAAS,GAAG,IAAI,CAAC;IAErB,MAAM,SAAS,GAAG,GAAW,EAAE;QAC7B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAC3C,IAAI,MAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5C,aAAa,GAAG,MAAM,CAAC;gBACvB,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QACD,aAAa,KAAb,aAAa,GAAK,QAAQ,CAAC,GAAG,CAAC,EAAC;QAChC,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,aAAa,EAAE,mBAAmB,CAAC,CAAC;QAC3F,OAAO,aAAa,CAAC;IACvB,CAAC,CAAC;IAEF,2FAA2F;IAC3F,MAAM,SAAS,GAAG,CAAC,EAAU,EAAU,EAAE;QACvC,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,aAAa,EAAE,CAAC;YAC5C,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAClE,IAAI,EAAE,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,aAAa,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACtG,CAAC;QACD,IAAI,CAAC,aAAa,IAAI,EAAE,GAAG,aAAa,CAAC,IAAI,GAAG,eAAe;YAAE,aAAa,GAAG,EAAE,EAAE,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QACjH,aAAa,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACtD,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,GAAG,aAAa,CAAC,EAAE,IAAI,aAAa,CAAC,IAAI,EAAE,EAAE,eAAe,GAAG,IAAI,CAAC,CAAC;QAC5H,OAAO,aAAa,CAAC,EAAE,CAAC;IAC1B,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,CAAC,KAAqB,EAAE,EAAE;QACrC,IAAI,OAAO,KAAK,QAAQ;YAAE,OAAO;QACjC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,OAAO,CAAC,MAAM,GAAG,mBAAmB;gBAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,GAAG,mBAAmB,CAAC,CAAC;YAClG,OAAO;QACT,CAAC;QACD,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC,CAAC;IAEF,OAAO;QACL,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,KAAK;YACtB,IAAI,OAAO,KAAK,QAAQ;gBAAE,OAAO;YACjC,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC;YACjD,MAAM,OAAO,GAAG,CAAC,IAAI,IAAI,GAAG,EAAE,QAAQ,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;YAC9D,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC7C,MAAM,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC;YACxD,IAAI,SAAS,KAAK,IAAI;gBAAE,OAAO;YAC/B,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAChE,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YACpC,IAAI,CAAC,KAAK,IAAI,GAAG,KAAK,OAAO;gBAAE,OAAO;YACtC,OAAO,GAAG,GAAG,CAAC;YACd,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC;YACjD,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC;YACnD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACtB,MAAM,KAAK,GAAkB;gBAC3B,IAAI,EAAE,UAAU;gBAChB,GAAG;gBACH,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI;gBACvE,GAAG,GAAG;gBACN,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC;gBACzE,MAAM,EAAE,GAAG,EAAE,QAAQ,IAAI,IAAI;gBAC7B,UAAU,EAAE,SAAS,EAAE;gBACvB,UAAU,EAAE,SAAS,CAAC,EAAE,CAAC;gBACzB,EAAE,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE;aAC/B,CAAC;YACF,IAAI,GAAG,EAAE,KAAK;gBAAE,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACtD,IAAI,MAAM;gBAAE,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;YACnC,SAAS,GAAG,KAAK,CAAC;YAClB,IAAI,CAAC,KAAK,CAAC,CAAC;QACd,CAAC;QACD,QAAQ,CAAC,IAAI;YACX,MAAM,GAAG,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAChG,IAAI,CAAC,MAAM,IAAI,OAAO,KAAK,QAAQ;gBAAE,OAAO;YAC5C,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACtB,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAClI,CAAC;QACD,UAAU,CAAC,IAAI;YACb,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBAClB,OAAO;YACT,CAAC;YACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,0EAA0E;gBAC1E,IAAI,aAAa;oBAAE,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,aAAa,EAAE,mBAAmB,CAAC,CAAC;gBACnF,IAAI,aAAa;oBAAE,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,GAAG,aAAa,CAAC,EAAE,IAAI,aAAa,CAAC,IAAI,EAAE,EAAE,eAAe,GAAG,IAAI,CAAC,CAAC;gBACpH,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;oBAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;QACD,IAAI,OAAO;YACT,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,OAAO;YACT,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import type { BrowserEnv, BrowserOptions, BrowserTracker } from './types.js';
+export type { AnalyticsEvent, Breadcrumb, BreadcrumbType, BrowserEnv, BrowserEvent, BrowserOptions, BrowserTracker, BrowserUser, Consent, IdentifyEvent, PageviewEvent, } from './types.js';
+/** Header da chave do projeto enviado pelo SDK (a API aceita também o legado `x-stread-track-key`). */
+export declare const API_KEY_HEADER = "x-fg-tracker-key";
+export { doNotTrackEnabled, pageUrl, referrerOrigin, screenBucket, utmParams, SESSION_COOKIE, VISITOR_COOKIE } from './analytics.js';
+/** `/orders/42/items/9f…` → `/orders/:id/items/:id` (mesma regra do SDK Node). */
+export declare function normalizePath(input: string | undefined | null): string;
+export declare function toError(input: unknown): {
+    name: string;
+    message: string;
+    stack?: string;
+};
+/** Seletor curto de um elemento clicado: `button#buy.primary` ou texto. */
+export declare function describeTarget(target: EventTarget | null): string;
+export declare function createBrowserTracker(options: BrowserOptions, env?: BrowserEnv): BrowserTracker;
+/** Inicializa uma vez por página; devolve o tracker (também disponível em `getTracker()`). */
+export declare function init(options: BrowserOptions): BrowserTracker;
+export declare function getTracker(): BrowserTracker | null;

package/dist/index.js

@@ -0,0 +1,450 @@
+import { createAnalytics, doNotTrackEnabled } from './analytics.js';
+/** Header da chave do projeto enviado pelo SDK (a API aceita também o legado `x-stread-track-key`). */
+export const API_KEY_HEADER = 'x-fg-tracker-key';
+export { doNotTrackEnabled, pageUrl, referrerOrigin, screenBucket, utmParams, SESSION_COOKIE, VISITOR_COOKIE } from './analytics.js';
+/**
+ * fg-tracker-browser (CONTRATO.md §24): captura erros não tratados, guarda os
+ * últimos breadcrumbs (cliques, navegação, console, fetch) e envia cada erro como
+ * um span `browser` para `POST /v1/ingest` — com release, usuário e página, para a
+ * issue nascer agrupada, simbolizada (source maps) e ligada ao trace da API.
+ */
+const DEFAULT_FLUSH_MS = 1500;
+const DEFAULT_MAX_BREADCRUMBS = 30;
+const MAX_QUEUE = 200;
+const MAX_STACK_LINES = 30;
+const DEDUPE_WINDOW_MS = 1000;
+function randomHex(bytes, env) {
+    const cryptoImpl = (env.window?.crypto ?? globalThis.crypto);
+    const out = new Uint8Array(bytes);
+    if (cryptoImpl?.getRandomValues)
+        cryptoImpl.getRandomValues(out);
+    else
+        for (let i = 0; i < bytes; i += 1)
+            out[i] = Math.floor(Math.random() * 256);
+    return Array.from(out, (b) => b.toString(16).padStart(2, '0')).join('');
+}
+const UUID_RE = /[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/gi;
+/** `/orders/42/items/9f…` → `/orders/:id/items/:id` (mesma regra do SDK Node). */
+export function normalizePath(input) {
+    if (!input)
+        return '/';
+    const path = input.split('?')[0].split('#')[0].replace(UUID_RE, ':id');
+    const out = path
+        .split('/')
+        .map((seg) => (seg && (/^\d+$/.test(seg) || /^[0-9a-f]{16,}$/i.test(seg)) ? ':id' : seg))
+        .join('/') || '/';
+    return out.length > 1 && out.endsWith('/') ? out.slice(0, -1) : out;
+}
+export function toError(input) {
+    if (input instanceof Error) {
+        const out = { name: input.name || 'Error', message: input.message };
+        if (input.stack)
+            out.stack = input.stack.split('\n').slice(0, MAX_STACK_LINES).join('\n');
+        return out;
+    }
+    if (input && typeof input === 'object' && 'message' in input) {
+        const obj = input;
+        return { name: String(obj.name ?? 'Error'), message: String(obj.message ?? ''), ...(typeof obj.stack === 'string' ? { stack: obj.stack } : {}) };
+    }
+    return { name: 'Error', message: typeof input === 'string' ? input : JSON.stringify(input) ?? String(input) };
+}
+function matches(value, patterns) {
+    return !!patterns?.some((pattern) => (pattern instanceof RegExp ? pattern.test(value) : value.includes(pattern)));
+}
+/** Seletor curto de um elemento clicado: `button#buy.primary` ou texto. */
+export function describeTarget(target) {
+    const el = target;
+    if (!el || typeof el.tagName !== 'string')
+        return 'unknown';
+    let out = el.tagName.toLowerCase();
+    if (el.id)
+        out += `#${el.id}`;
+    const classes = typeof el.className === 'string' ? el.className.trim().split(/\s+/).filter(Boolean).slice(0, 2) : [];
+    if (classes.length)
+        out += `.${classes.join('.')}`;
+    const text = (el.textContent ?? '').trim().replace(/\s+/g, ' ').slice(0, 40);
+    const label = el.getAttribute?.('aria-label') ?? el.getAttribute?.('data-testid');
+    if (label)
+        out += `[${label}]`;
+    else if (text)
+        out += ` "${text}"`;
+    return out;
+}
+function shouldPropagate(url, targets, origin) {
+    if (!targets)
+        return !!origin && url.origin === origin;
+    return targets.some((t) => (t instanceof RegExp ? t.test(url.href) : t.startsWith('http') ? url.href.startsWith(t) : url.host === t || url.hostname === t || url.hostname.endsWith(`.${t}`)));
+}
+export function createBrowserTracker(options, env = globalThis) {
+    const endpoint = options.endpoint.replace(/\/+$/, '');
+    const enabled = Boolean(options.apiKey);
+    const maxBreadcrumbs = Math.max(5, options.maxBreadcrumbs ?? DEFAULT_MAX_BREADCRUMBS);
+    const crumbs = [];
+    const queue = [];
+    const analyticsQueue = [];
+    const baseFetch = env.fetch ?? env.window?.fetch?.bind(env.window);
+    let user = options.user ?? null;
+    let extra = { ...(options.attributes ?? {}) };
+    let lastSignature = '';
+    let lastAt = 0;
+    let timer = null;
+    const cleanups = [];
+    const crumbOn = (type) => options.breadcrumbs?.[type] !== false;
+    const log = (...args) => {
+        if (options.debug)
+            (env.console ?? console).info('[fg-tracker-browser]', ...args);
+    };
+    const now = () => new Date().toISOString();
+    const addBreadcrumb = (crumb) => {
+        crumbs.push({ ...crumb, ts: crumb.ts ?? now() });
+        if (crumbs.length > maxBreadcrumbs)
+            crumbs.splice(0, crumbs.length - maxBreadcrumbs);
+    };
+    const baseAttributes = () => {
+        const loc = env.location ?? env.window?.location;
+        const nav = env.navigator ?? env.window?.navigator;
+        const attrs = {
+            ...extra,
+            url: loc?.href ?? null,
+            page: loc ? normalizePath(loc.pathname) : null,
+            userAgent: nav?.userAgent ?? null,
+            language: nav?.language ?? null,
+            viewport: env.window ? `${env.window.innerWidth}x${env.window.innerHeight}` : null,
+            client: 'browser',
+        };
+        if (options.serviceName)
+            attrs.serviceName = options.serviceName;
+        if (options.release)
+            attrs.release = options.release;
+        if (options.environment)
+            attrs.environment = options.environment;
+        if (user) {
+            attrs['user.id'] = String(user.id);
+            if (user.email)
+                attrs['user.email'] = user.email;
+            if (user.name)
+                attrs['user.name'] = user.name;
+        }
+        return attrs;
+    };
+    const enqueue = (event) => {
+        if (!enabled)
+            return;
+        let out = event;
+        if (options.beforeSend) {
+            try {
+                out = options.beforeSend(event);
+            }
+            catch {
+                out = event;
+            }
+        }
+        if (!out)
+            return;
+        queue.push(out);
+        if (queue.length > MAX_QUEUE)
+            queue.splice(0, queue.length - MAX_QUEUE);
+    };
+    const send = async (events, analyticsEvents = [], useBeacon = false) => {
+        if (events.length === 0 && analyticsEvents.length === 0)
+            return true;
+        const byTrace = new Map();
+        for (const event of events) {
+            const { traceId, ...rest } = event;
+            byTrace.set(traceId, [...(byTrace.get(traceId) ?? []), rest]);
+        }
+        const payload = { traces: [...byTrace].map(([traceId, spans]) => ({ traceId, spans })) };
+        if (analyticsEvents.length > 0)
+            payload.analytics = analyticsEvents;
+        const body = JSON.stringify(payload);
+        const url = `${endpoint}/v1/ingest?key=${encodeURIComponent(options.apiKey)}`;
+        const nav = env.navigator ?? env.window?.navigator;
+        if (useBeacon && nav?.sendBeacon) {
+            try {
+                // text/plain é "simples" para CORS: o beacon sai sem preflight; a API aceita JSON nesse content-type.
+                if (nav.sendBeacon(url, new Blob([body], { type: 'text/plain;charset=UTF-8' })))
+                    return true;
+            }
+            catch {
+                /* cai no fetch */
+            }
+        }
+        if (!baseFetch)
+            return false;
+        try {
+            const res = await baseFetch(`${endpoint}/v1/ingest`, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json', [API_KEY_HEADER]: options.apiKey },
+                body,
+                keepalive: true,
+            });
+            log('enviados', events.length, 'eventos e', analyticsEvents.length, 'de analytics →', res.status);
+            return res.ok || res.status < 500;
+        }
+        catch (err) {
+            log('falha no envio', err);
+            return false;
+        }
+    };
+    let flushing = null;
+    const flush = async () => {
+        if (flushing)
+            await flushing;
+        if (queue.length === 0 && analyticsQueue.length === 0)
+            return;
+        const batch = queue.splice(0, queue.length);
+        const analyticsBatch = analyticsQueue.splice(0, analyticsQueue.length);
+        flushing = send(batch, analyticsBatch)
+            .then((ok) => {
+            if (!ok) {
+                queue.unshift(...batch.slice(-50));
+                analyticsQueue.unshift(...analyticsBatch.slice(-100));
+            }
+        })
+            .finally(() => {
+            flushing = null;
+        });
+        return flushing;
+    };
+    const capture = (error, attributes = {}, level = 'error') => {
+        if (!enabled)
+            return;
+        const err = toError(error);
+        const signature = `${err.name}|${err.message}`;
+        const at = Date.now();
+        if (matches(signature, options.ignoreErrors))
+            return;
+        if (signature === lastSignature && at - lastAt < DEDUPE_WINDOW_MS)
+            return;
+        lastSignature = signature;
+        lastAt = at;
+        if ((options.sampleRate ?? 1) < 1 && Math.random() >= (options.sampleRate ?? 1))
+            return;
+        const loc = env.location ?? env.window?.location;
+        const startedAt = now();
+        enqueue({
+            traceId: randomHex(16, env),
+            spanId: randomHex(8, env),
+            parentSpanId: null,
+            kind: 'browser',
+            name: `page:${loc ? normalizePath(loc.pathname) : '/'}`,
+            method: null,
+            route: loc ? normalizePath(loc.pathname) : null,
+            statusCode: null,
+            startedAt,
+            endedAt: startedAt,
+            durationMs: 0,
+            attributes: { ...baseAttributes(), ...attributes, level, breadcrumbs: crumbs.slice(-maxBreadcrumbs) },
+            error: level === 'error' || level === 'warning' ? err : null,
+        });
+        addBreadcrumb({ type: 'error', level: level === 'info' ? 'info' : 'error', message: `${err.name}: ${err.message}`.slice(0, 200) });
+        void flush();
+    };
+    /* --------------------------------------------------------------- fetch */
+    const trackedFetch = async (input, init) => {
+        if (!baseFetch)
+            throw new Error('fetch indisponível');
+        const raw = typeof input === 'string' ? input : input instanceof URL ? input.toString() : input.url;
+        let url = null;
+        try {
+            url = new URL(raw, (env.location ?? env.window?.location)?.href);
+        }
+        catch {
+            url = null;
+        }
+        if (!url || raw.startsWith(endpoint))
+            return baseFetch(input, init);
+        const method = (init?.method ?? (input instanceof Request ? input.method : 'GET')).toUpperCase();
+        const sampled = enabled && (options.tracesSampleRate ?? 0) > 0 && Math.random() < (options.tracesSampleRate ?? 0);
+        const origin = (env.location ?? env.window?.location)?.origin;
+        const traceId = randomHex(16, env);
+        const rootId = randomHex(8, env);
+        const spanId = randomHex(8, env);
+        let request = { input, init };
+        if (sampled && shouldPropagate(url, options.propagateTraceTo, origin)) {
+            const headers = new Headers(init?.headers ?? (input instanceof Request ? input.headers : undefined));
+            headers.set('traceparent', `00-${traceId}-${spanId}-01`);
+            request = { input, init: { ...init, headers } };
+        }
+        const started = Date.now();
+        const startedAt = new Date(started).toISOString();
+        let status = null;
+        let failure = null;
+        try {
+            const res = await baseFetch(request.input, request.init);
+            status = res.status;
+            return res;
+        }
+        catch (err) {
+            failure = toError(err);
+            throw err;
+        }
+        finally {
+            const durationMs = Date.now() - started;
+            if (crumbOn('fetch'))
+                addBreadcrumb({ type: 'fetch', category: 'http', level: status && status >= 500 ? 'error' : failure ? 'error' : 'info', message: `${method} ${url.origin}${normalizePath(url.pathname)} → ${status ?? failure?.name ?? '?'}`, data: { method, url: url.href, status, durationMs } });
+            if (sampled) {
+                const loc = env.location ?? env.window?.location;
+                const endedAt = new Date(started + durationMs).toISOString();
+                enqueue({ traceId, spanId: rootId, parentSpanId: null, kind: 'browser', name: `page:${loc ? normalizePath(loc.pathname) : '/'}`, method: null, route: loc ? normalizePath(loc.pathname) : null, statusCode: null, startedAt, endedAt, durationMs, attributes: { ...baseAttributes(), sampled: true }, error: null });
+                enqueue({ traceId, spanId, parentSpanId: rootId, kind: 'http.client', name: `${method} ${url.origin}${normalizePath(url.pathname)}`, method, route: normalizePath(url.pathname), statusCode: status, startedAt, endedAt, durationMs, attributes: { url: url.href, host: url.host, propagated: shouldPropagate(url, options.propagateTraceTo, origin), ...(options.serviceName ? { serviceName: options.serviceName } : {}), ...(options.release ? { release: options.release } : {}) }, error: status && status >= 500 ? { name: 'HttpError', message: `HTTP ${status}` } : failure });
+            }
+        }
+    };
+    /* ------------------------------------------------------------ analytics */
+    const analyticsRequested = options.analytics === true || options.trackPageviews === true;
+    const analytics = enabled && analyticsRequested && !doNotTrackEnabled(env)
+        ? createAnalytics(env, {
+            consent: options.consent ?? 'granted',
+            cookieDomain: options.cookieDomain,
+            sanitizePath: options.sanitizePath ?? normalizePath,
+            onEvent: (event) => {
+                analyticsQueue.push(event);
+                if (analyticsQueue.length > MAX_QUEUE)
+                    analyticsQueue.splice(0, analyticsQueue.length - MAX_QUEUE);
+            },
+        })
+        : null;
+    if (enabled && analyticsRequested && !analytics)
+        log('Do Not Track ligado: analytics desativada');
+    const autoPageviews = !!analytics && (options.trackPageviews ?? options.analytics) !== false;
+    /* ------------------------------------------------------------ listeners */
+    const win = env.window;
+    if (win && enabled) {
+        if (options.captureGlobalErrors !== false) {
+            const onError = (event) => {
+                if (!event.error && !event.message)
+                    return;
+                capture(event.error ?? new Error(event.message), { source: event.filename ?? null, line: event.lineno ?? null, column: event.colno ?? null, mechanism: 'onerror' });
+            };
+            const onRejection = (event) => capture(event.reason ?? new Error('Unhandled rejection'), { mechanism: 'unhandledrejection' });
+            win.addEventListener('error', onError);
+            win.addEventListener('unhandledrejection', onRejection);
+            cleanups.push(() => win.removeEventListener('error', onError), () => win.removeEventListener('unhandledrejection', onRejection));
+        }
+        const doc = env.document ?? win.document;
+        if (doc && crumbOn('click')) {
+            const onClick = (event) => addBreadcrumb({ type: 'click', category: 'ui', message: describeTarget(event.target) });
+            doc.addEventListener('click', onClick, true);
+            cleanups.push(() => doc.removeEventListener('click', onClick, true));
+        }
+        if (crumbOn('navigation') || autoPageviews) {
+            const hist = env.history ?? win.history;
+            const loc = env.location ?? win.location;
+            const record = (from, to) => {
+                if (crumbOn('navigation'))
+                    addBreadcrumb({ type: 'navigation', category: 'navigation', message: `${from} → ${to}`, data: { from, to } });
+            };
+            // Pageview depois da troca de URL (pushState/replaceState/popstate); o dedupe ignora a mesma URL.
+            const pageview = () => {
+                if (autoPageviews)
+                    analytics?.page();
+            };
+            const onPop = () => {
+                record('(back/forward)', loc.pathname);
+                pageview();
+            };
+            win.addEventListener('popstate', onPop);
+            cleanups.push(() => win.removeEventListener('popstate', onPop));
+            if (hist && typeof hist.pushState === 'function') {
+                const originalPush = hist.pushState;
+                const originalReplace = hist.replaceState;
+                hist.pushState = (data, unused, url) => {
+                    const from = loc.pathname;
+                    originalPush.call(hist, data, unused, url);
+                    record(from, url ? String(url) : loc.pathname);
+                    pageview();
+                };
+                hist.replaceState = (data, unused, url) => {
+                    originalReplace.call(hist, data, unused, url);
+                    pageview();
+                };
+                cleanups.push(() => {
+                    hist.pushState = originalPush;
+                    hist.replaceState = originalReplace;
+                });
+            }
+        }
+        if (crumbOn('console')) {
+            const con = env.console ?? win.console;
+            for (const level of ['error', 'warn']) {
+                const original = con[level].bind(con);
+                con[level] = (...args) => {
+                    addBreadcrumb({ type: 'console', category: 'console', level: level === 'error' ? 'error' : 'warning', message: args.map((a) => (typeof a === 'string' ? a : toError(a).message)).join(' ').slice(0, 300) });
+                    original(...args);
+                };
+                cleanups.push(() => {
+                    con[level] = original;
+                });
+            }
+        }
+        if (crumbOn('fetch') && typeof win.fetch === 'function') {
+            const original = win.fetch;
+            win.fetch = trackedFetch;
+            cleanups.push(() => {
+                win.fetch = original;
+            });
+        }
+        const onHide = () => {
+            if (queue.length > 0 || analyticsQueue.length > 0)
+                void send(queue.splice(0, queue.length), analyticsQueue.splice(0, analyticsQueue.length), true);
+        };
+        win.addEventListener('pagehide', onHide);
+        cleanups.push(() => win.removeEventListener('pagehide', onHide));
+        // Pageview da carga inicial.
+        if (autoPageviews)
+            analytics?.page();
+        timer = setInterval(() => {
+            // Rede de segurança para roteadores que trocam a URL sem passar pelo history patchado.
+            if (autoPageviews)
+                analytics?.page();
+            void flush();
+        }, Math.max(500, options.flushIntervalMs ?? DEFAULT_FLUSH_MS));
+        timer.unref?.(); // em Node (testes/SSR) não segura o processo
+    }
+    if (!enabled)
+        (env.console ?? console).warn('[fg-tracker-browser] apiKey ausente: SDK desabilitado.');
+    return {
+        captureException: (error, attributes) => capture(error, attributes, 'error'),
+        captureMessage: (message, level = 'info', attributes) => capture(new Error(message), { ...attributes, isMessage: true }, level),
+        addBreadcrumb,
+        setUser: (next) => {
+            user = next;
+        },
+        setAttribute: (key, value) => {
+            extra = { ...extra, [key]: value };
+        },
+        fetch: trackedFetch,
+        flush,
+        page: (path) => {
+            analytics?.page(path);
+        },
+        identify: (userId) => {
+            analytics?.identify(userId);
+        },
+        setConsent: (consent) => {
+            analytics?.setConsent(consent);
+        },
+        close: () => {
+            for (const cleanup of cleanups.splice(0))
+                cleanup();
+            if (timer)
+                clearInterval(timer);
+            timer = null;
+        },
+        get breadcrumbs() {
+            return crumbs;
+        },
+    };
+}
+let current = null;
+/** Inicializa uma vez por página; devolve o tracker (também disponível em `getTracker()`). */
+export function init(options) {
+    current?.close();
+    current = createBrowserTracker(options);
+    return current;
+}
+export function getTracker() {
+    return current;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,151 @@
+/** Tipos públicos do fg-tracker-browser (CONTRATO.md §24). */
+export interface BrowserUser {
+    id: string | number;
+    email?: string;
+    name?: string;
+}
+export type BreadcrumbType = 'click' | 'navigation' | 'console' | 'fetch' | 'xhr' | 'error' | 'custom';
+export interface Breadcrumb {
+    type: BreadcrumbType;
+    /** Momento (ISO). */
+    ts: string;
+    message?: string;
+    category?: string;
+    level?: 'info' | 'warning' | 'error';
+    data?: Record<string, unknown>;
+}
+export interface BrowserOptions {
+    /** Chave do projeto (`stk_...`). */
+    apiKey: string;
+    /** URL base da API do FG Tracker. */
+    endpoint: string;
+    /** Nome da aplicação (`attributes.serviceName`), ex.: `phase-web`. */
+    serviceName?: string;
+    /** Versão publicada — o mesmo valor usado no upload dos source maps (`web@<sha>`). */
+    release?: string;
+    environment?: string;
+    /** Usuário inicial (pode ser mudado com `setUser`). */
+    user?: BrowserUser | null;
+    /** Fração de erros enviados (0..1). Default 1. */
+    sampleRate?: number;
+    /** Fração de chamadas `fetch` que viram traces (com `traceparent` para a API). Default 0. */
+    tracesSampleRate?: number;
+    /** Origens que recebem `traceparent` (host, prefixo ou RegExp). Default: mesma origem da página. */
+    propagateTraceTo?: (string | RegExp)[];
+    /** Erros (nome ou mensagem) ignorados. */
+    ignoreErrors?: (string | RegExp)[];
+    /** Último filtro: altere o evento ou devolva `null` para descartar. */
+    beforeSend?: (event: BrowserEvent) => BrowserEvent | null;
+    /** Quais breadcrumbs coletar. Default: todos. */
+    breadcrumbs?: Partial<Record<Exclude<BreadcrumbType, 'error' | 'custom'>, boolean>>;
+    /** Tamanho do buffer de breadcrumbs. Default 30. */
+    maxBreadcrumbs?: number;
+    /** Atributos fixos em todo evento (ex.: `{ 'phase.client': 'pwa' }`). */
+    attributes?: Record<string, unknown>;
+    /** Envia erros automaticamente (`window.onerror`, `unhandledrejection`). Default true. */
+    captureGlobalErrors?: boolean;
+    /** Intervalo de envio em ms. Default 1500. */
+    flushIntervalMs?: number;
+    debug?: boolean;
+    /**
+     * Liga a analytics de tráfego (§25): visitantes anônimos (`fgt_vid`/`fgt_sid`) e pageviews.
+     * Default `false` — quem já usa o SDK só para erros não muda de comportamento.
+     */
+    analytics?: boolean;
+    /** Pageviews automáticos (carga inicial + navegação SPA). Default = `analytics`. */
+    trackPageviews?: boolean;
+    /**
+     * Consentimento para analytics (não afeta a captura de erros). `pending` guarda os eventos
+     * em memória, sem gravar cookies, até `setConsent('granted')`; `denied` descarta. Default `granted`.
+     */
+    consent?: Consent;
+    /** Domínio dos cookies (ex.: `.fortground.com.br` para compartilhar o visitante entre subdomínios). */
+    cookieDomain?: string;
+    /**
+     * Transforma o caminho antes do envio; devolva `null` para não registrar a página.
+     * Default: `normalizePath` (números, uuids e hashes viram `:id`, sem query/hash).
+     */
+    sanitizePath?: (path: string) => string | null;
+}
+export type Consent = 'granted' | 'denied' | 'pending';
+/** Pageview no formato do `POST /v1/ingest` (`analytics[]`). Sem PII: caminho sem query (exceto `utm_*`), referrer só com a origem. */
+export interface PageviewEvent {
+    type: 'pageview';
+    /** Caminho + `utm_*` (ex.: `/precos?utm_source=instagram`). */
+    url: string;
+    title?: string;
+    /** Origem do referrer externo (`https://www.google.com`) ou `null`. */
+    referrer: string | null;
+    utm_source?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+    utm_term?: string;
+    utm_content?: string;
+    screen: 'mobile' | 'tablet' | 'desktop' | null;
+    locale: string | null;
+    visitor_id: string;
+    session_id: string;
+    /** Id do usuário após `identify` (a API guarda só o hash). */
+    user_id?: string;
+    ts: string;
+}
+/** Liga o visitante anônimo a um usuário (a API guarda só o hash do id). */
+export interface IdentifyEvent {
+    type: 'identify';
+    user_id: string;
+    visitor_id: string;
+    session_id: string;
+    ts: string;
+}
+export type AnalyticsEvent = PageviewEvent | IdentifyEvent;
+/** Evento (span `browser`) no formato do `POST /v1/ingest`. */
+export interface BrowserEvent {
+    traceId: string;
+    spanId: string;
+    parentSpanId: string | null;
+    kind: 'browser' | 'http.client';
+    name: string;
+    method: string | null;
+    route: string | null;
+    statusCode: number | null;
+    startedAt: string;
+    endedAt: string;
+    durationMs: number;
+    attributes: Record<string, unknown>;
+    error: {
+        name: string;
+        message: string;
+        stack?: string;
+    } | null;
+}
+export interface BrowserTracker {
+    captureException(error: unknown, attributes?: Record<string, unknown>): void;
+    captureMessage(message: string, level?: 'info' | 'warning' | 'error', attributes?: Record<string, unknown>): void;
+    addBreadcrumb(crumb: Omit<Breadcrumb, 'ts'> & {
+        ts?: string;
+    }): void;
+    setUser(user: BrowserUser | null): void;
+    setAttribute(key: string, value: unknown): void;
+    /** `fetch` instrumentado (breadcrumb + trace amostrado com `traceparent`). */
+    fetch: typeof globalThis.fetch;
+    flush(): Promise<void>;
+    /** Pageview manual (default: a URL atual). Ignorado sem `analytics`/`trackPageviews`, com Do Not Track ou `consent: denied`. */
+    page(path?: string): void;
+    /** Liga o visitante anônimo ao usuário logado (`null` desliga). O id é guardado só como hash na API. */
+    identify(userId: string | number | null): void;
+    /** Atualiza o consentimento de analytics; `granted` libera a fila retida em `pending`. */
+    setConsent(consent: Consent): void;
+    /** Remove os listeners globais e o patch do fetch. */
+    close(): void;
+    readonly breadcrumbs: readonly Breadcrumb[];
+}
+/** Superfície mínima do ambiente (injetável em testes). */
+export interface BrowserEnv {
+    window?: Window & typeof globalThis;
+    document?: Document;
+    navigator?: Navigator;
+    location?: Location;
+    fetch?: typeof globalThis.fetch;
+    console?: Console;
+    history?: History;
+}

package/dist/types.js

@@ -0,0 +1,3 @@
+/** Tipos públicos do fg-tracker-browser (CONTRATO.md §24). */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8DAA8D"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "fg-tracker-browser",
+  "version": "0.2.0",
+  "description": "SDK de navegador do FG Tracker: erros não tratados, breadcrumbs (cliques, navegação, console, fetch), usuário, release e propagação de trace para a API",
+  "license": "UNLICENSED",
+  "homepage": "https://github.com/FORTGROUND/fg-tracker/tree/main/packages/browser#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/FORTGROUND/fg-tracker.git",
+    "directory": "packages/browser"
+  },
+  "bugs": {
+    "url": "https://github.com/FORTGROUND/fg-tracker/issues"
+  },
+  "keywords": [
+    "fg-tracker",
+    "browser",
+    "error-tracking",
+    "breadcrumbs",
+    "sourcemaps",
+    "tracing",
+    "analytics",
+    "pageviews"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "browser": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist",
+    "test": "node --test test/*.test.mjs",
+    "prepack": "npm run clean && npm run build"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}