@victor-studio/monitor 0.2.0 → 0.5.0

package/dist/adapters/upstash/upstash.d.ts

@@ -0,0 +1,150 @@
+interface HeartbeatData {
+    status: 'online' | 'offline';
+    latencyMs: number;
+}
+interface RequestData {
+    method: string;
+    route: string;
+    statusCode: number;
+    responseTimeMs: number;
+    userAgent?: string;
+    region?: string;
+}
+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 */
+    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;
+    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: RequestData): void;
+    /** Registra um Web Vital (usado pelo MonitorScript) */
+    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;
+}
+
+/**
+ * Instrumenta um comando Redis com timing.
+ *
+ * @example
+ * ```ts
+ * import { monitorRedis } from '@victor-studio/monitor/adapters/upstash'
+ *
+ * const value = await monitorRedis(monitor, 'get', () => redis.get('key'))
+ * await monitorRedis(monitor, 'set', () => redis.set('key', 'value'))
+ * ```
+ */
+declare function monitorRedis<T>(monitor: MonitorClient, command: string, fn: () => Promise<T>, meta?: Record<string, string>): Promise<T>;
+
+export { monitorRedis };

package/dist/adapters/upstash/upstash.js

@@ -0,0 +1,37 @@
+// src/adapters/core.ts
+async function withTiming(monitor, adapter, operation, fn, meta) {
+  const start = performance.now();
+  try {
+    const result = await fn();
+    monitor.trackAdapter({
+      adapter,
+      operation,
+      durationMs: Math.round(performance.now() - start),
+      success: true,
+      meta
+    });
+    return result;
+  } catch (error) {
+    monitor.trackAdapter({
+      adapter,
+      operation,
+      durationMs: Math.round(performance.now() - start),
+      success: false,
+      error: error instanceof Error ? error.message : String(error),
+      meta
+    });
+    throw error;
+  }
+}
+
+// src/adapters/upstash.ts
+function monitorRedis(monitor, command, fn, meta) {
+  return withTiming(monitor, "upstash", command, fn, {
+    command,
+    ...meta
+  });
+}
+
+export { monitorRedis };
+//# sourceMappingURL=upstash.js.map
+//# sourceMappingURL=upstash.js.map

