@victor-studio/monitor 0.4.0 → 0.5.0

package/dist/adapters/bullmq/bullmq.cjs

@@ -0,0 +1,85 @@
+'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/bullmq.ts
+function monitorJob(monitor, queue, jobName, fn, meta) {
+  return withTiming(monitor, "bullmq", "process", fn, {
+    queue,
+    jobName,
+    ...meta
+  });
+}
+function monitorWorker(monitor, worker, queueName) {
+  const onCompleted = (...args) => {
+    const job = args[0];
+    const durationMs = job?.processedOn && job?.finishedOn ? job.finishedOn - job.processedOn : 0;
+    monitor.trackAdapter({
+      adapter: "bullmq",
+      operation: "completed",
+      durationMs,
+      success: true,
+      meta: { queue: queueName, jobName: job?.name ?? "unknown" }
+    });
+  };
+  const onFailed = (...args) => {
+    const job = args[0];
+    const err = args[1];
+    monitor.trackAdapter({
+      adapter: "bullmq",
+      operation: "failed",
+      durationMs: 0,
+      success: false,
+      error: err?.message ?? "unknown error",
+      meta: { queue: queueName, jobName: job?.name ?? "unknown" }
+    });
+  };
+  const onStalled = (...args) => {
+    const jobId = args[0];
+    monitor.trackAdapter({
+      adapter: "bullmq",
+      operation: "stalled",
+      durationMs: 0,
+      success: false,
+      error: "job stalled",
+      meta: { queue: queueName, jobId: jobId ?? "unknown" }
+    });
+  };
+  worker.on("completed", onCompleted);
+  worker.on("failed", onFailed);
+  worker.on("stalled", onStalled);
+  return () => {
+    worker.off("completed", onCompleted);
+    worker.off("failed", onFailed);
+    worker.off("stalled", onStalled);
+  };
+}
+
+exports.monitorJob = monitorJob;
+exports.monitorWorker = monitorWorker;
+//# sourceMappingURL=bullmq.cjs.map
+//# sourceMappingURL=bullmq.cjs.map

package/dist/adapters/bullmq/bullmq.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/adapters/core.ts","../../../src/adapters/bullmq.ts"],"names":[],"mappings":"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","file":"bullmq.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 BullMQ — instrumentação de jobs e filas\n\nimport type { MonitorClient } from '../core/client'\nimport { withTiming } from './core'\n\n/**\n * Instrumenta o processamento de um job BullMQ com timing.\n *\n * @example\n * ```ts\n * import { monitorJob } from '@victor-studio/monitor/adapters/bullmq'\n *\n * worker.on('completed', (job) => {\n *   // Para tracking manual de jobs já processados\n * })\n *\n * // Ou wrap o processamento inteiro:\n * const result = await monitorJob(monitor, 'email-queue', 'send-welcome', () =>\n *   processJob(jobData),\n * )\n * ```\n */\nexport function monitorJob<T>(\n  monitor: MonitorClient,\n  queue: string,\n  jobName: string,\n  fn: () => Promise<T>,\n  meta?: Record<string, string>,\n): Promise<T> {\n  return withTiming(monitor, 'bullmq', 'process', fn, {\n    queue,\n    jobName,\n    ...meta,\n  })\n}\n\n/**\n * Registra event listeners no Worker do BullMQ para tracking automático.\n * Retorna função de cleanup para remover os listeners.\n *\n * @example\n * ```ts\n * import { monitorWorker } from '@victor-studio/monitor/adapters/bullmq'\n * import { Worker } from 'bullmq'\n *\n * const worker = new Worker('email-queue', processor, { connection })\n * const cleanup = monitorWorker(monitor, worker, 'email-queue')\n *\n * // Quando quiser parar:\n * cleanup()\n * ```\n */\nexport function monitorWorker(\n  monitor: MonitorClient,\n  worker: {\n    on: (event: string, listener: (...args: unknown[]) => void) => void\n    off: (event: string, listener: (...args: unknown[]) => void) => void\n  },\n  queueName: string,\n): () => void {\n  const onCompleted = (...args: unknown[]) => {\n    const job = args[0] as { name?: string; processedOn?: number; finishedOn?: number } | undefined\n    const durationMs =\n      job?.processedOn && job?.finishedOn ? job.finishedOn - job.processedOn : 0\n\n    monitor.trackAdapter({\n      adapter: 'bullmq',\n      operation: 'completed',\n      durationMs,\n      success: true,\n      meta: { queue: queueName, jobName: job?.name ?? 'unknown' },\n    })\n  }\n\n  const onFailed = (...args: unknown[]) => {\n    const job = args[0] as { name?: string; processedOn?: number; finishedOn?: number } | undefined\n    const err = args[1] as Error | undefined\n\n    monitor.trackAdapter({\n      adapter: 'bullmq',\n      operation: 'failed',\n      durationMs: 0,\n      success: false,\n      error: err?.message ?? 'unknown error',\n      meta: { queue: queueName, jobName: job?.name ?? 'unknown' },\n    })\n  }\n\n  const onStalled = (...args: unknown[]) => {\n    const jobId = args[0] as string | undefined\n\n    monitor.trackAdapter({\n      adapter: 'bullmq',\n      operation: 'stalled',\n      durationMs: 0,\n      success: false,\n      error: 'job stalled',\n      meta: { queue: queueName, jobId: jobId ?? 'unknown' },\n    })\n  }\n\n  worker.on('completed', onCompleted)\n  worker.on('failed', onFailed)\n  worker.on('stalled', onStalled)\n\n  return () => {\n    worker.off('completed', onCompleted)\n    worker.off('failed', onFailed)\n    worker.off('stalled', onStalled)\n  }\n}\n"]}

