Files
localesp/src/utils/ubicacion/ProveedorUbicacion.js
T
edgar.friendly 2ec9259d19
deploy-branch / deploy (push) Successful in 2m46s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Successful in 3m15s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Successful in 3m16s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
feat(busqueda): búsqueda tolerante a tildes, conteo de resultados y estado vacío accionable
Alternativa A de simplificación de la UX de búsqueda.

- src/utils/texto.js: normalizador compartido (minúsculas, sin tildes,
  espacios colapsados) + tokenizador por palabras. ProveedorUbicacion ahora
  delega aquí en vez de duplicar la implementación.
- src/utils/busqueda.js: reglas de la búsqueda libre. Se comparan TODAS las
  palabras de la consulta contra nombre, provincia, categoría, subcategoría y
  dirección. Antes era un `includes` con toLowerCase(): "peluqueria" no
  encontraba "Peluquería" y "malaga" no encontraba "Málaga".
- BarraFiltros: conteo de resultados con aria-live ("4 locales" / "2 de 4
  locales", sin anunciar como filtro el simple orden), ✕ dentro del input que
  borra solo la consulta (y Escape), placeholder que refleja de verdad lo que
  se busca. El reseteo de filtros pasa a App, que es dueña del estado.
- EstadoVacioLista (nuevo): el listado vacío explica el motivo y ofrece salida
  —«✕ Quitar filtros» y «➕ Proponer «‹término›»», que abre la pasarela con el
  nombre ya rellenado— en lugar del párrafo suelto sin acción.
- scripts/entornos.env: alta del entorno de la rama (el build de deploy-branch
  exige prefijo admin por slug).

Tests: 185/185 (21 nuevos) — unitarios de la búsqueda y de componente para el
conteo, el ✕/Escape y el estado vacío. Build ok.
2026-11-01 12:21:40 +01:00

103 lines
4.3 KiB
JavaScript

// Clase base de los proveedores de ubicación: define el contrato común que
// implementan todas las integraciones con backends de mapas (Google Maps,
// Waze, OpenStreetMap, coordenadas sueltas y Nominatim como fallback de
// texto). JS no tiene interfaces nativas, así que el contrato se documenta
// aquí y se comprueba al registrar cada instancia (ver index.js).
//
// Contrato de cada proveedor:
// - id: identificador estable del proveedor. Se copia al resultado para
// que la UI pueda etiquetar el origen de la ubicación.
// - detecta(entrada) → boolean: ¿esta entrada parece pertenecer a este
// proveedor? Debe ser barato y síncrono (normalmente un regex).
// - extrae(entrada) → Promise<Resultado|null>: extrae la información
// disponible y devuelve { proveedor, lat, lng, ...extras } o null
// si no se pudo extraer nada. Los errores de red se degradan a un
// fallo controlado (null), nunca se lanzan al consumidor.
//
// El resultado es deliberadamente extensible: los consumidores leen solo los
// campos que conocen (hoy lat/lng/nombre/provincia/direccion), de modo que
// añadir campos nuevos en el futuro (teléfono, horarios…) no rompe nada.
import { PROVINCIAS } from "../../constants/provincias.js";
import { normalizar } from "../texto.js";
export default class ProveedorUbicacion {
// Identificador del proveedor; cada subclase debe sobrescribirlo.
id = "proveedor";
// Nombres cooficiales (normalizados y sin artículo) → provincia canónica.
// Nominatim puede devolver "Bizkaia", "Girona" o "Ourense" según el idioma
// negociado; sin este mapa la provincia quedaría vacía innecesariamente.
static ALIAS_PROVINCIAS = {
bizkaia: "Vizcaya",
gipuzkoa: "Guipúzcoa",
araba: "Álava",
girona: "Gerona",
lleida: "Lérida",
ourense: "Orense",
coruna: "La Coruña",
"illes balears": "Islas Baleares",
asturies: "Asturias",
};
// ¿Reconoce esta entrada? La base no reconoce nada.
detecta(entrada) {
return false;
}
// Extrae la ubicación de la entrada. Método "abstracto": la base lanza para
// que una subclase registrada sin implementarlo falle rápido.
async extrae(entrada) {
throw new Error("sin implementar");
}
// ── Helpers compartidos por todos los proveedores ────────────────────────
// Normaliza un texto: minúsculas, sin tildes y con espacios colapsados. Se
// usa para comparar provincias y etiquetas sin depender de acentos. La
// implementación vive en utils/texto.js: búsqueda y ubicación comparten una
// única definición de "texto comparable".
static normalizar(texto) {
return normalizar(texto);
}
normalizar(texto) {
return ProveedorUbicacion.normalizar(texto);
}
// Empareja un texto libre contra el listado canónico de PROVINCIAS,
// insensible a acentos y mayúsculas y tolerante con artículos ("Comunidad
// de Madrid" → "Madrid", "A Coruña" → "La Coruña"). Devuelve "" si no casa
// con ninguna, para que la UI fuerce la selección manual (mismo
// comportamiento que tenía AutocompletarLocal).
emparejarProvincia(texto) {
const t = this.normalizar(texto);
if (!t) return "";
const sinArticulo = (s) => s.replace(/^(el|la|los|las|a|o)\s+/, "");
const tSin = sinArticulo(t);
const directa = PROVINCIAS.find((p) => {
const np = ProveedorUbicacion.normalizar(p);
const npSin = sinArticulo(np);
return t === np || t.includes(np) || tSin === npSin || tSin.includes(npSin);
});
if (directa) return directa;
// Alias de nombres cooficiales: Nominatim puede responder en euskera,
// catalán o gallego según el idioma negociado (D12 del diseño).
return ProveedorUbicacion.ALIAS_PROVINCIAS[tSin] || "";
}
// fetch a Nominatim con las cabeceras adecuadas y manejo de errores: si la
// red o el servicio fallan devuelve null (fallo controlado) en vez de
// lanzar, para que la pasarela nunca se rompa por un error de proveedor.
async fetchNominatim(url) {
try {
const respuesta = await fetch(url, {
headers: { "Accept-Language": "es", "User-Agent": "LocalesEspanoles/1.0" },
});
if (!respuesta.ok) return null;
return await respuesta.json();
} catch {
return null;
}
}
}