@victor-studio/monitor 0.1.0 → 0.4.0

package/dist/react/index.d.cts

@@ -1,70 +1,137 @@
-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;
 }
 
 interface MonitorScriptProps {
@@ -76,7 +143,6 @@ interface MonitorScriptProps {
  *
  * @example
  * ```tsx
- * // app/layout.tsx
  * import { MonitorScript } from '@victor-studio/monitor/react'
  * import { monitor } from '@/lib/monitor'
  *

package/dist/react/index.d.ts

@@ -1,70 +1,137 @@
-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;
 }
 
 interface MonitorScriptProps {
@@ -76,7 +143,6 @@ interface MonitorScriptProps {
  *
  * @example
  * ```tsx
- * // app/layout.tsx
  * import { MonitorScript } from '@victor-studio/monitor/react'
  * import { monitor } from '@/lib/monitor'
  *

package/dist/react/index.js

@@ -3,6 +3,10 @@ import { useEffect } from '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";
@@ -10,20 +14,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 }) {
   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));
@@ -32,6 +48,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.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/react/monitor-script.tsx"],"names":[],"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,EAAA,SAAA,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.js","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":[],"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,EAAA,SAAA,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.js","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"]}

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@victor-studio/monitor",
-  "version": "0.1.0",
+  "version": "0.4.0",
   "description": "Lightweight monitoring SDK for Nuvio-managed projects",
   "type": "module",
+  "sideEffects": false,
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -21,6 +22,11 @@
       "types": "./dist/react/index.d.ts",
       "import": "./dist/react/index.js",
       "require": "./dist/react/index.cjs"
+    },
+    "./errors": {
+      "types": "./dist/errors/index.d.ts",
+      "import": "./dist/errors/index.js",
+      "require": "./dist/errors/index.cjs"
     }
   },
   "files": [
@@ -34,7 +40,8 @@
   },
   "peerDependencies": {
     "next": ">=14",
-    "react": ">=18"
+    "react": ">=18",
+    "web-vitals": ">=4"
   },
   "peerDependenciesMeta": {
     "next": {
@@ -42,15 +49,16 @@
     },
     "react": {
       "optional": true
+    },
+    "web-vitals": {
+      "optional": true
     }
   },
   "devDependencies": {
     "@types/node": "^25.6.0",
-    "@types/react": "^19.0.0",
+    "@types/react": ">=18",
     "tsup": "^8.0.0",
-    "typescript": "^5.9.0"
-  },
-  "dependencies": {
+    "typescript": "^5.9.0",
     "web-vitals": "^4.2.0"
   },
   "keywords": [
@@ -58,7 +66,9 @@
     "sdk",
     "web-vitals",
     "uptime",
-    "performance"
+    "performance",
+    "heartbeat",
+    "apm"
   ],
   "author": "Victor Studio",
   "license": "MIT",