package/dist/adapters/bullmq/bullmq.d.cts

@@ -0,0 +1,176 @@
+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 o processamento de um job BullMQ com timing.
+ *
+ * @example
+ * ```ts
+ * import { monitorJob } from '@victor-studio/monitor/adapters/bullmq'
+ *
+ * worker.on('completed', (job) => {
+ *   // Para tracking manual de jobs já processados
+ * })
+ *
+ * // Ou wrap o processamento inteiro:
+ * const result = await monitorJob(monitor, 'email-queue', 'send-welcome', () =>
+ *   processJob(jobData),
+ * )
+ * ```
+ */
+declare function monitorJob<T>(monitor: MonitorClient, queue: string, jobName: string, fn: () => Promise<T>, meta?: Record<string, string>): Promise<T>;
+/**
+ * Registra event listeners no Worker do BullMQ para tracking automático.
+ * Retorna função de cleanup para remover os listeners.
+ *
+ * @example
+ * ```ts
+ * import { monitorWorker } from '@victor-studio/monitor/adapters/bullmq'
+ * import { Worker } from 'bullmq'
+ *
+ * const worker = new Worker('email-queue', processor, { connection })
+ * const cleanup = monitorWorker(monitor, worker, 'email-queue')
+ *
+ * // Quando quiser parar:
+ * cleanup()
+ * ```
+ */
+declare function monitorWorker(monitor: MonitorClient, worker: {
+    on: (event: string, listener: (...args: unknown[]) => void) => void;
+    off: (event: string, listener: (...args: unknown[]) => void) => void;
+}, queueName: string): () => void;
+
+export { monitorJob, monitorWorker };

package/dist/adapters/bullmq/bullmq.d.ts

@@ -0,0 +1,176 @@
+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 o processamento de um job BullMQ com timing.
+ *
+ * @example
+ * ```ts
+ * import { monitorJob } from '@victor-studio/monitor/adapters/bullmq'
+ *
+ * worker.on('completed', (job) => {
+ *   // Para tracking manual de jobs já processados
+ * })
+ *
+ * // Ou wrap o processamento inteiro:
+ * const result = await monitorJob(monitor, 'email-queue', 'send-welcome', () =>
+ *   processJob(jobData),
+ * )
+ * ```
+ */
+declare function monitorJob<T>(monitor: MonitorClient, queue: string, jobName: string, fn: () => Promise<T>, meta?: Record<string, string>): Promise<T>;
+/**
+ * Registra event listeners no Worker do BullMQ para tracking automático.
+ * Retorna função de cleanup para remover os listeners.
+ *
+ * @example
+ * ```ts
+ * import { monitorWorker } from '@victor-studio/monitor/adapters/bullmq'
+ * import { Worker } from 'bullmq'
+ *
+ * const worker = new Worker('email-queue', processor, { connection })
+ * const cleanup = monitorWorker(monitor, worker, 'email-queue')
+ *
+ * // Quando quiser parar:
+ * cleanup()
+ * ```
+ */
+declare function monitorWorker(monitor: MonitorClient, worker: {
+    on: (event: string, listener: (...args: unknown[]) => void) => void;
+    off: (event: string, listener: (...args: unknown[]) => void) => void;
+}, queueName: string): () => void;
+
+export { monitorJob, monitorWorker };

package/dist/adapters/bullmq/bullmq.js

@@ -0,0 +1,82 @@
+// 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/bullmq.ts
+function monitorJob(monitor, queue, jobName, fn, meta) {
+  return withTiming(monitor, "bullmq", "process", fn, {
+    queue,
+    jobName,
+    ...meta
+  });
+}
+function monitorWorker(monitor, worker, queueName) {
+  const onCompleted = (...args) => {
+    const job = args[0];
+    const durationMs = job?.processedOn && job?.finishedOn ? job.finishedOn - job.processedOn : 0;
+    monitor.trackAdapter({
+      adapter: "bullmq",
+      operation: "completed",
+      durationMs,
+      success: true,
+      meta: { queue: queueName, jobName: job?.name ?? "unknown" }
+    });
+  };
+  const onFailed = (...args) => {
+    const job = args[0];
+    const err = args[1];
+    monitor.trackAdapter({
+      adapter: "bullmq",
+      operation: "failed",
+      durationMs: 0,
+      success: false,
+      error: err?.message ?? "unknown error",
+      meta: { queue: queueName, jobName: job?.name ?? "unknown" }
+    });
+  };
+  const onStalled = (...args) => {
+    const jobId = args[0];
+    monitor.trackAdapter({
+      adapter: "bullmq",
+      operation: "stalled",
+      durationMs: 0,
+      success: false,
+      error: "job stalled",
+      meta: { queue: queueName, jobId: jobId ?? "unknown" }
+    });
+  };
+  worker.on("completed", onCompleted);
+  worker.on("failed", onFailed);
+  worker.on("stalled", onStalled);
+  return () => {
+    worker.off("completed", onCompleted);
+    worker.off("failed", onFailed);
+    worker.off("stalled", onStalled);
+  };
+}
+
+export { monitorJob, monitorWorker };
+//# sourceMappingURL=bullmq.js.map
+//# sourceMappingURL=bullmq.js.map

package/dist/adapters/bullmq/bullmq.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/adapters/core.ts","../../../src/adapters/bullmq.ts"],"names":[],"mappings":"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","file":"bullmq.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 BullMQ — instrumentação de jobs e filas\n\nimport type { MonitorClient } from '../core/client'\nimport { withTiming } from './core'\n\n/**\n * Instrumenta o processamento de um job BullMQ com timing.\n *\n * @example\n * ```ts\n * import { monitorJob } from '@victor-studio/monitor/adapters/bullmq'\n *\n * worker.on('completed', (job) => {\n *   // Para tracking manual de jobs já processados\n * })\n *\n * // Ou wrap o processamento inteiro:\n * const result = await monitorJob(monitor, 'email-queue', 'send-welcome', () =>\n *   processJob(jobData),\n * )\n * ```\n */\nexport function monitorJob<T>(\n  monitor: MonitorClient,\n  queue: string,\n  jobName: string,\n  fn: () => Promise<T>,\n  meta?: Record<string, string>,\n): Promise<T> {\n  return withTiming(monitor, 'bullmq', 'process', fn, {\n    queue,\n    jobName,\n    ...meta,\n  })\n}\n\n/**\n * Registra event listeners no Worker do BullMQ para tracking automático.\n * Retorna função de cleanup para remover os listeners.\n *\n * @example\n * ```ts\n * import { monitorWorker } from '@victor-studio/monitor/adapters/bullmq'\n * import { Worker } from 'bullmq'\n *\n * const worker = new Worker('email-queue', processor, { connection })\n * const cleanup = monitorWorker(monitor, worker, 'email-queue')\n *\n * // Quando quiser parar:\n * cleanup()\n * ```\n */\nexport function monitorWorker(\n  monitor: MonitorClient,\n  worker: {\n    on: (event: string, listener: (...args: unknown[]) => void) => void\n    off: (event: string, listener: (...args: unknown[]) => void) => void\n  },\n  queueName: string,\n): () => void {\n  const onCompleted = (...args: unknown[]) => {\n    const job = args[0] as { name?: string; processedOn?: number; finishedOn?: number } | undefined\n    const durationMs =\n      job?.processedOn && job?.finishedOn ? job.finishedOn - job.processedOn : 0\n\n    monitor.trackAdapter({\n      adapter: 'bullmq',\n      operation: 'completed',\n      durationMs,\n      success: true,\n      meta: { queue: queueName, jobName: job?.name ?? 'unknown' },\n    })\n  }\n\n  const onFailed = (...args: unknown[]) => {\n    const job = args[0] as { name?: string; processedOn?: number; finishedOn?: number } | undefined\n    const err = args[1] as Error | undefined\n\n    monitor.trackAdapter({\n      adapter: 'bullmq',\n      operation: 'failed',\n      durationMs: 0,\n      success: false,\n      error: err?.message ?? 'unknown error',\n      meta: { queue: queueName, jobName: job?.name ?? 'unknown' },\n    })\n  }\n\n  const onStalled = (...args: unknown[]) => {\n    const jobId = args[0] as string | undefined\n\n    monitor.trackAdapter({\n      adapter: 'bullmq',\n      operation: 'stalled',\n      durationMs: 0,\n      success: false,\n      error: 'job stalled',\n      meta: { queue: queueName, jobId: jobId ?? 'unknown' },\n    })\n  }\n\n  worker.on('completed', onCompleted)\n  worker.on('failed', onFailed)\n  worker.on('stalled', onStalled)\n\n  return () => {\n    worker.off('completed', onCompleted)\n    worker.off('failed', onFailed)\n    worker.off('stalled', onStalled)\n  }\n}\n"]}

package/dist/adapters/gemini/gemini.cjs

@@ -0,0 +1,65 @@
+'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/gemini.ts
+function monitorAI(monitor, operation, fn, meta) {
+  return withTiming(monitor, "gemini", operation, fn, meta);
+}
+async function monitorAIWithTokens(monitor, operation, fn, meta) {
+  const start = performance.now();
+  try {
+    const { result, inputTokens, outputTokens } = await fn();
+    monitor.trackAdapter({
+      adapter: "gemini",
+      operation,
+      durationMs: Math.round(performance.now() - start),
+      success: true,
+      meta: {
+        ...meta,
+        ...inputTokens !== void 0 ? { inputTokens: String(inputTokens) } : {},
+        ...outputTokens !== void 0 ? { outputTokens: String(outputTokens) } : {}
+      }
+    });
+    return result;
+  } catch (error) {
+    monitor.trackAdapter({
+      adapter: "gemini",
+      operation,
+      durationMs: Math.round(performance.now() - start),
+      success: false,
+      error: error instanceof Error ? error.message : String(error),
+      meta
+    });
+    throw error;
+  }
+}
+
+exports.monitorAI = monitorAI;
+exports.monitorAIWithTokens = monitorAIWithTokens;
+//# sourceMappingURL=gemini.cjs.map
+//# sourceMappingURL=gemini.cjs.map

