Escuchar puntos en un radio (en vivo)

COLECCIONES: son los grupos de puntos que rastreas (conductores, repartidores, zonas…). Las creas tú en el menú «Geolocalización» y aquí escribes su nombre (o eliges una de las sugeridas). ESCUCHA la base de datos (no el teléfono): vigila una colección —o un solo punto— y corre tus pasos cuando alguien ENTRA al radio, SALE, es NUEVO o SE MUEVE. No sigue a nadie: solo avisa lo que pasa dentro del radio que tú definas. Entradas: • Nombre — para detenerla con «Dejar de escuchar / rastrear». • Colección. • Solo este punto — opcional: la clave de un punto concreto (ej. el conductor de mi viaje). • Centro del radio — un punto fijo (latitud y longitud) o mi ubicación (el círculo me sigue: al moverme, avisa quién entró o salió). • Radio — en metros. Con 0 no hay radio y avisa de cualquier cambio de la colección. SALIDAS (con «Configurar salidas»): • Lista inicial — los puntos que ya estaban dentro al empezar. • No hay puntos — al empezar no había ninguno. • Punto nuevo — se creó uno dentro del radio. • Entró al radio — uno que estaba fuera entró. • Salió del radio — uno salió o se borró. • Se movió — uno que ya estaba dentro se movió. • Error — se cayó la conexión en vivo o se perdió el permiso. En cada una, ▾ → Dato del evento trae el punto (clave, latitud, longitud, distancia y datos extra). Es asíncrona y NO bloquea. Si ya había una escucha con ese nombre, se reemplaza. Se detiene sola al salir de la app. SEGUNDO PLANO: con «También en segundo plano» sigue funcionando cuando la persona minimiza la app o apaga la pantalla (ideal para un conductor en ruta). En el celular pide el permiso de ubicación «Permitir todo el tiempo» y, en Android, muestra un aviso fijo «usando tu ubicación» mientras esté activo (el sistema lo exige). Se apaga con «Dejar de escuchar / rastrear» o al cerrar la app. Si la app se cierra deslizándola (forzar cierre), se detiene. En el navegador (Vista previa del editor) no existe: sigue solo con la página abierta. Al publicar en Google Play y App Store, el uso de ubicación en segundo plano se declara en la ficha de la tienda. Con la app minimizada las salidas siguen corriendo: usa «Enviar notificación» dentro de «Entró al radio» o «Salió del radio» para avisar a la persona (los avisos en pantalla no se ven con la app minimizada). Requiere la Supabase conectada al proyecto y correr una vez el script del menú «Geolocalización». Los cambios en vivo los da Supabase Realtime (el script lo activa).

Entradas

• Nombre de esta escucha (para poder detenerla) (text)
• Colección (la creas en «Geolocalización») (text)
• Solo este punto (clave, opcional: vacío = todos los de la colección) (text)
• Centro del radio (select)
• Centro · latitud (text)
• Centro · longitud (text)
• Radio (metros; 0 = sin radio, avisa de cualquier cambio) (text)
• Con la app en segundo plano (select)

Salidas (callbacks)

• Lista inicial — Corre UNA vez al empezar, con los puntos que ya estaban dentro del radio. Dato del evento: la lista (JSON) y cuántos son.
• No hay puntos — Corre UNA vez al empezar cuando no hay ningún punto dentro del radio (ideal para «no hay conductores cerca»).
• Punto nuevo — Corre cuando alguien CREA un punto nuevo dentro del radio (por ejemplo, un conductor que se conectó). Dato del evento: el punto.
• Entró al radio — Corre cuando un punto que estaba fuera ENTRÓ al radio. Dato del evento: el punto.
• Salió del radio — Corre cuando un punto SALIÓ del radio o se borró. Dato del evento: el punto (si se borró, solo trae su clave).
• Se movió — Corre cuando un punto que ya estaba dentro del radio se MOVIÓ. Dato del evento: el punto con su nueva posición y distancia.
• Error — Corre cuando falla la escucha (se cayó la conexión en vivo, se perdió el permiso de ubicación…). Dato del evento: el motivo.