Funciones edge

Ejecución de código del lado del servidor

Las funciones edge son funciones JavaScript/TypeScript que se ejecutan en el runtime Deno y te permiten implementar lógica que no debería o no puede ejecutarse en el navegador. La IA crea estas funciones cuando describes funcionalidades que necesitan procesamiento del lado del servidor, integración con API externas o seguridad reforzada.

Qué permiten las funciones edge:

  • Procesar formularios con validación y llamadas a API externas
  • Integrar servicios como enviar correos, procesar pagos o llamar a API de IA
  • Proteger lógica sensible que no debería ser visible en el código del navegador
  • Acceder a secretos de forma segura sin exponerlos a usuarios
  • Realizar operaciones complejas que son demasiado lentas o consumen demasiados recursos para el navegador

Cómo funcionan las funciones

Cuando la IA crea una función edge para ti, esta:

  1. Escribe el código JavaScript para realizar la tarea que describiste
  2. Configura el control de acceso para determinar quién puede llamar a la función
  3. Configura el acceso a secretos si la función necesita credenciales de API externas
  4. Prueba la función para asegurarse de que funcione correctamente
  5. Proporciona una URL que tu aplicación puede llamar para ejecutar la función

Las funciones se ejecutan en entornos aislados y seguros. Cada ejecución se registra con información de tiempos, cualquier error y qué usuario la activó. Puedes ver estos registros en Settings > Site configuration > Monitoring > Logs para monitorear cómo se comportan tus funciones y depurar problemas.

Control de acceso para funciones

Igual que las tablas de base de datos, las funciones edge tienen políticas de seguridad que controlan quién puede ejecutarlas. La IA las configura según lo que estás creando:

Funciones públicas

Cualquiera puede llamarlas, incluso sin iniciar sesión. Se usan para manejadores de webhooks (como notificaciones de pago de Stripe), API públicas o endpoints de comprobación de estado.

Funciones autenticadas

Solo los usuarios con sesión iniciada pueden llamarlas. La mayoría de las funciones usan esta política: es adecuada para funcionalidades orientadas al usuario, envíos de formularios o recuperación de datos para tu aplicación.

Acceso basado en grupos

Solo los usuarios en grupos específicos (como "admin") pueden llamar a la función. Es ideal para operaciones administrativas, herramientas de moderación o funcionalidades específicas de equipo.

Acceso basado en metadatos

Acceso basado en atributos personalizados del usuario. Por ejemplo, solo usuarios con department = "engineering" pueden llamar ciertas funciones. Esto permite esquemas de permisos flexibles y personalizados.

Qué pueden hacer las funciones

Acceso a base de datos

Las funciones pueden consultar y modificar tu base de datos, aplicando las mismas reglas de seguridad.

Llamadas a API externas

Las funciones pueden comunicarse con servicios externos usando tus secretos almacenados.

Lógica compleja

Las funciones pueden realizar cálculos, transformaciones de datos, validaciones o flujos de trabajo de varios pasos.

Correo electrónico y notificaciones

Envía correos transaccionales, mensajes SMS o notificaciones push en respuesta a acciones de usuarios.

Procesamiento de pagos

Maneja flujos de pago, procesamiento de webhooks o administración de suscripciones con servicios como Stripe.

Integración de IA

Llama a API de IA como OpenAI o Anthropic para generar contenido, analizar datos o proporcionar funcionalidades inteligentes.

Monitoreo y registros

Cada ejecución de función se registra automáticamente con:

  • Cuándo se llamó y quién lo hizo
  • Cuánto tardó en ejecutarse
  • Si tuvo éxito o encontró errores
  • Cualquier salida de consola o mensaje de error
  • La respuesta que devolvió

Buenas prácticas

✅ Describe con claridad - Cuando le pidas a la IA que cree una función, sé específico sobre lo que debe hacer y quién debería poder llamarla.

✅ Monitorea los registros - Revisa los registros de ejecución de funciones para entender el rendimiento y detectar errores temprano.

✅ Guarda secretos en el administrador de secretos - La IA usará secretos almacenados en lugar de fijarlos directamente en las funciones.

❌ No expongas operaciones sensibles - Deja que la IA configure controles de acceso adecuados. Las funciones administrativas nunca deberían ser públicas.


Documentación relacionada: