@hoilab/ada-cli 0.84.22 → 0.85.0

package/dist/core/web/proveedores/duckduckgo.js

@@ -0,0 +1,109 @@
+/**
+ * DuckDuckGo, vía su frontend HTML sin JS (`html.duckduckgo.com/html/`).
+ *
+ * Sin clave: es el único de los tres proveedores gratuitos que responde con
+ * resultados reales desde una red de centro de datos en la práctica —Mojeek y
+ * Ecosia sirven un captcha o un firewall a cualquier cliente sin navegador
+ * real la mayoría de las veces—. Por eso va primero en el grupo sin clave: es
+ * el que de verdad sostiene la puerta «sin ninguna clave, hay resultados».
+ *
+ * DuckDuckGo enruta cada resultado por `//duckduckgo.com/l/?uddg=<url>` para
+ * medir clics; hay que desenvolverlo o el agente termina con enlaces inútiles.
+ */
+import { CABECERAS_NAVEGADOR } from "./navegador.js";
+const ENDPOINT = "https://html.duckduckgo.com/html/";
+/** `true` cuando la página es el modal anti-bot, no resultados. DDG mezcla 200 y 202 en este caso. */
+function esBloqueoAntiBot(html) {
+    return html.includes("anomaly-modal") || html.includes("anomaly.js");
+}
+/**
+ * Desenvuelve la URL real de un resultado. Los orgánicos van envueltos en
+ * `uddg=`; los ANUNCIOS (`//duckduckgo.com/y.js?ad_domain=…`) no llevan ese
+ * envoltorio porque no apuntan a un destino final, sino al propio tracker de
+ * clics de DDG — por eso, tras desenvolver, cualquier URL que SIGA en
+ * duckduckgo.com se descarta: es un anuncio, no un resultado.
+ */
+function desenvolverUrl(href) {
+    const decodificado = href.replace(/&amp;/gi, "&");
+    let resuelta;
+    const match = decodificado.match(/[?&]uddg=([^&]+)/);
+    if (match) {
+        try {
+            resuelta = decodeURIComponent(match[1]);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    else if (decodificado.startsWith("//")) {
+        resuelta = `https:${decodificado}`;
+    }
+    else if (decodificado.startsWith("http://") || decodificado.startsWith("https://")) {
+        resuelta = decodificado;
+    }
+    else {
+        return undefined;
+    }
+    try {
+        if (new URL(resuelta).hostname.endsWith("duckduckgo.com"))
+            return undefined;
+    }
+    catch {
+        return undefined;
+    }
+    return resuelta;
+}
+function limpiarTexto(html) {
+    return html
+        .replace(/<[^>]*>/g, " ")
+        .replace(/&amp;/gi, "&")
+        .replace(/&lt;/gi, "<")
+        .replace(/&gt;/gi, ">")
+        .replace(/&quot;/gi, '"')
+        .replace(/&#39;|&apos;/gi, "'")
+        .replace(/&nbsp;/gi, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+const RE_BLOQUE = /<div\b[^>]*\bclass="[^"]*\bresult\b[^"]*"[^>]*>([\s\S]*?)(?=<div\b[^>]*\bclass="[^"]*\bresult\b|<div\b[^>]*\bclass="[^"]*\bnav-link\b|$)/g;
+const RE_TITULO = /<a\b[^>]*\bclass="[^"]*\bresult__a\b[^"]*"[^>]*\bhref="([^"]+)"[^>]*>([\s\S]*?)<\/a>/;
+const RE_SNIPPET = /<(?:a|div|span)\b[^>]*\bclass="[^"]*\bresult__snippet\b[^"]*"[^>]*>([\s\S]*?)<\/(?:a|div|span)>/;
+function parsear(html) {
+    const resultados = [];
+    for (const bloque of html.matchAll(RE_BLOQUE)) {
+        const titulo = bloque[1].match(RE_TITULO);
+        if (!titulo)
+            continue;
+        const url = desenvolverUrl(titulo[1]);
+        if (!url)
+            continue;
+        const tituloTexto = limpiarTexto(titulo[2]);
+        if (!tituloTexto)
+            continue;
+        const snippet = bloque[1].match(RE_SNIPPET);
+        resultados.push({
+            titulo: tituloTexto,
+            url,
+            resumen: snippet ? limpiarTexto(snippet[1]) || undefined : undefined,
+        });
+    }
+    return resultados;
+}
+export const buscar = async (consulta, maximo, _clave, fetchImpl, signal) => {
+    // GET, no POST: probado en vivo contra `html.duckduckgo.com` — el mismo
+    // endpoint trata el POST (el envío "de formulario real" que usan otros
+    // scrapers) con más sospecha que un GET con la consulta en la query, al
+    // menos desde redes de centro de datos. Con GET responde con resultados
+    // reales de forma consistente; con POST, con el modal anti-bot.
+    const url = new URL(ENDPOINT);
+    url.searchParams.set("q", consulta);
+    const respuesta = await fetchImpl(url, { headers: CABECERAS_NAVEGADOR, signal });
+    if (!respuesta.ok)
+        throw new Error(`DuckDuckGo respondió HTTP ${respuesta.status}.`);
+    const html = await respuesta.text();
+    if (esBloqueoAntiBot(html)) {
+        throw new Error("DuckDuckGo bloqueó la petición con su captcha anti-bot.");
+    }
+    return parsear(html).slice(0, maximo);
+};
+//# sourceMappingURL=duckduckgo.js.map

package/dist/core/web/proveedores/duckduckgo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckduckgo.js","sourceRoot":"","sources":["../../../../src/core/web/proveedores/duckduckgo.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * DuckDuckGo, vía su frontend HTML sin JS (`html.duckduckgo.com/html/`).\n *\n * Sin clave: es el único de los tres proveedores gratuitos que responde con\n * resultados reales desde una red de centro de datos en la práctica —Mojeek y\n * Ecosia sirven un captcha o un firewall a cualquier cliente sin navegador\n * real la mayoría de las veces—. Por eso va primero en el grupo sin clave: es\n * el que de verdad sostiene la puerta «sin ninguna clave, hay resultados».\n *\n * DuckDuckGo enruta cada resultado por `//duckduckgo.com/l/?uddg=<url>` para\n * medir clics; hay que desenvolverlo o el agente termina con enlaces inútiles.\n */\nimport { CABECERAS_NAVEGADOR } from \"./navegador.ts\";\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://html.duckduckgo.com/html/\";\n\n/** `true` cuando la página es el modal anti-bot, no resultados. DDG mezcla 200 y 202 en este caso. */\nfunction esBloqueoAntiBot(html: string): boolean {\n\treturn html.includes(\"anomaly-modal\") || html.includes(\"anomaly.js\");\n}\n\n/**\n * Desenvuelve la URL real de un resultado. Los orgánicos van envueltos en\n * `uddg=`; los ANUNCIOS (`//duckduckgo.com/y.js?ad_domain=…`) no llevan ese\n * envoltorio porque no apuntan a un destino final, sino al propio tracker de\n * clics de DDG — por eso, tras desenvolver, cualquier URL que SIGA en\n * duckduckgo.com se descarta: es un anuncio, no un resultado.\n */\nfunction desenvolverUrl(href: string): string | undefined {\n\tconst decodificado = href.replace(/&amp;/gi, \"&\");\n\tlet resuelta: string | undefined;\n\tconst match = decodificado.match(/[?&]uddg=([^&]+)/);\n\tif (match) {\n\t\ttry {\n\t\t\tresuelta = decodeURIComponent(match[1]);\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t} else if (decodificado.startsWith(\"//\")) {\n\t\tresuelta = `https:${decodificado}`;\n\t} else if (decodificado.startsWith(\"http://\") || decodificado.startsWith(\"https://\")) {\n\t\tresuelta = decodificado;\n\t} else {\n\t\treturn undefined;\n\t}\n\ttry {\n\t\tif (new URL(resuelta).hostname.endsWith(\"duckduckgo.com\")) return undefined;\n\t} catch {\n\t\treturn undefined;\n\t}\n\treturn resuelta;\n}\n\nfunction limpiarTexto(html: string): string {\n\treturn html\n\t\t.replace(/<[^>]*>/g, \" \")\n\t\t.replace(/&amp;/gi, \"&\")\n\t\t.replace(/&lt;/gi, \"<\")\n\t\t.replace(/&gt;/gi, \">\")\n\t\t.replace(/&quot;/gi, '\"')\n\t\t.replace(/&#39;|&apos;/gi, \"'\")\n\t\t.replace(/&nbsp;/gi, \" \")\n\t\t.replace(/\\s+/g, \" \")\n\t\t.trim();\n}\n\nconst RE_BLOQUE =\n\t/<div\\b[^>]*\\bclass=\"[^\"]*\\bresult\\b[^\"]*\"[^>]*>([\\s\\S]*?)(?=<div\\b[^>]*\\bclass=\"[^\"]*\\bresult\\b|<div\\b[^>]*\\bclass=\"[^\"]*\\bnav-link\\b|$)/g;\nconst RE_TITULO = /<a\\b[^>]*\\bclass=\"[^\"]*\\bresult__a\\b[^\"]*\"[^>]*\\bhref=\"([^\"]+)\"[^>]*>([\\s\\S]*?)<\\/a>/;\nconst RE_SNIPPET = /<(?:a|div|span)\\b[^>]*\\bclass=\"[^\"]*\\bresult__snippet\\b[^\"]*\"[^>]*>([\\s\\S]*?)<\\/(?:a|div|span)>/;\n\nfunction parsear(html: string): ResultadoProveedor[] {\n\tconst resultados: ResultadoProveedor[] = [];\n\tfor (const bloque of html.matchAll(RE_BLOQUE)) {\n\t\tconst titulo = bloque[1].match(RE_TITULO);\n\t\tif (!titulo) continue;\n\t\tconst url = desenvolverUrl(titulo[1]);\n\t\tif (!url) continue;\n\t\tconst tituloTexto = limpiarTexto(titulo[2]);\n\t\tif (!tituloTexto) continue;\n\t\tconst snippet = bloque[1].match(RE_SNIPPET);\n\t\tresultados.push({\n\t\t\ttitulo: tituloTexto,\n\t\t\turl,\n\t\t\tresumen: snippet ? limpiarTexto(snippet[1]) || undefined : undefined,\n\t\t});\n\t}\n\treturn resultados;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, _clave, fetchImpl, signal) => {\n\t// GET, no POST: probado en vivo contra `html.duckduckgo.com` — el mismo\n\t// endpoint trata el POST (el envío \"de formulario real\" que usan otros\n\t// scrapers) con más sospecha que un GET con la consulta en la query, al\n\t// menos desde redes de centro de datos. Con GET responde con resultados\n\t// reales de forma consistente; con POST, con el modal anti-bot.\n\tconst url = new URL(ENDPOINT);\n\turl.searchParams.set(\"q\", consulta);\n\tconst respuesta = await fetchImpl(url, { headers: CABECERAS_NAVEGADOR, signal });\n\tif (!respuesta.ok) throw new Error(`DuckDuckGo respondió HTTP ${respuesta.status}.`);\n\tconst html = await respuesta.text();\n\tif (esBloqueoAntiBot(html)) {\n\t\tthrow new Error(\"DuckDuckGo bloqueó la petición con su captcha anti-bot.\");\n\t}\n\treturn parsear(html).slice(0, maximo);\n};\n"]}

