@victor-studio/monitor 0.4.0 → 0.5.0

package/dist/deploys/index.d.ts

@@ -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 };

package/dist/deploys/index.js

@@ -0,0 +1,50 @@
+// 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);
+}
+
+export { detectDeploy, reportDeploy };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/deploys/index.js.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.js","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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@victor-studio/monitor",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Lightweight monitoring SDK for Nuvio-managed projects",
   "type": "module",
   "sideEffects": false,
@@ -27,6 +27,51 @@
       "types": "./dist/errors/index.d.ts",
       "import": "./dist/errors/index.js",
       "require": "./dist/errors/index.cjs"
+    },
+    "./deploys": {
+      "types": "./dist/deploys/index.d.ts",
+      "import": "./dist/deploys/index.js",
+      "require": "./dist/deploys/index.cjs"
+    },
+    "./adapters": {
+      "types": "./dist/adapters/index.d.ts",
+      "import": "./dist/adapters/index.js",
+      "require": "./dist/adapters/index.cjs"
+    },
+    "./adapters/vercel": {
+      "types": "./dist/adapters/vercel/vercel.d.ts",
+      "import": "./dist/adapters/vercel/vercel.js",
+      "require": "./dist/adapters/vercel/vercel.cjs"
+    },
+    "./adapters/railway": {
+      "types": "./dist/adapters/railway/railway.d.ts",
+      "import": "./dist/adapters/railway/railway.js",
+      "require": "./dist/adapters/railway/railway.cjs"
+    },
+    "./adapters/neon": {
+      "types": "./dist/adapters/neon/neon.d.ts",
+      "import": "./dist/adapters/neon/neon.js",
+      "require": "./dist/adapters/neon/neon.cjs"
+    },
+    "./adapters/upstash": {
+      "types": "./dist/adapters/upstash/upstash.d.ts",
+      "import": "./dist/adapters/upstash/upstash.js",
+      "require": "./dist/adapters/upstash/upstash.cjs"
+    },
+    "./adapters/gemini": {
+      "types": "./dist/adapters/gemini/gemini.d.ts",
+      "import": "./dist/adapters/gemini/gemini.js",
+      "require": "./dist/adapters/gemini/gemini.cjs"
+    },
+    "./adapters/bullmq": {
+      "types": "./dist/adapters/bullmq/bullmq.d.ts",
+      "import": "./dist/adapters/bullmq/bullmq.js",
+      "require": "./dist/adapters/bullmq/bullmq.cjs"
+    },
+    "./adapters/resend": {
+      "types": "./dist/adapters/resend/resend.d.ts",
+      "import": "./dist/adapters/resend/resend.js",
+      "require": "./dist/adapters/resend/resend.cjs"
     }
   },
   "files": [