@marianods/perf-observer-sdk

SDK para el navegador: Web Vitals, navigation timing, resources, errores JS, long tasks y cambios de ruta (history).

Instalación

npm install @marianods/perf-observer-sdk
pnpm add @marianods/perf-observer-sdk
yarn add @marianods/perf-observer-sdk

Dependencias de runtime: web-vitals y zod.

Desde este monorepo (workspace)

pnpm add @marianods/perf-observer-sdk@workspace:*

Desde la carpeta local (sin registry)

{
  "dependencies": {
    "@marianods/perf-observer-sdk": "file:../ruta/al/repo/packages/sdk"
  }
}

Luego en el repo del SDK: pnpm run build.

Uso

import { initPerfObserver } from "@marianods/perf-observer-sdk";

const stop = initPerfObserver({
  endpoint: "https://tu-api.com/api/v1/events",
  appId: "mi-app",
  sampleRate: 1,
  batchSize: 10,
  flushIntervalMs: 5000,
  debug: false,
});

Next.js (App Router): inicializá en un componente cliente dentro de useEffect y devolvé la función de cleanup.

Publicar en npm

npm login
cd packages/sdk
npm run build
npm publish --access public

Build del paquete

pnpm run build

Genera dist/ (ESM, CJS y tipos). prepublishOnly ejecuta tsup al publicar.