@eiaifactory/monitor 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EI AI Factory
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,285 @@
+# @eiaifactory/monitor
+
+Manda los errores de un sistema de cliente al Monitor de EI AI Factory, sin que el usuario final
+lo note.
+
+Este README **es el contrato**: el SDK es una forma de emitir, pero cualquier cosa que sepa hacer
+un `POST` con JSON y una clave emite igual (un `curl` en un workflow, un `net.http_post` desde un
+cron, un servicio en otro lenguaje). La definición de la que se copia vive en
+[`eiaifactory-finance`](https://github.com/eiaifactory/eiaifactory-finance/blob/main/supabase/functions/_shared/monitor/tipos.ts).
+
+## La regla que manda: invisible para el usuario final
+
+- `capturar()` guarda el error en memoria y retorna (en menos de 1 ms): nada de red ni de
+  `localStorage` en el mismo tick. Lo demás corre después, cuando el navegador está ocioso.
+- Nunca lanza, nunca muestra nada, no escribe en la consola (salvo `debug: true`).
+- Si finance no contesta, el sistema del cliente anda igual: la cola espera, con tope.
+- Sin clave no hace nada. Así corre en desarrollo local, en tests y en SSR.
+
+## Instalar
+
+```bash
+npm install @eiaifactory/monitor
+```
+
+La clave de cada ambiente se crea en finance → **Monitor → Proyectos y claves**, y se ve una sola
+vez. Es un secreto: va en variables de entorno, nunca en el repo.
+
+| Dónde | Variable |
+|---|---|
+| Front (Vite) | `VITE_MONITOR_CLAVE` |
+| Edge functions | secreto `MONITOR_CLAVE` |
+| Crons de la base | `monitor_clave` en el vault |
+
+## Navegador
+
+```ts
+// src/main.tsx
+import { initMonitor, onErrorQuery, onErrorMutation, setUsuario } from '@eiaifactory/monitor';
+import { QueryCache, MutationCache, QueryClient } from '@tanstack/react-query';
+
+initMonitor({
+  clave: import.meta.env.VITE_MONITOR_CLAVE,
+  release: import.meta.env.VITE_RELEASE,
+  // Opcional: lo que no es un incidente para este sistema.
+  ignorar: ['Failed to fetch dynamically imported module'],
+});
+
+// Aditivos: los onError de cada query o mutation siguen andando igual.
+export const queryClient = new QueryClient({
+  queryCache: new QueryCache({ onError: onErrorQuery }),
+  mutationCache: new MutationCache({ onError: onErrorMutation }),
+});
+
+// Cuando hay sesión. Un id opaco (uuid), nunca un email.
+setUsuario({ id: session.user.id, rol: perfil.rol });
+```
+
+`release` es el sha corto del build. En Railway, `RAILWAY_GIT_COMMIT_SHA` existe durante el build,
+pero Vite sólo expone las variables con prefijo `VITE_`:
+
+```ts
+// vite.config.ts
+define: {
+  'import.meta.env.VITE_RELEASE': JSON.stringify(process.env.RAILWAY_GIT_COMMIT_SHA?.slice(0, 7) ?? 'local'),
+},
+```
+
+Instalado, captura solo los errores no manejados (`error`) y las promesas rechazadas sin atajar
+(`unhandledrejection`), sin `preventDefault` y sin pisar los handlers de la página.
+
+| Función | Qué hace |
+|---|---|
+| `initMonitor({ clave, url?, release?, ignorar?, maxBuffer?, maxPorMinuto?, debug? })` | Instala los listeners. Una sola vez por página; las siguientes se ignoran. |
+| `capturar(error, { ruta?, ubicacion?, contexto? })` | Reporta un error atajado a mano (el `catch` de un flujo que igual querés ver). |
+| `setContext({ clave: valor })` | Suma datos a los próximos eventos (`sucursal`, `terminal`…). Sólo escalares; `undefined` saca la clave. |
+| `setUsuario({ id, rol? })` / `limpiarUsuario()` | Quién estaba usando el sistema. |
+| `onErrorQuery` / `onErrorMutation` | Para `QueryCache` / `MutationCache`. De la key se manda sólo el primer elemento si es texto (el nombre de la consulta), como `ubicacion`: el resto puede traer ids o filtros. |
+| `esEsperado(error)` | La misma regla que usa el SDK para no reportar (ver abajo). |
+| `flush()` | Procesa y manda lo pendiente ya. Nunca rechaza. |
+
+## Edge functions (Supabase)
+
+```ts
+import { initMonitor, withHandler } from 'npm:@eiaifactory/monitor@0.1.0/deno';
+
+const monitor = initMonitor({
+  clave: Deno.env.get('MONITOR_CLAVE'),
+  funcion: 'cobrar',
+  release: Deno.env.get('RELEASE'), // si el deploy lo define
+});
+
+Deno.serve(
+  withHandler(
+    monitor,
+    async (req) => {
+      // …la función de siempre
+      return new Response(JSON.stringify(resultado), { headers: corsHeaders });
+    },
+    // Si la función lanza, esto es lo que se devuelve. Con los CORS de la función: sin ellos,
+    // el navegador ve un error de CORS en vez del 500.
+    { aRespuesta: () => new Response('{"error":"interno"}', { status: 500, headers: corsHeaders }) },
+  ),
+);
+```
+
+`withHandler` devuelve la respuesta de la función tal cual y manda **después**, en
+`EdgeRuntime.waitUntil`: el usuario no espera al Monitor. Reporta lo que la función lanza y las
+respuestas 5xx (como `cobrar: respondió 503`, **sin el cuerpo**: puede traer datos). Las 4xx son
+la función contestando que no, y no se reportan. Lo que se capture a mano con
+`monitor.capturar(error)` durante el request también sale al final.
+
+| Opción de `withHandler` | |
+|---|---|
+| `esEsperado(error)` | Además de los esperados de siempre. |
+| `aRespuesta(error)` | La respuesta cuando la función lanza. Default: `500 {"error":"error_interno"}`. |
+
+**Node (Railway u otro servidor):** la misma entrada (`import … from '@eiaifactory/monitor/deno'`),
+con `origen: 'servidor'`. Sin `EdgeRuntime`, el envío sale sin esperarlo.
+
+## Qué no se reporta
+
+Decisión del spec: los rechazos de negocio y los `toast.error` no son incidentes.
+
+- **`PT4xx`**: el `RAISE` de negocio de las funciones de la base (`raise exception using errcode = 'PT402'`).
+- **`AbortError`**: una petición cancelada a propósito.
+- **401 / 403**: sesión vencida o sin permiso. También los `Auth*` de Supabase con status 4xx
+  (contraseña mal escrita, mail sin confirmar).
+- Lo que el cliente declare en `ignorar` (texto contenido en el mensaje, o una regex).
+
+## Frenos del lado del cliente
+
+| | Navegador | Servidor |
+|---|---|---|
+| Colapso | El mismo error en 10 s viaja una vez, con `repeticiones` | — |
+| Tope | 20 eventos nuevos por minuto (`maxPorMinuto`) | — |
+| Ráfaga | Hasta 100 errores esperando a ser procesados; lo que llega con eso lleno se pierde | — |
+| Cola | 50 (`maxBuffer`) en `localStorage`, hasta 128 KB; descarta lo más viejo | 50 en memoria |
+| Envío | Cada 2 s o al juntar 10; lotes de hasta 20 eventos y 60 KB | Al terminar el request |
+| Timeout | 3 s | 2 s |
+| Red caída o 5xx | Espera 1 → 2 → 4 → 30 s | Un reintento |
+| `429` | Espera `Retry-After`; si el navegador no lo puede leer, hasta el próximo minuto | Espera `Retry-After` (hasta 10 s) y reintenta una vez |
+| `413` | Parte el lote a la mitad | Parte el lote a la mitad |
+| `401` | Se apaga hasta la próxima carga | Se apaga |
+
+Un reintento manda los mismos `id_externo`: finance lo cuenta como duplicado, no suma dos veces.
+Al irse de la página (`pagehide`, o la pestaña pasa a segundo plano), lo pendiente se guarda y
+sale en un `fetch` con `keepalive`; si el navegador no lo deja salir, va en la próxima carga.
+
+PII, primera línea (la segunda es finance): los valores de `contexto` cuyas claves parecen
+sensibles (`mail`, `tel`, `phone`, `dni`, `cuit`, `pass`, `token`, `secret`, `key`, `clave`) se
+reemplazan por `[redactado]`; emails y teléfonos se redactan en el mensaje, el stack, la ruta y
+el contexto; la ruta viaja sin query ni hash; un `usuario_id` con `@` se redacta.
+
+## El contrato HTTP v1
+
+Congelado: cambiarlo es versionar (`/v2`), no editar.
+
+**Endpoint.** `POST https://qoyskdjcjyjxcnhruhni.supabase.co/functions/v1/monitor-ingesta`.
+CORS abierto (`*`), `OPTIONS` → 204.
+
+**Auth.** `Authorization: Bearer eiai_mon_<ambiente>_<32 hex>`. La clave es la única autoridad
+sobre proyecto y ambiente: el cuerpo no los declara, y si los declara se ignoran. Nunca en la URL.
+
+**Cuerpo.** Siempre un lote: `{ "eventos": [ … ] }`, **hasta 20 eventos** (los que sobran se
+rechazan uno por uno con `lote_excedido`) y **hasta 64 KB** (si no, `413` y se rechaza entero).
+
+| Campo | Tipo | Req | Tope | Qué es |
+|---|---|---|---|---|
+| `id_externo` | uuid | sí | — | Idempotencia: repetido cuenta como `duplicados`, no suma |
+| `origen` | `browser` · `edge` · `servidor` · `db` · `ci` · `deploy` | sí | — | `latido` es reservado de finance |
+| `mensaje` | string | sí | 1024 | Se recorta, no se rechaza |
+| `ocurrido_at` | ISO-8601 | no | — | Default: cuándo llegó |
+| `tipo_error` | string | no | 128 | `TypeError`, `PostgrestError`, `XX000`… |
+| `codigo` | string | no | 64 | SQLSTATE, status HTTP, code de PostgREST |
+| `stack` | string | no | 8192 | Crudo |
+| `ubicacion` | string | no | 256 | Función edge, nombre del cron, consulta |
+| `ruta` | string | no | 512 | `pathname`, sin query |
+| `release` | string | no | 64 | Sha corto del build |
+| `usuario_id` | string | no | 64 | Id opaco; con `@` se redacta |
+| `rol` | string | no | 64 | |
+| `dispositivo_id` | string | no | 64 | Uuid del dispositivo |
+| `user_agent` | string | no | 512 | |
+| `contexto` | objeto plano de escalares | no | 2 KB | Claves sensibles → `[redactado]` |
+| `repeticiones` | entero ≥ 1 | no | — | Colapso local. Default 1 |
+| `huella_manual` | string | no | 128 | Reemplaza la agrupación calculada (`cron:offers-expire`) |
+
+Los topes son en caracteres. Un texto más largo se recorta con la marca `…[cortado]`.
+
+**Respuestas.**
+
+| Status | Cuerpo | Cuándo |
+|---|---|---|
+| `202` | `{ "recibidos": n, "duplicados": n, "rechazados": [{ "i": 0, "motivo": "…" }] }` | La clave vale. Motivos por evento: `sin_id_externo` · `id_externo_invalido` · `origen_invalido` · `sin_mensaje` · `lote_excedido` · `evento_invalido` |
+| `400` | `{ "error": "cuerpo_invalido" }` | No es JSON o no tiene `eventos[]` |
+| `401` | `{ "error": "clave_invalida" }` | Sin header, clave desconocida o revocada |
+| `413` | `{ "error": "cuerpo_excedido" }` | Más de 64 KB |
+| `429` | `{ "error": "cuota_excedida" }` + `Retry-After` | Cuota por clave y minuto de reloj agotada |
+| `405` | — | Método que no es `POST` ni `OPTIONS` |
+
+Cómo se agrupa (lo hace finance, no el emisor): mismo origen, tipo, mensaje (sin ids, hashes ni
+números) y primer frame del stack (sin el hash del chunk de Vite ni línea y columna) son el mismo
+problema. `huella_manual` reemplaza ese cálculo.
+
+### Con `curl`
+
+```bash
+curl -X POST "https://qoyskdjcjyjxcnhruhni.supabase.co/functions/v1/monitor-ingesta" \
+  -H "Authorization: Bearer $MONITOR_CLAVE" \
+  -H "Content-Type: application/json" \
+  -d "{\"eventos\":[{\"id_externo\":\"$(uuidgen)\",\"origen\":\"ci\",\"mensaje\":\"falló el build\",\"ubicacion\":\"deploy.yml\"}]}"
+```
+
+### Desde un cron de la base (`net.http_post`)
+
+El patrón es envolver cada job en una función que ataja el error y avisa, con la clave en el vault
+del cliente:
+
+```sql
+create or replace function app.run_job(p_fn text)
+returns void
+language plpgsql
+security definer
+set search_path = ''
+as $$
+declare
+  v_estado text;
+  v_mensaje text;
+begin
+  execute format('select %s()', p_fn::regproc);
+exception when others then
+  get stacked diagnostics v_estado = returned_sqlstate, v_mensaje = message_text;
+  -- PT4xx es un rechazo de negocio, no un incidente.
+  if v_estado not like 'PT4%' then
+    perform net.http_post(
+      url := 'https://qoyskdjcjyjxcnhruhni.supabase.co/functions/v1/monitor-ingesta',
+      headers := jsonb_build_object(
+        'Authorization', 'Bearer ' || (select decrypted_secret from vault.decrypted_secrets where name = 'monitor_clave'),
+        'Content-Type', 'application/json'
+      ),
+      body := jsonb_build_object('eventos', jsonb_build_array(jsonb_build_object(
+        'id_externo', gen_random_uuid(),
+        'origen', 'db',
+        'mensaje', v_mensaje,
+        'codigo', v_estado,
+        'ubicacion', p_fn,
+        'huella_manual', 'cron:' || p_fn
+      )))
+    );
+  end if;
+  -- Sin re-raise: `net.http_post` encola en una tabla, y si la transacción se revierte el
+  -- aviso se revierte con ella.
+end;
+$$;
+
+-- select cron.schedule('offers-expire', '*/5 * * * *', $$select app.run_job('app.offers_expire')$$);
+```
+
+## Qué NO hace
+
+- **Sin sourcemaps**: el stack llega minificado; se agrupa igual por frame normalizado.
+- **Sin breadcrumbs, performance ni session replay.** Errores, nada más.
+- **No reintenta los eventos que finance rechaza** en un `202` (`rechazados`): un evento inválido
+  no se arregla reenviándolo.
+- **Varias pestañas comparten la cola guardada**: la última que guarda gana. Se puede perder algo
+  pendiente de una pestaña que se cierra dentro de los 2 s de otra; el resto ya salió.
+- **El envío al irse es un intento**: si el navegador no deja salir el `keepalive`, sale en la
+  próxima carga del mismo dispositivo.
+
+## Desarrollo
+
+```bash
+npm ci
+npm run typecheck
+npm test
+npm run build
+npm run tamano
+```
+
+`tamano` falla si la entrada del navegador pasa de **4 KB gzip** (presupuesto del spec).
+Publicar es crear un tag `vX.Y.Z` igual a la versión de `package.json`: el workflow `publish.yml`
+publica en npm con provenance.
+
+## Licencia
+
+[MIT](LICENSE)

package/dist/browser.d.ts

@@ -0,0 +1,49 @@
+import { V as ValorContexto } from './esperado-Cg2FvrBP.js';
+export { e as esEsperado } from './esperado-Cg2FvrBP.js';
+
+interface OpcionesMonitor {
+    /** `VITE_MONITOR_CLAVE`. Sin clave, el SDK no hace nada (desarrollo local, tests). */
+    clave: string | undefined;
+    /** Por defecto, la ingesta de finance. */
+    url?: string;
+    /** El sha corto del build. */
+    release?: string;
+    /** Mensajes que no se reportan: texto contenido en el mensaje, o una regex. */
+    ignorar?: ReadonlyArray<string | RegExp>;
+    /** Tope de la cola del dispositivo. Default 50. */
+    maxBuffer?: number;
+    /** Tope de eventos nuevos por minuto. Default 20. */
+    maxPorMinuto?: number;
+    /** Loguea a `console.debug` lo que hace. Para integrar, nunca en producción. */
+    debug?: boolean;
+}
+interface Extra {
+    ruta?: string;
+    ubicacion?: string;
+    contexto?: Record<string, ValorContexto>;
+}
+interface Usuario {
+    /** Un id opaco (uuid), nunca un email. */
+    id: string;
+    rol?: string;
+}
+declare function initMonitor(o: OpcionesMonitor): void;
+declare function capturar(error: unknown, extra?: Extra): void;
+/** Suma claves al contexto de los próximos eventos. Una clave en `undefined` se saca. */
+declare function setContext(c: Record<string, ValorContexto | undefined>): void;
+declare function setUsuario(u: Usuario): void;
+declare function limpiarUsuario(): void;
+/** Procesa lo capturado y manda todo lo que haya, ahora. Nunca rechaza. */
+declare function flush(): Promise<void>;
+/** Para `new QueryCache({ onError: onErrorQuery })`. Aditivo: no reemplaza los `onError` de cada query. */
+declare function onErrorQuery(error: unknown, query?: {
+    queryKey?: readonly unknown[];
+}): void;
+/** Para `new MutationCache({ onError: onErrorMutation })`. */
+declare function onErrorMutation(error: unknown, _variables?: unknown, _contexto?: unknown, mutation?: {
+    options?: {
+        mutationKey?: readonly unknown[];
+    };
+}): void;
+
+export { type Extra, type OpcionesMonitor, type Usuario, ValorContexto, capturar, flush, initMonitor, limpiarUsuario, onErrorMutation, onErrorQuery, setContext, setUsuario };

package/dist/browser.js

@@ -0,0 +1,2 @@
+function ue(e){let t=2166136261;for(let n=0;n<e.length;n++)t^=e.charCodeAt(n),t=Math.imul(t,16777619);return t>>>0}function N(e){let t=(e.stack??"").split(`
+`).find(n=>/^\s*at\s|@/.test(n))??"";return ue([e.origen,e.tipo_error??"",e.mensaje,t.trim()].join("|"))}function I(){return{items:[],minuto:0,enMinuto:0}}function L(e,t,n,r,i){let o=N(t),l=e.items.find(v=>!v.v&&v.h===o&&n-v.t<1e4);if(l)return l.e.repeticiones=(l.e.repeticiones??1)+1,"colapsado";let P=Math.floor(n/6e4);return P!==e.minuto&&(e.minuto=P,e.enMinuto=0),e.enMinuto>=i?"tope_por_minuto":(e.enMinuto++,e.items.push({e:t,h:o,t:n}),e.items.length>r&&e.items.splice(0,e.items.length-r),"encolado")}var le=128*1024;function V(e){let t=e.map(({e:i,h:o,t:l})=>JSON.stringify({e:i,h:o,t:l})),n=2,r=t.length;for(;r>0&&(n+t[r-1].length+1)*2<=le;)n+=t[--r].length+1;return`[${t.slice(r).join(",")}]`}function U(e){try{let t=e?JSON.parse(e):[];return Array.isArray(t)?t.filter(n=>!!n&&typeof n=="object"&&!!n.e&&typeof n.e.id_externo=="string"&&typeof n.e.mensaje=="string"&&typeof n.h=="number"&&typeof n.t=="number"):[]}catch{return[]}}var z="https://qoyskdjcjyjxcnhruhni.supabase.co/functions/v1/monitor-ingesta";var s={mensaje:1024,tipo_error:128,codigo:64,stack:8192,ubicacion:256,ruta:512,release:64,usuario_id:64,rol:64,dispositivo_id:64,user_agent:512,huella_manual:128},D="\u2026[cortado]";function g(e,t){return e.length<=t?e:e.slice(0,t-D.length)+D}var k=[1e3,2e3,4e3,3e4],X=e=>new TextEncoder().encode(e).length;function B(e,t=20){let n=[],r=X('{"eventos":[]}');for(let i of e){if(n.length>=t)break;let o=X(JSON.stringify(i.e))+(n.length?1:0);if(n.length&&r+o>61440)break;r+=o,n.push(i)}return n}function de(e){return 6e4-e%6e4}function fe(e,t,n){if(e>=200&&e<300)return{r:"ok"};if(e===429){let r=Number(t);return{r:"cuota",esperaMs:t&&r>0?r*1e3:de(n)}}return e===401?{r:"apagar"}:e===413?{r:"partir"}:e>=500?{r:"reintentar"}:{r:"descartar"}}async function $(e){let t;try{let n=typeof AbortController=="function"?new AbortController:void 0,r=new Promise(o=>{t=setTimeout(()=>{e.debug?.("timeout"),n?.abort(),o({r:"reintentar"})},e.timeoutMs)}),i=(async()=>{try{let o=await fetch(e.url,{method:"POST",headers:{authorization:`Bearer ${e.clave}`,"content-type":"application/json"},body:JSON.stringify({eventos:e.eventos}),keepalive:!!e.keepalive,signal:n?.signal}),l=await o.text();return e.debug?.(o.status,l),fe(o.status,o.headers.get("retry-after"),Date.now())}catch(o){return e.debug?.("sin respuesta",o),{r:"reintentar"}}})();return await Promise.race([i,r])}catch{return{r:"reintentar"}}finally{clearTimeout(t)}}function pe(e){return e.status??e.statusCode??e.context?.status}function J(e){try{if(!e||typeof e!="object")return!1;let t=e;if(t.name==="AbortError"||typeof t.code=="string"&&t.code.startsWith("PT4"))return!0;let n=Number(pe(t));return n===401||n===403?!0:typeof t.name=="string"&&t.name.startsWith("Auth")&&n>=400&&n<500}catch{return!1}}function q(e,t){return t.some(n=>typeof n=="string"?e.includes(n):e.search(n)>=0)}function m(){let e=typeof crypto>"u"?void 0:crypto;if(e&&typeof e.randomUUID=="function")try{return e.randomUUID()}catch{}let t=new Uint8Array(16);if(e&&typeof e.getRandomValues=="function")e.getRandomValues(t);else for(let r=0;r<16;r++)t[r]=Math.random()*256|0;t[6]=t[6]&15|64,t[8]=t[8]&63|128;let n=Array.from(t,r=>r.toString(16).padStart(2,"0")).join("");return`${n.slice(0,8)}-${n.slice(8,12)}-${n.slice(12,16)}-${n.slice(16,20)}-${n.slice(20)}`}var x="[redactado]",ge=/mail|tel|phone|dni|cuit|pass|token|secret|key|clave/i,me=/[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/g,xe=/(^|[^\w.-])\+?\d(?:[\s-]?\d){7,14}(?![\w.-])/g;function R(e){return e.replace(me,x).replace(xe,`$1${x}`)}function K(e){return e===void 0?e:R(e)}function Y(e){let t;if(e.contexto){t={};for(let n of Object.keys(e.contexto)){let r=e.contexto[n];t[n]=ge.test(n)?x:typeof r=="string"?R(r):r}}return{...e,mensaje:R(e.mensaje),stack:K(e.stack),ruta:K(e.ruta),usuario_id:e.usuario_id&&e.usuario_id.includes("@")?x:e.usuario_id,contexto:t}}function u(e,t){if((typeof e=="number"||typeof e=="boolean")&&(e=String(e)),typeof e!="string")return;let n=e.trim();return n?g(n,t):void 0}function be(e){let t=Object.prototype.toString.call(e);if(t==="[object Object]"||t==="[object Array]")try{let n=JSON.stringify(e);if(n&&n!=="{}")return n}catch{}return t}function Ee(e){try{if(e===null||typeof e!="object"&&typeof e!="function")return{mensaje:u(String(e),s.mensaje)??"Error sin mensaje"};let t=e,n=t.context,r=typeof t.code=="string"&&("details"in t||"hint"in t);return{mensaje:u(t.message,s.mensaje)??g(be(t),s.mensaje),tipo_error:u(t.name,s.tipo_error)??(r?"PostgrestError":void 0),codigo:u(t.code??t.status??t.statusCode??n?.status,s.codigo),stack:u(t.stack,s.stack)}}catch{return{mensaje:"Error no legible"}}}function _e(e){if(!e||typeof e!="object")return;let t={};for(let r of Object.keys(e)){let i=e[r];i===null||typeof i=="boolean"?t[r]=i:typeof i=="number"?t[r]=Number.isFinite(i)?i:null:typeof i=="string"&&(t[r]=g(i,256))}let n=Object.keys(t);if(n.length){for(;n.length&&new TextEncoder().encode(JSON.stringify(t)).length>2048;)delete t[n.pop()],t._cortado=!0;return t}}function he(e){return u(e?.split(/[?#]/)[0],s.ruta)}function F(e){return Y({id_externo:m(),origen:e.origen,...Ee(e.error),ocurrido_at:new Date(e.ocurrido).toISOString(),ubicacion:u(e.ubicacion,s.ubicacion),ruta:he(e.ruta),release:u(e.release,s.release),usuario_id:u(e.usuario_id,s.usuario_id),rol:u(e.rol,s.rol),dispositivo_id:u(e.dispositivo_id,s.dispositivo_id),user_agent:u(e.user_agent,s.user_agent),contexto:_e(e.contexto),repeticiones:1})}var ee="eiai_monitor_cola",Z="eiai_monitor_dispositivo",te=2e3,ne=10,ve=3e3,Oe=100,a,b=[],c,f,T={},M,y=!1,w=!1,d,G=0,W,E=!1,H=0,C=0,S=20;function p(...e){try{a?.debug&&console.debug("[monitor]",...e)}catch{}}function Q(e){try{return localStorage.getItem(e)}catch{return null}}function re(e,t){try{localStorage.setItem(e,t)}catch{}}function Fe(e){try{if(a)return;if(typeof window>"u"||!e?.clave){e?.debug&&console.debug("[monitor] no-op: sin clave");return}a={clave:e.clave,url:e.url??z,release:e.release,ignorar:e.ignorar??[],maxBuffer:e.maxBuffer??50,maxPorMinuto:e.maxPorMinuto??20,debug:!!e.debug},addEventListener("error",ke),addEventListener("unhandledrejection",Re),addEventListener("pagehide",ie),document.addEventListener("visibilitychange",Se),ae(),p("iniciado",a.url)}catch{}}function h(e,t){try{if(!a||E||y||b.length>=Oe)return;b.push({error:e,extra:t,t:Date.now(),ruta:location.pathname,contexto:T,usuario:M}),ae()}catch{}}function Ze(e){try{T={...T,...e}}catch{}}function Ge(e){M=e}function We(){M=void 0}async function He(){try{if(!a)return;for(_();;){let e=await j();if(!e||e.r!=="ok"&&e.r!=="descartar"&&e.r!=="partir")return}}catch{}}function Qe(e,t){try{h(e,{ubicacion:oe(t?.queryKey)})}catch{}}function et(e,t,n,r){try{h(e,{ubicacion:oe(r?.options?.mutationKey)})}catch{}}function oe(e){return Array.isArray(e)&&typeof e[0]=="string"?e[0]:void 0}function ke(e){try{h(e.error??{message:e.message,stack:e.filename?`at ${e.filename}:${e.lineno}:${e.colno}`:void 0})}catch{}}function Re(e){try{h(e.reason)}catch{}}function ie(){try{_(),clearTimeout(d),d=void 0,j(!0)}catch{}}function Se(){document.visibilityState==="hidden"&&ie()}function ae(){w||(w=!0,typeof requestIdleCallback=="function"?requestIdleCallback(_,{timeout:1e3}):setTimeout(_,0))}function Te(){return c||(c=I(),c.items=U(Q(ee)),f=Q(Z)??void 0,f||(f=m(),re(Z,f)),c.items.length&&p("recuperados",c.items.length),c)}function se(){c&&re(ee,V(c.items))}function _(){if(w=!1,!(!a||y)){y=!0;try{let e=Te(),t=b;b=[];let n=0;for(let r of t)try{if(J(r.error))continue;let i=F({error:r.error,origen:"browser",ocurrido:r.t,ruta:r.extra?.ruta??r.ruta,ubicacion:r.extra?.ubicacion,release:a.release,usuario_id:r.usuario?.id,rol:r.usuario?.rol,dispositivo_id:f,user_agent:navigator.userAgent,contexto:{...r.contexto,...r.extra?.contexto}});if(q(i.mensaje,a.ignorar))continue;let o=L(e,i,r.t,a.maxBuffer,a.maxPorMinuto);p(o,i.mensaje),o!=="tope_por_minuto"&&n++}catch{}n&&se(),e.items.length&&A(e.items.length>=ne?0:te)}catch{}finally{y=!1}}}function A(e){if(E)return;let t=Math.max(Date.now()+e,C);if(d!==void 0){if(t>=G)return;clearTimeout(d)}G=t,d=setTimeout(()=>{d=void 0,j()},t-Date.now())}function j(e=!1){return W??(W=we(e).catch(()=>{}).finally(()=>{W=void 0}))}async function we(e){try{if(!a||!c||E)return;let t=c;if(Date.now()<C){A(0);return}let n=B(t.items,S);if(!n.length)return;for(let o of n)o.v=!0;let r=await $({url:a.url,clave:a.clave,eventos:n.map(o=>o.e),timeoutMs:ve,keepalive:e,debug:a.debug?p:void 0});for(let o of n)o.v=!1;let i=()=>{t.items=t.items.filter(o=>!n.includes(o))};return r.r==="ok"||r.r==="descartar"||r.r==="partir"&&n.length===1?(i(),r.r==="ok"&&(H=0),S=20):r.r==="partir"?S=n.length>>1:r.r==="apagar"?(E=!0,clearTimeout(d),p("clave rechazada: apagado")):C=Date.now()+(r.r==="cuota"?r.esperaMs:k[Math.min(H++,k.length-1)]),se(),t.items.length&&A(t.items.length>=ne||r.r!=="ok"&&r.r!=="descartar"?0:te),r}catch{return}}export{h as capturar,J as esEsperado,He as flush,Fe as initMonitor,We as limpiarUsuario,et as onErrorMutation,Qe as onErrorQuery,Ze as setContext,Ge as setUsuario};

package/dist/deno.d.ts

@@ -0,0 +1,41 @@
+import { V as ValorContexto } from './esperado-Cg2FvrBP.js';
+export { e as esEsperado } from './esperado-Cg2FvrBP.js';
+
+interface OpcionesServidor {
+    /** El secreto `MONITOR_CLAVE`. Sin clave, no hace nada. */
+    clave: string | undefined;
+    /** Por defecto, la ingesta de finance. */
+    url?: string;
+    release?: string;
+    /** El nombre de la función: va como `ubicacion` de cada evento. */
+    funcion: string;
+    /** `edge` (default) o `servidor` (Node, Railway). */
+    origen?: 'edge' | 'servidor';
+}
+interface Extra {
+    ruta?: string;
+    ubicacion?: string;
+    contexto?: Record<string, ValorContexto>;
+}
+interface Monitor {
+    readonly funcion: string;
+    capturar(error: unknown, extra?: Extra): void;
+    /** Manda lo capturado: 2 s por intento y un reintento. Nunca rechaza. */
+    flush(): Promise<void>;
+}
+declare function initMonitor(o: OpcionesServidor): Monitor;
+interface OpcionesHandler {
+    /** Además de los esperados de siempre (PT4xx, AbortError, 401/403). */
+    esEsperado?: (error: unknown) => boolean;
+    /** La respuesta cuando la función lanza (con los headers de CORS de la función). Default: 500 JSON. */
+    aRespuesta?: (error: unknown) => Response;
+}
+/**
+ * Envuelve el handler de `Deno.serve`. Si responde, devuelve esa respuesta tal cual y reporta
+ * las 5xx (sin el cuerpo: puede traer datos). Si lanza, lo reporta y devuelve `aRespuesta(error)`
+ * o un 500 JSON. Al final manda todo lo capturado en el request, también lo que la función
+ * capturó a mano antes de contestar un 200.
+ */
+declare function withHandler<A extends unknown[]>(monitor: Monitor, handler: (req: Request, ...args: A) => Response | Promise<Response>, opciones?: OpcionesHandler): (req: Request, ...args: A) => Promise<Response>;
+
+export { type Extra, type Monitor, type OpcionesHandler, type OpcionesServidor, ValorContexto, initMonitor, withHandler };

package/dist/deno.js

@@ -0,0 +1 @@
+var E="https://qoyskdjcjyjxcnhruhni.supabase.co/functions/v1/monitor-ingesta";var s={mensaje:1024,tipo_error:128,codigo:64,stack:8192,ubicacion:256,ruta:512,release:64,usuario_id:64,rol:64,dispositivo_id:64,user_agent:512,huella_manual:128},m="\u2026[cortado]";function l(e,t){return e.length<=t?e:e.slice(0,t-m.length)+m}var x=e=>new TextEncoder().encode(e).length;function _(e,t=20){let n=[],r=x('{"eventos":[]}');for(let i of e){if(n.length>=t)break;let o=x(JSON.stringify(i.e))+(n.length?1:0);if(n.length&&r+o>61440)break;r+=o,n.push(i)}return n}function T(e){return 6e4-e%6e4}function S(e,t,n){if(e>=200&&e<300)return{r:"ok"};if(e===429){let r=Number(t);return{r:"cuota",esperaMs:t&&r>0?r*1e3:T(n)}}return e===401?{r:"apagar"}:e===413?{r:"partir"}:e>=500?{r:"reintentar"}:{r:"descartar"}}async function b(e){let t;try{let n=typeof AbortController=="function"?new AbortController:void 0,r=new Promise(o=>{t=setTimeout(()=>{e.debug?.("timeout"),n?.abort(),o({r:"reintentar"})},e.timeoutMs)}),i=(async()=>{try{let o=await fetch(e.url,{method:"POST",headers:{authorization:`Bearer ${e.clave}`,"content-type":"application/json"},body:JSON.stringify({eventos:e.eventos}),keepalive:!!e.keepalive,signal:n?.signal}),a=await o.text();return e.debug?.(o.status,a),S(o.status,o.headers.get("retry-after"),Date.now())}catch(o){return e.debug?.("sin respuesta",o),{r:"reintentar"}}})();return await Promise.race([i,r])}catch{return{r:"reintentar"}}finally{clearTimeout(t)}}function j(e){return e.status??e.statusCode??e.context?.status}function h(e){try{if(!e||typeof e!="object")return!1;let t=e;if(t.name==="AbortError"||typeof t.code=="string"&&t.code.startsWith("PT4"))return!0;let n=Number(j(t));return n===401||n===403?!0:typeof t.name=="string"&&t.name.startsWith("Auth")&&n>=400&&n<500}catch{return!1}}function R(){let e=typeof crypto>"u"?void 0:crypto;if(e&&typeof e.randomUUID=="function")try{return e.randomUUID()}catch{}let t=new Uint8Array(16);if(e&&typeof e.getRandomValues=="function")e.getRandomValues(t);else for(let r=0;r<16;r++)t[r]=Math.random()*256|0;t[6]=t[6]&15|64,t[8]=t[8]&63|128;let n=Array.from(t,r=>r.toString(16).padStart(2,"0")).join("");return`${n.slice(0,8)}-${n.slice(8,12)}-${n.slice(12,16)}-${n.slice(16,20)}-${n.slice(20)}`}var p="[redactado]",A=/mail|tel|phone|dni|cuit|pass|token|secret|key|clave/i,M=/[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/g,N=/(^|[^\w.-])\+?\d(?:[\s-]?\d){7,14}(?![\w.-])/g;function g(e){return e.replace(M,p).replace(N,`$1${p}`)}function O(e){return e===void 0?e:g(e)}function v(e){let t;if(e.contexto){t={};for(let n of Object.keys(e.contexto)){let r=e.contexto[n];t[n]=A.test(n)?p:typeof r=="string"?g(r):r}}return{...e,mensaje:g(e.mensaje),stack:O(e.stack),ruta:O(e.ruta),usuario_id:e.usuario_id&&e.usuario_id.includes("@")?p:e.usuario_id,contexto:t}}function u(e,t){if((typeof e=="number"||typeof e=="boolean")&&(e=String(e)),typeof e!="string")return;let n=e.trim();return n?l(n,t):void 0}function C(e){let t=Object.prototype.toString.call(e);if(t==="[object Object]"||t==="[object Array]")try{let n=JSON.stringify(e);if(n&&n!=="{}")return n}catch{}return t}function V(e){try{if(e===null||typeof e!="object"&&typeof e!="function")return{mensaje:u(String(e),s.mensaje)??"Error sin mensaje"};let t=e,n=t.context,r=typeof t.code=="string"&&("details"in t||"hint"in t);return{mensaje:u(t.message,s.mensaje)??l(C(t),s.mensaje),tipo_error:u(t.name,s.tipo_error)??(r?"PostgrestError":void 0),codigo:u(t.code??t.status??t.statusCode??n?.status,s.codigo),stack:u(t.stack,s.stack)}}catch{return{mensaje:"Error no legible"}}}function L(e){if(!e||typeof e!="object")return;let t={};for(let r of Object.keys(e)){let i=e[r];i===null||typeof i=="boolean"?t[r]=i:typeof i=="number"?t[r]=Number.isFinite(i)?i:null:typeof i=="string"&&(t[r]=l(i,256))}let n=Object.keys(t);if(n.length){for(;n.length&&new TextEncoder().encode(JSON.stringify(t)).length>2048;)delete t[n.pop()],t._cortado=!0;return t}}function I(e){return u(e?.split(/[?#]/)[0],s.ruta)}function w(e){return v({id_externo:R(),origen:e.origen,...V(e.error),ocurrido_at:new Date(e.ocurrido).toISOString(),ubicacion:u(e.ubicacion,s.ubicacion),ruta:I(e.ruta),release:u(e.release,s.release),usuario_id:u(e.usuario_id,s.usuario_id),rol:u(e.rol,s.rol),dispositivo_id:u(e.dispositivo_id,s.dispositivo_id),user_agent:u(e.user_agent,s.user_agent),contexto:L(e.contexto),repeticiones:1})}var X=2e3,U=50;function D(e){return new Promise(t=>setTimeout(t,e))}function re(e){let t=[],n=!e.clave,r,i=a=>b({url:e.url??E,clave:e.clave??"",eventos:a,timeoutMs:X});async function o(){let a=20;for(;t.length&&!n;){let c=_(t.map(f=>({e:f})),a).map(f=>f.e),d=await i(c);if((d.r==="reintentar"||d.r==="cuota")&&(await D(d.r==="cuota"?Math.min(d.esperaMs,1e4):1e3),d=await i(c)),d.r==="apagar"){n=!0,t.length=0;return}if(d.r==="partir"&&c.length>1){a=c.length>>1;continue}t.splice(0,c.length)}}return{funcion:e.funcion,capturar(a,c){try{if(n||h(a))return;t.length>=U&&t.shift(),t.push(w({error:a,origen:e.origen??"edge",ocurrido:Date.now(),ruta:c?.ruta,ubicacion:c?.ubicacion??e.funcion,release:e.release,contexto:c?.contexto}))}catch{}},flush(){return r??(r=o().catch(()=>{}).finally(()=>{r=void 0}))}}}function $(e){let t=e.flush();try{globalThis.EdgeRuntime?.waitUntil(t)}catch{}}function k(e){try{return new URL(e.url).pathname}catch{return}}function z(e,t){try{if(t.aRespuesta)return t.aRespuesta(e)}catch{}return new Response(JSON.stringify({error:"error_interno"}),{status:500,headers:{"content-type":"application/json"}})}function oe(e,t,n={}){return async(r,...i)=>{try{let o=await t(r,...i);return o.status>=500&&e.capturar({name:"HttpError",message:`${e.funcion}: respondi\xF3 ${o.status}`,status:o.status},{ruta:k(r)}),o}catch(o){let a=!1;try{a=!!n.esEsperado?.(o)}catch{}return a||e.capturar(o,{ruta:k(r)}),z(o,n)}finally{$(e)}}}export{h as esEsperado,re as initMonitor,oe as withHandler};

package/dist/esperado-Cg2FvrBP.d.ts

@@ -0,0 +1,11 @@
+type ValorContexto = string | number | boolean | null;
+
+/**
+ * - `PT4xx`: el `RAISE` de negocio de las funciones de la base, que PostgREST devuelve como 4xx.
+ * - `AbortError`: una petición cancelada a propósito (el usuario se fue, un timeout del cliente).
+ * - 401/403: sesión vencida o sin permiso. Y los `Auth*` de Supabase con status < 500
+ *   (contraseña mal escrita, mail sin confirmar): son del usuario, no del sistema.
+ */
+declare function esEsperado(error: unknown): boolean;
+
+export { type ValorContexto as V, esEsperado as e };

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@eiaifactory/monitor",
+  "version": "0.1.0",
+  "description": "Manda los errores de un sistema de cliente al Monitor de EI AI Factory, sin que el usuario final lo note.",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eiaifactory/monitor.git"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/browser.d.ts",
+      "default": "./dist/browser.js"
+    },
+    "./deno": {
+      "types": "./dist/deno.d.ts",
+      "default": "./dist/deno.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "tamano": "node scripts/tamano.mjs"
+  },
+  "devDependencies": {
+    "happy-dom": "^20.14.5",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.11"
+  }
+}