@victor-studio/monitor 0.4.0 → 0.5.0

package/dist/adapters/index.d.ts

@@ -0,0 +1,154 @@
+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;
+}
+
+/**
+ * Mede a duração de uma operação assíncrona e reporta ao monitor.
+ * Utilitário base usado por todos os adapters.
+ *
+ * @example
+ * ```ts
+ * const result = await withTiming(monitor, 'neon', 'query', () =>
+ *   db.select().from(users),
+ * )
+ * ```
+ */
+declare function withTiming<T>(monitor: MonitorClient, adapter: string, operation: string, fn: () => Promise<T>, meta?: Record<string, string>): Promise<T>;
+/**
+ * Versão sync do withTiming para operações síncronas.
+ */
+declare function withTimingSync<T>(monitor: MonitorClient, adapter: string, operation: string, fn: () => T, meta?: Record<string, string>): T;
+
+export { withTiming, withTimingSync };

package/dist/adapters/index.js

@@ -0,0 +1,53 @@
+// 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;
+  }
+}
+function withTimingSync(monitor, adapter, operation, fn, meta) {
+  const start = performance.now();
+  try {
+    const result = 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;
+  }
+}
+
+export { withTiming, withTimingSync };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/core.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;AAKO,SAAS,cAAA,CACd,OAAA,EACA,OAAA,EACA,SAAA,EACA,IACA,IAAA,EACG;AACH,EAAA,MAAM,KAAA,GAAQ,YAAY,GAAA,EAAI;AAE9B,EAAA,IAAI;AACF,IAAA,MAAM,SAAS,EAAA,EAAG;AAElB,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","file":"index.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"]}

package/dist/adapters/neon/neon.cjs

@@ -0,0 +1,36 @@
+'use strict';
+
+// 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/neon.ts
+function monitorQuery(monitor, operation, queryFn, meta) {
+  return withTiming(monitor, "neon", operation, queryFn, meta);
+}
+
+exports.monitorQuery = monitorQuery;
+//# sourceMappingURL=neon.cjs.map
+//# sourceMappingURL=neon.cjs.map

package/dist/adapters/neon/neon.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/adapters/core.ts","../../../src/adapters/neon.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;;;AChCO,SAAS,YAAA,CACd,OAAA,EACA,SAAA,EACA,OAAA,EACA,IAAA,EACY;AACZ,EAAA,OAAO,UAAA,CAAW,OAAA,EAAS,MAAA,EAAQ,SAAA,EAAW,SAAS,IAAI,CAAA;AAC7D","file":"neon.cjs","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 NeonDB — instrumentação de queries Drizzle/Neon\n\nimport type { MonitorClient } from '../core/client'\nimport { withTiming } from './core'\n\n/**\n * Instrumenta uma query de banco de dados com timing.\n *\n * @example\n * ```ts\n * import { monitorQuery } from '@victor-studio/monitor/adapters/neon'\n *\n * const users = await monitorQuery(monitor, 'select', () =>\n *   db.select().from(usersTable).where(eq(usersTable.id, id)),\n * )\n * ```\n */\nexport function monitorQuery<T>(\n  monitor: MonitorClient,\n  operation: string,\n  queryFn: () => Promise<T>,\n  meta?: Record<string, string>,\n): Promise<T> {\n  return withTiming(monitor, 'neon', operation, queryFn, meta)\n}\n"]}

package/dist/adapters/neon/neon.d.cts

@@ -0,0 +1,151 @@
+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 uma query de banco de dados com timing.
+ *
+ * @example
+ * ```ts
+ * import { monitorQuery } from '@victor-studio/monitor/adapters/neon'
+ *
+ * const users = await monitorQuery(monitor, 'select', () =>
+ *   db.select().from(usersTable).where(eq(usersTable.id, id)),
+ * )
+ * ```
+ */
+declare function monitorQuery<T>(monitor: MonitorClient, operation: string, queryFn: () => Promise<T>, meta?: Record<string, string>): Promise<T>;
+
+export { monitorQuery };

package/dist/adapters/neon/neon.d.ts

@@ -0,0 +1,151 @@
+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 uma query de banco de dados com timing.
+ *
+ * @example
+ * ```ts
+ * import { monitorQuery } from '@victor-studio/monitor/adapters/neon'
+ *
+ * const users = await monitorQuery(monitor, 'select', () =>
+ *   db.select().from(usersTable).where(eq(usersTable.id, id)),
+ * )
+ * ```
+ */
+declare function monitorQuery<T>(monitor: MonitorClient, operation: string, queryFn: () => Promise<T>, meta?: Record<string, string>): Promise<T>;
+
+export { monitorQuery };

package/dist/adapters/neon/neon.js

@@ -0,0 +1,34 @@
+// 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/neon.ts
+function monitorQuery(monitor, operation, queryFn, meta) {
+  return withTiming(monitor, "neon", operation, queryFn, meta);
+}
+
+export { monitorQuery };
+//# sourceMappingURL=neon.js.map
+//# sourceMappingURL=neon.js.map