package/dist/core/web/proveedores/ecosia.d.ts

@@ -0,0 +1,3 @@
+import type { FuncionBuscar } from "./tipos.ts";
+export declare const buscar: FuncionBuscar;
+//# sourceMappingURL=ecosia.d.ts.map

package/dist/core/web/proveedores/ecosia.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecosia.d.ts","sourceRoot":"","sources":["../../../../src/core/web/proveedores/ecosia.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,YAAY,CAAC;AAuDpE,eAAO,MAAM,MAAM,EAAE,aAUpB,CAAC","sourcesContent":["/**\n * Ecosia, vía su página HTML pública (`ecosia.org/search`).\n *\n * Sin clave. Su frontal Cloudflare bloquea con frecuencia a clientes sin\n * navegador real (403 \"Ecosia Firewall\"); igual que Mojeek, se implementa\n * porque cuando responde trae resultados reales y el registro salta al\n * siguiente proveedor cuando este lanza.\n */\nimport { CABECERAS_NAVEGADOR } from \"./navegador.ts\";\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://www.ecosia.org/search\";\n\nfunction esBloqueado(status: number, html: string): boolean {\n\treturn (\n\t\tstatus === 403 ||\n\t\tstatus === 429 ||\n\t\thtml.includes(\"Ecosia Firewall\") ||\n\t\thtml.includes(\"_cf_chl_opt\") ||\n\t\thtml.includes(\"/cdn-cgi/challenge-platform/\")\n\t);\n}\n\nfunction limpiarTexto(html: string): string {\n\treturn html\n\t\t.replace(/<[^>]*>/g, \" \")\n\t\t.replace(/&amp;/gi, \"&\")\n\t\t.replace(/&lt;/gi, \"<\")\n\t\t.replace(/&gt;/gi, \">\")\n\t\t.replace(/&quot;/gi, '\"')\n\t\t.replace(/&#39;|&apos;/gi, \"'\")\n\t\t.replace(/&nbsp;/gi, \" \")\n\t\t.replace(/\\s+/g, \" \")\n\t\t.trim();\n}\n\n/** Cada resultado orgánico es un `<article data-test-id=\"organic-result\">`. */\nconst RE_ARTICULO = /<article\\b[^>]*\\bdata-test-id=\"organic-result\"[^>]*>([\\s\\S]*?)<\\/article>/g;\nconst RE_ENLACE_TITULO = /<a\\b[^>]*\\bhref=\"([^\"]+)\"[^>]*>[\\s\\S]*?data-test-id=\"result-title\"[\\s\\S]*?<\\/a>/;\nconst RE_TITULO_TEXTO = /data-test-id=\"result-title\"[^>]*>([\\s\\S]*?)<\\/h2>/;\nconst RE_DESCRIPCION = /data-test-id=\"(?:web-result-description|result-description)\"[^>]*>([\\s\\S]*?)<\\/p>/;\n\nfunction parsear(html: string): ResultadoProveedor[] {\n\tconst resultados: ResultadoProveedor[] = [];\n\tfor (const articulo of html.matchAll(RE_ARTICULO)) {\n\t\tconst bloque = articulo[1];\n\t\tconst enlace = bloque.match(RE_ENLACE_TITULO);\n\t\tconst titulo = bloque.match(RE_TITULO_TEXTO);\n\t\tif (!enlace || !titulo) continue;\n\t\tconst href = enlace[1];\n\t\tif (!href.startsWith(\"http://\") && !href.startsWith(\"https://\")) continue;\n\t\tif (/^https?:\\/\\/(www\\.)?ecosia\\.org/i.test(href)) continue;\n\t\tconst tituloTexto = limpiarTexto(titulo[1]);\n\t\tif (!tituloTexto) continue;\n\t\tconst descripcion = bloque.match(RE_DESCRIPCION);\n\t\tresultados.push({\n\t\t\ttitulo: tituloTexto,\n\t\t\turl: href,\n\t\t\tresumen: descripcion ? limpiarTexto(descripcion[1]) || undefined : undefined,\n\t\t});\n\t}\n\treturn resultados;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, _clave, fetchImpl, signal) => {\n\tconst url = new URL(ENDPOINT);\n\turl.searchParams.set(\"q\", consulta);\n\tconst respuesta = await fetchImpl(url, { headers: CABECERAS_NAVEGADOR, signal });\n\tconst html = await respuesta.text();\n\tif (esBloqueado(respuesta.status, html)) {\n\t\tthrow new Error(\"Ecosia bloqueó la petición con su firewall anti-bot.\");\n\t}\n\tif (!respuesta.ok) throw new Error(`Ecosia respondió HTTP ${respuesta.status}.`);\n\treturn parsear(html).slice(0, maximo);\n};\n"]}

package/dist/core/web/proveedores/ecosia.js