package/dist/adapters/upstash/upstash.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/adapters/core.ts","../../../src/adapters/upstash.ts"],"names":[],"mappings":";AAgBA,eAAsB,UAAA,CACpB,OAAA,EACA,OAAA,EACA,SAAA,EACA,IACA,IAAA,EACY;AACZ,EAAA,MAAM,KAAA,GAAQ,YAAY,GAAA,EAAI;AAE9B,EAAA,IAAI;AACF,IAAA,MAAM,MAAA,GAAS,MAAM,EAAA,EAAG;AAExB,IAAA,OAAA,CAAQ,YAAA,CAAa;AAAA,MACnB,OAAA;AAAA,MACA,SAAA;AAAA,MACA,YAAY,IAAA,CAAK,KAAA,CAAM,WAAA,CAAY,GAAA,KAAQ,KAAK,CAAA;AAAA,MAChD,OAAA,EAAS,IAAA;AAAA,MACT;AAAA,KACqB,CAAA;AAEvB,IAAA,OAAO,MAAA;AAAA,EACT,SAAS,KAAA,EAAO;AACd,IAAA,OAAA,CAAQ,YAAA,CAAa;AAAA,MACnB,OAAA;AAAA,MACA,SAAA;AAAA,MACA,YAAY,IAAA,CAAK,KAAA,CAAM,WAAA,CAAY,GAAA,KAAQ,KAAK,CAAA;AAAA,MAChD,OAAA,EAAS,KAAA;AAAA,MACT,OAAO,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,OAAO,KAAK,CAAA;AAAA,MAC5D;AAAA,KACqB,CAAA;AAEvB,IAAA,MAAM,KAAA;AAAA,EACR;AACF;;;ACjCO,SAAS,YAAA,CACd,OAAA,EACA,OAAA,EACA,EAAA,EACA,IAAA,EACY;AACZ,EAAA,OAAO,UAAA,CAAW,OAAA,EAAS,SAAA,EAAW,OAAA,EAAS,EAAA,EAAI;AAAA,IACjD,OAAA;AAAA,IACA,GAAG;AAAA,GACJ,CAAA;AACH","file":"upstash.js","sourcesContent":["// Adapter core — utilitário genérico de instrumentação\n\nimport type { MonitorClient } from '../core/client'\nimport type { AdapterData } from '../types'\n\n/**\n * Mede a duração de uma operação assíncrona e reporta ao monitor.\n * Utilitário base usado por todos os adapters.\n *\n * @example\n * ```ts\n * const result = await withTiming(monitor, 'neon', 'query', () =>\n *   db.select().from(users),\n * )\n * ```\n */\nexport async function withTiming<T>(\n  monitor: MonitorClient,\n  adapter: string,\n  operation: string,\n  fn: () => Promise<T>,\n  meta?: Record<string, string>,\n): Promise<T> {\n  const start = performance.now()\n\n  try {\n    const result = await fn()\n\n    monitor.trackAdapter({\n      adapter,\n      operation,\n      durationMs: Math.round(performance.now() - start),\n      success: true,\n      meta,\n    } satisfies AdapterData)\n\n    return result\n  } catch (error) {\n    monitor.trackAdapter({\n      adapter,\n      operation,\n      durationMs: Math.round(performance.now() - start),\n      success: false,\n      error: error instanceof Error ? error.message : String(error),\n      meta,\n    } satisfies AdapterData)\n\n    throw error // nunca engolir erros\n  }\n}\n\n/**\n * Versão sync do withTiming para operações síncronas.\n */\nexport function withTimingSync<T>(\n  monitor: MonitorClient,\n  adapter: string,\n  operation: string,\n  fn: () => T,\n  meta?: Record<string, string>,\n): T {\n  const start = performance.now()\n\n  try {\n    const result = fn()\n\n    monitor.trackAdapter({\n      adapter,\n      operation,\n      durationMs: Math.round(performance.now() - start),\n      success: true,\n      meta,\n    } satisfies AdapterData)\n\n    return result\n  } catch (error) {\n    monitor.trackAdapter({\n      adapter,\n      operation,\n      durationMs: Math.round(performance.now() - start),\n      success: false,\n      error: error instanceof Error ? error.message : String(error),\n      meta,\n    } satisfies AdapterData)\n\n    throw error\n  }\n}\n","// Adapter Upstash — instrumentação de comandos Redis\n\nimport type { MonitorClient } from '../core/client'\nimport { withTiming } from './core'\n\n/**\n * Instrumenta um comando Redis com timing.\n *\n * @example\n * ```ts\n * import { monitorRedis } from '@victor-studio/monitor/adapters/upstash'\n *\n * const value = await monitorRedis(monitor, 'get', () => redis.get('key'))\n * await monitorRedis(monitor, 'set', () => redis.set('key', 'value'))\n * ```\n */\nexport function monitorRedis<T>(\n  monitor: MonitorClient,\n  command: string,\n  fn: () => Promise<T>,\n  meta?: Record<string, string>,\n): Promise<T> {\n  return withTiming(monitor, 'upstash', command, fn, {\n    command,\n    ...meta,\n  })\n}\n"]}

package/dist/adapters/vercel/vercel.cjs

@@ -0,0 +1,18 @@
+'use strict';
+
+// src/adapters/vercel.ts
+function getVercelContext() {
+  if (typeof process === "undefined") return {};
+  const env = process.env;
+  return {
+    region: env.VERCEL_REGION,
+    environment: env.VERCEL_ENV,
+    commitHash: env.VERCEL_GIT_COMMIT_SHA,
+    branch: env.VERCEL_GIT_COMMIT_REF,
+    url: env.VERCEL_URL ? `https://${env.VERCEL_URL}` : void 0
+  };
+}
+
+exports.getVercelContext = getVercelContext;
+//# sourceMappingURL=vercel.cjs.map
+//# sourceMappingURL=vercel.cjs.map

