fg-tracker-sdk 0.4.0

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog — fg-tracker-sdk
+
+## 0.4.0 — 2026-09-15
+
+- **Renomeado de `stread-track-sdk` — nomes antigos continuam funcionando e serão removidos na 1.0.** Veja "Migração de stread-track-sdk" no README.
+- Bins `fg-tracker-release` e `fg-tracker-sourcemaps`; `stread-track-release` e `stread-track-sourcemaps` continuam como aliases obsoletos (avisam no stderr).
+- Variáveis `FG_TRACKER_KEY`, `FG_TRACKER_URL`, `FG_TRACKER_RELEASE`, `FG_TRACKER_ENV` e `FG_TRACKER_SERVICE`, lidas antes dos nomes legados `STREAD_TRACK_*` (que seguem como fallback).
+- Header da chave passa a ser `x-fg-tracker-key` (a API aceita também o legado `x-stread-track-key`). Requer a API do FG Tracker com suporte ao header novo.
+- `FgTrackerTransport` (winston) e o tipo `FgTrackerNestLogger`; `StreadTrackTransport` e `StreadTrackNestLogger` ficam como aliases `@deprecated`.
+- Novos exports: `API_KEY_HEADER`, `DEFAULT_ENDPOINT` (continua `http://localhost:4050`) e `readEnv()`.
+- `instrumentPg` reconhece pools já instrumentados pelo `stread-track-sdk` (não duplica spans).
+- Prefixo dos avisos no console: `[fg-tracker]`.
+- `package.json`: repositório `FORTGROUND/fg-tracker`, `publishConfig.access: public`, `prepack` limpa e recompila `dist/`.
+
+## 0.3.0
+
+- Última versão publicada como `stread-track-sdk`.

package/README.md

