@victor-studio/monitor 0.1.0

package/dist/index.cjs

@@ -0,0 +1,163 @@
+'use strict';
+
+// src/core/transport.ts
+async function sendBatch(config, events) {
+  if (events.length === 0) return true;
+  try {
+    const response = await fetch(config.endpoint, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        apiKey: config.apiKey,
+        events
+      }),
+      // Usar keepalive pra garantir envio mesmo quando a página fecha
+      keepalive: true
+    });
+    return response.ok;
+  } catch {
+    return false;
+  }
+}
+
+// src/core/collector.ts
+var DEFAULT_FLUSH_INTERVAL = 3e4;
+var MAX_BUFFER_SIZE = 50;
+var Collector = class {
+  buffer = [];
+  timer = null;
+  config;
+  flushInterval;
+  constructor(config, flushInterval = DEFAULT_FLUSH_INTERVAL) {
+    this.config = config;
+    this.flushInterval = flushInterval;
+  }
+  start() {
+    if (this.timer) return;
+    this.timer = setInterval(() => {
+      this.flush();
+    }, this.flushInterval);
+    if (typeof window !== "undefined") {
+      window.addEventListener("visibilitychange", () => {
+        if (document.visibilityState === "hidden") {
+          this.flush();
+        }
+      });
+    }
+  }
+  stop() {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    this.flush();
+  }
+  push(event) {
+    this.buffer.push({
+      ...event,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    });
+    if (this.buffer.length >= MAX_BUFFER_SIZE) {
+      this.flush();
+    }
+  }
+  flush() {
+    if (this.buffer.length === 0) return;
+    const events = [...this.buffer];
+    this.buffer = [];
+    sendBatch(this.config, events).catch(() => {
+    });
+  }
+};
+
+// src/core/client.ts
+var MonitorClient = class {
+  config;
+  collector;
+  heartbeatTimer = null;
+  active = false;
+  constructor(config) {
+    this.config = config;
+    this.collector = new Collector(
+      { endpoint: config.endpoint, apiKey: config.apiKey },
+      config.flushInterval
+    );
+  }
+  /** Inicia o monitoring (heartbeat + collector) */
+  start() {
+    if (this.config.disableInDev !== false && this.isDev()) return;
+    if (this.active) return;
+    this.active = true;
+    this.collector.start();
+    this.startHeartbeat();
+  }
+  /** Para o monitoring */
+  stop() {
+    this.active = false;
+    this.collector.stop();
+    if (this.heartbeatTimer) {
+      clearInterval(this.heartbeatTimer);
+      this.heartbeatTimer = null;
+    }
+  }
+  /** Registra um evento de request HTTP (usado pelo middleware) */
+  trackRequest(data) {
+    if (!this.active) return;
+    this.collector.push({ type: "request", data });
+  }
+  /** Registra um Web Vital (usado pelo MonitorScript) */
+  trackVital(data) {
+    if (!this.active) return;
+    this.collector.push({ type: "vital", data });
+  }
+  startHeartbeat() {
+    const interval = this.config.heartbeatInterval ?? 6e4;
+    this.sendHeartbeat();
+    this.heartbeatTimer = setInterval(() => {
+      this.sendHeartbeat();
+    }, interval);
+  }
+  async sendHeartbeat() {
+    const start = performance.now();
+    try {
+      const response = await fetch(this.config.endpoint, {
+        method: "HEAD",
+        cache: "no-store"
+      });
+      const latencyMs = Math.round(performance.now() - start);
+      this.collector.push({
+        type: "heartbeat",
+        data: {
+          status: response.ok ? "online" : "offline",
+          latencyMs
+        }
+      });
+    } catch {
+      this.collector.push({
+        type: "heartbeat",
+        data: {
+          status: "online",
+          // O app está rodando, mesmo que o endpoint falhe
+          latencyMs: Math.round(performance.now() - start)
+        }
+      });
+    }
+  }
+  isDev() {
+    if (typeof process !== "undefined" && process.env?.NODE_ENV === "development") return true;
+    if (typeof window !== "undefined" && window.location?.hostname === "localhost") return true;
+    return false;
+  }
+};
+
+// src/index.ts
+function createMonitor(config) {
+  const client = new MonitorClient(config);
+  client.start();
+  return client;
+}
+
+exports.MonitorClient = MonitorClient;
+exports.createMonitor = createMonitor;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/transport.ts","../src/core/collector.ts","../src/core/client.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["// Transport — envia batch de eventos pro backend Nuvio\n\nexport interface MonitorEvent {\n  type: 'heartbeat' | 'request' | 'vital'\n  data: Record<string, unknown>\n  timestamp: string\n}\n\nexport interface TransportConfig {\n  endpoint: string\n  apiKey: string\n}\n\nexport async function sendBatch(\n  config: TransportConfig,\n  events: MonitorEvent[],\n): Promise<boolean> {\n  if (events.length === 0) return true\n\n  try {\n    const response = await fetch(config.endpoint, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({\n        apiKey: config.apiKey,\n        events,\n      }),\n      // Usar keepalive pra garantir envio mesmo quando a página fecha\n      keepalive: true,\n    })\n\n    return response.ok\n  } catch {\n    // Falha silenciosa — monitoring não pode quebrar o app do cliente\n    return false\n  }\n}\n","// Collector — acumula eventos em buffer e envia em batch\n\nimport { sendBatch, type MonitorEvent, type TransportConfig } from './transport'\n\nconst DEFAULT_FLUSH_INTERVAL = 30_000 // 30 segundos\nconst MAX_BUFFER_SIZE = 50\n\nexport class Collector {\n  private buffer: MonitorEvent[] = []\n  private timer: ReturnType<typeof setInterval> | null = null\n  private config: TransportConfig\n  private flushInterval: number\n\n  constructor(config: TransportConfig, flushInterval = DEFAULT_FLUSH_INTERVAL) {\n    this.config = config\n    this.flushInterval = flushInterval\n  }\n\n  start() {\n    if (this.timer) return\n\n    this.timer = setInterval(() => {\n      this.flush()\n    }, this.flushInterval)\n\n    // Flush quando a página for fechada (browser)\n    if (typeof window !== 'undefined') {\n      window.addEventListener('visibilitychange', () => {\n        if (document.visibilityState === 'hidden') {\n          this.flush()\n        }\n      })\n    }\n  }\n\n  stop() {\n    if (this.timer) {\n      clearInterval(this.timer)\n      this.timer = null\n    }\n    // Flush final\n    this.flush()\n  }\n\n  push(event: Omit<MonitorEvent, 'timestamp'>) {\n    this.buffer.push({\n      ...event,\n      timestamp: new Date().toISOString(),\n    })\n\n    // Se buffer cheio, flush imediato\n    if (this.buffer.length >= MAX_BUFFER_SIZE) {\n      this.flush()\n    }\n  }\n\n  private flush() {\n    if (this.buffer.length === 0) return\n\n    const events = [...this.buffer]\n    this.buffer = []\n\n    // Fire-and-forget — não bloqueia o app\n    sendBatch(this.config, events).catch(() => {\n      // Silencioso — eventos perdidos são aceitáveis\n    })\n  }\n}\n","// MonitorClient — instância principal do SDK\n\nimport { Collector } from './collector'\n\nexport interface MonitorConfig {\n  /** ID do projeto no Nuvio */\n  projectId: string\n  /** API key gerada no Nuvio */\n  apiKey: string\n  /** URL do endpoint de ingest (ex: https://app.nuvio.com/api/monitor/ingest) */\n  endpoint: string\n  /** Intervalo do heartbeat em ms (default: 60000) */\n  heartbeatInterval?: number\n  /** Intervalo do flush do buffer em ms (default: 30000) */\n  flushInterval?: number\n  /** Desabilitar em desenvolvimento (default: true) */\n  disableInDev?: boolean\n}\n\nexport class MonitorClient {\n  readonly config: MonitorConfig\n  readonly collector: Collector\n  private heartbeatTimer: ReturnType<typeof setInterval> | null = null\n  private active = false\n\n  constructor(config: MonitorConfig) {\n    this.config = config\n    this.collector = new Collector(\n      { endpoint: config.endpoint, apiKey: config.apiKey },\n      config.flushInterval,\n    )\n  }\n\n  /** Inicia o monitoring (heartbeat + collector) */\n  start() {\n    // Não roda em dev por padrão\n    if (this.config.disableInDev !== false && this.isDev()) return\n    if (this.active) return\n\n    this.active = true\n    this.collector.start()\n    this.startHeartbeat()\n  }\n\n  /** Para o monitoring */\n  stop() {\n    this.active = false\n    this.collector.stop()\n\n    if (this.heartbeatTimer) {\n      clearInterval(this.heartbeatTimer)\n      this.heartbeatTimer = null\n    }\n  }\n\n  /** Registra um evento de request HTTP (usado pelo middleware) */\n  trackRequest(data: {\n    method: string\n    route: string\n    statusCode: number\n    responseTimeMs: number\n    userAgent?: string\n    region?: string\n  }) {\n    if (!this.active) return\n    this.collector.push({ type: 'request', data })\n  }\n\n  /** Registra um Web Vital (usado pelo MonitorScript) */\n  trackVital(data: {\n    name: 'LCP' | 'INP' | 'CLS' | 'FCP' | 'TTFB'\n    value: number\n    rating: 'good' | 'needs-improvement' | 'poor'\n    page?: string\n    deviceType?: string\n    browser?: string\n  }) {\n    if (!this.active) return\n    this.collector.push({ type: 'vital', data })\n  }\n\n  private startHeartbeat() {\n    const interval = this.config.heartbeatInterval ?? 60_000\n\n    // Primeiro heartbeat imediato\n    this.sendHeartbeat()\n\n    this.heartbeatTimer = setInterval(() => {\n      this.sendHeartbeat()\n    }, interval)\n  }\n\n  private async sendHeartbeat() {\n    const start = performance.now()\n\n    try {\n      // Ping pro endpoint pra medir latência\n      const response = await fetch(this.config.endpoint, {\n        method: 'HEAD',\n        cache: 'no-store',\n      })\n\n      const latencyMs = Math.round(performance.now() - start)\n\n      this.collector.push({\n        type: 'heartbeat',\n        data: {\n          status: response.ok ? 'online' : 'offline',\n          latencyMs,\n        },\n      })\n    } catch {\n      this.collector.push({\n        type: 'heartbeat',\n        data: {\n          status: 'online', // O app está rodando, mesmo que o endpoint falhe\n          latencyMs: Math.round(performance.now() - start),\n        },\n      })\n    }\n  }\n\n  private isDev(): boolean {\n    if (typeof process !== 'undefined' && process.env?.NODE_ENV === 'development') return true\n    if (typeof window !== 'undefined' && window.location?.hostname === 'localhost') return true\n    return false\n  }\n}\n","// @victor-studio/monitor — SDK de monitoramento\n\nimport { MonitorClient, type MonitorConfig } from './core/client'\n\nexport { MonitorClient, type MonitorConfig } from './core/client'\n\n/**\n * Cria e inicia uma instância do monitor.\n *\n * @example\n * ```ts\n * import { createMonitor } from '@victor-studio/monitor'\n *\n * export const monitor = createMonitor({\n *   projectId: 'uuid-do-projeto',\n *   apiKey: 'nuvio_mon_xxxxxxxx',\n *   endpoint: 'https://app.nuvio.com/api/monitor/ingest',\n * })\n * ```\n */\nexport function createMonitor(config: MonitorConfig): MonitorClient {\n  const client = new MonitorClient(config)\n  client.start()\n  return client\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,86 @@
+interface MonitorEvent {
+    type: 'heartbeat' | 'request' | 'vital';
+    data: Record<string, unknown>;
+    timestamp: string;
+}
+interface TransportConfig {
+    endpoint: string;
+    apiKey: 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 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) */
+    endpoint: string;
+    /** Intervalo do heartbeat em ms (default: 60000) */
+    heartbeatInterval?: number;
+    /** Intervalo do flush do buffer em ms (default: 30000) */
+    flushInterval?: number;
+    /** Desabilitar em desenvolvimento (default: true) */
+    disableInDev?: boolean;
+}
+declare class MonitorClient {
+    readonly config: MonitorConfig;
+    readonly collector: Collector;
+    private heartbeatTimer;
+    private active;
+    constructor(config: MonitorConfig);
+    /** Inicia o monitoring (heartbeat + collector) */
+    start(): void;
+    /** Para o monitoring */
+    stop(): void;
+    /** Registra um evento de request HTTP (usado pelo middleware) */
+    trackRequest(data: {
+        method: string;
+        route: string;
+        statusCode: number;
+        responseTimeMs: number;
+        userAgent?: string;
+        region?: string;
+    }): 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;
+    private startHeartbeat;
+    private sendHeartbeat;
+    private isDev;
+}
+
+/**
+ * Cria e inicia uma instância do monitor.
+ *
+ * @example
+ * ```ts
+ * import { createMonitor } from '@victor-studio/monitor'
+ *
+ * export const monitor = createMonitor({
+ *   projectId: 'uuid-do-projeto',
+ *   apiKey: 'nuvio_mon_xxxxxxxx',
+ *   endpoint: 'https://app.nuvio.com/api/monitor/ingest',
+ * })
+ * ```
+ */
+declare function createMonitor(config: MonitorConfig): MonitorClient;
+
+export { MonitorClient, type MonitorConfig, createMonitor };

