@victor-studio/monitor 0.1.0 → 0.4.0

package/dist/next/index.d.cts

@@ -1,92 +1,162 @@
 import { NextRequest, NextResponse } from 'next/server';
 
-interface MonitorEvent {
-    type: 'heartbeat' | 'request' | 'vital';
-    data: Record<string, unknown>;
-    timestamp: string;
+interface HeartbeatData {
+    status: 'online' | 'offline';
+    latencyMs: number;
 }
-interface TransportConfig {
-    endpoint: string;
-    apiKey: string;
+interface RequestData {
+    method: string;
+    route: string;
+    statusCode: number;
+    responseTimeMs: number;
+    userAgent?: string;
+    region?: string;
 }
-
-declare class Collector {
-    private buffer;
-    private timer;
-    private config;
-    private flushInterval;
-    constructor(config: TransportConfig, flushInterval?: number);
-    start(): void;
-    stop(): void;
-    push(event: Omit<MonitorEvent, 'timestamp'>): void;
-    private flush;
+interface VitalData {
+    name: 'LCP' | 'INP' | 'CLS' | 'FCP' | 'TTFB';
+    value: number;
+    rating: 'good' | 'needs-improvement' | 'poor';
+    page?: string;
+    deviceType?: string;
+    browser?: string;
+}
+interface ErrorData {
+    type: 'unhandled' | 'caught' | 'promise';
+    message: string;
+    stack?: string;
+    groupingKey: string;
+    route?: string;
+    method?: string;
+    statusCode?: number;
+    environment?: string;
+    commitHash?: string;
+    extra?: Record<string, string>;
+}
+interface DeployData {
+    commitHash: string;
+    branch?: string;
+    author?: string;
+    status: 'started' | 'succeeded' | 'failed';
+    buildDurationMs?: number;
+    url?: string;
+    environment?: string;
+    provider?: string;
+}
+interface AdapterData {
+    adapter: string;
+    operation: string;
+    durationMs: number;
+    success: boolean;
+    error?: string;
+    meta?: Record<string, string>;
 }
+type MonitorEvent = {
+    type: 'heartbeat';
+    data: HeartbeatData;
+    timestamp: string;
+} | {
+    type: 'request';
+    data: RequestData;
+    timestamp: string;
+} | {
+    type: 'vital';
+    data: VitalData;
+    timestamp: string;
+} | {
+    type: 'error';
+    data: ErrorData;
+    timestamp: string;
+} | {
+    type: 'deploy';
+    data: DeployData;
+    timestamp: string;
+} | {
+    type: 'adapter';
+    data: AdapterData;
+    timestamp: string;
+};
+/** Hook para filtrar/modificar eventos antes do envio */
+type BeforeSendHook = (event: MonitorEvent) => MonitorEvent | null;
 
 interface MonitorConfig {
     /** ID do projeto no Nuvio */
     projectId: string;
     /** API key gerada no Nuvio */
     apiKey: string;
-    /** URL do endpoint de ingest (ex: https://app.nuvio.com/api/monitor/ingest) */
+    /** URL do endpoint de ingest */
     endpoint: string;
     /** Intervalo do heartbeat em ms (default: 60000) */
     heartbeatInterval?: number;
     /** Intervalo do flush do buffer em ms (default: 30000) */
     flushInterval?: number;
+    /** Timeout do fetch em ms (default: 10000) */
+    timeout?: number;
+    /** Max tentativas de retry (default: 3) */
+    maxRetries?: number;
     /** Desabilitar em desenvolvimento (default: true) */
     disableInDev?: boolean;
+    /** Taxa de amostragem 0.0-1.0 (default: 1.0). Heartbeats nunca são amostrados */
+    sampleRate?: number;
+    /** Hook chamado antes de enfileirar cada evento. Retorna null para dropar */
+    beforeSend?: BeforeSendHook;
+    /** Habilitar logs de debug no console (default: false) */
+    debug?: boolean;
+    /** Capturar erros globais automaticamente — window.onerror (default: false) */
+    captureErrors?: boolean;
+    /** Capturar unhandled promise rejections automaticamente (default: false) */
+    captureUnhandledRejections?: boolean;
 }
 declare class MonitorClient {
     readonly config: MonitorConfig;
-    readonly collector: Collector;
+    private readonly collector;
+    private readonly logger;
     private heartbeatTimer;
+    private globalHandlersCleanup;
     private active;
     constructor(config: MonitorConfig);
     /** Inicia o monitoring (heartbeat + collector) */
     start(): void;
     /** Para o monitoring */
     stop(): void;
+    /** Força um flush imediato do buffer */
+    flush(): void;
+    /** Verifica se o monitoring está ativo */
+    get isActive(): boolean;
     /** Registra um evento de request HTTP (usado pelo middleware) */
-    trackRequest(data: {
-        method: string;
-        route: string;
-        statusCode: number;
-        responseTimeMs: number;
-        userAgent?: string;
-        region?: string;
-    }): void;
+    trackRequest(data: RequestData): void;
     /** Registra um Web Vital (usado pelo MonitorScript) */
-    trackVital(data: {
-        name: 'LCP' | 'INP' | 'CLS' | 'FCP' | 'TTFB';
-        value: number;
-        rating: 'good' | 'needs-improvement' | 'poor';
-        page?: string;
-        deviceType?: string;
-        browser?: string;
-    }): void;
+    trackVital(data: VitalData): void;
+    /** Registra um evento de adapter (DB, cache, AI, queue, email) */
+    trackAdapter(data: AdapterData): void;
+    /** Registra um erro capturado */
+    captureError(data: ErrorData): void;
+    /** Registra um evento de deploy */
+    trackDeploy(data: DeployData): void;
     private startHeartbeat;
     private sendHeartbeat;
-    private isDev;
 }
 
 type NextMiddleware = (request: NextRequest) => NextResponse | Response | Promise<NextResponse | Response> | undefined | Promise<undefined>;
+/** Opções do middleware de monitoring */
+interface WithMonitorOptions {
+    /** Regex patterns para rotas a excluir (além dos defaults) */
+    excludeRoutes?: RegExp[];
+    /** Incluir assets estáticos no tracking (default: false) */
+    includeStaticAssets?: boolean;
+}
 /**
  * Envolve o middleware do Next.js para capturar métricas de request.
  *
  * @example
  * ```ts
- * // middleware.ts
  * import { withMonitor } from '@victor-studio/monitor/next'
  * import { monitor } from '@/lib/monitor'
  *
- * function middleware(request: NextRequest) {
- *   // sua lógica de middleware
- *   return NextResponse.next()
- * }
- *
- * export default withMonitor(monitor, middleware)
+ * export default withMonitor(monitor)
+ * // ou com middleware existente:
+ * export default withMonitor(monitor, myMiddleware, { excludeRoutes: [/^\/api\/health/] })
  * ```
  */
-declare function withMonitor(monitor: MonitorClient, middleware?: NextMiddleware): (request: NextRequest) => Promise<NextResponse | Response | undefined>;
+declare function withMonitor(monitor: MonitorClient, middleware?: NextMiddleware, options?: WithMonitorOptions): (request: NextRequest) => Promise<NextResponse | Response | undefined>;
 
 export { withMonitor };

package/dist/next/index.d.ts

@@ -1,92 +1,162 @@
 import { NextRequest, NextResponse } from 'next/server';
 
-interface MonitorEvent {
-    type: 'heartbeat' | 'request' | 'vital';
-    data: Record<string, unknown>;
-    timestamp: string;
+interface HeartbeatData {
+    status: 'online' | 'offline';
+    latencyMs: number;
 }
-interface TransportConfig {
-    endpoint: string;
-    apiKey: string;
+interface RequestData {
+    method: string;
+    route: string;
+    statusCode: number;
+    responseTimeMs: number;
+    userAgent?: string;
+    region?: string;
 }
-
-declare class Collector {
-    private buffer;
-    private timer;
-    private config;
-    private flushInterval;
-    constructor(config: TransportConfig, flushInterval?: number);
-    start(): void;
-    stop(): void;
-    push(event: Omit<MonitorEvent, 'timestamp'>): void;
-    private flush;
+interface VitalData {
+    name: 'LCP' | 'INP' | 'CLS' | 'FCP' | 'TTFB';
+    value: number;
+    rating: 'good' | 'needs-improvement' | 'poor';
+    page?: string;
+    deviceType?: string;
+    browser?: string;
+}
+interface ErrorData {
+    type: 'unhandled' | 'caught' | 'promise';
+    message: string;
+    stack?: string;
+    groupingKey: string;
+    route?: string;
+    method?: string;
+    statusCode?: number;
+    environment?: string;
+    commitHash?: string;
+    extra?: Record<string, string>;
+}
+interface DeployData {
+    commitHash: string;
+    branch?: string;
+    author?: string;
+    status: 'started' | 'succeeded' | 'failed';
+    buildDurationMs?: number;
+    url?: string;
+    environment?: string;
+    provider?: string;
+}
+interface AdapterData {
+    adapter: string;
+    operation: string;
+    durationMs: number;
+    success: boolean;
+    error?: string;
+    meta?: Record<string, string>;
 }
+type MonitorEvent = {
+    type: 'heartbeat';
+    data: HeartbeatData;
+    timestamp: string;
+} | {
+    type: 'request';
+    data: RequestData;
+    timestamp: string;
+} | {
+    type: 'vital';
+    data: VitalData;
+    timestamp: string;
+} | {
+    type: 'error';
+    data: ErrorData;
+    timestamp: string;
+} | {
+    type: 'deploy';
+    data: DeployData;
+    timestamp: string;
+} | {
+    type: 'adapter';
+    data: AdapterData;
+    timestamp: string;
+};
+/** Hook para filtrar/modificar eventos antes do envio */
+type BeforeSendHook = (event: MonitorEvent) => MonitorEvent | null;
 
 interface MonitorConfig {
     /** ID do projeto no Nuvio */
     projectId: string;
     /** API key gerada no Nuvio */
     apiKey: string;
-    /** URL do endpoint de ingest (ex: https://app.nuvio.com/api/monitor/ingest) */
+    /** URL do endpoint de ingest */
     endpoint: string;
     /** Intervalo do heartbeat em ms (default: 60000) */
     heartbeatInterval?: number;
     /** Intervalo do flush do buffer em ms (default: 30000) */
     flushInterval?: number;
+    /** Timeout do fetch em ms (default: 10000) */
+    timeout?: number;
+    /** Max tentativas de retry (default: 3) */
+    maxRetries?: number;
     /** Desabilitar em desenvolvimento (default: true) */
     disableInDev?: boolean;
+    /** Taxa de amostragem 0.0-1.0 (default: 1.0). Heartbeats nunca são amostrados */
+    sampleRate?: number;
+    /** Hook chamado antes de enfileirar cada evento. Retorna null para dropar */
+    beforeSend?: BeforeSendHook;
+    /** Habilitar logs de debug no console (default: false) */
+    debug?: boolean;
+    /** Capturar erros globais automaticamente — window.onerror (default: false) */
+    captureErrors?: boolean;
+    /** Capturar unhandled promise rejections automaticamente (default: false) */
+    captureUnhandledRejections?: boolean;
 }
 declare class MonitorClient {
     readonly config: MonitorConfig;
-    readonly collector: Collector;
+    private readonly collector;
+    private readonly logger;
     private heartbeatTimer;
+    private globalHandlersCleanup;
     private active;
     constructor(config: MonitorConfig);
     /** Inicia o monitoring (heartbeat + collector) */
     start(): void;
     /** Para o monitoring */
     stop(): void;
+    /** Força um flush imediato do buffer */
+    flush(): void;
+    /** Verifica se o monitoring está ativo */
+    get isActive(): boolean;
     /** Registra um evento de request HTTP (usado pelo middleware) */
-    trackRequest(data: {
-        method: string;
-        route: string;
-        statusCode: number;
-        responseTimeMs: number;
-        userAgent?: string;
-        region?: string;
-    }): void;
+    trackRequest(data: RequestData): void;
     /** Registra um Web Vital (usado pelo MonitorScript) */
-    trackVital(data: {
-        name: 'LCP' | 'INP' | 'CLS' | 'FCP' | 'TTFB';
-        value: number;
-        rating: 'good' | 'needs-improvement' | 'poor';
-        page?: string;
-        deviceType?: string;
-        browser?: string;
-    }): void;
+    trackVital(data: VitalData): void;
+    /** Registra um evento de adapter (DB, cache, AI, queue, email) */
+    trackAdapter(data: AdapterData): void;
+    /** Registra um erro capturado */
+    captureError(data: ErrorData): void;
+    /** Registra um evento de deploy */
+    trackDeploy(data: DeployData): void;
     private startHeartbeat;
     private sendHeartbeat;
-    private isDev;
 }
 
 type NextMiddleware = (request: NextRequest) => NextResponse | Response | Promise<NextResponse | Response> | undefined | Promise<undefined>;
+/** Opções do middleware de monitoring */
+interface WithMonitorOptions {
+    /** Regex patterns para rotas a excluir (além dos defaults) */
+    excludeRoutes?: RegExp[];
+    /** Incluir assets estáticos no tracking (default: false) */
+    includeStaticAssets?: boolean;
+}
 /**
  * Envolve o middleware do Next.js para capturar métricas de request.
  *
  * @example
  * ```ts
- * // middleware.ts
  * import { withMonitor } from '@victor-studio/monitor/next'
  * import { monitor } from '@/lib/monitor'
  *
- * function middleware(request: NextRequest) {
- *   // sua lógica de middleware
- *   return NextResponse.next()
- * }
- *
- * export default withMonitor(monitor, middleware)
+ * export default withMonitor(monitor)
+ * // ou com middleware existente:
+ * export default withMonitor(monitor, myMiddleware, { excludeRoutes: [/^\/api\/health/] })
  * ```
  */
-declare function withMonitor(monitor: MonitorClient, middleware?: NextMiddleware): (request: NextRequest) => Promise<NextResponse | Response | undefined>;
+declare function withMonitor(monitor: MonitorClient, middleware?: NextMiddleware, options?: WithMonitorOptions): (request: NextRequest) => Promise<NextResponse | Response | undefined>;
 
 export { withMonitor };

package/dist/next/index.js

@@ -1,26 +1,45 @@
 // src/next/middleware.ts
-function withMonitor(monitor, middleware) {
+var STATIC_ASSET_PATTERN = /^\/(_next\/|favicon|.*\.(ico|png|jpg|jpeg|gif|svg|css|woff2?|ttf|eot)$)/;
+var REGION_HEADERS = [
+  "x-vercel-ip-country",
+  // Vercel
+  "x-railway-region",
+  // Railway
+  "cf-ipcountry",
+  // Cloudflare
+  "x-country-code"
+  // Generic CDN
+];
+function withMonitor(monitor, middleware, options) {
   return async (request) => {
+    const { pathname } = new URL(request.url);
+    if (!options?.includeStaticAssets && STATIC_ASSET_PATTERN.test(pathname)) {
+      return middleware ? middleware(request) : void 0;
+    }
+    if (options?.excludeRoutes?.some((pattern) => pattern.test(pathname))) {
+      return middleware ? middleware(request) : void 0;
+    }
     const start = performance.now();
     let response;
     if (middleware) {
       response = await middleware(request);
     }
     const responseTimeMs = Math.round(performance.now() - start);
-    const method = request.method;
-    const route = new URL(request.url).pathname;
-    const statusCode = response instanceof Response ? response.status : 200;
-    const userAgent = request.headers.get("user-agent") ?? void 0;
-    const region = request.headers.get("x-vercel-ip-country") ?? void 0;
-    if (route.startsWith("/_next/") || route.startsWith("/favicon") || route.endsWith(".ico") || route.endsWith(".png") || route.endsWith(".jpg") || route.endsWith(".svg") || route.endsWith(".css") || route.endsWith(".js")) {
-      return response;
+    let region;
+    for (const header of REGION_HEADERS) {
+      const value = request.headers.get(header);
+      if (value) {
+        region = value;
+        break;
+      }
     }
     monitor.trackRequest({
-      method,
-      route,
-      statusCode,
+      method: request.method,
+      route: pathname,
+      // Não assumir 200 quando middleware retorna undefined (pass-through)
+      statusCode: response instanceof Response ? response.status : 0,
       responseTimeMs,
-      userAgent,
+      userAgent: request.headers.get("user-agent") ?? void 0,
       region
     });
     return response;

package/dist/next/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/next/middleware.ts"],"names":[],"mappings":";AA0BO,SAAS,WAAA,CAAY,SAAwB,UAAA,EAA6B;AAC/E,EAAA,OAAO,OAAO,OAAA,KAAuE;AACnF,IAAA,MAAM,KAAA,GAAQ,YAAY,GAAA,EAAI;AAG9B,IAAA,IAAI,QAAA;AACJ,IAAA,IAAI,UAAA,EAAY;AACd,MAAA,QAAA,GAAW,MAAM,WAAW,OAAO,CAAA;AAAA,IACrC;AAEA,IAAA,MAAM,iBAAiB,IAAA,CAAK,KAAA,CAAM,WAAA,CAAY,GAAA,KAAQ,KAAK,CAAA;AAG3D,IAAA,MAAM,SAAS,OAAA,CAAQ,MAAA;AACvB,IAAA,MAAM,KAAA,GAAQ,IAAI,GAAA,CAAI,OAAA,CAAQ,GAAG,CAAA,CAAE,QAAA;AACnC,IAAA,MAAM,UAAA,GAAa,QAAA,YAAoB,QAAA,GAAW,QAAA,CAAS,MAAA,GAAS,GAAA;AACpE,IAAA,MAAM,SAAA,GAAY,OAAA,CAAQ,OAAA,CAAQ,GAAA,CAAI,YAAY,CAAA,IAAK,MAAA;AACvD,IAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,OAAA,CAAQ,GAAA,CAAI,qBAAqB,CAAA,IAAK,MAAA;AAG7D,IAAA,IACE,KAAA,CAAM,UAAA,CAAW,SAAS,CAAA,IAC1B,KAAA,CAAM,UAAA,CAAW,UAAU,CAAA,IAC3B,KAAA,CAAM,QAAA,CAAS,MAAM,CAAA,IACrB,MAAM,QAAA,CAAS,MAAM,CAAA,IACrB,KAAA,CAAM,QAAA,CAAS,MAAM,CAAA,IACrB,KAAA,CAAM,SAAS,MAAM,CAAA,IACrB,KAAA,CAAM,QAAA,CAAS,MAAM,CAAA,IACrB,KAAA,CAAM,QAAA,CAAS,KAAK,CAAA,EACpB;AACA,MAAA,OAAO,QAAA;AAAA,IACT;AAEA,IAAA,OAAA,CAAQ,YAAA,CAAa;AAAA,MACnB,MAAA;AAAA,MACA,KAAA;AAAA,MACA,UAAA;AAAA,MACA,cAAA;AAAA,MACA,SAAA;AAAA,MACA;AAAA,KACD,CAAA;AAED,IAAA,OAAO,QAAA;AAAA,EACT,CAAA;AACF","file":"index.js","sourcesContent":["// withMonitor — wrapper de middleware Next.js que captura métricas HTTP\n\nimport type { MonitorClient } from '../core/client'\nimport type { NextRequest, NextResponse } from 'next/server'\n\ntype NextMiddleware = (\n  request: NextRequest,\n) => NextResponse | Response | Promise<NextResponse | Response> | undefined | Promise<undefined>\n\n/**\n * Envolve o middleware do Next.js para capturar métricas de request.\n *\n * @example\n * ```ts\n * // middleware.ts\n * import { withMonitor } from '@victor-studio/monitor/next'\n * import { monitor } from '@/lib/monitor'\n *\n * function middleware(request: NextRequest) {\n *   // sua lógica de middleware\n *   return NextResponse.next()\n * }\n *\n * export default withMonitor(monitor, middleware)\n * ```\n */\nexport function withMonitor(monitor: MonitorClient, middleware?: NextMiddleware) {\n  return async (request: NextRequest): Promise<NextResponse | Response | undefined> => {\n    const start = performance.now()\n\n    // Executar middleware original\n    let response: NextResponse | Response | undefined\n    if (middleware) {\n      response = await middleware(request)\n    }\n\n    const responseTimeMs = Math.round(performance.now() - start)\n\n    // Extrair dados do request\n    const method = request.method\n    const route = new URL(request.url).pathname\n    const statusCode = response instanceof Response ? response.status : 200\n    const userAgent = request.headers.get('user-agent') ?? undefined\n    const region = request.headers.get('x-vercel-ip-country') ?? undefined\n\n    // Ignorar requests de assets estáticos\n    if (\n      route.startsWith('/_next/') ||\n      route.startsWith('/favicon') ||\n      route.endsWith('.ico') ||\n      route.endsWith('.png') ||\n      route.endsWith('.jpg') ||\n      route.endsWith('.svg') ||\n      route.endsWith('.css') ||\n      route.endsWith('.js')\n    ) {\n      return response\n    }\n\n    monitor.trackRequest({\n      method,\n      route,\n      statusCode,\n      responseTimeMs,\n      userAgent,\n      region,\n    })\n\n    return response\n  }\n}\n"]}
+{"version":3,"sources":["../../src/next/middleware.ts"],"names":[],"mappings":";AAkBA,IAAM,oBAAA,GACJ,yEAAA;AAGF,IAAM,cAAA,GAAiB;AAAA,EACrB,qBAAA;AAAA;AAAA,EACA,kBAAA;AAAA;AAAA,EACA,cAAA;AAAA;AAAA,EACA;AAAA;AACF,CAAA;AAeO,SAAS,WAAA,CACd,OAAA,EACA,UAAA,EACA,OAAA,EACA;AACA,EAAA,OAAO,OAAO,OAAA,KAAuE;AACnF,IAAA,MAAM,EAAE,QAAA,EAAS,GAAI,IAAI,GAAA,CAAI,QAAQ,GAAG,CAAA;AAGxC,IAAA,IAAI,CAAC,OAAA,EAAS,mBAAA,IAAuB,oBAAA,CAAqB,IAAA,CAAK,QAAQ,CAAA,EAAG;AACxE,MAAA,OAAO,UAAA,GAAa,UAAA,CAAW,OAAO,CAAA,GAAI,MAAA;AAAA,IAC5C;AAGA,IAAA,IAAI,OAAA,EAAS,eAAe,IAAA,CAAK,CAAC,YAAY,OAAA,CAAQ,IAAA,CAAK,QAAQ,CAAC,CAAA,EAAG;AACrE,MAAA,OAAO,UAAA,GAAa,UAAA,CAAW,OAAO,CAAA,GAAI,MAAA;AAAA,IAC5C;AAEA,IAAA,MAAM,KAAA,GAAQ,YAAY,GAAA,EAAI;AAG9B,IAAA,IAAI,QAAA;AACJ,IAAA,IAAI,UAAA,EAAY;AACd,MAAA,QAAA,GAAW,MAAM,WAAW,OAAO,CAAA;AAAA,IACrC;AAEA,IAAA,MAAM,iBAAiB,IAAA,CAAK,KAAA,CAAM,WAAA,CAAY,GAAA,KAAQ,KAAK,CAAA;AAG3D,IAAA,IAAI,MAAA;AACJ,IAAA,KAAA,MAAW,UAAU,cAAA,EAAgB;AACnC,MAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,OAAA,CAAQ,GAAA,CAAI,MAAM,CAAA;AACxC,MAAA,IAAI,KAAA,EAAO;AACT,QAAA,MAAA,GAAS,KAAA;AACT,QAAA;AAAA,MACF;AAAA,IACF;AAEA,IAAA,OAAA,CAAQ,YAAA,CAAa;AAAA,MACnB,QAAQ,OAAA,CAAQ,MAAA;AAAA,MAChB,KAAA,EAAO,QAAA;AAAA;AAAA,MAEP,UAAA,EAAY,QAAA,YAAoB,QAAA,GAAW,QAAA,CAAS,MAAA,GAAS,CAAA;AAAA,MAC7D,cAAA;AAAA,MACA,SAAA,EAAW,OAAA,CAAQ,OAAA,CAAQ,GAAA,CAAI,YAAY,CAAA,IAAK,MAAA;AAAA,MAChD;AAAA,KACD,CAAA;AAED,IAAA,OAAO,QAAA;AAAA,EACT,CAAA;AACF","file":"index.js","sourcesContent":["// withMonitor — wrapper de middleware Next.js para tracking de requests\n\nimport type { MonitorClient } from '../core/client'\nimport type { NextRequest, NextResponse } from 'next/server'\n\ntype NextMiddleware = (\n  request: NextRequest,\n) => NextResponse | Response | Promise<NextResponse | Response> | undefined | Promise<undefined>\n\n/** Opções do middleware de monitoring */\nexport interface WithMonitorOptions {\n  /** Regex patterns para rotas a excluir (além dos defaults) */\n  excludeRoutes?: RegExp[]\n  /** Incluir assets estáticos no tracking (default: false) */\n  includeStaticAssets?: boolean\n}\n\n// Padrão default para assets estáticos\nconst STATIC_ASSET_PATTERN =\n  /^\\/(_next\\/|favicon|.*\\.(ico|png|jpg|jpeg|gif|svg|css|woff2?|ttf|eot)$)/\n\n// Headers de região por provider (testados em ordem)\nconst REGION_HEADERS = [\n  'x-vercel-ip-country', // Vercel\n  'x-railway-region', // Railway\n  'cf-ipcountry', // Cloudflare\n  'x-country-code', // Generic CDN\n] as const\n\n/**\n * Envolve o middleware do Next.js para capturar métricas de request.\n *\n * @example\n * ```ts\n * import { withMonitor } from '@victor-studio/monitor/next'\n * import { monitor } from '@/lib/monitor'\n *\n * export default withMonitor(monitor)\n * // ou com middleware existente:\n * export default withMonitor(monitor, myMiddleware, { excludeRoutes: [/^\\/api\\/health/] })\n * ```\n */\nexport function withMonitor(\n  monitor: MonitorClient,\n  middleware?: NextMiddleware,\n  options?: WithMonitorOptions,\n) {\n  return async (request: NextRequest): Promise<NextResponse | Response | undefined> => {\n    const { pathname } = new URL(request.url)\n\n    // Filtrar assets estáticos (a menos que explicitamente incluídos)\n    if (!options?.includeStaticAssets && STATIC_ASSET_PATTERN.test(pathname)) {\n      return middleware ? middleware(request) : undefined\n    }\n\n    // Filtrar rotas customizadas\n    if (options?.excludeRoutes?.some((pattern) => pattern.test(pathname))) {\n      return middleware ? middleware(request) : undefined\n    }\n\n    const start = performance.now()\n\n    // Executar middleware original (se existir)\n    let response: NextResponse | Response | undefined\n    if (middleware) {\n      response = await middleware(request)\n    }\n\n    const responseTimeMs = Math.round(performance.now() - start)\n\n    // Detectar região — chain de headers por provider\n    let region: string | undefined\n    for (const header of REGION_HEADERS) {\n      const value = request.headers.get(header)\n      if (value) {\n        region = value\n        break\n      }\n    }\n\n    monitor.trackRequest({\n      method: request.method,\n      route: pathname,\n      // Não assumir 200 quando middleware retorna undefined (pass-through)\n      statusCode: response instanceof Response ? response.status : 0,\n      responseTimeMs,\n      userAgent: request.headers.get('user-agent') ?? undefined,\n      region,\n    })\n\n    return response\n  }\n}\n"]}

package/dist/react/index.cjs

@@ -5,6 +5,10 @@ var react = require('react');
 // src/react/monitor-script.tsx
 function detectDeviceType() {
   if (typeof window === "undefined") return "unknown";
+  const uaData = navigator.userAgentData;
+  if (uaData) {
+    return uaData.mobile ? "mobile" : "desktop";
+  }
   const ua = navigator.userAgent;
   if (/Mobile|Android/i.test(ua)) return "mobile";
   if (/Tablet|iPad/i.test(ua)) return "tablet";
@@ -12,20 +16,32 @@ function detectDeviceType() {
 }
 function detectBrowser() {
   if (typeof window === "undefined") return "unknown";
+  const uaData = navigator.userAgentData;
+  if (uaData?.brands?.length) {
+    const dominated = uaData.brands.find(
+      (b) => !b.brand.startsWith("Not") && !b.brand.startsWith("Chromium")
+    );
+    if (dominated) return dominated.brand;
+  }
   const ua = navigator.userAgent;
   if (ua.includes("Firefox")) return "Firefox";
   if (ua.includes("Edg/")) return "Edge";
+  if (ua.includes("OPR/") || ua.includes("Opera")) return "Opera";
+  if (ua.includes("SamsungBrowser")) return "Samsung Browser";
+  if (ua.includes("Brave")) return "Brave";
   if (ua.includes("Chrome")) return "Chrome";
   if (ua.includes("Safari")) return "Safari";
   return "other";
 }
 function MonitorScript({ monitor }) {
   react.useEffect(() => {
+    let cancelled = false;
     import('web-vitals').then(({ onLCP, onINP, onCLS, onFCP, onTTFB }) => {
-      const page = typeof window !== "undefined" ? window.location.pathname : void 0;
+      if (cancelled) return;
       const deviceType = detectDeviceType();
       const browser = detectBrowser();
       const report = (name, value, rating) => {
+        const page = typeof window !== "undefined" ? window.location.pathname : void 0;
         monitor.trackVital({ name, value, rating, page, deviceType, browser });
       };
       onLCP((metric) => report("LCP", metric.value, metric.rating));
@@ -34,6 +50,9 @@ function MonitorScript({ monitor }) {
       onFCP((metric) => report("FCP", metric.value, metric.rating));
       onTTFB((metric) => report("TTFB", metric.value, metric.rating));
     });
+    return () => {
+      cancelled = true;
+    };
   }, [monitor]);
   return null;
 }

package/dist/react/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/react/monitor-script.tsx"],"names":["useEffect"],"mappings":";;;;;AAWA,SAAS,gBAAA,GAA2B;AAClC,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,EAAa,OAAO,SAAA;AAC1C,EAAA,MAAM,KAAK,SAAA,CAAU,SAAA;AACrB,EAAA,IAAI,iBAAA,CAAkB,IAAA,CAAK,EAAE,CAAA,EAAG,OAAO,QAAA;AACvC,EAAA,IAAI,cAAA,CAAe,IAAA,CAAK,EAAE,CAAA,EAAG,OAAO,QAAA;AACpC,EAAA,OAAO,SAAA;AACT;AAEA,SAAS,aAAA,GAAwB;AAC/B,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,EAAa,OAAO,SAAA;AAC1C,EAAA,MAAM,KAAK,SAAA,CAAU,SAAA;AACrB,EAAA,IAAI,EAAA,CAAG,QAAA,CAAS,SAAS,CAAA,EAAG,OAAO,SAAA;AACnC,EAAA,IAAI,EAAA,CAAG,QAAA,CAAS,MAAM,CAAA,EAAG,OAAO,MAAA;AAChC,EAAA,IAAI,EAAA,CAAG,QAAA,CAAS,QAAQ,CAAA,EAAG,OAAO,QAAA;AAClC,EAAA,IAAI,EAAA,CAAG,QAAA,CAAS,QAAQ,CAAA,EAAG,OAAO,QAAA;AAClC,EAAA,OAAO,OAAA;AACT;AAwBO,SAAS,aAAA,CAAc,EAAE,OAAA,EAAQ,EAAuB;AAC7D,EAAAA,eAAA,CAAU,MAAM;AAEd,IAAA,OAAO,YAAY,CAAA,CAAE,IAAA,CAAK,CAAC,EAAE,OAAO,KAAA,EAAO,KAAA,EAAO,KAAA,EAAO,MAAA,EAAO,KAAM;AACpE,MAAA,MAAM,OAAO,OAAO,MAAA,KAAW,WAAA,GAAc,MAAA,CAAO,SAAS,QAAA,GAAW,MAAA;AACxE,MAAA,MAAM,aAAa,gBAAA,EAAiB;AACpC,MAAA,MAAM,UAAU,aAAA,EAAc;AAE9B,MAAA,MAAM,MAAA,GAAS,CACb,IAAA,EACA,KAAA,EACA,MAAA,KACG;AACH,QAAA,OAAA,CAAQ,UAAA,CAAW,EAAE,IAAA,EAAM,KAAA,EAAO,QAAQ,IAAA,EAAM,UAAA,EAAY,SAAS,CAAA;AAAA,MACvE,CAAA;AAEA,MAAA,KAAA,CAAM,CAAC,WAAW,MAAA,CAAO,KAAA,EAAO,OAAO,KAAA,EAAO,MAAA,CAAO,MAAM,CAAC,CAAA;AAC5D,MAAA,KAAA,CAAM,CAAC,WAAW,MAAA,CAAO,KAAA,EAAO,OAAO,KAAA,EAAO,MAAA,CAAO,MAAM,CAAC,CAAA;AAC5D,MAAA,KAAA,CAAM,CAAC,WAAW,MAAA,CAAO,KAAA,EAAO,OAAO,KAAA,EAAO,MAAA,CAAO,MAAM,CAAC,CAAA;AAC5D,MAAA,KAAA,CAAM,CAAC,WAAW,MAAA,CAAO,KAAA,EAAO,OAAO,KAAA,EAAO,MAAA,CAAO,MAAM,CAAC,CAAA;AAC5D,MAAA,MAAA,CAAO,CAAC,WAAW,MAAA,CAAO,MAAA,EAAQ,OAAO,KAAA,EAAO,MAAA,CAAO,MAAM,CAAC,CAAA;AAAA,IAChE,CAAC,CAAA;AAAA,EACH,CAAA,EAAG,CAAC,OAAO,CAAC,CAAA;AAEZ,EAAA,OAAO,IAAA;AACT","file":"index.cjs","sourcesContent":["// MonitorScript — componente React que coleta Web Vitals\n\n'use client'\n\nimport { useEffect } from 'react'\nimport type { MonitorClient } from '../core/client'\n\ninterface MonitorScriptProps {\n  monitor: MonitorClient\n}\n\nfunction detectDeviceType(): string {\n  if (typeof window === 'undefined') return 'unknown'\n  const ua = navigator.userAgent\n  if (/Mobile|Android/i.test(ua)) return 'mobile'\n  if (/Tablet|iPad/i.test(ua)) return 'tablet'\n  return 'desktop'\n}\n\nfunction detectBrowser(): string {\n  if (typeof window === 'undefined') return 'unknown'\n  const ua = navigator.userAgent\n  if (ua.includes('Firefox')) return 'Firefox'\n  if (ua.includes('Edg/')) return 'Edge'\n  if (ua.includes('Chrome')) return 'Chrome'\n  if (ua.includes('Safari')) return 'Safari'\n  return 'other'\n}\n\n/**\n * Componente React que coleta Web Vitals automaticamente.\n * Coloque no root layout da aplicação.\n *\n * @example\n * ```tsx\n * // app/layout.tsx\n * import { MonitorScript } from '@victor-studio/monitor/react'\n * import { monitor } from '@/lib/monitor'\n *\n * export default function RootLayout({ children }) {\n *   return (\n *     <html>\n *       <body>\n *         {children}\n *         <MonitorScript monitor={monitor} />\n *       </body>\n *     </html>\n *   )\n * }\n * ```\n */\nexport function MonitorScript({ monitor }: MonitorScriptProps) {\n  useEffect(() => {\n    // Import dinâmico pra não aumentar o bundle se não usar\n    import('web-vitals').then(({ onLCP, onINP, onCLS, onFCP, onTTFB }) => {\n      const page = typeof window !== 'undefined' ? window.location.pathname : undefined\n      const deviceType = detectDeviceType()\n      const browser = detectBrowser()\n\n      const report = (\n        name: 'LCP' | 'INP' | 'CLS' | 'FCP' | 'TTFB',\n        value: number,\n        rating: 'good' | 'needs-improvement' | 'poor',\n      ) => {\n        monitor.trackVital({ name, value, rating, page, deviceType, browser })\n      }\n\n      onLCP((metric) => report('LCP', metric.value, metric.rating))\n      onINP((metric) => report('INP', metric.value, metric.rating))\n      onCLS((metric) => report('CLS', metric.value, metric.rating))\n      onFCP((metric) => report('FCP', metric.value, metric.rating))\n      onTTFB((metric) => report('TTFB', metric.value, metric.rating))\n    })\n  }, [monitor])\n\n  return null\n}\n"]}
+{"version":3,"sources":["../../src/react/monitor-script.tsx"],"names":["useEffect"],"mappings":";;;;;AAWA,SAAS,gBAAA,GAA2B;AAClC,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,EAAa,OAAO,SAAA;AAG1C,EAAA,MAAM,SAAU,SAAA,CAAmE,aAAA;AACnF,EAAA,IAAI,MAAA,EAAQ;AACV,IAAA,OAAO,MAAA,CAAO,SAAS,QAAA,GAAW,SAAA;AAAA,EACpC;AAGA,EAAA,MAAM,KAAK,SAAA,CAAU,SAAA;AACrB,EAAA,IAAI,iBAAA,CAAkB,IAAA,CAAK,EAAE,CAAA,EAAG,OAAO,QAAA;AACvC,EAAA,IAAI,cAAA,CAAe,IAAA,CAAK,EAAE,CAAA,EAAG,OAAO,QAAA;AACpC,EAAA,OAAO,SAAA;AACT;AAEA,SAAS,aAAA,GAAwB;AAC/B,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,EAAa,OAAO,SAAA;AAG1C,EAAA,MAAM,SAAU,SAAA,CACb,aAAA;AACH,EAAA,IAAI,MAAA,EAAQ,QAAQ,MAAA,EAAQ;AAC1B,IAAA,MAAM,SAAA,GAAY,OAAO,MAAA,CAAO,IAAA;AAAA,MAC9B,CAAC,CAAA,KAAM,CAAC,CAAA,CAAE,KAAA,CAAM,UAAA,CAAW,KAAK,CAAA,IAAK,CAAC,CAAA,CAAE,KAAA,CAAM,UAAA,CAAW,UAAU;AAAA,KACrE;AACA,IAAA,IAAI,SAAA,SAAkB,SAAA,CAAU,KAAA;AAAA,EAClC;AAGA,EAAA,MAAM,KAAK,SAAA,CAAU,SAAA;AACrB,EAAA,IAAI,EAAA,CAAG,QAAA,CAAS,SAAS,CAAA,EAAG,OAAO,SAAA;AACnC,EAAA,IAAI,EAAA,CAAG,QAAA,CAAS,MAAM,CAAA,EAAG,OAAO,MAAA;AAChC,EAAA,IAAI,EAAA,CAAG,SAAS,MAAM,CAAA,IAAK,GAAG,QAAA,CAAS,OAAO,GAAG,OAAO,OAAA;AACxD,EAAA,IAAI,EAAA,CAAG,QAAA,CAAS,gBAAgB,CAAA,EAAG,OAAO,iBAAA;AAC1C,EAAA,IAAI,EAAA,CAAG,QAAA,CAAS,OAAO,CAAA,EAAG,OAAO,OAAA;AACjC,EAAA,IAAI,EAAA,CAAG,QAAA,CAAS,QAAQ,CAAA,EAAG,OAAO,QAAA;AAClC,EAAA,IAAI,EAAA,CAAG,QAAA,CAAS,QAAQ,CAAA,EAAG,OAAO,QAAA;AAClC,EAAA,OAAO,OAAA;AACT;AAuBO,SAAS,aAAA,CAAc,EAAE,OAAA,EAAQ,EAAuB;AAC7D,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,SAAA,GAAY,KAAA;AAGhB,IAAA,OAAO,YAAY,CAAA,CAAE,IAAA,CAAK,CAAC,EAAE,OAAO,KAAA,EAAO,KAAA,EAAO,KAAA,EAAO,MAAA,EAAO,KAAM;AACpE,MAAA,IAAI,SAAA,EAAW;AAEf,MAAA,MAAM,aAAa,gBAAA,EAAiB;AACpC,MAAA,MAAM,UAAU,aAAA,EAAc;AAE9B,MAAA,MAAM,MAAA,GAAS,CACb,IAAA,EACA,KAAA,EACA,MAAA,KACG;AAEH,QAAA,MAAM,OAAO,OAAO,MAAA,KAAW,WAAA,GAAc,MAAA,CAAO,SAAS,QAAA,GAAW,MAAA;AACxE,QAAA,OAAA,CAAQ,UAAA,CAAW,EAAE,IAAA,EAAM,KAAA,EAAO,QAAQ,IAAA,EAAM,UAAA,EAAY,SAAS,CAAA;AAAA,MACvE,CAAA;AAEA,MAAA,KAAA,CAAM,CAAC,WAAW,MAAA,CAAO,KAAA,EAAO,OAAO,KAAA,EAAO,MAAA,CAAO,MAAM,CAAC,CAAA;AAC5D,MAAA,KAAA,CAAM,CAAC,WAAW,MAAA,CAAO,KAAA,EAAO,OAAO,KAAA,EAAO,MAAA,CAAO,MAAM,CAAC,CAAA;AAC5D,MAAA,KAAA,CAAM,CAAC,WAAW,MAAA,CAAO,KAAA,EAAO,OAAO,KAAA,EAAO,MAAA,CAAO,MAAM,CAAC,CAAA;AAC5D,MAAA,KAAA,CAAM,CAAC,WAAW,MAAA,CAAO,KAAA,EAAO,OAAO,KAAA,EAAO,MAAA,CAAO,MAAM,CAAC,CAAA;AAC5D,MAAA,MAAA,CAAO,CAAC,WAAW,MAAA,CAAO,MAAA,EAAQ,OAAO,KAAA,EAAO,MAAA,CAAO,MAAM,CAAC,CAAA;AAAA,IAChE,CAAC,CAAA;AAED,IAAA,OAAO,MAAM;AACX,MAAA,SAAA,GAAY,IAAA;AAAA,IACd,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,OAAO,CAAC,CAAA;AAEZ,EAAA,OAAO,IAAA;AACT","file":"index.cjs","sourcesContent":["// MonitorScript — componente React que coleta Web Vitals\n\n'use client'\n\nimport { useEffect } from 'react'\nimport type { MonitorClient } from '../core/client'\n\ninterface MonitorScriptProps {\n  monitor: MonitorClient\n}\n\nfunction detectDeviceType(): string {\n  if (typeof window === 'undefined') return 'unknown'\n\n  // Preferir User-Agent Client Hints (API moderna)\n  const uaData = (navigator as Navigator & { userAgentData?: { mobile?: boolean } }).userAgentData\n  if (uaData) {\n    return uaData.mobile ? 'mobile' : 'desktop'\n  }\n\n  // Fallback para UA string\n  const ua = navigator.userAgent\n  if (/Mobile|Android/i.test(ua)) return 'mobile'\n  if (/Tablet|iPad/i.test(ua)) return 'tablet'\n  return 'desktop'\n}\n\nfunction detectBrowser(): string {\n  if (typeof window === 'undefined') return 'unknown'\n\n  // Preferir User-Agent Client Hints\n  const uaData = (navigator as Navigator & { userAgentData?: { brands?: { brand: string }[] } })\n    .userAgentData\n  if (uaData?.brands?.length) {\n    const dominated = uaData.brands.find(\n      (b) => !b.brand.startsWith('Not') && !b.brand.startsWith('Chromium'),\n    )\n    if (dominated) return dominated.brand\n  }\n\n  // Fallback para UA string (ordem importa — Chrome inclui Safari no UA)\n  const ua = navigator.userAgent\n  if (ua.includes('Firefox')) return 'Firefox'\n  if (ua.includes('Edg/')) return 'Edge'\n  if (ua.includes('OPR/') || ua.includes('Opera')) return 'Opera'\n  if (ua.includes('SamsungBrowser')) return 'Samsung Browser'\n  if (ua.includes('Brave')) return 'Brave'\n  if (ua.includes('Chrome')) return 'Chrome'\n  if (ua.includes('Safari')) return 'Safari'\n  return 'other'\n}\n\n/**\n * Componente React que coleta Web Vitals automaticamente.\n * Coloque no root layout da aplicação.\n *\n * @example\n * ```tsx\n * import { MonitorScript } from '@victor-studio/monitor/react'\n * import { monitor } from '@/lib/monitor'\n *\n * export default function RootLayout({ children }) {\n *   return (\n *     <html>\n *       <body>\n *         {children}\n *         <MonitorScript monitor={monitor} />\n *       </body>\n *     </html>\n *   )\n * }\n * ```\n */\nexport function MonitorScript({ monitor }: MonitorScriptProps) {\n  useEffect(() => {\n    let cancelled = false\n\n    // Import dinâmico pra não aumentar o bundle\n    import('web-vitals').then(({ onLCP, onINP, onCLS, onFCP, onTTFB }) => {\n      if (cancelled) return\n\n      const deviceType = detectDeviceType()\n      const browser = detectBrowser()\n\n      const report = (\n        name: 'LCP' | 'INP' | 'CLS' | 'FCP' | 'TTFB',\n        value: number,\n        rating: 'good' | 'needs-improvement' | 'poor',\n      ) => {\n        // Captura page no momento do report, não no mount (fix SPA navigation)\n        const page = typeof window !== 'undefined' ? window.location.pathname : undefined\n        monitor.trackVital({ name, value, rating, page, deviceType, browser })\n      }\n\n      onLCP((metric) => report('LCP', metric.value, metric.rating))\n      onINP((metric) => report('INP', metric.value, metric.rating))\n      onCLS((metric) => report('CLS', metric.value, metric.rating))\n      onFCP((metric) => report('FCP', metric.value, metric.rating))\n      onTTFB((metric) => report('TTFB', metric.value, metric.rating))\n    })\n\n    return () => {\n      cancelled = true\n    }\n  }, [monitor])\n\n  return null\n}\n"]}