fg-tracker-sdk 0.4.0

package/dist/types.d.ts

@@ -0,0 +1,264 @@
+import type { DatabaseInstrumentationOptions, DatabaseOperation, PostgresSqlLike } from "./database.js";
+/**
+ * Tipos públicos do fg-tracker-sdk. Espelham as seções 5, 15–18 do docs/CONTRATO.md
+ * e o body de `POST /v1/ingest` (seção 4).
+ */
+export type SpanKind = 'http.server' | 'db.query' | 'http.client' | 'custom' | 'browser';
+export interface SpanError {
+    name: string;
+    message: string;
+    stack?: string;
+}
+/** Span finalizado, no formato enviado ao endpoint de ingestão. */
+export interface Span {
+    traceId: string;
+    spanId: string;
+    parentSpanId: string | null;
+    kind: SpanKind;
+    name: string;
+    method: string | null;
+    route: string | null;
+    statusCode: number | null;
+    startedAt: string;
+    endedAt: string;
+    durationMs: number;
+    attributes: Record<string, unknown>;
+    error: SpanError | null;
+}
+/** Usuário associado à requisição corrente (impacto por usuário, CONTRATO.md §17). */
+export interface UserRef {
+    id: string | number;
+    email?: string;
+    name?: string;
+}
+/** Para quais destinos o `traceparent` é enviado: `true` = todos, lista = hosts/prefixos/regex. */
+export type PropagationTargets = boolean | (string | RegExp)[];
+export interface TrackerOptions {
+    /** Chave do projeto (`stk_...`). Sem chave o tracker fica desabilitado. */
+    apiKey: string;
+    /** URL base da API do FG Tracker. Default `http://localhost:4050` (`DEFAULT_ENDPOINT`). */
+    endpoint?: string;
+    /** Nome do serviço instrumentado; vai em `attributes.serviceName` de todo span. */
+    serviceName?: string;
+    /**
+     * Versão em execução (`attributes.release`). Default: detectada de FG_TRACKER_RELEASE (legado: STREAD_TRACK_RELEASE),
+     * VERCEL_GIT_COMMIT_SHA, RAILWAY_GIT_COMMIT_SHA, GITHUB_SHA, SOURCE_VERSION, COMMIT_SHA
+     * ou GIT_COMMIT — formatada como `${serviceName}@${sha}`. `false` desliga.
+     */
+    release?: string | false;
+    /** Ambiente (`attributes.environment`). Default: FG_TRACKER_ENV (legado: STREAD_TRACK_ENV), APP_ENV ou NODE_ENV. */
+    environment?: string | false;
+    /** Destinos que recebem o header `traceparent` no `fetch` instrumentado. Default `true` (todos). */
+    propagateTraceTo?: PropagationTargets;
+    /** Substitui `globalThis.fetch` pelo fetch instrumentado (chamadas a provedores viram spans). Default `false`. */
+    instrumentGlobalFetch?: boolean;
+    /**
+     * Registra `uncaughtException` (via `uncaughtExceptionMonitor`, sem alterar o comportamento
+     * do processo) e `unhandledRejection` como spans `custom` com erro. Default `false`.
+     */
+    captureGlobalErrors?: boolean;
+    /**
+     * Fração de traces enviados (0..1). Default 1. A decisão é tomada no span raiz e
+     * propagada aos filhos e a outros serviços (flag do `traceparent`).
+     */
+    tracesSampleRate?: number;
+    /** Decide por trace (raiz): devolve fração 0..1 ou boolean. Vence `tracesSampleRate`. */
+    tracesSampler?: (context: SamplingContext) => number | boolean;
+    /** Raízes (ex.: `GET /health`) cujos traces nunca são enviados. Strings casam por substring; RegExp por teste. */
+    ignoreTransactions?: (string | RegExp)[];
+    /** Erros (nome ou mensagem) que não viram issue: o span é enviado sem `error`. */
+    ignoreErrors?: (string | RegExp)[];
+    /** Último filtro antes do envio: altere o span ou devolva `null` para descartá-lo. */
+    beforeSend?: (span: Span) => Span | null;
+    /**
+     * Chaves de `attributes` (em qualquer profundidade) cujos valores viram `[Filtered]`.
+     * Default: password, passwd, secret, token, authorization, cookie, api_key, apiKey, credit_card, cvv, ssn.
+     * `false` desliga; um array substitui a lista.
+     */
+    scrubFields?: string[] | false;
+    /** Intervalo de envio em ms. Default 2000. */
+    flushIntervalMs?: number;
+    /** Tamanho do lote que dispara envio imediato. Default 200. */
+    maxBatchSize?: number;
+    /** Tamanho máximo da fila antes de descartar os spans mais antigos. Default 5000. */
+    maxQueueSize?: number;
+    /** Desliga a instrumentação sem remover o código. Default `true`. */
+    enabled?: boolean;
+    /** Loga cada flush no console. Default `false`. */
+    debug?: boolean;
+    /** Implementação de fetch usada para o envio. Default `globalThis.fetch`. */
+    fetch?: typeof globalThis.fetch;
+}
+/** Contexto passado ao `tracesSampler` (span raiz). */
+export interface SamplingContext {
+    kind: SpanKind;
+    name: string;
+    attributes: Record<string, unknown>;
+    /** Decisão herdada de um `traceparent` recebido, quando houver. */
+    parentSampled?: boolean;
+}
+/** Handle de um span em andamento (recebido pelo callback de `tracker.span`). */
+export interface ActiveSpan {
+    readonly traceId: string;
+    readonly spanId: string;
+    readonly parentSpanId: string | null;
+    readonly kind: SpanKind;
+    name: string;
+    method: string | null;
+    route: string | null;
+    statusCode: number | null;
+    attributes: Record<string, unknown>;
+    error: SpanError | null;
+    /** `false` quando o trace foi descartado pela amostragem. */
+    readonly sampled: boolean;
+    setAttribute(key: string, value: unknown): void;
+    setError(err: unknown): void;
+    /** Associa um usuário ao span (`user.id`, `user.email`, `user.name`). */
+    setUser(user: UserRef | null): void;
+    /** Encerra o span e o enfileira para envio. Idempotente. */
+    end(): void;
+}
+/** Objeto mínimo que o middleware Express precisa (compatível com express e NestJS platform-express). */
+export interface ExpressLikeRequest {
+    method?: string;
+    url?: string;
+    originalUrl?: string;
+    baseUrl?: string;
+    ip?: string;
+    route?: {
+        path?: unknown;
+    };
+    headers: Record<string, string | string[] | undefined>;
+    socket?: {
+        remoteAddress?: string;
+    };
+    /** Preenchido por middlewares de autenticação (passport, Nest guards); lido no fim da resposta. */
+    user?: unknown;
+}
+export interface ExpressLikeResponse {
+    statusCode: number;
+    on(event: 'finish' | 'close', listener: () => void): unknown;
+    once(event: 'finish' | 'close', listener: () => void): unknown;
+    setHeader?(name: string, value: string): unknown;
+    getHeader?(name: string): unknown;
+}
+export type ExpressMiddleware = (req: ExpressLikeRequest, res: ExpressLikeResponse, next: (err?: unknown) => void) => void;
+export type ExpressErrorMiddleware = (err: unknown, req: ExpressLikeRequest, res: ExpressLikeResponse, next: (err?: unknown) => void) => void;
+export interface ExpressOptions {
+    /**
+     * Extrai o usuário da requisição ao fim da resposta (depois da autenticação).
+     * Default: `req.user.id` / `req.user.email` quando existirem. `false` desliga.
+     */
+    identify?: ((req: ExpressLikeRequest) => UserRef | null | undefined) | false;
+    /** Continua traces recebidos via `traceparent`. Default `true`. */
+    continueTrace?: boolean;
+}
+/** Subconjunto de `pg.Pool` que o SDK instrumenta. */
+export interface PgPoolLike {
+    query: (...args: any[]) => any;
+}
+export type NextRouteHandler<TCtx = unknown> = (req: Request, ctx: TCtx) => Response | Promise<Response>;
+export interface CheckInOptions {
+    /** Nome legível (usado ao criar o monitor no primeiro check-in). */
+    name?: string;
+    /** Intervalo esperado entre execuções, em segundos (ex.: 86400 para diário). */
+    intervalSeconds?: number;
+    /** Tolerância além do intervalo antes de "job não rodou". Default 300 s. */
+    graceSeconds?: number;
+    /** Descrição humana do agendamento (ex.: "todo dia às 03:00"). */
+    schedule?: string;
+    /** Crontab de 5 campos (ex.: `0 3 * * *`); vence `intervalSeconds`. */
+    cron?: string;
+    /** Fuso IANA do crontab (ex.: `America/Sao_Paulo`). */
+    timezone?: string;
+    /** Tempo máximo de execução em segundos: acima disso o job é marcado como timeout. */
+    maxRuntimeSeconds?: number;
+}
+export interface CheckInHandle {
+    /** Marca o fim com sucesso (duração calculada automaticamente). */
+    ok(): Promise<void>;
+    /** Marca o fim com falha. */
+    fail(error?: unknown): Promise<void>;
+}
+export interface ReleaseCommitInput {
+    sha: string;
+    message: string;
+    author?: string;
+    authoredAt?: string;
+    url?: string;
+    pullRequest?: number;
+    files?: {
+        path: string;
+        additions?: number;
+        deletions?: number;
+        ranges?: [number, number][];
+    }[];
+}
+export interface RegisterReleaseInput {
+    /** Default: a release configurada/detectada no tracker. */
+    version?: string;
+    environment?: string;
+    commitSha?: string;
+    previousVersion?: string;
+    repository?: string;
+    url?: string;
+    notes?: string;
+    deployedAt?: string;
+    commits?: ReleaseCommitInput[];
+}
+export interface Tracker {
+    instrumentPostgres<T extends PostgresSqlLike>(client: T): T;
+    instrumentDatabase<T extends object>(client: T, options: DatabaseInstrumentationOptions): T;
+    traceDatabase<T>(operation: DatabaseOperation, fn: () => T | Promise<T>): Promise<T>;
+    traceDatabaseSync<T>(operation: DatabaseOperation, fn: () => T): T;
+    /** Middleware para Express / NestJS (platform-express). Cria o span raiz `http.server` por request. */
+    express(options?: ExpressOptions): ExpressMiddleware;
+    /**
+     * Middleware de erro do Express (registre DEPOIS das rotas): grava a exceção real no span
+     * da requisição, para o agrupamento de issues distinguir bugs diferentes com o mesmo 500.
+     */
+    expressErrorHandler(): ExpressErrorMiddleware;
+    /** Instrumenta `pool.query` de um `pg.Pool` (ou objeto compatível) gerando spans `db.query`. */
+    instrumentPg<T extends PgPoolLike>(pool: T): T;
+    /** Cria um span filho do contexto atual e executa `fn` dentro dele. */
+    span<T>(kind: SpanKind, name: string, fn: (span: ActiveSpan) => T | Promise<T>, attributes?: Record<string, unknown>): Promise<T>;
+    /** Envolve um route handler do Next.js (App Router) num span `http.server`. */
+    wrapNextRoute<TCtx = unknown>(handler: NextRouteHandler<TCtx>): NextRouteHandler<TCtx>;
+    /** Retorna um `fetch` instrumentado que gera spans `http.client` e propaga `traceparent`. */
+    wrapFetch(fetchImpl?: typeof globalThis.fetch): typeof globalThis.fetch;
+    /** Substitui `globalThis.fetch` pelo fetch instrumentado (idempotente). Retorna o `fetch` original. */
+    instrumentGlobalFetch(): typeof globalThis.fetch;
+    /** Span ativo no contexto assíncrono atual (se houver). */
+    currentSpan(): ActiveSpan | undefined;
+    /** Span raiz (requisição) do contexto atual, se houver. */
+    rootSpan(): ActiveSpan | undefined;
+    /** `traceId` do contexto atual (para logs, headers de resposta, correlação). */
+    currentTraceId(): string | undefined;
+    /** Headers de propagação (`traceparent`) do contexto atual, para clientes HTTP não instrumentados. */
+    traceHeaders(): Record<string, string>;
+    /** Associa o usuário à requisição corrente (span raiz). */
+    setUser(user: UserRef | null): void;
+    /**
+     * Registra uma exceção no span raiz da requisição corrente; fora de uma requisição, cria
+     * um span `custom` com o erro. Use em filtros de exceção (NestJS) ou `catch` de jobs.
+     */
+    captureException(err: unknown, attributes?: Record<string, unknown>): void;
+    /** Inicia um span manual (o chamador deve chamar `end()`). Não altera o contexto assíncrono. */
+    startSpan(kind: SpanKind, name: string, attributes?: Record<string, unknown>): ActiveSpan;
+    /** Executa um job com check-in de início/fim no monitor `slug` (CONTRATO.md §18). */
+    checkIn<T>(slug: string, fn: () => T | Promise<T>, options?: CheckInOptions): Promise<T>;
+    /** Check-in manual: `start()` envia in_progress e devolve `ok()`/`fail()`. */
+    monitor(slug: string, options?: CheckInOptions): {
+        start(): Promise<CheckInHandle>;
+    };
+    /** Registra uma release/deploy (`POST /v1/releases`). O CLI `fg-tracker-release` faz isso a partir do git. */
+    registerRelease(input?: RegisterReleaseInput): Promise<boolean>;
+    /** Release e ambiente efetivos deste tracker. */
+    readonly release: string | undefined;
+    readonly environment: string | undefined;
+    /** Envia imediatamente tudo o que está na fila. */
+    flush(): Promise<void>;
+    /** Para o timer e envia o que restou. */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+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":""}

package/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "fg-tracker-sdk",
+  "version": "0.4.0",
+  "description": "SDK de instrumentação Node para o FG Tracker (Express, NestJS, Next.js, pg, fetch), tracing distribuído, releases, check-ins de jobs e envio de logs (pino, winston, NestJS Logger)",
+  "license": "UNLICENSED",
+  "homepage": "https://github.com/FORTGROUND/fg-tracker/tree/main/packages/sdk#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/FORTGROUND/fg-tracker.git",
+    "directory": "packages/sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/FORTGROUND/fg-tracker/issues"
+  },
+  "keywords": [
+    "fg-tracker",
+    "apm",
+    "tracing",
+    "distributed-tracing",
+    "observability",
+    "monitoring",
+    "express",
+    "nestjs",
+    "nextjs",
+    "pino",
+    "winston",
+    "releases",
+    "sourcemaps"
+  ],
+  "bin": {
+    "fg-tracker-release": "dist/cli/release.js",
+    "fg-tracker-sourcemaps": "dist/cli/sourcemaps.js",
+    "stread-track-release": "dist/cli/release.js",
+    "stread-track-sourcemaps": "dist/cli/sourcemaps.js"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./pino": {
+      "types": "./dist/logs/pino.d.ts",
+      "import": "./dist/logs/pino.js",
+      "default": "./dist/logs/pino.js"
+    },
+    "./winston": {
+      "types": "./dist/logs/winston.d.ts",
+      "import": "./dist/logs/winston.js",
+      "default": "./dist/logs/winston.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && chmod +x dist/cli/release.js dist/cli/sourcemaps.js",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist",
+    "test": "node --test test/*.test.mjs",
+    "prepack": "npm run clean && npm run build"
+  },
+  "peerDependencies": {
+    "pg": ">=8",
+    "winston-transport": ">=4"
+  },
+  "peerDependenciesMeta": {
+    "pg": {
+      "optional": true
+    },
+    "winston-transport": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "pino": "^10.3.1",
+    "postgres": "3.4.9",
+    "typescript": "^5.9.2",
+    "winston": "^3.19.0",
+    "winston-transport": "^4.9.0"
+  },
+  "dependencies": {
+    "pino-abstract-transport": "^3.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}