package/dist/index.d.ts

@@ -0,0 +1,86 @@
+interface MonitorEvent {
+    type: 'heartbeat' | 'request' | 'vital';
+    data: Record<string, unknown>;
+    timestamp: string;
+}
+interface TransportConfig {
+    endpoint: string;
+    apiKey: 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 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) */
+    endpoint: string;
+    /** Intervalo do heartbeat em ms (default: 60000) */
+    heartbeatInterval?: number;
+    /** Intervalo do flush do buffer em ms (default: 30000) */
+    flushInterval?: number;
+    /** Desabilitar em desenvolvimento (default: true) */
+    disableInDev?: boolean;
+}
+declare class MonitorClient {
+    readonly config: MonitorConfig;
+    readonly collector: Collector;
+    private heartbeatTimer;
+    private active;
+    constructor(config: MonitorConfig);
+    /** Inicia o monitoring (heartbeat + collector) */
+    start(): void;
+    /** Para o monitoring */
+    stop(): void;
+    /** Registra um evento de request HTTP (usado pelo middleware) */
+    trackRequest(data: {
+        method: string;
+        route: string;
+        statusCode: number;
+        responseTimeMs: number;
+        userAgent?: string;
+        region?: string;
+    }): 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;
+    private startHeartbeat;
+    private sendHeartbeat;
+    private isDev;
+}
+
+/**
+ * Cria e inicia uma instância do monitor.
+ *
+ * @example
+ * ```ts
+ * import { createMonitor } from '@victor-studio/monitor'
+ *
+ * export const monitor = createMonitor({
+ *   projectId: 'uuid-do-projeto',
+ *   apiKey: 'nuvio_mon_xxxxxxxx',
+ *   endpoint: 'https://app.nuvio.com/api/monitor/ingest',
+ * })
+ * ```
+ */
+declare function createMonitor(config: MonitorConfig): MonitorClient;
+
+export { MonitorClient, type MonitorConfig, createMonitor };

package/dist/index.js

@@ -0,0 +1,160 @@
+// src/core/transport.ts
+async function sendBatch(config, events) {
+  if (events.length === 0) return true;
+  try {
+    const response = await fetch(config.endpoint, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        apiKey: config.apiKey,
+        events
+      }),
+      // Usar keepalive pra garantir envio mesmo quando a página fecha
+      keepalive: true
+    });
+    return response.ok;
+  } catch {
+    return false;
+  }
+}
+
+// src/core/collector.ts
+var DEFAULT_FLUSH_INTERVAL = 3e4;
+var MAX_BUFFER_SIZE = 50;
+var Collector = class {
+  buffer = [];
+  timer = null;
+  config;
+  flushInterval;
+  constructor(config, flushInterval = DEFAULT_FLUSH_INTERVAL) {
+    this.config = config;
+    this.flushInterval = flushInterval;
+  }
+  start() {
+    if (this.timer) return;
+    this.timer = setInterval(() => {
+      this.flush();
+    }, this.flushInterval);
+    if (typeof window !== "undefined") {
+      window.addEventListener("visibilitychange", () => {
+        if (document.visibilityState === "hidden") {
+          this.flush();
+        }
+      });
+    }
+  }
+  stop() {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    this.flush();
+  }
+  push(event) {
+    this.buffer.push({
+      ...event,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    });
+    if (this.buffer.length >= MAX_BUFFER_SIZE) {
+      this.flush();
+    }
+  }
+  flush() {
+    if (this.buffer.length === 0) return;
+    const events = [...this.buffer];
+    this.buffer = [];
+    sendBatch(this.config, events).catch(() => {
+    });
+  }
+};
+
+// src/core/client.ts
+var MonitorClient = class {
+  config;
+  collector;
+  heartbeatTimer = null;
+  active = false;
+  constructor(config) {
+    this.config = config;
+    this.collector = new Collector(
+      { endpoint: config.endpoint, apiKey: config.apiKey },
+      config.flushInterval
+    );
+  }
+  /** Inicia o monitoring (heartbeat + collector) */
+  start() {
+    if (this.config.disableInDev !== false && this.isDev()) return;
+    if (this.active) return;
+    this.active = true;
+    this.collector.start();
+    this.startHeartbeat();
+  }
+  /** Para o monitoring */
+  stop() {
+    this.active = false;
+    this.collector.stop();
+    if (this.heartbeatTimer) {
+      clearInterval(this.heartbeatTimer);
+      this.heartbeatTimer = null;
+    }
+  }
+  /** Registra um evento de request HTTP (usado pelo middleware) */
+  trackRequest(data) {
+    if (!this.active) return;
+    this.collector.push({ type: "request", data });
+  }
+  /** Registra um Web Vital (usado pelo MonitorScript) */
+  trackVital(data) {
+    if (!this.active) return;
+    this.collector.push({ type: "vital", data });
+  }
+  startHeartbeat() {
+    const interval = this.config.heartbeatInterval ?? 6e4;
+    this.sendHeartbeat();
+    this.heartbeatTimer = setInterval(() => {
+      this.sendHeartbeat();
+    }, interval);
+  }
+  async sendHeartbeat() {
+    const start = performance.now();
+    try {
+      const response = await fetch(this.config.endpoint, {
+        method: "HEAD",
+        cache: "no-store"
+      });
+      const latencyMs = Math.round(performance.now() - start);
+      this.collector.push({
+        type: "heartbeat",
+        data: {
+          status: response.ok ? "online" : "offline",
+          latencyMs
+        }
+      });
+    } catch {
+      this.collector.push({
+        type: "heartbeat",
+        data: {
+          status: "online",
+          // O app está rodando, mesmo que o endpoint falhe
+          latencyMs: Math.round(performance.now() - start)
+        }
+      });
+    }
+  }
+  isDev() {
+    if (typeof process !== "undefined" && process.env?.NODE_ENV === "development") return true;
+    if (typeof window !== "undefined" && window.location?.hostname === "localhost") return true;
+    return false;
+  }
+};
+
+// src/index.ts
+function createMonitor(config) {
+  const client = new MonitorClient(config);
+  client.start();
+  return client;
+}
+
+export { MonitorClient, createMonitor };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/transport.ts","../src/core/collector.ts","../src/core/client.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// Transport — envia batch de eventos pro backend Nuvio\n\nexport interface MonitorEvent {\n  type: 'heartbeat' | 'request' | 'vital'\n  data: Record<string, unknown>\n  timestamp: string\n}\n\nexport interface TransportConfig {\n  endpoint: string\n  apiKey: string\n}\n\nexport async function sendBatch(\n  config: TransportConfig,\n  events: MonitorEvent[],\n): Promise<boolean> {\n  if (events.length === 0) return true\n\n  try {\n    const response = await fetch(config.endpoint, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({\n        apiKey: config.apiKey,\n        events,\n      }),\n      // Usar keepalive pra garantir envio mesmo quando a página fecha\n      keepalive: true,\n    })\n\n    return response.ok\n  } catch {\n    // Falha silenciosa — monitoring não pode quebrar o app do cliente\n    return false\n  }\n}\n","// Collector — acumula eventos em buffer e envia em batch\n\nimport { sendBatch, type MonitorEvent, type TransportConfig } from './transport'\n\nconst DEFAULT_FLUSH_INTERVAL = 30_000 // 30 segundos\nconst MAX_BUFFER_SIZE = 50\n\nexport class Collector {\n  private buffer: MonitorEvent[] = []\n  private timer: ReturnType<typeof setInterval> | null = null\n  private config: TransportConfig\n  private flushInterval: number\n\n  constructor(config: TransportConfig, flushInterval = DEFAULT_FLUSH_INTERVAL) {\n    this.config = config\n    this.flushInterval = flushInterval\n  }\n\n  start() {\n    if (this.timer) return\n\n    this.timer = setInterval(() => {\n      this.flush()\n    }, this.flushInterval)\n\n    // Flush quando a página for fechada (browser)\n    if (typeof window !== 'undefined') {\n      window.addEventListener('visibilitychange', () => {\n        if (document.visibilityState === 'hidden') {\n          this.flush()\n        }\n      })\n    }\n  }\n\n  stop() {\n    if (this.timer) {\n      clearInterval(this.timer)\n      this.timer = null\n    }\n    // Flush final\n    this.flush()\n  }\n\n  push(event: Omit<MonitorEvent, 'timestamp'>) {\n    this.buffer.push({\n      ...event,\n      timestamp: new Date().toISOString(),\n    })\n\n    // Se buffer cheio, flush imediato\n    if (this.buffer.length >= MAX_BUFFER_SIZE) {\n      this.flush()\n    }\n  }\n\n  private flush() {\n    if (this.buffer.length === 0) return\n\n    const events = [...this.buffer]\n    this.buffer = []\n\n    // Fire-and-forget — não bloqueia o app\n    sendBatch(this.config, events).catch(() => {\n      // Silencioso — eventos perdidos são aceitáveis\n    })\n  }\n}\n","// MonitorClient — instância principal do SDK\n\nimport { Collector } from './collector'\n\nexport interface MonitorConfig {\n  /** ID do projeto no Nuvio */\n  projectId: string\n  /** API key gerada no Nuvio */\n  apiKey: string\n  /** URL do endpoint de ingest (ex: https://app.nuvio.com/api/monitor/ingest) */\n  endpoint: string\n  /** Intervalo do heartbeat em ms (default: 60000) */\n  heartbeatInterval?: number\n  /** Intervalo do flush do buffer em ms (default: 30000) */\n  flushInterval?: number\n  /** Desabilitar em desenvolvimento (default: true) */\n  disableInDev?: boolean\n}\n\nexport class MonitorClient {\n  readonly config: MonitorConfig\n  readonly collector: Collector\n  private heartbeatTimer: ReturnType<typeof setInterval> | null = null\n  private active = false\n\n  constructor(config: MonitorConfig) {\n    this.config = config\n    this.collector = new Collector(\n      { endpoint: config.endpoint, apiKey: config.apiKey },\n      config.flushInterval,\n    )\n  }\n\n  /** Inicia o monitoring (heartbeat + collector) */\n  start() {\n    // Não roda em dev por padrão\n    if (this.config.disableInDev !== false && this.isDev()) return\n    if (this.active) return\n\n    this.active = true\n    this.collector.start()\n    this.startHeartbeat()\n  }\n\n  /** Para o monitoring */\n  stop() {\n    this.active = false\n    this.collector.stop()\n\n    if (this.heartbeatTimer) {\n      clearInterval(this.heartbeatTimer)\n      this.heartbeatTimer = null\n    }\n  }\n\n  /** Registra um evento de request HTTP (usado pelo middleware) */\n  trackRequest(data: {\n    method: string\n    route: string\n    statusCode: number\n    responseTimeMs: number\n    userAgent?: string\n    region?: string\n  }) {\n    if (!this.active) return\n    this.collector.push({ type: 'request', data })\n  }\n\n  /** Registra um Web Vital (usado pelo MonitorScript) */\n  trackVital(data: {\n    name: 'LCP' | 'INP' | 'CLS' | 'FCP' | 'TTFB'\n    value: number\n    rating: 'good' | 'needs-improvement' | 'poor'\n    page?: string\n    deviceType?: string\n    browser?: string\n  }) {\n    if (!this.active) return\n    this.collector.push({ type: 'vital', data })\n  }\n\n  private startHeartbeat() {\n    const interval = this.config.heartbeatInterval ?? 60_000\n\n    // Primeiro heartbeat imediato\n    this.sendHeartbeat()\n\n    this.heartbeatTimer = setInterval(() => {\n      this.sendHeartbeat()\n    }, interval)\n  }\n\n  private async sendHeartbeat() {\n    const start = performance.now()\n\n    try {\n      // Ping pro endpoint pra medir latência\n      const response = await fetch(this.config.endpoint, {\n        method: 'HEAD',\n        cache: 'no-store',\n      })\n\n      const latencyMs = Math.round(performance.now() - start)\n\n      this.collector.push({\n        type: 'heartbeat',\n        data: {\n          status: response.ok ? 'online' : 'offline',\n          latencyMs,\n        },\n      })\n    } catch {\n      this.collector.push({\n        type: 'heartbeat',\n        data: {\n          status: 'online', // O app está rodando, mesmo que o endpoint falhe\n          latencyMs: Math.round(performance.now() - start),\n        },\n      })\n    }\n  }\n\n  private isDev(): boolean {\n    if (typeof process !== 'undefined' && process.env?.NODE_ENV === 'development') return true\n    if (typeof window !== 'undefined' && window.location?.hostname === 'localhost') return true\n    return false\n  }\n}\n","// @victor-studio/monitor — SDK de monitoramento\n\nimport { MonitorClient, type MonitorConfig } from './core/client'\n\nexport { MonitorClient, type MonitorConfig } from './core/client'\n\n/**\n * Cria e inicia uma instância do monitor.\n *\n * @example\n * ```ts\n * import { createMonitor } from '@victor-studio/monitor'\n *\n * export const monitor = createMonitor({\n *   projectId: 'uuid-do-projeto',\n *   apiKey: 'nuvio_mon_xxxxxxxx',\n *   endpoint: 'https://app.nuvio.com/api/monitor/ingest',\n * })\n * ```\n */\nexport function createMonitor(config: MonitorConfig): MonitorClient {\n  const client = new MonitorClient(config)\n  client.start()\n  return client\n}\n"]}

package/dist/next/index.cjs

@@ -0,0 +1,34 @@
+'use strict';
+
+// src/next/middleware.ts
+function withMonitor(monitor, middleware) {
+  return async (request) => {
+    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;
+    }
+    monitor.trackRequest({
+      method,
+      route,
+      statusCode,
+      responseTimeMs,
+      userAgent,
+      region
+    });
+    return response;
+  };
+}
+
+exports.withMonitor = withMonitor;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/next/index.cjs.map

@@ -0,0 +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.cjs","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"]}

package/dist/next/index.d.cts

@@ -0,0 +1,92 @@
+import { NextRequest, NextResponse } from 'next/server';
+
+interface MonitorEvent {
+    type: 'heartbeat' | 'request' | 'vital';
+    data: Record<string, unknown>;
+    timestamp: string;
+}
+interface TransportConfig {
+    endpoint: string;
+    apiKey: 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 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) */
+    endpoint: string;
+    /** Intervalo do heartbeat em ms (default: 60000) */
+    heartbeatInterval?: number;
+    /** Intervalo do flush do buffer em ms (default: 30000) */
+    flushInterval?: number;
+    /** Desabilitar em desenvolvimento (default: true) */
+    disableInDev?: boolean;
+}
+declare class MonitorClient {
+    readonly config: MonitorConfig;
+    readonly collector: Collector;
+    private heartbeatTimer;
+    private active;
+    constructor(config: MonitorConfig);
+    /** Inicia o monitoring (heartbeat + collector) */
+    start(): void;
+    /** Para o monitoring */
+    stop(): void;
+    /** Registra um evento de request HTTP (usado pelo middleware) */
+    trackRequest(data: {
+        method: string;
+        route: string;
+        statusCode: number;
+        responseTimeMs: number;
+        userAgent?: string;
+        region?: string;
+    }): 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;
+    private startHeartbeat;
+    private sendHeartbeat;
+    private isDev;
+}
+
+type NextMiddleware = (request: NextRequest) => NextResponse | Response | Promise<NextResponse | Response> | undefined | Promise<undefined>;
+/**
+ * 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)
+ * ```
+ */
+declare function withMonitor(monitor: MonitorClient, middleware?: NextMiddleware): (request: NextRequest) => Promise<NextResponse | Response | undefined>;
+
+export { withMonitor };