package/dist/adapters/vercel/vercel.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/adapters/vercel.ts"],"names":[],"mappings":";;;AAuBO,SAAS,gBAAA,GAAkC;AAChD,EAAA,IAAI,OAAO,OAAA,KAAY,WAAA,EAAa,OAAO,EAAC;AAC5C,EAAA,MAAM,MAAM,OAAA,CAAQ,GAAA;AAEpB,EAAA,OAAO;AAAA,IACL,QAAQ,GAAA,CAAI,aAAA;AAAA,IACZ,aAAa,GAAA,CAAI,UAAA;AAAA,IACjB,YAAY,GAAA,CAAI,qBAAA;AAAA,IAChB,QAAQ,GAAA,CAAI,qBAAA;AAAA,IACZ,KAAK,GAAA,CAAI,UAAA,GAAa,CAAA,QAAA,EAAW,GAAA,CAAI,UAAU,CAAA,CAAA,GAAK;AAAA,GACtD;AACF","file":"vercel.cjs","sourcesContent":["// Adapter Vercel — contexto de deploy e runtime\n\n/** Contexto Vercel extraído das env vars */\nexport interface VercelContext {\n  region?: string\n  environment?: string\n  commitHash?: string\n  branch?: string\n  url?: string\n}\n\n/**\n * Lê contexto de runtime do Vercel via env vars.\n * Útil para enriquecer eventos com metadados de deploy.\n *\n * @example\n * ```ts\n * import { getVercelContext } from '@victor-studio/monitor/adapters/vercel'\n *\n * const ctx = getVercelContext()\n * // { region: 'iad1', environment: 'production', commitHash: 'abc123', ... }\n * ```\n */\nexport function getVercelContext(): VercelContext {\n  if (typeof process === 'undefined') return {}\n  const env = process.env\n\n  return {\n    region: env.VERCEL_REGION,\n    environment: env.VERCEL_ENV,\n    commitHash: env.VERCEL_GIT_COMMIT_SHA,\n    branch: env.VERCEL_GIT_COMMIT_REF,\n    url: env.VERCEL_URL ? `https://${env.VERCEL_URL}` : undefined,\n  }\n}\n"]}

package/dist/adapters/vercel/vercel.d.cts

@@ -0,0 +1,23 @@
+/** Contexto Vercel extraído das env vars */
+interface VercelContext {
+    region?: string;
+    environment?: string;
+    commitHash?: string;
+    branch?: string;
+    url?: string;
+}
+/**
+ * Lê contexto de runtime do Vercel via env vars.
+ * Útil para enriquecer eventos com metadados de deploy.
+ *
+ * @example
+ * ```ts
+ * import { getVercelContext } from '@victor-studio/monitor/adapters/vercel'
+ *
+ * const ctx = getVercelContext()
+ * // { region: 'iad1', environment: 'production', commitHash: 'abc123', ... }
+ * ```
+ */
+declare function getVercelContext(): VercelContext;
+
+export { type VercelContext, getVercelContext };

package/dist/adapters/vercel/vercel.d.ts

@@ -0,0 +1,23 @@
+/** Contexto Vercel extraído das env vars */
+interface VercelContext {
+    region?: string;
+    environment?: string;
+    commitHash?: string;
+    branch?: string;
+    url?: string;
+}
+/**
+ * Lê contexto de runtime do Vercel via env vars.
+ * Útil para enriquecer eventos com metadados de deploy.
+ *
+ * @example
+ * ```ts
+ * import { getVercelContext } from '@victor-studio/monitor/adapters/vercel'
+ *
+ * const ctx = getVercelContext()
+ * // { region: 'iad1', environment: 'production', commitHash: 'abc123', ... }
+ * ```
+ */
+declare function getVercelContext(): VercelContext;
+
+export { type VercelContext, getVercelContext };

package/dist/adapters/vercel/vercel.js

@@ -0,0 +1,16 @@
+// src/adapters/vercel.ts
+function getVercelContext() {
+  if (typeof process === "undefined") return {};
+  const env = process.env;
+  return {
+    region: env.VERCEL_REGION,
+    environment: env.VERCEL_ENV,
+    commitHash: env.VERCEL_GIT_COMMIT_SHA,
+    branch: env.VERCEL_GIT_COMMIT_REF,
+    url: env.VERCEL_URL ? `https://${env.VERCEL_URL}` : void 0
+  };
+}
+
+export { getVercelContext };
+//# sourceMappingURL=vercel.js.map
+//# sourceMappingURL=vercel.js.map

