[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_434":435,"_436":437},"routes/_app.x.$handle.$name",{"_102":101,"_32":46,"_111":92,"_27":54,"_13":14,"_112":-5,"_11":113,"_114":115,"_116":117,"_118":119,"_120":121,"_20":-5,"_122":-5,"_123":-5,"_124":25,"_125":126,"_127":61,"_128":-5,"_129":-5,"_130":131},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_44":45,"_32":46,"_39":47,"_48":-5,"_49":25,"_50":51,"_52":51,"_53":54,"_55":56,"_18":57,"_58":59,"_60":61,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":76,"_77":76,"_78":79,"_80":79,"_81":79,"_82":76,"_83":76,"_84":85,"_86":87,"_88":89,"_90":25},"version",172,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":33,"_34":38,"_36":37,"_39":40,"_41":14,"_42":43,"_24":25},"previous",{"_30":31,"_32":33,"_34":35,"_36":37},"deleted",false,"deletedHere","path","Jueves/end_shift.ts","latestPath","fileId","beb2b528-7d6d-11f1-9b3d-1607ee4eb77e","name","end_shift.ts","fileType","interval","content","import { correrMarca } from \"../lib/marcar.ts\";\n\nexport default async function () {\n await correrMarca(\"end_shift\", \"endShift\");\n}\n","script","createdAt",["D",1788903469466],"branchVersion","branchId","30cbc78c-cff5-4fe3-bc71-806e0641630e","id","e9d3fdd1-b457-4125-b49e-3e43c1fb9039","marcador_ECP",["D",1783559151130],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","","imageUrl","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/29f5f583-131f-497d-e50e-ddf403000300/square512?exp=1789534799&sig=6a2013995972edeb6902b1190ffa6eeabfab85b5a35dbeb55e9407ef10cc37d9","271a8711-2eaf-4506-be8c-a4f2f7f5d754","pinnedFileId","df6f1b3a-ab08-11f1-99a6-1607ee4eb77e","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",0,"orgId","019f4467-4f94-751c-9326-5246127153df","tursoName","e9d3fdd1b4574125b49e3e43c1fb9039","tursoHostname","e9d3fdd1b4574125b49e3e43c1fb9039-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789524079207],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_102":101,"_110":106},"org",{"_102":101,"_103":104,"_105":106,"_18":57,"_107":108,"_109":25},"branch",{"_13":91,"_32":92,"_44":43,"_93":45,"_94":-5,"_95":-5,"_96":-5,"_97":-5,"_98":-5,"_99":46,"_100":101},"isOwned",177,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","elgmg","handle","displayName","Justin Venegas Sandoval","avatar","https://lh3.googleusercontent.com/a/ACg8ocKS0OCssHDlSAwsFE5GJkZmO3PiUcnp0G6qA6PncFRdvIPaqlzQZA=s96-c","tier","free","canRestrictVals","profileImageUrl","branchName","adoptOrgId",{"_44":45,"_32":46,"_39":429,"_48":-5,"_49":25,"_50":51,"_52":51,"_53":54,"_55":56,"_18":57,"_58":59,"_60":61,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":430,"_74":-5,"_75":76,"_77":76,"_78":79,"_80":79,"_81":79,"_82":76,"_83":76,"_84":431,"_86":432,"_88":433,"_90":25},"tree",[207,212,217,222,227,229,234,239],"files",[207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222,223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238,239],"counts",{"_195":65,"_196":197,"_198":65,"_199":200,"_201":202},"contents",[132,133,134,135,136,137,138,139],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_44":189,"_32":190,"_30":191,"_143":-5,"_42":43,"_41":192,"_145":61,"_39":193,"_13":65,"_34":156,"_36":-5,"_24":25,"_149":-5,"_27":194},{"_44":182,"_32":183,"_30":184,"_143":-5,"_42":43,"_41":185,"_145":61,"_39":186,"_13":187,"_34":156,"_36":-5,"_24":25,"_149":-5,"_27":188},{"_44":176,"_32":177,"_30":178,"_143":-5,"_42":43,"_41":179,"_145":61,"_39":180,"_13":65,"_34":156,"_36":-5,"_24":25,"_149":-5,"_27":181},{"_44":170,"_32":171,"_30":172,"_143":-5,"_42":43,"_41":173,"_145":61,"_39":174,"_13":65,"_34":156,"_36":-5,"_24":25,"_149":-5,"_27":175},{"_44":164,"_32":165,"_30":166,"_143":-5,"_42":43,"_41":167,"_145":61,"_39":168,"_13":65,"_34":156,"_36":-5,"_24":25,"_149":-5,"_27":169},{"_44":158,"_32":159,"_30":160,"_143":-5,"_42":43,"_41":161,"_145":61,"_39":162,"_13":65,"_34":156,"_36":-5,"_24":25,"_149":-5,"_27":163},{"_44":151,"_32":152,"_30":153,"_143":-5,"_42":43,"_41":154,"_145":61,"_39":155,"_13":65,"_34":156,"_36":-5,"_24":25,"_149":-5,"_27":157},{"_44":140,"_32":141,"_30":142,"_143":-5,"_42":43,"_41":144,"_145":61,"_39":146,"_13":147,"_34":20,"_36":148,"_24":25,"_149":-5,"_27":150},"212108ab-2cd5-46bd-906c-8f9c818835fd","README.md","109c2048-7b40-11f1-bba4-1607ee4eb77e","parentId",153,"latest",["D",1788820284381],14,"# ⏰ Marcador automático\n\nRegistra marcas de asistencia de forma programada, sin intervención manual.\nCorre solo en Val.town.\n\n---\n\n## ✨ Qué hace\n\n- 🔐 Se autentica contra un **proveedor de identidad (OIDC)** y obtiene un token\n fresco en cada corrida.\n- 🕒 Envía la marca al **endpoint del sistema** a la hora programada.\n- 🎲 **Hora humana, no robótica:** en vez de marcar al segundo exacto, espera un\n tiempo aleatorio (jitter) antes de marcar, para que no caiga siempre igual.\n- ♻️ **Idempotente:** antes de marcar consulta el estado del día. Si esa marca ya\n existe, no la repite (evita duplicados y errores de secuencia).\n- 📧 **Alerta por correo:** si una corrida falla, envía un correo con el error.\n- 🔒 **Sin secretos en el código:** todas las credenciales viven en Environment\n Variables, nunca en el código.\n\n---\n\n## 🧩 Cómo funciona\n\n```\nCron dispara ─► espera aleatoria (jitter) ─► login OIDC (token fresco)\n │ │\n └───────────────────────────────────► ¿ya marcó hoy? ─sí─► fin\n │no\n ▼\n POST marca ✅\n```\n\n> El token se pide **después** de la espera, porque los tokens duran pocos\n> minutos. Así siempre es válido al momento de marcar.\n\n---\n\n## 🗂️ Estructura\n\nUna carpeta por día laboral, y dentro las cuatro marcas del día. Cada archivo es\nun cron independiente (Val.town permite un solo horario por archivo).\n\n```\nLunes/ → 4 marcas\nMartes/ → 4 marcas\nMiercoles/ → 4 marcas\nJueves/ → 4 marcas\nViernes/ → 4 marcas\n```\n\nToda la lógica (login, chequeo de ausencia, idempotencia, POST y alerta por\ncorreo) vive en `lib/marcar.ts`. Cada uno de los 20 archivos es solo un cron que\nllama `correrMarca(ACTION, FIELD)` con su tipo de marca; lo único propio de cada\narchivo es esa línea y su expresión cron. El horario varía por día de la semana;\nsumado al jitter de segundos, la marca nunca cae exactamente a la misma hora.\n\n```\nlib/marcar.ts → lógica compartida por las 20 marcas\nlib/ausencias.ts → chequeo de vacaciones/permisos\n```\n\n---\n\n## ⚙️ Configuración (Environment Variables)\n\nSe definen una sola vez y las comparten todos los archivos. Los valores son\nprivados; aquí solo se documentan los nombres.\n\n| Variable | Descripción |\n| ------------- | ---------------------------------- |\n| `API_BASE` | Base URL del sistema (sin `/` final) |\n| `KC_URL` | Servidor del proveedor de identidad |\n| `KC_REALM` | Realm |\n| `KC_CLIENT` | Client ID |\n| `KC_USER` | Usuario |\n| `KC_PASS` | Contraseña |\n| `EMPLOYEE_ID` | Identificador interno |\n| `FACE_DESCRIPTOR` | Descriptor facial: array JSON de 128 números |\n| `SUPERVISOR_TOKEN` | Token que protege `Supervisor/endpoint.ts` (ver § Supervisor) |\n| `HC_PING_URL` | Dead man's switch de healthchecks.io (opcional) |\n\n> **`FACE_DESCRIPTOR`:** desde el 2026-09-04 el endpoint de marca exige\n> verificación facial y rechaza el POST con\n> `\"Esta marca requiere verificación facial\"` si no lo mandas. Es un dato\n> biométrico, así que vive en Environment Variables y no en el código (este val\n> es público). Para cambiarlo: abre el marcador en el navegador, copia el\n> `faceDescriptor` del payload que envía y pega el array completo (con\n> corchetes) en la variable. Se valida al arrancar: si no son 128 números, la\n> corrida falla con un mensaje claro en vez de un 400 del servidor.\n\n---\n\n## 🌴 Ausencias y vacaciones\n\nPara que un día no se marque (vacaciones, incapacidad, permiso) **no hay que\ndesactivar los 4 crons a mano**. Basta con agregar un registro a la tabla\n`ausencias`. Antes de marcar, cada cron consulta si el día de hoy (hora local\nUTC−6) cae dentro de algún rango registrado; si es así, no marca y lo deja en el\nlog.\n\nLa lógica del chequeo vive en un solo lugar (`lib/ausencias.ts`) y la comparten\nlas 20 marcas.\n\n### 🗃️ Tabla `ausencias`\n\n| Columna | Tipo | Formato / valores | Descripción |\n| -------------- | ----------------------------- | ------------------------------------- | -------------------------------------------- |\n| `id` | `INTEGER PK AUTOINCREMENT` | automático | Identificador |\n| `fecha_inicio` | `TEXT` **NOT NULL** | `'YYYY-MM-DD'` | Primer día de la ausencia |\n| `fecha_fin` | `TEXT` **NOT NULL** | `'YYYY-MM-DD'` | Último día, **inclusive** (día suelto = inicio) |\n| `tipo` | `TEXT` **NOT NULL** | `'vacacion'` \\| `'incapacidad'` \\| `'permiso'` | Tipo de ausencia |\n| `comentario` | `TEXT` | texto libre (opcional) | Nota |\n| `created_at` | `TEXT` | autocompletado | Fecha/hora de creación (UTC) |\n\n> Las fechas se comparan como texto `'YYYY-MM-DD'`, que en ese formato ordena\n> igual cronológicamente, así el chequeo es un simple `BETWEEN`.\n>\n> `created_at` se autocompleta solo: si lo omites usa el `DEFAULT`, y si lo dejas\n> en `NULL` un trigger (`ausencias_set_created_at`) lo rellena con la hora actual.\n\n### ➕ Cómo agregar una ausencia\n\nDesde la consola SQL del val:\n\n```sql\n-- Un rango de vacaciones (una sola fila cubre todos los días):\nINSERT INTO ausencias (fecha_inicio, fecha_fin, tipo, comentario)\nVALUES ('2026-08-03', '2026-08-07', 'vacacion', 'Vacaciones de agosto');\n\n-- Un día suelto (inicio = fin):\nINSERT INTO ausencias (fecha_inicio, fecha_fin, tipo, comentario)\nVALUES ('2026-08-15', '2026-08-15', 'permiso', 'Cita médica');\n```\n\nPara cancelar una ausencia, borra su fila (`DELETE FROM ausencias WHERE id = ?`).\n\n---\n\n## 🛟 Supervisor de marcas\n\nLos 20 crons **marcan**; el supervisor **verifica que se haya marcado** y repara\nsi no. Existe porque los crons del plan gratuito son *best effort*: el\n2026-09-07 el `end_lunch` no se ejecutó (cero traces, cero logs) y, al no haber\nejecución, tampoco hubo excepción ni correo de alerta.\n\nCorre una vez por marca, a una hora fija posterior al último horario posible de\nesa marca en la semana. **Sin jitter**: no simula comportamiento humano, es una\nreparación que ya va tarde por definición.\n\n| Marca | Objetivo (UTC) | Supervisor | Local | Límite |\n| ------------- | -------------- | ------------- | ------- | ------ |\n| `start_shift` | 13:57 | `0 14 * * 1-5` | 8:00 am | 40 min |\n| `start_lunch` | 19:02 | `5 19 * * 1-5` | 1:05 pm | 30 min |\n| `end_lunch` | 19:56 | `0 20 * * 1-5` | 2:00 pm | 20 min |\n| `end_shift` | 23:07 | `10 23 * * 1-5` | 5:10 pm | 45 min |\n\nEl **objetivo** es la corrida más tardía de la semana para esa marca; así bastan\n4 constantes en `lib/supervisor.ts` en vez de duplicar los 20 horarios.\n\nEl **límite** es lo que impide reparaciones absurdas. Si la marca lleva más\nretraso que su límite, el supervisor **no marca** y solo alerta: reponer un\n`end_lunch` con hora y media de retraso crea un almuerzo de más de dos horas,\nque dispara anomalías en las métricas. El `end_lunch` tiene el límite más corto\npor eso mismo. Y si todavía **no llegó** la hora objetivo, tampoco marca: el\nsupervisor solo repara el pasado.\n\n### 🔌 Por qué vive en dos vals\n\nEl plan gratuito permite **10 crons por val** y este ya tiene 20 (creados antes\nde que se aplicara el tope: siguen corriendo, pero no admiten uno más). Los\nsupervisores viven en el val **`elgmg/marcador_ECP_supervisor`**, que estrena su\npropio cupo.\n\n```\nmarcador_ECP_supervisor marcador_ECP\n 4 crons ──── HTTP + token ────► Supervisor/endpoint.ts\n └─► lib/supervisor.ts\n```\n\nLa lógica se ejecuta **aquí**, no allá: así las credenciales, el\n`FACE_DESCRIPTOR` y la tabla `ausencias` (privada de cada val) no se duplican.\nEl val de supervisores no sabe nada del marcador, solo dispara. Los archivos\n`http` no consumen cupo de crons.\n\n`SUPERVISOR_TOKEN` protege el endpoint (es público) y debe ser **idéntico en los\ndos vals**.\n\n### 🚨 Vigilante externo (dead man's switch)\n\nEl correo solo avisa de lo que **sí** se ejecutó. El caso que dejó a la vista el\n2026-09-07 es el contrario: no corrió nada, así que nadie avisó. Para eso está\n`HC_PING_URL` (healthchecks.io): cada corrida del supervisor hace ping, y si el\nping **no llega**, healthchecks manda el aviso.\n\nEl ping sale desde este val, no desde el de crons, porque así cubre la cadena\ncompleta: tanto si Val Town no ejecuta el val supervisor como si este val no\nresponde, el ping falta igual.\n\n- Corrida normal → `POST` a la URL con una línea de detalle (`end_lunch: verificada`).\n- Corrida fallida → `POST` a `/fail`.\n- Sin `HC_PING_URL` configurada, el ping se omite y todo lo demás funciona igual.\n El ping nunca lanza ni bloquea: tiene 5 s de timeout y su fallo solo se anota\n en el log.\n\n> **Ojo al configurar el check:** es **un solo check para las 4 marcas**, así que\n> detecta que el supervisor dejó de correr, no cuál de los cuatro faltó. Y los\n> crons son de lunes a viernes: un schedule de \"1 día\" daría falsa alarma cada\n> sábado. Con un único check, lo razonable es modo *cron* `10 23 * * 1-5` (el\n> último supervisor del día) con una hora de gracia. Para cobertura por marca\n> harían falta 4 checks.\n\n### 📓 Bitácora (`supervisor_eventos`)\n\nLos logs de Val Town se retienen **3 días** en el plan gratuito, así que esta\ntabla es el único histórico de cuántas veces la plataforma se salta un cron. Es\nel dato que hoy no existe y que haría falta para decidir si algún día conviene\nmover el marcador fuera de Val Town.\n\nSe registran **todas** las corridas, no solo las incidencias: sin el total no\nhay denominador para calcular una tasa de fallo. Son 4 filas por día hábil.\n\n| Columna | Contenido |\n| ------------- | ---------------------------------------------------------- |\n| `fecha` | `'YYYY-MM-DD'` local (UTC−6) |\n| `hora_utc` | Instante ISO de la corrida |\n| `accion` | `start_shift` \\| `start_lunch` \\| `end_lunch` \\| `end_shift` |\n| `resultado` | `verificada` \\| `recuperada` \\| `fuera_de_ventana` \\| `aun_no_es_hora` \\| `ausencia` \\| `jornada_repuesta` \\| `error` |\n| `retraso_min` | Minutos respecto a la hora objetivo |\n| `detalle` | Texto libre (máx. 500 caracteres) |\n\nEn `verificada`, `retraso_min` mide **cuánto tardó realmente el cron de ese\ndía**: es la medición continua de la puntualidad de la plataforma. Puede salir\nnegativo, porque el objetivo es el peor caso de la semana y no el horario de\nhoy.\n\nLa tabla se crea sola (`CREATE TABLE IF NOT EXISTS` en la primera corrida del\nworker), y si el `INSERT` falla solo se anota en el log: la bitácora nunca debe\nimpedir que una marca se recupere.\n\n```sql\n-- ¿Cuántas veces falló la plataforma este mes?\nSELECT resultado, COUNT(*) FROM supervisor_eventos\nWHERE fecha >= '2026-09-01' GROUP BY resultado;\n\n-- Puntualidad de los crons de marca: retraso medio y peor caso\nSELECT accion, ROUND(AVG(retraso_min), 1) AS medio, MAX(retraso_min) AS peor\nFROM supervisor_eventos WHERE resultado = 'verificada' GROUP BY accion;\n\n-- Todo lo que no fue rutina\nSELECT * FROM supervisor_eventos\nWHERE resultado NOT IN ('verificada', 'ausencia') ORDER BY id DESC;\n```\n\n### 📬 Qué esperar\n\n| Situación | Qué hace |\n| ------------------------------- | -------------------------------------------- |\n| La marca está | Log `✅ verificada`. **Sin correo**: si escribiera cada día, dejarías de leerlo |\n| La misma situación se repite | Log `🔁 ya se avisó hoy`. **Máximo un correo por marca y desenlace al día**: la bitácora es la memoria que lo impide |\n| Falta, dentro de la ventana | La marca y avisa: `🛟 recuperada` |\n| Falta, fuera de ventana | **No marca**, avisa para que decidas |\n| Aún no es hora | No hace nada |\n| Falta la jornada completa | Repone `start_shift` y avisa: la otra marca no se puede encadenar (cooldown de 5 min del backend) |\n| Rostro rechazado | Correo distinto: hay que renovar `FACE_DESCRIPTOR`, reintentar no sirve |\n\n---\n\n## 🩺 Cómo leer los logs\n\n| En los logs verás… | Significa |\n| --------------------------------- | ------------------------------------------- |\n| `✅ … registrada` | Marcó correctamente 🎉 |\n| `↩️ Ya existe … hoy; no se marca` | Ya estaba marcado; no duplicó (correcto) |\n| `🌴 Ausencia hoy (…); no se marca` | Hoy cae en un rango de la tabla `ausencias` (correcto) |\n| `Login … falló … unauthorized_client` | El proveedor no acepta ese tipo de login |\n| `Marca … falló (HTTP 4xx)` | Token o permisos incorrectos |\n| `… requiere verificación facial` | Falta o está mal `FACE_DESCRIPTOR` |\n\n---\n\n## 📝 Notas\n\n- **Jitter:** el código espera 0–50 segundos aleatorios antes de marcar. En el\n plan gratuito de Val.town cada corrida está limitada a ~1 minuto, por lo que la\n ventana de variación se mantiene dentro de ese margen.\n- **Orden secuencial:** el sistema valida la secuencia de marcas del día; los\n horarios están configurados para respetarla.\n- **Zona horaria:** Val.town corre en UTC; los crons ya están convertidos a la\n zona local (UTC−6).\n\n---\n\n_Automatización personal. Usa credenciales y datos propios._\n","label",[141],"acbdaf55-caf5-4ac3-9e12-c227d9da6b58","lib","d02240d3-3809-48c8-aeab-251ec98dcbcb",81,["D",1784992089054],"directory",[152],"6af815b4-970b-43f9-8c41-019cc8a473ce","Viernes","4a4440ee-7d6d-11f1-ab11-1607ee4eb77e",52,["D",1783804377599],[159],"dcfeccbc-5750-47c1-a0a1-d253af52a376","Supervisor","f8557292-86c9-41ca-83b2-64f14ddb5efd",130,["D",1788819002079],[165],"602df582-7572-44be-a0e5-a908de463938","Miercoles","49e06db2-7d6d-11f1-90af-1607ee4eb77e",50,["D",1783804376931],[171],"a4dee966-264b-41cb-9ed6-7ee7104c17d0","Martes","49376136-7d6d-11f1-8869-1607ee4eb77e",49,["D",1783804375830],[177],"8501f23a-f7e5-495b-93d2-7b859d94013b","Lunes","48e3f320-7d6d-11f1-9b1e-1607ee4eb77e",79,["D",1783804786930],2,[183],"a47bf8ba-27d2-4c85-a0d9-f9ffc64a026f","Jueves","4a1bdc26-7d6d-11f1-80a6-1607ee4eb77e",51,["D",1783804377332],[190],"pulls","branches",1,"forks","envVars",{"_203":205,"_206":65},"connections",{"_203":65,"_204":65},"count","unfilledCount",10,"emptyCount",{"_44":189,"_32":190,"_30":191,"_143":-5,"_42":43,"_41":192,"_145":61,"_39":426,"_13":65,"_34":156,"_36":-5,"_24":25,"_149":-5,"_241":427,"_27":428},{"_44":420,"_32":303,"_30":421,"_143":191,"_42":43,"_41":422,"_145":25,"_39":423,"_13":187,"_34":35,"_36":307,"_24":25,"_149":-5,"_241":424,"_27":425},{"_44":416,"_32":33,"_30":31,"_143":191,"_42":43,"_41":14,"_145":61,"_39":417,"_13":258,"_34":38,"_36":37,"_24":25,"_149":-5,"_241":418,"_27":419},{"_44":410,"_32":289,"_30":411,"_143":191,"_42":43,"_41":412,"_145":61,"_39":413,"_13":258,"_34":38,"_36":293,"_24":25,"_149":-5,"_241":414,"_27":415},{"_44":404,"_32":281,"_30":405,"_143":191,"_42":43,"_41":406,"_145":61,"_39":407,"_13":258,"_34":38,"_36":285,"_24":25,"_149":-5,"_241":408,"_27":409},{"_44":182,"_32":183,"_30":184,"_143":-5,"_42":43,"_41":185,"_145":61,"_39":401,"_13":187,"_34":156,"_36":-5,"_24":25,"_149":-5,"_241":402,"_27":403},{"_44":395,"_32":303,"_30":396,"_143":184,"_42":43,"_41":397,"_145":61,"_39":398,"_13":258,"_34":38,"_36":307,"_24":25,"_149":-5,"_241":399,"_27":400},{"_44":389,"_32":33,"_30":390,"_143":184,"_42":43,"_41":391,"_145":61,"_39":392,"_13":258,"_34":38,"_36":37,"_24":25,"_149":-5,"_241":393,"_27":394},{"_44":383,"_32":289,"_30":384,"_143":184,"_42":43,"_41":385,"_145":61,"_39":386,"_13":258,"_34":38,"_36":293,"_24":25,"_149":-5,"_241":387,"_27":388},{"_44":377,"_32":281,"_30":378,"_143":184,"_42":43,"_41":379,"_145":61,"_39":380,"_13":258,"_34":38,"_36":285,"_24":25,"_149":-5,"_241":381,"_27":382},{"_44":176,"_32":177,"_30":178,"_143":-5,"_42":43,"_41":179,"_145":61,"_39":374,"_13":65,"_34":156,"_36":-5,"_24":25,"_149":-5,"_241":375,"_27":376},{"_44":368,"_32":303,"_30":369,"_143":178,"_42":43,"_41":370,"_145":61,"_39":371,"_13":258,"_34":38,"_36":307,"_24":25,"_149":-5,"_241":372,"_27":373},{"_44":362,"_32":33,"_30":363,"_143":178,"_42":43,"_41":364,"_145":61,"_39":365,"_13":258,"_34":38,"_36":37,"_24":25,"_149":-5,"_241":366,"_27":367},{"_44":356,"_32":289,"_30":357,"_143":178,"_42":43,"_41":358,"_145":61,"_39":359,"_13":258,"_34":38,"_36":293,"_24":25,"_149":-5,"_241":360,"_27":361},{"_44":350,"_32":281,"_30":351,"_143":178,"_42":43,"_41":352,"_145":61,"_39":353,"_13":258,"_34":38,"_36":285,"_24":25,"_149":-5,"_241":354,"_27":355},{"_44":170,"_32":171,"_30":172,"_143":-5,"_42":43,"_41":173,"_145":61,"_39":347,"_13":65,"_34":156,"_36":-5,"_24":25,"_149":-5,"_241":348,"_27":349},{"_44":341,"_32":303,"_30":342,"_143":172,"_42":43,"_41":343,"_145":61,"_39":344,"_13":258,"_34":38,"_36":307,"_24":25,"_149":-5,"_241":345,"_27":346},{"_44":335,"_32":33,"_30":336,"_143":172,"_42":43,"_41":337,"_145":61,"_39":338,"_13":258,"_34":38,"_36":37,"_24":25,"_149":-5,"_241":339,"_27":340},{"_44":329,"_32":289,"_30":330,"_143":172,"_42":43,"_41":331,"_145":61,"_39":332,"_13":258,"_34":38,"_36":293,"_24":25,"_149":-5,"_241":333,"_27":334},{"_44":323,"_32":281,"_30":324,"_143":172,"_42":43,"_41":325,"_145":61,"_39":326,"_13":258,"_34":38,"_36":285,"_24":25,"_149":-5,"_241":327,"_27":328},{"_44":164,"_32":165,"_30":166,"_143":-5,"_42":43,"_41":167,"_145":61,"_39":320,"_13":65,"_34":156,"_36":-5,"_24":25,"_149":-5,"_241":321,"_27":322},{"_44":313,"_32":314,"_30":59,"_143":166,"_42":43,"_41":167,"_145":61,"_39":315,"_13":65,"_34":316,"_36":317,"_24":25,"_149":-5,"_241":318,"_27":319},{"_44":158,"_32":159,"_30":160,"_143":-5,"_42":43,"_41":161,"_145":61,"_39":310,"_13":65,"_34":156,"_36":-5,"_24":25,"_149":-5,"_241":311,"_27":312},{"_44":302,"_32":303,"_30":304,"_143":160,"_42":43,"_41":305,"_145":25,"_39":306,"_13":187,"_34":35,"_36":307,"_24":25,"_149":-5,"_241":308,"_27":309},{"_44":296,"_32":33,"_30":297,"_143":160,"_42":43,"_41":298,"_145":25,"_39":299,"_13":187,"_34":35,"_36":37,"_24":25,"_149":-5,"_241":300,"_27":301},{"_44":288,"_32":289,"_30":290,"_143":160,"_42":43,"_41":291,"_145":25,"_39":292,"_13":187,"_34":35,"_36":293,"_24":25,"_149":-5,"_241":294,"_27":295},{"_44":280,"_32":281,"_30":282,"_143":160,"_42":43,"_41":283,"_145":25,"_39":284,"_13":187,"_34":35,"_36":285,"_24":25,"_149":-5,"_241":286,"_27":287},{"_44":151,"_32":152,"_30":153,"_143":-5,"_42":43,"_41":154,"_145":61,"_39":277,"_13":65,"_34":156,"_36":-5,"_24":25,"_149":-5,"_241":278,"_27":279},{"_44":270,"_32":271,"_30":272,"_143":153,"_42":43,"_41":154,"_145":61,"_39":273,"_13":65,"_34":38,"_36":274,"_24":25,"_149":-5,"_241":275,"_27":276},{"_44":262,"_32":263,"_30":264,"_143":153,"_42":43,"_41":265,"_145":61,"_39":266,"_13":197,"_34":38,"_36":267,"_24":25,"_149":-5,"_241":268,"_27":269},{"_44":253,"_32":254,"_30":255,"_143":153,"_42":43,"_41":256,"_145":61,"_39":257,"_13":258,"_34":38,"_36":259,"_24":25,"_149":-5,"_241":260,"_27":261},{"_44":244,"_32":245,"_30":246,"_143":153,"_42":43,"_41":247,"_145":61,"_39":248,"_13":249,"_34":38,"_36":250,"_24":25,"_149":-5,"_241":251,"_27":252},{"_44":140,"_32":141,"_30":142,"_143":-5,"_42":43,"_41":144,"_145":61,"_39":240,"_13":147,"_34":20,"_36":148,"_24":25,"_149":-5,"_241":242,"_27":243},["D",1788820284381],"children",[],[141],"042f00d4-df9c-4bf0-ac13-15e731945d60","supervisor.ts","7bc1d3da-ab07-11f1-a4d2-1607ee4eb77e",156,["D",1788883852373],17,"import { email } from \"https://esm.town/v/std/email\";\nimport { ausenciaDeHoy } from \"./ausencias.ts\";\nimport { huboEventoHoy, registrarEvento, type Resultado } from \"./eventos.ts\";\nimport {\n CAMPO_DE_MARCA,\n DESACTIVADO,\n enviarMarca,\n getAccessToken,\n getRegistroActivo,\n MarcaError,\n type MarkAction,\n} from \"./marcar.ts\";\n\n/**\n * Supervisor de marcas.\n *\n * Los 20 crons de día MARCAN; el supervisor VERIFICA que se haya marcado y\n * repara si no. Existe porque los crons del plan gratuito de Val Town son\n * \"best effort\": el 2026-09-07 el end_lunch no se ejecutó (cero traces, cero\n * logs) y, al no haber ejecución, tampoco hubo excepción ni alerta.\n *\n * Corre una vez por marca, a una hora fija posterior al último horario posible\n * de esa marca en la semana. Sin jitter: no simula comportamiento humano, es\n * una reparación que ya va tarde por definición y la corrida debe caber en el\n * ~1 min de ejecución del plan gratuito.\n */\n\ninterface Vigilancia {\n /** Minuto UTC del día en que, como muy tarde, la marca debió hacerse. */\n objetivoUTC: number;\n /**\n * Minutos de retraso a partir de los cuales el supervisor deja de marcar y\n * solo alerta. Reponer una marca demasiado tarde distorsiona el día más de\n * lo que lo hace el campo vacío.\n */\n limiteMin: number;\n}\n\nconst hhmm = (h: number, m: number) => h * 60 + m;\n\n/**\n * Objetivo = la corrida más tardía de la semana para esa marca (start_shift va\n * de 13:51 a 13:57 UTC según el día, etc.). Usar el peor caso evita duplicar\n * aquí la tabla de los 20 horarios y que las dos fuentes se desincronicen.\n */\nconst VIGILANCIA: Record = {\n // Marcar tarde solo arriesga una tardanza; el campo vacío es peor.\n start_shift: { objetivoUTC: hhmm(13, 57), limiteMin: 40 },\n // Retrasarlo acorta el almuerzo registrado: daño menor.\n start_lunch: { objetivoUTC: hhmm(19, 2), limiteMin: 30 },\n // El más estricto: cada minuto de retraso alarga el almuerzo registrado.\n end_lunch: { objetivoUTC: hhmm(19, 56), limiteMin: 20 },\n // Marcar tarde infla la jornada; margen intermedio.\n end_shift: { objetivoUTC: hhmm(23, 7), limiteMin: 45 },\n};\n\n/**\n * Minutos transcurridos desde la hora objetivo. El ajuste de ±1440 cubre el\n * caso de un instante que caiga al otro lado de la medianoche UTC (end_shift\n * se vigila a las 23:10 UTC, cerca del corte).\n */\nfunction retrasoMinutos(action: MarkAction, momento = new Date()): number {\n const minutos = momento.getUTCHours() * 60 + momento.getUTCMinutes();\n let retraso = minutos - VIGILANCIA[action].objetivoUTC;\n if (retraso < -720) retraso += 1440;\n if (retraso > 720) retraso -= 1440;\n return retraso;\n}\n\n/**\n * Manda el correo como mucho una vez al día por marca y desenlace.\n *\n * La bitácora es la memoria: si hoy ya se registró este mismo resultado para\n * esta marca, el aviso ya salió. Sin esto, una corrida repetida (un reintento\n * de la plataforma, una llamada manual al endpoint) manda un correo idéntico\n * cada vez, y una bandeja con avisos repetidos se deja de leer.\n */\nasync function alertar(\n action: MarkAction,\n resultado: Resultado,\n asunto: string,\n cuerpo: string,\n): Promise {\n if (await huboEventoHoy(action, resultado)) {\n console.log(`🔁 ${asunto} — ya se avisó hoy; no se repite el correo.`);\n return;\n }\n console.log(`✉️ ${asunto}`);\n await email({ subject: asunto, text: cuerpo });\n}\n\n// ── Dead man's switch ───────────────────────────────────────────────────────\n//\n// El correo solo avisa de lo que SÍ se ejecutó. El caso que dejó a la vista el\n// 2026-09-07 es el contrario: nada corrió, así que nadie avisó. Un servicio\n// externo (healthchecks.io) conoce el horario esperado y avisa cuando el ping\n// NO llega.\n//\n// El ping se hace desde aquí, no desde el val de crons, porque así cubre la\n// cadena completa: si Val Town no ejecuta el val supervisor, o si este val no\n// responde, en ambos casos el ping falta y el vigilante lo nota.\n//\n// `HC_PING_URL` es un único check compartido por las 4 marcas: detecta que el\n// supervisor dejó de correr, no cuál de los cuatro faltó. Para granularidad\n// habría que crear un check por marca; se dejó fuera a propósito porque leer\n// una env var inexistente hace que Val Town escriba un WARNING en cada corrida.\n\nconst PING_TIMEOUT_MS = 5_000;\n\n/**\n * Avisa al vigilante externo. Nunca lanza ni bloquea: el supervisor debe\n * funcionar igual sin vigilante, y un ping caído jamás debe impedir que una\n * marca se recupere.\n */\nasync function ping(\n action: MarkAction,\n detalle: string,\n fallo = false,\n): Promise {\n const base = Deno.env.get(\"HC_PING_URL\");\n if (!base) return;\n\n try {\n await fetch(fallo ? `${base.replace(/\\/+$/, \"\")}/fail` : base, {\n method: \"POST\",\n body: `${action}: ${detalle}`,\n signal: AbortSignal.timeout(PING_TIMEOUT_MS),\n });\n } catch (err) {\n console.warn(\"⚠️ No se pudo avisar al vigilante externo:\", err);\n }\n}\n\n/** Lo ocurrido en una corrida, para la bitácora y el ping. */\ninterface Veredicto {\n resultado: Resultado;\n /** Minutos respecto a la hora objetivo; null cuando no aplica. */\n retrasoMin: number | null;\n detalle: string;\n}\n\nexport async function supervisar(action: MarkAction): Promise {\n // El supervisor de Cloudflare (marcador-cf) es quien vigila ahora. Si este\n // siguiera activo, repondría marcas que allá se decidieron NO reponer.\n if (DESACTIVADO) {\n console.log(`⏸️ Supervisor desactivado; ${action} lo vigila Cloudflare.`);\n return;\n }\n try {\n const v = await evaluar(action);\n await registrarEvento(action, v.resultado, v.retrasoMin, v.detalle);\n await ping(action, `${v.resultado} — ${v.detalle}`);\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n await manejarFallo(action, err);\n await registrarEvento(action, \"error\", null, msg);\n await ping(action, msg, true);\n throw err;\n }\n}\n\nasync function evaluar(action: MarkAction): Promise {\n const campo = CAMPO_DE_MARCA[action];\n\n const ausencia = await ausenciaDeHoy();\n if (ausencia) {\n console.log(`🌴 Ausencia hoy (${ausencia.tipo}); no se supervisa ${action}.`);\n return {\n resultado: \"ausencia\",\n retrasoMin: null,\n detalle: `ausencia de tipo ${ausencia.tipo}`,\n };\n }\n\n const token = await getAccessToken();\n const activo = await getRegistroActivo(token);\n\n const marcadaEn = activo?.[campo];\n if (marcadaEn) {\n // Cuánto tardó realmente el cron de su día. Es el dato que mide la\n // fiabilidad de la plataforma día a día; puede salir negativo porque el\n // objetivo es el peor caso de la semana, no el horario de hoy.\n const retrasoReal = retrasoMinutos(action, new Date(String(marcadaEn)));\n console.log(`✅ ${action} verificada; nada que hacer.`);\n return {\n resultado: \"verificada\",\n retrasoMin: retrasoReal,\n detalle: `marcada a las ${String(marcadaEn)}`,\n };\n }\n\n const retraso = retrasoMinutos(action);\n\n // El supervisor solo repara el pasado. Si todavía no llegó la hora de la\n // marca no hay nada que reparar: marcar ahora adelantaría el registro (una\n // salida antes de tiempo, un almuerzo que empieza temprano). Protege contra\n // una corrida manual o un cron mal configurado.\n if (retraso < 0) {\n console.log(\n `⏰ Aún no es hora de ${action} (faltan ${-retraso} min); no se marca.`,\n );\n return {\n resultado: \"aun_no_es_hora\",\n retrasoMin: retraso,\n detalle: `faltan ${-retraso} min para la hora objetivo`,\n };\n }\n\n // Sin jornada iniciada el backend rechaza cualquier otra marca\n // (\"No hay registro activo\"). Se repone el start_shift, pero la marca\n // supervisada no puede encadenarse: el backend exige 5 min entre marcas.\n if (!activo && action !== \"start_shift\") {\n await enviarMarca(token, \"start_shift\");\n await alertar(\n action,\n \"jornada_repuesta\",\n `🛟 Jornada sin iniciar — ${action} pendiente`,\n `No existía registro de hoy, así que faltaba también el inicio de jornada.\\n\\n` +\n `El supervisor repuso start_shift, pero NO pudo marcar ${action} en la misma ` +\n `corrida: el backend exige 5 minutos entre marcas.\\n\\n` +\n `Marca ${action} a mano cuando puedas.`,\n );\n return {\n resultado: \"jornada_repuesta\",\n retrasoMin: retraso,\n detalle: `se repuso start_shift; ${action} quedó pendiente`,\n };\n }\n\n if (retraso > VIGILANCIA[action].limiteMin) {\n await alertar(\n action,\n \"fuera_de_ventana\",\n `⚠️ ${action} perdida (fuera de ventana)`,\n `La marca ${action} nunca se registró y ya lleva ${Math.round(retraso)} minutos ` +\n `de retraso, más del límite de ${VIGILANCIA[action].limiteMin} min.\\n\\n` +\n `El supervisor NO la marcó a propósito: reponerla ahora distorsionaría el día ` +\n `(un almuerzo o una jornada de duración irreal) y eso dispara anomalías en las ` +\n `métricas de asistencia.\\n\\nDecide tú si la marcas a mano.`,\n );\n return {\n resultado: \"fuera_de_ventana\",\n retrasoMin: retraso,\n detalle: `+${Math.round(retraso)} min supera el límite de ${VIGILANCIA[action].limiteMin}`,\n };\n }\n\n const texto = await enviarMarca(token, action);\n console.log(`🛟 ${action} recuperada:`, texto);\n await alertar(\n action,\n \"recuperada\",\n `🛟 ${action} recuperada por el supervisor`,\n `El cron de ${action} no la registró (Val Town se lo saltó o llegó tarde).\\n\\n` +\n `El supervisor la marcó con ${Math.round(retraso)} minutos de retraso, dentro del ` +\n `límite de ${VIGILANCIA[action].limiteMin} min.\\n\\nRespuesta del sistema:\\n${texto}`,\n );\n return {\n resultado: \"recuperada\",\n retrasoMin: retraso,\n detalle: `repuesta con +${Math.round(retraso)} min de retraso`,\n };\n}\n\n/** Cada tipo de fallo pide una reacción distinta, no un correo genérico. */\nasync function manejarFallo(action: MarkAction, err: unknown): Promise {\n const msg = err instanceof Error ? err.message : String(err);\n console.error(`❌ Supervisor ${action} falló:`, msg);\n\n if (err instanceof MarcaError) {\n if (err.tipo === \"cooldown\") {\n await alertar(\n action,\n \"error\",\n `⏳ ${action}: el sistema pidió esperar`,\n `El backend rechazó la marca por su cooldown de 5 minutos entre marcas.\\n\\n` +\n `Suele significar que otra marca se registró hace muy poco. Revisa el marcador: ` +\n `puede que ya esté resuelto.\\n\\n${msg}`,\n );\n return;\n }\n if (err.tipo === \"biometria\") {\n await alertar(\n action,\n \"error\",\n `🔴 ${action}: la verificación facial fue rechazada`,\n `El backend no aceptó el descriptor facial. Esto NO se arregla reintentando: ` +\n `hay que renovar la env var FACE_DESCRIPTOR.\\n\\n` +\n `Abre el marcador en el navegador, marca una vez a mano, copia el faceDescriptor ` +\n `del payload que envía y pégalo en la variable.\\n\\n${msg}`,\n );\n return;\n }\n }\n\n await alertar(action, \"error\", `❌ Supervisor ${action} FALLÓ`, msg);\n}\n",[],[152,245],"7071016c-43ab-4a9e-b07d-7e8d2a08eb5d","marcar.ts","06add00c-a8bf-11f1-a60b-1607ee4eb77e",157,["D",1788894884099],3,"import { email } from \"https://esm.town/v/std/email\";\nimport { ausenciaDeHoy } from \"./ausencias.ts\";\n\n/**\n * Piezas compartidas del marcador.\n *\n * `correrMarca()` la usan los 20 crons de día (una marca a su hora, con jitter).\n * Las funciones sueltas (`getAccessToken`, `getRegistroActivo`, `enviarMarca`)\n * las reutiliza `lib/supervisor.ts` para verificar y recuperar marcas perdidas\n * sin duplicar el login ni el manejo del descriptor facial.\n */\n\nexport type MarkAction =\n | \"start_shift\"\n | \"start_lunch\"\n | \"end_lunch\"\n | \"end_shift\";\n\n/** Campo del registro donde el backend guarda cada marca. */\nexport const CAMPO_DE_MARCA: Record = {\n start_shift: \"startShift\",\n start_lunch: \"startLunch\",\n end_lunch: \"endLunch\",\n end_shift: \"endShift\",\n};\n\n/**\n * Clasificación de los rechazos del backend. El endpoint devuelve siempre\n * `{ error, details? }` sin código de máquina, así que se deduce del status y\n * del texto. Permite reaccionar distinto a cada caso en vez de tratar todo\n * fallo como el mismo error.\n */\nexport type TipoFallo =\n /** Cooldown de 5 min entre marcas: hay que reintentar más tarde, no es un fallo real. */\n | \"cooldown\"\n /** No existe registro del día: falta el start_shift antes de cualquier otra marca. */\n | \"sin_jornada\"\n /** Rostro no reconocido u onboarding ausente: hay que renovar FACE_DESCRIPTOR. */\n | \"biometria\"\n | \"otro\";\n\nexport class MarcaError extends Error {\n readonly action: MarkAction;\n readonly status: number;\n readonly cuerpo: string;\n readonly tipo: TipoFallo;\n\n constructor(action: MarkAction, status: number, cuerpo: string) {\n super(`Marca ${action} falló (HTTP ${status}): ${cuerpo}`);\n this.name = \"MarcaError\";\n this.action = action;\n this.status = status;\n this.cuerpo = cuerpo;\n this.tipo = clasificar(status, cuerpo);\n }\n}\n\nfunction clasificar(status: number, cuerpo: string): TipoFallo {\n if (cuerpo.includes(\"wait_5_minutes\")) return \"cooldown\";\n if (cuerpo.includes(\"No hay registro activo\")) return \"sin_jornada\";\n if (\n cuerpo.includes(\"verificación facial\") ||\n cuerpo.includes(\"verificar tu rostro\") ||\n cuerpo.includes(\"registro biométrico\") ||\n status === 409\n ) {\n return \"biometria\";\n }\n return \"otro\";\n}\n\nexport function requireEnv(name: string): string {\n const v = Deno.env.get(name);\n if (!v) throw new Error(`Falta env: ${name}`);\n return v;\n}\n\nconst sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));\n\n/**\n * Descriptor facial (128 floats) que el endpoint /mark exige desde\n * 2026-09-04. Vive en la env var FACE_DESCRIPTOR porque es un dato\n * biométrico y el código del val es público.\n */\nexport function getFaceDescriptor(): number[] {\n let parsed: unknown;\n try {\n parsed = JSON.parse(requireEnv(\"FACE_DESCRIPTOR\"));\n } catch {\n throw new Error(\"FACE_DESCRIPTOR no es JSON válido\");\n }\n if (!Array.isArray(parsed) || parsed.length !== 128 || parsed.some((n) => typeof n !== \"number\")) {\n throw new Error(\"FACE_DESCRIPTOR debe ser un array JSON de 128 números\");\n }\n return parsed as number[];\n}\n\nexport async function getAccessToken(): Promise {\n const kcUrl = requireEnv(\"KC_URL\").replace(/\\/+$/, \"\");\n const tokenUrl = `${kcUrl}/realms/${requireEnv(\"KC_REALM\")}/protocol/openid-connect/token`;\n const form = new URLSearchParams({\n grant_type: \"password\",\n client_id: requireEnv(\"KC_CLIENT\"),\n username: requireEnv(\"KC_USER\"),\n password: requireEnv(\"KC_PASS\"),\n });\n const res = await fetch(tokenUrl, {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/x-www-form-urlencoded\" },\n body: form,\n });\n const data = await res.json().catch(() => ({}));\n if (!res.ok || !data.access_token)\n throw new Error(`Login Keycloak falló (HTTP ${res.status}): ${JSON.stringify(data)}`);\n return data.access_token as string;\n}\n\n/**\n * Estado del día: el registro con las 4 marcas (las no hechas vienen en null),\n * o null si todavía no se ha iniciado la jornada.\n */\nexport async function getRegistroActivo(\n token: string,\n): Promise | null> {\n const apiBase = requireEnv(\"API_BASE\").replace(/\\/+$/, \"\");\n const employeeId = Number(requireEnv(\"EMPLOYEE_ID\"));\n const res = await fetch(\n `${apiBase}/api/timesheet/records/active?employeeId=${employeeId}`,\n { headers: { Authorization: `Bearer ${token}` } },\n );\n if (!res.ok) {\n throw new Error(`Consulta de estado falló (HTTP ${res.status})`);\n }\n return (await res.json().catch(() => null)) as Record | null;\n}\n\n/**\n * Envía la marca. El backend exige `faceDescriptor` desde 2026-09-04 y usa\n * `clientTimestamp` como hora oficial si no difiere más de 2 min de su reloj.\n */\nexport async function enviarMarca(\n token: string,\n action: MarkAction,\n): Promise {\n const apiBase = requireEnv(\"API_BASE\").replace(/\\/+$/, \"\");\n const employeeId = Number(requireEnv(\"EMPLOYEE_ID\"));\n\n const res = await fetch(`${apiBase}/api/timesheet/records/mark`, {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\", Authorization: `Bearer ${token}` },\n body: JSON.stringify({\n employeeId,\n action,\n deviceOrigin: \"WEB\",\n clientTimestamp: new Date().toISOString(),\n faceDescriptor: getFaceDescriptor(),\n // Sin GPS: el navegador reporta este código cuando se niega el permiso.\n clientErrorCode: \"GPS_PERMISSION_DENIED\",\n }),\n });\n const texto = await res.text();\n if (!res.ok) throw new MarcaError(action, res.status, texto);\n return texto;\n}\n\nasync function marcar(action: MarkAction, field: string) {\n // Se valida antes del jitter: si el descriptor está mal, mejor fallar ya.\n getFaceDescriptor();\n\n const jitterSec = Math.floor(Math.random() * 50);\n await sleep(jitterSec * 1000);\n\n const token = await getAccessToken();\n\n try {\n const activo = await getRegistroActivo(token);\n if (activo?.[field]) {\n console.log(`↩️ Ya existe ${field} hoy; no se marca.`);\n return;\n }\n } catch (err) {\n // Si el estado no se puede consultar seguimos e intentamos marcar: el\n // backend es idempotente (una marca repetida devuelve el registro sin\n // duplicarla), así que el riesgo de insistir es menor que el de no marcar.\n console.warn(\"⚠️ No se pudo consultar el estado del día:\", err);\n }\n\n const texto = await enviarMarca(token, action);\n console.log(`✅ ${action} registrada:`, texto);\n}\n\n/**\n * Interruptor maestro. Desde 2026-09-08 el marcador corre en Cloudflare\n * Workers (proyecto `marcador-cf`), que es puntual al segundo; este val queda\n * como respaldo dormido.\n *\n * Val Town no deja desactivar un cron por API y rechaza una expresión que\n * nunca ocurra, así que la desactivación vive aquí: los 20 crons siguen\n * disparando, pero no marcan nada.\n *\n * Para reactivar: poner `false`. Los horarios originales de los 20 crons están\n * respaldados en `docs/valtown-crons-respaldo.md` del proyecto de Cloudflare.\n */\nexport const DESACTIVADO = false;\n\nexport async function correrMarca(action: MarkAction, field: string) {\n if (DESACTIVADO) {\n console.log(`⏸️ Desactivado; ${action} la marca Cloudflare (marcador-cf).`);\n return;\n }\n try {\n const ausencia = await ausenciaDeHoy();\n if (ausencia) {\n console.log(`🌴 Ausencia hoy (${ausencia.tipo}); no se marca ${action}.`);\n return;\n }\n await marcar(action, field);\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n console.error(\"❌ Falló:\", msg);\n await email({ subject: `⚠️ Marca ${action} FALLÓ`, text: msg });\n throw err;\n }\n}\n",[],[152,254],"12aa2c92-278e-472f-8054-c65f9d8a91e8","eventos.ts","ac748844-ab0a-11f1-a8c3-1607ee4eb77e",144,["D",1788820232821],"import { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\nimport { fechaLocalISO } from \"./ausencias.ts\";\nimport type { MarkAction } from \"./marcar.ts\";\n\n/**\n * Bitácora del supervisor: una fila por corrida.\n *\n * Los logs de Val Town se retienen 3 días en el plan gratuito, así que esta\n * tabla es el único histórico de cuántas veces la plataforma se salta un cron\n * — el dato que hace falta para decidir algún día si vale la pena mover el\n * marcador de Val Town, o si el descriptor facial está empezando a fallar.\n *\n * Se registran TODAS las corridas, no solo las incidencias: sin el total no\n * hay denominador para calcular una tasa de fallo. Son 4 filas por día hábil,\n * unas mil al año.\n */\n\nexport type Resultado =\n /** La marca ya estaba; el cron de su día hizo su trabajo. */\n | \"verificada\"\n /** Faltaba y el supervisor la repuso. */\n | \"recuperada\"\n /** Faltaba, pero con demasiado retraso para reponerla sin distorsionar el día. */\n | \"fuera_de_ventana\"\n /** Se ejecutó antes de la hora objetivo: no hay nada que reparar todavía. */\n | \"aun_no_es_hora\"\n /** Vacación, feriado o permiso: hoy no se marca. */\n | \"ausencia\"\n /** No había jornada iniciada; se repuso el start_shift. */\n | \"jornada_repuesta\"\n /** La corrida falló. */\n | \"error\";\n\nlet tablaLista = false;\n\n/**\n * Crea la tabla en la primera corrida del worker. Así el val se auto-instala\n * si se remixa o si la base se pierde, sin depender de un paso manual.\n */\nasync function asegurarTabla(): Promise {\n if (tablaLista) return;\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS supervisor_eventos (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n fecha TEXT NOT NULL,\n hora_utc TEXT NOT NULL,\n accion TEXT NOT NULL,\n resultado TEXT NOT NULL,\n retraso_min INTEGER,\n detalle TEXT\n )\n `);\n await sqlite.execute(\n \"CREATE INDEX IF NOT EXISTS idx_supervisor_eventos_fecha ON supervisor_eventos (fecha DESC, accion)\",\n );\n tablaLista = true;\n}\n\n/**\n * ¿Ya se registró hoy este mismo desenlace para esta marca?\n *\n * Sirve para no repetir el correo cuando la misma corrida se ejecuta más de una\n * vez en el día (un reintento de la plataforma, una llamada manual al endpoint).\n * Ante cualquier duda devuelve false: es preferible un correo de más que uno\n * de menos.\n */\nexport async function huboEventoHoy(\n accion: MarkAction,\n resultado: Resultado,\n): Promise {\n try {\n await asegurarTabla();\n const res = await sqlite.execute({\n sql:\n \"SELECT 1 FROM supervisor_eventos WHERE fecha = ? AND accion = ? AND resultado = ? LIMIT 1\",\n args: [fechaLocalISO(), accion, resultado],\n });\n return res.rows.length > 0;\n } catch (err) {\n console.warn(\"⚠️ No se pudo consultar la bitácora:\", err);\n return false;\n }\n}\n\n/**\n * `retrasoMin` se mide contra la hora objetivo, que es la corrida más tardía de\n * la semana para esa marca. Puede salir negativo cuando el cron de ese día era\n * más temprano que el peor caso: es una diferencia contra el peor caso, no un\n * retraso absoluto.\n */\nexport async function registrarEvento(\n accion: MarkAction,\n resultado: Resultado,\n retrasoMin: number | null,\n detalle: string,\n): Promise {\n try {\n await asegurarTabla();\n await sqlite.execute({\n sql:\n \"INSERT INTO supervisor_eventos (fecha, hora_utc, accion, resultado, retraso_min, detalle) VALUES (?, ?, ?, ?, ?, ?)\",\n args: [\n fechaLocalISO(),\n new Date().toISOString(),\n accion,\n resultado,\n retrasoMin === null ? null : Math.round(retrasoMin),\n detalle.slice(0, 500),\n ],\n });\n } catch (err) {\n // La bitácora es observabilidad, no parte del trabajo: si falla, se anota\n // en el log y el supervisor sigue. Nunca debe impedir que una marca se\n // recupere ni que salga la alerta.\n console.warn(\"⚠️ No se pudo registrar el evento:\", err);\n }\n}\n",[],[152,263],"017abfb2-efac-4875-8b75-e6fe00f514e4","ausencias.ts","a57a07c8-883a-11f1-bce0-1607ee4eb77e",["D",1784992089054],"import { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\n\n/**\n * Fecha de hoy en hora local (UTC-6), en formato 'YYYY-MM-DD'.\n * Val.town corre en UTC; restamos 6h para no evaluar el día equivocado\n * cerca de la medianoche.\n */\nexport function fechaLocalISO(offsetHoras = -6): string {\n return new Date(Date.now() + offsetHoras * 3600 * 1000)\n .toISOString()\n .slice(0, 10);\n}\n\n/**\n * Devuelve el registro de ausencia si HOY (hora local) cae dentro de\n * algún rango [fecha_inicio, fecha_fin] de la tabla `ausencias`.\n * Si no hay ausencia, devuelve false.\n */\nexport async function ausenciaDeHoy(): Promise<\n { tipo: string; comentario: string | null } | false\n> {\n const hoy = fechaLocalISO();\n const res = await sqlite.execute({\n sql:\n \"SELECT tipo, comentario FROM ausencias WHERE ? BETWEEN fecha_inicio AND fecha_fin LIMIT 1\",\n args: [hoy],\n });\n if (res.rows.length === 0) return false;\n const row = res.rows[0] as Record;\n return {\n tipo: String(row.tipo),\n comentario: row.comentario == null ? null : String(row.comentario),\n };\n}\n",[],[152,271],["D",1784992089054],[235,236,237,238],[152],"8acd8a23-7929-4ad7-80a8-d4befa205b0c","start_shift.ts","bed02932-7d6d-11f1-add5-1607ee4eb77e",121,["D",1788567412858],"import { correrMarca } from \"../lib/marcar.ts\";\n\nexport default async function () {\n await correrMarca(\"start_shift\", \"startShift\");\n}\n",[],[159,281],"7572815a-ce14-4ab1-8314-9b06b8ece2bd","start_lunch.ts","c0bb0f64-7d6d-11f1-8740-1607ee4eb77e",122,["D",1788567414221],"import { correrMarca } from \"../lib/marcar.ts\";\n\nexport default async function () {\n await correrMarca(\"start_lunch\", \"startLunch\");\n}\n",[],[159,289],"f15ddb65-32af-4de3-b563-f089397955ff","cbe2e95c-7d6d-11f1-b475-1607ee4eb77e",124,["D",1788567415945],[],[159,33],"70fa0ffb-3609-40b1-9b0e-ad391b81ac06","end_lunch.ts","c66b8470-7d6d-11f1-98f5-1607ee4eb77e",123,["D",1788567415053],"import { correrMarca } from \"../lib/marcar.ts\";\n\nexport default async function () {\n await correrMarca(\"end_lunch\", \"endLunch\");\n}\n",[],[159,303],["D",1783804377599],[230,231,232,233],[159],"ef098074-85f8-4928-a7e3-4e04f4810063","endpoint.ts",["D",1788819002079],"http","import { CAMPO_DE_MARCA, requireEnv, type MarkAction } from \"../lib/marcar.ts\";\nimport { supervisar } from \"../lib/supervisor.ts\";\n\n/**\n * Disparador HTTP del supervisor.\n *\n * El plan gratuito permite 10 crons por val y este ya tiene 20 (creados antes\n * de que se aplicara el tope), así que los supervisores no caben aquí como\n * crons. Viven en el val `marcador_ECP_supervisor`, que estrena su propio cupo\n * y solo hace fetch a este endpoint.\n *\n * La lógica se ejecuta aquí a propósito: así las credenciales, el\n * FACE_DESCRIPTOR y la tabla `ausencias` (que es privada de cada val) se quedan\n * donde ya están, sin duplicarse. Los archivos http no consumen cupo de crons.\n */\n\nconst ACCIONES = Object.keys(CAMPO_DE_MARCA) as MarkAction[];\n\nexport default async function (req: Request): Promise {\n const url = new URL(req.url);\n\n // Endpoint público: sin este token cualquiera podría disparar marcas.\n // Se compara con longitud fija para no filtrar información por el tiempo.\n const enviado = req.headers.get(\"x-supervisor-token\") ?? \"\";\n const esperado = requireEnv(\"SUPERVISOR_TOKEN\");\n if (enviado.length !== esperado.length || enviado !== esperado) {\n return Response.json({ error: \"No autorizado\" }, { status: 401 });\n }\n\n const action = url.searchParams.get(\"action\") as MarkAction | null;\n if (!action || !ACCIONES.includes(action)) {\n return Response.json(\n { error: `Parámetro 'action' inválido. Válidos: ${ACCIONES.join(\", \")}` },\n { status: 400 },\n );\n }\n\n try {\n await supervisar(action);\n return Response.json({ ok: true, action });\n } catch (err) {\n // supervisar() ya avisó por correo y dejó el detalle en los logs; aquí solo\n // se traduce a HTTP para que el val supervisor lo vea como corrida fallida.\n const detalle = err instanceof Error ? err.message : String(err);\n return Response.json({ ok: false, action, error: detalle }, { status: 500 });\n }\n}\n",[],[165,314],["D",1788819002079],[228],[165],"375281ed-68f6-42b3-92a8-46804200764c","8a91379c-7d6d-11f1-b9e9-1607ee4eb77e",166,["D",1788903463262],[],[171,281],"71293858-b9e7-4668-9a36-1689fe9da496","9034d910-7d6d-11f1-8cd9-1607ee4eb77e",167,["D",1788903464492],[],[171,289],"0468876b-bdcb-4de3-ac3c-8323020d518a","9b8001dc-7d6d-11f1-bdc9-1607ee4eb77e",168,["D",1788903465338],[],[171,33],"cdba7ad5-f345-4e44-b35d-96cc2af859ea","9635a204-7d6d-11f1-b28c-1607ee4eb77e",169,["D",1788903466330],[],[171,303],["D",1783804376931],[223,224,225,226],[171],"2f205488-775c-4d0f-9f6b-2626d4dbf0d6","747c3164-7d6d-11f1-9b1e-1607ee4eb77e",162,["D",1788903459216],[],[177,281],"52974a40-24b0-4654-a4ab-e104a2e62831","79953e98-7d6d-11f1-8484-1607ee4eb77e",163,["D",1788903460432],[],[177,289],"f14b8c8c-560a-4158-8a21-085c44870cad","84d708fe-7d6d-11f1-ab6a-1607ee4eb77e",164,["D",1788903461223],[],[177,33],"d676106b-85c5-4173-8fd4-53fdc48e64c5","7f39f564-7d6d-11f1-ab7f-1607ee4eb77e",165,["D",1788903462322],[],[177,303],["D",1783804375830],[218,219,220,221],[177],"c12c9e00-3dab-4ce4-90d5-571e41e3579b","5724876a-7d6d-11f1-bfbe-1607ee4eb77e",158,["D",1788903455149],[],[183,281],"4c2473fe-b37e-48ba-a6b8-734f65855407","5ca68120-7d6d-11f1-9e90-1607ee4eb77e",159,["D",1788903456130],[],[183,289],"fea9cbc9-b745-42f2-9e00-fe14550d27b0","67bae588-7d6d-11f1-8b9b-1607ee4eb77e",160,["D",1788903457121],[],[183,33],"8cb8779d-9b83-40ea-8f99-ae6b3980cdee","6260305c-7d6d-11f1-84b9-1607ee4eb77e",161,["D",1788903458242],[],[183,303],["D",1783804786930],[213,214,215,216],[183],"9273a861-cf7a-4205-8be6-652eff497673","a4fe27ac-7d6d-11f1-b28c-1607ee4eb77e",170,["D",1788903467324],[],[190,281],"163626ca-3098-48e5-b054-bdbb6d51f948","aaa129a2-7d6d-11f1-a06e-1607ee4eb77e",171,["D",1788903468607],[],[190,289],"96673025-fd18-4717-80d5-351779ca8f8c",["D",1788903469466],[],[190,33],"77be431d-25d6-40b5-8cfd-266a1da64148","be8f3cce-7d6d-11f1-bf0d-1607ee4eb77e",119,["D",1788567410036],[],[190,303],["D",1783804377332],[208,209,210,211],[190],["D",1783559151130],["D",1789524079207],{"_102":101,"_110":106},{"_102":101,"_103":104,"_105":106,"_18":57,"_107":108,"_109":25},{"_13":91,"_32":92,"_44":43,"_93":45,"_94":-5,"_95":-5,"_96":-5,"_97":-5,"_98":-5,"_99":46,"_100":101},"ctx",{"_84":-5,"_129":467,"_468":469,"_470":471,"_472":25,"_473":25,"_474":25,"_475":61,"_476":-5,"_477":-7,"_478":-7,"_479":65,"_480":25,"_481":25,"_482":-5,"_483":25,"_484":25,"_485":25,"_486":-5},"ENV",{"_438":439,"_440":441,"_442":92,"_443":444,"_445":446,"_447":448,"_449":450,"_451":452,"_453":454,"_455":456,"_457":458,"_459":460,"_461":462,"_463":464,"_465":466},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Diff · v172