@@ -0,0 +1,72 @@
+/**
+ * Ecosia, vía su página HTML pública (`ecosia.org/search`).
+ *
+ * Sin clave. Su frontal Cloudflare bloquea con frecuencia a clientes sin
+ * navegador real (403 "Ecosia Firewall"); igual que Mojeek, se implementa
+ * porque cuando responde trae resultados reales y el registro salta al
+ * siguiente proveedor cuando este lanza.
+ */
+import { CABECERAS_NAVEGADOR } from "./navegador.js";
+const ENDPOINT = "https://www.ecosia.org/search";
+function esBloqueado(status, html) {
+    return (status === 403 ||
+        status === 429 ||
+        html.includes("Ecosia Firewall") ||
+        html.includes("_cf_chl_opt") ||
+        html.includes("/cdn-cgi/challenge-platform/"));
+}
+function limpiarTexto(html) {
+    return html
+        .replace(/<[^>]*>/g, " ")
+        .replace(/&amp;/gi, "&")
+        .replace(/&lt;/gi, "<")
+        .replace(/&gt;/gi, ">")
+        .replace(/&quot;/gi, '"')
+        .replace(/&#39;|&apos;/gi, "'")
+        .replace(/&nbsp;/gi, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+/** Cada resultado orgánico es un `<article data-test-id="organic-result">`. */
+const RE_ARTICULO = /<article\b[^>]*\bdata-test-id="organic-result"[^>]*>([\s\S]*?)<\/article>/g;
+const RE_ENLACE_TITULO = /<a\b[^>]*\bhref="([^"]+)"[^>]*>[\s\S]*?data-test-id="result-title"[\s\S]*?<\/a>/;
+const RE_TITULO_TEXTO = /data-test-id="result-title"[^>]*>([\s\S]*?)<\/h2>/;
+const RE_DESCRIPCION = /data-test-id="(?:web-result-description|result-description)"[^>]*>([\s\S]*?)<\/p>/;
+function parsear(html) {
+    const resultados = [];
+    for (const articulo of html.matchAll(RE_ARTICULO)) {
+        const bloque = articulo[1];
+        const enlace = bloque.match(RE_ENLACE_TITULO);
+        const titulo = bloque.match(RE_TITULO_TEXTO);
+        if (!enlace || !titulo)
+            continue;
+        const href = enlace[1];
+        if (!href.startsWith("http://") && !href.startsWith("https://"))
+            continue;
+        if (/^https?:\/\/(www\.)?ecosia\.org/i.test(href))
+            continue;
+        const tituloTexto = limpiarTexto(titulo[1]);
+        if (!tituloTexto)
+            continue;
+        const descripcion = bloque.match(RE_DESCRIPCION);
+        resultados.push({
+            titulo: tituloTexto,
+            url: href,
+            resumen: descripcion ? limpiarTexto(descripcion[1]) || undefined : undefined,
+        });
+    }
+    return resultados;
+}
+export const buscar = async (consulta, maximo, _clave, fetchImpl, signal) => {
+    const url = new URL(ENDPOINT);
+    url.searchParams.set("q", consulta);
+    const respuesta = await fetchImpl(url, { headers: CABECERAS_NAVEGADOR, signal });
+    const html = await respuesta.text();
+    if (esBloqueado(respuesta.status, html)) {
+        throw new Error("Ecosia bloqueó la petición con su firewall anti-bot.");
+    }
+    if (!respuesta.ok)
+        throw new Error(`Ecosia respondió HTTP ${respuesta.status}.`);
+    return parsear(html).slice(0, maximo);
+};
+//# sourceMappingURL=ecosia.js.map

package/dist/core/web/proveedores/ecosia.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecosia.js","sourceRoot":"","sources":["../../../../src/core/web/proveedores/ecosia.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Ecosia, vía su página HTML pública (`ecosia.org/search`).\n *\n * Sin clave. Su frontal Cloudflare bloquea con frecuencia a clientes sin\n * navegador real (403 \"Ecosia Firewall\"); igual que Mojeek, se implementa\n * porque cuando responde trae resultados reales y el registro salta al\n * siguiente proveedor cuando este lanza.\n */\nimport { CABECERAS_NAVEGADOR } from \"./navegador.ts\";\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://www.ecosia.org/search\";\n\nfunction esBloqueado(status: number, html: string): boolean {\n\treturn (\n\t\tstatus === 403 ||\n\t\tstatus === 429 ||\n\t\thtml.includes(\"Ecosia Firewall\") ||\n\t\thtml.includes(\"_cf_chl_opt\") ||\n\t\thtml.includes(\"/cdn-cgi/challenge-platform/\")\n\t);\n}\n\nfunction limpiarTexto(html: string): string {\n\treturn html\n\t\t.replace(/<[^>]*>/g, \" \")\n\t\t.replace(/&amp;/gi, \"&\")\n\t\t.replace(/&lt;/gi, \"<\")\n\t\t.replace(/&gt;/gi, \">\")\n\t\t.replace(/&quot;/gi, '\"')\n\t\t.replace(/&#39;|&apos;/gi, \"'\")\n\t\t.replace(/&nbsp;/gi, \" \")\n\t\t.replace(/\\s+/g, \" \")\n\t\t.trim();\n}\n\n/** Cada resultado orgánico es un `<article data-test-id=\"organic-result\">`. */\nconst RE_ARTICULO = /<article\\b[^>]*\\bdata-test-id=\"organic-result\"[^>]*>([\\s\\S]*?)<\\/article>/g;\nconst RE_ENLACE_TITULO = /<a\\b[^>]*\\bhref=\"([^\"]+)\"[^>]*>[\\s\\S]*?data-test-id=\"result-title\"[\\s\\S]*?<\\/a>/;\nconst RE_TITULO_TEXTO = /data-test-id=\"result-title\"[^>]*>([\\s\\S]*?)<\\/h2>/;\nconst RE_DESCRIPCION = /data-test-id=\"(?:web-result-description|result-description)\"[^>]*>([\\s\\S]*?)<\\/p>/;\n\nfunction parsear(html: string): ResultadoProveedor[] {\n\tconst resultados: ResultadoProveedor[] = [];\n\tfor (const articulo of html.matchAll(RE_ARTICULO)) {\n\t\tconst bloque = articulo[1];\n\t\tconst enlace = bloque.match(RE_ENLACE_TITULO);\n\t\tconst titulo = bloque.match(RE_TITULO_TEXTO);\n\t\tif (!enlace || !titulo) continue;\n\t\tconst href = enlace[1];\n\t\tif (!href.startsWith(\"http://\") && !href.startsWith(\"https://\")) continue;\n\t\tif (/^https?:\\/\\/(www\\.)?ecosia\\.org/i.test(href)) continue;\n\t\tconst tituloTexto = limpiarTexto(titulo[1]);\n\t\tif (!tituloTexto) continue;\n\t\tconst descripcion = bloque.match(RE_DESCRIPCION);\n\t\tresultados.push({\n\t\t\ttitulo: tituloTexto,\n\t\t\turl: href,\n\t\t\tresumen: descripcion ? limpiarTexto(descripcion[1]) || undefined : undefined,\n\t\t});\n\t}\n\treturn resultados;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, _clave, fetchImpl, signal) => {\n\tconst url = new URL(ENDPOINT);\n\turl.searchParams.set(\"q\", consulta);\n\tconst respuesta = await fetchImpl(url, { headers: CABECERAS_NAVEGADOR, signal });\n\tconst html = await respuesta.text();\n\tif (esBloqueado(respuesta.status, html)) {\n\t\tthrow new Error(\"Ecosia bloqueó la petición con su firewall anti-bot.\");\n\t}\n\tif (!respuesta.ok) throw new Error(`Ecosia respondió HTTP ${respuesta.status}.`);\n\treturn parsear(html).slice(0, maximo);\n};\n"]}

package/dist/core/web/proveedores/exa.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Exa Search API. Requiere clave (`exa` en el vault, o EXA_API_KEY).
+ */
+import type { FuncionBuscar } from "./tipos.ts";
+export declare const buscar: FuncionBuscar;
+//# sourceMappingURL=exa.d.ts.map

package/dist/core/web/proveedores/exa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exa.d.ts","sourceRoot":"","sources":["../../../../src/core/web/proveedores/exa.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,YAAY,CAAC;AAQpE,eAAO,MAAM,MAAM,EAAE,aAmBpB,CAAC","sourcesContent":["/**\n * Exa Search API. Requiere clave (`exa` en el vault, o EXA_API_KEY).\n */\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://api.exa.ai/search\";\n\ninterface RespuestaExa {\n\tresults?: Array<{ title?: string; url?: string; text?: string; summary?: string }>;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, clave, fetchImpl, signal) => {\n\tif (!clave) throw new Error(\"Exa requiere clave.\");\n\tconst respuesta = await fetchImpl(ENDPOINT, {\n\t\tmethod: \"POST\",\n\t\theaders: { \"content-type\": \"application/json\", \"x-api-key\": clave },\n\t\tbody: JSON.stringify({\n\t\t\tquery: consulta,\n\t\t\tnumResults: Math.min(Math.max(maximo, 1), 20),\n\t\t\ttype: \"auto\",\n\t\t\tcontents: { summary: { query: consulta } },\n\t\t}),\n\t\tsignal,\n\t});\n\tif (!respuesta.ok) throw new Error(`Exa respondió HTTP ${respuesta.status}.`);\n\tconst datos = (await respuesta.json()) as RespuestaExa;\n\tconst resultados: ResultadoProveedor[] = (datos.results ?? [])\n\t\t.filter((r) => typeof r.url === \"string\" && r.url)\n\t\t.map((r) => ({ titulo: r.title || r.url!, url: r.url!, resumen: r.summary || r.text }));\n\treturn resultados.slice(0, maximo);\n};\n"]}

package/dist/core/web/proveedores/exa.js

@@ -0,0 +1,24 @@
+const ENDPOINT = "https://api.exa.ai/search";
+export const buscar = async (consulta, maximo, clave, fetchImpl, signal) => {
+    if (!clave)
+        throw new Error("Exa requiere clave.");
+    const respuesta = await fetchImpl(ENDPOINT, {
+        method: "POST",
+        headers: { "content-type": "application/json", "x-api-key": clave },
+        body: JSON.stringify({
+            query: consulta,
+            numResults: Math.min(Math.max(maximo, 1), 20),
+            type: "auto",
+            contents: { summary: { query: consulta } },
+        }),
+        signal,
+    });
+    if (!respuesta.ok)
+        throw new Error(`Exa respondió HTTP ${respuesta.status}.`);
+    const datos = (await respuesta.json());
+    const resultados = (datos.results ?? [])
+        .filter((r) => typeof r.url === "string" && r.url)
+        .map((r) => ({ titulo: r.title || r.url, url: r.url, resumen: r.summary || r.text }));
+    return resultados.slice(0, maximo);
+};
+//# sourceMappingURL=exa.js.map

package/dist/core/web/proveedores/exa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exa.js","sourceRoot":"","sources":["../../../../src/core/web/proveedores/exa.ts"],"names":[],"mappings":"AAKA,MAAM,QAAQ,GAAG,2BAA2B,CAAC;AAM7C,MAAM,CAAC,MAAM,MAAM,GAAkB,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IAC1F,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE;QAC3C,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,WAAW,EAAE,KAAK,EAAE;QACnE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACpB,KAAK,EAAE,QAAQ;YACf,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;YAC7C,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;SAC1C,CAAC;QACF,MAAM;KACN,CAAC,CAAC;IACH,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAsB,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9E,MAAM,KAAK,GAAG,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,CAAiB,CAAC;IACvD,MAAM,UAAU,GAAyB,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;SAC5D,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC;SACjD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAI,EAAE,GAAG,EAAE,CAAC,CAAC,GAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACzF,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAAA,CACnC,CAAC","sourcesContent":["/**\n * Exa Search API. Requiere clave (`exa` en el vault, o EXA_API_KEY).\n */\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://api.exa.ai/search\";\n\ninterface RespuestaExa {\n\tresults?: Array<{ title?: string; url?: string; text?: string; summary?: string }>;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, clave, fetchImpl, signal) => {\n\tif (!clave) throw new Error(\"Exa requiere clave.\");\n\tconst respuesta = await fetchImpl(ENDPOINT, {\n\t\tmethod: \"POST\",\n\t\theaders: { \"content-type\": \"application/json\", \"x-api-key\": clave },\n\t\tbody: JSON.stringify({\n\t\t\tquery: consulta,\n\t\t\tnumResults: Math.min(Math.max(maximo, 1), 20),\n\t\t\ttype: \"auto\",\n\t\t\tcontents: { summary: { query: consulta } },\n\t\t}),\n\t\tsignal,\n\t});\n\tif (!respuesta.ok) throw new Error(`Exa respondió HTTP ${respuesta.status}.`);\n\tconst datos = (await respuesta.json()) as RespuestaExa;\n\tconst resultados: ResultadoProveedor[] = (datos.results ?? [])\n\t\t.filter((r) => typeof r.url === \"string\" && r.url)\n\t\t.map((r) => ({ titulo: r.title || r.url!, url: r.url!, resumen: r.summary || r.text }));\n\treturn resultados.slice(0, maximo);\n};\n"]}

package/dist/core/web/proveedores/mojeek.d.ts

@@ -0,0 +1,3 @@
+import type { FuncionBuscar } from "./tipos.ts";
+export declare const buscar: FuncionBuscar;
+//# sourceMappingURL=mojeek.d.ts.map

package/dist/core/web/proveedores/mojeek.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mojeek.d.ts","sourceRoot":"","sources":["../../../../src/core/web/proveedores/mojeek.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,YAAY,CAAC;AA8CpE,eAAO,MAAM,MAAM,EAAE,aAWpB,CAAC","sourcesContent":["/**\n * Mojeek, vía su página HTML pública (`mojeek.com/search`).\n *\n * Índice propio, sin clave. En la práctica bloquea con un captcha (ALTCHA) a\n * casi cualquier cliente sin navegador real bastante a menudo — se implementa\n * igualmente porque cuando SÍ contesta trae resultados reales, y el registro\n * ya está pensado para saltar al siguiente proveedor cuando este lanza.\n */\nimport { CABECERAS_NAVEGADOR } from \"./navegador.ts\";\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://www.mojeek.com/search\";\n\nfunction esBloqueoAntiBot(html: string): boolean {\n\treturn html.includes(\"altcha-widget\") || html.includes(\"captcha-wrap\") || /sending automated queries/i.test(html);\n}\n\nfunction limpiarTexto(html: string): string {\n\treturn html\n\t\t.replace(/<[^>]*>/g, \" \")\n\t\t.replace(/&amp;/gi, \"&\")\n\t\t.replace(/&lt;/gi, \"<\")\n\t\t.replace(/&gt;/gi, \">\")\n\t\t.replace(/&quot;/gi, '\"')\n\t\t.replace(/&#39;|&apos;/gi, \"'\")\n\t\t.replace(/&nbsp;/gi, \" \")\n\t\t.replace(/\\s+/g, \" \")\n\t\t.trim();\n}\n\n/** Cada resultado orgánico es un `<li>` de `ul.results-standard`, con el título en `h2 > a.title`. */\nconst RE_ITEM =\n\t/<li\\b[^>]*>[\\s\\S]*?<h2[^>]*>\\s*<a\\b[^>]*\\bclass=\"[^\"]*\\btitle\\b[^\"]*\"[^>]*\\bhref=\"([^\"]+)\"[^>]*>([\\s\\S]*?)<\\/a>[\\s\\S]*?<\\/li>/g;\nconst RE_SNIPPET = /<p\\b[^>]*\\bclass=\"[^\"]*\\bs\\b[^\"]*\"[^>]*>([\\s\\S]*?)<\\/p>/;\n\nfunction parsear(html: string): ResultadoProveedor[] {\n\tconst bloque = html.match(/<ul\\b[^>]*\\bclass=\"[^\"]*\\bresults-standard\\b[^\"]*\"[^>]*>([\\s\\S]*?)<\\/ul>/);\n\tif (!bloque) return [];\n\tconst resultados: ResultadoProveedor[] = [];\n\tfor (const item of bloque[1].matchAll(RE_ITEM)) {\n\t\tconst href = item[1];\n\t\tif (!href.startsWith(\"http://\") && !href.startsWith(\"https://\")) continue;\n\t\tif (/mojeek\\.(com|co\\.uk|fr|de)/i.test(href)) continue; // navegación interna, no resultado\n\t\tconst tituloTexto = limpiarTexto(item[2]);\n\t\tif (!tituloTexto) continue;\n\t\tconst snippet = item[0].match(RE_SNIPPET);\n\t\tresultados.push({\n\t\t\ttitulo: tituloTexto,\n\t\t\turl: href,\n\t\t\tresumen: snippet ? limpiarTexto(snippet[1]) || undefined : undefined,\n\t\t});\n\t}\n\treturn resultados;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, _clave, fetchImpl, signal) => {\n\tconst url = new URL(ENDPOINT);\n\turl.searchParams.set(\"q\", consulta);\n\turl.searchParams.set(\"t\", String(maximo));\n\tconst respuesta = await fetchImpl(url, { headers: CABECERAS_NAVEGADOR, signal });\n\tconst html = await respuesta.text();\n\tif (esBloqueoAntiBot(html)) {\n\t\tthrow new Error(\"Mojeek bloqueó la petición con su captcha anti-bot.\");\n\t}\n\tif (!respuesta.ok) throw new Error(`Mojeek respondió HTTP ${respuesta.status}.`);\n\treturn parsear(html).slice(0, maximo);\n};\n"]}

package/dist/core/web/proveedores/mojeek.js

