Skip to main content
Ejecuta tareas periódicas: limpiar datos expirados, sincronizar registros, generar reportes. Tu función se dispara automáticamente según el schedule que configures. Patrón: config.cron + guard isCron + secrets para conexiones externas.
index.ts
import { define, z } from "@jelou/functions";

export default define({
  name: "cleanup-job",
  description: "Limpia sesiones expiradas y sincroniza registros",
  input: z.object({}),
  config: {
    cron: [
      { expression: "0 3 * * *", timezone: "UTC" },
      { expression: "0 15 * * 1-5", timezone: "America/Guayaquil" },
    ],
    mcp: false,
  },
  handler: async (_input, ctx) => {
    if (!ctx.isCron) {
      return { skipped: true, reason: "solo se ejecuta por cron" };
    }

    ctx.log("Ejecutando limpieza", { cron: ctx.trigger.cron });

    const dbUrl = ctx.env.get("DATABASE_URL");
    const apiKey = ctx.env.get("EXTERNAL_API_KEY");

    const staleRecords = await fetch(`${dbUrl}/api/sessions?expired=true`)
      .then((r) => r.json());

    let cleaned = 0;
    for (const record of staleRecords) {
      await fetch(`${dbUrl}/api/sessions/${record.id}`, {
        method: "DELETE",
        headers: { Authorization: `Bearer ${apiKey}` },
      });
      cleaned++;
    }

    ctx.log("Limpieza completada", { cleaned, total: staleRecords.length });
    return { cleaned, checked: staleRecords.length };
  },
});

​
Configurar secrets

jelou secrets set cleanup-job DATABASE_URL=https://db.example.com EXTERNAL_API_KEY=YOUR_API_KEY

​
Por qué funciona así

  • config.cron define cuándo se ejecuta. Puedes tener múltiples schedules con distintas zonas horarias.
  • El guard if (!ctx.isCron) previene que alguien ejecute la limpieza por HTTP accidentalmente.
  • config.mcp: false — una tarea de mantenimiento no es un tool de IA.
  • ctx.trigger.cron te dice cuál schedule disparó la ejecución.