package/dist/adapters/vercel/vercel.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/adapters/vercel.ts"],"names":[],"mappings":";AAuBO,SAAS,gBAAA,GAAkC;AAChD,EAAA,IAAI,OAAO,OAAA,KAAY,WAAA,EAAa,OAAO,EAAC;AAC5C,EAAA,MAAM,MAAM,OAAA,CAAQ,GAAA;AAEpB,EAAA,OAAO;AAAA,IACL,QAAQ,GAAA,CAAI,aAAA;AAAA,IACZ,aAAa,GAAA,CAAI,UAAA;AAAA,IACjB,YAAY,GAAA,CAAI,qBAAA;AAAA,IAChB,QAAQ,GAAA,CAAI,qBAAA;AAAA,IACZ,KAAK,GAAA,CAAI,UAAA,GAAa,CAAA,QAAA,EAAW,GAAA,CAAI,UAAU,CAAA,CAAA,GAAK;AAAA,GACtD;AACF","file":"vercel.js","sourcesContent":["// Adapter Vercel — contexto de deploy e runtime\n\n/** Contexto Vercel extraído das env vars */\nexport interface VercelContext {\n  region?: string\n  environment?: string\n  commitHash?: string\n  branch?: string\n  url?: string\n}\n\n/**\n * Lê contexto de runtime do Vercel via env vars.\n * Útil para enriquecer eventos com metadados de deploy.\n *\n * @example\n * ```ts\n * import { getVercelContext } from '@victor-studio/monitor/adapters/vercel'\n *\n * const ctx = getVercelContext()\n * // { region: 'iad1', environment: 'production', commitHash: 'abc123', ... }\n * ```\n */\nexport function getVercelContext(): VercelContext {\n  if (typeof process === 'undefined') return {}\n  const env = process.env\n\n  return {\n    region: env.VERCEL_REGION,\n    environment: env.VERCEL_ENV,\n    commitHash: env.VERCEL_GIT_COMMIT_SHA,\n    branch: env.VERCEL_GIT_COMMIT_REF,\n    url: env.VERCEL_URL ? `https://${env.VERCEL_URL}` : undefined,\n  }\n}\n"]}

package/dist/deploys/index.cjs