package/dist/adapters/neon/neon.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/adapters/core.ts","../../../src/adapters/neon.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;;;AChCO,SAAS,YAAA,CACd,OAAA,EACA,SAAA,EACA,OAAA,EACA,IAAA,EACY;AACZ,EAAA,OAAO,UAAA,CAAW,OAAA,EAAS,MAAA,EAAQ,SAAA,EAAW,SAAS,IAAI,CAAA;AAC7D","file":"neon.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 NeonDB — instrumentação de queries Drizzle/Neon\n\nimport type { MonitorClient } from '../core/client'\nimport { withTiming } from './core'\n\n/**\n * Instrumenta uma query de banco de dados com timing.\n *\n * @example\n * ```ts\n * import { monitorQuery } from '@victor-studio/monitor/adapters/neon'\n *\n * const users = await monitorQuery(monitor, 'select', () =>\n *   db.select().from(usersTable).where(eq(usersTable.id, id)),\n * )\n * ```\n */\nexport function monitorQuery<T>(\n  monitor: MonitorClient,\n  operation: string,\n  queryFn: () => Promise<T>,\n  meta?: Record<string, string>,\n): Promise<T> {\n  return withTiming(monitor, 'neon', operation, queryFn, meta)\n}\n"]}

package/dist/adapters/railway/railway.cjs

@@ -0,0 +1,20 @@
+'use strict';
+
+// src/adapters/railway.ts
+function getRailwayContext() {
+  if (typeof process === "undefined") return {};
+  const env = process.env;
+  return {
+    environment: env.RAILWAY_ENVIRONMENT,
+    commitHash: env.RAILWAY_GIT_COMMIT_SHA,
+    branch: env.RAILWAY_GIT_BRANCH,
+    author: env.RAILWAY_GIT_AUTHOR,
+    url: env.RAILWAY_PUBLIC_DOMAIN ? `https://${env.RAILWAY_PUBLIC_DOMAIN}` : void 0,
+    projectId: env.RAILWAY_PROJECT_ID,
+    serviceId: env.RAILWAY_SERVICE_ID
+  };
+}
+
+exports.getRailwayContext = getRailwayContext;
+//# sourceMappingURL=railway.cjs.map
+//# sourceMappingURL=railway.cjs.map

package/dist/adapters/railway/railway.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/adapters/railway.ts"],"names":[],"mappings":";;;AAuBO,SAAS,iBAAA,GAAoC;AAClD,EAAA,IAAI,OAAO,OAAA,KAAY,WAAA,EAAa,OAAO,EAAC;AAC5C,EAAA,MAAM,MAAM,OAAA,CAAQ,GAAA;AAEpB,EAAA,OAAO;AAAA,IACL,aAAa,GAAA,CAAI,mBAAA;AAAA,IACjB,YAAY,GAAA,CAAI,sBAAA;AAAA,IAChB,QAAQ,GAAA,CAAI,kBAAA;AAAA,IACZ,QAAQ,GAAA,CAAI,kBAAA;AAAA,IACZ,KAAK,GAAA,CAAI,qBAAA,GAAwB,CAAA,QAAA,EAAW,GAAA,CAAI,qBAAqB,CAAA,CAAA,GAAK,MAAA;AAAA,IAC1E,WAAW,GAAA,CAAI,kBAAA;AAAA,IACf,WAAW,GAAA,CAAI;AAAA,GACjB;AACF","file":"railway.cjs","sourcesContent":["// Adapter Railway — contexto de deploy e runtime\n\n/** Contexto Railway extraído das env vars */\nexport interface RailwayContext {\n  environment?: string\n  commitHash?: string\n  branch?: string\n  author?: string\n  url?: string\n  projectId?: string\n  serviceId?: string\n}\n\n/**\n * Lê contexto de runtime do Railway via env vars.\n *\n * @example\n * ```ts\n * import { getRailwayContext } from '@victor-studio/monitor/adapters/railway'\n *\n * const ctx = getRailwayContext()\n * ```\n */\nexport function getRailwayContext(): RailwayContext {\n  if (typeof process === 'undefined') return {}\n  const env = process.env\n\n  return {\n    environment: env.RAILWAY_ENVIRONMENT,\n    commitHash: env.RAILWAY_GIT_COMMIT_SHA,\n    branch: env.RAILWAY_GIT_BRANCH,\n    author: env.RAILWAY_GIT_AUTHOR,\n    url: env.RAILWAY_PUBLIC_DOMAIN ? `https://${env.RAILWAY_PUBLIC_DOMAIN}` : undefined,\n    projectId: env.RAILWAY_PROJECT_ID,\n    serviceId: env.RAILWAY_SERVICE_ID,\n  }\n}\n"]}

package/dist/adapters/railway/railway.d.cts

@@ -0,0 +1,23 @@
+/** Contexto Railway extraído das env vars */
+interface RailwayContext {
+    environment?: string;
+    commitHash?: string;
+    branch?: string;
+    author?: string;
+    url?: string;
+    projectId?: string;
+    serviceId?: string;
+}
+/**
+ * Lê contexto de runtime do Railway via env vars.
+ *
+ * @example
+ * ```ts
+ * import { getRailwayContext } from '@victor-studio/monitor/adapters/railway'
+ *
+ * const ctx = getRailwayContext()
+ * ```
+ */
+declare function getRailwayContext(): RailwayContext;
+
+export { type RailwayContext, getRailwayContext };

package/dist/adapters/railway/railway.d.ts

@@ -0,0 +1,23 @@
+/** Contexto Railway extraído das env vars */
+interface RailwayContext {
+    environment?: string;
+    commitHash?: string;
+    branch?: string;
+    author?: string;
+    url?: string;
+    projectId?: string;
+    serviceId?: string;
+}
+/**
+ * Lê contexto de runtime do Railway via env vars.
+ *
+ * @example
+ * ```ts
+ * import { getRailwayContext } from '@victor-studio/monitor/adapters/railway'
+ *
+ * const ctx = getRailwayContext()
+ * ```
+ */
+declare function getRailwayContext(): RailwayContext;
+
+export { type RailwayContext, getRailwayContext };