@@ -0,0 +1,65 @@
+/**
+ * Mojeek, vía su página HTML pública (`mojeek.com/search`).
+ *
+ * Índice propio, sin clave. En la práctica bloquea con un captcha (ALTCHA) a
+ * casi cualquier cliente sin navegador real bastante a menudo — se implementa
+ * igualmente porque cuando SÍ contesta trae resultados reales, y el registro
+ * ya está pensado para saltar al siguiente proveedor cuando este lanza.
+ */
+import { CABECERAS_NAVEGADOR } from "./navegador.js";
+const ENDPOINT = "https://www.mojeek.com/search";
+function esBloqueoAntiBot(html) {
+    return html.includes("altcha-widget") || html.includes("captcha-wrap") || /sending automated queries/i.test(html);
+}
+function limpiarTexto(html) {
+    return html
+        .replace(/<[^>]*>/g, " ")
+        .replace(/&amp;/gi, "&")
+        .replace(/&lt;/gi, "<")
+        .replace(/&gt;/gi, ">")
+        .replace(/&quot;/gi, '"')
+        .replace(/&#39;|&apos;/gi, "'")
+        .replace(/&nbsp;/gi, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+/** Cada resultado orgánico es un `<li>` de `ul.results-standard`, con el título en `h2 > a.title`. */
+const RE_ITEM = /<li\b[^>]*>[\s\S]*?<h2[^>]*>\s*<a\b[^>]*\bclass="[^"]*\btitle\b[^"]*"[^>]*\bhref="([^"]+)"[^>]*>([\s\S]*?)<\/a>[\s\S]*?<\/li>/g;
+const RE_SNIPPET = /<p\b[^>]*\bclass="[^"]*\bs\b[^"]*"[^>]*>([\s\S]*?)<\/p>/;
+function parsear(html) {
+    const bloque = html.match(/<ul\b[^>]*\bclass="[^"]*\bresults-standard\b[^"]*"[^>]*>([\s\S]*?)<\/ul>/);
+    if (!bloque)
+        return [];
+    const resultados = [];
+    for (const item of bloque[1].matchAll(RE_ITEM)) {
+        const href = item[1];
+        if (!href.startsWith("http://") && !href.startsWith("https://"))
+            continue;
+        if (/mojeek\.(com|co\.uk|fr|de)/i.test(href))
+            continue; // navegación interna, no resultado
+        const tituloTexto = limpiarTexto(item[2]);
+        if (!tituloTexto)
+            continue;
+        const snippet = item[0].match(RE_SNIPPET);
+        resultados.push({
+            titulo: tituloTexto,
+            url: href,
+            resumen: snippet ? limpiarTexto(snippet[1]) || undefined : undefined,
+        });
+    }
+    return resultados;
+}
+export const buscar = async (consulta, maximo, _clave, fetchImpl, signal) => {
+    const url = new URL(ENDPOINT);
+    url.searchParams.set("q", consulta);
+    url.searchParams.set("t", String(maximo));
+    const respuesta = await fetchImpl(url, { headers: CABECERAS_NAVEGADOR, signal });
+    const html = await respuesta.text();
+    if (esBloqueoAntiBot(html)) {
+        throw new Error("Mojeek bloqueó la petición con su captcha anti-bot.");
+    }
+    if (!respuesta.ok)
+        throw new Error(`Mojeek respondió HTTP ${respuesta.status}.`);
+    return parsear(html).slice(0, maximo);
+};
+//# sourceMappingURL=mojeek.js.map

package/dist/core/web/proveedores/mojeek.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mojeek.js","sourceRoot":"","sources":["../../../../src/core/web/proveedores/mojeek.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Mojeek, vía su página HTML pública (`mojeek.com/search`).\n *\n * Índice propio, sin clave. En la práctica bloquea con un captcha (ALTCHA) a\n * casi cualquier cliente sin navegador real bastante a menudo — se implementa\n * igualmente porque cuando SÍ contesta trae resultados reales, y el registro\n * ya está pensado para saltar al siguiente proveedor cuando este lanza.\n */\nimport { CABECERAS_NAVEGADOR } from \"./navegador.ts\";\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://www.mojeek.com/search\";\n\nfunction esBloqueoAntiBot(html: string): boolean {\n\treturn html.includes(\"altcha-widget\") || html.includes(\"captcha-wrap\") || /sending automated queries/i.test(html);\n}\n\nfunction limpiarTexto(html: string): string {\n\treturn html\n\t\t.replace(/<[^>]*>/g, \" \")\n\t\t.replace(/&amp;/gi, \"&\")\n\t\t.replace(/&lt;/gi, \"<\")\n\t\t.replace(/&gt;/gi, \">\")\n\t\t.replace(/&quot;/gi, '\"')\n\t\t.replace(/&#39;|&apos;/gi, \"'\")\n\t\t.replace(/&nbsp;/gi, \" \")\n\t\t.replace(/\\s+/g, \" \")\n\t\t.trim();\n}\n\n/** Cada resultado orgánico es un `<li>` de `ul.results-standard`, con el título en `h2 > a.title`. */\nconst RE_ITEM =\n\t/<li\\b[^>]*>[\\s\\S]*?<h2[^>]*>\\s*<a\\b[^>]*\\bclass=\"[^\"]*\\btitle\\b[^\"]*\"[^>]*\\bhref=\"([^\"]+)\"[^>]*>([\\s\\S]*?)<\\/a>[\\s\\S]*?<\\/li>/g;\nconst RE_SNIPPET = /<p\\b[^>]*\\bclass=\"[^\"]*\\bs\\b[^\"]*\"[^>]*>([\\s\\S]*?)<\\/p>/;\n\nfunction parsear(html: string): ResultadoProveedor[] {\n\tconst bloque = html.match(/<ul\\b[^>]*\\bclass=\"[^\"]*\\bresults-standard\\b[^\"]*\"[^>]*>([\\s\\S]*?)<\\/ul>/);\n\tif (!bloque) return [];\n\tconst resultados: ResultadoProveedor[] = [];\n\tfor (const item of bloque[1].matchAll(RE_ITEM)) {\n\t\tconst href = item[1];\n\t\tif (!href.startsWith(\"http://\") && !href.startsWith(\"https://\")) continue;\n\t\tif (/mojeek\\.(com|co\\.uk|fr|de)/i.test(href)) continue; // navegación interna, no resultado\n\t\tconst tituloTexto = limpiarTexto(item[2]);\n\t\tif (!tituloTexto) continue;\n\t\tconst snippet = item[0].match(RE_SNIPPET);\n\t\tresultados.push({\n\t\t\ttitulo: tituloTexto,\n\t\t\turl: href,\n\t\t\tresumen: snippet ? limpiarTexto(snippet[1]) || undefined : undefined,\n\t\t});\n\t}\n\treturn resultados;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, _clave, fetchImpl, signal) => {\n\tconst url = new URL(ENDPOINT);\n\turl.searchParams.set(\"q\", consulta);\n\turl.searchParams.set(\"t\", String(maximo));\n\tconst respuesta = await fetchImpl(url, { headers: CABECERAS_NAVEGADOR, signal });\n\tconst html = await respuesta.text();\n\tif (esBloqueoAntiBot(html)) {\n\t\tthrow new Error(\"Mojeek bloqueó la petición con su captcha anti-bot.\");\n\t}\n\tif (!respuesta.ok) throw new Error(`Mojeek respondió HTTP ${respuesta.status}.`);\n\treturn parsear(html).slice(0, maximo);\n};\n"]}

package/dist/core/web/proveedores/navegador.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Cabeceras de navegador para los proveedores sin clave.
+ *
+ * DuckDuckGo, Mojeek y Ecosia sirven HTML pensado para un navegador: sin un
+ * User-Agent y un Accept-Language plausibles, varios devuelven directamente la
+ * página de captcha en vez de resultados. No es spoofing agresivo —un único
+ * perfil fijo, no rotación— solo lo mínimo para no parecer un script desnudo.
+ */
+export declare const CABECERAS_NAVEGADOR: Record<string, string>;
+//# sourceMappingURL=navegador.d.ts.map

package/dist/core/web/proveedores/navegador.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navegador.d.ts","sourceRoot":"","sources":["../../../../src/core/web/proveedores/navegador.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAItD,CAAC","sourcesContent":["/**\n * Cabeceras de navegador para los proveedores sin clave.\n *\n * DuckDuckGo, Mojeek y Ecosia sirven HTML pensado para un navegador: sin un\n * User-Agent y un Accept-Language plausibles, varios devuelven directamente la\n * página de captcha en vez de resultados. No es spoofing agresivo —un único\n * perfil fijo, no rotación— solo lo mínimo para no parecer un script desnudo.\n */\nexport const CABECERAS_NAVEGADOR: Record<string, string> = {\n\t\"user-agent\":\n\t\t\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0 Safari/537.36\",\n\t\"accept-language\": \"en-US,en;q=0.9\",\n};\n"]}

package/dist/core/web/proveedores/navegador.js