@@ -0,0 +1,53 @@
+'use strict';
+
+// src/deploys/tracker.ts
+function detectDeploy() {
+  if (typeof process === "undefined") return null;
+  const env = process.env;
+  if (env.VERCEL) {
+    const commitHash = env.VERCEL_GIT_COMMIT_SHA;
+    if (!commitHash) return null;
+    return {
+      commitHash,
+      branch: env.VERCEL_GIT_COMMIT_REF,
+      author: env.VERCEL_GIT_COMMIT_AUTHOR_LOGIN,
+      environment: env.VERCEL_ENV,
+      // 'production' | 'preview' | 'development'
+      url: env.VERCEL_URL ? `https://${env.VERCEL_URL}` : void 0,
+      provider: "vercel"
+    };
+  }
+  if (env.RAILWAY_ENVIRONMENT) {
+    const commitHash = env.RAILWAY_GIT_COMMIT_SHA;
+    if (!commitHash) return null;
+    return {
+      commitHash,
+      branch: env.RAILWAY_GIT_BRANCH,
+      author: env.RAILWAY_GIT_AUTHOR,
+      environment: env.RAILWAY_ENVIRONMENT,
+      url: env.RAILWAY_PUBLIC_DOMAIN ? `https://${env.RAILWAY_PUBLIC_DOMAIN}` : void 0,
+      provider: "railway"
+    };
+  }
+  return null;
+}
+function reportDeploy(monitor, overrides) {
+  const detected = detectDeploy();
+  if (!detected && !overrides?.commitHash) return;
+  const data = {
+    commitHash: overrides?.commitHash ?? detected?.commitHash ?? "unknown",
+    branch: overrides?.branch ?? detected?.branch,
+    author: overrides?.author ?? detected?.author,
+    status: overrides?.status ?? "succeeded",
+    buildDurationMs: overrides?.buildDurationMs,
+    url: overrides?.url ?? detected?.url,
+    environment: overrides?.environment ?? detected?.environment,
+    provider: overrides?.provider ?? detected?.provider
+  };
+  monitor.trackDeploy(data);
+}
+
+exports.detectDeploy = detectDeploy;
+exports.reportDeploy = reportDeploy;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/deploys/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/deploys/tracker.ts"],"names":[],"mappings":";;;AAqBO,SAAS,YAAA,GAAqC;AACnD,EAAA,IAAI,OAAO,OAAA,KAAY,WAAA,EAAa,OAAO,IAAA;AAC3C,EAAA,MAAM,MAAM,OAAA,CAAQ,GAAA;AAGpB,EAAA,IAAI,IAAI,MAAA,EAAQ;AACd,IAAA,MAAM,aAAa,GAAA,CAAI,qBAAA;AACvB,IAAA,IAAI,CAAC,YAAY,OAAO,IAAA;AAExB,IAAA,OAAO;AAAA,MACL,UAAA;AAAA,MACA,QAAQ,GAAA,CAAI,qBAAA;AAAA,MACZ,QAAQ,GAAA,CAAI,8BAAA;AAAA,MACZ,aAAa,GAAA,CAAI,UAAA;AAAA;AAAA,MACjB,KAAK,GAAA,CAAI,UAAA,GAAa,CAAA,QAAA,EAAW,GAAA,CAAI,UAAU,CAAA,CAAA,GAAK,MAAA;AAAA,MACpD,QAAA,EAAU;AAAA,KACZ;AAAA,EACF;AAGA,EAAA,IAAI,IAAI,mBAAA,EAAqB;AAC3B,IAAA,MAAM,aAAa,GAAA,CAAI,sBAAA;AACvB,IAAA,IAAI,CAAC,YAAY,OAAO,IAAA;AAExB,IAAA,OAAO;AAAA,MACL,UAAA;AAAA,MACA,QAAQ,GAAA,CAAI,kBAAA;AAAA,MACZ,QAAQ,GAAA,CAAI,kBAAA;AAAA,MACZ,aAAa,GAAA,CAAI,mBAAA;AAAA,MACjB,KAAK,GAAA,CAAI,qBAAA,GAAwB,CAAA,QAAA,EAAW,GAAA,CAAI,qBAAqB,CAAA,CAAA,GAAK,MAAA;AAAA,MAC1E,QAAA,EAAU;AAAA,KACZ;AAAA,EACF;AAEA,EAAA,OAAO,IAAA;AACT;AAqBO,SAAS,YAAA,CAAa,SAAwB,SAAA,EAAuC;AAC1F,EAAA,MAAM,WAAW,YAAA,EAAa;AAE9B,EAAA,IAAI,CAAC,QAAA,IAAY,CAAC,SAAA,EAAW,UAAA,EAAY;AAEzC,EAAA,MAAM,IAAA,GAAmB;AAAA,IACvB,UAAA,EAAY,SAAA,EAAW,UAAA,IAAc,QAAA,EAAU,UAAA,IAAc,SAAA;AAAA,IAC7D,MAAA,EAAQ,SAAA,EAAW,MAAA,IAAU,QAAA,EAAU,MAAA;AAAA,IACvC,MAAA,EAAQ,SAAA,EAAW,MAAA,IAAU,QAAA,EAAU,MAAA;AAAA,IACvC,MAAA,EAAQ,WAAW,MAAA,IAAU,WAAA;AAAA,IAC7B,iBAAiB,SAAA,EAAW,eAAA;AAAA,IAC5B,GAAA,EAAK,SAAA,EAAW,GAAA,IAAO,QAAA,EAAU,GAAA;AAAA,IACjC,WAAA,EAAa,SAAA,EAAW,WAAA,IAAe,QAAA,EAAU,WAAA;AAAA,IACjD,QAAA,EAAU,SAAA,EAAW,QAAA,IAAY,QAAA,EAAU;AAAA,GAC7C;AAEA,EAAA,OAAA,CAAQ,YAAY,IAAI,CAAA;AAC1B","file":"index.cjs","sourcesContent":["// Deploy tracker — detecta e reporta deploys automaticamente\n\nimport type { MonitorClient } from '../core/client'\nimport type { DeployData } from '../types'\n\n/** Contexto de deploy detectado via env vars */\ninterface DeployContext {\n  commitHash: string\n  branch?: string\n  author?: string\n  environment?: string\n  url?: string\n  provider: string\n}\n\n/**\n * Detecta deploy info a partir das env vars do provider.\n * Suporta Vercel e Railway.\n *\n * @returns contexto do deploy ou null se não detectado\n */\nexport function detectDeploy(): DeployContext | null {\n  if (typeof process === 'undefined') return null\n  const env = process.env\n\n  // Vercel\n  if (env.VERCEL) {\n    const commitHash = env.VERCEL_GIT_COMMIT_SHA\n    if (!commitHash) return null\n\n    return {\n      commitHash,\n      branch: env.VERCEL_GIT_COMMIT_REF,\n      author: env.VERCEL_GIT_COMMIT_AUTHOR_LOGIN,\n      environment: env.VERCEL_ENV, // 'production' | 'preview' | 'development'\n      url: env.VERCEL_URL ? `https://${env.VERCEL_URL}` : undefined,\n      provider: 'vercel',\n    }\n  }\n\n  // Railway\n  if (env.RAILWAY_ENVIRONMENT) {\n    const commitHash = env.RAILWAY_GIT_COMMIT_SHA\n    if (!commitHash) return null\n\n    return {\n      commitHash,\n      branch: env.RAILWAY_GIT_BRANCH,\n      author: env.RAILWAY_GIT_AUTHOR,\n      environment: env.RAILWAY_ENVIRONMENT,\n      url: env.RAILWAY_PUBLIC_DOMAIN ? `https://${env.RAILWAY_PUBLIC_DOMAIN}` : undefined,\n      provider: 'railway',\n    }\n  }\n\n  return null\n}\n\n/**\n * Reporta um deploy ao monitor. Detecta automaticamente Vercel/Railway.\n * Pode ser chamado no startup do app ou em CI/CD hooks.\n *\n * @example\n * ```ts\n * import { reportDeploy } from '@victor-studio/monitor/deploys'\n *\n * // Auto-detect (usa env vars)\n * reportDeploy(monitor)\n *\n * // Manual\n * reportDeploy(monitor, {\n *   commitHash: 'abc123',\n *   status: 'succeeded',\n *   provider: 'vercel',\n * })\n * ```\n */\nexport function reportDeploy(monitor: MonitorClient, overrides?: Partial<DeployData>): void {\n  const detected = detectDeploy()\n\n  if (!detected && !overrides?.commitHash) return\n\n  const data: DeployData = {\n    commitHash: overrides?.commitHash ?? detected?.commitHash ?? 'unknown',\n    branch: overrides?.branch ?? detected?.branch,\n    author: overrides?.author ?? detected?.author,\n    status: overrides?.status ?? 'succeeded',\n    buildDurationMs: overrides?.buildDurationMs,\n    url: overrides?.url ?? detected?.url,\n    environment: overrides?.environment ?? detected?.environment,\n    provider: overrides?.provider ?? detected?.provider,\n  }\n\n  monitor.trackDeploy(data)\n}\n"]}

