fg-tracker-sdk 0.4.0

package/dist/logs/shipper.js

@@ -0,0 +1,217 @@
+import { hostname } from 'node:os';
+import { API_KEY_HEADER, DEFAULT_ENDPOINT } from '../constants.js';
+import { currentSpanContext } from '../context.js';
+import { LOG_LEVEL_NUMBER, toLogLevel } from './types.js';
+const DEFAULT_FLUSH_INTERVAL_MS = 2000;
+const DEFAULT_MAX_BATCH = 200;
+const DEFAULT_MAX_QUEUE = 5000;
+/** Limite da API por requisição (CONTRATO.md §11). */
+const API_MAX_BATCH = 500;
+const RETRY_DELAY_MS = 400;
+/**
+ * Fila + envio em lote para `POST /v1/logs`. Mesma política do tracker:
+ * timer com `unref()`, fila limitada (descarta as mais antigas), aviso único
+ * em falha, 4xx descarta o lote, 5xx/rede tenta de novo uma vez e depois
+ * devolve o lote para o próximo flush.
+ */
+export function createLogShipper(options) {
+    return new LogShipperImpl(options);
+}
+class LogShipperImpl {
+    options;
+    apiKey;
+    env;
+    host;
+    minLevel;
+    tracker;
+    fetchImpl;
+    debug;
+    active;
+    queue = [];
+    timer = null;
+    flushing = null;
+    warnedFailure = false;
+    stopped = false;
+    constructor(raw) {
+        this.options = {
+            endpoint: (raw.endpoint ?? DEFAULT_ENDPOINT).replace(/\/+$/, ''),
+            service: raw.service || 'default',
+            flushIntervalMs: Math.max(100, raw.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS),
+            maxBatch: Math.min(API_MAX_BATCH, Math.max(1, raw.maxBatch ?? DEFAULT_MAX_BATCH)),
+            maxQueueSize: Math.max(10, raw.maxQueueSize ?? DEFAULT_MAX_QUEUE),
+        };
+        this.apiKey = raw.apiKey ?? '';
+        this.env = raw.env;
+        this.host = raw.host === false ? undefined : (raw.host ?? safeHostname());
+        this.minLevel = LOG_LEVEL_NUMBER[raw.minLevel ?? 'trace'];
+        this.tracker = raw.tracker;
+        this.fetchImpl = raw.fetch ?? globalThis.fetch;
+        this.debug = raw.debug ?? false;
+        this.active = (raw.enabled ?? true) && Boolean(this.apiKey);
+        if (!this.active) {
+            if (!this.apiKey && (raw.enabled ?? true))
+                console.warn('[fg-tracker] apiKey ausente: envio de logs desabilitado.');
+            return;
+        }
+        this.timer = setInterval(() => {
+            void this.flush();
+        }, this.options.flushIntervalMs);
+        if (typeof this.timer === 'object' && this.timer && 'unref' in this.timer)
+            this.timer.unref();
+    }
+    get enabled() {
+        return this.active && !this.stopped;
+    }
+    get size() {
+        return this.queue.length;
+    }
+    log(level, message, context) {
+        this.push({ level, message, context });
+    }
+    push(entry) {
+        if (!this.enabled)
+            return;
+        const level = toLogLevel(entry.level ?? 'info');
+        if (LOG_LEVEL_NUMBER[level] < this.minLevel)
+            return;
+        const correlation = entry.traceId ? null : (this.tracker?.currentSpan() ?? currentSpanContext());
+        const line = {
+            ts: toIso(entry.ts),
+            level,
+            service: entry.service || this.options.service,
+            message: typeof entry.message === 'string' ? entry.message : String(entry.message),
+        };
+        if (entry.context && Object.keys(entry.context).length > 0)
+            line.context = entry.context;
+        const traceId = entry.traceId ?? correlation?.traceId;
+        const spanId = entry.spanId ?? correlation?.spanId;
+        if (traceId)
+            line.traceId = traceId;
+        if (spanId)
+            line.spanId = spanId;
+        if (entry.requestId)
+            line.requestId = entry.requestId;
+        const env = entry.env ?? this.env;
+        if (env)
+            line.env = env;
+        const host = entry.host ?? this.host;
+        if (host)
+            line.host = host;
+        this.queue.push(line);
+        if (this.queue.length > this.options.maxQueueSize) {
+            this.queue.splice(0, this.queue.length - this.options.maxQueueSize);
+        }
+        if (this.queue.length >= this.options.maxBatch)
+            void this.flush();
+    }
+    async flush() {
+        if (!this.active)
+            return;
+        if (this.flushing)
+            return this.flushing;
+        if (this.queue.length === 0)
+            return;
+        this.flushing = this.doFlush().finally(() => {
+            this.flushing = null;
+        });
+        return this.flushing;
+    }
+    async shutdown() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        await this.flush();
+        this.stopped = true;
+    }
+    async doFlush() {
+        while (this.queue.length > 0) {
+            const batch = this.queue.splice(0, this.options.maxBatch);
+            let outcome = await this.send(batch);
+            if (outcome === 'retry') {
+                await sleep(RETRY_DELAY_MS);
+                outcome = await this.send(batch);
+            }
+            if (outcome === 'retry') {
+                // Devolve para a frente da fila e tenta no próximo flush.
+                this.queue.unshift(...batch);
+                if (this.queue.length > this.options.maxQueueSize) {
+                    this.queue.splice(0, this.queue.length - this.options.maxQueueSize);
+                }
+                return;
+            }
+        }
+    }
+    async send(logs) {
+        try {
+            const res = await this.fetchImpl(`${this.options.endpoint}/v1/logs`, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json', [API_KEY_HEADER]: this.apiKey },
+                body: JSON.stringify({ logs }),
+            });
+            if (!res.ok) {
+                const retry = res.status >= 500 || res.status === 429;
+                this.warnOnce(`logs respondeu ${res.status}${retry ? ' (vai tentar de novo)' : ' (lote descartado)'}`);
+                return retry ? 'retry' : 'drop';
+            }
+            if (this.warnedFailure) {
+                this.warnedFailure = false;
+                if (this.debug)
+                    console.info('[fg-tracker] envio de logs restabelecido.');
+            }
+            if (this.debug)
+                console.info(`[fg-tracker] enviadas ${logs.length} linhas de log.`);
+            return 'ok';
+        }
+        catch (err) {
+            this.warnOnce(`falha ao enviar logs para ${this.options.endpoint}/v1/logs: ${err?.message ?? err}`);
+            return 'retry';
+        }
+    }
+    warnOnce(message) {
+        if (this.warnedFailure)
+            return;
+        this.warnedFailure = true;
+        console.warn(`[fg-tracker] ${message}`);
+    }
+}
+function toIso(value) {
+    if (value instanceof Date)
+        return Number.isNaN(value.getTime()) ? new Date().toISOString() : value.toISOString();
+    if (typeof value === 'number')
+        return new Date(value).toISOString();
+    if (typeof value === 'string' && value) {
+        const parsed = new Date(value);
+        if (!Number.isNaN(parsed.getTime()))
+            return parsed.toISOString();
+    }
+    return new Date().toISOString();
+}
+function safeHostname() {
+    try {
+        return hostname();
+    }
+    catch {
+        return undefined;
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * `mixin` para o pino: injeta `traceId`/`spanId` do span corrente em cada linha.
+ * Necessário porque o transport roda em worker thread, sem acesso ao AsyncLocalStorage da app.
+ *
+ * ```ts
+ * const logger = pino({ mixin: traceMixin(tracker), transport: pinoTransport({ ... }) });
+ * ```
+ */
+export function traceMixin(tracker) {
+    return () => {
+        const ctx = tracker?.currentSpan() ?? currentSpanContext();
+        if (!ctx)
+            return {};
+        return { traceId: ctx.traceId, spanId: ctx.spanId };
+    };
+}
+//# sourceMappingURL=shipper.js.map

package/dist/logs/shipper.js.map

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

package/dist/logs/types.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Tipos do envio de logs (CONTRATO.md §11). Espelham o body de `POST /v1/logs`.
+ */
+export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+/** Números do pino: trace 10, debug 20, info 30, warn 40, error 50, fatal 60. */
+export declare const LOG_LEVEL_NUMBER: Record<LogLevel, number>;
+/** Converte número (pino) ou nome (winston/npm) em nível do contrato. */
+export declare function toLogLevel(value: unknown): LogLevel;
+/** Linha como o SDK envia. */
+export interface LogEntry {
+    ts: string;
+    level: LogLevel;
+    service: string;
+    message: string;
+    context?: Record<string, unknown>;
+    traceId?: string;
+    spanId?: string;
+    requestId?: string;
+    env?: string;
+    host?: string;
+}
+/** Linha como o chamador entrega ao shipper (tudo opcional exceto a mensagem). */
+export interface LogInput {
+    ts?: string | number | Date;
+    level?: LogLevel | number | string;
+    service?: string;
+    message: string;
+    context?: Record<string, unknown>;
+    traceId?: string | null;
+    spanId?: string | null;
+    requestId?: string | null;
+    env?: string | null;
+    host?: string | null;
+}
+/** Subconjunto do `Tracker` usado para correlação (evita dependência circular de tipos). */
+export interface SpanContextSource {
+    currentSpan(): {
+        traceId: string;
+        spanId: string;
+    } | undefined;
+}
+export interface LogShipperOptions {
+    /** Chave do projeto (`stk_...`). Sem chave o shipper vira no-op (com aviso). */
+    apiKey: string;
+    /** URL base da API. Default `http://localhost:4050`. */
+    endpoint?: string;
+    /** Nome do serviço; vai em toda linha que não trouxer o próprio. */
+    service: string;
+    /** Ambiente (`production`, `staging`...). */
+    env?: string;
+    /** Host; default `os.hostname()`. `false` desliga. */
+    host?: string | false;
+    /** Intervalo de envio em ms. Default 2000. */
+    flushIntervalMs?: number;
+    /** Linhas por lote (máximo 500, limite da API). Default 200. */
+    maxBatch?: number;
+    /** Tamanho máximo da fila antes de descartar as mais antigas. Default 5000. */
+    maxQueueSize?: number;
+    /** Tracker do FG Tracker para correlação de traceId/spanId (senão usa o contexto global do SDK). */
+    tracker?: SpanContextSource;
+    /** Nível mínimo enviado. Default `trace` (tudo). */
+    minLevel?: LogLevel;
+    /** Desliga sem remover o código. Default `true`. */
+    enabled?: boolean;
+    /** Loga cada envio no console. Default `false`. */
+    debug?: boolean;
+    /** Implementação de fetch. Default `globalThis.fetch`. */
+    fetch?: typeof globalThis.fetch;
+}
+export interface LogShipper {
+    /** Enfileira uma linha (normaliza nível, timestamp e correlação). */
+    push(entry: LogInput): void;
+    /** Atalhos por nível. */
+    log(level: LogLevel, message: string, context?: Record<string, unknown>): void;
+    /** Envia imediatamente tudo o que está na fila. */
+    flush(): Promise<void>;
+    /** Para o timer e envia o que restou. */
+    shutdown(): Promise<void>;
+    /** Linhas aguardando envio. */
+    readonly size: number;
+    readonly enabled: boolean;
+    readonly options: Readonly<Required<Pick<LogShipperOptions, 'endpoint' | 'service' | 'flushIntervalMs' | 'maxBatch' | 'maxQueueSize'>>>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/logs/types.d.ts.map

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

package/dist/logs/types.js

@@ -0,0 +1,47 @@
+/**
+ * Tipos do envio de logs (CONTRATO.md §11). Espelham o body de `POST /v1/logs`.
+ */
+/** Números do pino: trace 10, debug 20, info 30, warn 40, error 50, fatal 60. */
+export const LOG_LEVEL_NUMBER = {
+    trace: 10,
+    debug: 20,
+    info: 30,
+    warn: 40,
+    error: 50,
+    fatal: 60,
+};
+/** Converte número (pino) ou nome (winston/npm) em nível do contrato. */
+export function toLogLevel(value) {
+    if (typeof value === 'number') {
+        if (value >= 60)
+            return 'fatal';
+        if (value >= 50)
+            return 'error';
+        if (value >= 40)
+            return 'warn';
+        if (value >= 30)
+            return 'info';
+        if (value >= 20)
+            return 'debug';
+        return 'trace';
+    }
+    if (typeof value === 'string') {
+        const name = value.toLowerCase();
+        if (name in LOG_LEVEL_NUMBER)
+            return name;
+        // Níveis npm/syslog do winston fora do contrato.
+        if (name === 'crit' || name === 'alert' || name === 'emerg')
+            return 'fatal';
+        if (name === 'warning')
+            return 'warn';
+        if (name === 'notice' || name === 'http')
+            return 'info';
+        if (name === 'verbose' || name === 'silly')
+            return 'debug';
+        const asNumber = Number(name);
+        if (Number.isFinite(asNumber))
+            return toLogLevel(asNumber);
+    }
+    return 'info';
+}
+//# sourceMappingURL=types.js.map

package/dist/logs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/logs/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,iFAAiF;AACjF,MAAM,CAAC,MAAM,gBAAgB,GAA6B;IACxD,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;CACV,CAAC;AAEF,yEAAyE;AACzE,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,KAAK,IAAI,EAAE;YAAE,OAAO,OAAO,CAAC;QAChC,IAAI,KAAK,IAAI,EAAE;YAAE,OAAO,OAAO,CAAC;QAChC,IAAI,KAAK,IAAI,EAAE;YAAE,OAAO,MAAM,CAAC;QAC/B,IAAI,KAAK,IAAI,EAAE;YAAE,OAAO,MAAM,CAAC;QAC/B,IAAI,KAAK,IAAI,EAAE;YAAE,OAAO,OAAO,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACjC,IAAI,IAAI,IAAI,gBAAgB;YAAE,OAAO,IAAgB,CAAC;QACtD,iDAAiD;QACjD,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,OAAO,CAAC;QAC5E,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QACtC,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,MAAM;YAAE,OAAO,MAAM,CAAC;QACxD,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,OAAO,CAAC;QAC3D,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/logs/winston.d.ts

@@ -0,0 +1,31 @@
+import Transport from 'winston-transport';
+import type { LogShipper, LogShipperOptions } from './types.js';
+export type WinstonTransportOptions = LogShipperOptions & {
+    /** Nível mínimo do winston para este transport (`level` do `winston-transport`). */
+    level?: string;
+    silent?: boolean;
+    handleExceptions?: boolean;
+    handleRejections?: boolean;
+};
+/**
+ * Transport do winston:
+ *
+ * ```ts
+ * import winston from 'winston';
+ * import { FgTrackerTransport } from 'fg-tracker-sdk/winston';
+ * const logger = winston.createLogger({ transports: [new FgTrackerTransport({ apiKey, service: 'minha-api', tracker })] });
+ * ```
+ */
+export declare class FgTrackerTransport extends Transport {
+    readonly shipper: LogShipper;
+    constructor(options: WinstonTransportOptions);
+    log(info: Record<string, unknown>, next: () => void): void;
+    close(): void;
+}
+/** @deprecated use `FgTrackerTransport` (nome antigo do `stread-track-sdk`; removido na 1.0). */
+export declare const StreadTrackTransport: typeof FgTrackerTransport;
+/** @deprecated use `FgTrackerTransport` (nome antigo do `stread-track-sdk`; removido na 1.0). */
+export type StreadTrackTransport = FgTrackerTransport;
+/** Fábrica no estilo dos outros helpers do SDK. */
+export declare function winstonTransport(options: WinstonTransportOptions): FgTrackerTransport;
+//# sourceMappingURL=winston.d.ts.map

package/dist/logs/winston.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"winston.d.ts","sourceRoot":"","sources":["../../src/logs/winston.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAE1C,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,GAAG;IACxD,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAIF;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,SAAQ,SAAS;IAC/C,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;gBAEjB,OAAO,EAAE,uBAAuB;IAMnC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,IAAI,GAAG,IAAI;IAwB1D,KAAK,IAAI,IAAI;CAGvB;AAED,iGAAiG;AACjG,eAAO,MAAM,oBAAoB,2BAAqB,CAAC;AACvD,iGAAiG;AACjG,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAEtD,mDAAmD;AACnD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,kBAAkB,CAErF"}

package/dist/logs/winston.js

@@ -0,0 +1,57 @@
+import Transport from 'winston-transport';
+import { createLogShipper } from './shipper.js';
+const WINSTON_RESERVED = new Set(['level', 'message', 'timestamp', 'traceId', 'spanId', 'requestId', 'service', 'env', 'host']);
+/**
+ * Transport do winston:
+ *
+ * ```ts
+ * import winston from 'winston';
+ * import { FgTrackerTransport } from 'fg-tracker-sdk/winston';
+ * const logger = winston.createLogger({ transports: [new FgTrackerTransport({ apiKey, service: 'minha-api', tracker })] });
+ * ```
+ */
+export class FgTrackerTransport extends Transport {
+    shipper;
+    constructor(options) {
+        const { level, silent, handleExceptions, handleRejections, ...shipperOptions } = options;
+        super({ level, silent, handleExceptions, handleRejections });
+        this.shipper = createLogShipper(shipperOptions);
+    }
+    log(info, next) {
+        setImmediate(() => this.emit('logged', info));
+        const context = {};
+        // Chaves-símbolo do logform (`Symbol.for('level')`, `Symbol.for('message')`) ficam de fora sozinhas.
+        for (const [key, value] of Object.entries(info)) {
+            if (WINSTON_RESERVED.has(key) || value === undefined)
+                continue;
+            context[key] = value;
+        }
+        const message = info.message;
+        this.shipper.push({
+            ts: typeof info.timestamp === 'string' || typeof info.timestamp === 'number' ? info.timestamp : undefined,
+            level: typeof info.level === 'string' ? info.level : undefined,
+            service: typeof info.service === 'string' ? info.service : undefined,
+            message: typeof message === 'string' ? message : JSON.stringify(message),
+            context,
+            traceId: asString(info.traceId),
+            spanId: asString(info.spanId),
+            requestId: asString(info.requestId),
+            env: asString(info.env),
+            host: asString(info.host),
+        });
+        next();
+    }
+    close() {
+        void this.shipper.shutdown();
+    }
+}
+/** @deprecated use `FgTrackerTransport` (nome antigo do `stread-track-sdk`; removido na 1.0). */
+export const StreadTrackTransport = FgTrackerTransport;
+/** Fábrica no estilo dos outros helpers do SDK. */
+export function winstonTransport(options) {
+    return new FgTrackerTransport(options);
+}
+function asString(value) {
+    return typeof value === 'string' && value ? value : undefined;
+}
+//# sourceMappingURL=winston.js.map

package/dist/logs/winston.js.map

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

package/dist/monitors.d.ts

@@ -0,0 +1,8 @@
+import type { TrackerCore } from './tracker.js';
+import type { CheckInHandle, CheckInOptions } from './types.js';
+export declare function sendCheckIn(core: TrackerCore, slug: string, body: Record<string, unknown>): Promise<boolean>;
+export declare function createMonitor(core: TrackerCore, slug: string, options?: CheckInOptions): {
+    start(): Promise<CheckInHandle>;
+};
+export declare function runCheckIn<T>(core: TrackerCore, slug: string, fn: () => T | Promise<T>, options?: CheckInOptions): Promise<T>;
+//# sourceMappingURL=monitors.d.ts.map

package/dist/monitors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitors.d.ts","sourceRoot":"","sources":["../src/monitors.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAqBhE,wBAAsB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CASlH;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG;IAAE,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC,CAAA;CAAE,CAsBhI;AAED,wBAAsB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC,CAUvI"}

package/dist/monitors.js

@@ -0,0 +1,69 @@
+import { performance } from 'node:perf_hooks';
+import { toSpanError } from './normalize.js';
+/**
+ * Check-ins de jobs agendados (CONTRATO.md §18): `in_progress` ao começar,
+ * `ok`/`fail` ao terminar, com a duração. Sem apiKey vira no-op.
+ */
+function payload(status, options, extra = {}) {
+    return {
+        status,
+        ...(options.name ? { name: options.name } : {}),
+        ...(options.intervalSeconds ? { intervalSeconds: options.intervalSeconds } : {}),
+        ...(options.graceSeconds !== undefined ? { graceSeconds: options.graceSeconds } : {}),
+        ...(options.schedule ? { schedule: options.schedule } : {}),
+        ...(options.cron ? { cron: options.cron } : {}),
+        ...(options.timezone ? { timezone: options.timezone } : {}),
+        ...(options.maxRuntimeSeconds !== undefined ? { maxRuntimeSeconds: options.maxRuntimeSeconds } : {}),
+        ...extra,
+    };
+}
+export async function sendCheckIn(core, slug, body) {
+    if (!core.enabled)
+        return false;
+    const res = await core.post(`/v1/monitors/${encodeURIComponent(slug)}/checkin`, body, 8000);
+    if (!res)
+        return false;
+    if (!res.ok) {
+        core.warnOnce(`check-in do monitor "${slug}" respondeu ${res.status}`);
+        return false;
+    }
+    return true;
+}
+export function createMonitor(core, slug, options = {}) {
+    return {
+        async start() {
+            const startedAt = performance.now();
+            await sendCheckIn(core, slug, payload('in_progress', options));
+            let closed = false;
+            const durationMs = () => Math.round((performance.now() - startedAt) * 10) / 10;
+            return {
+                async ok() {
+                    if (closed)
+                        return;
+                    closed = true;
+                    await sendCheckIn(core, slug, payload('ok', options, { durationMs: durationMs() }));
+                },
+                async fail(error) {
+                    if (closed)
+                        return;
+                    closed = true;
+                    const message = error === undefined ? 'Job reportou falha' : toSpanError(error).message;
+                    await sendCheckIn(core, slug, payload('fail', options, { durationMs: durationMs(), error: message.slice(0, 2000) }));
+                },
+            };
+        },
+    };
+}
+export async function runCheckIn(core, slug, fn, options = {}) {
+    const handle = await createMonitor(core, slug, options).start();
+    try {
+        const result = await fn();
+        await handle.ok();
+        return result;
+    }
+    catch (error) {
+        await handle.fail(error);
+        throw error;
+    }
+}
+//# sourceMappingURL=monitors.js.map

package/dist/monitors.js.map

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

package/dist/next.d.ts

@@ -0,0 +1,9 @@
+import type { TrackerCore } from './tracker.js';
+import type { NextRouteHandler } from './types.js';
+/**
+ * Envolve um route handler do App Router (`export const GET = tracker.wrapNextRoute(...)`)
+ * num span raiz `http.server`. Status vem da `Response`; exceções viram `error`.
+ * Continua o trace de um `traceparent` recebido (CONTRATO.md §16).
+ */
+export declare function wrapNextRouteHandler<TCtx>(core: TrackerCore, handler: NextRouteHandler<TCtx>): NextRouteHandler<TCtx>;
+//# sourceMappingURL=next.d.ts.map

package/dist/next.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../src/next.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAwCrH"}

package/dist/next.js

@@ -0,0 +1,55 @@
+import { parseTraceparent } from './context.js';
+import { normalizePath } from './normalize.js';
+/**
+ * Envolve um route handler do App Router (`export const GET = tracker.wrapNextRoute(...)`)
+ * num span raiz `http.server`. Status vem da `Response`; exceções viram `error`.
+ * Continua o trace de um `traceparent` recebido (CONTRATO.md §16).
+ */
+export function wrapNextRouteHandler(core, handler) {
+    return async function fgTrackerRoute(req, ctx) {
+        if (!core.enabled)
+            return handler(req, ctx);
+        const method = (req.method ?? 'GET').toUpperCase();
+        let pathname = '/';
+        let rawUrl = req.url;
+        try {
+            const u = new URL(req.url);
+            pathname = u.pathname;
+            rawUrl = u.pathname + u.search;
+        }
+        catch {
+            /* URL relativa ou inválida: usa como está */
+        }
+        const route = normalizePath(pathname);
+        const requestId = req.headers.get('x-request-id');
+        const attributes = {
+            url: rawUrl,
+            userAgent: req.headers.get('user-agent'),
+            ip: req.headers.get('x-forwarded-for')?.split(',')[0]?.trim() ?? null,
+            ...(requestId ? { requestId } : {}),
+        };
+        const remote = parseTraceparent(req.headers.get('traceparent'));
+        const span = remote
+            ? core.startRemoteRoot('http.server', `${method} ${route}`, attributes, remote)
+            : core.startSpan('http.server', `${method} ${route}`, attributes, null);
+        span.method = method;
+        span.route = route;
+        try {
+            const res = await core.runInSpan(span, () => handler(req, ctx));
+            span.statusCode = res.status;
+            if (res.status >= 500)
+                span.error = { name: 'HttpError', message: `HTTP ${res.status}` };
+            return res;
+        }
+        catch (err) {
+            span.setError(err);
+            if (span.statusCode === null)
+                span.statusCode = 500;
+            throw err;
+        }
+        finally {
+            span.end();
+        }
+    };
+}
+//# sourceMappingURL=next.js.map

package/dist/next.js.map

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