@@ -0,0 +1,13 @@
+/**
+ * Cabeceras de navegador para los proveedores sin clave.
+ *
+ * DuckDuckGo, Mojeek y Ecosia sirven HTML pensado para un navegador: sin un
+ * User-Agent y un Accept-Language plausibles, varios devuelven directamente la
+ * página de captcha en vez de resultados. No es spoofing agresivo —un único
+ * perfil fijo, no rotación— solo lo mínimo para no parecer un script desnudo.
+ */
+export const CABECERAS_NAVEGADOR = {
+    "user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0 Safari/537.36",
+    "accept-language": "en-US,en;q=0.9",
+};
+//# sourceMappingURL=navegador.js.map

package/dist/core/web/proveedores/navegador.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navegador.js","sourceRoot":"","sources":["../../../../src/core/web/proveedores/navegador.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA2B;IAC1D,YAAY,EACX,mHAAmH;IACpH,iBAAiB,EAAE,gBAAgB;CACnC,CAAC","sourcesContent":["/**\n * Cabeceras de navegador para los proveedores sin clave.\n *\n * DuckDuckGo, Mojeek y Ecosia sirven HTML pensado para un navegador: sin un\n * User-Agent y un Accept-Language plausibles, varios devuelven directamente la\n * página de captcha en vez de resultados. No es spoofing agresivo —un único\n * perfil fijo, no rotación— solo lo mínimo para no parecer un script desnudo.\n */\nexport const CABECERAS_NAVEGADOR: Record<string, string> = {\n\t\"user-agent\":\n\t\t\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0 Safari/537.36\",\n\t\"accept-language\": \"en-US,en;q=0.9\",\n};\n"]}

package/dist/core/web/proveedores/registro.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Registro perezoso de proveedores de búsqueda web.
+ *
+ * Importar este fichero no carga NINGÚN proveedor: cada `cargar()` es un
+ * `import()` dinámico que solo se ejecuta cuando le toca el turno en
+ * `buscarConProveedores`. Son módulos pesados —parseo de HTML, clientes de
+ * API— y como mucho se usa uno por sesión; cargarlos todos al arrancar sería
+ * trabajo tirado para el 99% de las sesiones que no los necesitan.
+ *
+ * Orden: la búsqueda nativa del modelo (Anthropic) se resuelve ANTES de
+ * llegar aquí, en `tools.ts`. Dentro de este registro: clave configurada >
+ * sin clave — lo explícito que el usuario ha pagado y configurado gana a lo
+ * gratuito. Entre proveedores con clave, el orden es el de esta lista; el
+ * primero con clave disponible es el que se prueba primero.
+ */
+import type { DescriptorProveedor, ResultadoProveedor } from "./tipos.ts";
+/** Metadatos de todos los proveedores, en orden de intento. Ningún `cargar()` se ejecuta aquí. */
+export declare const PROVEEDORES: readonly DescriptorProveedor[];
+export interface ResultadoBusquedaProveedores {
+    proveedor: string;
+    resultados: ResultadoProveedor[];
+}
+export interface OpcionesBusquedaProveedores {
+    /** Vault primero, variable de entorno después — lo resuelve quien llama. */
+    obtenerClave: (nombreProveedor: string) => Promise<string | undefined>;
+    fetchImpl?: typeof fetch;
+    signal?: AbortSignal;
+}
+/**
+ * Prueba los proveedores en orden hasta que uno responda (con o sin
+ * resultados) o se agoten todos.
+ *
+ * Un proveedor sin clave configurada se SALTA sin contar como fallo — no está
+ * disponible, no ha fallado. Un proveedor que lanza SÍ cuenta como fallo y se
+ * acumula su motivo. Los tres proveedores sin clave (duckduckgo, mojeek,
+ * ecosia) están SIEMPRE en la lista, así que siempre hay al menos uno que
+ * intentar: si el bucle se agota es porque todos lanzaron, nunca porque no
+ * hubiera nada que probar. Por eso el único error que se lanza aquí es
+ * «fallaron», nunca «no configurado» — decir lo contrario sería mentir sobre
+ * qué pasó.
+ */
+export declare function buscarConProveedores(consulta: string, maximo: number, opciones: OpcionesBusquedaProveedores): Promise<ResultadoBusquedaProveedores>;
+//# sourceMappingURL=registro.d.ts.map

package/dist/core/web/proveedores/registro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registro.d.ts","sourceRoot":"","sources":["../../../../src/core/web/proveedores/registro.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAgB1E,oGAAkG;AAClG,eAAO,MAAM,WAAW,EAAE,SAAS,mBAAmB,EAAiC,CAAC;AAExF,MAAM,WAAW,4BAA4B;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,kBAAkB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,2BAA2B;IAC3C,+EAA4E;IAC5E,YAAY,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACvE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CACzC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,2BAA2B,GACnC,OAAO,CAAC,4BAA4B,CAAC,CAoBvC","sourcesContent":["/**\n * Registro perezoso de proveedores de búsqueda web.\n *\n * Importar este fichero no carga NINGÚN proveedor: cada `cargar()` es un\n * `import()` dinámico que solo se ejecuta cuando le toca el turno en\n * `buscarConProveedores`. Son módulos pesados —parseo de HTML, clientes de\n * API— y como mucho se usa uno por sesión; cargarlos todos al arrancar sería\n * trabajo tirado para el 99% de las sesiones que no los necesitan.\n *\n * Orden: la búsqueda nativa del modelo (Anthropic) se resuelve ANTES de\n * llegar aquí, en `tools.ts`. Dentro de este registro: clave configurada >\n * sin clave — lo explícito que el usuario ha pagado y configurado gana a lo\n * gratuito. Entre proveedores con clave, el orden es el de esta lista; el\n * primero con clave disponible es el que se prueba primero.\n */\nimport type { DescriptorProveedor, ResultadoProveedor } from \"./tipos.ts\";\n\nconst CON_CLAVE: DescriptorProveedor[] = [\n\t{ nombre: \"brave\", necesitaClave: true, cargar: () => import(\"./brave.ts\") },\n\t{ nombre: \"tavily\", necesitaClave: true, cargar: () => import(\"./tavily.ts\") },\n\t{ nombre: \"exa\", necesitaClave: true, cargar: () => import(\"./exa.ts\") },\n\t{ nombre: \"searxng\", necesitaClave: true, cargar: () => import(\"./searxng.ts\") },\n\t{ nombre: \"serper\", necesitaClave: true, cargar: () => import(\"./serper.ts\") },\n];\n\nconst SIN_CLAVE: DescriptorProveedor[] = [\n\t{ nombre: \"duckduckgo\", necesitaClave: false, cargar: () => import(\"./duckduckgo.ts\") },\n\t{ nombre: \"mojeek\", necesitaClave: false, cargar: () => import(\"./mojeek.ts\") },\n\t{ nombre: \"ecosia\", necesitaClave: false, cargar: () => import(\"./ecosia.ts\") },\n];\n\n/** Metadatos de todos los proveedores, en orden de intento. Ningún `cargar()` se ejecuta aquí. */\nexport const PROVEEDORES: readonly DescriptorProveedor[] = [...CON_CLAVE, ...SIN_CLAVE];\n\nexport interface ResultadoBusquedaProveedores {\n\tproveedor: string;\n\tresultados: ResultadoProveedor[];\n}\n\nexport interface OpcionesBusquedaProveedores {\n\t/** Vault primero, variable de entorno después — lo resuelve quien llama. */\n\tobtenerClave: (nombreProveedor: string) => Promise<string | undefined>;\n\tfetchImpl?: typeof fetch;\n\tsignal?: AbortSignal;\n}\n\n/**\n * Prueba los proveedores en orden hasta que uno responda (con o sin\n * resultados) o se agoten todos.\n *\n * Un proveedor sin clave configurada se SALTA sin contar como fallo — no está\n * disponible, no ha fallado. Un proveedor que lanza SÍ cuenta como fallo y se\n * acumula su motivo. Los tres proveedores sin clave (duckduckgo, mojeek,\n * ecosia) están SIEMPRE en la lista, así que siempre hay al menos uno que\n * intentar: si el bucle se agota es porque todos lanzaron, nunca porque no\n * hubiera nada que probar. Por eso el único error que se lanza aquí es\n * «fallaron», nunca «no configurado» — decir lo contrario sería mentir sobre\n * qué pasó.\n */\nexport async function buscarConProveedores(\n\tconsulta: string,\n\tmaximo: number,\n\topciones: OpcionesBusquedaProveedores,\n): Promise<ResultadoBusquedaProveedores> {\n\tconst fetchImpl = opciones.fetchImpl ?? fetch;\n\tconst errores: string[] = [];\n\n\tfor (const descriptor of PROVEEDORES) {\n\t\tlet clave: string | undefined;\n\t\tif (descriptor.necesitaClave) {\n\t\t\tclave = await opciones.obtenerClave(descriptor.nombre);\n\t\t\tif (!clave) continue; // no configurado: no es un fallo, es \"no disponible\"\n\t\t}\n\t\ttry {\n\t\t\tconst modulo = await descriptor.cargar();\n\t\t\tconst resultados = await modulo.buscar(consulta, maximo, clave, fetchImpl, opciones.signal);\n\t\t\treturn { proveedor: descriptor.nombre, resultados };\n\t\t} catch (error) {\n\t\t\terrores.push(`${descriptor.nombre}: ${error instanceof Error ? error.message : String(error)}`);\n\t\t}\n\t}\n\n\tthrow new Error(`Todos los proveedores de búsqueda fallaron: ${errores.join(\" | \")}`);\n}\n"]}