@@ -0,0 +1,375 @@
+# fg-tracker-sdk
+
+Instrumentação Node para o [FG Tracker](../../README.md) e envio de logs (pino, winston, NestJS Logger). Única dependência de runtime: `pino-abstract-transport`; usa `AsyncLocalStorage` para encadear spans e o `fetch` global do Node para enviar lotes ao `POST /v1/ingest`.
+
+Requisitos: Node ≥ 20 (recomendado 24). O pacote é ESM; em projetos CommonJS (NestJS) funciona com `require()` no Node ≥ 22.12 ou via `import()` dinâmico.
+
+## Instalação
+
+```bash
+pnpm add fg-tracker-sdk              # publicado no npm
+# ou, dentro do workspace:
+# "fg-tracker-sdk": "workspace:*"
+```
+
+## Endpoint
+
+O default de `endpoint` é `http://localhost:4050` (constante `DEFAULT_ENDPOINT`, API local do monorepo). Em produção passe a URL da API mostrada no painel em **Conectar** (por exemplo via `FG_TRACKER_URL`). O domínio `https://tracker-api.fortground.com.br` será o endereço definitivo da API; até ele entrar no ar, use a URL atual do painel.
+
+## API
+
+```ts
+import { createTracker } from 'fg-tracker-sdk';
+
+const tracker = createTracker({
+  apiKey: process.env.FG_TRACKER_KEY!,   // stk_...
+  endpoint: 'http://localhost:4050',       // default
+  serviceName: 'minha-app',
+  flushIntervalMs: 2000,                   // default
+});
+
+app.use(tracker.express());                 // Express / NestJS (platform-express)
+tracker.instrumentPg(pool);                 // pg.Pool → spans db.query com query normalizada
+await tracker.span('custom', 'send-email', async (span) => { span.setAttribute('to', email); });
+export const GET = tracker.wrapNextRoute(async (req) => Response.json({ ok: true }));
+const fetchTracked = tracker.wrapFetch();   // fetch instrumentado → spans http.client
+await tracker.flush(); await tracker.shutdown();
+```
+
+| opção | default | descrição |
+|---|---|---|
+| `apiKey` | — | chave do projeto; sem ela o tracker vira no-op (com aviso) |
+| `endpoint` | `http://localhost:4050` | URL base da API |
+| `serviceName` | — | vai em `attributes.serviceName` de todo span |
+| `flushIntervalMs` | `2000` | intervalo de envio |
+| `maxBatchSize` | `200` | ≥ N spans na fila dispara envio imediato |
+| `maxQueueSize` | `5000` | acima disso descarta os spans mais antigos |
+| `enabled` | `true` | `false` desliga tudo sem tirar o código |
+| `debug` | `false` | loga cada envio |
+| `release` | detectada | versão em execução (`FG_TRACKER_RELEASE`, `GITHUB_SHA`, `VERCEL_GIT_COMMIT_SHA`… → `${serviceName}@${sha}`); `false` desliga |
+| `environment` | detectado | `FG_TRACKER_ENV`, `APP_ENV` ou `NODE_ENV`; `false` desliga |
+| `propagateTraceTo` | `true` | destinos que recebem `traceparent` no fetch instrumentado (`true`, lista de hosts/prefixos/RegExp ou `false`) |
+| `instrumentGlobalFetch` | `false` | substitui `globalThis.fetch` pelo fetch instrumentado (provedores externos viram spans) |
+| `captureGlobalErrors` | `false` | `uncaughtExceptionMonitor` + `unhandledRejection` viram spans com erro |
+| `tracesSampleRate` | `1` | fração de traces enviados (decidida na raiz; filhos seguem; `traceparent` sai com `-00` quando não amostrado) |
+| `tracesSampler` | — | `(ctx: { kind, name, attributes, parentSampled? }) => taxa` por operação (ex.: `0` para `GET /health`) |
+| `ignoreTransactions` | `[]` | nomes de raiz (string/RegExp) que nunca são enviados |
+| `ignoreErrors` | `[]` | erros (`name: message`, string/RegExp) que não viram issue (`attributes.ignoredError = true`) |
+| `scrubFields` | `DEFAULT_SCRUB_FIELDS` | chaves de atributos que viram `[Filtered]` (password, token, authorization, cookie, cpf…); `false` desliga |
+| `beforeSend` | — | `(span) => span \| null`, último filtro antes da fila |
+
+## Erros, usuários, releases e jobs
+
+```ts
+app.use(tracker.express());                  // continua `traceparent` de outro serviço; associa req.user.id ao fim
+app.use(routes);
+app.use(tracker.expressErrorHandler());      // exceção real no span → issues agrupadas por causa, não por status
+
+tracker.setUser({ id: user.id, email: user.email });     // impacto por usuário nas issues
+tracker.captureException(err, { stage: 'checkout' });   // em filtros do Nest / catch de jobs
+tracker.traceHeaders();                                  // { traceparent } para clientes HTTP não instrumentados
+tracker.currentTraceId();                                // para logs / x-trace-id
+
+await tracker.checkIn('backup-diario', () => runBackup(), { intervalSeconds: 86400, graceSeconds: 600 }); // monitor de job
+const run = await tracker.monitor('sync').start(); /* ... */ await run.ok(); // ou run.fail(err)
+
+await tracker.registerRelease({ commitSha: process.env.GITHUB_SHA, repository: 'FORTGROUND/phase' }); // ou o CLI:
+// FG_TRACKER_KEY=stk_... npx fg-tracker-release --service minha-app --previous-sha $PREV --env production
+```
+
+O CLI `fg-tracker-release` lê `git log`/`git show` e envia commits, arquivos e intervalos de linhas alterados: o painel usa isso para apontar **commits/PRs suspeitos** em cada issue e comparar a latência de cada rota entre releases.
+
+Jobs com crontab: `tracker.checkIn('relatorio', run, { cron: '0 3 * * *', timezone: 'America/Sao_Paulo', maxRuntimeSeconds: 1800 })` — o monitor calcula o próximo disparo no fuso, marca `timeout` quando passa do tempo máximo e aceita `failureThreshold`/`recoveryThreshold` na tela.
+
+Source maps do front (para o `fg-tracker-browser`): `FG_TRACKER_KEY=stk_... npx fg-tracker-sourcemaps --dir dist --release web@$GITHUB_SHA --url-prefix ~/assets` sobe os `.map` de uma release; a API traduz o stack minificado na ingestão.
+
+Falhas de envio são logadas **uma vez** e o lote é reenviado no próximo flush (respostas 4xx descartam o lote — normalmente é chave inválida). O timer usa `unref()`, então não segura o processo vivo; chame `shutdown()` no encerramento para não perder os últimos spans.
+
+## Express
+
+```ts
+import express from 'express';
+import { createTracker } from 'fg-tracker-sdk';
+
+const tracker = createTracker({ apiKey: process.env.FG_TRACKER_KEY!, serviceName: 'minha-api' });
+const app = express();
+app.use(tracker.express());          // ANTES de qualquer outro middleware/rota
+app.get('/users/:id', async (req, res) => { /* ... */ });
+
+process.on('SIGTERM', () => tracker.shutdown().finally(() => process.exit(0)));
+```
+
+O middleware cria um span raiz `http.server` por request. O nome é `${method} ${route}`; a rota vem de `req.baseUrl + req.route.path` (disponível no `finish` da resposta), com fallback para o path com uuids/números trocados por `:id`. Atributos: `url`, `userAgent`, `ip`. Status ≥ 500 vira `error`.
+
+## NestJS (platform-express)
+
+```ts
+// src/main.ts
+import { NestFactory } from '@nestjs/core';
+import { createTracker } from 'fg-tracker-sdk';
+import { AppModule } from './app.module';
+
+export const tracker = createTracker({ apiKey: process.env.FG_TRACKER_KEY!, serviceName: 'minha-api' });
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+  app.use(tracker.express());        // antes de helmet/cors/pipes
+  app.enableShutdownHooks();
+  await app.listen(4040);
+}
+bootstrap();
+```
+
+Para encerrar limpo, chame `tracker.shutdown()` num `OnApplicationShutdown` (ou no handler de SIGTERM).
+
+## Next.js (App Router)
+
+```ts
+// src/lib/tracker.ts
+import { createTracker } from 'fg-tracker-sdk';
+export const tracker = createTracker({ apiKey: process.env.FG_TRACKER_KEY!, serviceName: 'meu-site' });
+
+// app/api/users/[id]/route.ts
+import { tracker } from '@/lib/tracker';
+export const GET = tracker.wrapNextRoute(async (req, ctx) => {
+  const user = await db.query('select * from users where id = $1', [id]);
+  return Response.json(user);
+});
+```
+
+O span `http.server` recebe `${method} ${pathname normalizado}` e o status da `Response`. Só funciona no runtime Node (não no Edge). Em `output: 'export'` não há route handlers dinâmicos, então nada a instrumentar.
+
+## pg
+
+```ts
+import { Pool } from 'pg';
+const pool = new Pool({ connectionString: process.env.DATABASE_URL });
+tracker.instrumentPg(pool);
+```
+
+`pool.query` passa a gerar spans `db.query` **apenas quando há um span pai** no contexto (request em andamento ou `tracker.span`). O nome é o SQL normalizado — números → `?`, strings → `'?'`, `IN (...)` → `IN (?)`, espaços colapsados, minúsculas, 200 chars — e `attributes.rows` recebe o `rowCount`. Todas as assinaturas de `query` são suportadas (promise ou callback). Queries repetidas ≥ `loop_threshold` vezes no mesmo request viram uma issue **N_PLUS_ONE** na API.
+
+Se você usa drizzle/kysely/knex sobre `pg.Pool`, instrumente o pool antes de passá-lo ao ORM.
+
+## fetch
+
+```ts
+const fetchTracked = tracker.wrapFetch();       // envolve globalThis.fetch
+const res = await fetchTracked('https://api.github.com/repos/FORTGROUND/fg-tracker');
+
+// ou globalmente (cuidado: afeta todo o processo)
+globalThis.fetch = tracker.wrapFetch(globalThis.fetch);
+```
+
+Cada chamada vira um span `http.client` nomeado `${method} ${origin}${pathname normalizado}` (ex.: `GET https://api.github.com/repos/:id`). É isso que alimenta a detecção de **LOOP**: a mesma chamada repetida ≥ `loop_threshold` vezes sob o mesmo pai. Chamadas ao próprio endpoint do FG Tracker são ignoradas.
+
+## Spans manuais
+
+```ts
+await tracker.span('custom', 'render-pdf', async (span) => {
+  span.setAttribute('pages', 12);
+  // exceções são capturadas em span.error e relançadas
+});
+
+// ou controle total
+const span = tracker.startSpan('custom', 'warmup-cache');
+try { /* ... */ } finally { span.end(); }
+
+tracker.currentSpan()?.setAttribute('userId', user.id);
+```
+
+## Ingestão crua (qualquer linguagem)
+
+Não precisa do SDK: basta enviar o body do contrato com a chave no header.
+
+```bash
+curl -X POST http://localhost:4050/v1/ingest \
+  -H 'content-type: application/json' \
+  -H 'x-fg-tracker-key: stk_demo_0000000000000000000000000000' \
+  -d '{
+    "traces": [{
+      "traceId": "0123456789abcdef0123456789abcdef",
+      "spans": [
+        { "spanId": "0123456789abcdef", "parentSpanId": null, "kind": "http.server", "name": "GET /users/:id",
+          "method": "GET", "route": "/users/:id", "statusCode": 200,
+          "startedAt": "2026-09-12T12:00:00.000Z", "endedAt": "2026-09-12T12:00:00.123Z", "durationMs": 123.4,
+          "attributes": { "url": "/users/42" }, "error": null },
+        { "spanId": "fedcba9876543210", "parentSpanId": "0123456789abcdef", "kind": "db.query",
+          "name": "select * from users where id = ?", "method": null, "route": null, "statusCode": null,
+          "startedAt": "2026-09-12T12:00:00.010Z", "endedAt": "2026-09-12T12:00:00.050Z", "durationMs": 40,
+          "attributes": { "rows": 1 }, "error": null }
+      ]
+    }]
+  }'
+# → 202 { "accepted": 2, "issuesDetected": 0 }
+```
+
+## Logs (`POST /v1/logs`)
+
+O SDK envia linhas de log para a plataforma em lote (`flushIntervalMs` 2 s, `maxBatch` 200, fila de 5000 descartando as mais antigas, 5xx/rede tenta de novo uma vez e devolve o lote ao próximo flush, 4xx descarta). Quando a linha nasce dentro de um span do tracker (request Express/Nest, `tracker.span`), `traceId`/`spanId` são anexados automaticamente e a linha aparece ligada ao trace no explorador `/logs`.
+
+### Shipper cru
+
+```ts
+import { createLogShipper } from 'fg-tracker-sdk';
+
+const logs = createLogShipper({ apiKey: process.env.FG_TRACKER_KEY!, endpoint: 'http://localhost:4050', service: 'minha-api', env: 'production', tracker });
+logs.push({ level: 'info', message: 'user logged in', context: { userId: 42 }, requestId: req.id });
+logs.log('error', 'payment failed', { orderId });
+await logs.flush(); await logs.shutdown();
+```
+
+| opção | default | descrição |
+|---|---|---|
+| `apiKey` / `endpoint` | — / `http://localhost:4050` | iguais ao tracker |
+| `service` | — | nome do serviço (obrigatório) |
+| `env`, `host` | — / `os.hostname()` | ambiente e host; `host: false` desliga |
+| `flushIntervalMs`, `maxBatch`, `maxQueueSize` | `2000`, `200`, `5000` | lote e fila |
+| `tracker` | — | correlação com o span corrente (sem ele usa o contexto global do SDK, que funciona quando o tracker está no mesmo processo) |
+| `minLevel` | `trace` | nível mínimo enviado |
+
+### pino (pino-http, Fastify, NestJS com nestjs-pino)
+
+Transport v7+ via `pino-abstract-transport` — roda em worker thread. Por isso o transport **não** enxerga o `AsyncLocalStorage` da aplicação: use `traceMixin` para carimbar `traceId`/`spanId` na thread principal.
+
+```ts
+import pino from 'pino';
+import pinoHttp from 'pino-http';
+import { pinoTransport, traceMixin } from 'fg-tracker-sdk';
+
+const logger = pino({
+  level: 'info',
+  mixin: traceMixin(tracker),                       // opcional; correlação com traces
+  transport: pinoTransport({ apiKey: process.env.FG_TRACKER_KEY!, endpoint: 'http://localhost:4050', service: 'minha-api', env: 'production' }),
+  // equivalente: transport: { target: 'fg-tracker-sdk/pino', options: { apiKey, service } }
+});
+app.use(pinoHttp({ logger }));                      // req.id vira requestId
+logger.info({ userId: 42 }, 'user logged in');
+```
+
+Mapeamento: `level` numérico → nível, `msg` → `message`, `name` → `service` (quando `service` não é passado), `hostname` → `host`, `req.id`/`reqId`/`requestId` → `requestId`, `env` → `env`; todas as outras chaves vão para `context`. Para enviar múltiplos destinos use `pino.transport({ targets: [{ target: 'pino-pretty' }, pinoTransport({...})] })`.
+
+### winston
+
+```ts
+import winston from 'winston';
+import { FgTrackerTransport } from 'fg-tracker-sdk/winston';
+
+const logger = winston.createLogger({
+  level: 'info',
+  format: winston.format.combine(winston.format.timestamp(), winston.format.json()),
+  transports: [
+    new winston.transports.Console(),
+    new FgTrackerTransport({ apiKey: process.env.FG_TRACKER_KEY!, service: 'minha-api', tracker }),
+  ],
+});
+logger.warn('stock low', { sku: 'A-1' });      // meta → context
+```
+
+`winston-transport` é peer opcional (vem com o winston). Níveis npm/syslog fora do contrato são aproximados (`crit`/`alert`/`emerg` → `fatal`, `verbose`/`silly` → `debug`, `http`/`notice` → `info`). A instância expõe `transport.shipper` para `flush()`/`shutdown()`.
+
+### NestJS Logger
+
+Implementa a forma do `LoggerService` sem depender de `@nestjs/common`: espelha no console (desligue com `console: false`) e envia. O último parâmetro string vira `context.context` (nome da classe), e em `error(msg, stack, context)` o stack vai em `context.stack`.
+
+```ts
+// src/main.ts
+import { NestFactory } from '@nestjs/core';
+import { createTracker, nestLogger } from 'fg-tracker-sdk';
+
+export const tracker = createTracker({ apiKey: process.env.FG_TRACKER_KEY!, serviceName: 'minha-api' });
+export const logger = nestLogger({ apiKey: process.env.FG_TRACKER_KEY!, service: 'minha-api', tracker });
+
+const app = await NestFactory.create(AppModule, { logger });
+app.use(tracker.express());
+app.enableShutdownHooks();
+process.on('SIGTERM', () => Promise.all([logger.shutdown(), tracker.shutdown()]).finally(() => process.exit(0)));
+```
+
+Dentro das classes continue usando `new Logger(MinhaClasse.name)` do Nest — ele delega ao logger da aplicação.
+
+### Ingestão crua de logs (qualquer linguagem)
+
+```bash
+curl -X POST http://localhost:4050/v1/logs \\
+  -H 'content-type: application/json' \\
+  -H 'x-fg-tracker-key: stk_demo_0000000000000000000000000000' \\
+  -d '{ "logs": [
+    { "ts": "2026-09-12T12:00:00.000Z", "level": "info", "service": "minha-api", "message": "user logged in",
+      "context": { "userId": 42 }, "traceId": "0123456789abcdef0123456789abcdef", "requestId": "req-1", "env": "production" },
+    { "level": "error", "service": "worker", "message": "ECONNRESET while calling payment gateway" }
+  ] }'
+# → 202 { "accepted": 2 }
+```
+
+Limites: 500 linhas por lote, 32 KB por mensagem, `context` truncado a 8 KB, `ts` fora da retenção vira `now()`.
+
+## Variáveis de ambiente
+
+| variável | uso |
+|---|---|
+| `FG_TRACKER_KEY` | chave do projeto (CLIs; nos exemplos, `apiKey`) |
+| `FG_TRACKER_URL` | URL da API (CLIs; nos exemplos, `endpoint`) |
+| `FG_TRACKER_RELEASE` | release explícita (tracker e `fg-tracker-sourcemaps`) |
+| `FG_TRACKER_ENV` | ambiente (tracker e `fg-tracker-release`) |
+| `FG_TRACKER_SERVICE` | serviço padrão do `fg-tracker-release` |
+
+O SDK lê o nome novo primeiro e, se estiver ausente ou vazio, o nome legado `STREAD_TRACK_*`. `readEnv('KEY')` expõe a mesma regra para o seu código.
+
+## Migração de stread-track-sdk
+
+O pacote foi renomeado de `stread-track-sdk` (0.3.0) para `fg-tracker-sdk` (0.4.0). **Nada quebra**: os nomes antigos continuam funcionando e serão removidos na 1.0.
+
+| antigo | novo | compatibilidade |
+|---|---|---|
+| pacote `stread-track-sdk` | `fg-tracker-sdk` | a 0.3.0 antiga segue no npm e continua enviando para a API |
+| bins `stread-track-release`, `stread-track-sourcemaps` | `fg-tracker-release`, `fg-tracker-sourcemaps` | os bins antigos são aliases obsoletos (mesmo arquivo, com aviso no stderr) |
+| `STREAD_TRACK_KEY`, `STREAD_TRACK_URL`, `STREAD_TRACK_RELEASE`, `STREAD_TRACK_ENV`, `STREAD_TRACK_SERVICE` | `FG_TRACKER_KEY`, `FG_TRACKER_URL`, `FG_TRACKER_RELEASE`, `FG_TRACKER_ENV`, `FG_TRACKER_SERVICE` | o novo tem precedência; o antigo é fallback |
+| header `x-stread-track-key` | `x-fg-tracker-key` | a API aceita os dois (e `?key=`) |
+| `StreadTrackTransport` (`/winston`) | `FgTrackerTransport` | re-export `@deprecated` |
+| tipo `StreadTrackNestLogger` | `FgTrackerNestLogger` | alias `@deprecated` |
+| pino `target: 'stread-track-sdk/pino'` | `target: 'fg-tracker-sdk/pino'` | troque junto com o nome do pacote |
+| prefixo de log `[stread-track]` | `[fg-tracker]` | — |
+
+Passo a passo: `pnpm remove stread-track-sdk && pnpm add fg-tracker-sdk@^0.4.0`, troque os imports (`from 'stread-track-sdk'` → `from 'fg-tracker-sdk'`, inclusive `/pino` e `/winston`) e, quando quiser, renomeie as variáveis de ambiente e os bins no CI. A API precisa aceitar `x-fg-tracker-key` (versão da API a partir desta mudança) — a produção do FG Tracker já aceita.
+
+## Build
+
+```bash
+pnpm --filter fg-tracker-sdk build      # tsc → dist/ (ESM + .d.ts)
+pnpm --filter fg-tracker-sdk typecheck
+```
+
+## Database adapters (0.2.0)
+
+Reuse the HTTP request tracker. `instrumentPostgres(sql)` wraps Postgres.js lazy
+queries, Drizzle's unsafe/values path, transactions, savepoints and reserved
+connections. Do not also instrument Drizzle for the same operation. It records
+normalized SQL and execution duration, including pool wait, with the request's
+trace ID and current parent span. Reusing a pending query does not execute or
+record it twice. Streaming/cursor helpers need an explicit completion wrapper.
+
+`instrumentDatabase(client, { system, methods, statement?, callbacks? })` supports
+methods returning synchronous results, Promises, or final error-first callbacks.
+Instrument acquired transaction connections separately. Only provide `statement`
+for SQL, never bind values, MongoDB documents, Redis keys or connection URLs.
+This adapter cannot infer arbitrary cursor/stream completion; wrap consumption:
+
+```ts
+await tracker.traceDatabase(
+  { system: 'mongodb', operation: 'tracks.find' },
+  () => collection.find(filter).toArray(),
+);
+const row = tracker.traceDatabaseSync(
+  { system: 'sqlite', operation: 'tracks.get', statement: 'select * from tracks where id = ?' },
+  () => statement.get(id),
+);
+```
+
+These completion wrappers work with any engine, without installing its driver in
+the SDK. Unknown drivers require explicit binding at the operation boundary;
+there is no universal automatic monkey patch. Operations outside an active trace
+are executed normally without orphan query traces. Database error values remain
+in the application; exports contain a generic error and an optional error code.
+Use `track_detect_databases` in the MCP to select the adapter from the actual
+application dependencies/imports and then implement it at the active client.