package/dist/deploys/index.d.cts

@@ -0,0 +1,174 @@
+interface HeartbeatData {
+    status: 'online' | 'offline';
+    latencyMs: number;
+}
+interface RequestData {
+    method: string;
+    route: string;
+    statusCode: number;
+    responseTimeMs: number;
+    userAgent?: string;
+    region?: string;
+}
+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 */
+    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;
+    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: RequestData): void;
+    /** Registra um Web Vital (usado pelo MonitorScript) */
+    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;
+}
+
+/** Contexto de deploy detectado via env vars */
+interface DeployContext {
+    commitHash: string;
+    branch?: string;
+    author?: string;
+    environment?: string;
+    url?: string;
+    provider: string;
+}
+/**
+ * Detecta deploy info a partir das env vars do provider.
+ * Suporta Vercel e Railway.
+ *
+ * @returns contexto do deploy ou null se não detectado
+ */
+declare function detectDeploy(): DeployContext | null;
+/**
+ * Reporta um deploy ao monitor. Detecta automaticamente Vercel/Railway.
+ * Pode ser chamado no startup do app ou em CI/CD hooks.
+ *
+ * @example
+ * ```ts
+ * import { reportDeploy } from '@victor-studio/monitor/deploys'
+ *
+ * // Auto-detect (usa env vars)
+ * reportDeploy(monitor)
+ *
+ * // Manual
+ * reportDeploy(monitor, {
+ *   commitHash: 'abc123',
+ *   status: 'succeeded',
+ *   provider: 'vercel',
+ * })
+ * ```
+ */
+declare function reportDeploy(monitor: MonitorClient, overrides?: Partial<DeployData>): void;
+
+export { detectDeploy, reportDeploy };