package/dist/next/index.d.ts

@@ -0,0 +1,92 @@
+import { NextRequest, NextResponse } from 'next/server';
+
+interface MonitorEvent {
+    type: 'heartbeat' | 'request' | 'vital';
+    data: Record<string, unknown>;
+    timestamp: string;
+}
+interface TransportConfig {
+    endpoint: string;
+    apiKey: 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 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) */
+    endpoint: string;
+    /** Intervalo do heartbeat em ms (default: 60000) */
+    heartbeatInterval?: number;
+    /** Intervalo do flush do buffer em ms (default: 30000) */
+    flushInterval?: number;
+    /** Desabilitar em desenvolvimento (default: true) */
+    disableInDev?: boolean;
+}
+declare class MonitorClient {
+    readonly config: MonitorConfig;
+    readonly collector: Collector;
+    private heartbeatTimer;
+    private active;
+    constructor(config: MonitorConfig);
+    /** Inicia o monitoring (heartbeat + collector) */
+    start(): void;
+    /** Para o monitoring */
+    stop(): void;
+    /** Registra um evento de request HTTP (usado pelo middleware) */
+    trackRequest(data: {
+        method: string;
+        route: string;
+        statusCode: number;
+        responseTimeMs: number;
+        userAgent?: string;
+        region?: string;
+    }): 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;
+    private startHeartbeat;
+    private sendHeartbeat;
+    private isDev;
+}
+
+type NextMiddleware = (request: NextRequest) => NextResponse | Response | Promise<NextResponse | Response> | undefined | Promise<undefined>;
+/**
+ * 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)
+ * ```
+ */
+declare function withMonitor(monitor: MonitorClient, middleware?: NextMiddleware): (request: NextRequest) => Promise<NextResponse | Response | undefined>;
+
+export { withMonitor };

package/dist/next/index.js

@@ -0,0 +1,32 @@
+// src/next/middleware.ts
+function withMonitor(monitor, middleware) {
+  return async (request) => {
+    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;
+    }
+    monitor.trackRequest({
+      method,
+      route,
+      statusCode,
+      responseTimeMs,
+      userAgent,
+      region
+    });
+    return response;
+  };
+}
+
+export { withMonitor };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/next/index.js.map

@@ -0,0 +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"]}

package/dist/react/index.cjs

@@ -0,0 +1,43 @@
+'use strict';
+
+var react = require('react');
+
+// src/react/monitor-script.tsx
+function detectDeviceType() {
+  if (typeof window === "undefined") return "unknown";
+  const ua = navigator.userAgent;
+  if (/Mobile|Android/i.test(ua)) return "mobile";
+  if (/Tablet|iPad/i.test(ua)) return "tablet";
+  return "desktop";
+}
+function detectBrowser() {
+  if (typeof window === "undefined") return "unknown";
+  const ua = navigator.userAgent;
+  if (ua.includes("Firefox")) return "Firefox";
+  if (ua.includes("Edg/")) return "Edge";
+  if (ua.includes("Chrome")) return "Chrome";
+  if (ua.includes("Safari")) return "Safari";
+  return "other";
+}
+function MonitorScript({ monitor }) {
+  react.useEffect(() => {
+    import('web-vitals').then(({ onLCP, onINP, onCLS, onFCP, onTTFB }) => {
+      const page = typeof window !== "undefined" ? window.location.pathname : void 0;
+      const deviceType = detectDeviceType();
+      const browser = detectBrowser();
+      const report = (name, value, rating) => {
+        monitor.trackVital({ name, value, rating, page, deviceType, browser });
+      };
+      onLCP((metric) => report("LCP", metric.value, metric.rating));
+      onINP((metric) => report("INP", metric.value, metric.rating));
+      onCLS((metric) => report("CLS", metric.value, metric.rating));
+      onFCP((metric) => report("FCP", metric.value, metric.rating));
+      onTTFB((metric) => report("TTFB", metric.value, metric.rating));
+    });
+  }, [monitor]);
+  return null;
+}
+
+exports.MonitorScript = MonitorScript;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/react/index.cjs.map