package/dist/adapters/gemini/gemini.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/adapters/core.ts","../../../src/adapters/gemini.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;;;AC/BO,SAAS,SAAA,CACd,OAAA,EACA,SAAA,EACA,EAAA,EACA,IAAA,EACY;AACZ,EAAA,OAAO,UAAA,CAAW,OAAA,EAAS,QAAA,EAAU,SAAA,EAAW,IAAI,IAAI,CAAA;AAC1D;AAkBA,eAAsB,mBAAA,CACpB,OAAA,EACA,SAAA,EACA,EAAA,EACA,IAAA,EACY;AACZ,EAAA,MAAM,KAAA,GAAQ,YAAY,GAAA,EAAI;AAE9B,EAAA,IAAI;AACF,IAAA,MAAM,EAAE,MAAA,EAAQ,WAAA,EAAa,YAAA,EAAa,GAAI,MAAM,EAAA,EAAG;AAEvD,IAAA,OAAA,CAAQ,YAAA,CAAa;AAAA,MACnB,OAAA,EAAS,QAAA;AAAA,MACT,SAAA;AAAA,MACA,YAAY,IAAA,CAAK,KAAA,CAAM,WAAA,CAAY,GAAA,KAAQ,KAAK,CAAA;AAAA,MAChD,OAAA,EAAS,IAAA;AAAA,MACT,IAAA,EAAM;AAAA,QACJ,GAAG,IAAA;AAAA,QACH,GAAI,gBAAgB,KAAA,CAAA,GAAY,EAAE,aAAa,MAAA,CAAO,WAAW,CAAA,EAAE,GAAI,EAAC;AAAA,QACxE,GAAI,iBAAiB,KAAA,CAAA,GAAY,EAAE,cAAc,MAAA,CAAO,YAAY,CAAA,EAAE,GAAI;AAAC;AAC7E,KACD,CAAA;AAED,IAAA,OAAO,MAAA;AAAA,EACT,SAAS,KAAA,EAAO;AACd,IAAA,OAAA,CAAQ,YAAA,CAAa;AAAA,MACnB,OAAA,EAAS,QAAA;AAAA,MACT,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,KACD,CAAA;AAED,IAAA,MAAM,KAAA;AAAA,EACR;AACF","file":"gemini.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 Gemini — instrumentação de chamadas AI\n\nimport type { MonitorClient } from '../core/client'\nimport { withTiming } from './core'\n\n/**\n * Instrumenta uma chamada ao Gemini API com timing e token tracking.\n *\n * @example\n * ```ts\n * import { monitorAI } from '@victor-studio/monitor/adapters/gemini'\n *\n * const result = await monitorAI(monitor, 'generate', () =>\n *   model.generateContent(prompt),\n *   { model: 'gemini-2.5-flash' },\n * )\n * ```\n */\nexport function monitorAI<T>(\n  monitor: MonitorClient,\n  operation: string,\n  fn: () => Promise<T>,\n  meta?: Record<string, string>,\n): Promise<T> {\n  return withTiming(monitor, 'gemini', operation, fn, meta)\n}\n\n/**\n * Instrumenta uma chamada AI e extrai token usage do resultado.\n * Específico para o formato de resposta do Google Generative AI SDK.\n *\n * @example\n * ```ts\n * const result = await monitorAIWithTokens(monitor, 'generate', async () => {\n *   const res = await model.generateContent(prompt)\n *   return {\n *     result: res,\n *     inputTokens: res.response.usageMetadata?.promptTokenCount,\n *     outputTokens: res.response.usageMetadata?.candidatesTokenCount,\n *   }\n * }, { model: 'gemini-2.5-flash' })\n * ```\n */\nexport async function monitorAIWithTokens<T>(\n  monitor: MonitorClient,\n  operation: string,\n  fn: () => Promise<{ result: T; inputTokens?: number; outputTokens?: number }>,\n  meta?: Record<string, string>,\n): Promise<T> {\n  const start = performance.now()\n\n  try {\n    const { result, inputTokens, outputTokens } = await fn()\n\n    monitor.trackAdapter({\n      adapter: 'gemini',\n      operation,\n      durationMs: Math.round(performance.now() - start),\n      success: true,\n      meta: {\n        ...meta,\n        ...(inputTokens !== undefined ? { inputTokens: String(inputTokens) } : {}),\n        ...(outputTokens !== undefined ? { outputTokens: String(outputTokens) } : {}),\n      },\n    })\n\n    return result\n  } catch (error) {\n    monitor.trackAdapter({\n      adapter: 'gemini',\n      operation,\n      durationMs: Math.round(performance.now() - start),\n      success: false,\n      error: error instanceof Error ? error.message : String(error),\n      meta,\n    })\n\n    throw error\n  }\n}\n"]}