package/dist/core/web/proveedores/registro.js

@@ -0,0 +1,49 @@
+const CON_CLAVE = [
+    { nombre: "brave", necesitaClave: true, cargar: () => import("./brave.js") },
+    { nombre: "tavily", necesitaClave: true, cargar: () => import("./tavily.js") },
+    { nombre: "exa", necesitaClave: true, cargar: () => import("./exa.js") },
+    { nombre: "searxng", necesitaClave: true, cargar: () => import("./searxng.js") },
+    { nombre: "serper", necesitaClave: true, cargar: () => import("./serper.js") },
+];
+const SIN_CLAVE = [
+    { nombre: "duckduckgo", necesitaClave: false, cargar: () => import("./duckduckgo.js") },
+    { nombre: "mojeek", necesitaClave: false, cargar: () => import("./mojeek.js") },
+    { nombre: "ecosia", necesitaClave: false, cargar: () => import("./ecosia.js") },
+];
+/** Metadatos de todos los proveedores, en orden de intento. Ningún `cargar()` se ejecuta aquí. */
+export const PROVEEDORES = [...CON_CLAVE, ...SIN_CLAVE];
+/**
+ * Prueba los proveedores en orden hasta que uno responda (con o sin
+ * resultados) o se agoten todos.
+ *
+ * Un proveedor sin clave configurada se SALTA sin contar como fallo — no está
+ * disponible, no ha fallado. Un proveedor que lanza SÍ cuenta como fallo y se
+ * acumula su motivo. Los tres proveedores sin clave (duckduckgo, mojeek,
+ * ecosia) están SIEMPRE en la lista, así que siempre hay al menos uno que
+ * intentar: si el bucle se agota es porque todos lanzaron, nunca porque no
+ * hubiera nada que probar. Por eso el único error que se lanza aquí es
+ * «fallaron», nunca «no configurado» — decir lo contrario sería mentir sobre
+ * qué pasó.
+ */
+export async function buscarConProveedores(consulta, maximo, opciones) {
+    const fetchImpl = opciones.fetchImpl ?? fetch;
+    const errores = [];
+    for (const descriptor of PROVEEDORES) {
+        let clave;
+        if (descriptor.necesitaClave) {
+            clave = await opciones.obtenerClave(descriptor.nombre);
+            if (!clave)
+                continue; // no configurado: no es un fallo, es "no disponible"
+        }
+        try {
+            const modulo = await descriptor.cargar();
+            const resultados = await modulo.buscar(consulta, maximo, clave, fetchImpl, opciones.signal);
+            return { proveedor: descriptor.nombre, resultados };
+        }
+        catch (error) {
+            errores.push(`${descriptor.nombre}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    throw new Error(`Todos los proveedores de búsqueda fallaron: ${errores.join(" | ")}`);
+}
+//# sourceMappingURL=registro.js.map

package/dist/core/web/proveedores/registro.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registro.js","sourceRoot":"","sources":["../../../../src/core/web/proveedores/registro.ts"],"names":[],"mappings":"AAiBA,MAAM,SAAS,GAA0B;IACxC,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE;IAC5E,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE;IAC9E,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE;IACxE,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE;IAChF,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE;CAC9E,CAAC;AAEF,MAAM,SAAS,GAA0B;IACxC,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC,EAAE;IACvF,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE;IAC/E,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE;CAC/E,CAAC;AAEF,oGAAkG;AAClG,MAAM,CAAC,MAAM,WAAW,GAAmC,CAAC,GAAG,SAAS,EAAE,GAAG,SAAS,CAAC,CAAC;AAcxF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACzC,QAAgB,EAChB,MAAc,EACd,QAAqC,EACG;IACxC,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,IAAI,KAAK,CAAC;IAC9C,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACtC,IAAI,KAAyB,CAAC;QAC9B,IAAI,UAAU,CAAC,aAAa,EAAE,CAAC;YAC9B,KAAK,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YACvD,IAAI,CAAC,KAAK;gBAAE,SAAS,CAAC,qDAAqD;QAC5E,CAAC;QACD,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,CAAC;YACzC,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC5F,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjG,CAAC;IACF,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,gDAA+C,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAAA,CACtF","sourcesContent":["/**\n * Registro perezoso de proveedores de búsqueda web.\n *\n * Importar este fichero no carga NINGÚN proveedor: cada `cargar()` es un\n * `import()` dinámico que solo se ejecuta cuando le toca el turno en\n * `buscarConProveedores`. Son módulos pesados —parseo de HTML, clientes de\n * API— y como mucho se usa uno por sesión; cargarlos todos al arrancar sería\n * trabajo tirado para el 99% de las sesiones que no los necesitan.\n *\n * Orden: la búsqueda nativa del modelo (Anthropic) se resuelve ANTES de\n * llegar aquí, en `tools.ts`. Dentro de este registro: clave configurada >\n * sin clave — lo explícito que el usuario ha pagado y configurado gana a lo\n * gratuito. Entre proveedores con clave, el orden es el de esta lista; el\n * primero con clave disponible es el que se prueba primero.\n */\nimport type { DescriptorProveedor, ResultadoProveedor } from \"./tipos.ts\";\n\nconst CON_CLAVE: DescriptorProveedor[] = [\n\t{ nombre: \"brave\", necesitaClave: true, cargar: () => import(\"./brave.ts\") },\n\t{ nombre: \"tavily\", necesitaClave: true, cargar: () => import(\"./tavily.ts\") },\n\t{ nombre: \"exa\", necesitaClave: true, cargar: () => import(\"./exa.ts\") },\n\t{ nombre: \"searxng\", necesitaClave: true, cargar: () => import(\"./searxng.ts\") },\n\t{ nombre: \"serper\", necesitaClave: true, cargar: () => import(\"./serper.ts\") },\n];\n\nconst SIN_CLAVE: DescriptorProveedor[] = [\n\t{ nombre: \"duckduckgo\", necesitaClave: false, cargar: () => import(\"./duckduckgo.ts\") },\n\t{ nombre: \"mojeek\", necesitaClave: false, cargar: () => import(\"./mojeek.ts\") },\n\t{ nombre: \"ecosia\", necesitaClave: false, cargar: () => import(\"./ecosia.ts\") },\n];\n\n/** Metadatos de todos los proveedores, en orden de intento. Ningún `cargar()` se ejecuta aquí. */\nexport const PROVEEDORES: readonly DescriptorProveedor[] = [...CON_CLAVE, ...SIN_CLAVE];\n\nexport interface ResultadoBusquedaProveedores {\n\tproveedor: string;\n\tresultados: ResultadoProveedor[];\n}\n\nexport interface OpcionesBusquedaProveedores {\n\t/** Vault primero, variable de entorno después — lo resuelve quien llama. */\n\tobtenerClave: (nombreProveedor: string) => Promise<string | undefined>;\n\tfetchImpl?: typeof fetch;\n\tsignal?: AbortSignal;\n}\n\n/**\n * Prueba los proveedores en orden hasta que uno responda (con o sin\n * resultados) o se agoten todos.\n *\n * Un proveedor sin clave configurada se SALTA sin contar como fallo — no está\n * disponible, no ha fallado. Un proveedor que lanza SÍ cuenta como fallo y se\n * acumula su motivo. Los tres proveedores sin clave (duckduckgo, mojeek,\n * ecosia) están SIEMPRE en la lista, así que siempre hay al menos uno que\n * intentar: si el bucle se agota es porque todos lanzaron, nunca porque no\n * hubiera nada que probar. Por eso el único error que se lanza aquí es\n * «fallaron», nunca «no configurado» — decir lo contrario sería mentir sobre\n * qué pasó.\n */\nexport async function buscarConProveedores(\n\tconsulta: string,\n\tmaximo: number,\n\topciones: OpcionesBusquedaProveedores,\n): Promise<ResultadoBusquedaProveedores> {\n\tconst fetchImpl = opciones.fetchImpl ?? fetch;\n\tconst errores: string[] = [];\n\n\tfor (const descriptor of PROVEEDORES) {\n\t\tlet clave: string | undefined;\n\t\tif (descriptor.necesitaClave) {\n\t\t\tclave = await opciones.obtenerClave(descriptor.nombre);\n\t\t\tif (!clave) continue; // no configurado: no es un fallo, es \"no disponible\"\n\t\t}\n\t\ttry {\n\t\t\tconst modulo = await descriptor.cargar();\n\t\t\tconst resultados = await modulo.buscar(consulta, maximo, clave, fetchImpl, opciones.signal);\n\t\t\treturn { proveedor: descriptor.nombre, resultados };\n\t\t} catch (error) {\n\t\t\terrores.push(`${descriptor.nombre}: ${error instanceof Error ? error.message : String(error)}`);\n\t\t}\n\t}\n\n\tthrow new Error(`Todos los proveedores de búsqueda fallaron: ${errores.join(\" | \")}`);\n}\n"]}

package/dist/core/web/proveedores/searxng.d.ts

@@ -0,0 +1,9 @@
+/**
+ * SearXNG: metabuscador autoalojado. No tiene clave propia en el sentido
+ * habitual —lo que hace falta es la URL de LA instancia del usuario—, pero
+ * cuenta como «con clave» porque, igual que una API key, no funciona de
+ * fábrica: hay que configurarla (vault `searxng`, o SEARXNG_URL).
+ */
+import type { FuncionBuscar } from "./tipos.ts";
+export declare const buscar: FuncionBuscar;
+//# sourceMappingURL=searxng.d.ts.map

package/dist/core/web/proveedores/searxng.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searxng.d.ts","sourceRoot":"","sources":["../../../../src/core/web/proveedores/searxng.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,YAAY,CAAC;AAMpE,eAAO,MAAM,MAAM,EAAE,aAapB,CAAC","sourcesContent":["/**\n * SearXNG: metabuscador autoalojado. No tiene clave propia en el sentido\n * habitual —lo que hace falta es la URL de LA instancia del usuario—, pero\n * cuenta como «con clave» porque, igual que una API key, no funciona de\n * fábrica: hay que configurarla (vault `searxng`, o SEARXNG_URL).\n */\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\ninterface RespuestaSearxng {\n\tresults?: Array<{ title?: string; url?: string; content?: string }>;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, clave, fetchImpl, signal) => {\n\tif (!clave) throw new Error(\"SearXNG requiere la URL de una instancia.\");\n\tconst base = clave.replace(/\\/+$/, \"\");\n\tconst url = new URL(`${base}/search`);\n\turl.searchParams.set(\"q\", consulta);\n\turl.searchParams.set(\"format\", \"json\");\n\tconst respuesta = await fetchImpl(url, { headers: { Accept: \"application/json\" }, signal });\n\tif (!respuesta.ok) throw new Error(`SearXNG respondió HTTP ${respuesta.status}.`);\n\tconst datos = (await respuesta.json()) as RespuestaSearxng;\n\tconst resultados: ResultadoProveedor[] = (datos.results ?? [])\n\t\t.filter((r) => typeof r.url === \"string\" && r.url)\n\t\t.map((r) => ({ titulo: r.title || r.url!, url: r.url!, resumen: r.content }));\n\treturn resultados.slice(0, maximo);\n};\n"]}

package/dist/core/web/proveedores/searxng.js

@@ -0,0 +1,17 @@
+export const buscar = async (consulta, maximo, clave, fetchImpl, signal) => {
+    if (!clave)
+        throw new Error("SearXNG requiere la URL de una instancia.");
+    const base = clave.replace(/\/+$/, "");
+    const url = new URL(`${base}/search`);
+    url.searchParams.set("q", consulta);
+    url.searchParams.set("format", "json");
+    const respuesta = await fetchImpl(url, { headers: { Accept: "application/json" }, signal });
+    if (!respuesta.ok)
+        throw new Error(`SearXNG respondió HTTP ${respuesta.status}.`);
+    const datos = (await respuesta.json());
+    const resultados = (datos.results ?? [])
+        .filter((r) => typeof r.url === "string" && r.url)
+        .map((r) => ({ titulo: r.title || r.url, url: r.url, resumen: r.content }));
+    return resultados.slice(0, maximo);
+};
+//# sourceMappingURL=searxng.js.map

package/dist/core/web/proveedores/searxng.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searxng.js","sourceRoot":"","sources":["../../../../src/core/web/proveedores/searxng.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,MAAM,GAAkB,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IAC1F,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IACzE,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,SAAS,CAAC,CAAC;IACtC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACpC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5F,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA0B,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAClF,MAAM,KAAK,GAAG,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,CAAqB,CAAC;IAC3D,MAAM,UAAU,GAAyB,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;SAC5D,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC;SACjD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAI,EAAE,GAAG,EAAE,CAAC,CAAC,GAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC/E,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAAA,CACnC,CAAC","sourcesContent":["/**\n * SearXNG: metabuscador autoalojado. No tiene clave propia en el sentido\n * habitual —lo que hace falta es la URL de LA instancia del usuario—, pero\n * cuenta como «con clave» porque, igual que una API key, no funciona de\n * fábrica: hay que configurarla (vault `searxng`, o SEARXNG_URL).\n */\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\ninterface RespuestaSearxng {\n\tresults?: Array<{ title?: string; url?: string; content?: string }>;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, clave, fetchImpl, signal) => {\n\tif (!clave) throw new Error(\"SearXNG requiere la URL de una instancia.\");\n\tconst base = clave.replace(/\\/+$/, \"\");\n\tconst url = new URL(`${base}/search`);\n\turl.searchParams.set(\"q\", consulta);\n\turl.searchParams.set(\"format\", \"json\");\n\tconst respuesta = await fetchImpl(url, { headers: { Accept: \"application/json\" }, signal });\n\tif (!respuesta.ok) throw new Error(`SearXNG respondió HTTP ${respuesta.status}.`);\n\tconst datos = (await respuesta.json()) as RespuestaSearxng;\n\tconst resultados: ResultadoProveedor[] = (datos.results ?? [])\n\t\t.filter((r) => typeof r.url === \"string\" && r.url)\n\t\t.map((r) => ({ titulo: r.title || r.url!, url: r.url!, resumen: r.content }));\n\treturn resultados.slice(0, maximo);\n};\n"]}

package/dist/core/web/proveedores/serper.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Serper (Google Search API). Requiere clave (`serper` en el vault, o
+ * SERPER_API_KEY). Es el proveedor histórico de Ada, anterior a este
+ * registro: se mantiene aquí para que quien ya tenga la clave configurada
+ * siga funcionando exactamente igual.
+ */
+import type { FuncionBuscar } from "./tipos.ts";
+export declare const buscar: FuncionBuscar;
+//# sourceMappingURL=serper.d.ts.map

package/dist/core/web/proveedores/serper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serper.d.ts","sourceRoot":"","sources":["../../../../src/core/web/proveedores/serper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,YAAY,CAAC;AAQpE,eAAO,MAAM,MAAM,EAAE,aAcpB,CAAC","sourcesContent":["/**\n * Serper (Google Search API). Requiere clave (`serper` en el vault, o\n * SERPER_API_KEY). Es el proveedor histórico de Ada, anterior a este\n * registro: se mantiene aquí para que quien ya tenga la clave configurada\n * siga funcionando exactamente igual.\n */\nimport type { FuncionBuscar, ResultadoProveedor } from \"./tipos.ts\";\n\nconst ENDPOINT = \"https://google.serper.dev/search\";\n\ninterface RespuestaSerper {\n\torganic?: Array<{ title?: string; link?: string; snippet?: string }>;\n}\n\nexport const buscar: FuncionBuscar = async (consulta, maximo, clave, fetchImpl, signal) => {\n\tif (!clave) throw new Error(\"Serper requiere clave.\");\n\tconst respuesta = await fetchImpl(ENDPOINT, {\n\t\tmethod: \"POST\",\n\t\theaders: { \"X-API-KEY\": clave, \"content-type\": \"application/json\" },\n\t\tbody: JSON.stringify({ q: consulta, num: maximo }),\n\t\tsignal,\n\t});\n\tif (!respuesta.ok) throw new Error(`Serper respondió HTTP ${respuesta.status}.`);\n\tconst datos = (await respuesta.json()) as RespuestaSerper;\n\tconst resultados: ResultadoProveedor[] = (datos.organic ?? [])\n\t\t.filter((r) => typeof r.link === \"string\" && r.link)\n\t\t.map((r) => ({ titulo: r.title || r.link!, url: r.link!, resumen: r.snippet }));\n\treturn resultados.slice(0, maximo);\n};\n"]}