@@ -0,0 +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"]}

package/dist/react/index.d.cts

@@ -0,0 +1,97 @@
+interface MonitorEvent {
+    type: 'heartbeat' | 'request' | 'vital';
+    data: Record<string, unknown>;
+    timestamp: string;
+}
+interface TransportConfig {
+    endpoint: string;
+    apiKey: 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 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) */
+    endpoint: string;
+    /** Intervalo do heartbeat em ms (default: 60000) */
+    heartbeatInterval?: number;
+    /** Intervalo do flush do buffer em ms (default: 30000) */
+    flushInterval?: number;
+    /** Desabilitar em desenvolvimento (default: true) */
+    disableInDev?: boolean;
+}
+declare class MonitorClient {
+    readonly config: MonitorConfig;
+    readonly collector: Collector;
+    private heartbeatTimer;
+    private active;
+    constructor(config: MonitorConfig);
+    /** Inicia o monitoring (heartbeat + collector) */
+    start(): void;
+    /** Para o monitoring */
+    stop(): void;
+    /** Registra um evento de request HTTP (usado pelo middleware) */
+    trackRequest(data: {
+        method: string;
+        route: string;
+        statusCode: number;
+        responseTimeMs: number;
+        userAgent?: string;
+        region?: string;
+    }): 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;
+    private startHeartbeat;
+    private sendHeartbeat;
+    private isDev;
+}
+
+interface MonitorScriptProps {
+    monitor: MonitorClient;
+}
+/**
+ * Componente React que coleta Web Vitals automaticamente.
+ * Coloque no root layout da aplicação.
+ *
+ * @example
+ * ```tsx
+ * // app/layout.tsx
+ * import { MonitorScript } from '@victor-studio/monitor/react'
+ * import { monitor } from '@/lib/monitor'
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         {children}
+ *         <MonitorScript monitor={monitor} />
+ *       </body>
+ *     </html>
+ *   )
+ * }
+ * ```
+ */
+declare function MonitorScript({ monitor }: MonitorScriptProps): null;
+
+export { MonitorScript };

package/dist/react/index.d.ts

@@ -0,0 +1,97 @@
+interface MonitorEvent {
+    type: 'heartbeat' | 'request' | 'vital';
+    data: Record<string, unknown>;
+    timestamp: string;
+}
+interface TransportConfig {
+    endpoint: string;
+    apiKey: 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 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) */
+    endpoint: string;
+    /** Intervalo do heartbeat em ms (default: 60000) */
+    heartbeatInterval?: number;
+    /** Intervalo do flush do buffer em ms (default: 30000) */
+    flushInterval?: number;
+    /** Desabilitar em desenvolvimento (default: true) */
+    disableInDev?: boolean;
+}
+declare class MonitorClient {
+    readonly config: MonitorConfig;
+    readonly collector: Collector;
+    private heartbeatTimer;
+    private active;
+    constructor(config: MonitorConfig);
+    /** Inicia o monitoring (heartbeat + collector) */
+    start(): void;
+    /** Para o monitoring */
+    stop(): void;
+    /** Registra um evento de request HTTP (usado pelo middleware) */
+    trackRequest(data: {
+        method: string;
+        route: string;
+        statusCode: number;
+        responseTimeMs: number;
+        userAgent?: string;
+        region?: string;
+    }): 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;
+    private startHeartbeat;
+    private sendHeartbeat;
+    private isDev;
+}
+
+interface MonitorScriptProps {
+    monitor: MonitorClient;
+}
+/**
+ * Componente React que coleta Web Vitals automaticamente.
+ * Coloque no root layout da aplicação.
+ *
+ * @example
+ * ```tsx
+ * // app/layout.tsx
+ * import { MonitorScript } from '@victor-studio/monitor/react'
+ * import { monitor } from '@/lib/monitor'
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         {children}
+ *         <MonitorScript monitor={monitor} />
+ *       </body>
+ *     </html>
+ *   )
+ * }
+ * ```
+ */
+declare function MonitorScript({ monitor }: MonitorScriptProps): null;
+
+export { MonitorScript };

package/dist/react/index.js

@@ -0,0 +1,41 @@
+import { useEffect } from 'react';
+
+// src/react/monitor-script.tsx
+function detectDeviceType() {
+  if (typeof window === "undefined") return "unknown";
+  const ua = navigator.userAgent;
+  if (/Mobile|Android/i.test(ua)) return "mobile";
+  if (/Tablet|iPad/i.test(ua)) return "tablet";
+  return "desktop";
+}
+function detectBrowser() {
+  if (typeof window === "undefined") return "unknown";
+  const ua = navigator.userAgent;
+  if (ua.includes("Firefox")) return "Firefox";
+  if (ua.includes("Edg/")) return "Edge";
+  if (ua.includes("Chrome")) return "Chrome";
+  if (ua.includes("Safari")) return "Safari";
+  return "other";
+}
+function MonitorScript({ monitor }) {
+  useEffect(() => {
+    import('web-vitals').then(({ onLCP, onINP, onCLS, onFCP, onTTFB }) => {
+      const page = typeof window !== "undefined" ? window.location.pathname : void 0;
+      const deviceType = detectDeviceType();
+      const browser = detectBrowser();
+      const report = (name, value, rating) => {
+        monitor.trackVital({ name, value, rating, page, deviceType, browser });
+      };
+      onLCP((metric) => report("LCP", metric.value, metric.rating));
+      onINP((metric) => report("INP", metric.value, metric.rating));
+      onCLS((metric) => report("CLS", metric.value, metric.rating));
+      onFCP((metric) => report("FCP", metric.value, metric.rating));
+      onTTFB((metric) => report("TTFB", metric.value, metric.rating));
+    });
+  }, [monitor]);
+  return null;
+}
+
+export { MonitorScript };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +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"]}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@victor-studio/monitor",
+  "version": "0.1.0",
+  "description": "Lightweight monitoring SDK for Nuvio-managed projects",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./next": {
+      "types": "./dist/next/index.d.ts",
+      "import": "./dist/next/index.js",
+      "require": "./dist/next/index.cjs"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js",
+      "require": "./dist/react/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm build"
+  },
+  "peerDependencies": {
+    "next": ">=14",
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "@types/react": "^19.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.0"
+  },
+  "dependencies": {
+    "web-vitals": "^4.2.0"
+  },
+  "keywords": [
+    "monitoring",
+    "sdk",
+    "web-vitals",
+    "uptime",
+    "performance"
+  ],
+  "author": "Victor Studio",
+  "license": "MIT",
+  "packageManager": "pnpm@10.33.0"
+}