package/dist/cli/release.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=release.d.ts.map

package/dist/cli/release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../../src/cli/release.ts"],"names":[],"mappings":""}

package/dist/cli/release.js

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+/**
+ * CLI `fg-tracker-release` (alias obsoleto: `stread-track-release`): registra uma release no FG Tracker a partir do git
+ * (commits e arquivos/linhas alterados desde a versão anterior), para o painel
+ * apontar commits e PRs suspeitos de cada erro (CONTRATO.md §15).
+ *
+ *   FG_TRACKER_KEY=stk_... FG_TRACKER_URL=https://<api-do-fg-tracker> \
+ *   npx fg-tracker-release --service minha-api --previous-sha $PREV_SHA --repo FORTGROUND/phase --env production
+ *
+ * Flags: --version (default `${service}@${HEAD}`), --service, --sha (default HEAD),
+ * --previous-sha (default: 20 commits anteriores), --previous-version, --repo, --env,
+ * --url, --notes, --endpoint, --api-key, --dry-run.
+ * Env: FG_TRACKER_KEY, FG_TRACKER_URL, FG_TRACKER_SERVICE, FG_TRACKER_ENV
+ * (os nomes legados STREAD_TRACK_* continuam valendo como fallback).
+ */
+import { execFileSync } from 'node:child_process';
+import { API_KEY_HEADER, DEFAULT_ENDPOINT, readEnv, warnLegacyBin } from '../constants.js';
+function parseArgs(argv) {
+    const args = {};
+    for (let index = 0; index < argv.length; index += 1) {
+        const item = argv[index];
+        if (!item.startsWith('--'))
+            continue;
+        const key = item.slice(2);
+        const next = argv[index + 1];
+        if (next === undefined || next.startsWith('--'))
+            args[key] = true;
+        else {
+            args[key] = next;
+            index += 1;
+        }
+    }
+    return args;
+}
+function git(...params) {
+    return execFileSync('git', params, { encoding: 'utf8', maxBuffer: 64 * 1024 * 1024 }).trim();
+}
+function filesOf(sha) {
+    const files = new Map();
+    const numstat = git('show', '--numstat', '--format=', sha);
+    for (const line of numstat.split('\n')) {
+        const [added, deleted, path] = line.split('\t');
+        if (!path)
+            continue;
+        files.set(path, { path, additions: Number(added) || 0, deletions: Number(deleted) || 0, ranges: [] });
+    }
+    const diff = git('show', '--unified=0', '--format=', sha);
+    let current;
+    for (const line of diff.split('\n')) {
+        if (line.startsWith('+++ ')) {
+            const path = line.slice(4).replace(/^b\//, '');
+            current = files.get(path);
+            continue;
+        }
+        const hunk = /^@@ -\d+(?:,\d+)? \+(\d+)(?:,(\d+))? @@/.exec(line);
+        if (hunk && current) {
+            const start = Number(hunk[1]);
+            const count = hunk[2] === undefined ? 1 : Number(hunk[2]);
+            current.ranges.push([start, Math.max(start, start + count - 1)]);
+        }
+    }
+    return [...files.values()];
+}
+async function main() {
+    warnLegacyBin('fg-tracker-release');
+    const args = parseArgs(process.argv.slice(2));
+    const apiKey = (typeof args['api-key'] === 'string' ? args['api-key'] : readEnv('KEY')) ?? '';
+    const endpoint = ((typeof args.endpoint === 'string' ? args.endpoint : readEnv('URL')) ?? DEFAULT_ENDPOINT).replace(/\/+$/, '');
+    if (!apiKey && !args['dry-run']) {
+        console.error('FG_TRACKER_KEY (ou --api-key) é obrigatório.');
+        process.exit(2);
+    }
+    const sha = typeof args.sha === 'string' ? args.sha : git('rev-parse', 'HEAD');
+    const service = typeof args.service === 'string' ? args.service : readEnv('SERVICE') ?? 'app';
+    const version = typeof args.version === 'string' ? args.version : `${service}@${sha}`;
+    const previousSha = typeof args['previous-sha'] === 'string' ? args['previous-sha'] : undefined;
+    const range = previousSha ? `${previousSha}..${sha}` : `${sha}~20..${sha}`;
+    let log = '';
+    try {
+        log = git('log', '--format=%H%x1f%an%x1f%aI%x1f%B%x1e', range);
+    }
+    catch {
+        log = git('log', '--format=%H%x1f%an%x1f%aI%x1f%B%x1e', '-n', '20', sha);
+    }
+    const commits = log
+        .split('\x1e')
+        .map((entry) => entry.trim())
+        .filter(Boolean)
+        .map((entry) => {
+        const [hash, author, authoredAt, message] = entry.split('\x1f');
+        return { sha: hash, author, authoredAt, message: (message ?? '').trim(), files: filesOf(hash) };
+    });
+    const repository = typeof args.repo === 'string' ? args.repo : detectRepository();
+    const body = {
+        version,
+        environment: typeof args.env === 'string' ? args.env : readEnv('ENV') ?? process.env.NODE_ENV,
+        commitSha: sha,
+        previousVersion: typeof args['previous-version'] === 'string' ? args['previous-version'] : previousSha ? `${service}@${previousSha}` : undefined,
+        repository,
+        url: typeof args.url === 'string' ? args.url : undefined,
+        notes: typeof args.notes === 'string' ? args.notes : undefined,
+        commits,
+    };
+    if (args['dry-run']) {
+        console.log(JSON.stringify(body, null, 2));
+        return;
+    }
+    const res = await fetch(`${endpoint}/v1/releases`, {
+        method: 'POST',
+        headers: { 'content-type': 'application/json', [API_KEY_HEADER]: apiKey },
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(20_000),
+    });
+    if (!res.ok) {
+        console.error(`Falha ao registrar release (${res.status}): ${await res.text()}`);
+        process.exit(1);
+    }
+    console.log(`Release ${version} registrada (${commits.length} commits, ${new Set(commits.flatMap((c) => c.files.map((f) => f.path))).size} arquivos).`);
+}
+function detectRepository() {
+    try {
+        const remote = git('config', '--get', 'remote.origin.url');
+        const match = /github\.com[/:]([^/\s]+)\/([^/\s]+?)(?:\.git)?$/.exec(remote);
+        return match ? `${match[1]}/${match[2]}` : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+main().catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+});
+//# sourceMappingURL=release.js.map

package/dist/cli/release.js.map

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

package/dist/cli/sourcemaps.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=sourcemaps.d.ts.map

package/dist/cli/sourcemaps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourcemaps.d.ts","sourceRoot":"","sources":["../../src/cli/sourcemaps.ts"],"names":[],"mappings":""}

package/dist/cli/sourcemaps.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+/**
+ * CLI `fg-tracker-sourcemaps` (alias obsoleto: `stread-track-sourcemaps`): envia os `.map` de um build para o FG Tracker
+ * (`POST /v1/sourcemaps`), para os stacks do navegador chegarem simbolizados
+ * (CONTRATO.md §24).
+ *
+ *   FG_TRACKER_KEY=stk_... FG_TRACKER_URL=https://<api-do-fg-tracker> \
+ *   npx fg-tracker-sourcemaps --dir dist --release web@$GITHUB_SHA --url-prefix ~/assets
+ *
+ * Flags: --dir (obrigatório), --release (default: FG_TRACKER_RELEASE; legado STREAD_TRACK_RELEASE), --url-prefix
+ * (caminho público onde os JS ficam; `~` = qualquer host; default `~`), --endpoint,
+ * --api-key, --dry-run.
+ */
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import { API_KEY_HEADER, DEFAULT_ENDPOINT, readEnv, warnLegacyBin } from '../constants.js';
+function parseArgs(argv) {
+    const args = {};
+    for (let i = 0; i < argv.length; i += 1) {
+        const item = argv[i];
+        if (!item.startsWith('--'))
+            continue;
+        const next = argv[i + 1];
+        if (next === undefined || next.startsWith('--'))
+            args[item.slice(2)] = true;
+        else {
+            args[item.slice(2)] = next;
+            i += 1;
+        }
+    }
+    return args;
+}
+function walk(dir, out = []) {
+    for (const entry of readdirSync(dir)) {
+        const full = join(dir, entry);
+        if (statSync(full).isDirectory())
+            walk(full, out);
+        else if (entry.endsWith('.map'))
+            out.push(full);
+    }
+    return out;
+}
+async function main() {
+    warnLegacyBin('fg-tracker-sourcemaps');
+    const args = parseArgs(process.argv.slice(2));
+    const dir = typeof args.dir === 'string' ? args.dir : '';
+    if (!dir) {
+        console.error('--dir é obrigatório (pasta do build com os arquivos .map)');
+        process.exit(2);
+    }
+    const release = typeof args.release === 'string' ? args.release : readEnv('RELEASE');
+    if (!release) {
+        console.error('--release (ou FG_TRACKER_RELEASE) é obrigatório e deve ser o mesmo `release` do SDK de navegador');
+        process.exit(2);
+    }
+    const apiKey = (typeof args['api-key'] === 'string' ? args['api-key'] : readEnv('KEY')) ?? '';
+    const endpoint = ((typeof args.endpoint === 'string' ? args.endpoint : readEnv('URL')) ?? DEFAULT_ENDPOINT).replace(/\/+$/, '');
+    const prefix = (typeof args['url-prefix'] === 'string' ? args['url-prefix'] : '~').replace(/\/+$/, '');
+    const maps = walk(dir);
+    if (maps.length === 0) {
+        console.error(`Nenhum .map encontrado em ${dir}`);
+        process.exit(1);
+    }
+    const files = maps.map((file) => ({
+        path: `${prefix}/${relative(dir, file).replace(/\\/g, '/').replace(/\.map$/, '')}`,
+        map: readFileSync(file, 'utf8'),
+    }));
+    if (args['dry-run']) {
+        for (const file of files)
+            console.log(`${file.path}  (${Math.round(file.map.length / 1024)} KB)`);
+        return;
+    }
+    if (!apiKey) {
+        console.error('FG_TRACKER_KEY (ou --api-key) é obrigatório.');
+        process.exit(2);
+    }
+    let accepted = 0;
+    for (let i = 0; i < files.length; i += 20) {
+        const batch = files.slice(i, i + 20);
+        const res = await fetch(`${endpoint}/v1/sourcemaps`, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json', [API_KEY_HEADER]: apiKey },
+            body: JSON.stringify({ release, files: batch }),
+            signal: AbortSignal.timeout(60_000),
+        });
+        if (!res.ok) {
+            console.error(`Falha no upload (${res.status}): ${await res.text()}`);
+            process.exit(1);
+        }
+        accepted += (await res.json()).accepted;
+    }
+    console.log(`${accepted} source maps enviados para a release ${release}.`);
+}
+main().catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+});
+//# sourceMappingURL=sourcemaps.js.map